Skip to content

Vendia CLI command - uni

share uni

Manage project operations.

Table of Contents

Commands for share uni

Manage project operations

Usage for share uni

Terminal window
share uni <subcommand>
SubcommandDescription
uni createCreate a new project
uni deletePermanently delete a project
uni evolveEvolve the schema for a project
uni getGet information about a given project
uni inviteInvite a new workspace to join the project
uni joinJoin an existing project
uni listLists all projects in your account
uni openOpen a project in the vendia dev console
uni resetResets project to it’s original state

Examples for share uni

Terminal window
List all project info
share uni list
Get project info
share uni get --uni <uniName>
Create projects
# Register project via JSON file:
share uni:create --config registration.json
# Register project via --config:
share uni:create --config '{"name": "test-UniName", "schema": "schema.json","nodes":[{"name":"NodeName","userId": "email@email.com","region": "us-east-1","csp": "aws"}]}'
Open projects in Browser
share uni open
share uni open --uni <uniName>
Reset project data
share uni reset --uni <uniName>
Delete project
share uni delete --uni <uniName>
# Skip delete confirmation prompt:
share uni delete --uni <uniName> --force
Invite another workspace to the project
share uni invite --uni <uniName> --user <userEmail>
Join an existing project
share uni join -u <uniName> -t <token> --config '{"name":"nodeName", "userId":"email@email.com", "region":"us-east-1"}'
share uni join --uni <uniName> --token <token> --config '{"name":"nodeName", "userId":"email@email.com", "region":"us-east-1"}'
Evolve the schema of a project
share uni evolve --uni <uniName> --schema schema.json

uni create

Create a new project.

The uni create command also allows for optionally providing the schema and initial state filenames as an alternative to providing them in the registration file.

Usage for uni create

Terminal window
share uni create

Flags for uni create

  • config (option) - File path or JSON registration data
  • role (option) - Role name to use for the operation

Examples for uni create

Terminal window
# Register project via JSON file:
share uni:create --config registration.json
# Register project via --config:
share uni:create --config '{"name": "test-UniName", "schema": "schema.json","nodes":[{"name":"NodeName","userId": "email@email.com","region": "us-east-1","csp": "aws"}]}'

uni delete

Permanently delete a project.

Usage for uni delete

Terminal window
share uni delete

Flags for uni delete

  • uni (option) - Name of project
  • force (boolean) - Force deletion with no confirmation step. Use with caution
  • role (option) - Role name to use for the operation

Examples for uni delete

Terminal window
share uni delete --uni <uniName>
# Skip delete confirmation prompt:
share uni delete --uni <uniName> --force

uni evolve

Evolve the schema for a project.

Usage for uni evolve

Terminal window
share uni evolve

Flags for uni evolve

  • uni (option) - Name of project
  • schema (option) - File path of schema
  • allowed-breaking-change (option) - A type of breaking change allowed. This flag may be specified multiple times to allow more than one type of breaking change.
  • approval-required (option) - Interactive approval for breaking changes to a schema. Default is ‘ALWAYS’
  • role (option) - Role name to use for the operation

Examples for uni evolve

Terminal window
share uni evolve --uni <uniName> --schema schema.json

uni get

Get information about a given project.

Usage for uni get

Terminal window
share uni get

Flags for uni get

  • uni (option) - Name of project
  • role (option) - Role name to use for the operation

Examples for uni get

Terminal window
share uni get --uni <uniName>

uni invite

Invite a new workspace to join the project.

Usage for uni invite

Terminal window
share uni invite

Flags for uni invite

  • uni (option) - Name of project
  • user (option) - User email of user to invite
  • role (option) - Role name to use for the operation

Examples for uni invite

Terminal window
share uni invite --uni <uniName> --user <userEmail>

uni join

Join an existing project.

Usage for uni join

Terminal window
share uni join

Flags for uni join

  • uni (option) - Name of project
  • token (option) - Value of the invitation token
  • config (option) - Workspace configuration settings
  • json (boolean) - Output return values as JSON
  • role (option) - Role name to use for the operation

Examples for uni join

Terminal window
share uni join -u <uniName> -t <token> --config '{"name":"nodeName", "userId":"email@email.com", "region":"us-east-1"}'
share uni join --uni <uniName> --token <token> --config '{"name":"nodeName", "userId":"email@email.com", "region":"us-east-1"}'

uni list

Lists all projects in your account. Lists all projects in which the calling account owns a workspace.

Usage for uni list

Terminal window
share uni list

Flags for uni list

  • json (boolean) - Return list of projects as json
  • role (option) - Role name to use for the operation

Examples for uni list

Terminal window
share uni list

uni open

Open a project in the Vendia dev console.

Usage for uni open

Terminal window
share uni open

Flags for uni open

  • uni (option) - Name of project

Examples for uni open

Terminal window
share uni open
share uni open --uni <uniName>

uni reset

Resets a project to its original state. Resets project to the state it was in just after it began operation (useful during development and testing).

Usage for uni reset

Terminal window
share uni reset

Flags for uni reset

  • uni (option) - Name of project
  • role (option) - Role name to use for the operation

Examples for uni reset

Terminal window
share uni reset --uni <uniName>