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

Use um modelo de parâmetros para configurar vários parâmetros simultaneamente e aplique-o às instâncias. Para obter mais informações, consulte Usar um modelo de parâmetros para configurar os parâmetros de instâncias do ApsaraDB RDS for MySQL ou 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 é compatível apenas com instâncias do ApsaraDB RDS for MySQL e do ApsaraDB RDS for PostgreSQL.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos usar esta ferramenta para chamar a operação. O OpenAPI Explorer também gera dinamicamente códigos de exemplo para diferentes SDKs.

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	ModifyParameterGroup	Operação a ser executada. Defina o valor como ModifyParameterGroup.
ParameterGroupId	String	Sim	rpg-13ppdh****	ID do modelo de parâmetros. Chame a operação DescribeParameterGroups para consultar os IDs dos modelos de parâmetros.
ParameterGroupName	String	Não	testgroup1	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 deve variar entre 8 e 64 caracteres. Nota Se este parâmetro não for especificado, o nome original do modelo será mantido.
ParameterGroupDesc	String	Não	test	Descrição do modelo de parâmetros, limitada a 200 caracteres. Nota Se este parâmetro não for especificado, a descrição original do modelo será mantida.
Parameters	String	Não	{"back_log":"3000"}	String JSON contendo os parâmetros e valores a modificar no modelo. Formato: {"Parâmetro 1":"Valor do Parâmetro 1","Parâmetro 2":"Valor do Parâmetro 2 "......}. Para detalhes sobre 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. Nota Ao definir ModifyMode como Individual e especificar este parâmetro, os novos valores substituem integralmente os do modelo original. Ao definir ModifyMode como Collectivity e especificar este parâmetro, os novos valores são adicionados ao modelo original ou atualizam os existentes. Sem a especificação deste parâmetro, as configurações originais permanecem inalteradas.
RegionId	String	Sim	cn-hangzhou	ID da região. Chame a operação DescribeRegions para obter a lista de regiões mais recente. Nota Não é possível alterar a região de um modelo de parâmetros. Use a operação CloneParameterGroup para replicar o modelo em outra região.
ModifyMode	String	Não	Collectivity	Modo de modificação do modelo de parâmetros. Valores válidos: Collectivity: adiciona novos parâmetros ou modifica os existentes no modelo original. Valor padrão. Nota Neste modo, o sistema adiciona o valor de Parameters ao modelo original ou atualiza os parâmetros correspondentes, sem afetar as demais configurações. Individual: substitui os parâmetros originais. Nota Neste modo, o sistema usa o valor de Parameters para sobrescrever as configurações do modelo original.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
ParameterGroupId	String	rpg-13ppdh****	ID do modelo de parâmetros.
RequestId	String	857DC00B-7B85-4853-8B27-AD65EB618BC6	ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://rds.aliyuncs.com/?Action=ModifyParameterGroup
&ParameterGroupId=rpg-13ppdh****
&Parameters={"back_log":"3000"}
&ModifyMode=Collectivity
&Common request parameters

Exemplos de respostas de sucesso

Formato XML

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

<ModifyParameterGroupResponse>
    <ParameterGroupId>rpg-13ppdh****</ParameterGroupId>
    <RequestId>857DC00B-7B85-4853-8B27-AD65EB618BC6</RequestId>
</ModifyParameterGroupResponse>

Formato JSON

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

{
  "ParameterGroupId" : "rpg-13ppdh****",
  "RequestId" : "857DC00B-7B85-4853-8B27-AD65EB618BC6"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	ParamGroupsNameInvalid	The parameter group name is invalid.	Nome do modelo de parâmetros inválido. O nome deve ter entre 8 e 64 caracteres, iniciar com uma letra e conter apenas letras, dígitos, pontos (.) e sublinhados (_).

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