Bir IPsec-VPN bağlantısına hedef rota girişi eklemek için CreateVcoRouteEntry işlemini çağırır.
Operation description
IPsec-VPN bağlantısı bir transit yönlendirici örneğiyle ilişkilendirilmiş olmalıdır. Daha fazla bilgi için CreateTransitRouterVpnAttachment sayfasına bakın.
Hedef CIDR bloğu 0.0.0.0/0 olan bir hedef rota ekleyemezsiniz.
Hedef CIDR bloğu 100.64.0.0/10, 100.64.0.0/10'un bir alt ağı veya 100.64.0.0/10'u içeren bir CIDR bloğu olan hedef rota eklemeyin. Bu tür rota girişleri, konsolun IPsec-VPN bağlantısının durumunu görüntüleyememesine veya IPsec-VPN anlaşmasının başarısız olmasına neden olur.
- CreateVcoRouteEntry işlemi eşzamansızdır. Bir istek gönderdikten sonra sistem bir örnek kimliği döndürür, ancak hedef rota girişi henüz oluşturulmamıştır. Oluşturma görevi arka planda çalışmaya devam eder. Hedef rota girişinin oluşturma durumunu sorgulamak için DescribeVpnConnection işlemini çağırabilirsiniz:
IPsec-VPN bağlantısı updating durumundaysa, hedef rota girişi oluşturuluyor demektir.
IPsec-VPN bağlantısı attached durumundaysa, hedef rota girişi oluşturulmuş demektir.
CreateVcoRouteEntry işlemi, aynı IPsec-VPN bağlantısı için hedef rota girişlerinin eşzamanlı olarak oluşturulmasını desteklemez.
Try it now
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
vpc:CreateVcoRouteEntry |
create |
*VpnConnections
|
None | None |
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| RegionId |
string |
Yes |
IPsec-VPN bağlantısının bölge kimliği. Bölge kimliğini sorgulamak için DescribeRegions işlemini çağırabilirsiniz. |
cn-hangzhou |
| VpnConnectionId |
string |
Yes |
IPsec-VPN bağlantısının kimliği. |
vco-p0w2jpkhi2eeop6q6**** |
| RouteDest |
string |
Yes |
Hedef rota girişinin hedef CIDR bloğu. |
192.168.10.0/24 |
| Weight |
integer |
Yes |
Hedef rota girişinin ağırlığı. Geçerli değerler:
|
100 |
| NextHop |
string |
Yes |
Hedef rota girişinin sonraki atlama noktası. |
vco-p0w2jpkhi2eeop6q6**** |
| Description |
string |
No |
Hedef rota girişinin açıklaması. |
desctest |
| OverlayMode |
string |
No |
Tünel protokolü. Değeri, IPsec tünel protokolünü belirten Ipsec (varsayılan) olarak ayarlayın. |
Ipsec |
| ClientToken |
string |
No |
İsteğin idempotent olmasını sağlamak için kullanılan istemci belirteci. Belirteci oluşturmak için istemciyi kullanabilirsiniz, ancak belirtecin farklı istekler arasında benzersiz olduğundan emin olmalısınız. İstemci belirteci yalnızca ASCII karakterleri içerebilir. Not
Bu parametreyi belirtmezseniz, sistem otomatik olarak API isteğinin RequestId değerini ClientToken olarak kullanır. RequestId her API isteği için farklı olabilir. |
123e4567-e89b-12d3-a456-4266**** |
| DryRun |
boolean |
No |
Deneme çalıştırması yapılıp yapılmayacağını belirtir. Geçerli değerler:
|
false |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
Yanıt parametreleri. |
||
| VpnConnectionId |
string |
IPsec-VPN bağlantısının kimliği. |
vco-p0w2jpkhi2eeop6q6**** |
| RouteDest |
string |
Hedef rota girişinin hedef CIDR bloğu. |
192.168.10.0/24 |
| NextHop |
string |
Hedef rota girişinin sonraki atlama noktası. |
vco-p0w2jpkhi2eeop6q6**** |
| Weight |
integer |
Hedef rota girişinin ağırlığı.
|
100 |
| OverlayMode |
string |
Tünel protokolü. Değer, IPsec tünel protokolünü belirten Ipsec değeridir. |
Ipsec |
| State |
string |
Hedef rota girişinin yayımlama durumu. Değer, rota girişinin transit yönlendirici örneğine yayımlandığını belirten published değeridir. |
published |
| CreateTime |
integer |
Hedef rota girişinin oluşturulduğu zaman damgası. Birim: milisaniye. Zaman damgası, 1 Ocak 1970 00:00:00 UTC'den bu yana geçen milisaniye sayısını temsil eden UNIX zaman damgası biçimini izler. |
1658387202664 |
| RequestId |
string |
İstek kimliği. |
CFC4D13B-E680-3985-95B1-87AA155481DF |
| Description |
string |
Hedef rota girişinin açıklaması. |
desctest |
Examples
Success response
JSON format
{
"VpnConnectionId": "vco-p0w2jpkhi2eeop6q6****",
"RouteDest": "192.168.10.0/24",
"NextHop": "vco-p0w2jpkhi2eeop6q6****",
"Weight": 100,
"OverlayMode": "Ipsec",
"State": "published",
"CreateTime": 1658387202664,
"RequestId": "CFC4D13B-E680-3985-95B1-87AA155481DF",
"Description": "desctest"
}
Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | Resource.QuotaFull | The quota of resource is full | |
| 400 | VpnConnection.Configuring | The specified service is configuring. | The service is being configured. Try again later. |
| 400 | VpnConnection.FinancialLocked | The specified service is financial locked. | The error message returned because the service is locked due to overdue payments. |
| 400 | VpnRouteEntry.AlreadyExists | The specified route entry is already exist. | The route already exists. |
| 400 | VpnRouteEntry.Conflict | The specified route entry has conflict. | Route conflicts exist. |
| 400 | VpnRouteEntry.ConflictSSL | The specified route entry has conflict with SSL client. | The route conflicts with the SSL client. |
| 400 | VpnRouteEntry.BackupRoute | Validate backup route entry failed. | Active/standby routes failed authentication. |
| 400 | InvalidNextHop.NotFound | The specified NextHop does not exist. | The specified next hop does not exist. |
| 400 | IllegalParam.RouteDest | The specified RouteDest is invalid | The destination address is invalid. |
| 400 | OperationFailed.InvalidCidrBlock | Operation failed because the specified network block is invalid. | The CIDR block is invalid. |
| 400 | QuotaExceeded.VpnRouteEntry | The number of route entries to the VPN gateway in the VPC routing table has reached the quota limit. | The number of route entries to the VPN gateway in the VPC routing table has reached the quota limit. |
| 400 | TaskConflict | The operation is too frequent, please wait a moment and try again. | Your requests are too frequent. Try again later. |
| 400 | Resource.PbrRouteQuotaFull | The quota of Policy-based route is full. | Policy routing quota exceeded |
| 400 | CreatePbrRoutesQuotaFull.QuotaFull | The number of policy routes exceeds the quota limit. | The number of policy routes exceeds the quota limit. |
| 400 | CreateDbrRoutesQuotaFull.QuotaFull | The number of created destination routes exceeds the quota limit. | The number of created destination routes exceeds the quota limit. |
| 400 | DryRunOperation | Request validation has been passed with DryRun flag set. | The request passed the dry run. |
| 403 | Forbbiden.SubUser | User not authorized to operate on the specified resource. | The error message returned because you do not have the permissions to manage the resource. |
| 403 | Forbidden | User not authorized to operate on the specified resource. | You do not have the permissions to manage the specified resource. Apply for the permissions and try again. |
| 404 | InvalidVpnConnectionInstanceId.NotFound | The specified vpn connection instance id does not exist. | The specified vpn connection instance id does not exist. |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.