文档首页/ 云数据库 GeminiDB/ API参考/ API v3(推荐)/ 实例管理/ 变更实例安全组 - ChangingtheSecurityGroupofanInstance
更新时间:2025-11-26 GMT+08:00
分享

变更实例安全组 - ChangingtheSecurityGroupofanInstance

功能介绍

变更实例关联的安全组

接口约束

该接口支持如下数据库实例:

  • GeminiDB Cassandra
  • GeminiDB Mongo
  • GeminiDB Influx
  • GeminiDB Redis

异常实例不支持该操作。

请确认修改后的安全组策略。该策略可能会影响当前的实例连接,导致连接中断。

调试

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

授权信息

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

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项
  • 如果使用身份策略授权,需具备如下身份策略权限。

    授权项

    访问级别

    资源类型(*为必须)

    条件键

    别名

    依赖的授权项

    gaussdbfornosql:instance:updateSecurityGroup

    Write

    instance *

    • g:ResourceTag/<tag-key>
    • g:EnterpriseProjectId

    nosql:instance:modifySecurityGroup

    -

URI

PUT /v3/{project_id}/instances/{instance_id}/security-group

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释

租户在某一region下的project ID。获取方法请参见获取项目ID

束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

instance_id

String

参数解释

实例ID。

束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释

用户Token。

束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

表3 请求Body参数

参数

是否必选

参数类型

描述

security_group_id

String

参数解释

新的安全组ID。

束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

响应参数

状态码: 202

表4 响应Body参数

参数

参数类型

描述

job_id

String

参数解释

任务ID。

取值范围:

不涉及。

请求示例

  • URI样例
    PUT https://gaussdb-nosql.cn-north-4.myhuaweicloud.com/v3/375d8d8fad1f43039e23d3b6c0f60a19/instances/9136fd2a9fcd405ea4674276ce36dae8in02/security-group
  • 请求体样例
    {
      "security_group_id" : "73bed21a-708b-4985-b697-a96d0e0d2b39"
    }

响应示例

状态码: 202

No Content

{
  "job_id" : "3711e2ad-5787-49bc-a47f-3f0b066af9f5"
}

状态码

请参见状态码

错误码

请参见错误码

相关文档