华为云用户手册

请求示例 使用node_groups参数组，创建一个启用“集群高可用”功能的集群，集群版本号为 MRS 3.1.0。 POST https://{endpoint}/v1.1/{project_id}/run-job-flow{ "billing_type" : 12, "data_center" : "", "available_zone_id" : "d573142f24894ef3bd3664de068b44b0", "cluster_name" : "mrs_HEbK", "cluster_version" : "MRS 3.1.0", "safe_mode" : 0, "cluster_type" : 0, "component_list" : [ { "component_name" : "Hadoop" }, { "component_name" : "Spark" }, { "component_name" : "HBase" }, { "component_name" : "Hive" }, { "component_name" : "Presto" }, { "component_name" : "Tez" }, { "component_name" : "Hue" }, { "component_name" : "Loader" }, { "component_name" : "Flink" } ], "vpc" : "vpc-4b1c", "vpc_id" : "4a365717-67be-4f33-80c5-98e98a813af8", "subnet_id" : "67984709-e15e-4e86-9886-d76712d4e00a", "subnet_name" : "subnet-4b44", "security_groups_id" : "4820eace-66ad-4f2c-8d46-cf340e3029dd", "enterprise_project_id" : "0", "tags" : [ { "key" : "key1", "value" : "value1" }, { "key" : "key2", "value" : "value2" } ], "node_groups" : [ { "group_name" : "master_node_default_group", "node_num" : 2, "node_size" : "s3.xlarge.2.linux.bigdata", "root_volume_size" : 480, "root_volume_type" : "SATA", "data_volume_type" : "SATA", "data_volume_count" : 1, "data_volume_size" : 600 }, { "group_name" : "core_node_analysis_group", "node_num" : 3, "node_size" : "s3.xlarge.2.linux.bigdata", "root_volume_size" : 480, "root_volume_type" : "SATA", "data_volume_type" : "SATA", "data_volume_count" : 1, "data_volume_size" : 600 }, { "group_name" : "task_node_analysis_group", "node_num" : 2, "node_size" : "s3.xlarge.2.linux.bigdata", "root_volume_size" : 480, "root_volume_type" : "SATA", "data_volume_type" : "SATA", "data_volume_count" : 0, "data_volume_size" : 600, "auto_scaling_policy" : { "auto_scaling_enable" : true, "min_capacity" : 1, "max_capacity" : "3", "resources_plans" : [ { "period_type" : "daily", "start_time" : "9:50", "end_time" : "10:20", "min_capacity" : 2, "max_capacity" : 3 }, { "period_type" : "daily", "start_time" : "10:20", "end_time" : "12:30", "min_capacity" : 0, "max_capacity" : 2 } ], "exec_scripts" : [ { "name" : "before_scale_out", "uri" : "s3a://XXX/zeppelin_install.sh", "parameters" : "${mrs_scale_node_num} ${mrs_scale_type} xxx", "nodes" : [ "master", "core", "task" ], "active_master" : "true", "action_stage" : "before_scale_out", "fail_action" : "continue" }, { "name" : "after_scale_out", "uri" : "s3a://XXX/storm_rebalance.sh", "parameters" : "${mrs_scale_node_hostnames} ${mrs_scale_node_ips}", "nodes" : [ "master", "core", "task" ], "active_master" : "true", "action_stage" : "after_scale_out", "fail_action" : "continue" } ], "rules" : [ { "name" : "default-expand-1", "adjustment_type" : "scale_out", "cool_down_minutes" : 5, "scaling_adjustment" : 1, "trigger" : { "metric_name" : "YARNMemoryAvailablePercentage", "metric_value" : "25", "comparison_operator" : "LT", "evaluation_periods" : 10 } }, { "name" : "default-shrink-1", "adjustment_type" : "scale_in", "cool_down_minutes" : 5, "scaling_adjustment" : 1, "trigger" : { "metric_name" : "YARNMemoryAvailablePercentage", "metric_value" : "70", "comparison_operator" : "GT", "evaluation_periods" : 10 } } ] } } ], "login_mode" : 1, "cluster_master_secret" : "", "cluster_admin_secret" : "", "log_collection" : 1, "add_jobs" : [ { "job_type" : 1, "job_name" : "tenji111", "jar_path" : "s3a://bigdata/program/hadoop-mapreduce-examples-2.7.2.jar", "arguments" : "wordcount", "input" : "s3a://bigdata/input/wd_1k/", "output" : "s3a://bigdata/ouput/", "job_log" : "s3a://bigdata/log/", "shutdown_cluster" : true, "file_action" : "", "submit_job_once_cluster_run" : true, "hql" : "", "hive_script_path" : "" } ], "bootstrap_scripts" : [ { "name" : "Modify os config", "uri" : "s3a://XXX/modify_os_config.sh", "parameters" : "param1 param2", "nodes" : [ "master", "core", "task" ], "active_master" : "false", "before_component_start" : "true", "start_time" : "1667892101", "state" : "IN_PROGRESS", "fail_action" : "continue", "action_stages" : [ "BEFORE_COMPONENT_FIRST_START", "BEFORE_SCALE_IN" ] }, { "name" : "Install zepplin", "uri" : "s3a://XXX/zeppelin_install.sh", "parameters" : "", "nodes" : [ "master" ], "active_master" : "true", "before_component_start" : "false", "start_time" : "1667892101", "state" : "IN_PROGRESS", "fail_action" : "continue", "action_stages" : [ "AFTER_SCALE_IN", "AFTER_SCALE_OUT" ] } ]} 不使用node_groups参数组，创建一个启用“集群高可用”功能的集群，集群版本号为MRS 3.1.0。 POST https://{endpoint}/v1.1/{project_id}/run-job-flow{ "billing_type" : 12, "data_center" : "", "master_node_num" : 2, "master_node_size" : "s3.2xlarge.2.linux.bigdata", "core_node_num" : 3, "core_node_size" : "s1.xlarge.linux.bigdata", "available_zone_id" : "d573142f24894ef3bd3664de068b44b0", "cluster_name" : "newcluster", "vpc" : "vpc1", "vpc_id" : "5b7db34d-3534-4a6e-ac94-023cd36aaf74", "subnet_id" : "815bece0-fd22-4b65-8a6e-15788c99ee43", "subnet_name" : "subnet", "security_groups_id" : "845bece1-fd22-4b45-7a6e-14338c99ee43", "tags" : [ { "key" : "key1", "value" : "value1" }, { "key" : "key2", "value" : "value2" } ], "cluster_version" : "MRS 3.1.0", "cluster_type" : 0, "master_data_volume_type" : "SATA", "master_data_volume_size" : 600, "master_data_volume_count" : 1, "core_data_volume_type" : "SATA", "core_data_volume_size" : 600, "core_data_volume_count" : 2, "node_public_cert_name" : "SSHkey-bba1", "safe_mode" : 0, "log_collection" : 1, "task_node_groups" : [ { "node_num" : 2, "node_size" : "s3.xlarge.2.linux.bigdata", "data_volume_type" : "SATA", "data_volume_count" : 1, "data_volume_size" : 600, "auto_scaling_policy" : { "auto_scaling_enable" : true, "min_capacity" : 1, "max_capacity" : "3", "resources_plans" : [ { "period_type" : "daily", "start_time" : "9: 50", "end_time" : "10: 20", "min_capacity" : 2, "max_capacity" : 3 }, { "period_type" : "daily", "start_time" : "10: 20", "end_time" : "12: 30", "min_capacity" : 0, "max_capacity" : 2 } ], "exec_scripts" : [ { "name" : "before_scale_out", "uri" : "s3a: //XXX/zeppelin_install.sh", "parameters" : "${mrs_scale_node_num}${mrs_scale_type}xxx", "nodes" : [ "master", "core", "task" ], "active_master" : "true", "action_stage" : "before_scale_out", "fail_action" : "continue" }, { "name" : "after_scale_out", "uri" : "s3a: //XXX/storm_rebalance.sh", "parameters" : "${mrs_scale_node_hostnames}${mrs_scale_node_ips}", "nodes" : [ "master", "core", "task" ], "active_master" : "true", "action_stage" : "after_scale_out", "fail_action" : "continue" } ], "rules" : [ { "name" : "default-expand-1", "adjustment_type" : "scale_out", "cool_down_minutes" : 5, "scaling_adjustment" : 1, "trigger" : { "metric_name" : "YARNMemoryAvailablePercentage", "metric_value" : "25", "comparison_operator" : "LT", "evaluation_periods" : 10 } }, { "name" : "default-shrink-1", "adjustment_type" : "scale_in", "cool_down_minutes" : 5, "scaling_adjustment" : 1, "trigger" : { "metric_name" : "YARNMemoryAvailablePercentage", "metric_value" : "70", "comparison_operator" : "GT", "evaluation_periods" : 10 } } ] } } ], "component_list" : [ { "component_name" : "Hadoop" }, { "component_name" : "Spark" }, { "component_name" : "HBase" }, { "component_name" : "Hive" } ], "add_jobs" : [ { "job_type" : 1, "job_name" : "tenji111", "jar_path" : "s3a: //bigdata/program/hadoop-mapreduce-examples-2.7.2.jar", "arguments" : "wordcount", "input" : "s3a: //bigdata/input/wd_1k/", "output" : "s3a: //bigdata/ouput/", "job_log" : "s3a: //bigdata/log/", "shutdown_cluster" : true, "file_action" : "", "submit_job_once_cluster_run" : true, "hql" : "", "hive_script_path" : "" } ], "bootstrap_scripts" : [ { "name" : "Modifyosconfig", "uri" : "s3a: //XXX/modify_os_config.sh", "parameters" : "param1param2", "nodes" : [ "master", "core", "task" ], "active_master" : "false", "before_component_start" : "true", "start_time" : "1667892101", "state" : "IN_PROGRESS", "fail_action" : "continue", "action_stages" : [ "BEFORE_COMPONENT_FIRST_START", "BEFORE_SCALE_IN" ] }, { "name" : "Installzepplin", "uri" : "s3a: //XXX/zeppelin_install.sh", "parameters" : "", "nodes" : [ "master" ], "active_master" : "true", "before_component_start" : "false", "start_time" : "1667892101", "state" : "IN_PROGRESS", "fail_action" : "continue", "action_stages" : [ "AFTER_SCALE_IN", "AFTER_SCALE_OUT" ] } ]} 使用node_groups参数组，创建一个关闭“集群高可用”功能、最小规格的集群，集群版本号为MRS 3.1.0。 POST https://{endpoint}/v1.1/{project_id}/run-job-flow{ "billing_type" : 12, "data_center" : "", "available_zone_id" : "d573142f24894ef3bd3664de068b44b0", "cluster_name" : "mrs_HEbK", "cluster_version" : "MRS 3.1.0", "safe_mode" : 0, "cluster_type" : 0, "component_list" : [ { "component_name" : "Hadoop" }, { "component_name" : "Spark" }, { "component_name" : "HBase" }, { "component_name" : "Hive" }, { "component_name" : "Presto" }, { "component_name" : "Tez" }, { "component_name" : "Hue" }, { "component_name" : "Loader" }, { "component_name" : "Flink" } ], "vpc" : "vpc-4b1c", "vpc_id" : "4a365717-67be-4f33-80c5-98e98a813af8", "subnet_id" : "67984709-e15e-4e86-9886-d76712d4e00a", "subnet_name" : "subnet-4b44", "security_groups_id" : "4820eace-66ad-4f2c-8d46-cf340e3029dd", "enterprise_project_id" : "0", "tags" : [ { "key" : "key1", "value" : "value1" }, { "key" : "key2", "value" : "value2" } ], "node_groups" : [ { "group_name" : "master_node_default_group", "node_num" : 1, "node_size" : "s3.xlarge.2.linux.bigdata", "root_volume_size" : 480, "root_volume_type" : "SATA", "data_volume_type" : "SATA", "data_volume_count" : 1, "data_volume_size" : 600 }, { "group_name" : "core_node_analysis_group", "node_num" : 1, "node_size" : "s3.xlarge.2.linux.bigdata", "root_volume_size" : 480, "root_volume_type" : "SATA", "data_volume_type" : "SATA", "data_volume_count" : 1, "data_volume_size" : 600 } ], "login_mode" : 1, "cluster_master_secret" : "", "cluster_admin_secret" : "", "log_collection" : 1, "add_jobs" : [ { "job_type" : 1, "job_name" : "tenji111", "jar_path" : "s3a://bigdata/program/hadoop-mapreduce-examples-2.7.2.jar", "arguments" : "wordcount", "input" : "s3a://bigdata/input/wd_1k/", "output" : "s3a://bigdata/ouput/", "job_log" : "s3a://bigdata/log/", "shutdown_cluster" : true, "file_action" : "", "submit_job_once_cluster_run" : true, "hql" : "", "hive_script_path" : "" } ], "bootstrap_scripts" : [ { "name" : "Modify os config", "uri" : "s3a://XXX/modify_os_config.sh", "parameters" : "param1 param2", "nodes" : [ "master", "core", "task" ], "active_master" : "false", "before_component_start" : "true", "start_time" : "1667892101", "state" : "IN_PROGRESS", "fail_action" : "continue", "action_stages" : [ "BEFORE_COMPONENT_FIRST_START", "BEFORE_SCALE_IN" ] }, { "name" : "Install zepplin", "uri" : "s3a://XXX/zeppelin_install.sh", "parameters" : "", "nodes" : [ "master" ], "active_master" : "true", "before_component_start" : "false", "start_time" : "1667892101", "state" : "IN_PROGRESS", "fail_action" : "continue", "action_stages" : [ "AFTER_SCALE_IN", "AFTER_SCALE_OUT" ] } ]} 不使用node_groups参数组，创建一个关闭“集群高可用”功能、最小规格的集群，集群版本号为MRS 3.1.0。 POST https://{endpoint}/v1.1/{project_id}/run-job-flow{ "billing_type" : 12, "data_center" : "", "master_node_num" : 1, "master_node_size" : "s3.2xlarge.2.linux.bigdata", "core_node_num" : 1, "core_node_size" : "s1.xlarge.linux.bigdata", "available_zone_id" : "d573142f24894ef3bd3664de068b44b0", "cluster_name" : "newcluster", "vpc" : "vpc1", "vpc_id" : "5b7db34d-3534-4a6e-ac94-023cd36aaf74", "subnet_id" : "815bece0-fd22-4b65-8a6e-15788c99ee43", "subnet_name" : "subnet", "security_groups_id" : "", "enterprise_project_id" : "0", "tags" : [ { "key" : "key1", "value" : "value1" }, { "key" : "key2", "value" : "value2" } ], "cluster_version" : "MRS 3.1.0", "cluster_type" : 0, "master_data_volume_type" : "SATA", "master_data_volume_size" : 600, "master_data_volume_count" : 1, "core_data_volume_type" : "SATA", "core_data_volume_size" : 600, "core_data_volume_count" : 1, "login_mode" : 1, "node_public_cert_name" : "SSHkey-bba1", "safe_mode" : 0, "cluster_admin_secret" : "******", "log_collection" : 1, "component_list" : [ { "component_name" : "Hadoop" }, { "component_name" : "Spark" }, { "component_name" : "HBase" }, { "component_name" : "Hive" }, { "component_name" : "Presto" }, { "component_name" : "Tez" }, { "component_name" : "Hue" }, { "component_name" : "Loader" }, { "component_name" : "Flink" } ], "add_jobs" : [ { "job_type" : 1, "job_name" : "tenji111", "jar_path" : "s3a://bigdata/program/hadoop-mapreduce-examples-XXX.jar", "arguments" : "wordcount", "input" : "s3a://bigdata/input/wd_1k/", "output" : "s3a://bigdata/ouput/", "job_log" : "s3a://bigdata/log/", "shutdown_cluster" : false, "file_action" : "", "submit_job_once_cluster_run" : true, "hql" : "", "hive_script_path" : "" } ], "bootstrap_scripts" : [ { "name" : "Install zepplin", "uri" : "s3a://XXX/zeppelin_install.sh", "parameters" : "", "nodes" : [ "master" ], "active_master" : "false", "before_component_start" : "false", "start_time" : "1667892101", "state" : "IN_PROGRESS", "fail_action" : "continue", "action_stages" : [ "AFTER_SCALE_IN", "AFTER_SCALE_OUT" ] } ]}

规格 表1 IO优化型（IO2型）裸金属服务器的规格 规格名称/ID CPU 内存（GB） 本地磁盘 扩展配置 physical.io2.xlarge 2 * 22 Core Intel Xeon Gold 6161 V5 (2.2 GHz) 384 DDR4 RAM (GB) 2 * 800GB SSD RAID 1 + 10 * 800GB SSD 2 x 2 * 10GE 表2 本地存储型（D2型）裸金属服务器的规格 规格名称/ID CPU 内存（GB） 本地磁盘 扩展配置 physical.d2.large 2 * 12 Core Intel Xeon Gold 5118 V5 (2.3 GHz) 192 DDR4 RAM (GB) 2 * 600GB SAS System Disk RAID 1 + 12 * 10TB SATA 2 x 2 * 10GE

操作步骤 接口相关信息 URI格式：PUT /v1.1/{project_id}/cluster_infos/{cluster_id} 详情请参见调整集群节点。 请求示例 PUT: https://{endpoint}/v1.1/{project_id}/cluster_infos/{cluster_id} {endpoint}信息具体请参考终端节点。 {project_id}信息请通过获取项目ID获取。 {cluster_id}信息即创建集群成功后返回结果中的“cluster_id” 或参考获取集群ID获取。 Body： { "service_id": "", "plan_id": "", "parameters": { "order_id": "", "scale_type": "scale_out", "node_id": "node_orderadd", "node_group": "core_node_default_group", "instances": "1", "skip_bootstrap_scripts":false, "scale_without_start":false }, "previous_values": { "plan_id": "" } } 参数详细信息请参考调整集群节点获取。 响应示例 {"result": "succeeded"}

请求示例 批量刪除 POST /v1.1/{project_id}/clusters/{cluster_id}/tags/action{ "action" : "delete", "tags" : [ { "tag" : null, "key" : "DEV1", "value" : "DEV1" }, { "tag" : null, "key" : "DEV2", "value" : "DEV2" } ]}

操作步骤 接口相关信息 URI格式：POST /v2/{project_id}/clusters 详情请参见创建集群。 请求示例 POST: https://{endpoint}/v2/{project_id}/clusters {endpoint}信息具体请参考终端节点。 {project_id}信息请通过获取项目ID获取。 节点的实例规格参数“node_size”建议从MRS控制台的集群创建页面获取对应区域对应版本所支持的规格。 Body： { "cluster_version": "MRS 3.2.0-LTS.1", "cluster_name": "mrs_Demo", "cluster_type": "ANALYSIS", "charge_info": { "charge_mode": "postPaid" }, "region": "", "availability_zone": "", "vpc_name": "vpc-37cd", "subnet_name": "subnet-ed99", "components": "Hadoop,Spark2x,HBase,Hive,Hue,Flink,Oozie,Ranger,Tez", "safe_mode": "KERBEROS", "manager_admin_password": "Mrs@1234", "login_mode": "PASSWORD", "node_root_password": "Mrs@1234", "log_collection": 1, "mrs_ecs_default_agency": "MRS_E CS _DEFAULT_AGENCY", "tags": [ { "key": "tag1", "value": "111" }, { "key": "tag2", "value": "222" } ], "node_groups": [ { "group_name": "master_node_default_group", "node_num": 2, "node_size": "rc3.4xlarge.4.linux.bigdata", "root_volume": { "type": "SAS", "size": 480 }, "data_volume": { "type": "SAS", "size": 600 }, "data_volume_count": 1 }, { "group_name": "core_node_analysis_group", "node_num": 3, "node_size": "rc3.4xlarge.4.linux.bigdata", "root_volume": { "type": "SAS", "size": 480 }, "data_volume": { "type": "SAS", "size": 600 }, "data_volume_count": 1 }, { "group_name": "task_node_analysis_group", "node_num": 3, "node_size": "rc3.4xlarge.4.linux.bigdata", "root_volume": { "type": "SAS", "size": 480 }, "data_volume": { "type": "SAS", "size": 600 }, "data_volume_count": 1, "auto_scaling_policy": { "auto_scaling_enable": true, "min_capacity": 0, "max_capacity": 1, "resources_plans": [], "exec_scripts": [], "rules": [ { "name": "default-expand-1", "description": "", "adjustment_type": "scale_out", "cool_down_minutes": 5, "scaling_adjustment": "1", "trigger": { "metric_id": 2003, "metric_name": "StormSlotAvailablePercentage", "metric_value": 100, "comparison_operator_id": 2003, "comparison_operator": "LTOE", "evaluation_periods": "1" } } ] } } ]} 参数详细信息请参考创建集群获取。 响应示例 {"cluster_id": "da1592c2-bb7e-468d-9ac9-83246e95447a"}

操作步骤 接口相关信息 URI格式：PUT /v1.1/{project_id}/cluster_infos/{cluster_id} 详情请参见调整集群节点。 请求示例 PUT: https://{endpoint}/v1.1/{project_id}/cluster_infos/{cluster_id} {endpoint}信息具体请参考终端节点。 {project_id}信息请通过获取项目ID获取。 {cluster_id}信息即创建集群成功后返回结果中的“cluster_id” 或参考获取集群ID获取。 Body： { "service_id": "", "plan_id": "", "parameters": { "order_id": "", "scale_type": "scale_in", "node_id": "node_orderadd", "node_group": "core_node_default_group", "instances": "1" }, "previous_values": { "plan_id": "" } } 参数详细信息请参考调整集群节点获取。 响应示例 {"result": "succeeded"}

操作步骤 接口相关信息 URI格式：DELETE /v1.1/{project_id}/clusters/{cluster_id} 详情请参见删除集群。 请求示例 DELETE: https://{endpoint}/v1.1/{project_id}/clusters/{cluster_id} {endpoint}具体请参考终端节点。 {project_id}信息请通过获取项目ID获取。 {cluster_id}信息即创建集群成功后返回结果中的“cluster_id” 或参考获取集群ID获取。 Body：无 响应示例 {"result": "succeeded"}

响应示例 状态码： 202 获取SQL结果成功 { "sql_results" : { "0" : [ { "result" : "succeed" } ], "1" : [ { "database" : "default", "isTemporary" : "false", "tableName" : "src_wordcount" } ], "2" : [ { "result" : "succeed" } ], "3" : [ { "result" : "succeed" } ], "4" : [ { "name" : "a", "id" : 1 }, { "name" : "b", "id" : 2 } ] }} 状态码： 500 收集SQL作业结果失败 { "error_msg" : "收集SQL作业结果失败", "error_code" : "0172"}

URI GET /v2/{project_id}/clusters/{cluster_id}/job-executions/{job_execution_id}/sql-result 表1 路径参数 参数 是否必选 参数类型 描述 job_execution_id 是 String 作业ID。获取方法，请参见获取作业ID。 project_id 是 String 项目编号。获取方法，请参见获取项目ID。 cluster_id 是 String 集群ID。获取方法，请参见获取集群ID。

响应示例 状态码： 202 查询单个作业信息成功 { "job_detail" : { "job_id" : "431b135e-c090-489f-b1db-0abe3822b855", "user" : "xxxx", "job_name" : "pyspark1", "job_result" : "SUCCEEDED", "job_state" : "FINISHED", "job_progress" : 100, "job_type" : "SparkSubmit", "started_time" : 1564626578817, "submitted_time" : 1564626561541, "finished_time" : 1564626664930, "elapsed_time" : 86113, "queue" : "default", "arguments" : "[--class, org.apache.spark.examples.SparkPi, --driver-memory, 512MB, --num-executors, 1, --executor-cores, 1, --master, yarn-cluster, s3a://obs-test/jobs/spark/spark-examples_2.11-2.1.0.jar, 10000]", "launcher_id" : "application_1564622673393_0006", "app_id" : "application_1564622673393_0007", "properties" : "{}" }} 状态码： 500 查询单个作业信息失败 { "error_msg" : "查询作业失败", "error_code" : "0162"}

URI POST /v2/{project_id}/clusters/{cluster_id}/job-executions/{job_execution_id}/kill 表1 路径参数 参数 是否必选 参数类型 描述 job_execution_id 是 String 作业ID。获取方法，请参见获取作业ID。 project_id 是 String 项目编号。获取方法，请参见获取项目ID。 cluster_id 是 String 集群ID。获取方法，请参见获取集群ID。

URI GET /v2/{project_id}/clusters/{cluster_id}/job-executions/{job_execution_id} 表1 路径参数 参数 是否必选 参数类型 描述 job_execution_id 是 String 作业ID。获取方法，请参见获取作业ID。 project_id 是 String 项目编号。获取方法，请参见获取项目ID。 cluster_id 是 String 集群ID。获取方法，请参见获取集群ID。

URI GET /v2/{project_id}/clusters/{cluster_id}/sql-execution/{sql_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目编号。获取方法，请参见获取项目ID。 cluster_id 是 String 集群ID。获取方法，请参见获取集群ID。 sql_id 是 String SQL的执行ID，即提交SQL语句返回结果中的sql_id。

响应示例 状态码： 200 查询SQL结果成功 { "id" : "20190909_011820_00151_xxxxx", "statement" : "show tables", "status" : "FINISHED", "result_location" : "obs://my_bucket/uuid_date/xxxx.csv", "content" : [ [ "t1", null ], [ null, "t2" ], [ null, "t3" ] ]} 状态码： 400 查询SQL结果失败 { "error_code" : "MRS.0011", "message" : "提交SQL到Executor上失败，集群ID为xxxx"}

响应示例 状态码： 202 查询作业列表信息成功 { "total_record" : 2, "job_list" : [ { "job_id" : "981374c1-85da-44ee-be32-edfb4fba776c", "user" : "xxxx", "job_name" : "SparkSubmitTset", "job_result" : "UNDEFINED", "job_state" : "ACCEPTED", "job_progress" : 0, "job_type" : "SparkSubmit", "started_time" : 0, "submitted_time" : 1564714763119, "finished_time" : 0, "elapsed_time" : 0, "queue" : "default", "arguments" : "[--class, --driver-memory, --executor-cores, --master, yarn-cluster, s3a://obs-test/hadoop-mapreduce-examples-3.1.1.jar, dddd]", "launcher_id" : "application_1564622673393_0613", "properties" : { } }, { "job_id" : "c54c8aa0-c277-4f83-8acc-521d85cfa32b", "user" : "xxxx", "job_name" : "SparkSubmitTset2", "job_result" : "UNDEFINED", "job_state" : "ACCEPTED", "job_progress" : 0, "job_type" : "SparkSubmit", "started_time" : 0, "submitted_time" : 1564714020099, "finished_time" : 0, "elapsed_time" : 0, "queue" : "default", "arguments" : "[--conf, yujjsjhe, --driver-memory, yueujdjjd, --master,\nyarn-cluster,\ns3a://obs-test/hadoop-mapreduce-examples-3.1.1.jar]", "launcher_id" : "application_1564622673393_0611", "properties" : { } } ]} 状态码： 500 查询作业列表信息失败 { "error_msg" : "查询作业列表失败", "error_code" : "0166"}

URI GET /v2/{project_id}/clusters/{cluster_id}/job-executions 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目编号。获取方法，请参见获取项目ID。 cluster_id 是 String 集群ID。获取方法，请参见获取集群ID。 表2 Query参数 参数 是否必选 参数类型 描述 job_name 否 String 作业名称，只能由字母、数字、中划线和下划线组成，并且长度为1～128个字符。 job_id 否 String 作业ID，只能由字母、数字、中划线(-)组成，并且长度为1~64字符。 user 否 String 用户名称、只能由字母、数字、特殊字符(-_.)组成，且不能以数字开头，并且长度为1～32字符。 job_type 否 String 作业类型。 MapReduce SparkPython SparkSubmit：SparkPython类型的作业在查询时作业类型请选择SparkSubmit。 HiveScript HiveSql DistCp，导入、导出数据。 SparkScript SparkSql Flink job_state 否 String 作业运行状态。 FAILED：失败 KILLED：已终止 NEW：已创建 NEW_SAVING：已创建保存中 SUBMITTED：已提交 ACCEPTED：已接受 RUNNING：运行中 FINISHED：已完成 job_result 否 String 作业运行结果。 FAILED：执行失败的作业。 KILLED：执行中被手动终止的作业。 UNDEFINED：正在执行的作业。 SUCCEEDED：执行成功的作业。 queue 否 String 作业的资源对列类型名称，作业的资源对列类型名称，只能由数字、字母和特殊字符(-_)组成, 并且长度为1～64字符。 limit 否 String 返回结果中每页显示条数。缺省值：10 offset 否 String 表示作业列表从该偏移量开始查询。缺省值：1 sort_by 否 String 返回结果的排序方式，默认值为desc。 asc：按升序排列 desc：按降序排列 submitted_time_begin 否 Long 查询该时间之后提交的作业，UTC的毫秒时间戳。例如：1562032041362。 submitted_time_end 否 Long 查询该时间之前提交的作业UTC的毫秒时间戳。例如：1562032041362。

响应示例 状态码： 200 查询集群详情成功。 { "cluster" : { "clusterId" : "bdb064ff-2855-4624-90d5-e9a6376abd6e", "clusterName" : "c17022001", "masterNodeNum" : "2", "coreNodeNum" : "3", "clusterState" : "scaling-in", "stageDesc" : "Installing MRS Manager", "createAt" : "1487570757", "updateAt" : "1487668974", "billingType" : "Metered", "dataCenter" : "cn-north-1", "vpc" : "vpc-autotest", "vpcId" : "e2978efd-ca12-4058-9332-1ca0bfbab592", "duration" : "0", "fee" : "0", "hadoopVersion" : "", "masterNodeSize" : "s3.2xlarge.2.linux.bigdata", "coreNodeSize" : "s1.xlarge.linux.bigdata", "componentList" : [ { "componentId" : "MRS 3.1.0_001", "componentName" : "Hadoop", "componentVersion" : "3.1.1", "componentDesc" : "A framework that allows for the distributed processing of large data sets across clusters." }, { "componentId" : "MRS 3.1.0_002", "componentName" : "Spark", "componentVersion" : "2.3.2", "componentDesc" : "A fast and general engine for large-scale data processing." }, { "componentId" : "MRS 3.1.0_004", "componentName" : "Hive", "componentVersion" : "3.1.0", "componentDesc" : "A data warehouse infrastructure that provides data summarization and ad hoc querying." }, { "componentId" : "MRS 3.1.0_003", "componentName" : "HBase", "componentVersion" : "2.1.1", "componentDesc" : "A scalable, distributed database that supports structured data storage for large tables." } ], "externalIp" : "100.XXX.XXX.XXX", "externalAlternateIp" : "100.XXX.XXX.XXX", "internalIp" : "192.XXX.XXX.XXX", "eipId" : "b16dd5eb-5e5b-486a-906a-2e8f6e814a7a", "eipAddress" : "100.XXX.XXX.XXX", "eipv6Address" : "2403:XXXX:XXXX::XXXX:XXXX", "deploymentId" : "4ac46ca7-a488-4b91-82c2-e4d7aa9c40c2", "remark" : "", "orderId" : "null", "azId" : "null", "masterNodeProductId" : "b35cf2d2348a445ca74b32289a160882", "masterNodeSpecId" : "8ab05e503b4c42abb304e2489560063b", "coreNodeProductId" : "dc970349d128460e960a0c2b826c427c", "coreNodeSpecId" : "cdc6035a249a40249312f5ef72a23cd7", "azName" : "az1.dc1", "instanceId" : "4ac46ca7-a488-4b91-82c2-e4d7aa9c40c2", "vnc" : null, "tenantId" : "3f99e3319a8943ceb15c584f3325d064", "volumeSize" : "100", "volumeType" : "SATA", "subnetId" : "6b96eec3-4f8d-4c83-93e2-6ec625001d7c", "subnetName" : "subnet-ftest", "securityGroupsId" : "930e34e2-195d-401f-af07-0b64ea6603f8", "slaveSecurityGroupsId" : "2ef3343e-3477-4a0d-80fe-4d874e4f81b8", "bootstrapScripts" : [ { "name" : "test1-success", "uri" : "s3a://bootscript/script/simple/basic_success.sh", "parameters" : "", "nodes" : [ "master", "core" ], "active_master" : true, "fail_action" : "errorout", "before_component_start" : true, "state" : "SUC CES S", "start_time" : 1527681083, "action_stages" : [ "AFTER_SCALE_IN", "AFTER_SCALE_OUT" ] } ], "isMrsManagerFinish" : false, "safeMode" : "1", "clusterVersion" : "MRS 2.1.0", "nodePublicCertName" : "myp", "masterNodeIp" : "192.XXX.XXX.XXX", "privateIpFirst" : "192.XXX.XXX.XXX", "errorInfo" : null, "tags" : "k1=v1,k2=v2,k3=v3", "clusterType" : "", "logCollection" : "1", "nodeGroups" : [ { "GroupName" : "master_node_default_group", "NodeNum" : "1", "NodeSize" : "s3.xlarge.2.linux.bigdata", "NodeSpecId" : "cdc6035a249a40249312f5ef72a23cd7", "VmProductId" : "", "VmSpecCode" : null, "NodeProductId" : "dc970349d128460e960a0c2b826c427c", "RootVolumeSize" : "40", "RootVolumeProductId" : "16c1dcf0897249758b1ec276d06e0572", "RootVolumeType" : "SATA", "RootVolumeResourceSpecCode" : "", "RootVolumeResourceType" : "", "DataVolumeType" : "SATA", "DataVolumeCount" : "1", "DataVolumeSize" : "100", "DataVolumeProductId" : "16c1dcf0897249758b1ec276d06e0572", "DataVolumeResourceSpecCode" : "", "DataVolumeResourceType" : "" }, { "GroupName" : "core_node_analysis_group", "NodeNum" : "1", "NodeSize" : "s3.xlarge.2.linux.bigdata", "NodeSpecId" : "cdc6035a249a40249312f5ef72a23cd7", "VmProductId" : "", "VmSpecCode" : null, "NodeProductId" : "dc970349d128460e960a0c2b826c427c", "RootVolumeSize" : "40", "RootVolumeProductId" : "16c1dcf0897249758b1ec276d06e0572", "RootVolumeType" : "SATA", "RootVolumeResourceSpecCode" : "", "RootVolumeResourceType" : "", "DataVolumeType" : "SATA", "DataVolumeCount" : "1", "DataVolumeSize" : "100", "DataVolumeProductId" : "16c1dcf0897249758b1ec276d06e0572", "DataVolumeResourceSpecCode" : "", "DataVolumeResourceType" : "" }, { "GroupName" : "task_node_analysis_group", "NodeNum" : "1", "NodeSize" : "s3.xlarge.2.linux.bigdata", "NodeSpecId" : "cdc6035a249a40249312f5ef72a23cd7", "VmProductId" : "", "VmSpecCode" : null, "NodeProductId" : "dc970349d128460e960a0c2b826c427c", "RootVolumeSize" : "40", "RootVolumeProductId" : "16c1dcf0897249758b1ec276d06e0572", "RootVolumeType" : "SATA", "RootVolumeResourceSpecCode" : "", "RootVolumeResourceType" : "", "DataVolumeType" : "SATA", "DataVolumeCount" : "1", "DataVolumeSize" : "100", "DataVolumeProductId" : "16c1dcf0897249758b1ec276d06e0572", "DataVolumeResourceSpecCode" : "", "DataVolumeResourceType" : "" } ], "taskNodeGroups" : [ { "GroupName" : "task_node_default_group", "NodeNum" : "1", "NodeSize" : "s3.xlarge.2.linux.bigdata", "NodeSpecId" : "cdc6035a249a40249312f5ef72a23cd7", "VmProductId" : "", "VmSpecCode" : null, "NodeProductId" : "dc970349d128460e960a0c2b826c427c", "RootVolumeSize" : "40", "RootVolumeProductId" : "16c1dcf0897249758b1ec276d06e0572", "RootVolumeType" : "SATA", "RootVolumeResourceSpecCode" : "", "RootVolumeResourceType" : "", "DataVolumeType" : "SATA", "DataVolumeCount" : "1", "DataVolumeSize" : "100", "DataVolumeProductId" : "16c1dcf0897249758b1ec276d06e0572", "DataVolumeResourceSpecCode" : "", "DataVolumeResourceType" : "" } ], "masterDataVolumeType" : "SATA", "masterDataVolumeSize" : "200", "masterDataVolumeCount" : "1", "coreDataVolumeType" : "SATA", "coreDataVolumeSize" : "100", "coreDataVolumeCount" : "1", "periodType" : "0" }}

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 cluster Cluster object 集群参数。 表3 Cluster 参数 参数类型 描述 clusterId String 集群ID。 clusterName String 集群名称。 totalNodeNum String 集群部署的节点总数。 clusterState String 集群状态，包括： starting：启动中的集群。 running：运行中的集群。 terminated：已删除的集群。 failed：失败的集群。 abnormal：异常的集群。 terminating：删除中的集群。 frozen：已冻结的集群。 scaling-out：扩容中的集群。 scaling-in：缩容中的集群。 stageDesc String 集群进度描述。 安装集群进度包括： Verifying cluster parameters：校验集群参数中 Applying for cluster resources：申请集群资源中 Creating VM：创建虚拟机中 Initializing VM：初始化虚拟机中 Installing MRS Manager：安装MRS Manager中 Deploying cluster：部署集群中 Cluster installation failed：集群安装失败 扩容集群进度包括： Preparing for cluster expansion：准备扩容中 Creating VM：创建虚拟机中 Initializing VM：初始化虚拟机中 Adding node to the cluster：节点加入集群中 Cluster expansion failed：集群扩容失败 缩容集群进度包括： Preparing for cluster shrink：正在准备缩容 Decommissioning instance：实例退服中 Deleting VM：删除虚拟机中 Deleting node from the cluster：从集群删除节点中 Cluster shrink failed：集群缩容失败 集群安装、扩容、缩容失败，stageDesc会显示失败的原因。 createAt String 集群创建时间，十位时间戳。 updateAt String 集群更新时间，十位时间戳。 chargingStartTime String 开始计费时间。 billingType String 集群计费模式。 dataCenter String 集群工作区域。 vpc String VPC名称。 vpcId String VPC ID。 duration String 集群购买时长。 fee String 创建集群所需费用，系统自动计算。 hadoopVersion String Hadoop组件版本信息。 componentList Array of ComponentAmb objects 组件列表信息。 externalIp String 公网IP地址。 externalAlternateIp String 公网备用IP地址。 internalIp String 内网IP地址。 deploymentId String 集群部署ID。 remark String 集群备注信息。 orderId String 创建集群的订单号。 azId String 可用区域ID。 azName String 可用区域名称。 azCode String 可用区域英文名称 availabilityZoneId String 可用区域 instanceId String 实例ID。 vnc String 远程登录弹性云服务器的URI地址。 tenantId String 项目编号。 volumeSize Integer 磁盘存储空间。 volumeType String 磁盘类型。 subnetId String 子网ID。 subnetName String 子网名称。 securityGroupsId String 安全组ID。 slaveSecurityGroupsId String 非Master节点的安全组id，当前一个MRS集群只会使用一个安全组，所以该字段已经废弃，从兼容性考虑，该字段会返回和securityGroupsId同样的值。 bootstrapScripts Array of BootstrapScript objects 配置引导操作脚本信息。 safeMode Integer MRS集群运行模式。 0：普通集群 1：安全集群 clusterVersion String 集群版本。 nodePublicCertName String 密钥文件名称。 masterNodeIp String Master节点IP。 privateIpFirst String 首选私有IP。 errorInfo String 错误信息。 tags String 标签信息 masterNodeNum String 集群部署的Master节点数量。 coreNodeNum String 集群部署的Core节点数量。 masterNodeSize String Master节点的实例规格。 coreNodeSize String Core节点的实例规格。 masterNodeProductId String Master节点产品ID。 masterNodeSpecId String Master节点规格ID。 coreNodeProductId String Core节点产品ID。 coreNodeSpecId String Core节点规格ID。 masterDataVolumeType String Master节点数据磁盘存储类别，目前支持SATA、SAS和SSD。 masterDataVolumeSize Integer Master节点数据磁盘存储空间。为增大数据存储容量，创建集群时可同时添加磁盘。 取值范围：100GB～32000GB，传值只需填数字，不需要带单位GB。 masterDataVolumeCount Integer Master节点数据磁盘个数。 取值只能是1 coreDataVolumeType String Core节点数据磁盘存储类别，目前支持SATA、SAS和SSD。 coreDataVolumeSize Integer Core节点数据磁盘存储空间。为增大数据存储容量，创建集群时可同时添加磁盘。 取值范围：100GB～32000GB，传值只需填数字，不需要带单位GB。 coreDataVolumeCount Integer Core节点数据磁盘个数。 取值范围：1～10 enterpriseProjectId String 企业项目ID。 isMrsManagerFinish Boolean 表示集群创建过程中，MRS Manager是否安装完成。 true：安装完成 false：安装未完成 clusterType Integer 集群类型。 logCollection Integer 集群安装失败时，是否搜集日志。 0：不收集 1：收集 periodType Integer 区分包周期，集群是包年还是包月。 0：包月 1：包年 scale String 集群节点的变更状态（扩容/缩容/变更规格）。当该参数取值为空时，表示集群节点没有进行变更操作。 取值范围： scaling-out：扩容中 scaling-in：缩容中 scaling-error：处于running状态，且上一次扩容/缩容/升级规格失败的集群 scaling-up：Master节点规格升级中 scaling_up_first：备Master节点规格升级中 scaled_up_first：备Master节点规格升级成功 scaled-up-success：Master节点规格升级成功 nodeGroups Array of NodeGroupV10 objects Master节点、Core节点和Task节点列表信息。 taskNodeGroups Array of NodeGroupV10 objects Task节点列表信息。 eipId String 集群弹性公网ip的唯一标识。 eipAddress String 集群弹性公网ip的IPV4地址。 eipv6Address String 集群弹性公网ip的IPV6地址，IPv4时无此字段。 表4 ComponentAmb 参数 参数类型 描述 componentId String 组件ID。 componentName String 组件名称。 componentVersion String 组件版本。 componentDesc String 组件描述信息。 表5 BootstrapScript 参数 参数类型 描述 name String 引导操作脚本的名称，同一个集群的引导操作脚本名称不允许相同。 只能由数字、英文字符、空格、中划线和下划线组成，且不能以空格开头。 可输入的字符串长度为1～64个字符。 uri String 引导操作脚本的路径。设置为OBS桶的路径或虚拟机本地的路径。- OBS桶的路径：直接手动输入脚本路径。例如输入MRS提供的公共样例脚本路径。示例：s3a://bootstrap/presto/presto-install.sh，其中安装dualroles时，presto-install.sh脚本参数为dualroles, 安装worker时，presto-install.sh脚本参数为worker。根据Presto使用习惯，建议您在Active Master节点上安装dualroles，在Core节点上安装worker。- 虚拟机本地的路径：用户需要输入正确的脚本路径。脚本所在的路径必须以‘/’开头，以.sh结尾。 parameters String 引导操作脚本参数。 nodes Array of strings 引导操作脚本所执行的节点类型，包含master、core和task三种类型。说明：节点类型必须为小写字母。 active_master Boolean 引导操作脚本是否只运行在主Master节点上。 缺省值为false，表示引导操作脚本可运行在所有Master节点上。 fail_action String 引导操作脚本执行失败后，是否继续执行后续脚本和创建集群。 缺省值为errorout,表示终止操作。 说明： 建议您在调试阶段设置为“继续”，无论此引导操作是否执行成功，则集群都能继续安装和启动。 枚举值： continue：继续执行后续脚本。 errorout：终止操作。 before_component_start Boolean 引导操作脚本执行的时间。目前支持“组件启动前”和“组件启动后”两种类型。 缺省值为false，表示引导操作脚本在组件启动后执行。 start_time Long 单个引导操作脚本的执行时间。 state String 单个引导操作脚本的运行状态。 PENDING IN_PROGRESS SUCCESS FAILURE action_stages Array of strings 选择引导操作脚本执行的时间。 BEFORE_COMPONENT_FIRST_START: 组件首次启动后 AFTER_COMPONENT_FIRST_START: 组件首次启动前 BEFORE_SCALE_IN: 缩容前 AFTER_SCALE_IN: 缩容后 BEFORE_SCALE_OUT: 扩容前 AFTER_SCALE_OUT: 扩容后 表6 NodeGroupV10 参数 参数类型 描述 GroupName String 节点组名。 NodeNum Integer 节点数量，取值范围0～500，Master节点和Core节点数量至少为1，Core与Task节点总数最大为500个。 NodeSize String 节点的实例规格。 NodeSpecId String 节点实例规格ID。 VmProductId String 节点虚拟机产品ID。 VmSpecCode String 节点虚拟机产品规格。 NodeProductId String 节点实例产品ID。 RootVolumeSize Integer 节点系统盘大小，不可配置，默认为40GB。 RootVolumeProductId String 节点系统盘的产品ID。 RootVolumeType String 节点系统盘的类型。 RootVolumeResourceSpecCode String 节点系统盘产品规格。 RootVolumeResourceType String 节点系统盘产品类型。 DataVolumeType String 节点数据磁盘存储类别，目前支持SATA、SAS和SSD。 SATA：普通IO SAS：高IO SSD：超高IO DataVolumeCount Integer 节点数据磁盘存储数目。 DataVolumeSize Integer 节点数据磁盘存储大小。 DataVolumeProductId String 节点数据磁盘的产品ID。 DataVolumeResourceSpecCode String 节点数据磁盘的产品规格。 DataVolumeResourceType String 节点数据磁盘的产品类型。

响应示例 状态码： 200 查询作业exe对象列表成功。 { "totalRecord" : "14", "job_executions" : [ { "id" : "669476bd-89d2-45aa-8f1a-872d16de377e", "create_at" : "1484641003707", "update_at" : "1484641003707", "tenant_id" : "3f99e3319a8943ceb15c584f3325d064", "job_id" : "", "job_name" : "myfirstjob", "start_time" : "1484641003707", "end_time" : null, "cluster_id" : "2b460e01-3351-4170-b0a7-57b9dd5ffef3", "group_id" : "669476bd-89d2-45aa-8f1a-872d16de377e", "jar_path" : "s3a://jp-test1/program/hadoop-mapreduce-examples-2.4.1.jar", "input" : "s3a://jp-test1/input/", "output" : "s3a://jp-test1/output/", "job_log" : "s3a://jp-test1/joblogs/", "job_type" : "1", "file_action" : "", "arguments" : "wordcount", "hql" : "", "job_state" : "2", "job_final_status" : "1", "hive_script_path" : null, "create_by" : "3f99e3319a8943ceb15c584f3325d064", "finished_step" : "0", "job_main_id" : "", "job_step_id" : "", "postpone_at" : "1484641003174", "step_name" : "", "step_num" : "0", "task_num" : "0", "update_by" : "3f99e3319a8943ceb15c584f3325d064", "spend_time" : null, "step_seq" : "222", "progress" : "first progress" } ]}

URI GET /v1.1/{project_id}/job-exes 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目编号。获取方法，请参见获取项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 page_size 否 String 分页查询每页返回的最大作业数量。 取值范围：[1～100] current_page 否 String 当前查询页码。 job_name 否 String 作业名称。 cluster_id 是 String 集群编号。 state 否 String 作业状态编码： -1：Terminated表示已终止的作业状态 2：Running表示运行中的作业状态 3：Completed表示已完成的作业状态 4：Abnormal表示异常的作业状态 id 否 String 作业执行对象的编号。

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 totalRecord Integer 作业列表总数。 job_executions Array of JobExeResult objects 作业列表。 表4 JobExeResult 参数 参数类型 描述 id String 作业ID。 create_at Long 作业创建时间，十三位时间戳。 update_at Long 作业更新时间，十三位时间戳。 tenant_id String 项目编号。获取方法，请参见获取项目ID。 job_id String 作业ID。 job_name String 作业名称。 start_time Long 作业执行开始时间，十三位时间戳。 end_time Long 作业执行结束时间，十三位时间戳。 cluster_id String 作业所属集群ID。 group_id String 作业执行组ID jar_path String 执行程序jar包或sql文件地址。 input String 数据输入地址。 output String 数据输出地址。 job_log String 作业日志存储地址 job_type Integer 作业类型码。 1：MapReduce 2：Spark 3：Hive Script 4：HiveSQL（当前不支持） 5：DistCp 6：Spark Script 7：Spark SQL（该接口当前不支持） file_action String 导入导出数据。 arguments String 程序执行的关键参数，该参数由用户程序内的函数指定，MRS只负责参数的传入。该参数可为空。 hql String HQL脚本语句。 job_state Integer 作业状态编码： -1：Terminated表示已终止的作业状态 2：Running表示运行中的作业状态 3：Completed表示已完成的作业状态 4：Abnormal表示异常的作业状态 job_final_status Integer 作业最终状态码。 0：未完成 1：执行错误，终止执行 2：执行完成并且成功 3：已取消 hive_script_path String Hive脚本地址。 create_by String 创建作业的用户ID。 finished_step Integer 当前已完成的步骤数。 job_main_id String 作业主ID。 job_step_id String 作业步骤ID。 postpone_at Long 延迟时间，十三位时间戳。 step_name String 作业步骤名。 step_num Integer 步骤数量。 task_num Integer 任务数量。 update_by String 更新作业的用户ID。 spend_time Float 作业执行持续时间，单位：秒。 step_seq Integer 步骤序列号。 progress String 作业执行进度。

响应示例 状态码： 200 查询集群列表信息成功。 { "clusterTotal" : "1", "clusters" : [ { "clusterId" : "bc134369-294c-42b7-a707-b2036ba38524", "clusterName" : "mrs_D0zW", "masterNodeNum" : "2", "coreNodeNum" : "3", "clusterState" : "terminated", "createAt" : "1498272043", "updateAt" : "1498636753", "chargingStartTime" : "1498273733", "logCollection" : "1", "billingType" : "Metered", "dataCenter" : "cn-north-1", "vpc" : null, "duration" : "0", "fee" : null, "hadoopVersion" : null, "masterNodeSize" : null, "coreNodeSize" : null, "componentList" : [ { "componentId" : "MRS 3.1.0_001", "componentName" : "Hadoop", "componentVersion" : "3.1.1", "componentDesc" : "A framework that allows for the distributed processing of large data sets across clusters." }, { "componentId" : "MRS 3.1.0_003", "componentName" : "HBase", "componentVersion" : "2.1.1", "componentDesc" : "A scalable, distributed database that supports structured data storage for large tables." }, { "componentId" : "MRS 3.1.0_002", "componentName" : "Spark", "componentVersion" : "2.3.2", "componentDesc" : "A fast and general engine for large-scale data processing." }, { "componentId" : "MRS 3.1.0_004", "componentName" : "Hive", "componentVersion" : "3.1.0", "componentDesc" : "A data warehouse infrastructure that provides data summarization and ad hoc querying." } ], "externalIp" : null, "externalAlternateIp" : null, "internalIp" : null, "deploymentId" : null, "remark" : "", "orderId" : null, "azId" : null, "azCode" : null, "masterNodeProductId" : null, "masterNodeSpecId" : null, "coreNodeProductId" : null, "coreNodeSpecId" : null, "azName" : "az1.dc1", "instanceId" : null, "vnc" : "v2/5a3314075bfa49b9ae360f4ecd333695/servers/e2cda891-232e-4703-995e-3b1406add01d/action", "tenantId" : null, "volumeSize" : "0", "volumeType" : null, "subnetId" : null, "subnetName" : null, "securityGroupsId" : null, "slaveSecurityGroupsId" : null, "bootstrapScripts" : [ { "name" : "test1-success", "uri" : "s3a://bootscript/script/simple/basic_success.sh", "parameters" : "", "nodes" : [ "master", "core" ], "active_master" : true, "fail_action" : "errorout", "before_component_start" : true, "state" : "SUCCESS", "start_time" : 1527681083, "action_stages" : [ "AFTER_SCALE_IN", "AFTER_SCALE_OUT" ] } ], "isMrsManagerFinish" : false, "stageDesc" : "Installing MRS Manager", "safeMode" : "0", "clusterVersion" : null, "nodePublicCertName" : null, "masterNodeIp" : "unknown", "privateIpFirst" : null, "eipId" : "b16dd5eb-5e5b-486a-906a-2e8f6e814a7a", "eipAddress" : "100.XXX.XXX.XXX", "eipv6Address" : "2403:XXXX:XXXX::XXXX:XXXX", "errorInfo" : "", "clusterType" : "0", "nodeGroups" : [ { "GroupName" : "master_node_default_group", "NodeNum" : "1", "NodeSize" : "s3.xlarge.2.linux.bigdata", "NodeSpecId" : "cdc6035a249a40249312f5ef72a23cd7", "VmProductId" : "", "VmSpecCode" : null, "NodeProductId" : "dc970349d128460e960a0c2b826c427c", "RootVolumeSize" : "40", "RootVolumeProductId" : "16c1dcf0897249758b1ec276d06e0572", "RootVolumeType" : "SATA", "RootVolumeResourceSpecCode" : "", "RootVolumeResourceType" : "", "DataVolumeType" : "SATA", "DataVolumeCount" : "1", "DataVolumeSize" : "100", "DataVolumeProductId" : "16c1dcf0897249758b1ec276d06e0572", "DataVolumeResourceSpecCode" : "", "DataVolumeResourceType" : "" }, { "GroupName" : "core_node_analysis_group", "NodeNum" : "1", "NodeSize" : "s3.xlarge.2.linux.bigdata", "NodeSpecId" : "cdc6035a249a40249312f5ef72a23cd7", "VmProductId" : "", "VmSpecCode" : null, "NodeProductId" : "dc970349d128460e960a0c2b826c427c", "RootVolumeSize" : "40", "RootVolumeProductId" : "16c1dcf0897249758b1ec276d06e0572", "RootVolumeType" : "SATA", "RootVolumeResourceSpecCode" : "", "RootVolumeResourceType" : "", "DataVolumeType" : "SATA", "DataVolumeCount" : "1", "DataVolumeSize" : "100", "DataVolumeProductId" : "16c1dcf0897249758b1ec276d06e0572", "DataVolumeResourceSpecCode" : "", "DataVolumeResourceType" : "" }, { "GroupName" : "task_node_analysis_group", "NodeNum" : "1", "NodeSize" : "s3.xlarge.2.linux.bigdata", "NodeSpecId" : "cdc6035a249a40249312f5ef72a23cd7", "VmProductId" : "", "VmSpecCode" : null, "NodeProductId" : "dc970349d128460e960a0c2b826c427c", "RootVolumeSize" : "40", "RootVolumeProductId" : "16c1dcf0897249758b1ec276d06e0572", "RootVolumeType" : "SATA", "RootVolumeResourceSpecCode" : "", "RootVolumeResourceType" : "", "DataVolumeType" : "SATA", "DataVolumeCount" : "1", "DataVolumeSize" : "100", "DataVolumeProductId" : "16c1dcf0897249758b1ec276d06e0572", "DataVolumeResourceSpecCode" : "", "DataVolumeResourceType" : "" } ], "taskNodeGroups" : [ { "GroupName" : "task_node_default_group", "NodeNum" : "1", "NodeSize" : "s3.xlarge.2.linux.bigdata", "NodeSpecId" : "cdc6035a249a40249312f5ef72a23cd7", "VmProductId" : "", "VmSpecCode" : null, "NodeProductId" : "dc970349d128460e960a0c2b826c427c", "RootVolumeSize" : "40", "RootVolumeProductId" : "16c1dcf0897249758b1ec276d06e0572", "RootVolumeType" : "SATA", "RootVolumeResourceSpecCode" : "", "RootVolumeResourceType" : "", "DataVolumeType" : "SATA", "DataVolumeCount" : "1", "DataVolumeSize" : "100", "DataVolumeProductId" : "16c1dcf0897249758b1ec276d06e0572", "DataVolumeResourceSpecCode" : "", "DataVolumeResourceType" : "" } ], "masterDataVolumeType" : "SATA", "masterDataVolumeSize" : "200", "masterDataVolumeCount" : "1", "coreDataVolumeType" : "SATA", "coreDataVolumeSize" : "100", "coreDataVolumeCount" : "1", "periodType" : "0" } ]}

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 clusterTotal Integer 集群列表总数。 clusters Array of Cluster objects 集群参数。 表4 Cluster 参数 参数类型 描述 clusterId String 集群ID。 clusterName String 集群名称。 totalNodeNum String 集群部署的节点总数。 clusterState String 集群状态，包括： starting：启动中的集群。 running：运行中的集群。 terminated：已删除的集群。 failed：失败的集群。 abnormal：异常的集群。 terminating：删除中的集群。 frozen：已冻结的集群。 scaling-out：扩容中的集群。 scaling-in：缩容中的集群。 stageDesc String 集群进度描述。 安装集群进度包括： Verifying cluster parameters：校验集群参数中 Applying for cluster resources：申请集群资源中 Creating VM：创建虚拟机中 Initializing VM：初始化虚拟机中 Installing MRS Manager：安装MRS Manager中 Deploying cluster：部署集群中 Cluster installation failed：集群安装失败 扩容集群进度包括： Preparing for cluster expansion：准备扩容中 Creating VM：创建虚拟机中 Initializing VM：初始化虚拟机中 Adding node to the cluster：节点加入集群中 Cluster expansion failed：集群扩容失败 缩容集群进度包括： Preparing for cluster shrink：正在准备缩容 Decommissioning instance：实例退服中 Deleting VM：删除虚拟机中 Deleting node from the cluster：从集群删除节点中 Cluster shrink failed：集群缩容失败 集群安装、扩容、缩容失败，stageDesc会显示失败的原因。 createAt String 集群创建时间，十位时间戳。 updateAt String 集群更新时间，十位时间戳。 chargingStartTime String 开始计费时间。 billingType String 集群计费模式。 dataCenter String 集群工作区域。 vpc String VPC名称。 vpcId String VPC ID。 duration String 集群购买时长。 fee String 创建集群所需费用，系统自动计算。 hadoopVersion String Hadoop组件版本信息。 componentList Array of ComponentAmb objects 组件列表信息。 externalIp String 公网IP地址。 externalAlternateIp String 公网备用IP地址。 internalIp String 内网IP地址。 deploymentId String 集群部署ID。 remark String 集群备注信息。 orderId String 创建集群的订单号。 azId String 可用区域ID。 azName String 可用区域名称。 azCode String 可用区域英文名称 availabilityZoneId String 可用区域 instanceId String 实例ID。 vnc String 远程登录弹性云服务器的URI地址。 tenantId String 项目编号。 volumeSize Integer 磁盘存储空间。 volumeType String 磁盘类型。 subnetId String 子网ID。 subnetName String 子网名称。 securityGroupsId String 安全组ID。 slaveSecurityGroupsId String 非Master节点的安全组id，当前一个MRS集群只会使用一个安全组，所以该字段已经废弃，从兼容性考虑，该字段会返回和securityGroupsId同样的值。 bootstrapScripts Array of BootstrapScript objects 配置引导操作脚本信息。 safeMode Integer MRS集群运行模式。 0：普通集群 1：安全集群 clusterVersion String 集群版本。 nodePublicCertName String 密钥文件名称。 masterNodeIp String Master节点IP。 privateIpFirst String 首选私有IP。 errorInfo String 错误信息。 tags String 标签信息 masterNodeNum String 集群部署的Master节点数量。 coreNodeNum String 集群部署的Core节点数量。 masterNodeSize String Master节点的实例规格。 coreNodeSize String Core节点的实例规格。 masterNodeProductId String Master节点产品ID。 masterNodeSpecId String Master节点规格ID。 coreNodeProductId String Core节点产品ID。 coreNodeSpecId String Core节点规格ID。 masterDataVolumeType String Master节点数据磁盘存储类别，目前支持SATA、SAS和SSD。 masterDataVolumeSize Integer Master节点数据磁盘存储空间。为增大数据存储容量，创建集群时可同时添加磁盘。 取值范围：100GB～32000GB，传值只需填数字，不需要带单位GB。 masterDataVolumeCount Integer Master节点数据磁盘个数。 取值只能是1 coreDataVolumeType String Core节点数据磁盘存储类别，目前支持SATA、SAS和SSD。 coreDataVolumeSize Integer Core节点数据磁盘存储空间。为增大数据存储容量，创建集群时可同时添加磁盘。 取值范围：100GB～32000GB，传值只需填数字，不需要带单位GB。 coreDataVolumeCount Integer Core节点数据磁盘个数。 取值范围：1～10 enterpriseProjectId String 企业项目ID。 isMrsManagerFinish Boolean 表示集群创建过程中，MRS Manager是否安装完成。 true：安装完成 false：安装未完成 clusterType Integer 集群类型。 logCollection Integer 集群安装失败时，是否搜集日志。 0：不收集 1：收集 periodType Integer 区分包周期，集群是包年还是包月。 0：包月 1：包年 scale String 集群节点的变更状态（扩容/缩容/变更规格）。当该参数取值为空时，表示集群节点没有进行变更操作。 取值范围： scaling-out：扩容中 scaling-in：缩容中 scaling-error：处于running状态，且上一次扩容/缩容/升级规格失败的集群 scaling-up：Master节点规格升级中 scaling_up_first：备Master节点规格升级中 scaled_up_first：备Master节点规格升级成功 scaled-up-success：Master节点规格升级成功 nodeGroups Array of NodeGroupV10 objects Master节点、Core节点和Task节点列表信息。 taskNodeGroups Array of NodeGroupV10 objects Task节点列表信息。 eipId String 集群弹性公网ip的唯一标识。 eipAddress String 集群弹性公网ip的IPV4地址。 eipv6Address String 集群弹性公网ip的IPV6地址，IPv4时无此字段。 表5 ComponentAmb 参数 参数类型 描述 componentId String 组件ID。 componentName String 组件名称。 componentVersion String 组件版本。 componentDesc String 组件描述信息。 表6 BootstrapScript 参数 参数类型 描述 name String 引导操作脚本的名称，同一个集群的引导操作脚本名称不允许相同。 只能由数字、英文字符、空格、中划线和下划线组成，且不能以空格开头。 可输入的字符串长度为1～64个字符。 uri String 引导操作脚本的路径。设置为OBS桶的路径或虚拟机本地的路径。- OBS桶的路径：直接手动输入脚本路径。例如输入MRS提供的公共样例脚本路径。示例：s3a://bootstrap/presto/presto-install.sh，其中安装dualroles时，presto-install.sh脚本参数为dualroles, 安装worker时，presto-install.sh脚本参数为worker。根据Presto使用习惯，建议您在Active Master节点上安装dualroles，在Core节点上安装worker。- 虚拟机本地的路径：用户需要输入正确的脚本路径。脚本所在的路径必须以‘/’开头，以.sh结尾。 parameters String 引导操作脚本参数。 nodes Array of strings 引导操作脚本所执行的节点类型，包含master、core和task三种类型。说明：节点类型必须为小写字母。 active_master Boolean 引导操作脚本是否只运行在主Master节点上。 缺省值为false，表示引导操作脚本可运行在所有Master节点上。 fail_action String 引导操作脚本执行失败后，是否继续执行后续脚本和创建集群。 缺省值为errorout,表示终止操作。 说明： 建议您在调试阶段设置为“继续”，无论此引导操作是否执行成功，则集群都能继续安装和启动。 枚举值： continue：继续执行后续脚本。 errorout：终止操作。 before_component_start Boolean 引导操作脚本执行的时间。目前支持“组件启动前”和“组件启动后”两种类型。 缺省值为false，表示引导操作脚本在组件启动后执行。 start_time Long 单个引导操作脚本的执行时间。 state String 单个引导操作脚本的运行状态。 PENDING IN_PROGRESS SUCCESS FAILURE action_stages Array of strings 选择引导操作脚本执行的时间。 BEFORE_COMPONENT_FIRST_START: 组件首次启动后 AFTER_COMPONENT_FIRST_START: 组件首次启动前 BEFORE_SCALE_IN: 缩容前 AFTER_SCALE_IN: 缩容后 BEFORE_SCALE_OUT: 扩容前 AFTER_SCALE_OUT: 扩容后 表7 NodeGroupV10 参数 参数类型 描述 GroupName String 节点组名。 NodeNum Integer 节点数量，取值范围0～500，Master节点和Core节点数量至少为1，Core与Task节点总数最大为500个。 NodeSize String 节点的实例规格。 NodeSpecId String 节点实例规格ID。 VmProductId String 节点虚拟机产品ID。 VmSpecCode String 节点虚拟机产品规格。 NodeProductId String 节点实例产品ID。 RootVolumeSize Integer 节点系统盘大小，不可配置，默认为40GB。 RootVolumeProductId String 节点系统盘的产品ID。 RootVolumeType String 节点系统盘的类型。 RootVolumeResourceSpecCode String 节点系统盘产品规格。 RootVolumeResourceType String 节点系统盘产品类型。 DataVolumeType String 节点数据磁盘存储类别，目前支持SATA、SAS和SSD。 SATA：普通IO SAS：高IO SSD：超高IO DataVolumeCount Integer 节点数据磁盘存储数目。 DataVolumeSize Integer 节点数据磁盘存储大小。 DataVolumeProductId String 节点数据磁盘的产品ID。 DataVolumeResourceSpecCode String 节点数据磁盘的产品规格。 DataVolumeResourceType String 节点数据磁盘的产品类型。

URI GET /v1.1/{project_id}/cluster_infos 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目编号。获取方法，请参见获取项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 tags 否 String 可以通过集群的标签来搜索指定标签的集群，当指定多个tag进行查询时，标签之间是与的关系。 tags参数的格式为tags=k1v1,k2v2,k3*v3 当标签的value为空时，格式为tags=k1,k2,k3*v3 pageSize 否 String 分页查询每页返回的最大集群数量。 取值范围：[1～2147483646] currentPage 否 String 当前查询页码。 clusterName 否 String 集群名称。 clusterState 否 String 根据集群状态查询集群列表。 existing：查询现有集群列表，包括除“已删除”、包周期集群的“订单处理中”和“准备中”状态外的所有集群。 history：查询历史集群列表，包括所有“已删除”、删除集群失败、集群删除虚拟机失败、删除集群更新数据库失败等状态的集群。 starting：查询启动中的集群列表。 running：查询运行中的集群列表。 terminated：查询已删除的集群列表。 failed：查询失败的集群列表。 abnormal：查询异常的集群列表。 terminating：查询删除中的集群列表。 frozen：查询已冻结的集群列表。 scaling-out：查询扩容中的集群列表。 scaling-in：查询缩容中的集群列表。 enterpriseProjectId 否 String 通过企业项目ID来搜索指定项目的集群。 该参数默认设置为0，表示为default企业项目。 获取方式请参见《企业管理API参考》的“查询企业项目列表”响应消息表“enterprise_project字段数据结构说明”的“id”。

URI GET /v1.1/{project_id}/clusters/{cluster_id}/hosts 表1 路径参数 参数 是否必选 参数类型 描述 cluster_id 是 String 集群ID。获取方法，请参见获取集群ID。 project_id 是 String 项目编号。获取方法，请参见获取项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 pageSize 否 String 分页查询每页返回的最大集群数量。 取值范围：[1～2147483646] 默认值为10。 currentPage 否 String 当前查询页码。默认值为1。

响应示例 状态码： 200 查询主机列表信息成功。 { "total" : "5", "hosts" : [ { "id" : "063d1d47-ae91-4a48-840c-b3cfe4efbcf0", "name" : "a78e161c-d14f-4b68-8c2d-0219920ce844_node_core_IQhiC", "ip" : "192.168.0.169", "availability_zone_id" : null, "tags" : null, "status" : "ACTIVE", "resource_id" : "95c1eabc-ed1d-4037-97d1-62f0587790c7", "flavor" : "c2.2xlarge.linux.mrs", "type" : "Core", "mem" : "16384", "cpu" : "8", "root_volume_size" : "480", "data_volume_type" : "SATA", "data_volume_size" : "600", "data_volume_count" : "1" }, { "id" : "dc5c6208-faa2-4727-a65a-2b1ce235d350", "name" : "a78e161c-d14f-4b68-8c2d-0219920ce844_node_master1_ASzkl", "ip" : "192.168.0.156", "availability_zone_id" : null, "tags" : null, "status" : "ACTIVE", "resource_id" : "95c1eabc-ed1d-4037-97d1-62f0587790c7", "flavor" : "c2.4xlarge.linux.mrs", "type" : "Master", "mem" : "32768", "cpu" : "16", "root_volume_size" : "480", "data_volume_type" : "SATA", "data_volume_size" : "600", "data_volume_count" : "1" }, { "id" : "c0ce793d-848b-448a-835b-ea0cac534b09", "name" : "a78e161c-d14f-4b68-8c2d-0219920ce844_node_core_ANnRN", "ip" : "192.168.0.243", "availability_zone_id" : null, "tags" : null, "status" : "ACTIVE", "resource_id" : "95c1eabc-ed1d-4037-97d1-62f0587790c7", "flavor" : "c2.2xlarge.linux.mrs", "type" : "Core", "mem" : "16384", "cpu" : "8", "root_volume_size" : "480", "data_volume_type" : "SATA", "data_volume_size" : "600", "data_volume_count" : "1" }, { "id" : "95c23e43-ef6e-4732-b6ed-a5f1c7779fae", "name" : "a78e161c-d14f-4b68-8c2d-0219920ce844_node_core_uRRiA", "ip" : "192.168.0.126", "availability_zone_id" : null, "tags" : null, "status" : "ACTIVE", "resource_id" : "95c1eabc-ed1d-4037-97d1-62f0587790c7", "flavor" : "c2.2xlarge.linux.mrs", "type" : "Core", "mem" : "16384", "cpu" : "8", "root_volume_size" : "480", "data_volume_type" : "SATA", "data_volume_size" : "600", "data_volume_count" : "1" }, { "id" : "63bdbf75-1133-4a94-8c27-1fa12c8b9e70", "name" : "a78e161c-d14f-4b68-8c2d-0219920ce844_node_master2_StqFu", "ip" : "192.168.0.22", "availability_zone_id" : null, "tags" : null, "status" : "ACTIVE", "resource_id" : "95c1eabc-ed1d-4037-97d1-62f0587790c7", "flavor" : "c2.4xlarge.linux.mrs", "type" : "Master", "mem" : "32768", "cpu" : "16", "root_volume_size" : "480", "data_volume_type" : "SATA", "data_volume_size" : "600", "data_volume_count" : "1" } ]}

响应示例 状态码： 200 操作成功。 { "resources" : [ { "resource_detail" : null, "resource_id" : "cdfs_cefs_wesas_12_dsad", "resource_name" : "clusterA", "tags" : [ { "key" : "key1", "value" : "value1" }, { "key" : "key2", "value" : "value1" } ] } ], "total_count" : "1000"}

请求示例 查询action为filter时的集群列表 POST https://{endpoint}/v1.1/{project_id}/{resource_type}/resource_instances/action{ "offset" : "100", "limit" : "100", "action" : "filter", "matches" : [ { "key" : "resource_name", "value" : "clusterA" } ], "not_tags" : [ { "key" : "key1", "values" : [ "value1", "value2" ] } ], "tags" : [ { "key" : "key1", "values" : [ "value1", "value2" ] } ], "tags_any" : [ { "key" : "key1", "values" : [ "value1", "value2" ] } ], "not_tags_any" : [ { "key" : "key1", "values" : [ "value1", "value2" ] } ]} 查询action为count时的集群列表 POST https://{endpoint}/v1.1/{project_id}/{resource_type}/resource_instances/action{ "action" : "count", "not_tags" : [ { "key" : "key1", "values" : [ "value1", "value2" ] } ], "tags" : [ { "key" : "key1", "values" : [ "value1", "value2" ] }, { "key" : "key2", "values" : [ "value1", "value2" ] } ], "tags_any" : [ { "key" : "key1", "values" : [ "value1", "value2" ] } ], "not_tags_any" : [ { "key" : "key1", "values" : [ "value1", "value2" ] } ], "matches" : [ { "key" : "resource_name", "value" : "clusterA" } ]}

响应示例 状态码： 200 可用区信息 { "available_zones" : [ { "id" : "cn-north-7a", "az_code" : "cn-north-7a", "az_name" : "可用区1", "az_id" : "8c90c2a4e2594c0782faa6b205afeca7", "status" : "Running", "region_id" : "cn-north-7", "az_type" : "Dedicated", "az_group_id" : "", "az_tags" : { "mode" : null, "alias" : null, "public_border_group" : "center" } }, { "id" : "cn-north-7b", "az_code" : "cn-north-7b", "az_name" : "可用区2", "az_id" : "d539378ec1314c85b76fefa3f7071458", "status" : "Running", "region_id" : "cn-north-7", "az_type" : "Dedicated", "az_tags" : { "mode" : null, "alias" : null, "public_border_group" : "center" } }, { "id" : "cn-north-7c", "az_code" : "cn-north-7c", "az_name" : "可用区3", "az_id" : "9f1c5806706d4c1fb0eb72f0a9b18c77", "status" : "Running", "region_id" : "cn-north-7", "az_type" : "Dedicated", "az_tags" : { "mode" : null, "alias" : null, "public_border_group" : "center" } } ], "default_az_code" : "cn-north-7a", "support_physical_az_group" : true}

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 available_zones Array of AvailableZoneV2 objects 可用区列表 default_az_code String 默认可用区编码 support_physical_az_group Boolean 支持的物理可用区分组 表4 AvailableZoneV2 参数 参数类型 描述 id String 可用区编码 az_code String 可用区编码 az_name String 可用区名称 az_id String 可用区id status String 可用区状态 region_id String 区域id az_group_id String 可用区分组id az_type String 当前AZ的类型: Core 核心 Satellite 卫星 Dedicated 专属 Virtual 虚拟 Edge 边缘 EdgeCental 中心边缘 Hybrid 混合云 az_tags AvailableTag object 可用区标签 表5 AvailableTag 参数 参数类型 描述 mode String 模式，分为专属dedicated和共享shared alias String az的别名 public_border_group String 所属group。默认为”center”