Partager via


Dns Resolver Domain Lists - Create Or Update

Crée ou met à jour une liste de domaines de programme de résolution DNS.

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

Paramètres URI

Nom Dans Obligatoire Type Description
dnsResolverDomainListName
path True

string

minLength: 1
maxLength: 80
pattern: ^[a-zA-Z0-9]([a-zA-Z0-9_\-]*[a-zA-Z0-9])?$

Nom de la liste de domaines du programme de résolution DNS.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nom du groupe de ressources. Le nom ne respecte pas la casse.

subscriptionId
path True

string (uuid)

ID de l’abonnement cible. La valeur doit être un UUID.

api-version
query True

string

minLength: 1

Version de l’API à utiliser pour cette opération.

En-tête de la demande

Nom Obligatoire Type Description
If-Match

string

ETag de la ressource. Omettez cette valeur pour toujours remplacer la ressource actuelle. Spécifiez la dernière valeur ETag vue pour empêcher le remplacement accidentel des modifications simultanées.

If-None-Match

string

Définissez la valeur « * » pour permettre la création d’une nouvelle ressource, mais pour empêcher la mise à jour d’une ressource existante. D’autres valeurs seront ignorées.

Corps de la demande

Nom Obligatoire Type Description
location True

string

Emplacement géographique où réside la ressource

properties.domains

string[]

Domaines de la liste de domaines. Sera null si l’utilisateur utilise une grande liste de domaines.

tags

object

Balises de ressource.

Réponses

Nom Type Description
200 OK

DnsResolverDomainList

La liste des domaines du résolveur DNS a été mise à jour.

201 Created

DnsResolverDomainList

La liste des domaines du résolveur DNS a été créée.

Other Status Codes

ErrorResponse

Réponse par défaut. Elle sera désérialisée conformément à la définition d’erreur.

Exemples

Upsert DNS resolver domain list with bulk number of domains
Upsert DNS resolver domain list with less than 1000 domains

Upsert DNS resolver domain list with bulk number of domains

Exemple de requête

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

{
  "location": "westus2",
  "tags": {
    "key1": "value1"
  },
  "properties": {}
}

Exemple de réponse

Azure-AsyncOperation: https://management.azure.com/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/locations/westus2/dnsResolverOperationStatuses/asyncOperationId?api-version=2025-05-01
{
  "id": "/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/dnsResolverDomainLists/sampleDnsResolverDomainList",
  "name": "sampleDnsResolverDomainList",
  "type": "Microsoft.Network/dnsResolverDomainLists",
  "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"
  },
  "tags": {
    "key1": "value1"
  },
  "properties": {
    "domainsUrl": "/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/dnsResolverDomainLists/sampleDnsResolverDomainList/bulk",
    "provisioningState": "Succeeded",
    "resourceGuid": "b6b2d964-8588-4e3a-a7fe-8a5b7fe8eca5"
  }
}
Azure-AsyncOperation: https://management.azure.com/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/locations/westus2/dnsResolverOperationStatuses/asyncOperationId?api-version=2025-05-01
{
  "id": "/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/dnsResolverDomainLists/sampleDnsResolverDomainList",
  "name": "sampleDnsResolverDomainList",
  "type": "Microsoft.Network/dnsResolverDomainLists",
  "location": "westus2",
  "etag": "00000000-0000-0000-0000-000000000000",
  "tags": {
    "key1": "value1"
  },
  "properties": {
    "domainsUrl": "/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/dnsResolverDomainLists/sampleDnsResolverDomainList/bulk",
    "provisioningState": "Succeeded",
    "resourceGuid": "b6b2d964-8588-4e3a-a7fe-8a5b7fe8eca5"
  }
}

Upsert DNS resolver domain list with less than 1000 domains

Exemple de requête

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

{
  "location": "westus2",
  "tags": {
    "key1": "value1"
  },
  "properties": {
    "domains": [
      "contoso.com"
    ]
  }
}

Exemple de réponse

Azure-AsyncOperation: https://management.azure.com/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/locations/westus2/dnsResolverOperationStatuses/asyncOperationId?api-version=2025-05-01
{
  "id": "/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/dnsResolverDomainLists/sampleDnsResolverDomainList",
  "name": "sampleDnsResolverDomainList",
  "type": "Microsoft.Network/dnsResolverDomainLists",
  "location": "westus2",
  "etag": "00000000-0000-0000-0000-000000000000",
  "tags": {
    "key1": "value1"
  },
  "properties": {
    "domains": [
      "contoso.com"
    ],
    "provisioningState": "Succeeded",
    "resourceGuid": "b6b2d964-8588-4e3a-a7fe-8a5b7fe8eca5"
  }
}
Azure-AsyncOperation: https://management.azure.com/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/locations/westus2/dnsResolverOperationStatuses/asyncOperationId?api-version=2025-05-01
{
  "id": "/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/dnsResolverDomainLists/sampleDnsResolverDomainList",
  "name": "sampleDnsResolverDomainList",
  "type": "Microsoft.Network/dnsResolverDomainLists",
  "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"
  },
  "tags": {
    "key1": "value1"
  },
  "properties": {
    "domains": [
      "contoso.com"
    ],
    "provisioningState": "Succeeded",
    "resourceGuid": "b6b2d964-8588-4e3a-a7fe-8a5b7fe8eca5"
  }
}

Définitions

Nom Description
createdByType

Type d’identité qui a créé la ressource.

DnsResolverDomainList

Décrit une liste de domaines du programme de résolution DNS.

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

ErrorDetail

Détail de l’erreur.

ErrorResponse

Réponse d’erreur

ProvisioningState

État actuel de l’approvisionnement de la ressource.

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

createdByType

Type d’identité qui a créé la ressource.

Valeur Description
Application
Key
ManagedIdentity
User

DnsResolverDomainList

Décrit une liste de domaines du programme de résolution DNS.

Nom Type Description
etag

string

ETag de la liste des domaines du résolveur DNS.

id

string (arm-id)

ID de ressource complet pour la ressource. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} »

location

string

Emplacement géographique où réside la ressource

name

string

Nom de la ressource

properties.domains

string[]

Domaines de la liste de domaines. Sera null si l’utilisateur utilise une grande liste de domaines.

properties.domainsUrl

string

URL pour le chargement ou le téléchargement en bloc pour les listes de domaines contenant un ensemble plus important de domaines. Il sera renseigné si le domaine est vide ou null.

properties.provisioningState

ProvisioningState

État actuel de l’approvisionnement de la liste des domaines du résolveur DNS. Il s’agit d’une propriété en lecture seule et toute tentative de définition de cette valeur est ignorée.

properties.resourceGuid

string

Propriété resourceGuid de la ressource de liste de domaines du résolveur DNS.

systemData

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

tags

object

Balises de ressource.

type

string

Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom Type Description
info

object

Informations supplémentaires.

type

string

Type d’informations supplémentaire.

ErrorDetail

Détail de l’erreur.

Nom Type Description
additionalInfo

ErrorAdditionalInfo[]

Informations supplémentaires sur l’erreur.

code

string

Code d’erreur.

details

ErrorDetail[]

Détails de l’erreur.

message

string

Message d’erreur.

target

string

Cible d’erreur.

ErrorResponse

Réponse d’erreur

Nom Type Description
error

ErrorDetail

Objet d’erreur.

ProvisioningState

État actuel de l’approvisionnement de la ressource.

Valeur Description
Canceled
Creating
Deleting
Failed
Succeeded
Updating

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom Type Description
createdAt

string (date-time)

Horodatage de la création de ressources (UTC).

createdBy

string

Identité qui a créé la ressource.

createdByType

createdByType

Type d’identité qui a créé la ressource.

lastModifiedAt

string (date-time)

Horodatage de la dernière modification de ressource (UTC)

lastModifiedBy

string

Identité qui a modifié la ressource pour la dernière fois.

lastModifiedByType

createdByType

Type d’identité qui a modifié la ressource pour la dernière fois.