@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 |
策略分阶段执行。 执行顺序为:
|
| RawHttpHeaders |
表示为简单 JSON 对象的 HttpHeaders 集合。 |
| RequestBodyType |
请求支持的类型。 NodeJS.ReadableStream 仅是 Node。 Blob 仅限浏览器。 |
| SendRequest |
用于发出管道请求和接收响应的简单接口。 |
| TransferProgressEvent |
响应上传或下载进度而触发。 |
函数
变量
| bearer |
持有者TokenAuthenticationPolicy的程序标识符。 |
| decompress |
decompressResponsePolicy 的程序标识符。 |
| expontential |
指数RetryPolicy的程序标识符。 |
| form |
formDataPolicy 的程序标识符。 |
| log |
logPolicy 的程序标识符。 |
| nd |
ndJsonPolicy 的程序标识符。 |
| proxy |
proxyPolicy 的程序标识符。 |
| redirect |
redirectPolicy的程序标识符。 |
| set |
setClientRequestIdPolicy 的程序标识符。 |
| system |
systemErrorRetryPolicy的程序标识符。 |
| throttling |
throttlingRetryPolicy的程序标识符。 |
| tracing |
traceingPolicy 的程序标识符。 |
| user |
用户代理策略的程序标识符。 |
函数详细信息
bearerTokenAuthenticationPolicy(BearerTokenAuthenticationPolicyOptions)
一个策略,可以从 TokenCredential 实现请求令牌,然后将其作为持有者令牌应用于请求的授权标头。
function bearerTokenAuthenticationPolicy(options: BearerTokenAuthenticationPolicyOptions): PipelinePolicy
参数
返回
createEmptyPipeline()
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()
getDefaultProxySettings(string)
此方法将代理 URL 转换为 ProxySettings,以便与 ProxyPolicy 一起使用。
如果未提供任何参数,它将尝试分析环境变量 HTTPS_PROXY 或 HTTP_PROXY中的代理 URL。
function getDefaultProxySettings(proxyUrl?: string): ProxySettings | undefined
参数
- proxyUrl
-
string
要使用的代理的 URL。 可能包含身份验证信息。
返回
ProxySettings | undefined
logPolicy(LogPolicyOptions)
记录所有请求和响应的策略。
function logPolicy(options?: LogPolicyOptions): PipelinePolicy
参数
- options
- LogPolicyOptions
用于配置 logPolicy 的选项。
返回
ndJsonPolicy()
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()
当服务器发送具有 Retry-After 标头的 429 响应时重试的策略。
若要了解详细信息,请参阅 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)
为具有 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"