зеркало из https://github.com/Azure/AzureStor.git
refresh doc, change error to warning on bad url
This commit is contained in:
Родитель
68d01714dc
Коммит
f80beac1cb
|
@ -34,7 +34,7 @@
|
|||
#'
|
||||
#' Accounts created with `kind = "BlobStorage"` can only host blob storage, while those with `kind = "FileStorage"` can only host file storage. Accounts with `kind = "StorageV2"` can host all types of storage. Currently, AzureStor provides an R interface to ADLSgen2, blob and file storage.
|
||||
#'
|
||||
#' Currently (as of May 2019), if hierarchical namespaces are enabled, the blob API for the account is disabled. The blob endpoint is still accessible, but blob operations on the endpoint will fail. Full interoperability between blobs and ADLSgen2 is planned for later in 2019.
|
||||
#' Currently (as of October 2019), if hierarchical namespaces are enabled, the blob API for the account is disabled. The blob endpoint is still accessible, but blob operations on the endpoint will fail. Full interoperability between blobs and ADLSgen2 is planned for later in 2019.
|
||||
#'
|
||||
#' @section Value:
|
||||
#' An object of class `az_storage` representing the created storage account.
|
||||
|
|
|
@ -15,7 +15,7 @@
|
|||
#'
|
||||
#' If authenticating via AAD, you can supply the token either as a string, or as an object of class AzureToken, created via [AzureRMR::get_azure_token]. The latter is the recommended way of doing it, as it allows for automatic refreshing of expired tokens.
|
||||
#'
|
||||
#' Currently (as of May 2019), if hierarchical namespaces are enabled on a storage account, the blob API for the account is disabled. The blob endpoint is still accessible, but blob operations on the endpoint will fail. Full interoperability between blobs and ADLSgen2 is planned for later in 2019.
|
||||
#' Currently (as of October 2019), if hierarchical namespaces are enabled on a storage account, the blob API for the account is disabled. The blob endpoint is still accessible, but blob operations on the endpoint will fail. Full interoperability between blobs and ADLSgen2 is planned for later in 2019.
|
||||
#'
|
||||
#' @return
|
||||
#' For `adls_filesystem` and `create_adls_filesystem`, an S3 object representing an existing or created filesystem respectively.
|
||||
|
|
|
@ -17,7 +17,7 @@
|
|||
#'
|
||||
#' If authenticating via AAD, you can supply the token either as a string, or as an object of class AzureToken, created via [AzureRMR::get_azure_token]. The latter is the recommended way of doing it, as it allows for automatic refreshing of expired tokens.
|
||||
#'
|
||||
#' Currently (as of May 2019), if hierarchical namespaces are enabled on a storage account, the blob API for the account is disabled. The blob endpoint is still accessible, but blob operations on the endpoint will fail. Full interoperability between blobs and ADLSgen2 is planned for later in 2019.
|
||||
#' Currently (as of October 2019), if hierarchical namespaces are enabled on a storage account, the blob API for the account is disabled. The blob endpoint is still accessible, but blob operations on the endpoint will fail. Full interoperability between blobs and ADLSgen2 is planned for later in 2019.
|
||||
#'
|
||||
#' @return
|
||||
#' For `blob_container` and `create_blob_container`, an S3 object representing an existing or created container respectively.
|
||||
|
|
|
@ -6,7 +6,7 @@
|
|||
#' @param key The access key for the storage account.
|
||||
#' @param token 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.
|
||||
#' @param sas A shared access signature (SAS) for the account.
|
||||
#' @param api_version 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.
|
||||
#' @param api_version The storage API version to use when interacting with the host. Defaults to `"2018-11-09"`.
|
||||
#' @param x For the print method, a storage endpoint object.
|
||||
#' @param ... For the print method, further arguments passed to lower-level functions.
|
||||
#'
|
||||
|
@ -74,7 +74,7 @@ blob_endpoint <- function(endpoint, key=NULL, token=NULL, sas=NULL,
|
|||
api_version=getOption("azure_storage_api_version"))
|
||||
{
|
||||
if(!is_endpoint_url(endpoint, "blob"))
|
||||
stop("Not a blob endpoint", call.=FALSE)
|
||||
warning("Not a recognised blob endpoint", call.=FALSE)
|
||||
|
||||
obj <- list(url=endpoint, key=key, token=token, sas=sas, api_version=api_version)
|
||||
class(obj) <- c("blob_endpoint", "storage_endpoint")
|
||||
|
@ -87,7 +87,7 @@ file_endpoint <- function(endpoint, key=NULL, token=NULL, sas=NULL,
|
|||
api_version=getOption("azure_storage_api_version"))
|
||||
{
|
||||
if(!is_endpoint_url(endpoint, "file"))
|
||||
stop("Not a file endpoint", call.=FALSE)
|
||||
warning("Not a recognised file endpoint", call.=FALSE)
|
||||
|
||||
obj <- list(url=endpoint, key=key, token=token, sas=sas, api_version=api_version)
|
||||
class(obj) <- c("file_endpoint", "storage_endpoint")
|
||||
|
@ -100,7 +100,7 @@ adls_endpoint <- function(endpoint, key=NULL, token=NULL, sas=NULL,
|
|||
api_version=getOption("azure_adls_api_version"))
|
||||
{
|
||||
if(!is_endpoint_url(endpoint, "adls"))
|
||||
stop("Not an ADLS Gen2 endpoint", call.=FALSE)
|
||||
warning("Not a recognised ADLS Gen2 endpoint", call.=FALSE)
|
||||
|
||||
if(!is_empty(sas))
|
||||
warning("ADLSgen2 does not support authentication with a shared access signature")
|
||||
|
|
|
@ -85,7 +85,7 @@ You can call these functions in a couple of ways: by passing the full URL of the
|
|||
|
||||
If authenticating via AAD, you can supply the token either as a string, or as an object of class AzureToken, created via \link[AzureRMR:get_azure_token]{AzureRMR::get_azure_token}. The latter is the recommended way of doing it, as it allows for automatic refreshing of expired tokens.
|
||||
|
||||
Currently (as of May 2019), if hierarchical namespaces are enabled on a storage account, the blob API for the account is disabled. The blob endpoint is still accessible, but blob operations on the endpoint will fail. Full interoperability between blobs and ADLSgen2 is planned for later in 2019.
|
||||
Currently (as of October 2019), if hierarchical namespaces are enabled on a storage account, the blob API for the account is disabled. The blob endpoint is still accessible, but blob operations on the endpoint will fail. Full interoperability between blobs and ADLSgen2 is planned for later in 2019.
|
||||
}
|
||||
\examples{
|
||||
\dontrun{
|
||||
|
|
|
@ -90,7 +90,7 @@ You can call these functions in a couple of ways: by passing the full URL of the
|
|||
|
||||
If authenticating via AAD, you can supply the token either as a string, or as an object of class AzureToken, created via \link[AzureRMR:get_azure_token]{AzureRMR::get_azure_token}. The latter is the recommended way of doing it, as it allows for automatic refreshing of expired tokens.
|
||||
|
||||
Currently (as of May 2019), if hierarchical namespaces are enabled on a storage account, the blob API for the account is disabled. The blob endpoint is still accessible, but blob operations on the endpoint will fail. Full interoperability between blobs and ADLSgen2 is planned for later in 2019.
|
||||
Currently (as of October 2019), if hierarchical namespaces are enabled on a storage account, the blob API for the account is disabled. The blob endpoint is still accessible, but blob operations on the endpoint will fail. Full interoperability between blobs and ADLSgen2 is planned for later in 2019.
|
||||
}
|
||||
\examples{
|
||||
\dontrun{
|
||||
|
|
|
@ -41,7 +41,7 @@ This method deploys a new storage account resource, with parameters given by the
|
|||
|
||||
Accounts created with \code{kind = "BlobStorage"} can only host blob storage, while those with \code{kind = "FileStorage"} can only host file storage. Accounts with \code{kind = "StorageV2"} can host all types of storage. Currently, AzureStor provides an R interface to ADLSgen2, blob and file storage.
|
||||
|
||||
Currently (as of May 2019), if hierarchical namespaces are enabled, the blob API for the account is disabled. The blob endpoint is still accessible, but blob operations on the endpoint will fail. Full interoperability between blobs and ADLSgen2 is planned for later in 2019.
|
||||
Currently (as of October 2019), if hierarchical namespaces are enabled, the blob API for the account is disabled. The blob endpoint is still accessible, but blob operations on the endpoint will fail. Full interoperability between blobs and ADLSgen2 is planned for later in 2019.
|
||||
}
|
||||
|
||||
\section{Value}{
|
||||
|
|
|
@ -37,7 +37,7 @@ adls_endpoint(endpoint, key = NULL, token = NULL, sas = NULL,
|
|||
|
||||
\item{sas}{A shared access signature (SAS) for the account.}
|
||||
|
||||
\item{api_version}{The storage API version to use when interacting with the host. Defaults to \code{"2018-06-17"} for the ADLSgen2 endpoint, and \code{"2018-03-28"} for the others.}
|
||||
\item{api_version}{The storage API version to use when interacting with the host. Defaults to \code{"2018-11-09"}.}
|
||||
|
||||
\item{x}{For the print method, a storage endpoint object.}
|
||||
|
||||
|
|
Загрузка…
Ссылка в новой задаче