View a markdown version of this page

Amazon Control Tower使用 的 示例Amazon CLI - Amazon Command Line Interface
操作
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

Amazon Control Tower使用 的 示例Amazon CLI

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

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

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

主题

操作

以下代码示例演示了如何使用 create-landing-zone。

Amazon CLI

创建 Control Tower 登录区

以下 create-landing-zone 示例创建 Amazon Control Tower 登录区。

aws controltower create-landing-zone \
    --landing-zone-version 3.3 \
    --manifest "file://LandingZoneManifest.json"

输出：

{
    "arn": "arn:aws:controltower:us-east-1:123456789012:landingzone/13CJG46WZKXXX4X5",
    "operationIdentifier": "55XXXXXX-e2XX-41XX-a7XX-446XXXXXXXXX"
}

有关更多信息，请参阅《Amazon Control Tower 用户指南》中的 Amazon Control Tower 入门。

  • 有关 API 详细信息，请参阅《Amazon CLI Command Reference》中的 CreateLandingZone。

以下代码示例演示了如何使用 delete-landing-zone。

Amazon CLI

停用登录区

以下 delete-landing-zone 示例停用 Amazon Control Tower 登录区。

aws controltower delete-landing-zone \
    --landing-zone-identifier arn:aws:controltower:us-east-1:123456789012:landingzone/13CJG46WZKXXX4X5

输出：

{
    "operationIdentifier": "47XXXXXX-a6XX-82XX-c9XX-432XXXXXXXXX"
}

有关更多信息，请参阅《Amazon Control Tower 用户指南》中的停用 Amazon Control Tower 登录区。

  • 有关 API 详细信息，请参阅《Amazon CLI Command Reference》中的 DeleteLandingZone。

以下代码示例演示了如何使用 disable-baseline。

Amazon CLI

禁用 Control Tower 基准

以下 disable-baseline 示例禁用 Amazon Control Tower 基准。

aws controltower disable-baseline \
    --enabled-baseline-identifier arn:aws:controltower:us-east-1:123456789012:enabledbaseline/XOM12BEL4YD578CQ2

输出：

{
    "operationIdentifier": "b33486d7-5396-4ad0-9eae-3a57969fe8cd"
}

有关更多信息，请参阅《Amazon Control Tower 用户指南》中的基准的类型。

  • 有关 API 详细信息，请参阅《Amazon CLI Command Reference》中的 DisableBaseline。

以下代码示例演示了如何使用 disable-control。

Amazon CLI

禁用 Control Tower 控件

以下 disable-control 示例禁用 Amazon Control Tower 启用的控件。

aws controltower disable-control \
    --control-identifier arn:aws:controlcatalog:::control/497wrm2xnk1wxlf4obrxxxxxx \
    --target-identifier arn:aws:organizations::123456789012:ou/o-s64ryxxxxx/ou-oqxx-i5wnxxxx

输出：

{
    "operationIdentifier": "b8f0dxxx-08xx-43xx-a2xx-568e9922xxxx"
}

有关更多信息，请参阅《Amazon Control Tower 用户指南》中的关于 Amazon Control Tower 中的控件。

  • 有关 API 详细信息，请参阅《Amazon CLI Command Reference》中的 DisableControl。

以下代码示例演示了如何使用 enable-baseline。

Amazon CLI

示例 1：启用已禁用的 Control Tower 基准

以下 enable-baseline 示例在 Amazon Control Tower 基准 IdentityCenterBaseline 处于禁用状态时启用该基准。

aws controltower enable-baseline \
    --baseline-identifier arn:aws:controltower:us-east-1::baseline/17BSJV3IGJ2QSGA2 \
    --baseline-version 4.0 \
    --target-identifier arn:aws:organizations::123456789012:ou/o-s64ryixxxx/ou-oq9f-i5wnxxxx

输出：

{
    "arn": "arn:aws:controltower:us-east-1:123456789012:enabledbaseline/XOM12BEL4YD578CQ2",
    "operationIdentifier": "51e190ac-8a37-4f6d-b63c-fb5104b5db38"
}

有关更多信息，请参阅《Amazon Control Tower 用户指南》中的基准的类型。

示例 2：启用已启用的 Control Tower 基准

以下 enable-baseline 示例在 Amazon Control Tower 基准 IdentityCenterBaseline 处于启用状态时启用该基准。

aws controltower enable-baseline \
    --baseline-identifier arn:aws:controltower:us-east-1::baseline/17BSJV3IGJ2QSGA2 \
    --baseline-version 4.0 \
    --target-identifier arn:aws:organizations::123456789012:ou/o-s64ryixxxx/ou-oqxx-i5wnxxxx \
    --parameters '[{"key":"IdentityCenterEnabledBaselineArn","value":"arn:aws:controltower:us-east-1:123456789012:enabledbaseline/XAJNZNCBC1I386C7B"}]'

输出：

{
    "arn": "arn:aws:controltower:us-east-1:123456789012:enabledbaseline/XOM12BEL4YD578CQ2",
    "operationIdentifier": "51e190ac-8a37-4f6d-b63c-fb5104b5db38"
}

有关更多信息，请参阅《Amazon Control Tower 用户指南》中的基准的类型。

  • 有关 API 详细信息，请参阅《Amazon CLI Command Reference》中的 EnableBaseline。

以下代码示例演示了如何使用 enable-control。

Amazon CLI

启用 Control Tower 控件

以下 enable-control 示例启用 Amazon Control Tower 控件。

aws controltower enable-control \
    --control-identifier arn:aws:controlcatalog:::control/497wrm2xnk1wxlf4obrxxxxxx \
    --target-identifier arn:aws:organizations::123456789012:ou/o-s64ryxxxxx/ou-oqxx-i5wnxxxx

输出：

{
    "arn": "arn:aws:controltower:us-east-1:123456789012:enabledcontrol/18J5KBJ3W3VTIRLV",
    "operationIdentifier": "7691fc5a-de87-4540-8c95-b0aabd56382c"
}

有关更多信息，请参阅《Amazon Control Tower 用户指南》中的关于 Amazon Control Tower 中的控件。

  • 有关 API 详细信息，请参阅《Amazon CLI Command Reference》中的 EnableControl。

以下代码示例演示了如何使用 get-baseline-operation。

Amazon CLI

获取 Control Tower 基准操作

以下 get-baseline-operation 示例获取 Amazon Control Tower 基准操作的详细信息。

aws controltower get-baseline-operation \
    --operation-identifier "51e190ac-8a37-4f6d-b63c-fb5104b5db38"

输出：

{
    "baselineOperation": {
        "endTime": "2025-04-17T23:48:46+00:00",
        "operationIdentifier": "51e190ac-8a37-4f6d-b63c-fb5104b5db38",
        "operationType": "ENABLE_BASELINE",
        "startTime": "2025-04-17T23:46:37+00:00",
        "status": "SUCCEEDED",
        "statusMessage": "AWS Control Tower completed the baseline operation successfully."
    }
}

有关更多信息，请参阅《Amazon Control Tower 用户指南》中的基准的类型。

  • 有关 API 详细信息，请参阅《Amazon CLI Command Reference》中的 GetBaselineOperation。

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

Amazon CLI

获取 Control Tower 基准

以下 get-baseline 示例获取 Amazon Control Tower 基准的详细信息。

aws controltower get-baseline \
    --baseline-identifier arn:aws:controltower:us-east-1::baseline/LN25R72TTG6IGPTQ

输出：

{
    "arn": "arn:aws:controltower:us-east-1::baseline/LN25R72TTG6IGPTQ",
    "description": "Sets up shared resources for AWS Identity Center, which prepares the AWSControlTowerBaseline to set up Identity Center access for accounts.",
    "name": "IdentityCenterBaseline"
}

有关更多信息，请参阅《Amazon Control Tower 用户指南》中的基准的类型。

  • 有关 API 详细信息，请参阅《Amazon CLI Command Reference》中的 GetBaseline。

以下代码示例演示了如何使用 get-control-operation。

Amazon CLI

获取 Control Tower 控制操作

以下 get-control-operation 示例获取 Amazon Control Tower 控制操作的详细信息。

aws controltower get-control-operation \
    --operation-identifier "7691fc5a-de87-4540-8c95-b0aabd56382c"

输出：

{
    "controlOperation": {
        "controlIdentifier": "arn:aws:controlcatalog:::control/497wrm2xnk1wxlf4obrdo7mej",
        "enabledControlIdentifier": "arn:aws:controltower:us-east-1:123456789012:enabledcontrol/18J5KBJ3W3VTIRLV",
        "endTime": "2025-04-17T03:08:55+00:00",
        "operationIdentifier": "7691fc5a-de87-4540-8c95-b0aabd56382c",
        "operationType": "ENABLE_CONTROL",
        "startTime": "2025-04-17T03:07:52+00:00",
        "status": "SUCCEEDED",
        "statusMessage": "Operation was successful.",
        "targetIdentifier": "arn:aws:organizations::123456789012:ou/o-s64ryixxxx/ou-oqxx-i5wnxxxx"
    }
}

有关更多信息，请参阅《Amazon Control Tower 用户指南》中的关于 Amazon Control Tower 中的控件。

  • 有关 API 详细信息，请参阅《Amazon CLI Command Reference》中的 GetControlOperation。

以下代码示例演示了如何使用 get-enabled-baseline。

Amazon CLI

获取 Control Tower 启用的基准

以下 get-enabled-baseline 示例获取 Amazon Control Tower 启用的基准的详细信息。

aws controltower get-enabled-baseline \
    --enabled-baseline-identifier arn:aws:controltower:us-east-1:123456789012:enabledbaseline/XOM12BEL4YD578CQ2

输出：

{
    "enabledBaselineDetails": {
        "arn": "arn:aws:controltower:us-east-1:123456789012:enabledbaseline/XOM12BEL4YD578CQ2",
        "baselineIdentifier": "arn:aws:controltower:us-east-1::baseline/17BSJV3IGJ2QSGA2",
        "baselineVersion": "4.0",
        "parameters": [
            {
                "key": "IdentityCenterEnabledBaselineArn",
                "value": "arn:aws:controltower:us-east-1:123456789012:enabledbaseline/XAJNZNCBC1I386C7B"
            }
        ],
        "statusSummary": {
            "lastOperationIdentifier": "51e190ac-8a37-4f6d-b63c-fb5104b5db38",
            "status": "SUCCEEDED"
        },
        "targetIdentifier": "arn:aws:organizations::123456789012:ou/o-3onqfufxxx/ou-g8xx-5kluxxxx"
    }
}

有关更多信息，请参阅《Amazon Control Tower 用户指南》中的基准的类型。

  • 有关 API 详细信息，请参阅《Amazon CLI Command Reference》中的 GetEnabledBaseline。

以下代码示例演示了如何使用 get-enabled-control。

Amazon CLI

获取 Control Tower 启用的控件

以下 get-enabled-control 示例获取 Amazon Control Tower 启用的控件的详细信息。

aws controltower get-enabled-control \
    --enabled-control-identifier arn:aws:controltower:us-east-1:123456789012:enabledcontrol/26RGJRSLXCP1KW8D

输出：

{
    "enabledControlDetails": {
        "arn": "arn:aws:controltower:us-east-1:123456789012:enabledcontrol/26RGJRSLXCP1KW8D",
        "controlIdentifier": "arn:aws:controltower:us-east-1::control/AWS-GR_CLOUDTRAIL_CHANGE_PROHIBITED",
        "driftStatusSummary": {
             "driftStatus": "NOT_CHECKING"
        },
        "parameters": [],
        "statusSummary": {
            "status": "SUCCEEDED"
        },
        "targetIdentifier": "arn:aws:organizations::123456789012:ou/o-s64ryixxxx/ou-oqxx-i5wnxxxx",
        "targetRegions": [
            {
                "name": "ap-south-2"
            },
            {
                "name": "ap-south-1"
            },
            {
                "name": "eu-south-1"
            },
            {
                "name": "us-east-1"
            }
        ]
    }
}

有关更多信息，请参阅《Amazon Control Tower 用户指南》中的关于 Amazon Control Tower 中的控件。

  • 有关 API 详细信息，请参阅《Amazon CLI Command Reference》中的 GetEnabledControl。

以下代码示例演示了如何使用 get-landing-zone-operation。

Amazon CLI

获取 Control Tower 登录区操作

以下 get-landing-zone-operation 示例获取 Amazon Control Tower 登录区操作的详细信息。

aws controltower get-landing-zone-operation \
    --operation-identifier ee9d0d2d-6532-42d8-9b85-3fbb0700a606

输出：

{
    "operationDetails": {
        "operationIdentifier": "ee9d0d2d-6532-42d8-9b85-3fbb0700xxxx",
        "operationType": "RESET",
        "startTime": "2025-04-17T03:19:33+00:00",
        "status": "IN_PROGRESS"
    }
}

有关更多信息，请参阅《Amazon Control Tower 用户指南》中的 Amazon Control Tower 入门。

以下代码示例演示了如何使用 get-landing-zone。

Amazon CLI

描述 Control Tower 登录区

以下 get-landing-zone 示例获取 Amazon Control Tower 登录区的详细信息。

aws controltower get-landing-zone \
    --landing-zone-identifier arn:aws:controltower:us-east-1:123456789012:landingzone/13CJG46WZKXXX4X5

输出：

{
    "landingZone": {
        "arn": "arn:aws:controltower:us-east-1:123456789012:landingzone/13CJG46WZKXXX4X5",
        "driftStatus": {
            "status": "IN_SYNC"
        },
        "latestAvailableVersion": "3.3",
        "manifest": {
            "accessManagement": {
                "enabled": true
            },
            "securityRoles": {
                "accountId": "098765432101"
            },
            "governedRegions": [
                "us-east-1",
                "us-west-2"
            ],
            "organizationStructure": {
                "security": {
                    "name": "Security"
                }
            },
            "centralizedLogging": {
                "accountId": "111122223333",
                "configurations": {
                    "loggingBucket": {
                        "retentionDays": 365
                    },
                    "kmsKeyArn": "arn:aws:kms:us-east-1:123456789012:key/example-key-id",
                    "accessLoggingBucket": {
                        "retentionDays": 3650
                    }
                },
                "enabled": true
            }
        },
        "status": "ACTIVE",
        "version": "3.3"
    }
}

有关更多信息，请参阅《Amazon Control Tower 用户指南》中的 Amazon Control Tower 入门。

  • 有关 API 详细信息，请参阅《Amazon CLI Command Reference》中的 GetLandingZone。

以下代码示例演示了如何使用 list-baselines。

Amazon CLI

列出 Control Tower 基准

以下 list-baselines 示例列出所有可用的 Amazon Control Tower 基准。

aws controltower list-baselines

输出：

{
    "baselines": [
        {
            "arn": "arn:aws:controltower:us-east-1::baseline/4T4HA1KMO10S6311",
            "description": "Sets up resources to monitor security and compliance of accounts in your organization.",
            "name": "AuditBaseline"
        },
        {
            "arn": "arn:aws:controltower:us-east-1::baseline/J8HX46AHS5MIKQPD",
            "description": "Sets up a central repository for logs of API activities and resource configurations from accounts in your organization.",
            "name": "LogArchiveBaseline"
        },
        {
            "arn": "arn:aws:controltower:us-east-1::baseline/LN25R72TTG6IGPTQ",
            "description": "Sets up shared resources for AWS Identity Center, which prepares the AWSControlTowerBaseline to set up Identity Center access for accounts.",
            "name": "IdentityCenterBaseline"
        },
        {
            "arn": "arn:aws:controltower:us-east-1::baseline/17BSJV3IGJ2QSGA2",
            "description": "Sets up resources and mandatory controls for member accounts within the target OU, required for AWS Control Tower governance.",
            "name": "AWSControlTowerBaseline"
        },
        {
            "arn": "arn:aws:controltower:us-east-1::baseline/3WPD0NA6TJ9AOMU2",
            "description": "Sets up a central AWS Backup vault in your organization.",
            "name": "BackupCentralVaultBaseline"
        },
        {
            "arn": "arn:aws:controltower:us-east-1::baseline/H6C5JFCJJ3CPU3J5",
            "description": "Sets up AWS Backup Audit Manager.",
            "name": "BackupAdminBaseline"
        },
        {
            "arn": "arn:aws:controltower:us-east-1::baseline/APO9ATVPBKFRRGLK",
            "description": "Sets up a local AWS Backup vault and attaches multiple AWS Backup plans.",
            "name": "BackupBaseline"
        }
    ]
}

有关更多信息，请参阅《Amazon Control Tower 用户指南》中的基准的类型。

  • 有关 API 详细信息，请参阅《Amazon CLI Command Reference》中的 ListBaselines。

以下代码示例演示了如何使用 list-control-operations。

Amazon CLI

列出 Control Tower 控制操作

以下 list-control-operations 示例列出正在进行或已排队的 Amazon Control Tower 控件的详细信息。

aws controltower list-control-operations

输出：

{
    "controlOperations": [
        {
            "startTime": "2024-02-19T19:22:08+00:00",
            "operationType": "ENABLE_CONTROL",
            "status": "IN_PROGRESS",
            "statusMessage": "Operation is in progress.",
            "operationIdentifier": "f9f43b45-db27-44df-89d8-f9129e3632XX",
            "controlIdentifier": "arn:aws:controltower:us-east-1::control/SKIBWKYUQAAC",
            "targetIdentifier": "arn:aws:organizations::123456789012:ou/o-yy67i3pfv2/ou-slt4-8abknXXX",
            "enabledControlIdentifier": "arn:aws:controltower:us-east-1:123456789012:enabledcontrol/RWZFSHV2BBRU6JSE"
        },
        {
            "startTime": "2024-02-19T19:21:09+00:00",
            "operationType": "ENABLE_CONTROL",
            "status": "IN_PROGRESS",
            "statusMessage": "Operation is in progress",
            "operationIdentifier": "171ee0b1-e926-486e-9775-005bd244ccXX",
            "controlIdentifier": "arn:aws:controltower:us-east-1::control/PDKYAANJEWJE",
            "targetIdentifier": "arn:aws:organizations::123456789012:ou/o-yy67i3pfv2/ou-slt4-fl6miXXX",
            "enabledControlIdentifier": "arn:aws:controltower:us-east-2:123456789012:enabledcontrol/XCNJARWZFSHV6JSE"
        }
    ]
}

有关更多信息，请参阅《Amazon Control Tower 用户指南》中的关于 Amazon Control Tower 中的控件。

以下代码示例演示了如何使用 list-enabled-baselines。

Amazon CLI

列出 Control Tower 启用的基准

以下 list-enabled-baselines 示例列出所有启用的 Amazon Control Tower 基准。

aws controltower list-enabled-baselines

输出：

{
    "enabledBaselines": [
        {
            "arn": "arn:aws:controltower:us-east-1:123456789012:enabledbaseline/XAJNZNCBC1I386C7B",
            "baselineIdentifier": "arn:aws:controltower:us-east-1::baseline/LN25R72TTG6IGPTQ",
            "statusSummary": {
                "status": "SUCCEEDED"
            },
            "targetIdentifier": "arn:aws:organizations::123456789012:account/o-3onqfuxxxx/123456789012"
        },
        {
            "arn": "arn:aws:controltower:us-east-1:123456789012:enabledbaseline/XAH3ZJL9DWA386CA5",
            "baselineIdentifier": "arn:aws:controltower:us-east-1::baseline/4T4HA1KMO10S6311",
            "statusSummary": {
                "status": "SUCCEEDED"
            },
            "targetIdentifier": "arn:aws:organizations::123456789012:account/o-3onqfuxxxx/012345098765"
        },
        {
            "arn": "arn:aws:controltower:us-east-1:123456789012:enabledbaseline/XALFJ9548TL386CBT",
            "baselineIdentifier": "arn:aws:controltower:us-east-1::baseline/J8HX46AHS5MIKQPD",
            "statusSummary": {
                "status": "SUCCEEDED"
            },
            "targetIdentifier": "arn:aws:organizations::123456789012:account/o-3onqfuxxxx/098765432109"
        }
    ]
}

有关更多信息，请参阅《Amazon Control Tower 用户指南》中的基准的类型。

  • 有关 API 详细信息，请参阅《Amazon CLI Command Reference》中的 ListEnabledBaselines。

以下代码示例演示了如何使用 list-enabled-controls。

Amazon CLI

列出 Control Tower 启用的控件

以下 list-enabled-controls 示例获取 Amazon Control Tower 启用的控件的详细信息。

aws controltower list-enabled-controls \
    --target-identifier arn:aws:organizations::123456789012:ou/o-s64ryxxxxx/ou-oqxx-i5wnxxxx

输出：

{
    "enabledControls": [
        {
            "arn": "arn:aws:controltower:us-east-1:123456789012:enabledcontrol/26RGJRSLXCP1KW8D",
            "controlIdentifier": "arn:aws:controltower:us-east-1::control/AWS-GR_CLOUDTRAIL_CHANGE_PROHIBITED",
            "driftStatusSummary": {
                "driftStatus": "NOT_CHECKING"
            },
            "statusSummary": {
                "status": "SUCCEEDED"
            },
            "targetIdentifier": "arn:aws:organizations::123456789012:ou/o-s64ryxxxxx/ou-oqxx-i5wnxxxx"
        },
        {
            "arn": "arn:aws:controltower:us-east-1:123456789012:enabledcontrol/18AY24CWKM6IVSLU",
            "controlIdentifier": "arn:aws:controltower:us-east-1::control/AWS-GR_CLOUDTRAIL_CLOUDWATCH_LOGS_ENABLED",
            "driftStatusSummary": {
                "driftStatus": "NOT_CHECKING"
            },
            "statusSummary": {
                "status": "SUCCEEDED"
            },
            "targetIdentifier": "arn:aws:organizations::123456789012:ou/o-s64ryxxxxx/ou-oqxx-i5wnxxxx"
        }
    ]
}

有关更多信息，请参阅《Amazon Control Tower 用户指南》中的关于 Amazon Control Tower 中的控件。

  • 有关 API 详细信息，请参阅《Amazon CLI Command Reference》中的 ListEnabledControls。

以下代码示例演示了如何使用 list-landing-zone-operations。

Amazon CLI

列出 Control Tower 登录区操作

以下 list-landing-zone-operations 示例列出 Amazon Control Tower 登录区操作。

aws controltower list-landing-zone-operations

输出：

{
    "landingZoneOperations": [
        {
            "operationIdentifier": "202ee056-5147-49fd-a7ad-8161e3bf043a",
            "operationType": "RESET",
            "status": "SUCCEEDED"
        },
        {
            "operationIdentifier": "dbd4a4b1-baf9-48cc-bd71-6b923d0f2339",
            "operationType": "RESET",
            "status": "SUCCEEDED"
        },
        {
            "operationIdentifier": "e6261ab8-3247-4052-af31-1afe7bb0593e",
            "operationType": "UPDATE",
            "status": "SUCCEEDED"
        },
        {
            "operationIdentifier": "507c6c87-89a8-435f-8697-b257a800f129",
            "operationType": "UPDATE",
            "status": "SUCCEEDED"
        }
    ]
}

有关更多信息，请参阅《Amazon Control Tower 用户指南》中的 Amazon Control Tower 入门。

以下代码示例演示了如何使用 list-landing-zones。

Amazon CLI

列出 Control Tower 登录区标识符

以下 list-landing-zones 示例列出 Control Tower 登录区 identifier。

aws controltower list-landing-zones

输出：

{
    "landingZones": [
        {
            "arn": "arn:aws:controltower:us-east-1:123456789012:landingzone/13CJG46WZKXXX4X5"
        }
    ]
}

有关更多信息，请参阅《Amazon Control Tower 用户指南》中的 Amazon Control Tower 入门。

  • 有关 API 详细信息，请参阅《Amazon CLI Command Reference》中的 ListLandingZones。

以下代码示例演示了如何使用 list-tags-for-resource。

Amazon CLI

列出 Control Tower 启用的控件的标签

以下 list-tags-for-resource 示例列出 Amazon Control Tower 启用的控件的标签。

aws controltower list-tags-for-resource \
    --resource-arn "arn:aws:controltower:us-east-1:123456789012:enabledcontrol/2H2AWUG4SKG81855"

输出：

{
    "tags": {
        "TestTagKey": "TestTagValue"
    }
}

有关更多信息，请参阅《Amazon Control Tower 用户指南》中的关于 Amazon Control Tower 中的控件。

  • 有关 API 详细信息，请参阅《Amazon CLI 命令参考》中的 ListTagsForResource。

以下代码示例演示了如何使用 reset-enabled-baseline。

Amazon CLI

重置 Control Tower 启用的基准

以下 reset-enabled-baseline 示例重置 Amazon Control Tower 启用的基准。

aws controltower reset-enabled-baseline \
    --enabled-baseline-identifier arn:aws:controltower:us-east-1:123456789012:enabledbaseline/XOM12BEL4YD578CQ2

输出：

{
    "operationIdentifier": "214cde95-5c39-46b9-b429-4fad550a7096"
}

有关更多信息，请参阅《Amazon Control Tower 用户指南》中的基准的类型。

  • 有关 API 详细信息，请参阅《Amazon CLI Command Reference》中的 ResetEnabledBaseline。

以下代码示例演示了如何使用 reset-enabled-control。

Amazon CLI

重置 Control Tower 启用的控件

以下 reset-enabled-control 示例重置 Amazon Control Tower 启用的控件。

aws controltower reset-enabled-control \
    --enabled-control-identifier arn:aws:controltower:us-east-1:123456789012:enabledcontrol/2H2AWUG4SKG81855

输出：

{
    "operationIdentifier": "8276XXXX-b4XX-4eXX-96XX-881d2a4XXXXX"
}

有关更多信息，请参阅《Amazon Control Tower 用户指南》中的关于 Amazon Control Tower 中的控件。

  • 有关 API 详细信息，请参阅《Amazon CLI Command Reference》中的 ResetEnabledControl。

以下代码示例演示了如何使用 reset-landing-zone。

Amazon CLI

重置 Control Tower 登录区

以下 reset-landing-zone 示例重置 Amazon Control Tower 登录区。

aws controltower reset-landing-zone \
    --landing-zone-identifier arn:aws:controltower:us-east-1:123456789012:landingzone/13CJG46WZKXXX4X5

输出：

{
    "operationIdentifier": "73XXXXXX-b2XX-77XX-c6XX-374XXXXXXXXX"
}

有关更多信息，请参阅《Amazon Control Tower 用户指南》中的 Amazon Control Tower 入门。

  • 有关 API 详细信息，请参阅《Amazon CLI Command Reference》中的 ResetLandingZone。

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

Amazon CLI

标记 Control Tower 启用的控件

以下 tag-resource 示例标记 Amazon Control Tower 启用的控件。

aws controltower tag-resource \
    --resource-arn "arn:aws:controltower:us-east-1:123456789012:enabledcontrol/2H2AWUG4SKG81855" \
    --tags "TestTagKey=TestTagValue"

此命令不生成任何输出。

有关更多信息，请参阅《Amazon Control Tower 用户指南》中的关于 Amazon Control Tower 中的控件。

  • 有关 API 详细信息，请参阅《Amazon CLI 命令参考》中的 TagResource。

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

Amazon CLI

取消标记 Control Tower 启用的控件

以下 untag-resource 示例取消标记 Amazon Control Tower 启用的控件。

aws controltower untag-resource \
    --resource-arn "arn:aws:controltower:us-east-1:123456789012:enabledcontrol/2H2AWUG4SKG81855" \
    --tag-keys "TestTagKey"

此命令不生成任何输出。

有关更多信息，请参阅《Amazon Control Tower 用户指南》中的关于 Amazon Control Tower 中的控件。

  • 有关 API 详细信息，请参阅《Amazon CLI 命令参考》中的 UntagResource。

以下代码示例演示了如何使用 update-enabled-baseline。

Amazon CLI

示例 1：更新禁用的 Control Tower 基准

以下 update-enabled-baseline 示例在基准“IdentityCenterBaseline”处于禁用状态时更新 Amazon Control Tower 启用的基准。

aws controltower update-enabled-baseline \
    --baseline-version 4.0 \
    --enabled-baseline-identifier arn:aws:controltower:us-east-1:123456789012:enabledbaseline/XOM12BEL4YD578CQ2

输出：

{
    "operationIdentifier": "214cde95-5c39-46b9-b429-4fad550a7096"
}

示例 2：更新已启用的 Control Tower 基准

以下 update-enabled-baseline 示例在基准“IdentityCenterBaseline”处于启用状态时更新 Amazon Control Tower 启用的基准。

aws controltower update-enabled-baseline \
    --baseline-version 4.0 \
    --enabled-baseline-identifier arn:aws:controltower:us-east-1:123456789012:enabledbaseline/XOM12BEL4YD578CQ2 \
    --parameters '[{"key":"IdentityCenterEnabledBaselineArn","value":"arn:aws:controltower:us-east-1:123456789012:enabledbaseline/XAJNZNCBC1I386C7B"}]'

输出：

{
    "operationIdentifier": "b0f4a7c2-334d-48d9-971e-47fea9db3e8b"
}

有关更多信息，请参阅《Amazon Control Tower 用户指南》中的基准的类型。

以下代码示例演示了如何使用 update-enabled-control。

Amazon CLI

更新 Control Tower 启用的控件

以下 update-enabled-control 示例更新 Amazon Control Tower 启用的控件。

aws controltower update-enabled-control \
    --enabled-control-identifier arn:aws:controltower:us-east-1:123456789012:enabledcontrol/JSJN8UL0G2MWGRTZ \
    --parameters '[{"key":"AllowedRegions","value":["us-east-1","us-west-1","us-west-2","us-east-2"]}]'

输出：

{
    "operationIdentifier": "b8f0dxxx-08xx-43xx-a2xx-568e9922xxxx"
}

有关更多信息，请参阅《Amazon Control Tower 用户指南》中的关于 Amazon Control Tower 中的控件。

  • 有关 API 详细信息，请参阅《Amazon CLI Command Reference》中的 UpdateEnabledControl。

以下代码示例演示了如何使用 update-landing-zone。

Amazon CLI

更新 Control Tower 登录区

以下 update-landing-zone 示例更新 Amazon Control Tower 登录区。

aws controltower update-landing-zone \
    --landing-zone-identifier arn:aws:controltower:us-east-1:123456789012:landingzone/13CJG46WZKXXX4X5 \
    --landing-zone-version 3.3 \
    --manifest "file://UpdateLandingZoneManifest.json"

输出：

{
    "operationIdentifier": "53XXXXXX-b2XX-97XX-c6XX-474XXXXXXXXX"
}

有关更多信息，请参阅《Amazon Control Tower 用户指南》中的 Amazon Control Tower 入门。

  • 有关 API 详细信息，请参阅《Amazon CLI Command Reference》中的 UpdateLandingZone。