すべてのプロダクト
Search

このプロダクト

    Express Connect:CreateHighReliablePhysicalConnection

    ドキュメントセンター

    Express Connect:CreateHighReliablePhysicalConnection

    最終更新日:Jun 19, 2026

    ゾーン冗長モードでExpress Connect回線を作成し、Alibaba Cloud上のワークロードへのマルチライン接続の安定性を確保し、マルチラインディザスタリカバリによる単一ライン障害に起因するサービス中断を回避します。

    操作説明

    ポートを購入する際、ワークロードにディザスタリカバリ機能を提供するために、次の3つの組み合わせタイプのいずれかを選択できます。

    • 最大ディザスタリカバリ：2つのアクセスポイントでリソースを申請し、4つの独立したExpress Connect 回線接続を確立します。最大ディザスタリカバリのSLA 可用性は99.99%以上です。

    • 拡張ディザスタリカバリ：2つのアクセスポイントでリソースを申請し、2つの独立したExpress Connect 回線接続を確立します。拡張ディザスタリカバリのSLA 可用性は99.95%以上です。

    • 開発およびテスト：1つのアクセスポイントでリソースを申請し、2つの独立したExpress Connect 回線接続を確立します。

    今すぐお試しください

    この 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 ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    vpc:CreateHighReliablePhysicalConnection

    create

    *全部资源

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    RegionId

    string

    任意

    Express Connect 回線のリージョンID。

    DescribeRegions オペレーションを呼び出して、リージョンIDを照会できます。

    cn-shanghai
    ClientToken

    string

    任意

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

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

    説明

    このパラメーターを指定しない場合、システムはAPIリクエストのRequestIdをClientTokenとして自動的に使用します。RequestIdはAPIリクエストごとに異なる場合があります。

    123e4567-e89b-12d3-a456-426655440000
    ClientToken

    string

    任意

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

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

    説明

    このパラメーターを指定しない場合、システムはAPIリクエストのRequestIdをClientTokenとして自動的に使用します。RequestIdはAPIリクエストごとに異なる場合があります。

    123e4567-e89b-12d3-a456-426655440000
    ResourceGroupId

    string

    任意

    Express Connect 回線が属するリソースグループのID。

    rg-acfmxazb4p****
    Tag

    array<object>

    任意

    タグ。

    object

    任意

    タグ。

    Key

    string

    任意

    リソースのタグキー。最大 20 個のタグキーを指定できます。タグキーを空文字列にすることはできません。

    タグキーの長さは最大 64 文字で、英字または中国語の文字で始まる必要があります。数字、ピリオド（.）、アンダースコア（_）、ハイフン（-）を含めることができます。aliyunまたはacs:で始めることはできず、http://またはhttps://を含めることはできません。

    FinanceDept
    Value

    string

    任意

    リソースのタグ値。最大 20 個のタグ値を指定できます。タグ値は空文字列にすることができます。

    タグ値の長さは最大 128 文字で、英字または中国語の文字で始まる必要があります。数字、ピリオド（.）、アンダースコア（_）、ハイフン（-）を含めることができます。aliyunまたはacs:で始めることはできず、http://またはhttps://を含めることはできません。

    FinanceJoshua
    HighReliableType

    string

    必須

    ゾーン冗長モード。有効な値：

    • MultiApMultiDevice：最大ディザスタリカバリ。このモードは、2つの異なるアクセスポイントと2つの異なるデバイスをサポートし、最大限のディザスタリカバリを提供します。

    • MultiApSingleDevice：拡張ディザスタリカバリ。このモードは、2つの異なるアクセスポイントと1つのデバイスをサポートし、拡張ディザスタリカバリを提供します。

    • SingleApMultiDevice：開発およびテスト。このモードは、1つのアクセスポイントと2つのデバイスをサポートします。このモードは、非クリティカルなワークロードの開発とテストにのみ推奨されます。

    • SingleApMultiConnection：高帯域幅ロードバランシング。このモードは、ホワイトリストに登録されたユーザーのみが利用できます。1つのアクセスポイント、1つのデバイス、および複数の物理ポートをサポートします。このモードを使用するには、アカウントマネージャーにお問い合わせください。

    MultiApMultiDevice
    PortType

    string

    必須

    Express Connect 回線のポートタイプ。有効な値：

    • 1000Base-LX：GEシングルモード光ポート（10 km）。

    • 10GBase-LR：10 GEシングルモード光ポート（10 km）。

    • 40GBase-LR：40 GEシングルモード光ポート。

    • 100GBase-LR：100 GEシングルモード光ポート。

    説明

    40GBase-LRおよび100GBase-LRは、実際のポートの可用性に依存します。ポートの可用性については、アカウントマネージャーにお問い合わせください。

    1000Base-LX
    DeviceAdvancedCapacity

    array

    任意

    デバイスの高度な機能のリスト。

    string

    任意

    デバイスの高度な機能。有効な値：

    • SubifRateLimit：VBRレート制限。

    • DualStack：IPv6サポート。

    • BFD：双方向フォワーディング検出。

    • CEN：マルチプロトコルBGPサポート。

    • CENv6：マルチプロトコルBGPv6サポート。

    • QOS：QoSサポート。

    • MS-HA：高速フェイルオーバーグループサポート。

    • Multi-MS-HA：複数フェイルオーバーグループサポート。

    SubifRateLimit
    ApList

    array<object>

    必須

    アクセスポイントのリスト。

    object

    任意

    アクセスポイントのリスト。

    Name

    string

    任意

    Express Connect 回線の名前。

    名前の長さは2〜128 文字で、英字または中国語の文字で始まる必要があります。数字、アンダースコア（_）、ハイフン（-）を含めることができますが、http://またはhttps://で始めることはできません。

    test
    Description

    string

    任意

    Express Connect 回線の説明。

    説明の長さは2〜256 文字で、英字または中国語の文字で始まる必要がありますが、http://またはhttps://で始めることはできません。

    description
    RegionId

    string

    必須

    Express Connect 回線のリージョンID。

    DescribeRegions オペレーションを呼び出して、リージョンIDを照会できます。

    cn-shanghai
    LineOperator

    string

    必須

    Express Connect 回線の接続プロバイダー。有効な値：

    • CT：China Telecom。

    • CU：China Unicom。

    • CM：China Mobile。

    • CO：その他の中国キャリア。

    • Equinix：Equinix。

    • Other：中国本土以外のその他のキャリア。

    CT
    AccessPointId

    string

    必須

    Express Connect 回線のアクセスポイントのID。

    説明

    HighReliableTypeがMultiApMultiDeviceまたはMultiApSingleDeviceに設定されている場合、2つの異なるアクセスポイントを指定する必要があります。HighReliableTypeがSingleApMultiDeviceまたはSingleApMultiConnectionに設定されている場合、1つのアクセスポイントを指定する必要があります。

    ap-cn-beijing-ft-A
    PortNum

    integer

    任意

    ポートの数。このパラメーターは、HighReliableTypeがSingleApMultiConnectionに設定されている場合にのみ必要です。有効な値：2〜16。

    2
    Type

    string

    任意

    Express Connect 回線のタイプ。デフォルト値：VPC。

    VPC
    Bandwidth

    integer

    任意

    共有 Express Connect 回線の帯域幅。単位：Mbit/s。

    有効な値：50、100、200、300、400、500、1000、2000、4000、5000、8000、10000。

    50
    PeerLocation

    string

    任意

    オンプレミスデータセンターの地理的位置。

    XX街道
    CircuitCode

    string

    任意

    Express Connect 回線の接続プロバイダーが提供する回線コード。

    longtel001
    OpticalModuleModel

    string

    任意

    Express Connect 回線のアクセスポイントがサポートする光モジュールモデル。有効な値：

    • 1000Base-LX:

      • SFP-GE-LR-SM1310,10KM

      • SFP-GE-ER-SM1310,40KM

      • SFP-GE-ZR-SM1550,80KM

    • 10GBase-LR:

      • SFP-10G-LR-SM1310,10KM

      • SFP-10G-ER-SM1550,40KM

      • SFP-10G-ZR-SM1550,80KM

    • 40GBase-LR:

      • QSFP-40G-LR4-WDM1300,10KM

      • QSFP-40G-ER4-WDM1300,40KM

      • QSFP-40G-ZR4-WDM1300,80KM

    • 100GBase-LR:

      • QSFP28-100G-LR4-WDM1300,10KM

      • QSFP28-100G-ER4-WDM1300,40KM

      • QSFP28-100G-ZR4-WDM1300,80KM。

    SFP-GE-LR-SM1310,10KM
    DryRun

    string

    任意

    ドライランを実行するかどうかを指定します。有効な値：

    • true：インスタンスを作成せずにドライランを実行します。システムは、必須パラメーター、リクエスト形式、およびインスタンスのステータスを確認します。確認に失敗した場合、エラーコードDRYRUN.FAILと対応するエラーリストが返されます。確認に成功した場合、コードDRYRUN.SUCCESSが返されます。

    • false（デフォルト）：リクエストを送信します。リクエストが確認に合格した後、インスタンスが作成されます。

    false
    AcceptLanguage

    string

    任意

    レスポンスの言語。有効な値：

    • zh-CN（デフォルト）：中国語。

    • en-US：英語。

    zh-CN

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    レスポンスパラメーター。

    PhysicalConnectionList

    object

    physicalConnectionList

    array<object>

    Express Connect 回線インスタンスのリスト。

    object

    Express Connect 回線インスタンスのリスト。

    InstanceId

    string

    Express Connect 回線インターフェイスの ID です。

    pc-j5e5qqo616p81ncsp****
    RegionNo

    string

    Express Connect 回線インターフェイスのリージョン ID です。

    cn-shanghai
    RequestId

    string

    リクエストID。

    0ED8D006-F706-4D23-88ED-E11ED28DCAC0
    ErrorInfoList

    object

    errorInfoList

    array<object>

    ドライランが失敗した場合に返されるエラーコードとエラーメッセージ。すべてのエラー情報が返されます。含まれるエラー：

    • pconn.high.reliable.dryrun.error.disable.outbound.data.transfer.billing：ユーザーのアウトバウンドデータ転送課金が有効になっていません。

    • pconn.high.reliable.dryrun.error.incompatable.device.capacity：選択されたアクセスポイントに、デバイスの高度な機能要件を満たすデバイスがありません。

    • pconn.high.reliable.dryrun.error.quota.exceeded：ユーザークォータが不足しています。

    • pconn.high.reliable.dryrun.error.not.enough.resource：アクセスポイントのリソースが不足しています。

    object

    エラーコード。

    ErrorCode

    string

    エラーコードです。

    pconn.high.reliable.dryrun.error.disable.outbound.data.transfer.billing
    ErrorMessage

    string

    返されたエラーメッセージです。

    pconn.high.reliable.dryrun.error.disable.outbound.data.transfer.billing
    InstanceId

    string

    Express Connect 回線インターフェイスの ID です。

    pc-j5e5qqo616p81ncsp****

    例

    成功レスポンス

    JSONJSON

    {
  "PhysicalConnectionList": {
    "physicalConnectionList": [
      {
        "InstanceId": "pc-j5e5qqo616p81ncsp****",
        "RegionNo": "cn-shanghai"
      }
    ]
  },
  "RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0",
  "ErrorInfoList": {
    "errorInfoList": [
      {
        "ErrorCode": "pconn.high.reliable.dryrun.error.disable.outbound.data.transfer.billing",
        "ErrorMessage": "pconn.high.reliable.dryrun.error.disable.outbound.data.transfer.billing",
        "InstanceId": "pc-j5e5qqo616p81ncsp****"
      }
    ]
  }
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 Invalid.Status The device or interface status invalid, or has been used..
    400 InvalidType.Malformd The Type provided was invalid.
    400 InvalidPeerLocation.Malformd The PeerLocation provided was invalid.
    400 InvalidLineOperator.Malformd The LineOperator provided was invalid.
    400 InvalidPortType.Malformd The PortType provided was invalid.
    400 InvalidDescription.Malformed The specifid ?Description? is not valid.
    400 InvalidRedundantPhysicalConnectionId.NotFound The RedundantPhysicalConnectionId does not found.
    400 InvalidName.Malformed The specified ?Name? is not valid.
    400 QuotaExceeded.pConnPerAP Physical connection count per ap quota exceed.
    400 InvalidBandwidth invalid physical connection banwidth.
    400 InvalidRedundantPhysicalConnection redundant physical connection doesn't belong to current user.
    400 InvalidRedundantPhysicalConnectionStatus invalid redundant physical connection status.
    400 InvalidCircuitCode.Malformed circuitCode is illegal.
    400 QuotaExceeded.freePconnPerAP free physical connections count excceeded.
    400 InvalidPhysicalConnectionOperator.Malformed Specified PhysicalConnection Operator is not valid.
    400 InvalidPhysicalConnectionPortType.Malformed Specified PhysicalConnection PortType is not valid.
    400 InvalidPhysicalConnectionBandwidth.Malformed Specified PhysicalConnection Bandwidth is not valid.
    400 IllegalParam.ClientToken Token verify failed because client token length too long.
    400 InvalidPortType.NotFound Specified port type is not found.
    400 OperationFailed.PconnTrafficNotEnable The operation is failed because of PconnTrafficNotEnable. クラウドトラフィックがアクティブ化されていないため、操作は失敗しました。
    400 EcNotSupportRegion High reliable physical connection is not support in this region.
    400 EcFailToGetAp Fail to get access point details.
    400 EcNotEnoughResource Insufficient access point resources.
    400 IllegalParam.UnsupportedAccessPoint The access point type does not support the creation of a highly reliable physical connection.
    400 ResourceNotFound.AccessPointId The specified resource of access point id is not found.
    400 IllegalParam.%s The param of %s is illegal.
    404 InvalidPortType.NotFound There are no resources with the portType.

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

    変更履歴

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