Todos os produtos
Search
Central de documentação

AnalyticDB:CreateElasticPlan

Última atualização: Jun 28, 2026

Cria um plano de dimensionamento para um cluster do AnalyticDB for MySQL.

Descrição da operação

Para obter informações sobre os endpoints do AnalyticDB for MySQL, consulte Endpoints.

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

adb:CreateElasticPlan

create

*All Resource

*

Nenhuma Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

ElasticPlanName

string

Sim

O nome do plano de dimensionamento.

Nota

O nome deve ter de 2 a 30 caracteres e pode conter letras, dígitos e sublinhados (_). O nome deve começar com uma letra.

test

ResourceGroupName

string

Não

O nome do grupo de recursos.

Nota
  • Se você deseja criar um plano de dimensionamento que use grupos de recursos interativos, deve especificar este parâmetro. Se você deseja criar um plano de dimensionamento que use unidades de E/S elásticas (EIUs), não é necessário especificar este parâmetro.

  • Você pode chamar a operação DescribeDBResourceGroup para consultar o nome do grupo de recursos de um cluster.

test

StartTime

string

Não

A hora de início do plano de dimensionamento.

Nota

Especifique a hora no padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. A hora deve estar em UTC.

2022-01-01T12:01:00Z

EndTime

string

Não

A hora de término do plano de dimensionamento.

Nota

Especifique a hora no padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. A hora deve estar em UTC.

2025-01-01T12:01:00Z

Enabled

boolean

Sim

Especifica se o plano de dimensionamento deve ser ativado imediatamente após a criação do plano. Valores válidos:

  • true

  • false

true

CronExpression

string

Não

Uma expressão CRON que especifica o ciclo e a hora de dimensionamento para o plano de dimensionamento.

0 20 14 * * ?

TargetSize

string

Não

As especificações desejadas dos recursos elásticos após o dimensionamento.

Nota
  • Se o plano de dimensionamento usar EIUs e o Dimensionamento Proporcional Padrão para EIUs estiver ativado, não é necessário especificar este parâmetro. Em outros casos, você deve especificar este parâmetro.

  • Você pode chamar a operação DescribeElasticPlanSpecifications para consultar as especificações compatíveis com os planos de dimensionamento.

32ACU

Type

string

Sim

O tipo do plano de dimensionamento. Valores válidos:

  • EXECUTOR: o tipo de grupo de recursos interativo, que indica o tipo de recurso de computação.

  • WORKER: o tipo de EIU.

EXECUTOR

AutoScale

boolean

Não

Especifica se o Dimensionamento Proporcional Padrão para EIUs deve ser ativado. Valores válidos:

  • true. Nesse caso, os recursos de armazenamento são dimensionados junto com os recursos de computação, e os parâmetros TargetSize e CronExpression não são suportados.

  • false

Nota
  • Este parâmetro deve ser especificado quando Type estiver definido como WORKER. Este parâmetro não é obrigatório quando Type estiver definido como EXECUTOR.

  • Você pode ativar o Dimensionamento Proporcional Padrão para EIUs apenas para um único plano de dimensionamento de um cluster.

false

DBClusterId

string

Sim

O ID do cluster.

Nota

Você pode chamar a operação DescribeDBClusters para consultar os IDs de todos os clusters do AnalyticDB for MySQL em uma região.

amv-wz9509beptiz****

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Os parâmetros de resposta.

RequestId

string

O ID da solicitação.

A5C433C2-001F-58E3-99F5-3274C14DF8BD

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "A5C433C2-001F-58E3-99F5-3274C14DF8BD"
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 ACS.ElasticPlan.InvalidEndTime The end time should be later than current time. The end time of scheduled scaling must be later than the current time.
400 ACS.ElasticPlan.NameAlreadyExists The name already exists. A scaling plan with the same name exists.
400 ACS.ElasticPlan.WorkerNotFound Worker not found. The cluster cannot have storage scaling plans configured because it does not have reserved storage resources.
400 ACS.ElasticPlan.AutoWorkerPlanExists Failed to enable the elastic plan. The instance already has an active elastic plan. Failed to enable the storage scaling plan because the cluster has another storage scaling plan enabled.
400 ACS.ElasticPlan.WorkerPlanExists Failed to enable the elastic plan. At least one active elastic plan already exists. Failed to enable the storage scaling plan because another storage scaling plan has been enabled.
400 ACS.ElasticPlan.InvalidStartTimeInterval The start time of this elastic plan is too closed to another one. The effective time of the scaling plan is close to that of another scaling plan.
400 ACS.ElasticPlan.InvalidTodayPlan Failed to enable this elastic plan. Today's schedule time is missed and you should prepare at least %s minutes for us to prepare resource.
400 ACS.ElasticPlan.InvalidTargetSize Invalid target size.
400 ACS.ElasticPlan.InvalidStartTime Invalid start time.
404 InvalidDBCluster.NotFound The DBClusterId provided does not exist in our records. The specified DBClusterId parameter does not exist. Make sure that the DBClusterId value is valid.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.