Modifie une entrée DNAT spécifiée.
Description de l'opération
-
ModifyForwardEntry est une opération asynchrone. Après l'envoi d'une requête, le système renvoie un identifiant de requête, mais l'entrée DNAT n'a pas encore été modifiée. La tâche de modification s'exécute en arrière-plan. Vous pouvez appeler DescribeForwardTableEntries pour interroger l'état de l'entrée DNAT :
-
Si l'entrée DNAT est dans l'état Pending, l'entrée DNAT est en cours de modification. Dans cet état, vous pouvez uniquement effectuer des opérations de requête.
-
Si l'entrée DNAT est dans l'état Available, l'entrée DNAT est modifiée.
-
-
ModifyForwardEntry ne prend pas en charge les modifications simultanées d'une entrée DNAT au sein de la même table DNAT.
Testez maintenant
Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.
Test
Autorisation RAM
|
vpc:ModifyForwardEntry |
update |
*ForwardTable
|
Aucune | Aucune |
Paramètres de requête
|
Paramètre |
Type |
Requis |
Description |
Exemple |
| ForwardTableId |
string |
Oui |
L'identifiant de la table DNAT à laquelle l'entrée DNAT appartient. |
ftb-8vbx8xu2lqj9qb334**** |
| ForwardEntryId |
string |
Oui |
L'identifiant de l'entrée DNAT à modifier. |
fwd-8vbn3bc8roygjp0gy**** |
| ExternalIp |
string |
Non |
|
116.85.XX.XX |
| ExternalPort |
string |
Non |
|
80 |
| InternalIp |
string |
Non |
|
10.0.0.78 |
| InternalPort |
string |
Non |
|
80 |
| IpProtocol |
string |
Non |
Le type de protocole. Valeurs valides :
|
TCP |
| ForwardEntryName |
string |
Non |
Le nouveau nom de l'entrée DNAT. Le nom doit comporter de 2 à 128 caractères et doit commencer par une lettre ou un caractère chinois. Il ne peut pas commencer par |
test |
| RegionId |
string |
Oui |
L'identifiant de la région de la passerelle NAT. Vous pouvez appeler DescribeRegions pour interroger l'identifiant de la région. |
cn-hangzhou |
| ClientToken |
string |
Non |
Le jeton client utilisé pour garantir l'idempotence de la requête. Vous pouvez utiliser le client pour générer le jeton, mais vous devez vous assurer que le jeton est unique pour chaque requête. Le jeton ne peut contenir que des caractères ASCII. Remarque
Si vous ne spécifiez pas ce paramètre, le système utilise automatiquement le RequestId de la requête API comme ClientToken. Le RequestId peut être différent pour chaque requête API. |
123e4567-e89b-12d3-a456-426655440000 |
| PortBreak |
boolean |
Non |
Indique si la rupture de port doit être activée. Valeurs valides :
|
false |
| DryRun |
boolean |
Non |
Indique si un test à blanc doit être effectué. Valeurs valides :
|
false |
Éléments de réponse
|
Élément |
Type |
Description |
Exemple |
|
object |
L'identifiant de la requête. |
||
| RequestId |
string |
L'identifiant de la requête. |
2315DEB7-5E92-423A-91F7-4C1EC9AD97C3 |
Exemples
JSON format
{
"RequestId": "2315DEB7-5E92-423A-91F7-4C1EC9AD97C3"
}
Codes d'erreur
|
Code de statut HTTP |
Code d'erreur |
Message d'erreur |
Description |
|---|---|---|---|
| 400 | UnsupportedFeature.PortSegment | The feature of PortSegment is not supported. | |
| 400 | ExclusiveParam.%sAnd%s | The param of %s and %s are mutually exclusive. | You cannot specify %s and %s at the same time. |
| 400 | InvalidIp.NotInNatgw | The specified Ip not belong to natgateway. | |
| 400 | DuplicatedParam.InternalPort | The param of %s is duplicated. | Duplicate or occupied InternalPort parameter |
| 400 | DuplicatedParam.ExternalPort | The param of %s is duplicated. | The DNAT public network port has been used repeatedly. |
| 400 | OperationFailed.AnyPortConfig | Operation failed because any port correspondence any protocol | The operation failed. There is a conflict with another entry, any port or any protocol type. |
| 400 | OperationUnsupported.ForwardEntry | Duplicated destination ip port is unsupported. | You cannot specify duplicate destination IP addresses or destination ports. |
| 400 | IncorrectStatus.NatIp | The status of %s [%s] is incorrect. | The status of NatIp is incorrect. |
| 400 | Forbidden.IpHasBeenUsedInSnat | The source ip can't be used. Because it has been used in snat. | |
| 400 | IncorrectStatus.ForwardEntry | The status of %s [%s] is incorrect. | The DNAT entry to be deleted is in an invalid state. |
| 400 | InvalidExternalIp.Malformed | The specified ExternalIp is not a valid IP address. | |
| 400 | InvalidInternalIp.Malformed | The specified InternalIp is not a valid IP address. | |
| 400 | InvalidExternalPort.Malformed | The specified ExternalPort is not a valid port. | |
| 400 | InvalidInternalPort.Malformed | The specified InternalPort is not a valid port. | |
| 400 | Forbidden.DestnationIpOutOfVpcCIDR | The specified Destination Ip is Out of VPC CIDR. | |
| 400 | InvalidProtocal.ValueNotSupported | The specified IpProtocol does not support. | |
| 400 | IncorretForwardEntryStatus | Some Forward entry status blocked this operation.. | |
| 400 | QuotaExceeded | Forward entry quota exceeded in this route table. | A route table can only have 200 custom route entries at most. |
| 400 | ForwardEntry.Duplicated | The specified ExternalIp, IpProtocol, ExternalPort,InternalIp, InternalPort is duplicated | |
| 400 | Forbidden.ExternalIp.UsedInSnatTable | The specified ExternalIp is already used in SnatTable | |
| 400 | Forbidden.Already.Bounded | The specified instance already bounded | |
| 400 | InvalidIp.NotFound | The specified ip does not exist. | |
| 400 | InvalidParameter.Name.Malformed | The specified Name is not valid. | |
| 400 | IncorretStatus.ForwardEntry | The Specified forwardEntry is not stable status, can not operation | |
| 400 | IllegalParam.AnyPortNotZero | Any port port must be zero. | You must set the destination port and source port to 0 when IpProtocol is set to Any. |
| 400 | Duplicated.DestinationPort | The specified param DestinationPort is duplicated. | |
| 400 | InvalidForwardEntryId.NotFound | Specified forward entry ID does not exist | |
| 400 | OperationUnsupported.EipInBinding | Create snat entry with eip in associating status is unsupported. | You cannot use an associated EIP when you create an SNAT entry. |
| 400 | QuotaExceeded.ForwardEntrySessionManytoOne | The dnat session quota is exceed. | The number of DNAT sessions exceeds the upper limit. |
| 400 | OperationFailed.ForwardEntryNotAllowSrcIpEqualDstIp | The source IP of forward entry is not allowed to equal destination IP. | The public IP address of the DNAT entry is not allowed to be equal to the private IP address. |
| 404 | ResourceNotFound.NatIp | The specified resource of %s is not found. | |
| 404 | ResourceNotFound.ForwardEntry | The specified resource of %s is not found. | The specified %s resource does not exist. |
| 404 | InvalidRegionId.NotFound | The specified RegionId does not exist in our records. | |
| 404 | InvalidForwardEntryId.NotFound | Specified forward entry ID does not exist | |
| 404 | InvalidExternalIp.NotFound | Specified External Ip address does not found on the VRouter | |
| 404 | InvalidForwardTableId.NotFound | Specified forward table does not exist. |
Consultez Codes d'erreur pour la liste complète.
Notes de version
Consultez Notes de version pour la liste complète.