@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 é:
|
| 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
| bearer |
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. |
| create |
Cria um pipeline totalmente vazio. Útil para testar ou criar um personalizado. |
| create |
Cria um objeto que satisfaz a interface |
| create |
Crie um novo pipeline com um conjunto padrão de políticas personalizáveis. |
| create |
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. |
| decompress |
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 |
| exponential |
Uma política que tenta repetir os pedidos ao mesmo tempo que introduz um atraso exponencialmente crescente. |
| form |
Uma política que codifica FormData na solicitação no corpo. |
| get |
Esse método converte uma URL de proxy em |
| log |
Uma política que registra todas as solicitações e respostas. |
| nd |
ndJsonPolicy é uma política usada para controlar as configurações de manter ativas para cada solicitação. |
| proxy |
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. |
| redirect |
Uma política para seguir cabeçalhos de localização do servidor para oferecer suporte ao redirecionamento do lado do servidor. |
| set |
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. |
| system |
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. |
| throttling |
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 |
| tracing |
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. |
| user |
Uma política que define o cabeçalho User-Agent (ou equivalente) para refletir a versão da biblioteca. |
Variáveis
| bearer |
O identificador programático da BearerTokenAuthenticationPolicy. |
| decompress |
O identificador programático do decompressResponsePolicy. |
| expontential |
O identificador programático do exponencialRetryPolicy. |
| form |
O identificador programático do formDataPolicy. |
| log |
O identificador programático do logPolicy. |
| nd |
O identificador programático do ndJsonPolicy. |
| proxy |
O identificador programático do proxy Policy. |
| redirect |
O identificador programático do redirectPolicy. |
| set |
O identificador programático do setClientRequestIdPolicy. |
| system |
O identificador programático da sistemaErrorRetryPolicy. |
| throttling |
O identificador programático do throttlingRetryPolicy. |
| tracing |
O identificador programático da TraçingPolicy. |
| user |
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"