modifique uma lista de permissões de endereços IP - : Central de Documentação do Alibaba Cloud

Uma lista de permissões de endereços IP contém os endereços IP e blocos CIDR que têm acesso concedido à instância. Para obter mais informações, configure uma lista de permissões de endereços IP, consulte configure uma lista de permissões de endereços IP para uma instância do apsaradb rds.

Nota

Antes de chamar esta operação, certifique-se de que a instância esteja no estado Running.

Depuração

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

Parâmetros da requisição

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	ModifySecurityIps	A operação que você deseja executar. Defina o valor como ModifySecurityIps.
DBInstanceId	String	Sim	pgm-bp18n0c8zt45****	O ID da instância.
SecurityIps	String	Sim	10.23.XX.XX	Os endereços IP e blocos CIDR que você deseja incluir na lista de permissões de endereços IP. Se a lista de permissões de endereços IP contiver mais de um endereço IP ou bloco CIDR, separe esses endereços IP e blocos CIDR com vírgulas (,). Cada endereço IP ou bloco CIDR na lista de permissões de endereços IP deve ser único. Para obter mais informações, consulte configure uma lista de permissões de endereços IP para uma instância do apsaradb rds. As entradas na lista de permissões de endereços IP devem estar em um dos seguintes formatos: Endereços IP, como 10.23.XX.XX. Blocos CIDR, como 10.23.XX.XX/24. Neste exemplo, 24 indica que o prefixo de cada endereço IP na lista de permissões de endereços IP tem 24 bits de comprimento. Substitua 24 por um valor dentro do intervalo de 1 a 32. Nota Você pode configure no máximo 1.000 endereços IP e blocos CIDR para cada instância. Se você deseja adicionar um grande número de endereços IP, recomendamos que os agrupe em blocos CIDR, como 10.23.XX.XX/24.
DBInstanceIPArrayName	String	Não	test	O nome da lista de permissões de endereços IP que você deseja modifique. Valor padrão: Default. Nota Você pode configure no máximo 200 listas de permissões de endereços IP para cada instância.
DBInstanceIPArrayAttribute	String	Não	hidden	O atributo da lista de permissões de endereços IP. Por padrão, este parâmetro está vazio. Nota O console do apsaradb rds não exibe as listas de permissões de endereços IP que possuem o atributo hidden. Essas listas de permissões de endereços IP são usadas para acessar serviços da alibaba cloud, como o Data Transmission Service (DTS).
SecurityIPType	String	Não	IPv4	O tipo de endereço IP na lista de permissões de endereços IP. O valor é fixo como IPv4.
WhitelistNetworkType	String	Não	Classic	O tipo de rede da lista de permissões de endereços IP. Valores válidos: Classic: rede clássica no modo de lista de permissões aprimorado VPC: tipo de rede de nuvem privada virtual (VPC) no modo de lista de permissões aprimorado. MIX: modo de lista de permissões padrão. Valor padrão: MIX. Nota No modo de lista de permissões padrão, o sistema adiciona os endereços IP e blocos CIDR apenas à lista de permissões de endereços IP padrão. No modo de lista de permissões aprimorado, o sistema os adiciona às listas de permissões de endereços IP do tipo de rede clássica e às do tipo de rede VPC.
ModifyMode	String	Não	Cover	O método usado para modifique a lista de permissões de endereços IP. Valores válidos: Cover: Use os endereços IP e blocos CIDR especificados no parâmetro SecurityIps para substituir os endereços IP e blocos CIDR existentes na lista de permissões de endereços IP. Append: Adicione os endereços IP e blocos CIDR especificados no parâmetro SecurityIps à lista de permissões de endereços IP. Delete: exclua os endereços IP e blocos CIDR especificados no parâmetro SecurityIps da lista de permissões de endereços IP. Você deve manter pelo menos um endereço IP ou bloco CIDR. Valor padrão: Cover.
FreshWhiteListReadins	String	Não	pgr-bp17yuz4dn3d**,pgr-bp1vn2ph54u1**	As instâncias somente leitura para as quais você deseja sincronizar a lista de permissões de endereços IP. Este parâmetro se aplica apenas a instâncias do apsaradb rds for PostgreSQL. Se a instância estiver anexada a uma instância somente leitura, use este parâmetro para sincronizar a lista de permissões de endereços IP com a instância somente leitura. Se a instância estiver anexada a várias instâncias somente leitura, as instâncias somente leitura devem ser separadas por vírgulas (,). Se a instância não estiver anexada a uma instância somente leitura, este parâmetro estará vazio.

Parâmetros da resposta

Parâmetro	Tipo	Exemplo	Descrição
TaskId	String	115855279	O ID da tarefa.
RequestId	String	1AD222E9-E606-4A42-BF6D-8A4442913CEF	O ID da requisição.

Exemplos

Exemplos de requisições

http(s)://rds.aliyuncs.com/?Action=ModifySecurityIps
&DBInstanceId=pgm-bp18n0c8zt45****
&SecurityIps=10.23.12.24
&<Common request parameters>

Exemplos de respostas de sucesso

XML format

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

<ModifySecurityIpsResponse>
	<RequestId> 1AD222E9-E606-4A42-BF6D-8A4442913CEF</RequestId>
	<TaskId>115855279</TaskId>
</ModifySecurityIpsResponse>

JSON format

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

{
  "RequestId" : " 1AD222E9-E606-4A42-BF6D-8A4442913CEF",
  "TaskId" : 115855279
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidWhitelistNetType.Malformed	Specified WhitelistNetType is not valid.	Mensagem de erro exibida quando o valor do parâmetro WhitelistNetworkType é inválido. Insira um valor válido.
400	InvalidIPArrayAttribute.Format	The format of the IP attribute is invalid.	Mensagem de erro exibida quando o valor do parâmetro DBInstanceIPArrayAttribute está em um formato inválido. Insira um valor no formato válido e tente novamente. Se a lista de permissões de endereços IP contiver vários endereços IP ou blocos CIDR, certifique-se de que os endereços IP e blocos CIDR sejam únicos e estejam separados por vírgulas (,). As entradas na lista de permissões de endereços IP devem estar em um dos seguintes formatos: endereços IP, como 10.23.12.24; blocos CIDR, como 10.23.12.0/24. Neste caso, 24 indica que o prefixo de cada endereço IP tem 24 bits de comprimento. Substitua 24 por um valor dentro do intervalo de 1 a 32.
400	InvalidSecurityIPList.Duplicate	Specified security IP list is not valid: Duplicate IP address in the list.	Mensagem de erro exibida quando os endereços IP ou blocos CIDR especificados são inválidos. Os endereços IP ou blocos CIDR especificados estão duplicados.
400	SecurityIPList.Format	Specified SecurityIPList is not valid.	Mensagem de erro exibida quando os endereços IP ou blocos CIDR especificados são inválidos.

Para obter uma lista de códigos de erro, visite o Centro de Erros de API.