@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

原則會分階段執行。 執行順序為:

  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)

此方法會將 Proxy URL 轉換成 ProxySettings,以搭配 ProxyPolicy 使用。 如果未指定自變數,它會嘗試從環境變數剖析 proxy URL HTTPS_PROXYHTTP_PROXY

logPolicy(LogPolicyOptions)

記錄所有要求和響應的原則。

ndJsonPolicy()

ndJsonPolicy 是用來控制每個要求保持運作設定的原則。

proxyPolicy(ProxySettings)

允許將 Proxy 設定套用至所有要求的原則。 如果未傳遞靜態設定,則會從HTTPS_PROXY或HTTP_PROXY環境變數擷取它們。

redirectPolicy(RedirectPolicyOptions)

要遵循伺服器位置標頭的原則,以支援伺服器端重新導向。

setClientRequestIdPolicy(string)

每個 PipelineRequest 在建立時都會取得唯一標識碼。 此原則會透過 HTTP 標頭傳遞該唯一標識碼,以啟用更好的遙測和追蹤。

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 建立 OpenTelemetry Spans 的簡單原則。 不會記錄沒有父 Span 的要求。

userAgentPolicy(UserAgentPolicyOptions)

設定 User-Agent 標頭(或對等專案)以反映連結庫版本的原則。

變數

bearerTokenAuthenticationPolicyName

持有者TokenAuthenticationPolicy的程式識別碼。

decompressResponsePolicyName

decompressResponsePolicy 的程式識別碼。

expontentialRetryPolicyName

指數重試策略的程式識別碼。

formDataPolicyName

formDataPolicy 的程式識別碼。

logPolicyName

logPolicy 的程式識別碼。

ndJsonPolicyName

ndJsonPolicy 的程式識別碼。

proxyPolicyName

proxyPolicy 的程式識別碼。

redirectPolicyName

redirectPolicy 的程式識別碼。

setClientRequestIdPolicyName

setClientRequestIdPolicy 的程式識別碼。

systemErrorRetryPolicyName

systemErrorRetryPolicy 的程式識別碼。

throttlingRetryPolicyName

throttlingRetryPolicy 的程式識別碼。

tracingPolicyName

traceingPolicy 的程式識別碼。

userAgentPolicyName

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)

此方法會將 Proxy URL 轉換成 ProxySettings,以搭配 ProxyPolicy 使用。 如果未指定自變數,它會嘗試從環境變數剖析 proxy URL HTTPS_PROXYHTTP_PROXY

function getDefaultProxySettings(proxyUrl?: string): ProxySettings | undefined

參數

proxyUrl

string

要使用的 Proxy URL。 可能包含驗證資訊。

傳回

ProxySettings | undefined

logPolicy(LogPolicyOptions)

記錄所有要求和響應的原則。

function logPolicy(options?: LogPolicyOptions): PipelinePolicy

參數

options
LogPolicyOptions

設定logPolicy選項。

傳回

ndJsonPolicy()

ndJsonPolicy 是用來控制每個要求保持運作設定的原則。

function ndJsonPolicy(): PipelinePolicy

傳回

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()

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"