Operazioni, risorse e chiavi di condizione per Amazon Textract

Amazon Textract (prefisso del servizio: textract) fornisce le seguenti risorse, operazioni e chiavi di contesto della condizione specifiche del servizio per l'utilizzo in policy delle autorizzazioni 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 Textract

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
AnalyzeDocument	Concede l'autorizzazione per rilevare le istanze di entità di documento del mondo reale all'interno di un'immagine fornita come input	Lettura			s3:GetObject
AnalyzeExpense	Concede l'autorizzazione per rilevare le istanze di entità di documento del mondo reale all'interno di un'immagine fornita come input	Lettura			s3:GetObject
AnalyzeID	Concede l'autorizzazione per rilevare informazioni utili dai documenti di identità forniti come input	Lettura			s3:GetObject
CreateAdapter	Concede l'autorizzazione per creare un adattatore Amazon Textract	Scrittura		aws:RequestTag/${TagKey} aws:TagKeys
CreateAdapterVersion	Concede l'autorizzazione per creare una versione dell'adattatore Amazon Textract	Scrittura	adapter*
				aws:RequestTag/${TagKey} aws:TagKeys
DeleteAdapter	Concede l'autorizzazione per eliminare un adattatore Amazon Textract	Scrittura	adapter*
DeleteAdapterVersion	Concede l'autorizzazione per eliminare una versione dell'adattatore Amazon Textract	Scrittura	adapterversion*
DetectDocumentText	Concede l'autorizzazione per rilevare il testo nelle immagini del documento	Lettura			s3:GetObject
GetAdapter	Concede l'autorizzazione per ottenere un adattatore Amazon Textract	Lettura	adapter*
GetAdapterVersion	Concede l'autorizzazione per ottenere una versione dell'adattatore Amazon Textract	Lettura	adapterversion*
GetDocumentAnalysis	Concede l'autorizzazione per restituire le informazioni su un processo di analisi del documento	Lettura
GetDocumentTextDetection	Concede l'autorizzazione per restituire informazioni su un processo di rilevamento del testo di un documento	Lettura
GetExpenseAnalysis	Concede l'autorizzazione per restituire informazioni su un processo di analisi di costi	Lettura
GetLendingAnalysis	Concede l'autorizzazione per recuperare informazioni a livello di pagina relative a un lavoro di analisi dei prestiti	Lettura
GetLendingAnalysisSummary	Concede l'autorizzazione per recuperare informazioni di riepilogo relative a un lavoro di analisi dei prestiti	Lettura
ListAdapterVersions	Concede l'autorizzazione per elencare le versioni dell'adattatore Amazon Textract	Lettura
ListAdapters	Concede l'autorizzazione per elencare gli adattatori Amazon Textract	Lettura
ListTagsForResource	Concede l'autorizzazione per restituire un elenco di tag associati a una risorsa	Lettura	adapter
			adapterversion
StartDocumentAnalysis	Concede l'autorizzazione per avviare un processo asincrono per rilevare le istanze delle entità del documento del mondo reale all'interno di un'immagine o pdf fornito come input	Scrittura			s3:GetObject
StartDocumentTextDetection	Concede l'autorizzazione per avviare un processo asincrono per rilevare il testo in immagini di documenti o pdf	Scrittura			s3:GetObject
StartExpenseAnalysis	Concede l'autorizzazione per avviare un processo asincrono per rilevare le istanze di fatture o ricevute all'interno di un'immagine o di un file PDF fornito come input	Scrittura			s3:GetObject
StartLendingAnalysis	Concede l'autorizzazione per avviare un processo asincrono per il rilevamento di entità in un documento di prestito, con un'immagine o un PDF forniti come input	Scrittura			s3:GetObject
TagResource	Concede l'autorizzazione ad aggiungere uno o più tag a una risorsa	Applicazione di tag	adapter
			adapterversion
				aws:TagKeys aws:RequestTag/${TagKey}
UntagResource	Concede l'autorizzazione per rimuovere uno o più tag dalla risorsa	Assegnazione di tag	adapter
			adapterversion
				aws:TagKeys
UpdateAdapter	Concede l'autorizzazione per aggiornare l'adattatore Amazon Textract	Scrittura	adapter*

Tipi di risorsa definiti da Amazon Textract

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
adapter	arn:${Partition}:textract:${Region}:${Account}:/adapters/${AdapterId}	aws:ResourceTag/${TagKey}
adapterversion	arn:${Partition}:textract:${Region}:${Account}:/adapters/${AdapterId}/versions/${AdapterVersion}	aws:ResourceTag/${TagKey}

Chiavi di condizione per Amazon Textract

Amazon Textract 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	Type
aws:RequestTag/${TagKey}	Filtra l'accesso in base ai tag passati nella richiesta	Stringa
aws:ResourceTag/${TagKey}	Filtra l'accesso in base ai tag associati alla risorsa	Stringa
aws:TagKeys	Filtra l'accesso in base alle chiavi di tag passate nella richiesta	ArrayOfString