@azure/core-https package

Классы

DefaultHttpsClient

Реализация HttpsClient, использующая модуль Node "https" для отправки HTTPS-запросов.

RestError

Настраиваемый тип ошибки для неудачных запросов конвейера.

Интерфейсы

AddPipelineOptions

Параметры при добавлении политики в конвейер. Используется для выражения зависимостей от других политик.

BearerTokenAuthenticationPolicyOptions

Параметры настройки носителяTokenAuthenticationPolicy

ExponentialRetryPolicyOptions

Параметры, управляющие повторными неудачными запросами.

HttpHeaders

Представляет набор заголовков HTTP в запросе или ответе. Имена заголовков считаются нечувствительными к регистру.

HttpsClient

Обязательный интерфейс для клиента, который выполняет запросы HTTPS от имени конвейера.

InternalPipelineOptions

Определяет параметры, используемые для настройки внутренних параметров конвейера HTTP для клиента ПАКЕТА SDK.

LogPolicyOptions

Параметры настройки logPolicy.

Pipeline

Представляет собой конвейер для выполнения HTTPS-запроса к URL-адресу. Конвейеры могут иметь несколько политик для управления обработкой каждого запроса до и после его выполнения на сервере.

PipelineOptions

Определяет параметры, используемые для настройки конвейера HTTP для клиента ПАКЕТА SDK.

PipelinePolicy

Политика конвейера управляет запросом по мере перемещения по конвейеру. Это концептуально ПО промежуточного слоя, которое разрешено изменять запрос до его создания, а также ответ при получении.

PipelineRequest

Метаданные о запросе, выполняемом конвейером.

PipelineRequestOptions

Параметры для инициализации запроса. Почти эквивалентно Partial<PipelineRequest>, но url обязателен.

PipelineResponse

Метаданные о ответе, полученном конвейером.

ProxySettings

Параметры настройки прокси-сервера для исходящих запросов (Node.js только).

RedirectPolicyOptions

Параметры обработки ответов перенаправления.

RestErrorOptions

Параметры, поддерживаемые RestError.

SystemErrorRetryPolicyOptions

Параметры, управляющие повторными неудачными запросами.

TracingPolicyOptions

Параметры настройки политики трассировки.

UserAgentPolicyOptions

Параметры добавления сведений об агенте пользователя в исходящие запросы.

Псевдонимы типа

FormDataMap

Простой объект, предоставляющий данные формы, как будто из формы браузера.

FormDataValue

Каждая запись данных формы может быть строкой или (в браузере) BLOB.

HttpMethods

Поддерживаемые методы HTTP для использования при выполнении запросов.

PipelinePhase

Политики выполняются на этапах. Порядок выполнения:

  1. Этап сериализации
  2. Политики не на этапе
  3. Этап десериализации
  4. Этап повтора
RawHttpHeaders

Коллекция HttpHeaders, представленная как простой объект JSON.

RequestBodyType

Типы тел, поддерживаемые в запросе. NodeJS.ReadableStream — это только Node. Blob — это только браузер.

SendRequest

Простой интерфейс для выполнения запроса конвейера и получения ответа.

TransferProgressEvent

Активируется в ответ на ход отправки или скачивания.

Функции

bearerTokenAuthenticationPolicy(BearerTokenAuthenticationPolicyOptions)

Политика, которая может запросить маркер из реализации TokenCredential, а затем применить его к заголовку авторизации запроса в качестве маркера носителя.

createEmptyPipeline()

Создает полностью пустой конвейер. Полезно для тестирования или создания пользовательского.

createHttpHeaders(RawHttpHeaders)

Создает объект, удовлетворяющий интерфейсу HttpHeaders.

createPipelineFromOptions(InternalPipelineOptions)

Создайте конвейер с набором настраиваемых политик по умолчанию.

createPipelineRequest(PipelineRequestOptions)

Создает новый запрос конвейера с заданными параметрами. Этот метод позволяет легко задавать значения по умолчанию и не требуется.

decompressResponsePolicy()

Политика для включения распаковки ответа в соответствии с заголовком Accept-Encoding https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Encoding

exponentialRetryPolicy(ExponentialRetryPolicyOptions)

Политика, которая пытается повторить запросы при вводе экспоненциального увеличения задержки.

formDataPolicy()

Политика, кодируемая FormData в запросе в текст.

getDefaultProxySettings(string)

Этот метод преобразует URL-адрес прокси-сервера в ProxySettings для использования с ProxyPolicy. Если аргумент не задан, он пытается проанализировать URL-адрес прокси-сервера из переменных среды HTTPS_PROXY или HTTP_PROXY.

logPolicy(LogPolicyOptions)

Политика, которая регистрирует все запросы и ответы.

ndJsonPolicy()

ndJsonPolicy — это политика, используемая для управления сохранением активности параметров для каждого запроса.

proxyPolicy(ProxySettings)

Политика, которая позволяет применять параметры прокси-сервера ко всем запросам. Если не переданы статические параметры, они будут получены из переменных среды HTTPS_PROXY или HTTP_PROXY среды.

redirectPolicy(RedirectPolicyOptions)

Политика для выполнения заголовков location с сервера для поддержки перенаправления на стороне сервера.

setClientRequestIdPolicy(string)

Каждый PipelineRequest получает уникальный идентификатор при создании. Эта политика передает уникальный идентификатор вместе с заголовком HTTP, чтобы повысить эффективность телеметрии и трассировки.

systemErrorRetryPolicy(SystemErrorRetryPolicyOptions)

Политика повторных попыток, которая специально стремится обрабатывать ошибки в базовом транспортном слое (например, сбои подстановки DNS), а не повторяющиеся коды ошибок с самого сервера.

throttlingRetryPolicy()

Политика, которая повторяется, когда сервер отправляет ответ 429 с заголовком Retry-After.

Дополнительные сведения см. в 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 и https://docs.microsoft.com/en-us/azure/virtual-machines/troubleshooting/troubleshooting-throttling-errors

tracingPolicy(TracingPolicyOptions)

Простая политика для создания диапазонов OpenTelemetry для каждого запроса, сделанного конвейером с элементом SpanOptions с родительским элементом. Запросы, сделанные без родительского диапазона, не записываются.

userAgentPolicy(UserAgentPolicyOptions)

Политика, которая задает заголовок User-Agent (или эквивалентный) для отражения версии библиотеки.

Переменные

bearerTokenAuthenticationPolicyName

Программный идентификатор bearerTokenAuthenticationPolicy.

decompressResponsePolicyName

Программный идентификатор decompressResponsePolicy.

expontentialRetryPolicyName

Программный идентификатор экспоненциальной RetryPolicy.

formDataPolicyName

Программный идентификатор формы DataPolicy.

logPolicyName

Программный идентификатор logPolicy.

ndJsonPolicyName

Программный идентификатор ndJsonPolicy.

proxyPolicyName

Программный идентификатор проксиPolicy.

redirectPolicyName

Программный идентификатор redirectPolicy.

setClientRequestIdPolicyName

Программный идентификатор setClientRequestIdPolicy.

systemErrorRetryPolicyName

Программный идентификатор systemErrorRetryPolicy.

throttlingRetryPolicyName

Программный идентификатор дротлингаRetryPolicy.

tracingPolicyName

Программный идентификатор трассировкиPolicy.

userAgentPolicyName

Программный идентификатор userAgentPolicy.

Сведения о функции

bearerTokenAuthenticationPolicy(BearerTokenAuthenticationPolicyOptions)

Политика, которая может запросить маркер из реализации TokenCredential, а затем применить его к заголовку авторизации запроса в качестве маркера носителя.

function bearerTokenAuthenticationPolicy(options: BearerTokenAuthenticationPolicyOptions): PipelinePolicy

Параметры

Возвращаемое значение

createEmptyPipeline()

Создает полностью пустой конвейер. Полезно для тестирования или создания пользовательского.

function createEmptyPipeline(): Pipeline

Возвращаемое значение

createHttpHeaders(RawHttpHeaders)

Создает объект, удовлетворяющий интерфейсу HttpHeaders.

function createHttpHeaders(rawHeaders?: RawHttpHeaders): HttpHeaders

Параметры

rawHeaders
RawHttpHeaders

Простой объект, представляющий начальные заголовки

Возвращаемое значение

createPipelineFromOptions(InternalPipelineOptions)

Создайте конвейер с набором настраиваемых политик по умолчанию.

function createPipelineFromOptions(options: InternalPipelineOptions): Pipeline

Параметры

options
InternalPipelineOptions

Параметры настройки настраиваемого конвейера.

Возвращаемое значение

createPipelineRequest(PipelineRequestOptions)

Создает новый запрос конвейера с заданными параметрами. Этот метод позволяет легко задавать значения по умолчанию и не требуется.

function createPipelineRequest(options: PipelineRequestOptions): PipelineRequest

Параметры

options
PipelineRequestOptions

Параметры для создания запроса.

Возвращаемое значение

decompressResponsePolicy()

Политика для включения распаковки ответа в соответствии с заголовком Accept-Encoding https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Encoding

function decompressResponsePolicy(): PipelinePolicy

Возвращаемое значение

exponentialRetryPolicy(ExponentialRetryPolicyOptions)

Политика, которая пытается повторить запросы при вводе экспоненциального увеличения задержки.

function exponentialRetryPolicy(options?: ExponentialRetryPolicyOptions): PipelinePolicy

Параметры

options
ExponentialRetryPolicyOptions

Параметры, которые настраивают логику повторных попыток.

Возвращаемое значение

formDataPolicy()

Политика, кодируемая FormData в запросе в текст.

function formDataPolicy(): PipelinePolicy

Возвращаемое значение

getDefaultProxySettings(string)

Этот метод преобразует URL-адрес прокси-сервера в ProxySettings для использования с ProxyPolicy. Если аргумент не задан, он пытается проанализировать URL-адрес прокси-сервера из переменных среды HTTPS_PROXY или HTTP_PROXY.

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

Параметры

proxyUrl

string

URL-адрес используемого прокси-сервера. Может содержать сведения о проверке подлинности.

Возвращаемое значение

ProxySettings | undefined

logPolicy(LogPolicyOptions)

Политика, которая регистрирует все запросы и ответы.

function logPolicy(options?: LogPolicyOptions): PipelinePolicy

Параметры

options
LogPolicyOptions

Параметры настройки logPolicy.

Возвращаемое значение

ndJsonPolicy()

ndJsonPolicy — это политика, используемая для управления сохранением активности параметров для каждого запроса.

function ndJsonPolicy(): PipelinePolicy

Возвращаемое значение

proxyPolicy(ProxySettings)

Политика, которая позволяет применять параметры прокси-сервера ко всем запросам. Если не переданы статические параметры, они будут получены из переменных среды HTTPS_PROXY или HTTP_PROXY среды.

function proxyPolicy(proxySettings?: ProxySettings): PipelinePolicy

Параметры

proxySettings
ProxySettings

ProxySettings для использования для каждого запроса.

Возвращаемое значение

redirectPolicy(RedirectPolicyOptions)

Политика для выполнения заголовков location с сервера для поддержки перенаправления на стороне сервера.

function redirectPolicy(options?: RedirectPolicyOptions): PipelinePolicy

Параметры

options
RedirectPolicyOptions

Параметры управления поведением политики.

Возвращаемое значение

setClientRequestIdPolicy(string)

Каждый PipelineRequest получает уникальный идентификатор при создании. Эта политика передает уникальный идентификатор вместе с заголовком HTTP, чтобы повысить эффективность телеметрии и трассировки.

function setClientRequestIdPolicy(requestIdHeaderName?: string): PipelinePolicy

Параметры

requestIdHeaderName

string

Имя заголовка, в который передается идентификатор запроса.

Возвращаемое значение

systemErrorRetryPolicy(SystemErrorRetryPolicyOptions)

Политика повторных попыток, которая специально стремится обрабатывать ошибки в базовом транспортном слое (например, сбои подстановки DNS), а не повторяющиеся коды ошибок с самого сервера.

function systemErrorRetryPolicy(options?: SystemErrorRetryPolicyOptions): PipelinePolicy

Параметры

options
SystemErrorRetryPolicyOptions

Параметры, которые настраивают политику.

Возвращаемое значение

throttlingRetryPolicy()

Политика, которая повторяется, когда сервер отправляет ответ 429 с заголовком Retry-After.

Дополнительные сведения см. в 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 и https://docs.microsoft.com/en-us/azure/virtual-machines/troubleshooting/troubleshooting-throttling-errors

function throttlingRetryPolicy(): PipelinePolicy

Возвращаемое значение

tracingPolicy(TracingPolicyOptions)

Простая политика для создания диапазонов OpenTelemetry для каждого запроса, сделанного конвейером с элементом SpanOptions с родительским элементом. Запросы, сделанные без родительского диапазона, не записываются.

function tracingPolicy(options?: TracingPolicyOptions): PipelinePolicy

Параметры

options
TracingPolicyOptions

Параметры настройки телеметрии, зарегистрированной политикой трассировки.

Возвращаемое значение

userAgentPolicy(UserAgentPolicyOptions)

Политика, которая задает заголовок User-Agent (или эквивалентный) для отражения версии библиотеки.

function userAgentPolicy(options?: UserAgentPolicyOptions): PipelinePolicy

Параметры

options
UserAgentPolicyOptions

Параметры настройки значения агента пользователя.

Возвращаемое значение

Variable Details

bearerTokenAuthenticationPolicyName

Программный идентификатор bearerTokenAuthenticationPolicy.

bearerTokenAuthenticationPolicyName: "bearerTokenAuthenticationPolicy"

Тип

"bearerTokenAuthenticationPolicy"

decompressResponsePolicyName

Программный идентификатор decompressResponsePolicy.

decompressResponsePolicyName: "decompressResponsePolicy"

Тип

"decompressResponsePolicy"

expontentialRetryPolicyName

Программный идентификатор экспоненциальной RetryPolicy.

expontentialRetryPolicyName: "exponentialRetryPolicy"

Тип

"exponentialRetryPolicy"

formDataPolicyName

Программный идентификатор формы DataPolicy.

formDataPolicyName: "formDataPolicy"

Тип

"formDataPolicy"

logPolicyName

Программный идентификатор logPolicy.

logPolicyName: "logPolicy"

Тип

"logPolicy"

ndJsonPolicyName

Программный идентификатор ndJsonPolicy.

ndJsonPolicyName: "ndJsonPolicy"

Тип

"ndJsonPolicy"

proxyPolicyName

Программный идентификатор проксиPolicy.

proxyPolicyName: "proxyPolicy"

Тип

"proxyPolicy"

redirectPolicyName

Программный идентификатор redirectPolicy.

redirectPolicyName: "redirectPolicy"

Тип

"redirectPolicy"

setClientRequestIdPolicyName

Программный идентификатор setClientRequestIdPolicy.

setClientRequestIdPolicyName: "setClientRequestIdPolicy"

Тип

"setClientRequestIdPolicy"

systemErrorRetryPolicyName

Программный идентификатор systemErrorRetryPolicy.

systemErrorRetryPolicyName: "systemErrorRetryPolicy"

Тип

"systemErrorRetryPolicy"

throttlingRetryPolicyName

Программный идентификатор дротлингаRetryPolicy.

throttlingRetryPolicyName: "throttlingRetryPolicy"

Тип

"throttlingRetryPolicy"

tracingPolicyName

Программный идентификатор трассировкиPolicy.

tracingPolicyName: "tracingPolicy"

Тип

"tracingPolicy"

userAgentPolicyName

Программный идентификатор userAgentPolicy.

userAgentPolicyName: "userAgentPolicy"

Тип

"userAgentPolicy"