jancd/qiniu-developer_ShareGPT huggingface dataset:
human: 如何处理七牛云的云主机创建共享带宽

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

#  创建共享带宽

最近更新时间: 2021-04-22 14:52:05

# 请求路径

> `POST` /v1/vpc/common_bandwidth

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

名称 | 类型 | 位置 | 是否必须 | 描述  
---|---|---|---|---  
region_id | string | body | 是 | 地域 ID  
name | string | body | 是 | 共享带宽名称  
bandwidth | int | body | 是 | 带宽大小, 单位Mbps, 按带宽计费最小为2, 按增强型计费最小为200  
ratio | int | query | 否 | 保底百分比，按增强型计费只能为20, 按带宽计费时只能为100  
cost_charge_type | string | body | 是 | 付费类型  
cost_charge_mode | string | body | 是 | 计费方式, 取值: PayByBandwidth, PayBy95; 当 cost_charge_type = PrePaid 时，只能选 PayByBandwidth  
cost_period_unit | string | body | 是 | 付费周期  
cost_period | int | body | 否 | 付费周期长度, 当 cost_charge_type = PrePaid 时 必填  
client_token | string | body | 是 | 保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。  
enable_auto_renew | bool | body | 否 | 是否打开自动续费, true表示打开, 默认不打开  
  
# 返回值

名称 | 类型 | 是否必须 | 描述  
---|---|---|---  
data | CreateResponse | 是 | 创建返回结果  
request_id | string | 是 | 请求记录 ID  
  
### CreateResponse 创建返回结果

名称 | 类型 | 是否必须 | 描述  
---|---|---|---  
order | string | 否 | 订单号，选择预付费返回该参数  
bandwidth_package_id | string | 否 | 带宽包 ID, 选择后付费返回该参数  
  
# 示例

### 正常返回示例

    
    
    预付费:
    {
        "data": {
            "order": "1QW2F998-8642-2346-I2K3-0OKMNHY65TG4"
        },
        "request_id": "04F0F334-AC1"
    }
    后付费:
    {
        "data": {
            "bandwidth_package_id": "cbwp-xxx"
        },
        "request_id": "04F0F334-AC1"
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的云主机修改共享带宽规格

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 共享带宽 >修改共享带宽规格

#  修改共享带宽规格

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

# 请求路径

> `PUT` /v1/vpc/common_bandwidth/:cb_id/modify

# 请求参数

名称 | 类型 | 位置 | 是否必须 | 描述  
---|---|---|---|---  
region_id | string | body | 是 | 地域 ID  
cb_id | string | path | 是 | 共享带宽包 ID  
bandwidth | int | body | 是 | 新的带宽大小  
cost_charge_mode | string | body | 是 | 计费方式, PayByBandwidth 或 PayBy95  
  
# 返回值

名称 | 类型 | 是否必须 | 描述  
---|---|---|---  
data | OrderInfo | 否 | 订单详情  
request_id | string | 是 | 请求记录 ID  
  
### OrderInfo 订单详情

名称 | 类型 | 是否必须 | 描述  
---|---|---|---  
order | string | 否 | 订单号, 选择预付费返回该参数  
  
# 示例

### 正常返回示例

    
    
    预付费:
    {
        "data": {
            "order": "1QW2F998-8642-2346-I2K3-0OKMNHY65TG4"
        },
        "request_id": "04F0F334-AC1"
    }
    后付费:
    {
        "request_id": "04F0F334-AC1"
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的云主机修改共享带宽属性

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 共享带宽 >修改共享带宽属性

#  修改共享带宽属性

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

# 请求路径

> `PUT` /v1/vpc/common_bandwidth/:cb_id/config

# 请求参数

名称 | 类型 | 位置 | 是否必须 | 描述  
---|---|---|---|---  
region_id | string | body | 是 | 地域 ID  
cb_id | string | path | 是 | 共享带宽包 ID  
name | string | body | 是 | 名称  
description | string | body | 否 | 描述  
  
# 返回值

名称 | 类型 | 是否必须 | 描述  
---|---|---|---  
request_id | string | 是 | 请求记录 ID  
  
# 示例

### 正常返回示例

    
    
    {
        "request_id": "04F0F334-AC1"
    }
    

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

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

#  续费共享带宽

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

# 请求路径

> `POST` /v1/vpc/common_bandwidth/:cb_id/renew

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

名称 | 类型 | 位置 | 是否必须 | 描述  
---|---|---|---|---  
region_id | string | body | 是 | 地域 ID  
cb_id | string | path | 是 | 共享带宽 ID  
cost_charge_type | string | body | 是 | 付费类型  
cost_charge_mode | string | body | 是 | 计费方式, 取值: PayByBandwidth  
cost_period_unit | string | body | 是 | 付费周期  
cost_period | int | body | 是 | 付费周期长度  
  
# 返回值

名称 | 类型 | 是否必须 | 描述  
---|---|---|---  
data | Response | 是 | 订单详情  
request_id | string | 是 | 请求记录 ID  
  
### Response 返回结果

名称 | 类型 | 是否必须 | 描述  
---|---|---|---  
order | string | 否 | 订单号  
  
# 示例

### 正常返回示例

    
    
    {
        "data": {
            "order": "1QW2F998-8642-2346-I2K3-0OKMNHY65TG4"
        },
        "request_id": "04F0F334-AC1"
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的云主机手动添加主机到伸缩组

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 弹性伸缩 >手动添加主机到伸缩组

#  手动添加主机到伸缩组

最近更新时间: 2021-12-22 11:42:39

# 请求路径

> `POST` /v1/ess/group/:id/instance

# 请求参数

名称 | 类型 | 位置 | 是否必须 | 描述  
---|---|---|---|---  
region_id | string | body | 是 | 地域 ID  
id | string | path | 是 | 伸缩组 ID  
instance_id | []string | body | 是 | 要添加到伸缩组的 ID 列表  
  
# 返回值

名称 | 类型 | 是否必须 | 描述  
---|---|---|---  
request_id | string | 是 | 请求记录 ID  
  
# 示例

### 正常返回示例

    
    
    {
        "request_id": "504ce405-58d1-40b1-9674-40d7d3875d65"
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的云主机移出伸缩组内的主机

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 弹性伸缩 >移出伸缩组内的主机

#  移出伸缩组内的主机

最近更新时间: 2021-12-22 11:46:05

# 请求路径

> `DELETE` /v1/ess/group/:id/instance

# 请求参数

名称 | 类型 | 位置 | 是否必须 | 描述  
---|---|---|---|---  
region_id | string | body | 是 | 地域 ID  
id | string | path | 是 | 伸缩组 ID  
instance_id | []string | body | 是 | 要添加到伸缩组的 ID 列表  
  
# 返回值

名称 | 类型 | 是否必须 | 描述  
---|---|---|---  
request_id | string | 是 | 请求记录 ID  
  
# 示例

### 正常返回示例

    
    
    {
        "request_id": "504ce405-58d1-40b1-9674-40d7d3875d65"
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的云主机查询伸缩组规则列表

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 弹性伸缩 >查询伸缩组规则列表

#  查询伸缩组规则列表

最近更新时间: 2021-12-23 11:25:35

# 请求路径

> `GET` /v1/ess/group/:id/rule

# 请求参数

名称 | 类型 | 位置 | 是否必须 | 描述  
---|---|---|---|---  
region_id | string | query | 是 | 地域 ID  
id | string | path | 是 | 伸缩组 ID  
scaling_rule_id | string | query | 否 | 待查询伸缩规则的ID，最多可以输入10个，用逗号’,'分隔。  
scaling_rule_name | string | query | 否 | 待查询伸缩规则的名称，最多可以输入10个，用逗号’,'分隔。  
scaling_rule_ari | string | query | 否 | 待查询伸缩规则的唯一标识符，最多可以输入10个，用逗号’,'分隔。  
scaling_rule_type | string | query | 否 | 伸缩规则的类型。取值范围：SimpleScalingRule：简单规则; TargetTrackingScalingRule：目标追踪规则; StepScalingRule：步进规则; PredictiveScalingRule：预测规则。  
page | int | query | 否 | 页码  
size | int | query | 否 | 分页大小  
  
# 返回值

名称 | 类型 | 是否必须 | 描述  
---|---|---|---  
data | []ScalingRule | 是 | 伸缩组规则  
request_id | string | 是 | 请求记录 ID  
page | int | 是 | 页码  
size | int | 是 | 分页大小  
total | int | 是 | 查询到的总数  
  
### ScalingRule 伸缩组规则详情

名称 | 类型 | 是否必须 | 描述  
---|---|---|---  
scaling_rule_id | string | 是 | 伸缩组规则 ID  
scaling_group_id | string | 是 | 伸缩组 ID  
scaling_rule_name | string | 是 | 缩规则的名称  
scaling_rule_ari | string | 是 | 伸缩规则的唯一标识符  
scaling_rule_type | string | 是 | 伸缩规则的类型。  
adjustment_type | string | 是 | 伸缩规则的调整方式。可选值： QuantityChangeInCapacity：增加或减少指定数量的 ECS 实例; PercentChangeInCapacity：增加或减少指定比例的 ECS 实例; TotalCapacity： 将当前伸缩组的 ECS 实例数量调整到指定数量。  
adjustment_value | int | 是 | 伸缩规则的调整值。任何情况下，单次调整的 ECS 实例台数都不能超过 1000。不同调整方式对应的取值范围： QuantityChangeInCapacity：-500~500 PercentChangeInCapacity：-100~10000 TotalCapacity：0~1000  
cooldown | int | 是 | 伸缩规则的冷却时间。 取值范围：0~86400，单位：秒。  
  
# 示例

### 正常返回示例

    
    
    {
        "total_count": 1,
        "page_number": 1,
        "page_size": 10,
        "data": [
            {
                "scaling_rule_id": "asr-uf6fwqeyx00da6kpmckj",
                "scaling_group_id": "asg-uf61cm05cpiu8v7e2zuf",
                "scaling_rule_name": "esr-JaO9q",
                "scaling_rule_ari": "ari:acs:ess:cn-shanghai:1651221115715900:scalingrule/asr-uf6fwqeyx00da6kpmckj",
                "scaling_rule_type": "SimpleScalingRule",
                "adjustment_type": "QuantityChangeInCapacity",
                "adjustment_value": 1,
                "cooldown": 200,
                "alarm": null
            }
        ],
        "request_id": "ioRxAug1PmxrvMIW"
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的云主机执行伸缩组规则

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 弹性伸缩 >执行伸缩组规则

#  执行伸缩组规则

最近更新时间: 2021-12-23 14:40:32

# 请求路径

> `POST` /v1/ess/rule/execute

# 请求参数

名称 | 类型 | 位置 | 是否必须 | 描述  
---|---|---|---|---  
region_id | string | body | 是 | 地域 ID  
scaling_rule_ari | string | body | 是 | 伸缩规则唯一标识符。  
breach_threshold | string | body | 否 | 执行步进伸缩规则时指定的当前阈值，取值范围-9.999999E18~9.999999E18。参考值: 1。  
client_token | string | body | 否 | 用于保证请求的幂等性, 要保证在不同请求间唯一  
metric_value | double | body | 否 | 执行步进伸缩规则时指定的当前指标值，取值范围-9.999999E18~9.999999E18。参考值: 1。  
  
# 返回值

名称 | 类型 | 是否必须 | 描述  
---|---|---|---  
request_id | string | 是 | 请求记录 ID  
scaling_activity_id | string | 是 | 伸缩活动的ID。  
  
# 示例

### 正常返回示例

    
    
    {
        "request_id": "504ce405-58d1-40b1-9674-40d7d3875d65",
        "scaling_activity_id": "assaf"
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的云主机删除伸缩组规则

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 弹性伸缩 >删除伸缩组规则

#  删除伸缩组规则

最近更新时间: 2021-12-21 19:30:42

# 请求路径

> `DELETE` /v1/ess/group/:id/rule/:rule_id

# 请求参数

名称 | 类型 | 位置 | 是否必须 | 描述  
---|---|---|---|---  
region_id | string | body | 是 | 地域 ID  
id | string | path | 是 | 伸缩组 ID  
rule_id | bool | path | 是 | 伸缩组规则 ID  
  
# 返回值

名称 | 类型 | 是否必须 | 描述  
---|---|---|---  
request_id | string | 是 | 请求记录 ID  
  
# 示例

### 正常返回示例

    
    
    {
        "request_id": "504ce405-58d1-40b1-9674-40d7d3875d65"
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的云主机查询伸缩组的所有配置

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 弹性伸缩 >查询伸缩组的所有配置

#  查询伸缩组的所有配置

最近更新时间: 2021-12-23 10:34:08

# 请求路径

> `GET` /v1/ess/group/:id/configuration

# 请求参数

名称 | 类型 | 位置 | 是否必须 | 描述  
---|---|---|---|---  
region_id | string | query | 是 | 地域 ID  
id | string | path | 是 | 伸缩组 ID  
scaling_configuration_id | string | query | 否 | 伸缩配置的ID，如果有多个用逗号’,'分隔  
scaling_configuration_name | string | query | 否 | 伸缩配置的名称，如果有多个用逗号’,'分隔  
page | int | query | 否 | 页码  
size | int | query | 否 | 分页大小  
  
# 返回值

名称 | 类型 | 是否必须 | 描述  
---|---|---|---  
data | []ScalingConfiguration | 是 | 伸缩组配置  
request_id | string | 是 | 请求记录 ID  
page | int | 是 | 页码  
size | int | 是 | 分页大小  
total | int | 是 | 查询到的总数  
  
### ScalingConfiguration 伸缩组配置详情

名称 | 类型 | 是否必须 | 描述  
---|---|---|---  
scaling_configuration_id | string | 是 | 伸缩配置 ID  
scaling_group_id | string | 是 | 伸缩配置所属的伸缩组 ID  
scaling_configuration_name | string | 是 | 伸缩配置的显示名称  
image_id | string | 是 | 镜像ID  
instance_type | int | 是 | 实例规格  
security_group_id | int | 是 | 安全组 ID  
internet_charge_type | int | 是 | 网络计费类型  
internet_max_bandwidth_in | string | 是 | 公网入带宽最大值，单位为Mbps  
internet_max_bandwidth_out | string | 是 | 公网出带宽最大值，单位为Mbps  
system_disk_category | []string | 是 | 系统盘的磁盘种类。cloud_efficiency：高效云盘, cloud_ssd：SSD云盘, cloud_essd：ESSD云盘  
system_disk_size | int | 是 | 系统盘大小  
instance_name | int | 是 | 实例名称  
key_pair_name | int | 是 | 登录ECS实例时使用的密钥对的名称  
load_balancer_weight | int | 是 | ECS实例作为后端服务器时的权重，取值范围：1~100。  
lifecycle_state | int | 是 | 伸缩配置在伸缩组中生效状态  
creation_time | []string | 是 | 伸缩配置的创建时间  
data_disks | DataDisks | 否 | 数据盘信息的集合  
  
### DataDisks 数据盘集合

名称 | 类型 | 是否必须 | 描述  
---|---|---|---  
data_disk | []DataDiskInfo | 是 | 数据盘信息列表  
  
### DataDiskInfo 数据盘信息

名称 | 类型 | 是否必须 | 描述  
---|---|---|---  
size | int | 否 | 数据盘大小, 单位 GB  
category | string | 否 | 数据盘种类  
snapshot_id | string | 否 | 创建数据盘使用的快照 ID  
device | string | 否 | 数据盘挂载点  
  
# 示例

### 正常返回示例

    
    
    {
        "data": [
            {
                "scaling_configuration_id": "asc-uf6889r7umrb3vpzaa53",
                "scaling_configuration_name": "esc-LRGYF",
                "scaling_group_id": "asg-uf61cm05cpiu8v7e2zuf",
                "image_id": "m-uf6fkb6pplh9yo2df5dx",
                "instance_type": "ecs.xn4.small",
                "security_group_id": "sg-uf6j6oimxd1gl41ofehz",
                "internet_charge_type": "PayByTraffic",
                "internet_max_bandwidth_in": 1,
                "internet_max_bandwidth_out": 0,
                "system_disk_category": "cloud_efficiency",
                "system_disk_size": 40,
                "instance_name": "esci-FpKHn",
                "key_pair_name": "alex-mac",
                "load_balancer_weight": 50,
                "data_disks": {
                    "data_disk": []
                },
                "lifecycle_state": "Active",
                "creation_time": "2020-03-16T11:43Z"
            }
        ],
        "total_count": 1,
        "page_number": 1,
        "page_size": 10,
        "request_id": "ioRxAspgRVA-ucIW"
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的云主机创建弹性伸缩配置

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 弹性伸缩 >创建弹性伸缩配置

#  创建弹性伸缩配置

最近更新时间: 2021-12-21 17:34:02

# 请求路径

> `POST` /v1/ess/group/:id/configuration

# 请求参数

名称 | 类型 | 位置 | 是否必须 | 描述  
---|---|---|---|---  
region_id | string | body | 是 | 地域 ID  
id | string | path | 是 | 伸缩配置所属的伸缩组 ID  
scaling_configuration_name | string | body | 是 | 伸缩配置的显示名称  
image_id | string | body | 是 | 镜像ID  
instance_type | int | body | 是 | 实例规格  
security_group_id | int | body | 是 | 安全组 ID  
system_disk_category | []string | body | 是 | 系统盘的磁盘种类。cloud_efficiency：高效云盘, cloud_ssd：SSD云盘, cloud_essd：ESSD云盘  
system_disk_size | int | body | 是 | 系统盘大小  
system_disk_name | string | body | 是 | 系统盘名称  
instance_name | string | body | 是 | 实例名称  
key_pair_name | int | body | 否 | 登录ECS实例时使用的密钥对的名称  
load_balancer_weight | int | body | 是 | ECS实例作为后端服务器时的权重，取值范围：1~100。  
data_disks | DataDisks | body | 否 | 数据盘信息的集合  
password_inherit | bool | body | 否 | 是否使用镜像预设的密码。使用该参数时，您需要所用镜像已经预设了密码。  
  
# 示例

### 正常返回示例

    
    
    {
        "request_id": "ioRxAspgRVA-ucIW"
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的云主机删除弹性伸缩配置

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 弹性伸缩 >删除弹性伸缩配置

#  删除弹性伸缩配置

最近更新时间: 2021-12-21 17:36:24

# 请求路径

> `DELETE` /v1/ess/group/:id/configuration/:configuration_id

# 请求参数

名称 | 类型 | 位置 | 是否必须 | 描述  
---|---|---|---|---  
region_id | string | body | 是 | 地域 ID  
id | string | path | 是 | 伸缩组 ID  
configuration_id | string | path | 是 | 弹性伸缩配置 ID  
  
# 返回值

名称 | 类型 | 是否必须 | 描述  
---|---|---|---  
request_id | string | 是 | 请求记录 ID  
  
# 示例

### 正常返回示例

    
    
    {
        "request_id": "504ce405-58d1-40b1-9674-40d7d3875d65"
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的云主机查询伸缩活动

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 弹性伸缩 >查询伸缩活动

#  查询伸缩活动

最近更新时间: 2021-12-23 12:02:40

# 请求路径

> `GET` /v1/ess/group/:id/activity

# 请求参数

名称 | 类型 | 位置 | 是否必须 | 描述  
---|---|---|---|---  
region_id | string | query | 是 | 地域 ID  
id | string | path | 是 | 伸缩组 ID  
scaling_activity_id | string | query | 否 | 待查询伸缩活动的ID，最多可以输入10个，用逗号’,'分隔。  
status_code | string | query | 否 | 伸缩活动的状态。取值范围：Successful：执行成功的伸缩活动; Warning：部分执行成功的伸缩活动; Failed：执行失败的伸缩活动; InProgress：正在执行的伸缩活动; Rejected：执行伸缩活动请求被拒绝。  
page | int | query | 否 | 页码  
size | int | query | 否 | 分页大小  
  
# 返回值

名称 | 类型 | 是否必须 | 描述  
---|---|---|---  
data | []ScalingActivity | 是 | 伸缩组规则  
request_id | string | 是 | 请求记录 ID  
page | int | 是 | 页码  
size | int | 是 | 分页大小  
total | int | 是 | 查询到的总数  
  
### ScalingActivity 伸缩组规则详情

名称 | 类型 | 是否必须 | 描述  
---|---|---|---  
scaling_activity_id | string | 是 | 伸缩活动 ID  
scaling_group_id | string | 是 | 伸缩组 ID  
description | string | 是 | 伸缩活动的描述信息。  
cause | string | 是 | 触发伸缩活动的原因  
start_time | string | 是 | 伸缩活动的开始时间  
end_time | string | 是 | 伸缩活动的结束时间  
progress | int | 是 | 伸缩活动的运行进度  
status_code | string | 是 | 伸缩活动的当前状态  
status_message | string | 是 | 伸缩活动的状态信息  
  
# 示例

### 正常返回示例

    
    
    {
        "total_count": 1,
        "page_number": 1,
        "page_size": 10,
        "data": [
            {
                "scaling_activity_id": "asa-uf6b4cly11t2hcs9xehh",
                "scaling_group_id": "asg-uf61cm05cpiu8v7e2zuf",
                "description": "Add \"1\" ECS instance",
                "cause": "A user requests to execute scaling rule \"asr-uf6fwqeyx00da6kpmckj\", changing the Total Capacity from \"0\" to \"1\".",
                "start_time": "2021-12-21T11:31Z",
                "end_time": "2021-12-21T11:31Z",
                "progress": 100,
                "status_code": "Rejected",
                "status_message": "The current status of the specified scaling group does not support this action."
            }
        ],
        "request_id": "ioRxAh6mHLxGwsIW"
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的云主机创建高防实例

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 经典版 DDoS 高防 IP >资源管理 >创建高防实例

#  创建高防实例

最近更新时间: 2022-02-18 14:44:05

# 请求路径

> `POST` /v1/security/bgpip/create

# 请求参数

名称 | 类型 | 位置 | 是否必须 | 描述  
---|---|---|---|---  
X-Qiniu-Regionid | string | header | 是 | 地域 ID, 只能填shanghai，大陆通用地域  
time_span | int | body | 是 | 周期长度  
time_unit | int | body | 是 | 购买周期, 取值: 0表示按月，1表示按年  
bandwidth | int | body | 是 | 保底带宽大小，单位：Mbps  
service_bandwidth | int | body | 是 | 业务带宽大小，单位：Mbps  
elastic_limit | int | body | 是 | 弹性防护带宽大小，单位：Mbps  
domain_count | int | body | 是 | 转发规则数量  
enable_auto_renew | bool | body | 否 | 是否开启自动续费  
  
# 返回值

名称 | 类型 | 是否必须 | 描述  
---|---|---|---  
data | OrderInfo | 是 | 订单详情  
  
### OrderInfo 订单信息

名称 | 类型 | 是否必须 | 描述  
---|---|---|---  
order | string | 是 | 订单号  
  
# 示例

### 请求body示例

    
    
    {
        "bandwidth": 20000,
        "service_bandwidth": 100,
        "domain_count": 60,
        "elastic_limit": 0,
        "time_span": 1,
        "time_unit": 0,
        "enable_auto_renew": true
    }
    

### 正常返回示例

    
    
    {
        "data": {
            "order": "1QW2F998-8642-2346-I2K3-0OKMNHY65TG4"
        }
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的云主机升级高防实例

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 经典版 DDoS 高防 IP >资源管理 >升级高防实例

#  升级高防实例

最近更新时间: 2022-02-18 14:43:30

# 请求路径

> `PUT` /v1/security/bgpip/modify/:resource_id/bandwidth

# 请求参数

名称 | 类型 | 位置 | 是否必须 | 描述  
---|---|---|---|---  
resource_id | string | path | 是 | 高防实例ID  
X-Qiniu-Regionid | string | header | 是 | 地域 ID, 只能填shanghai, 大陆通用地域  
bandwidth | int | body | 是 | 保底带宽大小，单位：Mbps  
service_bandwidth | int | body | 是 | 业务带宽大小，单位：Mbps  
domain_count | int | body | 是 | 转发规则数量  
  
# 返回值

名称 | 类型 | 是否必须 | 描述  
---|---|---|---  
data | OrderInfo | 是 | 订单详情  
  
### OrderInfo 订单信息

名称 | 类型 | 是否必须 | 描述  
---|---|---|---  
order | string | 是 | 订单号  
  
# 示例

### 请求body示例

    
    
    {
        "bandwidth": 50000,
        "service_bandwidth": 100,
        "domain_count": 60
    }
    

### 正常返回示例

    
    
    {
        "data": {
            "order": "1QW2F998-8642-2346-I2K3-0OKMNHY65TG4"
        }
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的云主机续费高防实例

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 经典版 DDoS 高防 IP >资源管理 >续费高防实例

#  续费高防实例

最近更新时间: 2022-02-18 14:44:57

# 请求路径

> `POST` /v1/security/bgpip//resource/:resource_id/renew

# 请求参数

名称 | 类型 | 位置 | 是否必须 | 描述  
---|---|---|---|---  
resource_id | string | path | 是 | 高防实例ID  
X-Qiniu-Regionid | string | header | 是 | 地域 ID, 只能填shanghai, 大陆通用地域  
time_span | int | body | 是 | 周期长度  
time_unit | int | body | 是 | 续费周期, 取值: 0表示按月，1表示按年  
  
# 返回值

名称 | 类型 | 是否必须 | 描述  
---|---|---|---  
data | OrderInfo | 是 | 订单详情  
  
### OrderInfo 订单信息

名称 | 类型 | 是否必须 | 描述  
---|---|---|---  
order | string | 是 | 订单号  
  
# 示例

### 请求body示例

    
    
    {
        "time_span": 1,
        "time_uint": 0
    }
    

### 正常返回示例

    
    
    {
        "data": {
            "order": "1QW2F998-8642-2346-I2K3-0OKMNHY65TG4"
        }
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的云主机获取资源列表

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 经典版 DDoS 高防 IP >资源管理 >获取资源列表

#  获取资源列表

最近更新时间: 2022-02-18 12:09:42

# 请求路径

> `GET` /v1/security/bgpip/resources

# 请求参数

名称 | 类型 | 位置 | 是否必须 | 描述  
---|---|---|---|---  
X-Qiniu-Regionid | string | header | 是 | 地域 id, 取值：shanghai (上海或大陆通用地域)  
resource_id | string | path | 是 | 高防实例 id  
page | int | query | 否 | 查询页码, 默认为1  
size | int | query | 否 | 分页大小，默认为20  
filtering_name | string | query | 否 | 资源名称，支持模糊查询  
filtering_ip | string | query | 否 | 资源ip，支持模糊查询  
  
# 返回值

名称 | 类型 | 是否必须 | 描述  
---|---|---|---  
data | []BGPIPResource | 是 | 高防资源列表  
page | int | 是 | 查询页码  
size | int | 是 | 分页大小  
total | int | 是 | 高防资源总数  
request_id | string | 是 | 请求记录 id  
  
  

### BGPIPResource 实例信息

名称 | 类型 | 是否必须 | 描述  
---|---|---|---  
region_id | string | 是 | 地域 id  
resource_id | string | 是 | 资源 id  
name | string | 是 | 资源名称  
ip | string | 是 | 高防 IP 地址  
expire_time | string | 是 | 到期时间，示例：2020-01-09T18:21:55+08:00  
status | string | 是 | 实例状态，取值：idle(运行中), attacking(攻击中), blocking(封堵中), creating(创建中)，isolate（隔离中）  
cc_peak | int | 是 | CC防护峰值, 单位：QPS  
http_cc_threshold | int | 是 | CC防护触发阈值, 单位：QPS  
http_cc_enable | int | 是 | CC防护开关状态, 取值：1（开启），0（关闭）  
elastic_limit | int | 是 | 弹性防护带宽，单位：Mbps  
bandwidth | int | 是 | 保底防护带宽，单位：Mbps  
source_ip_segment | string | 是 | 回源 ip 段，多个 ip 段用‘;’分割  
  
  

# 示例

### 正常返回示例

    
    
    {
        "data": [
            {
                "region_id": "cn-shanghai",
                "resource_id": "bgpip-xxx",
                "name": "高防测试",
                "ip": 2.3.4.5,
                "expire_time": "2020-01-09T18:21:55+08:00",
                "status": idle,
                "cc_peak": 40000,
                "http_cc_threshold": 100,
                "http_cc_enable": 1,
                "elastic_limit": 30000,
                "bandwidth": 20000,
                "source_ip_segment": "0.0.0.0/0",
            }
        ],
        "page": 1,
        "size": 20,
        "total": 1,
        "request_id": "04F0F334-AC1"
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的云主机修改实例名称

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 经典版 DDoS 高防 IP >资源管理 >修改实例名称

#  修改实例名称

最近更新时间: 2022-02-18 12:11:36

# 请求路径

> `PATCH` /v1/security/bgpip/resource/:resource_id/name

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
X-Qiniu-Regionid | string | header | 是 | 地域 id, 取值：shanghai (大陆通用地域)  
resource_id | string | path | 是 | 高防实例 id  
name | string | body | 是 | 新实例名称，不能以数字开头，长度不超过32个字符  
  
# 返回值

名称 | 类型 | 是否必须 | 描述  
---|---|---|---  
request_id | string | 是 | 请求记录 id  
  
  

# 示例

### Body示例

    
    
    {
    	"name": "new_name"
    }
    

### 正常返回示例

    
    
    {
        "request_id": "04F0F334-AC1"
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的云主机修改弹性防护带宽

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 经典版 DDoS 高防 IP >资源管理
>修改弹性防护带宽

#  修改弹性防护带宽

最近更新时间: 2022-02-18 12:11:46

# 请求路径

> `PATCH` /v1/security/bgpip/resource/:resource_id/elastic_limit

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
X-Qiniu-Regionid | string | header | 是 | 地域 id, 取值：shanghai (大陆通用地域)  
resource_id | string | path | 是 | 高防实例 id  
elastic_limit | string | body | 是 | 弹性防护阈值，单位 Mbps, 取值[0 30000 40000 50000 60000 70000 80000 90000 100000 150000 200000 250000 300000],  
当取值为0时表示关闭弹性防护，否则取值需高于实例的保底防护带宽  
  
  

# 返回值

名称 | 类型 | 是否必须 | 描述  
---|---|---|---  
request_id | string | 是 | 请求记录 id  
  
  

# 示例

### Body参数示例

    
    
    {
    	"elastic_limit": 30000
    }
    

### 正常返回示例

    
    
    {
        "request_id": "04F0F334-AC1"
    }
    

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