Servers - Update

Memperbarui server.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}?api-version=2021-08-01-preview

Parameter URI

Name In Required Type Description
resourceGroupName
path True
  • string

Nama grup sumber daya yang berisi sumber daya. Anda dapat memperoleh nilai ini dari Azure Resource Manager API atau portal.

serverName
path True
  • string

Nama server.

subscriptionId
path True
  • string

ID langganan yang mengidentifikasi langganan Azure.

api-version
query True
  • string

Versi API yang digunakan untuk permintaan.

Isi Permintaan

Name Type Description
identity

Identitas server

properties.administratorLogin
  • string

Nama pengguna administrator untuk server. Setelah dibuat, itu tidak dapat diubah.

properties.administratorLoginPassword
  • string

Kata sandi masuk administrator (diperlukan untuk pembuatan server).

properties.administrators

Administrator Azure Active Directory server.

properties.federatedClientId
  • string

Id Klien yang digunakan untuk skenario CMK lintas penyewa

properties.keyId
  • string

URI CMK kunci yang digunakan untuk enkripsi.

properties.minimalTlsVersion
  • string

Versi TLS minimal. Nilai yang diizinkan: '1.0', '1.1', '1.2'

properties.primaryUserAssignedIdentityId
  • string

Id sumber daya identitas yang ditetapkan pengguna yang akan digunakan secara default.

properties.publicNetworkAccess

Apakah akses titik akhir publik diizinkan atau tidak untuk server ini. Nilai bersifat opsional tetapi jika diteruskan, harus 'Diaktifkan' atau 'Dinonaktifkan'

properties.restrictOutboundNetworkAccess

Apakah akan membatasi akses jaringan keluar untuk server ini atau tidak. Nilai bersifat opsional tetapi jika diteruskan, harus 'Diaktifkan' atau 'Dinonaktifkan'

properties.version
  • string

Versi server.

tags
  • object

Tag sumber daya.

Respons

Name Type Description
200 OK

Berhasil memperbarui server.

202 Accepted

Diterima

Other Status Codes

Respons Kesalahan: ***

  • 400 MissingIdentityId - Tidak ada identitas yang ditetapkan pengguna yang disediakan saat jenis identitas diatur ke UserAssigned

  • 400 InvalidPrimaryIdentityId - Pengguna menyediakan nilai untuk PrimaryUserIdentityId tetapi hal yang sama tidak tercantum dalam parameter IdentityId

  • 400 PECsNotExistingToDenyPublicNetworkAccess - Tidak dapat mengatur Tolak Akses Jaringan Publik ke Ya karena tidak ada titik akhir privat yang diaktifkan untuk mengakses server. Silakan siapkan titik akhir privat dan coba lagi operasi (https://docs.microsoft.com/azure/sql-database/sql-database-private-endpoint-overview#how-to-set-up-private-link-for-azure-sql-database).

  • 400 NameAlreadyExists - Nama yang disediakan sudah ada.

  • 400 UmiMissingAkvPermissions - PrimaryUserAssignedIdentityId yang disediakan oleh pengguna tidak memiliki akses ke KeyId yang disediakan

  • 400 MissingPrimaryIdentity - PrimaryUserAssignedIdentityId yang disediakan oleh pengguna tidak memiliki akses ke KeyId yang disediakan

  • 400 ProvisioningDisabled - Menampilkan pesan kesalahan dari otorisasi operasi sumber daya apa adanya, tanpa perubahan

  • 400 PrimaryIdentityMissingPermissionForKeyId - KeyId disediakan oleh pengguna selama pembuatan tetapi PrimaryUserAssignedIdentityId tidak disediakan dalam panggilan API

  • 400 InvalidIdentityTypeForKeyId - KeyId disediakan oleh pengguna selama pembuatan tetapi jenis identitas tidak diatur ke 'UserAssigned'

  • 400 InvalidLoginName - Nama masuk yang disediakan tidak valid.

  • 400 InvalidUsername - Nama pengguna yang disediakan berisi karakter yang tidak valid.

  • 400 Ipv6FeatureNotEnabled - Pengguna mencoba mengaktifkan dukungan Ipv6 di server tanpa mengaktifkan bendera fitur pada langganan, atau dukungan fitur saat ini dinonaktifkan di wilayah tersebut.

  • 400 PasswordTooShort - Kata sandi yang disediakan terlalu pendek

  • 400 AadOnlyAuthenticationIsEnabled - Azure Active Directory Hanya Autentikasi diaktifkan. Silakan hubungi administrator sistem Anda.

  • 400 RegionDoesNotSupportVersion - Pengguna mencoba membuat server versi tertentu di lokasi di mana versi server tersebut tidak didukung.

  • 400 PasswordTooLong - Kata sandi yang disediakan terlalu panjang.

  • 400 PasswordNotComplex - Kata sandi yang disediakan tidak cukup kompleks.

  • 400 InvalidParameterValue - Nilai yang tidak valid diberikan ke parameter.

  • 400 InvalidLocation - Lokasi yang tidak valid ditentukan.

  • 400 InvalidServerName - Nama server yang ditentukan tidak valid.

  • 400 InvalidIdentifier - Pengidentifikasi berisi NULL atau karakter unicode yang tidak valid.

  • 400 TokenTooLong - Token yang disediakan terlalu panjang.

  • 400 RegionDoesNotAllowProvisioning - Lokasi yang dipilih tidak menerima server Windows Azure SQL Database baru. Ini dapat berubah di lain waktu.

  • 400 ServerNotFound - Server yang diminta tidak ditemukan.

  • 400 InvalidMinimalTlsVersion - Versi TLS minimal tidak valid.

  • 400 InvalidExternalAdministratorLogin - Nama masuk administrator eksternal tidak valid atau hilang.

  • 400 InvalidExternalAdministratorSid - Id objek administrator eksternal tidak valid atau hilang.

  • 400 InvalidExternalAdministratorTenantId - Id penyewa administrator eksternal tidak valid atau hilang.

  • 400 ExternalAdministratorPrincipalType - Tipe prinsipal administrator eksternal tidak valid atau hilang. Pilih dari Pengguna, Aplikasi, atau Grup.

  • 400 MissingExternalAdministratorWithAadOnlyAuth - Untuk menggunakan Autentikasi Hanya Azure AD, harap berikan detail administrator eksternal.

  • 404 SubscriptionDoesNotHaveServer - Server yang diminta tidak ditemukan

  • 404 ServerNotInSubscriptionResourceGroup - Server yang ditentukan tidak ada di grup sumber daya dan langganan yang ditentukan.

  • 404 OperationIdNotFound - Operasi dengan Id tidak ada.

  • 404 SubscriptionNotFound - Langganan yang diminta tidak ditemukan.

  • 409 OperationCancelled - Operasi telah dibatalkan oleh pengguna.

  • 409 OperationInterrupted - Operasi pada sumber daya tidak dapat diselesaikan karena terganggu oleh operasi lain pada sumber daya yang sama.

  • 409 UpsertLogicalServerRequestAlreadyInProgress - Permintaan server logis yang sedang berlangsung sudah berlangsung, silakan coba permintaan Anda lagi nanti.

  • 409 ServerDisabled - Server dinonaktifkan.

  • 409 ConflictingServerOperation - Operasi saat ini sedang berlangsung untuk server.

  • 409 SubscriptionDisabled - Langganan dinonaktifkan.

  • 409 ServerQuotaExceeded - Server tidak dapat ditambahkan ke langganan karena akan melebihi kuota.

  • 409 ServerAlreadyExists - Nama server duplikat.

  • 429 SubscriptionTooManyCreateUpdateRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia.

  • 429 SubscriptionTooManyRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia.

  • 429 ConflictingSubscriptionOperation - Operasi saat ini sedang berlangsung untuk langganan.

  • 500 OperationTimedOut - Waktu operasi habis dan secara otomatis digulung balik. Silakan coba lagi operasi ini.

  • 503 TooManyRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia.

Contoh

Update a server

Sample Request

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-4645?api-version=2021-08-01-preview

{
  "properties": {
    "administratorLogin": "dummylogin",
    "administratorLoginPassword": "placeholder",
    "publicNetworkAccess": "Disabled",
    "restrictOutboundNetworkAccess": "Enabled"
  }
}

Sample Response

{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-4645",
  "name": "sqlcrudtest-4645",
  "type": "Microsoft.Sql/servers",
  "location": "japaneast",
  "kind": "v12.0",
  "properties": {
    "fullyQualifiedDomainName": "sqlcrudtest-4645.database.windows.net",
    "administratorLogin": "dummylogin",
    "version": "12.0",
    "state": "Ready",
    "publicNetworkAccess": "Disabled",
    "restrictOutboundNetworkAccess": "Enabled",
    "privateEndpointConnections": [
      {
        "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-4645/privateEndpointConnections/private-endpoint-name-00000000-1111-2222-3333-444444444444",
        "properties": {
          "provisioningState": "Ready",
          "privateEndpoint": {
            "id": "/subscriptions/55555555-6666-7777-8888-999999999999/resourceGroups/Default-Network/providers/Microsoft.Network/privateEndpoints/private-endpoint-name"
          },
          "privateLinkServiceConnectionState": {
            "status": "Approved",
            "description": "Auto-approved",
            "actionsRequired": "None"
          }
        }
      }
    ]
  }
}

Definisi

AdministratorType

Jenis administrator sever.

IdentityType

Jenis identitas. Atur ini ke 'SystemAssigned' untuk membuat dan menetapkan prinsipal Azure Active Directory secara otomatis untuk sumber daya.

PrincipalType

Jenis Utama administrator sever.

PrivateEndpointConnectionProperties

Properti koneksi titik akhir privat.

PrivateEndpointProperty
PrivateEndpointProvisioningState

Status koneksi titik akhir privat.

PrivateLinkServiceConnectionStateActionsRequire

Tindakan yang diperlukan untuk koneksi layanan tautan privat.

PrivateLinkServiceConnectionStateProperty
PrivateLinkServiceConnectionStateStatus

Status koneksi layanan tautan privat.

ResourceIdentity

Azure Active Directory konfigurasi identitas untuk sumber daya.

Server

Server Azure SQL Database.

ServerExternalAdministrator

Properti administrator direktori aktif.

ServerNetworkAccessFlag

Apakah akses titik akhir publik diizinkan atau tidak untuk server ini. Nilai bersifat opsional tetapi jika diteruskan, harus 'Diaktifkan' atau 'Dinonaktifkan'

ServerPrivateEndpointConnection

Koneksi titik akhir privat di bawah server

ServerUpdate

Permintaan pembaruan untuk server Azure SQL Database.

ServerWorkspaceFeature

Apakah server yang ada memiliki ruang kerja yang dibuat atau tidak dan apakah memungkinkan koneksi dari ruang kerja

UserIdentity

Azure Active Directory konfigurasi identitas untuk sumber daya.

AdministratorType

Jenis administrator sever.

Name Type Description
ActiveDirectory
  • string

IdentityType

Jenis identitas. Atur ini ke 'SystemAssigned' untuk membuat dan menetapkan prinsipal Azure Active Directory secara otomatis untuk sumber daya.

Name Type Description
None
  • string
SystemAssigned
  • string
SystemAssigned,UserAssigned
  • string
UserAssigned
  • string

PrincipalType

Jenis Utama administrator sever.

Name Type Description
Application
  • string
Group
  • string
User
  • string

PrivateEndpointConnectionProperties

Properti koneksi titik akhir privat.

Name Type Description
groupIds
  • string[]

ID grup.

privateEndpoint

Titik akhir privat tempat koneksi berada.

privateLinkServiceConnectionState

Status koneksi koneksi titik akhir privat.

provisioningState

Status koneksi titik akhir privat.

PrivateEndpointProperty

Name Type Description
id
  • string

Id sumber daya titik akhir privat.

PrivateEndpointProvisioningState

Status koneksi titik akhir privat.

Name Type Description
Approving
  • string
Dropping
  • string
Failed
  • string
Ready
  • string
Rejecting
  • string

PrivateLinkServiceConnectionStateActionsRequire

Tindakan yang diperlukan untuk koneksi layanan tautan privat.

Name Type Description
None
  • string

PrivateLinkServiceConnectionStateProperty

Name Type Description
actionsRequired

Tindakan yang diperlukan untuk koneksi layanan tautan privat.

description
  • string

Deskripsi koneksi layanan tautan privat.

status

Status koneksi layanan tautan privat.

PrivateLinkServiceConnectionStateStatus

Status koneksi layanan tautan privat.

Name Type Description
Approved
  • string
Disconnected
  • string
Pending
  • string
Rejected
  • string

ResourceIdentity

Azure Active Directory konfigurasi identitas untuk sumber daya.

Name Type Description
principalId
  • string

Id utama Azure Active Directory.

tenantId
  • string

Id penyewa Azure Active Directory.

type

Jenis identitas. Atur ini ke 'SystemAssigned' untuk membuat dan menetapkan prinsipal Azure Active Directory secara otomatis untuk sumber daya.

userAssignedIdentities

Id sumber daya dari identitas yang ditetapkan pengguna untuk digunakan

Server

Server Azure SQL Database.

Name Type Description
id
  • string

ID Sumber Daya.

identity

Identitas Azure Active Directory server.

kind
  • string

Jenis server sql. Ini adalah metadata yang digunakan untuk pengalaman portal Azure.

location
  • string

Lokasi sumber daya.

name
  • string

Nama sumber daya.

properties.administratorLogin
  • string

Nama pengguna administrator untuk server. Setelah dibuat, itu tidak dapat diubah.

properties.administratorLoginPassword
  • string

Kata sandi masuk administrator (diperlukan untuk pembuatan server).

properties.administrators

Administrator Azure Active Directory server.

properties.federatedClientId
  • string

Id Klien yang digunakan untuk skenario CMK lintas penyewa

properties.fullyQualifiedDomainName
  • string

Nama domain server yang sepenuhnya memenuhi syarat.

properties.keyId
  • string

URI CMK kunci yang digunakan untuk enkripsi.

properties.minimalTlsVersion
  • string

Versi TLS minimal. Nilai yang diizinkan: '1.0', '1.1', '1.2'

properties.primaryUserAssignedIdentityId
  • string

Id sumber daya identitas yang ditetapkan pengguna yang akan digunakan secara default.

properties.privateEndpointConnections

Daftar koneksi titik akhir privat di server

properties.publicNetworkAccess

Apakah akses titik akhir publik diizinkan atau tidak untuk server ini. Nilai bersifat opsional tetapi jika diteruskan, harus 'Diaktifkan' atau 'Dinonaktifkan'

properties.restrictOutboundNetworkAccess

Apakah akan membatasi akses jaringan keluar untuk server ini atau tidak. Nilai bersifat opsional tetapi jika diteruskan, harus 'Diaktifkan' atau 'Dinonaktifkan'

properties.state
  • string

Status server.

properties.version
  • string

Versi server.

properties.workspaceFeature

Apakah server yang ada memiliki ruang kerja yang dibuat atau tidak dan apakah memungkinkan koneksi dari ruang kerja

tags
  • object

Tag sumber daya.

type
  • string

Jenis sumber daya

ServerExternalAdministrator

Properti administrator direktori aktif.

Name Type Description
administratorType

Jenis administrator sever.

azureADOnlyAuthentication
  • boolean

Azure Active Directory hanya Autentikasi yang diaktifkan.

login
  • string

Nama masuk administrator server.

principalType

Jenis Utama administrator sever.

sid
  • string

SID (ID objek) administrator server.

tenantId
  • string

ID penyewa administrator.

ServerNetworkAccessFlag

Apakah akses titik akhir publik diizinkan atau tidak untuk server ini. Nilai bersifat opsional tetapi jika diteruskan, harus 'Diaktifkan' atau 'Dinonaktifkan'

Name Type Description
Disabled
  • string
Enabled
  • string

ServerPrivateEndpointConnection

Koneksi titik akhir privat di bawah server

Name Type Description
id
  • string

ID Sumber Daya.

properties

Properti koneksi titik akhir privat

ServerUpdate

Permintaan pembaruan untuk server Azure SQL Database.

Name Type Description
identity

Identitas server

properties.administratorLogin
  • string

Nama pengguna administrator untuk server. Setelah dibuat, itu tidak dapat diubah.

properties.administratorLoginPassword
  • string

Kata sandi masuk administrator (diperlukan untuk pembuatan server).

properties.administrators

Administrator Azure Active Directory server.

properties.federatedClientId
  • string

Id Klien yang digunakan untuk skenario CMK lintas penyewa

properties.fullyQualifiedDomainName
  • string

Nama domain server yang sepenuhnya memenuhi syarat.

properties.keyId
  • string

URI CMK kunci yang digunakan untuk enkripsi.

properties.minimalTlsVersion
  • string

Versi TLS minimal. Nilai yang diizinkan: '1.0', '1.1', '1.2'

properties.primaryUserAssignedIdentityId
  • string

Id sumber daya identitas yang ditetapkan pengguna yang akan digunakan secara default.

properties.privateEndpointConnections

Daftar koneksi titik akhir privat di server

properties.publicNetworkAccess

Apakah akses titik akhir publik diizinkan atau tidak untuk server ini. Nilai bersifat opsional tetapi jika diteruskan, harus 'Diaktifkan' atau 'Dinonaktifkan'

properties.restrictOutboundNetworkAccess

Apakah akan membatasi akses jaringan keluar untuk server ini atau tidak. Nilai bersifat opsional tetapi jika diteruskan, harus 'Diaktifkan' atau 'Dinonaktifkan'

properties.state
  • string

Status server.

properties.version
  • string

Versi server.

properties.workspaceFeature

Apakah server yang ada memiliki ruang kerja yang dibuat atau tidak dan apakah memungkinkan koneksi dari ruang kerja

tags
  • object

Tag sumber daya.

ServerWorkspaceFeature

Apakah server yang ada memiliki ruang kerja yang dibuat atau tidak dan apakah memungkinkan koneksi dari ruang kerja

Name Type Description
Connected
  • string
Disconnected
  • string

UserIdentity

Azure Active Directory konfigurasi identitas untuk sumber daya.

Name Type Description
clientId
  • string

Id klien Azure Active Directory.

principalId
  • string

Id utama Azure Active Directory.