Freigeben über


RequestPrepareOptions interface

Optionen zum Vorbereiten einer ausgehenden HTTP-Anforderung.

Eigenschaften

abortSignal

Signal eines Abbruchcontrollers. Kann verwendet werden, um sowohl das Senden einer Netzwerkanforderung als auch das Warten auf eine Antwort abzubrechen.

baseUrl

Die Basis-URL der Anforderung. Standardwert ist: "https://management.azure.com". Dies gilt nur für pathTemplate. Wenn Sie options.url bereitstellen, wird erwartet, dass Sie die vollständige URL angeben.

body

Anforderungstext Es kann von einem beliebigen Typ sein. Dieser Wert wird serialisiert, wenn es sich nicht um einen Stream handelt.

bodyIsStream

Gibt an, ob der Anforderungstext ein Stream ist (nützlich für Dateiuploadszenarien).

deserializationMapper

Enthält Informationen zum Deserialisieren des Antworttexts.

disableClientRequestId

Wenn dieser Wert auf true festgelegt ist, weist den Client an, den Header "x-ms-client-request-id" nicht auf eine neue Guid() festzulegen.

disableJsonStringifyOnBody

Gibt an, ob diese Methode JSON.stringify() für den Anforderungstext verwenden soll. Standardwert: False

formData

Formulardaten, die zum Erstellen des Anforderungstexts verwendet werden.

headers

Ein Wörterbuch von Anforderungsheadern, die auf die Anforderung angewendet werden müssen. Hier ist der Schlüssel der "header-name" und der Wert ist der "header-value". Der Header-Wert MUSS vom Typ Zeichenfolge sein.

  • ContentType muss mit dem Schlüsselnamen "Content-Type" angegeben werden. Standardwert "application/json; charset=utf-8".
  • "Transfer-Encoding" ist standardmäßig auf "chunked" festgelegt, wenn "options.bodyIsStream" auf true festgelegt ist.
  • "Content-Type" ist standardmäßig auf "application/octet-stream" festgelegt, wenn "options.bodyIsStream" auf true festgelegt ist.
  • "accept-language" ist standardmäßig auf "en-US" festgelegt.
  • "x-ms-client-request-id" ist standardmäßig auf eine neue Guid festgelegt. Um keine GUID für die Anforderung zu generieren, legen Sie options.disableClientRequestId auf true fest.
mappers

Ein Wörterbuch von Mappern, die während der [De]Serialisierung verwendet werden können.

method

Die HTTP-Anforderungsmethode. Gültige Werte sind "GET", "PUT", "HEAD", "DELETE", "OPTIONS", "POST" oder "PATCH".

onDownloadProgress

Ermöglicht das Nachverfolgen des Fortschritts beim Herunterladen der eingehenden Antwort.

onUploadProgress

Ermöglicht das Nachverfolgen des Fortschritts beim Hochladen der ausgehenden Anforderung.

pathParameters

Ein Wörterbuch mit Pfadparametern, die durch tatsächliche Werte in der pathTemplate ersetzt werden müssen. Hier ist der Schlüssel der "path-parameter-name" und der Wert ist der "path-parameter-value". Der "path-parameter-value" kann vom Typ "string" oder vom Typ "object" sein. Das Objektformat sollte verwendet werden, wenn Sie die URL-Codierung überspringen möchten. Bei Verwendung des Objektformats muss das Objekt über eine Eigenschaft namens value verfügen, die den "path-parameter-value" bereitstellt. Beispiel:

  • path-parameter-value im Objektformat: { "path-parameter-name": { value: "path-parameter-value", skipUrlEncoding: true } }
  • path-parameter-value im "string"-Format: { "path-parameter-name": "path-parameter-value" }.
pathTemplate

Die Pfadvorlage der Anforderungs-URL. Geben Sie entweder die "URL" an, oder geben Sie die "pathTemplate" im Optionsobjekt an. Beide Optionen schließen sich gegenseitig aus. Beispiel: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}

queryParameters

Ein Wörterbuch von Abfrageparametern, die an die URL angefügt werden sollen, wobei "key" der "query-parameter-name" und der "value" der "query-parameter-value" ist. Der "query-parameter-value" kann vom Typ "string" oder vom Typ "object" sein. Das Objektformat sollte verwendet werden, wenn Sie die URL-Codierung überspringen möchten. Bei Verwendung des Objektformats muss das Objekt über eine Eigenschaft namens value verfügen, die den "query-parameter-value" bereitstellt. Beispiel:

  • query-parameter-value im Objektformat: { "query-parameter-name": { value: "query-parameter-value", skipUrlEncoding: true } }
  • query-parameter-value im "string"-Format: { "query-parameter-name": "query-parameter-value"}. Hinweis: "Wenn options.url bereits über einige Abfrageparameter verfügt, wird der in options.queryParameters angegebene Wert an die URL angefügt.
serializationMapper

Enthält Informationen zum Serialisieren des Anforderungstexts.

spanOptions

Ablaufverfolgung: Optionen, die zum Erstellen einer Spanne verwendet werden, wenn die Ablaufverfolgung aktiviert ist.

tracingContext

Ablaufverfolgung: Kontext, der beim Erstellen von Spannen verwendet wird.

url

Die Anforderungs-URL. Sie kann Abfrageparameter enthalten oder auch nicht. Geben Sie entweder die "URL" an, oder geben Sie die "pathTemplate" im Optionsobjekt an. Beide Optionen schließen sich gegenseitig aus.

Details zur Eigenschaft

abortSignal

Signal eines Abbruchcontrollers. Kann verwendet werden, um sowohl das Senden einer Netzwerkanforderung als auch das Warten auf eine Antwort abzubrechen.

abortSignal?: AbortSignalLike

Eigenschaftswert

baseUrl

Die Basis-URL der Anforderung. Standardwert ist: "https://management.azure.com". Dies gilt nur für pathTemplate. Wenn Sie options.url bereitstellen, wird erwartet, dass Sie die vollständige URL angeben.

baseUrl?: string

Eigenschaftswert

string

body

Anforderungstext Es kann von einem beliebigen Typ sein. Dieser Wert wird serialisiert, wenn es sich nicht um einen Stream handelt.

body?: any

Eigenschaftswert

any

bodyIsStream

Gibt an, ob der Anforderungstext ein Stream ist (nützlich für Dateiuploadszenarien).

bodyIsStream?: boolean

Eigenschaftswert

boolean

deserializationMapper

Enthält Informationen zum Deserialisieren des Antworttexts.

deserializationMapper?: Record<string, unknown>

Eigenschaftswert

Record<string, unknown>

disableClientRequestId

Wenn dieser Wert auf true festgelegt ist, weist den Client an, den Header "x-ms-client-request-id" nicht auf eine neue Guid() festzulegen.

disableClientRequestId?: boolean

Eigenschaftswert

boolean

disableJsonStringifyOnBody

Gibt an, ob diese Methode JSON.stringify() für den Anforderungstext verwenden soll. Standardwert: False

disableJsonStringifyOnBody?: boolean

Eigenschaftswert

boolean

formData

Formulardaten, die zum Erstellen des Anforderungstexts verwendet werden.

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

Eigenschaftswert

{[key: string]: any}

headers

Ein Wörterbuch von Anforderungsheadern, die auf die Anforderung angewendet werden müssen. Hier ist der Schlüssel der "header-name" und der Wert ist der "header-value". Der Header-Wert MUSS vom Typ Zeichenfolge sein.

  • ContentType muss mit dem Schlüsselnamen "Content-Type" angegeben werden. Standardwert "application/json; charset=utf-8".
  • "Transfer-Encoding" ist standardmäßig auf "chunked" festgelegt, wenn "options.bodyIsStream" auf true festgelegt ist.
  • "Content-Type" ist standardmäßig auf "application/octet-stream" festgelegt, wenn "options.bodyIsStream" auf true festgelegt ist.
  • "accept-language" ist standardmäßig auf "en-US" festgelegt.
  • "x-ms-client-request-id" ist standardmäßig auf eine neue Guid festgelegt. Um keine GUID für die Anforderung zu generieren, legen Sie options.disableClientRequestId auf true fest.
headers?: {[key: string]: any}

Eigenschaftswert

{[key: string]: any}

mappers

Ein Wörterbuch von Mappern, die während der [De]Serialisierung verwendet werden können.

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

Eigenschaftswert

{[x: string]: any}

method

Die HTTP-Anforderungsmethode. Gültige Werte sind "GET", "PUT", "HEAD", "DELETE", "OPTIONS", "POST" oder "PATCH".

method: HttpMethods

Eigenschaftswert

onDownloadProgress

Ermöglicht das Nachverfolgen des Fortschritts beim Herunterladen der eingehenden Antwort.

onDownloadProgress?: (progress: TransferProgressEvent) => void

Eigenschaftswert

(progress: TransferProgressEvent) => void

onUploadProgress

Ermöglicht das Nachverfolgen des Fortschritts beim Hochladen der ausgehenden Anforderung.

onUploadProgress?: (progress: TransferProgressEvent) => void

Eigenschaftswert

(progress: TransferProgressEvent) => void

pathParameters

Ein Wörterbuch mit Pfadparametern, die durch tatsächliche Werte in der pathTemplate ersetzt werden müssen. Hier ist der Schlüssel der "path-parameter-name" und der Wert ist der "path-parameter-value". Der "path-parameter-value" kann vom Typ "string" oder vom Typ "object" sein. Das Objektformat sollte verwendet werden, wenn Sie die URL-Codierung überspringen möchten. Bei Verwendung des Objektformats muss das Objekt über eine Eigenschaft namens value verfügen, die den "path-parameter-value" bereitstellt. Beispiel:

  • path-parameter-value im Objektformat: { "path-parameter-name": { value: "path-parameter-value", skipUrlEncoding: true } }
  • path-parameter-value im "string"-Format: { "path-parameter-name": "path-parameter-value" }.
pathParameters?: {[key: string]: any | ParameterValue}

Eigenschaftswert

{[key: string]: any | ParameterValue}

pathTemplate

Die Pfadvorlage der Anforderungs-URL. Geben Sie entweder die "URL" an, oder geben Sie die "pathTemplate" im Optionsobjekt an. Beide Optionen schließen sich gegenseitig aus. Beispiel: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}

pathTemplate?: string

Eigenschaftswert

string

queryParameters

Ein Wörterbuch von Abfrageparametern, die an die URL angefügt werden sollen, wobei "key" der "query-parameter-name" und der "value" der "query-parameter-value" ist. Der "query-parameter-value" kann vom Typ "string" oder vom Typ "object" sein. Das Objektformat sollte verwendet werden, wenn Sie die URL-Codierung überspringen möchten. Bei Verwendung des Objektformats muss das Objekt über eine Eigenschaft namens value verfügen, die den "query-parameter-value" bereitstellt. Beispiel:

  • query-parameter-value im Objektformat: { "query-parameter-name": { value: "query-parameter-value", skipUrlEncoding: true } }
  • query-parameter-value im "string"-Format: { "query-parameter-name": "query-parameter-value"}. Hinweis: "Wenn options.url bereits über einige Abfrageparameter verfügt, wird der in options.queryParameters angegebene Wert an die URL angefügt.
queryParameters?: {[key: string]: any | ParameterValue}

Eigenschaftswert

{[key: string]: any | ParameterValue}

serializationMapper

Enthält Informationen zum Serialisieren des Anforderungstexts.

serializationMapper?: Mapper

Eigenschaftswert

spanOptions

Ablaufverfolgung: Optionen, die zum Erstellen einer Spanne verwendet werden, wenn die Ablaufverfolgung aktiviert ist.

spanOptions?: SpanOptions

Eigenschaftswert

@azure/core-tracing.SpanOptions

tracingContext

Ablaufverfolgung: Kontext, der beim Erstellen von Spannen verwendet wird.

tracingContext?: Context

Eigenschaftswert

@azure/core-tracing.Context

url

Die Anforderungs-URL. Sie kann Abfrageparameter enthalten oder auch nicht. Geben Sie entweder die "URL" an, oder geben Sie die "pathTemplate" im Optionsobjekt an. Beide Optionen schließen sich gegenseitig aus.

url?: string

Eigenschaftswert

string