Sync Groups - Create Or Update
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=2025-01-01
URI-paraméterek
| Név | In | Kötelező | Típus | Description |
|---|---|---|---|---|
|
database
|
path | True |
string |
Az adatbázis neve. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket. |
|
server
|
path | True |
string |
A kiszolgáló neve. |
|
subscription
|
path | True |
string (uuid) |
A cél-előfizetés azonosítója. Az értéknek UUID-nek kell lennie. |
|
sync
|
path | True |
string |
A szinkronizálási csoport neve. |
|
api-version
|
query | True |
string minLength: 1 |
A művelethez használandó API-verzió. |
Kérelem törzse
| Név | Típus | Description |
|---|---|---|
| properties.conflictLoggingRetentionInDays |
integer (int32) |
Ütközésnaplózás megőrzési ideje. |
| properties.conflictResolutionPolicy |
A szinkronizálási csoport ütközésfeloldási szabályzata. |
|
| properties.enableConflictLogging |
boolean |
Ha engedélyezve van az ütközésnaplózás. |
| properties.hubDatabasePassword |
string (password) |
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 (int32) |
A szinkronizálási csoport szinkronizálási időköze. |
| properties.schema |
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 |
A termékváltozat neve és kapacitása. |
Válaszok
| Név | Típus | Description |
|---|---|---|
| 200 OK |
A 'SyncGroup' erőforrás frissítési művelete sikeres |
|
| 201 Created |
A 'SyncGroup' erőforrás létrehozása sikeres Fejlécek
|
|
| 202 Accepted |
Az erőforrásművelet elfogadott. Fejlécek
|
|
| Other Status Codes |
Váratlan hibaválasz. |
Biztonság
azure_auth
Azure Active Directory OAuth2 Flow.
Típus:
oauth2
Folyamat:
implicit
Engedélyezési URL:
https://login.microsoftonline.com/common/oauth2/authorize
Hatókörök
| Név | Description |
|---|---|
| user_impersonation | a felhasználói fiók megszemélyesítése |
Példák
| Create a sync group |
| Update a sync group |
Create a sync group
Mintakérelem
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=2025-01-01
{
"properties": {
"conflictResolutionPolicy": "HubWin",
"hubDatabaseUserName": "hubUser",
"interval": -1,
"syncDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328",
"usePrivateLinkConnection": true
}
}
Mintaválasz
{
"name": "syncgroupcrud-3187",
"type": "Microsoft.Sql/servers/databases/syncGroups",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187",
"properties": {
"conflictResolutionPolicy": "HubWin",
"hubDatabaseUserName": "hubUser",
"interval": -1,
"lastSyncTime": "0001-01-01T08:00:00Z",
"privateEndpointName": "PE_67FDBBD6-B2D8-4014-9CC6-C68ABBCFD481_syncgroupcrud-8475",
"syncDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328",
"syncState": "NotReady",
"usePrivateLinkConnection": true
}
}
{
"name": "syncgroupcrud-3187",
"type": "Microsoft.Sql/servers/databases/syncGroups",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187",
"properties": {
"conflictResolutionPolicy": "HubWin",
"hubDatabaseUserName": "hubUser",
"interval": -1,
"lastSyncTime": "0001-01-01T08:00:00Z",
"privateEndpointName": "PE_67FDBBD6-B2D8-4014-9CC6-C68ABBCFD481_syncgroupcrud-8475",
"syncDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328",
"syncState": "NotReady",
"usePrivateLinkConnection": true
}
}
Update a sync group
Mintakérelem
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=2025-01-01
{
"properties": {
"conflictResolutionPolicy": "HubWin",
"hubDatabaseUserName": "hubUser",
"interval": -1,
"syncDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328",
"usePrivateLinkConnection": true
}
}
Mintaválasz
{
"name": "syncgroupcrud-3187",
"type": "Microsoft.Sql/servers/databases/syncGroups",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187",
"properties": {
"conflictResolutionPolicy": "HubWin",
"hubDatabaseUserName": "hubUser",
"interval": -1,
"lastSyncTime": "0001-01-01T08:00:00Z",
"privateEndpointName": "PE_67FDBBD6-B2D8-4014-9CC6-C68ABBCFD481_syncgroupcrud-3187",
"syncDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328",
"syncState": "NotReady",
"usePrivateLinkConnection": true
}
}
{
"name": "syncgroupcrud-3187",
"type": "Microsoft.Sql/servers/databases/syncGroups",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187",
"properties": {
"conflictResolutionPolicy": "HubWin",
"hubDatabaseUserName": "hubUser",
"interval": -1,
"lastSyncTime": "0001-01-01T08:00:00Z",
"privateEndpointName": "PE_67FDBBD6-B2D8-4014-9CC6-C68ABBCFD481_syncgroupcrud-3187",
"syncDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328",
"syncState": "NotReady",
"usePrivateLinkConnection": true
}
}
Definíciók
| Név | Description |
|---|---|
|
created |
Az erőforrást létrehozó identitás típusa. |
|
Error |
Az erőforrás-kezelési hiba további információi. |
|
Error |
A hiba részletei. |
|
Error |
Hibaválasz |
| Sku |
ARM-erőforrás termékváltozata. |
|
Sync |
A szinkronizálási csoport ütközésfeloldási szabályzata. |
|
Sync |
Egy Azure SQL Database sync group. |
|
Sync |
A szinkronizálási csoport sémájának tulajdonságai. |
|
Sync |
A tábla tulajdonságai a szinkronizálási csoport sémájában. |
|
Sync |
A szinkronizálási csoport táblájának oszloptulajdonságai. |
|
Sync |
A szinkronizálási csoport szinkronizálási állapota. |
|
system |
Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok. |
createdByType
Az erőforrást létrehozó identitás típusa.
| Érték | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
ErrorAdditionalInfo
Az erőforrás-kezelési hiba további információi.
| Név | Típus | Description |
|---|---|---|
| info |
object |
A további információk. |
| type |
string |
A további információtípus. |
ErrorDetail
A hiba részletei.
| Név | Típus | Description |
|---|---|---|
| additionalInfo |
A hiba további információi. |
|
| code |
string |
A hibakód. |
| details |
A hiba részletei. |
|
| message |
string |
A hibaüzenet. |
| target |
string |
A hiba célpontja. |
ErrorResponse
Hibaválasz
| Név | Típus | Description |
|---|---|---|
| error |
A hibaobjektum. |
Sku
ARM-erőforrás termékváltozata.
| Név | Típus | Description |
|---|---|---|
| capacity |
integer (int32) |
Az adott termékváltozat kapacitása. |
| family |
string |
Ha a szolgáltatás különböző hardvergenerációval rendelkezik ugyanahhoz az SKU-hoz, akkor ezt itt rögzítheti. |
| name |
string |
Az termékváltozat neve általában egy betű + Szám kód, pl. P3. |
| size |
string |
Az adott termékváltozat mérete |
| tier |
string |
Az adott termékváltozat szintje vagy kiadása, például Alapszintű, Prémium. |
SyncConflictResolutionPolicy
A szinkronizálási csoport ütközésfeloldási szabályzata.
| Érték | Description |
|---|---|
| HubWin |
HubWin |
| MemberWin |
MemberWin |
SyncGroup
Egy Azure SQL Database sync group.
| Név | Típus | Description |
|---|---|---|
| id |
string (arm-id) |
Az erőforrás teljes erőforrás-azonosítója. Például: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| name |
string |
Az erőforrás neve |
| properties.conflictLoggingRetentionInDays |
integer (int32) |
Ütközésnaplózás megőrzési ideje. |
| properties.conflictResolutionPolicy |
A szinkronizálási csoport ütközésfeloldási szabályzata. |
|
| properties.enableConflictLogging |
boolean |
Ha engedélyezve van az ütközésnaplózás. |
| properties.hubDatabasePassword |
string (password) |
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 (int32) |
A szinkronizálási csoport szinkronizálási időköze. |
| properties.lastSyncTime |
string (date-time) |
A szinkronizálási csoport utolsó szinkronizálási ideje. |
| properties.privateEndpointName |
string |
Ha engedélyezve van a privát kapcsolat használata, a szinkronizálási csoport privát végpontjának neve. |
| properties.schema |
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 |
A szinkronizálási csoport szinkronizálási állapota. |
|
| properties.usePrivateLinkConnection |
boolean |
Ha a privát kapcsolat használata engedélyezve van. |
| sku |
A termékváltozat neve és kapacitása. |
|
| systemData |
Azure Resource Manager metaadat, amely createdBy és modifiedBy információkat tartalmaz. |
|
| type |
string |
Az erőforrás típusa. Például: "Microsoft. Compute/virtualMachines" vagy "Microsoft. Tárhely/tárolásFiókok" |
SyncGroupSchema
A szinkronizálási csoport sémájának tulajdonságai.
| Név | Típus | Description |
|---|---|---|
| masterSyncMemberName |
string |
Annak a fő szinkronizálási tagnak a neve, ahonnan a séma származik. |
| tables |
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.
| Név | Típus | Description |
|---|---|---|
| columns |
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 csoport táblájának oszloptulajdonságai.
| Név | 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.
| Érték | Description |
|---|---|
| NotReady |
NotReady |
| Error |
Error |
| Warning |
Figyelmeztetés |
| Progressing |
Fejlődés |
| Good |
Jó |
systemData
Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.
| Név | Típus | Description |
|---|---|---|
| createdAt |
string (date-time) |
Az erőforrás-létrehozás időbélyege (UTC). |
| createdBy |
string |
Az erőforrást létrehozó identitás. |
| createdByType |
Az erőforrást létrehozó identitás típusa. |
|
| lastModifiedAt |
string (date-time) |
Az erőforrás utolsó módosításának időbélyege (UTC) |
| lastModifiedBy |
string |
Az erőforrást legutóbb módosító identitás. |
| lastModifiedByType |
Az erőforrást legutóbb módosító identitás típusa. |