register注册Slave接口
功能介绍
注册创建Slave接口
调试
您可以在API Explorer中调试该接口。
URI
POST /agentregister/v1/agent/register
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
否 |
String |
用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
cluster_id |
是 |
String |
cluster ID |
slave_name |
是 |
String |
Slave名称 |
work_dir |
是 |
String |
Slave工作空间 |
label |
否 |
String |
Slave label |
version |
否 |
String |
agent版本 |
retry |
否 |
Boolean |
是否重试 |
owner_type |
否 |
String |
Slave ownerType |
响应参数
状态码: 201
参数 |
参数类型 |
描述 |
---|---|---|
status |
String |
状态信息 |
result |
Object |
返回结果 |
error |
Object |
返回错误 |
请求示例
{ "cluster_id" : "ba6e170f1e954dab97d55d...", "slave_name" : "SLAVE_pKYFTV5tetaZ", "work_dir" : "/home/jenkins", "label" : "docker", "version" : "1.0.1", "retry" : false, "owner_type" : "customer" }
响应示例
无
状态码
状态码 |
描述 |
---|---|
201 |
Created |
401 |
Unauthorized |
403 |
Forbidden |
404 |
Not Found |
错误码
请参见错误码。
