更新专享版实例
功能介绍
更新专享版实例
调用方法
请参见如何调用API。
URI
PUT /v2/{project_id}/apigw/instances/{instance_id}
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目ID,获取方式请参见获取项目ID。 |
instance_id |
是 |
String |
实例ID,在API网关控制台的“实例信息”中获取。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
description |
否 |
String |
实例描述。支持除>和<以外的字符,长度为0~255。 |
maintain_begin |
否 |
String |
维护时间窗开始时间。时间格式为 xx:00:00,xx取值为02,06,10,14,18,22。 在这个时间段内,运维人员可以对该实例的节点进行维护操作。维护期间,业务可以正常使用,可能会发生闪断。维护操作通常几个月一次。 |
maintain_end |
否 |
String |
维护时间窗结束时间。时间格式为 xx:00:00,与维护时间窗开始时间相差4个小时。 在这个时间段内,运维人员可以对该实例的节点进行维护操作。维护期间,业务可以正常使用,可能会发生闪断。维护操作通常几个月一次。 |
instance_name |
否 |
String |
实例名称。 中英文字符开头,只能由中英文字符、数字、中划线、下划线组成,长度为3~64。
说明:
中文字符必须为UTF-8或者unicode编码。 最小长度:3 最大长度:64 |
security_group_id |
否 |
String |
指定实例所属的安全组。 获取方法如下:
|
vpcep_service_name |
否 |
String |
终端节点服务的名称。 支持英文、数字、中划线、下划线,0~16个字符。 如果您填写该参数为空,系统生成的终端节点服务的名称为{region}.{service_id}。 如果您填写该参数,系统生成的终端节点服务的名称为{region}.{vpcep_service_name}.{service_id}。 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
实例ID |
project_id |
String |
实例所属租户ID |
instance_name |
String |
实例名称 |
status |
String |
实例状态:
|
instance_status |
Integer |
实例状态对应编号
|
type |
String |
实例类型 默认apig |
spec |
String |
实例规格:
|
create_time |
Long |
实例创建时间。unix时间戳格式。 |
enterprise_project_id |
String |
企业项目ID,企业账号必填 |
eip_address |
String |
实例绑定的弹性IP地址 |
charging_mode |
Integer |
实例计费方式:
|
cbc_metadata |
String |
计费订单编号参数暂未使用 |
loadbalancer_provider |
String |
实例使用的负载均衡器类型
缺省值:lvs |
cbc_operation_locks |
Array of CbcOperationLock objects |
云运营限制操作锁 |
description |
String |
实例描述 |
vpc_id |
String |
虚拟私有云ID。 获取方法如下:
|
subnet_id |
String |
子网的网络ID。 获取方法如下:
|
security_group_id |
String |
指定实例所属的安全组。 获取方法如下:
|
maintain_begin |
String |
'维护时间窗开始时间。时间格式为 xx:00:00,xx取值为02,06,10,14,18,22。' '在这个时间段内,运维人员可以对该实例的节点进行维护操作。维护期间,业务可以正常使用,可能会发生闪断。维护操作通常几个月一次。' |
maintain_end |
String |
'维护时间窗结束时间。时间格式为 xx:00:00,与维护时间窗开始时间相差4个小时。' '在这个时间段内,运维人员可以对该实例的节点进行维护操作。维护期间,业务可以正常使用,可能会发生闪断。维护操作通常几个月一次'。 |
ingress_ip |
String |
实例入口,虚拟私有云访问地址 |
ingress_ip_v6 |
String |
实例入口,虚拟私有云访问地址 (IPv6) |
user_id |
String |
实例所属用户ID |
nat_eip_ipv6_cidr |
String |
出公网网段 (IPv6) 。 当前仅部分region部分可用区支持IPv6 |
eip_ipv6_address |
String |
弹性IP地址(IPv6)。 当前仅部分region部分可用区支持IPv6 |
nat_eip_address |
String |
实例出公网IP |
bandwidth_size |
Integer |
出公网带宽 |
bandwidth_charging_mode |
String |
出公网带宽计费模式 |
available_zone_ids |
String |
可用区 |
instance_version |
String |
实例版本编号 |
virsubnet_id |
String |
子网的网络ID。 暂不支持 |
roma_eip_address |
String |
roma弹性公网IP。 暂不支持 |
listeners |
Object |
监听信息 暂不支持 |
supported_features |
Array of strings |
实例支持的特性列表 |
endpoint_service |
EndpointService object |
终端节点服务详情 待废弃,优先使用endpoint_services |
endpoint_services |
Array of EndpointService objects |
终端节点服务列表 |
node_ips |
NodeIps object |
服务节点IP |
node_ipv6_ips |
NodeIps object |
服务IPV6节点IP |
public_ipv6_ips |
Array of strings |
实例IPV6出公网IP |
publicips |
Array of IpDetails objects |
公网入口地址列表 |
privateips |
Array of IpDetails objects |
私网入口地址列表 |
unreliable_ips |
Array of strings |
不建议使用的实例入口列表:分组子域名解析未指向到该列表的IP,不能用该列表的IP直接访问DEFAULT分组 |
enable_fullstack_ipv6 |
Boolean |
实例是否支持全量IPv6
|
is_releasable |
Boolean |
实例是否可释放
|
ingress_bandwidth_charging_mode |
String |
入公网带宽计费模式 |
参数 |
参数类型 |
描述 |
---|---|---|
lock_scene |
String |
限制操作场景:
|
lock_source_id |
String |
发起限制操作对象的标志 |
参数 |
参数类型 |
描述 |
---|---|---|
livedata |
Array of strings |
livedata节点IP地址列表 |
shubao |
Array of strings |
shubao节点IP地址列表 |
参数 |
参数类型 |
描述 |
---|---|---|
ip_address |
String |
IP地址 |
ipv6_address |
String |
IPV6地址 |
bandwidth_size |
Integer |
带宽大小 |
状态码: 400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码 |
error_msg |
String |
错误描述 |
状态码: 401
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码 |
error_msg |
String |
错误描述 |
状态码: 403
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码 |
error_msg |
String |
错误描述 |
状态码: 404
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码 |
error_msg |
String |
错误描述 |
状态码: 500
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码 |
error_msg |
String |
错误描述 |
请求示例
更新实例的信息
{ "description" : "test create instance", "instance_name" : "apig-demo" }
响应示例
状态码: 200
OK
{ "available_zone_ids" : "[xx-xxx-7a, xx-xxx-7b]", "bandwidth_size" : 5, "description" : "test create instance", "enterprise_project_id" : "0", "instance_name" : "apig-demo", "maintain_begin" : "22:00:00", "maintain_end" : "02:00:00", "security_group_id" : "36d0ec18-bd10-4da7-86f3-ad7a5ddc55d7", "spec" : "PROFESSIONAL", "subnet_id" : "a938121c-11c4-4c91-b983-bc9acd347bb5", "vpc_id" : "0957108c-257c-4ce0-9e93-527d279ce763", "enable_fullstack_ipv6" : true, "unreliable_ips" : [ "192.xx.xxx.xxx" ] }
状态码: 400
Bad Request
{ "error_code" : "APIC.7211", "error_msg" : "Parameter value does not match the rules, parameter name[maintainBegin]" }
状态码: 401
Unauthorized
{ "error_code" : "APIC.7102", "error_msg" : "Incorrect token or token resolution failed" }
状态码: 403
Forbidden
{ "error_code" : "APIC.7106", "error_msg" : "No permissions to request for the method" }
状态码: 404
Not Found
{ "error_code" : "APIC.7302", "error_msg" : "Instance not found" }
状态码: 500
Internal Server Error
{ "error_code" : "APIC.9000", "error_msg" : "Failed to request internal service" }
状态码
状态码 |
描述 |
---|---|
200 |
OK |
400 |
Bad Request |
401 |
Unauthorized |
403 |
Forbidden |
404 |
Not Found |
500 |
Internal Server Error |
错误码
请参见错误码。