Sdílet prostřednictvím

Usages - List

Služba:
Virtual Networks
Verze rozhraní API:
2025-03-01

Uveďte využití sítě pro předplatné.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Network/locations/{location}/usages?api-version=2025-03-01

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
location
 path True

string

pattern: ^[-\w\._ ]+$

Umístění, kde se dotazuje využití prostředků.
subscriptionId
 path True

string

Přihlašovací údaje předplatného, které jednoznačně identifikují předplatné Microsoft Azure. ID předplatného tvoří součást identifikátoru URI pro každé volání služby.
api-version
 query True

string

Verze rozhraní API klienta.

Odpovědi

Name Typ Description
200 OK

UsagesListResult

Žádost byla úspěšná. Operace vrátí seznam prostředků Usage.
Other Status Codes

CloudError

Chybová odpověď popisující, proč operace selhala.

Zabezpečení

azure_auth

Tok OAuth2 v Azure Active Directory

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name Description
user_impersonation zosobnění uživatelského účtu

Příklady

List usages
List usages spaced location

List usages

Ukázkový požadavek

GET https://management.azure.com/subscriptions/subid/providers/Microsoft.Network/locations/westus/usages?api-version=2025-03-01

Ukázková odpověď

Stavový kód:
200 
{
  "value": [
    {
      "currentValue": 8,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/westus/usages/VirtualNetworks",
      "limit": 50,
      "name": {
        "localizedValue": "Virtual Networks",
        "value": "VirtualNetworks"
      },
      "unit": "Count"
    },
    {
      "currentValue": 3,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/westus/usages/StaticPublicIPAddresses",
      "limit": 20,
      "name": {
        "localizedValue": "Static Public IP Addresses",
        "value": "StaticPublicIPAddresses"
      },
      "unit": "Count"
    },
    {
      "currentValue": 1,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/westus/usages/NetworkSecurityGroups",
      "limit": 100,
      "name": {
        "localizedValue": "Network Security Groups",
        "value": "NetworkSecurityGroups"
      },
      "unit": "Count"
    },
    {
      "currentValue": 8,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/westus/usages/PublicIPAddresses",
      "limit": 60,
      "name": {
        "localizedValue": "Public IP Addresses",
        "value": "PublicIPAddresses"
      },
      "unit": "Count"
    },
    {
      "currentValue": 2,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/westus/usages/NetworkInterfaces",
      "limit": 350,
      "name": {
        "localizedValue": "Network Interfaces",
        "value": "NetworkInterfaces"
      },
      "unit": "Count"
    },
    {
      "currentValue": 2,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/westus/usages/LoadBalancers",
      "limit": 100,
      "name": {
        "localizedValue": "Load Balancers",
        "value": "LoadBalancers"
      },
      "unit": "Count"
    },
    {
      "currentValue": 1,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/westus/usages/ApplicationGateways",
      "limit": 50,
      "name": {
        "localizedValue": "Application Gateways",
        "value": "ApplicationGateways"
      },
      "unit": "Count"
    },
    {
      "currentValue": 0,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/westus/usages/RouteTables",
      "limit": 100,
      "name": {
        "localizedValue": "Route Tables",
        "value": "RouteTables"
      },
      "unit": "Count"
    },
    {
      "currentValue": 0,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/westus/usages/RouteFilters",
      "limit": 1000,
      "name": {
        "localizedValue": "Route Filters",
        "value": "RouteFilters"
      },
      "unit": "Count"
    },
    {
      "currentValue": 0,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/westus/usages/NetworkWatchers",
      "limit": 1,
      "name": {
        "localizedValue": "Network Watchers",
        "value": "NetworkWatchers"
      },
      "unit": "Count"
    },
    {
      "currentValue": 0,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/westus/usages/PacketCaptures",
      "limit": 10,
      "name": {
        "localizedValue": "Packet Captures",
        "value": "PacketCaptures"
      },
      "unit": "Count"
    },
    {
      "currentValue": 0,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/westus/usages/DnsServersPerVirtualNetwork",
      "limit": 9,
      "name": {
        "localizedValue": "DNS servers per Virtual Network",
        "value": "DnsServersPerVirtualNetwork"
      },
      "unit": "Count"
    },
    {
      "currentValue": 0,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/westus/usages/SubnetsPerVirtualNetwork",
      "limit": 1000,
      "name": {
        "localizedValue": "Subnets per Virtual Network",
        "value": "SubnetsPerVirtualNetwork"
      },
      "unit": "Count"
    },
    {
      "currentValue": 0,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/westus/usages/IPConfigurationsPerVirtualNetwork",
      "limit": 4096,
      "name": {
        "localizedValue": "IP Configurations per Virtual Network",
        "value": "IPConfigurationsPerVirtualNetwork"
      },
      "unit": "Count"
    },
    {
      "currentValue": 0,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/westus/usages/PeeringsPerVirtualNetwork",
      "limit": 10,
      "name": {
        "localizedValue": "Peerings per Virtual Network",
        "value": "PeeringsPerVirtualNetwork"
      },
      "unit": "Count"
    },
    {
      "currentValue": 0,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/westus/usages/SecurityRulesPerNetworkSecurityGroup",
      "limit": 200,
      "name": {
        "localizedValue": "Security rules per Network Security Group",
        "value": "SecurityRulesPerNetworkSecurityGroup"
      },
      "unit": "Count"
    },
    {
      "currentValue": 0,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/westus/usages/SecurityRuleAddressesOrPortsPerNetworkSecurityGroup",
      "limit": 2000,
      "name": {
        "localizedValue": "Security rules addresses or ports per Network Security Group",
        "value": "SecurityRuleAddressesOrPortsPerNetworkSecurityGroup"
      },
      "unit": "Count"
    },
    {
      "currentValue": 0,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/westus/usages/InboundRulesPerLoadBalancer",
      "limit": 150,
      "name": {
        "localizedValue": "Inbound Rules per Load Balancer",
        "value": "InboundRulesPerLoadBalancer"
      },
      "unit": "Count"
    },
    {
      "currentValue": 0,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/westus/usages/FrontendIPConfigurationPerLoadBalancer",
      "limit": 10,
      "name": {
        "localizedValue": "Frontend IP Configurations per Load Balancer",
        "value": "FrontendIPConfigurationPerLoadBalancer"
      },
      "unit": "Count"
    },
    {
      "currentValue": 0,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/westus/usages/outboundRulesPerLoadBalancer",
      "limit": 5,
      "name": {
        "localizedValue": "Outbound Rules per Load Balancer",
        "value": "outboundRulesPerLoadBalancer"
      },
      "unit": "Count"
    },
    {
      "currentValue": 0,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/westus/usages/RoutesPerRouteTable",
      "limit": 100,
      "name": {
        "localizedValue": "Routes per Route Table",
        "value": "RoutesPerRouteTable"
      },
      "unit": "Count"
    },
    {
      "currentValue": 0,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/westus/usages/SecondaryIPConfigurationsPerNetworkInterface",
      "limit": 256,
      "name": {
        "localizedValue": "Secondary IP Configurations per Network Interface",
        "value": "SecondaryIPConfigurationsPerNetworkInterface"
      },
      "unit": "Count"
    },
    {
      "currentValue": 0,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/westus/usages/InboundRulesPerNetworkInterface",
      "limit": 500,
      "name": {
        "localizedValue": "Inbound rules per Network Interface",
        "value": "InboundRulesPerNetworkInterface"
      },
      "unit": "Count"
    },
    {
      "currentValue": 0,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/westus/usages/RouteFilterRulesPerRouteFilter",
      "limit": 1,
      "name": {
        "localizedValue": "Route filter rules per Route Filter",
        "value": "RouteFilterRulesPerRouteFilter"
      },
      "unit": "Count"
    },
    {
      "currentValue": 0,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/westus/usages/RouteFiltersPerExpressRouteBgpPeering",
      "limit": 1,
      "name": {
        "localizedValue": "Route filters per Express route BGP Peering",
        "value": "RouteFiltersPerExpressRouteBgpPeering"
      },
      "unit": "Count"
    }
  ]
}

List usages spaced location

Ukázkový požadavek

GET https://management.azure.com/subscriptions/subid/providers/Microsoft.Network/locations/West US/usages?api-version=2025-03-01

Ukázková odpověď

Stavový kód:
200 
{
  "value": [
    {
      "currentValue": 12,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/West US/usages/VirtualNetworks",
      "limit": 50,
      "name": {
        "localizedValue": "Virtual Networks",
        "value": "VirtualNetworks"
      },
      "unit": "Count"
    },
    {
      "currentValue": 1,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/West US/usages/StaticPublicIPAddresses",
      "limit": 20,
      "name": {
        "localizedValue": "Static Public IP Addresses",
        "value": "StaticPublicIPAddresses"
      },
      "unit": "Count"
    },
    {
      "currentValue": 3,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/West US/usages/NetworkSecurityGroups",
      "limit": 100,
      "name": {
        "localizedValue": "Network Security Groups",
        "value": "NetworkSecurityGroups"
      },
      "unit": "Count"
    },
    {
      "currentValue": 12,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/West US/usages/PublicIPAddresses",
      "limit": 60,
      "name": {
        "localizedValue": "Public IP Addresses",
        "value": "PublicIPAddresses"
      },
      "unit": "Count"
    },
    {
      "currentValue": 0,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/West US/usages/PublicIpPrefixes",
      "limit": 2147483647,
      "name": {
        "localizedValue": "Public Ip Prefixes",
        "value": "PublicIpPrefixes"
      },
      "unit": "Count"
    },
    {
      "currentValue": 2,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/West US/usages/NetworkInterfaces",
      "limit": 24000,
      "name": {
        "localizedValue": "Network Interfaces",
        "value": "NetworkInterfaces"
      },
      "unit": "Count"
    },
    {
      "currentValue": 0,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/West US/usages/LoadBalancers",
      "limit": 100,
      "name": {
        "localizedValue": "Load Balancers",
        "value": "LoadBalancers"
      },
      "unit": "Count"
    },
    {
      "currentValue": 3,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/West US/usages/ApplicationGateways",
      "limit": 50,
      "name": {
        "localizedValue": "Application Gateways",
        "value": "ApplicationGateways"
      },
      "unit": "Count"
    },
    {
      "currentValue": 5,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/West US/usages/RouteTables",
      "limit": 100,
      "name": {
        "localizedValue": "Route Tables",
        "value": "RouteTables"
      },
      "unit": "Count"
    },
    {
      "currentValue": 0,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/West US/usages/RouteFilters",
      "limit": 1000,
      "name": {
        "localizedValue": "Route Filters",
        "value": "RouteFilters"
      },
      "unit": "Count"
    },
    {
      "currentValue": 0,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/West US/usages/NetworkWatchers",
      "limit": 1,
      "name": {
        "localizedValue": "Network Watchers",
        "value": "NetworkWatchers"
      },
      "unit": "Count"
    },
    {
      "currentValue": 0,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/West US/usages/PacketCaptures",
      "limit": 100,
      "name": {
        "localizedValue": "Packet Captures",
        "value": "PacketCaptures"
      },
      "unit": "Count"
    },
    {
      "currentValue": 0,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/West US/usages/ApplicationSecurityGroups",
      "limit": 500,
      "name": {
        "localizedValue": "Application Security Groups.",
        "value": "ApplicationSecurityGroups"
      },
      "unit": "Count"
    },
    {
      "currentValue": 0,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/West US/usages/DdosProtectionPlans",
      "limit": 1,
      "name": {
        "localizedValue": "DDoS Protection Plans.",
        "value": "DdosProtectionPlans"
      },
      "unit": "Count"
    },
    {
      "currentValue": 0,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/West US/usages/ServiceEndpointPolicies",
      "limit": 200,
      "name": {
        "localizedValue": "Service Endpoint Policies",
        "value": "ServiceEndpointPolicies"
      },
      "unit": "Count"
    },
    {
      "currentValue": 0,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/West US/usages/NetworkIntentPolicies",
      "limit": 200,
      "name": {
        "localizedValue": "Network Intent Policies",
        "value": "NetworkIntentPolicies"
      },
      "unit": "Count"
    },
    {
      "currentValue": 0,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/West US/usages/DnsServersPerVirtualNetwork",
      "limit": 9,
      "name": {
        "localizedValue": "DNS servers per Virtual Network",
        "value": "DnsServersPerVirtualNetwork"
      },
      "unit": "Count"
    },
    {
      "currentValue": 0,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/West US/usages/SubnetsPerVirtualNetwork",
      "limit": 1000,
      "name": {
        "localizedValue": "Subnets per Virtual Network",
        "value": "SubnetsPerVirtualNetwork"
      },
      "unit": "Count"
    },
    {
      "currentValue": 0,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/West US/usages/IPConfigurationsPerVirtualNetwork",
      "limit": 16384,
      "name": {
        "localizedValue": "IP Configurations per Virtual Network",
        "value": "IPConfigurationsPerVirtualNetwork"
      },
      "unit": "Count"
    },
    {
      "currentValue": 0,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/West US/usages/PeeringsPerVirtualNetwork",
      "limit": 50,
      "name": {
        "localizedValue": "Peerings per Virtual Network",
        "value": "PeeringsPerVirtualNetwork"
      },
      "unit": "Count"
    },
    {
      "currentValue": 0,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/West US/usages/SecurityRulesPerNetworkSecurityGroup",
      "limit": 1000,
      "name": {
        "localizedValue": "Security rules per Network Security Group",
        "value": "SecurityRulesPerNetworkSecurityGroup"
      },
      "unit": "Count"
    },
    {
      "currentValue": 0,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/West US/usages/SecurityRulesPerNetworkIntentPolicy",
      "limit": 100,
      "name": {
        "localizedValue": "Security rules per Network Intent Policy",
        "value": "SecurityRulesPerNetworkIntentPolicy"
      },
      "unit": "Count"
    },
    {
      "currentValue": 0,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/West US/usages/RoutesPerNetworkIntentPolicy",
      "limit": 100,
      "name": {
        "localizedValue": "Routes per Network Intent Policy",
        "value": "RoutesPerNetworkIntentPolicy"
      },
      "unit": "Count"
    },
    {
      "currentValue": 0,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/West US/usages/SecurityRuleAddressesOrPortsPerNetworkSecurityGroup",
      "limit": 2000,
      "name": {
        "localizedValue": "Security rules addresses or ports per Network Security Group",
        "value": "SecurityRuleAddressesOrPortsPerNetworkSecurityGroup"
      },
      "unit": "Count"
    },
    {
      "currentValue": 0,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/West US/usages/InboundRulesPerLoadBalancer",
      "limit": 150,
      "name": {
        "localizedValue": "Inbound Rules per Load Balancer",
        "value": "InboundRulesPerLoadBalancer"
      },
      "unit": "Count"
    },
    {
      "currentValue": 0,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/West US/usages/FrontendIPConfigurationPerLoadBalancer",
      "limit": 10,
      "name": {
        "localizedValue": "Frontend IP Configurations per Load Balancer",
        "value": "FrontendIPConfigurationPerLoadBalancer"
      },
      "unit": "Count"
    },
    {
      "currentValue": 0,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/West US/usages/OutboundRulesPerLoadBalancer",
      "limit": 5,
      "name": {
        "localizedValue": "Outbound Rules per Load Balancer",
        "value": "OutboundRulesPerLoadBalancer"
      },
      "unit": "Count"
    },
    {
      "currentValue": 0,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/West US/usages/RoutesPerRouteTable",
      "limit": 400,
      "name": {
        "localizedValue": "Routes per Route Table",
        "value": "RoutesPerRouteTable"
      },
      "unit": "Count"
    },
    {
      "currentValue": 0,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/West US/usages/SecondaryIPConfigurationsPerNetworkInterface",
      "limit": 256,
      "name": {
        "localizedValue": "Secondary IP Configurations per Network Interface",
        "value": "SecondaryIPConfigurationsPerNetworkInterface"
      },
      "unit": "Count"
    },
    {
      "currentValue": 0,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/West US/usages/InboundRulesPerNetworkInterface",
      "limit": 500,
      "name": {
        "localizedValue": "Inbound rules per Network Interface",
        "value": "InboundRulesPerNetworkInterface"
      },
      "unit": "Count"
    },
    {
      "currentValue": 0,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/West US/usages/RouteFilterRulesPerRouteFilter",
      "limit": 1,
      "name": {
        "localizedValue": "Route filter rules per Route Filter",
        "value": "RouteFilterRulesPerRouteFilter"
      },
      "unit": "Count"
    },
    {
      "currentValue": 0,
      "id": "/subscriptions/subid/providers/Microsoft.Network/locations/West US/usages/RouteFiltersPerExpressRouteBgpPeering",
      "limit": 1,
      "name": {
        "localizedValue": "Route filters per Express route BGP Peering",
        "value": "RouteFiltersPerExpressRouteBgpPeering"
      },
      "unit": "Count"
    }
  ]
}

Definice

Name Description
CloudError

Chybová odpověď ze služby.
CloudErrorBody

Chybová odpověď ze služby.
Usage

Využití síťových prostředků.
UsageName

Názvy použití.
UsagesListResult

Odpověď operace použití seznamu.
UsageUnit

Výčet popisující měrnou jednotku.

CloudError

Objekt

Chybová odpověď ze služby.

Name Typ Description
error

CloudErrorBody

Tělo chyby cloudu.

CloudErrorBody

Objekt

Chybová odpověď ze služby.

Name Typ Description
code

string

Identifikátor chyby. Kódy jsou invariantní a mají být využity programově.
details

CloudErrorBody[]

Seznam dalších podrobností o chybě.
message

string

Zpráva popisující chybu, která má být vhodná pro zobrazení v uživatelském rozhraní.
target

string

Cíl konkrétní chyby. Například název vlastnosti v chybě.

Usage

Objekt

Využití síťových prostředků.

Name Typ Description
currentValue

integer (int64)

Aktuální hodnota využití.
id

string

Identifikátor prostředku.
limit

integer (int64)

Limit použití.
name

UsageName

Název typu použití.
unit

UsageUnit

Výčet popisující měrnou jednotku.

UsageName

Objekt

Názvy použití.

Name Typ Description
localizedValue

string

Lokalizovaný řetězec popisující název prostředku.
value

string

Řetězec popisující název prostředku.

UsagesListResult

Objekt

Odpověď operace použití seznamu.

Name Typ Description
nextLink

string

Adresa URL pro získání další sady výsledků.
value

Usage[]

Seznam využití síťových prostředků.

UsageUnit

Výčet

Výčet popisující měrnou jednotku.

Hodnota Description
Count