Hay más ejemplos de AWS SDK disponibles en el GitHub repositorio de [ejemplos de AWS Doc SDK](https://github.com/awsdocs/aws-doc-sdk-examples).
Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Ejemplos de Amazon SNS que utilizan AWS CLI
Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes AWS Command Line Interface mediante Amazon SNS.
Las *acciones* son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.
Los *escenarios* son ejemplos de código que muestran cómo llevar a cabo una tarea específica a través de llamadas a varias funciones dentro del servicio o combinado con otros Servicios de AWS.
En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.
**Topics**
+ [Acciones](#actions)
+ [Escenarios](#scenarios)
## Acciones
### `add-permission`
En el siguiente ejemplo de código, se muestra cómo utilizar `add-permission`.
**AWS CLI**
**Para añadir un permiso a un tema**
En el siguiente `add-permission` ejemplo, se añade el permiso para `987654321098` que la AWS cuenta utilice la `Publish` acción con el tema especificado en la sección AWS Cuenta`123456789012`.
```
aws sns add-permission \
--topic-arn arn:aws:sns:us-west-2:123456789012:MyTopic \
--label Publish-Permission \
--aws-account-id 987654321098 \
--action-name Publish
```
Este comando no genera ninguna salida.
+ Para obtener más información sobre la API, consulte [AddPermission](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/add-permission.html)la *Referencia de AWS CLI comandos*.
### `check-if-phone-number-is-opted-out`
En el siguiente ejemplo de código, se muestra cómo utilizar `check-if-phone-number-is-opted-out`.
**AWS CLI**
**Comprobar que se ha cancelado la recepción de mensajes SMS en un número de teléfono**
En el siguiente `check-if-phone-number-is-opted-out` ejemplo, se comprueba si el número de teléfono especificado está excluido de la recepción de mensajes SMS de la AWS cuenta corriente.
```
aws sns check-if-phone-number-is-opted-out \
--phone-number +1555550100
```
Salida:
```
{
"isOptedOut": false
}
```
+ Para obtener más información sobre la API, consulte [CheckIfPhoneNumberIsOptedOut](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/check-if-phone-number-is-opted-out.html)la *Referencia de AWS CLI comandos*.
### `confirm-subscription`
En el siguiente ejemplo de código, se muestra cómo utilizar `confirm-subscription`.
**AWS CLI**
**Confirmar una suscripción**
El siguiente comando `confirm-subscription` completa el proceso de confirmación que se inició al suscribirse a un tema de SNS denominado `my-topic`. El parámetro --token proviene del mensaje de confirmación enviado al punto de conexión de notificación especificado en la llamada de suscripción.
```
aws sns confirm-subscription \
--topic-arn arn:aws:sns:us-west-2:123456789012:my-topic \
--token 2336412f37fb687f5d51e6e241d7700ae02f7124d8268910b858cb4db727ceeb2474bb937929d3bdd7ce5d0cce19325d036bc858d3c217426bcafa9c501a2cace93b83f1dd3797627467553dc438a8c974119496fc3eff026eaa5d14472ded6f9a5c43aec62d83ef5f49109da7176391
```
Salida:
```
{
"SubscriptionArn": "arn:aws:sns:us-west-2:123456789012:my-topic:8a21d249-4329-4871-acc6-7be709c6ea7f"
}
```
+ Para obtener más información sobre la API, consulte [ConfirmSubscription](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/confirm-subscription.html)la *Referencia de AWS CLI comandos*.
### `create-platform-application`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-platform-application`.
**AWS CLI**
**Para crear una aplicación de plataforma**
En el siguiente ejemplo de `create-platform-application`, se crea una aplicación de la plataforma Google Firebase con la credencial de plataforma especificada.
```
aws sns create-platform-application \
--name MyApplication \
--platform GCM \
--attributes PlatformCredential=EXAMPLEabcd12345jklm67890stuv12345bcdef
```
Salida:
```
{
"PlatformApplicationArn": "arn:aws:sns:us-west-2:123456789012:app/GCM/MyApplication"
}
```
+ Para obtener más información sobre la API, consulte [CreatePlatformApplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/create-platform-application.html)la *Referencia de AWS CLI comandos*.
### `create-topic`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-topic`.
**AWS CLI**
**Creación de un tema de SNS**
En el siguiente ejemplo de `create-topic` se crea un tema de SNS denominado `my-topic`.
```
aws sns create-topic \
--name my-topic
```
Salida:
```
{
"ResponseMetadata": {
"RequestId": "1469e8d7-1642-564e-b85d-a19b4b341f83"
},
"TopicArn": "arn:aws:sns:us-west-2:123456789012:my-topic"
}
```
Para obtener más información, consulte [Uso de la interfaz de línea de AWS comandos con Amazon SQS y Amazon SNS](https://docs.aws.amazon.com/cli/latest/userguide/cli-sqs-queue-sns-topic.html) en la Guía del usuario de *AWS la interfaz de línea de comandos*.
+ Para obtener más información sobre la API, consulte la Referencia [CreateTopic](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/create-topic.html)de *AWS CLI comandos*.
### `delete-endpoint`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-endpoint`.
**AWS CLI**
**Para eliminar un punto de conexión de aplicación de plataforma**
En el siguiente ejemplo de `delete-endpoint`, se elimina el punto de conexión de la aplicación de la plataforma especificado.
```
aws sns delete-endpoint \
--endpoint-arn arn:aws:sns:us-west-2:123456789012:endpoint/GCM/MyApplication/12345678-abcd-9012-efgh-345678901234
```
Este comando no genera ninguna salida.
+ Para obtener más información sobre la API, consulte [DeleteEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/delete-endpoint.html)la *Referencia de AWS CLI comandos*.
### `delete-platform-application`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-platform-application`.
**AWS CLI**
**Para eliminar una aplicación de plataforma**
En el siguiente ejemplo de `delete-platform-application`, se elimina la aplicación de la plataforma especificada.
```
aws sns delete-platform-application \
--platform-application-arn arn:aws:sns:us-west-2:123456789012:app/ADM/MyApplication
```
Este comando no genera ninguna salida.
+ Para obtener más información sobre la API, consulte [DeletePlatformApplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/delete-platform-application.html)la *Referencia de AWS CLI comandos*.
### `delete-topic`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-topic`.
**AWS CLI**
**Eliminación de un tema de SNS**
El siguiente ejemplo de `delete-topic` elimina el tema de SNS especificado.
```
aws sns delete-topic \
--topic-arn "arn:aws:sns:us-west-2:123456789012:my-topic"
```
Este comando no genera ninguna salida.
+ Para obtener más información sobre la API, consulte [DeleteTopic](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/delete-topic.html)la *Referencia de AWS CLI comandos*.
### `get-endpoint-attributes`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-endpoint-attributes`.
**AWS CLI**
**Para enumerar los atributos de punto de conexión de la aplicación de plataforma**
En el siguiente ejemplo de `get-endpoint-attributes`, se enumeran los atributos del punto de conexión de la aplicación de la plataforma especificado.
```
aws sns get-endpoint-attributes \
--endpoint-arn arn:aws:sns:us-west-2:123456789012:endpoint/GCM/MyApplication/12345678-abcd-9012-efgh-345678901234
```
Salida:
```
{
"Attributes": {
"Enabled": "true",
"Token": "EXAMPLE12345..."
}
}
```
+ Para obtener más información sobre la API, consulte [GetEndpointAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/get-endpoint-attributes.html)la *Referencia de AWS CLI comandos*.
### `get-platform-application-attributes`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-platform-application-attributes`.
**AWS CLI**
**Para enumerar los atributos de la aplicación de plataforma**
En el siguiente ejemplo de `get-platform-application-attributes`, se enumeran los atributos de la aplicación de la plataforma especificada.
```
aws sns get-platform-application-attributes \
--platform-application-arn arn:aws:sns:us-west-2:123456789012:app/MPNS/MyApplication
```
Salida:
```
{
"Attributes": {
"Enabled": "true",
"SuccessFeedbackSampleRate": "100"
}
}
```
+ Para obtener más información sobre la API, consulte [GetPlatformApplicationAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/get-platform-application-attributes.html)la *Referencia de AWS CLI comandos*.
### `get-sms-attributes`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-sms-attributes`.
**AWS CLI**
**Mostrar los atributos predeterminados de los mensajes SMS**
En el siguiente ejemplo de `get-sms-attributes`, se muestran los atributos predeterminados para enviar mensajes SMS.
```
aws sns get-sms-attributes
```
Salida:
```
{
"attributes": {
"DefaultSenderID": "MyName"
}
}
```
+ Para obtener información sobre la API, consulte [GetSMSAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/get-sms-attributes.html) en la *Referencia de comandos de la AWS CLI *.
### `get-subscription-attributes`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-subscription-attributes`.
**AWS CLI**
**Para recuperar los atributos de suscripción de un tema**
En el siguiente ejemplo de `get-subscription-attributes`, se muestran los atributos de la suscripción especificada. Puede obtener el `subscription-arn` del resultado del comando `list-subscriptions`.
```
aws sns get-subscription-attributes \
--subscription-arn "arn:aws:sns:us-west-2:123456789012:my-topic:8a21d249-4329-4871-acc6-7be709c6ea7f"
```
Salida:
```
{
"Attributes": {
"Endpoint": "my-email@example.com",
"Protocol": "email",
"RawMessageDelivery": "false",
"ConfirmationWasAuthenticated": "false",
"Owner": "123456789012",
"SubscriptionArn": "arn:aws:sns:us-west-2:123456789012:my-topic:8a21d249-4329-4871-acc6-7be709c6ea7f",
"TopicArn": "arn:aws:sns:us-west-2:123456789012:my-topic"
}
}
```
+ Para obtener más información sobre la API, consulte [GetSubscriptionAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/get-subscription-attributes.html)la *Referencia de AWS CLI comandos*.
### `get-topic-attributes`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-topic-attributes`.
**AWS CLI**
**Recuperación de los atributos de un tema**
En el siguiente ejemplo de `get-topic-attributes`, se muestran los atributos del tema especificado.
```
aws sns get-topic-attributes \
--topic-arn "arn:aws:sns:us-west-2:123456789012:my-topic"
```
Salida:
```
{
"Attributes": {
"SubscriptionsConfirmed": "1",
"DisplayName": "my-topic",
"SubscriptionsDeleted": "0",
"EffectiveDeliveryPolicy": "{\"http\":{\"defaultHealthyRetryPolicy\":{\"minDelayTarget\":20,\"maxDelayTarget\":20,\"numRetries\":3,\"numMaxDelayRetries\":0,\"numNoDelayRetries\":0,\"numMinDelayRetries\":0,\"backoffFunction\":\"linear\"},\"disableSubscriptionOverrides\":false}}",
"Owner": "123456789012",
"Policy": "{\"Version\":\"2008-10-17\",\"Id\":\"__default_policy_ID\",\"Statement\":[{\"Sid\":\"__default_statement_ID\",\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"*\"},\"Action\":[\"SNS:Subscribe\",\"SNS:ListSubscriptionsByTopic\",\"SNS:DeleteTopic\",\"SNS:GetTopicAttributes\",\"SNS:Publish\",\"SNS:RemovePermission\",\"SNS:AddPermission\",\"SNS:SetTopicAttributes\"],\"Resource\":\"arn:aws:sns:us-west-2:123456789012:my-topic\",\"Condition\":{\"StringEquals\":{\"AWS:SourceOwner\":\"0123456789012\"}}}]}",
"TopicArn": "arn:aws:sns:us-west-2:123456789012:my-topic",
"SubscriptionsPending": "0"
}
}
```
+ Para obtener más información sobre la API, consulte [GetTopicAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/get-topic-attributes.html)la *Referencia de AWS CLI comandos*.
### `list-endpoints-by-platform-application`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-endpoints-by-platform-application`.
**AWS CLI**
**Para enumerar los puntos de conexión de una aplicación de plataforma**
En el siguiente ejemplo de `list-endpoints-by-platform-application`, se enumeran los puntos de conexión y los atributos de los puntos de conexión de la aplicación de la plataforma especificada.
```
aws sns list-endpoints-by-platform-application \
--platform-application-arn arn:aws:sns:us-west-2:123456789012:app/GCM/MyApplication
```
Salida:
```
{
"Endpoints": [
{
"Attributes": {
"Token": "EXAMPLE12345...,
"Enabled": "true"
},
"EndpointArn": "arn:aws:sns:us-west-2:123456789012:endpoint/GCM/MyApplication/12345678-abcd-9012-efgh-345678901234"
}
]
}
```
+ Para obtener más información sobre la API, consulte [ListEndpointsByPlatformApplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/list-endpoints-by-platform-application.html)la *Referencia de AWS CLI comandos*.
### `list-phone-numbers-opted-out`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-phone-numbers-opted-out`.
**AWS CLI**
**Mostrar exclusiones de mensajes SMS**
El siguiente ejemplo de `list-phone-numbers-opted-out` muestra los números de teléfono excluidos de la recepción de mensajes SMS.
```
aws sns list-phone-numbers-opted-out
```
Salida:
```
{
"phoneNumbers": [
"+15555550100"
]
}
```
+ Para obtener más información sobre la API, consulte [ListPhoneNumbersOptedOut](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/list-phone-numbers-opted-out.html)la *Referencia de AWS CLI comandos*.
### `list-platform-applications`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-platform-applications`.
**AWS CLI**
**Para enumerar las aplicaciones de plataforma**
En el siguiente ejemplo de `list-platform-applications`, se enumeran las aplicaciones de plataforma para ADM y MPNS.
```
aws sns list-platform-applications
```
Salida:
```
{
"PlatformApplications": [
{
"PlatformApplicationArn": "arn:aws:sns:us-west-2:123456789012:app/ADM/MyApplication",
"Attributes": {
"SuccessFeedbackSampleRate": "100",
"Enabled": "true"
}
},
{
"PlatformApplicationArn": "arn:aws:sns:us-west-2:123456789012:app/MPNS/MyOtherApplication",
"Attributes": {
"SuccessFeedbackSampleRate": "100",
"Enabled": "true"
}
}
]
}
```
+ Para obtener más información sobre la API, consulte [ListPlatformApplications](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/list-platform-applications.html)la *Referencia de AWS CLI comandos*.
### `list-subscriptions-by-topic`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-subscriptions-by-topic`.
**AWS CLI**
**Para enumerar las suscripciones asociadas a un tema**
En el siguiente ejemplo de `list-subscriptions-by-topic`, se recupera una lista de las suscripciones de SNS asociadas al tema especificado.
```
aws sns list-subscriptions-by-topic \
--topic-arn "arn:aws:sns:us-west-2:123456789012:my-topic"
```
Salida:
```
{
"Subscriptions": [
{
"Owner": "123456789012",
"Endpoint": "my-email@example.com",
"Protocol": "email",
"TopicArn": "arn:aws:sns:us-west-2:123456789012:my-topic",
"SubscriptionArn": "arn:aws:sns:us-west-2:123456789012:my-topic:8a21d249-4329-4871-acc6-7be709c6ea7f"
}
]
}
```
+ Para obtener más información sobre la API, consulte [ListSubscriptionsByTopic](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/list-subscriptions-by-topic.html)la *Referencia de AWS CLI comandos*.
### `list-subscriptions`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-subscriptions`.
**AWS CLI**
**Mostrar las suscripciones de SNS**
En el siguiente `list-subscriptions` ejemplo, se muestra una lista de las suscripciones de redes sociales de su AWS cuenta.
```
aws sns list-subscriptions
```
Salida:
```
{
"Subscriptions": [
{
"Owner": "123456789012",
"Endpoint": "my-email@example.com",
"Protocol": "email",
"TopicArn": "arn:aws:sns:us-west-2:123456789012:my-topic",
"SubscriptionArn": "arn:aws:sns:us-west-2:123456789012:my-topic:8a21d249-4329-4871-acc6-7be709c6ea7f"
}
]
}
```
+ Para obtener más información sobre la API, consulte [ListSubscriptions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/list-subscriptions.html)la *Referencia de AWS CLI comandos*.
### `list-tags-for-resource`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-tags-for-resource`.
**AWS CLI**
**Para enumerar las etiquetas de un tema**
En el siguiente ejemplo de `list-tags-for-resource`, se enumeran las etiquetas de un tema de Amazon SNS específico.
```
aws sns list-tags-for-resource \
--resource-arn arn:aws:sns:us-west-2:123456789012:MyTopic
```
Salida:
```
{
"Tags": [
{
"Key": "Team",
"Value": "Alpha"
}
]
}
```
+ Para obtener más información sobre la API, consulte [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/list-tags-for-resource.html)la *Referencia de AWS CLI comandos*.
### `list-topics`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-topics`.
**AWS CLI**
**Mostrar los temas de SNS**
En el siguiente `list-topics` ejemplo, se enumeran todos los temas de SNS de tu AWS cuenta.
```
aws sns list-topics
```
Salida:
```
{
"Topics": [
{
"TopicArn": "arn:aws:sns:us-west-2:123456789012:my-topic"
}
]
}
```
+ Para obtener más información sobre la API, consulte [ListTopics](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/list-topics.html)la *Referencia de AWS CLI comandos*.
### `opt-in-phone-number`
En el siguiente ejemplo de código, se muestra cómo utilizar `opt-in-phone-number`.
**AWS CLI**
**Para optar por recibir mensajes SMS**
El siguiente ejemplo de `opt-in-phone-number`, se permite que el número de teléfono especificado reciba mensajes SMS.
```
aws sns opt-in-phone-number \
--phone-number +15555550100
```
Este comando no genera ninguna salida.
+ Para obtener más información sobre la API, consulte [OptInPhoneNumber](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/opt-in-phone-number.html)la *Referencia de AWS CLI comandos*.
### `publish`
En el siguiente ejemplo de código, se muestra cómo utilizar `publish`.
**AWS CLI**
**Ejemplo 1: publicar un mensaje en un tema**
En el siguiente ejemplo de `publish` se publica el mensaje especificado en el tema de SNS especificado. El mensaje proviene de un archivo de texto que le permite incluir saltos de línea.
```
aws sns publish \
--topic-arn "arn:aws:sns:us-west-2:123456789012:my-topic" \
--message file://message.txt
```
Contenido de `message.txt`:
```
Hello World
Second Line
```
Salida:
```
{
"MessageId": "123a45b6-7890-12c3-45d6-111122223333"
}
```
**Ejemplo 2: publicar un mensaje SMS en un número de teléfono**
En el siguiente ejemplo de `publish`, se publica el mensaje `Hello world!` en el número de teléfono `+1-555-555-0100`.
```
aws sns publish \
--message "Hello world!" \
--phone-number +1-555-555-0100
```
Salida:
```
{
"MessageId": "123a45b6-7890-12c3-45d6-333322221111"
}
```
+ Para obtener detalles sobre la API, consulte [Publish](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/publish.html) en la *Referencia del comando de la AWS CLI *.
### `put-data-protection-policy`
En el siguiente ejemplo de código, se muestra cómo utilizar `put-data-protection-policy`.
**AWS CLI**
**Para definir la política de protección de datos**
**Ejemplo 1: impedir que los editores publiquen mensajes con CreditCardNumber**
El siguiente `put-data-protection-policy` ejemplo impide a los editores publicar mensajes con CreditCardNumber.
```
aws sns put-data-protection-policy \
--resource-arn arn:aws:sns:us-east-1:123456789012:mytopic \
--data-protection-policy "{\"Name\":\"data_protection_policy\",\"Description\":\"Example data protection policy\",\"Version\":\"2021-06-01\",\"Statement\":[{\"DataDirection\":\"Inbound\",\"Principal\":[\"*\"],\"DataIdentifier\":[\"arn:aws:dataprotection::aws:data-identifier/CreditCardNumber\"],\"Operation\":{\"Deny\":{}}}]}"
```
Este comando no genera ninguna salida.
**Ejemplo 2: cómo cargar parámetros de un archivo**
En el siguiente ejemplo de `put-data-protection-policy`, se cargan parámetros de un archivo.
```
aws sns put-data-protection-policy \
--resource-arn arn:aws:sns:us-west-2:123456789012:MyTopic \
--data-protection-policy file://policy.json
```
Este comando no genera ninguna salida.
+ Para obtener más información sobre la API, consulte [PutDataProtectionPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/put-data-protection-policy.html)la *Referencia de AWS CLI comandos*.
### `remove-permission`
En el siguiente ejemplo de código, se muestra cómo utilizar `remove-permission`.
**AWS CLI**
**Para eliminar un permiso de un tema**
En el siguiente ejemplo de `remove-permission`, se retira el permiso `Publish-Permission` del tema especificado.
```
aws sns remove-permission \
--topic-arn arn:aws:sns:us-west-2:123456789012:MyTopic \
--label Publish-Permission
```
Este comando no genera ninguna salida.
+ Para obtener más información sobre la API, consulte [RemovePermission](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/remove-permission.html)la *Referencia de AWS CLI comandos*.
### `set-endpoint-attributes`
En el siguiente ejemplo de código, se muestra cómo utilizar `set-endpoint-attributes`.
**AWS CLI**
**Para definir los atributos de punto de conexión**
En el siguiente ejemplo de `set-endpoint-attributes`, se desactiva el punto de conexión de la aplicación de la plataforma especificado.
```
aws sns set-endpoint-attributes \
--endpoint-arn arn:aws:sns:us-west-2:123456789012:endpoint/GCM/MyApplication/12345678-abcd-9012-efgh-345678901234 \
--attributes Enabled=false
```
Salida:
```
{
"Attributes": {
"Enabled": "false",
"Token": "EXAMPLE12345..."
}
}
```
+ Para obtener más información sobre la API, consulte [SetEndpointAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/set-endpoint-attributes.html)la *Referencia de AWS CLI comandos*.
### `set-platform-application-attributes`
En el siguiente ejemplo de código, se muestra cómo utilizar `set-platform-application-attributes`.
**AWS CLI**
**Para definir los atributos de una aplicación de plataforma**
En el siguiente ejemplo de `set-platform-application-attributes`, se establece el atributo `EventDeliveryFailure` de la aplicación de plataforma especificada en el ARN del tema de Amazon SNS especificado.
```
aws sns set-platform-application-attributes \
--platform-application-arn arn:aws:sns:us-west-2:123456789012:app/GCM/MyApplication \
--attributes EventDeliveryFailure=arn:aws:sns:us-west-2:123456789012:AnotherTopic
```
Este comando no genera ninguna salida.
+ Para obtener más información sobre la API, consulte [SetPlatformApplicationAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/set-platform-application-attributes.html)la *Referencia de AWS CLI comandos*.
### `set-sms-attributes`
En el siguiente ejemplo de código, se muestra cómo utilizar `set-sms-attributes`.
**AWS CLI**
**Establecimiento de los atributos de los mensajes SMS**
En el siguiente ejemplo de `set-sms-attributes`, se establece el ID de remitente predeterminado para los mensajes SMS a `MyName`.
```
aws sns set-sms-attributes \
--attributes DefaultSenderID=MyName
```
Este comando no genera ninguna salida.
+ Para obtener información sobre la API, consulte [Set SMSAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/set-sms-attributes.html) in *AWS CLI Command Reference*.
### `set-subscription-attributes`
En el siguiente ejemplo de código, se muestra cómo utilizar `set-subscription-attributes`.
**AWS CLI**
**Establecimiento de los atributos de suscripción**
En el siguiente ejemplo de `set-subscription-attributes`, se establece el atributo `RawMessageDelivery` en una suscripción de SQS.
```
aws sns set-subscription-attributes \
--subscription-arn arn:aws:sns:us-east-1:123456789012:mytopic:f248de18-2cf6-578c-8592-b6f1eaa877dc \
--attribute-name RawMessageDelivery \
--attribute-value true
```
Este comando no genera ninguna salida.
En el siguiente ejemplo de `set-subscription-attributes`, se establece un atributo `FilterPolicy` en una suscripción de SQS.
```
aws sns set-subscription-attributes \
--subscription-arn arn:aws:sns:us-east-1:123456789012:mytopic:f248de18-2cf6-578c-8592-b6f1eaa877dc \
--attribute-name FilterPolicy \
--attribute-value "{ \"anyMandatoryKey\": [\"any\", \"of\", \"these\"] }"
```
Este comando no genera ninguna salida.
En el siguiente ejemplo de `set-subscription-attributes`, se elimina el atributo `FilterPolicy` de una suscripción de SQS.
```
aws sns set-subscription-attributes \
--subscription-arn arn:aws:sns:us-east-1:123456789012:mytopic:f248de18-2cf6-578c-8592-b6f1eaa877dc \
--attribute-name FilterPolicy \
--attribute-value "{}"
```
Este comando no genera ninguna salida.
+ Para obtener más información sobre la API, consulte [SetSubscriptionAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/set-subscription-attributes.html)la *Referencia de AWS CLI comandos*.
### `set-topic-attributes`
En el siguiente ejemplo de código, se muestra cómo utilizar `set-topic-attributes`.
**AWS CLI**
**Establecimiento de un atributo para un tema**
En el ejemplo de `set-topic-attributes` siguiente, se establece el atributo `DisplayName` del tema especificado.
```
aws sns set-topic-attributes \
--topic-arn arn:aws:sns:us-west-2:123456789012:MyTopic \
--attribute-name DisplayName \
--attribute-value MyTopicDisplayName
```
Este comando no genera ninguna salida.
+ Para obtener más información sobre la API, consulte [SetTopicAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/set-topic-attributes.html)la *Referencia de AWS CLI comandos*.
### `subscribe`
En el siguiente ejemplo de código, se muestra cómo utilizar `subscribe`.
**AWS CLI**
**Suscripción a un tema**
El siguiente comando `subscribe` suscribe una dirección de correo electrónico al tema especificado.
```
aws sns subscribe \
--topic-arn arn:aws:sns:us-west-2:123456789012:my-topic \
--protocol email \
--notification-endpoint my-email@example.com
```
Salida:
```
{
"SubscriptionArn": "pending confirmation"
}
```
+ Para obtener detalles sobre la API, consulte [Subscribe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/subscribe.html) en la *Referencia de comandos de la AWS CLI *.
### `tag-resource`
En el siguiente ejemplo de código, se muestra cómo utilizar `tag-resource`.
**AWS CLI**
**Añadir una etiqueta a un tema**
El siguiente ejemplo de `tag-resource` añade una etiqueta de metadatos al tema de Amazon SNS especificado.
```
aws sns tag-resource \
--resource-arn arn:aws:sns:us-west-2:123456789012:MyTopic \
--tags Key=Team,Value=Alpha
```
Este comando no genera ninguna salida.
+ Para obtener más información sobre la API, consulte [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/tag-resource.html)la *Referencia de AWS CLI comandos*.
### `unsubscribe`
En el siguiente ejemplo de código, se muestra cómo utilizar `unsubscribe`.
**AWS CLI**
**Cancelación de la suscripción a un tema**
En el siguiente ejemplo de `unsubscribe`, se elimina la suscripción especificada de un tema.
```
aws sns unsubscribe \
--subscription-arn arn:aws:sns:us-west-2:0123456789012:my-topic:8a21d249-4329-4871-acc6-7be709c6ea7f
```
Este comando no genera ninguna salida.
+ Para obtener detalles sobre la API, consulte [Unsubscribe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/unsubscribe.html) en la *Referencia de comandos de la AWS CLI *.
### `untag-resource`
En el siguiente ejemplo de código, se muestra cómo utilizar `untag-resource`.
**AWS CLI**
**Para eliminar una etiqueta de un tema**
En el siguiente ejemplo de `untag-resource`, se eliminan las etiquetas con las claves especificadas del tema de Amazon SNS indicado.
```
aws sns untag-resource \
--resource-arn arn:aws:sns:us-west-2:123456789012:MyTopic \
--tag-keys Team
```
Este comando no genera ninguna salida.
+ Para obtener más información sobre la API, consulte [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/untag-resource.html)la *Referencia de AWS CLI comandos*.
## Escenarios
### Creación de un punto de conexión de la plataforma para notificaciones push
El siguiente ejemplo de código indica cómo crear un punto de enlace de la plataforma para las notificaciones push de Amazon SNS.
**AWS CLI**
**Creación de un punto de conexión de aplicación de plataforma**
En el siguiente ejemplo de `create-platform-endpoint`, se crea un punto de conexión para la aplicación de plataforma especificada mediante el token especificado.
```
aws sns create-platform-endpoint \
--platform-application-arn arn:aws:sns:us-west-2:123456789012:app/GCM/MyApplication \
--token EXAMPLE12345...
```
Salida:
```
{
"EndpointArn": "arn:aws:sns:us-west-2:1234567890:endpoint/GCM/MyApplication/12345678-abcd-9012-efgh-345678901234"
}
```