Struct S3DestinationConfiguration

#[non_exhaustive]
pub struct S3DestinationConfiguration {
    pub bucket: String,
    pub key: String,
    pub glue_configuration: Option<GlueConfiguration>,
    pub role_arn: String,
}

Configuration information for delivery of dataset contents to Amazon Simple Storage Service (Amazon S3).

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

bucket: String

The name of the S3 bucket to which dataset contents are delivered.

key: String

The key of the dataset contents object in an S3 bucket. Each object has a key that is a unique identifier. Each object has exactly one key.

You can create a unique key with the following options:

• Use !{iotanalytics:scheduleTime} to insert the time of a scheduled SQL query run.

• Use !{iotanalytics:versionId} to insert a unique hash that identifies a dataset content.

• Use !{iotanalytics:creationTime} to insert the creation time of a dataset content.

The following example creates a unique key for a CSV file: dataset/mydataset/!{iotanalytics:scheduleTime}/!{iotanalytics:versionId}.csv

If you don't use !{iotanalytics:versionId} to specify the key, you might get duplicate keys. For example, you might have two dataset contents with the same scheduleTime but different versionIds. This means that one dataset content overwrites the other.

glue_configuration: Option<GlueConfiguration>

Configuration information for coordination with Glue, a fully managed extract, transform and load (ETL) service.

role_arn: String

The ARN of the role that grants IoT Analytics permission to interact with your Amazon S3 and Glue resources.

Implementations

impl S3DestinationConfiguration

pub fn bucket(&self) -> &str

The name of the S3 bucket to which dataset contents are delivered.

pub fn key(&self) -> &str

The key of the dataset contents object in an S3 bucket. Each object has a key that is a unique identifier. Each object has exactly one key.

You can create a unique key with the following options:

• Use !{iotanalytics:scheduleTime} to insert the time of a scheduled SQL query run.

• Use !{iotanalytics:versionId} to insert a unique hash that identifies a dataset content.

• Use !{iotanalytics:creationTime} to insert the creation time of a dataset content.

The following example creates a unique key for a CSV file: dataset/mydataset/!{iotanalytics:scheduleTime}/!{iotanalytics:versionId}.csv

If you don't use !{iotanalytics:versionId} to specify the key, you might get duplicate keys. For example, you might have two dataset contents with the same scheduleTime but different versionIds. This means that one dataset content overwrites the other.

pub fn glue_configuration(&self) -> Option<&GlueConfiguration>

Configuration information for coordination with Glue, a fully managed extract, transform and load (ETL) service.

pub fn role_arn(&self) -> &str

The ARN of the role that grants IoT Analytics permission to interact with your Amazon S3 and Glue resources.

impl S3DestinationConfiguration

pub fn builder() -> S3DestinationConfigurationBuilder

Creates a new builder-style object to manufacture S3DestinationConfiguration.

Trait Implementations

impl Clone for S3DestinationConfiguration

fn clone(&self) -> S3DestinationConfiguration

Returns a duplicate of the value.

const fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for S3DestinationConfiguration

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for S3DestinationConfiguration

fn eq(&self, other: &S3DestinationConfiguration) -> bool

Tests for self and other values to be equal, and is used by ==.

const fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for S3DestinationConfiguration