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)からの経過時間(ミリ秒)
|
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 | リクエストデータの形式
|
レスポンス
共通レスポンス形式を説明します。
レスポンスボディ
レスポンスボディの説明は次の通りです。
error
errorは API呼び出し失敗情報を定義します。errorの説明は次の通りです。
| フィールド | タイプ | 必須の有無 | 説明 |
|---|---|---|---|
error |
Object | - | エラーコードとメッセージ
|
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についてユーザーの理解に役立つよう、さまざまな関連リソースを提供しています。
- Resource Manager APIの使用方法
- APIの概要: NAVERクラウドプラットフォームから発行された Access Key、Secret Keyの発行と確認、リクエストヘッダに必要な署名の作成方法
- Sub Accountご利用ガイド: NAVERクラウドプラットフォームコンソールから発行されたサブアカウントの Access Key発行と確認方法
- Ncloudの共通レスポンスステータスコード: Resource Managerサービスで使用される NAVERクラウドプラットフォームの共通レスポンスステータスコード情報
- Resource Managerサービスの使用方法
- Resource Managerご利用ガイド: NAVERクラウドプラットフォームコンソールで Resource Managerサービスを使用する方法
- Ncloud使用環境ガイド: VPC、Classic環境とサポート有無に関するガイド
- 料金プランの紹介、特長、詳細機能: Resource Managerサービスの料金体系、特長、詳細機能のサマリー
- サービスのお知らせ: Resource Managerサービスに関するお知らせ
- よくある質問: Resource Managerサービスに関するよくあるご質問
- お問い合わせ: APIガイドだけでは不明な点が解消されない場合、直接問い合わせ