標記 Amazon Forecast

標籤是您選擇性地定義並與AWS資源 (包括特定類型的 Amazon Forecast 資源) 建立關聯的標籤。標籤可協助您以不同方式分類和管理資源，例如透過用途、擁有者、環境或其他條件。例如，您可以使用標籤來套用政策或自動化，或識別受制於特定合規要求的資源。您可以將標籤新增到以下類型的「Forecast」資源：

• 資料集群組

• 資料集

• 資料集匯入任務

• 預測器

• 預測值匯出任務

• 預測

• Forecast 匯出任務

• 假設分析

• 假設預測

• 假設 Forecast 匯出工作

資源最多可以擁有 50 個標籤。

管理標籤

每個標籤皆包含由您定義的必要「標籤金鑰」與選用「標籤值」。標籤金鑰是一般標籤，做為更特定標籤值的類別。標籤值是標籤金鑰的描述項。例如，如果您有兩個版本的「Forecast」資料集匯入工作 (一個用於內部測試，另一個用於生產環境)，則可以為這兩個專案指派Environment標籤索引鍵。Environment標籤鍵的值可能是Test資料集匯入工作的一個版本和Production另一個版本。

標籤金鑰最多可包含 128 個字元。標籤值最多可包含 256 個字元。字元可以是 Unicode 字母、數字、空格或下列符號之一：_。：/= +-。 以下額外限制適用於標籤：

• 標籤鍵與值皆區分大小寫。

• 對於每個相關聯的資源，每個標籤金鑰必須是唯一的，而且只能有一個值。

• 請不要使用aws:AWS:、或任何這類字元的大寫或小寫組合做為索引鍵的前綴，因為這些是的AWS保留字。您無法編輯或刪除具備此字首的標籤鍵。值可以有這個前綴。如果標籤值aws作為其前綴，但鍵沒有，則 Production Forecast 將其視為使用者標記，並會計入 50 個標籤的限制。只有索引鍵字首的標籤，aws不算在受資源限制的標籤計數內。

• 您無法更新或刪除僅以其標籤為基礎的資源。您也須指定 Amazon Resource Name (ARN) 或資源 ID，取決於您使用的操作。

• 您可以將標籤與公有或共用資源建立關聯。但是，這些標籤僅適用於您的標籤AWS 帳戶，而不適用於共用資源的任何其他帳號。此外，標籤僅適用於位於為您的指AWS 區域定的資源AWS 帳戶。

若要新增、顯示、更新和移除 Forecast 資源中的標籤鍵和值，您可以使用AWS Command Line Interface (AWS CLI)、Forecast API 或AWS SDK。

在 IAM 政策中使用標籤

開始實施標籤後，您可以將以標籤為基礎的資源層級許可套用到AWS Identity and Access Management (IAM) 政策和 API 操作。這包括支援在建立資源時將標籤新增至資源的作業。透過這種方式使用標籤，您可以對您中的哪些群組和使用者AWS 帳戶有權建立和標記資源的權限，以及哪些群組和使用者有權更一般地建立、更新和移除標籤。

例如，您可以建立策略，允許使用者擁有所有 Forecast 資源的完整存取權，其中他們的名稱是資源Owner標籤中的值。

{
   "Version": "2012-10-17",
   "Statement": [
      {
         "Sid": "ModifyResourceIfOwner",
         "Effect": "Allow",
         "Action": "forecast:*",
         "Resource": "*",
         "Condition": {
            "StringEqualsIgnoreCase": {
               "aws:ResourceTag/Owner": "${aws:username}"
            }
         }
      }
   ]
}

下列範例示範如何建立允許建立和刪除資料集的原則。只有在使用者名稱為時，才允許這些操作johndoe。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "forecast:CreateDataset",
                "forecast:DeleteDataset"
            ],
            "Resource": "arn:aws:forecast:*:*:dataset/*",
            "Condition": {
                "StringEquals": {"aws:username" : "johndoe"}
            }
        },
        {
            "Effect": "Allow",
            "Action": "forecast:DescribeDataset",
            "Resource": "*"
        }
    ]
}

如果您定義標籤型、資源層級許可，則許可會立即生效。這表示您的資源一旦建立就會更安全，而且您可以快速開始強制使用新資源的標籤。您也可以使用資源層級許可，以控制哪些標籤金鑰和值可以與新的和現有的資源相關聯。如需詳細資訊，請參閱 AWSIAM 使用者指南中的使用標籤控制存取權限。

將標籤新增至資源

下列範例顯示如何使用AWS CLI和將標籤新增至「Forecast」資源AWS Management Console。

AWS CLI

若要在使用建立新的 Forecast 資源時新增標籤AWS CLI，請對資源使用適當的create指令，並包含tags參數和值。例如，來自的下列命令會建立以 CUSTOM 網域命名myDatasetGroup的新資料集群組，並新增下列Environment標籤：具有標Test籤值的標籤鍵，以及Owner標籤索引鍵和xyzCorp值。

aws forecast create-dataset-group \
--dataset-group-name myDatasetGroup \
--dataset-arns arn:aws:forecast:region:acct-id:dataset/dataset_name \
--domain CUSTOM \
--tags Key=Environment,Value=Test Key=Owner,Value=xyzCorp

如需可用來建立「Forecast」資源之指令的相關資訊，請參閱 Forecast AWS CLI命令參考。

若要將標籤新增至現有資源，請使用指tag-resource令並指定資源的 ARN，並在tags-model參數中提供標籤鍵和值。

aws forecast tag-resource \
--resource-arn resource ARN \
--tags Key=key,Value=value

AWS Management Console

在「Forecast」中建立資源時，您可以新增選用標籤。下列範例會將標籤新增到資料集群組。向其他資源添加標籤遵循類似的模式。

若要將標籤新增到新資料集群組

1. 登入，AWS Management Console並在 https://console.aws.amazon.com/forecast/ 開啟 Amazon Forecast 主控台。

2. 選擇 Create dataset group (建立資料集群組)。

3. 在資料集群組名稱中，輸入名稱。

4. 對於「預測」網域，請選擇網域。

5. 選擇 Add new tag (新增標籤)。

6. 對於「鍵值」和「值」，輸入適當的值。

   例如，分別為 Environment和 Test。

7. 若要新增更多標籤，請選擇 Add new tag.

   您最多可以為資源新增 50 個標籤。

8. 選擇 [下一步] 繼續建立資源。

其他資訊

如需有關標記的詳細資訊，請參閱下列資源。

• AWSAWS一般參考中的標籤原則

• AWS標記策略 (可下載 PDF)

• AWSAWSIAM 使用者指南中的存取控制

• AWSAWS Organizations使用者指南中的標記策略