Subscription Usages - List By Location

Служба:

SQL Database

Версия API:

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.
api-version	query	True	string	Версия API для использования в запросе.

Ответы

Имя	Тип	Описание
200 OK	SubscriptionUsageListResult	Сведения об использовании расположения подписки успешно получены.
Other Status Codes		Ответы на ошибки: *** 400 InvalidLocation — указано недопустимое расположение. 404 SubscriptionNotFound — запрошенная подписка не найдена.

Примеры

List subscription usages in the given location.

Образец запроса

HTTP

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

Java

/**
 * 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",
            com.azure.core.util.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

Пример ответа

Код состояния:

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	Идентификатор ресурса.
name	string	Имя ресурса.
properties.currentValue	number	Текущее значение метрики.
properties.displayName	string	Доступное для чтения имя метрики.
properties.limit	number	Граничное значение метрики.
properties.unit	string	Единица измерения метрики.
type	string	Тип ресурса.

SubscriptionUsageListResult

Список метрик использования подписки в расположении.

Имя	Тип	Описание
nextLink	string	Ссылка для получения следующей страницы результатов.
value	SubscriptionUsage[]	Массив результатов.