Sync Groups - List Logs

Serviço:: SQL Database

Versão da API:: 2025-01-01

Obtém uma coleção de logs de grupo de sincronização.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/syncGroups/{syncGroupName}/logs?api-version=2025-01-01&startTime={startTime}&endTime={endTime}&type={type}

Com parâmetros opcionais:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/syncGroups/{syncGroupName}/logs?api-version=2025-01-01&startTime={startTime}&endTime={endTime}&type={type}&continuationToken={continuationToken}

Parâmetros do URI

Name	Em	Obrigatório	Tipo	Descrição
databaseName	path	True	string	O nome do banco de dados.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
serverName	path	True	string	O nome do servidor.
subscriptionId	path	True	string (uuid)	A ID da assinatura de destino. O valor deve ser um UUID.
syncGroupName	path	True	string	O nome do grupo de sincronização.
api-version	query	True	string minLength: 1	A versão da API a utilizar para esta operação.
endTime	query	True	string	Obtenha logs gerados antes desse período.
startTime	query	True	string	Obtenha logs gerados após esse período.
type	query	True	SyncGroupsType	Os tipos de logs a serem recuperados.
continuationToken	query		string	O token de continuação para esta operação.

Respostas

Name	Tipo	Descrição
200 OK	SyncGroupLogListResult	Operação do Azure concluída com sucesso.
Other Status Codes	ErrorResponse	Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name	Descrição
user_impersonation	personificar a sua conta de utilizador

Exemplos

Get sync group logs

Pedido de amostra

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187/logs?api-version=2025-01-01&startTime=2017-01-01T00:00:00&endTime=2017-12-31T00:00:00&type=All


import com.azure.resourcemanager.sql.models.SyncGroupsType;

/**
 * Samples for SyncGroups ListLogs.
 */
public final class Main {
    /*
     * x-ms-original-file: 2025-01-01/SyncGroupGetLog.json
     */
    /**
     * Sample code: Get sync group logs.
     * 
     * @param manager Entry point to SqlServerManager.
     */
    public static void getSyncGroupLogs(com.azure.resourcemanager.sql.SqlServerManager manager) {
        manager.serviceClient().getSyncGroups().listLogs("syncgroupcrud-65440", "syncgroupcrud-8475",
            "syncgroupcrud-4328", "syncgroupcrud-3187", "2017-01-01T00:00:00", "2017-12-31T00:00:00",
            SyncGroupsType.ALL, null, 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

from azure.identity import DefaultAzureCredential

from azure.mgmt.sql import SqlManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-sql
# USAGE
    python sync_group_get_log.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = SqlManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="SUBSCRIPTION_ID",
    )

    response = client.sync_groups.list_logs(
        resource_group_name="syncgroupcrud-65440",
        server_name="syncgroupcrud-8475",
        database_name="syncgroupcrud-4328",
        sync_group_name="syncgroupcrud-3187",
        start_time="2017-01-01T00:00:00",
        end_time="2017-12-31T00:00:00",
        type="All",
    )
    for item in response:
        print(item)


# x-ms-original-file: 2025-01-01/SyncGroupGetLog.json
if __name__ == "__main__":
    main()

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 collection of sync group logs.
 *
 * @summary gets a collection of sync group logs.
 * x-ms-original-file: 2025-01-01/SyncGroupGetLog.json
 */
async function getSyncGroupLogs() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "00000000-1111-2222-3333-444444444444";
  const client = new SqlManagementClient(credential, subscriptionId);
  const resArray = new Array();
  for await (const item of client.syncGroups.listLogs(
    "syncgroupcrud-65440",
    "syncgroupcrud-8475",
    "syncgroupcrud-4328",
    "syncgroupcrud-3187",
    "2017-01-01T00:00:00",
    "2017-12-31T00:00:00",
    "All",
  )) {
    resArray.push(item);
  }

  console.log(resArray);
}

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

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Sql.Models;
using Azure.ResourceManager.Sql;

// Generated from example definition: specification/sql/resource-manager/Microsoft.Sql/SQL/stable/2025-01-01/examples/SyncGroupGetLog.json
// this example is just showing the usage of "SyncGroups_ListLogs" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this SyncGroupResource created on azure
// for more information of creating SyncGroupResource, please refer to the document of SyncGroupResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
string resourceGroupName = "syncgroupcrud-65440";
string serverName = "syncgroupcrud-8475";
string databaseName = "syncgroupcrud-4328";
string syncGroupName = "syncgroupcrud-3187";
ResourceIdentifier syncGroupResourceId = SyncGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, serverName, databaseName, syncGroupName);
SyncGroupResource syncGroup = client.GetSyncGroupResource(syncGroupResourceId);

// invoke the operation and iterate over the result
string startTime = "2017-01-01T00:00:00";
string endTime = "2017-12-31T00:00:00";
SyncGroupLogType type = SyncGroupLogType.All;
await foreach (SyncGroupLogProperties item in syncGroup.GetLogsAsync(startTime, endTime, type))
{
    Console.WriteLine($"Succeeded: {item}");
}

Console.WriteLine("Succeeded");

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

Resposta da amostra

Código de estado:: 200

{
  "value": [
    {
      "type": "Success",
      "operationStatus": "SchemaRefreshSuccess",
      "source": "syncgroupcrud-8475.database.windows.net/hub",
      "timestamp": "2017-05-30T07:16:08.25Z",
      "tracingId": "c0480c8e-6269-424e-9404-b00efce0ebae",
      "details": "Schema information obtained successfully."
    },
    {
      "type": "Error",
      "operationStatus": "SchemaRefreshFailure",
      "source": "syncgroupcrud-8475.database.windows.net/member",
      "timestamp": "2017-05-30T07:03:37.5733333Z",
      "tracingId": "cd3aa28c-0c31-471f-8a77-f1b21c908cbd",
      "details": "Getting schema information for the database failed with the exception \"Failed to connect to server .\nInner exception: SqlException Error Code: -2146232060 - SqlError Number:53, Message: A network-related or instance-specific error occurred while establishing a connection to SQL Server. The server was not found or was not accessible. Verify that the instance name is correct and that SQL Server is configured to allow remote connections. (provider: Named Pipes Provider, error: 40 - Could not open a connection to SQL Server) \nInner exception: The network path was not found\n For more information, provide tracing ID ‘cd3aa28c-0c31-471f-8a77-f1b21c908cbd’ to customer support.\""
    }
  ]
}

Definições

Name	Descrição
ErrorAdditionalInfo	O erro de gerenciamento de recursos informações adicionais.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
SyncGroupLogListResult	Uma lista de propriedades de log de grupo de sincronização.
SyncGroupLogProperties	Propriedades de um grupo de sincronização do Base de Dados SQL do Azure log.
SyncGroupLogType	Tipo de log do grupo de sincronização.
SyncGroupsType	Os tipos de logs a serem recuperados.

ErrorAdditionalInfo

Object

O erro de gerenciamento de recursos informações adicionais.

Name	Tipo	Descrição
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

Object

O detalhe do erro.

Name	Tipo	Descrição
additionalInfo	ErrorAdditionalInfo[]	O erro informações adicionais.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O alvo do erro.

ErrorResponse

Object

Resposta de erro

Name	Tipo	Descrição
error	ErrorDetail	O objeto de erro.

SyncGroupLogListResult

Object

Uma lista de propriedades de log de grupo de sincronização.

Name	Tipo	Descrição
nextLink	string (uri)	O link para a próxima página de itens
value	SyncGroupLogProperties[]	Os itens SyncGroupLogProperties nesta página

SyncGroupLogProperties

Object

Propriedades de um grupo de sincronização do Base de Dados SQL do Azure log.

Name	Tipo	Descrição
details	string	Detalhes do log do grupo de sincronização.
operationStatus	string	OperationStatus do log do grupo de sincronização.
source	string	Origem do log do grupo de sincronização.
timestamp	string (date-time)	Carimbo de data/hora do log do grupo de sincronização.
tracingId	string (uuid)	TracingId do log do grupo de sincronização.
type	SyncGroupLogType	Tipo de log do grupo de sincronização.

SyncGroupLogType

Enumeração

Tipo de log do grupo de sincronização.

Valor	Descrição
All	Todos
Error	Erro
Warning	Advertência
Success	Sucesso

SyncGroupsType

Enumeração

Os tipos de logs a serem recuperados.

Valor	Descrição
All	Todos
Error	Erro
Warning	Advertência
Success	Sucesso