本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 使用亚马逊 WorkSpaces 应用程序 API、 AWS 软件开发工具包或 AWS CLI 处理标签
<a name="basic-tagging-API-SDK-CLI"></a>

如果您使用的是 WorkSpaces 应用程序 API、S AWS DK 或 AWS 命令行界面 (AWS CLI)，则可以在创建新资源时使用以下带有`tags`参数的 WorkSpaces 应用程序操作来添加标签。

**注意**  
您可以在标签键和值中使用空格。要在使用 AWS CLI 时表示空格，请使用 “\$1 s”（不带引号）。


| Task | AWS CLI | API 操作 | 
| --- | --- | --- | 
| 添加新实例集的一个或多个标签 | [create-fleet](https://docs.aws.amazon.com/cli/latest/reference/appstream/create-fleet.html)  |  [CreateFleet](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_CreateFleet.html#AppStream2-CreateFleet-request-Tags)  | 
| 添加新映像生成器的一个或多个标签 | [create-imagebuilder](https://docs.aws.amazon.com/cli/latest/reference/appstream/create-imagebuilder.html) |  [CreateImageBuilder](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_CreateImageBuilder.html#AppStream2-CreateImageBuilder-request-Tags)  | 
| 添加新堆栈的一个或多个标签 |  [create-stack](https://docs.aws.amazon.com/cli/latest/reference/appstream/create-stack.html)  |  [CreateStack](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_CreateStack.html#AppStream2-CreateStack-request-Tags)  | 

您可以使用以下 WorkSpaces 应用程序操作为现有资源添加、编辑、移除或列出标签：


| Task | AWS CLI | API 操作 | 
| --- | --- | --- | 
| 添加或覆盖资源的一个或多个标签 | [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/appstream/tag-resource.html)  |  [TagResource](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_TagResource.html)  | 
| 删除资源的一个或多个标签 | [untag-resource](https://docs.aws.amazon.com/cli/latest/reference/appstream/untag-resource.html) |  [UntagResource](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_UntagResource.html)  | 
| 列出资源的一个或多个标签 |  [list-tags-for-resource](https://docs.aws.amazon.com/cli/latest/reference/appstream/list-tags-for-resource.html)  |  [ListTagsForResource](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_ListTagsForResource.html)  | 

当您使用 WorkSpaces 应用程序 API、 AWS 软件开发工具包或 AWS CLI 操作为现有 WorkSpaces 应用程序资源添加、编辑、移除或列出标签时，请使用其亚马逊资源名称 (ARN) 指定该资源。ARN 唯一标识 AWS 资源并使用以下通用语法。

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

***region***  
创建资源的 AWS 区域（例如，`us-east-1`）。

***account***  
不带连字符的 AWS 账户 ID（例如，`123456789012`）。

***resourceType***  
资源的类型。您可以标记以下 WorkSpaces 应用程序资源类型：`image-builder`、`image``fleet`、和`stack`。

***resourceName***  
资源的名称。

例如，您可以使用 CLI d [es](https://docs.aws.amazon.com/cli/latest/reference/appstream/describe-fleets.html) cribe-fleets AWS 命令获取 WorkSpaces 应用程序队列的 ARN。复制以下 命令。

```
aws appstream describe-fleets
```

对于包含名为 `TestFleet` 的单个实例集的环境，此资源的 ARN 将以 JSON 输出格式显示，类似于下文。

```
"Arn": "arn:aws:appstream:us-east-1:123456789012:fleet/TestFleet"
```

在获取此资源的 ARN 之后，您可以使用 [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/appstream/tag-resource.html) 命令添加两个标签：

```
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"
    }
}
```