As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# O que é AWS API Cloud Control?
Use AWS API Cloud Control para criar, ler, atualizar, excluir e listar (CRUD-L) seus recursos de nuvem que pertencem a serviços de terceiros AWS e a eles. Com o conjunto padronizado de interfaces de programação de aplicativos (APIs) da Cloud Control API, você pode realizar operações CRUD-L em qualquer recurso compatível em seu. Conta da AWS Usando a API de Controle da Nuvem, você não precisará gerar códigos ou scripts específicos para cada serviço individual responsável por esses recursos.
**Topics**
+ [Você é um usuário iniciante da API de Controle da Nuvem?](#first-time-user)
+ [Atributos da API de Controle da Nuvem](#cloudcontrolapi-feature-overview)
+ [Serviços relacionados](#related-services)
+ [Acessando a API de Controle da Nuvem](#accessing-cloudcontrolapi)
+ [Como funciona a API de Controle da Nuvem](how-it-works.md)
## Você é um usuário iniciante da API de Controle da Nuvem?
Se você estiver usando a API de Controle da Nuvem pela primeira vez, recomendamos que você leia as seguintes seções para começar:
+ [Conf AWS API Cloud Control iguração](setting-up.md)
+ [Conceitos básicos da API de Controle da Nuvem](getting-started.md)
## Atributos da API de Controle da Nuvem
A Cloud Control API fornece controle consistente sobre os recursos em sua AWS conta, oferecendo uma forma padronizada de acessar e provisionar esses recursos. Ele fornece uma interface programática uniforme para fazer chamadas diretamente para os vários tipos de recursos disponíveis em sua AWS conta, sem precisar se familiarizar com os serviços APIs da Web subjacentes.
## Serviços relacionados
Semelhante à API Cloud Control, AWS CloudFormation também usa tipos de recursos para chamar serviços da web subjacentes APIs para provisionar esses recursos quando você faz essa solicitação em sua conta. No entanto, CloudFormation se concentra em fornecer gerenciamento de recursos, tratando a infraestrutura como código. *Usando CloudFormation, você pode criar modelos declarativos que incluem vários recursos e suas dependências e, em seguida, provisionar esses recursos como uma pilha.* Uma pilha é uma unidade única que você gerencia CloudFormation. Você também pode gerenciar e provisionar centralmente pilhas em vários e. Contas da AWS Regiões da AWS Para ser gerenciado CloudFormation, um recurso deve ser criado como parte de uma pilha ou importado para uma pilha. Para obter mais informações, consulte o *Guia do usuário do [AWS CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html)*.
## Acessando a API de Controle da Nuvem
A API de Controle da Nuvem fornece operações de API para gerar solicitações de recursos de criação, leitura, atualização, exclusão e listagem (CRUD-L), além de rastrear e gerenciar essas solicitações. Você usa o AWS Command Line Interface (AWS CLI) para operações da API de Controle da Nuvem.
A tabela a seguir mostra as operações da API de Controle da Nuvem que você pode usar para gerar solicitações de recursos CRUD-L.
| Operação de 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) |
A tabela a seguir mostra as operações da API de Controle da Nuvem que você pode usar para rastrear e gerenciar solicitações de recursos enquanto elas estão em andamento.
| Operação de 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) |
# Como funciona a API de Controle da Nuvem
A Cloud Control API fornece controle centralizado sobre os recursos em você Conta da AWS e uma forma consistente de acessar e provisionar esses recursos. Ele fornece uma interface programática uniforme para fazer chamadas diretamente para os vários tipos de recursos disponíveis em sua Conta da AWS.
Um *tipo de recurso* representa um artefato que pode ser provisionado por meio de um serviço web: uma instância do Amazon Elastic Compute Cloud (Amazon EC2), uma instância de banco de dados do Amazon Relational Database Service (Amazon RDS) AWS Identity and Access Management , uma política (IAM) ou até mesmo uma aplicação web inteira. Cada tipo de recurso usa uma sintaxe padronizada para oferecer suporte a alguns ou a todos os seguintes eventos de ciclo de vida: criar, ler, atualizar, excluir e listar (CRUD-L). Você pode invocar diretamente esses manipuladores de eventos CRUD-L usando a Cloud Control API como um conjunto consistente de. APIs
A Amazon publicou várias centenas de tipos de recursos representando ofertas em serviços da AWS da web. Agora, editores terceirizados também podem disponibilizar seus próprios tipos de recursos para uso. Qualquer tipo de recurso desenvolvido usando a ferramenta de código aberto [AWS CloudFormation CLI](https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/what-is-cloudformation-cli.html) é automaticamente compatível com a API de Controle da Nuvem.
Cada tipo de recurso é definido por seu *esquema de tipo de recurso*. Este documento é compatível com o padrão aberto do [esquema JSON](https://json-schema.org/) e inclui:
+ Uma lista completa de cada propriedade do recurso e seus metadados associados, incluindo se a propriedade é necessária, tipo de dados e restrições de valor.
+ Os eventos CRUD-L que o tipo de recurso suporta e as permissões necessárias para que a API de Controle da Nuvem invoque cada manipulador de eventos compatível.
Ao criar ou atualizar um recurso, você especifica o JSON que representa as propriedades e os valores das propriedades que você deseja definir para o recurso. A API de Controle da Nuvem processa as chamadas reais para os serviços da web subjacentes para realizar as alterações solicitadas. Para solicitações de leitura, a API de Controle da Nuvem retorna o JSON que representa o estado atual do recurso especificado. Para solicitações de lista, a API de Controle da Nuvem retorna o identificador do recurso ou o JSON que representa o estado atual dos recursos especificados.
Você pode usar a API de Controle da Nuvem para realizar operações em recursos existentes, mesmo que esses recursos não tenham sido criados usando a API de Controle da Nuvem. Por exemplo, você pode usar a Cloud Control API para retornar informações de propriedades sobre cada AWS Lambda função em sua Conta da AWS.
Para ver um breve tutorial sobre como usar a Cloud Control API para realizar operações de recursos, consulte[Conceitos básicos da API de Controle da Nuvem](getting-started.md).
Para mais informações sobre os tipos de recursos e como usá-los com a Cloud Control API, consulte[Usando os tipos de recursos da Cloud Control API](resource-types.md).