Help Center> Cloud Phone Host> API Reference> APIs for Cloud Mobile Gaming Management> Application Version Management> Creating an Application Version
View PDF

Creating an Application Version

Function Description

  • API Name

    CreateAppVersion

  • Function

    Create an application version. A single tenant can create a maximum of 100,000 application versions.

URI

POST /v1/{project_id}/cloud-phone/app-versions

For details, see Table 1.
Table 1 Parameter description

Parameter

Mandatory

Type

Description

project_id

Yes

String

Specifies the project ID.

For details about how to obtain the project ID, see Obtaining a Project ID.

Request

  • Request parameters

    Parameter

    Mandatory

    Type

    Description

    app_id

    Yes

    String

    Specifies the unique ID of an application.

    version_code

    Yes

    String

    Specifies the main version number of an application version.

    The main version number is unique within the application and contains a maximum of 64 characters. Only uppercase letters, lowercase letters, digits, periods (.), underscores (_), and hyphens (-) are allowed.

    version_name

    Yes

    String

    Specifies the application version name.

    The value can contain a maximum of 64 characters, including only uppercase letters, lowercase letters, digits, periods (.), underscores (_), and hyphens (-).

    launch_activity

    Yes

    String

    Specifies the application startup path.

    The value can contain a maximum of 256 characters, including uppercase letters, lowercase letters, digits, periods (.), underscores (_), and hyphens (-).

    bucket_name

    Yes

    String

    Specifies the name of the bucket where the application version file is stored.

    A valid OBS bucket name contains 3 to 63 characters, including only lowercase letters, digits, hyphens (-), and periods (.).

    object_path

    Yes

    String

    Specifies the path of the application version file in the bucket, which must be a .tar package.

    A valid OBS path can contain a maximum of 1024 characters.
  • Example request 
    1
2
3
4
5
6
7
8
9
    		 
    POST https://{CPH Endpoint}/v1/{project_id}/cloud-phone/app-versions
{
    "app_id": "88b8449b896f3a4f0ad57222dd9190b",
    "version_code": "2100000000",
    "version_name": "1.1.0",
    "launch_activity": "com.xxx.path.main_activity",
    "bucket_name": "",
    "object_path": "pushfiletest/qjz/com.dygame.hyrj.dayu.tar"
}

Response

  • Response parameters

    Parameter

    Type

    Description

    request_id

    String

    Specifies the request ID, which is unique.

    app_version_id

    String

    Specifies the unique ID of the application version.
  • Example response 
    {
    "request_id": "6837531fd3f54550927b930180a706bf",
    "app_version_id": "1564567b8bab40f34711234cb80d0123"
}

Returned Values

See Returned Values.

Error Codes

See Error Codes.