开发者社区 问答 正文

Swarm API参考  集群API列表  重置节点

重置集群中的某个节点。

        说明
重置过程中会替换系统盘,需要提前做好数据备份。





请求信息


请求行 RequestLinePOST /clusters/{cluster_id}/instances/{instance_id}/reset HTTP/1.1
请求行参数 URI Param

[tr=rgb(51, 205, 229)][td]名称 类型是否必须描述cluster_idstring是集群 IDinstance_idstring是ECS实例 ID
特有请求头 RequestHead
无,请参考 公共请求头部
请求体 RequestBody
{
    "password": "ECS实例root登录密码",
    "ecs_image_id": "操作系统镜像",
    "release_eip_flag": "是否需要在集群配置完成后释放EIP"
}

请求体解析
[tr=rgb(51, 205, 229)][td]名称 类型是否必须描述passwordString是ECS 实例密码。ecs_image_idString是ECS 使用的系统镜像 ID。release_eip_flagbool可选配置完集群后是否释放 EIP,默认为 false。
ecs_image_id 列表
请参考文档 查看镜像列表 获取 ecs_image_id 列表。如果您需要自定义集群的 ECS 镜像的 ID,需要保证 ECS 镜像满足以下条件:
  • 操作系统:Ubuntu、Centos。
  • Linux Kernel version ≥ 3.18,用于支持 overlayfs 以及 overlay network。
  • 镜像中删除 /etc/docker/key.json 文件。


返回信息


返回行 ResponseLineHTT P/1.1 202 OK
特有返回头 ResponseHead
无,请参考 公共返回头部
返回体 ResponseBody
{
    "cluster_id": "string",
    "request_id": "string",
    "task_id": "string"
}


示例


请求示例
POST /clusters/Cccfd68c474454665ace07efce924f75f/instances/i-xx/reset HTTP/1.1
<公共请求头>
返回示例
HTTP/1.1 202 Accepted
<公共响应头>
{
    "cluster_id": "c2ac959c94acc4e86aca4e68bdf7c1987",
    "request_id": "B145E765-2800-40E5-9167-9E999574ABF8",
    "task_id": "T-5a544d2b9645f75f2e00003d"
}




展开
收起
青蛙跳 2018-08-31 23:29:00 1499 分享 版权
阿里云 AI 助理回答

要重置阿里云E-HPC集群中的某个节点,您需要通过调用相关API来执行此操作。以下是重置过程的详细步骤和注意事项:

操作概述

  • 目标:本操作旨在重置指定E-HPC集群中的一个或多个计算节点,过程中系统盘会被替换,因此重要数据必须提前备份。
  • 方式:通过API调用实现节点重置。

详细步骤

  1. 准备数据与参数

    • 数据备份:确保所有重要数据已从待重置节点的系统盘中备份到其他安全位置,因为重置会覆盖系统盘内容。
    • 收集信息:获取所需的集群ID (cluster_id) 和实例ID (instance_id)。可以通过调用ListClustersListNodes API获取这些信息。
    • 设置重置参数:准备请求体参数,包括ECS实例的新密码、操作系统镜像ID以及是否在集群配置完成后释放EIP(如果适用)。
  2. 构造API请求

    • 请求方法POST
    • 请求URL/clusters/{cluster_id}/instances/{instance_id}/reset
    • 请求头:包含必要的认证信息,如AccessKey ID和AccessKey Secret,遵循阿里云API调用的公共请求头部规范。
    • 请求体
      {
      "password": "新设置的ECS实例root登录密码",
      "ecs_image_id": "选择的操作系统镜像ID",
      "release_eip_flag": false // 或true,根据需求设定
      }
      
    • 注意ecs_image_id需参考文档提供的镜像列表,确保所选镜像满足E-HPC集群的要求。
  3. 发送请求:使用HTTP客户端或编程语言的库(如Python的requests库),将构造好的请求发送至阿里云E-HPC服务端点。

  4. 处理响应

    • 成功响应会返回一个JSON对象,包含任务ID (task_id)、集群ID (cluster_id) 和请求ID (request_id)。
    • 使用返回的task_id,可以通过查询任务状态的API来监控重置操作的进度。

注意事项

  • 数据安全务必在操作前完成数据备份,避免数据丢失。
  • 镜像兼容性:选择的ECS镜像需满足E-HPC集群对操作系统的特定要求。
  • API权限:确保调用API的RAM用户或角色具有ehpc:ResetNodes的写入权限。

示例

以下是一个示例请求和响应:

请求示例:

POST /clusters/Cccfd68c474454665ace07efce924f75f/instances/i-xx/reset HTTP/1.1
Content-Type: application/json
Authorization: {YOUR_AUTHORIZATION_HEADER}

{
    "password": "SecurePassw0rd",
    "ecs_image_id": "aliyun_ubuntu_18_04_64_20G_cloudinit_20200619.vhd",
    "release_eip_flag": false
}

响应示例:

HTTP/1.1 202 Accepted
Content-Type: application/json

{
    "cluster_id": "c2ac959c94acc4e86aca4e68bdf7c1987",
    "request_id": "B145E765-2800-40E5-9167-9E999574ABF8",
    "task_id": "T-5a544d2b9645f75f2e00003d"
}

请根据实际情况调整上述示例中的具体参数,并确保遵循阿里云API调用的最佳实践。

有帮助
无帮助
AI 助理回答生成答案可能存在不准确,仅供参考
0 条回答
写回答
取消 提交回答