本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
使用 Amazon 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 资源名称(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"
}
}