RequestPrepareOptions interface

  • 參考
套件:
@azure/ms-rest-js

屬性

abortSignal
baseUrl

要求的基底 URL。 預設值為：「 https://management.azure.com" ;。 這僅適用于 pathTemplate。 如果您要提供 options.url，則您預期會提供完整的 URL。
body

要求本文。 它可以是任何類型的。 如果此值不是資料流程，則會序列化此值。
bodyIsStream

指出要求本文是否為數據流， (適用于檔案上傳案例) 。
deserializationMapper

提供有關如何還原序列化回應本文的資訊。
disableClientRequestId

當設定為 true 時，會指示用戶端不要將 「x-ms-client-request-id」 標頭設定為新的 Guid () 。
disableJsonStringifyOnBody

指出這個方法是否應該 JSON.stringify () 要求本文。 預設值：false。
formData
headers

要求標頭的字典，需要套用至要求。 這裡的索引鍵是 「header-name」，而值是 「header-value」。 標頭值必須是字串類型。

  • ContentType 必須以索引鍵名稱提供為 「Content-Type」。 預設值 「application/json;charset=utf-8」。
  • 如果 「options.bodyIsStream」 設定為 true，預設會將 「Transfer-Encoding」 設定為 「區塊化」。
  • 如果 「options.bodyIsStream」 設定為 true，則 「Content-Type」 預設會設定為 「application/octet-stream」。
  • 預設會將 「accept-language」 設定為 「en-US」
  • 根據預設，「x-ms-client-request-id」 會設定為新的 Guid。 若要不產生要求的 GUID，請將 options.disableClientRequestId 設為 true
mappers

在 [de]序列化時可能使用的對應器的字典。
method

HTTP 要求方法。 有效值為 「GET」、「PUT」、「HEAD」、「DELETE」、「OPTIONS」、「POST」 或 「PATCH」。
onDownloadProgress
onUploadProgress
pathParameters

路徑參數的字典，必須以 pathTemplate 中的實際值取代。 這裡的索引鍵是 「path-parameter-name」，而此值是 「path-parameter-value」。 「path-parameter-value」 可以是 「string」 類型，也可以是 「object」 類型。 當您想要略過 URL 編碼時，應該使用 「object」 格式。 使用物件格式時，物件必須具有具名值的屬性，以提供 「path-parameter-value」。 範例：

  • path-parameter-value in 「object」 format： { 「path-parameter-name」： { value： 「path-parameter-value」， skipUrlEncoding： true } }
  • 「string」 格式為 path-parameter-value： { 「path-parameter-name」： 「path-parameter-value」 }。
pathTemplate

要求 URL 的路徑範本。 提供 「url」 或在 options 物件中提供 「pathTemplate」。 這兩個選項互斥。 範例：「/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}」
queryParameters

要附加至 URL 的查詢參數字典，其中 「key」 是 「query-parameter-name」，而 「value」 是 「query-parameter-value」。 「query-parameter-value」 可以是 「string」 類型，也可以是 「object」 類型。 當您想要略過 URL 編碼時，應該使用 「object」 格式。 使用物件格式時，物件必須具有名為 value 的屬性，以提供 「query-parameter-value」。 範例：

  • 「object」 格式的 query-parameter-value： { 「query-parameter-name」： { value： 「query-parameter-value」， skipUrlEncoding： true } }
  • 「string」 格式的 query-parameter-value： { 「query-parameter-name」： 「query-parameter-value」}。 注意：「如果 options.url 已經有一些查詢參數，則 options.queryParameters 中提供的值將會附加至 URL。
redirectLimit

限制此要求所遵循的重新導向數目。 如果設定為 0，將不會遵循重新導向。 如果保留未定義，則會套用基礎node_fetch的預設重新導向行為。
serializationMapper

提供有關如何序列化要求本文的資訊。
streamResponseBody
url

要求 URL。 它可能或可能沒有查詢參數。 提供 「url」 或在 options 物件中提供 「pathTemplate」。 這兩個選項互斥。

屬性詳細資料

abortSignal 

abortSignal?: AbortSignalLike

屬性值

AbortSignalLike

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 () 要求本文。 預設值：false。

disableJsonStringifyOnBody?: boolean

屬性值

boolean

formData 

formData?: {[key: string]: any}

屬性值

{[key: string]: any}

headers

要求標頭的字典，需要套用至要求。 這裡的索引鍵是 「header-name」，而值是 「header-value」。 標頭值必須是字串類型。

  • ContentType 必須以索引鍵名稱提供為 「Content-Type」。 預設值 「application/json;charset=utf-8」。
  • 如果 「options.bodyIsStream」 設定為 true，預設會將 「Transfer-Encoding」 設定為 「區塊化」。
  • 如果 「options.bodyIsStream」 設定為 true，則 「Content-Type」 預設會設定為 「application/octet-stream」。
  • 預設會將 「accept-language」 設定為 「en-US」
  • 根據預設，「x-ms-client-request-id」 會設定為新的 Guid。 若要不產生要求的 GUID，請將 options.disableClientRequestId 設為 true
headers?: {[key: string]: any}

屬性值

{[key: string]: any}

mappers

在 [de]序列化時可能使用的對應器的字典。

mappers?: {[x: string]: any}

屬性值

{[x: string]: any}

method

HTTP 要求方法。 有效值為 「GET」、「PUT」、「HEAD」、「DELETE」、「OPTIONS」、「POST」 或 「PATCH」。

method: HttpMethods

屬性值

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 編碼時，應該使用 「object」 格式。 使用物件格式時，物件必須具有具名值的屬性，以提供 「path-parameter-value」。 範例：

  • path-parameter-value in 「object」 format： { 「path-parameter-name」： { value： 「path-parameter-value」， skipUrlEncoding： true } }
  • 「string」 格式為 path-parameter-value： { 「path-parameter-name」： 「path-parameter-value」 }。
pathParameters?: {[key: string]: any | ParameterValue}

屬性值

{[key: string]: any | ParameterValue}

pathTemplate

要求 URL 的路徑範本。 提供 「url」 或在 options 物件中提供 「pathTemplate」。 這兩個選項互斥。 範例：「/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}」

pathTemplate?: string

屬性值

string

queryParameters

要附加至 URL 的查詢參數字典，其中 「key」 是 「query-parameter-name」，而 「value」 是 「query-parameter-value」。 「query-parameter-value」 可以是 「string」 類型，也可以是 「object」 類型。 當您想要略過 URL 編碼時，應該使用 「object」 格式。 使用物件格式時，物件必須具有名為 value 的屬性，以提供 「query-parameter-value」。 範例：

  • 「object」 格式的 query-parameter-value： { 「query-parameter-name」： { value： 「query-parameter-value」， skipUrlEncoding： true } }
  • 「string」 格式的 query-parameter-value： { 「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

提供有關如何序列化要求本文的資訊。

serializationMapper?: Mapper

屬性值

Mapper

streamResponseBody 

streamResponseBody?: boolean

屬性值

boolean

url

要求 URL。 它可能或可能沒有查詢參數。 提供 「url」 或在 options 物件中提供 「pathTemplate」。 這兩個選項互斥。

url?: string

屬性值

string