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 |
---|---|---|---|---|
dns
|
path | True |
string minLength: 1maxLength: 80 pattern: ^[a-zA-Z0-9]([a-zA-Z0-9_\-]*[a-zA-Z0-9])?$ |
Der Name der DNS-Auflösungsdomänenliste. |
resource
|
path | True |
string minLength: 1maxLength: 90 |
Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet. |
subscription
|
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 |
Die Liste der DNS-Resolverdomänen wurde aktualisiert. |
|
201 Created |
Die Domänenliste des DNS-Resolvers wurde erstellt. |
|
Other Status Codes |
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 |
---|---|
created |
Der Identitätstyp, der die Ressource erstellt hat. |
Dns |
Beschreibt eine DNS-Auflösungsdomänenliste. |
Error |
Der Ressourcenverwaltungsfehler zusätzliche Informationen. |
Error |
Das Fehlerdetails. |
Error |
Fehlerantwort |
Provisioning |
Der aktuelle Bereitstellungsstatus der Ressource. |
system |
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 |
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 |
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 |
Die zusätzlichen Informationen des Fehlers. |
|
code |
string |
Der Fehlercode. |
details |
Die Fehlerdetails. |
|
message |
string |
Die Fehlermeldung. |
target |
string |
Das Fehlerziel. |
ErrorResponse
Fehlerantwort
Name | Typ | Beschreibung |
---|---|---|
error |
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 |
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 |
Der Identitätstyp, der die Ressource zuletzt geändert hat. |