Obtaining Application Details (Recommended)_Managing Applications_APIs_API Reference

Function

This API is used to obtain application details by ID.

Calling Method

For details, see Calling APIs.

URI

GET /v1/applications/{app_id}/info

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
app_id	Yes	String	Parameter description: Application ID. Constraints: N/A Value range: The value consists of 32 characters. Only letters and digits are allowed. Default value: N/A

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	Definition: User token. Obtain a token (the value of the X-Subject-Token response header) by calling the IAM API used forObtaining a User Token. Constraints: N/A. Value range: String. Max. 20,000 characters. Default value: N/A.

Response Parameters

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
result	AppDetailInfo object	Parameter description: Application details.
status	String	Parameter description: Request success or failure status. Value range: success: Request succeeded error: Request failed

**Table 4** AppDetailInfo
Parameter	Type	Description
id	String	Parameter description: Application ID. Value range: The value consists of 32 characters. Letters and digits are allowed.
name	String	Parameter description: Application name. Value range: The value consists of 3-128 characters. Only letters, digits, hyphens (-) and underscores (_) are allowed.
region	String	Parameter description: Region to which the application belongs. Value range: N/A
description	String	Parameter description: Description. Value range: The value consists of 0-1,024 characters.
is_disable	Boolean	Parameter description: Whether the application is disabled. Value range: true: Disabled false: Not disabled
create_type	String	Parameter description: Creation method. Value range: template: Flexible application orchestration
project_id	String	Parameter description: Project ID. Value range: The value consists of 32 characters. Letters and digits are allowed.
project_name	String	Parameter description: Project name. Value range: The value consists of 3 to 128 characters.
slave_cluster_id	String	Definition: Slave cluster ID. It is empty by default. When it is empty, the default agent pool is used. Value range: 1 to 32 characters, including letters and digits. null is also supported.
is_care	Boolean	Definition: Whether you have favorited the application. Value range: true: Yes. false: No.
can_modify	Boolean	Definition: Whether you have the edit permission. Value range: true: Yes. false: No.
can_delete	Boolean	Definition: Whether you have the delete permission. Value range: true: Yes. false: No.
can_view	Boolean	Definition: Whether you have the view permission. Value range: true: Yes. false: No.
can_execute	Boolean	Definition: Whether you have the deployment permission. Value range: true: Yes. false: No.
can_copy	Boolean	Definition: Whether you have the copy permission. Value range: true: Yes. false: No.
can_manage	Boolean	Definition: Whether you have permission to edit the application permission matrix. Value range: true: Yes. false: No.
can_create_env	Boolean	Definition: Whether you have permission to create an environment. Value range: true: Yes. false: No.
can_disable	Boolean	Definition: Whether you have permission to disable applications. Value range: true: Yes. false: No.
owner_tenant_id	String	Parameter description: Tenant ID of the application owner. Value range: The value consists of 1-32 characters. Letters and digits are allowed.
create_user_id	String	Parameter description: ID of the application creator. Value range: The value consists of 1-32 characters. Letters and digits are allowed.
create_tenant_id	String	Parameter description: Tenant ID of the application creator. Value range: The value consists of 1-32 characters. Letters and digits are allowed.
create_time	String	Parameter description: Creation time. The value format is yyyy-MM-dd HH:mm:ss. For example, 2021-02-25 10:37:27. Value range: N/A
update_time	String	Parameter description: Modification time. The value format is yyyy-MM-dd HH:mm:ss. For example, 2021-02-25 10:37:27. Value range: N/A
permission_level	String	Parameter description: Application authentication level. Value range: project: Authentication at project level instance: Authentication at instance level
arrange_infos	Array of TaskV2Info objects	Parameter description: Deployment task information.

**Table 5** TaskV2Info
Parameter	Type	Description
id	String	Parameter description: Deployment application ID. Value range: The value consists of 32 characters. Letters and digits are allowed.
name	String	Parameter description: Deployment task name. Value range: The value consists of 3-128 characters. Only letters, digits, hyphens (-) and underscores (_) are allowed.
state	String	Parameter description: Deployment task status. Value range: Available: Executable state Draft: Draft state
description	String	Parameter description: Description. Value range: The value consists of 0-1,024 characters.
owner	String	Parameter description: Deployment application owner. Value range: N/A
steps	Map<String,Step>	Parameter description: Deployment action.
project_id	String	Parameter description: Project ID. Value range: The value consists of 32 characters. Letters and digits are allowed.
project_name	String	Parameter description: Project name. Value range: The value consists of 3 to 128 characters.
deploy_system	String	Parameter description: Deployment mode. Value range: deployTemplate: Deployment template
create_time	String	Parameter description: Creation time. The value format is yyyy-MM-dd HH:mm:ss. For example, 2021-02-25 10:37:27. Value range: N/A
update_time	String	Parameter description: Modification time. The value format is yyyy-MM-dd HH:mm:ss. For example, 2021-02-25 10:37:27. Value range: N/A
role_id	Integer	Definition: Project management role ID. Value range: N/A.
is_defaut_permission	Boolean	Definition: Whether you are the default role of the project management. Value range: true: Yes. false: No.
template_id	String	Parameter description: Template ID. Value range: The value consists of 1-32 characters. Letters and digits are allowed.
nick_name	String	Parameter description: Nickname of the application creator. Value range: The value consists of 0 to 128 characters.
owner_id	String	Parameter description: ID of the application creator. Value range: The value consists of 1-32 characters. Letters and digits are allowed.
tenant_id	String	Parameter description: Tenant ID of the application creator. Value range: The value consists of 1-32 characters. Letters and digits are allowed.
tenant_name	String	Parameter description: Tenant name of the application creator. Value range: The value consists of 0 to 128 characters.
slave_cluster_id	String	Definition: Slave cluster ID. It is empty by default. When it is empty, the default agent pool is used. Value range: 1 to 32 characters, including letters and digits. null is also supported.
is_care	Boolean	Definition: Whether you have favorited the application. Value range: true: Yes. false: No.
can_modify	Boolean	Definition: Whether you have the edit permission. Value range: true: Yes. false: No.
can_delete	Boolean	Definition: Whether you have the delete permission. Value range: true: Yes. false: No.
can_view	Boolean	Definition: Whether you have the view permission. Value range: true: Yes. false: No.
can_execute	Boolean	Definition: Whether you have the deployment permission. Value range: true: Yes. false: No.
can_copy	Boolean	Definition: Whether you have the copy permission. Value range: true: Yes. false: No.
can_manage	Boolean	Definition: Whether you have permission to edit the application permission matrix. Value range: true: Yes. false: No.
can_create_env	Boolean	Definition: Whether you have permission to create an environment. Value range: true: Yes. false: No.
can_disable	Boolean	Definition: Whether you have permission to disable applications. Value range: true: Yes. false: No.
app_component_list	Array of AppComponentDao objects	Parameter description: Application component list.
release_id	Integer	Parameter description: Deployment record sequence number. Value range: N/A
app_id	String	Parameter description: Deployment task ID. Value range: The value consists of 32 characters. Letters and digits are allowed.
is_disable	Boolean	Parameter description: Whether the application is disabled. Value range: true: Disabled false: Not disabled

**Table 6** Step
Parameter	Type	Description
id	String	Parameter description: Action ID. Value range: N/A
name	String	Parameter description: Action name. Value range: N/A
params	Map<String,String>	Parameter description: Action parameter. Value range: N/A
enable	Boolean	Definition: Whether to enable an action. Value range: true: Yes. false: No.

**Table 7** AppComponentDao
Parameter	Type	Description
task_id	String	Parameter description: Deployment application ID. Value range: The value consists of 32 characters. Letters and digits are allowed.
app_id	String	Parameter description: AOM application ID. Value range: The value consists of 32 characters. Letters and digits are allowed.
app_name	String	Parameter description: AOM application name. Value range: The value consists of letters and digits.
comp_id	String	Parameter description: AOM application component ID. Value range: The value consists of 32 characters. Letters and digits are allowed.
comp_name	String	Parameter description: AOM application component name. Value range: The value consists of 0 to 128 characters.
domain_id	String	Parameter description: Tenant ID. Value range: The value consists of 32 characters. Letters and digits are allowed.
region	String	Parameter description: Region information. Value range: The value consists of 1 to 256 characters.
state	String	Parameter description: Whether the AOM application component takes effect. Value range: 0: Initialized. 1: The operation is successful and takes effect.

Status code: 400

**Table 8** Response body parameters
Parameter	Type	Description
error_code	String	Error code
error_msg	String	Error description

Status code: 403

**Table 9** Response body parameters
Parameter	Type	Description
error_code	String	Error code
error_msg	String	Error description

Example Requests

https://{endpoint}/v1/applications/d2dc947ec2424d8789bb3984bb3adf45/info

Example Responses

Status code: 200

OK: The request is successful.

{
  "result" : {
    "id" : "d9e0532073e2475dbed64b22e64f3b26",
    "name" : "deployenv202308211530723",
    "region" : "example.com",
    "description" : "for_test",
    "is_disable" : true,
    "create_type" : "template",
    "project_id" : "1ff8aa6dda4643bd9cbdbb588fb24bde",
    "project_name" : "Test Item",
    "slave_cluster_id" : null,
    "is_care" : false,
    "can_modify" : true,
    "can_delete" : true,
    "can_view" : true,
    "can_execute" : true,
    "can_copy" : true,
    "can_manage" : true,
    "can_create_env" : true,
    "can_disable" : true,
    "owner_tenant_id" : "208fbb09068e4820b9209ef9ff4da73d",
    "create_user_id" : "6baa7454109d47c192f22078fe6cda20",
    "create_tenant_id" : "26a680dd72e7482eb60d2ef5513588bb",
    "create_time" : "2023-08-21 15:30:51.0",
    "update_time" : "2023-08-21 15:30:51.0",
    "permission_level" : "instance",
    "arrange_infos" : [ {
      "id" : "685a6f3b80264e7d96f2ba308f8414e5",
      "name" : "deployenv202308211530723",
      "state" : "Draft",
      "description" : "for_test",
      "owner" : "devcloud_devcloud_l00490255_01",
      "steps" : {
        "step1" : {
          "id" : null,
          "name" : "Install Go",
          "params" : { },
          "enable" : true
        },
        "step2" : {
          "id" : null,
          "name" : "Download Software Package",
          "params" : { },
          "enable" : true
        },
        "step3" : {
          "id" : null,
          "name" : "Stop Go Service",
          "params" : { },
          "enable" : true
        },
        "step4" : {
          "id" : null,
          "name" : "Start Go Service",
          "params" : { },
          "enable" : true
        },
        "step5" : {
          "id" : null,
          "name" : "Test Service",
          "params" : { },
          "enable" : true
        }
      },
      "project_id" : "1ff8aa6dda4643bd9cbdbb588fb24bde",
      "project_name" : "Test Item",
      "deploy_system" : "deployTemplate",
      "create_time" : "2023-08-21 15:30:51",
      "update_time" : "2023-08-21 15:30:51",
      "role_id" : 0,
      "is_defaut_permission" : false,
      "template_id" : "681bd91f9d6e42cdb4cb84d6718de9fe",
      "nick_name" : "Alias",
      "owner_id" : "6baa7454109d47c192f22078fe6cda20",
      "tenant_id" : "26a680dd72e7482eb60d2ef5513588bb",
      "tenant_name" : "devcloud_devcloud_l00490255_01",
      "slave_cluster_id" : null,
      "is_care" : false,
      "can_modify" : true,
      "can_delete" : true,
      "can_view" : true,
      "can_execute" : true,
      "can_copy" : true,
      "can_manage" : true,
      "can_create_env" : false,
      "can_disable" : false,
      "app_component_list" : [ ],
      "release_id" : 0,
      "app_id" : "d9e0532073e2475dbed64b22e64f3b26",
      "is_disable" : true
    } ]
  },
  "status" : "success"
}

Status code: 400

Bad Request

{
  "error_code" : "Deploy.00015002",
  "error_msg" : "Invalid request parameter."
}

Status code: 403

Forbidden

{
  "error_code" : "Deploy.00011154",
  "error_msg" : "You do not have permissions to perform this operation."
}

SDK Sample Code

The SDK sample code is as follows.

Java

    
     
       
       
         package com.huaweicloud.sdk.test;

import com.huaweicloud.sdk.core.auth.ICredential;
import com.huaweicloud.sdk.core.auth.BasicCredentials;
import com.huaweicloud.sdk.core.exception.ConnectionException;
import com.huaweicloud.sdk.core.exception.RequestTimeoutException;
import com.huaweicloud.sdk.core.exception.ServiceResponseException;
import com.huaweicloud.sdk.codeartsdeploy.v2.region.CodeArtsDeployRegion;
import com.huaweicloud.sdk.codeartsdeploy.v2.*;
import com.huaweicloud.sdk.codeartsdeploy.v2.model.*;


public class ShowAppDetailByIdSolution {

    public static void main(String[] args) {
        // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
        // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
        String ak = System.getenv("CLOUD_SDK_AK");
        String sk = System.getenv("CLOUD_SDK_SK");

        ICredential auth = new BasicCredentials()
                .withAk(ak)
                .withSk(sk);

        CodeArtsDeployClient client = CodeArtsDeployClient.newBuilder()
                .withCredential(auth)
                .withRegion(CodeArtsDeployRegion.valueOf("<YOUR REGION>"))
                .build();
        ShowAppDetailByIdRequest request = new ShowAppDetailByIdRequest();
        request.withAppId("{app_id}");
        try {
            ShowAppDetailByIdResponse response = client.showAppDetailById(request);
            System.out.println(response.toString());
        } catch (ConnectionException e) {
            e.printStackTrace();
        } catch (RequestTimeoutException e) {
            e.printStackTrace();
        } catch (ServiceResponseException e) {
            e.printStackTrace();
            System.out.println(e.getHttpStatusCode());
            System.out.println(e.getRequestId());
            System.out.println(e.getErrorCode());
            System.out.println(e.getErrorMsg());
        }
    }
}

        

      

    
   

Python

    
     
       
       
         # coding: utf-8

import os
from huaweicloudsdkcore.auth.credentials import BasicCredentials
from huaweicloudsdkcodeartsdeploy.v2.region.codeartsdeploy_region import CodeArtsDeployRegion
from huaweicloudsdkcore.exceptions import exceptions
from huaweicloudsdkcodeartsdeploy.v2 import *

if __name__ == "__main__":
    # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak = os.environ["CLOUD_SDK_AK"]
    sk = os.environ["CLOUD_SDK_SK"]

    credentials = BasicCredentials(ak, sk)

    client = CodeArtsDeployClient.new_builder() \
        .with_credentials(credentials) \
        .with_region(CodeArtsDeployRegion.value_of("<YOUR REGION>")) \
        .build()

    try:
        request = ShowAppDetailByIdRequest()
        request.app_id = "{app_id}"
        response = client.show_app_detail_by_id(request)
        print(response)
    except exceptions.ClientRequestException as e:
        print(e.status_code)
        print(e.request_id)
        print(e.error_code)
        print(e.error_msg)

        

      

    
   

Go

    
     
       
       
         package main

import (
	"fmt"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic"
    codeartsdeploy "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/codeartsdeploy/v2"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/services/codeartsdeploy/v2/model"
    region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/codeartsdeploy/v2/region"
)

func main() {
    // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak := os.Getenv("CLOUD_SDK_AK")
    sk := os.Getenv("CLOUD_SDK_SK")

    auth := basic.NewCredentialsBuilder().
        WithAk(ak).
        WithSk(sk).
        Build()

    client := codeartsdeploy.NewCodeArtsDeployClient(
        codeartsdeploy.CodeArtsDeployClientBuilder().
            WithRegion(region.ValueOf("<YOUR REGION>")).
            WithCredential(auth).
            Build())

    request := &model.ShowAppDetailByIdRequest{}
	request.AppId = "{app_id}"
	response, err := client.ShowAppDetailById(request)
	if err == nil {
        fmt.Printf("%+v\n", response)
    } else {
        fmt.Println(err)
    }
}

        

      

    
   

More

For SDK sample code of more programming languages, see the Sample Code tab in API Explorer. SDK sample code can be automatically generated.

Status Codes

Status Code	Description
200	OK: The request is successful.
400	Bad Request
403	Forbidden

Error Codes

See Error Codes.

Obtaining Application Details (Recommended)