Dns Resolver Domain Lists - Bulk
Télécharge ou télécharge la liste des domaines d’une liste de domaines du résolveur DNS à partir d’un lien de stockage.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsResolverDomainLists/{dnsResolverDomainListName}/bulk?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 |
---|---|---|---|
properties.action | True |
L’action à effectuer dans la demande, Upload ou Download. |
|
properties.storageUrl | True |
string |
URL du fichier d’objet blob du compte de stockage à utiliser dans la demande de chargement ou de téléchargement en bloc de la liste de domaines du résolveur DNS. |
Réponses
Nom | Type | Description |
---|---|---|
200 OK |
La demande en bloc de la liste de domaines du résolveur DNS a réussi. |
|
202 Accepted |
L’opération de chargement/téléchargement de domaines dans la liste de domaines du résolveur DNS a été acceptée et se déroulera de manière asynchrone. En-têtes Location: string |
|
Other Status Codes |
Réponse par défaut. Elle sera désérialisée conformément à la définition d’erreur. |
Exemples
Download DNS resolver domain list domains |
Upload DNS resolver domain list domains |
Download DNS resolver domain list domains
Exemple de requête
POST https://management.azure.com/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/dnsResolverDomainLists/sampleDnsResolverDomainList/bulk?api-version=2025-05-01
{
"properties": {
"action": "Download",
"storageUrl": "https://sampleStorageAccount.blob.core.windows.net/sample-container/sampleBlob.txt?sv=2022-11-02&sr=b&sig=39Up9jzHkxhUIhFEjEh9594DJxe7w6cIRCgOV6ICGS0%3A377&sp=rcw"
}
}
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
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": "2025-04-01T01:01:01.1075056Z",
"lastModifiedByType": "Application",
"lastModifiedAt": "2025-04-02T02:03:01.1974346Z"
},
"tags": {
"key1": "value1"
},
"properties": {
"domains": [],
"provisioningState": "Succeeded",
"resourceGuid": "b6b2d964-8588-4e3a-a7fe-8a5b7fe8eca5"
}
}
Upload DNS resolver domain list domains
Exemple de requête
POST https://management.azure.com/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/dnsResolverDomainLists/sampleDnsResolverDomainList/bulk?api-version=2025-05-01
{
"properties": {
"action": "Upload",
"storageUrl": "https://sampleStorageAccount.blob.core.windows.net/sample-container/sampleBlob.txt?sv=2022-11-02&sr=b&sig=39Up9jzHkxhUIhFEjEh9594DJxe7w6cIRCgOV6ICGS0%3A377&sp=rcw"
}
}
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
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": "2025-05-01T01:01:01.1075056Z",
"lastModifiedByType": "Application",
"lastModifiedAt": "2025-05-02T02:03:01.1974346Z"
},
"tags": {
"key1": "value1"
},
"properties": {
"domains": [],
"provisioningState": "Succeeded",
"resourceGuid": "b6b2d964-8588-4e3a-a7fe-8a5b7fe8eca5"
}
}
Définitions
Nom | Description |
---|---|
Action |
L’action à effectuer dans la demande, Upload ou Download. |
created |
Type d’identité qui a créé la ressource. |
Dns |
Décrit une liste de domaines du programme de résolution DNS. |
Dns |
Décrit une liste de domaines de résolveur DNS pour les opérations de téléchargement ou de téléchargement en bloc. |
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. |
Action
L’action à effectuer dans la demande, Upload ou Download.
Valeur | Description |
---|---|
Download | |
Upload |
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 » |
DnsResolverDomainListBulk
Décrit une liste de domaines de résolveur DNS pour les opérations de téléchargement ou de téléchargement en bloc.
Nom | Type | Description |
---|---|---|
properties.action |
L’action à effectuer dans la demande, Upload ou Download. |
|
properties.storageUrl |
string |
URL du fichier d’objet blob du compte de stockage à utiliser dans la demande de chargement ou de téléchargement en bloc de la liste de domaines du résolveur DNS. |
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. |