变更实例安全组 - 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
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
project_id | 是 | String | 参数解释： 租户在某一region下的project ID。获取方法请参见获取项目ID。 束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 |
instance_id | 是 | String | 参数解释： 实例ID。 束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 |
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
X-Auth-Token | 是 | String | 参数解释： 用户Token。 束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
security_group_id | 是 | String | 参数解释： 新的安全组ID。 束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 |
响应参数
状态码： 202
参数 | 参数类型 | 描述 |
|---|---|---|
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"
} 状态码
请参见状态码。
错误码
请参见错误码。
