使用標記 - Amazon Kinesis Data Analytics for SQL Applications 開發人員指南
建立應用程式時新增標籤為現有應用程式新增或更新標籤列出應用程式的標籤從應用程式移除標籤

在仔細考慮之後，我們決定在兩個步驟中停止 Amazon Kinesis Data Analytics for SQL 應用程式：

1. 從 2025 年 10 月 15 日起，您將無法為SQL應用程式建立新的 Kinesis Data Analytics。

2. 我們將從 2026 年 1 月 27 日起刪除您的應用程式。您將無法啟動或操作SQL應用程式的 Amazon Kinesis Data Analytics。從那時SQL起，Amazon Kinesis Data Analytics 將不再提供 的支援。如需詳細資訊，請參閱Amazon Kinesis Data Analytics for SQL 應用程式終止。

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

使用標記

本節說明如何將索引鍵值中繼資料標籤新增至 Kinesis Data Analytics 應用程式。這些標籤可用於下列目的：

  • 決定個別 Kinesis Data Analytics 應用程式的計費。如需詳細資訊，請參閱《AWS 帳單和成本管理使用者指南》中的使用成本分配標籤。

  • 根據標籤控制對應用程式資源的存取。如需詳細資訊，請參閱《使用者指南》中的使用標籤控制存取權。

  • 使用者定義的目的。您可以根據使用者標籤的存在來定義應用程式的功能。

注意有關標記的以下資訊：

  • 應用程式標籤的數目上限包括系統標籤。使用者定義的應用程式的標籤數目上限為 50。

  • 如果動作包含具有重複 Key 值的標籤清單，則服務會擲出 InvalidArgumentException。

建立應用程式時新增標籤

您可以在使用 CreateApplication 動作的 tags 參數建立應用程式時新增標籤。

以下範例請求顯示 CreateApplication 請求的 Tags 節點：

"Tags": [ 
    { 
        "Key": "Key1",
        "Value": "Value1"
    },
    { 
        "Key": "Key2",
        "Value": "Value2"
    }
]

為現有應用程式新增或更新標籤

您可以使用 TagResource 動作將標籤新增至應用程式。您無法使用 UpdateApplication 動作為應用程式新增標籤。

若要更新現有的標籤，請使用與現有標籤相同的索引鍵新增標籤。

TagResource 動作的下列請求範例會新增標籤或更新現有標籤：

{
   "ResourceARN": "string",
   "Tags": [ 
      { 
         "Key": "NewTagKey",
         "Value": "NewTagValue"
      },
      { 
         "Key": "ExistingKeyOfTagToUpdate",
         "Value": "NewValueForExistingTag"
      }
   ]
}

列出應用程式的標籤

若要列出現有標籤，請使用 ListTagsForResource 動作。

ListTagsForResource 動作的下列請求範例可列出應用程式的標籤：

{
   "ResourceARN": "arn:aws:kinesisanalytics:us-west-2:012345678901:application/MyApplication"
}

從應用程式移除標籤

若要從應用程式移除標籤，請使用 UntagResource 動作。

UntagResource 動作的下列請求範例可移除應用程式的標籤：

{
   "ResourceARN": "arn:aws:kinesisanalytics:us-west-2:012345678901:application/MyApplication",
   "TagKeys": [ "KeyOfFirstTagToRemove", "KeyOfSecondTagToRemove" ]
}