Servers - Get

Başvuru

Hizmet:: SQL Database

API Sürümü:: 2021-11-01

Bir sunucu alır.

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

İsteğe bağlı parametrelerle:

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ı.

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

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


/**
 * Samples for Servers GetByResourceGroup.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ServerGet.json
     */
    /**
     * Sample code: Get server.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getServer(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getServers().getByResourceGroupWithResponse("sqlcrudtest-7398",
            "sqlcrudtest-4645", null, com.azure.core.util.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

Örnek yanıt

Durum kodu:: 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",
    "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

Örnek isteği

HTTP
Java

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


/**
 * Samples for Servers GetByResourceGroup.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ServerGetWithExpandEqualsAdministrators.json
     */
    /**
     * Sample code: Get server with $expand=administrators/activedirectory.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        getServerWithExpandAdministratorsActivedirectory(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getServers().getByResourceGroupWithResponse("sqlcrudtest-7398",
            "sqlcrudtest-4645", null, com.azure.core.util.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

Örnek yanıt

Durum kodu:: 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",
    "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.

Aracılığıyla paylaş

Servers - Get

URI Parametreleri

Yanıtlar

Örnekler

Get server

Örnek isteği

Örnek yanıt

Get server with $expand=administrators/activedirectory

Örnek isteği

Örnek yanıt

Tanımlar

AdministratorType

IdentityType

PrincipalType

PrivateEndpointConnectionProperties

PrivateEndpointProperty

PrivateEndpointProvisioningState

PrivateLinkServiceConnectionStateActionsRequire

PrivateLinkServiceConnectionStateProperty

PrivateLinkServiceConnectionStateStatus

ResourceIdentity

Server

ServerExternalAdministrator

ServerNetworkAccessFlag

ServerPrivateEndpointConnection

ServerWorkspaceFeature

UserIdentity

Ek kaynaklar