Todos os produtos
Search
Central de documentação

Platform For AI:UpdateServiceRollout

Última atualização: Oct 27, 2026

Atualiza um plano de rollout de serviço.

Descrição da operação

Notas da solicitação

  • Forneça pelo menos um parâmetro: Especifique pelo menos um dos parâmetros Partition, Batch ou Paused na solicitação.

  • Parâmetros mutuamente exclusivos: Os parâmetros Partition e Batch são mutuamente exclusivos.

  • Efeito imediato: As atualizações entram em vigor imediatamente e afetam o processo de rollout de serviço em andamento.

  • Operações de rollback: Aumente o valor de Partition para reverter para uma versão anterior. Esta ação não é acionada automaticamente e requer uma atualização manual da imagem do serviço.

  • A pausa não afeta os parâmetros: Pausar o rollout não altera os parâmetros Partition ou Batch configurados. Ela apenas pausa a execução da política atual.

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

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Sintaxe da solicitação

PUT /api/v2/services/{ClusterId}/{ServiceName}/rollout HTTP/1.1

Parâmetros de caminho

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

ClusterId

string

Sim

ClusterId

  • Tipo: string

  • Obrigatório: sim

  • Descrição: O ID da região. O identificador da região onde o serviço está implantado.

  • Exemplo: cn-shanghai

cn-shanghai

ServiceName

string

Sim

ServiceName

  • Tipo: string

  • Obrigatório: sim

  • Descrição: O nome do serviço. O nome do serviço cuja política de rollout você deseja atualizar.

  • Exemplo: my-service

my-service

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

body

object

Não

O corpo da solicitação.

Partition

object

Não

Partition

  • Tipo: object

  • Obrigatório: não

  • Descrição: A configuração de rollout de partição. Usada para ajustar os parâmetros da política de partição. Mutuamente exclusiva com Batch.

Partition

string

Não

Partition

  • Tipo: string

  • Obrigatório: sim

  • Descrição: O valor da partição. Dois formatos são suportados:
    1. Formato inteiro: como "5", que indica que 5 réplicas antigas são retidas.

    2. Formato de porcentagem: como "50%", que indica que 50% das réplicas antigas são retidas. Estratégias de ajuste:

    • Aumentar o valor: Reverter para a versão antiga e aumentar a proporção de réplicas antigas.

    • Diminuir o valor: Prosseguir para a nova versão e diminuir a proporção de réplicas antigas.

    • Definir como "0%": Concluir a atualização completa e alternar todas as réplicas para a nova versão.

  • Exemplo: 30%

30%

Batch

object

Não

Batch

  • Tipo: object

  • Obrigatório: não

  • Descrição: A configuração de rollout em lote. Usada para ajustar os parâmetros da política em lote. Mutuamente exclusiva com Partition.

BatchSize

string

Não

O tamanho do lote. O número de réplicas a serem atualizadas em cada lote. Os formatos inteiro ou de porcentagem são suportados. Valor padrão: "25%".

25%

Interval

string

Não

O intervalo do lote. O tempo de espera entre dois rollouts. Unidades suportadas: s (segundos), m (minutos) e h (horas).

60s

Paused

boolean

Não

Especifica se o rollout deve ser pausado. Um valor true indica que o rollout está pausado. Um valor false indica que o rollout é retomado.

true

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

O corpo da resposta.

RequestId

string

O ID da solicitação. O identificador exclusivo retornado para cada solicitação, usado para solução de problemas e rastreamento.

40325405-579C-4D82****

Message

string

A mensagem retornada. Descreve o resultado do processamento da solicitação. Valores válidos:

  • "Rollout updated successfully": A política de rollout é atualizada.

  • "Rollout paused successfully": O rollout é pausado.

  • "Rollout resumed successfully": O rollout é retomado.

Rollout updated successfully

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "40325405-579C-4D82****",
  "Message": "Rollout updated successfully"
}

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.