RequestPrepareOptions interface

Alternativ för att förbereda en utgående HTTP-begäran.

Egenskaper

abortSignal

Signal för en avbruten styrenhet. Kan användas för att avbryta både skicka en nätverksbegäran och vänta på ett svar.

baseUrl

Bas-URL:en för begäran. Standardvärdet är: "https://management.azure.com". Detta gäller endast för pathTemplate. Om du tillhandahåller options.url förväntas du ange den fullständiga URL:en.

body

Begärandetexten. Det kan vara av vilken typ som helst. Det här värdet serialiseras om det inte är en ström.

bodyIsStream

Anger om begärandetexten är en ström (användbart för filuppladdningsscenarier).

deserializationMapper

Innehåller information om hur du deserialiserar svarstexten.

disableClientRequestId

När värdet är true instruerar du klienten att inte ange rubriken "x-ms-client-request-id" till ett nytt Guid().

disableJsonStringifyOnBody

Anger om den här metoden ska JSON.stringify() begärandetexten. Standardvärde: false.

formData

Formulärdata som används för att skapa begärandetexten.

headers

En ordlista med begärandehuvuden som måste tillämpas på begäran. Här är nyckeln "header-name" och värdet är "header-value". Huvudvärdet MÅSTE vara av typen sträng.

  • ContentType måste anges med nyckelnamnet som "Innehållstyp". Standardvärdet "application/json; charset=utf-8".
  • "Transfer-Encoding" är inställt på "segmenterad" som standard om "options.bodyIsStream" är inställt på true.
  • "Content-Type" är inställt på "application/octet-stream" som standard om "options.bodyIsStream" är inställt på true.
  • "accept-language" är som standard inställt på "en-US"
  • "x-ms-client-request-id" är som standard inställt på ett nytt guid. Om du inte vill generera ett guid för begäran anger du options.disableClientRequestId till true
mappers

En ordlista med mappare som kan användas under [de]serialisering.

method

HTTP-begärandemetoden. Giltiga värden är "GET", "PUT", "HEAD", "DELETE", "OPTIONS", "POST" eller "PATCH".

onDownloadProgress

Gör det möjligt att hålla reda på förloppet för nedladdning av inkommande svar.

onUploadProgress

Tillåter att du håller reda på förloppet för att ladda upp den utgående begäran.

pathParameters

En ordlista med sökvägsparametrar som måste ersättas med faktiska värden i pathTemplate. Här är nyckeln "path-parameter-name" och värdet är "path-parameter-value". "path-parameter-value" kan vara av typen "sträng" eller så kan det vara av typen "objekt". Formatet "object" ska användas när du vill hoppa över URL-kodning. När objektformatet används måste objektet ha en egenskap med namnet value som tillhandahåller "path-parameter-value". Exempel:

  • path-parameter-value i "object"-format: { "path-parameter-name": { value: "path-parameter-value", skipUrlEncoding: true } }
  • path-parameter-value i "string"-format: { "path-parameter-name": "path-parameter-value" }.
pathTemplate

Sökvägsmallen för begärande-URL:en. Ange antingen "url" eller ange "pathTemplate" i alternativobjektet. Båda alternativen är ömsesidigt uteslutande. Exempel: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}

queryParameters

En ordlista med frågeparametrar som ska läggas till i URL:en, där "nyckeln" är "query-parameter-name" och "value" är "query-parameter-value". "query-parameter-value" kan vara av typen "string" eller så kan det vara av typen "object". Formatet "object" ska användas när du vill hoppa över URL-kodning. När objektformatet används måste objektet ha en egenskap med namnet value som tillhandahåller "query-parameter-value". Exempel:

  • query-parameter-value i "object"-format: { "query-parameter-name": { value: "query-parameter-value", skipUrlEncoding: true } }
  • query-parameter-value i "string"-format: { "query-parameter-name": "query-parameter-value"}. Obs! "Om options.url redan har några frågeparametrar läggs värdet i options.queryParameters till i URL:en.
serializationMapper

Innehåller information om hur du serialiserar begärandetexten.

spanOptions

Spårning: Alternativ som används för att skapa ett spann när spårning är aktiverat.

tracingContext

Spårning: Kontext som används när du skapar intervall.

url

Begärande-URL:en. Den kanske har frågeparametrar i den. Ange antingen "url" eller ange "pathTemplate" i alternativobjektet. Båda alternativen är ömsesidigt uteslutande.

Egenskapsinformation

abortSignal

Signal för en avbruten styrenhet. Kan användas för att avbryta både skicka en nätverksbegäran och vänta på ett svar.

abortSignal?: AbortSignalLike

Egenskapsvärde

baseUrl

Bas-URL:en för begäran. Standardvärdet är: "https://management.azure.com". Detta gäller endast för pathTemplate. Om du tillhandahåller options.url förväntas du ange den fullständiga URL:en.

baseUrl?: string

Egenskapsvärde

string

body

Begärandetexten. Det kan vara av vilken typ som helst. Det här värdet serialiseras om det inte är en ström.

body?: any

Egenskapsvärde

any

bodyIsStream

Anger om begärandetexten är en ström (användbart för filuppladdningsscenarier).

bodyIsStream?: boolean

Egenskapsvärde

boolean

deserializationMapper

Innehåller information om hur du deserialiserar svarstexten.

deserializationMapper?: Record<string, unknown>

Egenskapsvärde

Record<string, unknown>

disableClientRequestId

När värdet är true instruerar du klienten att inte ange rubriken "x-ms-client-request-id" till ett nytt Guid().

disableClientRequestId?: boolean

Egenskapsvärde

boolean

disableJsonStringifyOnBody

Anger om den här metoden ska JSON.stringify() begärandetexten. Standardvärde: false.

disableJsonStringifyOnBody?: boolean

Egenskapsvärde

boolean

formData

Formulärdata som används för att skapa begärandetexten.

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

Egenskapsvärde

{[key: string]: any}

headers

En ordlista med begärandehuvuden som måste tillämpas på begäran. Här är nyckeln "header-name" och värdet är "header-value". Huvudvärdet MÅSTE vara av typen sträng.

  • ContentType måste anges med nyckelnamnet som "Innehållstyp". Standardvärdet "application/json; charset=utf-8".
  • "Transfer-Encoding" är inställt på "segmenterad" som standard om "options.bodyIsStream" är inställt på true.
  • "Content-Type" är inställt på "application/octet-stream" som standard om "options.bodyIsStream" är inställt på true.
  • "accept-language" är som standard inställt på "en-US"
  • "x-ms-client-request-id" är som standard inställt på ett nytt guid. Om du inte vill generera ett guid för begäran anger du options.disableClientRequestId till true
headers?: {[key: string]: any}

Egenskapsvärde

{[key: string]: any}

mappers

En ordlista med mappare som kan användas under [de]serialisering.

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

Egenskapsvärde

{[x: string]: any}

method

HTTP-begärandemetoden. Giltiga värden är "GET", "PUT", "HEAD", "DELETE", "OPTIONS", "POST" eller "PATCH".

method: HttpMethods

Egenskapsvärde

onDownloadProgress

Gör det möjligt att hålla reda på förloppet för nedladdning av inkommande svar.

onDownloadProgress?: (progress: TransferProgressEvent) => void

Egenskapsvärde

(progress: TransferProgressEvent) => void

onUploadProgress

Tillåter att du håller reda på förloppet för att ladda upp den utgående begäran.

onUploadProgress?: (progress: TransferProgressEvent) => void

Egenskapsvärde

(progress: TransferProgressEvent) => void

pathParameters

En ordlista med sökvägsparametrar som måste ersättas med faktiska värden i pathTemplate. Här är nyckeln "path-parameter-name" och värdet är "path-parameter-value". "path-parameter-value" kan vara av typen "sträng" eller så kan det vara av typen "objekt". Formatet "object" ska användas när du vill hoppa över URL-kodning. När objektformatet används måste objektet ha en egenskap med namnet value som tillhandahåller "path-parameter-value". Exempel:

  • path-parameter-value i "object"-format: { "path-parameter-name": { value: "path-parameter-value", skipUrlEncoding: true } }
  • path-parameter-value i "string"-format: { "path-parameter-name": "path-parameter-value" }.
pathParameters?: {[key: string]: any | ParameterValue}

Egenskapsvärde

{[key: string]: any | ParameterValue}

pathTemplate

Sökvägsmallen för begärande-URL:en. Ange antingen "url" eller ange "pathTemplate" i alternativobjektet. Båda alternativen är ömsesidigt uteslutande. Exempel: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}

pathTemplate?: string

Egenskapsvärde

string

queryParameters

En ordlista med frågeparametrar som ska läggas till i URL:en, där "nyckeln" är "query-parameter-name" och "value" är "query-parameter-value". "query-parameter-value" kan vara av typen "string" eller så kan det vara av typen "object". Formatet "object" ska användas när du vill hoppa över URL-kodning. När objektformatet används måste objektet ha en egenskap med namnet value som tillhandahåller "query-parameter-value". Exempel:

  • query-parameter-value i "object"-format: { "query-parameter-name": { value: "query-parameter-value", skipUrlEncoding: true } }
  • query-parameter-value i "string"-format: { "query-parameter-name": "query-parameter-value"}. Obs! "Om options.url redan har några frågeparametrar läggs värdet i options.queryParameters till i URL:en.
queryParameters?: {[key: string]: any | ParameterValue}

Egenskapsvärde

{[key: string]: any | ParameterValue}

serializationMapper

Innehåller information om hur du serialiserar begärandetexten.

serializationMapper?: Mapper

Egenskapsvärde

spanOptions

Spårning: Alternativ som används för att skapa ett spann när spårning är aktiverat.

spanOptions?: SpanOptions

Egenskapsvärde

@azure/core-tracing.SpanOptions

tracingContext

Spårning: Kontext som används när du skapar intervall.

tracingContext?: Context

Egenskapsvärde

@azure/core-tracing.Context

url

Begärande-URL:en. Den kanske har frågeparametrar i den. Ange antingen "url" eller ange "pathTemplate" i alternativobjektet. Båda alternativen är ömsesidigt uteslutande.

url?: string

Egenskapsvärde

string