Elastic Pools - Get

Rugalmas készletet kap.

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

URI-paraméterek

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

string

A rugalmas készlet neve.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket.

serverName
path True

string

A kiszolgáló neve.

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ó.

Válaszok

Name Típus Description
200 OK

ElasticPool

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

Get a Hyperscale elastic pool
Get an elastic pool
Get an elastic pool with Availability Zone
Get an elastic pool with preferred enclave type parameter
Get an elastic pool with serverless properties

Get a Hyperscale elastic pool

Mintakérelem

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

Mintaválasz

{
  "name": "sqlcrudtest-8102",
  "type": "Microsoft.Sql/servers/elasticPools",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102",
  "kind": "vcore,pool",
  "location": "Japan East",
  "properties": {
    "creationDate": "2021-08-26T03:46:20.57Z",
    "highAvailabilityReplicaCount": 2,
    "licenseType": "LicenseIncluded",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_Default",
    "maxSizeBytes": 0,
    "perDatabaseSettings": {
      "maxCapacity": 4,
      "minCapacity": 0
    },
    "state": "Ready",
    "zoneRedundant": false
  },
  "sku": {
    "name": "HS_Gen5",
    "capacity": 4,
    "family": "Gen5",
    "tier": "Hyperscale"
  }
}

Get an elastic pool

Mintakérelem

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

Mintaválasz

{
  "name": "sqlcrudtest-8102",
  "type": "Microsoft.Sql/servers/elasticPools",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102",
  "kind": null,
  "location": "Japan East",
  "properties": {
    "creationDate": "2017-10-10T01:25:25.033Z",
    "licenseType": "LicenseIncluded",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_1",
    "maxSizeBytes": 5242880000,
    "perDatabaseSettings": {
      "maxCapacity": 1,
      "minCapacity": 0.25
    },
    "state": "Ready",
    "zoneRedundant": true
  },
  "sku": {
    "name": "GP_Gen5_2",
    "capacity": 2,
    "tier": "GeneralPurpose"
  }
}

Get an elastic pool with Availability Zone

Mintakérelem

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

Mintaválasz

{
  "name": "sqlcrudtest-8102",
  "type": "Microsoft.Sql/servers/elasticPools",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102",
  "kind": null,
  "location": "Japan East",
  "properties": {
    "availabilityZone": "1",
    "creationDate": "2017-10-10T01:25:25.033Z",
    "licenseType": "LicenseIncluded",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_1",
    "maxSizeBytes": 5242880000,
    "perDatabaseSettings": {
      "maxCapacity": 1,
      "minCapacity": 0.25
    },
    "state": "Ready",
    "zoneRedundant": true
  },
  "sku": {
    "name": "GP_Gen5_2",
    "capacity": 2,
    "tier": "GeneralPurpose"
  }
}

Get an elastic pool with preferred enclave type parameter

Mintakérelem

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

Mintaválasz

{
  "name": "sqlcrudtest-8102",
  "type": "Microsoft.Sql/servers/elasticPools",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102",
  "kind": "vcore,pool",
  "location": "Japan East",
  "properties": {
    "creationDate": "2022-08-26T03:46:20.57Z",
    "highAvailabilityReplicaCount": 2,
    "licenseType": "LicenseIncluded",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_Default",
    "maxSizeBytes": 0,
    "perDatabaseSettings": {
      "maxCapacity": 4,
      "minCapacity": 0
    },
    "preferredEnclaveType": "VBS",
    "state": "Ready",
    "zoneRedundant": false
  },
  "sku": {
    "name": "GP_Gen5",
    "capacity": 4,
    "family": "Gen5",
    "tier": "GeneralPurpose"
  }
}

Get an elastic pool with serverless properties

Mintakérelem

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

Mintaválasz

{
  "name": "sqlcrudtest-8102",
  "type": "Microsoft.Sql/servers/elasticPools",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102",
  "kind": null,
  "location": "Japan East",
  "properties": {
    "autoPauseDelay": 60,
    "creationDate": "2017-10-10T01:25:25.033Z",
    "licenseType": "LicenseIncluded",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_1",
    "maxSizeBytes": 5242880000,
    "minCapacity": 0.5,
    "perDatabaseSettings": {
      "autoPauseDelay": 60,
      "maxCapacity": 1,
      "minCapacity": 0
    },
    "state": "Ready",
    "zoneRedundant": true
  },
  "sku": {
    "name": "GP_S_Gen5_2",
    "capacity": 2,
    "tier": "GeneralPurpose"
  }
}

Definíciók

Name Description
AlwaysEncryptedEnclaveType

Az adatbázisban kért enklávé típusa, azaz alapértelmezett vagy VBS enklávé.

AvailabilityZoneType

Azt a rendelkezésre állási zónát adja meg, amelybe az adatbázis rögzítve van.

createdByType

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

ElasticPool

Rugalmas készlet.

ElasticPoolLicenseType

A rugalmas készletre alkalmazandó licenctípus.

ElasticPoolPerDatabaseSettings

Rugalmas készlet adatbázis-beállításai szerint.

ElasticPoolState

A rugalmas készlet állapota.

ErrorAdditionalInfo

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

ErrorDetail

A hiba részletei.

ErrorResponse

Hibaválasz

Sku

ARM-erőforrás termékváltozata.

systemData

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

AlwaysEncryptedEnclaveType

Az adatbázisban kért enklávé típusa, azaz alapértelmezett vagy VBS enklávé.

Érték Description
Default

Alapértelmezett

VBS

VBS

AvailabilityZoneType

Azt a rendelkezésre állási zónát adja meg, amelybe az adatbázis rögzítve van.

Érték Description
NoPreference

NoPreference

1

1

2

2

3

3

createdByType

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

Érték Description
User
Application
ManagedIdentity
Key

ElasticPool

Rugalmas készlet.

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

kind

string

Egyfajta rugalmas készlet. 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.autoPauseDelay

integer (int32)

A rugalmas készlet automatikus szüneteltetése percek alatt. A -1 értéke azt jelenti, hogy az automatikus szüneteltetés le van tiltva

properties.availabilityZone

AvailabilityZoneType

Megadja azt a rendelkezésre állási zónát, amelybe a készlet elsődleges replikája rögzítve van.

properties.creationDate

string (date-time)

A rugalmas készlet létrehozási dátuma (ISO8601 formátum).

properties.highAvailabilityReplicaCount

integer (int32)

Az üzletileg kritikus, prémium vagy rugalmas skálázású kiadás rugalmas készletéhez társított másodlagos replikák száma, amelyek magas rendelkezésre állást biztosítanak. Csak rugalmas készletekre alkalmazható.

properties.licenseType

ElasticPoolLicenseType

A rugalmas készletre alkalmazandó licenctípus.

properties.maintenanceConfigurationId

string

A rugalmas készlethez rendelt karbantartási konfiguráció azonosítója. Ez a konfiguráció határozza meg azt az időszakot, amikor a karbantartási frissítések bekövetkeznek.

properties.maxSizeBytes

integer (int64)

Az adatbázis rugalmas készletének tárterületkorlátja bájtban.

properties.minCapacity

number (double)

Minimális kapacitás, amely alatt a kiszolgáló nélküli készlet nem zsugorodik, ha nincs szüneteltetve

properties.perDatabaseSettings

ElasticPoolPerDatabaseSettings

A rugalmas készlet adatbázisonkénti beállításai.

properties.preferredEnclaveType

AlwaysEncryptedEnclaveType

A rugalmas készleten kért enklávé típusa.

properties.state

ElasticPoolState

A rugalmas készlet állapota.

properties.zoneRedundant

boolean

Azt jelzi, hogy ez a rugalmas készlet zónaredundáns-e, ami azt jelenti, hogy ennek a rugalmas készletnek a replikái több rendelkezésre állási zónában lesznek elosztva.

sku

Sku

A rugalmas készlet termékváltozata.

A termékváltozatok listája régiónként és támogatási ajánlatonként eltérő lehet. Ahhoz, hogy meghatározd azokat a SKU-kat (beleértve a SKU nevet, szintet/kiadást, családot és kapacitást), amelyek elérhetők az előfizetésed számára egy Azure régióban, használd a Capabilities_ListByLocation REST API-t vagy a következő parancsot:

az sql elastic-pool list-editions -l <location> -o table
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"

ElasticPoolLicenseType

A rugalmas készletre alkalmazandó licenctípus.

Érték Description
LicenseIncluded

LicenceIncluded

BasePrice

BasePrice

ElasticPoolPerDatabaseSettings

Rugalmas készlet adatbázis-beállításai szerint.

Name Típus Description
autoPauseDelay

integer (int32)

Adatbázisonkénti késleltetés automatikus szüneteltetése a készleten belül

maxCapacity

number (double)

Egy adatbázis maximális kapacitása.

minCapacity

number (double)

Az összes adatbázis minimális kapacitása garantált.

ElasticPoolState

A rugalmas készlet állapota.

Érték Description
Creating

Készítés

Ready

Kész

Disabled

Disabled

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.

Sku

ARM-erőforrás termékváltozata.

Name Típus Description
capacity

integer (int32)

Az adott termékváltozat kapacitása.

family

string

Ha a szolgáltatás különböző hardvergenerációval rendelkezik ugyanahhoz az SKU-hoz, akkor ezt itt rögzítheti.

name

string

Az termékváltozat neve általában egy betű + Szám kód, pl. P3.

size

string

Az adott termékváltozat mérete

tier

string

Az adott termékváltozat szintje vagy kiadása, például Alapszintű, Prémium.

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.