Todos os produtos
Search
Central de documentação

:CreateApplicationAccelerationRule

Última atualização: Jul 03, 2026

Adiciona uma regra de aceleração de aplicação.

Observações de uso

Em cada plano de largura de banda de aceleração de aplicação, a soma dos valores de largura de banda especificados nas diferentes regras não pode exceder o valor máximo de largura de banda do plano.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro Tipo Obrigatório Exemplo Descrição
Action String Sim CreateApplicationAccelerationRule

A operação a ser executada. Defina o valor como CreateApplicationAccelerationRule.

DryRun Boolean Não false

Especifique se deve haver uma verificação prévia para validar informações como permissões e status da instância. Valores válidos:

  • false (padrão): envia a solicitação. Se a validação for bem-sucedida, o sistema adiciona a regra de aceleração de aplicação.
  • true: executa a verificação prévia sem adicionar a regra de aceleração de aplicação. O sistema valida os parâmetros obrigatórios e a sintaxe da solicitação. Em caso de falha na verificação, o sistema retorna uma mensagem de erro. Se a verificação for bem-sucedida, o código de erro DryRunOperation será retornado.
ClientToken String Não 02fb3da4-130e-11e9-8e44-001****

Token de cliente usado para garantir a idempotência da solicitação.

Gere um token por meio do cliente e garanta que ele seja único entre diferentes solicitações. O token aceita apenas caracteres ASCII e não pode exceder 64 caracteres.

Nota Se você não definir este parâmetro, o ClientToken assumirá o valor de RequestId. O valor de RequestId pode variar para cada solicitação de API.
RegionId String Sim cn-shanghai

ID da região do plano de largura de banda de aceleração de aplicação.

Chame a operação DescribeRegions para consultar a lista de regiões mais recente.

ApplicationBandwidthPackageId String Sim abwp-7963l7iqnquyj3****

ID do plano de largura de banda de aceleração de aplicação.

AccelerationRules.N.ServiceRegionId String Sim cn-hongkong

ID da região de serviço, correspondente à região onde as aplicações estão localizadas.

Chame a operação DescribeRegions para consultar a lista de regiões mais recente.

É possível especificar IDs de região para até 200 regras de aceleração de aplicação em cada chamada.

AccelerationRules.N.Bandwidth Integer Sim 1

Valor máximo de largura de banda da regra de aceleração de aplicação. Unidade: Mbit/s.

É possível definir valores máximos de largura de banda para até 200 regras de aceleração de aplicação por chamada.

AccelerationRules.N.Applications.N String Sim O365

Aplicações a serem aceleradas.

Chame a operação ListAccelerateApplications para consultar informações sobre as aplicações compatíveis com a aceleração do Smart Access Gateway (SAG).

É possível especificar aplicações para até 200 regras de aceleração de aplicação em cada chamada.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

57626BB9-8EF0-4A41-AE60-2C097784365F

ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=CreateApplicationAccelerationRule
&DryRun=false
&ClientToken=02fb3da4-130e-11e9-8e44-001****
&RegionId=cn-shanghai
&ApplicationBandwidthPackageId=abwp-7963l7iqnquyj3****
&AccelerationRules=[{"ServiceRegionId":"cn-hongkong","Bandwidth":1,"Applications":["O365"]}]
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateApplicationAccelerationRuleResponse>
    <RequestId>57626BB9-8EF0-4A41-AE60-2C097784365F</RequestId>
</CreateApplicationAccelerationRuleResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "57626BB9-8EF0-4A41-AE60-2C097784365F"
}

Códigos de erro

HttpCode

Código de erro

Mensagem de erro

Descrição

400

OperationDenied.Arrearage

The operation is denied due to overdue payment.

Operação negada devido a pagamentos em atraso.

400

OperationDenied.BandwidthExceeded

The total bandwidth exceeds the limit. The operation is denied.

A soma dos valores máximos de largura de banda atingiu o limite superior e a operação foi negada.

400

UnsupportedFeature.ApplicationAccelerate

The feature of ApplicationAccelerate is not supported.

Aceleração de aplicação não suportada.

400

ResourceAlreadyAssociated.SmartAccessGateway

The specified resource of SmartAccessGateway is already associated.

A instância SAG especificada já está associada a uma regra de aceleração de aplicação.

400

IncorrectBusinessStatus.ApplicationBandwidthPackage

The business status of ApplicationBandwidthPackage is incorrect.

O plano de largura de banda de aceleração de aplicação especificado está em um estado inválido.

Para obter uma lista de códigos de erro, visite o API Error Center.