接口说明

安全组的API文档中，流量的发起端为源端（Source），数据传输的接收端为目的端（Dest）。

调用该接口时，您需要了解：

• 出方向和入方向安全组规则总和不能超过200条。
• 安全组规则优先级（Priority）可选范围为1~100。数字越小，代表优先级越高。
• 优先级相同的安全组规则，以拒绝访问（drop）的规则优先。
• 源端设备可以是指定的IP地址范围（SourceCidrIp、Ipv6SourceCidrIp、SourcePrefixListId），也可以是其他安全组（SourceGroupId）中的ECS实例。
• 如果匹配的安全组规则已存在，此次AuthorizeSecurityGroup调用成功，但不会增加规则数。
• 以下任意一组参数可以确定一条安全组规则，只指定一个参数无法确定一条安全组规则。
  • 设置指定IP地址段的访问权限。此时，经典网络类型安全组的网卡类型（NicType）可设置公网（internet）和内网（intranet）。VPC类型安全组的网卡类型（NicType）只可设置内网（intranet）。如以下请求示例：IpProtocol、PortRange、（可选）SourcePortRange、NicType、Policy和SourceCidrIp。

    https://ecs.aliyuncs.com/?Action=AuthorizeSecurityGroup
            &SecurityGroupId=sg-F876FF7**
            &SourceCidrIp=10.0.0.0/8
            &IpProtocol=tcp
            &PortRange=22/22
            &NicType=intranet
            &Policy=accept
            &<公共请求参数>

  • 设置其他安全组的访问权限。此时，网卡类型（NicType）只能为内网（intranet）。经典网络类型安全组之间互访时，可以设置同一地域中其他安全组对您的安全组的访问权限。这个安全组可以是您的也可以是其他阿里云账户（SourceGroupOwnerAccount）的。VPC类型安全组之间互访时，可以设置同一VPC内其他安全组访问该安全组的访问权限。如以下请求示例：IpProtocol、PortRange、（可选）SourcePortRange、NicType、Policy、SourceGroupOwnerAccount和SourceGroupId。

    https://ecs.aliyuncs.com/?Action=AuthorizeSecurityGroup
            &SecurityGroupId=sg-F876FF7**
            &SourceGroupId=sg-1651FBB**
            &SourceGroupOwnerAccount=test@aliyun.com
            &IpProtocol=tcp
            &PortRange=22/22
            &NicType=intranet
            &Policy=drop
            &<公共请求参数>

  • 在安全组规则中关联前缀列表。此时，前缀列表仅支持网络类型为VPC的安全组，网卡类型（NicType）只可设置为内网（intranet）。如以下请求示例：IpProtocol、PortRange、（可选）SourcePortRange、NicType、Policy和SourcePrefixListId。

    https://ecs.aliyuncs.com/?Action=AuthorizeSecurityGroup
            &SecurityGroupId=sg-F876FF7**
            &SourcePrefixListId=pl-x1j1k5ykzqlixdcy****
            &SourceGroupOwnerAccount=test@aliyun.com
            &IpProtocol=tcp
            &PortRange=22/22
            &NicType=intranet
            &Policy=drop
            &<公共请求参数>

• 更多关于安全组规则的设置示例，请参见应用案例和安全组五元组规则介绍。

请求参数

返回数据

示例

请求示例

https://ecs.aliyuncs.com/?Action=AuthorizeSecurityGroup
&SecurityGroupId=sg-bp67acfmxazb4p****
&SourceCidrIp=10.0.0.0/8
&IpProtocol=tcp
&PortRange=22/22
&NicType=intranet
&Policy=accept
&<公共请求参数>

正常返回示例

XML格式

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

JSON格式

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

错误码

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