@azure/core-client package

Classi

ServiceClient

Inizializza una nuova istanza di ServiceClient.

Interfacce

AdditionalPolicyConfig

Usato per configurare criteri aggiuntivi aggiunti alla pipeline in fase di costruzione.

BaseMapper

Definizione di base di un mapper. Può essere usato per oggetti JavaScript XML e semplici.

CommonClientOptions

Il set comune di opzioni che i client di alto livello devono esporre.

CompositeMapper

Mapper composto da altri mapper.

CompositeMapperType

Consente di creare un mapper che descrive come eseguire il mapping di un set di proprietà di un oggetto basato su altri mapper.

Deve essere presente solo una delle proprietà seguenti: classNamee modelPropertiesadditionalProperties.

DeserializationContentTypes

I tipi di contenuto che indicano che una risposta dell'operazione deve essere deserializzata in modo particolare.

DeserializationPolicyOptions

Opzioni per configurare la deserializzazione della risposta dell'API.

DictionaryMapper

Mapper che descrive gli oggetti JavaScript semplici usati come coppie chiave/valore.

DictionaryMapperType

Consente di creare un mapper che descrive come analizzare un dizionario di valori mappati.

EnumMapper

Mapper che descrive un valore di enumerazione.

EnumMapperType

Consente di compilare un mapper che descrive come analizzare un valore di enumerazione.

FullOperationResponse

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

InternalClientPipelineOptions

Opzioni per la creazione di una pipeline da usare con ServiceClient. Per lo più per personalizzare i criteri di autenticazione (se si usa l'autenticazione token) o le opzioni di deserializzazione quando si usa XML.

MapperConstraints

Descrizione di vari vincoli di valore, ad esempio intervalli interi e regex stringa.

OperationArguments

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

OperationOptions

Tipo di opzioni di base per tutte le operazioni.

OperationParameter

Interfaccia comune estesa da tutti i parametri Operation.

OperationQueryParameter

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

OperationRequestInfo

Metadati usati per analizzare correttamente una risposta.

OperationRequestOptions

Opzioni utilizzate durante la creazione e l'invio di richieste HTTP per questa operazione.

OperationResponseMap

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.

PolymorphicDiscriminator

Usato per disambiguare le unioni dei tipi discriminate. Ad esempio, se la risposta può avere molte forme, ma include anche un campo "kind" (o simile), tale campo può essere usato per determinare come deserializzare la risposta al tipo corretto.

SequenceMapper

Mapper che descrive le matrici.

SequenceMapperType

Consente di creare un mapper che descrive come analizzare una sequenza di valori mappati.

SerializationPolicyOptions

Opzioni per configurare la serializzazione delle richieste API.

Serializer

Utilizzato per eseguire il mapping degli oggetti risposta non elaborati alle forme finali. Consente di creare pacchetti e decomprimere date e altri tipi codificati che non sono intrinseci a JSON. Consente anche il pull di valori dalle intestazioni, nonché l'inserimento di valori e costanti predefiniti.

SerializerOptions

Opzioni per configurare il comportamento di serializzazione/de-serializzazione.

ServiceClientOptions

Opzioni da fornire durante la creazione del client.

SimpleMapperType

Tipo di un semplice mapper.

SpanConfig

Configurazione per la creazione di un nuovo intervallo di traccia

XmlOptions

Opzioni per gestire il comportamento del parser xml e del generatore.

Alias tipo

Mapper

I mapper sono definizioni dei modelli di dati usati nella libreria. Questi modelli di dati fanno parte delle definizioni operation o client nelle risposte o nei parametri.

MapperType

Tipo del mapper. Include i mapper noti.

OperationRequest

Alias di tipo per la correzione futura.

ParameterPath

Codifica come raggiungere una determinata proprietà in un oggetto .

QueryCollectionFormat

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

RawResponseCallback

Funzione da chiamare ogni volta che viene ricevuta una risposta dal server durante l'esecuzione dell'operazione richiesta. Può essere chiamato più volte.

Funzioni

authorizeRequestOnClaimChallenge(AuthorizeRequestOnChallengeOptions)

Questa funzione può essere usata come callback per , per supportare le problematiche CAE: Valutazione dell'accessobearerTokenAuthenticationPolicy@azure/core-rest-pipelinecontinuo.

Chiamare con bearerTokenAuthenticationPolicy le opzioni seguenti:

import { bearerTokenAuthenticationPolicy } from "@azure/core-rest-pipeline";
import { authorizeRequestOnClaimChallenge } from "@azure/core-client";

const bearerTokenAuthenticationPolicy = bearerTokenAuthenticationPolicy({
  authorizeRequestOnChallenge: authorizeRequestOnClaimChallenge
});

Una volta specificato, i criteri gestiranno internamente le problematiche di valutazione dell'accesso continuo .Once provided, the bearerTokenAuthenticationPolicy policy will internally handle Continuous Access Evaluation (CAE). Quando non riesce a completare una richiesta, restituisce la risposta 401 (non autorizzata) da ARM.

Richiesta di esempio con attestazioni:

Bearer authorization_uri="https://login.windows-ppe.net/", error="invalid_token",
error_description="User session has been revoked",
claims="eyJhY2Nlc3NfdG9rZW4iOnsibmJmIjp7ImVzc2VudGlhbCI6dHJ1ZSwgInZhbHVlIjoiMTYwMzc0MjgwMCJ9fX0="
authorizeRequestOnTenantChallenge(AuthorizeRequestOnChallengeOptions)

Definisce un callback per gestire la richiesta di autenticazione per le API di archiviazione. Questo implementa il processo di verifica di connessione descritto qui: https://docs.microsoft.com/rest/api/storageservices/authorize-with-azure-active-directory#bearer-challenge La gestione include funzionalità specifiche per l'archiviazione che parte dalla documentazione generale della richiesta di verifica di AAD.

createClientPipeline(InternalClientPipelineOptions)

Crea una nuova pipeline da usare con un client del servizio. Aggiunge in deserializationPolicy per impostazione predefinita. Aggiunge anche bearerTokenAuthenticationPolicy se ha passato un tokenCredential.

createSerializer({[key: string]: any}, boolean)

Metodo che crea e restituisce un serializzatore.

deserializationPolicy(DeserializationPolicyOptions)

Questo criterio gestisce l'analisi delle risposte in base a OperationSpecs nella richiesta.

serializationPolicy(SerializationPolicyOptions)

Questo criterio gestisce l'assemblaggio del corpo e delle intestazioni della richiesta tramite OperationSpec e OperationArguments nella richiesta.

Dettagli funzione

authorizeRequestOnClaimChallenge(AuthorizeRequestOnChallengeOptions)

Questa funzione può essere usata come callback per , per supportare le problematiche CAE: Valutazione dell'accessobearerTokenAuthenticationPolicy@azure/core-rest-pipelinecontinuo.

Chiamare con bearerTokenAuthenticationPolicy le opzioni seguenti:

import { bearerTokenAuthenticationPolicy } from "@azure/core-rest-pipeline";
import { authorizeRequestOnClaimChallenge } from "@azure/core-client";

const bearerTokenAuthenticationPolicy = bearerTokenAuthenticationPolicy({
  authorizeRequestOnChallenge: authorizeRequestOnClaimChallenge
});

Una volta specificato, i criteri gestiranno internamente le problematiche di valutazione dell'accesso continuo .Once provided, the bearerTokenAuthenticationPolicy policy will internally handle Continuous Access Evaluation (CAE). Quando non riesce a completare una richiesta, restituisce la risposta 401 (non autorizzata) da ARM.

Richiesta di esempio con attestazioni:

Bearer authorization_uri="https://login.windows-ppe.net/", error="invalid_token",
error_description="User session has been revoked",
claims="eyJhY2Nlc3NfdG9rZW4iOnsibmJmIjp7ImVzc2VudGlhbCI6dHJ1ZSwgInZhbHVlIjoiMTYwMzc0MjgwMCJ9fX0="
function authorizeRequestOnClaimChallenge(onChallengeOptions: AuthorizeRequestOnChallengeOptions): Promise<boolean>

Parametri

Restituisce

Promise<boolean>

authorizeRequestOnTenantChallenge(AuthorizeRequestOnChallengeOptions)

Definisce un callback per gestire la richiesta di autenticazione per le API di archiviazione. Questo implementa il processo di verifica di connessione descritto qui: https://docs.microsoft.com/rest/api/storageservices/authorize-with-azure-active-directory#bearer-challenge La gestione include funzionalità specifiche per l'archiviazione che parte dalla documentazione generale della richiesta di verifica di AAD.

function authorizeRequestOnTenantChallenge(challengeOptions: AuthorizeRequestOnChallengeOptions): Promise<boolean>

Parametri

Restituisce

Promise<boolean>

createClientPipeline(InternalClientPipelineOptions)

Crea una nuova pipeline da usare con un client del servizio. Aggiunge in deserializationPolicy per impostazione predefinita. Aggiunge anche bearerTokenAuthenticationPolicy se ha passato un tokenCredential.

function createClientPipeline(options?: InternalClientPipelineOptions): Pipeline

Parametri

options
InternalClientPipelineOptions

Opzioni per personalizzare la pipeline creata.

Restituisce

createSerializer({[key: string]: any}, boolean)

Metodo che crea e restituisce un serializzatore.

function createSerializer(modelMappers?: {[key: string]: any}, isXML?: boolean): Serializer

Parametri

modelMappers

{[key: string]: any}

Modelli noti di cui eseguire il mapping

isXML

boolean

Se xml deve essere supportato

Restituisce

deserializationPolicy(DeserializationPolicyOptions)

Questo criterio gestisce l'analisi delle risposte in base a OperationSpecs nella richiesta.

function deserializationPolicy(options?: DeserializationPolicyOptions): PipelinePolicy

Parametri

Restituisce

serializationPolicy(SerializationPolicyOptions)

Questo criterio gestisce l'assemblaggio del corpo e delle intestazioni della richiesta tramite OperationSpec e OperationArguments nella richiesta.

function serializationPolicy(options?: SerializationPolicyOptions): PipelinePolicy

Parametri

Restituisce