ServiceClientOptions interface
建立用戶端時要提供的選項。
屬性
agent |
HTTP 和 HTTPS 代理程式,將用於每個 HTTP 要求(僅限Node.js)。 |
base |
如果指定:
如果未指定:
|
client |
如果指定,GenerateRequestIdPolicy 將會新增至 HTTP 管線,以將標頭新增至具有此標頭名稱的所有傳出要求,並以隨機 UUID 作為要求標識符。 |
deserialization |
將與 JSON 或 XML 串行化相關聯的內容類型。 |
generate |
是否要為每個 HTTP 要求產生用戶端要求標識碼標頭。 |
http |
將用來傳送 HTTP 要求的 HttpClient。 |
http |
HttpPipelineLogger,可用來偵錯 HTTP 管線內的 RequestPolicies。 |
no |
如果設定為 true,請關閉預設重試原則。 |
proxy |
將用於每個 HTTP 要求的 Proxy 設定(僅限Node.js)。 |
redirect |
如何處理重新導向響應的選項。 |
request |
呼叫以建立 RequestPolicy 管線的處理站陣列,用來在線路上傳送 HTTP 要求,或採用 defaultRequestPolicyFactories 的函式,並傳回將使用的 requestPolicyFactories。 |
rp |
取得或設定 AutomaticRPRegistration 的重試逾時,以秒為單位。 預設值為 30。 |
user |
傳送要求時要設定為遙測標頭的字串,或接受預設使用者代理程式字串的函式,並傳回將使用的使用者代理程式字串。 |
user |
傳送要求時,要用於遙測標頭的標頭名稱。 如果未指定此專案,則在 Node.js 上執行時,將會使用 “User-Agent”,並在瀏覽器中執行時使用 “x-ms-command-name”。 |
with |
是否要在瀏覽器中的 CORS 要求中包含認證。 如需詳細資訊,請參閱 https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest/withCredentials。 |
屬性詳細資料
agentSettings
baseUri
如果指定:
- 此
baseUri
會成為此 ServiceClient 要求所針對的基底 URI。 - 如果
baseUri
符合已知的資源管理員端點,而且TokenCredential
是透過建構函式傳遞,則此baseUri
會定義要${options.baseUri}/.default
的getToken
範圍。 否則,範圍會預設為 「https://management.azure.com/.default"。
如果未指定:
- 所有 OperationSpecs 都必須包含 baseUrl 屬性。
- 如果透過建構函式傳遞
TokenCredential
,getToken
範圍會設定為 「https://management.azure.com/.default"。
baseUri?: string
屬性值
string
clientRequestIdHeaderName
如果指定,GenerateRequestIdPolicy 將會新增至 HTTP 管線,以將標頭新增至具有此標頭名稱的所有傳出要求,並以隨機 UUID 作為要求標識符。
clientRequestIdHeaderName?: string
屬性值
string
deserializationContentTypes
將與 JSON 或 XML 串行化相關聯的內容類型。
deserializationContentTypes?: DeserializationContentTypes
屬性值
generateClientRequestIdHeader
是否要為每個 HTTP 要求產生用戶端要求標識碼標頭。
generateClientRequestIdHeader?: boolean
屬性值
boolean
httpClient
httpPipelineLogger
HttpPipelineLogger,可用來偵錯 HTTP 管線內的 RequestPolicies。
httpPipelineLogger?: HttpPipelineLogger
屬性值
noRetryPolicy
如果設定為 true,請關閉預設重試原則。
noRetryPolicy?: boolean
屬性值
boolean
proxySettings
redirectOptions
requestPolicyFactories
呼叫以建立 RequestPolicy 管線的處理站陣列,用來在線路上傳送 HTTP 要求,或採用 defaultRequestPolicyFactories 的函式,並傳回將使用的 requestPolicyFactories。
requestPolicyFactories?: RequestPolicyFactory[] | (defaultRequestPolicyFactories: RequestPolicyFactory[]) => void | RequestPolicyFactory[]
屬性值
RequestPolicyFactory[] | (defaultRequestPolicyFactories: RequestPolicyFactory[]) => void | RequestPolicyFactory[]
rpRegistrationRetryTimeout
取得或設定 AutomaticRPRegistration 的重試逾時,以秒為單位。 預設值為 30。
rpRegistrationRetryTimeout?: number
屬性值
number
userAgent
傳送要求時要設定為遙測標頭的字串,或接受預設使用者代理程式字串的函式,並傳回將使用的使用者代理程式字串。
userAgent?: string | (defaultUserAgent: string) => string
屬性值
string | (defaultUserAgent: string) => string
userAgentHeaderName
傳送要求時,要用於遙測標頭的標頭名稱。 如果未指定此專案,則在 Node.js 上執行時,將會使用 “User-Agent”,並在瀏覽器中執行時使用 “x-ms-command-name”。
userAgentHeaderName?: string | (defaultUserAgentHeaderName: string) => string
屬性值
string | (defaultUserAgentHeaderName: string) => string
withCredentials
是否要在瀏覽器中的 CORS 要求中包含認證。 如需詳細資訊,請參閱 https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest/withCredentials。
withCredentials?: boolean
屬性值
boolean