Ações, recursos e chaves de condição do Alexa for Business - Referência de autorização do serviço

Ações, recursos e chaves de condição do Alexa for Business

O Alexa for Business (prefixo do serviço: a4b) fornece os seguintes recursos, ações e chaves de contexto de condição específicos do serviço para uso em políticas de permissão do IAM.

Referências:

Ações definidas pelo Alexa for Business

Você pode especificar as seguintes ações no elemento Action de uma declaração de política do IAM. Use políticas para conceder permissões para executar uma operação na AWS. Quando usa uma ação em uma política, você geralmente permite ou nega acesso à operação da API ou ao comando da CLI com o mesmo nome. No entanto, em alguns casos, uma única ação controla o acesso a mais de uma operação. Como alternativa, algumas operações exigem várias ações diferentes.

A coluna Resource types (Tipos de recursos) indica se cada ação é compatível com permissões no nível do recurso. Se não houver valor para essa coluna, você deverá especificar todos os recursos ("*") no elemento Resource de sua declaração de política. Se a coluna incluir um tipo de recurso, você poderá especificar um ARN desse tipo em uma declaração com essa ação. Os recursos obrigatórios são indicados na tabela com um asterisco (*). Se você especificar um ARN de permissão no nível do recurso em uma instrução que esteja usando essa ação, ele deverá ser desse tipo. Algumas ações oferecem suporte a vários tipos de recursos. Se o tipo de recurso for opcional (não indicado como obrigatório), você poderá optar por usar um, mas não o outro.

Para obter detalhes sobre as colunas na tabela a seguir, consulte Tabela de ações.

Ações Descrição Nível de acesso Tipos de recursos (*necessários) Chaves de condição Ações dependentes
ApproveSkill Concede permissão para associar uma skill à organização na do cliente Conta da AWS Write
AssociateContactWithAddressBook Concede permissão para associar um contato a um determinado catálogo de endereços Write

addressbook*

contact*

AssociateDeviceWithNetworkProfile Concede permissão para associar um dispositivo ao perfil de rede especificado Write

device*

networkprofile*

AssociateDeviceWithRoom Concede permissão para associar um dispositivo a uma determinada sala Write

device*

room*

AssociateSkillGroupWithRoom Concede permissão para associar o grupo de skills a uma determinada sala Write

room*

skillgroup*

AssociateSkillWithSkillGroup Concede permissão para associar uma skill a um grupo de skills Write

skillgroup*

AssociateSkillWithUsers Concede permissão para disponibilizar uma skill privada para usuários inscritos habilitarem em seus dispositivos Write
CompleteRegistration [somente permissão] Concede permissão para concluir a operação de registro de um dispositivo Alexa Write
CreateAddressBook Concede permissão para criar um catálogo de endereços com os detalhes especificados Write
CreateBusinessReportSchedule Concede permissão para criar uma programação recorrente para relatórios de uso a serem entregues no local S3 especificado com um intervalo diário ou semanal especificado Write
CreateConferenceProvider Concede permissão para adicionar um novo provedor de conferência na do usuário Conta da AWS Write
CreateContact Concede permissão para criar um contato com os detalhes especificados Write
CreateGatewayGroup Concede permissão para criar um grupo de gateways com os detalhes especificados Write
CreateNetworkProfile Concede permissão para criar um perfil de rede com os detalhes especificados Write
CreateProfile Concede permissão para criar um novo perfil Write
CreateRoom Concede permissão para criar uma sala com os detalhes especificados Write

profile*

CreateSkillGroup Concede permissão para criar um grupo de skills com determinado nome e descrição Write
CreateUser Concede permissão para criar um usuário Write

user*

DeleteAddressBook Concede permissão para excluir um catálogo de endereços pelo ARN do catálogo de endereços Write

addressbook*

DeleteBusinessReportSchedule Concede permissão para excluir a programação de entrega de relatório recorrente com o ARN da programação especificada Write

schedule*

DeleteConferenceProvider Concede permissão para excluir um provedor de conferência Write

conferenceprovider*

DeleteContact Concede permissão para excluir um contato pelo ARN do contato Write

contact*

DeleteDevice Concede permissão para remover um dispositivo do Alexa For Business Write

device*

DeleteDeviceUsageData Concede permissão para excluir todo o histórico anterior do dispositivo de dados de entrada de voz e dados de resposta associados Write

device*

DeleteGatewayGroup Concede permissão para excluir um grupo de gateway Write

gatewaygroup*

DeleteNetworkProfile Concede permissão para excluir um perfil de rede pelo ARN do perfil de rede Write

networkprofile*

DeleteProfile Concede permissão para excluir um perfil pelo ARN do perfil Write

profile*

DeleteRoom Concede permissão para excluir uma sala Write

room*

DeleteRoomSkillParameter Concede permissão para excluir um parâmetro de uma skill e uma sala Write

room*

DeleteSkillAuthorization Concede permissão para desvincular uma conta de terceiros de uma skill Write

room*

DeleteSkillGroup Concede permissão para excluir um grupo de skills com o ARN do grupo de skills Write

skillgroup*

DeleteUser Concede permissão para excluir um usuário Write

user*

DisassociateContactFromAddressBook Concede permissão para desassociar um contato de um determinado catálogo de endereços Write

addressbook*

contact*

DisassociateDeviceFromRoom Concede permissão para desassociar um dispositivo de sua sala atual Write

device*

DisassociateSkillFromSkillGroup Concede permissão para desassociar uma skill de um grupo de skills Write

skillgroup*

DisassociateSkillFromUsers Concede permissão para tornar uma skill privada indisponível para usuários inscritos e os impede de habilitá-la em seus respectivos dispositivos Write

user*

DisassociateSkillGroupFromRoom Concede permissão para desassociar o grupo de skills de uma determinada sala Write

room*

skillgroup*

ForgetSmartHomeAppliances Concede permissão para esquecer dispositivos domésticos inteligentes associados a uma sala Write

room*

GetAddressBook Concede permissão para obter os detalhes do catálogo de endereços pelo ARN do catálogo de endereços Read

addressbook*

GetConferencePreference Concede permissão para recuperar as preferências de conferência existentes Read
GetConferenceProvider Concede permissão para obter detalhes sobre um provedor de conferência específico Read

conferenceprovider*

GetContact Concede permissão para obter os detalhes de contato pelo ARN do contato Read

contact*

GetDevice Concede permissão para obter detalhes do dispositivo Read

device*

GetGateway Concede permissão para recuperar os detalhes de um gateway Read

gateway*

GetGatewayGroup Concede permissão para recuperar os detalhes de um grupo de gateways Read

gatewaygroup*

GetInvitationConfiguration Concede permissão para recuperar os valores configurados para o modelo de e-mail de convite de inscrição de usuário Read
GetNetworkProfile Concede permissão para obter os detalhes do perfil de rede pelo ARN do perfil de rede Read

networkprofile*

GetProfile Concede permissão para obter um perfil quando provido de um ARN de perfil Read

profile*

GetRoom Concede permissão para obter detalhes da sala Read

room*

GetRoomSkillParameter Concede permissão para obter um parâmetro existente que foi definido para uma skill e uma sala Read

room*

GetSkillGroup Concede permissão para obter detalhes do grupo de skills com o ARN do grupo de skills Read

skillgroup*

ListBusinessReportSchedules Concede permissão para listar os detalhes das programações que um usuário configurou List
ListConferenceProviders Concede permissão para listar provedores de conferência em uma específica Conta da AWS List
ListDeviceEvents Concede permissão para listar o histórico de eventos do dispositivo, incluindo o status de conexão do dispositivo, por até 30 dias List

device*

ListGatewayGroups Concede permissão para listar resumos de grupos de gateway List
ListGateways Concede permissão para listar resumos de gateway List

gatewaygroup*

ListSkills Concede permissão para listar skills List
ListSkillsStoreCategories Concede permissão para listar todas as categorias na loja de skills da Alexa List
ListSkillsStoreSkillsByCategory Concede permissão para listar todas as skills na loja de skills da Alexa por categoria List
ListSmartHomeAppliances Concede permissão para listar todos os dispositivos domésticos inteligentes associados a uma sala List

room*

ListTags Concede permissão para listar todas as etiquetas de um recurso Read

device

room

user

PutConferencePreference Concede permissão para definir as preferências da conferência em um provedor de conferência específico no nível da conta Write
PutDeviceSetupEvents [somente permissão] Concede permissão para publicar eventos de configuração de dispositivo Alexa Write
PutInvitationConfiguration Concede permissão para configurar o modelo de e-mail para o convite de inscrição de usuário com os atributos especificados Write
PutRoomSkillParameter Concede permissão para colocar um parâmetro específico de sala para uma skill Write

room*

PutSkillAuthorization Concede permissão para vincular a conta de um usuário a um provedor de skills terceirizado Write

room*

RegisterAVSDevice Concede permissão para registrar um dispositivo habilitado para a Alexa desenvolvido por um fabricante de equipamento original (OEM) usando o Alexa Voice Service (AVS) Write
RegisterDevice [somente permissão] Concede permissão para registrar um dispositivo Alexa Write
RejectSkill Concede permissão para desassociar uma skill da organização na de um usuário Conta da AWS Write
ResolveRoom Concede permissão para resolver as informações da sala Read
RevokeInvitation Concede permissão para revogar um convite Write

user*

SearchAddressBooks Concede permissão para pesquisar catálogos de endereços e listar aqueles que atendem a um conjunto de critérios de filtragem e classificação List
SearchContacts Concede permissão para pesquisar contatos e listar aqueles que atendem a um conjunto de critérios de filtragem e classificação List
SearchDevices Concede permissão para pesquisar dispositivos List
SearchNetworkProfiles Concede permissão para pesquisar perfis de rede e listar aqueles que atendem a um conjunto de critérios de filtragem e classificação List
SearchProfiles Concede permissão para pesquisar perfis List
SearchRooms Concede permissão para pesquisar salas List
SearchSkillGroups Concede permissão para pesquisar grupos de skill List
SearchUsers Concede permissão para pesquisar usuários List
SendAnnouncement Concede permissão para acionar um fluxo assíncrono para enviar texto, SSML ou anúncios de áudio para salas identificadas por uma pesquisa ou filtro Write
SendInvitation Concede permissão para enviar um convite a um usuário Write

user*

StartDeviceSync Concede permissão para restaurar o dispositivo e sua conta às configurações padrão conhecidas, apagando todas as informações e configurações definidas por seus usuários anteriores Write
StartSmartHomeApplianceDiscovery Concede permissão para iniciar a descoberta de quaisquer dispositivos domésticos inteligentes associados à sala Read

room*

TagResource Concede permissão para adicionar etiquetas de metadados a um recurso Marcação

device

room

user

UntagResource Concede permissão para remover etiquetas de metadados de um recurso Marcação

device

room

user

UpdateAddressBook Concede permissão para atualizar detalhes do catálogo de endereços pelo ARN do catálogo de endereços Write

addressbook*

UpdateBusinessReportSchedule Concede permissão para atualizar a configuração da programação de entrega de relatórios com o ARN da programação especificada Write

schedule*

UpdateConferenceProvider Concede permissão para atualizar as configurações de um provedor de conferência existente Write

conferenceprovider*

UpdateContact Concede permissão para atualizar os detalhes de contato pelo ARN do contato Write

contact*

UpdateDevice Concede permissão para atualizar o nome do dispositivo Write

device*

UpdateGateway Concede permissão para atualizar os detalhes de um gateway Write

gateway*

UpdateGatewayGroup Concede permissão para atualizar os detalhes de um grupo de gateways Write

gatewaygroup*

UpdateNetworkProfile Concede permissão para atualizar um perfil de rede pelo ARN do perfil de rede Write

networkprofile*

UpdateProfile Concede permissão para atualizar um perfil existente Write

profile*

UpdateRoom Concede permissão para atualizar os detalhes da sala Write

room*

UpdateSkillGroup Concede permissão para atualizar detalhes do grupo de skills com o ARN do grupo de skills Write

skillgroup*

Tipos de recursos definidos pelo Alexa for Business

Os seguintes tipos de recursos são definidos por este serviço e podem ser usados no elemento Resource de declarações de políticas de permissão do IAM. Cada ação na Tabela de ações identifica os tipos de recursos que podem ser especificados com essa ação. Um tipo de recurso também pode definir quais chaves de condição você pode incluir em uma política. Essas chaves são exibidas na última coluna da tabela. Para obter detalhes sobre as colunas na tabela a seguir, consulte Tabela de tipos de recursos.

Tipos de recursos ARN Chaves de condição
profile arn:${Partition}:a4b:${Region}:${Account}:profile/${Resource_id}
room arn:${Partition}:a4b:${Region}:${Account}:room/${Resource_id}

aws:ResourceTag/${TagKey}

device arn:${Partition}:a4b:${Region}:${Account}:device/${Resource_id}

aws:ResourceTag/${TagKey}

skillgroup arn:${Partition}:a4b:${Region}:${Account}:skill-group/${Resource_id}
user arn:${Partition}:a4b:${Region}:${Account}:user/${Resource_id}

aws:ResourceTag/${TagKey}

addressbook arn:${Partition}:a4b:${Region}:${Account}:address-book/${Resource_id}
conferenceprovider arn:${Partition}:a4b:${Region}:${Account}:conference-provider/${Resource_id}
contact arn:${Partition}:a4b:${Region}:${Account}:contact/${Resource_id}
schedule arn:${Partition}:a4b:${Region}:${Account}:schedule/${Resource_id}
networkprofile arn:${Partition}:a4b:${Region}:${Account}:network-profile/${Resource_id}
gateway arn:${Partition}:a4b:${Region}:${Account}:gateway/${Resource_id}
gatewaygroup arn:${Partition}:a4b:${Region}:${Account}:gateway-group/${Resource_id}

Chaves de condição do Alexa for Business

O Alexa for Business define as seguintes chaves de condição que podem ser usadas no elemento Conditionde uma política do IAM. É possível usar essas chaves para refinar ainda mais as condições sob as quais a declaração de política se aplica. Para obter detalhes sobre as colunas na tabela a seguir, consulte Tabela de chaves de condição.

Para visualizar as chaves de condição globais disponíveis para todos os serviços, consulte Chaves de condição globais disponíveis.

Chaves de condição Descrição Type
a4b:amazonId Filtra ações com base no ID da Amazon na solicitação String
a4b:filters_deviceType Filtra ações com base no tipo de dispositivo na solicitação String
aws:RequestTag/${TagKey} Filtra ações com base no conjunto de valores permitidos para cada uma das etiquetas String
aws:ResourceTag/${TagKey} Filtra ações com base no valor da etiqueta associada ao recurso String
aws:TagKeys Filtra ações com base na presença de etiquetas obrigatórias na solicitação String