Subscription Usages - List By Location

Service:

SQL Database

API Version:

2021-11-01

Obtém todas as métricas de uso da assinatura em um determinado local.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
locationName	path	True	string	O nome da região em que o recurso está localizado.
subscriptionId	path	True	string	A ID de assinatura que identifica uma assinatura do Azure.
api-version	query	True	string	A versão da API a ser usada para a solicitação.

Respostas

Nome	Tipo	Description
200 OK	SubscriptionUsageListResult	Os usos do local da assinatura foram recuperados com êxito.
Other Status Codes		Respostas de erro: *** 400 InvalidLocation - Um local inválido foi especificado. 404 SubscriptionNotFound - A assinatura solicitada não foi encontrada.

Exemplos

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

Definições

Nome	Description
SubscriptionUsage	Métrica de uso de uma assinatura em um local.
SubscriptionUsageListResult	Uma lista de métricas de uso de assinatura em um local.

SubscriptionUsage

Métrica de uso de uma assinatura em um local.

Nome	Tipo	Description
id	string	ID do recurso.
name	string	Nome do recurso.
properties.currentValue	number	Valor atual da métrica.
properties.displayName	string	Nome legível pelo usuário da métrica.
properties.limit	number	Valor de limite da métrica.
properties.unit	string	Unidade da métrica.
type	string	Tipo de recurso.

SubscriptionUsageListResult

Uma lista de métricas de uso de assinatura em um local.

Nome	Tipo	Description
nextLink	string	Link para recuperar a próxima página de resultados.
value	SubscriptionUsage[]	Matriz de resultados.