Oggetti di risposta di risorse personalizzate

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

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

Campi di risposta del provider di risorse personalizzate

Di seguito sono elencate le proprietà del provider di risorse personalizzate durante l'invio del file alla JSON all'URL prefirmato. Per ulteriori informazioni sul caricamento degli oggetti utilizzando gli URL prefirmati, consulta l'argomento correlato nella Guida per l'utente di Amazon Simple Storage Service.

Nota

La dimensione totale del corpo della risposta non può superare 4096 byte.

Status

Il valore di stato inviato dal fornitore di risorse personalizzate in risposta a una richiesta AWS CloudFormation generata.

Deve essere SUCCESS o FAILED.

Campo obbligatorio: sì

▬Tipo: stringa

Reason

Descrive il motivo di una risposta con esito negativo.

Campo obbligatorio: richiesto se Status è FAILED. Altrimenti, è facoltativo.

▬Tipo: stringa

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.

Campo obbligatorio: sì

▬Tipo: stringa

StackId

Il nome della risorsa Amazon (ARN) che identifica lo stack che contiene la risorsa personalizzata. Questo valore di risposta deve essere copiato parola per parola dalla richiesta.

Campo obbligatorio: sì

▬Tipo: stringa

RequestId

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

Campo obbligatorio: sì

▬Tipo: stringa

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.

Campo obbligatorio: sì

▬Tipo: stringa

NoEcho

Facoltativo. Indica se nascondere o meno l'output della risorsa personalizzata quando viene recuperata utilizzando la funzione Fn::GetAtt. Se impostato sutrue, tutti i valori restituiti sono mascherati da asterischi (*****), ad eccezione di quelli memorizzati nella sezione del Metadata modello. AWS CloudFormation non trasforma, modifica o oscura le informazioni incluse nella sezione. Metadata Il valore predefinito è false.

Per ulteriori informazioni sull'utilizzo di NoEcho per mascherare le informazioni sensibili, consulta la best practice Non incorporare le credenziali nei modelli.

Required: No

Tipo: Booleano

Data

Facoltativo. Le coppie nome-valore definite dal provider di risorse personalizzate da inviare con la risposta. Puoi accedere ai valori forniti qui in base al nome nel modello con Fn::GetAtt.

Importante

Se le coppie nome-valore contengono informazioni riservate, è necessario utilizzare il campo NoEcho per mascherare l'output della risorsa personalizzata. In caso contrario, i valori sono visibili tramite API che visualizzano i valori delle proprietà (ad esempio DescribeStackEvents).

Required: No

Tipo: JSON object