/** *

Organizations is a web service that enables you to consolidate your multiple * Amazon Web Services accounts into an organization and centrally manage your * accounts and their resources.

*

This guide provides descriptions of the Organizations API. For more * information about using this service, see the Organizations User Guide.

*

* API version *

*

This version of the Organizations API Reference documents the Organizations API version * 2016-11-28.

* *

As an alternative to using the API directly, you can use one of the Amazon Web Services SDKs, * which consist of libraries and sample code for various programming languages and * platforms (Java, Ruby, .NET, iOS, Android, and more). The SDKs provide a convenient * way to create programmatic access to Organizations. For example, the SDKs take care of * cryptographically signing requests, managing errors, and retrying requests * automatically. For more information about the Amazon Web Services SDKs, including how to download * and install them, see Tools for Amazon Web * Services.

* *

We recommend that you use the Amazon Web Services SDKs to make programmatic API calls to Organizations. * However, you also can use the Organizations Query API to make direct calls to the Organizations web * service. To learn more about the Organizations Query API, see Calling the API by making HTTP Query * requests in the Organizations User Guide. Organizations supports GET and * POST requests for all actions. That is, the API doesn't require you to use GET for some * actions and POST for others. However, GET requests are subject to the limitation size of * a URL. Therefore, for operations that require larger sizes, use a POST request.

*

* Signing requests *

*

When you send HTTP requests to Amazon Web Services, sign the requests so that Amazon Web Services can identify * who sent them. You sign requests with your Amazon Web Services access key, which consists of an access * key ID and a secret access key. We strongly recommend that you don't create an access * key for your root account. Anyone who has the access key for your root account has * unrestricted access to all the resources in your account. Instead, create an access key * for an IAM user that has administrative permissions. As another option, use Amazon Web Services * Security Token Service (Amazon Web Services STS) to generate temporary security credentials, and use * those credentials to sign requests.

*

To sign requests, we recommend that you use Signature Version 4. If you * have an existing application that uses Signature Version 2, you don't have to update it * to use Signature Version 4. However, some operations now require Signature Version 4. * The documentation for operations that require version 4 indicate this * requirement.

*

When you use the Command Line Interface (CLI) or one of the Amazon Web Services SDKs to make requests to * Amazon Web Services, these tools automatically sign the requests for you with the access key that you * specify when you configure the tools.

*

In this release, each organization can have only one root.

*

* Support and feedback for Organizations *

*

We welcome your feedback. You can post your feedback and questions in the Organizations support * forum. For more information about the Amazon Web Services Support forums, see Forums Help.

*

* Endpoint to call When using the CLI or the Amazon Web Services * SDK *

*

For the current release of Organizations, specify the us-east-1 region * for all Amazon Web Services API and CLI calls made from the commercial Amazon Web Services Regions outside of * China. If calling from one of the Amazon Web Services Regions in China, then specify * cn-northwest-1. You can do this in the CLI by using these parameters * and commands:

* *

* How examples are presented *

*

The JSON returned by the Organizations service as response to your requests arrives as a * single long string without line breaks or formatting whitespace. The examples in this * guide include both line breaks and whitespace to improve readability. When example input * parameters also would result in long strings that would extend beyond the screen, we * insert line breaks to enhance readability. Always submit the input as a single JSON text * string.

*

* Recording API Requests *

*

Organizations supports CloudTrail, a service that records Amazon Web Services API calls for your * Amazon Web Services account and delivers log files to an Amazon S3 bucket. By using information collected * by CloudTrail, you can determine which requests the Organizations service received, who made the * request and when, and so on. For more about Organizations and its support for CloudTrail, see * Logging * Organizations API calls with CloudTrail in the * Organizations User Guide. To learn more about CloudTrail, including how to turn it * on and find your log files, see the CloudTrail User Guide.

* * @packageDocumentation */ export * from "./OrganizationsClient"; export * from "./Organizations"; export type { ClientInputEndpointParameters } from "./endpoint/EndpointParameters"; export type { RuntimeExtension } from "./runtimeExtensions"; export type { OrganizationsExtensionConfiguration } from "./extensionConfiguration"; export * from "./commands"; export { Command as $Command } from "@smithy/core/client"; export * from "./pagination"; export * from "./schemas/schemas_0"; export * from "./models/enums"; export * from "./models/errors"; export * from "./models/models_0"; export { OrganizationsServiceException } from "./models/OrganizationsServiceException";