Ejemplos de Amazon SNS que utilizan AWS CLI

PDF

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.

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 Cuenta123456789012.

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 AddPermissionla Referencia de AWS CLI comandos.

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 Cuenta123456789012.

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 AddPermissionla 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 [phone]

Salida:

{
    "isOptedOut": false
}

• Para obtener más información sobre la API, consulte CheckIfPhoneNumberIsOptedOutla 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 [phone]

Salida:

{
    "isOptedOut": false
}

• Para obtener más información sobre la API, consulte CheckIfPhoneNumberIsOptedOutla 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 ConfirmSubscriptionla 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 ConfirmSubscriptionla 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 CreatePlatformApplicationla 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 CreatePlatformApplicationla 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 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 CreateTopicde 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 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 CreateTopicde 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 DeleteEndpointla Referencia 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 DeleteEndpointla 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 DeletePlatformApplicationla 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 DeletePlatformApplicationla 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 DeleteTopicla 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 DeleteTopicla 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 GetEndpointAttributesla 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 GetEndpointAttributesla 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 GetPlatformApplicationAttributesla 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 GetPlatformApplicationAttributesla 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 en la Referencia de comandos de la AWS CLI .

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 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": "[e-mail]",
        "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 GetSubscriptionAttributesla Referencia de AWS CLI comandos.

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": "[e-mail]",
        "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 GetSubscriptionAttributesla 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 GetTopicAttributesla 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 GetTopicAttributesla 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 ListEndpointsByPlatformApplicationla 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 ListEndpointsByPlatformApplicationla 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": [
        "[phone]"
    ]
}

• Para obtener más información sobre la API, consulte ListPhoneNumbersOptedOutla 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": [
        "[phone]"
    ]
}

• Para obtener más información sobre la API, consulte ListPhoneNumbersOptedOutla 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 ListPlatformApplicationsla 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 ListPlatformApplicationsla 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": "[e-mail]",
            "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 ListSubscriptionsByTopicla 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": "[e-mail]",
            "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 ListSubscriptionsByTopicla 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": "[e-mail]",
            "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 ListSubscriptionsla 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": "[e-mail]",
            "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 ListSubscriptionsla 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 ListTagsForResourcela 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 ListTagsForResourcela 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 ListTopicsla 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 ListTopicsla 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 [phone]

Este comando no genera ninguna salida.

• Para obtener más información sobre la API, consulte OptInPhoneNumberla 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 [phone]

Este comando no genera ninguna salida.

• Para obtener más información sobre la API, consulte OptInPhoneNumberla 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 [phone].

aws sns publish \
    --message "Hello world!" \
    --phone-number [phone]

Salida:

{
    "MessageId": "123a45b6-7890-12c3-45d6-333322221111"
}

• Para obtener detalles sobre la API, consulte Publish en la Referencia del comando de la AWS CLI .

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 [phone].

aws sns publish \
    --message "Hello world!" \
    --phone-number [phone]

Salida:

{
    "MessageId": "123a45b6-7890-12c3-45d6-333322221111"
}

• Para obtener detalles sobre la API, consulte Publish 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 PutDataProtectionPolicyla Referencia de AWS CLI comandos.

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 PutDataProtectionPolicyla 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 RemovePermissionla 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 RemovePermissionla 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 SetEndpointAttributesla 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 SetEndpointAttributesla 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 SetPlatformApplicationAttributesla 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 SetPlatformApplicationAttributesla 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 in AWS CLI Command Reference.

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 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 SetSubscriptionAttributesla Referencia de AWS CLI comandos.

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 SetSubscriptionAttributesla 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 SetTopicAttributesla 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 SetTopicAttributesla 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 [e-mail]

Salida:

{
    "SubscriptionArn": "pending confirmation"
}

• Para obtener detalles sobre la API, consulte Subscribe en la Referencia de comandos de la AWS CLI .

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 [e-mail]

Salida:

{
    "SubscriptionArn": "pending confirmation"
}

• Para obtener detalles sobre la API, consulte Subscribe 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 TagResourcela Referencia de AWS CLI comandos.

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 TagResourcela 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 en la Referencia de comandos de la AWS CLI .

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 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 UntagResourcela Referencia de AWS CLI comandos.

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 UntagResourcela 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"
}

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"
}