Edge Cloud Master Controller API Documentation (2.0)

Download OpenAPI specification:Download

License: Apache 2.0

The Master Controller (MC) serves as the central API gateway for users to orchestrate edge resources and provides several APIs to both application developers and operators. Application developers can manage and monitor deployment of edge applications. Operators can manage and monitor the usage of cloudlet infrastructures. Both developers and operators can manage users within their Organization.

Security

Authentication is done by a user name or email plus a password. The login function returns a JSON Web Token (JWT) once authenticated, that should be included with subsequent API calls to authenticate the user. The JWT will expire after a while for security, at which point you may need to log in again.

Login

Login using account credentials

Request Body schema: application/json
apikey
string

(deprecated) Use password field for ApiKey

apikeyid
string

(deprecated) Use username field for ApiKeyId

password
string

User's password

totp
string

Temporary one-time password if 2-factor authentication is enabled

username
string

User's name or email address

Responses

Request samples

Content type
application/json
{
  • "apikey": "string",
  • "apikeyid": "string",
  • "password": "string",
  • "totp": "string",
  • "username": "string"
}

Response samples

Content type
application/json
"string"

User

Users can be assigned roles for Organizations, allowing them to view or manage resources associated with the Organizations.

UserAuthorized

Check if user is authorized

Authorizations:
bearerAuth
Request Body schema: application/json
action
string

Action defines what type of action can be performed on a resource

object
string

Optional object to act upon if auth claims has restriction

org
string

Organization name

resource
string

Resource defines a resource to act upon

Responses

Request samples

Content type
application/json
{
  • "action": "string",
  • "object": "string",
  • "org": "string",
  • "resource": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

CreateUserApiKey

Create an API key for reduced access, typically for automation

Authorizations:
bearerAuth
Request Body schema: application/json
ApiKey
string

API key

Description
string

Description of the purpose of this API key

Org
string

Org to which API key has permissions to access its objects

Array of objects or null (OrmapiRolePerm)

List of API key permissions

Responses

Request samples

Content type
application/json
{
  • "ApiKey": "string",
  • "Description": "string",
  • "Org": "string",
  • "permissions": [
    ]
}

Response samples

Content type
application/json
{
  • "ApiKey": "string",
  • "CreatedAt": "2019-08-24T14:15:22Z",
  • "Description": "string",
  • "Id": "string",
  • "Org": "string",
  • "permissions": [
    ]
}

CurrentUser

Show the currently logged in user

Authorizations:
bearerAuth

Responses

Response samples

Content type
application/json
{
  • "CreatedAt": "2019-08-24T14:15:22Z",
  • "Email": "string",
  • "EmailVerified": true,
  • "EnableTOTP": true,
  • "FailedLogins": 0,
  • "FamilyName": "string",
  • "GivenName": "string",
  • "LastFailedLogin": "2019-08-24T14:15:22Z",
  • "LastLogin": "2019-08-24T14:15:22Z",
  • "Locked": true,
  • "Metadata": "string",
  • "Name": "string",
  • "Nickname": "string",
  • "PassCrackTimeSec": 0,
  • "Picture": "string",
  • "UpdatedAt": "2019-08-24T14:15:22Z"
}

DeleteUser

Delete an existing user

Authorizations:
bearerAuth
Request Body schema: application/json
Email
string

User email

EnableTOTP
boolean

Enable or disable temporary one-time passwords for the account

FailedLogins
integer

Number of failed login attempts since last successful login

FamilyName
string

Family Name

GivenName
string

Given Name

Metadata
string

Metadata

Name
string

User name. Can only contain letters, digits, underscore, period, hyphen. It cannot have leading or trailing spaces or period. It cannot start with hyphen

Nickname
string

Nick Name

Picture
string

Picture (currently not used)

Responses

Request samples

Content type
application/json
{
  • "Email": "string",
  • "EnableTOTP": true,
  • "FailedLogins": 0,
  • "FamilyName": "string",
  • "GivenName": "string",
  • "Metadata": "string",
  • "Name": "string",
  • "Nickname": "string",
  • "Picture": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

DeleteUserApiKey

Delete an API key

Authorizations:
bearerAuth
Request Body schema: application/json
ApiKey
string

API key

Description
string

Description of the purpose of this API key

Org
string

Org to which API key has permissions to access its objects

Array of objects or null (OrmapiRolePerm)

List of API key permissions

Responses

Request samples

Content type
application/json
{
  • "ApiKey": "string",
  • "Description": "string",
  • "Org": "string",
  • "permissions": [
    ]
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

NewPassword

Set a new password while logged in, requires the existing password

Authorizations:
bearerAuth
Request Body schema: application/json
currentpassword
string

User's current password

password
string

User's new password

Responses

Request samples

Content type
application/json
{
  • "currentpassword": "string",
  • "password": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

AuthScopes

Show authorized permissions

Authorizations:
bearerAuth

Responses

Response samples

Content type
application/json
[
  • {
    }
]

ShowUser

Show users

Authorizations:
bearerAuth
Request Body schema: application/json
Email
string

User email

EnableTOTP
boolean

Enable or disable temporary one-time passwords for the account

FailedLogins
integer

Number of failed login attempts since last successful login

FamilyName
string

Family Name

GivenName
string

Given Name

Metadata
string

Metadata

Name
string

User name. Can only contain letters, digits, underscore, period, hyphen. It cannot have leading or trailing spaces or period. It cannot start with hyphen

Nickname
string

Nick Name

Picture
string

Picture (currently not used)

org
string

Organization name

role
string

Role name

Responses

Request samples

Content type
application/json
{
  • "Email": "string",
  • "EnableTOTP": true,
  • "FailedLogins": 0,
  • "FamilyName": "string",
  • "GivenName": "string",
  • "Metadata": "string",
  • "Name": "string",
  • "Nickname": "string",
  • "Picture": "string",
  • "org": "string",
  • "role": "string"
}

Response samples

Content type
application/json
[
  • {
    }
]

ShowUserApiKey

Show existing API keys

Authorizations:
bearerAuth
Request Body schema: application/json
ApiKey
string

API key

Description
string

Description of the purpose of this API key

Org
string

Org to which API key has permissions to access its objects

Array of objects or null (OrmapiRolePerm)

List of API key permissions

Responses

Request samples

Content type
application/json
{
  • "ApiKey": "string",
  • "Description": "string",
  • "Org": "string",
  • "permissions": [
    ]
}

Response samples

Content type
application/json
[
  • {
    }
]

UpdateUser

Update a user

Authorizations:
bearerAuth
Request Body schema: application/json
Email
string

User email

EnableTOTP
boolean

Enable or disable temporary one-time passwords for the account

FailedLogins
integer

Number of failed login attempts since last successful login

FamilyName
string

Family Name

GivenName
string

Given Name

Metadata
string

Metadata

Name
string

User name. Can only contain letters, digits, underscore, period, hyphen. It cannot have leading or trailing spaces or period. It cannot start with hyphen

Nickname
string

Nick Name

Picture
string

Picture (currently not used)

object (OrmapiEmailRequest)

Responses

Request samples

Content type
application/json
{
  • "Email": "string",
  • "EnableTOTP": true,
  • "FailedLogins": 0,
  • "FamilyName": "string",
  • "GivenName": "string",
  • "Metadata": "string",
  • "Name": "string",
  • "Nickname": "string",
  • "Picture": "string",
  • "verify": { }
}

Response samples

Content type
application/json
{
  • "Message": "string",
  • "TOTPQRImage": [
    ],
  • "TOTPSharedKey": "string"
}

PasswordReset

Reset the password using the token from the password reset email

Request Body schema: application/json
password
string

User's new password

token
string

Authentication token

Responses

Request samples

Content type
application/json
{
  • "password": "string",
  • "token": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

PasswordResetRequest

Request a password reset email to be sent to the user's email

Request Body schema: application/json

Responses

Request samples

Content type
application/json
{ }

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

ResendVerify

Request that the user verification email be resent

Request Body schema: application/json

Responses

Request samples

Content type
application/json
{ }

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

CreateUser

Create a new user

Request Body schema: application/json
Email
string

User email

EnableTOTP
boolean

Enable or disable temporary one-time passwords for the account

FailedLogins
integer

Number of failed login attempts since last successful login

FamilyName
string

Family Name

GivenName
string

Given Name

Metadata
string

Metadata

Name
string

User name. Can only contain letters, digits, underscore, period, hyphen. It cannot have leading or trailing spaces or period. It cannot start with hyphen

Nickname
string

Nick Name

Picture
string

Picture (currently not used)

object (OrmapiEmailRequest)

Responses

Request samples

Content type
application/json
{
  • "Email": "string",
  • "EnableTOTP": true,
  • "FailedLogins": 0,
  • "FamilyName": "string",
  • "GivenName": "string",
  • "Metadata": "string",
  • "Name": "string",
  • "Nickname": "string",
  • "Picture": "string",
  • "verify": { }
}

Response samples

Content type
application/json
{
  • "Message": "string",
  • "TOTPQRImage": [
    ],
  • "TOTPSharedKey": "string"
}

DeleteLockedUser

Delete a locked user by supplying the password

Request Body schema: application/json
Email
string

User email

EnableTOTP
boolean

Enable or disable temporary one-time passwords for the account

FailedLogins
integer

Number of failed login attempts since last successful login

FamilyName
string

Family Name

GivenName
string

Given Name

Metadata
string

Metadata

Name
string

User name. Can only contain letters, digits, underscore, period, hyphen. It cannot have leading or trailing spaces or period. It cannot start with hyphen

Nickname
string

Nick Name

Picture
string

Picture (currently not used)

Responses

Request samples

Content type
application/json
{
  • "Email": "string",
  • "EnableTOTP": true,
  • "FailedLogins": 0,
  • "FamilyName": "string",
  • "GivenName": "string",
  • "Metadata": "string",
  • "Name": "string",
  • "Nickname": "string",
  • "Picture": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

VerifyEmail

Verify a user's email account from the token in the email

Request Body schema: application/json
token
string

Authentication token

Responses

Request samples

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

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

Role

Roles can be assigned to users for Organizations, allowing the users to view or manage resources associated with the Organizations.

AddUserRole

Add a role for the organization to the user

Authorizations:
bearerAuth
Request Body schema: application/json
org
string

Organization name

role
string

Role which defines the set of permissions

username
string

User name

Responses

Request samples

Content type
application/json
{
  • "org": "string",
  • "role": "string",
  • "username": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

ShowRoleAssignment

Show roles for the current user

Authorizations:
bearerAuth
Request Body schema: application/json
org
string

Organization name

role
string

Role which defines the set of permissions

username
string

User name

Responses

Request samples

Content type
application/json
{
  • "org": "string",
  • "role": "string",
  • "username": "string"
}

Response samples

Content type
application/json
[
  • {
    }
]

ShowRolePerm

Show permissions associated with each role

Authorizations:
bearerAuth
Request Body schema: application/json
action
string

Action defines what type of action can be performed on a resource

resource
string

Resource defines a resource to act upon

role
string

Role defines a collection of permissions, which are resource-action pairs

Responses

Request samples

Content type
application/json
{
  • "action": "string",
  • "resource": "string",
  • "role": "string"
}

Response samples

Content type
application/json
[
  • {
    }
]

RemoveUserRole

Remove the role for the organization from the user

Authorizations:
bearerAuth
Request Body schema: application/json
org
string

Organization name

role
string

Role which defines the set of permissions

username
string

User name

Responses

Request samples

Content type
application/json
{
  • "org": "string",
  • "role": "string",
  • "username": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

ShowRoleNames

Show role names

Authorizations:
bearerAuth

Responses

Response samples

Content type
application/json
[
  • "string"
]

ShowUserRole

Show roles for the organizations the current user can add or remove roles to

Authorizations:
bearerAuth
Request Body schema: application/json
org
string

Organization name

role
string

Role which defines the set of permissions

username
string

User name

Responses

Request samples

Content type
application/json
{
  • "org": "string",
  • "role": "string",
  • "username": "string"
}

Response samples

Content type
application/json
[
  • {
    }
]

Org

CreateOrg

Create a new developer or operator organization

Authorizations:
bearerAuth
Request Body schema: application/json
Address
string

Organization address

Name
string

Organization name. Can only contain letters, digits, underscore, period, hyphen. It cannot have leading or trailing spaces or period. It cannot start with hyphen

Phone
string

Organization phone number

Type
string

Organization type: "developer" or "operator"

Responses

Request samples

Content type
application/json
{
  • "Address": "string",
  • "Name": "string",
  • "Phone": "string",
  • "Type": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

DeleteOrg

Delete an organization

Authorizations:
bearerAuth
Request Body schema: application/json
Address
string

Organization address

Name
string

Organization name. Can only contain letters, digits, underscore, period, hyphen. It cannot have leading or trailing spaces or period. It cannot start with hyphen

Phone
string

Organization phone number

Type
string

Organization type: "developer" or "operator"

Responses

Request samples

Content type
application/json
{
  • "Address": "string",
  • "Name": "string",
  • "Phone": "string",
  • "Type": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

ShowOrg

Show organizations

Authorizations:
bearerAuth
Request Body schema: application/json
Address
string

Organization address

Name
string

Organization name. Can only contain letters, digits, underscore, period, hyphen. It cannot have leading or trailing spaces or period. It cannot start with hyphen

Phone
string

Organization phone number

Type
string

Organization type: "developer" or "operator"

Responses

Request samples

Content type
application/json
{
  • "Address": "string",
  • "Name": "string",
  • "Phone": "string",
  • "Type": "string"
}

Response samples

Content type
application/json
[
  • {
    }
]

UpdateOrg

Update an organization

Authorizations:
bearerAuth
Request Body schema: application/json
Address
string

Organization address

Name
string

Organization name. Can only contain letters, digits, underscore, period, hyphen. It cannot have leading or trailing spaces or period. It cannot start with hyphen

Phone
string

Organization phone number

Type
string

Organization type: "developer" or "operator"

Responses

Request samples

Content type
application/json
{
  • "Address": "string",
  • "Name": "string",
  • "Phone": "string",
  • "Type": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

Cloudlet

Cloudlet is a set of compute resources at a particular location, provided by an Operator.

AddCloudletAllianceOrg

Add alliance organization to the cloudlet

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoCloudletAllianceOrg)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "CloudletAllianceOrg": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

AddCloudletResMapping

Add Optional Resource tag table

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoCloudletResMap)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "CloudletResMap": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

CreateCloudlet

Create Cloudlet. Sets up Cloudlet services on the Operators compute resources, and integrated as part of EdgeCloud edge resource portfolio. These resources are managed from the Edge Controller.

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoCloudlet)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "Cloudlet": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

DeleteCloudlet

Delete Cloudlet. Removes the Cloudlet services where they are no longer managed from the Edge Controller.

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoCloudlet)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "Cloudlet": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

FindFlavorMatch

Discover if flavor produces a matching platform flavor

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoFlavorMatch)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "FlavorMatch": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "availability_zone": "string",
  • "flavor_name": "string",
  • "key": {
    }
}

GenerateAccessKey

Generate new crm access key

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoCloudletKey)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "CloudletKey": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

GetCloudletGPUDriverLicenseConfig

Get Cloudlet Specific GPU Driver License Config. Returns the license config associated with the cloudlet

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoCloudletKey)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "CloudletKey": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

GetCloudletManifest

Get Cloudlet Manifest. Shows deployment manifest required to setup cloudlet

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoCloudletKey)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "CloudletKey": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "manifest": "string"
}

GetCloudletProps

Get Cloudlet Properties. Shows all the infra properties used to setup cloudlet

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoCloudletProps)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "CloudletProps": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "organization": "string",
  • "platform_type": "string",
  • "properties": {
    }
}

GetCloudletResourceQuotaProps

Get Cloudlet Resource Quota Properties. Shows all the resource quota properties of the cloudlet

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoCloudletResourceQuotaProps)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "CloudletResourceQuotaProps": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "organization": "string",
  • "platform_type": "string",
  • "properties": [
    ]
}

GetCloudletResourceUsage

Get Cloudlet resource information. Shows cloudlet resources used and their limits

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoCloudletResourceUsage)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "CloudletResourceUsage": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "info": [
    ],
  • "infra_usage": true,
  • "key": {
    }
}

GetOrganizationsOnCloudlet

Get organizations of ClusterInsts and AppInsts on cloudlet

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoCloudletKey)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "CloudletKey": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "name": "string"
}

RemoveCloudletAllianceOrg

Remove alliance organization from the cloudlet

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoCloudletAllianceOrg)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "CloudletAllianceOrg": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

RemoveCloudletResMapping

Remove Optional Resource tag table

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoCloudletResMap)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "CloudletResMap": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

RevokeAccessKey

Revoke crm access key

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoCloudletKey)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "CloudletKey": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

ShowCloudlet

Show Cloudlets. Lists all the cloudlets managed from Edge Controller.

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoCloudlet)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "Cloudlet": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "HostController": "string",
  • "access_vars": {
    },
  • "alliance_orgs": [
    ],
  • "chef_client_key": {
    },
  • "config": {
    },
  • "container_version": "string",
  • "created_at": "string",
  • "crm_access_key_upgrade_required": true,
  • "crm_access_public_key": "string",
  • "crm_override": "string",
  • "default_resource_alert_threshold": 0,
  • "delete_prepare": true,
  • "deployment": "string",
  • "deployment_local": true,
  • "dns_label": "string",
  • "enable_default_serverless_cluster": true,
  • "env_var": {
    },
  • "errors": [
    ],
  • "federation_config": {
    },
  • "fields": [
    ],
  • "flavor": {
    },
  • "gpu_config": {
    },
  • "infra_api_access": "string",
  • "infra_config": {
    },
  • "infra_flavors": [
    ],
  • "ip_support": "string",
  • "kafka_cluster": "string",
  • "kafka_password": "string",
  • "kafka_user": "string",
  • "key": {
    },
  • "license_config_storage_path": "string",
  • "location": {
    },
  • "maintenance_state": 0,
  • "notify_srv_addr": "string",
  • "num_dynamic_ips": 0,
  • "override_policy_container_version": true,
  • "physical_name": "string",
  • "platform_high_availability": true,
  • "platform_type": "string",
  • "res_tag_map": {
    },
  • "resource_quotas": [
    ],
  • "root_lb_fqdn": "string",
  • "secondary_crm_access_key_upgrade_required": true,
  • "secondary_crm_access_public_key": "string",
  • "secondary_notify_srv_addr": "string",
  • "single_kubernetes_cluster_owner": "string",
  • "state": "string",
  • "static_ips": "string",
  • "time_limits": {
    },
  • "trust_policy": "string",
  • "trust_policy_state": "string",
  • "updated_at": "string",
  • "vm_image_version": "string",
  • "vm_pool": "string"
}

ShowCloudletPlatformFeatures

Show Cloudlet Platform Features. Shows platform specific features

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoPlatformFeatures)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "PlatformFeatures": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "cloudlet_services_local": true,
  • "ip_allocated_per_service": true,
  • "is_fake": true,
  • "is_prebuilt_kubernetes_cluster": true,
  • "is_single_kubernetes_cluster": true,
  • "is_vm_pool": true,
  • "kubernetes_requires_worker_nodes": true,
  • "no_kubernetes_cluster_auto_scale": true,
  • "platform_type": "string",
  • "supports_additional_networks": true,
  • "supports_app_inst_dedicated_ip": true,
  • "supports_image_type_ova": true,
  • "supports_image_type_ovf": true,
  • "supports_kubernetes_only": true,
  • "supports_multi_tenant_cluster": true,
  • "supports_platform_high_availability_on_docker": true,
  • "supports_platform_high_availability_on_k8s": true,
  • "supports_shared_volume": true,
  • "supports_trust_policy": true
}

ShowFlavorsForCloudlet

Find all meta flavors viable on cloudlet

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoCloudletKey)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "CloudletKey": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "name": "string"
}

UpdateCloudlet

Update Cloudlet. Updates the Cloudlet configuration and manages the upgrade of Cloudlet services.

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoCloudlet)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "Cloudlet": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

OperatorCode

OperatorCode maps a carrier code to an Operator organization name.

CreateOperatorCode

Create Operator Code. Create a code for an Operator.

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoOperatorCode)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "OperatorCode": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

DeleteOperatorCode

Delete Operator Code. Delete a code for an Operator.

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoOperatorCode)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "OperatorCode": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

ShowOperatorCode

Show Operator Code. Show Codes for an Operator.

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoOperatorCode)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "OperatorCode": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "code": "string",
  • "organization": "string"
}

Flavor

Flavors define the compute, memory and storage capacity of computing instances. To put it simply, a flavor is an available hardware configuration for a server. It defines the size of a virtual server that can be launched.

AddFlavorRes

Add Optional Resource

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoFlavor)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "Flavor": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

CreateFlavor

Create a Flavor

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoFlavor)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "Flavor": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

DeleteFlavor

Delete a Flavor

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoFlavor)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "Flavor": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

RemoveFlavorRes

Remove Optional Resource

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoFlavor)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "Flavor": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

ShowFlavor

Show Flavors

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoFlavor)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "Flavor": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "delete_prepare": true,
  • "disk": 0,
  • "key": {
    },
  • "opt_res_map": {
    },
  • "ram": 0,
  • "vcpus": 0
}

UpdateFlavor

Update a Flavor

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoFlavor)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "Flavor": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

CloudletProps

Infra properties used to setup cloudlet.

CloudletResMap

Cloudlet resouce mapping.

FlavorMatch

To match a flavor with platform flavor.

CloudletPool

CloudletPool defines a pool of Cloudlets that have restricted access.

AddCloudletPoolMember

Add a Cloudlet to a CloudletPool

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoCloudletPoolMember)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "CloudletPoolMember": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

CreateCloudletPool

Create a CloudletPool

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoCloudletPool)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "CloudletPool": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

DeleteCloudletPool

Delete a CloudletPool

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoCloudletPool)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "CloudletPool": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

RemoveCloudletPoolMember

Remove a Cloudlet from a CloudletPool

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoCloudletPoolMember)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "CloudletPoolMember": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

ShowCloudletPool

Show CloudletPools

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoCloudletPool)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "CloudletPool": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "cloudlets": [
    ],
  • "created_at": "string",
  • "delete_prepare": true,
  • "key": {
    },
  • "updated_at": "string"
}

UpdateCloudletPool

Update a CloudletPool

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoCloudletPool)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "CloudletPool": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

CloudletPoolMember

Member belong to a cloudlet pool.

VMPool

Pool of VMs to be part of a Cloudlet.

AddVMPoolMember

Add VMPoolMember. Adds a VM to existing VM Pool.

Authorizations:
bearerAuth
Request Body schema: application/json
Region
string

Region name

object (EdgeprotoVMPoolMember)

Responses

Request samples

Content type
application/json
{
  • "Region": "string",
  • "VMPoolMember": {
    }
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

CreateVMPool

Create VMPool. Creates VM pool which will have VMs defined.

Authorizations:
bearerAuth
Request Body schema: application/json
Region
string

Region name

object (EdgeprotoVMPool)

Responses

Request samples

Content type
application/json
{
  • "Region": "string",
  • "VMPool": {
    }
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

DeleteVMPool

Delete VMPool. Deletes VM pool given that none of VMs part of this pool is used.

Authorizations:
bearerAuth
Request Body schema: application/json
Region
string

Region name

object (EdgeprotoVMPool)

Responses

Request samples

Content type
application/json
{
  • "Region": "string",
  • "VMPool": {
    }
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

RemoveVMPoolMember

Remove VMPoolMember. Removes a VM from existing VM Pool.

Authorizations:
bearerAuth
Request Body schema: application/json
Region
string

Region name

object (EdgeprotoVMPoolMember)

Responses

Request samples

Content type
application/json
{
  • "Region": "string",
  • "VMPoolMember": {
    }
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

ShowVMPool

Show VMPools. Lists all the VMs part of the VM pool.

Authorizations:
bearerAuth
Request Body schema: application/json
Region
string

Region name

object (EdgeprotoVMPool)

Responses

Request samples

Content type
application/json
{
  • "Region": "string",
  • "VMPool": {
    }
}

Response samples

Content type
application/json
{
  • "crm_override": "string",
  • "delete_prepare": true,
  • "errors": [
    ],
  • "key": {
    },
  • "state": "string",
  • "vms": [
    ]
}

UpdateVMPool

Update VMPool. Updates a VM pools VMs.

Authorizations:
bearerAuth
Request Body schema: application/json
Region
string

Region name

object (EdgeprotoVMPool)

Responses

Request samples

Content type
application/json
{
  • "Region": "string",
  • "VMPool": {
    }
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

VMPoolMember

Members belong to a VMPool.

OperatorMetrics

Collection of statistics related to Cloudlet.

Events

Collection of event/audit logs from edge services.

FindEvents

Find events and audit events, results sorted by relevance

Authorizations:
bearerAuth
Request Body schema: application/json
allowedorgs
Array of strings or null

Organizations allowed to access the event

endage
string

End age relative to now of the time range

endtime
string <date-time>

End time of the time range

from
integer

Start offset if paging through results

limit
integer

Display the last X events

object (NodeEventMatch)
object (NodeEventMatch)
startage
string

Start age relative to now of the time range

starttime
string <date-time>

Start time of the time range

Responses

Request samples

Content type
application/json
{
  • "allowedorgs": [
    ],
  • "endage": "string",
  • "endtime": "2019-08-24T14:15:22Z",
  • "from": 0,
  • "limit": 0,
  • "match": {
    },
  • "notmatch": {
    },
  • "startage": "string",
  • "starttime": "2019-08-24T14:15:22Z"
}

Response samples

Content type
application/json
[
  • {
    }
]

ShowEvents

Show events and audit events

Authorizations:
bearerAuth
Request Body schema: application/json
allowedorgs
Array of strings or null

Organizations allowed to access the event

endage
string

End age relative to now of the time range

endtime
string <date-time>

End time of the time range

from
integer

Start offset if paging through results

limit
integer

Display the last X events

object (NodeEventMatch)
object (NodeEventMatch)
startage
string

Start age relative to now of the time range

starttime
string <date-time>

Start time of the time range

Responses

Request samples

Content type
application/json
{
  • "allowedorgs": [
    ],
  • "endage": "string",
  • "endtime": "2019-08-24T14:15:22Z",
  • "from": 0,
  • "limit": 0,
  • "match": {
    },
  • "notmatch": {
    },
  • "startage": "string",
  • "starttime": "2019-08-24T14:15:22Z"
}

Response samples

Content type
application/json
[
  • {
    }
]

EventTerms

Show aggregated events terms

Authorizations:
bearerAuth
Request Body schema: application/json
allowedorgs
Array of strings or null

Organizations allowed to access the event

endage
string

End age relative to now of the time range

endtime
string <date-time>

End time of the time range

from
integer

Start offset if paging through results

limit
integer

Display the last X events

object (NodeEventMatch)
object (NodeEventMatch)
startage
string

Start age relative to now of the time range

starttime
string <date-time>

Start time of the time range

Responses

Request samples

Content type
application/json
{
  • "allowedorgs": [
    ],
  • "endage": "string",
  • "endtime": "2019-08-24T14:15:22Z",
  • "from": 0,
  • "limit": 0,
  • "match": {
    },
  • "notmatch": {
    },
  • "startage": "string",
  • "starttime": "2019-08-24T14:15:22Z"
}

Response samples

Content type
application/json
{
  • "names": [
    ],
  • "orgs": [
    ],
  • "regions": [
    ],
  • "tagkeys": [
    ],
  • "types": [
    ]
}

OperatorUsage

Usage details of Cloudlet.

AlertReceiver

Manage receiver for alerts from edge services.

CreateAlertReceiver

Create an alert receiver

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoAppInstKey)
object (EdgeprotoAppKey)
object (EdgeprotoClusterKey)
Email
string

Custom receiving email

Name
string

Receiver Name

PagerDutyApiVersion
string

PagerDuty API version

PagerDutyIntegrationKey
string

PagerDuty integration key

Region
string

Region for the alert receiver

Severity
string

Alert severity filter

SlackChannel
string

Custom slack channel

SlackWebhook
string

Custom slack webhook

Type
string

Receiver type. Eg. email, slack, pagerduty

User
string

User that created this receiver

Responses

Request samples

Content type
application/json
{
  • "AppInstKey": {
    },
  • "AppKey": {
    },
  • "ClusterKey": {
    },
  • "Email": "string",
  • "Name": "string",
  • "PagerDutyApiVersion": "string",
  • "PagerDutyIntegrationKey": "string",
  • "Region": "string",
  • "Severity": "string",
  • "SlackChannel": "string",
  • "SlackWebhook": "string",
  • "Type": "string",
  • "User": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

DeleteAlertReceiver

Delete an alert receiver

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoAppInstKey)
object (EdgeprotoAppKey)
object (EdgeprotoClusterKey)
Email
string

Custom receiving email

Name
string

Receiver Name

PagerDutyApiVersion
string

PagerDuty API version

PagerDutyIntegrationKey
string

PagerDuty integration key

Region
string

Region for the alert receiver

Severity
string

Alert severity filter

SlackChannel
string

Custom slack channel

SlackWebhook
string

Custom slack webhook

Type
string

Receiver type. Eg. email, slack, pagerduty

User
string

User that created this receiver

Responses

Request samples

Content type
application/json
{
  • "AppInstKey": {
    },
  • "AppKey": {
    },
  • "ClusterKey": {
    },
  • "Email": "string",
  • "Name": "string",
  • "PagerDutyApiVersion": "string",
  • "PagerDutyIntegrationKey": "string",
  • "Region": "string",
  • "Severity": "string",
  • "SlackChannel": "string",
  • "SlackWebhook": "string",
  • "Type": "string",
  • "User": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

ShowAlertReceiver

Show alert receivers

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoAppInstKey)
object (EdgeprotoAppKey)
object (EdgeprotoClusterKey)
Email
string

Custom receiving email

Name
string

Receiver Name

PagerDutyApiVersion
string

PagerDuty API version

PagerDutyIntegrationKey
string

PagerDuty integration key

Region
string

Region for the alert receiver

Severity
string

Alert severity filter

SlackChannel
string

Custom slack channel

SlackWebhook
string

Custom slack webhook

Type
string

Receiver type. Eg. email, slack, pagerduty

User
string

User that created this receiver

Responses

Request samples

Content type
application/json
{
  • "AppInstKey": {
    },
  • "AppKey": {
    },
  • "ClusterKey": {
    },
  • "Email": "string",
  • "Name": "string",
  • "PagerDutyApiVersion": "string",
  • "PagerDutyIntegrationKey": "string",
  • "Region": "string",
  • "Severity": "string",
  • "SlackChannel": "string",
  • "SlackWebhook": "string",
  • "Type": "string",
  • "User": "string"
}

Response samples

Content type
application/json
[
  • {
    }
]

Network

Manage additional networks which can be added to Cluster Instances.

CreateNetwork

Create a Network

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoNetwork)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "Network": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

DeleteNetwork

Delete a Network

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoNetwork)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "Network": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

ShowNetwork

Show Networks. Any fields specified will be used to filter results.

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoNetwork)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "Network": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "connection_type": "string",
  • "delete_prepare": true,
  • "key": {
    },
  • "routes": [
    ]
}

UpdateNetwork

Update a Network

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoNetwork)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "Network": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

FederationGuest

Manage Federation Consumer. Federation Consumer is where this platform consumes resources on another Federation partner.

CreateFederationGuest

Create Federation Guest

Authorizations:
bearerAuth
Request Body schema: application/json
AutoRegisterRegion
string

Region used for automatically registered zones

AutoRegisterZones
boolean

Automatically register any zone shared with me

FederationContextId
string

Federation context id returned by partner

ID
integer >= 0

Unique ID

object (OrmapiFederator)
Name
string

Unique name of this Federation Guest, will be used as an operator org for host's zones

NotifyClientId
string

Auth ClientId for notify callbacks to this Guest OP

OperatorId
string

Operator Organization that establishes the federation with a Host OP

PartnerAddr
string

Partner Address

object (OrmapiFederator)
PartnerTokenUrl
string

Partner token URL

ProviderClientId
string

Auth ClientId for connecting to the Host OP

ProviderClientKey
string

Auth ClientKey for connection to the Host OP (stored in secret storage)

Public
boolean

Public means any developer will be able to use the cloudlets, otherwise (TODO) allowed developers will need to be added explicitly

Responses

Request samples

Content type
application/json
{
  • "AutoRegisterRegion": "string",
  • "AutoRegisterZones": true,
  • "FederationContextId": "string",
  • "ID": 0,
  • "MyInfo": {
    },
  • "Name": "string",
  • "NotifyClientId": "string",
  • "OperatorId": "string",
  • "PartnerAddr": "string",
  • "PartnerInfo": {
    },
  • "PartnerTokenUrl": "string",
  • "ProviderClientId": "string",
  • "ProviderClientKey": "string",
  • "Public": true
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

DeleteFederationGuest

Delete Federation Guest

Authorizations:
bearerAuth
Request Body schema: application/json
AutoRegisterRegion
string

Region used for automatically registered zones

AutoRegisterZones
boolean

Automatically register any zone shared with me

FederationContextId
string

Federation context id returned by partner

ID
integer >= 0

Unique ID

object (OrmapiFederator)
Name
string

Unique name of this Federation Guest, will be used as an operator org for host's zones

NotifyClientId
string

Auth ClientId for notify callbacks to this Guest OP

OperatorId
string

Operator Organization that establishes the federation with a Host OP

PartnerAddr
string

Partner Address

object (OrmapiFederator)
PartnerTokenUrl
string

Partner token URL

ProviderClientId
string

Auth ClientId for connecting to the Host OP

ProviderClientKey
string

Auth ClientKey for connection to the Host OP (stored in secret storage)

Public
boolean

Public means any developer will be able to use the cloudlets, otherwise (TODO) allowed developers will need to be added explicitly

Responses

Request samples

Content type
application/json
{
  • "AutoRegisterRegion": "string",
  • "AutoRegisterZones": true,
  • "FederationContextId": "string",
  • "ID": 0,
  • "MyInfo": {
    },
  • "Name": "string",
  • "NotifyClientId": "string",
  • "OperatorId": "string",
  • "PartnerAddr": "string",
  • "PartnerInfo": {
    },
  • "PartnerTokenUrl": "string",
  • "ProviderClientId": "string",
  • "ProviderClientKey": "string",
  • "Public": true
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

GenerateFederationGuestNotifyKey

Set Partner Federation API Key

Authorizations:
bearerAuth
Request Body schema: application/json
AutoRegisterRegion
string

Region used for automatically registered zones

AutoRegisterZones
boolean

Automatically register any zone shared with me

FederationContextId
string

Federation context id returned by partner

ID
integer >= 0

Unique ID

object (OrmapiFederator)
Name
string

Unique name of this Federation Guest, will be used as an operator org for host's zones

NotifyClientId
string

Auth ClientId for notify callbacks to this Guest OP

OperatorId
string

Operator Organization that establishes the federation with a Host OP

PartnerAddr
string

Partner Address

object (OrmapiFederator)
PartnerTokenUrl
string

Partner token URL

ProviderClientId
string

Auth ClientId for connecting to the Host OP

ProviderClientKey
string

Auth ClientKey for connection to the Host OP (stored in secret storage)

Public
boolean

Public means any developer will be able to use the cloudlets, otherwise (TODO) allowed developers will need to be added explicitly

Responses

Request samples

Content type
application/json
{
  • "AutoRegisterRegion": "string",
  • "AutoRegisterZones": true,
  • "FederationContextId": "string",
  • "ID": 0,
  • "MyInfo": {
    },
  • "Name": "string",
  • "NotifyClientId": "string",
  • "OperatorId": "string",
  • "PartnerAddr": "string",
  • "PartnerInfo": {
    },
  • "PartnerTokenUrl": "string",
  • "ProviderClientId": "string",
  • "ProviderClientKey": "string",
  • "Public": true
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

SetFederationGuestAPIKey

Set Partner Federation API Key

Authorizations:
bearerAuth
Request Body schema: application/json
AutoRegisterRegion
string

Region used for automatically registered zones

AutoRegisterZones
boolean

Automatically register any zone shared with me

FederationContextId
string

Federation context id returned by partner

ID
integer >= 0

Unique ID

object (OrmapiFederator)
Name
string

Unique name of this Federation Guest, will be used as an operator org for host's zones

NotifyClientId
string

Auth ClientId for notify callbacks to this Guest OP

OperatorId
string

Operator Organization that establishes the federation with a Host OP

PartnerAddr
string

Partner Address

object (OrmapiFederator)
PartnerTokenUrl
string

Partner token URL

ProviderClientId
string

Auth ClientId for connecting to the Host OP

ProviderClientKey
string

Auth ClientKey for connection to the Host OP (stored in secret storage)

Public
boolean

Public means any developer will be able to use the cloudlets, otherwise (TODO) allowed developers will need to be added explicitly

Responses

Request samples

Content type
application/json
{
  • "AutoRegisterRegion": "string",
  • "AutoRegisterZones": true,
  • "FederationContextId": "string",
  • "ID": 0,
  • "MyInfo": {
    },
  • "Name": "string",
  • "NotifyClientId": "string",
  • "OperatorId": "string",
  • "PartnerAddr": "string",
  • "PartnerInfo": {
    },
  • "PartnerTokenUrl": "string",
  • "ProviderClientId": "string",
  • "ProviderClientKey": "string",
  • "Public": true
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

UpdateFederationGuest

Update Federation Guest

Authorizations:
bearerAuth
Request Body schema: application/json
AutoRegisterRegion
string

Region used for automatically registered zones

AutoRegisterZones
boolean

Automatically register any zone shared with me

FederationContextId
string

Federation context id returned by partner

ID
integer >= 0

Unique ID

object (OrmapiFederator)
Name
string

Unique name of this Federation Guest, will be used as an operator org for host's zones

NotifyClientId
string

Auth ClientId for notify callbacks to this Guest OP

OperatorId
string

Operator Organization that establishes the federation with a Host OP

PartnerAddr
string

Partner Address

object (OrmapiFederator)
PartnerTokenUrl
string

Partner token URL

ProviderClientId
string

Auth ClientId for connecting to the Host OP

ProviderClientKey
string

Auth ClientKey for connection to the Host OP (stored in secret storage)

Public
boolean

Public means any developer will be able to use the cloudlets, otherwise (TODO) allowed developers will need to be added explicitly

Responses

Request samples

Content type
application/json
{
  • "AutoRegisterRegion": "string",
  • "AutoRegisterZones": true,
  • "FederationContextId": "string",
  • "ID": 0,
  • "MyInfo": {
    },
  • "Name": "string",
  • "NotifyClientId": "string",
  • "OperatorId": "string",
  • "PartnerAddr": "string",
  • "PartnerInfo": {
    },
  • "PartnerTokenUrl": "string",
  • "ProviderClientId": "string",
  • "ProviderClientKey": "string",
  • "Public": true
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

DeregisterGuestZone

DeRegister Partner Federator Zone

Authorizations:
bearerAuth
Request Body schema: application/json
FedGuest
string

Federation Guest name

Region
string

Region to create local cloudlet versions of Host zones

Zones
Array of strings or null

Partner federator zones to be registered/deregistered

Responses

Request samples

Content type
application/json
{
  • "FedGuest": "string",
  • "Region": "string",
  • "Zones": [
    ]
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

RegisterGuestZone

Register Partner Federator Zone

Authorizations:
bearerAuth
Request Body schema: application/json
FedGuest
string

Federation Guest name

Region
string

Region to create local cloudlet versions of Host zones

Zones
Array of strings or null

Partner federator zones to be registered/deregistered

Responses

Request samples

Content type
application/json
{
  • "FedGuest": "string",
  • "Region": "string",
  • "Zones": [
    ]
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

ShowGuestZone

Show Federated Partner Zones

Authorizations:
bearerAuth
Request Body schema: application/json
ConsumerName
string

Name of the Federation Guest

GeoLocation
string

GPS co-ordinates associated with the zone (in decimal format)

GeographyDetails
string

Geography details

OperatorId
string

Guest operator organization

Region
string

Region in which zone is instantiated

ZoneId
string

Zone unique name

Responses

Request samples

Content type
application/json
{
  • "ConsumerName": "string",
  • "GeoLocation": "string",
  • "GeographyDetails": "string",
  • "OperatorId": "string",
  • "Region": "string",
  • "ZoneId": "string"
}

Response samples

Content type
application/json
[
  • {
    }
]

FederationHost

Manage Federation Provider. Federation Provider is where this platform hosts the applications being onboarded by another federation partner.

ShowHostApp

Show Apps onboarded by partner

Authorizations:
bearerAuth
Request Body schema: application/json
AppID
string

App ID send by partner

AppName
string

App name of federation app (not region app)

AppProviderId
string

App provider ID

AppStatusCallbackLink
string

App status callback link

AppVers
string

App version of federation app (not region app)

ArtefactIds
Array of strings or null (PqStringArray)
DeploymentZones
Array of strings or null (PqStringArray)
FederationName
string

Host Federation name

Responses

Request samples

Content type
application/json
{
  • "AppID": "string",
  • "AppName": "string",
  • "AppProviderId": "string",
  • "AppStatusCallbackLink": "string",
  • "AppVers": "string",
  • "ArtefactIds": [
    ],
  • "DeploymentZones": [
    ],
  • "FederationName": "string"
}

Response samples

Content type
application/json
[
  • {
    }
]

UnsafeDeleteHostApp

Delete App onboarded by partner, use only if partner cannot trigger delete themselves

Authorizations:
bearerAuth
Request Body schema: application/json
AppID
string

App ID send by partner

AppName
string

App name of federation app (not region app)

AppProviderId
string

App provider ID

AppStatusCallbackLink
string

App status callback link

AppVers
string

App version of federation app (not region app)

ArtefactIds
Array of strings or null (PqStringArray)
DeploymentZones
Array of strings or null (PqStringArray)
FederationName
string

Host Federation name

Responses

Request samples

Content type
application/json
{
  • "AppID": "string",
  • "AppName": "string",
  • "AppProviderId": "string",
  • "AppStatusCallbackLink": "string",
  • "AppVers": "string",
  • "ArtefactIds": [
    ],
  • "DeploymentZones": [
    ],
  • "FederationName": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

ShowHostAppInst

Show AppInsts onboarded by partner

Authorizations:
bearerAuth
Request Body schema: application/json
AppID
string

AppID for ProviderApp

AppInstCallbackLink
string

AppInst callback link

AppInstID
string

AppInst unique ID

AppName
string

App name for AppInstKey

AppVers
string

App version for AppInstKey

Cloudlet
string

Cloudlet name for AppInstKey

CloudletFedOrg
string

Cloudlet federation org for AppInstKey (this should always be blank)

CloudletOrg
string

Cloudlet org for AppInstKey

Error
string

Error message if create failed

FederationName
string

Host Federation name

Region
string

Region for AppInst

Responses

Request samples

Content type
application/json
{
  • "AppID": "string",
  • "AppInstCallbackLink": "string",
  • "AppInstID": "string",
  • "AppName": "string",
  • "AppVers": "string",
  • "Cloudlet": "string",
  • "CloudletFedOrg": "string",
  • "CloudletOrg": "string",
  • "Error": "string",
  • "FederationName": "string",
  • "Region": "string"
}

Response samples

Content type
application/json
[
  • {
    }
]

UnsafeDeleteHostAppInst

Delete AppInst created by partner, use only if partner cannot trigger delete themselves

Authorizations:
bearerAuth
Request Body schema: application/json
AppID
string

AppID for ProviderApp

AppInstCallbackLink
string

AppInst callback link

AppInstID
string

AppInst unique ID

AppName
string

App name for AppInstKey

AppVers
string

App version for AppInstKey

Cloudlet
string

Cloudlet name for AppInstKey

CloudletFedOrg
string

Cloudlet federation org for AppInstKey (this should always be blank)

CloudletOrg
string

Cloudlet org for AppInstKey

Error
string

Error message if create failed

FederationName
string

Host Federation name

Region
string

Region for AppInst

Responses

Request samples

Content type
application/json
{
  • "AppID": "string",
  • "AppInstCallbackLink": "string",
  • "AppInstID": "string",
  • "AppName": "string",
  • "AppVers": "string",
  • "Cloudlet": "string",
  • "CloudletFedOrg": "string",
  • "CloudletOrg": "string",
  • "Error": "string",
  • "FederationName": "string",
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

ShowHostArtefact

Show Artefacts created by partner

Authorizations:
bearerAuth
Request Body schema: application/json
AppName
string

App name in region

AppProviderId
string

App provider ID

AppVers
string

App version in region

ArtefactID
string

Artefact ID send by partner

ArtefactName
string

Artefact name

ArtefactVersion
string

Artefact version

DescType
string

Descriptor Type

FederationName
string

Host Federation name

FileIds
Array of strings or null (PqStringArray)
VirtType
string

Virtualization Type

Responses

Request samples

Content type
application/json
{
  • "AppName": "string",
  • "AppProviderId": "string",
  • "AppVers": "string",
  • "ArtefactID": "string",
  • "ArtefactName": "string",
  • "ArtefactVersion": "string",
  • "DescType": "string",
  • "FederationName": "string",
  • "FileIds": [
    ],
  • "VirtType": "string"
}

Response samples

Content type
application/json
[
  • {
    }
]

UnsafeDeleteHostArtefact

Delete Artefact onboarded by partner, use only if partner cannot trigger delete themselves

Authorizations:
bearerAuth
Request Body schema: application/json
AppName
string

App name in region

AppProviderId
string

App provider ID

AppVers
string

App version in region

ArtefactID
string

Artefact ID send by partner

ArtefactName
string

Artefact name

ArtefactVersion
string

Artefact version

DescType
string

Descriptor Type

FederationName
string

Host Federation name

FileIds
Array of strings or null (PqStringArray)
VirtType
string

Virtualization Type

Responses

Request samples

Content type
application/json
{
  • "AppName": "string",
  • "AppProviderId": "string",
  • "AppVers": "string",
  • "ArtefactID": "string",
  • "ArtefactName": "string",
  • "ArtefactVersion": "string",
  • "DescType": "string",
  • "FederationName": "string",
  • "FileIds": [
    ],
  • "VirtType": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

CreateFederationHost

Create Federation Host

Authorizations:
bearerAuth
Request Body schema: application/json
DefaultContainerDeployment
string

Default container deployment type (either docker or kubernetes)

FederationContextId
string

The federation context id we generated for this federation

ID
integer >= 0

Unique ID

object (OrmapiFederator)
Name
string

Unique name of this federation Host, will be used as a developer org name for Guest OP's images and apps

OperatorId
string

Operator Organization that provides the resources

object (OrmapiFederator)
PartnerNotifyClientId
string

Partner notification client id

PartnerNotifyClientKey
string

Partner notification client key (saved in secret storage)

PartnerNotifyDest
string

Partner notification URI

PartnerNotifyTokenUrl
string

Partner Oauth token URI

ProviderClientId
string

Host client ID for inbound connections

Regions
Array of strings or null (PqStringArray)

Responses

Request samples

Content type
application/json
{
  • "DefaultContainerDeployment": "string",
  • "FederationContextId": "string",
  • "ID": 0,
  • "MyInfo": {
    },
  • "Name": "string",
  • "OperatorId": "string",
  • "PartnerInfo": {
    },
  • "PartnerNotifyClientId": "string",
  • "PartnerNotifyClientKey": "string",
  • "PartnerNotifyDest": "string",
  • "PartnerNotifyTokenUrl": "string",
  • "ProviderClientId": "string",
  • "Regions": [
    ]
}

Response samples

Content type
application/json
{
  • "ClientId": "string",
  • "ClientKey": "string",
  • "TargetAddr": "string",
  • "TokenUrl": "string"
}

DeleteFederationHost

Delete Federation Host

Authorizations:
bearerAuth
Request Body schema: application/json
DefaultContainerDeployment
string

Default container deployment type (either docker or kubernetes)

FederationContextId
string

The federation context id we generated for this federation

ID
integer >= 0

Unique ID

object (OrmapiFederator)
Name
string

Unique name of this federation Host, will be used as a developer org name for Guest OP's images and apps

OperatorId
string

Operator Organization that provides the resources

object (OrmapiFederator)
PartnerNotifyClientId
string

Partner notification client id

PartnerNotifyClientKey
string

Partner notification client key (saved in secret storage)

PartnerNotifyDest
string

Partner notification URI

PartnerNotifyTokenUrl
string

Partner Oauth token URI

ProviderClientId
string

Host client ID for inbound connections

Regions
Array of strings or null (PqStringArray)

Responses

Request samples

Content type
application/json
{
  • "DefaultContainerDeployment": "string",
  • "FederationContextId": "string",
  • "ID": 0,
  • "MyInfo": {
    },
  • "Name": "string",
  • "OperatorId": "string",
  • "PartnerInfo": {
    },
  • "PartnerNotifyClientId": "string",
  • "PartnerNotifyClientKey": "string",
  • "PartnerNotifyDest": "string",
  • "PartnerNotifyTokenUrl": "string",
  • "ProviderClientId": "string",
  • "Regions": [
    ]
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

GenerateFederationHostAPIKey

Generate Federation Host API Key to share with Guest

Authorizations:
bearerAuth
Request Body schema: application/json
DefaultContainerDeployment
string

Default container deployment type (either docker or kubernetes)

FederationContextId
string

The federation context id we generated for this federation

ID
integer >= 0

Unique ID

object (OrmapiFederator)
Name
string

Unique name of this federation Host, will be used as a developer org name for Guest OP's images and apps

OperatorId
string

Operator Organization that provides the resources

object (OrmapiFederator)
PartnerNotifyClientId
string

Partner notification client id

PartnerNotifyClientKey
string

Partner notification client key (saved in secret storage)

PartnerNotifyDest
string

Partner notification URI

PartnerNotifyTokenUrl
string

Partner Oauth token URI

ProviderClientId
string

Host client ID for inbound connections

Regions
Array of strings or null (PqStringArray)

Responses

Request samples

Content type
application/json
{
  • "DefaultContainerDeployment": "string",
  • "FederationContextId": "string",
  • "ID": 0,
  • "MyInfo": {
    },
  • "Name": "string",
  • "OperatorId": "string",
  • "PartnerInfo": {
    },
  • "PartnerNotifyClientId": "string",
  • "PartnerNotifyClientKey": "string",
  • "PartnerNotifyDest": "string",
  • "PartnerNotifyTokenUrl": "string",
  • "ProviderClientId": "string",
  • "Regions": [
    ]
}

Response samples

Content type
application/json
{
  • "ClientId": "string",
  • "ClientKey": "string",
  • "TargetAddr": "string",
  • "TokenUrl": "string"
}

ShowHostImage

Show Images uploaded by partner

Authorizations:
bearerAuth
Request Body schema: application/json
AppProviderId
string

Partner app provider organization

Checksum
string

MD5 checksum for VM and file-based image types, sha256 digest for containers and Helm charts

Description
string

Image description

FederationName
string

Host federation name

FileID
string

File ID sent by partner

Name
string

Image name

Path
string

Image path

Status
string

Image status

Type
string

Image type (DOCKER, HELM, QCOW2, or OVA)

Version
string

Image version

Responses

Request samples

Content type
application/json
{
  • "AppProviderId": "string",
  • "Checksum": "string",
  • "Description": "string",
  • "FederationName": "string",
  • "FileID": "string",
  • "Name": "string",
  • "Path": "string",
  • "Status": "string",
  • "Type": "string",
  • "Version": "string"
}

Response samples

Content type
application/json
[
  • {
    }
]

UnsafeDeleteHostImage

Delete Image onboarded by partner, use only if partner cannot trigger delete themselves

Authorizations:
bearerAuth
Request Body schema: application/json
AppProviderId
string

Partner app provider organization

Checksum
string

MD5 checksum for VM and file-based image types, sha256 digest for containers and Helm charts

Description
string

Image description

FederationName
string

Host federation name

FileID
string

File ID sent by partner

Name
string

Image name

Path
string

Image path

Status
string

Image status

Type
string

Image type (DOCKER, HELM, QCOW2, or OVA)

Version
string

Image version

Responses

Request samples

Content type
application/json
{
  • "AppProviderId": "string",
  • "Checksum": "string",
  • "Description": "string",
  • "FederationName": "string",
  • "FileID": "string",
  • "Name": "string",
  • "Path": "string",
  • "Status": "string",
  • "Type": "string",
  • "Version": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

SetFederationHostNotifyKey

Set Federation Host notify key for notify connections

Authorizations:
bearerAuth
Request Body schema: application/json
DefaultContainerDeployment
string

Default container deployment type (either docker or kubernetes)

FederationContextId
string

The federation context id we generated for this federation

ID
integer >= 0

Unique ID

object (OrmapiFederator)
Name
string

Unique name of this federation Host, will be used as a developer org name for Guest OP's images and apps

OperatorId
string

Operator Organization that provides the resources

object (OrmapiFederator)
PartnerNotifyClientId
string

Partner notification client id

PartnerNotifyClientKey
string

Partner notification client key (saved in secret storage)

PartnerNotifyDest
string

Partner notification URI

PartnerNotifyTokenUrl
string

Partner Oauth token URI

ProviderClientId
string

Host client ID for inbound connections

Regions
Array of strings or null (PqStringArray)

Responses

Request samples

Content type
application/json
{
  • "DefaultContainerDeployment": "string",
  • "FederationContextId": "string",
  • "ID": 0,
  • "MyInfo": {
    },
  • "Name": "string",
  • "OperatorId": "string",
  • "PartnerInfo": {
    },
  • "PartnerNotifyClientId": "string",
  • "PartnerNotifyClientKey": "string",
  • "PartnerNotifyDest": "string",
  • "PartnerNotifyTokenUrl": "string",
  • "ProviderClientId": "string",
  • "Regions": [
    ]
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

ShowFederationHost

Show Federation Host

Authorizations:
bearerAuth
Request Body schema: application/json
DefaultContainerDeployment
string

Default container deployment type (either docker or kubernetes)

FederationContextId
string

The federation context id we generated for this federation

ID
integer >= 0

Unique ID

object (OrmapiFederator)
Name
string

Unique name of this federation Host, will be used as a developer org name for Guest OP's images and apps

OperatorId
string

Operator Organization that provides the resources

object (OrmapiFederator)
PartnerNotifyClientId
string

Partner notification client id

PartnerNotifyClientKey
string

Partner notification client key (saved in secret storage)

PartnerNotifyDest
string

Partner notification URI

PartnerNotifyTokenUrl
string

Partner Oauth token URI

ProviderClientId
string

Host client ID for inbound connections

Regions
Array of strings or null (PqStringArray)

Responses

Request samples

Content type
application/json
{
  • "DefaultContainerDeployment": "string",
  • "FederationContextId": "string",
  • "ID": 0,
  • "MyInfo": {
    },
  • "Name": "string",
  • "OperatorId": "string",
  • "PartnerInfo": {
    },
  • "PartnerNotifyClientId": "string",
  • "PartnerNotifyClientKey": "string",
  • "PartnerNotifyDest": "string",
  • "PartnerNotifyTokenUrl": "string",
  • "ProviderClientId": "string",
  • "Regions": [
    ]
}

Response samples

Content type
application/json
[
  • {
    }
]

UpdateFederationHost

Update Federation Host

Authorizations:
bearerAuth
Request Body schema: application/json
DefaultContainerDeployment
string

Default container deployment type (either docker or kubernetes)

FederationContextId
string

The federation context id we generated for this federation

ID
integer >= 0

Unique ID

object (OrmapiFederator)
Name
string

Unique name of this federation Host, will be used as a developer org name for Guest OP's images and apps

OperatorId
string

Operator Organization that provides the resources

object (OrmapiFederator)
PartnerNotifyClientId
string

Partner notification client id

PartnerNotifyClientKey
string

Partner notification client key (saved in secret storage)

PartnerNotifyDest
string

Partner notification URI

PartnerNotifyTokenUrl
string

Partner Oauth token URI

ProviderClientId
string

Host client ID for inbound connections

Regions
Array of strings or null (PqStringArray)

Responses

Request samples

Content type
application/json
{
  • "DefaultContainerDeployment": "string",
  • "FederationContextId": "string",
  • "ID": 0,
  • "MyInfo": {
    },
  • "Name": "string",
  • "OperatorId": "string",
  • "PartnerInfo": {
    },
  • "PartnerNotifyClientId": "string",
  • "PartnerNotifyClientKey": "string",
  • "PartnerNotifyDest": "string",
  • "PartnerNotifyTokenUrl": "string",
  • "ProviderClientId": "string",
  • "Regions": [
    ]
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

ShareHostZone

Share Host Zone with Partner OP

Authorizations:
bearerAuth
Request Body schema: application/json
FedHost
string

Federation Host name

Zones
Array of strings or null

Self federator zones to be shared/unshared

Responses

Request samples

Content type
application/json
{
  • "FedHost": "string",
  • "Zones": [
    ]
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

ShowHostZone

Show Shared Host Zones

Authorizations:
bearerAuth
Request Body schema: application/json
OperatorId
string

Host operator organization

PartnerNotifyZoneURI
string

Partner notify zone URI

ProviderName
string

Name of the Federation Host OP

ZoneId
string

Globally unique identifier of the federator zone

Responses

Request samples

Content type
application/json
{
  • "OperatorId": "string",
  • "PartnerNotifyZoneURI": "string",
  • "ProviderName": "string",
  • "ZoneId": "string"
}

Response samples

Content type
application/json
[
  • {
    }
]

UnshareHostZone

Unshare Host Zone with Partner OP

Authorizations:
bearerAuth
Request Body schema: application/json
FedHost
string

Federation Host name

Zones
Array of strings or null

Self federator zones to be shared/unshared

Responses

Request samples

Content type
application/json
{
  • "FedHost": "string",
  • "Zones": [
    ]
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

CreateHostZoneBase

Create Host Zone Base to package cloudlets into a zone

Authorizations:
bearerAuth
Request Body schema: application/json
Cloudlets
Array of strings or null (PqStringArray)
CountryCode
string

ISO 3166-1 Alpha-2 code for the country where operator platform is located

GeoLocation
string

GPS co-ordinates associated with the zone (in decimal format)

GeographyDetails
string

Geography details

OperatorId
string

Operator organization

Region
string

Region in which cloudlets reside

ZoneId
string

Unique name for zone

Responses

Request samples

Content type
application/json
{
  • "Cloudlets": [
    ],
  • "CountryCode": "string",
  • "GeoLocation": "string",
  • "GeographyDetails": "string",
  • "OperatorId": "string",
  • "Region": "string",
  • "ZoneId": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

DeleteHostZoneBase

Delete Host Zone Base

Authorizations:
bearerAuth
Request Body schema: application/json
Cloudlets
Array of strings or null (PqStringArray)
CountryCode
string

ISO 3166-1 Alpha-2 code for the country where operator platform is located

GeoLocation
string

GPS co-ordinates associated with the zone (in decimal format)

GeographyDetails
string

Geography details

OperatorId
string

Operator organization

Region
string

Region in which cloudlets reside

ZoneId
string

Unique name for zone

Responses

Request samples

Content type
application/json
{
  • "Cloudlets": [
    ],
  • "CountryCode": "string",
  • "GeoLocation": "string",
  • "GeographyDetails": "string",
  • "OperatorId": "string",
  • "Region": "string",
  • "ZoneId": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

ShowHostZoneBase

Show Host Zone Bases

Authorizations:
bearerAuth
Request Body schema: application/json
Cloudlets
Array of strings or null (PqStringArray)
CountryCode
string

ISO 3166-1 Alpha-2 code for the country where operator platform is located

GeoLocation
string

GPS co-ordinates associated with the zone (in decimal format)

GeographyDetails
string

Geography details

OperatorId
string

Operator organization

Region
string

Region in which cloudlets reside

ZoneId
string

Unique name for zone

Responses

Request samples

Content type
application/json
{
  • "Cloudlets": [
    ],
  • "CountryCode": "string",
  • "GeoLocation": "string",
  • "GeographyDetails": "string",
  • "OperatorId": "string",
  • "Region": "string",
  • "ZoneId": "string"
}

Response samples

Content type
application/json
[
  • {
    }
]

UpdateHostZoneBase

Update Host Zone Base

Authorizations:
bearerAuth
Request Body schema: application/json
Cloudlets
Array of strings or null (PqStringArray)
CountryCode
string

ISO 3166-1 Alpha-2 code for the country where operator platform is located

GeoLocation
string

GPS co-ordinates associated with the zone (in decimal format)

GeographyDetails
string

Geography details

OperatorId
string

Operator organization

Region
string

Region in which cloudlets reside

ZoneId
string

Unique name for zone

Responses

Request samples

Content type
application/json
{
  • "Cloudlets": [
    ],
  • "CountryCode": "string",
  • "GeoLocation": "string",
  • "GeographyDetails": "string",
  • "OperatorId": "string",
  • "Region": "string",
  • "ZoneId": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

ClusterInst

ClusterInst is an instance of a Cluster on a Cloudlet. It is defined by a Cluster, Cloudlet, and Developer key.

CreateClusterInst

Create Cluster Instance. Creates an instance of a Cluster on a Cloudlet, defined by a Cluster Key and a Cloudlet Key. ClusterInst is a collection of compute resources on a Cloudlet on which AppInsts are deployed.

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoClusterInst)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "ClusterInst": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

DeleteClusterInst

Delete Cluster Instance. Deletes an instance of a Cluster deployed on a Cloudlet.

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoClusterInst)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "ClusterInst": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

DeleteIdleReservableClusterInsts

Cleanup Reservable Cluster Instances. Deletes reservable cluster instances that are not in use.

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoIdleReservableClusterInsts)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "IdleReservableClusterInsts": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

ShowClusterInst

Show Cluster Instances. Lists all the cluster instances managed by Edge Controller.

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoClusterInst)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "ClusterInst": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "allocated_ip": "string",
  • "auto": true,
  • "auto_scale_policy": "string",
  • "availability_zone": "string",
  • "created_at": "string",
  • "crm_override": "string",
  • "delete_prepare": true,
  • "deployment": "string",
  • "dns_label": "string",
  • "errors": [
    ],
  • "external_volume_size": 0,
  • "flavor": {
    },
  • "fqdn": "string",
  • "image_name": "string",
  • "ip_access": "string",
  • "key": {
    },
  • "liveness": "string",
  • "master_node_flavor": "string",
  • "multi_tenant": true,
  • "networks": [
    ],
  • "node_flavor": "string",
  • "num_masters": 0,
  • "num_nodes": 0,
  • "opt_res": "string",
  • "reservable": true,
  • "reservation_ended_at": "string",
  • "reserved_by": "string",
  • "resources": {
    },
  • "shared_volume_size": 0,
  • "skip_crm_cleanup_on_failure": true,
  • "state": "string",
  • "updated_at": "string"
}

UpdateClusterInst

Update Cluster Instance. Updates an instance of a Cluster deployed on a Cloudlet.

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoClusterInst)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "ClusterInst": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

App

Provides information about the developer's application.

AddAppAlertPolicy

Add an AlertPolicy to the application definition

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoAppAlertPolicy)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "AppAlertPolicy": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

AddAppAutoProvPolicy

Add an AutoProvPolicy to the application definition

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoAppAutoProvPolicy)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "AppAutoProvPolicy": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

CreateApp

Create Application. Creates a definition for an application for Cloudlet deployment.

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoApp)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "App": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

DeleteApp

Delete Application. Deletes a definition of an application. Instances of the application must be deleted first.

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoApp)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "App": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

RemoveAppAlertPolicy

Remove an AlertPolicy from the application definition

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoAppAlertPolicy)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "AppAlertPolicy": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

RemoveAppAutoProvPolicy

Remove an AutoProvPolicy from the application definition

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoAppAutoProvPolicy)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "AppAutoProvPolicy": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

ShowApp

Show Applications. Lists all application definitions. Any fields specified will be used to filter results.

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoApp)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "App": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "access_ports": "string",
  • "access_type": "string",
  • "alert_policies": [
    ],
  • "allow_serverless": true,
  • "android_package_name": "string",
  • "annotations": "string",
  • "auth_public_key": "string",
  • "auto_prov_policies": [
    ],
  • "auto_prov_policy": "string",
  • "command": "string",
  • "command_args": [
    ],
  • "configs": [
    ],
  • "created_at": "string",
  • "default_flavor": {
    },
  • "del_opt": "string",
  • "delete_prepare": true,
  • "deployment": "string",
  • "deployment_generator": "string",
  • "deployment_manifest": "string",
  • "global_id": "string",
  • "image_path": "string",
  • "image_type": "string",
  • "internal_ports": true,
  • "key": {
    },
  • "md5sum": "string",
  • "official_fqdn": "string",
  • "qos_session_duration": "string",
  • "qos_session_profile": "string",
  • "required_outbound_connections": [
    ],
  • "revision": "string",
  • "scale_with_cluster": true,
  • "serverless_config": {
    },
  • "skip_hc_ports": "string",
  • "template_delimiter": "string",
  • "trusted": true,
  • "updated_at": "string",
  • "vm_app_os_type": "string"
}

ShowCloudletsForAppDeployment

Discover cloudlets supporting deployments of App.DefaultFlavor

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoDeploymentCloudletRequest)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "DeploymentCloudletRequest": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "federated_organization": "string",
  • "name": "string",
  • "organization": "string"
}

UpdateApp

Update Application. Updates the definition of an application.

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoApp)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "App": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

AppInst

AppInst is an instance of an App on a Cloudlet where it is defined by an App plus a ClusterInst key.

CreateAppInst

Create Application Instance. Creates an instance of an App on a Cloudlet where it is defined by an App plus a ClusterInst key. Many of the fields here are inherited from the App definition.

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoAppInst)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "AppInst": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

DeleteAppInst

Delete Application Instance. Deletes an instance of the App from the Cloudlet.

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoAppInst)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "AppInst": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

RefreshAppInst

Refresh Application Instance. Restarts an App instance with new App settings or image.

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoAppInst)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "AppInst": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

ShowAppInst

Show Application Instances. Lists all the Application instances managed by the Edge Controller. Any fields specified will be used to filter results.

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoAppInst)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "AppInst": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "app_key": {
    },
  • "auto_cluster_ip_access": "string",
  • "availability_zone": "string",
  • "cloudlet_flavor": "string",
  • "cloudlet_loc": {
    },
  • "cluster_key": {
    },
  • "compatibility_version": 0,
  • "configs": [
    ],
  • "created_at": "string",
  • "crm_override": "string",
  • "dedicated_ip": true,
  • "dns_label": "string",
  • "errors": [
    ],
  • "external_volume_size": 0,
  • "fed_key": {
    },
  • "fields": [
    ],
  • "flavor": {
    },
  • "force_update": true,
  • "health_check": 0,
  • "internal_port_to_lb_ip": {
    },
  • "key": {
    },
  • "liveness": "string",
  • "mapped_ports": [
    ],
  • "opt_res": "string",
  • "power_state": "string",
  • "real_cluster_name": "string",
  • "revision": "string",
  • "runtime_info": {
    },
  • "state": "string",
  • "unique_id": "string",
  • "update_multiple": true,
  • "updated_at": "string",
  • "uri": "string",
  • "virtual_cluster_key": {
    },
  • "vm_flavor": "string"
}

UpdateAppInst

Update Application Instance. Updates an Application instance and then refreshes it.

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoAppInst)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "AppInst": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

AutoProvPolicy

AutoProvPolicy defines the automated provisioning policy.

AddAutoProvPolicyCloudlet

Add a Cloudlet to the Auto Provisioning Policy

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoAutoProvPolicyCloudlet)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "AutoProvPolicyCloudlet": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

CreateAutoProvPolicy

Create an Auto Provisioning Policy

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoAutoProvPolicy)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "AutoProvPolicy": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

DeleteAutoProvPolicy

Delete an Auto Provisioning Policy

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoAutoProvPolicy)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "AutoProvPolicy": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

RemoveAutoProvPolicyCloudlet

Remove a Cloudlet from the Auto Provisioning Policy

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoAutoProvPolicyCloudlet)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "AutoProvPolicyCloudlet": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

ShowAutoProvPolicy

Show Auto Provisioning Policies. Any fields specified will be used to filter results.

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoAutoProvPolicy)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "AutoProvPolicy": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "cloudlets": [
    ],
  • "delete_prepare": true,
  • "deploy_client_count": 0,
  • "deploy_interval_count": 0,
  • "key": {
    },
  • "max_instances": 0,
  • "min_active_instances": 0,
  • "undeploy_client_count": 0,
  • "undeploy_interval_count": 0
}

UpdateAutoProvPolicy

Update an Auto Provisioning Policy

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoAutoProvPolicy)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "AutoProvPolicy": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

AppAutoProvPolicy

AutoProvPolicy belonging to an app.

AutoScalePolicy

AutoScalePolicy defines when and how ClusterInsts will have their nodes scaled up or down.

CreateAutoScalePolicy

Create an Auto Scale Policy

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoAutoScalePolicy)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "AutoScalePolicy": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

DeleteAutoScalePolicy

Delete an Auto Scale Policy

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoAutoScalePolicy)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "AutoScalePolicy": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

ShowAutoScalePolicy

Show Auto Scale Policies. Any fields specified will be used to filter results.

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoAutoScalePolicy)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "AutoScalePolicy": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "delete_prepare": true,
  • "key": {
    },
  • "max_nodes": 0,
  • "min_nodes": 0,
  • "scale_down_cpu_thresh": 0,
  • "scale_up_cpu_thresh": 0,
  • "stabilization_window_sec": 0,
  • "target_active_connections": 0,
  • "target_cpu": 0,
  • "target_mem": 0,
  • "trigger_time_sec": 0
}

UpdateAutoScalePolicy

Update an Auto Scale Policy

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoAutoScalePolicy)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "AutoScalePolicy": {
    },
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

PrivacyPolicy

PrivacyPolicy defines security restrictions for cluster instances nodes scaled up or down.

AutoProvPolicyCloudlet

AutoProvPolicyCloudlet belong to a cloudlet.

AppInstClientKey

Client is an AppInst client that called FindCloudlet DME Api.

ExecRequest

ExecRequest is a common struct for enabling a connection to execute some work on a container.

DeveloperMetrics

Collection of statistics related to Client/App/Cluster.

Events

Collection of event/audit logs from edge services.

FindEvents

Find events and audit events, results sorted by relevance

Authorizations:
bearerAuth
Request Body schema: application/json
allowedorgs
Array of strings or null

Organizations allowed to access the event

endage
string

End age relative to now of the time range

endtime
string <date-time>

End time of the time range

from
integer

Start offset if paging through results

limit
integer

Display the last X events

object (NodeEventMatch)
object (NodeEventMatch)
startage
string

Start age relative to now of the time range

starttime
string <date-time>

Start time of the time range

Responses

Request samples

Content type
application/json
{
  • "allowedorgs": [
    ],
  • "endage": "string",
  • "endtime": "2019-08-24T14:15:22Z",
  • "from": 0,
  • "limit": 0,
  • "match": {
    },
  • "notmatch": {
    },
  • "startage": "string",
  • "starttime": "2019-08-24T14:15:22Z"
}

Response samples

Content type
application/json
[
  • {
    }
]

ShowEvents

Show events and audit events

Authorizations:
bearerAuth
Request Body schema: application/json
allowedorgs
Array of strings or null

Organizations allowed to access the event

endage
string

End age relative to now of the time range

endtime
string <date-time>

End time of the time range

from
integer

Start offset if paging through results

limit
integer

Display the last X events

object (NodeEventMatch)
object (NodeEventMatch)
startage
string

Start age relative to now of the time range

starttime
string <date-time>

Start time of the time range

Responses

Request samples

Content type
application/json
{
  • "allowedorgs": [
    ],
  • "endage": "string",
  • "endtime": "2019-08-24T14:15:22Z",
  • "from": 0,
  • "limit": 0,
  • "match": {
    },
  • "notmatch": {
    },
  • "startage": "string",
  • "starttime": "2019-08-24T14:15:22Z"
}

Response samples

Content type
application/json
[
  • {
    }
]

EventTerms

Show aggregated events terms

Authorizations:
bearerAuth
Request Body schema: application/json
allowedorgs
Array of strings or null

Organizations allowed to access the event

endage
string

End age relative to now of the time range

endtime
string <date-time>

End time of the time range

from
integer

Start offset if paging through results

limit
integer

Display the last X events

object (NodeEventMatch)
object (NodeEventMatch)
startage
string

Start age relative to now of the time range

starttime
string <date-time>

Start time of the time range

Responses

Request samples

Content type
application/json
{
  • "allowedorgs": [
    ],
  • "endage": "string",
  • "endtime": "2019-08-24T14:15:22Z",
  • "from": 0,
  • "limit": 0,
  • "match": {
    },
  • "notmatch": {
    },
  • "startage": "string",
  • "starttime": "2019-08-24T14:15:22Z"
}

Response samples

Content type
application/json
{
  • "names": [
    ],
  • "orgs": [
    ],
  • "regions": [
    ],
  • "tagkeys": [
    ],
  • "types": [
    ]
}

DeveloperUsage

Usage details of App/Cluster.

AlertReceiver

Manage receiver for alerts from edge services.

CreateAlertReceiver

Create an alert receiver

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoAppInstKey)
object (EdgeprotoAppKey)
object (EdgeprotoClusterKey)
Email
string

Custom receiving email

Name
string

Receiver Name

PagerDutyApiVersion
string

PagerDuty API version

PagerDutyIntegrationKey
string

PagerDuty integration key

Region
string

Region for the alert receiver

Severity
string

Alert severity filter

SlackChannel
string

Custom slack channel

SlackWebhook
string

Custom slack webhook

Type
string

Receiver type. Eg. email, slack, pagerduty

User
string

User that created this receiver

Responses

Request samples

Content type
application/json
{
  • "AppInstKey": {
    },
  • "AppKey": {
    },
  • "ClusterKey": {
    },
  • "Email": "string",
  • "Name": "string",
  • "PagerDutyApiVersion": "string",
  • "PagerDutyIntegrationKey": "string",
  • "Region": "string",
  • "Severity": "string",
  • "SlackChannel": "string",
  • "SlackWebhook": "string",
  • "Type": "string",
  • "User": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

DeleteAlertReceiver

Delete an alert receiver

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoAppInstKey)
object (EdgeprotoAppKey)
object (EdgeprotoClusterKey)
Email
string

Custom receiving email

Name
string

Receiver Name

PagerDutyApiVersion
string

PagerDuty API version

PagerDutyIntegrationKey
string

PagerDuty integration key

Region
string

Region for the alert receiver

Severity
string

Alert severity filter

SlackChannel
string

Custom slack channel

SlackWebhook
string

Custom slack webhook

Type
string

Receiver type. Eg. email, slack, pagerduty

User
string

User that created this receiver

Responses

Request samples

Content type
application/json
{
  • "AppInstKey": {
    },
  • "AppKey": {
    },
  • "ClusterKey": {
    },
  • "Email": "string",
  • "Name": "string",
  • "PagerDutyApiVersion": "string",
  • "PagerDutyIntegrationKey": "string",
  • "Region": "string",
  • "Severity": "string",
  • "SlackChannel": "string",
  • "SlackWebhook": "string",
  • "Type": "string",
  • "User": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

ShowAlertReceiver

Show alert receivers

Authorizations:
bearerAuth
Request Body schema: application/json
object (EdgeprotoAppInstKey)
object (EdgeprotoAppKey)
object (EdgeprotoClusterKey)
Email
string

Custom receiving email

Name
string

Receiver Name

PagerDutyApiVersion
string

PagerDuty API version

PagerDutyIntegrationKey
string

PagerDuty integration key

Region
string

Region for the alert receiver

Severity
string

Alert severity filter

SlackChannel
string

Custom slack channel

SlackWebhook
string

Custom slack webhook

Type
string

Receiver type. Eg. email, slack, pagerduty

User
string

User that created this receiver

Responses

Request samples

Content type
application/json
{
  • "AppInstKey": {
    },
  • "AppKey": {
    },
  • "ClusterKey": {
    },
  • "Email": "string",
  • "Name": "string",
  • "PagerDutyApiVersion": "string",
  • "PagerDutyIntegrationKey": "string",
  • "Region": "string",
  • "Severity": "string",
  • "SlackChannel": "string",
  • "SlackWebhook": "string",
  • "Type": "string",
  • "User": "string"
}

Response samples

Content type
application/json
[
  • {
    }
]

Federation

Manage Federation Applications and Images

DeboardGuestApp

Remove App from partner federation

Authorizations:
bearerAuth
Request Body schema: application/json
AppName
string

App name in region

AppOrg
string

App org in region

AppVers
string

App version in region

FederationName
string

Target Guest Federation name

ID
string

Unique ID, acts as both the App and Artefact IDs

ImageIds
Array of strings or null (PqStringArray)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "AppName": "string",
  • "AppOrg": "string",
  • "AppVers": "string",
  • "FederationName": "string",
  • "ID": "string",
  • "ImageIds": [
    ],
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

OnboardGuestApp

Onboard existing App to partner federation

Authorizations:
bearerAuth
Request Body schema: application/json
AppName
string

App name in region

AppOrg
string

App org in region

AppVers
string

App version in region

FederationName
string

Target Guest Federation name

ID
string

Unique ID, acts as both the App and Artefact IDs

ImageIds
Array of strings or null (PqStringArray)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "AppName": "string",
  • "AppOrg": "string",
  • "AppVers": "string",
  • "FederationName": "string",
  • "ID": "string",
  • "ImageIds": [
    ],
  • "Region": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

ShowGuestApp

Show Apps onboarded to partner federation

Authorizations:
bearerAuth
Request Body schema: application/json
AppName
string

App name in region

AppOrg
string

App org in region

AppVers
string

App version in region

FederationName
string

Target Guest Federation name

ID
string

Unique ID, acts as both the App and Artefact IDs

ImageIds
Array of strings or null (PqStringArray)
Region
string

Region name

Responses

Request samples

Content type
application/json
{
  • "AppName": "string",
  • "AppOrg": "string",
  • "AppVers": "string",
  • "FederationName": "string",
  • "ID": "string",
  • "ImageIds": [
    ],
  • "Region": "string"
}

Response samples

Content type
application/json
[
  • {
    }
]

CreateGuestImage

Create image on partner federation

Authorizations:
bearerAuth
Request Body schema: application/json
Checksum
string

MD5 checksum for VM and file-based image types, sha256 digest for containers and Helm charts

FederationName
string

Federation the image is copied to (FederationGuest)

ID
string

ID

Name
string

Image name

Organization
string

Developer organization that owns the image

SourcePath
string

Full path to source image as used in App, i.e. https://vm-registry.domain/org/image.img

Type
string

Image type (DOCKER, HELM, QCOW2, or OVA)

Version
string

Image version

Responses

Request samples

Content type
application/json
{
  • "Checksum": "string",
  • "FederationName": "string",
  • "ID": "string",
  • "Name": "string",
  • "Organization": "string",
  • "SourcePath": "string",
  • "Type": "string",
  • "Version": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

DeleteGuestImage

Delete image from partner federation

Authorizations:
bearerAuth
Request Body schema: application/json
Checksum
string

MD5 checksum for VM and file-based image types, sha256 digest for containers and Helm charts

FederationName
string

Federation the image is copied to (FederationGuest)

ID
string

ID

Name
string

Image name

Organization
string

Developer organization that owns the image

SourcePath
string

Full path to source image as used in App, i.e. https://vm-registry.domain/org/image.img

Type
string

Image type (DOCKER, HELM, QCOW2, or OVA)

Version
string

Image version

Responses

Request samples

Content type
application/json
{
  • "Checksum": "string",
  • "FederationName": "string",
  • "ID": "string",
  • "Name": "string",
  • "Organization": "string",
  • "SourcePath": "string",
  • "Type": "string",
  • "Version": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string"
}

ShowGuestImage

Show images on partner federation

Authorizations:
bearerAuth
Request Body schema: application/json
Checksum
string

MD5 checksum for VM and file-based image types, sha256 digest for containers and Helm charts

FederationName
string

Federation the image is copied to (FederationGuest)

ID
string

ID

Name
string

Image name

Organization
string

Developer organization that owns the image

SourcePath
string

Full path to source image as used in App, i.e. https://vm-registry.domain/org/image.img

Type
string

Image type (DOCKER, HELM, QCOW2, or OVA)

Version
string

Image version

Responses

Request samples

Content type
application/json
{
  • "Checksum": "string",
  • "FederationName": "string",
  • "ID": "string",
  • "Name": "string",
  • "Organization": "string",
  • "SourcePath": "string",
  • "Type": "string",
  • "Version": "string"
}

Response samples

Content type
application/json
[
  • {
    }
]

ShowFederation

Show federations for App deployment

Authorizations:
bearerAuth
Request Body schema: application/json
AutoRegisterRegion
string

Region used for automatically registered zones

AutoRegisterZones
boolean

Automatically register any zone shared with me

FederationContextId
string

Federation context id returned by partner

ID
integer >= 0

Unique ID

object (OrmapiFederator)
Name
string

Unique name of this Federation Guest, will be used as an operator org for host's zones

NotifyClientId
string

Auth ClientId for notify callbacks to this Guest OP

OperatorId
string

Operator Organization that establishes the federation with a Host OP

PartnerAddr
string

Partner Address

object (OrmapiFederator)
PartnerTokenUrl
string

Partner token URL

ProviderClientId
string

Auth ClientId for connecting to the Host OP

ProviderClientKey
string

Auth ClientKey for connection to the Host OP (stored in secret storage)

Public
boolean

Public means any developer will be able to use the cloudlets, otherwise (TODO) allowed developers will need to be added explicitly

Responses

Request samples

Content type
application/json
{
  • "AutoRegisterRegion": "string",
  • "AutoRegisterZones": true,
  • "FederationContextId": "string",
  • "ID": 0,
  • "MyInfo": {
    },
  • "Name": "string",
  • "NotifyClientId": "string",
  • "OperatorId": "string",
  • "PartnerAddr": "string",
  • "PartnerInfo": {
    },
  • "PartnerTokenUrl": "string",
  • "ProviderClientId": "string",
  • "ProviderClientKey": "string",
  • "Public": true
}

Response samples

Content type
application/json
[
  • {
    }
]