@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 |
為傳出要求設定 Proxy 的選項(僅限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 |
指數重試策略的程式識別碼。 |
| form |
formDataPolicy 的程式識別碼。 |
| log |
logPolicy 的程式識別碼。 |
| nd |
ndJsonPolicy 的程式識別碼。 |
| proxy |
proxyPolicy 的程式識別碼。 |
| redirect |
redirectPolicy 的程式識別碼。 |
| set |
setClientRequestIdPolicy 的程式識別碼。 |
| system |
systemErrorRetryPolicy 的程式識別碼。 |
| throttling |
throttlingRetryPolicy 的程式識別碼。 |
| tracing |
traceingPolicy 的程式識別碼。 |
| user |
userAgentPolicy 的程式識別碼。 |
函式詳細資料
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)
此方法會將 Proxy URL 轉換成 ProxySettings,以搭配 ProxyPolicy 使用。
如果未指定自變數,它會嘗試從環境變數剖析 proxy URL HTTPS_PROXY 或 HTTP_PROXY。
function getDefaultProxySettings(proxyUrl?: string): ProxySettings | undefined
參數
- proxyUrl
-
string
要使用的 Proxy URL。 可能包含驗證資訊。
傳回
ProxySettings | undefined
logPolicy(LogPolicyOptions)
記錄所有要求和響應的原則。
function logPolicy(options?: LogPolicyOptions): PipelinePolicy
參數
- options
- LogPolicyOptions
設定logPolicy選項。
傳回
ndJsonPolicy()
proxyPolicy(ProxySettings)
允許將 Proxy 設定套用至所有要求的原則。 如果未傳遞靜態設定,則會從HTTPS_PROXY或HTTP_PROXY環境變數擷取它們。
function proxyPolicy(proxySettings?: ProxySettings): PipelinePolicy
參數
- proxySettings
- ProxySettings
要用於每個要求的 ProxySettings。
傳回
redirectPolicy(RedirectPolicyOptions)
要遵循伺服器位置標頭的原則,以支援伺服器端重新導向。
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()
當伺服器傳送具有 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 建立 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
指數重試策略的程式識別碼。
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
userAgentPolicy 的程式識別碼。
userAgentPolicyName: "userAgentPolicy"
類型
"userAgentPolicy"