

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

# AWS CLI 例子
<a name="tagging-cli-examples"></a>

 AWS CLI 提供了可用于管理分配给权限集的标签的命令。

## 分配标签
<a name="tagging-cli-examples-assigning"></a>

使用以下命令将标签分配给您的权限集。

**Example `tag-resource` 权限集命令**  
使用 `sso` 命令集中的 [https://docs.aws.amazon.com/cli/latest/reference/sso-admin/tag-resource.html](https://docs.aws.amazon.com/cli/latest/reference/sso-admin/tag-resource.html) 将标签分配给权限集：  

```
$ aws sso-admin tag-resource \
> --instance-arn sso-instance-arn \
> --resource-arn sso-resource-arn \
> --tags Stage=Test
```
此命令包含以下参数：  
+ `instance-arn`——将在其下运行操作的 IAM Identity Center 实例的 Amazon 资源名称 (ARN)。
+ `resource-arn`——具有要列出的标签的资源的 ARN。
+ `tags` – 标签的键值对。
要一次分配多个标签，请以逗号分隔的列表形式指定它们：  

```
$ aws sso-admin tag-resource \
> --instance-arn sso-instance-arn \
> --resource-arn sso-resource-arn \
> --tags Stage=Test,CostCenter=80432,Owner=SysEng
```

## 查看标签
<a name="tagging-cli-examples-viewing"></a>

使用以下命令查看您已分配给权限集的标签。

**Example `list-tags-for-resource` 权限集命令**  
使用 `sso` 命令集中的 [https://docs.aws.amazon.com/cli/latest/reference/sso-admin/list-tags-for-resource.html](https://docs.aws.amazon.com/cli/latest/reference/sso-admin/list-tags-for-resource.html) 查看分配给权限集的标签：  

```
$ aws sso-admin list-tags-for-resource --resource-arn sso-resource-arn
```

## 移除标签
<a name="tagging-cli-examples-removing"></a>

使用以下命令从权限集中删除标签。

**Example `untag-resource` 权限集命令**  
通过在 `sso` 命令集中使用 [https://docs.aws.amazon.com/cli/latest/reference/sso-admin/untag-resource.html](https://docs.aws.amazon.com/cli/latest/reference/sso-admin/untag-resource.html) 从权限集中删除标签：  

```
$ aws sso-admin untag-resource \
> --instance-arn sso-instance-arn \
> --resource-arn sso-resource-arn \
> --tag-keys Stage CostCenter Owner
```
对于 `--tag-keys` 参数，指定一个或多个标签键，但不包含标签值。

## 创建权限集时应用标签
<a name="tagging-cli-examples-applying"></a>

在创建权限集时使用以下命令分配标签。

**Example `create-permission-set` 命令以及标签**  
使用 [https://docs.aws.amazon.com/cli/latest/reference/sso-admin/create-permission-set.html](https://docs.aws.amazon.com/cli/latest/reference/sso-admin/create-permission-set.html) 命令创建权限集时，可以通过 `--tags` 参数指定标签：  

```
$ aws sso-admin create-permission-set \
> --instance-arn sso-instance-arn \
> --name permission=set-name \
> --tags Stage=Test,CostCenter=80432,Owner=SysEng
```