자격 증명 소유자 조회

Prev Next

Classic/VPC 환경에서 이용 가능합니다.

Access Key의 소유자를 조회합니다.

요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

메서드 URI
GET /api/v1/caller-identity

요청 헤더

Secure Token Service API에서 공통으로 사용하는 헤더에 대한 정보는 Secure Token Service 요청 헤더를 참조해 주십시오.

요청 예시

요청 예시는 다음과 같습니다.

curl --location --request GET 'https://sts.apigw.gov-ntruss.com/api/v1/caller-identity' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'Content-Type: application/json' \

응답

응답 형식을 설명합니다.

응답 바디

응답 바디에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
id String - Access Key 소유자의 고유 식별자
loginAlias String - Access Key 소유자의 접속 페이지 URL
userType String - Access Key 소유자의 유형
  • Customer | Sub | Role
    • Customer: 메인 계정
    • Sub: 서브 계정
    • Role: 역할 전환한 임시 자격 증명

응답 상태 코드

Secure Token Service API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Secure Token Service 응답 상태 코드를 참조해 주십시오.

응답 예시

응답 예시는 다음과 같습니다.

{
    "id": "e***-e***-1***-8***-2***",
    "loginAlias": "test1010",
    "userType": "Sub"
}