跳转到内容

问题

终端用户在发现所提供的服务中断时,可以提出问题。

属性

id (长整数)
问题创建时分配的唯一标识符

id (长整数)
被认为具有较大值的数字位

示例

234759602834500

标题 (字符串)
问题的标题

标题 (字符串)
纯文本格式。不允许使用富文本或换行符。

示例

Sample Content

描述 (html)
问题描述

描述 (html)
HTML 是一个文本区域,可以使用 html 元素。

示例

<b>The content to be displayed</b>

报告时间 (日期时间)
表示问题的报告时间

报告时间 (日期时间)
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

value :以长格式表示的时间(自 1970 年 1 月 1 日以来的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,则使用默认格式。

截止时间 (日期时间)
表示问题的截止时间

截止时间 (日期时间)
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

value :以长格式表示的时间(自 1970 年 1 月 1 日以来的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,则使用默认格式。

关闭时间 (日期时间)
表示问题的关闭时间

关闭时间 (日期时间)
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

value :以长格式表示的时间(自 1970 年 1 月 1 日以来的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,则使用默认格式。

更多属性 展开全部

报告者 (用户)

表示报告该问题的用户

报告者 (用户)
表示报告问题的用户

示例

{
  "reported_by": {
    "name": "test-reported_by",
    "id": "234567890123456"
  }
}

类别 (类别)

指示与问题相关的CI的类别。

类别 (类别)
指示与问题相关的CI的类别。

示例

{
  "category": {
    "name": "test-category",
    "id": "234567890123456"
  }
}

影响 (影响)

指示问题的影响

影响 (影响)
指示问题对业务、组或用户的影响

示例

{
  "impact": {
    "name": "test-impact",
    "id": "234567890123456"
  }
}

优先级 (优先级)

指示问题的优先级

优先级 (优先级)
指示问题的优先级。

示例

{
  "priority": {
    "name": "test-priority",
    "id": "234567890123456"
  }
}

子类别 (子类别)

分配在类别下选择的相关CI的子类别

子类别 (子类别)
指示在类别下选择的相关CI的子类别

示例

{
  "subcategory": {
    "name": "test-subcategory",
    "id": "234567890123456"
  }
}

项目 (项目)

指示项目分类

项目 (项目)
指示问题的项目分类。

示例

{
  "item": {
    "name": "test-item",
    "id": "234567890123456"
  }
}

紧急程度 (紧急程度)

指示问题的紧急程度

紧急程度 (紧急程度)
指示问题的紧急级别

示例

{
  "urgency": {
    "name": "test-urgency",
    "id": "234567890123456"
  }
}

站点 (站点)

指示问题发生的站点

站点 (站点)
指示问题发生的站点

示例

{
  "site": {
    "name": "test-site",
    "id": "234567890123456"
  }
}

(组)

问题的分配组

(组)
指示问题的分配组

示例

{
  "group": {
    "name": "test-group",
    "id": "234567890123456"
  }
}

技术员 (技术员)

指示分配给问题的技术员

技术员 (技术员)
指示分配给问题的技术员

示例

{
  "technician": {
    "email_id": "andrews@zmail.com",
    "name": "test-technician",
    "id": "234567890123456"
  }
}

状态 (状态)

指示问题的当前状态

状态 (状态)
指示问题的当前状态

示例

{
  "status": {
    "name": "Open",
    "id": "234567890123456"
  }
}

资产 (资产)

指示可能因该问题受影响的资产。

资产 (资产)
指示可能因问题受影响的资产

示例

{
  "assets": [
    {
      "name": "test-assets",
      "id": "234567890123456"
    }
  ]
}

服务 (服务类别)

可能因该问题受影响的服务

服务 (服务类别)
可能因该问题受影响的服务

示例

{
  "services": {
    "name": "test-services",
    "id": "234567890123456"
  }
}

用户定义字段 (用户定义字段)

包含问题的用户定义字段值

用户定义字段 (用户定义字段)

附件 (问题附件)

附加到问题的文件。最多可附加10个附件。

附件 (问题附件)
指示附加到问题的文件。最多只可附加10个附件。

示例

{
  "attachments": {
    "name": "test-attachments",
    "id": "234567890123456"
  }
}

模板 (问题模板)

指示用于创建问题的模板

模板 (问题模板)
指示用于创建问题的模板

示例

{
  "template": {
    "name": "test-template",
    "id": "234567890123456"
  }
}

配置项 (配置项)

可能因该问题受影响的配置项

配置项 (配置项)
可能因该问题受影响的配置项

示例

{
  "configuration_items": {
    "name": "test-configuration_items",
    "id": "234567890123456"
  }
}

影响详情 (JSONObject)

描述问题将如何影响业务
显示属性

影响详情 (JSONObject)

影响详情描述 (html)

包含有关问题如何影响组织的详细信息

影响详情描述 (html)
HTML 是一个文本区域,可以使用 html 元素。

示例

<b>The content to be displayed</b>

影响详情更新时间 (日期时间)

指示影响详情的最后更新时间 

影响详情更新时间 (日期时间)
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

value :以长格式表示的时间(自 1970 年 1 月 1 日以来的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,则使用默认格式。

影响详情更新者 (用户)

指示最后更新影响详情的用户

影响详情更新者 (用户)

示例

{
  "impact_details_updated_by": {
    "name": "test-impact_details_updated_by",
    "id": "234567890123456"
  }
}

根本原因 (JSONObject)

描述问题的原因
显示属性

根本原因 (JSONObject)

根本原因描述 (html)

包含问题根本原因的详细信息

根本原因描述 (html)
HTML 是一个文本区域,可以使用 html 元素。

示例

<b>The content to be displayed</b>

根本原因更新时间 (日期时间)

指示根本原因的最后更新时间

根本原因更新时间 (日期时间)
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

value :以长格式表示的时间(自 1970 年 1 月 1 日以来的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,则使用默认格式。

根本原因更新者 (用户)

最后更新根本原因的用户

根本原因更新者 (用户)

示例

{
  "root_cause_updated_by": {
    "name": "test-root_cause_updated_by",
    "id": "234567890123456"
  }
}

症状 (JSONObject)

描述问题对业务的影响症状
显示属性

症状 (JSONObject)

症状描述 (html)

包含问题症状的详细信息

症状描述 (html)
HTML 是一个文本区域,可以使用 html 元素。

示例

<b>The content to be displayed</b>

症状更新时间 (日期时间)

指示症状的最后更新时间

症状更新时间 (日期时间)
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

value :以长格式表示的时间(自 1970 年 1 月 1 日以来的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,则使用默认格式。

症状更新者 (用户)

最后更新症状的用户

症状更新者 (用户)

已知错误详情 (JSONObject)

描述问题的已知错误详情
显示属性

已知错误详情 (JSONObject)
指示已知错误信息

已知错误评论 (字符串)

包含有关已知错误的详细信息

已知错误评论 (字符串)
纯文本格式。不允许使用富文本或换行符。

示例

Sample Content

是否为已知错误 (布尔值)

指示问题是否为已知错误

是否为已知错误 (布尔值)
布尔值,可取两个可能值。取值为 true 和 false。

已知错误详情更新时间 (日期时间)

指示已知错误的最后更新时间

已知错误详情更新时间 (日期时间)
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

value :以长格式表示的时间(自 1970 年 1 月 1 日以来的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,则使用默认格式。

已知错误详情更新者 (用户)

指示最后更新已知错误的用户

已知错误详情更新者 (用户)

示例

{
  "known_error_details_updated_by": {
    "name": "test-known_error_details_updated_by",
    "id": "234567890123456"
  }
}

关闭详情 (JSONObject)

包含有关问题关闭的信息
显示属性

关闭详情 (JSONObject)

关闭详情评论 (字符串)

包含问题的关闭评论。

关闭详情评论 (字符串)
纯文本格式。不允许使用富文本或换行符。

示例

Sample Content

关闭代码 (关闭代码)

关闭代码表示关闭问题的原因

关闭代码 (关闭代码)

关闭详情更新时间 (日期时间)

指示关闭详情的最后更新时间

关闭详情更新时间 (日期时间)
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

value :以长格式表示的时间(自 1970 年 1 月 1 日以来的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,则使用默认格式。

关闭详情更新者 (用户)

最后更新关闭详情的用户。

关闭详情更新者 (用户)

解决详情 (JSONObject)

技术员为问题提供的解决方案
显示属性

解决详情 (JSONObject)

解决详情描述 (html)

包含问题解决方案的详细信息

解决详情描述 (html)
HTML 是一个文本区域,可以使用 html 元素。

示例

<b>The content to be displayed</b>

解决详情更新时间 (日期时间)

指示解决方案的最后更新时间

解决详情更新时间 (日期时间)
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

value :以长格式表示的时间(自 1970 年 1 月 1 日以来的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,则使用默认格式。

解决详情更新者 (用户)

最后更新解决方案的用户

解决详情更新者 (用户)

变通方案详情 (JSONObject)

技术员为问题提供的变通方案
显示属性

变通方案详情 (JSONObject)

变通方案详情描述 (html)

包含问题变通方案的详细信息

变通方案详情描述 (html)
HTML 是一个文本区域,可以使用 html 元素。

示例

<b>The content to be displayed</b>

变通方案更新时间 (日期时间)

指示变通方案的最后更新时间

变通方案更新时间 (日期时间)
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

value :以长格式表示的时间(自 1970 年 1 月 1 日以来的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,则使用默认格式。

变通方案更新者 (用户)

最后更新变通方案的用户

变通方案更新者 (用户)

显示编号 (序号)read only

问题的序列号

显示编号 (序号)

是否存在备注 (布尔值)read only

指示问题是否包含任何备注

是否存在备注 (布尔值)
布尔值,可取两个可能值。取值为 true 和 false。

更新时间 (日期时间)read only

指示问题的最后更新时间

更新时间 (日期时间)
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

value :以长格式表示的时间(自 1970 年 1 月 1 日以来的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,则使用默认格式。

生命周期 (问题生命周期)read only

描述问题生命周期及其各状态流程

生命周期 (问题生命周期)
描述问题生命周期及各状态流程

示例

{
  "lifecycle": {
    "name": "test-lifecycle",
    "id": "234567890123456"
  }
}

添加问题

此操作帮助您添加一个问题。

必填字段:- 标题

Url

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

属性

id (长整数)
问题创建时分配的唯一标识符

id (长整数)
被认为具有较大值的数字位

示例

234759602834500

标题 (字符串)
问题的标题

标题 (字符串)
纯文本格式。不允许使用富文本或换行符。

示例

Sample Content

描述 (html)
问题描述

描述 (html)
HTML 是一个文本区域,可以使用 html 元素。

示例

<b>The content to be displayed</b>

报告时间 (日期时间)
表示问题的报告时间

报告时间 (日期时间)
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

value :以长格式表示的时间(自 1970 年 1 月 1 日以来的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,则使用默认格式。

截止时间 (日期时间)
表示问题的截止时间

截止时间 (日期时间)
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

value :以长格式表示的时间(自 1970 年 1 月 1 日以来的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,则使用默认格式。

关闭时间 (日期时间)
表示问题的关闭时间

关闭时间 (日期时间)
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

value :以长格式表示的时间(自 1970 年 1 月 1 日以来的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,则使用默认格式。

更多属性 展开全部

报告者 (用户)

表示报告该问题的用户

报告者 (用户)
表示报告问题的用户

示例

{
  "reported_by": {
    "name": "test-reported_by",
    "id": "234567890123456"
  }
}

类别 (类别)

指示与问题相关的CI的类别。

类别 (类别)
指示与问题相关的CI的类别。

示例

{
  "category": {
    "name": "test-category",
    "id": "234567890123456"
  }
}

影响 (影响)

指示问题的影响

影响 (影响)
指示问题对业务、组或用户的影响

示例

{
  "impact": {
    "name": "test-impact",
    "id": "234567890123456"
  }
}

优先级 (优先级)

指示问题的优先级

优先级 (优先级)
指示问题的优先级。

示例

{
  "priority": {
    "name": "test-priority",
    "id": "234567890123456"
  }
}

子类别 (子类别)

分配在类别下选择的相关CI的子类别

子类别 (子类别)
指示在类别下选择的相关CI的子类别

示例

{
  "subcategory": {
    "name": "test-subcategory",
    "id": "234567890123456"
  }
}

项目 (项目)

指示项目分类

项目 (项目)
指示问题的项目分类。

示例

{
  "item": {
    "name": "test-item",
    "id": "234567890123456"
  }
}

紧急程度 (紧急程度)

指示问题的紧急程度

紧急程度 (紧急程度)
指示问题的紧急级别

示例

{
  "urgency": {
    "name": "test-urgency",
    "id": "234567890123456"
  }
}

站点 (站点)

指示问题发生的站点

站点 (站点)
指示问题发生的站点

示例

{
  "site": {
    "name": "test-site",
    "id": "234567890123456"
  }
}

(组)

问题的分配组

(组)
指示问题的分配组

示例

{
  "group": {
    "name": "test-group",
    "id": "234567890123456"
  }
}

技术员 (技术员)

指示分配给问题的技术员

技术员 (技术员)
指示分配给问题的技术员

示例

{
  "technician": {
    "email_id": "andrews@zmail.com",
    "name": "test-technician",
    "id": "234567890123456"
  }
}

状态 (状态)

指示问题的当前状态

状态 (状态)
指示问题的当前状态

示例

{
  "status": {
    "name": "Open",
    "id": "234567890123456"
  }
}

资产 (资产)

指示可能因该问题受影响的资产。

资产 (资产)
指示可能因问题受影响的资产

示例

{
  "assets": [
    {
      "name": "test-assets",
      "id": "234567890123456"
    }
  ]
}

服务 (服务类别)

可能因该问题受影响的服务

服务 (服务类别)
可能因该问题受影响的服务

示例

{
  "services": {
    "name": "test-services",
    "id": "234567890123456"
  }
}

用户定义字段 (用户定义字段)

包含问题的用户定义字段值

用户定义字段 (用户定义字段)

附件 (问题附件)

附加到问题的文件。最多可附加10个附件。

附件 (问题附件)
指示附加到问题的文件。最多只可附加10个附件。

示例

{
  "attachments": {
    "name": "test-attachments",
    "id": "234567890123456"
  }
}

模板 (问题模板)

指示用于创建问题的模板

模板 (问题模板)
指示用于创建问题的模板

示例

{
  "template": {
    "name": "test-template",
    "id": "234567890123456"
  }
}

配置项 (配置项)

可能因该问题受影响的配置项

配置项 (配置项)
可能因该问题受影响的配置项

示例

{
  "configuration_items": {
    "name": "test-configuration_items",
    "id": "234567890123456"
  }
}

影响详情 (JSONObject)

描述问题将如何影响业务
显示属性

影响详情 (JSONObject)

影响详情描述 (html)

包含有关问题如何影响组织的详细信息

影响详情描述 (html)
HTML 是一个文本区域,可以使用 html 元素。

示例

<b>The content to be displayed</b>

影响详情更新时间 (日期时间)

指示影响详情的最后更新时间 

影响详情更新时间 (日期时间)
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

value :以长格式表示的时间(自 1970 年 1 月 1 日以来的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,则使用默认格式。

影响详情更新者 (用户)

指示最后更新影响详情的用户

影响详情更新者 (用户)

示例

{
  "impact_details_updated_by": {
    "name": "test-impact_details_updated_by",
    "id": "234567890123456"
  }
}

根本原因 (JSONObject)

描述问题的原因
显示属性

根本原因 (JSONObject)

根本原因描述 (html)

包含问题根本原因的详细信息

根本原因描述 (html)
HTML 是一个文本区域,可以使用 html 元素。

示例

<b>The content to be displayed</b>

根本原因更新时间 (日期时间)

指示根本原因的最后更新时间

根本原因更新时间 (日期时间)
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

value :以长格式表示的时间(自 1970 年 1 月 1 日以来的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,则使用默认格式。

根本原因更新者 (用户)

最后更新根本原因的用户

根本原因更新者 (用户)

示例

{
  "root_cause_updated_by": {
    "name": "test-root_cause_updated_by",
    "id": "234567890123456"
  }
}

症状 (JSONObject)

描述问题对业务的影响症状
显示属性

症状 (JSONObject)

症状描述 (html)

包含问题症状的详细信息

症状描述 (html)
HTML 是一个文本区域,可以使用 html 元素。

示例

<b>The content to be displayed</b>

症状更新时间 (日期时间)

指示症状的最后更新时间

症状更新时间 (日期时间)
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

value :以长格式表示的时间(自 1970 年 1 月 1 日以来的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,则使用默认格式。

症状更新者 (用户)

最后更新症状的用户

症状更新者 (用户)

已知错误详情 (JSONObject)

描述问题的已知错误详情
显示属性

已知错误详情 (JSONObject)
指示已知错误信息

已知错误评论 (字符串)

包含有关已知错误的详细信息

已知错误评论 (字符串)
纯文本格式。不允许使用富文本或换行符。

示例

Sample Content

是否为已知错误 (布尔值)

指示问题是否为已知错误

是否为已知错误 (布尔值)
布尔值,可取两个可能值。取值为 true 和 false。

已知错误详情更新时间 (日期时间)

指示已知错误的最后更新时间

已知错误详情更新时间 (日期时间)
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

value :以长格式表示的时间(自 1970 年 1 月 1 日以来的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,则使用默认格式。

已知错误详情更新者 (用户)

指示最后更新已知错误的用户

已知错误详情更新者 (用户)

示例

{
  "known_error_details_updated_by": {
    "name": "test-known_error_details_updated_by",
    "id": "234567890123456"
  }
}

关闭详情 (JSONObject)

包含有关问题关闭的信息
显示属性

关闭详情 (JSONObject)

关闭详情评论 (字符串)

包含问题的关闭评论。

关闭详情评论 (字符串)
纯文本格式。不允许使用富文本或换行符。

示例

Sample Content

关闭代码 (关闭代码)

关闭代码表示关闭问题的原因

关闭代码 (关闭代码)

关闭详情更新时间 (日期时间)

指示关闭详情的最后更新时间

关闭详情更新时间 (日期时间)
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

value :以长格式表示的时间(自 1970 年 1 月 1 日以来的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,则使用默认格式。

关闭详情更新者 (用户)

最后更新关闭详情的用户。

关闭详情更新者 (用户)

解决详情 (JSONObject)

技术员为问题提供的解决方案
显示属性

解决详情 (JSONObject)

解决详情描述 (html)

包含问题解决方案的详细信息

解决详情描述 (html)
HTML 是一个文本区域,可以使用 html 元素。

示例

<b>The content to be displayed</b>

解决详情更新时间 (日期时间)

指示解决方案的最后更新时间

解决详情更新时间 (日期时间)
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

value :以长格式表示的时间(自 1970 年 1 月 1 日以来的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,则使用默认格式。

解决详情更新者 (用户)

最后更新解决方案的用户

解决详情更新者 (用户)

变通方案详情 (JSONObject)

技术员为问题提供的变通方案
显示属性

变通方案详情 (JSONObject)

变通方案详情描述 (html)

包含问题变通方案的详细信息

变通方案详情描述 (html)
HTML 是一个文本区域,可以使用 html 元素。

示例

<b>The content to be displayed</b>

变通方案更新时间 (日期时间)

指示变通方案的最后更新时间

变通方案更新时间 (日期时间)
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

value :以长格式表示的时间(自 1970 年 1 月 1 日以来的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,则使用默认格式。

变通方案更新者 (用户)

最后更新变通方案的用户

变通方案更新者 (用户)

显示编号 (序号)read only

问题的序列号

显示编号 (序号)

是否存在备注 (布尔值)read only

指示问题是否包含任何备注

是否存在备注 (布尔值)
布尔值,可取两个可能值。取值为 true 和 false。

更新时间 (日期时间)read only

指示问题的最后更新时间

更新时间 (日期时间)
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

value :以长格式表示的时间(自 1970 年 1 月 1 日以来的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,则使用默认格式。

生命周期 (问题生命周期)read only

描述问题生命周期及其各状态流程

生命周期 (问题生命周期)
描述问题生命周期及各状态流程

示例

{
  "lifecycle": {
    "name": "test-lifecycle",
    "id": "234567890123456"
  }
}

$ curl <service domain|custom domain>/app/<portal>/api/v3/problems\
      -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='{
    "problem": {
        "template": {
            "id": "4149000000128011",
            "name": "General Problem Template"
        },
        "problem_template_task_ids": [],
        "reported_by": {
            "id": "4149000000871029",
            "name": "John",
            "email_id": "john@zlyker.com"
        },
        "site": {
            "id": "4149000001242001",
            "name": "Base Site"
        },
        "impact": {
            "id": "4149000000008036",
            "name": "Affects Group"
        },
        "group": {
            "id": "4149000001032137",
            "name": "DBA Group"
        },
        "urgency": {
            "id": "4149000000007921",
            "name": "Normal"
        },
        "technician": {
            "id": "4149000000766091",
            "name": "John",
            "email_id": "john@zlyker.com"
        },
        "priority": {
            "id": "4149000000006803",
            "name": "Medium"
        },
        "udf_fields": {
            "udf_date3": null,
            "udf_char6": null,
            "udf_char1": "YES",
            "udf_date2": null
        },
        "status": {
            "id": "4149000000006657",
            "name": "Open"
        },
        "category": {
            "id": "4149000000006689",
            "name": "Software"
        },
        "subcategory": {
            "id": "4149000000006717",
            "name": "MS Office"
        },
        "item": {
            "id": "4149000000006773",
            "name": "item"
        },
        "due_by_time": {
            "value": 1678264620000
        },
        "closed_time": null,
        "services": [
            {
                "id": "4149000001341526",
                "name": "Communication"
            },
            {
                "id": "4149000001341618",
                "name": "Application Login"
            }
        ],
        "assets": [],
        "configuration_items": [
            {
                "id": "4149000000288117",
                "name": "Hardware Problems"
            }
        ],
        "title": "Test Problem",
        "description": "<div>Description</div>",
        "attachments": [],
        "impact_details": {
            "impact_details_description": "Impact Details"
        },
        "root_cause": {
            "root_cause_description": "Root Cause"
        },
        "symptoms": {
            "symptoms_description": "symptoms"
        },
        "resolution_details": {
            "resolution_details_description": "Resolution"
        },
        "workaround_details": {
            "workaround_details_description": "Workaround"
        }
    }
}'
// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/problems";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};
input_data = {
    "problem": {
        "template": {
            "id": "4149000000128011",
            "name": "General Problem Template"
        },
        "problem_template_task_ids": [],
        "reported_by": {
            "id": "4149000000871029",
            "name": "John",
            "email_id": "john@zlyker.com"
        },
        "site": {
            "id": "4149000001242001",
            "name": "Base Site"
        },
        "impact": {
            "id": "4149000000008036",
            "name": "Affects Group"
        },
        "group": {
            "id": "4149000001032137",
            "name": "DBA Group"
        },
        "urgency": {
            "id": "4149000000007921",
            "name": "Normal"
        },
        "technician": {
            "id": "4149000000766091",
            "name": "John",
            "email_id": "john@zlyker.com"
        },
        "priority": {
            "id": "4149000000006803",
            "name": "Medium"
        },
        "udf_fields": {
            "udf_date3": null,
            "udf_char6": null,
            "udf_char1": "YES",
            "udf_date2": null
        },
        "status": {
            "id": "4149000000006657",
            "name": "Open"
        },
        "category": {
            "id": "4149000000006689",
            "name": "Software"
        },
        "subcategory": {
            "id": "4149000000006717",
            "name": "MS Office"
        },
        "item": {
            "id": "4149000000006773",
            "name": "item"
        },
        "due_by_time": {
            "value": 1678264620000
        },
        "closed_time": null,
        "services": [
            {
                "id": "4149000001341526",
                "name": "Communication"
            },
            {
                "id": "4149000001341618",
                "name": "Application Login"
            }
        ],
        "assets": [],
        "configuration_items": [
            {
                "id": "4149000000288117",
                "name": "Hardware Problems"
            }
        ],
        "title": "Test Problem",
        "description": "<div>Description</div>",
        "attachments": [],
        "impact_details": {
            "impact_details_description": "Impact Details"
        },
        "root_cause": {
            "root_cause_description": "Root Cause"
        },
        "symptoms": {
            "symptoms_description": "symptoms"
        },
        "resolution_details": {
            "resolution_details_description": "Resolution"
        },
        "workaround_details": {
            "workaround_details_description": "Workaround"
        }
    }
};
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/problems"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
    "Authorization" = "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"
    "Content-Type" = "application/x-www-form-urlencoded"}
$input_data = @'
{
    "problem": {
        "template": {
            "id": "4149000000128011",
            "name": "General Problem Template"
        },
        "problem_template_task_ids": [],
        "reported_by": {
            "id": "4149000000871029",
            "name": "John",
            "email_id": "john@zlyker.com"
        },
        "site": {
            "id": "4149000001242001",
            "name": "Base Site"
        },
        "impact": {
            "id": "4149000000008036",
            "name": "Affects Group"
        },
        "group": {
            "id": "4149000001032137",
            "name": "DBA Group"
        },
        "urgency": {
            "id": "4149000000007921",
            "name": "Normal"
        },
        "technician": {
            "id": "4149000000766091",
            "name": "John",
            "email_id": "john@zlyker.com"
        },
        "priority": {
            "id": "4149000000006803",
            "name": "Medium"
        },
        "udf_fields": {
            "udf_date3": null,
            "udf_char6": null,
            "udf_char1": "YES",
            "udf_date2": null
        },
        "status": {
            "id": "4149000000006657",
            "name": "Open"
        },
        "category": {
            "id": "4149000000006689",
            "name": "Software"
        },
        "subcategory": {
            "id": "4149000000006717",
            "name": "MS Office"
        },
        "item": {
            "id": "4149000000006773",
            "name": "item"
        },
        "due_by_time": {
            "value": 1678264620000
        },
        "closed_time": null,
        "services": [
            {
                "id": "4149000001341526",
                "name": "Communication"
            },
            {
                "id": "4149000001341618",
                "name": "Application Login"
            }
        ],
        "assets": [],
        "configuration_items": [
            {
                "id": "4149000000288117",
                "name": "Hardware Problems"
            }
        ],
        "title": "Test Problem",
        "description": "<div>Description</div>",
        "attachments": [],
        "impact_details": {
            "impact_details_description": "Impact Details"
        },
        "root_cause": {
            "root_cause_description": "Root Cause"
        },
        "symptoms": {
            "symptoms_description": "symptoms"
        },
        "resolution_details": {
            "resolution_details_description": "Resolution"
        },
        "workaround_details": {
            "workaround_details_description": "Workaround"
        }
    }
}
'@
$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/problems"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
input_data = '''{
    "problem": {
        "template": {
            "id": "4149000000128011",
            "name": "General Problem Template"
        },
        "problem_template_task_ids": [],
        "reported_by": {
            "id": "4149000000871029",
            "name": "John",
            "email_id": "john@zlyker.com"
        },
        "site": {
            "id": "4149000001242001",
            "name": "Base Site"
        },
        "impact": {
            "id": "4149000000008036",
            "name": "Affects Group"
        },
        "group": {
            "id": "4149000001032137",
            "name": "DBA Group"
        },
        "urgency": {
            "id": "4149000000007921",
            "name": "Normal"
        },
        "technician": {
            "id": "4149000000766091",
            "name": "John",
            "email_id": "john@zlyker.com"
        },
        "priority": {
            "id": "4149000000006803",
            "name": "Medium"
        },
        "udf_fields": {
            "udf_date3": null,
            "udf_char6": null,
            "udf_char1": "YES",
            "udf_date2": null
        },
        "status": {
            "id": "4149000000006657",
            "name": "Open"
        },
        "category": {
            "id": "4149000000006689",
            "name": "Software"
        },
        "subcategory": {
            "id": "4149000000006717",
            "name": "MS Office"
        },
        "item": {
            "id": "4149000000006773",
            "name": "item"
        },
        "due_by_time": {
            "value": 1678264620000
        },
        "closed_time": null,
        "services": [
            {
                "id": "4149000001341526",
                "name": "Communication"
            },
            {
                "id": "4149000001341618",
                "name": "Application Login"
            }
        ],
        "assets": [],
        "configuration_items": [
            {
                "id": "4149000000288117",
                "name": "Hardware Problems"
            }
        ],
        "title": "Test Problem",
        "description": "<div>Description</div>",
        "attachments": [],
        "impact_details": {
            "impact_details_description": "Impact Details"
        },
        "root_cause": {
            "root_cause_description": "Root Cause"
        },
        "symptoms": {
            "symptoms_description": "symptoms"
        },
        "resolution_details": {
            "resolution_details_description": "Resolution"
        },
        "workaround_details": {
            "workaround_details_description": "Workaround"
        }
    }
}'''
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())
{
  "problem": {
    "known_error_details": {
      "known_error_details_updated_by": {
        "email_id": "john@zylker.com",
        "is_technician": true,
        "sms_mail": null,
        "mobile": null,
        "last_name": null,
        "user_scope": "internal_user",
        "sms_mail_id": null,
        "site": {
          "deleted": false,
          "name": "Base Site",
          "id": "4149000001242001",
          "is_default": true
        },
        "phone": null,
        "employee_id": null,
        "name": "John",
        "id": "4149000000871029",
        "photo_url": "https://contacts.localzoho.com/file?sample",
        "is_vip_user": false,
        "department": null,
        "first_name": "John",
        "job_title": null
      },
      "known_error_details_updated_on": {
        "display_value": "Mar 6, 2023 03:21 PM",
        "value": "1678096283689"
      },
      "known_error_comments": null,
      "is_known_error": false
    },
    "template": {
      "inactive": false,
      "name": "General Problem Template",
      "id": "4149000000128011"
    },
    "updated_time": null,
    "attachments": [],
    "display_id": {
      "display_value": "PB-140",
      "value": "140"
    },
    "description": "<div>Description</div>",
    "title": "Test Problem",
    "lifecycle": null,
    "assets": [],
    "configuration_items": [
      {
        "ci_type": {
          "id": "4149000000141328"
        },
        "name": "Hardware Problems",
        "id": "4149000000288117"
      }
    ],
    "urgency": {
      "name": "Normal",
      "id": "4149000000007921"
    },
    "close_details": {
      "close_details_updated_on": null,
      "closure_code": null,
      "close_details_comments": null,
      "close_details_updated_by": null
    },
    "rel": {
      "workarounds": null,
      "resolutions": null
    },
    "reported_by": {
      "email_id": "john@zylker.com",
      "is_technician": true,
      "sms_mail": null,
      "mobile": null,
      "last_name": null,
      "user_scope": "internal_user",
      "sms_mail_id": null,
      "site": {
        "deleted": false,
        "name": "Base Site",
        "id": "4149000001242001",
        "is_default": true
      },
      "phone": null,
      "employee_id": null,
      "name": "John",
      "id": "4149000000871029",
      "photo_url": "https://contacts.localzoho.com/file?sample",
      "is_vip_user": false,
      "department": null,
      "first_name": "John",
      "job_title": null
    },
    "id": "4149000001355051",
    "group": {
      "site": {
        "id": "4149000001242001"
      },
      "deleted": false,
      "name": "DBA Group",
      "id": "4149000001032137"
    },
    "root_cause": {
      "root_cause_updated_by": {
        "email_id": "john@zylker.com",
        "is_technician": true,
        "sms_mail": null,
        "mobile": null,
        "last_name": null,
        "user_scope": "internal_user",
        "sms_mail_id": null,
        "site": {
          "deleted": false,
          "name": "Base Site",
          "id": "4149000001242001",
          "is_default": true
        },
        "phone": null,
        "employee_id": null,
        "name": "John",
        "id": "4149000000871029",
        "photo_url": "https://contacts.localzoho.com/file?sample",
        "is_vip_user": false,
        "department": null,
        "first_name": "John",
        "job_title": null
      },
      "root_cause_description": "Root Cause",
      "root_cause_updated_on": {
        "display_value": "Mar 6, 2023 03:21 PM",
        "value": "1678096283690"
      }
    },
    "item": {
      "name": "Install",
      "id": "4149000000006773"
    },
    "resolution_details": {
      "resolution_details_updated_by": {
        "email_id": "john@zylker.com",
        "is_technician": true,
        "sms_mail": null,
        "mobile": null,
        "last_name": null,
        "user_scope": "internal_user",
        "sms_mail_id": null,
        "site": {
          "deleted": false,
          "name": "Base Site",
          "id": "4149000001242001",
          "is_default": true
        },
        "phone": null,
        "employee_id": null,
        "name": "John",
        "id": "4149000000871029",
        "photo_url": "https://contacts.localzoho.com/file?sample",
        "is_vip_user": false,
        "department": null,
        "first_name": "John",
        "job_title": null
      },
      "resolution_details_description": "Resolution",
      "resolution_details_updated_on": {
        "display_value": "Mar 6, 2023 03:21 PM",
        "value": "1678096283690"
      }
    },
    "workaround_details": {
      "workaround_details_description": "Workaround",
      "workaround_details_updated_by": {
        "email_id": "john@zylker.com",
        "is_technician": true,
        "sms_mail": null,
        "mobile": null,
        "last_name": null,
        "user_scope": "internal_user",
        "sms_mail_id": null,
        "site": {
          "deleted": false,
          "name": "Base Site",
          "id": "4149000001242001",
          "is_default": true
        },
        "phone": null,
        "employee_id": null,
        "name": "John",
        "id": "4149000000871029",
        "photo_url": "https://contacts.localzoho.com/file?sample",
        "is_vip_user": false,
        "department": null,
        "first_name": "John",
        "job_title": null
      },
      "workaround_details_updated_on": {
        "display_value": "Mar 6, 2023 03:21 PM",
        "value": "1678096283690"
      }
    },
    "impact": {
      "name": "Affects Group",
      "id": "4149000000008036"
    },
    "technician": {
      "email_id": "chine@haods.com",
      "is_technician": true,
      "sms_mail": null,
      "mobile": null,
      "last_name": null,
      "user_scope": "internal_user",
      "sms_mail_id": null,
      "cost_per_hour": "0",
      "site": {
        "id": "4149000001242001"
      },
      "phone": null,
      "employee_id": null,
      "name": "china ech",
      "id": "4149000000766091",
      "photo_url": "https://contacts.localzoho.com/file?exp=10&ID=-1&t=user&height=60&width=60",
      "is_vip_user": false,
      "department": null,
      "first_name": "china ech",
      "job_title": null
    },
    "closed_time": null,
    "services": [
      {
        "inactive": false,
        "name": "Communication",
        "id": "4149000001341526",
        "sort_index": 0
      },
      {
        "inactive": false,
        "name": "Application Login",
        "id": "4149000001341618",
        "sort_index": 0
      }
    ],
    "priority": {
      "color": "#ff6600",
      "name": "Medium",
      "id": "4149000000006803"
    },
    "due_by_time": {
      "display_value": "Mar 8, 2023 02:07 PM",
      "value": "1678264620000"
    },
    "symptoms": {
      "symptoms_updated_by": {
        "email_id": "john@zylker.com",
        "is_technician": true,
        "sms_mail": null,
        "mobile": null,
        "last_name": null,
        "user_scope": "internal_user",
        "sms_mail_id": null,
        "site": {
          "deleted": false,
          "name": "Base Site",
          "id": "4149000001242001",
          "is_default": true
        },
        "phone": null,
        "employee_id": null,
        "name": "John",
        "id": "4149000000871029",
        "photo_url": "https://contacts.localzoho.com/file?sample",
        "is_vip_user": false,
        "department": null,
        "first_name": "John",
        "job_title": null
      },
      "symptoms_description": "symptoms",
      "symptoms_updated_on": {
        "display_value": "Mar 6, 2023 03:21 PM",
        "value": "1678096283689"
      }
    },
    "site": {
      "deleted": false,
      "name": "Base Site",
      "id": "4149000001242001",
      "is_default": true
    },
    "udf_fields": {
      "udf_char6": null,
      "udf_char1": "YES",
      "udf_char2": null,
      "udf_char5": null,
      "udf_ref2": null,
      "udf_ref1": null,
      "udf_ref8": null,
      "udf_ref7": null,
      "udf_ref6": null,
      "udf_ref5": null,
      "udf_ref4": null,
      "udf_date3": null,
      "udf_date2": null,
      "udf_ref3": null
    },
    "impact_details": {
      "impact_details_updated_on": {
        "display_value": "Mar 6, 2023 03:21 PM",
        "value": "1678096283690"
      },
      "impact_details_updated_by": {
        "email_id": "john@zylker.com",
        "is_technician": true,
        "sms_mail": null,
        "mobile": null,
        "last_name": null,
        "user_scope": "internal_user",
        "sms_mail_id": null,
        "site": {
          "deleted": false,
          "name": "Base Site",
          "id": "4149000001242001",
          "is_default": true
        },
        "phone": null,
        "employee_id": null,
        "name": "John",
        "id": "4149000000871029",
        "photo_url": "https://contacts.localzoho.com/file?sample",
        "is_vip_user": false,
        "department": null,
        "first_name": "John",
        "job_title": null
      },
      "impact_details_description": "Impact Details"
    },
    "reported_time": {
      "display_value": "Mar 6, 2023 03:21 PM",
      "value": "1678096283612"
    },
    "problem_template_task_ids": [],
    "category": {
      "deleted": false,
      "name": "Software",
      "id": "4149000000006689"
    },
    "subcategory": {
      "name": "MS Office",
      "id": "4149000000006717"
    },
    "notes_present": false,
    "status": {
      "in_progress": true,
      "internal_name": "Open",
      "stop_timer": false,
      "color": "#0066ff",
      "name": "Open",
      "id": "4149000000006657"
    }
  },
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

编辑问题

此操作帮助您编辑一个问题。

Url

<service domain|custom domain>/app/<portal>/api/v3/problems/{problem_id}

属性

id (长整数)
问题创建时分配的唯一标识符

id (长整数)
被认为具有较大值的数字位

示例

234759602834500

标题 (字符串)
问题的标题

标题 (字符串)
纯文本格式。不允许使用富文本或换行符。

示例

Sample Content

描述 (html)
问题描述

描述 (html)
HTML 是一个文本区域,可以使用 html 元素。

示例

<b>The content to be displayed</b>

报告时间 (日期时间)
表示问题的报告时间

报告时间 (日期时间)
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

value :以长格式表示的时间(自 1970 年 1 月 1 日以来的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,则使用默认格式。

截止时间 (日期时间)
表示问题的截止时间

截止时间 (日期时间)
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

value :以长格式表示的时间(自 1970 年 1 月 1 日以来的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,则使用默认格式。

关闭时间 (日期时间)
表示问题的关闭时间

关闭时间 (日期时间)
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

value :以长格式表示的时间(自 1970 年 1 月 1 日以来的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,则使用默认格式。

更多属性 展开全部

报告者 (用户)

表示报告该问题的用户

报告者 (用户)
表示报告问题的用户

示例

{
  "reported_by": {
    "name": "test-reported_by",
    "id": "234567890123456"
  }
}

类别 (类别)

指示与问题相关的CI的类别。

类别 (类别)
指示与问题相关的CI的类别。

示例

{
  "category": {
    "name": "test-category",
    "id": "234567890123456"
  }
}

影响 (影响)

指示问题的影响

影响 (影响)
指示问题对业务、组或用户的影响

示例

{
  "impact": {
    "name": "test-impact",
    "id": "234567890123456"
  }
}

优先级 (优先级)

指示问题的优先级

优先级 (优先级)
指示问题的优先级。

示例

{
  "priority": {
    "name": "test-priority",
    "id": "234567890123456"
  }
}

子类别 (子类别)

分配在类别下选择的相关CI的子类别

子类别 (子类别)
指示在类别下选择的相关CI的子类别

示例

{
  "subcategory": {
    "name": "test-subcategory",
    "id": "234567890123456"
  }
}

项目 (项目)

指示项目分类

项目 (项目)
指示问题的项目分类。

示例

{
  "item": {
    "name": "test-item",
    "id": "234567890123456"
  }
}

紧急程度 (紧急程度)

指示问题的紧急程度

紧急程度 (紧急程度)
指示问题的紧急级别

示例

{
  "urgency": {
    "name": "test-urgency",
    "id": "234567890123456"
  }
}

站点 (站点)

指示问题发生的站点

站点 (站点)
指示问题发生的站点

示例

{
  "site": {
    "name": "test-site",
    "id": "234567890123456"
  }
}

(组)

问题的分配组

(组)
指示问题的分配组

示例

{
  "group": {
    "name": "test-group",
    "id": "234567890123456"
  }
}

技术员 (技术员)

指示分配给问题的技术员

技术员 (技术员)
指示分配给问题的技术员

示例

{
  "technician": {
    "email_id": "andrews@zmail.com",
    "name": "test-technician",
    "id": "234567890123456"
  }
}

状态 (状态)

指示问题的当前状态

状态 (状态)
指示问题的当前状态

示例

{
  "status": {
    "name": "Open",
    "id": "234567890123456"
  }
}

资产 (资产)

指示可能因该问题受影响的资产。

资产 (资产)
指示可能因问题受影响的资产

示例

{
  "assets": [
    {
      "name": "test-assets",
      "id": "234567890123456"
    }
  ]
}

服务 (服务类别)

可能因该问题受影响的服务

服务 (服务类别)
可能因该问题受影响的服务

示例

{
  "services": {
    "name": "test-services",
    "id": "234567890123456"
  }
}

用户定义字段 (用户定义字段)

包含问题的用户定义字段值

用户定义字段 (用户定义字段)

附件 (问题附件)

附加到问题的文件。最多可附加10个附件。

附件 (问题附件)
指示附加到问题的文件。最多只可附加10个附件。

示例

{
  "attachments": {
    "name": "test-attachments",
    "id": "234567890123456"
  }
}

会话 (会话)

无描述

会话 (会话)

模板 (问题模板)

指示用于创建问题的模板

模板 (问题模板)
指示用于创建问题的模板

示例

{
  "template": {
    "name": "test-template",
    "id": "234567890123456"
  }
}

配置项 (配置项)

可能因该问题受影响的配置项

配置项 (配置项)
可能因该问题受影响的配置项

示例

{
  "configuration_items": {
    "name": "test-configuration_items",
    "id": "234567890123456"
  }
}

影响详情 (JSONObject)

描述问题将如何影响业务
显示属性

影响详情 (JSONObject)

影响详情描述 (html)

包含有关问题如何影响组织的详细信息

影响详情描述 (html)
HTML 是一个文本区域,可以使用 html 元素。

示例

<b>The content to be displayed</b>

影响详情更新时间 (日期时间)

指示影响详情的最后更新时间 

影响详情更新时间 (日期时间)
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

value :以长格式表示的时间(自 1970 年 1 月 1 日以来的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,则使用默认格式。

影响详情更新者 (用户)

指示最后更新影响详情的用户

影响详情更新者 (用户)

示例

{
  "impact_details_updated_by": {
    "name": "test-impact_details_updated_by",
    "id": "234567890123456"
  }
}

根本原因 (JSONObject)

描述问题的原因
显示属性

根本原因 (JSONObject)

根本原因描述 (html)

包含问题根本原因的详细信息

根本原因描述 (html)
HTML 是一个文本区域,可以使用 html 元素。

示例

<b>The content to be displayed</b>

根本原因更新时间 (日期时间)

指示根本原因的最后更新时间

根本原因更新时间 (日期时间)
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

value :以长格式表示的时间(自 1970 年 1 月 1 日以来的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,则使用默认格式。

根本原因更新者 (用户)

最后更新根本原因的用户

根本原因更新者 (用户)

示例

{
  "root_cause_updated_by": {
    "name": "test-root_cause_updated_by",
    "id": "234567890123456"
  }
}

症状 (JSONObject)

描述问题对业务的影响症状
显示属性

症状 (JSONObject)

症状描述 (html)

包含问题症状的详细信息

症状描述 (html)
HTML 是一个文本区域,可以使用 html 元素。

示例

<b>The content to be displayed</b>

症状更新时间 (日期时间)

指示症状的最后更新时间

症状更新时间 (日期时间)
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

value :以长格式表示的时间(自 1970 年 1 月 1 日以来的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,则使用默认格式。

症状更新者 (用户)

最后更新症状的用户

症状更新者 (用户)

已知错误详情 (JSONObject)

描述问题的已知错误详情
显示属性

已知错误详情 (JSONObject)
指示已知错误信息

已知错误评论 (字符串)

包含有关已知错误的详细信息

已知错误评论 (字符串)
纯文本格式。不允许使用富文本或换行符。

示例

Sample Content

是否为已知错误 (布尔值)

指示问题是否为已知错误

是否为已知错误 (布尔值)
布尔值,可取两个可能值。取值为 true 和 false。

已知错误详情更新时间 (日期时间)

指示已知错误的最后更新时间

已知错误详情更新时间 (日期时间)
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

value :以长格式表示的时间(自 1970 年 1 月 1 日以来的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,则使用默认格式。

已知错误详情更新者 (用户)

指示最后更新已知错误的用户

已知错误详情更新者 (用户)

示例

{
  "known_error_details_updated_by": {
    "name": "test-known_error_details_updated_by",
    "id": "234567890123456"
  }
}

关闭详情 (JSONObject)

包含有关问题关闭的信息
显示属性

关闭详情 (JSONObject)

关闭详情评论 (字符串)

包含问题的关闭评论。

关闭详情评论 (字符串)
纯文本格式。不允许使用富文本或换行符。

示例

Sample Content

关闭代码 (关闭代码)

关闭代码表示关闭问题的原因

关闭代码 (关闭代码)

关闭详情更新时间 (日期时间)

指示关闭详情的最后更新时间

关闭详情更新时间 (日期时间)
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

value :以长格式表示的时间(自 1970 年 1 月 1 日以来的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,则使用默认格式。

关闭详情更新者 (用户)

最后更新关闭详情的用户。

关闭详情更新者 (用户)

解决详情 (JSONObject)

技术员为问题提供的解决方案
显示属性

解决详情 (JSONObject)

解决详情描述 (html)

包含问题解决方案的详细信息

解决详情描述 (html)
HTML 是一个文本区域,可以使用 html 元素。

示例

<b>The content to be displayed</b>

解决详情更新时间 (日期时间)

指示解决方案的最后更新时间

解决详情更新时间 (日期时间)
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

value :以长格式表示的时间(自 1970 年 1 月 1 日以来的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,则使用默认格式。

解决详情更新者 (用户)

最后更新解决方案的用户

解决详情更新者 (用户)

变通方案详情 (JSONObject)

技术员为问题提供的变通方案
显示属性

变通方案详情 (JSONObject)

变通方案详情描述 (html)

包含问题变通方案的详细信息

变通方案详情描述 (html)
HTML 是一个文本区域,可以使用 html 元素。

示例

<b>The content to be displayed</b>

变通方案更新时间 (日期时间)

指示变通方案的最后更新时间

变通方案更新时间 (日期时间)
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

value :以长格式表示的时间(自 1970 年 1 月 1 日以来的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,则使用默认格式。

变通方案更新者 (用户)

最后更新变通方案的用户

变通方案更新者 (用户)

显示编号 (序号)read only

问题的序列号

显示编号 (序号)

是否存在备注 (布尔值)read only

指示问题是否包含任何备注

是否存在备注 (布尔值)
布尔值,可取两个可能值。取值为 true 和 false。

更新时间 (日期时间)read only

指示问题的最后更新时间

更新时间 (日期时间)
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

value :以长格式表示的时间(自 1970 年 1 月 1 日以来的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,则使用默认格式。

生命周期 (问题生命周期)read only

描述问题生命周期及其各状态流程

生命周期 (问题生命周期)
描述问题生命周期及各状态流程

示例

{
  "lifecycle": {
    "name": "test-lifecycle",
    "id": "234567890123456"
  }
}

$ curl <service domain|custom domain>/app/<portal>/api/v3/problems/{problem_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='{
    "problem": {
        "template": {
            "id": "4149000000128011",
            "name": "General Problem Template"
        },
        "problem_template_task_ids": [],
        "reported_by": {
            "id": "4149000000871029",
            "name": "John",
            "email_id": "john@zlyker.com"
        },
        "site": {
            "id": "4149000001242001",
            "name": "Base Site"
        },
        "impact": {
            "id": "4149000000008036",
            "name": "Affects Group"
        },
        "group": {
            "id": "4149000001032137",
            "name": "DBA Group"
        },
        "urgency": {
            "id": "4149000000007921",
            "name": "Normal"
        },
        "technician": {
            "id": "4149000000766091",
            "name": "John",
            "email_id": "john@zlyker.com"
        },
        "priority": {
            "id": "4149000000006803",
            "name": "Medium"
        },
        "udf_fields": {
            "udf_date3": null,
            "udf_char6": null,
            "udf_char1": "YES",
            "udf_date2": null
        },
        "status": {
            "id": "4149000000006661",
            "name": "Closed"
        },
        "category": {
            "id": "4149000000006689",
            "name": "Software"
        },
        "subcategory": {
            "id": "4149000000006717",
            "name": "MS Office"
        },
        "item": {
            "id": "4149000000006773",
            "name": "item"
        },
        "due_by_time": {
            "value": 1678264620000
        },
        "close_details": {
            "closure_code": {
                "id": "4149000001015012",
                "name": "Success"
            },
            "close_details_comments": "Problem Resolved"
        },
        "title": "Edit Test Problem",
        "resolution_details": {
            "resolution_details_description": "Resolution"
        },
        "workaround_details": {
            "workaround_details_description": "Workaround"
        }
    }
}'
// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/problems/{problem_id}";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};
input_data = {
    "problem": {
        "template": {
            "id": "4149000000128011",
            "name": "General Problem Template"
        },
        "problem_template_task_ids": [],
        "reported_by": {
            "id": "4149000000871029",
            "name": "John",
            "email_id": "john@zlyker.com"
        },
        "site": {
            "id": "4149000001242001",
            "name": "Base Site"
        },
        "impact": {
            "id": "4149000000008036",
            "name": "Affects Group"
        },
        "group": {
            "id": "4149000001032137",
            "name": "DBA Group"
        },
        "urgency": {
            "id": "4149000000007921",
            "name": "Normal"
        },
        "technician": {
            "id": "4149000000766091",
            "name": "John",
            "email_id": "john@zlyker.com"
        },
        "priority": {
            "id": "4149000000006803",
            "name": "Medium"
        },
        "udf_fields": {
            "udf_date3": null,
            "udf_char6": null,
            "udf_char1": "YES",
            "udf_date2": null
        },
        "status": {
            "id": "4149000000006661",
            "name": "Closed"
        },
        "category": {
            "id": "4149000000006689",
            "name": "Software"
        },
        "subcategory": {
            "id": "4149000000006717",
            "name": "MS Office"
        },
        "item": {
            "id": "4149000000006773",
            "name": "item"
        },
        "due_by_time": {
            "value": 1678264620000
        },
        "close_details": {
            "closure_code": {
                "id": "4149000001015012",
                "name": "Success"
            },
            "close_details_comments": "Problem Resolved"
        },
        "title": "Edit Test Problem",
        "resolution_details": {
            "resolution_details_description": "Resolution"
        },
        "workaround_details": {
            "workaround_details_description": "Workaround"
        }
    }
};
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/problems/{problem_id}"
$headers = @{"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
$input_data = @'
{
    "problem": {
        "template": {
            "id": "4149000000128011",
            "name": "General Problem Template"
        },
        "problem_template_task_ids": [],
        "reported_by": {
            "id": "4149000000871029",
            "name": "John",
            "email_id": "john@zlyker.com"
        },
        "site": {
            "id": "4149000001242001",
            "name": "Base Site"
        },
        "impact": {
            "id": "4149000000008036",
            "name": "Affects Group"
        },
        "group": {
            "id": "4149000001032137",
            "name": "DBA Group"
        },
        "urgency": {
            "id": "4149000000007921",
            "name": "Normal"
        },
        "technician": {
            "id": "4149000000766091",
            "name": "John",
            "email_id": "john@zlyker.com"
        },
        "priority": {
            "id": "4149000000006803",
            "name": "Medium"
        },
        "udf_fields": {
            "udf_date3": null,
            "udf_char6": null,
            "udf_char1": "YES",
            "udf_date2": null
        },
        "status": {
            "id": "4149000000006661",
            "name": "Closed"
        },
        "category": {
            "id": "4149000000006689",
            "name": "Software"
        },
        "subcategory": {
            "id": "4149000000006717",
            "name": "MS Office"
        },
        "item": {
            "id": "4149000000006773",
            "name": "item"
        },
        "due_by_time": {
            "value": 1678264620000
        },
        "close_details": {
            "closure_code": {
                "id": "4149000001015012",
                "name": "Success"
            },
            "close_details_comments": "Problem Resolved"
        },
        "title": "Edit Test Problem",
        "resolution_details": {
            "resolution_details_description": "Resolution"
        },
        "workaround_details": {
            "workaround_details_description": "Workaround"
        }
    }
}
'@
$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/problems/{problem_id}"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
input_data = '''{
    "problem": {
        "template": {
            "id": "4149000000128011",
            "name": "General Problem Template"
        },
        "problem_template_task_ids": [],
        "reported_by": {
            "id": "4149000000871029",
            "name": "John",
            "email_id": "john@zlyker.com"
        },
        "site": {
            "id": "4149000001242001",
            "name": "Base Site"
        },
        "impact": {
            "id": "4149000000008036",
            "name": "Affects Group"
        },
        "group": {
            "id": "4149000001032137",
            "name": "DBA Group"
        },
        "urgency": {
            "id": "4149000000007921",
            "name": "Normal"
        },
        "technician": {
            "id": "4149000000766091",
            "name": "John",
            "email_id": "john@zlyker.com"
        },
        "priority": {
            "id": "4149000000006803",
            "name": "Medium"
        },
        "udf_fields": {
            "udf_date3": null,
            "udf_char6": null,
            "udf_char1": "YES",
            "udf_date2": null
        },
        "status": {
            "id": "4149000000006661",
            "name": "Closed"
        },
        "category": {
            "id": "4149000000006689",
            "name": "Software"
        },
        "subcategory": {
            "id": "4149000000006717",
            "name": "MS Office"
        },
        "item": {
            "id": "4149000000006773",
            "name": "item"
        },
        "due_by_time": {
            "value": 1678264620000
        },
        "close_details": {
            "closure_code": {
                "id": "4149000001015012",
                "name": "Success"
            },
            "close_details_comments": "Problem Resolved"
        },
        "title": "Edit Test Problem",
        "resolution_details": {
            "resolution_details_description": "Resolution"
        },
        "workaround_details": {
            "workaround_details_description": "Workaround"
        }
    }
}'''
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())
{
  "problem": {
    "known_error_details": {
      "known_error_details_updated_by": {
        "email_id": "john@zlyker.com",
        "is_technician": true,
        "sms_mail": null,
        "mobile": null,
        "last_name": null,
        "user_scope": "internal_user",
        "sms_mail_id": null,
        "site": {
          "deleted": false,
          "name": "Base Site",
          "id": "4149000001242001",
          "is_default": true
        },
        "phone": null,
        "employee_id": null,
        "name": "John",
        "id": "4149000000871029",
        "photo_url": "https://contacts.localzoho.com/file?sample",
        "is_vip_user": false,
        "department": null,
        "first_name": "John",
        "job_title": null
      },
      "known_error_details_updated_on": {
        "display_value": "Mar 6, 2023 03:21 PM",
        "value": "1678096283689"
      },
      "known_error_comments": null,
      "is_known_error": false
    },
    "template": {
      "inactive": false,
      "name": "General Problem Template",
      "id": "4149000000128011"
    },
    "updated_time": {
      "display_value": "Mar 6, 2023 03:34 PM",
      "value": "1678097051883"
    },
    "attachments": [],
    "display_id": {
      "display_value": "PB-140",
      "value": "140"
    },
    "description": "<div>Description</div>",
    "title": "Edit Test Problem",
    "lifecycle": null,
    "assets": [],
    "configuration_items": [
      {
        "ci_type": {
          "id": "4149000000141328"
        },
        "name": "Hardware Problems",
        "id": "4149000000288117"
      }
    ],
    "urgency": {
      "name": "Normal",
      "id": "4149000000007921"
    },
    "close_details": {
      "close_details_updated_on": {
        "display_value": "Mar 6, 2023 03:34 PM",
        "value": "1678097051891"
      },
      "closure_code": {
        "name": "Success",
        "id": "4149000001015012"
      },
      "close_details_comments": "Problem Resolved",
      "close_details_updated_by": {
        "email_id": "john@zlyker.com",
        "is_technician": true,
        "sms_mail": null,
        "mobile": null,
        "last_name": null,
        "user_scope": "internal_user",
        "sms_mail_id": null,
        "site": {
          "deleted": false,
          "name": "Base Site",
          "id": "4149000001242001",
          "is_default": true
        },
        "phone": null,
        "employee_id": null,
        "name": "John",
        "id": "4149000000871029",
        "photo_url": "https://contacts.localzoho.com/file?sample",
        "is_vip_user": false,
        "department": null,
        "first_name": "John",
        "job_title": null
      }
    },
    "rel": {
      "workarounds": null,
      "resolutions": null
    },
    "reported_by": {
      "email_id": "john@zlyker.com",
      "is_technician": true,
      "sms_mail": null,
      "mobile": null,
      "last_name": null,
      "user_scope": "internal_user",
      "sms_mail_id": null,
      "site": {
        "deleted": false,
        "name": "Base Site",
        "id": "4149000001242001",
        "is_default": true
      },
      "phone": null,
      "employee_id": null,
      "name": "John",
      "id": "4149000000871029",
      "photo_url": "https://contacts.localzoho.com/file?sample",
      "is_vip_user": false,
      "department": null,
      "first_name": "John",
      "job_title": null
    },
    "id": "4149000001355051",
    "group": {
      "site": {
        "id": "4149000001242001"
      },
      "deleted": false,
      "name": "DBA Group",
      "id": "4149000001032137"
    },
    "root_cause": {
      "root_cause_updated_by": {
        "email_id": "john@zlyker.com",
        "is_technician": true,
        "sms_mail": null,
        "mobile": null,
        "last_name": null,
        "user_scope": "internal_user",
        "sms_mail_id": null,
        "site": {
          "deleted": false,
          "name": "Base Site",
          "id": "4149000001242001",
          "is_default": true
        },
        "phone": null,
        "employee_id": null,
        "name": "John",
        "id": "4149000000871029",
        "photo_url": "https://contacts.localzoho.com/file?sample",
        "is_vip_user": false,
        "department": null,
        "first_name": "John",
        "job_title": null
      },
      "root_cause_description": "Root Cause",
      "root_cause_updated_on": {
        "display_value": "Mar 6, 2023 03:21 PM",
        "value": "1678096283690"
      }
    },
    "item": {
      "name": "Install",
      "id": "4149000000006773"
    },
    "resolution_details": {
      "resolution_details_updated_by": {
        "email_id": "john@zlyker.com",
        "is_technician": true,
        "sms_mail": null,
        "mobile": null,
        "last_name": null,
        "user_scope": "internal_user",
        "sms_mail_id": null,
        "site": {
          "deleted": false,
          "name": "Base Site",
          "id": "4149000001242001",
          "is_default": true
        },
        "phone": null,
        "employee_id": null,
        "name": "John",
        "id": "4149000000871029",
        "photo_url": "https://contacts.localzoho.com/file?sample",
        "is_vip_user": false,
        "department": null,
        "first_name": "John",
        "job_title": null
      },
      "resolution_details_description": "Resolution",
      "resolution_details_updated_on": {
        "display_value": "Mar 6, 2023 03:21 PM",
        "value": "1678096283690"
      }
    },
    "workaround_details": {
      "workaround_details_description": "Workaround",
      "workaround_details_updated_by": {
        "email_id": "john@zlyker.com",
        "is_technician": true,
        "sms_mail": null,
        "mobile": null,
        "last_name": null,
        "user_scope": "internal_user",
        "sms_mail_id": null,
        "site": {
          "deleted": false,
          "name": "Base Site",
          "id": "4149000001242001",
          "is_default": true
        },
        "phone": null,
        "employee_id": null,
        "name": "John",
        "id": "4149000000871029",
        "photo_url": "https://contacts.localzoho.com/file?sample",
        "is_vip_user": false,
        "department": null,
        "first_name": "John",
        "job_title": null
      },
      "workaround_details_updated_on": {
        "display_value": "Mar 6, 2023 03:21 PM",
        "value": "1678096283690"
      }
    },
    "impact": {
      "name": "Affects Group",
      "id": "4149000000008036"
    },
    "technician": {
      "email_id": "chine@haods.com",
      "is_technician": true,
      "sms_mail": null,
      "mobile": null,
      "last_name": null,
      "user_scope": "internal_user",
      "sms_mail_id": null,
      "cost_per_hour": "0",
      "site": {
        "id": "4149000001242001"
      },
      "phone": null,
      "employee_id": null,
      "name": "china ech",
      "id": "4149000000766091",
      "photo_url": "https://contacts.localzoho.com/file?exp=10&ID=-1&t=user&height=60&width=60",
      "is_vip_user": false,
      "department": null,
      "first_name": "china ech",
      "job_title": null
    },
    "closed_time": {
      "display_value": "Mar 6, 2023 03:34 PM",
      "value": "1678097051885"
    },
    "services": [
      {
        "inactive": false,
        "name": "Communication",
        "id": "4149000001341526",
        "sort_index": 0
      },
      {
        "inactive": false,
        "name": "Application Login",
        "id": "4149000001341618",
        "sort_index": 0
      }
    ],
    "priority": {
      "color": "#ff6600",
      "name": "Medium",
      "id": "4149000000006803"
    },
    "due_by_time": {
      "display_value": "Mar 8, 2023 02:07 PM",
      "value": "1678264620000"
    },
    "symptoms": {
      "symptoms_updated_by": {
        "email_id": "john@zlyker.com",
        "is_technician": true,
        "sms_mail": null,
        "mobile": null,
        "last_name": null,
        "user_scope": "internal_user",
        "sms_mail_id": null,
        "site": {
          "deleted": false,
          "name": "Base Site",
          "id": "4149000001242001",
          "is_default": true
        },
        "phone": null,
        "employee_id": null,
        "name": "John",
        "id": "4149000000871029",
        "photo_url": "https://contacts.localzoho.com/file?sample",
        "is_vip_user": false,
        "department": null,
        "first_name": "John",
        "job_title": null
      },
      "symptoms_description": "symptoms",
      "symptoms_updated_on": {
        "display_value": "Mar 6, 2023 03:21 PM",
        "value": "1678096283689"
      }
    },
    "site": {
      "deleted": false,
      "name": "Base Site",
      "id": "4149000001242001",
      "is_default": true
    },
    "udf_fields": {
      "udf_char6": null,
      "udf_char1": "YES",
      "udf_char2": null,
      "udf_char5": null,
      "udf_ref2": null,
      "udf_ref1": null,
      "udf_ref8": null,
      "udf_ref7": null,
      "udf_ref6": null,
      "udf_ref5": null,
      "udf_ref4": null,
      "udf_date3": null,
      "udf_date2": null,
      "udf_ref3": null
    },
    "impact_details": {
      "impact_details_updated_on": {
        "display_value": "Mar 6, 2023 03:21 PM",
        "value": "1678096283690"
      },
      "impact_details_updated_by": {
        "email_id": "john@zlyker.com",
        "is_technician": true,
        "sms_mail": null,
        "mobile": null,
        "last_name": null,
        "user_scope": "internal_user",
        "sms_mail_id": null,
        "site": {
          "deleted": false,
          "name": "Base Site",
          "id": "4149000001242001",
          "is_default": true
        },
        "phone": null,
        "employee_id": null,
        "name": "John",
        "id": "4149000000871029",
        "photo_url": "https://contacts.localzoho.com/file?sample",
        "is_vip_user": false,
        "department": null,
        "first_name": "John",
        "job_title": null
      },
      "impact_details_description": "Impact Details"
    },
    "reported_time": {
      "display_value": "Mar 6, 2023 03:21 PM",
      "value": "1678096283612"
    },
    "problem_template_task_ids": [],
    "category": {
      "deleted": false,
      "name": "Software",
      "id": "4149000000006689"
    },
    "subcategory": {
      "name": "MS Office",
      "id": "4149000000006717"
    },
    "notes_present": false,
    "status": {
      "in_progress": false,
      "internal_name": "Closed",
      "stop_timer": false,
      "color": "#006600",
      "name": "Closed",
      "id": "4149000000006661"
    }
  },
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

获取问题

此操作帮助您获取一个问题。

Url

<service domain|custom domain>/app/<portal>/api/v3/problems/{problem_id}

属性

id (长整数)
问题创建时分配的唯一标识符

id (长整数)
被认为具有较大值的数字位

示例

234759602834500

标题 (字符串)
问题的标题

标题 (字符串)
纯文本格式。不允许使用富文本或换行符。

示例

Sample Content

描述 (html)
问题描述

描述 (html)
HTML 是一个文本区域,可以使用 html 元素。

示例

<b>The content to be displayed</b>

报告时间 (日期时间)
表示问题的报告时间

报告时间 (日期时间)
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

value :以长格式表示的时间(自 1970 年 1 月 1 日以来的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,则使用默认格式。

截止时间 (日期时间)
表示问题的截止时间

截止时间 (日期时间)
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

value :以长格式表示的时间(自 1970 年 1 月 1 日以来的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,则使用默认格式。

关闭时间 (日期时间)
表示问题的关闭时间

关闭时间 (日期时间)
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

value :以长格式表示的时间(自 1970 年 1 月 1 日以来的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,则使用默认格式。

更多属性 展开全部

报告者 (用户)

表示报告该问题的用户

报告者 (用户)
表示报告问题的用户

示例

{
  "reported_by": {
    "name": "test-reported_by",
    "id": "234567890123456"
  }
}

类别 (类别)

指示与问题相关的CI的类别。

类别 (类别)
指示与问题相关的CI的类别。

示例

{
  "category": {
    "name": "test-category",
    "id": "234567890123456"
  }
}

影响 (影响)

指示问题的影响

影响 (影响)
指示问题对业务、组或用户的影响

示例

{
  "impact": {
    "name": "test-impact",
    "id": "234567890123456"
  }
}

优先级 (优先级)

指示问题的优先级

优先级 (优先级)
指示问题的优先级。

示例

{
  "priority": {
    "name": "test-priority",
    "id": "234567890123456"
  }
}

子类别 (子类别)

分配在类别下选择的相关CI的子类别

子类别 (子类别)
指示在类别下选择的相关CI的子类别

示例

{
  "subcategory": {
    "name": "test-subcategory",
    "id": "234567890123456"
  }
}

项目 (项目)

指示项目分类

项目 (项目)
指示问题的项目分类。

示例

{
  "item": {
    "name": "test-item",
    "id": "234567890123456"
  }
}

紧急程度 (紧急程度)

指示问题的紧急程度

紧急程度 (紧急程度)
指示问题的紧急级别

示例

{
  "urgency": {
    "name": "test-urgency",
    "id": "234567890123456"
  }
}

站点 (站点)

指示问题发生的站点

站点 (站点)
指示问题发生的站点

示例

{
  "site": {
    "name": "test-site",
    "id": "234567890123456"
  }
}

(组)

问题的分配组

(组)
指示问题的分配组

示例

{
  "group": {
    "name": "test-group",
    "id": "234567890123456"
  }
}

技术员 (技术员)

指示分配给问题的技术员

技术员 (技术员)
指示分配给问题的技术员

示例

{
  "technician": {
    "email_id": "andrews@zmail.com",
    "name": "test-technician",
    "id": "234567890123456"
  }
}

状态 (状态)

指示问题的当前状态

状态 (状态)
指示问题的当前状态

示例

{
  "status": {
    "name": "Open",
    "id": "234567890123456"
  }
}

资产 (资产)

指示可能因该问题受影响的资产。

资产 (资产)
指示可能因问题受影响的资产

示例

{
  "assets": [
    {
      "name": "test-assets",
      "id": "234567890123456"
    }
  ]
}

服务 (服务类别)

可能因该问题受影响的服务

服务 (服务类别)
可能因该问题受影响的服务

示例

{
  "services": {
    "name": "test-services",
    "id": "234567890123456"
  }
}

用户定义字段 (用户定义字段)

包含问题的用户定义字段值

用户定义字段 (用户定义字段)

附件 (问题附件)

附加到问题的文件。最多可附加10个附件。

附件 (问题附件)
指示附加到问题的文件。最多只可附加10个附件。

示例

{
  "attachments": {
    "name": "test-attachments",
    "id": "234567890123456"
  }
}

模板 (问题模板)

指示用于创建问题的模板

模板 (问题模板)
指示用于创建问题的模板

示例

{
  "template": {
    "name": "test-template",
    "id": "234567890123456"
  }
}

配置项 (配置项)

可能因该问题受影响的配置项

配置项 (配置项)
可能因该问题受影响的配置项

示例

{
  "configuration_items": {
    "name": "test-configuration_items",
    "id": "234567890123456"
  }
}

影响详情 (JSONObject)

描述问题将如何影响业务
显示属性

影响详情 (JSONObject)

影响详情描述 (html)

包含有关问题如何影响组织的详细信息

影响详情描述 (html)
HTML 是一个文本区域,可以使用 html 元素。

示例

<b>The content to be displayed</b>

影响详情更新时间 (日期时间)

指示影响详情的最后更新时间 

影响详情更新时间 (日期时间)
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

value :以长格式表示的时间(自 1970 年 1 月 1 日以来的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,则使用默认格式。

影响详情更新者 (用户)

指示最后更新影响详情的用户

影响详情更新者 (用户)

示例

{
  "impact_details_updated_by": {
    "name": "test-impact_details_updated_by",
    "id": "234567890123456"
  }
}

根本原因 (JSONObject)

描述问题的原因
显示属性

根本原因 (JSONObject)

根本原因描述 (html)

包含问题根本原因的详细信息

根本原因描述 (html)
HTML 是一个文本区域,可以使用 html 元素。

示例

<b>The content to be displayed</b>

根本原因更新时间 (日期时间)

指示根本原因的最后更新时间

根本原因更新时间 (日期时间)
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

value :以长格式表示的时间(自 1970 年 1 月 1 日以来的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,则使用默认格式。

根本原因更新者 (用户)

最后更新根本原因的用户

根本原因更新者 (用户)

示例

{
  "root_cause_updated_by": {
    "name": "test-root_cause_updated_by",
    "id": "234567890123456"
  }
}

症状 (JSONObject)

描述问题对业务的影响症状
显示属性

症状 (JSONObject)

症状描述 (html)

包含问题症状的详细信息

症状描述 (html)
HTML 是一个文本区域,可以使用 html 元素。

示例

<b>The content to be displayed</b>

症状更新时间 (日期时间)

指示症状的最后更新时间

症状更新时间 (日期时间)
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

value :以长格式表示的时间(自 1970 年 1 月 1 日以来的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,则使用默认格式。

症状更新者 (用户)

最后更新症状的用户

症状更新者 (用户)

已知错误详情 (JSONObject)

描述问题的已知错误详情
显示属性

已知错误详情 (JSONObject)
指示已知错误信息

已知错误评论 (字符串)

包含有关已知错误的详细信息

已知错误评论 (字符串)
纯文本格式。不允许使用富文本或换行符。

示例

Sample Content

是否为已知错误 (布尔值)

指示问题是否为已知错误

是否为已知错误 (布尔值)
布尔值,可取两个可能值。取值为 true 和 false。

已知错误详情更新时间 (日期时间)

指示已知错误的最后更新时间

已知错误详情更新时间 (日期时间)
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

value :以长格式表示的时间(自 1970 年 1 月 1 日以来的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,则使用默认格式。

已知错误详情更新者 (用户)

指示最后更新已知错误的用户

已知错误详情更新者 (用户)

示例

{
  "known_error_details_updated_by": {
    "name": "test-known_error_details_updated_by",
    "id": "234567890123456"
  }
}

关闭详情 (JSONObject)

包含有关问题关闭的信息
显示属性

关闭详情 (JSONObject)

关闭详情评论 (字符串)

包含问题的关闭评论。

关闭详情评论 (字符串)
纯文本格式。不允许使用富文本或换行符。

示例

Sample Content

关闭代码 (关闭代码)

关闭代码表示关闭问题的原因

关闭代码 (关闭代码)

关闭详情更新时间 (日期时间)

指示关闭详情的最后更新时间

关闭详情更新时间 (日期时间)
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

value :以长格式表示的时间(自 1970 年 1 月 1 日以来的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,则使用默认格式。

关闭详情更新者 (用户)

最后更新关闭详情的用户。

关闭详情更新者 (用户)

解决详情 (JSONObject)

技术员为问题提供的解决方案
显示属性

解决详情 (JSONObject)

解决详情描述 (html)

包含问题解决方案的详细信息

解决详情描述 (html)
HTML 是一个文本区域,可以使用 html 元素。

示例

<b>The content to be displayed</b>

解决详情更新时间 (日期时间)

指示解决方案的最后更新时间

解决详情更新时间 (日期时间)
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

value :以长格式表示的时间(自 1970 年 1 月 1 日以来的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,则使用默认格式。

解决详情更新者 (用户)

最后更新解决方案的用户

解决详情更新者 (用户)

变通方案详情 (JSONObject)

技术员为问题提供的变通方案
显示属性

变通方案详情 (JSONObject)

变通方案详情描述 (html)

包含问题变通方案的详细信息

变通方案详情描述 (html)
HTML 是一个文本区域,可以使用 html 元素。

示例

<b>The content to be displayed</b>

变通方案更新时间 (日期时间)

指示变通方案的最后更新时间

变通方案更新时间 (日期时间)
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

value :以长格式表示的时间(自 1970 年 1 月 1 日以来的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,则使用默认格式。

变通方案更新者 (用户)

最后更新变通方案的用户

变通方案更新者 (用户)

显示编号 (序号)read only

问题的序列号

显示编号 (序号)

是否存在备注 (布尔值)read only

指示问题是否包含任何备注

是否存在备注 (布尔值)
布尔值,可取两个可能值。取值为 true 和 false。

更新时间 (日期时间)read only

指示问题的最后更新时间

更新时间 (日期时间)
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

value :以长格式表示的时间(自 1970 年 1 月 1 日以来的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,则使用默认格式。

生命周期 (问题生命周期)read only

描述问题生命周期及其各状态流程

生命周期 (问题生命周期)
描述问题生命周期及各状态流程

示例

{
  "lifecycle": {
    "name": "test-lifecycle",
    "id": "234567890123456"
  }
}

$ curl -G <service domain|custom domain>/app/<portal>/api/v3/problems/{problem_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/problems/{problem_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/problems/{problem_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/problems/{problem_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"
    }
  ],
  "list_info": {
    "has_more_rows": false,
    "row_count": 1
  },
  "problem": {
    "known_error_details": {
      "known_error_details_updated_by": {
        "email_id": "john@zlyker.com",
        "is_technician": true,
        "sms_mail": null,
        "mobile": null,
        "last_name": null,
        "user_scope": "internal_user",
        "sms_mail_id": null,
        "site": {
          "deleted": false,
          "name": "Base Site",
          "id": "4149000001242001",
          "is_default": true
        },
        "phone": null,
        "employee_id": null,
        "name": "John",
        "id": "4149000000871029",
        "photo_url": "https://contacts.localzoho.com/file?sample",
        "is_vip_user": false,
        "department": null,
        "first_name": "John",
        "job_title": null
      },
      "known_error_details_updated_on": {
        "display_value": "Mar 6, 2023 03:21 PM",
        "value": "1678096283689"
      },
      "known_error_comments": null,
      "is_known_error": false
    },
    "template": {
      "inactive": false,
      "name": "General Problem Template",
      "id": "4149000000128011"
    },
    "updated_time": {
      "display_value": "Mar 6, 2023 03:34 PM",
      "value": "1678097051883"
    },
    "attachments": [],
    "display_id": {
      "display_value": "PB-140",
      "value": "140"
    },
    "description": "<div>Description</div>",
    "title": "Edit Test Problem",
    "lifecycle": null,
    "assets": [],
    "configuration_items": [
      {
        "ci_type": {
          "id": "4149000000141328"
        },
        "name": "Hardware Problems",
        "id": "4149000000288117"
      }
    ],
    "urgency": {
      "name": "Normal",
      "id": "4149000000007921"
    },
    "close_details": {
      "close_details_updated_on": {
        "display_value": "Mar 6, 2023 03:34 PM",
        "value": "1678097051891"
      },
      "closure_code": {
        "name": "Success",
        "id": "4149000001015012"
      },
      "close_details_comments": "Problem Resolved",
      "close_details_updated_by": {
        "email_id": "john@zlyker.com",
        "is_technician": true,
        "sms_mail": null,
        "mobile": null,
        "last_name": null,
        "user_scope": "internal_user",
        "sms_mail_id": null,
        "site": {
          "deleted": false,
          "name": "Base Site",
          "id": "4149000001242001",
          "is_default": true
        },
        "phone": null,
        "employee_id": null,
        "name": "John",
        "id": "4149000000871029",
        "photo_url": "https://contacts.localzoho.com/file?sample",
        "is_vip_user": false,
        "department": null,
        "first_name": "John",
        "job_title": null
      }
    },
    "rel": {
      "workarounds": null,
      "resolutions": null
    },
    "reported_by": {
      "email_id": "john@zlyker.com",
      "is_technician": true,
      "sms_mail": null,
      "mobile": null,
      "last_name": null,
      "user_scope": "internal_user",
      "sms_mail_id": null,
      "site": {
        "deleted": false,
        "name": "Base Site",
        "id": "4149000001242001",
        "is_default": true
      },
      "phone": null,
      "employee_id": null,
      "name": "John",
      "id": "4149000000871029",
      "photo_url": "https://contacts.localzoho.com/file?sample",
      "is_vip_user": false,
      "department": null,
      "first_name": "John",
      "job_title": null
    },
    "id": "4149000001355051",
    "group": {
      "site": {
        "id": "4149000001242001"
      },
      "deleted": false,
      "name": "DBA Group",
      "id": "4149000001032137"
    },
    "root_cause": {
      "root_cause_updated_by": {
        "email_id": "john@zlyker.com",
        "is_technician": true,
        "sms_mail": null,
        "mobile": null,
        "last_name": null,
        "user_scope": "internal_user",
        "sms_mail_id": null,
        "site": {
          "deleted": false,
          "name": "Base Site",
          "id": "4149000001242001",
          "is_default": true
        },
        "phone": null,
        "employee_id": null,
        "name": "John",
        "id": "4149000000871029",
        "photo_url": "https://contacts.localzoho.com/file?sample",
        "is_vip_user": false,
        "department": null,
        "first_name": "John",
        "job_title": null
      },
      "root_cause_description": "Root Cause",
      "root_cause_updated_on": {
        "display_value": "Mar 6, 2023 03:21 PM",
        "value": "1678096283690"
      }
    },
    "item": {
      "name": "Install",
      "id": "4149000000006773"
    },
    "resolution_details": {
      "resolution_details_updated_by": {
        "email_id": "john@zlyker.com",
        "is_technician": true,
        "sms_mail": null,
        "mobile": null,
        "last_name": null,
        "user_scope": "internal_user",
        "sms_mail_id": null,
        "site": {
          "deleted": false,
          "name": "Base Site",
          "id": "4149000001242001",
          "is_default": true
        },
        "phone": null,
        "employee_id": null,
        "name": "John",
        "id": "4149000000871029",
        "photo_url": "https://contacts.localzoho.com/file?sample",
        "is_vip_user": false,
        "department": null,
        "first_name": "John",
        "job_title": null
      },
      "resolution_details_description": "Resolution",
      "resolution_details_updated_on": {
        "display_value": "Mar 6, 2023 03:21 PM",
        "value": "1678096283690"
      }
    },
    "workaround_details": {
      "workaround_details_description": "Workaround",
      "workaround_details_updated_by": {
        "email_id": "john@zlyker.com",
        "is_technician": true,
        "sms_mail": null,
        "mobile": null,
        "last_name": null,
        "user_scope": "internal_user",
        "sms_mail_id": null,
        "site": {
          "deleted": false,
          "name": "Base Site",
          "id": "4149000001242001",
          "is_default": true
        },
        "phone": null,
        "employee_id": null,
        "name": "John",
        "id": "4149000000871029",
        "photo_url": "https://contacts.localzoho.com/file?sample",
        "is_vip_user": false,
        "department": null,
        "first_name": "John",
        "job_title": null
      },
      "workaround_details_updated_on": {
        "display_value": "Mar 6, 2023 03:21 PM",
        "value": "1678096283690"
      }
    },
    "impact": {
      "name": "Affects Group",
      "id": "4149000000008036"
    },
    "technician": {
      "email_id": "chine@haods.com",
      "is_technician": true,
      "sms_mail": null,
      "mobile": null,
      "last_name": null,
      "user_scope": "internal_user",
      "sms_mail_id": null,
      "cost_per_hour": "0",
      "site": {
        "id": "4149000001242001"
      },
      "phone": null,
      "employee_id": null,
      "name": "china ech",
      "id": "4149000000766091",
      "photo_url": "https://contacts.localzoho.com/file?exp=10&ID=-1&t=user&height=60&width=60",
      "is_vip_user": false,
      "department": null,
      "first_name": "china ech",
      "job_title": null
    },
    "closed_time": {
      "display_value": "Mar 6, 2023 03:34 PM",
      "value": "1678097051885"
    },
    "services": [
      {
        "inactive": false,
        "name": "Communication",
        "id": "4149000001341526",
        "sort_index": 0
      },
      {
        "inactive": false,
        "name": "Application Login",
        "id": "4149000001341618",
        "sort_index": 0
      }
    ],
    "priority": {
      "color": "#ff6600",
      "name": "Medium",
      "id": "4149000000006803"
    },
    "due_by_time": {
      "display_value": "Mar 8, 2023 02:07 PM",
      "value": "1678264620000"
    },
    "symptoms": {
      "symptoms_updated_by": {
        "email_id": "john@zlyker.com",
        "is_technician": true,
        "sms_mail": null,
        "mobile": null,
        "last_name": null,
        "user_scope": "internal_user",
        "sms_mail_id": null,
        "site": {
          "deleted": false,
          "name": "Base Site",
          "id": "4149000001242001",
          "is_default": true
        },
        "phone": null,
        "employee_id": null,
        "name": "John",
        "id": "4149000000871029",
        "photo_url": "https://contacts.localzoho.com/file?sample",
        "is_vip_user": false,
        "department": null,
        "first_name": "John",
        "job_title": null
      },
      "symptoms_description": "symptoms",
      "symptoms_updated_on": {
        "display_value": "Mar 6, 2023 03:21 PM",
        "value": "1678096283689"
      }
    },
    "site": {
      "deleted": false,
      "name": "Base Site",
      "id": "4149000001242001",
      "is_default": true
    },
    "udf_fields": {
      "udf_char6": null,
      "udf_char1": "YES",
      "udf_char2": null,
      "udf_char5": null,
      "udf_ref2": null,
      "udf_ref1": null,
      "udf_ref8": null,
      "udf_ref7": null,
      "udf_ref6": null,
      "udf_ref5": null,
      "udf_ref4": null,
      "udf_date3": null,
      "udf_date2": null,
      "udf_ref3": null
    },
    "impact_details": {
      "impact_details_updated_on": {
        "display_value": "Mar 6, 2023 03:21 PM",
        "value": "1678096283690"
      },
      "impact_details_updated_by": {
        "email_id": "john@zlyker.com",
        "is_technician": true,
        "sms_mail": null,
        "mobile": null,
        "last_name": null,
        "user_scope": "internal_user",
        "sms_mail_id": null,
        "site": {
          "deleted": false,
          "name": "Base Site",
          "id": "4149000001242001",
          "is_default": true
        },
        "phone": null,
        "employee_id": null,
        "name": "John",
        "id": "4149000000871029",
        "photo_url": "https://contacts.localzoho.com/file?sample",
        "is_vip_user": false,
        "department": null,
        "first_name": "John",
        "job_title": null
      },
      "impact_details_description": "Impact Details"
    },
    "reported_time": {
      "display_value": "Mar 6, 2023 03:21 PM",
      "value": "1678096283612"
    },
    "problem_template_task_ids": [],
    "category": {
      "deleted": false,
      "name": "Software",
      "id": "4149000000006689"
    },
    "subcategory": {
      "name": "MS Office",
      "id": "4149000000006717"
    },
    "notes_present": false,
    "status": {
      "in_progress": false,
      "internal_name": "Closed",
      "stop_timer": false,
      "color": "#006600",
      "name": "Closed",
      "id": "4149000000006661"
    }
  }
}

获取问题列表

此操作帮助您获取所有问题。

Url

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

属性

id (长整数)
问题创建时分配的唯一标识符

id (长整数)
被认为具有较大值的数字位

示例

234759602834500

标题 (字符串)
问题的标题

标题 (字符串)
纯文本格式。不允许使用富文本或换行符。

示例

Sample Content

描述 (html)
问题描述

描述 (html)
HTML 是一个文本区域,可以使用 html 元素。

示例

<b>The content to be displayed</b>

报告时间 (日期时间)
表示问题的报告时间

报告时间 (日期时间)
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

value :以长格式表示的时间(自 1970 年 1 月 1 日以来的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,则使用默认格式。

截止时间 (日期时间)
表示问题的截止时间

截止时间 (日期时间)
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

value :以长格式表示的时间(自 1970 年 1 月 1 日以来的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,则使用默认格式。

关闭时间 (日期时间)
表示问题的关闭时间

关闭时间 (日期时间)
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

value :以长格式表示的时间(自 1970 年 1 月 1 日以来的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,则使用默认格式。

更多属性 展开全部

报告者 (用户)

表示报告该问题的用户

报告者 (用户)
表示报告问题的用户

示例

{
  "reported_by": {
    "name": "test-reported_by",
    "id": "234567890123456"
  }
}

类别 (类别)

指示与问题相关的CI的类别。

类别 (类别)
指示与问题相关的CI的类别。

示例

{
  "category": {
    "name": "test-category",
    "id": "234567890123456"
  }
}

影响 (影响)

指示问题的影响

影响 (影响)
指示问题对业务、组或用户的影响

示例

{
  "impact": {
    "name": "test-impact",
    "id": "234567890123456"
  }
}

优先级 (优先级)

指示问题的优先级

优先级 (优先级)
指示问题的优先级。

示例

{
  "priority": {
    "name": "test-priority",
    "id": "234567890123456"
  }
}

子类别 (子类别)

分配在类别下选择的相关CI的子类别

子类别 (子类别)
指示在类别下选择的相关CI的子类别

示例

{
  "subcategory": {
    "name": "test-subcategory",
    "id": "234567890123456"
  }
}

项目 (项目)

指示项目分类

项目 (项目)
指示问题的项目分类。

示例

{
  "item": {
    "name": "test-item",
    "id": "234567890123456"
  }
}

紧急程度 (紧急程度)

指示问题的紧急程度

紧急程度 (紧急程度)
指示问题的紧急级别

示例

{
  "urgency": {
    "name": "test-urgency",
    "id": "234567890123456"
  }
}

工作日志 (工作日志)

无描述

工作日志 (工作日志)

站点 (站点)

指示问题发生的站点

站点 (站点)
指示问题发生的站点

示例

{
  "site": {
    "name": "test-site",
    "id": "234567890123456"
  }
}

(组)

问题的分配组

(组)
指示问题的分配组

示例

{
  "group": {
    "name": "test-group",
    "id": "234567890123456"
  }
}

技术员 (技术员)

指示分配给问题的技术员

技术员 (技术员)
指示分配给问题的技术员

示例

{
  "technician": {
    "email_id": "andrews@zmail.com",
    "name": "test-technician",
    "id": "234567890123456"
  }
}

状态 (状态)

指示问题的当前状态

状态 (状态)
指示问题的当前状态

示例

{
  "status": {
    "name": "Open",
    "id": "234567890123456"
  }
}

资产 (资产)

指示可能因该问题受影响的资产。

资产 (资产)
指示可能因问题受影响的资产

示例

{
  "assets": [
    {
      "name": "test-assets",
      "id": "234567890123456"
    }
  ]
}

服务 (服务类别)

可能因该问题受影响的服务

服务 (服务类别)
可能因该问题受影响的服务

示例

{
  "services": {
    "name": "test-services",
    "id": "234567890123456"
  }
}

用户定义字段 (用户定义字段)

包含问题的用户定义字段值

用户定义字段 (用户定义字段)

附件 (问题附件)

附加到问题的文件。最多可附加10个附件。

附件 (问题附件)
指示附加到问题的文件。最多只可附加10个附件。

示例

{
  "attachments": {
    "name": "test-attachments",
    "id": "234567890123456"
  }
}

会话 (会话)

无描述

会话 (会话)

模板 (问题模板)

指示用于创建问题的模板

模板 (问题模板)
指示用于创建问题的模板

示例

{
  "template": {
    "name": "test-template",
    "id": "234567890123456"
  }
}

配置项 (配置项)

可能因该问题受影响的配置项

配置项 (配置项)
可能因该问题受影响的配置项

示例

{
  "configuration_items": {
    "name": "test-configuration_items",
    "id": "234567890123456"
  }
}

显示编号 (序号)read only

问题的序列号

显示编号 (序号)

是否存在备注 (布尔值)read only

指示问题是否包含任何备注

是否存在备注 (布尔值)
布尔值,可取两个可能值。取值为 true 和 false。

更新时间 (日期时间)read only

指示问题的最后更新时间

更新时间 (日期时间)
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

value :以长格式表示的时间(自 1970 年 1 月 1 日以来的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,则使用默认格式。

$ curl -G <service domain|custom domain>/app/<portal>/api/v3/problems\
      -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/problems";
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/problems"
$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/problems"
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
  },
  "problems": [
    {
      "template": {
        "name": "test-name",
        "id": "1682944423003748"
      },
      "updated_time": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "display_id": {
        "display_value": "PB-3",
        "value": "3"
      },
      "description": "test-description",
      "title": "test-title",
      "urgency": {
        "name": "Urgent",
        "id": "2356072979101894"
      },
      "reported_by": {
        "email_id": "lincoln@zmail.com",
        "is_technician": false,
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "mobile": "test-mobile",
        "id": "2210656321195338",
        "photo_url": "test-photo_url",
        "is_vip_user": false,
        "job_title": "test-job_title"
      },
      "id": "1760624530278842",
      "group": {
        "site": {
          "id": "100000001111005757"
        },
        "deleted": false,
        "name": "Hardware Problems",
        "id": "2387199213602060"
      },
      "item": {
        "name": "Install",
        "id": "2389245760765183"
      },
      "impact": {
        "name": "Affects Business",
        "id": "1755679161346636"
      },
      "technician": {
        "email_id": "test@test.com",
        "cost_per_hour": 1343434.4333,
        "phone": "test-phone",
        "name": "Einstein",
        "mobile": "test-mobile",
        "id": "2281141910381802",
        "photo_url": "test-photo_url",
        "sms_mail_id": "test-sms_mail_id"
      },
      "closed_time": null,
      "priority": {
        "color": "#ffffff",
        "name": "High",
        "id": "2190663872127443"
      },
      "due_by_time": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "site": {
        "deleted": false,
        "name": "Custom Site",
        "id": "2038147713121720"
      },
      "udf_fields": {
        "udf_long1": "2430314675163833",
        "udf_char1": "test-udf_char1"
      },
      "category": {
        "deleted": false,
        "name": "Software",
        "id": "2121363349144358"
      },
      "subcategory": {
        "name": "Adobe Reader",
        "id": "2343366083030176"
      },
      "notes_present": false,
      "status": {
        "in_progress": false,
        "internal_name": "test-internal_name",
        "stop_timer": false,
        "color": "#ffffff",
        "name": "Open",
        "id": "1984587510883300"
      }
    }
  ]
}

删除问题

此操作帮助您删除一个问题。

Url

<service domain|custom domain>/app/<portal>/api/v3/problems/{problem_id}

$ curl <service domain|custom domain>/app/<portal>/api/v3/problems/{problem_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/problems/{problem_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/problems/{problem_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/problems/{problem_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"
  }
}