Es muy fácil crear temas de SNS, suscripciones y realizar otras operaciones en temas de SNS desde el terminal utilizando la utilidad aw-cli. En este artículo, le mostraré los comandos para crear un tema de SNS, una suscripción, confirmar y eliminar la suscripción mediante aws-cli. Se supone que ya está familiarizado con AWS SNS Service.
Para conocer las operaciones que se pueden realizar en los temas de SNS mediante la utilidad de línea de comandos aws-cli, visite la documentación oficial aquí.
Requisitos previos
- Cuenta de AWS (crear si no tiene una).
- Comprensión básica de los temas de SNS (haga clic aquí para aprender a crear un tema de SNS con Terraform).
- Comprensión básica de la suscripción a SNS.
- Usuario de IAM de AWS con la política AmazonSNSFullAccess adjunta y sus claves secretas y de acceso (haga clic aquí para aprender a crear un usuario de IAM).
- AWS CLI instalado en su máquina local.
¿Qué haremos?
- Compruebe aws cli y exporte la clave secreta y de acceso de AWS en su máquina local.
- Administre temas de SNS mediante aws cli.
Verifique aws cli y exporte aws access &secret key en su máquina local.
Si no tiene aws-cli, consulte la documentación oficial aquí para instalarlo en su máquina local y luego verifique la versión con el siguiente comando.
aws --version
Si ejecuta el siguiente comando, obtendrá un error ya que aún no ha configurado el acceso a su cuenta de AWS en la terminal.
aws sts get-caller-identity
Exporte el acceso de usuario de AWS IAM y las claves secretas en su terminal mediante los siguientes comandos.
export AWS_ACCESS_KEY_ID=<aws-user-access-key>
export AWS_SECRET_ACCESS_KEY=<aws-user-secret-key>
Esta vez, puede verificar su identidad ejecutando el siguiente comando. Debería ver los detalles del usuario en la salida.
aws sts get-caller-identity
Administrar temas de SNS mediante aws-cli
Revisemos los temas de SNS que tenemos en nuestra región actual.
aws sns list-topics
Para simplemente crear un tema de SNS, ejecute el siguiente comando. Puede especificar cualquier otro nombre si lo desea.
aws sns create-topic --name my-sns-topic-by-cli
Al crear un tema de SNS, también podemos especificarle etiquetas. Incluso puede especificar varias etiquetas a la vez.
aws sns create-topic --name my-sns-topic-by-cli-with-tag --tags Key=env,Value=test
Enumere los temas y podrá ver los temas recién creados esta vez.
aws sns list-topics
También puede verificar los atributos de un tema de SNS en particular especificando su arn. Para obtener el arn del tema, enumere primero los temas y luego copie el arn del tema deseado.
aws sns list-topics
aws sns get-topic-attributes --topic-arn arn:aws:sns:us-east-1:<your-account-number>:my-sns-topic-by-cli
Puede verificar todas las suscripciones en la región actual usando el siguiente comando.
aws sns list-subscriptions
Para crear una suscripción, debe especificar el protocolo y el arn del tema SNS. En este caso, crearemos una suscripción con el correo electrónico como punto final. Hay varios puntos finales admitidos por la suscripción, puede especificar el deseado.
aws sns subscribe --topic-arn arn:aws:sns:us-east-1:<your-account-number>:my-sns-topic-by-cli --protocol email --notification-endpoint <email-id>@<domain>
aws sns list-subscriptions
Después de crear la Suscripción, recibirá un correo electrónico de confirmación. La suscripción se puede confirmar haciendo clic en el enlace especificado en el correo electrónico o se puede usar un token para confirmar desde la CLI. Copie la dirección del enlace para recuperar el token, veremos el comando para confirmar la suscripción desde la terminal.
La dirección del enlace de confirmación contendrá el token como se destaca a continuación. Cópielo para confirmarlo desde la CLI.
Para confirmar la suscripción mediante aws-cli, utilice el siguiente comando y especifique el tema-arn y el token en el comando.
aws sns list-subscriptions
aws sns confirm-subscription --topic-arn arn:aws:sns:us-east-1:<your-account-number>:my-sns-topic-by-cli --token 2336412f37fb687f5d51e6e2425e90ccf51427f70d347f743e373ed99c34222d699f93426571175db9bc0b81296ae69f53a889e1fbd11571c642308353d4648c67a2851b17a7f3cc1b7e1aaccae0881c5855df5d37bcae458305855d98fcd012d1ed4728a2064c6425b77b00e62b8d4fcf7fcccfb212d6850e3fa450c25cdf9a
aws sns list-subscriptions
La suscripción se puede eliminar o cancelar simplemente especificando el arn de suscripción. Una vez que se cancela la suscripción del punto final, las notificaciones ya no llegarán al punto final.
aws sns list-subscriptions
aws sns unsubscribe --subscription-arn arn:aws:sns:us-east-1:<your-account-number>:my-sns-topic-by-cli:cde0b12a-437c-49da-ab25-bc467701156d
aws sns list-subscriptions
Una vez que ya no necesite el tema, es mejor eliminarlo. Tenga cuidado al eliminar el tema, ya que una vez eliminado no se puede restaurar.
aws sns list-topics
aws sns delete-topic --topic-arn arn:aws:sns:us-east-1:<your-account-number>:my-sns-topic-by-cli
614 aws sns list-topics
Conclusión
En este artículo, vimos los pasos para crear un tema de SNS, suscripción, confirmar suscripción. También vimos cómo se pueden eliminar la suscripción y el tema de SNS con el comando aws-cli.