

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á.

# Criando um recurso com AWS API Cloud Control
<a name="resource-operations-create"></a>

Use o comando `create-resource` para criar um recurso.

## Realizar a composição do estado desejado do recurso
<a name="resource-operations-create-desiredstate"></a>

Para que a API de controle da nuvem crie um recurso, você precisa especificar o *estado desejado* do recurso que deseja criar. O estado desejado consiste em uma lista das propriedades do recurso que você deseja especificar e seus valores desejados.

As propriedades de um recurso são definidas em seu esquema de tipo de recurso. Isso inclui se a propriedade é obrigatória, valores válidos e outras restrições de propriedade. Para obter mais informações sobre como visualizar definições de propriedades de recursos, consulte [Visualizando esquemas de tipos de recursos](resource-types.md#resource-types-schemas).

O estado desejado que você especificar deve ser válido em relação ao esquema do tipo de recurso.

Por exemplo, suponha que você queira criar um [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-logs-loggroup.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-logs-loggroup.html)recurso com um nome específico e uma política de retenção de 90 dias. Como primeira etapa, você deve compor o estado desejado do recurso, formatado como texto JSON.

```
{
  "LogGroupName": "CloudApiLogGroup",
  "RetentionInDays": 90
}
```

Ao chamar o comando `create-resource`, você pode passar o estado desejado diretamente em linha como uma string ou, para definições de estado desejadas mais complicadas, especificar a localização do arquivo.

O comando a seguir AWS Command Line Interface (AWS CLI) cria o recurso e especifica no `desired-state` parâmetro em que a `RetentionInDays` propriedade do recurso está definida`90`, além de especificar o nome do grupo de registros.

```
$ aws cloudcontrol create-resource --type-name AWS::Logs::LogGroup \
    --desired-state '{"LogGroupName": "CloudApiLogGroup", "RetentionInDays":90}'
```

## Acompanhando o progresso de uma solicitação de criação de recurso
<a name="resource-operations-create-progress"></a>

O comando `create-resource` retorna um objeto `ProgressEvent` que você pode usar para monitorar o status atual da sua solicitação de criação de recursos. Para obter mais informações, consulte [Acompanhando o progresso de uma solicitações de operações de recursos](resource-operations-manage-requests.md#resource-operations-manage-requests-track).