Record Sets - Update

Usługa:: DNS

Wersja interfejsu API:: 2018-09-01

Aktualizuje zestaw rekordów w prywatnej strefie DNS.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
privateZoneName	path	True	string	Nazwa prywatnej strefy DNS (bez kropki zakończenia).
recordType	path	True	RecordType	Typ rekordu DNS w tym zestawie rekordów.
relativeRecordSetName	path	True	string	Nazwa zestawu rekordów względem nazwy strefy.
resourceGroupName	path	True	string	Nazwa grupy zasobów.
subscriptionId	path	True	string	Pobiera poświadczenia subskrypcji, które jednoznacznie identyfikują subskrypcję platformy Microsoft Azure. Identyfikator subskrypcji stanowi część identyfikatora URI dla każdego wywołania usługi.
api-version	query	True	string	Wersja interfejsu API klienta.

Nagłówek żądania

Nazwa	Wymagane	Typ	Opis
If-Match		string	Element ETag zestawu rekordów. Pomiń tę wartość, aby zawsze zastępować bieżący zestaw rekordów. Określ ostatnio widzianą wartość elementu ETag, aby zapobiec przypadkowemu zastępowaniu współbieżnych zmian.

Treść żądania

Nazwa	Typ	Opis
etag	string	Element ETag zestawu rekordów.
properties.aRecords	ARecord[]	Lista rekordów A w zestawie rekordów.
properties.aaaaRecords	AaaaRecord[]	Lista rekordów usługi AAAA w zestawie rekordów.
properties.cnameRecord	CnameRecord	Rekord CNAME w zestawie rekordów.
properties.metadata	object	Metadane dołączone do zestawu rekordów.
properties.mxRecords	MxRecord[]	Lista rekordów MX w zestawie rekordów.
properties.ptrRecords	PtrRecord[]	Lista rekordów PTR w zestawie rekordów.
properties.soaRecord	SoaRecord	Rekord SOA w zestawie rekordów.
properties.srvRecords	SrvRecord[]	Lista rekordów SRV w zestawie rekordów.
properties.ttl	integer (int64)	Czas wygaśnięcia (czas wygaśnięcia) rekordów w zestawie rekordów.
properties.txtRecords	TxtRecord[]	Lista rekordów TXT w zestawie rekordów.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	RecordSet	Zestaw rekordów został zaktualizowany.
Other Status Codes	CloudError	Odpowiedź domyślna. Zostanie on zdeserializowany zgodnie z definicją Błędu.

Przykłady

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

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:: 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

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:: 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

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:: 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

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:: 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

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:: 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

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:: 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

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:: 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

Przykładowe żądanie

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

Przykładowa odpowiedź

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

Definicje

Nazwa	Opis
AaaaRecord	Rekord AAAAA.
ARecord	Rekord A.
CloudError	Odpowiedź na błąd z usługi.
CloudErrorBody	Odpowiedź na błąd z usługi.
CnameRecord	Rekord CNAME.
MxRecord	Rekord MX.
PtrRecord	Rekord PTR.
RecordSet	Opisuje zestaw rekordów DNS (kolekcję rekordów DNS o tej samej nazwie i typie) w prywatnej strefie DNS.
RecordType	Typ rekordu DNS w tym zestawie rekordów.
SoaRecord	Rekord SOA.
SrvRecord	Rekord SRV.
TxtRecord	Rekord TXT.

AaaaRecord

Objekt

Rekord AAAAA.

Nazwa	Typ	Opis
ipv6Address	string	Adres IPv6 tego rekordu AAAA.

ARecord

Objekt

Rekord A.

Nazwa	Typ	Opis
ipv4Address	string	Adres IPv4 tego rekordu A.

CloudError

Objekt

Odpowiedź na błąd z usługi.

Nazwa	Typ	Opis
error	CloudErrorBody	Treść błędu chmury.

CloudErrorBody

Objekt

Odpowiedź na błąd z usługi.

Nazwa	Typ	Opis
code	string	Identyfikator błędu. Kody są niezmienne i mają być używane programowo.
details	CloudErrorBody[]	Lista dodatkowych szczegółów dotyczących błędu.
message	string	Komunikat opisujący błąd, który ma być odpowiedni do wyświetlania w interfejsie użytkownika.
target	string	Element docelowy określonego błędu. Na przykład nazwa właściwości w błędzie.

CnameRecord

Objekt

Rekord CNAME.

Nazwa	Typ	Opis
cname	string	Nazwa kanoniczna dla tego rekordu CNAME.

MxRecord

Objekt

Rekord MX.

Nazwa	Typ	Opis
exchange	string	Nazwa domeny hosta poczty dla tego rekordu MX.
preference	integer (int32)	Wartość preferencji dla tego rekordu MX.

PtrRecord

Objekt

Rekord PTR.

Nazwa	Typ	Opis
ptrdname	string	Nazwa domeny docelowej PTR dla tego rekordu PTR.

RecordSet

Objekt

Opisuje zestaw rekordów DNS (kolekcję rekordów DNS o tej samej nazwie i typie) w prywatnej strefie DNS.

Nazwa	Typ	Opis
etag	string	Element ETag zestawu rekordów.
id	string	Identyfikator zestawu rekordów.
name	string	Nazwa zestawu rekordów.
properties.aRecords	ARecord[]	Lista rekordów A w zestawie rekordów.
properties.aaaaRecords	AaaaRecord[]	Lista rekordów usługi AAAA w zestawie rekordów.
properties.cnameRecord	CnameRecord	Rekord CNAME w zestawie rekordów.
properties.fqdn	string	W pełni kwalifikowana nazwa domeny zestawu rekordów.
properties.isAutoRegistered	boolean	Czy zestaw rekordów jest automatycznie zarejestrowany w prywatnej strefie DNS za pośrednictwem łącza sieci wirtualnej?
properties.metadata	object	Metadane dołączone do zestawu rekordów.
properties.mxRecords	MxRecord[]	Lista rekordów MX w zestawie rekordów.
properties.ptrRecords	PtrRecord[]	Lista rekordów PTR w zestawie rekordów.
properties.soaRecord	SoaRecord	Rekord SOA w zestawie rekordów.
properties.srvRecords	SrvRecord[]	Lista rekordów SRV w zestawie rekordów.
properties.ttl	integer (int64)	Czas wygaśnięcia (czas wygaśnięcia) rekordów w zestawie rekordów.
properties.txtRecords	TxtRecord[]	Lista rekordów TXT w zestawie rekordów.
type	string	Typ zestawu rekordów.

RecordType

Wyliczanie

Typ rekordu DNS w tym zestawie rekordów.

Wartość	Opis
A
AAAA
CNAME
MX
PTR
SOA
SRV
TXT

SoaRecord

Objekt

Rekord SOA.

Nazwa	Typ	Opis
email	string	Kontakt e-mail dla tego rekordu SOA.
expireTime	integer (int64)	Czas wygaśnięcia tego rekordu SOA.
host	string	Nazwa domeny serwera nazw autorytatywnych dla tego rekordu SOA.
minimumTtl	integer (int64)	Minimalna wartość tego rekordu SOA. Zgodnie z konwencją służy do określania ujemnego czasu trwania buforowania.
refreshTime	integer (int64)	Wartość odświeżania dla tego rekordu SOA.
retryTime	integer (int64)	Czas ponawiania próby dla tego rekordu SOA.
serialNumber	integer (int64)	Numer seryjny dla tego rekordu SOA.

SrvRecord

Objekt

Rekord SRV.

Nazwa	Typ	Opis
port	integer (int32)	Wartość portu dla tego rekordu SRV.
priority	integer (int32)	Wartość priorytetu dla tego rekordu SRV.
target	string	Nazwa domeny docelowej dla tego rekordu SRV.
weight	integer (int32)	Wartość wagi dla tego rekordu SRV.

TxtRecord

Objekt

Rekord TXT.

Nazwa	Typ	Opis
value	string[]	Wartość tekstowa tego rekordu TXT.

Udostępnij za pośrednictwem

Record Sets - Update

Parametry identyfikatora URI

Nagłówek żądania

Treść żądania

Odpowiedzi

Przykłady

PATCH Private DNS Zone A Record Set

Przykładowe żądanie

Przykładowa odpowiedź

PATCH Private DNS Zone AAAA Record Set

Przykładowe żądanie

Przykładowa odpowiedź

PATCH Private DNS Zone CNAME Record Set

Przykładowe żądanie

Przykładowa odpowiedź

PATCH Private DNS Zone MX Record Set

Przykładowe żądanie

Przykładowa odpowiedź

PATCH Private DNS Zone PTR Record Set

Przykładowe żądanie

Przykładowa odpowiedź

PATCH Private DNS Zone SOA Record Set

Przykładowe żądanie

Przykładowa odpowiedź

PATCH Private DNS Zone SRV Record Set

Przykładowe żądanie

Przykładowa odpowiedź

PATCH Private DNS Zone TXT Record Set

Przykładowe żądanie

Przykładowa odpowiedź

Definicje

AaaaRecord

ARecord

CloudError

CloudErrorBody

CnameRecord

MxRecord

PtrRecord

RecordSet

RecordType

SoaRecord

SrvRecord

TxtRecord