Dns Forwarding Rulesets - Delete

Service:

DNS

API Version:

2020-04-01-preview

Usuwa zestaw reguł przesyłania dalej DNS. OSTRZEŻENIE: Tej operacji nie można cofnąć. Wszystkie reguły przesyłania dalej w zestawie reguł zostaną usunięte.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
dnsForwardingRulesetName	path	True	string	Nazwa zestawu reguł przesyłania dalej DNS.
resourceGroupName	path	True	string	Nazwa grupy zasobów. W nazwie jest uwzględniana wielkość liter.
subscriptionId	path	True	string	Identyfikator subskrypcji docelowej.
api-version	query	True	string	Wersja interfejsu API do użycia dla tej operacji.

Nagłówek żądania

Nazwa	Wymagane	Typ	Opis
If-Match		string	Element ETag zasobu. Pomiń tę wartość, aby zawsze zastąpić bieżący zasób. Określ ostatnio widzianą wartość elementu ETag, aby zapobiec przypadkowemu zastąpieniu wszystkich współbieżnych zmian.

Odpowiedzi

Nazwa	Typ	Opis
200 OK		Zestaw reguł przesyłania dalej DNS został usunięty.
202 Accepted		Operacja usuwania zestawu reguł przesyłania dalej DNS została zaakceptowana i zostanie ukończona asynchronicznie.
204 No Content		Nie można odnaleźć zestawu reguł przesyłania dalej DNS.
Other Status Codes	CloudError	Odpowiedź domyślna. Zostanie ona zdeserializowana zgodnie z definicją błędu.

Przykłady

Delete DNS forwarding ruleset

Sample Request

HTTP

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

Java

import com.azure.core.util.Context;

/** Samples for DnsForwardingRulesets Delete. */
public final class Main {
    /*
     * x-ms-original-file: specification/dnsresolver/resource-manager/Microsoft.Network/preview/2020-04-01-preview/examples/DnsForwardingRuleset_Delete.json
     */
    /**
     * Sample code: Delete DNS forwarding ruleset.
     *
     * @param manager Entry point to DnsResolverManager.
     */
    public static void deleteDNSForwardingRuleset(com.azure.resourcemanager.dnsresolver.DnsResolverManager manager) {
        manager
            .dnsForwardingRulesets()
            .delete("sampleResourceGroup", "samplednsForwardingRulesetName", null, Context.NONE);
    }
}

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

Go

package armdnsresolver_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/dnsresolver/armdnsresolver"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/tree/main/specification/dnsresolver/resource-manager/Microsoft.Network/preview/2020-04-01-preview/examples/DnsForwardingRuleset_Delete.json
func ExampleDNSForwardingRulesetsClient_BeginDelete() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	client, err := armdnsresolver.NewDNSForwardingRulesetsClient("abdd4249-9f34-4cc6-8e42-c2e32110603e", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := client.BeginDelete(ctx,
		"sampleResourceGroup",
		"samplednsForwardingRulesetName",
		&armdnsresolver.DNSForwardingRulesetsClientBeginDeleteOptions{IfMatch: nil})
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	_, err = poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %v", err)
	}
}

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

JavaScript

const { DnsResolverManagementClient } = require("@azure/arm-dnsresolver");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Deletes a DNS forwarding ruleset. WARNING: This operation cannot be undone. All forwarding rules within the ruleset will be deleted.
 *
 * @summary Deletes a DNS forwarding ruleset. WARNING: This operation cannot be undone. All forwarding rules within the ruleset will be deleted.
 * x-ms-original-file: specification/dnsresolver/resource-manager/Microsoft.Network/preview/2020-04-01-preview/examples/DnsForwardingRuleset_Delete.json
 */
async function deleteDnsForwardingRuleset() {
  const subscriptionId = "abdd4249-9f34-4cc6-8e42-c2e32110603e";
  const resourceGroupName = "sampleResourceGroup";
  const dnsForwardingRulesetName = "samplednsForwardingRulesetName";
  const credential = new DefaultAzureCredential();
  const client = new DnsResolverManagementClient(credential, subscriptionId);
  const result = await client.dnsForwardingRulesets.beginDeleteAndWait(
    resourceGroupName,
    dnsForwardingRulesetName
  );
  console.log(result);
}

deleteDnsForwardingRuleset().catch(console.error);

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

Sample Response

Status code:

200

Status code:

204

Status code:

202

Location: https://management.azure.com/api/mresolver/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/locations/westus2/dnsResolverOperationResults/asyncOperationId?api-version=2020-04-01-preview
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=2020-04-01-preview

Definicje

Nazwa	Opis
CloudError	Komunikat o błędzie
CloudErrorBody	Treść komunikatu o błędzie

CloudError

Komunikat o błędzie

Nazwa	Typ	Opis
error	CloudErrorBody	Treść komunikatu o błędzie

CloudErrorBody

Treść komunikatu o błędzie

Nazwa	Typ	Opis
code	string	Kod błędu
details	CloudErrorBody[]	Dodatkowe informacje o błędzie
message	string	Opis przyczyny błędu
target	string	Zasób docelowy komunikatu o błędzie