Registri skema - AWS Glue

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Registri skema

Registri Skema API menjelaskan tipe data dan API terkait dengan bekerja dengan skema di. AWS Glue

Jenis data

RegistryId struktur

Struktur pembungkus yang mungkin berisi nama registri dan Amazon Resource Name (ARN).

Bidang
  • RegistryName- UTF -8 string, tidak kurang dari 1 atau lebih dari 255 byte panjang, cocok dengan. Custom string pattern #18

    Nama registri. Digunakan hanya untuk pencarian. Salah satu dari RegistryArn atau RegistryName harus disediakan.

  • RegistryArn- UTF -8 string, tidak kurang dari 1 atau lebih dari 10240 byte panjang, cocok dengan. Custom string pattern #22

    Arn dari registri yang akan diperbarui. Salah satu dari RegistryArn atau RegistryName harus disediakan.

RegistryListItem struktur

Struktur yang berisi detail untuk sebuah registri.

Bidang
  • RegistryName- UTF -8 string, tidak kurang dari 1 atau lebih dari 255 byte panjang, cocok dengan. Custom string pattern #18

    Nama registri.

  • RegistryArn- UTF -8 string, tidak kurang dari 1 atau lebih dari 10240 byte panjang, cocok dengan. Custom string pattern #22

    Nama Sumber Daya Amazon (ARN) dari registri.

  • Description — String deskripsi, dengan panjang tidak lebih dari 2048 byte, yang cocok dengan URI address multi-line string pattern.

    Sebuah deskripsi registri.

  • Status— UTF -8 string (nilai valid: AVAILABLE |DELETING).

    Status registri.

  • CreatedTime— UTF -8 string.

    Registri data telah dibuat.

  • UpdatedTime— UTF -8 string.

    Tanggal saat registri diperbarui.

MetadataInfo struktur

Struktur yang berisi informasi metadata untuk sebuah versi skema.

Bidang
  • MetadataValue- UTF -8 string, tidak kurang dari 1 atau lebih dari 256 byte panjang, cocok dengan. Custom string pattern #34

    Nilai yang sesuai kunci metadata.

  • CreatedTime— UTF -8 string.

    Waktu saat entri dibuat.

  • OtherMetadataValueList – Susunan objek OtherMetadataValueListItem.

    Metadata lainnya yang merupakan milik dari kunci metadata yang sama.

OtherMetadataValueListItem struktur

Struktur yang berisi metadata lain untuk sebuah versi skema yang merupakan milik dari kunci metadata yang sama.

Bidang
  • MetadataValue- UTF -8 string, tidak kurang dari 1 atau lebih dari 256 byte panjang, cocok dengan. Custom string pattern #34

    Nilai yang sesuai kunci metadata untuk metadata lainnya yang merupakan milik dari kunci metadata yang sama.

  • CreatedTime— UTF -8 string.

    Waktu saat entri dibuat.

SchemaListItem struktur

Sebuah objek yang berisi detail minimal untuk sebuah skema.

Bidang
  • RegistryName- UTF -8 string, tidak kurang dari 1 atau lebih dari 255 byte panjang, cocok dengan. Custom string pattern #18

    Nama registri tempat skema berada.

  • SchemaName- UTF -8 string, tidak kurang dari 1 atau lebih dari 255 byte panjang, cocok dengan. Custom string pattern #18

    Nama skema.

  • SchemaArn- UTF -8 string, tidak kurang dari 1 atau lebih dari 10240 byte panjang, cocok dengan. Custom string pattern #22

    Amazon Resource Name (ARN) untuk skema.

  • Description — String deskripsi, dengan panjang tidak lebih dari 2048 byte, yang cocok dengan URI address multi-line string pattern.

    Sebuah deskripsi untuk skema.

  • SchemaStatus— UTF -8 string (nilai valid: AVAILABLE | PENDING |DELETING).

    Status skema.

  • CreatedTime— UTF -8 string.

    Tanggal dan waktu saat sebuah skema dibuat.

  • UpdatedTime— UTF -8 string.

    Tanggal dan waktu saat sebuah skema diperbarui.

SchemaVersionListItem struktur

Sebuah objek yang berisi detail tentang sebuah versi skema.

Bidang
  • SchemaArn- UTF -8 string, tidak kurang dari 1 atau lebih dari 10240 byte panjang, cocok dengan. Custom string pattern #22

    Nama Sumber Daya Amazon (ARN) dari skema.

  • SchemaVersionId- UTF -8 string, tidak kurang dari 36 atau lebih dari 36 byte panjang, cocok dengan. Custom string pattern #17

    Pengenal unik dari versi skema.

  • VersionNumber — Nomor (bilangan bulat), tidak kurang dari 1 atau lebih dari 100000.

    Nomor versi dari skema.

  • Status— UTF -8 string (nilai valid: AVAILABLE | | PENDING FAILURE |DELETING).

    Status versi skema.

  • CreatedTime— UTF -8 string.

    Tanggal dan waktu saat versi skema dibuat.

MetadataKeyValuePair struktur

Sebuah Struktur yang berisi pasangan nilai kunci untuk metadata.

Bidang
  • MetadataKey- UTF -8 string, tidak kurang dari 1 atau lebih dari 128 byte panjang, cocok dengan. Custom string pattern #34

    Sebuah kunci metadata.

  • MetadataValue- UTF -8 string, tidak kurang dari 1 atau lebih dari 256 byte panjang, cocok dengan. Custom string pattern #34

    Nilai yang sesuai kunci metadata.

SchemaVersionErrorItem struktur

Sebuah objek yang berisi detail kesalahan untuk sebuah pada sebuah versi skema.

Bidang
  • VersionNumber — Nomor (bilangan bulat), tidak kurang dari 1 atau lebih dari 100000.

    Nomor versi dari skema.

  • ErrorDetails — Sebuah objek ErrorDetails.

    Detail kesalahan untuk versi skema.

ErrorDetails struktur

Sebuah objek yang berisi detail kesalahan.

Bidang
  • ErrorCode— UTF -8 string.

    Kode kesalahan untuk sebuah kesalahan.

  • ErrorMessage— UTF -8 string.

    Pesan kesalahan untuk sebuah kesalahan.

SchemaVersionNumber struktur

Sebuah struktur yang berisi informasi skema.

Bidang
  • LatestVersion – Boolean.

    Versi terbaru yang tersedia untuk skema.

  • VersionNumber — Nomor (bilangan bulat), tidak kurang dari 1 atau lebih dari 100000.

    Nomor versi dari skema.

SchemaId struktur

ID unik skema dalam registri AWS Glue skema.

Bidang
  • SchemaArn- UTF -8 string, tidak kurang dari 1 atau lebih dari 10240 byte panjang, cocok dengan. Custom string pattern #22

    Nama Sumber Daya Amazon (ARN) dari skema. Salah satu dari SchemaArn atau SchemaName harus disediakan.

  • SchemaName- UTF -8 string, tidak kurang dari 1 atau lebih dari 255 byte panjang, cocok dengan. Custom string pattern #18

    Nama skema. Salah satu dari SchemaArn atau SchemaName harus disediakan.

  • RegistryName- UTF -8 string, tidak kurang dari 1 atau lebih dari 255 byte panjang, cocok dengan. Custom string pattern #18

    Nama registri skema yang berisi skema.

Operasi

CreateRegistry tindakan (Python: create_registry)

Menciptakan sebuah registri baru yang dapat digunakan untuk menyimpan sekumpulan skema.

Permintaan
  • RegistryName- Diperlukan: UTF -8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok dengan file. Custom string pattern #18

    Nama registri yang akan dibuat dengan panjang maksimal 255 karakter, dan mungkin hanya berisi huruf, angka, tanda hubung, garis bawah, tanda dolar, atau tanda hash. Tanpa spasi.

  • Description — String deskripsi, dengan panjang tidak lebih dari 2048 byte, yang cocok dengan URI address multi-line string pattern.

    Sebuah deskripsi registri. Jika deskripsi tidak tersedia, maka tidak akan ada nilai default untuk ini.

  • Tags — Sebuah rangkaian peta pasangan nilai kunci, tidak lebih dari 50 pasang.

    Setiap kunci adalah string UTF -8, panjangnya tidak kurang dari 1 atau lebih dari 128 byte.

    Setiap nilai adalah string UTF -8, panjangnya tidak lebih dari 256 byte.

    AWS tag yang berisi pasangan nilai kunci dan dapat dicari berdasarkan konsol, baris perintah, atauAPI.

Respons
  • RegistryArn- UTF -8 string, tidak kurang dari 1 atau lebih dari 10240 byte panjang, cocok dengan. Custom string pattern #22

    Nama Sumber Daya Amazon (ARN) dari registri yang baru dibuat.

  • RegistryName- UTF -8 string, tidak kurang dari 1 atau lebih dari 255 byte panjang, cocok dengan. Custom string pattern #18

    Nama registri.

  • Description — String deskripsi, dengan panjang tidak lebih dari 2048 byte, yang cocok dengan URI address multi-line string pattern.

    Sebuah deskripsi registri.

  • Tags — Sebuah rangkaian peta pasangan nilai kunci, tidak lebih dari 50 pasang.

    Setiap kunci adalah string UTF -8, panjangnya tidak kurang dari 1 atau lebih dari 128 byte.

    Setiap nilai adalah string UTF -8, panjangnya tidak lebih dari 256 byte.

    Tag untuk registri.

Kesalahan
  • InvalidInputException

  • AccessDeniedException

  • AlreadyExistsException

  • ResourceNumberLimitExceededException

  • ConcurrentModificationException

  • InternalServiceException

CreateSchema tindakan (Python: create_schema)

Menciptakan sebuah set skema baru dan mendaftar definisi skema. Mengembalikan kesalahan jika set skema sudah ada tanpa benar-benar mendaftarkan versi.

Ketika set skema dibuat, pos pemeriksaan versi akan diatur ke versi pertama. Mode kompatibilitas DISABLED "" membatasi versi skema tambahan apa pun agar tidak ditambahkan setelah versi skema pertama. Untuk semua mode kompatibilitas lainnya, validasi pengaturan kompatibilitas hanya akan diterapkan dari versi kedua dan seterusnya saat RegisterSchemaVersion API digunakan.

Ketika ini API dipanggil tanpa aRegistryId, ini akan membuat entri untuk “default-registry” di tabel database registri, jika belum ada.

Permintaan
  • RegistryId — Sebuah objek RegistryId.

    Ini adalah sebuah bentuk pembungkus berisi bidang identitas registri. Jika ini tidak tersedia, maka registri default akan digunakan. ARNFormat untuk hal yang sama adalah:arn:aws:glue:us-east-2:<customer id>:registry/default-registry:random-5-letter-id.

  • SchemaName- Diperlukan: UTF -8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok dengan file. Custom string pattern #18

    Nama skema yang akan dibuat dengan panjang maksimal 255 karakter, dan mungkin hanya berisi huruf, angka, tanda hubung, garis bawah, tanda dolar, atau tanda hash. Tanpa spasi.

  • DataFormat- Diperlukan: UTF -8 string (nilai valid: AVRO | JSON |PROTOBUF).

    Format data dari definisi skema. Saat iniAVRO, JSON dan PROTOBUF didukung.

  • Compatibility— UTF -8 string (nilai yang valid: NONE DISABLED | BACKWARD | BACKWARD_ALL | FORWARD | FORWARD_ALL FULL |FULL_ALL).

    Mode kompatibilitas skema. Nilai yang mungkin adalah:

    • NONE: Tidak ada mode kompatibilitas yang berlaku. Anda dapat menggunakan pilihan ini dalam skenario pengembangan atau jika Anda tidak tahu mode kompatibilitas yang ingin Anda terapkan untuk skema. Setiap versi baru yang ditambahkan akan diterima tanpa menjalani pemeriksaan kompatibilitas terlebih dahulu.

    • DISABLED: Pilihan kompatibilitas ini mencegah pembuatan versi untuk skema tertentu. Anda dapat menggunakan pilihan ini untuk mencegah dilakukannya versioning masa depan pada sebuah skema.

    • BACKWARD: Pilihan kompatibilitas ini direkomendasikan karena memungkinkan penerima data untuk membaca versi skema saat ini dan versi skema sebelumnya. Ini berarti bahwa misalnya, versi skema baru tidak dapat membuang bidang data atau mengubah jenis bidang ini, sehingga tidak dapat dibaca oleh pembaca menggunakan versi sebelumnya.

    • BACKWARD_ ALL: Pilihan kompatibilitas ini memungkinkan penerima data untuk membaca versi skema saat ini dan semua versi skema sebelumnya. Anda dapat menggunakan pilihan ini ketika Anda harus menghapus bidang atau menambahkan bidang opsional, dan memeriksa kompatibilitas terhadap semua versi skema sebelumnya.

    • FORWARD: Pilihan kompatibilitas ini memungkinkan penerima data untuk membaca versi skema saat ini dan versi berikutnya, tetapi belum tentu versi yang lebih baru. Anda dapat menggunakan pilihan ini ketika Anda harus menambahkan bidang atau menghapus bidang opsional, tetapi hanya memeriksa kompatibilitas terhadap semua versi skema sebelumnya.

    • FORWARD_ ALL: Pilihan kompatibilitas ini memungkinkan penerima data untuk membaca yang ditulis oleh produsen skema terdaftar baru. Anda dapat menggunakan pilihan ini ketika Anda harus menambahkan bidang atau menghapus bidang opsional, dan memeriksa kompatibilitas terhadap semua versi skema sebelumnya.

    • FULLPilihan kompatibilitas ini memungkinkan penerima data untuk membaca data yang ditulis oleh produsen menggunakan versi skema sebelumnya atau berikutnya, tetapi tidak harus versi sebelumnya atau yang lebih baru. Anda dapat menggunakan pilihan ini ketika Anda harus menambahkan atau menghapus bidang opsional, tetapi hanya memeriksa kompatibilitas terhadap versi skema sebelumnya.

    • FULL_ ALL: Pilihan kompatibilitas ini memungkinkan penerima data untuk membaca data yang ditulis oleh produsen menggunakan semua versi skema sebelumnya. Anda dapat menggunakan pilihan ini ketika Anda harus menambahkan atau menghapus bidang opsional, dan memeriksa kompatibilitas terhadap semua versi skema sebelumnya.

  • Description — String deskripsi, dengan panjang tidak lebih dari 2048 byte, yang cocok dengan URI address multi-line string pattern.

    Sebuah deskripsi opsional dari skema. Jika deskripsi tidak tersedia, maka tidak akan ada nilai default otomatis untuk ini.

  • Tags — Sebuah rangkaian peta pasangan nilai kunci, tidak lebih dari 50 pasang.

    Setiap kunci adalah string UTF -8, panjangnya tidak kurang dari 1 atau lebih dari 128 byte.

    Setiap nilai adalah string UTF -8, panjangnya tidak lebih dari 256 byte.

    AWS tag yang berisi pasangan nilai kunci dan dapat dicari berdasarkan konsol, baris perintah, atauAPI. Jika ditentukan, ikuti AWS tags-on-create polanya.

  • SchemaDefinition- UTF -8 string, tidak kurang dari 1 atau lebih dari 170000 byte panjang, cocok dengan. Custom string pattern #33

    Definisi skema menggunakan pengaturan DataFormat untuk SchemaName.

Respons
  • RegistryName- UTF -8 string, tidak kurang dari 1 atau lebih dari 255 byte panjang, cocok dengan. Custom string pattern #18

    Nama registri.

  • RegistryArn- UTF -8 string, tidak kurang dari 1 atau lebih dari 10240 byte panjang, cocok dengan. Custom string pattern #22

    Nama Sumber Daya Amazon (ARN) dari registri.

  • SchemaName- UTF -8 string, tidak kurang dari 1 atau lebih dari 255 byte panjang, cocok dengan. Custom string pattern #18

    Nama skema.

  • SchemaArn- UTF -8 string, tidak kurang dari 1 atau lebih dari 10240 byte panjang, cocok dengan. Custom string pattern #22

    Nama Sumber Daya Amazon (ARN) dari skema.

  • Description — String deskripsi, dengan panjang tidak lebih dari 2048 byte, yang cocok dengan URI address multi-line string pattern.

    Sebuah deskripsi skema jika ditentukan saat dibuat.

  • DataFormat— UTF -8 string (nilai valid: AVRO | JSON |PROTOBUF).

    Format data dari definisi skema. Saat iniAVRO, JSON dan PROTOBUF didukung.

  • Compatibility— UTF -8 string (nilai yang valid: NONE DISABLED | BACKWARD | BACKWARD_ALL | FORWARD | FORWARD_ALL FULL |FULL_ALL).

    Mode kompatibilitas skema.

  • SchemaCheckpoint — Nomor (bilangan bulat), tidak kurang dari 1 atau lebih dari 100000.

    Nomor versi pos pemeriksaan (terakhir kali mode kompatibilitas diubah).

  • LatestSchemaVersion — Nomor (bilangan bulat), tidak kurang dari 1 atau lebih dari 100000.

    Versi terbaru dari skema yang dikaitkan dengan definisi skema yang dikembalikan.

  • NextSchemaVersion — Nomor (bilangan bulat), tidak kurang dari 1 atau lebih dari 100000.

    Versi berikutnya dari skema yang dikaitkan dengan definisi skema yang dikembalikan.

  • SchemaStatus— UTF -8 string (nilai valid: AVAILABLE | PENDING |DELETING).

    Status skema.

  • Tags — Sebuah rangkaian peta pasangan nilai kunci, tidak lebih dari 50 pasang.

    Setiap kunci adalah string UTF -8, panjangnya tidak kurang dari 1 atau lebih dari 128 byte.

    Setiap nilai adalah string UTF -8, panjangnya tidak lebih dari 256 byte.

    Tag untuk skema.

  • SchemaVersionId- UTF -8 string, tidak kurang dari 36 atau lebih dari 36 byte panjang, cocok dengan. Custom string pattern #17

    Pengenal unik dari versi skema yang pertama.

  • SchemaVersionStatus— UTF -8 string (nilai valid: AVAILABLE | | PENDING FAILURE |DELETING).

    Status versi skema pertama yang dibuat.

Kesalahan
  • InvalidInputException

  • AccessDeniedException

  • EntityNotFoundException

  • AlreadyExistsException

  • ResourceNumberLimitExceededException

  • ConcurrentModificationException

  • InternalServiceException

GetSchema tindakan (Python: get_schema)

Menjelaskan skema yang ditentukan secara detail.

Permintaan
  • SchemaIdWajib: Sebuah objek SchemaId.

    Ini adalah sebuah struktur pembungkus berisi bidang identitas skema. Strukturnya berisi:

    • SchemaId$SchemaArn: Nama Sumber Daya Amazon (ARN) dari skema. Baik SchemaArn, atau SchemaName dan RegistryName harus disediakan.

    • SchemaId$SchemaName: Nama skema. Baik SchemaArn, atau SchemaName dan RegistryName harus disediakan.

Respons
  • RegistryName- UTF -8 string, tidak kurang dari 1 atau lebih dari 255 byte panjang, cocok dengan. Custom string pattern #18

    Nama registri.

  • RegistryArn- UTF -8 string, tidak kurang dari 1 atau lebih dari 10240 byte panjang, cocok dengan. Custom string pattern #22

    Nama Sumber Daya Amazon (ARN) dari registri.

  • SchemaName- UTF -8 string, tidak kurang dari 1 atau lebih dari 255 byte panjang, cocok dengan. Custom string pattern #18

    Nama skema.

  • SchemaArn- UTF -8 string, tidak kurang dari 1 atau lebih dari 10240 byte panjang, cocok dengan. Custom string pattern #22

    Nama Sumber Daya Amazon (ARN) dari skema.

  • Description — String deskripsi, dengan panjang tidak lebih dari 2048 byte, yang cocok dengan URI address multi-line string pattern.

    Sebuah deskripsi skema jika ditentukan saat dibuat

  • DataFormat— UTF -8 string (nilai valid: AVRO | JSON |PROTOBUF).

    Format data dari definisi skema. Saat iniAVRO, JSON dan PROTOBUF didukung.

  • Compatibility— UTF -8 string (nilai yang valid: NONE DISABLED | BACKWARD | BACKWARD_ALL | FORWARD | FORWARD_ALL FULL |FULL_ALL).

    Mode kompatibilitas skema.

  • SchemaCheckpoint — Nomor (bilangan bulat), tidak kurang dari 1 atau lebih dari 100000.

    Nomor versi pos pemeriksaan (terakhir kali mode kompatibilitas diubah).

  • LatestSchemaVersion — Nomor (bilangan bulat), tidak kurang dari 1 atau lebih dari 100000.

    Versi terbaru dari skema yang dikaitkan dengan definisi skema yang dikembalikan.

  • NextSchemaVersion — Nomor (bilangan bulat), tidak kurang dari 1 atau lebih dari 100000.

    Versi berikutnya dari skema yang dikaitkan dengan definisi skema yang dikembalikan.

  • SchemaStatus— UTF -8 string (nilai valid: AVAILABLE | PENDING |DELETING).

    Status skema.

  • CreatedTime— UTF -8 string.

    Tanggal dan waktu saat sebuah skema dibuat.

  • UpdatedTime— UTF -8 string.

    Tanggal dan waktu saat sebuah skema diperbarui.

Kesalahan
  • InvalidInputException

  • AccessDeniedException

  • EntityNotFoundException

  • InternalServiceException

ListSchemaVersions tindakan (Python: list_schema_versions)

Mengembalikan daftar versi skema yang telah Anda buat, dengan informasi yang minimal. Versi skema dengan status Dihapus tidak akan disertakan dalam hasil. Hasil kosong akan dikembalikan jika tidak ada versi skema yang tersedia.

Permintaan
  • SchemaIdWajib: Sebuah objek SchemaId.

    Ini adalah sebuah struktur pembungkus berisi bidang identitas skema. Strukturnya berisi:

    • SchemaId$SchemaArn: Nama Sumber Daya Amazon (ARN) dari skema. Baik SchemaArn, atau SchemaName dan RegistryName harus disediakan.

    • SchemaId$SchemaName: Nama skema. Baik SchemaArn, atau SchemaName dan RegistryName harus disediakan.

  • MaxResults — Nomor (bilangan bulat), tidak kurang dari 1 atau lebih dari 100.

    Jumlah maksimum hasil yang diperlukan untuk setiap halaman. Jika nilai tidak diberikan, maka diatur ke nilai default 25 per halaman.

  • NextToken— UTF -8 string.

    Sebuah token kelanjutan, jika ini adalah panggilan kelanjutan.

Respons
  • Schemas – Susunan objek SchemaVersionListItem.

    Susunan objek SchemaVersionList yang berisi detail dari setiap versi skema.

  • NextToken— UTF -8 string.

    Sebuah token kelanjutan untuk pemberian nomor halaman untuk daftar token yang ditampilkan, dikembalikan jika segmen saat ini dari daftar tersebut bukan yang terakhir.

Kesalahan
  • InvalidInputException

  • AccessDeniedException

  • EntityNotFoundException

  • InternalServiceException

GetSchemaVersion tindakan (Python: get_schema_version)

Mendapatkan skema yang ditentukan oleh ID uniknya yang ditetapkan ketika versi skema dibuat atau didaftarkan. Versi skema dengan status Dihapus tidak akan disertakan dalam hasil.

Permintaan
  • SchemaId — Sebuah objek SchemaId.

    Ini adalah sebuah struktur pembungkus berisi bidang identitas skema. Strukturnya berisi:

    • SchemaId$SchemaArn: Nama Sumber Daya Amazon (ARN) dari skema. Baik SchemaArn, atau SchemaName dan RegistryName harus disediakan.

    • SchemaId$SchemaName: Nama skema. Baik SchemaArn, atau SchemaName dan RegistryName harus disediakan.

  • SchemaVersionId- UTF -8 string, tidak kurang dari 36 atau lebih dari 36 byte panjang, cocok dengan. Custom string pattern #17

    SchemaVersionId dari versi skema. Kolom ini diperlukan untuk mengambil berdasarkan ID skema. Baik ini atau pembungkus SchemaId harus disediakan.

  • SchemaVersionNumber — Sebuah objek SchemaVersionNumber.

    Nomor versi dari skema.

Respons
  • SchemaVersionId- UTF -8 string, tidak kurang dari 36 atau lebih dari 36 byte panjang, cocok dengan. Custom string pattern #17

    SchemaVersionId dari versi skema.

  • SchemaDefinition- UTF -8 string, tidak kurang dari 1 atau lebih dari 170000 byte panjang, cocok dengan. Custom string pattern #33

    Definisi skema untuk ID skema.

  • DataFormat— UTF -8 string (nilai valid: AVRO | JSON |PROTOBUF).

    Format data dari definisi skema. Saat iniAVRO, JSON dan PROTOBUF didukung.

  • SchemaArn- UTF -8 string, tidak kurang dari 1 atau lebih dari 10240 byte panjang, cocok dengan. Custom string pattern #22

    Nama Sumber Daya Amazon (ARN) dari skema.

  • VersionNumber — Nomor (bilangan bulat), tidak kurang dari 1 atau lebih dari 100000.

    Nomor versi dari skema.

  • Status— UTF -8 string (nilai valid: AVAILABLE | | PENDING FAILURE |DELETING).

    Status versi skema.

  • CreatedTime— UTF -8 string.

    Tanggal dan waktu saat versi skema dibuat.

Kesalahan
  • InvalidInputException

  • AccessDeniedException

  • EntityNotFoundException

  • InternalServiceException

GetSchemaVersionsDiff tindakan (Python: get_schema_versions_diff)

Mengambil perbedaan versi skema dalam jenis perbedaan yang ditentukan antara dua versi skema yang disimpan di Registri Skema.

Ini API memungkinkan Anda untuk membandingkan dua versi skema antara dua definisi skema di bawah skema yang sama.

Permintaan
  • SchemaIdWajib: Sebuah objek SchemaId.

    Ini adalah sebuah struktur pembungkus berisi bidang identitas skema. Strukturnya berisi:

    • SchemaId$SchemaArn: Nama Sumber Daya Amazon (ARN) dari skema. Salah satu dari SchemaArn atau SchemaName harus disediakan.

    • SchemaId$SchemaName: Nama skema. Salah satu dari SchemaArn atau SchemaName harus disediakan.

  • FirstSchemaVersionNumberWajib: Sebuah objek SchemaVersionNumber.

    Versi skema yang pertama dari dua versi skema yang akan dibandingkan.

  • SecondSchemaVersionNumberWajib: Sebuah objek SchemaVersionNumber.

    Versi skema yang kedua dari dua versi skema yang akan dibandingkan.

  • SchemaDiffType- Diperlukan: UTF -8 string (nilai valid:SYNTAX_DIFF).

    Mengacu pada SYNTAX_DIFF, yang merupakan tipe perbedaan yang didukung saat ini.

Respons
  • Diff- UTF -8 string, tidak kurang dari 1 atau lebih dari 340000 byte panjang, cocok dengan. Custom string pattern #33

    Perbedaan antara skema sebagai string dalam JsonPatch format.

Kesalahan
  • InvalidInputException

  • EntityNotFoundException

  • AccessDeniedException

  • InternalServiceException

ListRegistries tindakan (Python: list_registries)

Mengembalikan sebuah daftar registri yang telah Anda buat, dengan informasi registri yang minimal. Registri yang sedang dalam status Deleting tidak akan dimasukkan dalam hasil. Hasil kosong akan dikembalikan jika tidak ada registri yang tersedia.

Permintaan
  • MaxResults — Nomor (bilangan bulat), tidak kurang dari 1 atau lebih dari 100.

    Jumlah maksimum hasil yang diperlukan untuk setiap halaman. Jika nilai tidak diberikan, maka diatur ke nilai default 25 per halaman.

  • NextToken— UTF -8 string.

    Sebuah token kelanjutan, jika ini adalah panggilan kelanjutan.

Respons
  • Registries – Susunan objek RegistryListItem.

    Susunan objek RegistryDetailedListItem yang berisi detail minimal dari setiap registri.

  • NextToken— UTF -8 string.

    Sebuah token kelanjutan untuk pemberian nomor halaman untuk daftar token yang ditampilkan, dikembalikan jika segmen saat ini dari daftar tersebut bukan yang terakhir.

Kesalahan
  • InvalidInputException

  • AccessDeniedException

  • InternalServiceException

ListSchemas tindakan (Python: list_schemas)

Mengembalikan sebuah daftar skema dengan detail yang minimal. Skema dengan status Menghapus tidak akan disertakan dalam hasil. Hasil kosong akan dikembalikan jika tidak ada skema yang tersedia.

Ketika tidak RegistryId disediakan, semua skema di seluruh pendaftar akan menjadi bagian dari tanggapan. API

Permintaan
  • RegistryId — Sebuah objek RegistryId.

    Struktur pembungkus yang mungkin berisi nama registri dan Amazon Resource Name (ARN).

  • MaxResults — Nomor (bilangan bulat), tidak kurang dari 1 atau lebih dari 100.

    Jumlah maksimum hasil yang diperlukan untuk setiap halaman. Jika nilai tidak diberikan, maka diatur ke nilai default 25 per halaman.

  • NextToken— UTF -8 string.

    Sebuah token kelanjutan, jika ini adalah panggilan kelanjutan.

Respons
  • Schemas – Susunan objek SchemaListItem.

    Susunan objek SchemaListItem yang berisi detail dari setiap skema.

  • NextToken— UTF -8 string.

    Sebuah token kelanjutan untuk pemberian nomor halaman untuk daftar token yang ditampilkan, dikembalikan jika segmen saat ini dari daftar tersebut bukan yang terakhir.

Kesalahan
  • InvalidInputException

  • AccessDeniedException

  • EntityNotFoundException

  • InternalServiceException

RegisterSchemaVersion tindakan (Python: register_schema_version)

Menambahkan sebuah versi baru untuk skema yang ada. Mengembalikan sebuah kesalahan jika skema versi baru tidak memenuhi persyaratan kompatibilitas set skema. Ini tidak API akan membuat set skema baru dan akan mengembalikan kesalahan 404 jika set skema belum ada di Registri Skema.

Jika ini adalah definisi skema pertama yang terdaftar di Schema Registry, ini API akan menyimpan versi skema dan segera kembali. Jika tidak, panggilan ini memiliki potensi untuk berjalan lebih lama daripada operasi lain karena mode kompatibilitas. Anda dapat memanggil GetSchemaVersion API dengan SchemaVersionId untuk memeriksa mode kompatibilitas.

Jika definisi skema yang sama sudah disimpan dalam Registri Skema sebagai sebuah versi, maka ID skema dari skema yang ada akan dikembalikan ke pemanggil.

Permintaan
  • SchemaIdWajib: Sebuah objek SchemaId.

    Ini adalah sebuah struktur pembungkus berisi bidang identitas skema. Strukturnya berisi:

    • SchemaId$SchemaArn: Nama Sumber Daya Amazon (ARN) dari skema. Baik SchemaArn, atau SchemaName dan RegistryName harus disediakan.

    • SchemaId$SchemaName: Nama skema. Baik SchemaArn, atau SchemaName dan RegistryName harus disediakan.

  • SchemaDefinition- Diperlukan: UTF -8 string, panjangnya tidak kurang dari 1 atau lebih dari 170000 byte, cocok dengan. Custom string pattern #33

    Definisi skema menggunakan pengaturan DataFormat untuk SchemaName.

Respons
  • SchemaVersionId- UTF -8 string, tidak kurang dari 36 atau lebih dari 36 byte panjang, cocok dengan. Custom string pattern #17

    ID unik yang mewakili versi skema ini.

  • VersionNumber — Nomor (bilangan bulat), tidak kurang dari 1 atau lebih dari 100000.

    Versi skema ini (untuk aliran sinkronisasi saja, jika ini adalah versi pertama).

  • Status— UTF -8 string (nilai valid: AVAILABLE | | PENDING FAILURE |DELETING).

    Status versi skema.

Kesalahan
  • InvalidInputException

  • AccessDeniedException

  • EntityNotFoundException

  • ResourceNumberLimitExceededException

  • ConcurrentModificationException

  • InternalServiceException

UpdateSchema tindakan (Python: update_schema)

Memperbarui deskripsi, pengaturan kompatibilitas, atau versi pos pemeriksaan untuk sebuah set skema.

Untuk memperbarui pengaturan kompatibilitas, panggilan tidak akan memvalidasi kompatibilitas untuk seluruh rangkaian versi skema dengan pengaturan kompatibilitas baru. Jika nilai untuk Compatibility disediakan, maka VersionNumber (pos pemeriksaan) juga diperlukan. APIAkan memvalidasi nomor versi pos pemeriksaan untuk konsistensi.

Jika nilai untuk VersionNumber (pos pemeriksaan) disediakan, maka Compatibility bersifat opsional dan ini dapat digunakan untuk mengatur/me-reset pos pemeriksaan untuk skema tersebut.

Pembaruan ini hanya akan terjadi jika skema dalam AVAILABLE keadaan.

Permintaan
  • SchemaIdWajib: Sebuah objek SchemaId.

    Ini adalah sebuah struktur pembungkus berisi bidang identitas skema. Strukturnya berisi:

    • SchemaId$SchemaArn: Nama Sumber Daya Amazon (ARN) dari skema. Salah satu dari SchemaArn atau SchemaName harus disediakan.

    • SchemaId$SchemaName: Nama skema. Salah satu dari SchemaArn atau SchemaName harus disediakan.

  • SchemaVersionNumber — Sebuah objek SchemaVersionNumber.

    Nomor versi yang diperlukan untuk melakukan pemeriksaan. Salah satu dari VersionNumber atau Compatibility harus disediakan.

  • Compatibility— UTF -8 string (nilai yang valid: NONE DISABLED | BACKWARD | BACKWARD_ALL | FORWARD | FORWARD_ALL FULL |FULL_ALL).

    Pengaturan kompatibilitas baru untuk skema.

  • Description — String deskripsi, dengan panjang tidak lebih dari 2048 byte, yang cocok dengan URI address multi-line string pattern.

    Deskripsi baru untuk skema.

Respons
  • SchemaArn- UTF -8 string, tidak kurang dari 1 atau lebih dari 10240 byte panjang, cocok dengan. Custom string pattern #22

    Nama Sumber Daya Amazon (ARN) dari skema.

  • SchemaName- UTF -8 string, tidak kurang dari 1 atau lebih dari 255 byte panjang, cocok dengan. Custom string pattern #18

    Nama skema.

  • RegistryName- UTF -8 string, tidak kurang dari 1 atau lebih dari 255 byte panjang, cocok dengan. Custom string pattern #18

    Nama registri yang berisi skema.

Kesalahan
  • InvalidInputException

  • AccessDeniedException

  • EntityNotFoundException

  • ConcurrentModificationException

  • InternalServiceException

CheckSchemaVersionValidity tindakan (Python: check_schema_version_validity)

Memvalidasi skema yang disediakan. Panggilan ini tidak memiliki efek samping, ia hanya memvalidasi dengan menggunakan skema yang disediakan dengan menggunakan DataFormat sebagai formatnya. Karena tidak mengambil nama set skema, maka tidak ada pemeriksaan kompatibilitas yang dilakukan.

Permintaan
  • DataFormat- Diperlukan: UTF -8 string (nilai valid: AVRO | JSON |PROTOBUF).

    Format data dari definisi skema. Saat iniAVRO, JSON dan PROTOBUF didukung.

  • SchemaDefinition- Diperlukan: UTF -8 string, panjangnya tidak kurang dari 1 atau lebih dari 170000 byte, cocok dengan. Custom string pattern #33

    Definisi skema yang harus divalidasi.

Respons
  • Valid – Boolean.

    Mengembalikan BETUL, jika skema ini valid, dan mengembalikan SALAH, jika skema tidak valid.

  • Error- UTF -8 string, panjangnya tidak kurang dari 1 atau lebih dari 5000 byte.

    Pesan kesalahan kegagalan validasi.

Kesalahan
  • InvalidInputException

  • AccessDeniedException

  • InternalServiceException

UpdateRegistry tindakan (Python: update_registry)

Memperbarui registri yang ada yang digunakan untuk menyimpan koleksi skema. Properti yang diperbarui berhubungan dengan registri, dan tidak mengubah salah satu skema dalam registri tersebut.

Permintaan
  • RegistryIdWajib: Sebuah objek RegistryId.

    Ini adalah struktur pembungkus yang mungkin berisi nama registri dan Amazon Resource Name (ARN).

  • DescriptionWajib: String deskripsi, dengan panjang tidak lebih dari 2048 byte, yang cocok dengan URI address multi-line string pattern.

    Sebuah deskripsi registri. Jika deskripsi tidak tersedia, maka bidang ini tidak akan diperbarui.

Respons
  • RegistryName- UTF -8 string, tidak kurang dari 1 atau lebih dari 255 byte panjang, cocok dengan. Custom string pattern #18

    Nama registri yang diperbarui.

  • RegistryArn- UTF -8 string, tidak kurang dari 1 atau lebih dari 10240 byte panjang, cocok dengan. Custom string pattern #22

    Nama Sumber Daya Amazon (ARN) dari registri yang diperbarui.

Kesalahan
  • InvalidInputException

  • AccessDeniedException

  • EntityNotFoundException

  • ConcurrentModificationException

  • InternalServiceException

GetSchemaByDefinition tindakan (Python: get_schema_by_definition)

Mengambil sebuah skema berdasarkan SchemaDefinition. Definisi skema dikirim ke Registri Skema, di-kanonikalisasi, dan di-hash. Jika hash dicocokkan dalam lingkup SchemaName or ARN (atau registri default, jika tidak ada yang disediakan), metadata skema itu dikembalikan. Jika tidak, 404 atau NotFound kesalahan dikembalikan. Versi skema dengan status Deleted tidak akan disertakan dalam hasil.

Permintaan
  • SchemaIdWajib: Sebuah objek SchemaId.

    Ini adalah sebuah struktur pembungkus berisi bidang identitas skema. Strukturnya berisi:

    • SchemaId$SchemaArn: Nama Sumber Daya Amazon (ARN) dari skema. Salah satu dari SchemaArn atau SchemaName harus disediakan.

    • SchemaId$SchemaName: Nama skema. Salah satu dari SchemaArn atau SchemaName harus disediakan.

  • SchemaDefinition- Diperlukan: UTF -8 string, panjangnya tidak kurang dari 1 atau lebih dari 170000 byte, cocok dengan. Custom string pattern #33

    Definisi skema yang diwajibkan detail skema untuknya.

Respons
  • SchemaVersionId- UTF -8 string, tidak kurang dari 36 atau lebih dari 36 byte panjang, cocok dengan. Custom string pattern #17

    ID skema dari versi skema.

  • SchemaArn- UTF -8 string, tidak kurang dari 1 atau lebih dari 10240 byte panjang, cocok dengan. Custom string pattern #22

    Nama Sumber Daya Amazon (ARN) dari skema.

  • DataFormat— UTF -8 string (nilai valid: AVRO | JSON |PROTOBUF).

    Format data dari definisi skema. Saat iniAVRO, JSON dan PROTOBUF didukung.

  • Status— UTF -8 string (nilai valid: AVAILABLE | | PENDING FAILURE |DELETING).

    Status versi skema.

  • CreatedTime— UTF -8 string.

    Tanggal dan waktu saat sebuah skema dibuat.

Kesalahan
  • InvalidInputException

  • AccessDeniedException

  • EntityNotFoundException

  • InternalServiceException

GetRegistry tindakan (Python: get_registry)

Menjelaskan registri yang ditentukan secara detail.

Permintaan
  • RegistryIdWajib: Sebuah objek RegistryId.

    Ini adalah struktur pembungkus yang mungkin berisi nama registri dan Amazon Resource Name (ARN).

Respons
  • RegistryName- UTF -8 string, tidak kurang dari 1 atau lebih dari 255 byte panjang, cocok dengan. Custom string pattern #18

    Nama registri.

  • RegistryArn- UTF -8 string, tidak kurang dari 1 atau lebih dari 10240 byte panjang, cocok dengan. Custom string pattern #22

    Nama Sumber Daya Amazon (ARN) dari registri.

  • Description — String deskripsi, dengan panjang tidak lebih dari 2048 byte, yang cocok dengan URI address multi-line string pattern.

    Sebuah deskripsi registri.

  • Status— UTF -8 string (nilai valid: AVAILABLE |DELETING).

    Status registri.

  • CreatedTime— UTF -8 string.

    Tanggal dan waktu saat registri dibuat.

  • UpdatedTime— UTF -8 string.

    Tanggal dan waktu saat registri diperbarui.

Kesalahan
  • InvalidInputException

  • AccessDeniedException

  • EntityNotFoundException

  • InternalServiceException

PutSchemaVersionMetadata tindakan (Python: put_schema_version_metadata)

Menempatkan pasangan nilai kunci metadata untuk ID versi skema yang ditentukan. Maksimal 10 pasangan nilai kunci akan diizinkan untuk setiap versi skema. Mereka dapat ditambahkan lebih dari satu atau beberapa panggilan.

Permintaan
  • SchemaId — Sebuah objek SchemaId.

    ID unik untuk skema.

  • SchemaVersionNumber — Sebuah objek SchemaVersionNumber.

    Nomor versi dari skema.

  • SchemaVersionId- UTF -8 string, tidak kurang dari 36 atau lebih dari 36 byte panjang, cocok dengan. Custom string pattern #17

    ID versi unik dari versi skema.

  • MetadataKeyValueWajib: Sebuah objek MetadataKeyValuePair.

    Nilai yang sesuai kunci metadata.

Respons
  • SchemaArn- UTF -8 string, tidak kurang dari 1 atau lebih dari 10240 byte panjang, cocok dengan. Custom string pattern #22

    Amazon Resource Name (ARN) untuk skema.

  • SchemaName- UTF -8 string, tidak kurang dari 1 atau lebih dari 255 byte panjang, cocok dengan. Custom string pattern #18

    Nama untuk skema.

  • RegistryName- UTF -8 string, tidak kurang dari 1 atau lebih dari 255 byte panjang, cocok dengan. Custom string pattern #18

    Nama untuk registri.

  • LatestVersion – Boolean.

    Skema versi terbaru.

  • VersionNumber — Nomor (bilangan bulat), tidak kurang dari 1 atau lebih dari 100000.

    Nomor versi dari skema.

  • SchemaVersionId- UTF -8 string, tidak kurang dari 36 atau lebih dari 36 byte panjang, cocok dengan. Custom string pattern #17

    ID versi unik dari versi skema.

  • MetadataKey- UTF -8 string, tidak kurang dari 1 atau lebih dari 128 byte panjang, cocok dengan. Custom string pattern #34

    Kunci metadata.

  • MetadataValue- UTF -8 string, tidak kurang dari 1 atau lebih dari 256 byte panjang, cocok dengan. Custom string pattern #34

    Nilai dari kunci metadata.

Kesalahan
  • InvalidInputException

  • AccessDeniedException

  • AlreadyExistsException

  • EntityNotFoundException

  • ResourceNumberLimitExceededException

QuerySchemaVersionMetadata tindakan (Python: query_schema_version_metadata)

Kueri untuk informasi metadata versi skema.

Permintaan
  • SchemaId — Sebuah objek SchemaId.

    Struktur pembungkus yang mungkin berisi nama skema dan Amazon Resource Name ()ARN.

  • SchemaVersionNumber — Sebuah objek SchemaVersionNumber.

    Nomor versi dari skema.

  • SchemaVersionId- UTF -8 string, tidak kurang dari 36 atau lebih dari 36 byte panjang, cocok dengan. Custom string pattern #17

    ID versi unik dari versi skema.

  • MetadataList – Susunan objek MetadataKeyValuePair.

    Mencari pasangan nilai kunci untuk metadata, jika mereka tidak disediakan, maka semua informasi metadata akan diambil.

  • MaxResults — Nomor (bilangan bulat), tidak kurang dari 1 atau lebih dari 50.

    Jumlah maksimum hasil yang diperlukan untuk setiap halaman. Jika nilai tidak diberikan, maka diatur ke nilai default 25 per halaman.

  • NextToken— UTF -8 string.

    Sebuah token kelanjutan, jika ini adalah panggilan kelanjutan.

Respons
  • MetadataInfoMap – Susunan peta pasangan nilai kunci.

    Setiap kunci adalah string UTF -8, tidak kurang dari 1 atau lebih dari 128 byte panjang, cocok dengan. Custom string pattern #34

    Setiap nilai adalah sebuah objek MetadataInfo A.

    Sebuah peta kunci metadata dan nilai-nilai yang dikaitkan.

  • SchemaVersionId- UTF -8 string, tidak kurang dari 36 atau lebih dari 36 byte panjang, cocok dengan. Custom string pattern #17

    ID versi unik dari versi skema.

  • NextToken— UTF -8 string.

    Sebuah token kelanjutan untuk pemberian nomor halaman untuk daftar token yang ditampilkan, dikembalikan jika segmen saat ini dari daftar tersebut bukan yang terakhir.

Kesalahan
  • InvalidInputException

  • AccessDeniedException

  • EntityNotFoundException

RemoveSchemaVersionMetadata tindakan (Python: remove_schema_version_metadata)

Menghapus sebuah pasangan nilai kunci dari metadata versi skema untuk ID versi skema yang ditentukan.

Permintaan
  • SchemaId — Sebuah objek SchemaId.

    Struktur pembungkus yang mungkin berisi nama skema dan Amazon Resource Name ()ARN.

  • SchemaVersionNumber — Sebuah objek SchemaVersionNumber.

    Nomor versi dari skema.

  • SchemaVersionId- UTF -8 string, tidak kurang dari 36 atau lebih dari 36 byte panjang, cocok dengan. Custom string pattern #17

    ID versi unik dari versi skema.

  • MetadataKeyValueWajib: Sebuah objek MetadataKeyValuePair.

    Nilai dari kunci metadata.

Respons
  • SchemaArn- UTF -8 string, tidak kurang dari 1 atau lebih dari 10240 byte panjang, cocok dengan. Custom string pattern #22

    Nama Sumber Daya Amazon (ARN) dari skema.

  • SchemaName- UTF -8 string, tidak kurang dari 1 atau lebih dari 255 byte panjang, cocok dengan. Custom string pattern #18

    Nama skema.

  • RegistryName- UTF -8 string, tidak kurang dari 1 atau lebih dari 255 byte panjang, cocok dengan. Custom string pattern #18

    Nama registri.

  • LatestVersion – Boolean.

    Skema versi terbaru.

  • VersionNumber — Nomor (bilangan bulat), tidak kurang dari 1 atau lebih dari 100000.

    Nomor versi dari skema.

  • SchemaVersionId- UTF -8 string, tidak kurang dari 36 atau lebih dari 36 byte panjang, cocok dengan. Custom string pattern #17

    ID versi untuk versi skema.

  • MetadataKey- UTF -8 string, tidak kurang dari 1 atau lebih dari 128 byte panjang, cocok dengan. Custom string pattern #34

    Kunci metadata.

  • MetadataValue- UTF -8 string, tidak kurang dari 1 atau lebih dari 256 byte panjang, cocok dengan. Custom string pattern #34

    Nilai dari kunci metadata.

Kesalahan
  • InvalidInputException

  • AccessDeniedException

  • EntityNotFoundException

DeleteRegistry tindakan (Python: delete_registry)

Menghapus registri secara keseluruhan termasuk skema dan semua versinya. Untuk mendapatkan status operasi hapus, Anda dapat memanggil GetRegistry API setelah panggilan asinkron. Menghapus registri akan menonaktifkan semua operasi online untuk registri sepertiUpdateRegistry,, CreateSchemaUpdateSchema, dan. RegisterSchemaVersion APIs

Permintaan
  • RegistryIdWajib: Sebuah objek RegistryId.

    Ini adalah struktur pembungkus yang mungkin berisi nama registri dan Amazon Resource Name (ARN).

Respons
  • RegistryName- UTF -8 string, tidak kurang dari 1 atau lebih dari 255 byte panjang, cocok dengan. Custom string pattern #18

    Nama registri yang sedang dihapus.

  • RegistryArn- UTF -8 string, tidak kurang dari 1 atau lebih dari 10240 byte panjang, cocok dengan. Custom string pattern #22

    Nama Sumber Daya Amazon (ARN) dari registri yang sedang dihapus.

  • Status— UTF -8 string (nilai valid: AVAILABLE |DELETING).

    Status registri. Sebuah operasi yang sukses akan mengembalikan status Deleting.

Kesalahan
  • InvalidInputException

  • EntityNotFoundException

  • AccessDeniedException

  • ConcurrentModificationException

DeleteSchema tindakan (Python: delete_schema)

Menghapus seluruh set skema, termasuk set skema dan semua versinya. Untuk mendapatkan status operasi hapus, Anda dapat menelepon GetSchema API setelah panggilan asinkron. Menghapus registri akan menonaktifkan semua operasi online untuk skema, seperti, danGetSchemaByDefinition. RegisterSchemaVersion APIs

Permintaan
  • SchemaIdWajib: Sebuah objek SchemaId.

    Ini adalah struktur pembungkus yang mungkin berisi nama skema dan Amazon Resource Name ()ARN.

Respons
  • SchemaArn- UTF -8 string, tidak kurang dari 1 atau lebih dari 10240 byte panjang, cocok dengan. Custom string pattern #22

    Nama Sumber Daya Amazon (ARN) dari skema yang dihapus.

  • SchemaName- UTF -8 string, tidak kurang dari 1 atau lebih dari 255 byte panjang, cocok dengan. Custom string pattern #18

    Nama dari skema yang sedang dihapus.

  • Status— UTF -8 string (nilai valid: AVAILABLE | PENDING |DELETING).

    Status skema.

Kesalahan
  • InvalidInputException

  • EntityNotFoundException

  • AccessDeniedException

  • ConcurrentModificationException

DeleteSchemaVersions tindakan (Python: delete_schema_versions)

Menghapus versi skema yang ditentukan. Nomor versi atau rentang versi mungkin disediakan. Jika mode kompatibilitas melarang penghapusan versi yang diperlukan, seperti BACKWARDS _FULL, kesalahan dikembalikan. Memanggil GetSchemaVersions API setelah panggilan ini akan mencantumkan status versi yang dihapus.

Ketika rentang nomor versi berisi versi yang ditunjuk periksa, API akan mengembalikan konflik 409 dan tidak akan melanjutkan penghapusan. Anda harus menghapus pos pemeriksaan terlebih dahulu menggunakan DeleteSchemaCheckpoint API sebelum menggunakan iniAPI.

Anda tidak dapat menggunakan DeleteSchemaVersions API untuk menghapus versi skema pertama dalam kumpulan skema. Versi skema pertama hanya dapat dihapus oleh. DeleteSchema API Operasi ini juga akan menghapus SchemaVersionMetadata yang dilampirkan pada versi skema. Hapus paksa akan diberlakukan pada basis data.

Jika mode kompatibilitas melarang penghapusan versi yang diperlukan, seperti BACKWARDS _FULL, kesalahan dikembalikan.

Permintaan
  • SchemaIdWajib: Sebuah objek SchemaId.

    Ini adalah struktur pembungkus yang mungkin berisi nama skema dan Amazon Resource Name ()ARN.

  • Versions- Diperlukan: UTF -8 string, panjangnya tidak kurang dari 1 atau lebih dari 100000 byte, cocok dengan. Custom string pattern #35

    Rentang versi dapat diberikan, mungkin dalam format:

    • nomor versi tunggal, 5

    • rentang, 5-8: menghapus versi 5, 6, 7, 8

Respons
  • SchemaVersionErrors – Susunan objek SchemaVersionErrorItem.

    Sebuah daftar objek SchemaVersionErrorItem, masing-masing berisi kesalahan dan versi skema.

Kesalahan
  • InvalidInputException

  • EntityNotFoundException

  • AccessDeniedException

  • ConcurrentModificationException