RequestPrepareOptions interface
الخصائص
abort |
|
base |
عنوان URL الأساسي للطلب. القيمة الافتراضية هي: "https://management.azure.com". ينطبق هذا فقط مع pathTemplate. إذا كنت توفر options.url فمن المتوقع أن توفر عنوان url الكامل. |
body | نص الطلب. يمكن أن يكون من أي نوع. سيتم تسلسل هذه القيمة إذا لم تكن دفق. |
body |
يشير إلى ما إذا كان نص الطلب عبارة عن دفق (مفيد لسيناريوهات تحميل الملفات). |
deserialization |
يوفر معلومات حول كيفية إلغاء تسلسل نص الاستجابة. |
disable |
عند التعيين إلى true، يوجه العميل إلى عدم تعيين عنوان "x-ms-client-request-id" إلى Guid جديد(). |
disable |
يشير إلى ما إذا كان يجب أن يكون هذا الأسلوب JSON.stringify() نص الطلب. القيمة الافتراضية: خطأ. |
form |
|
headers | قاموس لرؤوس الطلبات التي يجب تطبيقها على الطلب. هنا يكون المفتاح هو "اسم الرأس" والقيمة هي "قيمة الرأس". يجب أن تكون قيمة العنوان من سلسلة النوع.
|
mappers | قاموس معينات يمكن استخدامه أثناء [de]serialization. |
method | أسلوب طلب HTTP. القيم الصالحة هي "GET" أو "PUT" أو "HEAD" أو "DELETE" أو "OPTIONS" أو "POST" أو "PATCH". |
on |
|
on |
|
path |
قاموس معلمات المسار التي تحتاج إلى استبدال بقيم فعلية في pathTemplate. هنا المفتاح هو "path-parameter-name" والقيمة هي "path-parameter-value". يمكن أن يكون "path-parameter-value" من النوع "string" أو يمكن أن يكون من النوع "object". يجب استخدام تنسيق "الكائن" عندما تريد تخطي ترميز عنوان URL. أثناء استخدام تنسيق الكائن، يجب أن يكون للكائن خاصية تسمى القيمة التي توفر "path-parameter-value". مثل:
|
path |
قالب مسار عنوان URL للطلب. إما توفير "url" أو توفير "pathTemplate" في عنصر الخيارات. كلا الخيارين يستبعد أحدهما الآخر. مثال: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}" |
query |
قاموس معلمات الاستعلام المراد إلحاقها بعنوان URL، حيث يكون "المفتاح" هو "اسم معلمة الاستعلام" و"القيمة" هي "قيمة معلمة الاستعلام". يمكن أن يكون "query-parameter-value" من النوع "سلسلة" أو يمكن أن يكون من النوع "كائن". يجب استخدام تنسيق "الكائن" عندما تريد تخطي ترميز عنوان URL. أثناء استخدام تنسيق الكائن، يجب أن يكون للكائن خاصية تسمى القيمة التي توفر "query-parameter-value". مثل:
|
redirect |
حدد عدد عمليات إعادة التوجيه المتبعة لهذا الطلب. إذا تم تعيينه إلى 0، فلن يتم اتباع عمليات إعادة التوجيه. إذا ترك غير محدد، تطبيق سلوك إعادة التوجيه الافتراضي node_fetch الأساسي. |
serialization |
يوفر معلومات حول كيفية تسلسل نص الطلب. |
stream |
|
url | عنوان URL للطلب. قد يكون أو لا يحتوي على معلمات استعلام فيه. إما توفير "url" أو توفير "pathTemplate" في عنصر الخيارات. كلا الخيارين يستبعد أحدهما الآخر. |
تفاصيل الخاصية
abortSignal
baseUrl
عنوان URL الأساسي للطلب. القيمة الافتراضية هي: "https://management.azure.com". ينطبق هذا فقط مع pathTemplate. إذا كنت توفر options.url فمن المتوقع أن توفر عنوان url الكامل.
baseUrl?: string
قيمة الخاصية
string
body
نص الطلب. يمكن أن يكون من أي نوع. سيتم تسلسل هذه القيمة إذا لم تكن دفق.
body?: any
قيمة الخاصية
any
bodyIsStream
يشير إلى ما إذا كان نص الطلب عبارة عن دفق (مفيد لسيناريوهات تحميل الملفات).
bodyIsStream?: boolean
قيمة الخاصية
boolean
deserializationMapper
يوفر معلومات حول كيفية إلغاء تسلسل نص الاستجابة.
deserializationMapper?: object
قيمة الخاصية
object
disableClientRequestId
عند التعيين إلى true، يوجه العميل إلى عدم تعيين عنوان "x-ms-client-request-id" إلى Guid جديد().
disableClientRequestId?: boolean
قيمة الخاصية
boolean
disableJsonStringifyOnBody
يشير إلى ما إذا كان يجب أن يكون هذا الأسلوب JSON.stringify() نص الطلب. القيمة الافتراضية: خطأ.
disableJsonStringifyOnBody?: boolean
قيمة الخاصية
boolean
formData
formData?: {[key: string]: any}
قيمة الخاصية
{[key: string]: any}
headers
قاموس لرؤوس الطلبات التي يجب تطبيقها على الطلب. هنا يكون المفتاح هو "اسم الرأس" والقيمة هي "قيمة الرأس". يجب أن تكون قيمة العنوان من سلسلة النوع.
- يجب توفير ContentType مع اسم المفتاح ك "نوع المحتوى". القيمة الافتراضية "application/json; charset=utf-8".
- يتم تعيين "Transfer-Encoding" إلى "chunked" بشكل افتراضي إذا تم تعيين "options.bodyIsStream" إلى true.
- يتم تعيين "نوع المحتوى" إلى "application/octet-stream" بشكل افتراضي إذا تم تعيين "options.bodyIsStream" إلى true.
- يتم تعيين "قبول اللغة" بشكل افتراضي إلى "en-US"
- يتم تعيين "x-ms-client-request-id" بشكل افتراضي إلى Guid جديد. لعدم إنشاء guid للطلب، يرجى تعيين options.disableClientRequestId إلى true
headers?: {[key: string]: any}
قيمة الخاصية
{[key: string]: any}
mappers
قاموس معينات يمكن استخدامه أثناء [de]serialization.
mappers?: {[x: string]: any}
قيمة الخاصية
{[x: string]: any}
method
أسلوب طلب HTTP. القيم الصالحة هي "GET" أو "PUT" أو "HEAD" أو "DELETE" أو "OPTIONS" أو "POST" أو "PATCH".
method: HttpMethods
قيمة الخاصية
onDownloadProgress
onDownloadProgress?: (progress: TransferProgressEvent) => void
قيمة الخاصية
(progress: TransferProgressEvent) => void
onUploadProgress
onUploadProgress?: (progress: TransferProgressEvent) => void
قيمة الخاصية
(progress: TransferProgressEvent) => void
pathParameters
قاموس معلمات المسار التي تحتاج إلى استبدال بقيم فعلية في pathTemplate. هنا المفتاح هو "path-parameter-name" والقيمة هي "path-parameter-value". يمكن أن يكون "path-parameter-value" من النوع "string" أو يمكن أن يكون من النوع "object". يجب استخدام تنسيق "الكائن" عندما تريد تخطي ترميز عنوان URL. أثناء استخدام تنسيق الكائن، يجب أن يكون للكائن خاصية تسمى القيمة التي توفر "path-parameter-value". مثل:
- path-parameter-value بتنسيق "object": { "path-parameter-name": { value: "path-parameter-value", skipUrlEncoding: true }
- path-parameter-value بتنسيق "string": { "path-parameter-name": "path-parameter-value" }.
pathParameters?: {[key: string]: any | ParameterValue}
قيمة الخاصية
{[key: string]: any | ParameterValue}
pathTemplate
قالب مسار عنوان URL للطلب. إما توفير "url" أو توفير "pathTemplate" في عنصر الخيارات. كلا الخيارين يستبعد أحدهما الآخر. مثال: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}"
pathTemplate?: string
قيمة الخاصية
string
queryParameters
قاموس معلمات الاستعلام المراد إلحاقها بعنوان URL، حيث يكون "المفتاح" هو "اسم معلمة الاستعلام" و"القيمة" هي "قيمة معلمة الاستعلام". يمكن أن يكون "query-parameter-value" من النوع "سلسلة" أو يمكن أن يكون من النوع "كائن". يجب استخدام تنسيق "الكائن" عندما تريد تخطي ترميز عنوان URL. أثناء استخدام تنسيق الكائن، يجب أن يكون للكائن خاصية تسمى القيمة التي توفر "query-parameter-value". مثل:
- query-parameter-value بتنسيق "object": { "query-parameter-name": { value: "query-parameter-value", skipUrlEncoding: true } }
- query-parameter-value بتنسيق "string": { "query-parameter-name": "query-parameter-value"}. ملاحظة: "إذا كانت options.url تحتوي بالفعل على بعض معلمات الاستعلام، إلحاق القيمة المتوفرة في options.queryParameters بعنوان url.
queryParameters?: {[key: string]: any | ParameterValue}
قيمة الخاصية
{[key: string]: any | ParameterValue}
redirectLimit
حدد عدد عمليات إعادة التوجيه المتبعة لهذا الطلب. إذا تم تعيينه إلى 0، فلن يتم اتباع عمليات إعادة التوجيه. إذا ترك غير محدد، تطبيق سلوك إعادة التوجيه الافتراضي node_fetch الأساسي.
redirectLimit?: number
قيمة الخاصية
number
serializationMapper
streamResponseBody
streamResponseBody?: boolean
قيمة الخاصية
boolean
url
عنوان URL للطلب. قد يكون أو لا يحتوي على معلمات استعلام فيه. إما توفير "url" أو توفير "pathTemplate" في عنصر الخيارات. كلا الخيارين يستبعد أحدهما الآخر.
url?: string
قيمة الخاصية
string