Todos os produtos
Search
Central de documentação

CloudOps Orchestration Service:UpdateOpsItem

Última atualização: Sep 10, 2026

Modifica um OpsItem.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

  • Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.

  • API: A API que você pode chamar para executar a ação.

  • Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.

  • Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.

    • Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.

    • Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.

  • Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.

  • Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

oos:UpdateOpsItem

update

*OpsItem

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

  • oos:TLSVersion
Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

RegionId

string

Não

O ID da região.

cn-hangzhou

Title

string

Não

O título do OpsItem.

Test

Description

string

Não

A descrição do OpsItem.

test-update

ResourceGroupId

string

Não

O ID do grupo de recursos.

rg-acfmxsn4m4******

Tags

object

Não

As tags.

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

ClientToken

string

Não

O token de idempotência.

DASKJJLKADS-AHKLJHJSAKL-AJK

Severity

string

Não

O nível de gravidade.

Valores válidos:

  • High :

    Alta.

  • Low :

    Baixa.

  • Medium :

    Média.

  • Critical :

    Crítica.

Medium

Source

string

Não

O serviço de origem.

/aliyun/ecs

Category

string

Não

A categoria.

Valores válidos:

  • Availability :

    Disponibilidade.

  • Performance :

    Desempenho.

  • Security :

    Segurança.

  • Cost :

    Custo.

  • Recovery :

    Backup e recuperação.

Security

Priority

integer

Não

A prioridade.

Valores válidos:

  • 1 :

    1

  • 2 :

    2

  • 3 :

    3

  • 4 :

    4

  • 5 :

    5

2

Solutions

string

Não

A lista de soluções.

[{"priority":3,"type":"url","url":"https://example.com","description":"Configure a alta disponibilidade entre zonas para o cluster."}]

DedupString

string

Não

A string de deduplicação.

ecs_instance_SystemMaintenance.Reboot

Resources

string

Não

A lista de ARNs de recursos associados.

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

OpsItemId

string

Não

O ID do OpsItem. Você deve especificar pelo menos um entre OpsItemId e Resources.

oi-e2264dcf040c472598e9

Status

string

Não

O status.

Valores válidos:

  • InProgress :

    Em andamento.

  • Resolved :

    Resolvido.

  • Open :

    Aberto.

Open

Não

O identificador do responsável, no formato tipo:id.

user:123456789

Não

A hora de término planejada, no formato ISO 8601.

2026-09-01T00:00:00Z

Não

A hora de término real, no formato ISO 8601.

2026-08-30T18:00:00Z

Não

O motivo da alteração de status. Este parâmetro é obrigatório quando Status é definido como Rejected.

Não atende aos critérios de aceitação e precisa ser reprocessado

Não

A porcentagem de progresso. Valores válidos: 0 a 100.

50

Não

O esforço estimado em horas.

8.0

Não

O esforço real em horas.

6.5

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

OpsItem

object

O OpsItem.

ActualEffortHours

number

O esforço real em horas.

6.5

ActualFinishTime

string

A hora de término real.

2026-08-30T18:00:00Z

AssigneeId

string

O identificador do responsável.

user:123456789

Attributes

string

As informações de atributos do OpsItem.

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

Category

string

A categoria.

Security

CreateDate

string

A hora em que o OpsItem foi criado.

2023-03-16T07:04Z

CreatedBy

string

O criador do OpsItem.

root(130900000)

Description

string

A descrição.

test-update

EstimatedEffortHours

number

O esforço estimado em horas.

8.0

LastModifiedBy

string

O usuário que modificou o OpsItem pela última vez.

root(130900000)

OpsItemId

string

O ID do OpsItem.

oi-e2264dcf040c472598e9

PlannedFinishTime

string

A hora de término planejada.

2026-09-01T00:00:00Z

Priority

integer

A prioridade.

2

Progress

integer

A porcentagem de progresso. Valores válidos: 0 a 100.

50

ResourceGroupId

string

O ID do grupo de recursos.

rg-acfmxsn4m4******

Resources

array

A lista de ARNs de recursos associados.

string

O ARN do recurso associado.

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

Severity

string

O nível de gravidade.

Medium

Solutions

array

A lista de soluções.

[{"priority":2,"type":"SlbNeedEcs","url":"https://computenest.console.alibabacloud.com/app","description":"Importar todas as instâncias ECS sob o SLB para o grupo de aplicativos"}]

string

As soluções.

[{\n \"priority\":2,\n \"type\":\"SlbNeedEcs\",\n \"url\":\"https://computenest.console.alibabacloud.com/app\",\n \"description\":\"Importar todas as instâncias ECS sob a instância SLB para o grupo de aplicativos\"\n}]

Source

string

O serviço de origem.

/aliyun/ecs

Status

string

O status.

Open

Tags

object

As tags.

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

Title

string

O título do OpsItem.

Test

UpdateDate

string

A hora em que o OpsItem foi atualizado pela última vez.

2023-03-16T08:04Z

RequestId

string

O ID da solicitação.

C996DECB-3D2B-5321-B359-BE7031B6399E

Exemplos

Resposta de sucesso

JSON formato

{
  "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)",
    "Description": "test-update",
    "EstimatedEffortHours": 8,
    "LastModifiedBy": "root(130900000)",
    "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\\\":\\\"Importar todas as instâncias ECS sob a instância SLB para o grupo de aplicativos.\\\"\\n}]"
    ],
    "Source": "/aliyun/ecs",
    "Status": "Open",
    "Tags": {
      "k1": "v1",
      "k2": "v2"
    },
    "Title": "Test",
    "UpdateDate": "2023-03-16T08:04Z"
  },
  "RequestId": "C996DECB-3D2B-5321-B359-BE7031B6399E"
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.