Subscription Usages - List By Location

Service:

SQL Database

API Version:

2021-11-01

特定の場所にあるすべてのサブスクリプション使用状況メトリックを取得します。

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

URI パラメーター

名前	/	必須	型	説明
locationName	path	True	string	リソースが配置されているリージョンの名前。
subscriptionId	path	True	string	Azure サブスクリプションを識別するサブスクリプション ID。
api-version	query	True	string	要求で使用する API のバージョン。

応答

名前	型	説明
200 OK	SubscriptionUsageListResult	サブスクリプションの場所の使用状況が正常に取得されました。
Other Status Codes		エラー応答: *** 400 InvalidLocation - 無効な場所が指定されました。 404 SubscriptionNotFound - 要求されたサブスクリプションが見つかりませんでした。

例

List subscription usages in the given location.

Sample Request

HTTP

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

Java

import com.azure.core.util.Context;

/** Samples for SubscriptionUsages ListByLocation. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/SubscriptionUsageListByLocation.json
     */
    /**
     * Sample code: List subscription usages in the given location.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void listSubscriptionUsagesInTheGivenLocation(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getSubscriptionUsages().listByLocation("WestUS", 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

Sample Response

Status code:

200

{
  "value": [
    {
      "properties": {
        "displayName": "Regional Server Quota for West US",
        "currentValue": 1,
        "limit": 20,
        "unit": "Count"
      },
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/Onebox/usages/ServerQuota",
      "name": "ServerQuota",
      "type": "Microsoft.Sql/locations/usages"
    },
    {
      "properties": {
        "displayName": "Free Database Count per Subscription for West US",
        "currentValue": 0,
        "limit": 1,
        "unit": "Count"
      },
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/Onebox/usages/SubscriptionFreeDatabaseCount",
      "name": "SubscriptionFreeDatabaseCount",
      "type": "Microsoft.Sql/locations/usages"
    },
    {
      "properties": {
        "displayName": "Free to Basic Database Upgrade count-down in West US",
        "currentValue": 365,
        "limit": 365,
        "unit": "Count"
      },
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/Onebox/usages/SubscriptionFreeDatabaseDaysLeft",
      "name": "SubscriptionFreeDatabaseDaysLeft",
      "type": "Microsoft.Sql/locations/usages"
    }
  ]
}

定義

名前	説明
SubscriptionUsage	ある場所でのサブスクリプションの使用状況メトリック。
SubscriptionUsageListResult	ある場所のサブスクリプション使用状況メトリックの一覧。

SubscriptionUsage

ある場所でのサブスクリプションの使用状況メトリック。

名前	型	説明
id	string	リソースの ID
name	string	リソース名。
properties.currentValue	number	メトリックの現在の値。
properties.displayName	string	メトリックのユーザーが読み取り可能な名前。
properties.limit	number	メトリックの境界値。
properties.unit	string	メトリックの単位。
type	string	リソースの種類。

SubscriptionUsageListResult

ある場所のサブスクリプション使用状況メトリックの一覧。

名前	型	説明
nextLink	string	結果の次のページを取得するためのリンク。
value	SubscriptionUsage[]	結果の配列。