WriteRequest

طلب كائن ByteStream.Write.

تمثيل JSON
{
  "resourceName": string,
  "writeOffset": string,
  "finishWrite": boolean,
  "data": string
}
الحقول
resourceName

string

اسم المورد المطلوب كتابته. يجب ضبط هذا الإعداد في أول WriteRequest من كل إجراء Write(). وإذا تم ضبطها على الطلبات اللاحقة، يجب أن تتطابق مع قيمة الطلب الأول.

writeOffset

string (int64 format)

يشير ذلك المصطلح إلى الإزاحة من بداية المورد الذي يجب كتابة البيانات فيه. يجب ملء هذا الحقل على جميع WriteRequest.

في أول WriteRequest من إجراء Write()، تشير إلى الإزاحة الأولية لاستدعاء Write(). القيمة يجب أن تكون مساوية لقيمة committedSize التي سيتم عرضها عند الاتصال بالرقم QueryWriteStatus().

وفي الاستدعاءات اللاحقة، يجب ضبط هذه القيمة ويجب أن تساوي مجموع writeOffset الأول وأحجام جميع حِزم data التي تم إرسالها سابقًا في مصدر البيانات هذا.

ستؤدي القيمة غير الصحيحة إلى حدوث خطأ.

finishWrite

boolean

إذا كانت true، يشير ذلك إلى اكتمال عملية الكتابة. سيؤدي إرسال أي WriteRequest بعد ذلك إلى عنوان يكون finishWrite فيه true إلى حدوث خطأ.

data

string (bytes format)

جزء من بيانات المورد. قد يترك العميل data فارغًا لأي WriteRequest محدَّد. ويتيح ذلك للعميل إبلاغ الخدمة بأنّ الطلب لا يزال منشورًا أثناء تشغيل عملية لإنشاء المزيد من البيانات.

سلسلة بترميز base64.