@azure/core-rest-pipeline package

Classes

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.
Agent	Uma interface compatível com o http.Agentdo NodeJS. Queremos evitar a reexportação pública da interface real, uma vez que ela pode variar entre as versões de tempo de execução.
AuthorizeRequestOnChallengeOptions	Opções enviadas para o retorno de chamada authorizeRequestOnChallenge
AuthorizeRequestOptions	Opções enviadas para o retorno de chamada authorizeRequest
AuxiliaryAuthenticationHeaderPolicyOptions	Opções para configurar o auxiliaryAuthenticationHeaderPolicy
BearerTokenAuthenticationPolicyOptions	Opções para configurar o bearerTokenAuthenticationPolicy
BodyPart	Uma parte do corpo da solicitação em uma solicitação com várias partes.
ChallengeCallbacks	Opções para substituir o processamento de Avaliação Contínua de Acesso desafios.
CreateFileFromStreamOptions	Opções extras para createFile quando um fluxo está sendo passado.
CreateFileOptions	Opções passadas para createFile especificando metadados sobre o arquivo.
DefaultRetryPolicyOptions	Opções que controlam como repetir solicitações com falha.
ExponentialRetryPolicyOptions	Opções que controlam como repetir solicitações com falha.
HttpClient	A interface necessária para um cliente que faz solicitações HTTP em nome de um pipeline.
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.
InternalPipelineOptions	Define opções que são usadas para configurar opções internas do pipeline HTTP para um cliente SDK.
KeyObject	Uma interface compatível com o tls.KeyObjectdo NodeJS. Queremos evitar a reexportação pública da interface real, uma vez que ela pode variar entre as versões de tempo de execução.
LogPolicyOptions	Opções para configurar o logPolicy.
MultipartRequestBody	Um corpo de solicitação composto por várias partes.
Pipeline	Representa um pipeline para fazer uma solicitação HTTP 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 Parcial, mas url é obrigatório.
PipelineResponse	Metadados sobre uma resposta recebida pelo pipeline.
PipelineRetryOptions	Opções que controlam como repetir solicitações com falha.
ProxySettings	Opções para configurar um proxy para solicitações de saída (somenteNode.js).
PxfObject	Uma interface compatível com o tls.PxfObjectdo NodeJS. Queremos evitar a reexportação pública da interface real, uma vez que ela pode variar entre as versões de tempo de execução.
RedirectPolicyOptions	Opções de como as respostas de redirecionamento são tratadas.
RestErrorOptions	As opções suportadas por RestError.
RetryInformation	Informações fornecidas à estratégia de repetição sobre o progresso atual da política de repetição.
RetryModifiers	Propriedades que podem modificar o comportamento da política de novas tentativas.
RetryPolicyOptions	Opções para o retryPolicy
RetryStrategy	Uma estratégia de repetição destina-se a definir se deve ou não tentar novamente e como tentar novamente.
SystemErrorRetryPolicyOptions	Opções que controlam como repetir solicitações com falha.
TelemetryOptions	Define opções que são usadas para configurar informações comuns de telemetria e rastreamento
ThrottlingRetryPolicyOptions	Opções que controlam como repetir solicitações com falha.
TlsSettings	Representa um certificado para autenticação TLS.
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.

Aliases 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, Blob ou um arquivo. Se você deseja passar um arquivo com um nome, mas não tem acesso à classe File, você pode usar o auxiliar createFile para criar um.
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 é: Fase de serialização Políticas que não estão em fase Fase de desserialização Fase de repetição Fase de Assinatura
RawHttpHeaders	Uma coleção HttpHeaders representada como um objeto JSON simples.
RawHttpHeadersInput	Uma coleção HttpHeaders para entrada, representada como um objeto JSON simples.
RequestBodyType	Tipos de organismos apoiados no pedido. NodeJS.ReadableStream e () => NodeJS.ReadableStream é somente Node. Blob, ReadableStream e () => ReadableStream são apenas navegadores.
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

agentPolicy(Agent)	Obtém uma política de pipeline que define http.agent
auxiliaryAuthenticationHeaderPolicy(AuxiliaryAuthenticationHeaderPolicyOptions)	Uma política para tokens externos para x-ms-authorization-auxiliary cabeçalho. Esse cabeçalho será usado ao criar um aplicativo entre locatários que talvez precisemos para lidar com solicitações de autenticação para recursos que estão em locatários diferentes. Você pode ver documentos ARM para um resumo de como esse recurso funciona
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.
createDefaultHttpClient()	Crie o HttpClient correto para o ambiente atual.
createEmptyPipeline()	Cria um pipeline totalmente vazio. Útil para testar ou criar um personalizado.
createFile(Uint8Array, string, CreateFileOptions)	Crie um objeto que implemente a interface File. Este objeto destina-se a ser passado para RequestBodyType.formData e não é garantido que funcione como esperado em outras situações. Use esta função para criar um objeto File para uso em RequestBodyType.formData em ambientes onde o objeto File global não está disponível.
createFileFromStream(() => ReadableStream<Uint8Array> | ReadableStream, string, CreateFileFromStreamOptions)	Crie um objeto que implemente a interface File. Este objeto destina-se a ser passado para RequestBodyType.formData e não é garantido que funcione como esperado em outras situações. Use esta função para: Crie um objeto File para uso em RequestBodyType.formData em ambientes onde o objeto File global não está disponível. Crie um objeto semelhante a um arquivo a partir de um fluxo legível sem ler o fluxo na memória.
createHttpHeaders(RawHttpHeadersInput)	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
defaultRetryPolicy(DefaultRetryPolicyOptions)	Uma política que se repete de acordo com três estratégias: Quando o servidor envia uma resposta 429 com um cabeçalho Retry-After. Quando há erros na camada de transporte subjacente (por exemplo, falhas de pesquisa de DNS). Ou, caso contrário, se a solicitação de saída falhar, ela tentará novamente com um atraso exponencialmente crescente.
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.
isRestError(unknown)	Typeguard para RestError
logPolicy(LogPolicyOptions)	Uma política que registra todas as solicitações e respostas.
multipartPolicy()	Política de pipeline para solicitações com várias partes
ndJsonPolicy()	ndJsonPolicy é uma política usada para controlar as configurações de manter ativas para cada solicitação.
proxyPolicy(ProxySettings, { customNoProxyList?: string[] })	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. No navegador, esta política não é usada.
retryPolicy(RetryStrategy[], RetryPolicyOptions)	retryPolicy é uma política genérica para permitir novas tentativas de solicitações quando determinadas condições são atendidas
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(ThrottlingRetryPolicyOptions)	Uma política que tenta novamente quando o servidor envia uma resposta 429 com um cabeçalho Retry-After. Para saber mais, consulte https://learn.microsoft.com/en-us/azure/azure-resource-manager/resource-manager-request-limits, https://learn.microsoft.com/en-us/azure/azure-subscription-service-limits e https://learn.microsoft.com/en-us/azure/virtual-machines/troubleshooting/troubleshooting-throttling-errors
tlsPolicy(TlsSettings)	Obtém uma política de pipeline que adiciona o certificado do cliente ao agente HttpClient para autenticação.
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.

Detalhes de Função

agentPolicy(Agent)

Obtém uma política de pipeline que define http.agent

function agentPolicy(agent?: Agent): PipelinePolicy

Parâmetros

agent

Agent

Devoluções

PipelinePolicy

auxiliaryAuthenticationHeaderPolicy(AuxiliaryAuthenticationHeaderPolicyOptions)

Uma política para tokens externos para x-ms-authorization-auxiliary cabeçalho. Esse cabeçalho será usado ao criar um aplicativo entre locatários que talvez precisemos para lidar com solicitações de autenticação para recursos que estão em locatários diferentes. Você pode ver documentos ARM para um resumo de como esse recurso funciona

function auxiliaryAuthenticationHeaderPolicy(options: AuxiliaryAuthenticationHeaderPolicyOptions): PipelinePolicy

Parâmetros

options

AuxiliaryAuthenticationHeaderPolicyOptions

Devoluções

PipelinePolicy

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

options

BearerTokenAuthenticationPolicyOptions

Devoluções

PipelinePolicy

createDefaultHttpClient()

Crie o HttpClient correto para o ambiente atual.

function createDefaultHttpClient(): HttpClient

Devoluções

HttpClient

createEmptyPipeline()

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

function createEmptyPipeline(): Pipeline

Devoluções

Pipeline

createFile(Uint8Array, string, CreateFileOptions)

Crie um objeto que implemente a interface File. Este objeto destina-se a ser passado para RequestBodyType.formData e não é garantido que funcione como esperado em outras situações.

Use esta função para criar um objeto File para uso em RequestBodyType.formData em ambientes onde o objeto File global não está disponível.

function createFile(content: Uint8Array, name: string, options?: CreateFileOptions): File

Parâmetros

content

Uint8Array

o conteúdo do arquivo como um Uint8Array na memória.

name

string

O nome do arquivo.

options

CreateFileOptions

metadados opcionais sobre o ficheiro, por exemplo, nome do ficheiro, tamanho do ficheiro, tipo MIME.

Devoluções

File

createFileFromStream(() => ReadableStream<Uint8Array> | ReadableStream, string, CreateFileFromStreamOptions)

Crie um objeto que implemente a interface File. Este objeto destina-se a ser passado para RequestBodyType.formData e não é garantido que funcione como esperado em outras situações.

Use esta função para:

• Crie um objeto File para uso em RequestBodyType.formData em ambientes onde o objeto File global não está disponível.
• Crie um objeto semelhante a um arquivo a partir de um fluxo legível sem ler o fluxo na memória.

function createFileFromStream(stream: () => ReadableStream<Uint8Array> | ReadableStream, name: string, options?: CreateFileFromStreamOptions): File

Parâmetros

stream

() => ReadableStream<Uint8Array> | ReadableStream

O conteúdo do arquivo como um retorno de chamada retornando um fluxo. Quando um objeto File feito usando createFile é passado no mapa de dados de formulário de uma solicitação, o fluxo não será lido na memória e, em vez disso, será transmitido quando a solicitação for feita. No caso de uma nova tentativa, o fluxo precisa ser lido novamente, então esse retorno de chamada DEVE retornar um novo fluxo, se possível.

name

string

O nome do arquivo.

options

CreateFileFromStreamOptions

metadados opcionais sobre o ficheiro, por exemplo, nome do ficheiro, tamanho do ficheiro, tipo MIME.

Devoluções

File

createHttpHeaders(RawHttpHeadersInput)

Cria um objeto que satisfaz a interface HttpHeaders.

function createHttpHeaders(rawHeaders?: RawHttpHeadersInput): HttpHeaders

Parâmetros

rawHeaders

RawHttpHeadersInput

Um objeto simples que representa cabeçalhos iniciais

Devoluções

HttpHeaders

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.

Devoluções

Pipeline

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.

Devoluções

PipelineRequest

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

Devoluções

PipelinePolicy

defaultRetryPolicy(DefaultRetryPolicyOptions)

Uma política que se repete de acordo com três estratégias:

• Quando o servidor envia uma resposta 429 com um cabeçalho Retry-After.
• Quando há erros na camada de transporte subjacente (por exemplo, falhas de pesquisa de DNS).
• Ou, caso contrário, se a solicitação de saída falhar, ela tentará novamente com um atraso exponencialmente crescente.

function defaultRetryPolicy(options?: DefaultRetryPolicyOptions): PipelinePolicy

Parâmetros

options

DefaultRetryPolicyOptions

Devoluções

PipelinePolicy

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.

Devoluções

PipelinePolicy

formDataPolicy()

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

function formDataPolicy(): PipelinePolicy

Devoluções

PipelinePolicy

getDefaultProxySettings(string)

Aviso

Esta API foi preterida.

• Internally this method is no longer necessary when setting proxy information.

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.

Devoluções

ProxySettings | undefined

isRestError(unknown)

Typeguard para RestError

function isRestError(e: unknown): e

Parâmetros

e

unknown

Algo apanhado por uma cláusula de captura.

Devoluções

e

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.

Devoluções

PipelinePolicy

multipartPolicy()

Política de pipeline para solicitações com várias partes

function multipartPolicy(): PipelinePolicy

Devoluções

PipelinePolicy

ndJsonPolicy()

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

function ndJsonPolicy(): PipelinePolicy

Devoluções

PipelinePolicy

proxyPolicy(ProxySettings, { customNoProxyList?: string[] })

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, options?: { customNoProxyList?: string[] }): PipelinePolicy

Parâmetros

proxySettings

ProxySettings

ProxySettings para usar em cada solicitação.

options

{ customNoProxyList?: string[] }

configurações adicionais, por exemplo, padrões de NO_PROXY personalizados

Devoluções

PipelinePolicy

redirectPolicy(RedirectPolicyOptions)

Uma política para seguir cabeçalhos de localização do servidor para oferecer suporte ao redirecionamento do lado do servidor. No navegador, esta política não é usada.

function redirectPolicy(options?: RedirectPolicyOptions): PipelinePolicy

Parâmetros

options

RedirectPolicyOptions

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

Devoluções

PipelinePolicy

retryPolicy(RetryStrategy[], RetryPolicyOptions)

retryPolicy é uma política genérica para permitir novas tentativas de solicitações quando determinadas condições são atendidas

function retryPolicy(strategies: RetryStrategy[], options?: RetryPolicyOptions): PipelinePolicy

Parâmetros

strategies

RetryStrategy[]

options

RetryPolicyOptions

Devoluções

PipelinePolicy

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.

Devoluções

PipelinePolicy

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.

Devoluções

PipelinePolicy

throttlingRetryPolicy(ThrottlingRetryPolicyOptions)

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

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

function throttlingRetryPolicy(options?: ThrottlingRetryPolicyOptions): PipelinePolicy

Parâmetros

options

ThrottlingRetryPolicyOptions

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

Devoluções

PipelinePolicy

tlsPolicy(TlsSettings)

Obtém uma política de pipeline que adiciona o certificado do cliente ao agente HttpClient para autenticação.

function tlsPolicy(tlsSettings?: TlsSettings): PipelinePolicy

Parâmetros

tlsSettings

TlsSettings

Devoluções

PipelinePolicy

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.

Devoluções

PipelinePolicy

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.

Devoluções

PipelinePolicy