翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# とは AWS クラウドコントロール API
<a name="what-is-cloudcontrolapi"></a>

 AWS クラウドコントロール API を使用して、 およびサードパーティーのサービスに属するクラウドリソースを作成、読み取り、更新、削除 AWS 、一覧表示 (CRUD-L) します。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 アカウントのリソースを一貫して制御できます。基盤となるウェブサービスの APIs に慣れなくても、 AWS アカウントで利用可能なさまざまなリソースタイプに直接呼び出しを行うための統一されたプログラムインターフェイスを提供します。

## 関連サービス
<a name="related-services"></a>

Cloud Control API と同様に、 AWS CloudFormation はリソースタイプを使用して基盤となるウェブサービス APIsを呼び出し、アカウントでそのようなリクエストを行うときにそれらのリソースをプロビジョニングします。ただし、CloudFormation は、インフラストラクチャをコードとして扱うことにより、リソース管理を提供することに重点を置いています。CloudFormation を使用すると、複数のリソースおよびその依存関係を含む宣言型テンプレートを作成し、それらのリソースをスタックとしてプロビジョニングできます。スタックは 1 つのユニットで、その後で管理します CloudFormation。また、複数の と にまたがるスタックを一元管理 AWS アカウント およびプロビジョニングすることもできます AWS リージョン。CloudFormation を使用して管理するには、リソースをスタックの一部として作成するか、スタックにインポートする必要があります。詳細については、*[AWS CloudFormation ユーザーガイド](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html)*をご参照ください。

## Cloud Control API へのアクセス
<a name="accessing-cloudcontrolapi"></a>

Cloud Control API では、リソースリクエストの追跡と管理に加えて、作成、読み取り、更新、削除、一覧表示 (CRUD-L、Create, Read, Update, Delete, and List) リソースリクエストを生成する API オペレーションも提供します。Cloud Control API オペレーションには AWS Command Line Interface (AWS CLI) を使用します。

以下の表は、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 アカウント し、それらのリソースにアクセスしてプロビジョニングする一貫した方法を提供します。Cloud Control API は、 AWS アカウントで利用可能なさまざまなリソースタイプを直接呼び出すための統一されたプログラムインターフェイスを提供します。

*リソースタイプ*は、ウェブサービスを介してプロビジョニングできるアーティファクトを表します。Amazon Elastic Compute Cloud (Amazon EC2) インスタンス、Amazon Relational Database Service (Amazon RDS) データベースインスタンス、 AWS Identity and Access Management (IAM) ポリシー、またはウェブアプリケーション全体です。各リソースタイプは、作成、読み取り、削除、一覧表示 (CRUD-L、Create, Read, Update, Delete, and List) といったライフサイクルイベントの一部またはすべてをサポートするために標準化された構文を使用します。Cloud Control API を API の一貫したセットとして使用して、これらの CRUD-L イベントハンドラーを直接呼び出すことができます。

Amazon は、 AWS ウェブサービスのオファリングを表す数百のリソースタイプを公開しています。現在では、サードパーティのパブリッシャーが独自のリソースタイプも利用できるようにしています。[AWS CloudFormation CLI](https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/what-is-cloudformation-cli.html) オープンソースツールを使用して開発されたリソースタイプはすべて、Cloud Control API によって自動的にサポートされます。

各リソースタイプはリソースタイプスキーマによって定義されます。このドキュメントは [JSON スキーマ](https://json-schema.org/)のオープンスタンダードに準拠しており、以下が含まれています。
+ 各リソースプロパティおよびそれに関連するメタデータ (プロパティが必要かどうか、データ型、値の制約など) の完全なリスト。
+ リソースタイプがサポートする CRUD-L イベント、およびサポートされている各イベントハンドラーを Cloud Control API が呼び出すために必要なアクセス許可。

リソースを作成または更新するときは、リソースに設定するプロパティとプロパティ値を表す JSON を指定します。Cloud Control API は、基盤となるウェブサービスへの実際の呼び出しを処理して、要求された変更を実行します。読み取りリクエストの場合、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)。