Löschen - AWS CloudFormation

Löschen

Anforderungen mit RequestType eingerichtet als Delete werden an den Anbieter einer benutzerdefinierten Ressource gesendet, wenn der template developer einen Stack löscht, der eine benutzerdefinierte Ressource enthält. Wenn Sie eine benutzerdefinierte Ressource löschen möchten, muss custom resource provider erfolgreich auf eine Löschenanfrage antworten.

Anfrage

Anforderungen zum Löschen enthalten die folgenden Felder:

RequestType

Delete aus.

RequestId

Eine eindeutige ID für die Anforderung

ResponseURL

Die Antwort-URL gibt einen vorsignierten S3-Bucket an, der Antworten vom custom resource provider an AWS CloudFormation empfängt.

ResourceType

Der vom Developer der Vorlagen gewählte Ressourcentyp der benutzerdefinierten Ressource in der AWS CloudFormation-Vorlage. Namen für benutzerdefinierte Ressourcentypen dürfen bis zu 60 Zeichen lang sein und sowohl alphanumerische Zeichen als auch folgende Zeichen enthalten: _@-.

LogicalResourceId

Der vom template developer gewählte Name (logische ID) der benutzerdefinierten Ressource in der AWS CloudFormation-Vorlage

StackId

Der Amazon-Ressourcenname (ARN), der den Stack identifiziert, der die benutzerdefinierte Ressource enthält

PhysicalResourceId

Eine erforderliche, vom custom resource provider definierte physische ID, die für diesen Anbieter eindeutig ist

ResourceProperties

Dieses Feld enthält die Inhalte des Properties-Objekts, das vom template developer gesendet wurde. Die Inhalte werden vom custom resource provider definiert.

Beispiel

{
   "RequestType" : "Delete",
   "RequestId" : "unique id for this delete request",
   "ResponseURL" : "pre-signed-url-for-delete-response",
   "ResourceType" : "Custom::MyCustomResourceType",
   "LogicalResourceId" : "name of resource in template",
   "StackId" : "arn:aws:cloudformation:us-east-2:namespace:stack/stack-name/guid",
   "PhysicalResourceId" : "custom resource provider-defined physical id",
   "ResourceProperties" : {
      "key1" : "string",
      "key2" : [ "list" ],
      "key3" : { "key4" : "map" }
   }
}

Antworten

Herzlichen Glückwunsch

Wenn die Löschenanfrage erfolgreich ist, muss eine Antwort an den S3-Bucket gesendet werden, die die folgenden Felder enthält:

Status

Der Wert muss SUCCESS sein.

RequestId

Eine eindeutige ID für die Anforderung Dieser Antwortwert sollte unverändert aus der Anforderung kopiert werden.

LogicalResourceId

Der vom template developer gewählte Name (logische ID) der benutzerdefinierten Ressource in der AWS CloudFormation-Vorlage Dieser Antwortwert sollte unverändert aus der Anforderung kopiert werden.

StackId

Der Amazon-Ressourcenname (ARN), der den Stack identifiziert, der die benutzerdefinierte Ressource enthält Dieser Antwortwert sollte unverändert aus der Anforderung kopiert werden.

PhysicalResourceId

Dieser Wert sollte ein eindeutiger Bezeichner für den Anbieter der benutzerdefinierten Ressource sein und kann bis zu 1 KB groß sein. Der Wert muss eine Zeichenfolge, die nicht leer ist, und für alle Antworten für dieselbe Ressource identisch sein.

Beispiel

{
   "Status" : "SUCCESS",
   "RequestId" : "unique id for this delete request (copied from request)",
   "LogicalResourceId" : "name of resource in template (copied from request)",
   "StackId" : "arn:aws:cloudformation:us-east-2:namespace:stack/stack-name/guid (copied from request)",
   "PhysicalResourceId" : "custom resource provider-defined physical id"
}

Fehlgeschlagen

Wenn die Löschenanfrage fehlschlägt, muss eine Antwort an den S3-Bucket gesendet werden, die die folgenden Felder enthält:

Status

Der Wert muss FAILED sein.

Grund

Der Grund für den Fehlschlag.

RequestId

Der Wert RequestId, der aus der Löschenanfrage kopiert wurde.

LogicalResourceId

Der Wert LogicalResourceId, der aus der Löschenanfrage kopiert wurde.

StackId

Der Wert StackId, der aus der Löschenanfrage kopiert wurde.

PhysicalResourceId

Eine erforderliche, vom custom resource provider definierte physische ID, die für diesen Anbieter eindeutig ist

Beispiel

{ "Status" : "FAILED", "Reason" : "Required failure reason string", "RequestId" : "unique id for this delete request (copied from request)", "LogicalResourceId" : "name of resource in template (copied from request)", "StackId" : "arn:aws:cloudformation:us-east-2:namespace:stack/stack-name/guid (copied from request)", "PhysicalResourceId" : "custom resource provider-defined physical id" }