Freigeben über


Dns Resolver Domain Lists - Create Or Update

Erstellt oder aktualisiert eine DNS-Auflösungsdomänenliste.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
dnsResolverDomainListName
path True

string

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

Der Name der DNS-Auflösungsdomänenliste.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.

subscriptionId
path True

string (uuid)

Die ID des Zielabonnements. Der Wert muss eine UUID sein.

api-version
query True

string

minLength: 1

Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Anforderungsheader

Name Erforderlich Typ Beschreibung
If-Match

string

ETag der Ressource. Lassen Sie diesen Wert aus, um die aktuelle Ressource immer zu überschreiben. Geben Sie den zuletzt gesehenen ETag-Wert an, um zu verhindern, dass gleichzeitige Änderungen versehentlich überschrieben werden.

If-None-Match

string

Legen Sie auf '*' fest, damit eine neue Ressource erstellt werden kann, aber um zu verhindern, dass eine vorhandene Ressource aktualisiert wird. Andere Werte werden ignoriert.

Anforderungstext

Name Erforderlich Typ Beschreibung
location True

string

Der geografische Standort, an dem sich die Ressource befindet

properties.domains

string[]

Die Domänen in der Domänenliste. Ist null, wenn der Benutzer eine große Domänenliste verwendet.

tags

object

Ressourcentags.

Antworten

Name Typ Beschreibung
200 OK

DnsResolverDomainList

Die Liste der DNS-Resolverdomänen wurde aktualisiert.

201 Created

DnsResolverDomainList

Die Domänenliste des DNS-Resolvers wurde erstellt.

Other Status Codes

ErrorResponse

Standardantwort. Sie wird gemäß der Fehlerdefinition deserialisiert.

Beispiele

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

Beispielanforderung

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

Beispiel für eine Antwort

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

Beispielanforderung

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

Beispiel für eine Antwort

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

Definitionen

Name Beschreibung
createdByType

Der Identitätstyp, der die Ressource erstellt hat.

DnsResolverDomainList

Beschreibt eine DNS-Auflösungsdomänenliste.

ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

ErrorDetail

Das Fehlerdetails.

ErrorResponse

Fehlerantwort

ProvisioningState

Der aktuelle Bereitstellungsstatus der Ressource.

systemData

Metadaten zur Erstellung und letzten Änderung der Ressource.

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

Wert Beschreibung
Application
Key
ManagedIdentity
User

DnsResolverDomainList

Beschreibt eine DNS-Auflösungsdomänenliste.

Name Typ Beschreibung
etag

string

ETag der DNS-Auflösungsdomänenliste.

id

string (arm-id)

Vollqualifizierte Ressourcen-ID für die Ressource. Z. B. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

location

string

Der geografische Standort, an dem sich die Ressource befindet

name

string

Der Name der Ressource

properties.domains

string[]

Die Domänen in der Domänenliste. Ist null, wenn der Benutzer eine große Domänenliste verwendet.

properties.domainsUrl

string

Die URL für den Massen-Upload oder -Download für Domain-Listen mit einer größeren Anzahl von Domains. Dies wird ausgefüllt, wenn domains leer oder null ist.

properties.provisioningState

ProvisioningState

Der aktuelle Bereitstellungsstatus der DNS-Auflösungsdomänenliste. Dies ist eine schreibgeschützte Eigenschaft, und jeder Versuch, diesen Wert festzulegen, wird ignoriert.

properties.resourceGuid

string

Die resourceGuid-Eigenschaft der DNS-Resolver-Domänenlistenressource.

systemData

systemData

Metadaten zur Erstellung und letzten Änderung der Ressource.

tags

object

Ressourcentags.

type

string

Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name Typ Beschreibung
info

object

Die zusätzlichen Informationen.

type

string

Der zusätzliche Informationstyp.

ErrorDetail

Das Fehlerdetails.

Name Typ Beschreibung
additionalInfo

ErrorAdditionalInfo[]

Die zusätzlichen Informationen des Fehlers.

code

string

Der Fehlercode.

details

ErrorDetail[]

Die Fehlerdetails.

message

string

Die Fehlermeldung.

target

string

Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name Typ Beschreibung
error

ErrorDetail

Das Fehlerobjekt.

ProvisioningState

Der aktuelle Bereitstellungsstatus der Ressource.

Wert Beschreibung
Canceled
Creating
Deleting
Failed
Succeeded
Updating

systemData

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name Typ Beschreibung
createdAt

string (date-time)

Der Zeitstempel der Ressourcenerstellung (UTC).

createdBy

string

Die Identität, die die Ressource erstellt hat.

createdByType

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

lastModifiedAt

string (date-time)

Der Zeitstempel der letzten Änderung der Ressource (UTC)

lastModifiedBy

string

Die Identität, die die Ressource zuletzt geändert hat.

lastModifiedByType

createdByType

Der Identitätstyp, der die Ressource zuletzt geändert hat.