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:

• Saiba como configurar este serviço.

• Visualize uma lista das operações de API disponíveis para este serviço.

• Saiba como proteger este serviço e seus recursos usando políticas de permissão do IAM.

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 Tipos de recursos na tabela Ações 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 ("*") aos quais a política se aplica 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 instrução com essa ação. Se a ação tiver um ou mais recursos necessários, o chamador deverá ter permissão para usar a ação com esses recursos. Os recursos obrigatórios são indicados na tabela com um asterisco (*). Se você limitar o acesso aos recursos com o elemento Resource em uma política do IAM, deverá incluir um ARN ou padrão para cada tipo de recurso necessário. 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 dos tipos de recurso opcionais.

A coluna Chaves de condição na tabela Ações inclui chaves que você pode especificar em um elemento Condition da declaração de política. Para obter mais informações sobre as chaves de condição associadas aos recursos do serviço, consulte a coluna Chaves de condição da tabela Tipos de recursos.

nota

As chaves de condição do recurso estão listadas na tabela Tipos de recursos. Você pode encontrar um link para o tipo de recurso que se aplica a uma ação na coluna Tipos de recursos (*obrigatório) da tabela Ações. O tipo de recurso na tabela Tipos de recursos inclui a coluna Chaves de condição, que são as chaves de condição do recurso que se aplicam a uma ação na tabela Ações.

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 habilidade à organização sob a responsabilidade do cliente Conta da AWS	Escrever
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		aws:RequestTag/${TagKey} aws:TagKeys
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	Escrever		aws:RequestTag/${TagKey} aws:TagKeys
CreateConferenceProvider	Concede permissão para adicionar um novo provedor de conferência abaixo do do usuário Conta da AWS	Escrever		aws:RequestTag/${TagKey} aws:TagKeys
CreateContact	Concede permissão para criar um contato com os detalhes especificados	Write		aws:RequestTag/${TagKey} aws:TagKeys
CreateGatewayGroup	Concede permissão para criar um grupo de gateways com os detalhes especificados	Write		aws:RequestTag/${TagKey} aws:TagKeys
CreateNetworkProfile	Concede permissão para criar um perfil de rede com os detalhes especificados	Write		aws:RequestTag/${TagKey} aws:TagKeys
CreateProfile	Concede permissão para criar um novo perfil	Write		aws:RequestTag/${TagKey} aws:TagKeys
CreateRoom	Concede permissão para criar uma sala com os detalhes especificados	Write	profile*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateSkillGroup	Concede permissão para criar um grupo de skills com determinado nome e descrição	Write		aws:RequestTag/${TagKey} aws:TagKeys
CreateUser	Concede permissão para criar um usuário	Write	user*
				aws:RequestTag/${TagKey} aws:TagKeys
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	Lista
ListConferenceProviders	Concede permissão para listar os provedores de conferências em um determinado Conta da AWS	Lista
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		aws:RequestTag/${TagKey} aws:TagKeys
RegisterDevice [somente permissão]	Concede permissão para registrar um dispositivo Alexa	Escrever
RejectSkill	Concede permissão para desassociar uma habilidade da organização da de um usuário Conta da AWS	Escrever
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
				aws:RequestTag/${TagKey} aws:TagKeys
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 Tipos de recursos. 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/${ResourceId}
room	arn:${Partition}:a4b:${Region}:${Account}:room/${ResourceId}	aws:ResourceTag/${TagKey}
device	arn:${Partition}:a4b:${Region}:${Account}:device/${ResourceId}	aws:ResourceTag/${TagKey}
skillgroup	arn:${Partition}:a4b:${Region}:${Account}:skill-group/${ResourceId}
user	arn:${Partition}:a4b:${Region}:${Account}:user/${ResourceId}	aws:ResourceTag/${TagKey}
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}

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	ArrayOfString
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	ArrayOfString