Eliminazione

Quando lo sviluppatore del modello elimina lo stack o rimuove la risorsa personalizzata dallo stack, CloudFormation invia una richiesta al fornitore di risorse personalizzate con RequestType set to. Delete Per eliminare uno stack con una risorsa personalizzata, il custom resource provider deve rispondere a una richiesta di eliminazione.

Per un'introduzione alle risorse personalizzate e al loro funzionamento, consulta. Risorse personalizzate

Richiesta

Le richieste di eliminazione contengono i seguenti campi:

RequestType

Delete.

RequestId

Un ID univoco per la richiesta.

ResponseURL

La risposta URL identifica un bucket S3 predefinito che riceve risposte dal fornitore di risorse personalizzato a. AWS CloudFormation

ResourceType

Il tipo di risorsa personalizzata nel modello scelto dallo sviluppatore del modello. CloudFormation I nomi dei tipi di risorsa personalizzata possono contenere fino a 60 caratteri e possono includere caratteri alfanumerici, oltre ai caratteri seguenti: _@-.

LogicalResourceId

Il nome (ID logico) scelto dallo sviluppatore del modello della risorsa personalizzata nel modello AWS CloudFormation .

StackId

L'Amazon Resource Name (ARN) che identifica lo stack che contiene la risorsa personalizzata.

PhysicalResourceId

Un ID fisico custom resource provider-defined richiesto che è univoco per quel fornitore.

Il valore restituito per un PhysicalResourceId può modificare le operazioni personalizzate di aggiornamento delle risorse. Se il valore restituito è lo stesso, viene considerato un aggiornamento normale. Se il valore restituito è diverso, AWS CloudFormation riconosce l'aggiornamento come sostituto e invia una richiesta di eliminazione alla vecchia risorsa. Per ulteriori informazioni, consulta AWS::CloudFormation::CustomResource.

ResourceProperties

Questo campo contiene il contenuto dell'oggetto Properties inviato dal template developer. I suoi contenuti vengono definiti dal provider di risorse personalizzate.

Esempio

{
   "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-west-2:123456789012:stack/mystack/5b918d10-cd98-11ea-90d5-0a9cd3354c10",
   "PhysicalResourceId" : "custom resource provider-defined physical id",
   "ResourceProperties" : {
      "key1" : "string",
      "key2" : [ "list" ],
      "key3" : { "key4" : "map" }
   }
}

Risposte

Riuscito

Quando la richiesta di eliminazione viene completata, una risposta deve essere inviata al bucket S3 con i seguenti campi:

Status

Deve essere SUCCESS.

RequestId

Un ID univoco per la richiesta. Questo valore di risposta deve essere copiato parola per parola dalla richiesta.

LogicalResourceId

Il nome (ID logico) scelto dallo sviluppatore del modello della risorsa personalizzata nel modello AWS CloudFormation . Questo valore di risposta deve essere copiato parola per parola dalla richiesta.

StackId

L'Amazon Resource Name (ARN) che identifica lo stack che contiene la risorsa personalizzata. Questo valore di risposta deve essere copiato parola per parola dalla richiesta.

PhysicalResourceId

Questo valore deve essere un identificativo univoco per il fornitore di risorse personalizzate e può avere una dimensione massima di 1 KB. Il valore deve essere una stringa non vuota e deve essere identico per tutte le risposte per la stessa risorsa.

Il valore restituito per un PhysicalResourceId può modificare le operazioni personalizzate di aggiornamento delle risorse. Se il valore restituito è lo stesso, viene considerato un aggiornamento normale. Se il valore restituito è diverso, AWS CloudFormation riconosce l'aggiornamento come sostituto e invia una richiesta di eliminazione alla vecchia risorsa. Per ulteriori informazioni, consulta AWS::CloudFormation::CustomResource.

Esempio

{
   "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-west-2:123456789012:stack/mystack/5b918d10-cd98-11ea-90d5-0a9cd3354c10 (copied from request)",
   "PhysicalResourceId" : "custom resource provider-defined physical id"
}

Non riuscito

Quando la richiesta di eliminazione non riesce, una risposta deve essere inviata al bucket S3 con i seguenti campi:

Status

Deve essere FAILED.

Reason

Il motivo dell'errore.

RequestId

Il valore RequestId copiato dalla richiesta di eliminazione.

LogicalResourceId

Il valore LogicalResourceId copiato dalla richiesta di eliminazione.

StackId

Il valore StackId copiato dalla richiesta di eliminazione.

PhysicalResourceId

Un ID fisico definito dal provider di risorse personalizzate obbligatorio che è univoco per tale provider.

Esempio

{
  "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-west-2:123456789012:stack/mystack/5b918d10-cd98-11ea-90d5-0a9cd3354c10 (copied from request)",
  "PhysicalResourceId" : "custom resource provider-defined physical id"
}