Sync Members - Create Or Update

Layanan:
SQL Database
Versi API:
2025-01-01

Membuat atau memperbarui anggota sinkronisasi.

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

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
databaseName
 path True

string

Nama database.
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

Nama grup sumber daya. Nama tidak sensitif terhadap penggunaan huruf besar atau kecil.
serverName
 path True

string

Nama server.
subscriptionId
 path True

string (uuid)

ID langganan target. Nilainya harus sebuah UUID.
syncGroupName
 path True

string

Nama grup sinkronisasi.
syncMemberName
 path True

string

Nama anggota sinkronisasi.
api-version
 query True

string

minLength: 1

Versi API yang digunakan untuk operasi ini.

Isi Permintaan

Nama Jenis Deskripsi
properties.databaseName

string

Nama database database anggota di anggota sinkronisasi.
properties.databaseType

SyncMemberDbType

Jenis database anggota sinkronisasi.
properties.password

string

Kata sandi database anggota di anggota sinkronisasi.
properties.serverName

string

Nama server database anggota di anggota sinkronisasi
properties.sqlServerDatabaseId

string (uuid)

ID database SQL Server dari anggota sinkronisasi.
properties.syncAgentId

string

Id sumber daya ARM dari agen sinkronisasi di anggota sinkronisasi.
properties.syncDirection

SyncDirection

Arah sinkronisasi anggota sinkronisasi.
properties.syncMemberAzureDatabaseResourceId

string

ID sumber daya ARM dari database logis anggota sinkronisasi, untuk anggota sinkronisasi di Azure.
properties.usePrivateLinkConnection

boolean

Apakah akan menggunakan koneksi tautan privat.
properties.userName

string

Nama pengguna database anggota di anggota sinkronisasi.

Respons

Nama Jenis Deskripsi
200 OK

SyncMember

Operasi pembaruan 'SyncMember' sumber daya berhasil
201 Created

SyncMember

Operasi pembuatan 'SyncMember' sumber daya berhasil

Header

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

Operasi sumber daya diterima.

Header

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

ErrorResponse

Respons kesalahan tak terduga.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory.

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama Deskripsi
user_impersonation meniru akun pengguna Anda

Contoh

Create a new sync member
Update a sync member

Create a new sync member

Permintaan sampel

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

Respon sampel

Kode status:
200 
{
  "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"
  }
}
Kode status:
201 
{
  "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"
  }
}
Kode status:
202

Update a sync member

Permintaan sampel

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

Respon sampel

Kode status:
200 
{
  "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"
  }
}
Kode status:
201 
{
  "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"
  }
}
Kode status:
202

Definisi

Nama Deskripsi
createdByType

Jenis identitas yang membuat sumber daya.
ErrorAdditionalInfo

Info tambahan kesalahan manajemen sumber daya.
ErrorDetail

Detail kesalahan.
ErrorResponse

Tanggapan kesalahan
SyncDirection

Arah sinkronisasi anggota sinkronisasi.
SyncMember

Anggota sinkronisasi Azure SQL Database.
SyncMemberDbType

Jenis database tertaut agen sinkronisasi.
SyncMemberState

Status sinkronisasi anggota sinkronisasi.
systemData

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

createdByType

Enumerasi

Jenis identitas yang membuat sumber daya.

Nilai Deskripsi
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objek

Info tambahan kesalahan manajemen sumber daya.

Nama Jenis Deskripsi
info

object

Info tambahan.
type

string

Jenis info tambahan.

ErrorDetail

Objek

Detail kesalahan.

Nama Jenis Deskripsi
additionalInfo

ErrorAdditionalInfo[]

Info tambahan kesalahan.
code

string

Kode kesalahan.
details

ErrorDetail[]

Rincian kesalahan.
message

string

Pesan kesalahan.
target

string

Sasaran kesalahan.

ErrorResponse

Objek

Tanggapan kesalahan

Nama Jenis Deskripsi
error

ErrorDetail

Objek kesalahan.

SyncDirection

Enumerasi

Arah sinkronisasi anggota sinkronisasi.

Nilai Deskripsi
Bidirectional

Dua arah
OneWayMemberToHub

OneWayMemberToHub
OneWayHubToMember

OneWayHubToMember

SyncMember

Objek

Anggota sinkronisasi Azure SQL Database.

Nama Jenis Deskripsi
id

string (arm-id)

ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Misalnya "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name

string

Nama sumber daya
properties.databaseName

string

Nama database database anggota di anggota sinkronisasi.
properties.databaseType

SyncMemberDbType

Jenis database anggota sinkronisasi.
properties.password

string

Kata sandi database anggota di anggota sinkronisasi.
properties.privateEndpointName

string

Nama titik akhir privat anggota sinkronisasi jika gunakan koneksi tautan privat diaktifkan, untuk anggota sinkronisasi di Azure.
properties.serverName

string

Nama server database anggota di anggota sinkronisasi
properties.sqlServerDatabaseId

string (uuid)

ID database SQL Server dari anggota sinkronisasi.
properties.syncAgentId

string

Id sumber daya ARM dari agen sinkronisasi di anggota sinkronisasi.
properties.syncDirection

SyncDirection

Arah sinkronisasi anggota sinkronisasi.
properties.syncMemberAzureDatabaseResourceId

string

ID sumber daya ARM dari database logis anggota sinkronisasi, untuk anggota sinkronisasi di Azure.
properties.syncState

SyncMemberState

Status sinkronisasi anggota sinkronisasi.
properties.usePrivateLinkConnection

boolean

Apakah akan menggunakan koneksi tautan privat.
properties.userName

string

Nama pengguna database anggota di anggota sinkronisasi.
systemData

systemData

Metadata Azure Resource Manager yang berisi informasi createdBy dan modifiedBy.
type

string

Jenis sumber daya. Misalnya "Microsoft. Komputasi/virtualMachines" atau "Microsoft. Akun penyimpanan/penyimpanan"

SyncMemberDbType

Enumerasi

Jenis database tertaut agen sinkronisasi.

Nilai Deskripsi
AzureSqlDatabase

AzureSqlDatabase
SqlServerDatabase

Database SqlServerDatabase

SyncMemberState

Enumerasi

Status sinkronisasi anggota sinkronisasi.

Nilai Deskripsi
SyncInProgress

Sinkronisasi Kemajuan
SyncSucceeded

SinkronisasiBerhasil
SyncFailed

SinkronisasiGagal
DisabledTombstoneCleanup

DinonaktifkanBatu NisanPembersihan
DisabledBackupRestore

DinonaktifkanCadanganPemulihan
SyncSucceededWithWarnings

SyncSucceededWithWarnings
SyncCancelling

SinkronisasiPembatalan
SyncCancelled

SinkronisasiDibatalkan
UnProvisioned

Tidak Disediakan
Provisioning

Provisioning
Provisioned

Disiapkan
ProvisionFailed

ProvisiGagal
DeProvisioning

DeProvisi
DeProvisioned

Dihapus Ketentuan
DeProvisionFailed

DeProvisionFailed
Reprovisioning

Penyediaan ulang
ReprovisionFailed

Penyediaan Ulang Gagal
UnReprovisioned

Tidak Disediakan Ulang

systemData

Objek

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

Nama Jenis Deskripsi
createdAt

string (date-time)

Tanda waktu pembuatan sumber daya (UTC).
createdBy

string

Identitas yang membuat sumber daya.
createdByType

createdByType

Jenis identitas yang membuat sumber daya.
lastModifiedAt

string (date-time)

Stempel waktu modifikasi terakhir sumber daya (UTC)
lastModifiedBy

string

Identitas yang terakhir mengubah sumber daya.
lastModifiedByType

createdByType

Jenis identitas yang terakhir memodifikasi sumber daya.