Projects and members

Overview

Use the following commands to manage your projects and project members on the Seven Bridges Platform.

projects create

Create a new project with a desired name and a chosen billing group.

Usage: sb projects create --name <name_value> --billing_group <billing_group_value> [--description <description_value>] [--locked <locked_value>] [flags] Flags: --name string The name given to a new project. --billing_group string The ID of the billing group for the project. --description string A human-readable description of the project. --locked string Prevents any Seven Bridges team member from viewing the project. (default "no") -h, --help help for create

projects list

List the projects accessible to the current user.

Usage: sb projects list [--user <user_value>] [flags] Flags: --user string List only projects owned by the specified user. -h, --help help for list

projects get

Get details of the specified project. Note that the project_id takes the form of {project_owner}/{project}, where {project_owner} is the username of the user who created the project and {project} is not the project's full given name, but its [short name](doc:the-api#project-short-name.

Usage: sb projects get <project_id> [flags] Arguments: project_id ID of the project. Flags: -h, --help help for get

projects update

Change the name, description, or billing group of a project. Note that the project_id takes the form of {project_owner}/{project}, where {project_owner} is the username of the user who created the project and that {project} is not the project's full given name but its short name.

Usage: sb projects update <project_id> [--name <name_value>] [--billing_group <billing_group_value>] [--description <description_value>] [--locked <locked_value>] [flags] Arguments: project_id ID of the project. Flags: --name string The new name given to the project. --billing_group string The ID of the new billing group for the project. --description string A human-readable new description of the project. --locked string Prevents any Seven Bridges team member from viewing the project. (default "no") -h, --help help for update

projects delete

Delete a project from the Platform. Note that this completely erases the project and any related data.

Usage: sb projects delete <project_id> [flags] Arguments: project_id ID of the project. Flags: -h, --help help for delete

members create

Add an existing member to the specified project with appropriate permissions. This request can only be successfully made by a user who has admin permissions in the project.

Users may have the following permissions on the Platform:

  • Read
  • Write
  • Copy
  • Execute
  • Admin
Usage: sb members create --project <project_value> --user <user_value> [--read] [--write] [--copy] [--execute] [--admin] [flags] Flags: --project string The ID of the project you are adding a new member to. --user string The username of the person you are adding to the project. --read The member can view file names, metadata, and workflows. This is automatically assigned when a member is created. (default true) --write The member can add, modify, and remove files and workflows. --copy The member can view file content, copy, and download files. --execute The member can execute workflows and abort tasks. --admin The member can modify another user's permissions, add or remove people, and manage funding sources.

members list

Get a list of the members of the specified project.

Usage: sb members list --project <project_value> [flags] Flags: --project string The project for which to return the list of members. -h, --help help for list

members get

Get member permissions for a given project.

Users may have the following permissions on the Seven Bridges Platform:

  • Read
  • Write
  • Copy
  • Execute
  • Admin

Permissions are granted at the project-level. You may, for instance, have admin permission in one project, execute permission in another, and read-only permission in a third.

Usage: sb members get --project <project_value> --user <user_value> [flags] Flags: --project string The ID of the project containing the member(s) whose permissions you are querying. --user string The username of the member whose permissions you are querying. -h, --help help for get

members update

Update a project member's permission for the specified project. It can only be successfully made if you have admin status for the project.

Usage: sb members update --project <project_value> --user <user_value> [--read] [--write] [--copy] [--execute] [--admin] [flags] Flags: --project string The ID of the project containing the member whose permissions you’d like to update. --user string The username of the project member whose permissions you are updating. --read This permission allows a project member to view file names, metadata, and workflows. Read permissions are assigned by default. (default true) --write This permission allows a project member to add, modify, and remove files and workflows. --copy This permission allows a project member to view file content, copy, and download files. --execute This permission allows a project member to execute workflows and abort tasks. --admin This permission allows a project member to modify another user's permissions, add or remove people, and manage funding sources. -h, --help help for update

members delete

Remove a member from the specified project. This command can only be successfully run by a user who has admin privileges in the specified project.

Usage: sb members delete --project <project_value> --user <user_value> [flags] Flags: --project string The ID of the project from which you are removing a member. --user string The username of the member you are removing. -h, --help help for delete