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 |
---|---|---|---|---|
dns
|
path | True |
string minLength: 1maxLength: 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. |
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nom du groupe de ressources. Le nom ne respecte pas la casse. |
subscription
|
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 |
La liste des domaines du résolveur DNS a été mise à jour. |
|
201 Created |
La liste des domaines du résolveur DNS a été créée. |
|
Other Status Codes |
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 |
---|---|
created |
Type d’identité qui a créé la ressource. |
Dns |
Décrit une liste de domaines du programme de résolution DNS. |
Error |
Informations supplémentaires sur l’erreur de gestion des ressources. |
Error |
Détail de l’erreur. |
Error |
Réponse d’erreur |
Provisioning |
État actuel de l’approvisionnement de la ressource. |
system |
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 |
É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 |
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 |
Informations supplémentaires sur l’erreur. |
|
code |
string |
Code d’erreur. |
details |
Détails de l’erreur. |
|
message |
string |
Message d’erreur. |
target |
string |
Cible d’erreur. |
ErrorResponse
Réponse d’erreur
Nom | Type | Description |
---|---|---|
error |
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 |
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 |
Type d’identité qui a modifié la ressource pour la dernière fois. |