Dns Forwarding Rulesets - Delete

Serviço:: DNS

Versão da API:: 2025-05-01

Exclui um conjunto de regras de encaminhamento de DNS. AVISO: Esta operação não pode ser desfeita. Todas as regras de encaminhamento dentro do conjunto de regras serão excluídas.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
dnsForwardingRulesetName	path	True	string	O nome do conjunto de regras de encaminhamento DNS.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
subscriptionId	path	True	string (uuid)	A ID da assinatura de destino. O valor deve ser uma UUID.
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.

Cabeçalho da solicitação

Nome	Obrigatório	Tipo	Description
If-Match		string	ETag do recurso. Omita esse valor para sempre substituir o recurso atual. Especifique o valor da ETag vista pela última vez para evitar a substituição acidental de alterações simultâneas.

Respostas

Nome	Tipo	Description
200 OK		O conjunto de regras de encaminhamento de DNS foi excluído.
202 Accepted		A operação para excluir o conjunto de regras de encaminhamento de DNS foi aceita e será concluída de forma assíncrona.
204 No Content		O conjunto de regras de encaminhamento DNS não foi encontrado.
Other Status Codes	CloudError	Resposta padrão. Ele será desserializado de acordo com a definição de erro.

Exemplos

Delete DNS forwarding ruleset

Solicitação de exemplo

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


/**
 * Samples for DnsForwardingRulesets Delete.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/dnsresolver/resource-manager/Microsoft.Network/stable/2025-05-01/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,
            com.azure.core.util.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

from azure.identity import DefaultAzureCredential

from azure.mgmt.dnsresolver import DnsResolverManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-dnsresolver
# USAGE
    python dns_forwarding_ruleset_delete.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = DnsResolverManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="abdd4249-9f34-4cc6-8e42-c2e32110603e",
    )

    client.dns_forwarding_rulesets.begin_delete(
        resource_group_name="sampleResourceGroup",
        dns_forwarding_ruleset_name="samplednsForwardingRulesetName",
    ).result()


# x-ms-original-file: specification/dnsresolver/resource-manager/Microsoft.Network/stable/2025-05-01/examples/DnsForwardingRuleset_Delete.json
if __name__ == "__main__":
    main()

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

Resposta de exemplo

Código de status:: 200

Código de status:: 204

Código de status:: 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=2025-05-01
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

Definições

Nome	Description
CloudError	Uma mensagem de erro
CloudErrorBody	O corpo de uma mensagem de erro

CloudError

Objeto

Uma mensagem de erro

Nome	Tipo	Description
error	CloudErrorBody	O corpo da mensagem de erro

CloudErrorBody