Compartir a través de


Dns Resolver Domain Lists - Bulk

Carga o descarga la lista de dominios de una lista de dominios de resolución de DNS desde un vínculo de almacenamiento.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
dnsResolverDomainListName
path True

string

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

Nombre de la lista de dominios de resolución DNS.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.

subscriptionId
path True

string (uuid)

Identificador de la suscripción de destino. El valor debe ser un UUID.

api-version
query True

string

minLength: 1

Versión de la API que se va a usar para esta operación.

Encabezado de la solicitud

Nombre Requerido Tipo Description
If-Match

string

ETag del recurso. Omita este valor para sobrescribir siempre el recurso actual. Especifique el valor de ETag visto por última vez para evitar que se sobrescriba accidentalmente cualquier cambio simultáneo.

If-None-Match

string

Establézcalo en "*" para permitir la creación de un nuevo recurso, pero evitar la actualización de un recurso existente. Se omitirán otros valores.

Cuerpo de la solicitud

Nombre Requerido Tipo Description
properties.action True

Action

La acción que se va a realizar en la solicitud, Cargar o Descargar.

properties.storageUrl True

string

La dirección URL del archivo blob de la cuenta de almacenamiento que se usará en la solicitud de carga o descarga masiva de la lista de dominios de resolución de DNS.

Respuestas

Nombre Tipo Description
200 OK

DnsResolverDomainList

La solicitud masiva de la lista de dominios de resolución DNS se realizó correctamente.

202 Accepted

La operación para cargar/descargar dominios en la lista de dominios de resolución de DNS se ha aceptado y se completará de forma asíncrona.

Encabezados

Location: string

Other Status Codes

ErrorResponse

Respuesta predeterminada. Se deserializará según la definición de error.

Ejemplos

Download DNS resolver domain list domains
Upload DNS resolver domain list domains

Download DNS resolver domain list domains

Solicitud de ejemplo

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"
  }
}

Respuesta de muestra

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

Solicitud de ejemplo

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"
  }
}

Respuesta de muestra

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"
  }
}

Definiciones

Nombre Description
Action

La acción que se va a realizar en la solicitud, Cargar o Descargar.

createdByType

Tipo de identidad que creó el recurso.

DnsResolverDomainList

Describe una lista de dominios de resolución DNS.

DnsResolverDomainListBulk

Describe una lista de dominios de resolución de DNS para operaciones UPLOAD o DOWNLOAD masivas.

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

ErrorDetail

Detalle del error.

ErrorResponse

Respuesta de error

ProvisioningState

El estado de aprovisionamiento actual del recurso.

systemData

Metadatos relativos a la creación y última modificación del recurso.

Action

La acción que se va a realizar en la solicitud, Cargar o Descargar.

Valor Description
Download
Upload

createdByType

Tipo de identidad que creó el recurso.

Valor Description
Application
Key
ManagedIdentity
User

DnsResolverDomainList

Describe una lista de dominios de resolución DNS.

Nombre Tipo Description
etag

string

ETag de la lista de dominios de resolución DNS.

id

string (arm-id)

Identificador de recurso completo para el recurso. Por ejemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

location

string

Ubicación geográfica donde reside el recurso

name

string

Nombre del recurso

properties.domains

string[]

Dominios de la lista de dominios. Será nulo si el usuario está utilizando una lista de dominios grande.

properties.domainsUrl

string

La URL para la carga o descarga masiva de listas de dominios que contienen un conjunto más grande de dominios. Esto se rellenará si domains está vacío o nulo.

properties.provisioningState

ProvisioningState

El estado de aprovisionamiento actual de la lista de dominios de resolución DNS. Se trata de una propiedad de solo lectura y se omitirá cualquier intento de establecer este valor.

properties.resourceGuid

string

La propiedad resourceGuid del recurso de lista de dominios de la resolución DNS.

systemData

systemData

Metadatos relativos a la creación y última modificación del recurso.

tags

object

Etiquetas de recursos.

type

string

Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

DnsResolverDomainListBulk

Describe una lista de dominios de resolución de DNS para operaciones UPLOAD o DOWNLOAD masivas.

Nombre Tipo Description
properties.action

Action

La acción que se va a realizar en la solicitud, Cargar o Descargar.

properties.storageUrl

string

La dirección URL del archivo blob de la cuenta de almacenamiento que se usará en la solicitud de carga o descarga masiva de la lista de dominios de resolución de DNS.

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

Nombre Tipo Description
info

object

Información adicional.

type

string

Tipo de información adicional.

ErrorDetail

Detalle del error.

Nombre Tipo Description
additionalInfo

ErrorAdditionalInfo[]

Información adicional del error.

code

string

Código de error.

details

ErrorDetail[]

Detalles del error.

message

string

El mensaje de error.

target

string

Destino del error.

ErrorResponse

Respuesta de error

Nombre Tipo Description
error

ErrorDetail

Objeto de error.

ProvisioningState

El estado de aprovisionamiento actual del recurso.

Valor Description
Canceled
Creating
Deleting
Failed
Succeeded
Updating

systemData

Metadatos relativos a la creación y última modificación del recurso.

Nombre Tipo Description
createdAt

string (date-time)

Marca de tiempo de creación de recursos (UTC).

createdBy

string

Identidad que creó el recurso.

createdByType

createdByType

Tipo de identidad que creó el recurso.

lastModifiedAt

string (date-time)

Marca de tiempo de la última modificación del recurso (UTC)

lastModifiedBy

string

Identidad que modificó por última vez el recurso.

lastModifiedByType

createdByType

Tipo de identidad que modificó por última vez el recurso.