CH2 Management API

1.0.0

Overview

Statistics
55 Operations
0 Skills
Runtime Category
Manage Private Spaces, connections, egress and ingress configurations, IAM roles, and logs for CloudHub 2.0.

Servers

  • US https://anypoint.mulesoft.com/runtimefabric/api
  • EU https://eu1.anypoint.mulesoft.com/runtimefabric/api
  • CA https://ca1.platform.mulesoft.com/runtimefabric/api
  • JP https://jp1.platform.mulesoft.com/runtimefabric/api
  • IN https://in1.platform.mulesoft.com/runtimefabric/api
  • AU https://au1.platform.mulesoft.com/runtimefabric/api

Authentication & Security

  • bearerAuth http

    Bearer token authentication. Login endpoint: https://anypoint.mulesoft.com/accounts/api/login

  • clientAuth oauth2

    OAuth2 client credentials. Token endpoint: https://anypoint.mulesoft.com/accounts/api/v2/oauth2/token

List Private Spaces listPrivateSpaces

GET

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
get the list of Private Spaces in the organization.

Path Parameters

Response

Successful operation.
Examples
application/json
{}

Create a Private Space createPrivateSpace

POST

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
Request Body application/json
create a Private Space

Path Parameters

Request Body

json
name *: string
The name of the Private Space.
flavor: string
The flavor of the Private Space.
environments: object
network: object
managedFirewallRules: array
Deprecated
firewallRules: array

Response

Resource created successfully.
Examples
application/json
{}

List supported VPN configurations listSupportedVpnConfigs

GET

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
get supported vpn configs

Path Parameters

Response

Successful operation.

Get monthly patch window schedule getMonthlyPatchWindow

GET

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
get the latest upcoming monthly patch window schedule

Path Parameters

Response

json
Successful operation.
releaseYear *: integer
Year of monthly patch releases
releaseMonth *: string
Patch release month
sandboxStartDate *: string
Start date for monthly patching in sandbox spaces
sandboxEndDate *: string
End date for monthly patching in sandbox spaces
productionStartDate *: string
Start date for monthly patching in production spaces
productionEndDate *: string
End date for monthly patching in production spaces
Examples
application/json
{ "releaseYear": 2024, "releaseMonth": "MARCH", "sandboxStartDate": "2024-03-18T00:00:00+00:00", "sandboxEndDate": "2024-03-22T23:59:59.999000+00:00", "productionStartDate": "2024-03-23T00:00:00+00:00", "productionEndDate": "2024-03-24T23:59:59.999000+00:00" }

Get a Private Space getPrivateSpace

GET

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
get the Private Space

Path Parameters

privateSpaceId *: string

Response

Successful operation.
Examples
application/json
{}

Update a Private Space updatePrivateSpace

PATCH

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
Request Body application/json
Update existing Private Space

Path Parameters

privateSpaceId *: string

Request Body

json
environments *: object
network *: object
managedFirewallRules: array
Deprecated
firewallRules *: array
logForwarding *: object
ingressConfiguration *: object
enableIAMRole: boolean
If true, application deployed to this space will have the Private Space IAM role attached to the service account.
enableEgress: boolean
edgeHpaConfigs: object
hpa config for edge pods in rtf namespace

Response

Successful operation.

Delete a Private Space deletePrivateSpace

DELETE

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
delete the Private Space

Path Parameters

privateSpaceId *: string

Response

Successful operation.

List Private Space associations listAssociations

GET

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
get all associations of a private space.

Path Parameters

privateSpaceId *: string

Response

json
Successful operation.
items: array
Array items
Examples
application/json
[ { "id": "d282e462-07af-4146-b7d8-8bd7e6b18d83", "environmentId": "2ea3eff9-569a-4495-b7b6-1e28c6440aeb", "organizationId": "1ffdaa42-4702-4747-aeb9-aecab0f5ac1b" }, { "id": "79810eb2-c999-4104-b650-31ea2962a200", "environmentId": "3e9d5bde-6ef7-4947-9f98-0f7c32d48909", "organizationId": "1ffdaa42-4702-4747-aeb9-aecab0f5ac1b" } ]

Create Private Space associations createAssociations

POST

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
Request Body application/json
create associations for Private space with business groups and environments

Path Parameters

privateSpaceId *: string

Request Body

json
associations *: array
List of associations

Response

json
Successful operation.
items: array
Array items
Examples
application/json
[ { "id": "d282e462-07af-4146-b7d8-8bd7e6b18d83", "environmentId": "2ea3eff9-569a-4495-b7b6-1e28c6440aeb", "organizationId": "1ffdaa42-4702-4747-aeb9-aecab0f5ac1b" }, { "id": "79810eb2-c999-4104-b650-31ea2962a200", "environmentId": "3e9d5bde-6ef7-4947-9f98-0f7c32d48909", "organizationId": "1ffdaa42-4702-4747-aeb9-aecab0f5ac1b" } ]

Get a Private Space association getAssociation

GET

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
get a specific associations of a private space.

Path Parameters

privateSpaceId *: string
associationId *: string
The association ID to identify the target resource.

Response

json
Successful operation.
id *: string
The UUID of the association.
name: string
environmentId *: string
The type of environment. Can be all, sandbox, production, or a specific environment UUID.
organizationId *: string
The type of organization. Can be all, or specific organization UUID.
deploymentStatus: string
errorMessage: string
Examples
application/json
{ "id": "d282e462-07af-4146-b7d8-8bd7e6b18d83", "environmentId": "2ea3eff9-569a-4495-b7b6-1e28c6440aeb", "organizationId": "1ffdaa42-4702-4747-aeb9-aecab0f5ac1b" }

Delete a Private Space association deleteAssociation

DELETE

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
delete an association

Path Parameters

privateSpaceId *: string
associationId *: string
The association ID to identify the target resource.

Response

Successful operation.

Get available ports getAvailablePorts

GET

Try it out

Path Parameters
Query Parameters
Custom Query Parameters
Custom Headers
Get the next set of available ports.

Path Parameters

privateSpaceId *: string

Query Parameters

available *: boolean
count *: integer

Response

json
Successful operation.
ports *: array
List of the ports to be leased by the owner
Examples
application/json
{ "ports": [ 0 ] }

Get IAM roles for the Private Space getPrivateSpaceIamRoles

GET

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
get the IAM roles associated with the space.

Path Parameters

privateSpaceId *: string

Response

json
Successful operation.
roles *: array
IAM roles associated with the space
organizationId *: string
The parent organization ID of the space
spaceId *: string
id of the space.
message: string
IAM roles associated with the space
Examples
application/json
{ "roles": [ "string" ], "organizationId": "string", "spaceId": "string", "message": "string" }

Get AWS account ID for the Private Space getPrivateSpaceAwsAccountId

GET

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
get the AWS account Id a string value.

Path Parameters

privateSpaceId *: string

Response

Successful operation.

Schedule or trigger Private Space upgrade schedulePrivateSpaceUpgrade

PATCH

Try it out

Path Parameters
Query Parameters
Custom Query Parameters
Custom Headers
Either upgrade now or (re)schedule an upgrade later

Path Parameters

privateSpaceId *: string

Query Parameters

date: string
The date query parameter.
optIn *: boolean
The optIn query parameter.

Response

json
Successful operation.
scheduledUpdateTime: string
Date of scheduled upgrade
status *: string
The status of the upgrade
Examples
application/json
{ "scheduledUpdateTime": "2024-02-28T17:57:36+00:00", "status": "QUEUED" }

Cancel a scheduled Private Space upgrade cancelPrivateSpaceUpgrade

DELETE

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
cancel a scheduled upgrade

Path Parameters

privateSpaceId *: string

Response

Successful operation.

Get Private Space upgrade status getPrivateSpaceUpgradeStatus

GET

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
get the upgrade status of the space

Path Parameters

privateSpaceId *: string

Response

json
Successful operation.
scheduledUpdateTime: string
Date of scheduled upgrade
status *: string
The status of the upgrade
Examples
application/json
{ "scheduledUpdateTime": "2024-02-28T17:57:36+00:00", "status": "QUEUED" }

List egress rule groups listEgressRuleGroups

GET

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
get all egress rule groups of a private space.

Path Parameters

privateSpaceId *: string

Response

json
Successful operation.
items: array
Array items
Examples
application/json
[ { "id": "65f106d7-5e39-474d-8224-28d92d00b210", "name": "example-rule-group", "rules": [ { "domains": [ "example.com" ], "protocol": "tcp", "fromPort": 1, "toPort": 65535, "description": "" } ] } ]

Create an egress rule group createEgressRuleGroup

POST

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
Request Body application/json
create an egress rule group

Path Parameters

privateSpaceId *: string

Request Body

json
name *: string
The name of the rule group.
rules: array

Response

json
Successful operation.
id *: string
name *: string
The name of the rule group.
rules: array
isDefault: boolean
Examples
application/json
{ "id": "string", "name": "string", "rules": [ { "id": "string", "type": "string" } ], "isDefault": true }

Get an egress rule group getEgressRuleGroup

GET

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
get a specific egress rule group

Path Parameters

privateSpaceId *: string
ruleGroupId *: string
The ruleGroup ID to identify the target resource.

Response

json
Successful operation.
id *: string
name *: string
The name of the rule group.
rules: array
isDefault: boolean
Examples
application/json
{ "id": "string", "name": "string", "rules": [ { "id": "string", "type": "string" } ], "isDefault": true }

Update an egress rule group updateEgressRuleGroup

PATCH

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
Request Body application/json
Update egress rule group.

Path Parameters

privateSpaceId *: string
ruleGroupId *: string
The ruleGroup ID to identify the target resource.

Request Body

json
name *: string
The name of the rule group.
rules: array

Response

json
Successful operation.
id *: string
name *: string
The name of the rule group.
rules: array
isDefault: boolean
Examples
application/json
{ "id": "string", "name": "string", "rules": [ { "id": "string", "type": "string" } ], "isDefault": true }

Delete an egress rule group deleteEgressRuleGroup

DELETE

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
delete egress rule group

Path Parameters

privateSpaceId *: string
ruleGroupId *: string
The ruleGroup ID to identify the target resource.

Response

Successful operation.

List Private Space routes listPrivateSpaceRoutes

GET

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
get the list of CIDR's in the private space.

Path Parameters

privateSpaceId *: string

Response

json
Successful operation.
items: array
Array items
Examples
application/json
[ { "id": "string", "type": "string" } ]

Update Private Space routes updatePrivateSpaceRoutes

PATCH

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
Request Body application/json
Update the CIDRs that the Cloudhub VPC will send traffic to via the IGW.

Path Parameters

privateSpaceId *: string

Request Body

json
networkGateways *: array

Response

json
Request accepted for processing.
items: array
Array items
Examples
application/json
[ { "id": "string", "type": "string" } ]

List Private Space connections listConnections

GET

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
get the list of Connections inside the private space.

Path Parameters

privateSpaceId *: string

Response

Successful operation.
Examples
application/json
{}

Create a Private Space connection createConnection

POST

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
Request Body application/json
create a Private Space Connection

Path Parameters

privateSpaceId *: string

Request Body

json
name *: string
vpns *: array

Response

Resource created successfully.
Examples
application/json
{}

Get a Private Space connection getConnection

GET

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
get the Private Space Connection

Path Parameters

privateSpaceId *: string

Response

Successful operation.
Examples
application/json
{}

Update a Private Space connection updateConnection

PATCH

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
Request Body application/json
Update existing Private Space Connection

Path Parameters

privateSpaceId *: string

Request Body

json
id *: string
name *: string
staticRoutes: array

Response

json
Successful operation.
id *: string
name *: string
vpns *: array
Examples
application/json
{ "id": "string", "name": "string", "vpns": [ { "id": "string", "type": "string" } ] }

Delete a Private Space connection deleteConnection

DELETE

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
delete the Private Space Connection

Path Parameters

privateSpaceId *: string

Response

Successful operation.

Add a VPN to a connection addConnectionVpn

POST

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
add a vpn to an existing connection.

Path Parameters

privateSpaceId *: string

Response

Resource created successfully.
Examples
application/json
{}

Update a VPN in a connection updateConnectionVpn

PATCH

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
Request Body application/json
delete a vpn from a connection.

Path Parameters

privateSpaceId *: string
vpnId *: string
The vpn ID to identify the target resource.

Request Body

json
id *: string
name: string
remoteAsn: number
localAsn: number
remoteIpAddress *: string
staticRoutes *: array
vpnTunnels *: array

Response

json
Successful operation.
id *: string
name: string
remoteAsn: number
localAsn: number
remoteIpAddress *: string
staticRoutes *: array
vpnTunnels *: array
Examples
application/json
{ "id": "string", "name": "string", "remoteAsn": 0.0, "localAsn": 0.0, "remoteIpAddress": "string", "staticRoutes": [ "string" ], "vpnTunnels": [ { "id": "string", "type": "string" } ] }

Delete a VPN from a connection deleteConnectionVpn

DELETE

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
delete a vpn from a connection.

Path Parameters

privateSpaceId *: string
vpnId *: string
The vpn ID to identify the target resource.

Response

Successful operation.

Download VPN connection guide getVpnConnectionGuide

GET

Try it out

Path Parameters
Query Parameters
Custom Query Parameters
Custom Headers
Retrieves a connectionGuide.

Path Parameters

privateSpaceId *: string
vpnId *: string
The vpn ID to identify the target resource.

Query Parameters

vendor *: string
The vendor query parameter.
platform *: string
The platform query parameter.
software *: string
The software query parameter.

Response

Successful operation.

List Private Space Transit Gateway connections listPrivateSpaceTgws

GET

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
get list of TGW connections assocated with a private space.

Path Parameters

privateSpaceId *: string

Response

Successful operation.
Examples
application/json
{}

Create a Private Space Transit Gateway connection createPrivateSpaceTgw

POST

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
Request Body application/json
create a private space TGW connection.

Path Parameters

privateSpaceId *: string

Request Body

json
name *: string
resourceShareId *: string
resourceShareAccount *: string
routes *: array

Response

Resource created successfully.
Examples
application/json
{}

Get a Private Space Transit Gateway getPrivateSpaceTgw

GET

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
Get the transitgateway
with id =
{transitgatewayId}

Path Parameters

privateSpaceId *: string
tgwId *: string

Response

Successful operation.
Examples
application/json
{}

Update a Private Space Transit Gateway updatePrivateSpaceTgw

PATCH

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
Request Body application/json
patch the Private Space TGW Connection

Path Parameters

privateSpaceId *: string
tgwId *: string

Request Body

json
name *: string

Response

json
Successful operation.
id *: string
name *: string
accountId: string
spec *: object
status *: object
Examples
application/json
{ "id": "string", "name": "string", "accountId": "string", "spec": { "id": "string", "type": "string" }, "status": { "id": "string", "type": "string" } }

Detach a Transit Gateway from a Private Space deletePrivateSpaceTgw

DELETE

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
Detach a Transit Gateway from the Private Space

Path Parameters

privateSpaceId *: string
tgwId *: string

Response

Successful operation.

List Transit Gateway connection routes listTgwConnectionRoutes

GET

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
get TGW routes configured to tgw connection.

Path Parameters

privateSpaceId *: string
tgwId *: string

Response

Successful operation.

Update Transit Gateway connection routes updateTgwConnectionRoutes

PATCH

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
Request Body application/json
patch routes for a TGW connection.

Path Parameters

privateSpaceId *: string
tgwId *: string

Request Body

json
items: array
Array items

Response

Successful operation.

List Transit Gateway routes for Private Space listPrivateSpaceTgwRoutes

GET

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
get TGW routes configured to private space.

Path Parameters

privateSpaceId *: string

Response

Successful operation.

List TLS contexts listTlsContexts

GET

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
get the list of TLS contexts inside the private space.

Path Parameters

privateSpaceId *: string

Response

Successful operation.
Examples
application/json
{}

Create a TLS context createTlsContext

POST

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
Request Body application/json
create a TLS context

Path Parameters

privateSpaceId *: string

Request Body

json

Response

Resource created successfully.
Examples
application/json
{}

Get a TLS context getTlsContext

GET

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
get the TLS context

Path Parameters

privateSpaceId *: string
contextId *: string
The context ID to identify the target resource.

Response

Successful operation.
Examples
application/json
{}

Update a TLS context updateTlsContext

PATCH

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
Update an existing TLS context

Path Parameters

privateSpaceId *: string
contextId *: string
The context ID to identify the target resource.

Response

json
Successful operation.
id *: string
name *: string
trustStore: object
keyStore *: object
ciphers *: object
type: string
Examples
application/json
{ "id": "string", "name": "string", "trustStore": { "id": "string", "type": "string" }, "keyStore": { "id": "string", "type": "string" }, "ciphers": { "id": "string", "type": "string" }, "type": "string" }

Delete a TLS context deleteTlsContext

DELETE

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
delete the TLS context

Path Parameters

privateSpaceId *: string
contextId *: string
The context ID to identify the target resource.

Response

Successful operation.

Download ingress logs downloadIngressLogs

GET

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
download ingress logs in ascending order

Path Parameters

privateSpaceId *: string

Response

Successful operation.

List Transit Gateway connections for the org listOrgTransitGateways

GET

Try it out

Path Parameters
Query Parameters
Custom Query Parameters
Custom Headers
get list of TGW connections assocated with an organization.

Path Parameters

Query Parameters

region: string
The region query parameter.
privateSpaceId: string
The privateSpace ID query parameter.

Response

Successful operation.
Examples
application/json
{}

Remove a Transit Gateway from the organization deleteOrgTransitGateway

DELETE

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
Remove the Transit gateway from your Anypoint Platform organization

Path Parameters

tgwId *: string

Response

Successful operation.

Get Transit Gateway routes listOrgTgwRoutes

GET

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
get TGW routes configured for a gateway

Path Parameters

tgwId *: string

Response

Successful operation.

List deployment targets listTargets

GET

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
get list of target deployments within an organization

Path Parameters

Response

Successful operation.
Examples
application/json
{}

Get a deployment target getTarget

GET

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
get the target

Path Parameters

id *: string
The id to identify the target resource.

Response

json
Successful operation.
id *: string
name *: string
version *: string
The version of the target.
type *: string
The type of the target.
vendor: string
The Kubernetes vendor of the Runtime Fabric.
runtimes *: array
egressRuleGroups: array
status *: string
environments: array
isAvailableForDeployments *: boolean
Determines if a deployment can be perfomed in a particular target.
replicationStrategies: object
Replication Strategies for this target per deployment type.
nodes *: array
defaults: object
enhancedSecurity: boolean
featureFlags: object
region *: string
Examples
application/json
{ "id": "string", "name": "string", "version": "string", "type": "string", "vendor": "string", "runtimes": [ { "id": "string", "type": "string" } ], "egressRuleGroups": [ { "id": "string", "type": "string" } ], "status": "string", "environments": [ "string" ], "isAvailableForDeployments": true }

Migrate a Cloudhub VPC to a Private Space migrateVpcToPrivateSpace

POST

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
Request Body application/json
create an equivalent Private Space for provided Cloudhub VPC

Path Parameters

vpcId *: string

Request Body

json
name *: string
The name of the private space
reservedCidrs: array

Response

Resource created successfully.
Examples
application/json
{}

List Cloudhub VPCs eligible for upgrade listMigratableVpcs

GET

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
get Cloudhub VPCs upgrade eligibility information

Path Parameters

Response

Successful operation.

Get VPC upgrade eligibility getVpcMigrationInfo

GET

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
get Cloudhub VPC upgrade eligibility information

Path Parameters

vpcId *: string

Response

Successful operation.