@aws-sdk/client-organizations 3.288.0 → 3.289.0

package/dist-types/commands/DisablePolicyTypeCommand.d.ts

@@ -39,6 +39,28 @@ export interface DisablePolicyTypeCommandOutput extends DisablePolicyTypeRespons
  * @see {@link DisablePolicyTypeCommandOutput} for command's `response` shape.
  * @see {@link OrganizationsClientResolvedConfig | config} for OrganizationsClient's `config` shape.
  *
+ * @example To disable a policy type in a root
+ * ```javascript
+ * // The following example shows how to disable the service control policy (SCP) policy type in a root. The response shows that the PolicyTypes response element no longer includes SERVICE_CONTROL_POLICY:/n/n
+ * const input = {
+ *   "PolicyType": "SERVICE_CONTROL_POLICY",
+ *   "RootId": "r-examplerootid111"
+ * };
+ * const command = new DisablePolicyTypeCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Root": {
+ *     "Arn": "arn:aws:organizations::111111111111:root/o-exampleorgid/r-examplerootid111",
+ *     "Id": "r-examplerootid111",
+ *     "Name": "Root",
+ *     "PolicyTypes": []
+ *   }
+ * }
+ * *\/
+ * // example id: to-disable-a-policy-type-in-a-root
+ * ```
+ *
  */
 export declare class DisablePolicyTypeCommand extends $Command<DisablePolicyTypeCommandInput, DisablePolicyTypeCommandOutput, OrganizationsClientResolvedConfig> {
     readonly input: DisablePolicyTypeCommandInput;

package/dist-types/commands/EnableAllFeaturesCommand.d.ts

@@ -54,6 +54,39 @@ export interface EnableAllFeaturesCommandOutput extends EnableAllFeaturesRespons
  * @see {@link EnableAllFeaturesCommandOutput} for command's `response` shape.
  * @see {@link OrganizationsClientResolvedConfig | config} for OrganizationsClient's `config` shape.
  *
+ * @example To enable all features in an organization
+ * ```javascript
+ * // This example shows the administrator asking all the invited accounts in the organization to approve enabling all features in the organization. AWS Organizations sends an email to the address that is registered with every invited member account asking the owner to approve the change by accepting the handshake that is sent. After all invited member accounts accept the handshake, the organization administrator can finalize the change to enable all features, and those with appropriate permissions can create policies and apply them to roots, OUs, and accounts:/n/n
+ * const input = {};
+ * const command = new EnableAllFeaturesCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Handshake": {
+ *     "Action": "ENABLE_ALL_FEATURES",
+ *     "Arn": "arn:aws:organizations::111111111111:handshake/o-exampleorgid/enable_all_features/h-examplehandshakeid111",
+ *     "ExpirationTimestamp": "2017-02-28T09:35:40.05Z",
+ *     "Id": "h-examplehandshakeid111",
+ *     "Parties": [
+ *       {
+ *         "Id": "o-exampleorgid",
+ *         "Type": "ORGANIZATION"
+ *       }
+ *     ],
+ *     "RequestedTimestamp": "2017-02-13T09:35:40.05Z",
+ *     "Resources": [
+ *       {
+ *         "Type": "ORGANIZATION",
+ *         "Value": "o-exampleorgid"
+ *       }
+ *     ],
+ *     "State": "REQUESTED"
+ *   }
+ * }
+ * *\/
+ * // example id: to-enable-all-features-in-an-organization
+ * ```
+ *
  */
 export declare class EnableAllFeaturesCommand extends $Command<EnableAllFeaturesCommandInput, EnableAllFeaturesCommandOutput, OrganizationsClientResolvedConfig> {
     readonly input: EnableAllFeaturesCommandInput;

package/dist-types/commands/EnablePolicyTypeCommand.d.ts

@@ -39,6 +39,33 @@ export interface EnablePolicyTypeCommandOutput extends EnablePolicyTypeResponse,
  * @see {@link EnablePolicyTypeCommandOutput} for command's `response` shape.
  * @see {@link OrganizationsClientResolvedConfig | config} for OrganizationsClient's `config` shape.
  *
+ * @example To enable a policy type in a root
+ * ```javascript
+ * // The following example shows how to enable the service control policy (SCP) policy type in a root. The output shows a root object with a PolicyTypes response element showing that SCPs are now enabled:/n/n
+ * const input = {
+ *   "PolicyType": "SERVICE_CONTROL_POLICY",
+ *   "RootId": "r-examplerootid111"
+ * };
+ * const command = new EnablePolicyTypeCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Root": {
+ *     "Arn": "arn:aws:organizations::111111111111:root/o-exampleorgid/r-examplerootid111",
+ *     "Id": "r-examplerootid111",
+ *     "Name": "Root",
+ *     "PolicyTypes": [
+ *       {
+ *         "Status": "ENABLED",
+ *         "Type": "SERVICE_CONTROL_POLICY"
+ *       }
+ *     ]
+ *   }
+ * }
+ * *\/
+ * // example id: to-enable-a-policy-type-in-a-root
+ * ```
+ *
  */
 export declare class EnablePolicyTypeCommand extends $Command<EnablePolicyTypeCommandInput, EnablePolicyTypeCommandOutput, OrganizationsClientResolvedConfig> {
     readonly input: EnablePolicyTypeCommandInput;

package/dist-types/commands/InviteAccountToOrganizationCommand.d.ts

@@ -54,6 +54,67 @@ export interface InviteAccountToOrganizationCommandOutput extends InviteAccountT
  * @see {@link InviteAccountToOrganizationCommandOutput} for command's `response` shape.
  * @see {@link OrganizationsClientResolvedConfig | config} for OrganizationsClient's `config` shape.
  *
+ * @example To invite an account to join an organization
+ * ```javascript
+ * // The following example shows the admin of the master account owned by bill@example.com inviting the account owned by juan@example.com to join an organization.
+ * const input = {
+ *   "Notes": "This is a request for Juan's account to join Bill's organization",
+ *   "Target": {
+ *     "Id": "juan@example.com",
+ *     "Type": "EMAIL"
+ *   }
+ * };
+ * const command = new InviteAccountToOrganizationCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Handshake": {
+ *     "Action": "INVITE",
+ *     "Arn": "arn:aws:organizations::111111111111:handshake/o-exampleorgid/invite/h-examplehandshakeid111",
+ *     "ExpirationTimestamp": "2017-02-16T09:36:05.02Z",
+ *     "Id": "h-examplehandshakeid111",
+ *     "Parties": [
+ *       {
+ *         "Id": "o-exampleorgid",
+ *         "Type": "ORGANIZATION"
+ *       },
+ *       {
+ *         "Id": "juan@example.com",
+ *         "Type": "EMAIL"
+ *       }
+ *     ],
+ *     "RequestedTimestamp": "2017-02-01T09:36:05.02Z",
+ *     "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"
+ *   }
+ * }
+ * *\/
+ * // example id: to-invite-an-account-to-join-an-organization-1472508594110
+ * ```
+ *
  */
 export declare class InviteAccountToOrganizationCommand extends $Command<InviteAccountToOrganizationCommandInput, InviteAccountToOrganizationCommandOutput, OrganizationsClientResolvedConfig> {
     readonly input: InviteAccountToOrganizationCommandInput;

package/dist-types/commands/LeaveOrganizationCommand.d.ts

@@ -92,6 +92,15 @@ export interface LeaveOrganizationCommandOutput extends __MetadataBearer {
  * @see {@link LeaveOrganizationCommandOutput} for command's `response` shape.
  * @see {@link OrganizationsClientResolvedConfig | config} for OrganizationsClient's `config` shape.
  *
+ * @example To leave an organization as a member account
+ * ```javascript
+ * // TThe following example shows how to remove your member account from an organization:
+ * const input = undefined;
+ * const command = new LeaveOrganizationCommand(input);
+ * await client.send(command);
+ * // example id: to-leave-an-organization-as-a-member-account-1472508784736
+ * ```
+ *
  */
 export declare class LeaveOrganizationCommand extends $Command<LeaveOrganizationCommandInput, LeaveOrganizationCommandOutput, OrganizationsClientResolvedConfig> {
     readonly input: LeaveOrganizationCommandInput;

package/dist-types/commands/ListAccountsCommand.d.ts

@@ -40,6 +40,57 @@ export interface ListAccountsCommandOutput extends ListAccountsResponse, __Metad
  * @see {@link ListAccountsCommandOutput} for command's `response` shape.
  * @see {@link OrganizationsClientResolvedConfig | config} for OrganizationsClient's `config` shape.
  *
+ * @example To retrieve a list of all of the accounts in an organization
+ * ```javascript
+ * // The following example shows you how to request a list of the accounts in an organization:
+ * const input = {};
+ * const command = new ListAccountsCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Accounts": [
+ *     {
+ *       "Arn": "arn:aws:organizations::111111111111:account/o-exampleorgid/111111111111",
+ *       "Email": "bill@example.com",
+ *       "Id": "111111111111",
+ *       "JoinedMethod": "INVITED",
+ *       "JoinedTimestamp": "20161215T193015Z",
+ *       "Name": "Master Account",
+ *       "Status": "ACTIVE"
+ *     },
+ *     {
+ *       "Arn": "arn:aws:organizations::111111111111:account/o-exampleorgid/222222222222",
+ *       "Email": "alice@example.com",
+ *       "Id": "222222222222",
+ *       "JoinedMethod": "INVITED",
+ *       "JoinedTimestamp": "20161215T210221Z",
+ *       "Name": "Developer Account",
+ *       "Status": "ACTIVE"
+ *     },
+ *     {
+ *       "Arn": "arn:aws:organizations::111111111111:account/o-exampleorgid/333333333333",
+ *       "Email": "juan@example.com",
+ *       "Id": "333333333333",
+ *       "JoinedMethod": "INVITED",
+ *       "JoinedTimestamp": "20161215T210347Z",
+ *       "Name": "Test Account",
+ *       "Status": "ACTIVE"
+ *     },
+ *     {
+ *       "Arn": "arn:aws:organizations::111111111111:account/o-exampleorgid/444444444444",
+ *       "Email": "anika@example.com",
+ *       "Id": "444444444444",
+ *       "JoinedMethod": "INVITED",
+ *       "JoinedTimestamp": "20161215T210332Z",
+ *       "Name": "Production Account",
+ *       "Status": "ACTIVE"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: to-retrieve-a-list-of-all-of-the-accounts-in-an-organization-1472509590974
+ * ```
+ *
  */
 export declare class ListAccountsCommand extends $Command<ListAccountsCommandInput, ListAccountsCommandOutput, OrganizationsClientResolvedConfig> {
     readonly input: ListAccountsCommandInput;

package/dist-types/commands/ListAccountsForParentCommand.d.ts

@@ -43,6 +43,41 @@ export interface ListAccountsForParentCommandOutput extends ListAccountsForParen
  * @see {@link ListAccountsForParentCommandOutput} for command's `response` shape.
  * @see {@link OrganizationsClientResolvedConfig | config} for OrganizationsClient's `config` shape.
  *
+ * @example To retrieve a list of all of the accounts in a root or OU
+ * ```javascript
+ * // The following example shows how to request a list of the accounts in an OU:/n/n
+ * const input = {
+ *   "ParentId": "ou-examplerootid111-exampleouid111"
+ * };
+ * const command = new ListAccountsForParentCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Accounts": [
+ *     {
+ *       "Arn": "arn:aws:organizations::111111111111:account/o-exampleorgid/333333333333",
+ *       "Email": "juan@example.com",
+ *       "Id": "333333333333",
+ *       "JoinedMethod": "INVITED",
+ *       "JoinedTimestamp": 1481835795.536,
+ *       "Name": "Development Account",
+ *       "Status": "ACTIVE"
+ *     },
+ *     {
+ *       "Arn": "arn:aws:organizations::111111111111:account/o-exampleorgid/444444444444",
+ *       "Email": "anika@example.com",
+ *       "Id": "444444444444",
+ *       "JoinedMethod": "INVITED",
+ *       "JoinedTimestamp": 1481835812.143,
+ *       "Name": "Test Account",
+ *       "Status": "ACTIVE"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: to-retrieve-a-list-of-all-of-the-accounts-in-a-root-or-ou-1472509590974
+ * ```
+ *
  */
 export declare class ListAccountsForParentCommand extends $Command<ListAccountsForParentCommandInput, ListAccountsForParentCommandOutput, OrganizationsClientResolvedConfig> {
     readonly input: ListAccountsForParentCommandInput;

package/dist-types/commands/ListChildrenCommand.d.ts

@@ -41,6 +41,32 @@ export interface ListChildrenCommandOutput extends ListChildrenResponse, __Metad
  * @see {@link ListChildrenCommandOutput} for command's `response` shape.
  * @see {@link OrganizationsClientResolvedConfig | config} for OrganizationsClient's `config` shape.
  *
+ * @example To retrieve a list of all of the child accounts and OUs in a parent root or OU
+ * ```javascript
+ * // The following example shows how to request a list of the child OUs in a parent root or OU:/n/n
+ * const input = {
+ *   "ChildType": "ORGANIZATIONAL_UNIT",
+ *   "ParentId": "ou-examplerootid111-exampleouid111"
+ * };
+ * const command = new ListChildrenCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Children": [
+ *     {
+ *       "Id": "ou-examplerootid111-exampleouid111",
+ *       "Type": "ORGANIZATIONAL_UNIT"
+ *     },
+ *     {
+ *       "Id": "ou-examplerootid111-exampleouid222",
+ *       "Type": "ORGANIZATIONAL_UNIT"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: to-retrieve-a-list-of-all-of-the-child-accounts-and-OUs-in-a-parent-container
+ * ```
+ *
  */
 export declare class ListChildrenCommand extends $Command<ListChildrenCommandInput, ListChildrenCommandOutput, OrganizationsClientResolvedConfig> {
     readonly input: ListChildrenCommandInput;

package/dist-types/commands/ListCreateAccountStatusCommand.d.ts

@@ -40,6 +40,58 @@ export interface ListCreateAccountStatusCommandOutput extends ListCreateAccountS
  * @see {@link ListCreateAccountStatusCommandOutput} for command's `response` shape.
  * @see {@link OrganizationsClientResolvedConfig | config} for OrganizationsClient's `config` shape.
  *
+ * @example To get a list of completed account creation requests made in the organization
+ * ```javascript
+ * // The following example shows a user requesting a list of only the completed account creation requests made for the current organization:
+ * const input = {
+ *   "States": [
+ *     "SUCCEEDED"
+ *   ]
+ * };
+ * const command = new ListCreateAccountStatusCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "CreateAccountStatuses": [
+ *     {
+ *       "AccountId": "444444444444",
+ *       "AccountName": "Developer Test Account",
+ *       "CompletedTimestamp": "2017-01-15T13:45:23.6Z",
+ *       "Id": "car-exampleaccountcreationrequestid1",
+ *       "RequestedTimestamp": "2017-01-15T13:45:23.01Z",
+ *       "State": "SUCCEEDED"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: to-get-a-list-of-completed-account-creation-requests-made-in-the-organization
+ * ```
+ *
+ * @example To get a list of all account creation requests made in the organization
+ * ```javascript
+ * // The following example shows a user requesting a list of only the in-progress account creation requests made for the current organization:
+ * const input = {
+ *   "States": [
+ *     "IN_PROGRESS"
+ *   ]
+ * };
+ * const command = new ListCreateAccountStatusCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "CreateAccountStatuses": [
+ *     {
+ *       "AccountName": "Production Account",
+ *       "Id": "car-exampleaccountcreationrequestid2",
+ *       "RequestedTimestamp": "2017-01-15T13:45:23.01Z",
+ *       "State": "IN_PROGRESS"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: to-get-a-list-of-all-account-creation-requests-made-in-the-organization-1472509174532
+ * ```
+ *
  */
 export declare class ListCreateAccountStatusCommand extends $Command<ListCreateAccountStatusCommandInput, ListCreateAccountStatusCommandOutput, OrganizationsClientResolvedConfig> {
     readonly input: ListCreateAccountStatusCommandInput;

package/dist-types/commands/ListHandshakesForAccountCommand.d.ts

@@ -43,6 +43,63 @@ export interface ListHandshakesForAccountCommandOutput extends ListHandshakesFor
  * @see {@link ListHandshakesForAccountCommandOutput} for command's `response` shape.
  * @see {@link OrganizationsClientResolvedConfig | config} for OrganizationsClient's `config` shape.
  *
+ * @example To retrieve a list of the handshakes sent to an account
+ * ```javascript
+ * // The following example shows you how to get a list of handshakes that are associated with the account of the credentials used to call the operation:
+ * const input = undefined;
+ * const command = new ListHandshakesForAccountCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Handshakes": [
+ *     {
+ *       "Action": "INVITE",
+ *       "Arn": "arn:aws:organizations::111111111111:handshake/o-exampleorgid/invite/h-examplehandshakeid111",
+ *       "ExpirationTimestamp": "2017-01-28T14:35:23.3Z",
+ *       "Id": "h-examplehandshakeid111",
+ *       "Parties": [
+ *         {
+ *           "Id": "o-exampleorgid",
+ *           "Type": "ORGANIZATION"
+ *         },
+ *         {
+ *           "Id": "juan@example.com",
+ *           "Type": "EMAIL"
+ *         }
+ *       ],
+ *       "RequestedTimestamp": "2017-01-13T14:35:23.3Z",
+ *       "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"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: to-retrieve-a-list-of-the-handshakes-sent-to-an-account-1472510214747
+ * ```
+ *
  */
 export declare class ListHandshakesForAccountCommand extends $Command<ListHandshakesForAccountCommandInput, ListHandshakesForAccountCommandOutput, OrganizationsClientResolvedConfig> {
     readonly input: ListHandshakesForAccountCommandInput;

package/dist-types/commands/ListHandshakesForOrganizationCommand.d.ts

@@ -46,6 +46,105 @@ export interface ListHandshakesForOrganizationCommandOutput extends ListHandshak
  * @see {@link ListHandshakesForOrganizationCommandOutput} for command's `response` shape.
  * @see {@link OrganizationsClientResolvedConfig | config} for OrganizationsClient's `config` shape.
  *
+ * @example To retrieve a list of the handshakes associated with an organization
+ * ```javascript
+ * // The following example shows you how to get a list of handshakes associated with the current organization:
+ * const input = undefined;
+ * const command = new ListHandshakesForOrganizationCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Handshakes": [
+ *     {
+ *       "Action": "INVITE",
+ *       "Arn": "arn:aws:organizations::111111111111:handshake/o-exampleorgid/invite/h-examplehandshakeid111",
+ *       "ExpirationTimestamp": "2017-01-28T14:35:23.3Z",
+ *       "Id": "h-examplehandshakeid111",
+ *       "Parties": [
+ *         {
+ *           "Id": "o-exampleorgid",
+ *           "Type": "ORGANIZATION"
+ *         },
+ *         {
+ *           "Id": "juan@example.com",
+ *           "Type": "EMAIL"
+ *         }
+ *       ],
+ *       "RequestedTimestamp": "2017-01-13T14:35:23.3Z",
+ *       "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"
+ *     },
+ *     {
+ *       "Action": "INVITE",
+ *       "Arn": "arn:aws:organizations::111111111111:handshake/o-exampleorgid/invite/h-examplehandshakeid111",
+ *       "ExpirationTimestamp": "2017-01-28T14:35:23.3Z",
+ *       "Id": "h-examplehandshakeid222",
+ *       "Parties": [
+ *         {
+ *           "Id": "o-exampleorgid",
+ *           "Type": "ORGANIZATION"
+ *         },
+ *         {
+ *           "Id": "anika@example.com",
+ *           "Type": "EMAIL"
+ *         }
+ *       ],
+ *       "RequestedTimestamp": "2017-01-13T14:35:23.3Z",
+ *       "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."
+ *         }
+ *       ],
+ *       "State": "ACCEPTED"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: to-retrieve-a-list-of-the-handshakes-associated-with-an-organization-1472511206653
+ * ```
+ *
  */
 export declare class ListHandshakesForOrganizationCommand extends $Command<ListHandshakesForOrganizationCommandInput, ListHandshakesForOrganizationCommandOutput, OrganizationsClientResolvedConfig> {
     readonly input: ListHandshakesForOrganizationCommandInput;

package/dist-types/commands/ListOrganizationalUnitsForParentCommand.d.ts

@@ -39,6 +39,33 @@ export interface ListOrganizationalUnitsForParentCommandOutput extends ListOrgan
  * @see {@link ListOrganizationalUnitsForParentCommandOutput} for command's `response` shape.
  * @see {@link OrganizationsClientResolvedConfig | config} for OrganizationsClient's `config` shape.
  *
+ * @example To retrieve a list of all of the child OUs in a parent root or OU
+ * ```javascript
+ * // The following example shows how to get a list of OUs in a specified root:/n/n
+ * const input = {
+ *   "ParentId": "r-examplerootid111"
+ * };
+ * const command = new ListOrganizationalUnitsForParentCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "OrganizationalUnits": [
+ *     {
+ *       "Arn": "arn:aws:organizations::111111111111:ou/o-exampleorgid/ou-examlerootid111-exampleouid111",
+ *       "Id": "ou-examplerootid111-exampleouid111",
+ *       "Name": "Development"
+ *     },
+ *     {
+ *       "Arn": "arn:aws:organizations::111111111111:ou/o-exampleorgid/ou-examlerootid111-exampleouid222",
+ *       "Id": "ou-examplerootid111-exampleouid222",
+ *       "Name": "Production"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: to-retrieve-a-list-of-all-of-the-OUs-in-a-parent-container
+ * ```
+ *
  */
 export declare class ListOrganizationalUnitsForParentCommand extends $Command<ListOrganizationalUnitsForParentCommandInput, ListOrganizationalUnitsForParentCommandOutput, OrganizationsClientResolvedConfig> {
     readonly input: ListOrganizationalUnitsForParentCommandInput;

package/dist-types/commands/ListParentsCommand.d.ts

@@ -44,6 +44,27 @@ export interface ListParentsCommandOutput extends ListParentsResponse, __Metadat
  * @see {@link ListParentsCommandOutput} for command's `response` shape.
  * @see {@link OrganizationsClientResolvedConfig | config} for OrganizationsClient's `config` shape.
  *
+ * @example To retrieve a list of all of the parents of a child OU or account
+ * ```javascript
+ * // The following example shows how to list the root or OUs that contain account 444444444444:/n/n
+ * const input = {
+ *   "ChildId": "444444444444"
+ * };
+ * const command = new ListParentsCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Parents": [
+ *     {
+ *       "Id": "ou-examplerootid111-exampleouid111",
+ *       "Type": "ORGANIZATIONAL_UNIT"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: to-retrieve-a-list-of-all-of-the-parents-of-a-child-ou-or-account
+ * ```
+ *
  */
 export declare class ListParentsCommand extends $Command<ListParentsCommandInput, ListParentsCommandOutput, OrganizationsClientResolvedConfig> {
     readonly input: ListParentsCommandInput;

package/dist-types/commands/ListPoliciesCommand.d.ts

@@ -39,6 +39,47 @@ export interface ListPoliciesCommandOutput extends ListPoliciesResponse, __Metad
  * @see {@link ListPoliciesCommandOutput} for command's `response` shape.
  * @see {@link OrganizationsClientResolvedConfig | config} for OrganizationsClient's `config` shape.
  *
+ * @example To retrieve a list policies in the organization
+ * ```javascript
+ * // The following example shows how to get a list of service control policies (SCPs):/n/n
+ * const input = {
+ *   "Filter": "SERVICE_CONTROL_POLICY"
+ * };
+ * const command = new ListPoliciesCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Policies": [
+ *     {
+ *       "Arn": "arn:aws:organizations::111111111111:policy/o-exampleorgid/service_control_policy/p-examplepolicyid111",
+ *       "AwsManaged": false,
+ *       "Description": "Enables account admins to delegate permissions for any S3 actions to users and roles in their accounts.",
+ *       "Id": "p-examplepolicyid111",
+ *       "Name": "AllowAllS3Actions",
+ *       "Type": "SERVICE_CONTROL_POLICY"
+ *     },
+ *     {
+ *       "Arn": "arn:aws:organizations::111111111111:policy/o-exampleorgid/service_control_policy/p-examplepolicyid222",
+ *       "AwsManaged": false,
+ *       "Description": "Enables account admins to delegate permissions for any EC2 actions to users and roles in their accounts.",
+ *       "Id": "p-examplepolicyid222",
+ *       "Name": "AllowAllEC2Actions",
+ *       "Type": "SERVICE_CONTROL_POLICY"
+ *     },
+ *     {
+ *       "Arn": "arn:aws:organizations::aws:policy/service_control_policy/p-FullAWSAccess",
+ *       "AwsManaged": true,
+ *       "Description": "Allows access to every operation",
+ *       "Id": "p-FullAWSAccess",
+ *       "Name": "FullAWSAccess",
+ *       "Type": "SERVICE_CONTROL_POLICY"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: to-retrieve-a-list-of--policies-in-the-organization
+ * ```
+ *
  */
 export declare class ListPoliciesCommand extends $Command<ListPoliciesCommandInput, ListPoliciesCommandOutput, OrganizationsClientResolvedConfig> {
     readonly input: ListPoliciesCommandInput;