Partilhar via


Sync Members - Create Or Update

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=2023-08-01

Parâmetros do URI

Name Em Necessário Tipo Description
databaseName
path True

string

O nome do banco de dados no qual o grupo de sincronização está hospedado.

resourceGroupName
path True

string

O nome do grupo de recursos que contém o recurso. Você pode obter esse valor da API do Azure Resource Manager ou do portal.

serverName
path True

string

O nome do servidor.

subscriptionId
path True

string

A ID de assinatura que identifica uma assinatura do Azure.

syncGroupName
path True

string

O nome do grupo de sincronização no qual o membro de sincronização está hospedado.

syncMemberName
path True

string

O nome do membro de sincronização.

api-version
query True

string

A versão da API a ser usada para a solicitação.

Corpo do Pedido

Name Tipo Description
properties.databaseName

string

Nome do banco de dados do banco de dados membro no membro de sincronização.

properties.databaseType

SyncMemberDbType

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

properties.password

string

Senha do banco de dados de membros no membro de sincronização.

properties.serverName

string

Nome do servidor do banco de dados membro no membro de sincronização

properties.sqlServerDatabaseId

string (uuid)

ID do banco de dados do SQL Server do membro de sincronização.

properties.syncAgentId

string

ID de 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 ARM do banco de dados lógico de membro de sincronização, para membros de sincronização no Azure.

properties.usePrivateLinkConnection

boolean

Se deve usar a conexão de link privado.

properties.userName

string

Nome de usuário do banco de dados de membros no membro de sincronização.

Respostas

Name Tipo Description
200 OK

SyncMember

Atualizado com êxito o membro de sincronização.

201 Created

SyncMember

Criado com êxito o membro de sincronização.

202 Accepted

A criação ou atualização do membro de sincronização está em andamento.

Cabeçalhos

Location: string

Other Status Codes

ErrorResponse

Respostas de erro: ***

  • 400 InvalidSyncGroupCreateOrUpdateRequest - O corpo da solicitação de grupo de sincronização de criação ou atualização está vazio.

  • 400 InvalidSyncMemberCreateOrUpdateRequest - O corpo da solicitação de membro de sincronização de criação ou atualização está vazio.

  • 400 InvalidSyncAgentCreateOrUpdateRequest - O corpo da solicitação do agente de sincronização de criação ou atualização está vazio.

  • 400 InvalidDatabaseResourceId - Identificador de recurso de banco de dados inválido.

  • 400 InvalidSyncGroupName - O nome do grupo de sincronização é inválido. Este campo pode conter letras, números, traços e sublinhados.

  • 400 InvalidSyncMemberName - O nome do membro de sincronização é inválido. Este campo pode conter letras, números, traços e sublinhados.

  • 400 MissingSyncMemberName - O nome do membro de sincronização está ausente

  • 400 InvalidSyncGroupInterval - O intervalo de sincronização deve ser maior ou igual a 5 segundos.

  • 400 MismatchingSubscriptionWithUrl - A assinatura fornecida não correspondeu à assinatura na Url.

  • 400 InvalidSyncAgentResourceId - Identificador de recurso do agente de sincronização inválido.

  • 400 MismatchingResourceGroupNameWithUrl - O nome do grupo de recursos fornecido não correspondia ao nome na Url.

  • 400 MismatchingServerNameWithUrl - O nome do servidor fornecido não correspondeu ao nome na Url.

  • 400 InvalidParameterValue - Um valor inválido foi dado a um parâmetro.

  • 400 MissingServerName - O nome do servidor está faltando

  • 400 MissingDatabaseName - O nome do banco de dados está faltando

  • 400 MissingSyncGroupName - O nome do grupo de sincronização está ausente

  • 400 MissingConflictResolutionPolicy - A Política de Resolução de Conflitos está ausente

  • 400 MissingSyncAgentName - O nome do agente de sincronização está ausente

  • 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 de sincronização é inválido.

  • 400 InvalidSyncAgent - O agente de sincronização é inválido.

  • 400 CannotCreateSyncMemberDueToQuotaExceeded - Não é possível criar membro de sincronização devido à quota excedida.

  • 400 SyncOperation_DuplicateSyncMemberDrop - O membro de sincronização já está sendo descartado.

  • 400 SyncOperation_WrongSyncDatabase - O banco de dados de sincronização especificado não corresponde ao existente.

  • 400 SyncOperation_DwInSyncGroup - Não é possível usar a edição do datawarehouse na sincronização de dados.

  • 400 SyncOperation_MasterDbInSyncGroup - Não é possível usar o mestre lógico na sincronização de dados.

  • 400 SyncOperation_UnsupportedDataTypeColumnInSchema - Não é possível adicionar coluna ao esquema porque o tipo de dados da coluna não é suportado.

  • 400 SyncOperation_InvalidCredential - A credencial do banco de dados é inválida.

  • 400 InvalidSyncMetadataDatabase - O banco de dados de metadados de sincronização é inválido.

  • 404 ResourceNotFound - O recurso solicitado não foi encontrado.

  • 404 SubscriptionDoesNotHaveServer - O servidor solicitado não foi encontrado

  • 404 DatabaseDoesNotExist - O usuário especificou um nome de banco de dados que não existe nesta instância do servidor.

  • 404 SyncOperation_HubServerNotFound - O servidor lógico do hub não existe.

  • 404 SyncOperation_InvalidHubDatabase - O banco de dados do hub é inválido.

  • 404 OperationIdNotFound - A operação com Id não existe.

  • 409 SyncOperation_DuplicateSyncMemberName - Não é possível criar membro de sincronização porque o membro de sincronização com o mesmo nome já existe.

  • 409 CannotCancelOperation - A operação de gerenciamento está em um estado que não pode ser cancelado.

  • 409 OperationCancelled - A operação foi cancelada pelo usuário.

  • 409 OperationInterrupted - A operação no recurso não pôde ser concluída porque foi interrompida por outra operação no mesmo recurso.

  • 429 SubscriptionTooManyCreateUpdateRequests - Solicitações além do máximo de solicitações que podem ser processadas pelos recursos disponíveis.

  • 429 SubscriptionTooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas pelos recursos disponíveis.

  • 500 OperationTimedOut - A operação atingiu o tempo limite e foi revertida automaticamente. Por favor, tente novamente a operação.

  • 503 TooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas pelos recursos disponíveis.

Exemplos

Create a new sync member
Update a sync member

Create a new sync member

Pedido de amostra

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=2023-08-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"
  }
}

Resposta da amostra

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

Update a sync member

Pedido de amostra

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=2023-08-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"
  }
}

Resposta da amostra

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

Definições

Name Description
ErrorAdditionalInfo

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

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta de erro

SyncDirection

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

SyncMember

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

SyncMemberDbType

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

SyncMemberState

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

ErrorAdditionalInfo

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

Name Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Name Tipo Description
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 destino do erro.

ErrorResponse

Resposta de erro

Name Tipo Description
error

ErrorDetail

O objeto de erro.

SyncDirection

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

Valor Description
Bidirectional
OneWayMemberToHub
OneWayHubToMember

SyncMember

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

Name Tipo Description
id

string

ID do recurso.

name

string

Nome do recurso.

properties.databaseName

string

Nome do banco de dados do banco de dados membro no membro de sincronização.

properties.databaseType

SyncMemberDbType

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

properties.password

string

Senha do banco de dados de membros no membro de sincronização.

properties.privateEndpointName

string

Nome do ponto de extremidade privado do membro de sincronização se usar conexão de link privado estiver habilitado, para membros de sincronização no Azure.

properties.serverName

string

Nome do servidor do banco de dados membro no membro de sincronização

properties.sqlServerDatabaseId

string (uuid)

ID do banco de dados do SQL Server do membro de sincronização.

properties.syncAgentId

string

ID de 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 ARM do banco de dados lógico 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 deve usar a conexão de link privado.

properties.userName

string

Nome de usuário do banco de dados de membros no membro de sincronização.

type

string

Tipo de recurso.

SyncMemberDbType

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

Valor Description
AzureSqlDatabase
SqlServerDatabase

SyncMemberState

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

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