Get App

Get App

Retrieves a specific app via its URN.

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

id


Authentication
This operation uses the following authentication methods.
Responses
200

OK

Returns App of type(s) application/json;version=39.1
{
    "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"
    },
    "eulaAccepted": false
}
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
Constraints: maxLength: 128

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
Constraints: maxLength: 256

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
Constraints: maxItems: 10

List of screenshot URLs of the App.

object
owner
Optional

Entity reference used to describe VCD entities

object
org
Required

Entity reference used to describe VCD entities

object
vdc
Optional

Entity reference used to describe VCD entities

boolean
eulaAccepted
Optional

Accepts EULA for the application version this App is launched from. If one application is protected by EULA, app creation, upgrade and downgrade requires to accept the EULA for the target application version.


Code Samples
COPY
                    curl -H 'Authorization: <value>' https://{api_host}/cloudapi/1.0.0/apps/{id}