ec2.security-groups.authorize-egressAdd an outbound rule
Request syntax
POST /ec2/api/security-groups/{id}/rules
{
"protocol": "enum",
"fromPort": "number",
"toPort": "number",
"cidrIpv4": "string",
"description": "string",
"direction": "outbound"
}Path parameters
idRequiredstring
Constraints: uuid
Request body
Fixed by this operation: direction: "outbound"
protocolRequiredenum
The IP protocol the rule matches
One of:
tcp,udp,icmpfromPortOptionalnumber
First port of the range; omitted: every port. Ignored for ICMP
Constraints: integer, 0-65535
toPortOptionalnumber
Last port of the range; omitted: fromPort alone
Constraints: integer, 0-65535
cidrIpv4Optionalstring
Where traffic may go: a CIDR block or a single address (IPv4 or IPv6); default 0.0.0.0/0
Default:
"0.0.0.0/0"descriptionOptionalstring
Free text; omitted: none
Constraints: max 255 chars
Response
201: `data` is the new rule (id, securityGroupId, direction, protocol, fromPort, toPort, cidrIpv4, description), already applied to the group’s instances.
A JSON response is wrapped as { "success": true, "data": … }; the CLI prints the whole body with --json.
Errors
- 400The request does not pass the schema above. The body is { "error": …, "issues": […] }, one issue per field.
- 401No credentials, or an access key that is unknown, revoked or expired.
- 403The caller's policies do not allow ec2:AuthorizeSecurityGroupEgress on this resource. The body names the action and the resource, and the refusal is recorded in the audit log.
- 404The resource does not exist in your organization.
Examples
The required parameters only, with example values. Replace id and the other placeholders with your own.
dcloud ec2 security-groups authorize-egress id --protocol tcpcurl -X POST "https://console.platform-development.deutschecloud.app/ec2/api/security-groups/id/rules" \
-H "Authorization: EWS-ACCESS-KEY $ACCESS_KEY" \
-H "Content-Type: application/json" \
-d '{"direction":"outbound","protocol":"tcp"}'Generated from the API description, the same one the API checks requests against and the CLI is built from. MCP tool: dcloud_ec2_security-groups_authorize-egress.