Partager via


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
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
properties.action True

Action

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

DnsResolverDomainList

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

ErrorResponse

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.

createdByType

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

DnsResolverDomainList

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

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.

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.

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

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 »

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

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

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.