更新全域公网带宽 - UpdateInternetBandwidth

功能介绍

更新全域公网带宽。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见权限和授权项。

如果使用身份策略授权，需具备如下身份策略权限。

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
eip:internetBandwidths:update	Write	internetBandwidth *	g:EnterpriseProjectId g:ResourceTag/<tag-key>	-	-

URI

PUT /v3/{domain_id}/geip/internet-bandwidths/{internet_bandwidth_id}

表1 路径参数
参数	是否必选	参数类型	描述
domain_id	是	String	租户账号ID，获取租户账号ID请参见租户账号ID 最小长度：5 最大长度：32
internet_bandwidth_id	是	String	全域公网带宽的ID 最小长度：36 最大长度：36

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	用户的Token，获取用户Token请参见获取用户Token

表3 请求Body参数
参数	是否必选	参数类型	描述
internet_bandwidth	是	internet_bandwidth object	更新全域公网带宽请求对象

表4 internet_bandwidth
参数	是否必选	参数类型	描述
name	否	String	功能说明：全域公网带宽名称取值范围：1-64，支持数字、字母、中文、_(下划线)、-（中划线）、.（点）最小长度：1 最大长度：64
description	否	String	功能说明：用户自定义的资源描述约束与限制：值的长度最大512字符，由数字、字母、中文、_(下划线)、-（中划线）、.（点）组成。最小长度：0 最大长度：512
size	否	Integer	功能说明：全域公网带宽大小（出云方向），具体取值范围以购买页面为准约束与限制：包年/包月全域公网带宽不支持修改带宽大小最小值：1
charge_mode	否	String	功能说明：计费模式，客户支持的计费类型可通过全域公网带宽限制列表接口查询。约束与限制：95计费需要满足一定条件才可使用，具体请见计费类。取值范围： bandwidth(按带宽计费) traffic(按流量计费) 95peak_plus_1000(按增强型95计费) 95peak_bidirection(按双向型传统95计费) 95peak_guar(带保底传统型95计费) 95peak_avr(95峰值平均计费)
ingress_size	否	Integer	全域公网带宽大小（入云方向），具体取值范围以购买页面为准最小值：1

响应参数

状态码：200

表5 响应Header参数
参数	参数类型	描述
X-Request-Id	String	本次请求编号

请求示例

更新带宽id为8efa2f2e-dc96-4bae-9323-ab5c472ad4bf的名称和大小

PUT https://{Endpoint}/v3/{domain_id}/geip/internet-bandwidths/8efa2f2e-dc96-4bae-9323-ab5c472ad4bf

{
  "internet_bandwidth" : {
    "size" : 90,
    "name" : "test"
  }
}

响应示例

状态码：200

{
  "example" : {
    "internet_bandwidth" : {
      "enterprise_project_id" : 0,
      "name" : "test",
      "created_at" : "2023-12-11T09:15:00Z",
      "updated_at" : "2023-12-11T09:21:59Z",
      "id" : "8efa2f2e-dc96-4bae-9323-ab5c472ad4bf",
      "isp" : "BGP",
      "access_site" : "cn-south-odin",
      "size" : 90,
      "description" : null,
      "charge_mode" : "bandwidth",
      "freezen_info" : null,
      "domain_id" : "f35feb8670a94a04a08d6628e0d5165b",
      "is_pre_paid" : false,
      "is_change_service" : false,
      "status" : "normal",
      "ratio_95peak" : 0,
      "ingress_size" : 90,
      "tags" : [ ]
    },
    "request_id" : "ef72b4af0a83461d13e2a45a2656b555"
  },
  "schema" : {
    "$ref" : "#/components/schemas/UpdateInternetBandwidthResponseBody"
  }
}