华为云用户手册

解决办法 如果用户是在登录ISCDesk时出现网络异常，那么需要用户检查网络，待网络恢复后再重新登录。此时单击登录页展示的“离线使用本地应用”，可以查看和使用本地已安装的应用。 如果用户是在使用ISCDesk过程中出现网络异常，那么ISCDesk右上角会提示“当前网络不可用，您已离线，请检查网络状态！”，工具软件也会弹出“网络异常”的提醒。此时用户仍可以看到ISCDesk首页展示的内容，但是无法下载安装工具软件。

如何使用工业数字模型驱动引擎？ 注册华为账号并完成实名认证后，需要开通工业数字模型驱动引擎（Industrial Digital Model Engine，简称iDME）并授权才可使用iDME。 如果您是首次使用iDME，可在控制台免费开通iDME 设计服务，具体操作请参见免费开通iDME设计服务。 如果您需要使用数据建模引擎，可先在控制台购买数据建模引擎，具体操作请参见购买数据建模引擎。 如果您需要使用数字主线引擎，可先在控制台开通数字主线引擎，具体操作请参见开通数字主线引擎。 如果您已开通以上资源，即可使用iDME进行一些常用操作，具体请参见工业数字模型驱动引擎。 父主题： 一般性相关问题

弹性云服务器关机后还会计费吗？ 弹性云服务器支持多种计费模式，不同计费模式的弹性云服务器的关机策略不同。 包年/包月：按订单周期计费，属于预付费资源，关机对计费无影响。 竞价计费（竞享模式）：按实际使用时长和选择的保障周期对应价格计费，虽然属于后付费资源，但关机后仍然正常计费。 按需计费、竞价计费（竞价模式）：按实际使用时长计费，属于后付费资源，关机后是否计费，与实例类型有关，详细的关机计费策略，如表1所示。 表1 关机计费策略 实例类型 实例说明 资源计费项 关机是否计费 关机后资源处理 普通实例 普通实例包括： 非裸金属实例 不含本地盘的实例 不含FPGA卡的实例 云服务器（计算资源，包括vCPU和内存） 不计费 公共资源池创建的实例，基础资源（vCPU、内存）不再保留。 当再次启动云服务器时，可能由于资源不足无法正常开机，请耐心等待，稍后再试。 基于专属资源或边缘可用区创建的实例，基础资源（vCPU、内存）仍会保留。 镜像 不计费 资源保留，不计费，不进行处理。 GPU 不计费 不含本地盘的“GPU加速型”实例，关机后GPU资源不再保留。 云硬盘（系统盘和数据盘） 计费 不受关机影响，仍然按资源计费原则正常计费。 带宽 计费 特殊实例 特殊实例包括： 裸金属实例 含本地盘的实例 如磁盘增强型、超高I/O型、H2型、P1型、P2型等。 含FPGA卡的实例 如Fp1型、Fp1c型。 云服务器（计算资源，包括vCPU和内容） 计费 不受关机影响，仍然按资源计费原则正常计费。 如需停止计费，需删除实例及其绑定资源。 镜像 计费 GPU 计费 云硬盘（系统盘和数据盘） 计费 带宽 计费 按需付费的弹性云服务器关机再次开机时，可能会出现由于资源不足引起的启动失败，请过一段时间再次启动，或更改弹性云服务器规格。 按需付费实例停止计费请参考弹性云服务器怎样停止计费？。 如果您需要长期使用当前弹性云服务器，可以将按需购买的云服务器转为包年/包月计费模式，节省开支。具体操作，请参考按需转包年/包月。 父主题： 收费标准类

包年/包月和按需计费模式是否支持互相切换？ 华为云支持包年/包月和按需计费模式互相切换。 图1 ECS计费模式变更 按需计费转换为包年/包月： 按需计费是后付费模式，按弹性云服务器的实际使用时长计费，可以随时开通/删除弹性云服务器。 如果您需要长期使用当前弹性云服务器，可以将按需购买的云服务器转为包年/包月计费模式，节省开支。具体操作，请参考按需转包年/包月。 包年/包月转换为按需计费： 包年/包月是预付费模式，按订单的购买周期计费，适用于可预估资源使用周期的场景。 如果您需要更灵活的计费方式，按照弹性云服务器的实际使用时长计费，您可以将实例的计费方式转为按需付费。包年/包月转按需，按需的计费模式立即生效。具体操作，请参考包年/包月转按需。 只有通过实名认证的客户，才可以执行包年/包月转按需操作。 在续费管理页面，订单状态是“使用中”的云服务器资源才能执行包年/包月转按需。 解决方案组合产品不支持包年/包月转按需。 已开票资源不支持包年/包月转按需。 父主题： 收费标准类

成本优化 成本控制 企业可以在成本中心的“预算管理”页面创建精细粒度的预算来管理成本和使用量，在实际或预测超过预算阈值时，自动发送通知给指定消息接收人。企业还可以创建预算报告，定期将指定预算进展通知给指定消息接收人。 例如企业需要创建一个弹性云服务器的按需成本预算，每月预算金额为2000元，当预测金额高于预算金额的80%时发送预算告警。那么，创建的预算如下： 图2 预算基本信息 图3 设置成本范围 图4 设置提醒 详细介绍请参见使用预测和预算来跟踪成本和使用量。

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

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

欠费影响 按需计费 账户因自动扣费导致欠费后，或者账单逾期，都将进入宽限期，KooMessage不会立即停止用户使用相应的功能。 产品进入宽限期，用户需要支付KooMessage在宽限期内产生的费用，华为云将在充值后自动扣取欠费金额。 宽限期到期时，如果用户未支付账户欠款，产品进入保留期，保留期内不计费。 用户在保留期内支付账户欠款，解除冻结后，仍可继续正常使用相应的功能。 图1 按需计费生命周期 套餐包 用户使用套餐包，已经预先支付了套餐包费用，因此在账户出现欠费或者账单逾期的情况下，已有的套餐包仍可正常使用。然而，对于涉及费用的操作，如新购套餐包等，用户将无法正常进行。 用户已购买套餐包，续费时因余额不足会出现续费不成功，用户应及时充值，保证账户余额充足。 宽限期和保留期的详细介绍，请参见宽限期保留期。 华为云根据客户等级定义了不同客户的宽限期和保留期时长。

购买产品套餐使用后，短信和智能解析完全不匹配，短信条数使用完，解析条数仍剩余？ 如果仅解析条数剩余，默认情况下，这条解析在套餐包里面扣除余量，短信按需计费。例如，在含短信套餐包仅剩余解析条数的情况下，用户发一条智能短信（一条短信+一条解析），这条解析在套餐包里面扣除余量，短信按需计费。智能信息创建发送任务时，需要上传手机号码并对号码解析如图1，会出现不可解析的号码，因此会出现降级发送短信，解析条数因此剩余。 图1 号码解析情况 不可解析智能信息号码数，有三类： 不发送：选择不发送，不扣除智能信息、智能信息基础版发送条数。 降级为普通短信：智能信息内容以普通短信方式发送，扣除智能信息发送条数，不扣除解析条数。 发送智能信息基础版：选择发送智能信息基础版，扣除智能信息基础版发送条数。 用户发送一条长短信，平台会按照长短信拆分后短信条数进行业务统计和计费，详情请参见短信内容长度计算规则。

套餐包到期 购买后，在计费周期内正常使用套餐包，此阶段为有效期；套餐包到期而未续费时，将陆续进入宽限期和保留期。 图4 套餐包生命周期 到期预警 套餐包到期前第7天内，系统将向用户推送到期预警消息。预警消息将通过邮件、短信和站内信的方式通知到华为账号的创建者。 到期影响 按需套餐包到期后，在账户余额充足情况下，不会影响用户使用KooMessage服务。 用尽即停套餐包到期后，会影响用户使用KooMessage服务。 宽限期和保留期的详细介绍，请参见宽限期保留期。 华为云根据客户等级定义了不同客户的宽限期和保留期时长。

套餐包详情 用户可以根据实际需求购买套餐包获取更多的优惠。 按需套餐包 KooMessage服务提供的按需套餐包如表1所示。用户根据诉求，选择合适的套餐包，用户可以通过价格计算器，快速计算出购买的参考价格。 表1 按需套餐包 适用项 套餐包类型 描述 使用限制 智能信息 智能信息解析 企业使用已有短信发送通道，KooMessage只做智能信息解析。 不同类型的短信模板，扣除不同套餐包内的额度。 智能信息发送和解析-通知类 企业使用KooMessage发送验证码和通知短信并做智能信息解析。 智能信息发送和解析-营销类 企业使用KooMessage发送营销短信并做智能信息解析。 智能信息通道 验证码和通知短信补充包 企业使用KooMessage发送验证码和通知短信。 营销短信补充包 企业使用KooMessage发送营销短信。 智能信息基础版 智能信息基础版（三网通道） 三网通道发送短信，移动、联通、电信号码均可发送，要求移动号码发送量占比不低于75%。 - 智能信息服务号 - 用户点击智能信息服务号的菜单一次，为一次点击。 目前只支持华为手机，后续会支持更多的机型。

在工业数字模型驱动引擎中，IAM和OrgID的区别 基于统一身份认证服务（Identity and Access Management，简称IAM）和组织成员帐号（OrgID）的能力，工业数字模型驱动引擎（Industrial Digital Model Engine，简称iDME）实现了对不同iDME商品的访问控制。您可以通过下表对比项，了解这两个服务的具体区别： 表1 IAM与OrgID的差异对比 对比项 IAM OrgID 定义 是华为云提供权限管理的基础服务，可以帮助用户安全地控制云服务和资源的访问权限。 是面向企业提供组织管理、企业成员账号管理以及SaaS应用授权管理能力的云服务，将Huawei ID账号体系延伸到企业用户，统一华为云面向生态SaaS服务的组织、账号，面向生态伙伴推出SaaS服务账号集成规范。 OrgID开通的相关权限受IAM控制。 账号类型 IAM账号，一般指IAM用户，由开通华为云业务的华为账号创建，完全归属于创建该IAM用户的华为账号。 OrgID使用账号分为个人华为账号、管理式华为账号和第三方认证源账号。 个人华为账号：本身拥有华为账号身份，被邀请作为当前华为账号在OrgID下某组织的成员。 管理式华为账号：由开通华为云业务的华为账号通过OrgID的成员管理创建，完全归属于创建该管理式华为账号的组织。 第三方认证源账号：由第三方认证源提供，组织管理员通过OrgID的认证源管理添加，鉴权认证通过后，可登录OrgID进行后续业务操作。 账号作用 IAM用户会根据华为账号赋予的有限权限范围操作iDME资源，属于资源账号。 可直接访问某个注册在OrgID的iDME应用，或者在OrgID的用户中心免登录访问应用列表中的iDME应用或iDME商品实例。 适用场景 希望对iDME资源进行精细化访问控制。 企业A存在多种iDME资源，希望将部分iDME资源授权给企业B使用。 企业内存在多个应用账号独立，希望企业用户使用一个账号就可以登录所有授权的iDME应用。 允许用户通过三方身份访问iDME商品实例，例如WeLink、oAuth、CAS、OIDC等。 希望应用内跳转其他应用或者域名匹配时，可以直接访问，无需二次登录。 希望统一业务平台和华为云的账号访问。 父主题： 一般性相关问题

企业租户 企业级租户是为了支撑企业级应用，单独为某个企业而开通的租户，是第一层租户。不同企业租户的模型和服务元数据采用逻辑隔离的方式存储在一个数据库。 数字主线引擎购买成功后会自动开通企业租户，即服务购买账号也是开通企业租户的账号。该账号登录数字主线引擎后，系统默认会为其配置企业级管理员。管理员可以给不同职责的用户授予对应租户下的合理角色，能保证用户拥有必要的权限开展相应的工作，避免越权操作和非安全操作。如何管理用户权限详细请参见用户权限管理。

请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 port 是 RemoveSecurityGroupOption object 端口移除安全组请求体 表3 RemoveSecurityGroupOption 参数 是否必选 参数类型 描述 security_groups 是 Array of strings 功能说明：安全组的ID列表； 例如："security_groups": ["a0608cbf-d047-4f54-8b28-cd7b59853fff"]

响应示例 状态码： 200 OK { "port" : { "name" : "", "id" : "99fd0c77-56b4-4bf6-8365-df352e45d5fc", "admin_state_up" : true, "status" : "DOWN", "project_id" : "f5dab68cd75740e68c599e9af5fe0aed", "device_id" : "", "mac_address" : "fa:16:3e:1f:17:df", "device_owner" : "", "description" : "", "vpc_id" : null, "zone_id" : "", "scope" : "center", "position_type" : "center", "vtep_ip" : null, "created_at" : "2023-05-10T01:35:02", "updated_at" : "2023-05-10T01:35:02", "port_security_enabled" : true, "tags" : [ ], "security_groups" : [ "567be4e3-d171-46ce-9e8a-c15e91cfe86a" ], "allowed_address_pairs" : [ ], "extra_dhcp_opts" : [ ], "instance_info" : null, "instance_id" : "", "instance_type" : "", "ecs_flavor" : "", "enable_efi" : false, "virsubnet_id" : "3847b263-2370-45c0-8236-38a1de568049", "private_ips" : [ { "subnet_cidr_id" : "ffe98087-6d4f-45cd-988b-1c87f75d2d53", "ip_address" : "192.168.158.228" } ], "vpc_tenant_id" : null, "binding:host_id" : "", "binding:vif_type" : "unbound", "binding:vnic_type" : "normal", "binding:vif_details" : { }, "binding:profile" : { }, "binding:migration_info" : { } }, "request_id" : "abd08c76-c853-4967-a898-12804330efab" }

请求示例 指定端口移除安全组，移除端口99fd0c77-56b4-4bf6-8365-df352e45d5fc关联的安全组8edd3747-ccd4-49a1-82b9-a165eec314b4、6c2d4540-3b7d-4207-a319-a7231b439995。 PUT https://{Endpoint}/v3/f5dab68cd75740e68c599e9af5fe0aed/ports/99fd0c77-56b4-4bf6-8365-df352e45d5fc/remove-security-groups { "port" : { "security_groups" : [ "8edd3747-ccd4-49a1-82b9-a165eec314b4", "6c2d4540-3b7d-4207-a319-a7231b439995" ] } }

请求参数 表2 请求参数 参数名称 类型 是否必选 说明 tags Array of tag objects 是 tag对象，请参见表3。 action String 是 操作标识： create：创建 delete：删除 表3 tag对象 属性 类型 是否必选 说明 key String 是 标签名称。 不能为空。 长度不超过128个字符(当前控制台操作key长度不超过36个字符)。 由英文字母、数字、下划线、中划线、中文字符组成。 同一资源的key值不能重复。 value String 是 标签值。 长度不超过255个字符(当前控制台操作value长度不超过43个字符)。 由英文字母、数字、下划线、点、中划线、中文字符组成。

请求示例 批量创建两条VPC资源标签，action为create。 POST https://{Endpoint}/v2.0/{project_id}/vpcs/{vpc_id}/tags/action { "action": "create", "tags": [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value3" } ] } 批量删除两条VPC资源标签，action为delete。 POST https://{Endpoint}/v2.0/{project_id}/vpcs/{vpc_id}/tags/action { "action": "delete", "tags": [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value3" } ] }

请求参数 表2 请求参数 参数名称 类型 必选 说明 network network object 是 network对象，参见表3。 更新操作时至少指定一项属性 表3 network对象 属性 是否必选 类型 说明 name 否 String 网络名称。 【使用说明】name不能为admin_external_net（预置网络名称，不可占用）。 admin_state_up 否 Boolean 管理状态。 【使用说明】只支持true。 port_security_enabled 否 Boolean 端口安全使能标记，如果不能使，则network下所有虚机的安全组和dhcp防欺骗不生效

响应参数 表4 响应参数 参数名称 类型 说明 network network object network对象，参见表5。 表5 network对象 属性 类型 说明 status String 网络状态，可以为ACTIVE，BUILD，DOWN或ERROR。 subnets Array of strings 网络关联的子网ID列表。 一个network仅支持关联一个subnet。 name String 网络名称。 name不能为admin_external_net（预置网络名称，不可占用）。 router:external Boolean 扩展属性：是否外部网络，默认值false。 admin_state_up Boolean 管理状态。 只支持true。 tenant_id String 项目ID shared Boolean 是否支持跨租户共享。 id String 网络的id 【使用说明】在查询网络列表时候非必选 provider:network_type String 扩展属性：网络类型。 取值范围：支持租户创建geneve、vxlan类型的网络 租户只能指定此参数为geneve，不指定时网路类型自动分配，一般分配为vxlan类型。预置网络admin_external_net的情况下，此参数为vlan，用户不可配置。 【使用说明】 创建geneve类型的网络，请指定此参数为geneve。 创建vxlan类型的网络，请求时请不要指定此参数。 availability_zone_hints Array of strings 本网络的候选可用域，当前版本不支持可用域调度。 availability_zones Array of strings 本网络的可用域。 port_security_enabled Boolean 端口安全使能标记，如果不使能，则network下所有虚机的安全组和dhcp防欺骗不生效 dns_domain String 默认内网DNS域地址，系统自动生成维护，不支持设置和更新 project_id String 项目ID，请参见获取项目ID。 created_at String 资源创建时间，UTC时间 格式：yyyy-MM-ddTHH:mm:ss updated_at String 资源更新时间，UTC时间 格式：yyyy-MM-ddTHH:mm:ss

请求示例 更新id为c360322d-5315-45d7-b7d2-481f98c56edb的network，名称更新为network-test02。 PUT https://{Endpoint}/v2.0/networks/c360322d-5315-45d7-b7d2-481f98c56edb { "network": { "name": "network-test02" } }

响应示例 { "network": { "id": "c360322d-5315-45d7-b7d2-481f98c56edb", "name": "network-test02", "status": "ACTIVE", "shared": false, "subnets": [], "availability_zone_hints": [], "availability_zones": [ "az2.dc2", "az5.dc5" ], "admin_state_up": true, "tenant_id": "bbfe8c41dd034a07bebd592bf03b4b0c", "project_id": "bbfe8c41dd034a07bebd592bf03b4b0c", "provider:network_type": "vxlan", "router:external": false, "port_security_enabled": true, "created_at": "2018-09-20T01:53:18", "updated_at": "2018-09-20T01:55:47" } }

请求参数 表2 请求参数 参数名称 类型 是否必选 说明 tag tag object 是 tag对象，请参见表3。 表3 tag对象 属性 类型 是否必选 说明 key String 是 标签名称。 不能为空。 长度不超过128个字符(当前控制台操作key长度不超过36个字符)。 由英文字母、数字、下划线、中划线、中文字符组成。 同一资源的key值不能重复。 value String 是 标签值。 长度不超过255个字符(当前控制台操作value长度不超过43个字符)。 由英文字母、数字、下划线、点、中划线、中文字符组成。

响应示例 { "subnet": { "id": "4779ab1c-7c1a-44b1-a02e-93dfc361b32d", "name": "subnet", "description": "", "cidr": "192.168.20.0/24", "dnsList": [ "114.xx.xx.114", "114.xx.xx.115" ], "status": "ACTIVE", "vpc_id": "3ec3b33f-ac1c-4630-ad1c-7dba1ed79d85", "gateway_ip": "192.168.20.1", "ipv6_enable": false, "dhcp_enable": true, "primary_dns": "114.xx.xx.114", "secondary_dns": "114.xx.xx.115", "availability_zone": "aa-bb-cc", "neutron_network_id": "4779ab1c-7c1a-44b1-a02e-93dfc361b32d", "neutron_subnet_id": "213cb9d-3122-2ac1-1a29-91ffc1231a12", "extra_dhcp_opts": [ { "opt_value": "10.100.0.33,10.100.0.34", "opt_name": "ntp" }, { "opt_value": "24h", "opt_name": "addresstime" } ], "tenant_id": "087679f0aa80d32a2f4ec0172f5e902b", "created_at": "2022-12-15T02:42:07", "updated_at": "2022-12-15T02:42:07" } }

响应示例 { "networks": [ { "id": "0133cd73-34d4-4d4c-bf1f-e65b24603206", "name": "3804f26c-7862-43b6-ad3c-48445f42de89", "status": "ACTIVE", "shared": false, "subnets": [ "423796f5-e02f-476f-bf02-2b88c8ddac8b" ], "availability_zone_hints": [], "availability_zones": [ "az2.dc2", "az5.dc5" ], "admin_state_up": true, "tenant_id": "bbfe8c41dd034a07bebd592bf03b4b0c", "project_id": "bbfe8c41dd034a07bebd592bf03b4b0c", "provider:network_type": "vxlan", "router:external": false, "port_security_enabled": true, "created_at": "2018-03-23T03:51:58", "updated_at": "2018-03-23T03:51:58" } ], "networks_links": [ { "rel": "next", "href": "https://{Endpoint}/v2.0/networks?limit=1&marker=0133cd73-34d4-4d4c-bf1f-e65b24603206" }, { "rel": "previous", "href": "https://{Endpoint}/v2.0/subnets?limit=1&marker=0133cd73-34d4-4d4c-bf1f-e65b24603206&page_reverse=True" } ] }

响应参数 表2 响应参数 参数名称 类型 说明 networks Array of network objects network对象列表，参见表3。 networks_links Array of networks_link objects 分页信息，参见表4。 只有在使用limit过滤，并且资源个数超过limit或者资源个数超过2000时（limit默认值），该参数的rel和href取值才会显示为next和其对应的link。 表3 network对象 属性 类型 说明 status String 网络状态，可以为ACTIVE，BUILD，DOWN或ERROR。 subnets Array of strings 网络关联的子网ID。 一个network仅支持关联一个subnet。 name String 网络名称。 name不能为admin_external_net（预置网络名称，不可占用）。 router:external Boolean 扩展属性：是否外部网络，默认值false。 admin_state_up Boolean 管理状态。 只支持true。 tenant_id String 项目ID shared Boolean 是否支持跨租户共享。 id String 网络的id provider:network_type String 扩展属性：网络类型。 取值范围：支持租户创建geneve、vxlan类型的网络 租户只能指定此参数为geneve，不指定时网路类型自动分配，一般分配为vxlan类型。预置网络admin_external_net的情况下，此参数为vlan，用户不可配置。 【使用说明】 创建geneve类型的网络，请指定此参数为geneve。 创建vxlan类型的网络，请求时请不要指定此参数。 availability_zone_hints Array of strings 本网络的候选可用域，当前版本不支持可用域调度。 availability_zones Array of strings 本网络的可用域。 port_security_enabled Boolean 端口安全使能标记，如果不使能，则network下所有虚机的安全组和dhcp防欺骗不生效 dns_domain String 默认内网DNS域地址，系统自动生成维护，不支持设置和更新 project_id String 项目ID，请参见获取项目ID。 created_at String 资源创建时间，UTC时间 格式：yyyy-MM-ddTHH:mm:ss updated_at String 资源更新时间，UTC时间 格式：yyyy-MM-ddTHH:mm:ss 表4 networks_link对象 参数名称 类型 说明 href String API链接 rel String API链接与该API版本的关系

URI GET /v2.0/networks 样例： GET https://{Endpoint}/v2.0/networks?id={network_id}&status={network_status}&name={network_name}&admin_state_up=${admin_state_up}&tenant_id={tenant_id}&shared={is_shared}&provider:network_type={geneve} 分页查询样例： GET https://{Endpoint}/v2.0/networks?limit=2&marker=0133cd73-34d4-4d4c-bf1f-e65b24603206&page_reverse=False 参数说明请参见表1。 表1 参数说明 名称 是否必选 参数类型 说明 id 否 String 按照网络对应的ID过滤查询 name 否 String 按照网络的名称过滤查询 admin_state_up 否 Boolean 按照网络的管理状态过滤查询 取值范围：true or false provider:network_type 否 String 按照网络的类型过滤查询 shared 否 Boolean 按照网络是否支持跨租户共享过滤查询 取值范围：true or false status 否 String 按照网络的状态过滤查询 取值范围：ACTIVE、BUILD、DOWN router:external 否 Boolean 按照网络是否外部网络过滤查询 取值范围：true or false tenant_id 否 String 按照网络所属的项目ID过滤查询 marker 否 String 分页查询的起始资源ID，表示从指定资源的下一条记录开始查询。 marker需要和limit配合使用： 若不传入marker和limit参数，查询结果返回第一页全部资源记录。 若不传入marker参数，limit为10，查询结果返回第1~10条资源记录。 若marker为第10条记录的资源ID，limit为10，查询结果返回第11~20条资源记录。 若marker为第10条记录的资源ID，不传入limit参数，查询结果返回第11条及之后的所有资源记录。 limit 否 Integer 分页查询每页返回的记录个数，取值范围为0~intmax（2^31-1），默认值2000。 limit需要和marker配合使用，详细规则请见marker的参数说明。

响应消息 响应参数 表2 响应参数 名称 参数类型 说明 port port object 端口对象，请参见表3。 表3 port字段说明 名称 参数类型 说明 id String 端口唯一标识 name String 功能说明：端口名称 取值：默认为空，最大长度不超过255 network_id String 功能说明：端口所属网络的ID 约束：必须是存在的网络ID admin_state_up Boolean 功能说明：管理状态 约束：只支持true，默认为true mac_address String 功能说明：端口MAC地址 约束：由系统分配，不支持指定 fixed_ips Array of fixed_ip objects 功能说明：端口IP。例如："fixed_ips": [{"subnet_id": "4dc70db6-cb7f-4200-9790-a6a910776bba", "ip_address": "192.169.25.79"}]，请参见表4。 约束：一个端口只支持一个fixed_ip，且不支持更新。 device_id String 功能说明：端口所属设备ID 约束：不支持设置和更新，由系统自动维护 device_owner String 功能说明：设备所属（DHCP/Router/ lb/Nova） 约束：不支持设置和更新，由系统自动维护 tenant_id String 项目ID。 status String 功能说明：端口状态，Hana硬直通虚拟机端口状态总为DOWN 取值范围：ACTIVE、BUILD、DOWN security_groups Array of strings 安全组的UUID(扩展属性) allowed_address_pairs Array of allow_address_pair objects 功能说明：IP/Mac对列表，allow_address_pair参见表5（扩展属性） 约束：IP地址不允许为 “0.0.0.0” 如果allowed_address_pairs配置地址池较大的CIDR（掩码小于24位），建议为该port配置一个单独的安全组 如果allowed_address_pairs为“1.1.1.1/0”，表示关闭源目地址检查开关 extra_dhcp_opts Array of extra_dhcp_opt objects DHCP的扩展Option(扩展属性)，请参见表6 binding:vif_details Object vif的详细信息， "ovs_hybrid_plug": 是否为ovs/bridge混合模式 binding:profile Object 扩展属性：提供用户设置自定义信息 【使用说明】 internal_elb字段，布尔类型，普通租户可见。只有在创建内网ELB的虚拟IP的网卡时设置为true。普通租户没有权限更改该字段，由系统维护。 举例： {"internal_elb": true} disable_security_groups字段，布尔类型，普通租户可见。默认为false高性能通信场景下，允许指定为true普通租户可见。仅支持创建port和读取时指定。当前仅支持指定为true，不支持指定为false 举例： {"disable_security_groups"：true }， 当前仅支持指定为true，不支持指定为false，指定为true时，FWaaS功能不生效。 binding:vnic_type String 功能说明：绑定的vNIC类型 取值范围：normal或者direct。normal: 软交换，direct: SRIOV硬直通（不支持） port_security_enabled Boolean 端口安全使能标记，如果不使能则安全组和dhcp防欺骗不生效，默认为true dns_assignment Array of dns_assignment objects 扩展属性：主网卡默认内网域名信息 【使用说明】不支持设置和更新，由系统自动维护 hostname：与端口dns_name一致 ip_address：端口ipv4私有地址 fqdn：为端口创建默认内网fqdn dns_name String 扩展属性：主网卡默认内网DNS名称 【使用说明】不支持设置和更新，由系统自动维护,访问该默认内网域名前，请确保子网使用当前系统提供的DNS 表4 fixed_ip对象 名称 参数类型 说明 subnet_id String 功能说明：所属子网ID 约束：不支持更新 ip_address String 端口IP地址 表5 allow_address_pair对象 名称 参数类型 说明 ip_address String 功能说明：IP地址 约束：不支持0.0.0.0 如果allowed_address_pairs配置地址池较大的CIDR（掩码小于24位），建议为该port配置一个单独的安全组。 mac_address String MAC地址 表6 extra_dhcp_opt对象 名称 参数类型 说明 opt_name String Option名称 opt_value String Option值 表7 dns_assignment对象 名称 参数类型 说明 hostname String 端口hostname。 ip_address String 端口IP地址。 fqdn String 端口内网fqdn。 响应样例： { "port": { "id": "d00f9c13-412f-4855-8af3-de5d8c24cd60", "name": "test", "status": "DOWN", "admin_state_up": "true", "fixed_ips": [ { "subnet_id": "70f2e74b-e660-410a-b754-0ca46744348a", "ip_address": "10.128.1.10" } ], "dns_assignment": [ { "hostname": "ip-10-128-1-10", "ip_address": "10-128-1-10", "fqdn": "ip-10-128-1-10.xxx.compute.internal." } ], "dns_name": "ip-10-128-1-10", "mac_address": "fa:16:3e:d7:f2:6c", "network_id": "5b808927-13c9-4e60-a4f4-ed6ffe225167", "tenant_id": "43f2d1cca56a40729dcb17212482f34d", "device_id": "", "device_owner": "", "security_groups": [ "02b4e8ee-74fa-4a31-802e-5490df11245e" ], "extra_dhcp_opts": [], "allowed_address_pairs": [], "binding:vnic_type": "normal", "binding:vif_details": {}, "binding:profile": {}, "port_security_enabled":true } }

响应消息 响应参数 表2 响应参数 名称 参数类型 说明 ports Array of port objects 端口列表对象，请参见表3。 表3 port字段说明 名称 参数类型 说明 id String 端口唯一标识 name String 功能说明：端口名称 取值：默认为空，最大长度不超过255 network_id String 功能说明：端口所属网络的ID 约束：必须是存在的网络ID admin_state_up Boolean 功能说明：管理状态 约束：只支持true，默认为true mac_address String 功能说明：端口MAC地址 约束：由系统分配，不支持指定 fixed_ips Array of fixed_ip objects 功能说明：端口IP。例如："fixed_ips": [{"subnet_id": "4dc70db6-cb7f-4200-9790-a6a910776bba", "ip_address": "192.169.25.79"}]，请参见表4 约束：一个端口只支持一个fixed_ip，且不支持更新。 device_id String 功能说明：端口所属设备ID 约束：不支持设置和更新，由系统自动维护 device_owner String 功能说明：设备所属（DHCP/Router/ lb/Nova） 约束：不支持设置和更新，由系统自动维护 tenant_id String 项目ID。 status String 功能说明：端口状态，Hana硬直通虚拟机端口状态总为DOWN 取值范围：ACTIVE、BUILD、DOWN security_groups Array of strings 安全组的UUID(扩展属性) allowed_address_pairs Array of allow_address_pair objects 功能说明：IP/Mac对列表，allow_address_pair参见表5（扩展属性） 约束：IP地址不允许为 “0.0.0.0” 如果allowed_address_pairs配置地址池较大的CIDR（掩码小于24位），建议为该port配置一个单独的安全组 如果allowed_address_pairs为“1.1.1.1/0”，表示关闭源目地址检查开关 extra_dhcp_opts Array of extra_dhcp_opt objects DHCP的扩展Option(扩展属性)，请参见表6 binding:vif_details Object vif的详细信息， "ovs_hybrid_plug": 是否为ovs/bridge混合模式 binding:profile Object 扩展属性：提供用户设置自定义信息 【使用说明】 internal_elb字段，布尔类型，普通租户可见。只有在创建内网ELB的虚拟IP的网卡时设置为true。普通租户没有权限更改该字段，由系统维护。 举例： {"internal_elb": true} disable_security_groups字段，布尔类型，普通租户可见。默认为false高性能通信场景下，允许指定为true普通租户可见。仅支持创建port和读取时指定。当前仅支持指定为true，不支持指定为false 举例： {"disable_security_groups"：true }， 当前仅支持指定为true，不支持指定为false，指定为true时，FWaaS功能不生效。 binding:vnic_type String 功能说明：绑定的vNIC类型 取值范围：normal或者direct。normal: 软交换，direct: SRIOV硬直通（不支持） port_security_enabled Boolean 端口安全使能标记，如果不使能则安全组和dhcp防欺骗不生效，默认为true dns_assignment Array of dns_assignment objects 扩展属性：主网卡默认内网域名信息 【使用说明】不支持设置和更新，由系统自动维护 hostname：与端口dns_name一致 ip_address：端口ipv4私有地址 fqdn：为端口创建默认内网fqdn dns_name String 扩展属性：主网卡默认内网DNS名称 【使用说明】不支持设置和更新，由系统自动维护，访问该默认内网域名前，请确保子网使用当前系统提供的DNS 表4 fixed_ip对象 名称 参数类型 说明 subnet_id String 功能说明：所属子网ID 约束：不支持更新 ip_address String 端口IP地址 表5 allow_address_pair对象 名称 参数类型 说明 ip_address String 功能说明：IP地址 约束：不支持0.0.0.0 如果allowed_address_pairs配置地址池较大的CIDR（掩码小于24位），建议为该port配置一个单独的安全组。 mac_address String MAC地址 表6 extra_dhcp_opt对象 名称 参数类型 说明 opt_name String Option名称 opt_value String Option值 表7 dns_assignment对象 名称 参数类型 说明 hostname String 端口hostname。 ip_address String 端口IP地址。 fqdn String 端口内网fqdn。 响应样例 { "ports": [ { "id": "d00f9c13-412f-4855-8af3-de5d8c24cd60", "name": "test", "status": "DOWN", "admin_state_up": "true", "fixed_ips": [ { "subnet_id": "70f2e74b-e660-410a-b754-0ca46744348a", "ip_address": "10.128.1.10" } ], "dns_assignment": [ { "hostname": "ip-10-128-1-10", "ip_address": "10-128-1-10", "fqdn": "ip-10-128-1-10.xxx.compute.internal." } ], "dns_name": "ip-10-128-1-10", "mac_address": "fa:16:3e:d7:f2:6c", "network_id": "5b808927-13c9-4e60-a4f4-ed6ffe225167", "tenant_id": "43f2d1cca56a40729dcb17212482f34d", "device_id": "", "device_owner": "", "security_groups": [ "02b4e8ee-74fa-4a31-802e-5490df11245e" ], "extra_dhcp_opts": [], "allowed_address_pairs": [], "binding:vnic_type": "normal", "binding:vif_details": {}, "binding:profile": {}, "port_security_enabled":true }, { "id": "28ba8f45-7636-45e4-8c0a-675d7663717c", "name": "test1", "status": "DOWN", "admin_state_up": "true", "fixed_ips": [ { "subnet_id": "061d3ca2-bd1f-4bd1-a01d-7a5155328c0e", "ip_address": "192.168.10.10" } ], "dns_assignment": [ { "hostname": "ip-192-168-10-10", "ip_address": "192-168-10-10", "fqdn": "ip-192-168-10-10.xxx.compute.internal." } ], "dns_name": "ip-192-168-10-10", "mac_address": "fa:16:3e:3d:91:cd", "network_id": "be2fe79a-3ee2-4d87-bd71-5afa78a5670d", "tenant_id": "43f2d1cca56a40729dcb17212482f34d", "device_id": "", "device_owner": "", "security_groups": [ "0bfc8687-ca18-4c37-ac84-d2198baba585" ], "extra_dhcp_opts": [], "allowed_address_pairs": [], "binding:vnic_type": "normal", "binding:vif_details": {}, "binding:profile": {}, "port_security_enabled":true } ] }

URI GET /v1/ports 样例： GET https://{Endpoint}/v1/ports?id={port_id}&name={port_name}&admin_state_up={is_admin_status_up}&network_id={network_id}&mac_address={port_mac}&device_id={port_device_id}&device_owner={device_owner}&status={port_status}&fixed_ips=ip_address={ip_address}&fixed_ips=subnet_id={subnet_id} 参数说明请参见表1。 表1 参数说明 名称 是否必选 参数类型 说明 id 否 String 按照port_id过滤查询 name 否 String 功能说明：按照name过滤查询 取值范围：最大长度不超过255 admin_state_up 否 Boolean 按照admin_state_up进行过滤 network_id 否 String 按照network_id过滤查询 mac_address 否 String 按照mac_address过滤查询 device_id 否 String 按照device_id过滤查询 device_owner 否 String 按照device_owner过滤查询 status 否 String 功能说明：按照status过滤查询 取值范围：ACTIVE、BUILD、DOWN marker 否 String 分页查询的起始资源ID，表示从指定资源的下一条记录开始查询。 marker需要和limit配合使用： 若不传入marker和limit参数，查询结果返回第一页全部资源记录。 若不传入marker参数，limit为10，查询结果返回第1~10条资源记录。 若marker为第10条记录的资源ID，limit为10，查询结果返回第11~20条资源记录。 若marker为第10条记录的资源ID，不传入limit参数，查询结果返回第11条及之后的所有资源记录。 limit 否 Integer 分页查询每页返回的记录个数，取值范围为0~intmax（2^31-1），默认值2000。 limit需要和marker配合使用，详细规则请见marker的参数说明。 fixed_ips 否 String 按照fixed_ips=ip_address或者fixed_ips=subnet_id过滤查询