Instance 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/locations/{locationName}/instanceFailoverGroups/{failoverGroupName}?api-version=2021-02-01-preview

Parámetros de identificador URI

Name In Required Type Description
failoverGroupName
path True
  • string

Nombre del grupo de conmutación por error.

locationName
path True
  • string

Nombre de la región donde se encuentra el recurso.

resourceGroupName
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.

subscriptionId
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

Name Required Type Description
properties.managedInstancePairs True

Lista de pares de instancia administrada en el grupo de conmutación por error.

properties.partnerRegions True

Información de la región del 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.readOnlyEndpoint

Punto de conexión de solo lectura de la instancia del grupo de conmutación por error.

Respuestas

Name Type 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: ***

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidPartner: el campo de asociados especificado en el cuerpo de la solicitud del grupo de conmutación por error de la instancia de creación o actualización está vacío o no es válido.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestDuplicatePartner: uno o varios de los servidores asociados proporcionados ya forman parte del grupo de conmutación por error de instancia. Asegúrese de que el servidor principal y todos los servidores asociados especificados sean únicos.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidManagedInstanceRegion: la región de la instancia administrada del asociado proporcionada en el cuerpo de la solicitud del grupo de conmutación por error de instancia está vacía o no es válida.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestUnsupportedPartnerCount: solo se admite una región de asociado.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestUnsupportedPairCount: solo se admite un par de instancias administradas.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpoint: el campo readWriteEndpoint es necesario para crear o actualizar solicitudes.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalid: el cuerpo de la solicitud del grupo de conmutación por error de la instancia de creación o actualización está vacío o no es válido.

  • 400 InstanceFailoverGroupUpdateOrDeleteRequestOnSecondary: no se permiten modificaciones en el grupo de conmutación por error de instancia en un servidor secundario. Ejecute la solicitud en el servidor principal.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestNegativeGracePeriodValues: el valor del período de gracia para el punto de conexión de lectura y escritura debe ser no negativo.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFields: la propiedad failoverWithDataLossGracePeriodMinutes debe proporcionarse cuando se selecciona la directiva de conmutación por error Automática para el punto de conexión de lectura y escritura.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteFailoverPolicy: el campo failoverPolicy para el punto de conexión de lectura y escritura es necesario para crear o actualizar solicitudes.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFieldsForManualPolicy: el valor del período de gracia no se debe proporcionar cuando se selecciona manual de directiva de conmutación por error para el punto de conexión de lectura y escritura.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestReadOnlyPropertyModified: el cuerpo de la solicitud del grupo de conmutación por error de la instancia de creación o actualización no debe modificar la propiedad de solo lectura '{0}'.

  • 400 InstanceFailoverGroupFailoverRequestOnPrimary: la solicitud de conmutación por error debe iniciarse en el servidor secundario del grupo de conmutación por error de instancia.

  • 400 InstanceFailoverGroupPartnerManagedInstanceFromDifferentSubscription: el servidor principal y el servidor asociado del grupo de conmutación por error son de suscripciones diferentes. No se permite la suscripción cruzada para servidores del grupo de conmutación por error.

  • 400 InvalidTargetSubregion: el servidor de destino de una base de datos secundaria no legible no está en una región de Azure emparejada con recuperación ante desastres.

  • 400 GeoDrInstanceSizeMismatch: la instancia administrada principal y la instancia administrada del asociado no tienen el mismo tamaño de almacenamiento.

  • 400 SecurityAdalPrincipalCertExpiredError: no se pudo completar la operación porque el certificado de entidad de seguridad de Azure Key Vault ha expirado.

  • 400 GeoDrSecondaryInstanceNotEmpty: la instancia administrada secundaria tiene bases de datos de usuario. Para crear un grupo de conmutación por error de instancia, la instancia administrada secundaria debe estar vacía.

  • 400 InstanceFailoverGroupIncorrectNetworkingConfiguration: la configuración de redes es incorrecta. El tráfico de replicación del servidor principal no puede acceder al servidor secundario.

  • 400 IncorrectReplicationLinkState: la operación espera que la base de datos esté en un estado esperado en el vínculo de replicación.

  • 400 SecurityInvalidAzureKeyVaultRecoveryLevel: el URI de Key Vault proporcionado no es válido.

  • 400 KeyMaterialNotFoundOnRemoteServer: el servidor remoto no tiene acceso al material de clave utilizado como protector TDE.

  • 400 AzureKeyVaultMismatchError: región de Key Vault inesperada que se encuentra en la respuesta http.

  • 400 AzureKeyVaultRsaKeyNotSupported: el almacén de claves proporcionado usa el tamaño o el tipo de clave RSA no admitidos. El tamaño de clave RSA admitido es 2048 o 3072 y el tipo de clave es RSA o RSA-HSM.

  • 400 UnableToResolveRemoteServer: no se pudo resolver el nombre del servidor asociado remoto debido a un nombre de servidor no válido o problemas de conectividad DNS.

  • 400 RemoteDatabaseCopyPermission: el usuario no tiene permiso suficiente para crear una copia de base de datos en el servidor especificado.

  • 400 CannotUseReservedDatabaseName: no se puede usar el nombre reservado de la base de datos en esta operación.

  • 400 InvalidFailoverGroupRegion: los servidores especificados en un grupo de conmutación por error de instancia deben residir en regiones diferentes para proporcionar aislamiento.

  • 400 InstanceFailoverGroupDoesNotExist: el grupo de conmutación por error no existe en un servidor.

  • 400 InstanceFailoverGroupNotSecondary: no se puede iniciar la conmutación por error desde el servidor principal en un grupo de conmutación por error de instancia.

  • 400 InvalidServerName: nombre de servidor no válido especificado.

  • 400 InvalidIdentifier: el identificador contiene NULL o un carácter unicode no válido.

  • 400 TokenTooLong: el token proporcionado es demasiado largo.

  • 400 AzureKeyVaultKeyDisabled: no se pudo completar la operación en el servidor porque la clave de Azure Key Vault está deshabilitada.

  • 400 AzureKeyVaultInvalidExpirationDate: no se pudo completar la operación porque la fecha de expiración de la clave de Azure Key Vault no es válida.

  • 400 SecurityAzureKeyVaultUrlNullOrEmpty: no se pudo completar la operación porque el URI de Azure Key Vault es nulo o está vacío.

  • 400 InvalidSku: el usuario especificó una SKU no válida.

  • 400 InvalidAddSecondaryPermission: el usuario no tiene permiso suficiente para agregar secundario en el servidor especificado.

  • 400 ServerNotFound: no se encontró el servidor solicitado.

  • 400 AzureKeyVaultNoServerIdentity: la identidad del servidor no está configurada correctamente.

  • 400 AzureKeyVaultInvalidUri: respuesta no válida de Azure Key Vault. Use un URI de Azure Key Vault válido.

  • 400 AzureKeyVaultMissingPermissions: faltan permisos necesarios en azure Key Vault el servidor.

  • 400 SecurityAzureKeyVaultInvalidKeyName: no se pudo completar la operación debido a un nombre de clave de servidor no válido.

  • 400 PlannedFailoverTimedOutForDatabase: el usuario ha invocado la conmutación por error planeada, ha agotado el tiempo de espera y una base de datos específica parece ser culpada.

  • 400 PlannedFailoverTimedOut: el usuario ha invocado la conmutación por error planeada y ha agotado el tiempo de espera al intentar ponerse en contacto con el servicio de administración de partners.

  • 400 AdalGenericError: no se pudo completar la operación porque se encontró un error de Azure Active Directory.

  • 400 GeoReplicationDatabaseNotSecondary: la operación espera que la base de datos sea un destino de replicación.

  • 400 AdalServicePrincipalNotFound: no se pudo completar la operación porque no se encontró un error de Azure Active Directory entidad de servicio de biblioteca.

  • 400 AzureKeyVaultMalformedVaultUri: el URI de Key Vault proporcionado no es válido.

  • 400 FeatureDisabledOnSelectedEdition: el usuario intentó usar una característica que está deshabilitada en la edición actual de la base de datos.

  • 404 OperationIdNotFound: la operación con id. no existe.

  • 404 ResourceNotFound: no se encontró el recurso solicitado.

  • 404 OperationIdNotFound: la operación con id. no existe.

  • 404 SourceDatabaseNotFound: la base de datos de origen no existe.

  • 404 ServerNotInSubscription: el servidor especificado no existe en la suscripción especificada.

  • 404 ServerNotInSubscriptionResourceGroup: el servidor especificado no existe en el grupo de recursos y la suscripción especificados.

  • 405 UnsupportedReplicationOperation: se inició una operación de replicación no admitida en la base de datos.

  • 409 OperationCancelled: el usuario canceló la operación.

  • 409 OperationInterrupted: no se pudo completar la operación en el recurso porque se interrumpió por otra operación en el mismo recurso.

  • 409 ManagedInstanceHasHybridLink: el usuario intentó iniciar la operación que no se admite cuando la instancia administrada tiene configurado un vínculo híbrido.

  • 409 RemoteDatabaseExists: el nombre de la base de datos de destino ya existe en el servidor de destino.

  • 409 ConflictingServerOperation: una operación está actualmente en curso para el servidor.

  • 409 SubscriptionDisabled: la suscripción está deshabilitada.

  • 409 InstanceFailoverGroupAlreadyExists: el grupo de conmutación por error ya existe en un servidor determinado.

  • 409 InstanceFailoverGroupBusy: el grupo de conmutación por error de instancia está ocupado con otra operación.

  • 409 GeoReplicationCannotBecomePrimaryDuringUndo: el usuario intentó conmutar por error o forzar la finalización de un vínculo geográfico mientras la base de datos secundaria está en un estado en el que puede no ser físicamente coherente y, por tanto, no puede entrar en el rol principal.

  • 409 InstanceFailoverGroupDnsRecordInUse: existe un registro DNS duplicado para el punto de conexión solicitado.

  • 409 ServerKeyNameAlreadyExists: la clave de servidor ya existe en el servidor.

  • 409 ServerKeyUriAlreadyExists: el URI de la clave de servidor ya existe en el servidor.

  • 409 ServerKeyDoesNotExists: la clave del servidor no existe.

  • 409 InvalidFailoverGroupName: se proporcionó un nombre de grupo de conmutación por error de instancia no válido.

  • 409 UpdateSloInProgress: el usuario intentó iniciar una operación incompatible mientras estaba en curso una actualización de SLO.

  • 409 AzureKeyVaultKeyNameNotFound: no se pudo completar la operación porque el nombre de clave de Azure Key Vault no existe.

  • 409 AzureKeyVaultKeyInUse: la clave está siendo utilizada actualmente por el servidor.

  • 409 ConflictingSystemOperationInProgress: una operación de mantenimiento del sistema está en curso en la base de datos y es necesario esperar a que se completen otras operaciones.

  • 409 InvalidOperationForDatabaseNotInReplicationRelationship: se realizó una operación de propagación de replicación en una base de datos que ya está en una relación de replicación.

  • 409 InvalidDatabaseStateForOperation: la operación no se permite en la base de datos en su estado de replicación actual.

  • 409 DuplicateGeoDrRelation: las bases de datos ya están en una relación de replicación. Se trata de una solicitud duplicada.

  • 429 SuscripciónTooManyCreateUpdateRequests: solicitudes más allá del número máximo de solicitudes que pueden procesar los recursos disponibles.

  • 429 SubscriptionTooManyRequests: solicitudes más allá del número máximo de solicitudes que pueden procesar los recursos disponibles.

  • 500 OperationTimedOut: se agota el tiempo de espera de la operación y se revierte automáticamente. Vuelva a intentar la operación y,

  • 503 TooManyRequests: solicitudes más allá del número máximo de solicitudes que se pueden procesar mediante recursos disponibles.

  • 503 AzureKeyVaultConnectionFailed: no se pudo completar la operación en el servidor porque se ha producido un error al intentar conectarse a Azure Key Vault

  • 503 AzureKeyVaultGenericConnectionError: no se pudo completar la operación porque se encontró un error al intentar recuperar Key Vault información .

  • 504 RequestTimeout: la solicitud de servicio superó el tiempo de espera permitido.

Ejemplos

Create failover group

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/Japan East/instanceFailoverGroups/failover-group-test-3?api-version=2021-02-01-preview

{
  "properties": {
    "readWriteEndpoint": {
      "failoverPolicy": "Automatic",
      "failoverWithDataLossGracePeriodMinutes": 480
    },
    "readOnlyEndpoint": {
      "failoverPolicy": "Disabled"
    },
    "partnerRegions": [
      {
        "location": "Japan West"
      }
    ],
    "managedInstancePairs": [
      {
        "primaryManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-primary-mngdInstance",
        "partnerManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-secondary-mngdInstance"
      }
    ]
  }
}

Sample Response

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/JapanEast/instanceFailoverGroups/failover-group-test-3",
  "name": "failover-group-test-3",
  "type": "Microsoft.Sql/locations/failoverGroups",
  "properties": {
    "readWriteEndpoint": {
      "failoverPolicy": "Automatic",
      "failoverWithDataLossGracePeriodMinutes": 480
    },
    "readOnlyEndpoint": {
      "failoverPolicy": "Disabled"
    },
    "replicationRole": "Primary",
    "replicationState": "CATCH_UP",
    "partnerRegions": [
      {
        "location": "Japan West",
        "replicationRole": "Secondary"
      }
    ],
    "managedInstancePairs": [
      {
        "primaryManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-primary-mngdInstance",
        "partnerManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-secondary-mngdInstance"
      }
    ]
  }
}
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/JapanEast/instanceFailoverGroups/failover-group-test-3",
  "name": "failover-group-test-3",
  "type": "Microsoft.Sql/locations/failoverGroups",
  "properties": {
    "readWriteEndpoint": {
      "failoverPolicy": "Automatic",
      "failoverWithDataLossGracePeriodMinutes": 480
    },
    "readOnlyEndpoint": {
      "failoverPolicy": "Disabled"
    },
    "replicationRole": "Primary",
    "replicationState": "CATCH_UP",
    "partnerRegions": [
      {
        "location": "Japan West",
        "replicationRole": "Secondary"
      }
    ],
    "managedInstancePairs": [
      {
        "primaryManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-primary-mngdInstance",
        "partnerManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-secondary-mngdInstance"
      }
    ]
  }
}

Definiciones

InstanceFailoverGroup

Un grupo de conmutación por error de instancia.

InstanceFailoverGroupReadOnlyEndpoint

Punto de conexión de solo lectura de la instancia del grupo de conmutación por error.

InstanceFailoverGroupReadWriteEndpoint

Punto de conexión de lectura y escritura de la instancia del grupo de conmutación por error.

InstanceFailoverGroupReplicationRole

Rol de replicación local de la instancia del grupo de conmutación por error.

ManagedInstancePairInfo

Pares de instancias administradas en el grupo de conmutación por error.

PartnerRegionInfo

Información de la región del asociado para el grupo de conmutación por error.

ReadOnlyEndpointFailoverPolicy

Directiva de conmutación por error del punto de conexión de solo lectura para el grupo de conmutación por error.

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.

InstanceFailoverGroup

Un grupo de conmutación por error de instancia.

Name Type Description
id
  • string

Identificador del recurso.

name
  • string

Nombre del recurso.

properties.managedInstancePairs

Lista de pares de instancia administrada en el grupo de conmutación por error.

properties.partnerRegions

Información de la región del 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.

type
  • string

Tipo de recurso.

InstanceFailoverGroupReadOnlyEndpoint

Punto de conexión de solo lectura de la instancia del grupo de conmutación por error.

Name Type Description
failoverPolicy

Directiva de conmutación por error del punto de conexión de solo lectura para el grupo de conmutación por error.

InstanceFailoverGroupReadWriteEndpoint

Punto de conexión de lectura y escritura de la instancia del grupo de conmutación por error.

Name Type 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.

InstanceFailoverGroupReplicationRole

Rol de replicación local de la instancia del grupo de conmutación por error.

Name Type Description
Primary
  • string
Secondary
  • string

ManagedInstancePairInfo

Pares de instancias administradas en el grupo de conmutación por error.

Name Type Description
partnerManagedInstanceId
  • string

Id. de partner Instancia administrada en par.

primaryManagedInstanceId
  • string

Id. del Instancia administrada principal en par.

PartnerRegionInfo

Información de la región del asociado para el grupo de conmutación por error.

Name Type Description
location
  • string

Ubicación geográfica de las instancias administradas del asociado.

replicationRole

Rol de replicación de las instancias administradas del asociado.

ReadOnlyEndpointFailoverPolicy

Directiva de conmutación por error del punto de conexión de solo lectura para el grupo de conmutación por error.

Name Type 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.

Name Type Description
Automatic
  • string
Manual
  • string