すべてのプロダクト
Search
ドキュメントセンター

Express Connect:CreateHighReliablePhysicalConnection

最終更新日:Aug 03, 2026

Alibaba Cloud へのマルチ回線アクセスによるサービスの安定性を確保し、マルチ回線のディザスタリカバリによって単一回線障害によるサービス中断を防ぐため、ゾーン冗長モードで Express Connect 回線を作成します。

操作説明

ポートを購入する際、以下の 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

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 Street

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.. Status パラメーターが無効です。
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. 説明の長さは 2~256 文字で、http:// または https:// で始まることはできません。
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. Express Connect 回線に対する操作が無効です。
400 InvalidPhysicalConnectionPortType.Malformed Specified PhysicalConnection PortType is not valid. Express Connect 回線のポートタイプが無効です。
400 InvalidPhysicalConnectionBandwidth.Malformed Specified PhysicalConnection Bandwidth is not valid. Express Connect 回線に関連付けられた帯域幅の値が無効です。
400 IllegalParam.ClientToken Token verify failed because client token length too long. ClientToken パラメーターが無効です。
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. このリージョンでは、高可用性 Express Connect 回線を一時的に購入できません。
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. アクセスポイントタイプは、高可用性 Express Connect 回線の作成をサポートしていません。
400 ResourceNotFound.AccessPointId The specified resource of access point id is not found. 現在のアクセスポイント情報が存在しません。情報を確認して、もう一度お試しください。
400 IllegalParam.%s The param of %s is illegal. 指定されたパラメーターが無効です。
400 UnsupportedFeature.LinkDelay The feature of LinkDelay is not supported. 状態トランジション遅延コマンドは現在サポートされていません。
404 InvalidPortType.NotFound There are no resources with the portType. 指定されたポートタイプが存在しません。

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

変更履歴

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