Private Zones - Update

Servizio:

DNS

Versione API:

2018-09-01

Aggiornamenti una zona di DNS privato. Non modifica i collegamenti di rete virtuale o i record DNS all'interno della zona.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/privateDnsZones/{privateZoneName}?api-version=2018-09-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
privateZoneName	path	True	string	Nome della zona DNS privato (senza un punto di terminazione).
resourceGroupName	path	True	string	Nome del gruppo di risorse.
subscriptionId	path	True	string	Ottiene le credenziali di sottoscrizione che consentono di identificare in modo univoco la sottoscrizione Microsoft Azure. L'ID sottoscrizione fa parte dell'URI per ogni chiamata di servizio.
api-version	query	True	string	Versione api client.

Intestazione della richiesta

Nome	Necessario	Tipo	Descrizione
If-Match		string	ETag della zona DNS privato. Omettere questo valore per sovrascrivere sempre la zona corrente. Specificare il valore ETag visualizzato per evitare di sovrascrivere accidentalmente eventuali modifiche simultanee.

Corpo della richiesta

Nome	Tipo	Descrizione
etag	string	ETag della zona.
location	string	Area di Azure in cui risiede la risorsa
tags	object	Tag delle risorse.

Risposte

Nome	Tipo	Descrizione
200 OK	PrivateZone	La zona DNS privato è stata aggiornata.
202 Accepted		L'operazione di aggiornamento della zona DNS privato è stata accettata e verrà completata in modo asincrono.
Other Status Codes	CloudError	Risposta predefinita. Verrà deserializzato in base alla definizione errore.

Esempio

PATCH Private DNS Zone

Esempio di richiesta

HTTP

PATCH https://management.azure.com/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com?api-version=2018-09-01

{
  "tags": {
    "key2": "value2"
  }
}

Risposta di esempio

Codice di stato:

200

{
  "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com",
  "name": "privatezone1.com",
  "type": "Microsoft.Network/privateDnsZones",
  "location": "global",
  "etag": "00000000-0000-0000-0000-000000000000",
  "properties": {
    "maxNumberOfRecordSets": 5000,
    "numberOfRecordSets": 1,
    "maxNumberOfVirtualNetworkLinks": 100,
    "numberOfVirtualNetworkLinks": 0,
    "maxNumberOfVirtualNetworkLinksWithRegistration": 50,
    "numberOfVirtualNetworkLinksWithRegistration": 0,
    "provisioningState": "Succeeded"
  },
  "tags": {
    "key2": "value2"
  }
}

Codice di stato:

202

Location: https://management.azure.com/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsOperationResults/asyncOperationId?api-version=2018-09-01
Azure-AsyncOperation: https://management.azure.com/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsOperationStatuses/asyncOperationId?api-version=2018-09-01
Retry-After: 60

Definizioni

Nome	Descrizione
CloudError	Risposta di errore dal servizio.
CloudErrorBody	Risposta di errore dal servizio.
PrivateZone	Descrive una zona DNS privato.
ProvisioningState	Stato di provisioning della risorsa. Si tratta di una proprietà di sola lettura e qualsiasi tentativo di impostare questo valore verrà ignorato.

CloudError

Risposta di errore dal servizio.

Nome	Tipo	Descrizione
error	CloudErrorBody	Corpo dell'errore cloud.

CloudErrorBody

Risposta di errore dal servizio.

Nome	Tipo	Descrizione
code	string	Identificatore dell'errore. I codici sono invarianti e devono essere utilizzati a livello di codice.
details	CloudErrorBody[]	Elenco di dettagli aggiuntivi sull'errore.
message	string	Messaggio che descrive l'errore, che deve essere adatto per la visualizzazione in un'interfaccia utente.
target	string	Destinazione dell'errore specifico. Ad esempio, il nome della proprietà in errore.

PrivateZone

Descrive una zona DNS privato.

Nome	Tipo	Descrizione
etag	string	ETag della zona.
id	string	ID risorsa completo per la risorsa. Esempio: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/privateDnsZones/{privateDnsZoneName}'.
location	string	Area di Azure in cui risiede la risorsa
name	string	nome della risorsa.
properties.maxNumberOfRecordSets	integer	Numero massimo di set di record che è possibile creare in questa zona DNS privato. Si tratta di una proprietà di sola lettura e qualsiasi tentativo di impostare questo valore verrà ignorato.
properties.maxNumberOfVirtualNetworkLinks	integer	Numero massimo di reti virtuali che possono essere collegate a questa zona DNS privato. Si tratta di una proprietà di sola lettura e qualsiasi tentativo di impostare questo valore verrà ignorato.
properties.maxNumberOfVirtualNetworkLinksWithRegistration	integer	Numero massimo di reti virtuali che possono essere collegate a questa zona DNS privato con registrazione abilitata. Si tratta di una proprietà di sola lettura e qualsiasi tentativo di impostare questo valore verrà ignorato.
properties.numberOfRecordSets	integer	Numero corrente di set di record in questa zona DNS privato. Si tratta di una proprietà di sola lettura e qualsiasi tentativo di impostare questo valore verrà ignorato.
properties.numberOfVirtualNetworkLinks	integer	Numero corrente di reti virtuali collegate a questa zona DNS privato. Si tratta di una proprietà di sola lettura e qualsiasi tentativo di impostare questo valore verrà ignorato.
properties.numberOfVirtualNetworkLinksWithRegistration	integer	Numero corrente di reti virtuali collegate a questa zona DNS privato con la registrazione abilitata. Si tratta di una proprietà di sola lettura e qualsiasi tentativo di impostare questo valore verrà ignorato.
properties.provisioningState	ProvisioningState	Stato di provisioning della risorsa. Si tratta di una proprietà di sola lettura e qualsiasi tentativo di impostare questo valore verrà ignorato.
tags	object	Tag delle risorse.
type	string	Tipo di risorsa. Esempio: "Microsoft.Network/privateDnsZones".

ProvisioningState

Stato di provisioning della risorsa. Si tratta di una proprietà di sola lettura e qualsiasi tentativo di impostare questo valore verrà ignorato.

Nome	Tipo	Descrizione
Canceled	string
Creating	string
Deleting	string
Failed	string
Succeeded	string
Updating	string