Sync Members - Get

Referência

Serviço:: SQL Database

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

Obtém um membro de sincronização.

GET 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 de URI

Nome	Em	Obrigató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 por meio da API do Gerenciador de Recursos do Azure ou por meio 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.

Respostas

Nome	Tipo	Description
200 OK	SyncMember	Recuperou com êxito o membro de sincronização especificado.
Other Status Codes		Respostas de erro: *** 400 InvalidSyncGroupCreateOrUpdateRequest - O corpo da solicitação do grupo de sincronização criar ou atualizar está vazio. 400 InvalidSyncMemberCreateOrUpdateRequest - O corpo da solicitação do membro de sincronização criar ou atualizar 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 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 correspondeu 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á ausente 400 MissingDatabaseName - O nome do banco de dados está ausente 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 à cota 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 datawarehouse na sincronização de dados. 400 SyncOperation_MasterDbInSyncGroup - Não é possível usar master lógicas na sincronização de dados. 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 de servidor. 404 SyncOperation_HubServerNotFound – O servidor lógico do hub não existe. 404 SyncOperation_InvalidHubDatabase – O banco de dados hub é inválido. 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.

Nome

Tipo

Description

200 OK

SyncMember

Recuperou com êxito o membro de sincronização especificado.

Other Status Codes

Respostas de erro: ***

400 InvalidSyncGroupCreateOrUpdateRequest - O corpo da solicitação do grupo de sincronização criar ou atualizar está vazio.
400 InvalidSyncMemberCreateOrUpdateRequest - O corpo da solicitação do membro de sincronização criar ou atualizar 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 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 correspondeu 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á ausente
400 MissingDatabaseName - O nome do banco de dados está ausente
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 à cota 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 datawarehouse na sincronização de dados.
400 SyncOperation_MasterDbInSyncGroup - Não é possível usar master lógicas na sincronização de dados.
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 de servidor.
404 SyncOperation_HubServerNotFound – O servidor lógico do hub não existe.
404 SyncOperation_InvalidHubDatabase – O banco de dados hub é inválido.
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.

Exemplos

Get a sync member

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


/**
 * Samples for SyncMembers Get.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/SyncMemberGet.json
     */
    /**
     * Sample code: Get a sync member.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getASyncMember(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getSyncMembers().getWithResponse("syncgroupcrud-65440",
            "syncgroupcrud-8475", "syncgroupcrud-4328", "syncgroupcrud-3187", "syncmembercrud-4879",
            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 de exemplo

Código de status:: 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"
}

Definições

Nome	Description
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.

SyncDirection

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

Nome	Tipo	Description
Bidirectional	string
OneWayHubToMember	string
OneWayMemberToHub	string

SyncMember

Um membro de sincronização do banco de dados SQL do Azure.

Nome	Tipo	Description
id	string	ID do recurso.
name	string	Nome do recurso.
properties.databaseName	string	Nome 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 membro no membro de sincronização.
properties.privateEndpointName	string	Nome do ponto de extremidade privado do membro de sincronização se usar a 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	SQL Server id do banco de dados do membro de sincronização.
properties.syncAgentId	string	ID de recurso do 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 do banco de dados lógico 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 a conexão de link privado deve ser usada.
properties.userName	string	Nome de usuário do banco de dados membro no membro de sincronização.
type	string	Tipo de recurso.

SyncMemberDbType

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

Nome	Tipo	Description
AzureSqlDatabase	string
SqlServerDatabase	string

SyncMemberState

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

Nome	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

Compartilhar via

Sync Members - Get

Parâmetros de URI

Respostas

Exemplos

Get a sync member

Solicitação de exemplo

Resposta de exemplo

Definições

SyncDirection

SyncMember

SyncMemberDbType

SyncMemberState

Recursos adicionais