From a382db7e5083d0d869b8e82b416fa659e7f6746e Mon Sep 17 00:00:00 2001
From: Mark Edmondson Please refer to the googleCloudStorageR website for most up to date documentation: http://code.markedmondson.me/googleCloudStorageR/ Please refer to the googleCloudStorageR website for most up to date documentation: Edmondson M (????).
googleCloudStorageR: R Interface with Google Cloud Storage.
-R package version 0.5.0.9000.
+R package version 0.5.1.
Object Object The modification time of the object metadata in RFC 3339 format Object object An object. Authenticate with Google Cloud Storage API Authentication json file you have downloaded from your Google Project The best way to authenticate is to use an environment argument pointing at your authentication file. Set the file location of your download Google Project JSON file in a Then, when you load the library you should auto-authenticate However, you can authenticate directly using this function pointing at your JSON auth file. This merges objects stored on Cloud Storage into one object. The bucket where the objects sit Object metadata Copies an object to a new destination Apply a predefined set of access controls to the destination object. If not NULL must be one of the predefined access controls such as If successful, a rewrite object. Other object functions: Create a new bucket in your project A list of gcs_create_lifecycle objects See here for details on location options Other bucket functions: Create a new access control at the bucket level Used also for when a bucket is updated Bucket access control object Other Access control functions: Use this to set rules for how long objects last in a bucket in gcs_create_bucket For multiple conditions, pass this object in as a list. Lifecycle documentation https://cloud.google.com/storage/docs/lifecycle Add a notification configuration that sends notifications for all supported events. What events to activate, leave at default for all Cloud Pub/Sub notifications allow you to track changes to your Cloud Storage objects.
@@ -160,14 +160,12 @@
-
-
-
googleCloudStorageR
Setup
-
diff --git a/docs/articles/googleCloudStorageR.html b/docs/articles/googleCloudStorageR.html
index 0c63a96..5e4eef6 100644
--- a/docs/articles/googleCloudStorageR.html
+++ b/docs/articles/googleCloudStorageR.html
@@ -30,7 +30,7 @@
googleCloudStorageR
- 0.5.0.9000
+ 0.5.1
googleCloudStorageR
Mark Edmondson
- 2019-07-30
+ 2019-08-31
googleCloudStorageR.Rmd
Contents
diff --git a/docs/articles/index.html b/docs/articles/index.html
index 9f72756..c83d443 100644
--- a/docs/articles/index.html
+++ b/docs/articles/index.html
@@ -8,11 +8,13 @@
-
Citation
@Manual{,
title = {googleCloudStorageR: R Interface with Google Cloud Storage},
author = {Mark Edmondson},
- note = {R package version 0.5.0.9000},
+ note = {R package version 0.5.1},
}
+
Authors
-
Changelog
-
-googleCloudStorageR 0.5.0.9000 Unreleased
+googleCloudStorageR 0.5.1 Unreleased
+
-
gcs_save_all()
to use new zip
for filepaths (Thanks @caewok) #107gcs_version_bucket()
- thanks @j450h1 ! (#96)
Contents
-
Object(acl = NULL, bucket = NULL, cacheControl = NULL,
@@ -136,7 +136,7 @@
-
+
Object Object
metadata = NULL, metageneration = NULL, name = NULL,
owner = NULL, selfLink = NULL, size = NULL, storageClass = NULL,
timeCreated = NULL, timeDeleted = NULL, updated = NULL)Arguments
-
+
Arg
Value
Details
-
Authenticate with Google Cloud Storage API
gcs_auth(json_file)
-
+
Arguments
-
+
Arg
Details
GCS_AUTH_FILE
argumentExamples
Examp
Contents
diff --git a/docs/reference/gcs_compose_objects.html b/docs/reference/gcs_compose_objects.html
index adcd1bd..8024c43 100644
--- a/docs/reference/gcs_compose_objects.html
+++ b/docs/reference/gcs_compose_objects.html
@@ -8,11 +8,13 @@
-
Compose up to 32 objects into one
gcs_compose_objects(objects, destination,
bucket = gcs_get_global_bucket())
-
+
Arguments
-
+
Arg
Value
See also
See a
gcs_get_object
,
gcs_list_objects
,
gcs_metadata_object
Examples
Examp
Contents
diff --git a/docs/reference/gcs_copy_object.html b/docs/reference/gcs_copy_object.html
index a185522..dfef789 100644
--- a/docs/reference/gcs_copy_object.html
+++ b/docs/reference/gcs_copy_object.html
@@ -8,11 +8,13 @@
-
Copy an object
gcs_copy_object(source_object, destination_object,
source_bucket = gcs_get_global_bucket(),
destination_bucket = gcs_get_global_bucket(), rewriteToken = NULL,
destinationPredefinedAcl = NULL)
-
+
Arguments
-
+
Arg
"bucketOwnerFullControl"
Value
See also
gcs_compose_objects
,
@@ -173,18 +172,15 @@ See a
gcs_get_object
,
gcs_list_objects
,
gcs_metadata_object
-
Create a new bucket
gcs_create_bucket(name, projectId, location = "US",
@@ -137,7 +137,7 @@
-
+
Create a new bucket
"bucketOwnerRead", "authenticatedRead", "private", "projectPrivate",
"publicRead"), projection = c("noAcl", "full"), versioning = FALSE,
lifecycle = NULL)Arguments
-
+
Arg
Details
See also
gcs_create_lifecycle
,
@@ -191,18 +190,15 @@ See a
gcs_get_global_bucket
,
gcs_global_bucket
,
gcs_list_buckets
-
Create a Bucket Access Controls
gcs_create_bucket_acl(bucket = gcs_get_global_bucket(), entity = "",
entity_type = c("user", "group", "domain", "project", "allUsers",
"allAuthenticatedUsers"), role = c("READER", "OWNER"))
-
+
Arguments
-
+
Arg
Value
See also
gcs_get_bucket_acl
,
gcs_get_object_acl
,
gcs_update_object_acl
-
Create a lifecycle condition
gcs_create_lifecycle(age = NULL, createdBefore = NULL,
numNewerVersions = NULL, isLive = NULL)
-
+
Arguments
-
+
Arg
See also
See a
gcs_get_global_bucket
,
gcs_global_bucket
,
gcs_list_buckets
Examples
# NOT RUN {
@@ -182,9 +181,7 @@
Examp
Contents
diff --git a/docs/reference/gcs_create_pubsub.html b/docs/reference/gcs_create_pubsub.html
index dce5ea8..ef1ce7d 100644
--- a/docs/reference/gcs_create_pubsub.html
+++ b/docs/reference/gcs_create_pubsub.html
@@ -8,11 +8,13 @@
Create a pub/sub notification for a bucket
gcs_create_pubsub(topic, project, bucket = gcs_get_global_bucket(),
event_types = NULL)
-
+
Arguments
-
+
Arg
Details
Details
sufficient permissions on the project to receive notifications;
an existing pub/sub topic;
have given your service account at least
pubsub.publisher
permission.
https://cloud.google.com/storage/docs/reporting-changes
Other pubsub functions: gcs_delete_pubsub
,
gcs_get_service_email
,
gcs_list_pubsub
@@ -176,7 +174,7 @@@@ -85,7 +88,6 @@ Changelog -Examp bucket <- "mybucket" # get the email to give access -gce_get_service_email(project) +gcs_get_service_email(project) # once email has access, create a new pub/sub topic for your bucket gcs_create_pubsub("gcs_r", project, bucket) @@ -189,11 +187,8 @@
Examp
Contents
diff --git a/docs/reference/gcs_delete_bucket.html b/docs/reference/gcs_delete_bucket.html index 5c91086..55186ff 100644 --- a/docs/reference/gcs_delete_bucket.html +++ b/docs/reference/gcs_delete_bucket.html @@ -8,11 +8,13 @@Delete a bucket — gcs_delete_bucket • googleCloudStorageR + + @@ -30,13 +32,14 @@ - + + @@ -63,7 +66,7 @@ googleCloudStorageR - 0.5.0.9000 + 0.5.1
Delete the bucket, and all its objects
-gcs_delete_bucket(bucket, ifMetagenerationMatch = NULL, ifMetagenerationNotMatch = NULL)- +
Delete only if metageneration does not match |
Other bucket functions: gcs_create_bucket
,
@@ -156,16 +156,14 @@
gcs_get_global_bucket
,
gcs_global_bucket
,
gcs_list_buckets
Deletes an object from a bucket
-gcs_delete_object(object_name, bucket = gcs_get_global_bucket(), generation = NULL)- +
If successful, TRUE.
-Other object functions: gcs_compose_objects
,
@@ -160,18 +159,15 @@
gcs_get_object
,
gcs_list_objects
,
gcs_metadata_object
Delete notification configurations for a bucket.
-gcs_delete_pubsub(config_name, bucket = gcs_get_global_bucket())- +
config_name | -A name of a configuration |
+ The ID of the pubsub configuration |
---|---|---|
bucket | The bucket for notifications |
TRUE if successful
Cloud Pub/Sub notifications allow you to track changes to your Cloud Storage objects. @@ -150,25 +153,22 @@
pubsub.publisher
permission.
-
https://cloud.google.com/storage/docs/reporting-changes
Other pubsub functions: gcs_create_pubsub
,
gcs_get_service_email
,
gcs_list_pubsub
Create the download URL for objects in buckets
-gcs_download_url(object_name, bucket = gcs_get_global_bucket(), public = FALSE)- +
TRUE to return a public URL |
the URL for downloading objects
-bucket
names should be length 1 or same length as object_name
predefinedAcl = 'publicRead'
Use the public = TRUE
to return the URL accessible to all, which changes the domain name from
storage.cloud.google.com
to storage.googleapis.com
Other download functions: gcs_parse_download
,
gcs_signed_url
Place within your .Rprofile
to load and save your session data automatically
gcs_first(bucket = Sys.getenv("GCS_SESSION_BUCKET")) gcs_last(bucket = Sys.getenv("GCS_SESSION_BUCKET"))- +
The bucket holding your session data. See Details. |
The folder you want to save to Google Cloud Storage will also need to have a yaml file called _gcssave.yaml
in the root of the directory. It can hold the following arguments:
GCS_AUTH_FILE
,
or if on Google Compute Engine it will reuse the Google Cloud authentication
via gar_gce_auth
-
gcs_save_all and gcs_load_all that these functions call
gcs_save_all and gcs_load_all that these functions call
@@ -187,11 +185,8 @@@@ -85,7 +88,6 @@ ChangelogExamp
Contents
diff --git a/docs/reference/gcs_get_bucket.html b/docs/reference/gcs_get_bucket.html index 802cdb9..4511862 100644 --- a/docs/reference/gcs_get_bucket.html +++ b/docs/reference/gcs_get_bucket.html @@ -8,11 +8,13 @@Get bucket info — gcs_get_bucket • googleCloudStorageR + + @@ -30,13 +32,14 @@ - + + @@ -63,7 +66,7 @@ googleCloudStorageR - 0.5.0.9000 + 0.5.1
Meta data about the bucket
-gcs_get_bucket(bucket = gcs_get_global_bucket(), ifMetagenerationMatch = NULL, ifMetagenerationNotMatch = NULL, projection = c("noAcl", "full"))- +
Properties to return. Default noAcl omits acl properties |
A bucket resource object
-Other bucket functions: gcs_create_bucket
,
@@ -165,7 +164,6 @@
gcs_get_global_bucket
,
gcs_global_bucket
,
gcs_list_buckets
@@ -182,11 +180,8 @@@@ -85,7 +88,6 @@ ChangelogExamp
Contents
diff --git a/docs/reference/gcs_get_bucket_acl.html b/docs/reference/gcs_get_bucket_acl.html index f001df0..235218e 100644 --- a/docs/reference/gcs_get_bucket_acl.html +++ b/docs/reference/gcs_get_bucket_acl.html @@ -8,11 +8,13 @@Get Bucket Access Controls — gcs_get_bucket_acl • googleCloudStorageR + + @@ -30,13 +32,14 @@ - + + @@ -63,7 +66,7 @@ googleCloudStorageR - 0.5.0.9000 + 0.5.1
Returns the ACL entry for the specified entity on the specified bucket
-gcs_get_bucket_acl(bucket = gcs_get_global_bucket(), entity = "", entity_type = c("user", "group", "domain", "project", "allUsers", "allAuthenticatedUsers"))- +
Bucket access control object
-Other Access control functions: gcs_create_bucket_acl
,
gcs_get_object_acl
,
gcs_update_object_acl
@@ -176,11 +174,8 @@@@ -85,7 +88,6 @@ ChangelogExamp
Contents
diff --git a/docs/reference/gcs_get_global_bucket.html b/docs/reference/gcs_get_global_bucket.html index 4f36466..8597250 100644 --- a/docs/reference/gcs_get_global_bucket.html +++ b/docs/reference/gcs_get_global_bucket.html @@ -8,11 +8,13 @@Get global bucket name — gcs_get_global_bucket • googleCloudStorageR + + @@ -30,13 +32,14 @@ - + + @@ -63,7 +66,7 @@ googleCloudStorageR - 0.5.0.9000 + 0.5.1
Bucket name set this session to use by default
-gcs_get_global_bucket()
-
+
+
Bucket name
-Set the bucket name via gcs_global_bucket
-Other bucket functions: gcs_create_bucket
,
@@ -146,19 +145,15 @@
gcs_get_bucket
,
gcs_global_bucket
,
gcs_list_buckets
This retrieves an object directly.
-gcs_get_object(object_name, bucket = gcs_get_global_bucket(), meta = FALSE, saveToDisk = NULL, overwrite = FALSE, parseObject = TRUE, parseFunction = gcs_parse_download)- +
If saveToDisk is NULL, the function that will parse the download. Defaults to gcs_parse_download |
The object, or TRUE if successfully saved to disk.
-This differs from providing downloads via a download link as you can @@ -176,9 +175,8 @@
object_name
can use a gs://
URI instead,
in which case it will take the bucket name from that URI and bucket
argument
will be overridden. The URLs should be in the form gs://bucket/object/name
By default if you want to get the object straight into an R session the parseFunction is gcs_parse_download which wraps httr
's content.
By default if you want to get the object straight into an R session the parseFunction is gcs_parse_download which wraps httr
's content.
If you want to use your own function (say to unzip the object) then supply it here. The first argument should take the downloaded object.
-Other object functions: gcs_compose_objects
,
@@ -186,7 +184,6 @@
gcs_delete_object
,
gcs_list_objects
,
gcs_metadata_object
@@ -205,7 +202,7 @@@@ -85,7 +88,6 @@ ChangelogExamp ## default gives a warning about missing column name. ## custom parse function to suppress warning f <- function(object){ - suppressWarnings(httr::content(object, encoding = "UTF-8")) + suppressWarnings(httr::content(object, encoding = "UTF-8")) } ## get mtcars csv with custom parse function. @@ -218,13 +215,9 @@
Examp
Contents
diff --git a/docs/reference/gcs_get_object_acl.html b/docs/reference/gcs_get_object_acl.html index 6492edf..9a1f33c 100644 --- a/docs/reference/gcs_get_object_acl.html +++ b/docs/reference/gcs_get_object_acl.html @@ -8,11 +8,13 @@Check the access control settings for an object for one entity — gcs_get_object_acl • googleCloudStorageR + + @@ -30,13 +32,14 @@ - + + @@ -63,7 +66,7 @@ googleCloudStorageR - 0.5.0.9000 + 0.5.1
Returns the default object ACL entry for the specified entity on the specified bucket.
-gcs_get_object_acl(object_name, bucket = gcs_get_global_bucket(), entity = "", entity_type = c("user", "group", "domain", "project", "allUsers", "allAuthenticatedUsers"), generation = NULL)- +
If present, selects a spcfic revision of the object |
Other Access control functions: gcs_create_bucket_acl
,
gcs_get_bucket_acl
,
gcs_update_object_acl
@@ -190,9 +189,7 @@@@ -85,7 +88,6 @@ ChangelogExamp
Contents
diff --git a/docs/reference/gcs_get_service_email.html b/docs/reference/gcs_get_service_email.html index f432ad7..8b9590c 100644 --- a/docs/reference/gcs_get_service_email.html +++ b/docs/reference/gcs_get_service_email.html @@ -8,11 +8,13 @@Get the email of service account associated with the bucket — gcs_get_service_email • googleCloudStorageR + + @@ -30,13 +32,14 @@ - + + @@ -63,7 +66,7 @@ googleCloudStorageR - 0.5.0.9000 + 0.5.1
Use this to get the right email so you can give it pubsub.publisher
permission.
gcs_get_service_email(project)- +
The project name containing the bucket |
This service email can be different from the email in the service JSON. Give this
pubsub.publisher
permission in the Google cloud console.
Other pubsub functions: gcs_create_pubsub
,
gcs_delete_pubsub
,
gcs_list_pubsub
Set a bucket name used for this R session
-gcs_global_bucket(bucket)- +
bucket name you want this session to use by default, or a bucket object |
The bucket name (invisibly)
-This sets a bucket to a global environment value so you don't need to supply the bucket argument to other API calls.
-Other bucket functions: gcs_create_bucket
,
@@ -156,20 +154,16 @@
gcs_get_bucket
,
gcs_get_global_bucket
,
gcs_list_buckets
List the buckets your projectId has access to
-gcs_list_buckets(projectId, prefix = "", projection = c("noAcl", "full"), maxResults = 1000, detail = c("summary", "full"))- +
Set level of detail |
data.frame
of buckets
Columns returned by detail
are:
summary
- name, storageClass, location ,updated
full
- as above plus: id, selfLink, projectNumber, timeCreated, metageneration, etag
Other bucket functions: gcs_create_bucket
,
@@ -176,7 +174,6 @@
gcs_get_bucket
,
gcs_get_global_bucket
,
gcs_global_bucket
@@ -193,13 +190,9 @@@@ -85,7 +88,6 @@ Changelog -Examp
Contents
diff --git a/docs/reference/gcs_list_objects.html b/docs/reference/gcs_list_objects.html index c3380cb..476310a 100644 --- a/docs/reference/gcs_list_objects.html +++ b/docs/reference/gcs_list_objects.html @@ -8,11 +8,13 @@List objects in a bucket — gcs_list_objects • googleCloudStorageR + + @@ -30,13 +32,14 @@ - + + @@ -63,7 +66,7 @@ googleCloudStorageR - 0.5.0.9000 + 0.5.1
List objects in a bucket
-gcs_list_objects(bucket = gcs_get_global_bucket(), detail = c("summary", "more", "full"), prefix = NULL, delimiter = NULL)- +
Use to list objects like a directory listing. |
A data.frame of the objects
-Columns returned by detail
are:
"/"
, then listing objects from a bucket that contains the
objects "a/b", "a/c", "dddd", "eeee", "e/f"
would return objects "dddd" and "eeee"
,
and prefixes "a/" and "e/"
.
-
Other object functions: gcs_compose_objects
,
@@ -180,20 +178,16 @@
gcs_delete_object
,
gcs_get_object
,
gcs_metadata_object
List notification configurations for a bucket.
-gcs_list_pubsub(bucket = gcs_get_global_bucket())- +
The bucket for notifications |
Cloud Pub/Sub notifications allow you to track changes to your Cloud Storage objects. @@ -146,25 +146,21 @@
pubsub.publisher
permission.
-
https://cloud.google.com/storage/docs/reporting-changes
Other pubsub functions: gcs_create_pubsub
,
gcs_delete_pubsub
,
gcs_get_service_email
Load R objects that have been saved using gcs_save or gcs_save_image
-gcs_load(file = ".RData", bucket = gcs_get_global_bucket(), envir = .GlobalEnv, saveToDisk = file, overwrite = TRUE)- +
If file exists, overwrite. Default TRUE. |
TRUE if successful
-The argument file
's default is to load an image file
called .RData
from gcs_save_image into the Global environment.
This would overwrite your existing .RData
file in the working directory, so
change the file name if you don't wish this to be the case.
Other R session data functions: gcs_save_all
,
gcs_save_image
, gcs_save
,
gcs_source
Use this to pass to uploads in gcs_upload
-gcs_metadata_object(object_name = NULL, metadata = NULL, md5Hash = NULL, crc32c = NULL, contentLanguage = NULL, contentEncoding = NULL, contentDisposition = NULL, cacheControl = NULL)- +
Cache-Control directive for the object data |
Object metadata for uploading of class gar_Object
Other object functions: gcs_compose_objects
,
@@ -181,18 +180,15 @@
gcs_delete_object
,
gcs_get_object
,
gcs_list_objects
Wrapper for httr
's content. This is the default function used in gcs_get_object
Wrapper for httr
's content. This is the default function used in gcs_get_object
gcs_parse_download(object, encoding = "UTF-8")- +
Default to UTF-8 |
gcs_get_object
Other download functions: gcs_download_url
,
gcs_signed_url
Used internally in gcs_upload, you can also use this for failed uploads within one week of generating the upload URL
-gcs_retry_upload(retry_object = NULL, upload_url = NULL, file = NULL, type = NULL)- +
If successful, an object metadata object, if not an gcs_upload_retry object.
- diff --git a/docs/reference/gcs_save.html b/docs/reference/gcs_save.html index a3ddc3f..d6d83f7 100644 --- a/docs/reference/gcs_save.html +++ b/docs/reference/gcs_save.html @@ -8,11 +8,13 @@Performs save then saves it to Google Cloud Storage.
-gcs_save(..., file, bucket = gcs_get_global_bucket(), envir = parent.frame())- +
Environment to search for objects to be saved |
The GCS object
-For all session data use gcs_save_image instead.
@@ -163,26 +162,21 @@For any other use, its better to use gcs_upload and gcs_get_object instead.
Restore the R objects using gcs_load(bucket = "your_bucket")
This will overwrite any data within your local environment with the same name.
-Other R session data functions: gcs_load
,
gcs_save_all
, gcs_save_image
,
gcs_source
This function takes all the files in the directory, zips them, and saves/loads/deletes them to the cloud. The upload name will be the directory name.
-gcs_save_all(directory = getwd(), bucket = gcs_get_global_bucket(), @@ -135,7 +135,7 @@- +Save/Load all files in directory to Google Cloud Storage
exdir = directory, list = FALSE) gcs_delete_all(directory = getwd(), bucket = gcs_get_global_bucket())
When downloading, only list where the files would unzip to |
When uploading the GCS meta object; when downloading TRUE
if successful
Zip/unzip is performed before upload and after download.
- +Zip/unzip is performed before upload and after download using zipr.
Other R session data functions: gcs_load
,
gcs_save_image
, gcs_save
,
gcs_source
Performs save.image then saves it to Google Cloud Storage.
-gcs_save_image(file = ".RData", bucket = gcs_get_global_bucket(), saveLocation = NULL, envir = parent.frame())- +
Environment to save from |
The GCS object
-gcs_save_image(bucket = "your_bucket")
will save all objects in the workspace
to .RData
folder on Google Cloud Storage within your_bucket
.
Restore the objects using gcs_load(bucket = "your_bucket")
This will overwrite any data with the same name in your current local environment.
-Other R session data functions: gcs_load
,
gcs_save_all
, gcs_save
,
gcs_source
This creates a signed URL which you can share with others who may or may not have a Google account. The object will be available until the specified timestamp.
-gcs_signed_url(meta_obj, expiration_ts = Sys.time() + 3600, verb = "GET", md5hash = NULL, includeContentType = FALSE)- +
For getting the URL via browsers this should be set to |
Create a URL with a time-limited read and write to an object, regardless whether they have a Google account
-https://cloud.google.com/storage/docs/access-control/signed-urls
Other download functions: gcs_download_url
,
gcs_parse_download
@@ -189,11 +187,8 @@@@ -85,7 +88,6 @@ ChangelogExamp
Contents
diff --git a/docs/reference/gcs_source.html b/docs/reference/gcs_source.html index 0923917..d8e0d13 100644 --- a/docs/reference/gcs_source.html +++ b/docs/reference/gcs_source.html @@ -8,11 +8,13 @@Source an R script from the Google Cloud — gcs_source • googleCloudStorageR + + @@ -30,13 +32,14 @@ - + + @@ -63,7 +66,7 @@ googleCloudStorageR - 0.5.0.9000 + 0.5.1
Download an R script and run it immediately via source
-gcs_source(script, bucket = gcs_get_global_bucket(), ...)- +
Passed to source |
TRUE if successful
-Other R session data functions: gcs_load
,
gcs_save_all
, gcs_save_image
,
gcs_save
Updates Google Cloud Storage ObjectAccessControls
-gcs_update_object_acl(object_name, bucket = gcs_get_global_bucket(), entity = "", entity_type = c("user", "group", "domain", "project", "allUsers", "allAuthenticatedUsers"), role = c("READER", "OWNER"))- +
Access permission for entity |
TRUE if successful
-An entity
is an identifier for the entity_type
.
entity="group"
could be example@googlegroups.com
entity="domain"
could be example.com
which is a Google Apps for Business domain.
objectAccessControls on Google API reference
Other Access control functions: gcs_create_bucket_acl
,
gcs_get_bucket_acl
,
gcs_get_object_acl
Upload up to 5TB
-gcs_upload(file, bucket = gcs_get_global_bucket(), type = NULL, @@ -134,7 +134,7 @@- +Upload a file of arbitrary type
"authenticatedRead", "bucketOwnerFullControl", "bucketOwnerRead", "projectPrivate", "publicRead", "default"), upload_type = c("simple", "resumable"))
Override automatic decision on upload type |
If successful, a metadata object
-When using object_function
it expects a function with two arguments:
If file
or name
argument contains folders e.g. /data/file.csv
then
the file will be uploaded with the same folder structure e.g. in a /data/
folder.
Use name
to override this.
Requires scopes https://www.googleapis.com/auth/devstorage.read_write
or https://www.googleapis.com/auth/devstorage.full_control
@@ -241,13 +238,9 @@@@ -86,7 +89,6 @@ ChangelogExamp
Contents
diff --git a/docs/reference/gcs_version_bucket.html b/docs/reference/gcs_version_bucket.html index c89ea2c..7789177 100644 --- a/docs/reference/gcs_version_bucket.html +++ b/docs/reference/gcs_version_bucket.html @@ -8,11 +8,13 @@Change or fetch bucket version status — gcs_version_bucket • googleCloudStorageR + + @@ -30,14 +32,15 @@ - + + @@ -64,7 +67,7 @@ googleCloudStorageR - 0.5.0.9000 + 0.5.1
Turn bucket versioning on or off, check status (default), or list archived versions of objects in the bucket and view their generation numbers.
-gcs_version_bucket(bucket, action = c("status", "enable", "disable", "list"))- +
"status", "enable", "disable", or "list" |
If action="list"
a versioned_objects dataframe
If action="status"
a boolean on if versioning is TRUE or FALSE
If action="enable" or "disable"
TRUE if operation is successful
@@ -175,9 +174,7 @@@@ -85,7 +88,6 @@ ChangelogExamp
Contents
diff --git a/docs/reference/googleCloudStorageR.html b/docs/reference/googleCloudStorageR.html index 06a7b0e..80371b7 100644 --- a/docs/reference/googleCloudStorageR.html +++ b/docs/reference/googleCloudStorageR.html @@ -8,11 +8,13 @@googleCloudStorageR — googleCloudStorageR • googleCloudStorageR + + @@ -30,13 +32,14 @@ - + + @@ -63,7 +66,7 @@ googleCloudStorageR - 0.5.0.9000 + 0.5.1
Interact with Google Cloud Storage API in R. Part of the 'cloudyr' project.
-