Servers - Get

Bir sunucu alır.

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

URI Parametreleri

Name İçinde Gerekli Tür Description
resourceGroupName
path True

string

Kaynağı içeren kaynak grubunun adı. Bu değeri Azure Resource Manager API'sinden veya portaldan alabilirsiniz.

serverName
path True

string

Sunucunun adı.

subscriptionId
path True

string

Azure aboneliğini tanımlayan abonelik kimliği.

api-version
query True

string

İstek için kullanılacak API sürümü.

$expand
query

string

Yanıta eklenecek alt kaynaklar.

Yanıtlar

Name Tür Description
200 OK

Server

Belirtilen sunucu başarıyla alındı.

Other Status Codes

Hata Yanıtları: ***

  • 404 SubscriptionNotFound - İstenen abonelik bulunamadı.

  • 404 ResourceNotFound - İstenen kaynak bulunamadı.

Örnekler

Get server
Get server with $expand=administrators/activedirectory

Get server

Sample Request

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

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

Sample Request

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

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

Tanımlar

Name Description
AdministratorType

Sunucu yöneticisinin türü.

IdentityType

Kimlik türü. Kaynak için otomatik olarak bir Azure Active Directory sorumlusu oluşturmak ve atamak için bunu 'SystemAssigned' olarak ayarlayın.

PrincipalType

Sunucu yöneticisinin Asıl Türü.

PrivateEndpointConnectionProperties

Özel uç nokta bağlantısının özellikleri.

PrivateEndpointProperty
PrivateEndpointProvisioningState

Özel uç nokta bağlantısının durumu.

PrivateLinkServiceConnectionStateActionsRequire

Özel bağlantı hizmeti bağlantısı için gereken eylemler.

PrivateLinkServiceConnectionStateProperty
PrivateLinkServiceConnectionStateStatus

Özel bağlantı hizmeti bağlantı durumu.

ResourceIdentity

Bir kaynak için Azure Active Directory kimlik yapılandırması.

Server

Azure SQL Veritabanı sunucusu.

ServerExternalAdministrator

Active Directory yöneticisinin özellikleri.

ServerNetworkAccessFlag

Bu sunucu için genel uç nokta erişimine izin verilip verilmeyeceği. Değer isteğe bağlıdır, ancak geçirilirse 'Etkin' veya 'Devre Dışı' olmalıdır

ServerPrivateEndpointConnection

Sunucu altında özel uç nokta bağlantısı

ServerWorkspaceFeature

Var olan sunucunun oluşturulmuş bir çalışma alanı olup olmadığı ve çalışma alanından bağlantıya izin verip vermediği

UserIdentity

Bir kaynak için Azure Active Directory kimlik yapılandırması.

AdministratorType

Sunucu yöneticisinin türü.

Name Tür Description
ActiveDirectory

string

IdentityType

Kimlik türü. Kaynak için otomatik olarak bir Azure Active Directory sorumlusu oluşturmak ve atamak için bunu 'SystemAssigned' olarak ayarlayın.

Name Tür Description
None

string

SystemAssigned

string

SystemAssigned,UserAssigned

string

UserAssigned

string

PrincipalType

Sunucu yöneticisinin Asıl Türü.

Name Tür Description
Application

string

Group

string

User

string

PrivateEndpointConnectionProperties

Özel uç nokta bağlantısının özellikleri.

Name Tür Description
groupIds

string[]

Grup kimlikleri.

privateEndpoint

PrivateEndpointProperty

Bağlantının ait olduğu özel uç nokta.

privateLinkServiceConnectionState

PrivateLinkServiceConnectionStateProperty

Özel uç nokta bağlantısının bağlantı durumu.

provisioningState

PrivateEndpointProvisioningState

Özel uç nokta bağlantısının durumu.

PrivateEndpointProperty

Name Tür Description
id

string

Özel uç noktanın kaynak kimliği.

PrivateEndpointProvisioningState

Özel uç nokta bağlantısının durumu.

Name Tür Description
Approving

string

Dropping

string

Failed

string

Ready

string

Rejecting

string

PrivateLinkServiceConnectionStateActionsRequire

Özel bağlantı hizmeti bağlantısı için gereken eylemler.

Name Tür Description
None

string

PrivateLinkServiceConnectionStateProperty

Name Tür Description
actionsRequired

PrivateLinkServiceConnectionStateActionsRequire

Özel bağlantı hizmeti bağlantısı için gereken eylemler.

description

string

Özel bağlantı hizmeti bağlantı açıklaması.

status

PrivateLinkServiceConnectionStateStatus

Özel bağlantı hizmeti bağlantı durumu.

PrivateLinkServiceConnectionStateStatus

Özel bağlantı hizmeti bağlantı durumu.

Name Tür Description
Approved

string

Disconnected

string

Pending

string

Rejected

string

ResourceIdentity

Bir kaynak için Azure Active Directory kimlik yapılandırması.

Name Tür Description
principalId

string

Azure Active Directory asıl kimliği.

tenantId

string

Azure Active Directory kiracı kimliği.

type

IdentityType

Kimlik türü. Kaynak için otomatik olarak bir Azure Active Directory sorumlusu oluşturmak ve atamak için bunu 'SystemAssigned' olarak ayarlayın.

userAssignedIdentities

<string,  UserIdentity>

Kullanılacak kullanıcı tarafından atanan kimliklerin kaynak kimlikleri

Server

Azure SQL Veritabanı sunucusu.

Name Tür Description
id

string

Kaynak Kimliği.

identity

ResourceIdentity

Sunucunun Azure Active Directory kimliği.

kind

string

Sql Server türü. Bu, Azure portal deneyimi için kullanılan meta verilerdir.

location

string

Kaynak konumu.

name

string

Kaynak adı.

properties.administratorLogin

string

Sunucu için yönetici kullanıcı adı. Oluşturulduktan sonra değiştirilemez.

properties.administratorLoginPassword

string

Yönetici oturum açma parolası (sunucu oluşturmak için gereklidir).

properties.administrators

ServerExternalAdministrator

Sunucunun Azure Active Directory yöneticisi.

properties.federatedClientId

string

Kiracılar arası CMK senaryosu için kullanılan İstemci kimliği

properties.fullyQualifiedDomainName

string

Sunucunun tam etki alanı adı.

properties.keyId

string

Şifreleme için kullanılacak anahtarın CMK URI'si.

properties.minimalTlsVersion

string

En düşük TLS sürümü. İzin verilen değerler: '1.0', '1.1', '1.2'

properties.primaryUserAssignedIdentityId

string

Varsayılan olarak kullanılacak kullanıcı tarafından atanan kimliğin kaynak kimliği.

properties.privateEndpointConnections

ServerPrivateEndpointConnection[]

Sunucudaki özel uç nokta bağlantılarının listesi

properties.publicNetworkAccess

ServerNetworkAccessFlag

Bu sunucu için genel uç nokta erişimine izin verilip verilmeyeceği. Değer isteğe bağlıdır, ancak geçirilirse 'Etkin' veya 'Devre Dışı' olmalıdır

properties.restrictOutboundNetworkAccess

ServerNetworkAccessFlag

Bu sunucu için giden ağ erişiminin kısıtlanıp kısıtlanmayacağını. Değer isteğe bağlıdır, ancak geçirilirse 'Etkin' veya 'Devre Dışı' olmalıdır

properties.state

string

Sunucunun durumu.

properties.version

string

Sunucunun sürümü.

properties.workspaceFeature

ServerWorkspaceFeature

Var olan sunucunun oluşturulmuş bir çalışma alanı olup olmadığı ve çalışma alanından bağlantıya izin verip vermediği

tags

object

Kaynak etiketleri.

type

string

Kaynak türü.

ServerExternalAdministrator

Active Directory yöneticisinin özellikleri.

Name Tür Description
administratorType

AdministratorType

Sunucu yöneticisinin türü.

azureADOnlyAuthentication

boolean

Yalnızca Azure Active Directory Kimlik Doğrulaması etkinleştirildi.

login

string

Sunucu yöneticisinin oturum açma adı.

principalType

PrincipalType

Sunucu yöneticisinin Asıl Türü.

sid

string

Sunucu yöneticisinin SID (nesne kimliği).

tenantId

string

Yöneticinin kiracı kimliği.

ServerNetworkAccessFlag

Bu sunucu için genel uç nokta erişimine izin verilip verilmeyeceği. Değer isteğe bağlıdır, ancak geçirilirse 'Etkin' veya 'Devre Dışı' olmalıdır

Name Tür Description
Disabled

string

Enabled

string

ServerPrivateEndpointConnection

Sunucu altında özel uç nokta bağlantısı

Name Tür Description
id

string

Kaynak Kimliği.

properties

PrivateEndpointConnectionProperties

Özel uç nokta bağlantı özellikleri

ServerWorkspaceFeature

Var olan sunucunun oluşturulmuş bir çalışma alanı olup olmadığı ve çalışma alanından bağlantıya izin verip vermediği

Name Tür Description
Connected

string

Disconnected

string

UserIdentity

Bir kaynak için Azure Active Directory kimlik yapılandırması.

Name Tür Description
clientId

string

Azure Active Directory istemci kimliği.

principalId

string

Azure Active Directory asıl kimliği.