@azure/core-client package

Classes

ServiceClient

Inicializa uma nova instância do ServiceClient.

Interfaces

AdditionalPolicyConfig

Usado para configurar políticas adicionais adicionadas ao pipeline na construção.

BaseMapper

A definição base de um mapeador. Pode ser usado para objetos XML e JavaScript simples.

CommonClientOptions

O conjunto comum de opções que os clientes de alto nível devem expor.

CompositeMapper

Um mapeador composto por outros mapeados.

CompositeMapperType

Ajuda a criar um mapeador que descreve como mapear um conjunto de propriedades de um objeto com base em outros mapeados.

Apenas uma das seguintes propriedades deve estar presente: classNamee modelPropertiesadditionalProperties.

DeserializationContentTypes

Os tipos de conteúdo que indicarão que uma resposta de operação deve ser desserializada de uma maneira específica.

DeserializationPolicyOptions

Opções para configurar a desserialização de resposta da API.

DictionaryMapper

Um mapeador que descreve objetos JavaScript simples usados como pares chave/valor.

DictionaryMapperType

Ajuda a criar um mapeador que descreve como analisar um dicionário de valores mapeados.

EnumMapper

Um mapeador que descreve um valor de enumeração.

EnumMapperType

Ajuda a criar um mapeador que descreve como analisar um valor de enumeração.

FullOperationResponse

Objeto wrapper para solicitação http e resposta. O objeto desserializado é armazenado na parsedBody propriedade quando o corpo da resposta é recebido em JSON ou XML.

InternalClientPipelineOptions

Opções para criar um Pipeline a ser usado com ServiceClient. Principalmente para personalizar a política de autenticação (se estiver usando autenticação de token) ou as opções de desserialização ao usar XML.

MapperConstraints

Descrição de várias restrições de valor, como intervalos inteiros e regex de cadeia de caracteres.

OperationArguments

Uma coleção de propriedades que se aplicam a uma única invocação de uma operação.

OperationOptions

O tipo de opções base para todas as operações.

OperationParameter

Uma interface comum que todos os parâmetros de Operação estendem.

OperationQueryParameter

Um parâmetro para uma operação que será adicionada como um parâmetro de consulta à solicitação HTTP da operação.

OperationRequestInfo

Metadados usados para analisar corretamente uma resposta.

OperationRequestOptions

Opções usadas ao criar e enviar solicitações HTTP para essa operação.

OperationResponseMap

Um OperationResponse que pode ser retornado de uma solicitação de operação para um único código de status.

OperationSpec

Uma especificação que define uma operação.

OperationURLParameter

Um parâmetro para uma operação que será substituída na URL de solicitação da operação.

PolymorphicDiscriminator

Usado para desambiguar uniões de tipos discriminados. Por exemplo, se a resposta puder ter muitas formas, mas também incluir um campo "tipo" (ou semelhante), esse campo poderá ser usado para determinar como desserializar a resposta ao tipo correto.

SequenceMapper

Um mapeador que descreve matrizes.

SequenceMapperType

Ajuda a criar um mapeador que descreve como analisar uma sequência de valores mapeados.

SerializationPolicyOptions

Opções para configurar a serialização de solicitação de API.

Serializer

Usado para mapear objetos de resposta brutos para formas finais. Ajuda a empacotar e desempacotar Datas e outros tipos codificados que não são intrínsecos ao JSON. Também permite extrair valores de cabeçalhos, bem como inserir valores e constantes padrão.

SerializerOptions

Opções para configurar o comportamento de serialização/des serialização.

ServiceClientOptions

Opções a serem fornecidas durante a criação do cliente.

SimpleMapperType

O tipo de um mapeador simples.

SpanConfig

Configuração para criar um novo intervalo de rastreamento

XmlOptions

Opções para controlar o comportamento do analisador xml e do construtor.

Aliases de tipo

Mapper

Mapeados são definições dos modelos de dados usados na biblioteca. Esses modelos de dados fazem parte das definições de Operação ou Cliente nas respostas ou parâmetros.

MapperType

Tipo do mapeador. Inclui mapeados conhecidos.

OperationRequest

Um alias de tipo para revisão futura.

ParameterPath

Codifica como acessar uma propriedade específica em um objeto .

QueryCollectionFormat

O formato que será usado para unir uma matriz de valores para um valor de parâmetro de consulta.

RawResponseCallback

Uma função a ser chamada sempre que uma resposta é recebida do servidor durante a execução da operação solicitada. Pode ser chamado várias vezes.

Funções

authorizeRequestOnClaimChallenge(AuthorizeRequestOnChallengeOptions)

Essa função pode ser usada como um retorno de chamada para o bearerTokenAuthenticationPolicy de @azure/core-rest-pipeline, para dar suporte a desafios de CAE: Avaliação contínua de acesso.

Chame o bearerTokenAuthenticationPolicy com as seguintes opções:

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

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

Depois de fornecida, a bearerTokenAuthenticationPolicy política lidará internamente com os desafios de CAE (Avaliação Contínua de Acesso). Quando não puder concluir um desafio, retornará a resposta 401 (não autorizada) do ARM.

Desafio de exemplo com declarações:

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

Define um retorno de chamada para lidar com o desafio de autenticação para APIs de Armazenamento. Isso implementa o processo de desafio do portador descrito aqui: https://docs.microsoft.com/rest/api/storageservices/authorize-with-azure-active-directory#bearer-challenge a manipulação tem recursos específicos para armazenamento que partem para os documentos gerais de desafio do AAD.

createClientPipeline(InternalClientPipelineOptions)

Cria um novo Pipeline para uso com um cliente de serviço. Adiciona em deserializationPolicy por padrão. Também adiciona em bearerTokenAuthenticationPolicy se passado um TokenCredential.

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

Método que cria e retorna um Serializador.

deserializationPolicy(DeserializationPolicyOptions)

Essa política lida com a análise de respostas de acordo com o OperationSpecs na solicitação.

serializationPolicy(SerializationPolicyOptions)

Essa política manipula a montagem do corpo da solicitação e dos cabeçalhos usando um OperationSpec e OperationArguments na solicitação.

Detalhes da função

authorizeRequestOnClaimChallenge(AuthorizeRequestOnChallengeOptions)

Essa função pode ser usada como um retorno de chamada para o bearerTokenAuthenticationPolicy de @azure/core-rest-pipeline, para dar suporte a desafios de CAE: Avaliação contínua de acesso.

Chame o bearerTokenAuthenticationPolicy com as seguintes opções:

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

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

Depois de fornecida, a bearerTokenAuthenticationPolicy política lidará internamente com os desafios de CAE (Avaliação Contínua de Acesso). Quando não puder concluir um desafio, retornará a resposta 401 (não autorizada) do ARM.

Desafio de exemplo com declarações:

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>

Parâmetros

Retornos

Promise<boolean>

authorizeRequestOnTenantChallenge(AuthorizeRequestOnChallengeOptions)

Define um retorno de chamada para lidar com o desafio de autenticação para APIs de Armazenamento. Isso implementa o processo de desafio do portador descrito aqui: https://docs.microsoft.com/rest/api/storageservices/authorize-with-azure-active-directory#bearer-challenge a manipulação tem recursos específicos para armazenamento que partem para os documentos gerais de desafio do AAD.

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

Parâmetros

Retornos

Promise<boolean>

createClientPipeline(InternalClientPipelineOptions)

Cria um novo Pipeline para uso com um cliente de serviço. Adiciona em deserializationPolicy por padrão. Também adiciona em bearerTokenAuthenticationPolicy se passado um TokenCredential.

function createClientPipeline(options?: InternalClientPipelineOptions): Pipeline

Parâmetros

options
InternalClientPipelineOptions

Opções para personalizar o pipeline criado.

Retornos

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

Método que cria e retorna um Serializador.

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

Parâmetros

modelMappers

{[key: string]: any}

Modelos conhecidos a serem mapeados

isXML

boolean

Se for necessário ter suporte para XML

Retornos

deserializationPolicy(DeserializationPolicyOptions)

Essa política lida com a análise de respostas de acordo com o OperationSpecs na solicitação.

function deserializationPolicy(options?: DeserializationPolicyOptions): PipelinePolicy

Parâmetros

Retornos

serializationPolicy(SerializationPolicyOptions)

Essa política manipula a montagem do corpo da solicitação e dos cabeçalhos usando um OperationSpec e OperationArguments na solicitação.

function serializationPolicy(options?: SerializationPolicyOptions): PipelinePolicy

Parâmetros

Retornos