Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/)

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

# 標記 Amazon Forecast 資源
<a name="tagging-forecast-resources"></a>

*標籤*是您選擇性定義並與 AWS 資源建立關聯的標籤，包括特定類型的 Amazon Forecast 資源。標籤可協助您以不同方式分類和管理資源，例如透過用途、擁有者、環境或其他條件。例如，您可以使用標籤來套用政策或自動化，或識別受制於特定合規要求的資源。您可以將標籤新增至下列類型的預測資源：
+ 資料集群組
+ 資料集
+ 資料集匯入任務
+ 預測器
+ 預測器匯出任務
+ 預測
+ 預測匯出任務
+ 假設分析
+ 假設預測
+ 假設預測匯出任務

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

## 管理標籤
<a name="forecast-managing-tags"></a>

每個標籤皆包含由您定義的必要「標籤金鑰」與選用「標籤值」。標籤金鑰是一般標籤，做為更特定標籤值的類別。標籤值是標籤金鑰的描述項。例如，如果您有兩個版本的預測資料集匯入任務 （一個用於內部測試，另一個用於生產），您可以將`Environment`標籤金鑰指派給兩個專案。`Environment` 標籤索引鍵的值可能`Test`適用於某個版本的資料集匯入任務，也可能`Production`適用於另一個版本。

標籤金鑰最多可包含 128 個字元。標籤值最多可包含 256 個字元。這些字元可以是 Unicode 字母、數字、空格或以下其中一個符號：\$1、:、/、=、\$1、-。以下額外限制適用於標籤：
+ 標籤鍵與值皆區分大小寫。
+ 對於每個相關聯的資源，每個標籤金鑰必須是唯一的，而且只能有一個值。
+ 請勿使用 `aws:`、 `AWS:`或任何大寫或小寫的 組合，例如金鑰的字首，因為其保留供 AWS 使用。您無法編輯或刪除具有此字首的標籤索引鍵。值可以有此字首。如果標籤值有 `aws`做為其字首，但金鑰沒有，則預測會將其視為使用者標籤，並計入 50 個標籤的限制。只有 金鑰字首的標籤`aws`不會計入每個資源限制的標籤。
+ 您無法更新或刪除僅以其標籤為基礎的資源。您也須指定 Amazon Resource Name (ARN) 或資源 ID，取決於您使用的操作。
+ 您可以將標籤與公有或共用資源建立關聯。不過，這些標籤僅適用於您的 AWS 帳戶，不適用於共用資源的任何其他帳戶。此外，這些標籤僅適用於位於 AWS 區域 中為 指定的資源 AWS 帳戶。

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

## 在 IAM 政策中使用標籤
<a name="tags-iam"></a>

開始實作標籤後，您可以將標籤型的資源層級許可，套用至 AWS Identity and Access Management (IAM) 政策和 API 操作。這包括支援在建立資源時將標籤新增至資源的作業。透過以這種方式使用標籤，您可以實作精細控制 中的哪些群組和使用者 AWS 帳戶 具有建立和標記資源的許可，以及哪些群組和使用者具有更普遍地建立、更新和移除標籤的許可。

例如，您可以建立政策，允許使用者完整存取所有預測資源，其中其名稱是資源`Owner`標籤中的值。

------
#### [ JSON ]

****  

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

------

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

------
#### [ JSON ]

****  

```
{
    "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": "*"
        }
    ]
}
```

------

如果您定義標籤型、資源層級許可，則許可會立即生效。這表示您的資源一旦建立就會更安全，而且您可以快速開始強制使用新資源的標籤。您也可以使用資源層級許可，以控制哪些標籤金鑰和值可以與新的和現有的資源相關聯。詳情請參閱 *AWS IAM 使用者指南*中的[使用標籤控制存取權](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html)。

## 將標籤新增至資源
<a name="tags-add"></a>

下列範例示範如何使用 [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/)和 將標籤新增至預測資源 AWS 管理主控台。

------
#### [ AWS CLI ]

若要在使用 建立新的預測資源時新增標籤 AWS CLI，請使用適當的資源`create`命令，並包含 `tags` 參數和值。例如，來自 的下列命令`myDatasetGroup`會為 CUSTOM 網域建立名為 的新資料集群組，並新增下列標籤：具有`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
```

如需可用來建立預測資源之命令的相關資訊，請參閱[預測 AWS CLI 命令參考](https://docs.aws.amazon.com/cli/latest/reference/forecast/)。

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

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

------
#### [ AWS 管理主控台 ]

當您在預測中建立資源時，您可以新增選用的標籤。下列範例會將標籤新增至資料集群組。將標籤新增至其他資源的方式類似。

**將標籤新增至新的資料集群組**

1. 登入 AWS 管理主控台 並開啟位於 https：//[https://console.aws.amazon.com/forecast/](https://console.aws.amazon.com/forecast/) 的 Amazon Forecast 主控台。

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

1. 針對**資料集群組名稱**，輸入名稱。

1.  針對**預測網域**，選擇網域。

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

1. 針對**索引鍵**和**值**，輸入適當的值。

   例如，分別為 **Environment**和 **Test**。

1. 若要新增更多標籤，請選擇**新增標籤**。

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

1. 選擇**下一步**以繼續建立您的資源。

------

## 其他資訊
<a name="tagging-additional-resources-information"></a>

如需標記的詳細資訊，請參閱下列資源。
+ *AWS 一般參考*中的[AWS 標記原則](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html) 
+ [AWS 標記策略 ](https://d1.awsstatic.com/whitepapers/aws-tagging-best-practices.pdf)（可下載的 PDF)
+ *AWS IAM 使用者指南*中的[AWS 存取控制](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) 
+ *AWS Organizations 《 使用者指南*》中的[AWS 標記政策](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_introduction.html)