Subscription Usages - List By Location

Service:

SQL Database

Version d'API:

2021-11-01

Obtient toutes les métriques d’utilisation de l’abonnement dans un emplacement donné.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
locationName	path	True	string	Nom de la région où se trouve la ressource.
subscriptionId	path	True	string	L’ID d’abonnement d’un abonnement Azure.
api-version	query	True	string	Version de l’API à utiliser pour la requête.

Réponses

Nom	Type	Description
200 OK	SubscriptionUsageListResult	Récupération réussie des utilisations de l’emplacement de l’abonnement.
Other Status Codes		Réponses d’erreur : *** 400 InvalidLocation : un emplacement non valide a été spécifié. 404 SubscriptionNotFound : l’abonnement demandé est introuvable.

Exemples

List subscription usages in the given location.

Exemple de requête

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

Exemple de réponse

Code d’état:

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

Définitions

Nom	Description
SubscriptionUsage	Métrique d’utilisation d’un abonnement dans un emplacement.
SubscriptionUsageListResult	Liste des métriques d’utilisation de l’abonnement dans un emplacement.

SubscriptionUsage

Object

Métrique d’utilisation d’un abonnement dans un emplacement.

Nom	Type	Description
id	string	ID de la ressource
name	string	Nom de la ressource.
properties.currentValue	number	Valeur actuelle de la métrique.
properties.displayName	string	Nom lisible par l’utilisateur de la métrique.
properties.limit	number	Valeur limite de la métrique.
properties.unit	string	Unité de la métrique.
type	string	Type de ressource.

SubscriptionUsageListResult

Object

Liste des métriques d’utilisation de l’abonnement dans un emplacement.

Nom	Type	Description
nextLink	string	Lien pour récupérer la page de résultats suivante.
value	SubscriptionUsage[]	Tableau de résultats.