Getting Started with Amazon AWS
AWS services or capabilities described in AWS documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon AWS.

AWS Developer Tools

Amazon AWS can be accessed programmatically using the AWS SDKs, the AWS Command Line Interface (CLI), and other AWS developer tools. The developer tools are designed to help you build and manage your Amazon AWS applications.

Important

Currently, the AWS developer tools are available only in English.

Please note the following Amazon AWS implementation particulars, which are potentially relevant to all services in the Beijing and Ningxia Regions.

  • To use services in the Beijing and Ningxia Regions, you need an account and credentials specific to the Beijing and Ningxia Regions. Accounts and credentials for other AWS Regions will not work for services operating in the Beijing and Ningxia Regions. Likewise, accounts and credentials for the Beijing and Ningxia Regions will not work for other AWS Regions.

  • There are two Availability Zones in the Beijing Region.

  • There are three Availability Zones in the Ningxia Region.

  • In AWS Identity and Access Management (IAM), you can grant or deny a service access to resources using the Principal policy element. Service principal values vary by Region.

  • The domain for both the Beijing and Ningxia Regions is amazonaws.cn.

  • The endpoints for services in the China (Beijing) Region and the China (Ningxia) Region are different from other global endpoints.

    • The endpoint domain for both the Beijing and Ningxia Regions is amazonaws.com.cn.

    • For an endpoint in the China (Beijing) Region, the Region value should be cn-north-1.

    • For an endpoint in the China (Ningxia) Region, the Region value should be cn-northwest-1.

    • For example, the endpoint for Elastic Load Balancing in the Beijing Region is elasticloadbalancing.cn-north-1.amazonaws.com.cn.

    Endpoint syntax varies from service to service. For more information, see China (Beijing), China (Ningxia), and the service-specific documentation.

  • In the China Regions, the Amazon Resource Name (ARN) syntax includes a cn.

    For example: arn:aws-cn:iam::123456789012:user/division_abc/subdivision_xyz/Bob.

  • The EC2-Classic platform is not supported.

  • AWS Marketplace is not supported.

  • The free usage tier is not available in the China Regions.

Note

The AWS documentation might show code examples for endpoints and ARNs that are not specific for the Beijing and Ningxia Regions. When using examples, verify you are using the correct endpoints and ARNs for your Region.

Language Options

Chinese is the default language for Amazon AWS documentation. To switch to the English version of the page, use the language selection dropdown at the top of the page. Note: Selecting a different language will update the language cookie, making it the default language.

Chinese-language URL syntax:
http://docs.amazonaws.cn/aws/latest/userguide/introduction.html
English-language URL syntax:
http://docs.amazonaws.cn/en_us/aws/latest/userguide/introduction.html

AWS SDKs

The AWS SDKs make it easy to work with AWS APIs in your preferred programming language or platform. The SDKs include sample code, libraries, documentation, templates, sample applications, and other developer tools related to your technology of choice.

To download the AWS SDKs, go to Tools for Amazon Web Services.

AWS Command Line Tools

Amazon Web Services (AWS) offers the AWS Command Line Interface (CLI), a single tool for controlling and managing multiple AWS services. For those who script in the Windows PowerShell environment, AWS also offers the AWS Tools for Windows PowerShell.

To download the AWS CLI or the PowerShell tools, go to Tools for Amazon Web Services.

Before the introduction of the AWS CLI, service-specific CLI tools were available. Some of the prior, service-specific CLIs are available in the China Regions. If a service-specific CLI is available, it can be downloaded from the appropriate service page. The service pages can be found at Documentation by Service.

IDE Toolkits

The AWS Toolkits provide specialized cloud tools integrated into your development environment. The AWS Toolkit for Eclipse is an open source plug-in for the Eclipse Java IDE that makes it easier to develop, debug, and deploy Java applications using Amazon Web Services. The AWS Toolkit for Visual Studio is an extension for Microsoft Visual Studio that helps you build, debug, and deploy .NET applications using AWS.

To download the IDE Toolkits, go to Tools for Amazon Web Services.