Organizations Service

Service to manage Organizations in TSB

Organizations

The Organizations service exposes methods to manage the organizations that exist in TSB. Organizations are the root of the Service Bridge object hierarchy. Each organization is completely independent of the other with its own set of tenants, users, teams, clusters and workspaces.

GetOrganization

SyncOrganization

CreateSettings

GetSettings

UpdateSettings

ListSettings

DeleteSettings

CreateOrganizationSettingsRequest

Request to create a Organization Settings.

Field	Description	Validation Rule
parent	string REQUIRED Parent resource where the Organization Settings will be created.	string = {   min_len: 1 }
name	string REQUIRED The short name for the resource to be created.	string = {   min_len: 1   max_len: 63   pattern: ^[a-z0-9]([a-z0-9-]*[a-z0-9])?$ }
settings	tetrateio.api.tsb.v2.OrganizationSetting REQUIRED Details of the Organization Settings to be created.	message = {   required: true }

DeleteOrganizationSettingsRequest

Request to delete a Organization Settings.

Field	Description	Validation Rule
fqn	string REQUIRED Fully-qualified name of the Organization Settings.	string = {   min_len: 1 }

GetOrganizationRequest

Request to retrieve a organization.

Field	Description	Validation Rule
fqn	string REQUIRED Fully-qualified name of the organization.	string = {   min_len: 1 }

GetOrganizationSettingsRequest

Request to retrieve a Organization Settings.

Field	Description	Validation Rule
fqn	string REQUIRED Fully-qualified name of the Organization Settings.	string = {   min_len: 1 }

ListOrganizationSettingsRequest

Request to list Organization Settings.

Field	Description	Validation Rule
parent	string REQUIRED Parent resource to list Organization Settings from.	string = {   min_len: 1 }

ListOrganizationSettingsResponse

List of all existing Organization settings objects in the Organization group.

Field	Description	Validation Rule
settings	List of tetrateio.api.tsb.v2.OrganizationSetting	–

SyncOrganizationRequest

Request to synchronize the users and teams in an organization from the configured identity provider.

Field	Description	Validation Rule
fqn	string REQUIRED Internal use only. Auto populated field.	string = {   min_len: 1 }
sourceType	tetrateio.api.tsb.v2.SourceType we cannot use the enum_only validation as protoc-gen-validate does not properly import the enum package in the generated code, and it breaks :(	–
users	List of tetrateio.api.tsb.v2.SyncOrganizationRequest.SyncUser	–
teams	List of tetrateio.api.tsb.v2.SyncOrganizationRequest.SyncTeam	–

SyncTeam

Information of a team as synchronized from the team source. This differs slightly from a TSB user since the fields here are raw info that does not have the context of the TSB hierarchy.

Field	Description	Validation Rule
id	string REQUIRED Unique ID for the group.	string = {   min_len: 1 }
description	string Optional description for the group.	–
memberUserIds	List of string List of user ids for the users that belong to this group.	–
memberGroupIds	List of string List of group ids for the groups that are nested into this group.	–
displayName	string Friendly name to show the group in the different UIs.	–

SyncUser

Information of a user as synchronized from the team source. This differs slightly from a TSB user since the fields here are raw info that does not have the context of the TSB hierarchy.

Field	Description	Validation Rule
id	string REQUIRED Unique ID for the user.	string = {   min_len: 1 }
description	string Optional description for the user.	–
email	string User's email	–
loginName	string The login username for the user.	–
displayName	string Friendly name to show the user in the different UIs.	–

SyncOrganizationResponse

Result of the organization users and team synchronization.

Field	Description	Validation Rule
failedUsers	tetrateio.api.tsb.v2.SyncOrganizationResponse.FailedIds List of users that were not synchronized	–
failedTeams	tetrateio.api.tsb.v2.SyncOrganizationResponse.FailedIds List of groups that were not synchronized	–

FailedIds

Field	Description	Validation Rule
removal	List of string Users or groups that failed to be removed	–
addition	List of string Users or groups that failed to be created	–
update	List of string Users or groups that failed to be updated	–