Create a storage endpoint object, for interacting with blob, file, table, queue or ADLSgen2 storage.
storage_endpoint(endpoint, key = NULL, token = NULL, sas = NULL,
api_version)blob_endpoint(endpoint, key = NULL, token = NULL, sas = NULL,
api_version = getOption("azure_storage_api_version"))
file_endpoint(endpoint, key = NULL, token = NULL, sas = NULL,
api_version = getOption("azure_storage_api_version"))
adls_endpoint(endpoint, key = NULL, token = NULL, sas = NULL,
api_version = getOption("azure_adls_api_version"))
# S3 method for storage_endpoint
print(x, ...)
# S3 method for adls_endpoint
print(x, ...)
The URL (hostname) for the endpoint. This must be of the form http[s]://{account-name}.{type}.{core-host-name}
, where type
is one of "dfs"
(corresponding to ADLSgen2), "blob"
, "file"
, "queue"
or "table"
. On the public Azure cloud, endpoints will be of the form https://{account-name}.{type}.core.windows.net
.
The access key for the storage account.
An Azure Active Directory (AAD) authentication token. This can be either a string, or an object of class AzureToken created by AzureRMR::get_azure_token. The latter is the recommended way of doing it, as it allows for automatic refreshing of expired tokens.
A shared access signature (SAS) for the account.
The storage API version to use when interacting with the host. Defaults to "2018-06-17"
for the ADLSgen2 endpoint, and "2018-03-28"
for the others.
For the print method, a storage endpoint object.
For the print method, further arguments passed to lower-level functions.
storage_endpoint
returns an object of S3 class "adls_endpoint"
, "blob_endpoint"
, "file_endpoint"
, "queue_endpoint"
or "table_endpoint"
depending on the type of endpoint. All of these also inherit from class "storage_endpoint"
. adls_endpoint
, blob_endpoint
and file_endpoint
return an object of the respective class.
Currently AzureStor only includes methods for interacting with ADLSgen2, blob and file storage.
This is the starting point for the client-side storage interface in AzureRMR. storage_endpoint
is a generic function to create an endpoint for any type of Azure storage while adls_endpoint
, blob_endpoint
and file_endpoint
create endpoints for those types.
If multiple authentication objects are supplied, they are used in this order of priority: first an access key, then an AAD token, then a SAS. If no authentication objects are supplied, only public (anonymous) access to the endpoint is possible. Note that authentication with a SAS is not currently supported by ADLSgen2.
create_storage_account, adls_filesystem, create_adls_filesystem, file_share, create_file_share, blob_container, create_blob_container
# NOT RUN {
# obtaining an endpoint from the storage account resource object
endp <- stor$get_blob_endpoint()
# creating an endpoint standalone
endp <- blob_endpoint("https://mystorage.blob.core.windows.net/", key="access_key")
# }
Run the code above in your browser using DataLab