@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 |
Политики выполняются на этапах. Порядок выполнения:
|
| RawHttpHeaders |
Коллекция HttpHeaders, представленная как простой объект JSON. |
| RequestBodyType |
Типы тел, поддерживаемые в запросе. NodeJS.ReadableStream — это только Node. Blob — это только браузер. |
| SendRequest |
Простой интерфейс для выполнения запроса конвейера и получения ответа. |
| TransferProgressEvent |
Активируется в ответ на ход отправки или скачивания. |
Функции
| bearer |
Политика, которая может запросить маркер из реализации TokenCredential, а затем применить его к заголовку авторизации запроса в качестве маркера носителя. |
| create |
Создает полностью пустой конвейер. Полезно для тестирования или создания пользовательского. |
| create |
Создает объект, удовлетворяющий интерфейсу |
| create |
Создайте конвейер с набором настраиваемых политик по умолчанию. |
| create |
Создает новый запрос конвейера с заданными параметрами. Этот метод позволяет легко задавать значения по умолчанию и не требуется. |
| decompress |
Политика для включения распаковки ответа в соответствии с заголовком Accept-Encoding https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Encoding |
| exponential |
Политика, которая пытается повторить запросы при вводе экспоненциального увеличения задержки. |
| form |
Политика, кодируемая FormData в запросе в текст. |
| get |
Этот метод преобразует URL-адрес прокси-сервера в |
| log |
Политика, которая регистрирует все запросы и ответы. |
| nd |
ndJsonPolicy — это политика, используемая для управления сохранением активности параметров для каждого запроса. |
| proxy |
Политика, которая позволяет применять параметры прокси-сервера ко всем запросам. Если не переданы статические параметры, они будут получены из переменных среды HTTPS_PROXY или HTTP_PROXY среды. |
| redirect |
Политика для выполнения заголовков location с сервера для поддержки перенаправления на стороне сервера. |
| set |
Каждый PipelineRequest получает уникальный идентификатор при создании. Эта политика передает уникальный идентификатор вместе с заголовком HTTP, чтобы повысить эффективность телеметрии и трассировки. |
| system |
Политика повторных попыток, которая специально стремится обрабатывать ошибки в базовом транспортном слое (например, сбои подстановки DNS), а не повторяющиеся коды ошибок с самого сервера. |
| throttling |
Политика, которая повторяется, когда сервер отправляет ответ 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 |
| tracing |
Простая политика для создания диапазонов OpenTelemetry для каждого запроса, сделанного конвейером с элементом SpanOptions с родительским элементом. Запросы, сделанные без родительского диапазона, не записываются. |
| user |
Политика, которая задает заголовок User-Agent (или эквивалентный) для отражения версии библиотеки. |
Переменные
| bearer |
Программный идентификатор bearerTokenAuthenticationPolicy. |
| decompress |
Программный идентификатор decompressResponsePolicy. |
| expontential |
Программный идентификатор экспоненциальной RetryPolicy. |
| form |
Программный идентификатор формы DataPolicy. |
| log |
Программный идентификатор logPolicy. |
| nd |
Программный идентификатор ndJsonPolicy. |
| proxy |
Программный идентификатор проксиPolicy. |
| redirect |
Программный идентификатор redirectPolicy. |
| set |
Программный идентификатор setClientRequestIdPolicy. |
| system |
Программный идентификатор systemErrorRetryPolicy. |
| throttling |
Программный идентификатор дротлингаRetryPolicy. |
| tracing |
Программный идентификатор трассировкиPolicy. |
| user |
Программный идентификатор 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"