Servers - List

Hizmet:: SQL Database

API Sürümü:: 2023-08-01

Abonelikteki tüm sunucuların listesini alır.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Sql/servers?api-version=2023-08-01

İsteğe bağlı parametrelerle:

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Sql/servers?$expand={$expand}&api-version=2023-08-01

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
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	ServerListResult	Sunucu listesi başarıyla alındı.
Other Status Codes	ErrorResponse	Hata Yanıtları: *** 404 SubscriptionNotFound - İstenen abonelik bulunamadı. 429 SubscriptionTooManyRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum isteğin ötesindeki istekler. 503 TooManyRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum isteğin ötesindeki istekler.

Name

Tür

Description

200 OK

ServerListResult

Sunucu listesi başarıyla alındı.

Other Status Codes

ErrorResponse

Hata Yanıtları: ***

404 SubscriptionNotFound - İstenen abonelik bulunamadı.
429 SubscriptionTooManyRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum isteğin ötesindeki istekler.
503 TooManyRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum isteğin ötesindeki istekler.

Örnekler

List servers

List servers with $expand=administrators/activedirectory

List servers

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/servers?api-version=2023-08-01

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Resources;
using Azure.ResourceManager.Resources.Models;
using Azure.ResourceManager.Sql.Models;
using Azure.ResourceManager.Sql;

// Generated from example definition: specification/sql/resource-manager/Microsoft.Sql/stable/2023-08-01/examples/ServerList.json
// this example is just showing the usage of "Servers_List" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this SubscriptionResource created on azure
// for more information of creating SubscriptionResource, please refer to the document of SubscriptionResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
ResourceIdentifier subscriptionResourceId = SubscriptionResource.CreateResourceIdentifier(subscriptionId);
SubscriptionResource subscriptionResource = client.GetSubscriptionResource(subscriptionResourceId);

// invoke the operation and iterate over the result
await foreach (SqlServerResource item in subscriptionResource.GetSqlServersAsync())
{
    // the variable item is a resource, you could call other operations on this instance as well
    // but just for demo, we get its data from this resource instance
    SqlServerData resourceData = item.Data;
    // for demo we just print out the id
    Console.WriteLine($"Succeeded on id: {resourceData.Id}");
}

Console.WriteLine("Succeeded");

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

{
  "value": [
    {
      "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"
              }
            }
          }
        ]
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-6661",
      "name": "sqlcrudtest-6661",
      "type": "Microsoft.Sql/servers",
      "location": "japaneast",
      "kind": "v12.0",
      "properties": {
        "fullyQualifiedDomainName": "sqlcrudtest-6661.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"
              }
            }
          }
        ]
      }
    }
  ]
}

List servers with $expand=administrators/activedirectory

Örnek isteği

HTTP
dotnet

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/servers?api-version=2023-08-01

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Resources;
using Azure.ResourceManager.Resources.Models;
using Azure.ResourceManager.Sql.Models;
using Azure.ResourceManager.Sql;

// Generated from example definition: specification/sql/resource-manager/Microsoft.Sql/stable/2023-08-01/examples/ServerListWithExpandEqualsAdministrators.json
// this example is just showing the usage of "Servers_List" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this SubscriptionResource created on azure
// for more information of creating SubscriptionResource, please refer to the document of SubscriptionResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
ResourceIdentifier subscriptionResourceId = SubscriptionResource.CreateResourceIdentifier(subscriptionId);
SubscriptionResource subscriptionResource = client.GetSubscriptionResource(subscriptionResourceId);

// invoke the operation and iterate over the result
await foreach (SqlServerResource item in subscriptionResource.GetSqlServersAsync())
{
    // the variable item is a resource, you could call other operations on this instance as well
    // but just for demo, we get its data from this resource instance
    SqlServerData resourceData = item.Data;
    // for demo we just print out the id
    Console.WriteLine($"Succeeded on id: {resourceData.Id}");
}

Console.WriteLine("Succeeded");

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

{
  "value": [
    {
      "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"
              }
            }
          }
        ]
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-6661",
      "name": "sqlcrudtest-6661",
      "type": "Microsoft.Sql/servers",
      "location": "japaneast",
      "kind": "v12.0",
      "properties": {
        "fullyQualifiedDomainName": "sqlcrudtest-6661.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ü.
ErrorAdditionalInfo	Kaynak yönetimi hatası ek bilgileri.
ErrorDetail	Hata ayrıntısı.
ErrorResponse	Hata yanıtı
ExternalGovernanceStatus	Dış idarenin durumu.
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.
MinimalTlsVersion	En düşük TLS sürümü. İzin verilen değerler: 'Yok', 1.0', '1.1', '1.2', '1.3'
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.
ServerListResult	Sunucuların listesi.
ServerNetworkAccessFlag	Bu sunucu için giden ağ erişiminin kısıtlanıp kısıtlanmaması. 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ı
ServerPublicNetworkAccessFlag	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ışı' veya 'SecuredByPerimeter' olmalıdır
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

Listeleme

Sunucu yöneticisinin türü.

Değer	Description
ActiveDirectory

ErrorAdditionalInfo

Object

Kaynak yönetimi hatası ek bilgileri.

Name	Tür	Description
info	object	Ek bilgiler.
type	string	Ek bilgi türü.

ErrorDetail

Object

Hata ayrıntısı.

Name	Tür	Description
additionalInfo	ErrorAdditionalInfo[]	Hata ek bilgileri.
code	string	Hata kodu.
details	ErrorDetail[]	Hata ayrıntıları.
message	string	Hata iletisi.
target	string	Hata hedefi.

ErrorResponse

Object

Hata yanıtı

Name	Tür	Description
error	ErrorDetail	Hata nesnesi.

ExternalGovernanceStatus

Listeleme

Dış idarenin durumu.

Değer	Description
Enabled
Disabled

IdentityType

Listeleme

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

Değer	Description
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

MinimalTlsVersion

Listeleme

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

Değer	Description
None
1.0
1.1
1.2
1.3

PrincipalType

Listeleme

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

Değer	Description
User
Group
Application

PrivateEndpointConnectionProperties

Object

Ö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

Object

Name	Tür	Description
id	string	Özel uç noktanın kaynak kimliği.

PrivateEndpointProvisioningState

Listeleme

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

Değer	Description
Approving
Ready
Dropping
Failed
Rejecting

PrivateLinkServiceConnectionStateActionsRequire

Listeleme

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

Değer	Description
None

PrivateLinkServiceConnectionStateProperty

Object

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

Listeleme

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

Değer	Description
Approved
Pending
Rejected
Disconnected

ResourceIdentity

Object

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

Name	Tür	Description
principalId	string (uuid)	Azure Active Directory asıl kimliği.
tenantId	string (uuid)	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

Object

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şturma için gereklidir).
properties.administrators	ServerExternalAdministrator	Sunucunun Azure Active Directory yöneticisi. Bu yalnızca sunucu oluşturma zamanında kullanılabilir. Sunucu güncelleştirmesi için kullanılırsa yoksayılır veya hataya neden olur. Güncelleştirmeler için tek tek API'lerin kullanılması gerekir.
properties.externalGovernanceStatus	ExternalGovernanceStatus	Dış idarenin durumu.
properties.federatedClientId	string (uuid)	Kiracılar arası CMK senaryosu için kullanılan İstemci kimliği
properties.fullyQualifiedDomainName	string	Sunucunun tam etki alanı adı.
properties.isIPv6Enabled	ServerNetworkAccessFlag	Bu sunucu için IPv6 desteğini etkinleştirip etkinleştirmeme. Değer isteğe bağlıdır, ancak geçirilirse 'Etkin' veya 'Devre Dışı' olmalıdır
properties.keyId	string	Şifreleme için kullanılacak anahtarın CMK URI'si.
properties.minimalTlsVersion	MinimalTlsVersion	En düşük TLS sürümü. İzin verilen değerler: 'Yok', 1.0', '1.1', '1.2', '1.3'
properties.primaryUserAssignedIdentityId	string	Varsayılan olarak kullanılacak kullanıcı tarafından atanan kimliğin kaynak kimliği.
properties.privateEndpointConnections	ServerPrivateEndpointConnection[]	Bir sunucudaki özel uç nokta bağlantılarının listesi
properties.publicNetworkAccess	ServerPublicNetworkAccessFlag	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ışı' veya 'SecuredByPerimeter' olmalıdır
properties.restrictOutboundNetworkAccess	ServerNetworkAccessFlag	Bu sunucu için giden ağ erişiminin kısıtlanıp kısıtlanmaması. 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

Object

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 (uuid)	Sunucu yöneticisinin SID (nesne kimliği).
tenantId	string (uuid)	Yöneticinin Kiracı Kimliği.

ServerListResult

Object

Sunucuların listesi.

Name	Tür	Description
nextLink	string	Sonraki sonuç sayfasını almak için bağlantı.
value	Server[]	Sonuç dizisi.

ServerNetworkAccessFlag

Listeleme

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

Değer	Description
Enabled
Disabled

ServerPrivateEndpointConnection

Object

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

ServerPublicNetworkAccessFlag

Listeleme

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ışı' veya 'SecuredByPerimeter' olmalıdır

Değer	Description
Enabled
Disabled
SecuredByPerimeter

ServerWorkspaceFeature

Listeleme

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

Değer	Description
Connected
Disconnected

UserIdentity

Object

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

Name	Tür	Description
clientId	string (uuid)	Azure Active Directory istemci kimliği.
principalId	string (uuid)	Azure Active Directory asıl kimliği.

Aracılığıyla paylaş

Servers - List

URI Parametreleri

Yanıtlar

Örnekler

List servers

Örnek isteği

Örnek yanıt

List servers with $expand=administrators/activedirectory

Örnek isteği

Örnek yanıt

Tanımlar

AdministratorType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExternalGovernanceStatus

IdentityType

MinimalTlsVersion

PrincipalType

PrivateEndpointConnectionProperties

PrivateEndpointProperty

PrivateEndpointProvisioningState

PrivateLinkServiceConnectionStateActionsRequire

PrivateLinkServiceConnectionStateProperty

PrivateLinkServiceConnectionStateStatus

ResourceIdentity

Server

ServerExternalAdministrator

ServerListResult

ServerNetworkAccessFlag

ServerPrivateEndpointConnection

ServerPublicNetworkAccessFlag

ServerWorkspaceFeature

UserIdentity