文档中心

私有网络

安全组

ModifySecurityGroupAttributes - 修改安全组信息

调用 ModifySecurityGroupAttributes 接口，修改安全组的名称和描述。

使用说明

以下可选参数如不配置，则保持原有配置。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action String 必选示例值：ModifySecurityGroupAttributes

接口名称。当前 API 的名称为ModifySecurityGroupAttributes。

Version String 必选示例值：2020-04-01

接口版本。当前 API 的版本为 2020-04-01。

SecurityGroupId String 必选示例值：sg-bp67acfmxazb4p****

安全组ID。

您可以调用 DescribeSecurityGroups 接口，查询安全组的ID。

SecurityGroupName String 可选示例值：sg-1

安全组的名称。

长度限制为1 ~ 128个字符。

需要以字母、中文或数字开头，可包含点号（.）、下划线（_）和短横线（-）。

Description String 可选示例值：sg_1

安全组的描述信息。

长度限制为0~ 255个字符。

需要以字母、中文或数字开头。可包含英文逗号（,）、点号（.）、下划线（_）、空格（）、等号（=）、短横线（-）、中文逗号（，）、中文句号（。）。

返回参数

下方仅列出本接口特有的返回参数。更多信息请参见返回结构。

RequestId String 示例值：2021062415303301022514515207C4****

请求ID。

请求示例

GET /?Action=ModifySecurityGroupAttribute&Version=2020-04-01&SecurityGroupId=sg-bp67acfmxazb4p****&SecurityGroupName=sg-1 HTTP/1.1​
Host: vpc.cn-beijing.volcengineapi.com​
X-Date: 20251121T094038Z​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20251121/cn-beijing/vpc/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​

返回示例

{​
    "ResponseMetadata": {​
        "RequestId": "20230604110420****100232280022D31",​
        "Action": "ModifySecurityGroupAttributes",​
        "Version": "2020-04-01",​
        "Service": "vpc",​
        "Region": "cn-beijing"​
    },​
    "Result": {​
        "RequestId": "2021062415303301022514515207C4****"​
    }​
}​

错误码

状态码	错误码	错误信息	说明
400	DryRunOperation	Exception raised to indicate a successfully authorized action when the DryRun flag is set to true.	该请求设置为DryRun操作，操作授权已获得许可，但未被实际执行。
400	InvalidDescription.Malformed	The specified description is malformed.	指定的描述格式不合法。请修复描述格式后重试。
400	InvalidDescription.Malformed	The specified description is malformed. Ensure the maximum length of description is 255.	指定的描述格式不合法。描述长度不能超过255个字符。
400	InvalidName.Malformed	The specified name is malformed.	指定的名称格式不合法。请修复名称格式后重试。
400	InvalidName.Malformed	The specified name is malformed. Ensure the maximum length of name is 128.	指定的名称格式不合法。名称长度不能超过128个字符。
400	InvalidSecurityGroup.InvalidStatus	The specified security group is not in the correct status for the request.	指定的安全组所处的状态无法响应该请求。
403	Forbidden	You are not authorized to perform operations on the specified security group. The specified security group is a service-managed security group.	无权限对指定安全组进行操作。指定的安全组为云产品托管的安全组。
404	InvalidSecurityGroupId.NotFound	The specified security group does not exist.	指定的安全组不存在。

最近更新时间：2026.02.09 16:06:02

这个页面对您有帮助吗？

有用

无用