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 |
---|---|---|---|---|
dns
|
path | True |
string minLength: 1maxLength: 80 pattern: ^[a-zA-Z0-9]([a-zA-Z0-9_\-]*[a-zA-Z0-9])?$ |
Nombre de la lista de dominios de resolución DNS. |
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas. |
subscription
|
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 |
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 |
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 |
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. |
created |
Tipo de identidad que creó el recurso. |
Dns |
Describe una lista de dominios de resolución DNS. |
Dns |
Describe una lista de dominios de resolución de DNS para operaciones UPLOAD o DOWNLOAD masivas. |
Error |
Información adicional sobre el error de administración de recursos. |
Error |
Detalle del error. |
Error |
Respuesta de error |
Provisioning |
El estado de aprovisionamiento actual del recurso. |
system |
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 |
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 |
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 |
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 |
Información adicional del error. |
|
code |
string |
Código de error. |
details |
Detalles del error. |
|
message |
string |
El mensaje de error. |
target |
string |
Destino del error. |
ErrorResponse
Respuesta de error
Nombre | Tipo | Description |
---|---|---|
error |
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 |
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 |
Tipo de identidad que modificó por última vez el recurso. |