jancd/qiniu-developer_ShareGPT huggingface dataset:
human: 如何处理七牛云的云主机修改安全组

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 安全组 >修改安全组

#  修改安全组

最近更新时间: 2021-06-03 11:45:00

# 请求路径

> `PUT` /v1/vm/sgr/:security_group_id

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
security_group_id | string | path | 是 | 安全组 ID  
region_id | string | body | 是 | 安全组所属地域ID。您可以调用 DescribeRegions 查看最新的七牛云地域列表。  
security_group_name | string | body | 否 | 安全组名称  
description | string | body | 否 | 安全组描述  
  
# 返回值

名称 | 类型 | 描述  
---|---|---  
request_id | string | 请求 ID  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的云主机删除安全组

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 安全组 >删除安全组

#  删除安全组

最近更新时间: 2021-06-03 11:50:18

# 请求路径

> `DELETE` /v1/vm/instance/:security_group_id

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
region_id | string | body | 是 | 安全组所属地域ID。您可以调用 DescribeRegions 查看最新的七牛云地域列表。  
security_group_id | string | path | 是 | 安全组ID。您可以调用 DescribeSecurityGroups 查看您可用的安全组。  
  
# 返回值

名称 | 类型 | 描述  
---|---|---  
request_id | string | 请求 ID  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的云主机绑定安全组

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 安全组 >绑定安全组

#  绑定安全组

最近更新时间: 2021-06-03 11:50:32

# 请求路径

> `POST` /v1/vm/instance/:instance_id/security_group/join

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
instance_id | string | path | 是 | 主机实例 ID  
region_id | string | body | 是 | 安全组所属地域ID。您可以调用 DescribeRegions 查看最新的七牛云地域列表。  
security_group_id | string | body | 是 | 安全组ID。您可以调用 DescribeSecurityGroups 查看您可用的安全组。  
  
# 返回值

名称 | 类型 | 描述  
---|---|---  
request_id | string | 请求 ID  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的云主机解绑安全组

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 安全组 >解绑安全组

#  解绑安全组

最近更新时间: 2020-12-29 16:46:16

# 请求路径

> `POST` /v1/vm/instance/:instance_id/security_group/leave

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
instance_id | string | path | 是 | 主机实例 ID  
region_id | string | body | 是 | 安全组所属地域ID。您可以调用 DescribeRegions 查看最新的七牛云地域列表。  
security_group_id | string | body | 是 | 安全组ID。您可以调用 DescribeSecurityGroups 查看您可用的安全组。  
  
# 返回值

名称 | 类型 | 描述  
---|---|---  
request_id | string | 请求 ID  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的云主机创建安全组入网规则

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 安全组 >创建安全组入网规则

#  创建安全组入网规则

最近更新时间: 2021-05-28 16:12:40

# 请求路径

> `POST` /v1/vm/sgr/:security_group_id/ingress

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
security_group_id | string | path | 是 |  安全组 ID。您可以调用 DescribeSecurityGroups 查看您可用的安全组。  
region_id | string | body | 是 |  安全组所属地域 ID。您可以调用 DescribeRegions 查看最新的七牛云地域列表。  
auth_type | string | body | 是 |  授权类型，ip_cidr: IP地址或ip段，security_group_id: 安全组id, ipv6_cidr: ipv6地址  
auth_list | []string | body | 是 |  授权列表，只能是ip地址段、ipv6地址或者安全组id。  
支持一次性授权多个相同授权类型的值。  
port_range_list | []string | body | 是 |  端口范围列表，支持一次性设置多个端口范围。 

  * TCP/UDP 协议：取值范围为 1~65535。使用斜线（/）隔开起始端口和终止端口。例如：1/200
  * ICMP 协议：-1/-1
  * GRE 协议：-1/-1
  * IpProtocol 取值为 all：-1/-1

  
ip_protocol | string | body | 否 |  传输层协议。取值大小写敏感。取值范围：

  * tcp
  * udp
  * icmp: 仅支持 IPv4 地址。
  * gre
  * all：支持所有协议

  
policy | string | body | 否 |  设置访问权限。取值范围：

  * accept（默认）：接受访问。
  * drop：拒绝访问，不返回拒绝信息，表现为发起端请求超时或者无法建立连接的类似信息。

  
priority | integer | body | 否 |  安全组规则优先级，数字越小，代表优先级越高。取值范围：1~100 默认值：1  
description | string | body | 否 |  安全组规则的描述信息。长度为 1~512 个字符  
  
# 返回值

名称 | 类型 | 描述  
---|---|---  
request_id | string | 请求 ID  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的云主机删除安全组入网规则

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 安全组 >删除安全组入网规则

#  删除安全组入网规则

最近更新时间: 2020-12-29 16:51:19

# 请求路径

> `DELETET` /v1/vm/sgr/:security_group_id/ingress

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
security_group_id | string | path | 是 |  安全组 ID。您可以调用 DescribeSecurityGroups 查看您可用的安全组。  
region_id | string | body | 是 |  安全组所属地域 ID。您可以调用 DescribeRegions 查看最新的七牛云地域列表。  
security_group_rule_id | string | body | 是 |  安全组入网规则 ID  
ip_protocol | string | body | 是 |  传输层协议。参数值大小写敏感。取值范围：

  * icmp
  * gre
  * tcp
  * udp
  * all：支持所有协议

  
port_range | string | body | 是 |  目的端安全组开放的传输层协议相关的端口范围。取值范围：

  * TCP/UDP 协议：取值范围为 1~65535。使用斜线（/）隔开起始端口和终止端口。例如：1/200
  * ICMP 协议：-1/-1
  * GRE 协议：-1/-1
  * all：-1/-1

  
source_group_id | string | body | 否 |  需要撤销访问权限的源端安全组 ID。

  * 必须设置 SourceGroupId 或者 SourceCidrIp 参数。
  * 如果指定了 SourceGroupId 没有指定参数 SourceCidrIp，则参数 NicType 取值只能为 intranet。
  * 如果同时指定了 SourceGroupId 和 SourceCidrIp，则默认以 SourceCidrIp 为准。

  
source_group_owner_account | string | body | 否 |  跨账户删除安全组规则时，源端安全组所属的七牛云账户。

  * 如果 SourceGroupOwnerAccount 及 SourceGroupOwnerId 均未设置，则认为是撤销您其他安全组的访问权限。
  * 如果已经设置参数 SourceCidrIp，则参数 SourceGroupOwnerAccount 无效。

  
source_group_owner_id | string | body | 否 |  跨账户删除安全组规则时，源端安全组所属的七牛云账户 ID。

  * 如果 SourceGroupOwnerId 及 SourceGroupOwnerAccount 均未设置，则认为是撤销您其他安全组的访问权限。
  * 如果您已经设置参数 SourceCidrIp，则参数 SourceGroupOwnerId 无效。

  
source_port_range | string | body | 否 |  源端安全组开放的传输层协议相关的端口范围。取值范围：

  * TCP/UDP 协议：取值范围为 1~65535。使用斜线（/）隔开起始端口和终止端口。例如：1/200
  * ICMP 协议：-1/-1
  * GRE 协议：-1/-1
  * all：-1/-1

  
source_cidr_ip | string | body | 否 |  源端 IP 地址范围。支持 CIDR 格式和 IPv4 格式的 IP 地址范围。默认值：0.0.0.0/0  
dest_cidr_ip | string | body | 否 |  目的端 IP 地址范围。支持 CIDR 格式和 IPv4 格式的 IP 地址范围。默认值：0.0.0.0/0  
policy | string | body | 否 |  访问权限。取值范围：

  * accept：接受访问
  * drop：拒绝访问，不发回拒绝信息

默认值：accept  
nic_type | string | body | 否 |  经典网络类型安全组规则的网卡类型。取值范围：

  * `internet`：公网网卡
  * `intranet`：内网网卡

默认值：internet 在以下情况中，参数 NicType 取值只能为 intranet：

  * 专有网络 VPC 类型安全组规则无需设置网卡类型，默认为 intranet，只能为 intranet。
  * 设置安全组之间互相访问时，即指定了 DestGroupId 且没有指定 DestCidrIp，只能为 intranet。

  
priority | integer | body | 否 |  安全组规则优先级。取值范围：1~100 默认值：1  
ipv6_source_cidr_ip | string | body | 否 |  源端 IPv6 CIDR 地址段。支持 CIDR 格式和 IPv6 格式的 IP 地址范围。 默认值：无 说明: 仅支持 VPC 类型的 IP 地址。  
ipv6_dest_cidr_ip | string | body | 否 |  目的端 IPv6 CIDR 地址段。支持 CIDR 格式和 IPv6 格式的 IP 地址范围。 默认值：无 说明: 仅支持 VPC 类型的 IP 地址。  
  
# 返回值

名称 | 类型 | 描述  
---|---|---  
request_id | string | 请求 ID  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的云主机安全组出网规则列表

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 安全组 >安全组出网规则列表

#  安全组出网规则列表

最近更新时间: 2020-12-29 16:53:57

# 请求路径

> `GET` /v1/vm/sgr/:security_group_id/egress

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
security_group_id | string | path | 是 | 安全组 ID  
region_id | string | query | 是 | 地域 ID  
page | integer | query | 否 | 页码。默认：1  
size | integer | query | 否 | 分页大小，最大100。默认20  
  
# 返回值

名称 | 类型 | 描述  
---|---|---  
request_id | string | 请求 ID  
page | integer | 页码  
size | integer | 分页大小  
total | integer | 安全组总量  
data | []PermissionType | 安全组权限规则  
  
### PermissionType

名称 | 类型 | 描述  
---|---|---  
security_group_rule_id | string | 安全组权限规则 ID  
ip_protocol | string | IP 协议, 传输层协议。不区分大小写。取值范围：`icmp`, `gre`, `tcp`, `udp`, `all`  
port_range | string | 端口范围  
source_cidr_ip | string | 源IP地址段，用于入方向授权  
source_group_id | string | 源安全组，用于入方向授权  
source_group_name | string | 源端安全组名称  
source_group_owner_account | string | 源安全组所属账户 ID  
dest_cidr_ip | string | 目标IP地址段，用于出方向授权  
dest_group_id | string | 目标安全组，用于出方向授权  
dest_group_name | string | 目的端安全组名称  
dest_group_owner_account | string | 目标安全组所属账户ID  
policy | string | 授权策略: `accept`, `drop`  
nic_type | string | 网络类型: `internet`, `intranet`  
priority | string | 规则优先级  
direction | string | 授权方向: `ingress`, `egress`, `all`  
description | string | 安全组描述信息  
create_time | string | 创建时间  
ipv6_source_cidr_ip | string | 源 IPv6 地址段  
ipv6_dest_cidr_ip | string | 目的 IPv6 地址段  
source_port_range | string | 源端端口范围  
  
## 返回值示例

    
    
    {
      "data": [
        {
          "security_group_rule_id": "953d74c8-95ab-48e8-a550",
          "ip_protocol": "ALL",
          "port_range": "-1/-1",
          "source_cidr_ip": "",
          "source_group_id": "",
          "source_group_name": "",
          "source_group_owner_account": "",
          "dest_cidr_ip": "",
          "dest_group_id": "",
          "dest_group_name": "",
          "dest_group_owner_account": "",
          "policy": "Accept",
          "nic_type": "intranet",
          "priority": 100,
          "direction": "egress",
          "description": "",
          "create_time": "2020-12-01T07:04:54Z",
          "ipv6_source_cidr_ip": "",
          "ipv6_dest_cidr_ip": "",
          "source_port_range": ""
        }
      ],
      "page": 1,
      "size": 10,
      "total": 1,
      "request_id": "ScKvEUa8plwinlMW"
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的云主机创建安全组出网规则

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 安全组 >创建安全组出网规则

#  创建安全组出网规则

最近更新时间: 2021-05-28 16:11:47

# 请求路径

> `POST` /v1/vm/sgr/:security_group_id/egress

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
security_group_id | string | path | 是 |  安全组 ID。您可以调用 DescribeSecurityGroups 查看您可用的安全组。  
region_id | string | body | 是 |  安全组所属地域 ID。您可以调用 DescribeRegions 查看最新的七牛云地域列表。  
auth_type | string | body | 是 |  授权类型，ip_cidr: IP地址或ip段，security_group_id: 安全组id，ipv6_cidr: ipv6地址  
auth_list | []string | body | 是 |  授权列表，只能是ip地址段、ipv6地址或者安全组id。  
支持一次性授权多个相同授权类型的值。  
port_range_list | []string | body | 是 |  端口范围列表，支持一次性设置多个端口范围。 

  * TCP/UDP 协议：取值范围为 1~65535。使用斜线（/）隔开起始端口和终止端口。例如：1/200
  * ICMP 协议：-1/-1
  * GRE 协议：-1/-1
  * IpProtocol 取值为 all：-1/-1

  
ip_protocol | string | body | 是 |  传输层协议。取值大小写敏感。取值范围：

  * icmp
  * gre
  * tcp
  * udp
  * all：支持所有协议

  
policy | string | body | 否 |  设置访问权限。取值范围：

  * accept：接受访问
  * drop：拒绝访问，不返回拒绝信息

默认值：accept  
priority | integer | body | 否 |  安全组规则优先级。取值范围：1~100 默认值：1  
description | string | body | 否 |  安全组规则的描述信息。长度为 1~512 个字符。  
  
# 返回值

名称 | 类型 | 描述  
---|---|---  
request_id | string | 请求 ID  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的云主机删除专有网络

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > VPC >删除专有网络

#  删除专有网络

最近更新时间: 2020-12-29 17:18:57

# 请求路径

> `DELETE` /v1/vm/vpc/:vpc_id

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
vpc_id | string | path | 是 | 专有网络 ID  
region_id | string | query | body | 是 | 地域 ID  
  
# 返回值

名称 | 类型 | 描述  
---|---|---  
request_id | string | 请求 ID  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的云主机虚拟交换机列表

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > VSwitch >虚拟交换机列表

#  虚拟交换机列表

最近更新时间: 2020-12-29 17:21:28

# 请求路径

> `GET` /v1/vm/switch

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
region_id | string | query | 否 | 地域 ID。您可以调用 DescribeRegions 查看最新的七牛云地域列表。  
vpc_id | string | query | 否 | 专有网络 ID  
zone_id | string | query | 否 | 可用区 ID。您可以通过调用DescribeZones接口获取可用区ID  
page | integer | query | 否 | 页码。默认：1  
size | integer | query | 否 | 分页大小，最大100。默认20  
  
# 返回值

名称 | 类型 | 描述  
---|---|---  
request_id | string | 请求 ID  
page | integer | 页码  
size | integer | 分页大小  
total | integer | 虚拟交换机总量  
data | []VSwitchInfo | 虚拟交换机列表  
  
### VSwitchInfo

名称 | 类型 | 描述  
---|---|---  
v_switch_id | string | 交换机的ID  
vpc_id | string | 交换机所属VPC的ID  
status | string | 交换机的状态，取值：Pending：配置中， Available：可用  
cidr_block | string | 交换机的IPv4网段  
zone_id | string | 交换机所属的可用区 ID  
region_id | string | 交换机所属的区域 ID  
available_ip_address_count | integer | 交换机中可用的IP地址数量  
description | string | 交换机的描述信息  
v_switch_name | string | 交换机的名称  
is_default | boolean | 是否为默认交换机，只能在创建的时候插入该字段  
ipv6_cidr_block | string | 交换机的IPv6网段  
created_at | string | 创建时间  
updated_at | string | 更新时间  
  
## 返回值示例

    
    
    {
      "data": [
        {
          "v_switch_id": "a88147c2-0d91-4727-9893",
          "vpc_id": "76b39642-dbdd-4e41-8e1c",
          "status": "Available",
          "cidr_block": "192.168.61.0/24",
          "zone_id": "grand-cn-north-4a",
          "region_id": "grand-cn-north-4",
          "available_ip_address_count": 251,
          "description": "System create default vswitch",
          "v_switch_name": "vswitch-default",
          "is_default": true,
          "client_token": "",
          "ipv6_cidr_block": "",
          "updated_at": "2020-12-01T15:04:54.121+08:00",
          "created_at": "2020-12-01T15:04:54.121+08:00"
        },
        {
          "v_switch_id": "7775f73d-1104-4758-97b2",
          "vpc_id": "76b39642-dbdd-4e41-8e1c",
          "status": "Available",
          "cidr_block": "192.168.0.0/24",
          "zone_id": "grand-cn-north-4g",
          "region_id": "grand-cn-north-4",
          "available_ip_address_count": 251,
          "description": "subnet-default",
          "v_switch_name": "subnet-default",
          "is_default": false,
          "client_token": "",
          "ipv6_cidr_block": "",
          "updated_at": "2020-11-12T17:09:25.283+08:00",
          "created_at": "2020-11-12T17:09:21.478+08:00"
        }
      ],
      "page": 1,
      "size": 10,
      "total": 2,
      "request_id": "N8cGFxnzdyenqFMW"
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的云主机虚拟交换机详情

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > VSwitch >虚拟交换机详情

#  虚拟交换机详情

最近更新时间: 2020-12-29 17:30:00

# 请求路径

> `GET` /v1/vm/switch/:v_switch_id

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
v_switch_id | string | path | 是 | 交换机 ID  
region_id | string | query | 是 | 地域 ID  
  
# 返回值

名称 | 类型 | 描述  
---|---|---  
request_id | string | 请求 ID  
data | VSwitchInfo | 虚拟交换机详情  
  
### VSwitchInfo

名称 | 类型 | 描述  
---|---|---  
v_switch_id | string | 交换机的ID  
vpc_id | string | 交换机所属VPC的ID  
status | string | 交换机的状态，取值：Pending：配置中， Available：可用  
cidr_block | string | 交换机的IPv4网段  
zone_id | string | 交换机所属的可用区 ID  
region_id | string | 交换机所属的区域 ID  
available_ip_address_count | integer | 交换机中可用的IP地址数量  
description | string | 交换机的描述信息  
v_switch_name | string | 交换机的名称  
is_default | boolean | 是否为默认交换机，只能在创建的时候插入该字段  
ipv6_cidr_block | string | 交换机的IPv6网段  
created_at | string | 创建时间  
updated_at | string | 更新时间  
  
## 返回值示例

    
    
    {
      "data": {
        "v_switch_id": "7775f73d-1104-4758-97b2",
        "vpc_id": "76b39642-dbdd-4e41-8e1c",
        "status": "Available",
        "cidr_block": "192.168.0.0/24",
        "zone_id": "grand-cn-north-4g",
        "region_id": "grand-cn-north-4",
        "available_ip_address_count": 251,
        "description": "subnet-default",
        "v_switch_name": "subnet-default",
        "is_default": false,
        "client_token": "",
        "ipv6_cidr_block": "",
        "updated_at": "2020-11-12T17:09:25.283+08:00",
        "created_at": "2020-11-12T17:09:21.478+08:00"
      },
      "request_id": "N8cGFxnzdyenqFMW"
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的云主机创建虚拟交换机

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > VSwitch >创建虚拟交换机

#  创建虚拟交换机

最近更新时间: 2021-01-28 19:15:13

# 请求路径

> `POST` /v1/vm/switch

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
region_id | string | body | 是 |  要创建的交换机的地域 ID 您可以通过调用 DescribeRegions 接口获取地域 ID。  
zone_id | string | body | 是 |  要创建的交换机所属的可用区 ID 您可以通过调用 DescribeZones 接口获取可用区 ID。  
cidr_block | string | body | 是 |  交换机的网段。交换机网段要求如下：

  * 交换机的网段的掩码长度范围为 16~29 位。
  * 交换机的网段必须从属于所在 VPC 的网段。
  * 交换机的网段不能与所在 VPC 中路由条目的目标网段相同，但可以是目标网段的子集。

  
vpc_id | string | body | 是 |  要创建的交换机所属的 VPC ID。  
v_switch_name | string | body | 否 |  交换机的名称 名称长度为 2~128 个字符，必须以字母或中文开头，但不能以 `http://` 或 `https://` 开头。  
description | string | body | 否 |  交换机的描述信息 描述长度为 2~256 个字符，必须以字母或中文开头，但不能以 `http://` 或 `https://` 开头。  
ipv6_cidr_block_number | integer | body | 否 |  交换机 IPv6 网段的最后 8 比特位 取值：0~255。 重设 json 的 key，避免和 model 内的 ipv6_cidr_block 类型不同 convert 失败  
client_token | string | body | 否 |  保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。  
  
# 返回值

名称 | 类型 | 描述  
---|---|---  
request_id | string | 请求 ID  
data | VSwitch | 交换机信息  
data.v_switch_id | string | 交换机 ID  
data.vpc_id | string | 专有网络 ID  
data.status | string | 状态  
data.cidr_block | string | CIDR  
data.region_id | string | 地域  
data.zone_id | string | 可用区  
data.v_switch_name | string | 交换机名  
data.available_ip_address_count | int | 可用 IP 数量  
data.updated_at | string | 最近更新时间  
data.created_at | string | 创建时间  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的云主机删除虚拟交换机

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > VSwitch >删除虚拟交换机

#  删除虚拟交换机

最近更新时间: 2020-12-29 17:32:17

# 请求路径

> `DELETE` /v1/vm/switch/:v_switch_id

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
v_switch_id | string | path | 是 | 交换机 ID  
region_id | string | query | body | 是 | 地域 ID  
  
# 返回值

名称 | 类型 | 描述  
---|---|---  
request_id | string | 请求 ID  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的云主机创建弹性公网 IP

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > EIP >创建弹性公网 IP

#  创建弹性公网 IP

最近更新时间: 2021-05-26 14:44:54

# 请求路径

> `POST` /v1/vm/eip

# 请求参数 ([查看付费参数 __](https://developer.qiniu.com/qvm/8006/common-params))

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
region_id | string | body | 是 |  地域 ID。您可以调用 DescribeRegions 查看最新的七牛云地域列表  
allocation_name | string | body | 是 |  分配名称  
bandwidth | string | body | 是 |  EIP 的带宽峰值，取值范围：1~200，单位为 Mbps。 默认值为 5。  
isp | string | body | 否 |  线路类型  
目前支持BGP线路和BGP精品线路，默认为BGP线路，在选择精品线路的时候该参数必填。

  * `BGP_PRO`: BGP（多线）精品线路
  * `BGP`: BGP（多线）线路
  * `5_telcom`: 电信
  * `5_union`: 联通
  * `5_bgp`: 全动态 BGP
  * `5_sbgp`: 静态 BGP

  
client_token | string | body | 是 |  保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。  
enable_auto_renew | boolean | body | 否 |  是否打开自动续费  
customized_release_time | string | body | 否 |  后付费定时删除的时间  
cost_charge_type | string | body | 是 | 付费方式  
cost_charge_mode | string | body | 是 | 计费方式  
cost_period_unit | string | body | 是 | 计费单位  
cost_period | integer | body | 是 | 计费周期  
  
# 返回值

名称 | 类型 | 描述  
---|---|---  
request_id | string | 请求 ID  
data | object{} | 创建 EIP 返回信息  
data.allocation_id | string | 按量创建返回 ID  
data.order | string | 预付费创建返回订单号  
  
## 返回值示例

    
    
    {
      "data": {
        "order": "edc5413cc610305704a8aaddca"
      },
      "request_id": "N8cGF-xihhWd5VMW"
    }
    
    
    
    {
      "data": {
        "allocation_id": "eip-6wexqbul13ouh13"
      },
      "request_id": "ScKvERYKCVyN4lMW"
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的云主机续费弹性公网 IP

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > EIP >续费弹性公网 IP

#  续费弹性公网 IP

最近更新时间: 2020-12-29 17:40:53

# 请求路径

> `POST` /v1/vm/eip/:allocation_id/renew

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
allocation_id | string | path | 是 | 弹性公网 IP 的 ID  
region_id | string | body | 是 | 地域 ID  
client_token | string | body | 否 | 保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。  
cost_charge_type | string | body | 是 | 付费方式  
cost_charge_mode | string | body | 是 | 计费方式  
cost_period_unit | string | body | 是 | 计费单位  
cost_period | integer | body | 是 | 计费周期  
  
# 返回值

名称 | 类型 | 描述  
---|---|---  
request_id | string | 请求 ID  
data | object{} | 续费 EIP 返回信息  
data.order | string | 订单号  
data.c_fee | float | 支付金额  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的云主机删除弹性公网 IP

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > EIP >删除弹性公网 IP

#  删除弹性公网 IP

最近更新时间: 2020-12-29 17:43:09

# 请求路径

> `DELETE` /v1/vm/eip/:allocation_id

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
allocation_id | string | path | 是 | 弹性公网 IP 的 ID  
region_id | string | query | body | 是 | 地域 ID  
  
# 返回值

名称 | 类型 | 描述  
---|---|---  
request_id | string | 请求 ID  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的云主机绑定弹性公网 IP

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > EIP >绑定弹性公网 IP

#  绑定弹性公网 IP

最近更新时间: 2020-12-29 17:44:52

# 请求路径

> `POST` /v1/vm/eip/:allocation_id/associate

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
allocation_id | string | path | 是 |  绑定云产品实例的 EIP 的 ID。  
region_id | string | body | 是 |  要绑定云产品实例的 EIP 所属的地域 ID。  
instance_type | string | body | 是 |  要绑定 EIP 的实例的类型，取值：

  * `Nat`：NAT 网关。
  * `SlbInstance`：负载均衡 SLB。
  * `EcsInstance`：云服务器 ECS。
  * `NetworkInterface`：辅助弹性网卡。
  * `HaVip`：高可用虚拟 IP。

  
instance_id | string | body | 是 |  要绑定 EIP 的实例 ID。 支持输入 NAT 网关实例 ID、负载均衡 SLB 实例 ID、云服务器 ECS 实例 ID、辅助弹性网卡实例 ID、高可用虚拟 IP 实例 ID。  
  
# 返回值

名称 | 类型 | 描述  
---|---|---  
request_id | string | 请求 ID  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的云主机解绑弹性公网 IP

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > EIP >解绑弹性公网 IP

#  解绑弹性公网 IP

最近更新时间: 2020-12-29 17:46:28

# 请求路径

> `DELETE` /v1/vm/eip/:allocation_id/associate

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
allocation_id | string | path | 是 |  绑定云产品实例的 EIP 的 ID。  
region_id | string | body | 是 |  要绑定云产品实例的 EIP 所属的地域 ID。  
instance_type | string | body | 是 |  要绑定 EIP 的实例的类型 取值： 

  * `Nat`：NAT 网关。
  * `SlbInstance`：负载均衡 SLB。
  * `EcsInstance`：云服务器 ECS（（默认值））。
  * `NetworkInterface`：辅助弹性网卡。
  * `HaVip`：高可用虚拟 IP。

  
instance_id | string | body | 是 |  要解绑 EIP 的云产品实例的 ID  
force | boolean | body | 否 |  当EIP绑定了NAT网关，且NAT网关添加了DNAT或SNAT条目时，是否强制解绑EIP

  * `false`：不强制解绑 EIP（默认值）。
  * `true`：强制解绑 EIP。

  
  
# 返回值

名称 | 类型 | 描述  
---|---|---  
request_id | string | 请求 ID  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的云主机弹性公网 IP 变配

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > EIP >弹性公网 IP 变配

#  弹性公网 IP 变配

最近更新时间: 2020-12-29 17:47:55

# 请求路径

> `PUT` /v1/vm/eip/:allocation_id/spec

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
allocation_id | string | path | 是 | 弹性公网 IP 的 ID  
region_id | string | body | 是 | 地域 ID  
bandwidth | string | body | 是 | EIP 的带宽峰值，取值：1~500，单位为 Mbps  
  
# 返回值

名称 | 类型 | 描述  
---|---|---  
request_id | string | 请求 ID  
  
注： 预付费 EIP 调用该接口会生成订单，需要支付后才能变配生效

以上内容是否对您有帮助？
human: 如何处理七牛云的云主机查询共享带宽列表

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 共享带宽 >查询共享带宽列表

#  查询共享带宽列表

最近更新时间: 2021-04-22 15:20:03

# 请求路径

> `GET` /v1/vpc/common_bandwidth

# 请求参数

名称 | 类型 | 位置 | 是否必须 | 描述  
---|---|---|---|---  
region_id | string | query | 否 | 支持多个地域 ID, 按逗号分隔  
cb_id | string | query | 否 | 共享带宽包 ID  
name | string | query | 否 | 名称模糊搜索  
page | int | query | 否 | 页码  
size | int | query | 否 | 分页大小  
  
# 返回值

名称 | 类型 | 是否必须 | 描述  
---|---|---|---  
data | []CommonBandwidth | 是 | 共享带宽列表  
request_id | string | 是 | 请求记录 ID  
page | int | 是 | 页码  
size | int | 是 | 分页大小  
total | int | 是 | 查询到的总数  
  
### CommonBandwidth 共享带宽详情

名称 | 类型 | 是否必须 | 描述  
---|---|---|---  
region_id | string | 是 | 地域 ID  
cb_id | string | 是 | 带宽包 ID  
name | string | 是 | 带宽包名称  
description | string | 是 | 带宽包描述  
bandwidth | int | 是 | 带宽大小, 单位 Mbps  
status | string | 是 | 共享带宽状态, 默认 Available  
public_address | []AddressInfo | 是 | 加入带宽包的弹性 IP 列表  
create_time | string | 是 | 创建时间  
expire_time | string | 是 | 过期时间  
ratio | int | 是 | 保底百分比  
cost_charge_type | string | 是 | 付费类型  
cost_charge_mode | string | 是 | 计费方式  
  
### AddressInfo 弹性 IP 信息

名称 | 类型 | 是否必须 | 描述  
---|---|---|---  
ip_address | string | 是 | IP 地址  
eip_id | string | 是 | IP 实例 ID  
  
# 示例

### 正常返回示例

    
    
    {
        "data": [
            {
                "_id": "60800ad3ca2a31b4d27286a2",
                "uid": 1381403989,
                "region_id": "cn-zhangjiakou",
                "cb_id": "cbwp-8vb7ta6zzkl83pq6bzv4i",
                "name": "test_qxy",
                "description": "null",
                "bandwidth": 2,
                "internet_charge_type": "PayByBandwidth",
                "ratio": 100,
                "instance_charge_type": "PostPaid",
                "status": "Available",
                "business_status": "Normal",
                "public_address": [{
                     "ip_address": "1.2.3.4",
                     "eip_id": "eip-xxx"
                }],
                "has_reservation_data": false,
                "isp": "BGP",
                "deletion_protection": false,
                "resource_group_id": "rg-acfm2aglnh2ecpa",
                "human_spec": "2Mbps",
                "create_time": "2021-04-21T19:21:55+08:00",
                "expire_time": "2121-04-22T03:26:56+08:00",
                "update_time": "2021-04-21T19:26:56.458+08:00",
                "customized_expire_time": null,
                "cost_charge_type": "PostPaid",
                "cost_charge_mode": "PayByBandwidth",
            }
        ],
        "page": 1,
        "size": 10,
        "total": 1,
        "request_id": "3xV5Lp2NuUUM3XcW"
    }
    

以上内容是否对您有帮助？