equinix_fabric_port（リソース）

Fabric V4 API互換リソースにより、Equinix Fabricポートの作成と管理が可能になります。

追加ドキュメント

はじめに： https://docs.equinix.com/fabric/ports/fabric-order-port/
API: https://docs.equinix.com/api-catalog/fabricv4/#operation/createPort

~>** 注:** このリソースはベータ版であり、変更される可能性があります。ご注意ください。実験的なリソースにはバグが含まれている可能性があり、実稼働環境での使用は推奨されません。

Terraformでポートオーダーを作成した後、ポート予約が発生する保証はありません。
Port Reservation が発生しない場合、Port Order は完了しておらず、Terraform リソースは依存関係として使用できません。
ポート削除は短いプロセスではなく、完了までに2～5営業日かかります。
同じ設定で Terraform リソースを再実行した場合、前回が Completed であったとしても、予約可能な Port にならない可能性がありますのでご注意ください。

使用例

resource "equinix_fabric_port" "order" {
  type = "XF_PORT"
  connectivity_source_type = "COLO"
  location = {
    metro_code = "TR"
  }
  settings = {
    package_type = "STANDARD"
    shared_port_type = false
  }
  encapsulation = {
    type = "DOT1Q"
    tag_protocol_id = "0x8100"
  }
  account = {
    account_number = "<account_number>"
  }
  project = {
    project_id = "<project_id>"
  }
  redundancy = {
    priority = "PRIMARY"
  }
  lag_enabled = true
  physical_ports = [
    {
      type = "XF_PHYSICAL_PORT"
      demarcation_point = {
        ibx = "TR2"
        cage_unique_space_id = "TR2:01:002087"
        cabinet_unique_space_id = "Demarc"
        patch_panel = "PP:Demarc:00002087"
        connector_type = "SC"
      }
    }
  ]
  physical_ports_speed = 1000
  physical_ports_type = "1000BASE_LX"
  physical_ports_count = 1
  demarcation_point_ibx = "TR2"
  notifications = [
    {
      type = "TECHNICAL"
      registered_users = [
        "<username>"
      ]
    },
    {
      type = "NOTIFICATION"
      registered_users = [
        "<username>"
      ]
    }
  ]
  additional_info = [
    {
      key = "lagType"
      value = "New"
    }
  ]
}

スキーマ

必須

account (属性) ポートオーダーのアカウント詳細 (ネストされたスキーマは以下を参照](#nestedatt--account))
connectivity_source_type （文字列）作成後のポートから使用される接続タイプ
demarcation_point_ibx (文字列) ポートが配置される IBX コード
encapsulation (属性) ポートのカプセル化設定 (入れ子になったスキーマは以下を参照](#nestedatt--encapsulation))
lag_enabled （論理値）作成したポートをリンクアグリゲーショングループで有効にするための論理値。
location (属性) ポートオーダーの場所の詳細 (ネストされたスキーマは下記参照)(#nestedatt--location)
notifications (属性リスト) 通知タイプと、それらの通知タイプを受け取る登録ユーザーのリスト (入れ子のスキーマは下記参照](#nestedatt--notifications))
physical_ports (属性リスト) このポートオーダーを実装する物理ポート (ネストされたスキーマは以下を参照](#nestedatt--physical_ports))
physical_ports_count (Number) ポートオーダーの物理ポート数
physical_ports_speed（数）物理ポート速度（Mbps
physical_ports_type (文字列) 物理ポートのタイプ
project (属性) ポートオーダープロジェクトの詳細 (入れ子になったスキーマは以下を参照](#nestedatt--project))
redundancy (属性) ポートの冗長性の設定 (入れ子になったスキーマは以下を参照](#nestedatt--redundancy))
settings (属性) ポートオーダーコンフィギュレーション設定 (ネストされたスキーマは以下を参照](#nestedatt--settings))
type （文字列）ポート注文要求のタイプ

オプション

additional_info (属性リスト) ポートオーダーに追加のコンテキストを提供するためのキー/値オブジェクトのリスト（入れ子になったスキーマについては下記を参照）。
device (属性) ポートデバイス構成 (入れ子になったスキーマは以下を参照](#nestedatt--device))
name （文字列）ポートの指定名
order (属性) purchaseOrder の詳細や署名など、ポートオーダーの詳細 (入れ子スキーマは下記参照)(#nestedatt--order)
timeouts (属性) (入れ子になったスキーマは以下を参照](#nestedatt--timeouts))

読み取り専用

change_log (属性) ポートリソースの最後の変更の詳細 (入れ子になったスキーマは以下を参照](#nestedatt--change_log))
href （文字列） Equinixが割り当てたポートリソースのURI
id （文字列）リソースの一意な識別子
state （文字列）ポートリソースのプロビジョニングステータスを表す値
uuid （文字列）エクイニクスが割り当てたポートリソースの一意識別子

`account`の入れ子スキーマ

必須

account_number （番号）ポートが作成されるアカウント番号

読み取り専用：

account_name (String) 口座名義人の正式名称。
ucm_id （文字列）エンタープライズデータストア ID

`encapsulation`の入れ子スキーマ

必須

tag_protocol_id （文字列）ポートカプセル化タグプロトコル識別子
type （文字列）ポートのカプセル化プロトコルタイプ

`location`の入れ子スキーマ

必須

metro_code （文字列）ポートが作成されるメトロコード

`notifications`の入れ子スキーマ

必須

registered_users （文字列のリスト）ポートでこの通知タイプを受信する登録ユーザーの配列
type (文字列) 通知タイプ

`physical_ports`の入れ子スキーマ

必須

demarcation_point (属性) 顧客の物理ポート (入れ子になったスキーマは以下を参照](#nestedatt--physical_ports--demarcation_point))
type （文字列）物理ポートタイプ

オプション

interface (属性) 物理ポートインターフェース (ネストされたスキーマは以下を参照](#nestedatt--physical_ports--interface))

`physical_ports.demarcation_point`の入れ子スキーマ

必須

cabinet_unique_space_id （文字列）ポートキャビネット固有のスペース ID
cage_unique_space_id （文字列）ポートケージ一意のスペース ID
connector_type （文字列）ポートコネクタタイプ
ibx （文字列）物理ポートの IBX メトロコード
patch_panel (文字列) ポートパッチパネル

`physical_ports.interface`の入れ子スキーマ

オプション

type （文字列）物理ポートのインターフェイスタイプ

`project`の入れ子スキーマ

必須

project_id (String) ポートが作成されるプロジェクト ID

`redundancy`の入れ子スキーマ

必須

priority （文字列）ポート冗長優先度値

`settings`の入れ子スキーマ

必須

package_type (文字列) 注文するポートの請求パッケージ
shared_port_type （論理値）顧客専用ケージか共有ニュートラルケージかを示します。

`additional_info`の入れ子スキーマ

必須

key （文字列）キー/値ペアのキー名。
value (String) キーと値のペアの値。

`device`の入れ子スキーマ

オプション

name （文字列）ポートのデバイス名
redundancy (属性) デバイスの冗長構成 (入れ子になったスキーマは以下を参照](#nestedatt--device--redundancy))

`device.redundancy`の入れ子スキーマ

オプション

group （文字列）冗長グループ識別子
priority (文字列) 冗長優先度 (PRIMARY または SECONDARY)

`order`の入れ子スキーマ

オプション

customer_reference_id (String) 顧客注文参照 ID
purchase_order (属性) 購入オーダーの詳細 (入れ子になったスキーマは以下を参照](#nestedatt--order--purchase_order))
signature (属性) ポート注文確認署名の詳細 (入れ子になったスキーマは以下を参照](#nestedatt--order--signature))

読み取り専用：

order_id (文字列) オーダー ID
order_number (文字列) 注文参照番号
uuid （文字列） Equinixが割り当てたオーダー識別子、これは派生レスポンス属性です。

`order.purchase_order`の入れ子スキーマ

読み取り専用：

amount (文字列) 購入注文金額
attachment_id (String) 発注書添付 ID
end_date (文字列) 購入注文終了日
number (文字列) 購入注文番号
start_date (文字列) 購入注文開始日
type (文字列) 購入注文タイプ

`order.signature`の入れ子スキーマ

必須

delegate (属性) 代議員オーダーの詳細 (入れ子になったスキーマは以下を参照](#nestedatt--order--signature--delegate))
signatory （文字列）ポート署名タイプ

`order.signature.delegate`の入れ子スキーマ

必須

email （文字列）署名者の電子メール

オプション

first_name （文字列）署名者の名前
last_name （文字列）署名者の姓

`timeouts`の入れ子スキーマ

オプション

create (String) "30s "や "2h45m "などの数字と単位接尾辞で構成される期間として解析できる文字列。有効な時間単位は、"s" (秒)、"m" (分)、"h" (時間) です。
delete (文字列) "30s "や "2h45m "などの数字と単位の接尾辞で構成される期間として解析できる文字列。有効な時間単位は、"s" (秒)、"m" (分)、"h" (時間) です。削除操作にタイムアウトを設定することは、破棄操作が発生する前に変更が状態に保存されている場合にのみ適用されます。
read (文字列) "30s "や "2h45m "などの数字と単位の接尾辞で構成される期間として解析できる文字列。有効な時間単位は "s"（秒）、"m"（分）、"h"（時間）です。読み取り操作は、リフレッシュが有効になっている場合、リフレッシュまたはプランニング操作中に発生します。
update (String) "30s "や "2h45m "などの数字と単位接尾辞で構成される期間として解析できる文字列。有効な時間単位は、"s" (秒)、"m" (分)、"h" (時間) です。

`change_log`の入れ子スキーマ

読み取り専用：

created_by （文字列）ポートリソースの作成者のユーザー名
created_by_email （文字列）ポートリソースの作成者の電子メール
created_by_full_name （文字列）ポートリソースの作成者の法的名前
created_date_time （文字列）ポートリソースの作成時間
deleted_by （文字列）ポートリソースの削除者のユーザー名
deleted_by_email （文字列）ポートリソースの削除者の電子メール
deleted_by_full_name （文字列）ポートリソースの削除者の法的名前
deleted_date_time （文字列）ポートリソースの削除時間
updated_by （文字列）ポートリソースの最終更新者のユーザー名。
updated_by_email （文字列）ポートリソースの最終更新者の電子メール
updated_by_full_name （文字列）ポートリソースの最終更新者の正式名。
updated_date_time （文字列）ポートリソースの最終更新時間

使用例​

スキーマ​

必須​

オプション​

読み取り専用​

accountの入れ子スキーマ​

encapsulationの入れ子スキーマ​

locationの入れ子スキーマ​

notificationsの入れ子スキーマ​

physical_portsの入れ子スキーマ​

physical_ports.demarcation_pointの入れ子スキーマ​

physical_ports.interfaceの入れ子スキーマ​

projectの入れ子スキーマ​

redundancyの入れ子スキーマ​

settingsの入れ子スキーマ​

additional_infoの入れ子スキーマ​

deviceの入れ子スキーマ​

device.redundancyの入れ子スキーマ​

orderの入れ子スキーマ​

order.purchase_orderの入れ子スキーマ​

order.signatureの入れ子スキーマ​

order.signature.delegateの入れ子スキーマ​

timeoutsの入れ子スキーマ​

change_logの入れ子スキーマ​

使用例

スキーマ

必須

オプション

読み取り専用

`account`の入れ子スキーマ

`encapsulation`の入れ子スキーマ

`location`の入れ子スキーマ

`notifications`の入れ子スキーマ

`physical_ports`の入れ子スキーマ

`physical_ports.demarcation_point`の入れ子スキーマ

`physical_ports.interface`の入れ子スキーマ

`project`の入れ子スキーマ

`redundancy`の入れ子スキーマ

`settings`の入れ子スキーマ

`additional_info`の入れ子スキーマ

`device`の入れ子スキーマ

`device.redundancy`の入れ子スキーマ

`order`の入れ子スキーマ

`order.purchase_order`の入れ子スキーマ

`order.signature`の入れ子スキーマ

`order.signature.delegate`の入れ子スキーマ

`timeouts`の入れ子スキーマ

`change_log`の入れ子スキーマ