Subscription Usages - List By Location

Service:

SQL Database

API Version:

2021-11-01

Ottiene tutte le metriche di utilizzo della sottoscrizione in una determinata posizione.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
locationName	path	True	string	Nome dell'area in cui si trova la risorsa.
subscriptionId	path	True	string	ID sottoscrizione che identifica una sottoscrizione di Azure.
api-version	query	True	string	Versione dell'API da usare per la richiesta.

Risposte

Nome	Tipo	Descrizione
200 OK	SubscriptionUsageListResult	È stato recuperato correttamente l'utilizzo della posizione della sottoscrizione.
Other Status Codes		Risposte di errore: 400 InvalidLocation: è stato specificato un percorso non valido. 404 SubscriptionNotFound: la sottoscrizione richiesta non è stata trovata.

Esempio

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

Definizioni

Nome	Descrizione
SubscriptionUsage	Metrica di utilizzo di una sottoscrizione in una località.
SubscriptionUsageListResult	Elenco delle metriche di utilizzo delle sottoscrizioni in una località.

SubscriptionUsage

Metrica di utilizzo di una sottoscrizione in una località.

Nome	Tipo	Descrizione
id	string	ID risorsa.
name	string	Nome risorsa.
properties.currentValue	number	Valore corrente della metrica.
properties.displayName	string	Nome leggibile dell'utente della metrica.
properties.limit	number	Valore limite della metrica.
properties.unit	string	Unità della metrica.
type	string	Tipo di risorsa.

SubscriptionUsageListResult

Elenco delle metriche di utilizzo delle sottoscrizioni in una località.

Nome	Tipo	Descrizione
nextLink	string	Collegamento per recuperare la pagina successiva dei risultati.
value	SubscriptionUsage[]	Matrice di risultati.