Create Trunk#

トランクを作成します。

APIエンドポイント#

リージョン APIエンドポイント
西日本リージョン3の場合 https://networking.jp-west-3.cloud.global.fujitsu.com
東日本リージョン3の場合 https://networking.jp-east-3.cloud.global.fujitsu.com

HTTPメソッドとURI#

POST

/v2.0/trunks

HTTPステータスコード#

正常時:201

エラー時:400, 401, 404, 409

リクエストパラメータの説明#

名前 In Type デフォルト値
/必須指定
Description
tenant_id body string 必須 プロジェクトID
project_id body string 必須 プロジェクトID
port_id body string 必須 親ポートのID
name body string 任意 リソース名
description body string 任意 リソースの説明
admin_state_up body boolean 任意 リソースの管理状態
デフォルトは「up(true)」です。
「down(false)」を指定した場合、サブポートの追加や削除、またはトランクの削除の操作が抑止されます。
sub_ports body array 必須 トランクと関連付けられているポートのリスト

レスポンスボディ(正常系)の説明#

名前 Type Description
admin_state_up boolean リソースの管理状態
「down(false)」が指定されていた場合、サブポートの追加や削除、またはトランクの削除の操作が抑止されます。
created_at string リソースの作成日時(UTC ISO8601形式)
description string リソースの説明
id string リソースのID
name string リソース名
port_id string 親のポートのID
revision_number integer リソースの改定番号
status string トランクのステータス
有効値は「ACTIVE」、「DOWN」、「BUILD」、「DEGRADED」と「ERROR」です。
作成時点では「DOWN」が表示されます。接続しているポート(親ポート・サブポート)が正常であれば「ACTIVE」と表示されます。
※トランクに対してサブポートを削除すると、既に接続されている他のサブポートが正常状態であっても「DOWN」と表示されることがあります。その際は、既に接続されているサブポートのうち1つを一度削除し、再追加してみてください。
tenant_id string プロジェクトID
project_id string プロジェクトID
sub_ports array トランクと関連付けられているポートのリスト
updated_at string リソースの最終更新日(UTC ISO8601形式)

リクエスト例#

{
    "trunk": {
        "port_id": "8027c4da-772f-4e43-bfbf-023b4a4e63de",
        "name": "test",
        "admin_state_up": true
    }
}

レスポンス例#

{
    "trunk": {
        "status": "DOWN",
        "sub_ports": [],
        "name": "test",
        "admin_state_up": true,
        "project_id": "145a14e4a64b49bf98baad8945dbd4f1",
        "tenant_id": "145a14e4a64b49bf98baad8945dbd4f1",
        "created_at": "2016-10-05T22:31:37Z",
        "updated_at": "2016-10-05T22:31:37Z",
        "revision_number": 1,
        "port_id": "8027c4da-772f-4e43-bfbf-023b4a4e63de",
        "id": "114a26b1-d124-4835-bb4f-021d3d886023",
        "description": ""
    }
}