# equinix\_fabric\_ports (Source de données)

Ressource de données compatible avec l'API Fabric V4 qui permet à l'utilisateur de récupérer les ports par nom ou par uuid.

Documentation complémentaire :

* Pour commencer : <https://docs.equinix.com/fabric/ports/managing-fabric-ports/>
* API : <https://docs.equinix.com/api-catalog/fabricv4/#tag/Ports>

## Exemple d'utilisation[​](#exemple-dutilisation "Direct link to Exemple d'utilisation")

```
data "equinix_fabric_ports" "ports_data_name" {

  filters {

    name = "<name_of_port||port_prefix>"

  }

}





output "id" {

  value = data.equinix_fabric_port.ports_data_name.data.0.id

}



output "name" {

  value = data.equinix_fabric_port.ports_data_name.data.0.name

}



output "state" {

  value = data.equinix_fabric_port.ports_data_name.data.0.state

}



output "account_name" {

  value = data.equinix_fabric_port.ports_data_name.data.0.account.0.account_name

}



output "type" {

  value = data.equinix_fabric_port.ports_data_name.data.0.type

}



output "bandwidth" {

  value = data.equinix_fabric_port.ports_data_name.data.0.bandwidth

}



output "used_bandwidth" {

  value = data.equinix_fabric_port.ports_data_name.data.0.used_bandwidth

}



output "encapsulation_type" {

  value = data.equinix_fabric_port.ports_data_name.data.0.encapsulation.0.type

}



output "ibx" {

  value = data.equinix_fabric_port.ports_data_name.data.0.location.0.ibx

}



output "metro_code" {

  value = data.equinix_fabric_port.ports_data_name.data.0.location.0.metro_code

}



output "metro_name" {

  value = data.equinix_fabric_port.ports_data_name.data.0.location.0.metro_name

}



output "region" {

  value = data.equinix_fabric_port.ports_data_name.data.0.location.0.region

}



output "device_redundancy_enabled" {

  value = data.equinix_fabric_port.ports_data_name.data.0.device.0.redundancy.0.enabled

}



output "device_redundancy_priority" {

  value = data.equinix_fabric_port.ports_data_name.data.0.device.0.redundancy.0.priority

}
```

<!-- -->

## Schéma[​](#schéma "Direct link to Schéma")

### En option[​](#en-option "Direct link to En option")

* `filter` (Block List) Liste d'objets filtres pour l'API SearchPorts. Chaque filtre doit avoir une propriété, un opérateur et une valeur. (voir [ci-dessous pour le schéma imbriqué](#nestedblock--filter))
* `filters` (Block Set, Max : 1, Obsolète) (Obsolète) Utilisez "filter" à la place. (voir [ci-dessous pour le schéma imbriqué](#nestedblock--filters))

### En lecture seule[​](#en-lecture-seule "Direct link to En lecture seule")

* `data` (Liste d'objets) Liste de ports (voir [ci-dessous pour le schéma imbriqué](#nestedatt--data))
* `id` (Chaîne) L'identifiant de cette ressource.

[]()

### Schéma imbriqué pour `filter`[​](#schéma-imbriqué-pour-filter "Direct link to schéma-imbriqué-pour-filter")

Obligatoire :

* `operator` (Chaîne) Opérateur (par exemple =, !=, in, etc.)
* `property` (Chaîne) Chemin d'accès à la propriété (par ex. /name, /uuid, /metroCode, etc.)
* `value` (Chaîne) Valeur à filtrer.

[]()

### Schéma imbriqué pour `filters`[​](#schéma-imbriqué-pour-filters "Direct link to schéma-imbriqué-pour-filters")

Obligatoire :

* `name` (Chaîne) Paramètre de requête pour obtenir les ports par nom

[]()

### Schéma imbriqué pour `data`[​](#schéma-imbriqué-pour-data "Direct link to schéma-imbriqué-pour-data")

En lecture seule :

* `account` (Ensemble d'objets) (voir [ci-dessous pour le schéma imbriqué](#nestedobjatt--data--account))
* `available_bandwidth` (Nombre)
* `bandwidth` (Nombre)
* `change_log` (Ensemble d'objets) (voir [ci-dessous pour le schéma imbriqué](#nestedobjatt--data--change_log))
* `description` (Chaîne)
* `device` (Set of Object) (voir [ci-dessous pour le schéma imbriqué](#nestedobjatt--data--device))
* `encapsulation` (Ensemble d'objets) (voir [ci-dessous pour le schéma imbriqué](#nestedobjatt--data--encapsulation))
* `href` (Chaîne)
* `lag_enabled` (booléen)
* `location` (Ensemble d'objets) (voir [ci-dessous pour le schéma imbriqué](#nestedobjatt--data--location))
* `name` (Chaîne)
* `operation` (Ensemble d'objets) (voir [ci-dessous pour le schéma imbriqué](#nestedobjatt--data--operation))
* `redundancy` (Ensemble d'objets) (voir [ci-dessous pour le schéma imbriqué](#nestedobjatt--data--redundancy))
* `service_type` (Chaîne)
* `state` (Chaîne)
* `type` (Chaîne)
* `used_bandwidth` (Nombre)
* `uuid` (Chaîne)

[]()

### Schéma imbriqué pour `data.account`[​](#schéma-imbriqué-pour-dataaccount "Direct link to schéma-imbriqué-pour-dataaccount")

En lecture seule :

* `account_name` (Chaîne)
* `account_number` (Nombre)
* `global_cust_id` (Chaîne)
* `global_org_id` (Chaîne)
* `global_organization_name` (Chaîne)
* `org_id` (Nombre)
* `organization_name` (Chaîne)
* `ucm_id` (Chaîne)

[]()

### Schéma imbriqué pour `data.change_log`[​](#schéma-imbriqué-pour-datachange_log "Direct link to schéma-imbriqué-pour-datachange_log")

En lecture seule :

* `created_by` (Chaîne)
* `created_by_email` (Chaîne)
* `created_by_full_name` (Chaîne)
* `created_date_time` (Chaîne)
* `deleted_by` (Chaîne)
* `deleted_by_email` (Chaîne)
* `deleted_by_full_name` (Chaîne)
* `deleted_date_time` (Chaîne)
* `updated_by` (Chaîne)
* `updated_by_email` (Chaîne)
* `updated_by_full_name` (Chaîne)
* `updated_date_time` (Chaîne)

[]()

### Schéma imbriqué pour `data.device`[​](#schéma-imbriqué-pour-datadevice "Direct link to schéma-imbriqué-pour-datadevice")

En lecture seule :

* `name` (Chaîne)
* `redundancy` (Ensemble d'objets) (voir [ci-dessous pour le schéma imbriqué](#nestedobjatt--data--device--redundancy))

[]()

### Schéma imbriqué pour `data.device.redundancy`[​](#schéma-imbriqué-pour-datadeviceredundancy "Direct link to schéma-imbriqué-pour-datadeviceredundancy")

En lecture seule :

* `enabled` (booléen)
* `group` (Chaîne)
* `priority` (Chaîne)

[]()

### Schéma imbriqué pour `data.encapsulation`[​](#schéma-imbriqué-pour-dataencapsulation "Direct link to schéma-imbriqué-pour-dataencapsulation")

En lecture seule :

* `tag_protocol_id` (Chaîne)
* `type` (Chaîne)

[]()

### Schéma imbriqué pour `data.location`[​](#schéma-imbriqué-pour-datalocation "Direct link to schéma-imbriqué-pour-datalocation")

En lecture seule :

* `ibx` (Chaîne)
* `metro_code` (Chaîne)
* `metro_name` (Chaîne)
* `region` (Chaîne)

[]()

### Schéma imbriqué pour `data.operation`[​](#schéma-imbriqué-pour-dataoperation "Direct link to schéma-imbriqué-pour-dataoperation")

En lecture seule :

* `connection_count` (Nombre)
* `op_status_changed_at` (Chaîne)
* `operational_status` (Chaîne)

[]()

### Schéma imbriqué pour `data.redundancy`[​](#schéma-imbriqué-pour-dataredundancy "Direct link to schéma-imbriqué-pour-dataredundancy")

En lecture seule :

* `enabled` (booléen)
* `group` (Chaîne)
* `priority` (Chaîne)