標記 Amazon AppStream 2.0 資源

AWS 可讓您以標籤形式將中繼資料指派至您的 AWS 資源。使用這些標籤有助於管理您的 AppStream 2.0 映像建置器、映像、機群和堆疊，以及整理資料，包括帳單資料。

您可以：

• 依照邏輯以不同方式為資源建立群組 (例如根據用途、擁有者或環境)。

  這在您擁有許多相同類型的資源時很有用。

• 根據您指派給資源的標籤來快速識別特定資源。

• 識別和控制 AWS 成本

例如，您可以識別和為處於不同環境 (例如開發或生產) 中的 AppStream 2.0 機群建立群組，或是根據指派給不同業務單位 (例如 HR 或行銷) 的機群建立群組。然後就可以詳細追蹤與這些機群相關聯的 AWS 成本。若要這樣做，請註冊以便取得包含標籤索引鍵值的 Amazon Web Services 帳戶帳單。如需有關使用標籤設定成本分配報告的詳細資訊，請參閱《AWS Billing 使用者指南》中的每月成本分配報告。

標記基本概念

標籤是由一個鍵/值對組成，與其他 AWS 服務標籤相似。若要標記一項資源，您可以為每個標籤指定「鍵」和「值」。鍵可以是一般性的類別，例如「專案」、「擁有者」或「環境」，並帶有特定的關聯值。您可以在多個資源間共享相同的鍵與值。您可以在建立 AppStream 2.0 資源後立即標記該資源，或是稍後再標記。若您刪除一項資源，標籤也會在刪除的同時從該資源上移除。但是，其他擁有相同標籤索引鍵的 AppStream 2.0 和 AWS 資源則不受影響。

您可以編輯標籤金鑰和值，並且可以隨時從資源移除標籤。您可以將標籤的值設為空白字串，但您無法將標籤的名稱設為 null。若您將與現有標籤具有相同鍵的標籤新增到該資源，則新值會覆寫舊值。如果您刪除資源，也會刪除任何該資源的標籤。

注意

若您計劃設定每月成本分配報告來追蹤 AppStream 2.0 資源的 AWS 成本，務必記住，新增至現有 AppStream 2.0 資源的標籤會在當月份續訂資源於下個月續訂時，出現在成本分配報告中。

標籤限制

• 每個 AppStream 2.0 資源的標籤數上限為 50。

• 鍵的長度上限為 128 個 Unicode 字元 (UTF-8)。

• 值的長度上限則為 256 個 Unicode 字元 (UTF-8)。

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

• 請勿在您的標籤名稱或值中使用「aws:」字首，因為這是保留給 AWS 使用的系統標籤。您無法編輯或刪除具備此前綴的標籤名稱或值。具此字首的標籤，不算在受資源限制的標籤計數內。

• 通常，允許使用的字元為：可用 UTF-8 表示的英文字母、數字和空格，以及以下特殊字元：+ - = . _ : / @。

• 雖然您可以在多個資源間共享相同的鍵和值，您無法在相同的資源上擁有重複的鍵。

• 您可以在資源建立期間為資源加上標籤。您也可以為已建立的資源新增、編輯和刪除標籤。

在 AppStream 2.0 主控台中建立資源期間新增標籤

當您在 AppStream 2.0 主控台建立資源時，可以新增一或多個標籤來管理資源。如需詳細資訊，請參閱下列主題：

• 映像建置器：啟動映像建置器以安裝和設定串流應用程式，步驟 4

• 映像：步驟 6：完成建立您的映像，步驟 1

• 機群：建立機群，步驟 3

• 堆疊：建立堆疊，步驟 2

在 AppStream 2.0 主控台新增、編輯和刪除現有資源的標籤

您可以使用 AppStream 2.0 主控台新增、編輯和刪除現有資源的標籤。

新增、編輯或刪除現有 AppStream 2.0 資源的標籤

1. 開啟 AppStream 2.0 主控台，位於 https://console.aws.amazon.com/appstream2。

2. 從導覽列中選取區域，其中包含您要新增、編輯或刪除標籤的資源。

3. 在導覽窗格中，選取資源類型。資源類型可以是映像建置器、映像、機群或堆疊。

4. 從資源清單選取資源。

5. 選擇 Tags (標籤)、Add/Edit Tags (新增/編輯標籤)，然後執行一項或多項下列動作：

   • 若要新增標籤，請選擇新增標籤，然後輸入每個標籤的索引鍵和值。

   • 若要編輯標籤，請視需要修改標籤的鍵和值。

   • 若要刪除標籤，請選擇標籤的刪除圖示 (X)。

6. 選擇 Save (儲存)。

透過 AppStream 2.0 API、AWS SDK 或 AWS CLI 使用標籤

如果您使用的是 AppStream 2.0 API、AWS SDK 或 AWS 命令列介面 (AWS CLI)，則可以在建立新資源時，使用以下 AppStream 2.0 操作搭配 tags 參數來新增標籤。

注意

您可以在標籤鍵和值內使用空格。若要在使用 AWS CLI 時指出空格，請使用「\s」(不含括號)。

任務	AWS CLI	API 操作
為新的機群新增一或多個標籤	create-fleet	CreateFleet
為新的映像建置器新增一或多個標籤	create-imagebuilder	CreateImageBuilder
為新的堆疊新增一或多個標籤	create-stack	CreateStack

您可以使用以下 AppStream 2.0 操作來新增、編輯、移除或列出現有資源的標籤：

任務	AWS CLI	API 操作
新增或覆寫資源的一或多個標籤	tag-resource	TagResource
移除資源的一或多個標籤	untag-resource	UntagResource
列出資源的一或多個標籤	list-tags-for-resource	ListTagsForResource

當您使用 AppStream 2.0 API、AWS SDK 或 AWS CLI 動作來新增、編輯、移除或列出現有 AppStream 2.0 資源的標籤時，請使用其 Amazon Resource Name (ARN) 來指定資源。ARN 可唯一識別 AWS 資源，並且使用以下的一般語法。

arn:aws:appstream:region:account:resourceType/resourceName

region

建立資源所在的 AWS 區域 (例如 us-east-1)。

account

AWS 帳戶 ID，不含連字號 (例如，123456789012)。

resourceType

資源的類型。您可以標記下列 AppStream 2.0 資源類型：image-builder、image、fleet 和 stack。

resourceName

資源的名稱。

例如，您可以使用 AWS CLI describe-fleets 命令來取得 AppStream 2.0 機群的 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"
    }
}