Sync Groups - Create Or Update

Referência

Serviço:: SQL Database

Versão da API:: 2021-11-01

Cria ou atualiza um grupo de sincronização.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
databaseName	path	True	string	O nome da base de dados na qual o grupo de sincronização está alojado.
resourceGroupName	path	True	string	O nome do grupo de recursos que contém o recurso. Pode obter este valor a partir da API do Azure Resource Manager ou do portal.
serverName	path	True	string	O nome do servidor.
subscriptionId	path	True	string	O ID da subscrição que identifica uma subscrição do Azure.
syncGroupName	path	True	string	O nome do grupo de sincronização.
api-version	query	True	string	A versão da API a utilizar para o pedido.

Corpo do Pedido

Name	Tipo	Description
properties.conflictLoggingRetentionInDays	integer	Período de retenção do registo de conflitos.
properties.conflictResolutionPolicy	SyncConflictResolutionPolicy	Política de resolução de conflitos do grupo de sincronização.
properties.enableConflictLogging	boolean	Se o registo de conflitos estiver ativado.
properties.hubDatabasePassword	string	Palavra-passe para a credencial da base de dados do hub do grupo de sincronização.
properties.hubDatabaseUserName	string	Nome de utilizador da credencial da base de dados do hub de grupo de sincronização.
properties.interval	integer	Intervalo de sincronização do grupo de sincronização.
properties.schema	SyncGroupSchema	Sincronizar o esquema do grupo de sincronização.
properties.syncDatabaseId	string	ID de recurso do ARM da base de dados de sincronização no grupo de sincronização.
properties.usePrivateLinkConnection	boolean	Se a ligação de ligação privada estiver ativada.
sku	Sku	O nome e a capacidade do SKU.

Respostas

Name	Tipo	Description
200 OK	SyncGroup	O grupo de sincronização foi atualizado com êxito.
201 Created	SyncGroup	Criou com êxito o grupo de sincronização.
202 Accepted		A criação ou atualização do grupo de sincronização está em curso.
Other Status Codes		Respostas de Erro: *** 400 InvalidSyncGroupCreateOrUpdateRequest - O corpo do pedido de grupo de sincronização de criação ou atualização está vazio. 400 InvalidSyncMemberCreateOrUpdateRequest - O corpo do pedido de membro de sincronização de criação ou atualização está vazio. 400 InvalidSyncAgentCreateOrUpdateRequest - O corpo do pedido do agente de sincronização de criação ou atualização está vazio. 400 InvalidDatabaseResourceId – identificador de recurso de base de dados inválido. 400 MismatchingSubscriptionWithUrl – a subscrição fornecida não corresponde à subscrição no Url. 400 InvalidSyncAgentResourceId - Identificador de recurso do agente de sincronização inválido. 400 MismatchingResourceGroupNameWithUrl – o nome do grupo de recursos fornecido não corresponde ao nome no Url. 400 MismatchingServerNameWithUrl – o nome do servidor fornecido não corresponde ao nome no Url. 400 InvalidParameterValue – foi atribuído um valor inválido a um parâmetro. 400 MissingServerName - O nome do servidor está em falta 400 MissingDatabaseName – O nome da base de dados está em falta 400 MissingSyncGroupName – O nome do Grupo de Sincronização está em falta 400 MissingConflictResolutionPolicy - A Política de Resolução de Conflitos está em falta 400 MissingSyncAgentName – O nome do Agente de Sincronização está em falta 400 SyncOperation_GenericFailure – Falha ao executar a operação de sincronização de dados. 400 InvalidSyncGroup - O grupo de sincronização é inválido. 400 FeatureDisabledOnSelectedEdition – o utilizador tentou utilizar uma funcionalidade que está desativada na edição atual da base de dados. 400 CannotCreateSyncGroupDueToQuotaExceeded - Não é possível criar um grupo de sincronização devido à quota excedida. 400 SyncOperation_DuplicateSyncGroupDrop - O grupo de sincronização já está a ser removido. 400 SyncOperation_WrongSyncDatabase – a base de dados de sincronização especificada não corresponde à existente. 400 SyncOperation_UpdateSyncGroupWhenDropping - Não é possível atualizar o grupo de sincronização porque está atualmente a ser removido. 400 SyncOperation_DwInSyncGroup - Não é possível utilizar a edição datawarehouse na sincronização de dados. 400 SyncOperation_MasterDbInSyncGroup – não é possível utilizar o mestre lógico na sincronização de dados. 400 SyncOperation_InvalidCredential - A credencial da base de dados é inválida. 400 InvalidSyncMetadataDatabase - A base de dados de metadados de sincronização é inválida. 400 SyncOperation_InvalidSyncInterval - Não é possível criar ou atualizar o grupo de sincronização porque o intervalo de sincronização é inválido. 404 ResourceNotFound – o recurso pedido não foi encontrado. 404 SubscriptionDoesNotHaveServer – O servidor pedido não foi encontrado 404 DatabaseDoesNotExist – o utilizador especificou um nome de base de dados que não existe nesta instância do servidor. 404 SyncOperation_HubServerNotFound - O servidor lógico hub não existe. 404 SyncOperation_InvalidHubDatabase - A base de dados do Hub é inválida. 404 OperationIdNotFound - A operação com o ID não existe. 409 SyncOperation_DuplicateSyncGroupName - Não é possível criar um grupo de sincronização porque o grupo de sincronização com o mesmo nome já existe. 409 OperationCancelled - A operação foi cancelada pelo utilizador. 409 OperationInterrupted - Não foi possível concluir a operação no recurso porque foi interrompida por outra operação no mesmo recurso. 429 SubscriptionTooManyCreateUpdateRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis. 429 SubscriptionTooManyRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis. 500 OperationTimedOut – a operação excedeu o limite de tempo e foi revertida automaticamente. Repita a operação. 503 TooManyRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis.

Exemplos

Create a sync group

Update a sync group

Create a sync group

PUT 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?api-version=2021-11-01

{
  "properties": {
    "interval": -1,
    "conflictResolutionPolicy": "HubWin",
    "syncDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328",
    "hubDatabaseUserName": "hubUser",
    "usePrivateLinkConnection": true
  }
}


import com.azure.resourcemanager.sql.fluent.models.SyncGroupInner;
import com.azure.resourcemanager.sql.models.SyncConflictResolutionPolicy;

/**
 * Samples for SyncGroups CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/SyncGroupCreate.json
     */
    /**
     * Sample code: Create a sync group.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createASyncGroup(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getSyncGroups().createOrUpdate("syncgroupcrud-65440",
            "syncgroupcrud-8475", "syncgroupcrud-4328", "syncgroupcrud-3187",
            new SyncGroupInner().withInterval(-1).withConflictResolutionPolicy(SyncConflictResolutionPolicy.HUB_WIN)
                .withSyncDatabaseId(
                    "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328")
                .withHubDatabaseUsername("hubUser").withUsePrivateLinkConnection(true),
            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

Resposta da amostra

Código de estado:: 200

{
  "properties": {
    "interval": -1,
    "lastSyncTime": "0001-01-01T08:00:00Z",
    "conflictResolutionPolicy": "HubWin",
    "syncDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328",
    "hubDatabaseUserName": "hubUser",
    "syncState": "NotReady",
    "usePrivateLinkConnection": true,
    "privateEndpointName": "PE_67FDBBD6-B2D8-4014-9CC6-C68ABBCFD481_syncgroupcrud-8475"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187",
  "name": "syncgroupcrud-3187",
  "type": "Microsoft.Sql/servers/databases/syncGroups"
}

Código de estado:: 201

{
  "properties": {
    "interval": -1,
    "lastSyncTime": "0001-01-01T08:00:00Z",
    "conflictResolutionPolicy": "HubWin",
    "syncDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328",
    "hubDatabaseUserName": "hubUser",
    "syncState": "NotReady",
    "usePrivateLinkConnection": true,
    "privateEndpointName": "PE_67FDBBD6-B2D8-4014-9CC6-C68ABBCFD481_syncgroupcrud-8475"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187",
  "name": "syncgroupcrud-3187",
  "type": "Microsoft.Sql/servers/databases/syncGroups"
}

Código de estado:: 202

Update a sync group

Pedido de amostra

HTTP
Java

PUT 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?api-version=2021-11-01

{
  "properties": {
    "interval": -1,
    "conflictResolutionPolicy": "HubWin",
    "syncDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328",
    "hubDatabaseUserName": "hubUser",
    "usePrivateLinkConnection": true
  }
}


import com.azure.resourcemanager.sql.fluent.models.SyncGroupInner;
import com.azure.resourcemanager.sql.models.SyncConflictResolutionPolicy;

/**
 * Samples for SyncGroups CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/SyncGroupUpdate.json
     */
    /**
     * Sample code: Update a sync group.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updateASyncGroup(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getSyncGroups().createOrUpdate("syncgroupcrud-65440",
            "syncgroupcrud-8475", "syncgroupcrud-4328", "syncgroupcrud-3187",
            new SyncGroupInner().withInterval(-1).withConflictResolutionPolicy(SyncConflictResolutionPolicy.HUB_WIN)
                .withSyncDatabaseId(
                    "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328")
                .withHubDatabaseUsername("hubUser").withUsePrivateLinkConnection(true),
            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

Resposta da amostra

Código de estado:: 200

{
  "properties": {
    "interval": -1,
    "lastSyncTime": "0001-01-01T08:00:00Z",
    "conflictResolutionPolicy": "HubWin",
    "syncDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328",
    "hubDatabaseUserName": "hubUser",
    "syncState": "NotReady",
    "usePrivateLinkConnection": true,
    "privateEndpointName": "PE_67FDBBD6-B2D8-4014-9CC6-C68ABBCFD481_syncgroupcrud-3187"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187",
  "name": "syncgroupcrud-3187",
  "type": "Microsoft.Sql/servers/databases/syncGroups"
}

Código de estado:: 201

{
  "properties": {
    "interval": -1,
    "lastSyncTime": "0001-01-01T08:00:00Z",
    "conflictResolutionPolicy": "HubWin",
    "syncDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328",
    "hubDatabaseUserName": "hubUser",
    "syncState": "NotReady",
    "usePrivateLinkConnection": true,
    "privateEndpointName": "PE_67FDBBD6-B2D8-4014-9CC6-C68ABBCFD481_syncgroupcrud-3187"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187",
  "name": "syncgroupcrud-3187",
  "type": "Microsoft.Sql/servers/databases/syncGroups"
}

Código de estado:: 202

Definições

Name	Description
Sku	Um SKU de Recurso do ARM.
SyncConflictResolutionPolicy	Política de resolução de conflitos do grupo de sincronização.
SyncGroup	Um grupo de sincronização da Base de Dados SQL do Azure.
SyncGroupSchema	Propriedades do esquema do grupo de sincronização.
SyncGroupSchemaTable	Propriedades da tabela no esquema do grupo de sincronização.
SyncGroupSchemaTableColumn	Propriedades da coluna na tabela de grupo de sincronização.
SyncGroupState	Estado de sincronização do grupo de sincronização.

Sku

Um SKU de Recurso do ARM.

Name	Tipo	Description
capacity	integer	Capacidade do SKU específico.
family	string	Se o serviço tiver diferentes gerações de hardware, para o mesmo SKU, isso pode ser capturado aqui.
name	string	O nome do SKU, normalmente, uma letra + Código de número, por exemplo, P3.
size	string	Tamanho do SKU específico
tier	string	O escalão ou edição do SKU específico, por exemplo, Básico, Premium.

SyncConflictResolutionPolicy

Política de resolução de conflitos do grupo de sincronização.

Name	Tipo	Description
HubWin	string
MemberWin	string

SyncGroup

Um grupo de sincronização da Base de Dados SQL do Azure.

Name	Tipo	Description
id	string	ID do Recurso.
name	string	Nome do recurso.
properties.conflictLoggingRetentionInDays	integer	Período de retenção do registo de conflitos.
properties.conflictResolutionPolicy	SyncConflictResolutionPolicy	Política de resolução de conflitos do grupo de sincronização.
properties.enableConflictLogging	boolean	Se o registo de conflitos estiver ativado.
properties.hubDatabasePassword	string	Palavra-passe para a credencial da base de dados do hub do grupo de sincronização.
properties.hubDatabaseUserName	string	Nome de utilizador da credencial da base de dados do hub de grupo de sincronização.
properties.interval	integer	Intervalo de sincronização do grupo de sincronização.
properties.lastSyncTime	string	Hora da última sincronização do grupo de sincronização.
properties.privateEndpointName	string	Nome do ponto final privado do grupo de sincronização se a ligação de ligação privada estiver ativada.
properties.schema	SyncGroupSchema	Sincronizar o esquema do grupo de sincronização.
properties.syncDatabaseId	string	ID de recurso do ARM da base de dados de sincronização no grupo de sincronização.
properties.syncState	SyncGroupState	Estado de sincronização do grupo de sincronização.
properties.usePrivateLinkConnection	boolean	Se a ligação de ligação privada estiver ativada.
sku	Sku	O nome e a capacidade do SKU.
type	string	Tipo de recurso.

SyncGroupSchema

Propriedades do esquema do grupo de sincronização.

Name	Tipo	Description
masterSyncMemberName	string	Nome do membro de sincronização principal de onde provém o esquema.
tables	SyncGroupSchemaTable[]	Lista de tabelas no esquema do grupo de sincronização.

SyncGroupSchemaTable

Propriedades da tabela no esquema do grupo de sincronização.

Name	Tipo	Description
columns	SyncGroupSchemaTableColumn[]	Lista de colunas no esquema do grupo de sincronização.
quotedName	string	Nome citado da tabela de esquema do grupo de sincronização.

SyncGroupSchemaTableColumn

Propriedades da coluna na tabela de grupo de sincronização.

Name	Tipo	Description
dataSize	string	Tamanho dos dados da coluna.
dataType	string	Tipo de dados da coluna.
quotedName	string	Nome citado da coluna da tabela de grupo de sincronização.

SyncGroupState

Estado de sincronização do grupo de sincronização.

Name	Tipo	Description
Error	string
Good	string
NotReady	string
Progressing	string
Warning	string

Partilhar via

Sync Groups - Create Or Update

Parâmetros do URI

Corpo do Pedido

Respostas

Exemplos

Create a sync group

Pedido de amostra

Resposta da amostra

Update a sync group

Pedido de amostra

Resposta da amostra

Definições

Sku

SyncConflictResolutionPolicy

SyncGroup

SyncGroupSchema

SyncGroupSchemaTable

SyncGroupSchemaTableColumn

SyncGroupState

Recursos adicionais