ec2.security-groups.authorize-ingress

Add an inbound rule

POST /ec2/api/security-groups/{id}/rulesIAM ec2:AuthorizeSecurityGroupIngressChanges state

Request syntax

POST /ec2/api/security-groups/{id}/rules
{
  "protocol": "enum",
  "fromPort": "number",
  "toPort": "number",
  "cidrIpv4": "string",
  "description": "string",
  "direction": "inbound"
}

Path parameters

  • idRequired

    string

    Constraints: uuid

Request body

Fixed by this operation: direction: "inbound"

  • protocolRequired

    enum

    The IP protocol the rule matches

    One of: tcp, udp, icmp

  • fromPortOptional

    number

    First port of the range; omitted: every port. Ignored for ICMP

    Constraints: integer, 0-65535

  • toPortOptional

    number

    Last port of the range; omitted: fromPort alone

    Constraints: integer, 0-65535

  • cidrIpv4Optional

    string

    Where traffic may come from: a CIDR block or a single address (IPv4 or IPv6); default 0.0.0.0/0

    Default: "0.0.0.0/0"

  • descriptionOptional

    string

    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:AuthorizeSecurityGroupIngress 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-ingress id --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-ingress.