华为云用户手册

适用于云数据库（RDS）的最佳实践 该示例模板包含以下合规规则： rds-instance-enable-backup rds-instance-enable-errorLog rds-instance-enable-slowLog rds-instance-multi-az-support rds-instance-no-public-ip rds-instances-enable-kms 父主题： 合规规则包示例模板

适用于金融行业的合规实践 该示例模板包含以下合规规则： access-keys-rotated as-group-elb-healthcheck-required css-cluster-https-required css-cluster-in-vpc cts-kms-encrypted-check cts-lts-enable cts-obs-bucket-track cts-support-validate-check cts-tracker-exists ecs-instance-in-vpc ecs-instance-no-public-ip eip-unbound-check elb-tls-https-listeners-only function-graph-concurrency-check iam-group-has-users-check iam-password-policy iam-root-access-key-check iam-user-group-membership-check iam-user-last-login-check iam-user-mfa-enabled kms-rotation-enabled mfa-enabled-for-iam-console-access mrs-cluster-in-vpc mrs-cluster-kerberos-enabled mrs-cluster-no-public-ip private-nat-gateway-authorized-vpc-only rds-instance-multi-az-support rds-instance-no-public-ip root-account-mfa-enabled stopped-ecs-date-diff volume-unused-check volumes-encrypted-check vpc-acl-unused-check vpc-flow-logs-enabled vpc-sg-ports-check vpn-connections-active (vpnaas.vpnConnections) vpn-connections-active (vpnaas.ipsec-site-connections) waf-instance-policy-not-empty 父主题： 合规规则包示例模板

AI加速型 各规格详细介绍请参见AI加速型。 表61 AI加速型实例特点 规格名称 计算 磁盘类型 网络 Ai1s CPU/内存配比：1:4/1:2 vCPU数量范围：2-32 处理器：第二代英特尔® 至强® 可扩展处理器 基频/睿频：2.6GHz/3.5GHz 支持开启/关闭超线程功能，详细内容请参见开启/关闭超线程 高IO 通用型SSD 超高IO 极速型SSD 通用型SSD V2 超高网络收发包能力 实例网络性能与计算规格对应，规格越高网络性能越强 最大网络收发包：200万PPS 最大内网带宽：25Gbps Ai1 CPU/内存配比：1:4 vCPU数量范围：2-32 处理器：第二代英特尔® 至强® 可扩展处理器 基频/睿频：2.6GHz/3.5GHz 支持开启/关闭超线程功能，详细内容请参见开启/关闭超线程 表62 Ai1s型弹性云服务器的规格 规格名称 vCPU 内存 （GiB） 最大带宽/基准带宽 最大收发包能力 （万/PPS） Ascend 310 Ascend RAM （GiB） 网卡多队列数 网卡个数上限 虚拟化类型 ai1s.3xlarge.2 12 24 12/6 75 4 32 4 6 KVM ai1s.4xlarge.2 16 32 15/8 100 4 32 8 8 KVM ai1s.5xlarge.2 20 40 25/15 200 4 32 8 8 KVM ai1s.9xlarge.2 36 72 30/18 550 4 32 16 8 KVM ai1s.large.4 2 8 4/1.3 20 1 8 2 2 KVM ai1s.xlarge.4 4 16 6/2 35 2 16 2 3 KVM ai1s.2xlarge.4 8 32 10/4 50 4 32 4 4 KVM ai1s.4xlarge.4 16 64 15/8 100 8 64 8 8 KVM ai1s.8xlarge.4 32 128 25/15 200 16 128 8 8 KVM 表63 Ai1型弹性云服务器的规格 规格名称 vCPU 内存 （GiB） 最大带宽/基准带宽 最大收发包能力 （万/PPS） Ascend 310 Ascend RAM （GiB） 网卡多队列数 网卡个数上限 虚拟化类型 ai1.large.4 2 8 4/1.3 20 1 8 2 2 KVM ai1.xlarge.4 4 16 6/2 35 2 16 2 3 KVM ai1.2xlarge.4 8 32 10/4 50 4 32 4 4 KVM ai1.4xlarge.4 16 64 15/8 100 8 64 8 8 KVM ai1.8xlarge.4 32 128 25/15 200 16 128 8 8 KVM

请求消息 表2 请求参数 参数 是否必选 参数类型 描述 os-stop 是 Object 标记为关闭云服务器操作，详情请参见表3。 表3 os-stop字段数据结构说明 参数 是否必选 参数类型 描述 servers 是 Array of objects 云服务器ID列表，详情请参见表4。 type 否 String 关机类型，默认为SOFT： SOFT：普通关机（默认）。 HARD：强制关机。 表4 servers字段数据结构说明 参数 是否必选 参数类型 描述 id 是 String 云服务器ID。

请求示例 批量关闭ID为“616fb98f-46ca-475e-917e-2563e5a8cd19”和“726fb98f-46ca-475e-917e-2563e5a8cd20”的云服务器，请求参数必须以”os-stop”字段下发。 POST https://{endpoint}/v1/{project_id}/cloudservers/action { "os-stop": { "type":"HARD", "servers": [ { "id": "616fb98f-46ca-475e-917e-2563e5a8cd19" }, { "id": "726fb98f-46ca-475e-917e-2563e5a8cd20" } ] } }

请求示例 删除指定云服务器组中UUID为“34dac9a0-c4a7-457b-bab2-e2c696e0e401”的云服务器。 POST https://{endpoint}/v1/{project_id}/cloudservers/os-server-groups/{server_group_id}/action { "remove_member": { "instance_uuid": "34dac9a0-c4a7-457b-bab2-e2c696e0e401" } }

请求消息 请求参数如表2所示。 表2 请求参数 参数 是否必选 参数类型 描述 reboot 是 Object 标记为重启云服务器操作，详情请参见表3。 表3 reboot字段数据结构说明 参数 是否必选 参数类型 描述 type 是 String 重启类型： SOFT：普通重启。 HARD：强制重启。 servers 是 Array of objects 云服务器ID列表，详情请参见表4。 表4 servers字段数据结构说明 参数 是否必选 参数类型 描述 id 是 String 云服务器ID。

请求示例 批量重启ID为“616fb98f-46ca-475e-917e-2563e5a8cd19”和“726fb98f-46ca-475e-917e-2563e5a8cd20”的云服务器，请求参数必须以”reboot”字段下发。 POST https://{endpoint}/v1/{project_id}/cloudservers/action { "reboot": { "type":"SOFT", "servers": [ { "id": "616fb98f-46ca-475e-917e-2563e5a8cd19" }, { "id": "726fb98f-46ca-475e-917e-2563e5a8cd20" } ] } }

计费方式 计费方式：支持周期计费（包月、半年或年）和按需计费两种计费模式。 周期计费：先购买再使用，企业在购买时，系统会根据企业所选的周期套餐金额，从企业云账户中扣除。 按需计费：先使用后付费，企业在购买后，系统根据订购天数或者呼叫产生的分钟数来计算费用并出账单，从企业云账户中扣除。 计费方式更改：计费周期内不支持计费方式更改。 计费周期：以年或月为计费周期，计费周期以UTC+8时区的时间为准。计费周期的起点是资源开通的时间点（精确到秒），终点是指定使用时长后的第一个 00:00:00。 周期计费：举例：假设企业购买1个月的坐席，在2020年1月4日13:23:56开通资源，计费周期终点是2020年2月5日00:00:00。 按需计费：如以按需计费的方式购买坐席产品，则按自然月为计费周期，使用1天收取1天费用。举例：假设企业在2020年1月4日选择按需计费购买10个基础语音坐席，并且在2020年1月16日再次购买2个基础语音坐席，在1月28日又删除1个语音坐席，则2020年1月31日需扣取的费用包括：10个基础语音坐席*使用天数28天+2个基础语音坐席*使用天数16天-1个基础语音坐席*使用天数4天，每坐席每天费用=每坐席每月价格/当月实际日历天数。 通话费用：按天收取，每天00:00统计前一天累计通话分钟数*每分钟单价收取，不足一分钟按一分钟收取。 计费量纲：资源不同，计费单位不同。下表为各种资源的计费单位。 表1 计费项说明 资源 功能介绍 计费单位 基础型座席 适用于以语音服务为主的中小企业呼叫中心，包括如下功能： 呼入 呼出 IVR（每座席含1路IVR） 话务监控 录音 排队路由 提供呼叫中心平台API用于二次开发。 按需，或包年包月，按每坐席计费 电销型座席 适用以外呼为主的电销型企业。包括如下功能： 外呼任务管理 外呼号码导入 人工外呼 录音 外呼结果统计等 提供API用于外呼应用开发。 按需，或包年包月，按每坐席计费 全能型座席 适用于全业务型企业呼叫中心，包括如下功能： 电销型座席全部功能 基础型座席全部功能 在线客服 提供呼叫中心平台API用于二次开发。 按需，或包年包月，按每坐席计费 在线客服座席 适用于需要通过多种渠道为客户提供在线客服的企业，包括如下功能： 支持通过网页、手机APP、H5小程序、微信、微博等渠道接入 支持文字、图片、表情、语音、视频、图文、链接等多种消息形式 支持与企业门户网站或第三方应用快速对接集成 提供SDK用于二次开发。 按需，或包年包月，按每坐席计费 智能座席助手 提供辅助座席进行音视频呼叫业务，为座席提供话术指导、知识支持等功能。 按需，或包年包月，按每坐席计费 预测外呼座席 适用于企业自行开发业务系统，调用平台预测外呼接口实现预测外呼功能。不包括呼入功能。 提供呼叫中心平台API用于二次开发。 按需，或包年包月，按每坐席计费 移动APP座席 适用于企业开发web业务系统或移动app应用，调用平台双呼接口，实现外呼。不包括呼入功能。 提供呼叫中心平台API用于二次开发。 按需，或包年包月，按每坐席计费 基础IVR 基础放音+收号+转座席，流程播放指定语音文件。 包年包月，按每并发路数计费 高级IVR 基础IVR+ TTS 接口（ 文字转语音 ）。 包年包月，按每并发路数计费 智能IVR 高级IVR+ASR接口，用于智能语音导航业务。 包年包月，按每并发路数计费 TTS Text to Speech，文本转化成语音。 包年包月，按每并发路数计费 ASR Automatic Speech Recognition，自动 语音识别 。 包年包月，按每并发路数计费 普通固话号码月租 - 按需或包年包月，按每个号码计费 普通固话号码月租（仅呼入） - 按需或包年包月，按每个号码计费，如企业申请的号码主要使用于呼入场景，每个月外呼通话时长少于50分钟，则需订购该类型号码。在企业申请号码时，运营商有权根据企业外呼需求决定分配何种类型的固话号码。该类型号码包括每月500分钟免费外呼通话时长。 普通固话号码通话费 - 按需，按每分钟计费，不足1分钟按1分钟计费，只计算外呼时长，呼入免费 95号码通话费 - 按需，按每分钟计费，不足1分钟按1分钟计费，呼入呼出均需收费 续费：以包年包月方式订购的产品可续费，可按年或月为续费周期，一个计费周期到期后，您可以选择自动续费，继续使用资源，也可以选择中止服务。按需计费无需续费； 为了避免到期后忘记续订导致资源被冻结，如选择包月模式，建议在订购时选择自动续费。 举例：假设企业原套餐在2020年2月2日00:00:00资源到期，企业选择续费1年，续费周期起点是2020年2月2日00:00:00，终点是2021年2月3日00:00:00。 退订：支持退订，可咨询云管理员。 以包年包月方式订购具体退订规则请参考：https://support.huaweicloud.com/usermanual-billing/zh-cn_topic_0083138805.html。以按需方式订购的产品可直接在云客服Console中删除，删除后将不再扣费。 扣费：对于按需方式订购的坐席产品和号码月租，在每月1日00:00，系统将自动统计上月的使用量，根据产品单价计算账单金额，自动从企业云账号扣费，如该账号已经申请了商务折扣，会按照折扣价计算。对于号码通信费用，则是每天00:00统计前一天通话时长后计算费用，自动从企业云账号扣费。

为什么需要NQA 随着运营商增值业务的开展，用户和运营商对QoS（Quality of Service）的相关要求越来越高，特别是在传统的IP网络承载语音和视频业务后，运营商与客户之间签订SLA（Service Level Agreement）成为普遍现象。 为了让用户看到承诺的带宽是否达到需求，运营商需要提供相关的时延、抖动、丢包率等相关的统计参数，以及时了解网络的性能状况。传统的网络性能分析方法（如Ping、Tracert等）已经不能满足用户对业务多样性和监测实时性的要求。NQA可以实现对网络运行状况的准确测试，输出统计信息。NQA可以监测网络上运行的多种协议的性能，使网络运营商能够实时采集到各种网络运行指标，例如：HTTP的总时延、TCP连接时延、DNS解析时延、文件传输速率、FTP连接时延、DNS解析错误率等。通过对这些指标进行控制，网络运营商可以为用户提供不同等级的网络服务。同时，NQA也是网络故障诊断和定位的有效工具。

静态路由与NQA联动 静态路由本身并没有检测机制，如果非本机直连链路发生了故障，静态路由不会自动从IP路由表中自动删除，需要网络管理员介入，这就无法保证及时进行链路切换，可能造成较长时间的业务中断。 使用静态路由模式创建VPN连接时，为了避免出现以上问题，需要使用NQA来检测静态路由所在的链路，确保VPN连接稳定性。使能NQA时需要确保对端网关设备支持ICMP功能，且对端接口地址已在对端网关上正确配置，否则可能导致流量不通。

责任共担 华为云秉承“将公司对网络和业务安全性保障的责任置于公司的商业利益之上”。针对层出不穷的 云安全 挑战和无孔不入的云安全威胁与攻击，华为云在遵从法律法规业界标准的基础上，以安全生态圈为护城河，依托华为独有的软硬件优势，构建面向不同区域和行业的完善云服务安全保障体系。 安全性是华为云与您的共同责任，如图1所示。 华为云：负责云服务自身的安全，提供安全的云。华为云的安全责任在于保障其所提供的IaaS、PaaS和SaaS各类各项云服务自身的安全，涵盖华为云数据中心的物理环境设施和运行其上的基础服务、平台服务、应用服务等。这不仅包括华为云基础设施和各项云服务技术的安全功能和性能本身，也包括运维运营安全，以及更广义的安全合规遵从。 租户：负责云服务内部的安全，安全地使用云。 华为云租户的安全责任在于对使用的IaaS、PaaS和SaaS类各项云服务内部的安全以及对租户定制配置进行安全有效的管理，包括但不限于虚拟网络、 虚拟主机 和访客虚拟机的操作系统，虚拟防火墙、API网关和高级安全服务，各项云服务，租户数据，以及身份账号和密钥管理等方面的安全配置。 《华为云安全白皮书》详细介绍华为云安全性的构建思路与措施，包括云安全战略、责任共担模型、合规与隐私、安全组织与人员、基础设施安全、租户服务与租户安全、工程安全、运维运营安全、生态安全。 图1 华为云安全责任共担模型 父主题： 安全

签名密钥 签名密钥由一对Key和Secret组成，用于后端服务验证API网关代理的身份，在API网关代理请求后端服务时，保障后端服务的安全。 当签名密钥绑定API后，API网关代理向后端服务发送此API的请求时，会增加相应的签名信息，此时，后端服务依照同样方式进行签名并得到签名结果，如果签名结果和API网关代理传过来的Authorization头中的签名一致，则可证明API请求确实来自API网关代理，而不是其他伪造请求。

约束与限制 API中心的使用限制如下： 创建API资产：每个用户最多可以创建50个API资产。 API网关代理：API网关代理使用限制如表1所示。 表1 API网关代理使用限制 限制项 限制值 API分组数量 每个用户最多可以创建50个API分组。 独立 域名 数量 每个分组最多可以绑定5个独立域名。 API数量 每个用户最多可以创建200个API。 后端策略数量 每个API最多可以创建5个后端策略（不包含默认后端策略）。 凭据数量 每个用户最多可以创建50个凭据。 流量控制策略数量 每个用户最多可以创建15个流量控制策略。 签名密钥策略数量 每个用户最多可以创建5个签名密钥。 访问控制策略数量 每个用户最多可以创建5个访问控制策略。 环境数量 每个用户最多可以创建5个环境（包含默认的RELEASE环境）。 环境变量数量 每个分组在任意一个环境中，最多可以创建50个环境变量。 负载通道数量 每个用户最多可以创建10个VPC通道，每个负载通道最多可以添加10个服务器。 参数数量 每个API最多可以创建50个参数。 发布历史数量 同一个API在每个环境中最多记录10条最新的发布历史。 每个API的访问频率 不大于200次/秒。 特殊应用 每个流控策略最多可以创建30个特殊应用。 特殊租户 每个流控策略最多可以创建30个特殊租户。 子域名访问次数 每个子域名每天最多可以访问1000次。 调用请求包的大小 API每次最大可以调用12M的请求包。 TLS协议 支持TLS1.1和TLS1.2，推荐使用TLS1.2。 本章描述的“用户”指的都是华为云账号。 如果API网关代理当前的配额限制无法满足您的需求，您可以向系统提交工单申请更多配额。

状态码 状态码 描述 200 OK 400 BadRequest 401 Unauthorized 403 Forbidden 404 NotFound 405 MethodNotAllowed 406 NotAcceptable 409 Conflict 415 UnsupportedMediaType 422 Invalid 429 TooManyRequests 500 InternalError 503 ServiceUnavailable 504 ServerTimeout

响应示例 状态码： 200 OK { "apiVersion" : "extensions/v1beta1", "items" : [ { "metadata" : { "annotations" : { "deployment.kubernetes.io/revision" : "1", "service.protal.kubernetes.io/access-ip" : "10.247.51.55:123", "service.protal.kubernetes.io/type" : "ClusterIP" }, "creationTimestamp" : "2017-12-09T03:44:24Z", "generation" : 2, "labels" : { "app" : "nginx" }, "name" : "nginx", "namespace" : "default", "resourceVersion" : "28579", "selfLink" : "/apis/extensions/v1beta1/namespaces/default/deployments/nginx", "uid" : "3f7846b5-dc93-11e7-9c19-fa163e2d897b" }, "spec" : { "replicas" : 1, "selector" : { "matchLabels" : { "app" : "nginx" } }, "strategy" : { "rollingUpdate" : { "maxSurge" : 1, "maxUnavailable" : 1 }, "type" : "RollingUpdate" }, "template" : { "metadata" : { "creationTimestamp" : null, "labels" : { "app" : "nginx" } }, "spec" : { "containers" : [ { "image" : "172.16.5.235:20202/test-01/mysql:v1", "imagePullPolicy" : "Always", "name" : "nginx", "resources" : { }, "terminationMessagePath" : "/dev/termination-log", "terminationMessagePolicy" : "File" } ], "dnsPolicy" : "ClusterFirst", "restartPolicy" : "Always", "schedulerName" : "default-scheduler", "securityContext" : { } } } }, "status" : { "availableReplicas" : 1, "conditions" : [ { "lastTransitionTime" : "2017-12-09T03:44:24Z", "lastUpdateTime" : "2017-12-09T03:44:24Z", "message" : "Deployment has minimum availability.", "reason" : "MinimumReplicasAvailable", "status" : "True", "type" : "Available" } ], "observedGeneration" : 2, "readyReplicas" : 1, "replicas" : 1, "updatedReplicas" : 1 } }, { "metadata" : { "annotations" : { "deployment.kubernetes.io/revision" : "1" }, "creationTimestamp" : "2017-12-13T03:13:22Z", "generation" : 2, "labels" : { "cce/appgroup" : "deploy-ex-test" }, "name" : "deploy-ex-12130306", "namespace" : "ns-12130306-s", "resourceVersion" : "418771", "selfLink" : "/apis/extensions/v1beta1/namespaces/ns-12130306-s/deployments/deploy-ex-12130306", "uid" : "934db57d-dfb3-11e7-9c19-fa163e2d897b" }, "spec" : { "replicas" : 1, "selector" : { "matchLabels" : { "cce/appgroup" : "deploy-ex-test" } }, "strategy" : { "rollingUpdate" : { "maxSurge" : 1, "maxUnavailable" : 1 }, "type" : "RollingUpdate" }, "template" : { "metadata" : { "creationTimestamp" : null, "labels" : { "cce/appgroup" : "deploy-ex-test" } }, "spec" : { "containers" : [ { "image" : "172.16.5.235:20202/test/redis:latest", "imagePullPolicy" : "IfNotPresent", "name" : "deploycon-12130306", "resources" : { }, "terminationMessagePath" : "/dev/termination-log", "terminationMessagePolicy" : "File" } ], "dnsPolicy" : "ClusterFirst", "restartPolicy" : "Always", "schedulerName" : "default-scheduler", "securityContext" : { } } } }, "status" : { "availableReplicas" : 1, "conditions" : [ { "lastTransitionTime" : "2017-12-13T03:13:22Z", "lastUpdateTime" : "2017-12-13T03:13:22Z", "message" : "Deployment has minimum availability.", "reason" : "MinimumReplicasAvailable", "status" : "True", "type" : "Available" } ], "observedGeneration" : 2, "readyReplicas" : 1, "replicas" : 1, "updatedReplicas" : 1 } } ], "kind" : "DeploymentList", "metadata" : { "resourceVersion" : "418820", "selfLink" : "/apis/extensions/v1beta1/deployments" } }

URI GET /apis/apps/v1/deployments 表1 Query参数 参数 是否必选 参数类型 描述 allowWatchBookmarks 否 Boolean allowWatchBookmarks requests watch events with type "BOOKMARK". Servers that do not implement bookmarks may ignore this flag and bookmarks are sent at the server's discretion. Clients should not assume bookmarks are returned at any specific interval, nor may they assume the server will send any BOOKMARK event during a session. If this is not a watch, this field is ignored. If the feature gate WatchBookmarks is not enabled in apiserver, this field is ignored. continue 否 String The continue option should be set when retrieving more results from the server. Since this value is server defined, clients may only use the continue value from a previous query result with identical query parameters (except for the value of continue) and the server may reject a continue value it does not recognize. If the specified continue value is no longer valid whether due to expiration (generally five to fifteen minutes) or a configuration change on the server, the server will respond with a 410 ResourceExpired error together with a continue token. If the client needs a consistent list, it must restart their list without the continue field. Otherwise, the client may send another list request with the token received with the 410 error, the server will respond with a list starting from the next key, but from the latest snapshot, which is inconsistent from the previous list results - objects that are created, modified, or deleted after the first list request will be included in the response, as long as their keys are after the "next key". This field is not supported when watch is true. Clients may start a watch from the last resourceVersion value returned by the server and not miss any modifications. fieldSelector 否 String A selector to restrict the list of returned objects by their fields. Defaults to everything. labelSelector 否 String A selector to restrict the list of returned objects by their labels. Defaults to everything. limit 否 Integer limit is a maximum number of responses to return for a list call. If more items exist, the server will set the continue field on the list metadata to a value that can be used with the same initial query to retrieve the next set of results. Setting a limit may return fewer than the requested amount of items (up to zero items) in the event all requested objects are filtered out and clients should only use the presence of the continue field to determine whether more results are available. Servers may choose not to support the limit argument and will return all of the available results. If limit is specified and the continue field is empty, clients may assume that no more results are available. This field is not supported if watch is true. The server guarantees that the objects returned when using continue will be identical to issuing a single list call without a limit - that is, no objects created, modified, or deleted after the first request is issued will be included in any subsequent continued requests. This is sometimes referred to as a consistent snapshot, and ensures that a client that is using limit to receive smaller chunks of a very large result can ensure they see all possible objects. If objects are updated during a chunked list the version of the object that was present at the time the first list result was calculated is returned. pretty 否 String If 'true', then the output is pretty printed. resourceVersion 否 String resourceVersion sets a constraint on what resource versions a request may be served from. See https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions for details. Defaults to unset resourceVersionMatch 否 String resourceVersionMatch determines how resourceVersion is applied to list calls. It is highly recommended that resourceVersionMatch be set for list calls where resourceVersion is set See https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions for details. Defaults to unset timeoutSeconds 否 Integer Timeout for the list/watch call. This limits the duration of the call, regardless of any activity or inactivity. watch 否 Boolean Watch for changes to the described resources and return them as a stream of add, update, and remove notifications. Specify resourceVersion.

状态码 状态码 描述 200 OK 400 BadRequest 401 Unauthorized 403 Forbidden 404 NotFound 405 MethodNotAllowed 406 NotAcceptable 409 Conflict 415 UnsupportedMediaType 422 Invalid 429 TooManyRequests 500 InternalError 503 ServiceUnavailable 504 ServerTimeout

URI GET /apis/apps/v1/namespaces/{namespace}/statefulsets/{name}/status 表1 路径参数 参数 是否必选 参数类型 描述 name 是 String name of the StatefulSet namespace 是 String object name and auth scope, such as for teams and projects 表2 Query参数 参数 是否必选 参数类型 描述 pretty 否 String If 'true', then the output is pretty printed.

响应示例 状态码： 200 OK { "apiVersion" : "apps/v1", "kind" : "StatefulSet", "metadata" : { "creationTimestamp" : "2018-09-04T07:13:00Z", "generation" : 1, "labels" : { "app" : "statefulset-test" }, "name" : "statefulset-test", "namespace" : "namespace-test", "resourceVersion" : "5217947", "selfLink" : "/apis/apps/v1/namespaces/namespace-test/statefulsets/statefulset-test/status", "uid" : "f4a35f35-b011-11e8-b6ef-f898ef6c78b4" }, "spec" : { "podManagementPolicy" : "OrderedReady", "replicas" : 3, "revisionHistoryLimit" : 10, "selector" : { "matchLabels" : { "app" : "statefulset-test" } }, "serviceName" : "", "template" : { "metadata" : { "annotations" : { "cri.cci.io/container-type" : "secure-container" }, "creationTimestamp" : null, "labels" : { "app" : "statefulset-test" } }, "spec" : { "containers" : [ { "image" : "*.*.*.*:20202/cci/redis:V1", "imagePullPolicy" : "IfNotPresent", "name" : "container-0", "resources" : { "limits" : { "cpu" : "500m", "memory" : "1Gi" }, "requests" : { "cpu" : "500m", "memory" : "1Gi" } }, "terminationMessagePath" : "/dev/termination-log", "terminationMessagePolicy" : "File" } ], "dnsPolicy" : "ClusterFirst", "imagePullSecrets" : [ { "name" : "imagepull-secret" } ], "restartPolicy" : "Always", "schedulerName" : "default-scheduler", "securityContext" : { } } }, "updateStrategy" : { "type" : "OnDelete" } }, "status" : { "collisionCount" : 0, "currentReplicas" : 3, "currentRevision" : "statefulset-test-f986b645b", "observedGeneration" : 1, "readyReplicas" : 1, "replicas" : 3, "updateRevision" : "statefulset-test-f986b645b" } }

响应示例 状态码： 200 OK { "apiVersion" : "v1", "kind" : "APIGroup", "name" : "batch", "preferredVersion" : { "groupVersion" : "batch/v1", "version" : "v1" }, "versions" : [ { "groupVersion" : "batch/v1", "version" : "v1" }, { "groupVersion" : "batch/v1beta1", "version" : "v1beta1" }, { "groupVersion" : "batch/v2alpha1", "version" : "v2alpha1" } ] }

状态码 状态码 描述 200 OK 400 BadRequest 401 Unauthorized 403 Forbidden 404 NotFound 405 MethodNotAllowed 406 NotAcceptable 409 Conflict 415 UnsupportedMediaType 422 Invalid 429 TooManyRequests 500 InternalError 503 ServiceUnavailable 504 ServerTimeout

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 apiVersion String APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources kind String Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds name String name is the name of the group. preferredVersion io.k8s.apimachinery.pkg.apis.meta.v1.GroupVersionForDiscovery object preferredVersion is the version preferred by the API server, which probably is the storage version. serverAddressByClientCIDRs Array of io.k8s.apimachinery.pkg.apis.meta.v1.ServerAddressByClientCIDR objects a map of client CIDR to server address that is serving this group. This is to help clients reach servers in the most network-efficient way possible. Clients can use the appropriate server address as per the CIDR that they match. In case of multiple matches, clients should use the longest matching CIDR. The server returns only those CIDRs that it thinks that the client can match. For example: the master will return an internal IP CIDR only, if the client reaches the server using an internal IP. Server looks at X-Forwarded-For header or X-Real-Ip header or request.RemoteAddr (in that order) to get the client IP. versions Array of io.k8s.apimachinery.pkg.apis.meta.v1.GroupVersionForDiscovery objects versions are the versions supported in this group. 表3 io.k8s.apimachinery.pkg.apis.meta.v1.GroupVersionForDiscovery 参数 参数类型 描述 groupVersion String groupVersion specifies the API group and version in the form "group/version" version String version specifies the version in the form of "version". This is to save the clients the trouble of splitting the GroupVersion. 表4 io.k8s.apimachinery.pkg.apis.meta.v1.ServerAddressByClientCIDR 参数 参数类型 描述 clientCIDR String The CIDR with which clients can match their IP to figure out the server address that they should use. serverAddress String Address of this server, suitable for a client that matches the above CIDR. This can be a hostname, hostname:port, IP or IP:port.

请求示例 将已创建EIPPool中的label值替换为"some-key" : "some-value"。 { "apiVersion" : "crd.yangtse.cni/v1", "kind" : "EIPPool", "metadata" : { "creationTimestamp" : "2022-09-07T01:22:50Z", "finalizers" : [ "yangtse.io/eip-pool" ], "generation" : 1, "labels" : { "some-key" : "some-value" }, "name" : "eippool-test", "namespace" : "namespace-test", "resourceVersion" : "42396258", "selfLink" : "/apis/crd.yangtse.cni/v1/namespaces/namespace-test/eippools/eippool-test", "uid" : "e4dc5432-1d9b-4fcb-8840-ee445b6511ae" }, "spec" : { "amount" : 1, "eipAttributes" : { "bandwidth" : { "chargeMode" : "bandwidth", "name" : "eip-test", "shareType" : "PER", "size" : 5 }, "ipVersion" : 4, "networkType" : "5_g-vm" } }, "status" : { "eips" : [ { "alias" : "eip-test", "bandWidthChargeMode" : "bandwidth", "bandwidthShareType" : "PER", "bandwidthSize" : 5, "id" : "034a0bae-81f7-46f4-b933-3273adc32b54", "ipv4" : "100.85.221.2", "networkType" : "5_g-vm", "status" : "DOWN" } ], "usage" : "0/1" } }

响应示例 状态码： 200 OK { "apiVersion" : "crd.yangtse.cni/v1", "kind" : "EIPPool", "metadata" : { "creationTimestamp" : "2022-09-07T01:22:50Z", "finalizers" : [ "yangtse.io/eip-pool" ], "generation" : 1, "labels" : { "some-key" : "some-value" }, "name" : "eippool-test", "namespace" : "namespace-test", "resourceVersion" : "42396258", "selfLink" : "/apis/crd.yangtse.cni/v1/namespaces/namespace-test/eippools/eippool-test", "uid" : "e4dc5432-1d9b-4fcb-8840-ee445b6511ae" }, "spec" : { "amount" : 1, "eipAttributes" : { "bandwidth" : { "chargeMode" : "bandwidth", "name" : "eip-test", "shareType" : "PER", "size" : 5 }, "ipVersion" : 4, "networkType" : "5_g-vm" } }, "status" : { "eips" : [ { "alias" : "eip-test", "bandWidthChargeMode" : "bandwidth", "bandwidthShareType" : "PER", "bandwidthSize" : 5, "id" : "034a0bae-81f7-46f4-b933-3273adc32b54", "ipv4" : "100.85.221.2", "networkType" : "5_g-vm", "status" : "DOWN" } ], "usage" : "0/1" } }

状态码 状态码 描述 200 OK 201 Created 400 BadRequest 401 Unauthorized 403 Forbidden 404 NotFound 405 MethodNotAllowed 406 NotAcceptable 409 Conflict 415 UnsupportedMediaType 422 Invalid 429 TooManyRequests 500 InternalError 503 ServiceUnavailable 504 ServerTimeout

URI PUT /apis/crd.yangtse.cni/v1/namespaces/{namespace}/eippools/{name} 表1 路径参数 参数 是否必选 参数类型 描述 name 是 String name of the EIPPool namespace 是 String object name and auth scope, such as for teams and projects 表2 Query参数 参数 是否必选 参数类型 描述 dryRun 否 String When present, indicates that modifications should not be persisted. An invalid or unrecognized dryRun directive will result in an error response and no further processing of the request. Valid values are: - All: all dry run stages will be processed fieldManager 否 String fieldManager is a name associated with the actor or entity that is making these changes. The value must be less than or 128 characters long, and only contain printable characters, as defined by https://golang.org/pkg/unicode/#IsPrint. pretty 否 String If 'true', then the output is pretty printed.

URI GET /api/v1/namespaces/{name} 表1 路径参数 参数 是否必选 参数类型 描述 name 是 String name of the Namespace 表2 Query参数 参数 是否必选 参数类型 描述 exact 否 Boolean Should the export be exact. Exact export maintains cluster-specific fields like 'Namespace'. Deprecated. Planned for removal in 1.18. export 否 Boolean Should this value be exported. Export strips fields that a user can not specify. Deprecated. Planned for removal in 1.18. pretty 否 String If 'true', then the output is pretty printed.

状态码 状态码 描述 200 OK 400 BadRequest 401 Unauthorized 403 Forbidden 404 NotFound 405 MethodNotAllowed 406 NotAcceptable 409 Conflict 415 UnsupportedMediaType 422 Invalid 429 TooManyRequests 500 InternalError 503 ServiceUnavailable 504 ServerTimeout

响应示例 状态码： 200 OK { "metadata" : { "annotations" : { "namespace.kubernetes.io/flavor" : "gpu-accelerated", "pv.kubernetes.io/enable-dynamic-provisioning" : "true", "tenant.kubernetes.io/domain-id" : "aadb43c0b14c4cafbccfff483d075987", "tenant.kubernetes.io/domain-name" : "cci", "tenant.kubernetes.io/project-id" : "51bf52609f2a49c68bfda3398817b376", "tenant.kubernetes.io/project-name" : "southchina" }, "creationTimestamp" : "2018-09-03T11:20:48Z", "name" : "namespace-test", "resourceVersion" : "5016746", "selfLink" : "/api/v1/namespaces/namespace-test", "uid" : "68a68c5a-af6b-11e8-8f17-c81fbe371a17" }, "spec" : { "finalizers" : [ "kubernetes" ] }, "status" : { "phase" : "Active" } }