Record Sets - Update

Tjänst:: DNS

API-version:: 2018-09-01

Uppdaterar en postuppsättning inom en privat DNS-zon.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
privateZoneName	path	True	string	Namnet på den privata DNS-zonen (utan en avslutande punkt).
recordType	path	True	RecordType	Typ av DNS-post i den här postuppsättningen.
relativeRecordSetName	path	True	string	Namnet på postuppsättningen i förhållande till namnet på zonen.
resourceGroupName	path	True	string	Namnet på resursgruppen.
subscriptionId	path	True	string	Hämtar prenumerationsautentiseringsuppgifter som unikt identifierar Microsoft Azure-prenumeration. Prenumerations-ID:t utgör en del av URI:n för varje tjänstanrop.
api-version	query	True	string	Klient-API-version.

Begärandehuvud

Name	Obligatorisk	Typ	Description
If-Match		string	ETag för postuppsättningen. Utelämna det här värdet för att alltid skriva över den aktuella postuppsättningen. Ange det senast synliga ETag-värdet för att förhindra att samtidiga ändringar skrivs över av misstag.

Begärandetext

Name	Typ	Description
etag	string	ETag för postuppsättningen.
properties.aRecords	ARecord[]	Listan över A-poster i postuppsättningen.
properties.aaaaRecords	AaaaRecord[]	Listan över AAAA-poster i postuppsättningen.
properties.cnameRecord	CnameRecord	CNAME-posten i postuppsättningen.
properties.metadata	object	Metadata som är kopplade till postuppsättningen.
properties.mxRecords	MxRecord[]	Listan över MX-poster i postuppsättningen.
properties.ptrRecords	PtrRecord[]	Listan över PTR-poster i postuppsättningen.
properties.soaRecord	SoaRecord	SOA-posten i postuppsättningen.
properties.srvRecords	SrvRecord[]	Listan över SRV-poster i postuppsättningen.
properties.ttl	integer (int64)	TTL (time-to-live) för posterna i postuppsättningen.
properties.txtRecords	TxtRecord[]	Listan över TXT-poster i postuppsättningen.

Svar

Name	Typ	Description
200 OK	RecordSet	Postuppsättningen har uppdaterats.
Other Status Codes	CloudError	Standardsvar. Den kommer att deserialiseras enligt feldefinitionen.

Exempel

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

Exempelbegäran

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

Exempelsvar

Statuskod:: 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

Exempelbegäran

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

Exempelsvar

Statuskod:: 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

Exempelbegäran

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

Exempelsvar

Statuskod:: 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

Exempelbegäran

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

Exempelsvar

Statuskod:: 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

Exempelbegäran

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

Exempelsvar

Statuskod:: 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

Exempelbegäran

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

Exempelsvar

Statuskod:: 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

Exempelbegäran

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

Exempelsvar

Statuskod:: 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

Exempelbegäran

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

Exempelsvar

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

Definitioner

Name	Description
AaaaRecord	En AAAA-post.
ARecord	En A-post.
CloudError	Ett felsvar från tjänsten.
CloudErrorBody	Ett felsvar från tjänsten.
CnameRecord	En CNAME-post.
MxRecord	En MX-post.
PtrRecord	En PTR-post.
RecordSet	Beskriver en DNS-postuppsättning (en samling DNS-poster med samma namn och typ) i en privat DNS-zon.
RecordType	Typ av DNS-post i den här postuppsättningen.
SoaRecord	En SOA-post.
SrvRecord	En SRV-post.
TxtRecord	En TXT-post.

AaaaRecord

Objekt

En AAAA-post.

Name	Typ	Description
ipv6Address	string	IPv6-adressen för den här AAAA-posten.

ARecord

Objekt

En A-post.

Name	Typ	Description
ipv4Address	string	IPv4-adressen för den här A-posten.

CloudError

Objekt

Ett felsvar från tjänsten.

Name	Typ	Description
error	CloudErrorBody	Molnfeltext.

CloudErrorBody

Objekt

Ett felsvar från tjänsten.

Name	Typ	Description
code	string	En identifierare för felet. Koder är invarianta och är avsedda att användas programmatiskt.
details	CloudErrorBody[]	En lista med ytterligare information om felet.
message	string	Ett meddelande som beskriver felet, avsett att vara lämpligt för visning i ett användargränssnitt.
target	string	Målet för det specifika felet. Till exempel namnet på egenskapen i fel.

CnameRecord

Objekt

En CNAME-post.

Name	Typ	Description
cname	string	Det kanoniska namnet på den här CNAME-posten.

MxRecord

Objekt

En MX-post.

Name	Typ	Description
exchange	string	Domännamnet för e-postvärden för den här MX-posten.
preference	integer (int32)	Inställningsvärdet för den här MX-posten.

PtrRecord

Objekt

En PTR-post.

Name	Typ	Description
ptrdname	string	PTR-måldomännamnet för den här PTR-posten.

RecordSet

Objekt

Beskriver en DNS-postuppsättning (en samling DNS-poster med samma namn och typ) i en privat DNS-zon.

Name	Typ	Description
etag	string	ETag för postuppsättningen.
id	string	ID för postuppsättningen.
name	string	Namnet på postuppsättningen.
properties.aRecords	ARecord[]	Listan över A-poster i postuppsättningen.
properties.aaaaRecords	AaaaRecord[]	Listan över AAAA-poster i postuppsättningen.
properties.cnameRecord	CnameRecord	CNAME-posten i postuppsättningen.
properties.fqdn	string	Fullständigt kvalificerat domännamn för postuppsättningen.
properties.isAutoRegistered	boolean	Registreras postuppsättningen automatiskt i den privata DNS-zonen via en länk till ett virtuellt nätverk?
properties.metadata	object	Metadata som är kopplade till postuppsättningen.
properties.mxRecords	MxRecord[]	Listan över MX-poster i postuppsättningen.
properties.ptrRecords	PtrRecord[]	Listan över PTR-poster i postuppsättningen.
properties.soaRecord	SoaRecord	SOA-posten i postuppsättningen.
properties.srvRecords	SrvRecord[]	Listan över SRV-poster i postuppsättningen.
properties.ttl	integer (int64)	TTL (time-to-live) för posterna i postuppsättningen.
properties.txtRecords	TxtRecord[]	Listan över TXT-poster i postuppsättningen.
type	string	Typ av postuppsättning.

RecordType

Uppräkning

Typ av DNS-post i den här postuppsättningen.

Värde	Description
A
AAAA
CNAME
MX
PTR
SOA
SRV
TXT

SoaRecord

Objekt

En SOA-post.

Name	Typ	Description
email	string	E-postkontakten för den här SOA-posten.
expireTime	integer (int64)	Förfalltid för den här SOA-posten.
host	string	Domännamnet för den auktoritativa namnservern för den här SOA-posten.
minimumTtl	integer (int64)	Minimivärdet för den här SOA-posten. Enligt konventionen används detta för att fastställa varaktigheten för negativ cachelagring.
refreshTime	integer (int64)	Uppdateringsvärdet för den här SOA-posten.
retryTime	integer (int64)	Återförsökstiden för den här SOA-posten.
serialNumber	integer (int64)	Serienumret för den här SOA-posten.

SrvRecord

Objekt

En SRV-post.

Name	Typ	Description
port	integer (int32)	Portvärdet för den här SRV-posten.
priority	integer (int32)	Prioritetsvärdet för den här SRV-posten.
target	string	Måldomännamnet för den här SRV-posten.
weight	integer (int32)	Viktvärdet för den här SRV-posten.

TxtRecord

Objekt

En TXT-post.

Name	Typ	Description
value	string[]	Textvärdet för den här TXT-posten.

Dela via

Record Sets - Update

URI-parametrar

Begärandehuvud

Begärandetext

Svar

Exempel

PATCH Private DNS Zone A Record Set

Exempelbegäran

Exempelsvar

PATCH Private DNS Zone AAAA Record Set

Exempelbegäran

Exempelsvar

PATCH Private DNS Zone CNAME Record Set

Exempelbegäran

Exempelsvar

PATCH Private DNS Zone MX Record Set

Exempelbegäran

Exempelsvar

PATCH Private DNS Zone PTR Record Set

Exempelbegäran

Exempelsvar

PATCH Private DNS Zone SOA Record Set

Exempelbegäran

Exempelsvar

PATCH Private DNS Zone SRV Record Set

Exempelbegäran

Exempelsvar

PATCH Private DNS Zone TXT Record Set

Exempelbegäran

Exempelsvar

Definitioner

AaaaRecord

ARecord

CloudError

CloudErrorBody

CnameRecord

MxRecord

PtrRecord

RecordSet

RecordType

SoaRecord

SrvRecord

TxtRecord