Skip to main content
logoTetrate Service BridgeVersion: next

Gateway Service

Service to manage the configuration for Gateways.

Gateways​

The Gateway service provides methods to manage gateway settings in TSB.

It provides methods to create and manage gateway groups within a workspace, allowing to create fine-grained groupings to configure a subset of the workspace namespaces. Access policies can be assigned at group level, providing a fine-grained access control to the gateway configuration features.

The Gateway service also provides methods to configure the different gateway settings that are allowed within each group.

CreateGroup​

GetGroup​

UpdateGroup​

ListGroups​

DeleteGroup​

CreateIngressGateway​

GetIngressGateway​

UpdateIngressGateway​

ListIngressGateways​

DeleteIngressGateway​

CreateEgressGateway​

GetEgressGateway​

UpdateEgressGateway​

ListEgressGateways​

DeleteEgressGateway​

CreateTier1Gateway​

GetTier1Gateway​

UpdateTier1Gateway​

ListTier1Gateways​

DeleteTier1Gateway​

CreateGateway​

GetGateway​

UpdateGateway​

ListGateways​

DeleteGateway​

ListSharedGateways​

CreateInstallGateway​

GetInstallGateway​

UpdateInstallGateway​

ListInstallGateways​

DeleteInstallGateway​

CreateInstallGatewayTemplate​

GetInstallGatewayTemplate​

UpdateInstallGatewayTemplate​

ListInstallGatewayTemplates​

DeleteInstallGatewayTemplate​

GetSharedGatewayReferenceGrant​

DeleteSharedGatewayReferenceGrant​

ListSharedGatewayReferenceGrants​

CreateSharedGatewayReferenceGrant​

UpdateSharedGatewayReferenceGrant​

CreateEgressGatewayRequest​

Request to create a EgressGateway.

FieldDescriptionValidation Rule

parent

string
REQUIRED
Parent resource where the EgressGateway 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])?$
}

egressGateway

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

message = {
  required: true
}

CreateGatewayGroupRequest​

Request to create a Gateway Group.

FieldDescriptionValidation Rule

parent

string
REQUIRED
Parent resource where the Group 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])?$
}

group

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

message = {
  required: true
}

CreateGatewayRequest​

Request to create a Gateway.

FieldDescriptionValidation Rule

parent

string
REQUIRED
Parent resource where the Gateway 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])?$
}

gateway

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

message = {
  required: true
}

CreateIngressGatewayRequest​

Request to create a IngressGateway.

FieldDescriptionValidation Rule

parent

string
REQUIRED
Parent resource where the IngressGateway 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])?$
}

ingressGateway

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

message = {
  required: true
}

CreateInstallGatewayRequest​

Request to create an InstallGateway.

FieldDescriptionValidation Rule

parent

string
REQUIRED
Parent resource where the InstallGateway 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])?$
}

gateway

tetrateio.api.install.dataplane.v1alpha1.GatewaySpec
REQUIRED
Details of the Gateway to be created.

message = {
  required: true
}

CreateInstallGatewayTemplateRequest​

Request to create an InstallGatewayTemplate.

FieldDescriptionValidation Rule

parent

string
REQUIRED
Organization fqn where the InstallGatewayTemplate 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])?$
}

template

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

message = {
  required: true
}

CreateSharedGatewayReferenceGrantRequest​

Request to create a SharedGatewayReferenceGrant.

FieldDescriptionValidation Rule

parent

string
REQUIRED
Parent resource where the SharedGatewayReferenceGrant 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])?$
}

sharedGatewayReferenceGrant

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

message = {
  required: true
}

CreateTier1GatewayRequest​

Request to create a Tier1Gateway.

FieldDescriptionValidation Rule

parent

string
REQUIRED
Parent resource where the Tier1Gateway 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])?$
}

tier1Gateway

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

message = {
  required: true
}

DeleteEgressGatewayRequest​

Request to delete a EgressGateway.

FieldDescriptionValidation Rule

fqn

string
REQUIRED
Fully-qualified name of the EgressGateway.

string = {
  min_len: 1
}

DeleteGatewayGroupRequest​

Request to delete a Gateway Group.

FieldDescriptionValidation Rule

fqn

string
REQUIRED
Fully-qualified name of the Group.

string = {
  min_len: 1
}

force

bool
Force the deletion of the object even if deletion protection is enabled. If this is set, then the object and all its children will be deleted even if any of them has the deletion protection enabled.

–

DeleteGatewayRequest​

Request to delete a Gateway.

FieldDescriptionValidation Rule

fqn

string
REQUIRED
Fully-qualified name of the Gateway.

string = {
  min_len: 1
}

DeleteIngressGatewayRequest​

Request to delete a IngressGateway.

FieldDescriptionValidation Rule

fqn

string
REQUIRED
Fully-qualified name of the IngressGateway.

string = {
  min_len: 1
}

DeleteInstallGatewayRequest​

Request to delete an InstallGateway.

FieldDescriptionValidation Rule

fqn

string
REQUIRED
Fully-qualified name of the InstallGateway.

string = {
  min_len: 1
}

DeleteInstallGatewayTemplateRequest​

Request to delete an InstallGatewayTemplate.

FieldDescriptionValidation Rule

fqn

string
REQUIRED
Fully-qualified name of the InstallGatewayTemplate.

string = {
  min_len: 1
}

force

bool
Force the deletion of the object even if deletion protection is enabled.

–

DeleteSharedGatewayReferenceGrantRequest​

Request to delete a SharedGatewayReferenceGrant.

FieldDescriptionValidation Rule

fqn

string
REQUIRED
Fully-qualified name of the SharedGatewayReferenceGrant.

string = {
  min_len: 1
}

DeleteTier1GatewayRequest​

Request to delete a Tier1Gateway.

FieldDescriptionValidation Rule

fqn

string
REQUIRED
Fully-qualified name of the Tier1Gateway.

string = {
  min_len: 1
}

GetEgressGatewayRequest​

Request to retrieve a EgressGateway.

FieldDescriptionValidation Rule

fqn

string
REQUIRED
Fully-qualified name of the EgressGateway.

string = {
  min_len: 1
}

GetGatewayGroupRequest​

Request to retrieve a Gateway Group.

FieldDescriptionValidation Rule

fqn

string
REQUIRED
Fully-qualified name of the Group.

string = {
  min_len: 1
}

GetGatewayRequest​

Request to retrieve a Gateway.

FieldDescriptionValidation Rule

fqn

string
REQUIRED
Fully-qualified name of the Gateway.

string = {
  min_len: 1
}

GetIngressGatewayRequest​

Request to retrieve a IngressGateway.

FieldDescriptionValidation Rule

fqn

string
REQUIRED
Fully-qualified name of the IngressGateway.

string = {
  min_len: 1
}

GetInstallGatewayRequest​

Request to retrieve an InstallGateway.

FieldDescriptionValidation Rule

fqn

string
REQUIRED
Fully-qualified name of the InstallGateway.

string = {
  min_len: 1
}

GetInstallGatewayTemplateRequest​

Request to retrieve an InstallGatewayTemplate.

FieldDescriptionValidation Rule

fqn

string
REQUIRED
Fully-qualified name of the InstallGatewayTemplate.

string = {
  min_len: 1
}

GetSharedGatewayReferenceGrantRequest​

Request to retrieve a SharedGatewayReferenceGrant.

FieldDescriptionValidation Rule

fqn

string
REQUIRED
Fully-qualified name of the SharedGatewayReferenceGrant.

string = {
  min_len: 1
}

GetTier1GatewayRequest​

Request to retrieve a Tier1Gateway.

FieldDescriptionValidation Rule

fqn

string
REQUIRED
Fully-qualified name of the Tier1Gateway.

string = {
  min_len: 1
}

ListEgressGatewaysRequest​

Request to list EgressGateways.

FieldDescriptionValidation Rule

parent

string
REQUIRED
Parent resource to list EgressGateways from.

string = {
  min_len: 1
}

ListEgressGatewaysResponse​

Lost of all Egress Gateway objects in the gateway group.

FieldDescriptionValidation Rule

egressGateways

List of tetrateio.api.tsb.gateway.v2.EgressGateway

–

ListGatewayGroupsRequest​

Request to list Gateway Groups.

FieldDescriptionValidation Rule

parent

string
REQUIRED
Parent resource to list Groups from.

string = {
  min_len: 1
}

ListGatewayGroupsResponse​

List of all gateway groups in the workspace.

FieldDescriptionValidation Rule

groups

List of tetrateio.api.tsb.gateway.v2.Group

–

ListGatewaysRequest​

Request to list Gateways.

FieldDescriptionValidation Rule

parent

string
REQUIRED
Parent resource to list Gateways from.

string = {
  min_len: 1
}

ListGatewaysResponse​

List of all Gateway objects in the gateway group.

FieldDescriptionValidation Rule

gateways

List of tetrateio.api.tsb.gateway.v2.Gateway
List of all Gateway objects.

–

ListIngressGatewaysRequest​

Request to list IngressGateways.

FieldDescriptionValidation Rule

parent

string
REQUIRED
Parent resource to list IngressGateways from.

string = {
  min_len: 1
}

ListIngressGatewaysResponse​

List of all Ingress Gateway objects in the gateway group.

FieldDescriptionValidation Rule

ingressGateways

List of tetrateio.api.tsb.gateway.v2.IngressGateway

–

ListInstallGatewayTemplatesRequest​

Request to list InstallGatewayTemplates.

FieldDescriptionValidation Rule

parent

string
REQUIRED
Parent Organization to list InstallGatewayTemplates from.

string = {
  min_len: 1
}

ListInstallGatewayTemplatesResponse​

List of all InstallGatewayTemplate objects.

FieldDescriptionValidation Rule

templates

List of tetrateio.api.tsb.gateway.v2.InstallGatewayTemplate

–

ListInstallGatewaysRequest​

Request to list InstallGateways.

FieldDescriptionValidation Rule

parent

string
REQUIRED
Parent resource to list InstallGateways from.

string = {
  min_len: 1
}

ListInstallGatewaysResponse​

List of all Install Gateway objects in the gateway group.

FieldDescriptionValidation Rule

installGateways

List of tetrateio.api.install.dataplane.v1alpha1.GatewaySpec

–

ListSharedGatewayReferenceGrantsRequest​

Request to list SharedGatewayReferenceGrants.

FieldDescriptionValidation Rule

parent

string
REQUIRED
Parent resource to list SharedGatewayReferenceGrants from.

string = {
  min_len: 1
}

ListSharedGatewayReferenceGrantsResponse​

List of all SharedGatewayReferenceGrants in the gateway group.

FieldDescriptionValidation Rule

sharedGatewayReferenceGrants

List of tetrateio.api.tsb.gateway.v2.SharedGatewayReferenceGrant
Details of the SharedGatewayReferenceGrants found in the gateway group.

–

ListSharedGatewaysRequest​

List shared gateways that have a shared reference grant for the given gateway group.

FieldDescriptionValidation Rule

parent

string
REQUIRED
Parent resource to list shared gateways from. This could be an Organization, Tenant, Workspace, or Gateway Group.

string = {
  min_len: 1
}

ListSharedGatewaysResponse​

List of all shared gateways that have a shared reference grant.

FieldDescriptionValidation Rule

sharedGateways

List of tetrateio.api.tsb.gateway.v2.ListSharedGatewaysResponse.SharedGateway
List of shared gateways.

–

SharedGateway​

Represents a shared gateway that has a reference grant.

FieldDescriptionValidation Rule

FQN

string
REQUIRED
The fully-qualified name of an installed gateway that is shared.

string = {
  min_len: 1
}

workloadSelector

tetrateio.api.tsb.types.v2.WorkloadSelector
The WorkloadSelector that can be used to add Gateway configuration to the shared gateway.

–

ListTier1GatewaysRequest​

Request to list Tier1Gateways.

FieldDescriptionValidation Rule

parent

string
REQUIRED
Parent resource to list Tier1Gateways from.

string = {
  min_len: 1
}

ListTier1GatewaysResponse​

List of all Tier1 Gateway objects in the gateway group.

FieldDescriptionValidation Rule

tier1Gateways

List of tetrateio.api.tsb.gateway.v2.Tier1Gateway

–