RequestPrepareOptions interface
Alternativ för att förbereda en utgående HTTP-begäran.
Egenskaper
abort |
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. |
base |
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. |
body |
Anger om begärandetexten är en ström (användbart för filuppladdningsscenarier). |
deserialization |
Innehåller information om hur du deserialiserar svarstexten. |
disable |
När värdet är true instruerar du klienten att inte ange rubriken "x-ms-client-request-id" till ett nytt Guid(). |
disable |
Anger om den här metoden ska JSON.stringify() begärandetexten. Standardvärde: false. |
form |
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.
|
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". |
on |
Gör det möjligt att hålla reda på förloppet för nedladdning av inkommande svar. |
on |
Tillåter att du håller reda på förloppet för att ladda upp den utgående begäran. |
path |
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 |
Sökvägsmallen för begärande-URL:en. Ange antingen "url" eller ange "pathTemplate" i alternativobjektet. Båda alternativen är ömsesidigt uteslutande.
Exempel: |
query |
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:
|
serialization |
Innehåller information om hur du serialiserar begärandetexten. |
span |
Spårning: Alternativ som används för att skapa ett spann när spårning är aktiverat. |
tracing |
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
tracingContext
Spårning: Kontext som används när du skapar intervall.
tracingContext?: Context
Egenskapsvärde
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