Record Sets - Update

서비스:
DNS
API 버전:
2018-05-01

DNS 영역 내에서 레코드 집합을 업데이트합니다.

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

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
recordType
 path True

RecordType

이 레코드 집합의 DNS 레코드 형식입니다.
relativeRecordSetName
 path True

string

영역 이름을 기준으로 하는 레코드 집합의 이름입니다.
resourceGroupName
 path True

string

리소스 그룹의 이름입니다.
subscriptionId
 path True

string

Microsoft Azure 구독을 고유하게 식별하는 Azure 구독 ID를 지정합니다.
zoneName
 path True

string

DNS 영역의 이름입니다(종료 점 제외).
api-version
 query True

string

API 버전을 지정합니다.

요청 헤더

Name 필수 형식 Description
If-Match

string

레코드 집합의 etag입니다. 현재 레코드 집합을 항상 덮어쓰려면 이 값을 생략합니다. 실수로 동시 변경 내용을 덮어쓰지 않도록 마지막으로 본 etag 값을 지정합니다.

요청 본문

Name 형식 Description
etag

string

레코드 집합의 etag입니다.
properties.AAAARecords

AaaaRecord[]

레코드 집합의 AAAA 레코드 목록입니다.
properties.ARecords

ARecord[]

레코드 집합의 A 레코드 목록입니다.
properties.CNAMERecord

CnameRecord

레코드 집합의 CNAME 레코드입니다.
properties.MXRecords

MxRecord[]

레코드 집합의 MX 레코드 목록입니다.
properties.NSRecords

NsRecord[]

레코드 집합의 NS 레코드 목록입니다.
properties.PTRRecords

PtrRecord[]

레코드 집합의 PTR 레코드 목록입니다.
properties.SOARecord

SoaRecord

레코드 집합의 SOA 레코드입니다.
properties.SRVRecords

SrvRecord[]

레코드 집합의 SRV 레코드 목록입니다.
properties.TTL

integer (int64)

레코드 집합에 있는 레코드의 TTL(Time-to-live)입니다.
properties.TXTRecords

TxtRecord[]

레코드 집합의 TXT 레코드 목록입니다.
properties.caaRecords

CaaRecord[]

레코드 집합의 CAA 레코드 목록입니다.
properties.metadata

object

레코드 집합에 연결된 메타데이터입니다.
properties.targetResource

SubResource

dns 리소스 값을 사용하는 Azure 리소스에 대한 참조입니다.

응답

Name 형식 Description
200 OK

RecordSet

레코드 집합이 업데이트되었습니다.
Other Status Codes

CloudError

기본 응답입니다. 오류 정의에 따라 역직렬화됩니다.

예제

Patch A recordset
Patch AAAA recordset
Patch CAA recordset
Patch CNAME recordset
Patch MX recordset
Patch NS recordset
Patch PTR recordset
Patch SOA recordset
Patch SRV recordset
Patch TXT recordset

Patch A recordset

샘플 요청

PATCH https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/A/record1?api-version=2018-05-01

{
  "properties": {
    "metadata": {
      "key2": "value2"
    }
  }
}

샘플 응답

상태 코드:
200 
{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/A/record1",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "record1",
  "type": "Microsoft.Network/dnsZones/A",
  "properties": {
    "metadata": {
      "key2": "value2"
    },
    "TTL": 3600,
    "fqdn": "record1.zone1",
    "ARecords": [
      {
        "ipv4Address": "127.0.0.1"
      }
    ]
  }
}

Patch AAAA recordset

샘플 요청

PATCH https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/AAAA/record1?api-version=2018-05-01

{
  "properties": {
    "metadata": {
      "key2": "value2"
    }
  }
}

샘플 응답

상태 코드:
200 
{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/AAAA/record1",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "record1",
  "type": "Microsoft.Network/dnsZones/AAAA",
  "properties": {
    "metadata": {
      "key2": "value2"
    },
    "TTL": 3600,
    "fqdn": "record1.zone1",
    "AAAARecords": [
      {
        "ipv6Address": "::1"
      }
    ]
  }
}

Patch CAA recordset

샘플 요청

PATCH https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/CAA/record1?api-version=2018-05-01

{
  "properties": {
    "metadata": {
      "key2": "value2"
    }
  }
}

샘플 응답

상태 코드:
200 
{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/CAA/record1",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "record1",
  "type": "Microsoft.Network/dnsZones/CAA",
  "properties": {
    "metadata": {
      "key2": "value2"
    },
    "TTL": 3600,
    "fqdn": "record1.zone1",
    "caaRecords": [
      {
        "flags": 0,
        "tag": "issue",
        "value": "ca.contoso.com"
      }
    ]
  }
}

Patch CNAME recordset

샘플 요청

PATCH https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/CNAME/record1?api-version=2018-05-01

{
  "properties": {
    "metadata": {
      "key2": "value2"
    }
  }
}

샘플 응답

상태 코드:
200 
{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/CNAME/record1",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "record1",
  "type": "Microsoft.Network/dnsZones/CNAME",
  "properties": {
    "metadata": {
      "key2": "value2"
    },
    "TTL": 3600,
    "fqdn": "record1.zone1",
    "CNAMERecord": {
      "cname": "contoso.com"
    }
  }
}

Patch MX recordset

샘플 요청

PATCH https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/MX/record1?api-version=2018-05-01

{
  "properties": {
    "metadata": {
      "key2": "value2"
    }
  }
}

샘플 응답

상태 코드:
200 
{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/MX/record1",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "record1",
  "type": "Microsoft.Network/dnsZones/MX",
  "properties": {
    "metadata": {
      "key2": "value2"
    },
    "TTL": 3600,
    "fqdn": "record1.zone1",
    "MXRecords": [
      {
        "preference": 0,
        "exchange": "mail.contoso.com"
      }
    ]
  }
}

Patch NS recordset

샘플 요청

PATCH https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/NS/record1?api-version=2018-05-01

{
  "properties": {
    "metadata": {
      "key2": "value2"
    }
  }
}

샘플 응답

상태 코드:
200 
{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/NS/record1",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "record1",
  "type": "Microsoft.Network/dnsZones/NS",
  "properties": {
    "metadata": {
      "key2": "value2"
    },
    "TTL": 3600,
    "fqdn": "record1.zone1",
    "NSRecords": [
      {
        "nsdname": "ns1.contoso.com"
      }
    ]
  }
}

Patch PTR recordset

샘플 요청

PATCH https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/0.0.127.in-addr.arpa/PTR/1?api-version=2018-05-01

{
  "properties": {
    "metadata": {
      "key2": "value2"
    }
  }
}

샘플 응답

상태 코드:
200 
{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/0.0.127.in-addr.arpa/PTR/1",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "1",
  "type": "Microsoft.Network/dnsZones/PTR",
  "properties": {
    "metadata": {
      "key2": "value2"
    },
    "TTL": 3600,
    "fqdn": "1.0.0.127.in-addr.arpa",
    "PTRRecords": [
      {
        "ptrdname": "localhost"
      }
    ]
  }
}

Patch SOA recordset

샘플 요청

PATCH https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/SOA/@?api-version=2018-05-01

{
  "properties": {
    "metadata": {
      "key2": "value2"
    }
  }
}

샘플 응답

상태 코드:
200 
{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/SOA/@",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "@",
  "type": "Microsoft.Network/dnsZones/SOA",
  "properties": {
    "metadata": {
      "key2": "value2"
    },
    "TTL": 3600,
    "fqdn": "zone1",
    "SOARecord": {
      "host": "ns1.contoso.com",
      "email": "hostmaster.contoso.com",
      "serialNumber": 1,
      "refreshTime": 3600,
      "retryTime": 300,
      "expireTime": 2419200,
      "minimumTTL": 300
    }
  }
}

Patch SRV recordset

샘플 요청

PATCH https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/SRV/record1?api-version=2018-05-01

{
  "properties": {
    "metadata": {
      "key2": "value2"
    }
  }
}

샘플 응답

상태 코드:
200 
{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/SRV/record1",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "record1",
  "type": "Microsoft.Network/dnsZones/SRV",
  "properties": {
    "metadata": {
      "key2": "value2"
    },
    "TTL": 3600,
    "fqdn": "record1.zone1",
    "SRVRecords": [
      {
        "priority": 0,
        "weight": 10,
        "port": 80,
        "target": "contoso.com"
      }
    ]
  }
}

Patch TXT recordset

샘플 요청

PATCH https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/TXT/record1?api-version=2018-05-01

{
  "properties": {
    "metadata": {
      "key2": "value2"
    }
  }
}

샘플 응답

상태 코드:
200 
{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/TXT/record1",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "record1",
  "type": "Microsoft.Network/dnsZones/TXT",
  "properties": {
    "metadata": {
      "key2": "value2"
    },
    "TTL": 3600,
    "fqdn": "record1.zone1",
    "TXTRecords": [
      {
        "value": [
          "string1",
          "string2"
        ]
      }
    ]
  }
}

정의

Name Description
AaaaRecord

AAAA 레코드입니다.
ARecord

A 레코드입니다.
CaaRecord

CAA 레코드입니다.
CloudError

서비스의 오류 응답입니다.
CloudErrorBody

서비스의 오류 응답입니다.
CnameRecord

CNAME 레코드입니다.
MxRecord

MX 레코드입니다.
NsRecord

NS 레코드입니다.
PtrRecord

PTR 레코드입니다.
RecordSet

DNS 레코드 집합(이름과 형식이 같은 DNS 레코드 컬렉션)에 대해 설명합니다.
RecordType

이 레코드 집합의 DNS 레코드 형식입니다.
SoaRecord

SOA 레코드입니다.
SrvRecord

SRV 레코드입니다.
SubResource

다른 리소스에 대한 참조
TxtRecord

TXT 레코드입니다.

AaaaRecord

Object

AAAA 레코드입니다.

Name 형식 Description
ipv6Address

string

이 AAAA 레코드의 IPv6 주소입니다.

ARecord

Object

A 레코드입니다.

Name 형식 Description
ipv4Address

string

이 A 레코드의 IPv4 주소입니다.

CaaRecord

Object

CAA 레코드입니다.

Name 형식 Description
flags

integer (int32)

이 CAA 레코드의 플래그는 0에서 255 사이의 정수입니다.
tag

string

이 CAA 레코드의 태그입니다.
value

string

이 CAA 레코드의 값입니다.

CloudError

Object

서비스의 오류 응답입니다.

Name 형식 Description
error

CloudErrorBody

클라우드 오류 본문입니다.

CloudErrorBody

Object

서비스의 오류 응답입니다.

Name 형식 Description
code

string

오류의 식별자입니다. 코드는 고정적이며 프로그래밍 방식으로 사용할 수 있습니다.
details

CloudErrorBody[]

오류에 대한 추가 세부 정보 목록입니다.
message

string

사용자 인터페이스에 표시하기에 적합한 오류를 설명하는 메시지입니다.
target

string

특정 오류의 대상입니다. 예를 들어 오류가 발생한 속성의 이름입니다.

CnameRecord

Object

CNAME 레코드입니다.

Name 형식 Description
cname

string

이 CNAME 레코드의 정식 이름입니다.

MxRecord

Object

MX 레코드입니다.

Name 형식 Description
exchange

string

이 MX 레코드에 대한 메일 호스트의 도메인 이름입니다.
preference

integer (int32)

이 MX 레코드의 기본 설정 값입니다.

NsRecord

Object

NS 레코드입니다.

Name 형식 Description
nsdname

string

이 NS 레코드의 이름 서버 이름입니다.

PtrRecord

Object

PTR 레코드입니다.

Name 형식 Description
ptrdname

string

이 PTR 레코드의 PTR 대상 도메인 이름입니다.

RecordSet

Object

DNS 레코드 집합(이름과 형식이 같은 DNS 레코드 컬렉션)에 대해 설명합니다.

Name 형식 Description
etag

string

레코드 집합의 etag입니다.
id

string

레코드 집합의 ID입니다.
name

string

레코드 집합의 이름입니다.
properties.AAAARecords

AaaaRecord[]

레코드 집합의 AAAA 레코드 목록입니다.
properties.ARecords

ARecord[]

레코드 집합의 A 레코드 목록입니다.
properties.CNAMERecord

CnameRecord

레코드 집합의 CNAME 레코드입니다.
properties.MXRecords

MxRecord[]

레코드 집합의 MX 레코드 목록입니다.
properties.NSRecords

NsRecord[]

레코드 집합의 NS 레코드 목록입니다.
properties.PTRRecords

PtrRecord[]

레코드 집합의 PTR 레코드 목록입니다.
properties.SOARecord

SoaRecord

레코드 집합의 SOA 레코드입니다.
properties.SRVRecords

SrvRecord[]

레코드 집합의 SRV 레코드 목록입니다.
properties.TTL

integer (int64)

레코드 집합에 있는 레코드의 TTL(Time-to-live)입니다.
properties.TXTRecords

TxtRecord[]

레코드 집합의 TXT 레코드 목록입니다.
properties.caaRecords

CaaRecord[]

레코드 집합의 CAA 레코드 목록입니다.
properties.fqdn

string

레코드 집합의 정규화된 도메인 이름입니다.
properties.metadata

object

레코드 집합에 연결된 메타데이터입니다.
properties.provisioningState

string

레코드 집합의 프로비전 상태입니다.
properties.targetResource

SubResource

dns 리소스 값을 사용하는 Azure 리소스에 대한 참조입니다.
type

string

레코드 집합의 형식입니다.

RecordType

열거형

이 레코드 집합의 DNS 레코드 형식입니다.

값 Description
A
AAAA
CAA
CNAME
MX
NS
PTR
SOA
SRV
TXT

SoaRecord

Object

SOA 레코드입니다.

Name 형식 Description
email

string

이 SOA 레코드의 전자 메일 연락처입니다.
expireTime

integer (int64)

이 SOA 레코드의 만료 시간입니다.
host

string

이 SOA 레코드에 대한 신뢰할 수 있는 이름 서버의 도메인 이름입니다.
minimumTTL

integer (int64)

이 SOA 레코드의 최소값입니다. 규칙에 따라 이는 음수 캐싱 기간을 결정하는 데 사용됩니다.
refreshTime

integer (int64)

이 SOA 레코드의 새로 고침 값입니다.
retryTime

integer (int64)

이 SOA 레코드의 재시도 시간입니다.
serialNumber

integer (int64)

이 SOA 레코드의 일련 번호입니다.

SrvRecord

Object

SRV 레코드입니다.

Name 형식 Description
port

integer (int32)

이 SRV 레코드의 포트 값입니다.
priority

integer (int32)

이 SRV 레코드의 우선 순위 값입니다.
target

string

이 SRV 레코드의 대상 도메인 이름입니다.
weight

integer (int32)

이 SRV 레코드의 가중치 값입니다.

SubResource

Object

다른 리소스에 대한 참조

Name 형식 Description
id

string

리소스 ID입니다.

TxtRecord

Object

TXT 레코드입니다.

Name 형식 Description
value

string[]

이 TXT 레코드의 텍스트 값입니다.