# 使用 Amazon CLI 的资源组标记 API
<a name="cli_resource-groups-tagging-api_code_examples"></a>

以下代码示例演示如何通过将 Amazon Command Line Interface与资源组标记 API 结合使用，来执行操作和实现常见场景。

*操作是大型程序的代码摘录*，必须在上下文中运行。您可以通过操作了解如何调用单个服务函数，还可以通过函数相关场景的上下文查看操作。

每个示例都包含一个指向完整源代码的链接，您可以从中找到有关如何在上下文中设置和运行代码的说明。

**Topics**
+ [操作](#actions)

## 操作
<a name="actions"></a>

### `get-resources`
<a name="resource-groups-tagging-api_GetResources_cli_topic"></a>

以下代码示例演示了如何使用 `get-resources`。

**Amazon CLI**  
**获取已标记资源的列表**  
以下 `get-resources` 示例显示账户中使用指定键名和值标记的资源的列表。  

```
aws resourcegroupstaggingapi get-resources \
    --tag-filters Key=Environment,Values=Production \
    --tags-per-page 100
```
输出：  

```
{
    "ResourceTagMappingList": [
        {
            "ResourceARN": " arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-7sbz2Kz0",
            "Tags": [
                {
                    "Key": "Environment",
                    "Value": "Production"
                }
            ]
        }
    ]
}
```
有关更多信息，请参阅《资源组标记 API Reference》**中的 [GetResources](https://docs.amazonaws.cn/resourcegroupstagging/latest/APIReference/API_GetResources.html)。  
+  有关 API 详细信息，请参阅《Amazon CLI 命令参考》**中的 [GetResources](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resourcegroupstaggingapi/get-resources.html)。

### `get-tag-keys`
<a name="resource-groups-tagging-api_GetTagKeys_cli_topic"></a>

以下代码示例演示了如何使用 `get-tag-keys`。

**Amazon CLI**  
**获取所有标签键的列表**  
以下 `get-tag-keys` 示例检索账户中资源使用的所有标签键名的列表。  

```
aws resourcegroupstaggingapi get-tag-keys
```
输出：  

```
{
    "TagKeys": [
        "Environment",
        "CostCenter",
        "Department"
    ]
}
```
有关更多信息，请参阅《资源组标记 API Reference》**中的 [GetTagKeys](https://docs.amazonaws.cn/resourcegroupstagging/latest/APIReference/API_GetTagKeys.html)。  
+  有关 API 详细信息，请参阅《Amazon CLI 命令参考》**中的 [GetTagKeys](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resourcegroupstaggingapi/get-tag-keys.html)。

### `get-tag-values`
<a name="resource-groups-tagging-api_GetTagValues_cli_topic"></a>

以下代码示例演示了如何使用 `get-tag-values`。

**Amazon CLI**  
**获取所有标签值的列表**  
以下 `get-tag-values` 示例显示了用于账户中所有资源的指定键的所有值  

```
aws resourcegroupstaggingapi get-tag-values \
    --key=Environment
```
输出：  

```
{
    "TagValues": [
        "Alpha",
        "Gamma",
        "Production"
    ]
}
```
有关更多信息，请参阅《资源组标记 API Reference》**中的 [GetTagValues](https://docs.amazonaws.cn/resourcegroupstagging/latest/APIReference/API_GetTagValues.html)。  
+  有关 API 详细信息，请参阅《Amazon CLI 命令参考》**中的 [GetTagValues](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resourcegroupstaggingapi/get-tag-values.html)。

### `tag-resources`
<a name="resource-groups-tagging-api_TagResources_cli_topic"></a>

以下代码示例演示了如何使用 `tag-resources`。

**Amazon CLI**  
**将标签添加到资源中**  
以下 `tag-resources` 示例向指定资源添加带有键名和值的标签。  

```
aws resourcegroupstaggingapi tag-resources \
    --resource-arn-list arn:aws:s3:::MyProductionBucket \
    --tags Environment=Production,CostCenter=1234
```
输出：  

```
{
    "FailedResourcesMap": {}
}
```
有关更多信息，请参阅《资源组标记 API Reference》**中的 [TagResources](https://docs.amazonaws.cn/resourcegroupstagging/latest/APIReference/API_TagResources.html)。  
+  有关 API 详细信息，请参阅《Amazon CLI 命令参考》**中的 [TagResources](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resourcegroupstaggingapi/tag-resources.html)。

### `untag-resources`
<a name="resource-groups-tagging-api_UntagResources_cli_topic"></a>

以下代码示例演示了如何使用 `untag-resources`。

**Amazon CLI**  
**从资源中删除标签**  
以下 `untag-resources` 示例将从指定资源中删除指定的标签键及其关联的值。  

```
aws resourcegroupstaggingapi untag-resources \
    --resource-arn-list arn:aws:s3:::amzn-s3-demo-bucket \
    --tag-keys Environment CostCenter
```
输出：  

```
{
    "FailedResourcesMap": {}
}
```
有关更多信息，请参阅《资源组标记 API Reference》**中的 [UntagResources](https://docs.amazonaws.cn/resourcegroupstagging/latest/APIReference/API_UntagResources.html)。  
+  有关 API 详细信息，请参阅《Amazon CLI 命令参考》**中的 [UntagResources](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resourcegroupstaggingapi/untag-resources.html)。