tencentcloud-sdk-nodejs
Version:
1,938 lines (1,868 loc) • 60.8 kB
TypeScript
/**
* 周期执行器设置。
*/
export interface ScheduleSettings {
/**
* 执行策略:
- ONCE:单次执行
- RECURRENCE:周期执行
只有在 CreateInvoker 时才必填,ModifyInvoker 时为非必填
*/
Policy: string;
/**
* 触发 Crontab 表达式。Policy 为 RECURRENCE 时,需要指定此字段。Crontab 按北京时间解析。
*/
Recurrence?: string;
/**
* 执行器下次执行时间。Policy 为 ONCE 时,需要指定此字段。
时间格式为:YYYY-MM-DDThh:mm:ssZ
*/
InvokeTime?: string;
}
/**
* CreateRegisterCode返回参数结构体
*/
export interface CreateRegisterCodeResponse {
/**
* 注册码ID。
*/
RegisterCodeId?: string;
/**
* 注册码值。
*/
RegisterCodeValue?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* PreviewReplacedCommandContent返回参数结构体
*/
export interface PreviewReplacedCommandContentResponse {
/**
* 自定义参数替换后的,经Base64编码的命令内容。
*/
ReplacedContent?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* CreateCommand返回参数结构体
*/
export interface CreateCommandResponse {
/**
* 命令ID。
*/
CommandId?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* DisableInvoker请求参数结构体
*/
export interface DisableInvokerRequest {
/**
* 待停止的执行器ID。
可通过 [DescribeInvokers(查询执行器)](https://cloud.tencent.com/document/api/1340/61759) 接口获取。
*/
InvokerId: string;
}
/**
* 注册实例信息。
*/
export interface RegisterInstanceInfo {
/**
* 注册码ID。
*/
RegisterCodeId?: string;
/**
* 托管实例ID。
*/
InstanceId?: string;
/**
* 托管实例名。
*/
InstanceName?: string;
/**
* 机器ID。
*/
MachineId?: string;
/**
* 系统名。取值:Linux | Windows。
*/
SystemName?: string;
/**
* 主机名。
*/
HostName?: string;
/**
* 内网IP。
*/
LocalIp?: string;
/**
* 公钥。
*/
PublicKey?: string;
/**
* 托管状态。
返回Online表示实例正在托管,返回Offline表示实例未托管。
*/
Status?: string;
/**
* 创建时间。格式为:YYYY-MM-DDThh:mm:ssZ
*/
CreatedTime?: string;
/**
* 上次更新时间。格式为:YYYY-MM-DDThh:mm:ssZ
*/
UpdatedTime?: string;
/**
* 标签
*/
Tags?: Array<Tag>;
}
/**
* 自动化助手客户端信息
*/
export interface AutomationAgentInfo {
/**
* 实例ID。
*/
InstanceId?: string;
/**
* Agent 版本号。
*/
Version?: string;
/**
* 上次心跳时间
*/
LastHeartbeatTime?: string;
/**
* Agent状态,取值范围:
Online:在线,Offline:离线
*/
AgentStatus?: string;
/**
* Agent运行环境,取值范围:Linux:Linux实例Windows:Windows实例
*/
Environment?: string;
/**
* Agent 支持的功能列表。
*/
SupportFeatures?: Array<string>;
}
/**
* DisableRegisterCodes请求参数结构体
*/
export interface DisableRegisterCodesRequest {
/**
* 注册码ID。
可通过 [DescribeRegisterCodes(查询注册码)](https://cloud.tencent.com/document/api/1340/96925) 接口获取。
*/
RegisterCodeIds: Array<string>;
}
/**
* DescribeRegisterInstances请求参数结构体
*/
export interface DescribeRegisterInstancesRequest {
/**
* 托管实例 id。
参数不支持同时指定 `InstanceIds` 和 `Filters` 。
*/
InstanceIds?: Array<string>;
/**
* 过滤器列表。参数不支持同时指定 `InstanceIds` 和 `Filters` 。
- instance-name
按照【托管实例名称】进行过滤。
类型:String
必选:否
- instance-id
按照【托管实例ID】进行过滤。
类型:String
必选:否
- register-code-id
按照【托管实例注册码ID】进行过滤。可通过 [DescribeRegisterCodes(查询注册码)](https://cloud.tencent.com/document/api/1340/96925) 接口获取。
类型:String
必选:否
- sys-name
按照【操作系统类型】进行过滤,取值:Linux | Windows。
类型:String
必选:否
*/
Filters?: Array<Filter>;
/**
* 偏移量,默认为 0。
*/
Offset?: number;
/**
* 返回数量,默认为 20,最大值为 100。
*/
Limit?: number;
}
/**
* DeleteRegisterCodes请求参数结构体
*/
export interface DeleteRegisterCodesRequest {
/**
* 注册码ID列表。限制输入的注册码ID数量大于0小于100。
可通过 [DescribeRegisterCodes(查询注册码)](https://cloud.tencent.com/document/api/1340/96925) 接口获取。
*/
RegisterCodeIds: Array<string>;
}
/**
* 执行活动详情。
*/
export interface Invocation {
/**
* 执行活动ID。
*/
InvocationId?: string;
/**
* 命令ID。
*/
CommandId?: string;
/**
* 执行任务状态。取值范围:
- PENDING:等待下发
- RUNNING:命令运行中
- CANCELLING:取消中
- SUCCESS:命令成功
- TIMEOUT:命令超时
- FAILED:命令失败
- CANCELLED:命令全部取消
- PARTIAL_FAILED:命令部分失败
- PARTIAL_CANCELLED:命令部分取消
*/
InvocationStatus?: string;
/**
* 执行任务信息列表。
*/
InvocationTaskBasicInfoSet?: Array<InvocationTaskBasicInfo>;
/**
* 执行活动描述。
*/
Description?: string;
/**
* 执行活动开始时间。格式为:YYYY-MM-DDThh:mm:ssZ
*/
StartTime?: string;
/**
* 执行活动结束时间。格式为:YYYY-MM-DDThh:mm:ssZ
*/
EndTime?: string;
/**
* 执行活动创建时间。格式为:YYYY-MM-DDThh:mm:ssZ
*/
CreatedTime?: string;
/**
* 执行活动更新时间。格式为:YYYY-MM-DDThh:mm:ssZ
*/
UpdatedTime?: string;
/**
* 自定义参数取值。
*/
Parameters?: string;
/**
* 自定义参数的默认取值。
*/
DefaultParameters?: string;
/**
* 执行命令的实例类型,取值范围:CVM、LIGHTHOUSE。
*/
InstanceKind?: string;
/**
* 在实例上执行命令时使用的用户名。
*/
Username?: string;
/**
* 调用来源。
- USER:来源于用户调用。
- INVOKER:来源于定时执行。
*/
InvocationSource?: string;
/**
* base64编码的命令内容
*/
CommandContent?: string;
/**
* 命令类型
*/
CommandType?: string;
/**
* 执行命令过期时间, 单位秒
*/
Timeout?: number;
/**
* 执行命令的工作路径
*/
WorkingDirectory?: string;
/**
* 日志上传的cos bucket 地址。
*/
OutputCOSBucketUrl?: string;
/**
* 日志在cos bucket中的目录。
*/
OutputCOSKeyPrefix?: string;
}
/**
* 用户配额信息。
*/
export interface GeneralResourceQuotaSet {
/**
* 资源名称
取值为:
- COMMAND:命令
- REGISTER_CODE:托管实例注册码
*/
ResourceName?: string;
/**
* 已使用额度
*/
ResourceQuotaUsed?: number;
/**
* 总额度
*/
ResourceQuotaTotal?: number;
}
/**
* RunCommand请求参数结构体
*/
export interface RunCommandRequest {
/**
* Base64编码后的命令内容,长度不可超过64KB。
*/
Content: string;
/**
* 待执行命令的实例ID列表,上限200。
可通过对应云产品的查询实例接口获取实例 ID。目前支持实例类型:
- CVM
- Lighthouse
- TAT 托管实例
*/
InstanceIds: Array<string>;
/**
* 命令名称。名称仅支持中文、英文、数字、下划线、分隔符"-"、小数点,最大长度不能超60个字节。
*/
CommandName?: string;
/**
* 命令描述。不超过120字符。
*/
Description?: string;
/**
* 命令类型,目前支持取值:SHELL、POWERSHELL、BAT。默认:SHELL。
*/
CommandType?: string;
/**
* 命令执行路径,对于 SHELL 命令默认为 /root,对于 POWERSHELL 命令默认为 C:\Program Files\qcloud\tat_agent\workdir。
*/
WorkingDirectory?: string;
/**
* 命令超时时间,默认60秒。取值范围[1, 86400]。
*/
Timeout?: number;
/**
* 是否保存命令,取值范围:
<li> true:保存</li>
<li> false:不保存</li>
默认为 false。
*/
SaveCommand?: boolean;
/**
* 是否启用自定义参数功能。
一旦创建,此值不提供修改。
取值范围:
<li> true:启用 </li>
<li> false:不启用 </li>
默认值:false。
*/
EnableParameter?: boolean;
/**
* 启用自定义参数功能时,自定义参数的默认取值。字段类型为json encoded string。如:{"varA": "222"}。
key为自定义参数名称,value为该参数的默认取值。kv均为字符串型。
仅在命令的 EnableParameter 为 true 时,才允许设置此参数。
参数不支持同时指定 `DefaultParameters` 和 `DefaultParameterConfs` 。
如果 Parameters 未提供,将使用这里的默认值进行替换。
自定义参数最多20个。
自定义参数名称需符合以下规范:字符数目上限64,可选范围【a-zA-Z0-9-_】。
*/
DefaultParameters?: string;
/**
* 自定义参数数组。 如果 Parameters 未提供,将使用这里的默认值进行替换。 自定义参数最多20个。
如果 Parameters 未提供,将使用这里的默认值进行替换。
仅在命令的 EnableParameter 为 true 时,才允许设置此参数。
参数不支持同时指定 `DefaultParameters` 和 `DefaultParameterConfs` 。
*/
DefaultParameterConfs?: Array<DefaultParameterConf>;
/**
* Command 的自定义参数。字段类型为json encoded string。如:{"varA": "222"}。
key为自定义参数名称,value为该参数的默认取值。kv均为字符串型。
仅在命令的 EnableParameter 为 true 时,才允许设置此参数。
如果未提供该参数取值,将使用 DefaultParameters 或 DefaultParameterConfs 进行替换。
自定义参数最多20个。
自定义参数名称需符合以下规范:字符数目上限64,可选范围【a-zA-Z0-9-_】。
*/
Parameters?: string;
/**
* 如果保存命令,可为命令设置标签。列表长度不超过10。
*/
Tags?: Array<Tag>;
/**
* 在 CVM 或 Lighthouse 实例中执行命令的用户名称。
使用最小权限执行命令是权限管理的最佳实践,建议您以普通用户身份执行云助手命令。默认情况下,在 Linux 实例中以 root 用户执行命令;在Windows 实例中以 System 用户执行命令。
*/
Username?: string;
/**
* 指定日志上传的cos bucket 地址,必须以https开头,如 https://BucketName-123454321.cos.ap-beijing.myqcloud.com。
*/
OutputCOSBucketUrl?: string;
/**
* 指定日志在cos bucket中的目录,目录命名有如下规则:
1. 可用数字、中英文和可见字符的组合,长度最多为60。
2. 用 / 分割路径,可快速创建子目录。
3. 不允许连续 / ;不允许以 / 开头;不允许以..作为文件夹名称。
*/
OutputCOSKeyPrefix?: string;
}
/**
* InvokeCommand请求参数结构体
*/
export interface InvokeCommandRequest {
/**
* 待触发的命令ID。可通过 [DescribeCommands(查询命令详情)](https://cloud.tencent.com/document/api/1340/52681) 接口获取。
*/
CommandId: string;
/**
* 待执行命令的实例ID列表,上限200。
可通过对应云产品的查询实例接口获取实例 ID。目前支持实例类型:
- CVM
- Lighthouse
- TAT 托管实例
*/
InstanceIds: Array<string>;
/**
* Command 的自定义参数。字段类型为json encoded string。如:{"varA": "222"}。
key为自定义参数名称,value为该参数的默认取值。kv均为字符串型。
仅在命令的 EnableParameter 为 true 时,才允许设置此参数。可通过 [DescribeCommands(查询命令详情)](https://cloud.tencent.com/document/api/1340/52681) 接口获取命令的 EnableParameter 设置。
如果未提供该参数取值,将使用 Command 的 DefaultParameters 或 DefaultParameterConfs 进行替换。
自定义参数最多20个。
自定义参数名称需符合以下规范:字符数目上限64,可选范围【a-zA-Z0-9-_】。
*/
Parameters?: string;
/**
* 在 CVM 或 Lighthouse 实例中执行命令的用户名称。
使用最小权限执行命令是权限管理的最佳实践,建议您以普通用户身份执行云助手命令。若不填,默认以 Command 配置的 Username 执行。
*/
Username?: string;
/**
* 命令执行路径, 默认以Command配置的WorkingDirectory执行。
*/
WorkingDirectory?: string;
/**
* 命令超时时间,取值范围[1, 86400]。默认以Command配置的Timeout执行。
*/
Timeout?: number;
/**
* 指定日志上传的cos bucket 地址,必须以https开头,如 https://BucketName-123454321.cos.ap-beijing.myqcloud.com。
*/
OutputCOSBucketUrl?: string;
/**
* 指定日志在cos bucket中的目录,目录命名有如下规则:
1. 可用数字、中英文和可见字符的组合,长度最多为60。
2. 用 / 分割路径,可快速创建子目录。
3. 不允许连续 / ;不允许以 / 开头;不允许以..作为文件夹名称。
*/
OutputCOSKeyPrefix?: string;
}
/**
* DescribeInvocationTasks请求参数结构体
*/
export interface DescribeInvocationTasksRequest {
/**
* 执行任务ID列表,每次请求的上限为100。参数不支持同时指定 `InvocationTaskIds` 和 `Filters`。
*/
InvocationTaskIds?: Array<string>;
/**
* 过滤条件。<br>
- invocation-task-id - String - 是否必填:否 -(过滤条件)按照执行任务ID过滤。
- invocation-id - String - 是否必填:否 -(过滤条件)按照执行活动ID过滤。可通过 [DescribeInvocations(查询执行活动)](https://cloud.tencent.com/document/api/1340/52679) 接口获取。
- instance-id - String - 是否必填:否 -(过滤条件)按照实例ID过滤。可通过对应云产品的查询实例接口获取实例 ID。目前支持实例类型: CVM、Lighthouse、TAT 托管实例
- command-id - String - 是否必填:否 -(过滤条件)按照命令ID过滤。可通过 [DescribeCommands(查询命令详情)](https://cloud.tencent.com/document/api/1340/52681) 接口获取。
每次请求的 `Filters` 的上限为10, `Filter.Values` 的上限为5。参数不支持同时指定 `InvocationTaskIds` 和 `Filters` 。
*/
Filters?: Array<Filter>;
/**
* 返回数量,默认为20,最大值为100。关于 `Limit` 的更进一步介绍请参考 API [简介](https://cloud.tencent.com/document/api/213/15688)中的相关小节。
*/
Limit?: number;
/**
* 偏移量,默认为0。关于 `Offset` 的更进一步介绍请参考 API [简介](https://cloud.tencent.com/document/api/213/15688)中的相关小节。
*/
Offset?: number;
/**
* 是否隐藏命令输出结果,取值范围:
- true:隐藏输出
- false:不隐藏
默认为 true。
*/
HideOutput?: boolean;
}
/**
* DeleteRegisterInstance返回参数结构体
*/
export interface DeleteRegisterInstanceResponse {
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* DescribeRegions请求参数结构体
*/
export declare type DescribeRegionsRequest = null;
/**
* 命令执行详情。
*/
export interface CommandDocument {
/**
* Base64 编码后的执行命令。
*/
Content?: string;
/**
* 命令类型。取值为 SHELL、POWERSHELL、BAT 之一。
*/
CommandType?: string;
/**
* 超时时间。单位:秒。
*/
Timeout?: number;
/**
* 执行路径。
*/
WorkingDirectory?: string;
/**
* 执行用户。
*/
Username?: string;
/**
* 保存输出的 COS Bucket 链接。
*/
OutputCOSBucketUrl?: string;
/**
* 保存输出的文件名称前缀。
*/
OutputCOSKeyPrefix?: string;
}
/**
* DescribeInvokerRecords返回参数结构体
*/
export interface DescribeInvokerRecordsResponse {
/**
* 符合条件的历史记录数量。
*/
TotalCount?: number;
/**
* 执行器执行历史记录。
*/
InvokerRecordSet?: Array<InvokerRecord>;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 任务结果。
*/
export interface TaskResult {
/**
* 命令执行ExitCode。
*/
ExitCode?: number;
/**
* Base64编码后的命令输出。最大长度24KB。
*/
Output?: string;
/**
* 命令执行开始时间。格式为:YYYY-MM-DDThh:mm:ssZ
注意:此字段可能返回 null,表示取不到有效值。
*/
ExecStartTime?: string;
/**
* 命令执行结束时间。格式为:YYYY-MM-DDThh:mm:ssZ
注意:此字段可能返回 null,表示取不到有效值。
*/
ExecEndTime?: string;
/**
* 命令最终输出被截断的字节数。
*/
Dropped?: number;
/**
* 日志在cos中的地址
*/
OutputUrl?: string;
/**
* 日志上传cos的错误信息。
*/
OutputUploadCOSErrorInfo?: string;
}
/**
* ModifyInvoker请求参数结构体
*/
export interface ModifyInvokerRequest {
/**
* 待修改的执行器ID。
可通过 [DescribeInvokers(查询执行器)](https://cloud.tencent.com/document/api/1340/61759) 接口获取。
*/
InvokerId: string;
/**
* 待修改的执行器名称。
*/
Name?: string;
/**
* 执行器类型,当前仅支持周期类型执行器,取值:`SCHEDULE` 。
*/
Type?: string;
/**
* 待修改的命令ID。
可通过 [DescribeCommands(查询命令详情)](https://cloud.tencent.com/document/api/1340/52681) 接口获取。
*/
CommandId?: string;
/**
* 待修改的用户名。
*/
Username?: string;
/**
* 待修改的自定义参数。
仅在 CommandId 所指命令的 EnableParameter 为 true 时,才允许设置此参数。可通过 [DescribeCommands(查询命令详情)](https://cloud.tencent.com/document/api/1340/52681) 接口获取命令的 EnableParameter 设置。
*/
Parameters?: string;
/**
* 待修改的实例ID列表。列表长度上限100。
可通过对应云产品的查询实例接口获取实例 ID。目前支持实例类型:CVM、Lighthouse、TAT 托管实例。
实例需要安装 TAT 客户端, 且客户端为 Online 状态。可通过 [DescribeAutomationAgentStatus(查询客户端状态)](https://cloud.tencent.com/document/api/1340/52682) 接口查询客户端状态。
*/
InstanceIds?: Array<string>;
/**
* 待修改的周期执行器设置。
*/
ScheduleSettings?: ScheduleSettings;
}
/**
* 执行活动任务简介。
*/
export interface InvocationTaskBasicInfo {
/**
* 执行任务ID。
*/
InvocationTaskId?: string;
/**
* 执行任务状态。取值范围:
- PENDING:等待下发
- DELIVERING:下发中
- DELIVER_DELAYED:延时下发
- DELIVER_FAILED:下发失败
- START_FAILED:命令启动失败
- RUNNING:命令运行中
- SUCCESS:命令成功
- FAILED:命令执行失败,执行完退出码不为 0
- TIMEOUT:命令超时
- TASK_TIMEOUT:客户端无响应
- CANCELLING:取消中
- CANCELLED:已取消(命令启动前就被取消)
- TERMINATED:已中止(命令执行期间被取消)
*/
TaskStatus?: string;
/**
* 实例ID。
*/
InstanceId?: string;
}
/**
* DeleteCommands请求参数结构体
*/
export interface DeleteCommandsRequest {
/**
* 待删除的命令 ID。可通过 [DescribeCommands(查询命令详情)](https://cloud.tencent.com/document/api/1340/52681) 接口获取。
*/
CommandIds: Array<string>;
}
/**
* EnableInvoker返回参数结构体
*/
export interface EnableInvokerResponse {
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* DescribeQuotas请求参数结构体
*/
export interface DescribeQuotasRequest {
/**
* 资源名称
取值为:
- COMMAND:命令
- REGISTER_CODE:托管实例注册码
*/
ResourceNames: Array<string>;
}
/**
* EnableInvoker请求参数结构体
*/
export interface EnableInvokerRequest {
/**
* 待启用的执行器ID。
可通过 [DescribeInvokers(查询执行器)](https://cloud.tencent.com/document/api/1340/61759) 接口获取。
*/
InvokerId: string;
}
/**
* 自定义参数。
*/
export interface DefaultParameterConf {
/**
* 参数名。
*/
ParameterName: string;
/**
* 参数默认值。
*/
ParameterValue: string;
/**
* 参数描述。
*/
ParameterDescription?: string;
}
/**
* DescribeScenes返回参数结构体
*/
export interface DescribeScenesResponse {
/**
* 符合条件的场景总数。
*/
TotalCount?: number;
/**
* 场景详情列表。
*/
SceneSet?: Array<Scene>;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* DescribeRegisterInstances返回参数结构体
*/
export interface DescribeRegisterInstancesResponse {
/**
* 该实例注册过的注册码总数。
*/
TotalCount?: number;
/**
* 被托管的实例信息的列表。
*/
RegisterInstanceSet?: Array<RegisterInstanceInfo>;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* ModifyCommand返回参数结构体
*/
export interface ModifyCommandResponse {
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 描述单个地域信息
*/
export interface RegionInfo {
/**
* 地域名称,例如,ap-guangzhou
*/
Region?: string;
/**
* 地域描述,例如: 广州
*/
RegionName?: string;
/**
* 地域是否可用状态,AVAILABLE 代表可用,UNAVAILABLE 代表不可用。
*/
RegionState?: string;
}
/**
* DescribeInvokers返回参数结构体
*/
export interface DescribeInvokersResponse {
/**
* 满足条件的执行器数量。
*/
TotalCount?: number;
/**
* 执行器信息。
*/
InvokerSet?: Array<Invoker>;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* CancelInvocation返回参数结构体
*/
export interface CancelInvocationResponse {
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* DeleteRegisterInstance请求参数结构体
*/
export interface DeleteRegisterInstanceRequest {
/**
* 托管实例ID。
可通过 [DescribeRegisterInstances(查询托管实例)](https://cloud.tencent.com/document/api/1340/96924) 接口获取。
*/
InstanceId: string;
}
/**
* DeleteCommand返回参数结构体
*/
export interface DeleteCommandResponse {
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* DisableInvoker返回参数结构体
*/
export interface DisableInvokerResponse {
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* DescribeCommands返回参数结构体
*/
export interface DescribeCommandsResponse {
/**
* 符合条件的命令总数。
*/
TotalCount?: number;
/**
* 命令详情列表。
*/
CommandSet?: Array<Command>;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* CreateRegisterCode请求参数结构体
*/
export interface CreateRegisterCodeRequest {
/**
* 注册码描述。最大长度为 128 字符。
*/
Description?: string;
/**
* 注册实例名称前缀。最大长度为 32 字符。
*/
InstanceNamePrefix?: string;
/**
* 该注册码允许注册的实例数目。默认值为 10,最小值为 1,最大值为 10000。
*/
RegisterLimit?: number;
/**
* 该注册码的有效时间,单位为小时。默认值为 4。
- 若传入值小于等于 99999,则以小时为单位设置有效时间。
- 若传入值大于 99999,则设置为长期有效。
*/
EffectiveTime?: number;
/**
* 该注册码限制tat_agent只能从IpAddressRange所描述公网出口进行注册。默认不做限制。
*/
IpAddressRange?: string;
}
/**
* CreateInvoker请求参数结构体
*/
export interface CreateInvokerRequest {
/**
* 执行器名称。
*/
Name: string;
/**
* 执行器类型,当前仅支持周期类型执行器,取值:`SCHEDULE` 。
*/
Type: string;
/**
* 远程命令ID。
可通过 [DescribeCommands(查询命令详情)](https://cloud.tencent.com/document/api/1340/52681) 接口获取。
*/
CommandId: string;
/**
* 触发器关联的实例ID。列表上限 100。
可通过对应云产品的查询实例接口获取实例 ID。目前支持实例类型:CVM、Lighthouse、TAT 托管实例。
实例需要安装 TAT 客户端, 且客户端为 Online 状态。可通过 [DescribeAutomationAgentStatus(查询客户端状态)](https://cloud.tencent.com/document/api/1340/52682) 接口查询客户端状态。
*/
InstanceIds: Array<string>;
/**
* 命令执行用户。
*/
Username?: string;
/**
* 命令自定义参数。
仅在 CommandId 所指命令的 EnableParameter 为 true 时,才允许设置此参数。可通过 [DescribeCommands(查询命令详情)](https://cloud.tencent.com/document/api/1340/52681) 接口获取命令的 EnableParameter 设置。
*/
Parameters?: string;
/**
* 周期执行器设置。当创建周期执行器时,必须指定此参数。
*/
ScheduleSettings?: ScheduleSettings;
}
/**
* DescribeAutomationAgentStatus请求参数结构体
*/
export interface DescribeAutomationAgentStatusRequest {
/**
* 待查询的实例ID列表。
可通过对应云产品的查询实例接口获取实例 ID。目前支持实例类型:CVM、Lighthouse、TAT 托管实例。
参数不支持同时指定 `InstanceIds ` 和 `Filters ` 。
*/
InstanceIds?: Array<string>;
/**
* - agent-status - String - 是否必填:否 -(过滤条件)按照agent状态过滤,取值:Online 在线,Offline 离线。
- environment - String - 是否必填:否 -(过滤条件)按照agent运行环境查询,取值:Linux, Windows。
- instance-id - String - 是否必填:否 -(过滤条件)按照实例ID过滤。 可通过对应云产品的查询实例接口获取实例 ID。目前支持实例类型:CVM、Lighthouse、TAT 托管实例。
参数不支持同时指定 `InstanceIds ` 和 `Filters ` 。
*/
Filters?: Array<Filter>;
/**
* 返回数量,默认为20,最大值为100。关于 `Limit` 的更进一步介绍请参考 API [简介](https://cloud.tencent.com/document/api/213/15688)中的相关小节。
*/
Limit?: number;
/**
* 偏移量,默认为0。关于 `Offset` 的更进一步介绍请参考 API [简介](https://cloud.tencent.com/document/api/213/15688)中的相关小节。
*/
Offset?: number;
}
/**
* InvokeCommand返回参数结构体
*/
export interface InvokeCommandResponse {
/**
* 执行活动ID。
*/
InvocationId?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* ModifyCommand请求参数结构体
*/
export interface ModifyCommandRequest {
/**
* 命令ID。可通过 [DescribeCommands(查询命令详情)](https://cloud.tencent.com/document/api/1340/52681) 接口获取。
*/
CommandId: string;
/**
* 命令名称。名称仅支持中文、英文、数字、下划线、分隔符"-"、小数点,最大长度不能超60个字节。
*/
CommandName?: string;
/**
* 命令描述。不超过120字符。
*/
Description?: string;
/**
* Base64编码后的命令内容,长度不可超过64KB。
*/
Content?: string;
/**
* 命令类型,目前支持取值:SHELL、POWERSHELL、BAT。
*/
CommandType?: string;
/**
* 命令执行路径。
*/
WorkingDirectory?: string;
/**
* 命令超时时间。取值范围[1, 86400]。
*/
Timeout?: number;
/**
* 启用自定义参数功能时,自定义参数的默认取值。字段类型为json encoded string。如:{"varA": "222"}。
参数不支持同时指定 `DefaultParameters` 和 `DefaultParameterConfs` 。
采取整体全覆盖式修改,即修改时必须提供所有新默认值。
仅在命令的 EnableParameter 为 true 时,才允许修改此参数。可通过 [DescribeCommands(查询命令详情)](https://cloud.tencent.com/document/api/1340/52681) 接口获取命令的 EnableParameter 设置。
key为自定义参数名称,value为该参数的默认取值。kv均为字符串型。
自定义参数最多20个。
自定义参数名称需符合以下规范:字符数目上限64,可选范围【a-zA-Z0-9-_】。
*/
DefaultParameters?: string;
/**
* 自定义参数数组。如果 InvokeCommand 时未提供参数取值,将使用这里的默认值进行替换。
参数不支持同时指定 `DefaultParameters` 和 `DefaultParameterConfs` 。
仅在命令的 EnableParameter 为 true 时,才允许修改此参数。可通过 [DescribeCommands(查询命令详情)](https://cloud.tencent.com/document/api/1340/52681) 接口获取命令的 EnableParameter 设置。
自定义参数最多20个。
*/
DefaultParameterConfs?: Array<DefaultParameterConf>;
/**
* 在 CVM 或 Lighthouse 实例中执行命令的用户名称。
使用最小权限执行命令是权限管理的最佳实践,建议您以普通用户身份执行云助手命令。
*/
Username?: string;
/**
* 指定日志上传的cos bucket 地址,必须以https开头,如 https://BucketName-123454321.cos.ap-beijing.myqcloud.com。
*/
OutputCOSBucketUrl?: string;
/**
* 指定日志在cos bucket中的目录,目录命名有如下规则:
1. 可用数字、中英文和可见字符的组合,长度最多为60。
2. 用 / 分割路径,可快速创建子目录。
3. 不允许连续 / ;不允许以 / 开头;不允许以..作为文件夹名称。
*/
OutputCOSKeyPrefix?: string;
}
/**
* DescribeInvokers请求参数结构体
*/
export interface DescribeInvokersRequest {
/**
* 执行器ID列表。
参数不支持同时指定 `InvokerIds ` 和 `Filters ` 。
*/
InvokerIds?: Array<string>;
/**
* 过滤条件:
- invoker-id - String - 是否必填:否 - (过滤条件)按执行器ID过滤。
- command-id - String - 是否必填:否 - (过滤条件)按命令ID过滤。可通过 [DescribeCommands(查询命令详情)](https://cloud.tencent.com/document/api/1340/52681) 接口获取。
- type - String - 是否必填:否 - (过滤条件)按执行器类型过滤。目前仅支持 SCHEDULE 一种。
参数不支持同时指定 `InvokerIds ` 和 `Filters ` 。
*/
Filters?: Array<Filter>;
/**
* 返回数量,默认为20,最大值为100。
*/
Limit?: number;
/**
* 偏移量,默认为0。
*/
Offset?: number;
}
/**
* DescribeCommands请求参数结构体
*/
export interface DescribeCommandsRequest {
/**
* 命令ID列表,每次请求的上限为100。参数不支持同时指定 `CommandIds` 和 `Filters` 。
*/
CommandIds?: Array<string>;
/**
* 过滤条件。
- command-id - String - 是否必填:否 -(过滤条件)按照命令ID过滤。
- command-name - String - 是否必填:否 -(过滤条件)按照命令名称过滤。
- command-type - String - 是否必填:否 -(过滤条件)按照命令类型过滤,取值为 SHELL、POWERSHELL、BAT。
- scene-id - String - 是否必填:否 -(过滤条件)按照场景ID过滤。可通过 [DescribeScenes(查询场景)](https://cloud.tencent.com/document/api/1340/109968) 接口获取场景ID。
- created-by - String - 是否必填:否 -(过滤条件)按照命令创建者过滤,取值为 TAT 或 USER。TAT 代表公共命令,USER 代表由用户创建的命令。
- tag-key - String - 是否必填:否 -(过滤条件)按照标签键进行过滤。
- tag-value - String - 是否必填:否 -(过滤条件)按照标签值进行过滤。
- tag:tag-key - String - 是否必填:否 -(过滤条件)按照标签键值对进行过滤。 tag-key使用具体的标签键进行替换。使用请参考示例4
每次请求的 `Filters` 的上限为10, `Filter.Values` 的上限为5。参数不支持同时指定 `CommandIds` 和 `Filters` 。
*/
Filters?: Array<Filter>;
/**
* 返回数量,默认为20,最大值为100。关于 `Limit` 的更进一步介绍请参考 API [简介](https://cloud.tencent.com/document/api/213/15688)中的相关小节。
*/
Limit?: number;
/**
* 偏移量,默认为0。关于 `Offset` 的更进一步介绍请参考 API [简介](https://cloud.tencent.com/document/api/213/15688)中的相关小节。
*/
Offset?: number;
}
/**
* DeleteInvoker返回参数结构体
*/
export interface DeleteInvokerResponse {
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* DescribeInvocations请求参数结构体
*/
export interface DescribeInvocationsRequest {
/**
* 执行活动ID列表,每次请求的上限为100。参数不支持同时指定 `InvocationIds` 和 `Filters`。
*/
InvocationIds?: Array<string>;
/**
* 过滤条件。<br>
<li> invocation-id - String - 是否必填:否 -(过滤条件)按照执行活动ID过滤。</li>
<li> command-id - String - 是否必填:否 -(过滤条件)按照命令ID过滤。</li>
<li> command-created-by - String - 是否必填:否 -(过滤条件)按照执行的命令类型过滤,取值为 TAT 或 USER,TAT 代表公共命令,USER 代表由用户创建的命令。</li>
<li> instance-kind - String - 是否必填:否 -(过滤条件)按照运行实例类型过滤,取值为 CVM 或 LIGHTHOUSE,CVM 代表实例为云服务器, LIGHTHOUSE 代表实例为轻量应用服务器。</li>
<br>每次请求的 `Filters` 的上限为10, `Filter.Values` 的上限为5。参数不支持同时指定 `InvocationIds` 和 `Filters` 。
*/
Filters?: Array<Filter>;
/**
* 返回数量,默认为20,最大值为100。关于 `Limit` 的更进一步介绍请参考 API [简介](https://cloud.tencent.com/document/api/213/15688)中的相关小节。
*/
Limit?: number;
/**
* 偏移量,默认为0。关于 `Offset` 的更进一步介绍请参考 API [简介](https://cloud.tencent.com/document/api/213/15688)中的相关小节。
*/
Offset?: number;
}
/**
* > 描述键值对过滤器,用于条件过滤查询。例如过滤ID、名称、状态等
> - 若存在多个`Filter`时,`Filter`间的关系为逻辑与(`AND`)关系。
> - 若同一个`Filter`存在多个`Values`,同一`Filter`下`Values`间的关系为逻辑或(`OR`)关系。
>
> 以[DescribeCommands](https://cloud.tencent.com/document/api/1340/52681)接口的`Filters`为例。若我们需要查询命令名称(`command-name`)为 “打印工作目录” ***并且*** 命令类型(`command-type`)为 “POWERSHELL” ***或者*** “BAT” 时,可如下实现:
```
Filters.0.Name=command-name
&Filters.0.Values.0=打印工作目录
&Filters.1.Name=command-type
&Filters.1.Values.0=POWERSHELL
&Filters.1.Values.1=BAT
```
*/
export interface Filter {
/**
* 需要过滤的字段。
*/
Name: string;
/**
* 字段的过滤值。
*/
Values: Array<string>;
}
/**
* DescribeInvocations返回参数结构体
*/
export interface DescribeInvocationsResponse {
/**
* 符合条件的执行活动总数。
*/
TotalCount?: number;
/**
* 执行活动列表。
*/
InvocationSet?: Array<Invocation>;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* DescribeInvocationTasks返回参数结构体
*/
export interface DescribeInvocationTasksResponse {
/**
* 符合条件的执行任务总数。
*/
TotalCount?: number;
/**
* 执行任务列表。
*/
InvocationTaskSet?: Array<InvocationTask>;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 命令详情。
*/
export interface Command {
/**
* 命令ID。
*/
CommandId?: string;
/**
* 命令名称。
*/
CommandName?: string;
/**
* 命令描述。
*/
Description?: string;
/**
* Base64编码后的命令内容。
*/
Content?: string;
/**
* 命令类型。取值为 SHELL、POWERSHELL、BAT 之一。
*/
CommandType?: string;
/**
* 命令执行路径。
*/
WorkingDirectory?: string;
/**
* 命令超时时间。
*/
Timeout?: number;
/**
* 命令创建时间。格式为:YYYY-MM-DDThh:mm:ssZ
*/
CreatedTime?: string;
/**
* 命令更新时间。格式为:YYYY-MM-DDThh:mm:ssZ
*/
UpdatedTime?: string;
/**
* 是否启用自定义参数功能。
*/
EnableParameter?: boolean;
/**
* 自定义参数的默认取值。
*/
DefaultParameters?: string;
/**
* 自定义参数的默认取值。
*/
DefaultParameterConfs?: Array<DefaultParameterConf>;
/**
* 命令关联的场景
*/
Scenes?: Array<string>;
/**
* 命令的结构化描述。公共命令有值,用户命令为空字符串。
*/
FormattedDescription?: string;
/**
* 命令创建者。TAT 代表公共命令,USER 代表个人命令。
*/
CreatedBy?: string;
/**
* 命令关联的标签列表。
*/
Tags?: Array<Tag>;
/**
* 在实例上执行命令的用户名。
*/
Username?: string;
/**
* 日志上传的cos bucket 地址。
*/
OutputCOSBucketUrl?: string;
/**
* 日志在cos bucket中的目录。
*/
OutputCOSKeyPrefix?: string;
}
/**
* PreviewReplacedCommandContent请求参数结构体
*/
export interface PreviewReplacedCommandContentRequest {
/**
* 本次预览采用的自定义参数。字段类型为 json encoded string,如:{"varA": "222"}。
仅在命令的 EnableParameter 为 true 时,才允许设置此参数。可通过 [DescribeCommands(查询命令详情)](https://cloud.tencent.com/document/api/1340/52681) 接口获取命令的 EnableParameter 设置。
如果有设置过 DefaultParameters 或 DefaultParameterConfs,会与 Parameters 进行叠加,优先使用 Parameters 的值。
key 为自定义参数名称,value 为该参数的取值。kv 均为字符串型。
自定义参数最多 20 个。
自定义参数名称需符合以下规范:字符数目上限 64,可选范围【a-zA-Z0-9-_】。
如果将预览的 CommandId 设置过 DefaultParameters,本参数可以为空。
*/
Parameters?: string;
/**
* 要进行替换预览的命令。
可通过 [DescribeCommands(查询命令详情)](https://cloud.tencent.com/document/api/1340/52681) 接口获取。
CommandId 与 Content,必须且只能提供一个。
*/
CommandId?: string;
/**
* 要预览的命令内容,经 Base64 编码,长度不可超过 64KB。
CommandId 与 Content,必须且只能提供一个。
*/
Content?: string;
}
/**
* 执行任务。
*/
export interface InvocationTask {
/**
* 执行活动ID。
*/
InvocationId?: string;
/**
* 执行任务ID。
*/
InvocationTaskId?: string;
/**
* 命令ID。
*/
CommandId?: string;
/**
* 执行任务状态。取值范围:
- PENDING:等待下发
- DELIVERING:下发中
- DELIVER_DELAYED:延时下发
- DELIVER_FAILED:下发失败
- START_FAILED:命令启动失败
- RUNNING:命令运行中
- SUCCESS:命令成功
- FAILED:命令执行失败,执行完退出码不为 0
- TIMEOUT:命令超时
- TASK_TIMEOUT:客户端无响应
- CANCELLING:取消中
- CANCELLED:已取消(命令启动前就被取消)
- TERMINATED:已中止(命令执行期间被取消)
*/
TaskStatus?: string;
/**
* 实例ID。
*/
InstanceId?: string;
/**
* 执行结果。
*/
TaskResult?: TaskResult;
/**
* 执行任务开始时间。格式为:YYYY-MM-DDThh:mm:ssZ
注意:此字段可能返回 null,表示取不到有效值。
*/
StartTime?: string;
/**
* 执行任务结束时间。格式为:YYYY-MM-DDThh:mm:ssZ
注意:此字段可能返回 null,表示取不到有效值。
*/
EndTime?: string;
/**
* 创建时间。格式为:YYYY-MM-DDThh:mm:ssZ
*/
CreatedTime?: string;
/**
* 更新时间。格式为:YYYY-MM-DDThh:mm:ssZ
*/
UpdatedTime?: string;
/**
* 执行任务所执行的命令详情。
*/
CommandDocument?: CommandDocument;
/**
* 执行任务失败时的错误信息。
*/
ErrorInfo?: string;
/**
* 调用来源。
- USER:来源于用户调用。
- INVOKER:来源于定时执行。
*/
InvocationSource?: string;
}
/**
* ModifyInvoker返回参数结构体
*/
export interface ModifyInvokerResponse {
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* ModifyRegisterInstance返回参数结构体
*/
export interface ModifyRegisterInstanceResponse {
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 执行器执行记录。
*/
export interface InvokerRecord {
/**
* 执行器ID。
*/
InvokerId?: string;
/**
* 执行时间。格式为:YYYY-MM-DDThh:mm:ssZ
*/
InvokeTime?: string;
/**
* 执行原因。
*/
Reason?: string;
/**
* 命令执行ID。
*/
InvocationId?: string;
/**
* 触发结果。
- PENDING:等待下发
- RUNNING:命令运行中
- CANCELLING:取消中
- SUCCESS:命令成功
- TIMEOUT:命令超时
- FAILED:命令失败
- CANCELLED:命令全部取消
- PARTIAL_FAILED:命令部分失败
- PARTIAL_CANCELLED:命令部分取消
*/
Result?: string;
}
/**
* DescribeRegisterCodes返回参数结构体
*/
export interface DescribeRegisterCodesResponse {
/**
* 查询到的注册码总数。
*/
TotalCount?: number;
/**
* 注册码信息列表。
*/
RegisterCodeSet?: Array<RegisterCodeInfo>;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* DescribeAutomationAgentStatus返回参数结构体
*/
export interface DescribeAutomationAgentStatusResponse {
/**
* Agent 信息列表。
*/
AutomationAgentSet?: Array<AutomationAgentInfo>;
/**
* 符合条件的 Agent 总数。
*/
TotalCount?: number;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* CreateInvoker返回参数结构体
*/
export interface CreateInvokerResponse {
/**
* 执行器ID。
*/
InvokerId?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* CancelInvocation请求参数结构体
*/
export interface CancelInvocationRequest {
/**
* 执行活动ID。
可通过 [DescribeInvocations(查询执行活动)](https://cloud.tencent.com/document/api/1340/52679) 接口获取。
*/
InvocationId: string;
/**
* 实例ID列表,上限100。
可通过对应云产品的查询实例接口获取实例 ID。目前支持实例类型:
- CVM
- Lighthouse
- TAT 托管实例
*/
InstanceIds?: Array<string>;
}
/**
* DescribeRegisterCodes请求参数结构体
*/
export interface DescribeRegisterCodesRequest {
/**
* 注册码ID。
*/
RegisterCodeIds?: Array<string>;
/**
* 偏移量,默认为 0。
*/
Offset?: number;
/**
* 返回数量,默认为 20,最大值为 100。
*/
Limit?: number;
}
/**
* DeleteCommand请求参数结构体
*/
export interface DeleteCommandRequest {
/**
* 待删除的命令 ID。可通过 [DescribeCommands(查询命令详情)](https://cloud.tencent.com/document/api/1340/52681) 接口获取。
*/
CommandId: string;
}
/**
* DeleteCommands返回参数结构体
*/
export interface DeleteCommandsResponse {
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 场景详情。
*/
export interface Scene {
/**
* 场景 ID 。
*/
SceneId?: string;
/**
* 场景名称。
*/
SceneName?: string;
/**
* 场景创建者。
- TAT:公共场景
*/
CreatedBy?: string;
/**
* 创建时间。格式为:YYYY-MM-DDThh:mm:ssZ
*/
CreatedTime?: string;
/**
* 更新时间。格式为:YYYY-MM-DDThh:mm:ssZ
*/
UpdatedTime?: string;
}
/**
* DescribeScenes请求参数结构体
*/
export interface DescribeScenesRequest {
/**
* 场景 ID 数组。
参数不支持同时指定 `SceneIds ` 和 `Filters ` 。
*/
SceneIds?: Array<string>;
/**
* 过滤条件。
- scene-id - String - 是否必填:否 -(过滤条件)按照场景 ID 过滤。
- scene-name - String - 是否必填:否 -(过滤条件)按照场景名称过滤。
- created-by - String - 是否必填:否 -(过滤条件)按照场景创建者过滤,目前仅支持 TAT,代表公共场景。
每次请求的 `Filters` 的上限为10, `Filter.Values` 的上限为5。参数不支持同时指定 `SceneIds` 和 `Filters` 。
*/
Filters?: Array<Filter>;
/**
* 返回数量,默认为20,最大值为100。关于 `Limit` 的更进一步介绍请参考 API [简介](https://cloud.tencent.com/document/api/213/15688)中的相关小节。
*/
Limit?: number;
/**
* 偏移量,默认为0。关于 `Offset` 的更进一步介绍请参考 API [简介](https://cloud.tencent.com/document/api/213/15688)中的相关小节。
*/
Offset?: number;
}
/**
* DeleteRegisterCodes返回参数结构体
*/
export interface DeleteRegisterCodesResponse {
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* DescribeInvokerRecords请求参数结构体
*/
export interface DescribeInvokerRecordsRequest {
/**
* 执行器ID列表。列表上限 100。
可通过 [DescribeInvokers(查询执行器)](https://cloud.tencent.com/document/api/1340/61759) 接口获取。
*/
InvokerIds?: Array<string>;
/**
* 返回数量,默认为20,最大值为100。
*/
Limit?: number;
/**
* 偏移量,默认为0。
*/
Offset?: number;
}
/**
* DeleteInvoker请求参数结构体
*/
export interface DeleteInvokerRequest {
/**
* 待删除的执行器ID。
可通过 [DescribeInvokers(查询执行器)](https://cloud.tencent.com/document/api/1340/61759) 接口获取。
*/
InvokerId: string;
}
/**
* ModifyRegisterInstance请求参数结构体
*/
export interface ModifyRegisterInstanceRequest {
/**
* 托管实例ID。
可通过 [DescribeRegisterInstances(查询托管实例)](https://cloud.tencent.com/document/api/1340/96924) 接口获取。
*/
InstanceId: string;
/**
* 实例名称。有效长度为 1~60 字符。
*/
InstanceName: string;
}
/**
* 标签
*/
export interface Tag {
/**
* 标签键。
*/
Key: string;
/**
* 标签值。
*/
Value: string;
}
/**
* RunCommand返回参数结构体
*/
export interface RunCommandResponse {
/**
* 命令ID。
*/
CommandId?: string;
/**
* 执行活动ID。
*/
InvocationId?: string;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* DisableRegisterCodes返回参数结构体
*/
export interface DisableRegisterCodesResponse {
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* DescribeQuotas返回参数结构体
*/
export interface DescribeQuotasResponse {
/**
* 资源额度列表
*/
GeneralResourceQuotaSet?: Array<GeneralResourceQuotaSet>;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* 注册码信息。
*/
export interface RegisterCodeInfo {
/**
* 注册码ID。
*/
RegisterCodeId?: string;
/**
* 注册码描述。
*/
Description?: string;
/**
* 注册实例名称前缀。
*/
InstanceNamePrefix?: string;
/**
* 该注册码允许注册的实例数目。
*/
RegisterLimit?: number;
/**
* 该注册码的过期时间,按照 ISO8601 标准表示,并且使用 UTC 时间。
格式为: YYYY-MM-DDThh:mm:ssZ。
注意:此字段可能返回 null,表示取不到有效值。
*/
ExpiredTime?: string;
/**
* 该注册码限制tat_agent只能从IpAddressRange所描述公网出口进行注册。
*/
IpAddressRange?: string;
/**
* 该注册码是否可用。
*/
Enabled?: boolean;
/**
* 该注册码已注册数目。
*/
RegisteredCount?: number;
/**
* 注册码创建时间,按照 ISO8601 标准表示,并且使用 UTC 时间。
格式为: YYYY-MM-DDThh:mm:ssZ。
注意:此字段可能返回 null,表示取不到有效值。
*/
CreatedTime?: string;
/**
* 注册码最近一次更新时间,按照 ISO8601 标准表示,并且使用 UTC 时间。
格式为: YYYY-MM-DDThh:mm:ssZ。
注意:此字段可能返回 null,表示取不到有效值。
*/
UpdatedTime?: string;
}
/**
* DescribeRegions返回参数结构体
*/
export interface DescribeRegionsResponse {
/**
* 地域数量
*/
TotalCount?: number;
/**
* 地域信息列表
*/
RegionSet?: Array<RegionInfo>;
/**
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
*/
RequestId?: string;
}
/**
* CreateCommand请求参数结构体
*/
export interface CreateCommandRequest {
/**
* 命令名称。名称仅支持中文、英文、数字、下划线、分隔符"-"、小数点,最大长度不能超60个字节。
*/
CommandName: string;
/**
* Base64编码后的命令内容,长度不可超过64KB。
*/
Content: string;
/**
* 命令描述。不超过120字符。
*/
Description?: string;
/**
* 命令类型,目前支持取值:SHELL、POWERSHELL、BAT。默认:SHELL。
*/
CommandType?: string;
/**
* 命令执行路径,对于 SHELL 命令默认为 /root,对于 POWERSHELL 命令默认为 C:\Program Files\qcloud\tat_agent\workdir。
*/
WorkingDirectory?: string;
/**
* 命令超时时间,默认60秒。取值范围[1, 86400]。
*/
Timeout?: number;
/**
* 是否启用自定义参数功能。
一旦创建,此值不提供修改。
默认值:false。
*/
EnableParameter?: boolean;
/**
* 启用自定义参数功能时,自定义参数的默认取值。字段类型为json encoded string。如:{"varA": "222"}。
key为自定义参数名称,value为该参数的默认取值。kv均为字符串型。
如果InvokeCommand时未提供参数取值,将使用这里的默认值进行替换。
参数不支持同时指定 `DefaultParameters` 和 `DefaultParameterConfs` 。
仅在 EnableParameter 参数为 true 时,才允许设置此参数。
自定义参数最多20个。
自定义参数名称需符合以下规范:字符数目上限64,可选范围【a-zA-Z0-9-_】。
*/
DefaultParameters?: string;
/**
* 自定义参数数组。
如果InvokeCommand时未提供参数取值,将使用这里的默认值进行替换。
参数不支持同时指定 `DefaultParameters` 和 `DefaultParameterConfs` 。
仅在 EnableParameter 参数为 true 时,才允许设置此参数。
自定义参数最多20个。
*/
DefaultParameterConfs?: Array<DefaultParameterConf>;
/**
* 为命令关联的标签,列表长度不超过10。
*/
Tags?: Array<Tag>;
/**
* 在 CVM 或 Lighthouse 实例中执行命令的用户名称。
使用最小权限执行命令是权限管理的最佳实践,建议您以普通用户身份执行云助手命令。默认情况下,在 Linux 实例中以 root 用户执行命令;在Windows 实例中以 System 用户执行命令。
*/
Username?: string;
/**
* 指定日志上传的cos bucket 地址,必须以https开头,如 https://BucketName-123454321.cos.ap-beijing.myqcloud.com。
*/
OutputCOSBucketUrl?: string;
/**
* 指定日志在cos bucket中的目录,目录命名有如下规则:
1. 可用数字、中英文和可见字符的组合,长度最多为60。
2. 用 / 分割路径,可快速创建子目录。
3. 不允许连续 / ;不允许以 / 开头;不允许以..作为文件夹名称
*/
OutputCOSKeyPrefix?: string;
}
/**
* 执行器信息。
*/
export interface Invoker {
/**
* 执行器ID。
*/
InvokerId?: string;
/**
* 执行器名称。
*/
Name?: string;
/**
* 执行器类型。目前仅支持 SCHEDULE 一种。
*/
Type?: string;
/**
* 命令ID。
*/
CommandId?: string;
/**
* 用户名。
*/
Username?: string;
/**
* 自定义参数。
*/
Parameters?: string;
/**
* 实例ID列表。
*/
InstanceIds?: Array<string>;
/**
* 执行器是否启用。
*/
Enable?: boolean;
/**
* 执行器周期计划。周期执行器会返回此字段。
*/
ScheduleSettings?: ScheduleSettings;
/**
* 创建时间。格式为:YYYY-MM-DDThh:mm:ssZ
*/
CreatedTime?: string;
/**
* 修改时间。格式为:YYYY-MM-DDThh:mm:ssZ
*/
UpdatedTime?: string;
}