Sync Groups - Create Or Update

Referencia

Szolgáltatás:: SQL Database

API-verzió:: 2021-11-01

Szinkronizálási csoportot hoz létre vagy frissít.

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
databaseName	path	True	string	Annak az adatbázisnak a neve, amelyen a szinkronizálási csoport üzemel.
resourceGroupName	path	True	string	Az erőforrást tartalmazó erőforráscsoport neve. Ezt az értéket az Azure Resource Manager API-ból vagy a portálról szerezheti be.
serverName	path	True	string	A kiszolgáló neve.
subscriptionId	path	True	string	Az Azure-előfizetést azonosító előfizetés-azonosító.
syncGroupName	path	True	string	A szinkronizálási csoport neve.
api-version	query	True	string	A kéréshez használni kívánt API-verzió.

Kérelem törzse

Name	Típus	Description
properties.conflictLoggingRetentionInDays	integer	Ütközésnaplózási megőrzési időszak.
properties.conflictResolutionPolicy	SyncConflictResolutionPolicy	A szinkronizálási csoport ütközésfeloldási szabályzata.
properties.enableConflictLogging	boolean	Ha az ütközésnaplózás engedélyezve van.
properties.hubDatabasePassword	string	A szinkronizálási csoport központi adatbázisának hitelesítő adatainak jelszava.
properties.hubDatabaseUserName	string	A szinkronizálási csoport központi adatbázisának hitelesítő adatainak felhasználóneve.
properties.interval	integer	A szinkronizálási csoport szinkronizálási időköze.
properties.schema	SyncGroupSchema	A szinkronizálási csoport szinkronizálási sémája.
properties.syncDatabaseId	string	A szinkronizálási csoport szinkronizálási adatbázisának ARM-erőforrás-azonosítója.
properties.usePrivateLinkConnection	boolean	Ha a privát kapcsolat használata engedélyezve van.
sku	Sku	A termékváltozat neve és kapacitása.

Válaszok

Name	Típus	Description
200 OK	SyncGroup	A szinkronizálási csoport frissítése sikerült.
201 Created	SyncGroup	A szinkronizálási csoport létrehozása sikerült.
202 Accepted		A szinkronizálási csoport létrehozása vagy frissítése folyamatban van.
Other Status Codes		Hibaválaszok: *** 400 InvalidSyncGroupCreateOrUpdateRequest – A szinkronizálási csoport létrehozásának vagy frissítésének kérelemtörzse üres. 400 InvalidSyncMemberCreateOrUpdateRequest – A szinkronizálási tag kérésének létrehozása vagy frissítése törzse üres. 400 InvalidSyncAgentCreateOrUpdateRequest – A szinkronizálási ügynök létrehozásának vagy frissítésének kérelemtörzse üres. 400 InvalidDatabaseResourceId – Érvénytelen adatbázis-erőforrás-azonosító. 400 MismatchingSubscriptionWithUrl – A megadott előfizetés nem egyezett meg az URL-címben szereplő előfizetéssel. 400 InvalidSyncAgentResourceId – Érvénytelen szinkronizálási ügynök erőforrás-azonosítója. 400 MismatchingResourceGroupNameWithUrl – A megadott erőforráscsoport neve nem egyezett meg az URL-címben megadott névvel. 400 MismatchingServerNameWithUrl – A megadott kiszolgálónév nem egyezett meg az URL-címben megadott névvel. 400 InvalidParameterValue – Érvénytelen értéket adott meg egy paraméternek. 400 MissingServerName – A kiszolgáló neve hiányzik 400 MissingDatabaseName – Az adatbázis neve hiányzik 400 MissingSyncGroupName – A szinkronizálási csoport neve hiányzik 400 MissingConflictResolutionPolicy – Az ütközésfeloldási szabályzat hiányzik 400 MissingSyncAgentName – A szinkronizálási ügynök neve hiányzik 400 SyncOperation_GenericFailure – Nem sikerült végrehajtani az adatszinkronizálási műveletet. 400 InvalidSyncGroup – A szinkronizálási csoport érvénytelen. 400 FeatureDisabledOnSelectedEdition – A felhasználó olyan funkciót próbált használni, amely le van tiltva az aktuális adatbázis-kiadásban. 400 Nem hozható létreSyncGroupDueToQuotaExceededed – A kvóta túllépése miatt nem hozható létre szinkronizálási csoport. 400 SyncOperation_DuplicateSyncGroupDrop – A szinkronizálási csoport már el lett dobva. 400 SyncOperation_WrongSyncDatabase – A megadott szinkronizálási adatbázis nem egyezik a meglévő adatbázissal. 400 SyncOperation_UpdateSyncGroupWhenDropping – A szinkronizálási csoport nem frissíthető, mert jelenleg elvetik. 400 SyncOperation_DwInSyncGroup – A datawarehouse kiadás nem használható az adatszinkronizálásban. 400 SyncOperation_MasterDbInSyncGroup – Nem használható logikai főkiszolgáló az adatszinkronizálásban. 400 SyncOperation_InvalidCredential – Az adatbázis hitelesítő adatai érvénytelenek. 400 InvalidSyncMetadataDatabase – A metaadat-adatbázis szinkronizálása érvénytelen. 400 SyncOperation_InvalidSyncInterval – A szinkronizálási csoport nem hozható létre vagy frissíthető, mert a szinkronizálási időköz érvénytelen. 404 ResourceNotFound – A kért erőforrás nem található. 404 SubscriptionDoesNotHaveServer – A kért kiszolgáló nem található 404 DatabaseDoesNotExist – A felhasználó olyan adatbázisnevet adott meg, amely nem létezik ezen a kiszolgálópéldányon. 404 SyncOperation_HubServerNotFound – A központi logikai kiszolgáló nem létezik. 404 SyncOperation_InvalidHubDatabase – A központi adatbázis érvénytelen. 404 OperationIdNotFound – Az azonosítóval rendelkező művelet nem létezik. 409 SyncOperation_DuplicateSyncGroupName – Nem hozható létre szinkronizálási csoport, mert az azonos nevű szinkronizálási csoport már létezik. 409 OperationCancelled – A felhasználó megszakította a műveletet. 409 OperationInterrupted – Az erőforráson végzett művelet nem hajtható végre, mert ugyanazon az erőforráson egy másik művelet megszakította. 429 SubscriptionTooManyCreateUpdateRequests – Az elérhető erőforrások által feldolgozható maximális kérelmeken túli kérések. 429 SubscriptionTooManyRequests – Az elérhető erőforrások által feldolgozható maximális kérelmeken túli kérések. 500 OperationTimedOut – A művelet túllépte az időkorlátot, és automatikusan visszagördült. Please retry the operation. 503 TooManyRequests – Az elérhető erőforrások által feldolgozható maximális kérelmeken túli kérések.

Példák

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

Mintaválasz

Állapotkód:: 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"
}

Állapotkód:: 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"
}

Állapotkód:: 202

Update a sync group

Mintakérelem

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

Mintaválasz

Állapotkód:: 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"
}

Állapotkód:: 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"
}

Állapotkód:: 202

Definíciók

Name	Description
Sku	ARM-erőforrás termékváltozata.
SyncConflictResolutionPolicy	A szinkronizálási csoport ütközésfeloldási szabályzata.
SyncGroup	Egy Azure SQL adatbázis-szinkronizálási csoport.
SyncGroupSchema	A szinkronizálási csoportséma tulajdonságai.
SyncGroupSchemaTable	A tábla tulajdonságai a szinkronizálási csoport sémájában.
SyncGroupSchemaTableColumn	A szinkronizálási csoporttáblában lévő oszlop tulajdonságai.
SyncGroupState	A szinkronizálási csoport szinkronizálási állapota.

Sku

ARM-erőforrás termékváltozata.

Name	Típus	Description
capacity	integer	Az adott termékváltozat kapacitása.
family	string	Ha a szolgáltatás különböző hardvergenerációkkal rendelkezik ugyanahhoz a termékváltozathoz, akkor az itt rögzíthető.
name	string	A termékváltozat neve, általában betű + Szám kód, pl. P3.
size	string	Az adott termékváltozat mérete
tier	string	Az adott termékváltozat (pl. Alapszintű, Prémium) szintje vagy kiadása.

SyncConflictResolutionPolicy

A szinkronizálási csoport ütközésfeloldási szabályzata.

Name	Típus	Description
HubWin	string
MemberWin	string

SyncGroup

Egy Azure SQL adatbázis-szinkronizálási csoport.

Name	Típus	Description
id	string	Erőforrás-azonosító.
name	string	Erőforrás neve.
properties.conflictLoggingRetentionInDays	integer	Ütközésnaplózási megőrzési időszak.
properties.conflictResolutionPolicy	SyncConflictResolutionPolicy	A szinkronizálási csoport ütközésfeloldási szabályzata.
properties.enableConflictLogging	boolean	Ha az ütközésnaplózás engedélyezve van.
properties.hubDatabasePassword	string	A szinkronizálási csoport központi adatbázisának hitelesítő adatainak jelszava.
properties.hubDatabaseUserName	string	A szinkronizálási csoport központi adatbázisának hitelesítő adatainak felhasználóneve.
properties.interval	integer	A szinkronizálási csoport szinkronizálási időköze.
properties.lastSyncTime	string	A szinkronizálási csoport utolsó szinkronizálási ideje.
properties.privateEndpointName	string	A szinkronizálási csoport privát végpontjának neve, ha a privát kapcsolat használata engedélyezve van.
properties.schema	SyncGroupSchema	A szinkronizálási csoport szinkronizálási sémája.
properties.syncDatabaseId	string	A szinkronizálási csoport szinkronizálási adatbázisának ARM-erőforrás-azonosítója.
properties.syncState	SyncGroupState	A szinkronizálási csoport szinkronizálási állapota.
properties.usePrivateLinkConnection	boolean	Ha a privát kapcsolat használata engedélyezve van.
sku	Sku	A termékváltozat neve és kapacitása.
type	string	Erőforrástípus.

SyncGroupSchema

A szinkronizálási csoportséma tulajdonságai.

Name	Típus	Description
masterSyncMemberName	string	Annak a fő szinkronizálási tagnak a neve, amelyből a séma származik.
tables	SyncGroupSchemaTable[]	A szinkronizálási csoport sémájában lévő táblák listája.

SyncGroupSchemaTable

A tábla tulajdonságai a szinkronizálási csoport sémájában.

Name	Típus	Description
columns	SyncGroupSchemaTableColumn[]	A szinkronizálási csoport sémájában lévő oszlopok listája.
quotedName	string	A szinkronizálási csoport sématáblájának idézett neve.

SyncGroupSchemaTableColumn

A szinkronizálási csoporttáblában lévő oszlop tulajdonságai.

Name	Típus	Description
dataSize	string	Az oszlop adatmérete.
dataType	string	Az oszlop adattípusa.
quotedName	string	A szinkronizálási csoport táblaoszlopának idézett neve.

SyncGroupState

A szinkronizálási csoport szinkronizálási állapota.

Name	Típus	Description
Error	string
Good	string
NotReady	string
Progressing	string
Warning	string

Megosztás a következőn keresztül:

Sync Groups - Create Or Update

URI-paraméterek

Kérelem törzse

Válaszok

Példák

Create a sync group

Mintakérelem

Mintaválasz

Update a sync group

Mintakérelem

Mintaválasz

Definíciók

Sku

SyncConflictResolutionPolicy

SyncGroup

SyncGroupSchema

SyncGroupSchemaTable

SyncGroupSchemaTableColumn

SyncGroupState

További források