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à.
Operazioni, risorse e chiavi di condizione per Amazon Comprehend
Amazon Comprehend (prefisso del servizio: comprehend) 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.
Argomenti
Operazioni definite da Amazon Comprehend
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.
| Operazioni | Descrizione | Livello di accesso | Tipi di risorsa (*obbligatorio) | Chiavi di condizione | Operazioni dipendenti |
|---|---|---|---|---|---|
| BatchDetectDominantLanguage | Concede l'autorizzazione per rilevare la lingua o le lingue presenti nell'elenco dei documenti di testo | Lettura | |||
| BatchDetectEntities | Concede l'autorizzazione per rilevare le entità denominate ("Persone", "Luoghi", "Posizioni", ecc.) all'interno di uno specifico elenco di documenti di testo | Lettura | |||
| BatchDetectKeyPhrases | Concede l'autorizzazione per rilevare le frasi più indicative dei contenuti all'interno dell'elenco dei documenti di testo | Lettura | |||
| BatchDetectSentiment | Concede l'autorizzazione per rilevare il sentiment di un testo nell'elenco dei documenti (positivo, negativo, neutro o misto) | Lettura | |||
| BatchDetectSyntax | Concede l'autorizzazione per rilevare le informazioni sintattiche (come parti del discorso, token) in un elenco di documenti di testo | Lettura | |||
| BatchDetectTargetedSentiment | Concede l'autorizzazione per rilevare i sentiment associati a entità specifiche (come marchi o prodotti) all'interno di uno specifico elenco di documenti di testo | Lettura | |||
| ClassifyDocument | Concede l'autorizzazione per creare una nuova richiesta di classificazione dei documenti per analizzare un singolo documento in tempo reale, utilizzando un modello personalizzato creato e addestrato in precedenza e un endpoint | Lettura | |||
| ContainsPiiEntities | Concede l'autorizzazione a classificare in tempo reale le informazioni di identificazione personale all'interno di determinati documenti | Lettura | |||
| CreateDataset | Concede l'autorizzazione per creare un nuovo set di dati in un flywheel | Scrittura | |||
| CreateDocumentClassifier | Concede l'autorizzazione per creare un nuovo classificatore di documenti che è possibile utilizzare per classificare i documenti | Scrittura | |||
| CreateEndpoint | Concede l'autorizzazione per creare un endpoint specifico del modello per l'inferenza sincrona per un modello personalizzato addestrato in precedenza | Scrittura | |||
| CreateEntityRecognizer | Concede l'autorizzazione per creare un'entità di riconoscimento utilizzando i file forniti | Scrittura | |||
| CreateFlywheel | Concede l'autorizzazione per creare un nuovo flywheel che è possibile utilizzare per addestrare le versioni dei modelli | Scrittura | |||
| DeleteDocumentClassifier | Concede l'autorizzazione per eliminare un classificatore di documenti creato in precedenza | Scrittura | |||
| DeleteEndpoint | Concede l'autorizzazione per eliminare un endpoint specifico del modello per un modello personalizzato precedentemente addestrato. Per eliminare il modello, è necessario eliminare tutti gli endpoint | Scrittura | |||
| DeleteEntityRecognizer | Concede l'autorizzazione per eliminare un riconoscimento delle entità fornito | Scrittura | |||
| DeleteFlywheel | Concede l'autorizzazione per eliminare un flywheel | Scrittura | |||
| DeleteResourcePolicy | Concede l'autorizzazione per rimuovere la policy della risorsa | Scrittura | |||
| DescribeDataset | Concede l'autorizzazione per ottenere le proprietà associate a un set di dati | Lettura | |||
| DescribeDocumentClassificationJob | Concede l'autorizzazione per ottenere le proprietà associate a un processo di classificazione dei documenti | Lettura | |||
| DescribeDocumentClassifier | Concede l'autorizzazione per ottenere le proprietà associate a un classificatore di documenti | Lettura | |||
| DescribeDominantLanguageDetectionJob | Concede l'autorizzazione per ottenere le proprietà associate a un processo di rilevamento della lingua dominante | Lettura | |||
| DescribeEndpoint | Concede l'autorizzazione per ottenere le proprietà associate a un endpoint specifico. Utilizza questa operazione per ottenere lo stato di un endpoint | Lettura | |||
| DescribeEntitiesDetectionJob | Concede l'autorizzazione per ottenere le proprietà associate a un processo di rilevamento delle entità | Lettura | |||
| DescribeEntityRecognizer | Concede l'autorizzazione per fornire dettagli su un riconoscitore di entità, tra cui lo stato, i bucket S3 che contengono i dati di addestramento, i metadati del riconoscitore, i parametri e così via | Lettura | |||
| DescribeEventsDetectionJob | Concede l'autorizzazione per ottenere le proprietà associate a un processo di rilevamento eventi | Lettura | |||
| DescribeFlywheel | Concede l'autorizzazione per ottenere le proprietà associate a un flywheel | Lettura | |||
| DescribeFlywheelIteration | Concede l'autorizzazione per ottenere le proprietà associate a un'iterazione flywheel per il flywheel | Lettura | |||
| DescribeKeyPhrasesDetectionJob | Concede l'autorizzazione per ottenere le proprietà associate a un processo di rilevamento delle frasi chiave | Lettura | |||
| DescribePiiEntitiesDetectionJob | Concede l'autorizzazione per ottenere le proprietà associate a un processo di rilevamento delle entità PII | Lettura | |||
| DescribeResourcePolicy | Concede l'autorizzazione per leggere la policy allegata della risorsa | Lettura | |||
| DescribeSentimentDetectionJob | Concede l'autorizzazione per ottenere le proprietà associate a un processo di rilevamento del sentiment | Lettura | |||
| DescribeTargetedSentimentDetectionJob | Concede l'autorizzazione per ottenere le proprietà associate a un processo di rilevamento dell'emozione | Lettura | |||
| DescribeTopicsDetectionJob | Concede l'autorizzazione per ottenere le proprietà associate a un processo di rilevamento degli argomenti | Lettura | |||
| DetectDominantLanguage | Concede l'autorizzazione per rilevare la lingua o le lingue presenti nel testo | Lettura | |||
| DetectEntities | Concede l'autorizzazione per rilevare le entità denominate ("Persone", "Luoghi", "Posizioni", ecc.) all'interno di uno specifico documento di testo | Lettura | |||
| DetectKeyPhrases | Concede l'autorizzazione per rilevare nel testo le frasi più indicative dei contenuti | Lettura | |||
| DetectPiiEntities | Concede l'autorizzazione per rilevare le entità di informazioni personali ("Nome", "SSN", "PIN", ecc.) all'interno del documento di testo specificato | Lettura | |||
| DetectSentiment | Concede l'autorizzazione per rilevare il sentiment di un testo in un documento (positivo, negativo, neutro o misto) | Lettura | |||
| DetectSyntax | Concede l'autorizzazione per rilevare le informazioni sintattiche (come parti del discorso, token) in un documento di testo | Lettura | |||
| DetectTargetedSentiment | Concede l'autorizzazione per rilevare i sentiment associati a entità specifiche (come marchi o prodotti) in un documento | Lettura | |||
| DetectToxicContent | Concede l'autorizzazione per rilevare contenuti inappropriati all'interno di un determinato elenco di segmenti di testo | Lettura | |||
| ImportModel | Concede l'autorizzazione per importare un modello Comprehend addestrato | Scrittura | |||
| ListDatasets | Concede l'autorizzazione per ottenere un elenco dei set di dati associato a un flywheel | Lettura | |||
| ListDocumentClassificationJobs | Concede l'autorizzazione per ottenere un elenco dei processi di classificazione dei documenti forniti | Lettura | |||
| ListDocumentClassifierSummaries | Concede l'autorizzazione per ottenere un elenco dei riepiloghi dei classificatori di documenti creati | Lettura | |||
| ListDocumentClassifiers | Concede l'autorizzazione per ottenere un elenco dei classificatori di documenti creati | Lettura | |||
| ListDominantLanguageDetectionJobs | Concede l'autorizzazione per ottenere un elenco dei processi di rilevamento della lingua dominante forniti | Lettura | |||
| ListEndpoints | Concede l'autorizzazione per ottenere un elenco di tutti gli endpoint esistenti creati | Lettura | |||
| ListEntitiesDetectionJobs | Concede l'autorizzazione per ottenere un elenco dei processi di rilevamento entità forniti | Lettura | |||
| ListEntityRecognizerSummaries | Concede l'autorizzazione per ottenere un elenco dei riepiloghi per i riconoscitori di entità creati | Lettura | |||
| ListEntityRecognizers | Concede l'autorizzazione per ottenere l'elenco delle proprietà di tutti i riconoscitori di entità creati, tra cui i riconoscitori attualmente in corso di addestramento | Lettura | |||
| ListEventsDetectionJobs | Concede l'autorizzazione per ottenere un elenco di processi di rilevamento eventi forniti | Lettura | |||
| ListFlywheelIterationHistory | Concede l'autorizzazione per ottenere un elenco delle iterazioni associate per un flywheel | Lettura | |||
| ListFlywheels | Concede l'autorizzazione per ottenere un elenco dei flywheel creati | Lettura | |||
| ListKeyPhrasesDetectionJobs | Concede l'autorizzazione per ottenere un elenco dei processi di rilevamento delle frasi chiave forniti | Lettura | |||
| ListPiiEntitiesDetectionJobs | Concede l'autorizzazione per ottenere un elenco di processi di rilevamento entità PII forniti | Lettura | |||
| ListSentimentDetectionJobs | Concede l'autorizzazione per ottenere un elenco di processi di rilevamento del sentiment forniti | Lettura | |||
| ListTagsForResource | Concede l'autorizzazione per elencare i tag per una risorsa | Lettura | |||
| ListTargetedSentimentDetectionJobs | Concede l'autorizzazione per ottenere un elenco di processi di rilevamento dell'emozione forniti | Lettura | |||
| ListTopicsDetectionJobs | Concede l'autorizzazione per ottenere un elenco di processi di rilevamento degli argomenti forniti | Lettura | |||
| PutResourcePolicy | Concede l'autorizzazione per allegare una policy alla risorsa | Scrittura | |||
| StartDocumentClassificationJob | Concede l'autorizzazione per avviare un processo di classificazione dei documenti asincrono | Scrittura | |||
| StartDominantLanguageDetectionJob | Concede l'autorizzazione per avviare un processo di rilevamento della lingua dominante asincrono per una raccolta di documenti | Scrittura | |||
| StartEntitiesDetectionJob | Concede l'autorizzazione per avviare un processo di rilevamento delle entità asincrono per una raccolta di documenti | Scrittura | |||
| StartEventsDetectionJob | Concede l'autorizzazione per avviare un processo di rilevamento eventi asincrono per una raccolta di documenti | Scrittura | |||
| StartFlywheelIteration | Concede l'autorizzazione per avviare un'iterazione flywheel per un flywheel | Scrittura | |||
| StartKeyPhrasesDetectionJob | Concede l'autorizzazione per avviare un processo di rilevamento delle frasi chiave asincrono per una raccolta di documenti | Scrittura | |||
| StartPiiEntitiesDetectionJob | Concede l'autorizzazione per avviare un processo di rilevamento delle entità PII asincrono per una raccolta di documenti | Scrittura | |||
| StartSentimentDetectionJob | Concede l'autorizzazione per avviare un processo di rilevamento del sentiment asincrono per una raccolta di documenti | Scrittura | |||
| StartTargetedSentimentDetectionJob | Concede l'autorizzazione per avviare un processo di rilevamento dell'emozione asincrono per una raccolta di documenti | Scrittura | |||
| StartTopicsDetectionJob | Concede l'autorizzazione per avviare un processo asincrono per rilevare gli argomenti più comuni nella raccolta di documenti e le frasi associate a ciascun argomento | Scrittura | |||
| StopDominantLanguageDetectionJob | Concede l'autorizzazione per arrestare un processo di rilevamento della lingua dominante | Scrittura | |||
| StopEntitiesDetectionJob | Concessione dell'autorizzazione per arrestare un processo di rilevamento delle entità | Scrittura | |||
| StopEventsDetectionJob | Concessione dell'autorizzazione per arrestare un processo di rilevamento eventi | Scrittura | |||
| StopKeyPhrasesDetectionJob | Concessione dell'autorizzazione per arrestare un processo di rilevamento delle frasi chiave | Scrittura | |||
| StopPiiEntitiesDetectionJob | Concede l'autorizzazione per arrestare un processo di rilevamento delle entità PII | Scrittura | |||
| StopSentimentDetectionJob | Concessione dell'autorizzazione per arrestare un processo di rilevamento del sentiment | Scrittura | |||
| StopTargetedSentimentDetectionJob | Concessione dell'autorizzazione per arrestare un processo di rilevamento dell'emozione | Scrittura | |||
| StopTrainingDocumentClassifier | Concede l'autorizzazione per arrestare un processo di addestramento per classificatori di documenti creato in precedenza | Scrittura | |||
| StopTrainingEntityRecognizer | Concede l'autorizzazione per arrestare un processo di addestramento per il riconoscimento di entità creato in precedenza | Scrittura | |||
| TagResource | Concede l'autorizzazione per applicare tag a una risorsa con determinate coppie di chiave/valore | Applicazione di tag | |||
| UntagResource | Concede l'autorizzazione per rimuovere l'etichetta di una risorsa con una determinata chiave | Applicazione di tag | |||
| UpdateEndpoint | Concede l'autorizzazione per aggiornare le informazioni sull'endpoint specificato | Scrittura | |||
| UpdateFlywheel | Concede l'autorizzazione per aggiornare una configurazione dei flywheel | Scrittura | |||
Tipi di risorsa definiti da Amazon Comprehend
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 |
|---|---|---|
| targeted-sentiment-detection-job |
arn:${Partition}:comprehend:${Region}:${Account}:targeted-sentiment-detection-job/${JobId}
|
|
| document-classifier |
arn:${Partition}:comprehend:${Region}:${Account}:document-classifier/${DocumentClassifierName}
|
|
| document-classifier-endpoint |
arn:${Partition}:comprehend:${Region}:${Account}:document-classifier-endpoint/${DocumentClassifierEndpointName}
|
|
| entity-recognizer |
arn:${Partition}:comprehend:${Region}:${Account}:entity-recognizer/${EntityRecognizerName}
|
|
| entity-recognizer-endpoint |
arn:${Partition}:comprehend:${Region}:${Account}:entity-recognizer-endpoint/${EntityRecognizerEndpointName}
|
|
| dominant-language-detection-job |
arn:${Partition}:comprehend:${Region}:${Account}:dominant-language-detection-job/${JobId}
|
|
| entities-detection-job |
arn:${Partition}:comprehend:${Region}:${Account}:entities-detection-job/${JobId}
|
|
| pii-entities-detection-job |
arn:${Partition}:comprehend:${Region}:${Account}:pii-entities-detection-job/${JobId}
|
|
| events-detection-job |
arn:${Partition}:comprehend:${Region}:${Account}:events-detection-job/${JobId}
|
|
| key-phrases-detection-job |
arn:${Partition}:comprehend:${Region}:${Account}:key-phrases-detection-job/${JobId}
|
|
| sentiment-detection-job |
arn:${Partition}:comprehend:${Region}:${Account}:sentiment-detection-job/${JobId}
|
|
| topics-detection-job |
arn:${Partition}:comprehend:${Region}:${Account}:topics-detection-job/${JobId}
|
|
| document-classification-job |
arn:${Partition}:comprehend:${Region}:${Account}:document-classification-job/${JobId}
|
|
| flywheel |
arn:${Partition}:comprehend:${Region}:${Account}:flywheel/${FlywheelName}
|
|
| flywheel-dataset |
arn:${Partition}:comprehend:${Region}:${Account}:flywheel/${FlywheelName}/dataset/${DatasetName}
|
Chiavi di condizione per Amazon Comprehend
Amazon Comprehend 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 richiedendo i valori dei tag presenti in una richiesta di creazione risorse | Stringa |
| aws:ResourceTag/${TagKey} | Filtra l'accesso richiedendo il valore di tag associato alla risorsa | Stringa |
| aws:TagKeys | Filtra l'accesso richiedendo la presenza di tag obbligatori nella richiesta | ArrayOfString |
| comprehend:DataLakeKmsKey | Filtra l'accesso tramite la chiave DataLake Kms associata alla risorsa flywheel nella richiesta | ARN |
| comprehend:FlywheelIterationId | Filtra l'accesso in base a un particolare ID di iterazione per un flywheel | Stringa |
| comprehend:ModelKmsKey | Filtra l'accesso in base alla chiave KMS del modello associata alla risorsa nella richiesta | ARN |
| comprehend:OutputKmsKey | Filtra l'accesso in base alla chiave KMS di output associata alla risorsa nella richiesta | ARN |
| comprehend:VolumeKmsKey | Filtra l'accesso in base alla chiave KMS del volume associata alla risorsa nella richiesta | ARN |
| comprehend:VpcSecurityGroupIds | Filtra l'accesso in base all'elenco di tutti gli ID gruppo di sicurezza del VPC associati alla risorsa nella richiesta | ArrayOfString |
| comprehend:VpcSubnets | Filtra l'accesso in base all'elenco di tutte le sottoreti VPC associate alla risorsa nella richiesta | ArrayOfString |
