本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
標記 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 資源的標籤
開啟 AppStream 2.0 主控台,位於 https://console.aws.amazon.com/appstream2
。 -
從導覽列中選取區域,其中包含您要新增、編輯或刪除標籤的資源。
-
在導覽窗格中,選取資源類型。資源類型可以是映像建置器、映像、機群或堆疊。
-
從資源清單選取資源。
選擇 Tags (標籤)、Add/Edit Tags (新增/編輯標籤),然後執行一項或多項下列動作:
若要新增標籤,請選擇新增標籤,然後輸入每個標籤的索引鍵和值。
若要編輯標籤,請視需要修改標籤的鍵和值。
若要刪除標籤,請選擇標籤的刪除圖示 (X)。
選擇 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 | |
為新的映像建置器新增一或多個標籤 | create-imagebuilder | |
為新的堆疊新增一或多個標籤 |
您可以使用以下 AppStream 2.0 操作來新增、編輯、移除或列出現有資源的標籤:
任務 | AWS CLI | API 操作 |
---|---|---|
新增或覆寫資源的一或多個標籤 | tag-resource | |
移除資源的一或多個標籤 | untag-resource | |
列出資源的一或多個標籤 |
當您使用 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"
}
}