@azure/core-https package

Classes

DefaultHttpsClient

Uma implementação HttpsClient que usa o módulo "https" do Node para enviar solicitações HTTPS.

RestError

Um tipo de erro personalizado para solicitações de pipeline com falha.

Interfaces

AddPipelineOptions

Opções ao adicionar uma política ao pipeline. Usado para expressar dependências de outras políticas.

BearerTokenAuthenticationPolicyOptions

Opções para configurar o bearerTokenAuthenticationPolicy

ExponentialRetryPolicyOptions

Opções que controlam como repetir solicitações com falha.

HttpHeaders

Representa um conjunto de cabeçalhos HTTP em uma solicitação/resposta. Os nomes de cabeçalho são tratados como insensíveis a maiúsculas e minúsculas.

HttpsClient

A interface necessária para um cliente que faz solicitações HTTPS em nome de um pipeline.

InternalPipelineOptions

Define opções que são usadas para configurar opções internas do pipeline HTTP para um cliente SDK.

LogPolicyOptions

Opções para configurar o logPolicy.

Pipeline

Representa um pipeline para fazer uma solicitação HTTPS para uma URL. Os pipelines podem ter várias políticas para gerenciar a manipulação de cada solicitação antes e depois de ela ser feita ao servidor.

PipelineOptions

Define opções que são usadas para configurar o pipeline HTTP para um cliente SDK.

PipelinePolicy

Uma política de pipeline manipula uma solicitação à medida que ela percorre o pipeline. É conceitualmente um middleware que tem permissão para modificar a solicitação antes que ela seja feita, bem como a resposta quando ela é recebida.

PipelineRequest

Metadados sobre uma solicitação que está sendo feita pelo pipeline.

PipelineRequestOptions

Configurações para inicializar uma solicitação. Quase equivalente a Partial<PipelineRequest>, mas url é obrigatório.

PipelineResponse

Metadados sobre uma resposta recebida pelo pipeline.

ProxySettings

Opções para configurar um proxy para solicitações de saída (somenteNode.js).

RedirectPolicyOptions

Opções de como as respostas de redirecionamento são tratadas.

RestErrorOptions

As opções suportadas por RestError.

SystemErrorRetryPolicyOptions

Opções que controlam como repetir solicitações com falha.

TracingPolicyOptions

Opções para configurar a política de rastreamento.

UserAgentPolicyOptions

Opções para adicionar detalhes do agente do usuário às solicitações de saída.

Alias de Tipo

FormDataMap

Um objeto simples que fornece dados de formulário, como se fosse de um formulário do navegador.

FormDataValue

Cada entrada de dados de formulário pode ser uma cadeia de caracteres ou (no navegador) um Blob.

HttpMethods

Métodos HTTP suportados para usar ao fazer solicitações.

PipelinePhase

As políticas são executadas em fases. A ordem de execução é:

  1. Fase de serialização
  2. Políticas que não estão em fase
  3. Fase de desserialização
  4. Fase de repetição
RawHttpHeaders

Uma coleção HttpHeaders representada como um objeto JSON simples.

RequestBodyType

Tipos de organismos apoiados no pedido. NodeJS.ReadableStream é somente Node. Blob é apenas navegador.

SendRequest

Uma interface simples para fazer uma solicitação de pipeline e receber uma resposta.

TransferProgressEvent

Disparado em resposta ao progresso do upload ou download.

Funções

bearerTokenAuthenticationPolicy(BearerTokenAuthenticationPolicyOptions)

Uma política que pode solicitar um token de uma implementação TokenCredential e, em seguida, aplicá-lo ao cabeçalho Authorization de uma solicitação como um token de portador.

createEmptyPipeline()

Cria um pipeline totalmente vazio. Útil para testar ou criar um personalizado.

createHttpHeaders(RawHttpHeaders)

Cria um objeto que satisfaz a interface HttpHeaders.

createPipelineFromOptions(InternalPipelineOptions)

Crie um novo pipeline com um conjunto padrão de políticas personalizáveis.

createPipelineRequest(PipelineRequestOptions)

Cria uma nova solicitação de pipeline com as opções fornecidas. Este método é para permitir a fácil configuração de valores padrão e não necessário.

decompressResponsePolicy()

Uma política para habilitar a descompactação de resposta de acordo com Accept-Encoding cabeçalho https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Encoding

exponentialRetryPolicy(ExponentialRetryPolicyOptions)

Uma política que tenta repetir os pedidos ao mesmo tempo que introduz um atraso exponencialmente crescente.

formDataPolicy()

Uma política que codifica FormData na solicitação no corpo.

getDefaultProxySettings(string)

Esse método converte uma URL de proxy em ProxySettings para uso com ProxyPolicy. Se nenhum argumento for fornecido, ele tentará analisar uma URL de proxy das variáveis de ambiente HTTPS_PROXY ou HTTP_PROXY.

logPolicy(LogPolicyOptions)

Uma política que registra todas as solicitações e respostas.

ndJsonPolicy()

ndJsonPolicy é uma política usada para controlar as configurações de manter ativas para cada solicitação.

proxyPolicy(ProxySettings)

Uma política que permite aplicar configurações de proxy a todas as solicitações. Se não forem passadas as configurações estáticas, elas serão recuperadas das variáveis de ambiente HTTPS_PROXY ou HTTP_PROXY.

redirectPolicy(RedirectPolicyOptions)

Uma política para seguir cabeçalhos de localização do servidor para oferecer suporte ao redirecionamento do lado do servidor.

setClientRequestIdPolicy(string)

Cada PipelineRequest recebe uma ID exclusiva após a criação. Essa política passa essa id exclusiva por meio de um cabeçalho HTTP para permitir uma melhor telemetria e rastreamento.

systemErrorRetryPolicy(SystemErrorRetryPolicyOptions)

Uma política de repetição que procura especificamente lidar com erros na camada de transporte subjacente (por exemplo, falhas de pesquisa de DNS) em vez de códigos de erro repetidos do próprio servidor.

throttlingRetryPolicy()

Uma política que tenta novamente quando o servidor envia uma resposta 429 com um cabeçalho Retry-After.

Para saber mais, consulte https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-manager-request-limits, https://docs.microsoft.com/en-us/azure/azure-subscription-service-limits e https://docs.microsoft.com/en-us/azure/virtual-machines/troubleshooting/troubleshooting-throttling-errors

tracingPolicy(TracingPolicyOptions)

Uma política simples para criar Spans OpenTelemetry para cada solicitação feita pelo pipeline que tem SpanOptions com um pai. As solicitações feitas sem um Span pai não serão registradas.

userAgentPolicy(UserAgentPolicyOptions)

Uma política que define o cabeçalho User-Agent (ou equivalente) para refletir a versão da biblioteca.

Variáveis

bearerTokenAuthenticationPolicyName

O identificador programático da BearerTokenAuthenticationPolicy.

decompressResponsePolicyName

O identificador programático do decompressResponsePolicy.

expontentialRetryPolicyName

O identificador programático do exponencialRetryPolicy.

formDataPolicyName

O identificador programático do formDataPolicy.

logPolicyName

O identificador programático do logPolicy.

ndJsonPolicyName

O identificador programático do ndJsonPolicy.

proxyPolicyName

O identificador programático do proxy Policy.

redirectPolicyName

O identificador programático do redirectPolicy.

setClientRequestIdPolicyName

O identificador programático do setClientRequestIdPolicy.

systemErrorRetryPolicyName

O identificador programático da sistemaErrorRetryPolicy.

throttlingRetryPolicyName

O identificador programático do throttlingRetryPolicy.

tracingPolicyName

O identificador programático da TraçingPolicy.

userAgentPolicyName

O identificador programático do userAgentPolicy.

Detalhes da Função

bearerTokenAuthenticationPolicy(BearerTokenAuthenticationPolicyOptions)

Uma política que pode solicitar um token de uma implementação TokenCredential e, em seguida, aplicá-lo ao cabeçalho Authorization de uma solicitação como um token de portador.

function bearerTokenAuthenticationPolicy(options: BearerTokenAuthenticationPolicyOptions): PipelinePolicy

Parâmetros

Regressos

createEmptyPipeline()

Cria um pipeline totalmente vazio. Útil para testar ou criar um personalizado.

function createEmptyPipeline(): Pipeline

Regressos

createHttpHeaders(RawHttpHeaders)

Cria um objeto que satisfaz a interface HttpHeaders.

function createHttpHeaders(rawHeaders?: RawHttpHeaders): HttpHeaders

Parâmetros

rawHeaders
RawHttpHeaders

Um objeto simples que representa cabeçalhos iniciais

Regressos

createPipelineFromOptions(InternalPipelineOptions)

Crie um novo pipeline com um conjunto padrão de políticas personalizáveis.

function createPipelineFromOptions(options: InternalPipelineOptions): Pipeline

Parâmetros

options
InternalPipelineOptions

Opções para configurar um pipeline personalizado.

Regressos

createPipelineRequest(PipelineRequestOptions)

Cria uma nova solicitação de pipeline com as opções fornecidas. Este método é para permitir a fácil configuração de valores padrão e não necessário.

function createPipelineRequest(options: PipelineRequestOptions): PipelineRequest

Parâmetros

options
PipelineRequestOptions

As opções para criar a solicitação com.

Regressos

decompressResponsePolicy()

Uma política para habilitar a descompactação de resposta de acordo com Accept-Encoding cabeçalho https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Encoding

function decompressResponsePolicy(): PipelinePolicy

Regressos

exponentialRetryPolicy(ExponentialRetryPolicyOptions)

Uma política que tenta repetir os pedidos ao mesmo tempo que introduz um atraso exponencialmente crescente.

function exponentialRetryPolicy(options?: ExponentialRetryPolicyOptions): PipelinePolicy

Parâmetros

options
ExponentialRetryPolicyOptions

Opções que configuram a lógica de repetição.

Regressos

formDataPolicy()

Uma política que codifica FormData na solicitação no corpo.

function formDataPolicy(): PipelinePolicy

Regressos

getDefaultProxySettings(string)

Esse método converte uma URL de proxy em ProxySettings para uso com ProxyPolicy. Se nenhum argumento for fornecido, ele tentará analisar uma URL de proxy das variáveis de ambiente HTTPS_PROXY ou HTTP_PROXY.

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

Parâmetros

proxyUrl

string

A url do proxy a ser usado. Pode conter informações de autenticação.

Regressos

ProxySettings | undefined

logPolicy(LogPolicyOptions)

Uma política que registra todas as solicitações e respostas.

function logPolicy(options?: LogPolicyOptions): PipelinePolicy

Parâmetros

options
LogPolicyOptions

Opções para configurar logPolicy.

Regressos

ndJsonPolicy()

ndJsonPolicy é uma política usada para controlar as configurações de manter ativas para cada solicitação.

function ndJsonPolicy(): PipelinePolicy

Regressos

proxyPolicy(ProxySettings)

Uma política que permite aplicar configurações de proxy a todas as solicitações. Se não forem passadas as configurações estáticas, elas serão recuperadas das variáveis de ambiente HTTPS_PROXY ou HTTP_PROXY.

function proxyPolicy(proxySettings?: ProxySettings): PipelinePolicy

Parâmetros

proxySettings
ProxySettings

ProxySettings para usar em cada solicitação.

Regressos

redirectPolicy(RedirectPolicyOptions)

Uma política para seguir cabeçalhos de localização do servidor para oferecer suporte ao redirecionamento do lado do servidor.

function redirectPolicy(options?: RedirectPolicyOptions): PipelinePolicy

Parâmetros

options
RedirectPolicyOptions

Opções para controlar o comportamento da política.

Regressos

setClientRequestIdPolicy(string)

Cada PipelineRequest recebe uma ID exclusiva após a criação. Essa política passa essa id exclusiva por meio de um cabeçalho HTTP para permitir uma melhor telemetria e rastreamento.

function setClientRequestIdPolicy(requestIdHeaderName?: string): PipelinePolicy

Parâmetros

requestIdHeaderName

string

O nome do cabeçalho para o qual passar a ID da solicitação.

Regressos

systemErrorRetryPolicy(SystemErrorRetryPolicyOptions)

Uma política de repetição que procura especificamente lidar com erros na camada de transporte subjacente (por exemplo, falhas de pesquisa de DNS) em vez de códigos de erro repetidos do próprio servidor.

function systemErrorRetryPolicy(options?: SystemErrorRetryPolicyOptions): PipelinePolicy

Parâmetros

options
SystemErrorRetryPolicyOptions

Opções que personalizam a política.

Regressos

throttlingRetryPolicy()

Uma política que tenta novamente quando o servidor envia uma resposta 429 com um cabeçalho Retry-After.

Para saber mais, consulte https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-manager-request-limits, https://docs.microsoft.com/en-us/azure/azure-subscription-service-limits e https://docs.microsoft.com/en-us/azure/virtual-machines/troubleshooting/troubleshooting-throttling-errors

function throttlingRetryPolicy(): PipelinePolicy

Regressos

tracingPolicy(TracingPolicyOptions)

Uma política simples para criar Spans OpenTelemetry para cada solicitação feita pelo pipeline que tem SpanOptions com um pai. As solicitações feitas sem um Span pai não serão registradas.

function tracingPolicy(options?: TracingPolicyOptions): PipelinePolicy

Parâmetros

options
TracingPolicyOptions

Opções para configurar a telemetria registrada pela política de rastreamento.

Regressos

userAgentPolicy(UserAgentPolicyOptions)

Uma política que define o cabeçalho User-Agent (ou equivalente) para refletir a versão da biblioteca.

function userAgentPolicy(options?: UserAgentPolicyOptions): PipelinePolicy

Parâmetros

options
UserAgentPolicyOptions

Opções para personalizar o valor do agente do usuário.

Regressos

Variable Details

bearerTokenAuthenticationPolicyName

O identificador programático da BearerTokenAuthenticationPolicy.

bearerTokenAuthenticationPolicyName: "bearerTokenAuthenticationPolicy"

Tipo

"bearerTokenAuthenticationPolicy"

decompressResponsePolicyName

O identificador programático do decompressResponsePolicy.

decompressResponsePolicyName: "decompressResponsePolicy"

Tipo

"decompressResponsePolicy"

expontentialRetryPolicyName

O identificador programático do exponencialRetryPolicy.

expontentialRetryPolicyName: "exponentialRetryPolicy"

Tipo

"exponentialRetryPolicy"

formDataPolicyName

O identificador programático do formDataPolicy.

formDataPolicyName: "formDataPolicy"

Tipo

"formDataPolicy"

logPolicyName

O identificador programático do logPolicy.

logPolicyName: "logPolicy"

Tipo

"logPolicy"

ndJsonPolicyName

O identificador programático do ndJsonPolicy.

ndJsonPolicyName: "ndJsonPolicy"

Tipo

"ndJsonPolicy"

proxyPolicyName

O identificador programático do proxy Policy.

proxyPolicyName: "proxyPolicy"

Tipo

"proxyPolicy"

redirectPolicyName

O identificador programático do redirectPolicy.

redirectPolicyName: "redirectPolicy"

Tipo

"redirectPolicy"

setClientRequestIdPolicyName

O identificador programático do setClientRequestIdPolicy.

setClientRequestIdPolicyName: "setClientRequestIdPolicy"

Tipo

"setClientRequestIdPolicy"

systemErrorRetryPolicyName

O identificador programático da sistemaErrorRetryPolicy.

systemErrorRetryPolicyName: "systemErrorRetryPolicy"

Tipo

"systemErrorRetryPolicy"

throttlingRetryPolicyName

O identificador programático do throttlingRetryPolicy.

throttlingRetryPolicyName: "throttlingRetryPolicy"

Tipo

"throttlingRetryPolicy"

tracingPolicyName

O identificador programático da TraçingPolicy.

tracingPolicyName: "tracingPolicy"

Tipo

"tracingPolicy"

userAgentPolicyName

O identificador programático do userAgentPolicy.

userAgentPolicyName: "userAgentPolicy"

Tipo

"userAgentPolicy"