Usages - List By Instance Pool

Obtient toutes les métriques d’utilisation du pool d’instances

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/instancePools/{instancePoolName}/usages?api-version=2025-01-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/instancePools/{instancePoolName}/usages?api-version=2025-01-01&expandChildren={expandChildren}

Paramètres URI

Nom Dans Obligatoire Type Description
instancePoolName
path True

string

Nom du pool d’instances à récupérer.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nom du groupe de ressources. Le nom ne respecte pas la casse.

subscriptionId
path True

string (uuid)

ID de l’abonnement cible. La valeur doit être un UUID.

api-version
query True

string

minLength: 1

Version de l’API à utiliser pour cette opération.

expandChildren
query

boolean

Paramètre de requête facultatif pour inclure les utilisations d’instance managée dans le pool d’instances.

Réponses

Nom Type Description
200 OK

UsageListResult

Opération Azure terminée avec succès.

Other Status Codes

ErrorResponse

Réponse d’erreur inattendue.

Sécurité

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom Description
user_impersonation emprunter l’identité de votre compte d’utilisateur

Exemples

List instance pool usages expanded with children.
List instance pool usages.

List instance pool usages expanded with children.

Exemple de requête

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP/usages?api-version=2025-01-01&expandChildren=True

Exemple de réponse

{
  "value": [
    {
      "name": {
        "localizedValue": "VCore utilization",
        "value": "VCore utilization"
      },
      "type": "Microsoft.Sql/instancePools/usages",
      "currentValue": 12,
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP/usages/vcore_utilization",
      "limit": 16,
      "requestedLimit": 40,
      "unit": "VCores"
    },
    {
      "name": {
        "localizedValue": "Storage utilization",
        "value": "Storage utilization"
      },
      "type": "Microsoft.Sql/instancePools/usages",
      "currentValue": 384,
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP/usages/storage_utilization",
      "limit": 8196,
      "requestedLimit": null,
      "unit": "VCores"
    },
    {
      "name": {
        "localizedValue": "Database utilization",
        "value": "Database utilization"
      },
      "type": "Microsoft.Sql/instancePools/usages",
      "currentValue": 5,
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP/usages/database_utilization",
      "limit": 100,
      "requestedLimit": null,
      "unit": "Number Of Databases"
    },
    {
      "name": {
        "localizedValue": "VCore utilization",
        "value": "VCore utilization"
      },
      "type": "Microsoft.Sql/instancePools/managedInstances/usages",
      "currentValue": null,
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP/managedInstances/managedInstance1/usages/vcore_utilization",
      "limit": 4,
      "requestedLimit": null,
      "unit": "VCores"
    },
    {
      "name": {
        "localizedValue": "VCore utilization",
        "value": "VCore utilization"
      },
      "type": "Microsoft.Sql/instancePools/managedInstances/usages",
      "currentValue": null,
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP/managedInstances/managedInstance2/usages/vcore_utilization",
      "limit": 4,
      "requestedLimit": 8,
      "unit": "VCores"
    },
    {
      "name": {
        "localizedValue": "Storage utilization",
        "value": "Storage utilization"
      },
      "type": "Microsoft.Sql/instancePools/managedInstances/usages",
      "currentValue": null,
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP/managedInstances/managedInstance1/usages/storage_utilization",
      "limit": 128,
      "requestedLimit": null,
      "unit": "Gigabytes"
    },
    {
      "name": {
        "localizedValue": "VCore utilization",
        "value": "VCore utilization"
      },
      "type": "Microsoft.Sql/instancePools/managedInstances/usages",
      "currentValue": null,
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP/managedInstances/managedInstance2/usages/storage_utilization",
      "limit": 128,
      "requestedLimit": 256,
      "unit": "Gigabytes"
    },
    {
      "name": {
        "localizedValue": "Database utilization",
        "value": "Database utilization"
      },
      "type": "Microsoft.Sql/instancePools/managedInstances/usages",
      "currentValue": 2,
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP/managedInstances/managedInstance1/usages/database_utilization",
      "limit": 100,
      "requestedLimit": null,
      "unit": "Number Of Databases"
    },
    {
      "name": {
        "localizedValue": "Database utilization",
        "value": "Database utilization"
      },
      "type": "Microsoft.Sql/instancePools/managedInstances/usages",
      "currentValue": 3,
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP/managedInstances/managedInstance2/usages/database_utilization",
      "limit": 100,
      "requestedLimit": null,
      "unit": "Number Of Databases"
    }
  ]
}

List instance pool usages.

Exemple de requête

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP/usages?api-version=2025-01-01

Exemple de réponse

{
  "value": [
    {
      "name": {
        "localizedValue": "VCore utilization",
        "value": "VCore utilization"
      },
      "type": "Microsoft.Sql/instancePools/usages",
      "currentValue": 12,
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP/usages/vcore_utilization",
      "limit": 16,
      "requestedLimit": 40,
      "unit": "VCores"
    },
    {
      "name": {
        "localizedValue": "Storage utilization",
        "value": "Storage utilization"
      },
      "type": "Microsoft.Sql/instancePools/usages",
      "currentValue": 384,
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP/usages/storage_utilization",
      "limit": 8196,
      "requestedLimit": null,
      "unit": "VCores"
    },
    {
      "name": {
        "localizedValue": "Database utilization",
        "value": "Database utilization"
      },
      "type": "Microsoft.Sql/instancePools/usages",
      "currentValue": 5,
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP/usages/database_utilization",
      "limit": 100,
      "requestedLimit": null,
      "unit": "Number Of Databases"
    }
  ]
}

Définitions

Nom Description
ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

ErrorDetail

Détail de l’erreur.

ErrorResponse

Réponse d’erreur

Name

Nom d’utilisation ARM

Usage

Utilisation d’ARM.

UsageListResult

Une liste d’utilisations.

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom Type Description
info

object

Informations supplémentaires.

type

string

Type d’informations supplémentaire.

ErrorDetail

Détail de l’erreur.

Nom Type Description
additionalInfo

ErrorAdditionalInfo[]

Informations supplémentaires sur l’erreur.

code

string

Code d’erreur.

details

ErrorDetail[]

Détails de l’erreur.

message

string

Message d’erreur.

target

string

Cible d’erreur.

ErrorResponse

Réponse d’erreur

Nom Type Description
error

ErrorDetail

Objet d’erreur.

Name

Nom d’utilisation ARM

Nom Type Description
localizedValue

string

Valeur localisée du nom d’utilisation.

value

string

Valeur du nom d’utilisation

Usage

Utilisation d’ARM.

Nom Type Description
currentValue

integer (int32)

Valeur actuelle de l’utilisation.

id

string

ID de la ressource

limit

integer (int32)

Limite d’utilisation.

name

Name

Nom de la ressource.

requestedLimit

integer (int32)

Limite demandée par l’utilisation.

type

string

Type de ressource.

unit

string

Unité d’utilisation.

UsageListResult

Une liste d’utilisations.

Nom Type Description
nextLink

string (uri)

Lien vers la page suivante des éléments

value

Usage[]

Les éléments d’utilisation sur cette page