• Amazon Systems Manager CloudWatch 控制面板在 2026 年 4 月 30 日之后将不再可用。客户可以像现在一样继续使用 Amazon CloudWatch 控制台来查看、创建和管理其 Amazon CloudWatch 控制面板。有关更多信息，请参阅 [Amazon CloudWatch 控制面板文档](https://docs.amazonaws.cn/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html)。

# 将 `AddTagsToResource` 与 CLI 配合使用
<a name="example_ssm_AddTagsToResource_section"></a>

以下代码示例演示如何使用 `AddTagsToResource`。

------
#### [ CLI ]

**Amazon CLI**  
**示例 1：向维护时段添加标签**  
以下 `add-tags-to-resource` 示例向指定的维护时段添加标签。  

```
aws ssm add-tags-to-resource \
    --resource-type {{"MaintenanceWindow"}} \
    --resource-id {{"mw-03eb9db428EXAMPLE"}} \
    --tags {{"Key=Stack,Value=Production"}}
```
此命令不生成任何输出。  
**示例 2：向参数添加标签**  
以下 `add-tags-to-resource` 示例向指定参数添加两个标签。  

```
aws ssm add-tags-to-resource \
    --resource-type {{"Parameter"}} \
    --resource-id {{"My-Parameter"}} \
    --tags '{{[{"Key":"Region","Value":"East"},{"Key":"Environment", "Value":"Production"}]}}'
```
此命令不生成任何输出。  
**示例 3：向 SSM 文档添加标签**  
以下 `add-tags-to-resource` 示例向指定文档添加标签。  

```
aws ssm add-tags-to-resource \
    --resource-type {{"Document"}} \
    --resource-id {{"My-Document"}} \
    --tags {{"Key=Quarter,Value=Q322"}}
```
此命令不生成任何输出。  
有关更多信息，请参阅《Amazon Systems Manager 用户指南》**中的[标记 Systems Manager 资源](https://docs.amazonaws.cn/systems-manager/latest/userguide/tagging-resources.html)。  
+  有关 API 详细信息，请参阅《Amazon CLI Command Reference》**中的 [AddTagsToResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm/add-tags-to-resource.html)。

------
#### [ PowerShell ]

**适用于 PowerShell V4 的工具**  
**示例 1：此示例使用新标签更新维护时段。如果此命令成功，则无任何输出。此示例使用的语法需要 PowerShell 版本 3 或更高版本。**  

```
$option1 = @{Key="Stack";Value=@("Production")}
Add-SSMResourceTag -ResourceId "mw-03eb9db42890fb82d" -ResourceType "MaintenanceWindow" -Tag $option1
```
**示例 2：对于 PowerShell 版本 2，必须使用 New-Object 创建每个标签。如果此命令成功，则无任何输出。**  

```
$tag1 = New-Object Amazon.SimpleSystemsManagement.Model.Tag
$tag1.Key = "Stack"
$tag1.Value = "Production"
		
Add-SSMResourceTag -ResourceId "mw-03eb9db42890fb82d" -ResourceType "MaintenanceWindow" -Tag $tag1
```
+  有关 API 详细信息，请参阅《Amazon Tools for PowerShell Cmdlet Reference（V4）》中的 [AddTagsToResource](https://docs.amazonaws.cn/powershell/v4/reference)**。

**适用于 PowerShell V5 的工具**  
**示例 1：此示例使用新标签更新维护时段。如果此命令成功，则无任何输出。此示例使用的语法需要 PowerShell 版本 3 或更高版本。**  

```
$option1 = @{Key="Stack";Value=@("Production")}
Add-SSMResourceTag -ResourceId "mw-03eb9db42890fb82d" -ResourceType "MaintenanceWindow" -Tag $option1
```
**示例 2：对于 PowerShell 版本 2，必须使用 New-Object 创建每个标签。如果此命令成功，则无任何输出。**  

```
$tag1 = New-Object Amazon.SimpleSystemsManagement.Model.Tag
$tag1.Key = "Stack"
$tag1.Value = "Production"
		
Add-SSMResourceTag -ResourceId "mw-03eb9db42890fb82d" -ResourceType "MaintenanceWindow" -Tag $tag1
```
+  有关 API 详细信息，请参阅《*Amazon Tools for PowerShell Cmdlet 参考 (V5)*》中的 [AddTagsToResource](https://docs.amazonaws.cn/powershell/v5/reference)。

------

有关 Amazon SDK 开发人员指南和代码示例的完整列表，请参阅 [将此服务与 Amazon SDK 结合使用](sdk-general-information-section.md)。本主题还包括有关入门的信息以及有关先前的 SDK 版本的详细信息。