/account/authz/permissions/authorizedactions
Description
Gets all permissions for requesting user with optional volume ID or project ID in context field
Body Parameter
| Name | Description | Required |
|---|---|---|
server.PermissionRequest | Permissions to check user against server.PermissionRequest |
Responses
| Code | Message | Datatype |
|---|---|---|
| 200 | OK | |
| 400 | Bad Request | |
| 403 | Forbidden | |
| 404 | Not Found | |
| 500 | Internal Server Error |
/account/authz/permissions/volume/:id
Description
Get if user has all provided volume permissions
Parameters
| Name | Description | Required | Type | In |
|---|---|---|---|---|
id | ID of Volume to check permissions against | string | path |
Body Parameter
| Name | Description | Required |
|---|---|---|
server.VolumePermissionsRequest | Volume permissions and user to check against server.VolumePermissionsRequest |
Responses
| Code | Message | Datatype |
|---|---|---|
| 200 | OK | |
| 400 | Bad Request | |
| 403 | Forbidden | |
| 404 | Not Found | |
| 500 | Internal Server Error |
/rpc/attach-volume-to-project
Description
Attach volume to project
Body Parameter
| Name | Description | Required |
|---|---|---|
server.UpdateVolumeProject | Project ID to attach to Volume ID server.UpdateVolumeProject |
Responses
| Code | Message | Datatype |
|---|---|---|
| 204 | No Content | |
| 400 | Bad Request | |
| 403 | Forbidden | |
| 404 | Not Found | |
| 500 | Internal Server Error |
/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
| Name | Description | Required |
|---|---|---|
server.BulkCopyVolumesRequest | Volume IDs to copy and target Project ID server.BulkCopyVolumesRequest |
Responses
| Code | Message | Datatype |
|---|---|---|
| 200 | OK | |
| 400 | Bad Request | |
| 403 | Forbidden | |
| 404 | Not Found | |
| 500 | Internal Server Error |
/rpc/delete-volume
Description
Delete a volume by ID
Body Parameter
| Name | Description | Required |
|---|---|---|
server.VolumeIDRequest | Volume ID to delete server.VolumeIDRequest |
Responses
| Code | Message | Datatype |
|---|---|---|
| 204 | No Content | |
| 400 | Bad Request | |
| 403 | Forbidden | |
| 404 | Not Found | |
| 500 | Internal Server Error |
/rpc/detach-volume-from-project
Description
Detach volume from project
Body Parameter
| Name | Description | Required |
|---|---|---|
server.UpdateVolumeProject | Project ID to detach from Volume ID server.UpdateVolumeProject |
Responses
| Code | Message | Datatype |
|---|---|---|
| 204 | No Content | |
| 400 | Bad Request | |
| 403 | Forbidden | |
| 404 | Not Found | |
| 500 | Internal Server Error |
/rpc/get-volume-mounts
Description
Get volume and snapshot mounts by project ID and optional data plane ID or volume ID
Body Parameter
| Name | Description | Required |
|---|---|---|
server.ListVolumeMountsRequest | Filters to apply to returned volume mounts server.ListVolumeMountsRequest |
Responses
| Code | Message | Datatype |
|---|---|---|
| 200 | OK | |
| 400 | Bad Request | |
| 403 | Forbidden | |
| 404 | Not Found | |
| 500 | Internal Server Error |
/rpc/mark-volume-for-deletion
Description
Mark volume for deletion
Body Parameter
| Name | Description | Required |
|---|---|---|
server.VolumeIDRequest | Volume ID to mark for deletion server.VolumeIDRequest |
Responses
| Code | Message | Datatype |
|---|---|---|
| 204 | No Content | |
| 400 | Bad Request | |
| 403 | Forbidden | |
| 404 | Not Found | |
| 500 | Internal Server Error |
/rpc/restore-volume
Description
Restore volume to active state
Body Parameter
| Name | Description | Required |
|---|---|---|
server.VolumeIDRequest | Volume ID to restore to active state server.VolumeIDRequest |
Responses
| Code | Message | Datatype |
|---|---|---|
| 204 | No Content | |
| 400 | Bad Request | |
| 403 | Forbidden | |
| 404 | Not Found | |
| 500 | Internal Server Error |
/volumes
Description
List volumes
Parameters
| Name | Description | Required | Type | In |
|---|---|---|---|---|
limit | Limit | integer | query | |
offset | Offset | integer | query | |
order | Order | string | query | |
search | Search | string | query | |
sort_by | Sort by | string | query | |
filter_strictly_by_volume_roles | Filter strictly by volume roles | boolean | query | |
project_id | Project ID | List of string | query | |
data_plane_id | Data Plane ID | List of string | query | |
status | Status | List of string | query |
Responses
| Code | Message | Datatype |
|---|---|---|
| 200 | OK | |
| 400 | Bad Request | |
| 403 | Forbidden | |
| 404 | Not Found | |
| 500 | Internal Server Error |
/volumes
Description
Create new volume
Body Parameter
| Name | Description | Required |
|---|---|---|
server.CreateVolumeRequest | Volume to create server.CreateVolumeRequest |
Responses
| Code | Message | Datatype |
|---|---|---|
| 200 | OK | |
| 400 | Bad Request | |
| 403 | Forbidden | |
| 404 | Not Found | |
| 500 | Internal Server Error |
/volumes/{id}
Description
Get volume by ID
Parameters
| Name | Description | Required | Type | In |
|---|---|---|---|---|
id | ID of volume to retrieve | string | path |
Responses
| Code | Message | Datatype |
|---|---|---|
| 200 | OK | |
| 400 | Bad Request | |
| 403 | Forbidden | |
| 404 | Not Found | |
| 500 | Internal Server Error |
/volumes/{id}
Description
Update Volume
Parameters
| Name | Description | Required | Type | In |
|---|---|---|---|---|
id | ID of volume to retrieve | string | path |
Body Parameter
| Name | Description | Required |
|---|---|---|
server.UpdateVolumeRequest | Name and description fields to update server.UpdateVolumeRequest |
Responses
| Code | Message | Datatype |
|---|---|---|
| 200 | OK | |
| 400 | Bad Request | |
| 403 | Forbidden | |
| 404 | Not Found | |
| 500 | Internal Server Error |
/volumes/{id}/connection-snippets
Description
Get the connection snippets for a given volume to access as a datasource
Parameters
| Name | Description | Required | Type | In |
|---|---|---|---|---|
id | Volume ID | string | path |
Responses
| Code | Message | Datatype |
|---|---|---|
| 200 | OK | |
| 400 | Bad Request | |
| 403 | Forbidden | |
| 404 | Not Found | |
| 500 | Internal Server Error |
/volumes/{id}/grants
Description
Get grants by Volume ID
Parameters
| Name | Description | Required | Type | In |
|---|---|---|---|---|
id | ID of volume to retrieve grants from | string | path |
Responses
| Code | Message | Datatype |
|---|---|---|
| 200 | OK | |
| 400 | Bad Request | |
| 403 | Forbidden | |
| 404 | Not Found | |
| 500 | Internal Server Error |
/volumes/{id}/grants
Description
Update grants by Volume ID
Responses
| Code | Message | Datatype |
|---|---|---|
| 200 | OK | |
| 400 | Bad Request | |
| 403 | Forbidden | |
| 404 | Not Found | |
| 500 | Internal Server Error |
/data-transfers
Description
Create new data transfer
Body Parameter
| Name | Description | Required |
|---|---|---|
server.CreateDataTransfer | Data transfer to create server.CreateDataTransfer |
Responses
| Code | Message | Datatype |
|---|---|---|
| 200 | OK | |
| 400 | Bad Request | |
| 403 | Forbidden | |
| 404 | Not Found | |
| 409 | Conflict | |
| 423 | Locked | |
| 500 | Internal Server Error |
/data-transfers/{id}/callback
Description
Callback for data transfer from filetask
Parameters
| Name | Description | Required | Type | In |
|---|---|---|---|---|
id | ID of data transfer targetted for callback from filetask | string | path |
Responses
| Code | Message | Datatype |
|---|---|---|
| 200 | OK | |
| 400 | Bad Request | |
| 403 | Forbidden | |
| 404 | Not Found | |
| 500 | Internal Server Error |
/downloads
Description
Create download archive
Body Parameter
| Name | Description | Required |
|---|---|---|
server.CreateDownloadArchiveRequest | Create download request server.CreateDownloadArchiveRequest |
Responses
| Code | Message | Datatype |
|---|---|---|
| 200 | OK | |
| 400 | Bad Request | |
| 403 | Forbidden | |
| 404 | Not Found | |
| 500 | Internal Server Error |
/downloads/{id}
Description
Get download task status
Parameters
| Name | Description | Required | Type | In |
|---|---|---|---|---|
id | ID of downloads task | string | path | |
volume_id | ID of volume download task originates from | string | query |
Responses
| Code | Message | Datatype |
|---|---|---|
| 200 | OK | |
| 400 | Bad Request | |
| 403 | Forbidden | |
| 404 | Not Found | |
| 500 | Internal Server Error |
/filesystems
Description
List filesystem
Parameters
| Name | Description | Required | Type | In |
|---|---|---|---|---|
limit | Limit | integer | query | |
offset | Offset | integer | query | |
order | Order | string | query | |
search | Search | string | query | |
sort_by | Sort by | string | query | |
data_plane_id | Data Plane ID | List of string | query |
Responses
| Code | Message | Datatype |
|---|---|---|
| 200 | OK | |
| 400 | Bad Request | |
| 403 | Forbidden | |
| 404 | Not Found | |
| 500 | Internal Server Error |
/filesystems
Description
Create new filesystem
Body Parameter
| Name | Description | Required |
|---|---|---|
server.Filesystem | Filesystem to create server.Filesystem |
Responses
| Code | Message | Datatype |
|---|---|---|
| 200 | OK | |
| 400 | Bad Request | |
| 403 | Forbidden | |
| 404 | Not Found | |
| 500 | Internal Server Error |
/filesystems/{id}
Description
Get filesystem by ID
Parameters
| Name | Description | Required | Type | In |
|---|---|---|---|---|
id | ID of filesystem to retrieve | string | path | |
include_hostname | Whether to include the data plane host name in response | boolean | query |
Responses
| Code | Message | Datatype |
|---|---|---|
| 200 | OK | |
| 400 | Bad Request | |
| 403 | Forbidden | |
| 404 | Not Found | |
| 500 | Internal Server Error |
/filesystems/{id}
Description
Update a filesystem. Can be updated if there are volumes associated with the filesystem
Parameters
| Name | Description | Required | Type | In |
|---|---|---|---|---|
id | ID of filesystem to update | string | path |
Body Parameter
| Name | Description | Required |
|---|---|---|
server.Filesystem | Filesystem to update server.Filesystem |
Responses
| Code | Message | Datatype |
|---|---|---|
| 200 | OK | |
| 400 | Bad Request | |
| 403 | Forbidden | |
| 404 | Not Found | |
| 500 | Internal Server Error |
/root-pvcs
Description
List available PVCs in the domino-compute namespace with the netapp-storage label
Parameters
| Name | Description | Required | Type | In |
|---|---|---|---|---|
data_plane_id | Data Plane ID | string | query |
Responses
| Code | Message | Datatype |
|---|---|---|
| 200 | OK | |
| 400 | Bad Request | |
| 403 | Forbidden | |
| 404 | Not Found | |
| 500 | Internal Server Error |
/rpc/create-snapshot-from-run
Description
Create new snapshot from a volumes mounted in a run, must be called by super user
Body Parameter
| Name | Description | Required |
|---|---|---|
server.CreateSnapshotFromRun | Snapshot to create from run ID server.CreateSnapshotFromRun |
Responses
| Code | Message | Datatype |
|---|---|---|
| 200 | OK | |
| 400 | Bad Request | |
| 403 | Forbidden | |
| 404 | Not Found | |
| 409 | Conflict | |
| 423 | Locked | |
| 500 | Internal Server Error |
/rpc/delete-snapshot
Description
Delete a snapshot by ID
Body Parameter
| Name | Description | Required |
|---|---|---|
server.SnapshotIDRequest | Snapshot ID to delete server.SnapshotIDRequest |
Responses
| Code | Message | Datatype |
|---|---|---|
| 204 | No Content | |
| 400 | Bad Request | |
| 403 | Forbidden | |
| 404 | Not Found | |
| 500 | Internal Server Error |
/rpc/restore-snapshot
Description
Restore snapshot to active state
Body Parameter
| Name | Description | Required |
|---|---|---|
server.SnapshotIDRequest | Snapshot ID to restore to active state server.SnapshotIDRequest |
Responses
| Code | Message | Datatype |
|---|---|---|
| 204 | No Content | |
| 400 | Bad Request | |
| 403 | Forbidden | |
| 404 | Not Found | |
| 500 | Internal Server Error |
/snapshots
Description
List snapshots
Parameters
| Name | Description | Required | Type | In |
|---|---|---|---|---|
limit | Limit | integer | query | |
offset | Offset | integer | query | |
order | Order | string | query | |
search | Search | string | query | |
sort_by | Sort by | string | query | |
volume_id | Volume ID | List of string | query | |
run_id | Volume ID | List of string | query |
Responses
| Code | Message | Datatype |
|---|---|---|
| 200 | OK | |
| 400 | Bad Request | |
| 403 | Forbidden | |
| 404 | Not Found | |
| 500 | Internal Server Error |
/snapshots
Description
Create new snapshot
Body Parameter
| Name | Description | Required |
|---|---|---|
server.CreateSnapshot | Snapshot to create server.CreateSnapshot |
Responses
| Code | Message | Datatype |
|---|---|---|
| 200 | OK | |
| 400 | Bad Request | |
| 403 | Forbidden | |
| 404 | Not Found | |
| 409 | Conflict | |
| 423 | Locked | |
| 500 | Internal Server Error |
/snapshots/{id}
Description
Get snapshot by ID
Parameters
| Name | Description | Required | Type | In |
|---|---|---|---|---|
id | ID of snapshot to retrieve | string | path |
Responses
| Code | Message | Datatype |
|---|---|---|
| 200 | OK | |
| 400 | Bad Request | |
| 403 | Forbidden | |
| 404 | Not Found | |
| 500 | Internal Server Error |
/snapshots/{id}
Description
Update Snapshot by ID
Parameters
| Name | Description | Required | Type | In |
|---|---|---|---|---|
id | ID of Snapshot to update | string | path |
Body Parameter
| Name | Description | Required |
|---|---|---|
server.UpdateSnapshot | Snapshot to update server.UpdateSnapshot |
Responses
| Code | Message | Datatype |
|---|---|---|
| 200 | OK | |
| 400 | Bad Request | |
| 403 | Forbidden | |
| 404 | Not Found | |
| 500 | Internal Server Error |
/snapshots/{id}/tags
Description
Add a tag to a snapshot
Parameters
| Name | Description | Required | Type | In |
|---|---|---|---|---|
id | ID of snapshot to add tag to | string | path |
Body Parameter
| Name | Description | Required |
|---|---|---|
server.CreateSnapshotTagRequest | Snapshot tag to add server.CreateSnapshotTagRequest |
Responses
| Code | Message | Datatype |
|---|---|---|
| 204 | No Content | |
| 400 | Bad Request | |
| 403 | Forbidden | |
| 404 | Not Found | |
| 500 | Internal Server Error |
/snapshots/{id}/tags/{name}
Description
Delete a tag from a snapshot
Parameters
| Name | Description | Required | Type | In |
|---|---|---|---|---|
id | ID of snapshot to delete tag from | string | path | |
name | Tag name to delete from snapshot | string | path |
Responses
| Code | Message | Datatype |
|---|---|---|
| 204 | No Content | |
| 400 | Bad Request | |
| 403 | Forbidden | |
| 404 | Not Found | |
| 500 | Internal Server Error |
/volumes/{id}/snapshots/{version}
Description
Get snapshot by volume ID and snapshot version
Parameters
| Name | Description | Required | Type | In |
|---|---|---|---|---|
id | Volume ID | string | path | |
version | Snapshot version | integer | path |
Responses
| Code | Message | Datatype |
|---|---|---|
| 200 | OK | |
| 400 | Bad Request | |
| 403 | Forbidden | |
| 404 | Not Found | |
| 500 | Internal Server Error |
| Field Name | Required | Type |
|---|---|---|
| language | remotefs.SnippetLanguage | |
| snippet | String |
| Field Name | Required | Type |
|---|---|---|
| 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 |
| Field Name | Required | Type | Description |
|---|---|---|---|
| createdAt | String | ||
| createdBy | remotefs.UserSummary | ||
| dataPlaneId | String | ||
| dataPlaneName | String | ||
| hostname | String | Data 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 |
| Field Name | Required | Type |
|---|---|---|
| id | String | |
| key | String | |
| status | String | |
| update | remotefs.TaskUpdate |
| Field Name | Required | Type |
|---|---|---|
| artifactId | String | |
| execution | remotefs.FlowsExecutionIdentifier |
| Field Name | Required | Type |
|---|---|---|
| filters | List of remotefs.Filter | |
| order | String | |
| pagination | remotefs.Pagination | |
| search | String | |
| sortBy | String |
| Type | Example |
|---|---|
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 |
| Field Name | Required | Type | Description |
|---|---|---|---|
| addedAt | String | ||
| addedBy | remotefs.UserSummary | ||
| name | String | ||
| projectId | String | References Mongo project ID | |
| volumeId | String |
| Field Name | Required | Type | Description |
|---|---|---|---|
| createdAt | String | ||
| createdBy | remotefs.UserSummary | ||
| description | String | ||
| id | String | ||
| labels | Object<String> | System-specified, e.g. for Flows artifacts | |
| lastMountedTime | String | ||
| runId | String | Optional field denoting resource associated with a run | |
| status | remotefs.ResourceStatus | ||
| tags | List of remotefs.SnapshotTag | User-specified, used for mount path resolution and is derived from SnapshotTags | |
| updatedAt | String | ||
| updatedBy | remotefs.UserSummary | ||
| version | Integer | Links to ONTAP snapshot name | |
| volumeId | String |
| Field Name | Required | Type |
|---|---|---|
| addedAt | String | |
| addedBy | remotefs.UserSummary | |
| name | String |
| Field Name | Required | Type |
|---|---|---|
| exportTargetId | String | |
| key | remotefs.FlowsArtifactVersionKey | |
| progress | Integer | |
| tags | Object<String> | |
| type | String | |
| uri | String |
| Field Name | Required | Type | Description |
|---|---|---|---|
| capacity | Integer | Maximum size in bytes | |
| createdAt | String | ||
| createdBy | remotefs.UserSummary | ||
| dataPlaneId | String | ||
| description | String | ||
| filesystemId | String | ||
| filesystemName | String | ||
| grants | List of remotefs.VolumeGrant | ||
| id | String | Links to ONTAP volume name | |
| lastMountedTime | String | ||
| maxSnapshots | Integer | ||
| name | String | ||
| numSnapshots | Integer | ||
| path | String | ||
| projects | List of remotefs.Project | ||
| status | remotefs.ResourceStatus | ||
| storageSize | Integer | Used size in bytes | |
| uniqueName | String | ||
| updatedAt | String | ||
| updatedBy | remotefs.UserSummary |
| Field Name | Required | Type |
|---|---|---|
| grants | List of remotefs.VolumeGrantDTO | |
| sourceVolumeId | String |
| Field Name | Required | Type | Description |
|---|---|---|---|
| isOrganization | Boolean | ||
| targetId | String | References Mongo user ID (including organizations) | |
| targetName | String | ||
| targetRole | remotefs.VolumeRole |
| Field Name | Required | Type |
|---|---|---|
| targetId | String | |
| targetRole | remotefs.VolumeRole |
| Field Name | Required | Type |
|---|---|---|
| canUserWrite | Boolean | |
| latestSnapshotTagSubPaths | List of remotefs.SnapshotTagSubPath | |
| name | String | |
| persistentVolumeClaimName | String | |
| snapshotSubPath | String | |
| subPath | String | |
| volumeId | String |
| Field Name | Required | Type |
|---|---|---|
| projectId | String | |
| volumes | List of remotefs.VolumeCopyDTO |
| Field Name | Required | Type |
|---|---|---|
| action | remotefs.Action | |
| data | remotefs.Volume | |
| error | String | |
| sourceVolumeId | String | |
| status | Integer |
| Field Name | Required | Type |
|---|---|---|
| results | List of server.CopyVolumeOperationResult |
| Field Name | Required | Type |
|---|---|---|
| destinationVolumeId | String | |
| fileCollisionSetting | remotefs.FileCollisionSetting | |
| payload | String | |
| targetRelativePath | String | |
| type | remotefs.DataTransferType |
| Field Name | Required | Type |
|---|---|---|
| capacity | Integer | |
| description | String | |
| filesystemId | String | |
| grants | List of remotefs.VolumeGrantDTO | |
| name | String | |
| projectId | String |
| Field Name | Required | Type |
|---|---|---|
| data | List of remotefs.Filesystem | |
| meta | remotefs.Meta |
| Field Name | Required | Type |
|---|---|---|
| data | List of remotefs.Snapshot | |
| meta | remotefs.Meta |
| Field Name | Required | Type |
|---|---|---|
| data | List of remotefs.Volume | |
| meta | remotefs.Meta |
| Field Name | Required | Type |
|---|---|---|
| code | remotefs.PermissionCode | |
| context | server.PermissionInfoContext | |
| id | String |
| Field Name | Required | Type | Description |
|---|---|---|---|
| actions | List of server.PermissionInfo | Effectively checking permissions, but using "actions" to be consistent with the rest of the API |
| Field Name | Required | Type | Description |
|---|---|---|---|
| actions | List of server.PermissionResponseInfo | Effectively are permissions, using "actions" for consistency |
| Field Name | Required | Type |
|---|---|---|
| code | remotefs.PermissionCode | |
| id | String | |
| result | Boolean |
| Field Name | Required | Type |
|---|---|---|
| mustHave | List of remotefs.Permission | |
| principal | server.Principal |
