將一台執行個體加入到指定的安全性群組。

描述

調用該介面時，您需要注意：

  • 加入安全性群組之前，執行個體必須處於 已停止（Stopped）或者 運行中（Running）狀態。

  • 一台執行個體最多可以加入 5 個安全性群組。您可以 申請 將執行個體加入更多安全性群組，最多不能超過 16 個安全性群組。

  • 每個安全性群組最多能管理 1000 台執行個體。

  • 您的安全性群組和執行個體必須屬於同一個阿里雲地域。

  • 您的安全性群組和執行個體的網路類型必須相同。如果網路類型為 專有網路 VPC，則安全性群組和執行個體必須屬於同一個 VPC。

請求參數

名稱 類型 是否必需 描述
Action String 是 系統規定參數。取值：JoinSecurityGroup
InstanceId String 是 執行個體 ID。您可以調用 DescribeRegions 查看最新的阿里雲地域列表。
SecurityGroupId String 是 安全性群組 ID。您可以調用 DescribeSecurityGroups 查看您可用的安全性群組。

返回參數

全是公共返回參數。參閱 公共返回參數。

樣本

請求樣本 
https://ecs.aliyuncs.com/?Action=JoinSecurityGroup
&InstanceId= i-instance1
&SecurityGroupId=F876FF7BA984
&<公共請求參數>
返回樣本

XML 格式

<JoinSecurityGroupResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</JoinSecurityGroupResponse>
JSON 格式 
{
    "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

錯誤碼

以下為本介面特有的錯誤碼。更多錯誤碼，請訪問 API 錯誤中心 。

錯誤碼 錯誤資訊 HTTP 狀態碼 說明
InvalidInstanceId.Mismatch Specified instance and security group are not in the same VPC. 400 指定的執行個體和安全性群組必須屬於同一個 VPC。
InstanceSecurityGroupLimitExceeded Exceeding the allowed amount of security groups that an instance can be in. 400 一台執行個體最多可以加入 5 個安全性群組。
MissingParameter The input parameter “InstanceId” that is mandatory for processing this request is not supplied. 400 您必須填入 InstanceId 參數。
MissingParameter The input parameter “SecurityGroupId” that is mandatory for processing this request is not supplied. 400 您必須填入 SecurityGroupId 參數。
IncorrectInstanceStatus The current status of the resource does not support this operation. 403 加入安全性群組之前，執行個體必須處於 已停止（Stopped）或者 運行中（Running）狀態。
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 每個安全性群組最多能管理 1000 台執行個體。
InvalidInstanceId.AlreadyExists The specified instance already exists in the specified security group. 403 指定的執行個體已經在指定的安全性群組中。
OperationDenied The specified operation is denied as your instance is locked for security reasons. 403 該資源目前被 安全控制，拒絕操作。
InvalidInstanceId.NotFound The specified InstanceId does not exist. 404 指定的 InstanceId不存在。
InvalidSecurityGroupId.NotFound The specified SecurityGroupId does not exist. 404 指定的 SecurityGroupId 不存在。