Record Sets - Update

Layanan:: DNS

Versi API:: 2018-09-01

Memperbarui kumpulan catatan dalam zona DNS Privat.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
privateZoneName	path	True	string	Nama zona DNS Privat (tanpa titik penghentian).
recordType	path	True	RecordType	Tipe catatan DNS dalam kumpulan catatan ini.
relativeRecordSetName	path	True	string	Nama kumpulan catatan, relatif terhadap nama zona.
resourceGroupName	path	True	string	Nama grup sumber daya.
subscriptionId	path	True	string	Mendapatkan kredensial langganan yang secara unik mengidentifikasi langganan Microsoft Azure. ID langganan membentuk bagian dari URI untuk setiap panggilan layanan.
api-version	query	True	string	Versi Api Klien.

Header Permintaan

Nama	Diperlukan	Jenis	Deskripsi
If-Match		string	ETag dari kumpulan catatan. Hilangkan nilai ini untuk selalu menimpa kumpulan catatan saat ini. Tentukan nilai ETag yang terakhir dilihat untuk mencegah penimpaan perubahan bersamaan secara tidak sengaja.

Isi Permintaan

Nama	Jenis	Deskripsi
etag	string	ETag dari kumpulan catatan.
properties.aRecords	ARecord[]	Daftar rekaman A dalam kumpulan catatan.
properties.aaaaRecords	AaaaRecord[]	Daftar catatan AAAA dalam kumpulan catatan.
properties.cnameRecord	CnameRecord	Catatan CNAME dalam kumpulan catatan.
properties.metadata	object	Metadata yang dilampirkan ke kumpulan catatan.
properties.mxRecords	MxRecord[]	Daftar catatan MX dalam kumpulan catatan.
properties.ptrRecords	PtrRecord[]	Daftar catatan PTR dalam kumpulan catatan.
properties.soaRecord	SoaRecord	Catatan SOA dalam kumpulan catatan.
properties.srvRecords	SrvRecord[]	Daftar catatan SRV dalam kumpulan catatan.
properties.ttl	integer (int64)	TTL (time-to-live) rekaman dalam kumpulan catatan.
properties.txtRecords	TxtRecord[]	Daftar catatan TXT dalam kumpulan catatan.

Respons

Nama	Jenis	Deskripsi
200 OK	RecordSet	Kumpulan catatan telah diperbarui.
Other Status Codes	CloudError	Respons default. Ini akan dideserialisasi sesuai definisi Kesalahan.

Contoh

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

Permintaan sampel

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

Respon sampel

Kode status:: 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

Permintaan sampel

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

Respon sampel

Kode status:: 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

Permintaan sampel

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

Respon sampel

Kode status:: 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

Permintaan sampel

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

Respon sampel

Kode status:: 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

Permintaan sampel

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

Respon sampel

Kode status:: 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

Permintaan sampel

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

Respon sampel

Kode status:: 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

Permintaan sampel

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

Respon sampel

Kode status:: 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

Permintaan sampel

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

Respon sampel

Kode status:: 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"
        ]
      }
    ]
  }
}

Definisi

Nama	Deskripsi
AaaaRecord	Catatan AAAA.
ARecord	Catatan A.
CloudError	Respons kesalahan dari layanan.
CloudErrorBody	Respons kesalahan dari layanan.
CnameRecord	Catatan CNAME.
MxRecord	Catatan MX.
PtrRecord	Catatan PTR.
RecordSet	Menjelaskan kumpulan catatan DNS (kumpulan catatan DNS dengan nama dan jenis yang sama) di zona DNS Privat.
RecordType	Tipe catatan DNS dalam kumpulan catatan ini.
SoaRecord	Catatan SOA.
SrvRecord	Catatan SRV.
TxtRecord	Catatan TXT.

AaaaRecord

Objek

Catatan AAAA.

Nama	Jenis	Deskripsi
ipv6Address	string	Alamat IPv6 dari catatan AAAA ini.

ARecord

Objek

Catatan A.

Nama	Jenis	Deskripsi
ipv4Address	string	Alamat IPv4 dari catatan A ini.

CloudError

Objek

Respons kesalahan dari layanan.

Nama	Jenis	Deskripsi
error	CloudErrorBody	Isi kesalahan cloud.

CloudErrorBody

Objek

Respons kesalahan dari layanan.

Nama	Jenis	Deskripsi
code	string	Pengidentifikasi untuk kesalahan. Kode invarian dan dimaksudkan untuk dikonsumsi secara terprogram.
details	CloudErrorBody[]	Daftar detail tambahan tentang kesalahan.
message	string	Pesan yang menjelaskan kesalahan, dimaksudkan agar cocok untuk ditampilkan di antarmuka pengguna.
target	string	Target kesalahan tertentu. Misalnya, nama properti dalam kesalahan.

CnameRecord

Objek

Catatan CNAME.

Nama	Jenis	Deskripsi
cname	string	Nama kanonis untuk catatan CNAME ini.

MxRecord

Objek

Catatan MX.

Nama	Jenis	Deskripsi
exchange	string	Nama domain host email untuk catatan MX ini.
preference	integer (int32)	Nilai preferensi untuk catatan MX ini.

PtrRecord

Objek

Catatan PTR.

Nama	Jenis	Deskripsi
ptrdname	string	Nama domain target PTR untuk catatan PTR ini.

RecordSet

Objek

Menjelaskan kumpulan catatan DNS (kumpulan catatan DNS dengan nama dan jenis yang sama) di zona DNS Privat.

Nama	Jenis	Deskripsi
etag	string	ETag dari kumpulan catatan.
id	string	ID kumpulan catatan.
name	string	Nama kumpulan catatan.
properties.aRecords	ARecord[]	Daftar rekaman A dalam kumpulan catatan.
properties.aaaaRecords	AaaaRecord[]	Daftar catatan AAAA dalam kumpulan catatan.
properties.cnameRecord	CnameRecord	Catatan CNAME dalam kumpulan catatan.
properties.fqdn	string	Nama domain yang sepenuhnya memenuhi syarat dari kumpulan catatan.
properties.isAutoRegistered	boolean	Apakah kumpulan catatan terdaftar otomatis di zona DNS Privat melalui tautan jaringan virtual?
properties.metadata	object	Metadata yang dilampirkan ke kumpulan catatan.
properties.mxRecords	MxRecord[]	Daftar catatan MX dalam kumpulan catatan.
properties.ptrRecords	PtrRecord[]	Daftar catatan PTR dalam kumpulan catatan.
properties.soaRecord	SoaRecord	Catatan SOA dalam kumpulan catatan.
properties.srvRecords	SrvRecord[]	Daftar catatan SRV dalam kumpulan catatan.
properties.ttl	integer (int64)	TTL (time-to-live) rekaman dalam kumpulan catatan.
properties.txtRecords	TxtRecord[]	Daftar catatan TXT dalam kumpulan catatan.
type	string	Jenis kumpulan catatan.

RecordType

Enumeration

Tipe catatan DNS dalam kumpulan catatan ini.

Nilai	Deskripsi
A
AAAA
CNAME
MX
PTR
SOA
SRV
TXT

SoaRecord

Objek

Catatan SOA.

Nama	Jenis	Deskripsi
email	string	Kontak email untuk catatan SOA ini.
expireTime	integer (int64)	Waktu kedaluwarsa untuk catatan SOA ini.
host	string	Nama domain server nama otoritatif untuk catatan SOA ini.
minimumTtl	integer (int64)	Nilai minimum untuk catatan SOA ini. Berdasarkan konvensi, ini digunakan untuk menentukan durasi penembolokan negatif.
refreshTime	integer (int64)	Nilai refresh untuk rekaman SOA ini.
retryTime	integer (int64)	Waktu coba lagi untuk rekaman SOA ini.
serialNumber	integer (int64)	Nomor seri untuk rekaman SOA ini.

SrvRecord

Objek

Catatan SRV.

Nama	Jenis	Deskripsi
port	integer (int32)	Nilai port untuk catatan SRV ini.
priority	integer (int32)	Nilai prioritas untuk catatan SRV ini.
target	string	Nama domain target untuk catatan SRV ini.
weight	integer (int32)	Nilai berat untuk catatan SRV ini.

TxtRecord

Objek

Catatan TXT.

Nama	Jenis	Deskripsi
value	string[]	Nilai teks rekaman TXT ini.

Bagikan melalui

Record Sets - Update

Parameter URI

Header Permintaan

Isi Permintaan

Respons

Contoh

PATCH Private DNS Zone A Record Set

Permintaan sampel

Respon sampel

PATCH Private DNS Zone AAAA Record Set

Permintaan sampel

Respon sampel

PATCH Private DNS Zone CNAME Record Set

Permintaan sampel

Respon sampel

PATCH Private DNS Zone MX Record Set

Permintaan sampel

Respon sampel

PATCH Private DNS Zone PTR Record Set

Permintaan sampel

Respon sampel

PATCH Private DNS Zone SOA Record Set

Permintaan sampel

Respon sampel

PATCH Private DNS Zone SRV Record Set

Permintaan sampel

Respon sampel

PATCH Private DNS Zone TXT Record Set

Permintaan sampel

Respon sampel

Definisi

AaaaRecord

ARecord

CloudError

CloudErrorBody

CnameRecord

MxRecord

PtrRecord

RecordSet

RecordType

SoaRecord

SrvRecord

TxtRecord