修改实例安全组 - ChangingtheSecurityGroupofanInstance
接口约束
容灾场景下，修改安全组时需要确保主实例与容灾实例连接的端口已在安全组的入方向规则中放开。
调试
您可以在API Explorer中调试该接口。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
- 如果使用身份策略授权，需具备如下身份策略权限。
授权项
访问级别
资源类型（*为必须）
条件键
别名
依赖的授权项
gaussdb:instance:modifySecurityGroup
write
instance
-
gaussdb:instance:modifySecurityGroup
-
URI
PUT /v3/{project_id}/instances/{instance_id}/security-group
名称 | 是否必选 | 参数类型 | 说明 |
|---|---|---|---|
project_id | 是 | String | 参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 只能由英文字母、数字组成，且长度为32个字符。 默认取值： 不涉及。 |
instance_id | 是 | String | 参数解释： 实例ID，此参数是用户创建实例的唯一标识。请参考查询数据库实例列表 - QueryingDBInstances接口获取实例ID。 约束限制： 不涉及。 取值范围： 只能由英文字母、数字组成，且长度为36个字符。 默认取值： 不涉及。 |
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
X-Auth-Token | 是 | String | 参数解释： 用户Token。 通过调用IAM服务获取用户Token接口获取。 请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 |
X-Language | 否 | String | 参数解释： 语言。 约束限制： 不涉及。 取值范围：
默认取值： en-us |
名称 | 是否必选 | 参数类型 | 说明 |
|---|---|---|---|
security_group_id | 是 | String | 参数解释: 目标安全组ID。请参考查询安全组列表接口获取安全组ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
响应参数
名称 | 参数类型 | 说明 |
|---|---|---|
job_id | String | 参数解释: 修改实例安全组的工作流ID。 取值范围: 不涉及。 |
请求示例
PUT https://gaussdb-opengauss.cn-north-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in14/security-group
{
"security_group_id": "2ea4d7a0-c317-4bbc-b53e-2c67b5499781"
} 响应示例
{
"job_id": "e51532df-b94d-4fbc-9cf0-aea030ade45d"
} 状态码
- 正常
- 异常
请参见状态码。
错误码
请参见错误码。
