# 业务上下文 API
业务上下文 API 描述了用于管理资产、资产类型、表单类型、术语表条目、附件和在 AWS Glue Data Catalog 中搜索的数据类型和操作。
## 数据类型
+ [AssetFormEntry 结构](#aws-glue-api-catalog-aws-glue-api-semantics-AssetFormEntry)
+ [AsetTypeForm 结构](#aws-glue-api-catalog-aws-glue-api-semantics-AssetTypeFormReference)
+ [IterableFormEntry 结构](#aws-glue-api-catalog-aws-glue-api-semantics-IterableFormEntry)
+ [IterableFormItem 结构](#aws-glue-api-catalog-aws-glue-api-semantics-IterableFormItem)
+ [IterableFormListItem 结构](#aws-glue-api-catalog-aws-glue-api-semantics-IterableFormListItem)
+ [SearchResultItem 结构](#aws-glue-api-catalog-aws-glue-api-semantics-SearchResultItem)
+ [SearchSort 结构](#aws-glue-api-catalog-aws-glue-api-semantics-SearchSort)
+ [SearchFilterClause 结构](#aws-glue-api-catalog-aws-glue-api-semantics-SearchFilterClause)
+ [SearchAttributeFilter 结构](#aws-glue-api-catalog-aws-glue-api-semantics-SearchAttributeFilter)
+ [SearchFilterValue 结构](#aws-glue-api-catalog-aws-glue-api-semantics-SearchFilterValue)
+ [ItemError 结构](#aws-glue-api-catalog-aws-glue-api-semantics-ItemError)
+ [GetAssetOutput 结构](#aws-glue-api-catalog-aws-glue-api-semantics-GetAssetOutput)
+ [SearchOutput 结构](#aws-glue-api-catalog-aws-glue-api-semantics-SearchOutput)
## AssetFormEntry 结构
资产上的表单，由表单类型标识符及其 JSON 内容组成。
**字段**
+ `FormTypeId` – UTF-8 字符串，长度不少于 1 个字节或超过 256 个字节。
定义此表单架构的表单类型的标识符。
+ `Content` – UTF-8 字符串。
表单的 JSON 内容，符合指定表单类型的架构。
## AsetTypeForm 结构
对资产类型中包含的表单类型的引用。
**字段**
+ `FormTypeIdentifier`：*必需：*UTF-8 字符串，长度不少于 1 个字节，不超过 256 个字节。
所引用的表单类型的标识符。
## IterableFormEntry 结构
资产上可用的可迭代表单，由其表单类型标识。
**字段**
+ `FormTypeId` – UTF-8 字符串，长度不少于 1 个字节或超过 256 个字节。
可迭代表单（例如 `columns`）的表单类型标识符，用于通过 `ListIterableForms` 或 `BatchGetIterableForms` 检索其项目。
## IterableFormItem 结构
一个完整的可迭代表单项及其表单。
**字段**
+ `ItemId` – UTF-8 字符串。
项目的唯一标识符。
+ `ItemName` – UTF-8 字符串。
物品的名称。
+ `GlossaryTerms` – UTF-8 字符串数组，不少于 1 个字符串，不超过 10 个字符串。
与项目关联的术语表条目的标识符。
+ `Forms` – 键值对的映射数组。
每个键是一个 UTF-8 字符串。
每个值都是一个 [AssetFormentry](#aws-glue-api-catalog-aws-glue-api-semantics-AssetFormEntry) 对象。
项目上的表单，按表单名称键入。
+ `Attachments` – 键值对的映射数组。
每个键是一个 UTF-8 字符串。
每个值都是一个 [AssetFormentry](#aws-glue-api-catalog-aws-glue-api-semantics-AssetFormEntry) 对象。
项目上的附加附件，按附件名称键控，以提供更多上下文信息。
## IterableFormListItem 结构
可迭代表单的项目摘要。
**字段**
+ `ItemId` – UTF-8 字符串。
项目的唯一标识符。
+ `ItemName` – UTF-8 字符串。
物品的名称。
+ `Description` – UTF-8 字符串。
项目的描述。
+ `GlossaryTerms` – UTF-8 字符串数组，不少于 1 个字符串，不超过 10 个字符串。
与项目关联的术语表条目的标识符。
## SearchResultItem 结构
代表匹配资产的单个搜索结果项。
**字段**
+ `Id` – UTF-8 字符串，不少于 1 个字节或超过 1087 个字节，与 `String` 匹配。
匹配资产的唯一标识符。
+ `AssetName` – UTF-8 字符串。
匹配资产的名称。
+ `AssetDescription` – UTF-8 字符串。
匹配资产的描述。
+ `UpdatedAt` – 时间戳。
上次更新匹配资产的时间戳。
+ `AssetTypeId` – UTF-8 字符串，长度不少于 1 个字节或超过 256 个字节。
匹配资产的资产类型的标识符。
## SearchSort 结构
搜索结果的排序条件。
**字段**
+ `Attribute`：*必需：*UTF-8 字符串，长度不少于 1 个字节，不超过 128 个字节。
要作为排序依据的属性。
+ `Order` – UTF-8 字符串（有效值：`ASCENDING` \| `DESCENDING`）。
排序顺序。有效值为 `ASCENDING` 和 `DESCENDING`。
## SearchFilterClause 结构
支持嵌套布尔逻辑的筛选子句。必须且只能指定以下之一：`andAllFilters`、`orAnyFilters`、`attributeFilter` 或 `mapFilter`。
**字段**
+ `AndAllFilters` – [SearchFilterClause](#aws-glue-api-catalog-aws-glue-api-semantics-SearchFilterClause) 对象的数组，长度不少于 1 个结构，不超过 10 个结构。
必须全部匹配的筛选子句列表（逻辑与）。
+ `OrAnyFilters` – [SearchFilterClause](#aws-glue-api-catalog-aws-glue-api-semantics-SearchFilterClause) 对象的数组，长度不少于 1 个结构，不超过 10 个结构。
筛选子句列表，其中至少有一个必须匹配（逻辑或）。
+ `AttributeFilter` – 一个 [SearchAttributeFilter](#aws-glue-api-catalog-aws-glue-api-semantics-SearchAttributeFilter) 对象。
单个属性值的筛选器。
+ `MapFilter` – .
映射属性的键值对的筛选器。
## SearchAttributeFilter 结构
使用运算符比较属性值的筛选器。
**字段**
+ `Attribute`：*必需：*UTF-8 字符串，长度不少于 1 个字节，不超过 128 个字节。
要筛选的属性名称。
+ `Operator` – *必填：*UTF-8 字符串（有效值：`equals` \| `greaterThan` \| `greaterThanOrEquals` \| `lessThan` \| `lessThanOrEquals` \| `notExists`）。
比较运算符。有效值为 `equals`、`greaterThan`、`greaterThanOrEquals`、`lessThan`、`lessThanOrEquals` 和 `notExists`。
+ `Value` – 一个 [SearchFilterValue](#aws-glue-api-catalog-aws-glue-api-semantics-SearchFilterValue) 对象。
要进行比较的值
## SearchFilterValue 结构
筛选值 必须且只能指定 `stringValue` 或 `longValue` 之一。
**字段**
+ `StringValue` – UTF-8 字符串，不超过 256 个字节。
字符串筛选器值。
+ `LongValue` – 数字（长型）。
长整数筛选器值。
## ItemError 结构
检索可迭代表单项时发生的错误。
**字段**
+ `ItemIdentifier` – UTF-8 字符串，长度不少于 1 个字节或超过 1087 个字节。
导致错误的项目的标识符。
+ `Code` – UTF-8 字符串。
错误代码。
+ `Message` – UTF-8 字符串。
错误消息。
## GetAssetOutput 结构
`GetAsset` 操作的响应结构。
**字段**
+ `Id` – *必填：*UTF-8 字符串，长度不少于 1 个字节或超过 1087 个字节，与 `String` 匹配。
资产的唯一标识符。
+ `Name` – UTF-8 字符串。
资产的名称。
+ `Description` – UTF-8 字符串。
资产的描述。
+ `CreatedAt` – 时间戳。
创建资产的时间戳。
+ `UpdatedAt` – 时间戳。
上次更新资产的时间戳。
+ `CreatedBy` – .
创建资产的主体的身份。
+ `UpdatedBy` – .
上次更新资产的主体的身份。
+ `AssetTypeId`：*必需：*UTF-8 字符串，长度不少于 1 个字节，不超过 256 个字节。
该资产的资产类型的标识符。
+ `GlossaryTerms` – UTF-8 字符串数组，不少于 1 个字符串，不超过 10 个字符串。
与资产相关的术语表条目的标识符。
+ `Forms` – 键值对的映射数组。
每个键是一个 UTF-8 字符串。
每个值都是一个 [AssetFormentry](#aws-glue-api-catalog-aws-glue-api-semantics-AssetFormEntry) 对象。
资产上的表单，按表单名称键入。
+ `Attachments` – 键值对的映射数组。
每个键是一个 UTF-8 字符串。
每个值都是一个 [AssetFormentry](#aws-glue-api-catalog-aws-glue-api-semantics-AssetFormEntry) 对象。
资产上的附加附件，按附件名称键入，以提供更多上下文信息。
+ `IterableForms` – 键值对的映射数组。
每个键是一个 UTF-8 字符串。
每个值都是一个 [IterableFormEntry](#aws-glue-api-catalog-aws-glue-api-semantics-IterableFormEntry) 对象。
资产上可用的可迭代表单，按表单名称键入（例如 `columns`）。使用表单名称和 `ListIterableForms` 或 `BatchGetIterableForms` 检索表单的项目。
## SearchOutput 结构
`Search` 操作的响应结构。
**字段**
+ `Items` – [SearchResultItem](#aws-glue-api-catalog-aws-glue-api-semantics-SearchResultItem) 对象的数组。
符合搜索条件的资产列表。
+ `TotalCount` – 数字（整数）。
符合搜索条件的资产总数。
+ `NextToken` – UTF-8 字符串。
延续令牌，如果当前片段不是最后一个片段则呈现。
+ `Aggregations`–对象的数组。
请求属性的聚合结果。
## 操作
+ [GetAsset 操作 (Python: get\_asset)](#aws-glue-api-catalog-aws-glue-api-semantics-GetAsset)
+ [PutAsset 操作 (Python: put\_asset)](#aws-glue-api-catalog-aws-glue-api-semantics-PutAsset)
+ [DeleteAsset 操作 (Python: delete\_asset)](#aws-glue-api-catalog-aws-glue-api-semantics-DeleteAsset)
+ [PutAssetType 操作 (Python: put\_asset\_type)](#aws-glue-api-catalog-aws-glue-api-semantics-PutAssetType)
+ [GetAssetType 操作 (Python: get\_asset\_type)](#aws-glue-api-catalog-aws-glue-api-semantics-GetAssetType)
+ [DeleteAssetType 操作 (Python: delete\_asset\_type)](#aws-glue-api-catalog-aws-glue-api-semantics-DeleteAssetType)
+ [ListAssetTypes 操作 (Python: list\_asset\_types)](#aws-glue-api-catalog-aws-glue-api-semantics-ListAssetTypes)
+ [PutFormType 操作 (Python: put\_form\_type)](#aws-glue-api-catalog-aws-glue-api-semantics-PutFormType)
+ [GetFormType 操作 (Python: get\_form\_type)](#aws-glue-api-catalog-aws-glue-api-semantics-GetFormType)
+ [DeleteFormType 操作 (Python: delete\_form\_type)](#aws-glue-api-catalog-aws-glue-api-semantics-DeleteFormType)
+ [ListFormTypes 操作 (Python: list\_form\_types)](#aws-glue-api-catalog-aws-glue-api-semantics-ListFormTypes)
+ [PutAttachment 操作 (Python: put\_attachment)](#aws-glue-api-catalog-aws-glue-api-semantics-PutAttachment)
+ [DeleteAttachment 操作 (Python: delete\_attachment)](#aws-glue-api-catalog-aws-glue-api-semantics-DeleteAttachment)
+ [ListIterableForms 操作 (Python: list\_iterable\_forms)](#aws-glue-api-catalog-aws-glue-api-semantics-ListIterableForms)
+ [BatchGetIterableForms 操作 (Python: batch\_get\_iterable\_forms)](#aws-glue-api-catalog-aws-glue-api-semantics-BatchGetIterableForms)
+ [CreateGlossary 操作 (Python: create\_glossary)](#aws-glue-api-catalog-aws-glue-api-semantics-CreateGlossary)
+ [GetGlossary 操作 (Python: get\_glossary)](#aws-glue-api-catalog-aws-glue-api-semantics-GetGlossary)
+ [UpdateGlossary 操作 (Python: update\_glossary)](#aws-glue-api-catalog-aws-glue-api-semantics-UpdateGlossary)
+ [DeleteGlossary 操作 (Python: delete\_glossary)](#aws-glue-api-catalog-aws-glue-api-semantics-DeleteGlossary)
+ [ListGlossaries 操作 (Python: list\_glossaries)](#aws-glue-api-catalog-aws-glue-api-semantics-ListGlossaries)
+ [CreateGlossaryTerm 操作 (Python: create\_glossary\_term)](#aws-glue-api-catalog-aws-glue-api-semantics-CreateGlossaryTerm)
+ [GetGlossaryTerm 操作 (Python: get\_glossary\_term)](#aws-glue-api-catalog-aws-glue-api-semantics-GetGlossaryTerm)
+ [UpdateGlossaryTerm 操作 (Python: update\_glossary\_term)](#aws-glue-api-catalog-aws-glue-api-semantics-UpdateGlossaryTerm)
+ [DeleteGlossaryTerm 操作 (Python: delete\_glossary\_term)](#aws-glue-api-catalog-aws-glue-api-semantics-DeleteGlossaryTerm)
+ [ListGlossaryTerms 操作 (Python: list\_glossary\_terms)](#aws-glue-api-catalog-aws-glue-api-semantics-ListGlossaryTerms)
+ [AssociateGlossaryTerms 操作 (Python: associate\_glossary\_terms)](#aws-glue-api-catalog-aws-glue-api-semantics-AssociateGlossaryTerms)
+ [DisassociateGlossaryTerms 操作 (Python: disassociate\_glossary\_terms)](#aws-glue-api-catalog-aws-glue-api-semantics-DisassociateGlossaryTerms)
+ [Search 操作 (Python: search)](#aws-glue-api-catalog-aws-glue-api-semantics-Search)
## GetAsset 操作 (Python: get\_asset)
检索 AWS Glue Data Catalog 中资产的元数据，包括其表单、其他附件和相关术语表条目。
**Example**
以下示例按标识符检索资产。
```
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": {}
}
```
**请求**
+ `Identifier` – *必填：*UTF-8 字符串，长度不少于 1 个字节或超过 1087 个字节，与 `String` 匹配。
要检索的资产的唯一标识符。
**响应**
`GetAsset` 操作的响应结构。
+ `GetAssetOutput` – 一个 [GetAssetOutput](#aws-glue-api-catalog-aws-glue-api-semantics-GetAssetOutput) 对象。
**错误**
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `ThrottlingException`
+ `InvalidInputException`
## PutAsset 操作 (Python: put\_asset)
在 AWS Glue Data Catalog 中创建或更新资产。如果资源已经存在，则此操作会对其进行更新；否则将创建一个新资产。
**Example**
以下示例使用表单创建资产。
```
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\"}"
}
}
}
```
**请求**
+ `AssetTypeId`：*必需：*UTF-8 字符串，长度不少于 1 个字节，不超过 256 个字节。
资产的资产类型的标识符。
+ `Identifier` – *必填：*UTF-8 字符串，长度不少于 1 个字节或超过 1087 个字节，与 `String` 匹配。
资产的唯一标识符。如果已存在具有此标识符的资产，则对其进行更新。
+ `Name` – *必填：*UTF-8 字符串。
资产的名称。
+ `Description` – UTF-8 字符串。
资产的描述。
+ `Forms` – *必填*：键值对的映射数组。
每个键是一个 UTF-8 字符串。
每个值都是一个 [AssetFormentry](#aws-glue-api-catalog-aws-glue-api-semantics-AssetFormEntry) 对象。
要在资产上设置的表单，按表单名称键入。每个条目都指定表单类型及其 JSON 内容。
+ `ClientToken` – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 匹配。
用于确保请求的幂等性而提供的唯一、区分大小写的标识符。
**响应**
+ `Id` – *必填：*UTF-8 字符串，长度不少于 1 个字节或超过 1087 个字节，与 `String` 匹配。
资产的唯一标识符。
+ `Name` – *必填：*UTF-8 字符串。
资产的名称。
+ `Description` – UTF-8 字符串。
资产的描述。
+ `CreatedAt` – 时间戳。
创建资产的时间戳。
+ `Forms` – 键值对的映射数组。
每个键是一个 UTF-8 字符串。
每个值都是一个 [AssetFormentry](#aws-glue-api-catalog-aws-glue-api-semantics-AssetFormEntry) 对象。
附加到资产的表单，按表单名称键入。
**错误**
+ `AccessDeniedException`
+ `ConcurrentModificationException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `InvalidInputException`
+ `ThrottlingException`
## DeleteAsset 操作 (Python: delete\_asset)
从 AWS Glue Data Catalog 中删除资产。
**Example**
以下示例按标识符删除资产。
```
aws glue delete-asset --identifier quarterly-sales-2026q1
```
**请求**
+ `Identifier` – *必填：*UTF-8 字符串，长度不少于 1 个字节或超过 1087 个字节，与 `String` 匹配。
要删除资产的唯一标识符。
**响应**
+ *无响应参数。*
**错误**
+ `AccessDeniedException`
+ `ConcurrentModificationException`
+ `InternalServiceException`
+ `InvalidInputException`
+ `ThrottlingException`
## PutAssetType 操作 (Python: put\_asset\_type)
在 AWS Glue Data Catalog 中创建或更新资产类型。资产类型通过指定其包含哪些表单来定义资产的结构。如果已存在名称与给定名称相同的资产类型，则对其进行更新。
**Example**
以下示例创建了引用表单类型的资产类型。
```
aws glue put-asset-type \
--name DataSet \
--forms '{"DataClassification":{"FormTypeIdentifier":"DataClassification"}}'
{
"Id": "DataSet",
"Name": "DataSet",
"Forms": {
"DataClassification": {
"FormTypeIdentifier": "DataClassification"
}
}
}
```
**请求**
+ `Name` – *必填*：UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节，与 `String` 匹配。
资产类型的名称。
+ `Forms`–*必填：*键值对的映射数组，不少于 1 对且不超过 100 对。
每个键是一个 UTF-8 字符串，不少于 1 个字节或超过 128 个字节，与 `String` 匹配。
每个值都是一个 [AssetTypeFormReference](#aws-glue-api-catalog-aws-glue-api-semantics-AssetTypeFormReference) 对象。
构成资产类型的表单，按表单名称键入。每个条目都引用定义表单架构的表单类型。
+ `ClientToken` – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 匹配。
用于确保请求的幂等性而提供的唯一、区分大小写的标识符。
**响应**
+ `Id` – UTF-8 字符串，长度不少于 1 个字节或超过 256 个字节。
资产类型的标识符。
+ `Name` – UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节，与 `String` 匹配。
资产类型的名称。
+ `Forms` – 键值对的映射数组，不少于 1 对且不超过 100 对。
每个键是一个 UTF-8 字符串，不少于 1 个字节或超过 128 个字节，与 `String` 匹配。
每个值都是一个 [AssetTypeFormReference](#aws-glue-api-catalog-aws-glue-api-semantics-AssetTypeFormReference) 对象。
构成资产类型的表单，按表单名称键入。
**错误**
+ `AccessDeniedException`
+ `InternalServiceException`
+ `InvalidInputException`
+ `ConcurrentModificationException`
+ `ThrottlingException`
## GetAssetType 操作 (Python: get\_asset\_type)
在 AWS Glue Data Catalog 中按标识符检索资产类型。
**Example**
以下示例按标识符检索资产类型。
```
aws glue get-asset-type --identifier DataSet
{
"Id": "DataSet",
"Name": "DataSet",
"Forms": {
"DataClassification": {
"FormTypeIdentifier": "DataClassification"
}
}
}
```
**请求**
+ `Identifier`：*必需：*UTF-8 字符串，长度不少于 1 个字节，不超过 256 个字节。
要检索的资产类型的标识符。
**响应**
+ `Id` – UTF-8 字符串，长度不少于 1 个字节或超过 256 个字节。
资产类型的标识符。
+ `Name` – UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节，与 `String` 匹配。
资产类型的名称。
+ `Forms` – 键值对的映射数组，不少于 1 对且不超过 100 对。
每个键是一个 UTF-8 字符串，不少于 1 个字节或超过 128 个字节，与 `String` 匹配。
每个值都是一个 [AssetTypeFormReference](#aws-glue-api-catalog-aws-glue-api-semantics-AssetTypeFormReference) 对象。
构成资产类型的表单，按表单名称键入。
**错误**
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `InvalidInputException`
+ `ThrottlingException`
## DeleteAssetType 操作 (Python: delete\_asset\_type)
从 AWS Glue Data Catalog 中删除资产类型。
**Example**
以下示例按标识符删除资产类型。
```
aws glue delete-asset-type --identifier DataSet
```
**请求**
+ `Identifier`：*必需：*UTF-8 字符串，长度不少于 1 个字节，不超过 256 个字节。
要删除的资产类型的标识符。
**响应**
+ *无响应参数。*
**错误**
+ `AccessDeniedException`
+ `InternalServiceException`
+ `InvalidInputException`
+ `ConcurrentModificationException`
+ `ThrottlingException`
## ListAssetTypes 操作 (Python: list\_asset\_types)
列出 AWS Glue Data Catalog 中定义的资产类型。
**Example**
以下示例列出账户中的资产类型。
```
aws glue list-asset-types --max-results 20
{
"Items": [
{
"Id": "DataSet",
"Name": "DataSet"
}
]
}
```
**请求**
+ `MaxResults` – 数字（整数），不小于 1 或大于 1000。
要在响应中返回的结果数量上限。
+ `NextToken` – UTF-8 字符串。
延续标记 (如果这是延续调用)。
**响应**
+ `Items`–对象的数组。
资产类型项目的列表。
+ `NextToken` – UTF-8 字符串。
延续令牌，如果当前片段不是最后一个片段则呈现。
**错误**
+ `AccessDeniedException`
+ `InternalServiceException`
+ `InvalidInputException`
+ `ThrottlingException`
## PutFormType 操作 (Python: put\_form\_type)
在 AWS Glue Data Catalog 中创建或更新表单类型。表单类型定义了可以附加到资产的结构化元数据的架构。
**Example**
以下示例使用 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}"
}
```
**请求**
+ `Name` – *必填*：UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节，与 `String` 匹配。
表单类型的名称。必须以大写字母开头。
+ `Schema` – *必填：* UTF-8 字符串，长度不少于 1 个字节，不超过 100000 个字节。
表单类型的 Smithy IDL 架构定义。
+ `ClientToken` – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 匹配。
用于确保请求的幂等性而提供的唯一、区分大小写的标识符。
**响应**
+ `Id` – UTF-8 字符串，长度不少于 1 个字节或超过 256 个字节。
表单类型的标识符。
+ `Name` – UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节，与 `String` 匹配。
表单类型的名称。
+ `Schema`：UTF-8 字符串，长度不少于 1 个字节，不超过 100000 个字节。
表单类型的 Smithy IDL 架构。
**错误**
+ `AccessDeniedException`
+ `InternalServiceException`
+ `InvalidInputException`
+ `ConcurrentModificationException`
+ `ThrottlingException`
## GetFormType 操作 (Python: get\_form\_type)
按标识符检索 AWS Glue Data Catalog 中的表单类型。
**Example**
以下示例通过标识符检索表单类型。
```
aws glue get-form-type --identifier DataClassification
{
"Id": "DataClassification",
"Name": "DataClassification",
"Schema": "structure DataClassification {\n classification: String\n owner: String\n}"
}
```
**请求**
+ `Identifier`：*必需：*UTF-8 字符串，长度不少于 1 个字节，不超过 256 个字节。
要检索的表单类型的标识符。
**响应**
+ `Id` – UTF-8 字符串，长度不少于 1 个字节或超过 256 个字节。
表单类型的标识符。
+ `Name` – UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节，与 `String` 匹配。
表单类型的名称。
+ `Schema`：UTF-8 字符串，长度不少于 1 个字节，不超过 100000 个字节。
表单类型的 Smithy IDL 架构。
**错误**
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `InvalidInputException`
+ `ThrottlingException`
## DeleteFormType 操作 (Python: delete\_form\_type)
从 AWS Glue Data Catalog 中删除表单类型。如果一个表单类型仍在由资产类型引用，则无法删除该表单类型。
**Example**
以下示例通过表单类型的标识符删除表单类型。
```
aws glue delete-form-type --identifier DataClassification
```
**请求**
+ `Identifier`：*必需：*UTF-8 字符串，长度不少于 1 个字节，不超过 256 个字节。
要删除的表单类型的标识符。
**响应**
+ *无响应参数。*
**错误**
+ `AccessDeniedException`
+ `InternalServiceException`
+ `InvalidInputException`
+ `ConcurrentModificationException`
+ `ConflictException`
+ `ThrottlingException`
## ListFormTypes 操作 (Python: list\_form\_types)
列出在 AWS Glue Data Catalog 中定义的表单类型。
**Example**
以下示例列出账户中的表单类型。
```
aws glue list-form-types --max-results 20
{
"Items": [
{
"Id": "DataClassification",
"Name": "DataClassification"
}
]
}
```
**请求**
+ `MaxResults` – 数字（整数），不小于 1 或大于 1000。
要在响应中返回的结果数量上限。
+ `NextToken` – UTF-8 字符串。
延续标记 (如果这是延续调用)。
**响应**
+ `Items`–*必填：*对象的数组。
表单类型项目的列表。
+ `NextToken` – UTF-8 字符串。
延续令牌，如果当前片段不是最后一个片段则呈现。
**错误**
+ `AccessDeniedException`
+ `InternalServiceException`
+ `InvalidInputException`
+ `ThrottlingException`
## PutAttachment 操作 (Python: put\_attachment)
将表单附加到 AWS Glue Data Catalog 中的资产或可迭代表单项。如果已经存在同名的附件，则会将其覆盖。
**Example**
以下示例将表单附加到资产。
```
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"
}
```
**请求**
+ `AssetIdentifier` – *必填：*UTF-8 字符串，长度不少于 1 个字节或超过 1087 个字节，与 `String` 匹配。
要将表单附加到的资产的唯一标识符。
+ `IterableFormName` – UTF-8 字符串，长度不少于 1 个字节或超过 256 个字节，与 `String` 匹配。
可迭代表单的名称。与 `itemIdentifier` 一起指定时，附件的目标是可迭代表单中的项目，而不是资产本身。
+ `ItemIdentifier` – UTF-8 字符串，长度不少于 1 个字节或超过 1087 个字节。
可迭代表单中项目的标识符。在指定 `iterableFormName` 时是必需的。
+ `AttachmentName` – *必填：*UTF-8 字符串，长度不少于 1 个字节或超过 256 个字节，与 `String` 匹配。
附件的名称。
+ `Content` – *必填：*UTF-8 字符串。
表单的 JSON 内容，符合指定表单类型的架构。
+ `FormTypeId`：*必需：*UTF-8 字符串，长度不少于 1 个字节，不超过 256 个字节。
此附件的表单类型的标识符。
+ `ClientToken` – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 匹配。
用于确保请求的幂等性而提供的唯一、区分大小写的标识符。
**响应**
+ `AssetId` – UTF-8 字符串，不少于 1 个字节或超过 1087 个字节，与 `String` 匹配。
资产的唯一标识符。
+ `IterableFormName` – UTF-8 字符串，长度不少于 1 个字节或超过 256 个字节，与 `String` 匹配。
如果附件以项目为目标，则为可迭代表单的名称。
+ `ItemIdentifier` – UTF-8 字符串，长度不少于 1 个字节或超过 1087 个字节。
如适用，可迭代表单中项目的标识符。
+ `AttachmentName` – UTF-8 字符串，长度不少于 1 个字节或超过 256 个字节，与 `String` 匹配。
附件的名称。
+ `FormTypeId` – UTF-8 字符串，长度不少于 1 个字节或超过 256 个字节。
此附件的表单类型的标识符。
**错误**
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `InvalidInputException`
+ `ConcurrentModificationException`
+ `ThrottlingException`
## DeleteAttachment 操作 (Python: delete\_attachment)
从 AWS Glue Data Catalog 中的资产中删除表单附件。
**Example**
以下示例将删除资产中的附件。
```
aws glue delete-attachment \
--identifier quarterly-sales-2026q1 \
--attachment-name reviewNote
{
"Identifier": "quarterly-sales-2026q1"
}
```
**请求**
+ `AssetIdentifier` – *必填：*UTF-8 字符串，长度不少于 1 个字节或超过 1087 个字节，与 `String` 匹配。
要删除其中的附件的资产的唯一标识符。
+ `AttachmentName` – *必填：*UTF-8 字符串，长度不少于 1 个字节或超过 256 个字节，与 `String` 匹配。
要删除的附件的名称。
**响应**
+ `Identifier` – UTF-8 字符串，不少于 1 个字节或超过 1087 个字节，与 `String` 匹配。
资产的唯一标识符。
**错误**
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `InvalidInputException`
+ `ConcurrentModificationException`
+ `ThrottlingException`
## ListIterableForms 操作 (Python: list\_iterable\_forms)
在 AWS Glue Data Catalog中以可迭代表单列出资产上的项目。例如，列出表格资产的列。
**Example**
以下示例列出了资产的列。
```
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": []
}
]
}
```
**请求**
+ `AssetIdentifier` – *必填：*UTF-8 字符串，长度不少于 1 个字节或超过 1087 个字节，与 `String` 匹配。
资产的唯一标识符。
+ `IterableFormName` – *必填：*UTF-8 字符串，长度不少于 1 个字节或超过 256 个字节，与 `String` 匹配。
要从中列出项目的可迭代表单的名称。
+ `MaxResults` – 数字（整数），不小于 1 或大于 1000。
要在响应中返回的结果数量上限。
+ `NextToken` – UTF-8 字符串。
延续标记 (如果这是延续调用)。
**响应**
+ `AssetId` – UTF-8 字符串，不少于 1 个字节或超过 1087 个字节，与 `String` 匹配。
资产的唯一标识符。
+ `IterableFormName` – UTF-8 字符串，长度不少于 1 个字节或超过 256 个字节，与 `String` 匹配。
可迭代表单的名称。
+ `Items` – [IterableFormListItem](#aws-glue-api-catalog-aws-glue-api-semantics-IterableFormListItem) 对象的数组。
可迭代表单项的列表。
+ `NextToken` – UTF-8 字符串。
延续令牌，如果当前片段不是最后一个片段则呈现。
**错误**
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `ThrottlingException`
+ `InvalidInputException`
## BatchGetIterableForms 操作 (Python: batch\_get\_iterable\_forms)
在单个请求中检索 AWS Glue Data Catalog 中资产的可迭代表单中的多个项目。
**Example**
以下示例按标识符检索特定列。
```
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": []
}
```
**请求**
+ `AssetIdentifier` – *必填：*UTF-8 字符串，长度不少于 1 个字节或超过 1087 个字节，与 `String` 匹配。
资产的唯一标识符。
+ `IterableFormName` – *必填：*UTF-8 字符串，长度不少于 1 个字节或超过 256 个字节，与 `String` 匹配。
要从中检索项目表单的可迭代表单的名称。
+ `ItemIdentifiers` – *必填：*UTF-8 字符串数组，不少于 1 个字符串，不超过 100 个字符串。
要检索的项目标识符列表。每个标识符可以是项目 ID 或项目名称。
**响应**
+ `Items` – [IterableFormItem](#aws-glue-api-catalog-aws-glue-api-semantics-IterableFormItem) 对象的数组。
检索到的可迭代表单项列表。
+ `Errors` – [ItemError](#aws-glue-api-catalog-aws-glue-api-semantics-ItemError) 对象的数组。
无法检索的项目的错误列表。
**错误**
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `InvalidInputException`
+ `ThrottlingException`
## CreateGlossary 操作 (Python: create\_glossary)
在 AWS Glue Data Catalog 中创建业务术语表。术语表是用于容纳定义业务概念的术语表条目的容器。
**Example**
以下示例创建了一个业务术语表。
```
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"
}
```
**请求**
+ `Name`：*必需：*UTF-8 字符串，长度不少于 1 个字节，不超过 256 个字节。
术语表的名称。
+ `Description`：UTF-8 字符串，长度不少于 1 个字节，不超过 2048 个字节。
术语表的描述。
+ `ClientToken` – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 匹配。
用于确保请求的幂等性而提供的唯一、区分大小写的标识符。
**响应**
+ `Id` – UTF-8 字符串。
术语表的唯一标识符。
+ `Name` – UTF-8 字符串，长度不少于 1 个字节或超过 256 个字节。
术语表的名称。
+ `Description`：UTF-8 字符串，长度不少于 1 个字节，不超过 2048 个字节。
术语表的描述。
**错误**
+ `AccessDeniedException`
+ `InternalServiceException`
+ `InvalidInputException`
+ `ConcurrentModificationException`
+ `ThrottlingException`
+ `AlreadyExistsException`
## GetGlossary 操作 (Python: get\_glossary)
按标识符检索 AWS Glue Data Catalog 中的业务术语表。
**Example**
以下示例按标识符检索术语表。
```
aws glue get-glossary --identifier 6n5f21s641nbjb
{
"Id": "6n5f21s641nbjb",
"Name": "Sales Terms",
"Description": "Glossary of sales-domain business terms"
}
```
**请求**
+ `Identifier` – *必填：*UTF-8 字符串。
要检索术语表的唯一标识符。
**响应**
+ `Id` – UTF-8 字符串。
术语表的唯一标识符。
+ `Name` – UTF-8 字符串，长度不少于 1 个字节或超过 256 个字节。
术语表的名称。
+ `Description`：UTF-8 字符串，长度不少于 1 个字节，不超过 2048 个字节。
术语表的描述。
**错误**
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `ThrottlingException`
## UpdateGlossary 操作 (Python: update\_glossary)
在 AWS Glue Data Catalog 中更新业务术语表。
**Example**
以下示例更新术语表的说明。
```
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"
}
```
**请求**
+ `Identifier` – *必填：*UTF-8 字符串。
要更新的术语表的唯一标识符。
+ `Name` – UTF-8 字符串，长度不少于 1 个字节或超过 256 个字节。
术语表的更新名称。
+ `Description`：UTF-8 字符串，长度不少于 1 个字节，不超过 2048 个字节。
术语表的更新描述。
+ `ClientToken` – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 匹配。
用于确保请求的幂等性而提供的唯一、区分大小写的标识符。
**响应**
+ `Id` – UTF-8 字符串。
术语表的唯一标识符。
+ `Name` – UTF-8 字符串，长度不少于 1 个字节或超过 256 个字节。
术语表的名称。
+ `Description`：UTF-8 字符串，长度不少于 1 个字节，不超过 2048 个字节。
术语表的描述。
**错误**
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `InvalidInputException`
+ `ConcurrentModificationException`
+ `ThrottlingException`
+ `AlreadyExistsException`
## DeleteGlossary 操作 (Python: delete\_glossary)
从 AWS Glue Data Catalog 中删除业务术语表。如果术语表中仍包含术语表条目，则无法将其删除。
**Example**
以下示例按标识符删除术语表。
```
aws glue delete-glossary --identifier 6n5f21s641nbjb
```
**请求**
+ `Identifier` – *必填：*UTF-8 字符串。
要删除术语表的唯一标识符。
**响应**
+ *无响应参数。*
**错误**
+ `AccessDeniedException`
+ `InternalServiceException`
+ `InvalidInputException`
+ `ConflictException`
+ `ConcurrentModificationException`
+ `ThrottlingException`
## ListGlossaries 操作 (Python: list\_glossaries)
在 AWS Glue Data Catalog 中列出业务术语表。
**Example**
以下示例列出账户中的术语表。
```
aws glue list-glossaries --max-results 20
{
"Items": [
{
"Id": "6n5f21s641nbjb",
"Name": "Sales Terms",
"Description": "Glossary of sales and revenue business terms"
}
]
}
```
**请求**
+ `MaxResults` – 数字（整数），不小于 1 或大于 1000。
要在响应中返回的结果数量上限。
+ `NextToken` – UTF-8 字符串。
延续标记 (如果这是延续调用)。
**响应**
+ `Items`–对象的数组。
术语表条目列表。
+ `NextToken` – UTF-8 字符串。
延续令牌，如果当前片段不是最后一个片段则呈现。
**错误**
+ `AccessDeniedException`
+ `InternalServiceException`
+ `InvalidInputException`
+ `ThrottlingException`
## CreateGlossaryTerm 操作 (Python: create\_glossary\_term)
在 AWS Glue Data Catalog 业务术语表中创建术语表条目。
**Example**
以下示例创建术语表条目：
```
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."
}
```
**请求**
+ `GlossaryIdentifier` – *必填：*UTF-8 字符串。
要在其中创建术语表条目的术语表的唯一标识符。
+ `Name`：*必需：*UTF-8 字符串，长度不少于 1 个字节，不超过 256 个字节。
术语表条目的名称。
+ `ShortDescription` – UTF-8 字符串，长度不少于 1 个字节或超过 1024 个字节。
术语表条目的简短描述。
+ `LongDescription` – UTF-8 字符串，长度不少于 1 个字节或超过 4096 个字节。
术语表条目的详细描述。
+ `ClientToken` – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 匹配。
用于确保请求的幂等性而提供的唯一、区分大小写的标识符。
**响应**
+ `Id` – UTF-8 字符串。
术语表条目的唯一标识符。
+ `GlossaryId` – UTF-8 字符串。
包含此条目的术语表的唯一标识符。
+ `Name` – UTF-8 字符串，长度不少于 1 个字节或超过 256 个字节。
术语表条目的名称。
+ `ShortDescription` – UTF-8 字符串，长度不少于 1 个字节或超过 1024 个字节。
术语表条目的简短描述。
+ `LongDescription` – UTF-8 字符串，长度不少于 1 个字节或超过 4096 个字节。
术语表条目的详细描述。
**错误**
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `InvalidInputException`
+ `ConcurrentModificationException`
+ `ThrottlingException`
+ `AlreadyExistsException`
## GetGlossaryTerm 操作 (Python: get\_glossary\_term)
按标识符检索 AWS Glue Data Catalog 中的术语表条目。
**Example**
以下示例按标识符检索术语表条目。
```
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."
}
```
**请求**
+ `Identifier` – *必填：*UTF-8 字符串。
要检索的术语表条目的唯一标识符。
**响应**
+ `Id` – UTF-8 字符串。
术语表条目的唯一标识符。
+ `GlossaryId` – UTF-8 字符串。
包含此条目的术语表的唯一标识符。
+ `Name` – UTF-8 字符串，长度不少于 1 个字节或超过 256 个字节。
术语表条目的名称。
+ `ShortDescription` – UTF-8 字符串，长度不少于 1 个字节或超过 1024 个字节。
术语表条目的简短描述。
+ `LongDescription` – UTF-8 字符串，长度不少于 1 个字节或超过 4096 个字节。
术语表条目的详细描述。
**错误**
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `ThrottlingException`
## UpdateGlossaryTerm 操作 (Python: update\_glossary\_term)
更新 AWS Glue Data Catalog 中的术语表条目。
**Example**
以下示例更新了术语表条目的简短描述。
```
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."
}
```
**请求**
+ `Identifier` – *必填：*UTF-8 字符串。
要更新的术语表条目的唯一标识符。
+ `Name` – UTF-8 字符串，长度不少于 1 个字节或超过 256 个字节。
术语表条目的更新名称。
+ `ShortDescription` – UTF-8 字符串，长度不少于 1 个字节或超过 1024 个字节。
术语表条目的简短描述。
+ `LongDescription` – UTF-8 字符串，长度不少于 1 个字节或超过 4096 个字节。
术语表条目的更新详细描述。
+ `ClientToken` – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 匹配。
用于确保请求的幂等性而提供的唯一、区分大小写的标识符。
**响应**
+ `Id` – UTF-8 字符串。
术语表条目的唯一标识符。
+ `GlossaryId` – UTF-8 字符串。
包含此条目的术语表的唯一标识符。
+ `Name` – UTF-8 字符串，长度不少于 1 个字节或超过 256 个字节。
术语表条目的名称。
+ `ShortDescription` – UTF-8 字符串，长度不少于 1 个字节或超过 1024 个字节。
术语表条目的简短描述。
+ `LongDescription` – UTF-8 字符串，长度不少于 1 个字节或超过 4096 个字节。
术语表条目的详细描述。
**错误**
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `InvalidInputException`
+ `ConcurrentModificationException`
+ `ThrottlingException`
+ `AlreadyExistsException`
## DeleteGlossaryTerm 操作 (Python: delete\_glossary\_term)
从 AWS Glue Data Catalog 中删除术语表条目。
**Example**
以下示例按标识符删除术语表条目。
```
aws glue delete-glossary-term --identifier avugvxvsul6izr
```
**请求**
+ `Identifier` – *必填：*UTF-8 字符串。
要删除术语表条目的唯一标识符。
**响应**
+ *无响应参数。*
**错误**
+ `AccessDeniedException`
+ `InternalServiceException`
+ `InvalidInputException`
+ `ConcurrentModificationException`
+ `ThrottlingException`
## ListGlossaryTerms 操作 (Python: list\_glossary\_terms)
列出 AWS Glue Data Catalog 中业务术语表中的术语表条目。
**Example**
以下示例列出了术语表中的术语表条目。
```
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."
}
]
}
```
**请求**
+ `GlossaryIdentifier` – *必填：*UTF-8 字符串。
要列出术语表条目的术语表的唯一标识符。
+ `MaxResults` – 数字（整数），不小于 1 或大于 1000。
要在响应中返回的结果数量上限。
+ `NextToken` – UTF-8 字符串。
延续标记 (如果这是延续调用)。
**响应**
+ `GlossaryId` – UTF-8 字符串。
术语表的唯一标识符。
+ `Items`–对象的数组。
术语表条目项列表。
+ `NextToken` – UTF-8 字符串。
延续令牌，如果当前片段不是最后一个片段则呈现。
**错误**
+ `AccessDeniedException`
+ `InternalServiceException`
+ `InvalidInputException`
+ `ThrottlingException`
## AssociateGlossaryTerms 操作 (Python: associate\_glossary\_terms)
将一个或多个术语表条目与 AWS Glue Data Catalog 中的资产相关联。
**Example**
以下示例将术语表条目与资产相关联。
```
aws glue associate-glossary-terms \
--identifier quarterly-sales-2026q1 \
--glossary-term-identifiers avugvxvsul6izr
{
"Identifier": "quarterly-sales-2026q1",
"GlossaryTerms": [
"avugvxvsul6izr"
]
}
```
**请求**
+ `AssetIdentifier` – *必填：*UTF-8 字符串，长度不少于 1 个字节或超过 1087 个字节，与 `String` 匹配。
要与术语表条目关联的资产的唯一标识符。
+ `GlossaryTermIdentifiers` — *必填：*UTF-8 字符串数组，不少于 1 个或不超过 10 个字符串。
要与资产关联的术语表条目标识符列表。
+ `ClientToken` – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 匹配。
用于确保请求的幂等性而提供的唯一、区分大小写的标识符。
**响应**
+ `Identifier` – UTF-8 字符串，不少于 1 个字节或超过 1087 个字节，与 `String` 匹配。
资产的唯一标识符。
+ `GlossaryTerms` – UTF-8 字符串数组，不少于 1 个字符串，不超过 10 个字符串。
术语表条目现在与资产相关联。
**错误**
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `InvalidInputException`
+ `ConcurrentModificationException`
+ `ThrottlingException`
## DisassociateGlossaryTerms 操作 (Python: disassociate\_glossary\_terms)
从 AWS Glue Data Catalog 中的资产中移除一个或多个术语表条目的关联。
**Example**
以下示例从资产中删除术语表条目。
```
aws glue disassociate-glossary-terms \
--identifier quarterly-sales-2026q1 \
--glossary-term-identifiers avugvxvsul6izr
{
"Identifier": "quarterly-sales-2026q1",
"GlossaryTerms": []
}
```
**请求**
+ `AssetIdentifier` – *必填：*UTF-8 字符串，长度不少于 1 个字节或超过 1087 个字节，与 `String` 匹配。
要解除与术语表条目关联的资产的唯一标识符。
+ `GlossaryTermIdentifiers` — *必填：*UTF-8 字符串数组，不少于 1 个或不超过 10 个字符串。
要与资产解除关联的术语表条目标识符列表。
+ `ClientToken` – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 匹配。
用于确保请求的幂等性而提供的唯一、区分大小写的标识符。
**响应**
+ `Identifier` – UTF-8 字符串，不少于 1 个字节或超过 1087 个字节，与 `String` 匹配。
资产的唯一标识符。
+ `GlossaryTerms` – UTF-8 字符串数组，不少于 1 个字符串，不超过 10 个字符串。
与资产相关的其余术语表条目。
**错误**
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `InvalidInputException`
+ `ConcurrentModificationException`
+ `ThrottlingException`
## Search 操作 (Python: search)
使用全文搜索、筛选器、排序和聚合在 AWS Glue Data Catalog 中搜索资产。返回具有相关性排名结果的匹配资产。
**Example**
以下示例对资产进行全文搜索。
```
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**
以下示例使用筛选子句和排序顺序进行搜索。
```
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**
以下示例对表单定义的字段进行筛选。表单字段由表单的资产类型标识符和字段名称引用，并用点连接在一起，此处是 `amazon.glue::GlueTable` 表单的 `databaseName` 字段。内置类型的资产类型标识符带有每个结果 `::` 中显示的 `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**
以下示例将常见资产字段和表单字段与逻辑与组合在一起。诸如 `name`、`type`、`region` 和 `catalogId` 之类的常见资产字段可直接引用；表单定义的字段使用 `assetTypeId.fieldName` 表示法。
```
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"
}
]
}
```
**请求**
+ `SearchText` – UTF-8 字符串，长度不少于 1 个字节或超过 1000 个字节。
要搜索的文本。必须至少提供 `searchText` 或 `filterClause` 之一。
+ `MaxResults` – 数字（整数），不小于 1 或大于 100。
要在响应中返回的结果数量上限。
+ `NextToken` – UTF-8 字符串。
延续标记 (如果这是延续调用)。
+ `Sort` – 一个 [SearchSort](#aws-glue-api-catalog-aws-glue-api-semantics-SearchSort) 对象。
搜索结果的排序条件。
+ `FilterClause` – 一个 [SearchFilterClause](#aws-glue-api-catalog-aws-glue-api-semantics-SearchFilterClause) 对象。
要应用于搜索的筛选子句。支持带有属性级和地图级筛选器的嵌套与/或逻辑。
**响应**
`Search` 操作的响应结构。
+ `SearchOutput` – 一个 [SearchOutput](#aws-glue-api-catalog-aws-glue-api-semantics-SearchOutput) 对象。
**错误**
+ `AccessDeniedException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `ThrottlingException`