Elastic Pools - Get

エラスティック プールを取得します。

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

URI パラメーター

Name In Required Type Description
elasticPoolName
path True
  • string

エラスティック プールの名前。

resourceGroupName
path True
  • string

リソースが含まれているリソース グループの名前。 この値は、Azure リソース マネージャー API またはポータルから取得できます。

serverName
path True
  • string

サーバーの名前。

subscriptionId
path True
  • string

Azure サブスクリプションを識別するサブスクリプション ID。

api-version
query True
  • string

要求で使用する API のバージョン。

応答

Name Type Description
200 OK

成功

Other Status Codes

エラー応答: ***

  • 400 ElasticPoolOverStorageUsage - エラスティック プールのストレージ制限に達した場合にデータベースにデータを書き込む試み。

  • 400 InvalidSku - ユーザーが無効な SKU を指定しました。

  • 400 InvalidTierSkuCombination - 指定されたレベルでは、指定された SKU がサポートされていません。

  • 400 ServerQuotaExceeded - サーバーは、許可されたデータベース スループット ユニットの制限に達しました。

  • 400 ElasticPoolAlreadyExists - 指定した名前のエラスティック プールがサーバーに既に含まれている。

  • 400 InvalidInputValueForEdition - エラスティック プールのプロビジョニングでは、指定されたエディションはサポートされていません。

  • 400 ElasticPoolDtuBelowLimit - 要求された DTU 値が、要求されたエラスティック プール サービス レベルに対して低すぎます。

  • 400 ElasticPoolDtuAboveLimit - 要求された DTU 値が、要求されたエラスティック プール サービス レベルに対して高すぎます。

  • 400 InvalidMaxSize - 最大サイズが無効です。

  • 400 ElasticPoolDbDtuMaxBelowLimit - 要求されたデータベースごとの DTU の最大値が、要求されたエラスティック プール サービス レベルに対して低すぎます。

  • 400 ElasticPoolDbDtuMaxAboveLimit - 要求されたデータベースごとの DTU の最大値が、要求されたエラスティック プール サービス レベルに対して高すぎます。

  • 400 InvalidInputValueForDatabaseDtuMax - 許可された値と一致しないリソース プールのデータベースあたりの DTU の最大値を設定します。

  • 400 ElasticPoolDbDtuMinAboveLimit - 要求されたサービス レベルでは、データベースあたりの要求された DTU 分が高すぎます。

  • 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 ElasticPoolBusy - ビジー状態のエラスティック プールで管理操作が試行されました。

  • 400 InvalidInputValueDatabaseDtuMinLargerThanMax - データベースあたりの DTU 最小値をデータベースあたりの DTU の最大値より大きい値に設定します。

  • 400 ElasticPoolInconsistentVcoreGuaranteeSettings - データベースの数とデータベースあたりの仮想コアの最小数が、エラスティック プールの要求された仮想コアを超えすることはできません。

  • 400 ElasticPoolStorageBelowLimitMB - サポートされている制限を下回るエラスティック プールの記憶域の制限を設定します。

  • 400 ElasticPoolStorageNotAllowedMB - 許容値と一致しないエラスティック プールのストレージ制限を mb 単位で設定しようと試みます。

  • 400 ElasticPoolCapacityStorageNotAllowedMB - 許容される値と一致しないエラスティック プールのストレージ制限を mb 単位で設定します。

  • 400 ElasticPoolStorageAboveLimitMB - サポートされている制限を下回るエラスティック プールの記憶域の制限を設定します。

  • 400 RegionDoesNotSupportVersion - ユーザーが、そのサーバー バージョンがサポートされていない場所に、指定されたバージョンのサーバーを作成しようとした。

  • 400 InvalidTier - ユーザーが無効なレベルを指定しました。

  • 400 SourceDatabaseEditionCouldNotBeUpgraded - ソース データベースのエディションをターゲット データベースより高くすることはできません。

  • 400 TargetDatabaseEditionCouldNotBeDowngraded - ターゲット データベースのエディションをソース データベースより低くすることはできません。

  • 400 ElasticPoolUpdateUpdateNotAllowed - 1 つ以上のデータベースでメモリ最適化オブジェクトが使用されているので、エラスティック プールはサービス レベルを プレミアム から Standard または Basic に下げできません。

  • 400 UpdateNotAllowedIfGeoDrOperationInProgress - サーバー ' ' のデータベース ' ' のコピーまたはフェールオーバー操作が現在進行中のため、この操作は許可 {0} {1} されません。

  • 400 RegionDoesNotAllowProvisioning - 選択した場所が新しいサーバー Windows Azure SQL Databaseできません。 これは後で変更される可能性があります。

  • 400 ElasticPoolOverFileSpace - エラスティック プール内のファイル領域が不足しています。

  • 400 ElasticPoolDbDtuMinBelowLimit - 要求されたデータベースごとの DTU 分が、要求されたエラスティック プール サービス レベルに対して低すぎます。

  • 400 ElasticPoolDbVcoreMaxBelowLimit - 要求されたエラスティック プール サービス レベルでは、データベースあたりの要求された仮想コアの最大値が低すぎます。

  • 400 ElasticPoolDbVcoreMaxAboveLimit - 要求されたエラスティック プール サービス レベルでは、データベースあたりの要求された仮想コアの最大値が高すぎます。

  • 400 InvalidInputValueForDatabaseVcoreMax - 許可された値と一致しないリソース プールのデータベースあたりの仮想コアの最大値の設定を試みます。

  • 400 ElasticPoolDbVcoreMinBelowLimit - 要求されたエラスティック プール サービス レベルでは、要求されたデータベースあたりの仮想コアの最小が低すぎます。

  • 400 InvalidInputValueForDatabaseVcoreMin - 許可された値と一致しないリソース プールのデータベースあたりの仮想コアの最小を設定します。

  • 400 PartnerDBNotCompatibleForSGXEnclave - エンクレーブ対応データベースの GeoDR リンクまたは更新 SLO の設定の試行は、両方のデータベースが DC シリーズハードウェアで実行されている場合にのみサポートされます。

  • 400 InvalidInputValueDatabaseVcoreMinLargerThanMax - データベースあたりの仮想コアの最小をデータベースあたりの仮想コアの最大値より大きい値に設定します。

  • 400 InvalidLicenseType - ユーザーが、サポートされていないライセンスの種類でデータベースまたはエラスティック プールを作成または更新しようとした。

  • 400 ProvisioningDisabled - 変更なしで、リソース操作承認者からのエラー メッセージを表示します

  • 400 InvalidPublicMaintenanceConfiguration - ユーザーは、内部 ID (形式が正しくありません、または間違ったリージョン) に変換できないパブリック メンテナンス構成を指定しようとしました。

  • 404 SubscriptionDoesNotHaveServer - 要求されたサーバーが見つかりませんでした

  • 404 ServerNotInSubscriptionResourceGroup - 指定されたサーバーが、指定されたリソース グループとサブスクリプションに存在しません。

  • 404 ElasticPoolNotFound - 指定されたエラスティック プールが、指定されたサーバーに存在しません。

  • 404 OperationIdNotFound - ID を持つ操作が存在しません。

  • 404 ResourceNotFound - 要求されたリソースが見つかりませんでした。

  • 405 NotSupported - この機能はサポートされていません。

  • 409 ServerDisabled - サーバーが無効です。

  • 409 SimultaneousSkuChangeNotAllowed - サービス目標変更操作は、レプリケーション関係の両方のデータベースで同時に実行できません。

  • 409 ElasticPoolUpdateLinksNotInCatchup - データベースの 1 つでコピーまたは geo レプリケーションのフェールオーバー操作を実行している間、エラスティック プールを更新できません。

  • 409 OperationCancelled - 操作はユーザーによって取り消されました。

  • 409 OperationInterrupted - 同じリソースに対する別の操作によって中断されたため、リソースに対する操作を完了する必要がありました。

  • 500 OperationTimedOut - 操作がタイム アウトされ、自動的にロールバックされました。 操作をやり直してください。

  • 503 ServiceTemporarilyUnavailable - 機能は一時的に使用できません。

Get an elastic pool

Sample Request

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=2021-02-01-preview

Sample Response

{
  "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": "GP_Gen5_2",
    "tier": "GeneralPurpose",
    "capacity": 2
  },
  "properties": {
    "creationDate": "2017-10-10T01:25:25.033Z",
    "state": "Ready",
    "maxSizeBytes": 5242880000,
    "perDatabaseSettings": {
      "minCapacity": 0.25,
      "maxCapacity": 1
    },
    "zoneRedundant": true,
    "licenseType": "LicenseIncluded",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_1"
  }
}

定義

ElasticPool

エラスティック プール。

ElasticPoolLicenseType

このエラスティックプールに適用するライセンスの種類。

ElasticPoolPerDatabaseSettings

エラスティック プールのデータベースごとの設定。

ElasticPoolState

エラスティック プールの状態。

Sku

ARM リソース SKU。

ElasticPool

エラスティック プール。

Name Type Description
id
  • string

リソースの ID

kind
  • string

エラスティック プールの種類。 これは、エクスペリエンスの向上に使用Azure portalメタデータです。

location
  • string

リソースの場所。

name
  • string

リソース名。

properties.creationDate
  • string

エラスティック プールの作成日 (ISO8601 形式)。

properties.licenseType

このエラスティック プールに適用するライセンスの種類。

properties.maintenanceConfigurationId
  • string

エラスティック プールに割り当てられたメンテナンス構成 ID。 この構成では、メンテナンスの更新が行われる期間を定義します。

properties.maxSizeBytes
  • integer

データベース エラスティック プールのストレージ制限 (バイト単位)。

properties.perDatabaseSettings

エラスティック プールのデータベースごとの設定。

properties.state

エラスティック プールの状態。

properties.zoneRedundant
  • boolean

このエラスティック プールがゾーン冗長かどうかは、このエラスティック プールのレプリカが複数の可用性ゾーンに分散されます。

sku

エラスティック プール SKU。

SKU の一覧は、リージョンとサポート オファーによって異なる場合があります。 Azure リージョンのサブスクリプションで使用できる SKU (SKU 名、階層/エディション、ファミリ、容量を含む) を特定するには、REST API または次のコマンド Capabilities_ListByLocation を使用します。

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

リソース タグ。

type
  • string

リソースの種類。

ElasticPoolLicenseType

このエラスティックプールに適用するライセンスの種類。

Name Type Description
BasePrice
  • string
LicenseIncluded
  • string

ElasticPoolPerDatabaseSettings

エラスティック プールのデータベースごとの設定。

Name Type Description
maxCapacity
  • number

1つのデータベースで使用できる最大容量。

minCapacity
  • number

最小容量は、すべてのデータベースを保証します。

ElasticPoolState

エラスティック プールの状態。

Name Type Description
Creating
  • string
Disabled
  • string
Ready
  • string

Sku

ARM リソース SKU。

Name Type Description
capacity
  • integer

特定の SKU の容量。

family
  • string

サービスのハードウェアの世代が異なる場合は、同じ SKU に対して、ここでキャプチャできます。

name
  • string

SKU の名前 (通常は文字 + 番号コード)(P3 など)。

size
  • string

特定の SKU のサイズ

tier
  • string

特定の SKU のレベルまたはエディション (Basic、プレミアム など)。