AWS IoT Analytics 不再提供給新客戶。的現有客戶 AWS IoT Analytics 可以繼續正常使用服務。進一步了解
本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
標記您的 AWS IoT Analytics 資源
為協助您管理您的頻道、資料集、資料存放區及管道,您可以選擇性將您自己的中繼資料,以標籤的形式指派給這些資源。本章說明標籤並示範如何建立此類標籤。
標籤基本概念
標籤可讓您以不同的方式分類您的 AWS IoT Analytics 資源,例如依據目的、擁有者或環境。當您有許多相同類型的資源時,這將會很有用,因為您可以依據先前指派的標籤,快速識別特定的資源。每個標籤皆包含由您定義的一個「索引鍵」與選擇性的「值」。例如,您可以為您的頻道定義一組標籤,協助您追蹤負責每個頻道訊息來源的裝置類型。我們建議您為每種資源類型建立符合您需求的標籤金鑰。使用一致的標籤金鑰組可讓您更輕鬆的管理您的資源。您可以根據您新增的標籤搜尋和篩選資源。
您也可以使用標籤來分類和追蹤您的成本。當您將標籤套用至通道、資料集、資料存放區或管道,AWS會以逗號分隔值 (CSV) 檔案格式產生一份成本分配報告,其中包含依標籤彙總的用量與成本。您可以套用代表業務類別 (例如成本中心、應用程式名稱或擁有者) 的標籤,來整理多個服務中的成本。如需有關使用成本分配的詳細資訊,請參閱使用AWS Billing者指南中的使用成本分配標籤。
為了易用性,請使用AWS Billing and Cost Management主控台中的標籤編輯器,此編輯器可讓您集中、整合地建立和管理標籤。如需詳細資訊,請參閱入門中的使用標籤編輯器AWS Management Console。
您還可使用 AWS CLI 和 AWS IoT Analytics API 來使用標籤。當您建立標籤時,可在下列命令中使用標籤欄位,將標籤關聯至頻道、資料集、資料存放區及管道:
您可以新增、修改或刪除支援標籤的現有資源。使用下列命令:
您可以編輯標籤金鑰和值,並且可以隨時從資源移除標籤。您可以將標籤的值設為空白字串,但您無法將標籤的值設為 Null。若您將與現有標籤具有相同值的標籤新增到該資源,則新值會覆寫舊值。如果您刪除資源,也會刪除與該資源相關聯的任何標籤。
搭配 IAM 政策使用標籤
您可以使用 Condition
元素 (也稱為 Condition
區塊),與 IAM 政策中的以下條件內容金鑰/值搭配,來根據資源標籤控制使用者存取 (許可):
-
使用
iotanalytics:ResourceTag/<tag-key>: <tag-value>
yo 允許或拒絕具有特定標籤的資源上的使用者動作。 -
使用
aws:RequestTag/<tag-key>: <tag-value>
以在提出 API 請求時,要求使用 (或不使用) 特定標籤,以建立或修改允許標籤的資源。 -
使用
aws:TagKeys: [<tag-key>, ...]
以在提出 API 請求時,要求使用 (或不使用) 特定標籤金鑰集,以建立或修改允許標籤的資源。注意
IAM 策略中的條件內容鍵/值僅適用於那些AWS IoT Analytics動作,其中能夠標記的資源的識別碼是必要參數。例如,根據條件內容金鑰/值,不允許/拒絕使用,因為在此請求中所參照的項目沒有可標記資源 (通道、資料集、資料存放區或管道)。DescribeLoggingOptions
如需詳細資訊,請參閱《IAM 使用者指南》中的使用標籤控制存取權限。該指南的 IAM JSON 政策參照部分具有 IAM 中 JSON 政策的詳細語法、描述和範例。
以下範例政策會套用兩個限制。受此政策限制的使用者:
-
無法提供資源「env=prod」標籤 (請參閱範例
"aws:RequestTag/env" : "prod"
中的行)。 -
無法修改或存取具有現有標籤「env=prod」的資源 (請參閱範例
"iotanalytics:ResourceTag/env" : "prod"
中的行)。
{ "Version" : "2012-10-17", "Statement" : [ { "Effect" : "Deny", "Action" : "iotanalytics:*", "Resource" : "*", "Condition" : { "StringEquals" : { "aws:RequestTag/env" : "prod" } } }, { "Effect" : "Deny", "Action" : "iotanalytics:*", "Resource" : "*", "Condition" : { "StringEquals" : { "iotanalytics:ResourceTag/env" : "prod" } } }, { "Effect": "Allow", "Action": [ "iotanalytics:*" ], "Resource": "*" } ] }
您也可以將多個標籤值封閉在清單中,以便為指定的標籤鍵指定多個標籤值,如下列範例所示。
"StringEquals" : { "iotanalytics:ResourceTag/env" : ["dev", "test"] }
注意
如果您允許/拒絕使用者根據標籤存取資源,請務必考慮明確拒絕使用者將這些標籤新增至相同資源或從中移除的能力。否則,使用者可能透過修改標籤來避開您的限制,並取得資源的存取。
標籤限制
以下基本限制適用於標籤:
-
每個資源的標籤數上限:50
-
金鑰長度上限:127 個 UTF-8 Unicode 字元
-
值長度上限:255 個 UTF-8 Unicode 字元
-
標籤金鑰與值皆區分大小寫。
-
標籤名稱或值不可使用,因為它只保留給AWS使用。
aws: prefix
您不可編輯或刪除具此字首的標籤名稱或值。具此字首的標籤,不算在受來源限制的標籤計數內。 -
如果您的標記結構描述是跨多項服務和資源使用,請記得其他服務可能會有字元使用限制。通常,允許使用的字元為:可用 UTF-8 表示的英文字母、空格和數字,加上以下特殊字元:+ - = . _ : / @。