View a markdown version of this page

Aggiorna i modelli di asset, i modelli dei componenti e le interfacce - AWS IoT SiteWise
Aggiornamento di un modello di asset, di un modello di componente o di un'interfaccia (console)Aggiornare un modello di asset, un modello di componente o un'interfaccia (AWS CLI)

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

Aggiorna i modelli di asset, i modelli dei componenti e le interfacce

Usa la AWS IoT SiteWise console o l'API per aggiornare un modello di asset, un modello di componente o un'interfaccia.

Non puoi modificare il tipo o il tipo di dati di una proprietà esistente o la finestra di una metrica esistente. Inoltre, non è possibile modificare il tipo di modello da modello di asset a modello di componente o interfaccia o viceversa.

Importante

  • Se rimuovi una proprietà da un modello di asset o da un modello di componente, AWS IoT SiteWise elimina tutti i dati precedenti relativi a quella proprietà. Per i modelli di componenti, ciò influisce su tutti i modelli di asset che utilizzano quel modello di componente, quindi fate particolare attenzione a capire in che misura la modifica può essere applicata.

  • Se rimuovete una definizione gerarchica da un modello di asset, AWS IoT SiteWise dissocia tutti gli asset in quella gerarchia.

Quando aggiorni un modello, anche gli asset basati su quel modello assimilano le modifiche apportate. Fino a quando le modifiche non si propagano, ogni asset ha lo stato UPDATING. È necessario attendere fino a quando gli asset ritornano nello stato ACTIVE prima di poter interagire con loro. In questo lasso di tempo, lo stato del modello di asset aggiornato sarà PROPAGATING.

Quando aggiornate un modello di componente, ogni modello di asset che incorpora quel modello di componente riflette le modifiche. Finché le modifiche del modello di componente non si propagano, ogni modello di asset interessato ha lo UPDATING stato, seguito dall'PROPAGATINGaggiornamento degli asset associati, come descritto nel paragrafo precedente. È necessario attendere che tali modelli di asset ritornino allo ACTIVE stato prima di interagire con essi. Durante questo periodo, lo stato del modello di componente aggiornato saràPROPAGATING.

Per ulteriori informazioni, consulta Stati di asset e modelli.

Aggiornamento di un modello di asset, di un modello di componente o di un'interfaccia (console)

È possibile utilizzare la AWS IoT SiteWise console per aggiornare un modello di asset, un modello di componente o un'interfaccia.

Per aggiornare un modello di asset, un modello di componente o un'interfaccia (console)

  1. Passare alla console AWS IoT SiteWise.

  2. Nel riquadro di navigazione selezionare Models (Modelli).

  3. Scegliete il modello di asset, il modello del componente o l'interfaccia da aggiornare.

  4. Scegli Modifica.

  5. Nella pagina Modifica modello esegui una delle operazioni seguenti:

  6. Selezionare Salva.

Nota

Le richieste di aggiornamento effettuate nella console vengono rifiutate se un altro utente aggiorna correttamente il modello di asset dall'ultima apertura della pagina Modifica modello. La console richiede all'utente di aggiornare la pagina Edit model, per recuperare il modello aggiornato. È necessario effettuare nuovamente gli aggiornamenti e riprovare a salvare. Per ulteriori dettagli, consulta Blocco ottimistico per le scritture del modello di asset.

Aggiornare un modello di asset, un modello di componente o un'interfaccia (AWS CLI)

Utilizzate AWS Command Line Interface (AWS CLI) per aggiornare un modello di asset, un modello di componente o un'interfaccia.

Utilizzate l'UpdateAssetModelAPI per aggiornare il nome, la descrizione e le proprietà di un modello di asset, di un modello di componente o di un'interfaccia. Solo per i modelli di asset, puoi aggiornare le gerarchie. Per le interfacce, è possibile aggiornare proprietà e gerarchie. Specifica i seguenti parametri:

  • assetModelId— L'ID della risorsa. Questo è l'ID effettivo in formato UUID, o externalId:myExternalId se ne ha uno. Per ulteriori informazioni, consulta Oggetti di riferimento con ID esterni nella Guida per l'utente di AWS IoT SiteWise .

Specificate il modello aggiornato nel payload. Per informazioni sul formato previsto di un modello di asset o di un modello di componente, consultaCrea modelli di asset in AWS IoT SiteWise.

avvertimento

L'UpdateAssetModelAPI sovrascrive il modello esistente con il modello fornito nel payload. Per evitare di eliminare le proprietà o le gerarchie del modello, è necessario includerne gli ID e le definizioni nel payload del modello aggiornato. Per informazioni su come interrogare la struttura esistente del modello, guardate l'operazione. DescribeAssetModel

Nota

La procedura seguente può aggiornare solo modelli compositi di tipoAWS/ALARM. Se desideri aggiornare i modelli CUSTOM compositi, usa UpdateAssetModelCompositeModel invece. Per ulteriori informazioni, consulta Aggiornare i modelli compositi personalizzati (componenti).

Per aggiornare un modello di asset o un modello di componente (AWS CLI)

  1. Eseguite il comando seguente per recuperare la definizione del modello esistente. Sostituisci asset-model-id con l'ID o l'ID esterno del modello di asset o del modello di componente da aggiornare.

    aws iotsitewise describe-asset-model --asset-model-id asset-model-id

    Il comando precedente restituisce la definizione del modello corrispondente alla versione più recente del modello.

    Per un caso d'uso in cui un modello di asset è in uno FAILED stato, recupera la definizione valida del modello corrispondente alla sua versione attiva per creare la tua richiesta di aggiornamento. Per informazioni dettagliate, vedi Versioni del modello di asset. Eseguite il comando seguente per recuperare la definizione del modello attivo:

    aws iotsitewise describe-asset-model --asset-model-id asset-model-id --asset-model-version ACTIVE

    L'operazione restituisce una risposta che contiene i dettagli del modello. La risposta ha la seguente struttura.

    {
    "assetModelId": "String",
    "assetModelArn": "String",
    "assetModelName": "String",
    "assetModelDescription": "String",
    "assetModelProperties": Array of AssetModelProperty,
    "assetModelHierarchies": Array of AssetModelHierarchyDefinition,
    "assetModelCompositeModels": Array of AssetModelCompositeModel,
    "assetModelCompositeModelSummaries": Array of AssetModelCompositeModelSummary,
    "assetModelCreationDate": "String",
    "assetModelLastUpdateDate": "String",
    "assetModelStatus": {
      "state": "String",
      "error": {
        "code": "String",
        "message": "String"
      },
    "assetModelType": "String"
    },
    "assetModelVersion": "String",
    "eTag": "String"
}

    Per maggiori informazioni, vedi l'operazione DescribeAssetModel.

  2. Crea un file denominato update-asset-model.json e copia la risposta del comando precedente nel file.

  3. Rimuovi le seguenti coppie chiave-valore dall'oggetto JSON in update-asset-model.json:

    • assetModelId

    • assetModelArn

    • assetModelCompositeModelSummaries

    • assetModelCreationDate

    • assetModelLastUpdateDate

    • assetModelStatus

    • assetModelType

    • assetModelVersion

    • eTag

    L'UpdateAssetModeloperazione prevede un payload con la seguente struttura:

    {
  "assetModelName": "String",
  "assetModelDescription": "String",
  "assetModelProperties": Array of AssetModelProperty,
  "assetModelHierarchies": Array of AssetModelHierarchyDefinition,
  "assetModelCompositeModels": Array of AssetModelCompositeModel
}

  4. In update-asset-model.json, effettua una delle seguenti operazioni:

    • Modifica il nome del modello di asset (assetModelName).

    • Modifica, aggiungi o rimuovi la descrizione del modello di asset (assetModelDescription).

    • Modifica, aggiungi o rimuovi qualsiasi proprietà del modello di asset (assetModelProperties). Non è possibile modificare l'elemento dataType delle proprietà esistenti o l'elemento window dei parametri esistenti. Per ulteriori informazioni, consulta Definire le proprietà dei dati.

    • Modifica, aggiungi o rimuovi una delle gerarchie del modello di asset (assetModelHierarchies). Non è possibile modificare l'elemento childAssetModelId delle gerarchie esistenti. Per ulteriori informazioni, consulta Definire le gerarchie dei modelli di asset.

    • Modificate, aggiungete o rimuovete qualsiasi modello composito di tipo AWS/ALARM () assetModelCompositeModels del modello di asset. Gli allarmi monitorano altre proprietà in modo da poter identificare quando apparecchiature o processi richiedono attenzione. Ogni definizione di allarme è un modello composito che standardizza l'insieme di proprietà utilizzate dall'allarme. Per ulteriori informazioni, consulta Monitora i dati con allarmi in AWS IoT SiteWise e Definisci allarmi sui modelli di asset in AWS IoT SiteWise.

  5. Esegui il comando seguente per aggiornare il modello di asset con la definizione memorizzata in update-asset-model.json. Sostituisci asset-model-id con l'ID del modello di asset:

    aws iotsitewise update-asset-model \
  --asset-model-id asset-model-id \
  --cli-input-json file://model-payload.json
Importante

Quando più utenti aggiornano un modello di asset contemporaneamente, le modifiche di un utente possono essere inavvertitamente sovrascritte da un altro utente. Per evitare che ciò accada, è necessario definire una richiesta di aggiornamento condizionale. Consulta Blocco ottimistico per le scritture del modello di asset.