Verwaltung von Betriebsanfragen für Ressourcen mit AWS Cloud Control API

Da Ressourcenoperationen asynchron sind, geben Ressourcenanforderungen z. B. create-resource ein ProgressEvent Objekt update-resource zurück, das Informationen über den aktuellen Status Ihrer Anforderung zum Erstellen oder Aktualisieren von Ressourcen enthält.

Beispielsweise könnte eine Anfrage zur Erstellung einer Ressource zunächst das folgende ProgressEvent Objekt zurückgeben.

{
    "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"
    }
}

Die im ProgressEvent Objekt zurückgegebenen Informationen enthalten ein Anforderungstoken, das Sie dann verwenden können, um eine Anforderung für einen Ressourcenvorgang nachzuverfolgen oder abzubrechen.

Anmerkung

Anfragen für Ressourcenoperationen laufen nach sieben Tagen ab.

Liste der aktiven Anfragen für Ressourcenoperationen

Verwenden Sie den list-resource-requests Befehl, um eine Liste der aktiven Ressourcenoperationsanforderungen für ein AWS-Konto und zurückzugeben AWS-Region. Sie können die Liste nach Anforderungstyp und Status filtern.

Anfragen für Ressourcenoperationen laufen nach sieben Tagen ab.

Das folgende Beispiel gibt aktive Anfragen für Ressourcenoperationen zurück, filtert jedoch alle Anfragen zur Ressourcenerstellung heraus, die noch in Bearbeitung sind.

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

Zu den Informationen, die für jeden Ressourcenvorgang zurückgegeben werden, gehört ein Anforderungstoken, mit dem Sie dann eine Anfrage für einen Ressourcenvorgang verfolgen oder stornieren können.

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

Nachverfolgen des Fortschritts von Anfragen zu Ressourcenoperationen

Verwenden Sie den get-resource-request-status Befehl, um den Fortschritt Ihrer Ressourcenbetriebsanforderung zu verfolgen. Dieser Befehl verwendet das Anforderungstoken, das in dem ProgressEvent Objekt enthalten ist, das bei der ersten Anforderung eines Ressourcenvorgangs generiert wurde. (Sie können das Anforderungstoken für eine Ressourcenoperationsanforderung auch mithilfe des list-resource-requests Befehls abrufen.) Der get-resource-request-status Befehl gibt ein aktualisiertes ProgressEvent Objekt zurück, das Informationen zum aktuellen Status der Anforderung enthält.

Sehen Sie sich das folgende -Beispiel an.

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

Anfragen für Ressourcenoperationen werden storniert

Verwenden Sie den cancel-resource-request Befehl, um eine Anforderung für einen Ressourcenvorgang abzubrechen, die gerade bearbeitet wird. Da Sie für eine bestimmte Ressource jeweils nur einen einzigen Vorgang ausführen können, kann es vorkommen, dass Sie den aktuellen Ressourcenvorgang abbrechen müssen, um die Ressource verfügbar zu machen, sodass ein weiterer Vorgang mit ihr ausgeführt werden kann.

Das Stornieren einer Ressourcenanforderung garantiert nicht, dass Cloud Control sofort alle Ressourcenoperationen abbrechen API kann. Stattdessen hört Cloud Control API auf, weitere Aufrufe an den Ressourcen-Event-Handler zu tätigen. Eine einzelne Anforderung für einen Ressourcenvorgang an Cloud Control API kann tatsächlich aus mehreren Aufrufen des zugrunde liegenden Dienstes bestehen, der die Ressource bereitstellt. Aus diesem Grund kann das Stornieren einer Anforderung für einen Ressourcenvorgang dazu führen, dass die Anfrage teilweise abgeschlossen wird, sodass nur einige der angeforderten Änderungen auf die Ressource angewendet werden. Cloud Control API setzt die Ressource nicht in ihren vorherigen Zustand zurück.

Nur Anfragen für Ressourcenoperationen mit dem Status PENDING oder IN_PROGRESS können storniert werden.

Anmerkung

Durch das Aufrufen werden zwar die von Cloud Control ausgeführten Operationen CancelResourceRequest abgebrochenAPI, es werden jedoch keine asynchronen Vorgänge beendet, die möglicherweise bereits auf nachgelagerten Diensten gestartet wurden.