Ações, recursos e chaves de condição do Amazon SNS - Referência de autorização do serviço
AçõesTipos de recursosChaves de condição

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:

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 Escrever

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 Escrever

topic*

PutDataProtectionPolicy Concede permissão para autorizar um proprietário de tópico a definir a política de proteção de dados Escrever

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 exibir 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 String
aws:ResourceTag/${TagKey} Filtra o acesso pelas etiquetas associadas ao recurso String
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 String
sns:Protocol Filtra o acesso com base no valor do protocolo de uma solicitação de assinatura ou de uma assinatura confirmada anteriormente String