华为云用户手册

什么是安全容器？ 安全容器这个概念主要与普通容器进行比较的。 和普通容器相比，它最主要的区别是每个容器（准确地说是pod）都运行在一个单独的微型虚拟机中，拥有独立的操作系统内核，以及虚拟化层的安全隔离。因为云容器实例采用的是共享多租集群，因此容器的安全隔离比用户独立拥有私有Kubernetes集群有更严格的要求。通过安全容器，不同租户之间的容器之间，内核、计算资源、存储和网络都是隔离开的。保护了用户的资源和数据不被其他用户抢占和窃取。 父主题： 基本概念类

如何从容器访问公网？ 您可以使用公有云平台提供的NAT网关服务。该服务能够为虚拟私有云内的容器提供 网络地址转换 （Network Address Translation）服务，使虚拟私有云内的容器可以共享使用弹性公网IP访问Internet。通过NAT网关的SNAT功能，可以直接访问Internet，提供超大并发数的连接服务，适用于请求量大、连接数多的服务。详细信息请参见从容器中访问公网。 父主题： 网络管理类

镜像、容器、工作负载的关系是什么？ 镜像：容器镜像是一个特殊的文件系统，除了提供容器运行时所需的程序、库、资源、配置等文件外，还包含了一些为运行时准备的配置参数（如匿名卷、环境变量、用户等）。镜像不包含任何动态数据，其内容在构建之后也不会被改变。 容器：镜像（Image）和容器（Container）的关系，就像是面向对象程序设计中的类和实例一样，镜像是静态的定义，容器是镜像运行时的实体。容器可以被创建、启动、停止、删除、暂停等。 工作负载：工作负载是在 Kubernetes 上运行的应用程序。一个工作负载由一个或多个实例（Pod）组成，一个实例由一个或多个容器组成，每个容器都对应一个容器镜像。 镜像、容器、工作负载之间的关系请参见下图。 图1 镜像、容器、工作负载的关系 父主题： 基本概念类

什么是云容器实例？ 云容器实例（Cloud Container Instance，CCI）服务提供 Serverless Container（无服务器容器）引擎，让您无需创建和管理服务器集群即可直接运行容器。 Serverless 是一种架构理念，是指不用创建和管理服务器、不用担心服务器的运行状态（服务器是否在工作等），只需动态申请应用需要的资源，把服务器留给专门的维护人员管理和维护，进而专注于应用开发，提升应用开发效率、节约企业IT成本。传统上使用 Kubernetes 运行容器，首先需要创建运行容器的 Kubernetes 服务器集群，然后再创建容器负载。云容器实例的 Serverless Container 就是从使用角度，无需创建、管理 Kubernetes 集群，也就是从使用的角度看不见服务器（Serverless），直接通过控制台、kubectl、Kubernetes API 创建和使用容器负载，且只需为容器所使用的资源付费。 云容器实例有如下功能： 自动化持续交付 一键运行DevOps的CI流程生成的容器镜像，保障CI/CD流程全自动化。 应用运行时全托管 提供无状态工作负载的运行时托管，保障应用稳定运行。 极速弹性扩缩容 支持用户自定义弹性伸缩策略，且能在1秒内实现弹性扩缩容。 应用高可用保障 支持多实例同时对外提供服务，保障用户业务高可靠，并提供全局负载均衡能力。 应用容器状态监控 提供容器健康状态检查和容器的运行时指标实时监控。 数据持久化存储 支持挂载网络存储卷，保障业务数据持久化存储。 父主题： 基本概念类

SDK列表 表1提供了LTS服务支持的SDK列表，您可以在GitHub仓库查看SDK更新历史、获取安装包以及查看指导文档。 其中Java和Go语言的SDK，请在GitHub仓库里/services/lts/目录下查看。 表1 SDK列表 编程语言 Github地址 参考文档 Java huaweicloud-sdk-java-v3 Java SDK使用指导 Python huaweicloud-sdk-python-v3 Python SDK使用指导 Go huaweicloud-sdk-go-v3 Go SDK使用指导 Node.js huaweicloud-sdk-nodejs-v3 Node.js SDK使用指导 .NET huaweicloud-sdk-net-v3 .NET SDK使用指导 PHP huaweicloud-sdk-php-v3 PHP SDK使用指导 C++ huaweicloud-sdk-cpp-v3 C++ SDK使用指导

CS E权限 默认情况下，新建的 IAM 用户没有任何权限，您需要将其加入用户组，并给用户组授予策略，才能使得用户组中的用户获得策略定义的权限，这一过程称为授权。授权后，用户就可以基于策略对云服务进行操作。 CSE资源通过物理区域划分，为项目级服务。授权时，“作用范围”需要选择“区域级项目”，然后在指定区域对应的项目中设置相关权限，并且该权限仅对此项目生效；如果在“所有项目”中设置权限，则该权限在所有区域项目中都生效。访问CSE时，需要先切换至授权区域。 根据授权精细程度分为角色和策略。 角色：IAM最初提供的一种根据用户的工作职能定义权限的粗粒度授权机制。该机制以服务为粒度，提供有限的服务相关角色用于授权。由于华为云各服务之间存在业务依赖关系，因此给用户授予角色时，可能需要一并授予依赖的其他角色，才能正确完成业务。角色并不能满足用户对精细化授权的要求，无法完全达到企业对权限最小化的安全管控要求。 策略：IAM最新提供的一种细粒度授权的能力，可以精确到具体服务的操作、资源以及请求条件等。基于策略的授权是一种更加灵活的授权方式，能够满足企业对权限最小化的安全管控要求。 如表1所示，包括了CSE的所有系统权限。 表1 CSE系统权限说明 系统角色/策略名称 描述 类别 依赖关系 CSE FullAccess 微服务引擎服务管理员权限。 系统策略 无 CSE ReadOnlyAccess 微服务引擎服务查看权限。 系统策略 无 如果表1所列权限不满足实际需求，可以在这个基础上创建微服务引擎自定义策略。 更多CSE相关功能需要依赖的服务权限，请参见表2所示。 表2 CSE控制台依赖服务的角色或策略 控制台功能 依赖服务 需配置角色/策略 删除、创建引擎 虚拟私有云 VPC 如果需要创建与删除引擎，需要设置VPC ReadOnlyAccess权限。 创建应用网关、查看应用网关详情 弹性负载均衡 ELB 如果需要创建应用网关及查看应用网关详情，需要设置ELB ReadOnlyAccess权限。 仪表盘 应用运维管理 AOM 如果需要查看仪表盘等图表数据，需要设置AOM ReadOnlyAccess权限。 标签管理 标签管理服务 TMS 如果需要使用TMS为ServiceComb引擎、Nacos引擎或应用网关添加标签，可以方便用户识别和管理拥有的ServiceComb引擎、Nacos引擎或应用网关资源，需要设置TMS ReadOnlyAccess权限。 导入IAM用户 统一身份认证 服务 IAM 如果需要导入IAM用户，需要设置IAM ReadOnlyAccess权限。 表3列出了微服务引擎常用操作与系统权限的授权关系，您可以参照该表选择合适的系统权限。 表3 常用操作与系统权限之间的关系 操作 CSE ReadOnlyAccess CSE FullAccess 创建微服务引擎 x √ 维护微服务引擎 x √ 查询微服务引擎 √ √ 删除微服务引擎 x √ 创建微服务 x √ 查询微服务 √ √ 维护微服务 x √ 删除微服务 x √ 创建微服务配置 x √ 查询微服务配置 √ √ 编辑微服务配置 x √ 删除微服务配置 x √ 创建微服务治理策略 x √ 查询微服务治理策略 √ √ 编辑微服务治理策略 x √ 删除微服务治理策略 x √

为什么应用运维管理AOM中有一条调用链，在 APM 界面上没有显示？ 在企业微服务之间调用复杂的场景下，APM Agent会抽样一些请求，拦截对应请求及后续一系列的调用信息。比如在A调用B然后调用C的场景，请求进入A后，APM系统会采用智能采样算法，决定是否对请求进行调用链跟踪。 AOM应用运维管理有访问的数据才会显示调用链，而且在显示的时候，一般情况下会有几分钟的延时。 如果没有访问或者没有数据，就不会显示调用链。

响应参数 状态码： 200 表9 响应Header参数 参数 参数类型 描述 X-Trace-Id String 参数解释： 追踪请求ID。 取值范围： 不涉及。 表10 响应Body参数 参数 参数类型 描述 utmcode String 参数解释： 地区UTM编码，用于地理空间数据的编码，表示服务区域的特定位置。 取值范围： 不涉及。 isCalibrationSucc Boolean 参数解释： 是否启用在线云标定。 取值范围： false：否 true：是 cacheData String 参数解释： 缓存数据，用于存储会话信息或临时数据。 取值范围： 不涉及。 pose pose object 参数解释： 位姿信息，包含姿态矩阵和位置信息。 取值范围： 不涉及。 requestId String 参数解释： 请求ID，用于标识和追踪特定的服务请求。 取值范围： 不涉及。 couplingTime Integer 参数解释： 根据云端负载建议端侧重定位时间（单位ms）。 取值范围： 不涉及。 vpsMode Integer 参数解释： 建议预检测模式。 取值范围： 0：gvps 1：lod processMode String 参数解释： 云端处理模式。 取值范围： gvps：高精视觉定位。 lodvps：模型视觉定位。 vpsFloor Integer 参数解释： 楼层信息，表示服务所在的楼层编号。 取值范围： 不涉及。 VpsCode Integer 参数解释： 状态码，用于表示服务的状态或结果。 取值范围： 0：成功。 1：无法提供服务。 2：相机位姿错误。 3：低置信度。 4：GPS位置错误。 5：图像错误。 6：语义错误。 -1：内部错误。 retry Integer 参数解释： 限制端侧手动单击的时间间隔（单位ms）。 取值范围： 不涉及。 status String 参数解释： 请求结果是否成功。 取值范围： succeeded：成功 failed：失败 表11 pose 参数 参数类型 描述 r Array of floats 参数解释： VPS姿态矩阵，按照左上到右下排列。 取值范围： 不涉及。 t Array of floats 参数解释： VPS位置，包含X、Y、Z三个浮点数，代表在空间中的位置。 取值范围： 不涉及。 confidence Double 参数解释： VPS结果置信度。 取值范围： 0~1，1表示完全置信。 K Array of floats 参数解释： 在线云标定默认内参，包含相机的焦距和光心坐标。 取值范围： 不涉及。

请求示例 vps请求体示例，image信息xxx需改为图片base64编码。 POST https://{Endpoint}.com/v1/algo/vps { "payload" : { "user" : { "vpsType" : "GVPS", "vpsMode" : "FullMode", "requestType" : 3, "image" : "xxx" }, "camera" : { "fx" : 1120, "fy" : 1120, "cx" : 720, "cy" : 540 }, "slam" : [ { "x" : "3457914.888789408", "y" : "43.618999587185016", "z" : "-366678.1012069998", "qx" : "-0.6027525895972902", "qy" : "0.6696625505117437", "qz" : "-0.31343264698264584", "qw" : "0.30000227171514465", "mode" : "0", "index" : "4" } ], "imu" : [ { "azimuth" : "38.6508926149583", "pitch" : "-3.3327073554530315", "roll" : "85.58219500612942", "qx" : "0.6383440820986672", "qy" : "-0.25189259238432615", "qz" : "-0.21407681135529025", "qw" : "0.6951532824524337", "accuracy" : "0" } ], "gps" : [ { "longitude" : "xxx", "latitude" : "xxx", "accuracy" : "12" } ] } }

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Trace-Id 否 String 参数解释： 追踪请求ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 App-Id 否 String 参数解释： 可选项，场景模板分配的app_id。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 Uuid 是 String 参数解释： 设备或者用户唯一标识。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 X-Auth-Token 否 String 参数解释： IAM Token，和Authorization二选一必传。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 Authorization 否 String 参数解释： AK/SK签名结果，和X-Auth-Token二选一必传。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 表2 请求Body参数 参数 是否必选 参数类型 描述 payload 是 payload object 参数解释： 客户端发送给服务器的数据，包含用户相关信息、相机内参、IMU（惯性测量单元）内参、GPS定位相关信息、SLAM（Simultaneous Localization and Mapping，即同时定位与地图构建）的相关信息。 约束限制： 不涉及。 表3 payload 参数 是否必选 参数类型 描述 user 是 user object 参数解释： 用户相关信息。 约束限制： 不涉及。 camera 是 camera object 参数解释： 相机内参，在计算机视觉和图像处理中，描述相机如何将三维世界映射到二维图像平面的一组参数。 约束限制： 不涉及。 imu 是 Array of imu objects 参数解释： IMU内参。用于测量和报告一个物体的特定力、角速度以及在某些情况下，磁场周围物体的方向的设备。 约束限制： 不涉及。 gps 是 Array of gps objects 参数解释： GPS相关信息，用户确定其地理位置的经纬度。 约束限制： 不涉及。 slam 是 Array of slam objects 参数解释： SLAM即同时定位与建图，是一种让机器人在未知环境中进行自主导航和建图的技术。在SLAM中，机器人使用传感器数据来确定自己在环境中的位置，并同时构建环境的地图。 约束限制： 不涉及。 表4 user 参数 是否必选 参数类型 描述 vpsMode 否 String 参数解释： VPS的运行模式 。 约束限制： 选取特定参数 。 取值范围： Offline：离线模式。 LocalMode：本地模式。 FullMode：全功能模式。 TrackingMode：跟踪模式。 默认取值： 不涉及。 vpsType 否 String 参数解释： VPS的定位方法，目前支持GVPS。 约束限制： 字符串类型选，取特定参数。 取值范围： GVPS：通用 DVPS：数字视频 LODVPS：卫星。 默认取值： 不涉及。 requestType 否 Integer 参数解释： 请求的设备类型 。 约束限制： 选取特定参数 。 取值范围： 0：安卓手机。 1：IOS手机。 2：安卓web端。 3：IOS web端。 4：AR眼镜 。 默认取值： 0。 image 是 String 参数解释： base64编码的图片信息 。 约束限制： 不涉及。 取值范围： 不涉及 。 默认取值： 不涉及。 表5 camera 参数 是否必选 参数类型 描述 fx 是 Float 参数解释： 相机内参，沿着x轴的焦距fx，单位为像素。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 fy 是 Float 参数解释： 相机内参，沿着y轴的焦距fy，单位为像素。 约束限制： 不涉及 。 取值范围： 不涉及。 默认取值： 不涉及。 cx 是 Integer 参数解释： 相机内参，相机光心沿x轴的坐标，单位为像素。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 cy 是 Integer 参数解释： 相机内参，相机光心沿y轴的坐标，单位为像素。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 表6 imu 参数 是否必选 参数类型 描述 accuracy 是 Double 参数解释： 表示IMU测量的误差值，数值越小表示测量结果越准确。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 azimuth 是 Double 参数解释： 方位角，表示物体绕垂直轴的旋转角度。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 roll 是 Double 参数解释： 横滚角，表示物体绕前进轴的旋转角度。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 pitch 是 Double 参数解释： 俯仰角，表示物体绕水平轴的旋转角度。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 qx 是 Double 参数解释： 四元数的x轴方向的虚部分量。它与旋转轴在x轴方向上的投影有关。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 qy 是 Double 参数解释： 四元数的y轴方向的虚部分量。它与旋转轴在y轴方向上的投影有关。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 qz 是 Double 参数解释： 四元数的z轴方向的虚部分量。它与旋转轴在z轴方向上的投影有关。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 qw 是 Double 参数解释： 四元数的实部qw通常与旋转的余弦值相关。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 表7 gps 参数 是否必选 参数类型 描述 longitude 是 Double 参数解释： 经度，正值表示东经，负值表示西经。 约束限制： 不涉及。 取值范围： -180° ~ 180°。 默认取值： 不涉及。 latitude 是 Double 参数解释： 纬度，正值表示北纬，负值表示南纬。 约束限制： 不涉及。 取值范围： -90° ~ 90°。 默认取值： 不涉及。 accuracy 是 Float 参数解释： 误差值，表示位置数据的不确定性半径。数值越小表示GPS测量的精度越高。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 表8 slam 参数 是否必选 参数类型 描述 x 是 Double 参数解释： 位置坐标参数，在三维空间中的前后位置。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 y 是 Double 参数解释： 位置坐标参数，在三维空间中的上下位置。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 z 是 Double 参数解释： 位置坐标参数，在三维空间中的左右位置。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 qx 是 Double 参数解释： 四元数的x轴方向的虚部分量。它与旋转轴在x轴方向上的投影有关。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 qy 是 Double 参数解释： 四元数的y轴方向的虚部分量。它与旋转轴在y轴方向上的投影有关。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 qz 是 Double 参数解释： 四元数的z轴方向的虚部分量。它与旋转轴在z轴方向上的投影有关。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 qw 是 Double 参数解释： 四元数的实部qw通常与旋转的余弦值相关。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。

请求消息头 附加请求头字段，如指定的URI和HTTP方法所要求的字段。例如定义消息体类型的请求头“Content-Type”，请求鉴权信息等。 详细的公共请求消息头字段请参见表3。 表3 公共请求消息头 名称 描述 是否必选 示例 Content-Type 消息体的类型（格式），当前只支持application/json。 是 application/json X-Auth-Token 用户Token。 用户Token也就是调用获取用户Token接口的响应值，该接口是唯一不需要认证的接口。 请求响应成功后在响应消息头（Headers）中包含的“X-Subject-Token”的值即为Token值。 是 使用Token认证时该字段必选。 注：以下仅为Token示例片段 MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

请求消息体（可选） 该部分可选。请求消息体通常以结构化格式（如JSON或XML）发出，与请求消息头中Content-Type对应，传递除请求消息头之外的内容。若请求消息体中的参数支持中文，则中文字符必须为UTF-8编码。 每个接口的请求消息体内容不同，也并不是每个接口都需要有请求消息体（或者说消息体为空），GET、DELETE操作类型的接口就不需要消息体，消息体具体内容需要根据具体接口而定。 对于创建工作共享空间接口，您可以从接口的请求部分看到所需的请求参数及参数说明。将消息体加入后的请求如下所示。 POST https://koomap.cn-north-4.myhuaweicloud.com/v1/workspaces Content-Type: application/json X-Auth-Token：xxxxxxxx { "workspace_name" : "工作共享空间名称", "workspace_description" : "这是描述" } 到这里为止这个请求需要的内容就具备齐全了，您可以使用curl、Postman或直接编写代码等方式发送请求调用API。对于获取用户Token接口，返回的响应消息头中“x-subject-token”就是需要获取的用户Token。有了Token之后，您就可以使用Token认证调用其他API。

请求URI 请求URI由如下部分组成： {URI-scheme}://{Endpoint}/{resource-path}?{query-string} 尽管请求URI包含在请求消息头中，但大多数语言或框架都要求您从请求消息中单独传递它，所以在此单独强调。 表1 URI中的参数说明 参数 描述 URI-scheme 表示用于传输请求的协议，当前KooMap所有API均采用HTTPS协议。 Endpoint 指定承载REST服务端点的服务器 域名 或IP，不同服务不同区域的Endpoint不同，当前KooMap只在“华北-北京四”部署，Endpoint为“koomap.cn-north-4.myhuaweicloud.com”。 resource-path 资源路径，即API访问路径。从具体API的URI模块获取，例如“创建工作共享空间”API的resource-path为“/v1/workspaces”。 query-string 可选参数，用于查询指定参数数据。设置查询参数时，查询参数前面需要带一个“?”，形式为“参数名=参数取值”，例如“?limit=10”，表示查询不超过10条数据。 例如您需要获取KooMap在“华北-北京四”区域的Token，则需使用“华北-北京四”区域的Endpoint（koomap.cn-north-4.myhuaweicloud.com），并在创建工作共享空间的URI部分找到resource-path（/v1/workspaces），拼接起来如下所示。 https://koomap.cn-north-4.myhuaweicloud.com/v1/workspaces 图1 URI示意图 为查看方便，在每个具体API的URI部分，只给出resource-path部分，并将请求方法写在一起。这是因为URI-scheme都是HTTPS，而Endpoint在同一个区域也相同，所以简洁起见将这两部分省略。

请求方法 HTTP请求方法（也称为操作或动词），它告诉服务您正在请求什么类型的操作。 表2 HTTP方法 方法 说明 GET 请求服务器返回指定资源。 POST 请求服务器新增资源或执行non-CRUD操作。 DELETE 请求服务器删除指定资源，如删除对象等。 PUT 请求服务器更新指定资源。 在创建工作共享空间的URI部分，您可以看到其请求方法为“POST”，则其请求为： POST https://koomap.cn-north-4.myhuaweicloud.com/v1/workspaces

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

概述 云地图服务 （KooMap）是使能数字孪生、赋能虚实融合互动的云服务、汇聚地图数据和应用生态，沉淀行业资产，打造开放平台，提供时空处理、分析、可视、虚实交互等一站式开箱即用的时空信息服务，驱动行业转型和创新。 您可以使用本文档提供的API对 云地图 服务进行相关操作，如创建、删除、修改等。支持的全部操作请参见API概览。 在调用KooMap API之前，请确保已经充分了解KooMap相关概念，详细信息请参见云地图服务的《产品介绍》。

基本概念 账号 用户注册时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于账号是付费主体，为了确保账号安全，建议您不要直接使用账号进行日常管理工作，而是创建用户并用来进行日常管理工作。 用户 由账号在IAM中创建的用户，是云服务的使用人员，具有身份凭证（密码和访问密钥）。 在我的凭证下，您可以查看账号ID和IAM用户ID。通常在调用API的鉴权过程中，您需要用到账号、用户和密码等信息。 区域（Region） 从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。Region分为通用Region和专属Region，通用Region指面向公共租户提供通用云服务的Region；专属Region指只承载同一类业务或只面向特定租户提供业务服务的专用Region。 详情请参见区域和可用区。 可用区（AZ，Availability Zone） 一个可用区是一个或多个物理数据中心的集合，有独立的风火水电，AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连，以满足用户跨AZ构建高可用性系统的需求。

API概览 云地图服务接口的分类与说明如表1所示。 表1 API概览 类型 说明 工作共享空间管理 工作共享空间管理接口，包括工作共享空间的新建、查询、修改以及删除接口。 卫星影像任务管理 卫星影像处理任务管理接口，包括任务的新建、查询、查看、启动、停止、归档/取消归档、删除、校验原始影像文件接口。 卫星影像用量统计 查询卫星影像生产服务的时空专属存储用量、任务处理成功后的成果影像存储用量、成功处理的次数。 卫星影像数据管理 根据过滤条件查询卫星影像信息列表。 实景三维任务管理 实景三维生产服务任务管理接口，包括建模任务的创建、更新、查询、启动、停止、归档/取消归档、删除以及展示任务概览信息接口。 实景三维精修后处理任务管理 实景三维精修后处理任务管理接口，包括创建、查询、启动、停止以及删除任务接口。 实景三维用量统计 查询实景三维生产服务的时空专属存储用量、成功建模的倾斜影像的像素点数量、成功建模的次数。 实景三维刺点管理 实景三维生产服务刺点管理接口，包括刺点的新增与删除、刺点信息获取、刺点文件的生成以及查询像控点的已刺点数量接口。 实景三维数据管理 查询/删除实景三维建模成果数据、精修后处理成果数据，查询当前租户的倾斜影像基本信息列表。 视觉定位 通过拍摄一系列具有已知位置的图像并分析它们的关键视觉特征（例如建筑物或桥梁的轮廓）来创建地图，以创建这些视觉特征的大规模且可快速搜索的索引。将设备图像中的特征与索引中的特征进行比较，可获得目标设备的位姿。 AR导航 基于摄像头实时捕捉的实景画面，将地图导航信息通过数字内容的形态叠加在实景画面中，生成虚拟的3D导航指引。

响应消息体（可选） 该部分可选。响应消息体通常以结构化格式（如JSON或XML）返回，与响应消息头中Content-Type对应，传递除响应消息头之外的内容。 对于创建工作共享空间接口，返回如下消息体。 { "workspace_id" : "aa78047c2e22408597dbeb2d33295720", "workspace_name" : "工作空间名称", "creator" : "user", "create_time" : "2022-11-07T08:28:05Z", "workspace_description" : "这是描述", "star" : 0 } 当接口调用出错时，会返回错误码及错误信息说明，错误响应的Body体格式如下所示。 { "error_code" : "KMP.00011004", "error_msg" : "请求参数不合法" } 其中，error_code表示错误码，error_msg表示错误描述信息。

AR地图运行服务错误码 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 状态码 错误码 错误信息 描述 处理措施 400 NAVI.0002 Navi failed, please check parameters. 导航失败。 检查参数是否正确或联系技术支持。 400 NAVI.0003 Invalid parameters. 导航算法服务参数不正确。 检查参数是否正确。 400 NAVI.0004 Access denied, out of your service zone. 导航参数不正确，位置不在您的服务区。 到有服务的地方请求或联系技术支持。 400 VPS.0002 VPS failed. 空间定位算法服务定位错误。 检查参数是否正确或请联系技术支持。 400 VPS.0003 Invalid parameters. 空间定位算法服务请求参数不正确。 检查参数是否正确。 400 VPS.0004 Access denied, out of your service zone. 空间定位算法服务参数不正确，位置不在您的服务区。 到有服务的地方请求或联系技术支持。 403 GATEWAY.0002 Auth failed, please check your auth token. 鉴权header未携带。 在请求头中携带鉴权信息，参考“如何调用API”。 403 GATEWAY.0003 Service unavailable. 服务未开通/冻结。 开通/购买服务，检查服务是否被冻结或联系技术支持。 403 GATEWAY.0005 IAM auth deny, you don't have the permission of this action. IAM鉴权失败，没有action的访问权限。 为IAM用户添加此服务对应的操作权限。 429 GATEWAY.0006 Too many requests. 触发网关限流。 降低访问频率或开通更高QPS规格的服务。 500 GATEWAY.0001 Open gateway system inner error. 网关内部错误。 请联系技术支持。 500 NAVI.0001 Navi internal server error. 导航算法服务错误。 请联系技术支持。 500 VPS.0001 Internal server error. 空间定位算法服务错误。 请联系技术支持。 502 GATEWAY.0007 Service timeout. 服务超时。 请联系技术支持。

续费 按需计费模式不需要续费操作，只需要保证账户余额充足即可。 套餐包需要续费操作，在套餐包到期后，如果用户想继续使用此套餐包，需要在指定时间内续费，否则可能无法使用相应的功能。 套餐包续费功能有两种： 手动续费：套餐包从购买到过期之前，用户可以在华为云控制台的“费用”为套餐包续费，以延长套餐包的使用时间。详情请参见手动续费。 自动续费：开通自动续费后，套餐包在每次到期前自动续费，避免因忘记手动续费而导致可能无法使用相应的功能。详情请参见自动续费。 套餐包的续费生命周期如图1所示，用户根据需要选择一种进行续费。 图1 续费生命周期 套餐包从购买至过期前，处于正常使用阶段，状态为“使用中”。 到期后，套餐包状态变为“已过期”。 到期未续费时，套餐包自动进入宽限期，宽限期到期后仍未续费，状态变为“已冻结”。 超过宽限期仍未续费时，套餐包自动进入保留期，在保留期内续费解冻后，仍旧可以继续正常使用。 宽限期和保留期的详细介绍，请参见宽限期保留期。 华为云根据客户等级定义了不同客户的宽限期和保留期时长。 更多续费相关操作，请参见续费管理。

欠费后，数据会被删除吗 当用户账号产生欠费后，用户需在约定时间内支付欠款，以防止账号冻结、相关服务资源停止或者释放对自身业务产生影响，具体操作请参见欠费还款。 欠费后，如果没有及时续费或充值，将进入宽限期。如宽限期满仍未续费或充值，将进入保留期。在保留期内资源将停止服务。保留期满仍未续费或充值，存储在云服务中的数据将被删除，云服务资源将被释放。详细说明请参见资源停止服务或逾期释放说明。宽限期与保留期的具体规则请参见宽限期保留期。 父主题： 计费FAQ

KooMap服务采用哪种计费模式，如何计费 计费模式：KooMap支持按需计费和套餐包两种计费模式。按需计费根据用户实际使用量和使用时长计费。这种计费方式比较灵活，可以按需开通和释放资源。套餐包是一种先付费再使用的计费模式，适用于对产品需求稳定且希望降低成本的用户。 计费规则： 卫星影像生产服务总费用 = 时空专属存储费用 + 各个基础处理服务费用 AR地图运行服务基础版总费用 = 时空专属存储费用 （公测时间不收取费用）+ 视觉定位和AR导航调用费用 实景三维生产服务总费用 = 时空专属存储费用 + 实景三维生产服务费用（基础版或专业版） AR地图生产服务总费用 = 时空专属存储费用（公测时间不收取费用） + AR地图生产服务费用 父主题： 计费FAQ

欠费影响 按需计费 当您的账户余额不足导致结算失败，账号将变成欠费状态。欠费后，按需资源不会立即停止服务，资源进入宽限期。您需支付按需资源在宽限期内产生的费用，相关费用可在管理控制台的“费用中心 ＞ 总览”菜单下查看“欠费金额”，华为云将在您充值时自动扣取欠费金额。 如果您在宽限期内仍未支付欠款，那么就会进入保留期，资源状态变为“已冻结”，您将无法对处于保留期的按需计费资源执行任何操作。 保留期到期后，若您仍未支付账户欠款，那么存储在云服务中的数据将被删除，云服务资源将被释放。 为防止账号冻结、相关服务资源停止或者释放对您的业务产生影响，请您及时在约定时间内支付欠款。 图1 按需计费KooMap资源生命周期 套餐包 用户使用套餐包，已经预先支付了套餐包费用，因此在账户出现欠费或者账单逾期的情况下，已有的套餐包仍可正常使用。然而，对于涉及费用的操作，如新购套餐包等，用户将无法正常进行。 用户已购买套餐包，续费时因余额不足会出现续费不成功，用户应及时充值，保证账户余额充足。 华为云根据客户等级定义了不同客户的宽限期和保留期时长。

计费场景 卫星影像生产服务 某用户在2023/09/01 09:30:00开通卫星影像生产服务，使用100GB的时空专属存储服务，并且使用100GB的数据基础处理：色彩增强与粗纠正L2。2023/09/01 10:30:00退订服务。 实景三维生产服务 某用户在2023/09/01 09:30:00开通实景三维生产服务，使用100GB的时空专属存储服务，并且使用100GP的实景三维生产服务基础版数据处理。 2023/09/01 10:30:00退订服务。 AR地图运行服务 某用户在2023/09/01 09:30:00开通AR地图运行服务，规格为50QPS。2023/09/02 09:30:00退订服务。 AR地图生产服务 按需计费：某用户在2023/09/01 09:30:00开通AR地图生产服务，使用全景建图云服务购买2万米的规格，2023/09/02 09:30:00退订服务。 套餐包：某用户在2023/09/01 09:30:00开通AR地图生产服务，并同时购买2个全景建图云服务套餐包（规格1万米，周期一年），使用全景建图云服务，2024/08/31 23:59:59到期。

计费构成分析 以下案例中出现的费用价格仅供参考，实际价格请参见控制台界面价格说明。 卫星影像生产服务 按需计费：2023/09/01 09:30:00 ~ 2023/09/01 10:30:00期间总共使用100GB的时空专属存储服务，数据存储的单价为 0.00029元/GB；总共进行了100GB的数据基础处理：色彩增强与粗纠正L2，该规格的数据处理单价为105元/GB，共使用了1小时。则总价为100* 0.00029+100*105=10500.029元。 实景三维生产服务 按需计费：2023/09/01 09:30:00 ~ 2023/09/01 10:30:00期间总共使用100GB的数据量处理，数据存储的单价为 0.00029元/GB；总共进行了100GP的实景三维生产服务基础版数据处理，该规格的数据处理单价为10元/GP，共使用了1小时。则总价为100* 0.00029+100*10=1000.029元。 AR地图运行服务 按需计费：2023/09/01 09:30:00 ~ 2023/09/02 09:30:00期间总共使用24个小时，50QPS的单价为125元/小时，总价为24*125=3000元。 AR地图生产服务 按需计费：2023/09/01 09:30:00 ~ 2023/09/02 09:30:00期间总共使用2万米，单价为1元/米，总价为20000*1=20000元。 按套餐包计费：2023/09/01 09:30:00 ~ 2024/08/31 23:59:59期间总共使用1年，总价即为全景建图云服务1万米套餐包费用7000元*2个=14000元。

计费说明 KooMap服务各个子服务的计费项如表1所示。 表1 计费项信息 服务 计费项 计费项说明 适用的计费模式 计费公式 卫星影像生产服务 时空专属存储 按实际存储数据（包括原始卫星影像、生产资料、成果影像、矢量数据）占用量计费，以GB为单位进行计费。 计费周期：实时计费 ，按小时结算。 按需计费 影像数据存储量（GB） * 单价（元/GB） * 小时 基础处理：色彩增强与粗纠正L2 按实际数据处理量计费，以GB为单位进行计费。 按需计费 成果影像数据量（GB）*单价（元/GB） 基础处理：色彩增强与精纠正L3 按实际数据处理量计费，以GB为单位进行计费。 按需计费 成果影像数据量（GB）*单价（元/GB） 基础处理：正射纠正L4 按实际数据处理量计费，以GB为单位进行计费。 按需计费 成果影像数据量（GB）*单价（元/GB） 基础处理：影像镶嵌L5 按实际数据处理量计费，以GB为单位进行计费。 按需计费 成果影像数据量（GB）*单价（元/GB） 实景三维生产服务 时空专属存储 按实际存储数据（包括倾斜影像、生产资料、精修后处理任务的输入数据、数据生产过程中产生的中间数据、成果数据）占用量计费，以GB为单位进行计费。 计费周期：实时计费 ，按小时结算。 按需计费 实际存储数据存储量（GB） *单价（元/GB）*小时 实景三维生产服务基础版 按实际数据处理量计费，以GP为单位进行计费。 按需计费 倾斜影像像素数量（GP）*单价（元/GP） 实景三维生产服务专业版 按实际数据处理量计费，以GP为单位进行计费。 按需计费 倾斜影像像素数量（GP）*单价（元/GP） AR地图运行服务 AR地图运行服务基础版 按实际开通时长计费，以小时为单位进行计费。 按需计费 资源规格对应的单价*开通时长 说明： KooMap AR地图运行服务根据您使用的规格和时长进行计费，提供50QPS ~ 500QPS总共10档资源规格。例如50QPS表示每秒支持50个用户并发。 AR地图生产服务 AR地图全景建图云服务 按实际数据处理量（采图轨迹长度）计费，以米为单位进行计费。 按需计费、套餐包 按需计费：采图轨迹长度（米）*单价（元/米） 套餐包：从套餐包的长度总量中扣除相应的轨迹长度（米），超出部分按需计费

计费周期 计费项 计费周期 时空专属存储 按小时结算。 系统每小时会统计前一个小时（整点区间，如18:00~19:00）的实际存储用量，根据实际用量产生话单并结算扣费。例如，在19:15结算的费用一般为18:00~19:00期间产生的费用，也可能存在延迟。 费用结算的最小时长为1小时，与具体的数据上传无关。例如，在结算18:00~19:00的存储费用时，无论是在18:00~19:00之间哪个时间段上传的，都以存储时长为1小时结算。 基础处理：色彩增强与粗纠正L2 按小时结算。 按照实际成果影像的存储量GB计费。例如，数据处理完成后，系统会对实际处理数据量结算费用。 基础处理：色彩增强与精纠正L3 基础处理：正射纠正L4 基础处理：影像镶嵌L5 实景三维生产服务基础版 按小时结算。 按照实际输入倾斜影像的像素数量GP计费。 例如，数据完成后，系统会对本次处理的实际处理数据量结算费用。 实景三维生产服务专业版 AR地图运行服务基础版 按小时结算。 系统每小时会统计前一个小时费用，例如，在10:15结算的费用一般为09:00:00~10:00:00期间产生的费用。 AR地图生产服务 按小时结算。 按照实际输入的轨迹长度（米）计费。例如，数据完成后，系统会对本次处理的实际处理数据量结算费用。 系统每小时会统计前一个小时费用。例如，在10:15结算的费用一般为09:00:00~10:00:00期间产生的费用。

适用计费项 表1 适用计费项 服务 计费项 说明 卫星影像生产服务 时空专属存储 按实际存储占用量计费，以GB为单位进行计费。 基础处理：色彩增强与粗纠正L2 按实际数据处理量计费，以GB为单位进行计费。 基础处理：色彩增强与精纠正L3 按实际数据处理量计费，以GB为单位进行计费。 基础处理：正射纠正L4 按实际数据处理量计费，以GB为单位进行计费。 基础处理：影像镶嵌L5 按实际数据处理量计费，以GB为单位进行计费。 实景三维生产服务 时空专属存储 按实际存储占用量计费，以GB为单位进行计费。 实景三维生产服务基础版 按实际数据处理量计费，以GP为单位进行计费。 实景三维生产服务专业版 按实际数据处理量计费，以GP为单位进行计费。 AR地图运行服务 AR地图运行服务基础版 按实际开通时长计费，以小时为单位进行计费。 AR地图生产服务 AR地图全景建图云服务 按实际数据处理量（采图轨迹长度）计费，以米为单位进行计费。

计费模式概述 KooMap提供按需计费和套餐包两种计费模式，以满足不同场景下的用户需求。 按需计费：一种后付费模式，即先使用再付费，按照云服务器实际使用时长计费，按小时结算。按需计费模式允许您根据实际业务需求灵活地调整资源使用，无需提前预置资源，从而降低预置过多或不足的风险。 套餐包：一种预付费模式，即先付费再使用，使用时优先扣除套餐包额度，超出部分按需计费。一般适用于设备需求量长期稳定的成熟业务。 表1 计费模式 计费模式 按需计费 套餐包 付费方式 后付费 预付费 计费周期 按小时结算 按订单的购买周期计费，超出部分按需计费 适用计费项 时空专属存储、卫星影像L2/L3/L4/L5等级处理、实景三维生产服务基础版/专业版、AR地图运行服务基础版、AR地图生产服务 AR地图生产服务 变更计费模式 不支持变更计费模式 不支持变更计费模式 适用场景 适用于计算资源需求波动的场景，可以随时开通，随时退订 适用于对产品需求稳定且希望降低成本的用户 父主题： 计费模式