Domino NetApp Volumes API

Endpoints

Authz

Gets all permissions for requesting user

POST

/account/authz/permissions/authorizedactions

Description

Gets all permissions for requesting user with optional volume ID or project ID in context field

Body Parameter
NameDescriptionRequired
server.PermissionRequestPermissions to check user against server.PermissionRequest

Responses
CodeMessageDatatype
200OK
400Bad Request
403Forbidden
404Not Found
500Internal Server Error

Volumes

Get if user has all provided volume permissions

POST

/account/authz/permissions/volume/:id

Description

Get if user has all provided volume permissions

Parameters
NameDescriptionRequiredTypeIn
idID of Volume to check permissions againststringpath
Body Parameter
NameDescriptionRequired
server.VolumePermissionsRequestVolume permissions and user to check against server.VolumePermissionsRequest

Responses
CodeMessageDatatype
200OK
400Bad Request
403Forbidden
404Not Found
500Internal Server Error

Attach volume to project

POST

/rpc/attach-volume-to-project

Description

Attach volume to project

Body Parameter
NameDescriptionRequired
server.UpdateVolumeProjectProject ID to attach to Volume ID server.UpdateVolumeProject

Responses
CodeMessageDatatype
204No Content
400Bad Request
403Forbidden
404Not Found
500Internal Server Error

Bulk copies volumes and contents to target project and allows for authorized user impersonation

POST

/rpc/bulk-copy-volumes-to-project

Description

Bulk copies volumes and contents to target project and allows for authorized user impersonation, does not copy snapshots and returns success/failure per volume

Body Parameter
NameDescriptionRequired
server.BulkCopyVolumesRequestVolume IDs to copy and target Project ID server.BulkCopyVolumesRequest

Responses
CodeMessageDatatype
200OK
400Bad Request
403Forbidden
404Not Found
500Internal Server Error

Check whether requesting user is over allowed volume limit

POST

/rpc/check-is-over-limit

Description

Check whether requesting user is over allowed volume limit

Responses
CodeMessageDatatype
200OK
400Bad Request
403Forbidden
404Not Found
500Internal Server Error

Delete volume by ID

POST

/rpc/delete-volume

Description

Delete a volume by ID

Body Parameter
NameDescriptionRequired
server.VolumeIDRequestVolume ID to delete server.VolumeIDRequest

Responses
CodeMessageDatatype
204No Content
400Bad Request
403Forbidden
404Not Found
500Internal Server Error

Detach volume from project

POST

/rpc/detach-volume-from-project

Description

Detach volume from project

Body Parameter
NameDescriptionRequired
server.UpdateVolumeProjectProject ID to detach from Volume ID server.UpdateVolumeProject

Responses
CodeMessageDatatype
204No Content
400Bad Request
403Forbidden
404Not Found
500Internal Server Error

Get volume mounts by project ID

POST

/rpc/get-volume-mounts

Description

Get volume and snapshot mounts by project ID and optional data plane ID or volume ID

Body Parameter
NameDescriptionRequired
server.ListVolumeMountsRequestFilters to apply to returned volume mounts server.ListVolumeMountsRequest

Responses
CodeMessageDatatype
200OK
400Bad Request
403Forbidden
404Not Found
500Internal Server Error

Mark volume for deletion

POST

/rpc/mark-volume-for-deletion

Description

Mark volume for deletion

Body Parameter
NameDescriptionRequired
server.VolumeIDRequestVolume ID to mark for deletion server.VolumeIDRequest

Responses
CodeMessageDatatype
204No Content
400Bad Request
403Forbidden
404Not Found
500Internal Server Error

Restore volume to active state

POST

/rpc/restore-volume

Description

Restore volume to active state

Body Parameter
NameDescriptionRequired
server.VolumeIDRequestVolume ID to restore to active state server.VolumeIDRequest

Responses
CodeMessageDatatype
204No Content
400Bad Request
403Forbidden
404Not Found
500Internal Server Error

Get domino staging volume name

GET

/staging-volume

Description

Get domino staging volume name

Responses
CodeMessageDatatype
200OK
400Bad Request
403Forbidden
404Not Found
500Internal Server Error

List volumes

GET

/volumes

Description

List volumes

Parameters
NameDescriptionRequiredTypeIn
limitLimitintegerquery
offsetOffsetintegerquery
orderOrderstringquery
searchSearchstringquery
sort_bySort bystringquery
filter_strictly_by_volume_rolesFilter strictly by volume rolesbooleanquery
project_idProject IDList of stringquery
data_plane_idData Plane IDList of stringquery
statusStatusList of stringquery
Responses
CodeMessageDatatype
200OK
400Bad Request
403Forbidden
404Not Found
500Internal Server Error

Create new volume

POST

/volumes

Description

Create new volume

Body Parameter
NameDescriptionRequired
server.CreateVolumeRequestVolume to create server.CreateVolumeRequest

Responses
CodeMessageDatatype
200OK
400Bad Request
403Forbidden
404Not Found
500Internal Server Error

Get volume by ID

GET

/volumes/{id}

Description

Get volume by ID

Parameters
NameDescriptionRequiredTypeIn
idID of volume to retrievestringpath
Responses
CodeMessageDatatype
200OK
400Bad Request
403Forbidden
404Not Found
500Internal Server Error

Update Volume

PATCH

/volumes/{id}

Description

Update Volume

Parameters
NameDescriptionRequiredTypeIn
idID of volume to retrievestringpath
Body Parameter
NameDescriptionRequired
server.UpdateVolumeRequestName and description fields to update server.UpdateVolumeRequest

Responses
CodeMessageDatatype
200OK
400Bad Request
403Forbidden
404Not Found
500Internal Server Error

Get the connection snippets for a given volume to access as a datasource

GET

/volumes/{id}/connection-snippets

Description

Get the connection snippets for a given volume to access as a datasource

Parameters
NameDescriptionRequiredTypeIn
idVolume IDstringpath
Responses
CodeMessageDatatype
200OK
400Bad Request
403Forbidden
404Not Found
500Internal Server Error

Get grants by Volume ID

GET

/volumes/{id}/grants

Description

Get grants by Volume ID

Parameters
NameDescriptionRequiredTypeIn
idID of volume to retrieve grants fromstringpath
Responses
CodeMessageDatatype
200OK
400Bad Request
403Forbidden
404Not Found
500Internal Server Error

Update grants by Volume ID

PUT

/volumes/{id}/grants

Description

Update grants by Volume ID

Parameters
NameDescriptionRequiredTypeIn
idID of volume to update grantsstringpath
Body Parameter
NameDescriptionRequired
remotefs.VolumeGrantDTONew grants to replace current volume grants

Responses
CodeMessageDatatype
200OK
400Bad Request
403Forbidden
404Not Found
500Internal Server Error

Get a volume by unique name

GET

/volumes/unique-name/{uniqueName}

Description

Get a volume by unique name

Parameters
NameDescriptionRequiredTypeIn
uniqueNameUnique name of volume to retrievestringpath
Responses
CodeMessageDatatype
200OK
400Bad Request
403Forbidden
404Not Found
500Internal Server Error

Data transfers

Create new data transfer

POST

/data-transfers

Description

Create new data transfer

Body Parameter
NameDescriptionRequired
server.CreateDataTransferData transfer to create server.CreateDataTransfer

Responses
CodeMessageDatatype
200OK
400Bad Request
403Forbidden
404Not Found
409Conflict
423Locked
500Internal Server Error

Get data transfer by ID

GET

/data-transfers/{id}

Description

Get data transfer by ID

Parameters
NameDescriptionRequiredTypeIn
idID of data transfer to retrievestringpath
Responses
CodeMessageDatatype
200OK
400Bad Request
403Forbidden
404Not Found
500Internal Server Error

Callback for data transfer from filetask

POST

/data-transfers/{id}/callback

Description

Callback for data transfer from filetask

Parameters
NameDescriptionRequiredTypeIn
idID of data transfer targetted for callback from filetaskstringpath
Responses
CodeMessageDatatype
200OK
400Bad Request
403Forbidden
404Not Found
500Internal Server Error

Downloads

Create download archive

POST

/downloads

Description

Create download archive

Body Parameter
NameDescriptionRequired
server.CreateDownloadArchiveRequestCreate download request server.CreateDownloadArchiveRequest

Responses
CodeMessageDatatype
200OK
400Bad Request
403Forbidden
404Not Found
500Internal Server Error

Get download task status

GET

/downloads/{id}

Description

Get download task status

Parameters
NameDescriptionRequiredTypeIn
idID of downloads taskstringpath
volume_idID of volume download task originates fromstringquery
Responses
CodeMessageDatatype
200OK
400Bad Request
403Forbidden
404Not Found
500Internal Server Error

Filesystems

List filesystem

GET

/filesystems

Description

List filesystem

Parameters
NameDescriptionRequiredTypeIn
limitLimitintegerquery
offsetOffsetintegerquery
orderOrderstringquery
searchSearchstringquery
sort_bySort bystringquery
data_plane_idData Plane IDList of stringquery
Responses
CodeMessageDatatype
200OK
400Bad Request
403Forbidden
404Not Found
500Internal Server Error

Create new filesystem

POST

/filesystems

Description

Create new filesystem

Body Parameter
NameDescriptionRequired
server.FilesystemFilesystem to create server.Filesystem

Responses
CodeMessageDatatype
200OK
400Bad Request
403Forbidden
404Not Found
500Internal Server Error

Get filesystem by ID

GET

/filesystems/{id}

Description

Get filesystem by ID

Parameters
NameDescriptionRequiredTypeIn
idID of filesystem to retrievestringpath
include_hostnameWhether to include the data plane host name in responsebooleanquery
Responses
CodeMessageDatatype
200OK
400Bad Request
403Forbidden
404Not Found
500Internal Server Error

Update filesystem

PUT

/filesystems/{id}

Description

Update a filesystem. Can be updated if there are volumes associated with the filesystem

Parameters
NameDescriptionRequiredTypeIn
idID of filesystem to updatestringpath
Body Parameter
NameDescriptionRequired
server.FilesystemFilesystem to update server.Filesystem

Responses
CodeMessageDatatype
200OK
400Bad Request
403Forbidden
404Not Found
500Internal Server Error

Delete filesystem by ID

DELETE

/filesystems/{id}

Description

Delete a filesystem by ID

Parameters
NameDescriptionRequiredTypeIn
idID of filesystem to deletestringpath
Responses
CodeMessageDatatype
204No Content
400Bad Request
403Forbidden
404Not Found
500Internal Server Error

List available PVCs in the domino-compute namespace with the netapp-storage label

GET

/root-pvcs

Description

List available PVCs in the domino-compute namespace with the netapp-storage label

Parameters
NameDescriptionRequiredTypeIn
data_plane_idData Plane IDstringquery
Responses
CodeMessageDatatype
200OK
400Bad Request
403Forbidden
404Not Found
500Internal Server Error

Snapshots

Create new snapshot from a run

POST

/rpc/create-snapshot-from-run

Description

Create new snapshot from a volumes mounted in a run, must be called by super user

Body Parameter
NameDescriptionRequired
server.CreateSnapshotFromRunSnapshot to create from run ID server.CreateSnapshotFromRun

Responses
CodeMessageDatatype
200OK
400Bad Request
403Forbidden
404Not Found
409Conflict
423Locked
500Internal Server Error

Delete snapshot by ID

POST

/rpc/delete-snapshot

Description

Delete a snapshot by ID

Body Parameter
NameDescriptionRequired
server.SnapshotIDRequestSnapshot ID to delete server.SnapshotIDRequest

Responses
CodeMessageDatatype
204No Content
400Bad Request
403Forbidden
404Not Found
500Internal Server Error

Restore snapshot to active state

POST

/rpc/restore-snapshot

Description

Restore snapshot to active state

Body Parameter
NameDescriptionRequired
server.SnapshotIDRequestSnapshot ID to restore to active state server.SnapshotIDRequest

Responses
CodeMessageDatatype
204No Content
400Bad Request
403Forbidden
404Not Found
500Internal Server Error

List snapshots

GET

/snapshots

Description

List snapshots

Parameters
NameDescriptionRequiredTypeIn
limitLimitintegerquery
offsetOffsetintegerquery
orderOrderstringquery
searchSearchstringquery
sort_bySort bystringquery
volume_idVolume IDList of stringquery
run_idVolume IDList of stringquery
Responses
CodeMessageDatatype
200OK
400Bad Request
403Forbidden
404Not Found
500Internal Server Error

Create new snapshot

POST

/snapshots

Description

Create new snapshot

Body Parameter
NameDescriptionRequired
server.CreateSnapshotSnapshot to create server.CreateSnapshot

Responses
CodeMessageDatatype
200OK
400Bad Request
403Forbidden
404Not Found
409Conflict
423Locked
500Internal Server Error

Get snapshot by ID

GET

/snapshots/{id}

Description

Get snapshot by ID

Parameters
NameDescriptionRequiredTypeIn
idID of snapshot to retrievestringpath
Responses
CodeMessageDatatype
200OK
400Bad Request
403Forbidden
404Not Found
500Internal Server Error

Update Snapshot by ID

PUT

/snapshots/{id}

Description

Update Snapshot by ID

Parameters
NameDescriptionRequiredTypeIn
idID of Snapshot to updatestringpath
Body Parameter
NameDescriptionRequired
server.UpdateSnapshotSnapshot to update server.UpdateSnapshot

Responses
CodeMessageDatatype
200OK
400Bad Request
403Forbidden
404Not Found
500Internal Server Error

Add snapshot tag

POST

/snapshots/{id}/tags

Description

Add a tag to a snapshot

Parameters
NameDescriptionRequiredTypeIn
idID of snapshot to add tag tostringpath
Body Parameter
NameDescriptionRequired
server.CreateSnapshotTagRequestSnapshot tag to add server.CreateSnapshotTagRequest

Responses
CodeMessageDatatype
204No Content
400Bad Request
403Forbidden
404Not Found
500Internal Server Error

Delete snapshot tag

DELETE

/snapshots/{id}/tags/{name}

Description

Delete a tag from a snapshot

Parameters
NameDescriptionRequiredTypeIn
idID of snapshot to delete tag fromstringpath
nameTag name to delete from snapshotstringpath
Responses
CodeMessageDatatype
204No Content
400Bad Request
403Forbidden
404Not Found
500Internal Server Error

Get snapshot by volume ID and snapshot version

GET

/volumes/{id}/snapshots/{version}

Description

Get snapshot by volume ID and snapshot version

Parameters
NameDescriptionRequiredTypeIn
idVolume IDstringpath
versionSnapshot versionintegerpath
Responses
CodeMessageDatatype
200OK
400Bad Request
403Forbidden
404Not Found
500Internal Server Error

Tasks

Get import blobs task update

GET

/tasks/import-blobs/{key}/update

Description

Get import blobs task update

Parameters
NameDescriptionRequiredTypeIn
keyKey of import blobs taskstringpath
Responses
CodeMessageDatatype
200OK
400Bad Request
403Forbidden
404Not Found
500Internal Server Error

Models

remotefs.Action

TypeExample

string

copy

remotefs.ConnectionSnippet

Field NameRequiredType
language
remotefs.SnippetLanguage
snippet
String

remotefs.DataTransfer

Field NameRequiredType
createdAt
String
createdBy
remotefs.UserSummary
destinationVolumeId
String
filetaskKey
String
id
String
labels
Object<String>
status
remotefs.DataTransferStatus
taskUpdate
remotefs.TaskUpdate
type
remotefs.DataTransferType
updatedAt
String
updatedBy
remotefs.UserSummary

remotefs.DataTransferStatus

TypeExample

string

Failed
Started
Succeeded

remotefs.DataTransferType

TypeExample

string

flows-artifact-export

remotefs.FileCollisionSetting

TypeExample

string

Rename
Overwrite
Ignore

remotefs.Filesystem

Field NameRequiredTypeDescription
createdAt
String
createdBy
remotefs.UserSummary
dataPlaneId
String
dataPlaneName
String
hostname
StringData plane prefix (e.g. mydp1029), "" for local data plane
id
String
isDataPlaneDefault
Boolean
maxSnapshotsPerVolume
Integer
name
String
numVolumes
Integer
rootPvc
String
storageClass
String
updatedAt
String
updatedBy
remotefs.UserSummary

remotefs.FiletaskTask

Field NameRequiredType
id
String
key
String
status
String
update
remotefs.TaskUpdate

remotefs.Filter

Field NameRequiredType
key
String
values
List of string

remotefs.FlowsArtifactVersionKey

Field NameRequiredType
artifactId
String
execution
remotefs.FlowsExecutionIdentifier

remotefs.FlowsExecutionIdentifier

Field NameRequiredType
domain
String
name
String
project
String

remotefs.Meta

Field NameRequiredType
filters
order
String
pagination
remotefs.Pagination
search
String
sortBy
String

remotefs.Pagination

Field NameRequiredType
limit
Integer
offset
Integer
totalCount
Integer

remotefs.Permission

TypeExample

string

ManageFilesystems
ViewFilesystems
CreateVolumes
ManageVolumesForExecution
ManageVolumes
ReadVolumes
ViewVolumes
MarkVolumesForDeletion
DeleteVolumes
EditSecurityVolumes
WorkbenchPermission.PerformNetAppActionsInProject
ReadUserPermissions
ImpersonateUser

remotefs.PermissionCode

TypeExample

string

data.manage_filesystems
data.view_filesystems
data.create_volumes
data.manage_volumes
data.manage_volumes_for_execution
data.read_volumes
data.view_volumes
data.mark_volumes_for_deletion
data.delete_volumes
data.edit_security_volumes
data.project.perform_net_app_actions_in_project

remotefs.Project

Field NameRequiredTypeDescription
addedAt
String
addedBy
remotefs.UserSummary
name
String
projectId
StringReferences Mongo project ID
volumeId
String

remotefs.ResourceStatus

TypeExample

string

Active
MarkedForDeletion
Deleted

remotefs.Snapshot

Field NameRequiredTypeDescription
createdAt
String
createdBy
remotefs.UserSummary
description
String
id
String
labels
Object<String>System-specified, e.g. for Flows artifacts
lastMountedTime
String
runId
StringOptional field denoting resource associated with a run
status
remotefs.ResourceStatus
tags
User-specified, used for mount path resolution and is derived from SnapshotTags
updatedAt
String
updatedBy
remotefs.UserSummary
version
IntegerLinks to ONTAP snapshot name
volumeId
String

remotefs.SnapshotTag

Field NameRequiredType
addedAt
String
addedBy
remotefs.UserSummary
name
String

remotefs.SnapshotTagSubPath

Field NameRequiredType
subPath
String
tagName
String

remotefs.SnippetLanguage

TypeExample

string

R
Python

remotefs.TaskUpdate

Field NameRequiredType
exportTargetId
String
key
remotefs.FlowsArtifactVersionKey
progress
Integer
tags
Object<String>
type
String
uri
String

remotefs.UserSummary

Field NameRequiredType
firstName
String
id
String
lastName
String
userName
String

remotefs.Volume

Field NameRequiredTypeDescription
capacity
IntegerMaximum size in bytes
createdAt
String
createdBy
remotefs.UserSummary
dataPlaneId
String
description
String
filesystemId
String
filesystemName
String
grants
id
StringLinks to ONTAP volume name
lastMountedTime
String
maxSnapshots
Integer
name
String
numSnapshots
Integer
path
String
projects
status
remotefs.ResourceStatus
storageSize
IntegerUsed size in bytes
uniqueName
String
updatedAt
String
updatedBy
remotefs.UserSummary

remotefs.VolumeCopyDTO

Field NameRequiredType
grants
sourceVolumeId
String

remotefs.VolumeGrant

Field NameRequiredTypeDescription
isOrganization
Boolean
targetId
StringReferences Mongo user ID (including organizations)
targetName
String
targetRole
remotefs.VolumeRole

remotefs.VolumeGrantDTO

Field NameRequiredType
targetId
String
targetRole
remotefs.VolumeRole

remotefs.VolumeMount

Field NameRequiredType
canUserWrite
Boolean
latestSnapshotTagSubPaths
name
String
persistentVolumeClaimName
String
snapshotSubPath
String
subPath
String
volumeId
String

remotefs.VolumeRole

TypeExample

string

VolumeOwner
VolumeEditor
VolumeReader
Service

server.BulkCopyVolumesRequest

Field NameRequiredType
projectId
String
volumes

server.CopyVolumeOperationResult

Field NameRequiredType
action
remotefs.Action
data
remotefs.Volume
error
String
sourceVolumeId
String
status
Integer

server.CopyVolumeOperationResults

Field NameRequiredType
results

server.CreateDataTransfer

Field NameRequiredType
destinationVolumeId
String
fileCollisionSetting
remotefs.FileCollisionSetting
payload
String
targetRelativePath
String
type
remotefs.DataTransferType

server.CreateDownloadArchiveRequest

Field NameRequiredType
relativePaths
List of string
snapshotId
String
volumeId
String

server.CreateSnapshot

Field NameRequiredType
description
String
tagNames
List of string
volumeId
String

server.CreateSnapshotFromRun

Field NameRequiredTypeDescription
description
String
runId
StringRun ID associated with the snapshot
userId
StringUser that initiated the run, set as snapshot creator
volumeId
String

server.CreateSnapshotTagRequest

Field NameRequiredType
name
String

server.CreateVolumeRequest

Field NameRequiredType
capacity
Integer
description
String
filesystemId
String
grants
name
String
projectId
String

server.Filesystem

Field NameRequiredType
dataPlaneId
String
isDataPlaneDefault
Boolean
maxSnapshotsPerVolume
Integer
name
String
rootPvc
String
storageClass
String

server.HTTPError

Field NameRequiredType
message
String

server.ListVolumeMountsRequest

Field NameRequiredType
dataPlaneIds
List of string
projectIds
List of string
volumeIds
List of string

server.PaginatedFilesystems

Field NameRequiredType
data
meta
remotefs.Meta

server.PaginatedSnapshots

Field NameRequiredType
data
meta
remotefs.Meta

server.PaginatedVolumes

Field NameRequiredType
data
meta
remotefs.Meta

server.PermissionInfo

Field NameRequiredType
code
remotefs.PermissionCode
context
server.PermissionInfoContext
id
String

server.PermissionInfoContext

Field NameRequiredType
projectId
String
volumeId
String

server.PermissionRequest

Field NameRequiredTypeDescription
actions
Effectively checking permissions, but using "actions" to be consistent with the rest of the API

server.PermissionResponse

Field NameRequiredTypeDescription
actions
Effectively are permissions, using "actions" for consistency

server.PermissionResponseInfo

Field NameRequiredType
code
remotefs.PermissionCode
id
String
result
Boolean

server.Principal

Field NameRequiredType
token
String

server.SnapshotIDRequest

Field NameRequiredType
snapshotId
String

server.UpdateSnapshot

Field NameRequiredType
description
String

server.UpdateVolumeProject

Field NameRequiredType
projectId
String
volumeId
String

server.UpdateVolumeRequest

Field NameRequiredType
description
String
name
String

server.VolumeIDRequest

Field NameRequiredType
volumeId
String

server.VolumePermissionsRequest

Field NameRequiredType
mustHave
principal
server.Principal