ServiceClientOptions interface
建立用戶端時要提供的選項。
屬性
client |
如果指定,GenerateRequestIdPolicy 將會新增至 HTTP 管線,此管線會將標頭新增至具有此標頭名稱的所有傳出要求,以及隨機 UUID 作為要求識別碼。 |
credential |
如果指定,將會用來建置 BearerTokenAuthenticationPolicy。 |
deserialization |
與 JSON 或 XML 序列化相關聯的內容類型。 |
generate |
是否要為每個 HTTP 要求產生用戶端要求識別碼標頭。 |
http |
將用來傳送 HTTP 要求的 HttpClient。 |
http |
可用來偵錯 HTTP 管線內 RequestPolicies 的 HttpPipelineLogger。 |
no |
如果設定為 true,請關閉預設重試原則。 |
proxy |
將用於每個 HTTP 要求的 Proxy 設定 (Node.js 只會) 。 |
request |
呼叫以建立 RequestPolicy 管線的處理站陣列,用來在線上傳送 HTTP 要求,或接受 defaultRequestPolicyFactories 的函式,並傳回將使用的 requestPolicyFactories。 |
rp |
取得或設定 AutomaticRPRegistration 的重試逾時,以秒為單位。 預設值為 30。 |
user |
傳送要求時要設定為遙測標頭的字串,或接受預設使用者代理程式字串的函式,並傳回將使用的使用者代理程式字串。 |
user |
傳送要求時,要用於遙測標頭的標頭名稱。 如果未指定此專案,則在Node.js上執行時,將會使用 「User-Agent」,並在瀏覽器中執行時使用 「x-ms-useragent」。 |
with |
是否要在瀏覽器中的 CORS 要求中包含認證。 如需相關資訊,請參閱 https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest/withCredentials 。 |
屬性詳細資料
clientRequestIdHeaderName
如果指定,GenerateRequestIdPolicy 將會新增至 HTTP 管線,此管線會將標頭新增至具有此標頭名稱的所有傳出要求,以及隨機 UUID 作為要求識別碼。
clientRequestIdHeaderName?: string
屬性值
string
credentialScopes
如果指定,將會用來建置 BearerTokenAuthenticationPolicy。
credentialScopes?: string | string[]
屬性值
string | string[]
deserializationContentTypes
與 JSON 或 XML 序列化相關聯的內容類型。
deserializationContentTypes?: DeserializationContentTypes
屬性值
generateClientRequestIdHeader
是否要為每個 HTTP 要求產生用戶端要求識別碼標頭。
generateClientRequestIdHeader?: boolean
屬性值
boolean
httpClient
httpPipelineLogger
可用來偵錯 HTTP 管線內 RequestPolicies 的 HttpPipelineLogger。
httpPipelineLogger?: HttpPipelineLogger
屬性值
noRetryPolicy
如果設定為 true,請關閉預設重試原則。
noRetryPolicy?: boolean
屬性值
boolean
proxySettings
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-useragent」。
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