# equinix\_fabric\_port (Ressource)
La ressource compatible API Fabric V4 permet la création et la gestion de ports Equinix Fabric
Documentation complémentaire :
* Pour commencer :
* API :
\~> \*\* REMARQUE :\*\* Cette ressource est en version bêta et peut être modifiée. Utiliser avec prudence. La ressource expérimentale peut contenir des bogues et n'est pas recommandée pour une utilisation en production.
* Il n'y a aucune garantie qu'une réservation de port se produise après la création d'une commande de port via Terraform.
* Si une réservation de port n'a pas lieu, la commande de port n'est pas complète et la ressource Terraform ne pourra pas être utilisée comme dépendance.
* La suppression des ports n'est pas un processus rapide et peut prendre de 2 à 5 jours ouvrables.
* Une nouvelle exécution de la ressource Terraform avec les mêmes paramètres peut ne pas générer de port disponible pour la réservation, même si le port précédent a été terminé
## Exemple d'utilisation[](#exemple-dutilisation "Lien direct vers Exemple d'utilisation")
```
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 = ""
}
project = {
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 = [
""
]
},
{
type = "NOTIFICATION"
registered_users = [
""
]
}
]
additional_info = [
{
key = "lagType"
value = "New"
}
]
}
```
## Schéma[](#schéma "Lien direct vers Schéma")
### Obligatoire[](#obligatoire "Lien direct vers Obligatoire")
* `account` (Attributs) Détails du compte de commande de port (voir [ci-dessous pour le schéma imbriqué](#nestedatt--account) )
* `connectivity_source_type` (Chaîne) type de connexion utilisé à partir du port après la création
* `demarcation_point_ibx` (Chaîne) Code IBX où le port sera situé
* `encapsulation` (Attributs) Paramètres d'encapsulation de port (voir [ci-dessous pour le schéma imbriqué](#nestedatt--encapsulation) )
* `lag_enabled` (Booléen) valeur booléenne pour activer le port créé avec des groupes d'agrégation de liens
* `location` (Attributs) Détails de l'emplacement pour la commande de port (voir [ci-dessous pour le schéma imbriqué](#nestedatt--location) )
* `notifications` (Liste des attributs) liste des types de notification et des utilisateurs enregistrés devant recevoir ces types de notification (voir [ci-dessous pour le schéma imbriqué](#nestedatt--notifications) )
* `physical_ports` (Liste des attributs) ports physiques qui mettront en œuvre cette commande de ports (voir [ci-dessous pour le schéma imbriqué](#nestedatt--physical_ports) )
* `physical_ports_count` (Number) nombre de ports physiques dans la commande de ports
* `physical_ports_speed` (Nombre) vitesse des ports physiques en Mbit/s.
* `physical_ports_type` (Chaîne) type de ports physiques
* `project` (Attributs) Détails du projet de commande de port (voir [ci-dessous pour le schéma imbriqué](#nestedatt--project) )
* `redundancy` (Attributs) Paramètres de redondance des ports (voir [ci-dessous pour le schéma imbriqué](#nestedatt--redundancy) )
* `type` (Chaîne) type de la demande de commande de port
### Facultatif[](#facultatif "Lien direct vers Facultatif")
* `order` (Attributs) Détails de la commande de port tels que les détails de la commande d'achat et la signature (voir [ci-dessous pour le schéma imbriqué](#nestedatt--order) )
* `timeouts` (Attributs) (voir [ci-dessous pour le schéma imbriqué](#nestedatt--timeouts) )
### En lecture seule[](#en-lecture-seule "Lien direct vers En lecture seule")
* `additional_info` (Liste des attributs) liste des objets clé/valeur pour fournir un contexte supplémentaire à la commande de port (voir [ci-dessous pour le schéma imbriqué](#nestedatt--additional_info) )
* `change_log` (Attributs) Détails de la dernière modification sur la ressource de port (voir [ci-dessous pour le schéma imbriqué](#nestedatt--change_log) )
* `device` (Attributs) Configuration du dispositif de port (voir [ci-dessous pour le schéma imbriqué](#nestedatt--device) )
* `href` (Chaîne) URI attribué par Equinix à la ressource de port
* `id` (Chaîne) identifiant unique de la ressource
* `name` (Chaîne) nom désigné du port
* `state` (Chaîne) représentant l'état de provisionnement de la ressource de port
* `uuid` (Chaîne) Equinix a attribué un identifiant unique à la ressource de port
[]()
### Schéma imbriqué pour `account`[](#schéma-imbriqué-pour-account "Lien direct vers schéma-imbriqué-pour-account")
Obligatoire :
* `account_number` (Numéro) numéro de compte pour lequel le port sera créé
En lecture seule :
* `account_name` (Chaîne) nom légal du titulaire de compte.
* `ucm_id` (Chaîne) identifiant du datastore d'entreprise
[]()
### Schéma imbriqué pour `encapsulation`[](#schéma-imbriqué-pour-encapsulation "Lien direct vers schéma-imbriqué-pour-encapsulation")
Obligatoire :
* `tag_protocol_id` (Chaîne) identifiant de protocole de balise d'encapsulation de port
* `type` (Chaîne) type de protocole d'encapsulation de port
[]()
### Schéma imbriqué pour `location`[](#schéma-imbriqué-pour-location "Lien direct vers schéma-imbriqué-pour-location")
Obligatoire :
* `metro_code` (Chaîne) Code métropolitain dans lequel le port sera créé
[]()
### Schéma imbriqué pour `notifications`[](#schéma-imbriqué-pour-notifications "Lien direct vers schéma-imbriqué-pour-notifications")
Obligatoire :
* `registered_users` (Liste de chaînes) Tableau d'utilisateurs enregistrés qui recevront ce type de notification sur le port
* `type` (Chaîne) type de notification
[]()
### Schéma imbriqué pour `physical_ports`[](#schéma-imbriqué-pour-physical_ports "Lien direct vers schéma-imbriqué-pour-physical_ports")
Obligatoire :
* `demarcation_point` (Attributs) Port physique du client (voir [ci-dessous pour le schéma imbriqué](#nestedatt--physical_ports--demarcation_point) )
* `type` (Chaîne) type de port physique
Facultatif :
* `interface` (Attributs) interface de port physique (voir [ci-dessous pour le schéma imbriqué](#nestedatt--physical_ports--interface) )
[]()
### Schéma imbriqué pour `physical_ports.demarcation_point`[](#schéma-imbriqué-pour-physical_portsdemarcation_point "Lien direct vers schéma-imbriqué-pour-physical_portsdemarcation_point")
Obligatoire :
* `cabinet_unique_space_id` (Chaîne) identifiant d'espace unique de l'armoire de ports
* `cage_unique_space_id` (Chaîne) identifiant d'espace unique de la cage de port
* `connector_type` (Chaîne) type de connecteur de port
* `ibx` (Chaîne) Code IBX Metro pour le port physique
* `patch_panel` (String) panneau de brassage de port
[]()
### Schéma imbriqué pour `physical_ports.interface`[](#schéma-imbriqué-pour-physical_portsinterface "Lien direct vers schéma-imbriqué-pour-physical_portsinterface")
Facultatif :
* `type` (Chaîne) type d'interface pour le port physique
[]()
### Schéma imbriqué pour `project`[](#schéma-imbriqué-pour-project "Lien direct vers schéma-imbriqué-pour-project")
Obligatoire :
* `project_id` (Chaîne) identifiant de projet dans lequel le port sera créé
[]()
### Schéma imbriqué pour `redundancy`[](#schéma-imbriqué-pour-redundancy "Lien direct vers schéma-imbriqué-pour-redundancy")
Obligatoire :
* `priority` (Chaîne) valeur de priorité de redondance de port
[]()
### Schéma imbriqué pour `order`[](#schéma-imbriqué-pour-order "Lien direct vers schéma-imbriqué-pour-order")
Facultatif :
* `customer_reference_id` (Chaîne) identifiant de référence de commande client
* `purchase_order` (Attributs) Détails du bon de commande (voir [ci-dessous pour le schéma imbriqué](#nestedatt--order--purchase_order) )
* `signature` (Attributs) Détails de la signature de confirmation de commande de port (voir [ci-dessous pour le schéma imbriqué](#nestedatt--order--signature) )
[]()
### Schéma imbriqué pour `order.purchase_order`[](#schéma-imbriqué-pour-orderpurchase_order "Lien direct vers schéma-imbriqué-pour-orderpurchase_order")
En lecture seule :
* `amount` (Chaîne) montant du bon de commande
* `attachment_id` (Chaîne) identifiant de pièce jointe du bon de commande
* `end_date` (Chaîne) date de fin du bon de commande
* `number` (String) numéro de bon de commande
* `start_date` (Chaîne) date de début du bon de commande
* `type` (Chaîne) type de bon de commande
[]()
### Schéma imbriqué pour `order.signature`[](#schéma-imbriqué-pour-ordersignature "Lien direct vers schéma-imbriqué-pour-ordersignature")
Obligatoire :
* `delegate` (Attributs) détails de la commande déléguée (voir [ci-dessous pour le schéma imbriqué](#nestedatt--order--signature--delegate) )
* `signatory` (Chaîne) type de signature de port
[]()
### Schéma imbriqué pour `order.signature.delegate`[](#schéma-imbriqué-pour-ordersignaturedelegate "Lien direct vers schéma-imbriqué-pour-ordersignaturedelegate")
Obligatoire :
* `email` (String) E-mail du signataire
Facultatif :
* `first_name` (Chaîne) Prénom du signataire
* `last_name` (Chaîne) nom de famille du signataire
[]()
### Schéma imbriqué pour `timeouts`[](#schéma-imbriqué-pour-timeouts "Lien direct vers schéma-imbriqué-pour-timeouts")
Facultatif :
* `create` (Chaîne) chaîne qui peut être [analysée sous la forme d'une durée](https://pkg.go.dev/time#ParseDuration) composée de nombres et de suffixes d'unités, tels que « 30s » ou « 2h45m ». Les unités de temps valides sont « s » (secondes), « m » (minutes), « h » (heures).
* `delete` (Chaîne) chaîne qui peut être [analysée sous la forme d'une durée](https://pkg.go.dev/time#ParseDuration) composée de nombres et de suffixes d'unités, tels que « 30s » ou « 2h45m ». Les unités de temps valides sont « s » (secondes), « m » (minutes), « h » (heures). La définition d'un délai d'expiration pour une opération de suppression n'est applicable que si les modifications sont enregistrées dans l'état avant que l'opération de destruction ne se produise.
* `read` (Chaîne) chaîne qui peut être [analysée sous la forme d'une durée](https://pkg.go.dev/time#ParseDuration) composée de nombres et de suffixes d'unités, tels que « 30s » ou « 2h45m ». Les unités de temps valides sont « s » (secondes), « m » (minutes), « h » (heures). Les opérations de lecture se produisent lors de toute opération d'actualisation ou de planification lorsque l'actualisation est activée.
* `update` (Chaîne) chaîne qui peut être [analysée sous la forme d'une durée](https://pkg.go.dev/time#ParseDuration) composée de nombres et de suffixes d'unités, tels que « 30s » ou « 2h45m ». Les unités de temps valides sont « s » (secondes), « m » (minutes), « h » (heures).
[]()
### Schéma imbriqué pour `additional_info`[](#schéma-imbriqué-pour-additional_info "Lien direct vers schéma-imbriqué-pour-additional_info")
En lecture seule :
* `key` (Chaîne) le nom de clé de la paire clé/valeur
* `value` (Chaîne) la valeur de la paire clé/valeur
[]()
### Schéma imbriqué pour `change_log`[](#schéma-imbriqué-pour-change_log "Lien direct vers schéma-imbriqué-pour-change_log")
En lecture seule :
* `created_by` (Chaîne) nom d'utilisateur du créateur de la ressource de port
* `created_by_email` (Chaîne) E-mail du créateur de la ressource de port
* `created_by_full_name` (Chaîne) nom légal du créateur de la ressource de port
* `created_date_time` (Chaîne) heure de création de la ressource de port
* `deleted_by` (String) nom d'utilisateur du deleter de la ressource de port
* `deleted_by_email` (String) E-mail de l'expéditeur de la ressource de port
* `deleted_by_full_name` (String) nom légal de la personne qui a supprimé la ressource de port
* `deleted_date_time` (Chaîne) heure de suppression de la ressource de port
* `updated_by` (Chaîne) nom d'utilisateur du dernier programme de mise à jour de la ressource de port
* `updated_by_email` (Chaîne) E-mail du dernier programme de mise à jour de la ressource de port
* `updated_by_full_name` (Chaîne) nom légal du dernier programme de mise à jour de la ressource de port
* `updated_date_time` (String) heure de la dernière mise à jour de la ressource de port
[]()
### Schéma imbriqué pour `device`[](#schéma-imbriqué-pour-device "Lien direct vers schéma-imbriqué-pour-device")
En lecture seule :
* `name` (Chaîne) nom du dispositif pour le port
* `redundancy` (Attributs) Configuration de la redondance des dispositifs (voir [ci-dessous pour le schéma imbriqué](#nestedatt--device--redundancy) )
[]()
### Schéma imbriqué pour `device.redundancy`[](#schéma-imbriqué-pour-deviceredundancy "Lien direct vers schéma-imbriqué-pour-deviceredundancy")
Facultatif :
* `group` (Chaîne) identifiant du groupe de redondance
* `priority` (Chaîne) priorité de redondance (PRINCIPALE ou SECONDAIRE)