Risoluzione delle proprietà di sola scrittura

Con il generatore IaC CloudFormation puoi generare un modello utilizzando risorse fornite nel tuo account che non sono già gestite da CloudFormation. Tuttavia, alcune proprietà delle risorse sono designate come di sola scrittura, il che significa che possono essere scritte ma non possono essere lette da CloudFormation, ad esempio una password del database.

Quando si generano modelli CloudFormation da risorse esistenti, le proprietà di sola scrittura rappresentano un problema. Nella maggior parte dei casi, CloudFormation converte queste proprietà in parametri nel modello generato. Ciò consente di inserire le proprietà come valori dei parametri durante le operazioni di importazione. Tuttavia, ci sono scenari in cui questa conversione non è possibile e CloudFormation gestisce questi casi in modo diverso.

Proprietà che si escludono a vicenda

Alcune risorse dispongono di più set di proprietà che si escludono a vicenda, alcune delle quali sono di sola scrittura. In questi casi, il generatore IaC non è in grado di determinare quale insieme di proprietà esclusive sia stato applicato alla risorsa durante la creazione. Ad esempio, è possibile fornire il codice per una AWS::Lambda::Function utilizzando uno di questi set di proprietà.

• Code/S3Bucket, Code/S3Key e facoltativamente Code/S3ObjectVersion

• Code/ImageUri

• Code/ZipFile

Tutte queste proprietà sono di sola scrittura. Il generatore IaC seleziona uno dei set esclusivi di proprietà e li aggiunge al modello generato. I parametri vengono aggiunti per ciascuna delle proprietà di sola scrittura. I nomi dei parametri includono OneOf e le relative descrizioni indicano che la proprietà corrispondente può essere sostituita con altre proprietà esclusive. Il generatore IaC imposta un tipo di avviso MUTUALLY_EXCLUSIVE_PROPERTIES per le proprietà incluse.

Tipi che si escludono a vicenda

In alcuni casi, una proprietà di sola scrittura può contenere più tipi di dati. Ad esempio, la proprietà Body di AWS::ApiGateway::RestApi può essere un object o una string. In questo caso, il generatore IaC include la proprietà nel modello generato utilizzando il tipo di string e imposta un tipo di avviso di MUTUALLY_EXCLUSIVE_TYPES.

Proprietà Array

Se una proprietà di sola scrittura ha un tipo di array, il generatore IaC non può includerla nel modello generato perché i parametri possono essere solo valori scalari. In questo caso, la proprietà viene omessa dal modello e viene impostato un tipo di avviso di UNSUPPORTED_PROPERTIES.

Proprietà facoltative

Per le proprietà opzionali di sola scrittura, il generatore IaC non è in grado di rilevare se la proprietà sia stata utilizzata durante l’impostazione della risorsa. In questo caso, la proprietà viene omessa dal modello generato e viene impostato un tipo di avviso di UNSUPPORTED_PROPERTIES.

Avvisi e fasi successive

Per determinare quali proprietà sono di sola scrittura è necessario esaminare gli avvisi restituiti dalla console del generatore IaC. Le Informazioni di riferimento sui tipi di proprietà e di risorseAWS non indicano se una proprietà è di sola scrittura o se supporta più tipi.

In alternativa, puoi vedere quali proprietà sono di sola scrittura dagli schemi dei provider di risorse. Per scaricare gli schemi dei provider di risorse, consulta CloudFormation resource provider schemas.

Per risolvere i problemi relativi alle proprietà di sola scrittura

1. Apri la pagina del generatore IaC della console CloudFormation.

2. Nella barra di navigazione, nella parte superiore della schermata, seleziona Regione AWS per il modello.

3. Scegli la scheda Modelli, quindi scegli il nome del modello che hai creato.

4. Nella scheda Definizione del modello, quando il modello generato include risorse con proprietà di sola scrittura, la console del generatore IaC mostra un avviso con un riepilogo del tipo di problemi. Ad esempio:

   

5. Scegli Visualizza dettagli degli avvisi per maggiori informazioni. Le risorse con proprietà di sola scrittura sono identificate dall’ID logico utilizzato nel modello e nel tipo di risorsa generati.

   Utilizza l’elenco di avvisi per identificare le risorse con proprietà di sola scrittura e analizza ogni risorsa per determinare quali modifiche (se presenti) devono essere apportate al modello generato.

   

6. Se il modello deve essere aggiornato per risolvere problemi con le proprietà di sola scrittura, procedi come segue:

   1. Per scaricare una copia del modello, scegli Scarica.

   2. Modifica il modello.

   3. Una volta completate le modifiche, puoi scegliere il pulsante Importa modello modificato per continuare il processo di importazione.