Todos os produtos
Search
Central de documentação

Platform For AI:UpdateServiceRollout

Última atualização: Jul 08, 2026

Atualiza o rollout de um serviço.

Descrição da operação

Notas de uso

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

  • Estratégias mutuamente exclusivas: Você não pode especificar os parâmetros Partition e Batch na mesma solicitação.

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

  • Rollback: Você pode realizar um rollback aumentando o valor de Partition. No entanto, este não é um processo automático e você deve atualizar manualmente a imagem do serviço.

  • A pausa não afeta os parâmetros: Pausar um rollout não altera os parâmetros Partition ou Batch configurados. Ele apenas suspende a estratégia de rollout 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

O ID da região onde o serviço está localizado.

  • Tipo: string

  • Obrigatório: Sim

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

  • Exemplo: cn-shanghai

cn-shanghai

ServiceName

string

Sim

O nome do serviço.

  • Tipo: string

  • Obrigatório: Sim

  • Descrição: O nome do serviço para o qual a estratégia de rollout será atualizada.

  • 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

A configuração de rollout de partição. Este parâmetro é mutuamente exclusivo com Batch.

  • Tipo: object

  • Obrigatório: Não

  • Descrição: A configuração de rollout de partição. Este parâmetro ajusta os parâmetros da estratégia de partição. É mutuamente exclusivo com Batch.

Partition

string

Não

Valor da partição

  • Tipo: string

  • Obrigatório: Sim

  • Descrição: O valor da partição. Este parâmetro especifica o número ou a porcentagem de réplicas da versão antiga a serem retidas. Ele suporta dois formatos:

    1. Um número inteiro, como "5", para o número de réplicas.

    2. Uma porcentagem, como "50%", para a proporção de réplicas.

    Estratégia de ajuste:

    • Aumentar o valor reverte para a versão anterior, aumentando o número de réplicas da versão antiga.

    • Diminuir o valor continua o rollout, reduzindo o número de réplicas da versão antiga.

    • Definir o valor como "0" ou "0%" conclui o rollout, substituindo todas as réplicas da versão antiga.

  • Exemplo: 30%

30%

Batch

object

Não

A configuração de rollout em lote. Este parâmetro é mutuamente exclusivo com Partition.

  • Tipo: object

  • Obrigatório: Não

  • Descrição: A configuração de rollout em lote para ajustar os parâmetros da política de lote. Este parâmetro é mutuamente exclusivo com Partition.

BatchSize

string

Não

O número de réplicas a serem atualizadas em cada lote. Pode ser um número inteiro ou uma porcentagem. O valor padrão é "25%".

25%

Interval

string

Não

O intervalo de espera entre os lotes. As unidades suportadas incluem s (segundos), m (minutos) e h (horas).

60s

Paused

boolean

Não

Defina como true para pausar o rollout ou false para retomá-lo.

true

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

O corpo da resposta.

RequestId

string

O identificador exclusivo da solicitação. Você pode usar este ID de solicitação para solução de problemas e rastreamento.

40325405-579C-4D82****

Message

string

A mensagem que indica o resultado da solicitação. Os valores possíveis incluem:

  • "Rollout updated successfully"

  • "Rollout paused successfully"

  • "Rollout resumed successfully"

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.