Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # APIs für den Geschäftskontext Die Business Context-API beschreibt die Datentypen und Operationen für die Verwaltung von Ressourcen, Assettypen, Formulartypen, Glossaren, Glossarbegriffen, Anhängen und der AWS Glue Suche im Datenkatalog. ## Datentypen + [AssetFormEntry Struktur](#aws-glue-api-catalog-aws-glue-api-semantics-AssetFormEntry) + [AssetTypeFormReference Struktur](#aws-glue-api-catalog-aws-glue-api-semantics-AssetTypeFormReference) + [IterableFormEntry Struktur](#aws-glue-api-catalog-aws-glue-api-semantics-IterableFormEntry) + [IterableFormItem Struktur](#aws-glue-api-catalog-aws-glue-api-semantics-IterableFormItem) + [IterableFormListItem Struktur](#aws-glue-api-catalog-aws-glue-api-semantics-IterableFormListItem) + [SearchResultItem Struktur](#aws-glue-api-catalog-aws-glue-api-semantics-SearchResultItem) + [SearchSort Struktur](#aws-glue-api-catalog-aws-glue-api-semantics-SearchSort) + [SearchFilterClause Struktur](#aws-glue-api-catalog-aws-glue-api-semantics-SearchFilterClause) + [SearchAttributeFilter Struktur](#aws-glue-api-catalog-aws-glue-api-semantics-SearchAttributeFilter) + [SearchFilterValue Struktur](#aws-glue-api-catalog-aws-glue-api-semantics-SearchFilterValue) + [ItemError Struktur](#aws-glue-api-catalog-aws-glue-api-semantics-ItemError) + [GetAssetOutput Struktur](#aws-glue-api-catalog-aws-glue-api-semantics-GetAssetOutput) + [SearchOutput Struktur](#aws-glue-api-catalog-aws-glue-api-semantics-SearchOutput) ## AssetFormEntry Struktur Ein Formular für ein Asset, das aus dem Formulartyp-Identifier und seinem JSON-Inhalt besteht. **Felder** + `FormTypeId`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 256 Byte lang. Der Bezeichner des Formulartyps, der das Schema dieses Formulars definiert. + `Content`— UTF-8 Zeichenfolge. Der JSON-Inhalt des Formulars, der dem Schema des angegebenen Formulartyps entspricht. ## AssetTypeFormReference Struktur Ein Verweis auf einen Formulartyp, der in einem Asset-Typ enthalten ist. **Felder** + `FormTypeIdentifier`— *Erforderlich:* UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 256 Byte lang. Der Bezeichner des Formulartyps, auf den verwiesen wird. ## IterableFormEntry Struktur Ein iterierbares Formular, das für ein Asset verfügbar ist und anhand seines Formulartyps identifiziert wird. **Felder** + `FormTypeId`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 256 Byte lang. Der Formulartypbezeichner des iterierbaren Formulars (z. B.`columns`), der verwendet wird, um seine Elemente über `ListIterableForms` oder `BatchGetIterableForms` abzurufen. ## IterableFormItem Struktur Ein vollständig iterierbares Formularelement mit seinen Formularen. **Felder** + `ItemId`— UTF-8 Zeichenfolge. Die eindeutige Kennung des Artikels. + `ItemName`— UTF-8 Zeichenfolge. Der Name des Elements. + `GlossaryTerms`— Ein Array von UTF-8 Zeichenketten, nicht weniger als 1 oder mehr als 10 Zeichenketten. Die Bezeichner der Glossarbegriffe, die dem Artikel zugeordnet sind. + `Forms` – Ein Map-Array von Schlüssel-Wert-Paaren. Jeder Schlüssel ist eine UTF-8 Zeichenfolge. Jeder Wert ist ein An [AssetFormEntry](#aws-glue-api-catalog-aws-glue-api-semantics-AssetFormEntry)-Objekt. Die Formulare auf dem Element, sortiert nach dem Formularnamen. + `Attachments` – Ein Map-Array von Schlüssel-Wert-Paaren. Jeder Schlüssel ist eine UTF-8 Zeichenfolge. Jeder Wert ist ein An [AssetFormEntry](#aws-glue-api-catalog-aws-glue-api-semantics-AssetFormEntry)-Objekt. Zusätzliche Anlagen zum Element für mehr Kontext, sortiert nach dem Namen des Anhangs. ## IterableFormListItem Struktur Eine Zusammenfassung eines Elements in iterierbarer Form. **Felder** + `ItemId`— UTF-8 Zeichenfolge. Die eindeutige Kennung des Artikels. + `ItemName`— UTF-8 Zeichenfolge. Der Name des Elements. + `Description`— UTF-8 Zeichenfolge. Die Beschreibung des Artikels. + `GlossaryTerms`— Ein Array von UTF-8 Zeichenketten, nicht weniger als 1 oder mehr als 10 Zeichenketten. Die Bezeichner der Glossarbegriffe, die dem Artikel zugeordnet sind. ## SearchResultItem Struktur Ein einzelnes Suchergebniselement, das ein passendes Asset darstellt. **Felder** + `Id`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 1087 Byte lang, entspricht. `String` Die eindeutige Kennung des übereinstimmenden Assets. + `AssetName`— UTF-8 Zeichenfolge. Der Name des übereinstimmenden Assets. + `AssetDescription`— UTF-8 Zeichenfolge. Die Beschreibung des übereinstimmenden Assets. + `UpdatedAt` – Zeitstempel. Der Zeitstempel, zu dem das übereinstimmende Asset zuletzt aktualisiert wurde. + `AssetTypeId`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 256 Byte lang. Die Kennung des Asset-Typs für das entsprechende Asset. ## SearchSort Struktur Die Sortierkriterien für Suchergebnisse. **Felder** + `Attribute`— *Erforderlich:* UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 128 Byte lang. Das Attribut, nach dem sortiert werden soll. + `Order`— UTF-8 Zeichenfolge (gültige Werte: `ASCENDING` \|`DESCENDING`). Die Sortierreihenfolge. Gültige Werte sind `ASCENDING` und `DESCENDING`. ## SearchFilterClause Struktur Eine Filterklausel, die verschachtelte boolesche Logik unterstützt. `mapFilter`Es muss genau einer von`andAllFilters`, `orAnyFilters``attributeFilter`, oder angegeben werden. **Felder** + `AndAllFilters`— Eine Reihe von [SearchFilterClause](#aws-glue-api-catalog-aws-glue-api-semantics-SearchFilterClause) Objekten, nicht weniger als 1 oder mehr als 10 Strukturen. Eine Liste von Filterklauseln, die alle übereinstimmen müssen (logisches UND). + `OrAnyFilters`— Eine Reihe von [SearchFilterClause](#aws-glue-api-catalog-aws-glue-api-semantics-SearchFilterClause) Objekten, nicht weniger als 1 oder mehr als 10 Strukturen. Eine Liste von Filterklauseln, bei denen mindestens eine übereinstimmen muss (logisches ODER). + `AttributeFilter` – Ein [SearchAttributeFilter](#aws-glue-api-catalog-aws-glue-api-semantics-SearchAttributeFilter)-Objekt. Ein Filter für einen einzelnen Attributwert. + `MapFilter` – . Ein Filter für das Schlüssel-Wert-Paar eines Map-Attributs. ## SearchAttributeFilter Struktur Ein Filter, der einen Attributwert mithilfe eines Operators vergleicht. **Felder** + `Attribute`— *Erforderlich:* UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 128 Byte lang. Der Attributname, nach dem gefiltert werden soll. + `Operator`— *Erforderlich:* UTF-8 Zeichenfolge (gültige Werte: `equals` \| `greaterThan` \| `greaterThanOrEquals` \| `lessThan` \| `lessThanOrEquals` \|`notExists`). Der Vergleichsoperator. Gültige Werte sind `equals``greaterThan`,`greaterThanOrEquals`,`lessThan`,`lessThanOrEquals`, und`notExists`. + `Value` – Ein [SearchFilterValue](#aws-glue-api-catalog-aws-glue-api-semantics-SearchFilterValue)-Objekt. Der Wert, mit dem verglichen werden soll. ## SearchFilterValue Struktur Ein Filterwert. `longValue`Es muss genau einer von `stringValue` oder angegeben werden. **Felder** + `StringValue`— UTF-8 Zeichenfolge, nicht mehr als 256 Byte lang. Ein Zeichenkettenfilterwert. + `LongValue` – Zahl (lang). Ein langer Integer-Filterwert. ## ItemError Struktur Ein Fehler, der beim Abrufen eines iterierbaren Formularelements aufgetreten ist. **Felder** + `ItemIdentifier`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 1087 Byte lang. Die ID des Elements, das den Fehler verursacht hat. + `Code`— UTF-8 Zeichenfolge. Der Fehlercode. + `Message`— UTF-8 Zeichenfolge. Die Fehlermeldung. ## GetAssetOutput Struktur Die Antwortstruktur für die `GetAsset` Operation. **Felder** + `Id`— *Erforderlich:* UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 1087 Byte lang, entspricht. `String` Die eindeutige Kennung des Assets. + `Name`— UTF-8 Zeichenfolge. Der Name des Vermögenswerts. + `Description`— UTF-8 Zeichenfolge. Die Beschreibung des Vermögenswerts. + `CreatedAt` – Zeitstempel. Der Zeitstempel, zu dem das Asset erstellt wurde. + `UpdatedAt` – Zeitstempel. Der Zeitstempel, zu dem das Asset zuletzt aktualisiert wurde. + `CreatedBy` – . Die Identität des Auftraggebers, der die Anlage erstellt hat. + `UpdatedBy` – . Die Identität des Prinzipals, der den Vermögenswert zuletzt aktualisiert hat. + `AssetTypeId`— *Erforderlich:* UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 256 Byte lang. Die Kennung des Asset-Typs für dieses Asset. + `GlossaryTerms`— Eine Reihe von UTF-8 Zeichenketten, nicht weniger als 1 oder mehr als 10 Zeichenketten. Die Identifikatoren der Glossarbegriffe, die mit dem Asset verknüpft sind. + `Forms` – Ein Map-Array von Schlüssel-Wert-Paaren. Jeder Schlüssel ist eine UTF-8 Zeichenfolge. Jeder Wert ist ein An [AssetFormEntry](#aws-glue-api-catalog-aws-glue-api-semantics-AssetFormEntry)-Objekt. Die Formulare auf dem Asset, sortiert nach dem Formularnamen. + `Attachments` – Ein Map-Array von Schlüssel-Wert-Paaren. Jeder Schlüssel ist eine UTF-8 Zeichenfolge. Jeder Wert ist ein An [AssetFormEntry](#aws-glue-api-catalog-aws-glue-api-semantics-AssetFormEntry)-Objekt. Zusätzliche Anlagen zum Asset für mehr Kontext, sortiert nach dem Namen des Anhangs. + `IterableForms` – Ein Map-Array von Schlüssel-Wert-Paaren. Jeder Schlüssel ist eine UTF-8 Zeichenfolge. Jeder Wert ist ein An [IterableFormEntry](#aws-glue-api-catalog-aws-glue-api-semantics-IterableFormEntry)-Objekt. Die iterierbaren Formulare, die auf dem Asset verfügbar sind, sind nach dem Formularnamen eingegeben (z. B.`columns`). Verwenden Sie den Formularnamen mit `ListIterableForms` oder`BatchGetIterableForms`, um die Elemente des Formulars abzurufen. ## SearchOutput Struktur Die Antwortstruktur für die `Search` Operation. **Felder** + `Items` – Ein Array mit [SearchResultItem](#aws-glue-api-catalog-aws-glue-api-semantics-SearchResultItem)-Objekten. Die Liste der Assets, die den Suchkriterien entsprechen. + `TotalCount` – Zahl (Ganzzahl). Die Gesamtzahl der Assets, die den Suchkriterien entsprechen. + `NextToken`— UTF-8 Zeichenfolge. Ein Fortsetzungs-Token, das vorhanden ist, wenn das aktuelle Segment nicht das letzte ist. + `Aggregations`— Eine Reihe von Objekten. Die Aggregationsergebnisse für die angeforderten Attribute. ## Operationen + [GetAsset Aktion (Python: get\_asset)](#aws-glue-api-catalog-aws-glue-api-semantics-GetAsset) + [PutAsset Aktion (Python: put\_asset)](#aws-glue-api-catalog-aws-glue-api-semantics-PutAsset) + [DeleteAsset Aktion (Python: delete\_asset)](#aws-glue-api-catalog-aws-glue-api-semantics-DeleteAsset) + [PutAssetType Aktion (Python: put\_asset\_type)](#aws-glue-api-catalog-aws-glue-api-semantics-PutAssetType) + [GetAssetType Aktion (Python: get\_asset\_type)](#aws-glue-api-catalog-aws-glue-api-semantics-GetAssetType) + [DeleteAssetType Aktion (Python: delete\_asset\_type)](#aws-glue-api-catalog-aws-glue-api-semantics-DeleteAssetType) + [ListAssetTypes Aktion (Python: list\_asset\_types)](#aws-glue-api-catalog-aws-glue-api-semantics-ListAssetTypes) + [PutFormType Aktion (Python: put\_form\_type)](#aws-glue-api-catalog-aws-glue-api-semantics-PutFormType) + [GetFormType Aktion (Python: get\_form\_type)](#aws-glue-api-catalog-aws-glue-api-semantics-GetFormType) + [DeleteFormType Aktion (Python: delete\_form\_type)](#aws-glue-api-catalog-aws-glue-api-semantics-DeleteFormType) + [ListFormTypes Aktion (Python: list\_form\_types)](#aws-glue-api-catalog-aws-glue-api-semantics-ListFormTypes) + [PutAttachment Aktion (Python: put\_attachment)](#aws-glue-api-catalog-aws-glue-api-semantics-PutAttachment) + [DeleteAttachment Aktion (Python: delete\_attachment)](#aws-glue-api-catalog-aws-glue-api-semantics-DeleteAttachment) + [ListIterableForms Aktion (Python: list\_iterable\_forms)](#aws-glue-api-catalog-aws-glue-api-semantics-ListIterableForms) + [BatchGetIterableForms Aktion (Python: batch\_get\_iterable\_forms)](#aws-glue-api-catalog-aws-glue-api-semantics-BatchGetIterableForms) + [CreateGlossary Aktion (Python: create\_glossary)](#aws-glue-api-catalog-aws-glue-api-semantics-CreateGlossary) + [GetGlossary Aktion (Python: get\_glossary)](#aws-glue-api-catalog-aws-glue-api-semantics-GetGlossary) + [UpdateGlossary Aktion (Python: update\_glossary)](#aws-glue-api-catalog-aws-glue-api-semantics-UpdateGlossary) + [DeleteGlossary Aktion (Python: delete\_glossary)](#aws-glue-api-catalog-aws-glue-api-semantics-DeleteGlossary) + [ListGlossaries Aktion (Python: list\_glossaries)](#aws-glue-api-catalog-aws-glue-api-semantics-ListGlossaries) + [CreateGlossaryTerm Aktion (Python: create\_glossary\_term)](#aws-glue-api-catalog-aws-glue-api-semantics-CreateGlossaryTerm) + [GetGlossaryTerm Aktion (Python: get\_glossary\_term)](#aws-glue-api-catalog-aws-glue-api-semantics-GetGlossaryTerm) + [UpdateGlossaryTerm Aktion (Python: update\_glossary\_term)](#aws-glue-api-catalog-aws-glue-api-semantics-UpdateGlossaryTerm) + [DeleteGlossaryTerm Aktion (Python: delete\_glossary\_term)](#aws-glue-api-catalog-aws-glue-api-semantics-DeleteGlossaryTerm) + [ListGlossaryTerms Aktion (Python: list\_glossary\_terms)](#aws-glue-api-catalog-aws-glue-api-semantics-ListGlossaryTerms) + [AssociateGlossaryTerms Aktion (Python: associate\_glossary\_terms)](#aws-glue-api-catalog-aws-glue-api-semantics-AssociateGlossaryTerms) + [DisassociateGlossaryTerms Aktion (Python: disassociate\_glossary\_terms)](#aws-glue-api-catalog-aws-glue-api-semantics-DisassociateGlossaryTerms) + [Suchaktion (Python: Suche)](#aws-glue-api-catalog-aws-glue-api-semantics-Search) ## GetAsset Aktion (Python: get\_asset) Ruft die Metadaten für ein Asset im AWS Glue Datenkatalog ab, einschließlich seiner Formulare, zusätzlicher Anlagen und der zugehörigen Glossarbegriffe. **Example** Im folgenden Beispiel wird ein Asset anhand seiner ID abgerufen. ``` 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": {} } ``` **Anforderung** + `Identifier`— *Erforderlich:* UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 1087 Byte lang, entspricht. `String` Die eindeutige Kennung des abzurufenden Assets. **Antwort** Die Antwortstruktur für den `GetAsset` Vorgang. + `GetAssetOutput` – Ein [GetAssetOutput](#aws-glue-api-catalog-aws-glue-api-semantics-GetAssetOutput)-Objekt. **Fehler** + `AccessDeniedException` + `EntityNotFoundException` + `InternalServiceException` + `ThrottlingException` + `InvalidInputException` ## PutAsset Aktion (Python: put\_asset) Erstellt oder aktualisiert ein Asset im AWS Glue Datenkatalog. Wenn das Objekt bereits vorhanden ist, wird es durch diesen Vorgang aktualisiert. Andernfalls wird ein neues Objekt erstellt. **Example** Im folgenden Beispiel wird ein Asset mit einem Formular erstellt. ``` 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\"}" } } } ``` **Anforderung** + `AssetTypeId`— *Erforderlich:* UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 256 Byte lang. Der Bezeichner des Asset-Typs für das Asset. + `Identifier`— *Erforderlich:* UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 1087 Byte lang, entspricht. `String` Die eindeutige Kennung des Assets. Wenn ein Asset mit dieser Kennung bereits existiert, wird es aktualisiert. + `Name`— *Erforderlich:* UTF-8 Zeichenfolge. Der Name des Vermögenswerts. + `Description`— UTF-8 Zeichenfolge. Die Beschreibung des Vermögenswerts. + `Forms` – *Erforderlich:* Ein Map-Array von Schlüssel-Wert-Paaren. Jeder Schlüssel ist eine UTF-8 Zeichenfolge. Jeder Wert ist ein An [AssetFormEntry](#aws-glue-api-catalog-aws-glue-api-semantics-AssetFormEntry)-Objekt. Die Formulare, die für das Asset festgelegt werden sollen, sortiert nach dem Formularnamen. Jeder Eintrag gibt den Formulartyp und seinen JSON-Inhalt an. + `ClientToken`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, entspricht[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Eine eindeutige Kennung, bei der zwischen Groß- und Kleinschreibung unterschieden wird, die Sie angeben, um die Idempotenz der Anforderung sicherzustellen. **Antwort** + `Id`— *Erforderlich:* UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 1087 Byte lang, entspricht. `String` Die eindeutige Kennung des Assets. + `Name`— *Erforderlich:* UTF-8 Zeichenfolge. Der Name des Vermögenswerts. + `Description`— UTF-8 Zeichenfolge. Die Beschreibung des Vermögenswerts. + `CreatedAt` – Zeitstempel. Der Zeitstempel, zu dem das Asset erstellt wurde. + `Forms` – Ein Map-Array von Schlüssel-Wert-Paaren. Jeder Schlüssel ist eine UTF-8 Zeichenfolge. Jeder Wert ist ein An [AssetFormEntry](#aws-glue-api-catalog-aws-glue-api-semantics-AssetFormEntry)-Objekt. Die an das Asset angehängten Formulare, sortiert nach dem Formularnamen. **Fehler** + `AccessDeniedException` + `ConcurrentModificationException` + `EntityNotFoundException` + `InternalServiceException` + `InvalidInputException` + `ThrottlingException` ## DeleteAsset Aktion (Python: delete\_asset) Löscht ein Asset aus dem Datenkatalog. AWS Glue **Example** Im folgenden Beispiel wird ein Asset anhand seiner ID gelöscht. ``` aws glue delete-asset --identifier quarterly-sales-2026q1 ``` **Anforderung** + `Identifier`— *Erforderlich:* UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 1087 Byte lang, entspricht. `String` Die eindeutige Kennung des zu löschenden Assets. **Antwort** + *Keine Antwortparameter.* **Fehler** + `AccessDeniedException` + `ConcurrentModificationException` + `InternalServiceException` + `InvalidInputException` + `ThrottlingException` ## PutAssetType Aktion (Python: put\_asset\_type) Erstellt oder aktualisiert einen Asset-Typ im Datenkatalog. AWS Glue Ein Asset-Typ definiert die Struktur von Assets, indem er angibt, welche Formen sie beinhalten. Wenn ein Asset-Typ mit dem angegebenen Namen bereits existiert, wird er aktualisiert. **Example** Im folgenden Beispiel wird ein Asset-Typ erstellt, der auf einen Formulartyp verweist. ``` aws glue put-asset-type \ --name DataSet \ --forms '{"DataClassification":{"FormTypeIdentifier":"DataClassification"}}' { "Id": "DataSet", "Name": "DataSet", "Forms": { "DataClassification": { "FormTypeIdentifier": "DataClassification" } } } ``` **Anforderung** + `Name`— *Erforderlich:* UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 128 Byte lang, entspricht`String`. Der Name des Asset-Typs. + `Forms`— *Erforderlich:* Ein Map-Array mit Schlüssel-Wert-Paaren, nicht weniger als 1 oder mehr als 100 Paaren. Jeder Schlüssel ist eine UTF-8 Zeichenfolge, die nicht weniger als 1 oder mehr als 128 Byte lang ist und der entspricht. `String` Jeder Wert ist ein An [AssetTypeFormReference](#aws-glue-api-catalog-aws-glue-api-semantics-AssetTypeFormReference)-Objekt. Die Formulare, aus denen sich der Asset-Typ zusammensetzt, sortiert nach dem Formularnamen. Jeder Eintrag verweist auf den Formulartyp, der das Schema des Formulars definiert. + `ClientToken`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, entspricht[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Eine eindeutige Kennung, bei der zwischen Groß- und Kleinschreibung unterschieden wird, die Sie angeben, um die Idempotenz der Anforderung sicherzustellen. **Antwort** + `Id`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 256 Byte lang. Der Bezeichner des Asset-Typs. + `Name`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 128 Byte lang, entspricht`String`. Der Name des Asset-Typs. + `Forms`— Ein Map-Array von Schlüssel-Wert-Paaren, nicht weniger als 1 oder mehr als 100 Paare. Jeder Schlüssel ist eine UTF-8 Zeichenfolge, die nicht weniger als 1 oder mehr als 128 Byte lang ist und der entspricht. `String` Jeder Wert ist ein An [AssetTypeFormReference](#aws-glue-api-catalog-aws-glue-api-semantics-AssetTypeFormReference)-Objekt. Die Formulare, aus denen sich der Asset-Typ zusammensetzt, sortiert nach dem Formularnamen. **Fehler** + `AccessDeniedException` + `InternalServiceException` + `InvalidInputException` + `ConcurrentModificationException` + `ThrottlingException` ## GetAssetType Aktion (Python: get\_asset\_type) Ruft einen Asset-Typ im AWS Glue Datenkatalog anhand seiner Kennung ab. **Example** Im folgenden Beispiel wird ein Asset-Typ anhand seiner ID abgerufen. ``` aws glue get-asset-type --identifier DataSet { "Id": "DataSet", "Name": "DataSet", "Forms": { "DataClassification": { "FormTypeIdentifier": "DataClassification" } } } ``` **Anforderung** + `Identifier`— *Erforderlich:* UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 256 Byte lang. Die Kennung des abzurufenden Asset-Typs. **Antwort** + `Id`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 256 Byte lang. Der Bezeichner des Asset-Typs. + `Name`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 128 Byte lang, entspricht`String`. Der Name des Asset-Typs. + `Forms`— Ein Map-Array von Schlüssel-Wert-Paaren, nicht weniger als 1 oder mehr als 100 Paare. Jeder Schlüssel ist eine UTF-8 Zeichenfolge, die nicht weniger als 1 oder mehr als 128 Byte lang ist und der entspricht. `String` Jeder Wert ist ein An [AssetTypeFormReference](#aws-glue-api-catalog-aws-glue-api-semantics-AssetTypeFormReference)-Objekt. Die Formulare, aus denen sich der Asset-Typ zusammensetzt, sortiert nach dem Formularnamen. **Fehler** + `AccessDeniedException` + `EntityNotFoundException` + `InternalServiceException` + `InvalidInputException` + `ThrottlingException` ## DeleteAssetType Aktion (Python: delete\_asset\_type) Löscht einen Asset-Typ aus dem Datenkatalog. AWS Glue **Example** Im folgenden Beispiel wird ein Asset-Typ anhand seiner ID gelöscht. ``` aws glue delete-asset-type --identifier DataSet ``` **Anforderung** + `Identifier`— *Erforderlich:* UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 256 Byte lang. Der Bezeichner des zu löschenden Asset-Typs. **Antwort** + *Keine Antwortparameter.* **Fehler** + `AccessDeniedException` + `InternalServiceException` + `InvalidInputException` + `ConcurrentModificationException` + `ThrottlingException` ## ListAssetTypes Aktion (Python: list\_asset\_types) Listet die im Datenkatalog definierten Asset-Typen auf. AWS Glue **Example** Im folgenden Beispiel werden die Assettypen im Konto aufgeführt. ``` aws glue list-asset-types --max-results 20 { "Items": [ { "Id": "DataSet", "Name": "DataSet" } ] } ``` **Anforderung** + `MaxResults` – Zahl (Ganzzahl), nicht kleiner als 1 oder größer als 1000. Die maximale Anzahl von Ergebnissen, die in der Antwort zurückgegeben werden sollen. + `NextToken`— UTF-8 Zeichenfolge. Ein Fortsetzungs-Token, wenn dies ein Fortsetzungsaufruf ist. **Antwort** + `Items`— Eine Reihe von Objekten. Die Liste der Elemente des Asset-Typs. + `NextToken`— UTF-8 Zeichenfolge. Ein Fortsetzungs-Token, das vorhanden ist, wenn das aktuelle Segment nicht das letzte ist. **Fehler** + `AccessDeniedException` + `InternalServiceException` + `InvalidInputException` + `ThrottlingException` ## PutFormType Aktion (Python: put\_form\_type) Erstellt oder aktualisiert einen Formulartyp im Datenkatalog. AWS Glue Ein Formulartyp definiert das Schema für strukturierte Metadaten, die an Assets angehängt werden können. **Example** Im folgenden Beispiel wird ein Formulartyp mit einem Smithy-Schema erstellt. ``` 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}" } ``` **Anforderung** + `Name`— *Erforderlich:* UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 128 Byte lang, entspricht. `String` Der Name des Formulartyps. Muss mit einem Großbuchstaben beginnen. + `Schema`— *Erforderlich:* UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 100000 Byte lang. Die Smithy-IDL-Schemadefinition für den Formulartyp. + `ClientToken`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, entspricht. [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) Eine eindeutige Kennung, bei der zwischen Groß- und Kleinschreibung unterschieden wird, die Sie angeben, um die Idempotenz der Anforderung sicherzustellen. **Antwort** + `Id`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 256 Byte lang. Der Bezeichner des Formulartyps. + `Name`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 128 Byte lang, entspricht`String`. Der Name des Formulartyps. + `Schema`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 100000 Byte lang. Das Smithy-IDL-Schema des Formulartyps. **Fehler** + `AccessDeniedException` + `InternalServiceException` + `InvalidInputException` + `ConcurrentModificationException` + `ThrottlingException` ## GetFormType Aktion (Python: get\_form\_type) Ruft einen Formulartyp im AWS Glue Datenkatalog anhand seines Bezeichners ab. **Example** Im folgenden Beispiel wird ein Formulartyp anhand seines Bezeichners abgerufen. ``` aws glue get-form-type --identifier DataClassification { "Id": "DataClassification", "Name": "DataClassification", "Schema": "structure DataClassification {\n classification: String\n owner: String\n}" } ``` **Anforderung** + `Identifier`— *Erforderlich:* UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 256 Byte lang. Der Bezeichner des abzurufenden Formulartyps. **Antwort** + `Id`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 256 Byte lang. Der Bezeichner des Formulartyps. + `Name`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 128 Byte lang, entspricht`String`. Der Name des Formulartyps. + `Schema`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 100000 Byte lang. Das Smithy-IDL-Schema des Formulartyps. **Fehler** + `AccessDeniedException` + `EntityNotFoundException` + `InternalServiceException` + `InvalidInputException` + `ThrottlingException` ## DeleteFormType Aktion (Python: delete\_form\_type) Löscht einen Formulartyp aus dem Datenkatalog. AWS Glue Ein Formulartyp kann nicht gelöscht werden, wenn er immer noch von einem Asset-Typ referenziert wird. **Example** Im folgenden Beispiel wird ein Formulartyp anhand seines Bezeichners gelöscht. ``` aws glue delete-form-type --identifier DataClassification ``` **Anforderung** + `Identifier`— *Erforderlich:* UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 256 Byte lang. Der Bezeichner des zu löschenden Formulartyps. **Antwort** + *Keine Antwortparameter.* **Fehler** + `AccessDeniedException` + `InternalServiceException` + `InvalidInputException` + `ConcurrentModificationException` + `ConflictException` + `ThrottlingException` ## ListFormTypes Aktion (Python: list\_form\_types) Listet die im Datenkatalog definierten Formulartypen auf. AWS Glue **Example** Im folgenden Beispiel werden die Formulartypen im Konto aufgeführt. ``` aws glue list-form-types --max-results 20 { "Items": [ { "Id": "DataClassification", "Name": "DataClassification" } ] } ``` **Anforderung** + `MaxResults` – Zahl (Ganzzahl), nicht kleiner als 1 oder größer als 1000. Die maximale Anzahl von Ergebnissen, die in der Antwort zurückgegeben werden sollen. + `NextToken`— UTF-8 Zeichenfolge. Ein Fortsetzungs-Token, wenn dies ein Fortsetzungsaufruf ist. **Antwort** + `Items`— *Erforderlich:* Eine Reihe von Objekten. Die Liste der Elemente vom Formulartyp. + `NextToken`— UTF-8 Zeichenfolge. Ein Fortsetzungs-Token, das vorhanden ist, wenn das aktuelle Segment nicht das letzte ist. **Fehler** + `AccessDeniedException` + `InternalServiceException` + `InvalidInputException` + `ThrottlingException` ## PutAttachment Aktion (Python: put\_attachment) Hängt ein Formular an ein Asset oder ein iterierbares Formularelement im Datenkatalog an. AWS Glue Wenn bereits ein Anhang mit demselben Namen vorhanden ist, wird er überschrieben. **Example** Im folgenden Beispiel wird ein Formular an ein Asset angehängt. ``` 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" } ``` **Anforderung** + `AssetIdentifier`— *Erforderlich:* UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 1087 Byte lang, entspricht. `String` Die eindeutige Kennung des Assets, an das das Formular angehängt werden soll. + `IterableFormName`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 256 Byte lang, entspricht`String`. Der Name des iterierbaren Formulars. Wenn der Anhang zusammen mit angegeben wird`itemIdentifier`, zielt er auf ein Element innerhalb des iterierbaren Formulars und nicht auf das Asset selbst ab. + `ItemIdentifier`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 1087 Byte lang. Der Bezeichner des Elements in der iterierbaren Form. Erforderlich, wenn `iterableFormName` angegeben ist. + `AttachmentName`— *Erforderlich:* UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 256 Byte lang, entspricht. `String` Der Name des Anhangs. + `Content`— *Erforderlich:* UTF-8 Zeichenfolge. Der JSON-Inhalt des Formulars, der dem Schema des angegebenen Formulartyps entspricht. + `FormTypeId`— *Erforderlich:* UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 256 Byte lang. Der Bezeichner des Formulartyps für diesen Anhang. + `ClientToken`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, entspricht[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Eine eindeutige Kennung, bei der zwischen Groß- und Kleinschreibung unterschieden wird, die Sie angeben, um die Idempotenz der Anforderung sicherzustellen. **Antwort** + `AssetId`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 1087 Byte lang, entspricht der`String`. Die eindeutige Kennung des Assets. + `IterableFormName`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 256 Byte lang, entspricht`String`. Der Name des iterierbaren Formulars, wenn der Anhang auf ein Element abzielt. + `ItemIdentifier`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 1087 Byte lang. Der Bezeichner des Elements in der iterierbaren Form, falls zutreffend. + `AttachmentName`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 256 Byte lang, entspricht. `String` Der Name des Anhangs. + `FormTypeId`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 256 Byte lang. Der Bezeichner des Formulartyps für diesen Anhang. **Fehler** + `AccessDeniedException` + `EntityNotFoundException` + `InternalServiceException` + `InvalidInputException` + `ConcurrentModificationException` + `ThrottlingException` ## DeleteAttachment Aktion (Python: delete\_attachment) Löscht einen Formularanhang aus einem Asset im Datenkatalog. AWS Glue **Example** Im folgenden Beispiel wird ein Anhang aus einem Asset gelöscht. ``` aws glue delete-attachment \ --identifier quarterly-sales-2026q1 \ --attachment-name reviewNote { "Identifier": "quarterly-sales-2026q1" } ``` **Anforderung** + `AssetIdentifier`— *Erforderlich:* UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 1087 Byte lang, entspricht. `String` Die eindeutige Kennung des Assets, von dem der Anhang gelöscht werden soll. + `AttachmentName`— *Erforderlich:* UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 256 Byte lang, entspricht`String`. Der Name des zu löschenden Anhangs. **Antwort** + `Identifier`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 1087 Byte lang, entspricht. `String` Die eindeutige Kennung des Assets. **Fehler** + `AccessDeniedException` + `EntityNotFoundException` + `InternalServiceException` + `InvalidInputException` + `ConcurrentModificationException` + `ThrottlingException` ## ListIterableForms Aktion (Python: list\_iterable\_forms) Listet die Elemente in iterierbarer Form auf einem Asset im Datenkatalog auf. AWS Glue Listet beispielsweise die Spalten eines Tabellenelements auf. **Example** Das folgende Beispiel listet die Spalten eines Assets auf. ``` 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": [] } ] } ``` **Anforderung** + `AssetIdentifier`— *Erforderlich:* UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 1087 Byte lang, entspricht. `String` Die eindeutige Kennung des Assets. + `IterableFormName`— *Erforderlich:* UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 256 Byte lang, entspricht`String`. Der Name des iterierbaren Formulars, aus dem Elemente aufgelistet werden sollen. + `MaxResults` – Zahl (Ganzzahl), nicht kleiner als 1 oder größer als 1000. Die maximale Anzahl von Ergebnissen, die in der Antwort zurückgegeben werden sollen. + `NextToken`— UTF-8 Zeichenfolge. Ein Fortsetzungs-Token, wenn dies ein Fortsetzungsaufruf ist. **Antwort** + `AssetId`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 1087 Byte lang, entspricht der`String`. Die eindeutige Kennung des Assets. + `IterableFormName`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 256 Byte lang, entspricht`String`. Der Name des iterierbaren Formulars. + `Items` – Ein Array mit [IterableFormListItem](#aws-glue-api-catalog-aws-glue-api-semantics-IterableFormListItem)-Objekten. Die Liste der iterierbaren Formularelemente. + `NextToken`— UTF-8 Zeichenfolge. Ein Fortsetzungs-Token, das vorhanden ist, wenn das aktuelle Segment nicht das letzte ist. **Fehler** + `AccessDeniedException` + `EntityNotFoundException` + `InternalServiceException` + `ThrottlingException` + `InvalidInputException` ## BatchGetIterableForms Aktion (Python: batch\_get\_iterable\_forms) Ruft in einer einzigen Anfrage mehrere Elemente aus einem iterierbaren Formular für ein Asset im Datenkatalog ab. AWS Glue **Example** Im folgenden Beispiel werden bestimmte Spalten anhand des Bezeichners abgerufen. ``` 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": [] } ``` **Anforderung** + `AssetIdentifier`— *Erforderlich:* UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 1087 Byte lang, entspricht. `String` Die eindeutige Kennung des Assets. + `IterableFormName`— *Erforderlich:* UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 256 Byte lang, entspricht`String`. Der Name des iterierbaren Formulars, aus dem Elemente abgerufen werden sollen. + `ItemIdentifiers`— *Erforderlich:* Ein Array von UTF-8 Zeichenketten, nicht weniger als 1 oder mehr als 100 Zeichenketten. Die Liste der abzurufenden Artikelkennungen. Bei jeder Kennung kann es sich um eine Artikel-ID oder einen Artikelnamen handeln. **Antwort** + `Items` – Ein Array mit [IterableFormItem](#aws-glue-api-catalog-aws-glue-api-semantics-IterableFormItem)-Objekten. Die Liste der abgerufenen iterierbaren Formularelemente. + `Errors` – Ein Array mit [ItemError](#aws-glue-api-catalog-aws-glue-api-semantics-ItemError)-Objekten. Die Liste der Fehler für Elemente, die nicht abgerufen werden konnten. **Fehler** + `AccessDeniedException` + `EntityNotFoundException` + `InternalServiceException` + `InvalidInputException` + `ThrottlingException` ## CreateGlossary Aktion (Python: create\_glossary) Erstellt ein Geschäftsglossar im Datenkatalog. AWS Glue Ein Glossar ist ein Container für Glossarbegriffe, die Geschäftskonzepte definieren. **Example** Im folgenden Beispiel wird ein Geschäftsglossar erstellt. ``` 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" } ``` **Anforderung** + `Name`— *Erforderlich:* UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 256 Byte lang. Der Name des Glossars. + `Description`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 2048 Byte lang. Die Beschreibung des Glossars. + `ClientToken`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, entspricht. [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) Eine eindeutige Kennung, bei der zwischen Groß- und Kleinschreibung unterschieden wird, die Sie angeben, um die Idempotenz der Anforderung sicherzustellen. **Antwort** + `Id`— UTF-8 Zeichenfolge. Die eindeutige Kennung des Glossars. + `Name`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 256 Byte lang. Der Name des Glossars. + `Description`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 2048 Byte lang. Die Beschreibung des Glossars. **Fehler** + `AccessDeniedException` + `InternalServiceException` + `InvalidInputException` + `ConcurrentModificationException` + `ThrottlingException` + `AlreadyExistsException` ## GetGlossary Aktion (Python: get\_glossary) Ruft ein Geschäftsglossar im AWS Glue Datenkatalog anhand seiner ID ab. **Example** Im folgenden Beispiel wird ein Glossar anhand seiner ID abgerufen. ``` aws glue get-glossary --identifier 6n5f21s641nbjb { "Id": "6n5f21s641nbjb", "Name": "Sales Terms", "Description": "Glossary of sales-domain business terms" } ``` **Anforderung** + `Identifier`— *Erforderlich: Zeichenfolge* UTF-8 . Die eindeutige Kennung des abzurufenden Glossars. **Antwort** + `Id`— UTF-8 Zeichenfolge. Die eindeutige Kennung des Glossars. + `Name`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 256 Byte lang. Der Name des Glossars. + `Description`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 2048 Byte lang. Die Beschreibung des Glossars. **Fehler** + `AccessDeniedException` + `EntityNotFoundException` + `InternalServiceException` + `ThrottlingException` ## UpdateGlossary Aktion (Python: update\_glossary) Aktualisiert ein Geschäftsglossar im Datenkatalog. AWS Glue **Example** Im folgenden Beispiel wird die Beschreibung eines Glossars aktualisiert. ``` 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" } ``` **Anforderung** + `Identifier`— *Erforderlich:* UTF-8 Zeichenfolge. Die eindeutige Kennung des zu aktualisierenden Glossars. + `Name`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 256 Byte lang. Der aktualisierte Name des Glossars. + `Description`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 2048 Byte lang. Die aktualisierte Beschreibung des Glossars. + `ClientToken`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, entspricht. [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) Eine eindeutige Kennung, bei der zwischen Groß- und Kleinschreibung unterschieden wird, die Sie angeben, um die Idempotenz der Anforderung sicherzustellen. **Antwort** + `Id`— UTF-8 Zeichenfolge. Die eindeutige Kennung des Glossars. + `Name`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 256 Byte lang. Der Name des Glossars. + `Description`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 2048 Byte lang. Die Beschreibung des Glossars. **Fehler** + `AccessDeniedException` + `EntityNotFoundException` + `InternalServiceException` + `InvalidInputException` + `ConcurrentModificationException` + `ThrottlingException` + `AlreadyExistsException` ## DeleteGlossary Aktion (Python: delete\_glossary) Löscht ein Geschäftsglossar aus dem Datenkatalog. AWS Glue Ein Glossar kann nicht gelöscht werden, wenn es noch Glossarbegriffe enthält. **Example** Im folgenden Beispiel wird ein Glossar anhand seines Bezeichners gelöscht. ``` aws glue delete-glossary --identifier 6n5f21s641nbjb ``` **Anforderung** + `Identifier`— *Erforderlich: Zeichenfolge* UTF-8 . Die eindeutige Kennung des zu löschenden Glossars. **Antwort** + *Keine Antwortparameter.* **Fehler** + `AccessDeniedException` + `InternalServiceException` + `InvalidInputException` + `ConflictException` + `ConcurrentModificationException` + `ThrottlingException` ## ListGlossaries Aktion (Python: list\_glossaries) Listet Geschäftsglossare im Datenkatalog auf. AWS Glue **Example** Im folgenden Beispiel werden die Glossare im Konto aufgeführt. ``` aws glue list-glossaries --max-results 20 { "Items": [ { "Id": "6n5f21s641nbjb", "Name": "Sales Terms", "Description": "Glossary of sales and revenue business terms" } ] } ``` **Anforderung** + `MaxResults` – Zahl (Ganzzahl), nicht kleiner als 1 oder größer als 1000. Die maximale Anzahl von Ergebnissen, die in der Antwort zurückgegeben werden sollen. + `NextToken`— UTF-8 Zeichenfolge. Ein Fortsetzungs-Token, wenn dies ein Fortsetzungsaufruf ist. **Antwort** + `Items`— Eine Reihe von Objekten. Die Liste der Glossareinträge. + `NextToken`— UTF-8 Zeichenfolge. Ein Fortsetzungs-Token, das vorhanden ist, wenn das aktuelle Segment nicht das letzte ist. **Fehler** + `AccessDeniedException` + `InternalServiceException` + `InvalidInputException` + `ThrottlingException` ## CreateGlossaryTerm Aktion (Python: create\_glossary\_term) Erstellt einen Glossarbegriff in einem Geschäftsglossar im Datenkatalog. AWS Glue **Example** Im folgenden Beispiel wird ein Glossarbegriff erstellt. ``` 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." } ``` **Anforderung** + `GlossaryIdentifier`— *Erforderlich:* UTF-8 Zeichenfolge. Die eindeutige Kennung des Glossars, in dem der Begriff erstellt werden soll. + `Name`— *Erforderlich:* UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 256 Byte lang. Der Name des Glossarbegriffs. + `ShortDescription`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 1024 Byte lang. Eine kurze Beschreibung des Begriffs im Glossar. + `LongDescription`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 4096 Byte lang. Eine ausführliche Beschreibung des Begriffs im Glossar. + `ClientToken`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, entspricht. [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) Eine eindeutige Kennung, bei der zwischen Groß- und Kleinschreibung unterschieden wird, die Sie angeben, um die Idempotenz der Anforderung sicherzustellen. **Antwort** + `Id`— UTF-8 Zeichenfolge. Die eindeutige Kennung des Glossarbegriffs. + `GlossaryId`— UTF-8 Zeichenfolge. Die eindeutige Kennung des Glossars, das diesen Begriff enthält. + `Name`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 256 Byte lang. Der Name des Begriffs im Glossar. + `ShortDescription`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 1024 Byte lang. Die kurze Beschreibung des Begriffs im Glossar. + `LongDescription`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 4096 Byte lang. Die ausführliche Beschreibung des Begriffs im Glossar. **Fehler** + `AccessDeniedException` + `EntityNotFoundException` + `InternalServiceException` + `InvalidInputException` + `ConcurrentModificationException` + `ThrottlingException` + `AlreadyExistsException` ## GetGlossaryTerm Aktion (Python: get\_glossary\_term) Ruft einen Glossarbegriff im Datenkatalog anhand seines Bezeichners ab. AWS Glue **Example** Im folgenden Beispiel wird ein Glossarbegriff anhand seines Bezeichners abgerufen. ``` 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." } ``` **Anforderung** + `Identifier`— *Erforderlich: Zeichenfolge* UTF-8 . Die eindeutige Kennung des abzurufenden Glossarbegriffs. **Antwort** + `Id`— UTF-8 Zeichenfolge. Die eindeutige Kennung des Glossarbegriffs. + `GlossaryId`— UTF-8 Zeichenfolge. Die eindeutige Kennung des Glossars, das diesen Begriff enthält. + `Name`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 256 Byte lang. Der Name des Begriffs im Glossar. + `ShortDescription`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 1024 Byte lang. Die kurze Beschreibung des Begriffs im Glossar. + `LongDescription`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 4096 Byte lang. Die ausführliche Beschreibung des Begriffs im Glossar. **Fehler** + `AccessDeniedException` + `EntityNotFoundException` + `InternalServiceException` + `ThrottlingException` ## UpdateGlossaryTerm Aktion (Python: update\_glossary\_term) Aktualisiert einen Glossarbegriff im Datenkatalog. AWS Glue **Example** Im folgenden Beispiel wird die Kurzbeschreibung eines Glossarbegriffs aktualisiert. ``` 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." } ``` **Anforderung** + `Identifier`— *Erforderlich:* UTF-8 Zeichenfolge. Die eindeutige Kennung des zu aktualisierenden Glossarbegriffs. + `Name`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 256 Byte lang. Der aktualisierte Name des Glossarbegriffs. + `ShortDescription`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 1024 Byte lang. Die aktualisierte Kurzbeschreibung des Glossarbegriffs. + `LongDescription`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 4096 Byte lang. Die aktualisierte ausführliche Beschreibung des Glossarbegriffs. + `ClientToken`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, entspricht. [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) Eine eindeutige Kennung, bei der zwischen Groß- und Kleinschreibung unterschieden wird, die Sie angeben, um die Idempotenz der Anforderung sicherzustellen. **Antwort** + `Id`— UTF-8 Zeichenfolge. Die eindeutige Kennung des Glossarbegriffs. + `GlossaryId`— UTF-8 Zeichenfolge. Die eindeutige Kennung des Glossars, das diesen Begriff enthält. + `Name`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 256 Byte lang. Der Name des Begriffs im Glossar. + `ShortDescription`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 1024 Byte lang. Die kurze Beschreibung des Begriffs im Glossar. + `LongDescription`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 4096 Byte lang. Die ausführliche Beschreibung des Begriffs im Glossar. **Fehler** + `AccessDeniedException` + `EntityNotFoundException` + `InternalServiceException` + `InvalidInputException` + `ConcurrentModificationException` + `ThrottlingException` + `AlreadyExistsException` ## DeleteGlossaryTerm Aktion (Python: delete\_glossary\_term) Löscht einen Glossarbegriff aus dem Datenkatalog. AWS Glue **Example** Im folgenden Beispiel wird ein Glossarbegriff anhand seines Bezeichners gelöscht. ``` aws glue delete-glossary-term --identifier avugvxvsul6izr ``` **Anforderung** + `Identifier`— *Erforderlich: Zeichenfolge* UTF-8 . Die eindeutige Kennung des zu löschenden Glossarbegriffs. **Antwort** + *Keine Antwortparameter.* **Fehler** + `AccessDeniedException` + `InternalServiceException` + `InvalidInputException` + `ConcurrentModificationException` + `ThrottlingException` ## ListGlossaryTerms Aktion (Python: list\_glossary\_terms) Listet Glossarbegriffe in einem Geschäftsglossar im Datenkatalog auf. AWS Glue **Example** Im folgenden Beispiel werden die Begriffe in einem Glossar aufgeführt. ``` 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." } ] } ``` **Anforderung** + `GlossaryIdentifier`— *Erforderlich:* UTF-8 Zeichenfolge. Die eindeutige Kennung des Glossars, dessen Begriffe aufgelistet werden sollen. + `MaxResults` – Zahl (Ganzzahl), nicht kleiner als 1 oder größer als 1000. Die maximale Anzahl von Ergebnissen, die in der Antwort zurückgegeben werden sollen. + `NextToken`— UTF-8 Zeichenfolge. Ein Fortsetzungs-Token, wenn dies ein Fortsetzungsaufruf ist. **Antwort** + `GlossaryId`— UTF-8 Zeichenfolge. Die eindeutige Kennung des Glossars. + `Items`— Eine Reihe von Objekten. Die Liste der Begriffselemente im Glossar. + `NextToken`— UTF-8 Zeichenfolge. Ein Fortsetzungs-Token, das vorhanden ist, wenn das aktuelle Segment nicht das letzte ist. **Fehler** + `AccessDeniedException` + `InternalServiceException` + `InvalidInputException` + `ThrottlingException` ## AssociateGlossaryTerms Aktion (Python: associate\_glossary\_terms) Ordnet einem Asset im Datenkatalog einen oder mehrere Glossarbegriffe zu. AWS Glue **Example** Das folgende Beispiel verknüpft einen Glossarbegriff mit einem Asset. ``` aws glue associate-glossary-terms \ --identifier quarterly-sales-2026q1 \ --glossary-term-identifiers avugvxvsul6izr { "Identifier": "quarterly-sales-2026q1", "GlossaryTerms": [ "avugvxvsul6izr" ] } ``` **Anforderung** + `AssetIdentifier`— *Erforderlich:* UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 1087 Byte lang, entspricht. `String` Die eindeutige Kennung des Assets, dem Glossarbegriffe zugeordnet werden sollen. + `GlossaryTermIdentifiers`— *Erforderlich:* Eine Reihe von UTF-8 Zeichenketten, nicht weniger als 1 oder mehr als 10 Zeichenketten. Die Liste der Begriffskennungen im Glossar, die dem Asset zugeordnet werden sollen. + `ClientToken`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, entspricht. [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) Eine eindeutige Kennung, bei der zwischen Groß- und Kleinschreibung unterschieden wird, die Sie angeben, um die Idempotenz der Anforderung sicherzustellen. **Antwort** + `Identifier`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 1087 Byte lang, entspricht der`String`. Die eindeutige Kennung des Assets. + `GlossaryTerms`— Eine Reihe von UTF-8 Zeichenketten, nicht weniger als 1 oder mehr als 10 Zeichenketten. Die Glossarbegriffe, die jetzt mit dem Asset verknüpft sind. **Fehler** + `AccessDeniedException` + `EntityNotFoundException` + `InternalServiceException` + `InvalidInputException` + `ConcurrentModificationException` + `ThrottlingException` ## DisassociateGlossaryTerms Aktion (Python: disassociate\_glossary\_terms) Entfernt die Zuordnung von einem oder mehreren Glossarbegriffen zu einem Asset im Datenkatalog. AWS Glue **Example** Im folgenden Beispiel wird ein Glossarbegriff aus einem Asset entfernt. ``` aws glue disassociate-glossary-terms \ --identifier quarterly-sales-2026q1 \ --glossary-term-identifiers avugvxvsul6izr { "Identifier": "quarterly-sales-2026q1", "GlossaryTerms": [] } ``` **Anforderung** + `AssetIdentifier`— *Erforderlich:* UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 1087 Byte lang, entspricht. `String` Die eindeutige Kennung des Assets, von dem Glossarbegriffe getrennt werden sollen. + `GlossaryTermIdentifiers`— *Erforderlich:* Eine Reihe von UTF-8 Zeichenketten, nicht weniger als 1 oder mehr als 10 Zeichenketten. Die Liste der Begriffskennungen im Glossar, die dem Asset zugeordnet werden sollen. + `ClientToken`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, entspricht. [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) Eine eindeutige Kennung, bei der zwischen Groß- und Kleinschreibung unterschieden wird, die Sie angeben, um die Idempotenz der Anforderung sicherzustellen. **Antwort** + `Identifier`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 1087 Byte lang, entspricht der`String`. Die eindeutige Kennung des Assets. + `GlossaryTerms`— Eine Reihe von UTF-8 Zeichenketten, nicht weniger als 1 oder mehr als 10 Zeichenketten. Die übrigen Glossarbegriffe, die mit dem Asset verknüpft sind. **Fehler** + `AccessDeniedException` + `EntityNotFoundException` + `InternalServiceException` + `InvalidInputException` + `ConcurrentModificationException` + `ThrottlingException` ## Suchaktion (Python: Suche) Sucht mithilfe von Volltextsuche, Filtern, Sortierung und Aggregationen nach Assets im AWS Glue Datenkatalog. Gibt übereinstimmende Assets mit Ergebnissen nach Relevanz zurück. **Example** Im folgenden Beispiel wird eine Volltextsuche nach Assets ausgeführt. ``` 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** Im folgenden Beispiel wird mit einer Filterklausel und einer Sortierreihenfolge gesucht. ``` 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** Im folgenden Beispiel wird nach einem durch ein Formular definierten Feld gefiltert. Auf ein Formularfeld verweisen die Asset-Typ-ID des Formulars und der Feldname, verbunden mit einem Punkt — hier das `databaseName` Feld des `amazon.glue::GlueTable` Formulars. Asset-Typ-IDs für integrierte Typen tragen das `::` Präfix, das in den einzelnen Ergebnissen angezeigt wird. `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** Das folgende Beispiel kombiniert ein gemeinsames Asset-Feld und ein Formularfeld mit einem logischen UND. Auf allgemeine Asset-Felder wie`name`, `type``region`, und wird direkt verwiesen. Felder, die durch ein Formular definiert `catalogId` sind, verwenden die `assetTypeId.fieldName` Notation. ``` 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" } ] } ``` **Anforderung** + `SearchText`— UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 1000 Byte lang. Der Text, nach dem gesucht werden soll. `filterClause`Es muss mindestens einer von `searchText` oder angegeben werden. + `MaxResults` – Zahl (Ganzzahl), nicht kleiner als 1 oder größer als 100. Die maximale Anzahl von Ergebnissen, die in der Antwort zurückgegeben werden sollen. + `NextToken`— UTF-8 Zeichenfolge. Ein Fortsetzungs-Token, wenn dies ein Fortsetzungsaufruf ist. + `Sort` – Ein [SearchSort](#aws-glue-api-catalog-aws-glue-api-semantics-SearchSort)-Objekt. Die Sortierkriterien für die Suchergebnisse. + `FilterClause` – Ein [SearchFilterClause](#aws-glue-api-catalog-aws-glue-api-semantics-SearchFilterClause)-Objekt. Die Filterklausel, die auf die Suche angewendet werden soll. Unterstützt verschachtelte AND/OR Logik mit Filtern auf Attribut- und Kartenebene. **Antwort** Die Antwortstruktur für den Vorgang. `Search` + `SearchOutput` – Ein [SearchOutput](#aws-glue-api-catalog-aws-glue-api-semantics-SearchOutput)-Objekt. **Fehler** + `AccessDeniedException` + `InvalidInputException` + `InternalServiceException` + `ThrottlingException`