fog--fog/lib/fog/aws/requests/ec2/describe_security_groups.rb

module Fog
  module AWS
    class EC2

      # Describe all or specified security groups
      #
      # ==== Parameters
      # * group_name<~Array> - List of groups to describe, defaults to all
      #
      # === Returns
      # * response<~Fog::AWS::Response>:
      #   * body<~Hash>:
      #     * 'requestId'<~String> - Id of request
      #     * 'securityGroupInfo'<~Array>:
      #       * 'groupDescription'<~String> - Description of security group
      #       * 'groupName'<~String> - Name of security group
      #       * 'ipPermissions'<~Array>:
      #         * 'fromPort'<~Integer> - Start of port range (or -1 for ICMP wildcard)
      #         * 'groups'<~Array>:
      #           * 'groupName'<~String> - Name of security group
      #           * 'userId'<~String> - AWS User Id of account
      #         * 'ipProtocol'<~String> - Ip protocol, must be in ['tcp', 'udp', 'icmp']
      #         * 'ipRanges'<~Array>:
      #           * 'cidrIp'<~String> - CIDR range
      #         * 'toPort'<~Integer> - End of port range (or -1 for ICMP wildcard)
      #       * 'ownerId'<~String> - AWS Access Key Id of the owner of the security group
      def describe_security_groups(group_name = [])
        params = indexed_params('GroupName', group_name)
        request({
          'Action' => 'DescribeSecurityGroups',
        }.merge!(params), Fog::Parsers::AWS::EC2::DescribeSecurityGroups.new)
      end

    end
  end
end