提取一条或多条变更

提取一条或多条变更

API调用URL地址

http://<serverName>:<portNumber>/api/v3/changes/pickup?ids={change_ids}

其中{change_ids}为提取的变更ID,多个ID用 “,” 隔开

示例:http://192.168.0.39:8080/api/v3/changes/pickup?ids=3,4

请求参数

方法:PUT

请求参数:

参数名

位置

authtoken

<API Key>

header

响应示例

{
    "response_status":[
        {
            "status_code":2000,
            "id":"1",
            "status":"success"
        }
,
        {
            "status_code":2000,
            "id":"2",
            "status":"success"
        }

    ]
,
    "changes":[
        {
            "template":{
                "name":"General Template",
                "id":"3"
            }
,
            "short_description":null,
            "attachments":[

            ]
,
            "roll_out_plan":{
                "updated_on":null,
                "internal_name":"roll_out_plan",
                "attachments":[

                ]
,
                "stage":{
                    "internal_name":"Planning",
                    "stage_index":"2",
                    "name":"Planning",
                    "id":"2"
                }
,
                "change":{
                    "id":"3"
                }
,
                "name":"roll_out_plan",
                "updated_by":null,
                "description":null,
                "id":"3"
            }
,
            "closure_code":null,
            "sla_violation":null,
            "roles":[

            ]
,
            "description":null,
            "emergency":false,
            "change_type":null,
            "title":"test",
            "review_details":{
                "updated_on":null,
                "internal_name":"review_details",
                "attachments":[

                ]
,
                "stage":{
                    "internal_name":"Review",
                    "stage_index":"5",
                    "name":"Review",
                    "id":"5"
                }
,
                "change":{
                    "id":"3"
                }
,
                "name":"review_details",
                "updated_by":null,
                "description":null,
                "id":"5"
            }
,
            "change_owner":{
                "email_id":null,
                "phone":"1234455",
                "name":"administrator",
                "mobile":"1234567890",
                "profile_pic":{
                    "content-url":"/images/default-profile-pic2.svg",
                    "name":"default-profile-pic2.svg"
                }
,
                "is_vipuser":false,
                "id":"5",
                "department":null
            }
,
            "next_review_on":null,
            "assets":[

            ]
,
            "urgency":null,
            "close_details":{
                "updated_on":null,
                "internal_name":"close_details",
                "attachments":[

                ]
,
                "stage":{
                    "internal_name":"Close",
                    "stage_index":"6",
                    "name":"Close",
                    "id":"6"
                }
,
                "change":{
                    "id":"1"
                }
,
                "name":"close_details",
                "updated_by":null,
                "description":null,
                "id":"6"
            }
,
            "id":"3",
            "change_requester":null,
            "group":null,
            "created_time":{
                "display_value":"18/11/2021 10:25 AM",
                "value":"1637202334062"
            }
,
            "item":null,
            "workflow":{
                "validated":true,
                "name":"SDGeneral",
                "id":"1",
                "type":"General"
            }
,
            "approval_status":{
                "name":"Pending Approval",
                "id":"1"
            }
,
            "change_manager":null,
            "impact":null,
            "retrospective":false,
            "sla":null,
            "checklist":{
                "updated_on":null,
                "internal_name":"checklist",
                "attachments":[

                ]
,
                "stage":{
                    "internal_name":"Planning",
                    "stage_index":"2",
                    "name":"Planning",
                    "id":"2"
                }
,
                "change":{
                    "id":"3"
                }
,
                "name":"checklist",
                "updated_by":null,
                "description":null,
                "id":"3"
            }
,
            "services":[

            ]
,
            "priority":null,
            "scheduled_end_time":null,
            "back_out_plan":{
                "updated_on":null,
                "internal_name":"back_out_plan",
                "attachments":[

                ]
,
                "stage":{
                    "internal_name":"Planning",
                    "stage_index":"2",
                    "name":"Planning",
                    "id":"2"
                }
,
                "change":{
                    "id":"3"
                }
,
                "name":"back_out_plan",
                "updated_by":null,
                "description":null,
                "id":"4"
            }
,
            "stage":{
                "internal_name":"Submission",
                "stage_index":"1",
                "name":"Submission",
                "id":"1"
            }
,
            "reason_for_change":null,
            "completed_time":null,
            "risk":null,
            "impact_details":{
                "updated_on":null,
                "internal_name":"impact_details",
                "attachments":[

                ]
,
                "stage":{
                    "internal_name":"Planning",
                    "stage_index":"2",
                    "name":"Planning",
                    "id":"2"
                }
,
                "change":{
                    "id":"3"
                }
,
                "name":"impact_details",
                "updated_by":null,
                "description":null,
                "id":"2"
            }
,
            "category":null,
            "subcategory":null,
            "notes_present":false,
            "status":{
                "internal_name":"Requested",
                "prominent":false,
                "stage":{
                    "id":"1"
                }
,
                "action_name":null,
                "name":"Requested",
                "id":"3"
            }
,
            "scheduled_start_time":null
        }
,
        {
            "template":{
                "name":"General Template",
                "id":"1"
            }
,
            "short_description":null,
            "attachments":[

            ]
,
            "roll_out_plan":{
                "updated_on":null,
                "internal_name":"roll_out_plan",
                "attachments":[

                ]
,
                "stage":{
                    "internal_name":"Planning",
                    "stage_index":"2",
                    "name":"Planning",
                    "id":"2"
                }
,
                "change":{
                    "id":"3"
                }
,
                "name":"roll_out_plan",
                "updated_by":null,
                "description":null,
                "id":"7"
            }
,
            "closure_code":null,
            "sla_violation":null,
            "roles":[

            ]
,
            "description":null,
            "emergency":false,
            "change_type":null,
            "title":"teste2",
            "review_details":{
                "updated_on":null,
                "internal_name":"review_details",
                "attachments":[

                ]
,
                "stage":{
                    "internal_name":"Review",
                    "stage_index":"5",
                    "name":"Review",
                    "id":"5"
                }
,
                "change":{
                    "id":"4"
                }
,
                "name":"review_details",
                "updated_by":null,
                "description":null,
                "id":"11"
            }
,
            "change_owner":{
                "email_id":null,
                "phone":"1234455",
                "name":"administrator",
                "mobile":"1234567890",
                "profile_pic":{
                    "content-url":"/images/default-profile-pic2.svg",
                    "name":"default-profile-pic2.svg"
                }
,
                "is_vipuser":false,
                "id":"5",
                "department":null
            }
,
            "next_review_on":null,
            "assets":[

            ]
,
            "urgency":null,
            "close_details":{
                "updated_on":null,
                "internal_name":"close_details",
                "attachments":[

                ]
,
                "stage":{
                    "internal_name":"Close",
                    "stage_index":"6",
                    "name":"Close",
                    "id":"6"
                }
,
                "change":{
                    "id":"4"
                }
,
                "name":"close_details",
                "updated_by":null,
                "description":null,
                "id":"12"
            }
,
            "id":"4",
            "change_requester":null,
            "group":null,
            "created_time":{
                "display_value":"18/11/2021 10:25 AM",
                "value":"1637202344530"
            }
,
            "item":null,
            "workflow":{
                "validated":true,
                "name":"SDGeneral",
                "id":"1",
                "type":"General"
            }
,
            "approval_status":{
                "name":"Pending Approval",
                "id":"1"
            }
,
            "change_manager":null,
            "impact":null,
            "retrospective":false,
            "sla":null,
            "checklist":{
                "updated_on":null,
                "internal_name":"checklist",
                "attachments":[

                ]
,
                "stage":{
                    "internal_name":"Planning",
                    "stage_index":"2",
                    "name":"Planning",
                    "id":"2"
                }
,
                "change":{
                    "id":"2"
                }
,
                "name":"checklist",
                "updated_by":null,
                "description":null,
                "id":"9"
            }
,
            "services":[

            ]
,
            "priority":null,
            "scheduled_end_time":null,
            "back_out_plan":{
                "updated_on":null,
                "internal_name":"back_out_plan",
                "attachments":[

                ]
,
                "stage":{
                    "internal_name":"Planning",
                    "stage_index":"2",
                    "name":"Planning",
                    "id":"2"
                }
,
                "change":{
                    "id":"2"
                }
,
                "name":"back_out_plan",
                "updated_by":null,
                "description":null,
                "id":"10"
            }
,
            "stage":{
                "internal_name":"Submission",
                "stage_index":"1",
                "name":"Submission",
                "id":"1"
            }
,
            "reason_for_change":null,
            "completed_time":null,
            "risk":null,
            "impact_details":{
                "updated_on":null,
                "internal_name":"impact_details",
                "attachments":[

                ]
,
                "stage":{
                    "internal_name":"Planning",
                    "stage_index":"2",
                    "name":"Planning",
                    "id":"2"
                }
,
                "change":{
                    "id":"2"
                }
,
                "name":"impact_details",
                "updated_by":null,
                "description":null,
                "id":"8"
            }
,
            "category":null,
            "subcategory":null,
            "notes_present":false,
            "status":{
                "internal_name":"Requested",
                "prominent":false,
                "stage":{
                    "id":"1"
                }
,
                "action_name":null,
                "name":"Requested",
                "id":"3"
            }
,
            "scheduled_start_time":null
        }

    ]

}

Postman示例





Python脚本示例

 #Python version - 3.9
#需要安装requests模块
import requests
 
url = "http://192.168.0.39:8080/api/v3/changes/pickup?ids=3,4"
headers = {"authtoken":"2D02FD93-9BD8-484E-ADEF-727FA69A161B"}
response = requests.put(url,headers=headers,verify=False)
print(response.text)