Criando um recurso com AWS Cloud Control API

Use o comando create-resource para criar um recurso.

Realizar a composição do estado desejado do recurso

Para API que o Cloud Control 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.

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 JSON texto.

{
  "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á definida90, 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

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.