Organizations: esempi che utilizzano AWS CLI

Come accettare un handshake da un altro account

Bill, il proprietario di un’organizzazione, ha invitato l’account di Juan a partecipare alla sua organizzazione. L’esempio seguente mostra l’account di Juan che accetta l’handshake e quindi l’invito.

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

L’output mostra quanto segue:

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

Come associare una policy a una root, un’unità organizzativa (UO) o un account

Esempio 1

L’esempio seguente mostra come collegare una policy di controllo dei servizi a un’unità organizzativa (UO):

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

Esempio 2

L’esempio seguente mostra come collegare una policy di controllo dei servizi direttamente a un account:

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

Come annullare un handshake inviato da un altro account

Bill ha inviato un invito all’account di Susan per partecipare alla sua organizzazione. Cambia idea e decide di annullare l’invito prima che Susan lo accetti. L’esempio seguente mostra l’annullamento di Bill:

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

L’output include un oggetto handshake che mostra che lo stato è 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
        }
}

Come creare un account membro automaticamente appartenente all’organizzazione

L’esempio seguente mostra come creare un account membro in un’organizzazione. L’account membro è configurato con il nome Production Account e l’indirizzo e-mail susan@example.com. Organizations crea automaticamente un ruolo IAM utilizzando il nome predefinito di OrganizationAccountAccessRole perché il parametro RoleName non è specificato. Inoltre, l'impostazione che consente agli utenti o ai ruoli IAM con autorizzazioni sufficienti di accedere ai dati di fatturazione dell'account è impostata sul valore predefinito di ALLOW perché il IamUserAccessToBilling parametro non è specificato. Organizations invia automaticamente a Susan un'e-mail di «Benvenuto a AWS»:

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

L’output include un oggetto richiesta che mostra che lo stato è IN_PROGRESS:

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

Successivamente è possibile interrogare lo stato corrente della richiesta fornendo il valore di risposta Id al describe-create-account-status comando come valore per il create-account-request-id parametro.

Per ulteriori informazioni, consulta Creare un AWS account nella tua organizzazione nella AWS Organizations Users Guide.

Esempio 1: come creare una nuova organizzazione

Bill desidera creare un’organizzazione utilizzando le credenziali dell’account 111111111111. L’esempio seguente mostra che l’account diventa l’account principale nella nuova organizzazione. Poiché non specifica un set di funzionalità, per impostazione predefinita la nuova organizzazione prevede che tutte le funzionalità siano abilitate e le policy di controllo del servizio siano abilitate nella root.

aws organizations create-organization

L’output include un oggetto organizzazione con dettagli sulla nuova organizzazione:

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

Esempio 2: come creare una nuova organizzazione solo con le funzionalità di fatturazione consolidata abilitate

L’esempio seguente crea un’organizzazione che supporta solo le funzionalità di fatturazione consolidata:

aws organizations create-organization --feature-set CONSOLIDATED_BILLING

L’output include un oggetto organizzazione con dettagli sulla nuova organizzazione:

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

Per ulteriori informazioni, consulta Creazione di un account nell’organizzazione nella Guida per l’utente di AWS Organizations.

Come creare un’unità organizzativa in un’unità organizzativa root o principale

L’esempio seguente mostra come creare un’unità organizzativa denominata AccountingOU:

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

L’output include un oggetto organizationalUnit con dettagli sulla nuova unità organizzativa:

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

Esempio 1: come creare una policy con un file di sorgente del testo per la policy JSON

L’esempio seguente mostra come creare una policy di controllo dei servizi denominata AllowAllS3Actions. Il contenuto della policy è tratto da un file presente sul computer locale chiamato policy.json.

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

L’output include un oggetto policy con dettagli sulla nuova policy:

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

Esempio 2: come creare una policy con una policy JSON come parametro

L’esempio seguente mostra come creare la stessa policy di controllo dei servizi, questa volta incorporando il contenuto della policy come stringa JSON nel parametro. La stringa deve essere preceduta da barre rovesciate come caratteri di escape prima delle virgolette doppie affinché queste ultime vengano considerate valori letterali del parametro, che a sua volta dovrà essere racchiuso tra virgolette doppie:

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"

Per ulteriori informazioni sulla creazione e l’utilizzo delle policy nell’organizzazione, consulta Gestione delle policy dell’organizzazione nella Guida per l’utente di AWS Organizations.

Come annullare un handshake inviato da un altro account

L’esempio seguente mostra che Susan, un’amministratrice proprietaria dell’account 222222222222, rifiuta un invito a partecipare all’organizzazione di Bill. L' DeclineHandshake operazione restituisce un oggetto handshake, a dimostrazione del fatto che lo stato è ora RIFIUTATO:

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

L’output include un oggetto handshake che mostra il nuovo stato 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"
        }
}

Come eliminare un’organizzazione

L’esempio seguente mostra come eliminare un’organizzazione. Per eseguire questa operazione, devi essere un amministratore dell’account principale dell’organizzazione. L'esempio presuppone che in precedenza siano stati rimossi tutti gli account dei membri e le politiche dall'organizzazione: OUs

aws organizations delete-organization

Come eliminare un’UO

L’esempio seguente mostra come eliminare un’UO. L'esempio presuppone che in precedenza siano stati rimossi tutti gli account e altri account OUs dall'unità organizzativa:

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

Come eliminare una policy

L’esempio seguente mostra come eliminare una policy da un’organizzazione. L’esempio presuppone che in precedenza la policy sia stata scollegata da tutte le entità:

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

Come ottenere i dettagli su un account

L’esempio seguente mostra come richiedere i dettagli relativi a un account:

aws organizations describe-account --account-id 555555555555

L’output mostra un oggetto account con i dettagli sull’account:

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

Come ottenere lo stato più recente di una richiesta per creare un account

L’esempio seguente mostra come richiedere lo stato più recente di una precedente richiesta per creare un account in un’organizzazione. L’identificatore --request-id specificato proviene dalla risposta della chiamata originale a create-account. La richiesta di creazione dell’account indica nel campo Stato che Organizations ha completato la creazione dell’account.

Comando:

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

Output:

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

Come ottenere informazioni su un handshake

L’esempio seguente mostra come richiedere i dettagli relativi a un handshake. L’ID dell’handshake proviene dalla chiamata originale a InviteAccountToOrganization o da una chiamata a ListHandshakesForAccount o ListHandshakesForOrganization:

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

L’output include un oggetto handshake che contiene tutti i dettagli sull’handshake richiesto:

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

Come ottenere informazioni sull’organizzazione corrente

L’esempio seguente mostra come richiedere i dettagli relativi a un’organizzazione:

aws organizations describe-organization

L’output include un oggetto organizzazione con dettagli sull’organizzazione:

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

Come ottenere informazioni su un’unità organizzativa

L’esempio describe-organizational-unit seguente richiede dettagli su un’unità organizzativa.

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

Output:

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

Come ottenere informazioni su una policy

L’esempio seguente mostra come richiedere informazioni su una policy:

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

L’output include un oggetto policy contenente i dettagli sulla policy:

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

Come scollegare una policy da una root, una UO o un account

L’esempio seguente mostra come scollegare una policy da un’unità organizzativa.

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

Come disabilitare un tipo di policy in una root

L’esempio seguente mostra come disabilitare il tipo di policy di controllo dei servizi in una root:

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

L'output mostra che l'elemento di PolicyTypes risposta non include più SERVICE_CONTROL_POLICY:

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

Come abilitare tutte le funzionalità in un’organizzazione

Questo esempio mostra l'amministratore che chiede a tutti gli account invitati dell'organizzazione di approvare l'attivazione di tutte le funzionalità dell'organizzazione. AWS Organizations invia un'e-mail all'indirizzo registrato con ogni account membro invitato chiedendo al proprietario di approvare la modifica a tutte le funzionalità accettando l'handshake che viene inviato. Dopo che tutti gli account dei membri invitati hanno accettato l'handshake, l'amministratore dell'organizzazione può finalizzare la modifica a tutte le funzionalità e chi dispone delle autorizzazioni appropriate può creare politiche e applicarle a root e account: OUs

aws organizations enable-all-features

L’output è un oggetto handshake che viene inviato a tutti gli account membro invitati per l’approvazione:

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

Come abilitare l’uso di un tipo di policy in una root

L’esempio seguente mostra come abilitare il tipo di policy di controllo dei servizi in una root:

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

L'output mostra un oggetto root con un elemento di risposta PolicyTypes che mostra che ora SCPs sono abilitati:

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

Come invitare un account a partecipare a un’organizzazione

L’esempio seguente mostra l’account master di proprietà di bill@example.com che invita l’account di proprietà di juan@example.com a partecipare a un’organizzazione:

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

L’output include una struttura handshake che mostra ciò che viene inviato all’account invitato:

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

Come lasciare un’organizzazione come account membro

L’esempio seguente mostra l’amministratore di un account membro che richiede di lasciare l’organizzazione di cui è attualmente membro:

aws organizations leave-organization

Come recuperare un elenco di tutti gli account in una root o un’unità organizzativa principale specificata

L’esempio seguente mostra come richiedere un elenco degli account in un’unità organizzativa:

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

L’output include un elenco di oggetti di riepilogo degli account.

{
        "Accounts": [
                {
                        "Arn": "arn:aws:organizations::111111111111:account/o-exampleorgid/333333333333",
                        "JoinedMethod": "INVITED",
                        "JoinedTimestamp": 1481835795.536,
                        "Id": "333333333333",
                        "Name": "Development Account",
                        "Email": "juan@example.com",
                        "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",
                        "Status": "ACTIVE"
                }
        ]
}

Come recuperare un elenco di tutti gli account di un’organizzazione

L’esempio seguente mostra come richiedere un elenco degli account in un’organizzazione:

aws organizations list-accounts

L’output include un elenco di oggetti di riepilogo degli account.

{
        "Accounts": [
                {
                        "Arn": "arn:aws:organizations::111111111111:account/o-exampleorgid/111111111111",
                        "JoinedMethod": "INVITED",
                        "JoinedTimestamp": 1481830215.45,
                        "Id": "111111111111",
                        "Name": "Master Account",
                        "Email": "bill@example.com",
                        "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",
                        "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",
                        "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",
                        "Status": "ACTIVE"
                }
        ]
}

Per recuperare gli account secondari e quelli OUs di un'unità organizzativa o root principale

L’esempio seguente illustra come elencare la root o l’unità organizzativa che contiene l’account 444444444444:

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

L'output mostra i due figli OUs contenuti dal genitore:

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

Esempio 1: come recuperare un elenco delle richieste di creazione di account effettuate nell’organizzazione corrente

L’esempio seguente mostra come richiedere un elenco di richieste di creazione di account che sono state completate per un’organizzazione:

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

L’output include una serie di oggetti con informazioni su ogni richiesta.

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

Esempio 2: come recuperare un elenco delle richieste di creazione di account in corso nell’organizzazione corrente

L’esempio seguente ottiene un elenco di richieste di creazione di account in corso per un’organizzazione:

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

L’output include una serie di oggetti con informazioni su ogni richiesta.

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

Come recuperare un elenco di handshake inviati a un account

L’esempio seguente mostra come ottenere un elenco di tutti gli handshake associati all’account delle credenziali utilizzate per chiamare l’operazione:

aws organizations list-handshakes-for-account

L’output include un elenco di strutture handshake con informazioni su ogni handshake, incluso lo stato corrente:

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

Come recuperare un elenco di handshake associati a un’organizzazione

L’esempio seguente mostra come ottenere un elenco di handshake associati all’organizzazione corrente:

aws organizations list-handshakes-for-organization

L’output mostra due handshake. Il primo è un invito all’account di Juan e mostra lo stato OPEN. Il secondo è un invito all’account di Anika e mostra lo stato ACCEPTED:

{
        "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."
                                }
                        ]
                }
        ]
}

Per recuperare un elenco di file OUs in un'unità organizzativa o root principale

L'esempio seguente mostra come ottenere un elenco di OUs in una radice specificata:

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

L'output mostra che la radice specificata ne contiene due OUs e mostra i dettagli di ciascuna:

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

Per elencare il genitore OUs o i root di un account o di un'unità organizzativa secondaria

L’esempio seguente illustra come elencare la root o l’unità organizzativa principale che contiene l’account 444444444444:

aws organizations list-parents --child-id 444444444444

L’output mostra che l’account specificato si trova nell’unità organizzativa con l’ID specificato:

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

Per recuperare un elenco degli SCPs allegati direttamente a un account

L'esempio seguente mostra come ottenere un elenco di tutte le politiche di controllo del servizio (SCPs), come specificato dal parametro Filter, che sono direttamente collegate a un account:

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

L’output include un elenco di strutture policy con informazioni di riepilogo sulle policy. L’elenco non include le policy che si applicano all’account a causa dell’ereditarietà dalla posizione in una gerarchia di unità organizzative:

{
        "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."
                }
        ]
}

Come recuperare un elenco di tutte le policy di un’organizzazione di un determinato tipo

L'esempio seguente mostra come ottenere un elenco di SCPs, come specificato dal parametro filter:

aws organizations list-policies --filter SERVICE_CONTROL_POLICY

L’output include un elenco di policy con informazioni di riepilogo:

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

Come recuperare un elenco delle root di un’organizzazione

L’esempio seguente mostra come ottenere l’elenco delle root per un’organizzazione:

aws organizations list-roots

L’output include un elenco di strutture root con informazioni di riepilogo:

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

Per recuperare un elenco delle radici e degli account a cui è associata una politica OUs

L'esempio seguente mostra come ottenere un elenco delle radici e degli account a cui è associata la politica specificata: OUs

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

L'output include un elenco di oggetti allegati con informazioni di riepilogo sulle radici e gli account a cui è associata la politica: OUs

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

Per spostare un account tra root o OUs

L’esempio seguente mostra come spostare l’account master dell’organizzazione dalla root a un’unità organizzativa:

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

Come rimuovere un account da un’organizzazione come account master

L’esempio seguente mostra come rimuovere un account da un’organizzazione:

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

Come rinominare un’unità organizzativa

Questo esempio mostra come rinominare un’unità organizzativa in “AccountingOU”:

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

L’output mostra il nuovo nome:

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

Esempio 1: come rinominare una policy

L’esempio update-policy seguente rinomina una policy e le fornisce una nuova descrizione.

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

L’output mostra il nuovo nome e la descrizione.

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

Esempio 2: come sostituire il contenuto di testo JSON di una policy

L'esempio seguente mostra come sostituire il testo JSON di SCP nell'esempio precedente con una nuova stringa di testo della policy JSON che consente S3 anziché: EC2

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

L’output mostra il nuovo contenuto:

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