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
instancePoolName
path True

string

Der Name des abzurufenden Instanzpools.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.

subscriptionId
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.

expandChildren
query

boolean

Optionaler Anforderungsparameter, um verwaltete Instanzenverwendungen in den Instanzpool einzuschließen.

Antworten

Name Typ Beschreibung
200 OK

UsageListResult

Azure-Operation erfolgreich abgeschlossen.

Other Status Codes

ErrorResponse

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
ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

ErrorDetail

Das Fehlerdetails.

ErrorResponse

Fehlerantwort

Name

ARM-Verwendungsname

Usage

ARM-Verwendung.

UsageListResult

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

ErrorAdditionalInfo[]

Die zusätzlichen Informationen des Fehlers.

code

string

Der Fehlercode.

details

ErrorDetail[]

Die Fehlerdetails.

message

string

Die Fehlermeldung.

target

string

Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name Typ Beschreibung
error

ErrorDetail

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

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