更新时间:2025-07-04 GMT+08:00
分享

执行公共脚本

功能介绍

执行公共脚本

脚本入参、超时时间、执行用户、资源受限。

接口约束

-脚本入参支持20个。

-单次下发的机器支持200个。

-单次批次内机器数量最大10个。

-最大批次数量为20批。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

POST /v1/job/public-scripts/{script_uuid}

表1 路径参数

参数

是否必选

参数类型

描述

script_uuid

String

参数解释:

公共脚本Uuid。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

租户token。

约束限制:

从IAM获取的租户token。

取值范围:

不涉及。

默认取值:

不涉及。

X-Language

String

参数解释:

国际化标记,zh-cn表示中文,en-us或不传表示英文。

约束限制:

zh-cn表示中文,en-us或不传表示英文。

取值范围:

zh-cn/en-us。

默认取值:

不涉及。

x-project-id

String

参数解释:

项目ID。

约束限制:

region对应的项目ID。

取值范围:

不涉及。

默认取值:

不涉及。

x-user-profile

String

参数解释:

IAM5.0用户信息。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

表3 请求Body参数

参数

是否必选

参数类型

描述

execute_param

ScriptExecuteParam object

参数解释:

脚本执行参数。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

execute_batches

Array of ExecuteInstancesBatchInfo objects

参数解释:

目标实例分批信息。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

表4 ScriptExecuteParam

参数

是否必选

参数类型

描述

resourceful

Boolean

参数解释:

该参数已废弃,传入该参数不会生效。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

timeout

Integer

参数解释:

超时时间。

约束限制:

单位:秒,取值范围:5 < timeout < 1800。

取值范围:

不涉及。

默认取值:

不涉及。

success_rate

Double

参数解释:

成功率,

约束限制:

支持小数点后一位。

取值范围:

1-100。

默认取值:

不涉及。

execute_user

String

参数解释:

脚本执行用户,如:root。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

script_params

Array of ScriptExecuteInputParam objects

参数解释:

脚本入参列表。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

表5 ScriptExecuteInputParam

参数

是否必选

参数类型

描述

param_name

String

参数解释:

脚本入参的名称,同一个脚本,参数名不能重复。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

param_value

String

参数解释:

脚本入参的值,默认必填。有引用参数(param_refer不为空)时,允许为空。

约束限制:

  • 参数长度为1-4096位

  • 可以包含大写字母、小写字母、数字及特殊字符(_-/.* ?:",=+@#[{]})

  • 禁止出现连续'.'

取值范围:

不涉及。

默认取值:

不涉及。

param_order

Integer

参数解释:

【已废弃】该参数已废弃,传入该参数不会生效。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

param_refer

ScriptExecuteParamReference object

参数解释:

参数引用。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

表6 ScriptExecuteParamReference

参数

是否必选

参数类型

描述

refer_type

String

参数解释:

参数引用类型:PARAM_STORE。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

param_id

String

参数解释:

引用参数的唯一主键id。

约束限制:

  • LOW

  • MEDIUM

  • HIGH

取值范围:

不涉及。

默认取值:

不涉及。

param_version

String

参数解释:

引用参数的版本号。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

表7 ExecuteInstancesBatchInfo

参数

是否必选

参数类型

描述

batch_index

Integer

参数解释:

批次索引,从1开始。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

target_instances

Array of ExecuteResourceInstance objects

参数解释:

目标节点列表。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

rotation_strategy

String

参数解释:

暂停继续策略。

约束限制:

  • CONTINUE:继续。

  • PAUSE:暂停。

取值范围:

CONTINUE/PAUSE。

默认取值:

不涉及。

表8 ExecuteResourceInstance

参数

是否必选

参数类型

描述

resource_id

String

参数解释:

ECS云服务器ID。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

region_id

String

参数解释:

服务器所属region。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

provider

String

参数解释:

资源提供者:ECS,不传默认为:ECS。请保证一次执行, 每个实例的provider是一致的。后续扩展CCE等。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

type

String

参数解释:

资源提供者下资源类型,不传默认为CLOUDSERVER。

CLOUDSERVER:CLOUDSERVER类型。

约束限制:

不允许跨type支持。

取值范围:

不涉及。

默认取值:

不涉及。

custom_attributes

Array of Customttribute objects

参数解释:

支持用户自定义5个key_value形式的属性。

约束限制:

  • key值长度为10 。

  • value长度为20 。

  • map长度最大为5。

  • 禁止填写敏感数据。

取值范围:

不涉及。

默认取值:

不涉及。

agent_sn

String

参数解释:

【已废弃】该参数已废弃,传入该参数不会生效。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

project_id

String

参数解释:

【已废弃】该参数已废弃,传入该参数不会生效。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

表9 Customttribute

参数

是否必选

参数类型

描述

key

String

参数解释:

自定义属性key。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

value

String

参数解释:

自定义属性的value。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

响应参数

状态码:200

表10 响应Body参数

参数

参数类型

描述

data

String

执行公共脚本返回体:execute_uuid。

请求示例

执行公共脚本。

POST https://{Endpoint}/v1/job/public-scripts/{script_uuid}

{
  "execute_param" : {
    "timeout" : 300,
    "execute_user" : "SYSTEM",
    "success_rate" : "100.0",
    "script_params" : [ {
      "param_name" : "action",
      "param_value" : "start",
      "param_order" : 1
    } ]
  },
  "execute_batches" : [ {
    "batch_index" : 1,
    "rotation_strategy" : "CONTINUE",
    "target_instances" : [ {
      "agent_sn" : "705c526eb7774c51xxxxxxxxxxxxxxxx",
      "resource_id" : "7c118539-15ab-41d3-xxxxxxxxxxxxxxxx",
      "enterprise_project_id" : "0",
      "project_id" : "10a6c23c2a10447797xxxxxxxxxxxxxxxx",
      "region_id" : "cn-north-x",
      "provider" : "ECS",
      "type" : "CLOUDSERVERS",
      "properties" : {
        "host_name" : "ecs-b007-0001",
        "fixed_ip" : "192.168.x.xx",
        "region_id" : "cn-north-x",
        "zone_id" : "cn-north-xx",
        "project_id" : "10a6c23c2a10447797xxxxxxxxxxxxxxxx"
      }
    } ]
  } ],
  "ticket_infos" : [ ]
}

响应示例

状态码:200

请求成功。

更多状态码请参考状态码

{
  "data" : "SCT2023083109562xxxxxxxxxx"
}

状态码

状态码

描述

200

请求成功。

更多状态码请参考状态码

错误码

请参见错误码

相关文档