华为云用户手册

产品优势 部署形态灵活可选，除云上智能分析外，同步支持算法边缘节点部署，有效降低带宽成本。边缘与云上智能算法版本同步升级、按需收费。 基于鲲鹏系列处理器和昇腾AI芯片，提供高并发低时延的多模态数据分析能力，保证园区场景业务的高效闭环。 面向泛园区场景提供多种智能分析算法，基于深度学习等领先技术，保证人、车辆、事件、行为的高精度感知和处理。 通过视频分析、图像处理和自然语言处理技术，对园区和城市治理中的视频、图片和文本数据进行多模态联合分析，充分挖掘数据潜在关联性。

防护效果 开启Web基础防护功能后，在浏览器中输入模拟SQL注入攻击的测试域名，WAF将拦截了此条攻击。您可以在“安全总览”页面，查看攻击的拦截日志，如图4所示。 图3 SQL攻击拦截 图4 安全统计 在“防护事件”页面，您可查看“昨天”、“今天”、“3天”、7天、“30天”或者自定义时间范围内的防护日志。同时，在攻击事件的“操作”列，单击“详情”，可以查看具体的攻击信息，如图5所示。 图5 防护事件列表

集群纳管相关操作 在“集群纳管”列表，可对纳管进行以下操作。 表1 集群纳管相关操作 任务 操作步骤 查询纳管 在搜索输入框中输入搜索条件，按回车键即可查询。 查看纳管详情 单击纳管名称前的，查看纳管详情。 删除纳管集群 单击操作栏“解除纳管”，可删除纳管。 说明： 当节点均“驱逐”且无作业运行时，方能解除纳管。 编辑纳管集群 单击操作栏“编辑”，可以对纳管进行编辑。 资源管理 单击操作栏的“资源管理”，具体请参考资源管理。 修改标签 单击集群名称前的“”，展开各个节点信息。 在节点的操作栏中，单击“修改标签”，可对节点的标签进行修改。 驱逐节点 单击集群名称前的“”，展开各个节点信息。 在节点的操作栏中，单击“驱逐节点”。 恢复节点 当节点被驱逐后，想要恢复节点时，可以按照以下步骤操作： 单击集群名称前的“”，展开各个节点信息。 在节点的操作栏中，单击“恢复节点”。

Simpro版本升级处理 simpro新版本升级会带来一些Catalogs中内容的改变，需要手动将安装目录中Catalogs的变化文件同步到每个用户的workspace。 # 以用户Octopus02举例（以每个环境的用户为准） # 将Catalogs变更内容同步到Octopus02 rsync -av --ignore-existing /opt/simpro/workspace/Catalogs/ /home/Octopus02/workspace/Catalogs # 将整个目录的权限变更回Octopus02 chown -R Octopus02:Octopus02 /home/Octopus02/workspace/Catalogs 之后使用安装目录的configure.xml覆盖每个用户workspace的configure.xml。 父主题： 在线仿真配置

镜像版本相关操作 在“镜像版本”列表，还可以完成以下操作。 表2 镜像版本相关操作 任务 操作步骤 推送镜像 单击指定镜像版本“操作”栏内的“推送”。 复制登录指令，登录镜像仓库。 在docker客户端，用“docker tag”命令将要推送上库的本地镜像打标签为推送指令“docker push”后的镜像名称。例如： docker tag 本地镜像 odrp-beta.Octopus.ias.huawei.com/Octopus/11ffec1e 在docker客户端，复制推送指令，将镜像推送至Octopus平台。 拉取镜像 支持将平台的镜像拉取至本地进行调试开发。 单击指定镜像版本“操作”栏内的“拉取”。 复制拉取指令，将镜像拉取至本地。 删除镜像版本 单击镜像版本操作栏内的“删除”，可删除镜像版本。

在线仿真系统配置 新增用户组。 sudo groupadd user-creators sudo groupadd change-vt sudo groupadd user-switch sudo groupadd x11vnc-owner sudo groupadd change-owner sudo groupadd find-files sudo groupadd LimitedAdmins sudo groupadd netstat-watcher 将Octopus添加到组。 sudo usermod -aG user-creators Octopus sudo usermod -aG change-vt Octopus sudo usermod -aG user-switch Octopus sudo usermod -aG x11vnc-owner Octopus sudo usermod -aG change-owner Octopus sudo usermod -aG find-files Octopus sudo usermod -aG LimitedAdmins Octopus sudo usermod -aG netstat-watcher Octopus 修改sudoers文件。 nano /etc/sudoers # 将内容加到ALL=(ALL:ALL) ALL下面 # 添加前最好查询下每个命令的位置，例如 whereis chvt,将命令的地址修改为对应环境的地址 ########## # Allow members of group sudo to execute any command %sudo ALL=(ALL:ALL) ALL ########## %user-creators ALL=(ALL) NOPASSWD: /usr/sbin/useradd %change-vt ALL=(ALL) NOPASSWD: /bin/chvt %user-switch ALL=(ALL) NOPASSWD: /bin/su %x11vnc-owner ALL=(ALL) NOPASSWD: /usr/bin/x11vnc %change-owner ALL=(ALL) NOPASSWD: /usr/bin/chown %find-files ALL=(ALL) NOPASSWD: /usr/bin/find %LimitedAdmins ALL=(ALL) NOPASSWD: /bin/systemctl %netstat-watcher ALL=(ALL) NOPASSWD: /usr/bin/netstat 如果之前服务器上配置了supervisor，需要停止。 systemctl stop supervisor systemctl disable supervisor 只允许特定用户Octopus使用su命令。 sudo groupadd su-users sudo groupadd su sudo usermod -aG su-users Octopus sudo dpkg-statoverride --update --add root su 4750 /bin/su sudo chgrp su-users /bin/su 父主题： 在线仿真配置

购买服务 登录Octopus服务平台，在左侧菜单栏中单击“总览”。 单击购买服务入口。 图4 购买入口 选择需要购买的基本服务，购买时长、购买个数以及是否自动续费。 若已购买的服务，会在服务后打上“已购买”的标签，并不支持到期前的重复购买。 图5 基本服务 单击“下一步”，选择扩容包、通用处理节点。 图6 扩容包、通用处理节点 购买扩容包和节点时，需要事前购买相对应的服务。 单击“下一步”，确认配置。 图7 确认配置 确认无误后，单击“去支付”，界面生成支付订单，可根据自身情况选择支付方式，确认付款。

Dockerfile 通常情况下Dockerfile无需变动，如赛目提供的环境准备脚本env_prepare_for_ubuntu18.04.sh有更新，则需要更新Dockerfile对应的内容。以1.9.5为例： FROM ubuntu:18.04 RUN apt-get update \ && apt-get install -y --no-install-recommends \ python3-dev \ libboost-system1.65.1 \ libboost-filesystem1.65.1 \ libgconf-2-4 \ libxss1 \ libcoin80v5 \ libpcap0.8 \ vlc \ sudo \ && rm -rf /var/apt/cache/* EXPOSE 10101 ENV PATH /opt/simpro/simulator/bin:${PATH} ENV LD_LIBRARY_PATH /opt/simpro/simulator/lib:/opt/simpro/simulator/thirdLib:/opt/simpro/PythonEval/bin WORKDIR /tmp/ COPY SimProInstall.deb ./ RUN useradd -m simpro -u 1000 -s /bin/bash RUN dpkg -i SimProInstall.deb \ && rm -rf /tmp/* \ && useradd -m Octopus -u 1099 -c 'Octopus User' -s /bin/bash \ && chown Octopus:Octopus -R /opt/ WORKDIR /opt/simpro/workspace COPY configure.xml ./ RUN chown Octopus:Octopus configure.xml

构建官方VTD基础镜像 对2021.1进行纯净安装，参考vtd安装文档。 进入 Runtime/Tools/Docker/vtd.run.control/，使用vtd的 CreateDockerPackage.sh 脚本分离必要的VTD文件，执行: sudo apt update sudo apt-get install rsync mkdir build ./CreateDockerPackage.sh build cd build/vtd.run.control 目录下有以下文件： buildDocker.sh Dockerfile opt/ runDocker.sh vtd.run.control.tgz 根据需求修改 buildDocker.sh ，比如修改apt源，ubunut基础镜像等，添加代理等，如果网络可达，可以不用改。 执行镜像构建脚本： ./buildDocker.sh 构建完成之后，会生成如下形式的镜像： vtd.run.control:latest 根据需要修改镜像tag，建议与vtd版本相关，如： docker tag vtd.run.control:latest vtd.run.control:2021.1.0.0 父主题： VTD镜像制作

Scalar Units speed units。 SPEED_UNIT = { "meter_per_second": 1.0, "mps": 1.0, "kilometer_per_hour": 0.277777778, "kmph": 0.277777778, "kph": 0.277777778, "mile_per_hour": 0.447038889, "mph": 0.447038889, "miph": 0.447038889, "mmph": 0.000000278, "millimeter_per_hour": 0.000000278 } acceleration units。 ACCELERATION_UNIT = { "meter_per_sec_sqr": 1.0, "mpsps": 1.0, "mpss": 1.0, "kilometer_per_hour_per_sec": 0.5270462769, "kmphps": 0.5270462769, "mile_per_hour_per_sec": 0.6686096686, "miphps": 0.6686096686 } length units。 LENGTH_UNIT = { "nanometer": 0.000000001, "nm": 0.000000001, "micrometer": 0.000001, "millimeter": 0.001, "mm": 0.001, "centimeter": 0.01, "cm": 0.01, "meter": 1.0, "m": 1.0, "kilometer": 1000.0, "km": 1000.0, "inch": 0.0254, "feet": 0.3048, "mile": 1609.344, "mi": 1609.344 } time units。 TIME_UNIT = { "millisecond": 0.001, "ms": 0.001, "second": 1.0, "sec": 1.0, "s": 1.0, "minute": 60.0, "min": 60.0, "hour": 3600.0, "h": 3600.0 } angle units。 ANGLE_UNIT = { "degree": 57.295779513, "deg": 57.295779513, "radian": 1.0, "rad": 1.0 } 父主题： 附录 Appendix

产品优势 一站式 开箱即用，全托管的自动驾驶云服务，用户无需从零搭建一套复杂的自动驾驶大数据平台、AI平台、仿真平台、标注平台等多个工具平台，只需聚焦于核心价值（自动驾驶算法、标注数据、仿真场景），快速开展自动驾驶业务，跟上瞬息多变的市场节奏。 海量数据 平台可支持PB级数据存储和亿级数据秒级检索。 软硬件加速 感知算法训练和仿真需要使用大量GPU资源，Octopus依托华为自研软硬件能力提供的强大算力支持，满足每天百万公里仿真测试和算法训练。 自动化标注 自动驾驶算法的持续提升依托于持续增加的高质量标注数据集，平台提供预标注范例模型，能对常用的物体如乘用车、大巴车、行人、骑行人、交通灯、可行驶区域等进行预标注，同时通过难例挖掘持续提升标注数据集质量。 仿真场景库 提供场景库管理和分布式运行能力，覆盖大部分驾驶路况，提升自动驾驶安全性。 并行仿真 实车测试成本高，危险系数高，提供并行仿真能力，能够利用云端资源快速回归仿真场景，提供上千个并行仿真节点，完成日行百万公里虚拟里程。 车云无缝对接 支持无缝对接自动驾驶车辆上的移动数据中心（Mobile Data Center，简称MDC）等车端硬件平台，实现车云协同。

AB类log函数评分方案 在该评分方案中，A类指标必须通过，如果该类指标有一项没有通过，则得分直接不及格（低于60分）。 在有A类指标参与评测时，B类指标即使有几项没有通过，整个得分也不会不及格。 B类指标不通过数超过一定比列时，对应的分数要小于80分。 在有A类指标参与评测时，B类指标即使有几项没有通过，整个得分也不会不及格。 C类指标不参与评分。 在没有A类指标参与评测时，B类指标评分权重更大，这样只要有几项B类指标不通过，则对应的评分会小于60分。 AB类log函数评分原则（Principle） AB类log函数评测分数计算实现（Equation） 父主题： 评测分数计算介绍

批量上传场景 平台支持通过上传脚本的形式对场景进行批量上传，具体操作步骤如下： 在获得上传脚本时，Gitee上的代码分支需要选择2.0.001-S000T分支。 批量上传脚本获取地址如下： https://gitee.com/huawei-octopus/scenario-upload-demo/blob/2.0.001-S000T/src/main.py 根据下表设置环境变量： 参数名 数据类型 说明 OSSM_ENDPOINT String 场景管理服务的endpoint PROJECT_ID String 项目ID VIAM String 获取token的VIAM的endpoint VERIFY_SSL Bool 是否开启ssl验证 MAX_TASK_SIZE Int 最大并发数 使用ak，sk生成API调用所需要的凭据，执行命令如下： python main.py login -ak xxx -sk xxx ak = System.getenv("HUAWEICLOUD_SDK_AK");sk = System.getenv("HUAWEICLOUD_SDK_SK"); #认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全； #本示例以ak和sk保存在环境变量中来实现身份验证为例，运行本示例前请先在本地环境中设置环境变量HUAWEICLOUD_SDK_AK和HUAWEICLOUD_SDK_SK。 # 如果进行了加密还需要进行解密操作。 请准备好批量场景（文件夹层级最多支持5层），文件夹结构举例如下： 执行批量上传命令： （需根据需要填入正确版本，默认为vtd） python main.py upload --path /tmp --version vtd --root xxx --simulator 参数名 数据类型 是否必选 说明 path String 是 要上传的批量场景文件夹地址 version String 否 场景版本，默认vtd 等待上述脚本执行完成，批量上传任务完成。 父主题： 应用示例

仿真服务分类 表1 仿真服务权限 分类 权限 对应API接口 授权项（Action） IAM项目 (Project) 企业项目 (Enterprise Project) 场景地图 创建地图场景 POST /v2/{project_id}/sim/sm/maps octopus:simScenario:create √ √ 修改场景地图文件 PATCH /v2/{project_id}/sim/sm/maps/{parent_lookup_id}/files/{sha256} octopus:simScenario:update √ √ 仿真场景 场景列表 GET /v2/{project_id}/sim/sm/scenarios octopus:simScenario:list √ √ 创建仿真场景 POST /v2/{project_id}/sim/sm/scenarios octopus:simScenario:create √ √ 创建场景文件 POST /v2/{project_id}/sim/sm/scenarios/{parent_lookup_id}/files octopus:simScenario:create √ √ 修改场景文件 PATCH /v2/{project_id}/sim/sm/scenarios/{parent_lookup_id}/files/{sha256} octopus:simScenario:update √ √ 父主题： 权限和授权项

调用API获取项目ID 项目ID可以通过调用查询指定条件下的项目列表API获取。 获取项目ID的接口为“GET https://{Endpoint}/v3/projects”，其中{Endpoint}为IAM的终端节点，可以从地区和终端节点获取。 接口的认证鉴权请参见认证鉴权。 响应示例如下，其中projects下的“id”即为项目ID。 { { "projects": [ { "domain_id": "65382450e8f64ac0870cd180d14e684b", "is_domain": false, "parent_id": "65382450e8f64ac0870cd180d14e684b", "name": "project_name", "description": "", "links": { "next": null, "previous": null, "self": "https://www.example.com/v3/projects/a4a5d4098fb4474fa22cd05f897d6b99" }, "id": "a4a5d4098fb4474fa22cd05f897d6b99", "enabled": true } ], "links": { "next": null, "previous": null, "self": "https://www.example.com/v3/projects" } }

响应示例 状态码： 200 请求成功 { "url" : "/v2/my_project_id/sim/sm/files/8717ae1874a4b063267211bb575373b7eb73aaa99d6ed531352fff3776dc3a60/", "sha256" : "8717ae1874a4b063267211bb575373b7eb73aaa99d6ed531352fff3776dc3a60", "created_at" : 1.699954027363056E9, "updated_at" : 1.699954028718363E9, "post" : null, "put_url" : null, "get_url" : "my-get-url", "path" : "my-path", "bucket" : "my-bucket", "filename" : "ALKS_Road_straight.xodr", "ready" : true }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 url String 文件资源地址。 sha256 String 文件sha256值。 created_at Double 创建时间。 最小值：0 updated_at Double 更新时间。 最小值：0 post post object POST预签链接信息，用于上传文件。 put_url String PUT预签链接地址，用于上传文件。优先使用POST方法上传。 get_url String GET地址，用于下载文件。 expire Integer 默认失效时间为600秒。 缺省值：600 path String 文件在OBS桶中的路径。 bucket String 文件所在OBS桶。 filename String 文件名。 最大长度：255 ready Boolean 文件状态。完成文件上传状态为true，未完成文件上传状态为false。 表4 post 参数 参数类型 描述 url String POST预签链接信息，用于上传文件。 fields PostResponseField object POST预签链接信息，调用POST预签链接上传文件时用于构造请求。 表5 PostResponseField 参数 参数类型 描述 key String Post预签链接Key字段，在创建请求时需要添加到请求头。 x-amz-algorithm String Post预签链接x-amz-algorithm字段，在创建请求时需要添加到请求头。 x-amz-credential String Post预签链接x-amz-credential字段，在创建请求时需要添加到请求头。 x-amz-date String Post预签链接x-amz-date字段，在创建请求时需要添加到请求头。 policy String Post预签链接policy字段，在创建请求时需要添加到请求头。 x-amz-signature String Post预签链接x-amz-signature字段，在创建请求时需要添加到请求头。

请求示例 创建仿真场景 POST https://{endpoint}/v2/{project_id}/sim/sm/scenarios/ { "name" : "my-scenario", "simulator" : "my-simulator", "priority" : 40, "description" : { "content" : "scenario description" }, "version" : "v1.1.1", "map" : "/v2/my_projectid/sim/sm/maps/2631662/", "map_filename" : "ALKS_Road_straight.xodr" }

响应示例 状态码： 201 请求成功 { "url" : "/v2/my_project_id/sim/sm/scenarios/361/", "id" : 361, "created_at" : 1.699954029362022E9, "updated_at" : 1.699954029362044E9, "labels" : [ ], "gen_scenario" : null, "road_scenario" : null, "description" : { "content" : "scenario description" }, "file" : null, "simulator" : "my-simulator", "version" : "v1.1.1", "map_filename" : "ALKS_Road_straight.xodr", "model_filename" : null, "user_id" : "userId", "user_name" : "userName", "name" : "my-scenario", "priority" : 40, "map" : "/v2/my_project_id/sim/sm/maps/2631662/", "model" : null }

响应参数 状态码： 201 表5 响应Body参数 参数 参数类型 描述 url String 仿真场景的资源地址。 id Integer 仿真场景ID。 created_at Double 创建时间。 最小值：0 updated_at Double 更新时间。 最小值：0 labels Array of LabelBriefSrlz objects 场景所关联的标签。场景标签体系为树状结构，按照OpenLABEL标准进行设计。 gen_scenario String 泛化场景资源地址。通过该字段判断仿真场景是否由泛化场景导入，并关联到导入的泛化场景。 road_scenario String 路采场景资源地址。通过该字段判断仿真场景是否由路采场景导入，并关联到导入的路采场景。 description MutableFileSrlz object 描述的内容。 file file object 仿真场景文件，场景文件为OpenSCENARIO格式。 simulator String 仿真器，支持VTD和SimPro。 枚举值： VTD SimPro version String 场景对应的OpenSCENARIO版本。 枚举值： vtd v0.9.1 v1.0.0 v1.1.0 v1.1.1 map_filename String 地图文件名称，地图文件为OpenDRIVE格式。 最大长度：255 model_filename String 地图文件所关联的3D模型文件名称，当前支持OSGB格式。 最大长度：255 user_id String 用户id。 最大长度：64 user_name String 用户名。 最大长度：64 name String 场景名称。 最大长度：256 priority priority object 场景仿真优先级。在运行仿真任务时会优先运行高优先级的场景。 最小值：-2147483648 最大值：2147483647 map String 场景地图资源地址。 model String 场景3D模型资源地址。 表6 LabelBriefSrlz 参数 参数类型 描述 name String 场景标签名称。 最大长度：64 url String 场景标签资源地址。 id Integer 场景标签ID。 family family object 场景标签类别。 最小值：-32768 最大值：32767 root Long 场景标签所在标签树的根标签ID。 最小值：-9223372036854775808 最大值：9223372036854775807 tag_type String 场景标签所属标签树名称。 最大长度：64 parent_names Array of objects 父标签名称。 表7 MutableFileSrlz 参数 参数类型 描述 content String 描述的内容。 最大长度：16777216 表8 file 参数 参数类型 描述 url String 文件资源地址。 sha256 String 文件sha256值。 最小长度：64 最大长度：64 created_at Double 创建时间。 最小值：0 updated_at Double 更新时间。 最小值：0 post post object POST预签链接信息，用于上传文件。 put_url String PUT预签链接地址，用于上传文件。优先使用POST方法上传。 get_url String GET地址，用于下载文件。 expire Integer 默认失效时间为600秒。 缺省值：600 ready Boolean 文件状态。完成文件上传状态为true，未完成文件上传状态为false。 filename String 文件名。 最大长度：255 表9 post 参数 参数类型 描述 url String POST预签链接信息，用于上传文件。 fields PostResponseField object POST预签链接信息，调用POST预签链接上传文件时用于构造请求。 表10 PostResponseField 参数 参数类型 描述 key String Post预签链接Key字段，在创建请求时需要添加到请求头。 x-amz-algorithm String Post预签链接x-amz-algorithm字段，在创建请求时需要添加到请求头。 x-amz-credential String Post预签链接x-amz-credential字段，在创建请求时需要添加到请求头。 x-amz-date String Post预签链接x-amz-date字段，在创建请求时需要添加到请求头。 policy String Post预签链接policy字段，在创建请求时需要添加到请求头。 x-amz-signature String Post预签链接x-amz-signature字段，在创建请求时需要添加到请求头。

请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 gen_scenario 否 String 泛化场景资源地址。通过该字段判断仿真场景是否由泛化场景导入，并关联到导入的泛化场景。 description 是 MutableFileSrlz object 描述的内容。 file 否 file object 仿真场景文件，场景文件为OpenSCENARIO格式。 simulator 是 String 仿真器，支持VTD和SimPro。 枚举值： VTD SimPro version 是 String 场景对应的OpenSCENARIO版本。 枚举值： vtd v0.9.1 v1.0.0 v1.1.0 v1.1.1 map_filename 否 String 地图文件名称，地图文件为OpenDRIVE格式。 最大长度：255 model_filename 否 String 地图文件所关联的3D模型文件名称，当前支持OSGB格式。 最大长度：255 user_id 否 String 用户id。 最大长度：64 user_name 否 String 用户名。 最大长度：64 name 是 String 场景名称。 最大长度：256 priority 否 priority object 场景仿真优先级。在运行仿真任务时会优先运行高优先级的场景。 最小值：-2147483648 最大值：2147483647 map 否 String 场景地图资源地址。 model 否 String 场景3D模型资源地址。 表3 MutableFileSrlz 参数 是否必选 参数类型 描述 content 是 String 描述的内容。 最大长度：16777216 表4 file 参数 是否必选 参数类型 描述 sha256 是 String 文件sha256值。 最小长度：64 最大长度：64 filename 是 String 文件名。 最大长度：255

响应示例 状态码： 200 请求成功 { "count" : 347, "next" : "http://{endpoint}/v2/{project_id}/sim/sm/scenarios/?limit=1&offset=1", "previous" : null, "results" : [ { "url" : "/v2/{project_id}/sim/sm/scenarios/1/", "id" : 1, "created_at" : 1.70071476428303E9, "updated_at" : 1.700714764892153E9, "labels" : [ ], "gen_scenario" : null, "road_scenario" : null, "simulator" : "MySimulator", "version" : "v1.0.0", "filename" : "cutin.xosc", "map_filename" : "city.xodr", "model_filename" : null, "user_id" : "my-userid", "user_name" : "my-username", "name" : "cutin", "priority" : 40, "status" : 0, "map" : "/v2/{project_id}/sim/sm/maps/1/", "model" : null } ] }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 count Integer 列表中实例的数量。 next String 下一个分页的查询地址。 previous String 上一个分页的查询地址。 results Array of ScenarioListSrlz objects 仿真场景列表。 表4 ScenarioListSrlz 参数 参数类型 描述 url String 仿真场景的资源地址。 id Integer 仿真场景ID。 created_at Double 创建时间。 最小值：0 updated_at Double 更新时间。 最小值：0 labels Array of LabelBriefSrlz objects 场景标签。场景标签体系为树状结构，按照OpenLABEL标准进行设计。 gen_scenario String 泛化场景资源地址。通过该字段判断仿真场景是否由泛化场景导入，并关联到导入的泛化场景。 road_scenario String 路采场景资源地址。通过该字段判断仿真场景是否由路采场景导入，并关联到导入的路采场景。 simulator String 仿真器，支持VTD和SimPro。 枚举值： VTD SimPro version String 场景对应的OpenSCENARIO版本。 枚举值： vtd v0.9.1 v1.0.0 v1.1.0 v1.1.1 filename String 场景文件名，场景文件为OpenSCENARIO格式。 最大长度：255 map_filename String 地图文件名称，地图文件为OpenDRIVE格式。 最大长度：255 model_filename String 地图文件所关联的3D模型文件名称，当前支持OSGB格式。 最大长度：255 user_id String 用户ID。 最大长度：64 user_name String 用户名。 最大长度：64 name String 场景名称。 最大长度：256 priority priority object 最小值：-2147483648 最大值：2147483647 status status object 最小值：-2147483648 最大值：2147483647 map String 场景地图资源地址。 model String 场景3D模型资源地址。 表5 LabelBriefSrlz 参数 参数类型 描述 name String 场景标签名称。 最大长度：64 url String 场景标签资源地址。 id Integer 场景标签ID。 family family object 场景标签类别。 最小值：-32768 最大值：32767 root Long 场景标签所在标签树的根标签ID。 最小值：-9223372036854775808 最大值：9223372036854775807 tag_type String 场景标签所属标签树名称。 最大长度：64 parent_names Array of objects 父标签名称。

URI GET /v2/{project_id}/sim/sm/scenarios 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 exclude_group 否 Integer 查询时不包括的场景组。 file 否 String 场景文件。 gen_scenario 否 String 泛化场景的资源地址。 group 否 Array 场景组ID。 id 否 Integer 场景ID。 label 否 Number 标签ID。 map 否 Integer 地图ID。 name 否 String 场景名称。 ordering 否 String 用于排序的字段，查询结果会基于该字段排序。 offset 否 Integer 分页查询的偏移。 limit 否 Integer 分页查询时查询结果数量。 search 否 String 查询条件。 simulator 否 String 仿真器，支持VTD和SimPro。 枚举值： SimPro VTD source 否 String 场景来源，可选项包括：generalization，road， upload，分别表示泛化场景，路采场景和用户自建场景。 status 否 Integer 0 - Released 1 - Available 10 - Initial 11 - Unavailable 12 - Releasing 100 - Deprecated 枚举值： 0 1 10 100 11 12 user_name 否 String 用户名 version 否 String vtd - vtd v0.9.1 - v0.9.1 v1.0.0 - v1.0.0 v1.1.0 - v1.1.0 v1.1.1 - v1.1.1 枚举值： v0.9.1 v1.0.0 v1.1.0 v1.1.1 vtd

AK/SK认证 AK/SK签名认证方式仅支持消息体大小12M以内，12M以上的请求请使用Token认证。 AK/SK认证就是使用AK/SK对请求进行签名，在请求时将签名信息添加到消息头，从而通过身份认证。 AK（Access Key ID）：访问密钥ID。与私有访问密钥关联的唯一标识符；访问密钥ID和私有访问密钥一起使用，对请求进行加密签名。 SK（Secret Access Key）：与访问密钥ID结合使用的密钥，对请求进行加密签名，可标识发送方，并防止请求被修改。 使用AK/SK认证时，您可以基于签名算法使用AK/SK对请求进行签名，也可以使用专门的签名SDK对请求进行签名。详细的签名方法和SDK使用方法请参见API签名指南。 签名SDK只提供签名功能，与服务提供的SDK不同，使用时请注意。

Token认证 Token的有效期为24小时，需要使用一个Token鉴权时，可以先缓存起来，避免频繁调用。 Token在计算机系统中代表令牌（临时）的意思，拥有Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限。 Token可通过调用获取用户Token接口获取，调用本服务API需要project级别的Token，即调用接口时，请求body中auth.scope的取值需要选择project，如下所示。 { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username", //IAM用户名 "password": "user_password", //IAM用户密码 "domain": { "name": "domainname" //IAM用户所属帐号名 } } } }, "scope": { "project": { "name": "*******" //项目名称 } } } } 获取Token后，再调用其他接口时，您需要在请求消息头中添加“X-Auth-Token”，其值即为Token。例如Token值为“ABCDEFJ....”，则调用接口时将“X-Auth-Token: ABCDEFJ....”加到请求消息头即可，如下所示。 GET https://iam.ap-southeast-1.myhuaweicloud.com/v3/auth/projects Content-Type: application/json X-Auth-Token: ABCDEFJ.... 您还可以通过这个视频教程了解如何使用Token认证：https://bbs.huaweicloud.com/videos/101333 。

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 url String 文件资源地址。 sha256 String 文件sha256值。 created_at Double 创建时间。 最小值：0 updated_at Double 更新时间。 最小值：0 post post object POST预签链接信息，用于上传文件。 put_url String PUT预签链接地址，用于上传文件。优先使用POST方法上传。 get_url String GET地址，用于下载文件。 expire Integer 默认失效时间为600秒。 缺省值：600 path String 文件在OBS桶中的路径。 bucket String 文件所在OBS桶。 filename String 文件名。 最大长度：255 ready Boolean 文件状态。完成文件上传状态为true，未完成文件上传状态为false。 表4 post 参数 参数类型 描述 url String POST预签链接信息，用于上传文件。 fields PostResponseField object POST预签链接信息，调用POST预签链接上传文件时用于构造请求。 表5 PostResponseField 参数 参数类型 描述 key String Post预签链接Key字段，在创建请求时需要添加到请求头。 x-amz-algorithm String Post预签链接x-amz-algorithm字段，在创建请求时需要添加到请求头。 x-amz-credential String Post预签链接x-amz-credential字段，在创建请求时需要添加到请求头。 x-amz-date String Post预签链接x-amz-date字段，在创建请求时需要添加到请求头。 policy String Post预签链接policy字段，在创建请求时需要添加到请求头。 x-amz-signature String Post预签链接x-amz-signature字段，在创建请求时需要添加到请求头。

响应示例 状态码： 200 请求成功 { "url" : "/v2/my_project_id/sim/sm/files/0fb50a138fb132be3c794eb423375cca3263fe35a33063c06a4821819ab7fc85/", "sha256" : "0fb50a138fb132be3c794eb423375cca3263fe35a33063c06a4821819ab7fc85", "created_at" : 1.699954029767271E9, "updated_at" : 1.699954030498088E9, "post" : null, "put_url" : null, "get_url" : "my-get-url", "path" : "my-path", "bucket" : ",my-bucket", "filename" : "ALKS_Scenario_4.1_1_FreeDriving_TEMPLATE.xosc", "ready" : true }

响应参数 状态码： 201 表4 响应Body参数 参数 参数类型 描述 url String 地图资源地址。 id Integer 地图ID。 created_at Double 创建时间。 最小值：0 updated_at Double 更新时间。 最小值：0 file FileCreateSrlz object 地图文件信息。 version String 地图文件的OpenDRIVE版本。 枚举值： v1.4.0 v1.5.0 v1.6.0 v1.6.1 v1.7.0 表5 FileCreateSrlz 参数 参数类型 描述 url String 文件资源地址。 sha256 String 文件sha256值。 最小长度：64 最大长度：64 created_at Double 创建时间。 最小值：0 updated_at Double 更新时间。 最小值：0 post post object POST预签链接信息，用于上传文件。 put_url String PUT预签链接地址，用于上传文件。优先使用POST方法上传。 get_url String GET地址，用于下载文件。 expire Integer 默认失效时间为600秒。 缺省值：600 ready Boolean 文件状态。完成文件上传状态为true，未完成文件上传状态为false。 filename String 文件名。 最大长度：255 表6 post 参数 参数类型 描述 url String POST预签链接信息，用于上传文件。 fields PostResponseField object POST预签链接信息，调用POST预签链接上传文件时用于构造请求。 表7 PostResponseField 参数 参数类型 描述 key String Post预签链接Key字段，在创建请求时需要添加到请求头。 x-amz-algorithm String Post预签链接x-amz-algorithm字段，在创建请求时需要添加到请求头。 x-amz-credential String Post预签链接x-amz-credential字段，在创建请求时需要添加到请求头。 x-amz-date String Post预签链接x-amz-date字段，在创建请求时需要添加到请求头。 policy String Post预签链接policy字段，在创建请求时需要添加到请求头。 x-amz-signature String Post预签链接x-amz-signature字段，在创建请求时需要添加到请求头。

请求示例 创建场景地图 POST https://{endpoint}/v2/{project_id}/sim/sm/maps/ { "version" : "v1.6.0", "file" : { "sha256" : "8717ae1874a4b063267211bb575373b7eb73aaa99d6ed531352fff3776dc3a60", "filename" : "ALKS_Road_straight.xodr" } }