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 #45Nama registri. Digunakan hanya untuk pencarian. Salah satu dari
RegistryArn
atauRegistryName
harus disediakan. -
RegistryArn
- UTF -8 string, tidak kurang dari 1 atau lebih dari 10240 byte panjang, cocok dengan. Custom string pattern #49Arn dari registri yang akan diperbarui. Salah satu dari
RegistryArn
atauRegistryName
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 #45Nama registri.
-
RegistryArn
- UTF -8 string, tidak kurang dari 1 atau lebih dari 10240 byte panjang, cocok dengan. Custom string pattern #49Nama 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 #14Nilai 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 #14Nilai 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 #45Nama registri tempat skema berada.
-
SchemaName
- UTF -8 string, tidak kurang dari 1 atau lebih dari 255 byte panjang, cocok dengan. Custom string pattern #45Nama skema.
-
SchemaArn
- UTF -8 string, tidak kurang dari 1 atau lebih dari 10240 byte panjang, cocok dengan. Custom string pattern #49Amazon 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 #49Nama 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 #44Pengenal 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 #14Sebuah kunci metadata.
-
MetadataValue
- UTF -8 string, tidak kurang dari 1 atau lebih dari 256 byte panjang, cocok dengan. Custom string pattern #14Nilai 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 #49Nama Sumber Daya Amazon (ARN) dari skema. Salah satu dari
SchemaArn
atauSchemaName
harus disediakan. -
SchemaName
- UTF -8 string, tidak kurang dari 1 atau lebih dari 255 byte panjang, cocok dengan. Custom string pattern #45Nama skema. Salah satu dari
SchemaArn
atauSchemaName
harus disediakan. -
RegistryName
- UTF -8 string, tidak kurang dari 1 atau lebih dari 255 byte panjang, cocok dengan. Custom string pattern #45Nama registri skema yang berisi skema.
Operasi
GetSchemaVersionsDiff tindakan (Python: get_schema_versions_diff)
RegisterSchemaVersion tindakan (Python: register_schema_version)
CheckSchemaVersionValidity tindakan (Python: check_schema_version_validity)
GetSchemaByDefinition tindakan (Python: get_schema_by_definition)
PutSchemaVersionMetadata tindakan (Python: put_schema_version_metadata)
QuerySchemaVersionMetadata tindakan (Python: query_schema_version_metadata)
RemoveSchemaVersionMetadata tindakan (Python: remove_schema_version_metadata)
DeleteSchemaVersions tindakan (Python: delete_schema_versions)
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 #45Nama 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 #49Nama 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 #45Nama 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 #45Nama 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 ini
AVRO
,JSON
danPROTOBUF
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 #13Definisi skema menggunakan pengaturan
DataFormat
untukSchemaName
.
Respons
-
RegistryName
- UTF -8 string, tidak kurang dari 1 atau lebih dari 255 byte panjang, cocok dengan. Custom string pattern #45Nama registri.
-
RegistryArn
- UTF -8 string, tidak kurang dari 1 atau lebih dari 10240 byte panjang, cocok dengan. Custom string pattern #49Nama 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 #45Nama skema.
-
SchemaArn
- UTF -8 string, tidak kurang dari 1 atau lebih dari 10240 byte panjang, cocok dengan. Custom string pattern #49Nama 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 ini
AVRO
,JSON
danPROTOBUF
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 #44Pengenal 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
-
SchemaId
— Wajib: 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
, atauSchemaName
danRegistryName
harus disediakan. -
SchemaId$SchemaName: Nama skema. Baik
SchemaArn
, atauSchemaName
danRegistryName
harus disediakan.
-
Respons
-
RegistryName
- UTF -8 string, tidak kurang dari 1 atau lebih dari 255 byte panjang, cocok dengan. Custom string pattern #45Nama registri.
-
RegistryArn
- UTF -8 string, tidak kurang dari 1 atau lebih dari 10240 byte panjang, cocok dengan. Custom string pattern #49Nama 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 #45Nama skema.
-
SchemaArn
- UTF -8 string, tidak kurang dari 1 atau lebih dari 10240 byte panjang, cocok dengan. Custom string pattern #49Nama 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 ini
AVRO
,JSON
danPROTOBUF
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
-
SchemaId
— Wajib: 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
, atauSchemaName
danRegistryName
harus disediakan. -
SchemaId$SchemaName: Nama skema. Baik
SchemaArn
, atauSchemaName
danRegistryName
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
, atauSchemaName
danRegistryName
harus disediakan. -
SchemaId$SchemaName: Nama skema. Baik
SchemaArn
, atauSchemaName
danRegistryName
harus disediakan.
-
-
SchemaVersionId
- UTF -8 string, tidak kurang dari 36 atau lebih dari 36 byte panjang, cocok dengan. Custom string pattern #44SchemaVersionId
dari versi skema. Kolom ini diperlukan untuk mengambil berdasarkan ID skema. Baik ini atau pembungkusSchemaId
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 #44SchemaVersionId
dari versi skema. -
SchemaDefinition
- UTF -8 string, tidak kurang dari 1 atau lebih dari 170000 byte panjang, cocok dengan. Custom string pattern #13Definisi skema untuk ID skema.
-
DataFormat
— UTF -8 string (nilai valid:AVRO
|JSON
|PROTOBUF
).Format data dari definisi skema. Saat ini
AVRO
,JSON
danPROTOBUF
didukung. -
SchemaArn
- UTF -8 string, tidak kurang dari 1 atau lebih dari 10240 byte panjang, cocok dengan. Custom string pattern #49Nama 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
-
SchemaId
— Wajib: 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
atauSchemaName
harus disediakan. -
SchemaId$SchemaName: Nama skema. Salah satu dari
SchemaArn
atauSchemaName
harus disediakan.
-
-
FirstSchemaVersionNumber
— Wajib: Sebuah objek SchemaVersionNumber.Versi skema yang pertama dari dua versi skema yang akan dibandingkan.
-
SecondSchemaVersionNumber
— Wajib: 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 #13Perbedaan 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
-
SchemaId
— Wajib: 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
, atauSchemaName
danRegistryName
harus disediakan. -
SchemaId$SchemaName: Nama skema. Baik
SchemaArn
, atauSchemaName
danRegistryName
harus disediakan.
-
-
SchemaDefinition
- Diperlukan: UTF -8 string, panjangnya tidak kurang dari 1 atau lebih dari 170000 byte, cocok dengan. Custom string pattern #13Definisi skema menggunakan pengaturan
DataFormat
untukSchemaName
.
Respons
-
SchemaVersionId
- UTF -8 string, tidak kurang dari 36 atau lebih dari 36 byte panjang, cocok dengan. Custom string pattern #44ID 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
-
SchemaId
— Wajib: 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
atauSchemaName
harus disediakan. -
SchemaId$SchemaName: Nama skema. Salah satu dari
SchemaArn
atauSchemaName
harus disediakan.
-
-
SchemaVersionNumber
— Sebuah objek SchemaVersionNumber.Nomor versi yang diperlukan untuk melakukan pemeriksaan. Salah satu dari
VersionNumber
atauCompatibility
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 #49Nama 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 #45Nama skema.
-
RegistryName
- UTF -8 string, tidak kurang dari 1 atau lebih dari 255 byte panjang, cocok dengan. Custom string pattern #45Nama 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 ini
AVRO
,JSON
danPROTOBUF
didukung. -
SchemaDefinition
- Diperlukan: UTF -8 string, panjangnya tidak kurang dari 1 atau lebih dari 170000 byte, cocok dengan. Custom string pattern #13Definisi 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
-
RegistryId
— Wajib: Sebuah objek RegistryId.Ini adalah struktur pembungkus yang mungkin berisi nama registri dan Amazon Resource Name (ARN).
-
Description
— Wajib: 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 #45Nama registri yang diperbarui.
-
RegistryArn
- UTF -8 string, tidak kurang dari 1 atau lebih dari 10240 byte panjang, cocok dengan. Custom string pattern #49Nama 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
-
SchemaId
— Wajib: 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
atauSchemaName
harus disediakan. -
SchemaId$SchemaName: Nama skema. Salah satu dari
SchemaArn
atauSchemaName
harus disediakan.
-
-
SchemaDefinition
- Diperlukan: UTF -8 string, panjangnya tidak kurang dari 1 atau lebih dari 170000 byte, cocok dengan. Custom string pattern #13Definisi 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 #44ID skema dari versi skema.
-
SchemaArn
- UTF -8 string, tidak kurang dari 1 atau lebih dari 10240 byte panjang, cocok dengan. Custom string pattern #49Nama Sumber Daya Amazon (ARN) dari skema.
-
DataFormat
— UTF -8 string (nilai valid:AVRO
|JSON
|PROTOBUF
).Format data dari definisi skema. Saat ini
AVRO
,JSON
danPROTOBUF
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
-
RegistryId
— Wajib: 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 #45Nama registri.
-
RegistryArn
- UTF -8 string, tidak kurang dari 1 atau lebih dari 10240 byte panjang, cocok dengan. Custom string pattern #49Nama 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 #44ID versi unik dari versi skema.
-
MetadataKeyValue
— Wajib: 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 #49Amazon Resource Name (ARN) untuk skema.
-
SchemaName
- UTF -8 string, tidak kurang dari 1 atau lebih dari 255 byte panjang, cocok dengan. Custom string pattern #45Nama untuk skema.
-
RegistryName
- UTF -8 string, tidak kurang dari 1 atau lebih dari 255 byte panjang, cocok dengan. Custom string pattern #45Nama 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 #44ID versi unik dari versi skema.
-
MetadataKey
- UTF -8 string, tidak kurang dari 1 atau lebih dari 128 byte panjang, cocok dengan. Custom string pattern #14Kunci metadata.
-
MetadataValue
- UTF -8 string, tidak kurang dari 1 atau lebih dari 256 byte panjang, cocok dengan. Custom string pattern #14Nilai 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 #44ID 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 #14
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 #44ID 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 #44ID versi unik dari versi skema.
-
MetadataKeyValue
— Wajib: 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 #49Nama 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 #45Nama skema.
-
RegistryName
- UTF -8 string, tidak kurang dari 1 atau lebih dari 255 byte panjang, cocok dengan. Custom string pattern #45Nama 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 #44ID versi untuk versi skema.
-
MetadataKey
- UTF -8 string, tidak kurang dari 1 atau lebih dari 128 byte panjang, cocok dengan. Custom string pattern #14Kunci metadata.
-
MetadataValue
- UTF -8 string, tidak kurang dari 1 atau lebih dari 256 byte panjang, cocok dengan. Custom string pattern #14Nilai 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
,, CreateSchema
UpdateSchema
, dan. RegisterSchemaVersion
APIs
Permintaan
-
RegistryId
— Wajib: 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 #45Nama registri yang sedang dihapus.
-
RegistryArn
- UTF -8 string, tidak kurang dari 1 atau lebih dari 10240 byte panjang, cocok dengan. Custom string pattern #49Nama 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
-
SchemaId
— Wajib: 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 #49Nama 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 #45Nama 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
-
SchemaId
— Wajib: 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 #15Rentang 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