1 amazon.s3.listKeys

Returns a list of summary information about the objects in the specified bucket. Depending on the request parameters, additional information is returned, such as common prefixes if a delimiter was specified. List results are always returned in lexicographic (alphabetical) order. Because buckets can contain a virtually unlimited number of keys, the complete results of a list query can be extremely large. To manage large result sets, Amazon S3 uses pagination to split them into multiple responses. Always check the ObjectListing.isTruncated() method to see if the returned listing is complete or if additional calls are needed to get more result

<amazon.s3.listKeys
    bucketName='bucketName'
    maxKeys='maxKeys'
    access-key='access-key'
    secret-key='secret-key'
    region='region'
/>

Attributes
Name	Type	Required	Default	Description
AbucketName	String				Name of the bucket
AmaxKeys	Integer			1000	Maximum number of rows returned
Aaccess-key	String				The AWS access key
Asecret-key	String				The AWS secret access key
Aregion	String				Sets the region to be used by the client. This will be used to determine both the service endpoint (eg: https://sns.us-west-1.amazonaws.com) and signing region (eg: us-west-1) for requests. If region is not explicitly provided as an attribute the DEFAULT_REGION_PROVIDER is consulted.

Example

Copy

<xsql-script>
    <body>
        <println><amazon.s3.listKeys bucketName='//informixs3test' /></println>
    </body>
</xsql-script>

Which prints in standard output:

Copy

+---------------------------------------+-------+-------+-----------------------------+------------+----------------------------------+
|key                                    |owner  |size   |lastModified                 |storageClass|ETag                              |
|char                                   |char   |long   |char                         |char        |char                              |
|visible                                |visible|visible|visible                      |visible     |visible                           |
+---------------------------------------+-------+-------+-----------------------------+------------+----------------------------------+
|ACM.pdf                                |       | 537427|Sat Aug 19 01:22:29 CEST 2017|STANDARD    |88c04558b24086b014b0edc059d7e381  |
|README.TODO                            |       |   6021|Sat Aug 19 16:02:52 CEST 2017|STANDARD    |638515d2dae98d9a38d6b087b2fb4de7  |
|README.md                              |       |    629|Sat Aug 19 01:24:04 CEST 2017|STANDARD    |5b830c613870f6d39918617a5bbd8d43-1|
|blob1.txt                              |       |    256|Sat Aug 19 16:02:51 CEST 2017|STANDARD    |494574e620952e1e30d0f498f2aa664d  |
|deister-ibdf.jar                       |       |  60352|Tue Aug 29 15:24:40 CEST 2017|STANDARD    |bdf631b1a2acbc5776d0930a7b9b073d  |
|deister-informix-bigdata.jar           |       |  61488|Thu Aug 31 12:42:02 CEST 2017|STANDARD    |e9b00c1afce3cb8f49704425cea2613d  |
|deister-informix-vldb.jar              |       |  61740|Mon Sep 04 15:48:15 CEST 2017|STANDARD    |78b2cac7812e2aa3243966d9bebcc560  |
|heapdump.20170825.201454.20065.0002.phd|       |2856578|Fri Aug 25 22:56:18 CEST 2017|STANDARD    |81b62f03a5534927896b1c15889805c9  |
|informix-amazon-s3.jar                 |       |  59315|Tue Aug 29 15:36:32 CEST 2017|STANDARD    |05def02d9f506cc8c6a370eb75d84220  |
|informix-deister-bdf.jar               |       |  58932|Tue Aug 29 11:01:04 CEST 2017|STANDARD    |24fa7ba9e322ba88c7a2871ecdff0db1  |
|informix-s3.jar                        |       |  28118|Sun Aug 27 15:01:16 CEST 2017|STANDARD    |7aa39ff2f1670fac4fead3a06961348e  |
|jdbc.jar                               |       | 785887|Thu Aug 24 03:22:33 CEST 2017|STANDARD    |18526bf316907548013ac342eeb332f2  |
+---------------------------------------+-------+-------+-----------------------------+------------+----------------------------------+

Example

Copy

<xsql-script>
    <body>
        <println><amazon.s3.listKeys bucketName='//informixs3test' ' access-key="MY_ACCESS_KEY" secret-key="MY_SECRET_KEY" region='eu-central-1' maxKeys='2'/></println>
    </body>
</xsql-script>

Which prints in standard output:

Copy

+---------------------------------------+-------+-------+-----------------------------+------------+----------------------------------+
|key                                    |owner  |size   |lastModified                 |storageClass|ETag                              |
|char                                   |char   |long   |char                         |char        |char                              |
|visible                                |visible|visible|visible                      |visible     |visible                           |
+---------------------------------------+-------+-------+-----------------------------+------------+----------------------------------+
|ACM.pdf                                |       | 537427|Sat Aug 19 01:22:29 CEST 2017|STANDARD    |88c04558b24086b014b0edc059d7e381  |
|README.TODO                            |       |   6021|Sat Aug 19 16:02:52 CEST 2017|STANDARD    |638515d2dae98d9a38d6b087b2fb4de7  |
+---------------------------------------+-------+-------+-----------------------------+------------+----------------------------------+