搭RegisterTargetWithMaintenanceWindow配 AWS SDK或使用 CLI - AWS SDK 程式碼範例

AWS 文檔 AWS SDK示例 GitHub 回購中有更多SDK示例。

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

搭RegisterTargetWithMaintenanceWindow配 AWS SDK或使用 CLI

下列程式碼範例會示範如何使用RegisterTargetWithMaintenanceWindow。

CLI
AWS CLI

範例 1：在維護時段中註冊單一目標

下列register-target-with-maintenance-window範例會在維護時段中註冊執行個體。

aws ssm register-target-with-maintenance-window \
    --window-id "mw-ab12cd34ef56gh78" \
    --target "Key=InstanceIds,Values=i-0000293ffd8c57862" \
    --owner-information "Single instance" \
    --resource-type "INSTANCE"

輸出：

{
    "WindowTargetId":"1a2b3c4d-1a2b-1a2b-1a2b-1a2b3c4d-1a2"
}

範例 2：使用執行處理在維護時段中註冊多個目標 IDs

下列register-target-with-maintenance-window範例會指定兩個執行個體的執行個體，以維護時段註冊它們IDs。

aws ssm register-target-with-maintenance-window \
    --window-id "mw-ab12cd34ef56gh78" \
    --target "Key=InstanceIds,Values=i-0000293ffd8c57862,i-0cb2b964d3e14fd9f" \
    --owner-information "Two instances in a list" \
    --resource-type "INSTANCE"

輸出：

{
    "WindowTargetId":"1a2b3c4d-1a2b-1a2b-1a2b-1a2b3c4d-1a2"
}

範例 3：使用資源標記將目標註冊至維護時段

下列register-target-with-maintenance-window範例會指定已套用至執行處理的資源標記，以維護時段註冊執行處理。

aws ssm register-target-with-maintenance-window \
    --window-id "mw-06cf17cbefcb4bf4f" \
    --targets "Key=tag:Environment,Values=Prod" "Key=Role,Values=Web" \
    --owner-information "Production Web Servers" \
    --resource-type "INSTANCE"

輸出：

{
    "WindowTargetId":"1a2b3c4d-1a2b-1a2b-1a2b-1a2b3c4d-1a2"
}

範例 4：使用一組標籤鍵註冊目標

下列register-target-with-maintenance-window範例會註冊全部具有指派一或多個標籤鍵的執行個體，而不論其索引鍵值為何。

aws ssm register-target-with-maintenance-window \
    --window-id "mw-0c50858d01EXAMPLE" \
    --resource-type "INSTANCE" \
    --target "Key=tag-key,Values=Name,Instance-Type,CostCenter"

輸出：

{
    "WindowTargetId":"1a2b3c4d-1a2b-1a2b-1a2b-1a2b3c4d-1a2"
}

範例 5：使用資源群組名稱註冊目標

下列register-target-with-maintenance-window範例會註冊指定的資源群組，不論其包含的資源類型為何。

aws ssm register-target-with-maintenance-window \
    --window-id "mw-0c50858d01EXAMPLE" \
    --resource-type "RESOURCE_GROUP" \
    --target "Key=resource-groups:Name,Values=MyResourceGroup"

輸出：

{
    "WindowTargetId":"1a2b3c4d-1a2b-1a2b-1a2b-1a2b3c4d-1a2"
}

如需詳細資訊，請參閱「AWS Systems Manager 使用指南」中的「使用維護時段」(AWS CLI) 註冊目標執行個體。

PowerShell
適用的工具 PowerShell

範例 1：此範例會在維護時段中註冊執行個體。

$option1 = @{Key="InstanceIds";Values=@("i-0000293ffd8c57862")}
Register-SSMTargetWithMaintenanceWindow -WindowId "mw-06cf17cbefcb4bf4f" -Target $option1 -OwnerInformation "Single instance" -ResourceType "INSTANCE"

輸出：

d8e47760-23ed-46a5-9f28-927337725398

範例 2：此範例會在維護時段中註冊多個執行環境。

$option1 = @{Key="InstanceIds";Values=@("i-0000293ffd8c57862","i-0cb2b964d3e14fd9f")}
Register-SSMTargetWithMaintenanceWindow -WindowId "mw-06cf17cbefcb4bf4f" -Target $option1 -OwnerInformation "Single instance" -ResourceType "INSTANCE"

輸出：

6ab5c208-9fc4-4697-84b7-b02a6cc25f7d

範例 3：此範例會使用EC2標籤註冊具有維護時段的執行個體。

$option1 = @{Key="tag:Environment";Values=@("Production")}
Register-SSMTargetWithMaintenanceWindow -WindowId "mw-06cf17cbefcb4bf4f" -Target $option1 -OwnerInformation "Production Web Servers" -ResourceType "INSTANCE"

輸出：

2994977e-aefb-4a71-beac-df620352f184