DataResource (AWS SDK for Java

java.lang.Object
- com.amazonaws.services.cloudtrail.model.DataResource

All Implemented Interfaces:

StructuredPojo, Serializable, Cloneable
```
@Generated(value="com.amazonaws:aws-java-sdk-code-generator")
public class DataResource
extends Object
implements Serializable, Cloneable, StructuredPojo
```
The Amazon S3 objects that you specify in your event selectors for your trail to log data events. Data events are object-level API operations that access S3 objects, such as GetObject, DeleteObject, and PutObject. You can specify up to 250 S3 buckets and object prefixes for a trail.

Example
1. You create an event selector for a trail and specify an S3 bucket and an empty prefix, such as arn:aws:s3:::bucket-1/.
2. You upload an image file to bucket-1.
3. The PutObject API operation occurs on an object in the S3 bucket that you specified in the event selector. The trail processes and logs the event.
4. You upload another image file to a different S3 bucket named arn:aws:s3:::bucket-2.
5. The event occurs on an object in an S3 bucket that you didn't specify in the event selector. The trail doesn’t log the event.
See Also:

AWS API Documentation, Serialized Form

Constructor Summary

Constructors
Constructor and Description

DataResource()

Constructors
Constructor and Description
`DataResource()`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`DataResource`	`clone()`
`boolean`	`equals(Object obj)`
`String`	`getType()` The resource type in which you want to log data events.
`List<String>`	`getValues()` A list of ARN-like strings for the specified S3 objects.
`int`	`hashCode()`
`void`	`marshall(ProtocolMarshaller protocolMarshaller)` Marshalls this structured data using the given `ProtocolMarshaller`.
`void`	`setType(String type)` The resource type in which you want to log data events.
`void`	`setValues(Collection<String> values)` A list of ARN-like strings for the specified S3 objects.
`String`	`toString()` Returns a string representation of this object; useful for testing and debugging.
`DataResource`	`withType(String type)` The resource type in which you want to log data events.
`DataResource`	`withValues(Collection<String> values)` A list of ARN-like strings for the specified S3 objects.
`DataResource`	`withValues(String... values)` A list of ARN-like strings for the specified S3 objects.

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

- Constructor Detail
  - DataResource
```
public DataResource()
```
- Method Detail
  - setType
```
public void setType(String type)
```
    The resource type in which you want to log data events. You can specify only the following value: AWS::S3::Object.
    
    Parameters:
    
    type - The resource type in which you want to log data events. You can specify only the following value: AWS::S3::Object.
  - getType
```
public String getType()
```
    The resource type in which you want to log data events. You can specify only the following value: AWS::S3::Object.
    
    Returns:
    
    The resource type in which you want to log data events. You can specify only the following value: AWS::S3::Object.
  - withType
```
public DataResource withType(String type)
```
    The resource type in which you want to log data events. You can specify only the following value: AWS::S3::Object.
    
    Parameters:
    
    type - The resource type in which you want to log data events. You can specify only the following value: AWS::S3::Object.
    
    Returns:
    
    Returns a reference to this object so that method calls can be chained together.
  - getValues
```
public List<String> getValues()
```
    A list of ARN-like strings for the specified S3 objects.
    
    To log data events for all objects in an S3 bucket, specify the bucket and an empty object prefix such as arn:aws:s3:::bucket-1/. The trail logs data events for all objects in this S3 bucket.
    
    To log data events for specific objects, specify the S3 bucket and object prefix such as arn:aws:s3:::bucket-1/example-images. The trail logs data events for objects in this S3 bucket that match the prefix.
    
    Returns:
    
    A list of ARN-like strings for the specified S3 objects.
    
    To log data events for all objects in an S3 bucket, specify the bucket and an empty object prefix such as arn:aws:s3:::bucket-1/. The trail logs data events for all objects in this S3 bucket.
    
    To log data events for specific objects, specify the S3 bucket and object prefix such as arn:aws:s3:::bucket-1/example-images. The trail logs data events for objects in this S3 bucket that match the prefix.
  - setValues
```
public void setValues(Collection<String> values)
```
    A list of ARN-like strings for the specified S3 objects.
    
    To log data events for all objects in an S3 bucket, specify the bucket and an empty object prefix such as arn:aws:s3:::bucket-1/. The trail logs data events for all objects in this S3 bucket.
    
    To log data events for specific objects, specify the S3 bucket and object prefix such as arn:aws:s3:::bucket-1/example-images. The trail logs data events for objects in this S3 bucket that match the prefix.
    
    Parameters:
    
    values - A list of ARN-like strings for the specified S3 objects.
    
    To log data events for all objects in an S3 bucket, specify the bucket and an empty object prefix such as arn:aws:s3:::bucket-1/. The trail logs data events for all objects in this S3 bucket.
    
    To log data events for specific objects, specify the S3 bucket and object prefix such as arn:aws:s3:::bucket-1/example-images. The trail logs data events for objects in this S3 bucket that match the prefix.
  - withValues
```
public DataResource withValues(String... values)
```
    A list of ARN-like strings for the specified S3 objects.
    
    To log data events for all objects in an S3 bucket, specify the bucket and an empty object prefix such as arn:aws:s3:::bucket-1/. The trail logs data events for all objects in this S3 bucket.
    
    To log data events for specific objects, specify the S3 bucket and object prefix such as arn:aws:s3:::bucket-1/example-images. The trail logs data events for objects in this S3 bucket that match the prefix.
    
    NOTE: This method appends the values to the existing list (if any). Use setValues(java.util.Collection) or withValues(java.util.Collection) if you want to override the existing values.
    
    Parameters:
    
    values - A list of ARN-like strings for the specified S3 objects.
    
    To log data events for all objects in an S3 bucket, specify the bucket and an empty object prefix such as arn:aws:s3:::bucket-1/. The trail logs data events for all objects in this S3 bucket.
    
    To log data events for specific objects, specify the S3 bucket and object prefix such as arn:aws:s3:::bucket-1/example-images. The trail logs data events for objects in this S3 bucket that match the prefix.
    
    Returns:
    
    Returns a reference to this object so that method calls can be chained together.
  - withValues
```
public DataResource withValues(Collection<String> values)
```
    A list of ARN-like strings for the specified S3 objects.
    
    To log data events for all objects in an S3 bucket, specify the bucket and an empty object prefix such as arn:aws:s3:::bucket-1/. The trail logs data events for all objects in this S3 bucket.
    
    To log data events for specific objects, specify the S3 bucket and object prefix such as arn:aws:s3:::bucket-1/example-images. The trail logs data events for objects in this S3 bucket that match the prefix.
    
    Parameters:
    
    values - A list of ARN-like strings for the specified S3 objects.
    
    To log data events for all objects in an S3 bucket, specify the bucket and an empty object prefix such as arn:aws:s3:::bucket-1/. The trail logs data events for all objects in this S3 bucket.
    
    To log data events for specific objects, specify the S3 bucket and object prefix such as arn:aws:s3:::bucket-1/example-images. The trail logs data events for objects in this S3 bucket that match the prefix.
    
    Returns:
    
    Returns a reference to this object so that method calls can be chained together.
  - toString
```
public String toString()
```
    Returns a string representation of this object; useful for testing and debugging.
    
    Overrides:
    
    toString in class Object
    
    Returns:
    
    A string representation of this object.
    
    See Also:
    
    Object.toString()
  - equals
```
public boolean equals(Object obj)
```
    Overrides:
    
    equals in class Object
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class Object
  - clone
```
public DataResource clone()
```
    Overrides:
    
    clone in class Object
  - marshall
```
public void marshall(ProtocolMarshaller protocolMarshaller)
```
    Description copied from interface: StructuredPojo
    
    Marshalls this structured data using the given ProtocolMarshaller.
    
    Specified by:
    
    marshall in interface StructuredPojo
    
    Parameters:
    
    protocolMarshaller - Implementation of ProtocolMarshaller used to marshall this object's data.

Did this page help you?

Class DataResource

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

DataResource

Method Detail

setType

getType

withType

getValues

setValues

withValues

withValues

toString

equals

hashCode

clone

marshall