翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
AWS Control Tower CreateLandingZone
API では、入力パラメータとしてランディングゾーンバージョンとランディングゾーンマニフェストファイルが必要です。ランディングゾーンマニフェストファイルを使用して、次の機能を設定できます。
マニフェストファイルをコンパイルすると、新しいランディングゾーンを作成する準備が整います。
ランディングゾーンマニフェストファイルに適用されるランディングゾーンスキーマの詳細については、「ランディングゾーンスキーマ」を参照してください。
注記
AWS Control Tower は、API を使用してランディングゾーンの設定と起動を行う場合に、リージョン拒否コントロールをサポートしません。API を使用してランディングゾーンを正常に起動した後で、AWS Control Tower コンソールを使用してリージョン拒否コントロールを設定できます。
-
AWS Control Tower の
CreateLandingZone
API を呼び出します。この API では、入力としてランディングゾーンバージョンとランディングゾーンマニフェストファイルが必要です。aws controltower create-landing-zone --landing-zone-version 3.3 --manifest "file://LandingZoneManifest.json"
次の例は、LandingZoneManifest.json マニフェストを示しています。マニフェストには、管理対象リージョンと集中ロギングの設定が含まれます。
{ "governedRegions": ["us-west-2","us-west-1"], "organizationStructure": { "security": { "name": "
CORE
" }, "sandbox": { "name": "Sandbox
" } }, "centralizedLogging": { "accountId": "222222222222
", "configurations": { "loggingBucket": { "retentionDays": 60 }, "accessLoggingBucket": { "retentionDays": 60 }, "kmsKeyArn": "arn:aws:kms:us-west-1:123456789123:key/e84XXXXX-6bXX-49XX-9eXX-ecfXXXXXXXXX
" }, "enabled": true }, "securityRoles": { "accountId": "333333333333
" }, "accessManagement": { "enabled": true } }注記
例に示すように、 アカウント
CentralizedLogging
とSecurityRoles
アカウントの AccountId は異なる必要があります。次の例は、LandingZoneManifest.json マニフェストファイルを示しています。このマニフェストファイルには、バックアップと集中ロギングの設定が含まれています。
{ "landingZoneIdentifier": "
LANDING ZONE ARN
", "manifest": { "accessManagement": { "enabled": true }, "securityRoles": { "accountId": "333333333333
" }, "backup": { "configurations": { "centralBackup": { "accountId": "CENTRAL BACKUP ACCOUNT ID
" }, "backupAdmin": { "accountId": "BACKUP MANAGER ACCOUNT ID
" }, "kmsKeyArn": "arn:aws:kms:us-west-1:123456789123:key/e84XXXXX-6bXX-49XX-9eXX-ecfXXXXXXXXX
" }, "enabled": true }, "governedRegions": [ "us-west-1" ], "organizationStructure": { "sandbox": { "name": "Sandbox" }, "security": { "name": "Security" } }, "centralizedLogging": { "accountId": "222222222222
", "configurations": { "loggingBucket": { "retentionDays": 365 }, "accessLoggingBucket": { "retentionDays": 3650 } }, "enabled": true } }, "version": "3.3" }出力:
{ "arn": "arn:aws:controltower:us-west-2:123456789012:landingzone/1A2B3C4D5E6F7G8H", "operationIdentifier": "55XXXXXX-e2XX-41XX-a7XX-446XXXXXXXXX" }
-
GetLandingZoneOperation
API を呼び出して、CreateLandingZone
オペレーションのステータスを確認します。GetLandingZoneOperation
API は、SUCCEEDED
、FAILED
、またはIN_PROGRESS
の ステータスを返します。aws controltower get-landing-zone-operation --operation-identifier "55XXXXXX-eXXX-4XXX-aXXX-44XXXXXXXXXX"
出力:
{ "operationDetails": { "operationType": "CREATE", "startTime": "Thu Nov 09 20:39:19 UTC 2023", "endTime": "Thu Nov 09 21:02:01 UTC 2023", "status": "SUCCEEDED" } }
-
ステータスが
SUCCEEDED
として返されたら、GetLandingZone
API を呼び出してランディングゾーンの設定を確認できます。aws controltower get-landing-zone --landing-zone-identifier "arn:aws:controltower:us-west-2:123456789123:landingzone/1A2B3C4D5E6F7G8H"
出力:
{ "landingZone": { "arn": "arn:aws:controltower:us-west-2:123456789012:landingzone/1A2B3C4D5E6F7G8H", "driftStatus": { "status": "IN_SYNC" }, "latestAvailableVersion": "3.3", "manifest": { "accessManagement": { "enabled": true }, "securityRoles": { "accountId": "333333333333" }, "governedRegions": [ "us-west-1", "eu-west-3", "us-west-2" ], "organizationStructure": { "sandbox": { "name": "Sandbox" }, "security": { "name": "Security" } }, "centralizedLogging": { "accountId": "222222222222", "configurations": { "loggingBucket": { "retentionDays": 60 }, "kmsKeyArn": "arn:aws:kms:us-west-1:123456789123:key/e84XXXXX-6bXX-49XX-9eXX-ecfXXXXXXXXX", "accessLoggingBucket": { "retentionDays": 60 } }, "enabled": true } }, "status": "PROCESSING", "version": "3.3" } }