レコードの作成

Classic/VPC環境で利用できます。

指定したドメインにレコードを作成します。

リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

リクエストヘッダ

レコード APIで共通して使用されるヘッダの詳細は、レコード APIの共通ヘッダをご参照ください。

リクエストパスパラメータ

パラメータの説明は次の通りです。

リクエストボディ

リクエストボディの詳細は、RecordCreateRequestをご参照ください。

リクエスト例

リクエストのサンプルコードは次の通りです。

curl --location --request POST  'https://globaldns.apigw.ntruss.com/dns/v1/ncpdns/record/25***' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'Content-Type: application/json' \
--data '[
    {
        "host": "record000",
        "type": "A",
        "content": "0.0.0.1",
        "ttl": 300,
        "aliasId": null,
        "lbId": null
    },
    {
        "host": "record001",
        "type": "AAAA",
        "content": "2001:0db8:85a3:0000:0000:8a2e:0370:7334",
        "ttl": 300,
        "aliasId": null,
        "lbId": null
    }
]'

レスポンス

レスポンス形式を説明します。

レスポンスステータスコード

NAVERクラウドプラットフォームでで共通して使用されるレスポンスステータスコードの詳細は、Ncloud APIのレスポンスステータスコードをご参照ください。

エラーコード例

エラーコードのサンプルコードは次の通りです。

{
  "result": "FAIL",
  "error": {
    "errorCode": "X00007",
    "message": "有効ではないレコードです。",
    "devMessage": "有効ではないレコードです。",
    "moreInfo": {
      "validationInfo": {
        "rrsetValidationResponseList": [
          {
            "recordType": "A",
            "field": "host",
            "recordName": "www.example.com",
            "msg": "入力したホストとタイプは、重複する他のリソースレコードに存在します。追加するには、リソースを変更してください。",
            "index": 0
          }
        ],
        "domainId": 749
      }
    }
  }
}