Skip to main content

AuthorizeSecurityGroupEgress

Description

the call AuthorizeSecurityGroupEgress adds a security group exit direction rule. Specify the outbound access permission of the security group, and allow or deny instances in the security group to send outbound traffic to other devices.

Request Method

POST

Request Path

/apsara/route/Ecs/AuthorizeSecurityGroupEgress

Request Parameters Common Parameters

NameLocationTypeRequiredSample valueDescription
PolicyBODYstringNoacceptset access rights. Value range: accept: Accept access drop: deny access, do not return denial information default value: accept.
DescriptionBODYstringNoManually authorize SSH 22 port-RuleDemodescription information of security group rules. The length is 1~512 characters.
SourcePortRangeBODYstringNo80/80the port range related to the transport layer protocol open by the source security group. Value range: TCP/UDP protocol: 1~65535. Use a slash (/) to separate the start and end ports. Correct demonstration: 1/200; Error demonstration: 200/1 ICMP protocol:-1/-1 GRE protocol:-1/-1 all:-1/-1
PriorityBODYstringNo1security group rule priority. Value range: 1~100 default value: 1.
SecurityGroupIdBODYstringYessg-bp67acfmxazb4ph***source security group ID.
Ipv6SourceCidrIpBODYstringNo2001:db8:1234:1a00::***source IPv6 CIDR address segment. Supports IP address ranges in CIDR format and IPv6 format. Default value: None. Description Only VPC IP addresses are supported.
NicTypeBODYstringNointranetthe network card type of the classic network type security group rule. Value range: internet: public network card intranet: intranet network card VPC type security group rules do not need to set the network card type. The default value is intranet and can only be intranet. when setting mutual access between security groups, the DestGroupId is specified and no DestCidrIp is specified, which can only be intranet. default value: internet.
DestGroupIdBODYstringNosg-bp67acfmxazb4pi***the destination security group ID that needs to set access rights. set at least one DestGroupId or DestCidrIp parameter. if the specified DestGroupId does not specify the parameter DestCidrIp, the parameter NicType value can only be intranet. if both DestGroupId and DestCidrIp are specified, the DestCidrIp shall prevail by default.
versionBODYstringNo2016-01-01version of api
PortRangeBODYstringYes80/80the port range related to the transport layer protocol open by the destination security group. Value range: TCP/UDP protocol: the value range is 1~65535. Use a slash (/) to separate the start and end ports. Correct demonstration: 1/200; Error demonstration: 200/1 ICMP protocol:-1/-1 GRE protocol:-1/-1 all:-1/-1
DestGroupOwnerAccountBODYstringNoTest@aliyun.comWhen setting security group rules across accounts, the Alibaba Cloud account to which the destination security group belongs. if the DestGroupOwnerAccount and DestGroupOwnerId are not set, it is considered to set the access rights of your other security groups. if the parameter DestCidrIp has been set, the parameter DestGroupOwnerAccount is invalid.
regionIdBODYstringYesNo sample value for this parameter.region id
SourceCidrIpBODYstringNo10.0.0.0/8source IP address range. CIDR format and IPv4 format are supported for IP address ranges. Default value: None.
DestGroupOwnerIdBODYlongNo12345678910When setting security group rules across accounts, the ID of the Alibaba Cloud account to which the destination security group belongs. if the DestGroupOwnerId and DestGroupOwnerAccount are not set, it is considered to set the access rights of your other security groups. if you have set the parameter DestCidrIp, the parameter DestGroupOwnerId is invalid.
IpProtocolBODYstringYesalltransport layer protocol. The value is case sensitive. Value range: icmp gre tcp udp all: supports all protocols
DestCidrIpBODYstringNo10.0.0.0/8destination IP address range. CIDR format and IPv4 format are supported for IP address ranges. Default value: None.
RegionIdBODYstringYescn-qingdao-env17-d01the region ID of the source security group. You can call the DescribeRegions to view the latest Alibaba Cloud region list.
Ipv6DestCidrIpBODYstringNo2001:db8:1233:1a00::***destination IPv6 CIDR address segment. Supports IP address ranges in CIDR format and IPv6 format. Default value: None. Description Only VPC IP addresses are supported.
ClientTokenBODYstringNo123e4567-e89b-12d3-a456-426655440000Ensure request idempotence. Generate a parameter value from your client to ensure that the parameter value is unique between different requests. ClientToken only supports ASCII characters and cannot exceed 64 characters. For more details, please refer to the section on how to ensure idempotence in the cloud server ECS development guide.

Return data

NameTypeSample valueDescription
RequestIDstring1E3D5A1E0-67CA-43DA-24BC-EAF2D5A1E4DCRequest id

Example

Successful Response example

{
"RequestID":"1E3D5A1E0-67CA-43DA-24BC-EAF2D5A1E4DC"
}

Failed Response example

{
"errorSample":
{
"resultCode":-1,
"resultMsg":"system error",
"result":null
}

}