Usages - List By Instance Pool
Ruft alle Metriken der Instanzpoolnutzung ab.
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}
URI-Parameter
| Name | In | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
instance
|
path | True |
string |
Der Name des abzurufenden Instanzpools. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet. |
|
subscription
|
path | True |
string (uuid) |
Die ID des Zielabonnements. Der Wert muss eine UUID sein. |
|
api-version
|
query | True |
string minLength: 1 |
Die API-Version, die für diesen Vorgang verwendet werden soll. |
|
expand
|
query |
boolean |
Optionaler Anforderungsparameter, um verwaltete Instanzenverwendungen in den Instanzpool einzuschließen. |
Antworten
| Name | Typ | Beschreibung |
|---|---|---|
| 200 OK |
Azure-Operation erfolgreich abgeschlossen. |
|
| Other Status Codes |
Unerwartete Fehlerantwort. |
Sicherheit
azure_auth
Azure Active Directory OAuth2 Flow.
Typ:
oauth2
Ablauf:
implicit
Autorisierungs-URL:
https://login.microsoftonline.com/common/oauth2/authorize
Bereiche
| Name | Beschreibung |
|---|---|
| user_impersonation | Identitätswechsel ihres Benutzerkontos |
Beispiele
| List instance pool usages expanded with children. |
| List instance pool usages. |
List instance pool usages expanded with children.
Beispielanforderung
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
Beispiel für eine Antwort
{
"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.
Beispielanforderung
GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP/usages?api-version=2025-01-01
Beispiel für eine Antwort
{
"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"
}
]
}
Definitionen
| Name | Beschreibung |
|---|---|
|
Error |
Der Ressourcenverwaltungsfehler zusätzliche Informationen. |
|
Error |
Das Fehlerdetails. |
|
Error |
Fehlerantwort |
| Name |
ARM-Verwendungsname |
| Usage |
ARM-Verwendung. |
|
Usage |
Eine Liste der Verwendungen. |
ErrorAdditionalInfo
Der Ressourcenverwaltungsfehler zusätzliche Informationen.
| Name | Typ | Beschreibung |
|---|---|---|
| info |
object |
Die zusätzlichen Informationen. |
| type |
string |
Der zusätzliche Informationstyp. |
ErrorDetail
Das Fehlerdetails.
| Name | Typ | Beschreibung |
|---|---|---|
| additionalInfo |
Die zusätzlichen Informationen des Fehlers. |
|
| code |
string |
Der Fehlercode. |
| details |
Die Fehlerdetails. |
|
| message |
string |
Die Fehlermeldung. |
| target |
string |
Das Fehlerziel. |
ErrorResponse
Fehlerantwort
| Name | Typ | Beschreibung |
|---|---|---|
| error |
Das Fehlerobjekt. |
Name
ARM-Verwendungsname
| Name | Typ | Beschreibung |
|---|---|---|
| localizedValue |
string |
Lokalisierter Wert für den Verwendungsnamen. |
| value |
string |
Verwendungsnamewert |
Usage
ARM-Verwendung.
| Name | Typ | Beschreibung |
|---|---|---|
| currentValue |
integer (int32) |
Aktueller Wert der Verwendung. |
| id |
string |
Ressourcen-ID |
| limit |
integer (int32) |
Nutzungsgrenzwert. |
| name |
Ressourcenname. |
|
| requestedLimit |
integer (int32) |
Der angeforderte Grenzwert für die Nutzung. |
| type |
string |
Ressourcentyp. |
| unit |
string |
Verwendungseinheit. |
UsageListResult
Eine Liste der Verwendungen.
| Name | Typ | Beschreibung |
|---|---|---|
| nextLink |
string (uri) |
Der Link zur nächsten Seite der Elemente |
| value |
Usage[] |
Die Nutzungselemente auf dieser Seite |