Ações, recursos e chaves de condição do Amazon SNS

O Amazon SNS (prefixo do serviço: sns) fornece os seguintes recursos, ações e chaves de contexto de condição específicos ao 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 Amazon SNS

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
AddPermission	Concede permissão para adicionar uma instrução à política de controle de acesso de um tópico, concedendo acesso para as contas especificadas da AWS às ações especificadas	Permissions management	topic*
CheckIfPhoneNumberIsOptedOut	Concede permissão para aceitar um número de telefone e indicar se o titular do telefone cancelou a opção de recebimento de mensagens SMS em sua conta	Read
ConfirmSubscription	Concede permissão para verificar a intenção do proprietário de um endpoint de receber mensagens validando o token enviado para o endpoint por uma ação Subscribe anterior	Write	topic*
CreatePlatformApplication	Concede permissão para criar um objeto de aplicação de plataforma para um dos serviços de notificações por push compatíveis, como APNS e GCM, nos quais dispositivos e aplicativos móveis podem ser inscritos	Write			iam:PassRole
CreatePlatformEndpoint	Concede permissão para criar um endpoint para um dispositivo e aplicativo móvel em um dos serviços de notificações por push compatíveis, como GCM e APNS	Write
CreateSMSSandboxPhoneNumber	Concede permissão para adicionar um número de telefone de destino e enviar uma senha de uso único (OTP) a esse número de telefone para uma Conta da AWS	Write
CreateTopic	Concede permissão para criar um tópico no qual as notificações possam ser publicadas	Write	topic*		iam:PassRole
				aws:RequestTag/${TagKey} aws:TagKeys
DeleteEndpoint	Concede permissão para excluir o endpoint de um dispositivo e aplicativo móvel do Amazon SNS	Write
DeletePlatformApplication	Concede permissão para excluir um objeto de aplicação da plataforma de um dos serviços de notificações por push compatíveis, como APNS e GCM	Write
DeleteSMSSandboxPhoneNumber	Concede permissão para excluir o número de telefone verificado ou pendente de uma Conta da AWS	Write
DeleteTopic	Concede permissão para excluir um tópico e todas as suas assinaturas	Gravação	topic*
GetDataProtectionPolicy	Concede permissão para retornar a política de proteção de dados do tópico	Leitura	topic*
GetEndpointAttributes	Concede permissão para recuperar os atributos do endpoint de um dispositivo em um dos serviços de notificações por push compatíveis, como GCM e APNS	Read
GetPlatformApplicationAttributes	Concede permissão para recuperar os atributos do objeto de aplicação da plataforma dos serviços de notificações por push compatíveis, como APNS e GCM	Read
GetSMSAttributes	Concede permissão para retornar as configurações de envio de mensagens SMS da sua conta	Read
GetSMSSandboxAccountStatus	Concede permissão para recuperar o status da sandbox para a conta de chamada na região de destino	Read
GetSubscriptionAttributes	Concede permissão para retornar todas as propriedades de uma assinatura	Read
GetTopicAttributes	Concede permissão para retornar todas as propriedades de um tópico	Read	topic*
ListEndpointsByPlatformApplication	Concede permissão para relacionar os endpoints e os atributos dos endpoints de dispositivos em um serviço de notificações por push compatível, como GCM e APNS	List
ListOriginationNumbers	Concede permissão para relacionar todos os números de origem e seus metadados	List
ListPhoneNumbersOptedOut	Concede permissão para retornar uma lista de números de telefone cancelados, o que significa que você não pode enviar mensagens SMS a eles	Read
ListPlatformApplications	Concede permissão para relacionar os objetos de aplicação da plataforma dos serviços de notificações por push compatíveis, como APNS e GCM	List
ListSMSSandboxPhoneNumbers	Concede permissão para os números de telefone de destino atuais, pendentes e verificados, da conta de chamada	List
ListSubscriptions	Concede permissão para retornar uma lista das assinaturas do solicitante	List
ListSubscriptionsByTopic	Concede permissão para retornar uma lista das inscrições para um determinado tópico	List	topic*
ListTagsForResource	Concede permissão para relacionar todas as etiquetas adicionadas ao tópico especificado do Amazon SNS	Read	topic
ListTopics	Concede permissão para retornar uma lista dos tópicos do solicitante	List
OptInPhoneNumber	Concede permissão para aceitar um número de telefone que está cancelado no momento, o que permite que você retome o envio de mensagens SMS para o número.	Write
Publish	Concede permissão para enviar uma mensagem para todos os endpoints inscritos de um tópico	Gravação	topic*
PutDataProtectionPolicy	Concede permissão para autorizar um proprietário de tópico a definir a política de proteção de dados	Gravação	topic*
RemovePermission	Concede permissão para remover uma instrução da política de controle de acesso de um tópico	Permissions management	topic*
SetEndpointAttributes	Concede permissão para definir os atributos de um endpoint de um dispositivo em um dos serviços de notificações por push compatíveis, como GCM e APNS	Write
SetPlatformApplicationAttributes	Concede permissão para definir os atributos do objeto de aplicação da plataforma dos serviços de notificações por push compatíveis, como APNS e GCM	Write			iam:PassRole
SetSMSAttributes	Concede permissão para definir as configurações padrão para enviar mensagens SMS e receber relatórios diários de uso de SMS	Write
SetSubscriptionAttributes	Concede permissão para permitir que um proprietário da assinatura defina um atributo do tópico para um novo valor	Write
SetTopicAttributes	Concede permissão para permitir que um proprietário de tópico defina um atributo do tópico para um novo valor	Gerenciamento de permissões	topic*		iam:PassRole
Subscribe	Concede permissão para se preparar para assinar um endpoint por meio do envio de uma mensagem de confirmação a ele	Write	topic*
				sns:Endpoint sns:Protocol
TagResource	Concede permissão para adicionar etiquetas ao tópico especificado do Amazon SNS	Marcação	topic
				aws:RequestTag/${TagKey} aws:TagKeys
Unsubscribe	Concede permissão para excluir uma assinatura	Write
UntagResource	Concede permissão para remover as etiquetas do tópico do Amazon SNS especificado	Marcação	topic
				aws:RequestTag/${TagKey} aws:TagKeys
VerifySMSSandboxPhoneNumber	Concede permissão para verificar um número de telefone de destino com uma senha de uso único (OTP) para uma Conta da AWS	Write

Tipos de recursos definidos pelo Amazon SNS

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
topic	arn:${Partition}:sns:${Region}:${Account}:${TopicName}	aws:ResourceTag/${TagKey}

Chaves de condição do Amazon SNS

O Amazon SNS define as seguintes chaves de condição que podem ser usadas no elemento Condition de 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	Tipo
aws:RequestTag/${TagKey}	Filtra o acesso baseado em etiquetas a partir da solicitação	Segmento
aws:ResourceTag/${TagKey}	Filtra o acesso pelas etiquetas associadas ao recurso	Segmento
aws:TagKeys	Filtra o acesso baseado nas chaves da etiqueta a partir da solicitação	ArrayOfString
sns:Endpoint	Filtra o acesso com base no URL, no endereço de e-mail ou no ARN de uma solicitação de assinatura ou de uma assinatura confirmada anteriormente	Segmento
sns:Protocol	Filtra o acesso com base no valor do protocolo de uma solicitação de assinatura ou de uma assinatura confirmada anteriormente	Segmento