云服务器内容精选

  • 响应示例 状态码: 200 OK { "server_name" : "cph-418540-1620-40-old-1", "availability_zone" : "br-iaas-odin1a", "addresses" : [ { "public_ip" : "10.246.xxx.xxx", "server_ip" : "172.31.22.245", "intranet_ip" : "172.31.22.245", "access_ip" : "10.246.xxx.xxx" } ], "metadata" : { "product_id" : "OFFI451249149551403012", "order_id" : "CS2007271727F9XJE" }, "create_time" : "2020-01-01T00:00:00Z", "vpc_id" : "12021c68-730f-41fa-9884-11c616f4c9ad", "phone_model_name" : "kg1.cg.c40.d30SSD.e1v1.old", "subnet_cidr" : "172.31.0.0/16", "keypair_name" : "KeyPair-1230", "resource_project_id" : "06a5b529fa80d28b2f53c014024bed44", "server_id" : "6edb89150bc742aa81fc8ac4ff047297", "server_model_name" : "physical.kg1.4xlarge.cg", "update_time" : "2020-01-01T00:00:00Z", "cidr" : "172.31.0.0/16", "vpc_cidr" : "172.31.0.0/16", "subnet_id" : "5784d2fe-fefd-42f0-a7f1-e88454d8bc0f", "request_id" : "91d5bf46a817466daa25fc5824ab9717", "status" : 5, "network_version" : "v1", "security_groups" : [ ] }
  • 响应参数 状态码: 200 表3 响应Body参数 参数 参数类型 描述 request_id String 请求的唯一标识ID。 server_name String 云手机服务器名称, 不超过65字符,只支持英文字母、数字、汉字、下划线和中划线。 availability_zone String 云手机服务器所在的可用区。 server_id String 云手机服务器的唯一标识,不超过32个字节。 server_model_name String 云手机服务器规格名称,不超过64个字节。 phone_model_name String 云手机规格名称,不超过64个字节。 keypair_name String 连接云手机所使用的密钥对的名称,不超过64个字节。 status Integer 服务器状态。 0、1、3、4:创建中 2:异常 5:正常 8:冻结 10:关机 11:关机中 12:关机失败 13:开机中 vpc_id String 云手机服务器所属虚拟私有云(简称VPC)的ID。网络版本 network_version 取值为“v1”时,表示云手机服务器所属资源租户的VPC ID;取值为“v2”时,表示租户创建服务器时指定 VPC 的 VPC ID。 cidr String 云手机服务器所属虚拟私有云(简称VPC)的网段。网络版本 network_version 取值为“v1”时,表示云手机服务器所属资源租户的VPC CIDR;取值为“v2”时,表示租户创建服务器时指定 VPC 的 VPC CIDR。 vpc_cidr String 云手机服务器所属虚拟私有云(简称VPC)的网段。网络版本 network_version 取值为“v1”时,表示云手机服务器所属资源租户的VPC CIDR;取值为“v2”时,表示租户创建服务器时指定 VPC 的 VPC CIDR。 subnet_id String 云手机服务器所属子网的ID。仅在网络版本 network_version 取值为“v2”时,该取值表示租户创建服务器时指定子网的 ID;网络版本取值为“v1”时,该字段表示云手机服务器所属资源租户的子网ID。 subnet_cidr String 云手机服务器所属子网的网段。网络版本 network_version取值为“v2”时,表示租户创建服务器时指定子网的 CIDR;取值为“v1”时,表示云手机服务器所属资源租户的子网CIDR。 resource_project_id String 云手机服务器的项目ID。 metadata metadata object 订单以及产品相关信息。 addresses Array of Address objects 云手机服务器的IP相关信息。 band_widths Array of Bandwidth objects 云手机服务器带宽信息的结构体数组。 volumes Array of Volume objects 云手机服务器卷信息的结构体数组。 share_volume_info share_volume_info object 云手机服务器的共享存储相关信息。 network_version String 是否为自定义网络的云手机服务器标识。"v1",非自定义网络的云手机服务器。"v2",自定义网络的云手机服务器。支持按照网络版本字段进行筛选。 enterprise_project_id String 云手机服务器所属企业项目ID。 security_groups Array of strings 服务器扩展网卡绑定的安全组信息。 系统定义网络的服务器,该字段返回为空列表。 create_time String 创建时间, 时间格式为UTC,YYYY-MM-DDTHH:MM:SSZ。 update_time String 更新时间, 时间格式为UTC,YYYY-MM-DDTHH:MM:SSZ。 表4 metadata 参数 参数类型 描述 product_id String 产品ID,不超过64个字节。 order_id String 订单ID,不超过64个字节。 表5 Address 参数 参数类型 描述 intranet_ip String 云手机服务器的内网IP,过期字段。 access_ip String 云手机服务器的公网IP,过期字段。 server_ip String 云手机服务器的内网IP,新增字段。 public_ip String 云手机服务器的公网IP,新增字段。 表6 Bandwidth 参数 参数类型 描述 band_width_name String 云手机服务器的带宽名称。 band_width_id String 云手机服务器的带宽唯一标识。 band_width_size Integer 云手机服务器的带宽大小。 band_width_charge_mode Integer 云手机服务器带宽的计费方式。 0:bandwidth, 按带宽计费 1:traffic, 按流量计费 band_width_share_type Integer 云手机服务器的带宽类型。 0:per,独享带宽 1:whole,共享带宽 create_time String 带宽创建时间, 时间格式为UTC,YYYY-MM-DDTHH:MM:SSZ。 update_time String 带宽更新时间, 时间格式为UTC,YYYY-MM-DDTHH:MM:SSZ。 表7 Volume 参数 参数类型 描述 volume_name String 云手机服务器的硬盘名称。 volume_id String 云手机服务器的硬盘唯一标识。 volume_size Integer 云手机服务器的硬盘大小,单位G。 volume_type String 云手机服务器的硬盘类型。 create_time String 硬盘创建时间, 时间格式为UTC,YYYY-MM-DDTHH:MM:SSZ。 update_time String 硬盘更新时间, 时间格式为UTC,YYYY-MM-DDTHH:MM:SSZ。 表8 share_volume_info 参数 参数类型 描述 volume_type String 共享存储磁盘类型。 size Integer 共享存储大小,单位G。 version Integer 共享存储版本: 0:共享存储1.0 1:共享存储2.0
  • 请求消息 请求参数如表2所示。 表2 请求参数 参数 是否必选 参数类型 描述 vpc_id 是 String 虚拟机私有云ID ,UUID格式。 nic 是 Object 需要添加的网卡参数列表,详情请参见表3。 表3 nic字段数据结构说明 参数 是否必选 参数类型 描述 port_id 否 String 网卡ID,UUID格式。 当该字段不为空时,表示挂载指定的网卡。 说明: port_id和subnet_id不能同时为空。 网卡ID可以通过虚拟私有云的“查询端口列表”接口查询。 约束: 网卡必须带有安全组。 网卡状态必须为DOWN。 网卡的vpcid必须和传入的vpcid一致。 当port_id和subnet_id同时存在的时候,优先使用port_id。 当选择port_id不为空时,代表此时使用的是弹性网卡,此时security_groups和ip_address等参数不生效。 subnet_id 否 String 云服务器添加网卡的信息。 需要指定云服务器所属虚拟私有云下已创建的网络(network)的ID,UUID格式。 security_groups 否 Array of objects 添加网卡的安全组信息,详情请参见表4。 ip_address 否 String IP地址,无该参数表示自动分配IP地址。 表4 security_groups字段数据结构说明 参数 是否必选 参数类型 描述 id 是 String 安全组ID。
  • 请求示例 为云服务器切换VPC,添加网卡、安全组并指定IP地址。 POST https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/changevpc { "vpc_id": "d32019d3-bc6e-4319-9c1d-6722fc136a23", "nic": { "subnet_id": "d32019d3-bc6e-4319-9c1d-6722fc136a23", "security_groups": [ { "id": "f0ac4394-7e4a-4409-9701-ba8be283dbc3" } ], "ip_address": "192.168.255.1" } }
  • 功能介绍 云服务器切换虚拟私有云。 本接口为异步接口,当前云服务器切换虚拟私有云请求下发成功后会返回job_id,此时云服务器切换虚拟私有云并没有立即完成,需要通过调用查询任务的执行状态查询job状态,当Job状态为 SUCCESS 时代表云服务器虚拟私有云切换成功。 切换虚拟私有云会卸载当前主网卡,用新指定的虚拟私有云创建主网卡。 若原主网卡绑定有弹性IP,则会将弹性IP绑定到新创建的主网卡上。 切换虚拟私有云会导致云服务器网络中断,同时更改云服务器子网、IP地址、MAC地址。 虚拟私有云切换完成后,与网络配置相关的应用软件需要重新配置。与网络相关的服务也需要重新配置,例如ELB、VPN、NAT、DNS等。 切换虚拟私有云过程中,请勿操作云服务器的弹性IP,或对云服务器做其他操作。
  • 响应示例 { "job_id": "ff808082739334d80173941567f21d4f", "serverIds": [ "118258c5-0c6a-4e73-8b51-8d1ea3272e1b", "e51b9e20-7088-4914-a4f3-6c76bcfed0be" ] } 或 { "error": { "code": "request body is illegal.", "message": "Ecs.0005" } } 或 { "error": { "message": "privateIp [%s] is not in this subnet [%s]", "code": "Ecs.0005", "details": [ { "code": "Ecs.0039" } ] } }
  • 响应消息 参数 参数类型 描述 job_id String 提交任务成功后返回的任务ID,用户可以使用该ID对任务执行情况进行查询。如何根据job_id来查询Job的执行状态,请参考5.8 查询Job状态。 serverIds Array of strings 云服务器ID列表。 说明: 通过云服务器ID查询云服务器详情 ,若返回404 可能云服务器还在创建或者已经创建失败。 异常响应请参考响应(任务类),异常响应要素说明。
  • 请求示例 创建一台按需计费云服务器,操作系统为CentOS 7.6 64bit,4U8G,磁盘类型为“SSD”,绑定10M的按带宽计费的弹性公网IP,采用密钥方式登录鉴权。 POST https://{endpoint}/v1/{project_id}/cloudservers { "server": { "availability_zone":"az1-dc1", "name": "newserver", "imageRef": "67f433d8-ed0e-4321-a8a2-a71838539e09", "root_volume": { "volumetype": "SSD" }, "data_volumes": [ { "volumetype": "SSD", "size": 100, "multiattach": true, "hw:passthrough": true } ], "flavorRef": "s3.xlarge.2", "vpcid": "0dae26c9-9a70-4392-93f3-87d53115d171", "security_groups": [ { "id": "507ca48f-814c-4293-8706-300564d54620" } ], "nics": [ { "subnet_id": "157ee789-03ea-45b1-a698-76c92660dd83" } ], "publicip": { "eip": { "iptype": "5_bgp", "bandwidth": { "size": 10, "sharetype": "PER" } } }, "key_name": "sshkey-123", "count": 1, "extendparam": { "enterprise_project_id": "f8e0ecc8-3825-4ee8-9596-fb4258ffdcbb" }, "server_tags": [ { "key": "key1", "value": "value1" } ], "metadata": { "op_svc_userid": "8ea65f4099ba412883e2a0da72b96873", "agency_name": "test" } } } 发送预校验请求,检查创建弹性云服务器的请求消息是否填写了必选参数,请求格式是否正确。 POST https://{endpoint}/v1/{project_id}/cloudservers { "dry_run": true, "server": { "availability_zone":"az1-dc1", "name": "newserver", "imageRef": "1189efbf-d48b-46ad-a823-94b942e2a000", "root_volume": { "volumetype": "SSD" }, "data_volumes": [ { "volumetype": "SSD", "size": 100, "multiattach": true, "hw:passthrough": true } ], "flavorRef": "s3.xlarge.2", "vpcid": "0dae26c9-9a70-4392-93f3-87d53115d171", "security_groups": [ { "id": "507ca48f-814c-4293-8706-300564d54620" } ], "nics": [ { "subnet_id": "157ee789-03ea-45b1-a698-76c92660dd83" } ], "key_name": "sshkey-123", "count": 1 } }
  • 操作场景 分布式消息服务RocketMQ版控制台支持重启实例的某个Broker节点,或者所有Broker节点。 主节点重启过程中,客户端的生产和消费请求会被拒绝,持续时间不超过30s,建议在业务量少时重启节点。重启备节点,不会影响业务的使用。 怎么判断哪个是主节点? 主节点为“Broker ID”显示“0”的节点。 图1 重启节点 仅在RocketMQ实例4.8.0版本支持重启节点,5.x版本不支持。
  • DMS for RocketMQ请求条件 您可以在创建自定义策略时,通过添加“请求条件”(Condition元素)来控制策略何时生效。请求条件包括条件键和运算符,条件键表示策略语句的 Condition元素,分为全局级条件键和服务级条件键。全局级条件键(前缀为g:)适用于所有操作,服务级条件键(前缀为服务缩写,如dms:)仅适用于对应服务的操作。运算符与条件键一起使用,构成完整的条件判断语句。 DMS for RocketMQ通过IAM预置了一组条件键,例如,您可以先使用dms:ssl条件键检查RocketMQ实例是否开启SSL,然后再允许执行操作。下表显示了适用于DMS for RocketMQ服务特定的条件键。 表1 DMS for RocketMQ请求条件 DMS for RocketMQ条件键 运算符 描述 dms:publicIP Bool Null 是否开启公网 dms:ssl Bool Null 是否开启SSL
  • 示例流程 图1 给用户授权DMS for RocketMQ权限流程 创建用户组并授权 在IAM控制台创建用户组,并授予DMS for RocketMQ的管理员权限“DMS ReadOnlyAccess”。 创建用户并加入用户组 在IAM控制台创建用户,并将其加入1中创建的用户组。 用户登录并验证权限 新创建的用户登录控制台,切换至授权区域,验证权限: 在“服务列表”中选择分布式消息服务RocketMQ版,进入RocketMQ实例主界面,单击右上角“购买RocketMQ实例”,尝试购买RocketMQ实例,如果无法购买RocketMQ实例(假设当前权限仅包含DMS ReadOnlyAccess),表示“DMS ReadOnlyAccess”已生效。 在“服务列表”中选择云硬盘(假设当前策略仅包含DMS ReadOnlyAccess),若提示权限不足,表示“DMS ReadOnlyAccess”已生效。
  • DMS for RocketMQ自定义策略样例 如果系统预置的DMS for RocketMQ权限,不满足您的授权要求,可以创建自定义策略。自定义策略中可以添加的授权项(Action)请参考细粒度策略支持的授权项。 目前华为云支持以下两种方式创建自定义策略: 可视化视图创建自定义策略:无需了解策略语法,按可视化视图导航栏选择云服务、操作、资源、条件等策略内容,可自动生成策略。 JSON视图创建自定义策略:可以在选择策略模板后,根据具体需求编辑策略内容;也可以直接在编辑框内编写JSON格式的策略内容。 具体创建步骤请参见:创建自定义策略。本章为您介绍常用的DMS for RocketMQ自定义策略样例。 DMS for RocketMQ的权限与策略基于分布式消息服务DMS,因此在IAM服务中为DMS for RocketMQ分配用户与权限时,请选择并使用“DMS”的权限与策略。 示例1:授权用户删除实例和重启实例 { "Version": "1.1", "Statement": [ { "Effect": "Allow", "Action": [ "dms:instance:modifyStatus", "dms:instance:delete" ] } ] } 示例2:拒绝用户删除实例 拒绝策略需要同时配合其他策略使用,否则没有实际作用。用户被授予的策略中,一个授权项的作用如果同时存在Allow和Deny,则遵循Deny优先原则。 如果您给用户授予DMS FullAccess的系统策略,但不希望用户拥有DMS FullAccess中定义的删除实例权限,您可以创建一条拒绝删除实例的自定义策略,然后同时将DMS FullAccess和拒绝策略授予用户,根据Deny优先原则,则用户可以对DMS for RocketMQ执行除了删除实例外的所有操作。拒绝策略示例如下: { "Version": "1.1", "Statement": [ { "Effect": "Deny", "Action": [ "dms:instance:delete" ] } ] }
  • 什么是死信队列? 死信队列用于处理无法被正常消费的消息。 一条消息初次消费失败会被重试消费,若重试次数达到最大值(默认16次,在客户端可配置)时,依然消费失败,则其将被投递到该消费者对应的特殊队列(即死信队列)中,这种消息被称为死信消息。 死信消息具有如下特性: 不会再被消费者正常消费。 死信消息默认保留时间为48小时,超时后,会被自动删除。如果想要修改死信消息保留时间,请参考修改RocketMQ消息保留时间。
  • 操作场景 本章节主要介绍如何查询、导出和重新投递死信消息。 分布式消息服务RocketMQ版提供三种死信消息查询的方法:按Group查询、按Message ID查询和按Message Key查询。 按Group查询:查询某时间段内指定消费组下所有的死信消息。此方法属于范围查询,查询到的死信消息可能比较多。 按Message ID查询:查询指定Message ID的消息。此方法属于精确查找,可以快速查询到某一条死信消息。 按Message Key查询:查询指定Message Key的消息。此方法属于精确查找,可以快速查询到某一条死信消息。
  • 操作步骤 登录分布式缓存服务管理控制台。 在管理控制台左上角单击,选择实例所在的区域。 单击左侧菜单栏的“缓存管理”,进入实例信息页面。 “缓存管理”支持通过筛选来查询对应的缓存实例。支持的筛选条件有“名称”、“规格”、“ID”、“IP地址”、“可用区”、“状态”、“实例类型”、“缓存类型”等。 在需要备份的DCS缓存实例左侧,单击实例名称,进入实例的基本信息页面。 单击“备份与恢复”页签,进入备份与恢复管理页面。 单击“手动备份”,弹出手动备份窗口。 选择备份格式,支持选择RDB格式或AOF格式。 Redis 4.0、5.0、6.0基础版和企业版高性能型实例支持选择RDB或AOF备份格式,企业版存储型实例仅支持RDB格式,Redis 3.0实例仅支持RDB格式。 AOF格式的备份会优先在从节点备份,从节点AOF会被重写。 单击“确定”,开始执行手工备份任务。 备注说明最长不能超过128个字节。 实例备份需耗时10~15分钟,备份期间发生的数据新增或修改记录,将不会保存到备份数据中。