Servers - List

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=2025-01-01
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Sql/servers?api-version=2025-01-01&$expand={$expand}

URI-paraméterek

Name In Kötelező Típus Description
subscriptionId
path True

string (uuid)

A cél-előfizetés azonosítója. Az értéknek UUID-nek kell lennie.

api-version
query True

string

minLength: 1

A művelethez használandó API-verzió.

$expand
query

string

A válaszba belefoglalandó gyermekerőforrások.

Válaszok

Name Típus Description
200 OK

ServerListResult

Az Azure működése sikeresen befejeződött.

Other Status Codes

ErrorResponse

Váratlan hibaválasz.

Biztonság

azure_auth

Azure Active Directory OAuth2 Flow.

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name Description
user_impersonation a felhasználói fiók megszemélyesítése

Példák

List servers
List servers with $expand=administrators/activedirectory

List servers

Mintakérelem

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

Mintaválasz

{
  "value": [
    {
      "name": "sqlcrudtest-4645",
      "type": "Microsoft.Sql/servers",
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-4645",
      "kind": "v12.0",
      "location": "japaneast",
      "properties": {
        "administratorLogin": "dummylogin",
        "externalGovernanceStatus": "Enabled",
        "fullyQualifiedDomainName": "sqlcrudtest-4645.database.windows.net",
        "isIPv6Enabled": "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": {
              "privateEndpoint": {
                "id": "/subscriptions/55555555-6666-7777-8888-999999999999/resourceGroups/Default-Network/providers/Microsoft.Network/privateEndpoints/private-endpoint-name"
              },
              "privateLinkServiceConnectionState": {
                "description": "Auto-approved",
                "actionsRequired": "None",
                "status": "Approved"
              },
              "provisioningState": "Ready"
            }
          }
        ],
        "publicNetworkAccess": "Enabled",
        "restrictOutboundNetworkAccess": "Enabled",
        "state": "Ready",
        "version": "12.0",
        "workspaceFeature": "Connected"
      }
    },
    {
      "name": "sqlcrudtest-6661",
      "type": "Microsoft.Sql/servers",
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-6661",
      "kind": "v12.0",
      "location": "japaneast",
      "properties": {
        "administratorLogin": "dummylogin",
        "externalGovernanceStatus": "Enabled",
        "fullyQualifiedDomainName": "sqlcrudtest-6661.database.windows.net",
        "isIPv6Enabled": "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": {
              "privateEndpoint": {
                "id": "/subscriptions/55555555-6666-7777-8888-999999999999/resourceGroups/Default-Network/providers/Microsoft.Network/privateEndpoints/private-endpoint-name"
              },
              "privateLinkServiceConnectionState": {
                "description": "Auto-approved",
                "actionsRequired": "None",
                "status": "Approved"
              },
              "provisioningState": "Ready"
            }
          }
        ],
        "publicNetworkAccess": "Enabled",
        "restrictOutboundNetworkAccess": "Enabled",
        "state": "Ready",
        "version": "12.0",
        "workspaceFeature": "Connected"
      }
    }
  ]
}

List servers with $expand=administrators/activedirectory

Mintakérelem

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

Mintaválasz

{
  "value": [
    {
      "name": "sqlcrudtest-4645",
      "type": "Microsoft.Sql/servers",
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-4645",
      "kind": "v12.0",
      "location": "japaneast",
      "properties": {
        "administratorLogin": "dummylogin",
        "administrators": {
          "azureADOnlyAuthentication": true,
          "login": "bob@contoso.com",
          "principalType": "User",
          "sid": "00000011-1111-2222-2222-123456789111",
          "tenantId": "00000011-1111-2222-2222-123456789111"
        },
        "externalGovernanceStatus": "Enabled",
        "fullyQualifiedDomainName": "sqlcrudtest-4645.database.windows.net",
        "isIPv6Enabled": "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": {
              "privateEndpoint": {
                "id": "/subscriptions/55555555-6666-7777-8888-999999999999/resourceGroups/Default-Network/providers/Microsoft.Network/privateEndpoints/private-endpoint-name"
              },
              "privateLinkServiceConnectionState": {
                "description": "Auto-approved",
                "actionsRequired": "None",
                "status": "Approved"
              },
              "provisioningState": "Ready"
            }
          }
        ],
        "publicNetworkAccess": "Enabled",
        "restrictOutboundNetworkAccess": "Enabled",
        "retentionDays": 7,
        "state": "Ready",
        "version": "12.0",
        "workspaceFeature": "Connected"
      }
    },
    {
      "name": "sqlcrudtest-6661",
      "type": "Microsoft.Sql/servers",
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-6661",
      "kind": "v12.0",
      "location": "japaneast",
      "properties": {
        "administratorLogin": "dummylogin",
        "administrators": {
          "azureADOnlyAuthentication": true,
          "login": "bob@contoso.com",
          "principalType": "User",
          "sid": "00000011-1111-2222-2222-123456789111",
          "tenantId": "00000011-1111-2222-2222-123456789111"
        },
        "externalGovernanceStatus": "Enabled",
        "fullyQualifiedDomainName": "sqlcrudtest-6661.database.windows.net",
        "isIPv6Enabled": "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": {
              "privateEndpoint": {
                "id": "/subscriptions/55555555-6666-7777-8888-999999999999/resourceGroups/Default-Network/providers/Microsoft.Network/privateEndpoints/private-endpoint-name"
              },
              "privateLinkServiceConnectionState": {
                "description": "Auto-approved",
                "actionsRequired": "None",
                "status": "Approved"
              },
              "provisioningState": "Ready"
            }
          }
        ],
        "publicNetworkAccess": "Enabled",
        "restrictOutboundNetworkAccess": "Enabled",
        "retentionDays": 7,
        "state": "Ready",
        "version": "12.0",
        "workspaceFeature": "Connected"
      }
    }
  ]
}

Definíciók

Name Description
AdministratorType

A rendszergazda típusa.

createdByType

Az erőforrást létrehozó identitás típusa.

ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

ErrorDetail

A hiba részletei.

ErrorResponse

Hibaválasz

ExternalGovernanceStatus

A külső irányítás állapota.

IdentityType

Az identitás típusa. Állítsuk be 'SystemAssigned'-re, hogy automatikusan létrehozhass és hozzárendelhesd az Azure Active Directory alapvetőt az erőforráshoz.

MinimalTlsVersion

Minimális TLS-verzió. Engedélyezett értékek: "Nincs", 1.0", "1.1", "1.2", "1.3"

PrincipalType

A rendszergazda egyszerű típusa.

PrivateEndpointConnectionProperties

Privát végpontkapcsolat tulajdonságai.

PrivateEndpointProperty
PrivateEndpointProvisioningState

A privát végpontkapcsolat állapota.

PrivateLinkServiceConnectionStateActionsRequire

A privát kapcsolat szolgáltatáskapcsolatához szükséges műveletek.

PrivateLinkServiceConnectionStateProperty
PrivateLinkServiceConnectionStateStatus

A privát kapcsolat szolgáltatás kapcsolati állapota.

ResourceIdentity

Azure Active Directory identity configuration for a resource

Server

An Azure SQL Database server.

ServerCreateMode

Létrehozási mód a szerverhez, ehhez csak érvényes értékek a Normál és a Visszaállítás.

ServerExternalAdministrator

Az Active Directory-rendszergazda tulajdonságai.

ServerListResult

Kiszolgálólista művelet válasza.

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, "Engedélyezve" vagy "Letiltva" értéknek kell lennie

ServerPrivateEndpointConnection

Privát végpontkapcsolat egy kiszolgáló alatt

ServerPublicNetworkAccessFlag

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

ServerWorkspaceFeature

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

systemData

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

UserIdentity

Azure Active Directory identity configuration for a resource

AdministratorType

A rendszergazda típusa.

Érték Description
ActiveDirectory

ActiveDirectory

createdByType

Az erőforrást létrehozó identitás típusa.

Érték Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

Name Típus Description
info

object

A további információk.

type

string

A további információtípus.

ErrorDetail

A hiba részletei.

Name Típus Description
additionalInfo

ErrorAdditionalInfo[]

A hiba további információi.

code

string

A hibakód.

details

ErrorDetail[]

A hiba részletei.

message

string

A hibaüzenet.

target

string

A hiba célpontja.

ErrorResponse

Hibaválasz

Name Típus Description
error

ErrorDetail

A hibaobjektum.

ExternalGovernanceStatus

A külső irányítás állapota.

Érték Description
Enabled

Engedélyezett

Disabled

Disabled

IdentityType

Az identitás típusa. Állítsuk be 'SystemAssigned'-re, hogy automatikusan létrehozhass és hozzárendelhesd az Azure Active Directory alapvetőt az erőforráshoz.

Érték Description
None

Nincs

SystemAssigned

Rendszer Által Hozzárendelve

UserAssigned

UserAssigned

SystemAssigned,UserAssigned

SystemAssigned,UserAssigned

MinimalTlsVersion

Minimális TLS-verzió. Engedélyezett értékek: "Nincs", 1.0", "1.1", "1.2", "1.3"

Érték Description
None

Nincs

1.0

1.0

1.1

1.1

1.2

1.2

1.3

1.3

PrincipalType

A rendszergazda egyszerű típusa.

Érték Description
User

User

Group

Csoport

Application

Application

PrivateEndpointConnectionProperties

Privát végpontkapcsolat 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égpont kapcsolati állapota.

provisioningState

PrivateEndpointProvisioningState

A privát végpontkapcsolat állapota.

PrivateEndpointProperty

Name Típus Description
id

string

A privát végpont erőforrás-azonosítója.

PrivateEndpointProvisioningState

A privát végpontkapcsolat állapota.

Érték Description
Approving

Jóváhagyás

Ready

Kész

Dropping

Csepegés

Failed

Meghiúsult

Rejecting

Elutasítás

PrivateLinkServiceConnectionStateActionsRequire

A privát kapcsolat szolgáltatáskapcsolatához szükséges műveletek.

Érték Description
None

Nincs

PrivateLinkServiceConnectionStateProperty

Name Típus Description
actionsRequired

PrivateLinkServiceConnectionStateActionsRequire

A privát kapcsolat szolgáltatáskapcsolatához szükséges műveletek.

description

string

A privát kapcsolat szolgáltatás kapcsolatának leírása.

status

PrivateLinkServiceConnectionStateStatus

A privát kapcsolat szolgáltatás kapcsolati állapota.

PrivateLinkServiceConnectionStateStatus

A privát kapcsolat szolgáltatás kapcsolati állapota.

Érték Description
Approved

Jóváhagyott

Pending

Függőben lévő

Rejected

Elutasított

Disconnected

Disconnected

ResourceIdentity

Azure Active Directory identity configuration for a resource

Name Típus Description
principalId

string (uuid)

Az Azure Active Directory fő azonosítója.

tenantId

string (uuid)

Az Azure Active Directory tenant id.

type

IdentityType

Az identitás típusa. Állítsuk be 'SystemAssigned'-re, hogy automatikusan létrehozhass és hozzárendelhesd az Azure Active Directory alapvetőt az erőforráshoz.

userAssignedIdentities

<string,  UserIdentity>

A felhasználó által hozzárendelt használt identitások erőforrás-azonosítói

Server

An Azure SQL Database server.

Name Típus Description
id

string (arm-id)

Az erőforrás teljes erőforrás-azonosítója. Például: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

identity

ResourceIdentity

A szerver Azure Active Directory identitása.

kind

string

Az SQL Server típusa. Ez az Azure portál élményhez használt metaadat.

location

string

Az a földrajzi hely, ahol az erőforrás él

name

string

Az 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 (password)

A rendszergazda bejelentkezési jelszava (a kiszolgáló létrehozásához szükséges).

properties.administrators

ServerExternalAdministrator

Az Azure Active Directory adminisztrátor használható szerver létrehozása és frissítései során, kivéve az azureADOnlyAuthentication tulajdonságot. A tulajdonság azureADOnlyAuthentication frissítéséhez egyedi API-t kell használni.

properties.createMode

ServerCreateMode

Létrehozási mód a szerverhez, ehhez csak érvényes értékek a Normál és a Visszaállítás.

properties.externalGovernanceStatus

ExternalGovernanceStatus

A külső irányítás állapota.

properties.federatedClientId

string (uuid)

A bérlők közötti CMK-forgatókönyvhöz használt ügyfélazonosító

properties.fullyQualifiedDomainName

string

A kiszolgáló teljes tartományneve.

properties.isIPv6Enabled

ServerNetworkAccessFlag

A kiszolgáló IPv6-támogatásának engedélyezése. Az érték megadása nem kötelező, de ha be van adva, "Engedélyezve" vagy "Letiltva" értéknek kell lennie

properties.keyId

string

A titkosításhoz használandó kulcs CMK URI-ja.

properties.minimalTlsVersion

MinimalTlsVersion

Minimális TLS-verzió. Engedélyezett értékek: "Nincs", 1.0", "1.1", "1.2", "1.3"

properties.primaryUserAssignedIdentityId

string

A 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ó magánvégpont-kapcsolatainak listája

properties.publicNetworkAccess

ServerPublicNetworkAccessFlag

Azt jelzi, hogy engedélyezett-e nyilvános végpont-hozzáférés ehhez a kiszolgálóhoz. Az érték megadása nem kötelező, de ha be van adva, akkor "Engedélyezve" vagy "Letiltva" vagy "SecuredByPerimeter" értéknek 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, "Engedélyezve" vagy "Letiltva" értéknek kell lennie

properties.retentionDays

integer (int32)

Azon napok száma, amelyek miatt a kiszolgáló helyreállíthatóan törölve marad.

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étrehozásával, és engedélyezi-e a kapcsolatot a munkaterületről

systemData

systemData

Azure Resource Manager metaadat, amely createdBy és modifiedBy információkat tartalmaz.

tags

object

Erőforráscímkék.

type

string

Az erőforrás típusa. Például: "Microsoft. Compute/virtualMachines" vagy "Microsoft. Tárhely/tárolásFiókok"

ServerCreateMode

Létrehozási mód a szerverhez, ehhez csak érvényes értékek a Normál és a Visszaállítás.

Érték Description
Normal

Normális

Restore

Restore

ServerExternalAdministrator

Az Active Directory-rendszergazda tulajdonságai.

Name Típus Description
administratorType

AdministratorType

A rendszergazda típusa.

azureADOnlyAuthentication

boolean

Azure Active Directory csak hitelesítés engedélyezve.

login

string

A kiszolgáló rendszergazdájának bejelentkezési neve.

principalType

PrincipalType

A rendszergazda egyszerű típusa.

sid

string (uuid)

A kiszolgáló rendszergazdájának SID-azonosítója (objektumazonosítója).

tenantId

string (uuid)

A rendszergazda bérlőazonosítója.

ServerListResult

Kiszolgálólista művelet válasza.

Name Típus Description
nextLink

string (uri)

A következő oldalra mutató link

value

Server[]

A kiszolgáló elemei ezen a lapon

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, "Engedélyezve" vagy "Letiltva" értéknek kell lennie

Érték Description
Enabled

Engedélyezett

Disabled

Disabled

ServerPrivateEndpointConnection

Privát végpontkapcsolat egy kiszolgáló alatt

Name Típus Description
id

string

Erőforrás-azonosító.

properties

PrivateEndpointConnectionProperties

Privát végpont kapcsolati tulajdonságai

ServerPublicNetworkAccessFlag

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

Érték Description
Enabled

Engedélyezett

Disabled

Disabled

SecuredByPerimeter

SecuredByPerimeter

ServerWorkspaceFeature

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

Érték Description
Connected

Csatlakoztatva

Disconnected

Disconnected

systemData

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

Name Típus Description
createdAt

string (date-time)

Az erőforrás-létrehozás időbélyege (UTC).

createdBy

string

Az erőforrást létrehozó identitás.

createdByType

createdByType

Az erőforrást létrehozó identitás típusa.

lastModifiedAt

string (date-time)

Az erőforrás utolsó módosításának időbélyege (UTC)

lastModifiedBy

string

Az erőforrást legutóbb módosító identitás.

lastModifiedByType

createdByType

Az erőforrást legutóbb módosító identitás típusa.

UserIdentity

Azure Active Directory identity configuration for a resource

Name Típus Description
clientId

string (uuid)

Az Azure Active Directory kliensazonosítója.

principalId

string (uuid)

Az Azure Active Directory fő azonosítója.