Criar um recurso

Use o comando create-resource para criar um recurso.

Realizar a composição do estado desejado do recurso

Para que o Cloud Control API 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 exibir definições de propriedades de recursos, consulte Visualizando esquemas de tipos de recursos.

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 AWS::Logs::LogGrouprecurso 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 parâmetro desired-state em que a propriedade RetentionInDays do recurso está definida em 90, além de especificar o nome do grupo de logs.

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

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 ter mais informações, consulte Acompanhando o progresso de uma solicitações de operações de recursos.