기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# ID 스토어에서 userID를 사용하여 사용자 메타데이터 및 속성 검색
<a name="query-session-data-map-userid"></a>

**참고**  
이 절차는 동일한 사용자 ID 형식을 사용하는 [SearchJobs](https://docs.aws.amazon.com/deadline-cloud/latest/APIReference/API_SearchJobs.html) API에서 반환되는 `createdBy` 필드에도 적용됩니다.

세션 통계의 `userId` 필드에는 다음 값 중 하나가 포함됩니다.
+  AWS Identity and Access Management (IAM) 역할 ARN, 예: `arn:aws:sts::123456789012:assumed-role/Admin/user-Isengard`.
+ IAM Identity Center 사용자 ID(UUID), 예: `f9c1f3f0-1031-70dc-4d25-30d7225b04a0`.

IAM 역할 ARNs의 경우 사용자 이름은 ARN 자체에 표시됩니다. IAM Identity Center 사용자 IDs의 경우 IAM Identity Center Identity Store API를 사용하여 사용자 이름을 조회할 수 있습니다.

IAM Identity Center 사용자 ID와 연결된 사용자 이름을 식별하려면 다음 절차를 사용합니다. 시작하기 전에 IAM Identity Center 설정에서 Identity Store ID를 가져옵니다. 자세한 내용은 [ID 스토어 ID 찾기](#query-session-data-find-identity-store-id) 단원을 참조하십시오.

## 사용자 ID를 매핑하려면
<a name="query-session-data-map-userid-cli"></a>

1. 다음 명령을 실행하여 {{IdentityStoreId}}를 Identity Store ID로 바꾸고 {{userUUID}}를 세션 통계 응답`userId`의 로 바꿉니다.

   ```
   aws identitystore describe-user \
       --identity-store-id {{IdentityStoreId}} \
       --user-id {{userUUID}}
   ```

1. 사용자 이름이 포함된 응답을 검토합니다.

   ```
   {
       "UserName": "jdoe",
       "UserId": "f9c1f3f0-1031-70dc-4d25-30d7225b04a0",
       "Name": {
           "FamilyName": "Doe",
           "GivenName": "Jane"
       },
       "DisplayName": "Jane Doe",
       "Emails": [{
           "Value": "jdoe@example.com",
           "Type": "work",
           "Primary": true
       }],
       "IdentityStoreId": "d-xxxxxxxxxx"
   }
   ```

## ID 스토어 ID 찾기
<a name="query-session-data-find-identity-store-id"></a>

사용자 IDs 사용자 이름에 매핑하려면 Identity Store ID가 필요합니다. IAM Identity Center 콘솔 또는를 사용하여 Identity Store ID를 찾을 수 있습니다 AWS CLI.

**콘솔**  
콘솔을 사용하여 Identity Store ID를 찾으려면 다음 절차를 사용합니다.

1.  AWS Management Console에 로그인하고 [IAM Identity Center 콘솔](https://console.aws.amazon.com/singlesignon/home)을 엽니다.

1. 탐색 창에서 **설정**을 선택합니다.

1. **IAM Identity Center Identity Store ID** 값을 복사합니다. 형식은 `d-xxxxxxxxxx`입니다.

**AWS CLI**  


다음 명령을 실행하여 {{region-name}}을 IAM Identity Center 인스턴스가 구성된 리전으로 바꿉니다.

```
aws sso-admin list-instances --region {{region-name}}
```

응답에는 `IdentityStoreId`가 포함됩니다.

```
{
    "Instances": [
        {
            "CreatedDate": "2025-11-19T15:45:55.160000-08:00",
            "IdentityStoreId": "d-xxxxxxxxxx",
            "InstanceArn": "arn:aws:sso:::instance/ssoins-xxxxxxxxxxxxxxxx",
            "OwnerAccountId": "123456789012",
            "Status": "ACTIVE"
        }
    ]
}
```

## 사용자 매핑 확인
<a name="query-session-data-verify-user"></a>

사용자 ID를 사용자 이름에 매핑한 후 IAM Identity Center 콘솔에서 사용자 ID가 예상 사용자와 일치하는지 확인할 수 있습니다. 사용자 매핑을 확인하려면 다음 절차를 사용합니다.

1.  AWS Management Console에 로그인하고 [IAM Identity Center 콘솔](https://console.aws.amazon.com/singlesignon/home)을 엽니다.

1. 탐색 창에서 **사용자**를 선택합니다.

1.  AWS CLI 응답에서 사용자 이름을 선택합니다.

1. **일반 정보** 섹션에서 **사용자 ID**가 세션 통계의와 일치하는`userId`지 확인합니다.

## 추가 리소스
<a name="query-session-data-additional-resources"></a>
+ [IAM Identity Center 사용 설명서](https://docs.aws.amazon.com/singlesignon/latest/userguide/what-is.html)
+ [IAM Identity Center Identity Store API 참조](https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/welcome.html)