Compartir a través de


@azure/core-rest-pipeline package

Clases

RestError

Tipo de error personalizado para solicitudes de canalización con errores.

Interfaces

AddPipelineOptions

Opciones al agregar una directiva a la canalización. Se usa para expresar dependencias en otras directivas.

Agent

Interfaz compatible con nodeJS.http.Agent Queremos evitar volver a exportar públicamente la interfaz real, ya que puede variar entre versiones en tiempo de ejecución.

AuthorizeRequestOnChallengeOptions

Opciones enviadas a la devolución de llamada authorizeRequestOnChallenge

AuthorizeRequestOptions

Opciones enviadas a la devolución de llamada authorizeRequest

AuxiliaryAuthenticationHeaderPolicyOptions

Opciones para configurar auxiliarAuthenticationHeaderPolicy

BearerTokenAuthenticationPolicyOptions

Opciones para configurar bearerTokenAuthenticationPolicy

ChallengeCallbacks

Opciones para invalidar el procesamiento de desafíos de evaluación continua de acceso .

DefaultRetryPolicyOptions

Opciones que controlan cómo reintentar las solicitudes con error.

ExponentialRetryPolicyOptions

Opciones que controlan cómo reintentar las solicitudes con error.

HttpClient

Interfaz necesaria para un cliente que realiza solicitudes HTTP en nombre de una canalización.

HttpHeaders

Representa un conjunto de encabezados HTTP en una solicitud o respuesta. Los nombres de encabezado se tratan como sin distinción entre mayúsculas y minúsculas.

InternalPipelineOptions

Define las opciones que se usan para configurar opciones internas de la canalización HTTP para un cliente del SDK.

KeyObject

Interfaz compatible con nodeJS.tls.KeyObject Queremos evitar volver a exportar públicamente la interfaz real, ya que puede variar entre versiones en tiempo de ejecución.

LogPolicyOptions

Opciones para configurar logPolicy.

Pipeline

Representa una canalización para realizar una solicitud HTTP en una dirección URL. Las canalizaciones pueden tener varias directivas para administrar la manipulación de cada solicitud antes y después de que se realice en el servidor.

PipelineOptions

Define las opciones que se usan para configurar la canalización HTTP para un cliente del SDK.

PipelinePolicy

Una directiva de canalización manipula una solicitud a medida que recorre la canalización. Conceptualmente, es un middleware que puede modificar la solicitud antes de realizarla, así como la respuesta cuando se recibe.

PipelineRequest

Metadatos sobre una solicitud que realiza la canalización.

PipelineRequestOptions

Configuración para inicializar una solicitud. Casi equivalente a Partial, pero la dirección URL es obligatoria.

PipelineResponse

Metadatos sobre una respuesta recibida por la canalización.

PipelineRetryOptions

Opciones que controlan cómo reintentar las solicitudes con error.

ProxySettings

Opciones para configurar un proxy para solicitudes salientes (solo Node.js).

PxfObject

Interfaz compatible con nodeJS.tls.PxfObject Queremos evitar volver a exportar públicamente la interfaz real, ya que puede variar entre versiones en tiempo de ejecución.

RedirectPolicyOptions

Opciones para controlar las respuestas de redireccionamiento.

RestErrorOptions

Las opciones admitidas por RestError.

RetryInformation

Información proporcionada a la estrategia de reintento sobre el progreso actual de la directiva de reintentos.

RetryModifiers

Propiedades que pueden modificar el comportamiento de la directiva de reintento.

RetryPolicyOptions

Opciones de retryPolicy

RetryStrategy

Una estrategia de reintento está pensada para definir si se reintenta o no y cómo reintentar.

SystemErrorRetryPolicyOptions

Opciones que controlan cómo reintentar las solicitudes con error.

TelemetryOptions

Define las opciones que se usan para configurar la información de seguimiento y telemetría comunes.

ThrottlingRetryPolicyOptions

Opciones que controlan cómo reintentar las solicitudes con error.

TlsSettings

Representa un certificado para la autenticación TLS.

TracingPolicyOptions

Opciones para configurar la directiva de seguimiento.

UserAgentPolicyOptions

Opciones para agregar detalles del agente de usuario a las solicitudes salientes.

Alias de tipos

FormDataMap

Objeto simple que proporciona datos de formulario, como si fuera de un formulario del explorador.

FormDataValue

Cada entrada de datos de formulario puede ser una cadena o (en el explorador) un blob.

HttpMethods

Métodos HTTP admitidos que se usarán al realizar solicitudes.

PipelinePhase

Las directivas se ejecutan en fases. El orden de ejecución es:

  1. Fase de serialización
  2. Directivas que no están en una fase
  3. Fase de deserialización
  4. Fase de reintento
  5. Fase de inicio de sesión
RawHttpHeaders

Colección HttpHeaders representada como un objeto JSON simple.

RawHttpHeadersInput

Colección HttpHeaders para la entrada, representada como un objeto JSON simple.

RequestBodyType

Tipos de cuerpos admitidos en la solicitud. NodeJS.ReadableStream y () => NodeJS.ReadableStream es solo Node. Blob, ReadableStream y () => ReadableStream son solo exploradores.

SendRequest

Interfaz sencilla para realizar una solicitud de canalización y recibir una respuesta.

TransferProgressEvent

Se desencadena en respuesta a la carga o descarga del progreso.

Funciones

auxiliaryAuthenticationHeaderPolicy(AuxiliaryAuthenticationHeaderPolicyOptions)

Una directiva para los tokens externos al x-ms-authorization-auxiliary encabezado. Este encabezado se usará al crear una aplicación entre inquilinos, es posible que tengamos que controlar las solicitudes de autenticación de los recursos que se encuentran en distintos inquilinos. Puede ver los documentos de ARM para obtener una lista desplegable de cómo funciona esta característica.

bearerTokenAuthenticationPolicy(BearerTokenAuthenticationPolicyOptions)

Una directiva que puede solicitar un token desde una implementación de TokenCredential y, a continuación, aplicarla al encabezado de autorización de una solicitud como token de portador.

createDefaultHttpClient()

Cree el httpClient correcto para el entorno actual.

createEmptyPipeline()

Crea una canalización totalmente vacía. Resulta útil para probar o crear uno personalizado.

createHttpHeaders(RawHttpHeadersInput)

Crea un objeto que satisface la HttpHeaders interfaz .

createPipelineFromOptions(InternalPipelineOptions)

Cree una canalización con un conjunto predeterminado de directivas personalizables.

createPipelineRequest(PipelineRequestOptions)

Crea una nueva solicitud de canalización con las opciones especificadas. Este método es permitir la configuración sencilla de los valores predeterminados y no es necesario.

decompressResponsePolicy()

Directiva para habilitar la descompresión de respuesta según el encabezado Accept-Encoding https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Encoding

defaultRetryPolicy(DefaultRetryPolicyOptions)

Una directiva que reintenta según tres estrategias:

  • Cuando el servidor envía una respuesta 429 con un encabezado Retry-After.
  • Cuando hay errores en la capa de transporte subyacente (por ejemplo, errores de búsqueda de DNS).
  • O bien, si se produce un error en la solicitud saliente, volverá a intentarlo con un retraso exponencialmente creciente.
exponentialRetryPolicy(ExponentialRetryPolicyOptions)

Directiva que intenta reintentar solicitudes al introducir un retraso exponencialmente creciente.

formDataPolicy()

Directiva que codifica FormData en la solicitud en el cuerpo.

getDefaultProxySettings(string)

Este método convierte una dirección URL de proxy en ProxySettings para su uso con ProxyPolicy. Si no se proporciona ningún argumento, intenta analizar una dirección URL de proxy de las variables HTTPS_PROXY de entorno o HTTP_PROXY.

isRestError(unknown)

Typeguard para RestError

logPolicy(LogPolicyOptions)

Directiva que registra todas las solicitudes y respuestas.

ndJsonPolicy()

ndJsonPolicy es una directiva que se usa para controlar la configuración de mantenimiento activo de cada solicitud.

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

Directiva que permite aplicar una configuración de proxy a todas las solicitudes. Si no se pasa la configuración estática, se recuperarán de las variables de entorno HTTPS_PROXY o HTTP_PROXY.

redirectPolicy(RedirectPolicyOptions)

Una directiva para seguir los encabezados de ubicación del servidor para admitir el redireccionamiento del lado servidor. En el explorador, esta directiva no se usa.

retryPolicy(RetryStrategy[], RetryPolicyOptions)

retryPolicy es una directiva genérica para habilitar las solicitudes de reintento cuando se cumplen ciertas condiciones.

setClientRequestIdPolicy(string)

Cada PipelineRequest obtiene un identificador único tras la creación. Esta directiva pasa ese identificador único a través de un encabezado HTTP para habilitar una mejor telemetría y seguimiento.

systemErrorRetryPolicy(SystemErrorRetryPolicyOptions)

Una directiva de reintento que busca específicamente controlar los errores en la capa de transporte subyacente (por ejemplo, errores de búsqueda de DNS) en lugar de códigos de error que se pueden reintentar desde el propio servidor.

throttlingRetryPolicy(ThrottlingRetryPolicyOptions)

Directiva que reintenta cuando el servidor envía una respuesta 429 con un encabezado Retry-After.

Para más información, consulte https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-manager-request-limitsy . https://docs.microsoft.com/en-us/azure/azure-subscription-service-limitshttps://docs.microsoft.com/en-us/azure/virtual-machines/troubleshooting/troubleshooting-throttling-errors

tlsPolicy(TlsSettings)

Obtiene una directiva de canalización que agrega el certificado de cliente al agente HttpClient para la autenticación.

tracingPolicy(TracingPolicyOptions)

Una directiva sencilla para crear intervalos de OpenTelemetry para cada solicitud realizada por la canalización que tiene SpanOptions con un elemento primario. Las solicitudes realizadas sin un intervalo primario no se registrarán.

userAgentPolicy(UserAgentPolicyOptions)

Directiva que establece el encabezado User-Agent (o equivalente) para reflejar la versión de la biblioteca.

Detalles de la función

auxiliaryAuthenticationHeaderPolicy(AuxiliaryAuthenticationHeaderPolicyOptions)

Una directiva para los tokens externos al x-ms-authorization-auxiliary encabezado. Este encabezado se usará al crear una aplicación entre inquilinos, es posible que tengamos que controlar las solicitudes de autenticación de los recursos que se encuentran en distintos inquilinos. Puede ver los documentos de ARM para obtener una lista desplegable de cómo funciona esta característica.

function auxiliaryAuthenticationHeaderPolicy(options: AuxiliaryAuthenticationHeaderPolicyOptions): PipelinePolicy

Parámetros

Devoluciones

bearerTokenAuthenticationPolicy(BearerTokenAuthenticationPolicyOptions)

Una directiva que puede solicitar un token desde una implementación de TokenCredential y, a continuación, aplicarla al encabezado de autorización de una solicitud como token de portador.

function bearerTokenAuthenticationPolicy(options: BearerTokenAuthenticationPolicyOptions): PipelinePolicy

Parámetros

Devoluciones

createDefaultHttpClient()

Cree el httpClient correcto para el entorno actual.

function createDefaultHttpClient(): HttpClient

Devoluciones

createEmptyPipeline()

Crea una canalización totalmente vacía. Resulta útil para probar o crear uno personalizado.

function createEmptyPipeline(): Pipeline

Devoluciones

createHttpHeaders(RawHttpHeadersInput)

Crea un objeto que satisface la HttpHeaders interfaz .

function createHttpHeaders(rawHeaders?: RawHttpHeadersInput): HttpHeaders

Parámetros

rawHeaders
RawHttpHeadersInput

Objeto simple que representa encabezados iniciales

Devoluciones

createPipelineFromOptions(InternalPipelineOptions)

Cree una canalización con un conjunto predeterminado de directivas personalizables.

function createPipelineFromOptions(options: InternalPipelineOptions): Pipeline

Parámetros

options
InternalPipelineOptions

Opciones para configurar una canalización personalizada.

Devoluciones

createPipelineRequest(PipelineRequestOptions)

Crea una nueva solicitud de canalización con las opciones especificadas. Este método es permitir la configuración sencilla de los valores predeterminados y no es necesario.

function createPipelineRequest(options: PipelineRequestOptions): PipelineRequest

Parámetros

options
PipelineRequestOptions

Las opciones con las que crear la solicitud.

Devoluciones

decompressResponsePolicy()

Directiva para habilitar la descompresión de respuesta según el encabezado Accept-Encoding https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Encoding

function decompressResponsePolicy(): PipelinePolicy

Devoluciones

defaultRetryPolicy(DefaultRetryPolicyOptions)

Una directiva que reintenta según tres estrategias:

  • Cuando el servidor envía una respuesta 429 con un encabezado Retry-After.
  • Cuando hay errores en la capa de transporte subyacente (por ejemplo, errores de búsqueda de DNS).
  • O bien, si se produce un error en la solicitud saliente, volverá a intentarlo con un retraso exponencialmente creciente.
function defaultRetryPolicy(options?: DefaultRetryPolicyOptions): PipelinePolicy

Parámetros

Devoluciones

exponentialRetryPolicy(ExponentialRetryPolicyOptions)

Directiva que intenta reintentar solicitudes al introducir un retraso exponencialmente creciente.

function exponentialRetryPolicy(options?: ExponentialRetryPolicyOptions): PipelinePolicy

Parámetros

options
ExponentialRetryPolicyOptions

Opciones que configuran la lógica de reintento.

Devoluciones

formDataPolicy()

Directiva que codifica FormData en la solicitud en el cuerpo.

function formDataPolicy(): PipelinePolicy

Devoluciones

getDefaultProxySettings(string)

Este método convierte una dirección URL de proxy en ProxySettings para su uso con ProxyPolicy. Si no se proporciona ningún argumento, intenta analizar una dirección URL de proxy de las variables HTTPS_PROXY de entorno o HTTP_PROXY.

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

Parámetros

proxyUrl

string

Dirección URL del proxy que se va a usar. Puede contener información de autenticación.

Devoluciones

ProxySettings | undefined

isRestError(unknown)

Typeguard para RestError

function isRestError(e: unknown): e

Parámetros

e

unknown

Algo capturado por una cláusula catch.

Devoluciones

e

logPolicy(LogPolicyOptions)

Directiva que registra todas las solicitudes y respuestas.

function logPolicy(options?: LogPolicyOptions): PipelinePolicy

Parámetros

options
LogPolicyOptions

Opciones para configurar logPolicy.

Devoluciones

ndJsonPolicy()

ndJsonPolicy es una directiva que se usa para controlar la configuración de mantenimiento activo de cada solicitud.

function ndJsonPolicy(): PipelinePolicy

Devoluciones

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

Directiva que permite aplicar una configuración de proxy a todas las solicitudes. Si no se pasa la configuración estática, se recuperarán de las variables de entorno HTTPS_PROXY o HTTP_PROXY.

function proxyPolicy(proxySettings?: ProxySettings, options?: { customNoProxyList?: string[] }): PipelinePolicy

Parámetros

proxySettings
ProxySettings

ProxySettings que se va a usar en cada solicitud.

options

{ customNoProxyList?: string[] }

configuración adicional, por ejemplo, patrones de NO_PROXY personalizados

Devoluciones

redirectPolicy(RedirectPolicyOptions)

Una directiva para seguir los encabezados de ubicación del servidor para admitir el redireccionamiento del lado servidor. En el explorador, esta directiva no se usa.

function redirectPolicy(options?: RedirectPolicyOptions): PipelinePolicy

Parámetros

options
RedirectPolicyOptions

Opciones para controlar el comportamiento de la directiva.

Devoluciones

retryPolicy(RetryStrategy[], RetryPolicyOptions)

retryPolicy es una directiva genérica para habilitar las solicitudes de reintento cuando se cumplen ciertas condiciones.

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

Parámetros

strategies

RetryStrategy[]

Devoluciones

setClientRequestIdPolicy(string)

Cada PipelineRequest obtiene un identificador único tras la creación. Esta directiva pasa ese identificador único a través de un encabezado HTTP para habilitar una mejor telemetría y seguimiento.

function setClientRequestIdPolicy(requestIdHeaderName?: string): PipelinePolicy

Parámetros

requestIdHeaderName

string

Nombre del encabezado al que se va a pasar el identificador de solicitud.

Devoluciones

systemErrorRetryPolicy(SystemErrorRetryPolicyOptions)

Una directiva de reintento que busca específicamente controlar los errores en la capa de transporte subyacente (por ejemplo, errores de búsqueda de DNS) en lugar de códigos de error que se pueden reintentar desde el propio servidor.

function systemErrorRetryPolicy(options?: SystemErrorRetryPolicyOptions): PipelinePolicy

Parámetros

options
SystemErrorRetryPolicyOptions

Opciones que personalizan la directiva.

Devoluciones

throttlingRetryPolicy(ThrottlingRetryPolicyOptions)

Directiva que reintenta cuando el servidor envía una respuesta 429 con un encabezado Retry-After.

Para más información, consulte https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-manager-request-limitsy . https://docs.microsoft.com/en-us/azure/azure-subscription-service-limitshttps://docs.microsoft.com/en-us/azure/virtual-machines/troubleshooting/troubleshooting-throttling-errors

function throttlingRetryPolicy(options?: ThrottlingRetryPolicyOptions): PipelinePolicy

Parámetros

options
ThrottlingRetryPolicyOptions

Opciones que configuran la lógica de reintento.

Devoluciones

tlsPolicy(TlsSettings)

Obtiene una directiva de canalización que agrega el certificado de cliente al agente HttpClient para la autenticación.

function tlsPolicy(tlsSettings?: TlsSettings): PipelinePolicy

Parámetros

tlsSettings
TlsSettings

Devoluciones

tracingPolicy(TracingPolicyOptions)

Una directiva sencilla para crear intervalos de OpenTelemetry para cada solicitud realizada por la canalización que tiene SpanOptions con un elemento primario. Las solicitudes realizadas sin un intervalo primario no se registrarán.

function tracingPolicy(options?: TracingPolicyOptions): PipelinePolicy

Parámetros

options
TracingPolicyOptions

Opciones para configurar la telemetría registrada por la directiva de seguimiento.

Devoluciones

userAgentPolicy(UserAgentPolicyOptions)

Directiva que establece el encabezado User-Agent (o equivalente) para reflejar la versión de la biblioteca.

function userAgentPolicy(options?: UserAgentPolicyOptions): PipelinePolicy

Parámetros

options
UserAgentPolicyOptions

Opciones para personalizar el valor del agente de usuario.

Devoluciones