Record Sets - Update

Servizio:: DNS

Versione API:: 2018-09-01

Aggiorna un set di record all'interno di una zona DNS privato.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
privateZoneName	path	True	string	Nome della zona DNS privato (senza un punto di terminazione).
recordType	path	True	RecordType	Tipo di record DNS in questo set di record.
relativeRecordSetName	path	True	string	Nome del set di record, relativo al nome della zona.
resourceGroupName	path	True	string	Nome del gruppo di risorse.
subscriptionId	path	True	string	Ottiene le credenziali di sottoscrizione che identificano in modo univoco la sottoscrizione di Microsoft Azure. L'ID sottoscrizione fa parte dell'URI per ogni chiamata al servizio.
api-version	query	True	string	Versione dell'API client.

Intestazione della richiesta

Nome	Necessario	Tipo	Descrizione
If-Match		string	ETag del set di record. Omettere questo valore per sovrascrivere sempre il set di record corrente. Specificare l'ultimo valore ETag visualizzato per impedire la sovrascrittura accidentale delle modifiche simultanee.

Corpo della richiesta

Nome	Tipo	Descrizione
etag	string	ETag del set di record.
properties.aRecords	ARecord[]	Elenco di record A nel set di record.
properties.aaaaRecords	AaaaRecord[]	Elenco di record AAAA nel set di record.
properties.cnameRecord	CnameRecord	Record CNAME nel set di record.
properties.metadata	object	Metadati collegati al set di record.
properties.mxRecords	MxRecord[]	Elenco di record MX nel set di record.
properties.ptrRecords	PtrRecord[]	Elenco di record PTR nel set di record.
properties.soaRecord	SoaRecord	Record SOA nel set di record.
properties.srvRecords	SrvRecord[]	Elenco di record SRV nel set di record.
properties.ttl	integer (int64)	Durata (TTL) dei record nel set di record.
properties.txtRecords	TxtRecord[]	Elenco di record TXT nel set di record.

Risposte

Nome	Tipo	Descrizione
200 OK	RecordSet	Il set di record è stato aggiornato.
Other Status Codes	CloudError	Risposta predefinita. Verrà deserializzato in base alla definizione di errore.

Esempio

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

Esempio di richiesta

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

Risposta di esempio

Codice di stato:: 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

Esempio di richiesta

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

Risposta di esempio

Codice di stato:: 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

Esempio di richiesta

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

Risposta di esempio

Codice di stato:: 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

Esempio di richiesta

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

Risposta di esempio

Codice di stato:: 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

Esempio di richiesta

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

Risposta di esempio

Codice di stato:: 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

Esempio di richiesta

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

Risposta di esempio

Codice di stato:: 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

Esempio di richiesta

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

Risposta di esempio

Codice di stato:: 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

Esempio di richiesta

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

Risposta di esempio

Codice di stato:: 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"
        ]
      }
    ]
  }
}

Definizioni

Nome	Descrizione
AaaaRecord	Record AAAA.
ARecord	Un record A.
CloudError	Risposta di errore dal servizio.
CloudErrorBody	Risposta di errore dal servizio.
CnameRecord	Record CNAME.
MxRecord	Un record MX.
PtrRecord	Record PTR.
RecordSet	Descrive un set di record DNS (una raccolta di record DNS con lo stesso nome e tipo) in una zona DNS privata.
RecordType	Tipo di record DNS in questo set di record.
SoaRecord	Record SOA.
SrvRecord	Record SRV.
TxtRecord	Record TXT.

AaaaRecord

Object

Record AAAA.

Nome	Tipo	Descrizione
ipv6Address	string	Indirizzo IPv6 di questo record AAAA.

ARecord

Object

Un record A.

Nome	Tipo	Descrizione
ipv4Address	string	Indirizzo IPv4 del record A.

CloudError

Object

Risposta di errore dal servizio.

Nome	Tipo	Descrizione
error	CloudErrorBody	Corpo dell'errore cloud.

CloudErrorBody

Object

Risposta di errore dal servizio.

Nome	Tipo	Descrizione
code	string	Identificatore dell'errore. I codici sono invarianti e devono essere utilizzati a livello di codice.
details	CloudErrorBody[]	Elenco di dettagli aggiuntivi sull'errore.
message	string	Messaggio che descrive l'errore, destinato a essere adatto per la visualizzazione in un'interfaccia utente.
target	string	Destinazione dell'errore specifico. Ad esempio, il nome della proprietà in errore.

CnameRecord

Object

Record CNAME.

Nome	Tipo	Descrizione
cname	string	Nome canonico per questo record CNAME.

MxRecord

Object

Un record MX.

Nome	Tipo	Descrizione
exchange	string	Nome di dominio dell'host di posta per questo record MX.
preference	integer (int32)	Valore di preferenza per questo record MX.

PtrRecord

Object

Record PTR.

Nome	Tipo	Descrizione
ptrdname	string	Nome di dominio di destinazione PTR per questo record PTR.

RecordSet

Object

Descrive un set di record DNS (una raccolta di record DNS con lo stesso nome e tipo) in una zona DNS privata.

Nome	Tipo	Descrizione
etag	string	ETag del set di record.
id	string	ID del set di record.
name	string	Nome del set di record.
properties.aRecords	ARecord[]	Elenco di record A nel set di record.
properties.aaaaRecords	AaaaRecord[]	Elenco di record AAAA nel set di record.
properties.cnameRecord	CnameRecord	Record CNAME nel set di record.
properties.fqdn	string	Nome di dominio completo del set di record.
properties.isAutoRegistered	boolean	Il set di record viene registrato automaticamente nella zona DNS privato tramite un collegamento di rete virtuale?
properties.metadata	object	Metadati collegati al set di record.
properties.mxRecords	MxRecord[]	Elenco di record MX nel set di record.
properties.ptrRecords	PtrRecord[]	Elenco di record PTR nel set di record.
properties.soaRecord	SoaRecord	Record SOA nel set di record.
properties.srvRecords	SrvRecord[]	Elenco di record SRV nel set di record.
properties.ttl	integer (int64)	Durata (TTL) dei record nel set di record.
properties.txtRecords	TxtRecord[]	Elenco di record TXT nel set di record.
type	string	Tipo del set di record.

RecordType

Enumerazione

Tipo di record DNS in questo set di record.

Valore	Descrizione
A
AAAA
CNAME
MX
PTR
SOA
SRV
TXT

SoaRecord

Object

Record SOA.

Nome	Tipo	Descrizione
email	string	Contatto di posta elettronica per questo record SOA.
expireTime	integer (int64)	Ora di scadenza per questo record SOA.
host	string	Nome di dominio del server dei nomi autorevole per questo record SOA.
minimumTtl	integer (int64)	Valore minimo per questo record SOA. Per convenzione, questa operazione viene utilizzata per determinare la durata negativa della memorizzazione nella cache.
refreshTime	integer (int64)	Valore di aggiornamento per questo record SOA.
retryTime	integer (int64)	Tempo di ripetizione dei tentativi per questo record SOA.
serialNumber	integer (int64)	Numero di serie per questo record SOA.

SrvRecord

Object

Record SRV.

Nome	Tipo	Descrizione
port	integer (int32)	Valore della porta per questo record SRV.
priority	integer (int32)	Valore di priorità per questo record SRV.
target	string	Nome di dominio di destinazione per questo record SRV.
weight	integer (int32)	Valore di peso per questo record SRV.

TxtRecord

Object

Record TXT.

Nome	Tipo	Descrizione
value	string[]	Valore di testo del record TXT.

Condividi tramite

Record Sets - Update

Parametri dell'URI

Intestazione della richiesta

Corpo della richiesta

Risposte

Esempio

PATCH Private DNS Zone A Record Set

Esempio di richiesta

Risposta di esempio

PATCH Private DNS Zone AAAA Record Set

Esempio di richiesta

Risposta di esempio

PATCH Private DNS Zone CNAME Record Set

Esempio di richiesta

Risposta di esempio

PATCH Private DNS Zone MX Record Set

Esempio di richiesta

Risposta di esempio

PATCH Private DNS Zone PTR Record Set

Esempio di richiesta

Risposta di esempio

PATCH Private DNS Zone SOA Record Set

Esempio di richiesta

Risposta di esempio

PATCH Private DNS Zone SRV Record Set

Esempio di richiesta

Risposta di esempio

PATCH Private DNS Zone TXT Record Set

Esempio di richiesta

Risposta di esempio

Definizioni

AaaaRecord

ARecord

CloudError

CloudErrorBody

CnameRecord

MxRecord

PtrRecord

RecordSet

RecordType

SoaRecord

SrvRecord

TxtRecord