Sync Members - Create Or Update
Skapar eller uppdaterar en synkroniseringsmedlem.
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-parametrar
| Name | I | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
database
|
path | True |
string |
Namnet på databasen. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Namnet på resursgruppen. Namnet är skiftlägesokänsligt. |
|
server
|
path | True |
string |
Namnet på servern. |
|
subscription
|
path | True |
string (uuid) |
ID för målprenumerationen. Värdet måste vara ett UUID. |
|
sync
|
path | True |
string |
Namnet på synkroniseringsgruppen. |
|
sync
|
path | True |
string |
Namnet på synkroniseringsmedlemmen. |
|
api-version
|
query | True |
string minLength: 1 |
Den API-version som ska användas för den här åtgärden. |
Begärandetext
| Name | Typ | Description |
|---|---|---|
| properties.databaseName |
string |
Databasnamnet på medlemsdatabasen i synkroniseringsmedlemmen. |
| properties.databaseType |
Databastyp för synkroniseringsmedlemmen. |
|
| properties.password |
string |
Lösenord för medlemsdatabasen i synkroniseringsmedlemmen. |
| properties.serverName |
string |
Servernamn för medlemsdatabasen i synkroniseringsmedlemmen |
| properties.sqlServerDatabaseId |
string (uuid) |
SQL Server-databas-id för synkroniseringsmedlemmen. |
| properties.syncAgentId |
string |
ARM-resurs-ID för synkroniseringsagenten i synkroniseringsmedlemmen. |
| properties.syncDirection |
Synkroniseringsriktningen för synkroniseringsmedlemmen. |
|
| properties.syncMemberAzureDatabaseResourceId |
string |
ARM-resurs-id för den logiska databasen för synkroniserade medlemmar, för synkroniserade medlemmar i Azure. |
| properties.usePrivateLinkConnection |
boolean |
Om du vill använda en privat länkanslutning. |
| properties.userName |
string |
Användarnamn för medlemsdatabasen i synkroniseringsmedlemmen. |
Svar
| Name | Typ | Description |
|---|---|---|
| 200 OK |
Resursens 'SyncMember'-uppdateringsoperation lyckades |
|
| 201 Created |
Resursen 'SyncMember' skapade operationen lyckades Sidhuvuden
|
|
| 202 Accepted |
Resursåtgärden har godkänts. Sidhuvuden
|
|
| Other Status Codes |
Ett oväntat felsvar. |
Säkerhet
azure_auth
Azure Active Directory OAuth2 Flow.
Typ:
oauth2
Flow:
implicit
Auktoriseringswebbadress:
https://login.microsoftonline.com/common/oauth2/authorize
Omfattningar
| Name | Description |
|---|---|
| user_impersonation | personifiera ditt användarkonto |
Exempel
| Create a new sync member |
| Update a sync member |
Create a new sync member
Exempelbegäran
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"
}
}
Exempelsvar
{
"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
Exempelbegäran
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"
}
}
Exempelsvar
{
"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"
}
}
Definitioner
| Name | Description |
|---|---|
|
created |
Den typ av identitet som skapade resursen. |
|
Error |
Resurshanteringsfelet ytterligare information. |
|
Error |
Detaljerna om felet. |
|
Error |
Felsvar |
|
Sync |
Synkroniseringsriktningen för synkroniseringsmedlemmen. |
|
Sync |
En Azure SQL Database sync-medlem. |
|
Sync |
Typ av länkad databas för synkroniseringsagenten. |
|
Sync |
Synkroniseringsstatus för synkroniseringsmedlemmen. |
|
system |
Metadata som rör skapande och senaste ändring av resursen. |
createdByType
Den typ av identitet som skapade resursen.
| Värde | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
ErrorAdditionalInfo
Resurshanteringsfelet ytterligare information.
| Name | Typ | Description |
|---|---|---|
| info |
object |
Den ytterligare informationen. |
| type |
string |
Typen av ytterligare information. |
ErrorDetail
Detaljerna om felet.
| Name | Typ | Description |
|---|---|---|
| additionalInfo |
Felet ytterligare information. |
|
| code |
string |
Felkoden. |
| details |
Felinformationen. |
|
| message |
string |
Felmeddelandet. |
| target |
string |
Felmålet. |
ErrorResponse
Felsvar
| Name | Typ | Description |
|---|---|---|
| error |
Felet objektet. |
SyncDirection
Synkroniseringsriktningen för synkroniseringsmedlemmen.
| Värde | Description |
|---|---|
| Bidirectional |
Dubbelriktad |
| OneWayMemberToHub |
OneWayMemberToHub |
| OneWayHubToMember |
OneWayHubToMember |
SyncMember
En Azure SQL Database sync-medlem.
| Name | Typ | Description |
|---|---|---|
| id |
string (arm-id) |
Fullständigt kvalificerat resurs-ID för resursen. T.ex. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| name |
string |
Namnet på resursen |
| properties.databaseName |
string |
Databasnamnet på medlemsdatabasen i synkroniseringsmedlemmen. |
| properties.databaseType |
Databastyp för synkroniseringsmedlemmen. |
|
| properties.password |
string |
Lösenord för medlemsdatabasen i synkroniseringsmedlemmen. |
| properties.privateEndpointName |
string |
Namnet på den privata endpointen för synkmedlemmen om privat länkanslutning används är aktiverat, för synkmedlemmar i Azure. |
| properties.serverName |
string |
Servernamn för medlemsdatabasen i synkroniseringsmedlemmen |
| properties.sqlServerDatabaseId |
string (uuid) |
SQL Server-databas-id för synkroniseringsmedlemmen. |
| properties.syncAgentId |
string |
ARM-resurs-ID för synkroniseringsagenten i synkroniseringsmedlemmen. |
| properties.syncDirection |
Synkroniseringsriktningen för synkroniseringsmedlemmen. |
|
| properties.syncMemberAzureDatabaseResourceId |
string |
ARM-resurs-id för den logiska databasen för synkroniserade medlemmar, för synkroniserade medlemmar i Azure. |
| properties.syncState |
Synkroniseringsstatus för synkroniseringsmedlemmen. |
|
| properties.usePrivateLinkConnection |
boolean |
Om du vill använda en privat länkanslutning. |
| properties.userName |
string |
Användarnamn för medlemsdatabasen i synkroniseringsmedlemmen. |
| systemData |
Azure Resource Manager-metadata som innehåller creationBy och modifiedBy-information. |
|
| type |
string |
Resurstypen. T.ex. "Microsoft. Compute/virtualMachines" eller "Microsoft. Storage/storageAccounts" |
SyncMemberDbType
Typ av länkad databas för synkroniseringsagenten.
| Värde | Description |
|---|---|
| AzureSqlDatabase |
AzureSqlDatabase |
| SqlServerDatabase |
SqlServerDatabase |
SyncMemberState
Synkroniseringsstatus för synkroniseringsmedlemmen.
| Värde | Description |
|---|---|
| SyncInProgress |
SyncInProgress |
| SyncSucceeded |
SyncSucceeded |
| SyncFailed |
SyncFailed |
| DisabledTombstoneCleanup |
Funktionsnedsatt Gravstensrensning |
| DisabledBackupRestore |
InaktiveradeBackupÅterställning |
| SyncSucceededWithWarnings |
SyncSucceededMedWarnings |
| SyncCancelling |
SyncCancelling |
| SyncCancelled |
SyncCancelled |
| UnProvisioned |
Oprovisionerad |
| Provisioning |
Provisioning |
| Provisioned |
Tillhandahållen |
| ProvisionFailed |
ProvisionFailed |
| DeProvisioning |
Avprovisionering |
| DeProvisioned |
DeProvisioned |
| DeProvisionFailed |
DeProvisionFailed |
| Reprovisioning |
Omprovisionering |
| ReprovisionFailed |
ProviantMisslyckad |
| UnReprovisioned |
Ej återprovierad |
systemData
Metadata som rör skapande och senaste ändring av resursen.
| Name | Typ | Description |
|---|---|---|
| createdAt |
string (date-time) |
Tidsstämpeln för resursskapande (UTC). |
| createdBy |
string |
Identiteten som skapade resursen. |
| createdByType |
Den typ av identitet som skapade resursen. |
|
| lastModifiedAt |
string (date-time) |
Tidsstämpeln för senaste ändring av resurs (UTC) |
| lastModifiedBy |
string |
Identiteten som senast ändrade resursen. |
| lastModifiedByType |
Den typ av identitet som senast ändrade resursen. |