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à. # API del contesto aziendale L'API del contesto aziendale descrive i tipi di dati e le operazioni per la gestione di risorse, tipi di risorse, tipi di modulo, glossari, termini del glossario, allegati e la ricerca nel Data Catalog. AWS Glue ## Tipi di dati + [AssetFormEntry struttura](#aws-glue-api-catalog-aws-glue-api-semantics-AssetFormEntry) + [AssetTypeFormReference struttura](#aws-glue-api-catalog-aws-glue-api-semantics-AssetTypeFormReference) + [IterableFormEntry struttura](#aws-glue-api-catalog-aws-glue-api-semantics-IterableFormEntry) + [IterableFormItem struttura](#aws-glue-api-catalog-aws-glue-api-semantics-IterableFormItem) + [IterableFormListItem struttura](#aws-glue-api-catalog-aws-glue-api-semantics-IterableFormListItem) + [SearchResultItem struttura](#aws-glue-api-catalog-aws-glue-api-semantics-SearchResultItem) + [SearchSort struttura](#aws-glue-api-catalog-aws-glue-api-semantics-SearchSort) + [SearchFilterClause struttura](#aws-glue-api-catalog-aws-glue-api-semantics-SearchFilterClause) + [SearchAttributeFilter struttura](#aws-glue-api-catalog-aws-glue-api-semantics-SearchAttributeFilter) + [SearchFilterValue struttura](#aws-glue-api-catalog-aws-glue-api-semantics-SearchFilterValue) + [ItemError struttura](#aws-glue-api-catalog-aws-glue-api-semantics-ItemError) + [GetAssetOutput struttura](#aws-glue-api-catalog-aws-glue-api-semantics-GetAssetOutput) + [SearchOutput struttura](#aws-glue-api-catalog-aws-glue-api-semantics-SearchOutput) ## AssetFormEntry struttura Un modulo su una risorsa, costituito dall'identificatore del tipo di modulo e dal relativo contenuto JSON. **Campi** + `FormTypeId`— UTF-8 stringa, lunga non meno di 1 o più di 256 byte. L'identificatore del tipo di modulo che definisce lo schema di questo modulo. + `Content`— UTF-8 stringa. Il contenuto JSON del modulo, conforme allo schema del tipo di modulo specificato. ## AssetTypeFormReference struttura Un riferimento a un tipo di modulo incluso in un tipo di risorsa. **Campi** + `FormTypeIdentifier`— *Obbligatorio:* UTF-8 stringa, lunga non meno di 1 o più di 256 byte. L'identificatore del tipo di modulo a cui si fa riferimento. ## IterableFormEntry struttura Un modulo iterabile disponibile su una risorsa, identificato dal tipo di modulo. **Campi** + `FormTypeId`— UTF-8 stringa, lunga non meno di 1 o più di 256 byte. L'identificatore del tipo di modulo del modulo iterabile (ad esempio,`columns`), utilizzato per recuperarne gli elementi tramite o. `ListIterableForms` `BatchGetIterableForms` ## IterableFormItem struttura Un elemento di modulo iterabile completo con i suoi moduli. **Campi** + `ItemId`— UTF-8 stringa. L'identificatore univoco dell'articolo. + `ItemName`— UTF-8 stringa. Nome dell'elemento. + `GlossaryTerms`— Una matrice di UTF-8 stringhe, non meno di 1 o più di 10 stringhe. Gli identificatori dei termini del glossario associati all'elemento. + `Forms`: una matrice della mappa di coppie chiave-valore. Ogni chiave è una UTF-8 stringa. Ogni valore è un oggetto [AssetFormEntry](#aws-glue-api-catalog-aws-glue-api-semantics-AssetFormEntry). I moduli sull'elemento, digitati in base al nome del modulo. + `Attachments`: una matrice della mappa di coppie chiave-valore. Ogni chiave è una UTF-8 stringa. Ogni valore è un oggetto [AssetFormEntry](#aws-glue-api-catalog-aws-glue-api-semantics-AssetFormEntry). Allegati aggiuntivi sull'elemento per un maggiore contesto, digitati in base al nome dell'allegato. ## IterableFormListItem struttura Un riepilogo di un elemento in forma iterabile. **Campi** + `ItemId`— UTF-8 stringa. L'identificatore univoco dell'articolo. + `ItemName`— UTF-8 stringa. Nome dell'elemento. + `Description`— UTF-8 corda. La descrizione dell'articolo. + `GlossaryTerms`— Una matrice di UTF-8 stringhe, non meno di 1 o più di 10 stringhe. Gli identificatori dei termini del glossario associati all'elemento. ## SearchResultItem struttura Un singolo elemento del risultato di ricerca che rappresenta una risorsa corrispondente. **Campi** + `Id`— UTF-8 stringa, lunga non meno di 1 o più di 1087 byte, corrispondente a. `String` L'identificatore univoco dell'asset corrispondente. + `AssetName`— stringa UTF-8 . Il nome dell'asset corrispondente. + `AssetDescription`— UTF-8 stringa. La descrizione dell'asset abbinato. + `UpdatedAt`: timestamp. Il timestamp in cui l'asset corrispondente è stato aggiornato l'ultima volta. + `AssetTypeId`— UTF-8 stringa, lunga non meno di 1 o più di 256 byte. L'identificatore del tipo di risorsa per l'asset corrispondente. ## SearchSort struttura I criteri di ordinamento per i risultati della ricerca. **Campi** + `Attribute`— *Obbligatorio:* UTF-8 stringa di lunghezza non inferiore a 1 o superiore a 128 byte. L'attributo in base al quale ordinare. + `Order`— UTF-8 stringa (valori validi: `ASCENDING` \|`DESCENDING`). Il criterio di ordinamento. I valori validi sono `ASCENDING` e `DESCENDING`. ## SearchFilterClause struttura Una clausola di filtro che supporta la logica booleana annidata. È necessario specificare esattamente uno dei `andAllFilters``orAnyFilters`,`attributeFilter`, o`mapFilter`. **Campi** + `AndAllFilters`— Una serie di [SearchFilterClause](#aws-glue-api-catalog-aws-glue-api-semantics-SearchFilterClause) oggetti, non meno di 1 o più di 10 strutture. Un elenco di clausole di filtro che devono corrispondere tutte (AND logico). + `OrAnyFilters`— Una serie di [SearchFilterClause](#aws-glue-api-catalog-aws-glue-api-semantics-SearchFilterClause) oggetti, non meno di 1 o più di 10 strutture. Un elenco di clausole di filtro a cui almeno una deve corrispondere (OR logico). + `AttributeFilter`: un oggetto [SearchAttributeFilter](#aws-glue-api-catalog-aws-glue-api-semantics-SearchAttributeFilter). Un filtro su un singolo valore di attributo. + `MapFilter` – . Un filtro sulla coppia chiave-valore di un attributo della mappa. ## SearchAttributeFilter struttura Un filtro che confronta il valore di un attributo utilizzando un operatore. **Campi** + `Attribute`— *Obbligatorio:* UTF-8 stringa, lunga non meno di 1 o più di 128 byte. Il nome dell'attributo in base al quale filtrare. + `Operator`— *Obbligatorio:* UTF-8 stringa (valori validi: `equals` `greaterThan` \| `greaterThanOrEquals` \| `lessThan` \| `lessThanOrEquals` \| \|`notExists`). L'operatore di confronto. I valori validi sono `equals``greaterThan`,`greaterThanOrEquals`,`lessThan`,`lessThanOrEquals`, e`notExists`. + `Value`: un oggetto [SearchFilterValue](#aws-glue-api-catalog-aws-glue-api-semantics-SearchFilterValue). Valore con cui effettuare il confronto. ## SearchFilterValue struttura Un valore di filtro. È `longValue` necessario specificare esattamente uno dei `stringValue` o. **Campi** + `StringValue`— UTF-8 stringa, lunga non più di 256 byte. Un valore di filtro a stringa. + `LongValue`: numero (lungo). Un valore di filtro intero lungo. ## ItemError struttura Un errore che si è verificato durante il recupero di un elemento del modulo iterabile. **Campi** + `ItemIdentifier`— UTF-8 stringa, lunga non meno di 1 o più di 1087 byte. L'identificatore dell'elemento che ha causato l'errore. + `Code`— UTF-8 stringa. Il codice di errore. + `Message`— UTF-8 corda. Messaggio di errore. ## GetAssetOutput struttura La struttura di risposta per l'`GetAsset`operazione. **Campi** + `Id`— *Obbligatorio:* UTF-8 stringa di lunghezza non inferiore a 1 o superiore a 1087 byte, corrispondente a. `String` L'identificatore univoco della risorsa. + `Name`— UTF-8 stringa. Il nome della risorsa. + `Description`— UTF-8 stringa. La descrizione della risorsa. + `CreatedAt`: timestamp. Il timestamp in cui è stata creata la risorsa. + `UpdatedAt`: timestamp. Il timestamp in cui la risorsa è stata aggiornata l'ultima volta. + `CreatedBy` – . L'identità del principale che ha creato la risorsa. + `UpdatedBy` – . L'identità del principale che ha aggiornato l'asset per ultimo. + `AssetTypeId`— *Obbligatorio:* UTF-8 stringa, lunga non meno di 1 o più di 256 byte. L'identificatore del tipo di risorsa per questa risorsa. + `GlossaryTerms`— Una matrice di UTF-8 stringhe, non meno di 1 o più di 10 stringhe. Gli identificatori dei termini del glossario associati alla risorsa. + `Forms`: una matrice della mappa di coppie chiave-valore. Ogni chiave è una UTF-8 stringa. Ogni valore è un oggetto [AssetFormEntry](#aws-glue-api-catalog-aws-glue-api-semantics-AssetFormEntry). I moduli sulla risorsa, codificati in base al nome del modulo. + `Attachments`: una matrice della mappa di coppie chiave-valore. Ogni chiave è una UTF-8 stringa. Ogni valore è un oggetto [AssetFormEntry](#aws-glue-api-catalog-aws-glue-api-semantics-AssetFormEntry). Allegati aggiuntivi sulla risorsa per un contesto più approfondito, codificati in base al nome dell'allegato. + `IterableForms`: una matrice della mappa di coppie chiave-valore. Ogni chiave è una UTF-8 stringa. Ogni valore è un oggetto [IterableFormEntry](#aws-glue-api-catalog-aws-glue-api-semantics-IterableFormEntry). I moduli iterabili disponibili sulla risorsa, codificati in base al nome del modulo (ad esempio,`columns`). Utilizzate il nome del modulo con `ListIterableForms` o `BatchGetIterableForms` per recuperare gli elementi del modulo. ## SearchOutput struttura La struttura di risposta per l'`Search`operazione. **Campi** + `Items`: una matrice di oggetti [SearchResultItem](#aws-glue-api-catalog-aws-glue-api-semantics-SearchResultItem). L'elenco delle risorse che corrispondono ai criteri di ricerca. + `TotalCount`: numero (intero). Il numero totale di risorse che corrispondono ai criteri di ricerca. + `NextToken`— UTF-8 stringa. Un token di continuazione, presente se il segmento corrente non è l'ultimo. + `Aggregations`— Una serie di oggetti. I risultati dell'aggregazione per gli attributi richiesti. ## Operazioni + [GetAsset azione (Python: get\_asset)](#aws-glue-api-catalog-aws-glue-api-semantics-GetAsset) + [PutAsset azione (Python: put\_asset)](#aws-glue-api-catalog-aws-glue-api-semantics-PutAsset) + [DeleteAsset azione (Python: delete\_asset)](#aws-glue-api-catalog-aws-glue-api-semantics-DeleteAsset) + [PutAssetType azione (Python: put\_asset\_type)](#aws-glue-api-catalog-aws-glue-api-semantics-PutAssetType) + [GetAssetType azione (Python: get\_asset\_type)](#aws-glue-api-catalog-aws-glue-api-semantics-GetAssetType) + [DeleteAssetType azione (Python: delete\_asset\_type)](#aws-glue-api-catalog-aws-glue-api-semantics-DeleteAssetType) + [ListAssetTypes azione (Python: list\_asset\_types)](#aws-glue-api-catalog-aws-glue-api-semantics-ListAssetTypes) + [PutFormType azione (Python: put\_form\_type)](#aws-glue-api-catalog-aws-glue-api-semantics-PutFormType) + [GetFormType azione (Python: get\_form\_type)](#aws-glue-api-catalog-aws-glue-api-semantics-GetFormType) + [DeleteFormType azione (Python: delete\_form\_type)](#aws-glue-api-catalog-aws-glue-api-semantics-DeleteFormType) + [ListFormTypes azione (Python: list\_form\_types)](#aws-glue-api-catalog-aws-glue-api-semantics-ListFormTypes) + [PutAttachment azione (Python: put\_attachment)](#aws-glue-api-catalog-aws-glue-api-semantics-PutAttachment) + [DeleteAttachment azione (Python: delete\_attachment)](#aws-glue-api-catalog-aws-glue-api-semantics-DeleteAttachment) + [ListIterableForms azione (Python: list\_iterable\_forms)](#aws-glue-api-catalog-aws-glue-api-semantics-ListIterableForms) + [BatchGetIterableForms azione (Python: batch\_get\_iterable\_forms)](#aws-glue-api-catalog-aws-glue-api-semantics-BatchGetIterableForms) + [CreateGlossary azione (Python: create\_glossary)](#aws-glue-api-catalog-aws-glue-api-semantics-CreateGlossary) + [GetGlossary azione (Python: get\_glossary)](#aws-glue-api-catalog-aws-glue-api-semantics-GetGlossary) + [UpdateGlossary azione (Python: update\_glossary)](#aws-glue-api-catalog-aws-glue-api-semantics-UpdateGlossary) + [DeleteGlossary azione (Python: delete\_glossary)](#aws-glue-api-catalog-aws-glue-api-semantics-DeleteGlossary) + [ListGlossaries azione (Python: list\_glossaries)](#aws-glue-api-catalog-aws-glue-api-semantics-ListGlossaries) + [CreateGlossaryTerm azione (Python: create\_glossary\_term)](#aws-glue-api-catalog-aws-glue-api-semantics-CreateGlossaryTerm) + [GetGlossaryTerm azione (Python: get\_glossary\_term)](#aws-glue-api-catalog-aws-glue-api-semantics-GetGlossaryTerm) + [UpdateGlossaryTerm azione (Python: update\_glossary\_term)](#aws-glue-api-catalog-aws-glue-api-semantics-UpdateGlossaryTerm) + [DeleteGlossaryTerm azione (Python: delete\_glossary\_term)](#aws-glue-api-catalog-aws-glue-api-semantics-DeleteGlossaryTerm) + [ListGlossaryTerms azione (Python: list\_glossary\_terms)](#aws-glue-api-catalog-aws-glue-api-semantics-ListGlossaryTerms) + [AssociateGlossaryTerms azione (Python: associate\_glossary\_terms)](#aws-glue-api-catalog-aws-glue-api-semantics-AssociateGlossaryTerms) + [DisassociateGlossaryTerms azione (Python: disassociate\_glossary\_terms)](#aws-glue-api-catalog-aws-glue-api-semantics-DisassociateGlossaryTerms) + [Azione di ricerca (Python: search)](#aws-glue-api-catalog-aws-glue-api-semantics-Search) ## GetAsset azione (Python: get\_asset) Recupera i metadati di una risorsa in AWS Glue Data Catalog, inclusi i moduli, gli allegati aggiuntivi e i termini del glossario associati. **Example** L'esempio seguente recupera una risorsa tramite il relativo identificatore. ``` aws glue get-asset --identifier quarterly-sales-2026q1 { "Id": "quarterly-sales-2026q1", "Name": "Quarterly Sales 2026 Q1", "Description": "Aggregated quarterly sales metrics", "CreatedAt": "2026-06-16T06:42:00.442Z", "AssetTypeId": "DataSet", "GlossaryTerms": [], "Forms": { "DataClassification": { "FormTypeId": "DataClassification", "Content": "{\"classification\":\"internal\",\"owner\":\"data-platform-team\"}" } }, "Attachments": {}, "IterableForms": {} } ``` **Richiesta** + `Identifier`— *Obbligatorio:* UTF-8 stringa, di lunghezza non inferiore a 1 o superiore a 1087 byte, corrispondente a. `String` L'identificatore univoco della risorsa da recuperare. **Risposta** La struttura di risposta per l'operazione. `GetAsset` + `GetAssetOutput`: un oggetto [GetAssetOutput](#aws-glue-api-catalog-aws-glue-api-semantics-GetAssetOutput). **Errori** + `AccessDeniedException` + `EntityNotFoundException` + `InternalServiceException` + `ThrottlingException` + `InvalidInputException` ## PutAsset azione (Python: put\_asset) Crea o aggiorna una risorsa in AWS Glue Data Catalog. Se la risorsa esiste già, questa operazione la aggiorna; in caso contrario, viene creata una nuova risorsa. **Example** L'esempio seguente crea una risorsa con un modulo. ``` aws glue put-asset \ --asset-type-id DataSet \ --identifier quarterly-sales-2026q1 \ --name "Quarterly Sales 2026 Q1" \ --description "Aggregated quarterly sales metrics" \ --forms '{"DataClassification":{"FormTypeId":"DataClassification","Content":"{\"classification\":\"internal\",\"owner\":\"data-platform-team\"}"}}' { "Id": "quarterly-sales-2026q1", "Name": "Quarterly Sales 2026 Q1", "Description": "Aggregated quarterly sales metrics", "CreatedAt": "2026-06-16T06:42:00.442Z", "Forms": { "DataClassification": { "FormTypeId": "DataClassification", "Content": "{\"classification\":\"internal\",\"owner\":\"data-platform-team\"}" } } } ``` **Richiesta** + `AssetTypeId`— *Obbligatorio:* UTF-8 stringa, lunga non meno di 1 o più di 256 byte. L'identificatore del tipo di risorsa per la risorsa. + `Identifier`— *Obbligatorio:* UTF-8 stringa, lunga almeno 1 o più di 1087 byte, corrispondente a. `String` L'identificatore univoco della risorsa. Se esiste già una risorsa con questo identificatore, viene aggiornata. + `Name`— *Obbligatorio:* UTF-8 stringa. Il nome della risorsa. + `Description`— UTF-8 stringa. La descrizione della risorsa. + `Forms` - *obbligatorio:* una matrice della mappa di coppie chiave-valore. Ogni chiave è una UTF-8 stringa. Ogni valore è un oggetto [AssetFormEntry](#aws-glue-api-catalog-aws-glue-api-semantics-AssetFormEntry). I moduli da impostare sulla risorsa, codificati in base al nome del modulo. Ogni voce specifica il tipo di modulo e il relativo contenuto JSON. + `ClientToken`— UTF-8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) Un identificatore univoco (con distinzione tra maiuscole e minuscole) che fornisci per assicurare l'idempotenza della richiesta. **Risposta** + `Id`— *Obbligatorio:* UTF-8 stringa di lunghezza non inferiore a 1 o superiore a 1087 byte, corrispondente a. `String` L'identificatore univoco della risorsa. + `Name`— *Obbligatorio:* UTF-8 stringa. Il nome della risorsa. + `Description`— UTF-8 stringa. La descrizione della risorsa. + `CreatedAt`: timestamp. Il timestamp in cui è stata creata la risorsa. + `Forms`: una matrice della mappa di coppie chiave-valore. Ogni chiave è una UTF-8 stringa. Ogni valore è un oggetto [AssetFormEntry](#aws-glue-api-catalog-aws-glue-api-semantics-AssetFormEntry). I moduli allegati alla risorsa, codificati in base al nome del modulo. **Errori** + `AccessDeniedException` + `ConcurrentModificationException` + `EntityNotFoundException` + `InternalServiceException` + `InvalidInputException` + `ThrottlingException` ## DeleteAsset azione (Python: delete\_asset) Elimina una risorsa da AWS Glue Data Catalog. **Example** L'esempio seguente elimina una risorsa in base al relativo identificatore. ``` aws glue delete-asset --identifier quarterly-sales-2026q1 ``` **Richiesta** + `Identifier`— *Obbligatorio:* UTF-8 stringa, di lunghezza non inferiore a 1 o superiore a 1087 byte, corrispondente a. `String` L'identificatore univoco della risorsa da eliminare. **Risposta** + *Nessun parametro di risposta.* **Errori** + `AccessDeniedException` + `ConcurrentModificationException` + `InternalServiceException` + `InvalidInputException` + `ThrottlingException` ## PutAssetType azione (Python: put\_asset\_type) Crea o aggiorna un tipo di risorsa in Data Catalog. AWS Glue Un tipo di risorsa definisce la struttura delle risorse specificando quali moduli includono. Se esiste già un tipo di risorsa con il nome specificato, viene aggiornato. **Example** L'esempio seguente crea un tipo di risorsa che fa riferimento a un tipo di modulo. ``` aws glue put-asset-type \ --name DataSet \ --forms '{"DataClassification":{"FormTypeIdentifier":"DataClassification"}}' { "Id": "DataSet", "Name": "DataSet", "Forms": { "DataClassification": { "FormTypeIdentifier": "DataClassification" } } } ``` **Richiesta** + `Name`— *Obbligatorio:* UTF-8 stringa, di lunghezza non inferiore a 1 o superiore a 128 byte, corrispondente a. `String` Il nome del tipo di risorsa. + `Forms`— *Obbligatorio:* un array di mappe di coppie chiave-valore, non meno di 1 o più di 100 coppie. Ogni chiave è una UTF-8 stringa, lunga non meno di 1 o più di 128 byte, che corrisponde a. `String` Ogni valore è un oggetto [AssetTypeFormReference](#aws-glue-api-catalog-aws-glue-api-semantics-AssetTypeFormReference). I moduli che costituiscono il tipo di risorsa, codificati in base al nome del modulo. Ogni voce fa riferimento al tipo di modulo che definisce lo schema del modulo. + `ClientToken`— UTF-8 stringa, di lunghezza non inferiore a 1 o più di 255 byte, corrispondente a. [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) Un identificatore univoco (con distinzione tra maiuscole e minuscole) che fornisci per assicurare l'idempotenza della richiesta. **Risposta** + `Id`— UTF-8 stringa, lunga non meno di 1 o più di 256 byte. L'identificatore del tipo di risorsa. + `Name`— UTF-8 stringa, lunga non meno di 1 o più di 128 byte, corrispondente a. `String` Il nome del tipo di risorsa. + `Forms`— Un array di mappe di coppie chiave-valore, non meno di 1 o più di 100 coppie. Ogni chiave è una UTF-8 stringa, lunga non meno di 1 o più di 128 byte, che corrisponde a. `String` Ogni valore è un oggetto [AssetTypeFormReference](#aws-glue-api-catalog-aws-glue-api-semantics-AssetTypeFormReference). I moduli che costituiscono il tipo di risorsa, codificati in base al nome del modulo. **Errori** + `AccessDeniedException` + `InternalServiceException` + `InvalidInputException` + `ConcurrentModificationException` + `ThrottlingException` ## GetAssetType azione (Python: get\_asset\_type) Recupera un tipo di risorsa in Data Catalog tramite il relativo identificatore AWS Glue . **Example** L'esempio seguente recupera un tipo di risorsa tramite il relativo identificatore. ``` aws glue get-asset-type --identifier DataSet { "Id": "DataSet", "Name": "DataSet", "Forms": { "DataClassification": { "FormTypeIdentifier": "DataClassification" } } } ``` **Richiesta** + `Identifier`— *Obbligatorio:* UTF-8 stringa, lunga non meno di 1 o più di 256 byte. L'identificatore del tipo di risorsa da recuperare. **Risposta** + `Id`— UTF-8 stringa, lunga non meno di 1 o più di 256 byte. L'identificatore del tipo di risorsa. + `Name`— UTF-8 stringa, lunga non meno di 1 o più di 128 byte, corrispondente a. `String` Il nome del tipo di risorsa. + `Forms`— Un array di mappe di coppie chiave-valore, non meno di 1 o più di 100 coppie. Ogni chiave è una UTF-8 stringa, lunga non meno di 1 o più di 128 byte, che corrisponde a. `String` Ogni valore è un oggetto [AssetTypeFormReference](#aws-glue-api-catalog-aws-glue-api-semantics-AssetTypeFormReference). I moduli che costituiscono il tipo di risorsa, codificati in base al nome del modulo. **Errori** + `AccessDeniedException` + `EntityNotFoundException` + `InternalServiceException` + `InvalidInputException` + `ThrottlingException` ## DeleteAssetType azione (Python: delete\_asset\_type) Elimina un tipo di risorsa da Data Catalog. AWS Glue **Example** L'esempio seguente elimina un tipo di risorsa in base al relativo identificatore. ``` aws glue delete-asset-type --identifier DataSet ``` **Richiesta** + `Identifier`— *Obbligatorio:* UTF-8 stringa, lunga non meno di 1 o più di 256 byte. L'identificatore del tipo di risorsa da eliminare. **Risposta** + *Nessun parametro di risposta.* **Errori** + `AccessDeniedException` + `InternalServiceException` + `InvalidInputException` + `ConcurrentModificationException` + `ThrottlingException` ## ListAssetTypes azione (Python: list\_asset\_types) Elenca i tipi di asset definiti in Data Catalog. AWS Glue **Example** L'esempio seguente elenca i tipi di asset presenti nell'account. ``` aws glue list-asset-types --max-results 20 { "Items": [ { "Id": "DataSet", "Name": "DataSet" } ] } ``` **Richiesta** + `MaxResults`: numero (intero), non inferiore a 1 o superiore a 1.000. Il numero massimo di risultati da restituire nella risposta. + `NextToken`— UTF-8 stringa. Un token di continuazione, se si tratta di una chiamata di continuazione. **Risposta** + `Items`— Una serie di oggetti. L'elenco degli elementi del tipo di risorsa. + `NextToken`— UTF-8 stringa. Un token di continuazione, presente se il segmento corrente non è l'ultimo. **Errori** + `AccessDeniedException` + `InternalServiceException` + `InvalidInputException` + `ThrottlingException` ## PutFormType azione (Python: put\_form\_type) Crea o aggiorna un tipo di modulo in Data Catalog. AWS Glue Un tipo di modulo definisce lo schema per i metadati strutturati che possono essere allegati alle risorse. **Example** L'esempio seguente crea un tipo di modulo con uno schema Smithy. ``` aws glue put-form-type \ --name DataClassification \ --schema 'structure DataClassification { classification: String owner: String }' { "Id": "DataClassification", "Name": "DataClassification", "Schema": "structure DataClassification {\n classification: String\n owner: String\n}" } ``` **Richiesta** + `Name`— *Obbligatorio:* UTF-8 stringa, lunga non meno di 1 o più di 128 byte, corrispondente a. `String` Nome del tipo di modulo. Deve iniziare con una lettera maiuscola. + `Schema`— *Obbligatorio:* UTF-8 stringa, lunga non meno di 1 o più di 100000 byte. La definizione dello schema Smithy IDL per il tipo di modulo. + `ClientToken`— UTF-8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) Un identificatore univoco (con distinzione tra maiuscole e minuscole) che fornisci per assicurare l'idempotenza della richiesta. **Risposta** + `Id`— UTF-8 stringa, lunga non meno di 1 o più di 256 byte. L'identificatore del tipo di modulo. + `Name`— UTF-8 stringa, lunga non meno di 1 o più di 128 byte, corrispondente a. `String` Il nome del tipo di modulo. + `Schema`— UTF-8 stringa, lunga non meno di 1 o più di 100000 byte. Lo schema Smithy IDL del tipo di modulo. **Errori** + `AccessDeniedException` + `InternalServiceException` + `InvalidInputException` + `ConcurrentModificationException` + `ThrottlingException` ## GetFormType azione (Python: get\_form\_type) Recupera un tipo di modulo in AWS Glue Data Catalog tramite il relativo identificatore. **Example** L'esempio seguente recupera un tipo di modulo tramite il relativo identificatore. ``` aws glue get-form-type --identifier DataClassification { "Id": "DataClassification", "Name": "DataClassification", "Schema": "structure DataClassification {\n classification: String\n owner: String\n}" } ``` **Richiesta** + `Identifier`— *Obbligatorio:* UTF-8 stringa, di lunghezza non inferiore a 1 o superiore a 256 byte. L'identificatore del tipo di modulo da recuperare. **Risposta** + `Id`— UTF-8 stringa, lunga non meno di 1 o più di 256 byte. L'identificatore del tipo di modulo. + `Name`— UTF-8 stringa, lunga non meno di 1 o più di 128 byte, corrispondente a. `String` Il nome del tipo di modulo. + `Schema`— UTF-8 stringa, lunga non meno di 1 o più di 100000 byte. Lo schema Smithy IDL del tipo di modulo. **Errori** + `AccessDeniedException` + `EntityNotFoundException` + `InternalServiceException` + `InvalidInputException` + `ThrottlingException` ## DeleteFormType azione (Python: delete\_form\_type) Elimina un tipo di modulo da Data Catalog. AWS Glue Un tipo di modulo non può essere eliminato se è ancora referenziato da un tipo di risorsa. **Example** L'esempio seguente elimina un tipo di modulo in base al relativo identificatore. ``` aws glue delete-form-type --identifier DataClassification ``` **Richiesta** + `Identifier`— *Obbligatorio:* UTF-8 stringa, di lunghezza non inferiore a 1 o superiore a 256 byte. L'identificatore del tipo di modulo da eliminare. **Risposta** + *Nessun parametro di risposta.* **Errori** + `AccessDeniedException` + `InternalServiceException` + `InvalidInputException` + `ConcurrentModificationException` + `ConflictException` + `ThrottlingException` ## ListFormTypes azione (Python: list\_form\_types) Elenca i tipi di modulo definiti in Data Catalog. AWS Glue **Example** L'esempio seguente elenca i tipi di modulo presenti nell'account. ``` aws glue list-form-types --max-results 20 { "Items": [ { "Id": "DataClassification", "Name": "DataClassification" } ] } ``` **Richiesta** + `MaxResults`: numero (intero), non inferiore a 1 o superiore a 1.000. Il numero massimo di risultati da restituire nella risposta. + `NextToken`— UTF-8 stringa. Un token di continuazione, se si tratta di una chiamata di continuazione. **Risposta** + `Items`— *Obbligatorio:* una serie di oggetti. L'elenco degli elementi del tipo di modulo. + `NextToken`— UTF-8 stringa. Un token di continuazione, presente se il segmento corrente non è l'ultimo. **Errori** + `AccessDeniedException` + `InternalServiceException` + `InvalidInputException` + `ThrottlingException` ## PutAttachment azione (Python: put\_attachment) Allega un modulo a una risorsa o a un elemento del modulo iterabile in Data Catalog. AWS Glue Se esiste già un allegato con lo stesso nome, viene sovrascritto. **Example** L'esempio seguente allega un modulo a una risorsa. ``` aws glue put-attachment \ --asset-identifier quarterly-sales-2026q1 \ --attachment-name reviewNote \ --form-type-id DataClassification \ --content '{"classification":"internal","owner":"analytics-team"}' { "AssetId": "quarterly-sales-2026q1", "AttachmentName": "reviewNote", "FormTypeId": "DataClassification" } ``` **Richiesta** + `AssetIdentifier`— *Obbligatorio:* UTF-8 stringa, di lunghezza non inferiore a 1 o superiore a 1087 byte, corrispondente a. `String` L'identificatore univoco della risorsa a cui allegare il modulo. + `IterableFormName`— UTF-8 stringa, lunga non meno di 1 o più di 256 byte, corrispondente a. `String` Il nome del modulo iterabile. Se specificato insieme a`itemIdentifier`, l'allegato si rivolge a un elemento all'interno del modulo iterabile anziché alla risorsa stessa. + `ItemIdentifier`— UTF-8 stringa, lunga non meno di 1 o più di 1087 byte. L'identificatore dell'elemento all'interno del modulo iterabile. Opzione obbligatoria quando specifichi `iterableFormName`. + `AttachmentName`— *Obbligatorio:* UTF-8 stringa, lunga non meno di 1 o più di 256 byte, corrispondente a. `String` Il nome dell'allegato. + `Content`— *Obbligatorio:* UTF-8 stringa. Il contenuto JSON del modulo, conforme allo schema del tipo di modulo specificato. + `FormTypeId`— *Obbligatorio:* UTF-8 stringa di lunghezza non inferiore a 1 o superiore a 256 byte. L'identificatore del tipo di modulo per questo allegato. + `ClientToken`— UTF-8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) Un identificatore univoco (con distinzione tra maiuscole e minuscole) che fornisci per assicurare l'idempotenza della richiesta. **Risposta** + `AssetId`— UTF-8 stringa, di lunghezza non inferiore a 1 o più di 1087 byte, corrispondente a. `String` L'identificatore univoco della risorsa. + `IterableFormName`— UTF-8 stringa, lunga non meno di 1 o più di 256 byte, corrispondente a. `String` Il nome del modulo iterabile, se l'allegato è destinato a un elemento. + `ItemIdentifier`— UTF-8 stringa, lunga non meno di 1 o più di 1087 byte. L'identificatore dell'elemento all'interno del modulo iterabile, se applicabile. + `AttachmentName`— UTF-8 stringa, lunga non meno di 1 o più di 256 byte, corrispondente a. `String` Il nome dell'allegato. + `FormTypeId`— UTF-8 stringa, lunga non meno di 1 o più di 256 byte. L'identificatore del tipo di modulo per questo allegato. **Errori** + `AccessDeniedException` + `EntityNotFoundException` + `InternalServiceException` + `InvalidInputException` + `ConcurrentModificationException` + `ThrottlingException` ## DeleteAttachment azione (Python: delete\_attachment) Elimina un allegato al modulo da una risorsa in AWS Glue Data Catalog. **Example** L'esempio seguente elimina un allegato da una risorsa. ``` aws glue delete-attachment \ --identifier quarterly-sales-2026q1 \ --attachment-name reviewNote { "Identifier": "quarterly-sales-2026q1" } ``` **Richiesta** + `AssetIdentifier`— *Obbligatorio:* UTF-8 stringa, di lunghezza non inferiore a 1 o superiore a 1087 byte, corrispondente a. `String` L'identificatore univoco della risorsa da cui eliminare l'allegato. + `AttachmentName`— *Obbligatorio:* UTF-8 stringa, lunga non meno di 1 o più di 256 byte, corrispondente a. `String` Il nome dell'allegato da eliminare. **Risposta** + `Identifier`— UTF-8 stringa, lunga non meno di 1 o più di 1087 byte, corrispondente a. `String` L'identificatore univoco della risorsa. **Errori** + `AccessDeniedException` + `EntityNotFoundException` + `InternalServiceException` + `InvalidInputException` + `ConcurrentModificationException` + `ThrottlingException` ## ListIterableForms azione (Python: list\_iterable\_forms) Elenca gli elementi in forma iterabile su una risorsa in Data Catalog. AWS Glue Ad esempio, elenca le colonne di una risorsa tabellare. **Example** L'esempio seguente elenca le colonne di una risorsa. ``` aws glue list-iterable-forms \ --asset-identifier quarterly-sales-2026q1 \ --iterable-form-name columns \ --max-results 20 { "AssetId": "quarterly-sales-2026q1", "IterableFormName": "columns", "Items": [ { "ItemId": "quarterly-sales-2026q1#region", "ItemName": "region", "Description": "AWS region of the sales record", "GlossaryTerms": [] }, { "ItemId": "quarterly-sales-2026q1#amount", "ItemName": "amount", "Description": "Sales amount in USD", "GlossaryTerms": [] } ] } ``` **Richiesta** + `AssetIdentifier`— *Obbligatorio:* UTF-8 stringa, di lunghezza non inferiore a 1 o superiore a 1087 byte, corrispondente a. `String` L'identificatore univoco della risorsa. + `IterableFormName`— *Obbligatorio:* UTF-8 stringa, lunga almeno 1 o più di 256 byte, corrispondente a. `String` Il nome del modulo iterabile da cui elencare gli elementi. + `MaxResults`: numero (intero), non inferiore a 1 o superiore a 1.000. Il numero massimo di risultati da restituire nella risposta. + `NextToken`— UTF-8 stringa. Un token di continuazione, se si tratta di una chiamata di continuazione. **Risposta** + `AssetId`— UTF-8 stringa, lunga non meno di 1 o più di 1087 byte, corrispondente a. `String` L'identificatore univoco della risorsa. + `IterableFormName`— UTF-8 stringa, lunga non meno di 1 o più di 256 byte, corrispondente a. `String` Il nome del modulo iterabile. + `Items`: una matrice di oggetti [IterableFormListItem](#aws-glue-api-catalog-aws-glue-api-semantics-IterableFormListItem). L'elenco degli elementi del modulo iterabili. + `NextToken`— UTF-8 stringa. Un token di continuazione, presente se il segmento corrente non è l'ultimo. **Errori** + `AccessDeniedException` + `EntityNotFoundException` + `InternalServiceException` + `ThrottlingException` + `InvalidInputException` ## BatchGetIterableForms azione (Python: batch\_get\_iterable\_forms) Recupera più elementi da un modulo iterabile su una risorsa in Data Catalog in un'unica richiesta. AWS Glue **Example** L'esempio seguente recupera colonne specifiche per identificatore. ``` aws glue batch-get-iterable-forms \ --asset-identifier quarterly-sales-2026q1 \ --iterable-form-name columns \ --item-identifiers region amount { "Items": [ { "ItemId": "quarterly-sales-2026q1#region", "ItemName": "region", "GlossaryTerms": [], "Forms": { "columns": { "FormTypeId": "amazon.glue::Column", "Content": "{\"type\":\"string\"}" } }, "Attachments": {} }, { "ItemId": "quarterly-sales-2026q1#amount", "ItemName": "amount", "GlossaryTerms": [], "Forms": { "columns": { "FormTypeId": "amazon.glue::Column", "Content": "{\"type\":\"double\"}" } }, "Attachments": {} } ], "Errors": [] } ``` **Richiesta** + `AssetIdentifier`— *Obbligatorio:* UTF-8 stringa, di lunghezza non inferiore a 1 o superiore a 1087 byte, corrispondente a. `String` L'identificatore univoco della risorsa. + `IterableFormName`— *Obbligatorio:* UTF-8 stringa, lunga almeno 1 o più di 256 byte, corrispondente a. `String` Il nome del modulo iterabile da cui recuperare gli elementi. + `ItemIdentifiers`— *Obbligatorio:* un array di UTF-8 stringhe, non meno di 1 o più di 100 stringhe. L'elenco degli identificatori degli elementi da recuperare. Ogni identificatore può essere un ID o un nome di elemento. **Risposta** + `Items`: una matrice di oggetti [IterableFormItem](#aws-glue-api-catalog-aws-glue-api-semantics-IterableFormItem). L'elenco degli elementi del modulo iterabile recuperati. + `Errors`: una matrice di oggetti [ItemError](#aws-glue-api-catalog-aws-glue-api-semantics-ItemError). L'elenco degli errori per gli elementi che non possono essere recuperati. **Errori** + `AccessDeniedException` + `EntityNotFoundException` + `InternalServiceException` + `InvalidInputException` + `ThrottlingException` ## CreateGlossary azione (Python: create\_glossary) Crea un glossario aziendale in Data Catalog. AWS Glue Un glossario è un contenitore di termini di glossario che definiscono i concetti aziendali. **Example** L'esempio seguente crea un glossario aziendale. ``` aws glue create-glossary \ --name "Sales Terms" \ --description "Glossary of sales-domain business terms" { "Id": "6n5f21s641nbjb", "Name": "Sales Terms", "Description": "Glossary of sales-domain business terms" } ``` **Richiesta** + `Name`— *Obbligatorio:* UTF-8 stringa, lunga non meno di 1 o più di 256 byte. Il nome del glossario. + `Description`— UTF-8 stringa, lunga non meno di 1 o più di 2048 byte. La descrizione del glossario. + `ClientToken`— UTF-8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) Un identificatore univoco (con distinzione tra maiuscole e minuscole) che fornisci per assicurare l'idempotenza della richiesta. **Risposta** + `Id`— UTF-8 stringa. L'identificatore univoco del glossario. + `Name`— UTF-8 stringa, lunga non meno di 1 o più di 256 byte. Il nome del glossario. + `Description`— UTF-8 stringa, lunga non meno di 1 o più di 2048 byte. La descrizione del glossario. **Errori** + `AccessDeniedException` + `InternalServiceException` + `InvalidInputException` + `ConcurrentModificationException` + `ThrottlingException` + `AlreadyExistsException` ## GetGlossary azione (Python: get\_glossary) Recupera un glossario aziendale in AWS Glue Data Catalog tramite il relativo identificatore. **Example** L'esempio seguente recupera un glossario in base al relativo identificatore. ``` aws glue get-glossary --identifier 6n5f21s641nbjb { "Id": "6n5f21s641nbjb", "Name": "Sales Terms", "Description": "Glossary of sales-domain business terms" } ``` **Richiesta** + `Identifier`— *Obbligatorio: stringa.* UTF-8 L'identificatore univoco del glossario da recuperare. **Risposta** + `Id`— stringa. UTF-8 L'identificatore univoco del glossario. + `Name`— UTF-8 stringa, lunga non meno di 1 o più di 256 byte. Il nome del glossario. + `Description`— UTF-8 stringa, lunga non meno di 1 o più di 2048 byte. La descrizione del glossario. **Errori** + `AccessDeniedException` + `EntityNotFoundException` + `InternalServiceException` + `ThrottlingException` ## UpdateGlossary azione (Python: update\_glossary) Aggiorna un glossario aziendale in Data Catalog. AWS Glue **Example** L'esempio seguente aggiorna la descrizione di un glossario. ``` aws glue update-glossary \ --identifier 6n5f21s641nbjb \ --name "Sales Terms" \ --description "Glossary of sales and revenue business terms" { "Id": "6n5f21s641nbjb", "Name": "Sales Terms", "Description": "Glossary of sales and revenue business terms" } ``` **Richiesta** + `Identifier`— *Obbligatorio:* UTF-8 stringa. L'identificatore univoco del glossario da aggiornare. + `Name`— UTF-8 stringa, lunga non meno di 1 o più di 256 byte. Il nome aggiornato del glossario. + `Description`— UTF-8 stringa, lunga non meno di 1 o più di 2048 byte. La descrizione aggiornata del glossario. + `ClientToken`— UTF-8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) Un identificatore univoco (con distinzione tra maiuscole e minuscole) che fornisci per assicurare l'idempotenza della richiesta. **Risposta** + `Id`— UTF-8 stringa. L'identificatore univoco del glossario. + `Name`— UTF-8 stringa, lunga non meno di 1 o più di 256 byte. Il nome del glossario. + `Description`— UTF-8 stringa, lunga non meno di 1 o più di 2048 byte. La descrizione del glossario. **Errori** + `AccessDeniedException` + `EntityNotFoundException` + `InternalServiceException` + `InvalidInputException` + `ConcurrentModificationException` + `ThrottlingException` + `AlreadyExistsException` ## DeleteGlossary azione (Python: delete\_glossary) Elimina un glossario aziendale da Data Catalog. AWS Glue Un glossario non può essere eliminato se contiene ancora termini del glossario. **Example** L'esempio seguente elimina un glossario in base al relativo identificatore. ``` aws glue delete-glossary --identifier 6n5f21s641nbjb ``` **Richiesta** + `Identifier`— *Obbligatorio: stringa.* UTF-8 L'identificatore univoco del glossario da eliminare. **Risposta** + *Nessun parametro di risposta.* **Errori** + `AccessDeniedException` + `InternalServiceException` + `InvalidInputException` + `ConflictException` + `ConcurrentModificationException` + `ThrottlingException` ## ListGlossaries azione (Python: list\_glossaries) Elenca i glossari aziendali in Data Catalog. AWS Glue **Example** L'esempio seguente elenca i glossari presenti nell'account. ``` aws glue list-glossaries --max-results 20 { "Items": [ { "Id": "6n5f21s641nbjb", "Name": "Sales Terms", "Description": "Glossary of sales and revenue business terms" } ] } ``` **Richiesta** + `MaxResults`: numero (intero), non inferiore a 1 o superiore a 1.000. Il numero massimo di risultati da restituire nella risposta. + `NextToken`— UTF-8 stringa. Un token di continuazione, se si tratta di una chiamata di continuazione. **Risposta** + `Items`— Una serie di oggetti. L'elenco degli elementi del glossario. + `NextToken`— UTF-8 stringa. Un token di continuazione, presente se il segmento corrente non è l'ultimo. **Errori** + `AccessDeniedException` + `InternalServiceException` + `InvalidInputException` + `ThrottlingException` ## CreateGlossaryTerm azione (Python: create\_glossary\_term) Crea un termine di glossario all'interno di un glossario aziendale in Data Catalog. AWS Glue **Example** L'esempio seguente crea un termine di glossario. ``` aws glue create-glossary-term \ --glossary-identifier 6n5f21s641nbjb \ --name "Net Revenue" \ --short-description "Revenue after returns, allowances, and discounts." \ --long-description "Net revenue is gross revenue minus returns, allowances, and discounts over a reporting period." { "Id": "avugvxvsul6izr", "GlossaryId": "6n5f21s641nbjb", "Name": "Net Revenue", "ShortDescription": "Revenue after returns, allowances, and discounts.", "LongDescription": "Net revenue is gross revenue minus returns, allowances, and discounts over a reporting period." } ``` **Richiesta** + `GlossaryIdentifier`— *Obbligatorio:* UTF-8 stringa. L'identificatore univoco del glossario in cui creare il termine. + `Name`— *Obbligatorio:* UTF-8 stringa, lunga non meno di 1 o più di 256 byte. Il nome del termine del glossario. + `ShortDescription`— UTF-8 stringa, lunga non meno di 1 o più di 1024 byte. Breve descrizione del termine del glossario. + `LongDescription`— UTF-8 stringa, lunga non meno di 1 o più di 4096 byte. Una descrizione dettagliata del termine del glossario. + `ClientToken`— UTF-8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) Un identificatore univoco (con distinzione tra maiuscole e minuscole) che fornisci per assicurare l'idempotenza della richiesta. **Risposta** + `Id`— UTF-8 stringa. L'identificatore univoco del termine del glossario. + `GlossaryId`— stringa UTF-8 . L'identificatore univoco del glossario contenente questo termine. + `Name`— UTF-8 stringa, lunga non meno di 1 o più di 256 byte. Il nome del termine del glossario. + `ShortDescription`— UTF-8 stringa, lunga non meno di 1 o più di 1024 byte. Breve descrizione del termine del glossario. + `LongDescription`— UTF-8 stringa, lunga non meno di 1 o più di 4096 byte. Descrizione estesa del termine del glossario. **Errori** + `AccessDeniedException` + `EntityNotFoundException` + `InternalServiceException` + `InvalidInputException` + `ConcurrentModificationException` + `ThrottlingException` + `AlreadyExistsException` ## GetGlossaryTerm azione (Python: get\_glossary\_term) Recupera un termine del glossario in Data Catalog tramite il relativo identificatore. AWS Glue **Example** L'esempio seguente recupera un termine del glossario in base al relativo identificatore. ``` aws glue get-glossary-term --identifier avugvxvsul6izr { "Id": "avugvxvsul6izr", "GlossaryId": "6n5f21s641nbjb", "Name": "Net Revenue", "ShortDescription": "Revenue after returns, allowances, and discounts.", "LongDescription": "Net revenue is gross revenue minus returns, allowances, and discounts over a reporting period." } ``` **Richiesta** + `Identifier`— *Obbligatorio: stringa.* UTF-8 L'identificatore univoco del termine del glossario da recuperare. **Risposta** + `Id`— stringa. UTF-8 L'identificatore univoco del termine del glossario. + `GlossaryId`— stringa UTF-8 . L'identificatore univoco del glossario contenente questo termine. + `Name`— UTF-8 stringa, lunga non meno di 1 o più di 256 byte. Il nome del termine del glossario. + `ShortDescription`— UTF-8 stringa, lunga non meno di 1 o più di 1024 byte. Breve descrizione del termine del glossario. + `LongDescription`— UTF-8 stringa, lunga non meno di 1 o più di 4096 byte. Descrizione estesa del termine del glossario. **Errori** + `AccessDeniedException` + `EntityNotFoundException` + `InternalServiceException` + `ThrottlingException` ## UpdateGlossaryTerm azione (Python: update\_glossary\_term) Aggiorna un termine del glossario in Data Catalog. AWS Glue **Example** L'esempio seguente aggiorna la breve descrizione di un termine del glossario. ``` aws glue update-glossary-term \ --identifier avugvxvsul6izr \ --name "Net Revenue" \ --short-description "Gross revenue minus returns, allowances, and discounts." \ --long-description "Net revenue is gross revenue minus returns, allowances, and discounts over a reporting period." { "Id": "avugvxvsul6izr", "GlossaryId": "6n5f21s641nbjb", "Name": "Net Revenue", "ShortDescription": "Gross revenue minus returns, allowances, and discounts.", "LongDescription": "Net revenue is gross revenue minus returns, allowances, and discounts over a reporting period." } ``` **Richiesta** + `Identifier`— *Obbligatorio:* UTF-8 stringa. L'identificatore univoco del termine del glossario da aggiornare. + `Name`— UTF-8 stringa, lunga non meno di 1 o più di 256 byte. Il nome aggiornato del termine del glossario. + `ShortDescription`— UTF-8 stringa, lunga non meno di 1 o più di 1024 byte. Breve descrizione aggiornata del termine del glossario. + `LongDescription`— UTF-8 stringa, lunga non meno di 1 o più di 4096 byte. La descrizione estesa aggiornata del termine del glossario. + `ClientToken`— UTF-8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) Un identificatore univoco (con distinzione tra maiuscole e minuscole) che fornisci per assicurare l'idempotenza della richiesta. **Risposta** + `Id`— UTF-8 stringa. L'identificatore univoco del termine del glossario. + `GlossaryId`— stringa UTF-8 . L'identificatore univoco del glossario contenente questo termine. + `Name`— UTF-8 stringa, lunga non meno di 1 o più di 256 byte. Il nome del termine del glossario. + `ShortDescription`— UTF-8 stringa, lunga non meno di 1 o più di 1024 byte. Breve descrizione del termine del glossario. + `LongDescription`— UTF-8 stringa, lunga non meno di 1 o più di 4096 byte. Descrizione estesa del termine del glossario. **Errori** + `AccessDeniedException` + `EntityNotFoundException` + `InternalServiceException` + `InvalidInputException` + `ConcurrentModificationException` + `ThrottlingException` + `AlreadyExistsException` ## DeleteGlossaryTerm azione (Python: delete\_glossary\_term) Elimina un termine del glossario da Data Catalog. AWS Glue **Example** L'esempio seguente elimina un termine del glossario in base al relativo identificatore. ``` aws glue delete-glossary-term --identifier avugvxvsul6izr ``` **Richiesta** + `Identifier`— *Obbligatorio: stringa.* UTF-8 L'identificatore univoco del termine del glossario da eliminare. **Risposta** + *Nessun parametro di risposta.* **Errori** + `AccessDeniedException` + `InternalServiceException` + `InvalidInputException` + `ConcurrentModificationException` + `ThrottlingException` ## ListGlossaryTerms azione (Python: list\_glossary\_terms) Elenca i termini del glossario all'interno di un glossario aziendale in Data Catalog. AWS Glue **Example** L'esempio seguente elenca i termini in un glossario. ``` aws glue list-glossary-terms \ --glossary-identifier 6n5f21s641nbjb \ --max-results 20 { "Items": [ { "Id": "avugvxvsul6izr", "Name": "Net Revenue", "ShortDescription": "Gross revenue minus returns, allowances, and discounts." } ] } ``` **Richiesta** + `GlossaryIdentifier`— *Obbligatorio:* UTF-8 stringa. L'identificatore univoco del glossario di cui elencare i termini. + `MaxResults`: numero (intero), non inferiore a 1 o superiore a 1.000. Il numero massimo di risultati da restituire nella risposta. + `NextToken`— UTF-8 stringa. Un token di continuazione, se si tratta di una chiamata di continuazione. **Risposta** + `GlossaryId`— UTF-8 corda. L'identificatore univoco del glossario. + `Items`— Una serie di oggetti. L'elenco dei termini del glossario. + `NextToken`— UTF-8 stringa. Un token di continuazione, presente se il segmento corrente non è l'ultimo. **Errori** + `AccessDeniedException` + `InternalServiceException` + `InvalidInputException` + `ThrottlingException` ## AssociateGlossaryTerms azione (Python: associate\_glossary\_terms) Associa uno o più termini del glossario a una risorsa in Data Catalog. AWS Glue **Example** L'esempio seguente associa un termine del glossario a una risorsa. ``` aws glue associate-glossary-terms \ --identifier quarterly-sales-2026q1 \ --glossary-term-identifiers avugvxvsul6izr { "Identifier": "quarterly-sales-2026q1", "GlossaryTerms": [ "avugvxvsul6izr" ] } ``` **Richiesta** + `AssetIdentifier`— *Obbligatorio:* UTF-8 stringa, di lunghezza non inferiore a 1 o superiore a 1087 byte, corrispondente a. `String` L'identificatore univoco della risorsa a cui associare i termini del glossario. + `GlossaryTermIdentifiers`— *Obbligatorio:* un array di UTF-8 stringhe, non meno di 1 o più di 10 stringhe. L'elenco degli identificatori dei termini del glossario da associare alla risorsa. + `ClientToken`— UTF-8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) Un identificatore univoco (con distinzione tra maiuscole e minuscole) che fornisci per assicurare l'idempotenza della richiesta. **Risposta** + `Identifier`— UTF-8 stringa, di lunghezza non inferiore a 1 o più di 1087 byte, corrispondente a. `String` L'identificatore univoco della risorsa. + `GlossaryTerms`— Una matrice di UTF-8 stringhe, non meno di 1 o più di 10 stringhe. I termini del glossario ora associati alla risorsa. **Errori** + `AccessDeniedException` + `EntityNotFoundException` + `InternalServiceException` + `InvalidInputException` + `ConcurrentModificationException` + `ThrottlingException` ## DisassociateGlossaryTerms azione (Python: disassociate\_glossary\_terms) Rimuove l'associazione di uno o più termini del glossario da una risorsa in Data Catalog. AWS Glue **Example** L'esempio seguente rimuove un termine del glossario da una risorsa. ``` aws glue disassociate-glossary-terms \ --identifier quarterly-sales-2026q1 \ --glossary-term-identifiers avugvxvsul6izr { "Identifier": "quarterly-sales-2026q1", "GlossaryTerms": [] } ``` **Richiesta** + `AssetIdentifier`— *Obbligatorio:* UTF-8 stringa, lunga non meno di 1 o più di 1087 byte, corrispondente a. `String` L'identificatore univoco della risorsa da cui dissociare i termini del glossario. + `GlossaryTermIdentifiers`— *Obbligatorio:* un array di UTF-8 stringhe, non meno di 1 o più di 10 stringhe. L'elenco degli identificatori dei termini del glossario da dissociare dalla risorsa. + `ClientToken`— UTF-8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) Un identificatore univoco (con distinzione tra maiuscole e minuscole) che fornisci per assicurare l'idempotenza della richiesta. **Risposta** + `Identifier`— UTF-8 stringa, di lunghezza non inferiore a 1 o più di 1087 byte, corrispondente a. `String` L'identificatore univoco della risorsa. + `GlossaryTerms`— Una matrice di UTF-8 stringhe, non meno di 1 o più di 10 stringhe. I restanti termini del glossario associati alla risorsa. **Errori** + `AccessDeniedException` + `EntityNotFoundException` + `InternalServiceException` + `InvalidInputException` + `ConcurrentModificationException` + `ThrottlingException` ## Azione di ricerca (Python: search) Cerca risorse in AWS Glue Data Catalog utilizzando la ricerca completa, i filtri, l'ordinamento e le aggregazioni. Restituisce gli asset corrispondenti con risultati classificati per rilevanza. **Example** L'esempio seguente esegue una ricerca completa di risorse. ``` aws glue search --search-text "sales" --max-results 10 { "Items": [ { "Id": "quarterly-sales-2026q1", "AssetName": "Quarterly Sales 2026 Q1", "AssetDescription": "Aggregated quarterly sales metrics", "UpdatedAt": "2026-06-16T06:42:00.442Z", "AssetTypeId": "DataSet" } ] } ``` **Example** L'esempio seguente esegue una ricerca con una clausola di filtro e un tipo di ordinamento. ``` aws glue search \ --search-text "sales" \ --max-results 10 \ --filter-clause '{"AttributeFilter":{"Attribute":"AssetTypeId","Operator":"equals","Value":{"StringValue":"DataSet"}}}' \ --sort '{"Attribute":"name","Order":"ASCENDING"}' { "Items": [ { "Id": "quarterly-sales-2026q1", "AssetName": "Quarterly Sales 2026 Q1", "AssetDescription": "Aggregated quarterly sales metrics", "UpdatedAt": "2026-06-16T06:42:00.442Z", "AssetTypeId": "DataSet" } ] } ``` **Example** L'esempio seguente filtra in base a un campo definito da un modulo. A un campo del modulo fanno riferimento l'identificatore del tipo di risorsa del modulo e il nome del campo, uniti da un punto, in questo caso, il `databaseName` campo del `amazon.glue::GlueTable` modulo. Gli identificatori dei tipi di asset per i tipi predefiniti riportano il `::` prefisso mostrato in ogni risultato. `AssetTypeId` ``` aws glue search \ --filter-clause '{"AttributeFilter":{"Attribute":"amazon.glue::GlueTable.databaseName","Operator":"equals","Value":{"StringValue":"sales"}}}' \ --max-results 10 { "Items": [ { "Id": "arn:aws:glue:us-east-1:123456789012:table/sales/transactions", "AssetName": "transactions", "AssetDescription": "Raw sales transactions", "UpdatedAt": "2026-06-16T06:42:00.442Z", "AssetTypeId": "amazon.glue::GlueTable" } ] } ``` **Example** L'esempio seguente combina un campo di asset comune e un campo modulo con un AND logico. I campi di risorse comuni come`name`, `type``region`, e `catalogId` sono referenziati direttamente; i campi definiti da un modulo utilizzano la `assetTypeId.fieldName` notazione. ``` aws glue search \ --filter-clause '{"AndAllFilters":[{"AttributeFilter":{"Attribute":"type","Operator":"equals","Value":{"StringValue":"Table"}}},{"AttributeFilter":{"Attribute":"amazon.glue::GlueTable.databaseName","Operator":"equals","Value":{"StringValue":"sales"}}}]}' \ --max-results 10 { "Items": [ { "Id": "arn:aws:glue:us-east-1:123456789012:table/sales/transactions", "AssetName": "transactions", "AssetDescription": "Raw sales transactions", "UpdatedAt": "2026-06-16T06:42:00.442Z", "AssetTypeId": "amazon.glue::GlueTable" } ] } ``` **Richiesta** + `SearchText`— UTF-8 stringa, lunga non meno di 1 o più di 1000 byte. Il testo da cercare. Almeno uno `searchText` o `filterClause` deve essere fornito. + `MaxResults`: numero (intero), non inferiore a 1 o superiore a 100. Il numero massimo di risultati da restituire nella risposta. + `NextToken`— UTF-8 stringa. Un token di continuazione, se si tratta di una chiamata di continuazione. + `Sort`: un oggetto [SearchSort](#aws-glue-api-catalog-aws-glue-api-semantics-SearchSort). I criteri di ordinamento per i risultati della ricerca. + `FilterClause`: un oggetto [SearchFilterClause](#aws-glue-api-catalog-aws-glue-api-semantics-SearchFilterClause). La clausola di filtro da applicare alla ricerca. Supporta la AND/OR logica annidata con filtri a livello di attributo e a livello di mappa. **Risposta** La struttura di risposta per l'operazione. `Search` + `SearchOutput`: un oggetto [SearchOutput](#aws-glue-api-catalog-aws-glue-api-semantics-SearchOutput). **Errori** + `AccessDeniedException` + `InvalidInputException` + `InternalServiceException` + `ThrottlingException`