Sync Agents - List Linked Databases

Service:

SQL Database

API Version:

2021-11-01

Elenchi database collegati a un agente di sincronizzazione.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
resourceGroupName	path	True	string	Nome del gruppo di risorse contenente la risorsa. È possibile ottenere questo valore dall'API di Gestione risorse di Azure o dal portale.
serverName	path	True	string	Nome del server in cui è ospitato l'agente di sincronizzazione.
subscriptionId	path	True	string	ID sottoscrizione che identifica una sottoscrizione di Azure.
syncAgentName	path	True	string	Nome dell'agente di sincronizzazione.
api-version	query	True	string	Versione dell'API da usare per la richiesta.

Risposte

Nome	Tipo	Descrizione
200 OK	SyncAgentLinkedDatabaseListResult	È stato recuperato correttamente il database di SQL Server collegato all'agente di sincronizzazione.
Other Status Codes		Risposte agli errori: ** 400 InvalidSyncGroupCreateOrUpdateRequest: il corpo della richiesta del gruppo di sincronizzazione crea o aggiorna è vuoto. 400 InvalidSyncMemberCreateOrUpdateRequest: il corpo della richiesta membro di creazione o aggiornamento della sincronizzazione è vuoto. 400 InvalidSyncAgentCreateOrUpdateRequest: il corpo della richiesta dell'agente di sincronizzazione di creazione o aggiornamento è vuoto. 400 InvalidDatabaseResourceId - Identificatore di risorsa del database non valido. 400 Mancata corrispondenzaSubscriptionWithUrl: la sottoscrizione specificata non corrispondeva alla sottoscrizione nell'URL. 400 InvalidSyncAgentResourceId - Identificatore di risorsa dell'agente di sincronizzazione non valido. 400 MismatchingResourceGroupNameWithUrl: il nome del gruppo di risorse specificato non corrisponde al nome nell'URL. 400 MismatchingServerNameWithUrl: il nome del server specificato non corrisponde al nome nell'URL. 400 InvalidParameterValue: un valore non valido è stato assegnato a un parametro. 400 MissingServerName - Nome server mancante 400 MissingDatabaseName - Nome database mancante 400 MissingSyncGroupName - Il nome del gruppo di sincronizzazione manca 400 MissingConflictResolutionPolicy - Manca il criterio di risoluzione dei conflitti 400 MissingSyncAgentName - Il nome dell'agente di sincronizzazione manca 400 SyncOperation_GenericFailure - Impossibile eseguire l'operazione di sincronizzazione dei dati. 400 SyncOperation_WrongSyncDatabase: il database di sincronizzazione specificato non corrisponde a quello esistente. 400 SyncOperation_DwInSyncGroup - Impossibile usare l'edizione datawarehouse nella sincronizzazione dei dati. 400 SyncOperation_MasterDbInSyncGroup - Impossibile usare master logico nella sincronizzazione dei dati. 400 CannotDeleteInUseSyncAgent - Impossibile eliminare l'agente di sincronizzazione perché viene usato dal membro di sincronizzazione. 400 InvalidSyncAgent - Agente di sincronizzazione non valido. 400 InvalidSyncMetadataDatabase - Il database dei metadati di sincronizzazione non è valido. 404 ResourceNotFound : la risorsa richiesta non è stata trovata. 404 SubscriptionDoesNotHaveServer - Il server richiesto non è stato trovato 404 DatabaseDoesNotExist: l'utente ha specificato un nome di database che non esiste in questa istanza del server. 409 SyncOperation_AgentAlreadyExists : l'agente di sincronizzazione con lo stesso nome esiste già. 409 SyncOperation_AgentIdAlreadyExists : l'agente di sincronizzazione con lo stesso ID esiste già.

Esempio

Get sync agent linked databases

Sample Request

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

import com.azure.core.util.Context;

/** 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", 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

Sample Response

Status code:

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

Definizioni

Nome	Descrizione
SyncAgentLinkedDatabase	Database collegato Azure SQL agente di sincronizzazione del database.
SyncAgentLinkedDatabaseListResult	Elenco dei database collegati all'agente di sincronizzazione.
SyncMemberDbType	Tipo del database collegato dell'agente di sincronizzazione.

SyncAgentLinkedDatabase

Database collegato Azure SQL agente di sincronizzazione del database.

Nome	Tipo	Descrizione
id	string	ID risorsa.
name	string	Nome risorsa.
properties.databaseId	string	ID del database collegato dell'agente di sincronizzazione.
properties.databaseName	string	Nome del database del database collegato dell'agente di sincronizzazione.
properties.databaseType	SyncMemberDbType	Tipo del database collegato dell'agente di sincronizzazione.
properties.description	string	Descrizione del database collegato dell'agente di sincronizzazione.
properties.serverName	string	Nome del server del database collegato dell'agente di sincronizzazione.
properties.userName	string	Nome utente del database collegato dell'agente di sincronizzazione.
type	string	Tipo di risorsa.

SyncAgentLinkedDatabaseListResult

Elenco dei database collegati all'agente di sincronizzazione.

Nome	Tipo	Descrizione
nextLink	string	Collegamento per recuperare la pagina successiva dei risultati.
value	SyncAgentLinkedDatabase[]	Matrice di risultati.

SyncMemberDbType

Tipo del database collegato dell'agente di sincronizzazione.

Nome	Tipo	Descrizione
AzureSqlDatabase	string
SqlServerDatabase	string