機能の概要
指定した組織およびプロジェクトの下で使用されているAPIキーの一覧をページ単位で取得します。
呼び出しの説明
インターフェース制約
呼び出し元はマルチクラウドAPIにアクセスするためのキーを保有している必要があります。AccessKey IDとAccessKey Secretの取得方法については、アクセスキーの管理をご参照ください。
リクエストパス
GET /api/v2/maas/apikeys
リクエストパラメータ
クエリパラメータ
パラメータ名 |
パラメータタイプ |
必須 |
説明 |
サンプル値 |
|---|---|---|---|---|
| uid | string | いいえ | アカウントID。ネットワークから入力されます。欠落している場合はINVALID_PARAMETERを返します。 | {uid} |
| Action | string | いいえ | クエリアクション識別子。応答のactionフィールドとエコーします。同じ名前のヘッダーでも指定できます。 | ListAIServiceAPIKeys |
| pageNumber | integer | いいえ | ページ番号。1から始まり、デフォルトは1です。 | 1 |
| pageSize | integer | いいえ | 1ページあたりの件数。デフォルトは10、最大は100です。この値を超える場合、サーバー側で強制的に20に設定されます。 | 10 |
リクエストヘッダー
ヘッダー名 |
ヘッダータイプ |
必須 |
説明 |
サンプル値 |
|---|---|---|---|---|
| Authorization | string | はい | IAM認証情報。 | -u ak:sk |
| requestId | string | いいえ | リクエストの一意の識別子。 | req-abc123 |
| X-Request-Id | string | いいえ | リクエストの一意の識別子。 | req-abc123 |
| X-OB-Org-Id | string | はい | 組織ID。すべてのインターフェースで必須です。 | org-xxxxxxxx |
| X-OB-Project-Id | string | はい | プロジェクトID。すべてのインターフェースで必須です。 | proj-xxxxxxxx |
戻り値
パラメータ名 |
パラメータタイプ |
説明 |
|---|---|---|
| action | string | リクエストアクションの識別子です。 |
| data | object | 戻されるデータオブジェクトです。 |
| data.list | array | APIキーのリストです。 |
| data.list[].id | string | APIキーIDです。 |
| data.list[].name | string | APIキー名です。 |
| data.list[].createdAt | string | 作成日時です。 |
| data.list[].updatedAt | string | 更新日時です。 |
| data.list[].expiresAt | string | 有効期限です。 |
| data.total | integer | 総レコード数です。 |
| requestId | string | リクエストIDです。 |
| server | string | サーバーアドレスです。 |
例
リクエスト例
curl -X GET \
'https://api-cloud.oceanbase.com/api/v2/maas/apikeys?pageNumber=1&pageSize=10' \
-u ak:sk \
-H 'X-OB-Org-Id: org-xxxxxxxx' \
-H 'X-OB-Project-Id: proj-xxxxxxxx' \
-H 'requestId: req-abc123'
レスポンス例
{
"action": "ListAIServiceAPIKeys",
"data": {
"list": [
{
"id": "xxxxxx",
"name": "MyAPIKey",
"createdAt": "2024-01-01T00:00:00Z",
"updatedAt": "2024-01-01T00:00:00Z",
"expiresAt": "2025-01-01T00:00:00Z"
}
],
"total": 1
},
"requestId": "xxxxxx",
"server": "xxx.xxx.x.xxx:xxxx"
}