Criar um recurso - Control API do Cloud Control

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

Criar um recurso

Usar acreate-resourcecomando para criar um recurso.

Compondo o estado desejado do recurso

Para que a Cloud Control API crie um recurso, você precisa especificar oestado desejadodo recurso que você 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 propriedade de recurso, consulte.Exibindo esquemas de tipo de recurso.

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

Por exemplo, suponha que você queira criar umAWS::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 }

Quando você liga para ocreate-resource, você pode passar o estado desejado diretamente em linha como uma string ou, para definições de estado desejadas mais complicadas, especificar um local de arquivo.

Os seguintes exemplos deAWS Command Line Interface(AWS CLI) cria o recurso e especifica nodesired-stateparâmetro que oRetentionInDaysa propriedade do recurso está definida como90, 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}"

Controlar o andamento de uma solicitação de criação de recurso

Ocreate-resourcecomando retorna umProgressEventobjeto que você pode usar para rastrear o status atual da solicitação de criação de recurso. Para obter mais informações, consulteControlar o progresso das solicitações de recursos.