Todos os produtos
Search
Central de documentação

PolarDB:CreateCronJobPolicyServerless

Última atualização: Jun 28, 2026

Cria uma política de tarefa agendada para um cluster serverless.

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

polardb:CreateCronJobPolicyServerless

create

*All Resource

*

Nenhuma Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

DBClusterId

string

Sim

O ID do cluster.

pc-xxxxxxxxxx

RegionId

string

Sim

O ID da região.

cn-hangzhou

CronExpression

string

Sim

A expressão Cron.

0 0 13 * * ?

ScaleMin

string

Não

O número mínimo de PolarDB Capacity Units (PCUs). O valor deve ser de 0,25 a 32 e deve ser menor ou igual ao valor de ScaleMax.

1

ScaleMax

string

Não

O número máximo de PCUs. O valor deve ser de 1 a 32.

3

ScaleRoNumMin

string

Não

O número mínimo de nós somente leitura. Valores válidos: 0 a 15.

2

ScaleRoNumMax

string

Não

O número máximo de nós somente leitura. Valores válidos: 0 a 15. O valor deve ser maior ou igual ao valor de ScaleRoNumMin.

4

AllowShutDown

string

Não

Especifica se a suspensão por inatividade deve ser ativada. Valores válidos:

  • true: Ativa o recurso.

  • false (padrão): Desativa o recurso.

true

SecondsUntilAutoPause

string

Não

O período de inatividade em minutos antes que o cluster seja pausado automaticamente. O valor deve ser um múltiplo de 5 e variar de 5 a 1440.

10

ScaleApRoNumMin

string

Não

O número mínimo de nós de column store somente leitura. Valores válidos: 0 a 15.

1

ScaleApRoNumMax

string

Não

O número máximo de nós de column store somente leitura. Valores válidos: 0 a 15.

1

ServerlessRuleCpuEnlargeThreshold

string

Não

A porcentagem de utilização de CPU que aciona um scale-up. Valores válidos: 40 a 100.

60

ServerlessRuleCpuShrinkThreshold

string

Não

A porcentagem de utilização de CPU que aciona um scale-down. Valores válidos: 10 a 100. O valor de ServerlessRuleCpuEnlargeThreshold menos o valor deste parâmetro deve ser 30 ou superior.

30

ServerlessRuleMode

string

Não

A sensibilidade de escalonamento. Valores válidos:

  • normal: padrão

  • flexible: flexível

normal

StartTime

string

Não

A hora de início da tarefa. Use o formato yyyy-MM-ddTHH:mm:ssZ. A hora deve estar no Tempo Universal Coordenado (UTC).

2020-11-14T00:00Z

EndTime

string

Sim

A hora de término da tarefa. Use o formato yyyy-MM-ddTHH:mm:ssZ. A hora deve estar em UTC.

2021-09-23T01:01:00Z

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

RequestId

string

O ID da solicitação.

45D24263-7E3A-4140-9472-************

JobId

string

O ID da tarefa agendada.

1fa3c0e7-b568-4f41-b703-463c96a91bd8

DBClusterId

string

O ID do cluster.

pc-****************

RegionId

string

O ID da região.

cn-hangzhou

Status

string

O status da tarefa. Valores válidos:

  • working: A tarefa agendada está em execução.

  • finish: A tarefa agendada está concluída.

working

CronExpression

string

A expressão Cron.

0 0 8 * * ?

Action

string

A ação da tarefa agendada. O valor é fixo como ModifyDBClusterServerlessConf.

ModifyDBClusterServerlessConf

StartTime

string

A hora de início da tarefa. A hora está no formato yyyy-MM-ddTHH:mm:ssZ e em UTC.

2020-05-01T00:00Z

EndTime

string

A hora de término da tarefa. A hora está no formato yyyy-MM-ddTHH:mm:ssZ e em UTC.

2021-04-07T04:00Z

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "45D24263-7E3A-4140-9472-************",
  "JobId": "1fa3c0e7-b568-4f41-b703-463c96a91bd8",
  "DBClusterId": "pc-****************",
  "RegionId": "cn-hangzhou",
  "Status": "working",
  "CronExpression": "0 0 8 * * ?",
  "Action": "ModifyDBClusterServerlessConf",
  "StartTime": "2020-05-01T00:00Z",
  "EndTime": "2021-04-07T04:00Z"
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 InvalidRegionId.Malformed The specified parameter RegionId is not valid. The specified RegionId parameter is invalid.
400 InvalidStartTime.Malformed The specified parameter StartTime is not valid. The specified StartTime parameter is invalid.
400 InvalidEndTime.Malformed The specified parameter EndTime is not valid. The specified EndTime parameter is invalid.
400 InvalidCronJobParam.Type The specified type is not valid. The specified type is not valid.
400 InvalidCronJobParam.InstanceId The specified instanceId is not valid. The specified instanceId is invalid.
400 InvalidCronJobParam.CronExpression The specified cronExpression is not valid. The specified cronExpression is not valid.
404 InvalidDBClusterId.Malformed The specified parameter DBClusterId is not valid. The specified DBClusterId parameter is invalid.
409 InvalidCronJob.DuplicateJob This instance has tasks with duplicate crontab expressions. This instance has tasks with duplicate crontab expressions.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.