Failover Groups - Create Or Update
Crea o actualiza un grupo de conmutación por error.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/failoverGroups/{failoverGroupName}?api-version=2021-11-01
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
failover
|
path | True |
string |
Nombre del grupo de conmutación por error. |
resource
|
path | True |
string |
Nombre del grupo de recursos que contiene el recurso. Puede obtener este valor en la API del Administrador de recursos o el portal de Azure. |
server
|
path | True |
string |
Nombre del servidor que contiene el grupo de conmutación por error. |
subscription
|
path | True |
string |
El id. de suscripción que identifica una suscripción de Azure. |
api-version
|
query | True |
string |
La versión de API que se usará para la solicitud. |
Cuerpo de la solicitud
Nombre | Requerido | Tipo | Description |
---|---|---|---|
properties.partnerServers | True |
Lista de información del servidor asociado para el grupo de conmutación por error. |
|
properties.readWriteEndpoint | True |
Punto de conexión de lectura y escritura de la instancia del grupo de conmutación por error. |
|
properties.databases |
string[] |
Lista de bases de datos del grupo de conmutación por error. |
|
properties.readOnlyEndpoint |
Punto de conexión de solo lectura de la instancia del grupo de conmutación por error. |
||
tags |
object |
Etiquetas del recurso. |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
Se actualizó correctamente el grupo de conmutación por error. |
|
201 Created |
Se creó correctamente el grupo de conmutación por error. |
|
202 Accepted |
Aceptado |
|
Other Status Codes |
Respuestas de error: ***
|
Ejemplos
Create failover group
Solicitud de ejemplo
PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/failoverGroups/failover-group-test-3?api-version=2021-11-01
{
"properties": {
"readWriteEndpoint": {
"failoverPolicy": "Automatic",
"failoverWithDataLossGracePeriodMinutes": 480
},
"readOnlyEndpoint": {
"failoverPolicy": "Disabled"
},
"partnerServers": [
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server"
}
],
"databases": [
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-1",
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-2"
]
}
}
Respuesta de muestra
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/failoverGroups/failover-group-test-3",
"name": "failover-group-test-3",
"type": "Microsoft.Sql/servers/failoverGroups",
"location": "Japan East",
"properties": {
"readWriteEndpoint": {
"failoverPolicy": "Automatic",
"failoverWithDataLossGracePeriodMinutes": 480
},
"readOnlyEndpoint": {
"failoverPolicy": "Disabled"
},
"replicationRole": "Primary",
"replicationState": "CATCH_UP",
"partnerServers": [
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server",
"location": "Japan West",
"replicationRole": "Secondary"
}
],
"databases": [
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-1",
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-2"
]
}
}
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/failoverGroups/failover-group-test-3",
"name": "failover-group-test-3",
"type": "Microsoft.Sql/servers/failoverGroups",
"location": "Japan East",
"properties": {
"readWriteEndpoint": {
"failoverPolicy": "Automatic",
"failoverWithDataLossGracePeriodMinutes": 480
},
"readOnlyEndpoint": {
"failoverPolicy": "Disabled"
},
"replicationRole": "Primary",
"replicationState": "CATCH_UP",
"partnerServers": [
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server",
"location": "Japan West",
"replicationRole": "Secondary"
}
],
"databases": [
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-1",
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-2"
]
}
}
Definiciones
Nombre | Description |
---|---|
Failover |
Un grupo de conmutación por error. |
Failover |
Punto de conexión de solo lectura de la instancia del grupo de conmutación por error. |
Failover |
Punto de conexión de lectura y escritura de la instancia del grupo de conmutación por error. |
Failover |
Rol de replicación local de la instancia del grupo de conmutación por error. |
Partner |
Información del servidor asociado para el grupo de conmutación por error. |
Read |
Directiva de conmutación por error del punto de conexión de solo lectura para el grupo de conmutación por error. |
Read |
Directiva de conmutación por error del punto de conexión de lectura y escritura para el grupo de conmutación por error. Si failoverPolicy es Automatic, se requiere failoverWithDataLossGracePeriodMinutes. |
FailoverGroup
Un grupo de conmutación por error.
Nombre | Tipo | Description |
---|---|---|
id |
string |
Identificador del recurso. |
location |
string |
Ubicación del recurso |
name |
string |
Nombre del recurso. |
properties.databases |
string[] |
Lista de bases de datos del grupo de conmutación por error. |
properties.partnerServers |
Lista de información del servidor asociado para el grupo de conmutación por error. |
|
properties.readOnlyEndpoint |
Punto de conexión de solo lectura de la instancia del grupo de conmutación por error. |
|
properties.readWriteEndpoint |
Punto de conexión de lectura y escritura de la instancia del grupo de conmutación por error. |
|
properties.replicationRole |
Rol de replicación local de la instancia del grupo de conmutación por error. |
|
properties.replicationState |
string |
Estado de replicación de la instancia del grupo de conmutación por error. |
tags |
object |
Etiquetas del recurso. |
type |
string |
Tipo de recurso. |
FailoverGroupReadOnlyEndpoint
Punto de conexión de solo lectura de la instancia del grupo de conmutación por error.
Nombre | Tipo | Description |
---|---|---|
failoverPolicy |
Directiva de conmutación por error del punto de conexión de solo lectura para el grupo de conmutación por error. |
FailoverGroupReadWriteEndpoint
Punto de conexión de lectura y escritura de la instancia del grupo de conmutación por error.
Nombre | Tipo | Description |
---|---|---|
failoverPolicy |
Directiva de conmutación por error del punto de conexión de lectura y escritura para el grupo de conmutación por error. Si failoverPolicy es Automatic, se requiere failoverWithDataLossGracePeriodMinutes. |
|
failoverWithDataLossGracePeriodMinutes |
integer |
Período de gracia antes de la conmutación por error con pérdida de datos se intenta para el punto de conexión de lectura y escritura. Si failoverPolicy es Automatic, se requiere failoverWithDataLossGracePeriodMinutes. |
FailoverGroupReplicationRole
Rol de replicación local de la instancia del grupo de conmutación por error.
Nombre | Tipo | Description |
---|---|---|
Primary |
string |
|
Secondary |
string |
PartnerInfo
Información del servidor asociado para el grupo de conmutación por error.
Nombre | Tipo | Description |
---|---|---|
id |
string |
Identificador de recurso del servidor asociado. |
location |
string |
Ubicación geográfica del servidor asociado. |
replicationRole |
Rol de replicación del servidor asociado. |
ReadOnlyEndpointFailoverPolicy
Directiva de conmutación por error del punto de conexión de solo lectura para el grupo de conmutación por error.
Nombre | Tipo | Description |
---|---|---|
Disabled |
string |
|
Enabled |
string |
ReadWriteEndpointFailoverPolicy
Directiva de conmutación por error del punto de conexión de lectura y escritura para el grupo de conmutación por error. Si failoverPolicy es Automatic, se requiere failoverWithDataLossGracePeriodMinutes.
Nombre | Tipo | Description |
---|---|---|
Automatic |
string |
|
Manual |
string |