/** * Copyright (c) 2014 Baidu.com, Inc. All Rights Reserved * * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with * the License. You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the * specific language governing permissions and limitations under the License. * * @file src/tsdb_admin_client.ts * @author leeight */ import BceBaseClient from './bce_base_client'; import type { BceConfig, BceResponse } from './types/common'; /** TSDB Admin 客户端选项 */ interface TsdbAdminClientOptions { config?: Partial; } /** 数据库状态 */ type DatabaseStatus = 'CREATING' | 'RUNNING' | 'PAUSED' | 'DELETING' | 'DELETED' | 'ERROR'; /** 数据库配置 */ interface DatabaseConfig { /** 数据库名称 */ databaseName: string; /** 描述 */ description?: string; /** 存储类型 */ storageType?: 'STANDARD' | 'COLD'; /** 数据保留时间(天) */ dataRetentionDays?: number; /** 客户端Token */ clientToken?: string; } /** 数据库信息 */ interface DatabaseInfo { /** 数据库名称 */ databaseName: string; /** 描述 */ description?: string; /** 状态 */ status: DatabaseStatus; /** 存储类型 */ storageType: string; /** 数据保留时间(天) */ dataRetentionDays: number; /** 创建时间 */ createTime: string; /** 最后修改时间 */ lastModifyTime: string; /** 端点信息 */ endpoint: { /** 公网端点 */ publicEndpoint: string; /** 内网端点 */ intranetEndpoint: string; }; /** 存储大小(字节) */ storageSize?: number; /** 数据点数量 */ dataPointCount?: number; } /** 用户配置 */ interface UserConfig { /** 用户名 */ username: string; /** 密码 */ password: string; /** 权限 */ privilege: 'READ' | 'WRITE' | 'ADMIN'; /** 描述 */ description?: string; } /** 用户信息 */ interface UserInfo { /** 用户名 */ username: string; /** 权限 */ privilege: string; /** 描述 */ description?: string; /** 创建时间 */ createTime: string; } /** 列表选项 */ interface ListOptions extends TsdbAdminClientOptions { /** 最大返回数量 */ maxKeys?: number; /** 分页标记 */ marker?: string; } /** 监控指标 */ interface Metric { /** 指标名称 */ metricName: string; /** 数据点数量 */ dataPointCount: number; /** 最后写入时间 */ lastWriteTime: string; /** 标签信息 */ tags: Record; } /** * TSDB Admin 时序数据库管理客户端 */ export default class TsdbAdminClient extends BceBaseClient { /** * 构造函数 * @param config TSDB Admin 客户端配置 */ constructor(config: BceConfig); /** * 创建数据库 * @param config 数据库配置 * @param options 选项 * @returns Promise 解析为创建结果 */ createDatabase(config: DatabaseConfig, options?: TsdbAdminClientOptions): Promise>; /** * 获取数据库信息 * @param databaseName 数据库名称 * @param options 选项 * @returns Promise 解析为数据库信息 */ getDatabase(databaseName: string, options?: TsdbAdminClientOptions): Promise>; /** * 列出数据库 * @param options 列表选项 * @returns Promise 解析为数据库列表 */ listDatabases(options?: ListOptions): Promise>; /** * 更新数据库 * @param databaseName 数据库名称 * @param updates 更新配置 * @param options 选项 * @returns Promise 解析为更新结果 */ updateDatabase(databaseName: string, updates: Partial>, options?: TsdbAdminClientOptions): Promise>; /** * 删除数据库 * @param databaseName 数据库名称 * @param options 选项 * @returns Promise 解析为删除结果 */ deleteDatabase(databaseName: string, options?: TsdbAdminClientOptions): Promise>; /** * 创建数据库用户 * @param databaseName 数据库名称 * @param userConfig 用户配置 * @param options 选项 * @returns Promise 解析为创建结果 */ createUser(databaseName: string, userConfig: UserConfig, options?: TsdbAdminClientOptions): Promise>; /** * 获取用户信息 * @param databaseName 数据库名称 * @param username 用户名 * @param options 选项 * @returns Promise 解析为用户信息 */ getUser(databaseName: string, username: string, options?: TsdbAdminClientOptions): Promise>; /** * 列出数据库用户 * @param databaseName 数据库名称 * @param options 选项 * @returns Promise 解析为用户列表 */ listUsers(databaseName: string, options?: TsdbAdminClientOptions): Promise>; /** * 更新用户 * @param databaseName 数据库名称 * @param username 用户名 * @param updates 更新配置 * @param options 选项 * @returns Promise 解析为更新结果 */ updateUser(databaseName: string, username: string, updates: Partial>, options?: TsdbAdminClientOptions): Promise>; /** * 删除用户 * @param databaseName 数据库名称 * @param username 用户名 * @param options 选项 * @returns Promise 解析为删除结果 */ deleteUser(databaseName: string, username: string, options?: TsdbAdminClientOptions): Promise>; /** * 获取数据库统计信息 * @param databaseName 数据库名称 * @param options 选项 * @returns Promise 解析为统计信息 */ getDatabaseStatistics(databaseName: string, options?: TsdbAdminClientOptions): Promise>; /** * 获取指标列表 * @param databaseName 数据库名称 * @param options 选项 * @returns Promise 解析为指标列表 */ getMetrics(databaseName: string, options?: TsdbAdminClientOptions): Promise>; /** * 获取标签列表 * @param databaseName 数据库名称 * @param metricName 指标名称 * @param options 选项 * @returns Promise 解析为标签列表 */ getTags(databaseName: string, metricName: string, options?: TsdbAdminClientOptions): Promise; }>>; /** * 创建数据库备份 * @param databaseName 数据库名称 * @param backupName 备份名称 * @param options 选项 * @returns Promise 解析为备份结果 */ createBackup(databaseName: string, backupName: string, options?: TsdbAdminClientOptions): Promise>; /** * 列出备份 * @param databaseName 数据库名称 * @param options 选项 * @returns Promise 解析为备份列表 */ listBackups(databaseName: string, options?: TsdbAdminClientOptions): Promise>; /** * 删除备份 * @param databaseName 数据库名称 * @param backupId 备份ID * @param options 选项 * @returns Promise 解析为删除结果 */ deleteBackup(databaseName: string, backupId: string, options?: TsdbAdminClientOptions): Promise>; } export {}; //# sourceMappingURL=tsdb_admin_client.d.ts.map