Querying Template Details
Function
This API is used to query template details.
Calling Method
For details, see Calling APIs.
URI
GET /v5/{tenant_id}/api/pipeline-templates/{template_id}
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
tenant_id |
Yes |
String |
Definition: Tenant ID. Constraints: N/A Value range: The value consists of 32 characters, including digits and letters. Default value: N/A |
template_id |
Yes |
String |
Definition: Template ID, which is the unique identifier of a template. Obtain the template ID by calling the API for querying templates. templates.id indicates the template ID. Constraints: N/A Value range: The value consists of 32 characters, including digits and letters. Default value: N/A |
Request Parameters
None
Response Parameters
Status code: 200
Parameter |
Type |
Description |
---|---|---|
id |
String |
Definition: Template ID. Value range: The value consists of 32 characters, including digits and letters. |
name |
String |
Parameter description: Template name. Value range: None. |
icon |
String |
Parameter description: Template icon. Value range: None. |
manifest_version |
String |
Parameter description: Version. Value range: The default value is 3.0. |
language |
String |
Definition: Template language. Value range:
|
description |
String |
Parameter description: Template description. Value range: None. |
is_system |
Boolean |
Definition: Whether the template is a system template. Value range:
|
region |
String |
Parameter description: Template region. Value range: None. |
domain_id |
String |
Definition: ID of the tenant to which the template belongs. Value range: The value consists of 32 characters, including digits and letters. |
variables |
Array of CustomVariable objects |
Definition: Custom parameter. Constraints: N/A Value range: N/A Default value: N/A |
creator_id |
String |
Definition: Template creator ID. Value range: The value consists of 32 characters, including digits and letters. |
updater_id |
String |
Definition: Template updater ID. Value range: The value consists of 32 characters, including digits and letters. |
create_time |
Integer |
Parameter description: Creation time. Value range: None. |
update_time |
Integer |
Parameter description: Update time. Value range: None. |
is_collect |
String |
Definition: Whether to add the object to favorites. Value range:
|
is_show_source |
Boolean |
Definition: Whether to display the pipeline source. Value range:
|
definition |
String |
Definition: Template orchestration JSON file, including stages. Value range: N/A |
Parameter |
Type |
Description |
---|---|---|
pipeline_id |
String |
Definition: Pipeline ID. Obtain the ID by calling the API for querying pipelines. pipelines.pipelineId indicates the pipeline ID. Constraints: N/A Value range: The value consists of 32 characters, including digits and letters. Default value: N/A |
name |
String |
Definition: Custom parameter name. Constraints: N/A Value range: Enter a maximum of 128 characters. Only letters, digits, and underscores (_) are supported. Default value: N/A |
sequence |
Integer |
Parameter description: Parameter sequence number, which starts from 1. Constraints: None. Value range: None. Default value: None. |
type |
String |
Definition: Custom parameter type. Constraints: N/A Value range:
Default value: N/A |
value |
String |
Parameter description: Default value of a custom parameter. Constraints: None. Value range: Up to 8192 characters. Default value: None. |
is_secret |
Boolean |
Definition: Private parameter or not. Constraints: N/A Value range:
Default value: false. |
description |
String |
Parameter description: Parameter description. Constraints: None. Value range: Up to 1024 characters. Default value: None. |
is_runtime |
Boolean |
Definition: Whether a parameter can be set at runtime. Constraints: N/A Value range:
Default value: false. |
limits |
Array of objects |
Parameter description: List of enumerated values. Constraints: None. Value range: Up to 1,024 characters. Default value: None. |
is_reset |
Boolean |
Definition: Whether to reset. If the auto-increment parameter is edited, the edited value is used. Otherwise, the last digit increases. Constraints: N/A Value range:
Default value: false. |
latest_value |
String |
Definition: Value of the parameter in the last run. Constraints: N/A Value range: Max. 8,192 characters. Default value: N/A |
runtime_value |
String |
Definition: Input value of a parameter when the pipeline is executed. Constraints: N/A Value range: N/A Default value: N/A |
Status code: 400
Parameter |
Type |
Description |
---|---|---|
error_msg |
String |
Parameter description: Error message. Value range: N/A |
error_code |
String |
Parameter description: Error code. Value range: N/A |
Example Requests
Querying Pipeline Template Details
GET https://{endpoint}/v5/a5f63758220947b7821e70ae2734c01d/api/pipeline-templates/deb18013bb6c4659b160b15fd7468644
Example Responses
Status code: 200
OK
{ "id" : "deb18013bb6c4659b160b15fd7468644", "name" : "Creating a Pipeline Template-20230112115711", "icon" : null, "manifest_version" : "3.0", "language" : "none", "description" : "", "is_system" : false, "region" : "{region}", "domain_id" : "70ffec613024477bbaf266128bd9778d", "variables" : [ ], "creator_id" : "5ffd41c9df9d4506862ce27e209bb106", "updater_id" : "5ffd41c9df9d4506862ce27e209bb106", "create_time" : 1673495851000, "update_time" : 1673495851000, "is_collect" : null, "is_show_source" : true, "definition" : "{\"stages\":[{\"name\":\"Phase _1\",\"sequence\":\"0\",\"jobs\":[{\"stage_id\":1673495831907,\"identifier\":\"16734958501367554c26c-561b-4831-a906-e88316c8e674\",\"name\": \"New Task\",\"depends_on\":[] ,\"timeout\":\"\",\"timeout_unit\":\"\",\"steps\":[],\"exec_type\":\"AGENTLESS_JOB\",\"sequence\":0}],\"identifier\":\"0\",\"pre\":[{\"task\":\"official_devcloud_autoTrigger\",\"sequence\":0}],\"post\":null,\"depends_on\":[],\"run_always\":false}]}" }
Status Codes
Status Code |
Description |
---|---|
200 |
OK |
400 |
Bad request |
401 |
Unauthorized |
403 |
Forbidden |
404 |
Not Found |
Error Codes
See Error Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot