云服务器内容精选

  • URI GET https://{Endpoint}/v3/{project_id}/instances/{instance_id}/auto-enlarge-policy 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 instance_id 是 String 实例ID,严格匹配UUID规则。
  • 响应参数 表2 响应Body参数 参数 参数类型 描述 switch_option Boolean 磁盘自动扩容开关。 limit_volume_size Integer 存储自动扩容上限。 min_volume_size Integer 最小扩容磁盘容量。 max_volume_size Integer 最大扩容磁盘容量。 trigger_available_percent Integer 可用存储空间率。 percents Array of integers 空间率集合。 step_size Interger 扩容步长,固定大小扩容方式。 step_percent Interger 扩容步长,百分比扩容方式。
  • 响应示例 查询磁盘自动扩容策略成功。 { "switch_option" : true, "limit_volume_size" : 200, "min_volume_size" : 160, "max_volume_size" : 240, "trigger_available_percent" : 20, "percents": [ 20, 25, 50 ], "step_size": 200, "step_percent": null }
  • 接口约束 该接口仅支持MySQL、PostgreSQL引擎。 Serverless型实例不支持该接口。 RDS for PostgreSQL实例中存在异常节点,无法升级小版本。 对于RDS for PostgreSQL 11版本,如果内核小版本小于11.2,则不支持小版本升级。 只支持立即升级,不支持可维护时间段内升级小版本。 RDS for PostgreSQL升级内核小版本后,有可能导致主备节点倒换。
  • 前提条件 需要具备AppStage服务运维岗位权限,权限申请操作请参见申请权限。 创建平台托管模式的实例,需规划隔离域,具体请参见隔离域配置。 申请SLB机器需要业务提前规划好隔离域,否则会申请失败。隔离域规划的目的:建立隔离域与产品/自有服务、资源类型的关联关系,指定隔离域下的网络互通规则作用于哪些服务和BaaS实例(同一个隔离域网络默认互通,不同隔离域网络默认不通),通过弹性网络服务(ENS)规划好隔离域后,IaC文件可以不定义隔离域,各BaaS服务根据站点、产品、服务、资源类型找到隔离域。 创建自管理模式的SLB实例,指的是将公有云ECS作为SLB主机,需要先申请ECS并将ECS纳管至运维中心的VMS中。 仅支持EulerOS操作系统ECS作为SLB主机。1.4.18及更新版本的SLB只兼容EulerOS 2.9操作系统。 已设置执行机。
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 phones Array of Phone objects 云手机信息。 request_id String 请求的唯一标识ID。 count Integer 实例总数。 表5 Phone 参数 参数类型 描述 phone_name String 云手机的名称,不超过65个字符。 server_id String 云手机所在的服务器ID,不超过32个字节。 phone_id String 云手机的唯一标识,不超过32个字节。 phone_model_name String 云手机规格名称,不超过64个字节。 image_id String 云手机镜像ID,不超过32个字节。 image_version String 镜像版本。 vnc_enable String 云手机是否开启VNC服务。 true:开启 false:不开启 status Integer 云手机状态。 0: 创建中 1:创建中 2:运行中 3:重置中 4:重启中 6:冻结 7:正在关机 8:已关机 -5:重置失败 -6:重启失败 -7:手机异常 -8:创建失败 -9:关机失败 type Integer 云手机类型。 0:普通云手机 1:试玩云手机 imei String imei码。 traffic_type String 手机路由类型。 direct:默认路由 routing:路由到编码容器 volume_mode Integer 手机物理磁盘是否独立。 0:不独立 1:独立 availability_zone String 云手机服务器所在的可用区。 metadata metadata object 订单以及产品相关信息。 create_time String 创建时间, 时间格式为UTC。 update_time String 更新时间, 时间格式为UTC。 表6 metadata 参数 参数类型 描述 order_id String 订单ID,不超过64个字节。 product_id String 产品ID,不超过64个字节。
  • 响应示例 状态码: 200 OK { "request_id" : "6a63a18b8bab40ffb71ebd9cb80d0085", "count" : 1, "phones" : [ { "phone_name" : "mobile-0001", "server_id" : "88b8449b896f3a4f0ad57222dd91909", "phone_id" : "1234567b8bab40ffb711234cb80d0234", "phone_model_name" : "AOSP-1U4G15G-001", "image_version" : "AOSP 7.0", "image_id" : "88b8449b896f3a4f0ad57222dd91909", "vnc_enable" : "true", "status" : 2, "type" : 0, "imei" : "869287243397729", "availability_zone" : "cn-southwest-242b", "traffic_type" : "direct", "volume_mode" : 0, "metadata" : { "order_id" : "CS1710111105S8IPB", "product_id" : "00301-25217-0--0" }, "create_time" : "2017-10-10T00:00:00Z", "update_time" : "2018-10-10T00:00:00Z" } ] }
  • URI GET /v1/{project_id}/cloud-phone/phones 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目id。 表2 Query参数 参数 是否必选 参数类型 描述 offset 否 Integer 偏移量为一个大于等于0整数,表示查询该偏移量后面的所有的资源数,默认值为0。 limit 否 Integer 每页返回的资源个数。取值范围:1~200(默认值为200),一般设置为10、20、50。 phone_name 否 String 云手机名称,支持模糊查询。 server_id 否 String 云手机服务器的唯一标识。 status 否 Integer 云手机状态。 1:创建中 2:运行中 3:重置中 4:重启中 6:冻结 7:正在关机 8:已关机 -5:重置失败 -6:重启失败 -7:手机异常 -8:创建失败 -9:关机失败 type 否 Integer 云手机类型。 0:普通云手机
  • 实例计费方式更改 支持实例包周期和按需计费方式互换。注意包周期转按需计费生效的前提是包周期已到期。 在左侧导航栏单击“实例管理”。 在需要更改计费方式的实例上,单击“更多”,选择“转包周期”或“转按需”。 按需转包周期:选择续费时长,单击“去支付”,完成付款即可。 包周期转按需:包周期转按需生效的前提是包周期已到期,包周期转按需操作可在包周期到期前或包周期到期后的冻结期内执行。单击“转按需”即可。
  • 购买的约束说明 创建实例存在一些约束,当您登录后无法创建实例,或者创建失败,请参考以下约束说明进行检查,并解除限制。 实例配额 同一项目ID下,一个主账号默认只能创建5个实例。如果您需要创建更多实例,可提交工单,申请修改配额。 用户权限 如果您使用系统角色相关权限,需要同时拥有“APIG Administrator”和“VPC Administrator”权限才能创建实例。 如果您使用系统策略,则拥有“APIG FullAccess”即可。 如果使用自定义策略,请参考对用户组授权。 子网中可用私有地址数量 API网关专享实例的基础版、专业版、企业版,以及铂金版分别需要3、5、6、7个私有地址。在铂金版的基础上,铂金版X依次增加4个私有地址。请确保您选择的子网段有足够多的私有地址可用,私有地址可在虚拟私有云服务的控制台查询。
  • 网络环境准备 负载 虚拟私有云(Virtual Private Cloud,简称VPC)。实例需要配置虚拟私有云(负载),在同一负载中的资源(如ECS),可以使用实例的私有地址调用API。 在创建实例时,建议配置和您其他关联业务相同负载,确保网络安全的同时,方便网络配置。 创建实例后,不支持修改虚拟私有云(负载)。 弹性公网IP 实例的API如果要允许外部调用,则需要创建一个弹性公网IP,并与实例绑定,作为实例的公网入口。 如果API的后端服务部署在公网,还需要有公网出口访问权限,这由API网关统一规划,不需要单独创建弹性公网IP。 安全组 安全组类似防火墙,控制谁能访问实例的指定端口,以及控制实例的通信数据流向指定的目的地址。安全组入方向规则建议按需开放地址与端口,这样可以保护实例的网络安全。 实例绑定的安全组有如下要求: 入方向:如果需要从公网调用API,或从其他安全组内资源调用API,则需要为实例绑定的安全组的入方向放开80(HTTP)、443(HTTPS)两个端口。 出方向:如果后端服务部署在公网,或者其他安全组内,则需要为实例绑定的安全组的出方向放开后端服务地址与API调用端口。 如果API的前后端服务与实例绑定了相同的安全组、相同的虚拟私有云,则无需专门为实例开放上述端口。
  • 操作步骤 进入购买实例页面。 除墨西哥城一、北京一区域外,在其他区域购买实例后默认开启ELB负载。开启ELB负载的实例暂不支持安全组配置,如需禁用部分IP请使用访问控制策略。 开启ELB负载:ELB作为网关入口的负载均衡器,入口支持跨VPC访问。但在开启公网入口时,弹性IP地址由网关随机分配,不支持选择已有弹性IP地址。 根据下表参数说明,配置实例参数。 表1 API网关实例参数说明 信息项 描述 计费模式 实例收费方式,当前支持“按需计费”和“包周期”两种方式。 目前仅北京一、北京四、乌兰察布一、上海一、上海二、广州、广州-友好用户环境和贵阳一支持包周期收费方式。 区域 指APIG实例部署的区域,建议和您其他的业务部署在相同区域,这样不同的业务可以在负载内以子网方式通信,节省公网带宽成本,降低网络延时。 可用区 指同一区域内电力、网络等资源物理隔离的地理区域,一般为互相独立的机房。 APIG实例支持同时选择多个可用区,进行跨可用区部署,提升实例高可用性。 APIG不支持跨可用区迁移实例。 实例名称 实例的名称,根据规划自定义。 实例规格 当前开放基础版、专业版、企业版、铂金版实例。不同实例规格,对API请求的并发支持能力不同,具体请参考《API网关产品介绍》的规格说明章节。 说明: 目前仅上海一和北京四区域支持选择更多铂金版规格。 可维护时间窗 指允许云服务技术支持对实例进行维护的时间段。如果有维护需要,技术支持会提前与您沟通确认。 建议选择业务量较少的时间段。 企业项目 使用企业用户登录时,可选择实例所属企业项目。 有关企业项目的资源使用、迁移以及用户权限等,请参考《企业管理用户指南》。 公网入口 指允许外部服务通过弹性IP地址,调用实例创建的API。开启“公网入口”,需要绑定一个“弹性IP地址”,弹性IP地址另行收费。 说明: 在北京四、上海一、广州、贵阳一区域开启公网入口后,弹性IP地址由网关随机分配,不支持选择已有弹性IP地址。您可以根据业务预估设置合适的“入公网带宽”,入公网带宽费用按小时计算,以弹性IP服务的价格为准。 您需要使用独立域名/调试域名访问,使用调试域名访问时存在单日访问次数限制。可在创建API分组后,为分组绑定独立域名,独立域名需要解析到实例的弹性IP地址。 例如您有一个API,请求协议为HTTPS,Path为/apidemo,开启了公网访问,并为分组绑定了独立域名后,可使用https://{domain}/apidemo这个URL访问您的API。其中,{domain}表示已绑定到分组的独立域名,目标端口443可默认缺省。 公网出口 指允许实例API的后端服务部署在外部网络,APIG为实例开启公网出口。您可以根据业务预估设置合适的“出公网带宽”,出公网带宽费用按小时计算,以弹性IP服务的价格为准。 IPv6 仅在计费模式为“按需计费”时,需要配置。 如果后端服务部署在外部网络,且需要使用IPv6地址访问,则需要勾选“支持IPv6”。 说明: 目前仅北京四支持。 网络 指为实例绑定到一个VPC,并为其分配子网。 使用已创建的VPC和子网,请在下拉列表选择当前账号下创建的VPC和子网。 使用共享VPC和子网,请在下拉列表选择其他账号共享给当前账号的VPC和子网。 共享VPC基于资源访问管理(Resource Access Manager,简称RAM)服务的机制,VPC的所有者可以将VPC内的子网共享给一个或者多个账号使用。通过共享VPC功能,可以简化网络配置,帮助您统一配置和运维多个账号下的资源,有助于提升资源的管控效率,降低运维成本。有关VPC子网共享的更多信息,请参见共享VPC。 使用新的VPC和子网,请单击“控制台”,参考创建虚拟私有云创建待使用的新VPC和子网。 安全组 安全组用于设置端口访问规则,定义哪些端口允许被外部访问,以及允许访问外部哪些地址与端口。 例如,后端服务部署在外部网络,则需要设置相应的安全组规则,允许访问后端服务地址与API调用端口。 说明: 如果开启公网入口,安全组入方向需要放开80(HTTP)和443(HTTPS)端口的访问权限。 终端节点服务名称 填写终端节点服务名称。购买实例后,同步创建VPC终端节点服务,可以被终端节点连接和访问。 如果填写了终端节点服务名称,购买实例后,在实例详情中的“终端节点管理”页签下展示名称为{region}.{终端节点服务名称}.{终端节点服务ID};如果终端节点服务名称为空,购买实例后,在实例详情中的“终端节点管理”页签下展示名称为{region}.{apig}.{终端节点服务ID}。 标签 通过标签对实例资源进行标记,批量分类实例资源,实现对实例资源进行分组查询、分析及管理。如果没有标签选择可单击“查看预定义标签”创建,也可以直接输入标签键值创建。 实例创建完成后,也可以在标签管理中设置。 说明: 如您的组织已经设定API网关服务的相关标签策略,则需按照标签策略规则为实例添加标签。标签如果不符合标签策略的规则,则可能会导致创建实例失败,请联系组织管理员了解标签策略详情。 购买时长 计费模式为“包年/包月”时配置。实例的购买时长,最短1个月。 描述 实例的描述信息。 单击“立即购买”,进入实例规格确认页面。 规格确认无误后,勾选服务协议,支付费用后,开始创建实例,界面显示创建进度。
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 表3 请求Body参数 参数 是否必选 参数类型 描述 offset 否 Integer 索引位置偏移量,表示从查询到的大Key列表偏移offset条数据后查询对应的大Key信息。 取值大于或等于0。不传该参数时,查询偏移量默认为0,表示从第一条大Key开始查询。 limit 否 Integer 查询个数上限值。取值范围:1~100。不传该参数时,默认查询前100条大Key。 key_types 否 Array of strings 大大Key的类型,一个字符串列表,支持"string"、"hash"、"zset"、"set"、"list"、"stream"六种类型。
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 keys Array of 表5 objects 查询到的大Key列表。 count Integer 大Key的总数。 表5 BigKeysInfoResponseBody 参数 参数类型 描述 db_id Integer 大Key所在的DB。 key_type String 大Key类型。 key_name String 大Key名。 key_size Integer 大Key的长度。 状态码: 400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误消息。 状态码: 500 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误消息。
  • 响应示例 状态码: 202 Accepted 创建按需实例响应样例: { "id" : "39b6a1a278844ac48119d86512e0000bin06", "name" : "test-cassandra-01", "datastore" : { "type" : "cassandra", "version" : "3.11", "storage_engine" : "rocksDB" }, "created" : "2019-10-28 14:10:54", "status" : "creating", "region" : "aaa", "availability_zone" : "bbb,ccc,ddd", "vpc_id" : "490a4a08-ef4b-44c5-94be-3051ef9e4fce", "subnet_id" : "0e2eda62-1d42-4d64-a9d1-4e9aa9cd994f", "security_group_id" : "2a1f7fc8-3307-42a7-aa6f-42c8b9b8f8c5", "mode" : "Cluster", "flavor" : [ { "num" : 3, "size" : 500, "storage" : "ULTRAHIGH", "spec_code" : "geminidb.cassandra.4xlarge.4" } ], "backup_strategy" : { "start_time" : "08:15-09:15", "keep_days" : "8" }, "enterprise_project_id" : "0", "ssl_option" : "1", "job_id" : "c010abd0-48cf-4fa8-8cbc-090f093eaa2f" } 创建包周期实例响应样例: