RequestPrepareOptions interface

Csomag:

@azure/core-http

A kimenő HTTP-kérések előkészítésének lehetőségei.

Tulajdonságok

abortSignal	Megszakító vezérlő jele. A hálózati kérések küldésének megszakítására és a válaszra való várakozásra is használható.
baseUrl	A kérelem alap URL-címe. Az alapértelmezett érték a következő: "https://management.azure.com". Ez csak a pathTemplate esetén alkalmazható. Ha a options.url címet adja meg, akkor a teljes URL-címet kell megadnia.
body	A kérelem törzse. Bármilyen típusú lehet. Ez az érték szerializálva lesz, ha nem stream.
bodyIsStream	Azt jelzi, hogy a kérelemtörzs stream-e (a fájlfeltöltési forgatókönyvekben hasznos).
deserializationMapper	A válasz törzsének deszerializálásáról nyújt információt.
disableClientRequestId	Ha igaz értékre van állítva, arra utasítja az ügyfelet, hogy ne állítsa az "x-ms-client-request-id" fejlécet új GUID() értékre.
disableJsonStringifyOnBody	Azt jelzi, hogy ennek a metódusnak jSON.stringify() kell-e a kérelem törzsét. Alapértelmezett érték: hamis.
formData	Űrlapadatok, amelyeket a kérelem törzsének létrehozásához használunk.
headers	A kérelemfejlécek szótára, amelyet a kérelemre kell alkalmazni. Itt a kulcs a "fejléc-név", az érték pedig a "fejléc-érték". A fejléc-értéknek sztring típusúnak kell lennie. A ContentType kulcsnevet "Content-Type" néven kell megadni. Alapértelmezett érték : "application/json; charset=utf-8". A "Transfer-Encoding" értéke alapértelmezés szerint "darabolt", ha a "options.bodyIsStream" értéke igaz. A "Content-Type" értéke alapértelmezés szerint "application/octet-stream", ha a "options.bodyIsStream" értéke igaz. Az "accept-language" alapértelmezés szerint az "en-US" értékre van állítva Az "x-ms-client-request-id" alapértelmezés szerint egy új guid értékre van állítva. Ha nem szeretne guid-t létrehozni a kéréshez, állítsa a options.disableClientRequestId értéket true (igaz) értékre.
mappers	A [de]szerializálás során használható leképezők szótára.
method	A HTTP-kérelem metódusa. Az érvényes értékek a következők: "GET", "PUT", "HEAD", "DELETE", "OPTIONS", "POST", vagy "PATCH".
onDownloadProgress	Lehetővé teszi a bejövő válasz letöltésének előrehaladásának nyomon követését.
onUploadProgress	Lehetővé teszi a kimenő kérés feltöltésének előrehaladásának nyomon követését.
pathParameters	Az elérésiút-paraméterek szótára, amelyet a pathTemplate tényleges értékeivel kell helyettesíteni. Itt a kulcs a "path-parameter-name", az érték pedig a "path-parameter-value". A "path-parameter-value" típus lehet "sztring" vagy "object" típusú. Az url-kódolás kihagyásakor az "object" formátumot kell használni. Az objektumformátum használata során az objektumnak egy nevű tulajdonságmal kell rendelkeznie, amely a "path-parameter-value" értéket adja meg. Példa: path-parameter-value in "object" format: { "path-parameter-name": { value: "path-parameter-value", skipUrlEncoding: true } } path-parameter-value in "string" format: { "path-parameter-name": "path-parameter-value" }.
pathTemplate	A kérelem URL-címének elérésiút-sablonja. Adja meg az "url"-t, vagy adja meg a "pathTemplate" értéket a beállításobjektumban. Mindkét lehetőség kölcsönösen kizárja egymást. Például: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}
queryParameters	Az URL-címhez hozzáfűzendő lekérdezési paraméterek szótára, ahol a "kulcs" a "query-parameter-name", az "érték" pedig a "query-parameter-value". A "query-parameter-value" típus lehet "sztring" vagy "object" típusú. Az url-kódolás kihagyásakor az "object" formátumot kell használni. Az objektumformátum használata során az objektumnak egy nevű tulajdonságtal kell rendelkeznie, amely a "query-parameter-value" értéket biztosítja. Példa: query-parameter-value "object" formátumban: { "query-parameter-name": { value: "query-parameter-value", skipUrlEncoding: true } } query-parameter-value "string" formátumban: { "query-parameter-name": "query-parameter-value"}. Megjegyzés: "Ha a options.url már tartalmaz lekérdezési paramétereket, akkor az options.queryParameters elemben megadott érték hozzá lesz fűzve az URL-címhez.
serializationMapper	Információt nyújt a kérelem törzsének szerializálásáról.
spanOptions	Nyomkövetés: A span létrehozásához használt beállítások, ha engedélyezve van a nyomkövetés.
tracingContext	Nyomkövetés: A spanok létrehozásakor használt környezet.
url	A kérelem URL-címe. Előfordulhat, hogy lekérdezési paraméterek vannak benne, vagy nem. Adja meg az "url"-t, vagy adja meg a "pathTemplate" értéket a beállításobjektumban. Mindkét lehetőség kölcsönösen kizárja egymást.

Tulajdonság adatai

abortSignal

Megszakító vezérlő jele. A hálózati kérések küldésének megszakítására és a válaszra való várakozásra is használható.

abortSignal?: AbortSignalLike

Tulajdonság értéke

AbortSignalLike

baseUrl

A kérelem alap URL-címe. Az alapértelmezett érték a következő: "https://management.azure.com". Ez csak a pathTemplate esetén alkalmazható. Ha a options.url címet adja meg, akkor a teljes URL-címet kell megadnia.

baseUrl?: string

Tulajdonság értéke

string

body

A kérelem törzse. Bármilyen típusú lehet. Ez az érték szerializálva lesz, ha nem stream.

body?: any

Tulajdonság értéke

any

bodyIsStream

Azt jelzi, hogy a kérelemtörzs stream-e (a fájlfeltöltési forgatókönyvekben hasznos).

bodyIsStream?: boolean

Tulajdonság értéke

boolean

deserializationMapper

A válasz törzsének deszerializálásáról nyújt információt.

deserializationMapper?: Record<string, unknown>

Tulajdonság értéke

Record<string, unknown>

disableClientRequestId

Ha igaz értékre van állítva, arra utasítja az ügyfelet, hogy ne állítsa az "x-ms-client-request-id" fejlécet új GUID() értékre.

disableClientRequestId?: boolean

Tulajdonság értéke

boolean

disableJsonStringifyOnBody

Azt jelzi, hogy ennek a metódusnak jSON.stringify() kell-e a kérelem törzsét. Alapértelmezett érték: hamis.

disableJsonStringifyOnBody?: boolean

Tulajdonság értéke

boolean

formData

Űrlapadatok, amelyeket a kérelem törzsének létrehozásához használunk.

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

Tulajdonság értéke

{[key: string]: any}

headers

A kérelemfejlécek szótára, amelyet a kérelemre kell alkalmazni. Itt a kulcs a "fejléc-név", az érték pedig a "fejléc-érték". A fejléc-értéknek sztring típusúnak kell lennie.

• A ContentType kulcsnevet "Content-Type" néven kell megadni. Alapértelmezett érték : "application/json; charset=utf-8".
• A "Transfer-Encoding" értéke alapértelmezés szerint "darabolt", ha a "options.bodyIsStream" értéke igaz.
• A "Content-Type" értéke alapértelmezés szerint "application/octet-stream", ha a "options.bodyIsStream" értéke igaz.
• Az "accept-language" alapértelmezés szerint az "en-US" értékre van állítva
• Az "x-ms-client-request-id" alapértelmezés szerint egy új guid értékre van állítva. Ha nem szeretne guid-t létrehozni a kéréshez, állítsa a options.disableClientRequestId értéket true (igaz) értékre.

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

Tulajdonság értéke

{[key: string]: any}

mappers

A [de]szerializálás során használható leképezők szótára.

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

Tulajdonság értéke

{[x: string]: any}

method

A HTTP-kérelem metódusa. Az érvényes értékek a következők: "GET", "PUT", "HEAD", "DELETE", "OPTIONS", "POST", vagy "PATCH".

method: HttpMethods

Tulajdonság értéke

HttpMethods

onDownloadProgress

Lehetővé teszi a bejövő válasz letöltésének előrehaladásának nyomon követését.

onDownloadProgress?: (progress: TransferProgressEvent) => void

Tulajdonság értéke

(progress: TransferProgressEvent) => void

onUploadProgress

Lehetővé teszi a kimenő kérés feltöltésének előrehaladásának nyomon követését.

onUploadProgress?: (progress: TransferProgressEvent) => void

Tulajdonság értéke

(progress: TransferProgressEvent) => void

pathParameters

Az elérésiút-paraméterek szótára, amelyet a pathTemplate tényleges értékeivel kell helyettesíteni. Itt a kulcs a "path-parameter-name", az érték pedig a "path-parameter-value". A "path-parameter-value" típus lehet "sztring" vagy "object" típusú. Az url-kódolás kihagyásakor az "object" formátumot kell használni. Az objektumformátum használata során az objektumnak egy nevű tulajdonságmal kell rendelkeznie, amely a "path-parameter-value" értéket adja meg. Példa:

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

pathParameters?: {[key: string]: any | ParameterValue}

Tulajdonság értéke

{[key: string]: any | ParameterValue}

pathTemplate

A kérelem URL-címének elérésiút-sablonja. Adja meg az "url"-t, vagy adja meg a "pathTemplate" értéket a beállításobjektumban. Mindkét lehetőség kölcsönösen kizárja egymást. Például: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}

pathTemplate?: string

Tulajdonság értéke

string

queryParameters

Az URL-címhez hozzáfűzendő lekérdezési paraméterek szótára, ahol a "kulcs" a "query-parameter-name", az "érték" pedig a "query-parameter-value". A "query-parameter-value" típus lehet "sztring" vagy "object" típusú. Az url-kódolás kihagyásakor az "object" formátumot kell használni. Az objektumformátum használata során az objektumnak egy nevű tulajdonságtal kell rendelkeznie, amely a "query-parameter-value" értéket biztosítja. Példa:

• query-parameter-value "object" formátumban: { "query-parameter-name": { value: "query-parameter-value", skipUrlEncoding: true } }
• query-parameter-value "string" formátumban: { "query-parameter-name": "query-parameter-value"}. Megjegyzés: "Ha a options.url már tartalmaz lekérdezési paramétereket, akkor az options.queryParameters elemben megadott érték hozzá lesz fűzve az URL-címhez.

queryParameters?: {[key: string]: any | ParameterValue}

Tulajdonság értéke

{[key: string]: any | ParameterValue}

serializationMapper

Információt nyújt a kérelem törzsének szerializálásáról.

serializationMapper?: Mapper

Tulajdonság értéke

Mapper

spanOptions

Nyomkövetés: A span létrehozásához használt beállítások, ha engedélyezve van a nyomkövetés.

spanOptions?: SpanOptions

Tulajdonság értéke

@azure/core-tracing.SpanOptions

tracingContext

Nyomkövetés: A spanok létrehozásakor használt környezet.

tracingContext?: Context

Tulajdonság értéke

@azure/core-tracing.Context

url

A kérelem URL-címe. Előfordulhat, hogy lekérdezési paraméterek vannak benne, vagy nem. Adja meg az "url"-t, vagy adja meg a "pathTemplate" értéket a beállításobjektumban. Mindkét lehetőség kölcsönösen kizárja egymást.

url?: string

Tulajdonság értéke

string