RequestPrepareOptions interface
Opzioni per preparare una richiesta HTTP in uscita.
Proprietà
abort |
Segnale di un controller di interruzione. Può essere usato per interrompere l'invio di una richiesta di rete e l'attesa di una risposta. |
base |
URL di base della richiesta. Il valore predefinito è: "https://management.azure.com". Questa opzione è applicabile solo con pathTemplate. Se si specifica options.url, è previsto che venga fornito l'URL completo. |
body | Corpo della richiesta. Può essere di qualsiasi tipo. Questo valore verrà serializzato se non è un flusso. |
body |
Indica se il corpo della richiesta è un flusso (utile per gli scenari di caricamento di file). |
deserialization |
Fornisce informazioni su come deserializzare il corpo della risposta. |
disable |
Se impostato su true, indica al client di non impostare l'intestazione "x-ms-client-request-id" su un nuovo Guid(). |
disable |
Indica se questo metodo deve essere JSON.stringify() il corpo della richiesta. Valore predefinito: false. |
form |
Dati del modulo, usati per compilare il corpo della richiesta. |
headers | Dizionario di intestazioni di richiesta che devono essere applicate alla richiesta. Qui la chiave è "header-name" e il valore è "header-value". Il valore dell'intestazione DEVE essere di tipo string.
|
mappers | Dizionario di mapper che possono essere usati durante la serializzazione [de]. |
method | Metodo della richiesta HTTP. I valori validi sono "GET", "PUT", "HEAD", "DELETE", "OPTIONS", "POST" o "PATCH". |
on |
Consente di tenere traccia dello stato di avanzamento del download della risposta in ingresso. |
on |
Consente di tenere traccia dello stato di avanzamento del caricamento della richiesta in uscita. |
path |
Dizionario dei parametri di percorso che devono essere sostituiti con i valori effettivi nel pathTemplate. Qui la chiave è "path-parameter-name" e il valore è "path-parameter-value". "path-parameter-value" può essere di tipo "string" oppure può essere di tipo "object". Il formato "object" deve essere usato quando si vuole ignorare la codifica url. Quando si usa il formato dell'oggetto, l'oggetto deve avere un valore denominato proprietà che fornisce il valore "path-parameter-value". Esempio:
|
path |
Modello di percorso dell'URL della richiesta. Specificare "url" o specificare "pathTemplate" nell'oggetto options. Entrambe le opzioni si escludono a vicenda.
Esempio: |
query |
Dizionario di parametri di query da aggiungere all'URL, dove "key" è "query-parameter-name" e "value" è "query-parameter-value". "query-parameter-value" può essere di tipo "string" oppure può essere di tipo "object". Il formato "object" deve essere usato quando si vuole ignorare la codifica url. Quando si usa il formato dell'oggetto, l'oggetto deve avere una proprietà denominata value che fornisce il valore "query-parameter-value". Esempio:
|
serialization |
Fornisce informazioni su come serializzare il corpo della richiesta. |
span |
Traccia: opzioni usate per creare un intervallo quando la traccia è abilitata. |
tracing |
Traccia: contesto usato durante la creazione di intervalli. |
url | URL della richiesta. Può avere o meno parametri di query. Specificare "url" o specificare "pathTemplate" nell'oggetto options. Entrambe le opzioni si escludono a vicenda. |
Dettagli proprietà
abortSignal
Segnale di un controller di interruzione. Può essere usato per interrompere l'invio di una richiesta di rete e l'attesa di una risposta.
abortSignal?: AbortSignalLike
Valore della proprietà
baseUrl
URL di base della richiesta. Il valore predefinito è: "https://management.azure.com". Questa opzione è applicabile solo con pathTemplate. Se si specifica options.url, è previsto che venga fornito l'URL completo.
baseUrl?: string
Valore della proprietà
string
body
Corpo della richiesta. Può essere di qualsiasi tipo. Questo valore verrà serializzato se non è un flusso.
body?: any
Valore della proprietà
any
bodyIsStream
Indica se il corpo della richiesta è un flusso (utile per gli scenari di caricamento di file).
bodyIsStream?: boolean
Valore della proprietà
boolean
deserializationMapper
Fornisce informazioni su come deserializzare il corpo della risposta.
deserializationMapper?: Record<string, unknown>
Valore della proprietà
Record<string, unknown>
disableClientRequestId
Se impostato su true, indica al client di non impostare l'intestazione "x-ms-client-request-id" su un nuovo Guid().
disableClientRequestId?: boolean
Valore della proprietà
boolean
disableJsonStringifyOnBody
Indica se questo metodo deve essere JSON.stringify() il corpo della richiesta. Valore predefinito: false.
disableJsonStringifyOnBody?: boolean
Valore della proprietà
boolean
formData
Dati del modulo, usati per compilare il corpo della richiesta.
formData?: {[key: string]: any}
Valore della proprietà
{[key: string]: any}
headers
Dizionario di intestazioni di richiesta che devono essere applicate alla richiesta. Qui la chiave è "header-name" e il valore è "header-value". Il valore dell'intestazione DEVE essere di tipo string.
- ContentType deve essere fornito con il nome della chiave come "Content-Type". Valore predefinito "application/json; charset=utf-8".
- "Transfer-Encoding" è impostato su "chunked" per impostazione predefinita se "options.bodyIsStream" è impostato su true.
- "Content-Type" è impostato su "application/octet-stream" per impostazione predefinita se "options.bodyIsStream" è impostato su true.
- "accept-language" per impostazione predefinita è impostato su "en-US"
- Per impostazione predefinita, "x-ms-client-request-id" è impostato su un nuovo GUID. Per non generare un GUID per la richiesta, impostare options.disableClientRequestId su true
headers?: {[key: string]: any}
Valore della proprietà
{[key: string]: any}
mappers
Dizionario di mapper che possono essere usati durante la serializzazione [de].
mappers?: {[x: string]: any}
Valore della proprietà
{[x: string]: any}
method
Metodo della richiesta HTTP. I valori validi sono "GET", "PUT", "HEAD", "DELETE", "OPTIONS", "POST" o "PATCH".
method: HttpMethods
Valore della proprietà
onDownloadProgress
Consente di tenere traccia dello stato di avanzamento del download della risposta in ingresso.
onDownloadProgress?: (progress: TransferProgressEvent) => void
Valore della proprietà
(progress: TransferProgressEvent) => void
onUploadProgress
Consente di tenere traccia dello stato di avanzamento del caricamento della richiesta in uscita.
onUploadProgress?: (progress: TransferProgressEvent) => void
Valore della proprietà
(progress: TransferProgressEvent) => void
pathParameters
Dizionario dei parametri di percorso che devono essere sostituiti con i valori effettivi nel pathTemplate. Qui la chiave è "path-parameter-name" e il valore è "path-parameter-value". "path-parameter-value" può essere di tipo "string" oppure può essere di tipo "object". Il formato "object" deve essere usato quando si vuole ignorare la codifica url. Quando si usa il formato dell'oggetto, l'oggetto deve avere un valore denominato proprietà che fornisce il valore "path-parameter-value". Esempio:
- path-parameter-value in formato "object":
{ "path-parameter-name": { value: "path-parameter-value", skipUrlEncoding: true } }
- path-parameter-value in formato "string":
{ "path-parameter-name": "path-parameter-value" }
.
pathParameters?: {[key: string]: any | ParameterValue}
Valore della proprietà
{[key: string]: any | ParameterValue}
pathTemplate
Modello di percorso dell'URL della richiesta. Specificare "url" o specificare "pathTemplate" nell'oggetto options. Entrambe le opzioni si escludono a vicenda.
Esempio: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}
pathTemplate?: string
Valore della proprietà
string
queryParameters
Dizionario di parametri di query da aggiungere all'URL, dove "key" è "query-parameter-name" e "value" è "query-parameter-value". "query-parameter-value" può essere di tipo "string" oppure può essere di tipo "object". Il formato "object" deve essere usato quando si vuole ignorare la codifica url. Quando si usa il formato dell'oggetto, l'oggetto deve avere una proprietà denominata value che fornisce il valore "query-parameter-value". Esempio:
- query-parameter-value in formato "object":
{ "query-parameter-name": { value: "query-parameter-value", skipUrlEncoding: true } }
- query-parameter-value in formato "string":
{ "query-parameter-name": "query-parameter-value"}
. Nota: "Se options.url ha già alcuni parametri di query, il valore fornito in options.queryParameters verrà aggiunto all'URL.
queryParameters?: {[key: string]: any | ParameterValue}
Valore della proprietà
{[key: string]: any | ParameterValue}
serializationMapper
Fornisce informazioni su come serializzare il corpo della richiesta.
serializationMapper?: Mapper
Valore della proprietà
spanOptions
Traccia: opzioni usate per creare un intervallo quando la traccia è abilitata.
spanOptions?: SpanOptions
Valore della proprietà
tracingContext
Traccia: contesto usato durante la creazione di intervalli.
tracingContext?: Context
Valore della proprietà
url
URL della richiesta. Può avere o meno parametri di query. Specificare "url" o specificare "pathTemplate" nell'oggetto options. Entrambe le opzioni si escludono a vicenda.
url?: string
Valore della proprietà
string