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 |
|---|---|---|---|---|
|
instance
|
path | True |
string |
Nom du pool d’instances à récupérer. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nom du groupe de ressources. Le nom ne respecte pas la casse. |
|
subscription
|
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. |
|
expand
|
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 |
Opération Azure terminée avec succès. |
|
| Other Status Codes |
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 |
|---|---|
|
Error |
Informations supplémentaires sur l’erreur de gestion des ressources. |
|
Error |
Détail de l’erreur. |
|
Error |
Réponse d’erreur |
| Name |
Nom d’utilisation ARM |
| Usage |
Utilisation d’ARM. |
|
Usage |
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 |
Informations supplémentaires sur l’erreur. |
|
| code |
string |
Code d’erreur. |
| details |
Détails de l’erreur. |
|
| message |
string |
Message d’erreur. |
| target |
string |
Cible d’erreur. |
ErrorResponse
Réponse d’erreur
| Nom | Type | Description |
|---|---|---|
| error |
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 |
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 |