Spravujte témata AWS SNS pomocí aws-cli

Pomocí nástroje aw-cli je velmi snadné vytvářet témata SNS, předplatná a provádět další operace s tématy SNS z terminálu. V tomto článku vám ukážu příkazy pro vytvoření tématu SNS, předplatné, potvrzení a odstranění předplatného pomocí aws-cli. Předpokládá se, že již znáte službu AWS SNS.

Chcete-li vědět o operacích, které lze s tématy SNS provádět pomocí nástroje příkazového řádku aws-cli, navštivte oficiální dokumentaci zde.

Předpoklady

1. Účet AWS  (vytvořte si, pokud jej nemáte).
2. Základní znalost témat SNS (Kliknutím sem se naučíte vytvářet téma SNS pomocí Terraformu).
3. Základní pochopení předplatného SNS.
4. Uživatel AWS IAM s připojenou zásadou AmazonSNSFullAccess a jeho přístupovými a tajnými klíči (kliknutím sem se naučíte vytvořit uživatele IAM).
5. AWS CLI nainstalované na vašem místním počítači.

Co budeme dělat?

1. Zkontrolujte aws cli a exportujte přístupový a tajný klíč AWS na místní počítač.
2. Spravujte témata SNS pomocí aws cli.

Zkontrolujte aws cli a exportujte aws přístup a tajný klíč na místním počítači.

Pokud aws-cli nemáte, podívejte se na oficiální dokumentaci zde a nainstalujte jej na místní počítač a poté zkontrolujte jeho verzi pomocí následujícího příkazu.

aws --version

Pokud provedete následující příkaz, zobrazí se chyba, protože jste dosud v terminálu nenakonfigurovali přístup ke svému účtu AWS.

aws sts get-caller-identity

Exportujte uživatelský přístup a tajné klíče AWS IAM do svého terminálu pomocí následujících příkazů.

export AWS_ACCESS_KEY_ID=<aws-user-access-key>

export AWS_SECRET_ACCESS_KEY=<aws-user-secret-key>

Tentokrát můžete svou identitu zkontrolovat provedením následujícího příkazu. Ve výstupu byste měli vidět podrobnosti o uživateli.

aws sts get-caller-identity

Správa témat SNS pomocí aws-cli

Pojďme se podívat na témata SNS, která máme v našem současném regionu.

aws sns list-topics

Chcete-li jednoduše vytvořit téma SNS, proveďte následující příkaz. Pokud chcete, můžete zadat jakýkoli jiný název.

aws sns create-topic --name my-sns-topic-by-cli

Při vytváření tématu SNS k němu můžeme také zadat značky. Můžete dokonce zadat více značek najednou.

aws sns create-topic --name my-sns-topic-by-cli-with-tag --tags Key=env,Value=test

Vypište témata a tentokrát uvidíte nově vytvořená témata.

aws sns list-topics

Můžete také zkontrolovat atributy konkrétního tématu SNS zadáním jeho arn. Chcete-li získat arn z tématu, nejprve seznam témat a poté zkopírujte arn požadovaného tématu.

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

Všechna předplatná v aktuální oblasti můžete zkontrolovat pomocí následujícího příkazu.

aws sns list-subscriptions

Chcete-li vytvořit předplatné, musíte zadat protokol a arn tématu SNS. V tomto případě vytvoříme předplatné s e-mailem jako koncovým bodem. Předplatné podporuje různé koncové body, můžete určit požadovaný.

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

Po vytvoření předplatného obdržíte potvrzovací e-mail. Předplatné lze potvrdit kliknutím na odkaz uvedený v e-mailu nebo lze k potvrzení z CLI použít token. Zkopírujte adresu odkazu, abyste z ní získali token, uvidíme příkaz pro potvrzení předplatného z terminálu.

Adresa potvrzovacího odkazu bude obsahovat token, jak je zvýrazněno níže. Zkopírujte jej pro potvrzení z CLI.

Chcete-li potvrdit předplatné pomocí aws-cli, použijte následující příkaz a v příkazu zadejte topic-arn a token.

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

Předplatné lze smazat nebo odhlásit jednoduše zadáním předplatného arn. Jakmile je koncový bod odhlášen, oznámení se již nebudou dostávat do koncového bodu.

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

Jakmile téma již nepotřebujete, je lepší ho smazat. Při mazání tématu buďte opatrní, protože jednou odstraněné téma již nelze obnovit.

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

Závěr

V tomto článku jsme viděli kroky k vytvoření tématu SNS, předplatného, potvrzení odběru. Také jsme viděli, jak lze odstranit předplatné a téma SNS pomocí příkazu aws-cli.