Operazioni, risorse e chiavi di condizione per Amazon Location

Amazon Location Service (prefisso del servizio: geo) fornisce le seguenti risorse, operazioni e chiavi di contesto della condizione specifiche del servizio per l'utilizzo nelle policy di autorizzazione di 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 Amazon Location

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
AssociateTrackerConsumer	Concede l'autorizzazione per creare un'associazione tra una raccolta di geofence e una risorsa del tracker	Scrittura	tracker*
BatchDeleteDevicePositionHistory	Concede l'autorizzazione per eliminare un batch di cronologie di posizione del dispositivo da una risorsa del tracker	Scrittura	tracker*
				geo:DeviceIds
BatchDeleteGeofence	Concede l'autorizzazione per eliminare un batch di geofence da una raccolta di geofence	Scrittura	geofence-collection*
				geo:GeofenceIds
BatchEvaluateGeofences	Concede l'autorizzazione per valutare le posizioni del dispositivo rispetto alla posizione delle geofence in una data raccolta di geofence	Scrittura	geofence-collection*
BatchGetDevicePosition	Concede l'autorizzazione per inviare una richiesta batch per richiamare le posizioni del dispositivo	Lettura	tracker*
				geo:DeviceIds
BatchPutGeofence	Concede l'autorizzazione per inviare una richiesta batch per l'aggiunta di geofence in una determinata raccolta di geofence	Scrittura	geofence-collection*
				geo:GeofenceIds
BatchUpdateDevicePosition	Concede l'autorizzazione per caricare l'aggiornamento di una posizione per uno o più dispositivi su una risorsa del tracker	Scrittura	tracker*
				geo:DeviceIds
CalculateRoute	Concede l'autorizzazione per calcolare i percorsi utilizzando una determinata risorsa di calcolo del percorso	Lettura	route-calculator*
CalculateRouteMatrix	Concede l'autorizzazione per calcolare una matrice di percorso utilizzando una determinata risorsa di calcolo del percorso	Lettura	route-calculator*
CreateGeofenceCollection	Concede l'autorizzazione per creare una raccolta di geofence	Scrittura	geofence-collection*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateKey	Concede l'autorizzazione per creare una risorsa chiave di API	Scrittura	api-key*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateMap	Concede l'autorizzazione per creare una risorsa di mappatura	Scrittura	map*
				aws:RequestTag/${TagKey} aws:TagKeys
CreatePlaceIndex	Concede l'autorizzazione per creare una risorsa indice di luoghi	Scrittura	place-index*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateRouteCalculator	Concede l'autorizzazione per creare una risorsa calcolatrice di route	Scrittura	route-calculator*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateTracker	Concede l'autorizzazione per creare una risorsa del tracker	Scrittura	tracker*
				aws:RequestTag/${TagKey} aws:TagKeys
DeleteGeofenceCollection	Concede l'autorizzazione per eliminare una raccolta di geofence	Scrittura	geofence-collection*
DeleteKey	Concede l'autorizzazione per eliminare una risorsa di chiave API	Scrittura	api-key*
DeleteMap	Concede l'autorizzazione per eliminare una risorsa di mappatura	Scrittura	map*
DeletePlaceIndex	Concede l'autorizzazione per eliminare una risorsa indice di luoghi	Scrittura	place-index*
DeleteRouteCalculator	Concede l'autorizzazione per eliminare una risorsa calcolatrice route	Scrittura	route-calculator*
DeleteTracker	Concede l'autorizzazione per eliminare una risorsa del tracker	Scrittura	tracker*
DescribeGeofenceCollection	Concede l'autorizzazione per richiamare i dettagli di una raccolta di geofence	Lettura	geofence-collection*
DescribeKey	Concede l'autorizzazione per recuperare i dettagli e il segreto delle risorse	Lettura	api-key*
DescribeMap	Concede l'autorizzazione per richiamare i dettagli delle risorse di mappatura	Lettura	map*
DescribePlaceIndex	Concede l'autorizzazione per richiamare i dettagli di una risorsa con indice di luogo	Lettura	place-index*
DescribeRouteCalculator	Concede l'autorizzazione per recuperare i dettagli delle risorse del calcolatore route	Lettura	route-calculator*
DescribeTracker	Concede l'autorizzazione per richiamare i dettagli di una risorsa del tracker	Lettura	tracker*
DisassociateTrackerConsumer	Concede l'autorizzazione per rimuovere l'associazione tra una risorsa del tracker e una raccolta di geofence	Scrittura	tracker*
ForecastGeofenceEvents	Concede l'autorizzazione a prevedere gli eventi per i geofence archiviati in una determinata raccolta di geofence	Lettura	geofence-collection*
GetDevicePosition	Concede l'autorizzazione per richiamare la posizione più recente del dispositivo	Lettura	tracker*
				geo:DeviceIds
GetDevicePositionHistory	Concede l'autorizzazione per richiamare la cronologia delle posizioni del dispositivo	Lettura	tracker*
				geo:DeviceIds
GetGeofence	Concede l'autorizzazione per richiamare i dettagli della geofence da una raccolta di geofence	Lettura	geofence-collection*
				geo:GeofenceIds
GetMapGlyphs	Concede l'autorizzazione per richiamare il file glifo per una risorsa di mappatura	Lettura	map*
GetMapSprites	Concede l'autorizzazione per recuperare il file sprite per una risorsa di mappatura	Lettura	map*
GetMapStyleDescriptor	Concede l'autorizzazione per richiamare il descrittore di stile della mappa da una risorsa di mappatura	Lettura	map*
GetMapTile	Concede l'autorizzazione per richiamare il riquadro della mappa dalla risorsa di mappatura	Lettura	map*
GetPlace	Concede l'autorizzazione per trovare un luogo tramite il suo ID univoco	Lettura	place-index*
ListDevicePositions	Concede l'autorizzazione per richiamare un elenco di dispositivi e le loro ultime posizioni dalla risorsa del tracker specificata	Lettura	tracker*
ListGeofenceCollections	Concede l'autorizzazione per elencare le raccolte di geofence	Elenco	geofence-collection*
ListGeofences	Concede l'autorizzazione per elencare le geofence memorizzate in una determinata raccolta di geofence	Lettura	geofence-collection*
ListKeys	Concede l'autorizzazione per elencare le risorse di chiave API	Elenco	api-key*
ListMaps	Concede l'autorizzazione per elencare le risorse di mappatura	Elenco	map*
ListPlaceIndexes	Concede l'autorizzazione per restituire un elenco di risorse indice di luoghi	Elenco	place-index*
ListRouteCalculators	Concede l'autorizzazione a restituire un elenco delle risorse del calcolatore di route	Elenco	route-calculator*
ListTagsForResource	Concede l'autorizzazione per elencare i tag (metadati) assegnati alla risorsa	Lettura	api-key
			geofence-collection
			map
			place-index
			route-calculator
			tracker
ListTrackerConsumers	Concede l'autorizzazione per richiamare un elenco di raccolte di geofence correntemente associate alla risorsa del tracker specificata	Lettura	tracker*
ListTrackers	Concede l'autorizzazione per restituire un elenco di risorse del tracker	Elenco	tracker*
PutGeofence	Concede l'autorizzazione per aggiungere una nuova geofence o aggiornare una geofence esistente in una determinata raccolta di geofence	Scrittura	geofence-collection*
				geo:GeofenceIds
SearchPlaceIndexForPosition	Concede l'autorizzazione per riportare i geocodici a una determinata coordinata	Lettura	place-index*
SearchPlaceIndexForSuggestions	Concede l'autorizzazione per generare suggerimenti per indirizzi e punti di interesse sulla base di testo in formato libero parziale o errato	Lettura	place-index*
SearchPlaceIndexForText	Concede l'autorizzazione per geocodificare testo in formato libero, ad esempio un indirizzo, un nome, una città o un'area geografica	Lettura	place-index*
TagResource	Concede l'autorizzazione per aggiungere o modificare i tag della risorsa specificata. I tag sono metadati che possono essere utilizzati per gestire una risorsa.	Applicazione di tag	api-key
			geofence-collection
			map
			place-index
			route-calculator
			tracker
				aws:RequestTag/${TagKey} aws:TagKeys
UntagResource	Concede l'autorizzazione per rimuovere i tag specificati (metadati) dalla risorsa	Assegnazione di tag	api-key
			geofence-collection
			map
			place-index
			route-calculator
			tracker
				aws:TagKeys
UpdateGeofenceCollection	Concede l'autorizzazione per aggiornare una raccolta di geofence	Scrittura	geofence-collection*
UpdateKey	Concede l'autorizzazione per aggiornare una risorsa di chiave API	Scrittura	api-key*
UpdateMap	Concede l'autorizzazione per aggiornare una risorsa di mappatura	Scrittura	map*
UpdatePlaceIndex	Concede l'autorizzazione per aggiornare una risorsa indice di luoghi	Scrittura	place-index*
UpdateRouteCalculator	Concede l'autorizzazione per aggiornare una risorsa calcolatrice di routing	Scrittura	route-calculator*
UpdateTracker	Concede l'autorizzazione per aggiornare una risorsa del tracker	Scrittura	tracker*
VerifyDevicePosition	Concede l'autorizzazione a verificare la posizione di un dispositivo	Lettura	tracker*
				geo:DeviceIds

Tipi di risorsa definiti da Amazon Location

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
api-key	arn:${Partition}:geo:${Region}:${Account}:api-key/${KeyName}	aws:ResourceTag/${TagKey}
geofence-collection	arn:${Partition}:geo:${Region}:${Account}:geofence-collection/${GeofenceCollectionName}	aws:ResourceTag/${TagKey} geo:GeofenceIds
map	arn:${Partition}:geo:${Region}:${Account}:map/${MapName}	aws:ResourceTag/${TagKey}
place-index	arn:${Partition}:geo:${Region}:${Account}:place-index/${IndexName}	aws:ResourceTag/${TagKey}
route-calculator	arn:${Partition}:geo:${Region}:${Account}:route-calculator/${CalculatorName}	aws:ResourceTag/${TagKey}
tracker	arn:${Partition}:geo:${Region}:${Account}:tracker/${TrackerName}	aws:ResourceTag/${TagKey} geo:DeviceIds

Chiavi di condizione per Amazon Location

Amazon Location definisce le seguenti chiavi di condizione che possono essere utilizzate nell'elemento Condition 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 in base alla chiave e al valore di un tag in una richiesta	Stringa
aws:ResourceTag/${TagKey}	Filtra l'accesso in base alla presenza di coppie chiave-valore di tag nella richiesta	Stringa
aws:TagKeys	Filtra l'accesso tramite i tasti tag in una richiesta	ArrayOfStringa
geo:DeviceIds	Filtra l'accesso in base alla presenza di ID dispositivo nella richiesta	ArrayOfStringa
geo:GeofenceIds	Filtra l'accesso in base alla presenza di ID geofence nella richiesta	ArrayOfStringa