Usages - List By Instance Pool
Obtém todas as métricas de uso do pool de instâncias
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}
Parâmetros do URI
| Name | Em | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
|
instance
|
path | True |
string |
O nome do pool de instâncias a ser recuperado. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas. |
|
subscription
|
path | True |
string (uuid) |
A ID da assinatura de destino. O valor deve ser um UUID. |
|
api-version
|
query | True |
string minLength: 1 |
A versão da API a utilizar para esta operação. |
|
expand
|
query |
boolean |
Parâmetro de solicitação opcional para incluir usos de instâncias gerenciadas no pool de instâncias. |
Respostas
| Name | Tipo | Descrição |
|---|---|---|
| 200 OK |
Operação do Azure concluída com sucesso. |
|
| Other Status Codes |
Uma resposta de erro inesperada. |
Segurança
azure_auth
Azure Active Directory OAuth2 Flow.
Tipo:
oauth2
Fluxo:
implicit
URL de Autorização:
https://login.microsoftonline.com/common/oauth2/authorize
Âmbitos
| Name | Descrição |
|---|---|
| user_impersonation | personificar a sua conta de utilizador |
Exemplos
| List instance pool usages expanded with children. |
| List instance pool usages. |
List instance pool usages expanded with children.
Pedido de amostra
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
Resposta da amostra
{
"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.
Pedido de amostra
GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/instancePools/testIP/usages?api-version=2025-01-01
Resposta da amostra
{
"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"
}
]
}
Definições
| Name | Descrição |
|---|---|
|
Error |
O erro de gerenciamento de recursos informações adicionais. |
|
Error |
O detalhe do erro. |
|
Error |
Resposta de erro |
| Name |
Nome de uso do ARM |
| Usage |
Utilização de ARM. |
|
Usage |
Uma lista de usos. |
ErrorAdditionalInfo
O erro de gerenciamento de recursos informações adicionais.
| Name | Tipo | Descrição |
|---|---|---|
| info |
object |
As informações adicionais. |
| type |
string |
O tipo de informação adicional. |
ErrorDetail
O detalhe do erro.
| Name | Tipo | Descrição |
|---|---|---|
| additionalInfo |
O erro informações adicionais. |
|
| code |
string |
O código de erro. |
| details |
Os detalhes do erro. |
|
| message |
string |
A mensagem de erro. |
| target |
string |
O alvo do erro. |
ErrorResponse
Resposta de erro
| Name | Tipo | Descrição |
|---|---|---|
| error |
O objeto de erro. |
Name
Nome de uso do ARM
| Name | Tipo | Descrição |
|---|---|---|
| localizedValue |
string |
Valor localizado do nome de uso. |
| value |
string |
Valor do nome de uso |
Usage
Utilização de ARM.
| Name | Tipo | Descrição |
|---|---|---|
| currentValue |
integer (int32) |
Valor atual de uso. |
| id |
string |
ID do recurso. |
| limit |
integer (int32) |
Limite de utilização. |
| name |
Nome do recurso. |
|
| requestedLimit |
integer (int32) |
Limite de uso solicitado. |
| type |
string |
Tipo de recurso. |
| unit |
string |
Unidade de utilização. |
UsageListResult
Uma lista de usos.
| Name | Tipo | Descrição |
|---|---|---|
| nextLink |
string (uri) |
O link para a próxima página de itens |
| value |
Usage[] |
Os itens de Utilização nesta página |