Help Center/SecMaster/API Reference/API/Playbook Version Management/Querying Playbook Version Details
Updated on 2025-03-20 GMT+08:00
View PDF

Querying Playbook Version Details

Function

Show playbook version version

Calling Method

For details, see Calling APIs.

URI

GET /v1/{project_id}/workspaces/{workspace_id}/soc/playbooks/versions/{version_id}

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Project ID.

workspace_id

Yes

String

Workspace ID

version_id

Yes

String

Playbook version ID.

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

User token.

It can be obtained by calling the IAM API used to obtain a user token. The value of X-Subject-Token in the response header is a token.

content-type

Yes

String

application/json;charset=UTF-8

Response Parameters

Status code: 200

Table 3 Response header parameters

Parameter

Type

Description

X-request-id

String

Request ID, in the format request_uuid-timestamp-hostname.

Table 4 Response body parameters

Parameter

Type

Description

code

String

Error code

message

String

Error message

data

PlaybookVersionInfo object

Playbook review details.

Table 5 PlaybookVersionInfo

Parameter

Type

Description

id

String

Playbook version ID.

description

String

Description.

create_time

String

Creation time.

update_time

String

Update time.

project_id

String

Project ID.

creator_id

String

Creator ID.

modifier_id

String

ID of the user who updated the information.

playbook_id

String

Playbook ID.

version

String

Version No.

enabled

Boolean

Whether to enable the function. - true -- Enabled. - false -- Disabled

status

String

Playbook version status. Options - Editing, APPROVING, UNPASSED, and PUBLISHED

action_strategy

String

Execution policy. Currently, only asynchronous concurrent execution is supported. The corresponding value is ASYNC.

actions

Array of ActionInfo objects

Workflows associated with the playbook.

rule_enable

Boolean

Whether to enable the trigger condition filter.

rules

RuleInfo object

Playbook triggering specifications information.

dataclass_id

String

Data class ID.

trigger_type

String

How the playbook is triggered. The options are as follows - EVENT -- event; TIMER -- scheduled.)

dataobject_create

Boolean

Whether to trigger a playbook when a data object is created.

dataobject_update

Boolean

Whether to trigger a playbook when a data object is updated.

dataobject_delete

Boolean

Whether to trigger a playbook when a data object is deleted.

version_type

Integer

Version type (0 -- draft; 1 -- officially released)

rule_id

String

Filtering rule ID.

dataclass_name

String

Data class name.

approve_name

String

Reviewer.

Table 6 ActionInfo

Parameter

Type

Description

id

String

Playbook workflow ID.

name

String

Workflow name.

description

String

Description.

action_type

String

Workflow type.

action_id

String

Workflow ID.

playbook_id

String

Playbook ID.

playbook_version_id

String

Playbook version ID.

project_id

String

Project ID.

Table 7 RuleInfo

Parameter

Type

Description

id

String

Rule ID.

project_id

String

Project ID.

rule

String

Trigger rule.

Status code: 400

Table 8 Response header parameters

Parameter

Type

Description

X-request-id

String

Request ID, in the format request_uuid-timestamp-hostname.

Table 9 Response body parameters

Parameter

Type

Description

code

String

Error Code

message

String

Error Description

Example Requests

None

Example Responses

Status code: 200

Response when the request is successful.

{
  "code" : 0,
  "message" : "Error message",
  "data" : {
    "id" : "909494e3-558e-46b6-a9eb-07a8e18ca62f",
    "description" : "This my XXXX",
    "create_time" : "2021-01-30T23:00:00Z+0800",
    "update_time" : "2021-01-30T23:00:00Z+0800",
    "project_id" : "909494e3-558e-46b6-a9eb-07a8e18ca62f",
    "creator_id" : "909494e3-558e-46b6-a9eb-07a8e18ca62f",
    "modifier_id" : "909494e3-558e-46b6-a9eb-07a8e18ca62f",
    "playbook_id" : "909494e3-558e-46b6-a9eb-07a8e18ca62f",
    "version" : "v1.1.1",
    "enabled" : true,
    "status" : "editing",
    "action_strategy" : "sync",
    "actions" : [ {
      "id" : "909494e3-558e-46b6-a9eb-07a8e18ca62f",
      "name" : "MyXXX",
      "description" : "This my XXXX",
      "action_type" : "Workflow",
      "action_id" : "909494e3-558e-46b6-a9eb-07a8e18ca62f",
      "playbook_id" : "string",
      "playbook_version_id" : "string",
      "project_id" : "string"
    } ],
    "rule_enable" : true,
    "rules" : {
      "id" : "909494e3-558e-46b6-a9eb-07a8e18ca62f",
      "project_id" : "909494e3-558e-46b6-a9eb-07a8e18ca62f",
      "rule" : "909494e3-558e-46b6-a9eb-07a8e18ca62f"
    },
    "dataclass_id" : "909494e3-558e-46b6-a9eb-07a8e18ca62f",
    "trigger_type" : "event",
    "dataobject_create" : true,
    "dataobject_update" : true,
    "dataobject_delete" : true,
    "version_type" : 1,
    "rule_id" : "string",
    "dataclass_name" : "string",
    "approve_name" : "string"
  }
}

Status Codes

Status Code

Description

200

Response when the request is successful.

400

Response when the request failed.

Error Codes

See Error Codes.

Parent Topic: Playbook Version Management