Servers - List

Referencia

Szolgáltatás:: SQL Database

API-verzió:: 2021-11-01

Lekéri az előfizetés összes kiszolgálójának listáját.

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

Opcionális paraméterekkel:

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
subscriptionId	path	True	string	Az Azure-előfizetést azonosító előfizetés-azonosító.
api-version	query	True	string	A kéréshez használandó API-verzió.
$expand	query		string	A válaszban szerepeltetni kívánt gyermekerőforrások.

Válaszok

Name	Típus	Description
200 OK	ServerListResult	Sikerült lekérni a kiszolgálók listáját.
Other Status Codes		Hibaválaszok: *** 404 SubscriptionNotFound – A kért előfizetés nem található.

Name

Típus

Description

200 OK

ServerListResult

Sikerült lekérni a kiszolgálók listáját.

Other Status Codes

Hibaválaszok: ***

404 SubscriptionNotFound – A kért előfizetés nem található.

Példák

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=2021-11-01


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

Mintaválasz

Állapotkód:: 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

Mintakérelem

HTTP
Java

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


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

Mintaválasz

Állapotkód:: 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"
              }
            }
          }
        ]
      }
    }
  ]
}

Definíciók

Name	Description
AdministratorType	A rendszergazda típusa.
IdentityType	Az identitás típusa. Állítsa ezt "SystemAssigned" értékre, hogy automatikusan létrehozhasson és hozzárendelhessen egy Azure Active Directory-tagot az erőforráshoz.
PrincipalType	A rendszergazda egyszerű típusa.
PrivateEndpointConnectionProperties	Privát végponti kapcsolat tulajdonságai.
PrivateEndpointProperty
PrivateEndpointProvisioningState	A privát végponti kapcsolat állapota.
PrivateLinkServiceConnectionStateActionsRequire	A privát kapcsolati szolgáltatáskapcsolathoz szükséges műveletek.
PrivateLinkServiceConnectionStateProperty
PrivateLinkServiceConnectionStateStatus	A private link szolgáltatás kapcsolati állapota.
ResourceIdentity	Azure Active Directory-identitáskonfiguráció egy erőforráshoz.
Server	Egy Azure SQL adatbázis-kiszolgáló.
ServerExternalAdministrator	Az Active Directory-rendszergazda tulajdonságai.
ServerListResult	A kiszolgálók listája.
ServerNetworkAccessFlag	Azt, hogy a nyilvános végponthoz való hozzáférés engedélyezve van-e ehhez a kiszolgálóhoz. Az érték megadása nem kötelező, de ha be van adva, akkor "Engedélyezve" vagy "Letiltva" értékűnek kell lennie.
ServerPrivateEndpointConnection	Privát végponti kapcsolat egy kiszolgáló alatt
ServerWorkspaceFeature	Azt jelzi, hogy a meglévő kiszolgáló rendelkezik-e munkaterület létrehozva, és engedélyezi-e a munkaterületről való csatlakozást
UserIdentity	Azure Active Directory-identitáskonfiguráció egy erőforráshoz.

AdministratorType

A rendszergazda típusa.

Name	Típus	Description
ActiveDirectory	string

IdentityType

Az identitás típusa. Állítsa ezt "SystemAssigned" értékre, hogy automatikusan létrehozhasson és hozzárendelhessen egy Azure Active Directory-tagot az erőforráshoz.

Name	Típus	Description
None	string
SystemAssigned	string
SystemAssigned,UserAssigned	string
UserAssigned	string

PrincipalType

A rendszergazda egyszerű típusa.

Name	Típus	Description
Application	string
Group	string
User	string

PrivateEndpointConnectionProperties

Privát végponti kapcsolat tulajdonságai.

Name	Típus	Description
groupIds	string[]	Csoportazonosítók.
privateEndpoint	PrivateEndpointProperty	Privát végpont, amelyhez a kapcsolat tartozik.
privateLinkServiceConnectionState	PrivateLinkServiceConnectionStateProperty	A privát végponti kapcsolat kapcsolati állapota.
provisioningState	PrivateEndpointProvisioningState	A privát végponti kapcsolat állapota.

PrivateEndpointProperty

Name	Típus	Description
id	string	A privát végpont erőforrás-azonosítója.

PrivateEndpointProvisioningState

A privát végponti kapcsolat állapota.

Name	Típus	Description
Approving	string
Dropping	string
Failed	string
Ready	string
Rejecting	string

PrivateLinkServiceConnectionStateActionsRequire

A privát kapcsolati szolgáltatáskapcsolathoz szükséges műveletek.

Name	Típus	Description
None	string

PrivateLinkServiceConnectionStateProperty

Name	Típus	Description
actionsRequired	PrivateLinkServiceConnectionStateActionsRequire	A privát kapcsolati szolgáltatáskapcsolathoz szükséges műveletek.
description	string	A private link szolgáltatás kapcsolatának leírása.
status	PrivateLinkServiceConnectionStateStatus	A private link szolgáltatás kapcsolati állapota.

PrivateLinkServiceConnectionStateStatus

A private link szolgáltatás kapcsolati állapota.

Name	Típus	Description
Approved	string
Disconnected	string
Pending	string
Rejected	string

ResourceIdentity

Azure Active Directory-identitáskonfiguráció egy erőforráshoz.

Name	Típus	Description
principalId	string	Az Azure Active Directory egyszerű azonosítója.
tenantId	string	Az Azure Active Directory-bérlő azonosítója.
type	IdentityType	Az identitás típusa. Állítsa ezt "SystemAssigned" értékre, hogy automatikusan létrehozhasson és hozzárendelhessen egy Azure Active Directory-tagot az erőforráshoz.
userAssignedIdentities	<string, UserIdentity>	A felhasználó által hozzárendelt használandó identitások erőforrás-azonosítói

Server

Egy Azure SQL adatbázis-kiszolgáló.

Name	Típus	Description
id	string	Erőforrás-azonosító.
identity	ResourceIdentity	A kiszolgáló Azure Active Directory-identitása.
kind	string	Az SQL Server típusa. Ez a Azure Portal élményhez használt metaadatok.
location	string	Erőforrás helye.
name	string	Erőforrás neve.
properties.administratorLogin	string	A kiszolgáló rendszergazdai felhasználóneve. A létrehozás után nem módosítható.
properties.administratorLoginPassword	string	A rendszergazdai bejelentkezési jelszó (a kiszolgáló létrehozásához szükséges).
properties.administrators	ServerExternalAdministrator	A kiszolgáló Azure Active Directory-rendszergazdája.
properties.federatedClientId	string	A bérlők közötti CMK-forgatókönyvhöz használt ügyfél-azonosító
properties.fullyQualifiedDomainName	string	A kiszolgáló teljes tartományneve.
properties.keyId	string	A titkosításhoz használandó kulcs CMK URI-ja.
properties.minimalTlsVersion	string	Minimális TLS-verzió. Megengedett értékek: "1.0", "1.1", "1.2"
properties.primaryUserAssignedIdentityId	string	Egy felhasználó által hozzárendelt identitás erőforrás-azonosítója, amelyet alapértelmezés szerint használni szeretne.
properties.privateEndpointConnections	ServerPrivateEndpointConnection[]	A kiszolgáló privát végponti kapcsolatainak listája
properties.publicNetworkAccess	ServerNetworkAccessFlag	Azt, hogy a nyilvános végponthoz való hozzáférés engedélyezve van-e ehhez a kiszolgálóhoz. Az érték megadása nem kötelező, de ha be van adva, akkor "Engedélyezve" vagy "Letiltva" értékűnek kell lennie.
properties.restrictOutboundNetworkAccess	ServerNetworkAccessFlag	A kiszolgáló kimenő hálózati hozzáférésének korlátozása. Az érték megadása nem kötelező, de ha be van adva, akkor "Engedélyezve" vagy "Letiltva" értékűnek kell lennie.
properties.state	string	A kiszolgáló állapota.
properties.version	string	A kiszolgáló verziója.
properties.workspaceFeature	ServerWorkspaceFeature	Azt jelzi, hogy a meglévő kiszolgáló rendelkezik-e munkaterület létrehozva, és engedélyezi-e a munkaterületről való csatlakozást
tags	object	Erőforráscímkék.
type	string	Erőforrástípus.

ServerExternalAdministrator

Az Active Directory-rendszergazda tulajdonságai.

Name	Típus	Description
administratorType	AdministratorType	A rendszergazda típusa.
azureADOnlyAuthentication	boolean	Csak az Azure Active Directory-hitelesítés engedélyezve van.
login	string	A kiszolgáló-rendszergazda bejelentkezési neve.
principalType	PrincipalType	A rendszergazda egyszerű típusa.
sid	string	A kiszolgálóadminisztrátor SID-azonosítója (objektumazonosítója).
tenantId	string	A rendszergazda bérlőazonosítója.

ServerListResult

A kiszolgálók listája.

Name	Típus	Description
nextLink	string	Hivatkozás az eredmények következő oldalának lekéréséhez.
value	Server[]	Eredmények tömbje.

ServerNetworkAccessFlag

Azt, hogy a nyilvános végponthoz való hozzáférés engedélyezve van-e ehhez a kiszolgálóhoz. Az érték megadása nem kötelező, de ha be van adva, akkor "Engedélyezve" vagy "Letiltva" értékűnek kell lennie.

Name	Típus	Description
Disabled	string
Enabled	string

ServerPrivateEndpointConnection

Privát végponti kapcsolat egy kiszolgáló alatt

Name	Típus	Description
id	string	Erőforrás-azonosító.
properties	PrivateEndpointConnectionProperties	Privát végpont kapcsolati tulajdonságai

ServerWorkspaceFeature

Azt jelzi, hogy a meglévő kiszolgáló rendelkezik-e munkaterület létrehozva, és engedélyezi-e a munkaterületről való csatlakozást

Name	Típus	Description
Connected	string
Disconnected	string

UserIdentity

Azure Active Directory-identitáskonfiguráció egy erőforráshoz.

Name	Típus	Description
clientId	string	Az Azure Active Directory-ügyfél azonosítója.
principalId	string	Az Azure Active Directory egyszerű azonosítója.

Megosztás a következőn keresztül:

Servers - List

URI-paraméterek

Válaszok

Példák

List servers

Mintakérelem

Mintaválasz

List servers with $expand=administrators/activedirectory

Mintakérelem

Mintaválasz

Definíciók

AdministratorType

IdentityType

PrincipalType

PrivateEndpointConnectionProperties

PrivateEndpointProperty

PrivateEndpointProvisioningState

PrivateLinkServiceConnectionStateActionsRequire

PrivateLinkServiceConnectionStateProperty

PrivateLinkServiceConnectionStateStatus

ResourceIdentity

Server

ServerExternalAdministrator

ServerListResult

ServerNetworkAccessFlag

ServerPrivateEndpointConnection

ServerWorkspaceFeature

UserIdentity

További források