Database Accounts - Failover Priority Change
Cambia la prioridad de conmutación por error de la cuenta de base de datos de Azure Cosmos DB. Una prioridad de conmutación por error de 0 indica una región de escritura. Valor máximo de una prioridad de conmutación por error = (número total de regiones - 1). Los valores de prioridad de conmutación por error deben ser únicos para cada una de las regiones en las que existe la cuenta de base de datos.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/failoverPriorityChange?api-version=2023-11-15
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
account
|
path | True |
string |
Nombre de la cuenta de base de datos de Cosmos DB. Regex pattern: |
resource
|
path | True |
string |
Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas. |
subscription
|
path | True |
string |
Identificador de la suscripción de destino. |
api-version
|
query | True |
string |
Versión de API que se usará para la operación. |
Cuerpo de la solicitud
Nombre | Requerido | Tipo | Description |
---|---|---|---|
failoverPolicies | True |
Lista de directivas de conmutación por error. |
Respuestas
Nombre | Tipo | Description |
---|---|---|
202 Accepted |
Accepted. La operación de cambio de directiva de conmutación por error se completará de forma asincrónica. Headers
|
|
204 No Content |
Ningún contenido |
Seguridad
azure_auth
Flujo OAuth2 de Azure Active Directory
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nombre | Description |
---|---|
user_impersonation | Suplantación de su cuenta de usuario |
Ejemplos
CosmosDBDatabaseAccountFailoverPriorityChange
Sample Request
POST https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1-failover/failoverPriorityChange?api-version=2023-11-15
{
"failoverPolicies": [
{
"locationName": "eastus",
"failoverPriority": 0
},
{
"locationName": "westus",
"failoverPriority": 1
}
]
}
Sample Response
Location: https://centraluseuap.management.azure.com/subscriptions/d1eb41bc-1b7f-4404-bd2a-8568c222852d/providers/Microsoft.DocumentDB/locations/centraluseuap/operationsStatus/fdd04b7b-86d5-460f-b19e-386230348bcc?api-version=2023-11-15
Azure-AsyncOperation: https://centraluseuap.management.azure.com/subscriptions/d1eb41bc-1b7f-4404-bd2a-8568c222852d/providers/Microsoft.DocumentDB/locations/centraluseuap/operationsStatus/fdd04b7b-86d5-460f-b19e-386230348bcc?api-version=2023-11-15
Definiciones
Nombre | Description |
---|---|
Failover |
Lista de nuevas directivas de conmutación por error para el cambio de prioridad de conmutación por error. |
Failover |
Directiva de conmutación por error de una región determinada de una cuenta de base de datos. |
FailoverPolicies
Lista de nuevas directivas de conmutación por error para el cambio de prioridad de conmutación por error.
Nombre | Tipo | Description |
---|---|---|
failoverPolicies |
Lista de directivas de conmutación por error. |
FailoverPolicy
Directiva de conmutación por error de una región determinada de una cuenta de base de datos.
Nombre | Tipo | Description |
---|---|---|
failoverPriority |
integer |
Prioridad de conmutación por error de la región. Una prioridad de conmutación por error de 0 indica una región de escritura. Valor máximo de una prioridad de conmutación por error = (número total de regiones - 1). Los valores de prioridad de conmutación por error deben ser únicos para cada una de las regiones en las que existe la cuenta de base de datos. |
id |
string |
Identificador único de la región en la que se replica la cuenta de base de datos. Ejemplo: <accountName-locationName>><. |
locationName |
string |
Nombre de la región en la que existe la cuenta de base de datos. |