Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Gestione delle richieste di funzionamento delle risorse con AWS Cloud Control API

Poiché le operazioni sulle risorse sono asincrone, le richieste di risorse, ad create-resource esempio, update-resource restituiscono un ProgressEvent oggetto che contiene informazioni sullo stato corrente della richiesta di creazione o aggiornamento delle risorse.

Ad esempio, una richiesta di creazione di risorse potrebbe inizialmente restituire il seguente oggetto. 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"
    }
}

Le informazioni restituite nell'ProgressEventoggetto includono un token di richiesta che è quindi possibile utilizzare per tenere traccia o annullare una richiesta di gestione delle risorse.

Elenco delle richieste di funzionamento delle risorse attive

Utilizzate il list-resource-requests comando per restituire un elenco di richieste di funzionamento delle risorse attive per un Account AWS and Regione AWS. È possibile filtrare l'elenco per tipo e stato della richiesta.

Le richieste di gestione delle risorse scadono dopo sette giorni.

L'esempio seguente restituisce le richieste di gestione delle risorse attive, ma filtra tutte le richieste di creazione di risorse ancora in corso.

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

Le informazioni restituite per ogni operazione sulle risorse includono un token di richiesta che è quindi possibile utilizzare per tenere traccia o annullare una richiesta di gestione delle risorse.

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

Monitoraggio dello stato di avanzamento delle richieste di gestione delle risorse

Utilizzate il get-resource-request-status comando per tenere traccia dello stato di avanzamento della richiesta di gestione delle risorse. Questo comando accetta il token di richiesta incluso nell'ProgressEventoggetto generato durante la richiesta iniziale di gestione delle risorse. (È inoltre possibile recuperare il token di richiesta per una richiesta di funzionamento delle risorse utilizzando il list-resource-requests comando.) Il get-resource-request-status comando restituisce un ProgressEvent oggetto aggiornato contenente informazioni sullo stato corrente della richiesta.

Guarda l'esempio seguente.

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

Annullamento delle richieste di funzionamento delle risorse

Utilizzare il cancel-resource-request comando per annullare una richiesta di funzionamento delle risorse attualmente in corso. Poiché è possibile eseguire una sola operazione su una determinata risorsa alla volta, in alcuni casi potrebbe essere necessario annullare l'operazione corrente sulla risorsa per rendere la risorsa disponibile in modo che possa essere eseguita un'altra operazione su di essa.

L'annullamento di una richiesta di risorse non garantisce che Cloud Control API possa annullare immediatamente tutte le operazioni relative alle risorse. Piuttosto, Cloud Control API smetterà di effettuare ulteriori chiamate al gestore degli eventi delle risorse. Una singola richiesta di gestione delle risorse a Cloud Control API potrebbe effettivamente consistere in più chiamate al servizio sottostante che fornisce la risorsa. Per questo motivo, l'annullamento di una richiesta di gestione delle risorse potrebbe lasciare la richiesta parzialmente completata, con il risultato che solo alcune delle modifiche richieste vengano applicate alla risorsa. Cloud Control API non ripristina la risorsa allo stato precedente.

Solo le richieste di gestione delle risorse con stato PENDING o IN_PROGRESS possono essere annullate.