IPv6 CIDR ブロックを持つ VPC 内の ECS インスタンスがクライアントの IPv6 エンドポイントに対してアウトバウンドアクセスを開始できるようにする一方で、クライアントの IPv6 エンドポイントがインターネット経由で VPC 内の ECS インスタンスにアクセスできないようにするための送信のみルールを作成できます。IPv6 アドレスに対して送信のみルールを追加するには、CreateIpv6EgressOnlyRule を呼び出します。
操作説明
- CreateIpv6EgressOnlyRule API は非同期です。システムはすぐにインスタンス ID を返しますが、IPv6 アドレスに対する送信のみルールはまだ正常に作成されておらず、作成タスクがバックグラウンドで継続しています。DescribeIpv6EgressOnlyRules を呼び出して、IPv6 アドレスに対する送信のみルールの作成ステータスを照会できます。
IPv6 アドレスに対する送信のみルールのステータスが Creating の場合、ルールがまだ作成中であることを示します。
IPv6 アドレスに対する送信のみルールのステータスが Created の場合、ルールが正常に作成されたことを示します。
CreateIpv6EgressOnlyRule API は、同一の IPv6 アドレスに対して送信のみルールを同時に追加することをサポートしていません。
今すぐお試しください
テスト
RAM 認証
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| RegionId |
string |
必須 |
IPv6 ゲートウェイがデプロイされているリージョンの ID です。 DescribeRegions 操作を呼び出して、リージョン ID を照会できます。 |
cn-huhehaote |
| Ipv6GatewayId |
string |
必須 |
IPv6 ゲートウェイの ID です。 |
ipv6gw-hp3c2paq0ywauasza**** |
| InstanceId |
string |
必須 |
送信のみルールを作成する対象の IPv6 アドレスの ID です。 |
ipv6-hp3nxjkfxn5pnhgl5**** |
| InstanceType |
string |
任意 |
送信のみルールを作成する対象のインスタンスのタイプです。 デフォルト値：Ipv6Address |
Ipv6Address |
| Name |
string |
任意 |
送信のみルールの名前です。 名前の長さは 0～128 文字で、 |
rulename |
| Description |
string |
任意 |
送信のみルールの説明です。 説明の長さは 0～256 文字で、 |
ruledescription |
| ClientToken |
string |
任意 |
リクエストのべき等性を保証するために使用されるクライアントトークンです。 クライアント側でトークンを生成できますが、異なるリクエスト間でトークンが一意であることを保証する必要があります。トークンには ASCII 文字のみを使用でき、長さは 64 文字を超えてはいけません。 説明
このパラメーターを指定しない場合、システムは自動的に RequestId の値をクライアントトークンとして使用します。RequestId の値は各 API リクエストごとに異なります。 |
0c593ea1-3bea-11e9-b96b-88e9fe637760 |
| RegionId |
string |
必須 |
IPv6 ゲートウェイがデプロイされているリージョンの ID です。 DescribeRegions 操作を呼び出して、リージョン ID を照会できます。 |
cn-huhehaote |
| DryRun |
boolean |
任意 |
実際の実行を行わずにリクエストをドライランします。 |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
|||
| Ipv6EgressRuleId |
string |
送信のみルールの ID です。 |
ipv6py-hp3w98rmlbqp01245**** |
| RequestId |
string |
リクエスト ID です。 |
9DFEDBEE-E5AB-49E8-A2DC-CC114C67AF75 |
例
成功レスポンス
JSONJSON
{
"Ipv6EgressRuleId": "ipv6py-hp3w98rmlbqp01245****",
"RequestId": "9DFEDBEE-E5AB-49E8-A2DC-CC114C67AF75"
}エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | InvalidIpv6Gateway.NotFound | The specified IPv6 gateway was not found. | |
| 400 | IllegalParam.Name | The param of Name [%s] is illegal. | |
| 400 | IllegalParam.Description | The parameter of Description is illegal. | |
| 400 | IllegalParam.InstanceType | The parameter of InstanceType is illegal. | |
| 400 | OperationFailed.FinancialLocked | The operation is forbidden because of financialLocked. | |
| 400 | OperationUnsupported.EgressRuleVSwitch | The specified VSwitch is not supported to create egress-only rule. | |
| 400 | InvalidIpv6Instance.NotFound | The specified resource of InvalidIpv6Instance is not found. | |
| 400 | OperationFailed.NoInternetBandwidth | Operation failed because the ipv6 instance has no internet bandwidth. | |
| 400 | OperationFailed.Ipv6EgressRuleExisted | An egress-only rule already exists for the IPv6 address. | |
| 400 | OperationFailed.InternetBandwidthUnstable | The operation is forbidden because of InternetBandwidthUnstable. | |
| 400 | IncorrectStatus.Ipv6InternetBandwidth | The status of the IPv6InternetBandwidth is incorrect. | |
| 400 | OperationUnsupported.EgressRuleInDefaultSpec | Egress-only rule is not supported. Please update the spec of IPv6 Gateway to Medium or Large. | |
| 400 | QuotaExceeded.Ipv6EgressRules | %s quota exceeded. | |
| 400 | Mismatch.Ipv6AddressAndIpv6Gateway | The %s and %s are mismatched. | |
| 400 | OperationUnsupported.EgressOnlyRuleOnFreeIpv6Instance | Creating ipv6 egress only rule on ipv6 instance that not associated with any resource is unsupported. | |
| 400 | MissingParam.InstanceId | The parameter InstanceId is mandatory. | |
| 400 | InvalidRegionId.NotFound | The specified RegionId does not exist in our records. | |
| 400 | OperationUnsupported.ULA | %s is unsupported. | |
| 400 | OperationUnsupported.PrivateGUA | This operation does not support private GUA addresses. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。