全部产品
Search
文档中心

云服务器 ECS:ModifySecurityGroupAttribute

更新时间:Sep 12, 2023

调用ModifySecurityGroupAttribute修改一个安全组的名称或者描述。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称

类型

是否必选

示例值

描述

Action String ModifySecurityGroupAttribute

系统规定参数。取值:ModifySecurityGroupAttribute

SecurityGroupId String sg-bp67acfmxazb4p****

安全组ID。

Description String TestDescription

安全组描述信息。长度为2~256个英文或中文字符,不能以http://https://开头。

默认值:空

SecurityGroupName String SecurityGroupTestName

安全组名称。 长度为2~128个英文或中文字符。必须以大小写字母或中文开头,不能以http://https://开头。可以包含数字、半角冒号(:)、下划线(_)或者连字符(-)。

默认值:空

RegionId String cn-hangzhou

地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。

返回数据

名称

类型

示例值

描述

RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

请求ID。

示例

请求示例

https://ecs.aliyuncs.com/?Action=ModifySecurityGroupAttribute
&SecurityGroupId=sg-bp67acfmxazb4p****
&RegionId=cn-hangzhou
&SecurityGroupName=SecurityGroupTestName
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifySecurityGroupAttributeResponse>
     <RequestId>CEF72CEB-54B6-4AE8-B225-F876FF7BA984</RequestId>
</ModifySecurityGroupAttributeResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "CEF72CEB-54B6-4AE8-B225-F876FF7BA984"
}

错误码

HttpCode

错误码

错误信息

描述

400 InvalidSecurityGroupName.Malformed Specified security group name is not valid. 指定的安全组名称格式不合法。请您按照规则进行配置:默认值为空,长度为 2-128 个英文或中文字符,必须以大小字母或中文开头,可包含数字,英文句号(.),下划线(_)或连字符(-),安全组名称会展示在控制台。不能以 http:// 和 https:// 开头。
400 InvalidSecurityGroupDiscription.Malformed Specified security group description is not valid. 指定的安全组描述不合法。
403 InvalidOperation.ResourceManagedByCloudProduct %s 云产品托管的安全组不支持修改操作。
404 InvalidSecurityGroupId.NotFound The specified SecurityGroupId does not exist. 指定的安全组在该用户账号下不存在,请您检查安全组 ID 是否正确。

访问错误中心查看更多错误码。