You are viewing documentation for version 3 of the AWS SDK for Ruby. Version 2 documentation can be found here.

Class: Aws::CloudWatchLogs::Types::DescribeLogStreamsRequest

Inherits:
Struct
  • Object
show all
Defined in:
gems/aws-sdk-cloudwatchlogs/lib/aws-sdk-cloudwatchlogs/types.rb

Overview

Note:

When making an API call, you may pass DescribeLogStreamsRequest data as a hash:

{
  log_group_name: "LogGroupName", # required
  log_stream_name_prefix: "LogStreamName",
  order_by: "LogStreamName", # accepts LogStreamName, LastEventTime
  descending: false,
  next_token: "NextToken",
  limit: 1,
}

Instance Attribute Summary collapse

Instance Attribute Details

#descendingBoolean

If the value is true, results are returned in descending order. If the value is to false, results are returned in ascending order. The default value is false.

Returns:

  • (Boolean)


549
550
551
552
553
554
555
556
557
# File 'gems/aws-sdk-cloudwatchlogs/lib/aws-sdk-cloudwatchlogs/types.rb', line 549

class DescribeLogStreamsRequest < Struct.new(
  :log_group_name,
  :log_stream_name_prefix,
  :order_by,
  :descending,
  :next_token,
  :limit)
  include Aws::Structure
end

#limitInteger

The maximum number of items returned. If you don't specify a value, the default is up to 50 items.

Returns:

  • (Integer)


549
550
551
552
553
554
555
556
557
# File 'gems/aws-sdk-cloudwatchlogs/lib/aws-sdk-cloudwatchlogs/types.rb', line 549

class DescribeLogStreamsRequest < Struct.new(
  :log_group_name,
  :log_stream_name_prefix,
  :order_by,
  :descending,
  :next_token,
  :limit)
  include Aws::Structure
end

#log_group_nameString

The name of the log group.

Returns:

  • (String)


549
550
551
552
553
554
555
556
557
# File 'gems/aws-sdk-cloudwatchlogs/lib/aws-sdk-cloudwatchlogs/types.rb', line 549

class DescribeLogStreamsRequest < Struct.new(
  :log_group_name,
  :log_stream_name_prefix,
  :order_by,
  :descending,
  :next_token,
  :limit)
  include Aws::Structure
end

#log_stream_name_prefixString

The prefix to match.

iIf orderBy is LastEventTime,you cannot specify this parameter.

Returns:

  • (String)


549
550
551
552
553
554
555
556
557
# File 'gems/aws-sdk-cloudwatchlogs/lib/aws-sdk-cloudwatchlogs/types.rb', line 549

class DescribeLogStreamsRequest < Struct.new(
  :log_group_name,
  :log_stream_name_prefix,
  :order_by,
  :descending,
  :next_token,
  :limit)
  include Aws::Structure
end

#next_tokenString

The token for the next set of items to return. (You received this token from a previous call.)

Returns:

  • (String)


549
550
551
552
553
554
555
556
557
# File 'gems/aws-sdk-cloudwatchlogs/lib/aws-sdk-cloudwatchlogs/types.rb', line 549

class DescribeLogStreamsRequest < Struct.new(
  :log_group_name,
  :log_stream_name_prefix,
  :order_by,
  :descending,
  :next_token,
  :limit)
  include Aws::Structure
end

#order_byString

If the value is LogStreamName, the results are ordered by log stream name. If the value is LastEventTime, the results are ordered by the event time. The default value is LogStreamName.

If you order the results by event time, you cannot specify the logStreamNamePrefix parameter.

lastEventTimestamp represents the time of the most recent log event in the log stream in CloudWatch Logs. This number is expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC. lastEventTimeStamp updates on an eventual consistency basis. It typically updates in less than an hour from ingestion, but may take longer in some rare situations.

Returns:

  • (String)


549
550
551
552
553
554
555
556
557
# File 'gems/aws-sdk-cloudwatchlogs/lib/aws-sdk-cloudwatchlogs/types.rb', line 549

class DescribeLogStreamsRequest < Struct.new(
  :log_group_name,
  :log_stream_name_prefix,
  :order_by,
  :descending,
  :next_token,
  :limit)
  include Aws::Structure
end