

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

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

 AWS CLI 提供的命令可讓您用來管理指派給許可集的標籤。

## 指派標籤
<a name="tagging-cli-examples-assigning"></a>

使用下列命令將標籤指派給您的許可集。

**Example `tag-resource` 許可集的命令**  
在一組命令[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)中使用 ，將標籤指派給許可`sso`集：  

```
$ aws sso-admin tag-resource \
> --instance-arn sso-instance-arn \
> --resource-arn sso-resource-arn \
> --tags Stage=Test
```
此命令包括下列參數：  
+ `instance-arn` – 執行操作的 IAM Identity Center 執行個體的 Amazon Resource Name (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
```