Bagikan melalui


Servers - Get

Mendapatkan server.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}?api-version=2021-11-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}?$expand={$expand}&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.

$expand
query

string

Sumber daya anak untuk disertakan dalam respons.

Respons

Nama Jenis Deskripsi
200 OK

Server

Berhasil mengambil server yang ditentukan.

Other Status Codes

Respons Kesalahan: ***

  • 404 SubscriptionNotFound - Langganan yang diminta tidak ditemukan.

  • 404 ResourceNotFound - Sumber daya yang diminta tidak ditemukan.

Contoh

Get server
Get server with $expand=administrators/activedirectory

Get server

Permintaan sampel

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

Respon sampel

{
  "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",
    "workspaceFeature": "Connected",
    "publicNetworkAccess": "Enabled",
    "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"
          }
        }
      }
    ]
  }
}

Get server with $expand=administrators/activedirectory

Permintaan sampel

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

Respon sampel

{
  "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",
    "workspaceFeature": "Connected",
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Enabled",
    "administrators": {
      "principalType": "User",
      "login": "bob@contoso.com",
      "sid": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111",
      "azureADOnlyAuthentication": true
    },
    "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

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

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

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.