Classic/VPC環境で利用できます。
Cloud Log Analyticsサービスで照会したログのエクスポート時に使用可能な Object Storageのバケットリストを照会します。
リクエスト
リクエスト形式を説明します。リクエスト形式は次の通りです。
| メソッド | URI |
|---|---|
| GET | /api/{regionCode}-v1/export/buckets |
リクエストヘッダ
Cloud Log Analytics APIで共通して使用されるヘッダの詳細は、Cloud Log Analyticsのリクエストヘッダをご参照ください。
リクエストパスパラメータ
リクエストパスパラメータの説明は次の通りです。
| フィールド | タイプ | 必須の有無 | 説明 |
|---|---|---|---|
regionCode |
String | Required | リージョンコード
|
リクエスト例
リクエストのサンプルコードは次の通りです。
curl --location --request GET 'https://cloudloganalytics.apigw.ntruss.com/api/{regionCode}-v1/export/buckets' \
--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'
レスポンス
レスポンス形式を説明します。
レスポンスボディ
レスポンスボディの説明は次の通りです。
| フィールド | タイプ | 必須の有無 | 説明 |
|---|---|---|---|
code |
Integer | - | レスポンスステータスコード |
message |
String | - | レスポンスステータスメッセージ |
result |
Object | - | レスポンス結果 |
result.memberNo |
Integer | - | ユーザーの NAVERクラウドプラットフォーム会員番号 |
result.returnCode |
Integer | - | リターンコード |
result.subAccountNo |
Integer | - | サブアカウント番号 |
result.returnMsg |
String | - | リターンメッセージ |
result.boxUsage |
Integer | - | バケット使用量 |
result.regionNo |
Integer | - | リージョン番号 |
result.bucketList |
Array | - | Object Storageのバケットリスト |
bucketList
bucketListの説明は次の通りです。
| フィールド | タイプ | 必須の有無 | 説明 |
|---|---|---|---|
name |
Integer | - | バケット名 |
bytesUsed |
Integer | - | 使用可能なバケット容量 |
storageLocation |
String | - | バケットの位置 |
objectCount |
Integer | - | オブジェクト数 |
creationTime |
String | - | バケットの作成日 |
レスポンスステータスコード
Cloud Log Analytics APIで共通して使用されるレスポンスステータスコードの詳細は、Cloud Log Analyticsのレスポンスステータスコードをご参照ください。
レスポンス例
レスポンスのサンプルコードは次の通りです。
{
"code": 0,
"message": "リクエストが正常に処理されました",
"result": {
"memberNo": "*******",
"returnCode": null,
"subAccountNo": null,
"returnMsg": null,
"boxUsage": null,
"regionNo": "1",
"bucketList": [
{
"name": "test.cla",
"bytesUsed": 526150,
"storageLocation": "KR-Container",
"objectCount": 6,
"creationTime": 1729491347694
}
]
}
}