Crie um modelo de parâmetros - : Central de Documentação do Alibaba Cloud

Utilize um modelo de parâmetros para configurar vários parâmetros simultaneamente e, em seguida, aplique-o a uma instância. Para mais informações, consulte Usar um modelo de parâmetros para configurar os parâmetros de instâncias do ApsaraDB RDS for MySQL e Usar um modelo de parâmetros para configurar os parâmetros de instâncias do ApsaraDB RDS for PostgreSQL.

Nota

A aplicação de modelos de parâmetros é suportada apenas em instâncias do ApsaraDB RDS for MySQL e do ApsaraDB RDS for PostgreSQL.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	CreateParameterGroup	A operação que você deseja executar. Defina o valor como CreateParameterGroup.
RegionId	String	Sim	cn-hangzhou	O ID da região do modelo de parâmetros. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.
ParameterGroupName	String	Sim	test1234	O nome do modelo de parâmetros. O nome pode conter letras, dígitos, pontos (.) e sublinhados (_) e deve começar com uma letra. O comprimento do nome deve ser de 8 a 64 caracteres.
Engine	String	Sim	mysql	O mecanismo de banco de dados. Valores válidos: mysql PostgreSQL
EngineVersion	String	Sim	5,7	A versão do mecanismo de banco de dados executada na instância. Valores válidos: Se a instância executa MySQL, ela deve utilizar uma das seguintes versões: 5,6 5,7 8,0 Caso a instância execute PostgreSQL, as versões compatíveis são: 10,0 11,0 12,0 13,0 14,0 15,0
Parameters	String	Sim	{"back_log":"3000","wait_timeout":"86400"}	Uma string JSON composta pelos parâmetros e seus respectivos valores no modelo. Formato: {"Parâmetro 1":"Valor do Parâmetro 1","Parâmetro 2":"Valor do Parâmetro 2"...}. Para obter mais detalhes sobre os parâmetros modificáveis, consulte Modificar os parâmetros de uma instância do ApsaraDB RDS for MySQL ou Modificar os parâmetros de uma instância do ApsaraDB RDS for PostgreSQL.
ParameterGroupDesc	String	Não	test	A descrição do modelo de parâmetros. Este campo aceita até 200 caracteres.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
ParameterGroupId	String	rpg-q488w14xvsk****	O ID do modelo de parâmetros. Chame a operação DescribeParameterGroups para consultar os IDs dos modelos de parâmetros.
RequestId	String	7A41C147-C8D0-4DAE-A1A2-17EBCD60DFA1	O ID da solicitação.

Exemplos

Solicitações de exemplo

http(s)://rds.aliyuncs.com/?Action=CreateParameterGroup
&RegionId=cn-hangzhou
&ParameterGroupName=test1234
&Engine=mysql
&EngineVersion=5.7
&Parameters={"back_log":"3000","wait_timeout":"86400"}
&<Common request parameters>

Respostas de sucesso de exemplo

Formato XML

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

<CreateParameterGroupResponse>
    <ParameterGroupId>rpg-q488w14xvsk****</ParameterGroupId>
    <RequestId>7A41C147-C8D0-4DAE-A1A2-17EBCD60DFA1</RequestId>
</CreateParameterGroupResponse>

Formato JSON

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

{
  "ParameterGroupId" : "rpg-q488w14xvsk****",
  "RequestId" : "7A41C147-C8D0-4DAE-A1A2-17EBCD60DFA1"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidParameters.Malformed	The specified parameter "Parameters" is not valid.	Mensagem retornada porque o valor do parâmetro Parameters é inválido. Especifique um valor válido.
400	ParamGroupsNameInvalid	The specified parameter group name is invalid.	Indica que o nome do modelo de parâmetros é inválido. O nome deve ter entre 8 e 64 caracteres, podendo conter letras, dígitos, pontos (.) e sublinhados (_), e precisa iniciar com uma letra.
400	InvalidEngine.Malformed	Specified engine is not valid.	Ocorreu porque o mecanismo de banco de dados especificado não é válido. Informe um mecanismo correto.
400	InvalidEngineVersion.Malformed	Specified engine version is not valid.	Retorna este erro quando a versão do mecanismo de banco de dados informada é inválida. Verifique a versão e tente novamente.
400	ParamGroupsDbTypeNotSupport	The parameter group does not support the specified database type.	Sinaliza que o modelo de parâmetros tem suporte apenas para instâncias que executam MySQL.
400	ParamGroupsDbVersionNotSupport	The parameter group does not support the database version.	Informa que o modelo de parâmetros é compatível exclusivamente com instâncias rodando MySQL 5,6, MySQL 5,7 ou MySQL 8,0.
400	ParamNotExist	This param Not Exist	O parâmetro especificado não existe. Revise a configuração do parâmetro Parameters.
400	ParamTypeError	The parameter type error.	Aponta que o tipo do parâmetro está incorreto.
400	ParamGroupsNotExistOrTypeNotSupport	The parameter group does not exist or its type is not supported.	Significa que o modelo de parâmetros não foi encontrado ou seu tipo não possui suporte.
400	InvalidRegion.Format	Specified Region is not valid.	A região especificada é inválida.
400	InvalidParameters.Format	Specified parameter is not valid	O formato de um dos parâmetros fornecidos está incorreto.
400	ParamGroupsDescInvalid	The maximum length of parameter group description is exceeded.	A descrição do modelo de parâmetros ultrapassou o limite de 200 caracteres.

Para obter uma lista completa de códigos de erro, consulte Códigos de erro do serviço.