Sync Members - Create Or Update

Vytvoří nebo aktualizuje člena synchronizace.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
databaseName
path True

string

Název databáze.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Název skupiny prostředků. Název nerozlišuje malá a velká písmena.

serverName
path True

string

Název serveru.

subscriptionId
path True

string (uuid)

ID cílového předplatného. Hodnota musí být UUID.

syncGroupName
path True

string

Název skupiny synchronizace.

syncMemberName
path True

string

Název člena synchronizace.

api-version
query True

string

minLength: 1

Verze rozhraní API, která se má použít pro tuto operaci.

Text požadavku

Name Typ Description
properties.databaseName

string

Název databáze člena v synchronizačním členu.

properties.databaseType

SyncMemberDbType

Typ databáze člena synchronizace

properties.password

string

Heslo členské databáze v synchronizačním členu.

properties.serverName

string

Název serveru členské databáze v synchronizačním členu

properties.sqlServerDatabaseId

string (uuid)

Identifikace databáze SQL Server člena synchronizace.

properties.syncAgentId

string

ID prostředku ARM agenta synchronizace v členu synchronizace

properties.syncDirection

SyncDirection

Směr synchronizace člena synchronizace

properties.syncMemberAzureDatabaseResourceId

string

ARM resource id logické databáze sync členů, pro sync členy v Azure.

properties.usePrivateLinkConnection

boolean

Určuje, jestli se má použít připojení privátního propojení.

properties.userName

string

Uživatelské jméno členské databáze v synchronizačním členu.

Odpovědi

Name Typ Description
200 OK

SyncMember

Aktualizace zdroje 'SyncMember' byla úspěšná

201 Created

SyncMember

Operace vytvoření zdroje 'SyncMember' byla úspěšná

Hlavičky

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

Operace prostředku byla přijata.

Hlavičky

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

ErrorResponse

Neočekávaná chybová odpověď

Zabezpečení

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name Description
user_impersonation zosobnění uživatelského účtu

Příklady

Create a new sync member
Update a sync member

Create a new sync member

Ukázkový požadavek

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"
  }
}

Ukázková odpověď

{
  "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

Ukázkový požadavek

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"
  }
}

Ukázková odpověď

{
  "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"
  }
}

Definice

Name Description
createdByType

Typ identity, která prostředek vytvořila.

ErrorAdditionalInfo

Další informace o chybě správy prostředků

ErrorDetail

Podrobnosti o chybě.

ErrorResponse

Chybová odpověď

SyncDirection

Směr synchronizace člena synchronizace

SyncMember

Člen synchronizace Azure SQL Database.

SyncMemberDbType

Typ propojené databáze agenta synchronizace

SyncMemberState

Stav synchronizace člena synchronizace

systemData

Metadata týkající se vytvoření a poslední změny prostředku.

createdByType

Typ identity, která prostředek vytvořila.

Hodnota Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Další informace o chybě správy prostředků

Name Typ Description
info

object

Další informace.

type

string

Další typ informací.

ErrorDetail

Podrobnosti o chybě.

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Další informace o chybě.

code

string

Kód chyby.

details

ErrorDetail[]

Podrobnosti o chybě.

message

string

Chybová zpráva.

target

string

Cíl chyby.

ErrorResponse

Chybová odpověď

Name Typ Description
error

ErrorDetail

Objekt chyby.

SyncDirection

Směr synchronizace člena synchronizace

Hodnota Description
Bidirectional

Obousměrný

OneWayMemberToHub

OneWayMemberToHub

OneWayHubToMember

OneWayHubToMember

SyncMember

Člen synchronizace Azure SQL Database.

Name Typ Description
id

string (arm-id)

Plně kvalifikované ID prostředku pro prostředek. Např. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

Název prostředku

properties.databaseName

string

Název databáze člena v synchronizačním členu.

properties.databaseType

SyncMemberDbType

Typ databáze člena synchronizace

properties.password

string

Heslo členské databáze v synchronizačním členu.

properties.privateEndpointName

string

Soukromý název endpointu člena synchronizace, pokud je povoleno soukromé spojení pro členy synchronizace v Azure.

properties.serverName

string

Název serveru členské databáze v synchronizačním členu

properties.sqlServerDatabaseId

string (uuid)

Identifikace databáze SQL Server člena synchronizace.

properties.syncAgentId

string

ID prostředku ARM agenta synchronizace v členu synchronizace

properties.syncDirection

SyncDirection

Směr synchronizace člena synchronizace

properties.syncMemberAzureDatabaseResourceId

string

ARM resource id logické databáze sync členů, pro sync členy v Azure.

properties.syncState

SyncMemberState

Stav synchronizace člena synchronizace

properties.usePrivateLinkConnection

boolean

Určuje, jestli se má použít připojení privátního propojení.

properties.userName

string

Uživatelské jméno členské databáze v synchronizačním členu.

systemData

systemData

Azure Resource Manager metadata obsahující informace createdBy a modifiedBy.

type

string

Typ prostředku. Například "Microsoft. Compute/virtualMachines" nebo "Microsoft. Úložiště/úložištěÚčty"

SyncMemberDbType

Typ propojené databáze agenta synchronizace

Hodnota Description
AzureSqlDatabase

AzureSqlDatabase

SqlServerDatabase

SqlServerDatabase

SyncMemberState

Stav synchronizace člena synchronizace

Hodnota Description
SyncInProgress

SyncInProgress

SyncSucceeded

SyncSucceeded

SyncFailed

SyncFailed

DisabledTombstoneCleanup

NeaktivovánoÚklid na kameni

DisabledBackupRestore

DisabledBackupRestore

SyncSucceededWithWarnings

SynchronizaceUspělSVarováními

SyncCancelling

Synchronizace rušení

SyncCancelled

SyncCancelled

UnProvisioned

UnProvisioned

Provisioning

Provisioning

Provisioned

Poskytnuto

ProvisionFailed

ProvisionFailed

DeProvisioning

DeProvisioning

DeProvisioned

DeProvisioned

DeProvisionFailed

DeProvisionFailed

Reprovisioning

Obnovení nastavení

ReprovisionFailed

ReprovisionFailed

UnReprovisioned

Neobnoveno

systemData

Metadata týkající se vytvoření a poslední změny prostředku.

Name Typ Description
createdAt

string (date-time)

Časové razítko vytvoření prostředku (UTC).

createdBy

string

Identita, která prostředek vytvořila.

createdByType

createdByType

Typ identity, která prostředek vytvořila.

lastModifiedAt

string (date-time)

Časové razítko poslední změny zdroje (UTC)

lastModifiedBy

string

Identita, která naposledy změnila prostředek.

lastModifiedByType

createdByType

Typ identity, která naposledy změnila prostředek.