Updated on 2025-07-10 GMT+08:00

Querying a Trigger Policy Based on the Release Task ID

Function

This API is used to query a release task trigger policy based on the release task ID.

URI

GET /v3/{project_id}/pipeline/pipelines/{pipeline_id}/hooks

Table 1 Path parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Tenant's project ID. See Obtaining a Project ID.

pipeline_id

Yes

String

Release task ID. See Obtaining the Release Task List.

Request

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

Content-Type

Yes

String

Message body type (format). Default value: application/json;charset=utf8.

X-Auth-Token

Yes

String

API calling can be authenticated using a token or AK/SK. If you use a token, this parameter is mandatory and must be set to the token. For details about how to obtain the token, see Authentication.

Response

Table 3 Response

Parameter

Type

Description

strategy_type

Integer

Execution policy.

  • 0: manual trigger
  • 1: scheduled trigger

hooks

List of object

Scheduling policy. This parameter is mandatory when strategy_type is set to 1. See Table 4.

Table 4 hooks

Parameter

Type

Description

schedule

String

Regular expression of the scheduling.

timezone_operator

String

Hour offset from the Coordinated Universal Time (UTC).

timezone_hour

Integer

Direction of the offset, that is, whether the time is advanced (+) or delayed (-).

Example Request

Query the release task trigger policy.

{
    "selected_tasks": [
        {
            "stage_name": "75foki",
            "tasks": [
                "bkdi55"
            ]
        }
    ],
    "strategy_type": 1,
    "hooks": [
        {
            "schedule": "0 00-59/10 00-00 ? * MON *",
            "timezone_operator": "+",
            "timezone_hour": 8
        }
    ]
}

Example Response

None

Status Code

Status Code

Description

200

OK

400

Bad Request

404

Not Found

500

Internal Server Error

Error Code

See ServiceStage Error Codes.