Record Sets - Update

Služba:: DNS

Verze rozhraní API:: 2018-09-01

Aktualizuje sadu záznamů v rámci zóny privátního DNS.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/privateDnsZones/{privateZoneName}/{recordType}/{relativeRecordSetName}?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)
recordType	path	True	RecordType	Typ záznamu DNS v této sadě záznamů.
relativeRecordSetName	path	True	string	Název sady záznamů vzhledem k názvu zóny.
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	ETag sady záznamů. Tuto hodnotu vynecháte, pokud chcete vždy přepsat aktuální sadu záznamů. Zadejte naposledy zobrazenou hodnotu značky ETag, abyste zabránili náhodnému přepsání souběžných změn.

Text požadavku

Name	Typ	Description
etag	string	ETag sady záznamů.
properties.aRecords	ARecord[]	Seznam záznamů A v sadě záznamů
properties.aaaaRecords	AaaaRecord[]	Seznam záznamů AAAA v sadě záznamů
properties.cnameRecord	CnameRecord	Záznam CNAME v sadě záznamů.
properties.metadata	object	Metadata připojená k sadě záznamů.
properties.mxRecords	MxRecord[]	Seznam záznamů MX v sadě záznamů.
properties.ptrRecords	PtrRecord[]	Seznam záznamů PTR v sadě záznamů
properties.soaRecord	SoaRecord	Záznam SOA v sadě záznamů.
properties.srvRecords	SrvRecord[]	Seznam záznamů SRV v sadě záznamů.
properties.ttl	integer (int64)	Hodnota TTL (time-to-live) záznamů v sadě záznamů.
properties.txtRecords	TxtRecord[]	Seznam záznamů TXT v sadě záznamů.

Odpovědi

Name	Typ	Description
200 OK	RecordSet	Sada záznamů byla aktualizována.
Other Status Codes	CloudError	Výchozí odpověď. Bude deserializován podle definice chyby.

Příklady

PATCH Private DNS Zone A Record Set

PATCH Private DNS Zone AAAA Record Set

PATCH Private DNS Zone CNAME Record Set

PATCH Private DNS Zone MX Record Set

PATCH Private DNS Zone PTR Record Set

PATCH Private DNS Zone SOA Record Set

PATCH Private DNS Zone SRV Record Set

PATCH Private DNS Zone TXT Record Set

PATCH Private DNS Zone A Record Set

Ukázkový požadavek

HTTP

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

{
  "properties": {
    "metadata": {
      "key2": "value2"
    }
  }
}

Ukázková odpověď

Stavový kód:: 200

{
  "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/A/recorda",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "recorda",
  "type": "Microsoft.Network/privateDnsZones/A",
  "properties": {
    "metadata": {
      "key2": "value2"
    },
    "ttl": 3600,
    "fqdn": "recorda.privatezone1.com.",
    "isAutoRegistered": false,
    "aRecords": [
      {
        "ipv4Address": "1.2.3.4"
      }
    ]
  }
}

PATCH Private DNS Zone AAAA Record Set

Ukázkový požadavek

HTTP

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

{
  "properties": {
    "metadata": {
      "key2": "value2"
    }
  }
}

Ukázková odpověď

Stavový kód:: 200

{
  "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/AAAA/recordaaaa",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "recordaaaa",
  "type": "Microsoft.Network/privateDnsZones/AAAA",
  "properties": {
    "metadata": {
      "key2": "value2"
    },
    "ttl": 3600,
    "fqdn": "recordaaaa.privatezone1.com.",
    "isAutoRegistered": false,
    "aaaaRecords": [
      {
        "ipv6Address": "::1"
      }
    ]
  }
}

PATCH Private DNS Zone CNAME Record Set

Ukázkový požadavek

HTTP

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

{
  "properties": {
    "metadata": {
      "key2": "value2"
    }
  }
}

Ukázková odpověď

Stavový kód:: 200

{
  "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/CNAME/recordcname",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "recordcname",
  "type": "Microsoft.Network/privateDnsZones/CNAME",
  "properties": {
    "metadata": {
      "key2": "value2"
    },
    "ttl": 3600,
    "fqdn": "recordcname.privatezone1.com.",
    "isAutoRegistered": false,
    "cnameRecord": {
      "cname": "contoso.com"
    }
  }
}

PATCH Private DNS Zone MX Record Set

Ukázkový požadavek

HTTP

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

{
  "properties": {
    "metadata": {
      "key2": "value2"
    }
  }
}

Ukázková odpověď

Stavový kód:: 200

{
  "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/MX/recordmx",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "recordmx",
  "type": "Microsoft.Network/privateDnsZones/MX",
  "properties": {
    "metadata": {
      "key2": "value2"
    },
    "ttl": 3600,
    "fqdn": "recordmx.privatezone1.com.",
    "isAutoRegistered": false,
    "mxRecords": [
      {
        "preference": 0,
        "exchange": "mail.privatezone1.com"
      }
    ]
  }
}

PATCH Private DNS Zone PTR Record Set

Ukázkový požadavek

HTTP

PATCH https://management.azure.com/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/0.0.127.in-addr.arpa/PTR/1?api-version=2018-09-01

{
  "properties": {
    "metadata": {
      "key2": "value2"
    }
  }
}

Ukázková odpověď

Stavový kód:: 200

{
  "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/0.0.127.in-addr.arpa/PTR/1",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "1",
  "type": "Microsoft.Network/privateDnsZones/PTR",
  "properties": {
    "metadata": {
      "key2": "value2"
    },
    "ttl": 3600,
    "fqdn": "1.0.0.127.in-addr.arpa.",
    "isAutoRegistered": false,
    "ptrRecords": [
      {
        "ptrdname": "localhost"
      }
    ]
  }
}

PATCH Private DNS Zone SOA Record Set

Ukázkový požadavek

HTTP

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

{
  "properties": {
    "metadata": {
      "key2": "value2"
    }
  }
}

Ukázková odpověď

Stavový kód:: 200

{
  "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/SOA/@",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "@",
  "type": "Microsoft.Network/privateDnsZones/SOA",
  "properties": {
    "metadata": {
      "key2": "value2"
    },
    "ttl": 3600,
    "fqdn": "privatezone1.com.",
    "isAutoRegistered": false,
    "soaRecord": {
      "host": "azureprivatedns.net",
      "email": "azureprivatedns-hostmaster.microsoft.com",
      "serialNumber": 1,
      "refreshTime": 3600,
      "retryTime": 300,
      "expireTime": 2419200,
      "minimumTtl": 300
    }
  }
}

PATCH Private DNS Zone SRV Record Set

Ukázkový požadavek

HTTP

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

{
  "properties": {
    "metadata": {
      "key2": "value2"
    }
  }
}

Ukázková odpověď

Stavový kód:: 200

{
  "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/SRV/recordsrv",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "recordsrv",
  "type": "Microsoft.Network/privateDnsZones/SRV",
  "properties": {
    "metadata": {
      "key2": "value2"
    },
    "ttl": 3600,
    "fqdn": "recordsrv.privatezone1.com.",
    "isAutoRegistered": false,
    "srvRecords": [
      {
        "priority": 0,
        "weight": 10,
        "port": 80,
        "target": "contoso.com"
      }
    ]
  }
}

PATCH Private DNS Zone TXT Record Set

Ukázkový požadavek

HTTP

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

{
  "properties": {
    "metadata": {
      "key2": "value2"
    }
  }
}

Ukázková odpověď

Stavový kód:: 200

{
  "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/TXT/recordtxt",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "recordtxt",
  "type": "Microsoft.Network/privateDnsZones/TXT",
  "properties": {
    "metadata": {
      "key2": "value2"
    },
    "ttl": 3600,
    "fqdn": "recordtxt.privatezone1.com.",
    "isAutoRegistered": false,
    "txtRecords": [
      {
        "value": [
          "string1",
          "string2"
        ]
      }
    ]
  }
}

Definice

Name	Description
AaaaRecord	Záznam AAAA.
ARecord	Záznam A.
CloudError	Chybová odpověď ze služby.
CloudErrorBody	Chybová odpověď ze služby.
CnameRecord	Záznam CNAME.
MxRecord	Záznam MX.
PtrRecord	Záznam PTR.
RecordSet	Popisuje sadu záznamů DNS (kolekci záznamů DNS se stejným názvem a typem) v zóně privátního DNS.
RecordType	Typ záznamu DNS v této sadě záznamů.
SoaRecord	Záznam SOA.
SrvRecord	Záznam SRV.
TxtRecord	Záznam TXT.

AaaaRecord

Objekt

Záznam AAAA.

Name	Typ	Description
ipv6Address	string	Adresa IPv6 tohoto záznamu AAAA.

ARecord

Objekt

Záznam A.

Name	Typ	Description
ipv4Address	string	Adresa IPv4 tohoto záznamu A.

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ě.

CnameRecord

Objekt

Záznam CNAME.

Name	Typ	Description
cname	string	Kanonický název tohoto záznamu CNAME.

MxRecord

Objekt

Záznam MX.

Name	Typ	Description
exchange	string	Název domény hostitele pošty pro tento záznam MX.
preference	integer (int32)	Hodnota předvoleb pro tento záznam MX.

PtrRecord

Objekt

Záznam PTR.

Name	Typ	Description
ptrdname	string	Název cílové domény PTR pro tento záznam PTR.

RecordSet

Objekt

Popisuje sadu záznamů DNS (kolekci záznamů DNS se stejným názvem a typem) v zóně privátního DNS.

Name	Typ	Description
etag	string	ETag sady záznamů.
id	string	ID sady záznamů.
name	string	Název sady záznamů.
properties.aRecords	ARecord[]	Seznam záznamů A v sadě záznamů
properties.aaaaRecords	AaaaRecord[]	Seznam záznamů AAAA v sadě záznamů
properties.cnameRecord	CnameRecord	Záznam CNAME v sadě záznamů.
properties.fqdn	string	Plně kvalifikovaný název domény sady záznamů.
properties.isAutoRegistered	boolean	Je sada záznamů automaticky zaregistrovaná v zóně privátního DNS prostřednictvím propojení virtuální sítě?
properties.metadata	object	Metadata připojená k sadě záznamů.
properties.mxRecords	MxRecord[]	Seznam záznamů MX v sadě záznamů.
properties.ptrRecords	PtrRecord[]	Seznam záznamů PTR v sadě záznamů
properties.soaRecord	SoaRecord	Záznam SOA v sadě záznamů.
properties.srvRecords	SrvRecord[]	Seznam záznamů SRV v sadě záznamů.
properties.ttl	integer (int64)	Hodnota TTL (time-to-live) záznamů v sadě záznamů.
properties.txtRecords	TxtRecord[]	Seznam záznamů TXT v sadě záznamů.
type	string	Typ sady záznamů.

RecordType

Výčet

Typ záznamu DNS v této sadě záznamů.

Hodnota	Description
A
AAAA
CNAME
MX
PTR
SOA
SRV
TXT

SoaRecord

Objekt

Záznam SOA.

Name	Typ	Description
email	string	E-mailový kontakt pro tento záznam SOA.
expireTime	integer (int64)	Doba vypršení platnosti tohoto záznamu SOA.
host	string	Název domény autoritativního názvového serveru pro tento záznam SOA.
minimumTtl	integer (int64)	Minimální hodnota pro tento záznam SOA. Podle konvence se používá k určení záporné doby ukládání do mezipaměti.
refreshTime	integer (int64)	Hodnota aktualizace pro tento záznam SOA.
retryTime	integer (int64)	Čas opakování pro tento záznam SOA.
serialNumber	integer (int64)	Sériové číslo pro tento záznam SOA.

SrvRecord

Objekt

Záznam SRV.

Name	Typ	Description
port	integer (int32)	Hodnota portu pro tento záznam SRV.
priority	integer (int32)	Hodnota priority pro tento záznam SRV.
target	string	Název cílové domény pro tento záznam SRV.
weight	integer (int32)	Hodnota váhy pro tento záznam SRV.

TxtRecord

Objekt

Záznam TXT.

Name	Typ	Description
value	string[]	Textová hodnota tohoto záznamu TXT.

Sdílet prostřednictvím

Record Sets - Update

Parametry identifikátoru URI

Hlavička požadavku

Text požadavku

Odpovědi

Příklady

PATCH Private DNS Zone A Record Set

Ukázkový požadavek

Ukázková odpověď

PATCH Private DNS Zone AAAA Record Set

Ukázkový požadavek

Ukázková odpověď

PATCH Private DNS Zone CNAME Record Set

Ukázkový požadavek

Ukázková odpověď

PATCH Private DNS Zone MX Record Set

Ukázkový požadavek

Ukázková odpověď

PATCH Private DNS Zone PTR Record Set

Ukázkový požadavek

Ukázková odpověď

PATCH Private DNS Zone SOA Record Set

Ukázkový požadavek

Ukázková odpověď

PATCH Private DNS Zone SRV Record Set

Ukázkový požadavek

Ukázková odpověď

PATCH Private DNS Zone TXT Record Set

Ukázkový požadavek

Ukázková odpověď

Definice

AaaaRecord

ARecord

CloudError

CloudErrorBody

CnameRecord

MxRecord

PtrRecord

RecordSet

RecordType

SoaRecord

SrvRecord

TxtRecord