本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
使用 Amazon AppStream 2.0 API、 AWS SDK 或 AWS CLI 來使用標籤
如果您使用的是 AppStream 2.0 API、 AWS 開發套件或 AWS 命令列界面 (AWS CLI)，您可以在建立新資源時搭配 tags 參數使用下列 AppStream 2.0 操作來新增標籤。
注意
您可以在標籤鍵和值內使用空格。若要在使用 CLI AWS 時指出空格，請使用 "\s" （不含引號）。
| 任務 | AWS CLI | API 作業 |
|---|---|---|
| 為新的機群新增一或多個標籤 | create-fleet | |
| 為新的映像建置器新增一或多個標籤 | create-imagebuilder | |
| 為新的堆疊新增一或多個標籤 |
您可以使用以下 AppStream 2.0 操作來新增、編輯、移除或列出現有資源的標籤：
| 任務 | AWS CLI | API 作業 |
|---|---|---|
| 新增或覆寫資源的一或多個標籤 | tag-resource | |
| 移除資源的一或多個標籤 | untag-resource | |
| 列出資源的一或多個標籤 |
當您使用 AppStream 2.0 API、 AWS 開發套件或 AWS CLI 動作來新增、編輯、移除或列出現有 AppStream 2.0 資源的標籤時，請使用其 Amazon Resource Name (ARN) 來指定資源。ARN 可唯一識別 AWS 資源，並使用下列一般語法。
arn:aws:appstream:region:account:resourceType/resourceNameregion-
建立資源 AWS 的區域 （例如
us-east-1)。 account-
AWS 帳戶 ID，不含連字號 （例如
123456789012)。 resourceType-
資源的類型。您可以標記下列 AppStream 2.0 資源類型：
image-builder、image、fleet和stack。 resourceName-
資源的名稱。
例如，您可以使用 CLI describe-fleets 命令來取得 AppStream 2.0 AWS 機群的 ARN。複製以下命令。
aws appstream describe-fleets
針對包含單一名為 TestFleet 機群的環境，此資源的 ARN 在 JSON 輸出中看起來會如下所示。
"Arn": "arn:aws:appstream:us-east-1:123456789012:fleet/TestFleet"在您取得此資源的 ARN 後，您可以使用 tag-resource 命令來新增兩個標籤：
aws appstream tag-resource --resource arn:awsappstream:us-east-1:123456789012:fleet/TestFleet --tags Environment=Test,Department=IT第一個標籤 (Environment=Test) 指出機群位於測試環境。第二個標籤 (Department=IT) 則指出機群位於 IT 部門。
您可以使用以下命令來列出您新增到機群的兩個標籤。
aws appstream list-tags-for-resource --resource arn:aws:appstream:us-east-1:123456789012:fleet/TestFleet針對此範例，JSON 輸出看起來會如下所示：
{
"Tags": {
"Environment" : "Test",
"Department" : "IT"
}
}