跳转到内容

变更风险

大多数提议的变更在实施过程中可能涉及一定程度的风险。为了完成变更，参与变更的用户应了解这些风险。 

属性

id （长整型）
变更风险的唯一标识符

id （长整型）
被认为具有更大数值的数字位数。

示例 

234759602834500

名称 （字符串）
变更风险名称

名称 （字符串）
纯文本格式。不允许富文本或换行符。

示例 

Sample Content

描述 （字符串）
关于变更风险的简短描述

描述 （字符串）
纯文本格式。不允许富文本或换行符。

示例 

Sample Content

非激活 （布尔值）
指示变更风险是否处于激活状态

非激活 （布尔值）
布尔值，可为 true 或 false 两种值。

添加变更风险

此操作帮助您添加变更风险。必填字段：名称

必填字段：名称

URL

<service domain|custom domain>/app/<portal>/api/v3/change_risks

属性

id （长整型）
变更风险的唯一标识符

id （长整型）
被认为具有更大数值的数字位数。

示例 

234759602834500

名称 （字符串）
变更风险名称

名称 （字符串）
纯文本格式。不允许富文本或换行符。

示例 

Sample Content

描述 （字符串）
关于变更风险的简短描述

描述 （字符串）
纯文本格式。不允许富文本或换行符。

示例 

Sample Content

非激活 （布尔值）
指示变更风险是否处于激活状态

非激活 （布尔值）
布尔值，可为 true 或 false 两种值。

$ curl <service domain|custom domain>/app/<portal>/api/v3/change_risks\
      -X POST\
      -H "Accept: application/vnd.manageengine.sdp.v3+json"\
      -H "Authorization: Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"\
      -H "Content-Type: application/x-www-form-urlencoded"\
      -d input_data='{
  "change_risk": {
    "inactive": false,
    "name": "test-name",
    "description": "test-description"
  }
}'

// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/change_risks";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};
input_data = {
  "change_risk": {
    "inactive": false,
    "name": "test-name",
    "description": "test-description"
  }
};
params = {"input_data": input_data};
response = invokeurl
[
    url: url
    type: POST
    parameters: params
    headers: headers
];
info response;

#Powershell version - 5.1
$url = "<service domain|custom domain>/app/<portal>/api/v3/change_risks"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
    "Authorization" = "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"
    "Content-Type" = "application/x-www-form-urlencoded"}
$input_data = @'
{
  "change_risk": {
    "inactive": false,
    "name": "test-name",
    "description": "test-description"
  }
}
'@
$data = @{ 'input_data' = $input_data}
$response = Invoke-RestMethod -Uri $url -Method post -Body $data -Headers $headers
$response

#Python version - 3.10
from urllib.error import HTTPError
from urllib.parse import urlencode
from urllib.request import urlopen,Request

url = "<service domain|custom domain>/app/<portal>/api/v3/change_risks"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
input_data = '''{
  "change_risk": {
    "inactive": false,
    "name": "test-name",
    "description": "test-description"
  }
}'''
data = urlencode({"input_data":input_data}).encode()
httprequest = Request(url, headers=headers,data=data, method="POST")
try:
    with urlopen(httprequest) as response:
        print(response.read().decode())
except HTTPError as e:
    print(e.read().decode())

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  },
  "change_risk": {
    "inactive": false,
    "name": "test-name",
    "description": "test-description",
    "id": "2467513650673593"
  }
}

编辑变更风险

此操作帮助您编辑变更风险。

URL

<service domain|custom domain>/app/<portal>/api/v3/change_risks/{change_risk_id}

属性

id （长整型）
变更风险的唯一标识符

id （长整型）
被认为具有更大数值的数字位数。

示例 

234759602834500

名称 （字符串）
变更风险名称

名称 （字符串）
纯文本格式。不允许富文本或换行符。

示例 

Sample Content

描述 （字符串）
关于变更风险的简短描述

描述 （字符串）
纯文本格式。不允许富文本或换行符。

示例 

Sample Content

非激活 （布尔值）
指示变更风险是否处于激活状态

非激活 （布尔值）
布尔值，可为 true 或 false 两种值。

$ curl <service domain|custom domain>/app/<portal>/api/v3/change_risks/{change_risk_id}\
      -X PUT\ 
      -H "Accept: application/vnd.manageengine.sdp.v3+json"\
      -H "Authorization: Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"\
      -H "Content-Type: application/x-www-form-urlencoded"\
      -d input_data='{
  "change_risk": {
    "inactive": false,
    "name": "test-name",
    "description": "test-description"
  }
}'

// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/change_risks/{change_risk_id}";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};
input_data = {
  "change_risk": {
    "inactive": false,
    "name": "test-name",
    "description": "test-description"
  }
};
params = {"input_data": input_data};
response = invokeurl
[
    url: url
    type: PUT
    parameters: params
    headers: headers
];
info response;

#Powershell version - 5.1
$url = "<service domain|custom domain>/app/<portal>/api/v3/change_risks/{change_risk_id}"
$headers = @{"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
$input_data = @'
{
  "change_risk": {
    "inactive": false,
    "name": "test-name",
    "description": "test-description"
  }
}
'@
$data = @{ 'input_data' = $input_data}
$response = Invoke-RestMethod -Uri $url -Method put -Body $data -Headers $headers
$response

#Python version - 3.10
from urllib.error import HTTPError
from urllib.parse import urlencode
from urllib.request import urlopen,Request

url = "<service domain|custom domain>/app/<portal>/api/v3/change_risks/{change_risk_id}"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
input_data = '''{
  "change_risk": {
    "inactive": false,
    "name": "test-name",
    "description": "test-description"
  }
}'''
data = urlencode({"input_data":input_data}).encode()
httprequest = Request(url, headers=headers,data=data, method="PUT")
try:
    with urlopen(httprequest) as response:
        print(response.read().decode())
except HTTPError as e:
    print(e.read().decode())

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  },
  "change_risk": {
    "inactive": false,
    "name": "test-name",
    "description": "test-description",
    "id": "1944735328424155"
  }
}

获取变更风险

此操作帮助您获取变更风险。

URL

<service domain|custom domain>/app/<portal>/api/v3/change_risks/{change_risk_id}

属性

id （长整型）
变更风险的唯一标识符

id （长整型）
被认为具有更大数值的数字位数。

示例 

234759602834500

名称 （字符串）
变更风险名称

名称 （字符串）
纯文本格式。不允许富文本或换行符。

示例 

Sample Content

描述 （字符串）
关于变更风险的简短描述

描述 （字符串）
纯文本格式。不允许富文本或换行符。

示例 

Sample Content

非激活 （布尔值）
指示变更风险是否处于激活状态

非激活 （布尔值）
布尔值，可为 true 或 false 两种值。

$ curl -G <service domain|custom domain>/app/<portal>/api/v3/change_risks/{change_risk_id}\
      -X GET\
      -H "Accept: application/vnd.manageengine.sdp.v3+json"\
      -H "Authorization: Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"\
      -H "Content-Type: application/x-www-form-urlencoded"

// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/change_risks/{change_risk_id}";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};          
response = invokeurl
[
    url: url
    type: GET
    headers: headers
];
info response;

#Powershell version - 5.1
$url = "<service domain|custom domain>/app/<portal>/api/v3/change_risks/{change_risk_id}"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
    "Authorization" = "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"
    "Content-Type" = "application/x-www-form-urlencoded"}  
$response = Invoke-RestMethod -Uri $url -Method get -Headers $headers 
$response

#Python version - 3.8
#This script requires requests module installed in python.
from urllib.error import HTTPError
from urllib.parse import urlencode
from urllib.request import urlopen,Request

url = "<service domain|custom domain>/app/<portal>/api/v3/change_risks/{change_risk_id}"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
httprequest = Request(url, headers=headers)
try:
    with urlopen(httprequest) as response:
        print(response.read().decode())
except HTTPError as e:
    print(e.read().decode())

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  },
  "change_risk": {
    "inactive": false,
    "name": "test-name",
    "description": "test-description",
    "id": "1730001255341506"
  }
}

获取变更风险列表

此操作帮助您获取变更风险列表。

URL

<service domain|custom domain>/app/<portal>/api/v3/change_risks

属性

id （长整型）
变更风险的唯一标识符

id （长整型）
被认为具有更大数值的数字位数。

示例 

234759602834500

名称 （字符串）
变更风险名称

名称 （字符串）
纯文本格式。不允许富文本或换行符。

示例 

Sample Content

描述 （字符串）
关于变更风险的简短描述

描述 （字符串）
纯文本格式。不允许富文本或换行符。

示例 

Sample Content

非激活 （布尔值）
指示变更风险是否处于激活状态

非激活 （布尔值）
布尔值，可为 true 或 false 两种值。

$ curl -G <service domain|custom domain>/app/<portal>/api/v3/change_risks\
      -X GET\ 
      -H "Accept: application/vnd.manageengine.sdp.v3+json"\
      -H "Authorization: Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"\
      -H "Content-Type: application/x-www-form-urlencoded"\
      --data-urlencode input_data='{}'

// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/change_risks";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};
input_data = {};
params = {"input_data":input_data};           
response = invokeurl
[
    url: url
    type: GET
    parameters:params
    headers: headers
];
info response;

#Powershell version - 5.1
$url = "<service domain|custom domain>/app/<portal>/api/v3/change_risks"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
    "Authorization" = "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"
    "Content-Type" = "application/x-www-form-urlencoded"}
$input_data = @'{}'@
$data = @{ 'input_data' = $input_data}    
$response = Invoke-RestMethod -Uri $url -Method get -Body $data -Headers $headers 
$response

#Python version - 3.8
#This script requires requests module installed in python.
from urllib.error import HTTPError
from urllib.parse import urlencode
from urllib.request import urlopen,Request

url = "<service domain|custom domain>/app/<portal>/api/v3/change_risks"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
input_data = '''{}'''       
url += "?" + urlencode({"input_data":input_data})
httprequest = Request(url, headers=headers)
try:
    with urlopen(httprequest) as response:
        print(response.read().decode())
except HTTPError as e:
    print(e.read().decode())

{
  "response_status": [
    {
      "status_code": 2000,
      "status": "success"
    }
  ],
  "list_info": {
    "has_more_rows": false,
    "row_count": 1
  },
  "change_risks": [
    {
      "inactive": false,
      "name": "test-name",
      "description": "test-description",
      "id": "2448868246839349"
    }
  ]
}

删除变更风险

此操作帮助您删除变更风险。

URL

<service domain|custom domain>/app/<portal>/api/v3/change_risks/{change_risk_id}


$ curl <service domain|custom domain>/app/<portal>/api/v3/change_risks/{change_risk_id}\
      -X DELETE\ 
      -H "Accept: application/vnd.manageengine.sdp.v3+json"\
      -H "Authorization: Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"\
      -H "Content-Type: application/x-www-form-urlencoded"

// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/change_risks/{change_risk_id}";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};
response = invokeurl
[
    url: url
    type: DELETE
    headers: headers
];
info response;

#Powershell version - 5.1
$url = "<service domain|custom domain>/app/<portal>/api/v3/change_risks/{change_risk_id}"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
    "Authorization" = "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"
    "Content-Type" = "application/x-www-form-urlencoded"}
$response = Invoke-RestMethod -Uri $url -Method delete -Headers $headers
$response

#Python version - 3.10
from urllib.error import HTTPError
from urllib.request import urlopen,Request

url = "<service domain|custom domain>/app/<portal>/api/v3/change_risks/{change_risk_id}"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
httprequest = Request(url, headers=headers,method="DELETE")
try:
    with urlopen(httprequest) as response:
        print(response.read().decode())
except HTTPError as e:
    print(e.read().decode())

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}