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.

Administrar las solicitudes de operación de recursos con AWS Cloud Control API

Como las operaciones de recursos son asíncronas, las solicitudes de recursos, como create-resource y update-resource, devuelven un objeto ProgressEvent que contiene información sobre el estado actual de su solicitud de creación o actualización de recurso.

Por ejemplo, una solicitud de creación de recursos podría devolver inicialmente el siguiente objeto ProgressEvent.

{
    "ProgressEvent": {
        "EventTime": "2021-08-09T18:17:15.219Z",
        "TypeName": "AWS::Logs::LogGroup",
        "OperationStatus": "IN_PROGRESS",
        "Operation": "CREATE",
        "Identifier": "LogGroupResourceExample",
        "RequestToken": "5f40c577-3534-4b20-9599-0b0123456789"
    }
}

La información devuelta en el objeto ProgressEvent incluye un token de solicitud que, a continuación, puede usar para hacer el seguimiento o cancelar una solicitud de operación de recursos.

Enumeración de las solicitudes de operación de recursos activas

Utilice el list-resource-requests comando para devolver una lista de las solicitudes de operaciones de recursos activas para un Cuenta de AWS y Región de AWS. Puede filtrar la lista por tipo y estado de solicitud.

Las solicitudes de operación de recursos caducan a los siete días.

El siguiente ejemplo devuelve las solicitudes de operación de recursos activas, pero excluye las solicitudes de creación de recursos que aún estén en curso.

$ aws cloudcontrol list-resource-requests --resource-request-status-filter \
    Operations=CREATE,OperationStatuses=IN_PROGRESS

La información devuelta de cada operación de recursos incluye un token de solicitud que, a continuación, puede usar para hacer el seguimiento o cancelar una solicitud de operación de recursos.

{
    "ResourceRequestStatusSummaries": [
        {
            "EventTime": "2021-08-09T18:17:16.591Z",
            "TypeName": "AWS::Logs::LogGroup",
            "OperationStatus": "SUCCESS",
            "Operation": "CREATE",
            "Identifier": "LogGroupResourceExample",
            "RequestToken": "5f40c577-3534-4b20-9599-0b0123456789"
        }
    ]
}

Seguimiento del progreso de las solicitudes de operación de recursos

Utilice el comando get-resource-request-status para hacer un seguimiento del progreso de su solicitud de operación de recursos. Este comando toma el token de solicitud incluido en el objeto ProgressEvent generado durante la solicitud inicial de operación de recursos. (También puede recuperar el token de solicitud de una solicitud de operación de recursos mediante el comando list-resource-requests). El comando get-resource-request-status devuelve un objeto ProgressEvent actualizado que contiene información sobre el estado actual de la solicitud.

Consulte el siguiente ejemplo.

$ aws cloudcontrol get-resource-request-status \
    --request-token 5f40c577-3534-4b20-9599-0b0123456789

Cancelación de las solicitudes de operación de recursos

Utilice el comando cancel-resource-request para cancelar una solicitud de operación de recursos que esté actualmente en curso. Como solo puede realizar una sola operación en un recurso determinado a la vez, puede haber casos en los que necesite cancelar la operación de recurso actual para que el recurso esté disponible y poder realizar otra operación en él.

Cancelar una solicitud de recurso no garantiza que la API de control en la nube pueda cancelar inmediatamente todas las operaciones de recursos. Por el contrario, la API de control en la nube dejará de realizar más llamadas al controlador de eventos del recurso. De hecho, una sola solicitud de operación de recursos a la API de control en la nube podría consistir en varias llamadas al servicio subyacente que aprovisiona el recurso. Por este motivo, cancelar una solicitud de operación de recursos podría dejar la solicitud parcialmente completada, lo que puede provocar que solo se apliquen algunos de los cambios solicitados al recurso. La API de control en la nube no revierte el recurso a su estado anterior.

Solo se pueden cancelar las solicitudes de operaciones de recursos con un estado PENDING o IN_PROGRESS.