Freigeben über


WebSearchClientOptions interface

Eine Schnittstelle, die WebSearchClientOptions darstellt.

Extends

Eigenschaften

endpoint

Unterstützte Cognitive Services-Endpunkte (Protokoll und Hostname, z. B. "https://westus.api.cognitive.microsoft.com", "https://api.cognitive.microsoft.com"). Standardwert: 'https://api.cognitive.microsoft.com'.

Geerbte Eigenschaften

agentSettings

HTTP- und HTTPS-Agents, die für jede HTTP-Anforderung verwendet werden ( nurNode.js).

baseUri

Wenn angegeben:

  • Dieser baseUri wird zum Basis-URI, für den Anforderungen für diesen ServiceClient gestellt werden.
  • Wenn die baseUri einem bekannten Ressourcen-Manager-Endpunkt entspricht und ein TokenCredential über den Konstruktor übergeben wurde, definiert diese baseUri den getToken Bereich, der ${options.baseUri}/.defaultwerden soll. Andernfalls würde der Bereich standardmäßig auf "https://management.azure.com/.default"" festgelegt.

Wenn sie nicht angegeben ist:

  • Alle OperationSpecs müssen eine baseUrl-Eigenschaft enthalten.
  • Wenn ein TokenCredential über den Konstruktor übergeben wurde, wird der getToken Bereich auf "https://management.azure.com/.default"" festgelegt.
clientRequestIdHeaderName

Wenn angegeben, wird der HTTP-Pipeline eine GenerateRequestIdPolicy hinzugefügt, die allen ausgehenden Anforderungen mit diesem Headernamen und einer zufälligen UUID als Anforderungs-ID einen Header hinzufügt.

deserializationContentTypes

Die Inhaltstypen, die der JSON- oder XML-Serialisierung zugeordnet werden.

generateClientRequestIdHeader

Gibt an, ob für jede HTTP-Anforderung ein Clientanforderungs-ID-Header generiert werden soll.

httpClient

Der HttpClient, der zum Senden von HTTP-Anforderungen verwendet wird.

httpPipelineLogger

Der HttpPipelineLogger, der zum Debuggen von RequestPolicies innerhalb der HTTP-Pipeline verwendet werden kann.

noRetryPolicy

Wenn dieser Wert auf "true" festgelegt ist, deaktivieren Sie die Standardrichtlinie für wiederholungsversuche.

proxySettings

Proxyeinstellungen, die für jede HTTP-Anforderung verwendet werden ( nurNode.js).

redirectOptions

Optionen für die Behandlung von Umleitungsantworten.

requestPolicyFactories

Ein Array von Fabriken, die aufgerufen werden, um die RequestPolicy-Pipeline zu erstellen, die zum Senden einer HTTP-Anforderung an die Verbindung verwendet wird, oder eine Funktion, die in den defaultRequestPolicyFactories verwendet wird, und gibt die requestPolicyFactories zurück, die verwendet werden.

rpRegistrationRetryTimeout

Dient zum Abrufen oder Festlegen des Wiederholungstimeouts in Sekunden für AutomaticRPRegistration. Der Standardwert ist 30.

userAgent

Die Zeichenfolge, die beim Senden der Anforderung auf den Telemetrieheader festgelegt werden soll, oder eine Funktion, die die Standard-Benutzer-Agent-Zeichenfolge einnimmt und die verwendete Benutzer-Agent-Zeichenfolge zurückgibt.

userAgentHeaderName

Der Headername, der beim Senden der Anforderung für den Telemetrieheader verwendet werden soll. Wenn dies nicht angegeben ist, wird "User-Agent" beim Ausführen auf Node.js verwendet, und "x-ms-command-name" wird verwendet, wenn er in einem Browser ausgeführt wird.

withCredentials

Gibt an, ob Anmeldeinformationen in CORS-Anforderungen im Browser eingeschlossen werden sollen. Weitere Informationen finden Sie unter https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest/withCredentials.

Details zur Eigenschaft

endpoint

Unterstützte Cognitive Services-Endpunkte (Protokoll und Hostname, z. B. "https://westus.api.cognitive.microsoft.com", "https://api.cognitive.microsoft.com"). Standardwert: 'https://api.cognitive.microsoft.com'.

endpoint?: string

Eigenschaftswert

string

Geerbte Eigenschaftsdetails

agentSettings

HTTP- und HTTPS-Agents, die für jede HTTP-Anforderung verwendet werden ( nurNode.js).

agentSettings?: AgentSettings

Eigenschaftswert

von ServiceClientOptions.agentSettings geerbt

baseUri

Wenn angegeben:

  • Dieser baseUri wird zum Basis-URI, für den Anforderungen für diesen ServiceClient gestellt werden.
  • Wenn die baseUri einem bekannten Ressourcen-Manager-Endpunkt entspricht und ein TokenCredential über den Konstruktor übergeben wurde, definiert diese baseUri den getToken Bereich, der ${options.baseUri}/.defaultwerden soll. Andernfalls würde der Bereich standardmäßig auf "https://management.azure.com/.default"" festgelegt.

Wenn sie nicht angegeben ist:

  • Alle OperationSpecs müssen eine baseUrl-Eigenschaft enthalten.
  • Wenn ein TokenCredential über den Konstruktor übergeben wurde, wird der getToken Bereich auf "https://management.azure.com/.default"" festgelegt.
baseUri?: string

Eigenschaftswert

string

Geerbt von ServiceClientOptions.baseUri

clientRequestIdHeaderName

Wenn angegeben, wird der HTTP-Pipeline eine GenerateRequestIdPolicy hinzugefügt, die allen ausgehenden Anforderungen mit diesem Headernamen und einer zufälligen UUID als Anforderungs-ID einen Header hinzufügt.

clientRequestIdHeaderName?: string

Eigenschaftswert

string

Geerbt von ServiceClientOptions.clientRequestIdHeaderName

deserializationContentTypes

Die Inhaltstypen, die der JSON- oder XML-Serialisierung zugeordnet werden.

deserializationContentTypes?: DeserializationContentTypes

Eigenschaftswert

Geerbt von ServiceClientOptions.deserializationContentTypes

generateClientRequestIdHeader

Gibt an, ob für jede HTTP-Anforderung ein Clientanforderungs-ID-Header generiert werden soll.

generateClientRequestIdHeader?: boolean

Eigenschaftswert

boolean

Geerbt von ServiceClientOptions.generateClientRequestIdHeader

httpClient

Der HttpClient, der zum Senden von HTTP-Anforderungen verwendet wird.

httpClient?: HttpClient

Eigenschaftswert

geerbt von ServiceClientOptions.httpClient

httpPipelineLogger

Der HttpPipelineLogger, der zum Debuggen von RequestPolicies innerhalb der HTTP-Pipeline verwendet werden kann.

httpPipelineLogger?: HttpPipelineLogger

Eigenschaftswert

geerbt von ServiceClientOptions.httpPipelineLogger

noRetryPolicy

Wenn dieser Wert auf "true" festgelegt ist, deaktivieren Sie die Standardrichtlinie für wiederholungsversuche.

noRetryPolicy?: boolean

Eigenschaftswert

boolean

geerbt von ServiceClientOptions.noRetryPolicy

proxySettings

Proxyeinstellungen, die für jede HTTP-Anforderung verwendet werden ( nurNode.js).

proxySettings?: ProxySettings

Eigenschaftswert

geerbt von ServiceClientOptions.proxySettings

redirectOptions

Optionen für die Behandlung von Umleitungsantworten.

redirectOptions?: RedirectOptions

Eigenschaftswert

Geerbt von ServiceClientOptions.redirectOptions

requestPolicyFactories

Ein Array von Fabriken, die aufgerufen werden, um die RequestPolicy-Pipeline zu erstellen, die zum Senden einer HTTP-Anforderung an die Verbindung verwendet wird, oder eine Funktion, die in den defaultRequestPolicyFactories verwendet wird, und gibt die requestPolicyFactories zurück, die verwendet werden.

requestPolicyFactories?: RequestPolicyFactory[] | (defaultRequestPolicyFactories: RequestPolicyFactory[]) => void | RequestPolicyFactory[]

Eigenschaftswert

RequestPolicyFactory[] | (defaultRequestPolicyFactories: RequestPolicyFactory[]) => void | RequestPolicyFactory[]

Geerbt von ServiceClientOptions.requestPolicyFactories

rpRegistrationRetryTimeout

Dient zum Abrufen oder Festlegen des Wiederholungstimeouts in Sekunden für AutomaticRPRegistration. Der Standardwert ist 30.

rpRegistrationRetryTimeout?: number

Eigenschaftswert

number

geerbt von ServiceClientOptions.rpRegistrationRetryTimeout

userAgent

Die Zeichenfolge, die beim Senden der Anforderung auf den Telemetrieheader festgelegt werden soll, oder eine Funktion, die die Standard-Benutzer-Agent-Zeichenfolge einnimmt und die verwendete Benutzer-Agent-Zeichenfolge zurückgibt.

userAgent?: string | (defaultUserAgent: string) => string

Eigenschaftswert

string | (defaultUserAgent: string) => string

geerbt von ServiceClientOptions.userAgent

userAgentHeaderName

Der Headername, der beim Senden der Anforderung für den Telemetrieheader verwendet werden soll. Wenn dies nicht angegeben ist, wird "User-Agent" beim Ausführen auf Node.js verwendet, und "x-ms-command-name" wird verwendet, wenn er in einem Browser ausgeführt wird.

userAgentHeaderName?: string | (defaultUserAgentHeaderName: string) => string

Eigenschaftswert

string | (defaultUserAgentHeaderName: string) => string

geerbt von ServiceClientOptions.userAgentHeaderName

withCredentials

Gibt an, ob Anmeldeinformationen in CORS-Anforderungen im Browser eingeschlossen werden sollen. Weitere Informationen finden Sie unter https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest/withCredentials.

withCredentials?: boolean

Eigenschaftswert

boolean

geerbt von ServiceClientOptions.withCredentials