Servers - List By Resource Group

Referenz

Dienst:: SQL Database

API-Version:: 2021-11-01

Ruft eine Liste der Server in einer Ressourcengruppe ab.

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

Mit optionalen Parametern:

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
resourceGroupName	path	True	string	Der Name der Ressourcengruppe, die die Ressource enthält. Dieser Wert kann über die Azure-Ressourcen-Manager-API oder das Portal abgerufen werden.
subscriptionId	path	True	string	Abonnement-ID für ein Azure-Abonnement.
api-version	query	True	string	API-Version, die für die Anforderung verwendet werden soll.
$expand	query		string	Die untergeordneten Ressourcen, die in die Antwort eingeschlossen werden sollen.

Antworten

Name	Typ	Beschreibung
200 OK	ServerListResult	Die Liste der Server wurde erfolgreich abgerufen.
Other Status Codes		Fehlerantworten: *** 404 SubscriptionNotFound: Das angeforderte Abonnement wurde nicht gefunden.

Name

Typ

Beschreibung

200 OK

ServerListResult

Die Liste der Server wurde erfolgreich abgerufen.

Other Status Codes

Fehlerantworten: ***

404 SubscriptionNotFound: Das angeforderte Abonnement wurde nicht gefunden.

Beispiele

List servers by resource group

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

List servers by resource group

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


/**
 * Samples for Servers ListByResourceGroup.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ServerListByResourceGroup.json
     */
    /**
     * Sample code: List servers by resource group.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void listServersByResourceGroup(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getServers().listByResourceGroup("sqlcrudtest-7398", 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

Beispiel für eine Antwort

Statuscode:: 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 by resource group with $expand=administrators/activedirectory

Beispielanforderung

HTTP
Java

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


/**
 * Samples for Servers ListByResourceGroup.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ServerListByResourceGroupWithExpandEqualsAdministrators.json
     */
    /**
     * Sample code: List servers by resource group with $expand=administrators/activedirectory.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void listServersByResourceGroupWithExpandAdministratorsActivedirectory(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getServers().listByResourceGroup("sqlcrudtest-7398", 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

Beispiel für eine Antwort

Statuscode:: 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"
              }
            }
          }
        ]
      }
    }
  ]
}

Definitionen

Name	Beschreibung
AdministratorType	Typ des Serveradministrators.
IdentityType	Der Identitätstyp. Legen Sie dies auf "SystemAssigned" fest, um automatisch einen Azure Active Directory-Prinzipal für die Ressource zu erstellen und zuzuweisen.
PrincipalType	Prinzipaltyp des Serveradministrators.
PrivateEndpointConnectionProperties	Eigenschaften einer privaten Endpunktverbindung.
PrivateEndpointProperty
PrivateEndpointProvisioningState	Zustand der Verbindung mit dem privaten Endpunkt.
PrivateLinkServiceConnectionStateActionsRequire	Die aktionen, die für die Private Link-Dienstverbindung erforderlich sind.
PrivateLinkServiceConnectionStateProperty
PrivateLinkServiceConnectionStateStatus	Die Private Link-Dienstverbindung status.
ResourceIdentity	Azure Active Directory-Identitätskonfiguration für eine Ressource.
Server	Ein Azure SQL Datenbankserver.
ServerExternalAdministrator	Eigenschaften eines Active Directory-Administrators.
ServerListResult	Eine Liste von Servern.
ServerNetworkAccessFlag	Gibt an, ob der Zugriff auf öffentliche Endpunkte für diesen Server zulässig ist. Der Wert ist optional, muss aber bei Übergabe "Aktiviert" oder "Deaktiviert" sein.
ServerPrivateEndpointConnection	Eine private Endpunktverbindung unter einem Server
ServerWorkspaceFeature	Gibt an, ob ein vorhandener Server einen Arbeitsbereich erstellt hat und ob er eine Verbindung vom Arbeitsbereich aus zulässt
UserIdentity	Azure Active Directory-Identitätskonfiguration für eine Ressource.

AdministratorType

Enumeration

Typ des Serveradministrators.

Wert	Beschreibung
ActiveDirectory

IdentityType

Enumeration

Der Identitätstyp. Legen Sie dies auf "SystemAssigned" fest, um automatisch einen Azure Active Directory-Prinzipal für die Ressource zu erstellen und zuzuweisen.

Wert	Beschreibung
None
SystemAssigned
SystemAssigned,UserAssigned
UserAssigned

PrincipalType

Enumeration

Prinzipaltyp des Serveradministrators.

Wert	Beschreibung
Application
Group
User

PrivateEndpointConnectionProperties

Objekt

Eigenschaften einer privaten Endpunktverbindung.

Name	Typ	Beschreibung
groupIds	string[]	Gruppen-IDs.
privateEndpoint	PrivateEndpointProperty	Privater Endpunkt, zu dem die Verbindung gehört.
privateLinkServiceConnectionState	PrivateLinkServiceConnectionStateProperty	Verbindungsstatus der privaten Endpunktverbindung.
provisioningState	PrivateEndpointProvisioningState	Zustand der Verbindung mit dem privaten Endpunkt.

PrivateEndpointProperty

Objekt

Name	Typ	Beschreibung
id	string	Ressourcen-ID des privaten Endpunkts.

PrivateEndpointProvisioningState

Enumeration

Zustand der Verbindung mit dem privaten Endpunkt.

Wert	Beschreibung
Approving
Dropping
Failed
Ready
Rejecting

PrivateLinkServiceConnectionStateActionsRequire

Enumeration

Die aktionen, die für die Private Link-Dienstverbindung erforderlich sind.

Wert	Beschreibung
None

PrivateLinkServiceConnectionStateProperty

Objekt

Name	Typ	Beschreibung
actionsRequired	PrivateLinkServiceConnectionStateActionsRequire	Die aktionen, die für die Private Link-Dienstverbindung erforderlich sind.
description	string	Die Verbindungsbeschreibung des Private Link-Diensts.
status	PrivateLinkServiceConnectionStateStatus	Die Private Link-Dienstverbindung status.

PrivateLinkServiceConnectionStateStatus

Enumeration

Die Private Link-Dienstverbindung status.

Wert	Beschreibung
Approved
Disconnected
Pending
Rejected

ResourceIdentity

Objekt

Azure Active Directory-Identitätskonfiguration für eine Ressource.

Name	Typ	Beschreibung
principalId	string	Die Azure Active Directory-Prinzipal-ID.
tenantId	string	Die Azure Active Directory-Mandanten-ID.
type	IdentityType	Der Identitätstyp. Legen Sie dies auf "SystemAssigned" fest, um automatisch einen Azure Active Directory-Prinzipal für die Ressource zu erstellen und zuzuweisen.
userAssignedIdentities	<string, UserIdentity>	Die Ressourcen-ID der zu verwendenden benutzerseitig zugewiesenen Identitäten

Server

Objekt

Ein Azure SQL Datenbankserver.

Name	Typ	Beschreibung
id	string	Ressourcen-ID
identity	ResourceIdentity	Die Azure Active Directory-Identität des Servers.
kind	string	Art von SQL Server. Dies sind Metadaten, die für die Azure-Portal-Benutzeroberfläche verwendet werden.
location	string	Ressourcenspeicherort
name	string	Name der Ressource.
properties.administratorLogin	string	Administratorbenutzername für den Server. Nach der Erstellung kann es nicht mehr geändert werden.
properties.administratorLoginPassword	string	Das Administratoranmeldekennwort (erforderlich für die Servererstellung).
properties.administrators	ServerExternalAdministrator	Der Azure Active Directory-Administrator des Servers.
properties.federatedClientId	string	Client-ID, die für mandantenübergreifendes CMK-Szenario verwendet wird
properties.fullyQualifiedDomainName	string	Der vollqualifizierte Domänenname des Servers.
properties.keyId	string	Ein CMK-URI des Schlüssels, der für die Verschlüsselung verwendet werden soll.
properties.minimalTlsVersion	string	Minimale TLS-Version. Zulässige Werte: "1.0", "1.1", "1.2"
properties.primaryUserAssignedIdentityId	string	Die Ressourcen-ID einer benutzerseitig zugewiesenen Identität, die standardmäßig verwendet werden soll.
properties.privateEndpointConnections	ServerPrivateEndpointConnection[]	Liste der privaten Endpunktverbindungen auf einem Server
properties.publicNetworkAccess	ServerNetworkAccessFlag	Gibt an, ob der Zugriff auf öffentliche Endpunkte für diesen Server zulässig ist. Der Wert ist optional, muss aber bei Übergabe "Aktiviert" oder "Deaktiviert" sein.
properties.restrictOutboundNetworkAccess	ServerNetworkAccessFlag	Gibt an, ob der ausgehende Netzwerkzugriff für diesen Server eingeschränkt werden soll oder nicht. Der Wert ist optional, muss aber bei Übergabe "Aktiviert" oder "Deaktiviert" sein.
properties.state	string	Der Zustand des Servers.
properties.version	string	Die Serverversion.
properties.workspaceFeature	ServerWorkspaceFeature	Gibt an, ob ein vorhandener Server einen Arbeitsbereich erstellt hat und ob er eine Verbindung vom Arbeitsbereich aus zulässt
tags	object	Ressourcentags.
type	string	Der Ressourcentyp.

ServerExternalAdministrator

Objekt

Eigenschaften eines Active Directory-Administrators.

Name	Typ	Beschreibung
administratorType	AdministratorType	Typ des Serveradministrators.
azureADOnlyAuthentication	boolean	Nur Azure Active Directory-Authentifizierung aktiviert.
login	string	Anmeldename des Serveradministrators.
principalType	PrincipalType	Prinzipaltyp des Serveradministrators.
sid	string	SID (Objekt-ID) des Serveradministrators.
tenantId	string	Mandanten-ID des Administrators.

ServerListResult

Objekt

Eine Liste von Servern.

Name	Typ	Beschreibung
nextLink	string	Link zum Abrufen der nächsten Ergebnisseite.
value	Server[]	Array von Ergebnissen.

ServerNetworkAccessFlag

Enumeration

Gibt an, ob der Zugriff auf öffentliche Endpunkte für diesen Server zulässig ist. Der Wert ist optional, muss aber bei Übergabe "Aktiviert" oder "Deaktiviert" sein.

Wert	Beschreibung
Disabled
Enabled

ServerPrivateEndpointConnection

Objekt

Eine private Endpunktverbindung unter einem Server

Name	Typ	Beschreibung
id	string	Ressourcen-ID
properties	PrivateEndpointConnectionProperties	Verbindungseigenschaften für private Endpunkte

ServerWorkspaceFeature

Enumeration

Gibt an, ob ein vorhandener Server einen Arbeitsbereich erstellt hat und ob er eine Verbindung vom Arbeitsbereich aus zulässt

Wert	Beschreibung
Connected
Disconnected

UserIdentity

Objekt

Azure Active Directory-Identitätskonfiguration für eine Ressource.

Name	Typ	Beschreibung
clientId	string	Die Azure Active Directory-Client-ID.
principalId	string	Die Azure Active Directory-Prinzipal-ID.

Freigeben über

Servers - List By Resource Group

URI-Parameter

Antworten

Beispiele

List servers by resource group

Beispielanforderung

Beispiel für eine Antwort

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

Beispielanforderung

Beispiel für eine Antwort

Definitionen

AdministratorType

IdentityType

PrincipalType

PrivateEndpointConnectionProperties

PrivateEndpointProperty

PrivateEndpointProvisioningState

PrivateLinkServiceConnectionStateActionsRequire

PrivateLinkServiceConnectionStateProperty

PrivateLinkServiceConnectionStateStatus

ResourceIdentity

Server

ServerExternalAdministrator

ServerListResult

ServerNetworkAccessFlag

ServerPrivateEndpointConnection

ServerWorkspaceFeature

UserIdentity

Zusätzliche Ressourcen