CosmosClientOptions.ApplicationRegion Propriété

Définition

Espace de noms:

Microsoft.Azure.Cosmos

Assembly:

Microsoft.Azure.Cosmos.Client.dll

Paquet:

Microsoft.Azure.Cosmos v3.39.0

Source:

CosmosClientOptions.cs

Obtient ou définit l’emplacement où l’application s’exécute. Cela influence le choix du KIT de développement logiciel (SDK) pour l’interaction du service Azure Cosmos DB.

public string ApplicationRegion { get; set; }

member this.ApplicationRegion : string with get, set

Public Property ApplicationRegion As String

Valeur de propriété

String

Exemples

Si un compte est configuré avec plusieurs régions, notamment USA Ouest, USA Est et Europe Ouest, la configuration d’un client comme l’exemple ci-dessous entraînerait la génération d’une région préférée triée par cosmos en fonction de la proximité avec USA Est. CosmosClient enverra des demandes à USA Est, si cette région devient indisponible, elle sera de secours vers USA Ouest (deuxième à proximité), et enfin vers l’Europe Ouest si USA Ouest devient indisponible.

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

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

Remarques

Lors de l’initialisation de CosmosClient, les informations de compte, y compris les régions disponibles, sont obtenues à partir de Endpoint. CosmosClient utilise la valeur de ApplicationRegion pour remplir la liste par défaut avec les régions disponibles du compte classées par proximité géographique de la région indiquée. Si la valeur de ApplicationRegion n’est pas une région disponible dans le compte, la liste par défaut est toujours remplie selon le même mécanisme, mais n’inclut pas la région indiquée.

Si, lors de l’initialisation de CosmosClient, le Endpoint n’est pas accessible, le CosmosClient tente de récupérer et d’obtenir les informations de compte qui émettent des demandes à tous les Regions triés à proximité du ApplicationRegion. Pour un contrôle plus granulaire sur les régions sélectionnées ou pour définir une liste basée sur des critères personnalisés, utilisez ApplicationPreferredRegions au lieu de ApplicationRegion.

Pour plus d’informations, consultez également Diagnostiquer et résoudre les problèmes de disponibilité des KITS de développement logiciel (SDK) Cosmos .

Cette configuration est une alternative à , l’une ou l’autre ApplicationPreferredRegionspeut être définie, mais pas les deux.

Voir aussi

• WithApplicationRegion(String)