PutDisableFwSwitch を使用したファイアウォールスイッチの無効化 - Cloud Firewall - Alibaba Cloud - Cloud Firewall

ファイアウォールスイッチを無効にします。

操作説明

ファイアウォールスイッチを無効にします。ファイアウォールスイッチが無効になると、トラフィックは Cloud Firewall を通過しません。

QPS 制限

この操作の単一ユーザー QPS 制限は、1 秒あたり 10 回の呼び出しです。制限を超えると、API 呼び出しがスロットリングされ、ビジネスに影響を与える可能性があります。必要に応じてこの操作を呼び出してください。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

yundun-cloudfirewall:PutDisableFwSwitch

update

*すべてのリソース。

*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
SourceIp `deprecated`	string	任意	リクエストのソース IP アドレス。	192.0.XX.XX
Lang	string	任意	受信するメッセージの言語タイプ。有効な値: zh (デフォルト): 中国語 en: 英語	zh
IpaddrList	array	任意	IP アドレスリスト。説明 IpaddrList、RegionList、ResourceTypeList パラメーターをすべて空にすることはできません。これらのパラメーターのうち少なくとも 1 つに値を指定する必要があります。	["192.0.XX.XX","192.0.XX.XX"]
	string	任意	IP アドレス。	192.0.XX.XX
RegionList	array	任意	リージョンリスト。説明 IpaddrList、RegionList、ResourceTypeList パラメーターをすべて空にすることはできません。これらのパラメーターのうち少なくとも 1 つに値を指定する必要があります。	["cn-hangzhou","cn-shanghai"]
	string	任意	リージョン ID。	cn-hangzhou
ResourceTypeList	array	任意	アセットタイプリスト。有効な値: BastionHostEgressIP: Bastion Host のソース IP アドレス。 BastionHostIngressIP: Bastion Host の宛先 IP アドレス。 EcsEIP: ECS EIP。 EcsPublicIP: Elastic Compute Service (ECS) インスタンスのパブリック IP アドレス。 EIP: Elastic IP Address。 EniEIP: ネットワークインターフェースコントローラー (NIC) EIP。 NatEIP: NAT EIP。 SlbEIP: SLB EIP (CLB EIP)。 SlbPublicIP: SLB パブリック IP アドレス (CLB パブリック IP アドレス)。 NatPublicIP: NAT パブリック IP アドレス。 HAVIP: アクティブな仮想 IP アドレス。 NlbEIP: NLB EIP。 ApiGatewayEIP: API Gateway パブリック IP アドレス。 AlbEIP: ALB EIP。 AiGatewayEIP: AI Gateway パブリック IP アドレス。 GaEIP: GA EIP。 SwasEIP: シンプルアプリケーションサーバーパブリック IP アドレス。 EcdEIP: Elastic Desktop Service パブリック IP アドレス。 BastionHostIP: Bastion Host IP アドレス。説明 IpaddrList、RegionList、ResourceTypeList パラメーターをすべて空にすることはできません。設定項目でこれらのパラメーターのうち少なくとも 1 つに値を指定する必要があります。	["EcsPublicIp","NatEip"]
	string	任意	アセットタイプリスト。有効な値: BastionHostEgressIP: Bastion Host のソース IP アドレス。 BastionHostIngressIP: Bastion Host の宛先 IP アドレス。 EcsEIP: ECS EIP。 EcsPublicIP: Elastic Compute Service (ECS) インスタンスのパブリック IP アドレス。 EIP: Elastic IP Address。 EniEIP: ネットワークインターフェースコントローラー (NIC) EIP。 NatEIP: NAT EIP。 SlbEIP: SLB EIP (CLB EIP)。 SlbPublicIP: SLB パブリック IP アドレス (CLB パブリック IP アドレス)。 NatPublicIP: NAT パブリック IP アドレス。 HAVIP: アクティブな仮想 IP アドレス。 NlbEIP: NLB EIP。 ApiGatewayEIP: API Gateway パブリック IP アドレス。 AlbEIP: ALB EIP。 AiGatewayEIP: AI Gateway パブリック IP アドレス。 GaEIP: GA EIP。 SwasEIP: シンプルアプリケーションサーバーパブリック IP アドレス。 EcdEIP: Elastic Desktop Service パブリック IP アドレス。 BastionHostIP: Bastion Host IP アドレス。説明 IpaddrList、RegionList、ResourceTypeList パラメーターをすべて空にすることはできません。設定項目でこれらのパラメーターのうち少なくとも 1 つに値を指定する必要があります。	EcsPublicIP
MemberUid	string	任意	メンバーアカウントの一意の識別子。	1234
IpVersion	string	任意	IP バージョン。	4
ClientToken	string	任意	リクエストの冪等性を保証するクライアントトークン。クライアントによって生成されるトークンは、異なるリクエスト間で一意である必要があります。値は [0-9a-zA-Z-_]{1,64} のフォーマットの大文字と小文字を区別する文字列です。UUID の使用を推奨します。サーバーは有効期間内 (600 秒) に冪等性を保証します。同じ ClientToken と同じビジネスパラメーターを持つ繰り返しリクエストは、最初のリクエストと同じ結果を返します。同じ ClientToken が異なるビジネスパラメーターで使用された場合、IdempotentParameterMismatch エラーコードを含む HTTP 400 エラーが返されます。	defefedxexxxx
DryRun	boolean	任意	ドライランのみを実行するかどうかを指定します。このパラメーターを true に設定すると、システムは実際のリソースの作成、更新、削除、非同期トラフィック迂回タスクのトリガー、または課金、通知、コールバックなどのダウンストリーム副作用の生成を行わずに、パラメーターの有効性、ID 権限、リソースの存在、クォータ制限、依存関係などの事前チェックを実行します。ドライランが成功した場合、応答に DryRun=true が返され、実際の呼び出し応答と区別できます。ドライランが失敗した場合、機械可読なエラーコードが返されます (パラメーターエラーの場合は ErrorParamsInvalid、権限不足の場合は ErrorAuthentication、クォータ不足の場合は ErrorInstanceOpenIpNumExceed など)。このパラメーターを false (デフォルト) に設定すると、リクエストが開始され、無効化操作が実行されます。	true

この操作を呼び出す際は、本トピックで説明されているリクエストパラメーターに加えて、Alibaba Cloud 共通リクエストパラメーターを含める必要があります。共通パラメーターの詳細については、「共通パラメーター」を参照してください。この操作のリクエストフォーマットについては、「使用例」セクションのリクエスト例を参照してください。

レスポンスフィールド

フィールド	型	説明	例
	object
RequestId	string	リクエスト ID。	B2841452-CB8D-4F7D-B247-38E1CF7334F8
DryRun	boolean	ドライランのみが実行されたかどうかを示します。このパラメーターが true の場合、システムは実際のリソースの作成、更新、削除、非同期トラフィック迂回タスクのトリガー、または課金、通知、コールバックなどのダウンストリーム副作用の生成を行わずに、パラメーターの有効性、ID 権限、リソースの存在、クォータ制限、依存関係などの事前チェックを実行しました。ドライランが成功した場合、応答に DryRun=true が返され、実際の呼び出し応答と区別できます。ドライランが失敗した場合、機械可読なエラーコードが返されます (パラメーターエラーの場合は ErrorParamsInvalid、権限不足の場合は ErrorAuthentication、クォータ不足の場合は ErrorInstanceOpenIpNumExceed など)。false (デフォルト) の値は、リクエストが開始され、有効化操作が実行されたことを示します。	true

例

成功レスポンス

JSONJSON

{
  "RequestId": "B2841452-CB8D-4F7D-B247-38E1CF7334F8",
  "DryRun": true
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ
400	ErrorParamsNotEnough	Parameters are insufficient.
400	ErrorDBSelect	An error occurred while querying database.
400	ErrorInstanceStatusNotNormal	This operation is not supported when the instance is in the current state.
400	ErrorRecordLog	An error occurred while updating the operation log.
400	IdempotentParameterMismatch	The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.
400	InvalidClientToken	ClientToken format invalid. Only ASCII letters, digits, hyphens and underscores are allowed, max 64 characters.
401	ErrorAuthentication	An authentication error occurred.
409	IdempotentToken.Processing	A previous request with the same ClientToken is still being processed.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。