API docs by Redocly

Omnistrate Registration API (2022-09-01-00)

Download OpenAPI specification:

REST API for Omnistrate Service Registration

auth-session-api

Validate the caller's current JWT session and return minimal verified identity

DescribeAuthSession auth-session-api

Validate signature, expiration and backend session revocation. Missing, malformed, expired or revoked JWTs return 401. No refresh or new token is issued.

Authorizations:
api_key_header_Authorization

Responses

Response samples

Content type
application/json
{
  • "exp": 7857494812608929000,
  • "organizationID": "Sit impedit consequatur voluptatem.",
  • "serviceProviderID": "Dolorem et rem praesentium.",
  • "userID": "Velit et quo nihil qui ullam."
}

global-api

Common API for all Omnistrate API endpoints

registrationServiceHealth global-api

Registration service health check endpoint

Responses

Response samples

Content type
application/json
{
  • "status": "FAILED|CANCELLED|PENDING_DEPENDENCY|PENDING|RUNNING|DEPLOYING|UPLOADING|READY|SUCCESS|COMPLETE|DELETING|DELETED|UNKNOWN|DISCONNECTED|DISCONNECTING|CONNECTING|DEACTIVATED"
}

consumptionServiceHealth global-api

Consumption service health check endpoint

Responses

Response samples

Content type
application/json
{
  • "status": "FAILED|CANCELLED|PENDING_DEPENDENCY|PENDING|RUNNING|DEPLOYING|UPLOADING|READY|SUCCESS|COMPLETE|DELETING|DELETED|UNKNOWN|DISCONNECTED|DISCONNECTING|CONNECTING|DEACTIVATED"
}

consumptionServiceVersion global-api

Consumption service version endpoint

Responses

Response samples

Content type
application/json
{
  • "additionalVersions": {
    },
  • "apiVersion": "1.0",
  • "buildCommitSHA": "1234567890abcdef1234567890abcdef12345678",
  • "buildTimestamp": "2020-01-01T00:00:00Z",
  • "componentVersion": "v0.47.96"
}

registrationServiceVersion global-api

Registration service version endpoint

Responses

Response samples

Content type
application/json
{
  • "additionalVersions": {
    },
  • "apiVersion": "1.0",
  • "buildCommitSHA": "1234567890abcdef1234567890abcdef12345678",
  • "buildTimestamp": "2020-01-01T00:00:00Z",
  • "componentVersion": "v0.47.96"
}

service-api

ListService service-api

Authorizations:
api_key_header_Authorization

Responses

Response samples

Content type
application/json
{
  • "ids": [
    ],
  • "nextPageToken": "next-token",
  • "services": [
    ]
}

CreateService service-api

Authorizations:
api_key_header_Authorization
Request Body schema: application/json
required
description
required
string

A brief description of the service

name
required
string

Name of the Service

serviceLogoURL
string <uri>

The logo for the service

Responses

Request samples

Content type
application/json
{
  • "description": "A MySQL SaaS specializing in multi-writer clusters for high availability",
  • "name": "MySQL multi-writer service",
  • "serviceLogoURL": "http://larson.biz/rolando"
}

Response samples

Content type
application/json
"s-123456"

DeleteService service-api

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: s-12345678

The service ID to operate on

Responses

DescribeService service-api

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: s-12345678

The service ID to operate on

Responses

Response samples

Content type
application/json
{
  • "createdAt": "2019-01-01T00:00:00Z",
  • "description": "A MySQL SaaS specializing in multi-writer clusters for high availability",
  • "id": "s-123456",
  • "key": "mysql",
  • "name": "MySQL multi-writer service",
  • "roleType": "root|editor|reader|service_editor|service_reader|admin|service_operator",
  • "serviceEnvironments": [
    ],
  • "serviceLogoURL": "Dolore tenetur perspiciatis sint qui accusantium.",
  • "serviceProviderID": "Quo animi quidem praesentium.",
  • "serviceProviderName": "Omnistrate, Inc."
}

UpdateService service-api

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: s-12345678

The service ID to operate on

Request Body schema: application/json
required
description
string

A brief description of the service

dryRun
boolean

If set to true, performs a dry run of the update operation without making any changes

name
string

Name of the Service

serviceLogoURL
string

The logo for the service

Responses

Request samples

Content type
application/json
{
  • "description": "A MySQL SaaS specializing in multi-writer clusters for high availability",
  • "dryRun": true,
  • "name": "MySQL multi-writer service",
  • "serviceLogoURL": "Quam et voluptas sed pariatur fugiat sequi."
}

ServiceHealth service-api

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: s-12345678

The ID of the service

Responses

Response samples

Content type
application/json
{
  • "health": "UP|DOWN|UNKNOWN",
  • "id": "s-123456",
  • "report": {
    }
}

CreateServiceFromComposeSpec service-api

Authorizations:
api_key_header_Authorization
Request Body schema: application/json
required
description
required
string

A brief description of the service

fileContent
required
string

Base64 encoded Compose Spec YAML in docker compose format

fileFormat
required
string

MIME type of file format

fileName
required
string

Name of compose spec YAML file that is uploaded

name
required
string

Name of the Service

serviceLogoURL
string <uri>

The logo for the service

Responses

Request samples

Content type
application/json
{
  • "description": "A MySQL SaaS specializing in multi-writer clusters for high availability",
  • "fileContent": "Repudiandae mollitia nihil ea.",
  • "fileFormat": "text/plain",
  • "fileName": "mysql.yaml",
  • "name": "MySQL multi-writer service",
  • "serviceLogoURL": "http://langoshlind.net/vicente"
}

Response samples

Content type
application/json
"s-123456"

BuildServiceFromComposeSpec service-api

Authorizations:
api_key_header_Authorization
Request Body schema: application/json
required
object

Configs for the service. Key is the compose spec name of the config and value is base64 encoded config content

description
string

A brief description of the service

dryrun
boolean

If set to true, performs a dry run of the build operation without making any changes

environment
string

The environment to build the service in

environmentType
string

The type of the environment

fileContent
required
string

Base64 encoded Compose Spec YAML in docker compose format

forceCreateNewServicePlanVersion
boolean

Force create a new service plan version when the service is released

name
required
string

Name of the Service

release
boolean

Release the service after building

releaseAsPreferred
boolean

Release the service as preferred

releaseVersionName
string

Release version name

object

Secrets for the service. Key is the compose spec name of the secret and value is base64 encoded secret content

serviceLogoURL
string <uri>

The logo for the service

Responses

Request samples

Content type
application/json
{
  • "configs": {
    },
  • "description": "A MySQL SaaS specializing in multi-writer clusters for high availability",
  • "dryrun": true,
  • "environment": "dev",
  • "environmentType": "PROD|PRIVATE|CANARY|STAGING|QA|DEV|GLOBAL",
  • "fileContent": "Iure aperiam libero minus.",
  • "forceCreateNewServicePlanVersion": true,
  • "name": "MySQL multi-writer service",
  • "release": true,
  • "releaseAsPreferred": true,
  • "releaseVersionName": "mysql",
  • "secrets": {
    },
  • "serviceLogoURL": "http://hintzwitting.org/simeon"
}

Response samples

Content type
application/json
{
  • "isNewServicePlanVersionCreated": true,
  • "productTierID": "Corporis laborum aspernatur blanditiis velit nostrum.",
  • "serviceEnvironmentID": "se-123456",
  • "serviceID": "s-123456",
  • "undefinedResources": {
    }
}

BuildServiceFromServicePlanSpec service-api

Authorizations:
api_key_header_Authorization
Request Body schema: application/json
required
description
string

A brief description of the service

dryrun
boolean

If set to true, performs a dry run of the build operation without making any changes

environment
string

The environment to build the service in

environmentType
string

The type of the environment

fileContent
required
string

Base64 encoded Compose Spec YAML in service plan configuration format

forceCreateNewServicePlanVersion
boolean

Force create a new service plan version when the service is released

name
required
string

Name of the Service

release
boolean

Release the service after building

releaseAsPreferred
boolean

Release the service as preferred

releaseVersionName
string

Release version name

serviceLogoURL
string <uri>

The logo for the service

Responses

Request samples

Content type
application/json
{
  • "description": "A MySQL SaaS specializing in multi-writer clusters for high availability",
  • "dryrun": true,
  • "environment": "dev",
  • "environmentType": "PROD|PRIVATE|CANARY|STAGING|QA|DEV|GLOBAL",
  • "fileContent": "Porro sapiente aut quasi voluptatem.",
  • "forceCreateNewServicePlanVersion": true,
  • "name": "MySQL multi-writer service",
  • "release": true,
  • "releaseAsPreferred": true,
  • "releaseVersionName": "mysql",
  • "serviceLogoURL": "http://harrislangosh.name/benny"
}

Response samples

Content type
application/json
{
  • "isNewServicePlanVersionCreated": true,
  • "productTierID": "Debitis cumque.",
  • "serviceEnvironmentID": "se-123456",
  • "serviceID": "s-123456",
  • "undefinedResources": {
    }
}

PrepareServiceFromServicePlanSpec service-api

Authorizations:
api_key_header_Authorization
Request Body schema: application/json
required
customerOnboardingId
string

The ID of the onboarding of the service

environment
required
string

The environment to build the service in

environmentType
required
string

The type of the environment

fileContent
required
string

Base64 encoded Compose Spec YAML in service plan configuration format

name
required
string

Name of the Service

Responses

Request samples

Content type
application/json
{
  • "customerOnboardingId": "Facilis aperiam cumque molestias harum et.",
  • "environment": "dev",
  • "environmentType": "PROD|PRIVATE|CANARY|STAGING|QA|DEV|GLOBAL",
  • "fileContent": "Rerum suscipit eum tempore aut quia.",
  • "name": "MySQL multi-writer service"
}

Response samples

Content type
application/json
{
  • "artifactUploadingTasks": [
    ],
  • "isNewProductTierCreated": true,
  • "productTierID": "Rerum sit ab veritatis sed.",
  • "serviceEnvironmentID": "se-123456",
  • "serviceID": "s-123456"
}

service-environment-api

ListServiceEnvironment service-environment-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The ID of the service this environment belongs to

Responses

Response samples

Content type
application/json
{
  • "ids": [
    ],
  • "nextPageToken": "next-token"
}

CreateServiceEnvironment service-environment-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The ID of the service this environment belongs to

Request Body schema: application/json
required
autoApproveSubscription
boolean

Auto approve subscription or not

deploymentConfigId
required
string

The deployment configuration ID

description
required
string

A brief description of the service environment

name
required
string

Name of the Service Environment

serviceAuthPublicKey
string

PEM-encoded Public key part of the key used to sign the JWT tokens for the service control plane APIs

sourceEnvironmentId
string

The ID of the service environment to use for promoting changes to this environment

type
string
visibility
string

This parameter is used to configure the visibility of the service control-plane APIs

Responses

Request samples

Content type
application/json
{
  • "autoApproveSubscription": false,
  • "deploymentConfigId": "Voluptatibus et nostrum eaque sequi enim eos.",
  • "description": "The production environment for the MySQL multi-writer service",
  • "name": "Production",
  • "serviceAuthPublicKey": "-----BEGIN PUBLIC KEY-----\nMFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAExXBS01nPRugGbKCN8m9sSSTkGvPT\n7a1Jn74No2dTkp+tQ+ZyBa7ClKbEXFaR2mzy06q0ivJAxPi1pixofIXE0Q==\n-----END PUBLIC KEY-----\n",
  • "sourceEnvironmentId": "se-123456",
  • "type": "PROD|PRIVATE|CANARY|STAGING|QA|DEV|GLOBAL",
  • "visibility": "PUBLIC"
}

Response samples

Content type
application/json
"se-123456"

DeleteServiceEnvironment service-environment-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The ID of the service this environment belongs to

id
required
string
Example: se-12345678

The ID of the service environment

Responses

DescribeServiceEnvironment service-environment-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The ID of the service this environment belongs to

id
required
string
Example: se-12345678

The ID of the service environment

Responses

Response samples

Content type
application/json
{
  • "autoApproveSubscription": false,
  • "deploymentConfigId": "Eius hic eum qui quo.",
  • "description": "The production environment for the MySQL multi-writer service",
  • "id": "se-123456",
  • "key": "production",
  • "name": "Production",
  • "promotionStatus": [
    ],
  • "roleType": "root|editor|reader|service_editor|service_reader|admin|service_operator",
  • "saasPortalStatus": "FAILED|CANCELLED|PENDING_DEPENDENCY|PENDING|RUNNING|DEPLOYING|UPLOADING|READY|SUCCESS|COMPLETE|DELETING|DELETED|UNKNOWN|DISCONNECTED|DISCONNECTING|CONNECTING|DEACTIVATED",
  • "saasPortalUrl": "https://saas-portal.example.com",
  • "serviceAuthPublicKey": "-----BEGIN PUBLIC KEY-----\nMFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAExXBS01nPRugGbKCN8m9sSSTkGvPT\n7a1Jn74No2dTkp+tQ+ZyBa7ClKbEXFaR2mzy06q0ivJAxPi1pixofIXE0Q==\n-----END PUBLIC KEY-----\n",
  • "serviceId": "s-123456",
  • "sourceEnvironmentId": "se-123456",
  • "type": "PROD|PRIVATE|CANARY|STAGING|QA|DEV|GLOBAL",
  • "visibility": "PUBLIC"
}

UpdateServiceEnvironment service-environment-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The ID of the service this environment belongs to

id
required
string
Example: se-12345678

The ID of the service environment

Request Body schema: application/json
required
autoApproveSubscription
boolean

Auto approve subscription or not

deploymentConfigId
string

The deployment configuration ID

description
string

A brief description of the service environment

name
string

Name of the Service Environment

serviceAuthPublicKey
string

PEM-encoded Public key part of the key used to sign the JWT tokens for the service control plane APIs

sourceEnvironmentId
string

The ID of the service environment to use for promoting changes to this environment

visibility
string

This parameter is used to configure the visibility of the service control-plane APIs

Responses

Request samples

Content type
application/json
{
  • "autoApproveSubscription": false,
  • "deploymentConfigId": "Non libero autem at a earum consequatur.",
  • "description": "The production environment for the MySQL multi-writer service",
  • "name": "Production",
  • "serviceAuthPublicKey": "-----BEGIN PUBLIC KEY-----\nMFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAExXBS01nPRugGbKCN8m9sSSTkGvPT\n7a1Jn74No2dTkp+tQ+ZyBa7ClKbEXFaR2mzy06q0ivJAxPi1pixofIXE0Q==\n-----END PUBLIC KEY-----\n",
  • "sourceEnvironmentId": "se-12345678",
  • "visibility": "PUBLIC"
}

PromoteServiceEnvironmentStatus service-environment-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The ID of the service this environment belongs to

id
required
string
Example: se-12345678

The ID of the service environment

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    },
  • {
    },
  • {
    }
]

PromoteServiceEnvironment service-environment-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The ID of the service this environment belongs to

id
required
string
Example: se-12345678

The ID of the service environment

Request Body schema: application/json
required
productTierId
string

The ID of the product tier to use for the promotion

productTierVersion
string

The product tier version to use for the promotion

Responses

Request samples

Content type
application/json
{
  • "productTierId": "Aut libero quaerat.",
  • "productTierVersion": "1.0"
}

service-model-api

CreateServiceModel service-model-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service this model is for

Request Body schema: application/json
required
accountConfigIds
Array of strings

The infrastructure account configuration ID list

description
required
string

A brief description of the service model

Array of objects (ServiceModelFeatureDetail)

Enabled service model features

modelType
required
string

The model type encapsulating this service

name
required
string

Name of the Service Model

serviceApiId
required
string

The service API this model is for

Responses

Request samples

Content type
application/json
{
  • "accountConfigIds": [
    ],
  • "description": "A MySQL Hosted SaaS specializing in multi-writer clusters for high availability",
  • "features": [
    ],
  • "modelType": "OMNISTRATE_HOSTED|CUSTOMER_HOSTED|BYOA",
  • "name": "MySQL multi-writer service hosted model",
  • "serviceApiId": "Ratione repellendus."
}

Response samples

Content type
application/json
"Cupiditate qui quam eos est."

DeleteServiceModel service-model-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID this model belongs to

id
required
string
Example: sm-12345678

The service model ID

Responses

DescribeServiceModel service-model-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID this model belongs to

id
required
string
Example: sm-12345678

The service model ID

Responses

Response samples

Content type
application/json
{
  • "accountConfigIds": [
    ],
  • "activeAccountConfigIds": {
    },
  • "description": "A MySQL Hosted SaaS specializing in multi-writer clusters for high availability",
  • "features": [
    ],
  • "id": "Impedit cumque rerum accusamus pariatur.",
  • "key": "mysql-multi-writer-service-hosted-model",
  • "modelType": "OMNISTRATE_HOSTED|CUSTOMER_HOSTED|BYOA",
  • "name": "MySQL multi-writer service hosted model",
  • "productTiers": [
    ],
  • "serviceApiId": "Ex quidem possimus possimus velit consequuntur omnis.",
  • "serviceId": "s-123456"
}

UpdateServiceModel service-model-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID this model belongs to

id
required
string
Example: sm-12345678

The service model ID

Request Body schema: application/json
required
description
string

A brief description of the service model

name
string

Name of the Service Model

Responses

Request samples

Content type
application/json
{
  • "description": "A MySQL Hosted SaaS specializing in multi-writer clusters for high availability",
  • "name": "MySQL multi-writer service hosted model"
}

RemoveAccountConfigFromServiceModel service-model-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID this model belongs to

id
required
string
Example: sm-12345678

The service model ID

Request Body schema: application/json
required
accountConfigId
required
string

The infrastructure account configuration ID

Responses

Request samples

Content type
application/json
{
  • "accountConfigId": "Corrupti perspiciatis qui aut id iusto vero."
}

AddAccountConfigToServiceModel service-model-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID this model belongs to

id
required
string
Example: sm-12345678

The service model ID

Request Body schema: application/json
required
accountConfigId
required
string

The infrastructure account configuration ID

Responses

Request samples

Content type
application/json
{
  • "accountConfigId": "Dolorem odio."
}

SetActiveAccountConfig service-model-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID this model belongs to

id
required
string
Example: sm-12345678

The service model ID

accountConfigId
required
string
Example: ac-12345678

The infrastructure account configuration ID

Responses

DisableServiceModelFeature service-model-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID this model belongs to

id
required
string
Example: sm-12345678

The service model ID

Request Body schema: application/json
required
feature
required
string

Responses

Request samples

Content type
application/json
{
  • "feature": "CUSTOM_NETWORKS|CUSTOM_TERRAFORM_POLICY|CUSTOM_AGENT_RBAC"
}

EnableServiceModelFeature service-model-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID this model belongs to

id
required
string
Example: sm-12345678

The service model ID

Request Body schema: application/json
required
required
object
feature
required
string

Responses

Request samples

Content type
application/json
{
  • "configuration": {
    },
  • "feature": "CUSTOM_NETWORKS|CUSTOM_TERRAFORM_POLICY|CUSTOM_AGENT_RBAC"
}

ReleaseServiceModelStatus service-model-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID this model belongs to

id
required
string
Example: sm-12345678

The service model ID

Responses

Response samples

Content type
application/json
{
  • "status": "DEPLOYING|READY|PENDING|FAILED|NOT_CONFIGURED"
}

CopyServiceModel service-model-api

DEPRECATED: Create a new service model from spec instead

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID this model belongs to

sourceId
required
string
Example: sm-12345678

The source service model ID

Request Body schema: application/json
required
accountConfigIds
Array of strings

The infrastructure account configuration ID list

description
required
string

A brief description of the service model

Array of objects (ServiceModelFeatureDetail)

Enabled service model features

name
required
string

Name of the Service Model

targetServiceModelType
required
string

The model type encapsulating this service

targetTierType
string

Target product tier type

Responses

Request samples

Content type
application/json
{
  • "accountConfigIds": [
    ],
  • "description": "A MySQL Hosted SaaS specializing in multi-writer clusters for high availability",
  • "features": [
    ],
  • "name": "MySQL multi-writer service hosted model",
  • "targetServiceModelType": "OMNISTRATE_HOSTED|CUSTOMER_HOSTED|BYOA",
  • "targetTierType": "OMNISTRATE_DEDICATED_TENANCY|OMNISTRATE_MULTI_TENANCY|CUSTOM_TENANCY"
}

Response samples

Content type
application/json
"Ipsum earum."

ListServiceModel service-model-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID

serviceApiId
required
string
Example: sa-12345678

The service API ID

Responses

Response samples

Content type
application/json
{
  • "ids": [
    ],
  • "nextPageToken": "next-token"
}

product-tier-api

ListProductTier product-tier-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

Service ID

serviceModelId
required
string
Example: sm-12345678

Service model ID

Responses

Response samples

Content type
application/json
{
  • "ids": [
    ],
  • "nextPageToken": "next-token"
}

CreateProductTier product-tier-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

Service ID

Request Body schema: application/json
required
allowCreatesWhenPaymentNotConfigured
boolean

Allow creates when payment not configured

autoApproveSubscription
boolean

Auto approve subscription or not

awsRegions
Array of strings

The AWS regions that this product tier is available on

azureRegions
Array of strings

The Azure regions that this product tier is available on

billingProductID
string

Optional billing product ID for tax purposes

billingProviders
Array of strings

List of billing providers to be used for the product tier

byocOnpremRegions
Array of strings

The BYOC on-prem regions that this product tier is available on

object (CustomMeteringConfiguration)
defaultBillingProvider
string

The default billing provider to be used for the product tier

object (ProductTierDeploymentConfiguration)
description
required
string

A brief description of the product tier

disableInvoiceGeneration
boolean

Whether Stripe invoice generation is disabled for this product tier

documentation
string

Documentation

enableDeletionProtection
boolean

Enable deletion protection for the product tier

exportUsageMetering
boolean

Export usage metering data

object

Export usage metering data configuration

gcpRegions
Array of strings

The GCP regions that this product tier is available on

isDisabled
boolean

Create the product tier in a disabled state. Enabling the product tier will let end-customers subscribe and use the service plan.

maxNumberOfInstances
integer <int64>

Maximum number of instances

name
required
string

Name of the product tier

nebiusRegions
Array of strings

The Nebius regions that this product tier is available on

ociRegions
Array of strings

The OCI regions that this product tier is available on

onPremPlatforms
Array of strings

The on prem platforms that this product tier is available on

planDescription
required
string

A brief description for the end user of the product tier

object

Price per unit.

pricing
any

Pricing

privateRegions
Array of strings

The private regions that this product tier is available on

serviceModelId
required
string

Service model ID

support
string

Support

tierType
required
string

Tier type

Responses

Request samples

Content type
application/json
{
  • "allowCreatesWhenPaymentNotConfigured": true,
  • "autoApproveSubscription": false,
  • "awsRegions": [
    ],
  • "azureRegions": [
    ],
  • "billingProductID": "abc123",
  • "billingProviders": [
    ],
  • "byocOnpremRegions": [
    ],
  • "customMetering": {
    },
  • "defaultBillingProvider": "STRIPE|BRING_YOUR_OWN",
  • "deploymentConfiguration": {
    },
  • "description": "A premium product tier",
  • "disableInvoiceGeneration": false,
  • "documentation": "Any documentation",
  • "enableDeletionProtection": false,
  • "exportUsageMetering": true,
  • "exportUsageMeteringConfig": {
    },
  • "gcpRegions": [
    ],
  • "isDisabled": false,
  • "maxNumberOfInstances": 5,
  • "name": "Premium",
  • "nebiusRegions": [
    ],
  • "ociRegions": [
    ],
  • "onPremPlatforms": [
    ],
  • "planDescription": "A premium plan",
  • "pricePerUnit": {
    },
  • "pricing": {
    },
  • "privateRegions": [
    ],
  • "serviceModelId": "Vel nihil consequatur reiciendis voluptas rem vitae.",
  • "support": "Any support",
  • "tierType": "OMNISTRATE_DEDICATED_TENANCY|OMNISTRATE_MULTI_TENANCY|CUSTOM_TENANCY"
}

Response samples

Content type
application/json
"Et reprehenderit quo."

DeleteProductTier product-tier-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

Service ID

id
required
string
Example: pt-12345678

Product tier ID

Responses

DescribeProductTier product-tier-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

Service ID

id
required
string
Example: pt-12345678

Product tier ID

query Parameters
version
string
Example: version=3.0

The version number for the specific version set

Responses

Response samples

Content type
application/json
{
  • "allowCreatesWhenPaymentNotConfigured": true,
  • "apiGroups": {
    },
  • "autoApproveSubscription": false,
  • "awsRegions": [
    ],
  • "azureRegions": [
    ],
  • "billingProductID": "abc123",
  • "billingProviders": [
    ],
  • "byocOnpremRegions": [
    ],
  • "cloudProvidersConfigReadiness": {
    },
  • "customMetering": {
    },
  • "defaultBillingProvider": "STRIPE|BRING_YOUR_OWN",
  • "deploymentArtifactIDs": [
    ],
  • "deploymentConfiguration": {
    },
  • "description": "A premium product tier",
  • "disableInvoiceGeneration": false,
  • "documentation": "Any documentation",
  • "enableDeletionProtection": false,
  • "enabledFeatures": [
    ],
  • "exportUsageMetering": true,
  • "exportUsageMeteringConfig": {
    },
  • "features": {
    },
  • "gcpRegions": [
    ],
  • "id": "Ut aut quia perferendis repudiandae velit est.",
  • "isDisabled": false,
  • "key": "premium",
  • "maxNumberOfInstances": 5,
  • "name": "Premium",
  • "nebiusRegions": [
    ],
  • "ociRegions": [
    ],
  • "onPremPlatforms": [
    ],
  • "planDescription": "A premium plan",
  • "pricePerUnit": {
    },
  • "pricing": {
    },
  • "privateRegions": [
    ],
  • "serviceId": "s-123456",
  • "serviceModelId": "Asperiores nulla dicta.",
  • "support": "Any support",
  • "tierType": "OMNISTRATE_DEDICATED_TENANCY|OMNISTRATE_MULTI_TENANCY|CUSTOM_TENANCY"
}

UpdateProductTier product-tier-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

Service ID

id
required
string
Example: pt-12345678

Product tier ID

Request Body schema: application/json
required
allowCreatesWhenPaymentNotConfigured
boolean

Allow creates when payment not configured

autoApproveSubscription
boolean

Auto approve subscription or not

awsRegions
Array of strings

The AWS regions that this product tier is available on

azureRegions
Array of strings

The Azure regions that this product tier is available on

billingProductID
string

Optional billing product ID for tax purposes

billingProviders
Array of strings

List of billing providers to be used for the product tier

byocOnpremRegions
Array of strings

The BYOC on-prem regions that this product tier is available on

object (CustomMeteringConfiguration)
defaultBillingProvider
string

The default billing provider to be used for the product tier

object (ProductTierDeploymentConfiguration)
description
string

A brief description of the product tier

disableInvoiceGeneration
boolean

Whether Stripe invoice generation is disabled for this product tier

documentation
string

Documentation

enableDeletionProtection
boolean

Enable deletion protection for the product tier

exportUsageMetering
boolean

Export usage metering data

object

Export usage metering data configuration

gcpRegions
Array of strings

The GCP regions that this product tier is available on

isDisabled
boolean

Update the product tier's state as enabled/disabled. Enabling the product tier will let end-customers subscribe and use the service plan.

maxNumberOfInstances
integer <int64>

Maximum number of instances. Set to -1 for unlimited.

name
string

Name of the product tier

nebiusRegions
Array of strings

The Nebius regions that this product tier is available on

ociRegions
Array of strings

The OCI regions that this product tier is available on

onPremPlatforms
Array of strings

The on prem platforms that this product tier is available on

planDescription
string

A brief description for the end user of the product tier

object

Price per unit.

pricing
any

Pricing

privateRegions
Array of strings

The private regions that this product tier is available on

support
string

Support

tierType
string

Tier type

Responses

Request samples

Content type
application/json
{
  • "allowCreatesWhenPaymentNotConfigured": true,
  • "autoApproveSubscription": false,
  • "awsRegions": [
    ],
  • "azureRegions": [
    ],
  • "billingProductID": "abc123",
  • "billingProviders": [
    ],
  • "byocOnpremRegions": [
    ],
  • "customMetering": {
    },
  • "defaultBillingProvider": "STRIPE|BRING_YOUR_OWN",
  • "deploymentConfiguration": {
    },
  • "description": "A premium product tier",
  • "disableInvoiceGeneration": false,
  • "documentation": "Any documentation",
  • "enableDeletionProtection": false,
  • "exportUsageMetering": true,
  • "exportUsageMeteringConfig": {
    },
  • "gcpRegions": [
    ],
  • "isDisabled": false,
  • "maxNumberOfInstances": 5,
  • "name": "Premium",
  • "nebiusRegions": [
    ],
  • "ociRegions": [
    ],
  • "onPremPlatforms": [
    ],
  • "planDescription": "A premium plan",
  • "pricePerUnit": {
    },
  • "pricing": {
    },
  • "privateRegions": [
    ],
  • "support": "Any support",
  • "tierType": "OMNISTRATE_DEDICATED_TENANCY|OMNISTRATE_MULTI_TENANCY|CUSTOM_TENANCY"
}

DisableProductTierFeature product-tier-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

Service ID

id
required
string
Example: pt-12345678

Product tier ID

Request Body schema: application/json
required
feature
required
string

Feature to disable

scope
string

Feature scope

Responses

Request samples

Content type
application/json
{
  • "feature": "LOGS|METRICS|CLOUD_INSURANCE|MARKETPLACE|OPERATIONAL_STATUS|COMPLIANCE|APPLICATION_SECURITY",
  • "scope": "INTERNAL|CUSTOMER"
}

EnableProductTierFeature product-tier-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

Service ID

id
required
string
Example: pt-12345678

Product tier ID

Request Body schema: application/json
required
object

The configuration parameters of the product tier feature

feature
required
string

Feature to enable

scope
string

Feature scope

Responses

Request samples

Content type
application/json
{
  • "configuration": {
    },
  • "feature": "LOGS|METRICS|CLOUD_INSURANCE|MARKETPLACE|OPERATIONAL_STATUS|COMPLIANCE|APPLICATION_SECURITY",
  • "scope": "INTERNAL|CUSTOMER"
}

DescribeProductTierWorkspaceArtifacts product-tier-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

Service ID

id
required
string
Example: pt-12345678

Product tier ID

workspaceArtifactId
required
string
Example: ws-da-12345678

The workspace artifact archive ID

query Parameters
version
string
Example: version=3.0

The product tier version to use. If omitted, the latest product tier workspace artifacts are used.

Responses

Response samples

Content type
application/json
{
  • "lastFailedReason": "Failed to package deployment artifacts",
  • "status": "FAILED|CANCELLED|PENDING_DEPENDENCY|PENDING|RUNNING|DEPLOYING|UPLOADING|READY|SUCCESS|COMPLETE|DELETING|DELETED|UNKNOWN|DISCONNECTED|DISCONNECTING|CONNECTING|DEACTIVATED",
  • "workspaceArtifactId": "Repellat ut maiores."
}

DownloadProductTierWorkspaceArtifacts product-tier-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

Service ID

id
required
string
Example: pt-12345678

Product tier ID

query Parameters
workspaceArtifactId
string
Example: workspaceArtifactId=ws-da-12345678

The workspace artifact archive ID to download. If omitted, the latest prepared workspace artifact archive is used.

version
string
Example: version=3.0

The product tier version to use. If omitted, the latest product tier workspace artifacts are used.

Responses

Response samples

Content type
application/json
"string"

GetProductTierWorkspaceArtifactsDownloadURL product-tier-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

Service ID

id
required
string
Example: pt-12345678

Product tier ID

query Parameters
workspaceArtifactId
string
Example: workspaceArtifactId=ws-da-12345678

The workspace artifact archive ID to download. If omitted, the latest prepared workspace artifact archive is used.

version
string
Example: version=3.0

The product tier version to use. If omitted, the latest product tier workspace artifacts are used.

Responses

Response samples

PrepareProductTierWorkspaceArtifacts product-tier-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

Service ID

id
required
string
Example: pt-12345678

Product tier ID

query Parameters
version
string
Example: version=3.0

The product tier version to use. If omitted, the latest product tier workspace artifacts are used.

Responses

Response samples

Content type
application/json
{
  • "lastFailedReason": "Failed to package deployment artifacts",
  • "status": "FAILED|CANCELLED|PENDING_DEPENDENCY|PENDING|RUNNING|DEPLOYING|UPLOADING|READY|SUCCESS|COMPLETE|DELETING|DELETED|UNKNOWN|DISCONNECTED|DISCONNECTING|CONNECTING|DEACTIVATED",
  • "workspaceArtifactId": "Rerum cum similique assumenda numquam ut et."
}

CopyProductTier product-tier-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

Service ID

sourceId
required
string
Example: pt-12345678

The source product tier ID

Request Body schema: application/json
required
allowCreatesWhenPaymentNotConfigured
boolean

Allow creates when payment not configured

autoApproveSubscription
boolean

Auto approve subscription or not

awsRegions
Array of strings

The AWS regions that this product tier is available on

azureRegions
Array of strings

The Azure regions that this product tier is available on

billingProductID
string

Optional billing product ID for tax purposes

byocOnpremRegions
Array of strings

The BYOC on-prem regions that this product tier is available on

object (CustomMeteringConfiguration)
description
required
string

A brief description of the product tier

documentation
string

Documentation

enableDeletionProtection
boolean

Enable deletion protection for the product tier

exportUsageMetering
boolean

Export usage metering data

object

Export usage metering data configuration

gcpRegions
Array of strings

The GCP regions that this product tier is available on

maxNumberOfInstances
integer <int64>

Maximum number of instances

name
required
string

Name of the product tier

nebiusRegions
Array of strings

The Nebius regions that this product tier is available on

ociRegions
Array of strings

The OCI regions that this product tier is available on

onPremPlatforms
Array of strings

The on prem platforms that this product tier is available on

planDescription
string

A brief description for the end user of the product tier

object

Price per unit.

pricing
any

Pricing

privateRegions
Array of strings

The Private cloud regions that this product tier is available on

serviceModelId
required
string

Service model ID

support
string

Support

targetTierType
string

Tier type

Responses

Request samples

Content type
application/json
{
  • "allowCreatesWhenPaymentNotConfigured": true,
  • "autoApproveSubscription": false,
  • "awsRegions": [
    ],
  • "azureRegions": [
    ],
  • "billingProductID": "abc123",
  • "byocOnpremRegions": [
    ],
  • "customMetering": {
    },
  • "description": "A premium product tier",
  • "documentation": "Any documentation",
  • "enableDeletionProtection": false,
  • "exportUsageMetering": true,
  • "exportUsageMeteringConfig": {
    },
  • "gcpRegions": [
    ],
  • "maxNumberOfInstances": 5,
  • "name": "Premium",
  • "nebiusRegions": [
    ],
  • "ociRegions": [
    ],
  • "onPremPlatforms": [
    ],
  • "planDescription": "A premium plan",
  • "pricePerUnit": {
    },
  • "pricing": {
    },
  • "privateRegions": [
    ],
  • "serviceModelId": "Provident tenetur tempora.",
  • "support": "Any support",
  • "targetTierType": "OMNISTRATE_DEDICATED_TENANCY|OMNISTRATE_MULTI_TENANCY|CUSTOM_TENANCY"
}

Response samples

Content type
application/json
"Incidunt doloremque."

service-api-api

CreateServiceAPI service-api-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID that this API bundle belongs to

Request Body schema: application/json
required
description
required
string

A brief description of the service API bundle

serviceEnvironmentId
required
string

The service environment ID

Responses

Request samples

Content type
application/json
{
  • "description": "A MySQL SaaS API specializing in multi-writer multi-tenant clusters for high availability",
  • "serviceEnvironmentId": "se-123456"
}

Response samples

Content type
application/json
"Architecto reiciendis ducimus accusamus modi soluta aut."

DeleteServiceAPI service-api-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID that this API bundle belongs to

id
required
string
Example: sa-12345678

The service API ID

Responses

DescribeServiceAPI service-api-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID that this API bundle belongs to

id
required
string
Example: sa-12345678

The service API ID

Responses

Response samples

Content type
application/json
{
  • "apiVersion": "v1",
  • "deploymentConfigId": "Expedita similique est modi ut.",
  • "description": "A MySQL SaaS API specializing in multi-writer multi-tenant clusters for high availability",
  • "id": "Corporis qui nam quam unde temporibus quos.",
  • "serviceEnvironmentId": "se-123456",
  • "serviceId": "s-123456",
  • "serviceName": "mysql"
}

UpdateServiceAPI service-api-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID that this API bundle belongs to

id
required
string
Example: sa-12345678

The service API ID

Request Body schema: application/json
required
description
string

A brief description of the service API bundle

Responses

Request samples

Content type
application/json
{
  • "description": "A MySQL SaaS API specializing in multi-writer multi-tenant clusters for high availability"
}

DiscardPendingChanges service-api-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID that this API bundle belongs to

id
required
string
Example: sa-12345678

The service API ID

query Parameters
productTierId
string
Example: productTierId=pt-12345678

ProductTierID of the resource to describe pending changes forNeeds to specified in combination with the product tier version

Responses

DescribePendingChanges service-api-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID that this API bundle belongs to

id
required
string
Example: sa-12345678

The service API ID

query Parameters
productTierId
string
Example: productTierId=pt-12345678

ProductTierID of the resource to describe pending changes forNeeds to specified in combination with the product tier version

Responses

Response samples

Content type
application/json
{
  • "id": "Atque animi quia asperiores aut.",
  • "resourceChangeSets": {
    },
  • "serviceId": "s-123456"
}

DeprecateServiceAPI service-api-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID that this API bundle belongs to

id
required
string
Example: sa-12345678

The service API ID

Responses

ReleaseServiceAPI service-api-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID that this API bundle belongs to

id
required
string
Example: sa-12345678

The service API ID

Request Body schema: application/json
required
copySpecFromPreviousVersion
boolean
Default: false

When true, copies the specification from the previous version during the release operation.

dryRun
boolean
Default: false

When true, performs a dry run of the release operation without making any actual changes to the current pending changes and the service API.

isPreferred
boolean
Default: false

Indicates whether this version set is preferred.

productTierId
string

The product tier ID

versionSetName
string

The name of the version set to release

versionSetType
string

The version-set type of the product-tier.

Responses

Request samples

Content type
application/json
{
  • "copySpecFromPreviousVersion": false,
  • "dryRun": false,
  • "isPreferred": true,
  • "productTierId": "Dolore aspernatur.",
  • "versionSetName": "v1",
  • "versionSetType": "Major|Incremental|UserDefined"
}

ListServiceAPI service-api-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID that this API bundle belongs to

serviceEnvironmentId
required
string
Example: se-12345678

The service environment ID

Responses

Response samples

Content type
application/json
{
  • "ids": [
    ],
  • "nextPageToken": "next-token"
}

service-plan-api

ListServicePlans service-plan-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

Service ID

serviceEnvironmentId
required
string
Example: se-12345678

Service environment ID

query Parameters
nextPageToken
string
Example: nextPageToken=token

The next token to use for pagination

pageSize
integer <int64>
Example: pageSize=10

The number of resources to return per page

skipHasPendingChangesCheck
boolean
Example: skipHasPendingChangesCheck=false

Skip the check for pending changes in the service plans

Responses

Response samples

Content type
application/json
{
  • "nextPageToken": "next-token",
  • "servicePlans": [
    ]
}

GetServicePlan service-plan-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

Service ID

productTierId
required
string
Example: pt-12345678

Product tier ID

Responses

Response samples

Content type
application/json
{
  • "AutoApproveSubscription": false,
  • "accountConfigIds": [
    ],
  • "activeAccountConfigIds": {
    },
  • "apiVersion": "v1",
  • "awsRegions": [
    ],
  • "azureRegions": [
    ],
  • "byocOnpremRegions": [
    ],
  • "deploymentConfigId": "Velit sed inventore qui.",
  • "gcpRegions": [
    ],
  • "hasPendingChanges": true,
  • "isProductTierDisabled": true,
  • "latestMajorVersion": "3.0",
  • "modelType": "OMNISTRATE_HOSTED|CUSTOMER_HOSTED|BYOA",
  • "nebiusRegions": [
    ],
  • "ociRegions": [
    ],
  • "onPremPlatforms": [
    ],
  • "privateRegions": [
    ],
  • "productTierDescription": "A premium product tier",
  • "productTierDocumentation": "Any documentation",
  • "productTierFeatures": {
    },
  • "productTierId": "Ut sint laudantium porro ex et eos.",
  • "productTierKey": "premium",
  • "productTierName": "Premium",
  • "productTierPlanDescription": "A premium plan",
  • "productTierPricing": {
    },
  • "productTierSupport": "Any support",
  • "serviceApiDescription": "A MySQL SaaS API specializing in multi-writer multi-tenant clusters for high availability",
  • "serviceApiId": "Eum sed et quam quidem quia.",
  • "serviceEnvironmentId": "se-123456",
  • "serviceModelDescription": "A MySQL Hosted SaaS specializing in multi-writer clusters for high availability",
  • "serviceModelFeatures": [
    ],
  • "serviceModelId": "Architecto autem cupiditate eius enim temporibus.",
  • "serviceModelName": "MySQL multi-writer service hosted model",
  • "tierType": "OMNISTRATE_DEDICATED_TENANCY|OMNISTRATE_MULTI_TENANCY|CUSTOM_TENANCY",
  • "versionSetStatus": "Preferred|Active|Deprecated|Pending"
}

resource-api

ListResources resource-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: si-12345678

The ID of the service to list resources for

productTierId
required
string
Example: pt-12345678

The product tier ID

query Parameters
managed
boolean
Example: managed=false

Is resource managed by omnistrate

ProductTierVersion
string
Example: ProductTierVersion=Blanditiis id voluptas ipsa nihil atque et.

Product tier version of the instance to describe. If not specified, the latest version is described.

Responses

Response samples

Content type
application/json
{
  • "ids": [
    ],
  • "nextPageToken": "next-token",
  • "resources": [
    ]
}

CreateResource resource-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID that this API bundle belongs to

Request Body schema: application/json
required
object (AdditionalSecurityContext)
object (AgentConfiguration)
object (BackupConfiguration)
object (BlobStorageConfiguration)
object (ContainerImagesRegistryCopyConfiguration)
object

Custom labels for the resource

object

Custom sysctl settings for the resource

Array of objects (CustomULimits)

Custom ulimits for the resource

object (DeploymentTarget)

The deployment target configuration for the resource

description
required
string

A brief description of the resource

disable
string

Allows resource to be disabled. Expression returning true/false can be used as value. Resource is enabled by default, if this property is not set.

Array of objects (EnvironmentVariable)

The environment variables that this resource requires

object (FileSystemConfiguration)
object (HelmChartConfiguration)
imageConfigId
string

The ID of the image configuration that this resource refers to

infraConfigId
string

The ID of the infrastructure configuration that this resource refers to

internal
boolean
Default: false

Whether this resource is internal or not

isProxy
boolean
Default: false

Whether this resource is a proxy or not

object (JobConfig)
key
string

The key of the resource

object (KustomizeConfiguration)
object (L4LoadBalancerConfiguration)
object (L7LoadBalancerConfiguration)
name
required
string

Name of the resource

object

The Terraform configurations for various OnPrem platforms

object (OperatorCRDConfiguration)
productTierId
required
string

The product tier ID

proxyType
string
Default: "PortsBasedProxy"

A proxy type of resource

Array of objects (ResourceDependency)
resourceType
string

The type of the resource

object

The Terraform configurations for various cloud providers

Responses

Request samples

Content type
application/json
{
  • "additionalSecurityContext": {
    },
  • "agentConfiguration": {
    },
  • "backupConfiguration": {
    },
  • "blobStorageConfiguration": {
    },
  • "containerImagesRegistryCopyConfiguration": {
    },
  • "customLabels": {
    },
  • "customSysCTLs": {
    },
  • "customULimits": [
    ],
  • "deploymentTarget": {
    },
  • "description": "A resource to manage a hosted public SaaS offering of a multi-writer MySQL service",
  • "disable": "{{ $var.disableExtraComponents }}",
  • "environmentVariables": [
    ],
  • "fileSystemConfiguration": {
    },
  • "helmChartConfiguration": {
    },
  • "imageConfigId": "Excepturi voluptas.",
  • "infraConfigId": "Ea quo qui tempora aut.",
  • "internal": true,
  • "isProxy": false,
  • "jobConfig": {
    },
  • "key": "galera",
  • "kustomizeConfiguration": {
    },
  • "l4LoadBalancerConfiguration": {
    },
  • "l7LoadBalancerConfiguration": {
    },
  • "name": "Galera",
  • "onPremTerraformConfigurations": {
    },
  • "operatorCRDConfiguration": {
    },
  • "productTierId": "Inventore esse optio est voluptatibus.",
  • "proxyType": "PortsBasedProxy",
  • "resourceDependencies": [
    ],
  • "resourceType": "|Generic|PortsBasedProxy|L4LoadBalancer|L7LoadBalancer|FileSystem|OperatorCRD|HelmChart|Kustomize",
  • "terraformConfigurations": {
    }
}

Response samples

Content type
application/json
"Vitae odit veniam."

DeleteResource resource-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID that this API bundle belongs to

id
required
string
Example: r-12345678

The ID of the resource

query Parameters
dryRun
boolean
Default: false
Example: dryRun=false

If true, validates the deletion without actually deleting the resource

Responses

DescribeResource resource-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID that this API bundle belongs to

id
required
string
Example: r-12345678

The ID of the resource

query Parameters
ProductTierVersion
string
Example: ProductTierVersion=Repellat assumenda rerum nulla consectetur rerum.

Product tier version of the resource to describe. If not specified, the latest version is described.

ProductTierId
string
Example: ProductTierId=Ad a officiis est nobis debitis eos.

ProductTierId of the resource to describe. Needs to specified in combination with the product tier version

Responses

Response samples

Content type
application/json
{
  • "actionHooks": [
    ],
  • "additionalSecurityContext": {
    },
  • "agentConfiguration": {
    },
  • "backupConfiguration": {
    },
  • "blobStorageConfiguration": {
    },
  • "capabilities": [
    ],
  • "containerImagesRegistryCopyConfiguration": {
    },
  • "customLabels": {
    },
  • "customSysCTLs": {
    },
  • "customULimits": [
    ],
  • "dependencies": [
    ],
  • "deploymentTarget": {
    },
  • "description": "An resource to manage a hosted public SaaS offering of a multi-writer MySQL service",
  • "disable": "{{ $var.disableExtraComponents }}",
  • "environmentVariables": [
    ],
  • "fileSystemConfiguration": {
    },
  • "helmChartConfiguration": {
    },
  • "id": "Voluptate molestias ipsum consectetur.",
  • "imageConfigId": "Ut assumenda aperiam in sequi ipsam non.",
  • "infraConfigId": "Quasi velit maiores iusto harum.",
  • "internal": false,
  • "isDeprecated": false,
  • "jobConfig": {
    },
  • "key": "galera",
  • "kustomizeConfiguration": {
    },
  • "l4LoadBalancerConfiguration": {
    },
  • "l7LoadBalancerConfiguration": {
    },
  • "name": "Galera",
  • "onPremTerraformConfigurations": {
    },
  • "operatorCRDConfiguration": {
    },
  • "productTierId": "Et dolorem quia explicabo consequatur ut nulla.",
  • "proxyType": "PortsBasedProxy",
  • "resourceType": "|Generic|PortsBasedProxy|L4LoadBalancer|L7LoadBalancer|FileSystem|OperatorCRD|HelmChart|Kustomize",
  • "serviceId": "s-123456",
  • "terraformConfigurations": {
    }
}

UpdateResource resource-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID that this API bundle belongs to

id
required
string
Example: r-12345678

The ID of the resource

Request Body schema: application/json
required
object (AdditionalSecurityContext)
object (AgentConfiguration)
object (BackupConfiguration)
object (ContainerImagesRegistryCopyConfiguration)
object

Custom labels for the resource

object

Custom sysctl settings for the resource

Array of objects (CustomULimits)

Custom ulimits for the resource

Array of objects (ResourceDependency)
object (DeploymentTarget)

The deployment target configuration for the resource

description
string

A brief description of the resource

disable
string

Allows resource to be disabled. Expression returning true/false can be used as value. Resource is enabled by default, if this property is not set.

Array of objects (EnvironmentVariable)

The environment variables that this resource requires

object (FileSystemConfiguration)
object (HelmChartConfiguration)
imageConfigId
string

The ID of the image configuration that this resource refers to

infraConfigId
string

The ID of the infrastructure configuration that this resource refers to

object (JobConfig)
object (KustomizeConfiguration)
object (L4LoadBalancerConfiguration)
object (L7LoadBalancerConfiguration)
name
string

Name of the resource

object

The Terraform configurations for various OnPrem platforms

object (OperatorCRDConfiguration)
object

The Terraform configurations for various cloud providers

Responses

Request samples

Content type
application/json
{
  • "additionalSecurityContext": {
    },
  • "agentConfiguration": {
    },
  • "backupConfiguration": {
    },
  • "containerImagesRegistryCopyConfiguration": {
    },
  • "customLabels": {
    },
  • "customSysCTLs": {
    },
  • "customULimits": [
    ],
  • "dependencies": [
    ],
  • "deploymentTarget": {
    },
  • "description": "A resource to manage a hosted public SaaS offering of a multi-writer MySQL service",
  • "disable": "{{ $var.disableExtraComponents }}",
  • "environmentVariables": [
    ],
  • "fileSystemConfiguration": {
    },
  • "helmChartConfiguration": {
    },
  • "imageConfigId": "Reprehenderit aut.",
  • "infraConfigId": "Sequi ducimus.",
  • "jobConfig": {
    },
  • "kustomizeConfiguration": {
    },
  • "l4LoadBalancerConfiguration": {
    },
  • "l7LoadBalancerConfiguration": {
    },
  • "name": "Galera",
  • "onPremTerraformConfigurations": {
    },
  • "operatorCRDConfiguration": {
    },
  • "terraformConfigurations": {
    }
}

DeregisterActionHook resource-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The ID of the service to which the hook belongs

id
required
string
Example: r-12345678

The ID of the resource to which the hook belongs

Request Body schema: application/json
required
scope
required
string

The scope of the hook

type
required
string

The type of hook to execute

Responses

Request samples

Content type
application/json
{
  • "scope": "CLUSTER|NODE",
  • "type": "INIT|ADD|REMOVE|PROMOTE|DEMOTE|HEALTH_CHECK|READINESS_CHECK|STARTUP_CHECK|PRE_START|POST_START|PRE_UPGRADE|POST_UPGRADE|PRE_STOP|POST_STOP"
}

ListActionHooks resource-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The ID of the service to which the hook belongs

id
required
string
Example: r-12345678

The ID of the resource to which the hook belongs

Responses

Response samples

Content type
application/json
{
  • "hooks": [
    ]
}

RegisterActionHook resource-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The ID of the service to which the hook belongs

id
required
string
Example: r-12345678

The ID of the resource to which the hook belongs

Request Body schema: application/json
required
commandTemplate
required
string

The Base64 encoded command template to execute

customCommand
Array of strings

The custom command to execute the hook with

customImage
string

The custom image to execute the hook

scope
required
string

The scope of the hook

type
required
string

The type of hook to execute

Responses

Request samples

Content type
application/json
{
  • "commandTemplate": "ZWNobyAiaGVsbG8gd29ybGQi",
  • "customCommand": [
    ],
  • "customImage": "my-custom-image:latest",
  • "scope": "CLUSTER|NODE",
  • "type": "INIT|ADD|REMOVE|PROMOTE|DEMOTE|HEALTH_CHECK|READINESS_CHECK|STARTUP_CHECK|PRE_START|POST_START|PRE_UPGRADE|POST_UPGRADE|PRE_STOP|POST_STOP"
}

DisableResourceCapability resource-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID that this API bundle belongs to

id
required
string
Example: r-12345678

The ID of the resource

Request Body schema: application/json
required
capability
required
string

The capability to disable

Responses

Request samples

Content type
application/json
{
  • "capability": "SERVERLESS|SERVICE_ACCOUNT_POLICIES|PROCESS_CORE_DUMP|CUSTOM_DNS|SIDECARS"
}

ListResourceCapabilities resource-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID that this API bundle belongs to

id
required
string
Example: r-12345678

The ID of the resource

query Parameters
ProductTierVersion
string
Example: ProductTierVersion=Non non.

Product tier version of the instance to describe. If not specified, the latest version is described.

ProductTierId
string
Example: ProductTierId=Ad a officiis est nobis debitis eos.

Product tier id of the instance to describe. Needs to specified in combination with the product tier version

Responses

Response samples

Content type
application/json
{
  • "capabilities": [
    ]
}

EnableResourceCapability resource-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID that this API bundle belongs to

id
required
string
Example: r-12345678

The ID of the resource

Request Body schema: application/json
required
capability
required
string

The type of capability of a resource

object

The configuration parameters of a capability of a resource

Responses

Request samples

Content type
application/json
{
  • "capability": "SERVERLESS|SERVICE_ACCOUNT_POLICIES|PROCESS_CORE_DUMP|CUSTOM_DNS|SIDECARS",
  • "configuration": {
    }
}

ListDependentResource resource-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID that this API bundle belongs to

id
required
string
Example: r-12345678

The ID of the resource

Responses

Response samples

Content type
application/json
{
  • "id": "Est nihil.",
  • "ids": [
    ],
  • "nextPageToken": "next-token",
  • "serviceId": "s-123456"
}

DeprecateResource resource-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID that this API bundle belongs to

id
required
string
Example: r-12345678

The ID of the resource

Responses

UnsetEnvironmentVariables resource-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID that this API bundle belongs to

id
required
string
Example: r-12345678

The ID of the resource

Request Body schema: application/json
required
Array of objects (EnvironmentVariable)

The environment variables that this resource is no longer dependent on

Responses

Request samples

Content type
application/json
{
  • "environmentVariables": [
    ]
}

SetEnvironmentVariables resource-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID that this API bundle belongs to

id
required
string
Example: r-12345678

The ID of the resource

Request Body schema: application/json
required
Array of objects (EnvironmentVariable)

The environment variables that this resource requires

Responses

Request samples

Content type
application/json
{
  • "environmentVariables": [
    ]
}

ListFiles resource-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID that this API bundle belongs to

id
required
string
Example: r-12345678

The ID of the resource

query Parameters
productTierId
string
Example: productTierId=pt-12345678

ProductTierId of the config file to describe

productTierVersion
string
Example: productTierVersion=1.0

Product tier version of the config file to describe. If missing, last version is described

Responses

Response samples

Content type
application/json
{
  • "files": [
    ]
}

AddFile resource-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID that this API bundle belongs to

id
required
string
Example: r-12345678

The ID of the resource

header Parameters
Content-Type
stringmultipart/[^;]+; boundary=.+
Default: multipart/form-data; boundary=boundary
Example: multipart/form-data; boundary=boundary

Content-Type header, must define value for multipart boundary.

Name
required
string
Example: file.txt

The name of the file

Description
required
string
Example: A file to store the configuration for the resource

The description of the file

FileType
required
string
Example: Config

The type of the file

MountPath
required
string
Example: /etc/config

The mount path of the file

Responses

Response samples

Content type
application/json
"Sint cupiditate non dolores eligendi."

RemoveFile resource-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID that this API bundle belongs to

id
required
string
Example: r-12345678

The ID of the resource

fileId
required
string
Example: file-12345678

The ID of the file

Responses

GetFile resource-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID that this API bundle belongs to

id
required
string
Example: r-12345678

The ID of the resource

fileId
required
string
Example: f-12345678

The ID of the file

query Parameters
productTierId
string
Example: productTierId=pt-12345678

Product Tier ID of the config files to list

productTierVersion
string
Example: productTierVersion=1.0

Product Tier version of the config files to list. If missing, last version is used

Responses

Response samples

Content type
application/json
"string"

UpdateFileContent resource-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID that this API bundle belongs to

id
required
string
Example: r-12345678

The ID of the resource

fileId
required
string
Example: f-12345678

The ID of the file

header Parameters
Content-Type
stringmultipart/[^;]+; boundary=.+
Default: multipart/form-data; boundary=boundary
Example: multipart/form-data; boundary=boundary

Content-Type header, must define value for multipart boundary.

Responses

UpdateFileMetadata resource-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID that this API bundle belongs to

id
required
string
Example: r-12345678

The ID of the resource

fileId
required
string
Example: f-12345678

The ID of the file

Request Body schema: application/json
required
description
string

The description of the file

mountPath
string

The mount path of the file

name
string

The name of the file

Responses

Request samples

Content type
application/json
{
  • "description": "A file to store the configuration for the resource",
  • "mountPath": "/etc/config",
  • "name": "file.txt"
}

DeregisterResourceMetricsConfig resource-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID that this API bundle belongs to

id
required
string
Example: r-12345678

The ID of the resource

Responses

DescribeResourceMetricsConfig resource-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID that this API bundle belongs to

id
required
string
Example: r-12345678

The ID of the resource

query Parameters
ProductTierVersion
string
Example: ProductTierVersion=Adipisci ullam esse odio illum.

Product tier version of the resource to describe. If not specified, the latest version is described.

ProductTierId
string
Example: ProductTierId=Ad a officiis est nobis debitis eos.

ProductTierId of the resource to describe. Needs to specified in combination with the product tier version

Responses

Response samples

Content type
application/json
{}

RegisterResourceMetricsConfig resource-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID that this API bundle belongs to

id
required
string
Example: r-12345678

The ID of the resource

Request Body schema: application/json
required
metricEndpoint
required
string

The local host endpoint to supply prometheus metric

Responses

Request samples

Content type
application/json
{}

RemoveResourceDependency resource-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID that this API bundle belongs to

id
required
string
Example: r-12345678

The ID of the resource

resourceDependencyId
required
string
Example: r-12345678

The ID of the resource dependency to remove

Responses

AddResourceDependency resource-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID that this API bundle belongs to

id
required
string
Example: r-12345678

The ID of the resource

resourceDependencyId
required
string
Example: r-12345678

The ID of the resource to be added as a dependency

Request Body schema: application/json
required
object

A map of the source parameter to the dependency resource parameter

Responses

Request samples

Content type
application/json
{
  • "parameterMap": {
    }
}

UndeprecateResource resource-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID that this API bundle belongs to

id
required
string
Example: r-12345678

The ID of the resource

Responses

custom-workflow-api

DeleteCustomWorkflow custom-workflow-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The ID of the service that this workflow belongs to

id
required
string
Example: cwt-12345678

The custom workflow ID

Responses

DescribeCustomWorkflow custom-workflow-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The ID of the service that this workflow belongs to

id
required
string
Example: cwt-12345678

The custom workflow ID

query Parameters
productTierVersion
string
Example: productTierVersion=Quae vel ut provident sunt sunt laudantium.

Product tier version of the workflow to describe. If not specified, the latest version is described.

productTierId
string
Example: productTierId=pt-12345678

Product tier ID of the workflow to describe. Needs to be specified in combination with the product tier version

Responses

Response samples

Content type
application/json
{
  • "apiParameters": [
    ],
  • "configuration": {
    },
  • "description": "Trigger an on-demand backup for the operator-managed service",
  • "id": "Quibusdam animi qui doloremque qui.",
  • "isSystemWorkflow": true,
  • "name": "Backup now",
  • "outputParameterSpecs": [
    ],
  • "outputParameters": {
    },
  • "productTierId": "Excepturi qui nihil quaerat.",
  • "scope": [
    ],
  • "serviceId": "s-123456",
  • "spec": {
    },
  • "verb": "SWITCHOVER"
}

UpdateCustomWorkflow custom-workflow-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The ID of the service that this workflow belongs to

id
required
string
Example: cwt-12345678

The custom workflow ID

Request Body schema: application/json
required
Array of objects (InputParameterEntity)

The API parameters that users provide when invoking this workflow

object

Workflow-specific configuration as a flexible key-value map. For backup workflows: backupRetentionInDays (int), backupPeriodInHours (int), snapshotBeforeDeletion (bool). New properties can be added without API or schema changes.

description
string

A brief description of the workflow

name
string

The display name of the workflow

Array of objects (WorkflowOutputParameterSpec)

Typed declarations of the output parameters this workflow produces.

scope
Array of strings

The user context scopes that can invoke this workflow

spec
any

The workflow definition persisted for the service plan

verb
string

The workflow verb

Responses

Request samples

Content type
application/json
{
  • "apiParameters": [
    ],
  • "configuration": {
    },
  • "description": "Trigger an on-demand backup for the operator-managed service",
  • "name": "Backup now",
  • "outputParameterSpecs": [
    ],
  • "scope": [
    ],
  • "spec": {
    },
  • "verb": "SWITCHOVER"
}

ListCustomWorkflows custom-workflow-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The ID of the service that the workflows belong to

productTierId
required
string
Example: pt-12345678

The product tier ID

query Parameters
productTierVersion
string
Example: productTierVersion=Numquam delectus.

Product tier version of the workflows to describe. If not specified, the latest version is described.

Responses

Response samples

Content type
application/json
{
  • "customWorkflows": [
    ]
}

CreateCustomWorkflow custom-workflow-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The ID of the service that this workflow belongs to

productTierId
required
string
Example: pt-12345678

The product tier ID that this workflow belongs to

Request Body schema: application/json
required
Array of objects (InputParameterEntity)

The API parameters that users provide when invoking this workflow

object

Workflow-specific configuration as a flexible key-value map. For backup workflows: backupRetentionInDays (int), backupPeriodInHours (int), snapshotBeforeDeletion (bool). New properties can be added without API or schema changes.

description
string

A brief description of the workflow

name
required
string

The display name of the workflow

Array of objects (WorkflowOutputParameterSpec)

Typed declarations of the output parameters this workflow produces.

scope
Array of strings

The user context scopes that can invoke this workflow

spec
required
any

The workflow definition persisted for the service plan

verb
required
string

The workflow verb

Responses

Request samples

Content type
application/json
{
  • "apiParameters": [
    ],
  • "configuration": {
    },
  • "description": "Trigger an on-demand backup for the operator-managed service",
  • "name": "Backup now",
  • "outputParameterSpecs": [
    ],
  • "scope": [
    ],
  • "spec": {
    },
  • "verb": "SWITCHOVER"
}

Response samples

Content type
application/json
"Nobis enim."

tier-version-set-api

CustomerListTierVersionSets tier-version-set-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

ID of the Service

productTierId
required
string
Example: Ad a officiis est nobis debitis eos.

The product tier ID that this version set belongs to.

query Parameters
nextPageToken
string
Example: nextPageToken=token

The next token to use for pagination

pageSize
integer <int64>
Example: pageSize=10

The number of resources to return per page

Responses

Response samples

Content type
application/json
{
  • "nextPageToken": "next-token",
  • "tierVersionSets": [
    ]
}

ListTierVersionSets tier-version-set-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

ID of the Service

productTierId
required
string
Example: Ad a officiis est nobis debitis eos.

The product tier ID that this version set belongs to.

query Parameters
latestMajorVersionOnly
boolean
Example: latestMajorVersionOnly=true

If true, the latest major version is returned. The parameter needs to be specified in isolation.

latestIncrementalVersionForMajorVersion
string
Example: latestIncrementalVersionForMajorVersion=3.0

Returns the latest incremental version for the given major version. The paramenter needs to be specified in isolation.

excludeFeatures
boolean
Example: excludeFeatures=true

If true, omit the features and enabledFeatures fields from each version set.

excludeResources
boolean
Example: excludeResources=true

If true, omit the resources field from each version set.

excludeStats
boolean
Example: excludeStats=true

If true, omit runtime stats fields such as instanceCount from each version set.

nextPageToken
string
Example: nextPageToken=token

The next token to use for pagination

pageSize
integer <int64>
Example: pageSize=10

The number of resources to return per page

Responses

Response samples

Content type
application/json
{
  • "nextPageToken": "next-token",
  • "tierVersionSets": [
    ]
}

CreateTierVersionSet tier-version-set-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

ID of the Service

productTierId
required
string
Example: Ad a officiis est nobis debitis eos.

The product tier ID that this version set belongs to.

Request Body schema: application/json
required
description
string

A brief description of the product-tier version set.

name
string

The name of the product-tier version set.

parentVersion
string

The parent version of this version set.

type
required
string

The version-set type of the product-tier.

Responses

Request samples

Content type
application/json
{
  • "description": "Corporis aliquid necessitatibus.",
  • "name": "Major version set",
  • "parentVersion": "2.0",
  • "type": "Major|Incremental|UserDefined"
}

Response samples

Content type
application/json
{
  • "version": "3.0"
}

DescribeTierVersionSet tier-version-set-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

ID of the Service

productTierId
required
string
Example: Ad a officiis est nobis debitis eos.

The product tier ID that this version set belongs to.

version
required
string
Example: 3.0

The version number for the specific version set.

Responses

Response samples

Content type
application/json
{
  • "autoApproveSubscription": false,
  • "baseVersion": "3.0",
  • "createBackupSystemWorkflowDisabled": true,
  • "createBackupSystemWorkflowDisabledAt": "2026-09-15T12:00:00Z",
  • "createdAt": "2020-01-01T00:00:00Z",
  • "createdBy": "John Doe",
  • "deleteBackupSystemWorkflowDisabled": true,
  • "deleteBackupSystemWorkflowDisabledAt": "2026-09-15T13:00:00Z",
  • "deploymentArtifactsVersionedMetadata": [
    ],
  • "description": "Vel eos est.",
  • "enabledFeatures": [
    ],
  • "features": {
    },
  • "instanceCount": 12,
  • "latestUpgradePathId": "Perferendis at quo ducimus.",
  • "name": "Regular version set",
  • "parentVersion": "2.0",
  • "productTierId": "Laboriosam cupiditate nulla saepe eaque magni.",
  • "releaseNotes": "Quae excepturi aut ea sit sequi vero.",
  • "releasedAt": "2020-01-01T00:00:00Z",
  • "releasedBy": "John Doe",
  • "resources": [
    ],
  • "serviceId": "s-123456",
  • "serviceModelId": "Consequatur consequatur beatae.",
  • "status": "Preferred|Active|Deprecated|Pending",
  • "type": "Major|Incremental|UserDefined",
  • "updatedAt": "2020-01-01T00:00:00Z",
  • "version": "3.0"
}

UpdateTierVersionSet tier-version-set-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

ID of the Service

productTierId
required
string
Example: Ad a officiis est nobis debitis eos.

The product tier ID that this version set belongs to.

version
required
string
Example: 3.0

The version number for the specific version set.

Request Body schema: application/json
required
name
required
string

The name of the product-tier version set.

Responses

Request samples

Content type
application/json
{
  • "name": "Updated version set name"
}

Response samples

Content type
application/json
{
  • "autoApproveSubscription": false,
  • "baseVersion": "3.0",
  • "createBackupSystemWorkflowDisabled": true,
  • "createBackupSystemWorkflowDisabledAt": "2026-09-15T12:00:00Z",
  • "createdAt": "2020-01-01T00:00:00Z",
  • "createdBy": "John Doe",
  • "deleteBackupSystemWorkflowDisabled": true,
  • "deleteBackupSystemWorkflowDisabledAt": "2026-09-15T13:00:00Z",
  • "deploymentArtifactsVersionedMetadata": [
    ],
  • "description": "Provident iure consequatur distinctio fugiat eum qui.",
  • "enabledFeatures": [
    ],
  • "features": {
    },
  • "instanceCount": 12,
  • "latestUpgradePathId": "Quo est optio assumenda dignissimos.",
  • "name": "Regular version set",
  • "parentVersion": "2.0",
  • "productTierId": "Laboriosam ipsam quis.",
  • "releaseNotes": "Beatae asperiores magnam et excepturi aspernatur ab.",
  • "releasedAt": "2020-01-01T00:00:00Z",
  • "releasedBy": "John Doe",
  • "resources": [
    ],
  • "serviceId": "s-123456",
  • "serviceModelId": "Minima qui accusantium amet aut autem.",
  • "status": "Preferred|Active|Deprecated|Pending",
  • "type": "Major|Incremental|UserDefined",
  • "updatedAt": "2020-01-01T00:00:00Z",
  • "version": "3.0"
}

DeprecateTierVersionSet tier-version-set-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

ID of the Service

productTierId
required
string
Example: Ad a officiis est nobis debitis eos.

The product tier ID that this version set belongs to.

version
required
string
Example: 3.0

The version number for the specific version set.

Responses

Response samples

Content type
application/json
{
  • "autoApproveSubscription": false,
  • "baseVersion": "3.0",
  • "createBackupSystemWorkflowDisabled": true,
  • "createBackupSystemWorkflowDisabledAt": "2026-09-15T12:00:00Z",
  • "createdAt": "2020-01-01T00:00:00Z",
  • "createdBy": "John Doe",
  • "deleteBackupSystemWorkflowDisabled": true,
  • "deleteBackupSystemWorkflowDisabledAt": "2026-09-15T13:00:00Z",
  • "deploymentArtifactsVersionedMetadata": [
    ],
  • "description": "Amet est pariatur quia.",
  • "enabledFeatures": [
    ],
  • "features": {
    },
  • "instanceCount": 12,
  • "latestUpgradePathId": "Consequuntur est.",
  • "name": "Regular version set",
  • "parentVersion": "2.0",
  • "productTierId": "Esse quo adipisci voluptas voluptatem.",
  • "releaseNotes": "Iste est.",
  • "releasedAt": "2020-01-01T00:00:00Z",
  • "releasedBy": "John Doe",
  • "resources": [
    ],
  • "serviceId": "s-123456",
  • "serviceModelId": "Adipisci ducimus error.",
  • "status": "Preferred|Active|Deprecated|Pending",
  • "type": "Major|Incremental|UserDefined",
  • "updatedAt": "2020-01-01T00:00:00Z",
  • "version": "3.0"
}

DiffTierVersionSets tier-version-set-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

ID of the Service

productTierId
required
string
Example: Ad a officiis est nobis debitis eos.

The product tier ID that this version set belongs to.

version
required
string
Example: 3.0

The version number for the version set.

anotherVersion
required
string
Example: 3.1

The target version to compare against.

Responses

Response samples

Content type
application/json
{
  • "anotherVersion": "3.1",
  • "productTierId": "Blanditiis ut aliquid tempore.",
  • "resourceChangeSets": {
    },
  • "serviceId": "s-123456",
  • "version": "3.0"
}

DescribeTierVersionSetMetadata tier-version-set-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

ID of the Service

productTierId
required
string
Example: Ad a officiis est nobis debitis eos.

The product tier ID that this version set belongs to.

version
required
string
Example: 3.0

The version number for the specific version set.

Responses

Response samples

Content type
application/json
{
  • "createBackupSystemWorkflowDisabled": true,
  • "createBackupSystemWorkflowDisabledAt": "2026-09-15T12:00:00Z",
  • "deleteBackupSystemWorkflowDisabled": true,
  • "deleteBackupSystemWorkflowDisabledAt": "2026-09-15T13:00:00Z",
  • "productTierId": "Dolor dolores ut hic labore nobis.",
  • "releaseNotes": "Voluptates ad pariatur nobis.",
  • "serviceId": "s-123456",
  • "version": "Aut id quae saepe illum est."
}

UpdateTierVersionSetMetadata tier-version-set-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

ID of the Service

productTierId
required
string
Example: Ad a officiis est nobis debitis eos.

The product tier ID that this version set belongs to.

version
required
string
Example: 3.0

The version number for the specific version set.

Request Body schema: application/json
required
releaseNotes
string

Release notes for the version set.

Responses

Request samples

Content type
application/json
{
  • "releaseNotes": "Repellat exercitationem occaecati atque quia."
}

Response samples

Content type
application/json
{
  • "createBackupSystemWorkflowDisabled": true,
  • "createBackupSystemWorkflowDisabledAt": "2026-09-15T12:00:00Z",
  • "deleteBackupSystemWorkflowDisabled": true,
  • "deleteBackupSystemWorkflowDisabledAt": "2026-09-15T13:00:00Z",
  • "productTierId": "Culpa ut.",
  • "releaseNotes": "Dolor velit sed assumenda adipisci eos rem.",
  • "serviceId": "s-123456",
  • "version": "Et beatae culpa asperiores est."
}

PromoteTierVersionSet tier-version-set-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

ID of the Service

productTierId
required
string
Example: Ad a officiis est nobis debitis eos.

The product tier ID that this version set belongs to.

version
required
string
Example: 3.0

The version number for the specific version set.

Responses

Response samples

Content type
application/json
{
  • "autoApproveSubscription": false,
  • "baseVersion": "3.0",
  • "createBackupSystemWorkflowDisabled": true,
  • "createBackupSystemWorkflowDisabledAt": "2026-09-15T12:00:00Z",
  • "createdAt": "2020-01-01T00:00:00Z",
  • "createdBy": "John Doe",
  • "deleteBackupSystemWorkflowDisabled": true,
  • "deleteBackupSystemWorkflowDisabledAt": "2026-09-15T13:00:00Z",
  • "deploymentArtifactsVersionedMetadata": [
    ],
  • "description": "Quia voluptatem.",
  • "enabledFeatures": [
    ],
  • "features": {
    },
  • "instanceCount": 12,
  • "latestUpgradePathId": "Et architecto.",
  • "name": "Regular version set",
  • "parentVersion": "2.0",
  • "productTierId": "Quia et ut omnis.",
  • "releaseNotes": "Laboriosam eum quasi blanditiis dolores.",
  • "releasedAt": "2020-01-01T00:00:00Z",
  • "releasedBy": "John Doe",
  • "resources": [
    ],
  • "serviceId": "s-123456",
  • "serviceModelId": "Repellendus possimus expedita dignissimos.",
  • "status": "Preferred|Active|Deprecated|Pending",
  • "type": "Major|Incremental|UserDefined",
  • "updatedAt": "2020-01-01T00:00:00Z",
  • "version": "3.0"
}

ReleaseTierVersionSet tier-version-set-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

ID of the Service

productTierId
required
string
Example: Ad a officiis est nobis debitis eos.

The product tier ID that this version set belongs to.

version
required
string
Example: 3.0

The version number for the specific version set.

Request Body schema: application/json
required
isPreferred
boolean

Indicates whether this version set is preferred.

name
string

The name of the product-tier version set.

Responses

Request samples

Content type
application/json
{
  • "isPreferred": true,
  • "name": "Major version set"
}

Response samples

Content type
application/json
{
  • "autoApproveSubscription": false,
  • "baseVersion": "3.0",
  • "createBackupSystemWorkflowDisabled": true,
  • "createBackupSystemWorkflowDisabledAt": "2026-09-15T12:00:00Z",
  • "createdAt": "2020-01-01T00:00:00Z",
  • "createdBy": "John Doe",
  • "deleteBackupSystemWorkflowDisabled": true,
  • "deleteBackupSystemWorkflowDisabledAt": "2026-09-15T13:00:00Z",
  • "deploymentArtifactsVersionedMetadata": [
    ],
  • "description": "Expedita voluptas totam.",
  • "enabledFeatures": [
    ],
  • "features": {
    },
  • "instanceCount": 12,
  • "latestUpgradePathId": "Qui et sunt nostrum quam doloremque.",
  • "name": "Regular version set",
  • "parentVersion": "2.0",
  • "productTierId": "Ipsum quos qui.",
  • "releaseNotes": "Alias dignissimos quam quas qui.",
  • "releasedAt": "2020-01-01T00:00:00Z",
  • "releasedBy": "John Doe",
  • "resources": [
    ],
  • "serviceId": "s-123456",
  • "serviceModelId": "Tenetur sint.",
  • "status": "Preferred|Active|Deprecated|Pending",
  • "type": "Major|Incremental|UserDefined",
  • "updatedAt": "2020-01-01T00:00:00Z",
  • "version": "3.0"
}

GetTierVersionSetSpec tier-version-set-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

ID of the Service

productTierId
required
string
Example: Ad a officiis est nobis debitis eos.

The product tier ID that this version set belongs to.

query Parameters
version
string
Example: version=3.0

The version number for the specific version set. If not specified, returns the latest preferred or active version.

Responses

Response samples

Content type
application/json
{
  • "createdAt": "2007-03-30T16:04:54Z",
  • "productTierId": "Eligendi ut consequatur dolorem.",
  • "serviceId": "s-123456",
  • "specContent": "{\"RawYAML\":\"bmFtZTogbXktc2VydmljZQpkZXBsb3ltZW50OgogIGhvc3RlZDoKICAgIGFjY291bnQ6IC4uLg==\",\"Configs\":{\"database_url\":\"cG9zdGdyZXM6Ly9sb2NhbGhvc3Q6NTQzMi9teWRi\"},\"Secrets\":{\"api_key\":\"c2VjcmV0X2FwaV9rZXlfdjEyMzQ1\"}}",
  • "updatedAt": "2011-02-08T22:26:56Z",
  • "version": "1.0"
}

ListTierVersionSetSpecs tier-version-set-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

ID of the Service

productTierId
required
string
Example: Ad a officiis est nobis debitis eos.

The product tier ID that this version set belongs to.

Responses

Response samples

Content type
application/json
{
  • "specs": [
    ]
}

input-parameter-api

CreateInputParameter input-parameter-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The ID of the service that this output parameter belongs to

Request Body schema: application/json
required
defaultValue
string

Default value to use for an optional input parameter represented as a string

dependentResourceId
string

The ID of the resource whose instance this input parameter depends on

description
required
string

A brief description of the input parameter

hasOptions
boolean
Default: false

Marks the input parameter to be selectable from a list of values

isList
boolean
Default: false

Marks the input parameter as a list of values

key
required
string non-empty ^[a-zA-Z][a-zA-Z0-9_]*$

Key of the input parameter

object

A map for labeled options. The key is the label and the value is the option. When the option is selected, the label will be displayed to the end customer. Specify either options or labeledOptions when defining the input parameter.

object (Limits)

Limit of a parameter

modifiable
required
boolean

Marks the input parameter as immutable

name
required
string non-empty

External name for the input parameter

options
Array of strings

A list of options to restrict the value of the input parameter to (represented as a string)

regex
string

Regular expression pattern for validating the input parameter value

required
required
boolean

Enforces the input parameter as a required parameter

resourceId
required
string

The ID of the resource that this input parameter belongs to

object (InputParameterScope)

Scope of the input parameter

tabIndex
integer <int64>
Default: 0

Index for parameter ordering in the SaaS portal

type
required
string

Responses

Request samples

Content type
application/json
{
  • "defaultValue": "default value",
  • "dependentResourceId": "Enim fugiat autem dignissimos est.",
  • "description": "Cupiditate cumque dolor aperiam sit.",
  • "hasOptions": false,
  • "isList": true,
  • "key": "48",
  • "labeledOptions": {
    },
  • "limits": {
    },
  • "modifiable": false,
  • "name": "x",
  • "options": [
    ],
  • "regex": "^[a-zA-Z0-9_-]+$",
  • "required": true,
  • "resourceId": "Itaque architecto deleniti sit.",
  • "scope": {
    },
  • "tabIndex": 1,
  • "type": "Boolean|Float64|String|Resource|Secret|Password"
}

Response samples

Content type
application/json
"Soluta suscipit quos hic excepturi id praesentium."

DeleteInputParameter input-parameter-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The ID of the service that this output parameter belongs to

id
required
string
Example: var-12345678

ID of the input parameter

Responses

DescribeInputParameter input-parameter-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The ID of the service that this output parameter belongs to

id
required
string
Example: var-12345678

ID of the input parameter

query Parameters
ProductTierVersion
string
Example: ProductTierVersion=Dolor qui magni voluptatum minima voluptate.

Product tier version of the instance to describe. If not specified, the latest version is described.

ProductTierId
string
Example: ProductTierId=Ad a officiis est nobis debitis eos.

Product tier id of the instance to describe. Needs to specified in combination with the product tier version

Responses

Response samples

Content type
application/json
{
  • "defaultValue": "true",
  • "dependentResourceId": "Hic quis ipsa optio natus molestiae.",
  • "description": "Sapiente rerum minima voluptatem nobis ullam.",
  • "hasOptions": true,
  • "id": "Praesentium aspernatur accusamus culpa.",
  • "isList": false,
  • "key": "lu",
  • "labeledOptions": {
    },
  • "limits": {
    },
  • "modifiable": true,
  • "name": "5",
  • "options": [
    ],
  • "regex": "^[a-zA-Z0-9_-]+$",
  • "required": true,
  • "resourceId": "A nemo.",
  • "scope": {
    },
  • "serviceId": "s-123456",
  • "tabIndex": 1,
  • "type": "Boolean|Float64|String|Resource|Secret|Password"
}

UpdateInputParameter input-parameter-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The ID of the service that this output parameter belongs to

id
required
string
Example: var-12345678

ID of the input parameter

Request Body schema: application/json
required
defaultValue
string

Default value to use for an optional input parameter represented as a string

description
string

A brief description of the input parameter

hasOptions
boolean

Marks the input parameter to be selectable from a list of values

object

A map for labeled options. The key is the label and the value is the option. When the option is selected, the label will be displayed to the end customer. Specify either options or labeledOptions when defining the input parameter.

object (Limits)

Limit of a parameter

modifiable
boolean

Marks the input parameter as immutable

name
string non-empty

External name for the input parameter

options
Array of strings

A list of options to restrict the value of the input parameter to (represented as a string)

regex
string

Regular expression pattern for validating the input parameter value

required
boolean

Enforces the input parameter as a required parameter

object (InputParameterScope)

Scope of the input parameter

tabIndex
integer <int64>
Default: 0

Index for parameter ordering in the SaaS portal

Responses

Request samples

Content type
application/json
{
  • "defaultValue": "[\"1\", \"2.8\", \"3\"]",
  • "description": "Esse aut et.",
  • "hasOptions": true,
  • "labeledOptions": {
    },
  • "limits": {
    },
  • "modifiable": false,
  • "name": "7h",
  • "options": [
    ],
  • "regex": "^[0-9]+$",
  • "required": false,
  • "scope": {
    },
  • "tabIndex": 1
}

ListInputParameter input-parameter-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The ID of the service that this output parameter belongs to

resourceId
required
string
Example: r-12345678

The ID of the resource that this input parameter belongs to

query Parameters
ProductTierVersion
string
Example: ProductTierVersion=Et et itaque.

Product tier version of the instance to describe. If not specified, the latest version is described.

ProductTierId
string
Example: ProductTierId=Ad a officiis est nobis debitis eos.

Product tier id of the instance to describe. Needs to specified in combination with the product tier version

Responses

Response samples

Content type
application/json
{
  • "ids": [
    ],
  • "inputParameters": [
    ],
  • "nextPageToken": "next-token"
}

output-parameter-api

CreateOutputParameter output-parameter-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The ID of the service that this output parameter belongs to

Request Body schema: application/json
required
description
required
string non-empty

Description of the output variable being exported

object (GenericCommandValueProviderConfig)

Configuration for generic command-based value provider

key
required
string non-empty ^[a-zA-Z][a-zA-Z0-9_]*$

Key of the output variable being exported

object (KubectlValueProviderConfig)

Configuration for kubectl-based value provider

name
required
string non-empty

External name of the output variable being exported

resourceId
required
string

The ID of the resource that this output parameter belongs to

value
string

Value of the output variable being exported

valueRef
string

Reference to another variable that will be used to set the value of the output variable being exported

valueType
string

Responses

Request samples

Content type
application/json
{
  • "description": "Username of the user created in the target system",
  • "genericCommandValueProvider": {
    },
  • "key": "username",
  • "kubectlValueProvider": {
    },
  • "name": "Username",
  • "resourceId": "Rerum laborum expedita similique.",
  • "value": "johndoe",
  • "valueRef": "$var.username",
  • "valueType": "Boolean|Float64|String|Secret|Password"
}

Response samples

Content type
application/json
"Fugiat est tempora."

DeleteOutputParameter output-parameter-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The ID of the service that this output parameter belongs to

id
required
string
Example: op-12345678

The ID of the output parameter

Responses

DescribeOutputParameter output-parameter-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The ID of the service that this output parameter belongs to

id
required
string
Example: op-12345678

The ID of the output parameter

query Parameters
ProductTierVersion
string
Example: ProductTierVersion=Ea exercitationem vero sint.

Product tier version of the resource to describe. If not specified, the latest version is described.

ProductTierId
string
Example: ProductTierId=Ad a officiis est nobis debitis eos.

ProductTierId of the resource to describe. Needs to specified in combination with the product tier version

Responses

Response samples

Content type
application/json
{
  • "description": "Username of the user created in the target system",
  • "genericCommandValueProvider": {
    },
  • "id": "Molestiae itaque repellendus aut voluptas eveniet aut.",
  • "key": "username",
  • "kubectlValueProvider": {
    },
  • "name": "Username",
  • "resourceId": "Corrupti corrupti qui in aut.",
  • "serviceId": "s-123456",
  • "value": "johndoe",
  • "valueRef": "$var.username",
  • "valueType": "Boolean|Float64|String|Secret|Password"
}

UpdateOutputParameter output-parameter-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The ID of the service that this output parameter belongs to

id
required
string
Example: op-12345678

The ID of the output parameter

Request Body schema: application/json
required
description
string non-empty

Description of the output variable being exported

object (GenericCommandValueProviderConfig)

Configuration for generic command-based value provider

object (KubectlValueProviderConfig)

Configuration for kubectl-based value provider

name
string non-empty

External name of the output variable being exported

value
string non-empty

Value of the output variable being exported

valueRef
string

Reference to an input variable that will be used to set the value of the output variable being exported

valueType
string

Responses

Request samples

Content type
application/json
{
  • "description": "Username of the user created in the target system",
  • "genericCommandValueProvider": {
    },
  • "kubectlValueProvider": {
    },
  • "name": "Username",
  • "value": "johndoe",
  • "valueRef": "$var.username",
  • "valueType": "Boolean|Float64|String|Secret|Password"
}

ListOutputParameter output-parameter-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The ID of the service that this output parameter belongs to

resourceId
required
string
Example: r-12345678

The ID of the resource that this output parameter belongs to

query Parameters
ProductTierVersion
string
Example: ProductTierVersion=Non similique ut nesciunt explicabo.

Product tier version of the resource to describe. If not specified, the latest version is described.

ProductTierId
string
Example: ProductTierId=Ad a officiis est nobis debitis eos.

ProductTierId of the resource to describe. Needs to specified in combination with the product tier version

Responses

Response samples

Content type
application/json
{
  • "ids": [
    ],
  • "nextPageToken": "next-token",
  • "outputParameters": [
    ]
}

vunit-api

The external facing VUnit API

ListVUnits vunit-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

Service ID for the VUnit

serviceModelId
required
string
Example: sm-12345678

Service Model ID for the VUnit

Request Body schema: application/json
required
cloudProvider
required
string

The infra / cloud provider name

region
required
string

Region code specific to the cloud-provider

Responses

Request samples

Content type
application/json
{
  • "cloudProvider": "aws|azure|gcp|nebius|oci|byoc-onprem|all",
  • "region": "us-west-2"
}

Response samples

Content type
application/json
{
  • "ids": {
    },
  • "nextPageToken": "next-token"
}

DescribeNetwork vunit-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

Service ID context

id
required
string
Example: n-12345678

Network to operate on

Responses

Response samples

Content type
application/json
{
  • "cidr": "10.0.0.0/16",
  • "id": "Ut odio distinctio ut et similique provident.",
  • "networkConfigId": "Modi dignissimos officiis.",
  • "serviceId": "s-123456",
  • "type": "PUBLIC",
  • "vunitId": "Qui quae consectetur et."
}

DescribeVUnit vunit-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

Service ID for the VUnit

id
required
string
Example: vu-12345678

VUnit to operate on

Responses

Response samples

Content type
application/json
{
  • "cloudProvider": "aws|azure|gcp|nebius|oci|byoc-onprem|all",
  • "id": "Molestiae est suscipit rerum sed vel.",
  • "networkIds": [
    ],
  • "region": "us-west-2",
  • "serviceId": "s-123456",
  • "serviceModelId": "Beatae totam libero."
}

infra-config-api

The infra config API manages the infra for Omnistrate resources

CreateInfraConfig infra-config-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID

Request Body schema: application/json
required
computeConfigId
string

The compute config ID

object (CustomTag)

Custom tag

description
required
string

The description for the infra config

name
required
string

The name of the infra config

networkConfigId
string

The network config ID

serviceEnvironmentId
required
string

The service environment ID

storageConfigId
string

The storage config ID

Responses

Request samples

Content type
application/json
{
  • "computeConfigId": "Amet aut fugiat quas rerum.",
  • "customTag": {
    },
  • "description": "Infra config used for the base tier MySQL service",
  • "name": "MySQL Writer Infra Config",
  • "networkConfigId": "Libero et sed consequuntur molestiae quia delectus.",
  • "serviceEnvironmentId": "se-123456",
  • "storageConfigId": "Nemo amet id est quam."
}

Response samples

Content type
application/json
"Qui voluptas."

DeleteInfraConfig infra-config-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID

id
required
string
Example: ic-12345678

Infra Config ID to operate on

Responses

DescribeInfraConfig infra-config-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID

id
required
string
Example: ic-12345678

Infra Config ID to operate on

query Parameters
ProductTierVersion
string
Example: ProductTierVersion=Quos minus praesentium.

Product tier version of the infra config to describe. If not specified, the latest version is described.

ProductTierId
string
Example: ProductTierId=Ad a officiis est nobis debitis eos.

ProductTierId of the infra config to describe. Needs to specified in combination with the product tier version

Responses

Response samples

Content type
application/json
{
  • "computeConfigId": "Error nesciunt laborum et.",
  • "customTag": {
    },
  • "description": "Infra config used for the base tier MySQL service",
  • "id": "Rem dolor delectus.",
  • "name": "MySQL Writer Infra Config",
  • "networkConfigId": "Commodi voluptate quia.",
  • "serviceEnvironmentId": "se-123456",
  • "serviceId": "s-123456",
  • "storageConfigId": "Ipsam praesentium."
}

UpdateInfraConfig infra-config-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID

id
required
string
Example: ic-12345678

Infra Config ID to operate on

Request Body schema: application/json
required
computeConfigId
string

The compute config ID

object (CustomTag)

Custom tag

description
string

The description for the infra config

name
string

The name of the infra config

networkConfigId
string

The network config ID

storageConfigId
string

The storage config ID per compute node

Responses

Request samples

Content type
application/json
{
  • "computeConfigId": "Officiis incidunt dolor eveniet omnis cumque.",
  • "customTag": {
    },
  • "description": "Infra config used for the base tier MySQL service",
  • "name": "MySQL Writer Infra Config",
  • "networkConfigId": "Nostrum dolor corrupti omnis.",
  • "storageConfigId": "Nobis occaecati rem quasi assumenda aut."
}

ListAssociatedResources infra-config-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID

id
required
string
Example: ic-12345678

Infra Config ID to operate on

Responses

Response samples

Content type
application/json
{
  • "id": "Officia aut eveniet.",
  • "resourceIds": [
    ],
  • "serviceId": "s-123456"
}

DetachComputeConfig infra-config-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID

id
required
string
Example: ic-12345678

Infra Config ID to operate on

Responses

DetachNetworkConfig infra-config-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID

id
required
string
Example: ic-12345678

Infra Config ID to operate on

Responses

ReleaseInfraConfig infra-config-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID

id
required
string
Example: ic-12345678

Infra Config ID to operate on

Request Body schema: application/json
required
productTierId
string

The product tier ID

Responses

Request samples

Content type
application/json
{
  • "productTierId": "Labore architecto."
}

RolloutFleetInfra infra-config-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID

id
required
string
Example: ic-12345678

Infra Config ID to operate on

Responses

RolloutFleetInfraStatus infra-config-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID

id
required
string
Example: ic-12345678

Infra Config ID to operate on

Responses

Response samples

Content type
application/json
{
  • "status": "FAILED|CANCELLED|PENDING_DEPENDENCY|PENDING|RUNNING"
}

DetachStorageConfig infra-config-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID

id
required
string
Example: ic-12345678

Infra Config ID to operate on

Responses

ListInfraConfig infra-config-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID

serviceEnvironmentId
required
string
Example: se-12345678

The service environment ID

query Parameters
managed
boolean
Example: managed=false

Is infra config managed by omnistrate

Responses

Response samples

Content type
application/json
{
  • "ids": [
    ],
  • "nextPageToken": "next-token"
}

image-config-api

The image config API manages the image config for Omnistrate entities

CreateImageConfig image-config-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID to use for the infra

Request Body schema: application/json
required
object (CustomImageCommandsAndArgs)

Commands and arguments to run in the container

description
required
string

A brief description of the image configuration

imageName
required
string non-empty

Name of the container image

imageRegistryId
string

The image registry ID to use for the infra

imageSignaturePublicKeyPEM
string

PEM-encoded Public key part of the key used to sign the container image

imageTag
string
Default: "latest"

Tag representing the specific software image version

serviceEnvironmentId
required
string

The service environment ID

Responses

Request samples

Content type
application/json
{
  • "customImageCommandsAndArgs": {
    },
  • "description": "A image configuration for my new entity",
  • "imageName": "mysql",
  • "imageRegistryId": "Veniam modi.",
  • "imageSignaturePublicKeyPEM": "-----BEGIN PUBLIC KEY-----\nMFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAExXBS01nPRugGbKCN8m9sSSTkGvPT\n7a1Jn74No2dTkp+tQ+ZyBa7ClKbEXFaR2mzy06q0ivJAxPi1pixofIXE0Q==\n-----END PUBLIC KEY-----\n",
  • "imageTag": "latest",
  • "serviceEnvironmentId": "se-123456"
}

Response samples

Content type
application/json
"Perspiciatis molestiae."

DeleteImageConfig image-config-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID

id
required
string
Example: imgc-12345678

The image configuration ID

Responses

DescribeImageConfig image-config-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID

id
required
string
Example: imgc-12345678

The image configuration ID

query Parameters
ProductTierVersion
string
Example: ProductTierVersion=Quasi cumque voluptas nemo explicabo fugit.

Product tier version of the image config to describe. If not specified, the latest version is described.

ProductTierId
string
Example: ProductTierId=Ad a officiis est nobis debitis eos.

ProductTierId of the image config to describe. Needs to specified in combination with the product tier version

Responses

Response samples

Content type
application/json
{
  • "customImageCommandsAndArgs": {
    },
  • "description": "An image configuration for my new entity",
  • "id": "Praesentium est voluptatem voluptatem cupiditate soluta.",
  • "imageName": "mysql",
  • "imageRegistryId": "Unde architecto cum dolor laboriosam accusamus.",
  • "imageSignaturePublicKeyPEM": "-----BEGIN PUBLIC KEY-----\nMFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAExXBS01nPRugGbKCN8m9sSSTkGvPT\n7a1Jn74No2dTkp+tQ+ZyBa7ClKbEXFaR2mzy06q0ivJAxPi1pixofIXE0Q==\n-----END PUBLIC KEY-----\n",
  • "imageTag": "v1",
  • "serviceEnvironmentId": "se-123456",
  • "serviceId": "s-123456"
}

UpdateImageConfig image-config-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID

id
required
string
Example: imgc-12345678

The image configuration ID

Request Body schema: application/json
required
object (CustomImageCommandsAndArgs)

Commands and arguments to run in the container

description
string

A brief description of the image configuration

imageName
string non-empty

Name of the container image

imageRegistryId
string

The image registry ID to use for the infra

imageSignaturePublicKeyPEM
string

PEM-encoded Public key part of the key used to sign the container image

imageTag
string

Tag representing the software image version that is currently preferred

Responses

Request samples

Content type
application/json
{
  • "customImageCommandsAndArgs": {
    },
  • "description": "An image configuration for my new entity",
  • "imageName": "mysql",
  • "imageRegistryId": "Vel velit alias rerum et.",
  • "imageSignaturePublicKeyPEM": "-----BEGIN PUBLIC KEY-----\nMFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAExXBS01nPRugGbKCN8m9sSSTkGvPT\n7a1Jn74No2dTkp+tQ+ZyBa7ClKbEXFaR2mzy06q0ivJAxPi1pixofIXE0Q==\n-----END PUBLIC KEY-----\n",
  • "imageTag": "v1"
}

ReleaseImageConfig image-config-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID

id
required
string
Example: imgc-12345678

The image configuration ID

Request Body schema: application/json
required
productTierId
string

The product tier ID

Responses

Request samples

Content type
application/json
{
  • "productTierId": "Iusto illo aut."
}

RolloutFleetImageStatus image-config-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID

id
required
string
Example: imgc-12345678

The image configuration ID

Responses

Response samples

Content type
application/json
{
  • "status": "FAILED|CANCELLED|PENDING_DEPENDENCY|PENDING|RUNNING"
}

RolloutFleetImageConfig image-config-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID

id
required
string
Example: imgc-12345678

The image configuration ID

Responses

ListImageConfigs image-config-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID to use for the infra

serviceEnvironmentId
required
string
Example: se-12345678

The service environment ID

Responses

Response samples

Content type
application/json
{
  • "ids": [
    ],
  • "nextPageToken": "next-token"
}

deployment-artifact-api

The deployment artifact API manages the deployment artifacts for Omnistrate entities

UploadDeploymentArtifact deployment-artifact-api

Authorizations:
api_key_header_Authorization
Request Body schema: application/json
required
accountConfigID
required
string

The account config ID associated with the deployment artifact

artifactPath
required
string

The path to the deployment artifact

base64EncodedArtifact
required
string

The deployment artifact file content with base64 encoding, and expected to be a .tar.gz file

environmentType
required
string

The environment type for the deployment artifact

productTierName
required
string

The name of the product tier

serviceName
required
string

The name of the service

Responses

Request samples

Content type
application/json
{
  • "accountConfigID": "ac-1234567890",
  • "artifactPath": "/path/to",
  • "base64EncodedArtifact": "Praesentium rem autem eum impedit.",
  • "environmentType": "PROD|PRIVATE|CANARY|STAGING|QA|DEV|GLOBAL",
  • "productTierName": "standard",
  • "serviceName": "my-service"
}

Response samples

Content type
application/json
"Tempore nulla voluptatem hic ea."

DescribeDeploymentArtifact deployment-artifact-api

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: da-12345678

The ID of the deployment artifact

query Parameters
hash
string
Example: hash=3a7bd3e2360a3d4855f3c8d2f8f6e6c1

Hash of the deployment artifact to describe. If not specified, the latest version is described.

Responses

Response samples

Content type
application/json
{
  • "accountConfigID": "Rerum maxime nesciunt tempora qui aut qui.",
  • "artifactPath": "artifacts/path/to/",
  • "hash": "3a7bd3e2360a3d4855f3c8d2f8f6e6c1",
  • "id": "Quia minus quibusdam.",
  • "lastFailedReason": "Failed",
  • "presignedDownloadUrl": "https://api.omnistrate.cloud/2022-09-01-00/deployment-artifact/da-12345678/download",
  • "status": "FAILED|CANCELLED|PENDING_DEPENDENCY|PENDING|RUNNING|DEPLOYING|UPLOADING|READY|SUCCESS|COMPLETE|DELETING|DELETED|UNKNOWN|DISCONNECTED|DISCONNECTING|CONNECTING|DEACTIVATED"
}

DownloadDeploymentArtifact deployment-artifact-api

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: da-12345678

The ID of the deployment artifact

query Parameters
hash
string
Example: hash=3a7bd3e2360a3d4855f3c8d2f8f6e6c1

Hash of the deployment artifact to download. If not specified, the latest version is downloaded.

Responses

Response samples

Content type
application/json
"string"

deployment-config-api

The deployment config API manages the deployment config for Omnistrate entities

ListDeploymentConfigs deployment-config-api

Authorizations:
api_key_header_Authorization

Responses

Response samples

Content type
application/json
{
  • "ids": [
    ],
  • "nextPageToken": "next-token"
}

CreateDeploymentConfig deployment-config-api

Authorizations:
api_key_header_Authorization
Request Body schema: application/json
required
description
required
string

A brief description of the deployment config

object (InfraRollConfiguration)

The rollout configuration to use for making changes to the resources backed by this infra

name
required
string

Name of the deployment config

rolloutPriorityList
Array of strings

Responses

Request samples

Content type
application/json
{
  • "description": "A production deployment config",
  • "infraRollConfiguration": {
    },
  • "name": "Production",
  • "rolloutPriorityList": [
    ]
}

Response samples

Content type
application/json
"Ea dolores neque corporis tempora id."

DeleteDeploymentConfig deployment-config-api

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: dc-12345678

The deployment configuration ID

Responses

DescribeDeploymentConfig deployment-config-api

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Examples:
  • default - default

The deployment configuration ID

Responses

Response samples

Content type
application/json
{
  • "description": "A production deployment config",
  • "id": "Consectetur laborum consequuntur porro veniam laudantium est.",
  • "infraRollConfiguration": {
    },
  • "name": "Production",
  • "rolloutPriorityList": [
    ]
}

UpdateDeploymentConfig deployment-config-api

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: dc-12345678

The deployment configuration ID

Request Body schema: application/json
required
description
string

A brief description of the deployment config

object (InfraRollConfiguration)

The rollout configuration to use for making changes to the resources backed by this infra

name
string

Name of the deployment config

rolloutPriorityList
Array of strings

Responses

Request samples

Content type
application/json
{
  • "description": "A production deployment config",
  • "infraRollConfiguration": {
    },
  • "name": "Production",
  • "rolloutPriorityList": [
    ]
}

compute-config-api

The compute config API manages the compute config for Omnistrate entities

ListComputeConfig compute-config-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID

query Parameters
managed
boolean
Example: managed=false

Is compute config managed by omnistrate

Responses

Response samples

Content type
application/json
{
  • "ids": [
    ],
  • "nextPageToken": "next-token"
}

CreateComputeConfig compute-config-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID

Request Body schema: application/json
required
object (AutoscalingPolicy)

Autoscaling policy for compute nodes

cpuArchitecture
string

Processor architecture

description
required
string non-empty

Description of the compute config

name
required
string non-empty

Name of the compute config

replicaCount
string

Number of replicas to provision for this logical pool of nodes per instance of the resource

object (ResourceSpec)

Resource requirements

rootVolumeSizeGi
integer <int64>

Size of the root volume in Gi

object (WarmPoolConfiguration)

Warm pool configuration for compute nodes

Responses

Request samples

Content type
application/json
{
  • "autoscalingPolicy": {
    },
  • "cpuArchitecture": "X86_64|ARM64",
  • "description": "my compute config description",
  • "name": "my compute config",
  • "replicaCount": "3",
  • "resources": {
    },
  • "rootVolumeSizeGi": 10,
  • "warmPoolConfiguration": {
    }
}

Response samples

Content type
application/json
"Rerum dolorem sed est quod officia et."

DeleteComputeConfig compute-config-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID

id
required
string
Example: cc-12345678

ID of the compute config

Responses

DescribeComputeConfig compute-config-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID

id
required
string
Example: cc-12345678

ID of the compute config

query Parameters
ProductTierVersion
string
Example: ProductTierVersion=Harum omnis quod ut.

Product tier version of the compute config to describe. If not specified, the latest version is described.

ProductTierId
string
Example: ProductTierId=Ad a officiis est nobis debitis eos.

ProductTierId of the compute config to describe. Needs to specified in combination with the product tier version

Responses

Response samples

Content type
application/json
{
  • "autoscalingPolicy": {
    },
  • "computeInstanceTypeConfigOverrides": {
    },
  • "cpuArchitecture": "X86_64|ARM64",
  • "description": "my compute config description",
  • "id": "Ab dolorum et.",
  • "infraConfigIDs": [
    ],
  • "instanceTypes": {
    },
  • "name": "my compute config",
  • "replicaCount": "3",
  • "resources": {
    },
  • "rootVolumeSizeGi": 10,
  • "serviceId": "s-123456",
  • "warmPoolConfiguration": {
    }
}

UpdateComputeConfig compute-config-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID

id
required
string
Example: cc-12345678

ID of the compute config

Request Body schema: application/json
required
object (AutoscalingPolicy)

Autoscaling policy for compute nodes

cpuArchitecture
string

Processor architecture

description
string non-empty

Description of the compute config

name
string non-empty

Name of the compute config

replicaCount
string

Number of replicas to provision for this logical pool of nodes per instance of the resource

object (ResourceSpec)

Resource requirements

rootVolumeSizeGi
integer <int64>

Size of the root volume in Gi

object (WarmPoolConfiguration)

Warm pool configuration for compute nodes

Responses

Request samples

Content type
application/json
{
  • "autoscalingPolicy": {
    },
  • "cpuArchitecture": "X86_64|ARM64",
  • "description": "my compute config description",
  • "name": "my compute config",
  • "replicaCount": "3",
  • "resources": {
    },
  • "rootVolumeSizeGi": 10,
  • "warmPoolConfiguration": {
    }
}

RemoveComputeInstanceType compute-config-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID

id
required
string
Example: cc-12345678

ID of the compute config

Request Body schema: application/json
required
cloudProviderName
required
string

The cloud provider for this compute instance type config

instanceType
required
string

The instance type for this compute instance type config

Responses

Request samples

Content type
application/json
{
  • "cloudProviderName": "aws|azure|gcp|nebius|oci|byoc-onprem|all",
  • "instanceType": "t3.micro"
}

AddComputeInstanceType compute-config-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID

id
required
string
Example: cc-12345678

ID of the compute config

Request Body schema: application/json
required
cloudProviderName
required
string

The cloud provider for this compute instance type config

object (ComputeInstanceTypeConfigOverride)
instanceType
required
string

The instance type for this compute instance type config

Responses

Request samples

Content type
application/json
{
  • "cloudProviderName": "aws|azure|gcp|nebius|oci|byoc-onprem|all",
  • "configOverride": {
    },
  • "instanceType": "t3.micro"
}

ListComputeInstanceTypes compute-config-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID

cloudProviderName
required
string
Example: aws

The cloud provider for this compute instance type config

Responses

Response samples

Content type
application/json
{
  • "nextPageToken": "next-token",
  • "types": [
    ]
}

storage-config-api

The storage config API manages the storage config for Omnistrate entities

ListStorageConfig storage-config-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service id to filter by

query Parameters
managed
boolean
Example: managed=false

Is storage config managed by omnistrate

Responses

Response samples

Content type
application/json
{
  • "ids": [
    ],
  • "nextPageToken": "next-token"
}

CreateStorageConfig storage-config-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service to which this storage config belongs

Request Body schema: application/json
required
description
required
string non-empty

Description of the storage config

name
required
string non-empty

Name of the storage config

Responses

Request samples

Content type
application/json
{
  • "description": "my-storage-config-description",
  • "name": "my-storage-config"
}

Response samples

Content type
application/json
"Natus quo sunt dolores nesciunt aut unde."

DeleteStorageConfig storage-config-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID

id
required
string
Example: sc-12345678

The storage config ID

Responses

DescribeStorageConfig storage-config-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID

id
required
string
Example: sc-12345678

The storage config ID

query Parameters
ProductTierVersion
string
Example: ProductTierVersion=Accusantium sit omnis qui officia temporibus placeat.

Product tier version of the storage config to describe. If not specified, the latest version is described.

ProductTierId
string
Example: ProductTierId=Ad a officiis est nobis debitis eos.

ProductTierId of the storage config to describe. Needs to specified in combination with the product tier version

Responses

Response samples

Content type
application/json
{
  • "description": "my-storage-config-description",
  • "id": "Architecto veniam qui ratione et.",
  • "infraConfigIDs": [
    ],
  • "name": "my-storage-config",
  • "serviceId": "s-123456",
  • "volumes": {
    }
}

UpdateStorageConfig storage-config-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID

id
required
string
Example: sc-12345678

The storage config ID

Request Body schema: application/json
required
description
string non-empty

Description of the storage config

name
string non-empty

Name of the storage config

Responses

Request samples

Content type
application/json
{
  • "description": "my-storage-config-description",
  • "name": "my-storage-config"
}

RemoveStorageVolumeConfig storage-config-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID

id
required
string
Example: sc-12345678

The storage config ID

storageVolumeConfigId
required
string
Example: svc-12345678

The storage volume config ID

Request Body schema: application/json
required
mountPath
string

The specific mount path to remove. If not specified, all mount paths for the storage volume config will be removed

Responses

Request samples

Content type
application/json
{
  • "mountPath": "/data"
}

AddStorageVolumeConfig storage-config-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID

id
required
string
Example: sc-12345678

The storage config ID

storageVolumeConfigId
required
string
Example: svc-12345678

The storage volume config ID

Request Body schema: application/json
required
mountPath
string

The path where the storage volume will be mounted

Responses

Request samples

Content type
application/json
{
  • "mountPath": "/data"
}

storage-volume-config-api

The storage volume config API manages the storage volume config for Omnistrate entities

ListStorageVolumeConfig storage-volume-config-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service to list storage volume configs for

query Parameters
managed
boolean
Example: managed=false

Is storage volume config managed by omnistrate

Responses

Response samples

Content type
application/json
{
  • "ids": [
    ],
  • "nextPageToken": "next-token"
}

CreateStorageVolumeConfig storage-volume-config-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID

Request Body schema: application/json
required
clusterStorageType
string

The type of the fixed storage for the cluster

description
required
string

A brief description of the context for the storage volume pool

disableBackup
boolean

Disable backup for the storage volume

instanceStorageIops
string

The IOPS provisioned for the configured instance storage type

instanceStorageSizeGi
string

The storage size (in Gi) provisioned for the configured instance storage type

instanceStorageThroughputMiBps
string

The throughput (in MiBps) provisioned for the configured instance storage type

instanceStorageType
string

The type of the storage for a compute instance

name
required
string

Name of the storage volume pool

storageResourceID
string

The storage resource ID

Responses

Request samples

Content type
application/json
{
  • "clusterStorageType": "S3|$var.storageType|AWS::EFS",
  • "description": "A storage volume set to store the MySQL data directory",
  • "disableBackup": false,
  • "instanceStorageIops": "$var.storageIops",
  • "instanceStorageSizeGi": "$var.storage_size",
  • "instanceStorageThroughputMiBps": "128",
  • "instanceStorageType": "$var.storageType",
  • "name": "MySQL Data Volume",
  • "storageResourceID": "r-12345678"
}

Response samples

Content type
application/json
"Quas debitis quo."

DeleteStorageVolumeConfig storage-volume-config-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID

id
required
string
Example: svc-12345678

The storage volume config ID

Responses

DescribeStorageVolumeConfig storage-volume-config-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID

id
required
string
Example: svc-12345678

The storage volume config ID

query Parameters
ProductTierVersion
string
Example: ProductTierVersion=Quia et eligendi nisi dolores aliquam.

Product tier version of the network config to describe. If not specified, the latest version is described.

ProductTierId
string
Example: ProductTierId=Ad a officiis est nobis debitis eos.

ProductTierId of the network config to describe. Needs to specified in combination with the product tier version

Responses

Response samples

Content type
application/json
{
  • "cloudProviderName": "aws|azure|gcp|nebius|oci|byoc-onprem|all",
  • "clusterStorageType": "S3|$var.storageType|AWS::EFS",
  • "description": "A storage volume set to store the MySQL data directory",
  • "disableBackup": false,
  • "id": "Similique nisi.",
  • "instanceStorageIops": "7500",
  • "instanceStorageSizeGi": "128",
  • "instanceStorageThroughputMiBps": "128",
  • "instanceStorageType": "$var.storageType",
  • "name": "MySQL Data Volume",
  • "serviceId": "s-123456",
  • "storageResourceID": "r-12345678"
}

UpdateStorageVolumeConfig storage-volume-config-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID

id
required
string
Example: svc-12345678

The storage volume config ID

Request Body schema: application/json
required
description
string

A brief description of the context for the storage volume pool

disableBackup
boolean

Disable backup for the storage volume

name
string

Name of the storage volume pool

Responses

Request samples

Content type
application/json
{
  • "description": "A storage volume set to store the MySQL data directory",
  • "disableBackup": false,
  • "name": "MySQL Data Volume"
}

UpdateInstanceStorageVolumeConfig storage-volume-config-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID

id
required
string
Example: svc-12345678

The storage volume config ID

Request Body schema: application/json
required
instanceStorageIops
string

The IOPS provisioned for the configured instance storage type

instanceStorageThroughputMiBps
string

The throughput (in MiBps) provisioned for the configured instance storage type

instanceStorageType
string

The type of the storage for a compute instance

Responses

Request samples

Content type
application/json
{
  • "instanceStorageIops": "7500",
  • "instanceStorageThroughputMiBps": "128",
  • "instanceStorageType": "AWS::EBS_GP2"
}

UpdateStorageVolumeSizeConfig storage-volume-config-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID

id
required
string
Example: svc-12345678

The storage volume config ID

Request Body schema: application/json
required
instanceStorageSizeGi
required
string

The storage size (in Gi) provisioned for the configured instance storage type

Responses

Request samples

Content type
application/json
{
  • "instanceStorageSizeGi": "$var.storage_size"
}

network-config-api

The network config API manages the network config for Omnistrate entities

ListNetworkConfig network-config-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID to list network configs for

query Parameters
managed
boolean
Example: managed=false

Is network config managed by omnistrate

Responses

Response samples

Content type
application/json
{
  • "ids": [
    ],
  • "nextPageToken": "token"
}

CreateNetworkConfig network-config-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The ID of the service

Request Body schema: application/json
required
description
required
string

A brief description of the network config

endpointPerReplica
required
boolean

Generates a DNS endpoint per-replica for this network config

internal
boolean
Default: false

Restrict access to this network config to the internal network

name
required
string

Name of the network config

object

Named ports to map to the generated DNS endpoint

openPorts
Array of integers <int64> [ items <int64 > ]

Ports to map to the generated DNS endpoint

object (PrivateNetworkingConfiguration)

The private networking configuration for the network config

object (PublicNetworkingConfiguration)

The public networking configuration for the network config

stableEgressIP
boolean

Enable stable egress IP

tlsTerminationPort
integer <int64>

The port that hosts the reverse proxy for TLS termination

zoneConfiguration
string

The preferred type of zonal availability for this resource and the specific zone(s) to deploy in

Responses

Request samples

Content type
application/json
{
  • "description": "A multi-zone HA network config",
  • "endpointPerReplica": true,
  • "internal": true,
  • "name": "Multi-zone",
  • "namedOpenPorts": {
    },
  • "openPorts": [
    ],
  • "privateNetworkingConfiguration": {
    },
  • "publicNetworkingConfiguration": {
    },
  • "stableEgressIP": true,
  • "tlsTerminationPort": 443,
  • "zoneConfiguration": "SINGLE_ZONE_OMNISTRATE_RECOMMENDED|SINGLE_ZONE_CUSTOMER_PROVIDED|MULTI_ZONE"
}

Response samples

Content type
application/json
"Occaecati velit quo."

DeleteNetworkConfig network-config-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The ID of the service

id
required
string
Example: nc-12345678

The ID of the network config

Responses

DescribeNetworkConfig network-config-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The ID of the service

id
required
string
Example: nc-12345678

The ID of the network config

query Parameters
ProductTierVersion
string
Example: ProductTierVersion=Modi saepe totam pariatur deserunt aliquam.

Product tier version of the network config to describe. If not specified, the latest version is described.

ProductTierId
string
Example: ProductTierId=Ad a officiis est nobis debitis eos.

ProductTierId of the network config to describe. Needs to specified in combination with the product tier version

Responses

Response samples

Content type
application/json
{
  • "description": "A multi-zone HA network config",
  • "endpointPerReplica": true,
  • "id": "Ipsum perspiciatis.",
  • "infraConfigIDs": [
    ],
  • "internal": true,
  • "name": "Multi-zone",
  • "namedOpenPorts": {
    },
  • "openPorts": [
    ],
  • "privateNetworkingConfiguration": {
    },
  • "publicNetworkingConfiguration": {
    },
  • "serviceId": "s-123456",
  • "stableEgressIP": true,
  • "tlsTerminationPort": 443,
  • "zoneConfiguration": "SINGLE_ZONE_OMNISTRATE_RECOMMENDED|SINGLE_ZONE_CUSTOMER_PROVIDED|MULTI_ZONE"
}

UpdateNetworkConfig network-config-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The ID of the service

id
required
string
Example: nc-12345678

The ID of the network config

Request Body schema: application/json
required
description
string

A brief description of the network config

endpointPerReplica
boolean

Generates a DNS endpoint per-replica for this network config

internal
boolean

Restrict access to this network config to the internal network

name
string

Name of the network config

object

Named ports to map to the generated DNS endpoint

openPorts
Array of integers <int64> [ items <int64 > ]

Ports to map to the generated DNS endpoint

object (PrivateNetworkingConfiguration)

The private networking configuration for the network config

object (PublicNetworkingConfiguration)

The public networking configuration for the network config

stableEgressIP
boolean

Create an external node load balancer per node rather than expose the node ip directly

tlsTerminationPort
integer <int64>

The port that hosts the reverse proxy for TLS termination

zoneConfiguration
string

The preferred type of zonal availability for this resource and the specific zone(s) to deploy in

Responses

Request samples

Content type
application/json
{
  • "description": "A multi-zone HA network config",
  • "endpointPerReplica": true,
  • "internal": true,
  • "name": "Multi-zone",
  • "namedOpenPorts": {
    },
  • "openPorts": [
    ],
  • "privateNetworkingConfiguration": {
    },
  • "publicNetworkingConfiguration": {
    },
  • "stableEgressIP": true,
  • "tlsTerminationPort": 443,
  • "zoneConfiguration": "SINGLE_ZONE_OMNISTRATE_RECOMMENDED|SINGLE_ZONE_CUSTOMER_PROVIDED|MULTI_ZONE"
}

availability-zone-api

The Availability Zone API provides read-only access to availability zones

DescribeAvailabilityZone availability-zone-api

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: az-12345678

ID of an AZ

Responses

Response samples

Content type
application/json
{
  • "cloudProviderName": "aws|azure|gcp|nebius|oci|byoc-onprem|all",
  • "code": "us-east-1a",
  • "description": "US East (N. Virginia) Availability Zone A",
  • "id": "Aperiam cumque.",
  • "regionCode": "us-east-1"
}

ListAvailabilityZone availability-zone-api

Authorizations:
api_key_header_Authorization
path Parameters
cloudProviderName
required
string
Example: aws

The cloud provider for this compute instance type config

Responses

Response samples

Content type
application/json
{
  • "ids": [
    ],
  • "nextPageToken": "next-token"
}

GetAvailabilityZoneByCode availability-zone-api

Authorizations:
api_key_header_Authorization
path Parameters
code
required
string
Example: us-east-1a

Cloud-provider native availability zone code

cloudProviderName
required
string
Example: aws

The cloud provider for this compute instance type config

Responses

Response samples

Content type
application/json
"Accusamus quisquam ad molestiae dolore."

ListAvailabilityZonesByRegionCode availability-zone-api

Authorizations:
api_key_header_Authorization
path Parameters
regionCode
required
string
Example: us-east-1
cloudProviderName
required
string
Example: aws

The cloud provider for this compute instance type config

Responses

Response samples

Content type
application/json
{
  • "ids": [
    ],
  • "nextPageToken": "next-token"
}

region-api

The Region API provides read-only access to regions

DescribeRegion region-api

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: region-12345678

ID of the Region

Responses

Response samples

Content type
application/json
{
  • "cloudProviderId": "Eaque eos sequi non.",
  • "cloudProviderName": "aws|azure|gcp|nebius|oci|byoc-onprem|all",
  • "code": "us-east-1",
  • "description": "US East (N. Virginia)",
  • "id": "Ab vero sapiente."
}

ListRegion region-api

Authorizations:
api_key_header_Authorization
path Parameters
cloudProviderName
required
string
Example: aws

The cloud provider for this compute instance type config

query Parameters
serviceId
string
Example: serviceId=s-12345678

Service ID. If specified together with serviceModelId,list the regions of the service model. Otherwise list all regions.

serviceModelId
string
Example: serviceModelId=sm-12345678

Service model ID. If specified together with serviceId,list the regions of the service model. Otherwise list all regions.

productTierId
string
Example: productTierId=pt-12345678

Product tier ID. If specified together with serviceId,list the regions of the product tier. Otherwise list all regions.

modelType
string
Example: modelType=CUSTOMER_HOSTED

Model type. If specified, list regions for the specified model type.

Responses

Response samples

Content type
application/json
{
  • "ids": [
    ],
  • "nextPageToken": "next-token"
}

GetRegionByCode region-api

Authorizations:
api_key_header_Authorization
path Parameters
code
required
string non-empty
Example: us-east-1

Cloud-provider native region code

cloudProviderName
required
string
Example: aws

The cloud provider for this compute instance type config

Responses

Response samples

Content type
application/json
"Molestiae voluptas."

cloud-provider-api

The Cloud Provider API provides read-only access to cloud provider metadata

ListCloudProvider cloud-provider-api

Authorizations:
api_key_header_Authorization
query Parameters
serviceId
string
Example: serviceId=s-12345678

Service ID. If specified together with serviceModelId,list the cloud provider of the service model. Otherwise list all cloud provider.

serviceModelId
string
Example: serviceModelId=sm-12345678

Service model ID. If specified together with serviceId,list the cloud provider of the service model. Otherwise list all cloud provider.

productTierId
string
Example: productTierId=pt-12345678

Product tier ID. If specified together with serviceId,list the cloud provider of the product tier. Otherwise list all cloud provider.

Responses

Response samples

Content type
application/json
{
  • "ids": [
    ],
  • "nextPageToken": "next-token"
}

DescribeCloudProvider cloud-provider-api

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: infra-12345678

ID of the CloudProvider

Responses

Response samples

Content type
application/json
{
  • "description": "Amazon Web Services",
  • "id": "Placeat autem omnis incidunt id et.",
  • "name": "aws"
}

GetCloudProviderByName cloud-provider-api

Authorizations:
api_key_header_Authorization
path Parameters
name
required
string non-empty
Example: aws

Name of the CloudProvider

Responses

Response samples

Content type
application/json
"Et occaecati."

demo-api

The Demo API provides a demo of the system

Demo demo-api

Request Body schema: application/json
required
company
required
string non-empty
email
required
string <email> non-empty
name
required
string non-empty
phone
string

Responses

Request samples

Content type
application/json
{
  • "company": "ABC",
  • "email": "abc@gmail.com",
  • "name": "John Doe",
  • "phone": "+1-234567890"
}

contactus-api

The Contactus API for customers to reach out to us

Contactus contactus-api

Request Body schema: application/json
required
company
required
string non-empty
email
required
string <email> non-empty
message
required
string non-empty
name
required
string non-empty

Responses

Request samples

Content type
application/json
{
  • "company": "ABC",
  • "email": "abc@gmail.com",
  • "message": "this is a test",
  • "name": "John Doe"
}

signin-api

The signin API for customers to authenticate with us

LoginWithIdentityProvider signin-api

Request Body schema: application/json
required
object

Additional attributes for the user

authorizationCode
string

The authorization code from the Identity Provider

companyDescription
string non-empty
companyUrl
string non-empty
deviceCode
string

The device code from the Identity Provider

identityProviderName
required
string

The name of the identity provider

invitedEmail
string <email>

Email address that the user was invited with

legalCompanyName
string non-empty
redirectUri
string

The redirect URI used to get the authorization code

Responses

Request samples

Content type
application/json
{
  • "attributes": {
    },
  • "authorizationCode": "4/P7q7W91a-oMsCeLvIaQm6bTrgtp7&",
  • "companyDescription": "We sell xyz database software",
  • "companyUrl": "https://www.mywebsite.com",
  • "deviceCode": "4/P7q7W91a-oMsCeLvIaQm6bTrgtp7&",
  • "identityProviderName": "Google|GitHub|Microsoft Entra|Amazon Cognito|Okta|Auth0|Keycloak|OIDC",
  • "invitedEmail": "abc@gmail.com",
  • "legalCompanyName": "mywebsite",
  • "redirectUri": "https://www.example/redirect"
}

Response samples

Content type
application/json
{
  • "jwtToken": "",
  • "refreshToken": ""
}

RefreshToken signin-api

Exchange a valid refresh token for a new JWT token and refresh token pair

Request Body schema: application/json
required
refreshToken
string non-empty

The refresh token to exchange for a new JWT token. Optional when the refresh token is provided via httpOnly cookie.

Responses

Request samples

Content type
application/json
{
  • "refreshToken": "o"
}

Response samples

Content type
application/json
{
  • "jwtToken": "",
  • "refreshToken": ""
}

RevokeToken signin-api

Revoke a single refresh token, preventing further JWT renewal from that session. The access JWT continues until its natural TTL expiry. Idempotent: revoking an unknown or already-revoked token returns success.

Request Body schema: application/json
required
refreshToken
string non-empty

The refresh token to revoke. Optional when the refresh token is provided via httpOnly cookie.

Responses

Request samples

Content type
application/json
{
  • "refreshToken": "a2y"
}

Signin signin-api

Request Body schema: application/json
required
email
required
string <email> non-empty
hashedPassword
string non-empty
password
string non-empty

Responses

Request samples

Content type
application/json
{
  • "email": "abc@gmail.com",
  • "hashedPassword": "deprecated",
  • "password": "password"
}

Response samples

Content type
application/json
{
  • "jwtToken": "",
  • "refreshToken": ""
}

sp-organization-api

The Organization API for managing service provider organizations

GetCustomMetricsEndpoint sp-organization-api

Returns the custom metrics endpoint and an access token scoped to the authenticated organization.

Authorizations:
api_key_header_Authorization
query Parameters
expiresInSeconds
integer <int64> >= 1
Example: expiresInSeconds=86400

Optional lifetime in seconds for the access token. It cannot exceed the configured maximum validity.

Responses

Response samples

Content type
application/json
{}

DescribeServiceProviderOrganization sp-organization-api

Authorizations:
api_key_header_Authorization

Responses

Response samples

Content type
application/json
{
  • "DefaultDeploymentCellConfigurations": {
    },
  • "DeploymentCellConfigurationsPerEnv": {
    },
  • "awsAPNTagValue": "pc:partner123",
  • "id": "Adipisci quasi qui consectetur quos vitae ratione.",
  • "isPerEnvClusterEnabled": true
}

ModifyServiceProviderOrganization sp-organization-api

Authorizations:
api_key_header_Authorization
Request Body schema: application/json
required
object

The default deployment cell configurations for the organization per environment.

awsAPNTagValue
string

AWS APN tag override for this provider organization. Omit to leave unchanged or send an empty string to restore the default. Root and admin users only.

Responses

Request samples

Content type
application/json
{
  • "DeploymentCellConfigurations": {
    },
  • "awsAPNTagValue": "pc:partner123"
}

GetServiceProviderConfigurationForEnvironment sp-organization-api

Returns the service provider deployment cell configuration and account statuses for an environment

Authorizations:
api_key_header_Authorization
path Parameters
environmentType
required
string non-empty
Example: PROD

The type of the environment whose service provider configuration should be returned

Responses

Response samples

Content type
application/json
{
  • "deploymentCellConfigurationPerCloudProvider": {
    }
}

signup-api

The Signup API for customers to signup with us

ChangePassword signup-api

Request Body schema: application/json
required
email
required
string <email> non-empty
password
required
string non-empty
token
required
string non-empty

Responses

Request samples

Content type
application/json
{
  • "email": "abc@gmail.com",
  • "password": "password",
  • "token": "fc7b8dea-a50b-4c9a-8864-fc3d845a2be6"
}

ResetPassword signup-api

Request Body schema: application/json
required
email
required
string <email> non-empty

Responses

Request samples

Content type
application/json
{
  • "email": "abc@gmail.com"
}

Signup signup-api

Request Body schema: application/json
required
object

Additional attributes for the user signup

companyDescription
string non-empty
companyUrl
string non-empty
email
required
string <email> non-empty
legalCompanyName
string
Default: ""
name
required
string non-empty
password
required
string non-empty

Responses

Request samples

Content type
application/json
{
  • "attributes": {
    },
  • "companyDescription": "We sell xyz database software",
  • "companyUrl": "https://www.mywebsite.com",
  • "email": "abc@gmail.com",
  • "legalCompanyName": "mywebsite",
  • "name": "John Doe",
  • "password": "password"
}

RegenerateToken signup-api

path Parameters
id
required
string non-empty
Example: user-abcd1234

Responses

ValidateToken signup-api

Request Body schema: application/json
required
email
required
string <email> non-empty
token
required
string non-empty

Responses

Request samples

Content type
application/json
{
  • "email": "abc@gmail.com",
  • "token": "fc7b8dea-a50b-4c9a-8864-fc3d845a2be6"
}

plan-api

The Plan API is for payment info. It's explicitly empty for free plans.

DescribePlan plan-api

Authorizations:
api_key_header_Authorization

Responses

Response samples

Content type
application/json
{
  • "modifiedAt": "2023-01-01T00:00:00Z",
  • "paymentConfigured": true,
  • "paymentInfoPortalURL": "https://billing.stripe.com/p/session/abc123",
  • "planCoreHourCost": 0.05,
  • "planDescription": "The starter plan is priced at 'X' units",
  • "planFrequency": "MONTHLY",
  • "planMonthlyCost": 49,
  • "planName": "STARTER_NO_COMMIT|STARTER|GROWTH|ENTERPRISE",
  • "startDate": "2023-01-01"
}

ChangePlan plan-api

Authorizations:
api_key_header_Authorization
Request Body schema: application/json
required
planName
required
string

The name of the plan this user is changing to

Responses

Request samples

Content type
application/json
{
  • "planName": "STARTER_NO_COMMIT|STARTER|GROWTH|ENTERPRISE"
}

usage-api

The Usage API is for getting the last calendar month usage.

GetCurrentUsage usage-api

Authorizations:
api_key_header_Authorization

Responses

Response samples

Content type
application/json
{
  • "endTime": "2021-01-01T00:00:00.000Z",
  • "planName": "STARTER_NO_COMMIT|STARTER|GROWTH|ENTERPRISE",
  • "startTime": "2021-01-01T00:00:00.000Z",
  • "usage": [
    ]
}

GetUsagePerDay usage-api

Authorizations:
api_key_header_Authorization
query Parameters
startDate
string <date-time>
Example: startDate=2023-01-01T10:00:00Z

Start date of the usage report

endDate
string <date-time>
Example: endDate=2024-01-01T10:00:00Z

End date of the usage report

Responses

Response samples

Content type
application/json
{
  • "endTime": "2021-01-01T00:00:00.000Z",
  • "planName": "STARTER_NO_COMMIT|STARTER|GROWTH|ENTERPRISE",
  • "startTime": "2021-01-01T00:00:00.000Z",
  • "usage": [
    ]
}

invoice-api

The Invoices API gets the list of invoices for the organization

ListInvoices invoice-api

Authorizations:
api_key_header_Authorization
query Parameters
billingProvider
string
Example: billingProvider=STRIPE

Billing provider. If specified, list invoices for the specified billing provider.

Responses

Response samples

Content type
application/json
{}

DescribeInvoice invoice-api

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: in_1234568

The ID of the invoice

Responses

Response samples

Content type
application/json
{}

users-api

The user management API to manage user metadata

ChangeUserRole users-api

Authorizations:
api_key_header_Authorization
Request Body schema: application/json
required
email
required
string <email> non-empty
newRoleType
required
string

Responses

Request samples

Content type
application/json
{
  • "email": "abc@gmail.com",
  • "newRoleType": "root|editor|reader|service_editor|service_reader|admin|service_operator"
}

CustomerDeleteUser users-api

Authorizations:
api_key_header_Authorization

Responses

CustomerInviteUser users-api

Authorizations:
api_key_header_Authorization
Request Body schema: application/json
required
email
required
string <email> non-empty

Responses

Request samples

Content type
application/json
{
  • "email": "abc@example.com"
}

CustomerLoginWithIdentityProvider users-api

Authorizations:
api_key_header_Authorization
Request Body schema: application/json
required
object

Additional attributes for the user

authorizationCode
required
string

The authorization code from the Identity Provider

companyDescription
string non-empty
companyUrl
string non-empty
environmentType
string

The environment type of the portal that the customer is signing in to

identityProviderName
string

The name or type of the Identity Provider

invitedEmail
string <email>

Email address that the user was invited with

legalCompanyName
string non-empty
redirectUri
string

The redirect URI used to get the authorization code

state
string

The state parameter used to prevent CSRF attacks

Responses

Request samples

Content type
application/json
{
  • "attributes": {
    },
  • "authorizationCode": "4/P7q7W91a-oMsCeLvIaQm6bTrgtp7&",
  • "companyDescription": "We sell xyz database software",
  • "companyUrl": "https://www.mywebsite.com",
  • "environmentType": "PROD|PRIVATE|CANARY|STAGING|QA|DEV|GLOBAL",
  • "identityProviderName": "Google|GitHub|Microsoft Entra|Amazon Cognito|Okta|Auth0|Keycloak|OIDC",
  • "invitedEmail": "abc@gmail.com",
  • "legalCompanyName": "mywebsite",
  • "redirectUri": "https://www.example/redirect",
  • "state": "state"
}

Response samples

Content type
application/json
{
  • "jwtToken": "",
  • "refreshToken": ""
}

CustomerResetPassword users-api

Authorizations:
api_key_header_Authorization
Request Body schema: application/json
required
email
required
string <email> non-empty

Responses

Request samples

Content type
application/json
{
  • "email": "abc@example.com"
}

CustomerSignin users-api

Authorizations:
api_key_header_Authorization
Request Body schema: application/json
required
email
required
string <email> non-empty
environmentType
string

The environment type of the portal that the customer is signing in to

hashedPassword
string non-empty
password
string non-empty

Responses

Request samples

Content type
application/json
{
  • "email": "abc@gmail.com",
  • "environmentType": "PROD|PRIVATE|CANARY|STAGING|QA|DEV|GLOBAL",
  • "hashedPassword": "deprecated",
  • "password": "password"
}

Response samples

Content type
application/json
{
  • "jwtToken": "",
  • "refreshToken": ""
}

CustomerSignup users-api

Authorizations:
api_key_header_Authorization
Request Body schema: application/json
required
object

Additional attributes for the user signup

companyDescription
string non-empty
companyUrl
string non-empty
email
required
string <email> non-empty

Email address of the end-user

legalCompanyName
string
Default: ""
name
required
string non-empty

Name of the end-user

password
required
string non-empty

Responses

Request samples

Content type
application/json
{
  • "attributes": {
    },
  • "companyDescription": "We sell xyz database software",
  • "companyUrl": "https://www.mywebsite.com",
  • "email": "abc@gmail.com",
  • "legalCompanyName": "mywebsite",
  • "name": "John Doe",
  • "password": "password"
}

InviteUser users-api

Authorizations:
api_key_header_Authorization
Request Body schema: application/json
required
email
required
string <email> non-empty
roleType
required
string

Responses

Request samples

Content type
application/json
{
  • "email": "abc@gmail.com",
  • "roleType": "root|editor|reader|service_editor|service_reader|admin|service_operator"
}

Logout users-api

Authorizations:
api_key_header_Authorization

Responses

DescribeUsersByOrg users-api

Authorizations:
api_key_header_Authorization

Responses

Response samples

Content type
application/json
{
  • "Id": "org-aKQ8G13QeR",
  • "orgUsers": [
    ]
}

RevokeUserRole users-api

Authorizations:
api_key_header_Authorization
Request Body schema: application/json
required
email
required
string <email> non-empty
roleType
required
string

Responses

Request samples

Content type
application/json
{
  • "email": "abc@gmail.com",
  • "roleType": "root|editor|reader|service_editor|service_reader|admin|service_operator"
}

UpdatePassword users-api

Authorizations:
api_key_header_Authorization
Request Body schema: application/json
required
currentPassword
string non-empty
currentPasswordHash
string non-empty
password
required
string non-empty

Responses

Request samples

Content type
application/json
{
  • "currentPassword": "currentPassword",
  • "currentPasswordHash": "currentPasswordHash",
  • "password": "password"
}

DeleteUser users-api

Authorizations:
api_key_header_Authorization

Responses

DescribeUser users-api

Authorizations:
api_key_header_Authorization

Responses

Response samples

Content type
application/json
{
  • "address": {
    },
  • "attributes": {
    },
  • "createdAt": "2023-01-10T00:00:00Z",
  • "email": "abc@gmail.com",
  • "enabled": true,
  • "featureFlags": {
    },
  • "id": "user-abcd1234",
  • "lastModifiedAt": "2023-01-20T00:00:00Z",
  • "name": "John Dae",
  • "orgCookiePolicy": "Eum voluptatibus sed.",
  • "orgDescription": "ACME Inc.",
  • "orgDisablePasswordLogin": false,
  • "orgFavIconURL": "Ut reiciendis ea praesentium tempore hic.",
  • "orgId": "org-aKQ8G13QeR",
  • "orgLogoURL": "Nostrum quibusdam est vel facere.",
  • "orgName": "ACME",
  • "orgPrivacyPolicy": "Quos aut est eveniet et earum.",
  • "orgSupportEmail": "support@example.com",
  • "orgTermsOfUse": "Alias reiciendis.",
  • "orgURL": "something.acme",
  • "planName": "STARTER_NO_COMMIT|STARTER|GROWTH|ENTERPRISE",
  • "roleType": "root|editor|reader|service_editor|service_reader|admin|service_operator",
  • "status": "ACTIVE|NOT_ENABLED"
}

UpdateUser users-api

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: user-abcd1234

The User ID

Request Body schema: application/json
required
object (Address)
object

Additional attributes of the user.

name
string

The name of the user

orgCookiePolicy
string

The cookie policy for the org that this user owns in an HTML format

orgDescription
string

The description of the org that this user owns

orgDisablePasswordLogin
boolean

Whether password login is disabled for the org that this user owns

orgFavIconURL
string <uri>

The favicon of the org that this user owns

orgLogoURL
string <uri>

The logo of the org that this user owns

orgName
string

The org name that this user owns

orgPrivacyPolicy
string

The privacy policy for the org that this user owns in an HTML format

orgSupportEmail
string

The support email of the org that this user owns

orgTermsOfUse
string

The terms of use for the org that this user owns in an HTML format

orgURL
string

The url of the org that this user owns

Responses

Request samples

Content type
application/json
{
  • "address": {
    },
  • "attributes": {
    },
  • "name": "John Dae",
  • "orgCookiePolicy": "Dolores quae quo.",
  • "orgDescription": "ACME Inc.",
  • "orgDisablePasswordLogin": false,
  • "orgFavIconURL": "http://faheydibbert.info/effie",
  • "orgLogoURL": "http://rosenbaum.net/laury_klein",
  • "orgName": "ACME",
  • "orgPrivacyPolicy": "Temporibus sunt autem explicabo vel voluptatem qui.",
  • "orgSupportEmail": "support@example.com",
  • "orgTermsOfUse": "Quaerat aut adipisci qui.",
  • "orgURL": "something.acme"
}

consumption-user-api

The Consumption Signin API signs the user into the consumption service

ListAllSubscriptionUsers consumption-user-api

Authorizations:
api_key_header_Authorization
query Parameters
environmentType
string
Example: environmentType=DEV

The environment type to filter by

Responses

Response samples

Content type
application/json
{
  • "subscriptionUsers": [
    ]
}

InviteUser consumption-user-api

Authorizations:
api_key_header_Authorization
path Parameters
subscriptionId
required
string
Example: sub-abcd1234

The subscription ID

Request Body schema: application/json
required
email
required
string <email> non-empty
roleType
required
string

Responses

Request samples

Content type
application/json
{
  • "email": "abc@gmail.com",
  • "roleType": "root|editor|reader|service_editor|service_reader|admin|service_operator"
}

RevokeUserRole consumption-user-api

Authorizations:
api_key_header_Authorization
path Parameters
subscriptionId
required
string
Example: sub-abcd1234

The subscription ID

Request Body schema: application/json
required
email
required
string <email> non-empty
roleType
required
string

Responses

Request samples

Content type
application/json
{
  • "email": "abc@gmail.com",
  • "roleType": "root|editor|reader|service_editor|service_reader|admin|service_operator"
}

DescribeUsersBySubscription consumption-user-api

Authorizations:
api_key_header_Authorization
path Parameters
subscriptionId
required
string
Example: sub-abcd1234

The subscription ID

Responses

Response samples

Content type
application/json
{
  • "Id": "sub-abcd1234",
  • "subscriptionUsers": [
    ]
}

DescribeUserBillingDetails consumption-user-api

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: user-abcd1234

ID of a User

Responses

Response samples

Content type
application/json
{}

Signin consumption-user-api

Authorizations:
basic_header_Authorization

Responses

Response samples

Content type
application/json
{
  • "token": "2"
}

services-orchestration-api

The Services Orchestration API manages the orchestration of services

ListServicesOrchestrations services-orchestration-api

Authorizations:
api_key_header_Authorization

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    },
  • {
    }
]

CreateServicesOrchestration services-orchestration-api

Authorizations:
api_key_header_Authorization
Request Body schema: application/json
required
orchestrationCreateDSL
required
string

base64 encoded content of service orchestration create DSL

Responses

Request samples

Content type
application/json
{
  • "orchestrationCreateDSL": "Et quia blanditiis quia eius."
}

Response samples

Content type
application/json
{
  • "id": "Exercitationem ad aut dignissimos cum."
}

DeleteServicesOrchestration services-orchestration-api

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: so-12345678

The ID of the services orchestration

Responses

DescribeServicesOrchestration services-orchestration-api

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: so-12345678

The ID of the services orchestration

Responses

Response samples

Content type
application/json
{
  • "ServicesTopology": [
    ],
  • "createdAt": "2021-01-01T00:00:00Z",
  • "id": "Ea ut.",
  • "orchestrationFailedReason": "Invalid DSL",
  • "resultParams": {
    },
  • "status": "PENDING",
  • "updatedAt": "2021-01-01T00:00:00Z"
}

ModifyServicesOrchestration services-orchestration-api

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: so-12345678

The ID of the services orchestration

Request Body schema: application/json
required
orchestrationModifyDSL
required
string

base64 encoded content of services orchestration modify DSL

Responses

Request samples

Content type
application/json
{
  • "orchestrationModifyDSL": "Non rerum minima facere nesciunt."
}

resource-instance-api

The Resource Instance API manages the instances of a resource

ListAllResourceInstances resource-instance-api

Authorizations:
api_key_header_Authorization
query Parameters
environmentType
string
Example: environmentType=DEV

The environment type to filter by

Responses

Response samples

Content type
application/json
{
  • "nextPageToken": "next-token",
  • "resourceInstances": [
    ]
}

GenerateTokenForDeploymentCellDashboard resource-instance-api

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: instance-abcd1234

The instance ID whose deployment cell dashboard token is to be generated

query Parameters
subscriptionId
required
string
Example: subscriptionId=sub-abcd1234

Subscription Id

Responses

Response samples

Content type
application/json
{
  • "deploymentCellID": "hc-12345678",
  • "expirationTimestamp": "2021-01-01T00:00:00Z",
  • "token": "token"
}

UpgradeResourceInstanceVersion resource-instance-api

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: instance-abcd1234

The instance ID

query Parameters
subscriptionId
string
Example: subscriptionId=sub-abcd1234

Subscription Id

Request Body schema: application/json
required
productTierKey
required
string

The product tier name

resourceKey
required
string

The resource key

serviceAPIVersion
required
string

The service API version

serviceEnvironmentKey
required
string

The service environment name

serviceKey
required
string

The service name

serviceModelKey
required
string

The service model name

serviceProviderId
required
string

The service provider ID

targetVersion
string

The version to upgrade to

Responses

Request samples

Content type
application/json
{
  • "productTierKey": "premium",
  • "resourceKey": "mysql",
  • "serviceAPIVersion": "v1",
  • "serviceEnvironmentKey": "dev",
  • "serviceKey": "service-orchestration",
  • "serviceModelKey": "hosted",
  • "serviceProviderId": "Consectetur et aut.",
  • "targetVersion": "2.0"
}

ListResourceInstances resource-instance-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceProviderId
required
string
Example: omnistrate

The service provider ID

serviceKey
required
string
Example: service-orchestration

The service key

serviceAPIVersion
required
string
Example: v1

The service API version

serviceEnvironmentKey
required
string
Example: dev

The service environment name

serviceModelKey
required
string
Example: hosted

The service model name

productTierKey
required
string
Example: premium

The product tier name

resourceKey
required
string
Example: mysql

The resource key

query Parameters
subscriptionId
string
Example: subscriptionId=sub-abcd1234

Subscription Id

Responses

Response samples

Content type
application/json
{
  • "ids": [
    ],
  • "nextPageToken": "next-token"
}

CreateResourceInstance resource-instance-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceProviderId
required
string
Example: omnistrate

The service provider ID

serviceKey
required
string
Example: service-orchestration

The service name

serviceAPIVersion
required
string
Example: v1

The service API version

serviceEnvironmentKey
required
string
Example: dev

The service environment name

serviceModelKey
required
string
Example: hosted

The service model name

productTierKey
required
string
Example: premium

The product tier name

resourceKey
required
string
Example: mysql

The resource key

query Parameters
subscriptionId
string
Example: subscriptionId=sub-abcd1234

Subscription Id

header Parameters
Idempotency-Key
string [ 1 .. 255 ] characters
Example: 6a7b1c2d-3e4f-5061-7283-94a5b6c7d8e9

Makes this create safe to retry. Sending the same key with the same request returns the instance the first call created instead of creating a second one; sending it with a different request is rejected with 409. Keys are scoped to the calling user and expire 24 hours after first use

Request Body schema: application/json
required
cloud_provider
string

The cloud provider name

custom_network_id
string

Custom network for resource

Array of objects (CustomTag)

The custom tags for the resource instance

externalBillingId
string

This externalBillingId is deprecated and will be removed in the future

network_type
string

The network type

onprem_platform
string

OnPrem platform

productTierVersion
string

The product tier version

region
string

The region code

requestParams
any

The request parameters

Responses

Request samples

Content type
application/json
{
  • "cloud_provider": "aws",
  • "custom_network_id": "n-1234567890",
  • "customTags": [
    ],
  • "externalBillingId": "external-billing-id-1234",
  • "network_type": "PUBLIC|INTERNAL",
  • "onprem_platform": "OpenShift",
  • "productTierVersion": "1.0",
  • "region": "us-east-1",
  • "requestParams": {
    }
}

Response samples

Content type
application/json
{
  • "id": "Sint eos eos eum."
}

DeleteResourceInstance resource-instance-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceProviderId
required
string
Example: omnistrate

The service provider ID

serviceKey
required
string
Example: service-orchestration

The service name

serviceAPIVersion
required
string
Example: v1

The service API version

serviceEnvironmentKey
required
string
Example: dev

The service environment name

serviceModelKey
required
string
Example: hosted

The service model name

productTierKey
required
string
Example: premium

The product tier name

resourceKey
required
string
Example: mysql

The resource key

id
required
string
Example: instance-abcd1234

The instance ID

query Parameters
subscriptionId
string
Example: subscriptionId=sub-abcd1234

Subscription Id

skipFinalSnapshot
boolean
Default: false
Example: skipFinalSnapshot=false

Skip taking final snapshot before deletion. If false (default), a final snapshot will be taken before deletion if snapshot-before-deletion is enabled on the plan.

Responses

DescribeResourceInstance resource-instance-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceProviderId
required
string
Example: omnistrate

The service provider ID

serviceKey
required
string
Example: service-orchestration

The service name

serviceAPIVersion
required
string
Example: v1

The service API version

serviceEnvironmentKey
required
string
Example: dev

The service environment name

serviceModelKey
required
string
Example: hosted

The service model name

productTierKey
required
string
Example: premium

The product tier name

resourceKey
required
string
Example: mysql

The resource key

id
required
string
Example: instance-abcd1234

The instance ID

query Parameters
subscriptionId
string
Example: subscriptionId=sub-abcd1234

Subscription Id

Responses

Response samples

Content type
application/json
{
  • "active": true,
  • "autoscalingEnabled": true,
  • "awsAccountID": "123456789012",
  • "azureSubscriptionID": "0fa05079-dd73-4b88-babc-05537817604a",
  • "backupStatus": {
    },
  • "cloud_provider": "aws",
  • "created_at": "2023-01-10T00:00:00Z",
  • "createdByUserId": "Suscipit quod aut et numquam harum.",
  • "createdByUserName": "John Doe",
  • "currentReplicas": "2",
  • "customNetworkDetail": {
    },
  • "customTags": [
    ],
  • "detailedNetworkTopology": {
    },
  • "externalPayerId": "external-payer-id-1234",
  • "gcpProjectID": "my-project",
  • "highAvailability": true,
  • "id": "instance-abcd1234",
  • "instanceLoadStatus": "LOAD_NORMAL|LOAD_IDLE|LOAD_OVERLOADED|STOPPED|UNKNOWN|N/A",
  • "kubernetesDashboardEndpoint": {},
  • "last_modified_at": "2023-01-20T00:00:00Z",
  • "launch_input_params": {
    },
  • "maintenanceTasks": {
    },
  • "maxReplicas": "1",
  • "minReplicas": "1",
  • "nebiusTenantID": "tenant-e00ezh17k22wmwq5f0",
  • "network_type": "PUBLIC|INTERNAL",
  • "ociTenancyID": "ocid1.tenancy.oc1..aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  • "onPremInstallerDetails": {},
  • "onpremPlatform": "EKS|GKE|AKS|Generic",
  • "productTierFeatures": {
    },
  • "productTierVersionDetail": {
    },
  • "region": "us-east-1",
  • "resourceID": "Veniam mollitia natus laborum placeat vitae aut.",
  • "resourceInstanceMetadata": {
    },
  • "result_params": {
    },
  • "serverlessEnabled": true,
  • "snapshotBeforeDeletionEnabled": true,
  • "sourceSnapshotID": "instance-ss-abcd1234",
  • "status": "FAILED|CANCELLED|PENDING_DEPENDENCY|PENDING|RUNNING|DEPLOYING|UPLOADING|READY|SUCCESS|COMPLETE|DELETING|DELETED|UNKNOWN|DISCONNECTED|DISCONNECTING|CONNECTING|DEACTIVATED",
  • "subscriptionId": "sub-abcd1234",
  • "subscriptionLicense": {
    },
  • "subscriptionStatus": "ACTIVE|SUSPENDED|TERMINATED|CANCELLED",
  • "supportedOperations": [
    ],
  • "tierVersion": "1.0"
}

UpdateResourceInstance resource-instance-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceProviderId
required
string
Example: omnistrate

The service provider ID

serviceKey
required
string
Example: service-orchestration

The service name

serviceAPIVersion
required
string
Example: v1

The service API version

serviceEnvironmentKey
required
string
Example: dev

The service environment name

serviceModelKey
required
string
Example: hosted

The service model name

productTierKey
required
string
Example: premium

The product tier name

resourceKey
required
string
Example: mysql

The resource key

id
required
string
Example: instance-abcd1234

The instance ID

query Parameters
subscriptionId
string
Example: subscriptionId=sub-abcd1234

Subscription Id

Request Body schema: application/json
required
Array of objects (CustomTag)

The custom tag for the resource instance

network_type
string

The network type

requestParams
any

The request parameters

Responses

Request samples

Content type
application/json
{
  • "customTags": [
    ],
  • "network_type": "PUBLIC|INTERNAL",
  • "requestParams": {
    }
}

AddCapacityToResourceInstance resource-instance-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceProviderId
required
string
Example: omnistrate

The service provider ID

serviceKey
required
string
Example: service-orchestration

The service name

serviceAPIVersion
required
string
Example: v1

The service API version

serviceEnvironmentKey
required
string
Example: dev

The service environment name

serviceModelKey
required
string
Example: hosted

The service model name

productTierKey
required
string
Example: premium

The product tier name

resourceKey
required
string
Example: mysql

The resource key

id
required
string
Example: instance-abcd1234

The instance ID

query Parameters
subscriptionId
string
Example: subscriptionId=sub-abcd1234

Subscription Id

Request Body schema: application/json
required
capacityToBeAdded
required
integer <int64>

Number of replicas to be added

Responses

Request samples

Content type
application/json
{
  • "capacityToBeAdded": 3
}

CopyResourceInstanceSnapshot resource-instance-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceProviderId
required
string
Example: omnistrate

The service provider ID

serviceKey
required
string
Example: service-orchestration

The service name

serviceAPIVersion
required
string
Example: v1

The service API version

serviceEnvironmentKey
required
string
Example: dev

The service environment name

serviceModelKey
required
string
Example: hosted

The service model name

productTierKey
required
string
Example: premium

The product tier name

resourceKey
required
string
Example: mysql

The resource key

id
required
string
Example: instance-abcd1234

The instance ID

query Parameters
subscriptionId
string
Example: subscriptionId=sub-abcd1234

Subscription Id

Request Body schema: application/json
required
sourceSnapshotId
string

The source snapshot ID

targetRegion
required
string

The target region to copy the snapshot to

Responses

Request samples

Content type
application/json
{
  • "sourceSnapshotId": "Dolores cumque aspernatur debitis.",
  • "targetRegion": "us-west-2"
}

Response samples

Content type
application/json
{
  • "snapshotId": "Fuga modi nesciunt exercitationem expedita."
}

RemoveCustomDNSFromResourceInstance resource-instance-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceProviderId
required
string
Example: omnistrate

The service provider ID

serviceKey
required
string
Example: service-orchestration

The service name

serviceAPIVersion
required
string
Example: v1

The service API version

serviceEnvironmentKey
required
string
Example: dev

The service environment name

serviceModelKey
required
string
Example: hosted

The service model name

productTierKey
required
string
Example: premium

The product tier name

resourceKey
required
string
Example: http-service

The resource key

id
required
string
Example: instance-abcd1234

The instance ID

query Parameters
subscriptionId
string
Example: subscriptionId=sub-abcd1234

Subscription Id

Responses

AddCustomDNSToResourceInstance resource-instance-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceProviderId
required
string
Example: omnistrate

The service provider ID

serviceKey
required
string
Example: service-orchestration

The service name

serviceAPIVersion
required
string
Example: v1

The service API version

serviceEnvironmentKey
required
string
Example: dev

The service environment name

serviceModelKey
required
string
Example: hosted

The service model name

productTierKey
required
string
Example: premium

The product tier name

resourceKey
required
string
Example: http-service

The resource key

id
required
string
Example: instance-abcd1234

The instance ID

query Parameters
subscriptionId
string
Example: subscriptionId=sub-abcd1234

Subscription Id

Request Body schema: application/json
required
customDNS
required
string

The custom DNS to add

targetPort
integer <int64>

The target port

Responses

Request samples

Content type
application/json
{
  • "customDNS": "my-custom-dns.com",
  • "targetPort": 8080
}

ResourceInstanceCustomWorkflow resource-instance-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceProviderId
required
string
Example: omnistrate

The service provider ID

serviceKey
required
string
Example: service-orchestration

The service name

serviceAPIVersion
required
string
Example: v1

The service API version

serviceEnvironmentKey
required
string
Example: dev

The service environment name

serviceModelKey
required
string
Example: hosted

The service model name

productTierKey
required
string
Example: premium

The product tier name

resourceKey
required
string
Example: postgres

The resource key

id
required
string
Example: instance-abcd1234

The instance ID

workflowId
required
string
Example: cwt-12345678

The custom workflow ID from the instance's supportedOperations list.

query Parameters
subscriptionId
string
Example: subscriptionId=sub-abcd1234

Subscription Id

Request Body schema: application/json
required
requestParams
any

Input parameters for the custom workflow. System workflow operations do not require user supplied parameters.

Responses

Request samples

Content type
application/json
{
  • "requestParams": {
    }
}

Response samples

Content type
application/json
{
  • "status": "FAILED|CANCELLED|PENDING_DEPENDENCY|PENDING|RUNNING|DEPLOYING|UPLOADING|READY|SUCCESS|COMPLETE|DELETING|DELETED|UNKNOWN|DISCONNECTED|DISCONNECTING|CONNECTING|DEACTIVATED",
  • "workflowExecutionId": "Labore iure sint placeat.",
  • "workflowId": "Occaecati illum ut eum incidunt."
}

FailoverResourceInstance resource-instance-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceProviderId
required
string
Example: omnistrate

The service provider ID

serviceKey
required
string
Example: service-orchestration

The service name

serviceAPIVersion
required
string
Example: v1

The service API version

serviceEnvironmentKey
required
string
Example: dev

The service environment name

serviceModelKey
required
string
Example: hosted

The service model name

productTierKey
required
string
Example: premium

The product tier name

resourceKey
required
string
Example: mysql

The resource key

id
required
string
Example: instance-abcd1234

The instance ID

query Parameters
subscriptionId
string
Example: subscriptionId=sub-abcd1234

Subscription Id

Request Body schema: application/json
required
failedReplicaAction
string

The failed replica action

failedReplicaID
required
string

The failed replica ID

Responses

Request samples

Content type
application/json
{
  • "failedReplicaAction": "FAILOVER_ONLY|FAILOVER_AND_RESTART|FAILOVER_AND_RECREATE",
  • "failedReplicaID": "db-0"
}

DescribeResourceInstanceHealthHistory resource-instance-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceProviderId
required
string
Example: omnistrate

The service provider ID

serviceKey
required
string
Example: service-orchestration

The service name

serviceAPIVersion
required
string
Example: v1

The service API version

serviceEnvironmentKey
required
string
Example: dev

The service environment name

serviceModelKey
required
string
Example: hosted

The service model name

productTierKey
required
string
Example: premium

The product tier name

resourceKey
required
string
Example: mysql

The resource key

id
required
string
Example: instance-abcd1234

The instance ID

query Parameters
subscriptionId
string
Example: subscriptionId=sub-abcd1234

Subscription Id

startTime
required
string <date-time>
Example: startTime=2026-10-06T10:00:00Z

Inclusive start of the requested period, in RFC3339 format

endTime
required
string <date-time>
Example: endTime=2026-10-06T11:00:00Z

Exclusive end of the requested period, in RFC3339 format

limit
integer <int64> [ 1 .. 1000 ]
Default: 100
Example: limit=304

Maximum number of changes to return in one page

nextPageToken
string <= 4096 characters
Example: nextPageToken=nq9

Continuation token bound to the provider, instance, and requested period

Responses

Response samples

Content type
application/json
{
  • "changes": [
    ],
  • "endTime": "1984-08-30T17:14:23Z",
  • "initialStatus": {
    },
  • "instanceId": "instance-12345678",
  • "nextPageToken": "Laborum reprehenderit omnis dolore aut aperiam nostrum.",
  • "startTime": "2006-10-25T04:02:02Z"
}

UpdateResourceInstanceMetadata resource-instance-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceProviderId
required
string
Example: omnistrate

The service provider ID

serviceKey
required
string
Example: service-orchestration

The service name

serviceAPIVersion
required
string
Example: v1

The service API version

serviceEnvironmentKey
required
string
Example: dev

The service environment name

serviceModelKey
required
string
Example: hosted

The service model name

productTierKey
required
string
Example: premium

The product tier name

resourceKey
required
string
Example: mysql

The resource key

id
required
string
Example: instance-abcd1234

The instance ID

query Parameters
subscriptionId
string
Example: subscriptionId=sub-abcd1234

Subscription Id

Request Body schema: application/json
required
Array of objects (CustomTag)

The custom tag for the resource instance

deletionProtection
boolean

Set to true to enable deletion protection or false to disable it

Responses

Request samples

Content type
application/json
{
  • "customTags": [
    ],
  • "deletionProtection": true
}

RemoveCapacityFromResourceInstance resource-instance-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceProviderId
required
string
Example: omnistrate

The service provider ID

serviceKey
required
string
Example: service-orchestration

The service name

serviceAPIVersion
required
string
Example: v1

The service API version

serviceEnvironmentKey
required
string
Example: dev

The service environment name

serviceModelKey
required
string
Example: hosted

The service model name

productTierKey
required
string
Example: premium

The product tier name

resourceKey
required
string
Example: mysql

The resource key

id
required
string
Example: instance-abcd1234

The instance ID

query Parameters
subscriptionId
string
Example: subscriptionId=sub-abcd1234

Subscription Id

Request Body schema: application/json
required
capacityToBeRemoved
required
integer <int64>

Number of replicas to be removed

Responses

Request samples

Content type
application/json
{
  • "capacityToBeRemoved": 3
}

RestartResourceInstance resource-instance-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceProviderId
required
string
Example: omnistrate

The service provider ID

serviceKey
required
string
Example: service-orchestration

The service name

serviceAPIVersion
required
string
Example: v1

The service API version

serviceEnvironmentKey
required
string
Example: dev

The service environment name

serviceModelKey
required
string
Example: hosted

The service model name

productTierKey
required
string
Example: premium

The product tier name

resourceKey
required
string
Example: mysql

The resource key

id
required
string
Example: instance-abcd1234

The instance ID

query Parameters
subscriptionId
string
Example: subscriptionId=sub-abcd1234

Subscription Id

Responses

RestoreResourceInstance resource-instance-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceProviderId
required
string
Example: omnistrate

The service provider ID

serviceKey
required
string
Example: service-orchestration

The service name

serviceAPIVersion
required
string
Example: v1

The service API version

serviceEnvironmentKey
required
string
Example: dev

The service environment name

serviceModelKey
required
string
Example: hosted

The service model name

productTierKey
required
string
Example: premium

The product tier name

resourceKey
required
string
Example: mysql

The resource key

id
required
string
Example: instance-abcd1234

The instance ID

query Parameters
subscriptionId
string
Example: subscriptionId=sub-abcd1234

Subscription Id

Request Body schema: application/json
required
network_type
string

The network type

targetRestoreTime
required
string

The target restore time

Responses

Request samples

Content type
application/json
{
  • "network_type": "PUBLIC|INTERNAL",
  • "targetRestoreTime": "2021-09-01T00:00:00Z"
}

Response samples

Content type
application/json
{
  • "id": "Veritatis quasi ut in."
}

ListResourceInstanceSnapshots resource-instance-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceProviderId
required
string
Example: omnistrate

The service provider ID

serviceKey
required
string
Example: service-orchestration

The service key

serviceAPIVersion
required
string
Example: v1

The service API version

serviceEnvironmentKey
required
string
Example: dev

The service environment name

serviceModelKey
required
string
Example: hosted

The service model name

productTierKey
required
string
Example: premium

The product tier name

resourceKey
required
string
Example: mysql

The resource key

id
required
string
Example: instance-abcd1234

The instance ID

query Parameters
subscriptionId
string
Example: subscriptionId=sub-abcd1234

Subscription Id

Responses

Response samples

Content type
application/json
{
  • "snapshots": [
    ]
}

StartResourceInstance resource-instance-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceProviderId
required
string
Example: omnistrate

The service provider ID

serviceKey
required
string
Example: service-orchestration

The service name

serviceAPIVersion
required
string
Example: v1

The service API version

serviceEnvironmentKey
required
string
Example: dev

The service environment name

serviceModelKey
required
string
Example: hosted

The service model name

productTierKey
required
string
Example: premium

The product tier name

resourceKey
required
string
Example: mysql

The resource key

id
required
string
Example: instance-abcd1234

The instance ID

query Parameters
subscriptionId
string
Example: subscriptionId=sub-abcd1234

Subscription Id

Responses

StopResourceInstance resource-instance-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceProviderId
required
string
Example: omnistrate

The service provider ID

serviceKey
required
string
Example: service-orchestration

The service name

serviceAPIVersion
required
string
Example: v1

The service API version

serviceEnvironmentKey
required
string
Example: dev

The service environment name

serviceModelKey
required
string
Example: hosted

The service model name

productTierKey
required
string
Example: premium

The product tier name

resourceKey
required
string
Example: mysql

The resource key

id
required
string
Example: instance-abcd1234

The instance ID

query Parameters
subscriptionId
string
Example: subscriptionId=sub-abcd1234

Subscription Id

Responses

RestoreResourceInstanceFromSnapshot resource-instance-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceProviderId
required
string
Example: omnistrate

The service provider ID

serviceKey
required
string
Example: service-orchestration

The service name

serviceAPIVersion
required
string
Example: v1

The service API version

serviceEnvironmentKey
required
string
Example: dev

The service environment name

serviceModelKey
required
string
Example: hosted

The service model name

productTierKey
required
string
Example: premium

The product tier name

resourceKey
required
string
Example: mysql

The resource key

snapshotId
required
string
Example: instance-ss-abcd1234

The snapshot ID

query Parameters
subscriptionId
string
Example: subscriptionId=sub-abcd1234

Subscription Id

Request Body schema: application/json
required
custom_network_id
string

Custom network for resource

network_type
string

The network type

Responses

Request samples

Content type
application/json
{
  • "custom_network_id": "n-1234567890",
  • "network_type": "PUBLIC|INTERNAL"
}

Response samples

Content type
application/json
{
  • "id": "Voluptate ut."
}

ResourceInstanceProvisionerSetupKit resource-instance-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceProviderId
required
string
Example: omnistrate

The service provider ID

serviceKey
required
string
Example: service-orchestration

The service name

serviceAPIVersion
required
string
Example: v1

The service API version

serviceEnvironmentKey
required
string
Example: dev

The service environment name

serviceModelKey
required
string
Example: hosted

The service model name

query Parameters
subscriptionId
string
Example: subscriptionId=sub-abcd1234

Subscription Id

Responses

UpdateAccountConfigResourceInstance resource-instance-api

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: instance-abcd1234

The instance ID

Request Body schema: application/json
required
Array of objects (CustomTag)

Full replacement set of custom tags for the backing account configuration

Array of objects (UpdateAccountConfigNebiusBindingInput)

Full replacement set of Nebius bindings for this account config instance

serviceId
required
string

The service ID

setConnection
boolean

set account config instance connection

subscriptionId
required
string

The subscription ID

Responses

Request samples

Content type
application/json
{
  • "customTags": [
    ],
  • "nebiusBindings": [
    ],
  • "serviceId": "service-1234",
  • "setConnection": true,
  • "subscriptionId": "sub-abcd1234"
}

instance-snapshot-api

The Instance Snapshot API manages the snapshots of resource instances

ListAllInstanceSnapshots instance-snapshot-api

Authorizations:
api_key_header_Authorization
query Parameters
environmentType
string
Example: environmentType=DEV

The environment type to filter by

snapshotType
string
Example: snapshotType=AutomatedSnapshot|ManualSnapshot

The type of snapshot to list. Valid values are: 'ManualSnapshot' and 'AutomatedSnapshot'

Responses

Response samples

Content type
application/json
{
  • "snapshots": [
    ]
}

CreateInstanceSnapshot instance-snapshot-api

Authorizations:
api_key_header_Authorization
query Parameters
subscriptionId
string
Example: subscriptionId=sub-abcd1234

The subscription ID

Request Body schema: application/json
required
instanceId
required
string

The instance ID

targetRegion
string

The target region to create the snapshot in. If not specified, use the same region as the instance

Responses

Request samples

Content type
application/json
{
  • "instanceId": "instance-abcd1234",
  • "targetRegion": "us-west-2"
}

Response samples

Content type
application/json
{
  • "id": "Hic dolorum iste et fugiat."
}

DeleteInstanceSnapshot instance-snapshot-api

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: instance-ss-12345678

The instance snapshot ID

query Parameters
subscriptionId
string
Example: subscriptionId=sub-abcd1234

The subscription ID

Responses

DescribeInstanceSnapshot instance-snapshot-api

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: instance-ss-12345678

The instance snapshot ID

query Parameters
subscriptionId
string
Example: subscriptionId=sub-abcd1234

The subscription ID

Responses

Response samples

Content type
application/json
{
  • "cloudProvider": "aws|azure|gcp|nebius|oci|byoc-onprem|all",
  • "completeTime": "2021-09-01T00:00:00Z",
  • "createdTime": "2021-09-01T00:00:00Z",
  • "encrypted": true,
  • "outputParams": [
    ],
  • "productTierId": "Sunt quia.",
  • "productTierName": "Premium",
  • "productTierVersion": "1.0",
  • "productTierVersionDescription": "Version 1.0",
  • "progress": 99,
  • "region": "us-west-2",
  • "serviceId": "s-123456",
  • "serviceName": "Postgres",
  • "snapshotId": "Vel dicta sint eum mollitia.",
  • "snapshotMetadata": {
    },
  • "snapshotType": "AutomatedSnapshot|ManualSnapshot",
  • "sourceInstanceId": "instance-12345678",
  • "status": "completed",
  • "subscriptionId": "Unde vel.",
  • "subscriptionOwnerOrgId": "Similique illo aliquam non quam consequatur.",
  • "subscriptionOwnerOrgName": "Example Inc.",
  • "subscriptionOwnerUserId": "Sapiente quidem neque id architecto a.",
  • "subscriptionOwnerUserName": "Admin"
}

RestoreResourceInstanceFromSnapshot instance-snapshot-api

Authorizations:
api_key_header_Authorization
path Parameters
snapshotId
required
string
Example: instance-ss-abcd1234

The snapshot ID

query Parameters
subscriptionId
string
Example: subscriptionId=sub-abcd1234

The subscription ID

Request Body schema: application/json
required
custom_network_id
string

Custom network for resource

network_type
string

The network type

Responses

Request samples

Content type
application/json
{
  • "custom_network_id": "n-1234567890",
  • "network_type": "PUBLIC|INTERNAL"
}

Response samples

Content type
application/json
{
  • "instanceId": "Porro tempora dignissimos."
}

CopyInstanceSnapshot instance-snapshot-api

Authorizations:
api_key_header_Authorization
path Parameters
sourceSnapshotId
required
string
Example: instance-ss-abcd1234

The source snapshot ID

query Parameters
subscriptionId
string
Example: subscriptionId=sub-abcd1234

The subscription ID

Request Body schema: application/json
required
targetRegion
required
string

The target region to copy the snapshot to

Responses

Request samples

Content type
application/json
{
  • "targetRegion": "us-west-2"
}

Response samples

Content type
application/json
{
  • "id": "Eligendi distinctio voluptatem tempora fugit unde dolorum."
}

consumption-usage-api

The Consumption Usage API retrieves the usage data for consumption users

GetCurrentConsumptionUsage consumption-usage-api

Authorizations:
api_key_header_Authorization
query Parameters
subscriptionID
string
Example: subscriptionID=sub-12345678

The subscription ID to get usage for

Responses

Response samples

Content type
application/json
{
  • "endTime": "2021-01-01T00:00:00.000Z",
  • "startTime": "2021-01-01T00:00:00.000Z",
  • "usage": [
    ]
}

GetConsumptionUsagePerDay consumption-usage-api

Authorizations:
api_key_header_Authorization
query Parameters
startDate
string <date-time>
Example: startDate=2023-01-01T10:00:00Z

Start date of the usage report

endDate
string <date-time>
Example: endDate=2024-01-01T10:00:00Z

End date of the usage report

subscriptionID
string
Example: subscriptionID=sub-12345678

The subscription ID to get usage for

Responses

Response samples

Content type
application/json
{
  • "endTime": "2021-01-01T00:00:00.000Z",
  • "startTime": "2021-01-01T00:00:00.000Z",
  • "usage": [
    ]
}

consumption-invoice-api

The Consumption Invoice API retrieves the invoice data for consumption users

ListConsumptionInvoices consumption-invoice-api

Authorizations:
api_key_header_Authorization
query Parameters
billingProvider
string
Example: billingProvider=STRIPE

Billing provider. If specified, list invoices for the specified billing provider.

Responses

Response samples

Content type
application/json
{}

consumption-billing-api

The Consumption Invoice API retrieves the billing information for consumption users

DescribeConsumptionBillingDetails consumption-billing-api

Authorizations:
api_key_header_Authorization
query Parameters
returnUrl
string
Example: returnUrl=https://mysaasportal.com

Return Url used to configure payment methods links

supportsCustomPaymentPortal
boolean
Example: supportsCustomPaymentPortal=true

Whether the caller supports inline custom payment method management

Responses

Response samples

Content type
application/json
{}

DescribeConsumptionBillingStatus consumption-billing-api

Authorizations:
api_key_header_Authorization

Responses

Response samples

Content type
application/json
{
  • "enabled": true
}

account-config-api

The Account Config API manages the access information for a Service Provider account

CreateAccountConfig account-config-api

Authorizations:
api_key_header_Authorization
Request Body schema: application/json
required
awsAccessKey
string

The AWS access key

awsAccountID
string

The AWS account ID

awsBootstrapRoleARN
string

The security role ARN or service account ARN that grants access to operate the infra

awsSecretKey
string

The AWS secret key

azureSubscriptionID
string

The Azure subscription ID

azureTenantID
string

The Azure tenant ID

byoaInstanceID
string

The BYOA instance ID that this account config is tied to

cloudProviderId
required
string

Cloud Provider ID to operate on

Array of objects (CustomTag)

The custom tags for the account configuration

description
required
string

The description for the account

gcpProjectID
string

The GCP project ID

gcpProjectNumber
string

The GCP project number

gcpServiceAccountEmail
string

The GCP service account email

gcpServiceAccountKey
string

The GCP service account key

name
required
string

The name of the account

Array of objects (NebiusAccountBindingInput)

The Nebius per-region project/service-account bindings for the tenant-scoped Nebius account configuration

nebiusTenantID
string

The Nebius tenant ID for the tenant-scoped Nebius account configuration

ociDomainID
string

The Domain OCID for Oracle Cloud Infrastructure

ociTenancyID
string

The Tenancy OCID for Oracle Cloud Infrastructure

Responses

Request samples

Content type
application/json
{
  • "awsAccessKey": "Et excepturi quo quia.",
  • "awsAccountID": "123456789012",
  • "awsBootstrapRoleARN": "arn:aws:iam::<ACCOUNT_ID>:role/<ROLE_NAME>",
  • "awsSecretKey": "Voluptatem eaque.",
  • "azureSubscriptionID": "12345678-1234-1234-1234-123456789012",
  • "azureTenantID": "12345678-1234-1234-1234-123456789012",
  • "byoaInstanceID": "instance-12345678",
  • "cloudProviderId": "Perferendis consequuntur.",
  • "customTags": [
    ],
  • "description": "An AWS account hosting multiple dev environments",
  • "gcpProjectID": "my-project",
  • "gcpProjectNumber": "123456789012",
  • "gcpServiceAccountEmail": "bootstrap@my-project.iam.gserviceaccount.com",
  • "gcpServiceAccountKey": "Placeat velit ipsa facilis minus.",
  • "name": "Dev AWS account",
  • "nebiusBindings": [
    ],
  • "nebiusTenantID": "tenant-id",
  • "ociDomainID": "ocid1.domain.oc1..aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  • "ociTenancyID": "ocid1.tenancy.oc1..aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
}

Response samples

Content type
application/json
"Non dolorum error saepe dolorem."

DeleteAccountConfig account-config-api

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: ac-12345678

Account Config ID to operate on

Responses

DescribeAccountConfig account-config-api

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: ac-12345678

Account Config ID to operate on

Responses

Response samples

Content type
application/json
{
  • "awsAccountID": "123456789012",
  • "awsBootstrapRoleARN": "arn:aws:iam::<ACCOUNT_ID>:role/<ROLE_NAME>",
  • "awsCloudFormationNoLBTemplateURL": "https://s3.amazonaws.com/omnistrate-cloudformation/org-EUVvex3bVm/account-config-setup-template-no-lb-policy.yaml",
  • "awsCloudFormationTemplateURL": "https://s3.amazonaws.com/omnistrate-cloudformation/org-EUVvex3bVm/account-config-setup-template.yaml",
  • "azureBootstrapShellCommand": "bash -c \"$(curl -fsSL https://omnistrate.com/account-setup/azure-bootstrap.sh?account_config_id=ac-MOju2uwKM0)\"",
  • "azureDisconnectShellCommand": "bash -c \"$(curl -fsSL https://omnistrate.com/account-setup/azure-disconnect.sh?account_config_id=ac-MOju2uwKM0)\"",
  • "azureOffboardShellCommand": "bash -c \"$(curl -fsSL https://omnistrate.com/account-setup/azure-offboard.sh?account_config_id=ac-MOju2uwKM0)\"",
  • "azureSubscriptionID": "12345678-1234-1234-1234-123456789012",
  • "azureTenantID": "12345678-1234-1234-1234-123456789012",
  • "byoaInstanceIDs": [
    ],
  • "cloudProviderId": "Unde assumenda magni dolorum at et non.",
  • "customTags": [
    ],
  • "description": "An AWS account hosting multiple dev environments",
  • "gcpBootstrapShellCommand": "bash -c \"$(curl -fsSL https://omnistrate.com/account-setup/gcp-bootstrap.sh?account_config_id=ac-MOju2uwKM0)\"",
  • "gcpDisconnectShellCommand": "bash -c \"$(curl -fsSL https://omnistrate.com/account-setup/gcp-disconnect.sh?account_config_id=ac-MOju2uwKM0)\"",
  • "gcpOffboardShellCommand": "bash -c \"$(curl -fsSL https://omnistrate.com/account-setup/gcp-offboard.sh?account_config_id=ac-MOju2uwKM0)\"",
  • "gcpProjectID": "my-project",
  • "gcpProjectNumber": "123456789012",
  • "gcpServiceAccountEmail": "bootstrap@my-project.iam.gserviceaccount.com",
  • "id": "Eveniet sint accusantium occaecati quisquam consequatur.",
  • "name": "Dev AWS account",
  • "nebiusBindings": [
    ],
  • "nebiusTenantID": "tenant-e00abc123",
  • "ociBootstrapShellCommand": "bash -c \"$(curl -fsSL https://omnistrate.com/account-setup/oci-bootstrap.sh?account_config_id=ac-MOju2uwKM0)\"",
  • "ociDisconnectShellCommand": "bash -c \"$(curl -fsSL https://omnistrate.com/account-setup/oci-disconnect.sh?account_config_id=ac-MOju2uwKM0)\"",
  • "ociDomainID": "ocid1.domain.oc1..aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  • "ociOffboardShellCommand": "bash -c \"$(curl -fsSL https://omnistrate.com/account-setup/oci-offboard.sh?account_config_id=ac-MOju2uwKM0)\"",
  • "ociTenancyID": "ocid1.tenancy.oc1..aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  • "status": "PENDING|VERIFYING|READY|FAILED|DELETING|READY_TO_OFFBOARD",
  • "statusMessage": "Account is ready"
}

UpdateAccountConfig account-config-api

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: ac-12345678

Account Config ID to operate on

Request Body schema: application/json
required
Array of objects (CustomTag)

Full replacement set of custom tags for the account configuration

description
string

The updated description for the account

name
string

The updated name of the account

Array of objects (NebiusAccountBindingInput)

Full replacement set of Nebius project/service-account bindings for an existing tenant-scoped Nebius account configuration

Responses

Request samples

Content type
application/json
{
  • "customTags": [
    ],
  • "description": "Nebius account for eu-north1 and eu-west1 projects",
  • "name": "Updated Nebius account",
  • "nebiusBindings": [
    ]
}

Response samples

Content type
application/json
"Ex eius modi quod tempora."

ListAccountConfigCloudNativeNetworks account-config-api

List all registered CloudNativeNetworks for an account configuration

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: ac-12345678

Account Config ID to operate on

Responses

Response samples

Content type
application/json
{
  • "cloudNativeNetworks": [
    ]
}

ImportAccountConfigCloudNativeNetworkHostCluster account-config-api

Import a discovered host cluster from an imported cloud native network

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: ac-12345678

Account Config ID to operate on

region
required
string
Example: us-east-1

The deployment region where the host cluster resides

cloudNativeNetworkId
required
string
Example: vpc-0abc123def456

The cloud provider network ID (e.g. AWS VPC ID) that contains the host cluster to import

hostClusterName
required
string
Example: existing-eks-cluster

The cloud provider host cluster name to import from this cloud native network

Responses

Response samples

Content type
application/json
{
  • "created": true,
  • "hostClusterId": "Molestiae dolorum quaerat mollitia labore rerum quia."
}

ImportAccountConfigCloudNativeNetwork account-config-api

Import an available cloud native network for deployments (sets status to READY)

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: ac-12345678

Account Config ID to operate on

region
required
string
Example: us-east-1

The deployment region whose validated subnetworks should be imported

cloudNativeNetworkId
required
string
Example: /subscriptions/12345678-1234-1234-1234-123456789abc/resourceGroups/customer-rg/providers/Microsoft.Network/virtualNetworks/customer-vnet

The provider-native network ID (for example, AWS VPC ID, GCP VPC name, or Azure VNet resource ID) to import for deployments

Responses

Response samples

Content type
application/json
{
  • "cloudNativeNetworks": [
    ]
}

UnimportAccountConfigCloudNativeNetwork account-config-api

Unimport a cloud native network, reverting it from READY to AVAILABLE

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: ac-12345678

Account Config ID to operate on

region
required
string
Example: us-east-1

The deployment region whose cloud native network row should be unimported

cloudNativeNetworkId
required
string
Example: /subscriptions/12345678-1234-1234-1234-123456789abc/resourceGroups/customer-rg/providers/Microsoft.Network/virtualNetworks/customer-vnet

The provider-native network ID (for example, AWS VPC ID, GCP VPC name, or Azure VNet resource ID) to unimport. Rejected with HTTP 400 if the network is currently in use by a host cluster.

Responses

Response samples

Content type
application/json
{
  • "cloudNativeNetworks": [
    ]
}

BulkImportAccountConfigCloudNativeNetworks account-config-api

Bulk import or unimport CloudNativeNetworks for deployments

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: ac-12345678

Account Config ID to operate on

Request Body schema: application/json
required
required
Array of objects (AccountConfigCloudNativeNetworkOperation)

List of cloud native network operations to perform

Responses

Request samples

Content type
application/json
{
  • "cloudNativeNetworks": [
    ]
}

Response samples

Content type
application/json
{
  • "cloudNativeNetworks": [
    ]
}

SyncAccountConfigCloudNativeNetworks account-config-api

Sync CloudNativeNetworks from the provider's cloud account: discovers CloudNativeNetworks and upserts them into the database

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: ac-12345678

Account Config ID to operate on

Request Body schema: application/json
required
Array of objects (SyncAccountConfigCloudNativeNetworkTarget)

Optional list of (region, cloudNativeNetworkId) targets to sync. Each target is {region (required), cloudNativeNetworkId (optional)}: with the network ID set, only that network is re-validated; with the network ID omitted, every supported network in the region is enumerated. If the entire list is empty, the sync sweeps every region the account is enabled in (derived from the service plan).

Responses

Request samples

Content type
application/json
{
  • "cloudNativeNetworks": [
    ]
}

Response samples

Content type
application/json
{
  • "cloudNativeNetworks": [
    ]
}

DescribeAccountConfigByAWSAccountID account-config-api

Authorizations:
api_key_header_Authorization
path Parameters
awsAccountID
required
string
Example: 123456789012

The AWS account ID

Responses

Response samples

Content type
application/json
{}

DescribeAccountConfigByAzureSubscriptionID account-config-api

Authorizations:
api_key_header_Authorization
path Parameters
azureSubscriptionID
required
string
Example: 12345678-1234-1234-1234-123456789012

The Azure subscription ID

Responses

Response samples

Content type
application/json
{
  • "azureSubscriptionID": "12345678-1234-1234-1234-123456789012",
  • "azureTenantID": "12345678-1234-1234-1234-123456789012",
  • "byoaInstanceIDs": [
    ],
  • "cloudProviderId": "Expedita eum minima consequuntur et.",
  • "description": "An AWS account hosting multiple dev environments",
  • "id": "Saepe nesciunt et numquam.",
  • "name": "Dev AWS account",
  • "status": "PENDING|VERIFYING|READY|FAILED|DELETING|READY_TO_OFFBOARD",
  • "statusMessage": "Account is ready"
}

ListBYOAConfig account-config-api

Authorizations:
api_key_header_Authorization
Request Body schema: application/json
required
cloudProviderName
required
string

Cloud Provider name to filter on

Responses

Request samples

Content type
application/json
{
  • "cloudProviderName": "aws|azure|gcp|nebius|oci|byoc-onprem|all"
}

Response samples

Content type
application/json
{
  • "accountConfigs": [
    ],
  • "ids": [
    ],
  • "nextPageToken": "next-token"
}

ListAccountConfig account-config-api

Authorizations:
api_key_header_Authorization
path Parameters
cloudProviderName
required
string
Example: aws

Cloud Provider name to filter on

Responses

Response samples

Content type
application/json
{
  • "accountConfigs": [
    ],
  • "ids": [
    ],
  • "nextPageToken": "next-token"
}

DescribeAccountConfigByGCPProjectID account-config-api

Authorizations:
api_key_header_Authorization
path Parameters
gcpProjectID
required
string
Example: my-project

The GCP project ID

Responses

Response samples

Content type
application/json
{
  • "byoaInstanceIDs": [
    ],
  • "cloudProviderId": "Itaque omnis veniam.",
  • "description": "An AWS account hosting multiple dev environments",
  • "gcpProjectID": "my-project",
  • "gcpProjectNumber": "123456789012",
  • "gcpServiceAccountEmail": "bootstrap@my-project.iam.gserviceaccount.com",
  • "id": "Ut voluptas debitis nisi rem.",
  • "name": "Dev AWS account",
  • "status": "PENDING|VERIFYING|READY|FAILED|DELETING|READY_TO_OFFBOARD",
  • "statusMessage": "Account is ready"
}

AccountConfigIdentityID account-config-api

Returns the identity id of the account config to be used in the trust policy of the account

Authorizations:
api_key_header_Authorization

Responses

Response samples

Content type
application/json
{
  • "id": "Commodi iusto molestiae officia."
}

DescribeAccountConfigByNebiusTenantID account-config-api

Authorizations:
api_key_header_Authorization
path Parameters
nebiusTenantID
required
string
Example: tenant-id

The Nebius tenant ID

Responses

Response samples

Content type
application/json
{
  • "byoaInstanceIDs": [
    ],
  • "cloudProviderId": "Excepturi qui ipsum laboriosam.",
  • "description": "A Nebius tenant account hosting multiple regional project bindings",
  • "id": "Qui in quas.",
  • "name": "Prod Nebius tenant account",
  • "nebiusBindings": [
    ],
  • "nebiusTenantID": "tenant-e00abc123",
  • "status": "PENDING|VERIFYING|READY|FAILED|DELETING|READY_TO_OFFBOARD",
  • "statusMessage": "Account is ready"
}

DescribeAccountConfigByOCITenancyID account-config-api

Authorizations:
api_key_header_Authorization
path Parameters
ociTenancyID
required
string
Example: ocid1.tenancy.oc1..aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa

The Tenancy OCID for Oracle Cloud Infrastructure

Responses

Response samples

Content type
application/json
{
  • "byoaInstanceIDs": [
    ],
  • "cloudProviderId": "Deserunt aut aperiam exercitationem amet assumenda voluptate.",
  • "description": "An OCI account hosting multiple dev environments",
  • "id": "Non impedit.",
  • "name": "Dev OCI account",
  • "ociDomainID": "ocid1.domain.oc1..aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  • "ociTenancyID": "ocid1.tenancy.oc1..aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  • "status": "PENDING|VERIFYING|READY|FAILED|DELETING|READY_TO_OFFBOARD",
  • "statusMessage": "Account is ready"
}

VerifyAccountConfig account-config-api

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: ac-12345678

Account Config ID to operate on

Responses

custom-domain-api

The Custom Domain API manages the delegated domain names for the Service Provider

ListCustomDomain custom-domain-api

Authorizations:
api_key_header_Authorization

Responses

Response samples

Content type
application/json
{
  • "CustomDomains": [
    ],
  • "ids": [
    ],
  • "nextPageToken": "next-token"
}

CreateCustomDomain custom-domain-api

Authorizations:
api_key_header_Authorization
Request Body schema: application/json
required
customDomain
required
string

The root domain of the domain to use as suffix

description
required
string

The description for the domain

name
required
string

The name of the custom domain

required
object (Route53Configuration)

Responses

Request samples

Content type
application/json
{
  • "customDomain": "mydomain.dev",
  • "description": "Description of the domain",
  • "name": "Dev domain",
  • "route53Configuration": {
    }
}

Response samples

Content type
application/json
"Accusantium doloribus."

DeleteCustomDomain custom-domain-api

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: cd-12345678

custom domain ID to operate on

Responses

DescribeCustomDomain custom-domain-api

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: cd-12345678

custom domain ID to operate on

Responses

Response samples

Content type
application/json
{
  • "customDomain": "mydomain.dev",
  • "description": "Description of the domain",
  • "id": "Necessitatibus qui illum sit.",
  • "name": "Dev domain",
  • "route53Configuration": {},
  • "status": "PENDING|VERIFYING|READY|FAILED",
  • "statusMessage": "Account is ready"
}

CustomDomainIdentityID custom-domain-api

Returns the identity id of the Custom Domain to be used in the trust policy of the account

Authorizations:
api_key_header_Authorization

Responses

Response samples

Content type
application/json
{
  • "id": "Quos voluptate nobis provident est."
}

VerifyCustomDomain custom-domain-api

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: cd-12345678

custom domain ID to operate on

Responses

limit-api

The limit API manages the limit for Omnistrate entities

ListLimit limit-api

Authorizations:
api_key_header_Authorization
Request Body schema: application/json
required
family
required
string

Limit family

Responses

Request samples

Content type
application/json
{
  • "family": "SERVICE"
}

Response samples

Content type
application/json
{
  • "keys": [
    ],
  • "nextPageToken": "next-token"
}

DeleteLimit limit-api

Authorizations:
api_key_header_Authorization
path Parameters
family
required
string
Example: COMPUTE_INFRA

Limit family

key
required
string
Example: MAX_VIRTUAL_CORES_PER_RESOURCE

Unique key to identify the limit

Responses

DescribeLimit limit-api

Authorizations:
api_key_header_Authorization
path Parameters
family
required
string
Example: COMPUTE_INFRA

Limit family

key
required
string
Example: MAX_VIRTUAL_CORES_PER_RESOURCE

Unique key to identify the limit

Responses

Response samples

Content type
application/json
{
  • "description": "A premium limit",
  • "family": "SERVICE",
  • "key": "MAX_VIRTUAL_CORES_PER_RESOURCE",
  • "modifiable": true,
  • "name": "Premium Tier",
  • "value": 4
}

UpdateLimit limit-api

Authorizations:
api_key_header_Authorization
path Parameters
family
required
string
Example: COMPUTE_INFRA

Limit family

key
required
string
Example: MAX_VIRTUAL_CORES_PER_RESOURCE

Unique key to identify the limit

Request Body schema: application/json
required
description
string

A brief description of the limit

name
string

Name of the limit

value
required
integer <int64>

Value of the limit being enforced

Responses

Request samples

Content type
application/json
{
  • "description": "A premium limit",
  • "name": "Premium Tier",
  • "value": 4
}

image-registry-api

The image registry API manages the image registry for Omnistrate resources

ListImageRegistry image-registry-api

Authorizations:
api_key_header_Authorization

Responses

Response samples

Content type
application/json
{
  • "ids": [
    ],
  • "nextPageToken": "next-token"
}

CreateImageRegistry image-registry-api

Authorizations:
api_key_header_Authorization
Request Body schema: application/json
required
description
required
string

A brief description of the Image Registry

host
required
string

The Image Registry host

name
required
string

Name of the Image Registry

password
string

The password to use when authenticating to the Image Registry

username
string

The username to use when authenticating to the Image Registry

Responses

Request samples

Content type
application/json
{
  • "description": "DockerHub is a public Docker Image Registry",
  • "host": "docker.io",
  • "name": "DockerHub",
  • "password": "mypassword",
  • "username": "myusername"
}

Response samples

Content type
application/json
"Dolor quos voluptate reprehenderit minima."

DeleteImageRegistry image-registry-api

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: ir-12345678

The ID of the Image Registry

Responses

DescribeImageRegistry image-registry-api

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: ir-12345678

The ID of the Image Registry

Responses

Response samples

Content type
application/json
{
  • "description": "DockerHub is a public Docker Image Registry",
  • "host": "docker.io",
  • "id": "Porro nisi quis ex autem.",
  • "name": "DockerHub",
  • "password": "mypassword",
  • "username": "myusername"
}

UpdateImageRegistry image-registry-api

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: ir-12345678

The ID of the Image Registry

Request Body schema: application/json
required
description
string

A brief description of the Image Registry

host
string

The Image Registry host

name
string

Name of the Image Registry

password
string

The password to use when authenticating to the Image Registry

username
string

The username to use when authenticating to the Image Registry

Responses

Request samples

Content type
application/json
{
  • "description": "DockerHub is a public Docker Image Registry",
  • "host": "docker.io",
  • "name": "DockerHub",
  • "password": "mypassword",
  • "username": "myusername"
}

service-offering-api

The service offering API provides a public API to list all public services

ListServiceOffering service-offering-api

Authorizations:
api_key_header_Authorization
query Parameters
orgId
string
Example: orgId=org-12345678

Org Id

visibility
string
Example: visibility=PRIVATE

The visibility of service offering

environmentType
string
Example: environmentType=DEV

The environment type to filter by

Responses

Response samples

Content type
application/json
{}

DescribeServiceOffering service-offering-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID

query Parameters
visibility
string
Example: visibility=PRIVATE

The visibility of service offering

environmentType
string
Example: environmentType=DEV

The environment type to filter by

Responses

Response samples

Content type
application/json
{}

DescribeServiceOfferingResource service-offering-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceId
required
string
Example: s-12345678

The service ID

resourceId
required
string
Example: r-12345678

The resource ID

instanceId
required
string
Default: "none"
Example: instance-12345678

The instance ID

query Parameters
productTierId
string
Example: productTierId=pt-12345678

The product tier Id

productTierVersion
string
Example: productTierVersion=1.0.0

The product tier version

Responses

Response samples

Content type
application/json
{
  • "apis": [
    ]
}

audit-events-api

The set of APIs for auditing instance events for consumption side users.

ListAuditEventsForInstance audit-events-api

Authorizations:
api_key_header_Authorization
path Parameters
instanceId
required
string
Example: instance-12345678

The ID of the resource instance

query Parameters
subscriptionId
string
Example: subscriptionId=sub-abcd1234

Subscription Id

Responses

Response samples

Content type
application/json
{
  • "events": [
    ],
  • "ids": [
    ],
  • "nextPageToken": "token"
}

DeprecatedListAuditEventsForInstance audit-events-api

Authorizations:
api_key_header_Authorization
path Parameters
instanceId
required
string
Example: instance-12345678

The ID of the resource instance

query Parameters
subscriptionId
string
Example: subscriptionId=sub-abcd1234

Subscription Id

Responses

Response samples

Content type
application/json
{
  • "events": [
    ],
  • "ids": [
    ],
  • "nextPageToken": "token"
}

ListAuditEventsForServicePlan audit-events-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceProviderId
required
string
Example: omnistrate

The service provider ID

serviceKey
required
string
Example: service-orchestration

The service name

serviceAPIVersion
required
string
Example: v1

The service API version

serviceEnvironmentKey
required
string
Example: dev

The service environment name

serviceModelKey
required
string
Example: hosted

The service model name

productTierKey
required
string
Example: premium

The product tier name

query Parameters
subscriptionId
string
Example: subscriptionId=sub-abcd1234

Subscription Id

Responses

Response samples

Content type
application/json
{
  • "events": [
    ],
  • "ids": [
    ],
  • "nextPageToken": "token"
}

DeprecatedListAuditEventsForServicePlan audit-events-api

Authorizations:
api_key_header_Authorization
path Parameters
serviceProviderId
required
string
Example: omnistrate

The service provider ID

serviceKey
required
string
Example: service-orchestration

The service name

serviceAPIVersion
required
string
Example: v1

The service API version

serviceEnvironmentKey
required
string
Example: dev

The service environment name

serviceModelKey
required
string
Example: hosted

The service model name

productTierKey
required
string
Example: premium

The product tier name

query Parameters
subscriptionId
string
Example: subscriptionId=sub-abcd1234

Subscription Id

Responses

Response samples

Content type
application/json
{
  • "events": [
    ],
  • "ids": [
    ],
  • "nextPageToken": "token"
}

ListAllAuditEvents audit-events-api

Authorizations:
api_key_header_Authorization
query Parameters
nextPageToken
string
Example: nextPageToken=token

The next token to use for pagination

pageSize
integer <int64>
Example: pageSize=10

The number of resources to return per page

serviceID
string
Example: serviceID=s-123456

The service ID to list events for

environmentType
string
Example: environmentType=PROD|PRIVATE|CANARY|STAGING|QA|DEV|GLOBAL

The type of service environment

eventSourceTypes
Array of strings
Example: eventSourceTypes=Quisquam officiis voluptatum et possimus.&eventSourceTypes=In dolorum perferendis velit et et.&eventSourceTypes=Repellendus et ea unde debitis ut.&eventSourceTypes=Placeat ut reprehenderit earum sequi perspiciatis sit.

The event types to filter by

instanceID
string
Example: instanceID=instance-12345678

The instance ID to list events for

startDate
string <date-time>
Example: startDate=2023-01-01T10:00:00Z

Start date of the events

endDate
string <date-time>
Example: endDate=2024-01-01T10:00:00Z

End date of the events

Responses

Response samples

Content type
application/json
{
  • "events": [
    ],
  • "ids": [
    ],
  • "nextPageToken": "token"
}

DescribeAuditEvent audit-events-api

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: event-12345678

The ID of the event

query Parameters
subscriptionId
string
Example: subscriptionId=sub-abcd1234

Subscription Id

Responses

Response samples

Content type
application/json
{
  • "authMethod": "API_KEY",
  • "billingProvider": "STRIPE",
  • "billingProviderId": "payer_acme_corp_2024",
  • "cloudProvider": "aws",
  • "cloudProviderAccountId": "account-12345678",
  • "environmentId": "se-123456",
  • "environmentType": "PROD|PRIVATE|CANARY|STAGING|QA|DEV|GLOBAL",
  • "eventSource": "Customer, Infra or Maintenance",
  • "id": "Ad dolor est eos voluptatum.",
  • "ipAddress": "203.0.113.42",
  • "message": "instance-abcd1234 created",
  • "orgId": "Adipisci quos nisi.",
  • "orgName": "Acme Corporation",
  • "planVersion": "v1.0",
  • "productTierId": "Iure autem voluptatibus debitis rerum eum error.",
  • "region": "us-east-1",
  • "resourceInstanceId": "instance-abcd1234",
  • "resourceName": "Galera",
  • "roleType": "root",
  • "serviceId": "s-123456",
  • "serviceName": "mysql",
  • "servicePlanName": "Basic Plan",
  • "sessionId": "ak-12345678",
  • "subscriptionId": "sub-abcd1234",
  • "time": "2023-01-10T00:00:00Z",
  • "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:146.0) Gecko/20100101 Firefox/146.0",
  • "userId": "Culpa rem aliquid.",
  • "userName": "John Doe",
  • "workflowFailures": [
    ]
}

DeprecatedDescribeAuditEvent audit-events-api

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: event-12345678

The ID of the event

query Parameters
subscriptionId
string
Example: subscriptionId=sub-abcd1234

Subscription Id

Responses

Response samples

Content type
application/json
{
  • "authMethod": "API_KEY",
  • "billingProvider": "STRIPE",
  • "billingProviderId": "payer_acme_corp_2024",
  • "cloudProvider": "aws",
  • "cloudProviderAccountId": "account-12345678",
  • "environmentId": "se-123456",
  • "environmentType": "PROD|PRIVATE|CANARY|STAGING|QA|DEV|GLOBAL",
  • "eventSource": "Customer, Infra or Maintenance",
  • "id": "Eum ea accusamus maxime eum fugit.",
  • "ipAddress": "203.0.113.42",
  • "message": "instance-abcd1234 created",
  • "orgId": "Consequatur sunt.",
  • "orgName": "Acme Corporation",
  • "planVersion": "v1.0",
  • "productTierId": "Eum et consequatur eos.",
  • "region": "us-east-1",
  • "resourceInstanceId": "instance-abcd1234",
  • "resourceName": "Galera",
  • "roleType": "root",
  • "serviceId": "s-123456",
  • "serviceName": "mysql",
  • "servicePlanName": "Basic Plan",
  • "sessionId": "ak-12345678",
  • "subscriptionId": "sub-abcd1234",
  • "time": "2023-01-10T00:00:00Z",
  • "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:146.0) Gecko/20100101 Firefox/146.0",
  • "userId": "Eligendi repellendus vel quas qui.",
  • "userName": "John Doe",
  • "workflowFailures": [
    ]
}

subscription-api

The subscription management API to manage subscription metadata

ListSubscriptions subscription-api

Authorizations:
api_key_header_Authorization
query Parameters
serviceId
string
Example: serviceId=service-12345678

Service Id

environmentType
string
Example: environmentType=DEV

The environment type to filter by

includeInactive
boolean
Example: includeInactive=false

Flag indicating whether to include inactive (suspended, cancelled, terminated) subscriptions

Responses

Response samples

Content type
application/json
{
  • "ids": [
    ],
  • "nextPageToken": "next-token",
  • "subscriptions": [
    ]
}

CreateSubscription subscription-api

Authorizations:
api_key_header_Authorization
Request Body schema: application/json
required
productTierId
required
string

The product tier ID

serviceId
required
string

The service ID

Responses

Request samples

Content type
application/json
{
  • "productTierId": "Rerum rem quas voluptates distinctio.",
  • "serviceId": "s-123456"
}

Response samples

Content type
application/json
"Ut et doloremque sed."

DeleteSubscription subscription-api

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: sub-12345678

The subscription ID

Responses

DescribeSubscription subscription-api

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: sub-12345678

The subscription ID

Responses

Response samples

Content type
application/json
{
  • "accountConfigIdentityId": "Temporibus sint ipsa aut labore.",
  • "allowCreatesWhenPaymentNotConfigured": true,
  • "allowedDeploymentLocations": [
    ],
  • "cloudProviderNames": [
    ],
  • "createdAt": "2019-01-01T00:00:00Z",
  • "defaultSubscription": true,
  • "id": "Tempore voluptate inventore repellendus.",
  • "maxNumberOfInstances": 10,
  • "paymentMethodConfigured": true,
  • "productTierId": "Magnam doloremque soluta ut quam.",
  • "productTierName": "Omnistrate Multi Tenancy",
  • "roleType": "root|editor|reader|service_editor|service_reader|admin|service_operator",
  • "rootUserId": "Ut consequatur itaque pariatur ab delectus.",
  • "rootUserName": "John Doe",
  • "rootUserOrgId": "Et amet qui.",
  • "rootUserOrgName": "Example Inc.",
  • "serviceId": "s-123456",
  • "serviceLogoURL": "Quo officiis.",
  • "serviceName": "MySQL multi-writer service",
  • "serviceOrgId": "Et at aliquid ea est natus.",
  • "serviceOrgName": "Omnistrate",
  • "status": "ACTIVE|SUSPENDED|TERMINATED|CANCELLED",
  • "subscriptionOwnerName": "John Doe"
}

subscription-request-api

The subscription request API for end customers to issue subscription requests

ListSubscriptionRequests subscription-request-api

Authorizations:
api_key_header_Authorization
query Parameters
status
string
Example: status=PENDING

The status of the subscription request to filter by

Responses

Response samples

Content type
application/json
{
  • "ids": [
    ],
  • "nextPageToken": "next-token",
  • "subscriptionRequests": [
    ]
}

CreateSubscriptionRequest subscription-request-api

Authorizations:
api_key_header_Authorization
Request Body schema: application/json
required
productTierId
required
string

The product tier ID

serviceId
required
string

The service ID

Responses

Request samples

Content type
application/json
{
  • "productTierId": "Provident rerum.",
  • "serviceId": "s-123456"
}

Response samples

Content type
application/json
"Et placeat aut."

CancelSubscriptionRequest subscription-request-api

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: subr-12345678

The subscription ID

Responses

DescribeSubscriptionRequest subscription-request-api

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: subr-12345678

The subscription ID

Responses

Response samples

Content type
application/json
{
  • "createdAt": "2019-01-01T00:00:00Z",
  • "id": "Laudantium rem voluptatibus quaerat consequuntur quam.",
  • "productTierId": "Hic autem molestiae.",
  • "productTierName": "Omnistrate Multi Tenancy",
  • "rootUserEmail": "abc@gmail.com",
  • "rootUserId": "Dolor maxime suscipit aliquid quia quia rem.",
  • "rootUserName": "John Doe",
  • "serviceId": "s-123456",
  • "serviceLogoURL": "Molestiae delectus vel debitis et.",
  • "serviceName": "MySQL multi-writer service",
  • "status": "PENDING|APPROVED|DENIED|CANCELLED",
  • "updatedAt": "2019-01-01T00:00:00Z",
  • "updatedByUserId": "Nobis omnis et fuga ducimus et.",
  • "updatedByUserName": "John Doe"
}

identity-provider-api

ListIdentityProviders identity-provider-api

Authorizations:
api_key_header_Authorization

Responses

Response samples

Content type
application/json
{
  • "identityProviders": [
    ]
}

CreateIdentityProvider identity-provider-api

Authorizations:
api_key_header_Authorization
Request Body schema: application/json
required
authorizationEndpoint
string

The authorization endpoint of the Identity Provider

clientId
required
string

The Client ID of the Identity Provider

clientSecret
required
string

The Client Secret of the Identity Provider

disabled
boolean

Whether the Identity Provider is disabled

emailIdentifiers
string

The email identifiers to use for the Identity Provider

environmentType
string

The type of environment to filter costs by

identityProviderName
required
string

The type of the Identity Provider

loginButtonIconUrl
string

The URL of the icon to use for the login button

loginButtonText
string

The text to use for the login button

name
string

The name of the Identity Provider

scopes
string

The scopes to request from the Identity Provider

tokenEndpoint
string

The token endpoint of the Identity Provider

userInfoEndpoint
string

The user info endpoint of the Identity Provider

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
"Consequatur eos."

RenderIdentityProviders identity-provider-api

Authorizations:
api_key_header_Authorization
query Parameters
environmentType
string
Example: environmentType=production

The environment type to render the identity provider for

redirectUrl
string
Example: redirectUrl=https://example.com/redirect

The URL to redirect to after successful authentication

loginHint
string
Example: loginHint=user@domain.com

Login hint to pre-fill the identity provider login form

Responses

Response samples

Content type
application/json
{
  • "identityProviders": [
    ]
}

ListIdentityProviderTypes identity-provider-api

Authorizations:
api_key_header_Authorization

Responses

Response samples

Content type
application/json
{
  • "identityProviderTypes": [
    ]
}

DeleteIdentityProvider identity-provider-api

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: idp-12345678

The Identity Provider ID

Responses

DescribeIdentityProvider identity-provider-api

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: idp-12345678

The Identity Provider ID

Responses

Response samples

Content type
application/json
{
  • "authorizationEndpoint": "https://accounts.google.com/o/oauth2/auth",
  • "clientId": "exampleclientid.apps.googleusercontent.com",
  • "clientSecret": "exampleclientsecret",
  • "disabled": false,
  • "emailIdentifiers": "company.com",
  • "environmentType": "production",
  • "id": "Sunt earum cupiditate itaque natus.",
  • "identityProviderName": "Google|GitHub|Microsoft Entra|Amazon Cognito|Okta|Auth0|Keycloak|OIDC",
  • "loginButtonIconUrl": "https://example.com/icon.png",
  • "loginButtonText": "Login with Google",
  • "name": "Google for my company",
  • "scopes": "openid email profile",
  • "status": "FAILED|CANCELLED|PENDING_DEPENDENCY|PENDING|RUNNING|DEPLOYING|UPLOADING|READY|SUCCESS|COMPLETE|DELETING|DELETED|UNKNOWN|DISCONNECTED|DISCONNECTING|CONNECTING|DEACTIVATED",
  • "tokenEndpoint": "https://oauth2.googleapis.com/token",
  • "userInfoEndpoint": "https://www.googleapis.com/oauth2/v3/userinfo"
}

UpdateIdentityProvider identity-provider-api

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: idp-12345678

The Identity Provider ID

Request Body schema: application/json
required
authorizationEndpoint
string

The authorization endpoint of the Identity Provider

clientId
string

The Client ID of the Identity Provider

clientSecret
string

The Client Secret of the Identity Provider

disabled
boolean

Whether the Identity Provider is disabled

emailIdentifiers
string

The email identifiers to use for the Identity Provider

environmentType
string

The type of environment for the Identity Provider

loginButtonIconUrl
string

The URL of the icon to use for the login button

loginButtonText
string

The text to use for the login button

name
string

The name of the Identity Provider

scopes
string

The scopes to request from the Identity Provider

tokenEndpoint
string

The token endpoint of the Identity Provider

userInfoEndpoint
string

The user info endpoint of the Identity Provider

Responses

Request samples

Content type
application/json
{}

VerifyIdentityProvider identity-provider-api

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: idp-12345678

The Identity Provider ID

Responses

Response samples

Content type
application/json
{
  • "clientId": "exampleclientid.apps.googleusercontent.com",
  • "clientSecret": "exampleclientsecret",
  • "id": "Unde quia eligendi ea vitae sapiente.",
  • "identityProviderName": "Google|GitHub|Microsoft Entra|Amazon Cognito|Okta|Auth0|Keycloak|OIDC",
  • "name": "Google for my company",
  • "status": "FAILED|CANCELLED|PENDING_DEPENDENCY|PENDING|RUNNING|DEPLOYING|UPLOADING|READY|SUCCESS|COMPLETE|DELETING|DELETED|UNKNOWN|DISCONNECTED|DISCONNECTING|CONNECTING|DEACTIVATED"
}

saas-portal-api

ListSaaSPortals saas-portal-api

Authorizations:
api_key_header_Authorization

Responses

Response samples

Content type
application/json
{
  • "saasPortals": [
    ]
}

ListSaaSPortalCustomDomains saas-portal-api

Authorizations:
api_key_header_Authorization

Responses

Response samples

Content type
application/json
{
  • "customDomains": [
    ]
}

CreateSaaSPortalCustomDomain saas-portal-api

Authorizations:
api_key_header_Authorization
Request Body schema: application/json
required
customDomain
required
string

The custom domain

description
required
string

The custom domain description

environmentType
required
string

The environment type for the custom domain

name
required
string

The custom domain name

Responses

Request samples

Content type
application/json
{
  • "customDomain": "mycustomdomain.com",
  • "description": "My custom domain description",
  • "environmentType": "PROD|PRIVATE|CANARY|STAGING|QA|DEV|GLOBAL",
  • "name": "MyCustomDomain"
}

DeleteSaaSPortalCustomDomain saas-portal-api

Authorizations:
api_key_header_Authorization
path Parameters
environmentType
required
string
Example: DEV

The environment type for the custom domain

Responses

UpdateSaaSPortalCustomDomain saas-portal-api

Authorizations:
api_key_header_Authorization
path Parameters
environmentType
required
string
Example: DEV

The environment type for the saas portal custom domain to update

Request Body schema: application/json
required
customDomain
string

The custom domain

description
string

The custom domain description

name
string

The custom domain name

Responses

Request samples

Content type
application/json
{
  • "customDomain": "mycustomdomain.com",
  • "description": "My custom domain description",
  • "name": "MyCustomDomain"
}

UpdateSaaSPortal saas-portal-api

Authorizations:
api_key_header_Authorization
path Parameters
environmentType
required
string
Example: DEV

The environment type for the saas portal custom domain to update

Request Body schema: application/json
required
apiKeyValue
string

The API key value for the SaaS portal

customDomain
string

The custom domain for the SaaS portal

disablePasswordLogin
boolean

Whether to disable password login for the SaaS portal

object (SaaSPortalEmailConfig)
googleAnalyticsTagID
string

The Google Analytics tag ID for the SaaS portal

object (SaaSPortalImageConfig)

Responses

Request samples

Content type
application/json
{
  • "apiKeyValue": "om_ABCDEFGHIJKLMNOPQRSTUVWXYZ234567",
  • "customDomain": "mycustomdomain.com",
  • "disablePasswordLogin": false,
  • "emailConfig": {
    },
  • "googleAnalyticsTagID": "G-123456789",
  • "imageConfig": {
    }
}

helm-package-api

ListHelmPackages helm-package-api

Authorizations:
api_key_header_Authorization
query Parameters
chartName
string
Example: chartName=my-chart

The chart name to filter by

Responses

Response samples

Content type
application/json
{
  • "helmPackages": [
    ]
}

SaveHelmPackage helm-package-api

Authorizations:
api_key_header_Authorization
Request Body schema: application/json
required
required
object (HelmPackage)

Responses

Request samples

Content type
application/json
{
  • "helmPackage": {
    }
}

DeleteHelmPackage helm-package-api

Authorizations:
api_key_header_Authorization
path Parameters
chartName
required
string
Example: my-chart

The chart name of the Helm package to delete

chartVersion
required
string
Example: 1.0.0

The chart version of the Helm package to delete

Responses

DescribeHelmPackage helm-package-api

Authorizations:
api_key_header_Authorization
path Parameters
chartName
required
string
Example: my-chart

The chart name of the Helm package to describe

chartVersion
required
string
Example: 1.0.0

The chart version of the Helm package to describe

Responses

Response samples

Content type
application/json
{
  • "chartName": "my-chart",
  • "chartRepoName": "my-repo",
  • "chartRepoUrl": "https://my-repo.com",
  • "chartValues": {
    },
  • "chartVersion": "1.0.0",
  • "layeredChartValues": [
    ],
  • "namespace": "default",
  • "password": "my-password",
  • "username": "my-user"
}

compose-gen-api

CheckIfContainerImageAccessible compose-gen-api

Authorizations:
api_key_header_Authorization
query Parameters
imageRegistry
required
string
Example: imageRegistry=docker.io

Registry where the image is stored

username
string
Example: username=username

Username to access the image registry

password
string
Example: password=password

Password to access the image registry

image
required
string
Example: image=library/mysql:5.7

Name of the image along with the tag. Include the repository name if the image is not from the official repository

Responses

Response samples

Content type
application/json
{
  • "errorMsg": "Voluptatem totam dolore.",
  • "imageAccessible": false
}

GenerateComposeSpecFromContainerImage compose-gen-api

Authorizations:
api_key_header_Authorization
Request Body schema: application/json
required
Array of objects (EnvironmentVariable)

Runtime environment variables needed to run the image

image
required
string

Name of the image along with the tag. Include the repository name if the image is not from the official repository

imageRegistry
required
string

Registry where the image is stored

password
string

Password to access the image registry

username
string

Username to access the image registry

Responses

Request samples

Content type
application/json
{
  • "environmentVariables": [
    ],
  • "image": "library/mysql:5.7",
  • "imageRegistry": "docker.io",
  • "password": "password",
  • "username": "username"
}

Response samples

Content type
application/json
{
  • "fileContent": "Incidunt velit ipsam aut porro non distinctio."
}

custom-network-api

ListCustomNetworks custom-network-api

Authorizations:
api_key_header_Authorization
query Parameters
cloudProviderName
string
Example: cloudProviderName=aws

The name of the cloud provider to filter custom networks by

cloudProviderRegion
string
Example: cloudProviderRegion=us-east-1

The region of the cloud provider to filter custom networks by

customNetworksOnly
boolean
Example: customNetworksOnly=false

Flag indicating whether to return only custom networks, or to include default and imported networks as well

subscriptionId
string
Example: subscriptionId=sub-12345678

List available custom networks for the given subscription ID

Responses

Response samples

Content type
application/json
{
  • "customNetworks": [
    ]
}

CreateCustomNetwork custom-network-api

Authorizations:
api_key_header_Authorization
Request Body schema: application/json
required
cidr
string <cidr>
Default: "10.0.0.0/16"

CIDR block for the network

cloudProviderName
required
string

The name of the cloud provider that the instance is running on.

cloudProviderRegion
required
string

The region of the cloud provider that the instance is running in.

name
string

User friendly network name to help distinguish networks with same CIDRs

object (NetworkFeaturesConfiguration)
orgId
string

The ID of the organization that owns the custom network

Responses

Request samples

Content type
application/json
{
  • "cidr": "10.0.0.0/16",
  • "cloudProviderName": "aws|azure|gcp|nebius|oci|byoc-onprem|all",
  • "cloudProviderRegion": "us-east-1",
  • "name": "Prod us-east-1",
  • "networkFeaturesConfiguration": {
    },
  • "orgId": "Non omnis."
}

Response samples

Content type
application/json
{
  • "cidr": "10.0.0.0/16",
  • "cloudProviderName": "aws|azure|gcp|nebius|oci|byoc-onprem|all",
  • "cloudProviderRegion": "us-east-1",
  • "created_at": "2023-01-10T00:00:00Z",
  • "id": "Eos dolores omnis vitae.",
  • "last_modified_at": "2023-01-20T00:00:00Z",
  • "name": "Prod us-east-1",
  • "networkDefinitionType": "Default|Custom|Imported",
  • "networkFeaturesConfiguration": {
    },
  • "networkInstances": [
    ],
  • "owningUserId": "Architecto asperiores facilis nobis.",
  • "owningUserName": "John Doe",
  • "status": "FAILED|CANCELLED|PENDING_DEPENDENCY|PENDING|RUNNING|DEPLOYING|UPLOADING|READY|SUCCESS|COMPLETE|DELETING|DELETED|UNKNOWN|DISCONNECTED|DISCONNECTING|CONNECTING|DEACTIVATED"
}

DeleteCustomNetwork custom-network-api

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: n-12345678

ID of a custom network

Responses

DescribeCustomNetwork custom-network-api

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: n-12345678

ID of a custom network

Responses

Response samples

Content type
application/json
{
  • "cidr": "10.0.0.0/16",
  • "cloudProviderName": "aws|azure|gcp|nebius|oci|byoc-onprem|all",
  • "cloudProviderRegion": "us-east-1",
  • "created_at": "2023-01-10T00:00:00Z",
  • "id": "Non libero rerum est.",
  • "last_modified_at": "2023-01-20T00:00:00Z",
  • "name": "Prod us-east-1",
  • "networkDefinitionType": "Default|Custom|Imported",
  • "networkFeaturesConfiguration": {
    },
  • "networkInstances": [
    ],
  • "owningUserId": "Ut earum numquam error quia impedit expedita.",
  • "owningUserName": "John Doe",
  • "status": "FAILED|CANCELLED|PENDING_DEPENDENCY|PENDING|RUNNING|DEPLOYING|UPLOADING|READY|SUCCESS|COMPLETE|DELETING|DELETED|UNKNOWN|DISCONNECTED|DISCONNECTING|CONNECTING|DEACTIVATED"
}

UpdateCustomNetwork custom-network-api

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: n-12345678

ID of a custom network

Request Body schema: application/json
required
name
string

User friendly network name to help distinguish networks with same CIDRs

Responses

Request samples

Content type
application/json
{
  • "name": "Dev us-east-1"
}

Response samples

Content type
application/json
{
  • "cidr": "10.0.0.0/16",
  • "cloudProviderName": "aws|azure|gcp|nebius|oci|byoc-onprem|all",
  • "cloudProviderRegion": "us-east-1",
  • "created_at": "2023-01-10T00:00:00Z",
  • "id": "Tempore dignissimos et.",
  • "last_modified_at": "2023-01-20T00:00:00Z",
  • "name": "Prod us-east-1",
  • "networkDefinitionType": "Default|Custom|Imported",
  • "networkFeaturesConfiguration": {
    },
  • "networkInstances": [
    ],
  • "owningUserId": "Et repudiandae inventore.",
  • "owningUserName": "John Doe",
  • "status": "FAILED|CANCELLED|PENDING_DEPENDENCY|PENDING|RUNNING|DEPLOYING|UPLOADING|READY|SUCCESS|COMPLETE|DELETING|DELETED|UNKNOWN|DISCONNECTED|DISCONNECTING|CONNECTING|DEACTIVATED"
}

stripe-connect-api

The API to manage stripe connected accounts

GetStripeAuthorizeUrl stripe-connect-api

Authorizations:
api_key_header_Authorization

Responses

CompleteOAuthConnection stripe-connect-api

Authorizations:
api_key_header_Authorization
Request Body schema: application/json
required
code
string

Authorization code from Stripe

state
string

Random string used on the authorize URL

Responses

Request samples

Content type
application/json
{
  • "code": "ac_12345678",
  • "state": "12345678"
}

Response samples

Content type
application/json
{
  • "stripeUserID": "acct_12345678"
}

tenant-billing-api

The API to manage tenant billing

GetTenantBillingStatus tenant-billing-api

Authorizations:
api_key_header_Authorization

Responses

Response samples

Content type
application/json
{}

DisableTenantBilling tenant-billing-api

Authorizations:
api_key_header_Authorization

Responses

DisableBillingProvider tenant-billing-api

Authorizations:
api_key_header_Authorization
path Parameters
billingProviderType
required
string
Example: STRIPE

The type of billing provider to enable

Responses

EnableTenantBilling tenant-billing-api

Authorizations:
api_key_header_Authorization

Responses

EnableBillingProvider tenant-billing-api

Authorizations:
api_key_header_Authorization
path Parameters
billingProviderType
required
string
Example: STRIPE

The type of billing provider to enable

Request Body schema: application/json
required
balanceDueLink
string

The URL to the balance due page

logoURL
string

The URL of the logo for the billing provider. Only present when the billing provider is BRING_YOUR_OWN

name
string

A custom name for the billing provider. Only present when the billing provider is BRING_YOUR_OWN

Responses

Request samples

Content type
application/json
{
  • "balanceDueLink": "https://billing.provider.com/balance-due. Only present when the billing provider is BRING_YOUR_OWN",
  • "logoURL": "https://example.com/logo.png",
  • "name": "Stripe"
}

secrets-api

The set of APIs to manage secrets for service providers.

DeleteSecret secrets-api

Authorizations:
api_key_header_Authorization
path Parameters
environmentType
required
string
Example: DEV

The environment type for the secret

name
required
string
Example: my-secret

Name of the secret

Responses

GetSecret secrets-api

Authorizations:
api_key_header_Authorization
path Parameters
environmentType
required
string
Example: DEV

The environment type for the secret

name
required
string
Example: my-secret

Name of the secret

Responses

Response samples

Content type
application/json
{
  • "environmentType": "PROD|PRIVATE|CANARY|STAGING|QA|DEV|GLOBAL",
  • "name": "my-secret",
  • "value": "super-secret-value"
}

SetSecret secrets-api

Authorizations:
api_key_header_Authorization
path Parameters
environmentType
required
string
Example: DEV

The environment type for the secret

name
required
string
Example: my-secret

Name of the secret

Request Body schema: application/json
required
value
required
string

The value of the secret

Responses

Request samples

Content type
application/json
{
  • "value": "super-secret-value"
}

ListSecrets secrets-api

Authorizations:
api_key_header_Authorization
path Parameters
environmentType
required
string
Example: DEV

The environment type for the secret

Responses

Response samples

Content type
application/json
{
  • "secrets": [
    ]
}

expression-evaluator-api

The API to evaluate expressions.

ExpressionEvaluator expression-evaluator-api

Authorizations:
api_key_header_Authorization
Request Body schema: application/json
required
deploymentCellID
string

Either this or the instanceID must be provided to evaluate the expression(s)

expression
string

Expression containing system and api parameter variable references

object

If provided, the expression field is ignored and all expressions in the map are evaluated. The map keys are preserved in the result.

instanceID
string

Either this or the deploymentCellID must be provided to evaluate the expression(s)

productTierID
string

Mandatory if the instanceID is not provided

resourceKey
required
string

The resource key to use for evaluating resource parameters

serviceID
required
string

The service ID to use for evaluating service parameters

Responses

Request samples

Content type
application/json
{
  • "deploymentCellID": "Rem distinctio voluptatum.",
  • "expression": "{{ $sys.network.externalClusterEndpoint }}",
  • "expressionMap": {
    },
  • "instanceID": "instance-12345678",
  • "productTierID": "Sed ut impedit aut deserunt.",
  • "resourceKey": "mysql",
  • "serviceID": "s-123456"
}

Response samples

Content type
application/json
{
  • "error": "failed to evaluate expression: ...",
  • "result": "my-cluster.example.com"
}

schema-api

The API to get the latest JSON schema for various extensions and spec types.

GetJSONSchema schema-api

query Parameters
type
required
string
Example: type=x-omnistrate-service-plan|x-omnistrate-integrations|x-omnistrate-mode-internal|x-omnistrate-proxy-type|x-omnistrate-actionhooks|x-omnistrate-api-params|x-omnistrate-capabilities|x-omnistrate-compute|x-omnistrate-job-config|x-omnistrate-storage|x-omnistrate-image-registry-attributes|x-omnistrate-load-balancer|compose|service-plan|deployment-cell-amenities|system-parameters|services-orchestration-create-dsl|service-orchestration-modify-dsl

The type of the schema to retrieve

Responses

Response samples

Content type
application/json
"Ipsum quis velit similique praesentium."

api-key-api

The set of APIs to manage org-bounded long-lived API keys.

ListAPIKeys api-key-api

Authorizations:
api_key_header_Authorization

Responses

Response samples

Content type
application/json
{
  • "apiKeys": [
    ]
}

CreateAPIKey api-key-api

Authorizations:
api_key_header_Authorization
Request Body schema: application/json
required
description
string

Optional free-text description. No character of the plaintext key is ever stored or returned beyond the prefix label.

expiresAt
string <date-time>

Optional ISO 8601 expiry. Omit for non-expiring keys.

name
required
string

Operator-facing display name for the key. Unique within the org; conflicts return 409.

roleType
required
string

Authority granted to the key. Must be assignable by the caller per the role priority cap. The 'root' role is never assignable to an API key.

Responses

Request samples

Content type
application/json
{
  • "description": "Used by the prod CI pipeline to call the deploy API.",
  • "expiresAt": "2027-01-01T00:00:00Z",
  • "name": "ci-pipeline-prod",
  • "roleType": "root|editor|reader|service_editor|service_reader|admin|service_operator"
}

Response samples

Content type
application/json
{
  • "id": "apikey-12345678",
  • "key": "om_ABCDEF1234567890ABCDEF1234567890ABCDEF1234567890ABCDEF12",
  • "metadata": {
    }
}

DeleteAPIKey api-key-api

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: apikey-12345678

The API key ID.

Responses

DescribeAPIKey api-key-api

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: apikey-12345678

The API key ID.

Responses

Response samples

Content type
application/json
{
  • "metadata": {
    }
}

UpdateAPIKeyMetadata api-key-api

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: apikey-12345678

The API key ID.

Request Body schema: application/json
required
description
string

New description. Optional; nil leaves the field unchanged.

name
string

New display name. Optional; nil leaves the field unchanged. Re-validated for uniqueness within the org on change (409 on conflict).

Responses

Request samples

Content type
application/json
{
  • "description": "Used by the prod CI pipeline; rotated 2026-04.",
  • "name": "ci-pipeline-prod-renamed"
}

Response samples

Content type
application/json
{
  • "metadata": {
    }
}

RevokeAPIKey api-key-api

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string
Example: apikey-12345678

The API key ID.

Responses

Response samples

Content type
application/json
{
  • "metadata": {
    }
}

consumption-payment-method-api

Payment method management for end customers (SP-tier billing via Stripe Connect)

GetConsumptionStripeConfig consumption-payment-method-api

Get Stripe publishable key and connected account ID for mounting Elements

Authorizations:
api_key_header_Authorization

Responses

Response samples

Content type
application/json
{
  • "publishableKey": "pk_test_51...",
  • "stripeAccountId": "acct_1M2JTkLkdIwHu7ix"
}

ListConsumptionPaymentMethods consumption-payment-method-api

List all payment methods for the end customer

Authorizations:
api_key_header_Authorization

Responses

Response samples

Content type
application/json
{
  • "paymentMethods": [
    ]
}

RemoveConsumptionPaymentMethod consumption-payment-method-api

Remove a payment method from the connected account. Blocked if unpaid invoices exist.

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string^pm_[a-zA-Z0-9]+$
Example: pm_1NVChw2eZvKYlo2CwkOranTh

Payment method ID to remove

Responses

SetDefaultConsumptionPaymentMethod consumption-payment-method-api

Set a payment method as default on the connected account

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string^pm_[a-zA-Z0-9]+$
Example: pm_1NVChw2eZvKYlo2CwkOranTh

Payment method ID to set as default

Responses

CreateConsumptionSetupIntent consumption-payment-method-api

Create a Stripe SetupIntent for adding a new payment method via the connected account

Authorizations:
api_key_header_Authorization

Responses

Response samples

Content type
application/json
{
  • "clientSecret": "seti_1NVChw2eZvKYlo2C_secret_..."
}

managed-release-api

Internal API for publishing complete managed artifact release revisions.

ListManagedReleaseRevisions managed-release-api

Authorizations:
api_key_header_Authorization
query Parameters
status
string
Enum: "PENDING" "IN_PROGRESS" "READY" "AVAILABLE" "FAILED" "CANCELLED" "SKIPPED" "DEPRECATED" "REVOKED"
Example: status=AVAILABLE

Lifecycle status for a managed release revision or provisioner-target sync.

releaseComponent
string
Enum: "managed-manifest" "bootstrap-service" "service-orchestration"
Example: releaseComponent=bootstrap-service

Component pipeline that owns a managed artifact subset.

limit
integer <int64> [ 1 .. 100 ]
Default: 20
Example: limit=47
includeArtifacts
boolean
Default: false
Example: includeArtifacts=true

Responses

Response samples

Content type
application/json
{
  • "revisions": [
    ]
}

DescribeManagedReleaseRevision managed-release-api

Authorizations:
api_key_header_Authorization
path Parameters
bundleVersion
required
string^r[0-9]{7,}$
Example: r0000020
query Parameters
includeArtifacts
boolean
Default: true
Example: includeArtifacts=true

Responses

Response samples

Content type
application/json
{
  • "artifactCount": 1772075955271498000,
  • "artifacts": [
    ],
  • "bundleRevisionId": "oabr-3z",
  • "bundleVersion": "r0000020",
  • "componentRevisions": [
    ],
  • "contentHash": "sha256:a25B62aADAe8F29f413BD9ade809C48E24A5EF51A10cEa7E0fFCAf0Bc3Bc3CBd",
  • "createdAt": "2000-10-16T22:22:09Z",
  • "lastError": "Consequatur nobis consequatur.",
  • "lastTransitionTime": "1975-06-15T02:33:22Z",
  • "releaseComponent": "bootstrap-service",
  • "releaseSequence": 5638324923186775000,
  • "releasedAt": "1972-12-20T03:24:26Z",
  • "status": "AVAILABLE",
  • "updatedAt": "1981-09-20T15:58:59Z",
  • "workflowId": "gtl",
  • "workflowRunId": "g47"
}

PublishManagedRelease managed-release-api

Authorizations:
api_key_header_Authorization
Request Body schema: application/json
required
required
Array of objects (ManagedReleaseArtifact2) [ 1 .. 512 ] items
component
required
string
Enum: "managed-manifest" "bootstrap-service" "service-orchestration"
componentVersion
required
string [ 1 .. 256 ] characters
idempotencyKey
required
string [ 1 .. 512 ] characters
sourceCommit
required
string [ 7 .. 128 ] characters

Responses

Request samples

Content type
application/json
{
  • "artifacts": [
    ],
  • "component": "bootstrap-service",
  • "componentVersion": "j",
  • "idempotencyKey": "m",
  • "sourceCommit": "e8s"
}

Response samples

Content type
application/json
{
  • "bundleRevisionId": "oabr-s",
  • "bundleVersion": "r0000020",
  • "created": true,
  • "readyTargetCount": 733636892857335900,
  • "releaseSequence": 7017778706656903000,
  • "targetCount": 5059642064992159000
}

ListManagedReleaseSyncs managed-release-api

Authorizations:
api_key_header_Authorization
path Parameters
organizationId
required
string [ 1 .. 256 ] characters
Example: ke6
provisionerTargetId
required
string [ 1 .. 256 ] characters
Example: hp
query Parameters
status
string
Enum: "PENDING" "IN_PROGRESS" "READY" "AVAILABLE" "FAILED" "CANCELLED" "SKIPPED" "DEPRECATED" "REVOKED"
Example: status=AVAILABLE

Lifecycle status for a managed release revision or provisioner-target sync.

includeArtifactResults
boolean
Default: false
Example: includeArtifactResults=true

Responses

Response samples

Content type
application/json
{
  • "syncs": [
    ]
}

DescribeManagedReleaseSync managed-release-api

Authorizations:
api_key_header_Authorization
path Parameters
organizationId
required
string [ 1 .. 256 ] characters
Example: mcj
provisionerTargetId
required
string [ 1 .. 256 ] characters
Example: e4
bundleRevisionId
required
string^oabr-[a-zA-Z0-9-]+$
Example: oabr-8J
query Parameters
includeArtifactResults
boolean
Default: true
Example: includeArtifactResults=true

Responses

Response samples

Content type
application/json
{
  • "artifactResultCount": 2400267738857627600,
  • "artifactResults": [
    ],
  • "bundleRevisionId": "oabr-AP",
  • "bundleVersion": "r0000020",
  • "createdAt": "1985-06-05T14:40:16Z",
  • "destinationRegistry": "h7v",
  • "lastError": "Magni delectus veritatis.",
  • "lastTransitionTime": "1977-01-02T09:02:11Z",
  • "organizationId": "q",
  • "provisionerTargetId": "y",
  • "status": "AVAILABLE",
  • "syncId": "spabs-u",
  • "updatedAt": "1972-05-28T08:25:14Z",
  • "workflowId": "q0l",
  • "workflowRunId": "abv"
}

managed-artifact-api

Tenant-scoped managed artifact release history, Base Amenities release policy, and provisioner-target synchronization API. Published releases and target synchronization records are read-only.

DescribeManagedArtifactReleasePolicy managed-artifact-api

Return the managed artifact release policy for one Base Amenities environment and cloud provider. The authenticated organization is the authorization boundary.

Authorizations:
api_key_header_Authorization
path Parameters
environmentType
required
string
Example: PROD|PRIVATE|CANARY|STAGING|QA|DEV|GLOBAL

The type of service environment

cloudProvider
required
string
Example: aws|azure|gcp|nebius|oci|byoc-onprem|all

Name of the Infra Provider

Responses

Response samples

Content type
application/json
{
  • "autoUpgrade": false,
  • "cloudProvider": "aws",
  • "effectiveBundleVersion": "r0000020",
  • "environmentType": "PROD",
  • "preferredBundleVersion": "r0000020"
}

UpdateManagedArtifactReleasePolicy managed-artifact-api

Update automatic release adoption or the preferred managed artifact release for one Base Amenities environment and cloud provider. Enabling auto-upgrade clears the stored preference; disabling it without a version freezes the current effective release.

Authorizations:
api_key_header_Authorization
path Parameters
environmentType
required
string
Example: PROD|PRIVATE|CANARY|STAGING|QA|DEV|GLOBAL

The type of service environment

cloudProvider
required
string
Example: aws|azure|gcp|nebius|oci|byoc-onprem|all

Name of the Infra Provider

Request Body schema: application/json
required
autoUpgrade
required
boolean

Enable automatic adoption of the newest published release. When true, preferredBundleVersion must be omitted and any stored pin is cleared.

preferredBundleVersion
string^r[0-9]{7,}$

Published release to prefer while auto-upgrade is disabled. When disabling auto-upgrade, omission preserves an existing preferred release or pins the current effective release if no preference exists.

Responses

Request samples

Content type
application/json
{
  • "autoUpgrade": false,
  • "preferredBundleVersion": "r0000020"
}

Response samples

Content type
application/json
{
  • "autoUpgrade": false,
  • "cloudProvider": "aws",
  • "effectiveBundleVersion": "r0000020",
  • "environmentType": "PROD",
  • "preferredBundleVersion": "r0000020"
}

ListManagedArtifactReleases managed-artifact-api

List published managed artifact releases visible to the authenticated organization.

Authorizations:
api_key_header_Authorization
query Parameters
bundleVersion
string^r[0-9]{7,}$
Example: bundleVersion=r7272713
releasedAfter
string <date-time>
Example: releasedAfter=2010-08-26T21:14:01Z
releasedBefore
string <date-time>
Example: releasedBefore=2008-03-09T13:13:09Z
limit
integer <int64> [ 1 .. 100 ]
Default: 20
Example: limit=27
nextPageToken
string <= 4096 characters
Example: nextPageToken=glh

Opaque token returned by the previous list response.

Responses

Response samples

Content type
application/json
{
  • "nextPageToken": "Atque repellat in quaerat excepturi.",
  • "releases": [
    ]
}

DescribeManagedArtifactRelease managed-artifact-api

Return one published managed artifact release, including its tenant-visible artifacts.

Authorizations:
api_key_header_Authorization
path Parameters
bundleVersion
required
string^r[0-9]{7,}$
Example: r0000020

Responses

Response samples

Content type
application/json
{
  • "amenityCount": 15,
  • "artifactCount": 57,
  • "artifacts": [
    ],
  • "bundleVersion": "r0000020",
  • "createdAt": "1979-08-19T08:00:02Z",
  • "lastTransitionTime": "1997-08-16T10:46:42Z",
  • "releaseSequence": 6635099025426621000,
  • "releasedAt": "2008-03-17T16:06:00Z",
  • "targetStatus": {
    }
}

ListManagedArtifactSyncs managed-artifact-api

List private managed artifact syncs or public ECR publications for the authenticated organization.

Authorizations:
api_key_header_Authorization
query Parameters
registryType
string
Example: registryType=PRIVATE_ECR|PUBLIC_ECR

Registry kind to list; omitted selects PRIVATE_ECR for existing clients.

destinationAccountId
string^[0-9]{12}$
Example: destinationAccountId=265030318314

Optional destination AWS account filter for PRIVATE_ECR or PUBLIC_ECR; not an execution host-cluster ID. Combined with targetId, both filters must match.

bundleVersion
string^r[0-9]{7,}$
Example: bundleVersion=r6146499
status
string
Example: status=PENDING|IN_PROGRESS|READY|FAILED|SKIPPED

Lifecycle status for one private provisioner-target sync or public account publication. Known values are PENDING, IN_PROGRESS, READY, FAILED and SKIPPED. Clients must tolerate additional values; the service validates supported status filters.

targetId
string [ 1 .. 256 ] characters
Example: targetId=3
updatedAfter
string <date-time>
Example: updatedAfter=1983-10-14T04:14:18Z
updatedBefore
string <date-time>
Example: updatedBefore=1972-04-30T04:38:04Z
limit
integer <int64> [ 1 .. 100 ]
Default: 20
Example: limit=90
nextPageToken
string <= 4096 characters
Example: nextPageToken=e60

Opaque token returned by the previous list response.

Responses

Response samples

Content type
application/json
{
  • "nextPageToken": "Debitis explicabo dolor quia perferendis.",
  • "syncs": [
    ]
}

DescribeManagedArtifactSync managed-artifact-api

Return one managed artifact synchronization record, including per-artifact results.

Authorizations:
api_key_header_Authorization
path Parameters
id
required
string^(spabs|sppap)-[a-zA-Z0-9-]+$
Example: sppap-9

Responses

Response samples

Content type
application/json
{
  • "artifactCount": 4115339503071489000,
  • "artifacts": [
    ],
  • "bundleVersion": "r0000020",
  • "completedArtifactCount": 8520858888903790000,
  • "createdAt": "1982-04-27T22:26:16Z",
  • "destination": {
    },
  • "failedArtifactCount": 5459167404545064000,
  • "failureCategory": "ENDPOINT",
  • "failureMessage": "iwe",
  • "id": "sppap-KB",
  • "lastTransitionTime": "1972-12-31T16:58:34Z",
  • "registryType": "PRIVATE_ECR|PUBLIC_ECR",
  • "status": "PENDING|IN_PROGRESS|READY|FAILED|SKIPPED",
  • "target": {
    },
  • "updatedAt": "1977-07-09T09:41:45Z"
}