Virtual Networks - List Usage

Service:

Virtual Networks

API-versie:

2025-05-01

Geeft een overzicht van gebruiksstatistieken.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/usages?api-version=2025-05-01

URI-parameters

Name	In	Vereist	Type	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	De naam van de resourcegroep. De naam is hoofdletterongevoelig.
subscriptionId	path	True	string (uuid)	De id van het doelabonnement. De waarde moet een UUID zijn.
virtualNetworkName	path	True	string	De naam van het virtuele netwerk.
api-version	query	True	string minLength: 1	De API-versie die voor deze bewerking moet worden gebruikt.

Antwoorden

Name	Type	Description
200 OK	VirtualNetworkListUsageResult	Azure-operatie succesvol voltooid.
Other Status Codes	CloudError	Een onverwachte foutreactie.

Beveiliging

azure_auth

OAuth2-stroom voor Azure Active Directory.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

VnetGetUsage

Voorbeeldaanvraag

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/vnetName/usages?api-version=2025-05-01

JavaScript

const { NetworkManagementClient } = require("@azure/arm-network");
const { DefaultAzureCredential } = require("@azure/identity");
require("dotenv/config");

/**
 * This sample demonstrates how to Lists usage stats.
 *
 * @summary Lists usage stats.
 * x-ms-original-file: specification/network/resource-manager/Microsoft.Network/Network/stable/2025-05-01/examples/VirtualNetworkListUsage.json
 */
async function vnetGetUsage() {
  const subscriptionId = process.env["NETWORK_SUBSCRIPTION_ID"] || "subid";
  const resourceGroupName = process.env["NETWORK_RESOURCE_GROUP"] || "rg1";
  const virtualNetworkName = "vnetName";
  const credential = new DefaultAzureCredential();
  const client = new NetworkManagementClient(credential, subscriptionId);
  const resArray = new Array();
  for await (const item of client.virtualNetworks.listUsage(
    resourceGroupName,
    virtualNetworkName,
  )) {
    resArray.push(item);
  }
  console.log(resArray);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Voorbeeldrespons

Statuscode:

200

{
  "value": [
    {
      "name": {
        "localizedValue": "Subnet size and usage",
        "value": "SubnetSpace"
      },
      "currentValue": -1,
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/vnetName/subnets/GatewaySubnet",
      "limit": -1,
      "unit": "Count"
    },
    {
      "name": {
        "localizedValue": "Subnet size and usage",
        "value": "SubnetSpace"
      },
      "currentValue": 2,
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/vnetName/subnets/newSubnet",
      "limit": 3,
      "unit": "Count"
    }
  ]
}

Definities

Name	Description
CloudError	Een foutreactie van de service.
CloudErrorBody	Een foutreactie van de service.
VirtualNetworkListUsageResult	Antwoord voor de getUsage-API-serviceoproep voor virtuele netwerken.
VirtualNetworkUsage	Gebruiksgegevens voor subnet.
VirtualNetworkUsageName	Container voor gebruikstekenreeksen.

CloudError

Object

Een foutreactie van de service.

Name	Type	Description
error	CloudErrorBody	Wolk fout lichaam.

CloudErrorBody

Object

Een foutreactie van de service.

Name	Type	Description
code	string	Een id voor de fout. Codes zijn invariant en zijn bedoeld om programmatisch te worden gebruikt.
details	CloudErrorBody[]	Een lijst met aanvullende details over de fout.
message	string	Een bericht met een beschrijving van de fout, bedoeld om te worden weergegeven in een gebruikersinterface.
target	string	Het doel van de specifieke fout. Bijvoorbeeld de naam van de eigenschap in fout.

VirtualNetworkListUsageResult

Object

Antwoord voor de getUsage-API-serviceoproep voor virtuele netwerken.

Name	Type	Description
nextLink	string (uri)	De koppeling naar de volgende pagina met items
value	VirtualNetworkUsage[]	De VirtualNetworkUsage-items op deze pagina

VirtualNetworkUsage

Object

Gebruiksgegevens voor subnet.

Name	Type	Description
currentValue	number (double)	Geeft het aantal IP's aan dat uit het subnet is gebruikt.
id	string	Subnet-ID.
limit	number (double)	Geeft de grootte van het subnet aan.
name	VirtualNetworkUsageName	De naam die de algemene en gelokaliseerde waarde voor gebruik bevat.
unit	string	Gebruik eenheden. Geeft als resultaat 'Aantal'.

VirtualNetworkUsageName

Object

Container voor gebruikstekenreeksen.

Name	Type	Description
localizedValue	string	Gelokaliseerde subnetgrootte en gebruikstekenreeks.
value	string	Grootte van het subnet en gebruikstekenreeks.