华为云用户手册

超高I/O型I7n 概述 I7n型弹性云服务器搭载第三代英特尔® 至强® 可扩展处理器，使用高性能NVMe SSD本地盘的ECS云服务器，提供高存储IOPS以及低读写时延。 使用须知 请参考使用须知。 适用场景 超高I/O型实例适用于高性能关系型数据库 NoSQL数据库(Cassandra、MongoDB等)以及ElasticSearch搜索等场景 规格 表6 I7n型弹性云服务器的规格 规格名称 vCPU 内存 （GiB） 最大带宽/基准带宽 （Gbps） 最大收发包能力 （万PPS） 网卡多队列数 网卡个数上限 辅助网卡个数上限 本地盘 （GiB） 虚拟化类型 i7n.2xlarge.4 8 32 10/3.4 120 4 4 64 1 × 1600GiB NVMe KVM i7n.4xlarge.4 16 64 15/6.7 200 4 6 96 2 × 1600GiB NVMe KVM i7n.8xlarge.4 32 128 25/13.5 400 8 8 192 4 × 1600GiB NVMe KVM i7n.12xlarge.4 48 192 30/20 500 16 8 256 6 × 1600GiB NVMe KVM i7n.16xlarge.4 64 256 35/27 600 16 8 256 8 × 1600GiB NVMe KVM i7n.24xlarge.4 96 420 44/20 800 32 8 256 12 × 1600GiB NVMe KVM

超高I/O型I7 概述 I7型弹性云服务器搭载第三代英特尔® 至强® 可扩展处理器，配备大容量高性能NVMe SSD本地盘，提供高存储IOPS以及低读写时延。 使用须知 请参考使用须知。 适用场景 超高I/O型实例适用于高性能关系型数据库 NoSQL数据库(Cassandra、MongoDB等)以及ElasticSearch搜索等场景 规格 表3 I7型弹性云服务器的规格 规格名称 vCPU 内存 （GiB） 最大带宽/基准带宽 （Gbps） 最大收发包能力 （万PPS） 网卡多队列数 网卡个数上限 辅助网卡个数上限 本地盘 （GiB） 虚拟化类型 i7.2xlarge.4 8 32 10/3 120 4 4 64 1 × 1600GiB NVMe KVM i7.4xlarge.4 16 64 15/6 200 4 6 96 2 × 1600GiB NVMe KVM i7.8xlarge.4 32 128 25/12 400 8 8 192 4 × 1600GiB NVMe KVM i7.12xlarge.4 48 192 30/18 500 16 8 256 6 × 1600GiB NVMe KVM i7.16xlarge.4 64 256 35/24 600 16 8 256 8 × 1600GiB NVMe KVM i7.24xlarge.4 96 384 44/36 800 32 8 256 12 × 1600GiB NVMe KVM

超高I/O型aI7 概述 aI7型弹性云服务器搭载新一代可扩展处理器，配备大容量高性能NVMe SSD本地盘，提供高存储IOPS以及低读写时延。 使用须知 请参考使用须知。 适用场景 超高I/O型实例适用于高性能关系型数据库 NoSQL数据库(Cassandra、MongoDB等)以及ElasticSearch搜索等场景 规格 表4 aI7型弹性云服务器的规格 规格名称 vCPU 内存 （GiB） 最大带宽/基准带宽 （Gbps） 最大收发包能力 （万PPS） 网卡多队列数 网卡个数上限 辅助网卡个数上限 本地盘 （GiB） 虚拟化类型 ai7.2xlarge.8 8 64 4/2.5 100 8 8 64 1 × 1600GiB NVMe KVM ai7.4xlarge.8 16 128 8/5 200 16 8 128 2 × 1600GiB NVMe KVM ai7.8xlarge.8 32 256 15/8 300 16 8 256 4 × 1600GiB NVMe KVM ai7.12xlarge.8 48 384 22/12 400 16 8 256 6 × 1600GiB NVMe KVM ai7.16xlarge.8 64 512 28/16 550 24 12 256 8 × 1600GiB NVMe KVM ai7.24xlarge.8 96 768 40/25 800 24 12 256 12 × 1600GiB NVMe KVM

超高I/O型实例类型总览 超高I/O型弹性云服务器使用高性能NVMe SSD本地磁盘，提供高存储IOPS以及低读写时延，您可以通过管理控制台创建挂载有高性能NVMe SSD盘的弹性云服务器。 在售：Ir3、I3、Ir7、I7、aI7、Ir7n、I7n 表1 超高I/O型实例特点 规格名称 计算 磁盘类型 网络 超高I/O型Ir7 CPU/内存配比：1:4 vCPU数量范围：2-64 处理器：第三代英特尔® 至强® 铂金® 可扩展处理器 基频/睿频：3.0GHz/3.5GHz 支持开启/关闭超线程功能，详细内容请参见开启/关闭超线程 高IO 通用型SSD 超高IO 极速型SSD 通用型SSD V2 支持IPv6 超高网络收发包能力 实例网络性能与计算规格对应，规格越高网络性能越强 最大网络收发包：600万PPS 最大内网带宽：40Gbps 超高I/O型I7 CPU/内存配比：1:4 vCPU数量范围：8-96 处理器：第三代英特尔® 至强® 铂金® 可扩展处理器 基频/睿频：3.0GHz/3.5GHz 支持开启/关闭超线程功能，详细内容请参见开启/关闭超线程 高IO 通用型SSD 超高IO 极速型SSD 通用型SSD V2 支持IPv6 超高网络收发包能力 实例网络性能与计算规格对应，规格越高网络性能越强 最大网络收发包：800万PPS 最大内网带宽：40Gbps 超高I/O型aI7 CPU/内存配比：1:8 vCPU数量范围：8-96 基频/睿频：2.45GHz/3.5GHz 支持开启/关闭超线程功能，详细内容请参见开启/关闭超线程 高IO 通用型SSD 超高IO 极速型SSD 通用型SSD V2 支持IPv6 超高网络收发包能力 实例网络性能与计算规格对应，规格越高网络性能越强 最大网络收发包：800万PPS 最大内网带宽：40Gbps 超高I/O型Ir7n CPU/内存配比：1:4 vCPU数量范围：2-64 处理器：第三代英特尔® 至强® 可扩展处理器 基频/睿频：2.6GHz/3.5GHz 高IO 通用型SSD 超高IO 极速型SSD 支持IPv6 超高网络收发包能力 实例网络性能与计算规格对应，规格越高网络性能越强 最大网络收发包：600万PPS 最大内网带宽：40Gbps 超高I/O型I7n CPU/内存配比：1:4 vCPU数量范围：8-96 处理器：第三代英特尔® 至强® 可扩展处理器 基频/睿频：2.6GHz/3.5GHz 高IO 通用型SSD 超高IO 极速型SSD 通用型SSD V2 支持IPv6 超高网络收发包能力 实例网络性能与计算规格对应，规格越高网络性能越强 最大网络收发包：800万PPS 最大内网带宽：40Gbps 超高I/O型Ir3 CPU/内存配比：1:4 vCPU数量范围：2-32 处理器：第二代英特尔® 至强® 可扩展处理器 基频/睿频：2.6GHz/3.5GHz 高IO 通用型SSD 超高IO 极速型SSD 通用型SSD V2 超高网络收发包能力 实例网络性能与计算规格对应，规格越高网络性能越强 最大网络收发包：450万PPS 最大内网带宽：30Gbps 超高I/O型I3 CPU/内存配比：1:8 vCPU数量范围：8-64 处理器：英特尔® 至强® 可扩展处理器 基频/睿频：3.0GHz/3.4GHz 高IO 通用型SSD 超高IO 极速型SSD 通用型SSD V2 超高网络收发包能力 实例网络性能与计算规格对应，规格越高网络性能越强 最大网络收发包：500万PPS 最大内网带宽：25Gbps

超高I/O型Ir7 概述 Ir7型弹性云服务器搭载第三代英特尔® 至强® 可扩展处理器，配备2块容量较小的高性能NVMe SSD本地盘，提供高存储IOPS以及低读写时延。 使用须知 请参考使用须知。 适用场景 适用于高性能关系型数据库。 NoSQL数据库(Cassandra、MongoDB等)。 ElasticSearch搜索等场景。 规格 表2 Ir7型弹性云服务器的规格 规格名称 vCPU 内存 （GiB） 最大带宽/基准带宽 （Gbps） 最大收发包能力 （万PPS） 网卡多队列数 网卡个数上限 本地盘 （GiB） 虚拟化类型 ir7.large.4 2 8 3/0.8 40 2 3 2 × 50 KVM ir7.xlarge.4 4 16 6/1.5 80 2 3 2 × 100 KVM ir7.2xlarge.4 8 32 15/3.1 150 4 4 2 × 200 KVM ir7.4xlarge.4 16 64 20/6.2 300 4 6 2 × 400 KVM ir7.8xlarge.4 32 128 30/12 400 8 8 2 × 800 KVM ir7.16xlarge.4 64 256 40/25 600 16 8 2 × 1600 KVM

功能 FPGA开发套件 FPGA云服务提供硬件开发套件 (HDK）。HDK包括加速器示例、编码环境、仿真平台、自动化编译工具、代码加密和调试工具包等必备工具。您可以参照应用示例和用户开发指导手册，迅速开发和测试您的FPGA硬件加速器。 应用开发套件 FPGA云服务提供应用开发套件 (SDK）。SDK包括应用示例、硬件抽象接口、加速器抽象接口、加速器驱动和runtime、版本管理工具等必备工具。通过加速器抽象接口实现硬件加速器和驱动的透明化，您的应用即可像调用软件函数库一样调用硬件加速器，让您方便快捷的开发基于硬件加速器的高性能应用。 FPGA硬件配置 每个FPGA云服务器最大提供8片FPGA，每片FPGA包含约250万逻辑单元。支持PCIe 3.0 x16接口，吞吐量高达100Gbps；FPGA之间提供高达300Gbps的Mesh光互连网络；每片提供64GiB的DDR4，接口速率高达2133MHz。让您的应用不再受限硬件配置。 硬件加速器资源池 FPGA云服务的硬件加速资源以池化的形式呈现，像分配CPU资源一样，按照您的需求分配最合适、最经济的FPGA资源。通过FPGA虚拟化技术、隔离技术和分布式技术，可以实现节点内FPGA资源的共享，而这一切对您的业务都是透明的，从而最大化满足您业务的硬件加速需求。

使用场景 应用： 视频处理、机器学习、基因组学研究、金融风险分析 场景特点： 适合密集计算、高并发、高带宽场景。 适用场景： 视频处理：图片自动分类识别、图片搜索、视频转码、实时渲染、互联网直播和AR/VR等视频应用，需要大量的实时计算能力，普通的云服务器难以满足性能需求，FPGA云服务器可以提供高性价比的视频解决方案，是视频类场景的理想选择。 机器学习：机器学习中多层神经网络需要大量计算资源，其中训练过程需要处理海量的数据，推理过程则希望极低的时延。同时机器学习算法还在不断优化中， FPGA以其高并行计算、硬件可编程、低功耗、和低时延等优势，可针对不同算法动态编程设计最匹配的硬件电路，满足机器学习中海量计算和极低时延的要求。因此，FPGA在满足机器学习的硬件需求上提供极具吸引力的替代方案。 基因组学研究：通过基因测序和分析、生物和医疗信息等海量数据的快速分析，可实现精准医疗；同时在药物研发、分子育种等领域都有海量数据的处理，该领域需要硬件加速来解决生物计算量的性能瓶颈。FPGA云服务器提供的强大的可编程的硬件计算能力可以很好满足海量生物数据快速计算的需求。 金融风险分析：金融行业对计算能力、基于超低时延和高吞吐能力的及时响应有很高的要求，比如基于定价树模型的金融计算、高频金融交易、基金/证券交易算法、金融风险分析和决策、交易安全保证等，FPGA云服务通过可编程的硬件加速技术，可以针对各种场景的提供硬件加速解决方案，部分场景可以提供相比纯软件百倍的性能改善。

规格 表1 高性能架构弹性云服务器的规格 规格名称 vCPU 内存 （GiB） 最大带宽/基准带宽 （Gbps） 最大收发包能力 （万PPS） 网卡多队列数 FPGA 虚拟化类型 fp1.2xlarge.11 8 88GiB 5/1.3 20 2 1×VU9P KVM fp1.8xlarge.11 32 352GiB 10/5 60 8 4×VU9P KVM fp1.16xlarge.11 64 704GiB 10/10 100 8 8×VU9P KVM fp1.8xlarge.8 32 224GiB 10/5 60 8 1×VU9P KVM fp1.16xlarge.8 64 448GiB 10/10 100 8 2×VU9P KVM 网络类型：10GbE 表2 通用型架构弹性云服务器的规格 规格名称 vCPU 内存 （GiB） 最大带宽/基准带宽 （Gbps） 最大收发包能力 （万PPS） 网卡多队列数 FPGA 虚拟化类型 fp1c.2xlarge.11 8 88GiB 5/1.3 20 2 1×VU9P KVM fp1c.8xlarge.11 32 352GiB 10/5 60 8 4×VU9P KVM fp1c.16xlarge.11 64 704GiB 10/10 100 8 8×VU9P KVM fp1c.8xlarge.8 32 224GiB 10/5 60 8 1×VU9P KVM fp1c.16xlarge.8 64 448GiB 10/10 100 8 2×VU9P KVM 网络类型：10GbE

概述 FPGA加速云服务器（FPGA Accelerated Cloud Server，FACS）提供FPGA开发和使用的工具及环境，让用户方便地开发FPGA加速器和部署基于FPGA加速的业务，为您提供易用、经济、敏捷和安全的FPGA云服务。 FPGA加速云服务器包括两类： 高性能架构 基于DPDK的高性能交互框架，支持流计算模型，支持数据流并发，主要用于RTL开发场景，满足用户高带宽低时延的要求。 通用型架构 基于SDAccel的通用型交互框架，支持块计算模块，支持Xilinx SGDMA数据传输框架，主要用于高级语言开发或已有算法移植，满足用户快速上线的需求。

云服务器备份与云硬盘备份 目前弹性云服务器备份可以通过“云服务器备份”和“云硬盘备份”功能实现： 云服务器备份（推荐）：如果是对弹性云服务器中的所有云硬盘（系统盘和数据盘）进行备份，推荐使用云服务器备份功能，同时对所有云硬盘进行备份，避免因备份创建时间差带来的数据不一致问题。 云硬盘备份：如果对指定的单个或多个云硬盘（系统盘或数据盘）进行备份，推荐使用云硬盘备份功能，在保证数据安全的同时降低备份成本。 表1 云服务器备份与云硬盘备份 对比维度 云服务器备份 云硬盘备份 备份/恢复对象 服务器中的所有云硬盘（系统盘和数据盘）。 指定的单个或多个磁盘（系统盘或数据盘）。 推荐场景 需要对整个云服务器进行保护。 系统盘没有个人数据，因而只需要对部分的数据盘进行备份。 优势 备份的同一个服务器下的所有磁盘数据具有一致性，即同时对所有云硬盘进行备份，不存在因备份创建时间差带来的数据不一致问题。 保证数据安全的同时降低备份成本。

计费场景 网格类型 计费模式 网格管理规模 实例数规模阶梯 按需计费 包月 包年 企业版网格 按需计费 5000实例 0-20 网格实例规格单价 * 20 * 购买时长 网格实例规格单价 * 20 * 一月的小时数，在此基础上会有一定优惠 网格实例规格单价 * 20 * 一年的小时数，仅需支付10个月的套餐包费用即可包一整年 21-5000 网格实例规格单价 * 5000 * 购买时长 网格实例规格单价 * 20 * 一月的小时数，在此基础上会有一定优惠 网格实例规格单价 * 20 * 一年的小时数，仅需支付10个月的套餐包费用即可包一整年 基础版网格 免费 200实例 0-200 / / / 专有网格 按需计费 20实例 0-20 网格实例规格单价 * 20 * 购买时长 网格实例规格单价 * 20 * 一月的小时数，在此基础上会有一定优惠 网格实例规格单价 * 20 * 一年的小时数，在此基础上会有一定优惠 按需计费 5000实例 0-5000 网格实例规格单价 * 5000 * 购买时长 网格实例规格单价 * 20 * 一月的小时数，在此基础上会有一定优惠 网格实例规格单价 * 20 * 一年的小时数，在此基础上会有一定优惠

包年/包月资源 对于包年/包月计费模式的资源，例如包年/包月的应用服务网格，用户在购买时会一次性付费，服务将在到期后自动停止使用。 如果在计费周期内不再使用包年/包月资源，由于包年/包月资源创建后不能删除，如需停止使用，请到费用中心执行退订操作，系统将根据资源是否属于五天无理由退订、是否使用代金券和折扣券等条件返还一定金额到您的账户。详细的退订规则请参见云服务退订规则概览。 如果您已开启“自动续费”功能，为避免继续产生费用，请在自动续费扣款日（默认为到期前7日）之前关闭自动续费。 对于包年/包月网格，即使集群已被删除，服务网格仍然会继续计费，如果网格不再使用，请将其退订。

在续费管理页面开通自动续费 在费用中心开通自动续费的方法适合所有资源。 登录ASM控制台。 单击“控制台”页面上方“费用”，在下拉菜单中选择“续费管理”。 进入“续费管理”页面。 自定义查询条件。 可在“自动续费项”页签查询已经开通自动续费的资源。 可对“手动续费项”、“到期转按需项”、“到期不续费项”页签的资源开通自动续费。 为包年/包月资源开通自动续费。 单个资源开通自动续费：选择需要开通自动续费的资源，单击操作列“开通自动续费”。 批量资源开通自动续费：选择需要开通自动续费的资源，单击列表左上角的“开通自动续费”。 选择续费时长，并根据需要设置自动续费次数，单击“开通”。 在“续费管理”页面开通的自动续费，自动续费周期以实际选择的续费时长以及自动续费次数为准。例如：您选择了续费时长3个月，不限次数，即在每次到期前自动续费3个月

适用场景 包年/包月计费模式需要用户预先支付一定时长的费用，适用于长期、稳定的业务需求。以下是一些适用于包年/包月计费模式的业务场景： 稳定业务需求：对于长期运行且资源需求相对稳定的业务，如企业官网、在线商城、博客等，包年/包月计费模式能提供较高的成本效益。 长期项目：对于周期较长的项目，如科研项目、大型活动策划等，包年/包月计费模式可以确保在整个项目周期内资源的稳定使用。 数据安全要求高：对于对数据安全性要求较高的业务，包年/包月计费模式可确保资源的持续使用，降低因资源欠费而导致的数据安全风险。

到期后影响 图1描述了包年/包月ASM资源各个阶段的状态。购买后，在计费周期内资源正常运行，此阶段为有效期；资源到期而未续费时，将陆续进入宽限期和保留期。 图1 包年/包月ASM资源生命周期 到期预警 包年/包月ASM应用服务网格在到期前第7天内，系统将向用户推送到期预警消息。预警消息将通过邮件、短信和站内信的方式通知到华为云账号的创建者。 到期后影响 当您的包年/包月ASM应用服务网格到期未续费，首先会进入宽限期，资源状态变为“已过期”。部分操作（更新网格，升级网格等）受限。 如果您在宽限期内仍未续费包年/包月ASM应用服务网格，那么就会进入保留期，资源状态变为“已冻结”，您将无法对处于保留期的包年/包月资源执行任何操作。 保留期到期后，若包年/包月ASM应用服务网格资源仍未续费，那么应用服务网格相关的资源均会被释放，数据无法恢复。 华为云根据客户等级定义了不同客户的宽限期和保留期时长。 关于续费的详细介绍请参见续费概述。 华为云为客户提供充分的时间进行续费与充值，当您的包年/包月资源到期未续订会依次进入宽限期和保留期，详情请参见宽限期保留期、 关于充值的详细操作请参见账户充值。

计费模式概述 应用服务网格提供包年/包月、按需计费两种计费模式，以满足不同场景下的用户需求。 包年/包月：一种预付费模式，即先付费再使用，按照订单的购买周期进行结算。购买周期越长，享受的折扣越大。一般适用于设备需求量长期稳定的成熟业务。 按需计费：一种后付费模式，即先使用再付费，按照网格实际使用时长计费，秒级计费，按小时结算。按需计费模式允许您根据实际业务需求灵活地调整资源使用，无需提前预置资源，从而降低预置过多或不足的风险。一般适用于电商抢购等设备需求量瞬间大幅波动的场景。 父主题： 计费模式

计费周期 按需计费资源按秒计费，每一个小时整点结算一次费用（以UTC+8时间为准），结算完毕后进入新的计费周期。计费的起点以网格实例创建成功的时间点为准，终点以网格实例删除时间为准。 按需计费的企业版网格购买成功后即开始计费。应用服务网格实例从创建到启动需要一定时长，计费的起点是创建成功的时间点，而非创建时间。 按需计费的企业版网格治理不足20实例时，按20实例数收取费用，超过20实例时，按实际实例数收取费用。 例如，您在8:45:30购买了一个按需计费的应用服务网格，然后在8:55:00将其删除，则计费周期为8:00:00 ~ 9:00:00，在8:45:30 ~ 8:55:30间产生费用，该计费周期内的计费时长为600秒。

续费相关的功能 本文介绍网格续费相关内容，如表1所示。 表1 续费相关的功能 功能 说明 手动续费 包年/包月的网格从购买到被自动删除之前，您可以随时在ASM控制台为网格续费，以延长网格的使用时间。 自动续费 开通自动续费后，网格会在每次到期前自动续费，避免因忘记手动续费而导致资源被自动删除。 在一个包年/包月应用服务网格生命周期的不同阶段，您可以根据需要选择一种方式进行续费，具体如下图所示。 图1 应用服务网格生命周期 网格从购买到到期前，处于正常运行阶段，资源状态为“运行中”。 到期后，资源状态变为“已过期”。 到期未续费时，网格资源首先会进入宽限期，宽限期到期后仍未续费，网格资源状态变为“已冻结”。 超过宽限期仍未续费将进入保留期，如果保留期内仍未续费，资源将被自动删除。 华为云根据客户等级定义了不同客户的宽限期和保留期时长。 在网格到期前均可开通自动续费，到期前7日凌晨3:00首次尝试自动续费，如果扣款失败，每天凌晨3:00尝试一次，直至网格到期或者续费成功。到期前7日自动续费扣款是系统默认配置，您也可以根据需要修改此扣款日。

在费用中心续费 在费用中心续费资源的方法适合所有资源。 登录管理控制台。 单击“控制台”页面上方“费用与成本”，在下拉菜单中选择“续费管理”。 进入“续费管理”页面。 自定义查询条件。 可在“手动续费项”、“自动续费项”、“到期转按需项”、“到期不续费项”页签查询全部待续费资源，对资源进行手动续费的操作。 所有需手动续费的资源都可归置到“手动续费项”页签，具体操作请参见如何恢复为手动续费。 手动续费资源。 单个续费：在资源页面找到需要续费的资源，单击操作列的“续费”。 批量续费：在资源页面勾选需要续费的资源，单击列表左上角的“批量续费”。 选择应用服务网格的续费时长，判断是否勾选“统一到期日”，将应用服务网格到期时间统一到各个月的某一天（详细介绍请参见统一包年/包月资源的到期日）。确认配置费用后单击“去支付”。 进入支付页面，选择支付方式，确认付款，支付订单后即可完成续费。

计费项 表1 应用服务网格计费项 计费项 计费项说明 适用的计费模式 计费公式 网格管理规模 服务网格可管理的最大实例数（Pod个数） 包年/包月、按需计费 网格实例规格单价 * 实例个数 * 购买时长 ASM套餐价格中不包含APM服务费用，推荐购买APM服务享受全方位的服务性能监控：APM计费模式介绍。 ASM套餐价格不包含用户使用华为云上的资源费用（弹性云服务器、CCE集群管理费、ELB费用等），相关链接如下： 集群创建费用详见：云容器引擎价格详情。 更多价格详情请参见：产品价格详情。

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 request_id String 资源ID标识符。 最小长度：32 最大长度：36 tags Array of MultivaluedTag objects 带宽包的所有标签。 数组长度：1 - 200 表4 MultivaluedTag 参数 参数类型 描述 key String 标签键，最大长度128个unicode字符，格式为大小写字母，数字，中划线“-”，下划线“_”，中文。 values Array of strings 相同键的值列表 数组长度：1 - 20

响应示例 状态码： 200 查询带宽包标签信息成功。 { "request_id" : "762f22e24aec86c3d61d8db870e87ead", "tags" : [ { "key" : "key1", "values" : [ "value1" ] }, { "key" : "key2", "values" : [ "value2" ] } ] }

URI GET /v3/{domain_id}/gcn/quotas 表1 路径参数 参数 是否必选 参数类型 描述 domain_id 是 String 账户ID。 最小长度：10 最大长度：32 表2 Query参数 参数 是否必选 参数类型 描述 quota_type 否 Array 根据配额类型查询，可查询多个类型。 数组长度：1 - 20 limit 否 Integer 每页返回的个数。 取值范围：1~1000。 最小值：1 最大值：1000 缺省值：1000 marker 否 String 翻页信息，从上次API调用返回的翻页数据中获取，可填写前一页marker或者后一页marker，填入前一页previous_marker就向前翻页，后一页next_marker就向翻页。 翻页过程中，查询条件不能修改，包括过滤条件，排序条件，limit。 最小长度：1 最大长度：4096

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 request_id String 资源ID标识符。 最小长度：32 最大长度：36 quotas Array of CentralNetworkQuota objects 配额列表 数组长度：0 - 2000 表5 CentralNetworkQuota 参数 参数类型 描述 quota_key String 中心网络配额类型。 - central_networks_per_account (每个账户的中心网数) - policy_versions_per_central_network (每个中心网的策略数) - size_of_document_per_central_network_policy_version (中心网络策略文档大小(KB)) - planes_per_central_network (每个中心网的平面数) - er_instances_per_region_per_central_network (每个中心网络每个区域的Er实例数) - connections_per_central_network (每个中心网的连接数) - attachments_per_central_network (每个中心网的附件数) - GDGW_attachments_per_region_per_central_network (每个中心网每个区域的GDGW附件数) - ER_ROUTE_TABLE_attachments_per_region_per_central_network (每个中心网每个区域的ER_ROUTE_TABLE附件数) quota_limit Integer 配额大小。 最小值：0 最大值：2147483647 used Integer 已使用配额。 最小值：0 最大值：2147483647 unit String 配额值的单位。 最小长度：0 最大长度：255

响应示例 状态码： 200 查询中心网络配额成功 { "request_id" : "a3bad420-33b8-4e26-9e9b-bdf67aa8e72b", "quotas" : [ { "quota_key" : "central_networks_per_account", "quota_limit" : 6, "used" : 0, "unit" : "count" } ] }

AK/SK认证 AK/SK签名认证方式仅支持消息体大小在12MB以内，12MB以上的请求请使用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需要项目级别的Token，即调用获取用户Token接口时，请求body中auth.scope的取值需要选择project，如下所示。 { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username", //IAM用户名 "password": "********", //IAM用户密码 "domain": { "name": "domainname" //IAM用户所属账号名 } } } }, "scope": { "project": { "name": "xxxxxxxx" //项目名称 } } } } 获取Token后，再调用其他接口时，您需要在请求消息头中添加“X-Auth-Token”，其值即为Token。例如Token值为“ABCDEFJ....”，则调用接口时将“X-Auth-Token: ABCDEFJ....”加到请求消息头即可，如下所示。 1 2 3 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/projects Content-Type: application/json X-Auth-Token: ABCDEFJ.... 您还可以通过这个视频教程了解如何使用Token认证：https://bbs.huaweicloud.com/videos/101333。

请求消息体（可选） 该部分可选。请求消息体通常以结构化格式（如JSON或XML）发出，与请求消息头中Content-Type对应，传递除请求消息头之外的内容。若请求消息体中的参数支持中文，则中文字符必须为UTF-8编码。 每个接口的请求消息体内容不同，也并不是每个接口都需要有请求消息体（或者说消息体为空），GET、DELETE操作类型的接口就不需要消息体，消息体具体内容需要根据具体接口而定。 对于获取用户Token接口，您可以从接口的请求部分看到所需的请求参数及参数说明。将消息体加入后的请求如下所示，加粗的斜体字段需要根据实际值填写，其中username为用户名，domainname为用户所属的账号名称，********为用户登录密码，xxxxxxxxxxxxxxxxxx为project的名称，如“cn-north-1”，您可以从地区和终端节点获取。 scope参数定义了Token的作用域，下面示例中获取的Token仅能访问project下的资源。您还可以设置Token的作用域为某个账号下所有资源或账号的某个project下的资源，详细定义请参见获取用户Token。 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens Content-Type: application/json { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username", "password": "********", "domain": { "name": "domainname" } } } }, "scope": { "project": { "name": "xxxxxxxxxxxxxxxxxx" } } } } 到这里为止这个请求需要的内容就具备齐全了，您可以使用curl、Postman或直接编写代码等方式发送请求调用API。对于获取用户Token接口，返回的响应消息头中的“x-subject-token”就是需要获取的用户Token。有了Token之后，您就可以使用Token认证调用其他API。

请求方法 HTTP请求方法（也称为操作或动词），它告诉服务您正在请求什么类型的操作。 表2 HTTP方法 方法 说明 GET 请求服务器返回指定资源。 PUT 请求服务器更新指定资源。 POST 请求服务器新增资源或执行特殊操作。 DELETE 请求服务器删除指定资源，如删除对象等。 HEAD 请求服务器资源头部。 PATCH 请求服务器更新资源的部分内容。 当资源不存在的时候，PATCH可能会去创建一个新的资源。 在获取用户Token的URI部分，您可以看到其请求方法为“POST”，则其请求为： 1 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens

请求消息头 附加请求头字段，如指定的URI和HTTP方法所要求的字段。例如定义消息体类型的请求头“Content-Type”，请求鉴权信息等。 详细的公共请求消息头字段请参见表3。 表3 公共请求消息头 名称 描述 是否必选 示例 Host 请求的服务器信息，从服务API的URL中获取。值为hostname[:port]。端口缺省时使用默认的端口，https的默认端口为443。 否 使用AK/SK认证时该字段必选。 code.test.com or code.test.com:443 Content-Type 消息体的类型（格式）。推荐用户使用默认值application/json，有其他取值时会在具体接口中专门说明。 是 application/json Content-Length 请求body长度，单位为Byte。 否 3495 X-Project-Id project id，项目编号。请参考获取项目ID章节获取项目编号。 否 如果是专属云场景采用AK/SK认证方式的接口请求，或者多project场景采用AK/SK认证的接口请求，则该字段必选。 e9993fc787d94b6c886cbaa340f9c0f4 X-Auth-Token 用户Token。 用户Token也就是调用获取用户Token接口的响应值，该接口是唯一不需要认证的接口。 请求响应成功后在响应消息头（Headers）中包含的“X-Subject-Token”的值即为Token值。 否 使用Token认证时该字段必选。 注：以下仅为Token示例片段。 MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ API同时支持使用AK/SK认证，AK/SK认证使用SDK对请求进行签名，签名过程会自动往请求中添加Authorization（签名认证信息）和X-Sdk-Date（请求发送的时间）请求头。 AK/SK认证的详细说明请参见认证鉴权的“AK/SK认证”。 对于获取用户Token接口，由于不需要认证，所以只添加“Content-Type”即可，添加消息头后的请求如下所示。 1 2 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens Content-Type: application/json