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
oDelete
. 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
conRequestId
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
conRequestId
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, consultaAWS::CloudFormation::CustomResource
.Obbligatorio: inviato sempre con le richieste
Update
eDelete
e mai conCreate
.▬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