Servers - List By Resource Group

Pobiera listę serwerów w grupach zasobów.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers?api-version=2021-02-01-preview
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers?$expand={$expand}&api-version=2021-02-01-preview

Parametry identyfikatora URI

Name In Required Type Description
resourceGroupName
path True
  • string

Nazwa grupy zasobów zawierającej zasób. Tę wartość można uzyskać z interfejsu API Resource Manager platformy Azure lub portalu.

subscriptionId
path True
  • string

Identyfikator subskrypcji identyfikujący subskrypcję platformy Azure.

api-version
query True
  • string

Wersja interfejsu API do użycia dla żądania.

$expand
query
  • string

Zasoby podrzędne do uwzględnienia w odpowiedzi.

Odpowiedzi

Name Type Description
200 OK

Pomyślnie pobrano listę serwerów.

Other Status Codes

Odpowiedzi na błędy: ***

Przykłady

List servers by resource group
List servers by resource group with $expand=administrators

List servers by resource group

Sample Request

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

Sample Response

{
  "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 by resource group with $expand=administrators

Sample Request

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

Sample Response

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

Definicje

AdministratorType

Typ administratora serwera.

IdentityType

Typ tożsamości. Ustaw tę wartość na wartość "SystemAssigned", aby automatycznie utworzyć i przypisać Azure Active Directory podmiot zabezpieczeń dla zasobu.

PrincipalType

Typ podmiotu zabezpieczeń administratora serwera.

PrivateEndpointConnectionProperties

Właściwości połączenia prywatnego punktu końcowego.

PrivateEndpointProperty
PrivateEndpointProvisioningState

Stan połączenia prywatnego punktu końcowego.

PrivateLinkServiceConnectionStateActionsRequire

Akcje wymagane do połączenia usługi private link.

PrivateLinkServiceConnectionStateProperty
PrivateLinkServiceConnectionStateStatus

Stan połączenia usługi private link.

ResourceIdentity

Azure Active Directory konfiguracji tożsamości dla zasobu.

Server

Serwer Azure SQL Database.

ServerExternalAdministrator

Właściwości administratora usługi Active Directory.

ServerListResult

Lista serwerów.

ServerNetworkAccessFlag

Niezależnie od tego, czy dostęp do publicznego punktu końcowego jest dozwolony dla tego serwera. Wartość jest opcjonalna, ale jeśli została przekazana, musi mieć wartość "Włączone" lub "Wyłączone"

ServerPrivateEndpointConnection

Połączenie prywatnego punktu końcowego na serwerze

ServerWorkspaceFeature

Czy istniejący serwer ma utworzony obszar roboczy i czy zezwala na połączenie z obszaru roboczego

UserIdentity

Azure Active Directory konfiguracji tożsamości dla zasobu.

AdministratorType

Typ administratora serwera.

Name Type Description
ActiveDirectory
  • string

IdentityType

Typ tożsamości. Ustaw tę wartość na wartość "SystemAssigned", aby automatycznie utworzyć i przypisać Azure Active Directory podmiot zabezpieczeń dla zasobu.

Name Type Description
None
  • string
SystemAssigned
  • string
SystemAssigned,UserAssigned
  • string
UserAssigned
  • string

PrincipalType

Typ podmiotu zabezpieczeń administratora serwera.

Name Type Description
Application
  • string
Group
  • string
User
  • string

PrivateEndpointConnectionProperties

Właściwości połączenia prywatnego punktu końcowego.

Name Type Description
privateEndpoint

Prywatny punkt końcowy, do którego należy połączenie.

privateLinkServiceConnectionState

Stan połączenia prywatnego punktu końcowego.

provisioningState

Stan połączenia prywatnego punktu końcowego.

PrivateEndpointProperty

Name Type Description
id
  • string

Identyfikator zasobu prywatnego punktu końcowego.

PrivateEndpointProvisioningState

Stan połączenia prywatnego punktu końcowego.

Name Type Description
Approving
  • string
Dropping
  • string
Failed
  • string
Ready
  • string
Rejecting
  • string

PrivateLinkServiceConnectionStateActionsRequire

Akcje wymagane do połączenia usługi private link.

Name Type Description
None
  • string

PrivateLinkServiceConnectionStateProperty

Name Type Description
actionsRequired

Akcje wymagane do połączenia usługi private link.

description
  • string

Opis połączenia usługi private link.

status

Stan połączenia usługi private link.

PrivateLinkServiceConnectionStateStatus

Stan połączenia usługi private link.

Name Type Description
Approved
  • string
Disconnected
  • string
Pending
  • string
Rejected
  • string

ResourceIdentity

Azure Active Directory konfiguracji tożsamości dla zasobu.

Name Type Description
principalId
  • string

Identyfikator podmiotu zabezpieczeń Azure Active Directory.

tenantId
  • string

Identyfikator dzierżawy Azure Active Directory.

type

Typ tożsamości. Ustaw tę wartość na wartość "SystemAssigned", aby automatycznie utworzyć i przypisać Azure Active Directory podmiot zabezpieczeń dla zasobu.

userAssignedIdentities

Identyfikatory zasobów tożsamości przypisanych przez użytkownika do użycia

Server

Serwer Azure SQL Database.

Name Type Description
id
  • string

Identyfikator zasobu.

identity

Tożsamość Azure Active Directory serwera.

kind
  • string

Rodzaj serwera SQL. Są to metadane używane w środowisku Azure Portal.

location
  • string

Lokalizacja zasobu.

name
  • string

Nazwa zasobu.

properties.administratorLogin
  • string

Nazwa użytkownika administratora serwera. Po utworzeniu nie można go zmienić.

properties.administratorLoginPassword
  • string

Hasło logowania administratora (wymagane do utworzenia serwera).

properties.administrators

Tożsamość Azure Active Directory serwera.

properties.federatedClientId
  • string

Identyfikator klienta używany w scenariuszu cmK między dzierżawami

properties.fullyQualifiedDomainName
  • string

W pełni kwalifikowana nazwa domeny serwera.

properties.keyId
  • string

Identyfikator URI klucza do użycia na potrzeby szyfrowania.

properties.minimalTlsVersion
  • string

Minimalna wersja protokołu TLS. Dozwolone wartości: "1.0", "1.1", "1.2"

properties.primaryUserAssignedIdentityId
  • string

Identyfikator zasobu tożsamości przypisanej przez użytkownika domyślnie używany.

properties.privateEndpointConnections

Lista połączeń prywatnego punktu końcowego na serwerze

properties.publicNetworkAccess

Niezależnie od tego, czy dostęp do publicznego punktu końcowego jest dozwolony dla tego serwera. Wartość jest opcjonalna, ale jeśli została przekazana, musi mieć wartość "Włączone" lub "Wyłączone"

properties.restrictOutboundNetworkAccess

Niezależnie od tego, czy należy ograniczyć dostęp do sieci wychodzącej dla tego serwera. Wartość jest opcjonalna, ale jeśli została przekazana, musi mieć wartość "Włączone" lub "Wyłączone"

properties.state
  • string

Stan serwera.

properties.version
  • string

Wersja serwera.

properties.workspaceFeature

Czy istniejący serwer ma utworzony obszar roboczy i czy zezwala na połączenie z obszaru roboczego

tags
  • object

Tagi zasobów.

type
  • string

Typ zasobu.

ServerExternalAdministrator

Właściwości administratora usługi Active Directory.

Name Type Description
administratorType

Typ administratora serwera.

azureADOnlyAuthentication
  • boolean

Azure Active Directory włączone tylko uwierzytelnianie.

login
  • string

Nazwa logowania administratora serwera.

principalType

Typ podmiotu zabezpieczeń administratora serwera.

sid
  • string

Identyfikator SID (identyfikator obiektu) administratora serwera.

tenantId
  • string

Identyfikator dzierżawy administratora.

ServerListResult

Lista serwerów.

Name Type Description
nextLink
  • string

Link, aby pobrać następną stronę wyników.

value

Tablica wyników.

ServerNetworkAccessFlag

Niezależnie od tego, czy dostęp do publicznego punktu końcowego jest dozwolony dla tego serwera. Wartość jest opcjonalna, ale jeśli została przekazana, musi mieć wartość "Włączone" lub "Wyłączone"

Name Type Description
Disabled
  • string
Enabled
  • string

ServerPrivateEndpointConnection

Połączenie prywatnego punktu końcowego na serwerze

Name Type Description
id
  • string

Identyfikator zasobu.

properties

Właściwości połączenia prywatnego punktu końcowego

ServerWorkspaceFeature

Czy istniejący serwer ma utworzony obszar roboczy i czy zezwala na połączenie z obszaru roboczego

Name Type Description
Connected
  • string
Disconnected
  • string

UserIdentity

Azure Active Directory konfiguracji tożsamości dla zasobu.

Name Type Description
clientId
  • string

Identyfikator klienta Azure Active Directory.

principalId
  • string

Identyfikator podmiotu zabezpieczeń Azure Active Directory.