Sync Members - Create Or Update

Referência

Serviço:: SQL Database

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

Cria ou atualiza um membro de sincronização.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/syncGroups/{syncGroupName}/syncMembers/{syncMemberName}?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 no qual o membro de sincronização está alojado.
syncMemberName	path	True	string	O nome do membro 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.databaseName	string	Nome da base de dados da base de dados membro no membro de sincronização.
properties.databaseType	SyncMemberDbType	Tipo de base de dados do membro de sincronização.
properties.password	string	Palavra-passe da base de dados membro no membro de sincronização.
properties.serverName	string	Nome do servidor da base de dados membro no membro de sincronização
properties.sqlServerDatabaseId	string	SQL Server iD da base de dados do membro de sincronização.
properties.syncAgentId	string	ID do recurso arm do agente de sincronização no membro de sincronização.
properties.syncDirection	SyncDirection	Direção de sincronização do membro de sincronização.
properties.syncMemberAzureDatabaseResourceId	string	ID de recurso do ARM da base de dados lógica de membro de sincronização, para membros de sincronização no Azure.
properties.usePrivateLinkConnection	boolean	Se pretende utilizar a ligação de ligação privada.
properties.userName	string	Nome de utilizador da base de dados membro no membro de sincronização.

Respostas

Name	Tipo	Description
200 OK	SyncMember	O membro de sincronização foi atualizado com êxito.
201 Created	SyncMember	Criou com êxito o membro de sincronização.
202 Accepted		A criação ou atualização do membro 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 InvalidSyncMember - O membro da sincronização é inválido. 400 InvalidSyncAgent - O agente de sincronização é inválido. 400 CannotCreateSyncMemberDueToQuotaExceeded - Não é possível criar um membro de sincronização devido à quota excedida. 400 SyncOperation_DuplicateSyncMemberDrop - O membro 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_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. 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_DuplicateSyncMemberName - Não é possível criar um membro de sincronização porque o membro 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 new sync member

Update a sync member

Create a new sync member

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/syncMembers/syncmembercrud-4879?api-version=2021-11-01

{
  "properties": {
    "databaseType": "AzureSqlDatabase",
    "serverName": "syncgroupcrud-3379.database.windows.net",
    "databaseName": "syncgroupcrud-7421",
    "userName": "myUser",
    "syncDirection": "Bidirectional",
    "usePrivateLinkConnection": true,
    "syncMemberAzureDatabaseResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328"
  }
}


import com.azure.resourcemanager.sql.fluent.models.SyncMemberInner;
import com.azure.resourcemanager.sql.models.SyncDirection;
import com.azure.resourcemanager.sql.models.SyncMemberDbType;

/**
 * Samples for SyncMembers CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/SyncMemberCreate.json
     */
    /**
     * Sample code: Create a new sync member.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createANewSyncMember(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getSyncMembers().createOrUpdate("syncgroupcrud-65440",
            "syncgroupcrud-8475", "syncgroupcrud-4328", "syncgroupcrud-3187", "syncmembercrud-4879",
            new SyncMemberInner().withDatabaseType(SyncMemberDbType.AZURE_SQL_DATABASE)
                .withSyncMemberAzureDatabaseResourceId(
                    "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328")
                .withUsePrivateLinkConnection(true).withServerName("syncgroupcrud-3379.database.windows.net")
                .withDatabaseName("syncgroupcrud-7421").withUsername("myUser")
                .withSyncDirection(SyncDirection.BIDIRECTIONAL),
            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": {
    "databaseType": "AzureSqlDatabase",
    "serverName": "syncgroupcrud-3379.database.windows.net",
    "databaseName": "syncgroupcrud-7421",
    "userName": "myUser",
    "syncDirection": "Bidirectional",
    "syncState": "UnProvisioned",
    "usePrivateLinkConnection": true,
    "privateEndpointName": "PE_67FDBBD6-B2D8-4014-9CC6-C68ABBCFD481_syncmembercrud-4879",
    "syncMemberAzureDatabaseResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187/syncMembers/syncmembercrud-4879",
  "name": "syncmembercrud-4879",
  "type": "Microsoft.Sql/servers/databases/syncGroups/syncMembers"
}

Código de estado:: 201

{
  "properties": {
    "databaseType": "AzureSqlDatabase",
    "serverName": "syncgroupcrud-3379.database.windows.net",
    "databaseName": "syncgroupcrud-7421",
    "userName": "myUser",
    "syncDirection": "Bidirectional",
    "syncState": "UnProvisioned",
    "usePrivateLinkConnection": true,
    "privateEndpointName": "PE_67FDBBD6-B2D8-4014-9CC6-C68ABBCFD481_syncmembercrud-4879",
    "syncMemberAzureDatabaseResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187/syncMembers/syncmembercrud-4879",
  "name": "syncmembercrud-4879",
  "type": "Microsoft.Sql/servers/databases/syncGroups/syncMembers"
}

Código de estado:: 202

Update a sync member

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/syncMembers/syncmembercrud-4879?api-version=2021-11-01

{
  "properties": {
    "databaseType": "AzureSqlDatabase",
    "serverName": "syncgroupcrud-3379.database.windows.net",
    "databaseName": "syncgroupcrud-7421",
    "userName": "myUser",
    "syncDirection": "Bidirectional",
    "usePrivateLinkConnection": true,
    "syncMemberAzureDatabaseResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328"
  }
}


import com.azure.resourcemanager.sql.fluent.models.SyncMemberInner;
import com.azure.resourcemanager.sql.models.SyncDirection;
import com.azure.resourcemanager.sql.models.SyncMemberDbType;

/**
 * Samples for SyncMembers CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/SyncMemberUpdate.json
     */
    /**
     * Sample code: Update a sync member.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updateASyncMember(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getSyncMembers().createOrUpdate("syncgroupcrud-65440",
            "syncgroupcrud-8475", "syncgroupcrud-4328", "syncgroupcrud-3187", "syncmembercrud-4879",
            new SyncMemberInner().withDatabaseType(SyncMemberDbType.AZURE_SQL_DATABASE)
                .withSyncMemberAzureDatabaseResourceId(
                    "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328")
                .withUsePrivateLinkConnection(true).withServerName("syncgroupcrud-3379.database.windows.net")
                .withDatabaseName("syncgroupcrud-7421").withUsername("myUser")
                .withSyncDirection(SyncDirection.BIDIRECTIONAL),
            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": {
    "databaseType": "AzureSqlDatabase",
    "serverName": "syncgroupcrud-3379.database.windows.net",
    "databaseName": "syncgroupcrud-7421",
    "userName": "myUser",
    "syncDirection": "Bidirectional",
    "syncState": "UnProvisioned",
    "usePrivateLinkConnection": true,
    "privateEndpointName": "PE_67FDBBD6-B2D8-4014-9CC6-C68ABBCFD481_syncmembercrud-4879",
    "syncMemberAzureDatabaseResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187/syncMembers/syncmembercrud-4879",
  "name": "syncmembercrud-4879",
  "type": "Microsoft.Sql/servers/databases/syncGroups/syncMembers"
}

Código de estado:: 201

{
  "properties": {
    "databaseType": "AzureSqlDatabase",
    "serverName": "syncgroupcrud-3379.database.windows.net",
    "databaseName": "syncgroupcrud-7421",
    "userName": "myUser",
    "syncDirection": "Bidirectional",
    "syncState": "UnProvisioned",
    "usePrivateLinkConnection": true,
    "privateEndpointName": "PE_67FDBBD6-B2D8-4014-9CC6-C68ABBCFD481_syncmembercrud-4879",
    "syncMemberAzureDatabaseResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187/syncMembers/syncmembercrud-4879",
  "name": "syncmembercrud-4879",
  "type": "Microsoft.Sql/servers/databases/syncGroups/syncMembers"
}

Código de estado:: 202

Definições

Name	Description
SyncDirection	Direção de sincronização do membro de sincronização.
SyncMember	Um membro de sincronização da Base de Dados SQL do Azure.
SyncMemberDbType	Tipo de base de dados do membro de sincronização.
SyncMemberState	Estado de sincronização do membro de sincronização.

SyncDirection

Direção de sincronização do membro de sincronização.

Name	Tipo	Description
Bidirectional	string
OneWayHubToMember	string
OneWayMemberToHub	string

SyncMember

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

Name	Tipo	Description
id	string	ID do Recurso.
name	string	Nome do recurso.
properties.databaseName	string	Nome da base de dados da base de dados membro no membro de sincronização.
properties.databaseType	SyncMemberDbType	Tipo de base de dados do membro de sincronização.
properties.password	string	Palavra-passe da base de dados membro no membro de sincronização.
properties.privateEndpointName	string	Nome do ponto final privado do membro de sincronização se a ligação de ligação privada estiver ativada para membros de sincronização no Azure.
properties.serverName	string	Nome do servidor da base de dados membro no membro de sincronização
properties.sqlServerDatabaseId	string	SQL Server iD da base de dados do membro de sincronização.
properties.syncAgentId	string	ID do recurso arm do agente de sincronização no membro de sincronização.
properties.syncDirection	SyncDirection	Direção de sincronização do membro de sincronização.
properties.syncMemberAzureDatabaseResourceId	string	ID de recurso do ARM da base de dados lógica de membro de sincronização, para membros de sincronização no Azure.
properties.syncState	SyncMemberState	Estado de sincronização do membro de sincronização.
properties.usePrivateLinkConnection	boolean	Se pretende utilizar a ligação de ligação privada.
properties.userName	string	Nome de utilizador da base de dados membro no membro de sincronização.
type	string	Tipo de recurso.

SyncMemberDbType

Tipo de base de dados do membro de sincronização.

Name	Tipo	Description
AzureSqlDatabase	string
SqlServerDatabase	string

SyncMemberState

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

Name	Tipo	Description
DeProvisionFailed	string
DeProvisioned	string
DeProvisioning	string
DisabledBackupRestore	string
DisabledTombstoneCleanup	string
ProvisionFailed	string
Provisioned	string
Provisioning	string
ReprovisionFailed	string
Reprovisioning	string
SyncCancelled	string
SyncCancelling	string
SyncFailed	string
SyncInProgress	string
SyncSucceeded	string
SyncSucceededWithWarnings	string
UnProvisioned	string
UnReprovisioned	string

Partilhar via

Sync Members - Create Or Update

Parâmetros do URI

Corpo do Pedido

Respostas

Exemplos

Create a new sync member

Pedido de amostra

Resposta da amostra

Update a sync member

Pedido de amostra

Resposta da amostra

Definições

SyncDirection

SyncMember

SyncMemberDbType

SyncMemberState

Recursos adicionais