@aws-sdk/client-organizations 3.288.0 → 3.289.0

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

@@ -59,6 +59,63 @@ export interface AcceptHandshakeCommandOutput extends AcceptHandshakeResponse, _
  * @see {@link AcceptHandshakeCommandOutput} for command's `response` shape.
  * @see {@link OrganizationsClientResolvedConfig | config} for OrganizationsClient's `config` shape.
  *
+ * @example To accept a handshake from another account
+ * ```javascript
+ * // Bill is the owner of an organization, and he invites Juan's account (222222222222) to join his organization. The following example shows Juan's account accepting the handshake and thus agreeing to the invitation.
+ * const input = {
+ *   "HandshakeId": "h-examplehandshakeid111"
+ * };
+ * const command = new AcceptHandshakeCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Handshake": {
+ *     "Action": "INVITE",
+ *     "Arn": "arn:aws:organizations::111111111111:handshake/o-exampleorgid/invite/h-examplehandshakeid111",
+ *     "ExpirationTimestamp": "20170228T1215Z",
+ *     "Id": "h-examplehandshakeid111",
+ *     "Parties": [
+ *       {
+ *         "Id": "o-exampleorgid",
+ *         "Type": "ORGANIZATION"
+ *       },
+ *       {
+ *         "Id": "juan@example.com",
+ *         "Type": "EMAIL"
+ *       }
+ *     ],
+ *     "RequestedTimestamp": "20170214T1215Z",
+ *     "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": "ACCOUNT",
+ *         "Value": "222222222222"
+ *       }
+ *     ],
+ *     "State": "ACCEPTED"
+ *   }
+ * }
+ * *\/
+ * // example id: to-accept-a-handshake-from-another-account-1472500561150
+ * ```
+ *
  */
 export declare class AcceptHandshakeCommand extends $Command<AcceptHandshakeCommandInput, AcceptHandshakeCommandOutput, OrganizationsClientResolvedConfig> {
     readonly input: AcceptHandshakeCommandInput;

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

@@ -54,6 +54,32 @@ export interface AttachPolicyCommandOutput extends __MetadataBearer {
  * @see {@link AttachPolicyCommandOutput} for command's `response` shape.
  * @see {@link OrganizationsClientResolvedConfig | config} for OrganizationsClient's `config` shape.
  *
+ * @example To attach a policy to an OU
+ * ```javascript
+ * // The following example shows how to attach a service control policy (SCP) to an OU:
+ * //
+ * const input = {
+ *   "PolicyId": "p-examplepolicyid111",
+ *   "TargetId": "ou-examplerootid111-exampleouid111"
+ * };
+ * const command = new AttachPolicyCommand(input);
+ * await client.send(command);
+ * // example id: to-attach-a-policy-to-an-ou
+ * ```
+ *
+ * @example To attach a policy to an account
+ * ```javascript
+ * // The following example shows how to attach a service control policy (SCP) to an account:
+ * //
+ * const input = {
+ *   "PolicyId": "p-examplepolicyid111",
+ *   "TargetId": "333333333333"
+ * };
+ * const command = new AttachPolicyCommand(input);
+ * await client.send(command);
+ * // example id: to-attach-a-policy-to-an-account
+ * ```
+ *
  */
 export declare class AttachPolicyCommand extends $Command<AttachPolicyCommandInput, AttachPolicyCommandOutput, OrganizationsClientResolvedConfig> {
     readonly input: AttachPolicyCommandInput;

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

@@ -34,6 +34,68 @@ export interface CancelHandshakeCommandOutput extends CancelHandshakeResponse, _
  * @see {@link CancelHandshakeCommandOutput} for command's `response` shape.
  * @see {@link OrganizationsClientResolvedConfig | config} for OrganizationsClient's `config` shape.
  *
+ * @example To cancel a handshake sent to a member account
+ * ```javascript
+ * // Bill previously sent an invitation to Susan's account to join his organization. He changes his mind and decides to cancel the invitation before Susan accepts it. The following example shows Bill's cancellation:
+ * //
+ * const input = {
+ *   "HandshakeId": "h-examplehandshakeid111"
+ * };
+ * const command = new CancelHandshakeCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Handshake": {
+ *     "Action": "INVITE",
+ *     "Arn": "arn:aws:organizations::111111111111:handshake/o-exampleorgid/invite/h-examplehandshakeid111",
+ *     "ExpirationTimestamp": "20170228T1215Z",
+ *     "Id": "h-examplehandshakeid111",
+ *     "Parties": [
+ *       {
+ *         "Id": "o-exampleorgid",
+ *         "Type": "ORGANIZATION"
+ *       },
+ *       {
+ *         "Id": "susan@example.com",
+ *         "Type": "EMAIL"
+ *       }
+ *     ],
+ *     "RequestedTimestamp": "20170214T1215Z",
+ *     "Resources": [
+ *       {
+ *         "Resources": [
+ *           {
+ *             "Type": "MASTER_EMAIL",
+ *             "Value": "bill@example.com"
+ *           },
+ *           {
+ *             "Type": "MASTER_NAME",
+ *             "Value": "Master Account"
+ *           },
+ *           {
+ *             "Type": "ORGANIZATION_FEATURE_SET",
+ *             "Value": "CONSOLIDATED_BILLING"
+ *           }
+ *         ],
+ *         "Type": "ORGANIZATION",
+ *         "Value": "o-exampleorgid"
+ *       },
+ *       {
+ *         "Type": "ACCOUNT",
+ *         "Value": "222222222222"
+ *       },
+ *       {
+ *         "Type": "NOTES",
+ *         "Value": "This is a request for Susan's account to join Bob's organization."
+ *       }
+ *     ],
+ *     "State": "CANCELED"
+ *   }
+ * }
+ * *\/
+ * // example id: to-cancel-a-handshake-sent-to-a-member-account-1472501320506
+ * ```
+ *
  */
 export declare class CancelHandshakeCommand extends $Command<CancelHandshakeCommandInput, CancelHandshakeCommandOutput, OrganizationsClientResolvedConfig> {
     readonly input: CancelHandshakeCommandInput;

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

@@ -103,6 +103,28 @@ export interface CreateAccountCommandOutput extends CreateAccountResponse, __Met
  * @see {@link CreateAccountCommandOutput} for command's `response` shape.
  * @see {@link OrganizationsClientResolvedConfig | config} for OrganizationsClient's `config` shape.
  *
+ * @example To create a new account that is automatically part of the organization
+ * ```javascript
+ * // The owner of an organization creates a member account in the organization. The following example shows that when the organization owner creates the member account, the account is preconfigured with the name "Production Account" and an owner email address of susan@example.com.  An IAM role is automatically created using the default name because the roleName parameter is not used. AWS Organizations sends Susan a "Welcome to AWS" email:
+ * //
+ * //
+ * const input = {
+ *   "AccountName": "Production Account",
+ *   "Email": "susan@example.com"
+ * };
+ * const command = new CreateAccountCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "CreateAccountStatus": {
+ *     "Id": "car-examplecreateaccountrequestid111",
+ *     "State": "IN_PROGRESS"
+ *   }
+ * }
+ * *\/
+ * // example id: to-create-a-new-account-that-is-automatically-part-of-the-organization-1472501463507
+ * ```
+ *
  */
 export declare class CreateAccountCommand extends $Command<CreateAccountCommandInput, CreateAccountCommandOutput, OrganizationsClientResolvedConfig> {
     readonly input: CreateAccountCommandInput;

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

@@ -39,6 +39,61 @@ export interface CreateOrganizationCommandOutput extends CreateOrganizationRespo
  * @see {@link CreateOrganizationCommandOutput} for command's `response` shape.
  * @see {@link OrganizationsClientResolvedConfig | config} for OrganizationsClient's `config` shape.
  *
+ * @example To create a new organization with all features enabled
+ * ```javascript
+ * // Bill wants to create an organization using credentials from account 111111111111. The following example shows that the account becomes the master account in the new organization. Because he does not specify a feature set, the new organization defaults to all features enabled and service control policies enabled on the root:
+ * //
+ * //
+ * const input = {};
+ * const command = new CreateOrganizationCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Organization": {
+ *     "Arn": "arn:aws:organizations::111111111111:organization/o-exampleorgid",
+ *     "AvailablePolicyTypes": [
+ *       {
+ *         "Status": "ENABLED",
+ *         "Type": "SERVICE_CONTROL_POLICY"
+ *       }
+ *     ],
+ *     "FeatureSet": "ALL",
+ *     "Id": "o-exampleorgid",
+ *     "MasterAccountArn": "arn:aws:organizations::111111111111:account/o-exampleorgid/111111111111",
+ *     "MasterAccountEmail": "bill@example.com",
+ *     "MasterAccountId": "111111111111"
+ *   }
+ * }
+ * *\/
+ * // example id: to-create-a-new-organization-with-all-features enabled
+ * ```
+ *
+ * @example To create a new organization with consolidated billing features only
+ * ```javascript
+ * // In the following example, Bill creates an organization using credentials from account 111111111111, and configures the organization to support only the consolidated billing feature set:
+ * //
+ * //
+ * const input = {
+ *   "FeatureSet": "CONSOLIDATED_BILLING"
+ * };
+ * const command = new CreateOrganizationCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Organization": {
+ *     "Arn": "arn:aws:organizations::111111111111:organization/o-exampleorgid",
+ *     "AvailablePolicyTypes": [],
+ *     "FeatureSet": "CONSOLIDATED_BILLING",
+ *     "Id": "o-exampleorgid",
+ *     "MasterAccountArn": "arn:aws:organizations::111111111111:account/o-exampleorgid/111111111111",
+ *     "MasterAccountEmail": "bill@example.com",
+ *     "MasterAccountId": "111111111111"
+ *   }
+ * }
+ * *\/
+ * // example id: to-create-a-new-organization-with-consolidated-billing-features-only
+ * ```
+ *
  */
 export declare class CreateOrganizationCommand extends $Command<CreateOrganizationCommandInput, CreateOrganizationCommandOutput, OrganizationsClientResolvedConfig> {
     readonly input: CreateOrganizationCommandInput;

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

@@ -39,6 +39,29 @@ export interface CreateOrganizationalUnitCommandOutput extends CreateOrganizatio
  * @see {@link CreateOrganizationalUnitCommandOutput} for command's `response` shape.
  * @see {@link OrganizationsClientResolvedConfig | config} for OrganizationsClient's `config` shape.
  *
+ * @example To create a new organization unit
+ * ```javascript
+ * // The following example shows how to create an OU that is named AccountingOU. The new OU is directly under the root.:
+ * //
+ * //
+ * const input = {
+ *   "Name": "AccountingOU",
+ *   "ParentId": "r-examplerootid111"
+ * };
+ * const command = new CreateOrganizationalUnitCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "OrganizationalUnit": {
+ *     "Arn": "arn:aws:organizations::111111111111:ou/o-exampleorgid/ou-examplerootid111-exampleouid111",
+ *     "Id": "ou-examplerootid111-exampleouid111",
+ *     "Name": "AccountingOU"
+ *   }
+ * }
+ * *\/
+ * // example id: to-create-a-new-organizational-unit
+ * ```
+ *
  */
 export declare class CreateOrganizationalUnitCommand extends $Command<CreateOrganizationalUnitCommandInput, CreateOrganizationalUnitCommandOutput, OrganizationsClientResolvedConfig> {
     readonly input: CreateOrganizationalUnitCommandInput;

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

@@ -35,6 +35,35 @@ export interface CreatePolicyCommandOutput extends CreatePolicyResponse, __Metad
  * @see {@link CreatePolicyCommandOutput} for command's `response` shape.
  * @see {@link OrganizationsClientResolvedConfig | config} for OrganizationsClient's `config` shape.
  *
+ * @example To create a service control policy
+ * ```javascript
+ * // The following example shows how to create a service control policy (SCP) that is named AllowAllS3Actions. The JSON string in the content parameter specifies the content in the policy. The parameter string is escaped with backslashes to ensure that the embedded double quotes in the JSON policy are treated as literals in the parameter, which itself is surrounded by double quotes:
+ * //
+ * //
+ * const input = {
+ *   "Content": "{\\\"Version\\\":\\\"2012-10-17\\\",\\\"Statement\\\":{\\\"Effect\\\":\\\"Allow\\\",\\\"Action\\\":\\\"s3:*\\\"}}",
+ *   "Description": "Enables admins of attached accounts to delegate all S3 permissions",
+ *   "Name": "AllowAllS3Actions",
+ *   "Type": "SERVICE_CONTROL_POLICY"
+ * };
+ * const command = new CreatePolicyCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Policy": {
+ *     "Content": "{\"Version\":\"2012-10-17\",\"Statement\":{\"Effect\":\"Allow\",\"Action\":\"s3:*\"}}",
+ *     "PolicySummary": {
+ *       "Arn": "arn:aws:organizations::111111111111:policy/o-exampleorgid/service_control_policy/p-examplepolicyid111",
+ *       "Description": "Allows delegation of all S3 actions",
+ *       "Name": "AllowAllS3Actions",
+ *       "Type": "SERVICE_CONTROL_POLICY"
+ *     }
+ *   }
+ * }
+ * *\/
+ * // example id: to-create-a-service-control-policy
+ * ```
+ *
  */
 export declare class CreatePolicyCommand extends $Command<CreatePolicyCommandInput, CreatePolicyCommandOutput, OrganizationsClientResolvedConfig> {
     readonly input: CreatePolicyCommandInput;

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

@@ -35,6 +35,63 @@ export interface DeclineHandshakeCommandOutput extends DeclineHandshakeResponse,
  * @see {@link DeclineHandshakeCommandOutput} for command's `response` shape.
  * @see {@link OrganizationsClientResolvedConfig | config} for OrganizationsClient's `config` shape.
  *
+ * @example To decline a handshake sent from the master account
+ * ```javascript
+ * // The following example shows Susan declining an invitation to join Bill's organization. The DeclineHandshake operation returns a handshake object, showing that the state is now DECLINED:
+ * const input = {
+ *   "HandshakeId": "h-examplehandshakeid111"
+ * };
+ * const command = new DeclineHandshakeCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Handshake": {
+ *     "Action": "INVITE",
+ *     "Arn": "arn:aws:organizations::111111111111:handshake/o-exampleorgid/invite/h-examplehandshakeid111",
+ *     "ExpirationTimestamp": "2016-12-15T19:27:58Z",
+ *     "Id": "h-examplehandshakeid111",
+ *     "Parties": [
+ *       {
+ *         "Id": "222222222222",
+ *         "Type": "ACCOUNT"
+ *       },
+ *       {
+ *         "Id": "o-exampleorgid",
+ *         "Type": "ORGANIZATION"
+ *       }
+ *     ],
+ *     "RequestedTimestamp": "2016-11-30T19:27:58Z",
+ *     "Resources": [
+ *       {
+ *         "Resources": [
+ *           {
+ *             "Type": "MASTER_EMAIL",
+ *             "Value": "bill@example.com"
+ *           },
+ *           {
+ *             "Type": "MASTER_NAME",
+ *             "Value": "Master Account"
+ *           }
+ *         ],
+ *         "Type": "ORGANIZATION",
+ *         "Value": "o-exampleorgid"
+ *       },
+ *       {
+ *         "Type": "ACCOUNT",
+ *         "Value": "222222222222"
+ *       },
+ *       {
+ *         "Type": "NOTES",
+ *         "Value": "This is an invitation to Susan's account to join the Bill's organization."
+ *       }
+ *     ],
+ *     "State": "DECLINED"
+ *   }
+ * }
+ * *\/
+ * // example id: to-decline-a-handshake-sent-from-the-master-account-1472502666967
+ * ```
+ *
  */
 export declare class DeclineHandshakeCommand extends $Command<DeclineHandshakeCommandInput, DeclineHandshakeCommandOutput, OrganizationsClientResolvedConfig> {
     readonly input: DeclineHandshakeCommandInput;

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

@@ -31,6 +31,19 @@ export interface DeleteOrganizationalUnitCommandOutput extends __MetadataBearer
  * @see {@link DeleteOrganizationalUnitCommandOutput} for command's `response` shape.
  * @see {@link OrganizationsClientResolvedConfig | config} for OrganizationsClient's `config` shape.
  *
+ * @example To delete an organization unit
+ * ```javascript
+ * // The following example shows how to delete an OU. The example assumes that you previously removed all accounts and other OUs from the OU:
+ * //
+ * //
+ * const input = {
+ *   "OrganizationalUnitId": "ou-examplerootid111-exampleouid111"
+ * };
+ * const command = new DeleteOrganizationalUnitCommand(input);
+ * await client.send(command);
+ * // example id: to-delete-an-organizational-unit
+ * ```
+ *
  */
 export declare class DeleteOrganizationalUnitCommand extends $Command<DeleteOrganizationalUnitCommandInput, DeleteOrganizationalUnitCommandOutput, OrganizationsClientResolvedConfig> {
     readonly input: DeleteOrganizationalUnitCommandInput;

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

@@ -32,6 +32,19 @@ export interface DeletePolicyCommandOutput extends __MetadataBearer {
  * @see {@link DeletePolicyCommandOutput} for command's `response` shape.
  * @see {@link OrganizationsClientResolvedConfig | config} for OrganizationsClient's `config` shape.
  *
+ * @example To delete a policy
+ * ```javascript
+ * // The following example shows how to delete a policy from an organization. The example assumes that you previously detached the policy from all entities:
+ * //
+ * //
+ * const input = {
+ *   "PolicyId": "p-examplepolicyid111"
+ * };
+ * const command = new DeletePolicyCommand(input);
+ * await client.send(command);
+ * // example id: to-delete-a-policy
+ * ```
+ *
  */
 export declare class DeletePolicyCommand extends $Command<DeletePolicyCommandInput, DeletePolicyCommandOutput, OrganizationsClientResolvedConfig> {
     readonly input: DeletePolicyCommandInput;

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

@@ -31,6 +31,27 @@ export interface DescribeAccountCommandOutput extends DescribeAccountResponse, _
  * @see {@link DescribeAccountCommandOutput} for command's `response` shape.
  * @see {@link OrganizationsClientResolvedConfig | config} for OrganizationsClient's `config` shape.
  *
+ * @example To get the details about an account
+ * ```javascript
+ * // The following example shows a user in the master account (111111111111) asking for details about account 555555555555:
+ * const input = {
+ *   "AccountId": "555555555555"
+ * };
+ * const command = new DescribeAccountCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Account": {
+ *     "Arn": "arn:aws:organizations::111111111111:account/o-exampleorgid/555555555555",
+ *     "Email": "anika@example.com",
+ *     "Id": "555555555555",
+ *     "Name": "Beta Account"
+ *   }
+ * }
+ * *\/
+ * // example id: to-get-the-details-about-an-account-1472503166868
+ * ```
+ *
  */
 export declare class DescribeAccountCommand extends $Command<DescribeAccountCommandInput, DescribeAccountCommandOutput, OrganizationsClientResolvedConfig> {
     readonly input: DescribeAccountCommandInput;

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

@@ -31,6 +31,26 @@ export interface DescribeCreateAccountStatusCommandOutput extends DescribeCreate
  * @see {@link DescribeCreateAccountStatusCommandOutput} for command's `response` shape.
  * @see {@link OrganizationsClientResolvedConfig | config} for OrganizationsClient's `config` shape.
  *
+ * @example To get information about a request to create an account
+ * ```javascript
+ * // The following example shows how to request the status about a previous request to create an account in an organization. This operation can be called only by a principal from the organization's master account. In the example, the specified "createAccountRequestId" comes from the response of the original call to "CreateAccount":
+ * const input = {
+ *   "CreateAccountRequestId": "car-exampleaccountcreationrequestid"
+ * };
+ * const command = new DescribeCreateAccountStatusCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "CreateAccountStatus": {
+ *     "AccountId": "333333333333",
+ *     "Id": "car-exampleaccountcreationrequestid",
+ *     "State": "SUCCEEDED"
+ *   }
+ * }
+ * *\/
+ * // example id: to-get-information-about-a-request-to-create-an-account-1472503727223
+ * ```
+ *
  */
 export declare class DescribeCreateAccountStatusCommand extends $Command<DescribeCreateAccountStatusCommandInput, DescribeCreateAccountStatusCommandOutput, OrganizationsClientResolvedConfig> {
     readonly input: DescribeCreateAccountStatusCommandInput;

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

@@ -35,6 +35,59 @@ export interface DescribeHandshakeCommandOutput extends DescribeHandshakeRespons
  * @see {@link DescribeHandshakeCommandOutput} for command's `response` shape.
  * @see {@link OrganizationsClientResolvedConfig | config} for OrganizationsClient's `config` shape.
  *
+ * @example To get information about a handshake
+ * ```javascript
+ * // The following example shows you how to request details about a handshake. The handshake ID comes either from the original call to "InviteAccountToOrganization", or from a call to "ListHandshakesForAccount" or "ListHandshakesForOrganization":
+ * const input = {
+ *   "HandshakeId": "h-examplehandshakeid111"
+ * };
+ * const command = new DescribeHandshakeCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Handshake": {
+ *     "Action": "INVITE",
+ *     "Arn": "arn:aws:organizations::111111111111:handshake/o-exampleorgid/invite/h-examplehandshakeid111",
+ *     "ExpirationTimestamp": "2016-11-30T17:24:58.046Z",
+ *     "Id": "h-examplehandshakeid111",
+ *     "Parties": [
+ *       {
+ *         "Id": "o-exampleorgid",
+ *         "Type": "ORGANIZATION"
+ *       },
+ *       {
+ *         "Id": "333333333333",
+ *         "Type": "ACCOUNT"
+ *       }
+ *     ],
+ *     "RequestedTimestamp": "2016-11-30T17:24:58.046Z",
+ *     "Resources": [
+ *       {
+ *         "Resources": [
+ *           {
+ *             "Type": "MASTER_EMAIL",
+ *             "Value": "bill@example.com"
+ *           },
+ *           {
+ *             "Type": "MASTER_NAME",
+ *             "Value": "Master Account"
+ *           }
+ *         ],
+ *         "Type": "ORGANIZATION",
+ *         "Value": "o-exampleorgid"
+ *       },
+ *       {
+ *         "Type": "ACCOUNT",
+ *         "Value": "333333333333"
+ *       }
+ *     ],
+ *     "State": "OPEN"
+ *   }
+ * }
+ * *\/
+ * // example id: to-get-information-about-a-handshake-1472503400505
+ * ```
+ *
  */
 export declare class DescribeHandshakeCommand extends $Command<DescribeHandshakeCommandInput, DescribeHandshakeCommandOutput, OrganizationsClientResolvedConfig> {
     readonly input: DescribeHandshakeCommandInput;

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

@@ -36,6 +36,32 @@ export interface DescribeOrganizationCommandOutput extends DescribeOrganizationR
  * @see {@link DescribeOrganizationCommandOutput} for command's `response` shape.
  * @see {@link OrganizationsClientResolvedConfig | config} for OrganizationsClient's `config` shape.
  *
+ * @example To get information about an organization
+ * ```javascript
+ * // The following example shows how to request information about the current user's organization:/n/n
+ * const input = undefined;
+ * const command = new DescribeOrganizationCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Organization": {
+ *     "Arn": "arn:aws:organizations::111111111111:organization/o-exampleorgid",
+ *     "AvailablePolicyTypes": [
+ *       {
+ *         "Status": "ENABLED",
+ *         "Type": "SERVICE_CONTROL_POLICY"
+ *       }
+ *     ],
+ *     "FeatureSet": "ALL",
+ *     "Id": "o-exampleorgid",
+ *     "MasterAccountArn": "arn:aws:organizations::111111111111:account/o-exampleorgid/111111111111",
+ *     "MasterAccountEmail": "bill@example.com"
+ *   }
+ * }
+ * *\/
+ * // example id: to-get-information-about-an-organization-1472503400505
+ * ```
+ *
  */
 export declare class DescribeOrganizationCommand extends $Command<DescribeOrganizationCommandInput, DescribeOrganizationCommandOutput, OrganizationsClientResolvedConfig> {
     readonly input: DescribeOrganizationCommandInput;

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

@@ -31,6 +31,26 @@ export interface DescribeOrganizationalUnitCommandOutput extends DescribeOrganiz
  * @see {@link DescribeOrganizationalUnitCommandOutput} for command's `response` shape.
  * @see {@link OrganizationsClientResolvedConfig | config} for OrganizationsClient's `config` shape.
  *
+ * @example To get information about an organizational unit
+ * ```javascript
+ * // The following example shows how to request details about an OU:/n/n
+ * const input = {
+ *   "OrganizationalUnitId": "ou-examplerootid111-exampleouid111"
+ * };
+ * const command = new DescribeOrganizationalUnitCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "OrganizationalUnit": {
+ *     "Arn": "arn:aws:organizations::111111111111:ou/o-exampleorgid/ou-examplerootid111-exampleouid111",
+ *     "Id": "ou-examplerootid111-exampleouid111",
+ *     "Name": "Accounting Group"
+ *   }
+ * }
+ * *\/
+ * // example id: to-get-information-about-an-organizational-unit
+ * ```
+ *
  */
 export declare class DescribeOrganizationalUnitCommand extends $Command<DescribeOrganizationalUnitCommandInput, DescribeOrganizationalUnitCommandOutput, OrganizationsClientResolvedConfig> {
     readonly input: DescribeOrganizationalUnitCommandInput;

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

@@ -31,6 +31,32 @@ export interface DescribePolicyCommandOutput extends DescribePolicyResponse, __M
  * @see {@link DescribePolicyCommandOutput} for command's `response` shape.
  * @see {@link OrganizationsClientResolvedConfig | config} for OrganizationsClient's `config` shape.
  *
+ * @example To get information about a policy
+ * ```javascript
+ * // The following example shows how to request information about a policy:/n/n
+ * const input = {
+ *   "PolicyId": "p-examplepolicyid111"
+ * };
+ * const command = new DescribePolicyCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "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",
+ *       "AwsManaged": false,
+ *       "Description": "Enables admins to delegate S3 permissions",
+ *       "Id": "p-examplepolicyid111",
+ *       "Name": "AllowAllS3Actions",
+ *       "Type": "SERVICE_CONTROL_POLICY"
+ *     }
+ *   }
+ * }
+ * *\/
+ * // example id: to-get-information-about-a-policy
+ * ```
+ *
  */
 export declare class DescribePolicyCommand extends $Command<DescribePolicyCommandInput, DescribePolicyCommandOutput, OrganizationsClientResolvedConfig> {
     readonly input: DescribePolicyCommandInput;

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

@@ -43,6 +43,18 @@ export interface DetachPolicyCommandOutput extends __MetadataBearer {
  * @see {@link DetachPolicyCommandOutput} for command's `response` shape.
  * @see {@link OrganizationsClientResolvedConfig | config} for OrganizationsClient's `config` shape.
  *
+ * @example To detach a policy from a root, OU, or account
+ * ```javascript
+ * // The following example shows how to detach a policy from an OU:/n/n
+ * const input = {
+ *   "PolicyId": "p-examplepolicyid111",
+ *   "TargetId": "ou-examplerootid111-exampleouid111"
+ * };
+ * const command = new DetachPolicyCommand(input);
+ * await client.send(command);
+ * // example id: to-detach-a-policy-from-a-root-ou-or-account
+ * ```
+ *
  */
 export declare class DetachPolicyCommand extends $Command<DetachPolicyCommandInput, DetachPolicyCommandOutput, OrganizationsClientResolvedConfig> {
     readonly input: DetachPolicyCommandInput;