

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# ¿Qué es API de control de nube de AWS?
<a name="what-is-cloudcontrolapi"></a>

Úselo API de control de nube de AWS para crear, leer, actualizar, eliminar y enumerar (CRUD-L) sus recursos en la nube que pertenecen a servicios de terceros o a AWS servicios de terceros. Con el conjunto estandarizado de interfaces de programación de aplicaciones (APIs) de la API Cloud Control, puedes realizar operaciones de CRUD-L en cualquier recurso compatible que tengas. Cuenta de AWS Con la API de control en la nube, no tendrá que generar códigos ni scripts específicos para cada servicio individual responsable de esos recursos.

**Topics**
+ [¿Es la primera vez que usa la API de control en la nube?](#first-time-user)
+ [Funciones de la API de control en la nube](#cloudcontrolapi-feature-overview)
+ [Servicios relacionados](#related-services)
+ [Acceso a la API de control en la nube](#accessing-cloudcontrolapi)
+ [Cómo funciona la API de control en la nube](how-it-works.md)

## ¿Es la primera vez que usa la API de control en la nube?
<a name="first-time-user"></a>

Si es la primera vez que usa la API de control en la nube, le recomendamos que empiece leyendo las siguientes secciones:
+ [Con API de control de nube de AWS figuración](setting-up.md)
+ [Introducción a la API de control en la nube](getting-started.md)

## Funciones de la API de control en la nube
<a name="cloudcontrolapi-feature-overview"></a>

La API de Cloud Control te proporciona un control uniforme sobre los recursos de tu AWS cuenta al ofrecer una forma estandarizada de acceder a esos recursos y de aprovisionarlos. Proporciona una interfaz programática uniforme para realizar llamadas directamente a los distintos tipos de recursos disponibles en tu AWS cuenta, sin tener que familiarizarte con APIs los servicios web subyacentes.

## Servicios relacionados
<a name="related-services"></a>

Al igual que la API de Cloud Control, AWS CloudFormation también utiliza tipos de recursos para llamar APIs a los servicios web subyacentes y aprovisionar esos recursos cuando realizas una solicitud de este tipo en tu cuenta. Sin embargo, CloudFormation se centra en proporcionar administración de recursos, al tratar la infraestructura como código. *Con CloudFormation él, puede crear plantillas declarativas que incluyan varios recursos y sus dependencias y, a continuación, aprovisionar esos recursos como una pila.* Una pila es una unidad única que luego se administra. CloudFormation También puede administrar y aprovisionar pilas de forma centralizada en múltiples Cuentas de AWS y Regiones de AWS. Para poder gestionarlo correctamente CloudFormation, un recurso debe crearse como parte de una pila o importarse a una pila. Para obtener más información, consulte la *[Guía del usuario de AWS CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html)*.

## Acceso a la API de control en la nube
<a name="accessing-cloudcontrolapi"></a>

La API de control en la nube proporciona operaciones de API para generar solicitudes para leer, actualizar, eliminar y enumerar recursos (CRUD-L), además de hacer un seguimiento de esas solicitudes y administrarlas. Use la AWS Command Line Interface (AWS CLI) para las operaciones de la API de control en la nube.

En la siguiente tabla, se muestran las operaciones de la API de control en la nube que puede usar para generar solicitudes de recursos CRUD-L.


| Operación de la API | AWS CLI comando | 
| --- | --- | 
|  [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)  | 

En la siguiente tabla, se muestran las operaciones de la API de control en la nube que puede usar para hacer el seguimiento de las solicitudes de recursos y administrarlas mientras están en proceso.


| Operación de la API | AWS CLI comando | 
| --- | --- | 
|  [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)  | 

# Cómo funciona la API de control en la nube
<a name="how-it-works"></a>

La API de Cloud Control te proporciona un control centralizado de tus recursos Cuenta de AWS y una forma coherente de acceder a esos recursos y aprovisionarlos. Proporciona una interfaz programática uniforme para realizar llamadas directamente a los distintos tipos de recursos disponibles en su Cuenta de AWS.

Un *tipo de recurso* representa un artefacto que se puede aprovisionar a través de un servicio web: una instancia de Amazon Elastic Compute Cloud (Amazon EC2), una instancia de base de datos de Amazon Relational Database Service (Amazon RDS), una política AWS Identity and Access Management (IAM) o incluso una aplicación web completa. Cada tipo de recurso utiliza una sintaxis estandarizada para admitir algunos de los siguientes eventos del ciclo de vida o todos ellos: crear, leer, actualizar, eliminar y enumerar (CRUD-L). Puedes invocar directamente estos controladores de eventos CRUD-L utilizando la API de Cloud Control como un conjunto coherente de ellos. APIs

Amazon ha publicado varios cientos de tipos de recursos que representan las ofertas de todos los servicios web de AWS . Ahora, los editores externos también pueden hacer que sus propios tipos de recursos estén disponibles para su uso. La API de control en la nube admite automáticamente cualquier tipo de recurso desarrollado con la herramienta de código abierto [CLI de AWS CloudFormation](https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/what-is-cloudformation-cli.html).

Cada tipo de recurso se define mediante su *esquema de tipos de recursos*. Este documento cumple con el estándar abierto del [esquema JSON](https://json-schema.org/) e incluye:
+ Una lista completa de cada propiedad de recurso y sus metadatos asociados, que incluye si la propiedad es obligatoria, el tipo de datos y las restricciones de valor.
+ Los eventos CRUD-L que admite el tipo de recurso, y los permisos necesarios para que la API de control en la nube invoque cada controlador de eventos compatible.

Cuando crea o actualiza un recurso, especifica un JSON que representa las propiedades y los valores de propiedad que desea establecer para el recurso. La API de control en la nube gestiona las llamadas reales a los servicios web subyacentes para realizar los cambios solicitados. En el caso de las solicitudes de lectura, la API de control en la nube devuelve un JSON que representa el estado actual del recurso especificado. En el caso de las solicitudes de lista, la API de control en la nube devuelve el identificador del recurso o el JSON que representa el estado actual de los recursos especificados.

Puede usar la API de control en la nube para realizar operaciones en los recursos existentes, aunque esos recursos no se hayan creado con la API de control en la nube. Por ejemplo, puedes usar la API de Cloud Control para obtener información sobre las propiedades de cada AWS Lambda función de la tuya. Cuenta de AWS

Para ver un breve tutorial sobre cómo usar la API de Cloud Control para realizar operaciones de recursos, consulta[Introducción a la API de control en la nube](getting-started.md).

Para obtener más información sobre los tipos de recursos y cómo usarlos con la API de Cloud Control, consulta[Uso de los tipos de recursos de la API de Cloud Control](resource-types.md).