AWS CLI를 사용한 Amazon Chime 예시 - AWS Command Line Interface
작업

이 문서는 AWS CLI의 버전 1에만 해당합니다. AWS CLI의 버전 2와 관련된 문서는 버전 2 사용 설명서를 참조하세요.

AWS CLI를 사용한 Amazon Chime 예시

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

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

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

주제

작업

다음 코드 예시에서는 associate-phone-number-with-user을 사용하는 방법을 보여 줍니다.

AWS CLI

전화번호를 사용자와 연결하는 방법

다음 associate-phone-number-with-user 예시에서는 지정된 전화번호를 사용자와 연결합니다.

aws chime associate-phone-number-with-user \
    --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \
    --user-id 1ab2345c-67de-8901-f23g-45h678901j2k \
    --e164-phone-number "+12065550100"

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Amazon Chime 관리 안내서의 Managing User Phone Numbers 섹션을 참조하세요.

다음 코드 예시에서는 associate-phone-numbers-with-voice-connector-group을 사용하는 방법을 보여 줍니다.

AWS CLI

전화번호들을 Amazon Chime Voice Connector 그룹과 연결하는 방법

다음 associate-phone-numbers-with-voice-connector-group 예시에서는 지정된 전화번호들을 Amazon Chime Voice Connector 그룹과 연결합니다.

aws chime associate-phone-numbers-with-voice-connector-group \
    --voice-connector-group-id 123a456b-c7d8-90e1-fg23-4h567jkl8901 \
    --e164-phone-numbers "+12065550100" "+12065550101" \
    --force-associate

출력:

{
    "PhoneNumberErrors": []
}

자세한 내용은 Amazon Chime 관리 안내서의 Working with Amazon Chime Voice Connector groups 섹션을 참조하세요.

다음 코드 예시에서는 associate-phone-numbers-with-voice-connector을 사용하는 방법을 보여 줍니다.

AWS CLI

전화번호들을 Amazon Chime Voice Connector와 연결하는 방법

다음 associate-phone-numbers-with-voice-connector 예시에서는 지정된 전화번호들을 Amazon Chime Voice Connector와 연결합니다.

aws chime associate-phone-numbers-with-voice-connector \
    --voice-connector-id abcdef1ghij2klmno3pqr4 \
    --e164-phone-numbers "+12065550100" "+12065550101"
    --force-associate

출력:

{
    "PhoneNumberErrors": []
}

자세한 내용은 Amazon Chime 관리 안내서의 Working with Amazon Chime Voice Connectors 섹션을 참조하세요.

다음 코드 예시에서는 associate-signin-delegate-groups-with-account을 사용하는 방법을 보여 줍니다.

AWS CLI

로그인 위임 그룹을 연결하는 방법

다음 associate-signin-delegate-groups-with-account 예시에서는 지정된 로그인 위임 그룹을 지정된 Amazon Chime 계정과 연결합니다.

aws chime associate-signin-delegate-groups-with-account \
    --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \
    --signin-delegate-groups GroupName=my_users

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Amazon Chime 관리 안내서의 Managing User Access and Permissions' 섹션을 참조하세요.

다음 코드 예시에서는 batch-create-room-membership을 사용하는 방법을 보여 줍니다.

AWS CLI

여러 룸 멤버십을 생성하는 방법

다음 batch-create-room-membership 예시에서는 채팅룸에 여러 사용자를 채팅룸 멤버로 추가합니다. 또한 사용자에게 관리자 및 멤버 역할을 할당합니다.

aws chime batch-create-room-membership \
    --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \
    --room-id abcd1e2d-3e45-6789-01f2-3g45h67i890j \
    --membership-item-list "MemberId=1ab2345c-67de-8901-f23g-45h678901j2k,Role=Administrator" "MemberId=2ab2345c-67de-8901-f23g-45h678901j2k,Role=Member"

출력:

{
    "ResponseMetadata": {
        "RequestId": "169ba401-d886-475f-8b3f-e01eac6fadfb",
        "HTTPStatusCode": 201,
        "HTTPHeaders": {
            "x-amzn-requestid": "169ba401-d886-475f-8b3f-e01eac6fadfb",
            "content-type": "application/json",
            "content-length": "13",
            "date": "Mon, 02 Dec 2019 22:46:58 GMT",
            "connection": "keep-alive"
        },
        "RetryAttempts": 0
    },
    "Errors": []
}

자세한 내용은 Amazon Chime 사용 설명서의 채팅룸 생성을 참조하세요.

다음 코드 예시에서는 batch-delete-phone-number을 사용하는 방법을 보여 줍니다.

AWS CLI

여러 전화번호를 삭제하는 방법

다음 batch-delete-phone-number 예시에서는 지정된 전화번호를 모두 삭제합니다.

aws chime batch-delete-phone-number \
    --phone-number-ids "%2B12065550100" "%2B12065550101"

이 명령은 출력을 생성하지 않습니다. 출력:

{
    "PhoneNumberErrors": []
}

자세한 내용은 Amazon Chime 관리 안내서의 Working with Phone Numbers 섹션을 참조하세요.

다음 코드 예시에서는 batch-suspend-user을 사용하는 방법을 보여 줍니다.

AWS CLI

여러 사용자를 일시 중지하는 방법

다음 batch-suspend-user 예시에서는 지정된 Amazon Chime 계정에서 나열된 사용자를 일시 중지합니다.

aws chime batch-suspend-user \
    --account-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE \
    --user-id-list "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE" "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE" "a1b2c3d4-5678-90ab-cdef-44444EXAMPLE"

출력:

{
    "UserErrors": []
}

  • API 세부 정보는 AWS CLI 명령 참조의 BatchSuspendUser를 참조하세요.

다음 코드 예시에서는 batch-unsuspend-user을 사용하는 방법을 보여 줍니다.

AWS CLI

여러 사용자의 일시 중지를 취소하는 방법

다음 batch-unsuspend-user 예시에서는 지정된 Amazon Chime 계정의 나열된 사용자에 대한 모든 이전의 일시 중지를 제거합니다.

aws chime batch-unsuspend-user \
    --account-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE \
    --user-id-list "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE" "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE" "a1b2c3d4-5678-90ab-cdef-44444EXAMPLE"

출력:

{
    "UserErrors": []
}

다음 코드 예시에서는 batch-update-phone-number을 사용하는 방법을 보여 줍니다.

AWS CLI

여러 전화번호 제품 유형을 동시에 업데이트하는 방법

다음 batch-update-phone-number 예시에서는 지정된 모든 전화번호의 제품 유형을 업데이트합니다.

aws chime batch-update-phone-number \
    --update-phone-number-request-items PhoneNumberId=%2B12065550100,ProductType=BusinessCalling PhoneNumberId=%2B12065550101,ProductType=BusinessCalling

출력:

{
    "PhoneNumberErrors": []
}

여러 전화번호 호출 이름을 동시에 업데이트하는 방법

다음 batch-update-phone-number 예시에서는 지정된 모든 전화번호에 대한 호출 이름을 업데이트합니다.

aws chime batch-update-phone-number \
    --update-phone-number-request-items PhoneNumberId=%2B14013143874,CallingName=phonenumber1 PhoneNumberId=%2B14013144061,CallingName=phonenumber2

출력:

{
    "PhoneNumberErrors": []
}

자세한 내용은 Amazon Chime 관리 안내서의 Working with Phone Numbers 섹션을 참조하세요.

다음 코드 예시에서는 batch-update-user을 사용하는 방법을 보여 줍니다.

AWS CLI

단일 명령으로 여러 사용자를 업데이트하는 방법

다음 batch-update-user 예시에서는 지정된 Amazon Chime 계정에서 나열된 각 사용자에 대해 LicenseType을 업데이트합니다.

aws chime batch-update-user \
    --account-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE
    --update-user-request-items "UserId=a1b2c3d4-5678-90ab-cdef-22222EXAMPLE,LicenseType=Basic" "UserId=a1b2c3d4-5678-90ab-cdef-33333EXAMPLE,LicenseType=Basic"

출력:

{
    "UserErrors": []
}

  • API 세부 정보는 AWS CLI 명령 참조의 BatchUpdateUser를 참조하세요.

다음 코드 예시에서는 create-account을 사용하는 방법을 보여 줍니다.

AWS CLI

계정을 생성하려면

다음 create-account 예시에서는 관리자의 AWS 계정에서 Amazon Chime 계정을 생성합니다.

aws chime create-account \
    --name MyChimeAccount

출력:

{
    "Account": {
        "AwsAccountId": "111122223333",
        "AccountId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
        "Name": "MyChimeAccount",
        "AccountType": "Team",
        "CreatedTimestamp": "2019-01-04T17:11:22.003Z",
        "DefaultLicense": "Pro",
        "SupportedLicenses": [
            "Basic",
            "Pro"
        ],
        "SigninDelegateGroups": [
            {
                "GroupName": "myGroup"
            },
        ]
    }
}

자세한 내용은 Amazon Chime 관리 안내서의 Getting Started 섹션을 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 CreateAccount를 참조하세요.

다음 코드 예시에서는 create-bot을 사용하는 방법을 보여 줍니다.

AWS CLI

Amazon Chime 봇을 생성하는 방법

다음 create-bot 예시에서는 지정된 Amazon Chime Enterprise 계정에 대한 봇을 생성합니다.

aws chime create-bot \
    --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \
    --display-name "myBot" \
    --domain "example.com"

출력:

{
    "Bot": {
        "BotId": "123abcd4-5ef6-789g-0h12-34j56789012k",
        "UserId": "123abcd4-5ef6-789g-0h12-34j56789012k",
        "DisplayName": "myBot (Bot)",
        "BotType": "ChatBot",
        "Disabled": false,
        "CreatedTimestamp": "2019-09-09T18:05:56.749Z",
        "UpdatedTimestamp": "2019-09-09T18:05:56.749Z",
        "BotEmail": "myBot-chimebot@example.com",
        "SecurityToken": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"
    }
}

자세한 내용은 Amazon Chime 개발자 안내서의 Integrate a Chat Bot with Amazon Chime 섹션을 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 CreateBot을 참조하세요.

다음 코드 예시에서는 create-phone-number-order을 사용하는 방법을 보여 줍니다.

AWS CLI

전화번호 명령을 생성하는 방법

다음 create-phone-number-order 예시에서는 지정된 전화번호에 대한 전화번호 명령을 생성합니다.

aws chime create-phone-number-order \
    --product-type VoiceConnector \
    --e164-phone-numbers "+12065550100" "+12065550101" "+12065550102"

출력:

{
    "PhoneNumberOrder": {
        "PhoneNumberOrderId": "abc12345-de67-89f0-123g-h45i678j9012",
        "ProductType": "VoiceConnector",
        "Status": "Processing",
        "OrderedPhoneNumbers": [
            {
                "E164PhoneNumber": "+12065550100",
                "Status": "Processing"
            },
            {
               "E164PhoneNumber": "+12065550101",
               "Status": "Processing"
            },
            {
              "E164PhoneNumber": "+12065550102",
              "Status": "Processing"
            }
        ],
        "CreatedTimestamp": "2019-08-09T21:35:21.427Z",
        "UpdatedTimestamp": "2019-08-09T21:35:22.408Z"
    }
}

자세한 내용은 Amazon Chime 관리 안내서의 Working with Phone Numbers 섹션을 참조하세요.

다음 코드 예시에서는 create-proxy-session을 사용하는 방법을 보여 줍니다.

AWS CLI

프록시 세션을 생성하는 방법

다음 create-proxy-session 예시에서는 음성 및 SMS 기능을 사용하여 프록시 세션을 생성합니다.

aws chime create-proxy-session \
    --voice-connector-id abcdef1ghij2klmno3pqr4 \
    --participant-phone-numbers "+14015550101" "+12065550100" \
    --capabilities "Voice" "SMS"

출력:

{
    "ProxySession": {
        "VoiceConnectorId": "abcdef1ghij2klmno3pqr4",
        "ProxySessionId": "123a4bc5-67d8-901e-2f3g-h4ghjk56789l",
        "Status": "Open",
        "ExpiryMinutes": 60,
        "Capabilities": [
            "SMS",
            "Voice"
        ],
        "CreatedTimestamp": "2020-04-15T16:10:10.288Z",
        "UpdatedTimestamp": "2020-04-15T16:10:10.288Z",
        "Participants": [
            {
                "PhoneNumber": "+12065550100",
                "ProxyPhoneNumber": "+19135550199"
            },
            {
                "PhoneNumber": "+14015550101",
                "ProxyPhoneNumber": "+19135550199"
            }
        ]
    }
}

자세한 내용은 Amazon Chime 개발자 안내서의 Proxy Phone Sessions 섹션을 참조하세요.

다음 코드 예시에서는 create-room-membership을 사용하는 방법을 보여 줍니다.

AWS CLI

룸 멤버십을 생성하는 방법

다음 create-room-membership 예시에서는 지정된 사용자를 채팅룸에 채팅룸 멤버로 추가합니다.

aws chime create-room-membership \
    --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \
    --room-id abcd1e2d-3e45-6789-01f2-3g45h67i890j \
    --member-id 1ab2345c-67de-8901-f23g-45h678901j2k

출력:

{
    "RoomMembership": {
        "RoomId": "abcd1e2d-3e45-6789-01f2-3g45h67i890j",
        "Member": {
            "MemberId": "1ab2345c-67de-8901-f23g-45h678901j2k",
            "MemberType": "User",
            "Email": "janed@example.com",
            "FullName": "Jane Doe",
            "AccountId": "12a3456b-7c89-012d-3456-78901e23fg45"
        },
        "Role": "Member",
        "InvitedBy": "arn:aws:iam::111122223333:user/alejandro",
        "UpdatedTimestamp": "2019-12-02T22:36:41.969Z"
    }
}

자세한 내용은 Amazon Chime 사용 설명서의 채팅룸 생성을 참조하세요.

다음 코드 예시에서는 create-room을 사용하는 방법을 보여 줍니다.

AWS CLI

채팅룸을 만들려면

다음 create-room 예시에서는 지정된 Amazon Chime 계정에 대한 채팅룸을 생성합니다.

aws chime create-room \
    --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \
    --name chatRoom

출력:

{
    "Room": {
        "RoomId": "abcd1e2d-3e45-6789-01f2-3g45h67i890j",
        "Name": "chatRoom",
        "AccountId": "12a3456b-7c89-012d-3456-78901e23fg45",
        "CreatedBy": "arn:aws:iam::111122223333:user/alejandro",
        "CreatedTimestamp": "2019-12-02T22:29:31.549Z",
        "UpdatedTimestamp": "2019-12-02T22:29:31.549Z"
    }
}

자세한 내용은 Amazon Chime 사용 설명서의 채팅룸 생성을 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 CreateRoom을 참조하세요.

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

AWS CLI

공유 디바이스에 대한 사용자 프로파일을 생성하는 방법

다음 create-user 예시에서는 지정된 이메일 주소에 대한 공유 디바이스 프로파일을 생성합니다.

aws chime create-user \
    --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \
    --email roomdevice@example.com \
    --user-type SharedDevice

출력:

{
    "User": {
        "UserId": "1ab2345c-67de-8901-f23g-45h678901j2k",
        "AccountId": "12a3456b-7c89-012d-3456-78901e23fg45",
        "PrimaryEmail": "roomdevice@example.com",
        "DisplayName": "Room Device",
        "LicenseType": "Pro",
        "UserType": "SharedDevice",
        "UserRegistrationStatus": "Registered",
        "RegisteredOn": "2020-01-15T22:38:09.806Z",
        "AlexaForBusinessMetadata": {
            "IsAlexaForBusinessEnabled": false
        }
    }
}

자세한 내용은 Amazon Chime 관리 안내서의 Preparing for Setup 섹션을 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 CreateUser를 참조하세요.

다음 코드 예시에서는 create-voice-connector-group을 사용하는 방법을 보여 줍니다.

AWS CLI

Amazon Chime Voice Connector 그룹을 생성하는 방법

다음 create-voice-connector-group 예시에서는 지정된 Amazon Chime Voice Connector를 포함하는 Amazon Chime Voice Connector 그룹을 생성합니다.

aws chime create-voice-connector-group \
    --name myGroup \
    --voice-connector-items VoiceConnectorId=abcdef1ghij2klmno3pqr4,Priority=2

출력:

{
    "VoiceConnectorGroup": {
        "VoiceConnectorGroupId": "123a456b-c7d8-90e1-fg23-4h567jkl8901",
        "Name": "myGroup",
        "VoiceConnectorItems": [],
        "CreatedTimestamp": "2019-09-18T16:38:34.734Z",
        "UpdatedTimestamp": "2019-09-18T16:38:34.734Z"
    }
}

자세한 내용은 Amazon Chime 관리 안내서의 Working with Amazon Chime Voice Connector Groups 섹션을 참조하세요.

다음 코드 예시에서는 create-voice-connector을 사용하는 방법을 보여 줍니다.

AWS CLI

Amazon Chime Voice Connector를 생성하는 방법

다음 create-voice-connector 예시에서는 암호화가 활성화된 상태로, 지정된 AWS 리전에서 Amazon Chime Voice Connector를 생성합니다.

aws chime create-voice-connector \
    --name newVoiceConnector \
    --aws-region us-west-2 \
    --require-encryption

출력:

{
    "VoiceConnector": {
        "VoiceConnectorId": "abcdef1ghij2klmno3pqr4",
        "AwsRegion": "us-west-2",
        "Name": "newVoiceConnector",
        "OutboundHostName": "abcdef1ghij2klmno3pqr4.voiceconnector.chime.aws",
        "RequireEncryption": true,
        "CreatedTimestamp": "2019-09-18T20:34:01.352Z",
        "UpdatedTimestamp": "2019-09-18T20:34:01.352Z"
    }
}

자세한 내용은 Amazon Chime 관리 안내서의 Working with Amazon Chime Voice Connectors 섹션을 참조하세요.

다음 코드 예시에서는 delete-account을 사용하는 방법을 보여 줍니다.

AWS CLI

계정을 삭제하는 방법

다음 delete-account 예시에서는 지정된 계정을 삭제합니다.

aws chime delete-account --account-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Amazon Chime 관리 안내서의 Deleting Your Account 섹션을 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 DeleteAccount를 참조하세요.

다음 코드 예시에서는 delete-phone-number을 사용하는 방법을 보여 줍니다.

AWS CLI

전화번호를 삭제하는 방법

다음 delete-phone-number 예시에서는 지정된 전화번호를 삭제 대기열로 이동합니다.

aws chime delete-phone-number \
    --phone-number-id "+12065550100"

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Amazon Chime 관리 안내서의 Working with Phone Numbers 섹션을 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 DeletePhoneNumber를 참조하세요.

다음 코드 예시에서는 delete-proxy-session을 사용하는 방법을 보여 줍니다.

AWS CLI

프록시 세션을 삭제하는 방법

다음 delete-proxy-session 예시에서는 지정된 프록시 세션을 삭제합니다.

aws chime delete-proxy-session \
    --voice-connector-id abcdef1ghij2klmno3pqr4 \
    --proxy-session-id 123a4bc5-67d8-901e-2f3g-h4ghjk56789l

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Amazon Chime 개발자 안내서의 Proxy Phone Sessions 섹션을 참조하세요.

다음 코드 예시에서는 delete-room-membership을 사용하는 방법을 보여 줍니다.

AWS CLI

채팅룸의 멤버인 사용자를 제거하는 방법

다음 delete-room-membership 예시에서는 지정된 채팅룸에서 지정된 멤버를 제거합니다.

aws chime delete-room-membership \
    --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \
    --room-id abcd1e2d-3e45-6789-01f2-3g45h67i890j \
    --member-id 1ab2345c-67de-8901-f23g-45h678901j2k

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Amazon Chime 사용 설명서의 채팅룸 생성을 참조하세요.

다음 코드 예시에서는 delete-room을 사용하는 방법을 보여 줍니다.

AWS CLI

채팅방을 삭제하는 방법

다음 delete-room 예시에서는 지정된 채팅룸을 삭제하고 채팅룸 멤버십을 제거합니다.

aws chime delete-room \
    --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \
    --room-id abcd1e2d-3e45-6789-01f2-3g45h67i890j

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Amazon Chime 사용 설명서의 채팅룸 생성을 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 DeleteRoom을 참조하세요.

다음 코드 예시에서는 delete-voice-connector-group을 사용하는 방법을 보여 줍니다.

AWS CLI

제목

다음 delete-voice-connector-group 예시에서는 지정된 Amazon Chime Voice Connector 그룹을 삭제합니다.

aws chime delete-voice-connector-group \
    --voice-connector-group-id 123a456b-c7d8-90e1-fg23-4h567jkl8901

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Amazon Chime 관리 안내서의 Working with Amazon Chime Voice Connector Groups 섹션을 참조하세요.

다음 코드 예시에서는 delete-voice-connector-origination을 사용하는 방법을 보여 줍니다.

AWS CLI

시작 설정을 삭제하는 방법

다음 delete-voice-connector-origination 예시에서는 지정된 Amazon Chime Voice Connector에서 시작 호스트, 포트, 프로토콜, 우선순위 및 가중치를 삭제합니다.

aws chime delete-voice-connector-origination \
    --voice-connector-id abcdef1ghij2klmno3pqr4

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Amazon Chime 관리 안내서의 Working with Amazon Chime Voice Connectors 섹션을 참조하세요.

다음 코드 예시에서는 delete-voice-connector-proxy을 사용하는 방법을 보여 줍니다.

AWS CLI

프록시 구성을 삭제하는 방법

다음 delete-voice-connector-proxy 예시에서는 Amazon Chime Voice Connector에서 프록시 구성을 삭제합니다.

aws chime delete-voice-connector-proxy \
    --voice-connector-id abcdef1ghij2klmno3pqr4

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Amazon Chime 개발자 안내서의 Proxy Phone Sessions 섹션을 참조하세요.

다음 코드 예시에서는 delete-voice-connector-streaming-configuration을 사용하는 방법을 보여 줍니다.

AWS CLI

스트리밍 구성을 삭제하는 방법

다음 delete-voice-connector-streaming-configuration 예시에서는 지정된 Amazon Chime Voice Connector에 대한 스트리밍 구성을 삭제합니다.

aws chime delete-voice-connector-streaming-configuration \
    --voice-connector-id abcdef1ghij2klmno3pqr4

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Amazon Chime 관리 안내서의 Streaming Amazon Chime Voice Connector Data to Kinesis 섹션을 참조하세요.

다음 코드 예시에서는 delete-voice-connector-termination-credentials을 사용하는 방법을 보여 줍니다.

AWS CLI

종료 자격 증명을 삭제하는 방법

다음 delete-voice-connector-termination-credentials 예시에서는 지정된 사용자 이름 및 Amazon Chime Voice Connector에 대한 종료 자격 증명을 삭제합니다.

aws chime delete-voice-connector-termination-credentials \
    --voice-connector-id abcdef1ghij2klmno3pqr4 \
    --usernames "jdoe"

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Amazon Chime 관리 안내서의 Working with Amazon Chime Voice Connectors 섹션을 참조하세요.

다음 코드 예시에서는 delete-voice-connector-termination을 사용하는 방법을 보여 줍니다.

AWS CLI

종료 설정을 삭제하는 방법

다음 delete-voice-connector-termination 예시에서는 지정된 Amazon Chime Voice Connector에 대한 종료 설정을 삭제합니다.

aws chime delete-voice-connector-termination \
    --voice-connector-id abcdef1ghij2klmno3pqr4

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Amazon Chime 관리 안내서의 Working with Amazon Chime Voice Connectors 섹션을 참조하세요.

다음 코드 예시에서는 delete-voice-connector을 사용하는 방법을 보여 줍니다.

AWS CLI

Amazon Chime Voice Connector를 삭제하는 방법

다음 delete-voice-connector 예시에서는 다음을 수행합니다.

aws chime delete-voice-connector \
    --voice-connector-id abcdef1ghij2klmno3pqr4

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Amazon Chime 관리 안내서의 Working with Amazon Chime Voice Connectors 섹션을 참조하세요.

다음 코드 예시에서는 disassociate-phone-number-from-user을 사용하는 방법을 보여 줍니다.

AWS CLI

사용자와 전화번호의 연결을 해제하는 방법

다음 disassociate-phone-number-from-user 예시에서는 지정된 사용자에서 전화번호의 연결을 해제합니다.

aws chime disassociate-phone-number-from-user \
    --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \
    --user-id 1ab2345c-67de-8901-f23g-45h678901j2k

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Amazon Chime 관리 안내서의 Managing User Phone Numbers 섹션을 참조하세요.

다음 코드 예시에서는 disassociate-phone-numbers-from-voice-connector-group을 사용하는 방법을 보여 줍니다.

AWS CLI

Amazon Chime Voice Connector 그룹과 전화번호의 연결을 해제하는 방법

다음 disassociate-phone-numbers-from-voice-connector-group 예시에서는 Amazon Chime Voice Connector 그룹에서 지정된 전화번호의 연결을 해제합니다.

aws chime disassociate-phone-numbers-from-voice-connector-group \
    --voice-connector-group-id 123a456b-c7d8-90e1-fg23-4h567jkl8901 \
    --e164-phone-numbers "+12065550100" "+12065550101"

출력:

{
    "PhoneNumberErrors": []
}

자세한 내용은 Amazon Chime 관리 안내서의 Working with Amazon Chime Voice Connector Groups 섹션을 참조하세요.

다음 코드 예시에서는 disassociate-phone-numbers-from-voice-connector을 사용하는 방법을 보여 줍니다.

AWS CLI

Amazon Chime Voice Connector와 전화번호의 연결을 해제하는 방법

다음 disassociate-phone-numbers-from-voice-connector 예시에서는 Amazon Chime Voice Connector에서 지정된 전화번호의 연결을 해제합니다.

aws chime disassociate-phone-numbers-from-voice-connector \
    --voice-connector-id abcdef1ghij2klmno3pqr4 \
    --e164-phone-numbers "+12065550100" "+12065550101"

출력:

{
    "PhoneNumberErrors": []
}

자세한 내용은 Amazon Chime 관리 안내서의 Working with Amazon Chime Voice Connectors 섹션을 참조하세요.

다음 코드 예시에서는 disassociate-signin-delegate-groups-from-account을 사용하는 방법을 보여 줍니다.

AWS CLI

로그인 위임 그룹의 연결을 해제하는 방법

다음 disassociate-signin-delegate-groups-from-account 예시에서는 지정된 Amazon Chime 계정에서 지정된 로그인 위임 그룹의 연결을 해제합니다.

aws chime disassociate-signin-delegate-groups-from-account \
    --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \
    --group-names "my_users"

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Amazon Chime 관리 안내서의 Managing User Access and Permissions' 섹션을 참조하세요.

다음 코드 예시에서는 get-account-settings을 사용하는 방법을 보여 줍니다.

AWS CLI

계정의 설정을 검색하는 방법

다음 get-account-settings 예시에서는 지정된 계정에 대한 계정 설정을 검색합니다.

aws chime get-account-settings --account-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE

출력:

{
    "AccountSettings": {
        "DisableRemoteControl": false,
        "EnableDialOut": false
    }
}

자세한 내용은 Amazon Chime 관리 안내서의 Managing Your Amazon Chime Accounts 섹션을 참조하세요.

다음 코드 예시에서는 get-account을 사용하는 방법을 보여 줍니다.

AWS CLI

계정의 세부 정보를 검색하는 방법

다음 get-account 예시에서는 지정된 Amazon Chime 계정에 대한 세부 정보를 검색합니다.

aws chime get-account \
    --account-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE

출력:

{
    "Account": {
        "AwsAccountId": "111122223333",
        "AccountId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
        "Name": "EnterpriseDirectory",
        "AccountType": "EnterpriseDirectory",
        "CreatedTimestamp": "2018-12-20T18:38:02.181Z",
        "DefaultLicense": "Pro",
        "SupportedLicenses": [
            "Basic",
            "Pro"
        ],
        "SigninDelegateGroups": [
            {
                "GroupName": "myGroup"
            },
        ]
    }
}

자세한 내용은 Amazon Chime 관리 안내서의 Managing Your Amazon Chime Accounts 섹션을 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 GetAccount를 참조하세요.

다음 코드 예시에서는 get-bot을 사용하는 방법을 보여 줍니다.

AWS CLI

봇에 대한 세부 정보를 검색하는 방법

다음 get-bot 예시에서는 지정된 봇의 세부 정보를 표시합니다.

aws chime get-bot \
    --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \
    --bot-id 123abcd4-5ef6-789g-0h12-34j56789012k

출력:

{
    "Bot": {
        "BotId": "123abcd4-5ef6-789g-0h12-34j56789012k",
        "UserId": "123abcd4-5ef6-789g-0h12-34j56789012k",
        "DisplayName": "myBot (Bot)",
        "BotType": "ChatBot",
        "Disabled": false,
        "CreatedTimestamp": "2019-09-09T18:05:56.749Z",
        "UpdatedTimestamp": "2019-09-09T18:05:56.749Z",
        "BotEmail": "myBot-chimebot@example.com",
        "SecurityToken": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"
    }
}

자세한 내용은 Amazon Chime 개발자 안내서의 Update Chat Bots 섹션을 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 GetBot을 참조하세요.

다음 코드 예시에서는 get-global-settings을 사용하는 방법을 보여 줍니다.

AWS CLI

전역 설정을 가져오는 방법

다음 get-global-settings 예시에서는 관리자의 AWS 계정과 연결된 Amazon Chime Business Calling 및 Amazon Chime Voice Connector에 대한 통화 세부 정보 레코드를 보관하는 데 사용되는 S3 버킷 이름을 검색합니다.

aws chime get-global-settings

출력:

{
    "BusinessCalling": {
        "CdrBucket": "s3bucket"
    },
    "VoiceConnector": {
        "CdrBucket": "s3bucket"
    }
}

자세한 내용은 Amazon Chime 관리 안내서의 Managing Global Settings 섹션을 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 GetGlobalSettings를 참조하세요.

다음 코드 예시에서는 get-phone-number-order을 사용하는 방법을 보여 줍니다.

AWS CLI

전화번호 명령에 대한 세부 정보를 가져오는 방법

다음 get-phone-number-order 예시에서는 지정된 전화번호 명령의 세부 정보를 표시합니다.

aws chime get-phone-number-order \
    --phone-number-order-id abc12345-de67-89f0-123g-h45i678j9012

출력:

{
    "PhoneNumberOrder": {
        "PhoneNumberOrderId": "abc12345-de67-89f0-123g-h45i678j9012",
        "ProductType": "VoiceConnector",
        "Status": "Partial",
        "OrderedPhoneNumbers": [
            {
              "E164PhoneNumber": "+12065550100",
              "Status": "Acquired"
            },
            {
                "E164PhoneNumber": "+12065550101",
                "Status": "Acquired"
            },
            {
                "E164PhoneNumber": "+12065550102",
                "Status": "Failed"
            }
        ],
        "CreatedTimestamp": "2019-08-09T21:35:21.427Z",
        "UpdatedTimestamp": "2019-08-09T21:35:31.926Z"
    }
}

자세한 내용은 Amazon Chime 관리 안내서의 Working with Phone Numbers 섹션을 참조하세요.

다음 코드 예시에서는 get-phone-number-settings을 사용하는 방법을 보여 줍니다.

AWS CLI

발신 호출 이름을 검색하는 방법

다음 get-phone-number-settings 예시에서는 발신 사용자의 AWS 계정에 대한 기본 발신 호출 이름을 검색합니다.

aws chime get-phone-number-settings

이 명령은 출력을 생성하지 않습니다. 출력:

{
    "CallingName": "myName",
    "CallingNameUpdatedTimestamp": "2019-10-28T18:56:42.911Z"
}

자세한 내용은 Amazon Chime 관리 안내서의 Working with Phone Numbers 섹션을 참조하세요.

다음 코드 예시에서는 get-phone-number을 사용하는 방법을 보여 줍니다.

AWS CLI

전화번호 세부 정보를 가져오는 방법

다음 get-phone-number 예시에서는 지정된 전화번호의 세부 정보를 표시합니다.

aws chime get-phone-number \
    --phone-number-id +12065550100

출력:

{
    "PhoneNumber": {
        "PhoneNumberId": "%2B12065550100",
        "E164PhoneNumber": "+12065550100",
        "Type": "Local",
        "ProductType": "VoiceConnector",
        "Status": "Unassigned",
        "Capabilities": {
            "InboundCall": true,
            "OutboundCall": true,
            "InboundSMS": true,
            "OutboundSMS": true,
            "InboundMMS": true,
            "OutboundMMS": true
        },
       "Associations": [
            {
                "Value": "abcdef1ghij2klmno3pqr4",
                "Name": "VoiceConnectorId",
                "AssociatedTimestamp": "2019-10-28T18:40:37.453Z"
            }
        ],
        "CallingNameStatus": "UpdateInProgress",
        "CreatedTimestamp": "2019-08-09T21:35:21.445Z",
        "UpdatedTimestamp": "2019-08-09T21:35:31.745Z"
    }
}

자세한 내용은 Amazon Chime 관리 안내서의 Working with Phone Numbers 섹션을 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 GetPhoneNumber를 참조하세요.

다음 코드 예시에서는 get-proxy-session을 사용하는 방법을 보여 줍니다.

AWS CLI

프록시 세션 세부 정보를 가져오는 방법

다음 get-proxy-session 예시에서는 지정된 프록시 세션의 세부 정보를 나열합니다.

aws chime get-proxy-session \
    --voice-connector-id abcdef1ghij2klmno3pqr4 \
    --proxy-session-id 123a4bc5-67d8-901e-2f3g-h4ghjk56789l

출력:

{
    "ProxySession": {
        "VoiceConnectorId": "abcdef1ghij2klmno3pqr4",
        "ProxySessionId": "123a4bc5-67d8-901e-2f3g-h4ghjk56789l",
        "Status": "Open",
        "ExpiryMinutes": 60,
        "Capabilities": [
            "SMS",
            "Voice"
        ],
        "CreatedTimestamp": "2020-04-15T16:10:10.288Z",
        "UpdatedTimestamp": "2020-04-15T16:10:10.288Z",
        "Participants": [
            {
                "PhoneNumber": "+12065550100",
                "ProxyPhoneNumber": "+19135550199"
            },
            {
                "PhoneNumber": "+14015550101",
                "ProxyPhoneNumber": "+19135550199"
            }
        ]
    }
}

자세한 내용은 Amazon Chime 개발자 안내서의 Proxy Phone Sessions 섹션을 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 GetProxySession을 참조하세요.

다음 코드 예시에서는 get-room을 사용하는 방법을 보여 줍니다.

AWS CLI

채팅룸에 대한 세부 정보를 가져오는 방법

다음 get-room 예시에서는 지정된 채팅룸에 대한 세부 정보를 표시합니다.

aws chime get-room \
    --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \
    --room-id abcd1e2d-3e45-6789-01f2-3g45h67i890j

출력:

{
    "Room": {
        "RoomId": "abcd1e2d-3e45-6789-01f2-3g45h67i890j",
        "Name": "chatRoom",
        "AccountId": "12a3456b-7c89-012d-3456-78901e23fg45",
        "CreatedBy": "arn:aws:iam::111122223333:user/alejandro",
        "CreatedTimestamp": "2019-12-02T22:29:31.549Z",
        "UpdatedTimestamp": "2019-12-02T22:29:31.549Z"
    }
}

자세한 내용은 Amazon Chime 사용 설명서의 채팅룸 생성을 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 GetRoom을 참조하세요.

다음 코드 예시에서는 get-user-settings을 사용하는 방법을 보여 줍니다.

AWS CLI

사용자 설정을 검색하는 방법

다음 get-user-settings 예시에서는 지정된 사용자 설정을 표시합니다.

aws chime get-user-settings \
    --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \
    --user-id 1ab2345c-67de-8901-f23g-45h678901j2k

출력:

{
    "UserSettings": {
        "Telephony": {
            "InboundCalling": true,
            "OutboundCalling": true,
            "SMS": true
        }
    }
}

자세한 내용은 Amazon Chime 관리 안내서의 Managing User Phone Numbers 섹션을 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 GetUserSettings를 참조하세요.

다음 코드 예시에서는 get-user을 사용하는 방법을 보여 줍니다.

AWS CLI

사용자에 대한 세부 정보를 가져오는 방법

다음 get-user 예시에서는 지정된 사용자에 대한 세부 정보를 검색합니다.

aws chime get-user \
    --account-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE \
    --user-id a1b2c3d4-5678-90ab-cdef-22222EXAMPLE

출력:

{
    "User": {
        "UserId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
        "AccountId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
        "PrimaryEmail": "marthar@example.com",
        "DisplayName": "Martha Rivera",
        "LicenseType": "Pro",
        "UserRegistrationStatus": "Registered",
        "RegisteredOn": "2018-12-20T18:45:25.231Z",
        "InvitedOn": "2018-12-20T18:45:25.231Z",
        "AlexaForBusinessMetadata": {
            "IsAlexaForBusinessEnabled": False,
            "AlexaForBusinessRoomArn": "null"
        },
        "PersonalPIN": "XXXXXXXXXX"
    }
}

자세한 내용은 Amazon Chime 관리 안내서의 Managing Users 섹션을 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 GetUser를 참조하세요.

다음 코드 예시에서는 get-voice-connector-group을 사용하는 방법을 보여 줍니다.

AWS CLI

Amazon Chime Voice Connector 그룹에 대한 세부 정보를 가져오는 방법

다음 get-voice-connector-group 예시에서는 지정된 Amazon Chime Voice Connector 그룹에 대한 세부 정보를 표시합니다.

aws chime get-voice-connector-group \
    --voice-connector-group-id 123a456b-c7d8-90e1-fg23-4h567jkl8901

출력:

{
    "VoiceConnectorGroup": {
        "VoiceConnectorGroupId": "123a456b-c7d8-90e1-fg23-4h567jkl8901",
        "Name": "myGroup",
        "VoiceConnectorItems": [],
        "CreatedTimestamp": "2019-09-18T16:38:34.734Z",
        "UpdatedTimestamp": "2019-09-18T16:38:34.734Z"
    }
}

자세한 내용은 Amazon Chime 관리 안내서의 Working with Amazon Chime Voice Connector Groups 섹션을 참조하세요.

다음 코드 예시에서는 get-voice-connector-logging-configuration을 사용하는 방법을 보여 줍니다.

AWS CLI

로깅 구성 세부 정보를 가져오는 방법

다음 get-voice-connector-logging-configuration 예시에서는 지정된 Amazon Chime Voice Connector에 대한 로깅 구성 세부 정보를 검색합니다.

aws chime get-voice-connector-logging-configuration \
    --voice-connector-id abcdef1ghij2klmno3pqr4

출력:

{
    "LoggingConfiguration": {
        "EnableSIPLogs": true
    }
}

자세한 내용은 Amazon Chime 관리 안내서의 Streaming Amazon Chime Voice Connector Media to Kinesis 섹션을 참조하세요.

다음 코드 예시에서는 get-voice-connector-origination을 사용하는 방법을 보여 줍니다.

AWS CLI

시작 설정을 검색하는 방법

다음 get-voice-connector-origination 예시에서는 지정된 Amazon Chime Voice Connector에 대한 시작 호스트, 포트, 프로토콜, 우선순위 및 가중치를 검색합니다.

aws chime get-voice-connector-origination \
    --voice-connector-id abcdef1ghij2klmno3pqr4

출력:

{
    "Origination": {
        "Routes": [
            {
                "Host": "10.24.34.0",
                "Port": 1234,
                "Protocol": "TCP",
                "Priority": 1,
                "Weight": 5
            }
        ],
        "Disabled": false
    }
}

자세한 내용은 Amazon Chime 관리 안내서의 Working with Amazon Chime Voice Connectors 섹션을 참조하세요.

다음 코드 예시에서는 get-voice-connector-proxy을 사용하는 방법을 보여 줍니다.

AWS CLI

프록시 구성 세부 정보를 가져오는 방법

다음 get-voice-connector-proxy 예시에서는 Amazon Chime Voice Connector에 대한 프록시 구성 세부 정보를 가져옵니다.

aws chime get-voice-connector-proxy \
    --voice-connector-id abcdef1ghij2klmno3pqr4

출력:

{
    "Proxy": {
        "DefaultSessionExpiryMinutes": 60,
        "Disabled": false,
        "PhoneNumberCountries": [
            "US"
        ]
    }
}

자세한 내용은 Amazon Chime 개발자 안내서의 Proxy Phone Sessions 섹션을 참조하세요.

다음 코드 예시에서는 get-voice-connector-streaming-configuration을 사용하는 방법을 보여 줍니다.

AWS CLI

스트리밍 구성 세부 정보를 가져오는 방법

다음 get-voice-connector-streaming-configuration 예시에서는 지정된 Amazon Chime Voice Connector에 대한 스트리밍 구성 세부 정보를 가져옵니다.

aws chime get-voice-connector-streaming-configuration \
    --voice-connector-id abcdef1ghij2klmno3pqr4

출력:

{
    "StreamingConfiguration": {
        "DataRetentionInHours": 24,
        "Disabled": false
    }
}

자세한 내용은 Amazon Chime 관리 안내서의 Streaming Amazon Chime Voice Connector Data to Kinesis 섹션을 참조하세요.

다음 코드 예시에서는 get-voice-connector-termination-health을 사용하는 방법을 보여 줍니다.

AWS CLI

종료 상태 세부 정보를 검색하는 방법

다음 get-voice-connector-termination-health 예시에서는 지정된 Amazon Chime Voice Connector에 대한 종료 상태 세부 정보를 검색합니다.

aws chime get-voice-connector-termination-health \
    --voice-connector-id abcdef1ghij2klmno3pqr4

출력:

{
    "TerminationHealth": {
        "Timestamp": "Fri Aug 23 16:45:55 UTC 2019",
        "Source": "10.24.34.0"
    }
}

자세한 내용은 Amazon Chime 관리 안내서의 Working with Amazon Chime Voice Connectors 섹션을 참조하세요.

다음 코드 예시에서는 get-voice-connector-termination을 사용하는 방법을 보여 줍니다.

AWS CLI

종료 설정을 검색하는 방법

다음 get-voice-connector-termination 예시에서는 지정된 Amazon Chime Voice Connector에 대한 종료 설정을 검색합니다.

aws chime get-voice-connector-termination \
    --voice-connector-id abcdef1ghij2klmno3pqr4

이 명령은 출력을 생성하지 않습니다. 출력:

{
    "Termination": {
        "CpsLimit": 1,
        "DefaultPhoneNumber": "+12065550100",
        "CallingRegions": [
            "US"
        ],
        "CidrAllowedList": [
            "10.24.34.0/23"
        ],
        "Disabled": false
    }
}

자세한 내용은 Amazon Chime 관리 안내서의 Working with Amazon Chime Voice Connectors 섹션을 참조하세요.

다음 코드 예시에서는 get-voice-connector을 사용하는 방법을 보여 줍니다.

AWS CLI

Amazon Chime Voice Connector에 대한 세부 정보를 가져오는 방법

다음 get-voice-connector 예시에서는 지정된 Amazon Chime Voice Connector의 세부 정보를 표시합니다.

aws chime get-voice-connector \
    --voice-connector-id abcdef1ghij2klmno3pqr4

출력:

{
    "VoiceConnector": {
        "VoiceConnectorId": "abcdef1ghij2klmno3pqr4",
        "AwsRegion": "us-west-2",
        "Name": "newVoiceConnector",
        "OutboundHostName": "abcdef1ghij2klmno3pqr4.voiceconnector.chime.aws",
        "RequireEncryption": true,
        "CreatedTimestamp": "2019-09-18T20:34:01.352Z",
        "UpdatedTimestamp": "2019-09-18T20:34:01.352Z"
    }
}

자세한 내용은 Amazon Chime 관리 안내서의 Working with Amazon Chime Voice Connectors 섹션을 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 GetVoiceConnector를 참조하세요.

다음 코드 예시에서는 invite-users을 사용하는 방법을 보여 줍니다.

AWS CLI

사용자를 Amazon Chime에 가입하도록 초대하는 방법

다음 invite-users 예시에서는 사용자를 지정된 Amazon Chime 계정에 초대하는 이메일을 보냅니다.

aws chime invite-users \
    --account-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE \
    --user-email-list "alejandror@example.com" "janed@example.com"

출력:

{
    "Invites": [
        {
            "InviteId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
            "Status": "Pending",
            "EmailAddress": "alejandror@example.com",
            "EmailStatus": "Sent"
        }
        {
            "InviteId": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
            "Status": "Pending",
            "EmailAddress": "janed@example.com",
            "EmailStatus": "Sent"
        }
    ]
}

자세한 내용은 Amazon Chime 관리 안내서의 Inviting and Suspending Users 섹션을 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 InviteUsers를 참조하세요.

다음 코드 예시에서는 list-accounts을 사용하는 방법을 보여 줍니다.

AWS CLI

계정 목록을 가져오는 방법

다음 list-accounts 예시에서는 관리자의 AWS 계정에서 Amazon Chime 계정 목록을 검색합니다.

aws chime list-accounts

출력:

{
    "Accounts": [
        {
            "AwsAccountId": "111122223333",
            "AccountId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
            "Name": "First Chime Account",
            "AccountType": "EnterpriseDirectory",
            "CreatedTimestamp": "2018-12-20T18:38:02.181Z",
            "DefaultLicense": "Pro",
            "SupportedLicenses": [
                "Basic",
                "Pro"
            ],
            "SigninDelegateGroups": [
                {
                    "GroupName": "myGroup"
                },
            ]
        },
        {
            "AwsAccountId": "111122223333",
            "AccountId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
            "Name": "Second Chime Account",
            "AccountType": "Team",
            "CreatedTimestamp": "2018-09-04T21:44:22.292Z",
            "DefaultLicense": "Pro",
            "SupportedLicenses": [
                "Basic",
                "Pro"
            ],
            "SigninDelegateGroups": [
                {
                    "GroupName": "myGroup"
                },
            ]
        }
    ]
}

자세한 내용은 Amazon Chime 관리 안내서의 Managing Your Amazon Chime Accounts 섹션을 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 ListAccounts를 참조하세요.

다음 코드 예시에서는 list-bots을 사용하는 방법을 보여 줍니다.

AWS CLI

봇 목록을 검색하는 방법

다음 list-bots 예시에서는 지정된 Amazon Chime Enterprise 계정과 연결된 봇을 나열합니다.

aws chime list-bots \
    --account-id 12a3456b-7c89-012d-3456-78901e23fg45

출력:

{
    "Bot": {
        "BotId": "123abcd4-5ef6-789g-0h12-34j56789012k",
        "UserId": "123abcd4-5ef6-789g-0h12-34j56789012k",
        "DisplayName": "myBot (Bot)",
        "BotType": "ChatBot",
        "Disabled": false,
        "CreatedTimestamp": "2019-09-09T18:05:56.749Z",
        "UpdatedTimestamp": "2019-09-09T18:05:56.749Z",
        "BotEmail": "myBot-chimebot@example.com",
        "SecurityToken": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"
    }
}

자세한 내용은 Amazon Chime 개발자 안내서의 Use Chat Bots with Amazon Chime 섹션을 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 ListBots를 참조하세요.

다음 코드 예시에서는 list-phone-number-orders을 사용하는 방법을 보여 줍니다.

AWS CLI

전화번호 명령을 나열하는 방법

다음 list-phone-number-orders 예시에서는 Amazon Chime 관리자의 계정과 연결된 전화번호 명령을 나열합니다.

aws chime list-phone-number-orders

출력:

{
    "PhoneNumberOrders": [
        {
            "PhoneNumberOrderId": "abc12345-de67-89f0-123g-h45i678j9012",
            "ProductType": "VoiceConnector",
            "Status": "Partial",
            "OrderedPhoneNumbers": [
                {
                    "E164PhoneNumber": "+12065550100",
                    "Status": "Acquired"
                },
                {
                    "E164PhoneNumber": "+12065550101",
                    "Status": "Acquired"
                },
                {
                    "E164PhoneNumber": "+12065550102",
                    "Status": "Failed"
                }
            ],
            "CreatedTimestamp": "2019-08-09T21:35:21.427Z",
            "UpdatedTimestamp": "2019-08-09T21:35:31.926Z"
        }
        {
            "PhoneNumberOrderId": "cba54321-ed76-09f5-321g-h54i876j2109",
            "ProductType": "BusinessCalling",
            "Status": "Partial",
            "OrderedPhoneNumbers": [
                {
                    "E164PhoneNumber": "+12065550103",
                    "Status": "Acquired"
                },
                {
                    "E164PhoneNumber": "+12065550104",
                    "Status": "Acquired"
                },
                {
                    "E164PhoneNumber": "+12065550105",
                    "Status": "Failed"
                }
            ],
            "CreatedTimestamp": "2019-08-09T21:35:21.427Z",
            "UpdatedTimestamp": "2019-08-09T21:35:31.926Z"
        }
    ]
}

자세한 내용은 Amazon Chime 관리 안내서의 Working with Phone Numbers 섹션을 참조하세요.

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

AWS CLI

Amazon Chime 계정의 전화번호를 나열하는 방법

다음 list-phone-numbers 예시에서는 관리자의 Amazon Chime 계정과 연결된 전화번호를 나열합니다.

aws chime list-phone-numbers

이 명령은 출력을 생성하지 않습니다. 출력:

{
    "PhoneNumbers": [
        {
            "PhoneNumberId": "%2B12065550100",
            "E164PhoneNumber": "+12065550100",
            "Type": "Local",
            "ProductType": "VoiceConnector",
            "Status": "Assigned",
            "Capabilities": {
                "InboundCall": true,
                "OutboundCall": true,
                "InboundSMS": true,
                "OutboundSMS": true,
                "InboundMMS": true,
                "OutboundMMS": true
            },
            "Associations": [
                {
                    "Value": "abcdef1ghij2klmno3pqr4",
                    "Name": "VoiceConnectorId",
                    "AssociatedTimestamp": "2019-10-28T18:40:37.453Z"
                }
            ],
            "CallingNameStatus": "UpdateInProgress",
            "CreatedTimestamp": "2019-08-12T22:10:20.521Z",
            "UpdatedTimestamp": "2019-10-28T18:42:07.964Z"
        },
        {
            "PhoneNumberId": "%2B12065550101",
            "E164PhoneNumber": "+12065550101",
            "Type": "Local",
            "ProductType": "VoiceConnector",
            "Status": "Assigned",
            "Capabilities": {
                "InboundCall": true,
                "OutboundCall": true,
                "InboundSMS": true,
                "OutboundSMS": true,
                "InboundMMS": true,
                "OutboundMMS": true
            },
            "Associations": [
                {
                    "Value": "abcdef1ghij2klmno3pqr4",
                    "Name": "VoiceConnectorId",
                    "AssociatedTimestamp": "2019-10-28T18:40:37.511Z"
                }
            ],
            "CallingNameStatus": "UpdateInProgress",
            "CreatedTimestamp": "2019-08-12T22:10:20.521Z",
            "UpdatedTimestamp": "2019-10-28T18:42:07.960Z"
        }
    ]
}

자세한 내용은 Amazon Chime 관리 안내서의 Working with Phone Numbers 섹션을 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 ListTagsForVault를 참조하세요.

다음 코드 예시에서는 list-proxy-sessions을 사용하는 방법을 보여 줍니다.

AWS CLI

프록시 세션을 나열하는 방법

다음 list-proxy-sessions 예시에서는 Amazon Chime Voice Connector에 대한 프록시 세션을 나열합니다.

aws chime list-proxy-sessions \
    --voice-connector-id abcdef1ghij2klmno3pqr4

출력:

{
    "ProxySession": {
        "VoiceConnectorId": "abcdef1ghij2klmno3pqr4",
        "ProxySessionId": "123a4bc5-67d8-901e-2f3g-h4ghjk56789l",
        "Status": "Open",
        "ExpiryMinutes": 60,
        "Capabilities": [
            "SMS",
            "Voice"
        ],
        "CreatedTimestamp": "2020-04-15T16:10:10.288Z",
        "UpdatedTimestamp": "2020-04-15T16:10:10.288Z",
        "Participants": [
            {
                "PhoneNumber": "+12065550100",
                "ProxyPhoneNumber": "+19135550199"
            },
            {
                "PhoneNumber": "+14015550101",
                "ProxyPhoneNumber": "+19135550199"
            }
        ]
    }
}

자세한 내용은 Amazon Chime 개발자 안내서의 Proxy Phone Sessions 섹션을 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 ListProxySessions를 참조하세요.

다음 코드 예시에서는 list-room-memberships을 사용하는 방법을 보여 줍니다.

AWS CLI

룸 멤버십을 나열하는 방법

다음 list-room-memberships 예시에서는 지정된 채팅룸에 대한 멤버십 세부 정보의 목록을 표시합니다.

aws chime list-room-memberships \
    --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \
    --room-id abcd1e2d-3e45-6789-01f2-3g45h67i890j

출력:

{
    "RoomMemberships": [
        {
            "RoomId": "abcd1e2d-3e45-6789-01f2-3g45h67i890j",
            "Member": {
                "MemberId": "2ab2345c-67de-8901-f23g-45h678901j2k",
                "MemberType": "User",
                "Email": "zhangw@example.com",
                "FullName": "Zhang Wei",
                "AccountId": "12a3456b-7c89-012d-3456-78901e23fg45"
            },
            "Role": "Member",
            "InvitedBy": "arn:aws:iam::111122223333:user/alejandro",
            "UpdatedTimestamp": "2019-12-02T22:46:58.532Z"
        },
        {
            "RoomId": "abcd1e2d-3e45-6789-01f2-3g45h67i890j",
            "Member": {
                "MemberId": "1ab2345c-67de-8901-f23g-45h678901j2k",
                "MemberType": "User",
                "Email": "janed@example.com",
                "FullName": "Jane Doe",
                "AccountId": "12a3456b-7c89-012d-3456-78901e23fg45"
            },
            "Role": "Administrator",
            "InvitedBy": "arn:aws:iam::111122223333:user/alejandro",
            "UpdatedTimestamp": "2019-12-02T22:46:58.532Z"
        }
    ]
}

자세한 내용은 Amazon Chime 사용 설명서의 채팅룸 생성을 참조하세요.

다음 코드 예시에서는 list-rooms을 사용하는 방법을 보여 줍니다.

AWS CLI

채팅룸을 나열하는 방법

다음 list-rooms 예시에서는 지정된 계정에서 채팅룸의 목록을 표시합니다. 이 목록은 지정된 멤버가 속한 채팅룸만 나열하도록 필터링됩니다.

aws chime list-rooms \
    --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \
    --member-id 1ab2345c-67de-8901-f23g-45h678901j2k

출력:

{
    "Room": {
        "RoomId": "abcd1e2d-3e45-6789-01f2-3g45h67i890j",
        "Name": "teamRoom",
        "AccountId": "12a3456b-7c89-012d-3456-78901e23fg45",
        "CreatedBy": "arn:aws:iam::111122223333:user/alejandro",
        "CreatedTimestamp": "2019-12-02T22:29:31.549Z",
        "UpdatedTimestamp": "2019-12-02T22:33:19.310Z"
    }
}

자세한 내용은 Amazon Chime 사용 설명서의 채팅룸 생성을 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 ListRooms를 참조하세요.

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

AWS CLI

계정 내 모든 사용자를 나열하는 방법

다음 list-users 예시에서는 지정된 Amazon Chime 계정에 대한 사용자를 나열합니다.

aws chime list-users --account-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE

출력:

{
    "Users": [
        {
            "UserId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
            "AccountId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
            "PrimaryEmail": "mariag@example.com",
            "DisplayName": "Maria Garcia",
            "LicenseType": "Pro",
            "UserType": "PrivateUser",
            "UserRegistrationStatus": "Registered",
            "RegisteredOn": "2018-12-20T18:45:25.231Z"
            "AlexaForBusinessMetadata": {
                "IsAlexaForBusinessEnabled": false
            }
        },
        {
            "UserId": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
            "AccountId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
            "PrimaryEmail": "richardr@example.com",
            "DisplayName": "Richard Roe",
            "LicenseType": "Pro",
            "UserType": "PrivateUser",
            "UserRegistrationStatus": "Registered",
            "RegisteredOn": "2018-12-20T18:45:45.415Z"
            "AlexaForBusinessMetadata": {
                "IsAlexaForBusinessEnabled": false
            }
        },
        {
            "UserId": "a1b2c3d4-5678-90ab-cdef-44444EXAMPLE",
            "AccountId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
            "PrimaryEmail": "saanvis@example.com",
            "DisplayName": "Saanvi Sarkar",
            "LicenseType": "Basic",
            "UserType": "PrivateUser",
            "UserRegistrationStatus": "Registered",
            "RegisteredOn": "2018-12-20T18:46:57.747Z"
            "AlexaForBusinessMetadata": {
                "IsAlexaForBusinessEnabled": false
            }
        },
        {
            "UserId": "a1b2c3d4-5678-90ab-cdef-55555EXAMPLE",
            "AccountId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
            "PrimaryEmail": "wxiulan@example.com",
            "DisplayName": "Wang Xiulan",
            "LicenseType": "Basic",
            "UserType": "PrivateUser",
            "UserRegistrationStatus": "Registered",
            "RegisteredOn": "2018-12-20T18:47:15.390Z"
            "AlexaForBusinessMetadata": {
                "IsAlexaForBusinessEnabled": false
            }
        }
    ]
}

자세한 내용은 Amazon Chime 관리 안내서의 Managing Users 섹션을 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 ListUsers를 참조하세요.

다음 코드 예시에서는 list-voice-connector-groups을 사용하는 방법을 보여 줍니다.

AWS CLI

Amazon Chime 계정에 대한 Amazon Chime Voice Connector 그룹을 나열하는 방법

다음 list-voice-connector-groups 예시에서는 관리자의 Amazon Chime 계정과 연결된 Amazon Chime Voice Connector 그룹을 나열합니다.

aws chime list-voice-connector-groups

출력:

{
    "VoiceConnectorGroups": [
        {
            "VoiceConnectorGroupId": "123a456b-c7d8-90e1-fg23-4h567jkl8901",
            "Name": "myGroup",
            "VoiceConnectorItems": [],
            "CreatedTimestamp": "2019-09-18T16:38:34.734Z",
            "UpdatedTimestamp": "2019-09-18T16:38:34.734Z"
        }
    ]
}

자세한 내용은 Amazon Chime 관리 안내서의 Working with Amazon Chime Voice Connector groups 섹션을 참조하세요.

다음 코드 예시에서는 list-voice-connector-termination-credentials을 사용하는 방법을 보여 줍니다.

AWS CLI

종료 자격 증명의 목록을 검색하는 방법

다음 list-voice-connector-termination-credentials 예시에서는 지정된 Amazon Chime Voice Connector에 대한 종료 자격 증명의 목록을 검색합니다.

aws chime list-voice-connector-termination-credentials \
    --voice-connector-id abcdef1ghij2klmno3pqr4

이 명령은 출력을 생성하지 않습니다. 출력:

{
    "Usernames": [
        "jdoe"
    ]
}

자세한 내용은 Amazon Chime 관리 안내서의 Working with Amazon Chime Voice Connectors 섹션을 참조하세요.

다음 코드 예시에서는 list-voice-connectors을 사용하는 방법을 보여 줍니다.

AWS CLI

계정에 대한 Amazon Chime Voice Connector를 나열하는 방법

다음 list-voice-connectors 예시에서는 발신자의 계정과 연결된 Amazon Chime Voice Connector를 나열합니다.

aws chime list-voice-connectors

출력:

{
    "VoiceConnectors": [
        {
            "VoiceConnectorId": "abcdef1ghij2klmno3pqr4",
            "AwsRegion": "us-east-1",
            "Name": "MyVoiceConnector",
            "OutboundHostName": "abcdef1ghij2klmno3pqr4.voiceconnector.chime.aws",
            "RequireEncryption": true,
            "CreatedTimestamp": "2019-06-04T18:46:56.508Z",
            "UpdatedTimestamp": "2019-09-18T16:33:00.806Z"
        },
        {
            "VoiceConnectorId": "cbadef1ghij2klmno3pqr5",
            "AwsRegion": "us-west-2",
            "Name": "newVoiceConnector",
            "OutboundHostName": "cbadef1ghij2klmno3pqr5.voiceconnector.chime.aws",
            "RequireEncryption": true,
            "CreatedTimestamp": "2019-09-18T20:34:01.352Z",
            "UpdatedTimestamp": "2019-09-18T20:34:01.352Z"
        }
    ]
}

자세한 내용은 Amazon Chime 관리 안내서의 Working with Amazon Chime Voice Connectors 섹션을 참조하세요.

다음 코드 예시에서는 logout-user을 사용하는 방법을 보여 줍니다.

AWS CLI

사용자를 로그아웃하는 방법

다음 logout-user 예시에서는 지정된 사용자를 로그아웃합니다.

aws chime logout-user \
    --account-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE \
    --user-id a1b2c3d4-5678-90ab-cdef-22222EXAMPLE

이 명령은 출력을 생성하지 않습니다.

  • API 세부 정보는 AWS CLI 명령 참조의 LogoutUser를 참조하세요.

다음 코드 예시에서는 put-voice-connector-logging-configuration을 사용하는 방법을 보여 줍니다.

AWS CLI

지정된 Amazon Chime Voice Connector에 대한 로깅 구성을 추가하는 방법

다음 put-voice-connector-logging-configuration 예시에서는 지정된 Amazon Chime Voice Connector에 대한 SIP 로깅 구성을 켭니다.

aws chime put-voice-connector-logging-configuration \
    --voice-connector-id abcdef1ghij2klmno3pqr4 \
    --logging-configuration EnableSIPLogs=true

출력:

{
    "LoggingConfiguration": {
        "EnableSIPLogs": true
    }
}

자세한 내용은 Amazon Chime 관리 안내서의 Streaming Amazon Chime Voice Connector Media to Kinesis 섹션을 참조하세요.

다음 코드 예시에서는 put-voice-connector-origination을 사용하는 방법을 보여 줍니다.

AWS CLI

시작 설정을 설정하는 방법

다음 put-voice-connector-origination 예시에서는 지정된 Amazon Chime Voice Connector에 대한 시작 호스트, 포트, 프로토콜, 우선순위 및 가중치를 설정합니다.

aws chime put-voice-connector-origination \
    --voice-connector-id abcdef1ghij2klmno3pqr4 \
    --origination Routes=[{Host="10.24.34.0",Port=1234,Protocol="TCP",Priority=1,Weight=5}],Disabled=false

출력:

{
    "Origination": {
        "Routes": [
            {
                "Host": "10.24.34.0",
                "Port": 1234,
                "Protocol": "TCP",
                "Priority": 1,
                "Weight": 5
            }
        ],
        "Disabled": false
    }
}

자세한 내용은 Amazon Chime 관리 안내서의 Working with Amazon Chime Voice Connectors 섹션을 참조하세요.

다음 코드 예시에서는 put-voice-connector-proxy을 사용하는 방법을 보여 줍니다.

AWS CLI

프록시 구성을 설정하는 방법

다음 put-voice-connector-proxy 예시에서는 Amazon Chime Voice Connector에 프록시 구성을 설정합니다.

aws chime put-voice-connector-proxy \
    --voice-connector-id abcdef1ghij2klmno3pqr4 \
    --default-session-expiry-minutes 60 \
    --phone-number-pool-countries "US"

출력:

{
    "Proxy": {
        "DefaultSessionExpiryMinutes": 60,
        "Disabled": false,
        "PhoneNumberCountries": [
            "US"
        ]
    }
}

자세한 내용은 Amazon Chime 개발자 안내서의 Proxy Phone Sessions 섹션을 참조하세요.

다음 코드 예시에서는 put-voice-connector-streaming-configuration을 사용하는 방법을 보여 줍니다.

AWS CLI

스트리밍 구성을 생성하는 방법

다음 put-voice-connector-streaming-configuration 예시에서는 지정된 Amazon Chime Voice Connector에 대한 스트리밍 구성을 생성합니다. 이는 Amazon Chime Voice Connector에서 Amazon Kinesis로의 미디어 스트리밍을 활성화하고 데이터 보존 기간을 24시간으로 설정합니다.

aws chime put-voice-connector-streaming-configuration \
    --voice-connector-id abcdef1ghij2klmno3pqr4 \
    --streaming-configuration DataRetentionInHours=24,Disabled=false

출력:

{
    "StreamingConfiguration": {
        "DataRetentionInHours": 24,
        "Disabled": false
    }
}

자세한 내용은 Amazon Chime 관리 안내서의 Streaming Amazon Chime Voice Connector Data to Kinesis 섹션을 참조하세요.

다음 코드 예시에서는 put-voice-connector-termination-credentials을 사용하는 방법을 보여 줍니다.

AWS CLI

종료 자격 증명을 설정하는 방법

다음 put-voice-connector-termination-credentials 예시에서는 지정된 Amazon Chime Voice Connector에 대한 종료 자격 증명을 설정합니다.

aws chime put-voice-connector-termination-credentials \
    --voice-connector-id abcdef1ghij2klmno3pqr4 \
    --credentials Username="jdoe",Password="XXXXXXXX"

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Amazon Chime 관리 안내서의 Working with Amazon Chime Voice Connectors 섹션을 참조하세요.

다음 코드 예시에서는 put-voice-connector-termination을 사용하는 방법을 보여 줍니다.

AWS CLI

종료 설정을 설정하는 방법

다음 put-voice-connector-termination 예시에서는 지정된 Amazon Chime Voice Connector에 대해 발신 리전 및 허용되는 IP 호스트 종료 설정을 설정합니다.

aws chime put-voice-connector-termination \
    --voice-connector-id abcdef1ghij2klmno3pqr4 \
    --termination CallingRegions="US",CidrAllowedList="10.24.34.0/23",Disabled=false

출력:

{
    "Termination": {
        "CpsLimit": 0,
        "CallingRegions": [
            "US"
        ],
        "CidrAllowedList": [
            "10.24.34.0/23"
        ],
        "Disabled": false
    }
}

자세한 내용은 Amazon Chime 관리 안내서의 Working with Amazon Chime Voice Connectors 섹션을 참조하세요.

다음 코드 예시에서는 regenerate-security-token을 사용하는 방법을 보여 줍니다.

AWS CLI

보안 토큰을 재생성하는 방법

다음 regenerate-security-token 예시에서는 지정된 봇에 대한 보안 토큰을 재생성합니다.

aws chime regenerate-security-token \
    --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \
    --bot-id 123abcd4-5ef6-789g-0h12-34j56789012k

출력:

{
    "Bot": {
        "BotId": "123abcd4-5ef6-789g-0h12-34j56789012k",
        "UserId": "123abcd4-5ef6-789g-0h12-34j56789012k",
        "DisplayName": "myBot (Bot)",
        "BotType": "ChatBot",
        "Disabled": false,
        "CreatedTimestamp": "2019-09-09T18:05:56.749Z",
        "UpdatedTimestamp": "2019-09-09T18:05:56.749Z",
        "BotEmail": "myBot-chimebot@example.com",
        "SecurityToken": "je7MtGbClwBF/2Zp9Utk/h3yCo8nvbEXAMPLEKEY"
    }
}

자세한 내용은 Amazon Chime 개발자 안내서의 Authenticate Chat Bot Requests 섹션을 참조하세요.

다음 코드 예시에서는 reset-personal-pin을 사용하는 방법을 보여 줍니다.

AWS CLI

사용자의 개인 회의 PIN을 재설정하는 방법

다음 reset-personal-pin 예시에서는 지정된 사용자의 개인 회의 PIN을 재설정합니다.

aws chime reset-personal-pin \
    --account-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE
    --user-id a1b2c3d4-5678-90ab-cdef-22222EXAMPLE

출력:

{
    "User": {
        "UserId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
        "AccountId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
        "PrimaryEmail": "mateo@example.com",
        "DisplayName": "Mateo Jackson",
        "LicenseType": "Pro",
        "UserType": "PrivateUser",
        "UserRegistrationStatus": "Registered",
        "RegisteredOn": "2018-12-20T18:45:25.231Z",
        "AlexaForBusinessMetadata": {
            "IsAlexaForBusinessEnabled": False,
            "AlexaForBusinessRoomArn": "null"
        },
        "PersonalPIN": "XXXXXXXXXX"
    }
}

자세한 내용은 Amazon Chime 관리 안내서의 Changing Personal Meeting PINs 섹션을 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 ResetPersonalPin을 참조하세요.

다음 코드 예시에서는 restore-phone-number을 사용하는 방법을 보여 줍니다.

AWS CLI

전화번호를 복원하는 방법

다음 restore-phone-number 예시에서는 지정된 전화번호를 삭제 대기열에서 복원합니다.

aws chime restore-phone-number \
    --phone-number-id "+12065550100"

출력:

{
    "PhoneNumber": {
        "PhoneNumberId": "%2B12065550100",
        "E164PhoneNumber": "+12065550100",
        "Type": "Local",
        "ProductType": "BusinessCalling",
        "Status": "Unassigned",
        "Capabilities": {
            "InboundCall": true,
            "OutboundCall": true,
            "InboundSMS": true,
            "OutboundSMS": true,
            "InboundMMS": true,
            "OutboundMMS": true
        },
        "Associations": [],
        "CreatedTimestamp": "2019-08-09T21:35:21.445Z",
        "UpdatedTimestamp": "2019-08-12T22:06:36.355Z"
    }
}

자세한 내용은 Amazon Chime 관리 안내서의 Working with Phone Numbers 섹션을 참조하세요.

다음 코드 예시에서는 search-available-phone-numbers을 사용하는 방법을 보여 줍니다.

AWS CLI

사용 가능한 전화번호를 검색하는 방법

다음 search-available-phone-numbers 예시에서는 지역 코드별로 사용 가능한 전화번호를 검색합니다.

aws chime search-available-phone-numbers \
    --area-code "206"

출력:

{
    "E164PhoneNumbers": [
        "+12065550100",
        "+12065550101",
        "+12065550102",
        "+12065550103",
        "+12065550104",
        "+12065550105",
        "+12065550106",
        "+12065550107",
        "+12065550108",
        "+12065550109",
    ]
}

자세한 내용은 Amazon Chime 관리 안내서의 Working with Phone Numbers 섹션을 참조하세요.

다음 코드 예시에서는 update-account-settings을 사용하는 방법을 보여 줍니다.

AWS CLI

계정의 설정을 업데이트하는 방법

다음 update-account-settings 예시에서는 지정된 Amazon Chime 계정에 대한 공유 화면의 원격 제어를 비활성화합니다.

aws chime update-account-settings \
    --account-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE \
    --account-settings DisableRemoteControl=true

이 명령은 출력을 생성하지 않습니다.

다음 코드 예시에서는 update-account을 사용하는 방법을 보여 줍니다.

AWS CLI

계정을 업데이트하는 방법

다음 update-account 예시에서는 지정된 계정 이름을 업데이트합니다.

aws chime update-account \
    --account-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE \
    --name MyAccountName

출력:

{
    "Account": {
        "AwsAccountId": "111122223333",
        "AccountId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
        "Name": "MyAccountName",
        "AccountType": "Team",
        "CreatedTimestamp": "2018-09-04T21:44:22.292Z",
        "DefaultLicense": "Pro",
        "SupportedLicenses": [
            "Basic",
            "Pro"
        ],
        "SigninDelegateGroups": [
            {
                "GroupName": "myGroup"
            },
        ]
    }
}

자세한 내용은 Amazon Chime 관리 안내서의 Renaming Your Account 섹션을 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 UpdateAccount를 참조하세요.

다음 코드 예시에서는 update-bot을 사용하는 방법을 보여 줍니다.

AWS CLI

봇을 업데이트하는 방법

다음 update-bot 예시에서는 지정된 봇의 상태를 업데이트하여 실행을 중지합니다.

aws chime update-bot \
    --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \
    --bot-id 123abcd4-5ef6-789g-0h12-34j56789012k \
    --disabled

출력:

{
    "Bot": {
        "BotId": "123abcd4-5ef6-789g-0h12-34j56789012k",
        "UserId": "123abcd4-5ef6-789g-0h12-34j56789012k",
        "DisplayName": "myBot (Bot)",
        "BotType": "ChatBot",
        "Disabled": true,
        "CreatedTimestamp": "2019-09-09T18:05:56.749Z",
        "UpdatedTimestamp": "2019-09-09T18:05:56.749Z",
        "BotEmail": "myBot-chimebot@example.com",
        "SecurityToken": "je7MtGbClwBF/2Zp9Utk/h3yCo8nvbEXAMPLEKEY"
    }
}

자세한 내용은 Amazon Chime 개발자 안내서의 Update Chat Bots 섹션을 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 UpdateBot을 참조하세요.

다음 코드 예시에서는 update-global-settings을 사용하는 방법을 보여 줍니다.

AWS CLI

전역 설정을 업데이트하는 방법

다음 update-global-settings 예시에서는 관리자의 AWS 계정과 연결된 Amazon Chime Business Calling 및 Amazon Chime Voice Connector에 대한 통화 세부 정보 레코드를 보관하는 데 사용되는 S3 버킷을 업데이트합니다.

aws chime update-global-settings \
    --business-calling CdrBucket="s3bucket" \
    --voice-connector CdrBucket="s3bucket"

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Amazon Chime 관리 안내서의 Managing Global Settings 섹션을 참조하세요.

다음 코드 예시에서는 update-phone-number-settings을 사용하는 방법을 보여 줍니다.

AWS CLI

발신 호출 이름을 업데이트하는 방법

다음 update-phone-number-settings 예시에서는 관리자의 AWS 계정에 대한 기본 발신 호출 이름을 업데이트합니다.

aws chime update-phone-number-settings \
    --calling-name "myName"

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Amazon Chime 관리 안내서의 Working with Phone Numbers 섹션을 참조하세요.

다음 코드 예시에서는 update-phone-number을 사용하는 방법을 보여 줍니다.

AWS CLI

예시 1: 전화번호에 대한 제품 유형 업데이트

다음 update-phone-number 예시에서는 지정된 전화번호의 제품 유형을 업데이트합니다.

aws chime update-phone-number \
    --phone-number-id "+12065550100" \
    --product-type "BusinessCalling"

출력:

{
    "PhoneNumber": {
        "PhoneNumberId": "%2B12065550100",
        "E164PhoneNumber": "+12065550100",
        "Type": "Local",
        "ProductType": "BusinessCalling",
        "Status": "Unassigned",
        "Capabilities": {
            "InboundCall": true,
            "OutboundCall": true,
            "InboundSMS": true,
            "OutboundSMS": true,
            "InboundMMS": true,
            "OutboundMMS": true
        },
        "Associations": [],
        "CallingName": "phonenumber1",
        "CreatedTimestamp": "2019-08-09T21:35:21.445Z",
        "UpdatedTimestamp": "2019-08-12T21:44:07.591Z"
    }
}

예시 2: 전화번호에 대한 발신 호출 이름 업데이트

다음 update-phone-number 예시에서는 지정된 전화번호에 대한 발신 호출 이름을 업데이트합니다.

aws chime update-phone-number --phone-number-id "+12065550100" --calling-name "phonenumber2"

출력:

{
    "PhoneNumber": {
        "PhoneNumberId": "%2B12065550100",
        "E164PhoneNumber": "+12065550100",
        "Type": "Local",
        "ProductType": "BusinessCalling",
        "Status": "Unassigned",
        "Capabilities": {
            "InboundCall": true,
            "OutboundCall": true,
            "InboundSMS": true,
            "OutboundSMS": true,
            "InboundMMS": true,
            "OutboundMMS": true
        },
        "Associations": [],
        "CallingName": "phonenumber2",
        "CreatedTimestamp": "2019-08-09T21:35:21.445Z",
        "UpdatedTimestamp": "2019-08-12T21:44:07.591Z"
    }
}

자세한 내용은 Amazon Chime 관리 안내서의 Working with Phone Numbers 섹션을 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 UpdatePhoneNumber를 참조하세요.

다음 코드 예시에서는 update-proxy-session을 사용하는 방법을 보여 줍니다.

AWS CLI

프록시 세션을 업데이트하는 방법

다음 update-proxy-session 예시에서는 프록시 세션 기능을 업데이트합니다.

aws chime update-proxy-session \
    --voice-connector-id abcdef1ghij2klmno3pqr4 \
    --proxy-session-id 123a4bc5-67d8-901e-2f3g-h4ghjk56789l \
    --capabilities "Voice"

출력:

{
    "ProxySession": {
        "VoiceConnectorId": "abcdef1ghij2klmno3pqr4",
        "ProxySessionId": "123a4bc5-67d8-901e-2f3g-h4ghjk56789l",
        "Status": "Open",
        "ExpiryMinutes": 60,
        "Capabilities": [
            "Voice"
        ],
        "CreatedTimestamp": "2020-04-15T16:10:10.288Z",
        "UpdatedTimestamp": "2020-04-15T16:10:10.288Z",
        "Participants": [
            {
                "PhoneNumber": "+12065550100",
                "ProxyPhoneNumber": "+19135550199"
            },
            {
                "PhoneNumber": "+14015550101",
                "ProxyPhoneNumber": "+19135550199"
            }
        ]
    }
}

자세한 내용은 Amazon Chime 개발자 안내서의 Proxy Phone Sessions 섹션을 참조하세요.

다음 코드 예시에서는 update-room-membership을 사용하는 방법을 보여 줍니다.

AWS CLI

룸 멤버십을 업데이트하는 방법

다음 update-room-membership 예시에서는 지정된 채팅룸 멤버의 역할을 Administrator로 수정합니다.

aws chime update-room-membership \
    --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \
    --room-id abcd1e2d-3e45-6789-01f2-3g45h67i890j \
    --member-id 1ab2345c-67de-8901-f23g-45h678901j2k \
    --role Administrator

출력:

{
    "RoomMembership": {
        "RoomId": "abcd1e2d-3e45-6789-01f2-3g45h67i890j",
        "Member": {
            "MemberId": "1ab2345c-67de-8901-f23g-45h678901j2k",
            "MemberType": "User",
            "Email": "sofiamartinez@example.com",
            "FullName": "Sofia Martinez",
            "AccountId": "12a3456b-7c89-012d-3456-78901e23fg45"
        },
        "Role": "Administrator",
        "InvitedBy": "arn:aws:iam::111122223333:user/admin",
        "UpdatedTimestamp": "2019-12-02T22:40:22.931Z"
    }
}

자세한 내용은 Amazon Chime 사용 설명서의 채팅룸 생성을 참조하세요.

다음 코드 예시에서는 update-room을 사용하는 방법을 보여 줍니다.

AWS CLI

채팅룸을 업데이트하는 방법

다음 update-room 예시에서는 지정된 채팅룸의 이름을 수정합니다.

aws chime update-room \
    --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \
    --room-id abcd1e2d-3e45-6789-01f2-3g45h67i890j \
    --name teamRoom

출력:

{
    "Room": {
        "RoomId": "abcd1e2d-3e45-6789-01f2-3g45h67i890j",
        "Name": "teamRoom",
        "AccountId": "12a3456b-7c89-012d-3456-78901e23fg45",
        "CreatedBy": "arn:aws:iam::111122223333:user/alejandro",
        "CreatedTimestamp": "2019-12-02T22:29:31.549Z",
        "UpdatedTimestamp": "2019-12-02T22:33:19.310Z"
    }
}

자세한 내용은 Amazon Chime 사용 설명서의 채팅룸 생성을 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 UpdateRoom을 참조하세요.

다음 코드 예시에서는 update-user-settings을 사용하는 방법을 보여 줍니다.

AWS CLI

사용자 설정을 업데이트하는 방법

다음 update-user-settings 예시에서는 지정된 사용자가 수신 및 발신 통화를 수행하고 SMS 메시지를 보내고 받을 수 있도록 합니다.

aws chime update-user-settings \
    --account-id 12a3456b-7c89-012d-3456-78901e23fg45 \
    --user-id 1ab2345c-67de-8901-f23g-45h678901j2k \
    --user-settings "Telephony={InboundCalling=true,OutboundCalling=true,SMS=true}"

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Amazon Chime 관리 안내서의 Managing User Phone Numbers 섹션을 참조하세요.

다음 코드 예시에서는 update-user을 사용하는 방법을 보여 줍니다.

AWS CLI

사용자 세부 정보를 업데이트하는 방법

이 예시에서는 지정된 사용자에 대해 지정된 세부 정보를 업데이트합니다.

명령:

aws chime update-user \
    --account-id a1b2c3d4-5678-90ab-cdef-11111EXAMPLE \
    --user-id a1b2c3d4-5678-90ab-cdef-22222EXAMPLE \
    --license-type "Basic"

출력:

{
    "User": {
        "UserId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE"
    }
}

  • API 세부 정보는 AWS CLI 명령 참조의 UpdateUser 섹션을 참조하세요.

다음 코드 예시에서는 update-voice-connector-group을 사용하는 방법을 보여 줍니다.

AWS CLI

Amazon Chime Voice Connector 그룹에 대한 세부 정보를 업데이트하는 방법

다음 update-voice-connector-group 예시에서는 지정된 Amazon Chime Voice Connector 그룹의 세부 정보를 업데이트합니다.

aws chime update-voice-connector-group \
    --voice-connector-group-id 123a456b-c7d8-90e1-fg23-4h567jkl8901 \
    --name "newGroupName" \
    --voice-connector-items VoiceConnectorId=abcdef1ghij2klmno3pqr4,Priority=1

출력:

{
    "VoiceConnectorGroup": {
        "VoiceConnectorGroupId": "123a456b-c7d8-90e1-fg23-4h567jkl8901",
        "Name": "newGroupName",
        "VoiceConnectorItems": [
            {
                "VoiceConnectorId": "abcdef1ghij2klmno3pqr4",
                "Priority": 1
            }
        ],
        "CreatedTimestamp": "2019-09-18T16:38:34.734Z",
        "UpdatedTimestamp": "2019-10-28T19:00:57.081Z"
    }
}

자세한 내용은 Amazon Chime 관리 안내서의 Working with Amazon Chime Voice Connector Groups 섹션을 참조하세요.

다음 코드 예시에서는 update-voice-connector을 사용하는 방법을 보여 줍니다.

AWS CLI

Amazon Chime Voice Connector에 대한 세부 정보를 업데이트하는 방법

다음 update-voice-connector 예시에서는 지정된 Amazon Chime Voice Connector의 이름을 업데이트합니다.

aws chime update-voice-connector \
    --voice-connector-id abcdef1ghij2klmno3pqr4 \
    --name newName \
    --require-encryption

출력:

{
    "VoiceConnector": {
        "VoiceConnectorId": "abcdef1ghij2klmno3pqr4",
        "AwsRegion": "us-west-2",
        "Name": "newName",
        "OutboundHostName": "abcdef1ghij2klmno3pqr4.voiceconnector.chime.aws",
        "RequireEncryption": true,
        "CreatedTimestamp": "2019-09-18T20:34:01.352Z",
        "UpdatedTimestamp": "2019-09-18T20:40:52.895Z"
    }
}

자세한 내용은 Amazon Chime 관리 안내서의 Working with Amazon Chime Voice Connectors 섹션을 참조하세요.