Crear un recurso con AWS Cloud Control API - Control en la nube API

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Crear un recurso con AWS Cloud Control API

Utilice el comando create-resource para crear un recurso.

Composición del estado deseado del recurso

Para API que Cloud Control cree un recurso, debes especificar el estado deseado del recurso que deseas crear. El estado deseado consiste en una lista de las propiedades del recurso que deseas especificar y sus valores deseados.

Las propiedades de un recurso se definen en su esquema de tipos de recursos. Esto incluye si la propiedad es obligatoria, los valores válidos y otras restricciones de propiedad. Para obtener más información acerca de la visualización de definiciones de propiedades de los recursos, consulte Visualización de esquemas de tipos de recursos.

El estado deseado que especifique debe ser válido en el esquema de tipos de recurso.

Como ejemplo, supongamos que desea crear un AWS::Logs::LogGrouprecurso con un nombre específico y una política de retención de 90 días. Como primer paso, debe redactar el estado deseado del recurso, formateado como JSON texto.

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

Al llamar al comando create-resource, puede pasar el estado deseado directamente en línea como una cadena o, para definiciones de estado deseadas más complicadas, especificar una ubicación de archivo.

El comando siguiente AWS Command Line Interface (AWS CLI) crea el recurso y especifica en el desired-state parámetro en el que está establecida la RetentionInDays propiedad del recurso90, además de especificar el nombre del grupo de registros.

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

Seguimiento del progreso de una solicitud de creación de recurso

El comando create-resource devuelve un objeto ProgressEvent que puede utilizar para supervisar el estado actual de la solicitud de creación de recurso. Para obtener más información, consulte Seguimiento del progreso de las solicitudes de operación de recursos.