云服务器内容精选

  • 响应示例 状态码: 200 请求成功。 { "data" : [ { "usage_measure_name" : "时空专属存储", "usage_type" : "DATA", "domain_id" : "abc123c55c3c4526b2ed7a0213bc9xxx", "usage_subtype" : null, "usage_unit_type" : "VOLUME", "capacity" : 0, "usage" : 0, "unit" : "GB", "created_time" : "2022-10-27T13:12:56Z", "update_time" : "2022-10-27T13:12:56Z" } ], "page" : { "offset" : 0, "limit" : 10, "total" : 1 } }
  • 响应参数 状态码: 200 表3 响应Header参数 参数 参数类型 描述 X-request-id String 请求ID,用于运维人员定位请求日志。 表4 响应Body参数 参数 参数类型 描述 data Array of UsageInfo objects 用量信息列表。 page Page object 分页信息。 表5 UsageInfo 参数 参数类型 描述 usage_measure_name String 用量度量名称,通常与KooMap的计费项保持一致。当前支持以下用量度量名称: 时空专属存储 基础处理:色彩增强与粗纠正L2 基础处理:色彩增强与精纠正L3 基础处理:正射纠正L4 基础处理:影像镶嵌L5 最小长度:0 最大长度:50 usage_unit_type String 用量单位类型,表示单条用量单位所对应的类型。 该值为“VOLUME”时表示用量单位是存储量。 该值为“TIME”时表示用量单位是次数。 usage_type String 用量类型。 该值为“DATA”时表示时空专属存储服务对应的用量。 该值为“TASK”时表示处理任务服务对应的用量。 domain_id String 华为云 IAM 租户账号ID。 最小长度:32 最大长度:32 usage_subtype String 用量子类型,用于区分同一用量类型下的多个子用量,目前usage_type为“TASK”时才需要设置该值。 L2:L2等级生产服务 L3:L3等级生产服务 L4:L4等级生产服务 L5:L5等级生产服务 最小长度:0 最大长度:20 usage Float 租户当前的使用量数值。 capacity Float 租户购买的套餐总量值,按需使用取值为0。 unit String 用量的计量单位。 当用量单位类型为“VOLUME”时,单位为存储量相关的单位,如:GB。 当用量单位类型为“TIME”时,单位为“次”。 created_time String 用量记录的创建时间。格式为UTC标准时间:yyyy-MM-dd'T'HH:mm:ss'Z'。 最小长度:20 最大长度:20 update_time String 用量记录的更新时间。格式为UTC标准时间:yyyy-MM-dd'T'HH:mm:ss'Z'。 最小长度:20 最大长度:20 表6 Page 参数 参数类型 描述 offset Integer 偏移量,表示从第几条数据开始查询。 limit Integer 每页包含的查询记录数量。 total Integer 符合查询条件的记录总数。 状态码: 400 表7 响应Header参数 参数 参数类型 描述 X-request-id String 请求ID,用于运维人员定位请求日志。 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为:KMP.XXXXXXXX,其中X表示数字。 最小长度:12 最大长度:12 error_msg String 错误描述。 最小长度:2 最大长度:512 状态码: 500 表9 响应Header参数 参数 参数类型 描述 X-request-id String 请求ID,用于运维人员定位请求日志。 表10 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为:KMP.XXXXXXXX,其中X表示数字。 最小长度:12 最大长度:12 error_msg String 错误描述。 最小长度:2 最大长度:512
  • URI GET /v1/kmp-control/usages 表1 Query参数 参数 是否必选 参数类型 描述 usage_type 是 String 查询的用量类型。 DATA:时空专属存储服务占用空间大小。 TASK:成功处理的成果影像数据大小以及成功处理任务次数。 limit 否 Integer 分页大小。 最小值:1 最大值:100 缺省值:10 offset 否 Integer 偏移量,表示从第几条记录开始查询。 最小值:0 最大值:2147483647 缺省值:0
  • 响应示例 状态码: 200 请求成功。 { "data_info" : [ { "image_name" : "影像名称", "is_product" : "0", "image_level" : "L1A", "image_status" : "完成", "image_date" : "2013-10-09T16:00:00Z", "upload_date" : "2022-11-09T03:02:52Z", "image_resolution" : "16.0", "image_description" : "", "image_id" : "9260ad8d63f84ed1a9269f56162e42a5", "image_type" : "1", "user_name" : "IAM用户名称", "image_alias" : "WFV3", "product_clip" : 1, "product_tile" : 1, "is_cog" : 1 } ] } 状态码: 400 非法请求。 { "error_code" : "400", "error_msg" : "参数不符合规范。" }
  • 响应参数 状态码: 200 表3 响应Body参数 参数 参数类型 描述 data_info Array of DataInfo objects 数据信息列表。 page Page object 分页信息。 表4 DataInfo 参数 参数类型 描述 image_name String 卫星影像名称。 支持模糊查询,格式为中英文、数字、下划线、中划线、“.”,长度100个字符以内。 is_product String 卫星影像是否为成果影像。 目前只支持原始影像(0)、成果影像(1)。 枚举值: 0 1 image_level String 卫星影像等级。 目前只支持L1、L1A、L1B、L2、L3、L4、L5。 最小长度:2 最大长度:3 image_status String 卫星影像迁移状态。当前仅支持完成(0)、迁入中(1)、迁入失败(2)、迁出中(3)、迁出失败(4)、删除中(6)、卫星影像正在被任务使用导致删除失败(7)、网络错误导致删除失败(8)。 image_date String 卫星影像成像时间。 格式为UTC标准时间:yyyy-MM-dd'T'HH:mm:ss'Z'。 最小长度:20 最大长度:20 upload_date String 卫星影像上传时间。 格式为UTC标准时间:yyyy-MM-dd'T'HH:mm:ss'Z'。 最小长度:20 最大长度:20 image_resolution String 卫星影像分辨率,精确到小数点后一位。 image_description String 卫星影像描述。 格式为中英文、数字、下划线、中划线,长度255个字符以内。 最小长度:0 最大长度:255 image_id String 卫星影像ID。 格式为英文、数字,长度为32。 最小长度:32 最大长度:32 image_type String 卫星影像类型。当前仅支持全色(0)、多光谱(1)。 枚举值: 0 1 user_name String IAM用户名称。 image_alias String 卫星影像别名。 格式为中英文、数字、下划线、中划线、“.”,长度255个字符以内。 最小长度:0 最大长度:255 product_clip Integer 是否为矢量切割影像。当前仅支持是(1)、否(0)。 枚举值: 0 1 product_tile Integer 是否为金字塔切割影像。当前仅支持是(1)、否(0)。 枚举值: 0 1 is_cog Integer 是否为COG影像。当前仅支持是(1)、否(0)。 枚举值: 0 1 表5 Page 参数 参数类型 描述 offset Integer 偏移量,表示从第几条数据开始查询。 limit Integer 每页包含的查询记录数量。 total Integer 符合查询条件的记录总数。 状态码: 400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为:KMP.XXXXXXXX,其中X表示数字。 最小长度:12 最大长度:12 error_msg String 错误描述。 最小长度:2 最大长度:512 状态码: 500 表7 响应Header参数 参数 参数类型 描述 X-request-id String 请求ID,用于运维人员定位请求日志。 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为:KMP.XXXXXXXX,其中X表示数字。 最小长度:12 最大长度:12 error_msg String 错误描述。 最小长度:2 最大长度:512
  • 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String IAM Token信息,用于租户鉴权,该字段由租户请求IAM的Token接口获得。 表2 FormData参数 参数 是否必选 参数类型 描述 image_name 否 String 卫星影像名称,支持模糊查询。 格式为中英文、数字、下划线、中划线、“.”,长度100个字符以内。 最小长度:0 最大长度:100 image_date_from 否 String 卫星影像上传起始时间。 格式为UTC标准时间:yyyy-MM-dd'T'HH:mm:ss'Z'。 最小长度:20 最大长度:20 image_date_to 否 String 卫星影像上传截止时间。 格式为UTC标准时间:yyyy-MM-dd'T'HH:mm:ss'Z'。 最小长度:20 最大长度:20 image_status 否 String 卫星影像迁移状态列表。 当前仅支持完成(0)、迁入中(1)、迁入失败(2)、迁出中(3)、迁出失败(4)、删除中(6)、卫星影像正在被任务使用导致删除失败(7)、网络错误导致删除失败(8)。状态之间以“,”隔开。 raw_alias 否 String 卫星影像别名。 支持模糊查询,格式为中英文、数字、下划线、中划线、“.”,长度100个字符以内。 最小长度:0 最大长度:100 image_alias 否 String 卫星影像别名列表。 格式为中英文、数字、下划线、中划线、“.”。别名之间以“,”隔开。 image_levels 否 String 卫星影像等级列表。 当前仅支持L1、L1A、L1B、L2、L3、L4、L5。等级之间以“,”隔开。 is_product 否 String 卫星影像是否为成果数据。 当前仅支持原始数据(0)、成果数据(1)。 order 否 String 卫星影像排序规则。 当前仅支持影像名称正序(1)、影像名称倒序(-1)、影像别名正序(2)、影像别名倒序(-2)、影像上传日期正序(3)、影像上传日期倒序(-3)。 description 否 String 卫星影像描述。 格式为中英文、数字、下划线、中划线,长度为255个字符以内。 image_type 否 String 卫星影像类型。当前仅支持全色(0)、多光谱(1)。 limit 是 Integer 每页显示条数。 最小值:1 最大值:100 offset 是 Integer 偏移量,表示从第几条记录开始查询。 最小值:0 最大值:2147483647
  • 请求示例 新建处理任务,目前只支持卫星影像处理任务(ORSIP)。 POST https://{Endpoint}/v1/kmp-control/tasks { "task_name": "这是任务描述", "task_type": "ORSIP", "data_ids": [ "ed9313d537dd4cf7a6a7758f9xxxxd84", "8dc0d6187b8e4f429c2d20d34xxxxx5a" ], "production_level": "L2", "task_description": "这是任务描述", "workspace_id": "dfa3527b45a24de6a2d0ddbcb8xxxxxx", "shape_id": null, "data_alias": { "JL1_20160112_203_0018_L2": "JL1_20160112_203_0018_L2" }, "coordination": "WGS84", "data_description": { "JL1_20160112_203_0018_L2": null }, "csv_ids": [3cd09e0xbf7949a59c9ec14012a4xxxx], "is_clip": "0", "is_tile": "0" }
  • 响应示例 状态码: 200 请求成功。 { "task_id" : "4d40e927514a40898d23a20155xxxxxx", "workspace_id" : "dfa3527b45a24de6a2d0ddbcb8xxxxxx", "data_id" : "[\"ed9313d537dd4cf7a6a7758f942xxxxx\",\"8dc0d6187b8e4f429c2d20d340xxxxxa\"]", "task_name" : "测试", "domain_id" : "234602bf93714dcba145eaa45xxxxxxx", "creator" : "xxxxx", "create_time" : "2023-02-17T09:27:07Z", "task_status" : "INIT", "task_type" : "ORSIP", "task_description" : "测试", "exec_start_time" : null, "exec_stop_time" : null, "origin_data_alias" : null, "production_level" : "L2", "task_progress" : "0.0", "shape_id" : null, "is_deleted" : 0, "image_url" : null, "frozen_tag" : null, "is_clip" : "0", "is_tile" : "0" }
  • 响应参数 状态码: 200 表3 响应Body参数 参数 参数类型 描述 task_id String 任务唯一标识ID。 最小长度:32 最大长度:36 workspace_id String 工作共享空间ID。 data_id String 数据ID。 task_name String 任务名称。 最小长度:2 最大长度:64 creator String 创建者ID。 最小长度:2 最大长度:512 create_time String 创建时间。 task_status String 任务状态。包括INIT(初始化)、RUNNING(运行中)、SUC CES S(执行成功)、ARCHIVED(已归档)、FAILED(执行失败)、STOPPING(停止中)、STOP_SUCCESS(已停止)、STOP_FAILED(停止失败)、START_RUNNING(等待中)。 task_type String 任务类型。 当前仅支持ORSIP(卫星影像生产)。 task_description String 任务描述。 exec_start_time String 开始操作时间。 缺省值:null exec_stop_time String 停止操作时间。 缺省值:null origin_data_alias String 原始数据别名。 production_level String 任务输出结果影像级别,当前支持以下级别: L2、L3、L4、L5。 task_progress String 任务执行进度。 shape_id String 矢量数据文件ID,“isClip”为“1”时必填。 is_deleted Integer 是否删除。 0:未删除 1:已删除 image_url String 影像链接。 domain_id String 华为云IAM租户账号ID。 fail_message String 任务失败原因。 frozen_tag String 任务冻结状态。当前仅支持frozen(冻结中)。 isClip String 是否为矢量切割。 0:否 1:是 isTile String 是否为金字塔切割。 0:否 1:是 状态码: 400 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为:KMP.XXXXXXXX,其中X表示数字。 最小长度:12 最大长度:12 error_msg String 错误描述。 最小长度:2 最大长度:512 状态码: 500 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为:KMP.XXXXXXXX,其中X表示数字。 最小长度:12 最大长度:12 error_msg String 错误描述。 最小长度:2 最大长度:512
  • (可选)导入生产资料 登录KooMap服务控制台,进入控制台页面。 在左侧导航栏选择“卫星影像”下的“数据管理”菜单,然后在右侧页面单击“生产资料”页签。 单击“导入生产资料”,出现“导入生产资料文件”弹窗。 填写或选择导入生产资料文件的信息,包括导入方式、上传文件、生产资料别名、生产资料描述(相关说明可参考下表4)。 表4 导入生产资料文件说明 序号 参数名称 参数说明 1 导入方式 必选项,仅支持从本地上传生产资料(小于60MB)。 2 上传文件 必选项,单击“选择文件”,依照系统提示上传本地生产资料文件。 3 生产资料别名 必填项,依照系统提示输入生产资料别名,不可与已有别名重复。 4 生产资料描述 选填项,主要描述导入生产资料文件的补充信息,输入要求请查看界面提示。 单击“确定”,导入生产资料文件。导入成功后,“运行状态”变更为“加密完成”。 图7 导入生产资料
  • 导入卫星影像 登录KooMap服务控制台,进入控制台页面。 在左侧导航栏,选择“卫星影像”下的“数据管理”菜单,然后在右侧页面单击“影像数据”页签。 添加影像文件。 单击“导入影像”,您可选择如下任一方式添加影像文件到列表中。 单个添加:参考表1配置影像文件信息,单击,将影像文件添加到“已添加的影像文件”列表中。如果需导入多个目录地址的影像文件,请您分别配置影像文件信息,并单击添加到列表中。 图1 设置影像文件信息 批量添加:单击页面右上角的“下载模板”,依照模板提示或参考表1配置影像文件信息,再单击“上传Excel”批量添加影像文件。 表1 导入影像参数说明 参数名称 参数说明 OBS Endpoint 必填项,输入OBS桶所在区域的终端节点,可参考查看桶信息获取。 影像目录地址 必填项,输入上传到OBS桶的原始影像文件所在的文件夹路径(可直接进入OBS控制台复制OBS的文件路径),不可与已有地址重复。 目录地址格式为:obs://桶名/影像文件所在的文件夹路径。 示例:obs://obstest-ea7e/path 影像名称 无需手动输入,系统会根据您导入的影像自动识别名称。 影像别名 必填项,依照界面提示输入影像的别名,不可与已有别名重复。 影像描述 选填项,主要描述导入影像的补充信息。 图2 已添加的影像文件 导入影像文件。 单个导入:在“已添加的影像文件”列表中单击操作列的“导入”,导入单个影像文件。 您还可以执行删除、编辑、重试操作。 删除:从列表中删除影像文件。 编辑:重新设置影像文件信息。该影像文件会从当前列表中删除,编辑完成后可再次添加到“已添加的影像文件”列表中。 重试:导入失败,排查原因并修改后,重新导入影像文件。 批量导入:单击页面最下方的“开始批量导入”按钮,批量导入“已添加的影像文件”列表中的影像文件。 在“已添加的影像文件”列表中,如果该影像文件处理结果提示“文件名校验失败”,请单击操作列或页面右上角的“命名辅助工具”,参考表2配置参数,根据生成的文件夹和文件名称修改OBS桶内文件夹与文件名称,并重新执行1~4。 表2 命名辅助工具参数说明 参数 说明 卫星名 必填项,输入卫星名,卫星名前缀不能为GF1、GF2、GF6、GF7、JL1、TRIPLESAT、BJ3、SV1、SV2、ZY1、ZY3、SJ9A、PHR1A、PHR1B、WV01、WV02、TH01,仅支持输入字母和数字,不能超过100个字符。 传感器名 必选项,选择传感器名称。目前仅支持如下传感器名称: MSS PAN 成像日期 必选项,设置卫星影像的成像日期。 中心经度 必填项,输入卫星影像中心经度。E/W开头(不区分大小写),经度保留一位小数,如E23.0。 中心纬度 必填项,输入卫星影像中心纬度。N/S开头(不区分大小写),纬度保留一位小数,如N23.0。 等级 必选项,选择卫星影像等级,目前仅支持“L1”等级。 文件夹名称 系统依照上面设置的信息,自动拼接文件夹名称。单击可复制文件夹名称。 文件夹 展示文件夹中的目录文件。您可以根据生成的结果去修改本地影像文件夹与文件名称。 说明: 文件夹名称与文件名称须保持一致。 文件夹内必须包含 .tif/.tiff、.rpc/.rpb、.xml三种后缀名的文件。 查看导入结果。 导入后,在左侧导航栏选择“卫星影像”下的“数据管理”菜单,然后在右侧页面单击“影像数据”页签,可查看该影像文件导入情况,导入过程中“运行状态”为“迁入中”,导入成功后,“运行状态”变更为“完成”。 图3 导入卫星影像
  • (可选)导入矢量数据 登录KooMap服务控制台,进入控制台页面。 在左侧导航栏选择“卫星影像”下的“数据管理”菜单,然后在右侧页面单击“矢量数据”页签。 单击“导入矢量”,出现“导入矢量文件”弹窗。 填写或选择导入矢量文件的信息,相关说明可参考下表3。 表3 导入矢量参数说明 序号 参数名称 参数说明 1 导入方式 必选项,选择矢量文件的导入方式,选项如下: 矢量文件地址导入(小于2GB) 说明: 支持的文件格式有:.dbf、.shp、.shx、.prj、.sbn、.sbx、.cpg、.qpj、.xml、.qmd,至少应含有.dbf、.prj、.shp、.shx四个文件。文件大小之和应小于2GB,请上传文件名相同的文件。 本地矢量文件上传(小于60MB) 说明: 支持的文件格式有:.dbf、.shp、.shx、.prj、.sbn、.sbx、.cpg、.qpj、.xml、.qmd,至少应含有.dbf、.prj、.shp、.shx四个文件。文件大小之和应小于60MB,请上传文件名相同的文件。 2 OBS Endpoint 必填项,当导入方式选择“矢量文件地址导入”显示该项参数。输入OBS桶所在区域的终端节点,可参考查看桶信息获取。 3 矢量目录地址 必填项,当导入方式选择“矢量文件地址导入(小于2GB)”时才显示该参数。 获取方式:进入OBS管理控制台复制矢量文件所在的文件夹路径。 目录地址格式为:obs://桶名/矢量文件所在的文件夹路径。 示例:obs://obstest-ea7e/path 4 上传文件 必填项,当导入方式选择“本地矢量文件上传(小于60MB)”时才显示该参数,单击“选择文件”上传本地矢量文件。 5 矢量别名 必填项,根据界面提示输入矢量别名,且不能与系统已有别名重复。 6 矢量描述 选填项,主要描述导入矢量文件的补充信息,输入要求请查看界面提示。 图4 矢量文件地址导入 图5 上传本地矢量文件 单击“确定”,导入矢量数据。 导入后,选择“卫星影像”下的“数据管理”菜单,然后单击“矢量数据”页签,查看该矢量数据导入情况。导入过程中“运行状态”为“迁入中”,导入成功后,“运行状态”变更为“完成”。 图6 导入矢量数据
  • 操作步骤 登录KooMap管理控制台。 在左侧导航栏选择“工作共享空间管理”,然后在右侧页面单击待创建任务的工作共享空间名称,进入任务概览页。 选择“卫星影像概览”页签,单击,进入“创建任务”页面。 填写任务基本信息,单击“下一步”。 基本信息包括任务名称、任务描述。 设置任务的其他相关信息,单击“下一步”。 其他相关信息包括数据类型、处理等级、坐标系、卫星影像、生产资料和矢量数据。 选择处理等级、坐标系、数据类型。 表1 配置项说明 配置项 配置说明 处理等级 选择卫星影像处理等级。 有“L2”、“L3”、“L4”和“L5”四个处理等级可供选择。 选择“L3”处理等级时,系统默认勾选“生产资料”。 选择“L4”处理等级时,可勾选“生产资料”。 选择“L5”处理等级时,可勾选“生产资料”、“金字塔切割”或“矢量切割”。 坐标系 选择卫星影像坐标系。 有“WGS84”、“WGS84-UTM”、“国家2000”和“国家2000-GaussKruger”可供选择。 说明: 当您使用“WGS84-UTM”时,可在右侧框选择具体的UTM带号。 当您使用“国家2000-GaussKruger” 时,需根据您实际需要在右侧框选择CG CS 2000坐标系对应EPSGCode。 数据类型 影像处理的数据类型。 “卫星影像”是必选项,您也可依据实际情况选择其他的数据类型。 当“处理等级”选择“L2”时,“数据类型”必须选择“卫星影像”。 当“处理等级”选择“L3”时,“数据类型”必须选择“卫星影像”和“生产资料”。 当“处理等级”选择“L4”且勾选“生产资料”时,“数据类型”除了必选“卫星影像”,还可选择“生产资料”。 当“处理等级”选择“L5”且勾选“生产资料”或“矢量切割”时,“数据类型”除了必选“卫星影像”,还可选择“生产资料”或“矢量数据”。 单击对应的“数据类型”,选择待处理的卫星影像、矢量数据或生产资料,单击“下一步”。 勾选卫星影像文件 您可直接勾选卫星影像文件或设置过滤条件筛选后,再勾选符合过滤条件的影像文件。文件的选择需遵守如下规则: 只处理多光谱影像:拍摄卫星只有多光谱相机(GF1-WFV或GF6-WFV),且必须选择卫星型号和传感器型号一致的影像。 处理多光谱和全色一一对应影像:必须选择卫星型号一致的影像,且多光谱和全色影像文件数量一致。 图1 勾选卫星影像文件 (可选)勾选矢量数据 当处理等级选择“L5”且勾选“矢量切割”选项时,才需选择矢量数据。您可直接勾选矢量数据或设置过滤条件筛选后,再勾选符合过滤条件的矢量数据。 图2 勾选矢量数据 (可选)勾选生产资料 当处理等级选择“L3”、“L4”或“L5”且勾选“生产资料”时,才需选择生产资料。您可直接勾选生产资料或设置过滤条件筛选后,再勾选符合过滤条件的生产资料。 图3 勾选生产资料 确定或修改新建任务的信息,单击“确定”。 确认成果影像名称或根据需要修改成果影像别名(影像别名不可重复)、影像描述。 返回任务概览页面查看新建的处理任务。 鼠标悬停在卡片中的任务名称处,可查看该任务相关信息。 图4 任务创建成功
  • 概述 卫星影像生产服务:对原始的遥感光学卫星影像进行专业处理,生成各个行业应用可使用的成果影像数据。 您可在KooMap控制台完成卫星影像、矢量数据和生产资料的管理,包括导入、查询、查看、迁移、下载、删除等操作;还可以在KooMap控制台查看卫星影像生产服务任务处理后相关用量统计信息。 卫星影像:指通过安装在遥感平台上的遥感仪器对地球表面摄影或扫描获得的影像。目前版本仅支持对遥感光学卫星影像处理。 矢量数据:指通过记录坐标的方式尽可能的将地理实体的空间位置表现的准确无误。影像处理服务中可利用矢量属性对卫星影像边界裁切,从而获取到满足用户业务需求数据。 生产资料:指摄区范围内具有平面坐标、高程坐标的地理信息文件,用于提升成果影像的几何精度。 父主题: 卫星影像