機能の概要
データベースユーザーの詳細を取得します。
呼び出しの説明
インターフェース制約
呼び出し元はOCPアプリケーションサービスの認証を通過している必要があります。
呼び出し元は指定されたテナントに対する読み取り権限を持っている必要があります。
リクエストパス
GET /api/v2/ob/clusters/{id}/tenants/{tenantId}/users/{username}
リクエストパラメータ
パスパラメータ
パラメータ |
型 |
必須 |
サンプル値 |
説明 |
|---|---|---|---|---|
| id | Integer | はい | 1 | クラスタID |
| tenantId | Integer | はい | 5 | テナントID |
| username | String | はい | root | ユーザー名 |
| hostName | String | いいえ | 33.47.251.% | ホスト名 |
戻り値
パラメータ |
型 |
説明 |
|---|---|---|
| data | Object | データベースユーザー。データベースユーザーデータ構造は下表を参照してください。 |
| successful | Boolean | リクエストが成功したかどうかを示します。 |
| timestamp | Datetime | サーバーがリクエストを完了したタイムスタンプです。 |
| duration | Integer | サーバーがリクエストを処理した時間(ミリ秒)。 |
| status | Integer | HTTP Status仕様に準拠したコード。 |
| traceId | String | リクエストのTrace IDで、問題の調査に使用されます。 |
| server | String | リクエストに応答したアプリケーションサービスのアドレスです。 |
データベースユーザーデータ構造
パラメータ |
型 |
説明 |
|---|---|---|
| username | String | ユーザー名。 |
| globalPrivileges | StringArray | グローバル権限のリスト: |
| dbPrivileges | Array | データベース権限のリスト。 説明:MySQLテナントにのみ存在し、Oracleテナントにはこのフィールドはありません。 |
| ├─ dbName | String | データベース名。 |
| ├─ privileges | StringArray | データベースの権限リスト。 |
| objectPrivileges | Array | オブジェクト権限のリスト。 説明:Oracleテナントにのみ存在し、MySQLテナントにはこのフィールドはありません。 |
| ├─ dbObject | Object | データベースオブジェクト。 |
| ├─ privileges | StringArray | オブジェクトの権限リスト。 |
| grantedRoles | String | ユーザーに付与されたロール。 説明:Oracleテナントにのみ存在し、MySQLテナントにはこのフィールドはありません。 |
| isLocked | Bool | ユーザーがロックされているかどうか。 |
| createTime | Datetime | ユーザー作成日時。 |
| connectionStrings | Array | OBProxyと接続文字列のリスト。 |
| ├─ connectionStringType | String | 接続文字列タイプ。取り得る範囲: |
| ├─ obProxyAddress | String | OBProxyアドレス。 説明:接続文字列タイプがOBProxyの場合に有効です。 |
| ├─ obProxyPort | Integer | OBProxyポート。 説明:接続文字列タイプがOBProxyの場合に有効です。 |
| ├─ connectionString | String | 接続文字列。 |
| accessibleDatabases | StringArray | アクセス可能なデータベース。 説明:Oracleテナントにのみ存在し、MySQLテナントにはこのフィールドはありません。 |
dbObjectパラメータの説明
パラメータ |
型 |
説明 |
|---|---|---|
| objectType | String | データベースオブジェクトのタイプ。取り得る範囲: |
| objectName | String | データベースオブジェクト名、すなわちテーブル名、ビュー名、またはストアドプロシージャ名。 |
| schemaName | String | スキーマ名。通常、ユーザー名と同じです。 |
例
リクエスト例
クラスタ1、テナント1000001内のrootユーザーの詳細を取得します。
GET /api/v2/ob/clusters/1/tenants/1000001/users/root?id=1&tenantId=1000001&username=root
レスポンス例
{
"data": {
"accessibleDatabases": [
"oceanbase",
"information_schema",
"mysql",
"test",
"db1"
],
"connectionStrings": [
{
"connectionString": "mysql -hxx.xx.xx.xx -P2881 -uroot@mysql1 -p",
"type": "DIRECT"
}
],
"createTime": "2021-09-06T11:38:44.585445+08:00",
"dbPrivileges": [
{
"dbName": "mysql",
"privileges": [
"SELECT",
"INSERT",
"UPDATE",
"DELETE",
"CREATE",
"DROP",
"INDEX",
"ALTER",
"CREATE_VIEW",
"SHOW_VIEW"
]
},
{
"dbName": "oceanbase",
"privileges": [
"SELECT",
"INSERT",
"UPDATE",
"DELETE",
"CREATE",
"DROP",
"INDEX",
"ALTER",
"CREATE_VIEW",
"SHOW_VIEW"
]
},
{
"dbName": "test",
"privileges": [
"SELECT",
"INSERT",
"UPDATE",
"DELETE",
"CREATE",
"DROP",
"INDEX",
"ALTER",
"CREATE_VIEW",
"SHOW_VIEW"
]
},
{
"dbName": "information_schema",
"privileges": [
"SELECT",
"INSERT",
"UPDATE",
"DELETE",
"CREATE",
"DROP",
"INDEX",
"ALTER",
"CREATE_VIEW",
"SHOW_VIEW"
]
}
],
"globalPrivileges": [
"ALTER",
"CREATE",
"DELETE",
"DROP",
"GRANT_OPTION",
"INSERT",
"UPDATE",
"SELECT",
"INDEX",
"CREATE_VIEW",
"SHOW_VIEW",
"SHOW_DATABASES",
"CREATE_USER",
"SUPER",
"PROCESS"
],
"isLocked": false,
"username": "root"
},
"duration": 429,
"server": "a83ad33525",
"status": 200,
"successful": true,
"timestamp": "2021-09-07T15:12:20.703+08:00",
"traceId": "28857c5276f24a35"
}