Oggetti di richieste di risorse personalizzate - AWS CloudFormation

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à.

Oggetti di richieste di risorse personalizzate

Questo argomento descrive le proprietà dell'oggetto di richiesta per una risorsa CloudFormation personalizzata.

Per un'introduzione alle risorse personalizzate e al loro funzionamento, consultaCrea una logica di provisioning personalizzata con risorse personalizzate.

Proprietà delle richieste dello sviluppatore del modello

Lo sviluppatore del modello utilizza la CloudFormation risorsa AWS::CloudFormation::CustomResource, per specificare una risorsa personalizzata in un modello.

In AWS::CloudFormation::CustomResource, tutte le proprietà vengono definite dal custom resource provider. C'è una sola proprietà obbligatoria: ServiceToken.

ServiceTimeout

Il tempo massimo, in secondi, che può trascorrere prima del timeout di un'operazione personalizzata su una risorsa.

Il valore deve essere un numero intero compreso tra 1 e 3600. Il valore predefinito è 3600 secondi (1 ora).

Required: No

Tipo: stringa

ServiceToken

Il token di servizio, ad esempio l'ARN di un argomento Amazon SNS o l'ARN della funzione Lambda. Il token di servizio deve provenire dalla stessa regione dello stack.

Campo obbligatorio: sì

Tipo: stringa

Tutti gli altri campi delle proprietà della risorsa sono opzionali e vengono inviati, testualmente, al custom resource provider nel campo ResourceProperties della richiesta. Il provider definisce i nomi e i contenuti validi di questi campi.

Campi delle richieste del provider di risorse personalizzate

Questi campi vengono inviati nelle richieste JSON CloudFormation al provider di risorse personalizzate nell'argomento SNS che il provider ha configurato per questo scopo.

RequestType

Il tipo di richiesta è impostato dall'operazione CloudFormation stack (create-stack, update-stack o delete-stack) avviata dallo sviluppatore del modello per lo stack che contiene la risorsa personalizzata.

Deve essere un valore tra: Create, Update o Delete. Per ulteriori informazioni, consulta Tipi di richieste di risorse personalizzate.

Campo obbligatorio: sì

Tipo: stringa

ResponseURL

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

Campo obbligatorio: sì

Tipo: stringa

StackId

Il nome della risorsa Amazon (ARN) che identifica lo stack che contiene la risorsa personalizzata.

La combinazione di StackId con RequestId costituisce un valore che puoi utilizzare per identificare in modo univoco una richiesta in una particolare risorsa personalizzata.

Campo obbligatorio: sì

Tipo: stringa

RequestId

Un ID univoco per la richiesta.

La combinazione di StackId con RequestId costituisce un valore che puoi utilizzare per identificare in modo univoco una richiesta in una particolare risorsa personalizzata.

Campo obbligatorio: sì

Tipo: stringa

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: _@-.

Campo obbligatorio: sì

Tipo: stringa

LogicalResourceId

Il nome (ID logico) scelto dallo sviluppatore del modello della risorsa personalizzata nel modello AWS CloudFormation . Questa proprietà viene fornita per facilitare la comunicazione tra il provider di risorse personalizzate e il template developer.

Campo obbligatorio: sì

Tipo: stringa

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.

Obbligatorio: inviato sempre con le richieste Update e Delete e mai con Create.

Tipo: stringa

ResourceProperties

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

Required: No

Tipo: JSON object

OldResourceProperties

Usato solo per le richieste Update. Contiene le proprietà delle risorse dichiarate prima della richiesta di aggiornamento.

Campo obbligatorio: sì

Tipo: JSON object