Share via

Usages - List

  • Riferimento
Service:
Virtual Networks
API Version:
2023-09-01

Elencare gli utilizzi di rete per una sottoscrizione.

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
location
 path True

string

Posizione in cui viene eseguita una query sull'utilizzo delle risorse.

Regex pattern: ^[-\w\._ ]+$
subscriptionId
 path True

string

Credenziali della sottoscrizione che identificano in modo univoco la sottoscrizione di Microsoft Azure. L'ID sottoscrizione fa parte dell'URI per ogni chiamata di servizio.
api-version
 query True

string

Versione API client.

Risposte

Nome Tipo Descrizione
200 OK

UsagesListResult

Richiesta completata. L'operazione restituisce un elenco di risorse di utilizzo.
Other Status Codes

CloudError

Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

List usages
List usages spaced location

List usages

Sample Request

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

Sample Response

Status code:
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

Sample Request

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

Sample Response

Status code:
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"
    }
  ]
}

Definizioni

Nome Descrizione
CloudError

Risposta di errore dal servizio.
CloudErrorBody

Risposta di errore dal servizio.
Usage

Utilizzo delle risorse di rete.
UsageName

Nomi di utilizzo.
UsagesListResult

Risposta dell'operazione di utilizzo dell'elenco.
UsageUnit

Enumerazione che descrive l'unità di misura.

CloudError

Risposta di errore dal servizio.

Nome Tipo Descrizione
error

CloudErrorBody

Corpo dell'errore cloud.

CloudErrorBody

Risposta di errore dal servizio.

Nome Tipo Descrizione
code

string

Identificatore dell'errore. I codici sono invarianti e devono essere utilizzati a livello di codice.
details

CloudErrorBody[]

Elenco di dettagli aggiuntivi sull'errore.
message

string

Messaggio che descrive l'errore, che deve essere adatto per la visualizzazione in un'interfaccia utente.
target

string

Destinazione dell'errore specifico. Ad esempio, il nome della proprietà in errore.

Usage

Utilizzo delle risorse di rete.

Nome Tipo Descrizione
currentValue

integer

Valore corrente dell'utilizzo.
id

string

Identificatore di risorsa.
limit

integer

Limite di utilizzo.
name

UsageName

Nome del tipo di utilizzo.
unit

UsageUnit

Enumerazione che descrive l'unità di misura.

UsageName

Nomi di utilizzo.

Nome Tipo Descrizione
localizedValue

string

Stringa localizzata che descrive il nome della risorsa.
value

string

Stringa che descrive il nome della risorsa.

UsagesListResult

Risposta dell'operazione di utilizzo dell'elenco.

Nome Tipo Descrizione
nextLink

string

URL per ottenere il set di risultati successivo.
value

Usage[]

Elenco degli utilizzi delle risorse di rete.

UsageUnit

Enumerazione che descrive l'unità di misura.

Nome Tipo Descrizione
Count

string