Modifier une liste d'autorisation d'adresses IP - - Centre de documentation Alibaba Cloud

Une liste d'autorisation d'adresses IP contient les adresses IP et les blocs CIDR autorisés à accéder à l'instance. Pour plus d'informations sur la configuration d'une liste d'autorisation d'adresses IP, consultez la rubrique Configurer une liste d'autorisation d'adresses IP pour une instance ApsaraDB RDS.

Remarque

Avant d'appeler cette opération, assurez-vous que l'instance est dans l'état Running.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	ModifySecurityIps	Opération à effectuer. Définissez la valeur sur ModifySecurityIps.
DBInstanceId	String	Yes	pgm-bp18n0c8zt45****	ID de l'instance.
SecurityIps	String	Yes	10,23.XX.XX	Adresses IP et blocs CIDR à inclure dans la liste d'autorisation d'adresses IP. Si la liste contient plusieurs adresses IP ou blocs CIDR, séparez-les par des virgules (,). Chaque adresse IP ou bloc CIDR de la liste doit être unique. Pour plus d'informations, consultez la rubrique Configurer une liste d'autorisation d'adresses IP pour une instance ApsaraDB RDS. Les entrées de la liste d'autorisation doivent respecter l'un des formats suivants : Adresses IP, par exemple 10,23.XX.XX. Blocs CIDR, par exemple 10,23.XX.XX/24. Dans cet exemple, 24 indique que le préfixe de chaque adresse IP de la liste d'autorisation est de 24 bits. Vous pouvez remplacer 24 par une valeur comprise entre 1 et 32. Remarque Vous pouvez configurer un maximum de 1 000 adresses IP et blocs CIDR par instance. Si vous souhaitez ajouter un grand nombre d'adresses IP, nous vous recommandons de les regrouper en blocs CIDR, tels que 10,23.XX.XX/24.
DBInstanceIPArrayName	String	No	test	Nom de la liste d'autorisation d'adresses IP à modifier. Valeur par défaut : Default. Remarque Vous pouvez configurer un maximum de 200 listes d'autorisation d'adresses IP par instance.
DBInstanceIPArrayAttribute	String	No	hidden	Attribut de la liste d'autorisation d'adresses IP. Par défaut, ce paramètre est vide. Remarque Les listes d'autorisation d'adresses IP dotées de l'attribut hidden ne s'affichent pas dans la console ApsaraDB RDS. Ces listes servent à accéder aux services Alibaba Cloud, tels que Data Transmission Service (DTS).
SecurityIPType	String	No	IPv4	Type d'adresse IP dans la liste d'autorisation d'adresses IP. La valeur est fixée à IPv4.
WhitelistNetworkType	String	No	Classic	Type de réseau de la liste d'autorisation d'adresses IP. Valeurs valides : Classic : réseau classique en mode de liste d'autorisation amélioré VPC : type de réseau Virtual Private Cloud (VPC) en mode de liste d'autorisation amélioré. MIX : mode de liste d'autorisation standard. Valeur par défaut : MIX. Remarque En mode de liste d'autorisation standard, les adresses IP et les blocs CIDR sont ajoutés uniquement à la liste d'autorisation d'adresses IP par défaut. En mode de liste d'autorisation amélioré, les adresses IP et les blocs CIDR sont ajoutés aux listes d'autorisation d'adresses IP de type réseau classique et de type réseau VPC.
ModifyMode	String	No	Cover	Méthode de modification de la liste d'autorisation d'adresses IP. Valeurs valides : Cover : utilisez les adresses IP et les blocs CIDR spécifiés dans le paramètre SecurityIps pour écraser les adresses IP et les blocs CIDR existants dans la liste d'autorisation. Append : ajoutez les adresses IP et les blocs CIDR spécifiés dans le paramètre SecurityIps à la liste d'autorisation. Delete : supprimez les adresses IP et les blocs CIDR spécifiés dans le paramètre SecurityIps de la liste d'autorisation. Vous devez conserver au moins une adresse IP ou un bloc CIDR. Valeur par défaut : Cover.
FreshWhiteListReadins	String	No	pgr-bp17yuz4dn3d**,pgr-bp1vn2ph54u1**	Instances en lecture seule vers lesquelles synchroniser la liste d'autorisation d'adresses IP. Ce paramètre s'applique uniquement aux instances ApsaraDB RDS for PostgreSQL. Si l'instance est associée à une instance en lecture seule, utilisez ce paramètre pour synchroniser la liste d'autorisation avec l'instance en lecture seule. Si l'instance est associée à plusieurs instances en lecture seule, séparez-les par des virgules (,). Si l'instance n'est associée à aucune instance en lecture seule, ce paramètre est vide.

Paramètres de réponse

Parameter	Type	Example	Description
TaskId	String	115855279	ID de la tâche.
RequestId	String	1AD222E9-E606-4A42-BF6D-8A4442913CEF	ID de la requête.

Exemples

Exemples de requêtes

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

Exemples de réponses réussies

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
}

Codes d'erreur

HTTP status code	Error code	Error message	Description
400	InvalidWhitelistNetType.Malformed	Specified WhitelistNetType is not valid.	La valeur du paramètre WhitelistNetworkType n'est pas valide. Saisissez une valeur valide.
400	InvalidIPArrayAttribute.Format	The format of the IP attribute is invalid.	Le format de la valeur du paramètre DBInstanceIPArrayAttribute n'est pas valide. Saisissez une valeur au format valide et réessayez. Si la liste d'autorisation contient plusieurs adresses IP ou blocs CIDR, assurez-vous qu'ils sont uniques et séparés par des virgules (,). Les entrées de la liste d'autorisation doivent respecter l'un des formats suivants : adresses IP, par exemple 10.23.12.24. Blocs CIDR, par exemple 10.23.12.0/24. Dans ce cas, 24 indique que le préfixe de chaque adresse IP est de 24 bits. Vous pouvez remplacer 24 par une valeur comprise entre 1 et 32.
400	InvalidSecurityIPList.Duplicate	Specified security IP list is not valid: Duplicate IP address in the list.	Les adresses IP ou les blocs CIDR spécifiés ne sont pas valides. Des adresses IP ou des blocs CIDR en double ont été spécifiés.
400	SecurityIPList.Format	Specified SecurityIPList is not valid.	Les adresses IP ou les blocs CIDR spécifiés ne sont pas valides.

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs de l'API.