全部产品
Search

搜索本产品

    系统运维管理：UpdateOpsItem - 更新运维项

    文档中心

    系统运维管理：UpdateOpsItem - 更新运维项

    更新时间：Sep 10, 2026

    修改运维项。

    调试

    您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

    调试

    授权信息

    下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

    • 操作：是指具体的权限点。

    • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。

    • 资源类型：是指操作中支持授权的资源类型。具体说明如下：

      • 对于必选的资源类型，用前面加 * 表示。

      • 对于不支持资源级授权的操作，用全部资源表示。

    • 条件关键字：是指云产品自身定义的条件关键字。

    • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

    操作

    访问级别

    资源类型

    条件关键字

    关联操作

    oos:UpdateOpsItem

    update

    *OpsItem

    acs:oos:{#regionId}:{#accountId}:opsitem/{#OpsItemId}
    • oos:TLSVersion
    		 无

    请求参数

    名称

    类型

    必填

    描述

    示例值
    RegionId

    string

    否

    地域 ID。

    cn-hangzhou
    Title

    string

    否

    运维项标题。

    Test
    Description

    string

    否

    运维项的描述。

    test-update
    ResourceGroupId

    string

    否

    资源组 ID。

    rg-acfmxsn4m4******
    Tags

    object

    否

    标签。

    { "k1": "v1", "k2": "v2" }
    ClientToken

    string

    否

    幂等 Token。

    DASKJJLKADS-AHKLJHJSAKL-AJK
    Severity

    string

    否

    严重程度。

    枚举值：

    • High :

      高

    • Low :

      低

    • Medium :

      中

    • Critical :

      严重

    Medium
    Source

    string

    否

    来源业务。

    /aliyun/ecs
    Category

    string

    否

    分类。

    枚举值：

    • Availability :

      可用性

    • Performance :

      性能

    • Security :

      安全

    • Cost :

      成本

    • Recovery :

      备份恢复

    Security
    Priority

    integer

    否

    优先级。

    枚举值：

    • 1 :

      1

    • 2 :

      2

    • 3 :

      3

    • 4 :

      4

    • 5 :

      5

    2
    Solutions

    string

    否

    解决方案列表。

    [{"priority":3,"type":"url","url":"https://example.com","description":"Configure cross-zone high availability for the cluster."}]
    DedupString

    string

    否

    去重字符串。

    ecs_instance_SystemMaintenance.Reboot
    Resources

    string

    否

    关联资源 ARN 列表。

    [\"arn:acs:ecs:cn-heyuan:1139354755361920:instance/i-f8z928h7aqotd3o65032\"]
    OpsItemId

    string

    否

    运维项 ID，OpsItemId 和 Resources 二参数必须填一个。

    oi-e2264dcf040c472598e9
    Status

    string

    否

    状态。

    枚举值：

    • InProgress :

      处理中

    • Resolved :

      已解决

    • Open :

      待处理

    Open
    AssigneeId

    string

    否

    负责人标识，格式为 type:id

    user:123456789
    PlannedFinishTime

    string

    否

    计划完成时间，ISO 8601 格式

    2026-09-01T00:00:00Z
    ActualFinishTime

    string

    否

    实际完成时间，ISO 8601 格式

    2026-08-30T18:00:00Z
    StatusChangeReason

    string

    否

    状态变更原因，当 Status 为 Rejected 时必填

    不符合验收标准，需要重新处理
    Progress

    integer

    否

    进度百分比，取值范围 0-100

    50
    EstimatedEffortHours

    number

    否

    预计工作时长（小时）

    8.0
    ActualEffortHours

    number

    否

    实际花费工作时长（小时）

    6.5

    返回参数

    名称

    类型

    描述

    示例值

    object

    OpsItem

    object

    运维项

    ActualEffortHours

    number

    实际花费工作时长（小时）

    6.5
    ActualFinishTime

    string

    实际完成时间

    2026-08-30T18:00:00Z
    AssigneeId

    string

    负责人标识

    user:123456789
    Attributes

    string

    运维项属性信息。

    [{'Attribute': {'Weight': 100}, 'RealServer': 'uaejc8hnqzqz5valyh8dibolpvza48ik.yundunwaf5.com'}]
    Category

    string

    分类。

    Security
    CreateDate

    string

    创建时间。

    2023-03-16T07:04Z
    CreatedBy

    string

    运维项创建者。

    root(130900000)

    Description

    string

    描述。

    test-update
    EstimatedEffortHours

    number

    预计工作时长（小时）

    8.0
    LastModifiedBy

    string

    运维项修改者。

    root(130900000)

    OpsItemId

    string

    运维项 ID。

    oi-e2264dcf040c472598e9
    PlannedFinishTime

    string

    计划完成时间

    2026-09-01T00:00:00Z
    Priority

    integer

    优先级。

    2
    Progress

    integer

    进度百分比，取值范围 0-100

    50
    ResourceGroupId

    string

    资源组 ID。

    rg-acfmxsn4m4******
    Resources

    array

    关联资源 ARN 列表。

    string

    关联资源 ARN。

    [\"arn:acs:ecs:cn-heyuan:1139354755361920:instance/i-f8z928h7aqotd3o65032\"]
    Severity

    string

    严重程度。

    Medium
    Solutions

    array

    解决方案列表。

    [{"priority":2,"type":"SlbNeedEcs","url":"https://computenest.console.alibabacloud.com/app","description":"Import all ECS instances under the SLB to the app group"}]

    string

    解决方案。

    [{\n \"priority\":2,\n \"type\":\"SlbNeedEcs\",\n \"url\":\"https://computenest.console.alibabacloud.com/app\",\n \"description\":\"请将SLB实例下所有的ECS实例导入到应用分组中\"\n}]
    Source

    string

    来源业务。

    /aliyun/ecs
    Status

    string

    状态。

    Open
    Tags

    object

    标签。

    { "k1": "v1", "k2": "v2" }

    Title

    string

    运维项标题。

    Test
    UpdateDate

    string

    更新时间。

    2023-03-16T08:04Z
    RequestId

    string

    请求 ID。

    C996DECB-3D2B-5321-B359-BE7031B6399E

    示例

    正常返回示例

    JSON格式

    {
  "OpsItem": {
    "ActualEffortHours": 6.5,
    "ActualFinishTime": "2026-08-30T18:00:00Z",
    "AssigneeId": "user:123456789",
    "Attributes": "[{'Attribute': {'Weight': 100}, 'RealServer': 'uaejc8hnqzqz5valyh8dibolpvza48ik.yundunwaf5.com'}]",
    "Category": "Security",
    "CreateDate": "2023-03-16T07:04Z",
    "CreatedBy": "root(130900000)\n",
    "Description": "test-update",
    "EstimatedEffortHours": 8,
    "LastModifiedBy": "root(130900000)\n",
    "OpsItemId": "oi-e2264dcf040c472598e9",
    "PlannedFinishTime": "2026-09-01T00:00:00Z",
    "Priority": 2,
    "Progress": 50,
    "ResourceGroupId": "rg-acfmxsn4m4******",
    "Resources": [
      "[\\\"arn:acs:ecs:cn-heyuan:1139354755361920:instance/i-f8z928h7aqotd3o65032\\\"]"
    ],
    "Severity": "Medium",
    "Solutions": [
      "[{\\n    \\\"priority\\\":2,\\n    \\\"type\\\":\\\"SlbNeedEcs\\\",\\n    \\\"url\\\":\\\"https://computenest.console.alibabacloud.com/app\\\",\\n    \\\"description\\\":\\\"请将SLB实例下所有的ECS实例导入到应用分组中\\\"\\n}]"
    ],
    "Source": "/aliyun/ecs",
    "Status": "Open",
    "Tags": {
      "k1": "v1",
      "k2": "v2"
    },
    "Title": "Test",
    "UpdateDate": "2023-03-16T08:04Z"
  },
  "RequestId": "C996DECB-3D2B-5321-B359-BE7031B6399E"
}

    错误码

    访问错误中心查看更多错误码。

    变更历史

    更多信息，参考变更详情。