Replication Links - Update

Service:

SQL Database

API Version:

2023-08-01-preview

Novedades el tipo de vínculo de replicación.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/replicationLinks/{linkId}?api-version=2023-08-01-preview

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
databaseName	path	True	string	El nombre de la base de datos.
linkId	path	True	string
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.
serverName	path	True	string	El nombre del servidor.
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

Nombre	Tipo	Description
properties.linkType	ReplicationLinkType	Tipo de vínculo (GEO, NAMED, STANDBY). La operación de actualización no admite NAMED.

Respuestas

Nombre	Tipo	Description
200 OK	ReplicationLink	Se actualizó correctamente el vínculo de replicación.
202 Accepted		La operación de actualización está en curso.
Other Status Codes	ErrorResponse	Respuestas de error: *** 400 ReplicationLinksReplicationLinkNameIsInvalid: el nombre del vínculo de replicación debe ser un guid válido. 400 GeoReplicationDatabaseNotSecondary: la operación espera que la base de datos sea un destino de replicación. 400 ReplicationLinksReplicationLinkTypeIsInvalid: LinkType no es válido. Los valores válidos son STANDBY y GEO. 400 ReplicationLinksCreateIsNotSupported: no se admite la creación del vínculo de replicación. 400 LedgerNoDropLink: no se puede detener la replicación geográfica porque la base de datos tiene habilitadas las cargas implícitas de libro de contabilidad. Deshabilite las cargas de resumen del libro de contabilidad y vuelva a intentar la operación. 400 CannotUseTrailingWhitespacesInDatabaseName: no se pudo validar el nombre de la base de datos. 400 GeoReplicationDatabaseNotSecondary: la operación espera que la base de datos sea un destino de replicación. 400 VBSEnclaveNotSupportedForGeoReplicationWithDefaultEnclave: no se admite la configuración de la replicación geográfica para las bases de datos que usan valores diferentes de la propiedad preferredEnclaveType. La base de datos principal "{0}" del servidor "{1}" usa el{2} valor preferredEnclaveType , mientras que el valor de preferredEnclaveType especificado para la base de datos secundaria "{3}" en el servidor "{4}" es "{5}". 400 VBSEnclaveNotSupportedForPlannedFailoverBetweenDatabasesWithDifferentPreferredEnclaveTypes: la conmutación por error planeada entre la base de datos principal y la secundaria con diferentes preferredEnclaveType no se admite para los enclaves de seguridad basada en virtualización (VBS). 400 CannotUseReservedDatabaseName: no se puede usar el nombre reservado de la base de datos en esta operación. 400 InvalidServerName: nombre de servidor no válido especificado. 400 PlannedFailoverTimedOut: el usuario ha invocado 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 InvalidIdentifier: el identificador contiene NULL o un carácter unicode no válido. 400 IncorrectReplicationLinkState: la operación espera que la base de datos esté en un estado esperado en el vínculo de replicación. 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 DatabaseDoesNotExist: el usuario ha especificado un nombre de base de datos que no existe en esta instancia del servidor. 409 CannotCancelOperation: la operación de administración está en un estado que no se puede cancelar. 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 InvalidOperationForDatabaseNotInReplicationRelationship: se realizó una operación de replicación en una base de datos que no está en una relación de replicació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 DuplicateGeoDrRelation: las bases de datos ya están en una relación de replicación. Se trata de una solicitud duplicada. 409 UpdateSloInProgress: el usuario intentó iniciar una operación incompatible mientras estaba en curso una actualización de SLO. 409 ManagementServiceDatabaseBusy : la base de datos '{0}' está ocupada con otra operación. Pruebe la operación más adelante. 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 FailoverGroupAlreadySetup: no se puede realizar la operación porque el vínculo de replicación geográfica forma parte de un grupo de conmutación por error. Debe quitar la base de datos del grupo para finalizar o conmutar por error individualmente. 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.

Ejemplos

Update Replication Link

Sample Request

HTTP

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/sourcesvr/databases/gamma-db/replicationLinks/00000000-1111-2222-3333-666666666666?api-version=2023-08-01-preview

{
  "properties": {
    "linkType": "STANDBY"
  }
}

Sample Response

Status code:

200

{
  "properties": {
    "partnerServer": "testsvr",
    "partnerDatabase": "gamma-db",
    "partnerDatabaseId": "/subscriptions/00000000-1111-2222-3333-555555555555/resourceGroups/Second-Default/providers/Microsoft.Sql/servers/testsvr/databases/gamma-db",
    "partnerLocation": "Japan East",
    "role": "Primary",
    "partnerRole": "Secondary",
    "replicationMode": "ASYNC",
    "startTime": "2018-06-21T08:12:43.783Z",
    "percentComplete": 100,
    "replicationState": "CATCH_UP",
    "isTerminationAllowed": true,
    "linkType": "STANDBY"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/sourcesvr/databases/gamma-db/replicationLinks/4891ca10-ebd0-47d7-9182-c722651780fb",
  "name": "00000000-1111-2222-3333-666666666666"
}

Status code:

202

Location: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/japaneast/replicationLinksOperationResults/11111111-1111-1111-1111-111111111111

Definiciones

Nombre	Description
ErrorAdditionalInfo	Información adicional sobre el error de administración de recursos.
ErrorDetail	Detalle del error.
ErrorResponse	Respuesta de error
ReplicationLink	Un vínculo de replicación.
ReplicationLinkType	Tipo de vínculo (GEO, NAMED, STANDBY). La operación de actualización no admite NAMED.
ReplicationLinkUpdate	Una solicitud de actualización de vínculo de replicación.
ReplicationRole	Rol de replicación local.
ReplicationState	Estado de replicación (PENDIENTE, SEEDING, CATCHUP, SUSPENDED).

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

Nombre	Tipo	Description
info	object	Información adicional.
type	string	Tipo de información adicional.

ErrorDetail

Detalle del error.

Nombre	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	Información adicional del error.
code	string	Código de error.
details	ErrorDetail[]	Los detalles del error.
message	string	El mensaje de error.
target	string	Destino del error.

ErrorResponse

Respuesta de error

Nombre	Tipo	Description
error	ErrorDetail	Objeto de error.

ReplicationLink

Un vínculo de replicación.

Nombre	Tipo	Description
id	string	Identificador del recurso.
name	string	Nombre del recurso.
properties.isTerminationAllowed	boolean	Si el usuario puede finalizar el vínculo actualmente.
properties.linkType	ReplicationLinkType	Tipo de vínculo (GEO, NAMED, STANDBY). La operación de actualización no admite NAMED.
properties.partnerDatabase	string	Base de datos del asociado de recursos.
properties.partnerDatabaseId	string	Id. de base de datos del asociado de recursos.
properties.partnerLocation	string	Ubicación del asociado de recursos.
properties.partnerRole	ReplicationRole	Rol de replicación de asociados.
properties.partnerServer	string	Servidor del asociado de recursos.
properties.percentComplete	integer	Porcentaje de finalización de propagación del vínculo.
properties.replicationMode	string	Modo de replicación.
properties.replicationState	ReplicationState	Estado de replicación (PENDIENTE, SEEDING, CATCHUP, SUSPENDED).
properties.role	ReplicationRole	Rol de replicación local.
properties.startTime	string	Hora en la que se creó el vínculo.
type	string	Tipo de recurso.

ReplicationLinkType

Tipo de vínculo (GEO, NAMED, STANDBY). La operación de actualización no admite NAMED.

Nombre	Tipo	Description
GEO	string
NAMED	string
STANDBY	string

ReplicationLinkUpdate

Una solicitud de actualización de vínculo de replicación.

Nombre	Tipo	Description
id	string	Identificador del recurso.
name	string	Nombre del recurso.
properties.linkType	ReplicationLinkType	Tipo de vínculo (GEO, NAMED, STANDBY). La operación de actualización no admite NAMED.
type	string	Tipo de recurso.

ReplicationRole

Rol de replicación local.

Nombre	Tipo	Description
Copy	string
NonReadableSecondary	string
Primary	string
Secondary	string
Source	string

ReplicationState

Estado de replicación (PENDIENTE, SEEDING, CATCHUP, SUSPENDED).

Nombre	Tipo	Description
CATCH_UP	string
PENDING	string
SEEDING	string
SUSPENDED	string