CosmosClientOptions.ApplicationPreferredRegions Propiedad

Definición

Espacio de nombres:

Microsoft.Azure.Cosmos

Ensamblado:

Microsoft.Azure.Cosmos.Client.dll

Paquete:

Microsoft.Azure.Cosmos v3.39.0

Source:

CosmosClientOptions.cs

Obtiene y establece las regiones preferidas para las cuentas de base de datos con replicación geográfica en el servicio Azure Cosmos DB.

public System.Collections.Generic.IReadOnlyList<string> ApplicationPreferredRegions { get; set; }

member this.ApplicationPreferredRegions : System.Collections.Generic.IReadOnlyList<string> with get, set

Public Property ApplicationPreferredRegions As IReadOnlyList(Of String)

Valor de propiedad

IReadOnlyList<String>

Ejemplos

CosmosClientOptions clientOptions = new CosmosClientOptions()
{
    ApplicationPreferredRegions = new List<string>(){ Regions.EastUS, Regions.WestUS }
};

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

Comentarios

Durante la inicialización de CosmosClient, la información de la cuenta, incluidas las regiones disponibles, se obtiene de Endpoint. CosmosClient usará el valor de ApplicationPreferredRegions para rellenar la lista preferida con las regiones disponibles de la cuenta que se cruzan con su valor. Si el valor de ApplicationPreferredRegions contiene regiones que no son una región disponible en la cuenta, se omitirán los valores. Si estas regiones no válidas se agregan más adelante a la cuenta, CosmosClient las usará si son superiores en el orden de preferencia.

Si durante la inicialización de CosmosClient, Endpoint no es accesible, CosmosClient intentará recuperar y obtener la información de la cuenta que emite solicitudes a las regiones en el orden en ApplicationPreferredRegions que se muestran.

Consulte también Diagnóstico y solución de problemas de disponibilidad de los SDK de Cosmos para obtener más detalles.

Esta configuración es una alternativa a ApplicationRegion, ya sea que se puede establecer, pero no ambas.