Operazioni, risorse e chiavi di condizione per AWS IoT 1-Click

AWS IoT 1-Click (prefisso del servizio:iot1click) 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 di IAM.

Operazioni definite da AWS IoT 1-Click

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
AssociateDeviceWithPlacement	Concede l'autorizzazione per associare un dispositivo a un posizionamento	Write	project*
ClaimDevicesByClaimCode	Concede l'autorizzazione per richiedere un batch di dispositivi con un codice attestazione	Read
CreatePlacement	Concede l'autorizzazione per creare un nuovo posizionamento in un progetto	Write	project*
CreateProject	Concede l'autorizzazione per creare un nuovo progetto	Write	project*
				aws:RequestTag/${TagKey} aws:TagKeys
DeletePlacement	Concede l'autorizzazione per eliminare un posizionamento da un progetto	Write	project*
DeleteProject	Concede l'autorizzazione per eliminare un progetto.	Write	project*
DescribeDevice	Concede l'autorizzazione per descrivere un dispositivo	Read	device*
DescribePlacement	Concede l'autorizzazione per descrivere un predittore	Read	project*
DescribeProject	Concede l'autorizzazione per descrivere un progetto	Read	project*
DisassociateDeviceFromPlacement	Concede l'autorizzazione per dissociare un dispositivo da un posizionamento	Write	project*
FinalizeDeviceClaim	Concede l'autorizzazione per finalizzare un'attestazione dispositivo	Read	device*
				aws:RequestTag/${TagKey} aws:TagKeys
GetDeviceMethods	Concede l'autorizzazione per ottenere i metodi disponibili di un dispositivo	Read	device*
GetDevicesInPlacement	Concede l'autorizzazione per ottenere i dispositivi associati a un posizionamento	Read	project*
InitiateDeviceClaim	Concede l'autorizzazione per inizializzare un'attestazione dispositivo	Read	device*
InvokeDeviceMethod	Concede l'autorizzazione per richiamare un metodo dispositivo	Write	device*
ListDeviceEvents	Concede l'autorizzazione ad elencare gli eventi passati pubblicati da un dispositivo	Read	device*
ListDevices	Concede l'autorizzazione per elencare tutti i dispositivi	Elenco
ListPlacements	Concede l'autorizzazione per elencare i posizionamenti in un progetto	Read	project*
ListProjects	Concede l'autorizzazione per elencare tutti i progetti	Elenco
ListTagsForResource	Concede l'autorizzazione per elencare i tag per una risorsa	Read	device
			project
TagResource	Concede l'autorizzazione per aggiungere o modificare i tag di una risorsa	Applicazione di tag	device
			project
				aws:RequestTag/${TagKey} aws:TagKeys
UnclaimDevice	Concede l'autorizzazione per annullare l'attestazione di un dispositivo	Read	device*
UntagResource	Concede l'autorizzazione per rimuovere i tag specificati (metadati) da una risorsa	Applicazione di tag	device
			project
				aws:TagKeys
UpdateDeviceState	Concede l'autorizzazione per aggiornare lo stato del dispositivo	Write	device*
UpdatePlacement	Concede l'autorizzazione per aggiornare un posizionamento	Write	project*
UpdateProject	Aggiorna un progetto	Write	project*

Tipi di risorsa definiti da AWS IoT 1-Click

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
device	arn:${Partition}:iot1click:${Region}:${Account}:devices/${DeviceId}	aws:ResourceTag/${TagKey}
project	arn:${Partition}:iot1click:${Region}:${Account}:projects/${ProjectName}	aws:ResourceTag/${TagKey}

Chiavi di condizione per AWS IoT 1-Click

AWS IoT 1-Click 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 le operazioni in base ai tag passati nella richiesta	Stringa
aws:ResourceTag/${TagKey}	Filtra le operazioni in base ai tag associati alla risorsa.	Stringa
aws:TagKeys	Filtra le operazioni in base alle chiavi di tag passate nella richiesta	ArrayOfString