@azure/ms-rest-js package

Classi

ApiKeyCredentials

Esegue l'autenticazione a un servizio usando una chiave API.
AzureIdentityCredentialAdapter

Questa classe fornisce un'estensione semplice da usare <xref:TokenCredential> dalla libreria di @azure/identity da usare con sdk di Azure legacy che accettano ServiceClientCredentials famiglia di credenziali per l'autenticazione.
BaseRequestPolicy
BasicAuthenticationCredentials
DefaultHttpClient
DomainCredentials

Esegue l'autenticazione a un servizio usando una chiave API.
HttpHeaders

Raccolta di coppie chiave/valore di intestazione HTTP.
RequestPolicyOptions

Proprietà facoltative che possono essere usate durante la creazione di un oggetto RequestPolicy.
RestError
Serializer
ServiceClient
TokenCredentials

Oggetto credenziali che usa una stringa di token e uno schema di autorizzazione per l'autenticazione.
TopicCredentials

Esegue l'autenticazione a un servizio usando una chiave API.
URLBuilder

Classe che gestisce la creazione, la modifica e l'analisi degli URL.
URLQuery

Classe che gestisce la parte di query di un URLBuilder.
WebResource

Crea un nuovo oggetto WebResource.

Questa classe fornisce un'astrazione su una chiamata REST essendo indipendente dalla libreria/implementazione e eseguendo il wrapping delle proprietà necessarie per avviare una richiesta.

Interfacce

AbortSignalLike

Consente di interrompere la richiesta al momento dell'attivazione dell'evento "abort". Compatibile con il browser abortSignal e i polifill comuni predefiniti del browser.
AgentSettings

Agenti HTTP e HTTPS ( soloNode.js)
ApiKeyCredentialOptions
BaseMapper
CompositeMapper
CompositeMapperType
DeserializationContentTypes

Tipi di contenuto che indicano che una risposta dell'operazione deve essere deserializzata in modo specifico.
DictionaryMapper
DictionaryMapperType
EnumMapper
EnumMapperType
HttpClient

Interfaccia che può inviare HttpRequests e ricevere httpResponses promesso.
HttpHeader

Singola intestazione all'interno di un insieme HttpHeaders.
HttpHeadersLike

Raccolta di coppie chiave/valore di intestazione HTTP.
HttpOperationResponse

Oggetto wrapper per la richiesta e la risposta HTTP. L'oggetto deserializzato viene archiviato nella proprietà parsedBody quando il corpo della risposta viene ricevuto in JSON o XML.
HttpPipelineLogger

Un logger che può essere aggiunto a un oggetto HttpPipeline. In questo modo, ogni RequestPolicy registra i messaggi che possono essere usati a scopo di debug.
HttpResponse

Proprietà in una risposta HTTP che sarà sempre presente.
MapperConstraints
OperationArguments

Raccolta di proprietà che si applicano a una singola chiamata di un'operazione.
OperationParameter

Interfaccia comune estesa da tutti i parametri Operation.
OperationQueryParameter

Parametro per un'operazione che verrà aggiunta come parametro di query alla richiesta HTTP dell'operazione.
OperationResponse

Oggetto OperationResponse che può essere restituito da una richiesta di operazione per un singolo codice di stato.
OperationSpec

Specifica che definisce un'operazione.
OperationURLParameter

Parametro per un'operazione che verrà sostituito nell'URL della richiesta dell'operazione.
ParameterValue

Valore del parametro specificato per i parametri di percorso o query in RequestPrepareOptions
PolymorphicDiscriminator
ProxySettings

Impostazioni proxy HTTP ( soloNode.js)
RedirectOptions

Opzioni per la gestione delle risposte di reindirizzamento.
RequestOptionsBase

Descrive la struttura di base dell'oggetto opzioni che verrà utilizzato in ogni operazione.
RequestPolicy
RequestPolicyOptionsLike

Proprietà facoltative che possono essere usate durante la creazione di un oggetto RequestPolicy.
RequestPrepareOptions
RestResponse

Risposta appiattita a una chiamata REST. Contiene l'oggetto HttpOperationResponse sottostante, nonché le proprietà unite del parsedBody, parsedHeaders e così via.
SequenceMapper
SequenceMapperType
ServiceCallback
ServiceClientCredentials
ServiceClientOptions

Opzioni da fornire durante la creazione del client.
SimpleMapperType
TokenResponse

TokenResponse viene definito in @azure/ms-rest-nodeauth e viene copiato qui per non aggiungere una dipendenza non necessaria.
UrlParameterValue
WebResourceLike

Astrazione su una chiamata REST.

Alias tipo

Authenticator
CommonRequestInfo
CommonRequestInit
CommonResponse
HttpMethods
HttpRequestBody
Mapper
ParameterPath
RawHttpHeaders

Insieme HttpHeaders rappresentato come un semplice oggetto JSON.
RequestPolicyFactory

Crea una nuova richiesta RequestPolicy per richiesta che usa il valore nextPolicy specificato.
TelemetryInfo
TransferProgressEvent

Generato in risposta allo stato di caricamento o download.

Enumerazioni

HttpPipelineLogLevel

Livelli diversi di log che possono essere usati con HttpPipelineLogger.
QueryCollectionFormat

Formato che verrà usato per unire una matrice di valori per un valore del parametro di query.

Funzioni

agentPolicy(AgentSettings)
applyMixins(any, any[])

Applica le proprietà sul prototipo di sourceCtors al prototipo di targetCtor
delay<T>(number, T)

Wrapper per setTimeout che risolve una promessa dopo t millisecondi.
deserializationPolicy(DeserializationContentTypes)

Creare una nuova serializzazione RequestPolicyCreator che serializza i corpi delle richieste HTTP durante il passaggio attraverso la pipeline HTTP.
deserializeResponseBody(string[], string[], HttpOperationResponse)
encodeUri(string)

Codifica un URI.
executePromisesSequentially(any[], any)

Esegue una matrice di promesse in sequenza. L'ispirazione di questo metodo è qui: https://pouchdb.com/2015/05/18/we-have-a-problem-with-promises.html. Un blog fantastico sulle promesse!
exponentialRetryPolicy(number, number, number, number)
flattenResponse(HttpOperationResponse, undefined | OperationResponse)
generateClientRequestIdPolicy(string)
generateUuid()

UUID generato
getDefaultProxySettings(string)
getDefaultUserAgentValue()
isDuration(string)

Indica se la stringa specificata è in formato ISO 8601.
isValidUuid(string)

Convalida l'uuid specificato come stringa
logPolicy(any)
promiseToCallback(Promise<any>)

Converte una promessa in un callback.
promiseToServiceCallback<T>(Promise<HttpOperationResponse>)

Converte una promessa in un callback del servizio.
proxyPolicy(ProxySettings)
redirectPolicy(number)
serializeObject(any)
signingPolicy(ServiceClientCredentials)
stripRequest(WebResourceLike)

Restituisce una versione rimossa della richiesta HTTP che non contiene l'intestazione Authorization.
stripResponse(HttpOperationResponse)

Restituisce una versione rimossa della risposta HTTP che contiene solo corpo, intestazioni e stato.
systemErrorRetryPolicy(number, number, number, number)
throttlingRetryPolicy(number)
userAgentPolicy(TelemetryInfo)

Variabili

MapperType
Constants
isNode

Una costante che indica se l'ambiente è node.js o basato su browser.

Dettagli funzione

agentPolicy(AgentSettings) 

function agentPolicy(agentSettings?: AgentSettings): RequestPolicyFactory

Parametri

agentSettings
AgentSettings

Valori restituiti

RequestPolicyFactory

applyMixins(any, any[])

Applica le proprietà sul prototipo di sourceCtors al prototipo di targetCtor

function applyMixins(targetCtor: any, sourceCtors: any[])

Parametri

targetCtor

any

Oggetto di destinazione in cui devono essere applicate le proprietà.

sourceCtors

any[]

Matrice di oggetti di origine da cui devono essere acquisite le proprietà.

delay<T>(number, T)

Wrapper per setTimeout che risolve una promessa dopo t millisecondi.

function delay<T>(t: number, value?: T): Promise<T>

Parametri

t

number

Numero di millisecondi da ritardare.

value

T

Valore da risolvere con dopo un timeout di t millisecondi.

Valori restituiti

Promise<T>

Promessa risolta

deserializationPolicy(DeserializationContentTypes)

Creare una nuova serializzazione RequestPolicyCreator che serializza i corpi delle richieste HTTP durante il passaggio attraverso la pipeline HTTP.

function deserializationPolicy(deserializationContentTypes?: DeserializationContentTypes): RequestPolicyFactory

Parametri

deserializationContentTypes
DeserializationContentTypes

Valori restituiti

RequestPolicyFactory

deserializeResponseBody(string[], string[], HttpOperationResponse) 

function deserializeResponseBody(jsonContentTypes: string[], xmlContentTypes: string[], response: HttpOperationResponse): Promise<HttpOperationResponse>

Parametri

jsonContentTypes

string[]

xmlContentTypes

string[]

response
HttpOperationResponse

Valori restituiti

Promise<HttpOperationResponse>

encodeUri(string)

Codifica un URI.

function encodeUri(uri: string): string

Parametri

uri

string

URI da codificare.

Valori restituiti

string

URI codificato.

executePromisesSequentially(any[], any)

Esegue una matrice di promesse in sequenza. L'ispirazione di questo metodo è qui: https://pouchdb.com/2015/05/18/we-have-a-problem-with-promises.html. Un blog fantastico sulle promesse!

function executePromisesSequentially(promiseFactories: any[], kickstart?: any): Promise<any>

Parametri

promiseFactories

any[]

Matrice di factory promise (funzione che restituisce una promessa)

kickstart

any

Input alla prima promessa usata per avviare la catena di promesse. Se non specificato, la catena di promesse inizia con non definita.

Valori restituiti

Promise<any>

Catena di promesse risolte o rifiutate

exponentialRetryPolicy(number, number, number, number) 

function exponentialRetryPolicy(retryCount?: number, retryInterval?: number, minRetryInterval?: number, maxRetryInterval?: number): RequestPolicyFactory

Parametri

retryCount

number

retryInterval

number

minRetryInterval

number

maxRetryInterval

number

Valori restituiti

RequestPolicyFactory

flattenResponse(HttpOperationResponse, undefined | OperationResponse) 

function flattenResponse(_response: HttpOperationResponse, responseSpec: undefined | OperationResponse): RestResponse

Parametri

_response
HttpOperationResponse
responseSpec

undefined | OperationResponse

Valori restituiti

RestResponse

generateClientRequestIdPolicy(string) 

function generateClientRequestIdPolicy(requestIdHeaderName?: string): RequestPolicyFactory

Parametri

requestIdHeaderName

string

Valori restituiti

RequestPolicyFactory

generateUuid()

UUID generato

function generateUuid(): string

Valori restituiti

string

RFC4122 UUID v4.

getDefaultProxySettings(string) 

function getDefaultProxySettings(proxyUrl?: string): ProxySettings | undefined

Parametri

proxyUrl

string

Valori restituiti

ProxySettings | undefined

getDefaultUserAgentValue() 

function getDefaultUserAgentValue(): string

Valori restituiti

string

isDuration(string)

Indica se la stringa specificata è in formato ISO 8601.

function isDuration(value: string): boolean

Parametri

value

string

Valore da convalidare per il formato di durata ISO 8601.

Valori restituiti

boolean

true se valido, false in caso contrario.

isValidUuid(string)

Convalida l'uuid specificato come stringa

function isValidUuid(uuid: string): boolean

Parametri

uuid

string

uuid come stringa che deve essere convalidata

Valori restituiti

boolean

True se l'uuid è valido; false in caso contrario.

logPolicy(any) 

function logPolicy(logger?: any): RequestPolicyFactory

Parametri

logger

any

Valori restituiti

RequestPolicyFactory

promiseToCallback(Promise<any>)

Avviso

Questa API è ora deprecata.

generated code should instead depend on responseToBody

Converte una promessa in un callback.

function promiseToCallback(promise: Promise<any>): Function

Parametri

promise

Promise<any>

Promessa da convertire in callback

Valori restituiti

Function

Funzione che accetta il callback (cb: Function): void

promiseToServiceCallback<T>(Promise<HttpOperationResponse>)

Converte una promessa in un callback del servizio.

function promiseToServiceCallback<T>(promise: Promise<HttpOperationResponse>): Function

Parametri

promise

Promise<HttpOperationResponse>

Promessa di HttpOperationResponse da convertire in un callback del servizio

Valori restituiti

Function

Una funzione che accetta il callback del servizio (cb: ServiceCallback<T>): void

proxyPolicy(ProxySettings) 

function proxyPolicy(proxySettings?: ProxySettings): RequestPolicyFactory

Parametri

proxySettings
ProxySettings

Valori restituiti

RequestPolicyFactory

redirectPolicy(number) 

function redirectPolicy(maximumRetries?: number): RequestPolicyFactory

Parametri

maximumRetries

number

Valori restituiti

RequestPolicyFactory

serializeObject(any) 

function serializeObject(toSerialize: any): any

Parametri

toSerialize

any

Valori restituiti

any

signingPolicy(ServiceClientCredentials) 

function signingPolicy(authenticationProvider: ServiceClientCredentials): RequestPolicyFactory

Parametri

authenticationProvider
ServiceClientCredentials

Valori restituiti

RequestPolicyFactory

stripRequest(WebResourceLike)

Restituisce una versione rimossa della richiesta HTTP che non contiene l'intestazione Authorization.

function stripRequest(request: WebResourceLike): WebResourceLike

Parametri

request
WebResourceLike

Oggetto Richiesta HTTP

Valori restituiti

WebResourceLike

Versione rimossa di Richiesta HTTP.

stripResponse(HttpOperationResponse)

Restituisce una versione rimossa della risposta HTTP che contiene solo corpo, intestazioni e stato.

function stripResponse(response: HttpOperationResponse): any

Parametri

response
HttpOperationResponse

Risposta HTTP

Valori restituiti

any

Versione rimossa di Http Response.

systemErrorRetryPolicy(number, number, number, number) 

function systemErrorRetryPolicy(retryCount?: number, retryInterval?: number, minRetryInterval?: number, maxRetryInterval?: number): RequestPolicyFactory

Parametri

retryCount

number

retryInterval

number

minRetryInterval

number

maxRetryInterval

number

Valori restituiti

RequestPolicyFactory

throttlingRetryPolicy(number) 

function throttlingRetryPolicy(maxRetries?: number): RequestPolicyFactory

Parametri

maxRetries

number

Valori restituiti

RequestPolicyFactory

userAgentPolicy(TelemetryInfo) 

function userAgentPolicy(userAgentData?: TelemetryInfo): RequestPolicyFactory

Parametri

userAgentData
TelemetryInfo

Valori restituiti

RequestPolicyFactory

Dettagli delle variabili

MapperType 

MapperType: { Base64Url: "Base64Url", Boolean: "Boolean", ByteArray: "ByteArray", Composite: "Composite", Date: "Date", DateTime: "DateTime", DateTimeRfc1123: "DateTimeRfc1123", Dictionary: "Dictionary", Enum: "Enum", Number: "Number", Object: "Object", Sequence: "Sequence", Stream: "Stream", String: "String", TimeSpan: "TimeSpan", UnixTime: "UnixTime" }

Tipo

{ Base64Url: "Base64Url", Boolean: "Boolean", ByteArray: "ByteArray", Composite: "Composite", Date: "Date", DateTime: "DateTime", DateTimeRfc1123: "DateTimeRfc1123", Dictionary: "Dictionary", Enum: "Enum", Number: "Number", Object: "Object", Sequence: "Sequence", Stream: "Stream", String: "String", TimeSpan: "TimeSpan", UnixTime: "UnixTime" }

Constants 

Constants: { ALL_PROXY: string, HTTP: string, HTTPS: string, HTTPS_PROXY: string, HTTP_PROXY: string, HeaderConstants: { AUTHORIZATION: string, AUTHORIZATION_SCHEME: string, RETRY_AFTER: string, USER_AGENT: string }, HttpConstants: { HttpVerbs: { DELETE: string, GET: string, HEAD: string, MERGE: string, PATCH: string, POST: string, PUT: string }, StatusCodes: { TooManyRequests: number } }, NO_PROXY: string, msRestVersion: string }

Tipo

{ ALL_PROXY: string, HTTP: string, HTTPS: string, HTTPS_PROXY: string, HTTP_PROXY: string, HeaderConstants: { AUTHORIZATION: string, AUTHORIZATION_SCHEME: string, RETRY_AFTER: string, USER_AGENT: string }, HttpConstants: { HttpVerbs: { DELETE: string, GET: string, HEAD: string, MERGE: string, PATCH: string, POST: string, PUT: string }, StatusCodes: { TooManyRequests: number } }, NO_PROXY: string, msRestVersion: string }

isNode

Una costante che indica se l'ambiente è node.js o basato su browser.

isNode: boolean

Tipo

boolean