Subscription Usages - List By Location

Dienst:

SQL Database

API-Version:

2021-11-01

Ruft alle Abonnementnutzungsmetriken an einem bestimmten Speicherort ab.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
locationName	path	True	string	Der Name der Region, in der sich die Ressource befindet.
subscriptionId	path	True	string	Abonnement-ID für ein Azure-Abonnement.
api-version	query	True	string	API-Version, die für die Anforderung verwendet werden soll.

Antworten

Name	Typ	Beschreibung
200 OK	SubscriptionUsageListResult	Die Nutzung des Abonnementstandorts wurde erfolgreich abgerufen.
Other Status Codes		Fehlerantworten: *** 400 InvalidLocation: Ein ungültiger Speicherort wurde angegeben. 404 SubscriptionNotFound: Das angeforderte Abonnement wurde nicht gefunden.

Beispiele

List subscription usages in the given location.

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:

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

Definitionen

Name	Beschreibung
SubscriptionUsage	Nutzungsmetrik eines Abonnements an einem Standort.
SubscriptionUsageListResult	Eine Liste der Abonnementnutzungsmetriken an einem Standort.

SubscriptionUsage

Nutzungsmetrik eines Abonnements an einem Standort.

Name	Typ	Beschreibung
id	string	Ressourcen-ID
name	string	Name der Ressource.
properties.currentValue	number	Aktueller Wert der Metrik.
properties.displayName	string	Benutzerlesbarer Name der Metrik.
properties.limit	number	Der Grenzwert der Metrik.
properties.unit	string	Einheit der Metrik.
type	string	Der Ressourcentyp.

SubscriptionUsageListResult

Eine Liste der Abonnementnutzungsmetriken an einem Standort.

Name	Typ	Beschreibung
nextLink	string	Link zum Abrufen der nächsten Ergebnisseite.
value	SubscriptionUsage[]	Array von Ergebnissen.