Kirim Batch Properti
Mengirimkan batch properti.
Mengirimkan batch operasi properti. Baik semua atau tidak ada operasi yang akan dilakukan.
Minta
Metode | URI Permintaan |
---|---|
POST | /Names/{nameId}/$/GetProperties/$/SubmitBatch?api-version=6.0&timeout={timeout} |
Parameter
Nama | Jenis | Diperlukan | Lokasi |
---|---|---|---|
nameId |
string | Ya | Jalur |
api-version |
string | Ya | Kueri |
timeout |
bilangan bulat (int64) | Tidak | Kueri |
PropertyBatchDescriptionList |
PropertyBatchDescriptionList | Ya | Isi |
nameId
Jenis: string
Diperlukan: Ya
Nama Service Fabric, tanpa skema URI 'fabric:'.
api-version
Jenis: string
Diperlukan: Ya
Default: 6.0
Versi API. Parameter ini diperlukan dan nilainya harus '6.0'.
Versi SERVICE Fabric REST API didasarkan pada versi runtime tempat API diperkenalkan atau diubah. Runtime Service Fabric mendukung lebih dari satu versi API. Ini adalah versi TERBARU api yang didukung. Jika versi API yang lebih rendah diteruskan, respons yang dikembalikan mungkin berbeda dari yang didokumenkan dalam spesifikasi ini.
Selain itu, runtime menerima versi apa pun yang lebih tinggi dari versi terbaru yang didukung hingga versi runtime saat ini. Jadi jika versi API terbaru adalah 6.0, tetapi jika runtime adalah 6.1, untuk mempermudah penulisan klien, runtime akan menerima versi 6.1 untuk API tersebut. Namun perilaku API akan sesuai versi 6.0 yang didokumentasikan.
timeout
Jenis: bilangan bulat (int64)
Diperlukan: Tidak
Default: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1
Batas waktu server untuk melakukan operasi dalam hitungan detik. Batas waktu ini menentukan durasi waktu klien bersedia menunggu operasi yang diminta selesai. Nilai default untuk parameter ini adalah 60 detik.
PropertyBatchDescriptionList
Jenis: PropertyBatchDescriptionList
Diperlukan: Ya
Menjelaskan operasi batch properti yang akan dikirimkan.
Respons
Kode Status HTTP | Deskripsi | Skema Respons |
---|---|---|
200 (OK) | Respons yang berhasil berarti bahwa batch properti berhasil. |
SuccessfulPropertyBatchInfo |
409 (Konflik) | Respons 409 berarti bahwa salah satu operasi batch properti gagal, dan berisi informasi lebih lanjut tentang kegagalan tersebut. Tidak ada operasi yang dilakukan. |
FailedPropertyBatchInfo |
Semua kode status lainnya | Respons kesalahan terperinci. |
FabricError |
Contoh
Operasi batch properti
Contoh ini menunjukkan cara mengirimkan batch properti. Batch ini memastikan bahwa properti ada, memeriksa apakah properti memiliki nomor urutan yang diharapkan, dan mengedit properti hanya jika kondisi sebelumnya berhasil. Kemudian melakukan operasi get untuk mendapatkan info properti saat ini. Jika semua operasi berhasil, batch dilakukan secara transaksi dan respons keberhasilan dikembalikan dengan kode status 200. Jika batch gagal, respons yang gagal dikembalikan dengan kode status 409. Respons yang gagal di bawah ini menunjukkan kegagalan batch karena properti tidak memiliki nomor urutan yang diharapkan.
Minta
POST http://localhost:19080/Names/samples/apps/$/GetProperties/$/SubmitBatch?api-version=6.0
Isi
{
"Operations": [
{
"Kind": "CheckExists",
"PropertyName": "PersistentQueueAppData",
"Exists": true
},
{
"Kind": "CheckSequence",
"PropertyName": "PersistentQueueAppData",
"SequenceNumber": "12"
},
{
"Kind": "Put",
"PropertyName": "PersistentQueueAppData",
"Value": {
"Kind": "Binary",
"Data": [
"1",
"2",
"3",
"4",
"5"
]
},
"CustomTypeId": "InitializationData"
},
{
"Kind": "Get",
"PropertyName": "PersistentQueueAppData",
"IncludeValue": false
}
]
}
Respons 200
Isi
{
"Kind": "Successful",
"Properties": {
"3": {
"Name": "PersistentQueueAppData",
"Metadata": {
"TypeId": "Binary",
"CustomTypeId": "InitializationData",
"Parent": "fabric:/samples/apps",
"SizeInBytes": "5",
"LastModifiedUtcTimestamp": "2017-07-17T05:01:19.049Z",
"SequenceNumber": "13"
}
}
}
}
Respons 409
Isi
{
"Kind": "Failed",
"ErrorMessage": "FABRIC_E_PROPERTY_CHECK_FAILED",
"OperationIndex": "1"
}