Sync Agents - List Linked Databases

Dienst:

SQL Database

API-Version:

2021-11-01

Listen Datenbanken, die mit einem Synchronisierungs-Agent verknüpft sind.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
resourceGroupName	path	True	string	Der Name der Ressourcengruppe, die die Ressource enthält. Dieser Wert kann über die Azure-Ressourcen-Manager-API oder das Portal abgerufen werden.
serverName	path	True	string	Der Name des Servers, auf dem der Synchronisierungs-Agent gehostet wird.
subscriptionId	path	True	string	Abonnement-ID für ein Azure-Abonnement.
syncAgentName	path	True	string	Der Name des Synchronisierungs-Agents.
api-version	query	True	string	API-Version, die für die Anforderung verwendet werden soll.

Antworten

Name	Typ	Beschreibung
200 OK	SyncAgentLinkedDatabaseListResult	Verknüpfte SQL Server-Datenbanken mit dem Synchronisierungs-Agent wurden erfolgreich abgerufen.
Other Status Codes		Fehlerantworten: *** 400 InvalidSyncGroupCreateOrUpdateRequest: Der Anforderungstext der Synchronisierungsgruppe erstellen oder aktualisieren ist leer. 400 InvalidSyncMemberCreateOrUpdateRequest: Der Anforderungstext zum Erstellen oder Aktualisieren von Synchronisierungsmitglied ist leer. 400 InvalidSyncAgentCreateOrUpdateRequest: Der Anforderungstext des Synchronisierungs-Agents zum Erstellen oder Aktualisieren ist leer. 400 InvalidDatabaseResourceId: Ungültiger Datenbankressourcenbezeichner. 400 MismatchingSubscriptionWithUrl: Das bereitgestellte Abonnement stimmte nicht mit dem Abonnement in der URL überein. 400 InvalidSyncAgentResourceId: Ungültiger Synchronisierungs-Agent-Ressourcenbezeichner. 400 MismatchingResourceGroupNameWithUrl: Der angegebene Ressourcengruppenname stimmte nicht mit dem Namen in der URL überein. 400 MismatchingServerNameWithUrl: Der angegebene Servername stimmte nicht mit dem Namen in der URL überein. 400 InvalidParameterValue: Einem Parameter wurde ein ungültiger Wert zugewiesen. 400 MissingServerName: Der Servername fehlt 400 MissingDatabaseName : Der Datenbankname fehlt 400 MissingSyncGroupName: Der Name der Synchronisierungsgruppe fehlt 400 MissingConflictResolutionPolicy: Die Konfliktauflösungsrichtlinie fehlt 400 MissingSyncAgentName: Der Name des Synchronisierungs-Agents fehlt 400 SyncOperation_GenericFailure: Fehler beim Ausführen des Datensynchronisierungsvorgangs. 400 SyncOperation_WrongSyncDatabase: Die angegebene Synchronisierungsdatenbank stimmt nicht mit der vorhandenen Datenbank überein. 400 SyncOperation_DwInSyncGroup: Datawarehouse Edition kann nicht in der Datensynchronisierung verwendet werden. 400 SyncOperation_MasterDbInSyncGroup: Logische master in der Datensynchronisierung kann nicht verwendet werden. 400 CannotDeleteInUseSyncAgent: Der Synchronisierungs-Agent kann nicht gelöscht werden, da er vom Synchronisierungsmitglied verwendet wird. 400 InvalidSyncAgent: Der Synchronisierungs-Agent ist ungültig. 400 InvalidSyncMetadataDatabase: Die Metadatendatenbank der Synchronisierung ist ungültig. 404 ResourceNotFound: Die angeforderte Ressource wurde nicht gefunden. 404 SubscriptionDoesNotHaveServer: Der angeforderte Server wurde nicht gefunden. 404 DatabaseDoesNotExist: Der Benutzer hat einen Datenbanknamen angegeben, der auf diesem Server instance nicht vorhanden ist. 409 SyncOperation_AgentAlreadyExists: Der Synchronisierungs-Agent mit demselben Namen ist bereits vorhanden. 409 SyncOperation_AgentIdAlreadyExists: Der Synchronisierungs-Agent mit derselben ID ist bereits vorhanden.

Beispiele

Get sync agent linked databases

Beispielanforderung

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncagentcrud-65440/providers/Microsoft.Sql/servers/syncagentcrud-8475/syncAgents/syncagentcrud-3187/linkedDatabases?api-version=2021-11-01

Java

/**
 * Samples for SyncAgents ListLinkedDatabases.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/SyncAgentGetLinkedDatabases.json
     */
    /**
     * Sample code: Get sync agent linked databases.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getSyncAgentLinkedDatabases(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getSyncAgents().listLinkedDatabases("syncagentcrud-65440",
            "syncagentcrud-8475", "syncagentcrud-3187", 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

Beispiel für eine Antwort

Statuscode:

200

{
  "value": [
    {
      "properties": {
        "databaseType": "SqlServerDatabase",
        "databaseId": "55555555-6666-7777-8888-999999999999",
        "description": "",
        "serverName": "DummySqlServer",
        "databaseName": "DummySqlServerDb",
        "userName": "DummyUser"
      },
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-Onebox/providers/Microsoft.Sql/servers/syncagentcrud-8475/syncAgents/syncagentcrud-3187/linkedDatabases/55555555-6666-7777-8888-999999999999"
    }
  ]
}

Definitionen

Name	Beschreibung
SyncAgentLinkedDatabase	Eine Azure SQL Verknüpfte Datenbank für den Synchronisierungs-Agent.
SyncAgentLinkedDatabaseListResult	Eine Liste der verknüpften Datenbanken des Synchronisierungs-Agents.
SyncMemberDbType	Typ der verknüpften Datenbank des Synchronisierungs-Agents.

SyncAgentLinkedDatabase

Eine Azure SQL Verknüpfte Datenbank für den Synchronisierungs-Agent.

Name	Typ	Beschreibung
id	string	Ressourcen-ID
name	string	Name der Ressource.
properties.databaseId	string	ID der verknüpften Datenbank des Synchronisierungs-Agents.
properties.databaseName	string	Datenbankname der verknüpften Datenbank des Synchronisierungs-Agents.
properties.databaseType	SyncMemberDbType	Typ der verknüpften Datenbank des Synchronisierungs-Agents.
properties.description	string	Beschreibung der verknüpften Datenbank des Synchronisierungs-Agents.
properties.serverName	string	Servername der verknüpften Datenbank des Synchronisierungs-Agents.
properties.userName	string	Benutzername der verknüpften Datenbank des Synchronisierungs-Agents.
type	string	Der Ressourcentyp.

SyncAgentLinkedDatabaseListResult

Eine Liste der verknüpften Datenbanken des Synchronisierungs-Agents.

Name	Typ	Beschreibung
nextLink	string	Link zum Abrufen der nächsten Ergebnisseite.
value	SyncAgentLinkedDatabase[]	Array von Ergebnissen.

SyncMemberDbType

Typ der verknüpften Datenbank des Synchronisierungs-Agents.

Name	Typ	Beschreibung
AzureSqlDatabase	string
SqlServerDatabase	string