Record概要

Prev Next

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

概要

Global DNSで提供されるドメインのクエリ数を規定されたAPIで呼び出すことができる機能です。
ダッシュボードから発行された許可されたAPI Keyを使用する必要が呼び出しが可能です。

Global DNSの共通設定

Global DNS APIで共通して使用されるリクエスト形式とレスポンス形式を説明します。

リクエスト

共通リクエスト形式を説明します。

API URL

リクエスト API URLは次の通りです。

https://globaldns.apigw.ntruss.com

リクエストヘッダ

リクエストヘッダの説明は次の通りです。

フィールド 必須の有無 説明
x-ncp-apigw-timestamp Required 1970年1月1日00:00:00協定世界時(UTC)からの経過時間(ミリ秒)
  • API Gatewayサーバとの時間差が5分以上の場合は無効なリクエストとみなす
  • Unix timestamp形式
x-ncp-iam-access-key Required NAVERクラウドプラットフォームから発行された Access Key
x-ncp-apigw-signature-v2 Required NAVERクラウドプラットフォームから発行された Access Keyとマッピングする Secret Keyと HMAC暗号化アルゴリズム(HmacSHA256)でリクエスト情報を暗号化した後、Base64にエンコードした署名
x-ncp-region_code Required 移行データ保存先バケットのリージョンコード
  • KR (有効値)

レスポンス

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

응답 바디

응답 바디에 대한 설명은 다음과 같습니다.

error
error는 API 호출 실패 정보를 정의합니다. error에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
result String - API 호출 결과
  • FAIL: 호출이 실패한 경우 표시
error Object - 오류 코드 및 메시지
  • successfalse인 경우 표시
error.errorCode Integer - 오류 코드
error.message String - 오류 메시지

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

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