Schema Registry - AWS Glue

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Schema Registry

스키마 레지스트리 API는 AWS Glue에서의 스키마 작업과 관련된 API 및 데이터 유형에 대해 설명합니다.

데이터 타입

RegistryId 구조

레지스트리 이름과 Amazon 리소스 이름(ARN)을 포함할 수 있는 래퍼 구조입니다.

필드
  • RegistryNameCustom string pattern #18과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    레지스트리의 이름입니다. 조회에만 사용됩니다. RegistryArn 또는 RegistryName 중 하나가 제공되어야 합니다.

  • RegistryArnCustom string pattern #22과(와) 일치하는 1~10,240바이트 길이의 UTF-8 문자열입니다.

    업데이트할 레지스트리의 ARN입니다. RegistryArn 또는 RegistryName 중 하나가 제공되어야 합니다.

RegistryListItem 구조

레지스트리에 대한 세부 정보를 포함하는 구조입니다.

필드
  • RegistryNameCustom string pattern #18과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    레지스트리의 이름입니다.

  • RegistryArnCustom string pattern #22과(와) 일치하는 1~10,240바이트 길이의 UTF-8 문자열입니다.

    레지스트리의 Amazon 리소스 이름(ARN)입니다.

  • DescriptionURI address multi-line string pattern과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

    레지스트리에 대한 설명입니다.

  • Status – UTF-8 문자열입니다(유효한 값: AVAILABLE | DELETING).

    레지스트리의 상태입니다.

  • CreatedTime – UTF-8 문자열입니다.

    레지스트리가 생성된 데이터입니다.

  • UpdatedTime – UTF-8 문자열입니다.

    레지스트리가 업데이트된 날짜입니다.

MetadataInfo 구조

스키마 버전에 대한 메타데이터 정보를 포함하는 구조입니다.

필드
  • MetadataValueCustom string pattern #34과(와) 일치하는 1~256바이트 길이의 UTF-8 문자열입니다.

    메타데이터 키의 해당하는 값입니다.

  • CreatedTime – UTF-8 문자열입니다.

    항목이 생성된 시간입니다.

  • OtherMetadataValueListOtherMetadataValueListItem 객체의 배열입니다.

    동일한 메타데이터 키에 속하는 다른 메타데이터입니다.

OtherMetadataValueListItem 구조

동일한 메타데이터 키에 속하는 스키마 버전에 대한 다른 메타데이터를 포함하는 구조입니다.

필드
  • MetadataValueCustom string pattern #34과(와) 일치하는 1~256바이트 길이의 UTF-8 문자열입니다.

    동일한 메타데이터 키에 속하는 스키마 버전에 대한 다른 메타데이터를 포함하는 구조입니다.

  • CreatedTime – UTF-8 문자열입니다.

    항목이 생성된 시간입니다.

SchemaListItem 구조

스키마에 대한 최소한의 세부 정보를 포함하는 객체입니다.

필드
  • RegistryNameCustom string pattern #18과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    스키마가 있는 레지스트리의 이름입니다.

  • SchemaNameCustom string pattern #18과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    스키마의 이름입니다.

  • SchemaArnCustom string pattern #22과(와) 일치하는 1~10,240바이트 길이의 UTF-8 문자열입니다.

    스키마의 Amazon 리소스 이름(ARN)입니다.

  • DescriptionURI address multi-line string pattern과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

    스키마에 대한 설명입니다.

  • SchemaStatus – UTF-8 문자열입니다(유효한 값: AVAILABLE | PENDING | DELETING).

    스키마의 상태입니다.

  • CreatedTime – UTF-8 문자열입니다.

    스키마가 생성된 날짜 및 시간입니다.

  • UpdatedTime – UTF-8 문자열입니다.

    스키마가 업데이트된 날짜 및 시간입니다.

SchemaVersionListItem 구조

스키마 버전에 대한 세부 정보를 포함하는 객체입니다.

필드
  • SchemaArnCustom string pattern #22과(와) 일치하는 1~10,240바이트 길이의 UTF-8 문자열입니다.

    스키마의 Amazon 리소스 이름(ARN).

  • SchemaVersionIdCustom string pattern #17과(와) 일치하는 36바이트 이상 길이의 UTF-8 문자열입니다.

    스키마 버전의 고유한 식별자입니다.

  • VersionNumber - 1~100,000의 숫자(정수)입니다.

    스키마의 버전 번호입니다.

  • Status – UTF-8 문자열입니다(유효한 값: AVAILABLE | PENDING | FAILURE | DELETING).

    스키마 버전의 상태입니다.

  • CreatedTime – UTF-8 문자열입니다.

    스키마 버전이 생성된 날짜 및 시간입니다.

MetadataKeyValuePair 구조

메타데이터에 대한 키 값 페어를 포함하는 구조입니다.

필드
  • MetadataKeyCustom string pattern #34과(와) 일치하는 1~128바이트 길이의 UTF-8 문자열입니다.

    메타데이터 키입니다.

  • MetadataValueCustom string pattern #34과(와) 일치하는 1~256바이트 길이의 UTF-8 문자열입니다.

    메타데이터 키의 해당하는 값입니다.

SchemaVersionErrorItem 구조

스키마 버전에 대한 작업에 대한 오류 세부 정보가 포함된 객체입니다.

필드
  • VersionNumber - 1~100,000의 숫자(정수)입니다.

    스키마의 버전 번호입니다.

  • ErrorDetailsErrorDetails 객체입니다.

    스키마 버전에 대한 오류 세부 정보입니다.

ErrorDetails 구조

오류 세부 정보가 포함된 객체입니다.

필드
  • ErrorCode – UTF-8 문자열입니다.

    오류에 대한 오류 코드입니다.

  • ErrorMessage – UTF-8 문자열입니다.

    오류에 대한 오류 메시지입니다.

SchemaVersionNumber 구조

스키마 버전 정보를 포함하는 구조입니다.

필드
  • LatestVersion – 부울입니다.

    스키마에 사용할 수 있는 최신 버전입니다.

  • VersionNumber - 1~100,000의 숫자(정수)입니다.

    스키마의 버전 번호입니다.

SchemaId 구조

AWS Glue 스키마 레지스트리에 있는 스키마의 고유 ID입니다.

필드
  • SchemaArnCustom string pattern #22과(와) 일치하는 1~10,240바이트 길이의 UTF-8 문자열입니다.

    스키마의 Amazon 리소스 이름(ARN). SchemaArn 또는 SchemaName 중 하나가 제공되어야 합니다.

  • SchemaNameCustom string pattern #18과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    스키마의 이름입니다. SchemaArn 또는 SchemaName 중 하나가 제공되어야 합니다.

  • RegistryNameCustom string pattern #18과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    해당 스키마가 포함된 스키마 레지스트리의 이름입니다.

운영

CreateRegistry 작업(Python: create_registry)

스키마 컬렉션을 보유하는 데 사용할 수 있는 새 레지스트리를 생성합니다.

요청
  • RegistryName필수(Required): Custom string pattern #18과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    레지스트리 이름은 최대 255자이며 문자, 숫자, 하이픈, 밑줄, 달러 기호 또는 해시 표시만 포함할 수 있습니다. 공백은 없습니다.

  • DescriptionURI address multi-line string pattern과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

    레지스트리에 대한 설명입니다. 설명이 제공되지 않으면 이에 대한 기본값이 없습니다.

  • Tags – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

    각 키는 길이가 1~128바이트인 UTF-8 문자열입니다.

    각 값은 256 바이트 이하 길이의 UTF-8 문자열입니다.

    키 값 페어가 포함된 AWS 태그이며 콘솔, 명령줄 또는 API로 검색할 수 있습니다.

응답
  • RegistryArnCustom string pattern #22과(와) 일치하는 1~10,240바이트 길이의 UTF-8 문자열입니다.

    새로 생성된 레지스트리의 Amazon 리소스 이름(ARN)입니다.

  • RegistryNameCustom string pattern #18과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    레지스트리의 이름입니다.

  • DescriptionURI address multi-line string pattern과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

    레지스트리에 대한 설명입니다.

  • Tags – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

    각 키는 길이가 1~128바이트인 UTF-8 문자열입니다.

    각 값은 256 바이트 이하 길이의 UTF-8 문자열입니다.

    레지스트리에 대한 태그입니다.

Errors
  • InvalidInputException

  • AccessDeniedException

  • AlreadyExistsException

  • ResourceNumberLimitExceededException

  • ConcurrentModificationException

  • InternalServiceException

CreateSchema 작업(Python: create_schema)

새 스키마 집합을 생성하고 스키마 정의를 등록합니다. 실제로 버전을 등록하지 않고 스키마 집합이 이미 존재하는 경우 오류를 반환합니다.

스키마 집합이 생성되면 버전 체크포인트가 첫 번째 버전으로 설정됩니다. 호환성 모드 "DISABLED"는 첫 번째 스키마 버전 이후에 추가되는 모든 추가 스키마 버전을 제한합니다. 다른 모든 호환성 모드의 경우 호환성 설정의 검증은 RegisterSchemaVersion API를 사용할 때 두 번째 버전부터만 적용됩니다.

이 API가 RegistryId 없이 호출되면 레지스트리 데이터베이스 테이블에 "default-registry" 항목이 생성됩니다(아직 없는 경우).

요청
  • RegistryIdRegistryId 객체입니다.

    이것은 레지스트리 자격 증명 필드를 포함하는 래퍼 셰이프입니다. 제공되지 않으면 기본 레지스트리가 사용됩니다. 동일한 ARN 포맷은 arn:aws:glue:us-east-2:<customer id>:registry/default-registry:random-5-letter-id입니다.

  • SchemaName필수(Required): Custom string pattern #18과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    스키마 이름은 최대 255자이며 문자, 숫자, 하이픈, 밑줄, 달러 기호 또는 해시 표시만 포함할 수 있습니다. 공백은 없습니다.

  • DataFormat필수: UTF-8 문자열입니다(유효한 값: AVRO | JSON | PROTOBUF).

    스키마 정의의 데이터 형식입니다. 현재 AVRO, JSONPROTOBUF가 지원됩니다.

  • 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: 이 호환성 선택을 통해 데이터 수신자는 모든 이전 스키마 버전을 사용하여 생산자가 작성한 데이터를 읽을 수 있습니다. 선택적 필드를 추가 또는 제거하고 모든 이전 스키마 버전과의 호환성을 확인해야 할 때 이 선택 사항을 사용할 수 있습니다.

  • DescriptionURI address multi-line string pattern과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

    스키마에 대한 설명입니다(선택 사항). 설명이 제공되지 않으면 이에 대한 자동 기본값이 없습니다.

  • Tags – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

    각 키는 길이가 1~128바이트인 UTF-8 문자열입니다.

    각 값은 256 바이트 이하 길이의 UTF-8 문자열입니다.

    키 값 페어가 포함된 AWS 태그이며 콘솔, 명령줄 또는 API로 검색할 수 있습니다. 지정된 경우AWS tags-on-create 패턴을 따릅니다.

  • SchemaDefinitionCustom string pattern #33과(와) 일치하는 1~170,000바이트 길이의 UTF-8 문자열입니다.

    SchemaName에 대해 DataFormat 설정을 사용하는 스키마 정의입니다.

응답
  • RegistryNameCustom string pattern #18과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    레지스트리의 이름입니다.

  • RegistryArnCustom string pattern #22과(와) 일치하는 1~10,240바이트 길이의 UTF-8 문자열입니다.

    레지스트리의 Amazon 리소스 이름(ARN)입니다.

  • SchemaNameCustom string pattern #18과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    스키마의 이름입니다.

  • SchemaArnCustom string pattern #22과(와) 일치하는 1~10,240바이트 길이의 UTF-8 문자열입니다.

    스키마의 Amazon 리소스 이름(ARN).

  • DescriptionURI address multi-line string pattern과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

    스키마에 대한 설명입니다(생성 시 지정한 경우).

  • DataFormat – UTF-8 문자열입니다(유효한 값: AVRO | JSON | PROTOBUF).

    스키마 정의의 데이터 형식입니다. 현재 AVRO, JSONPROTOBUF가 지원됩니다.

  • Compatibility – UTF-8 문자열입니다(유효한 값: NONE | DISABLED | BACKWARD | BACKWARD_ALL | FORWARD | FORWARD_ALL | FULL | FULL_ALL).

    스키마 호환성 모드입니다.

  • SchemaCheckpoint - 1~100,000의 숫자(정수)입니다.

    체크포인트의 버전 번호(호환성 모드가 마지막으로 변경된 시간)입니다.

  • LatestSchemaVersion - 1~100,000의 숫자(정수)입니다.

    반환된 스키마 정의와 연결된 스키마의 최신 버전입니다.

  • NextSchemaVersion - 1~100,000의 숫자(정수)입니다.

    반환된 스키마 정의와 연결된 스키마의 다음 버전입니다.

  • SchemaStatus – UTF-8 문자열입니다(유효한 값: AVAILABLE | PENDING | DELETING).

    스키마의 상태입니다.

  • Tags – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

    각 키는 길이가 1~128바이트인 UTF-8 문자열입니다.

    각 값은 256 바이트 이하 길이의 UTF-8 문자열입니다.

    스키마의 태그입니다.

  • SchemaVersionIdCustom string pattern #17과(와) 일치하는 36바이트 이상 길이의 UTF-8 문자열입니다.

    첫 번째 스키마 버전의 고유 식별자입니다.

  • SchemaVersionStatus – UTF-8 문자열입니다(유효한 값: AVAILABLE | PENDING | FAILURE | DELETING).

    생성된 첫 번째 스키마 버전의 상태입니다.

Errors
  • InvalidInputException

  • AccessDeniedException

  • EntityNotFoundException

  • AlreadyExistsException

  • ResourceNumberLimitExceededException

  • ConcurrentModificationException

  • InternalServiceException

GetSchema 작업(Python: get_schema)

지정된 스키마를 자세히 설명합니다.

요청
  • SchemaId필수(Required): SchemaId 객체입니다.

    스키마 자격 증명 필드를 포함하는 래퍼 구조입니다. 구조에는 다음이 포함됩니다.

    • SchemaId$SchemaArn: 스키마의 Amazon 리소스 이름(ARN)입니다. SchemaArn 또는 SchemaNameRegistryName이 제공되어야 합니다.

    • SchemaId$SchemaName: 스키마의 이름입니다. SchemaArn 또는 SchemaNameRegistryName이 제공되어야 합니다.

응답
  • RegistryNameCustom string pattern #18과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    레지스트리의 이름입니다.

  • RegistryArnCustom string pattern #22과(와) 일치하는 1~10,240바이트 길이의 UTF-8 문자열입니다.

    레지스트리의 Amazon 리소스 이름(ARN)입니다.

  • SchemaNameCustom string pattern #18과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    스키마의 이름입니다.

  • SchemaArnCustom string pattern #22과(와) 일치하는 1~10,240바이트 길이의 UTF-8 문자열입니다.

    스키마의 Amazon 리소스 이름(ARN).

  • DescriptionURI address multi-line string pattern과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

    스키마에 대한 설명입니다(생성 시 지정한 경우).

  • DataFormat – UTF-8 문자열입니다(유효한 값: AVRO | JSON | PROTOBUF).

    스키마 정의의 데이터 형식입니다. 현재 AVRO, JSONPROTOBUF가 지원됩니다.

  • Compatibility – UTF-8 문자열입니다(유효한 값: NONE | DISABLED | BACKWARD | BACKWARD_ALL | FORWARD | FORWARD_ALL | FULL | FULL_ALL).

    스키마의 호환성 모드입니다.

  • SchemaCheckpoint - 1~100,000의 숫자(정수)입니다.

    체크포인트의 버전 번호(호환성 모드가 마지막으로 변경된 시간)입니다.

  • LatestSchemaVersion - 1~100,000의 숫자(정수)입니다.

    반환된 스키마 정의와 연결된 스키마의 최신 버전입니다.

  • NextSchemaVersion - 1~100,000의 숫자(정수)입니다.

    반환된 스키마 정의와 연결된 스키마의 다음 버전입니다.

  • SchemaStatus – UTF-8 문자열입니다(유효한 값: AVAILABLE | PENDING | DELETING).

    스키마의 상태입니다.

  • CreatedTime – UTF-8 문자열입니다.

    스키마가 생성된 날짜 및 시간입니다.

  • UpdatedTime – UTF-8 문자열입니다.

    스키마가 업데이트된 날짜 및 시간입니다.

Errors
  • InvalidInputException

  • AccessDeniedException

  • EntityNotFoundException

  • InternalServiceException

ListSchemaVersions 작업(Python: list_schema_versions)

최소한의 정보로 생성한 스키마 버전 목록을 반환합니다. [삭제됨(Deleted)] 상태의 스키마 버전은 결과에 포함되지 않습니다. 사용 가능한 스키마 버전이 없으면 빈 결과가 반환됩니다.

요청
  • SchemaId필수(Required): SchemaId 객체입니다.

    스키마 자격 증명 필드를 포함하는 래퍼 구조입니다. 구조에는 다음이 포함됩니다.

    • SchemaId$SchemaArn: 스키마의 Amazon 리소스 이름(ARN)입니다. SchemaArn 또는 SchemaNameRegistryName이 제공되어야 합니다.

    • SchemaId$SchemaName: 스키마의 이름입니다. SchemaArn 또는 SchemaNameRegistryName이 제공되어야 합니다.

  • MaxResults – 1~100의 숫자(정수)입니다.

    페이지당 필요한 최대 결과 수입니다. 값이 제공되지 않으면 페이지당 기본값이 25로 설정됩니다.

  • NextToken – UTF-8 문자열입니다.

    이것이 지속적으로 호출되면 지속적인 토큰입니다.

응답
  • SchemasSchemaVersionListItem 객체의 배열입니다.

    각 스키마 버전의 세부 정보를 포함하는 SchemaVersionList 객체의 배열입니다.

  • NextToken – UTF-8 문자열입니다.

    목록의 현재 세그먼트가 마지막이 아니면 반환된 토큰 목록에 페이지를 매기는 지속적인 토큰은 반환됩니다.

Errors
  • InvalidInputException

  • AccessDeniedException

  • EntityNotFoundException

  • InternalServiceException

GetSchemaVersion 작업(Python: get_schema_version)

스키마 버전을 생성하거나 등록할 때 할당된 고유 ID로 지정된 스키마를 가져옵니다. [삭제됨(Deleted)] 상태의 스키마 버전은 결과에 포함되지 않습니다.

요청
  • SchemaIdSchemaId 객체입니다.

    스키마 자격 증명 필드를 포함하는 래퍼 구조입니다. 구조에는 다음이 포함됩니다.

    • SchemaId$SchemaArn: 스키마의 Amazon 리소스 이름(ARN)입니다. SchemaArn 또는 SchemaNameRegistryName이 제공되어야 합니다.

    • SchemaId$SchemaName: 스키마의 이름입니다. SchemaArn 또는 SchemaNameRegistryName이 제공되어야 합니다.

  • SchemaVersionIdCustom string pattern #17과(와) 일치하는 36바이트 이상 길이의 UTF-8 문자열입니다.

    스키마 버전의 SchemaVersionId입니다. 이 필드는 스키마 ID로 가져오기 위해 필요합니다. 이것 또는 SchemaId 래퍼를 제공해야 합니다.

  • SchemaVersionNumberSchemaVersionNumber 객체입니다.

    스키마의 버전 번호입니다.

응답
  • SchemaVersionIdCustom string pattern #17과(와) 일치하는 36바이트 이상 길이의 UTF-8 문자열입니다.

    스키마 버전의 SchemaVersionId입니다.

  • SchemaDefinitionCustom string pattern #33과(와) 일치하는 1~170,000바이트 길이의 UTF-8 문자열입니다.

    스키마 ID에 대한 스키마 정의입니다.

  • DataFormat – UTF-8 문자열입니다(유효한 값: AVRO | JSON | PROTOBUF).

    스키마 정의의 데이터 형식입니다. 현재 AVRO, JSONPROTOBUF가 지원됩니다.

  • SchemaArnCustom string pattern #22과(와) 일치하는 1~10,240바이트 길이의 UTF-8 문자열입니다.

    스키마의 Amazon 리소스 이름(ARN).

  • VersionNumber - 1~100,000의 숫자(정수)입니다.

    스키마의 버전 번호입니다.

  • Status – UTF-8 문자열입니다(유효한 값: AVAILABLE | PENDING | FAILURE | DELETING).

    스키마 버전의 상태입니다.

  • CreatedTime – UTF-8 문자열입니다.

    스키마 버전이 생성된 날짜 및 시간입니다.

Errors
  • InvalidInputException

  • AccessDeniedException

  • EntityNotFoundException

  • InternalServiceException

GetSchemaVersionsDiff 작업(Python: get_schema_versions_diff)

Schema Registry에 저장된 두 스키마 버전 간에 지정된 차이 유형의 스키마 버전 차이를 가져옵니다.

이 API를 사용하면 동일한 스키마 아래의 두 스키마 정의 간에 두 스키마 버전을 비교할 수 있습니다.

요청
  • SchemaId필수(Required): SchemaId 객체입니다.

    스키마 자격 증명 필드를 포함하는 래퍼 구조입니다. 구조에는 다음이 포함됩니다.

    • SchemaId$SchemaArn: 스키마의 Amazon 리소스 이름(ARN)입니다. SchemaArn 또는 SchemaName 중 하나가 제공되어야 합니다.

    • SchemaId$SchemaName: 스키마의 이름입니다. SchemaArn 또는 SchemaName 중 하나가 제공되어야 합니다.

  • FirstSchemaVersionNumber필수(Required): SchemaVersionNumber 객체입니다.

    비교할 두 스키마 버전 중 첫 번째 버전입니다.

  • SecondSchemaVersionNumber필수(Required): SchemaVersionNumber 객체입니다.

    비교할 두 스키마 버전 중 두 번째 버전입니다.

  • SchemaDiffType필수: UTF-8 문자열입니다(유효한 값: SYNTAX_DIFF).

    현재 지원되는 diff 유형인 SYNTAX_DIFF를 나타냅니다.

응답
  • DiffCustom string pattern #33과(와) 일치하는 1~340,000바이트 길이의 UTF-8 문자열입니다.

    JsonPatch 포맷의 문자열로 스키마 간의 차이점입니다.

Errors
  • InvalidInputException

  • EntityNotFoundException

  • AccessDeniedException

  • InternalServiceException

ListRegistries 작업(Python: list_registries)

최소한의 레지스트리 정보로 생성한 레지스트리 목록을 반환합니다. Deleting 상태의 레지스트리는 결과에 포함되지 않습니다. 사용 가능한 레지스트리가 없으면 빈 결과가 반환됩니다.

요청
  • MaxResults – 1~100의 숫자(정수)입니다.

    페이지당 필요한 최대 결과 수입니다. 값이 제공되지 않으면 페이지당 기본값이 25로 설정됩니다.

  • NextToken – UTF-8 문자열입니다.

    이것이 지속적으로 호출되면 지속적인 토큰입니다.

응답
  • RegistriesRegistryListItem 객체의 배열입니다.

    각 레지스트리에 대한 최소한의 세부 정보를 포함하는 RegistryDetailedListItem 객체의 배열입니다.

  • NextToken – UTF-8 문자열입니다.

    목록의 현재 세그먼트가 마지막이 아니면 반환된 토큰 목록에 페이지를 매기는 지속적인 토큰은 반환됩니다.

Errors
  • InvalidInputException

  • AccessDeniedException

  • InternalServiceException

ListSchemas 작업(Python: list_schemas)

최소한의 세부 정보가 포함된 스키마 목록을 반환합니다. [삭제 중(Deleting)] 상태의 스키마는 결과에 포함되지 않습니다. 사용 가능한 스키마가 없으면 빈 결과가 반환됩니다.

RegistryId가 제공되지 않으면 레지스트리 전체의 모든 스키마가 API 응답의 일부가 됩니다.

요청
  • RegistryIdRegistryId 객체입니다.

    레지스트리 이름과 Amazon 리소스 이름(ARN)을 포함할 수 있는 래퍼 구조입니다.

  • MaxResults – 1~100의 숫자(정수)입니다.

    페이지당 필요한 최대 결과 수입니다. 값이 제공되지 않으면 페이지당 기본값이 25로 설정됩니다.

  • NextToken – UTF-8 문자열입니다.

    이것이 지속적으로 호출되면 지속적인 토큰입니다.

응답
  • SchemasSchemaListItem 객체의 배열입니다.

    각 스키마의 세부 정보를 포함하는 SchemaListItem 객체의 배열입니다.

  • NextToken – UTF-8 문자열입니다.

    목록의 현재 세그먼트가 마지막이 아니면 반환된 토큰 목록에 페이지를 매기는 지속적인 토큰은 반환됩니다.

Errors
  • InvalidInputException

  • AccessDeniedException

  • EntityNotFoundException

  • InternalServiceException

RegisterSchemaVersion 작업(Python: register_schema_version)

기존 스키마에 새 버전을 추가합니다. 새 버전의 스키마가 스키마 집합의 호환성 요구 사항을 충족하지 않는 경우 오류를 반환합니다. 이 API는 새 스키마 집합을 생성하지 않으며 스키마 집합이 Schema Registry에 아직 없는 경우 404 오류를 반환합니다.

이것이 Schema Registry에 등록되는 첫 번째 스키마 정의인 경우 이 API는 스키마 버전을 저장하고 즉시 반환합니다. 그렇지 않으면 이 호출은 호환성 모드로 인해 다른 작업보다 더 오래 실행될 가능성이 있습니다. SchemaVersionIdGetSchemaVersion API를 호출하여 호환 모드를 확인할 수 있습니다.

동일한 스키마 정의가 이미 Schema Registry에 버전으로 저장되어 있는 경우 기존 스키마의 스키마 ID가 호출자에게 반환됩니다.

요청
  • SchemaId필수(Required): SchemaId 객체입니다.

    스키마 자격 증명 필드를 포함하는 래퍼 구조입니다. 구조에는 다음이 포함됩니다.

    • SchemaId$SchemaArn: 스키마의 Amazon 리소스 이름(ARN)입니다. SchemaArn 또는 SchemaNameRegistryName이 제공되어야 합니다.

    • SchemaId$SchemaName: 스키마의 이름입니다. SchemaArn 또는 SchemaNameRegistryName이 제공되어야 합니다.

  • SchemaDefinition필수(Required): Custom string pattern #33과(와) 일치하는 1~170,000바이트 길이의 UTF-8 문자열입니다.

    SchemaName에 대해 DataFormat 설정을 사용하는 스키마 정의입니다.

응답
  • SchemaVersionIdCustom string pattern #17과(와) 일치하는 36바이트 이상 길이의 UTF-8 문자열입니다.

    이 스키마의 버전을 나타내는 고유 ID입니다.

  • VersionNumber - 1~100,000의 숫자(정수)입니다.

    이 스키마의 버전입니다(동기화 흐름 전용, 이것이 첫 번째 버전인 경우).

  • Status – UTF-8 문자열입니다(유효한 값: AVAILABLE | PENDING | FAILURE | DELETING).

    스키마 버전의 상태입니다.

Errors
  • InvalidInputException

  • AccessDeniedException

  • EntityNotFoundException

  • ResourceNumberLimitExceededException

  • ConcurrentModificationException

  • InternalServiceException

UpdateSchema 작업(Python: update_schema)

스키마 집합에 대한 설명, 호환성 설정 또는 버전 검사점을 업데이트합니다.

호환성 설정을 업데이트하기 위해 호출은 새 호환성 설정을 사용하여 전체 스키마 버전 집합에 대한 호환성을 확인하지 않습니다. Compatibility 값이 제공되면 VersionNumber(체크포인트)도 필요합니다. API는 일관성을 위해 체크포인트 버전 번호를 검증합니다.

VersionNumber(체크포인트) 값이 제공되면 Compatibility는 선택 사항이며 스키마에 대한 검사점을 설정/재설정하는 데 사용할 수 있습니다.

이 업데이트는 스키마가 AVAILABLE 상태인 경우에만 발생합니다.

요청
  • SchemaId필수(Required): SchemaId 객체입니다.

    스키마 자격 증명 필드를 포함하는 래퍼 구조입니다. 구조에는 다음이 포함됩니다.

    • SchemaId$SchemaArn: 스키마의 Amazon 리소스 이름(ARN)입니다. SchemaArn 또는 SchemaName 중 하나가 제공되어야 합니다.

    • SchemaId$SchemaName: 스키마의 이름입니다. SchemaArn 또는 SchemaName 중 하나가 제공되어야 합니다.

  • SchemaVersionNumberSchemaVersionNumber 객체입니다.

    체크 포인팅에 필요한 버전 번호입니다. VersionNumber 또는 Compatibility 중 하나가 제공되어야 합니다.

  • Compatibility – UTF-8 문자열입니다(유효한 값: NONE | DISABLED | BACKWARD | BACKWARD_ALL | FORWARD | FORWARD_ALL | FULL | FULL_ALL).

    스키마에 대한 새 호환성 설정입니다.

  • DescriptionURI address multi-line string pattern과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

    스키마에 대한 새 설명입니다.

응답
  • SchemaArnCustom string pattern #22과(와) 일치하는 1~10,240바이트 길이의 UTF-8 문자열입니다.

    스키마의 Amazon 리소스 이름(ARN).

  • SchemaNameCustom string pattern #18과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    스키마의 이름입니다.

  • RegistryNameCustom string pattern #18과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    해당 스키마가 포함된 레지스트리의 이름입니다.

Errors
  • InvalidInputException

  • AccessDeniedException

  • EntityNotFoundException

  • ConcurrentModificationException

  • InternalServiceException

CheckSchemaVersionValidity 작업(Python: check_schema_version_validity)

제공된 스키마를 검증합니다. 이 호출은 부작용이 없으며 단순히 DataFormat을 포맷으로 사용하여 제공된 스키마를 사용하여 검증합니다. 스키마 집합 이름을 사용하지 않으므로 호환성 검사가 수행되지 않습니다.

요청
  • DataFormat필수: UTF-8 문자열입니다(유효한 값: AVRO | JSON | PROTOBUF).

    스키마 정의의 데이터 형식입니다. 현재 AVRO, JSONPROTOBUF가 지원됩니다.

  • SchemaDefinition필수(Required): Custom string pattern #33과(와) 일치하는 1~170,000바이트 길이의 UTF-8 문자열입니다.

    검증해야 하는 스키마의 정의입니다.

응답
  • Valid – 부울입니다.

    스키마가 유효하면 true를 반환하고 그렇지 않으면 false를 반환합니다.

  • Error – 1~5,000바이트 길이의 UTF-8 문자열입니다.

    검증 실패 메시지입니다.

Errors
  • InvalidInputException

  • AccessDeniedException

  • InternalServiceException

UpdateRegistry 작업(Python: update_registry)

스키마 컬렉션을 보유하는 데 사용되는 기존 레지스트리를 업데이트합니다. 업데이트된 속성은 레지스트리와 관련되며 레지스트리 내의 스키마를 수정하지 않습니다.

요청
  • RegistryId필수(Required): RegistryId 객체입니다.

    이는 레지스트리 이름과 Amazon 리소스 이름(ARN)을 포함할 수 있는 래퍼 구조입니다.

  • Description필수(Required): URI address multi-line string pattern과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

    레지스트리에 대한 설명입니다. 설명이 제공되지 않으면 이 필드는 업데이트되지 않습니다.

응답
  • RegistryNameCustom string pattern #18과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    업데이트된 레지스트리의 이름입니다.

  • RegistryArnCustom string pattern #22과(와) 일치하는 1~10,240바이트 길이의 UTF-8 문자열입니다.

    업데이트된 레지스트리의 Amazon 리소스 이름(ARN)입니다.

Errors
  • InvalidInputException

  • AccessDeniedException

  • EntityNotFoundException

  • ConcurrentModificationException

  • InternalServiceException

GetSchemaByDefinition 작업(Python: get_schema_by_definition)

SchemaDefinition으로 스키마를 검색합니다. 스키마 정의는 Schema Registry로 전송되고 정규화되고 해시됩니다. 해시가 SchemaName 또는 ARN의 범위 내에서 일치하는 경우(또는 제공되지 않은 경우 기본 레지스트리) 해당 스키마의 메타데이터가 반환됩니다. 그렇지 않으면 404 또는 NotFound 오류가 반환됩니다. Deleted 상태의 스키마 버전은 결과에 포함되지 않습니다.

요청
  • SchemaId필수(Required): SchemaId 객체입니다.

    스키마 자격 증명 필드를 포함하는 래퍼 구조입니다. 구조에는 다음이 포함됩니다.

    • SchemaId$SchemaArn: 스키마의 Amazon 리소스 이름(ARN)입니다. SchemaArn 또는 SchemaName 중 하나가 제공되어야 합니다.

    • SchemaId$SchemaName: 스키마의 이름입니다. SchemaArn 또는 SchemaName 중 하나가 제공되어야 합니다.

  • SchemaDefinition필수(Required): Custom string pattern #33과(와) 일치하는 1~170,000바이트 길이의 UTF-8 문자열입니다.

    스키마 세부 정보가 필요한 스키마의 정의입니다.

응답
  • SchemaVersionIdCustom string pattern #17과(와) 일치하는 36바이트 이상 길이의 UTF-8 문자열입니다.

    스키마 버전의 스키마 ID입니다.

  • SchemaArnCustom string pattern #22과(와) 일치하는 1~10,240바이트 길이의 UTF-8 문자열입니다.

    스키마의 Amazon 리소스 이름(ARN).

  • DataFormat – UTF-8 문자열입니다(유효한 값: AVRO | JSON | PROTOBUF).

    스키마 정의의 데이터 형식입니다. 현재 AVRO, JSONPROTOBUF가 지원됩니다.

  • Status – UTF-8 문자열입니다(유효한 값: AVAILABLE | PENDING | FAILURE | DELETING).

    스키마 버전의 상태입니다.

  • CreatedTime – UTF-8 문자열입니다.

    스키마가 생성된 날짜 및 시간입니다.

Errors
  • InvalidInputException

  • AccessDeniedException

  • EntityNotFoundException

  • InternalServiceException

GetRegistry 작업(Python: get_registry)

지정된 레지스트리를 자세히 설명합니다.

요청
  • RegistryId필수(Required): RegistryId 객체입니다.

    이는 레지스트리 이름과 Amazon 리소스 이름(ARN)을 포함할 수 있는 래퍼 구조입니다.

응답
  • RegistryNameCustom string pattern #18과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    레지스트리의 이름입니다.

  • RegistryArnCustom string pattern #22과(와) 일치하는 1~10,240바이트 길이의 UTF-8 문자열입니다.

    레지스트리의 Amazon 리소스 이름(ARN)입니다.

  • DescriptionURI address multi-line string pattern과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

    레지스트리에 대한 설명입니다.

  • Status – UTF-8 문자열입니다(유효한 값: AVAILABLE | DELETING).

    레지스트리의 상태입니다.

  • CreatedTime – UTF-8 문자열입니다.

    레지스트리가 생성된 날짜 및 시간입니다.

  • UpdatedTime – UTF-8 문자열입니다.

    레지스트리가 업데이트된 날짜 및 시간입니다.

Errors
  • InvalidInputException

  • AccessDeniedException

  • EntityNotFoundException

  • InternalServiceException

PutSchemaVersionMetadata 작업(Python: put_schema_version_metadata)

지정된 스키마 버전 ID에 대한 메타데이터 키 값 페어를 넣습니다. 스키마 버전당 최대 10개의 키 값 페어가 허용됩니다. 하나 이상의 호출을 통해 추가할 수 있습니다.

요청
  • SchemaIdSchemaId 객체입니다.

    스키마의 고유 ID입니다.

  • SchemaVersionNumberSchemaVersionNumber 객체입니다.

    스키마의 버전 번호입니다.

  • SchemaVersionIdCustom string pattern #17과(와) 일치하는 36바이트 이상 길이의 UTF-8 문자열입니다.

    스키마 버전의 고유한 버전 ID입니다.

  • MetadataKeyValue필수(Required): MetadataKeyValuePair 객체입니다.

    메타데이터 키의 해당하는 값입니다.

응답
  • SchemaArnCustom string pattern #22과(와) 일치하는 1~10,240바이트 길이의 UTF-8 문자열입니다.

    스키마의 Amazon 리소스 이름(ARN)입니다.

  • SchemaNameCustom string pattern #18과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    스키마의 이름입니다.

  • RegistryNameCustom string pattern #18과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    레지스트리의 이름입니다.

  • LatestVersion – 부울입니다.

    스키마의 최신 버전입니다.

  • VersionNumber - 1~100,000의 숫자(정수)입니다.

    스키마의 버전 번호입니다.

  • SchemaVersionIdCustom string pattern #17과(와) 일치하는 36바이트 이상 길이의 UTF-8 문자열입니다.

    스키마 버전의 고유한 버전 ID입니다.

  • MetadataKeyCustom string pattern #34과(와) 일치하는 1~128바이트 길이의 UTF-8 문자열입니다.

    메타데이터 키입니다.

  • MetadataValueCustom string pattern #34과(와) 일치하는 1~256바이트 길이의 UTF-8 문자열입니다.

    메타데이터 키의 값입니다.

Errors
  • InvalidInputException

  • AccessDeniedException

  • AlreadyExistsException

  • EntityNotFoundException

  • ResourceNumberLimitExceededException

QuerySchemaVersionMetadata 작업(Python: query_schema_version_metadata)

스키마 버전 메타데이터 정보에 대한 쿼리입니다.

요청
  • SchemaIdSchemaId 객체입니다.

    스키마 이름과 Amazon 리소스 이름(ARN)을 포함할 수 있는 래퍼 구조입니다.

  • SchemaVersionNumberSchemaVersionNumber 객체입니다.

    스키마의 버전 번호입니다.

  • SchemaVersionIdCustom string pattern #17과(와) 일치하는 36바이트 이상 길이의 UTF-8 문자열입니다.

    스키마 버전의 고유한 버전 ID입니다.

  • MetadataListMetadataKeyValuePair 객체의 배열입니다.

    메타데이터에 대한 키-값 페어를 검색합니다. 제공되지 않으면 모든 메타데이터 정보를 가져옵니다.

  • MaxResults – 1~50의 숫자(정수)입니다.

    페이지당 필요한 최대 결과 수입니다. 값이 제공되지 않으면 페이지당 기본값이 25로 설정됩니다.

  • NextToken – UTF-8 문자열입니다.

    이것이 지속적으로 호출되면 지속적인 토큰입니다.

응답
  • MetadataInfoMap – 키-값 페어의 맵 배열입니다.

    각 키는 Custom string pattern #34과(와) 일치하는 1~128바이트 길이의 UTF-8 문자열입니다.

    각 값은 MetadataInfo 객체입니다.

    메타데이터 키 및 관련 값의 맵입니다.

  • SchemaVersionIdCustom string pattern #17과(와) 일치하는 36바이트 이상 길이의 UTF-8 문자열입니다.

    스키마 버전의 고유한 버전 ID입니다.

  • NextToken – UTF-8 문자열입니다.

    목록의 현재 세그먼트가 마지막이 아니면 반환된 토큰 목록에 페이지를 매기는 지속적인 토큰은 반환됩니다.

Errors
  • InvalidInputException

  • AccessDeniedException

  • EntityNotFoundException

RemoveSchemaVersionMetadata 작업(Python: remove_schema_version_metadata)

지정된 스키마 버전 ID에 대한 스키마 버전 메타데이터에서 키 값 페어를 제거합니다.

요청
  • SchemaIdSchemaId 객체입니다.

    스키마 이름과 Amazon 리소스 이름(ARN)을 포함할 수 있는 래퍼 구조입니다.

  • SchemaVersionNumberSchemaVersionNumber 객체입니다.

    스키마의 버전 번호입니다.

  • SchemaVersionIdCustom string pattern #17과(와) 일치하는 36바이트 이상 길이의 UTF-8 문자열입니다.

    스키마 버전의 고유한 버전 ID입니다.

  • MetadataKeyValue필수(Required): MetadataKeyValuePair 객체입니다.

    메타데이터 키의 값입니다.

응답
  • SchemaArnCustom string pattern #22과(와) 일치하는 1~10,240바이트 길이의 UTF-8 문자열입니다.

    스키마의 Amazon 리소스 이름(ARN).

  • SchemaNameCustom string pattern #18과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    스키마의 이름입니다.

  • RegistryNameCustom string pattern #18과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    레지스트리의 이름입니다.

  • LatestVersion – 부울입니다.

    스키마의 최신 버전입니다.

  • VersionNumber - 1~100,000의 숫자(정수)입니다.

    스키마의 버전 번호입니다.

  • SchemaVersionIdCustom string pattern #17과(와) 일치하는 36바이트 이상 길이의 UTF-8 문자열입니다.

    스키마 버전에 대한 버전 ID입니다.

  • MetadataKeyCustom string pattern #34과(와) 일치하는 1~128바이트 길이의 UTF-8 문자열입니다.

    메타데이터 키입니다.

  • MetadataValueCustom string pattern #34과(와) 일치하는 1~256바이트 길이의 UTF-8 문자열입니다.

    메타데이터 키의 값입니다.

Errors
  • InvalidInputException

  • AccessDeniedException

  • EntityNotFoundException

DeleteRegistry 작업(Python: delete_registry)

스키마와 모든 해당 버전을 포함한 전체 레지스트리를 삭제합니다. 삭제 작업의 상태를 얻으려면 비동기 호출 후 GetRegistry API를 호출할 수 있습니다. 레지스트리를 삭제하면 UpdateRegistry, CreateSchema, UpdateSchemaRegisterSchemaVersion API와 같은 레지스트리에 대한 모든 온라인 작업이 비활성화됩니다.

요청
  • RegistryId필수(Required): RegistryId 객체입니다.

    이는 레지스트리 이름과 Amazon 리소스 이름(ARN)을 포함할 수 있는 래퍼 구조입니다.

응답
  • RegistryNameCustom string pattern #18과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    삭제되는 레지스트리의 이름입니다.

  • RegistryArnCustom string pattern #22과(와) 일치하는 1~10,240바이트 길이의 UTF-8 문자열입니다.

    삭제 중인 레지스트리의 Amazon 리소스 이름(ARN)입니다.

  • Status – UTF-8 문자열입니다(유효한 값: AVAILABLE | DELETING).

    레지스트리의 상태입니다. 작업이 성공하면 Deleting 상태가 반환됩니다.

Errors
  • InvalidInputException

  • EntityNotFoundException

  • AccessDeniedException

  • ConcurrentModificationException

DeleteSchema 작업(Python: delete_schema)

스키마 집합 및 모든 해당 버전을 포함하여 전체 스키마 집합을 삭제합니다. 삭제 작업의 상태를 얻으려면 비동기 호출 후 GetSchema API를 호출할 수 있습니다. 레지스트리를 삭제하면 GetSchemaByDefinitionRegisterSchemaVersion API와 같은 스키마에 대한 모든 온라인 작업이 비활성화됩니다.

요청
  • SchemaId필수(Required): SchemaId 객체입니다.

    이는 스키마 이름과 Amazon 리소스 이름(ARN)을 포함할 수 있는 래퍼 구조입니다.

응답
  • SchemaArnCustom string pattern #22과(와) 일치하는 1~10,240바이트 길이의 UTF-8 문자열입니다.

    삭제 중인 스키마의 Amazon 리소스 이름(ARN)입니다.

  • SchemaNameCustom string pattern #18과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    삭제 중인 스키마의 이름입니다.

  • Status – UTF-8 문자열입니다(유효한 값: AVAILABLE | PENDING | DELETING).

    스키마의 상태입니다.

Errors
  • InvalidInputException

  • EntityNotFoundException

  • AccessDeniedException

  • ConcurrentModificationException

DeleteSchemaVersions 작업(Python: delete_schema_versions)

지정된 스키마에서 버전을 제거합니다. 버전 번호 또는 범위가 제공될 수 있습니다. 호환 모드가 BACKWARDS_FULL과 같이 필요한 버전의 삭제를 금지하는 경우 오류가 반환됩니다. 이 호출 후 GetSchemaVersions API를 호출하면 삭제된 버전의 상태가 나열됩니다.

버전 번호 범위에 체크포인트 버전이 포함된 경우 API는 409 충돌을 반환하고 삭제를 진행하지 않습니다. 이 API를 사용하기 전에 먼저 DeleteSchemaCheckpoint API를 사용하여 체크포인트를 제거해야 합니다.

DeleteSchemaVersions API를 사용하여 스키마 집합의 첫 번째 스키마 버전을 삭제할 수 없습니다. 첫 번째 스키마 버전은 DeleteSchema API로만 삭제할 수 있습니다. 이 작업은 스키마 버전 아래에 첨부된 SchemaVersionMetadata도 삭제합니다. 영구 삭제는 데이터베이스에 적용됩니다.

호환 모드가 BACKWARDS_FULL과 같이 필요한 버전의 삭제를 금지하는 경우 오류가 반환됩니다.

요청
  • SchemaId필수(Required): SchemaId 객체입니다.

    이는 스키마 이름과 Amazon 리소스 이름(ARN)을 포함할 수 있는 래퍼 구조입니다.

  • Versions필수(Required): Custom string pattern #35과(와) 일치하는 1~100,000바이트 길이의 UTF-8 문자열입니다.

    다음 포맷의 버전 범위가 제공될 수 있습니다.

    • 단일 버전 번호, 5

    • 범위, 5~8 : 버전 5, 6, 7, 8을 삭제합니다.

응답
  • SchemaVersionErrorsSchemaVersionErrorItem 객체의 배열입니다.

    각각 오류 및 스키마 버전을 포함하는 SchemaVersionErrorItem 객체 목록입니다.

Errors
  • InvalidInputException

  • EntityNotFoundException

  • AccessDeniedException

  • ConcurrentModificationException