Há mais exemplos de AWS SDK disponíveis no repositório [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .
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á.
# AWS CodeStar Exemplos de notificações usando AWS CLI
Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Command Line Interface com AWS CodeStar notificações.
*Ações* são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.
Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.
**Topics**
+ [Ações](#actions)
## Ações
### `create-notification-rule`
O código de exemplo a seguir mostra como usar `create-notification-rule`.
**AWS CLI**
**Para criar uma regra de notificação**
O `create-notification-rule` exemplo a seguir usa um arquivo JSON chamado `rule.json` para criar uma regra de notificação com o nome `MyNotificationRule` de um repositório nomeado `MyDemoRepo` na conta especificada AWS . As notificações com o tipo de detalhe `FULL` são enviadas para o tópico do Amazon SNS de destino especificado quando ramificações e tags são criadas.
```
aws codestar-notifications create-notification-rule \
--cli-input-json file://rule.json
```
Conteúdo de `rule.json`:
```
{
"Name": "MyNotificationRule",
"EventTypeIds": [
"codecommit-repository-branches-and-tags-created"
],
"Resource": "arn:aws:codecommit:us-east-1:123456789012:MyDemoRepo",
"Targets": [
{
"TargetType": "SNS",
"TargetAddress": "arn:aws:sns:us-east-1:123456789012:MyNotificationTopic"
}
],
"Status": "ENABLED",
"DetailType": "FULL"
}
```
Saída:
```
{
"Arn": "arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/dc82df7a-EXAMPLE"
}
```
Para obter mais informações, consulte [Criar uma regra de notificação](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/notification-rule-create.html) no *Guia do usuário do console de ferramentas do desenvolvedor da AWS *.
+ Para obter detalhes da API, consulte [CreateNotificationRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-notifications/create-notification-rule.html)em *Referência de AWS CLI Comandos*.
### `delete-notification-rule`
O código de exemplo a seguir mostra como usar `delete-notification-rule`.
**AWS CLI**
**Para excluir uma regra de notificação**
O exemplo `delete-notification-rule` a seguir exclui a regra de notificação especificada.
```
aws codestar-notifications delete-notification-rule \
--arn arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/dc82df7a-EXAMPLE
```
Saída:
```
{
"Arn": "arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/dc82df7a-EXAMPLE"
}
```
Para obter mais informações, consulte [Excluir uma regra de notificação](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/notification-rule-delete.html) no *Guia do usuário do console de ferramentas do desenvolvedor da AWS *.
+ Para obter detalhes da API, consulte [DeleteNotificationRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-notifications/delete-notification-rule.html)em *Referência de AWS CLI Comandos*.
### `delete-target`
O código de exemplo a seguir mostra como usar `delete-target`.
**AWS CLI**
**Para excluir uma regra de notificação**
O exemplo `delete-target` a seguir remove o destino especificado de todas as regras de notificação configuradas para usá-lo como destino e, depois, exclui o destino.
```
aws codestar-notifications delete-target \
--target-address arn:aws:sns:us-east-1:123456789012:MyNotificationTopic \
--force-unsubscribe-all
```
Este comando não produz saída.
Para obter mais informações, consulte [Excluir um destino de regra de notificação](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/notification-target-delete.html) no *Guia do usuário do console de ferramentas do desenvolvedor da AWS *.
+ Para obter detalhes da API, consulte [DeleteTarget](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-notifications/delete-target.html)em *Referência de AWS CLI Comandos*.
### `describe-notification-rule`
O código de exemplo a seguir mostra como usar `describe-notification-rule`.
**AWS CLI**
**Para recuperar detalhes de uma regra de notificação**
O exemplo `describe-notification-rule` a seguir recupera os detalhes da regra de notificação especificada.
```
aws codestar-notifications describe-notification-rule \
--arn arn:aws:codestar-notifications:us-west-2:123456789012:notificationrule/dc82df7a-EXAMPLE
```
Saída:
```
{
"LastModifiedTimestamp": 1569199844.857,
"EventTypes": [
{
"ServiceName": "CodeCommit",
"EventTypeName": "Branches and tags: Created",
"ResourceType": "Repository",
"EventTypeId": "codecommit-repository-branches-and-tags-created"
}
],
"Status": "ENABLED",
"DetailType": "FULL",
"Resource": "arn:aws:codecommit:us-west-2:123456789012:MyDemoRepo",
"Arn": "arn:aws:codestar-notifications:us-west-w:123456789012:notificationrule/dc82df7a-EXAMPLE",
"Targets": [
{
"TargetStatus": "ACTIVE",
"TargetAddress": "arn:aws:sns:us-west-2:123456789012:MyNotificationTopic",
"TargetType": "SNS"
}
],
"Name": "MyNotificationRule",
"CreatedTimestamp": 1569199844.857,
"CreatedBy": "arn:aws:iam::123456789012:user/Mary_Major"
}
```
Para obter mais informações, consulte [Visualizar regras de notificação](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/notification-rule-view.html) no *Guia do usuário do console de ferramentas do desenvolvedor da AWS *.
+ Para obter detalhes da API, consulte [DescribeNotificationRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-notifications/describe-notification-rule.html)em *Referência de AWS CLI Comandos*.
### `list-event-types`
O código de exemplo a seguir mostra como usar `list-event-types`.
**AWS CLI**
**Para obter uma lista de tipos de evento para uma regra de notificação**
O `list-event-types` exemplo a seguir recupera uma lista filtrada de todos os tipos de eventos de notificação disponíveis para CodeDeploy aplicativos. Se, em vez disso, você não usar nenhum filtro, o comando retornará todos os tipos de eventos de notificação para todos os tipos de recursos.
```
aws codestar-notifications list-event-types \
--filters Name=SERVICE_NAME,Value=CodeDeploy
```
Saída:
```
{
"EventTypes": [
{
"EventTypeId": "codedeploy-application-deployment-succeeded",
"ServiceName": "CodeDeploy",
"EventTypeName": "Deployment: Succeeded",
"ResourceType": "Application"
},
{
"EventTypeId": "codedeploy-application-deployment-failed",
"ServiceName": "CodeDeploy",
"EventTypeName": "Deployment: Failed",
"ResourceType": "Application"
},
{
"EventTypeId": "codedeploy-application-deployment-started",
"ServiceName": "CodeDeploy",
"EventTypeName": "Deployment: Started",
"ResourceType": "Application"
}
]
}
```
Para obter mais informações, consulte [Criar uma regra de notificação](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/notification-rule-create.html) no *Guia do usuário do console de ferramentas do desenvolvedor da AWS *.
+ Para obter detalhes da API, consulte [ListEventTypes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-notifications/list-event-types.html)em *Referência de AWS CLI Comandos*.
### `list-notification-rules`
O código de exemplo a seguir mostra como usar `list-notification-rules`.
**AWS CLI**
**Para recuperar uma lista de regras de notificação**
O `list-notification-rules` exemplo a seguir recupera uma lista de todas as regras de notificação na AWS região especificada.
```
aws codestar-notifications list-notification-rules --region us-east-1
```
Saída:
```
{
"NotificationRules": [
{
"Id": "dc82df7a-EXAMPLE",
"Arn": "arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/dc82df7a-EXAMPLE"
},
{
"Id": "8d1f0983-EXAMPLE",
"Arn": "arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/8d1f0983-EXAMPLE"
}
]
}
```
Para obter mais informações, consulte [Visualizar regras de notificação](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/notification-rule-view.html) no *Guia do usuário do console de ferramentas do desenvolvedor da AWS *.
+ Para obter detalhes da API, consulte [ListNotificationRules](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-notifications/list-notification-rules.html)em *Referência de AWS CLI Comandos*.
### `list-tags-for-resource`
O código de exemplo a seguir mostra como usar `list-tags-for-resource`.
**AWS CLI**
**Para obter uma lista de tags anexadas a uma regra de notificação**
O exemplo `list-tags-for-resource` a seguir recupera uma lista de todas as tags anexadas à regra de notificação especificada. Neste exemplo, a regra de notificação atualmente não tem tags associadas a ela.
```
aws codestar-notifications list-tags-for-resource \
--arn arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/fe1efd35-EXAMPLE
```
Saída:
```
{
"Tags": {}
}
```
Para obter mais informações, consulte [Criar uma regra de notificação](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/notification-rule-create.html) no *Guia do usuário do console de ferramentas do desenvolvedor da AWS *.
+ Para obter detalhes da API, consulte [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-notifications/list-tags-for-resource.html)em *Referência de AWS CLI Comandos*.
### `list-targets`
O código de exemplo a seguir mostra como usar `list-targets`.
**AWS CLI**
**Para recuperar uma lista de destinos de regra de notificação**
O `list-targets` exemplo a seguir recupera uma lista de todos os alvos da regra de notificação na AWS região especificada.
```
aws codestar-notifications list-targets \
--region us-east-1
```
Saída:
```
{
"Targets": [
{
"TargetAddress": "arn:aws:sns:us-east-1:123456789012:MySNSTopicForNotificationRules",
"TargetType": "SNS",
"TargetStatus": "ACTIVE"
},
{
"TargetAddress": "arn:aws:sns:us-east-1:123456789012:MySNSTopicForNotificationsAboutMyDemoRepo",
"TargetType": "SNS",
"TargetStatus": "ACTIVE"
}
]
}
```
Para obter mais informações, consulte [Visualizar destinos de regra de notificação](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/notification-target-view.html) no *Guia do usuário do console de ferramentas do desenvolvedor da AWS *.
+ Para obter detalhes da API, consulte [ListTargets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-notifications/list-targets.html)em *Referência de AWS CLI Comandos*.
### `subscribe`
O código de exemplo a seguir mostra como usar `subscribe`.
**AWS CLI**
**Para adicionar um destino a uma regra de notificação**
O exemplo `subscribe` a seguir adiciona um tópico do Amazon SNS como um destino para a regra de notificação especificada.
```
aws codestar-notifications subscribe \
--arn arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/dc82df7a-EXAMPLE \
--target TargetType=SNS,TargetAddress=arn:aws:sns:us-east-1:123456789012:MyNotificationTopic
```
Saída:
```
{
"Arn": "arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/dc82df7a-EXAMPLE"
}
```
Para obter mais informações, consulte [Adicionar ou remover um tópico do Amazon SNS como destino para uma regra de notificação](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/notification-target-change-rule.html) no *Guia do usuário do console de ferramentas do desenvolvedor da AWS *.
+ Consulte detalhes da API em [Subscribe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-notifications/subscribe.html) na *Referência de comandos da AWS CLI *.
### `tag-resource`
O código de exemplo a seguir mostra como usar `tag-resource`.
**AWS CLI**
**Para adicionar uma tag a uma regra de notificação**
O exemplo `tag-resource` a seguir adiciona uma tag com o nome de chave de `Team` e o valor de `Li_Juan` à regra de notificação especificada.
```
aws codestar-notifications tag-resource \
--arn arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/fe1efd35-EXAMPLE \
--tags Team=Li_Juan
```
Saída:
```
{
"Tags": {
"Team": "Li_Juan"
}
}
```
Para obter mais informações, consulte [Criar uma regra de notificação](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/notification-rule-create.html) no *Guia do usuário do console de ferramentas do desenvolvedor da AWS *.
+ Para obter detalhes da API, consulte [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-notifications/tag-resource.html)em *Referência de AWS CLI Comandos*.
### `unsubscribe`
O código de exemplo a seguir mostra como usar `unsubscribe`.
**AWS CLI**
**Para remover um destino de uma regra de notificação**
O exemplo `unsubscribe` a seguir remove um tópico do Amazon SNS como um destino da regra de notificação especificada.
```
aws codestar-notifications unsubscribe \
--arn arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/dc82df7a-EXAMPLE \
--target TargetType=SNS,TargetAddress=arn:aws:sns:us-east-1:123456789012:MyNotificationTopic
```
Saída:
```
{
"Arn": "arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/dc82df7a-EXAMPLE"
"TargetAddress": "arn:aws:sns:us-east-1:123456789012:MyNotificationTopic"
}
```
Para obter mais informações, consulte [Adicionar ou remover um tópico do Amazon SNS como destino para uma regra de notificação](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/notification-target-change-rule.html) no *Guia do usuário do console de ferramentas do desenvolvedor da AWS *.
+ Consulte detalhes da API em [Unsubscribe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-notifications/unsubscribe.html) na *Referência de comandos da AWS CLI *.
### `untag-resource`
O código de exemplo a seguir mostra como usar `untag-resource`.
**AWS CLI**
**Para remover uma tag de uma regra de notificação**
O exemplo `untag-resource` a seguir remove a tag com uma chave de nome `Team` da regra de notificação especificada.
```
aws codestar-notifications untag-resource \
--arn arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/fe1efd35-EXAMPLE \
--tag-keys Team
```
Este comando não produz saída.
Para obter mais informações, consulte [Editar uma regra de notificação](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/notification-rule-edit.html) no *Guia do usuário do console de ferramentas do desenvolvedor da AWS *.
+ Para obter detalhes da API, consulte [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-notifications/untag-resource.html)em *Referência de AWS CLI Comandos*.
### `update-notification-rule`
O código de exemplo a seguir mostra como usar `update-notification-rule`.
**AWS CLI**
**Para atualizar uma regra de notificação**
O `update-notification-rule` exemplo a seguir atualiza uma regra de notificação nomeada `MyNotificationRule` na AWS conta `123456789012` usando um arquivo JSON chamado`update.json`.
```
aws codestar-notifications update-notification-rule \
--cli-input-json file://update.json
```
Conteúdo de `update.json`:
```
{
"Name": "MyUpdatedNotificationRule",
"EventTypeIds": [
"codecommit-repository-branches-and-tags-created"
],
"Resource": "arn:aws:codecommit:us-east-1:123456789012:MyDemoRepo",
"Targets": [
{
"TargetType": "SNS",
"TargetAddress": "arn:aws:sns:us-east-1:123456789012:MyNotificationTopic"
}
],
"Status": "ENABLED",
"DetailType": "FULL"
}
```
Saída:
```
{
"Arn": "arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/dc82df7a-EXAMPLE"
}
```
Para obter mais informações, consulte [Editar uma regra de notificação](https://docs.aws.amazon.com/dtconsole/latest/userguide/notification-rule-edit.html) no *Guia do usuário do console de ferramentas do desenvolvedor da AWS *.
+ Para obter detalhes da API, consulte [UpdateNotificationRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codestar-notifications/update-notification-rule.html)em *Referência de AWS CLI Comandos*.