Update App

Update App

Updates a specific app. When package info for the specified container app has been updated, this API will response 202 with task URL in location header. Otherwise this API returns 200.

Request
URI
PUT
https://{api_host}/cloudapi/1.0.0/apps/{id}
COPY
Path Parameters
string
id
Required

id

string
id
Required

id

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
200

OK

Returns App of type(s) application/json;version=38.0 
{
    "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


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) application/json;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