更新专享版实例
功能介绍
更新专享版实例
调用方法
请参见如何调用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 枚举值：
|
|
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) ，暂不支持 |
|
eip_ipv6_address |
String |
弹性IP地址(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 |
入公网带宽计费模式 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
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 |
错误码
请参见错误码。
