jancd/qiniu-developer_ShareGPT huggingface dataset:
human: 如何处理七牛云的云主机获取四层规则列表

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

#  获取四层规则列表

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

# 请求路径

> `GET` /v1/security/bgpip/resource/:resource_id/level4rule_v2

# 请求参数

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

名称 | 类型 | 是否必须 | 描述  
---|---|---|---  
data | []Level4RuleDetail | 是 | 四层规则信息列表  
page | int | 是 | 查询页码  
size | int | 是 | 分页大小  
total | int | 是 | 四层规则总数  
request_id | string | 是 | 请求记录 id  
  
  

### Level4RuleDetail 详情

名称 | 类型 | 是否必须 | 描述  
---|---|---|---  
rule_id | string | 是 | 规则 id  
rule_name | string | 是 | 规则名称  
protocol | string | 是 | 转发协议类型，取值：TCP, UDP  
virtual_port | int | 是 | 转发端口  
source_port | int | 是 | 源站端口  
source_type | int | 是 | 回源类型，取值：1(域名回源)，2(IP回源)  
source_list | [ ] L4RuleSource | 是 | 回源列表  
keep_time | int | 是 | 会话保持时间，单位：秒  
keep_enable | int | 是 | 会话保持开关，取值：0(会话保持关闭)，1(会话保持开启)  
health_check | HealthCheckInfo | 是 | 健康检查信息  
  
  

### HealthCheckInfo 详情

名称 | 类型 | 是否必须 | 描述  
---|---|---|---  
rule_id | string | 是 | 四层规则 id  
enable | int | 是 | 是否开启，1表示开启；0表示关闭  
timeout | int | 是 | 响应超时时间，单位：秒  
interval | int | 是 | 检测间隔时间，单位：秒，必须要大于响应超时时间  
kick_num | int | 是 | 不健康阈值，单位：次  
alive_num | int | 是 | 健康阈值，单位：次  
err_msg | string | 是 | 健康检查错误信息  
  
  

# 示例

### 正常返回示例

    
    
    {
        "data": [
            {
                "rule_name": "",
                "rule_id": "rule1",
                "protocol": "TCP",
                "virtual_port": 9147,
                "source_port": 9147,
                "source_type": 2,
                "keep_time": 0,
                "keep_enable": 0,
                "source_list": [
                    {
                        "source": "1.2.3.4",
                        "weight": 1
                    }
                ],
                "health_check": {
                    "rule_id": "rule1",
                    "enable": 0,
                    "interval": 15,
                    "kick_num": 5,
                    "alive_num": 5,
                    "timeout": 6,
                    "err_msg": ""
                }
            }
        ],
        "page": 1,
        "size": 20,
        "total": 1,
        "request_id": "04F0F334-AC1"
    }
    

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

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 经典版 DDoS 高防 IP >四层规则管理
>创建四层规则

#  创建四层规则

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

# 请求路径

> `POST` /v1/security/bgpip/resource/:resource_id/level4rule_v2/create

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
X-Qiniu-Regionid | string | header | 是 | 地域 id, 取值：shanghai (大陆通用地域)  
resource_id | string | path | 是 | 高防实例 id  
rule_name | string | body | 否 | 规则名称，不能以数字开头，长度不超过32个字符  
protocol | string | body | 是 | 四层协议，取值：TCP, UDP  
virtual_port | int | body | 是 | 转发端口  
source_port | int | body | 是 | 源站端口  
source_type | int | body | 是 | 回源类型，取值：1(域名回源)，2(IP回源)  
source_list | [ ] L4RuleSource | body | 是 | 回源列表  
keep_time | int | body | 是 | 会话保持时间，单位秒  
keep_enable | int | body | 是 | 会话保持开关，取值：0(会话保持关闭)，1(会话保持开启)  
lb_type | int | body | 是 | 负载均衡方式，取值: 只能填1(加权轮询)  
  
  

#### L4RuleSource参数说明

名称 | 类型 | 是否必须 | 描述  
---|---|---|---  
source | string | 是 | 回源 IP 或域名  
weight | int | 是 | 回源权重，取值：0到100  
  
  

# 返回值

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

# 示例

### Body示例

    
    
    {
        "rule_name": "rule1",
        "protocol": "TCP",
        "virtual_port": 8000,
        "source_port": 8000,
        "source_type": 2,
        "keep_time": 0,
        "keep_enable": 0,
        "source_list": [
            {
                "source": "1.2.3.4",
                "weight": 1
            }
        ],
        "lb_type":1
    }
    

### 正常返回示例

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

以上内容是否对您有帮助？
human: 如何处理七牛云的云主机修改四层规则

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 经典版 DDoS 高防 IP >四层规则管理
>修改四层规则

#  修改四层规则

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

# 请求路径

> `PUT` /v1/security/bgpip/resource/:resource_id/level4rule_v2/:rule_id/update

# 请求参数

名称 | 类型 | 位置 | 是否必须 | 描述  
---|---|---|---|---  
X-Qiniu-Regionid | string | header | 是 | 地域 id, 取值：shanghai (大陆通用地域)  
resource_id | string | path | 是 | 高防实例 id  
rule_id | string | path | 是 | 规则 id, 可通过四层规则列表接口获取  
rule_name | string | body | 否 | 规则名称，不能以数字开头，长度不超过32个字符  
protocol | string | body | 是 | 四层协议，取值：TCP, UDP  
virtual_port | int | body | 是 | 转发端口  
source_port | int | body | 是 | 源站端口  
source_type | int | body | 是 | 回源类型，取值：1(域名回源)，2(IP回源)  
source_list | [ ] L4RuleSource | body | 是 | 回源列表  
keep_time | int | body | 是 | 会话保持时间，单位秒  
keep_enable | int | body | 是 | 会话保持开关，取值：0(会话保持关闭)，1(会话保持开启)  
lb_type | int | body | 是 | 负载均衡方式，取值: 只能填1(加权轮询)  
  
注：如果有部分参数无需修改，则填入修改前的参数值即可。

### L4RuleSource参数说明

名称 | 类型 | 是否必须 | 描述  
---|---|---|---  
source | string | 是 | 回源IP或域名  
weight | int | 是 | 回源权重，取值0到100  
  
  

# 返回值

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

# 示例

### Body参数示例

    
    
    {
        "rule_id": "rule-001",
        "rule_name": "rule1",
        "protocol": "TCP",
        "virtual_port": 8000,
        "source_port": 8000,
        "source_type": 2,
        "keep_time": 0,
        "keep_enable": 0,
        "source_list": [
            {
                "source": "1.2.3.4",
                "weight": 1
            }
        ],
        "lb_type":1
    }
    

### 正常返回示例

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

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

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 经典版 DDoS 高防 IP >四层规则管理
>删除四层规则

#  删除四层规则

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

# 请求路径

> `DELETE` /v1/security/bgpip/resource/:resource_id/level4rule_v2/delete

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
X-Qiniu-Regionid | string | header | 是 | 地域 id, 取值：shanghai (大陆通用地域)  
resource_id | string | path | 是 | 高防实例id  
rule_id_list | [] string | body | 是 | 需要删除的规则id列表  
  
# 返回值

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

# 示例

### Body示例

    
    
    {
        "rule_id_list": ["rule-1xxx"]
    }
    

  

### 正常返回示例

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

以上内容是否对您有帮助？
human: 如何处理七牛云的云主机修改四层规则健康检查

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 经典版 DDoS 高防 IP >四层规则管理
>修改四层规则健康检查

#  修改四层规则健康检查

最近更新时间: 2022-02-18 12:13:08

# 请求路径

> `PUT`
> /v1/security/bgpip/resource/:resource_id/level4rule_v2/:rule_id/health_check

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
X-Qiniu-Regionid | string | header | 是 | 地域 id, 取值：shanghai (大陆通用地域)  
resource_id | string | path | 是 | 高防实例 id  
rule_id | string | path | 是 | 规则 id, 可通过四层规则列表接口获取  
enable | int | body | 是 | 是否开启，1表示开启；0表示关闭  
timeout | int | body | 是 | 响应超时时间，单位：秒  
interval | int | body | 是 | 检测间隔时间，单位：秒，必须要大于响应超时时间  
kick_num | int | body | 是 | 不健康阈值，单位：次  
alive_num | int | body | 是 | 健康阈值，单位：次  
  
注：如果有部分参数无需修改，则填入修改前的参数值即可。

# 返回值

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

# 示例

### Body参数示例

    
    
    {
        "rule_id": "rule1",
        "enable": 0,
        "interval": 15,
        "kick_num": 5,
        "alive_num": 5,
        "timeout": 6,
        "err_msg": ""
    }
    

### 正常返回示例

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

以上内容是否对您有帮助？
human: 如何处理七牛云的云主机修改四层规则会话保持

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 经典版 DDoS 高防 IP >四层规则管理
>修改四层规则会话保持

#  修改四层规则会话保持

最近更新时间: 2022-02-18 12:13:21

# 请求路径

> `PUT`
> /v1/security/bgpip/resource/:resource_id/level4rule_v2/:rule_id/keep_time

# 请求参数

名称 | 类型 | 位置 | 是否必须 | 描述  
---|---|---|---|---  
X-Qiniu-Regionid | string | header | 是 | 地域 id, 取值：shanghai (大陆通用地域)  
resource_id | string | path | 是 | 高防实例 id  
rule_id | string | path | 是 | 规则 id, 可通过四层规则列表接口获取  
keep_time | int | body | 是 | 会话保持时间，单位：秒  
keep_enable | int | body | 是 | 会话保持开关，取值：0(关闭)，1(开启)  
  
注：如果有部分参数无需修改，则填入修改前的参数值即可。

# 返回值

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

# 示例

### Body参数示例

    
    
    {
        "keep_time": 10,
        "keep_enable": 1
    }
    

### 正常返回示例

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

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

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > Web应用防火墙 (WAF) >查询WAF实例列表

#  查询WAF实例列表

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

# 请求路径

> `GET` /v1/security/waf/:region/instances

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

名称 | 类型 | 位置 | 是否必须 | 描述  
---|---|---|---|---  
region | string | path | 是 | 区域信息，只能填cn，国内区域  
X-Qiniu-Regionid | string | header | 否 | 地域 ID, 取值: cn-hangzhou  
page | int | body | 否 | 查询页码  
size | int | body | 否 | 分页大小  
  
# 返回值

名称 | 类型 | 是否必须 | 描述  
---|---|---|---  
data | []WAFInstance | 是 | WAF实例列表  
page | int | 是 | 页码  
size | int | 是 | 分页大小  
total | int | 是 | 总数  
  
### WAFInstance WAF实例详情

名称 | 类型 | 是否必须 | 描述  
---|---|---|---  
region_id | string | 是 | 地域 ID  
resource_id | string | 是 | WAF实例ID  
status | string | 是 | WAF实例状态  
expire_time | string | 是 | 到期时间  
package_code | string | 是 | 版本类型，取值: version_3（内地高级版）, version_4（内地企业版）, version_4（内地旗舰版）  
ext_domain_package | int | 是 | 域名扩展包个数  
exclusive_ip_package | int | 是 | 域名独享资源包个数, 范围: 0-100, 粒度为1  
ext_bandwidth | int | 是 | 带宽扩展包大小，单位: Mbps  
app_sdk | bool | 是 | APP防护是否开启  
anti_bot | bool | 是 | Bot管理是否开启  
waf_gslb | bool | 是 | 智能负载均衡是否开启  
professional_service | bool | 否 | 专家服务是否开启  
big_screen | string | 是 | 0: 未开启， 1: 单屏服务, all: 多屏服务  
waf_log | bool | 是 | 是否开启日志服务  
log_storage | int | 是 | 日志存储大小, 单位: TB  
log_time | int | 是 | 日志存储时间, 单位: 天  
service_bandwidth | int | 是 | 业务带宽大小，单位: Mbps  
qps | int | 是 | 业务QPS大小  
source_ipv4_segment | string | 是 | ipv4回源网段  
source_ipv6_segment | string | 是 | ipv6回源网段  
  
# 示例

### 返回结果示例

    
    
    {
        "data": [
            {
                "region_id":"cn-hangzhou",
                "resource_id":"waf-cn-m7r22is373v",
                "status":"normal",
                "expire_time": "2021-10-21 00:00:00.000",
                "package_code": "version_3",
                "exclusive_ip_package": 0,
                "ext_bandwidth": 0,
                "ext_domain_package": 0,
                "app_sdk": false,
                "anti_bot": false,
                "waf_gslb": false,
                "source_ipv4_segment": "101.200.106.0/24,106.15.101.96/27,112.124.159.0/24",
                "source_ipv6_segment": "2408:400a:3c:4800::/56",
                "service_bandwidth": 100,
                "qps": 5000
            }
        ],
        "page":1,
        "size":10,
        "total":1
    }
    

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

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > Web应用防火墙 (WAF) >创建WAF实例

#  创建WAF实例

最近更新时间: 2022-02-18 16:01:53

# 请求路径

> `POST` /v1/security/waf/:region/create

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

名称 | 类型 | 位置 | 是否必须 | 描述  
---|---|---|---|---  
region | string | path | 是 | 区域信息, 只能填cn，国内区域  
X-Qiniu-Regionid | string | header | 是 | 地域 ID, 只能填cn-hangzhou，大陆通用地域  
package_code | string | body | 是 | 版本类型，取值: version_3（内地高级版）, version_4（内地企业版）, version_4（内地旗舰版）  
ext_domain_package | int | body | 是 | 域名扩展包个数  
exclusive_ip_package | int | body | 是 | 域名独享资源包个数, 范围: 0-100, 粒度为1  
ext_bandwidth | int | body | 是 | 带宽扩展包大小，单位: Mbps  
app_sdk | bool | body | 否 | APP防护是否开启 ，默认false, 下同  
anti_bot | bool | body | 否 | Bot管理是否开启  
waf_gslb | bool | body | 否 | 智能负载均衡是否开启  
professional_service | bool | body | 否 | 专家服务是否开启  
big_screen | string | body | 是 | 0: 未开启， 1: 单屏服务, all: 多屏服务  
waf_log | bool | body | 否 | 是否开启日志服务  
log_storage | int | body | 否 | 日志存储大小, 单位: TB  
log_time | int | body | 否 | 日志存储时间, 单位: 天  
cost_charge_type | string | body | 是 | 付费类型  
cost_period_unit | string | body | 是 | 付费周期  
cost_period | int | body | 是 | 付费周期长度  
client_token | string | body | 否 | 接口请求幂等参数  
enable_auto_renew | bool | body | 否 | 是否开启自动续费  
  
# 返回值

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

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

### 请求body示例

    
    
    {
        "package_code": "version_3",
        "exclusive_ip_package": 0,
        "ext_bandwidth": 0,
        "ext_domain_package": 0,
        "app_sdk": false,
        "anti_bot": false,
        "waf_gslb": false,
        "client_token": "0.33729492396085137",
        "cost_charge_type": "PrePaid",
        "cost_period_unit": "Month",
        "cost_period": 1,
        "enable_auto_renew": true
    }
    

### 正常返回示例

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

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

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > Web应用防火墙 (WAF) >升级WAF实例

#  升级WAF实例

最近更新时间: 2022-02-18 15:44:27

# 请求路径

> `POST` /v1/security/waf/:region/update

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

名称 | 类型 | 位置 | 是否必须 | 描述  
---|---|---|---|---  
region | string | path | 是 | 区域信息, 只能填cn，国内区域  
X-Qiniu-Regionid | string | header | 是 | 地域 ID, 只能填cn-hangzhou，大陆通用地域  
instance_id | int | body | 是 | WAF实例ID  
package_code | string | body | 是 | 版本类型，取值: version_3（内地高级版）, version_4（内地企业版）, version_4（内地旗舰版）  
ext_domain_package | int | body | 是 | 域名扩展包个数  
exclusive_ip_package | int | body | 是 | 域名独享资源包个数, 范围: 0-100, 粒度为1  
ext_bandwidth | int | body | 是 | 带宽扩展包大小，单位: Mbps  
app_sdk | bool | body | 否 | APP防护是否开启，默认false, 下同  
anti_bot | bool | body | 否 | Bot管理是否开启  
waf_gslb | bool | body | 否 | 智能负载均衡是否开启  
professional_service | bool | body | 否 | 专家服务是否开启  
big_screen | string | body | 是 | 0: 未开启， 1: 单屏服务, all: 多屏服务  
waf_log | bool | body | 否 | 是否开启日志服务  
log_storage | int | body | 否 | 日志存储大小, 单位: TB  
log_time | int | body | 否 | 日志存储时间, 单位: 天  
client_token | string | body | 否 | 接口请求幂等参数  
  
# 返回值

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

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

### 请求body示例

    
    
    {
        "package_code": "version_3",
        "exclusive_ip_package": 1,
        "ext_bandwidth": 1,
        "ext_domain_package": 0,
        "app_sdk": false,
        "anti_bot": false,
        "waf_gslb": false,
        "client_token": "0.33729492396085137"
    }
    

### 正常返回示例

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

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

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > Web应用防火墙 (WAF) >续费WAF实例

#  续费WAF实例

最近更新时间: 2022-02-18 15:02:26

# 请求路径

> `POST` /v1/security/waf/:cn/renew

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

名称 | 类型 | 位置 | 是否必须 | 描述  
---|---|---|---|---  
region | string | path | 是 | 区域信息，只能填cn，国内区域  
X-Qiniu-Regionid | string | header | 是 | 地域 ID, 只能填cn-hangzhou，大陆通用地域  
instance_id | string | body | 是 | WAF实例ID  
cost_charge_type | string | body | 是 | 付费类型  
cost_period_unit | string | body | 是 | 付费周期  
cost_period | int | body | 是 | 付费周期长度  
client_token | string | body | 否 | 接口请求幂等参数  
  
# 返回值

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

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

### 请求body示例

    
    
    {
        "instance_id": "waf-xxx,
        "client_token": "0.33729492396085137",
        "cost_charge_type": "PrePaid",
        "cost_period_unit": "Month",
        "cost_period": 1
    }
    

### 正常返回示例

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

以上内容是否对您有帮助？
human: 如何处理七牛云的云主机标签

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 标签

#  标签

最近更新时间: 2021-02-26 14:16:18

管理资源标签

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

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 >
[标签](https://developer.qiniu.com/qvm/api/7786/resource-tags) > 标签列表

#  标签列表

最近更新时间: 2021-02-26 14:45:36

# 请求路径

> `GET` /v1/tag/meta

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
with_detail | bool | query | 否 |  是否返回标签详细信息，默认 false   
  
# 返回值

名称 | 类型 | 描述  
---|---|---  
request_id | string | 请求 ID  
data | []Tag | 标签列表  
  
### Tag

名称 | 类型 | 描述  
---|---|---  
name | string |  标签名  
description | string |  描述信息  
resource_count | int |  with_detail == true 时会返回  
  
## 返回值示例

    
    
    {
      "data": [
        {
          "name": "proxy",
          "description": "proxy resources",
          "resource_count": 10
        }
      ],
      "request_id": "N8cGF3EvRnQOSFMW"
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的云主机创建/更新标签

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 >
[标签](https://developer.qiniu.com/qvm/api/7786/resource-tags) > 创建/更新标签

#  创建/更新标签

最近更新时间: 2021-02-26 14:34:27

# 请求路径

> `PUT` /v1/tag/meta/:name

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
name | string | path | 是 |  标签名称，如果存在同名标签，更新其 description 字段；如果不存在则新建   
description | string | body | 否 |  标签描述   
  
# 返回值

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

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 >
[标签](https://developer.qiniu.com/qvm/api/7786/resource-tags) > 标签详情

#  标签详情

最近更新时间: 2021-02-26 14:31:20

# 请求路径

> `GET` /v1/tag/meta/:name

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
name | string | path | 是 |  标签名称   
  
# 返回值

名称 | 类型 | 描述  
---|---|---  
request_id | string | 请求 ID  
data | TagInfo | 标签信息  
  
### TagInfo

名称 | 类型 | 描述  
---|---|---  
name | string |  标签名  
description | string |  描述信息  
items | []TagResourceItem |  该标签下的资源信息   
  
### TagResourceItem

名称 | 类型 | 描述  
---|---|---  
region_id | string |  地域名称   
resource_type | string |  资源类型   
resource_id | string |  资源ID   
  
## 返回值示例

    
    
    {
      "data": [
        {
          "name": "proxy",
          "description": "proxy resources",
          "items": [
            {
              "region_id": "cn-beijing",
              "resource_type": "disk",
              "resource_id": "d-xxx"
            }
          ]
        }
      ],
      "request_id": "N8cGF3EvRnQOSFMW"
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的云主机删除标签

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 >
[标签](https://developer.qiniu.com/qvm/api/7786/resource-tags) > 删除标签

#  删除标签

最近更新时间: 2021-02-26 14:36:07

# 请求路径

> `DELETE` /v1/tag/meta/:tag_name

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
tag_name | string | path | 是 | 标签名称  
  
# 返回值

名称 | 类型 | 描述  
---|---|---  
request_id | string | 请求 ID  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的云主机资源标签列表查询

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 >
[标签](https://developer.qiniu.com/qvm/api/7786/resource-tags) > 资源标签列表查询

#  资源标签列表查询

最近更新时间: 2021-02-26 15:18:50

# 请求路径

> `GET` /v1/tag/resource/:resource_id

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
resource_id | string | path | 是 |  资源ID   
region_id | string | query | 是 |  资源所在地域ID   
  
# 返回值

名称 | 类型 | 描述  
---|---|---  
request_id | string | 请求 ID  
data | []Tag | 标签列表  
  
### Tag

名称 | 类型 | 描述  
---|---|---  
name | string |  标签名  
description | string |  描述信息  
  
## 返回值示例

    
    
    {
      "data": [
        {
          "name": "proxy",
          "description": "proxy resources",
        }
      ],
      "request_id": "N8cGF3EvRnQOSFMW"
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的云主机资源添加标签

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 >
[标签](https://developer.qiniu.com/qvm/api/7786/resource-tags) > 资源添加标签

#  资源添加标签

最近更新时间: 2021-02-26 15:19:35

# 请求路径

> `POST` /v1/tag/resource

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
resource_type | string | body | 是 |  资源类型   
resource_id | string | body | 是 |  资源ID   
region_id | string | query | 是 |  资源所在地域ID   
tag | []string | body | 是 |  需要添加的标签名列表   
  
# 返回值

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

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 >
[标签](https://developer.qiniu.com/qvm/api/7786/resource-tags) > 资源删除标签

#  资源删除标签

最近更新时间: 2021-02-26 15:19:58

# 请求路径

> `DELETE` /v1/tag/resource/:resource_id

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
resource_type | string | body | 是 |  资源类型   
resource_id | string | body | 是 |  资源ID   
region_id | string | query | 是 |  资源所在地域ID   
tag | []string | body | 是 |  需要删除的标签名列表   
  
# 返回值

名称 | 类型 | 描述  
---|---|---  
request_id | string | 请求 ID  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的云主机订单详情查询

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 财务 >订单详情查询

#  订单详情查询

最近更新时间: 2021-02-01 12:18:17

# 请求路径

> `GET` /v1/order/detail/<order_hash>

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
order_hash | string | url | 是 |  订单 Hash  
  
# 返回值

名称 | 类型 | 描述  
---|---|---  
request_id | string | 请求 ID  
data | OrderInfo[] | 订单信息  
  
### OrderInfo

名称 | 类型 | 描述  
---|---|---  
order | string | 订单 Hash  
fee | float64 | 订单原价  
c_fee | float64 | 订单实付金额  
create_time | string | 创建时间  
pay_time | string | 支付时间  
cancel_time | string | 取消时间  
expire_time | string | 支付过期时间  
status | OrderStatus | 订单状态  
items | OrderItemInfo | 订单资源信息  
  
### OrderStatus

名称 | 类型 | 描述  
---|---|---  
new | string | 新建状态  
paid | string | 已经支付状态  
canceled | string | 被取消状态  
complete | string | 订单下所有子订单都已经发货完成  
refund | string | 用户订单执行了退款  
  
### OrderItemInfo

名称 | 类型 | 描述  
---|---|---  
order_type | string | 订单类型  
price | float64 | 金额  
region | string | 地域  
resource_type | string | 资源类型  
resource_id | string | 资源 ID  
status | OrderItemStatus | 发货状态  
life_start_time | string | 生命周期生效时间  
life_start_time | string | 生命周期失效时间  
  
### OrderItemStatus

名称 | 类型 | 描述  
---|---|---  
non_executable | string | 不可执行状态  
executable | string | 可执行状态  
processing | string | 正在执行中  
success | string | 执行成功  
failed | string | 执行失败  
fail_over | string | 失败次数过多  
cancelled | string | 被取消  
refunded | string | 已退款  
  
## 返回值示例

    
    
    {
      "data": {
        "order": "602892b7b500000eed4190e932000000",
        "fee": 29.55,
        "c_fee": 29.55,
        "create_time": "2020-09-16T11:57:18Z",
        "pay_time": "2020-09-17T14:58:22Z",
        "cancel_time": "0001-01-01T00:00:00Z",
        "expire_time": "2020-09-23T19:57:18+08:00",
        "status": "complete",
        "items": [
          {
            "order_type": "create",
            "resource_type": "instance",
            "resource_id": "i-xxxx",
            "region": "cn-qingdao",
            "price": 16.25,
            "status": "success",
            "life_start_time": "2020-09-17T14:59:07Z",
            "life_expire_time": "2020-10-18T00:00:00Z"
          },
          {
            "order_type": "create",
            "resource_type": "disk",
            "resource_id": "d-xxxx",
            "region": "cn-qingdao",
            "price": 13.3,
            "status": "success",
            "life_start_time": "2020-09-17T14:59:07Z",
            "life_expire_time": "2020-10-18T00:00:00Z"
          }
        ]
      },
      "request_id": "TRBUBYEtcQWEg18W"
    }
    

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