Virtual Network Subnet Usage - Execute

Abrufen der Subnetznutzung für ein virtuelles Netzwerk für eine bestimmte vNet-Ressourcen-ID.

POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.DBforPostgreSQL/locations/{locationName}/checkVirtualNetworkSubnetUsage?api-version=2024-08-01

URI-Parameter

Name In Erforderlich Typ Beschreibung
locationName
path True

string

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

Der Name des Speicherorts.

subscriptionId
path True

string (uuid)

Die ID des Zielabonnements. Der Wert muss eine UUID sein.

api-version
query True

string

minLength: 1

Die API-Version, die für diesen Vorgang verwendet werden soll.

Anforderungstext

Name Typ Beschreibung
virtualNetworkArmResourceId

string

ID der virtuellen Netzwerkressource.

Antworten

Name Typ Beschreibung
200 OK

VirtualNetworkSubnetUsageResult

OKAY

Other Status Codes

ErrorResponse

Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Sicherheit

azure_auth

Microsoft Entra OAuth2-Fluss

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel ihres Benutzerkontos

Beispiele

VirtualNetworkSubnetUsageList

Beispielanforderung

POST https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/westus/checkVirtualNetworkSubnetUsage?api-version=2024-08-01

{
  "virtualNetworkArmResourceId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.Network/virtualNetworks/examplevirtualnetwork"
}

Beispiel für eine Antwort

{
  "delegatedSubnetsUsage": [
    {
      "subnetName": "examplesubnet1",
      "usage": 2
    },
    {
      "subnetName": "examplesubnet2",
      "usage": 3
    }
  ],
  "subscriptionId": "ffffffff-ffff-ffff-ffff-ffffffffffff",
  "location": "westus"
}

Definitionen

Name Beschreibung
DelegatedSubnetUsage

Delegierte Subnetznutzungsdaten.

ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

ErrorDetail

Das Fehlerdetails.

ErrorResponse

Fehlerantwort

VirtualNetworkSubnetUsageParameter

Parameter für die Subnetznutzung im virtuellen Netzwerk

VirtualNetworkSubnetUsageResult

Subnetznutzungsdaten für virtuelle Netzwerke.

DelegatedSubnetUsage

Delegierte Subnetznutzungsdaten.

Name Typ Beschreibung
subnetName

string

Name des delegierten Subnetzes, für das IP-Adressen verwendet werden

usage

integer (int64)

Anzahl der IP-Adressen, die vom delegierten Subnetz verwendet werden

ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name Typ Beschreibung
info

object

Die zusätzlichen Informationen.

type

string

Der zusätzliche Informationstyp.

ErrorDetail

Das Fehlerdetails.

Name Typ Beschreibung
additionalInfo

ErrorAdditionalInfo[]

Die zusätzlichen Informationen des Fehlers.

code

string

Der Fehlercode.

details

ErrorDetail[]

Die Fehlerdetails.

message

string

Die Fehlermeldung.

target

string

Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name Typ Beschreibung
error

ErrorDetail

Das Fehlerobjekt.

VirtualNetworkSubnetUsageParameter

Parameter für die Subnetznutzung im virtuellen Netzwerk

Name Typ Beschreibung
virtualNetworkArmResourceId

string

ID der virtuellen Netzwerkressource.

VirtualNetworkSubnetUsageResult

Subnetznutzungsdaten für virtuelle Netzwerke.

Name Typ Beschreibung
delegatedSubnetsUsage

DelegatedSubnetUsage[]

Delegierte Subnetznutzungsdaten.

location

string

Speicherort der delegierten Subnetznutzung

subscriptionId

string

subscriptionId der delegierten Subnetznutzung