Aggiornamento di una risorsa con AWS Cloud Control API - Controllo del cloud API
Composizione del documento di patchIn che modo Cloud Control API aggiorna le risorseMonitoraggio dello stato di avanzamento di una richiesta di risorse di aggiornamento

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

Aggiornamento di una risorsa con AWS Cloud Control API

Utilizzare il update-resource comando per aggiornare una risorsa esistente. Ciò include risorse che non erano state originariamente fornite utilizzando Cloud Control. API

Importante

Sconsigliamo vivamente di utilizzare Cloud Control API per aggiornare risorse gestite attivamente da altri servizi. Ciò può portare a risultati inaspettati. Ad esempio, non utilizzare Cloud Control API per aggiornare le risorse che attualmente fanno parte di uno AWS CloudFormation stack.

Per aggiornare una risorsa esistente, devi specificare l'identificatore della risorsa. Per ulteriori informazioni sulla determinazione dell'identificatore di una risorsa, vedere. Utilizzo dell'identificatore principale di una risorsa

L'aggiornamento di una risorsa comporta la modifica dei valori delle proprietà della risorsa. Le proprietà di una risorsa sono definite nello schema del tipo di risorsa. Ciò include se la proprietà è obbligatoria, valori validi e altri vincoli di proprietà. Per ulteriori informazioni sulla visualizzazione delle definizioni delle proprietà delle risorse, vedere. Visualizzazione degli schemi dei tipi di risorse

Composizione del documento di patch

Per aggiornare una risorsa, dovete innanzitutto definire gli aggiornamenti come un elenco di operazioni di patch contenute in un documento di JSON patch. Questo documento di patch deve rispettare lo standard definito in RFC6902 - JavaScript Object Notation () JSON Patch.

Ogni operazione di patch definisce un singolo aggiornamento a una proprietà di risorsa specifica. Sono richieste le seguenti proprietà:

  • op: il tipo di operazione. Cloud Control API supporta tutte le operazioni definite in RFC 6902: addremove,,replace, movecopy, etest.

  • path: Il percorso della proprietà della risorsa, relativo alla properties sezione dello schema delle risorse.

A seconda dell'operazione, potrebbero essere necessarie proprietà aggiuntive. Per informazioni specifiche, fare riferimento a RFC 6902.

Quando si utilizza il update-resource comando, è possibile specificare il documento di patch in linea come stringa o specificare una posizione per il file.

L'esempio seguente aggiorna la politica di conservazione di una AWS::Logs::LogGrouprisorsa denominata CloudControlApiLogGroup a 90 giorni.

$ aws cloudcontrol update-resource --type-name AWS::Logs::LogGroup \
    --identifier CloudControlApiLogGroup \
    --patch-document '[{"op":"test","path":"RetentionInDays","value":90}]'

In che modo Cloud Control API aggiorna le risorse

Per aggiornare una risorsa, Cloud Control recupera API innanzitutto lo stato corrente della risorsa, quindi la aggiorna in un processo in due fasi:

  • Cloud Control API combina le operazioni di patch specificate nella richiesta di aggiornamento con lo stato corrente della risorsa, per generare lo stato desiderato della risorsa dopo l'aggiornamento. Le operazioni vengono applicate in sequenza nell'ordine in cui appaiono nel documento di patch. Ogni operazione della sequenza viene applicata allo stato corrente della risorsa; lo stato della risorsa risultante diventa l'obiettivo dell'operazione successiva.

    A questo punto, l'intera richiesta di aggiornamento ha esito negativo se:

    • Un'operazione di patch inclusa nella richiesta non è valida.

    • Un'operazione di patch di op tipo test non riesce.

    In questi casi, l'intera richiesta di aggiornamento fallisce e Cloud Control API non aggiorna la risorsa.

  • Cloud Control chiama API quindi il gestore degli aggiornamenti del tipo di risorsa per aggiornare la risorsa.

    Se il gestore degli aggiornamenti si guasta in qualsiasi momento, Cloud Control API non ripristina la risorsa allo stato precedente.

Ad esempio, considera il seguente documento di patch, definito per aggiornare una AWS::Logs::LogGrouprisorsa. Il documento contiene due operazioni di patch. La prima operazione è di tipo test e verifica se la politica di conservazione della risorsa è impostata su 3653 giorni. In tal caso, la risorsa supera il test e Cloud Control API passa all'operazione successiva. Questa operazione sostituisce l'attuale valore della politica di conservazione con 180 giorni. Se la politica di conservazione della risorsa è impostata su un valore diverso da 3653 giorni, la prima test operazione fallisce e Cloud Control API non esegue mai la seconda replace operazione.

[
  {
    "op": "test",
    "path": "/RetentionInDays",
    "value":3653
  },
  {
    "op": "replace",
    "path": "/RetentionInDays",
    "value":180
  }
]

Monitoraggio dello stato di avanzamento di una richiesta di risorse di aggiornamento

Il update-resource comando restituisce un ProgressEvent oggetto che è possibile utilizzare per tenere traccia dello stato corrente della richiesta di funzionamento delle risorse. Per ulteriori informazioni, consulta Monitoraggio dello stato di avanzamento delle richieste di gestione delle risorse.