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

Express Connect:CreatePhysicalConnection

最終更新日:Jun 19, 2026

CreatePhysicalConnection 操作を呼び出して、Express Connect 回線を申請します。

操作説明

専用の Express Connect 回線を申請するか、テナント用の共有 Express Connect 回線を申請できます。アプリケーションが完了すると、Express Connect 回線は Initial 状態になります。キャリアに連絡して工事を開始してください。

この操作を呼び出す際は、以下の点にご注意ください:

  • Express Connect 回線を申請する場合、Enabled 状態でない Express Connect 回線の数は 5 を超えることはできません。

  • アカウントに支払い遅延のある Express Connect 回線がある場合、新しい 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:CreatePhysicalConnection

create

*PhysicalConnection

acs:vpc:{#regionId}:{#accountId}:physicalconnection/*

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

RegionId

string

必須

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

DescribeRegions 操作を呼び出して、リージョン ID をクエリできます。

cn-shanghai

AccessPointId

string

必須

Express Connect 回線が配置されているアクセスポイントの ID。

ap-cn-beijing-ft-A

Type

string

任意

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

VPC

LineOperator

string

必須

Express Connect 回線を提供するキャリア。有効な値:

  • CT: China Telecom。

  • CU: China Unicom。

  • CM: China Mobile。

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

  • Equinix: Equinix。

  • Other: 中国以外のその他のキャリア。

CT

bandwidth

integer

任意

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

有効な値: 501002003004005001000200040005000800010000

50

PeerLocation

string

任意

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

XX街道

PortType

string

任意

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

  • 100Base-T: 100M イーサネットポート。

  • 1000Base-T: 1 GE 電気ポート。

  • 1000Base-LX: GE シングルモード光ポート (10 km)。

  • 10GBase-T: 10 GE 電気ポート。

  • 10GBase-LR: 10 GE シングルモード光ポート (10 km)。

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

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

説明

40GBase-LR と 100GBase-LR は、バックエンドの実際のポートの可用性に基づいて作成されます。ポートの可用性の詳細については、アカウントマネージャーにお問い合わせください。

1000Base-T

RedundantPhysicalConnectionId

string

任意

冗長 Express Connect 回線のインスタンス ID。冗長回線は AllocatedConfirmed、または Enabled 状態である必要があります。

pc-119mfjzm****

Description

string

任意

Express Connect 回線の説明。

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

description

Name

string

任意

Express Connect 回線の名前。

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

test

CircuitCode

string

任意

キャリアが Express Connect 回線に対して提供する回線コード。

longtel001

ClientToken

string

任意

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

クライアントからパラメーター値を生成し、異なるリクエスト間でこの値が一意であることを確認してください。ClientToken は ASCII 文字のみをサポートします。

説明

指定しない場合、システムは API リクエストの RequestIdClientToken 識別子として自動的に使用します。API リクエストごとに RequestId は異なります。

123e4567-e89b-12d3-a456-42665544****

ClientToken

string

任意

客户端 Token,用于保证请求的幂等性。

从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符。

説明

若您未指定,则系统自动使用 API 请求的 RequestId 作为 ClientToken 标识。每次 API 请求的 RequestId 不一样。

123e4567-e89b-12d3-a456-42665544****

ResourceGroupId

string

任意

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

rg-acfmoiyermp****

Tag

array<object>

任意

タグのリスト。

object

任意

タグのリスト。

Key

string

任意

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

タグキーは最大 128 文字です。aliyun または acs: で始めることはできず、http:// または https:// を含めることはできません。

FinanceDept

Value

string

任意

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

タグ値は最大 128 文字です。aliyun または acs: で始めることはできず、http:// または https:// を含めることはできません。

FinanceJoshua

DeviceAdvancedCapacity

array

任意

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

string

任意

デバイスの高度な機能のリスト。有効な値:

  • SubifRateLimit: VBR 粒度での帯域幅調整をサポートします。

  • DualStack: IPv6 プロトコルをサポートします。

  • BFD: 転送ポイント間の障害検出ネットワークプロトコルをサポートします。

  • CEN: MP-BGP プロトコルをサポートします。

  • CENv6: MP-BGPv6 プロトコルをサポートします。

  • QOS: QoS をサポートします。

  • MS-HA: 高速スイッチオーバーグループをサポートします。

  • Multi-MS-HA: 複数のスイッチオーバーグループをサポートします。

列挙値:

  • BFD :

    BFD

  • SubifRateLimit :

    SubifRateLimit

  • DualStack :

    DualStack

  • CENv6 :

    CENv6

  • CEN :

    CEN

CENv6

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

レスポンスフィールド

フィールド

説明

object

応答パラメーター。

PhysicalConnectionId

string

Express Connect 回線のインスタンス ID。

pc-bp1ciz7ekd2grn1as****

RequestId

string

リクエスト ID。

8A6A5EC5-6F6C-4906-9689-56ACE58A13E0

成功レスポンス

JSONJSON

{
  "PhysicalConnectionId": "pc-bp1ciz7ekd2grn1as****",
  "RequestId": "8A6A5EC5-6F6C-4906-9689-56ACE58A13E0"
}

エラーコード

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 InvalidAccessPointId.NotEnabled Invalid access point status.
400 ResourceNotFound.AccessPointId The specified resource of access point id is not found.
400 InvalidParameter.DeviceAdvancedCapacity Invalid physical connection device advanced capacity.
404 InvalidPortType.NotFound There are no resources with the portType.

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

変更履歴

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