As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# SNS \$1 Atualização (automação gerenciada)
Modifique as propriedades de um tópico existente do Amazon Simple Notification Service (SNS) do Amazon Simple Notification Service (SNS).
**Classificação completa:** Gerenciamento \$1 Monitoramento e notificação \$1 SNS \$1 Atualização (automação gerenciada)
## Detalhes do tipo de alteração
****
| | |
| --- |--- |
| ID do tipo de alteração | ct-0zzf0fjz76jmb |
| Versão atual | 1,0 |
| Duração esperada da execução | 240 minutos |
| Aprovação da AWS | Obrigatório |
| Aprovação do cliente | Não é necessário se o remetente |
| Modo de execução | Manual |
## Informações adicionais
### Atualizar tópico do SNS
#### Atualizar tópico do SNS com o console
Captura de tela desse tipo de alteração no console AMS:
![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/managedservices/latest/ctref/images/guiSnsUpdateCT.png)
Como funciona:
1. Navegue até a página **Criar RFC**: No painel de navegação esquerdo do console AMS, clique **RFCs**para abrir a página da RFCs lista e, em seguida, clique em **Criar** RFC.
1. Escolha um tipo de alteração popular (CT) na visualização padrão **Procurar tipos de alteração** ou selecione uma CT na visualização **Escolher por categoria**.
+ **Navegar por tipo de alteração**: você pode clicar em um CT popular na área de **criação rápida** para abrir imediatamente a página **Executar RFC**. Observe que você não pode escolher uma versão mais antiga do CT com a criação rápida.
Para classificar CTs, use a área **Todos os tipos de alteração** na exibição **Cartão** ou **Tabela**. Em qualquer exibição, selecione uma CT e clique em **Criar RFC** para abrir a página **Executar RFC**. Se aplicável, a opção **Criar com versão mais antiga** aparece ao lado do botão **Criar RFC**.
+ **Escolha por categoria**: selecione uma categoria, subcategoria, item e operação e a caixa de detalhes do CT será aberta com a opção **Criar com uma versão mais antiga**, se aplicável. Clique em **Criar RFC** para abrir a página **Executar RFC**.
1. Na página **Executar RFC**, abra a área do nome do CT para ver a caixa de detalhes do CT. É necessário um **Assunto** (preenchido se você escolher seu CT na visualização **Procurar tipos de alteração**). Abra a área **Configuração adicional** para adicionar informações sobre o RFC.
Na área **Configuração de execução**, use as listas suspensas disponíveis ou insira valores para os parâmetros necessários. Para configurar parâmetros de execução opcionais, abra a área **Configuração adicional**.
1. Ao terminar, clique em **Executar**. Se não houver erros, a página **RFC criada com sucesso** será exibida com os detalhes da RFC enviada e a saída inicial de **execução**.
1. Abra a área **Parâmetros de execução** para ver as configurações que você enviou. Atualize a página para atualizar o status de execução do RFC. Opcionalmente, cancele a RFC ou crie uma cópia dela com as opções na parte superior da página.
#### Atualizar tópico do SNS com a CLI
Como funciona:
1. Use o Inline Create (você emite um `create-rfc` comando com todos os parâmetros de RFC e execução incluídos) ou o Template Create (você cria dois arquivos JSON, um para os parâmetros RFC e outro para os parâmetros de execução) e emita o `create-rfc` comando com os dois arquivos como entrada. Ambos os métodos são descritos aqui.
1. Envie o `aws amscm submit-rfc --rfc-id ID` comando RFC: com o ID RFC retornado.
Monitore o `aws amscm get-rfc --rfc-id ID` comando RFC:.
Para verificar a versão do tipo de alteração, use este comando:
```
aws amscm list-change-type-version-summaries --filter Attribute=ChangeTypeId,Value=CT_ID
```
**nota**
Você pode usar qualquer `CreateRfc` parâmetro com qualquer RFC, independentemente de eles fazerem parte do esquema para o tipo de alteração. Por exemplo, para receber notificações quando o status da RFC mudar, adicione essa linha `--notification "{\"Email\": {\"EmailRecipients\" : [\"email@example.com\"]}}"` à parte dos parâmetros da RFC da solicitação (não aos parâmetros de execução). Para obter uma lista de todos os CreateRfc parâmetros, consulte a [Referência da API de gerenciamento de alterações do AMS](https://docs.aws.amazon.com/managedservices/latest/ApiReference-cm/API_CreateRfc.html).
*INLINE CREATE* (parâmetros mínimos):
Execute o comando create RFC com os parâmetros de execução fornecidos em linha (aspas de escape ao fornecer parâmetros de execução em linha) e, em seguida, envie a ID de RFC retornada. Por exemplo, você pode substituir o conteúdo por algo assim:
```
aws amscm create-rfc --change-type-id "ct-0zzf0fjz76jmb" --change-type-version "1.0" --title "Update SNS Topic" --execution-parameters "{\"TopicArn\": \"arn:aws:sns:us-east-1:123456789101:My-SNS-Topic\", \"Priority\": \"Medium\", \"Parameters\": {\"DisplayName\": \"My-SNS-Topic\", \"KmsMasterKeyId\": \"arn:aws:kms:us-east-1:123456789101:key/cfe0542d-3be9-4166-9eac-d0cd6af61445\"}}"
```
*CRIAÇÃO DE MODELO* (todos os parâmetros):
1. Envie os parâmetros de execução do esquema JSON para esse tipo de alteração em um arquivo; este exemplo o chama de .json. SnsUpdateParams
```
aws amscm get-change-type-version --change-type-id "ct-3rcl9u1k017wu" --query "ChangeTypeVersion.ExecutionInputSchema" --output text > SnsUpdateParams.json
```
1. Modifique e salve o SnsUpdateParams arquivo. Por exemplo, você pode substituir o conteúdo por algo assim:
```
{
"TopicArn": "arn:aws:sns:us-east-1:123456789101:Test-Stack",
"Parameters": {
"DisplayName": "My-Test-Stack",
"DeliveryPolicy": "{\"http\":{\"defaultHealthyRetryPolicy\":{\"minDelayTarget\":20,\"maxDelayTarget\":20,\"numRetries\":3,\"numMaxDelayRetries\":0,\"numNoDelayRetries\":0,\"numMinDelayRetries\":0,\"backoffFunction\":\"linear\"},\"disableSubscriptionOverrides\":false,\"defaultRequestPolicy\":{\"headerContentType\":\"text/plain; charset=UTF-8\"}}}",
"DataProtectionPolicy": "{\"Name\":\"__example_data_protection_policy\",\"Description\":\"Exampledataprotectionpolicy\",\"Version\":\"2021-06-01\",\"Statement\":[{\"DataDirection\":\"Inbound\",\"Principal\":[\"arn:aws:iam::123456789101:user/ExampleUser\"],\"DataIdentifier\":[\"arn:aws:dataprotection::aws:data-identifier/CreditCardNumber\"],\"Operation\":{\"Deidentify\":{\"MaskConfig\":{\"MaskWithCharacter\":\"#\"}}}}]}",
"KmsMasterKeyARN": "arn:aws:kms:ap-southeast-2:123456789101:key/bb43bd18-3a75-482e-822d-d0d3a5544dc8",
"TracingConfig": "Active"
},
"Priority": "Medium"
}
```
1. Envie o arquivo JSON do modelo RFC para um arquivo chamado SnsUpdateRfc .json:
```
aws amscm create-rfc --generate-cli-skeleton > SnsUpdateRfc.json
```
1. Modifique e salve o SnsUpdateRfc arquivo.json. Por exemplo, você pode substituir o conteúdo por algo assim:
```
{
"ChangeTypeVersion": "1.0",
"ChangeTypeId": "ct-0zzf0fjz76jmb",
"Title": "Update-SNS-RFC"
}
```
1. Crie o RFC, especificando o arquivo SnsUpdate Rfc e o arquivo: SnsUpdateParams
```
aws amscm create-rfc --cli-input-json file://SnsUpdateRfc.json --execution-parameters file://SnsUpdateParams.json
```
Você recebe o ID do novo RFC na resposta e pode usá-lo para enviar e monitorar o RFC. Até que você o envie, o RFC permanece no estado de edição e não inicia.
#### Dicas
Para saber mais sobre o AWS Simple Notification Service (SNS), consulte [Amazon](https://aws.amazon.com/sns/) Simple Notification Service. Consulte também [Conceitos básicos do Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html).
## Parâmetros de entrada de execução
Para obter informações detalhadas sobre os parâmetros de entrada de execução, consulte[Esquema para o tipo de alteração ct-0zzf0fjz76jmb](schemas.md#ct-0zzf0fjz76jmb-schema-section).
## Exemplo: parâmetros obrigatórios
```
{
"TopicArn": "arn:aws:sns:us-east-1:000000000000:Test-Stack"
}
```
## Exemplo: Todos os parâmetros
```
{
"TopicArn": "arn:aws:sns:us-east-1:000000000000:Test-Stack",
"Parameters":{
"DisplayName": "Test-Stack",
"AddSubscriptions": [
{
"Protocol": "http",
"Endpoint": "http://example.com/webhook"
},
{
"Protocol": "https",
"Endpoint": "https://example.com/webhook"
},
{
"Protocol": "email",
"Endpoint": "test@example.com"
},
{
"Protocol": "email-json",
"Endpoint": "test@example.com"
},
{
"Protocol": "sms",
"Endpoint": "+1234567890"
},
{
"Protocol": "sqs",
"Endpoint": "arn:aws:sqs:us-east-1:000000000000:TestQueue"
},
{
"Protocol": "application",
"Endpoint": "arn:aws:sns:us-east-1:000000000000:endpoint/GCM/MyApplication"
},
{
"Protocol": "lambda",
"Endpoint": "arn:aws:lambda:us-east-1:000000000000:function:TestFunction"
},
{
"Protocol": "firehose",
"Endpoint": "arn:aws:firehose:us-east-1:000000000000:deliverystream/TestStream"
}
],
"RemoveSubscriptions": [
"arn:aws:sns:us-east-1:000000000000:Test-Stack:12345678-1234-1234-1234-123456789012"
],
"DeliveryPolicy": "{\"http\":{\"defaultHealthyRetryPolicy\":{\"minDelayTarget\":20,\"maxDelayTarget\":20,\"numRetries\":3,\"numMaxDelayRetries\":0,\"numNoDelayRetries\":0,\"numMinDelayRetries\":0,\"backoffFunction\":\"linear\"},\"disableSubscriptionOverrides\":false,\"defaultRequestPolicy\":{\"headerContentType\":\"text/plain; charset=UTF-8\"}}}",
"DataProtectionPolicy": "{\"Name\":\"__example_data_protection_policy\",\"Description\":\"Exampledataprotectionpolicy\",\"Version\":\"2021-06-01\",\"Statement\":[{\"DataDirection\":\"Inbound\",\"Principal\":[\"arn:aws:iam::123456789012:user/ExampleUser\"],\"DataIdentifier\":[\"arn:aws:dataprotection::aws:data-identifier/CreditCardNumber\"],\"Operation\":{\"Deidentify\":{\"MaskConfig\":{\"MaskWithCharacter\":\"#\"}}}}]}",
"KmsMasterKeyARN": "arn:aws:kms:ap-southeast-2:123456789023:key/bb43bd18-3a75-482e-822d-d0d3a5544dc8",
"TracingConfig": "Active"
},
"Priority": "Medium"
}
```