@azure/core-http package
类
AccessTokenRefresher |
如果当前未等待新令牌,可帮助使用 core-http 令牌身份验证策略来请求新令牌。 |
ApiKeyCredentials |
使用 API 密钥向服务进行身份验证。 |
BaseRequestPolicy |
从中派生所有请求策略的基类。 |
BasicAuthenticationCredentials |
使用用户名和密码进行身份验证的简单 <xref:ServiceClientCredential>。 |
DefaultHttpClient |
使用 |
ExpiringAccessTokenCache |
提供一个 AccessTokenCache 实现,该实现在 expiresOnTimestamp 传递后清除缓存的 AccessToken。 |
HttpHeaders |
HTTP 标头键/值对的集合。 |
RequestPolicyOptions |
创建 RequestPolicy 时可以使用的可选属性。 |
RestError |
从 HTTP 请求到服务终结点导致的错误。 |
Serializer |
用于将原始响应对象映射到最终形状。 帮助打包和解压缩日期和其他编码类型,这些类型不是 JSON 固有的。 还允许从标头拉取值,以及插入默认值和常量。 |
ServiceClient |
ServiceClient 发送服务请求并接收响应。 |
TopicCredentials |
用于 Azure 事件网格的 TopicCredentials 对象。 |
URLBuilder |
处理创建、修改和分析 URL 的类。 |
URLQuery |
一个处理 URLBuilder 查询部分的类。 |
WebResource |
创建新的 WebResource 对象。 此类通过与库/实现无关并包装必要的属性来启动请求,从而通过 REST 调用提供抽象。 |
接口
AbortSignalLike |
允许在触发“中止”事件时中止请求。 与浏览器内置 AbortSignal 和常见 polyfills 兼容。 |
AccessToken |
表示具有过期时间的访问令牌。 |
AccessTokenCache |
为从 TokenCredential 返回的 AccessToken 提供缓存。 |
ApiKeyCredentialOptions |
描述在创建 ApiKeyCredentials 实例时要提供的选项 |
BaseMapper |
映射器的基本定义。 可用于 XML 和纯 JavaScript 对象。 |
CompositeMapper |
由其他映射器组成的映射器。 |
CompositeMapperType |
帮助生成一个映射器,该映射器描述如何基于其他映射器映射对象的一组属性。 应仅存在以下属性之一: |
DeserializationContentTypes |
指示应以特定方式反序列化作响应的内容类型。 |
DeserializationOptions |
用于配置 API 响应反序列化的选项。 |
DictionaryMapper |
描述用作键/值对的纯 JavaScript 对象的映射器。 |
DictionaryMapperType |
帮助生成描述如何分析映射值的字典的映射器。 |
EnumMapper |
描述枚举值的映射器。 |
EnumMapperType |
帮助生成描述如何分析枚举值的映射器。 |
GetTokenOptions |
定义 TokenCredential.getToken 的选项。 |
HttpClient |
可以发送 HttpRequests 并接收承诺的 HttpResponses 的接口。 |
HttpHeader |
HttpHeaders 集合中的单个标头。 |
HttpHeadersLike |
HTTP 标头键/值对的集合。 |
HttpOperationResponse |
http 请求和响应的包装器对象。 当响应正文以 JSON 或 XML 接收响应正文时,反序列化对象存储在 |
HttpPipelineLogger |
可添加到 HttpPipeline 的记录器。 这使每个 RequestPolicy 能够记录可用于调试的消息。 |
HttpResponse |
HTTP 响应上的属性,该响应将始终存在。 |
InternalPipelineOptions |
定义用于为 SDK 客户端配置 HTTP 管道的内部选项的选项。 |
KeepAliveOptions |
有关如何为将来的请求维护 HTTP 连接的选项。 |
LogPolicyOptions |
传递给 logPolicy的选项。 默认情况下,只记录一组标头列表,但可以配置此列表。 永远不会记录请求和响应正文。 |
MapperConstraints |
描述各种值约束,例如整数范围和字符串正则表达式。 |
OperationArguments |
应用于单个作调用的属性集合。 |
OperationOptions |
所有作的基本选项类型。 |
OperationParameter |
所有 Operation 参数扩展的通用接口。 |
OperationQueryParameter |
将作为查询参数添加到作的 HTTP 请求的作的参数。 |
OperationRequestOptions |
允许配置 SDK作发出的 HTTP 请求处理的选项。 |
OperationResponse |
可从单个状态代码的作请求返回的 OperationResponse。 |
OperationSpec |
定义如何通过 HTTP 执行特定服务作的规范,包括如何将请求信息正确序列化为 ServiceClient可返回的对象有效负载,以及如何反序列化响应信息。 |
OperationURLParameter |
作的参数,该参数将替换为作的请求 URL。 |
ParameterValue |
RequestPrepareOptions 中为路径或查询参数提供的参数值 |
PipelineOptions |
定义用于为 SDK 客户端配置 HTTP 管道的选项。 |
PolymorphicDiscriminator |
用于消除区分类型联合的歧义。 例如,如果响应可以包含许多形状,但还包括“kind”字段(或类似),该字段可用于确定如何将响应反序列化为正确的类型。 |
ProxySettings |
为传出请求配置代理的选项(仅Node.js)。 |
RedirectOptions |
有关如何处理重定向响应的选项。 |
RequestOptionsBase |
描述将在每个作中使用的 options 对象的基结构。 |
RequestPolicy |
请求策略的基础结构。 |
RequestPolicyOptionsLike |
创建 RequestPolicy 时可以使用的可选属性。 |
RequestPrepareOptions |
用于准备传出 HTTP 请求的选项。 |
RestResponse |
对 REST 调用的平展响应。
包含基础 HttpOperationResponse 以及 |
RetryOptions |
控制如何重试失败请求的选项。 |
SequenceMapper |
描述数组的映射器。 |
SequenceMapperType |
帮助生成描述如何分析映射值的序列的映射器。 |
SerializerOptions |
用于管理 xml 分析器和生成器行为的选项。 |
ServiceCallback | |
ServiceClientCredentials |
表示具有 |
ServiceClientOptions |
创建客户端时要提供的选项。 |
SimpleMapperType |
简单映射器的类型。 |
TokenCredential |
表示能够提供身份验证令牌的凭据。 |
TracingPolicyOptions |
自定义跟踪策略的选项。 |
UrlParameterValue |
表示 URL 参数值的接口。 |
UserAgentOptions |
用于将用户代理详细信息添加到传出请求的选项。 |
WebResourceLike |
要向远程服务器发出的 HTTP 请求的说明。 |
类型别名
Authenticator |
接收质询并解析具有字符串令牌的承诺的函数。 |
CommonRequestInfo |
调用 |
CommonRequestInit |
包含有关传出 HTTP 请求的信息的对象。 |
CommonResponse |
包含有关传入 HTTP 响应的信息的对象。 |
HttpMethods |
支持的 HTTP 方法列表。 |
HttpRequestBody |
可能的 HTTP 请求正文类型 |
Mapper |
映射器是库中使用的数据模型的定义。 这些数据模型是响应或参数中的作或客户端定义的一部分。 |
MapperType |
映射器的类型。 包括已知的映射器。 |
ParameterPath |
描述如何访问给定对象数据源中的特定属性的路径。 可以是一个属性名称、一个表示嵌套属性名称的数组,或者一组包含路径的多个命名属性(对于复杂对象值)。 |
ProxyOptions |
ProxySettings 的别名供将来使用。 |
RawHttpHeaders |
表示为简单 JSON 对象的 HttpHeaders 集合。 |
RequestPolicyFactory |
创建一个新的 RequestPolicy per-request,该请求使用提供的 nextPolicy。 |
TelemetryInfo |
遥测信息。 要包含在 User-Agent 字符串中的键/值对。 |
TransferProgressEvent |
响应上传或下载进度而触发。 |
枚举
HttpPipelineLogLevel |
可用于 HttpPipelineLogger 的不同级别的日志。 |
QueryCollectionFormat |
将用于将值数组联接在一起的查询参数值的格式。 |
RetryMode |
描述重试模式类型。 目前仅支持指数。 |
函数
函数详细信息
applyMixins(unknown, any[])
将 sourceCtors 原型上的属性应用于 targetCtor 的原型
function applyMixins(targetCtorParam: unknown, sourceCtors: any[])
参数
- targetCtorParam
-
unknown
- sourceCtors
-
any[]
需要从中获取属性的源对象的数组。
bearerTokenAuthenticationPolicy(TokenCredential, string | string[])
为 RequestPolicy 创建一个新工厂,该工厂将持有者令牌应用于请求的 Authorization
标头。
function bearerTokenAuthenticationPolicy(credential: TokenCredential, scopes: string | string[]): RequestPolicyFactory
参数
- credential
- TokenCredential
可提供持有者令牌的 TokenCredential 实现。
- scopes
-
string | string[]
持有者令牌适用的范围。
返回
createPipelineFromOptions(InternalPipelineOptions, RequestPolicyFactory)
基于给定的选项创建 HTTP 管道。
function createPipelineFromOptions(pipelineOptions: InternalPipelineOptions, authPolicyFactory?: RequestPolicyFactory): ServiceClientOptions
参数
- pipelineOptions
- InternalPipelineOptions
定义用于在 SDK 客户端的 HTTP 管道中配置策略的选项。
- authPolicyFactory
- RequestPolicyFactory
用于签名请求的可选身份验证策略工厂。
返回
delay(number, DelayOptions)
setTimeout 的包装器,用于在 timeInMs 毫秒后解析承诺。
function delay(timeInMs: number, options?: DelayOptions): Promise<void>
参数
- timeInMs
-
number
要延迟的毫秒数。
- options
- DelayOptions
延迟选项 - 当前中止选项
返回
Promise<void>
在 timeInMs 后解决的承诺
deserializationPolicy(DeserializationContentTypes, SerializerOptions)
创建一个新的序列化 RequestPolicyCreator,它将在 HTTP 管道传递时序列化 HTTP 请求正文。
function deserializationPolicy(deserializationContentTypes?: DeserializationContentTypes, parsingOptions?: SerializerOptions): RequestPolicyFactory
参数
- deserializationContentTypes
- DeserializationContentTypes
- parsingOptions
- SerializerOptions
返回
deserializeResponseBody(string[], string[], HttpOperationResponse, SerializerOptions)
给定要分析为 JSON 或 XML 的特定内容类型集,使用 HTTP 响应生成请求的 OperationSpec定义的结果对象。
function deserializeResponseBody(jsonContentTypes: string[], xmlContentTypes: string[], response: HttpOperationResponse, options?: SerializerOptions): Promise<HttpOperationResponse>
参数
- jsonContentTypes
-
string[]
将正文分析为 JSON 的响应内容类型。
- xmlContentTypes
-
string[]
将正文分析为 XML 的响应内容类型。
- response
- HttpOperationResponse
来自管道的 HTTP 响应。
- options
- SerializerOptions
序列化程序的选项,主要用于根据需要配置 XML 分析器。
返回
Promise<HttpOperationResponse>
HttpOperationResponse 对象,该对象可由 ServiceClient返回。
disableResponseDecompressionPolicy()
返回可用于创建 <xref:DisableResponseDecompressionPolicy>实例的请求策略工厂。
function disableResponseDecompressionPolicy(): RequestPolicyFactory
返回
encodeUri(string)
对 URI 进行编码。
function encodeUri(uri: string): string
参数
- uri
-
string
要编码的 URI。
返回
string
编码的 URI。
executePromisesSequentially(any[], unknown)
按顺序执行承诺数组。 此方法的灵感如下:https://pouchdb.com/2015/05/18/we-have-a-problem-with-promises.html。 关于承诺的真棒博客!
function executePromisesSequentially(promiseFactories: any[], kickstart: unknown): Promise<any>
参数
- promiseFactories
-
any[]
承诺工厂数组(返回 promise 的函数)
- kickstart
-
unknown
输入用于启动承诺链的第一个承诺。 如果未提供,则承诺链以未定义开头。
返回
Promise<any>
已解决或拒绝的承诺链
exponentialRetryPolicy(number, number, number)
只要指定了最大重试时间间隔,就会重试请求的次数,每次重试等待的时间都长于上次。
function exponentialRetryPolicy(retryCount?: number, retryInterval?: number, maxRetryInterval?: number): RequestPolicyFactory
参数
- retryCount
-
number
最大重试次数。
- retryInterval
-
number
重试之间的基时间。
- maxRetryInterval
-
number
重试之间的最长等待时间。
返回
flattenResponse(HttpOperationResponse, undefined | OperationResponse)
将 HttpOperationResponse 分析为规范化 HTTP 响应对象(RestResponse)。
function flattenResponse(_response: HttpOperationResponse, responseSpec: undefined | OperationResponse): RestResponse
参数
- _response
- HttpOperationResponse
http 响应的包装对象。
- responseSpec
-
undefined | OperationResponse
如何分析响应属性的映射器。
返回
- 规范化响应对象。
generateClientRequestIdPolicy(string)
创建一个策略,该策略将唯一请求 ID 分配给传出请求。
function generateClientRequestIdPolicy(requestIdHeaderName?: string): RequestPolicyFactory
参数
- requestIdHeaderName
-
string
将唯一 ID 分配给请求时要使用的标头的名称。
返回
generateUuid()
生成的 UUID
function generateUuid(): string
返回
string
RFC4122 v4 UUID。
getDefaultProxySettings(string)
将代理服务器的给定 URL 转换为 ProxySettings
,或者在未传递代理服务器时尝试从当前环境中检索 ProxySettings
。
function getDefaultProxySettings(proxyUrl?: string): ProxySettings | undefined
参数
- proxyUrl
-
string
代理的 URL
返回
ProxySettings | undefined
默认代理设置或未定义。
getDefaultUserAgentValue()
生成用户代理的默认方法。 使用此包中的静态信息,以及运行时提供的系统信息。
function getDefaultUserAgentValue(): string
返回
string
isDuration(string)
指示给定字符串是否采用 ISO 8601 格式。
function isDuration(value: string): boolean
参数
- value
-
string
要验证的 ISO 8601 持续时间格式的值。
返回
boolean
如果有效,则 true
否则 false
。
isTokenCredential(unknown)
测试对象以确定它是否实现 TokenCredential。
function isTokenCredential(credential: unknown): credential
参数
- credential
-
unknown
要测试的假定 TokenCredential。
返回
credential
isValidUuid(string)
将给定的 uuid 验证为字符串
function isValidUuid(uuid: string): boolean
参数
- uuid
-
string
作为需要验证的字符串的 uuid
返回
boolean
如果 uuid 有效,则为 True;否则为 false。
keepAlivePolicy(KeepAliveOptions)
创建一个策略,用于控制是否在将来的请求上维护 HTTP 连接。
function keepAlivePolicy(keepAliveOptions?: KeepAliveOptions): RequestPolicyFactory
参数
- keepAliveOptions
- KeepAliveOptions
保持活动状态选项。 默认情况下,为将来的请求维护 HTTP 连接。
返回
<xref:KeepAlivePolicy> 实例
logPolicy(LogPolicyOptions)
创建一个策略,用于记录有关传出请求和传入响应的信息。
function logPolicy(loggingOptions?: LogPolicyOptions): RequestPolicyFactory
参数
- loggingOptions
- LogPolicyOptions
日志记录选项。
返回
<xref:LogPolicy> 实例
operationOptionsToRequestOptionsBase<T>(T)
将 OperationOptions 转换为 RequestOptionsBase
function operationOptionsToRequestOptionsBase<T>(opts: T): RequestOptionsBase
参数
- opts
-
T
要转换为 RequestOptionsBase 的 OperationOptions 对象
返回
parseXML(string, SerializerOptions)
将给定的 XML 字符串转换为 JSON
function parseXML(str: string, opts?: SerializerOptions): Promise<any>
参数
- str
-
string
包含要分析为 JSON 的 XML 内容的字符串
- opts
- SerializerOptions
控制给定 xml 字符串分析的选项
返回
Promise<any>
promiseToCallback(Promise<any>)
警告
现已弃用此 API。
generated code should instead depend on responseToBody
将 Promise 转换为回调。
function promiseToCallback(promise: Promise<any>): (cb: Function) => void
参数
- promise
-
Promise<any>
要转换为回调的 Promise
返回
(cb: Function) => void
获取回调 (cb: Function) => void
的函数
promiseToServiceCallback<T>(Promise<HttpOperationResponse>)
将 Promise 转换为服务回调。
function promiseToServiceCallback<T>(promise: Promise<HttpOperationResponse>): (cb: ServiceCallback<T>) => void
参数
- promise
-
Promise<HttpOperationResponse>
要转换为服务回调的 HttpOperationResponse 的承诺
返回
(cb: ServiceCallback<T>) => void
获取服务回调的函数 (cb: ServiceCallback): void
proxyPolicy(ProxySettings, { customNoProxyList?: string[] })
允许将代理设置应用于所有请求的策略。 如果未传递静态设置,将从HTTPS_PROXY或HTTP_PROXY环境变量中检索它们。
function proxyPolicy(proxySettings?: ProxySettings, options?: { customNoProxyList?: string[] }): RequestPolicyFactory
参数
- proxySettings
- ProxySettings
要在每个请求上使用的 ProxySettings。
- options
-
{ customNoProxyList?: string[] }
其他设置,例如自定义NO_PROXY模式
返回
redirectPolicy(number)
创建重定向策略,如果响应到达“位置”标头,并且状态代码介于 300 和 307 之间,则向新目标发送请求。
function redirectPolicy(maximumRetries?: number): RequestPolicyFactory
参数
- maximumRetries
-
number
要遵循的最大重定向数。
返回
<xref:RedirectPolicy> 实例
serializeObject(unknown)
将可能包含二进制信息的对象序列化为纯对象、数组或字符串的实用工具函数。
function serializeObject(toSerialize: unknown): any
参数
- toSerialize
-
unknown
返回
any
signingPolicy(ServiceClientCredentials)
创建一个策略,通过调用提供的 authenticationProvider
的 signRequest
方法来签署传出请求。
function signingPolicy(authenticationProvider: ServiceClientCredentials): RequestPolicyFactory
参数
- authenticationProvider
- ServiceClientCredentials
身份验证提供程序。
返回
<xref:SigningPolicy>的实例。
stringifyXML(unknown, SerializerOptions)
将给定的 JSON 对象转换为 XML 字符串
function stringifyXML(obj: unknown, opts?: SerializerOptions): string
参数
- obj
-
unknown
要转换为 XML 字符串的 JSON 对象
- opts
- SerializerOptions
控制给定 JSON 对象的分析的选项
返回
string
stripRequest(WebResourceLike)
返回不包含授权标头的 Http 请求的剥离版本。
function stripRequest(request: WebResourceLike): WebResourceLike
参数
- request
- WebResourceLike
Http 请求对象
返回
Http 请求的剥离版本。
stripResponse(HttpOperationResponse)
返回仅包含正文、标头和状态的 Http 响应的剥离版本。
function stripResponse(response: HttpOperationResponse): any
参数
- response
- HttpOperationResponse
Http 响应
返回
any
Http 响应的剥离版本。
systemErrorRetryPolicy(number, number, number, number)
出现系统错误时重试的策略,由代码“ETIMEDOUT”、“ESOCKETTIMEDOUT”、“ECONNREFUSED”、“ECONNRESET”或“ENOENT”标识。
function systemErrorRetryPolicy(retryCount?: number, retryInterval?: number, minRetryInterval?: number, maxRetryInterval?: number): RequestPolicyFactory
参数
- retryCount
-
number
最大重试次数。
- retryInterval
-
number
客户端重试间隔(以毫秒为单位)。
- minRetryInterval
-
number
最小重试间隔(以毫秒为单位)。
- maxRetryInterval
-
number
最大重试间隔(以毫秒为单位)。
返回
<xref:SystemErrorRetryPolicy> 实例
throttlingRetryPolicy()
创建一个策略,如果响应指示请求因限制原因而失败,则重新发送请求。
例如,如果响应包含 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(): RequestPolicyFactory
返回
tracingPolicy(TracingPolicyOptions)
创建一个策略,用于包装具有跟踪范围的传出请求。
function tracingPolicy(tracingOptions?: TracingPolicyOptions): RequestPolicyFactory
参数
- tracingOptions
- TracingPolicyOptions
跟踪选项。
返回
<xref:TracingPolicy> 类的实例。
userAgentPolicy(TelemetryInfo)
返回一个策略,该策略基于给定的 TelemetryInfo将用户代理标头添加到传出请求。
function userAgentPolicy(userAgentData?: TelemetryInfo): RequestPolicyFactory
参数
- userAgentData
- TelemetryInfo
遥测信息。
返回
新的 <xref:UserAgentPolicy>。