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
databaseName
path True

string

Namnet på databasen.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Namnet på resursgruppen. Namnet är skiftlägesokänsligt.

serverName
path True

string

Namnet på servern.

subscriptionId
path True

string (uuid)

ID för målprenumerationen. Värdet måste vara ett UUID.

syncGroupName
path True

string

Namnet på synkroniseringsgruppen.

syncMemberName
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

SyncMemberDbType

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

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

SyncMember

Resursens 'SyncMember'-uppdateringsoperation lyckades

201 Created

SyncMember

Resursen 'SyncMember' skapade operationen lyckades

Sidhuvuden

  • Location: string
  • Retry-After: integer
202 Accepted

Resursåtgärden har godkänts.

Sidhuvuden

  • Location: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

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
createdByType

Den typ av identitet som skapade resursen.

ErrorAdditionalInfo

Resurshanteringsfelet ytterligare information.

ErrorDetail

Detaljerna om felet.

ErrorResponse

Felsvar

SyncDirection

Synkroniseringsriktningen för synkroniseringsmedlemmen.

SyncMember

En Azure SQL Database sync-medlem.

SyncMemberDbType

Typ av länkad databas för synkroniseringsagenten.

SyncMemberState

Synkroniseringsstatus för synkroniseringsmedlemmen.

systemData

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

ErrorAdditionalInfo[]

Felet ytterligare information.

code

string

Felkoden.

details

ErrorDetail[]

Felinformationen.

message

string

Felmeddelandet.

target

string

Felmålet.

ErrorResponse

Felsvar

Name Typ Description
error

ErrorDetail

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

SyncMemberDbType

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

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

SyncMemberState

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

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

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

createdByType

Den typ av identitet som senast ändrade resursen.