Private Zones - Update

Služba:

DNS

Verze rozhraní API:

2018-09-01

Aktualizuje privátní zónu DNS. Neupravuje propojení virtuální sítě ani záznamy DNS v rámci zóny.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
privateZoneName	path	True	string	Název zóny privátního DNS (bez ukončující tečky)
resourceGroupName	path	True	string	Název skupiny prostředků.
subscriptionId	path	True	string	Získá přihlašovací údaje předplatného, které jednoznačně identifikují předplatné Microsoft Azure. ID předplatného tvoří součást identifikátoru URI pro každé volání služby.
api-version	query	True	string	Verze rozhraní API klienta.

Hlavička požadavku

Name	Vyžadováno	Typ	Description
If-Match		string	Značky ETag zóny privátního DNS. Tuto hodnotu vynecháte, pokud chcete aktuální zónu vždy přepsat. Zadejte naposledy zobrazenou hodnotu značky ETag, abyste zabránili náhodnému přepsání jakýchkoli souběžných změn.

Text požadavku

Name	Typ	Description
etag	string	ETag zóny.
location	string	Oblast Azure, ve které se prostředek nachází
tags	object	Značky prostředků

Odpovědi

Name	Typ	Description
200 OK	PrivateZone	Aktualizovala se zóna privátního DNS.
202 Accepted		Byla přijata operace aktualizace privátní zóny DNS a bude dokončena asynchronně.
Other Status Codes	CloudError	Výchozí odpověď. Bude deserializován podle definice chyby.

Příklady

PATCH Private DNS Zone

Ukázkový požadavek

HTTP

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

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

Ukázková odpověď

Stavový kód:

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

Stavový kód:

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

Definice

Name	Description
CloudError	Chybová odpověď ze služby.
CloudErrorBody	Chybová odpověď ze služby.
PrivateZone	Popisuje privátní zónu DNS.
ProvisioningState	Stav zřizování prostředku. Toto je vlastnost jen pro čtení a všechny pokusy o nastavení této hodnoty budou ignorovány.

CloudError

Objekt

Chybová odpověď ze služby.

Name	Typ	Description
error	CloudErrorBody	Text chyby cloudu.

CloudErrorBody

Objekt

Chybová odpověď ze služby.

Name	Typ	Description
code	string	Identifikátor chyby. Kódy jsou invariantní a mají být využity programově.
details	CloudErrorBody[]	Seznam dalších podrobností o chybě
message	string	Zpráva popisující chybu, která má být vhodná pro zobrazení v uživatelském rozhraní.
target	string	Cíl konkrétní chyby. Například název vlastnosti v chybě.

PrivateZone

Objekt

Popisuje privátní zónu DNS.

Name	Typ	Description
etag	string	ETag zóny.
id	string	Plně kvalifikované ID prostředku pro prostředek. Příklad : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/privateDnsZones/{privateDnsZoneName}.
location	string	Oblast Azure, ve které se prostředek nachází
name	string	Název prostředku
properties.maxNumberOfRecordSets	integer (int64)	Maximální počet sad záznamů, které lze vytvořit v této zóně privátního DNS. Toto je vlastnost jen pro čtení a všechny pokusy o nastavení této hodnoty budou ignorovány.
properties.maxNumberOfVirtualNetworkLinks	integer (int64)	Maximální počet virtuálních sítí, které lze propojit s touto zónou privátního DNS. Toto je vlastnost jen pro čtení a všechny pokusy o nastavení této hodnoty budou ignorovány.
properties.maxNumberOfVirtualNetworkLinksWithRegistration	integer (int64)	Maximální počet virtuálních sítí, které lze propojit s touto zónou privátního DNS s povolenou registrací. Toto je vlastnost jen pro čtení a všechny pokusy o nastavení této hodnoty budou ignorovány.
properties.numberOfRecordSets	integer (int64)	Aktuální počet sad záznamů v této zóně privátního DNS. Toto je vlastnost jen pro čtení a všechny pokusy o nastavení této hodnoty budou ignorovány.
properties.numberOfVirtualNetworkLinks	integer (int64)	Aktuální počet virtuálních sítí propojených s touto zónou privátního DNS. Toto je vlastnost jen pro čtení a všechny pokusy o nastavení této hodnoty budou ignorovány.
properties.numberOfVirtualNetworkLinksWithRegistration	integer (int64)	Aktuální počet virtuálních sítí propojených s touto zónou privátního DNS s povolenou registrací. Toto je vlastnost jen pro čtení a všechny pokusy o nastavení této hodnoty budou ignorovány.
properties.provisioningState	ProvisioningState	Stav zřizování prostředku. Toto je vlastnost jen pro čtení a všechny pokusy o nastavení této hodnoty budou ignorovány.
tags	object	Značky prostředků
type	string	Typ prostředku. Příklad : Microsoft.Network/privateDnsZones.

ProvisioningState

Výčet

Stav zřizování prostředku. Toto je vlastnost jen pro čtení a všechny pokusy o nastavení této hodnoty budou ignorovány.

Hodnota	Description
Canceled
Creating
Deleting
Failed
Succeeded
Updating