Folder : get_sts_storage_token
Folder_GetStsStorageToken.RdGet STS (AWS Security Token Service) credentials for direct access to the storage location backing this entity. These credentials can be used with AWS tools such as the AWS CLI.
Usage
synGetStsStorageToken(instance, permission, output_format="json", min_remaining_life=NULL, synapse_client=NULL)Arguments
- instance
(Folder) The Folder instance to operate on.
- permission
(character) The permission level for the token. Must be 'read_only' or 'read_write'.
- output_format
(character) The output format for the credentials. Options:
- 'json' (default): the credentials exactly as returned by Synapse, as a named list.
- 'boto': a named list with only theaws_access_key_id,aws_secret_access_key, andaws_session_tokenentries.
- 'bash', 'cmd', or 'powershell': a character string of commands that export the credentials as environment variables in that shell.
- 'shell': the same as one of 'bash', 'cmd', or 'powershell', chosen automatically for the current system.- min_remaining_life
(Optional[integer]) The minimum remaining life (in seconds) for a cached token before a new one is fetched.
- synapse_client
(Optional[Synapse]) If not passed in, the last created instance from the Synapse class constructor will be used.
Examples
if (FALSE) { # \dontrun{
## Using credentials with AWS tools
# Get STS credentials for an STS-enabled folder and make them available to
# AWS tools (such as the AWS CLI) through the standard environment variables.
library(synapser)
synLogin()
folder = Folder(id = "syn123") |> synGet()
credentials = folder |> synGetStsStorageToken(
permission = "read_write",
output_format = "boto"
)
Sys.setenv(
AWS_ACCESS_KEY_ID = credentials$aws_access_key_id,
AWS_SECRET_ACCESS_KEY = credentials$aws_secret_access_key,
AWS_SESSION_TOKEN = credentials$aws_session_token
)
} # }