Sync Members - Create Or Update

Referentie

Service:: SQL Database

API-versie:: 2021-11-01

Hiermee wordt een synchronisatielid gemaakt of bijgewerkt.

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

URI-parameters

Name	In	Vereist	Type	Description
databaseName	path	True	string	De naam van de database waarop de synchronisatiegroep wordt gehost.
resourceGroupName	path	True	string	De naam van de resourcegroep die de resource bevat. U kunt deze waarde verkrijgen via de Azure Resource Manager-API of de portal.
serverName	path	True	string	De naam van de server.
subscriptionId	path	True	string	De abonnements-id waarmee een Azure-abonnement wordt geïdentificeerd.
syncGroupName	path	True	string	De naam van de synchronisatiegroep waarin het synchronisatielid wordt gehost.
syncMemberName	path	True	string	De naam van het synchronisatielid.
api-version	query	True	string	De API-versie die moet worden gebruikt voor de aanvraag.

Aanvraagbody

Name	Type	Description
properties.databaseName	string	Databasenaam van de liddatabase in het synchronisatielid.
properties.databaseType	SyncMemberDbType	Databasetype van het synchronisatielid.
properties.password	string	Wachtwoord van de liddatabase in het synchronisatielid.
properties.serverName	string	Servernaam van de liddatabase in het synchronisatielid
properties.sqlServerDatabaseId	string	SQL Server database-id van het synchronisatielid.
properties.syncAgentId	string	ARM-resource-id van de synchronisatieagent in het synchronisatielid.
properties.syncDirection	SyncDirection	Synchronisatierichting van het synchronisatielid.
properties.syncMemberAzureDatabaseResourceId	string	ARM-resource-id van de logische database van het synchronisatielid voor synchronisatieleden in Azure.
properties.usePrivateLinkConnection	boolean	Of u een Private Link-verbinding wilt gebruiken.
properties.userName	string	Gebruikersnaam van de liddatabase in het synchronisatielid.

Antwoorden

Name	Type	Description
200 OK	SyncMember	Het synchronisatielid is bijgewerkt.
201 Created	SyncMember	Het synchronisatielid is gemaakt.
202 Accepted		Het synchronisatielid wordt gemaakt of bijgewerkt.
Other Status Codes		Foutreacties: *** 400 InvalidSyncGroupCreateOrUpdateRequest - De aanvraagtekst van de synchronisatiegroep maken of bijwerken is leeg. 400 InvalidSyncMemberCreateOrUpdateRequest - De aanvraagtekst van het synchronisatielid maken of bijwerken is leeg. 400 InvalidSyncAgentCreateOrUpdateRequest - De aanvraagtekst van de synchronisatieagent maken of bijwerken is leeg. 400 InvalidDatabaseResourceId - Ongeldige databaseresource-id. 400 Komt niet overeenSubscriptionWithUrl : het opgegeven abonnement komt niet overeen met het abonnement in de URL. 400 InvalidSyncAgentResourceId - Ongeldige resource-id van de synchronisatieagent. 400 Komt niet overeenResourceGroupNameWithUrl - De opgegeven naam van de resourcegroep komt niet overeen met de naam in de URL. 400 Komt niet overeenServerNameWithUrl - De opgegeven servernaam komt niet overeen met de naam in de URL. 400 InvalidParameterValue : er is een ongeldige waarde opgegeven voor een parameter. 400 MissingServerName - De servernaam ontbreekt 400 MissingDatabaseName - De databasenaam ontbreekt 400 MissingSyncGroupName - De naam van de synchronisatiegroep ontbreekt 400 MissingConflictResolutionPolicy - Het conflictoplossingsbeleid ontbreekt 400 MissingSyncAgentName - De naam van de synchronisatieagent ontbreekt 400 SyncOperation_GenericFailure : kan de gegevenssynchronisatiebewerking niet uitvoeren. 400 InvalidSyncGroup - Synchronisatiegroep is ongeldig. 400 InvalidSyncMember - Synchronisatielid is ongeldig. 400 InvalidSyncAgent - De synchronisatieagent is ongeldig. 400 CannotCreateSyncMemberDueToQuotaExceeded - Kan geen synchronisatielid maken omdat het quotum is overschreden. 400 SyncOperation_DuplicateSyncMemberDrop : het synchronisatielid wordt al verwijderd. 400 SyncOperation_WrongSyncDatabase: de opgegeven synchronisatiedatabase komt niet overeen met de bestaande database. 400 SyncOperation_DwInSyncGroup : kan de datawarehouse-editie niet gebruiken in gegevenssynchronisatie. 400 SyncOperation_MasterDbInSyncGroup : kan logische master niet gebruiken in gegevenssynchronisatie. 400 SyncOperation_InvalidCredential - De referentie van de database is ongeldig. 400 InvalidSyncMetadataDatabase - Database met synchronisatiemetagegevens is ongeldig. 404 ResourceNotFound - De aangevraagde resource is niet gevonden. 404 SubscriptionDoesNotHaveServer - De aangevraagde server is niet gevonden 404 DatabaseDoesNotExist - Gebruiker heeft een databasenaam opgegeven die niet bestaat op dit serverexemplaar. 404 SyncOperation_HubServerNotFound - Logische hubserver bestaat niet. 404 SyncOperation_InvalidHubDatabase - Hub-database is ongeldig. 404 OperationIdNotFound - De bewerking met id bestaat niet. 409 SyncOperation_DuplicateSyncMemberName : kan geen synchronisatielid maken omdat het synchronisatielid met dezelfde naam al bestaat. 409 OperationCancelled : de bewerking is geannuleerd door de gebruiker. 409 Bewerking onderbroken: de bewerking op de resource kan niet worden voltooid omdat deze is onderbroken door een andere bewerking op dezelfde resource. 429 SubscriptionTooManyCreateUpdateRequests - Aanvragen die verder gaan dan het maximumaantal aanvragen dat kan worden verwerkt door beschikbare resources. 429 SubscriptionTooManyRequests : aanvragen die verder gaan dan het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources. 500 OperationTimedOut: er is een time-out opgetreden voor de bewerking en deze is automatisch teruggedraaid. Probeer de bewerking opnieuw uit te voeren. 503 TooManyRequests : aanvragen die verder gaan dan het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources.

Voorbeelden

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

Voorbeeldrespons

Statuscode:: 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"
}

Statuscode:: 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"
}

Statuscode:: 202

Update a sync member

Voorbeeldaanvraag

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

Voorbeeldrespons

Statuscode:: 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"
}

Statuscode:: 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"
}

Statuscode:: 202

Definities

Name	Description
SyncDirection	Synchronisatierichting van het synchronisatielid.
SyncMember	Een Azure SQL databasesynchronisatielid.
SyncMemberDbType	Databasetype van het synchronisatielid.
SyncMemberState	Synchronisatiestatus van het synchronisatielid.

SyncDirection

Synchronisatierichting van het synchronisatielid.

Name	Type	Description
Bidirectional	string
OneWayHubToMember	string
OneWayMemberToHub	string

SyncMember

Een Azure SQL databasesynchronisatielid.

Name	Type	Description
id	string	Resource-id.
name	string	Resourcenaam.
properties.databaseName	string	Databasenaam van de liddatabase in het synchronisatielid.
properties.databaseType	SyncMemberDbType	Databasetype van het synchronisatielid.
properties.password	string	Wachtwoord van de liddatabase in het synchronisatielid.
properties.privateEndpointName	string	De naam van het privé-eindpunt van het synchronisatielid als private link-verbinding gebruiken is ingeschakeld voor synchronisatieleden in Azure.
properties.serverName	string	Servernaam van de liddatabase in het synchronisatielid
properties.sqlServerDatabaseId	string	SQL Server database-id van het synchronisatielid.
properties.syncAgentId	string	ARM-resource-id van de synchronisatieagent in het synchronisatielid.
properties.syncDirection	SyncDirection	Synchronisatierichting van het synchronisatielid.
properties.syncMemberAzureDatabaseResourceId	string	ARM-resource-id van de logische database van het synchronisatielid voor synchronisatieleden in Azure.
properties.syncState	SyncMemberState	Synchronisatiestatus van het synchronisatielid.
properties.usePrivateLinkConnection	boolean	Of u een Private Link-verbinding wilt gebruiken.
properties.userName	string	Gebruikersnaam van de liddatabase in het synchronisatielid.
type	string	Resourcetype.

SyncMemberDbType

Databasetype van het synchronisatielid.

Name	Type	Description
AzureSqlDatabase	string
SqlServerDatabase	string

SyncMemberState

Synchronisatiestatus van het synchronisatielid.

Name	Type	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

Delen via

Sync Members - Create Or Update

URI-parameters

Aanvraagbody

Antwoorden

Voorbeelden

Create a new sync member

Voorbeeldaanvraag

Voorbeeldrespons

Update a sync member

Voorbeeldaanvraag

Voorbeeldrespons

Definities

SyncDirection

SyncMember

SyncMemberDbType

SyncMemberState

Aanvullende resources