Replication Links - List By Database

Servicio:

SQL Database

Versión de la API:

2021-11-01

Obtiene una lista de vínculos de replicación en la base de datos.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/replicationLinks?api-version=2021-11-01

Parámetros de identificador URI

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

Respuestas

Nombre	Tipo	Description
200 OK	ReplicationLinkListResult	Recuperó correctamente la lista de vínculos de replicación.
Other Status Codes		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 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 implícitas del libro de contabilidad y vuelva a intentar la operación. 404 ResourceNotFound: no se encontró el recurso solicitado. 404 SubscriptionDoesNotHaveServer: no se encontró el servidor solicitado 404 ServerNotInSubscriptionResourceGroup: el servidor especificado no existe en el grupo de recursos y la suscripción especificados.

Ejemplos

List replication links on server on database.

Solicitud de ejemplo

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/sourcesvr/databases/tetha-db/replicationLinks?api-version=2021-11-01

Java

/**
 * Samples for ReplicationLinks ListByDatabase.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ReplicationLinkListByDatabase.json
     */
    /**
     * Sample code: List replication links on server on database.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void listReplicationLinksOnServerOnDatabase(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getReplicationLinks().listByDatabase("Default", "sourcesvr",
            "tetha-db", com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Respuesta de muestra

status code:

200

{
  "value": [
    {
      "properties": {
        "partnerServer": "testsvr",
        "partnerDatabase": "tetha-db",
        "partnerLocation": "Japan East",
        "role": "Primary",
        "partnerRole": "Secondary",
        "replicationMode": "ASYNC",
        "startTime": "2018-06-21T08:11:46.907Z",
        "percentComplete": 100,
        "replicationState": "CATCH_UP",
        "isTerminationAllowed": true,
        "linkType": "GEO"
      },
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/sourcesvr/databases/tetha-db/replicationLinks/fb92de60-eb87-4a58-b250-3362d0cfdf26",
      "name": "fb92de60-eb87-4a58-b250-3362d0cfdf26"
    },
    {
      "properties": {
        "partnerServer": "targetsvr",
        "partnerDatabase": "tetha-db",
        "partnerLocation": "Japan East",
        "role": "Primary",
        "partnerRole": "Secondary",
        "replicationMode": "ASYNC",
        "startTime": "2018-06-21T08:11:34.423Z",
        "percentComplete": 100,
        "replicationState": "CATCH_UP",
        "isTerminationAllowed": true,
        "linkType": "GEO"
      },
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/sourcesvr/databases/tetha-db/replicationLinks/6ad1eefc-18a2-4fcb-94f3-4b654ba788d7",
      "name": "6ad1eefc-18a2-4fcb-94f3-4b654ba788d7"
    }
  ]
}

Definiciones

Nombre	Description
ReplicationLink	Vínculo de replicación.
ReplicationLinkListResult	Lista de vínculos de replicación.
ReplicationLinkType	Tipo de vínculo (GEO, NAMED, STANDBY).
ReplicationRole	Rol de replicación local.
ReplicationState	Estado de replicación (PENDIENTE, SEEDING, CATCHUP, SUSPENDED).

ReplicationLink

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).
properties.partnerDatabase	string	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 inicializació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.

ReplicationLinkListResult

Lista de vínculos de replicación.

Nombre	Tipo	Description
nextLink	string	Vínculo para recuperar la página siguiente de resultados.
value	ReplicationLink[]	Matriz de resultados.

ReplicationLinkType

Tipo de vínculo (GEO, NAMED, STANDBY).

Nombre	Tipo	Description
GEO	string
NAMED	string
STANDBY	string

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