CosmosClientOptions.ApplicationRegion 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 o establece la ubicación donde se ejecuta la aplicación. Esto influirá en la elección del SDK para la interacción del servicio Azure Cosmos DB.

public string ApplicationRegion { get; set; }

member this.ApplicationRegion : string with get, set

Public Property ApplicationRegion As String

Valor de propiedad

String

Ejemplos

Si una cuenta está configurada con varias regiones, como Oeste de EE. UU., Este de EE. UU. y Oeste de Europa, la configuración de un cliente como el ejemplo siguiente daría como resultado que CosmosClient generara una región preferida ordenada basada en la proximidad a Este de EE. UU. CosmosClient enviará solicitudes al Este de EE. UU., si esa región deja de estar disponible, se revertirá a Oeste de EE. UU. (segundo por proximidad) y, por último, a Oeste de Europa si Oeste de EE. UU. deja de estar disponible.

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

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 ApplicationRegion para rellenar la lista preferida con las regiones disponibles de la cuenta ordenadas por proximidad geográfica a la región indicada. Si el valor de ApplicationRegion no es una región disponible en la cuenta, la lista preferida se sigue rellenando siguiendo el mismo mecanismo, pero no incluiría la región indicada.

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 todas las Regions solicitudes ordenadas por proximidad a ApplicationRegion. Para un control más pormenorizado sobre las regiones seleccionadas o para definir una lista basada en criterios personalizados, use ApplicationPreferredRegions en lugar de ApplicationRegion.

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

Esta configuración es una alternativa a ApplicationPreferredRegions, cualquiera de las dos se puede establecer, pero no ambas.

Consulte también

• WithApplicationRegion(String)