기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
Alexa for Business에 사용되는 작업, 리소스 및 조건 키
Alexa for Business(서비스 접두사: a4b)는 IAM 권한 정책에 사용할 수 있는 다음과 같은 서비스별 리소스, 작업 및 조건 컨텍스트 키를 제공합니다.
참조:
-
이 서비스를 구성하는 방법을 알아봅니다.
-
이 서비스에 사용 가능한 API 작업의 목록을 봅니다.
-
IAM 권한 정책을 사용하여 이 서비스와 리소스를 보호하는 방법을 알아봅니다.
Alexa for Business에서 정의한 작업
IAM 정책 설명의 Action 요소에서는 다음 작업을 지정할 수 있습니다. 정책을 사용하여 AWS에서 작업할 수 있는 권한을 부여합니다. 정책에서 작업을 사용하면 일반적으로 이름이 같은 API 작업 또는 CLI 명령에 대한 액세스를 허용하거나 거부합니다. 그러나 경우에 따라 하나의 작업으로 둘 이상의 작업에 대한 액세스가 제어됩니다. 또는 일부 작업을 수행하려면 다양한 작업이 필요합니다.
작업 테이블의 액세스 수준 열은 작업이 분류되는 방법(목록, 읽기, 권한 관리 또는 태그 지정)을 설명합니다. 이 분류는 정책에서 사용하는 작업이 부여하는 액세스 레벨을 이해하는 데 도움이 될 수 있습니다. 액세스 수준에 대한 자세한 내용은 정책 요약의 액세스 수준을 참조하세요.
작업 테이블의 리소스 유형 열에는 각 작업이 리소스 수준 권한을 지원하는지 여부가 표시됩니다. 리소스 열에 값이 없으면 정책 문의 Resource 요소에서 정책이 적용되는 모든 리소스("*")를 지정해야 합니다. 리소스 열에 리소스 유형이 포함되어 있으면 해당 작업 시 문에서 해당 유형의 ARN을 지정할 수 있습니다. 작업에 필요한 리소스가 하나 이상 있는 경우, 호출자에게 해당 리소스와 함께 작업을 사용할 수 있는 권한이 있어야 합니다. 필수 리소스는 테이블에서 별표(*)로 표시됩니다. IAM 정책의 Resource 요소로 리소스 액세스를 제한하는 경우, 각 필수 리소스 유형에 대해 ARN 또는 패턴을 포함해야 합니다. 일부 작업은 다수의 리소스 유형을 지원합니다. 리소스 유형이 옵션(필수 리소스로 표시되지 않은 경우)인 경우에는 선택적 리소스 유형 중 하나를 사용하도록 선택할 수 있습니다.
작업 테이블의 조건 키 열에는 정책 설명의 Condition 요소에서 지정할 수 있는 키가 포함됩니다. 서비스의 리소스와 연결된 조건 키에 대한 자세한 내용은 리소스 유형 테이블의 조건 키 열을 참조하세요.
작업 테이블의 종속 작업 열에는 작업을 성공적으로 호출하는 데 필요할 수 있는 추가 권한이 표시됩니다. 작업 자체에 대한 권한 외에 이러한 권한이 필요할 수 있습니다. 작업이 종속 작업을 지정하는 경우 해당 종속성은 테이블에 나열된 첫 번째 리소스뿐만 아니라 해당 작업에 정의된 추가 리소스에도 적용될 수 있습니다.
참고
리소스 조건 키는 리소스 유형 표에 나열되어 있습니다. 작업에 적용되는 리소스 유형에 대한 링크는 리소스 유형(*필수) 작업 표의 열에서 찾을 수 있습니다. 리소스 유형 테이블의 리소스 유형에는 조건 키 열이 포함되고 이는 작업 표의 작업에 적용되는 리소스 조건 키입니다.
다음 테이블의 열에 대한 자세한 내용은 작업 테이블을 참조하세요.
| 작업 | 설명 | 액세스 레벨 | 리소스 유형(*필수) | 조건 키 | 종속 작업 |
|---|---|---|---|---|---|
| ApproveSkill | 고객의에 따라 조직에 스킬을 연결할 수 있는 권한을 부여합니다. AWS 계정 | 쓰기 | |||
| AssociateContactWithAddressBook | 연락처를 지정된 주소록과 연결할 수 있는 권한을 부여합니다. | Write | |||
| AssociateDeviceWithNetworkProfile | 디바이스를 지정된 네트워크 프로파일과 연결할 수 있는 권한을 부여합니다. | Write | |||
| AssociateDeviceWithRoom | 디바이스를 지정된 방과 연결할 수 있는 권한을 부여합니다. | Write | |||
| AssociateSkillGroupWithRoom | 스킬 그룹을 지정된 방과 연결할 수 있는 권한을 부여합니다. | Write | |||
| AssociateSkillWithSkillGroup | 스킬을 스킬 그룹과 연결할 수 있는 권한을 부여합니다. | Write | |||
| AssociateSkillWithUsers | 등록된 사용자가 디바이스에서 프라이빗 스킬을 사용하도록 하는 권한을 부여합니다. | Write | |||
| CompleteRegistration [권한만 해당] | Alexa 디바이스 등록 작업을 완료할 수 있는 권한을 부여합니다. | Write | |||
| CreateAddressBook | 지정된 세부 정보로 주소록을 생성할 수 있는 권한을 부여합니다. | Write | |||
| CreateBusinessReportSchedule | 지정된 일 또는 주 간격으로 지정된 S3 위치에 전송할 사용 보고서의 반복 일정을 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateConferenceProvider | 사용자의에 새 회의 공급자를 추가할 수 있는 권한을 부여합니다. AWS 계정 | 쓰기 | |||
| CreateContact | 지정된 세부 정보로 연락처를 생성할 수 있는 권한을 부여합니다. | Write | |||
| CreateGatewayGroup | 지정된 세부 정보로 게이트웨이 그룹을 생성할 수 있는 권한을 부여합니다. | Write | |||
| CreateNetworkProfile | 지정된 세부 정보로 네트워크 프로파일을 생성할 수 있는 권한을 부여합니다. | Write | |||
| CreateProfile | 새 프로파일을 생성할 수 있는 권한을 부여합니다. | Write | |||
| CreateRoom | 지정된 세부 정보로 방을 생성할 수 있는 권한을 부여합니다. | Write | |||
| CreateSkillGroup | 지정된 이름 및 설명으로 스킬 그룹을 생성할 수 있는 권한을 부여합니다. | Write | |||
| CreateUser | 사용자를 생성할 수 있는 권한을 부여합니다. | Write | |||
| DeleteAddressBook | 주소록 ARN에 의해 주소록을 삭제할 수 있는 권한을 부여합니다. | Write | |||
| DeleteBusinessReportSchedule | 지정된 일정 ARN으로 보고서 전달 반복 일정을 삭제할 수 있는 권한을 부여합니다. | Write | |||
| DeleteConferenceProvider | 회의 공급자를 삭제할 수 있는 권한을 부여합니다. | Write | |||
| DeleteContact | 연락처 ARN에 의해 연락처를 삭제할 수 있는 권한을 부여합니다. | Write | |||
| DeleteDevice | Alexa For Business에서 디바이스를 제거할 수 있는 권한을 부여합니다. | Write | |||
| DeleteDeviceUsageData | 디바이스에 있는 이전 음성 입력 데이터 및 관련 응답 데이터 전체 기록을 삭제할 수 있는 권한을 부여합니다. | Write | |||
| DeleteGatewayGroup | 게이트웨이 그룹을 삭제할 수 있는 권한을 부여합니다. | Write | |||
| DeleteNetworkProfile | 네트워크 프로파일 ARN에 의해 네트워크 프로파일을 삭제할 수 있는 권한을 부여합니다. | Write | |||
| DeleteProfile | 프로파일 ARN에 의해 프로파일을 삭제할 수 있는 권한을 부여합니다. | Write | |||
| DeleteRoom | 방을 삭제할 수 있는 권한을 부여합니다. | Write | |||
| DeleteRoomSkillParameter | 스킬 및 방에서 파라미터를 삭제할 수 있는 권한을 부여합니다. | Write | |||
| DeleteSkillAuthorization | 스킬에서 타사 계정의 연결을 해제할 수 있는 권한을 부여합니다. | Write | |||
| DeleteSkillGroup | 스킬 그룹 ARN으로 스킬 그룹을 삭제할 수 있는 권한을 부여합니다. | Write | |||
| DeleteUser | 사용자를 삭제할 수 있는 권한을 부여합니다. | Write | |||
| DisassociateContactFromAddressBook | 지정된 주소록에서 연락처를 분리할 수 있는 권한을 부여합니다. | Write | |||
| DisassociateDeviceFromRoom | 현재 방에서 디바이스의 연결을 해제할 수 있는 권한을 부여합니다. | Write | |||
| DisassociateSkillFromSkillGroup | 스킬 그룹에서 스킬의 연결을 해제할 수 있는 권한을 부여합니다. | Write | |||
| DisassociateSkillFromUsers | 등록된 사용자가 디바이스에서 프라이빗 스킬을 사용할 수 없게 하는 권한을 부여합니다. | Write | |||
| DisassociateSkillGroupFromRoom | 지정된 방에서 스킬 그룹의 연결을 해제할 수 있는 권한을 부여합니다. | Write | |||
| ForgetSmartHomeAppliances | 방에 연결된 스마트 가전 제품을 삭제할 수 있는 권한을 부여합니다. | Write | |||
| GetAddressBook | 주소록 ARN에 의해 주소록 세부 정보를 가져올 수 있는 권한을 부여합니다. | Read | |||
| GetConferencePreference | 기존 회의 기본 설정을 검색할 수 있는 권한을 부여합니다. | Read | |||
| GetConferenceProvider | 특정 회의 공급자에 대한 세부 정보를 가져올 수 있는 권한을 부여합니다. | Read | |||
| GetContact | 연락처 ARN에 의해 연락처 세부 정보를 가져올 수 있는 권한을 부여합니다. | Read | |||
| GetDevice | 장치 세부 정보를 가져올 수 있는 권한을 부여합니다. | Read | |||
| GetGateway | 게이트웨이의 세부 정보를 검색할 수 있는 권한을 부여합니다. | Read | |||
| GetGatewayGroup | 게이트웨이 그룹의 세부 정보를 검색할 수 있는 권한을 부여합니다. | Read | |||
| GetInvitationConfiguration | 사용자 등록 초대 이메일 템플릿에 대해 구성된 값을 검색할 수 있는 권한을 부여합니다. | Read | |||
| GetNetworkProfile | 네트워크 프로파일 ARN에 의해 네트워크 프로파일 세부 정보를 가져올 수 있는 권한을 부여합니다. | Read | |||
| GetProfile | 프로파일 ARN으로 제공된 경우 프로파일을 가져올 수 있는 권한을 부여합니다. | Read | |||
| GetRoom | 방 세부 정보를 가져올 수 있는 권한을 부여합니다. | Read | |||
| GetRoomSkillParameter | 스킬 및 방에 대해 설정된 기존 파라미터를 가져올 수 있는 권한을 부여합니다. | Read | |||
| GetSkillGroup | 스킬 그룹 ARN으로 스킬 그룹 세부 정보를 가져올 수 있는 권한을 부여합니다. | Read | |||
| ListBusinessReportSchedules | 사용자가 구성한 일정의 세부 정보를 나열할 수 있는 권한을 부여합니다. | List | |||
| ListConferenceProviders | 특정 아래에 회의 공급자를 나열할 수 있는 권한을 부여합니다. AWS 계정 | List | |||
| ListDeviceEvents | 디바이스 연결 상태를 포함하여 최대 30일간의 디바이스 이벤트 기록을 나열할 수 있는 권한을 부여합니다. | 나열 | |||
| ListGatewayGroups | 게이트웨이 그룹 요약을 나열할 수 있는 권한을 부여합니다. | 나열 | |||
| ListGateways | 게이트웨이 요약을 나열할 수 있는 권한을 부여합니다. | 나열 | |||
| ListSkills | 스킬을 나열할 수 있는 권한을 부여합니다. | 나열 | |||
| ListSkillsStoreCategories | Alexa 스킬 스토어의 모든 범주를 나열할 수 있는 권한을 부여합니다. | 나열 | |||
| ListSkillsStoreSkillsByCategory | Alexa 스킬 스토어의 모든 스킬을 범주별로 나열할 수 있는 권한을 부여합니다. | 나열 | |||
| ListSmartHomeAppliances | 방에 연결된 모든 스마트 가전 제품을 나열할 수 있는 권한을 부여합니다. | 나열 | |||
| ListTags | 리소스에 대한 모든 태그를 나열할 수 있는 권한을 부여합니다. | Read | |||
| PutConferencePreference | 계정 수준에서 특정 회의 공급자에 대한 회의 기본 설정을 지정할 수 있는 권한을 부여합니다. | Write | |||
| PutDeviceSetupEvents [권한만 해당] | Alexa 디바이스 설정 이벤트를 게시할 수 있는 권한을 부여합니다. | Write | |||
| PutInvitationConfiguration | 지정된 속성을 사용하여 사용자 등록 초대에 대한 이메일 템플릿을 구성할 수 있는 권한을 부여합니다. | Write | |||
| PutRoomSkillParameter | 스킬에 대한 방별 파라미터를 입력할 수 있는 권한을 부여합니다. | Write | |||
| PutSkillAuthorization | 사용자 계정을 타사 스킬 공급자에 연결할 수 있는 권한을 부여합니다. | Write | |||
| RegisterAVSDevice | AVS(Alexa Voice Service)를 사용하여 OEM(Original Equipment Manufacturer)에서 제작한 Alexa 지원 장치를 등록할 수 있는 권한을 부여합니다. | Write | |||
| RegisterDevice [권한만 해당] | Alexa 디바이스를 등록할 수 있는 권한을 부여합니다. | 쓰기 | |||
| RejectSkill | 사용자의에 따라 조직에서 스킬을 연결 해제할 수 있는 권한을 부여합니다. AWS 계정 | 쓰기 | |||
| ResolveRoom | 방 정보를 확인할 수 있는 권한을 부여합니다. | Read | |||
| RevokeInvitation | 초대를 취소할 수 있는 권한을 부여합니다. | Write | |||
| SearchAddressBooks | 주소록을 검색하고 필터 및 정렬 기준 세트를 충족하는 주소록을 나열할 수 있는 권한을 부여합니다. | 나열 | |||
| SearchContacts | 연락처를 검색하고 필터 및 정렬 기준 세트를 충족하는 연락처를 나열할 수 있는 권한을 부여합니다. | 나열 | |||
| SearchDevices | 디바이스를 검색할 수 있는 권한을 부여합니다. | 나열 | |||
| SearchNetworkProfiles | 네트워크 프로파일을 검색하고 필터 및 정렬 기준 세트를 충족하는 네트워크 프로파일을 나열할 수 있는 권한을 부여합니다. | 나열 | |||
| SearchProfiles | 프로파일을 검색할 수 있는 권한을 부여합니다. | 나열 | |||
| SearchRooms | 방을 검색할 수 있는 권한을 부여합니다. | 나열 | |||
| SearchSkillGroups | 스킬 그룹을 검색할 수 있는 권한을 부여합니다. | 나열 | |||
| SearchUsers | 사용자를 검색할 수 있는 권한을 부여합니다. | 나열 | |||
| SendAnnouncement | 비동기 흐름을 트리거하여 검색 또는 필터로 식별된 방에 텍스트, SSML 또는 오디오 알림을 보낼 수 있는 권한을 부여합니다. | Write | |||
| SendInvitation | 사용자에게 초대를 보낼 수 있는 권한을 부여합니다. | Write | |||
| StartDeviceSync | 이전 사용자가 설정한 모든 정보와 설정을 지워 디바이스 및 계정을 알려진 기본 설정으로 복원할 수 있는 권한을 부여합니다. | Write | |||
| StartSmartHomeApplianceDiscovery | 방과 연결된 모든 스마트 홈 어플라이언스의 검색을 시작할 수 있는 권한을 부여합니다. | Read | |||
| TagResource | 리소스에 메타데이터 태그를 추가할 수 있는 권한을 부여합니다. | 태그 지정 | |||
| UntagResource | 리소스에서 메타데이터 태그를 제거할 수 있는 권한을 부여합니다. | 태그 지정 | |||
| UpdateAddressBook | 주소록 ARN에 의해 주소록 세부 정보를 업데이트할 수 있는 권한을 부여합니다. | Write | |||
| UpdateBusinessReportSchedule | 지정된 일정 ARN으로 보고서 전달 일정에 대한 구성을 업데이트할 수 있는 권한을 부여합니다. | Write | |||
| UpdateConferenceProvider | 기존 회의 공급자의 설정을 업데이트할 수 있는 권한을 부여합니다. | Write | |||
| UpdateContact | 연락처 ARN에 의해 연락처 세부 정보를 업데이트할 수 있는 권한을 부여합니다. | Write | |||
| UpdateDevice | 디바이스 이름을 업데이트할 수 있는 권한을 부여합니다. | Write | |||
| UpdateGateway | 게이트웨이의 세부 정보를 업데이트할 수 있는 권한을 부여합니다. | Write | |||
| UpdateGatewayGroup | 게이트웨이 그룹의 세부 정보를 업데이트할 수 있는 권한을 부여합니다. | Write | |||
| UpdateNetworkProfile | 네트워크 프로파일 ARN에 의해 네트워크 프로파일을 업데이트할 수 있는 권한을 부여합니다. | Write | |||
| UpdateProfile | 기존 프로파일을 업데이트할 수 있는 권한을 부여합니다. | Write | |||
| UpdateRoom | 방 세부 정보를 업데이트할 수 있는 권한을 부여합니다. | Write | |||
| UpdateSkillGroup | 스킬 그룹 ARN으로 스킬 그룹 세부 정보를 업데이트할 수 있는 권한을 부여합니다. | Write |
Alexa for Business에서 정의한 리소스 유형
이 서비스에서 정의하는 리소스 유형은 다음과 같으며, IAM 권한 정책 설명의 Resource 요소에서 사용할 수 있습니다. 작업 테이블의 각 작업은 해당 작업으로 지정할 수 있는 리소스 유형을 식별합니다. 리소스 유형은 정책에 포함할 조건 키를 정의할 수도 있습니다. 이러한 키는 리소스 유형 테이블의 마지막 열에 표시됩니다. 다음 테이블의 열에 관한 자세한 내용은 리소스 유형 테이블을 참조하세요.
| 리소스 유형 | ARN | 조건 키 |
|---|---|---|
| profile |
arn:${Partition}:a4b:${Region}:${Account}:profile/${ResourceId}
|
|
| room |
arn:${Partition}:a4b:${Region}:${Account}:room/${ResourceId}
|
|
| device |
arn:${Partition}:a4b:${Region}:${Account}:device/${ResourceId}
|
|
| skillgroup |
arn:${Partition}:a4b:${Region}:${Account}:skill-group/${ResourceId}
|
|
| user |
arn:${Partition}:a4b:${Region}:${Account}:user/${ResourceId}
|
|
| addressbook |
arn:${Partition}:a4b:${Region}:${Account}:address-book/${ResourceId}
|
|
| conferenceprovider |
arn:${Partition}:a4b:${Region}:${Account}:conference-provider/${ResourceId}
|
|
| contact |
arn:${Partition}:a4b:${Region}:${Account}:contact/${ResourceId}
|
|
| schedule |
arn:${Partition}:a4b:${Region}:${Account}:schedule/${ResourceId}
|
|
| networkprofile |
arn:${Partition}:a4b:${Region}:${Account}:network-profile/${ResourceId}
|
|
| gateway |
arn:${Partition}:a4b:${Region}:${Account}:gateway/${ResourceId}
|
|
| gatewaygroup |
arn:${Partition}:a4b:${Region}:${Account}:gateway-group/${ResourceId}
|
Alexa for Business에 사용되는 조건 키
Alexa for Business는 IAM 정책의 Condition 요소에 사용할 수 있는 다음과 같은 조건 키를 정의합니다. 이러한 키를 사용하여 정책 설명이 적용되는 조건을 보다 상세하게 설정할 수 있습니다. 다음 테이블의 열에 대한 자세한 내용은 조건 키 테이블을 참조하세요.
모든 서비스에서 사용할 수 있는 전역 조건 키를 보려면 AWS 전역 조건 컨텍스트 키를 참조하세요.
| 조건 키 | 설명 | Type |
|---|---|---|
| a4b:amazonId | 요청의 Amazon ID를 기준으로 작업을 필터링합니다. | 문자열 |
| a4b:filters_deviceType | 요청의 디바이스 유형을 기준으로 작업을 필터링합니다. | ArrayOfString |
| aws:RequestTag/${TagKey} | 각 태그에 허용되는 값 집합을 기준으로 작업을 필터링합니다. | 문자열 |
| aws:ResourceTag/${TagKey} | 리소스와 연결된 태그-값을 기준으로 작업을 필터링합니다. | 문자열 |
| aws:TagKeys | 요청에 필수 태그가 있는지 여부를 기준으로 작업을 필터링합니다. | ArrayOfString |
