Record Sets - Update

Serviço:: DNS

Versão da API:: 2018-09-01

Atualiza um conjunto de registros dentro de uma zona DNS privada.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
privateZoneName	path	True	string	O nome da zona DNS privada (sem um ponto de encerramento).
recordType	path	True	RecordType	O tipo de registo DNS neste conjunto de registos.
relativeRecordSetName	path	True	string	O nome do conjunto de registros, relativo ao nome da zona.
resourceGroupName	path	True	string	O nome do grupo de recursos.
subscriptionId	path	True	string	Obtém credenciais de assinatura que identificam exclusivamente a assinatura do Microsoft Azure. O ID da assinatura faz parte do URI de cada chamada de serviço.
api-version	query	True	string	Versão da API do cliente.

Cabeçalho do Pedido

Name	Necessário	Tipo	Description
If-Match		string	O ETag do conjunto de recordes. Omita esse valor para sempre substituir o conjunto de registros atual. Especifique o valor ETag visto pela última vez para evitar a substituição acidental de alterações simultâneas.

Corpo do Pedido

Name	Tipo	Description
etag	string	O ETag do conjunto de recordes.
properties.aRecords	ARecord[]	A lista de registros A no conjunto de registros.
properties.aaaaRecords	AaaaRecord[]	A lista de registros AAAA no conjunto de registros.
properties.cnameRecord	CnameRecord	O registro CNAME no conjunto de registros.
properties.metadata	object	Os metadados anexados ao conjunto de registros.
properties.mxRecords	MxRecord[]	A lista de registros MX no conjunto de registros.
properties.ptrRecords	PtrRecord[]	A lista de registros PTR no conjunto de registros.
properties.soaRecord	SoaRecord	O registro SOA no conjunto de registros.
properties.srvRecords	SrvRecord[]	A lista de registros SRV no conjunto de registros.
properties.ttl	integer (int64)	O TTL (time-to-live) dos recordes no conjunto de recordes.
properties.txtRecords	TxtRecord[]	A lista de registros TXT no conjunto de registros.

Respostas

Name	Tipo	Description
200 OK	RecordSet	O conjunto de registros foi atualizado.
Other Status Codes	CloudError	Resposta padrão. Ele será desserializado de acordo com a definição de erro.

Exemplos

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

Pedido de amostra

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

Resposta da amostra

Código de estado:: 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

Pedido de amostra

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

Resposta da amostra

Código de estado:: 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

Pedido de amostra

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

Resposta da amostra

Código de estado:: 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

Pedido de amostra

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

Resposta da amostra

Código de estado:: 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

Pedido de amostra

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

Resposta da amostra

Código de estado:: 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

Pedido de amostra

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

Resposta da amostra

Código de estado:: 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

Pedido de amostra

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

Resposta da amostra

Código de estado:: 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

Pedido de amostra

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

Resposta da amostra

Código de estado:: 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"
        ]
      }
    ]
  }
}

Definições

Name	Description
AaaaRecord	Um registo AAAA.
ARecord	Um registo A.
CloudError	Uma resposta de erro do serviço.
CloudErrorBody	Uma resposta de erro do serviço.
CnameRecord	Um registro CNAME.
MxRecord	Um registro MX.
PtrRecord	Um registo PTR.
RecordSet	Descreve um conjunto de registros DNS (uma coleção de registros DNS com o mesmo nome e tipo) em uma zona DNS privada.
RecordType	O tipo de registo DNS neste conjunto de registos.
SoaRecord	Um registro SOA.
SrvRecord	Um registro SRV.
TxtRecord	Um registo TXT.

AaaaRecord

Object

Um registo AAAA.

Name	Tipo	Description
ipv6Address	string	O endereço IPv6 deste registo AAAA.

ARecord

Object

Um registo A.

Name	Tipo	Description
ipv4Address	string	O endereço IPv4 deste registo A.

CloudError

Object

Uma resposta de erro do serviço.

Name	Tipo	Description
error	CloudErrorBody	Corpo do erro na nuvem.

CloudErrorBody

Object

Uma resposta de erro do serviço.

Name	Tipo	Description
code	string	Um identificador para o erro. Os códigos são invariantes e destinam-se a ser consumidos programaticamente.
details	CloudErrorBody[]	Uma lista de detalhes adicionais sobre o erro.
message	string	Uma mensagem descrevendo o erro, destinada a ser adequada para exibição em uma interface do usuário.
target	string	O alvo do erro específico. Por exemplo, o nome da propriedade em erro.

CnameRecord

Object

Um registro CNAME.

Name	Tipo	Description
cname	string	O nome canônico para este registro CNAME.

MxRecord

Object

Um registro MX.

Name	Tipo	Description
exchange	string	O nome de domínio do host de email para esse registro MX.
preference	integer (int32)	O valor de preferência para esse registro MX.

PtrRecord

Object

Um registo PTR.

Name	Tipo	Description
ptrdname	string	O nome de domínio de destino PTR para este registo PTR.

RecordSet

Object

Descreve um conjunto de registros DNS (uma coleção de registros DNS com o mesmo nome e tipo) em uma zona DNS privada.

Name	Tipo	Description
etag	string	O ETag do conjunto de recordes.
id	string	A ID do conjunto de registros.
name	string	O nome do conjunto de registros.
properties.aRecords	ARecord[]	A lista de registros A no conjunto de registros.
properties.aaaaRecords	AaaaRecord[]	A lista de registros AAAA no conjunto de registros.
properties.cnameRecord	CnameRecord	O registro CNAME no conjunto de registros.
properties.fqdn	string	Nome de domínio totalmente qualificado do conjunto de registros.
properties.isAutoRegistered	boolean	O conjunto de registros é registrado automaticamente na zona DNS privada por meio de um link de rede virtual?
properties.metadata	object	Os metadados anexados ao conjunto de registros.
properties.mxRecords	MxRecord[]	A lista de registros MX no conjunto de registros.
properties.ptrRecords	PtrRecord[]	A lista de registros PTR no conjunto de registros.
properties.soaRecord	SoaRecord	O registro SOA no conjunto de registros.
properties.srvRecords	SrvRecord[]	A lista de registros SRV no conjunto de registros.
properties.ttl	integer (int64)	O TTL (time-to-live) dos recordes no conjunto de recordes.
properties.txtRecords	TxtRecord[]	A lista de registros TXT no conjunto de registros.
type	string	O tipo do conjunto de registros.

RecordType

Enumeração

O tipo de registo DNS neste conjunto de registos.

Valor	Description
A
AAAA
CNAME
MX
PTR
SOA
SRV
TXT

SoaRecord

Object

Um registro SOA.

Name	Tipo	Description
email	string	O contato de e-mail para este registro SOA.
expireTime	integer (int64)	O tempo de expiração para este registro SOA.
host	string	O nome de domínio do servidor de nomes autorizado para este registro SOA.
minimumTtl	integer (int64)	O valor mínimo para esse registro SOA. Por convenção, isso é usado para determinar a duração do cache negativo.
refreshTime	integer (int64)	O valor de atualização para esse registro SOA.
retryTime	integer (int64)	O tempo de repetição para este registro SOA.
serialNumber	integer (int64)	O número de série para este registro SOA.

SrvRecord

Object

Um registro SRV.

Name	Tipo	Description
port	integer (int32)	O valor da porta para esse registro SRV.
priority	integer (int32)	O valor de prioridade para este registro SRV.
target	string	O nome de domínio de destino para este registro SRV.
weight	integer (int32)	O valor de peso para este registro SRV.

TxtRecord

Object

Um registo TXT.

Name	Tipo	Description
value	string[]	O valor de texto deste registro TXT.

Partilhar via

Record Sets - Update

Parâmetros do URI

Cabeçalho do Pedido

Corpo do Pedido

Respostas

Exemplos

PATCH Private DNS Zone A Record Set

Pedido de amostra

Resposta da amostra

PATCH Private DNS Zone AAAA Record Set

Pedido de amostra

Resposta da amostra

PATCH Private DNS Zone CNAME Record Set

Pedido de amostra

Resposta da amostra

PATCH Private DNS Zone MX Record Set

Pedido de amostra

Resposta da amostra

PATCH Private DNS Zone PTR Record Set

Pedido de amostra

Resposta da amostra

PATCH Private DNS Zone SOA Record Set

Pedido de amostra

Resposta da amostra

PATCH Private DNS Zone SRV Record Set

Pedido de amostra

Resposta da amostra

PATCH Private DNS Zone TXT Record Set

Pedido de amostra

Resposta da amostra

Definições

AaaaRecord

ARecord

CloudError

CloudErrorBody

CnameRecord

MxRecord

PtrRecord

RecordSet

RecordType

SoaRecord

SrvRecord

TxtRecord