Quản lý chủ đề AWS SNS bằng aws-cli

[theanh]

Rất dễ dàng để tạo chủ đề SNS, đăng ký và thực hiện các thao tác khác trên chủ đề SNS từ thiết bị đầu cuối bằng tiện ích aw-cli. Trong bài viết này, tôi sẽ chỉ cho bạn các lệnh để tạo Chủ đề SNS, Đăng ký, xác nhận và xóa Đăng ký bằng aws-cli. Giả sử bạn đã quen thuộc với Dịch vụ AWS SNS.

Để biết về các hoạt động có thể thực hiện trên các chủ đề SNS bằng tiện ích dòng lệnh aws-cli, hãy truy cập tài liệu chính thức tại đây.

Điều kiện tiên quyết​

1. Tài khoản AWS (Tạo nếu bạn chưa có).
2. Hiểu biết cơ bản về SNS Chủ đề (Nhấp vào đây để tìm hiểu cách tạo Chủ đề SNS bằng Terraform).
3. Hiểu biết cơ bản về Đăng ký SNS.
4. Người dùng AWS IAM có AmazonSNSFullAccesschính sách được đính kèm vào chính sách đó cùng với khóa truy cập và khóa bí mật của chính sách đó (Nhấp vào đây để tìm hiểu cách tạo Người dùng IAM).
5. AWS CLI được cài đặt trên máy cục bộ của bạn.

Chúng ta sẽ làm gì?​

1. Kiểm tra aws cli và xuất AWSaccess & khóa bí mật trên máy cục bộ của bạn.
2. Quản lý chủ đề SNS bằng AWS cli.

Kiểm tra AWS cli và xuất AWS access & khóa bí mật trên máy cục bộ của bạn.​

Nếu bạn không có aws-cli thì hãy tham khảo tài liệu chính thứctại đây để cài đặt trên máy cục bộ của bạn và sau đó kiểm tra phiên bản của nó bằng lệnh sau.

aws --version

Nếu bạn thực hiện lệnh sau, bạn sẽ nhận được lỗi vì bạn chưa cấu hình quyền truy cập vào tài khoản AWS của mình trong thiết bị đầu cuối.

aws sts get-caller-identity

Xuất quyền truy cập người dùng AWS IAM và khóa bí mật trên thiết bị đầu cuối của bạn bằng các lệnh sau.

export AWS_ACCESS_KEY_ID=

export AWS_SECRET_ACCESS_KEY=

Lần này, bạn có thể kiểm tra danh tính của mình bằng cách thực hiện lệnh sau. Bạn sẽ thấy thông tin chi tiết về người dùng trong đầu ra.

aws sts get-caller-identity

Quản lý Chủ đề SNS bằng aws-cli​

Hãy kiểm tra Chủ đề SNS mà chúng ta có trong vùng hiện tại của mình.

aws sns list-topics

Để tạo một chủ đề SNS, hãy thực hiện lệnh sau. Bạn có thể chỉ định bất kỳ tên nào khác nếu muốn.

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

Trong khi tạo Chủ đề SNS, chúng ta cũng có thể chỉ định thẻ cho chủ đề đó. Bạn thậm chí có thể chỉ định nhiều thẻ cùng một lúc.

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

Liệt kê các chủ đề và bạn có thể xem các chủ đề mới được tạo lần này.

aws sns list-topics

Bạn cũng có thể kiểm tra các thuộc tính của một chủ đề SNS cụ thể bằng cách chỉ định arn của chủ đề đó. Để lấy arn của chủ đề, trước tiên hãy liệt kê các chủ đề rồi sao chép arn của chủ đề mong muốn.

aws sns list-topics

aws sns get-topic-attributes --topic-arn arn:aws:sns:us-east-1::my-sns-topic-by-cli

Bạn có thể kiểm tra tất cả các đăng ký trong vùng hiện tại bằng lệnh sau.

aws sns list-subscriptions

Để tạo Đăng ký, bạn cần chỉ định giao thức và arn của Chủ đề SNS. Trong trường hợp này, chúng tôi sẽ tạo Đăng ký với Email làm điểm cuối. Có nhiều điểm cuối khác nhau được hỗ trợ bởi đăng ký, bạn có thể chỉ định điểm cuối mong muốn.

aws sns subscribe --topic-arn arn:aws:sns:us-east-1::my-sns-topic-by-cli --protocol email --notification-endpoint @

aws sns list-subscriptions

Sau khi Đăng ký được tạo, bạn sẽ nhận được email xác nhận. Đăng ký có thể được xác nhận bằng cách nhấp vào liên kết được chỉ định trong email hoặc có thể sử dụng mã thông báo để xác nhận từ CLI. Sao chép địa chỉ liên kết để lấy mã thông báo từ đó, chúng ta sẽ thấy lệnh xác nhận đăng ký từ thiết bị đầu cuối.



Địa chỉ liên kết xác nhận sẽ chứa mã thông báo được tô sáng bên dưới. Sao chép mã thông báo đó để xác nhận từ CLI.



Để xác nhận Đăng ký bằng aws-cli, hãy sử dụng lệnh sau và chỉ định topic-arn và mã thông báo trong lệnh.

aws sns list-subscriptions

aws sns confirm-subscription --topic-arn arn:aws:sns:us-east-1::my-sns-topic-by-cli --token 2336412f37fb687f5d51e6e2425e90ccf51427f70d347f743e373ed99c34222d699f93426571175db9bc0b81296ae69f53a889e1fbd11571c642308353d4648c67a2851b17a7f3cc1b7e1aaccae0881c5855df5d37bcae458305855d98fcd012d1ed4728a2064c6425b77b00e62b8d4fcf7fcccfb212d6850e3fa450c25cdf9a

aws sns list-subscriptions

Đăng ký có thể bị xóa hoặc hủy đăng ký chỉ bằng cách chỉ định arn đăng ký. Sau khi Điểm cuối bị hủy đăng ký, thông báo sẽ không còn đến được điểm cuối nữa.

aws sns list-subscriptions

aws sns unsubscribe --subscription-arn arn:aws:sns:us-east-1::my-sns-topic-by-cli:cde0b12a-437c-49da-ab25-bc467701156d

aws sns list-subscriptions

Khi bạn không còn cần chủ đề nữa, tốt hơn hết là xóa chủ đề đó. Hãy cẩn thận khi xóa chủ đề vì một khi đã xóa thì không thể khôi phục lại được.

aws sns list-topics

aws sns delete-topic --topic-arn arn:aws:sns:us-east-1::my-sns-topic-by-cli

614aws sns list-topics

Kết luận​

Trong bài viết này, chúng ta đã thấy các bước để tạo Chủ đề SNS, Đăng ký, xác nhận Đăng ký. Chúng ta cũng đã thấy cách xóa Đăng ký và chủ đề SNS bằng lệnh aws-cli.