Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Qu'est-ce que c'est API de commande du Cloud AWS ?
Utilisez-le API de commande du Cloud AWS pour créer, lire, mettre à jour, supprimer et répertorier (CRUD-L) vos ressources cloud appartenant à des services tiers ou appartenant à AWS des services tiers. Grâce à l'ensemble standardisé d'interfaces de programmation d'applications () de l'API Cloud Control (APIs), vous pouvez effectuer des opérations CRUD-L sur toutes les ressources prises en charge dans votre. Compte AWS Grâce à l'API Cloud Control, vous n'aurez pas à générer de code ou de scripts spécifiques à chaque service responsable de ces ressources.
**Topics**
+ [Utilisez-vous l'API Cloud Control pour la première fois ?](#first-time-user)
+ [Caractéristiques de l'API Cloud Control](#cloudcontrolapi-feature-overview)
+ [Services connexes](#related-services)
+ [Accès à l'API Cloud Control](#accessing-cloudcontrolapi)
+ [Comment fonctionne l'API Cloud Control](how-it-works.md)
## Utilisez-vous l'API Cloud Control pour la première fois ?
Si vous utilisez l'API Cloud Control pour la première fois, nous vous recommandons de commencer par lire les sections suivantes :
+ [Con API de commande du Cloud AWS figuration](setting-up.md)
+ [Commencer à utiliser l'API Cloud Control](getting-started.md)
## Caractéristiques de l'API Cloud Control
L'API Cloud Control vous permet de contrôler de manière cohérente les ressources de votre AWS compte en proposant un mode standardisé d'accès et de provisionnement de ces ressources. Il fournit une interface de programmation uniforme pour passer des appels directement aux différents types de ressources disponibles dans votre AWS compte, sans avoir à vous familiariser avec les services APIs Web sous-jacents.
## Services connexes
À l'instar de l'API Cloud Control, elle utilise AWS CloudFormation également des types de ressources pour appeler les services Web sous-jacents APIs afin de fournir ces ressources lorsque vous placez une telle demande dans votre compte. Cependant, il CloudFormation se concentre sur la gestion des ressources, en traitant l'infrastructure comme du code. À l'aide de CloudFormation, vous pouvez créer des modèles déclaratifs qui incluent plusieurs ressources et leurs dépendances, puis provisionner ces ressources sous forme de *pile*. Une pile est une unité unique que vous pouvez ensuite gérer CloudFormation. Vous pouvez également gérer et approvisionner de manière centralisée des piles sur plusieurs Comptes AWS et Régions AWS. Pour être gérée CloudFormation, une ressource doit être créée dans le cadre d'une pile ou importée dans une pile. Pour plus d’informations, consultez le *[Guide de l’utilisateur AWS CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html)*.
## Accès à l'API Cloud Control
L'API Cloud Control fournit des opérations d'API pour générer des demandes de ressources de création, de lecture, de mise à jour, de suppression et de liste (CRUD-L), en plus du suivi et de la gestion de ces demandes. Vous utilisez le AWS Command Line Interface (AWS CLI) pour les opérations de l'API Cloud Control.
Le tableau suivant indique les opérations de l'API Cloud Control que vous pouvez utiliser pour générer des demandes de ressources CRUD-L.
| Opération API | AWS CLI commande |
| --- | --- |
| [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) |
Le tableau suivant présente les opérations de l'API Cloud Control que vous pouvez utiliser pour suivre et gérer les demandes de ressources pendant leur traitement.
| Opération API | AWS CLI commande |
| --- | --- |
| [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) |
# Comment fonctionne l'API Cloud Control
L'API Cloud Control vous permet de centraliser le contrôle de vos ressources Compte AWS et d'accéder à ces ressources et de les approvisionner de manière cohérente. Il fournit une interface de programmation uniforme pour passer des appels directement aux différents types de ressources disponibles dans votre Compte AWS.
Un *type de ressource* représente un artefact qui peut être mis en service via un service Web : une instance Amazon Elastic Compute Cloud (Amazon EC2), une instance de base de données Amazon Relational Database Service (Amazon RDS), une politique Gestion des identités et des accès AWS (IAM) ou même une application Web complète. Chaque type de ressource utilise une syntaxe standardisée pour prendre en charge certains ou tous les événements du cycle de vie suivants : création, lecture, mise à jour, suppression et liste (CRUD-L). Vous pouvez appeler directement ces gestionnaires d'événements CRUD-L à l'aide de l'API Cloud Control en tant qu'ensemble cohérent de. APIs
Amazon a publié plusieurs centaines de types de ressources représentant des offres de services AWS Web. Désormais, les éditeurs tiers peuvent également mettre à disposition leurs propres types de ressources. Tout type de ressource développé à l'aide de l'outil open source [AWS CloudFormation CLI](https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/what-is-cloudformation-cli.html) est automatiquement pris en charge par l'API Cloud Control.
Chaque type de ressource est défini par son *schéma de type de ressource*. Ce document est conforme au standard ouvert du [schéma JSON](https://json-schema.org/) et inclut :
+ Une liste complète de chaque propriété de ressource et de ses métadonnées associées, indiquant notamment si la propriété est requise, le type de données et les contraintes de valeur.
+ Les événements CRUD-L pris en charge par le type de ressource et les autorisations nécessaires à l'API Cloud Control pour appeler chaque gestionnaire d'événements pris en charge.
Lorsque vous créez ou mettez à jour une ressource, vous spécifiez le JSON qui représente les propriétés et les valeurs de propriétés que vous souhaitez définir pour la ressource. L'API Cloud Control gère les appels réels aux services Web sous-jacents pour effectuer les modifications demandées. Pour les demandes de lecture, l'API Cloud Control renvoie un code JSON qui représente l'état actuel de la ressource spécifiée. Pour les demandes de liste, l'API Cloud Control renvoie soit l'identifiant de ressource, soit le JSON qui représente l'état actuel des ressources spécifiées.
Vous pouvez utiliser l'API Cloud Control pour effectuer des opérations sur les ressources existantes, même si celles-ci n'ont pas été créées à l'aide de l'API Cloud Control. Par exemple, vous pouvez utiliser l'API Cloud Control pour renvoyer des informations de propriété relatives à chaque AWS Lambda fonction de votre Compte AWS.
Pour un bref didacticiel sur l'utilisation de l'API Cloud Control pour effectuer des opérations sur les ressources, consultez[Commencer à utiliser l'API Cloud Control](getting-started.md).
Pour plus d'informations sur les types de ressources et sur leur utilisation avec l'API Cloud Control, consultez[Utilisation des types de ressources de l'API Cloud Control](resource-types.md).