Delen via


@azure/core-client package

Klassen

ServiceClient

Hiermee initialiseert u een nieuw exemplaar van de ServiceClient.

Interfaces

AdditionalPolicyConfig

Wordt gebruikt voor het configureren van extra beleidsregels die tijdens de bouw aan de pijplijn zijn toegevoegd.

BaseMapper

De basisdefinitie van een mapper. Kan worden gebruikt voor XML- en Gewone JavaScript-objecten.

CommonClientOptions

De algemene set opties die clients op hoog niveau naar verwachting beschikbaar zullen maken.

CompositeMapper

Een mapper die bestaat uit andere mappers.

CompositeMapperType

Helpt bij het bouwen van een mapper die beschrijft hoe u een set eigenschappen van een object kunt toewijzen op basis van andere mappers.

Er mag slechts een van de volgende eigenschappen aanwezig zijn: classNameen additionalPropertiesmodelProperties .

DeserializationContentTypes

De inhoudstypen die aangeven dat een bewerkingsreactie op een bepaalde manier moet worden gedeserialiseerd.

DeserializationPolicyOptions

Opties voor het configureren van de deserialisatie van API-antwoorden.

DictionaryMapper

Een mapper die gewone JavaScript-objecten beschrijft die worden gebruikt als sleutel-waardeparen.

DictionaryMapperType

Helpt bij het bouwen van een mapper die beschrijft hoe u een woordenlijst met toegewezen waarden parseert.

EnumMapper

Een mapper die een enum-waarde beschrijft.

EnumMapperType

Helpt bij het bouwen van een mapper die beschrijft hoe u een enum-waarde kunt parseren.

FullOperationResponse

Wrapper-object voor HTTP-aanvraag en -antwoord. Het gedeserialiseerde object wordt opgeslagen in de parsedBody eigenschap wanneer de antwoordtekst wordt ontvangen in JSON of XML.

InternalClientPipelineOptions

Opties voor het maken van een pijplijn voor gebruik met ServiceClient. Meestal voor het aanpassen van het verificatiebeleid (als u tokenverificatie gebruikt) of de deserialisatieopties bij het gebruik van XML.

MapperConstraints

Beschrijving van verschillende waardebeperkingen, zoals bereiken voor gehele getallen en tekenreeks regex.

OperationArguments

Een verzameling eigenschappen die van toepassing is op één aanroep van een bewerking.

OperationOptions

Het type basisopties voor alle bewerkingen.

OperationParameter

Een algemene interface die door alle Operation-parameters wordt uitgebreid.

OperationQueryParameter

Een parameter voor een bewerking die als queryparameter wordt toegevoegd aan de HTTP-aanvraag van de bewerking.

OperationRequestInfo

Metagegevens die worden gebruikt om een antwoord correct te parseren.

OperationRequestOptions

Opties die worden gebruikt bij het maken en verzenden van HTTP-aanvragen voor deze bewerking.

OperationResponseMap

Een OperationResponse die kan worden geretourneerd vanuit een bewerkingsaanvraag voor één statuscode.

OperationSpec

Een specificatie die een bewerking definieert.

OperationURLParameter

Een parameter voor een bewerking die wordt vervangen door de aanvraag-URL van de bewerking.

PolymorphicDiscriminator

Wordt gebruikt om gediscrimineerde typevakbonden ondubbelzinnig te maken. Als antwoord bijvoorbeeld veel shapes kan hebben, maar ook een veld 'soort' (of iets dergelijks) bevat, kan dat veld worden gebruikt om te bepalen hoe het antwoord moet worden gedeserialiseerd naar het juiste type.

SequenceMapper

Een mapper die matrices beschrijft.

SequenceMapperType

Helpt bij het bouwen van een mapper die beschrijft hoe u een reeks toegewezen waarden parseert.

SerializationPolicyOptions

Opties voor het configureren van serialisatie van API-aanvragen.

Serializer

Wordt gebruikt om onbewerkte antwoordobjecten toe te wijzen aan uiteindelijke shapes. Helpt bij het verpakken en uitpakken van datums en andere gecodeerde typen die niet inherent zijn aan JSON. U kunt ook waarden ophalen uit headers en standaardwaarden en constanten invoegen.

SerializerOptions

Opties voor het configureren van serialisatie-/deserialisatiegedrag.

ServiceClientOptions

Opties die moeten worden opgegeven tijdens het maken van de client.

SimpleMapperType

Het type eenvoudige mapper.

SpanConfig

Configuratie voor het maken van een nieuwe traceringsbereik

XmlOptions

Opties voor het bepalen van het gedrag van xml-parser en opbouwfunctie.

Type-aliassen

Mapper

Mappers zijn definities van de gegevensmodellen die in de bibliotheek worden gebruikt. Deze gegevensmodellen maken deel uit van de bewerkings- of clientdefinities in de antwoorden of parameters.

MapperType

Type van de mapper. Bevat bekende mappers.

OperationRequest

Een typealias voor toekomstige controle.

ParameterPath

Codeert hoe u een bepaalde eigenschap op een object bereikt.

QueryCollectionFormat

De indeling die wordt gebruikt om een matrix met waarden samen te voegen voor een queryparameterwaarde.

RawResponseCallback

Een functie die telkens wordt aangeroepen wanneer er een antwoord van de server wordt ontvangen tijdens het uitvoeren van de aangevraagde bewerking. Kan meerdere keren worden aangeroepen.

Functies

authorizeRequestOnClaimChallenge(AuthorizeRequestOnChallengeOptions)

Deze functie kan worden gebruikt als een callback voor de bearerTokenAuthenticationPolicy van , ter ondersteuning van @azure/core-rest-pipelineCAE-uitdagingen: continue toegangsevaluatie.

Roep de bearerTokenAuthenticationPolicy aan met de volgende opties:

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

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

Zodra het bearerTokenAuthenticationPolicy beleid is opgegeven, worden problemen met continue toegangsevaluatie (CAE) intern afgehandeld. Wanneer een uitdaging niet kan worden voltooid, wordt het 401-antwoord (niet-geautoriseerd) van ARM geretourneerd.

Voorbeeld van een uitdaging met claims:

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

Definieert een callback voor het afhandelen van verificatie-uitdagingen voor Opslag-API's. Hiermee wordt het bearer-uitdagingsproces geïmplementeerd dat hier wordt beschreven: https://docs.microsoft.com/rest/api/storageservices/authorize-with-azure-active-directory#bearer-challenge Afhandeling heeft specifieke functies voor opslag die vertrekken naar de algemene AAD-uitdagingsdocumenten.

createClientPipeline(InternalClientPipelineOptions)

Hiermee maakt u een nieuwe pijplijn voor gebruik met een serviceclient. Voegt standaard toe in deserializationPolicy. Voegt ook toe in bearerTokenAuthenticationPolicy als een TokenCredential is doorgegeven.

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

Methode die een serializer maakt en retourneert.

deserializationPolicy(DeserializationPolicyOptions)

Dit beleid verwerkt het parseren van antwoorden op basis van OperationSpecs voor de aanvraag.

serializationPolicy(SerializationPolicyOptions)

Dit beleid verwerkt het samenstellen van de aanvraagbody en headers met behulp van een OperationSpec en OperationArguments voor de aanvraag.

Functiedetails

authorizeRequestOnClaimChallenge(AuthorizeRequestOnChallengeOptions)

Deze functie kan worden gebruikt als een callback voor de bearerTokenAuthenticationPolicy van , ter ondersteuning van @azure/core-rest-pipelineCAE-uitdagingen: continue toegangsevaluatie.

Roep de bearerTokenAuthenticationPolicy aan met de volgende opties:

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

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

Zodra het bearerTokenAuthenticationPolicy beleid is opgegeven, worden problemen met continue toegangsevaluatie (CAE) intern afgehandeld. Wanneer een uitdaging niet kan worden voltooid, wordt het 401-antwoord (niet-geautoriseerd) van ARM geretourneerd.

Voorbeeld van een uitdaging met claims:

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>

Parameters

Retouren

Promise<boolean>

authorizeRequestOnTenantChallenge(AuthorizeRequestOnChallengeOptions)

Definieert een callback voor het afhandelen van verificatie-uitdagingen voor Opslag-API's. Hiermee wordt het bearer-uitdagingsproces geïmplementeerd dat hier wordt beschreven: https://docs.microsoft.com/rest/api/storageservices/authorize-with-azure-active-directory#bearer-challenge Afhandeling heeft specifieke functies voor opslag die vertrekken naar de algemene AAD-uitdagingsdocumenten.

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

Parameters

Retouren

Promise<boolean>

createClientPipeline(InternalClientPipelineOptions)

Hiermee maakt u een nieuwe pijplijn voor gebruik met een serviceclient. Voegt standaard toe in deserializationPolicy. Voegt ook toe in bearerTokenAuthenticationPolicy als een TokenCredential is doorgegeven.

function createClientPipeline(options?: InternalClientPipelineOptions): Pipeline

Parameters

options
InternalClientPipelineOptions

Opties voor het aanpassen van de gemaakte pijplijn.

Retouren

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

Methode die een serializer maakt en retourneert.

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

Parameters

modelMappers

{[key: string]: any}

Bekende modellen die moeten worden toegewezen

isXML

boolean

Als XML moet worden ondersteund

Retouren

deserializationPolicy(DeserializationPolicyOptions)

Dit beleid verwerkt het parseren van antwoorden op basis van OperationSpecs voor de aanvraag.

function deserializationPolicy(options?: DeserializationPolicyOptions): PipelinePolicy

Parameters

Retouren

serializationPolicy(SerializationPolicyOptions)

Dit beleid verwerkt het samenstellen van de aanvraagbody en headers met behulp van een OperationSpec en OperationArguments voor de aanvraag.

function serializationPolicy(options?: SerializationPolicyOptions): PipelinePolicy

Parameters

Retouren