Files {sevenbridges2} | R Documentation |
R6 Class representing Files resource.
sevenbridges2::Resource
-> Files
URL
List of URL endpoints for this resource.
new()
Create new Files resource object.
Files$new(...)
...
Other response arguments.
query()
This call returns a list of files and subdirectories in a
specified project or directory within a project, with specified
properties that you can access. The project or directory whose contents
you want to list is specified as a query parameter in the call. Further
properties to filter by can also be specified as query parameters.
Note that this call lists both files and subdirectories in the
specified project or directory within a project, but not the contents
of the subdirectories.
To list the contents of a subdirectory, make a new call
and specify the subdirectory ID as the parent
parameter.
More information you can find in our
API documentation.
Files$query( project = NULL, parent = NULL, name = NULL, metadata = NULL, origin = NULL, tag = NULL, limit = getOption("sevenbridges2")$limit, offset = getOption("sevenbridges2")$offset, ... )
project
Project identifier (ID) as string or a Project object. Project should not be used together with parent. If parent is used, the call will list the content of the specified folder, within the project to which the folder belongs. If project is used, the call will list the content at the root of the project's files.
parent
The parent folder identifier as string or a File object
which must be of type FOLDER
.
Should not be used together with project.
If parent is used, the call will list the content of the specified
folder, within the project to which the folder belongs.
If project is used, the call will list the content at the root of
the project's files.
name
Name of the file. List files with this name. Note that the name must be an exact complete string for the results to match. Multiple names can be represented as a vector.
metadata
List file with this metadata field values. List only files that have the specified value in metadata field. Different metadata fields are represented as a named list. You can also define multiple instances of the same metadata field.
origin
Task object. List only files produced by task.
tag
List files containing this tag. Note that the tag must be an exact complete string for the results to match. Multiple tags can be represented by vector of values.
limit
The maximum number of collection items to return
for a single request. Minimum value is 1
.
The maximum value is 100
and the default value is 50
.
This is a pagination-specific attribute.
offset
The zero-based starting index in the entire collection
of the first item to return. The default value is 0
.
This is a pagination-specific attribute.
...
Other arguments that can be passed to core api()
function
as 'fields', etc.
Collection
of File
objects.
\dontrun{ files_object <- Files$new(auth = auth) # Query files in a project files_object$query(project = project) }
get()
This call returns a single File object with its details. The call returns the file's name, its tags, and all of its metadata. Files are specified by their IDs, which you can obtain by making the API call to list all files in a project.
Files$get(id, ...)
id
The file ID.
...
Other arguments that can be passed to core api()
function
as 'fields', etc.
File
object.
\dontrun{ files_object <- Files$new(auth = auth) # Get file using id files_object$get(id = id) }
delete()
This call removes a file from the Seven Bridges Platform.
Files are specified by their IDs, which you can obtain by using
Files$query()
to list files or by getting a single file
using Files$get()
.
Files$delete(file, ...)
file
File
object or file ID.
...
Other arguments that can be passed to core api()
function
as 'fields', etc.
\dontrun{ files_object <- Files$new(auth = auth) # Delete a file files_object$delete(file = file) }
copy()
Copy file/files to the specified project. This call allows
you to copy files between projects. Unlike the call to copy a file
between projects, this call lets you batch the copy operation and copy
a list of files at a time.
More information you may find
here.
Files$copy(files, destination_project)
files
The list of files' IDs or list of File object to copy.
destination_project
Project object or project ID. where you want to copy files into.
\dontrun{ files_object <- Files$new(auth = auth) # Copy files to a project files_object$copy( file = file, destination_project = project ) }
create_folder()
A method for creating a new folder. It allows you to create
a new folder on the Platform within the root folder of a specified
project or the provided parent folder. Remember that you should provide
either the destination project (as the project
parameter) or the
destination folder (as the parent
parameter), not both.
More information you may find
here.
Files$create_folder(name, parent = NULL, project = NULL)
name
The name of the folder you are about to create.
parent
The ID of the parent destination folder or a File
object which must be of type FOLDER
.
project
The ID of the destination project, or a Project object.
\dontrun{ files_object <- Files$new(auth = auth) # Create folder in a project files_object$create_folder( name = name, project = project ) }
bulk_delete()
This method facilitates bulk file deletion. It accepts
either a list of File
objects or a list containing
files' IDs.
Files$bulk_delete(files)
files
Either a list of File
objects or a list
of strings (IDs) representing the files you intend to delete.
None. The function only displays the IDs of the deleted files in the console.
\dontrun{ # Delete two files by providing their IDs a$files$bulk_delete(files = list("file_1_ID", "file_2_ID")) } \dontrun{ # Delete two files by providing a list of File objects a$files$bulk_delete(files = list(File_Object_1, File_Object_2)) }
bulk_get()
This call returns the details of multiple specified files, including file names and file metadata. The maximum number of files you can retrieve the details for per call is 100.
Files$bulk_get(files)
files
A list of File
objects or list of strings
(IDs) of the files you are querying for details.
Collection
(list of File
objects).
\dontrun{ # Get details of multiple files a$files$bulk_get( files = list("file_1_ID", "file_2_ID") ) }
bulk_update()
A method that sets new information for specified files, replacing all existing information and erasing omitted parameters.
Files$bulk_update(files)
files
List of File
objects.
For each of the specified files, the call sets a new name
,
new tags
, and metadata
.
When editing fields in the File
objects you wish to
update, keep the following in mind:
The name
field should be a string representing the new name of
the file.
The metadata
field should be a named list of key-value pairs.
The keys and values should be strings.
The tags
field should be an unnamed list of values.
The maximum number of files you can update the details for per call is 100.
Collection
(list of File
objects).
\dontrun{ # Update details of multiple files a$files$bulk_update( files = list(File_Object_1, File_Object_2) ) }
bulk_edit()
This method modifies the existing information for specified files or adds new information while preserving omitted parameters.
Files$bulk_edit(files)
files
List of File
objects.
For each of the specified files, the call edits its name
,
tags
, and metadata
.
When editing fields in the File
objects you wish to
update, keep the following in mind:
The name
field should be a string representing the new name of
the file.
The metadata
field should be a named list of key-value pairs.
The keys and values should be strings.
The tags
field should be an unnamed list of values.
The maximum number of files you can update the details for per call is 100.
Collection
(list of File
objects).
\dontrun{ # Edit details of multiple files a$files$bulk_edit( files = list(File_Object_1, File_Object_2) ) }
clone()
The objects of this class are cloneable with this method.
Files$clone(deep = FALSE)
deep
Whether to make a deep clone.
## ------------------------------------------------
## Method `Files$query`
## ------------------------------------------------
## Not run:
files_object <- Files$new(auth = auth)
# Query files in a project
files_object$query(project = project)
## End(Not run)
## ------------------------------------------------
## Method `Files$get`
## ------------------------------------------------
## Not run:
files_object <- Files$new(auth = auth)
# Get file using id
files_object$get(id = id)
## End(Not run)
## ------------------------------------------------
## Method `Files$delete`
## ------------------------------------------------
## Not run:
files_object <- Files$new(auth = auth)
# Delete a file
files_object$delete(file = file)
## End(Not run)
## ------------------------------------------------
## Method `Files$copy`
## ------------------------------------------------
## Not run:
files_object <- Files$new(auth = auth)
# Copy files to a project
files_object$copy(
file = file,
destination_project = project
)
## End(Not run)
## ------------------------------------------------
## Method `Files$create_folder`
## ------------------------------------------------
## Not run:
files_object <- Files$new(auth = auth)
# Create folder in a project
files_object$create_folder(
name = name,
project = project
)
## End(Not run)
## ------------------------------------------------
## Method `Files$bulk_delete`
## ------------------------------------------------
## Not run:
# Delete two files by providing their IDs
a$files$bulk_delete(files = list("file_1_ID", "file_2_ID"))
## End(Not run)
## Not run:
# Delete two files by providing a list of File objects
a$files$bulk_delete(files = list(File_Object_1, File_Object_2))
## End(Not run)
## ------------------------------------------------
## Method `Files$bulk_get`
## ------------------------------------------------
## Not run:
# Get details of multiple files
a$files$bulk_get(
files = list("file_1_ID", "file_2_ID")
)
## End(Not run)
## ------------------------------------------------
## Method `Files$bulk_update`
## ------------------------------------------------
## Not run:
# Update details of multiple files
a$files$bulk_update(
files = list(File_Object_1, File_Object_2)
)
## End(Not run)
## ------------------------------------------------
## Method `Files$bulk_edit`
## ------------------------------------------------
## Not run:
# Edit details of multiple files
a$files$bulk_edit(
files = list(File_Object_1, File_Object_2)
)
## End(Not run)