Sync Members - Create Or Update
Szinkronizálási tagot hoz létre vagy frissít.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/syncGroups/{syncGroupName}/syncMembers/{syncMemberName}?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. |
|
sync
|
path | True |
string |
A szinkronizálási tag 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.databaseName |
string |
A tagadatbázis adatbázisneve a szinkronizálási tagban. |
| properties.databaseType |
A szinkronizálási tag adatbázistípusa. |
|
| properties.password |
string |
A tagadatbázis jelszava a szinkronizálási tagban. |
| properties.serverName |
string |
A tagadatbázis kiszolgálóneve a szinkronizálási tagban |
| properties.sqlServerDatabaseId |
string (uuid) |
SQL Server adatbázis azonosítója a sync tagnak. |
| properties.syncAgentId |
string |
A szinkronizálási ügynök ARM-erőforrás-azonosítója a szinkronizálási tagban. |
| properties.syncDirection |
A szinkronizálási tag szinkronizálási iránya. |
|
| properties.syncMemberAzureDatabaseResourceId |
string |
A sync tag logikai adatbázis ARM erőforrás azonosítója, az Azure-i szinkron tagokhoz. |
| properties.usePrivateLinkConnection |
boolean |
Privát kapcsolat használata. |
| properties.userName |
string |
A tagadatbázis felhasználóneve a szinkronizálási tagban. |
Válaszok
| Név | Típus | Description |
|---|---|---|
| 200 OK |
A 'SyncMember' erőforrás frissítési művelete sikeres |
|
| 201 Created |
'SyncMember' 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 new sync member |
| Update a sync member |
Create a new sync member
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/syncMembers/syncmembercrud-4879?api-version=2025-01-01
{
"properties": {
"databaseName": "syncgroupcrud-7421",
"databaseType": "AzureSqlDatabase",
"serverName": "syncgroupcrud-3379.database.windows.net",
"syncDirection": "Bidirectional",
"syncMemberAzureDatabaseResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328",
"usePrivateLinkConnection": true,
"userName": "myUser"
}
}
Mintaválasz
{
"name": "syncmembercrud-4879",
"type": "Microsoft.Sql/servers/databases/syncGroups/syncMembers",
"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",
"properties": {
"databaseName": "syncgroupcrud-7421",
"databaseType": "AzureSqlDatabase",
"privateEndpointName": "PE_67FDBBD6-B2D8-4014-9CC6-C68ABBCFD481_syncmembercrud-4879",
"serverName": "syncgroupcrud-3379.database.windows.net",
"syncDirection": "Bidirectional",
"syncMemberAzureDatabaseResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328",
"syncState": "UnProvisioned",
"usePrivateLinkConnection": true,
"userName": "myUser"
}
}
{
"name": "syncmembercrud-4879",
"type": "Microsoft.Sql/servers/databases/syncGroups/syncMembers",
"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",
"properties": {
"databaseName": "syncgroupcrud-7421",
"databaseType": "AzureSqlDatabase",
"privateEndpointName": "PE_67FDBBD6-B2D8-4014-9CC6-C68ABBCFD481_syncmembercrud-4879",
"serverName": "syncgroupcrud-3379.database.windows.net",
"syncDirection": "Bidirectional",
"syncMemberAzureDatabaseResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328",
"syncState": "UnProvisioned",
"usePrivateLinkConnection": true,
"userName": "myUser"
}
}
Update a sync member
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/syncMembers/syncmembercrud-4879?api-version=2025-01-01
{
"properties": {
"databaseName": "syncgroupcrud-7421",
"databaseType": "AzureSqlDatabase",
"serverName": "syncgroupcrud-3379.database.windows.net",
"syncDirection": "Bidirectional",
"syncMemberAzureDatabaseResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328",
"usePrivateLinkConnection": true,
"userName": "myUser"
}
}
Mintaválasz
{
"name": "syncmembercrud-4879",
"type": "Microsoft.Sql/servers/databases/syncGroups/syncMembers",
"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",
"properties": {
"databaseName": "syncgroupcrud-7421",
"databaseType": "AzureSqlDatabase",
"privateEndpointName": "PE_67FDBBD6-B2D8-4014-9CC6-C68ABBCFD481_syncmembercrud-4879",
"serverName": "syncgroupcrud-3379.database.windows.net",
"syncDirection": "Bidirectional",
"syncMemberAzureDatabaseResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328",
"syncState": "UnProvisioned",
"usePrivateLinkConnection": true,
"userName": "myUser"
}
}
{
"name": "syncmembercrud-4879",
"type": "Microsoft.Sql/servers/databases/syncGroups/syncMembers",
"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",
"properties": {
"databaseName": "syncgroupcrud-7421",
"databaseType": "AzureSqlDatabase",
"privateEndpointName": "PE_67FDBBD6-B2D8-4014-9CC6-C68ABBCFD481_syncmembercrud-4879",
"serverName": "syncgroupcrud-3379.database.windows.net",
"syncDirection": "Bidirectional",
"syncMemberAzureDatabaseResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328",
"syncState": "UnProvisioned",
"usePrivateLinkConnection": true,
"userName": "myUser"
}
}
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 |
|
Sync |
A szinkronizálási tag szinkronizálási iránya. |
|
Sync |
An Azure SQL Database sync member. |
|
Sync |
A szinkronizálási ügynök társított adatbázisának típusa. |
|
Sync |
A szinkronizálási tag 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. |
SyncDirection
A szinkronizálási tag szinkronizálási iránya.
| Érték | Description |
|---|---|
| Bidirectional |
Kétirányú |
| OneWayMemberToHub |
OneWayMemberToHub |
| OneWayHubToMember |
OneWayHubToMember |
SyncMember
An Azure SQL Database sync member.
| 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.databaseName |
string |
A tagadatbázis adatbázisneve a szinkronizálási tagban. |
| properties.databaseType |
A szinkronizálási tag adatbázistípusa. |
|
| properties.password |
string |
A tagadatbázis jelszava a szinkronizálási tagban. |
| properties.privateEndpointName |
string |
A szinkronizáló tag privát végpont neve, ha a privát link kapcsolat engedélyezve van, az Azure-ban szinkronizáló tagok esetén. |
| properties.serverName |
string |
A tagadatbázis kiszolgálóneve a szinkronizálási tagban |
| properties.sqlServerDatabaseId |
string (uuid) |
SQL Server adatbázis azonosítója a sync tagnak. |
| properties.syncAgentId |
string |
A szinkronizálási ügynök ARM-erőforrás-azonosítója a szinkronizálási tagban. |
| properties.syncDirection |
A szinkronizálási tag szinkronizálási iránya. |
|
| properties.syncMemberAzureDatabaseResourceId |
string |
A sync tag logikai adatbázis ARM erőforrás azonosítója, az Azure-i szinkron tagokhoz. |
| properties.syncState |
A szinkronizálási tag szinkronizálási állapota. |
|
| properties.usePrivateLinkConnection |
boolean |
Privát kapcsolat használata. |
| properties.userName |
string |
A tagadatbázis felhasználóneve a szinkronizálási tagban. |
| 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" |
SyncMemberDbType
A szinkronizálási ügynök társított adatbázisának típusa.
| Érték | Description |
|---|---|
| AzureSqlDatabase |
AzureSqlDatabase |
| SqlServerDatabase |
SqlServerDatabase |
SyncMemberState
A szinkronizálási tag szinkronizálási állapota.
| Érték | Description |
|---|---|
| SyncInProgress |
SyncInProgress |
| SyncSucceeded |
SyncSucceeded |
| SyncFailed |
SyncFailed |
| DisabledTombstoneCleanup |
Disabled TombstoneCleanup |
| DisabledBackupRestore |
DisabledBackupRestore |
| SyncSucceededWithWarnings |
SyncSucceededWithWarnings |
| SyncCancelling |
SyncCancelling |
| SyncCancelled |
SyncCancelled |
| UnProvisioned |
Ellátástalan |
| Provisioning |
Provisioning |
| Provisioned |
Előkészítve |
| ProvisionFailed |
ProvisionFailed |
| DeProvisioning |
Deprovisioning |
| DeProvisioned |
Deprovisioned |
| DeProvisionFailed |
DeprovisionFailed |
| Reprovisioning |
Újrakiosztás |
| ReprovisionFailed |
Újraellátás Sikertelen |
| UnReprovisioned |
Utánpótlás nélkül |
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. |