CosmosClientOptions.ApplicationRegion Eigenschaft

Definition

Namespace:

Microsoft.Azure.Cosmos

Assembly:

Microsoft.Azure.Cosmos.Client.dll

Paket:

Microsoft.Azure.Cosmos v3.39.0

Quelle:

CosmosClientOptions.cs

Ruft den Speicherort ab, an dem die Anwendung ausgeführt wird, oder legt diese fest. Dies beeinflusst die Auswahl des SDK für die Azure Cosmos DB-Dienstinteraktion.

public string ApplicationRegion { get; set; }

member this.ApplicationRegion : string with get, set

Public Property ApplicationRegion As String

Eigenschaftswert

String

Beispiele

Wenn ein Konto mit mehreren Regionen konfiguriert ist, einschließlich USA, Westen, USA, Osten und Europa, Westen, würde die Konfiguration eines Clients wie im folgenden Beispiel dazu führen, dass CosmosClient basierend auf der Nähe von USA, Osten eine sortierte bevorzugte Region generiert. Der CosmosClient sendet Anforderungen an "USA, Osten". Wenn diese Region nicht mehr verfügbar ist, wird ein Fallback auf "USA, Westen" (zweiter In der Nähe) und schließlich nach Europa, "Europa, Westen" durchgeführt, wenn "USA, Westen" nicht mehr verfügbar ist.

CosmosClientOptions clientOptions = new CosmosClientOptions()
{
    ApplicationRegion = Regions.EastUS
};

CosmosClient client = new CosmosClient("endpoint", "key", clientOptions);

Hinweise

Während der CosmosClient-Initialisierung werden die Kontoinformationen, einschließlich der verfügbaren Regionen, aus dem Endpointabgerufen. CosmosClient verwendet den Wert von ApplicationRegion , um die bevorzugte Liste mit den verfügbaren Regionen des Kontos aufzufüllen, die nach geografischer Nähe zur angegebenen Region sortiert sind. Wenn der Wert von ApplicationRegion keine verfügbare Region im Konto ist, wird die bevorzugte Liste weiterhin nach demselben Mechanismus aufgefüllt, enthält jedoch nicht die angegebene Region.

Wenn während der CosmosClient-Initialisierung nicht Endpoint erreichbar ist, versucht der CosmosClient, die Kontoinformationen wiederherzustellen und abzurufen, die Anforderungen an alle Regions geordneten geordneten Nach der Nähe zu erhalten ApplicationRegion. Verwenden Sie ApplicationPreferredRegions anstelle von ApplicationRegion, um die ausgewählten Regionen präziser zu steuern oder eine Liste basierend auf benutzerdefinierten Kriterien zu definieren.

Weitere Informationen finden Sie unter Diagnose und Problembehandlung für die Verfügbarkeit von Cosmos SDKs .

Diese Konfiguration ist eine Alternative zu ApplicationPreferredRegions, die entweder festgelegt werden kann, aber nicht beide.

Weitere Informationen

• WithApplicationRegion(String)