> ## Documentation Index
> Fetch the complete documentation index at: https://docs.basaltic.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Permissões do Notifications

> Ações IAM da API Notifications e permissões adicionais entre serviços.

Publicação, gerenciamento de assinaturas e acesso a segredos usam ações IAM separadas. Confirmações de email e webhook usam seus tokens em vez de IAM.

<span id="actions" />

## Ações

A referência dos endpoints descreve campos e respostas. Esta tabela relaciona cada chamada à ação IAM.

| Chamada | Ação necessária |
| - | - |
| `GET /v1/topics` | `notifications:ListTopics` |
| `POST /v1/topics` | `notifications:CreateTopic` |
| `GET /v1/topics/{topic_id}` | `notifications:DescribeTopic` |
| `PATCH /v1/topics/{topic_id}` | `notifications:UpdateTopic` |
| `DELETE /v1/topics/{topic_id}` | `notifications:DeleteTopic` |
| `GET /v1/topics/{topic_id}/policy` | `notifications:GetTopicPolicy` |
| `PUT /v1/topics/{topic_id}/policy` | `notifications:PutTopicPolicy` |
| `DELETE /v1/topics/{topic_id}/policy` | `notifications:DeleteTopicPolicy` |
| `POST /v1/topics/{topic_id}/publish` | `notifications:Publish` |
| `POST /v1/topics/{topic_id}/publish-batch` | `notifications:Publish` |
| `GET /v1/topics/{topic_id}/subscriptions` | `notifications:ListSubscriptions` |
| `POST /v1/topics/{topic_id}/subscriptions` | `notifications:Subscribe` |
| `GET /v1/topics/{topic_id}/subscriptions/{subscription_id}` | `notifications:DescribeSubscription` |
| `PATCH /v1/topics/{topic_id}/subscriptions/{subscription_id}` | `notifications:UpdateSubscription` |
| `DELETE /v1/topics/{topic_id}/subscriptions/{subscription_id}` | `notifications:Unsubscribe` |
| `POST /v1/topics/{topic_id}/subscriptions/{subscription_id}/resend-confirmation` | `notifications:ResendConfirmation` |
| `GET /v1/topics/{topic_id}/subscriptions/{subscription_id}/signing-secret` | `notifications:GetSubscriptionSigningSecret` |
| `POST /v1/topics/{topic_id}/subscriptions/{subscription_id}/signing-secret/rotate` | `notifications:RotateSubscriptionSigningSecret` |
| `GET /v1/topics/{topic_id}/messages` | `notifications:ListMessages` |
| `GET /v1/topics/{topic_id}/messages/{message_id}` | `notifications:DescribeMessage` |
| `GET /v1/topics/{topic_id}/deliveries` | `notifications:ListDeliveries` |

Leituras de mensagens e entregas autorizam pelo tópico pai e suas tags. Métricas usam `telemetry:ReadMetrics` na conta e região selecionadas.

<span id="cross-service-permissions" />

## Permissões entre serviços

Assinar uma fila exige `notifications:Subscribe` no tópico e `queue:SendMessage` no destino, na mesma conta e região. Uma fila de falhas também exige `queue:SendMessage`; alterar o destino revalida essa permissão.

<span id="signing-secrets" />

## Segredos de assinatura

`notifications:DescribeSubscription` retorna metadados. `notifications:GetSubscriptionSigningSecret` lê o segredo do webhook e `notifications:RotateSubscriptionSigningSecret` o rotaciona. Conceda as permissões separadamente.

<span id="example-policy" />

## Exemplo de política

Esta política concede somente as leituras de coleções listadas. Não permite enviar mensagens ou gerenciar recursos.

```json theme={null}
{
  "version": "2024-01-01",
  "statements": [
    {
      "effect": "allow",
      "actions": [
        "notifications:ListTopics",
        "notifications:ListSubscriptions"
      ],
      "resources": [
        "*"
      ]
    }
  ]
}
```

Veja [Políticas IAM](/pt/iam/policies) para avaliação de políticas e [Notifications](/pt/notifications) para a visão geral.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.