Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Étape 2 : Lancez votre zone d'atterrissage à l'aide des API AWS Control Tower

Vous pouvez utiliser les API AWS Control Tower pour lancer votre zone d'atterrissage. Cette section explique comment créer le fichier manifeste de zone d'atterrissage requis et comment l'utiliser avec l'opération CreateLandingZone d'API.

Création du fichier manifeste

Le fichier manifeste est un document JSON qui spécifie la configuration de votre zone d'atterrissage. Avec la version 4.0 de Landing Zone, de nombreux composants sont désormais optionnels, ce qui permet un déploiement plus flexible.

Structure du manifeste

Vous trouverez ci-dessous la structure complète du fichier manifeste avec toutes les configurations disponibles :

{
    "accessManagement": {
        "enabled": true    // Required - Controls IAM Identity Center integration
    },
    "backup": {
        "enabled": true,   // Required - Controls AWS Backup integration
        "configurations": {
            "backupAdmin": {
                "accountId": "111122223333"    // Backup administrator account
            },
            "centralBackup": {
                "accountId": "111122224444"    // Central backup account
            },
            "kmsKeyArn": "arn:aws:kms:region:account-id:key/key-id"
        }
    },
    "centralizedLogging": {
        "accountId": "111122225555",    // Log archive account
        "enabled": true,                // Required - Controls centralized logging
        "configurations": {
            "accessLoggingBucket": {
                "retentionDays": 365    // Minimum value: 1
            },
            "loggingBucket": {
                "retentionDays": 365    // Minimum value: 1
            },
            "kmsKeyArn": "arn:aws:kms:region:account-id:key/key-id"
        }
    },
    "config": {
        "accountId": "111122226666",    // Config aggregator account
        "enabled": true,                // Required - Controls AWS Config integration
        "configurations": {
            "accessLoggingBucket": {
                "retentionDays": 365    // Minimum value: 1
            },
            "loggingBucket": {
                "retentionDays": 365    // Minimum value: 1
            },
            "kmsKeyArn": "arn:aws:kms:region:account-id:key/key-id"
        }
    },
    "governedRegions": [               // Optional - List of regions to govern
        "us-east-1",
        "us-west-2"
    ],
    "securityRoles": {
        "enabled": true,               // Required - Controls security roles creation
        "accountId": ""111122226666"    // Security/Audit account
    }
}
                    

Remarques importantes

Utilisation de l' CreateLandingZone API

Pour créer votre zone d'atterrissage à l'aide de l'API :

                    aws controltower create-landing-zone --landing-zone-version 4.0 --manifest file://manifest.json
                

L'API renverra un identifiant d'opération de zone d'atterrissage que vous pourrez utiliser pour suivre la progression de la création de votre zone d'atterrissage. Exemple de réponse :

{
    "arn": "arn:aws:controltower:us-west-2:123456789012:landingzone/1A2B3C4D5E6F7G8H",
    "operationIdentifier": "55XXXXXX-e2XX-41XX-a7XX-446XXXXXXXXX"
}
                

Vous pouvez surveiller l'état des opérations à l'aide de l'GetLandingZoneOperationAPI qui renvoie un état de SUCCEEDEDFAILED, ou IN_PROGRESS :

                    aws controltower get-landing-zone-operation --operation-identifier "55XXXXXX-eXXX-4XXX-aXXX-44XXXXXXXXXX"
                

Ce qui a changé dans la version 4.0 de Landing Zone

Changements importants apportés à la structure et aux exigences du manifeste :