阿里云如何使用將實例加入安全組接口
來源:技術員聯盟┆發布時間:2017-12-11 12:38┆點擊:
將實例加入安全組
描述
將實例加入到指定的安全組。
只有在實例狀態為 Stopped 或 Running 狀態下才可以執行該操作。
每個實例最多屬于 5 個安全組
每個安全組最多擁有個 1000 個實例
請求參數
名稱
類型
是否必須
描述
Action
String
是
系統規定參數,取值:JoinSecurityGroup
InstanceId
String
是
指定的實例 ID
SecurityGroupId
String
是
安全組代碼
返回參數
全是公共返回參數,詳見公共返回參數
錯誤碼
錯誤代碼
描述
Http 狀態碼
語義
InvalidInstanceId.NotFound
The InstanceId provided does not exist in our records.
404
指定的 InstanceId 不存在
MissingParameter
The input parameter "InstanceId" that is mandatory for processing this request is not supplied.
400
缺少 InstanceId 值
InvalidSecurityGroupId.NotFound
The SecurityGroupId provided does not exist in our records.
404
指定的 SecurityGroupId 不存在
MissingParameter
The input parameter "SecurityGroupId" that is mandatory for processing this request is not supplied.
400
缺少 SecurityGroupId 值
InstanceSecurityGroupLimitExceeded
Exceeding the allowed amount of security groups that an instance can be in.
400
實例加入的安全組數量達到上限
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
Exceeding the allowed amount of instances of a security group.
403
該 SecurityGroup 內的 Instance 數量已經達到上限
InvalidInstanceId.Mismatch
Specified instance and security group are not in the same VPC.
403
指定的實例和安全組不屬于同一個虛擬專有網絡
(包含另外兩種特殊情況:
實例不屬于 VPC 類型的,安全組屬于 VPC 類型
實例屬于 VPC 類型,安全組不屬于 VPC 類型
)
InvalidInstanceId.AlreadyExists
The specified instance is already in the specified security group.
403
指定的實例已經在指定的安全組中
示例
請求示例
https://ecs.aliyuncs.com/?Action=JoinSecurityGroup
&InstanceId= i-instance1
&SecurityGroupId=F876FF7BA984
&<公共請求參數>
返回示例
XML格式
473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
JSON格式
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"