你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

@azure/core-https package

DefaultHttpsClient

使用 Node 的“https”模块发送 HTTPS 请求的 HttpsClient 实现。

RestError

失败管道请求的自定义错误类型。

接口

AddPipelineOptions

将策略添加到管道时的选项。 用于表达对其他策略的依赖项。

BearerTokenAuthenticationPolicyOptions

配置 bearerTokenAuthenticationPolicy 的选项

ExponentialRetryPolicyOptions

控制如何重试失败请求的选项。

HttpHeaders

表示请求/响应上的一组 HTTP 标头。 标头名称被视为不区分大小写。

HttpsClient

代表管道发出 HTTPS 请求的客户端所需的接口。

InternalPipelineOptions

定义用于为 SDK 客户端配置 HTTP 管道的内部选项的选项。

LogPolicyOptions

用于配置 logPolicy 的选项。

Pipeline

表示用于向 URL 发出 HTTPS 请求的管道。 管道可以有多个策略来管理对服务器之前和之后每个请求的作。

PipelineOptions

定义用于为 SDK 客户端配置 HTTP 管道的选项。

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

表示为简单 JSON 对象的 HttpHeaders 集合。

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 一起使用。 如果未提供任何参数,它将尝试分析环境变量 HTTPS_PROXYHTTP_PROXY中的代理 URL。

logPolicy(LogPolicyOptions)

记录所有请求和响应的策略。

ndJsonPolicy()

ndJsonPolicy 是用于控制每个请求的保持活动设置的策略。

proxyPolicy(ProxySettings)

允许将代理设置应用于所有请求的策略。 如果未传递静态设置,将从HTTPS_PROXY或HTTP_PROXY环境变量中检索它们。

redirectPolicy(RedirectPolicyOptions)

一个策略,用于遵循来自服务器的 Location 标头以支持服务器端重定向。

setClientRequestIdPolicy(string)

每个 PipelineRequest 在创建时获取唯一 ID。 此策略通过 HTTP 标头传递该唯一 ID,以实现更好的遥测和跟踪。

systemErrorRetryPolicy(SystemErrorRetryPolicyOptions)

一个重试策略,该策略专门试图处理基础传输层(例如 DNS 查找失败)中的错误,而不是服务器本身的可重试错误代码。

throttlingRetryPolicy()

当服务器发送具有 Retry-After 标头的 429 响应时重试的策略。

若要了解详细信息,请参阅 https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-manager-request-limitshttps://docs.microsoft.com/en-us/azure/azure-subscription-service-limitshttps://docs.microsoft.com/en-us/azure/virtual-machines/troubleshooting/troubleshooting-throttling-errors

tracingPolicy(TracingPolicyOptions)

为具有 SpanOptions 且具有父级的管道发出的每个请求创建 OpenTelemetry Spans 的简单策略。 不会记录在没有父 Span 的情况下发出的请求。

userAgentPolicy(UserAgentPolicyOptions)

设置 User-Agent 标头(或等效)以反映库版本的策略。

变量

bearerTokenAuthenticationPolicyName

持有者TokenAuthenticationPolicy的程序标识符。

decompressResponsePolicyName

decompressResponsePolicy 的程序标识符。

expontentialRetryPolicyName

指数RetryPolicy的程序标识符。

formDataPolicyName

formDataPolicy 的程序标识符。

logPolicyName

logPolicy 的程序标识符。

ndJsonPolicyName

ndJsonPolicy 的程序标识符。

proxyPolicyName

proxyPolicy 的程序标识符。

redirectPolicyName

redirectPolicy的程序标识符。

setClientRequestIdPolicyName

setClientRequestIdPolicy 的程序标识符。

systemErrorRetryPolicyName

systemErrorRetryPolicy的程序标识符。

throttlingRetryPolicyName

throttlingRetryPolicy的程序标识符。

tracingPolicyName

traceingPolicy 的程序标识符。

userAgentPolicyName

用户代理策略的程序标识符。

函数详细信息

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 一起使用。 如果未提供任何参数,它将尝试分析环境变量 HTTPS_PROXYHTTP_PROXY中的代理 URL。

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 在创建时获取唯一 ID。 此策略通过 HTTP 标头传递该唯一 ID,以实现更好的遥测和跟踪。

function setClientRequestIdPolicy(requestIdHeaderName?: string): PipelinePolicy

参数

requestIdHeaderName

string

要向其传递请求 ID 的标头的名称。

返回

systemErrorRetryPolicy(SystemErrorRetryPolicyOptions)

一个重试策略,该策略专门试图处理基础传输层(例如 DNS 查找失败)中的错误,而不是服务器本身的可重试错误代码。

function systemErrorRetryPolicy(options?: SystemErrorRetryPolicyOptions): PipelinePolicy

参数

options
SystemErrorRetryPolicyOptions

自定义策略的选项。

返回

throttlingRetryPolicy()

tracingPolicy(TracingPolicyOptions)

为具有 SpanOptions 且具有父级的管道发出的每个请求创建 OpenTelemetry Spans 的简单策略。 不会记录在没有父 Span 的情况下发出的请求。

function tracingPolicy(options?: TracingPolicyOptions): PipelinePolicy

参数

options
TracingPolicyOptions

用于配置跟踪策略记录的遥测的选项。

返回

userAgentPolicy(UserAgentPolicyOptions)

设置 User-Agent 标头(或等效)以反映库版本的策略。

function userAgentPolicy(options?: UserAgentPolicyOptions): PipelinePolicy

参数

options
UserAgentPolicyOptions

自定义用户代理值的选项。

返回

Variable Details

bearerTokenAuthenticationPolicyName

持有者TokenAuthenticationPolicy的程序标识符。

bearerTokenAuthenticationPolicyName: "bearerTokenAuthenticationPolicy"

类型

"bearerTokenAuthenticationPolicy"

decompressResponsePolicyName

decompressResponsePolicy 的程序标识符。

decompressResponsePolicyName: "decompressResponsePolicy"

类型

"decompressResponsePolicy"

expontentialRetryPolicyName

指数RetryPolicy的程序标识符。

expontentialRetryPolicyName: "exponentialRetryPolicy"

类型

"exponentialRetryPolicy"

formDataPolicyName

formDataPolicy 的程序标识符。

formDataPolicyName: "formDataPolicy"

类型

"formDataPolicy"

logPolicyName

logPolicy 的程序标识符。

logPolicyName: "logPolicy"

类型

"logPolicy"

ndJsonPolicyName

ndJsonPolicy 的程序标识符。

ndJsonPolicyName: "ndJsonPolicy"

类型

"ndJsonPolicy"

proxyPolicyName

proxyPolicy 的程序标识符。

proxyPolicyName: "proxyPolicy"

类型

"proxyPolicy"

redirectPolicyName

redirectPolicy的程序标识符。

redirectPolicyName: "redirectPolicy"

类型

"redirectPolicy"

setClientRequestIdPolicyName

setClientRequestIdPolicy 的程序标识符。

setClientRequestIdPolicyName: "setClientRequestIdPolicy"

类型

"setClientRequestIdPolicy"

systemErrorRetryPolicyName

systemErrorRetryPolicy的程序标识符。

systemErrorRetryPolicyName: "systemErrorRetryPolicy"

类型

"systemErrorRetryPolicy"

throttlingRetryPolicyName

throttlingRetryPolicy的程序标识符。

throttlingRetryPolicyName: "throttlingRetryPolicy"

类型

"throttlingRetryPolicy"

tracingPolicyName

traceingPolicy 的程序标识符。

tracingPolicyName: "tracingPolicy"

类型

"tracingPolicy"

userAgentPolicyName

用户代理策略的程序标识符。

userAgentPolicyName: "userAgentPolicy"

类型

"userAgentPolicy"