転送ルールを削除します。

説明　

  • DeleteForwardingRulesは非同期操作です。 リクエストを送信した後、システムはリクエストIDを返しますが、操作はシステムバックグラウンドで実行中です。 ListForwardingRulesを呼び出して、転送ルールの状態を照会できます。
    • 転送ルールが削除中の状態の場合、転送ルールは削除中です。 この場合、クエリ操作のみを実行できます。
    • 転送ルールを照会できない場合、転送ルールは削除されます。
  • DeleteForwardingRules操作は、特定の期間内に同じGlobal Accelerator (GA) インスタンスに対して繰り返し呼び出すことはできません。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

項目 データ型 必須／任意 例: 説明　
操作 String 必須 DeleteForwardingRules

実行する操作です。 値をDeleteForwardingRulesに設定します。

RegionId String 必須 cn-hangzhou

GAインスタンスがデプロイされているリージョンのID。 値をcn-hangzhouに設定します。

ClientToken String 任意 123e4567-e89b-12d3-a456-426655440000

リクエストのべき等性を保証するために使用されるクライアントトークン。

クライアントを使用して値を生成できますが、異なるリクエスト間で一意であることを確認する必要があります。 クライアントトークンにはASCII文字のみを含めることができます。

説明 このパラメーターを設定しない場合、ClientTokenはRequestIdの値に設定されます。 RequestIdの値は、APIリクエストごとに異なる場合があります。
ForwardingRuleIds.N String 必須 frule-bp19a3t3yzr21q3 ****

転送ルールのID。

AcceleratorId String 必須 ga-bp17frjjh0udz4q ****

GA インスタンスの ID です。

ListenerId String 必須 lsr-bp1s0vzbi5bxlx5 ****

リスナーの ID を示します。

レスポンスパラメーター

項目 データ型 例: 説明　
ForwardingRules ForwardingRulesの配列

転送ルールの詳細。

ForwardingRuleId String frule-bp19a3t3yzr21q3 ****

転送ルールのID。

RequestId String CFC67ED9-4AB1-431F-B6E3-A752B7B8CCD4

リクエストの ID です。

例

リクエストの例

http(s)://[Endpoint]/?Action=DeleteForwardingRules
&RegionId=cn-hangzhou
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&ForwardingRuleIds=["frule-bp19a3t3yzr21q3 ****"]
&AcceleratorId=ga-bp17frjjh0udz4q ****
&ListenerId=lsr-bp1s0vzbi5bxlx5 ****
&<共通リクエストパラメーター>

正常に処理された場合のレスポンス例

XML 形式 

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

<DeleteForwardingRulesResponse>
    <ForwardingRules>
        <ForwardingRuleId>frule-bp19a3t3yzr21q3 ****</ForwardingRuleId>
    </ForwardingRules>
    <RequestId>CFC67ED9-4AB1-431F-B6E3-A752B7B8CCD4</RequestId>
</DeleteForwardingRulesResponse>

JSON 形式 

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

{
  "ForwardingRules" : [ {
    "ForwardingRuleId" : "frule-bp19a3t3yzr21q3 ****"
  } ],
  "RequestId" : "CFC67ED9-4AB1-431F-B6E3-A752B7B8CCD4"
}

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明　
400 NotExist.Listener リスナーが存在しません。 指定されたリスナーが存在しない場合に返されるエラーメッセージ。
400 NotActive.Listener リスナーの状態がアクティブではありません。 指定されたリスナーが不安定な場合に返されるエラーメッセージ。
400 NotExist.Accelerator 高速化されたインスタンスは存在しません。 指定されたGAインスタンスが存在しない場合に返されるエラーメッセージ。
400 NotExist.BusinessRegion ビジネスリージョンは存在しません。 指定されたリージョンが存在しない場合に返されるエラーメッセージ。
400 NotExist.BasicBandwidthPackage 基本帯域幅パッケージを指定する必要があります。 基本帯域幅プランが指定されていない場合に返されるエラーメッセージ。
400 QuotaExceeded.EndPoint エンドポイントの最大数を超えています。 エンドポイントの数が上限に達した場合に返されるエラーメッセージ。
400 存在します。EndpointGroup エンドポイントグループは既に存在します。 指定されたエンドポイントグループが既に存在する場合に返されるエラーメッセージ。
400 NoPermission.VpcEndpoint 操作を実行する権限がありません。 サービスにリンクされたロールを作成する権限がない場合に返されるエラーメッセージ。 Alibaba Cloudアカウントの所有者または管理者に連絡して、AliyunGlobalAccelerationFullAccessポリシー、または必要なサービスにリンクされたロールを作成するための権限をRAMユーザーに付与するカスタム権限ポリシーをアタッチしてください。 カスタムポリシーでは、サービス名をo vpcendpoint.ga.aliyuncs.comに、サービスにリンクされたロールをAliyunServiceRoleForGaVpcEndpointに、権限をram:CreateServiceLinkedRoleに設定する必要があります。

エラーコードリストについては、「API エラーセンター」をご参照ください。