

# AWS CLI를 사용한 Amazon Connect 예제
<a name="cli_connect_code_examples"></a>

다음 코드 예제에서는 Amazon Connect에서 AWS Command Line Interface를 사용하여 일반적인 시나리오를 구현하는 방법을 보여 줍니다.

*작업*은 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 작업은 개별 서비스 함수를 직접적으로 호출하는 방법을 보여주며 관련 시나리오의 컨텍스트에 맞는 작업을 볼 수 있습니다.

각 예시에는 전체 소스 코드에 대한 링크가 포함되어 있으며, 여기에서 컨텍스트에 맞춰 코드를 설정하고 실행하는 방법에 대한 지침을 찾을 수 있습니다.

**Topics**
+ [작업](#actions)

## 작업
<a name="actions"></a>

### `create-user`
<a name="connect_CreateUser_cli_topic"></a>

다음 코드 예시는 `create-user`의 사용 방법을 보여줍니다.

**AWS CLI**  
**사용자를 생성하는 방법**  
다음 `create-user` 예제에서는 지정된 속성을 가진 사용자를 지정된 Amazon Connect 인스턴스에 추가합니다.  

```
aws connect create-user \
    --username Mary \
    --password Pass@Word1 \
    --identity-info FirstName=Mary,LastName=Major \
    --phone-config PhoneType=DESK_PHONE,AutoAccept=true,AfterContactWorkTimeLimit=60,DeskPhoneNumber=+15555551212 \
    --security-profile-id 12345678-1111-2222-aaaa-a1b2c3d4f5g7 \
    --routing-profile-id 87654321-9999-3434-abcd-x1y2z3a1b2c3 \
    --instance-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
출력:  

```
{
    "UserId": "87654321-2222-1234-1234-111234567891",
    "UserArn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/agent/87654321-2222-1234-1234-111234567891"
}
```
자세한 내용은 **Amazon Connect 관리자 안내서의 [사용자 추가](https://docs.aws.amazon.com/connect/latest/adminguide/user-management.html)를 참조하세요.  
+  API 세부 정보는 **AWS CLI 명령 참조의 [CreateUser](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/connect/create-user.html)를 참조하세요.

### `delete-user`
<a name="connect_DeleteUser_cli_topic"></a>

다음 코드 예시는 `delete-user`의 사용 방법을 보여줍니다.

**AWS CLI**  
**사용자 삭제**  
다음 `delete-user` 예제에서는 지정된 Amazon Connect 인스턴스에서 지정된 사용자를 삭제합니다.  

```
aws connect delete-user \
    --instance-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \
    --user-id 87654321-2222-1234-1234-111234567891
```
이 명령은 출력을 생성하지 않습니다.  
자세한 내용은 **Amazon Connect 관리자 안내서의 [사용자 관리](https://docs.aws.amazon.com/connect/latest/adminguide/manage-users.html)를 참조하세요.  
+  API 세부 정보는 **AWS CLI 명령 참조의 [DeleteUser](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/connect/delete-user.html)를 참조하세요.

### `describe-user-hierarchy-group`
<a name="connect_DescribeUserHierarchyGroup_cli_topic"></a>

다음 코드 예시는 `describe-user-hierarchy-group`의 사용 방법을 보여줍니다.

**AWS CLI**  
**계층 그룹에 대한 세부 정보를 표시하는 방법**  
다음 `describe-user-hierarchy-group` 예제에서는 지정된 Amazon Connect 계층 구조 그룹에 대한 세부 정보를 표시합니다.  

```
aws connect describe-user-hierarchy-group \
    --hierarchy-group-id 12345678-1111-2222-800e-aaabbb555gg \
    --instance-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
출력:  

```
{
     "HierarchyGroup": {
         "Id": "12345678-1111-2222-800e-a2b3c4d5f6g7",
         "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/agent-group/12345678-1111-2222-800e-a2b3c4d5f6g7",
         "Name": "Example Corporation",
         "LevelId": "1",
         "HierarchyPath": {
             "LevelOne": {
                 "Id": "abcdefgh-3333-4444-8af3-201123456789",
                 "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/agent-group/abcdefgh-3333-4444-8af3-201123456789",
                 "Name": "Example Corporation"
             }
         }
     }
 }
```
자세한 내용은 **Amazon Connect 관리자 안내서의 [에이전트 계층 구조 설정](https://docs.aws.amazon.com/connect/latest/adminguide/agent-hierarchy.html)을 참조하세요.  
+  API 세부 정보는 **AWS CLI 명령 참조의 [DescribeUserHierarchyGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/connect/describe-user-hierarchy-group.html) 섹션을 참조하세요.

### `describe-user-hierarchy-structure`
<a name="connect_DescribeUserHierarchyStructure_cli_topic"></a>

다음 코드 예시는 `describe-user-hierarchy-structure`의 사용 방법을 보여줍니다.

**AWS CLI**  
**계층 구조에 대한 세부 정보를 표시하는 방법**  
다음 `describe-user-hierarchy-structure` 예제에서는 지정된 Amazon Connect 인스턴스의 계층 구조에 대한 세부 정보를 표시합니다.  

```
aws connect describe-user-hierarchy-group \
    --instance-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
출력:  

```
{
     "HierarchyStructure": {
         "LevelOne": {
             "Id": "12345678-1111-2222-800e-aaabbb555gg",
             "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/agent-group-level/1",
             "Name": "Corporation"
         },
         "LevelTwo": {
             "Id": "87654321-2222-3333-ac99-123456789102",
             "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/agent-group-level/2",
             "Name": "Services Division"
         },
         "LevelThree": {
             "Id": "abcdefgh-3333-4444-8af3-201123456789",
             "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/agent-group-level/3",
             "Name": "EU Site"
         }
     }
 }
```
자세한 내용은 **Amazon Connect 관리자 안내서의 [에이전트 계층 구조 설정](https://docs.aws.amazon.com/connect/latest/adminguide/agent-hierarchy.html)을 참조하세요.  
+  API 세부 정보는 **AWS CLI 명령 참조의 [DescribeUserHierarchyStructure](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/connect/describe-user-hierarchy-structure.html) 섹션을 참조하세요.

### `describe-user`
<a name="connect_DescribeUser_cli_topic"></a>

다음 코드 예시는 `describe-user`의 사용 방법을 보여줍니다.

**AWS CLI**  
**사용자의 세부 정보를 표시하는 방법**  
다음 `describe-user` 예제에서는 지정된 Amazon Connect 사용자에 대한 세부 정보를 표시합니다.  

```
aws connect describe-user \
    --user-id 0c245dc0-0cf5-4e37-800e-2a7481cc8a60
    --instance-id 40c83b68-ea62-414c-97bb-d018e39e158e
```
출력:  

```
{
    "User": {
        "Id": "0c245dc0-0cf5-4e37-800e-2a7481cc8a60",
        "Arn": "arn:aws:connect:us-west-2:123456789012:instance/40c83b68-ea62-414c-97bb-d018e39e158e/agent/0c245dc0-0cf5-4e37-800e-2a7481cc8a60",
        "Username": "Jane",
        "IdentityInfo": {
            "FirstName": "Jane",
            "LastName": "Doe",
            "Email": "example.com"
        },
        "PhoneConfig": {
            "PhoneType": "SOFT_PHONE",
            "AutoAccept": false,
            "AfterContactWorkTimeLimit": 0,
            "DeskPhoneNumber": ""
        },
        "DirectoryUserId": "8b444cf6-b368-4f29-ba18-07af27405658",
        "SecurityProfileIds": [
            "b6f85a42-1dc5-443b-b621-de0abf70c9cf"
        ],
        "RoutingProfileId": "0be36ee9-2b5f-4ef4-bcf7-87738e5be0e5",
        "Tags": {}
    }
}
```
자세한 내용은 **Amazon Connect 관리자 안내서의 [사용자 관리](https://docs.aws.amazon.com/connect/latest/adminguide/manage-users.html)를 참조하세요.  
+  API 세부 정보는 **AWS CLI 명령 참조의 [DescribeUser](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/connect/describe-user.html) 섹션을 참조하세요.

### `get-contact-attributes`
<a name="connect_GetContactAttributes_cli_topic"></a>

다음 코드 예시는 `get-contact-attributes`의 사용 방법을 보여줍니다.

**AWS CLI**  
**연락처의 속성을 검색하는 방법**  
다음 `get-contact-attributes` 예제에서는 지정된 Amazon Connect Contact에 설정된 속성을 검색합니다.  

```
aws connect get-contact-attributes \
    --instance-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \
    --initial-contact-id 12345678-1111-2222-800e-a2b3c4d5f6g7
```
출력:  

```
{
    "Attributes": {
        "greetingPlayed": "true"
    }
}
```
자세한 내용은 **Amazon Connect 관리자 안내서의 [Amazon Connect Contact 속성 사용](https://docs.aws.amazon.com/connect/latest/adminguide/connect-contact-attributes.html)을 참조하세요.  
+  API 세부 정보는 **AWS CLI 명령 참조의 [GetContactAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/connect/get-contact-attributes.html) 섹션을 참조하세요.

### `list-contact-flows`
<a name="connect_ListContactFlows_cli_topic"></a>

다음 코드 예시는 `list-contact-flows`의 사용 방법을 보여줍니다.

**AWS CLI**  
**인스턴스의 고객 응대 흐름을 나열하는 방법**  
다음 `list-contact-flows` 예제에서는 지정된 Amazon Connect 인스턴스의 고객 응대 흐름을 나열합니다.  

```
aws connect list-contact-flows \
    --instance-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
출력:  

```
{
     "ContactFlowSummaryList": [
         {
             "Id": "12345678-1111-2222-800e-a2b3c4d5f6g7",
             "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/contact-flow/12345678-1111-2222-800e-a2b3c4d5f6g7",
             "Name": "Default queue transfer",
             "ContactFlowType": "QUEUE_TRANSFER"
         },
         {
             "Id": "87654321-2222-3333-ac99-123456789102",
             "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/contact-flow/87654321-2222-3333-ac99-123456789102",
             "Name": "Default agent hold",
             "ContactFlowType": "AGENT_HOLD"
         },
         {
             "Id": "abcdefgh-3333-4444-8af3-201123456789",
                 "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/contact-flow/abcdefgh-3333-4444-8af3-201123456789",
             "Name": "Default customer hold",
             "ContactFlowType": "CUSTOMER_HOLD"
         },
     ]
 }
```
자세한 내용은 **Amazon Connect 관리자 안내서의 [Amazon Connect Contact 흐름 생성](https://docs.aws.amazon.com/connect/latest/adminguide/connect-contact-flows.html)을 참조하세요.  
+  API 세부 정보는 **AWS CLI 명령 참조의 [ListContactFlows](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/connect/list-contact-flows.html) 섹션 섹션을 참조하세요.

### `list-hours-of-operations`
<a name="connect_ListHoursOfOperations_cli_topic"></a>

다음 코드 예시는 `list-hours-of-operations`의 사용 방법을 보여줍니다.

**AWS CLI**  
**인스턴스에서 작업 시간을 나열하는 방법**  
다음 `list-hours-of-operations` 예제에서는 지정된 Amazon Connect 인스턴스의 운영 시간을 나열합니다.  

```
aws connect list-hours-of-operations \
    --instance-id 40c83b68-ea62-414c-97bb-d018e39e158e
```
출력:  

```
{
    "HoursOfOperationSummaryList": [
        {
            "Id": "d69f1f84-7457-4924-8fbe-e64875546259",
            "Arn": "arn:aws:connect:us-west-2:123456789012:instance/40c83b68-ea62-414c-97bb-d018e39e158e/operating-hours/d69f1f84-7457-4924-8fbe-e64875546259",
            "Name": "Basic Hours"
        }
    ]
}
```
자세한 내용은 **Amazon Connect 관리자 안내서의 [대기열에 대한 작업 시간 설정](https://docs.aws.amazon.com/connect/latest/adminguide/set-hours-operation.html)을 참조하세요.  
+  API 세부 정보는 **AWS CLI 명령 참조의 [ListHoursOfOperations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/connect/list-hours-of-operations.html) 섹션을 참조하세요.

### `list-phone-numbers`
<a name="connect_ListPhoneNumbers_cli_topic"></a>

다음 코드 예시는 `list-phone-numbers`의 사용 방법을 보여줍니다.

**AWS CLI**  
**인스턴스의 전화번호를 나열하는 방법**  
다음 `list-phone-numbers` 예제에서는 지정된 Amazon Connect 인스턴스의 전화번호를 나열합니다.  

```
aws connect list-phone-numbers \
    --instance-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
출력:  

```
{
    "PhoneNumberSummaryList": [
        {
            "Id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
            "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/phone-number/xyz80zxy-xyz1-80zx-zx80-11111EXAMPLE",
            "PhoneNumber": "+17065551212",
            "PhoneNumberType": "DID",
            "PhoneNumberCountryCode": "US"
        },
        {
            "Id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
            "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/phone-number/ccc0ccc-xyz1-80zx-zx80-22222EXAMPLE",
            "PhoneNumber": "+18555551212",
            "PhoneNumberType": "TOLL_FREE",
            "PhoneNumberCountryCode": "US"
        }
    ]
}
```
자세한 내용은 **Amazon Connect 관리자 안내서의 [고객 센터의 전화번호 설정](https://docs.aws.amazon.com/connect/latest/adminguide/contact-center-phone-number.html)을 참조하세요.  
+  API 세부 정보는 **AWS CLI 명령 참조의 [ListPhoneNumbers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/connect/list-phone-numbers.html) 섹션 섹션을 참조하세요.

### `list-queues`
<a name="connect_ListQueues_cli_topic"></a>

다음 코드 예시는 `list-queues`의 사용 방법을 보여줍니다.

**AWS CLI**  
**인스턴스의 대기열을 나열하는 방법**  
다음 `list-queues` 예제에서는 지정된 Amazon Connect 인스턴스의 대기열을 나열합니다.  

```
aws connect list-queues \
    --instance-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
출력:  

```
{
    "QueueSummaryList": [
        {
            "Id": "12345678-1111-2222-800e-a2b3c4d5f6g7",
            "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/queue/agent/12345678-1111-2222-800e-a2b3c4d5f6g7",
            "QueueType": "AGENT"
        },
        {
            "Id": "87654321-2222-3333-ac99-123456789102",
            "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/queue/agent/87654321-2222-3333-ac99-123456789102",
            "QueueType": "AGENT"
        },
        {
            "Id": "abcdefgh-3333-4444-8af3-201123456789",
            "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/queue/agent/abcdefgh-3333-4444-8af3-201123456789",
            "QueueType": "AGENT"
        },
        {
            "Id": "hgfedcba-4444-5555-a31f-123456789102",
            "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/queue/hgfedcba-4444-5555-a31f-123456789102",
            "Name": "BasicQueue",
            "QueueType": "STANDARD"
        },
    ]
}
```
자세한 내용은 **Amazon Connect 관리자 안내서의 [대기열 생성](https://docs.aws.amazon.com/connect/latest/adminguide/create-queue.html)을 참조하세요.  
+  API 세부 정보는 *AWS CLI 명령 참조*의 [ListQueues](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/connect/list-queues.html)를 참조하세요.

### `list-routing-profiles`
<a name="connect_ListRoutingProfiles_cli_topic"></a>

다음 코드 예시는 `list-routing-profiles`의 사용 방법을 보여줍니다.

**AWS CLI**  
**인스턴스의 모든 라우팅 프로필을 나열하는 방법**  
다음 `list-routing-profiles` 예제에서는 지정된 Amazon Connect 인스턴스의 라우팅 프로파일을 나열합니다.  

```
aws connect list-routing-profiles \
    --instance-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
출력:  

```
{
    "RoutingProfileSummaryList": [
        {
            "Id": "12345678-1111-2222-800e-a2b3c4d5f6g7",
            "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/routing-profile/12345678-1111-2222-800e-a2b3c4d5f6g7",
            "Name": "Basic Routing Profile"
        },
    ]
}
```
자세한 내용은 **Amazon Connect 관리자 안내서의 [라우팅 프로필 생성](https://docs.aws.amazon.com/connect/latest/adminguide/routing-profiles.html)을 참조하세요.  
+  API 세부 정보는 **AWS CLI 명령 참조의 [ListRoutingProfiles](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/connect/list-routing-profiles.html) 섹션을 참조하세요.

### `list-security-profiles`
<a name="connect_ListSecurityProfiles_cli_topic"></a>

다음 코드 예시는 `list-security-profiles`의 사용 방법을 보여줍니다.

**AWS CLI**  
**인스턴스의 모든 보안 프로필을 나열하는 방법**  
다음 `list-security-profiles` 예제에서는 지정된 Amazon Connect 인스턴스의 보안 프로파일을 나열합니다.  

```
aws connect list-security-profiles \
    --instance-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
출력:  

```
{
    "SecurityProfileSummaryList": [
        {
            "Id": "12345678-1111-2222-800e-a2b3c4d5f6g7",
            "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/security-profile/12345678-1111-2222-800e-a2b3c4d5f6g7",
            "Name": "CallCenterManager"
        },
        {
            "Id": "87654321-2222-3333-ac99-123456789102",
            "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/security-profile/87654321-2222-3333-ac99-123456789102",
            "Name": "QualityAnalyst"
        },
        {
            "Id": "abcdefgh-3333-4444-8af3-201123456789",
            "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/security-profile/abcdefgh-3333-4444-8af3-201123456789",
            "Name": "Agent"
        },
        {
            "Id": "12345678-1111-2222-800e-x2y3c4d5fzzzz",
            "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/security-profile/12345678-1111-2222-800e-x2y3c4d5fzzzz",
            "Name": "Admin"
        }
    ]
}
```
자세한 내용은 **Amazon Connect 관리자 안내서의 [권한 할당: 보안 프로필](https://docs.aws.amazon.com/connect/latest/adminguide/connect-security-profiles.html)을 참조하세요.  
+  API 세부 정보는 **AWS CLI 명령 참조의 [ListSecurityProfiles](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/connect/list-security-profiles.html) 섹션을 참조하세요.

### `list-user-hierarchy-groups`
<a name="connect_ListUserHierarchyGroups_cli_topic"></a>

다음 코드 예시는 `list-user-hierarchy-groups`의 사용 방법을 보여줍니다.

**AWS CLI**  
**인스턴스의 사용자 계층 그룹을 나열하는 방법**  
다음 `list-user-hierarchy-groups` 예제에서는 지정된 Amazon Connect 인스턴스의 사용자 계층 그룹을 나열합니다.  

```
aws connect list-user-hierarchy-groups \
    --instance-id 40c83b68-ea62-414c-97bb-d018e39e158e
```
출력:  

```
{
    "UserHierarchyGroupSummaryList": [
        {
            "Id": "0e2f6d1d-b3ca-494b-8dbc-ba81d9f8182a",
            "Arn": "arn:aws:connect:us-west-2:123456789012:instance/40c83b68-ea62-414c-97bb-d018e39e158e/agent-group/0e2f6d1d-b3ca-494b-8dbc-ba81d9f8182a",
            "Name": "Example Corporation"
        },
    ]
}
```
자세한 내용은 **Amazon Connect 관리자 안내서의 [에이전트 계층 구조 설정](https://docs.aws.amazon.com/connect/latest/adminguide/agent-hierarchy.html)을 참조하세요.  
+  API 세부 정보는 **AWS CLI 명령 참조의 [ListUserHierarchyGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/connect/list-user-hierarchy-groups.html) 섹션을 참조하세요.

### `list-users`
<a name="connect_ListUsers_cli_topic"></a>

다음 코드 예시는 `list-users`의 사용 방법을 보여줍니다.

**AWS CLI**  
**인스턴스의 사용자 계층 그룹을 나열하는 방법**  
다음 `list-users` 예제에서는 지정된 Amazon Connect 인스턴스의 사용자를 나열합니다.  

```
aws connect list-users \
    --instance-id 40c83b68-ea62-414c-97bb-d018e39e158e
```
출력:  

```
{
    "UserSummaryList": [
        {
            "Id": "0c245dc0-0cf5-4e37-800e-2a7481cc8a60",
            "Arn": "arn:aws:connect:us-west-2:123456789012:instance/40c83b68-ea62-414c-97bb-d018e39e158e/agent/0c245dc0-0cf5-4e37-800e-2a7481cc8a60",
            "Username": "Jane"
        },
        {
            "Id": "46f0c67c-3fc7-4806-ac99-403798788c14",
            "Arn": "arn:aws:connect:us-west-2:123456789012:instance/40c83b68-ea62-414c-97bb-d018e39e158e/agent/46f0c67c-3fc7-4806-ac99-403798788c14",
            "Username": "Paulo"
        },
        {
            "Id": "55a83578-95e1-4710-8af3-2b7afe310e48",
            "Arn": "arn:aws:connect:us-west-2:123456789012:instance/40c83b68-ea62-414c-97bb-d018e39e158e/agent/55a83578-95e1-4710-8af3-2b7afe310e48",
            "Username": "JohnD"
        },
        {
            "Id": "703e27b5-c9f0-4f1f-a239-64ccbb160125",
            "Arn": "arn:aws:connect:us-west-2:123456789012:instance/40c83b68-ea62-414c-97bb-d018e39e158e/agent/703e27b5-c9f0-4f1f-a239-64ccbb160125",
            "Username": "JohnS"
        }
    ]
}
```
자세한 내용은 **Amazon Connect 관리자 안내서의 [사용자 추가](https://docs.aws.amazon.com/connect/latest/adminguide/user-management.html)를 참조하세요.  
+  API 세부 정보는 **AWS CLI 명령 참조의 [ListUsers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/connect/list-users.html)를 참조하세요.

### `update-contact-attributes`
<a name="connect_UpdateContactAttributes_cli_topic"></a>

다음 코드 예시는 `update-contact-attributes`의 사용 방법을 보여줍니다.

**AWS CLI**  
**연락처의 속성을 업데이트하는 방법**  
다음 `update-contact-attributes` 예제에서는 지정된 Amazon Connect 사용자의 `greetingPlayed` 속성을 업데이트합니다.  

```
aws connect update-contact-attributes \
    --initial-contact-id 11111111-2222-3333-4444-12345678910 \
    --instance-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \
    --attributes greetingPlayed=false
```
이 명령은 출력을 생성하지 않습니다.  
자세한 내용은 **Amazon Connect 관리자 안내서의 [Amazon Connect Contact 속성 사용](https://docs.aws.amazon.com/connect/latest/adminguide/connect-contact-attributes.html)을 참조하세요.  
+  API 세부 정보는 **AWS CLI 명령 참조의 [UpdateContactAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/connect/update-contact-attributes.html) 섹션을 참조하세요.

### `update-user-hierarchy`
<a name="connect_UpdateUserHierarchy_cli_topic"></a>

다음 코드 예시는 `update-user-hierarchy`의 사용 방법을 보여줍니다.

**AWS CLI**  
**사용자의 계층 구조를 업데이트하는 방법**  
다음 `update-user-hierarchy` 예제에서는 지정된 Amazon Connect 사용자의 에이전트 계층 구조를 업데이트합니다.  

```
aws connect update-user-hierarchy \
    --hierarchy-group-id 12345678-a1b2-c3d4-e5f6-123456789abc \
    --user-id 87654321-2222-1234-1234-111234567891 \
    --instance-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
이 명령은 출력을 생성하지 않습니다.  
자세한 내용은 **Amazon Connect 관리자 안내서의 [에이전트 설정 구성](https://docs.aws.amazon.com/connect/latest/adminguide/configure-agents.html)을 참조하세요.  
+  API 세부 정보는 **AWS CLI 명령 참조의 [UpdateUserHierarchy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/connect/update-user-hierarchy.html) 섹션을 참조하세요.

### `update-user-identity-info`
<a name="connect_UpdateUserIdentityInfo_cli_topic"></a>

다음 코드 예시는 `update-user-identity-info`의 사용 방법을 보여줍니다.

**AWS CLI**  
**사용자의 자격 증명 정보를 업데이트하는 방법**  
다음 `update-user-identity-info` 예제에서는 지정된 Amazon Connect 사용자의 자격 증명 정보를 업데이트합니다.  

```
aws connect update-user-identity-info \
    --identity-info FirstName=Mary,LastName=Major,Email=marym@example.com \
    --user-id 87654321-2222-1234-1234-111234567891 \
    --instance-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
이 명령은 출력을 생성하지 않습니다.  
자세한 내용은 **Amazon Connect 관리자 안내서의 [에이전트 설정 구성](https://docs.aws.amazon.com/connect/latest/adminguide/configure-agents.html)을 참조하세요.  
+  API 세부 정보는 **AWS CLI 명령 참조의 [UpdateUserIdentityInfo](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/connect/update-user-identity-info.html) 섹션을 참조하세요.

### `update-user-phone-config`
<a name="connect_UpdateUserPhoneConfig_cli_topic"></a>

다음 코드 예시는 `update-user-phone-config`의 사용 방법을 보여줍니다.

**AWS CLI**  
**사용자의 전화 구성을 업데이트하는 방법**  
다음 `update-user-phone-config` 예제에서는 지정된 사용자의 전화 구성을 업데이트합니다.  

```
aws connect update-user-phone-config \
    --phone-config PhoneType=SOFT_PHONE,AutoAccept=false,AfterContactWorkTimeLimit=60,DeskPhoneNumber=+18005551212 \
    --user-id 12345678-4444-3333-2222-111122223333 \
    --instance-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
이 명령은 출력을 생성하지 않습니다.  
자세한 내용은 **Amazon Connect 관리자 안내서의 [에이전트 설정 구성](https://docs.aws.amazon.com/connect/latest/adminguide/configure-agents.html)을 참조하세요.  
+  API 세부 정보는 **AWS CLI 명령 참조의 [UpdateUserPhoneConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/connect/update-user-phone-config.html) 섹션을 참조하세요.

### `update-user-routing-profile`
<a name="connect_UpdateUserRoutingProfile_cli_topic"></a>

다음 코드 예시는 `update-user-routing-profile`의 사용 방법을 보여줍니다.

**AWS CLI**  
**사용자의 라우팅 프로필을 업데이트하는 방법**  
다음 `update-user-routing-profile` 예제에서는 지정된 Amazon Connect 사용자의 라우팅 프로파일을 업데이트합니다.  

```
aws connect update-user-routing-profile \
    --routing-profile-id 12345678-1111-3333-2222-4444EXAMPLE \
    --user-id 87654321-2222-1234-1234-111234567891 \
    --instance-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
이 명령은 출력을 생성하지 않습니다.  
자세한 내용은 **Amazon Connect 관리자 안내서의 [에이전트 설정 구성](https://docs.aws.amazon.com/connect/latest/adminguide/configure-agents.html)을 참조하세요.  
+  API 세부 정보는 **AWS CLI 명령 참조의 [UpdateUserRoutingProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/connect/update-user-routing-profile.html) 섹션을 참조하세요.

### `update-user-security-profiles`
<a name="connect_UpdateUserSecurityProfiles_cli_topic"></a>

다음 코드 예시는 `update-user-security-profiles`의 사용 방법을 보여줍니다.

**AWS CLI**  
**사용자의 보안 프로필을 업데이트하는 방법**  
다음 `update-user-security-profiles` 예제에서는 지정된 Amazon Connect 사용자의 보안 프로파일을 업데이트합니다.  

```
aws connect update-user-security-profiles \
    --security-profile-ids 12345678-1234-1234-1234-1234567892111 \
    --user-id 87654321-2222-1234-1234-111234567891 \
    --instance-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
이 명령은 출력을 생성하지 않습니다.  
자세한 내용은 **Amazon Connect 관리자 안내서의 [권한 할당: 보안 프로필](https://docs.aws.amazon.com/connect/latest/adminguide/connect-security-profiles.html)을 참조하세요.  
+  API 세부 정보는 **AWS CLI 명령 참조의 [UpdateUserSecurityProfiles](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/connect/update-user-security-profiles.html) 섹션을 참조하세요.