Skip to main content
Version: 1.5.x

Workspace Service

Workspaces

The Workspaces service provides methods to manage the workspaces for a given tenant.

Workspaces are the main containers for the different configuration resources available in TSB, and provide infrastructure isolation constraints.

CreateWorkspace

Requires CreateWorkspace

Create a new workspace. The workspace will own exclusively the namespaces configured in the namespaces selector for the workspace.

GetWorkspace

Requires ReadWorkspace

Get the details of an existing workspace

UpdateWorkspace

Requires WriteWorkspace

Modify an existing workspace

ListWorkspaces

List all existing workspaces for the given tenant.

DeleteWorkspace

Requires DeleteWorkspace

Delete an existing workspace. Note that deleting resources in TSB is a recursive operation. Deleting a workspace will delete all groups and configuration objects that exist in it.

CreateSettings

Requires CreateWorkspaceSetting

Create default settings for a workspace. Default settings will apply to the services owned by the workspace, unless more specific settings are provided at the group level.

GetSettings

Requires ReadWorkspaceSetting

Get the details of a settings object for the given workspace.

UpdateSettings

Requires WriteWorkspaceSetting

Modify the given workspace settings.

ListSettings

List all settings available for the given workspace.

DeleteSettings

Requires DeleteWorkspaceSetting

Delete the given workspace settings.

CreateWorkspaceRequest

Request to create a Workspace.

FieldDescriptionValidation Rule

parent

string
REQUIRED
Parent resource where the Workspace will be created.

string = {
  min_len: 1
}

name

string
REQUIRED
The short name for the resource to be created.

string = {
  min_len: 1
}

workspace

tetrateio.api.tsb.v2.Workspace
REQUIRED
Details of the Workspace to be created.

message = {
  required: true
}

CreateWorkspaceSettingsRequest

Request to create a Workspace Settings.

FieldDescriptionValidation Rule

parent

string
REQUIRED
Parent resource where the Workspace Settings will be created.

string = {
  min_len: 1
}

name

string
REQUIRED
The short name for the resource to be created.

string = {
  min_len: 1
}

settings

tetrateio.api.tsb.v2.WorkspaceSetting
REQUIRED
Details of the Workspace Settings to be created.

message = {
  required: true
}

DeleteWorkspaceRequest

Request to delete a Workspace.

FieldDescriptionValidation Rule

fqn

string
REQUIRED
Fully-qualified name of the Workspace.

string = {
  min_len: 1
}

DeleteWorkspaceSettingsRequest

Request to delete a Workspace Settings.

FieldDescriptionValidation Rule

fqn

string
REQUIRED
Fully-qualified name of the Workspace Settings.

string = {
  min_len: 1
}

GetWorkspaceRequest

Request to retrieve a Workspace.

FieldDescriptionValidation Rule

fqn

string
REQUIRED
Fully-qualified name of the Workspace.

string = {
  min_len: 1
}

GetWorkspaceSettingsRequest

Request to retrieve a Workspace Settings.

FieldDescriptionValidation Rule

fqn

string
REQUIRED
Fully-qualified name of the Workspace Settings.

string = {
  min_len: 1
}

ListWorkspaceSettingsRequest

Request to list Workspace Settings.

FieldDescriptionValidation Rule

parent

string
REQUIRED
Parent resource to list Workspace Settings from.

string = {
  min_len: 1
}

ListWorkspaceSettingsResponse

The existing settings objects for the given workspace.

FieldDescriptionValidation Rule

settings

List of tetrateio.api.tsb.v2.WorkspaceSetting

ListWorkspacesRequest

Request to list Workspaces.

FieldDescriptionValidation Rule

parent

string
REQUIRED
Parent resource to list Workspaces from.

string = {
  min_len: 1
}

ListWorkspacesResponse

The existing workspaces for the given tenant.

FieldDescriptionValidation Rule

workspaces

List of tetrateio.api.tsb.v2.Workspace