PutLogEventsRequest (AWS SDK for Android

java.lang.Object
- com.amazonaws.AmazonWebServiceRequest
- - com.amazonaws.services.logs.model.PutLogEventsRequest

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable
```
public class PutLogEventsRequest
extends AmazonWebServiceRequest
implements java.io.Serializable
```
Uploads a batch of log events to the specified log stream.

You must include the sequence token obtained from the response of the previous call. An upload in a newly created log stream does not require a sequence token. You can also get the sequence token using DescribeLogStreams. If you call PutLogEvents twice within a narrow time period using the same value for sequenceToken, both calls may be successful, or one may be rejected.

The batch of events must satisfy the following constraints:
- The maximum batch size is 1,048,576 bytes, and this size is calculated as the sum of all event messages in UTF-8, plus 26 bytes for each log event.
- None of the log events in the batch can be more than 2 hours in the future.
- None of the log events in the batch can be older than 14 days or the retention period of the log group.
- The log events in the batch must be in chronological ordered by their time stamp. The time stamp is the time the event occurred, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC. (In AWS Tools for PowerShell and the AWS SDK for .NET, the timestamp is specified in .NET format: yyyy-mm-ddThh:mm:ss. For example, 2017-09-15T13:45:30.)
- The maximum number of log events in a batch is 10,000.
- A batch of log events in a single request cannot span more than 24 hours. Otherwise, the operation fails.
If a call to PutLogEvents returns "UnrecognizedClientException" the most likely cause is an invalid AWS access key ID or secret key.
See Also:

Serialized Form

Constructor Summary

Constructors
Constructor and Description
`PutLogEventsRequest()` Default constructor for PutLogEventsRequest object.
`PutLogEventsRequest(java.lang.String logGroupName, java.lang.String logStreamName, java.util.List<InputLogEvent> logEvents)` Constructs a new PutLogEventsRequest object.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`boolean`	`equals(java.lang.Object obj)`
`java.util.List<InputLogEvent>`	`getLogEvents()` The log events.
`java.lang.String`	`getLogGroupName()` The name of the log group.
`java.lang.String`	`getLogStreamName()` The name of the log stream.
`java.lang.String`	`getSequenceToken()` The sequence token obtained from the response of the previous `PutLogEvents` call.
`int`	`hashCode()`
`void`	`setLogEvents(java.util.Collection<InputLogEvent> logEvents)` The log events.
`void`	`setLogGroupName(java.lang.String logGroupName)` The name of the log group.
`void`	`setLogStreamName(java.lang.String logStreamName)` The name of the log stream.
`void`	`setSequenceToken(java.lang.String sequenceToken)` The sequence token obtained from the response of the previous `PutLogEvents` call.
`java.lang.String`	`toString()` Returns a string representation of this object; useful for testing and debugging.
`PutLogEventsRequest`	`withLogEvents(java.util.Collection<InputLogEvent> logEvents)` The log events.
`PutLogEventsRequest`	`withLogEvents(InputLogEvent... logEvents)` The log events.
`PutLogEventsRequest`	`withLogGroupName(java.lang.String logGroupName)` The name of the log group.
`PutLogEventsRequest`	`withLogStreamName(java.lang.String logStreamName)` The name of the log stream.
`PutLogEventsRequest`	`withSequenceToken(java.lang.String sequenceToken)` The sequence token obtained from the response of the previous `PutLogEvents` call.

Methods inherited from class com.amazonaws.AmazonWebServiceRequest
clone, getCloneRoot, getCloneSource, getGeneralProgressListener, getRequestClientOptions, getRequestCredentials, getRequestMetricCollector, setGeneralProgressListener, setRequestCredentials, setRequestMetricCollector, withGeneralProgressListener, withRequestMetricCollector

Methods inherited from class java.lang.Object
getClass, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - PutLogEventsRequest
```
public PutLogEventsRequest()
```
    Default constructor for PutLogEventsRequest object. Callers should use the setter or fluent setter (with...) methods to initialize any additional object members.
  - PutLogEventsRequest
```
public PutLogEventsRequest(java.lang.String logGroupName,
                           java.lang.String logStreamName,
                           java.util.List<InputLogEvent> logEvents)
```
    Constructs a new PutLogEventsRequest object. Callers should use the setter or fluent setter (with...) methods to initialize any additional object members.
    
    Parameters:
    
    logGroupName -
    The name of the log group.
    
    logStreamName -
    The name of the log stream.
    
    logEvents -
    The log events.
- Method Detail
  - getLogGroupName
```
public java.lang.String getLogGroupName()
```
    The name of the log group.
    
    Constraints:
    Length: 1 - 512
    Pattern: [\.\-_/#A-Za-z0-9]+
    
    Returns:
    
    The name of the log group.
  - setLogGroupName
```
public void setLogGroupName(java.lang.String logGroupName)
```
    The name of the log group.
    
    Constraints:
    Length: 1 - 512
    Pattern: [\.\-_/#A-Za-z0-9]+
    
    Parameters:
    
    logGroupName -
    The name of the log group.
  - withLogGroupName
```
public PutLogEventsRequest withLogGroupName(java.lang.String logGroupName)
```
    The name of the log group.
    
    Returns a reference to this object so that method calls can be chained together.
    Constraints:
    Length: 1 - 512
    Pattern: [\.\-_/#A-Za-z0-9]+
    
    Parameters:
    
    logGroupName -
    The name of the log group.
    
    Returns:
    
    A reference to this updated object so that method calls can be chained together.
  - getLogStreamName
```
public java.lang.String getLogStreamName()
```
    The name of the log stream.
    
    Constraints:
    Length: 1 - 512
    Pattern: [^:*]*
    
    Returns:
    
    The name of the log stream.
  - setLogStreamName
```
public void setLogStreamName(java.lang.String logStreamName)
```
    The name of the log stream.
    
    Constraints:
    Length: 1 - 512
    Pattern: [^:*]*
    
    Parameters:
    
    logStreamName -
    The name of the log stream.
  - withLogStreamName
```
public PutLogEventsRequest withLogStreamName(java.lang.String logStreamName)
```
    The name of the log stream.
    
    Returns a reference to this object so that method calls can be chained together.
    Constraints:
    Length: 1 - 512
    Pattern: [^:*]*
    
    Parameters:
    
    logStreamName -
    The name of the log stream.
    
    Returns:
    
    A reference to this updated object so that method calls can be chained together.
  - getLogEvents
```
public java.util.List<InputLogEvent> getLogEvents()
```
    The log events.
    
    Returns:
    
    The log events.
  - setLogEvents
```
public void setLogEvents(java.util.Collection<InputLogEvent> logEvents)
```
    The log events.
    
    Parameters:
    
    logEvents -
    The log events.
  - withLogEvents
```
public PutLogEventsRequest withLogEvents(InputLogEvent... logEvents)
```
    The log events.
    
    Returns a reference to this object so that method calls can be chained together.
    
    Parameters:
    
    logEvents -
    The log events.
    
    Returns:
    
    A reference to this updated object so that method calls can be chained together.
  - withLogEvents
```
public PutLogEventsRequest withLogEvents(java.util.Collection<InputLogEvent> logEvents)
```
    The log events.
    
    Returns a reference to this object so that method calls can be chained together.
    
    Parameters:
    
    logEvents -
    The log events.
    
    Returns:
    
    A reference to this updated object so that method calls can be chained together.
  - getSequenceToken
```
public java.lang.String getSequenceToken()
```
    The sequence token obtained from the response of the previous PutLogEvents call. An upload in a newly created log stream does not require a sequence token. You can also get the sequence token using DescribeLogStreams. If you call PutLogEvents twice within a narrow time period using the same value for sequenceToken, both calls may be successful, or one may be rejected.
    
    Constraints:
    Length: 1 -
    
    Returns:
    
    The sequence token obtained from the response of the previous PutLogEvents call. An upload in a newly created log stream does not require a sequence token. You can also get the sequence token using DescribeLogStreams. If you call PutLogEvents twice within a narrow time period using the same value for sequenceToken, both calls may be successful, or one may be rejected.
  - setSequenceToken
```
public void setSequenceToken(java.lang.String sequenceToken)
```
    The sequence token obtained from the response of the previous PutLogEvents call. An upload in a newly created log stream does not require a sequence token. You can also get the sequence token using DescribeLogStreams. If you call PutLogEvents twice within a narrow time period using the same value for sequenceToken, both calls may be successful, or one may be rejected.
    
    Constraints:
    Length: 1 -
    
    Parameters:
    
    sequenceToken -
    The sequence token obtained from the response of the previous PutLogEvents call. An upload in a newly created log stream does not require a sequence token. You can also get the sequence token using DescribeLogStreams. If you call PutLogEvents twice within a narrow time period using the same value for sequenceToken, both calls may be successful, or one may be rejected.
  - withSequenceToken
```
public PutLogEventsRequest withSequenceToken(java.lang.String sequenceToken)
```
    The sequence token obtained from the response of the previous PutLogEvents call. An upload in a newly created log stream does not require a sequence token. You can also get the sequence token using DescribeLogStreams. If you call PutLogEvents twice within a narrow time period using the same value for sequenceToken, both calls may be successful, or one may be rejected.
    
    Returns a reference to this object so that method calls can be chained together.
    Constraints:
    Length: 1 -
    
    Parameters:
    
    sequenceToken -
    The sequence token obtained from the response of the previous PutLogEvents call. An upload in a newly created log stream does not require a sequence token. You can also get the sequence token using DescribeLogStreams. If you call PutLogEvents twice within a narrow time period using the same value for sequenceToken, both calls may be successful, or one may be rejected.
    
    Returns:
    
    A reference to this updated object so that method calls can be chained together.
  - toString
```
public java.lang.String toString()
```
    Returns a string representation of this object; useful for testing and debugging.
    
    Overrides:
    
    toString in class java.lang.Object
    
    Returns:
    
    A string representation of this object.
    
    See Also:
    
    Object.toString()
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class java.lang.Object
  - equals
```
public boolean equals(java.lang.Object obj)
```
    Overrides:
    
    equals in class java.lang.Object

Class PutLogEventsRequest

Constructor Summary

Method Summary

Methods inherited from class com.amazonaws.AmazonWebServiceRequest

Methods inherited from class java.lang.Object

Constructor Detail

PutLogEventsRequest

PutLogEventsRequest

Method Detail

getLogGroupName

setLogGroupName

withLogGroupName

getLogStreamName

setLogStreamName

withLogStreamName

getLogEvents

setLogEvents

withLogEvents

withLogEvents

getSequenceToken

setSequenceToken

withSequenceToken

toString

hashCode

equals