Azioni, risorse e chiavi di condizione per l' AWS IoT SiteWise

AWS IoT SiteWise (service prefix:iotsitewise) fornisce le seguenti risorse, azioni e chiavi di contesto delle condizioni specifiche del servizio da utilizzare nelle policy di autorizzazione IAM.

Riferimenti:

• Scopri come configurare questo servizio.

• Visualizza un elenco delle operazioni API disponibili per questo servizio.

• Scopri come proteggere questo servizio e le sue risorse utilizzando le policy delle autorizzazioni IAM.

Azioni definite dall' AWS IoT SiteWise

Puoi specificare le seguenti operazioni nell'elemento Action di un'istruzione di policy IAM. Utilizza le policy per concedere le autorizzazioni per eseguire un'operazione in AWS. Quando utilizzi un'operazione in una policy, in genere consenti o rifiuti l'accesso all'operazione API o al comando CLI con lo stesso nome. Tuttavia, in alcuni casi, una singola operazione controlla l'accesso a più di una operazione. In alternativa, alcune operazioni richiedono operazioni differenti.

La colonna Tipi di risorsa della tabella Operazioni indica se ogni operazione supporta le autorizzazioni a livello di risorsa. Se non vi è nessun valore in corrispondenza di questa colonna, è necessario specificare tutte le risorse ("*") alle quali si applica la policy nell'elemento Resource dell'istruzione di policy. Se la colonna include un tipo di risorsa, puoi specificare un ARN di quel tipo in una istruzione con tale operazione. Se l'operazione ha una o più risorse richieste, il chiamante deve disporre dell'autorizzazione per utilizzare l'operazione con tali risorse. Le risorse richieste sono indicate nella tabella con un asterisco (*). Se si limita l'accesso alle risorse con l'elemento Resource in una policy IAM, è necessario includere un ARN o un modello per ogni tipo di risorsa richiesta. Alcune operazioni supportano più tipi di risorse. Se il tipo di risorsa è facoltativo (non indicato come obbligatorio), puoi scegliere di utilizzare uno tra i tipi di risorsa facoltativi.

La colonna Chiavi di condizione della tabella Operazioni contiene le chiavi che è possibile specificare nell'elemento Condition di un'istruzione di policy. Per ulteriori informazioni sulle chiavi di condizione associate alle risorse per il servizio guarda la colonna Chiavi di condizione della tabella Tipi di risorsa.

Nota

Le chiavi relative alle condizioni delle risorse sono elencate nella tabella Tipi di risorse. Nella colonna Tipi di risorse (*obbligatorio) della tabella Operazioni è presente un collegamento al tipo di risorsa che si applica a un'operazione. Il tipo di risorsa nella tabella Tipi di risorse include la colonna Chiavi di condizione, che contiene le chiavi delle condizioni delle risorse che si applicano a un'operazione nella tabella Operazioni.

Per dettagli sulle colonne nella tabella seguente, consultare Tabella delle operazioni.

Azioni	Descrizione	Livello di accesso	Tipi di risorsa (*obbligatorio)	Chiavi di condizione	Operazioni dipendenti
AssociateAssets	Concede l'autorizzazione per associare una risorsa figlio a una risorsa padre attraverso una gerarchia	Scrittura	asset*
AssociateTimeSeriesToAssetProperty	Concede l'autorizzazione per associare una serie temporale a una proprietà della risorsa	Scrittura	asset*
			time-series*
BatchAssociateProjectAssets	Concede l'autorizzazione per associare asset a un progetto	Write	project*
BatchDisassociateProjectAssets	Concede l'autorizzazione per annullare l'associazione di asset a un progetto	Scrittura	project*
BatchGetAssetPropertyAggregates	Concede l'autorizzazione per recuperare gli aggregati calcolati per più proprietà delle risorse	Lettura	asset
			time-series
BatchGetAssetPropertyValue	Concede l'autorizzazione per recuperare il valore più recente per più proprietà delle risorse	Lettura	asset
			time-series
BatchGetAssetPropertyValueHistory	Concede l'autorizzazione per recuperare la cronologia dei valori per più proprietà delle risorse	Lettura	asset
			time-series
BatchPutAssetPropertyValue	Concede l'autorizzazione a inserire valori di proprietà per le proprietà delle risorse	Write	asset
			time-series
CreateAccessPolicy	Concede l'autorizzazione per creare policy d'accesso per un portale o un progetto	Write	portal
			project
				aws:RequestTag/${TagKey} aws:TagKeys
CreateAsset	Concede l'autorizzazione per creare una risorsa da un modello di asset	Write	asset-model*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateAssetModel	Concede l'autorizzazione per creare un modello di asset	Scrittura		aws:RequestTag/${TagKey} aws:TagKeys
CreateAssetModelCompositeModel	Concede l'autorizzazione per creare un modello composito all'interno di un modello di asset	Scrittura	asset-model*
CreateBulkImportJob	Concede l'autorizzazione per creare un processo di importazione in blocco	Scrittura
CreateDashboard	Concede l'autorizzazione per creare un dashboard in un progetto	Write	project*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateGateway	Concede l'autorizzazione per creare un gateway	Write		aws:RequestTag/${TagKey} aws:TagKeys
CreatePortal	Concede l'autorizzazione per creare un portale.	Write		aws:RequestTag/${TagKey} aws:TagKeys	sso:CreateManagedApplicationInstance sso:DescribeRegisteredRegions
CreateProject	Concede l'autorizzazione per creare un progetto in un portale	Write	portal*
				aws:RequestTag/${TagKey} aws:TagKeys
DeleteAccessPolicy	Concede l'autorizzazione per eliminare una policy di accesso	Write	access-policy*
DeleteAsset	Concede l'autorizzazione per eliminare un asset	Write	asset*
DeleteAssetModel	Concede l'autorizzazione per eliminare un modello di asset	Scrittura	asset-model*
DeleteAssetModelCompositeModel	Concede l'autorizzazione per eliminare un modello di asset composito	Scrittura	asset-model*
DeleteDashboard	Concede l'autorizzazione per eliminare un dashboard	Write	dashboard*
DeleteGateway	Concede l'autorizzazione per eliminare un gateway	Write	gateway*
DeletePortal	Concede l'autorizzazione per eliminare un portale	Write	portal*		sso:DeleteManagedApplicationInstance
DeleteProject	Concede l'autorizzazione per eliminare un progetto.	Scrittura	project*
DeleteTimeSeries	Concede l'autorizzazione per eliminare una serie temporale	Scrittura	asset
			time-series
DescribeAccessPolicy	Concede l'autorizzazione per descrivere una policy di accesso	Lettura	access-policy*
DescribeAction	Concede l'autorizzazione per descrivere le operazioni	Lettura	asset
DescribeAsset	Concede l'autorizzazione per descrivere un'asset	Lettura	asset*
DescribeAssetCompositeModel	Concede l'autorizzazione per descrivere un modello di asset composito	Lettura	asset*
DescribeAssetModel	Concede l'autorizzazione per descrivere un modello di asset	Lettura	asset-model*
DescribeAssetModelCompositeModel	Concede l'autorizzazione per descrivere un modello di asset composito	Lettura	asset-model*
DescribeAssetProperty	Concede l'autorizzazione per descrivere una proprietà dell'asset	Lettura	asset*
DescribeBulkImportJob	Concede l'autorizzazione per descrivere un processo di importazione in blocco	Lettura
DescribeDashboard	Concede l'autorizzazione per descrivere un dashboard	Lettura	dashboard*
DescribeDefaultEncryptionConfiguration	Concede l'autorizzazione a descrivere la configurazione di crittografia predefinita per Account AWS	Lettura
DescribeGateway	Concede l'autorizzazione per descrivere un gateway	Read	gateway*
DescribeGatewayCapabilityConfiguration	Concede l'autorizzazione per descrivere una configurazione di funzionalità per un gateway	Lettura	gateway*
DescribeLoggingOptions	Concede l'autorizzazione a descrivere le opzioni di registrazione per Account AWS	Lettura
DescribePortal	Concede l'autorizzazione per descrivere un portale	Read	portal*
DescribeProject	Concede l'autorizzazione per descrivere un progetto	Lettura	project*
DescribeStorageConfiguration	Concede l'autorizzazione a descrivere la configurazione di archiviazione per Account AWS	Lettura
DescribeTimeSeries	Concede l'autorizzazione per descrivere una serie temporale	Lettura	asset
			time-series
				aws:RequestTag/${TagKey} aws:TagKeys
DisassociateAssets	Concede l'autorizzazione per annullare l'associazione di una risorsa figlio da una risorsa padre in base a una gerarchia	Scrittura	asset*
DisassociateTimeSeriesFromAssetProperty	Concede l'autorizzazione per annullare l'associazione di una serie temporale a una proprietà della risorsa	Scrittura	asset*
			time-series*
EnableSiteWiseIntegration [solo autorizzazione]	Concede l'autorizzazione per consentire l' SiteWise integrazione dell'IoT con altri servizi	Scrittura
ExecuteAction	Concede l'autorizzazione per eseguire le operazioni	Scrittura	asset
ExecuteQuery	Concede l'autorizzazione per eseguire una query	Lettura
GetAssetPropertyAggregates	Concede l'autorizzazione per recuperare gli aggregati calcolati per una proprietà dell'asset	Read	asset
			time-series
GetAssetPropertyValue	Concede l'autorizzazione per recuperare il valore più recente per una proprietà dell'asset	Read	asset
			time-series
GetAssetPropertyValueHistory	Concede l'autorizzazione per recuperare la cronologia dei valori per una proprietà dell'asset	Lettura	asset
			time-series
GetInterpolatedAssetPropertyValues	Concede l'autorizzazione per recuperare i valori interpolati per una proprietà della risorsa	Lettura	asset
			time-series
ListAccessPolicies	Concede l'autorizzazione per elencare tutti i criteri di accesso per un'identità o una risorsa	Elenco	portal
			project
ListActions	Concede l'autorizzazione per elencare tutte le operazioni	Elenco	asset
ListAssetModelCompositeModels	Concede l'autorizzazione per elencare tutti i modelli di asset compositi	Elenco	asset-model*
ListAssetModelProperties	Concede l'autorizzazione per elencare le proprietà dei modelli di asset	Elenco	asset-model*
ListAssetModels	Concede l'autorizzazione per elencare tutti i modelli di asset	Elenco
ListAssetProperties	Concede l'autorizzazione per elencare le proprietà degli asset	Elenco	asset*
ListAssetRelationships	Concede l'autorizzazione per elencare il grafico delle relazioni delle risorse per una risorsa	Elenco	asset*
ListAssets	Concede l'autorizzazione per elencare tutte le risorse	Elenco	asset-model
ListAssociatedAssets	Concede l'autorizzazione per elencare tutte le risorse associate a una risorsa attraverso una gerarchia	Elenco	asset*
ListBulkImportJobs	Concede l'autorizzazione per elencare i processi di importazione in blocco	Elenco
ListCompositionRelationships	Concede l'autorizzazione per elencare tutte le relazioni di composizione dei modelli di asset compositi	Elenco	asset-model*
ListDashboards	Concede l'autorizzazione per elencare tutti i dashboard di un progetto	Elenco	project*
ListGateways	Concede l'autorizzazione per elencare tutti i gateway	Elenco
ListPortals	Concede l'autorizzazione per elencare tutti i portali	Elenco
ListProjectAssets	Concede l'autorizzazione per elencare tutte le risorse associate a un progetto	Elenco	project*
ListProjects	Concede l'autorizzazione per elencare tutti i progetti in un portale	Elenco	portal*
ListTagsForResource	Concede l'autorizzazione per elencare tutti i tag per una risorsa	Lettura	access-policy
			asset
			asset-model
			dashboard
			gateway
			portal
			project
			time-series
				aws:ResourceTag/${TagKey}
ListTimeSeries	Concede l'autorizzazione per elencare le serie temporali	Elenco	asset
PutDefaultEncryptionConfiguration	Concede l'autorizzazione a impostare la configurazione di crittografia predefinita per Account AWS	Scrittura
PutLoggingOptions	Concede l'autorizzazione a impostare le opzioni di registrazione per Account AWS	Scrittura
PutStorageConfiguration	Concede l'autorizzazione a configurare le impostazioni di archiviazione per Account AWS	Scrittura
TagResource	Concede l'autorizzazione per applicare un tag a una risorsa.	Applicazione di tag	access-policy
			asset
			asset-model
			dashboard
			gateway
			portal
			project
			time-series
				aws:TagKeys aws:RequestTag/${TagKey}
UntagResource	Concede l'autorizzazione per rimuovere un tag da una risorsa.	Applicazione di tag	access-policy
			asset
			asset-model
			dashboard
			gateway
			portal
			project
			time-series
				aws:TagKeys
UpdateAccessPolicy	Concede l'autorizzazione per l'aggiornamento di una policy di accesso	Write	access-policy*
UpdateAsset	Concede l'autorizzazione per aggiornare un asset	Write	asset*
UpdateAssetModel	Concede l'autorizzazione per l'aggiornamento di un modello di asset	Scrittura	asset-model*
UpdateAssetModelCompositeModel	Concede l'autorizzazione per aggiornare un modello di asset composito	Scrittura	asset-model*
UpdateAssetModelPropertyRouting [solo autorizzazione]	Concede l'autorizzazione ad aggiornare il routing di una proprietà AssetModel	Scrittura	asset-model*
UpdateAssetProperty	Concede l'autorizzazione per l'aggiornamento di una proprietà di un asset	Write	asset*
UpdateDashboard	Concede l'autorizzazione per aggiornare un dashboard	Write	dashboard*
UpdateGateway	Concede l'autorizzazione per aggiornare un gateway	Write	gateway*
UpdateGatewayCapabilityConfiguration	Concede l'autorizzazione per aggiornare una configurazione di funzionalità per un gateway	Write	gateway*
UpdatePortal	Concede l'autorizzazione per aggiornare un portale	Write	portal*
UpdateProject	Concede l'autorizzazione per aggiornare un progetto	Scrittura	project*

Tipi di risorse definiti dall' AWS IoT SiteWise

I seguenti tipi di risorse sono definiti da questo servizio e possono essere utilizzati nell'elemento Resource delle istruzioni di policy delle autorizzazioni IAM. Ogni operazione nella Tabella delle operazioni identifica i tipi di risorse che possono essere specificati con tale operazione. Un tipo di risorsa può anche definire quali chiavi di condizione puoi includere in una policy. Queste chiavi vengono visualizzate nell'ultima colonna della tabella Tipi di risorsa. Per dettagli sulle colonne nella tabella seguente, consulta Tabella dei tipi di risorsa.

Tipi di risorsa	ARN	Chiavi di condizione
asset	arn:${Partition}:iotsitewise:${Region}:${Account}:asset/${AssetId}	aws:ResourceTag/${TagKey}
asset-model	arn:${Partition}:iotsitewise:${Region}:${Account}:asset-model/${AssetModelId}	aws:ResourceTag/${TagKey}
time-series	arn:${Partition}:iotsitewise:${Region}:${Account}:time-series/${TimeSeriesId}	aws:ResourceTag/${TagKey}
gateway	arn:${Partition}:iotsitewise:${Region}:${Account}:gateway/${GatewayId}	aws:ResourceTag/${TagKey}
portal	arn:${Partition}:iotsitewise:${Region}:${Account}:portal/${PortalId}	aws:ResourceTag/${TagKey}
project	arn:${Partition}:iotsitewise:${Region}:${Account}:project/${ProjectId}	aws:ResourceTag/${TagKey}
dashboard	arn:${Partition}:iotsitewise:${Region}:${Account}:dashboard/${DashboardId}	aws:ResourceTag/${TagKey}
access-policy	arn:${Partition}:iotsitewise:${Region}:${Account}:access-policy/${AccessPolicyId}	aws:ResourceTag/${TagKey}

Chiavi di condizione per l' AWS IoT SiteWise

AWS L'IoT SiteWise definisce le seguenti chiavi di condizione che possono essere utilizzate nell'Conditionelemento di una policy IAM. Puoi utilizzare queste chiavi per perfezionare ulteriormente le condizioni in base alle quali si applica l'istruzione di policy. Per dettagli sulle colonne nella tabella seguente, consulta Tabella delle chiavi di condizione.

Per visualizzare le chiavi di condizione globali disponibili per tutti i servizi, consulta Chiavi di condizione globali disponibili.

Chiavi di condizione	Descrizione	Tipo
aws:RequestTag/${TagKey}	Filtra l'accesso dalle coppie chiave-valore tag nella richiesta	Stringa
aws:ResourceTag/${TagKey}	Filtra l'accesso dai tag collegati a una risorsa	Stringa
aws:TagKeys	Filtra l'accesso in base alle chiavi tag nella richiesta	ArrayOfString
iotsitewise:assetHierarchyPath	Filtra l'accesso in base a un percorso gerarchico di asset, ovvero la stringa di ID risorsa nella gerarchia della risorsa, ciascuno separato da una barra	Stringa
iotsitewise:childAssetId	Filtra l'accesso in base all'ID di una risorsa figlio associata a una risorsa padre	Stringa
iotsitewise:group	Filtra l'accesso in base all'ID di un gruppo AWS Single Sign-On	Stringa
iotsitewise:iam	Filtra l'accesso in base all'ID di un' AWS identità IAM	Stringa
iotsitewise:isAssociatedWithAssetProperty	Filtra l'accesso in base ai flussi di dati associati o non associati alle proprietà della risorsa	Stringa
iotsitewise:portal	Filtra l'accesso in base all'ID di un portale	Stringa
iotsitewise:project	Filtri l'accesso in base all'ID di un progetto	Stringa
iotsitewise:propertyAlias	Filtra l'accesso in base all'alias della proprietà	Stringa
iotsitewise:propertyId	Filtra l'accesso in base all'ID di una proprietà asset	Stringa
iotsitewise:user	Filtra l'accesso in base all'ID di un utente AWS Single Sign-On	Stringa