本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 什么是 AWS 云端控制 API？
<a name="what-is-cloudcontrolapi"></a>

 AWS 云端控制 API 用于创建、读取、更新、删除和列出 (CRUD-L) 属于 AWS 第三方服务的云资源。借助 Cloud Control API 标准化的一组应用程序编程接口 (APIs)，您可以对中任何支持的资源执行 CRUD-L 操作。 AWS 账户使用 Cloud Control API，您无需生成特定于对这些资源负责的每个单独服务的代码或脚本。

**Topics**
+ [您是首次接触 Cloud Control API 的用户吗？](#first-time-user)
+ [Cloud Control API 的功能](#cloudcontrolapi-feature-overview)
+ [相关服务](#related-services)
+ [访问 Cloud Control API](#accessing-cloudcontrolapi)
+ [Cloud Control API 的工作原理](how-it-works.md)

## 您是首次接触 Cloud Control API 的用户吗？
<a name="first-time-user"></a>

如果您是首次接触 Cloud Control API 的用户，我们建议您先阅读以下部分：
+ [设置 AWS 云端控制 API](setting-up.md)
+ [开始使用 Cloud Control API](getting-started.md)

## Cloud Control API 的功能
<a name="cloudcontrolapi-feature-overview"></a>

Cloud Control API 通过提供访问和配置这些资源的标准化方式，使您能够一致地控制 AWS 账户中的资源。它提供了一个统一的编程接口，无需熟悉底层 Web 服务，即可直接调用 AWS 账户中可用的各种资源类型。 APIs 

## 相关服务
<a name="related-services"></a>

与 Cloud Control API 类似，当您在账户中发出此类请求时， AWS CloudFormation 也使用资源类型 APIs 来调用底层 Web 服务来配置这些资源。但是，通过将基础设施视为代码，将 CloudFormation 重点放在提供资源管理上。使用 CloudFormation，您可以创作包含多个资源及其依赖关系的声明性模板，然后将这些资源配置为*堆栈*。堆栈是您随后通过它进行管理的单个单元 CloudFormation。您还可以跨多个和集中管理和配置堆栈 AWS 账户 。 AWS 区域要通过进行管理 CloudFormation，必须将资源作为堆栈的一部分创建或导入到堆栈中。有关更多信息，请参阅 *AWS CloudFormation 用户指南*。[https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html)

## 访问 Cloud Control API
<a name="accessing-cloudcontrolapi"></a>

除了跟踪和管理这些请求外，Cloud Control API 还提供用于生成创建、读取、更新、删除和列出 (CRUD-L) 资源请求的 API 操作。您可以使用 AWS Command Line Interface (AWS CLI) 来执行 Cloud Control API 操作。

下表显示了可用于生成 CRUD-L 资源请求的 Cloud Control API 操作。


| API 操作 | AWS CLI 命令 | 
| --- | --- | 
|  [https://docs.aws.amazon.com/cloudcontrolapi/latest/APIReference/API_CreateResource.html](https://docs.aws.amazon.com/cloudcontrolapi/latest/APIReference/API_CreateResource.html)  |  [https://docs.aws.amazon.com/cli/latest/reference/cloudcontrol/create-resource.html](https://docs.aws.amazon.com/cli/latest/reference/cloudcontrol/create-resource.html)  | 
|  [https://docs.aws.amazon.com/cloudcontrolapi/latest/APIReference/API_DeleteResource.html](https://docs.aws.amazon.com/cloudcontrolapi/latest/APIReference/API_DeleteResource.html)  |  [https://docs.aws.amazon.com/cli/latest/reference/cloudcontrol/delete-resource.html](https://docs.aws.amazon.com/cli/latest/reference/cloudcontrol/delete-resource.html)  | 
|  [https://docs.aws.amazon.com/cloudcontrolapi/latest/APIReference/API_GetResource.html](https://docs.aws.amazon.com/cloudcontrolapi/latest/APIReference/API_GetResource.html)  |  [https://docs.aws.amazon.com/cli/latest/reference/cloudcontrol/get-resource.html](https://docs.aws.amazon.com/cli/latest/reference/cloudcontrol/get-resource.html)  | 
|  [https://docs.aws.amazon.com/cloudcontrolapi/latest/APIReference/API_ListResources.html](https://docs.aws.amazon.com/cloudcontrolapi/latest/APIReference/API_ListResources.html)  |  [https://docs.aws.amazon.com/cli/latest/reference/cloudcontrol/list-resources.html](https://docs.aws.amazon.com/cli/latest/reference/cloudcontrol/list-resources.html)  | 
|  [https://docs.aws.amazon.com/cloudcontrolapi/latest/APIReference/API_UpdateResource.html](https://docs.aws.amazon.com/cloudcontrolapi/latest/APIReference/API_UpdateResource.html)  |  [https://docs.aws.amazon.com/cli/latest/reference/cloudcontrol/update-resource.html](https://docs.aws.amazon.com/cli/latest/reference/cloudcontrol/update-resource.html)  | 

下表显示了可用于跟踪和管理正在处理的资源请求的 Cloud Control API 操作。


| API 操作 | AWS CLI 命令 | 
| --- | --- | 
|  [CancelResourceRequest](https://docs.aws.amazon.com/cloudcontrolapi/latest/APIReference/API_CancelResourceRequest.html)  |  [https://docs.aws.amazon.com/cli/latest/reference/cloudcontrol/cancel-resource-request.html](https://docs.aws.amazon.com/cli/latest/reference/cloudcontrol/cancel-resource-request.html)  | 
|  [GetResourceRequestStatus](https://docs.aws.amazon.com/cloudcontrolapi/latest/APIReference/API_GetResourceRequestStatus.html)  |  [https://docs.aws.amazon.com/cli/latest/reference/cloudcontrol/get-resource-request-status.html](https://docs.aws.amazon.com/cli/latest/reference/cloudcontrol/get-resource-request-status.html)  | 
|  [ListResourceRequests](https://docs.aws.amazon.com/cloudcontrolapi/latest/APIReference/API_ListResourceRequests.html)  |  [https://docs.aws.amazon.com/cli/latest/reference/cloudcontrol/list-resource-requests.html](https://docs.aws.amazon.com/cli/latest/reference/cloudcontrol/list-resource-requests.html)  | 

# Cloud Control API 的工作原理
<a name="how-it-works"></a>

Cloud Control API 可让您集中控制自己的资源， AWS 账户 并以一致的方式访问和配置这些资源。它提供了一个统一编程接口，用于直接调用 AWS 账户中可用的各种资源类型。

*资源类型*代表可以通过 Web 服务配置的项目：亚马逊弹性计算云 (Amazon EC2) 实例、亚马逊关系数据库服务 (Amazon RDS) 数据库实例、 AWS Identity and Access Management (IAM) 策略，甚至是整个 Web 应用程序。每种资源类型都使用标准化的语法来支持以下部分或所有生命周期事件：创建、读取、更新、删除和列出 (CRUD-L)。你可以使用 Cloud Control API 作为一组一致的方法直接调用这些 CRUD-L 事件处理程序。 APIs

Amazon 已经发布了代表各项 AWS Web 服务中的产品的数百种资源类型。现在，第三方发布者也可以提供自己的资源类型以供使用。Cloud Control API 自动支持任何使用 [AWS CloudFormation CLI](https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/what-is-cloudformation-cli.html) 开源工具开发的资源类型。

每种资源类型都由其*资源类型架构*定义。本文档符合 [JSON 架构](https://json-schema.org/)开放标准，并且包括：
+ 每个资源属性及其关联元数据的完整列表，包括该属性是否为必需属性、数据类型和值约束。
+ 资源类型支持的 CRUD-L 事件，以及 Cloud Control API 调用每个支持的事件处理程序所需的权限。

创建或更新资源时，需要指定 JSON 来表示要为该资源设置的属性和属性值。Cloud Control API 处理对底层 Web 服务的实际调用，以执行请求的更改。对于读取请求，Cloud Control API 会返回表示指定资源的当前状态的 JSON。对于列出请求，Cloud Control API 会返回资源标识符或表示指定资源的当前状态的 JSON。

您可以使用 Cloud Control API 对现有资源执行操作，即使这些资源不是使用 Cloud Control API 创建的也不例外。例如，您可以使用 Cloud Control API 返回有关您的中每个 AWS Lambda 函数的属性信息 AWS 账户。

有关如何使用 Cloud Control API 执行资源操作的简要教程，请参阅[开始使用 Cloud Control API](getting-started.md)。

有关资源类型以及如何将其与 Cloud Control API 配合使用的更多信息，请参阅[使用云控制 API 资源类型](resource-types.md)。