View a markdown version of this page

AWS Control Tower 使用示例 AWS CLI - AWS SDK 代码示例
操作

文档 AWS SDK 示例 GitHub 存储库中还有更多 S AWS DK 示例。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

AWS Control Tower 使用示例 AWS CLI

以下代码示例向您展示了如何使用with来执行操作和实现常见场景 AWS Control Tower。 AWS Command Line Interface

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

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

主题

操作

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

AWS CLI

创建 Control Tower 着陆区

以下create-landing-zone示例创建了 Cont AWS rol 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"
}

有关更多信息，请参阅《AWS 控制塔用户指南》中的 Cont AWS rol Tower 入门。

  • 有关 API 的详细信息，请参阅AWS CLI 命令参考CreateLandingZone中的。

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

AWS CLI

停用着陆区

以下delete-landing-zone示例停用 Cont AWS rol Tower 着陆区。

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

输出：

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

有关更多信息，请参阅《AWS 控制塔用户指南》中的停用AWS 控制塔着陆区。

  • 有关 API 的详细信息，请参阅AWS CLI 命令参考DeleteLandingZone中的。

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

AWS CLI

禁用 Control Tower 基准

以下disable-baseline示例禁用 Cont AWS rol Tower 基准。

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

输出：

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

有关更多信息，请参阅 Cont AWS rol Tower 用户指南中的基准类型。

  • 有关 API 的详细信息，请参阅AWS CLI 命令参考DisableBaseline中的。

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

AWS CLI

禁用 Control Tower 控件

以下disable-control示例禁用启用了 Cont AWS rol 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"
}

有关更多信息，请参阅《控制塔用户指南》中的 “关于AWS控制塔中的控件”。 AWS

  • 有关 API 的详细信息，请参阅AWS CLI 命令参考DisableControl中的。

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

AWS CLI

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

以下enable-baseline示例在禁用基准时启用 Con IdentityCenterBaseline t AWS rol Tower 基准。

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"
}

有关更多信息，请参阅 Cont AWS rol Tower 用户指南中的基准类型。

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

如果启用了基准，则以下enable-baseline示例将启用 Cont AWS rol IdentityCenterBaseline Tower 基准。

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"
}

有关更多信息，请参阅 Cont AWS rol Tower 用户指南中的基准类型。

  • 有关 API 的详细信息，请参阅AWS CLI 命令参考EnableBaseline中的。

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

AWS CLI

启用 Control Tower 控件

以下enable-control示例启用 Cont AWS rol 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"
}

有关更多信息，请参阅《控制塔用户指南》中的 “关于AWS控制塔中的控件”。 AWS

  • 有关 API 的详细信息，请参阅AWS CLI 命令参考EnableControl中的。

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

AWS CLI

获取 Control Tower 基准操作

以下get-baseline-operation示例获取了 Cont AWS rol 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."
    }
}

有关更多信息，请参阅 Cont AWS rol Tower 用户指南中的基准类型。

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

AWS CLI

获取 Control Tower 基准

以下get-baseline示例获取了 Cont AWS rol 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"
}

有关更多信息，请参阅 Cont AWS rol Tower 用户指南中的基准类型。

  • 有关 API 的详细信息，请参阅AWS CLI 命令参考GetBaseline中的。

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

AWS CLI

要获取 Control Tower 的控制操作

以下get-control-operation示例详细介绍了 Cont AWS rol 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"
    }
}

有关更多信息，请参阅《控制塔用户指南》中的 “关于AWS控制塔中的控件”。 AWS

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

AWS CLI

获取启用 Control Tower 的基准

以下get-enabled-baseline示例详细介绍了启用了 Cont AWS rol 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"
    }
}

有关更多信息，请参阅 Cont AWS rol Tower 用户指南中的基准类型。

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

AWS CLI

获取启用 Control Tower 的控件

以下get-enabled-control示例详细介绍了启用了 Cont AWS rol 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"
            }
        ]
    }
}

有关更多信息，请参阅《控制塔用户指南》中的 “关于AWS控制塔中的控件”。 AWS

  • 有关 API 的详细信息，请参阅AWS CLI 命令参考GetEnabledControl中的。

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

AWS CLI

要获得 Control Tower 着陆区行动

以下get-landing-zone-operation示例详细介绍了 Cont AWS rol 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"
    }
}

有关更多信息，请参阅《AWS 控制塔用户指南》中的 Cont AWS rol Tower 入门。

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

AWS CLI

描述 Control Tower 着陆区

以下get-landing-zone示例获取了 Cont AWS rol 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"
    }
}

有关更多信息，请参阅《AWS 控制塔用户指南》中的 Cont AWS rol Tower 入门。

  • 有关 API 的详细信息，请参阅AWS CLI 命令参考GetLandingZone中的。

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

AWS CLI

列出 Control Tower 基准

以下list-baselines示例列出了所有可用的 Cont AWS rol 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"
        }
    ]
}

有关更多信息，请参阅 Cont AWS rol Tower 用户指南中的基准类型。

  • 有关 API 的详细信息，请参阅AWS CLI 命令参考ListBaselines中的。

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

AWS CLI

列出 Control Tower 控制操作

以下list-control-operations示例列出了正在进行或已排队的 Contro AWS l 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"
        }
    ]
}

有关更多信息，请参阅《控制塔用户指南》中的 “关于AWS控制塔中的控件”。 AWS

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

AWS CLI

列出启用 Control Tower 的基准

以下list-enabled-baselines示例列出了所有启用的 Cont AWS rol 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"
        }
    ]
}

有关更多信息，请参阅 Cont AWS rol Tower 用户指南中的基准类型。

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

AWS CLI

列出启用 Control Tower 的控件

以下list-enabled-controls示例详细介绍了启用 Cont AWS rol 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"
        }
    ]
}

有关更多信息，请参阅《控制塔用户指南》中的 “关于AWS控制塔中的控件”。 AWS

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

AWS CLI

列出 Control Tower 着陆区的行动

以下list-landing-zone-operations示例列出了 Cont AWS rol 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"
        }
    ]
}

有关更多信息，请参阅《AWS 控制塔用户指南》中的 Cont AWS rol Tower 入门。

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

AWS 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"
        }
    ]
}

有关更多信息，请参阅《AWS 控制塔用户指南》中的 Cont AWS rol Tower 入门。

  • 有关 API 的详细信息，请参阅AWS CLI 命令参考ListLandingZones中的。

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

AWS CLI

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

以下list-tags-for-resource示例列出了已启用 Cont AWS rol Tower 的控件的标签。

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

输出：

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

有关更多信息，请参阅《控制塔用户指南》中的 “关于AWS控制塔中的控件”。 AWS

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

AWS CLI

重置已启用 Control Tower 的基准

以下reset-enabled-baseline示例重置了启用 Cont AWS rol Tower 的基准。

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

输出：

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

有关更多信息，请参阅 Cont AWS rol Tower 用户指南中的基准类型。

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

AWS CLI

重置已启用 Control Tower 的控件

以下reset-enabled-control示例重置启用了 Cont AWS rol Tower 的控件。

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

输出：

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

有关更多信息，请参阅《控制塔用户指南》中的 “关于AWS控制塔中的控件”。 AWS

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

AWS CLI

重置 Control Tower 着陆区

以下reset-landing-zone示例重置了 Cont AWS rol Tower 着陆区。

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

输出：

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

有关更多信息，请参阅《AWS 控制塔用户指南》中的 Cont AWS rol Tower 入门。

  • 有关 API 的详细信息，请参阅AWS CLI 命令参考ResetLandingZone中的。

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

AWS CLI

标记已启用 Control Tower 的控件

以下tag-resource示例为启用了 Control Tower 的 AWS 控件添加了标签。

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

此命令不生成任何输出。

有关更多信息，请参阅《控制塔用户指南》中的 “关于AWS控制塔中的控件”。 AWS

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

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

AWS CLI

取消标记已启用 Control Tower 的控件

以下untag-resource示例取消了启用了 Control Tower 的 AWS 控件的标签。

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

此命令不生成任何输出。

有关更多信息，请参阅《控制塔用户指南》中的 “关于AWS控制塔中的控件”。 AWS

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

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

AWS CLI

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

如果禁用了基准 “IdentityCenterBaseline”，则以下update-enabled-baseline示例会更新启用了 Cont AWS rol 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 基准

如果启用了基准 “IdentityCenterBaseline”，则以下update-enabled-baseline示例会更新启用了 Cont AWS rol 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"
}

有关更多信息，请参阅 Cont AWS rol Tower 用户指南中的基准类型。

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

AWS CLI

更新启用了 Control Tower 的控件

以下update-enabled-control示例更新了启用了 Cont AWS rol 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"
}

有关更多信息，请参阅《控制塔用户指南》中的 “关于AWS控制塔中的控件”。 AWS

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

AWS CLI

更新 Control Tower 着陆区

以下update-landing-zone示例更新了 Cont AWS rol 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"
}

有关更多信息，请参阅《AWS 控制塔用户指南》中的 Cont AWS rol Tower 入门。

  • 有关 API 的详细信息，请参阅AWS CLI 命令参考UpdateLandingZone中的。