Sync Groups - Create Or Update

Referens

Tjänst:: SQL Database

API-version:: 2021-11-01

Skapar eller uppdaterar en synkroniseringsgrupp.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
databaseName	path	True	string	Namnet på databasen där synkroniseringsgruppen finns.
resourceGroupName	path	True	string	Namnet på resursgruppen som innehåller resursen. Du kan hämta det här värdet från Azure Resource Manager-API:et eller portalen.
serverName	path	True	string	Namnet på servern.
subscriptionId	path	True	string	Prenumerations-ID:t som identifierar en Azure-prenumeration.
syncGroupName	path	True	string	Namnet på synkroniseringsgruppen.
api-version	query	True	string	DEN API-version som ska användas för begäran.

Begärandetext

Name	Typ	Description
properties.conflictLoggingRetentionInDays	integer	Kvarhållningsperiod för konfliktloggning.
properties.conflictResolutionPolicy	SyncConflictResolutionPolicy	Princip för konfliktlösning för synkroniseringsgruppen.
properties.enableConflictLogging	boolean	Om konfliktloggning är aktiverat.
properties.hubDatabasePassword	string	Lösenord för autentiseringsuppgifterna för synkroniseringsgruppens hubbdatabas.
properties.hubDatabaseUserName	string	Användarnamn för autentiseringsuppgifterna för synkroniseringsgruppens hubbdatabas.
properties.interval	integer	Synkroniseringsintervall för synkroniseringsgruppen.
properties.schema	SyncGroupSchema	Synkroniseringsschema för synkroniseringsgruppen.
properties.syncDatabaseId	string	ARM-resurs-ID för synkroniseringsdatabasen i synkroniseringsgruppen.
properties.usePrivateLinkConnection	boolean	Om du använder privat länk är anslutningen aktiverad.
sku	Sku	SKU:ns namn och kapacitet.

Svar

Name	Typ	Description
200 OK	SyncGroup	Synkroniseringsgruppen har uppdaterats.
201 Created	SyncGroup	Synkroniseringsgruppen har skapats.
202 Accepted		Det pågår att skapa eller uppdatera synkroniseringsgruppen.
Other Status Codes		Felsvar: *** 400 InvalidSyncGroupCreateOrUpdateRequest – begärandetexten för att skapa eller uppdatera synkroniseringsgruppen är tom. 400 InvalidSyncMemberCreateOrUpdateRequest – begärandetexten för att skapa eller uppdatera synkroniseringsmedlemmen är tom. 400 InvalidSyncAgentCreateOrUpdateRequest – begärandetexten för att skapa eller uppdatera synkroniseringsagenten är tom. 400 InvalidDatabaseResourceId – Ogiltig databasresursidentifierare. 400 MismatchingSubscriptionWithUrl – den angivna prenumerationen matchade inte prenumerationen i URL:en. 400 InvalidSyncAgentResourceId – Ogiltig synkroniseringsagentresursidentifierare. 400 MismatchingResourceGroupNameWithUrl – det angivna resursgruppsnamnet matchade inte namnet i URL:en. 400 MismatchingServerNameWithUrl – Det angivna servernamnet matchade inte namnet i URL:en. 400 InvalidParameterValue – ett ogiltigt värde gavs till en parameter. 400 MissingServerName – Servernamnet saknas 400 MissingDatabaseName – Databasnamnet saknas 400 MissingSyncGroupName – Namnet på synkroniseringsgruppen saknas 400 MissingConflictResolutionPolicy – Konfliktlösningsprincipen saknas 400 MissingSyncAgentName – Sync Agent-namnet saknas 400 SyncOperation_GenericFailure – Det gick inte att utföra datasynkroniseringsåtgärden. 400 InvalidSyncGroup – synkroniseringsgruppen är ogiltig. 400 FeatureDisabledOnSelectedEdition – Användaren försökte använda en funktion som är inaktiverad i den aktuella databasutgåvan. 400 CannotCreateSyncGroupDueToQuotaExceededed – Det går inte att skapa synkroniseringsgruppen på grund av att kvoten har överskridits. 400 SyncOperation_DuplicateSyncGroupDrop – Synkroniseringsgruppen tas redan bort. 400 SyncOperation_WrongSyncDatabase – Den angivna synkroniseringsdatabasen matchar inte den befintliga. 400 SyncOperation_UpdateSyncGroupWhenDropping – Det går inte att uppdatera synkroniseringsgruppen eftersom den för närvarande tas bort. 400 SyncOperation_DwInSyncGroup – Det går inte att använda datawarehouse edition i datasynkronisering. 400 SyncOperation_MasterDbInSyncGroup – Det går inte att använda logisk huvudserver i datasynkronisering. 400 SyncOperation_InvalidCredential – Databasens autentiseringsuppgifter är ogiltiga. 400 InvalidSyncMetadataDatabase – Databasen för synkroniseringsmetadata är ogiltig. 400 SyncOperation_InvalidSyncInterval – Det går inte att skapa eller uppdatera synkroniseringsgruppen eftersom synkroniseringsintervallet är ogiltigt. 404 ResourceNotFound – Den begärda resursen hittades inte. 404 SubscriptionDoesNotHaveServer – den begärda servern hittades inte 404 DatabaseDoesNotExist – Användaren har angett ett databasnamn som inte finns på den här serverinstansen. 404 SyncOperation_HubServerNotFound – Den logiska hubbservern finns inte. 404 SyncOperation_InvalidHubDatabase – Hubbdatabasen är ogiltig. 404 OperationIdNotFound – Åtgärden med ID finns inte. 409 SyncOperation_DuplicateSyncGroupName – Det går inte att skapa synkroniseringsgruppen eftersom synkroniseringsgruppen med samma namn redan finns. 409 OperationCancelled – Åtgärden har avbrutits av användaren. 409 Åtgärd avbröts – Det gick inte att slutföra åtgärden på resursen eftersom den avbröts av en annan åtgärd på samma resurs. 429 SubscriptionTooManyCreateUpdateRequests – begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 429 SubscriptionTooManyRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 500 OperationTimedOut – Tidsgränsen för åtgärden uppnåddes och återställdes automatiskt. Försök att utföra åtgärden igen. 503 TooManyRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser.

Exempel

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

Exempelsvar

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

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

Statuskod:: 202

Update a sync group

Exempelbegäran

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

Exempelsvar

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

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

Statuskod:: 202

Definitioner

Name	Description
Sku	En ARM-resurs-SKU.
SyncConflictResolutionPolicy	Princip för konfliktlösning för synkroniseringsgruppen.
SyncGroup	En Azure SQL databassynkroniseringsgrupp.
SyncGroupSchema	Egenskaper för synkroniseringsgruppsschema.
SyncGroupSchemaTable	Egenskaper för tabellen i synkroniseringsgruppschemat.
SyncGroupSchemaTableColumn	Egenskaper för kolumnen i synkroniseringsgrupptabellen.
SyncGroupState	Synkroniseringstillstånd för synkroniseringsgruppen.

Sku

En ARM-resurs-SKU.

Name	Typ	Description
capacity	integer	Kapacitet för den specifika SKU:n.
family	string	Om tjänsten har olika generationer av maskinvara, för samma SKU, kan den samlas in här.
name	string	Namnet på SKU:n, vanligtvis en bokstav + nummerkod, t.ex. P3.
size	string	Storleken på den specifika SKU:n
tier	string	Nivån eller utgåvan av den specifika SKU:n, t.ex. Basic, Premium.

SyncConflictResolutionPolicy

Princip för konfliktlösning för synkroniseringsgruppen.

Name	Typ	Description
HubWin	string
MemberWin	string

SyncGroup

En Azure SQL databassynkroniseringsgrupp.

Name	Typ	Description
id	string	Resurs-ID.
name	string	Resursnamn.
properties.conflictLoggingRetentionInDays	integer	Kvarhållningsperiod för konfliktloggning.
properties.conflictResolutionPolicy	SyncConflictResolutionPolicy	Princip för konfliktlösning för synkroniseringsgruppen.
properties.enableConflictLogging	boolean	Om konfliktloggning är aktiverat.
properties.hubDatabasePassword	string	Lösenord för autentiseringsuppgifterna för synkroniseringsgruppens hubbdatabas.
properties.hubDatabaseUserName	string	Användarnamn för autentiseringsuppgifterna för synkroniseringsgruppens hubbdatabas.
properties.interval	integer	Synkroniseringsintervall för synkroniseringsgruppen.
properties.lastSyncTime	string	Synkroniseringsgruppens senaste synkroniseringstid.
properties.privateEndpointName	string	Synkroniseringsgruppens privata slutpunktsnamn om privat länkanslutning är aktiverad.
properties.schema	SyncGroupSchema	Synkroniseringsschema för synkroniseringsgruppen.
properties.syncDatabaseId	string	ARM-resurs-ID för synkroniseringsdatabasen i synkroniseringsgruppen.
properties.syncState	SyncGroupState	Synkroniseringstillstånd för synkroniseringsgruppen.
properties.usePrivateLinkConnection	boolean	Om du använder privat länk är anslutningen aktiverad.
sku	Sku	SKU:ns namn och kapacitet.
type	string	Resurstyp.

SyncGroupSchema

Egenskaper för synkroniseringsgruppsschema.

Name	Typ	Description
masterSyncMemberName	string	Namnet på den huvudsynkroniseringsmedlem som schemat kommer från.
tables	SyncGroupSchemaTable[]	Lista över tabeller i synkroniseringsgruppsschemat.

SyncGroupSchemaTable

Egenskaper för tabellen i synkroniseringsgruppschemat.

Name	Typ	Description
columns	SyncGroupSchemaTableColumn[]	Lista över kolumner i synkroniseringsgruppsschemat.
quotedName	string	Det angivna namnet på schematabellen för synkroniseringsgrupper.

SyncGroupSchemaTableColumn

Egenskaper för kolumnen i synkroniseringsgrupptabellen.

Name	Typ	Description
dataSize	string	Datastorlek för kolumnen.
dataType	string	Datatyp för kolumnen.
quotedName	string	Det angivna namnet på kolumnen synkroniseringsgrupptabell.

SyncGroupState

Synkroniseringstillstånd för synkroniseringsgruppen.

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

Dela via

Sync Groups - Create Or Update

URI-parametrar

Begärandetext

Svar

Exempel

Create a sync group

Exempelbegäran

Exempelsvar

Update a sync group

Exempelbegäran

Exempelsvar

Definitioner

Sku

SyncConflictResolutionPolicy

SyncGroup

SyncGroupSchema

SyncGroupSchemaTable

SyncGroupSchemaTableColumn

SyncGroupState

Ytterligare resurser