Create App

Create App

Creates a new App in the provided organization. If appType is VmApp, then this method throws 400 BadRequest exception. VM based apps cannot be created using this API.

Request
URI
POST
https://{api_host}/cloudapi/1.0.0/apps
COPY
Request Body
App of type(s) application/json
Optional 
{
    "appType": "string",
    "id": "string",
    "appTemplateId": "string",
    "appId": "string",
    "appVersion": "string",
    "name": "string",
    "description": "string",
    "creationDate": "string",
    "status": "READY, FAILED, NOT_READY",
    "logoUrl": "string",
    "screenshotUrls": [
        "string"
    ],
    "owner": {
        "name": "string",
        "id": "string"
    },
    "org": {
        "name": "string",
        "id": "string"
    },
    "vdc": {
        "name": "string",
        "id": "string"
    }
}
string
appType
Required

Type of application. This is a discriminator field that helps in distinguishing the type of app this object represents. If the app is running in Kubernetes cluster, the value of this field is ContainerApp. If the app is running in a virtual machine or a collection of virtual machines then this the value of this field is VmApp.

string
id
Optional

A unique identifier for the app.

string
appTemplateId
Optional

An identifier to the appTemplate from which this app is created.

string
appId
Required

An identifier by which this application is uniquely identified in its source catalog.

string
appVersion
Required

Version of this application.

string
name
Required

The name of the app. If the app is ContainerApp, the value of this field must consist of lowercase alphanumeric characters or '-', start with an alphabetic character, and end with an alphanumeric character.

string
description
Optional

The description of the app.

string As date-time As date-time
creationDate
Optional

The date and time when this app was created. This value will be formatted as per ISO 8601 format and include timezone information.

string
status
Optional

Status indicating whether this app is ready or not.

string
logoUrl
Optional

URL of the logo of this application.

array of string
screenshotUrls
Optional

List of screenshot URLs of the App.

EntityReference
owner
Optional

owner

EntityReference
org
Required

org

EntityReference
vdc
Optional

vdc

Authentication
This operation uses the following authentication methods.
Responses
202

The request have been accepted and the task to monitor the request is in the Location header.

Operation doesn't return any data structure

400

Invalid configuration.

Returns Error of type(s) */*;version=38.0 
{
    "minorErrorCode": "string",
    "message": "string",
    "stackTrace": "string"
}
string
minorErrorCode
Required

minorErrorCode

string
message
Required

message

string
stackTrace
Optional

stackTrace


Availability
Added in 39.0.0-alpha
On This Page
App Operations
POST
Create App
DELETE
Delete App
GET
Get App
GET
Get Custom Values
GET
Query Apps
GET
Query Kubernetes Resources
PUT
Update App
PUT
Update Custom Values
PUT
Update Kubernetes Resources