使用 Amazon WorkSpaces 應用程式 API、 AWS SDK 或 AWS CLI 來處理標籤 - Amazon WorkSpaces 應用程式

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

使用 Amazon WorkSpaces 應用程式 API、 AWS SDK 或 AWS CLI 來處理標籤

如果您使用 WorkSpaces 應用程式 API、 AWS 開發套件或 AWS 命令列界面 (AWS CLI)，您可以在建立新資源時使用下列 WorkSpaces 應用程式操作搭配 tags 參數來新增標籤。

注意

您可以在標籤鍵和值內使用空格。若要在使用 CLI AWS 時指出空格，請使用 "\s" （不含引號）。

任務 AWS CLI API 作業
為新的機群新增一或多個標籤 create-fleet

CreateFleet
為新的映像建置器新增一或多個標籤 create-imagebuilder

CreateImageBuilder
為新的堆疊新增一或多個標籤

create-stack

CreateStack

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

任務 AWS CLI API 作業
新增或覆寫資源的一或多個標籤 tag-resource

TagResource
移除資源的一或多個標籤 untag-resource

UntagResource
列出資源的一或多個標籤

list-tags-for-resource

ListTagsForResource

當您使用 WorkSpaces 應用程式 API、 AWS 開發套件或 AWS CLI 動作來新增、編輯、移除或列出現有 WorkSpaces 應用程式資源的標籤時，請使用其 Amazon Resource Name (ARN) 來指定資源。ARN 可唯一識別 AWS 資源，並使用下列一般語法。

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

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

account

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

resourceType

資源的類型。您可以標記下列 WorkSpaces 應用程式資源類型：image-builder、fleet、 image和 stack。

resourceName

資源的名稱。

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