架构注册表

• RegistryId 结构

• RegistryListItem 结构

• MetadataInfo 结构

• OtherMetadataValueListItem 结构

• SchemaListItem 结构

• SchemaVersionListItem 结构

• MetadataKeyValuePair 结构

• SchemaVersionErrorItem 结构

• ErrorDetails 结构

• SchemaVersionNumber 结构

• SchemaId 结构

字段

• RegistryName – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Custom string pattern #18 匹配。

  注册表的名称。仅用于查找。必须提供 RegistryArn 或 RegistryName 中的一个。

• RegistryArn – UTF-8 字符串，长度不少于 1 个字节或超过 10240 个字节，与 Custom string pattern #22 匹配。

  要更新的注册表的 ARN。必须提供 RegistryArn 或 RegistryName 中的一个。

字段

• RegistryName – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Custom string pattern #18 匹配。

  注册表的名称。

• RegistryArn – UTF-8 字符串，长度不少于 1 个字节或超过 10240 个字节，与 Custom string pattern #22 匹配。

  注册表的 Amazon Resource Name（ARN）。

• Description – 描述字符串，长度不超过 2048 个字节，与 URI address multi-line string pattern 匹配。

  注册表的描述。

• Status – UTF-8 字符串（有效值：AVAILABLE | DELETING）。

  注册表的状态。

• CreatedTime – UTF-8 字符串。

  注册表创建的数据。

• UpdatedTime – UTF-8 字符串。

  注册表更新的日期。

字段

• MetadataValue – UTF-8 字符串，长度不少于 1 个字节或超过 256 个字节，与 Custom string pattern #34 匹配。

  元数据键的相应值。

• CreatedTime – UTF-8 字符串。

  创建条目的时间。

• OtherMetadataValueList – OtherMetadataValueListItem 对象的数组。

  属于同一元数据键的其他元数据。

字段

• MetadataValue – UTF-8 字符串，长度不少于 1 个字节或超过 256 个字节，与 Custom string pattern #34 匹配。

  元数据键的其他元数据的相应值属于同一元数据键。

• CreatedTime – UTF-8 字符串。

  创建条目的时间。

字段

• RegistryName – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Custom string pattern #18 匹配。

  架构所在的注册表的名称。

• SchemaName – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Custom string pattern #18 匹配。

  架构的名称。

• SchemaArn – UTF-8 字符串，长度不少于 1 个字节或超过 10240 个字节，与 Custom string pattern #22 匹配。

  架构的 Amazon Resource Name（ARN）。

• Description – 描述字符串，长度不超过 2048 个字节，与 URI address multi-line string pattern 匹配。

  架构描述。

• SchemaStatus – UTF-8 字符串（有效值：AVAILABLE | PENDING | DELETING）。

  架构的状态。

• CreatedTime – UTF-8 字符串。

  架构的创建日期和时间。

• UpdatedTime – UTF-8 字符串。

  架构的更新日期和时间。

字段

• SchemaArn – UTF-8 字符串，长度不少于 1 个字节或超过 10240 个字节，与 Custom string pattern #22 匹配。

  架构的 Amazon Resource Name（ARN）。

• SchemaVersionId – UTF-8 字符串，长度不少于 36 个字节或超过 36 个字节，与 Custom string pattern #17 匹配。

  架构版本的唯一标识符。

• VersionNumber – 数字（长度），不小于 1 或大于 100000。

  架构的版本号。

• Status – UTF-8 字符串（有效值：AVAILABLE |PENDING | FAILURE | DELETING）。

  架构版本的状态。

• CreatedTime – UTF-8 字符串。

  此架构版本的创建日期和时间。

字段

• MetadataKey – UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节，与 Custom string pattern #34 匹配。

  元数据键

• MetadataValue – UTF-8 字符串，长度不少于 1 个字节或超过 256 个字节，与 Custom string pattern #34 匹配。

  元数据键的相应值。

字段

• VersionNumber – 数字（长度），不小于 1 或大于 100000。

  架构的版本号。

• ErrorDetails – 一个 ErrorDetails 对象。

  架构版本的错误的详细信息。

字段

• ErrorCode – UTF-8 字符串。

  错误的错误代码。

• ErrorMessage – UTF-8 字符串。

  错误的错误消息。

字段

• LatestVersion – 布尔值。

  可用于架构的最新版本。

• VersionNumber – 数字（长度），不小于 1 或大于 100000。

  架构的版本号。

字段

• SchemaArn – UTF-8 字符串，长度不少于 1 个字节或超过 10240 个字节，与 Custom string pattern #22 匹配。

  架构的 Amazon Resource Name（ARN）。必须提供 SchemaArn 或 SchemaName 中的一个。

• SchemaName – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Custom string pattern #18 匹配。

  架构的名称。必须提供 SchemaArn 或 SchemaName 中的一个。

• RegistryName – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Custom string pattern #18 匹配。

  包含该架构的架构注册表的名称。

• CreateRegistry 操作（Python：create_registry）

• CreateSchema 操作（Python：create_schema）

• GetSchema 操作（Python：get_schema）

• ListSchemaVersions 操作（Python：list_schema _version）

• GetSchemaVersion 操作（Python：get_table_version）

• GetSchemaVersionsDiff 操作（Python：get_schema_versions_diff）

• ListRegistries 操作（Python：list_registries）

• ListSchemas 操作（Python：list_schema）

• RegisterSchemaVersion 操作（Python：register_schema_version）

• UpdateSchema 操作（Python：update_schema）

• CheckSchemaVersionValidity 操作（Python：check_schema_version_validity）

• UpdateRegistry 操作（Python：update_registry）

• GetSchemaByDefinition 操作（Python：get_schema_by_definition）

• GetRegistry 操作（Python：get_registry）

• PutSchemaVersionMetadata 操作（Python：put_schema_version_metadata）

• QuerySchemaVersionMetadata 操作（Python：query_schema_version_metadata）

• RemoveSchemaVersionMetadata 操作（Python：remove_schema_version_metadata）

• DeleteRegistry 操作（Python：delete_registry）

• DeleteSchema 操作（Python：delete_schema）

• DeleteSchemaVersions 操作（Python：delete_table_version）

请求

• RegistryName – 必填：UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Custom string pattern #18 匹配。

  要创建的注册表的名称，其最大长度不得超过 255 个字符，且只能包含字母、数字、连字符、下划线、美元符号或哈希标记。无空格。

• Description – 描述字符串，长度不超过 2048 个字节，与 URI address multi-line string pattern 匹配。

  注册表的描述。如果未提供描述，则不会有任何默认值。

• Tags – 键值对的映射数组，不超过 50 对。

  每个键都是一个 UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节。

  每个值是一个 UTF-8 字符串，不超过 256 个字节。

  AWS 标签，其中包含键值对，并可以通过控制台、命令行或 API 进行搜索。

响应

• RegistryArn – UTF-8 字符串，长度不少于 1 个字节或超过 10240 个字节，与 Custom string pattern #22 匹配。

  服务注册表的 Amazon Resource Name（ARN）。

• RegistryName – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Custom string pattern #18 匹配。

  注册表的名称。

• Description – 描述字符串，长度不超过 2048 个字节，与 URI address multi-line string pattern 匹配。

  注册表的描述。

• Tags – 键值对的映射数组，不超过 50 对。

  每个键都是一个 UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节。

  每个值是一个 UTF-8 字符串，不超过 256 个字节。

  注册表的标签。

错误

• InvalidInputException

• AccessDeniedException

• AlreadyExistsException

• ResourceNumberLimitExceededException

• ConcurrentModificationException

• InternalServiceException

请求

• RegistryId – 一个 RegistryId 对象。

  这是包含注册表标识字段的包装形状。如果未提供此选项，则会使用默认的注册表。相同的 ARN 格式为：arn:aws:glue:us-east-2:<customer id>:registry/default-registry:random-5-letter-id。

• SchemaName – 必填：UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Custom string pattern #18 匹配。

  要创建的架构的名称，其最大长度不得超过 255 个字符，且只能包含字母、数字、连字符、下划线、美元符号或哈希标记。无空格。

• DataFormat – 必填： UTF-8 字符串（有效值：AVRO | JSON | PROTOBUF）。

  架构定义的数据格式。目前支持 AVRO、JSON 和 PROTOBUF。

• Compatibility – UTF-8 字符串（有效值：NONE | DISABLED | BACKWARD | BACKWARD_ALL | FORWARD | FORWARD_ALL | FULL | FULL_ALL）。

  架构的兼容模式。可能的值包括：

  • NONE：不适用兼容模式。您可以在开发场景或者在不知道要应用于架构的兼容性模式时使用此选项。无需进行兼容性检查，接受添加的任何新版本。

  • DISABLED：此兼容性选项可防止对特定架构进行版本控制。您可以使用此选项来防止将来对架构进行版本控制。

  • BACKWARD：建议使用此兼容性选项，因为它允许数据接收器读取架构的最新版本和上一个版本。这意味着，例如，新架构版本不能删除数据字段或更改这些字段的类型，因此使用先前版本的读取器无法读取这些字段。

  • BACKWARD_ALL：此兼容性选项允许数据接收器读取架构的最新版本和所有先前版本。当您需要删除字段或添加可选字段以及检查所有先前架构版本的兼容性时，您可以使用此选项。

  • FORWARD：此兼容性选项允许数据接收器读取当前和下一个架构版本，但不一定是更高版本。当您需要添加字段或删除可选字段，但仅检查上一个架构版本的兼容性时，您可以使用此选项。

  • FORWARD_ALL：此兼容性选项允许数据接收器读取任何新的注册架构的创建器写入。当您需要添加字段或删除可选字段以及检查所有先前架构版本的兼容性时，您可以使用此选项。

  • FULL：此兼容性选项允许数据接收器读取使用先前版本或下一版本的架构，但不一定是早期版本或更高版本的创建器写入的数据。当您需要添加或删除可选字段，但仅检查上一个架构版本的兼容性时，您可以使用此选项。

  • FULL_ALL：此兼容性选项允许数据接收器读取使用所有架构先前版本的创建器写入的数据。当您需要添加或删除可选字段以及检查所有先前架构版本的兼容性时，您可以使用此选项。

• Description – 描述字符串，长度不超过 2048 个字节，与 URI address multi-line string pattern 匹配。

  架构的描述（可选）。如果未提供描述，则不会有自动任何默认值。

• Tags – 键值对的映射数组，不超过 50 对。

  每个键都是一个 UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节。

  每个值是一个 UTF-8 字符串，不超过 256 个字节。

  AWS 标签，其中包含键值对，并可以通过控制台、命令行或 API 进行搜索。如果指定，请遵循 AWS tags-on-create 模式。

• SchemaDefinition – UTF-8 字符串，长度不少于 1 个字节或超过 170000 个字节，与 Custom string pattern #33 匹配。

  使用 DataFormat 设置 SchemaName 的架构定义。

响应

• RegistryName – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Custom string pattern #18 匹配。

  注册表的名称。

• RegistryArn – UTF-8 字符串，长度不少于 1 个字节或超过 10240 个字节，与 Custom string pattern #22 匹配。

  注册表的 Amazon Resource Name（ARN）。

• SchemaName – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Custom string pattern #18 匹配。

  架构的名称。

• SchemaArn – UTF-8 字符串，长度不少于 1 个字节或超过 10240 个字节，与 Custom string pattern #22 匹配。

  架构的 Amazon Resource Name（ARN）。

• Description – 描述字符串，长度不超过 2048 个字节，与 URI address multi-line string pattern 匹配。

  对架构（如果在创建时指定）的描述。

• DataFormat – UTF-8 字符串（有效值：AVRO | JSON | PROTOBUF）。

  架构定义的数据格式。目前支持 AVRO、JSON 和 PROTOBUF。

• Compatibility – UTF-8 字符串（有效值：NONE | DISABLED | BACKWARD | BACKWARD_ALL | FORWARD | FORWARD_ALL | FULL | FULL_ALL）。

  架构的兼容模式。

• SchemaCheckpoint – 数字（长度），不小于 1 或大于 100000。

  检查点的版本号（上次更改兼容模式时）。

• LatestSchemaVersion – 数字（长度），不小于 1 或大于 100000。

  与返回的架构定义相关联的架构的最新版本。

• NextSchemaVersion – 数字（长度），不小于 1 或大于 100000。

  与返回的架构定义相关联的架构的下一个版本。

• SchemaStatus – UTF-8 字符串（有效值：AVAILABLE | PENDING | DELETING）。

  架构的状态。

• Tags – 键值对的映射数组，不超过 50 对。

  每个键都是一个 UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节。

  每个值是一个 UTF-8 字符串，不超过 256 个字节。

  架构的标签。

• SchemaVersionId – UTF-8 字符串，长度不少于 36 个字节或超过 36 个字节，与 Custom string pattern #17 匹配。

  第一个架构版本的唯一标识符。

• SchemaVersionStatus – UTF-8 字符串（有效值：AVAILABLE |PENDING | FAILURE | DELETING）。

  所创建的第一个架构版本的状态。

错误

• InvalidInputException

• AccessDeniedException

• EntityNotFoundException

• AlreadyExistsException

• ResourceNumberLimitExceededException

• ConcurrentModificationException

• InternalServiceException

请求

• SchemaId – 必填：一个 SchemaId 对象。

  包含架构标识字段的包装结构。结构包含：

  • SchemaId$SchemaArn：架构的 Amazon Resource Name（ARN） 必须提供 SchemaArn，或者 SchemaName 和 RegistryName。

  • SchemaId$SchemaName：架构的名称。必须提供 SchemaArn，或者 SchemaName 和 RegistryName。

响应

• RegistryName – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Custom string pattern #18 匹配。

  注册表的名称。

• RegistryArn – UTF-8 字符串，长度不少于 1 个字节或超过 10240 个字节，与 Custom string pattern #22 匹配。

  注册表的 Amazon Resource Name（ARN）。

• SchemaName – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Custom string pattern #18 匹配。

  架构的名称。

• SchemaArn – UTF-8 字符串，长度不少于 1 个字节或超过 10240 个字节，与 Custom string pattern #22 匹配。

  架构的 Amazon Resource Name（ARN）。

• Description – 描述字符串，长度不超过 2048 个字节，与 URI address multi-line string pattern 匹配。

  对架构（如果在创建时指定）的描述。

• DataFormat – UTF-8 字符串（有效值：AVRO | JSON | PROTOBUF）。

  架构定义的数据格式。目前支持 AVRO、JSON 和 PROTOBUF。

• Compatibility – UTF-8 字符串（有效值：NONE | DISABLED | BACKWARD | BACKWARD_ALL | FORWARD | FORWARD_ALL | FULL | FULL_ALL）。

  架构的兼容模式。

• SchemaCheckpoint – 数字（长度），不小于 1 或大于 100000。

  检查点的版本号（上次更改兼容模式时）。

• LatestSchemaVersion – 数字（长度），不小于 1 或大于 100000。

  与返回的架构定义相关联的架构的最新版本。

• NextSchemaVersion – 数字（长度），不小于 1 或大于 100000。

  与返回的架构定义相关联的架构的下一个版本。

• SchemaStatus – UTF-8 字符串（有效值：AVAILABLE | PENDING | DELETING）。

  架构的状态。

• CreatedTime – UTF-8 字符串。

  架构的创建日期和时间。

• UpdatedTime – UTF-8 字符串。

  架构的更新日期和时间。

错误

• InvalidInputException

• AccessDeniedException

• EntityNotFoundException

• InternalServiceException

请求

• SchemaId – 必填：一个 SchemaId 对象。

  包含架构标识字段的包装结构。结构包含：

  • SchemaId$SchemaArn：架构的 Amazon Resource Name（ARN） 必须提供 SchemaArn，或者 SchemaName 和 RegistryName。

  • SchemaId$SchemaName：架构的名称。必须提供 SchemaArn，或者 SchemaName 和 RegistryName。

• MaxResults – 数字（整数），不小于 1 或大于 100。

  每页所需的最大结果数量。如果未提供该值，则每页默认最大数量为 25。

• NextToken – UTF-8 字符串。

  延续标记 (如果这是延续调用)。

响应

• Schemas – SchemaVersionListItem 对象的数组。

  SchemaVersionList 对象的数组，包含每个架构版本的详细信息。

• NextToken – UTF-8 字符串。

  对返回的标记列表进行分页的延续令牌 (如果列表的当前片段不是最后一个，则返回)。

错误

• InvalidInputException

• AccessDeniedException

• EntityNotFoundException

• InternalServiceException

请求

• SchemaId – 一个 SchemaId 对象。

  包含架构标识字段的包装结构。结构包含：

  • SchemaId$SchemaArn：架构的 Amazon Resource Name（ARN） 必须提供 SchemaArn，或者 SchemaName 和 RegistryName。

  • SchemaId$SchemaName：架构的名称。必须提供 SchemaArn，或者 SchemaName 和 RegistryName。

• SchemaVersionId – UTF-8 字符串，长度不少于 36 个字节或超过 36 个字节，与 Custom string pattern #17 匹配。

  架构版本的 SchemaVersionId。此字段是按架构 ID 进行读取的必填字段。必须提供此字段或 SchemaId 包装。

• SchemaVersionNumber – 一个 SchemaVersionNumber 对象。

  架构的版本号。

响应

• SchemaVersionId – UTF-8 字符串，长度不少于 36 个字节或超过 36 个字节，与 Custom string pattern #17 匹配。

  架构版本的 SchemaVersionId。

• SchemaDefinition – UTF-8 字符串，长度不少于 1 个字节或超过 170000 个字节，与 Custom string pattern #33 匹配。

  架构 ID 的架构定义。

• DataFormat – UTF-8 字符串（有效值：AVRO | JSON | PROTOBUF）。

  架构定义的数据格式。目前支持 AVRO、JSON 和 PROTOBUF。

• SchemaArn – UTF-8 字符串，长度不少于 1 个字节或超过 10240 个字节，与 Custom string pattern #22 匹配。

  架构的 Amazon Resource Name（ARN）。

• VersionNumber – 数字（长度），不小于 1 或大于 100000。

  架构的版本号。

• Status – UTF-8 字符串（有效值：AVAILABLE |PENDING | FAILURE | DELETING）。

  架构版本的状态。

• CreatedTime – UTF-8 字符串。

  此架构版本的创建日期和时间。

错误

• InvalidInputException

• AccessDeniedException

• EntityNotFoundException

• InternalServiceException

请求

• SchemaId – 必填：一个 SchemaId 对象。

  包含架构标识字段的包装结构。结构包含：

  • SchemaId$SchemaArn：架构的 Amazon Resource Name（ARN） 必须提供 SchemaArn 或 SchemaName 中的一个。

  • SchemaId$SchemaName：架构的名称。必须提供 SchemaArn 或 SchemaName 中的一个。

• FirstSchemaVersionNumber – 必填：一个 SchemaVersionNumber 对象。

  要比较的两个架构版本中的第一个版本。

• SecondSchemaVersionNumber – 必填：一个 SchemaVersionNumber 对象。

  要比较的两个架构版本中的第二个版本。

• SchemaDiffType – 必填：UTF-8 字符串（有效值：SYNTAX_DIFF）。

  指的是 SYNTAX_DIFF，这是当前支持的差异类型。

响应

• Diff – UTF-8 字符串，长度不少于 1 个字节或超过 340000 个字节，与 Custom string pattern #33 匹配。

  架构之间的差异以字符串的形式在 JSONPatch 格式中输出。

错误

• InvalidInputException

• EntityNotFoundException

• AccessDeniedException

• InternalServiceException

请求

• MaxResults – 数字（整数），不小于 1 或大于 100。

  每页所需的最大结果数量。如果未提供该值，则每页默认最大数量为 25。

• NextToken – UTF-8 字符串。

  延续标记 (如果这是延续调用)。

响应

• Registries – RegistryListItem 对象的数组。

  RegistryDetailedListItem 对象的数组，其中包含每个注册表的最少详细信息。

• NextToken – UTF-8 字符串。

  对返回的标记列表进行分页的延续令牌 (如果列表的当前片段不是最后一个，则返回)。

错误

• InvalidInputException

• AccessDeniedException

• InternalServiceException

请求

• RegistryId – 一个 RegistryId 对象。

  包装结构，包含注册表名称和 Amazon Resource Name（ARN）。

• MaxResults – 数字（整数），不小于 1 或大于 100。

  每页所需的最大结果数量。如果未提供该值，则每页默认最大数量为 25。

• NextToken – UTF-8 字符串。

  延续标记 (如果这是延续调用)。

响应

• Schemas – SchemaListItem 对象的数组。

  SchemaListItem 对象数组，包含每个架构的详细信息。

• NextToken – UTF-8 字符串。

  对返回的标记列表进行分页的延续令牌 (如果列表的当前片段不是最后一个，则返回)。

错误

• InvalidInputException

• AccessDeniedException

• EntityNotFoundException

• InternalServiceException

请求

• SchemaId – 必填：一个 SchemaId 对象。

  包含架构标识字段的包装结构。结构包含：

  • SchemaId$SchemaArn：架构的 Amazon Resource Name（ARN） 必须提供 SchemaArn，或者 SchemaName 和 RegistryName。

  • SchemaId$SchemaName：架构的名称。必须提供 SchemaArn，或者 SchemaName 和 RegistryName。

• SchemaDefinition – 必填：UTF-8 字符串，长度不少于 1 个字节或超过 170000 个字节，与 Custom string pattern #33 匹配。

  使用 DataFormat 设置 SchemaName 的架构定义。

响应

• SchemaVersionId – UTF-8 字符串，长度不少于 36 个字节或超过 36 个字节，与 Custom string pattern #17 匹配。

  表示此架构版本的唯一 ID。

• VersionNumber – 数字（长度），不小于 1 或大于 100000。

  此架构的版本（仅适用于同步流，以防这是第一个版本）。

• Status – UTF-8 字符串（有效值：AVAILABLE |PENDING | FAILURE | DELETING）。

  架构版本的状态。

错误

• InvalidInputException

• AccessDeniedException

• EntityNotFoundException

• ResourceNumberLimitExceededException

• ConcurrentModificationException

• InternalServiceException

请求

• SchemaId – 必填：一个 SchemaId 对象。

  包含架构标识字段的包装结构。结构包含：

  • SchemaId$SchemaArn：架构的 Amazon Resource Name（ARN） 必须提供 SchemaArn 或 SchemaName 中的一个。

  • SchemaId$SchemaName：架构的名称。必须提供 SchemaArn 或 SchemaName 中的一个。

• SchemaVersionNumber – 一个 SchemaVersionNumber 对象。

  通过检查点检验所需的版本号。必须提供 VersionNumber 或 Compatibility 中的一个。

• Compatibility – UTF-8 字符串（有效值：NONE | DISABLED | BACKWARD | BACKWARD_ALL | FORWARD | FORWARD_ALL | FULL | FULL_ALL）。

  架构的新兼容性设置。

• Description – 描述字符串，长度不超过 2048 个字节，与 URI address multi-line string pattern 匹配。

  架构的新描述。

响应

• SchemaArn – UTF-8 字符串，长度不少于 1 个字节或超过 10240 个字节，与 Custom string pattern #22 匹配。

  架构的 Amazon Resource Name（ARN）。

• SchemaName – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Custom string pattern #18 匹配。

  架构的名称。

• RegistryName – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Custom string pattern #18 匹配。

  包含该架构的注册表的名称。

错误

• InvalidInputException

• AccessDeniedException

• EntityNotFoundException

• ConcurrentModificationException

• InternalServiceException

请求

• DataFormat – 必填： UTF-8 字符串（有效值：AVRO | JSON | PROTOBUF）。

  架构定义的数据格式。目前支持 AVRO、JSON 和 PROTOBUF。

• SchemaDefinition – 必填：UTF-8 字符串，长度不少于 1 个字节或超过 170000 个字节，与 Custom string pattern #33 匹配。

  必须验证的架构的定义。

响应

• Valid – 布尔值。

  如果模式有效，则返回“true”，否则返回“false”。

• Error – UTF-8 字符串，长度不少于 1 个字节或超过 5000 个字节。

  验证失败错误消息。

错误

• InvalidInputException

• AccessDeniedException

• InternalServiceException

请求

• RegistryId – 必填：一个 RegistryId 对象。

  这是包装结构，包含注册表名称和 Amazon Resource Name（ARN）。

• Description – 必填：描述字符串，长度不超过 2048 个字节，与 URI address multi-line string pattern 匹配。

  注册表的描述。如果未提供描述，则不会更新此字段。

响应

• RegistryName – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Custom string pattern #18 匹配。

  更新的注册表的名称。

• RegistryArn – UTF-8 字符串，长度不少于 1 个字节或超过 10240 个字节，与 Custom string pattern #22 匹配。

  更新的注册表的 Amazon Resource name（ARN）。

错误

• InvalidInputException

• AccessDeniedException

• EntityNotFoundException

• ConcurrentModificationException

• InternalServiceException

请求

• SchemaId – 必填：一个 SchemaId 对象。

  包含架构标识字段的包装结构。结构包含：

  • SchemaId$SchemaArn：架构的 Amazon Resource Name（ARN） 必须提供 SchemaArn 或 SchemaName 中的一个。

  • SchemaId$SchemaName：架构的名称。必须提供 SchemaArn 或 SchemaName 中的一个。

• SchemaDefinition – 必填：UTF-8 字符串，长度不少于 1 个字节或超过 170000 个字节，与 Custom string pattern #33 匹配。

  需要架构详细信息的架构的定义。

响应

• SchemaVersionId – UTF-8 字符串，长度不少于 36 个字节或超过 36 个字节，与 Custom string pattern #17 匹配。

  架构版本的架构 ID。

• SchemaArn – UTF-8 字符串，长度不少于 1 个字节或超过 10240 个字节，与 Custom string pattern #22 匹配。

  架构的 Amazon Resource Name（ARN）。

• DataFormat – UTF-8 字符串（有效值：AVRO | JSON | PROTOBUF）。

  架构定义的数据格式。目前支持 AVRO、JSON 和 PROTOBUF。

• Status – UTF-8 字符串（有效值：AVAILABLE |PENDING | FAILURE | DELETING）。

  架构版本的状态。

• CreatedTime – UTF-8 字符串。

  架构的创建日期和时间。

错误

• InvalidInputException

• AccessDeniedException

• EntityNotFoundException

• InternalServiceException

请求

• RegistryId – 必填：一个 RegistryId 对象。

  这是包装结构，包含注册表名称和 Amazon Resource Name（ARN）。

响应

• RegistryName – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Custom string pattern #18 匹配。

  注册表的名称。

• RegistryArn – UTF-8 字符串，长度不少于 1 个字节或超过 10240 个字节，与 Custom string pattern #22 匹配。

  注册表的 Amazon Resource Name（ARN）。

• Description – 描述字符串，长度不超过 2048 个字节，与 URI address multi-line string pattern 匹配。

  注册表的描述。

• Status – UTF-8 字符串（有效值：AVAILABLE | DELETING）。

  注册表的状态。

• CreatedTime – UTF-8 字符串。

  注册表的创建日期和时间。

• UpdatedTime – UTF-8 字符串。

  注册表的更新日期和时间。

错误

• InvalidInputException

• AccessDeniedException

• EntityNotFoundException

• InternalServiceException

请求

• SchemaId – 一个 SchemaId 对象。

  架构的唯一 ID。

• SchemaVersionNumber – 一个 SchemaVersionNumber 对象。

  架构的版本号。

• SchemaVersionId – UTF-8 字符串，长度不少于 36 个字节或超过 36 个字节，与 Custom string pattern #17 匹配。

  架构版本的唯一版本 ID。

• MetadataKeyValue – 必填：一个 MetadataKeyValuePair 对象。

  元数据键的相应值。

响应

• SchemaArn – UTF-8 字符串，长度不少于 1 个字节或超过 10240 个字节，与 Custom string pattern #22 匹配。

  架构的 Amazon Resource Name（ARN）。

• SchemaName – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Custom string pattern #18 匹配。

  架构的名称。

• RegistryName – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Custom string pattern #18 匹配。

  注册表的名称。

• LatestVersion – 布尔值。

  架构的最新版本。

• VersionNumber – 数字（长度），不小于 1 或大于 100000。

  架构的版本号。

• SchemaVersionId – UTF-8 字符串，长度不少于 36 个字节或超过 36 个字节，与 Custom string pattern #17 匹配。

  架构版本的唯一版本 ID。

• MetadataKey – UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节，与 Custom string pattern #34 匹配。

  元数据键。

• MetadataValue – UTF-8 字符串，长度不少于 1 个字节或超过 256 个字节，与 Custom string pattern #34 匹配。

  元数据键的值。

错误

• InvalidInputException

• AccessDeniedException

• AlreadyExistsException

• EntityNotFoundException

• ResourceNumberLimitExceededException

请求

• SchemaId – 一个 SchemaId 对象。

  包装结构，包含架构名称和 Amazon Resource Name（ARN）。

• SchemaVersionNumber – 一个 SchemaVersionNumber 对象。

  架构的版本号。

• SchemaVersionId – UTF-8 字符串，长度不少于 36 个字节或超过 36 个字节，与 Custom string pattern #17 匹配。

  架构版本的唯一版本 ID。

• MetadataList – MetadataKeyValuePair 对象的数组。

  搜索元数据的键值对，如果未提供键值对，则将获取所有元数据信息。

• MaxResults – 数字（整数），不小于 1 或大于 50。

  每页所需的最大结果数量。如果未提供该值，则每页默认最大数量为 25。

• NextToken – UTF-8 字符串。

  延续标记 (如果这是延续调用)。

响应

• MetadataInfoMap – 键值对的映射数组。

  每个键是一个 UTF-8 字符串，不少于 1 个字节或超过 128 个字节，与 Custom string pattern #34 匹配。

  每个值都是一个 MetadataInfo 对象。

  元数据键和关联值的映射。

• SchemaVersionId – UTF-8 字符串，长度不少于 36 个字节或超过 36 个字节，与 Custom string pattern #17 匹配。

  架构版本的唯一版本 ID。

• NextToken – UTF-8 字符串。

  对返回的标记列表进行分页的延续令牌 (如果列表的当前片段不是最后一个，则返回)。

错误

• InvalidInputException

• AccessDeniedException

• EntityNotFoundException

请求

• SchemaId – 一个 SchemaId 对象。

  包装结构，包含架构名称和 Amazon Resource Name（ARN）。

• SchemaVersionNumber – 一个 SchemaVersionNumber 对象。

  架构的版本号。

• SchemaVersionId – UTF-8 字符串，长度不少于 36 个字节或超过 36 个字节，与 Custom string pattern #17 匹配。

  架构版本的唯一版本 ID。

• MetadataKeyValue – 必填：一个 MetadataKeyValuePair 对象。

  元数据键的值。

响应

• SchemaArn – UTF-8 字符串，长度不少于 1 个字节或超过 10240 个字节，与 Custom string pattern #22 匹配。

  架构的 Amazon Resource Name（ARN）。

• SchemaName – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Custom string pattern #18 匹配。

  架构的名称。

• RegistryName – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Custom string pattern #18 匹配。

  注册表的名称。

• LatestVersion – 布尔值。

  架构的最新版本。

• VersionNumber – 数字（长度），不小于 1 或大于 100000。

  架构的版本号。

• SchemaVersionId – UTF-8 字符串，长度不少于 36 个字节或超过 36 个字节，与 Custom string pattern #17 匹配。

  架构版本的版本 ID。

• MetadataKey – UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节，与 Custom string pattern #34 匹配。

  元数据键。

• MetadataValue – UTF-8 字符串，长度不少于 1 个字节或超过 256 个字节，与 Custom string pattern #34 匹配。

  元数据键的值。

错误

• InvalidInputException

• AccessDeniedException

• EntityNotFoundException

请求

• RegistryId – 必填：一个 RegistryId 对象。

  这是包装结构，包含注册表名称和 Amazon Resource Name（ARN）。

响应

• RegistryName – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Custom string pattern #18 匹配。

  正在删除的注册表的名称。

• RegistryArn – UTF-8 字符串，长度不少于 1 个字节或超过 10240 个字节，与 Custom string pattern #22 匹配。

  服务注册表的 Amazon Resource Name（ARN）。

• Status – UTF-8 字符串（有效值：AVAILABLE | DELETING）。

  注册表的状态。成功的操作将返回 Deleting 状态。

错误

• InvalidInputException

• EntityNotFoundException

• AccessDeniedException

• ConcurrentModificationException

请求

• SchemaId – 必填：一个 SchemaId 对象。

  这是包装结构，包含架构名称和 Amazon Resource Name（ARN）。

响应

• SchemaArn – UTF-8 字符串，长度不少于 1 个字节或超过 10240 个字节，与 Custom string pattern #22 匹配。

  要删除的架构的 Amazon Resource Name（ARN）。

• SchemaName – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Custom string pattern #18 匹配。

  正在删除的架构的名称。

• Status – UTF-8 字符串（有效值：AVAILABLE | PENDING | DELETING）。

  架构的状态。

错误

• InvalidInputException

• EntityNotFoundException

• AccessDeniedException

• ConcurrentModificationException

请求

• SchemaId – 必填：一个 SchemaId 对象。

  这是包装结构，包含架构名称和 Amazon Resource Name（ARN）。

• Versions – 必填：UTF-8 字符串，长度不少于 1 个字节或超过 100000 个字节，与 Custom string pattern #35 匹配。

  可以提供一个版本范围，其格式可能为：

  • 单个版本号，5

  • 一个范围，5-8：删除版本 5、6、7、8

响应

• SchemaVersionErrors – SchemaVersionErrorItem 对象的数组。

  SchemaVersionErrorItem 对象列表，每个对象都包含错误和架构版本。

错误

• InvalidInputException

• EntityNotFoundException

• AccessDeniedException

• ConcurrentModificationException