华为云用户手册

Zeppelin Zeppelin是一个基于web的notebook，支持交互式的数据分析。了解更多请访问Zeppelin官网http://zeppelin.apache.org/。 本样例脚本能够自动化安装Zeppelin。根据创建集群的region选择对应的脚本路径，在创建集群的添加引导操作时填入到“脚本路径”即可，该脚本无需填入参数。根据Zeppelin使用习惯，您只须在Active Master节点上执行该脚本。 添加引导操作时填入的脚本路径： 华北-北京一：s3a://mrs-samples-bootstrap-cn-north-1/zeppelin/zeppelin_install.sh 华东-上海二：s3a://mrs-samples-bootstrap-cn-east-2/zeppelin/zeppelin_install.sh 华南-广州：s3a://mrs-samples-bootstrap-cn-south-1/zeppelin/zeppelin_install.sh 华北-北京四：s3a://mrs-samples-bootstrap-cn-north-4/zeppelin/zeppelin_install.sh 样例脚本下载路径： 华北-北京一：https://mrs-samples-bootstrap-cn-north-1.obs.cn-north-1.myhuaweicloud.com/zeppelin/zeppelin_install.sh 华东-上海二：https://mrs-samples-bootstrap-cn-east-2.obs.cn-east-2.myhuaweicloud.com/zeppelin/zeppelin_install.sh 华南-广州：https://mrs-samples-bootstrap-cn-south-1.obs.cn-south-1.myhuaweicloud.com/zeppelin/zeppelin_install.sh 华北-北京四：https://mrs-samples-bootstrap-cn-north-4.obs.cn-north-4.myhuaweicloud.com/zeppelin/zeppelin_install.sh 引导操作执行完成后，可用如下方法验证正确安装了zeppelin。 第一种：可以root远程登录集群Active Master节点，执行/home/apache/zeppelin-0.7.3-bin-all/bin/zeppelin-daemon.sh status，结果显示“Zeppelin is running [ OK ]"，则表示安装成功。 第二种：在同一个VPC启动一个Windows云服务器，访问集群Active Master节点的7510端口，能访问到Zeppelin的页面，说明安装成功。

补丁基本信息 表1 补丁基本信息 补丁号 MRS 1.7.1.3 发布时间 2018-09-18 解决的问题 MRS Manager MRS Manager新增运维通道功能。 MRS Manager单击审计日志详细信息下载报错。 MRS Manager界面中主机列表下的磁盘使用率计算优化。 Kafka组件问题 KAFKA-5413 Kafka日志清理失败：segment文件offset跨度过大。 KAFKA-6529 客户端异常断开场景，Broker内存泄露。 KAFKA-5417 并发场景下，客户端连接状态不一致。 Hbase问题 HBase解决每次执行balance命令，重复计算region location的问题。 补丁兼容关系 包含1.7.1.3及之前发布的所有补丁解决的问题。

安装补丁的影响 安装补丁后需要重启服务才能生效，重启服务期间引起服务暂不可用。 安装补丁后，需要重新下载安装全量的客户端，包含Master节点的原始客户端和虚拟私有云的其他节点使用的客户端（即您自行搭建的客户端）。 主Master节点的原始客户端全量更新，请参见全量更新主Master节点的原始客户端。 备Master节点的原始客户端全量更新，请参见全量更新备Master节点的原始客户端。 自行搭建的客户端全量安装方法，请参见安装客户端（3.x之前版本）。 重新安装客户端前建议先对老客户端进行备份。 若您根据业务场景修改过客户端配置，请重装客户端后再次修改客户端配置。

注意事项 由于1.7.1 集群的健康检查中存在一项误报，而补丁安装前会进行集群的健康检查。从而导致客户第一次提交安装补丁后，提示集群异常，补丁安装终止。在确认报错是误报后，客户可以再次提交安装补丁请求，第二次安装补丁会跳过健康检查，进行补丁安装。 误报内容可以通过如下方式确认： 查看并导出检查报告，健康检查结果上只存在这两个主机报错：“安装目录及数据目录检查： 目录下文件异常. 请检查安装目录和数据目录下的内容”。 图1 健康检查的结果

操作步骤 登录主管理节点。 执行以下命令切换用户： sudo su - root su - omm 执行以下命令在主管理节点“${ OMS _RUN_PATH}/workspace0/ha/local/cert”目录生成“root-ca.crt”和“root-ca.pem”： sh ${OMS_RUN_PATH}/workspace/ha/module/hacom/script/gen-cert.sh --root-ca --country=country --state=state --city=city --company=company --organize=organize --common-name=commonname --email=管理员邮箱 --password=password 命令中如果携带认证密码信息可能存在安全风险，在执行命令前建议关闭系统的history命令记录功能，避免信息泄露。 例如，执行以下命令：sh ${OMS_RUN_PATH}/workspace/ha/module/hacom/script/gen-cert.sh --root-ca --country=CN --state=gd --city=sz --company=hw --organize=IT --common-name=HADOOP.COM --email=abc@hw.com --password=xxx 提示以下信息表示命令执行成功： Generate root-ca pair success. 在主管理节点以“omm”用户执行以下命令，复制“root-ca.crt”和“root-ca.pem”到“${BIGDATA_HOME}/om-0.0.1/security/certHA”目录。 cp -arp ${OMS_RUN_PATH}/workspace0/ha/local/cert/root-ca.* ${BIGDATA_HOME}/om-0.0.1/security/certHA 使用“omm”用户将主管理节点生成的“root-ca.crt”和“root-ca.pem”复制到备管理节点“${BIGDATA_HOME}/om-0.0.1/security/certHA”目录。 执行以下命令，生成HA用户证书并自动替换。 sh ${BIGDATA_HOME}/om-0.0.1/sbin/replacehaSSLCert.sh 根据提示信息输入password，并按回车键确认。 Please input ha ssl cert password: 界面提示以下信息表示HA用户证书替换成功： [INFO] Succeed to replace ha ssl cert. 执行以下命令，重启OMS。 sh ${BIGDATA_HOME}/om-0.0.1/sbin/restart-oms.sh 界面提示以下信息： start HA successfully. 登录备管理节点并切换到omm用户，重复6～7。 执行sh ${BIGDATA_HOME}/om-0.0.1/sbin/status-oms.sh，查看管理节点的“HAAllResOK”是否为“Normal”，并可以重新访问MRS Manager表示操作成功。

返回结果 表5 返回结果 类型 说明 GetResult 参数解释： SDK公共结果对象。 表6 GetResult 参数名称 参数类型 描述 status int 参数解释： HTTP状态码。 取值范围： 状态码是一组从2xx（成功）到4xx或5xx（错误）的数字代码，状态码表示了请求响应的状态。完整的状态码列表请参见状态码。 默认取值： 无 reason str 参数解释： HTTP文本描述。 默认取值： 无 errorCode str 参数解释： OBS服务端错误码，当status参数小于300时为空。 默认取值： 无 errorMessage str 参数解释： OBS服务端错误描述，当status参数小于300时为空。 默认取值： 无 requestId str 参数解释： OBS服务端返回的请求ID。 默认取值： 无 indicator str 参数解释： OBS服务端返回的错误定位码。 默认取值： 无 hostId str 参数解释： 请求的服务端ID，当status参数小于300时为空。 默认取值： 无 resource str 参数解释： 发生错误时相关的桶或对象，当status参数小于300时为空。 默认取值： 无 header list 参数解释： 响应消息头列表，由多个元组构成。每个元组均包含两个元素，代表响应头的键值对。 默认取值： 无 body object 参数解释： 操作成功后的结果数据，当status大于300时为空。该值根据调用接口的不同而不同，参见“桶相关接口”章节和“对象相关接口”章节的详细描述。 默认取值： 无

接口约束 您必须是桶拥有者或拥有下载对象的权限，才能下载对象。建议使用 IAM 或桶策略进行授权，如果使用IAM则需授予obs:object:GetObject权限，如果使用桶策略则需授予GetObject权限。相关授权方式介绍可参见OBS权限控制概述，配置方式详见使用IAM自定义策略、配置对象策略。 OBS支持的Region与Endpoint的对应关系，详细信息请参见地区与终端节点。 对于存储类别为归档存储的对象，需要确认对象的状态为“已恢复”才能对其进行下载。

方法定义 ObsClient.downloadFiles(bucketName, prefix, downloadFolder, taskNum, taskQueueSize, headers, imageProcess, interval, taskCallback, progressCallback, threshold, partSize, subTaskNum, enableCheckpoint, checkpointFile)

代码样例 1 2 3 4 5 6 7 8 9 try: resp = obsClient.downloadFiles(bucketName='bucketname', prefix='objectkey', downloadFolder='localFolder') result = "DownloadFiles summary : total_task:%d, success:%d ,failure:%d" % (resp.total_tasks, resp.successful_tasks, resp.failed_tasks) print(result) except: import traceback print(traceback.format_exc())

资源和成本 表1 资源和成本规划 资源 资源说明 数量 每月费用 OBS 算子请求OBS API。 1 通过算子对数据进行处理，都会涉及到对OBS API的调用，每调用一次API都计算一次请求次数。 对象存储服务 OBS会根据调用API的请求次数进行费用收取，收取详情参见OBS请求费用说明。 FunctionGraph函数 算子使用FunctionGraph 函数工作流 。 1 通过算子对数据进行处理，会使用到函数工作流的资源，比如算子执行时长，函数工作流会根据资源使用情况进行收费，收费详情参见函数工作流计费说明。 视频转码 新建转码任务可以将视频进行转码，并在转码过程中压制水印、视频截图等。视频转码前需要配置转码模板。 待转码的音视频需要存储在与 媒体处理 服务同区域的OBS桶中，且该OBS桶已授权。 1 由媒体处理服务MPC进行收费，详情查看计费说明。

按需计费的EIP费用 按需计费的EIP费用由弹性公网IP保有费和固定带宽费用组成。 表1 按需计费的EIP费用组成 计费项 计费说明 弹性公网IP保有费 已购买的EIP未绑定云资源时，会收取弹性公网IP保有费，即IP保有费。 固定带宽费用 （不同计费方式有不同的计费主体） 按需计费（按带宽计费）的带宽费用 按需计费（按流量计费）的流量费用 共享带宽费用 不同的EIP资源状态，EIP的费用不同。具体参见表2。 表2 按需计费EIP在不同资源状态的费用 EIP资源状态 按需计费（按带宽计费） 按需计费（按流量计费） 按需计费（加入共享带宽） 未绑定EIP计费 弹性公网IP保有费 带宽费 弹性公网IP保有费 弹性公网IP保有费 共享带宽费 绑定EIP计费 带宽费 说明： 无论EIP绑定的实例是否运行，都会收取带宽费，比如E CS 关机后，会继续收取带宽费，不收取弹性公网IP保有费。 流量费 说明： EIP绑定的实例停止运行后，不产生流量则不收取流量费，比如ECS关机后，停止收取流量费，不收取弹性公网IP保有费。 共享带宽费 解绑EIP计费 弹性公网IP保有费 带宽费 弹性公网IP保有费 弹性公网IP保有费 共享带宽费 释放EIP计费 停止收取带宽费和弹性公网IP保有费。 停止收取流量费和弹性公网IP保有费。 停止收取弹性公网IP保有费。 删除共享带宽，停止收取带宽费。

成本优化 成本控制 企业可以在成本中心的“预算管理”页面创建精细粒度的预算来管理成本和使用量，在实际或预测超过预算阈值时，自动发送通知给指定消息接收人。企业还可以创建预算报告，定期将指定预算进展通知给指定消息接收人。 例如企业需要创建一个弹性公网IP的按需成本预算，每月预算金额为10000元，当预测金额高于预算金额的80%时发送预算告警。那么，创建的预算如下： 图4 预算基本信息 图5 设置成本范围 图6 设置提醒 详细介绍请参见使用预测和预算来跟踪成本和使用量。 资源优化 您可以通过 云监控服务 监控资源的使用情况，识别空闲资源，寻找节约成本的机会。也可以根据成本分析阶段的分析结果识别成本偏高的资源，然后采取针对性的优化措施。 监控资源利用率，评估当前配置是否过高。例如：带宽等资源的利用率。 监控闲置的资源，避免浪费。例如：未绑定的EIP等。 计费模式优化 不同类型的业务对资源使用周期有不同的要求，为每一类业务确定合适的计费模式，灵活组合以达到最优效果。 针对长期稳定的成熟业务，使用包年/包月计费模式。 针对不能中断的短期、突增或不可预测的业务，使用按需计费模式。 实现自动化运维 华为云也提供了丰富的运维类产品，帮助您提升运维效率，降低运维的人力成本。例如： 弹性伸缩：持续动态维护按需类带宽资源。适合业务负载存在峰谷波动的场景。 智能购买组：组合计算存储服务，一键部署跨计费模式、跨可用区和跨实例规格的实例集群。适合需要快速交付稳定算力，同时使用竞价实例降低成本的场景。 资源编排 ：一键部署并维护包含多种云资源和依赖关系的资源栈。适合交付整体系统、克隆环境等场景。 自动化运维：以服务化的方式定义一组运维操作，高效执行运维任务。适合定时运维、批量运维、跨地域运维等场景。

成本分配 成本管理的基础是树立成本责任制，让各部门、各业务团队、各责任人参与进来，为各自消耗云服务产生的成本负责。企业可以通过成本分配的方式，将云上成本分组，归集到特定的团队或项目业务中，让各责任组织及时了解各自的成本情况。 华为云成本中心支持通过多种不同的方式对成本进行归集和重新分配，您可以根据需要选择合适的分配工具。 通过关联账号进行成本分配 企业主客户可以使用关联账号对子客户的成本进行归集，从而对子账号进行财务管理。详细介绍请参见通过关联账号维度查看成本分配。 通过企业项目进行成本分配 在进行成本分配之前，建议开通企业项目并做好企业项目的规划，可以根据企业的组织架构或者业务项目来划分。在购买EIP时选择指定企业项目，新购EIP将按此企业项目进行成本分配。详细介绍请参见通过企业项目维度查看成本分配。 图2 为弹性公网IP选择企业项目 通过成本标签进行成本分配 标签是华为云为了标识云资源，按各种维度（例如用途、所有者或环境）对云资源进行分类的标记。推荐企业使用预定义标签进行成本归集，具体流程如下： 图3 为弹性公网IP添加标签 详细介绍请参见通过成本标签维度查看成本分配。 使用成本单元进行成本分配 企业可以使用成本中心的“成本单元”来拆分公共成本。公共成本是指多个部门共享的计算、网络、存储或资源包产生的云成本，或无法直接通过企业项目、成本标签分配的云成本。这些成本不能直接归属于单一所有者，因此不能直接归属到某一类别。使用拆分规则，可以在各团队或业务部门之间公平地分配这些成本。详细介绍请参见使用成本单元查看成本分配。

编写Workflow Workflow的编写主要在于每个节点的定义，您可以参考节点类型章节，按照自己的场景需求选择相应的代码示例模板进行修改。编写过程主要分为以下几个步骤。 梳理场景，了解预置Step的功能，确定最终的DAG结构。 单节点功能，如训练、推理等在ModelArts相应服务中调试通过。 根据节点功能选择相应的代码模板，进行内容的补充。 根据DAG结构编排节点，完成Workflow的编写。 父主题： 如何开发Workflow

开发态 开发态主要是指使用Workflow的Python SDK开发和调试工作流，使用上具有一定的门槛，适用于MLOps相关的开发者。该使用方式对于AI开发者来说是非常熟悉的一种开发模式，而且灵活度极高，主要提供以下能力。 开发构建：使用python代码灵活编排构建工作流。 调试：支持debug以及run两种模式，其中run模式支持节点部分运行、全部运行。 发布：支持将调试后的工作流进行固化，发布至运行态，支持配置运行。 共享：支持将工作流作为资产发布至AI Gallery，分享给其他用户使用。 父主题： 核心概念

从AI Gallery订阅的Workflow如何使用 登录AI Gallery的Workflow案例库 从AI Gallery的Workflow资产页面，选择并订阅一个Workflow，勾选“我已阅读 《数据安全与隐私风险承担条款》 和 《华为云AI Gallery服务协议》”后，单击“继续订阅” 订阅完成后，单击“运行”后跳转到ModelArts控制台界面，选择资产版本、Workflow名称、云服务区域以及工作空间，单击“导入”，进入该Workflow的详情页面。 图2 从AI Gallery导入工作流 单击右上角的“配置”后进入配置页面，根据您所订阅的工作流，配置Workflow需要的部分输入项和参数，参考表1，参数配置完成后，单击右上角的“保存配置”。 保存成功后，单击右上角的“启动”，启动Workflow。 Workflow进入运行页面，等待Workflow运行。 每一个节点运行状况页面的“状态”为此节点的运行状态，运行成功会自动执行下一个节点的运行，直至所有节点运行成功，代表Workflow完成运行。 图3 完成运行

响应示例 状态码为 200 时: 请求成功。 { "api_acl_policy" : { "allow_ip_ranges" : [ { "ip_range" : "0.0.0.0-255.255.255.255", "description" : "" }, { "ip_range" : "0.0.0.0-255.255.255.255", "description" : "" } ], "allow_address_netmasks" : [ { "address_netmask" : "192.168.0.1/24", "description" : "" }, { "address_netmask" : "192.168.0.1/24", "description" : "" } ] } }

请求示例 修改帐号的接口访问策略：允许访问的IP地址区间为“0.0.0.0-255.255.255.255”。 PUT https://iam.myhuaweicloud.com/v3.0/OS-SECURITYPOLICY/domains/{domain_id}/api-acl-policy { "api_acl_policy" : { "allow_ip_ranges" : [ { "ip_range" : "0.0.0.0-255.255.255.255", "description" : "1" }, { "ip_range" : "0.0.0.0-255.255.255.253", "description" : "12" } ], "allow_address_netmasks" : [ { "address_netmask" : "192.168.0.1/24", "description" : "3" }, { "address_netmask" : "192.168.0.2/23", "description" : "4" } ] } }

响应参数 表7 响应Body参数 参数 参数类型 描述 api_acl_policy object 接口访问控制策略。 表8 api_acl_policy 参数 参数类型 描述 allow_address_netmasks objects 允许访问的IP地址或网段。 allow_ip_ranges objects 允许访问的IP地址区间。 表9 allow_address_netmasks 参数 参数类型 描述 address_netmask String IP地址或网段，例如:192.168.0.1/24。 description String 描述信息。 表10 allow_ip_ranges 参数 参数类型 描述 description String 描述信息。 ip_range String IP地址区间，例如:0.0.0.0-255.255.255.255。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 访问令牌，承载用户的身份、权限等信息。 token所需权限请参见授权项。 表3 请求Body参数 参数 是否必选 参数类型 描述 api_acl_policy 是 object 接口访问控制策略。 表4 api_acl_policy 参数 是否必选 参数类型 描述 allow_address_netmasks 否 Array of objects 允许访问的IP地址或网段。 allow_address_netmasks与allow_ip_ranges两个参数二选一即可。 allow_ip_ranges 否 Array of objects 允许访问的IP地址区间。 allow_address_netmasks与allow_ip_ranges两个参数二选一即可。 表5 allow_address_netmasks 参数 是否必选 参数类型 描述 address_netmask 是 String IP地址或网段，例如:192.168.0.1/24。 description 否 String 描述信息。 表6 allow_ip_ranges 参数 是否必选 参数类型 描述 description 否 String 描述信息。 ip_range 是 String IP地址区间，例如:0.0.0.0-255.255.255.255。

响应示例 状态码为 200 时: 请求成功。 { "console_acl_policy" : { "allow_ip_ranges" : [ { "ip_range" : "0.0.0.0-255.255.255.255", "description" : "" }, { "ip_range" : "0.0.0.0-255.255.255.255", "description" : "" } ], "allow_address_netmasks" : [ { "address_netmask" : "192.168.0.1/24", "description" : "" }, { "address_netmask" : "192.168.0.1/24", "description" : "" } ] } }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 访问令牌，承载用户的身份、权限等信息。 token所需权限请参见授权项。 表3 请求Body参数 参数 是否必选 参数类型 描述 console_acl_policy 是 object 控制台访问控制策略。 表4 console_acl_policy 参数 是否必选 参数类型 描述 allow_address_netmasks 否 Array of objects 允许访问的IP地址或网段。allow_address_netmasks与 allow_ip_ranges两个参数二选一即可。 allow_ip_ranges 否 Array of objects 允许访问的IP地址区间。allow_address_netmasks与 allow_ip_ranges两个参数二选一即可。 表5 allow_address_netmasks 参数 是否必选 参数类型 描述 address_netmask 是 String IP地址或网段，例如:192.168.0.1/24。 description 否 String 描述信息。 表6 allow_ip_ranges 参数 是否必选 参数类型 描述 description 否 String 描述信息。 ip_range 是 String IP地址区间，例如:0.0.0.0-255.255.255.255。

请求示例 修改帐号的控制台访问策略：允许访问的IP地址区间为“0.0.0.0-255.255.255.255”。 PUT https://iam.myhuaweicloud.com/v3.0/OS-SECURITYPOLICY/domains/{domain_id}/console-acl-policy { "console_acl_policy" : { "allow_ip_ranges" : [ { "ip_range" : "0.0.0.0-255.255.255.255", "description" : "1" }, { "ip_range" : "0.0.0.0-255.255.255.253", "description" : "12" } ], "allow_address_netmasks" : [ { "address_netmask" : "192.168.0.1/24", "description" : "3" }, { "address_netmask" : "192.168.0.2/23", "description" : "4" } ] } }

响应参数 表7 响应Body参数 参数 参数类型 描述 console_acl_policy object Console访问控制策略。 表8 console_acl_policy 参数 参数类型 描述 allow_address_netmasks Array of objects 允许访问的IP地址或网段。 allow_ip_ranges Array of objects 允许访问的IP地址区间。 表9 allow_address_netmasks 参数 参数类型 描述 address_netmask String IP地址或网段，例如:192.168.0.1/24。 description String 描述信息。 表10 allow_ip_ranges 参数 参数类型 描述 description String 描述信息。 ip_range String IP地址区间，例如:0.0.0.0-255.255.255.255。

请求示例 创建一个托管物理连接，设置带宽为10，VLAN为441。 POST https://{dc_endpoint}/v3/6fbe9263116a4b68818cf1edce16bc4f/dcaas/hosted-connects { "hosted_connect" : { "name" : "client-dc-faf1", "description" : "", "resource_tenant_id" : "0605768a3300d5762f82c01180692873", "hosting_id" : "2cfb53be-b05f-40d5-a2f8-3a59ac383836", "vlan" : 441, "bandwidth" : 10 } }

响应示例 状态码： 201 CREATED { "hosted_connect" : { "id" : "0278b472-ffa5-4eb3-8c0d-979d479f8ef6", "name" : "client-dc-faf1", "description" : "", "tenant_id" : "0605768a3300d5762f82c01180692873", "hosting_id" : "2cfb53be-b05f-40d5-a2f8-3a59ac383836", "vlan" : 441, "bandwidth" : 10, "location" : "hangzhou", "peer_location" : "", "provider" : "client-dc-faf1%20\n\n", "provider_status" : "ACTIVE", "status" : "ACTIVE", "apply_time" : "2022-07-13T08:25:38.000Z", "admin_state_up" : true, "create_time" : "2022-07-13T08:25:38.000Z" }, "request_id" : "a59a3776faa1d055f8124dc7b0977a90" }

响应参数 状态码： 201 表5 响应Body参数 参数 参数类型 描述 request_id String 操作请求ID hosted_connect HostedDirectConnect object 托管专线对象信息 表6 HostedDirectConnect 参数 参数类型 描述 id String 托管专线ID 最小长度：36 最大长度：36 tenant_id String 实例所属项目ID name String 物理专线名称 最小长度：0 最大长度：64 description String 物理专线的描述信息 最小长度：0 最大长度：128 bandwidth Integer 物理专线接入带宽 单位：Mbps 最小值：2 最大值：400000 location String 专线的接入位置信息 最小长度：0 最大长度：255 peer_location String 物理专线对端所在的物理位置，省/市/街道或IDC名称。 最小长度：0 最大长度：255 hosting_id String hosted物理专线对应的hosting物理专线的ID provider String 专线线路的提供商 admin_state_up Boolean 管理状态：true或false 缺省值：true vlan Integer hosted物理专线预分配的vlan。 最小值：0 最大值：3999 status String 资源状态，合法值是：ACTIVE，DOWN，BUILD，ERROR，PENDING_DELETE，DELETED，APPLY，DENY，PENDING_PAY，PAID，PENDING_SURVEY 枚举值： BUILD：申请专线正在施工建设中 PAID：已支付 APPLY：申请开通 PENDING_SURVEY：待工勘 ACTIVE：专线已经开通完成且线路处于正常状态 DOWN：专线对应的端口处于down的状态，可能存在线路故障等异常。 ERROR：专线配置异常，请联系客服解决相关问题 PENDING_DELETE：正在删除 DELETED：已删除 DENY：客户需求无法满足，拒绝工勘。 PENDING_PAY：待支付 apply_time String 物理专线申请时间 create_time String 物理专线创建时间 provider_status String 物理专线的运营商操作状态，合法值是：ACTIVE， DOWN 枚举值： ACTIVE DOWN

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 获取Token ，请参考《 统一身份认证 服务API参考》的“获取用户Token”章节。请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。 最小长度：0 最大长度：10240 表3 请求Body参数 参数 是否必选 参数类型 描述 hosted_connect 是 CreateHostedDirectConnect object 创建托管专线参数对象 表4 CreateHostedDirectConnect 参数 是否必选 参数类型 描述 name 否 String 托管物理专线的名称 最小长度：0 最大长度：64 description 否 String 托管专线的描述信息 最小长度：0 最大长度：128 bandwidth 是 Integer 指定托管专线接入带宽 单位：Mbps 最小值：2 最大值：400000 hosting_id 是 String hosted物理专线对应的hosting物理专线的ID vlan 是 Integer 指定托管(hosted)专线预分配的vlan 最小值：0 最大值：3999 resource_tenant_id 是 String 为其他租户创建托管专线，指定对应的租户ID 最小长度：0 最大长度：32 peer_location 否 String 物理专线对端所在的物理位置，省/市/街道或IDC名称。 最小长度：0 最大长度：255

响应示例 状态码： 200 OK { "request_id" : "a59a3776faa1d055f8124dc7b0977a90", "hosted_connects" : [ { "id" : "0278b472-ffa5-4eb3-8c0d-979d479f8ef6", "name" : "client-dc-faf1", "description" : "", "tenant_id" : "0605768a3300d5762f82c01180692873", "hosting_id" : "2cfb53be-b05f-40d5-a2f8-3a59ac383836", "vlan" : 441, "bandwidth" : 10, "location" : "hangzhou", "peer_location" : "", "provider" : "client-dc-faf1%20\n\n", "provider_status" : "ACTIVE", "status" : "ACTIVE", "apply_time" : "2022-07-13T08:25:38.000Z", "admin_state_up" : true, "create_time" : "2022-07-13T08:25:38.000Z" } ] }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 request_id String 本次操作的请求ID hosted_connects Array of HostedDirectConnect objects 托管专线对象信息 page_info PageInfo object 分页查询页的信息 表5 HostedDirectConnect 参数 参数类型 描述 id String 托管专线ID 最小长度：36 最大长度：36 tenant_id String 实例所属项目ID name String 物理专线名称 最小长度：0 最大长度：64 description String 物理专线的描述信息 最小长度：0 最大长度：128 bandwidth Integer 物理专线接入带宽 单位：Mbps 最小值：2 最大值：400000 location String 专线的接入位置信息 最小长度：0 最大长度：255 peer_location String 物理专线对端所在的物理位置，省/市/街道或IDC名称。 最小长度：0 最大长度：255 hosting_id String hosted物理专线对应的hosting物理专线的ID provider String 专线线路的提供商 admin_state_up Boolean 管理状态：true或false 缺省值：true vlan Integer hosted物理专线预分配的vlan。 最小值：0 最大值：3999 status String 资源状态，合法值是：ACTIVE，DOWN，BUILD，ERROR，PENDING_DELETE，DELETED，APPLY，DENY，PENDING_PAY，PAID，PENDING_SURVEY 枚举值： BUILD：申请专线正在施工建设中 PAID：已支付 APPLY：申请开通 PENDING_SURVEY：待工勘 ACTIVE：专线已经开通完成且线路处于正常状态 DOWN：专线对应的端口处于down的状态，可能存在线路故障等异常。 ERROR：专线配置异常，请联系客服解决相关问题 PENDING_DELETE：正在删除 DELETED：已删除 DENY：客户需求无法满足，拒绝工勘。 PENDING_PAY：待支付 apply_time String 物理专线申请时间 create_time String 物理专线创建时间 provider_status String 物理专线的运营商操作状态，合法值是：ACTIVE， DOWN 枚举值： ACTIVE DOWN 表6 PageInfo 参数 参数类型 描述 previous_marker String 上一页的marker，值为资源的uuid 最小长度：0 最大长度：36 current_count Integer 当前列表中资源数量 最小值：0 最大值：2000 next_marker String 下一页的marker，值为资源的uuid，为空时表示最后一页 最小长度：0 最大长度：36