Replication Links - List By Database

Odwołanie

Service:: SQL Database

API Version:: 2021-02-01-preview

Pobiera listę linków replikacji w bazie danych.

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

Parametry identyfikatora URI

Name	In	Required	Type	Description
databaseName	path	True	string	Nazwa bazy danych.
resourceGroupName	path	True	string	Nazwa grupy zasobów zawierającej zasób. Tę wartość można uzyskać z interfejsu API usługi Azure Resource Manager lub portalu.
serverName	path	True	string	Nazwa serwera.
subscriptionId	path	True	string	Identyfikator subskrypcji identyfikujący subskrypcję platformy Azure.
api-version	query	True	string	Wersja interfejsu API do użycia dla żądania.

Odpowiedzi

Name	Type	Description
200 OK	ReplicationLinkListResult	Pomyślnie pobrano listę łączy replikacji.
Other Status Codes		Odpowiedzi na błędy: *** 400 ReplicationLinksReplicationLinkNameIsInvalid — nazwa łącza replikacji powinna być prawidłowym identyfikatorem GUID. 400 ReplicationLinksDeleteIsNotSupported — ta akcja nie jest jeszcze dostępna, użyj polecenia 2014-04-01 dla tej akcji. 404 ResourceNotFound — żądany zasób nie został znaleziony.

Name

Type

Description

200 OK

ReplicationLinkListResult

Pomyślnie pobrano listę łączy replikacji.

Other Status Codes

Odpowiedzi na błędy: ***

400 ReplicationLinksReplicationLinkNameIsInvalid — nazwa łącza replikacji powinna być prawidłowym identyfikatorem GUID.
400 ReplicationLinksDeleteIsNotSupported — ta akcja nie jest jeszcze dostępna, użyj polecenia 2014-04-01 dla tej akcji.
404 ResourceNotFound — żądany zasób nie został znaleziony.

Przykłady

List replication links on server on database.

Sample Request

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-02-01-preview

package armsql_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/sql/armsql"
)

// x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/preview/2021-02-01-preview/examples/ReplicationLinkListByDatabase.json
func ExampleReplicationLinksClient_ListByDatabase() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	client := armsql.NewReplicationLinksClient("<subscription-id>", cred, nil)
	pager := client.ListByDatabase("<resource-group-name>",
		"<server-name>",
		"<database-name>",
		nil)
	for {
		nextResult := pager.NextPage(ctx)
		if err := pager.Err(); err != nil {
			log.Fatalf("failed to advance page: %v", err)
		}
		if !nextResult {
			break
		}
		for _, v := range pager.PageResponse().Value {
			log.Printf("Pager result: %#v\n", v)
		}
	}
}

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

const { SqlManagementClient } = require("@azure/arm-sql");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Gets a list of replication links on database.
 *
 * @summary Gets a list of replication links on database.
 * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/preview/2021-02-01-preview/examples/ReplicationLinkListByDatabase.json
 */
async function listReplicationLinksOnServerOnDatabase() {
  const subscriptionId = "00000000-1111-2222-3333-444444444444";
  const resourceGroupName = "Default";
  const serverName = "sourcesvr";
  const databaseName = "tetha-db";
  const credential = new DefaultAzureCredential();
  const client = new SqlManagementClient(credential, subscriptionId);
  const resArray = new Array();
  for await (let item of client.replicationLinks.listByDatabase(
    resourceGroupName,
    serverName,
    databaseName
  )) {
    resArray.push(item);
  }
  console.log(resArray);
}

listReplicationLinksOnServerOnDatabase().catch(console.error);

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

Sample Response

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"
    }
  ]
}

Definicje

ReplicationLink	Link replikacji.
ReplicationLinkListResult	Lista linków replikacji.
ReplicationLinkType	Typ łącza (GEO, NAMED).
ReplicationRole	Rola replikacji lokalnej.
ReplicationState	Stan replikacji (PENDING, SEEDING, CATCHUP, SUSPENDED).

ReplicationLink

Link replikacji.

Name	Type	Description
id	string	Identyfikator zasobu.
name	string	Nazwa zasobu.
properties.isTerminationAllowed	boolean	Czy użytkownik może obecnie przerwać łącze.
properties.linkType	ReplicationLinkType	Typ łącza (GEO, NAMED).
properties.partnerDatabase	string	Baza danych partnera zasobów.
properties.partnerLocation	string	Lokalizacja partnera zasobów.
properties.partnerRole	ReplicationRole	Rola replikacji partnera.
properties.partnerServer	string	Serwer partnera zasobów.
properties.percentComplete	integer	Procent ukończenia rozmieszczania dla łącza.
properties.replicationMode	string	Tryb replikacji.
properties.replicationState	ReplicationState	Stan replikacji (PENDING, SEEDING, CATCHUP, SUSPENDED).
properties.role	ReplicationRole	Rola replikacji lokalnej.
properties.startTime	string	Godzina utworzenia łącza.
type	string	Typ zasobu.

ReplicationLinkListResult

Lista linków replikacji.

Name	Type	Description
nextLink	string	Łącze, aby pobrać następną stronę wyników.
value	ReplicationLink[]	Tablica wyników.

ReplicationLinkType

Typ łącza (GEO, NAMED).

Name	Type	Description
GEO	string
NAMED	string

ReplicationRole

Rola replikacji lokalnej.

Name	Type	Description
Copy	string
NonReadableSecondary	string
Primary	string
Secondary	string
Source	string

ReplicationState

Stan replikacji (PENDING, SEEDING, CATCHUP, SUSPENDED).

Name	Type	Description
CATCH_UP	string
PENDING	string
SEEDING	string
SUSPENDED	string