华为云用户手册

逻辑场景 Logical scenario 逻辑场景的参数声明通过：范围型[最小值..最大值] 和枚举型[值1, 值2] 的方式来实现泛化: 范围型支持float和scalar类型 枚举型支持int, float, bool, str, enum和scalar类型，且需要保证枚举列表中的元素均为相同类型. 例1：范围型 m_value: float = [2.0..3.0] v: speed = [5mps..10mps] delay: time = [40s..60s] m_a: acceleration = [0.00mpss..0.03mpss] 例2：枚举型 m_ id: int = [-1, 2] m_value: float = [2.0, 3.0] m_on_road: bool = [true, false] Ego_name: string = ["Audi_A3_2009_black", "Audi_A3_2009_red"] m_shape: dynamics_shape = [linear, sinusoidal] m_side: side_left_right = [left, right] v: speed = [5mps, 7mps, 10mps] m_a: acceleration = [0.01mpss, 0.03mpss] delay: time = [40s, 60s, 100s] 通过泛化参数，可以实现实体entity 、动作act ，以及修饰器modifier 的泛化. Struct类型不能直接泛化，而是通过泛化参数来进行泛化. 例1：entity泛化 Ego_name: string = ["Audi_A3_2009_black", "Audi_A3_2009_red"] Ego_controller: string = "DefaultDriver" Ego: vehicle with: keep(it.name == Ego_name) keep(it.initial_bm == Ego_controller) 例2：act泛化 m_lateral: bool = [true, false] m_speed: speed = [5mps..15mps] m_rate_profile: dynamics_shape = linear Ego.activate_controller(m_lateral, true) Ego.change_speed(target: m_speed, rate_peak: 0.0mpss, rate_profile: m_rate_profile) 例3：modifier泛化 m_speed: speed = [5mps..15mps] Ego.assign_init_speed() with: speed(speed: m_speed) 例4：Struct类型泛化 m_lane_id: int = [-1, 2] m_odr: odr_point = map.create_odr_point(road_id: '0', lane_id:m_lane_id, s: 5.0m, t: 0.0m) m_x: distance = [2m..7.5m] m_position_3d: position_3d = map.create_xyz_point(x: m_x, y: 10.0m ,z: 0.0m) m_pose_3d: pose_3d with: keep(it.odr_point == m_odr) 父主题： 参数声明 Parameter Declarations

具体场景 Concrete scenario 具体场景的参数声明支持基础类型、标量(scalar)类型、枚举(enum)类型，和 结构(struct)类型： 基础类型包含int、float、bool，和string类型.可以直接在等号后赋值. scalar类型包含speed、acceleration、length、time，和angle类型.赋值时需要在值后 加上OSC2.0支持的单位（见附录Scalar units）. enum类型包含side_left_right、distance_direction、distance_mode、 lane_change_side、 dynamics_shape，和 catalog.赋值时必须使用枚举列表内的值（见附录Enum list） . struct类型包含odr_point、xyz_point、position_3d、road_point、orientation_3d和pose_3d等，可以使用 keep创建.此外，odr_point、xyz_point，和road_point分别可以使用map的成员函数 create_odr_point 、 create_xyz_point 和create_road_point 来创建（OSC2.0支持的struct类型详见附录Struct）. 给bool型赋值时必须使用'true'和'false'，如果使用'True'或'False'或拼写错误将使语句无效. 例1：基础类型 m_road_id: string = '0' Ego_name: string = "Audi_A3_2009_black" m_lateral: bool = true 例2：scalar类型 v: speed = 5mps delay: time = 40s distance: length = 30.0m m_a: acceleration = 0.01mpss 例3：enum类型 m_side: side_left_right = right m_direction: distance_direction = longitudinal 例4：struct类型，keep创建 my_odr: odr_point with: keep(it.road_id == 0) keep(it.lane_id == -1) keep(it.s == 3.0m) keep(it.t == 0.0m) my_pos: position_3d with: keep(it.x == 1.0m) keep(it.y == 2.0m) keep(it.z == 3.0m) my_xyz: xyz_point with: keep(it.position == my_pos) my_road: road_point with: keep(it.road_id == '1') keep(it.s == 3.0m) keep(it.t == 0.0m) my_orientation: orientation_3d with: keep(it.roll == 1.0rad) keep(it.pitch == 2.0rad) keep(it.yaw == 3.0rad) my_pose: pose_3d with: keep(it.xyz_point == my_xyz) keep(it.orientation == m_orientation) m_trajectory: trajectory with: keep(it.points == [my_pose1, my_pose2, my_pose3]) keep(it.time_stamps == [0s, 5s, 20s] ) 例5：struct类型，map创建 my_odr: odr_point = map.create_odr_point(road_id: m_road_id,lane_id:'-4',s: 5.0m, t: 0.0m) my_xyz: xyz_point = map.create_xyz_point(x: 2.5m, y: 10.0m ,z: 0.0m) my_point: road_point = map.create_road_point(road_id: '1', s: 5.0m, t: 0.0m) 父主题： 参数声明 Parameter Declarations

采样结果 如下图1和图2所示，对于某个逻辑场景进行拉丁超立方和蒙特卡洛采样，参数都是符合随机特性，但采样得到的值不相同。 对于同样的采样点数，拉丁超立方采样的结果会更加分散，并且边界值会更多。 图4 蒙特卡洛采样结果 图5 拉丁超立方采样结果 对于离散型参数，联合概率分布采样会根据给定的取值列表进行随机采样。 图6 离散型参数-联合概率分布采样结果 对于连续型参数，联合概率分布采样会根据参数分布和相关系数进行采样。 图7 连续型参数-联合概率分布采样结果 对于重要性采样，联合概率分布采样会在边界附近进行采样。 图8 重要性采样结果

并行仿真 Octopus平台的并行仿真模块分为任务配置和仿真任务两部分。用户在任务配置模块，可使用自研仿真算法，根据Octopus自研仿真评测体系，从行车安全、驾驶行为、乘员舒适性等多维度测评在多种条件下的仿真场景中控制算法控制质量。在仿真任务模块，可将仿真任务运行中关键指标变化绘制成图表，直观形象，也可在仿真任务结束后评测报告可下载至本地查看。 任务配置 仿真任务 3D回放 排队任务管理 信号查看器 场景回放 父主题： 仿真服务

用例管理 在测试用例的详情页，可以进行以下操作： 查看测试用例详情。 单击用例名称查看该用例详细信息。 图1 测试用例详情 编辑测试脚本。 可根据需要添加测试脚本，在测试用例详情页，单击测试脚本后面的“编辑”，编辑脚本类型。 图2 编辑测试脚本 用例发布。 当用例状态为“编辑中”时，用例详情页面，单击用例名称后“发布”，可对用例进行发布。 关闭用例。 当用例状态为“已发布”时，用例详情页面，单击用例名称后“关闭用例”，可对用例进行关闭。 修改用例。 单击用例名称，进入用例详情页，单击右上角“编辑”，即可修改用例信息。 用例状态为＂已关闭＂和＂已发布＂时，不支持编辑用例基本信息。 用例编辑中/发布/关闭的使用逻辑： 测试用例在被创建时的默认状态是编辑中，当测试用例中的场景和测试脚本以及其他相关信息都确认达到测试条件时，可以选择发布测试用例，发布后的测试用例才能被用于创建仿真任务，并且用例一旦发布，就不允许删除，从而保证测试结果的可追溯。当发布后的测试用例后续不会再进行测试时，可以选择关闭测试用例，关闭后的测试用例不能用于创建仿真任务，并且同样关闭后的测试用例不能被删除，从而保证结果的可追溯性。 父主题： 测试用例管理

评测列表 在评测列表，还可以进行以下操作： 表1 评测列表相关操作 任务 操作步骤 搜索评测 在搜索框中输入关键字搜索相关评测。支持通过评测名称和评测ID搜索。 查看评测详情 单击评测名称，页面跳转至评测详情页。 编辑评测 单击操作栏中的“编辑”，可编辑评测的信息。 说明： 当内置评测是system_default时，只支持编辑“评测模式”。 删除评测 单击操作栏中的“删除”，可删除该评测。 父主题： 评测管理

模型推理启动文件实例 如果要将自定义模型用于评测，启动文件请参考如下示例，以2D目标检测为例： # -*- coding: utf-8 -*- """ 用户自定义启动脚本，用于模型评测 """ # 用户推理入口，函数名不限 def detect(image_dir, output_dir): # 用户处理脚本，此处省略 # 示例推理过程，用户也可根据dataloader等完成推理过程 for img in os.listdir(image_dir): img_path = os.path.join(image_dir, img) img_data = cv2.imread(img_path) detections = model.predict(img_data) # 将单个样本的推理结果保存为如下的json文件 results = [] for x1, y1, x2, y2, score, cls_pred in detections: bbox = {} bbox["xmin"] = int(x1) bbox["ymin"] = int(y1) bbox["xmax"] = int(x2) bbox["ymax"] = int(y2) results.append({ "name": classes[int(cls_pred)], "score": f"{score:0.4f}", "bndbox": bbox }) # 保证推理结果文件与图片（样本）同名存入结果路径（保存为Octopus-2d检测推理格式） sample_dir = os.path.join(output_path, os.path.basename(image_path).split(".")[0]) os.makedirs(sample_dir, exist_ok=True) json_file = os.path.join(sample_dir, os.path.basename(image_path).split(".")[0] + ".json") json.dump(results, open(json_file, "w")) # 推理脚本入口 if __name__ == '__main__': # 获取数据集路径与推理结果存放路径，用户根据命令行参数获取数据集位置和推理结果存储位置 parser = argparse.ArgumentParser() parser.add_argument("--image_dir", type=str, default=os.getenv("DATASET"") parser.add_argument("--output_dir", type=str, default=os.getenv("INFER_RESULT") args, unparsed = parser.parse_known_args() # 接收数据路径合结果路径后，调用推理服务，根据用户实际推理方法或文件进行替换 detect(args.image_dir, args.output_dir)

Lidar激光雷达标定文件模板 标定文件名：“lidar_right_999.yaml” 文件内容示例： Pandar40: rotation_vel2veh_matrix: rows: 3 cols: 3 data: [0.999365,0.0349167,0.00707821,-0.034795,0.999256,-0.0166374,-0.00765387,0.0163806,0.999837] tanslation_vel2veh_vector: rows: 3 cols: 1 data: [0.00915069,1.34196,1.38] rotation_veh_vel_euler: yaw: -1.9940678960476272 pitch: 0.43853880056948835 roll: 0.9386082809708912 translation_veh_vel: x: 0.00915069 y: 1.34196 z: 1.38 timeshift_vel_veh: 0.000000000 父主题： 标定文件模板

Camera相机标定文件模板 标定文件名：“roof_cam_999.yaml” 文件内容示例： Roof_Cam_9: camera_model: pinhole intrinsics: rows: 1 cols: 4 data: - 957.3874 - 960.8491 - 957.7912 - 565.3051 resolution: width: 1020 height: 1920 distortion_model: radtan distortion_coeffs: rows: 1 cols: 5 data: - -0.3152 - 0.1068 - 1.0109e-05 - 0.00014344 - -0.0174 rotation_veh2cam_matrix: rows: 3 cols: 3 data: - -0.9998299042764152 - 0.017818974176046335 - 0.004792519744625967 - -0.0052751312364799794 - -0.027136554579648777 - -0.999617350015897 - -0.01768206109206492 - -0.9994728825361424 - 0.027225960978949772 tanslation_veh2cam_matrix: rows: 3 cols: 1 data: - -0.03155699382111174 - 1.1564462683421137 - 0.5492014802301336 rotation_veh_cam_euler: yaw: 178.97898507859358 pitch: -0.27459237862937325 roll: -88.43985827166519 translation_veh_cam: x: -0.015740166503007778 y: 0.580856341427072 z: 1.1412035414910402 transform_image2veh_matrix: rows: 3 cols: 3 data: [] transform_veh2image_matrix: rows: 3 cols: 4 data: - -973.6528713841998 - -939.7369315451515 - 30.649111295873002 - 495.5498232950973 - -15.049594426539091 - -590.5017166128401 - -944.1638507975063 - 1420.2429138739958 - -0.01768206109206492 - -0.9994728825361424 - 0.027225960978949772 - 0.5492014802301336 timeshift_cam_veh: 0.0 父主题： 标定文件模板

Vehicle车辆标定文件模板 标定文件名：“车辆自身参数.yaml” 文件内容示例： # The vehicle config vehicle: # basic mass: #质量 # Body front_track: #m前轮距 rear_track: #m后轮距 wheelbase: #m轴距 height: #m高度 width: #m宽度 length: #m长度 rear_distance: #m后轴到车尾距离 front_distance: #m后轴到车头距离 x_CoG: #m前轴到重心距离，x方向 y_CoG: #m中心到重心距离，y方向 z_CoG: #m地面到重心距离，z方向 # Wheel and brake wheel_radius: #m车轮半径 # Steering min_steering_angle: #rad车轮最小转向角度，弧度 max_steering_angle: #rad车轮最大转向角度，弧度 min_steering_wheel_angle: #rad方向盘最小转向角度，弧度 max_steering_wheel_angle: #rad方向盘最大转向角度，弧度 max_steering_wheel_speed: #rad/s方向盘最大转速 steering_zero_bias: #rad初始位置偏移量 # Powertrain max_speed: #m/s最大速度 max_reversing_speed: #m/s最大倒车速度 max_deceleration: #最大减速度 max_acceleration: #最大加速度 rpm_idle: #r/min引擎空闲状态转速 rpm_change: #r/min换挡时引擎转速 rpm_max: # r/min引擎最大转速 engine_power_max: #watt引擎最大功率 # Transmission main_ratio: #主减速器比率 gear_ratio_drive: #驾驶模式传动比率 gear_ratio_reverse: #倒车模式传动比率 # Coefficient lambda: #等效质量乘数，需大于1 Cd: #空气阻力系数 # default lane params lane_width_default: #车道宽度 lane_width_margin: #车道边线宽度 safe_avoid_distance: #m安全边线距离 #localizaition loc: yaw_offset: 父主题： 标定文件模板

ModelArts入门实践 本章节列举了一些常用的实践案例，方便您快速了解并使用ModelArts完成AI开发。 表1 常用最佳实践 分类 实践案例 描述 适用人群 ModelArts Standard模型训练 使用ModelArts Standard的专属资源池训练模型 本案例介绍了如何使用ModelArts Standard专属资源池提供的计算资源，结合SFS和OBS存储，在ModelArts Standard的训练环境中开展单机单卡、单机多卡、多机多卡分布式训练。 面向熟悉代码编写和调测的AI工程师，同时了解SFS和OBS云服务 示例：从 0 到 1 制作 自定义镜像 并用于训练（Pytorch+CPU/GPU） 本案例介绍如何从0开始制作镜像，并使用该镜像在ModelArts Standard平台上进行训练。镜像中使用的AI引擎是Pytorch，训练使用的资源是CPU或GPU。 面向熟悉代码编写和调测的AI工程师，同时熟悉docker容器知识 示例：从 0 到 1 制作自定义镜像并用于训练（MindSpore+Ascend） 本案例介绍如何从0开始制作镜像，并使用该镜像在ModelArts Standard平台上进行训练。镜像中使用的AI引擎是MindSpore，训练使用的资源是Ascend。 主流开源大模型基于Standard适配PyTorch NPU训练指导 本案例基于ModelArts Standard供的昇腾计算资源，指导用户完成Llama、Qwen、ChatGLM、Yi、Baichuan等常见开源大模型的预训练、SFT微调、LoRA微调训练过程。 面向熟悉代码编写和调测的AI工程师 ModelArts Standard推理部署 使用Standard一键完成商超商品识别模型部署 本案例以“商超商品识别”模型为例，介绍从AI Gallery订阅模型，一键部署到ModelArts Standard，并进行在线推理预测的体验过程。 面向AI开发零基础的用户 从0-1制作自定义镜像并创建AI应用 针对ModelArts不支持的AI引擎，您可以构建自定义镜像，并将镜像导入ModelArts，创建为AI应用。本案例详细介绍如何使用自定义镜像创建AI应用，并部署成在线服务。 面向熟悉代码编写和调测的AI工程师，同时熟悉docker容器知识 主流开源大模型基于Standard适配PyTorch NPU推理指导 本案例基于ModelArts Standard供的昇腾计算资源，指导用户完成Llama、Qwen、ChatGLM、Yi、Baichuan等常见开源大模型的推理部署、模型评测、模型量化等功能。 面向熟悉代码编写和调测的AI工程师 ModelArts Standard自动学习 使用Standard自动学习实现垃圾分类 本案例基于华为云AI开发者社区AI Gallery中的数据集资产，让零AI基础的开发者使用ModelArts Standard的自动学习功能完成“图像分类”AI模型的训练和部署。 面向AI开发零基础的用户 使用Standard自动学习实现口罩检测 本案例基于华为云AI开发者社区AI Gallery中的数据集资产，让零AI基础的开发者使用ModelArts Standard的自动学习功能完成“物体检测”AI模型的训练和部署。依据开发者提供的标注数据及选择的场景，无需任何代码开发，自动生成满足用户精度要求的模型。 ModelArts Standard开发环境 本地开发的MindSpore模型迁移至云上训练 本案例介绍了如何将本地开发好的MindSpore模型代码，通过PyCharm ToolKit连接到ModelArts Standard进行云上调试和训练。 面向熟悉代码编写和调测的AI工程师 使用ModelArts VS Code插件进行模型开发（Ascend） 本案例以Ascend Model Zoo为例，介绍如何通过VS Code插件及ModelArts Standard的Notebook进行云端数据调试及模型开发。 ModelArts Lite Server 主流开源大模型基于DevServer适配PyTorch NPU训练指导 本案例基于ModelArts Lite DevServer供的昇腾计算资源，指导用户完成Llama、Qwen、ChatGLM、Yi、Baichuan等常见开源大模型的预训练、SFT微调、LoRA微调训练过程。 面向熟悉代码编写和调测的AI工程师，同时熟悉Linux和Docker容器基础知识 主流开源大模型基于DevServer适配PyTorch NPU推理指导 本案例基于ModelArts Lite DecServer提供的昇腾计算资源，指导用户完成Llama、Qwen、ChatGLM、Yi、Baichuan等常见开源大模型的推理部署、模型评测、模型量化等功能。

步骤6：运行工作流 项目完成创建之后，会自动跳转到新版自动学习的运行总览页面。同时您的工作流会自动从数据标注节点开始运行。您需要做的是： 观察数据标注节点，待数据标注节点变为橙色即为“等待操作”状态。双击数据标注节点，打开数据标注节点的运行详情页面，单击“继续运行”。 在弹出的窗口中，单击“确定”，工作流会开始继续运行。当工作流运行到“服务部署”节点，状态会变为“等待输入”，您需要填写以下两个输入参数，其他参数保持默认。 计算节点规格：根据您的实际需求选择相应的规格，不同规格的配置费用不同，选择好规格后，配置费用处会显示相应的费用。 是否自动停止：为了避免资源浪费，建议您打开该开关，根据您的需求，选择自动停止时间，也可以自定义自动停止的时间。 图5 选择计算节点规格 图6 设置自动停止 参数填写完毕之后，单击运行状况右边的“继续运行”，单击确认弹窗中的“确定”即可继续完成工作流的运行。

步骤3：部署模型服务 “llama3.1”模型创建成功后，在我的模型列表，单击操作列的“部署”，进入部署模型服务页面。 在部署模型服务页面，完成创建配置。 图5 资源设置 表2 部署模型服务 参数 说明 取值样例 服务设置 服务名称 自定义模型服务的名称。 service-llama3 描述 部署模型服务的简介。 - 模型设置 部署模型 当从“我的模型”进入部署模型服务页面时，此处默认呈现选择的模型。 llama3.1 资源设置 资源池类型 资源池分为公共资源池与专属资源池。 公共资源池供所有租户共享使用。 专属资源池需单独创建，不与其他租户共享。 公共资源池 实例规格 选择实例规格，规格中描述了服务器类型、型号等信息。 xxx 单实例流量限制（QPM） 设置待部署模型的单实例流量限制QPM。 60 实例数 设置服务器个数。增加实例个数可提高总QPM，“总QPM = 单实例QPM x 实例数”。 1 更多选项 事件通知 选择是否打开“事件通知”开关。 开关关闭（默认关闭）：表示不启用 消息通知 服务。 开关打开：表示订阅消息通知服务，当任务发生特定事件（如任务状态变化或疑似卡死）时会发送通知。此时必须配置“主题名”和“事件”。 “主题名”：事件通知的主题名称。单击“创建主题”，前往消息通知服务中创建主题。 “事件”：选择要订阅的事件类型。例如“创建中”、“已完成”、“运行失败”等。 说明： 需要为消息通知服务中创建的主题添加订阅，当订阅状态为“已确认”后，方可收到事件通知。订阅主题的详细操作请参见添加订阅。 使用消息通知服务会产生相关服务费用，详细信息请参见计费说明。 关闭 自动停止 当使用付费资源时，可以选择是否打开“自动停止”开关。 开关关闭（默认关闭）：表示任务将一直运行。 开关打开：表示启用自动停止功能，此时必须配置自动停止时间，支持设置为“1小时”、“2小时”、“4小时”、6小时或“自定义”。启用该参数并设置时间后，运行时长到期后将会自动终止任务，准备排队等状态不扣除运行时长。 关闭 参数配置完成后，单击“提交”，创建部署任务。 在任务列表，当模型“状态”变成“运行中”时，表示模型部署完成。

步骤2：创建我的模型 登录ModelArts管理控制台。 在左侧导航栏中，选择“ModelArts Studio”进入ModelArts Studio大模型即服务平台。 在ModelArts Studio左侧导航栏中，选择“模型广场”进入模型广场。 在模型广场搜索“Llama3.1-8B”，单击“立即使用”进入模型详情页。 在模型详情页，单击“自定义模型”弹出创建模型页面。 在创建模型页面，配置参数。 图3 创建模型 表1 创建模型 参数 说明 取值样例 来源模型 当从“模型广场”进入创建模型页面时，此处默认呈现选择的模型。 Llama3.1-8B 模型名称 自定义模型名称。 llama3.1 描述 模型简介。 - 权重设置与词表 默认选择“使用推荐权重”，支持选择“自定义权重”。 使用平台推荐的权重文件，可提高模型的训练、压缩、部署和调优等服务的使用效率。 权重文件指的是模型的参数集合。 使用推荐权重 参数配置完成后，单击“创建”，创建自定义模型。 在模型列表，单击模型名称可以进入详情页查看模型详细信息和任务。 当模型“状态”变成“创建成功”时，表示模型创建完成。 图4 查看我的模型状态

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 regions Array of RegionSummary objects 数组长度：0 - 200 表3 RegionSummary 参数 参数类型 描述 region_id String 区域ID. region_status String 启用状态。 ENABLED：已启用 ENABLING：启用中 DISABLING：禁用中 DISABLED：已禁用 ENABLED_BY_DEFAULT：默认启用

响应示例 状态码： 200 Successful. { "data_list" : [ { "key" : "p-0c72ca49f26142389729cb49744f546c", "status" : "normal", "version" : 1667374528187, "account_id" : "abc4fcec974c4ee88fa60d6438e49a7c", "created_at" : "2023-02-08T04:00:55.924Z", "updated_at" : "2023-02-08T04:00:55.924Z", "value" : { "id" : "p-0c72ca49f26142389729cb49744f546c", "document" : "{\"Version\":\"5.0\",\"Statement\":[{\"Effect\":\"Allow\",\"Action\":[\"sts:agencies:assume\"]}]}" } } ] }

URI GET /internal/list-keys 表1 Query参数 参数 是否必选 参数类型 描述 collection 是 String The unique name of a data collection. region_switch 组织 account_id 否 Object The unique identifier (ID) of an account. limit 否 Integer Maximum number of results in a page. 最小值：1 最大值：200 缺省值：100 marker 否 String Page marker. 最小长度：4 最大长度：400

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 keys Array of strings The unique key of a data. 数组长度：0 - 200 page_info PageInfo object The information of page. 表3 PageInfo 参数 参数类型 描述 next_marker String If present, indicates that more output is available than is included in the current response. Use this value in the marker request parameter in a subsequent call to the operation to get the next part of the output. You should repeat this until the next_marker response element comes back as null. current_count Integer The number of items in the current page.

响应示例 状态码： 200 Successful { "user_features" : [ { "account_id" : "abc4fcec974c4ee88fa60d6438e49a7c", "feature_name" : "region_deny", "feature_status" : true, "created_at" : "2024-06-04T03:48:18.883Z", "updated_at" : "2024-06-04T03:48:18.883Z" } ] }

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 user_features Array of UserFeature objects The feature application object of the ListUserFeatures operation. 数组长度：1 - 200 表3 UserFeature 参数 参数类型 描述 account_id String The unique identifier (ID) of an account. feature_name String 特性名称。 region_deny：区域禁用 feature_status String 特性状态。 on：启用 off: 关闭 created_at String 创建时间。 updated_at String 更新时间。

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 region RegionSummary object 表3 RegionSummary 参数 参数类型 描述 region_id String 区域ID. region_status String 启用状态。 ENABLED：已启用 ENABLING：启用中 DISABLING：禁用中 DISABLED：已禁用 ENABLED_BY_DEFAULT：默认启用

URI GET /v1/list-regions 表1 Query参数 参数 是否必选 参数类型 描述 account_id 否 String 账号的唯一标识符（ID）。 最小长度：1 最大长度：36 region_status 否 Array 区域启用状态。ENABLED：已启用；ENABLING：启用中；DISABLING：禁用中；DISABLED：已禁用；ENABLED_BY_DEFAULT：默认启用。 数组长度：1 - 5

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 regions Array of RegionSummary objects 区域列表。 数组长度：0 - 2000 表3 RegionSummary 参数 参数类型 描述 region_id String 区域ID。 region_status String 启用状态。 ENABLED：已启用； ENABLING：启用中； DISABLING：禁用中； DISABLED：已禁用； ENABLED_BY_DEFAULT：默认启用。

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 region RegionSummary object 区域状态。 表3 RegionSummary 参数 参数类型 描述 region_id String 区域ID。 region_status String 启用状态。 ENABLED：已启用； ENABLING：启用中； DISABLING：禁用中； DISABLED：已禁用； ENABLED_BY_DEFAULT：默认启用。

错误码 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 更多服务错误码请参见API错误中心。 状态码 错误码 错误信息 描述 处理措施 401 Organizations.1001 This operation can be called only from the management account of an organization. 权限校验失败 请检查是否是组织的管理账号调用。 401 Organizations.1002 This operation can be called only from the management account of an organization or by a member account that is a delegated administrator for a service. 权限校验失败 请检查是否是组织的管理账号或委托管理员账号调用。 409 Organizations.1003 Concurrent modification. 并发修改 请稍后重试。 400 Organizations.1004 Bad request for generate organizations service management token. 生成组织管理员token请求错误 请稍后重试，如果再次失败请联系管理员。 400 Organizations.1005 Bad request for query cbc em info. 查询企业多账号请求失败 请确认是否是企业多账号的主账号或子账号。 400 Organizations.1006 Bad request for generate assume-role token. 升级权限失败 请稍后重试，如果再次失败请联系管理员。 403 Organizations.1007 Policy doesn't allow '{0}' to be performed. 细粒度鉴权失败 请检查用户有接口访问权限。 400 Organizations.1008 Bad request for checking permission. 细粒度鉴权请求错误 请联系管理员。 400 Organizations.1009 Bad request for impersonate. 切换角色请求错误 请联系管理员。 404 Organizations.1010 Not found for http header. 请求头不存在 请检查是否满足调用接口所需的全部请求头。 400 Organizations.1011 Bad request for invalid user profile. 无效用户配置文件的错误请求 请联系管理员。 400 Organizations.1012 Bad request for invalid context attributes. 对无效上下文属性的错误请求 请联系管理员。 400 Organizations.1013 Bad request for invalid marker. marker参数非法 请检查marker参数是否合法传入。 400 Organizations.1014 Bad request for request proof. proof请求头非法 请检查proof请求头是否合法传入。 401 Organizations.1015 This operation can be called from any account in the organization. 权限校验失败 请检查是否是组织的成员账号调用。 400 Organizations.1016 Bad request for domain tags. 获取账号标签失败 请联系管理员。 400 Organizations.1017 Bad request for get projects. 获取账号的项目信息失败 请联系管理员。 401 Organizations.1018 This operation can be called only from the organization's member account. 权限校验失败 请检查是否是组织的普通成员账号调用。 400 Organizations.1019 Bad request for query iam domain info. 获取用户信息失败 请联系管理员。 400 Organizations.1020 SSL check failed. 证书校验失败 请联系管理员。 400 Organizations.1021 Bad request for authorization header pattern. token请求头非法 请检查authorization请求头是否合法传入。 400 Organizations.1022 Bad request for query restricted list. 查询受限列表失败 请联系管理员。 400 Organizations.1023 Bad request for query frozen list. 查询冻结列表失败 请联系管理员。 404 Organizations.1100 Not found for organization. 组织不存在 请检查账号是否开通组织服务。 409 Organizations.1101 Conflict for create organization, this account is already a member of an organization. 创建组织发生冲突 请检查账号是否已经开通组织服务。 400 Organizations.1102 Deletes the organization, you must first remove all member accounts and all organizational units and all policies. 删除组织失败 请检查是否已经移除所有的成员账号、组织单元以及策略。 400 Organizations.1103 Can not create organization, only for primary account of EM. 无法创建组织，仅适用于EM的主账号 请检查是否是企业主子账号的主账号。 403 Organizations.1104 The current operation has been restricted. 操作被受限，不允许访问 请检查账号是否被受限。 403 Organizations.1105 The current operation has been frozen. 操作被冻结，不允许访问 请检查账号是否被冻结。 404 Organizations.1200 Not found for organizational unit. 组织单元不存在 请检查该组织单元是否存在。 404 Organizations.1201 Not found for a root or organizational unit with the ParentId. 根据ParentId没有找到root节点或组织单元 请检查该ParentId是否存在。 400 Organizations.1202 The organizational unit is not empty. 组织单元非空 请检查该组织单元是否清空，包括该组织单元下的账号及子组织单元。 400 Organizations.1203 Quota exceeded for an organizational unit tree level. 超过组织单元最大的树深度配额 请检查是否超过组织单元最大的树深度配额。 400 Organizations.1204 Quota exceeded for organizational unit. 超过可以创建的组织单元配额 请检查是否超过可以创建的组织单元配额。 409 Organizations.1205 Conflict for organizational unit, an organizational unit names must be unique within a parent. 组织单元名称不唯一 请检查组织单元名称是否在父节点下唯一。 404 Organizations.1300 Not found for account. 账号不存在 请检查该账号是否存在。 404 Organizations.1301 Not found for create account status. 创建账号状态不存在 请检查传入的create_account_status_id是否正确。 400 Organizations.1302 Bad request for wrong source parent id. source_parent_id错误 请检查传入的source_parent_id是否正确。 400 Organizations.1303 Bad request for wrong destination parent id. destination_parent_id错误 请检查传入的destination_parent_id是否正确。 400 Organizations.1304 The management account of the organization or the organization administrator could not leave organization. 组织的管理账号或管理员账号不能离开组织 请检查离开组织的账号是否是组织的管理账号或管理员账号。 400 Organizations.1305 Quota exceeded for account. 组织中的账号超出配额 请检查组织中的账号是否超出配额。 409 Organizations.1306 This account is already a member of an organization. An account can belong to only one organization at a time. 该账号已经是组织中的成员 请检查该账号是否已经是组织中的成员。 409 Organizations.1307 This account is already invited. 该账号已经被邀请 请检查该账号是否已经被邀请。 400 Organizations.1308 Can not invite account, only for sub-account of EM. 不能邀请账号，仅适用于EM的子账号 请检查是否是组织管理员所在企业主子账号的子账号。 400 Organizations.1309 This account cannot be invited because it is at a site different from your organization. 不能邀请该账号，因为该账号与当前组织不在同一站点 请检查主账号和被邀请账号是否在同一站点。 400 Organizations.1310 This account cannot be invited because its type is currently not supported. 不能邀请该账号，暂不支持邀请该账号类型 请检查账号类型是否为普通账号。 404 Organizations.1400 Not found for handshake. handshake不存在 请检查handshake是否正确。 400 Organizations.1401 Bad request for wrong handshake status, this operation can only be applied to a pending handshake. handshake状态不正确，该操作只能在handshake为pending时执行 请检查handshake的状态是否正确。 400 Organizations.1402 Quota exceeded for cancelled handshake per day. 超出每天取消handshake的配额 请检查是否超出每天取消handshake的配额。 404 Organizations.1500 Not found for delegated administrator. 委托管理员不存在 请检查委托管理员是否存在。 409 Organizations.1501 Conflict for delegated administrator. 委托管理员冲突 请检查委托管理员是否存在。 404 Organizations.1600 Not found for policy. 策略不存在 请检查该策略是否存在。 404 Organizations.1601 Not found for policy attachment. 策略绑定关系不存在 请检查该策略的绑定关系。 404 Organizations.1602 Not found for policy attachment entity. 策略需要绑定的实体不存在 请检查该策略需要绑定的实体是否存在。 409 Organizations.1603 Conflict for policy attachment. 绑定策略冲突 请检查该策略在该实体上是否已经存在绑定。 400 Organizations.1604 Bad request for existing policy attachment. 该策略不存在绑定的实体 请检查该策略是否存在绑定的实体。 400 Organizations.1605 Bad request for modify builtin policy. 内置策略不允许修改 请检查进行操作的策略是否是内置策略。 400 Organizations.1606 Quota exceeded for policy. 超出创建策略的配额 请检查是否达到策略的配额限制。 400 Organizations.1607 Quota exceeded for service control policy per entity. 每一个实体上允许绑定的策略超出配额 请检查该实体上已经绑定的策略是否达到配额限制。 400 Organizations.1608 Wrong format for policy content. 策略内容格式错误 请检查策略的内容是否格式错误。 404 Organizations.1609 Not found for root. root节点不存在 请检查输入的root节点ID是否正确。 404 Organizations.1610 Not found for root policy type. root节点策略类型不存在 请检查输入参数是否正确。 400 Organizations.1611 Bad request for wrong root policy type status. root节点策略类型状态错误 请检查输入参数是否正确。 409 Organizations.1612 Conflict for policy, policy names must be unique within an organization. 策略名称在同一个组织内不唯一 请检查策略名称在该组织下是否唯一。 400 Organizations.1613 Bad request for service control policy disabled. 服务控制策略已经禁止 请检查服务控制策略是否被禁止。 400 Organizations.1614 The last policy not allow detach. 最后一个策略不允许解绑 请检查需要解除绑定的策略是否是该实体的最后一个策略。 400 Organizations.1615 The policy name not allow all space. 策略名称不能全为空白字符 请检查策略名称是否合法。 400 Organizations.1616 Policy changes in progress. 策略变更正在进行 请稍后重试。 400 Organizations.1617 Scheduler runtime exception. 启用/禁用策略类型失败 请稍后重试。 400 Organizations.1618 Not supported policy type. 不支持的策略类型 请检查策略类型是否正确。 400 Organizations.1619 You provided a string parameter that is longer than allowed. 参数长度超出允许范围 请输入最大长度5120内的参数。 404 Organizations.1700 Not found for tag. 标签不存在 请检查标签是否存在。 404 Organizations.1701 Not found for tag resource. 标签所对应的资源不存在 请检查标签对应的资源是否存在。 409 Organizations.1702 Conflict for tag. 标签已经存在 请检查该资源是否已经存在该标签。 400 Organizations.1703 Quota exceeded for tag. 标签超出配额 请检查标签是否达到配额限制。 400 Organizations.1800 Invalid quota value. 配额值无效 请检查输入的配额值是否正确。 404 Organizations.1900 Not found for trusted service. 可信服务不存在 请检查输入的参数是否正确。 409 Organizations.1901 Conflict for trusted service. 可信服务冲突 请检查可信服务是否已经存在。 400 Organizations.1902 Delegated administrator is not empty for this service. 当前服务委托管理员不能为空 请给当前服务设置委托管理员。 400 Organizations.2000 Bad request for create service linked agency. 创建服务关联委托失败 请检查输入的参数是否正确。 400 Organizations.2001 Bad request for missing app_name. 缺少app名称 请检查是否缺少app名称。 409 Organizations.2002 Conflict for service linked agency, already created. 服务关联委托冲突 请检查是否已经存在该服务关联委托。 400 Organizations.2003 Bad request for delete service linked agency. 删除服务关联委托失败 请检查输入的参数是否正确。 404 Organizations.2004 Not found for service linked agency. 服务关联委托不存在 请检查是否存在该服务关联委托。 404 Organizations.2005 Not found for service request for service_principal. app名称不存在 请检查app名称是否正确。 400 Organizations.2006 Bad request for authorization header, jwt token is malformed. jwt token畸形 请检查jwt token是否正确。 400 Organizations.2100 Exactly one of parent id and child id should be provided. ParentId和ChildId必须填写一个 请检查ParentId和ChildId是否均不存在。 409 Organizations.2101 Conflict for service, service_principal and app_name names must be unique. service_principal或app_name冲突，该名称可能已存在 请检查service_principal或app_name是否已经存在。 404 Organizations.2102 Not found for service. 服务不存在 请检查传入的service_principal是否正确。 400 Organizations.2103 Bad request for list service principal. 获取service_principal错误 请检查输入的参数是否正确。 404 Organizations.2104 Not found for entity. 实体不存在 请检查实体id是否正确，如果是新建实体请稍后重试。 400 Organizations.2105 Policy type is invalid. 策略类型无效 请检查策略类型（tag_policy）。 404 Organizations.2106 Not found for service principal from iam, must register at IAM . service_principal未在IAM进行注册 请检查service_principal是否已经在IAM注册。 400 Organizations.2200 Time format or range error. 时间格式/范围错误 请检查输入的参数是否正确。 400 Organizations.2201 Bad request for change customer relation. 变更绑定关系失败 请联系管理员。 400 Organizations.2202 The relation of domain ID has changed too many times. 变更绑定关系次数太多 子客户不能频繁变更绑定关系（子客户单月操作不大于10次）。 403 Organizations.2007 Bad Request: {0}. 创建服务关联委托失败 根据填充的错误原因，检查权限是否被授权。 父主题： 附录

其他 权限 对应API接口 授权项（Action） IAM项目(Project) 企业项目(Enterprise Project) 查询有效的策略 GET /v1/organizations/entities/effective-policies organizations:effectivePolicies:get × × 列出组织中的根、组织单元和账号 GET /v1/organizations/entities organizations:entities:list × × 列出所有可以与组织服务集成的云服务 GET /v1/organizations/services organizations:services:list × × 列出被添加到标签策略强制执行的资源类型 GET /v1/organizations/tag-policy-services organizations:tagPolicyServices:list × × 列出租户的组织配额 GET /v1/organizations/quotas organizations:quotas:list × ×

标签管理 权限 对应API接口 授权项（Action） IAM项目(Project) 企业项目(Enterprise Project) 列出绑定到指定资源的标签 GET /v1/organizations/resources/{resource_id}/tags organizations:tags:list × × 为指定的资源添加标签 POST /v1/organizations/resources/{resource_id}/tag organizations:resources:tag × × 从指定资源中删除指定主键标签 POST /v1/organizations/resources/{resource_id}/untag organizations:resources:untag × × 列出绑定到指定资源的标签 GET /v1/organizations/{resource_type}/{resource_id}/tags organizations:tags:list × × 为指定资源添加标签 POST /v1/organizations/{resource_type}/{resource_id}/tags/create organizations:resources:tag × × 从指定资源中删除指定主键标签 POST /v1/organizations/{resource_type}/{resource_id}/tags/delete organizations:resources:untag × × 根据资源类型及标签信息查询实例列表 POST /v1/organizations/{resource_type}/resource-instances/filter organizations:resources:listByTag × × 根据资源类型及标签信息查询实例数量 POST /v1/organizations/{resource_type}/resource-instances/count organizations:resources:countByTag × × 查询资源标签 GET /v1/organizations/{resource_type}/tags organizations:resources:list × ×

委托管理员管理 权限 对应API接口 授权项（Action） IAM项目(Project) 企业项目(Enterprise Project) 注册作为服务委托管理员 POST /v1/organizations/delegated-administrators/register organizations:delegatedAdministrators:register × × 注销服务的委托管理员 POST /v1/organizations/delegated-administrators/deregister organizations:delegatedAdministrators:deregister × × 列出指定账号是其委托管理员的服务 GET /v1/organizations/accounts/{account_id}/delegated-services organizations:delegatedServices:list × × 列出此组织中指定为委托管理员的账号 GET /v1/organizations/delegated-administrators organizations:delegatedAdministrators:list × ×

可信服务管理 权限 对应API接口 授权项（Action） IAM项目(Project) 企业项目(Enterprise Project) 启用可信服务 POST /v1/organizations/enable-trusted-service organizations:trustedServices:enable × × 禁用受信任服务 POST /v1/organizations/disable-trusted-service organizations:trustedServices:disable × × 列出组织的可信服务列表 GET /v1/organizations/trusted-services organizations:trustedServices:list × ×

策略管理 权限 对应API接口 授权项（Action） IAM项目(Project) 企业项目(Enterprise Project) 创建策略 POST /v1/organizations/policies organizations:policies:create organizations:resources:tag（如果请求带标签） × × 列出策略 GET /v1/organizations/policies organizations:policies:list × × 查询策略相关信息 GET /v1/organizations/policies/{policy_id} organizations:policies:get × × 更新策略 PATCH /v1/organizations/policies/{policy_id} organizations:policies:update × × 删除策略 DELETE /v1/organizations/policies/{policy_id} organizations:policies:delete × × 在根中启用策略类型 POST /v1/organizations/policies/enable organizations:policies:enable × × 禁用根中的策略类型 POST /v1/organizations/policies/disable organizations:policies:disable × × 将策略跟实体绑定 POST /v1/organizations/policies/{policy_id}/attach organizations:policies:attach × × 将策略跟实体解绑 POST /v1/organizations/policies/{policy_id}/detach organizations:policies:detach × × 列出跟指定策略绑定的所有实体 GET /v1/organizations/policies/{policy_id}/attached-entities organizations:attachedEntities:list × ×