Servers - List
Mendapatkan daftar semua server dalam langganan.
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Sql/servers?api-version=2025-01-01
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Sql/servers?api-version=2025-01-01&$expand={$expand}
Parameter URI
| Nama | Dalam | Diperlukan | Jenis | Deskripsi |
|---|---|---|---|---|
|
subscription
|
path | True |
string (uuid) |
ID langganan target. Nilainya harus sebuah UUID. |
|
api-version
|
query | True |
string minLength: 1 |
Versi API yang digunakan untuk operasi ini. |
|
$expand
|
query |
string |
Sumber daya anak untuk disertakan dalam respons. |
Respons
| Nama | Jenis | Deskripsi |
|---|---|---|
| 200 OK |
Operasi Azure berhasil diselesaikan. |
|
| Other Status Codes |
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
| List servers |
| List servers with $expand=administrators/activedirectory |
List servers
Permintaan sampel
Respon sampel
{
"value": [
{
"name": "sqlcrudtest-4645",
"type": "Microsoft.Sql/servers",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-4645",
"kind": "v12.0",
"location": "japaneast",
"properties": {
"administratorLogin": "dummylogin",
"externalGovernanceStatus": "Enabled",
"fullyQualifiedDomainName": "sqlcrudtest-4645.database.windows.net",
"isIPv6Enabled": "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": {
"privateEndpoint": {
"id": "/subscriptions/55555555-6666-7777-8888-999999999999/resourceGroups/Default-Network/providers/Microsoft.Network/privateEndpoints/private-endpoint-name"
},
"privateLinkServiceConnectionState": {
"description": "Auto-approved",
"actionsRequired": "None",
"status": "Approved"
},
"provisioningState": "Ready"
}
}
],
"publicNetworkAccess": "Enabled",
"restrictOutboundNetworkAccess": "Enabled",
"state": "Ready",
"version": "12.0",
"workspaceFeature": "Connected"
}
},
{
"name": "sqlcrudtest-6661",
"type": "Microsoft.Sql/servers",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-6661",
"kind": "v12.0",
"location": "japaneast",
"properties": {
"administratorLogin": "dummylogin",
"externalGovernanceStatus": "Enabled",
"fullyQualifiedDomainName": "sqlcrudtest-6661.database.windows.net",
"isIPv6Enabled": "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": {
"privateEndpoint": {
"id": "/subscriptions/55555555-6666-7777-8888-999999999999/resourceGroups/Default-Network/providers/Microsoft.Network/privateEndpoints/private-endpoint-name"
},
"privateLinkServiceConnectionState": {
"description": "Auto-approved",
"actionsRequired": "None",
"status": "Approved"
},
"provisioningState": "Ready"
}
}
],
"publicNetworkAccess": "Enabled",
"restrictOutboundNetworkAccess": "Enabled",
"state": "Ready",
"version": "12.0",
"workspaceFeature": "Connected"
}
}
]
}
List servers with $expand=administrators/activedirectory
Permintaan sampel
Respon sampel
{
"value": [
{
"name": "sqlcrudtest-4645",
"type": "Microsoft.Sql/servers",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-4645",
"kind": "v12.0",
"location": "japaneast",
"properties": {
"administratorLogin": "dummylogin",
"administrators": {
"azureADOnlyAuthentication": true,
"login": "bob@contoso.com",
"principalType": "User",
"sid": "00000011-1111-2222-2222-123456789111",
"tenantId": "00000011-1111-2222-2222-123456789111"
},
"externalGovernanceStatus": "Enabled",
"fullyQualifiedDomainName": "sqlcrudtest-4645.database.windows.net",
"isIPv6Enabled": "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": {
"privateEndpoint": {
"id": "/subscriptions/55555555-6666-7777-8888-999999999999/resourceGroups/Default-Network/providers/Microsoft.Network/privateEndpoints/private-endpoint-name"
},
"privateLinkServiceConnectionState": {
"description": "Auto-approved",
"actionsRequired": "None",
"status": "Approved"
},
"provisioningState": "Ready"
}
}
],
"publicNetworkAccess": "Enabled",
"restrictOutboundNetworkAccess": "Enabled",
"retentionDays": 7,
"state": "Ready",
"version": "12.0",
"workspaceFeature": "Connected"
}
},
{
"name": "sqlcrudtest-6661",
"type": "Microsoft.Sql/servers",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-6661",
"kind": "v12.0",
"location": "japaneast",
"properties": {
"administratorLogin": "dummylogin",
"administrators": {
"azureADOnlyAuthentication": true,
"login": "bob@contoso.com",
"principalType": "User",
"sid": "00000011-1111-2222-2222-123456789111",
"tenantId": "00000011-1111-2222-2222-123456789111"
},
"externalGovernanceStatus": "Enabled",
"fullyQualifiedDomainName": "sqlcrudtest-6661.database.windows.net",
"isIPv6Enabled": "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": {
"privateEndpoint": {
"id": "/subscriptions/55555555-6666-7777-8888-999999999999/resourceGroups/Default-Network/providers/Microsoft.Network/privateEndpoints/private-endpoint-name"
},
"privateLinkServiceConnectionState": {
"description": "Auto-approved",
"actionsRequired": "None",
"status": "Approved"
},
"provisioningState": "Ready"
}
}
],
"publicNetworkAccess": "Enabled",
"restrictOutboundNetworkAccess": "Enabled",
"retentionDays": 7,
"state": "Ready",
"version": "12.0",
"workspaceFeature": "Connected"
}
}
]
}
Definisi
| Nama | Deskripsi |
|---|---|
|
Administrator |
Jenis administrator sever. |
|
created |
Jenis identitas yang membuat sumber daya. |
|
Error |
Info tambahan kesalahan manajemen sumber daya. |
|
Error |
Detail kesalahan. |
|
Error |
Tanggapan kesalahan |
|
External |
Status tata kelola eksternal. |
|
Identity |
Jenis identitas. Atur ini ke 'SystemAssigned' untuk secara otomatis membuat dan menetapkan perwakilan Azure Active Directory untuk sumber daya. |
|
Minimal |
Versi TLS minimal. Nilai yang diizinkan: 'None', 1.0', '1.1', '1.2', '1.3' |
|
Principal |
Jenis Utama administrator sever. |
|
Private |
Properti koneksi titik akhir privat. |
|
Private |
|
|
Private |
Status koneksi titik akhir privat. |
|
Private |
Tindakan yang diperlukan untuk koneksi layanan tautan privat. |
|
Private |
|
|
Private |
Status koneksi layanan tautan privat. |
|
Resource |
Konfigurasi identitas Azure Active Directory untuk sumber daya. |
| Server |
Server Azure SQL Database. |
|
Server |
Buat mode untuk server, hanya nilai yang valid untuk ini adalah Normal dan Pulihkan. |
|
Server |
Properti administrator direktori aktif. |
|
Server |
Respons operasi daftar Server. |
|
Server |
Apakah membatasi akses jaringan keluar untuk server ini atau tidak. Nilai bersifat opsional tetapi jika diteruskan, harus 'Diaktifkan' atau 'Dinonaktifkan' |
|
Server |
Koneksi titik akhir privat di bawah server |
|
Server |
Apakah akses titik akhir publik diizinkan atau tidak untuk server ini. Nilai bersifat opsional tetapi jika diteruskan, harus 'Diaktifkan' atau 'Dinonaktifkan' atau 'SecuredByPerimeter' |
|
Server |
Apakah server yang ada dibuat atau tidak memiliki ruang kerja dan apakah memungkinkan koneksi dari ruang kerja |
|
system |
Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya. |
|
User |
Konfigurasi identitas Azure Active Directory untuk sumber daya. |
AdministratorType
Jenis administrator sever.
| Nilai | Deskripsi |
|---|---|
| ActiveDirectory |
Direktori Aktif |
createdByType
Jenis identitas yang membuat sumber daya.
| Nilai | Deskripsi |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
ErrorAdditionalInfo
Info tambahan kesalahan manajemen sumber daya.
| Nama | Jenis | Deskripsi |
|---|---|---|
| info |
object |
Info tambahan. |
| type |
string |
Jenis info tambahan. |
ErrorDetail
Detail kesalahan.
| Nama | Jenis | Deskripsi |
|---|---|---|
| additionalInfo |
Info tambahan kesalahan. |
|
| code |
string |
Kode kesalahan. |
| details |
Rincian kesalahan. |
|
| message |
string |
Pesan kesalahan. |
| target |
string |
Sasaran kesalahan. |
ErrorResponse
Tanggapan kesalahan
| Nama | Jenis | Deskripsi |
|---|---|---|
| error |
Objek kesalahan. |
ExternalGovernanceStatus
Status tata kelola eksternal.
| Nilai | Deskripsi |
|---|---|
| Enabled |
Enabled |
| Disabled |
Nonaktif |
IdentityType
Jenis identitas. Atur ini ke 'SystemAssigned' untuk secara otomatis membuat dan menetapkan perwakilan Azure Active Directory untuk sumber daya.
| Nilai | Deskripsi |
|---|---|
| None |
Tidak |
| SystemAssigned |
DitugaskanSistem |
| UserAssigned |
UserAssigned |
| SystemAssigned,UserAssigned |
SistemTugas,Pengguna Ditetapkan |
MinimalTlsVersion
Versi TLS minimal. Nilai yang diizinkan: 'None', 1.0', '1.1', '1.2', '1.3'
| Nilai | Deskripsi |
|---|---|
| None |
Tidak |
| 1.0 |
1.0 |
| 1.1 |
1.1 |
| 1.2 |
1.2 |
| 1.3 |
1.3 |
PrincipalType
Jenis Utama administrator sever.
| Nilai | Deskripsi |
|---|---|
| User |
Pengguna |
| Group |
Kelompok |
| Application |
Application |
PrivateEndpointConnectionProperties
Properti koneksi titik akhir privat.
| Nama | Jenis | Deskripsi |
|---|---|---|
| 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
| Nama | Jenis | Deskripsi |
|---|---|---|
| id |
string |
Id sumber daya titik akhir privat. |
PrivateEndpointProvisioningState
Status koneksi titik akhir privat.
| Nilai | Deskripsi |
|---|---|
| Approving |
Menyetujui |
| Ready |
Siap |
| Dropping |
Menjatuhkan |
| Failed |
Kegagalan |
| Rejecting |
Menolak |
PrivateLinkServiceConnectionStateActionsRequire
Tindakan yang diperlukan untuk koneksi layanan tautan privat.
| Nilai | Deskripsi |
|---|---|
| None |
Tidak |
PrivateLinkServiceConnectionStateProperty
| Nama | Jenis | Deskripsi |
|---|---|---|
| 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.
| Nilai | Deskripsi |
|---|---|
| Approved |
Disetujui |
| Pending |
Menunggu |
| Rejected |
Ditolak |
| Disconnected |
Terputus |
ResourceIdentity
Konfigurasi identitas Azure Active Directory untuk sumber daya.
| Nama | Jenis | Deskripsi |
|---|---|---|
| principalId |
string (uuid) |
ID perwakilan Azure Active Directory. |
| tenantId |
string (uuid) |
ID penyewa Azure Active Directory. |
| type |
Jenis identitas. Atur ini ke 'SystemAssigned' untuk secara otomatis membuat dan menetapkan perwakilan Azure Active Directory untuk sumber daya. |
|
| userAssignedIdentities |
<string,
User |
Id sumber daya dari identitas yang ditetapkan pengguna untuk digunakan |
Server
Server 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}" |
| identity |
Identitas Azure Active Directory server. |
|
| kind |
string |
Jenis server sql. Ini adalah metadata yang digunakan untuk pengalaman portal Azure. |
| location |
string |
Lokasi geografis tempat sumber daya berada |
| name |
string |
Nama sumber daya |
| properties.administratorLogin |
string |
Nama pengguna administrator untuk server. Setelah dibuat, itu tidak dapat diubah. |
| properties.administratorLoginPassword |
string (password) |
Kata sandi masuk administrator (diperlukan untuk pembuatan server). |
| properties.administrators |
Administrator Azure Active Directory dapat digunakan selama pembuatan server dan untuk pembaruan server, kecuali untuk properti azureADOnlyAuthentication. Untuk memperbarui properti azureADOnlyAuthentication, API individual harus digunakan. |
|
| properties.createMode |
Buat mode untuk server, hanya nilai yang valid untuk ini adalah Normal dan Pulihkan. |
|
| properties.externalGovernanceStatus |
Status tata kelola eksternal. |
|
| properties.federatedClientId |
string (uuid) |
Id Klien yang digunakan untuk skenario CMK lintas penyewa |
| properties.fullyQualifiedDomainName |
string |
Nama domain server yang sepenuhnya memenuhi syarat. |
| properties.isIPv6Enabled |
Apakah mengaktifkan dukungan IPv6 untuk server ini atau tidak. Nilai bersifat opsional tetapi jika diteruskan, harus 'Diaktifkan' atau 'Dinonaktifkan' |
|
| properties.keyId |
string |
URI CMK kunci yang akan digunakan untuk enkripsi. |
| properties.minimalTlsVersion |
Versi TLS minimal. Nilai yang diizinkan: 'None', 1.0', '1.1', '1.2', '1.3' |
|
| 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' atau 'SecuredByPerimeter' |
|
| properties.restrictOutboundNetworkAccess |
Apakah membatasi akses jaringan keluar untuk server ini atau tidak. Nilai bersifat opsional tetapi jika diteruskan, harus 'Diaktifkan' atau 'Dinonaktifkan' |
|
| properties.retentionDays |
integer (int32) |
Jumlah hari server ini akan tetap dihapus sementara. |
| properties.state |
string |
Status server. |
| properties.version |
string |
Versi server. |
| properties.workspaceFeature |
Apakah server yang ada dibuat atau tidak memiliki ruang kerja dan apakah memungkinkan koneksi dari ruang kerja |
|
| systemData |
Metadata Azure Resource Manager yang berisi informasi createdBy dan modifiedBy. |
|
| tags |
object |
Tag sumber daya. |
| type |
string |
Jenis sumber daya. Misalnya "Microsoft. Komputasi/virtualMachines" atau "Microsoft. Akun penyimpanan/penyimpanan" |
ServerCreateMode
Buat mode untuk server, hanya nilai yang valid untuk ini adalah Normal dan Pulihkan.
| Nilai | Deskripsi |
|---|---|
| Normal |
Biasa |
| Restore |
Restore |
ServerExternalAdministrator
Properti administrator direktori aktif.
| Nama | Jenis | Deskripsi |
|---|---|---|
| administratorType |
Jenis administrator sever. |
|
| azureADOnlyAuthentication |
boolean |
Hanya Azure Active Directory Autentikasi diaktifkan. |
| login |
string |
Nama masuk administrator server. |
| principalType |
Jenis Utama administrator sever. |
|
| sid |
string (uuid) |
SID (ID objek) administrator server. |
| tenantId |
string (uuid) |
ID penyewa administrator. |
ServerListResult
Respons operasi daftar Server.
| Nama | Jenis | Deskripsi |
|---|---|---|
| nextLink |
string (uri) |
Tautan ke halaman item berikutnya |
| value |
Server[] |
Item Server di halaman ini |
ServerNetworkAccessFlag
Apakah membatasi akses jaringan keluar untuk server ini atau tidak. Nilai bersifat opsional tetapi jika diteruskan, harus 'Diaktifkan' atau 'Dinonaktifkan'
| Nilai | Deskripsi |
|---|---|
| Enabled |
Enabled |
| Disabled |
Nonaktif |
ServerPrivateEndpointConnection
Koneksi titik akhir privat di bawah server
| Nama | Jenis | Deskripsi |
|---|---|---|
| id |
string |
ID Sumber Daya. |
| properties |
Properti koneksi titik akhir privat |
ServerPublicNetworkAccessFlag
Apakah akses titik akhir publik diizinkan atau tidak untuk server ini. Nilai bersifat opsional tetapi jika diteruskan, harus 'Diaktifkan' atau 'Dinonaktifkan' atau 'SecuredByPerimeter'
| Nilai | Deskripsi |
|---|---|
| Enabled |
Enabled |
| Disabled |
Nonaktif |
| SecuredByPerimeter |
Diamankan olehPerimeter |
ServerWorkspaceFeature
Apakah server yang ada dibuat atau tidak memiliki ruang kerja dan apakah memungkinkan koneksi dari ruang kerja
| Nilai | Deskripsi |
|---|---|
| Connected |
Tersambung |
| Disconnected |
Terputus |
systemData
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 |
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 |
Jenis identitas yang terakhir memodifikasi sumber daya. |
UserIdentity
Konfigurasi identitas Azure Active Directory untuk sumber daya.
| Nama | Jenis | Deskripsi |
|---|---|---|
| clientId |
string (uuid) |
ID klien Azure Active Directory. |
| principalId |
string (uuid) |
ID perwakilan Azure Active Directory. |