すべてのプロダクト
Search

このプロダクト

    Cloud Firewall:CreateAckClusterConnector

    ドキュメントセンター

    Cloud Firewall:CreateAckClusterConnector

    最終更新日:Aug 14, 2026

    ACK クラスター コネクタを作成します。

    操作説明

    QPS 制限

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

    今すぐお試しください

    この 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:CreateAckClusterConnector

    create

    *すべてのリソース。

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    MemberUid

    string

    任意

    ACK クラスターリソースが属するアカウントの Alibaba Cloud UID。

    135809047715****
    RegionNo

    string

    必須

    ACK クラスターコネクタのリージョン ID。次の API を呼び出して値を取得できます：

    説明

    Cloud Firewall の ACK クラスターコネクタがサポートするリージョンの詳細については、「ACK クラスター同期ノード」をご参照ください。

    cn-hangzhou。
    ConnectorName

    string

    必須

    ACK クラスターコネクタの名前。名前の長さは 1～64 文字で、漢字、大文字、小文字、数字、ピリオド (.) 、アンダースコア (_) 、ハイフン (-) を使用できます。

    ack-クラスター-コネクタ-name
    ClusterId

    string

    必須

    ACK クラスターの ID。次の API を呼び出して値を取得できます：

    cb0f5640b1b2d404cad6ba21509d7847b。
    PrimaryVswitchId

    string

    必須

    ACK クラスターコネクタのプライマリ vSwitch。次の API を呼び出して値を取得できます：

    vsw-2zerfbbje7dvnbii2****
    PrimaryVswitchIp

    string

    任意

    ACK クラスターコネクタのプライマリ vSwitch の IP アドレス。

    10.100.1.1
    StandbyVswitchId

    string

    任意

    ACK クラスターコネクタのスタンバイ vSwitch。次の API を呼び出して値を取得できます：

    vsw-2ze2gtlfozrab01cfo****
    StandbyVswitchIp

    string

    任意

    ACK クラスターコネクタのスタンバイ vSwitch の IP アドレス。

    10.100.2.1
    Ttl

    string

    必須

    ACK クラスターコネクタの同期間隔 (単位：秒) 。有効な値の範囲は 2～60 です。

    30

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    AckClusterConnector

    object

    ACK クラスターコネクタのレスポンスボディです。

    ConnectorId

    string

    ACK クラスターコネクタの一意の ID です。

    ac-7c1bad6c3cc84c33baab。
    ConnectorName

    string

    ACK クラスターコネクタの名前です。名前は 1～64 文字で、中国語の文字、大文字と小文字、数字、ピリオド (.)、アンダースコア (_)、ハイフン (-) を含めることができます。

    ack-クラスター-コネクタ-name
    MemberUid

    string

    ACK クラスターリソースが属する Alibaba Cloud アカウントの UID です。

    135809047715****
    RegionNo

    string

    ACK クラスターコネクタのリージョン ID です。次の API を呼び出して値を取得できます。

    説明

    Cloud Firewall の ACK クラスターコネクタでサポートされているリージョンの詳細については、「ACK クラスター同期ノード」をご参照ください。

    cn-shanghai。
    ClusterId

    string

    ACK クラスターの ID です。次の API を呼び出して値を取得できます。

    cb0f5640b1b2d404cad6ba21509d7847b。
    ClusterName

    string

    ACK クラスターの名前です。

    ack-クラスター-name
    VpcId

    string

    ACK クラスターが属する VPC タイプのインスタンスの ID です。

    vpc-j6cvhdscntzuvr0x****
    PrimaryVswitchId

    string

    ACK クラスターコネクタのプライマリ vSwitch です。次の API を呼び出して値を取得できます。

    vsw-2zerfbbje7dvnbii2****
    PrimaryVswitchZoneId

    string

    ACK クラスターコネクタのプライマリ vSwitch のゾーンです。次の API を呼び出して値を取得できます。

    cn-hangzhou-g。
    PrimaryVswitchIp

    string

    ACK クラスターコネクタのプライマリ vSwitch の IP アドレスです。

    10.100.1.1
    StandbyVswitchId

    string

    ACK クラスターコネクタのスタンバイ vSwitch です。次の API を呼び出して値を取得できます。

    vsw-2ze2gtlfozrab01cfo****
    StandbyVswitchZoneId

    string

    ACK クラスターコネクタのスタンバイ vSwitch のゾーンです。次の API を呼び出して値を取得できます。

    cn-hangzhou-h。
    StandbyVswitchIp

    string

    ACK クラスターコネクタのスタンバイ vSwitch の IP アドレスです。

    10.100.2.1
    Ttl

    integer

    ACK クラスターコネクタの同期間隔です。有効な値は 2～60 で、単位は秒です。

    30
    ConnectorStatus

    string

    ACK クラスターコネクタのインスタンスステータスです。有効な値は次のとおりです。

    • init：初期化中。

    • deleting：削除中。

    • ready：正常。

    列挙値:

    • init :

      initializing.

    • deleting :

      deleting.

    • ready :

      normal.

    ready。
    ConnectorHealthCheckStatus

    string

    ACK クラスターコネクタのヘルスチェックステータスです。有効な値は次のとおりです。

    • init：初期化中。

    • healthy：正常。

    列挙値:

    • init :

      initializing.

    • healthy :

      healthy.

    • unhealthy :

      unhealthy.

    healthy。
    AckClientHostIp

    string

    ACK クラスターコネクタが内部ネットワーク経由で ACK クラスターにアクセスするために使用する、エントリポイントの IP アドレスです。

    10.40.32.240
    TaskId

    string

    ACK クラスターコネクタを作成する一意のタスク ID です。

    タスク-c92d4544ef7b6a42
    CreateTime

    string

    ACK クラスターコネクタが作成されたときのタイムスタンプです。単位は秒です。

    1724982259
    RequestId

    string

    リクエスト ID です。

    0DC783F1-B3A7-578D-8A63-*****

    例

    成功レスポンス

    JSONJSON

    {
  "AckClusterConnector": {
    "ConnectorId": "ac-7c1bad6c3cc84c33baab。",
    "ConnectorName": "ack-クラスター-コネクタ-name",
    "MemberUid": "135809047715****",
    "RegionNo": "cn-shanghai。",
    "ClusterId": "cb0f5640b1b2d404cad6ba21509d7847b。",
    "ClusterName": "ack-クラスター-name",
    "VpcId": "vpc-j6cvhdscntzuvr0x****",
    "PrimaryVswitchId": "vsw-2zerfbbje7dvnbii2****",
    "PrimaryVswitchZoneId": "cn-hangzhou-g。",
    "PrimaryVswitchIp": "10.100.1.1",
    "StandbyVswitchId": "vsw-2ze2gtlfozrab01cfo****",
    "StandbyVswitchZoneId": "cn-hangzhou-h。",
    "StandbyVswitchIp": "10.100.2.1",
    "Ttl": 30,
    "ConnectorStatus": "ready。",
    "ConnectorHealthCheckStatus": "healthy。",
    "AckClientHostIp": "10.40.32.240",
    "TaskId": "タスク-c92d4544ef7b6a42",
    "CreateTime": "1724982259"
  },
  "RequestId": "0DC783F1-B3A7-578D-8A63-*****"
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 ErrorVSwitchAndPrivateIpAddressMismatched The vSwitch and privateIpAddress are mismatched.
    400 ErrorAckClusterNotFound The specified resource ACK cluster is not found.
    400 ErrorAckClusterConnectorReverseEndpointIpNotAllocated The IP is already allocated, failed to create reverse endpoint.
    400 ErrorParametersUid The aliUid parameter is invalid.
    400 ErrorParameters Parameters error.
    400 ErrorRegionNo regionNo error.
    400 ErrorDBSelect An error occurred while querying database.
    400 ErrorVswitchNoAvailableIP the vswitch has no available ip.
    400 ErrorVswitchNotFound vswitch not found
    400 ErrorDBInsert An error occurred while performing an insert operation in the database.
    400 ErrorAckClusterNetworkOnlySupportTerway The ACK cluster network only support Terway.
    400 ErrorAckVpcAndVSwitchVpcMismatched The ACK VPC and vSwitch VPC are mismatched.
    400 ErrorPrimaryStandbyVswitchSameZone The primary and standby vSwitch are in the same availability zone.
    400 ErrorAckClusterSpecOnlySupportAckPro The ACK cluster spec only support ack.pro.small.
    400 ErrorAckClusterConnectorQuotaExceeded ACK cluster connector resource exceeds the quota limit.
    400 ErrorAckNotOpen ACK service is not open.
    400 ErrorAckClusterConnectorExist The ACK cluster connector already exist.
    400 MissingParameter.ClusterId ClusterId is required and must not be empty.
    400 InvalidParameter.ClusterId The specified ClusterId is not a valid ACK cluster identifier.
    400 InvalidParameter.Ttl The value of Ttl must be between 2 and 60.
    400 ErrorOpenApiError An OpenAPI interface error occurred.

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

    変更履歴

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