Updated on 2026-01-12 GMT+08:00

Querying the Basic Extension Details

Function

This API is used to query the basic extension details.

Calling Method

For details, see Calling APIs.

URI

GET /v3/{domain_id}/extension/detail

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

domain_id

Yes

String

Definition:

Tenant ID, that is, domain ID of a user.

Constraints:

N/A

Range:

The value consists of 32 characters, including digits and letters.

Default value:

N/A

Table 2 Query Parameters

Parameter

Mandatory

Type

Description

plugin_name

Yes

String

Definition:

Extension name.

Constraints:

N/A

Value range:

N/A

Default value:

N/A

version

Yes

String

Definition:

Extension version.

Constraints:

N/A

Value range:

N/A

Default value:

N/A

Request Parameters

Table 3 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 for .

Constraints:

N/A

Value range:

N/A

Default value:

N/A

Response Parameters

Status code: 200

Table 4 Response body parameters

Parameter

Type

Description

type

String

Definition:

Extension type.

Value range:

N/A

name

String

Definition:

Extension name.

Value range:

N/A

friendly_name

String

Definition:

Displayed extension name.

Value range:

N/A

category

String

Definition:

Service type.

Value range:

N/A

description

String

Definition:

Extension description.

Value range:

N/A

version

String

Definition:

Extension version.

Value range:

N/A

version_description

String

Definition:

Extension version description.

Value range:

N/A

inputs

Array of inputs objects

Definition:

Input information.

Value range:

N/A

data_source_bindings

Array of data_source_bindings objects

Definition:

Data source information.

Value range:

N/A

outputs

Array of outputs objects

Definition:

Output information.

Value range:

N/A

execution

execution object

Definition:

Extension type.

Value range:

N/A

Table 5 inputs

Parameter

Type

Description

name

String

Definition:

Name.

Value range:

N/A

type

String

Definition:

Type.

Value range:

N/A

label

String

Definition:

Label.

Value range:

N/A

description

String

Definition:

Description.

Value range:

N/A

default_value

String

Definition:

Default value.

Value range:

N/A

required

Boolean

Definition:

Mandatory or not.

Value range:

  • true: mandatory.

  • false: optional.

extend_prop

ExtensionExtendProp object

Definition:

Extended attributes.

Value range:

N/A

validation

ExtensionValidation object

Definition:

Verification details.

Value range:

N/A

Table 6 ExtensionExtendProp

Parameter

Type

Description

api_options

String

Definition:

API option.

Value range:

N/A

api_type

String

Definition:

API type.

Value range:

N/A

show_placeholder

String

Definition:

Placeholder.

Value range:

N/A

options

String

Definition:

Option.

Value range:

N/A

disabled_conditions

String

Definition:

Conditions for disabling an extension.

Value range:

N/A

visible_conditions

String

Definition:

Visible condition.

Value range:

N/A

Table 7 ExtensionValidation

Parameter

Type

Description

required_message

String

Definition:

Message displayed when the extension input item is mandatory but is not set.

Value range:

N/A

regex

String

Definition:

Regular expression used to verify the extension input value.

Value range:

N/A

regex_message

String

Definition:

Message displayed when the value of an extension input item does not meet the regular expression requirement.

Value range:

N/A

max_length

Integer

Definition:

Maximum length of an extension input value.

Value range:

N/A

min_length

Integer

Definition:

Minimum length of an extension input value.

Value range:

N/A

Table 8 data_source_bindings

Parameter

Type

Description

target

String

Definition:

Destination address.

Value range:

N/A

endpointId

String

Definition:

Endpoint ID.

Value range:

N/A

data_source_name

String

Definition:

Name of the bound data source.

Value range:

N/A

Table 9 outputs

Parameter

Type

Description

name

String

Definition:

Name.

Value range:

N/A

type

String

Definition:

Type.

Value range:

N/A

description

String

Definition:

Description.

Value range:

N/A

prop

Map<String,String>

Definition:

Extended information.

Value range:

N/A

Table 10 execution

Parameter

Type

Description

target

String

Definition:

Location of the executable file.

Value range:

N/A.

type

String

Definition:

Extension type.

Value range:

N/A

sha256

String

Definition:

SHA-256.

Value range:

N/A

Status code: 400

Table 11 Response body parameters

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

GET https://{endpoint}/v3/ce8df55870164338a72d7e828a966a2a/extension/detail?plugin_name=basic-CTS&version=2.3.5

Example Responses

Status code: 200

OK

{
  "type" : "Task",
  "name" : "basic-CTS",
  "category" : "Test",
  "description" : "",
  "version" : "2.3.5",
  "inputs" : [ {
    "name" : "SHELL_PLUGIN",
    "type" : "input",
    "label" : "Single-line Text Box",
    "description" : "Sample String",
    "required" : true,
    "validation" : {
      "required_message" : null,
      "regex" : null,
      "regex_message" : null,
      "max_length" : null,
      "min_length" : null
    },
    "default_value" : "",
    "extend_prop" : {
      "api_options" : null,
      "api_type" : null,
      "options" : null,
      "disabled_conditions" : null,
      "visible_conditions" : null
    }
  } ],
  "outputs" : [ {
    "name" : "problem",
    "type" : "output",
    "description" : "Number of recorded problems"
  } ],
  "execution" : {
    "type" : "scripts/test.sh",
    "target" : "Shell",
    "sha256" : "4fa52dab3fb72847e4da5f00295a96fce8892f301d384efe9b776aa1731ba8f0"
  },
  "friendly_name" : "Basic plug-in - CTS2",
  "version_description" : "Running Shell Commands"
}

Status Codes

Status Code

Description

200

OK

400

Bad request

401

Unauthorized

403

Forbidden

404

Not Found

Error Codes

See Error Codes.