Updated on 2024-12-02 GMT+08:00

Obtaining Information About a Trigger

Function

Obtain information about a trigger.

URI

GET /v2/manage/namespaces/{namespace}/repos/{repository}/triggers/{trigger}

Table 1 describes the parameters.

Table 1 Parameter description

Parameter

Mandatory

Type

Description

namespace

Yes

String

Organization name

repository

Yes

String

Image repository name

trigger

Yes

String

Trigger name

Request

  • Request parameters
    Table 2 Request header parameters

    Parameter

    Mandatory

    Type

    Description

    Content-Type

    Yes

    String

    Message body type (format). The value can be application/json or charset=utf-8 application/json.

    The default value is application/json.

    X-Auth-Token

    Yes

    String

    User token.

    The token can be obtained by calling an IAM API. The value of X-Subject-Token in the response header is the user token.

  • Example request
    GET https://{Endpoint}/v2/manage/namespaces/group/repos/busybox/triggers/test

Response

  • Response parameters

    Status code: 200

    Table 3 Response body parameter description

    Parameter

    Type

    Description

    action

    String

    Action to trigger. The value can be update.

    app_type

    String

    Application type. The value can be deployments or statefulsets.

    application

    String

    Application name.

    cluster_id

    String

    Cluster ID. If trigger_mode is set to cci, leave this parameter blank.

    cluster_name

    String

    Cluster name. If trigger_mode is set to cci, leave this parameter blank.

    cluster_ns

    String

    Namespace where the application is located.

    condition

    String

    Trigger condition.

    • When trigger_type is set to all, set this parameter to .*.
    • When trigger_type is set to tag, set this parameter to specific image tags separated by semicolons (;).
    • When trigger_type is set to regular, set this parameter to a regular expression.

    container

    String

    Name of the container to be updated. By default, all containers using this image are updated.

    created_at

    String

    Creation time.

    creator_name

    String

    Creator.

    enable

    String

    Whether to enable the trigger.

    name

    String

    Trigger name.

    trigger_history

    Array of objects

    Trigger history.

    trigger_mode

    String

    Trigger type. The value can be cce or cci.

    trigger_type

    String

    Trigger condition. The value can be all, tag, or regular.

    Table 4 Parameter description

    Parameter

    Type

    Description

    action

    String

    Action to trigger. The value can be update.

    app_type

    String

    Application type. The value can be deployments or statefulsets.

    application

    String

    Application name.

    cluster_id

    String

    (Reserved field) Cluster ID.

    cluster_name

    String

    (Reserved field) Cluster name.

    cluster_ns

    String

    (Reserved field) Namespace where the application is located.

    condition

    String

    Trigger condition.

    • When trigger_type is set to all, set this parameter to .*.
    • When trigger_type is set to tag, set this parameter to specific image tags separated by semicolons (;).
    • When trigger_type is set to regular, set this parameter to a regular expression.

    container

    String

    Name of the container to be updated. By default, all containers using this image are updated.

    created_at

    String

    Creation time.

    creator_name

    String

    Creator.

    detail

    String

    Details.

    result

    String

    Update result. The value can be success or failed.

    tag

    String

    Image tag that triggers the update.

  • Example response
    {
        "action": "update",
        "app_type": "deployments",
        "application": "cci-deployment-20204161",
        "cluster_id": "",
        "cluster_name": "",
        "cluster_ns": "cci-namespace-21539491",
        "condition": ".*",
        "container": "",
        "created_at": "2020-04-16T01:35:08.639589Z",
        "creator_name": "paas_swr_z00232859",
        "enable": "true",
        "name": "test",
        "trigger_history": [
            {
                "action": "update",
                "app_type": "deployments",
                "application": "cci-deployment-20204161",
                "cluster_id": "",
                "cluster_name": "",
                "cluster_ns": "",
                "condition": ".*",
                "container": "",
                "created_at": "2020-04-16T01:36:36.155119Z",
                "creator_name": "************",
                "detail": "xxxxxxxxxxxxxx",
                "result": "failed",
                "tag": "test"
            }
        ],
        "trigger_mode": "cci",
        "trigger_type": "all"
    }

Status Code

Status Code

Description

200

Request successful.

400

Request error.

401

Authentication failed.

404

The organization does not exist.

500

Failed to complete the request because of an internal service error.

Error Codes

For details, see Error Codes.