JoinSecurityGroup_云服务器 ECS_API文档-阿里云OpenAPI开发者门户

接口说明

说明该 API 已不推荐使用。推荐您调用 ModifyInstanceAttribute 接口将 ECS 实例加入或移除安全组；调用 ModifyNetworkInterfaceAttribute 接口将弹性网卡（ENI）加入或移除安全组。

该接口不支持同时将实例和弹性网卡加入一个安全组，即参数InstanceId和NetworkInterfaceId不能同时传值。
您的安全组和实例必须属于同一个阿里云地域。
您的安全组和实例的网络类型必须相同。如果网络类型为专有网络 VPC，则安全组和实例必须属于同一个 VPC。
加入安全组之前，实例必须处于已停止（Stopped）或者运行中（Running）状态。
一台实例或一张弹性网卡最多可以加入五个安全组。更多信息，请参见安全组使用限制。

流控信息

请求速率为1000/60(s)。

授权信息

如下是此API对应的授权信息，用于RAM权限策略语句的Action元素中，为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置，使用方法可参考访问控制帮助文档。

具体说明如下：展开详情

操作	访问级别	资源类型	条件关键字	关联操作

ecs:JoinSecurityGroup	Update	Instance acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId} SecurityGroup acs:ecs:{#regionId}:{#accountId}:securitygroup/{#securitygroupId}	无	无

请求参数

字段名称	字段详情
SecurityGroupIdstring	安全组 ID。您可以调用 DescribeSecurityGroups 查看您可用的安全组。示例值:sg-bp67acfmxazb4p****参考取值来源: CreateSecurityGroup DescribeSecurityGroups
InstanceIdstring	实例 ID。展开详情示例值:i-bp67acfmxazb4p****参考取值来源: RunInstances StopInstances CreateInstance StartInstances RebootInstances DescribeInstances ModifyManagedInstance RenewReservedInstances DetachInstanceRamRole AttachInstanceRamRole DeregisterManagedInstance PurchaseReservedInstancesOffering
NetworkInterfaceIdstring	弹性网卡 ID。展开详情示例值:eni-bp13kd656hxambfe****参考取值来源: CreateNetworkInterface DescribeNetworkInterfaces
RegionIdstring	地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。展开详情示例值:cn-hangzhou参考取值来源: DescribeRegions

返回参数

字段名称	字段详情
RequestIdstring	请求 ID。示例值:473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

返回示例

错误返回示例

错误码

没有我想要的错误码, 点击反馈

全局错误码

HTTP 状态码	错误码	错误信息	操作

400	InstanceSecurityGroupLimitExceeded	Exceeding the allowed amount of security groups that an instance can be in.	诊断
400	InvalidInstanceId.Mismatch	Specified instance and security group are not in the same VPC.	诊断
400	InvalidInstanceId.Malformed	The specified parameter "InstanceId" is not valid.	诊断
400	InvalidOperation.NotSupportEnterpriseGroup	The specified instance type doesn't support enterprise level security group.	诊断
400	InvalidOperation.MultiGroupType	The specified instance can't join different types of security group.	诊断
400	InvalidOperation.InvalidEniState	%s	诊断
400	InvalidOperation.EniAndGroupNotBelongSameUser	%s	诊断
400	NotBelongUser	%s	诊断
400	MissingParameter.RegionId	The specified RegionId should not be null.	诊断
400	InvalidStatus.EniOrInstanceIsBeingCreated	%s.	诊断
403	IncorrectInstanceStatus	The current status of the resource does not support this operation.	诊断
403	InstanceLockedForSecurity	The specified operation is denied as your instance is locked for security reasons.	诊断
403	SecurityGroupInstanceLimitExceeded	The maximum number of instances in a security group is exceeded.	诊断
403	InvalidInstanceId.AlreadyExists	The specified instance already exists in the specified security group.	诊断
403	AclLimitExceed	%s	诊断
403	InstanceSecurityGroupLimitExceeded	%s	诊断
403	InvalidOperation.NetworkInterfaceCountExceeded	The maximum number of NetworkInterface in a enterprise level security group is exceeded.	诊断
403	InvalidOperation.ResourceManagedByCloudProduct	%s	诊断
403	InvalidOperation.InvalidEniType	%s	诊断
403	InvalidOperation.VpcMismatch	%s	诊断
403	InvalidOperation.EniServiceManaged	%s	诊断
403	InvalidParam.Malformed	%s	诊断
403	InvalidParam.EniIdAndInstanceId.Conflict	%s	诊断
403	Forbidden.InstanceIsBeingCreated	The specified instance is being created.	诊断
404	InvalidSecurityGroupId.NotFound	The specified SecurityGroupId does not exist.	诊断
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	诊断
404	InvalidEniId.NotFound	%s	诊断
500	InternalError	The request processing has failed due to some unknown error.	诊断

变更历史

	变更时间	变更内容概要	操作
	2024-07-09	变更错误码400