Dns Forwarding Rulesets - Delete

Dienst:
DNS
API-Version:
2025-05-01

Löscht ein DNS-Weiterleitungsregelnet. WARNUNG: Dieser Vorgang kann nicht rückgängig gemacht werden. Alle Weiterleitungsregeln innerhalb des Regelsets werden gelöscht.

DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsForwardingRulesets/{dnsForwardingRulesetName}?api-version=2025-05-01

URI-Parameter

Name In Erforderlich Typ Beschreibung
dnsForwardingRulesetName
 path True

string

Der Name des DNS-Weiterleitungsregelnets.
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.
subscriptionId
 path True

string (uuid)

Die ID des Zielabonnements. Der Wert muss eine UUID sein.
api-version
 query True

string

minLength: 1

Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Anforderungsheader

Name Erforderlich Typ Beschreibung
if-match

string

ETag der Ressource. Lassen Sie diesen Wert aus, um die aktuelle Ressource immer zu überschreiben. Geben Sie den zuletzt gesehenen ETag-Wert an, um zu verhindern, dass gleichzeitige Änderungen versehentlich überschrieben werden.

Antworten

Name Typ Beschreibung
200 OK

Ressource erfolgreich gelöscht.
202 Accepted

Das Löschen von Ressourcen wird akzeptiert.

Header

  • Location: string
  • Retry-After: integer
204 No Content

Ressource ist nicht vorhanden.
Other Status Codes

CloudError

Unerwartete Fehlerantwort.

Sicherheit

azure_auth

Azure Active Directory 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

Delete DNS forwarding ruleset

Beispielanforderung

DELETE https://management.azure.com/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/dnsForwardingRulesets/samplednsForwardingRulesetName?api-version=2025-05-01

Beispiel für eine Antwort

Statuscode:
200
Statuscode:
202 
Azure-AsyncOperation: https://management.azure.com/api/mresolver/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/locations/westus2/dnsResolverOperationStatuses/asyncOperationId?api-version=2025-05-01
Location: https://management.azure.com/api/mresolver/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/locations/westus2/dnsResolverOperationResults/asyncOperationId?api-version=2025-05-01
Statuscode:
204

Definitionen

Name Beschreibung
CloudError

Fehlermeldung
CloudErrorBody

Der Textkörper einer Fehlermeldung

CloudError

Objekt

Fehlermeldung

Name Typ Beschreibung
error

CloudErrorBody

Der Textkörper der Fehlermeldung

CloudErrorBody

Objekt

Der Textkörper einer Fehlermeldung

Name Typ Beschreibung
code

string

Der Fehlercode
details

CloudErrorBody[]

Zusätzliche Fehlerinformationen
message

string

Eine Beschreibung, was den Fehler verursacht hat
target

string

Die Zielressource der Fehlermeldung