Global Edgeの概要

Prev Next

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

Global Edgeは、世界中のユーザーとアプリケーションの間に位置し、ウェブやアプリのコンテンツに迅速かつ安全にアクセスするようサポートする NAVERクラウドプラットフォームのサービスです。Global Edgeサービスは、プロファイル、エッジ、パージ、証明書管理機能関連の APIを RESTfulの形式で提供します。

Global Edgeの共通設定

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

リクエスト

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

API URL

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

https://edge.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にエンコードした署名
Content-Type Optional リクエストデータの形式
  • application/json
Accept Optional レスポンスデータの形式
  • application/json

レスポンス

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

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

レスポンスステータスコードの説明は次の通りです。

HTTPステータスコード コード メッセージ 説明
200 0000 Success 呼び出し成功
400 0040 Field validation Error リクエストデータ形式が一致しない
400 0101 同じ名前の Profileがあります。 重複したプロファイル名
400 0102 これ以上 Profileを作成できません。 プロファイル作成制限
400 0250 再稼働する Edgeで停止状態ではないインスタンスが含まれています。 動作を実行できないエッジが存在
401 200 Authentication Failed 認証失敗
403 0032 許可されていないリクエストです。 許可されていないリクエスト
403 0032 統計照会終了日は開始日以降です。 終了日は開始日以降でなければならない
500 9999 Unknown Error サーバエラー発生
参考

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

Global Edge API

Global Edgeサービスが提供する APIの説明は次の通りです。

プロファイル

プロファイル関連 APIの説明は次の通りです。

API 説明
プロファイルの作成 プロファイルを作成
プロファイルリストの照会 プロファイルリストを照会
プロファイル名のチェック プロファイル作成前に名前の有効性を確認
プロファイル名の変更 プロファイル名を変更
プロファイルの削除 プロファイルの削除

エッジ

エッジ関連 APIの説明は次の通りです。

API 説明
エッジの作成 エッジを作成
エッジリストの照会 エッジリストを照会
エッジ状態の照会 エッジの現在の状態を照会
エッジの照会 エッジの詳細情報を照会
エッジ統計の照会 エッジトラフィック統計を照会
エッジの編集 エッジ設定を変更
エッジの再起動 停止したエッジを再起動
エッジの停止 運用中のエッジを停止
エッジの削除 停止したエッジを削除

パージ

パージ関連 APIの説明は次の通りです。

API 説明
パージの実行 パージを実行
パージ履歴の照会 パージ実行履歴を照会

証明書

証明書関連 APIの説明は次の通りです。

API 説明
証明書プロビジョニング 証明書プロビジョニング
証明書リストの照会 証明書リストを照会
証明書の照会 証明書の詳細情報を照会
証明書の更新 証明書を更新
証明書適用範囲の拡大 韓国/日本証明書にグローバル証明書を追加して範囲を拡大
TLSプロトコルバージョンの変更 証明書の TLSプロトコルサポートバージョンを変更
グローバル証明書の削除 期限切れになったか、期限切れ予定のグローバル証明書を削除
証明書の削除 証明書を削除

Global Edge関連リソース

Global Edge APIについてユーザーの理解に役立つよう、さまざまな関連リソースを提供しています。