Dns Resolvers - Create Or Update

Servizio:: DNS

Versione API:: 2025-05-01

Crea o aggiorna un sistema di risoluzione DNS.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
dnsResolverName	path	True	string	Nome del sistema di risoluzione DNS.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.
subscriptionId	path	True	string (uuid)	ID della sottoscrizione di destinazione. Il valore deve essere un UUID.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Intestazione della richiesta

Nome	Necessario	Tipo	Descrizione
If-Match		string	ETag della risorsa. Omettere questo valore per sovrascrivere sempre la risorsa corrente. Specificare l'ultimo valore ETag visualizzato per impedire la sovrascrittura accidentale di eventuali modifiche simultanee.
If-None-Match		string	Impostare su '*' per consentire la creazione di una nuova risorsa, ma per impedire l'aggiornamento di una risorsa esistente. Gli altri valori verranno ignorati.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
location	True	string	Posizione geografica in cui risiede la risorsa
properties.virtualNetwork	True	SubResource	Riferimento alla rete virtuale. Questa operazione non può essere modificata dopo la creazione.
tags		object	Tag di risorsa.

Risposte

Nome	Tipo	Descrizione
200 OK	DnsResolver	Il resolver DNS è stato aggiornato.
201 Created	DnsResolver	Il resolver DNS è stato creato.
202 Accepted		L'operazione di upsert del resolver DNS è stata accettata e verrà completata in modo asincrono.
Other Status Codes	CloudError	Risposta predefinita. Verrà deserializzato in base alla definizione di errore.

Esempio

Upsert DNS resolver

Esempio di richiesta

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

{
  "tags": {
    "key1": "value1"
  },
  "location": "westus2",
  "properties": {
    "virtualNetwork": {
      "id": "/subscriptions/cbb1387e-4b03-44f2-ad41-58d4677b9873/resourceGroups/virtualNetworkResourceGroup/providers/Microsoft.Network/virtualNetworks/sampleVirtualNetwork"
    }
  }
}


import com.azure.core.management.SubResource;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for DnsResolvers CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/dnsresolver/resource-manager/Microsoft.Network/stable/2025-05-01/examples/DnsResolver_Put.json
     */
    /**
     * Sample code: Upsert DNS resolver.
     * 
     * @param manager Entry point to DnsResolverManager.
     */
    public static void upsertDNSResolver(com.azure.resourcemanager.dnsresolver.DnsResolverManager manager) {
        manager.dnsResolvers().define("sampleDnsResolver").withRegion("westus2")
            .withExistingResourceGroup("sampleResourceGroup")
            .withVirtualNetwork(new SubResource().withId(
                "/subscriptions/cbb1387e-4b03-44f2-ad41-58d4677b9873/resourceGroups/virtualNetworkResourceGroup/providers/Microsoft.Network/virtualNetworks/sampleVirtualNetwork"))
            .withTags(mapOf("key1", "fakeTokenPlaceholder")).create();
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

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_resolver_put.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",
    )

    response = client.dns_resolvers.begin_create_or_update(
        resource_group_name="sampleResourceGroup",
        dns_resolver_name="sampleDnsResolver",
        parameters={
            "location": "westus2",
            "properties": {
                "virtualNetwork": {
                    "id": "/subscriptions/cbb1387e-4b03-44f2-ad41-58d4677b9873/resourceGroups/virtualNetworkResourceGroup/providers/Microsoft.Network/virtualNetworks/sampleVirtualNetwork"
                }
            },
            "tags": {"key1": "value1"},
        },
    ).result()
    print(response)


# x-ms-original-file: specification/dnsresolver/resource-manager/Microsoft.Network/stable/2025-05-01/examples/DnsResolver_Put.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

package armdnsresolver_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"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/blob/d0d3a9b4fe0fce880fded7a617e71f84406bacbd/specification/dnsresolver/resource-manager/Microsoft.Network/stable/2025-05-01/examples/DnsResolver_Put.json
func ExampleDNSResolversClient_BeginCreateOrUpdate() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armdnsresolver.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewDNSResolversClient().BeginCreateOrUpdate(ctx, "sampleResourceGroup", "sampleDnsResolver", armdnsresolver.DNSResolver{
		Location: to.Ptr("westus2"),
		Tags: map[string]*string{
			"key1": to.Ptr("value1"),
		},
		Properties: &armdnsresolver.Properties{
			VirtualNetwork: &armdnsresolver.SubResource{
				ID: to.Ptr("/subscriptions/cbb1387e-4b03-44f2-ad41-58d4677b9873/resourceGroups/virtualNetworkResourceGroup/providers/Microsoft.Network/virtualNetworks/sampleVirtualNetwork"),
			},
		},
	}, &armdnsresolver.DNSResolversClientBeginCreateOrUpdateOptions{IfMatch: nil,
		IfNoneMatch: nil,
	})
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.DNSResolver = armdnsresolver.DNSResolver{
	// 	Name: to.Ptr("sampleDnsResolver"),
	// 	Type: to.Ptr("Microsoft.Network/dnsResolvers"),
	// 	ID: to.Ptr("/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/dnsResolvers/sampleDnsResolver"),
	// 	SystemData: &armdnsresolver.SystemData{
	// 		CreatedAt: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2021-04-01T01:01:01.107Z"); return t}()),
	// 		CreatedByType: to.Ptr(armdnsresolver.CreatedByTypeApplication),
	// 		LastModifiedAt: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2021-04-02T02:03:01.197Z"); return t}()),
	// 		LastModifiedByType: to.Ptr(armdnsresolver.CreatedByTypeApplication),
	// 	},
	// 	Location: to.Ptr("westus2"),
	// 	Tags: map[string]*string{
	// 		"key1": to.Ptr("value1"),
	// 	},
	// 	Etag: to.Ptr("00000000-0000-0000-0000-000000000000"),
	// 	Properties: &armdnsresolver.Properties{
	// 		DNSResolverState: to.Ptr(armdnsresolver.DNSResolverStateConnected),
	// 		ProvisioningState: to.Ptr(armdnsresolver.ProvisioningStateSucceeded),
	// 		ResourceGUID: to.Ptr("b6b2d964-8588-4e3a-a7fe-8a5b7fe8eca5"),
	// 		VirtualNetwork: &armdnsresolver.SubResource{
	// 			ID: to.Ptr("/subscriptions/cbb1387e-4b03-44f2-ad41-58d4677b9873/resourceGroups/virtualNetworkResourceGroup/providers/Microsoft.Network/virtualNetworks/sampleVirtualNetwork"),
	// 		},
	// 	},
	// }
}

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

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

/**
 * This sample demonstrates how to Creates or updates a DNS resolver.
 *
 * @summary Creates or updates a DNS resolver.
 * x-ms-original-file: specification/dnsresolver/resource-manager/Microsoft.Network/stable/2025-05-01/examples/DnsResolver_Put.json
 */
async function upsertDnsResolver() {
  const subscriptionId =
    process.env["DNSRESOLVER_SUBSCRIPTION_ID"] || "abdd4249-9f34-4cc6-8e42-c2e32110603e";
  const resourceGroupName = process.env["DNSRESOLVER_RESOURCE_GROUP"] || "sampleResourceGroup";
  const dnsResolverName = "sampleDnsResolver";
  const parameters = {
    location: "westus2",
    tags: { key1: "value1" },
    virtualNetwork: {
      id: "/subscriptions/cbb1387e-4b03-44f2-ad41-58d4677b9873/resourceGroups/virtualNetworkResourceGroup/providers/Microsoft.Network/virtualNetworks/sampleVirtualNetwork",
    },
  };
  const credential = new DefaultAzureCredential();
  const client = new DnsResolverManagementClient(credential, subscriptionId);
  const result = await client.dnsResolvers.beginCreateOrUpdateAndWait(
    resourceGroupName,
    dnsResolverName,
    parameters,
  );
  console.log(result);
}

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

Risposta di esempio

Codice di stato:: 201

{
  "id": "/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/dnsResolvers/sampleDnsResolver",
  "name": "sampleDnsResolver",
  "type": "Microsoft.Network/dnsResolvers",
  "tags": {
    "key1": "value1"
  },
  "location": "westus2",
  "etag": "00000000-0000-0000-0000-000000000000",
  "properties": {
    "virtualNetwork": {
      "id": "/subscriptions/cbb1387e-4b03-44f2-ad41-58d4677b9873/resourceGroups/virtualNetworkResourceGroup/providers/Microsoft.Network/virtualNetworks/sampleVirtualNetwork"
    },
    "dnsResolverState": "Connected",
    "provisioningState": "Succeeded",
    "resourceGuid": "b6b2d964-8588-4e3a-a7fe-8a5b7fe8eca5"
  }
}

Codice di stato:: 200

{
  "id": "/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/dnsResolvers/sampleDnsResolver",
  "name": "sampleDnsResolver",
  "type": "Microsoft.Network/dnsResolvers",
  "tags": {
    "key1": "value1"
  },
  "location": "westus2",
  "etag": "00000000-0000-0000-0000-000000000000",
  "systemData": {
    "createdByType": "Application",
    "createdAt": "2021-04-01T01:01:01.1075056Z",
    "lastModifiedByType": "Application",
    "lastModifiedAt": "2021-04-02T02:03:01.1974346Z"
  },
  "properties": {
    "virtualNetwork": {
      "id": "/subscriptions/cbb1387e-4b03-44f2-ad41-58d4677b9873/resourceGroups/virtualNetworkResourceGroup/providers/Microsoft.Network/virtualNetworks/sampleVirtualNetwork"
    },
    "dnsResolverState": "Connected",
    "provisioningState": "Succeeded",
    "resourceGuid": "b6b2d964-8588-4e3a-a7fe-8a5b7fe8eca5"
  }
}

Codice di stato:: 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

Definizioni

Nome	Descrizione
CloudError	Messaggio di errore
CloudErrorBody	Corpo di un messaggio di errore
createdByType	Tipo di identità che ha creato la risorsa.
DnsResolver	Descrive un resolver DNS.
DnsResolverState	Stato corrente del sistema di risoluzione DNS. Si tratta di una proprietà di sola lettura e qualsiasi tentativo di impostare questo valore verrà ignorato.
ProvisioningState	Stato di provisioning corrente della risorsa.
SubResource	Riferimento a un'altra risorsa arm.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.

CloudError

Object

Messaggio di errore

Nome	Tipo	Descrizione
error	CloudErrorBody	Corpo del messaggio di errore

CloudErrorBody

Object

Corpo di un messaggio di errore

Nome	Tipo	Descrizione
code	string	Codice di errore
details	CloudErrorBody[]	Informazioni aggiuntive sull'errore
message	string	Descrizione di ciò che ha causato l'errore
target	string	Risorsa di destinazione del messaggio di errore

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
Application
Key
ManagedIdentity
User

DnsResolver

Object

Descrive un resolver DNS.

Nome	Tipo	Descrizione
etag	string	ETag del sistema di risoluzione DNS.
id	string (arm-id)	ID risorsa completo per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Posizione geografica in cui risiede la risorsa
name	string	Nome della risorsa
properties.dnsResolverState	DnsResolverState	Stato corrente del sistema di risoluzione DNS. Si tratta di una proprietà di sola lettura e qualsiasi tentativo di impostare questo valore verrà ignorato.
properties.provisioningState	ProvisioningState	Stato di provisioning corrente del sistema di risoluzione DNS. Si tratta di una proprietà di sola lettura e qualsiasi tentativo di impostare questo valore verrà ignorato.
properties.resourceGuid	string	Proprietà resourceGuid della risorsa resolver DNS.
properties.virtualNetwork	SubResource	Riferimento alla rete virtuale. Questa operazione non può essere modificata dopo la creazione.
systemData	systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
tags	object	Tag di risorsa.
type	string	Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

DnsResolverState

Enumerazione

Stato corrente del sistema di risoluzione DNS. Si tratta di una proprietà di sola lettura e qualsiasi tentativo di impostare questo valore verrà ignorato.

Valore	Descrizione
Connected
Disconnected

ProvisioningState

Enumerazione

Stato di provisioning corrente della risorsa.

Valore	Descrizione
Canceled
Creating
Deleting
Failed
Succeeded
Updating

SubResource

Object

Riferimento a un'altra risorsa arm.

Nome	Tipo	Descrizione
id	string	ID risorsa.

systemData

Object

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string (date-time)	Timestamp della creazione della risorsa (UTC).
createdBy	string	Identità che ha creato la risorsa.
createdByType	createdByType	Tipo di identità che ha creato la risorsa.
lastModifiedAt	string (date-time)	Timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy	string	Identità che ha modificato l'ultima volta la risorsa.
lastModifiedByType	createdByType	Tipo di identità che ha modificato l'ultima volta la risorsa.

Condividi tramite

Dns Resolvers - Create Or Update

Parametri dell'URI

Intestazione della richiesta

Corpo della richiesta

Risposte

Esempio

Upsert DNS resolver

Esempio di richiesta

Risposta di esempio

Definizioni

CloudError

CloudErrorBody

createdByType

DnsResolver

DnsResolverState

ProvisioningState

SubResource

systemData