指定機器。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：
- 操作：是指具體的權限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀?。≧ead）或列出（List）。
- 資源類型：是指操作中支持授權的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權的操作，用
全部資源表示。
- 條件關鍵字：是指云產品自身定義的條件關鍵字。
- 關聯(lián)操作：是指成功執(zhí)行操作所需要的其他權限。操作者必須同時具備關聯(lián)操作的權限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯(lián)操作 |
|---|---|---|---|---|
| edas:ManageSchedulerxDesignateWorkers | create | *全部資源 * |
| 無 |
請求參數(shù)
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| Namespace | string | 是 | 命名空間 UID | 4a06d5ea-f576-4326-842c-fb14ea043d8d |
| NamespaceSource | string | 否 | 命名空間來源 | schedulerx |
| GroupId | string | 是 | 應用分組 ID | hxm.test |
| JobId | long | 是 | 任務 ID | 144153 |
| Transferable | boolean | 是 | 是否故障轉移 | true |
| DesignateType | integer | 是 | 指定機器的類型：1.worker, 2.label | 1 |
| Workers | string | 否 | 指定機器列表 JSON 格式列表 | ["127.0.0.1","127.0.0.2"] |
| Labels | string | 否 | 指定 | ["gray"] |
| RegionId | string | 是 | 地域 | public |
返回參數(shù)
示例
正常返回示例
JSON格式
{
"RequestId": "765xxx",
"Message": "job is not existed",
"Code": 200,
"Success": true,
"AccessDeniedDetail": {
"AuthAction": "",
"AuthPrincipalDisplayName": "",
"AuthPrincipalOwnerId": "",
"AuthPrincipalType": "",
"EncodedDiagnosticMessage": "",
"NoPermissionType": "",
"PolicyType": ""
}
}錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內容概要 | 操作 |
|---|---|---|
| 2024-10-21 | OpenAPI 返回結構發(fā)生變更 | 查看變更詳情 |
| 2022-12-26 | API 內部配置變更，不影響調用 | 查看變更詳情 |
| 2021-12-21 | OpenAPI 入參發(fā)生變更、OpenAPI 返回結構發(fā)生變更 | 查看變更詳情 |
| 2021-12-20 | 新增 OpenAPI | 查看變更詳情 |
示例 Demo
package com.alibaba.schedulerx.pop;
import java.util.List;
import com.alibaba.schedulerx.common.util.JsonUtil;
import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.exceptions.ServerException;
import com.aliyuncs.profile.DefaultProfile;
import com.aliyuncs.schedulerx2.model.v20190430.DesignateWorkersRequest;
import com.aliyuncs.schedulerx2.model.v20190430.DesignateWorkersResponse;
import com.google.common.collect.Lists;
public class TestDesignateWorkers {
public static void main(String[] args) {
// OpenAPI 的接入點，具體查看支持地域列表或根據(jù)購買地域填寫
String regionId = "public";
//鑒權使用的 AccessKey ID，由阿里云官網控制臺獲取
String accessKeyId = "xxxxxxxx";
//鑒權使用的 AccessKey Secret，由阿里云官網控制臺獲取
String accessKeySecret = "xxxxxxxxx";
//產品名稱
String productName ="schedulerx2";
//對照支持地域列表選擇 Domain 填寫
String domain ="schedulerx.aliyuncs.com";
//構建 OpenAPI 客戶端
DefaultProfile.addEndpoint(regionId, productName, domain);
DefaultProfile defaultProfile = DefaultProfile.getProfile(regionId, accessKeyId, accessKeySecret);
DefaultAcsClient client = new DefaultAcsClient(defaultProfile);
DesignateWorkersRequest request = new DesignateWorkersRequest();
request.setNamespace("433d8b23-06e9-408c-aaaa-90d4d1b9a4af");
request.setGroupId("xuren_test");
request.setJobId(3048L);
//是否故障轉移
request.setTransferable(true);
//1 表示指定 worker，2 表示指定 label
request.setDesignateType(1);
List<String> workers = Lists.newArrayList();
workers.add("30.225.16.104");
//workers 需要 json 格式
request.setWorkers(JsonUtil.toJson(workers));
DesignateWorkersResponse response;
try {
response = client.getAcsResponse(request);
System.out.println(JsonUtil.toJson(response));
} catch (ServerException e) {
// TODO Auto-generated catch block
e.printStackTrace();
} catch (ClientException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
}
}