View a markdown version of this page

Exemples d'organisations utilisant AWS CLI - AWS Exemples de code SDK
Actions

D'autres exemples de AWS SDK sont disponibles dans le référentiel AWS Doc SDK Examples GitHub .

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.

Exemples d'organisations utilisant AWS CLI

Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide de AWS Command Line Interface with Organizations.

Les actions sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.

Rubriques

Actions

L'exemple de code suivant montre comment utiliseraccept-handshake.

AWS CLI

Pour accepter l’établissement d’une liaison provenant d’un autre compte

Bill, le propriétaire d’une organisation, a déjà invité le compte de Juan à rejoindre son organisation. L’exemple suivant montre que le compte de Juan accepte l’établissement d’une liaison et accepte ainsi l’invitation.

aws organizations accept-handshake --handshake-id h-examplehandshakeid111

La sortie montre ce qui suit :

{
        "Handshake": {
                "Action": "INVITE",
                "Arn": "arn:aws:organizations::111111111111:handshake/o-exampleorgid/invite/h-examplehandshakeid111",
                "RequestedTimestamp": 1481656459.257,
                "ExpirationTimestamp": 1482952459.257,
                "Id": "h-examplehandshakeid111",
                "Parties": [
                        {
                                "Id": "o-exampleorgid",
                                "Type": "ORGANIZATION"
                        },
                        {
                                "Id": "juan@example.com",
                                "Type": "EMAIL"
                        }
                ],
                "Resources": [
                        {
                                "Resources": [
                                        {
                                                "Type": "MASTER_EMAIL",
                                                "Value": "bill@amazon.com"
                                        },
                                        {
                                                "Type": "MASTER_NAME",
                                                "Value": "Org Master Account"
                                        },
                                        {
                                                "Type": "ORGANIZATION_FEATURE_SET",
                                                "Value": "ALL"
                                        }
                                ],
                                "Type": "ORGANIZATION",
                                "Value": "o-exampleorgid"
                        },
                        {
                                "Type": "EMAIL",
                                "Value": "juan@example.com"
                        }
                ],
                "State": "ACCEPTED"
        }
}

  • Pour plus de détails sur l'API, consultez AcceptHandshake la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserattach-policy.

AWS CLI

Pour attacher une stratégie à une racine, une unité d’organisation ou un compte

Exemple 1

L’exemple suivant montre comment attacher une politique de contrôle des services (SCP) à une unité d’organisation :

aws organizations attach-policy
                --policy-id p-examplepolicyid111
                --target-id ou-examplerootid111-exampleouid111

Exemple 2

L’exemple suivant montre comment attacher une politique de contrôle des services directement à un compte :

aws organizations attach-policy
                --policy-id p-examplepolicyid111
                --target-id 333333333333

  • Pour plus de détails sur l'API, consultez AttachPolicy la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisercancel-handshake.

AWS CLI

Pour annuler l’établissement d’une liaison envoyé depuis un autre compte

Bill avait déjà envoyé une invitation sur le compte de Susan pour rejoindre son organisation. Il change d’avis et décide d’annuler l’invitation avant que Susan ne l’accepte. L’exemple suivant illustre l’annulation de Bill :

aws organizations cancel-handshake --handshake-id h-examplehandshakeid111

La sortie inclut un objet d’établissement de liaison qui indique que l’état est désormais CANCELED :

{
        "Handshake": {
                "Id": "h-examplehandshakeid111",
                "State":"CANCELED",
                "Action": "INVITE",
                "Arn": "arn:aws:organizations::111111111111:handshake/o-exampleorgid/invite/h-examplehandshakeid111",
                "Parties": [
                        {
                                "Id": "o-exampleorgid",
                                "Type": "ORGANIZATION"
                        },
                        {
                                "Id": "susan@example.com",
                                "Type": "EMAIL"
                        }
                ],
                "Resources": [
                        {
                                "Type": "ORGANIZATION",
                                "Value": "o-exampleorgid",
                                "Resources": [
                                        {
                                                "Type": "MASTER_EMAIL",
                                                "Value": "bill@example.com"
                                        },
                                        {
                                                "Type": "MASTER_NAME",
                                                "Value": "Master Account"
                                        },
                                        {
                                                "Type": "ORGANIZATION_FEATURE_SET",
                                                "Value": "CONSOLIDATED_BILLING"
                                        }
                                ]
                        },
                        {
                                "Type": "EMAIL",
                                "Value": "anika@example.com"
                        },
                        {
                                "Type": "NOTES",
                                "Value": "This is a request for Susan's account to join Bob's organization."
                        }
                ],
                "RequestedTimestamp": 1.47008383521E9,
                "ExpirationTimestamp": 1.47137983521E9
        }
}

  • Pour plus de détails sur l'API, consultez CancelHandshake la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisercreate-account.

AWS CLI

Pour créer un compte membre qui fait automatiquement partie de votre organisation

L’exemple suivant montre comment créer un compte membre dans une organisation. Le compte membre est configuré avec le nom Compte de production et l’adresse e-mail susan@example.com. Les organisations créent automatiquement un rôle IAM en utilisant le nom par défaut OrganizationAccountAccessRole car le paramètre RoleName n'est pas spécifié. En outre, le paramètre qui autorise les utilisateurs ou les rôles IAM disposant d'autorisations suffisantes à accéder aux données de facturation des comptes est défini sur la valeur par défaut ALLOW car le IamUserAccessToBilling paramètre n'est pas spécifié. Les organisations envoient automatiquement à Susan un e-mail AWS« Bienvenue à » :

aws organizations create-account --email susan@example.com --account-name "Production Account"

La sortie inclut un objet de demande qui indique que l’état est désormais IN_PROGRESS :

{
        "CreateAccountStatus": {
                "State": "IN_PROGRESS",
                "Id": "car-examplecreateaccountrequestid111"
        }
}

Vous pouvez ultérieurement interroger l’état actuel de la demande en fournissant la valeur de la réponse de l’Id à la commande describe-create-account-status comme valeur du paramètre create-account-request-id.

Pour plus d'informations, consultez la section Création d'un AWS compte dans votre organisation dans le Guide de l'utilisateur AWS des organisations.

  • Pour plus de détails sur l'API, consultez CreateAccount la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisercreate-organization.

AWS CLI

Exemple 1 : pour créer une organisation

Bill souhaite créer une organisation à l’aide des informations d’identification du compte 111111111111. L’exemple suivant montre que le compte devient le compte principal de la nouvelle organisation. Comme il ne spécifie aucun ensemble de fonctionnalités, la nouvelle organisation utilise par défaut toutes les fonctionnalités activées et les politiques de contrôle des services sont activées à la racine.

aws organizations create-organization

La sortie inclut un objet d’organisation contenant des détails sur la nouvelle organisation :

{
        "Organization": {
                "AvailablePolicyTypes": [
                        {
                                "Status": "ENABLED",
                                "Type": "SERVICE_CONTROL_POLICY"
                        }
                ],
                "MasterAccountId": "111111111111",
                "MasterAccountArn": "arn:aws:organizations::111111111111:account/o-exampleorgid/111111111111",
                "MasterAccountEmail": "bill@example.com",
                "FeatureSet": "ALL",
                "Id": "o-exampleorgid",
                "Arn": "arn:aws:organizations::111111111111:organization/o-exampleorgid"
        }
}

Exemple 2 : pour créer une organisation avec uniquement les fonctionnalités de facturation consolidée activées

L’exemple suivant crée une organisation qui prend uniquement en charge les fonctionnalités de facturation consolidée :

aws organizations create-organization --feature-set CONSOLIDATED_BILLING

La sortie inclut un objet d’organisation contenant des détails sur la nouvelle organisation :

{
        "Organization": {
                "Arn": "arn:aws:organizations::111111111111:organization/o-exampleorgid",
                "AvailablePolicyTypes": [],
                "Id": "o-exampleorgid",
                "MasterAccountArn": "arn:aws:organizations::111111111111:account/o-exampleorgid/111111111111",
                "MasterAccountEmail": "bill@example.com",
                "MasterAccountId": "111111111111",
                "FeatureSet": "CONSOLIDATED_BILLING"
        }
}

Pour plus d’informations, consultez Création d’une organisation dans le Guide de l’utilisateur AWS  Organizations.

  • Pour plus de détails sur l'API, consultez CreateOrganization la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisercreate-organizational-unit.

AWS CLI

Pour créer une unité d’organisation dans une unité d’organisation racine ou parente

L’exemple suivant montre comment créer une unité d’organisation nommée AccountingOU :

aws organizations create-organizational-unit --parent-id r-examplerootid111 --name AccountingOU

La sortie inclut un objet organizationalUnit contenant des détails sur la nouvelle unité d’organisation :

{
        "OrganizationalUnit": {
                "Id": "ou-examplerootid111-exampleouid111",
                "Arn": "arn:aws:organizations::111111111111:ou/o-exampleorgid/ou-examplerootid111-exampleouid111",
                "Name": "AccountingOU",
                "Path": "o-exampleorgid/r-examplerootid111/ou-examplerootid111-exampleouid111/"
        }
}

L'exemple de code suivant montre comment utilisercreate-policy.

AWS CLI

Exemple 1 : pour créer une politique avec un fichier source texte pour la politique JSON

L’exemple suivant vous montre comment créer une politique de contrôle des services (SCP) nommée AllowAllS3Actions. Le contenu de la politique est extrait d’un fichier sur l’ordinateur local appelé policy.json.

aws organizations create-policy --content file://policy.json --name AllowAllS3Actions, --type SERVICE_CONTROL_POLICY --description "Allows delegation of all S3 actions"

La sortie inclut un objet de politique contenant des informations sur la nouvelle politique :

{
        "Policy": {
                "Content": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Action\":[\"s3:*\"],\"Resource\":[\"*\"]}]}",
                "PolicySummary": {
                        "Arn": "arn:aws:organizations::o-exampleorgid:policy/service_control_policy/p-examplepolicyid111",
                        "Description": "Allows delegation of all S3 actions",
                        "Name": "AllowAllS3Actions",
                        "Type":"SERVICE_CONTROL_POLICY"
                }
        }
}

Exemple 2 : pour créer une politique avec une politique JSON en tant que paramètre

L’exemple suivant montre comment créer la même SCP, cette fois en intégrant le contenu de la politique sous forme de chaîne JSON dans le paramètre. La chaîne doit être échappée avec des barres obliques inversées avant les guillemets doubles pour qu’ils soient interprétés comme des caractères littéraux dans le paramètre, qui est lui-même entouré de guillemets doubles :

aws organizations create-policy --content "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Action\":[\"s3:*\"],\"Resource\":[\"*\"]}]}" --name AllowAllS3Actions --type SERVICE_CONTROL_POLICY --description "Allows delegation of all S3 actions"

Pour plus d’informations sur la création et l’utilisation de politiques dans votre organisation, consultez Gestion des stratégies d’organisation dans le Guide de l’utilisateur AWS  Organizations.

  • Pour plus de détails sur l'API, consultez CreatePolicy la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdecline-handshake.

AWS CLI

Pour refuser l’établissement d’une liaison envoyé depuis un autre compte

L’exemple suivant montre que Susan, une administratrice propriétaire du compte 222222222222, refuse une invitation à rejoindre l’organisation de Bill. L' DeclineHandshake opération renvoie un objet de poignée de main, indiquant que l'état est désormais REFUSÉ :

aws organizations decline-handshake --handshake-id h-examplehandshakeid111

La sortie inclut un objet d’établissement de liaison qui indique le nouvel état DECLINED :

{
        "Handshake": {
                "Id": "h-examplehandshakeid111",
                "State": "DECLINED",
                "Resources": [
                        {
                                "Type": "ORGANIZATION",
                                "Value": "o-exampleorgid",
                                "Resources": [
                                        {
                                                "Type": "MASTER_EMAIL",
                                                "Value": "bill@example.com"
                                        },
                                        {
                                                "Type": "MASTER_NAME",
                                                "Value": "Master Account"
                                        }
                                ]
                        },
                        {
                                "Type": "EMAIL",
                                "Value": "susan@example.com"
                        },
                        {
                                "Type": "NOTES",
                                "Value": "This is an invitation to Susan's account to join the Bill's organization."
                        }
                ],
                "Parties": [
                        {
                                "Type": "EMAIL",
                                "Id": "susan@example.com"
                        },
                        {
                                "Type": "ORGANIZATION",
                                "Id": "o-exampleorgid"
                        }
                ],
                "Action": "INVITE",
                "RequestedTimestamp": 1470684478.687,
                "ExpirationTimestamp": 1471980478.687,
                "Arn": "arn:aws:organizations::111111111111:handshake/o-exampleorgid/invite/h-examplehandshakeid111"
        }
}

  • Pour plus de détails sur l'API, consultez DeclineHandshake la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdelete-organization.

AWS CLI

Pour supprimer une organisation

L’exemple suivant montre comment supprimer une organisation. Pour effectuer cette opération, vous devez être administrateur du compte principal de l’organisation. L’exemple suppose que vous avez précédemment supprimé tous les comptes membres, les unités organisationnelles et les politiques de l’organisation :

aws organizations delete-organization

  • Pour plus de détails sur l'API, consultez DeleteOrganization la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdelete-organizational-unit.

AWS CLI

Pour supprimer une unité d’organisation

L’exemple suivant montre comment supprimer une unité d’organisation. L’exemple suppose que vous avez précédemment supprimé tous les comptes et d’autres unités d’organisation de l’unité d’organisation :

aws organizations delete-organizational-unit --organizational-unit-id ou-examplerootid111-exampleouid111

L'exemple de code suivant montre comment utiliserdelete-policy.

AWS CLI

Pour supprimer une politique

L’exemple suivant montre comment supprimer une stratégie d’une organisation. L’exemple suppose que vous avez préalablement détaché la stratégie de toutes les entités :

aws organizations delete-policy --policy-id p-examplepolicyid111

  • Pour plus de détails sur l'API, consultez DeletePolicy la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdescribe-account.

AWS CLI

Pour obtenir des détails sur un compte

L’exemple suivant montre comment demander des détails sur un compte :

aws organizations describe-account --account-id 555555555555

La sortie montre un objet de compte avec les détails du compte :

{
        "Account": {
                "Id": "555555555555",
                "Arn": "arn:aws:organizations::111111111111:account/o-exampleorgid/555555555555",
                "Name": "Beta account",
                "Email": "anika@example.com",
                "JoinedMethod": "INVITED",
                "JoinedTimeStamp": 1481756563.134,
                "Paths": [
                        "o-exampleorgid/r-examplerootid111/555555555555/"
                ],
                "State": "ACTIVE",
                "Status": "ACTIVE"
        }
}

  • Pour plus de détails sur l'API, consultez DescribeAccount la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdescribe-create-account-status.

AWS CLI

Pour connaître l’état le plus récent d’une demande de création de compte

L’exemple suivant montre comment demander le dernier statut d’une demande précédente de création de compte dans une organisation. Le --request-id spécifié provient de la réponse de l’appel initial à create-account. La demande de création de compte indique par le champ de statut que Organizations a terminé avec succès la création du compte.

Commande :

aws organizations describe-create-account-status --create-account-request-id car-examplecreateaccountrequestid111

Sortie :

{
  "CreateAccountStatus": {
    "State": "SUCCEEDED",
    "AccountId": "555555555555",
    "AccountName": "Beta account",
    "RequestedTimestamp": 1470684478.687,
    "CompletedTimestamp": 1470684532.472,
    "Id": "car-examplecreateaccountrequestid111"
  }
}

L'exemple de code suivant montre comment utiliserdescribe-handshake.

AWS CLI

Pour obtenir les informations sur l’établissement d’une liaison

L’exemple suivant vous montre comment demander des informations sur l’établissement d’une liaison. L’ID d’établissement de liaison provient soit de l’appel initial vers InviteAccountToOrganization, soit d’un appel vers ListHandshakesForAccount ou ListHandshakesForOrganization :

aws organizations describe-handshake --handshake-id h-examplehandshakeid111

La sortie inclut un objet d’établissement de liaison contenant toutes les informations sur l’établissement de liaison demandé :

{
        "Handshake": {
                "Id": "h-examplehandshakeid111",
                "State": "OPEN",
                "Resources": [
                        {
                                "Type": "ORGANIZATION",
                                "Value": "o-exampleorgid",
                                "Resources": [
                                        {
                                                "Type": "MASTER_EMAIL",
                                                "Value": "bill@example.com"
                                        },
                                        {
                                                "Type": "MASTER_NAME",
                                                "Value": "Master Account"
                                        }
                                ]
                        },
                        {
                                "Type": "EMAIL",
                                "Value": "anika@example.com"
                        }
                ],
                "Parties": [
                        {
                                "Type": "ORGANIZATION",
                                "Id": "o-exampleorgid"
                        },
                        {
                                "Type": "EMAIL",
                                "Id": "anika@example.com"
                        }
                ],
                "Action": "INVITE",
                "RequestedTimestamp": 1470158698.046,
                "ExpirationTimestamp": 1471454698.046,
                "Arn": "arn:aws:organizations::111111111111:handshake/o-exampleorgid/invite/h-examplehandshakeid111"
        }
}

  • Pour plus de détails sur l'API, consultez DescribeHandshake la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdescribe-organization.

AWS CLI

Pour obtenir les informations sur l’organisation actuelle

L’exemple suivant vous montre comment demander des informations sur une organisation :

aws organizations describe-organization

La sortie inclut un objet d’organisation contenant des informations sur l’organisation :

{
        "Organization": {
                "MasterAccountArn": "arn:aws:organizations::111111111111:account/o-exampleorgid/111111111111",
                "MasterAccountEmail": "bill@example.com",
                "MasterAccountId": "111111111111",
                "Id": "o-exampleorgid",
                "FeatureSet": "ALL",
                "Arn": "arn:aws:organizations::111111111111:organization/o-exampleorgid",
                "AvailablePolicyTypes": [
                        {
                                "Status": "ENABLED",
                                "Type": "SERVICE_CONTROL_POLICY"
                        }
                ]
        }
}

  • Pour plus de détails sur l'API, consultez DescribeOrganization la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdescribe-organizational-unit.

AWS CLI

Pour obtenir des informations sur une unité d’organisation

L’exemple describe-organizational-unit suivant demande des informations sur une unité d’organisation.

aws organizations describe-organizational-unit \
    --organizational-unit-id ou-examplerootid111-exampleouid111

Sortie :

{
    "OrganizationalUnit": {
        "Name": "Accounting Group",
        "Arn": "arn:aws:organizations::123456789012:ou/o-exampleorgid/ou-examplerootid111-exampleouid111",
        "Id": "ou-examplerootid111-exampleouid111",
        "Path": "o-exampleorgid/r-examplerootid111/ou-examplerootid111-exampleouid111/"
    }
}

L'exemple de code suivant montre comment utiliserdescribe-policy.

AWS CLI

Pour obtenir les informations sur une politique

L’exemple suivant montre comment demander des informations sur une politique :

aws organizations describe-policy --policy-id p-examplepolicyid111

La sortie inclut un objet de politique contenant des informations sur la politique :

{
        "Policy": {
                "Content": "{\n  \"Version\": \"2012-10-17\",\n  \"Statement\": [\n    {\n      \"Effect\": \"Allow\",\n      \"Action\": \"*\",\n      \"Resource\": \"*\"\n    }\n  ]\n}",
                "PolicySummary": {
                        "Arn": "arn:aws:organizations::111111111111:policy/o-exampleorgid/service_control_policy/p-examplepolicyid111",
                        "Type": "SERVICE_CONTROL_POLICY",
                        "Id": "p-examplepolicyid111",
                        "AwsManaged": false,
                        "Name": "AllowAllS3Actions",
                        "Description": "Enables admins to delegate S3 permissions"
                }
        }
}

  • Pour plus de détails sur l'API, consultez DescribePolicy la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdetach-policy.

AWS CLI

Pour détacher une stratégie d’une racine, d’une unité d’organisation ou d’un compte

L’exemple suivant indique comment détacher une politique d’une unité d’organisation :

aws organizations  detach-policy  --target-id ou-examplerootid111-exampleouid111 --policy-id p-examplepolicyid111

  • Pour plus de détails sur l'API, consultez DetachPolicy la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdisable-policy-type.

AWS CLI

Pour désactiver un type de politique dans une racine

L’exemple suivant montre comment désactiver le type de politique de contrôle des services (SCP) dans une racine :

aws organizations disable-policy-type --root-id r-examplerootid111 --policy-type SERVICE_CONTROL_POLICY

La sortie indique que l'élément de PolicyTypes réponse n'inclut plus SERVICE_CONTROL_POLICY :

{
        "Root": {
                "PolicyTypes": [],
                "Name": "Root",
                "Id": "r-examplerootid111",
                "Arn": "arn:aws:organizations::111111111111:root/o-exampleorgid/r-examplerootid111"
        }
}

  • Pour plus de détails sur l'API, consultez DisablePolicyType la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserenable-all-features.

AWS CLI

Pour demander toutes les fonctionnalités dans une organisation

Cet exemple montre l'administrateur demandant à tous les comptes invités de l'organisation d'approuver l'activation de toutes les fonctionnalités de l'organisation. AWS Les organisations envoient un e-mail à l'adresse associée à chaque compte de membre invité pour demander au propriétaire d'approuver la modification de toutes les fonctionnalités en acceptant la poignée de main envoyée. Une fois que tous les comptes membres invités ont accepté l’établissement d’une liaison, l’administrateur de l’organisation peut finaliser la modification de toutes les fonctionnalités, et ceux qui disposent des autorisations appropriées peuvent créer des politiques et les appliquer aux racines, aux unités d’organisation et aux comptes :

aws organizations enable-all-features

La sortie est un objet d’établissement de liaison qui est envoyé à tous les comptes membres invités pour approbation :

{
        "Handshake": {
                "Action": "ENABLE_ALL_FEATURES",
                "Arn":"arn:aws:organizations::111111111111:handshake/o-exampleorgid/enable_all_features/h-examplehandshakeid111",
                "ExpirationTimestamp":1.483127868609E9,
                "Id":"h-examplehandshakeid111",
                "Parties": [
                        {
                                "id":"o-exampleorgid",
                                "type":"ORGANIZATION"
                        }
                ],
                "requestedTimestamp":1.481831868609E9,
                "resources": [
                        {
                                "type":"ORGANIZATION",
                                "value":"o-exampleorgid"
                        }
                ],
                "state":"REQUESTED"
        }
}

  • Pour plus de détails sur l'API, consultez EnableAllFeatures la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserenable-policy-type.

AWS CLI

Pour activer l’utilisation d’un type de politique dans une racine

L’exemple suivant montre comment activer le type de politique de contrôle des services (SCP) dans une racine :

aws organizations enable-policy-type --root-id r-examplerootid111 --policy-type SERVICE_CONTROL_POLICY

La sortie montre un objet racine avec un élément de réponse policyTypes indiquant que les SCP sont désormais activées :

{
        "Root": {
                "PolicyTypes": [
                        {
                                "Status":"ENABLED",
                                "Type":"SERVICE_CONTROL_POLICY"
                        }
                ],
                "Id": "r-examplerootid111",
                "Name": "Root",
                "Arn": "arn:aws:organizations::111111111111:root/o-exampleorgid/r-examplerootid111"
        }
}

  • Pour plus de détails sur l'API, consultez EnablePolicyType la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserinvite-account-to-organization.

AWS CLI

Pour inviter un compte à rejoindre une organisation

L’exemple suivant montre le compte principal appartenant à bill@example.com invitant le compte appartenant à juan@example.com à rejoindre une organisation :

aws organizations invite-account-to-organization --target '{"Type": "EMAIL", "Id": "juan@example.com"}' --notes "This is a request for Juan's account to join Bill's organization."

La sortie inclut une structure d’établissement de liaison qui montre ce qui est envoyé au compte invité :

{
        "Handshake": {
                "Action": "INVITE",
                "Arn": "arn:aws:organizations::111111111111:handshake/o-exampleorgid/invite/h-examplehandshakeid111",
                "ExpirationTimestamp": 1482952459.257,
                "Id": "h-examplehandshakeid111",
                "Parties": [
                        {
                                "Id": "o-exampleorgid",
                                "Type": "ORGANIZATION"
                        },
                        {
                                "Id": "juan@example.com",
                                "Type": "EMAIL"
                        }
                ],
                "RequestedTimestamp": 1481656459.257,
                "Resources": [
                        {
                                "Resources": [
                                        {
                                                "Type": "MASTER_EMAIL",
                                                "Value": "bill@amazon.com"
                                        },
                                        {
                                                "Type": "MASTER_NAME",
                                                "Value": "Org Master Account"
                                        },
                                        {
                                                "Type": "ORGANIZATION_FEATURE_SET",
                                                "Value": "FULL"
                                        }
                                ],
                                "Type": "ORGANIZATION",
                                "Value": "o-exampleorgid"
                        },
                        {
                                "Type": "EMAIL",
                                "Value": "juan@example.com"
                        }
                ],
                "State": "OPEN"
        }
}

L'exemple de code suivant montre comment utiliserleave-organization.

AWS CLI

Pour quitter une organisation en tant que compte membre

L’exemple suivant montre l’administrateur d’un compte membre demandant à quitter l’organisation dont il est actuellement membre :

aws organizations leave-organization

  • Pour plus de détails sur l'API, consultez LeaveOrganization la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-accounts-for-parent.

AWS CLI

Pour extraire une liste de tous les comptes d’une racine parent ou d’une unité d’organisation spécifiée

L’exemple suivant montre comment demander une liste des comptes d’une unité d’organisation :

aws organizations list-accounts-for-parent --parent-id ou-examplerootid111-exampleouid111

La sortie comprend une liste d’objets de résumé de compte.

{
        "Accounts": [
                {
                        "Arn": "arn:aws:organizations::111111111111:account/o-exampleorgid/333333333333",
                        "JoinedMethod": "INVITED",
                        "JoinedTimestamp": 1481835795.536,
                        "Id": "333333333333",
                        "Name": "Development Account",
                        "Email": "juan@example.com",
                        "Paths": [
                                "o-exampleorgid/r-examplerootid111/111111111111/"
                        ],
                        "State": "ACTIVE",
                        "Status": "ACTIVE"
                },
                {
                        "Arn": "arn:aws:organizations::111111111111:account/o-exampleorgid/444444444444",
                        "JoinedMethod": "INVITED",
                        "JoinedTimestamp": 1481835812.143,
                        "Id": "444444444444",
                        "Name": "Test Account",
                        "Email": "anika@example.com",
                        "Paths": [
                                "o-exampleorgid/r-examplerootid111/111111111111/"
                        ],
                        "State": "ACTIVE",
                        "Status": "ACTIVE"
                }
        ]
}

L'exemple de code suivant montre comment utiliserlist-accounts.

AWS CLI

Pour extraire une liste de tous les comptes d’une organisation

L’exemple suivant vous montre comment demander une liste des comptes d’une organisation :

aws organizations list-accounts

La sortie comprend une liste d’objets de résumé de compte.

{
        "Accounts": [
                {
                        "Arn": "arn:aws:organizations::111111111111:account/o-exampleorgid/111111111111",
                        "JoinedMethod": "INVITED",
                        "JoinedTimestamp": 1481830215.45,
                        "Id": "111111111111",
                        "Name": "Master Account",
                        "Email": "bill@example.com",
                        "Paths": [
                                "o-exampleorgid/r-examplerootid111/111111111111/"
                        ],
                        "State": "ACTIVE",
                        "Status": "ACTIVE"
                },
                {
                        "Arn": "arn:aws:organizations::111111111111:account/o-exampleorgid/222222222222",
                        "JoinedMethod": "INVITED",
                        "JoinedTimestamp": 1481835741.044,
                        "Id": "222222222222",
                        "Name": "Production Account",
                        "Email": "alice@example.com",
                        "Paths": [
                                "o-exampleorgid/r-examplerootid111/111111111111/"
                        ],
                        "State": "ACTIVE",
                        "Status": "ACTIVE"
                },
                {
                        "Arn": "arn:aws:organizations::111111111111:account/o-exampleorgid/333333333333",
                        "JoinedMethod": "INVITED",
                        "JoinedTimestamp": 1481835795.536,
                        "Id": "333333333333",
                        "Name": "Development Account",
                        "Email": "juan@example.com",
                        "Paths": [
                                "o-exampleorgid/r-examplerootid111/111111111111/"
                        ],
                        "State": "ACTIVE",
                        "Status": "ACTIVE"
                },
                {
                        "Arn": "arn:aws:organizations::111111111111:account/o-exampleorgid/444444444444",
                        "JoinedMethod": "INVITED",
                        "JoinedTimestamp": 1481835812.143,
                        "Id": "444444444444",
                        "Name": "Test Account",
                        "Email": "anika@example.com",
                        "Paths": [
                                "o-exampleorgid/r-examplerootid111/111111111111/"
                        ],
                        "State": "ACTIVE",
                        "Status": "ACTIVE"
                }
        ]
}

  • Pour plus de détails sur l'API, consultez ListAccounts la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-children.

AWS CLI

Pour extraire les comptes enfants et les unités d’organisation d’une unité d’organisation parent ou racine

L’exemple suivant explique comment répertorier la racine ou l’unité d’organisation contenant ce compte 444444444444 :

aws organizations list-children --child-type ORGANIZATIONAL_UNIT --parent-id ou-examplerootid111-exampleouid111

La sortie montre les deux unités d’organisation enfants contenues par le parent :

{
        "Children": [
                {
                        "Id": "ou-examplerootid111-exampleouid111",
                        "Type":"ORGANIZATIONAL_UNIT"
                },
                {
                        "Id":"ou-examplerootid111-exampleouid222",
                        "Type":"ORGANIZATIONAL_UNIT"
                }
        ]
}

  • Pour plus de détails sur l'API, consultez ListChildren la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-create-account-status.

AWS CLI

Exemple 1 : pour extraire une liste des demandes de création de compte effectuées dans l’organisation actuelle

L’exemple suivant montre comment demander une liste des demandes de création de compte pour une organisation qui ont été traitées avec succès :

aws organizations list-create-account-status --states SUCCEEDED

La sortie inclut un ensemble d’objets contenant des informations sur chaque demande.

{
        "CreateAccountStatuses": [
                {
                        "AccountId": "444444444444",
                        "AccountName": "Developer Test Account",
                        "CompletedTimeStamp": 1481835812.143,
                        "Id": "car-examplecreateaccountrequestid111",
                        "RequestedTimeStamp": 1481829432.531,
                        "State": "SUCCEEDED"
                }
        ]
}

Exemple 2 : pour extraire une liste des demandes de création de compte en cours effectuées dans l’organisation actuelle

L’exemple suivant obtient la liste des demandes de création de compte en cours pour une organisation :

aws organizations list-create-account-status --states IN_PROGRESS

La sortie inclut un ensemble d’objets contenant des informations sur chaque demande.

{
        "CreateAccountStatuses": [
                {
                  "State": "IN_PROGRESS",
                  "Id": "car-examplecreateaccountrequestid111",
                  "RequestedTimeStamp": 1481829432.531,
                  "AccountName": "Production Account"
                }
        ]
}

L'exemple de code suivant montre comment utiliserlist-handshakes-for-account.

AWS CLI

Pour extraire une liste des établissements de liaison envoyés à un compte

L’exemple suivant montre comment obtenir une liste de tous les établissements de liaison associés au compte des informations d’identification qui ont été utilisés pour appeler l’opération :

aws organizations list-handshakes-for-account

La sortie inclut une liste de structures d’établissement de liaison avec des informations sur chaque établissement de liaison, y compris son état actuel :

{
        "Handshake": {
                "Action": "INVITE",
                "Arn": "arn:aws:organizations::111111111111:handshake/o-exampleorgid/invite/h-examplehandshakeid111",
                "ExpirationTimestamp": 1482952459.257,
                "Id": "h-examplehandshakeid111",
                "Parties": [
                        {
                                "Id": "o-exampleorgid",
                                "Type": "ORGANIZATION"
                        },
                        {
                                "Id": "juan@example.com",
                                "Type": "EMAIL"
                        }
                ],
                "RequestedTimestamp": 1481656459.257,
                "Resources": [
                        {
                                "Resources": [
                                        {
                                                "Type": "MASTER_EMAIL",
                                                "Value": "bill@amazon.com"
                                        },
                                        {
                                                "Type": "MASTER_NAME",
                                                "Value": "Org Master Account"
                                        },
                                        {
                                                "Type": "ORGANIZATION_FEATURE_SET",
                                                "Value": "FULL"
                                        }
                                ],
                                "Type": "ORGANIZATION",
                                "Value": "o-exampleorgid"
                        },
                        {
                                "Type": "EMAIL",
                                "Value": "juan@example.com"
                        }
                ],
                "State": "OPEN"
        }
}

L'exemple de code suivant montre comment utiliserlist-handshakes-for-organization.

AWS CLI

Pour extraire une liste des établissements de liaison associés à une organisation

L’exemple suivant montre comment obtenir une liste des établissements de liaison associés à l’organisation actuelle :

aws organizations list-handshakes-for-organization

La sortie montre deux établissements de liaison. Le premier est une invitation à accéder au compte de Juan et indique l’état OUVERT. La seconde est une invitation à accéder au compte d’Anika et indique l’état ACCEPTÉ :

{
        "Handshakes": [
                {
                        "Action": "INVITE",
                        "Arn": "arn:aws:organizations::111111111111:handshake/o-exampleorgid/invite/h-examplehandshakeid111",
                        "ExpirationTimestamp": 1482952459.257,
                        "Id": "h-examplehandshakeid111",
                        "Parties": [
                                {
                                        "Id": "o-exampleorgid",
                                        "Type": "ORGANIZATION"
                                },
                                {
                                        "Id": "juan@example.com",
                                        "Type": "EMAIL"
                                }
                        ],
                        "RequestedTimestamp": 1481656459.257,
                        "Resources": [
                                {
                                        "Resources": [
                                                {
                                                        "Type": "MASTER_EMAIL",
                                                        "Value": "bill@amazon.com"
                                                },
                                                {
                                                        "Type": "MASTER_NAME",
                                                        "Value": "Org Master Account"
                                                },
                                                {
                                                        "Type": "ORGANIZATION_FEATURE_SET",
                                                        "Value": "FULL"
                                                }
                                        ],
                                        "Type": "ORGANIZATION",
                                        "Value": "o-exampleorgid"
                                },
                                {
                                        "Type": "EMAIL",
                                        "Value": "juan@example.com"
                                },
                                {
                                        "Type":"NOTES",
                                        "Value":"This is an invitation to Juan's account to join Bill's organization."
                                }
                        ],
                        "State": "OPEN"
                },
                {
                        "Action": "INVITE",
                        "State":"ACCEPTED",
                        "Arn": "arn:aws:organizations::111111111111:handshake/o-exampleorgid/invite/h-examplehandshakeid111",
                        "ExpirationTimestamp": 1.471797437427E9,
                        "Id": "h-examplehandshakeid222",
                        "Parties": [
                                {
                                        "Id": "o-exampleorgid",
                                        "Type": "ORGANIZATION"
                                },
                                {
                                        "Id": "anika@example.com",
                                        "Type": "EMAIL"
                                }
                        ],
                        "RequestedTimestamp": 1.469205437427E9,
                        "Resources": [
                                {
                                        "Resources": [
                                                {
                                                        "Type":"MASTER_EMAIL",
                                                        "Value":"bill@example.com"
                                                },
                                                {
                                                        "Type":"MASTER_NAME",
                                                        "Value":"Master Account"
                                                }
                                        ],
                                        "Type":"ORGANIZATION",
                                        "Value":"o-exampleorgid"
                                },
                                {
                                        "Type":"EMAIL",
                                        "Value":"anika@example.com"
                                },
                                {
                                        "Type":"NOTES",
                                        "Value":"This is an invitation to Anika's account to join Bill's organization."
                                }
                        ]
                }
        ]
}

L'exemple de code suivant montre comment utiliserlist-organizational-units-for-parent.

AWS CLI

Pour extraire une liste des unités d’organisation d’une unité d’organisation parent ou racine

L’exemple suivant vous montre comment obtenir une liste des unités d’organisation dans une racine spécifiée :

aws organizations list-organizational-units-for-parent --parent-id r-examplerootid111

Le résultat indique que la racine spécifiée contient deux unités d’organisation et indique des informations sur chacune d’elles :

{
        "OrganizationalUnits": [
                {
                        "Name": "AccountingDepartment",
                        "Arn": "arn:aws:organizations::o-exampleorgid:ou/r-examplerootid111/ou-examplerootid111-exampleouid111",
                        "Id": "ou-examplerootid111-exampleouid111",
                        "Path": "o-exampleorgid/r-examplerootid111/ou-examplerootid111-exampleouid111/"
                },
                {
                        "Name": "ProductionDepartment",
                        "Arn": "arn:aws:organizations::o-exampleorgid:ou/r-examplerootid111/ou-examplerootid111-exampleouid222",
                        "Id": "ou-examplerootid111-exampleouid222",
                        "Path": "o-exampleorgid/r-examplerootid111/ou-examplerootid111-exampleouid222/"
                }
        ]
}

L'exemple de code suivant montre comment utiliserlist-parents.

AWS CLI

Pour répertorier les unités d’organisation parents ou racines d’un compte ou d’une unité d’organisation enfant

L’exemple suivant explique comment répertorier la racine ou l’unité d’organisation parent contenant ce compte 444444444444 :

aws organizations list-parents --child-id 444444444444

La sortie indique que le compte spécifié se trouve dans l’unité d’organisation avec l’ID spécifié :

{
  "Parents": [
        {
          "Id": "ou-examplerootid111-exampleouid111",
          "Type": "ORGANIZATIONAL_UNIT"
        }
  ]
}

  • Pour plus de détails sur l'API, consultez ListParents la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-policies-for-target.

AWS CLI

Pour extraire une liste des SCP attachées directement à un compte

L’exemple suivant montre comment obtenir une liste de toutes les politiques de contrôle des services (SCP), telles que spécifiées par le paramètre Filtrer, qui sont directement attachées à un compte :

aws organizations list-policies-for-target --filter SERVICE_CONTROL_POLICY --target-id 444444444444

La sortie inclut une liste de structures de politique avec des informations récapitulatives sur les politiques. La liste n’inclut pas les politiques qui s’appliquent au compte en raison de l’héritage provenant de son emplacement dans une hiérarchie des unités d’organisation :

{
        "Policies": [
                {
                        "Type": "SERVICE_CONTROL_POLICY",
                        "Name": "AllowAllEC2Actions",
                        "AwsManaged", false,
                        "Id": "p-examplepolicyid222",
                        "Arn": "arn:aws:organizations::o-exampleorgid:policy/service_control_policy/p-examplepolicyid222",
                        "Description": "Enables account admins to delegate permissions for any EC2 actions to users and roles in their accounts."
                }
        ]
}

L'exemple de code suivant montre comment utiliserlist-policies.

AWS CLI

Pour extraire une liste de toutes les politiques d’une organisation d’un certain type

L’exemple suivant vous montre comment obtenir une liste de SCP, telle que spécifiée par le paramètre de filtre :

aws organizations list-policies --filter SERVICE_CONTROL_POLICY

La sortie inclut une liste des politiques avec des informations récapitulatives :

{
        "Policies": [
                {
                        "Type": "SERVICE_CONTROL_POLICY",
                        "Name": "AllowAllS3Actions",
                        "AwsManaged": false,
                        "Id": "p-examplepolicyid111",
                        "Arn": "arn:aws:organizations::111111111111:policy/service_control_policy/p-examplepolicyid111",
                        "Description": "Enables account admins to delegate permissions for any S3 actions to users and roles in their accounts."
                },
                {
                        "Type": "SERVICE_CONTROL_POLICY",
                        "Name": "AllowAllEC2Actions",
                        "AwsManaged": false,
                        "Id": "p-examplepolicyid222",
                        "Arn": "arn:aws:organizations::111111111111:policy/service_control_policy/p-examplepolicyid222",
                        "Description": "Enables account admins to delegate permissions for any EC2 actions to users and roles in their accounts."
                },
                {
                        "AwsManaged": true,
                        "Description": "Allows access to every operation",
                        "Type": "SERVICE_CONTROL_POLICY",
                        "Id": "p-FullAWSAccess",
                        "Arn": "arn:aws:organizations::aws:policy/service_control_policy/p-FullAWSAccess",
                        "Name": "FullAWSAccess"
                }
        ]
}

  • Pour plus de détails sur l'API, consultez ListPolicies la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-roots.

AWS CLI

Pour extraire une liste des racines d’une organisation

Cet exemple vous montre comment obtenir la liste des racines d’une organisation :

aws organizations list-roots

La sortie inclut une liste des structures racines avec des informations récapitulatives :

{
        "Roots": [
                {
                        "Name": "Root",
                        "Arn": "arn:aws:organizations::111111111111:root/o-exampleorgid/r-examplerootid111",
                        "Id": "r-examplerootid111",
                        "PolicyTypes": [
                                {
                                        "Status":"ENABLED",
                                        "Type":"SERVICE_CONTROL_POLICY"
                                }
                        ]
                }
        ]
}

  • Pour plus de détails sur l'API, consultez ListRoots la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-targets-for-policy.

AWS CLI

Pour récupérer une liste des racines, unités d’organisation et comptes auxquels la politique est attachée

L’exemple suivant montre comment obtenir une liste des racines, des unités d’organisation et des comptes auxquels la politique spécifiée est attachée.

aws organizations list-targets-for-policy --policy-id p-FullAWSAccess

La sortie comprend une liste d’objets d’attachement avec des informations récapitulatives sur les racines, les unités d’organisation et les comptes auxquels la politique est attachée :

{
        "Targets": [
                {
                        "Arn": "arn:aws:organizations::111111111111:root/o-exampleorgid/r-examplerootid111",
                        "Name": "Root",
                        "TargetId":"r-examplerootid111",
                        "Type":"ROOT"
                },
                {
                        "Arn": "arn:aws:organizations::111111111111:account/o-exampleorgid/333333333333;",
                        "Name": "Developer Test Account",
                        "TargetId": "333333333333",
                        "Type": "ACCOUNT"
                },
                {
                        "Arn":"arn:aws:organizations::111111111111:ou/o-exampleorgid/ou-examplerootid111-exampleouid111",
                        "Name":"Accounting",
                        "TargetId":"ou-examplerootid111-exampleouid111",
                        "Type":"ORGANIZATIONAL_UNIT"
                }
        ]
}

  • Pour plus de détails sur l'API, consultez ListTargetsForPolicy la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisermove-account.

AWS CLI

Pour déplacer un compte entre des racines ou des unités d’organisation

L’exemple suivant montre comment déplacer le compte principal de l’organisation de la racine vers une unité d’organisation :

aws organizations move-account --account-id 333333333333 --source-parent-id r-examplerootid111 --destination-parent-id ou-examplerootid111-exampleouid111

  • Pour plus de détails sur l'API, consultez MoveAccount la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserremove-account-from-organization.

AWS CLI

Pour supprimer un compte d’une organisation en tant que compte principal

L’exemple suivant vous montre comment supprimer un compte d’une organisation :

aws organizations remove-account-from-organization --account-id 333333333333

L'exemple de code suivant montre comment utiliserupdate-organizational-unit.

AWS CLI

Pour renommer une unité d’organisation

Cet exemple vous montre comment renommer une unité d’organisation : dans cet exemple, l’unité d’organisation est renommée « AccountingOU » :

aws organizations update-organizational-unit --organizational-unit-id ou-examplerootid111-exampleouid111 --name AccountingOU

La sortie affiche le nouveau nom :

{
        "OrganizationalUnit": {
                "Id": "ou-examplerootid111-exampleouid111",
                "Name": "AccountingOU",
                "Arn": "arn:aws:organizations::111111111111:ou/o-exampleorgid/ou-examplerootid111-exampleouid111",
                "Path": "o-exampleorgid/r-examplerootid111/ou-examplerootid111-exampleouid111/"
        }
}

L'exemple de code suivant montre comment utiliserupdate-policy.

AWS CLI

Exemple 1 : pour renommer une politique

L’exemple update-policy suivant renomme une politique et lui donne une nouvelle description.

aws organizations update-policy \
    --policy-id p-examplepolicyid111 \
    --name Renamed-Policy \
    --description "This description replaces the original."

La sortie affiche le nouveau nom et la nouvelle description.

{
    "Policy": {
        "Content": "{\n  \"Version\":\"2012-10-17\",\n  \"Statement\":{\n    \"Effect\":\"Allow\",\n    \"Action\":\"ec2:*\",\n    \"Resource\":\"*\"\n  }\n}\n",
        "PolicySummary": {
            "Id": "p-examplepolicyid111",
            "AwsManaged": false,
            "Arn":"arn:aws:organizations::111111111111:policy/o-exampleorgid/service_control_policy/p-examplepolicyid111",
            "Description": "This description replaces the original.",
            "Name": "Renamed-Policy",
            "Type": "SERVICE_CONTROL_POLICY"
        }
    }
}

Exemple 2 : pour remplacer le contenu textuel JSON d’une politique

L’exemple suivant vous montre comment remplacer le texte JSON de la SCP dans l’exemple précédent par une nouvelle chaîne de texte de politique JSON qui autorise S3 au lieu d’EC2 :

aws organizations update-policy \
    --policy-id p-examplepolicyid111 \
    --content "{\"Version\":\"2012-10-17\",\"Statement\":{\"Effect\":\"Allow\",\"Action\":\"s3:*\",\"Resource\":\"*\"}}"

La sortie affiche le nouveau contenu :

{
    "Policy": {
        "Content": "{ \"Version\": \"2012-10-17\", \"Statement\": { \"Effect\": \"Allow\", \"Action\": \"s3:*\", \"Resource\": \"*\" } }",
        "PolicySummary": {
            "Arn": "arn:aws:organizations::111111111111:policy/o-exampleorgid/service_control_policy/p-examplepolicyid111",
            "AwsManaged": false;
            "Description": "This description replaces the original.",
            "Id": "p-examplepolicyid111",
            "Name": "Renamed-Policy",
            "Type": "SERVICE_CONTROL_POLICY"
        }
    }
}

  • Pour plus de détails sur l'API, consultez UpdatePolicy la section Référence des AWS CLI commandes.