レコードの変更

Prev Next

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

指定したドメインに作成されたレコード情報を変更します。

リクエスト

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

メソッド URI
PUT /ncpdns/record/{domainId}

リクエストヘッダ

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

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

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

フィールド タイプ 必須の有無 説明
domainId Integer Required ドメイン ID

リクエストボディ

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

リクエスト例

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

curl --location --request PUT '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 '[
    {
        "id": 27****,
        "host": "record002",
        "type": "A",
        "content": "1.1.1.1",
        "ttl": 400,
        "aliasId": null,
        "lbId": null
    },
    {
        "id": 27****,
        "host": "record003",
        "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
            }
        }
    }
}