---
title: Getting Started with Datadog
description: Datadog, the leading service for cloud-scale monitoring.
breadcrumbs: Docs > Infrastructure > Datadog Resource Catalog
---

# aws_security_group{% #aws_security_group %}

## `account_id`{% #account_id %}

**Type**: `STRING`

## `description`{% #description %}

**Type**: `STRING`**Provider name**: `Description`**Description**: A description of the security group.

## `group_id`{% #group_id %}

**Type**: `STRING`**Provider name**: `GroupId`**Description**: The ID of the security group.

## `group_name`{% #group_name %}

**Type**: `STRING`**Provider name**: `GroupName`**Description**: The name of the security group.

## `ip_permissions`{% #ip_permissions %}

**Type**: `UNORDERED_LIST_STRUCT`**Provider name**: `IpPermissions`**Description**: The inbound rules associated with the security group.

- `from_port`**Type**: `INT32`**Provider name**: `FromPort`**Description**: If the protocol is TCP or UDP, this is the start of the port range. If the protocol is ICMP or ICMPv6, this is the ICMP type or -1 (all ICMP types).
- `ip_protocol`**Type**: `STRING`**Provider name**: `IpProtocol`**Description**: The IP protocol name (`tcp`, `udp`, `icmp`, `icmpv6`) or number (see [Protocol Numbers](http://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml)). Use `-1` to specify all protocols. When authorizing security group rules, specifying `-1` or a protocol number other than `tcp`, `udp`, `icmp`, or `icmpv6` allows traffic on all ports, regardless of any port range you specify. For `tcp`, `udp`, and `icmp`, you must specify a port range. For `icmpv6`, the port range is optional; if you omit the port range, traffic for all types and codes is allowed.
- `ip_ranges`**Type**: `UNORDERED_LIST_STRUCT`**Provider name**: `IpRanges`**Description**: The IPv4 address ranges.
  - `cidr_ip`**Type**: `STRING`**Provider name**: `CidrIp`**Description**: The IPv4 address range. You can either specify a CIDR block or a source security group, not both. To specify a single IPv4 address, use the /32 prefix length.
  - `description`**Type**: `STRING`**Provider name**: `Description`**Description**: A description for the security group rule that references this IPv4 address range. Constraints: Up to 255 characters in length. Allowed characters are a-z, A-Z, 0-9, spaces, and ._-:/()#,@[]+=&;{}!$*
- `ipv6_ranges`**Type**: `UNORDERED_LIST_STRUCT`**Provider name**: `Ipv6Ranges`**Description**: The IPv6 address ranges.
  - `cidr_ipv6`**Type**: `STRING`**Provider name**: `CidrIpv6`**Description**: The IPv6 address range. You can either specify a CIDR block or a source security group, not both. To specify a single IPv6 address, use the /128 prefix length.
  - `description`**Type**: `STRING`**Provider name**: `Description`**Description**: A description for the security group rule that references this IPv6 address range. Constraints: Up to 255 characters in length. Allowed characters are a-z, A-Z, 0-9, spaces, and ._-:/()#,@[]+=&;{}!$*
- `prefix_list_ids`**Type**: `UNORDERED_LIST_STRUCT`**Provider name**: `PrefixListIds`**Description**: The prefix list IDs.
  - `description`**Type**: `STRING`**Provider name**: `Description`**Description**: A description for the security group rule that references this prefix list ID. Constraints: Up to 255 characters in length. Allowed characters are a-z, A-Z, 0-9, spaces, and ._-:/()#,@[]+=;{}!$*
  - `prefix_list_id`**Type**: `STRING`**Provider name**: `PrefixListId`**Description**: The ID of the prefix.
- `to_port`**Type**: `INT32`**Provider name**: `ToPort`**Description**: If the protocol is TCP or UDP, this is the end of the port range. If the protocol is ICMP or ICMPv6, this is the ICMP code or -1 (all ICMP codes). If the start port is -1 (all ICMP types), then the end port must be -1 (all ICMP codes).
- `user_id_group_pairs`**Type**: `UNORDERED_LIST_STRUCT`**Provider name**: `UserIdGroupPairs`**Description**: The security group and Amazon Web Services account ID pairs.
  - `description`**Type**: `STRING`**Provider name**: `Description`**Description**: A description for the security group rule that references this user ID group pair. Constraints: Up to 255 characters in length. Allowed characters are a-z, A-Z, 0-9, spaces, and ._-:/()#,@[]+=;{}!$*
  - `group_id`**Type**: `STRING`**Provider name**: `GroupId`**Description**: The ID of the security group.
  - `group_name`**Type**: `STRING`**Provider name**: `GroupName`**Description**: [Default VPC] The name of the security group. For a security group in a nondefault VPC, use the security group ID. For a referenced security group in another VPC, this value is not returned if the referenced security group is deleted.
  - `peering_status`**Type**: `STRING`**Provider name**: `PeeringStatus`**Description**: The status of a VPC peering connection, if applicable.
  - `user_id`**Type**: `STRING`**Provider name**: `UserId`**Description**: The ID of an Amazon Web Services account. For a referenced security group in another VPC, the account ID of the referenced security group is returned in the response. If the referenced security group is deleted, this value is not returned.
  - `vpc_id`**Type**: `STRING`**Provider name**: `VpcId`**Description**: The ID of the VPC for the referenced security group, if applicable.
  - `vpc_peering_connection_id`**Type**: `STRING`**Provider name**: `VpcPeeringConnectionId`**Description**: The ID of the VPC peering connection, if applicable.

## `ip_permissions_egress`{% #ip_permissions_egress %}

**Type**: `UNORDERED_LIST_STRUCT`**Provider name**: `IpPermissionsEgress`**Description**: The outbound rules associated with the security group.

- `from_port`**Type**: `INT32`**Provider name**: `FromPort`**Description**: If the protocol is TCP or UDP, this is the start of the port range. If the protocol is ICMP or ICMPv6, this is the ICMP type or -1 (all ICMP types).
- `ip_protocol`**Type**: `STRING`**Provider name**: `IpProtocol`**Description**: The IP protocol name (`tcp`, `udp`, `icmp`, `icmpv6`) or number (see [Protocol Numbers](http://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml)). Use `-1` to specify all protocols. When authorizing security group rules, specifying `-1` or a protocol number other than `tcp`, `udp`, `icmp`, or `icmpv6` allows traffic on all ports, regardless of any port range you specify. For `tcp`, `udp`, and `icmp`, you must specify a port range. For `icmpv6`, the port range is optional; if you omit the port range, traffic for all types and codes is allowed.
- `ip_ranges`**Type**: `UNORDERED_LIST_STRUCT`**Provider name**: `IpRanges`**Description**: The IPv4 address ranges.
  - `cidr_ip`**Type**: `STRING`**Provider name**: `CidrIp`**Description**: The IPv4 address range. You can either specify a CIDR block or a source security group, not both. To specify a single IPv4 address, use the /32 prefix length.
  - `description`**Type**: `STRING`**Provider name**: `Description`**Description**: A description for the security group rule that references this IPv4 address range. Constraints: Up to 255 characters in length. Allowed characters are a-z, A-Z, 0-9, spaces, and ._-:/()#,@[]+=&;{}!$*
- `ipv6_ranges`**Type**: `UNORDERED_LIST_STRUCT`**Provider name**: `Ipv6Ranges`**Description**: The IPv6 address ranges.
  - `cidr_ipv6`**Type**: `STRING`**Provider name**: `CidrIpv6`**Description**: The IPv6 address range. You can either specify a CIDR block or a source security group, not both. To specify a single IPv6 address, use the /128 prefix length.
  - `description`**Type**: `STRING`**Provider name**: `Description`**Description**: A description for the security group rule that references this IPv6 address range. Constraints: Up to 255 characters in length. Allowed characters are a-z, A-Z, 0-9, spaces, and ._-:/()#,@[]+=&;{}!$*
- `prefix_list_ids`**Type**: `UNORDERED_LIST_STRUCT`**Provider name**: `PrefixListIds`**Description**: The prefix list IDs.
  - `description`**Type**: `STRING`**Provider name**: `Description`**Description**: A description for the security group rule that references this prefix list ID. Constraints: Up to 255 characters in length. Allowed characters are a-z, A-Z, 0-9, spaces, and ._-:/()#,@[]+=;{}!$*
  - `prefix_list_id`**Type**: `STRING`**Provider name**: `PrefixListId`**Description**: The ID of the prefix.
- `to_port`**Type**: `INT32`**Provider name**: `ToPort`**Description**: If the protocol is TCP or UDP, this is the end of the port range. If the protocol is ICMP or ICMPv6, this is the ICMP code or -1 (all ICMP codes). If the start port is -1 (all ICMP types), then the end port must be -1 (all ICMP codes).
- `user_id_group_pairs`**Type**: `UNORDERED_LIST_STRUCT`**Provider name**: `UserIdGroupPairs`**Description**: The security group and Amazon Web Services account ID pairs.
  - `description`**Type**: `STRING`**Provider name**: `Description`**Description**: A description for the security group rule that references this user ID group pair. Constraints: Up to 255 characters in length. Allowed characters are a-z, A-Z, 0-9, spaces, and ._-:/()#,@[]+=;{}!$*
  - `group_id`**Type**: `STRING`**Provider name**: `GroupId`**Description**: The ID of the security group.
  - `group_name`**Type**: `STRING`**Provider name**: `GroupName`**Description**: [Default VPC] The name of the security group. For a security group in a nondefault VPC, use the security group ID. For a referenced security group in another VPC, this value is not returned if the referenced security group is deleted.
  - `peering_status`**Type**: `STRING`**Provider name**: `PeeringStatus`**Description**: The status of a VPC peering connection, if applicable.
  - `user_id`**Type**: `STRING`**Provider name**: `UserId`**Description**: The ID of an Amazon Web Services account. For a referenced security group in another VPC, the account ID of the referenced security group is returned in the response. If the referenced security group is deleted, this value is not returned.
  - `vpc_id`**Type**: `STRING`**Provider name**: `VpcId`**Description**: The ID of the VPC for the referenced security group, if applicable.
  - `vpc_peering_connection_id`**Type**: `STRING`**Provider name**: `VpcPeeringConnectionId`**Description**: The ID of the VPC peering connection, if applicable.

## `owner_id`{% #owner_id %}

**Type**: `STRING`**Provider name**: `OwnerId`**Description**: The Amazon Web Services account ID of the owner of the security group.

## `security_group_arn`{% #security_group_arn %}

**Type**: `STRING`

## `tags`{% #tags %}

**Type**: `UNORDERED_LIST_STRING`

## `vpc_id`{% #vpc_id %}

**Type**: `STRING`**Provider name**: `VpcId`**Description**: The ID of the VPC for the security group.