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 : https://docs.equinix.com/fabric/ports/fabric-order-port/
- API : https://docs.equinix.com/api-catalog/fabricv4/#operation/createPort
~> ** REMARQUE :** Cette ressource est en version bêta et peut être modifiée. Veuillez l'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.
- Veuillez noter qu'une nouvelle exécution de la ressource Terraform avec les mêmes paramètres peut ne pas aboutir à un port disponible pour la réservation, même si la précédente était terminée.
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 = "<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"
}
]
}
Schéma
Obligatoire
account(Attributs) Détails du compte de commande de port (voir ci-dessous pour le schéma imbriqué )connectivity_source_type(Chaîne) type de connexion utilisé à partir du port après la créationdemarcation_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é )lag_enabled(Booléen) valeur booléenne pour activer le port créé avec des groupes d'agrégation de lienslocation(Attributs) Détails de l'emplacement pour la commande de port (voir ci-dessous pour le schéma imbriqué )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é )physical_ports(Liste des attributs) ports physiques qui mettront en œuvre cette commande de ports (voir ci-dessous pour le schéma imbriqué )physical_ports_count(Number) nombre de ports physiques dans la commande de portsphysical_ports_speed(Nombre) vitesse des ports physiques en Mbit/s.physical_ports_type(Chaîne) type de ports physiquesproject(Attributs) Détails du projet de commande de port (voir ci-dessous pour le schéma imbriqué )redundancy(Attributs) Paramètres de redondance des ports (voir ci-dessous pour le schéma imbriqué )type(Chaîne) type de la demande de commande de port
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é )timeouts(Attributs) (voir ci-dessous pour le schéma imbriqué )
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é )change_log(Attributs) Détails de la dernière modification sur la ressource de port (voir ci-dessous pour le schéma imbriqué )device(Attributs) Configuration du dispositif de port (voir ci-dessous pour le schéma imbriqué )href(Chaîne) URI attribué par Equinix à la ressource de portid(Chaîne) identifiant unique de la ressourcename(Chaîne) nom désigné du portstate(Chaîne) représentant l'état de provisionnement de la ressource de portuuid(Chaîne) Equinix a attribué un identifiant unique à la ressource de port
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
Obligatoire :
tag_protocol_id(Chaîne) identifiant de protocole de balise d'encapsulation de porttype(Chaîne) type de protocole d'encapsulation de port
Schéma imbriqué pour location
Obligatoire :
metro_code(Chaîne) Code métropolitain dans lequel le port sera créé
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 porttype(Chaîne) type de notification
Schéma imbriqué pour physical_ports
Obligatoire :
demarcation_point(Attributs) Port physique du client (voir ci-dessous pour le schéma imbriqué )type(Chaîne) type de port physique
Facultatif :
interface(Attributs) interface de port physique (voir ci-dessous pour le schéma imbriqué )
Schéma imbriqué pour physical_ports.demarcation_point
Obligatoire :
cabinet_unique_space_id(Chaîne) identifiant d'espace unique de l'armoire de portscage_unique_space_id(Chaîne) identifiant d'espace unique de la cage de portconnector_type(Chaîne) type de connecteur de portibx(Chaîne) Code IBX Metro pour le port physiquepatch_panel(String) panneau de brassage de port
Schéma imbriqué pour physical_ports.interface
Facultatif :
type(Chaîne) type d'interface pour le port physique
Schéma imbriqué pour project
Obligatoire :
project_id(Chaîne) identifiant de projet dans lequel le port sera créé
Schéma imbriqué pour redundancy
Obligatoire :
priority(Chaîne) valeur de priorité de redondance de port
Schéma imbriqué pour order
Facultatif :
customer_reference_id(Chaîne) identifiant de référence de commande clientpurchase_order(Attributs) Détails du bon de commande (voir ci-dessous pour le schéma imbriqué )signature(Attributs) Détails de la signature de confirmation de commande de port (voir ci-dessous pour le schéma imbriqué )
Schéma imbriqué pour order.purchase_order
En lecture seule :
amount(Chaîne) montant du bon de commandeattachment_id(Chaîne) identifiant de pièce jointe du bon de commandeend_date(Chaîne) date de fin du bon de commandenumber(String) numéro de bon de commandestart_date(Chaîne) date de début du bon de commandetype(Chaîne) type de bon de commande
Schéma imbriqué pour order.signature
Obligatoire :
delegate(Attributs) détails de la commande déléguée (voir ci-dessous pour le schéma imbriqué )signatory(Chaîne) type de signature de port
Schéma imbriqué pour order.signature.delegate
Obligatoire :
email(String) E-mail du signataire
Facultatif :
first_name(Chaîne) Prénom du signatairelast_name(Chaîne) nom de famille du signataire
Schéma imbriqué pour timeouts
Facultatif :
create(Chaîne) chaîne qui peut être analysée sous la forme d'une durée 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 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 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 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
En lecture seule :
key(Chaîne) le nom de clé de la paire clé/valeurvalue(Chaîne) la valeur de la paire clé/valeur
Schéma imbriqué pour change_log
En lecture seule :
created_by(Chaîne) nom d'utilisateur du créateur de la ressource de portcreated_by_email(Chaîne) E-mail du créateur de la ressource de portcreated_by_full_name(Chaîne) nom légal du créateur de la ressource de portcreated_date_time(Chaîne) heure de création de la ressource de portdeleted_by(String) nom d'utilisateur du deleter de la ressource de portdeleted_by_email(String) E-mail de l'expéditeur de la ressource de portdeleted_by_full_name(String) nom légal de la personne qui a supprimé la ressource de portdeleted_date_time(Chaîne) heure de suppression de la ressource de portupdated_by(Chaîne) nom d'utilisateur du dernier programme de mise à jour de la ressource de portupdated_by_email(Chaîne) E-mail du dernier programme de mise à jour de la ressource de portupdated_by_full_name(Chaîne) nom légal du dernier programme de mise à jour de la ressource de portupdated_date_time(String) heure de la dernière mise à jour de la ressource de port
Schéma imbriqué pour device
En lecture seule :
name(Chaîne) nom du dispositif pour le portredundancy(Attributs) Configuration de la redondance des dispositifs (voir ci-dessous pour le schéma imbriqué )
Schéma imbriqué pour device.redundancy
Facultatif :
group(Chaîne) identifiant du groupe de redondancepriority(Chaîne) priorité de redondance (PRINCIPALE ou SECONDAIRE)