All Products
Search
Document Center

CloudOps Orchestration Service:UpdateOpsItem

Last Updated:Sep 21, 2026

Modifies an OpsItem.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

  • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

  • API: The API that you can call to perform the action.

  • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

  • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

    • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

    • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

  • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

  • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

oos:UpdateOpsItem

update

*OpsItem

acs:oos:{#regionId}:{#accountId}:opsitem/{#OpsItemId}

  • oos:TLSVersion
None

Request parameters

Parameter

Type

Required

Description

Example

RegionId

string

No

The region ID.

cn-hangzhou

Title

string

No

The title of the OpsItem.

Test

Description

string

No

The description of the OpsItem.

test-update

ResourceGroupId

string

No

The resource group ID.

rg-acfmxsn4m4******

Tags

object

No

The tags.

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

ClientToken

string

No

The idempotence token.

DASKJJLKADS-AHKLJHJSAKL-AJK

Severity

string

No

The severity level.

Valid values:

  • High :

    High.

  • Low :

    Low.

  • Medium :

    Medium.

  • Critical :

    Critical.

Medium

Source

string

No

The source service.

/aliyun/ecs

Category

string

No

The category.

Valid values:

  • Availability :

    Availability.

  • Performance :

    Performance.

  • Security :

    Security.

  • Cost :

    Cost.

  • Recovery :

    Backup and recovery.

Security

Priority

integer

No

The priority.

Valid values:

  • 1 :

    1

  • 2 :

    2

  • 3 :

    3

  • 4 :

    4

  • 5 :

    5

2

Solutions

string

No

The list of solutions.

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

DedupString

string

No

The deduplication string.

ecs_instance_SystemMaintenance.Reboot

Resources

string

No

The list of associated resource ARNs.

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

OpsItemId

string

No

The OpsItem ID. You must specify at least one of OpsItemId and Resources.

oi-e2264dcf040c472598e9

Status

string

No

The status.

Valid values:

  • InProgress :

    In progress.

  • Resolved :

    Resolved.

  • Open :

    Open.

Open

AssigneeId

string

No

The assignee identifier in the format of type:id.

user:123456789

PlannedFinishTime

string

No

The planned finish time in ISO 8601 format in UTC.

2026-09-01T00:00:00Z

ActualFinishTime

string

No

The actual finish time in ISO 8601 format in UTC.

2026-08-30T18:00:00Z

StatusChangeReason

string

No

The reason for the status change. This parameter is required when Status is set to Rejected.

Does not meet acceptance criteria and needs to be reprocessed

Progress

integer

No

The progress percentage. Valid values: 0 to 100.

50

EstimatedEffortHours

number

No

The estimated effort in hours.

8.0

ActualEffortHours

number

No

The actual effort spent in hours.

6.5

Response elements

Element

Type

Description

Example

object

OpsItem

object

The OpsItem.

ActualEffortHours

number

The actual effort spent in hours.

6.5

ActualFinishTime

string

The actual finish time in ISO 8601 format in UTC.

2026-08-30T18:00:00Z

AssigneeId

string

The assignee identifier in the format of type:id.

user:123456789

Attributes

string

The attribute information of the OpsItem.

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

Category

string

The category.

Security

CreateDate

string

The creation time in ISO 8601 format in UTC.

2023-03-16T07:04Z

CreatedBy

string

The creator of the OpsItem.

root(130900000)

Description

string

The description.

test-update

EstimatedEffortHours

number

The estimated effort in hours.

8.0

LastModifiedBy

string

The last modifier of the OpsItem.

root(130900000)

OpsItemId

string

The OpsItem ID.

oi-e2264dcf040c472598e9

PlannedFinishTime

string

The planned finish time in ISO 8601 format in UTC.

2026-09-01T00:00:00Z

Priority

integer

The priority.

2

Progress

integer

The progress percentage. Valid values: 0 to 100.

50

ResourceGroupId

string

The resource group ID.

rg-acfmxsn4m4******

Resources

array

The list of associated resource ARNs.

string

The associated resource ARN.

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

Severity

string

The severity level.

Medium

Solutions

array

The list of solutions.

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

string

The Solutions.

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

Source

string

The source service.

/aliyun/ecs

Status

string

The status.

Open

Tags

object

The tags.

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

Title

string

The title of the OpsItem.

Test

UpdateDate

string

The update time in ISO 8601 format in UTC.

2023-03-16T08:04Z

RequestId

string

The request ID.

C996DECB-3D2B-5321-B359-BE7031B6399E

Examples

Success response

JSON format

{
  "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\\\":\\\"Import all ECS instances under the SLB instance into the application group\\\"\\n}]"
    ],
    "Source": "/aliyun/ecs",
    "Status": "Open",
    "Tags": {
      "k1": "v1",
      "k2": "v2"
    },
    "Title": "Test",
    "UpdateDate": "2023-03-16T08:04Z"
  },
  "RequestId": "C996DECB-3D2B-5321-B359-BE7031B6399E"
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.