Resource Managerの概要

Prev Next

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

Resource Managerは NAVERプラットフォーム内のすべてのリソースを統合的に管理する NAVERクラウドプラットフォームのサービスです。Resource Managerサービスは、ユーザーのリソース関連機能の APIを RESTful形式で提供します。

Resource Managerの共通設定

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

リクエスト

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

API URL

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

https://resourcemanager.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 Required リクエストデータの形式
  • application/json

レスポンス

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

レスポンスボディ

レスポンスボディの説明は次の通りです。

error
errorは API呼び出し失敗情報を定義します。errorの説明は次の通りです。

フィールド タイプ 必須の有無 説明
error Object - エラーコードとメッセージ
  • successfalseの場合に表示
error.errorCode Integer - エラーコード
error.message String - エラーメッセージ

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

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

HTTPステータスコード コード メッセージ 説明
400 - 'nrnList' cannot be empty. nrnListの値が欠落
400 - 'tagKey' cannot be empty. tagKeyの値が欠落
400 - 'tagKey' cannot be empty when using 'tag' parameter. tag[].tagKeyの値が欠落
400 - 'tagValue' cannot be empty. tagValueの値が欠落
参考

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

レスポンス例

呼び出しが成功した場合のレスポンス例は、API仕様書を確認してください。呼び出しに失敗した場合のレスポンスのサンプルコードは次の通りです。

{
    "error": {
        "errorCode": "400",
        "message": " 'nrnList' cannot be empty."
    }
}

Resource Manager API

Resource Managerサービスで提供する APIの説明は次の通りです。

API 説明
AttachGroup グループにリソースを追加
AttachTag リソースにタグを追加
DetachGroup グループからリソースを削除
DetachTag リソースからタグを削除
GetGroupList リソースグループリストを照会
GetResourceList リソースリストを照会

Resource Manager関連リソース

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