@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: |
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 |
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
authorize |
Essa função pode ser usada como um retorno de chamada para o Chame o
Depois de fornecida, a Desafio de exemplo com declarações:
|
authorize |
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. |
create |
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. |
create |
Método que cria e retorna um Serializador. |
deserialization |
Essa política lida com a análise de respostas de acordo com o OperationSpecs na solicitação. |
serialization |
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
- onChallengeOptions
- AuthorizeRequestOnChallengeOptions
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
- challengeOptions
- AuthorizeRequestOnChallengeOptions
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
- options
- DeserializationPolicyOptions
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
- options
- SerializationPolicyOptions