配置 Amazon SNS 主題標籤 - Amazon Simple Notification Service
使用列出，添加和刪除 Amazon SNS 主題的標籤 AWS Management Console使用新增標籤至主題 AWS SDK使用 Amazon SNS API 動作管理標籤API支援的動作 ABAC

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

配置 Amazon SNS 主題標籤

本頁顯示如何使用 AWS Management Console AWS SDK、和設 AWS CLI定 Amazon SNS 主題的標籤。

重要

不要在標籤中添加個人身份信息（PII）或其他機密或敏感信息。其他 Amazon Web Services 可以存取標籤，包括帳單。標籤不適用於私人或敏感資料。

使用列出，添加和刪除 Amazon SNS 主題的標籤 AWS Management Console

  1. 登錄到 Amazon 控SNS制台。

  2. 在導覽面板上，選擇 Topics (主題)。

  3. 在 Topics (主題) 頁面上，選擇主題，然後選擇 Delete (刪除)。

  4. 展開 Tags (標籤) 區段。

    隨即列出已新增到主題的標籤。

  5. 修改主題標籤：

    • 若要新增標籤，請選擇 Add tag (新增標籤)，然後輸入 Key (索引鍵) 和 Value (值) (選用)。

    • 若要移除標籤，請選擇鍵/值對旁邊的 Remove tag (移除標籤)。

  6. 選擇儲存變更。

使用新增標籤至主題 AWS SDK

若要使用 AWS SDK，您必須使用您的認證進行設定。如需詳細資訊，請參閱《工具參考指南》中的共用設定AWS SDKs和認證檔案。

下列程式碼範例會示範如何使用TagResource。

CLI
AWS CLI

將標籤新增至主題

下列tag-resource範例會將中繼資料標籤新增至指定的 Amazon SNS 主題。

aws sns tag-resource \
    --resource-arn arn:aws:sns:us-west-2:123456789012:MyTopic \
    --tags Key=Team,Value=Alpha

此命令不會產生輸出。

  • 如需詳API細資訊，請參閱AWS CLI 指令參考TagResource中的。

Java
SDK對於爪哇 2.x
注意

還有更多關於 GitHub。尋找完整範例，並了解如何在AWS 設定和執行程式碼範例儲存庫。

import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.sns.SnsClient;
import software.amazon.awssdk.services.sns.model.SnsException;
import software.amazon.awssdk.services.sns.model.Tag;
import software.amazon.awssdk.services.sns.model.TagResourceRequest;
import java.util.ArrayList;
import java.util.List;

/**
 * Before running this Java V2 code example, set up your development
 * environment, including your credentials.
 *
 * For more information, see the following documentation topic:
 *
 * https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/get-started.html
 */
public class AddTags {
    public static void main(String[] args) {
        final String usage = """

                Usage:    <topicArn>

                Where:
                   topicArn - The ARN of the topic to which tags are added.

                """;

        if (args.length != 1) {
            System.out.println(usage);
            System.exit(1);
        }

        String topicArn = args[0];
        SnsClient snsClient = SnsClient.builder()
                .region(Region.US_EAST_1)
                .build();

        addTopicTags(snsClient, topicArn);
        snsClient.close();
    }

    public static void addTopicTags(SnsClient snsClient, String topicArn) {
        try {
            Tag tag = Tag.builder()
                    .key("Team")
                    .value("Development")
                    .build();

            Tag tag2 = Tag.builder()
                    .key("Environment")
                    .value("Gamma")
                    .build();

            List<Tag> tagList = new ArrayList<>();
            tagList.add(tag);
            tagList.add(tag2);

            TagResourceRequest tagResourceRequest = TagResourceRequest.builder()
                    .resourceArn(topicArn)
                    .tags(tagList)
                    .build();

            snsClient.tagResource(tagResourceRequest);
            System.out.println("Tags have been added to " + topicArn);

        } catch (SnsException e) {
            System.err.println(e.awsErrorDetails().errorMessage());
            System.exit(1);
        }
    }
}

  • 如需詳API細資訊，請參閱AWS SDK for Java 2.x API參考TagResource中的。

Kotlin
SDK對於科特林
注意

還有更多關於 GitHub。尋找完整範例，並了解如何在AWS 設定和執行程式碼範例儲存庫。

suspend fun addTopicTags(topicArn: String) {
    val tag =
        Tag {
            key = "Team"
            value = "Development"
        }

    val tag2 =
        Tag {
            key = "Environment"
            value = "Gamma"
        }

    val tagList = mutableListOf<Tag>()
    tagList.add(tag)
    tagList.add(tag2)

    val request =
        TagResourceRequest {
            resourceArn = topicArn
            tags = tagList
        }

    SnsClient { region = "us-east-1" }.use { snsClient ->
        snsClient.tagResource(request)
        println("Tags have been added to $topicArn")
    }
}

  • 有API關詳細資訊，請參閱TagResource中AWS SDK的以取得 Kotlin API 的參考資料

使用 Amazon SNS API 動作管理標籤

若要使用 Amazon 管理標籤 SNSAPI，請使用下列API動作：

API支援的動作 ABAC

以下是支援以屬性為基礎的存取控制 () ABAC 的API動作清單。有關更多詳細信息ABAC，請參閱有什麼ABAC用途 AWS？ 在《IAM使用者指南》中。