Aracılığıyla paylaş

Record Sets - Update

Hizmet:
DNS
API Sürümü:
2018-09-01

Özel DNS bölgesi içindeki bir kayıt kümesini güncelleştirir.

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

URI Parametreleri

Name İçinde Gerekli Tür Description
privateZoneName
 path True

string

Özel DNS bölgesinin adı (sonlandırıcı nokta olmadan).
recordType
 path True

RecordType

Bu kayıt kümesindeki DNS kaydının türü.
relativeRecordSetName
 path True

string

Kayıt kümesinin adı, bölgenin adına göre.
resourceGroupName
 path True

string

Kaynak grubunun adı.
subscriptionId
 path True

string

Microsoft Azure aboneliğini benzersiz olarak tanımlayan abonelik kimlik bilgilerini alır. Abonelik kimliği, her hizmet çağrısı için URI'nin bir parçasını oluşturur.
api-version
 query True

string

İstemci Api Sürümü.

İstek Başlığı

Name Gerekli Tür Description
If-Match

string

Kayıt kümesinin ETag'i. Geçerli kayıt kümesinin üzerine her zaman yazmak için bu değeri atla. Eşzamanlı değişikliklerin yanlışlıkla üzerine yazılmasını önlemek için son görülen ETag değerini belirtin.

İstek Gövdesi

Name Tür Description
etag

string

Kayıt kümesinin ETag'i.
properties.aRecords

ARecord[]

Kayıt kümesindeki A kayıtlarının listesi.
properties.aaaaRecords

AaaaRecord[]

Kayıt kümesindeki AAAA kayıtlarının listesi.
properties.cnameRecord

CnameRecord

Kayıt kümesindeki CNAME kaydı.
properties.metadata

object

Kayıt kümesine eklenen meta veriler.
properties.mxRecords

MxRecord[]

Kayıt kümesindeki MX kayıtlarının listesi.
properties.ptrRecords

PtrRecord[]

Kayıt kümesindeki PTR kayıtlarının listesi.
properties.soaRecord

SoaRecord

Kayıt kümesindeki SOA kaydı.
properties.srvRecords

SrvRecord[]

Kayıt kümesindeki SRV kayıtlarının listesi.
properties.ttl

integer (int64)

Kayıt kümesindeki kayıtların TTL değeri (yaşam süresi).
properties.txtRecords

TxtRecord[]

Kayıt kümesindeki TXT kayıtlarının listesi.

Yanıtlar

Name Tür Description
200 OK

RecordSet

Kayıt kümesi güncelleştirildi.
Other Status Codes

CloudError

Varsayılan yanıt. Hata tanımına göre seri durumdan çıkarılır.

Örnekler

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

Örnek isteği

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

Örnek yanıt

Durum kodu:
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

Örnek isteği

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

Örnek yanıt

Durum kodu:
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

Örnek isteği

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

Örnek yanıt

Durum kodu:
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

Örnek isteği

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

Örnek yanıt

Durum kodu:
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

Örnek isteği

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

Örnek yanıt

Durum kodu:
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

Örnek isteği

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

Örnek yanıt

Durum kodu:
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

Örnek isteği

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

Örnek yanıt

Durum kodu:
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

Örnek isteği

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

Örnek yanıt

Durum kodu:
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"
        ]
      }
    ]
  }
}

Tanımlar

Name Description
AaaaRecord

AAAA kaydı.
ARecord

A kaydı.
CloudError

Hizmetten bir hata yanıtı.
CloudErrorBody

Hizmetten bir hata yanıtı.
CnameRecord

CNAME kaydı.
MxRecord

Bir MX kaydı.
PtrRecord

PTR kaydı.
RecordSet

Özel DNS bölgesinde bir DNS kayıt kümesini (aynı ad ve türe sahip DNS kayıtları koleksiyonu) açıklar.
RecordType

Bu kayıt kümesindeki DNS kaydının türü.
SoaRecord

SoA kaydı.
SrvRecord

Bir SRV kaydı.
TxtRecord

TXT kaydı.

AaaaRecord

Object

AAAA kaydı.

Name Tür Description
ipv6Address

string

Bu AAAA kaydının IPv6 adresi.

ARecord

Object

A kaydı.

Name Tür Description
ipv4Address

string

Bu A kaydının IPv4 adresi.

CloudError

Object

Hizmetten bir hata yanıtı.

Name Tür Description
error

CloudErrorBody

Bulut hata gövdesi.

CloudErrorBody

Object

Hizmetten bir hata yanıtı.

Name Tür Description
code

string

Hatanın tanımlayıcısı. Kodlar sabittir ve program aracılığıyla kullanılması amaçlanmıştır.
details

CloudErrorBody[]

Hatayla ilgili ek ayrıntıların listesi.
message

string

Hatayı açıklayan ve kullanıcı arabiriminde görüntülenmeye uygun olması amaçlanan bir ileti.
target

string

Belirli bir hatanın hedefi. Örneğin, özelliğin adı hatalı.

CnameRecord

Object

CNAME kaydı.

Name Tür Description
cname

string

Bu CNAME kaydının kurallı adı.

MxRecord

Object

Bir MX kaydı.

Name Tür Description
exchange

string

Bu MX kaydı için posta ana bilgisayarının etki alanı adı.
preference

integer (int32)

Bu MX kaydı için tercih değeri.

PtrRecord

Object

PTR kaydı.

Name Tür Description
ptrdname

string

Bu PTR kaydı için PTR hedef etki alanı adı.

RecordSet

Object

Özel DNS bölgesinde bir DNS kayıt kümesini (aynı ad ve türe sahip DNS kayıtları koleksiyonu) açıklar.

Name Tür Description
etag

string

Kayıt kümesinin ETag'i.
id

string

Kayıt kümesinin kimliği.
name

string

Kayıt kümesinin adı.
properties.aRecords

ARecord[]

Kayıt kümesindeki A kayıtlarının listesi.
properties.aaaaRecords

AaaaRecord[]

Kayıt kümesindeki AAAA kayıtlarının listesi.
properties.cnameRecord

CnameRecord

Kayıt kümesindeki CNAME kaydı.
properties.fqdn

string

Kayıt kümesinin tam etki alanı adı.
properties.isAutoRegistered

boolean

Kayıt kümesi bir sanal ağ bağlantısı üzerinden Özel DNS bölgesine otomatik olarak kaydedildi mi?
properties.metadata

object

Kayıt kümesine eklenen meta veriler.
properties.mxRecords

MxRecord[]

Kayıt kümesindeki MX kayıtlarının listesi.
properties.ptrRecords

PtrRecord[]

Kayıt kümesindeki PTR kayıtlarının listesi.
properties.soaRecord

SoaRecord

Kayıt kümesindeki SOA kaydı.
properties.srvRecords

SrvRecord[]

Kayıt kümesindeki SRV kayıtlarının listesi.
properties.ttl

integer (int64)

Kayıt kümesindeki kayıtların TTL değeri (yaşam süresi).
properties.txtRecords

TxtRecord[]

Kayıt kümesindeki TXT kayıtlarının listesi.
type

string

Kayıt kümesinin türü.

RecordType

Listeleme

Bu kayıt kümesindeki DNS kaydının türü.

Değer Description
A
AAAA
CNAME
MX
PTR
SOA
SRV
TXT

SoaRecord

Object

SoA kaydı.

Name Tür Description
email

string

Bu SOA kaydının e-posta ilgili kişisi.
expireTime

integer (int64)

Bu SOA kaydının süresi doldu.
host

string

Bu SOA kaydı için yetkili ad sunucusunun etki alanı adı.
minimumTtl

integer (int64)

Bu SOA kaydı için en düşük değer. Kural gereği bu, negatif önbelleğe alma süresini belirlemek için kullanılır.
refreshTime

integer (int64)

Bu SOA kaydının yenileme değeri.
retryTime

integer (int64)

Bu SOA kaydı için yeniden deneme süresi.
serialNumber

integer (int64)

Bu SOA kaydının seri numarası.

SrvRecord

Object

Bir SRV kaydı.

Name Tür Description
port

integer (int32)

Bu SRV kaydının bağlantı noktası değeri.
priority

integer (int32)

Bu SRV kaydının öncelik değeri.
target

string

Bu SRV kaydının hedef etki alanı adı.
weight

integer (int32)

Bu SRV kaydının ağırlık değeri.

TxtRecord

Object

TXT kaydı.

Name Tür Description
value

string[]

Bu TXT kaydının metin değeri.