H5P_DATASET_ACCESS: HDF5 File Access Property List Interface
In rhdf5: R Interface to HDF5

Description Usage Arguments Details Value Author(s) References See Also Examples

The functions, macros, and subroutines listed here are used to manipulate file access property lists (fapl) objects in various ways.

1	H5Pset_fapl_ros3 ( h5plist, s3credentials = NULL)

`h5plist`	An object of class `H5IdComponent` representing a H5 property list identifier of class H5P_FILE_ACCESS. See `H5Pcreate` or `H5Pcopy` to create an object of this kind.
`s3credentials`	Either `NULL` or a list of length 3 specifying the AWS access credentials (see details).

To access files in a private Amazon S3 bucket you will need to provide three additional details: The AWS region where the files are hosted, your AWS access key ID, and your AWS secret access key. More information on how to obtain AWS access keys can be found at https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html#access-keys-and-secret-access-keys. These are provided as a list to the s3credentials argument. If you are accessing public data this argument should be NULL.

See https://portal.hdfgroup.org/display/HDF5/File+Access+Properties for further details. See H5P for documentation of more functions to manupulate property lists of other property list classes.

The functions return the standard return value from their respective C-functions.

Mike L. Smith

https://portal.hdfgroup.org/display/HDF5

H5P

## creating a fapl for accessing a public S3 bucket

pid <- H5Pcreate("H5P_FILE_ACCESS")
H5Pset_fapl_ros3( pid )
H5Pclose(pid)


## creating a fapl for accessing a private S3 bucket
## and provding required S3 credentials list

## these are example credentials and will not provide access
s3_cred <- list(
    aws_region = "eu-central-1",
    access_key_id = "AKIAIOSFODNN7EXAMPLE",
    secret_access_key = "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"
)


pid <- H5Pcreate("H5P_FILE_ACCESS")
H5Pset_fapl_ros3( pid, s3credentials = s3_cred )
H5Pclose(pid)