Servers - Update

Service:

SQL Database

API Version:

2021-11-01

Updates server.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
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

Nama	Jenis	Deskripsi
identity	ResourceIdentity	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	ServerExternalAdministrator	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	ServerNetworkAccessFlag	Apakah akses titik akhir publik diizinkan atau tidak untuk server ini. Nilai bersifat opsional tetapi jika diteruskan, harus 'Diaktifkan' atau 'Dinonaktifkan'
properties.restrictOutboundNetworkAccess	ServerNetworkAccessFlag	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

Nama	Jenis	Deskripsi
200 OK	Server	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 Only Authentication 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. 400 ExternalAdministratorLoginSameAsSqlAdmin - Nama administrator Azure Active Directory dan akun admin server harus berbeda. Harap berikan nilai yang berbeda. 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 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. 503 TooManyRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia.

Contoh

Update a server

Sample Request

HTTP

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

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

Java

import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.models.ServerNetworkAccessFlag;
import com.azure.resourcemanager.sql.models.ServerUpdate;

/** Samples for Servers Update. */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ServerUpdate.json
     */
    /**
     * Sample code: Update a server.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updateAServer(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getServers().update("sqlcrudtest-7398", "sqlcrudtest-4645",
            new ServerUpdate().withAdministratorLogin("dummylogin")
                .withAdministratorLoginPassword("fakeTokenPlaceholder")
                .withPublicNetworkAccess(ServerNetworkAccessFlag.DISABLED)
                .withRestrictOutboundNetworkAccess(ServerNetworkAccessFlag.ENABLED),
            Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:

200

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

Status code:

202

Definisi

Nama	Deskripsi
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	Konfigurasi identitas Azure Active Directory untuk sumber daya.
Server	Server database Azure SQL.
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 database Azure SQL.
ServerWorkspaceFeature	Apakah server yang ada memiliki ruang kerja yang dibuat atau tidak dan apakah memungkinkan koneksi dari ruang kerja
UserIdentity	Konfigurasi identitas Azure Active Directory untuk sumber daya.

AdministratorType

Jenis administrator sever.

Nama	Jenis	Deskripsi
ActiveDirectory	string

IdentityType

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

Nama	Jenis	Deskripsi
None	string
SystemAssigned	string
SystemAssigned,UserAssigned	string
UserAssigned	string

PrincipalType

Jenis Utama administrator sever.

Nama	Jenis	Deskripsi
Application	string
Group	string
User	string

PrivateEndpointConnectionProperties

Properti koneksi titik akhir privat.

Nama	Jenis	Deskripsi
groupIds	string[]	ID grup.
privateEndpoint	PrivateEndpointProperty	Titik akhir privat tempat koneksi berada.
privateLinkServiceConnectionState	PrivateLinkServiceConnectionStateProperty	Status koneksi koneksi titik akhir privat.
provisioningState	PrivateEndpointProvisioningState	Status koneksi titik akhir privat.

PrivateEndpointProperty

Nama	Jenis	Deskripsi
id	string	Id sumber daya titik akhir privat.

PrivateEndpointProvisioningState

Status koneksi titik akhir privat.

Nama	Jenis	Deskripsi
Approving	string
Dropping	string
Failed	string
Ready	string
Rejecting	string

PrivateLinkServiceConnectionStateActionsRequire

Tindakan yang diperlukan untuk koneksi layanan tautan privat.

Nama	Jenis	Deskripsi
None	string

PrivateLinkServiceConnectionStateProperty

Nama	Jenis	Deskripsi
actionsRequired	PrivateLinkServiceConnectionStateActionsRequire	Tindakan yang diperlukan untuk koneksi layanan tautan privat.
description	string	Deskripsi koneksi layanan tautan privat.
status	PrivateLinkServiceConnectionStateStatus	Status koneksi layanan tautan privat.

PrivateLinkServiceConnectionStateStatus

Status koneksi layanan tautan privat.

Nama	Jenis	Deskripsi
Approved	string
Disconnected	string
Pending	string
Rejected	string

ResourceIdentity

Konfigurasi identitas Azure Active Directory untuk sumber daya.

Nama	Jenis	Deskripsi
principalId	string	Id utama Azure Active Directory.
tenantId	string	Id penyewa Azure Active Directory.
type	IdentityType	Jenis identitas. Atur ini ke 'SystemAssigned' untuk membuat dan menetapkan prinsipal Azure Active Directory secara otomatis untuk sumber daya.
userAssignedIdentities	<string,  UserIdentity>	Id sumber daya dari identitas yang ditetapkan pengguna untuk digunakan

Server

Server database Azure SQL.

Nama	Jenis	Deskripsi
id	string	ID Sumber Daya.
identity	ResourceIdentity	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	ServerExternalAdministrator	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	ServerPrivateEndpointConnection[]	Daftar koneksi titik akhir privat di server
properties.publicNetworkAccess	ServerNetworkAccessFlag	Apakah akses titik akhir publik diizinkan atau tidak untuk server ini. Nilai bersifat opsional tetapi jika diteruskan, harus 'Diaktifkan' atau 'Dinonaktifkan'
properties.restrictOutboundNetworkAccess	ServerNetworkAccessFlag	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	ServerWorkspaceFeature	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.

Nama	Jenis	Deskripsi
administratorType	AdministratorType	Jenis administrator sever.
azureADOnlyAuthentication	boolean	Azure Active Directory hanya Autentikasi yang diaktifkan.
login	string	Nama masuk administrator server.
principalType	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'

Nama	Jenis	Deskripsi
Disabled	string
Enabled	string

ServerPrivateEndpointConnection

Koneksi titik akhir privat di bawah server

Nama	Jenis	Deskripsi
id	string	ID Sumber Daya.
properties	PrivateEndpointConnectionProperties	Properti koneksi titik akhir privat

ServerUpdate

Permintaan pembaruan untuk server database Azure SQL.

Nama	Jenis	Deskripsi
identity	ResourceIdentity	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	ServerExternalAdministrator	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	ServerPrivateEndpointConnection[]	Daftar koneksi titik akhir privat di server
properties.publicNetworkAccess	ServerNetworkAccessFlag	Apakah akses titik akhir publik diizinkan atau tidak untuk server ini. Nilai bersifat opsional tetapi jika diteruskan, harus 'Diaktifkan' atau 'Dinonaktifkan'
properties.restrictOutboundNetworkAccess	ServerNetworkAccessFlag	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	ServerWorkspaceFeature	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

Nama	Jenis	Deskripsi
Connected	string
Disconnected	string

UserIdentity

Konfigurasi identitas Azure Active Directory untuk sumber daya.

Nama	Jenis	Deskripsi
clientId	string	Id klien Azure Active Directory.
principalId	string	Id utama Azure Active Directory.