調用RetryVpcPrefixListAssociation介面重新下發最新的首碼列表。
介面說明
當您修改了首碼列表執行個體的資訊後,關聯首碼列表執行個體的路由表中未自動更新成功首碼列表執行個體的資訊時,您可以使用該介面重新向關聯的路由表下發最新的首碼列表執行個體。
- RetryVpcPrefixListAssociation 介面屬於非同步介面,即系統返回一個請求 ID,但該最新的首碼列表執行個體尚未重新下發成功,系統背景重新下發任務仍在進行。您可以調用 GetVpcPrefixListAssociations 查詢首碼列表執行個體的最新下髮狀態:
當首碼列表執行個體的下髮狀態處於 Modifying 時,表示最新的首碼列表執行個體正在重新下發中。
當首碼列表執行個體的下髮狀態處於 ModifyFailed 時,表示最新的首碼列表執行個體重新下發失敗。
當首碼列表執行個體的下髮狀態處於 Created 時,表示最新的首碼列表執行個體重新下發成功。
RetryVpcPrefixListAssociation 介面不支援針對同一個首碼列表並發重試下發最新的首碼列表執行個體。
情境說明
修改首碼列表執行個體時,只要 CIDR 網段合法並且沒有衝突的 CIRD 網段,也沒有超過首碼列表執行個體的最大條目數即可修改成功。然而由於引用方的原因(例如,由於配額的原因或者與已有的路由衝突),可能會導致引用失敗。您可以在引用方處將失敗的問題解決後,請調用 RetryVpcPrefixListAssociation 介面,重新下發最新的首碼列表執行個體。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
vpc:RetryVpcPrefixListAssociation |
update |
*PrefixList
|
無 | 無 |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| PrefixListId |
string |
是 |
要重新下發的首碼列表的執行個體 ID。 |
pl-0b7hwu67**** |
| ResourceType |
string |
是 |
關聯首碼列表執行個體的資源類型。取值:
|
vpcRouteTable |
| ResourceId |
string |
是 |
關聯的資源的執行個體 ID。 |
vtb-bp1drpcfz9srr393h**** |
| ClientToken |
string |
否 |
用戶端 Token,用於保證請求的等冪性。 從您的用戶端產生一個參數值,確保不同請求間該參數值唯一。ClientToken 只支援 ASCII 字元。 說明
若您未指定,則系統自動使用 API 請求的 RequestId 作為 ClientToken 標識。每次 API 請求的 RequestId 可能不一樣。 |
123e4567-e89b-12d3-a456-426655440000 |
| DryRun |
boolean |
否 |
是否只預檢此次請求。取值:
|
false |
| RegionId |
string |
是 |
要重新下發的首碼列表執行個體所在地區 ID。 您可以通過調用 DescribeRegions 介面擷取地區 ID。 |
cn-hangzhou |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
|||
| RequestId |
string |
請求 ID。 |
4EC47282-1B74-4534-BD0E-403F3EE64CAF |
樣本
正常返回樣本
JSON格式
{
"RequestId": "4EC47282-1B74-4534-BD0E-403F3EE64CAF"
}
錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 400 | UnsupportedRegion | The feature of prefixList entry is not supported in this region. | 本地區不支援操作prefixList路由 |
| 400 | OperationDenied.SystemPrefixList | The operation is not allowed because of SystemPrefixList. | 不允許作業系統PrefixList |
| 400 | OperationFailed.OperateShareResource | This is not allowed to operate shared prefixList. | 無法操作共用PrefixList |
| 400 | IncorrectStatus.PrefixList | The status of prefixList is incorrect. | PrefixList處於中間態,無法操作 |
| 400 | OperationFailed.NotExistAssociateRelation | The operation is failed because of association not exist. | 操作失敗,PrefixList不存在該參考關聯性 |
| 400 | ResourceNotFound.PrefixList | The specified resource of prefixList is not found. | 輸入的prefixList不存在 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。