다음을 통해 공유


Elastic Pools - List By Server

서버의 모든 탄력적 풀을 가져옵니다.

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

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
resourceGroupName
path True

string

리소스를 포함하는 리소스 그룹의 이름입니다. Azure 리소스 관리자 API 또는 포털에서 이 값을 가져올 수 있습니다.

serverName
path True

string

서버의 이름입니다.

subscriptionId
path True

string

Azure 구독을 식별하는 구독 ID입니다.

api-version
query True

string

요청에 사용할 API 버전입니다.

$skip
query

integer

int64

건너뛸 컬렉션의 요소 수입니다.

응답

Name 형식 Description
200 OK

ElasticPoolListResult

성공

Other Status Codes

오류 응답: ***

  • 400 ElasticPoolOverStorageUsage - 탄력적 풀의 스토리지 제한에 도달했을 때 데이터베이스에 데이터를 쓰려고 시도합니다.

  • 400 InvalidSku - 사용자가 잘못된 sku를 지정했습니다.

  • 400 InvalidTierSkuCombination - 지정된 계층이 지정된 sku를 지원하지 않습니다.

  • 400 ServerQuotaExceeded - 서버가 허용된 데이터베이스 처리량 단위에 대한 제한에 도달했습니다.

  • 400 ElasticPoolAlreadyExists - 서버에 이미 지정된 이름의 탄력적 풀이 포함되어 있습니다.

  • 400 SubscriptionVcoreQuotaExceeded - 구독이 허용된 vCore 할당량을 초과하므로 작업을 수행할 수 없습니다.

  • 400 InvalidInputValueForEdition - 탄력적 풀 프로비저닝에 대해 지정된 버전이 지원되지 않습니다.

  • 400 ElasticPoolDtuBelowLimit - 요청된 DTU 값이 요청된 탄력적 풀 서비스 계층에 비해 너무 낮습니다.

  • 400 ElasticPoolDtuAboveLimit - 요청된 DTU 값이 요청된 탄력적 풀 서비스 계층에 비해 너무 높습니다.

  • 400 InvalidMaxSize - 잘못된 최대 크기입니다.

  • 400 ElasticPoolDbDtuMaxBelowLimit - 요청된 탄력적 풀 서비스 계층에 대해 데이터베이스당 요청된 DTU 최대값이 너무 낮습니다.

  • 400 ElasticPoolDbDtuMaxAboveLimit - 요청된 탄력적 풀 서비스 계층에 대해 데이터베이스당 요청된 DTU 최대값이 너무 높습니다.

  • 400 InvalidInputValueForDatabaseDtuMax - 허용되는 값과 일치하지 않는 리소스 풀의 데이터베이스당 DTU 최대값을 설정하려고 시도합니다.

  • 400 ElasticPoolDbDtuMinAboveLimit - 데이터베이스당 요청된 DTU 최소값이 요청된 서비스 계층에 비해 너무 높습니다.

  • 400 ElasticPoolOverStorage - 탄력적 풀의 스토리지 제한에 도달했을 때 데이터베이스에 데이터를 쓰려고 시도합니다.

  • 400 InvalidInputValueForDatabaseDtuMin - 허용되는 값과 일치하지 않는 리소스 풀의 데이터베이스당 DTU 최소값을 설정하려고 시도합니다.

  • 400 ElasticPoolInconsistentDtuGuaranteeSettings - 탄력적 풀의 요청된 DTU를 초과하는 탄력적 풀의 데이터베이스에 DTU 최소를 제공하려고 시도합니다.

  • 400 ElasticPoolDtuUnsupported - 사용자가 지원되지 않는 DTU 용량으로 탄력적 풀을 만들거나 업데이트하려고 했습니다.

  • 400 ElasticPoolStorageAboveLimitGB - 탄력적 풀 스토리지 제한을 지원되는 제한 아래로 설정하려고 시도합니다.

  • 400 ElasticPoolsNotEnabled - 이 지역에서 탄력적 풀을 사용하도록 설정하지 않았습니다.

  • 400 ElasticPoolNotEmpty - 비어 있지 않은 탄력적 풀을 삭제하도록 요청합니다.

  • 400 ElasticPoolStorageBelowLimitGB - 탄력적 풀 스토리지 제한을 지원되는 한도 이하로 설정하려고 시도합니다.

  • 400 ElasticPoolStorageNotAllowedGB - 허용되는 값과 일치하지 않는 탄력적 풀 스토리지 제한을 gb로 설정하려고 시도합니다.

  • 400 ElasticPoolDatabaseLimit - 탄력적 풀이 데이터베이스 수 제한에 도달했습니다.

  • 400 ElasticPoolDecreaseStorageLimitBelowUsage - 스토리지 사용량보다 탄력적 풀의 스토리지 제한을 줄이려고 시도합니다.

  • 400 InvalidInputValueDatabaseDtuMinLargerThanMax - 데이터베이스당 DTU 최소값을 데이터베이스당 DTU 최대값보다 높게 설정하려고 시도합니다.

  • 400 ElasticPoolInconsistentVcoreGuaranteeSettings - 데이터베이스당 데이터베이스 수 및 VCore 최소값은 탄력적 풀의 요청된 VCore를 초과할 수 없습니다.

  • 400 ElasticPoolStorageBelowLimitMB - 탄력적 풀 스토리지 제한을 지원되는 제한 이하로 설정하려고 시도합니다.

  • 400 ElasticPoolStorageNotAllowedMB - 허용되는 값과 일치하지 않는 탄력적 풀 스토리지 제한을 mb로 설정하려고 합니다.

  • 400 ElasticPoolCapacityStorageNotAllowedMB - 허용되는 값과 일치하지 않는 탄력적 풀 스토리지 제한을 mb로 설정하려고 시도합니다.

  • 400 ElasticPoolStorageAboveLimitMB - 탄력적 풀 스토리지 제한을 지원되는 제한 아래로 설정하려고 시도합니다.

  • 400 RegionDoesNotSupportVersion - 사용자가 해당 서버 버전이 지원되지 않는 위치에 지정된 버전의 서버를 만들려고 했습니다.

  • 400 InvalidTier - 사용자가 잘못된 계층을 지정했습니다.

  • 400 SourceDatabaseEditionCouldNotBeUpgraded - 원본 데이터베이스는 대상 데이터베이스보다 높은 버전을 가질 수 없습니다.

  • 400 TargetDatabaseEditionCouldNotBeDowngraded - 대상 데이터베이스는 원본 데이터베이스보다 낮은 버전을 가질 수 없습니다.

  • 400 ElasticPoolUpdateHkNotAllowed - 하나 이상의 데이터베이스에서 메모리 최적화 개체를 사용하므로 탄력적 풀은 서비스 계층을 프리미엄에서 표준 또는 기본으로 낮출 수 없습니다.

  • 400 UpdateNotAllowedIfGeoDrOperationInProgress - 서버 '{1}'의 데이터베이스 '{0}'에 대한 복사 또는 장애 조치(failover) 작업이 현재 진행 중이므로 작업이 허용되지 않습니다.

  • 400 RegionDoesNotAllowProvisioning - 선택한 위치가 새 Windows Azure SQL 데이터베이스 서버를 허용하지 않습니다. 나중에 변경 될 수 있습니다.

  • 400 ElasticPoolOverFileSpace - 탄력적 풀에 파일 공간이 부족합니다.

  • 400 ElasticPoolDbDtuMinBelowLimit - 요청된 탄력적 풀 서비스 계층에 대해 데이터베이스당 요청된 DTU 최소값이 너무 낮습니다.

  • 400 ElasticPoolDbVcoreMaxBelowLimit - 요청된 탄력적 풀 서비스 계층에 대해 데이터베이스당 요청된 VCore 최대값이 너무 낮습니다.

  • 400 ElasticPoolDbVcoreMaxAboveLimit - 요청된 탄력적 풀 서비스 계층에 대해 데이터베이스당 요청된 VCore 최대값이 너무 높습니다.

  • 400 InvalidInputValueForDatabaseVcoreMax - 허용되는 값과 일치하지 않는 리소스 풀의 데이터베이스당 VCore 최대값을 설정하려고 시도합니다.

  • 400 ElasticPoolDbVcoreMinBelowLimit - 요청된 탄력적 풀 서비스 계층에 대해 데이터베이스당 요청된 VCore 최소값이 너무 낮습니다.

  • 400 InvalidInputValueForDatabaseVcoreMin - 허용되는 값과 일치하지 않는 리소스 풀의 데이터베이스당 VCore 최소값을 설정하려고 시도합니다.

  • 400 PartnerDBNotCompatibleForSGXEnclave - Enclave 사용 데이터베이스에 대해 GeoDR 링크를 설정하거나 SLO를 업데이트하려는 시도는 두 데이터베이스가 DC 시리즈 하드웨어에서 실행되는 경우에만 지원됩니다.

  • 400 InvalidInputValueDatabaseVcoreMinLargerThanMax - 데이터베이스당 VCore 최소값을 데이터베이스당 VCore 최대값보다 높게 설정하려고 시도합니다.

  • 400 InvalidLicenseType - 사용자가 지원되지 않는 라이선스 유형으로 데이터베이스 또는 탄력적 풀을 만들거나 업데이트하려고 했습니다.

  • 400 ProvisioningDisabled - 변경 없이 리소스 작업 권한 부여자의 오류 메시지를 있는 그대로 표시합니다.

  • 400 InvalidPublicMaintenanceConfiguration - 사용자가 내부 ID(잘못된 형식 또는 잘못된 지역)로 변환할 수 없는 공용 유지 관리 구성을 지정하려고 했습니다.

  • 404 SubscriptionDoesNotHaveServer - 요청된 서버를 찾을 수 없습니다.

  • 404 ServerNotInSubscriptionResourceGroup - 지정된 서버가 지정된 리소스 그룹 및 구독에 없습니다.

  • 404 ElasticPoolNotFound - 지정된 서버에 대해 지정된 탄력적 풀이 없습니다.

  • 404 OperationIdNotFound - ID가 있는 작업이 없습니다.

  • 405 NotSupported - 이 기능은 지원되지 않습니다.

  • 409 ElasticPoolBusy - 사용 중인 탄력적 풀에서 관리 작업이 시도되었습니다.

  • 409 ServerDisabled - 서버를 사용할 수 없습니다.

  • 409 SimultaneousSkuChangeNotAllowed - 서비스 목표 변경 작업은 복제 관계의 두 데이터베이스에서 동시에 실행할 수 없습니다.

  • 409 ElasticPoolUpdateLinksNotInCatchup - 데이터베이스 중 하나가 복사 또는 지역 복제 장애 조치(failover) 작업을 수행하는 동안 탄력적 풀을 업데이트할 수 없습니다.

  • 409 OperationCancelled - 사용자가 작업을 취소했습니다.

  • 409 OperationInterrupted - 동일한 리소스의 다른 작업에 의해 중단되었으므로 리소스에 대한 작업을 완료할 수 없습니다.

  • 429 SubscriptionTooManyCreateUpdateRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.

  • 429 SubscriptionTooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.

  • 500 ElasticPoolFailedMoveDbToElasticPool - 내부 리소스 제약 조건으로 인해 데이터베이스를 탄력적 풀로 이동하지 못했습니다. 일시적인 상태일 수 있습니다. 다시 시도하세요.

  • 500 OperationTimedOut - 작업 시간이 초과되고 자동으로 롤백됩니다. 작업을 다시 시도하세요.

  • 503 ServiceTemporarilyUnavailable - 기능을 일시적으로 사용할 수 없습니다.

  • 503 TooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.

예제

Get all elastic pools in a server

샘플 요청

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

샘플 응답

{
  "value": [
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-2729",
      "name": "sqlcrudtest-2729",
      "type": "Microsoft.Sql/servers/elasticPools",
      "location": "Japan East",
      "kind": null,
      "sku": {
        "name": "GP_Gen4_2",
        "tier": "GeneralPurpose",
        "capacity": 2
      },
      "properties": {
        "creationDate": "2017-02-10T01:27:21.32Z",
        "state": "Ready",
        "maxSizeBytes": 5242880000,
        "perDatabaseSettings": {
          "minCapacity": 0.25,
          "maxCapacity": 1
        },
        "zoneRedundant": true,
        "licenseType": "LicenseIncluded"
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-3191",
      "name": "sqlcrudtest-3191",
      "type": "Microsoft.Sql/servers/elasticPools",
      "location": "Japan East",
      "kind": null,
      "sku": {
        "name": "BasicPool",
        "tier": "Basic",
        "capacity": 50
      },
      "properties": {
        "creationDate": "2017-02-10T01:26:26.45Z",
        "state": "Ready",
        "maxSizeBytes": 5242880000,
        "perDatabaseSettings": {
          "minCapacity": 0,
          "maxCapacity": 5
        }
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-2369/providers/Microsoft.Sql/servers/sqlcrudtest-8069/elasticPools/sqlcrudtest-8102",
      "name": "sqlcrudtest-8102",
      "type": "Microsoft.Sql/servers/elasticPools",
      "location": "Japan East",
      "kind": null,
      "sku": {
        "name": "BasicPool",
        "tier": "Basic",
        "capacity": 50
      },
      "properties": {
        "creationDate": "2017-02-10T01:25:25.033Z",
        "state": "Ready",
        "maxSizeBytes": 5242880000,
        "perDatabaseSettings": {
          "minCapacity": 0,
          "maxCapacity": 5
        }
      }
    }
  ]
}

정의

Name Description
ElasticPool

탄력적 풀.

ElasticPoolLicenseType

이 탄력적 풀에 적용할 라이선스 유형입니다.

ElasticPoolListResult

탄력적 풀 목록 요청의 결과입니다.

ElasticPoolPerDatabaseSettings

탄력적 풀의 데이터베이스별 설정입니다.

ElasticPoolState

탄력적 풀의 상태입니다.

Sku

ARM 리소스 SKU입니다.

ElasticPool

탄력적 풀.

Name 형식 Description
id

string

리소스 ID입니다.

kind

string

탄력적 풀의 종류입니다. Azure Portal 환경에 사용되는 메타데이터입니다.

location

string

리소스 위치.

name

string

리소스 이름입니다.

properties.creationDate

string

탄력적 풀(ISO8601 형식)의 생성 날짜입니다.

properties.highAvailabilityReplicaCount

integer

고가용성을 제공하는 데 사용되는 탄력적 풀과 연결된 보조 복제본의 수입니다. 하이퍼스케일 탄력적 풀에만 적용됩니다.

properties.licenseType

ElasticPoolLicenseType

이 탄력적 풀에 적용할 라이선스 유형입니다.

properties.maintenanceConfigurationId

string

탄력적 풀에 할당된 유지 관리 구성 ID입니다. 이 구성은 유지 관리 업데이트가 발생하는 기간을 정의합니다.

properties.maxSizeBytes

integer

데이터베이스 탄력적 풀의 스토리지 제한(바이트)입니다.

properties.minCapacity

number

일시 중지되지 않은 경우 서버리스 풀이 아래로 축소되지 않는 최소 용량

properties.perDatabaseSettings

ElasticPoolPerDatabaseSettings

탄력적 풀에 대한 데이터베이스별 설정입니다.

properties.state

ElasticPoolState

탄력적 풀의 상태입니다.

properties.zoneRedundant

boolean

이 탄력적 풀이 영역 중복인지 여부입니다. 즉, 이 탄력적 풀의 복제본이 여러 가용성 영역에 분산됩니다.

sku

Sku

탄력적 풀 SKU입니다.

SKU 목록은 지역 및 지원 제안에 따라 다를 수 있습니다. Azure 지역의 구독에 사용할 수 있는 SKU 이름, 계층/버전, 제품군 및 용량을 포함하려면 REST API 또는 다음 명령을 사용합니다 Capabilities_ListByLocation .

az sql elastic-pool list-editions -l <location> -o table
tags

object

리소스 태그.

type

string

리소스 종류.

ElasticPoolLicenseType

이 탄력적 풀에 적용할 라이선스 유형입니다.

Name 형식 Description
BasePrice

string

LicenseIncluded

string

ElasticPoolListResult

탄력적 풀 목록 요청의 결과입니다.

Name 형식 Description
nextLink

string

연결하여 결과의 다음 페이지를 검색합니다.

value

ElasticPool[]

결과 배열입니다.

ElasticPoolPerDatabaseSettings

탄력적 풀의 데이터베이스별 설정입니다.

Name 형식 Description
maxCapacity

number

한 데이터베이스에서 사용할 수 있는 최대 용량입니다.

minCapacity

number

모든 데이터베이스의 최소 용량이 보장됩니다.

ElasticPoolState

탄력적 풀의 상태입니다.

Name 형식 Description
Creating

string

Disabled

string

Ready

string

Sku

ARM 리소스 SKU입니다.

Name 형식 Description
capacity

integer

특정 SKU의 용량입니다.

family

string

서비스에 동일한 SKU에 대해 여러 세대의 하드웨어가 있는 경우 여기에서 캡처할 수 있습니다.

name

string

SKU의 이름(일반적으로 문자 + 숫자 코드(예: P3)입니다.

size

string

특정 SKU의 크기

tier

string

특정 SKU의 계층 또는 버전(예: Basic, Premium)입니다.