你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Usages - List

获取指定范围的所有资源的当前使用情况列表。

GET https://management.azure.com/{scope}/providers/Microsoft.Quota/usages?api-version=2023-02-01

URI 参数

名称 必需 类型 说明
scope
path True

string

目标 Azure 资源 URI。 例如 /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/qms-test/providers/Microsoft.Batch/batchAccounts/testAccount/。 这是 List GET 操作的目标 Azure 资源 URI。 如果在 之后/quotas添加 ,{resourceName}则它是特定资源 GET 操作中的目标 Azure 资源 URI。

api-version
query True

string

要用于此操作的 API 版本。

响应

名称 类型 说明
200 OK

UsagesLimits

没问题。 使用分页的响应中将返回使用情况信息。

标头

ETag: string

Other Status Codes

ExceptionResponse

描述操作失败原因的错误响应。

安全性

azure_auth

Azure Active Directory OAuth 2.0 授权

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称 说明
user_impersonation 模拟用户帐户。

示例

Quotas_listUsagesForCompute
Quotas_listUsagesForNetwork
Quotas_listUsagesMachineLearningServices

Quotas_listUsagesForCompute

示例请求

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Compute/locations/eastus/providers/Microsoft.Quota/usages?api-version=2023-02-01

示例响应

{
  "value": [
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Compute/locations/eastus/providers/Microsoft.Quota/Usages/standardFSv2Family",
      "type": "Microsoft.Quota/Usages",
      "name": "standardFSv2Family",
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "isQuotaApplicable": true,
        "name": {
          "value": "standardFSv2Family",
          "localizedValue": "Standard FSv2 Family vCPUs"
        }
      }
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Compute/locations/eastus/providers/Microsoft.Quota/Usages/standardNDSFamily",
      "type": "Microsoft.Quota/Usages",
      "name": "standardNDSFamily",
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "isQuotaApplicable": true,
        "name": {
          "value": "standardNDSFamily",
          "localizedValue": "Standard NDS Family vCPUs"
        }
      }
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Compute/locations/eastus/providers/Microsoft.Quota/Usages/standardNCSv2Family",
      "type": "Microsoft.Quota/Usages",
      "name": "standardNCSv2Family",
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "isQuotaApplicable": true,
        "name": {
          "value": "standardNCSv2Family",
          "localizedValue": "Standard NCSv2 Family vCPUs"
        }
      }
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Compute/locations/eastus/providers/Microsoft.Quota/Usages/standardNCSv3Family",
      "type": "Microsoft.Quota/Usages",
      "name": "standardNCSv3Family",
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "isQuotaApplicable": true,
        "name": {
          "value": "standardNCSv3Family",
          "localizedValue": "Standard NCSv3 Family vCPUs"
        }
      }
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Compute/locations/eastus/providers/Microsoft.Quota/Usages/standardLSv2Family",
      "type": "Microsoft.Quota/Usages",
      "name": "standardLSv2Family",
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "isQuotaApplicable": true,
        "name": {
          "value": "standardLSv2Family",
          "localizedValue": "Standard LSv2 Family vCPUs"
        }
      }
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Compute/locations/eastus/providers/Microsoft.Quota/Usages/standardPBSFamily",
      "type": "Microsoft.Quota/Usages",
      "name": "standardPBSFamily",
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "isQuotaApplicable": true,
        "name": {
          "value": "standardPBSFamily",
          "localizedValue": "Standard PBS Family vCPUs"
        }
      }
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Compute/locations/eastus/providers/Microsoft.Quota/Usages/standardEIv3Family",
      "type": "Microsoft.Quota/Usages",
      "name": "standardEIv3Family",
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "isQuotaApplicable": true,
        "name": {
          "value": "standardEIv3Family",
          "localizedValue": "Standard EIv3 Family vCPUs"
        }
      }
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Compute/locations/eastus/providers/Microsoft.Quota/Usages/standardEISv3Family",
      "type": "Microsoft.Quota/Usages",
      "name": "standardEISv3Family",
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "isQuotaApplicable": true,
        "name": {
          "value": "standardEISv3Family",
          "localizedValue": "Standard EISv3 Family vCPUs"
        }
      }
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Compute/locations/eastus/providers/Microsoft.Quota/Usages/standardDCSFamily",
      "type": "Microsoft.Quota/Usages",
      "name": "standardDCSFamily",
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "isQuotaApplicable": true,
        "name": {
          "value": "standardDCSFamily",
          "localizedValue": "Standard DCS Family vCPUs"
        }
      }
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Compute/locations/eastus/providers/Microsoft.Quota/Usages/standardNVSv2Family",
      "type": "Microsoft.Quota/Usages",
      "name": "standardNVSv2Family",
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "isQuotaApplicable": true,
        "name": {
          "value": "standardNVSv2Family",
          "localizedValue": "Standard NVSv2 Family vCPUs"
        }
      }
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Compute/locations/eastus/providers/Microsoft.Quota/Usages/standardMSv2Family",
      "type": "Microsoft.Quota/Usages",
      "name": "standardMSv2Family",
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "isQuotaApplicable": true,
        "name": {
          "value": "standardMSv2Family",
          "localizedValue": "Standard MSv2 Family vCPUs"
        }
      }
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Compute/locations/eastus/providers/Microsoft.Quota/Usages/availabilitySets",
      "type": "Microsoft.Quota/Usages",
      "name": "availabilitySets",
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "isQuotaApplicable": false,
        "name": {
          "value": "availabilitySets",
          "localizedValue": "Availability Sets"
        }
      }
    }
  ],
  "nextLink": ""
}

Quotas_listUsagesForNetwork

示例请求

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/locations/eastus/providers/Microsoft.Quota/usages?api-version=2023-02-01

示例响应

{
  "value": [
    {
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "name": {
          "value": "VirtualNetworks",
          "localizedValue": "Virtual Networks"
        },
        "properties": {},
        "isQuotaApplicable": false
      },
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/locations/eastus/providers/Microsoft.Quota/usages/",
      "type": "Microsoft.Quota/usages",
      "name": "VirtualNetworks"
    },
    {
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "name": {
          "value": "StaticPublicIPAddresses",
          "localizedValue": "Static Public IP Addresses"
        },
        "properties": {},
        "isQuotaApplicable": false
      },
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/locations/eastus/providers/Microsoft.Quota/usages/",
      "type": "Microsoft.Quota/usages",
      "name": "StaticPublicIPAddresses"
    },
    {
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "name": {
          "value": "NetworkSecurityGroups",
          "localizedValue": "Network Security Groups"
        },
        "properties": {},
        "isQuotaApplicable": false
      },
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/locations/eastus/providers/Microsoft.Quota/usages/",
      "type": "Microsoft.Quota/usages",
      "name": "NetworkSecurityGroups"
    },
    {
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "name": {
          "value": "PublicIPAddresses",
          "localizedValue": "Public IP Addresses - Basic"
        },
        "isQuotaApplicable": true,
        "resourceType": "PublicIpAddresses",
        "properties": {}
      },
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/locations/eastus/providers/Microsoft.Quota/usages/",
      "type": "Microsoft.Quota/usages",
      "name": "PublicIPAddresses"
    },
    {
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "name": {
          "value": "PublicIpPrefixes",
          "localizedValue": "Public Ip Prefixes"
        },
        "properties": {},
        "isQuotaApplicable": false
      },
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/locations/eastus/providers/Microsoft.Quota/usages/",
      "type": "Microsoft.Quota/usages",
      "name": "PublicIpPrefixes"
    },
    {
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "name": {
          "value": "NatGateways",
          "localizedValue": "Nat Gateways"
        },
        "properties": {},
        "isQuotaApplicable": false
      },
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/locations/eastus/providers/Microsoft.Quota/usages/",
      "type": "Microsoft.Quota/usages",
      "name": "NatGateways"
    },
    {
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "name": {
          "value": "NetworkInterfaces",
          "localizedValue": "Network Interfaces"
        },
        "properties": {},
        "isQuotaApplicable": false
      },
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/locations/eastus/providers/Microsoft.Quota/usages/",
      "type": "Microsoft.Quota/usages",
      "name": "NetworkInterfaces"
    },
    {
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "name": {
          "value": "PrivateEndpoints",
          "localizedValue": "Private Endpoints"
        },
        "properties": {},
        "isQuotaApplicable": false
      },
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/locations/eastus/providers/Microsoft.Quota/usages/",
      "type": "Microsoft.Quota/usages",
      "name": "PrivateEndpoints"
    },
    {
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "name": {
          "value": "PrivateEndpointRedirectMaps",
          "localizedValue": "Private Endpoint Redirect Maps"
        },
        "properties": {},
        "isQuotaApplicable": false
      },
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/locations/eastus/providers/Microsoft.Quota/usages/",
      "type": "Microsoft.Quota/usages",
      "name": "PrivateEndpointRedirectMaps"
    },
    {
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "name": {
          "value": "LoadBalancers",
          "localizedValue": "Load Balancers"
        },
        "properties": {},
        "isQuotaApplicable": false
      },
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/locations/eastus/providers/Microsoft.Quota/usages/",
      "type": "Microsoft.Quota/usages",
      "name": "LoadBalancers"
    },
    {
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "name": {
          "value": "PrivateLinkServices",
          "localizedValue": "Private Link Services"
        },
        "properties": {},
        "isQuotaApplicable": false
      },
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/locations/eastus/providers/Microsoft.Quota/usages/",
      "type": "Microsoft.Quota/usages",
      "name": "PrivateLinkServices"
    },
    {
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "name": {
          "value": "ApplicationGateways",
          "localizedValue": "Application Gateways"
        },
        "properties": {},
        "isQuotaApplicable": false
      },
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/locations/eastus/providers/Microsoft.Quota/usages/",
      "type": "Microsoft.Quota/usages",
      "name": "ApplicationGateways"
    },
    {
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "name": {
          "value": "RouteTables",
          "localizedValue": "Route Tables"
        },
        "properties": {},
        "isQuotaApplicable": false
      },
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/locations/eastus/providers/Microsoft.Quota/usages/",
      "type": "Microsoft.Quota/usages",
      "name": "RouteTables"
    },
    {
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "name": {
          "value": "RouteFilters",
          "localizedValue": "Route Filters"
        },
        "properties": {},
        "isQuotaApplicable": false
      },
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/locations/eastus/providers/Microsoft.Quota/usages/",
      "type": "Microsoft.Quota/usages",
      "name": "RouteFilters"
    },
    {
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "name": {
          "value": "NetworkWatchers",
          "localizedValue": "Network Watchers"
        },
        "properties": {},
        "isQuotaApplicable": false
      },
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/locations/eastus/providers/Microsoft.Quota/usages/",
      "type": "Microsoft.Quota/usages",
      "name": "NetworkWatchers"
    },
    {
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "name": {
          "value": "PacketCaptures",
          "localizedValue": "Packet Captures"
        },
        "properties": {},
        "isQuotaApplicable": false
      },
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/locations/eastus/providers/Microsoft.Quota/usages/",
      "type": "Microsoft.Quota/usages",
      "name": "PacketCaptures"
    },
    {
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "name": {
          "value": "ApplicationSecurityGroups",
          "localizedValue": "Application Security Groups."
        },
        "properties": {},
        "isQuotaApplicable": false
      },
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/locations/eastus/providers/Microsoft.Quota/usages/",
      "type": "Microsoft.Quota/usages",
      "name": "ApplicationSecurityGroups"
    },
    {
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "name": {
          "value": "StandardSkuLoadBalancers",
          "localizedValue": "Standard Sku Load Balancers"
        },
        "properties": {},
        "isQuotaApplicable": false
      },
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/locations/eastus/providers/Microsoft.Quota/usages/",
      "type": "Microsoft.Quota/usages",
      "name": "StandardSkuLoadBalancers"
    },
    {
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "name": {
          "value": "StandardSkuPublicIpAddresses",
          "localizedValue": "Public IP Addresses - Standard"
        },
        "isQuotaApplicable": true,
        "resourceType": "PublicIpAddresses"
      },
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/locations/eastus/providers/Microsoft.Quota/usages/",
      "type": "Microsoft.Quota/usages",
      "name": "StandardSkuPublicIpAddresses"
    },
    {
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "name": {
          "value": "DnsServersPerVirtualNetwork",
          "localizedValue": "DNS servers per Virtual Network"
        },
        "properties": {},
        "isQuotaApplicable": false
      },
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/locations/eastus/providers/Microsoft.Quota/usages/",
      "type": "Microsoft.Quota/usages",
      "name": "DnsServersPerVirtualNetwork"
    },
    {
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "name": {
          "value": "MinPublicIpInterNetworkPrefixLength",
          "localizedValue": "Min Public Ip InterNetwork Prefix Length"
        },
        "properties": {},
        "isQuotaApplicable": true
      },
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/locations/eastus/providers/Microsoft.Quota/usages/",
      "type": "Microsoft.Quota/usages",
      "name": "MinPublicIpInterNetworkPrefixLength"
    }
  ]
}

Quotas_listUsagesMachineLearningServices

示例请求

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.MachineLearningServices/locations/eastus/providers/Microsoft.Quota/usages?api-version=2023-02-01

示例响应

{
  "value": [
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.MachineLearningServices/locations/eastus/providers/Microsoft.Quota/usages/standardDv2Family",
      "type": "Microsoft.Quota/usages",
      "name": "standardDv2Family",
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "name": {
          "value": "standardDv2Family",
          "localizedValue": "Standard Dv2 Family vCPUs"
        },
        "resourceType": "dedicated"
      }
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.MachineLearningServices/locations/eastus/providers/Microsoft.Quota/usages/totalLowPriorityCores",
      "type": "Microsoft.Quota/usages",
      "name": "totalLowPriorityCores",
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "name": {
          "value": "totalLowPriorityCores",
          "localizedValue": "Total Regional Low-priority vCPUs"
        },
        "resourceType": "lowPriority"
      }
    }
  ]
}

定义

名称 说明
CurrentUsagesBase

资源使用情况。

ExceptionResponse

错误。

ResourceName

资源提供程序提供的资源的名称。 请求配额时,请使用此属性名称。

ServiceError

API 错误详细信息。

ServiceErrorDetail

错误详细信息。

UsagesLimits

配额限制。

UsagesObject

资源使用情况值。

UsagesProperties

指定资源的使用情况属性。

usagesTypes

配额或用法限制类型。

CurrentUsagesBase

资源使用情况。

名称 类型 说明
id

string

资源 ID。

name

string

资源名称。

properties

UsagesProperties

指定资源的使用情况属性。

type

string

资源类型。

ExceptionResponse

错误。

名称 类型 说明
error

ServiceError

API 错误详细信息。

ResourceName

资源提供程序提供的资源的名称。 请求配额时,请使用此属性名称。

名称 类型 说明
localizedValue

string

资源显示名称。

value

string

资源名称。

ServiceError

API 错误详细信息。

名称 类型 说明
code

string

错误代码。

details

ServiceErrorDetail[]

错误详细信息列表。

message

string

错误消息。

ServiceErrorDetail

错误详细信息。

名称 类型 说明
code

string

错误代码。

message

string

错误消息。

UsagesLimits

配额限制。

名称 类型 说明
nextLink

string

用于提取下一页配额限制的 URI。 如果没有更多页,则为 null。

value

CurrentUsagesBase[]

配额限制列表。

UsagesObject

资源使用情况值。

名称 类型 说明
usagesType

usagesTypes

配额或用法限制类型。

value

integer

使用情况值。

UsagesProperties

指定资源的使用情况属性。

名称 类型 说明
isQuotaApplicable

boolean

指出是否可以请求此资源的配额。

name

ResourceName

资源提供程序提供的资源名称。 请求配额时,请使用此属性名称。

properties

object

特定资源提供程序的其他属性。

quotaPeriod

string

配额使用情况值摘要的时间段。 例如:*P1D (每一天) *PT1M (每一分钟) *PT1S (每秒) 。 此参数是可选的,因为它不适用于所有资源(例如计算)。

resourceType

string

资源类型的名称。 可选字段。

unit

string

配额使用情况的单位,例如 Count 和 Bytes。 请求配额时,请在 PUT 操作的请求正文中使用 GET 响应中返回的 单位 值。

usages

UsagesObject

此资源的配额限制属性。

usagesTypes

配额或用法限制类型。

名称 类型 说明
Combined

string

Individual

string