本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 什麼是 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)
+ [雲端控制 API 的功能](#cloudcontrolapi-feature-overview)
+ [相關服務](#related-services)
+ [存取雲端控制 API](#accessing-cloudcontrolapi)
+ [雲端控制 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)

## 雲端控制 API 的功能
<a name="cloudcontrolapi-feature-overview"></a>

雲端控制 API 透過提供標準化的方式來存取和佈建這些資源，為您提供 AWS 對帳戶中資源的一致控制。它提供統一的程式設計界面，可直接呼叫您 AWS 帳戶中可用的各種資源類型，而無需熟悉基礎 Web APIs。

## 相關服務
<a name="related-services"></a>

與 Cloud Control API 類似，當您在帳戶中提出此類請求時， AWS CloudFormation 也會使用資源類型來呼叫基礎 Web 服務 APIs 來佈建這些資源。不過，CloudFormation 著重於透過將基礎設施視為程式碼來提供資源管理。使用 CloudFormation，您可以撰寫包含多個資源及其相依性的宣告式範本，然後將這些資源佈建為*堆疊*。堆疊是您接著管理的單一單位 CloudFormation。您也可以集中管理和佈建多個 和 的堆疊 AWS 帳戶 AWS 區域。若要透過 CloudFormation 管理，資源必須建立為堆疊的一部分或匯入堆疊。如需詳細資訊，請參閱《*[AWS CloudFormation 使用者指南](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html)*》。

## 存取雲端控制 API
<a name="accessing-cloudcontrolapi"></a>

除了追蹤和管理這些請求之外，Cloud Control API 還提供 API 操作來產生建立、讀取、更新、刪除和列出 (CRUD-L) 資源請求。您可以使用 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)  | 

# 雲端控制 API 的運作方式
<a name="how-it-works"></a>

Cloud Control API 可讓您集中控制 中的資源， AWS 帳戶 並以一致的方式存取和佈建這些資源。它提供統一的程式設計界面，可直接對 中提供的各種資源類型進行呼叫 AWS 帳戶。

*資源類型*代表可透過 Web 服務佈建的成品：Amazon Elastic Compute Cloud (Amazon EC2) 執行個體、Amazon Relational Database Service (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 使用它們的詳細資訊，請參閱 [使用 Cloud Control API 資源類型](resource-types.md)。