equinix · displague · Jul 1, 2022 · Jun 29, 2022 · Jun 29, 2022
diff --git a/docs/data-sources/connection.md b/docs/data-sources/connection.md
@@ -5,15 +5,17 @@ description: |-
   Retrieve Equinix Fabric Connection
 ---
 
-# metal\_connection
+# metal_connection (Data Source)
+
+!> **PROVIDER DEPRECATED:** Equinix Metal Provider is now Deprecated. Please consider using [`equinix_metal_connection`](https://registry.terraform.io/providers/equinix/equinix/latest/docs/data-sources/equinix_metal_connection) data source from the [Equinix provider](https://registry.terraform.io/providers/equinix/equinix/latest/docs) instead of `metal_connection`. [See the Metal provider section for more details](../index.md#equinix-metal-provider) on the new provider and available migration guides.
 
 Use this data source to retrieve a connection resource from [Equinix Fabric - software-defined interconnections](https://metal.equinix.com/developers/docs/networking/fabric/)
 
 ## Example Usage
 
 ```hcl
 data "metal_connection" "example" {
-  connection_id     = "4347e805-eb46-4699-9eb9-5c116e6a017d"
+  connection_id     = "4347e805-eb46-4699-9eb9-5c116e6a017d" 
 }
 ```
 

diff --git a/docs/data-sources/device.md b/docs/data-sources/device.md
@@ -5,7 +5,9 @@ description: |-
   Provides an Equinix Metal device datasource. This can be used to read existing devices.
 ---
 
-# metal_device
+# metal_device (Data Source)
+
+!> **PROVIDER DEPRECATED:** Equinix Metal Provider is now Deprecated. Please consider using [`equinix_metal_device`](https://registry.terraform.io/providers/equinix/equinix/latest/docs/data-sources/equinix_metal_device) data source from the [Equinix provider](https://registry.terraform.io/providers/equinix/equinix/latest/docs) instead of `metal_device`. [See the Metal provider section for more details](../index.md#equinix-metal-provider) on the new provider and available migration guides.
 
 Provides an Equinix Metal device datasource.
 

diff --git a/docs/data-sources/device_bgp_neighbors.md b/docs/data-sources/device_bgp_neighbors.md
@@ -5,7 +5,9 @@ description: |-
   Provides a datasource for listing BGP neighbors of an Equinix Metal device
 ---
 
-# metal_device_bgp_neighbors
+# metal_device_bgp_neighbors (Data Source)
+
+!> **PROVIDER DEPRECATED:** Equinix Metal Provider is now Deprecated. Please consider using [`equinix_metal_device_bgp_neighbors`](https://registry.terraform.io/providers/equinix/equinix/latest/docs/data-sources/equinix_metal_device_bgp_neighbors) data source from the [Equinix provider](https://registry.terraform.io/providers/equinix/equinix/latest/docs) instead of `metal_device_bgp_neighbors`. [See the Metal provider section for more details](../index.md#equinix-metal-provider) on the new provider and available migration guides.
 
 Use this datasource to retrieve list of BGP neighbors of a device in the Equinix Metal host.
 

diff --git a/docs/data-sources/facility.md b/docs/data-sources/facility.md
@@ -5,7 +5,9 @@ description: |-
   Provides an Equinix Metal facility datasource. This can be used to read facilities.
 ---
 
-# metal_facility
+# metal_facility (Data Source)
+
+!> **PROVIDER DEPRECATED:** Equinix Metal Provider is now Deprecated. Please consider using [`equinix_metal_facility`](https://registry.terraform.io/providers/equinix/equinix/latest/docs/data-sources/equinix_metal_facility) data source from the [Equinix provider](https://registry.terraform.io/providers/equinix/equinix/latest/docs) instead of `metal_facility`. [See the Metal provider section for more details](../index.md#equinix-metal-provider) on the new provider and available migration guides.
 
 Provides an Equinix Metal facility datasource.
 

diff --git a/docs/data-sources/gateway.md b/docs/data-sources/gateway.md
@@ -5,7 +5,9 @@ description: |-
   Retrieve Equinix Metal Gateways
 ---
 
-# metal\_gateway
+# metal_gateway (Data Source)
+
+!> **PROVIDER DEPRECATED:** Equinix Metal Provider is now Deprecated. Please consider using [`equinix_metal_gateway`](https://registry.terraform.io/providers/equinix/equinix/latest/docs/data-sources/equinix_metal_gateway) data source from the [Equinix provider](https://registry.terraform.io/providers/equinix/equinix/latest/docs) instead of `metal_gateway`. [See the Metal provider section for more details](../index.md#equinix-metal-provider) on the new provider and available migration guides.
 
 Use this datasource to retrieve Metal Gateway resources in Equinix Metal.
 

diff --git a/docs/data-sources/hardware_reservation.md b/docs/data-sources/hardware_reservation.md
@@ -5,7 +5,9 @@ description: |-
   Retrieve Equinix Metal Hardware Reservation
 ---
 
-# metal_hardware_reservation
+# metal_hardware_reservation (Data Source)
+
+!> **PROVIDER DEPRECATED:** Equinix Metal Provider is now Deprecated. Please consider using [`equinix_metal_hardware_reservation`](https://registry.terraform.io/providers/equinix/equinix/latest/docs/data-sources/equinix_metal_hardware_reservation) data source from the [Equinix provider](https://registry.terraform.io/providers/equinix/equinix/latest/docs) instead of `metal_hardware_reservation`. [See the Metal provider section for more details](../index.md#equinix-metal-provider) on the new provider and available migration guides.
 
 Use this data source to retrieve a [hardware reservation resource from Equinix Metal](https://metal.equinix.com/developers/docs/deploy/reserved/).
 

diff --git a/docs/data-sources/ip_block_ranges.md b/docs/data-sources/ip_block_ranges.md
@@ -5,7 +5,9 @@ description: |-
   List IP address ranges allocated to a project
 ---
 
-# metal\_ip\_block\_ranges
+# metal_ip_block_ranges (Data Source)
+
+!> **PROVIDER DEPRECATED:** Equinix Metal Provider is now Deprecated. Please consider using [`equinix_metal_ip_block_ranges`](https://registry.terraform.io/providers/equinix/equinix/latest/docs/data-sources/equinix_metal_ip_block_ranges) data source from the [Equinix provider](https://registry.terraform.io/providers/equinix/equinix/latest/docs) instead of `metal_ip_block_ranges`. [See the Metal provider section for more details](../index.md#equinix-metal-provider) on the new provider and available migration guides.
 
 Use this datasource to get CIDR expressions for allocated IP blocks of all the types in a project, optionally filtered by facility or metro.
 

diff --git a/docs/data-sources/metro.md b/docs/data-sources/metro.md
@@ -5,7 +5,9 @@ description: |-
   Provides an Equinix Metal metro datasource. This can be used to read metros.
 ---
 
-# metal_metro
+# metal_metro (Data Source)
+
+!> **PROVIDER DEPRECATED:** Equinix Metal Provider is now Deprecated. Please consider using [`equinix_metal_metro`](https://registry.terraform.io/providers/equinix/equinix/latest/docs/data-sources/equinix_metal_metro) data source from the [Equinix provider](https://registry.terraform.io/providers/equinix/equinix/latest/docs) instead of `metal_metro`. [See the Metal provider section for more details](../index.md#equinix-metal-provider) on the new provider and available migration guides.
 
 Provides an Equinix Metal metro datasource.
 

diff --git a/docs/data-sources/operating_system.md b/docs/data-sources/operating_system.md
@@ -5,7 +5,9 @@ description: |-
   Get an Equinix Metal operating system image
 ---
 
-# metal\_operating\_system
+# metal_operating_system (Data Source)
+
+!> **PROVIDER DEPRECATED:** Equinix Metal Provider is now Deprecated. Please consider using [`equinix_metal_operating_system`](https://registry.terraform.io/providers/equinix/equinix/latest/docs/data-sources/equinix_metal_operating_system) data source from the [Equinix provider](https://registry.terraform.io/providers/equinix/equinix/latest/docs) instead of `metal_operating_system`. [See the Metal provider section for more details](../index.md#equinix-metal-provider) on the new provider and available migration guides.
 
 Use this data source to get Equinix Metal Operating System image.
 

diff --git a/docs/data-sources/organization.md b/docs/data-sources/organization.md
@@ -5,7 +5,9 @@ description: |-
   Provides an Equinix Metal Organization datasource. This can be used to read existing Organizations.
 ---
 
-# metal_organization
+# metal_organization (Data Source)
+
+!> **PROVIDER DEPRECATED:** Equinix Metal Provider is now Deprecated. Please consider using [`equinix_metal_organization`](https://registry.terraform.io/providers/equinix/equinix/latest/docs/data-sources/equinix_metal_organization) data source from the [Equinix provider](https://registry.terraform.io/providers/equinix/equinix/latest/docs) instead of `metal_organization`. [See the Metal provider section for more details](../index.md#equinix-metal-provider) on the new provider and available migration guides.
 
 Provides an Equinix Metal organization datasource.
 

diff --git a/docs/data-sources/plans.md b/docs/data-sources/plans.md
@@ -5,7 +5,9 @@ description: |-
   Provides an Equinix Metal plans datasource. This can be used to find plans that meet a filter criteria.
 ---
 
-# metal_plans
+# metal_plans (Data Source)
+
+!> **PROVIDER DEPRECATED:** Equinix Metal Provider is now Deprecated. Please consider using [`equinix_metal_plans`](https://registry.terraform.io/providers/equinix/equinix/latest/docs/data-sources/equinix_metal_plans) data source from the [Equinix provider](https://registry.terraform.io/providers/equinix/equinix/latest/docs) instead of `metal_plans`. [See the Metal provider section for more details](../index.md#equinix-metal-provider) on the new provider and available migration guides.
 
 Provides an Equinix Metal plans datasource. This can be used to find plans that meet a filter criteria.
 

diff --git a/docs/data-sources/port.md b/docs/data-sources/port.md
@@ -5,7 +5,9 @@ description: |-
   Fetch device ports
 ---
 
-# metal_port
+# metal_port (Data Source)
+
+!> **PROVIDER DEPRECATED:** Equinix Metal Provider is now Deprecated. Please consider using [`equinix_metal_port`](https://registry.terraform.io/providers/equinix/equinix/latest/docs/data-sources/equinix_metal_port) data source from the [Equinix provider](https://registry.terraform.io/providers/equinix/equinix/latest/docs) instead of `metal_port`. [See the Metal provider section for more details](../index.md#equinix-metal-provider) on the new provider and available migration guides.
 
 Use this data source to read ports of existing devices. You can read port by either its UUID, or by a device UUID and port name.
 

diff --git a/docs/data-sources/precreated_ip_block.md b/docs/data-sources/precreated_ip_block.md
@@ -5,7 +5,9 @@ description: |-
   Load automatically created IP blocks from your Equinix Metal project
 ---
 
-# metal\_precreated\_ip\_block
+# metal_precreated_ip_block (Data Source)
+
+!> **PROVIDER DEPRECATED:** Equinix Metal Provider is now Deprecated. Please consider using [`equinix_metal_precreated_ip_block`](https://registry.terraform.io/providers/equinix/equinix/latest/docs/data-sources/equinix_metal_precreated_ip_block) data source from the [Equinix provider](https://registry.terraform.io/providers/equinix/equinix/latest/docs) instead of `metal_precreated_ip_block`. [See the Metal provider section for more details](../index.md#equinix-metal-provider) on the new provider and available migration guides.
 
 Use this data source to get CIDR expression for precreated IPv6 and IPv4 blocks in Equinix Metal.
 You can then use the cidrsubnet TF builtin function to derive subnets.

diff --git a/docs/data-sources/project.md b/docs/data-sources/project.md
@@ -5,7 +5,9 @@ description: |-
   Provides an Equinix Metal Project datasource.
 ---
 
-# metal\_project
+# metal_project (Data Source)
+
+!> **PROVIDER DEPRECATED:** Equinix Metal Provider is now Deprecated. Please consider using [`equinix_metal_project`](https://registry.terraform.io/providers/equinix/equinix/latest/docs/data-sources/equinix_metal_project) data source from the [Equinix provider](https://registry.terraform.io/providers/equinix/equinix/latest/docs) instead of `metal_project`. [See the Metal provider section for more details](../index.md#equinix-metal-provider) on the new provider and available migration guides.
 
 Use this datasource to retrieve attributes of the Project API resource.
 

diff --git a/docs/data-sources/project_ssh_key.md b/docs/data-sources/project_ssh_key.md
@@ -5,7 +5,9 @@ description: |-
   Provides an Equinix Metal Project SSH Key datasource.
 ---
 
-# metal\_project\_ssh\_key
+# metal_project_ssh_key (Data Source)
+
+!> **PROVIDER DEPRECATED:** Equinix Metal Provider is now Deprecated. Please consider using [`equinix_metal_project_ssh_key`](https://registry.terraform.io/providers/equinix/equinix/latest/docs/data-sources/equinix_metal_project_ssh_key) data source from the [Equinix provider](https://registry.terraform.io/providers/equinix/equinix/latest/docs) instead of `metal_project_ssh_key`. [See the Metal provider section for more details](../index.md#equinix-metal-provider) on the new provider and available migration guides.
 
 Use this datasource to retrieve attributes of a Project SSH Key API resource.
 

diff --git a/docs/data-sources/reserved_ip_block.md b/docs/data-sources/reserved_ip_block.md
@@ -5,7 +5,9 @@ description: |-
 Look up an IP address block
 ---
 
-# metal\_reserved\_ip\_block
+# metal_reserved_ip_block (Data Source)
+
+!> **PROVIDER DEPRECATED:** Equinix Metal Provider is now Deprecated. Please consider using [`equinix_metal_reserved_ip_block`](https://registry.terraform.io/providers/equinix/equinix/latest/docs/data-sources/equinix_metal_reserved_ip_block) data source from the [Equinix provider](https://registry.terraform.io/providers/equinix/equinix/latest/docs) instead of `metal_reserved_ip_block`. [See the Metal provider section for more details](../index.md#equinix-metal-provider) on the new provider and available migration guides.
 
 Use this data source to find IP address blocks in Equinix Metal. You can use IP address or a block ID for lookup.
 

diff --git a/docs/data-sources/spot_market_price.md b/docs/data-sources/spot_market_price.md
@@ -5,7 +5,9 @@ description: |-
   Get an Equinix Metal Spot Market Price
 ---
 
-# metal\_operating\_system
+# metal_operating_system (Data Source)
+
+!> **PROVIDER DEPRECATED:** Equinix Metal Provider is now Deprecated. Please consider using [`equinix_metal_operating_system`](https://registry.terraform.io/providers/equinix/equinix/latest/docs/data-sources/equinix_metal_operating_system) data source from the [Equinix provider](https://registry.terraform.io/providers/equinix/equinix/latest/docs) instead of `metal_operating_system`. [See the Metal provider section for more details](../index.md#equinix-metal-provider) on the new provider and available migration guides.
 
 Use this data source to get Equinix Metal Spot Market Price for a plan.
 

diff --git a/docs/data-sources/spot_market_request.md b/docs/data-sources/spot_market_request.md
@@ -5,7 +5,9 @@ description: |-
   Provides a datasource for existing Spot Market Requests in the Equinix Metal host.
 ---
 
-# metal_spot_market_request
+# metal_spot_market_request (Data Source)
+
+!> **PROVIDER DEPRECATED:** Equinix Metal Provider is now Deprecated. Please consider using [`equinix_metal_spot_market_request`](https://registry.terraform.io/providers/equinix/equinix/latest/docs/data-sources/equinix_metal_spot_market_request) data source from the [Equinix provider](https://registry.terraform.io/providers/equinix/equinix/latest/docs) instead of `metal_spot_market_request`. [See the Metal provider section for more details](../index.md#equinix-metal-provider) on the new provider and available migration guides.
 
 Provides an Equinix Metal spot_market_request datasource. The datasource will contain list of device IDs created by referenced Spot Market Request.
 

diff --git a/docs/data-sources/virtual_circuit.md b/docs/data-sources/virtual_circuit.md
@@ -5,7 +5,9 @@ description: |-
   Retrieve Equinix Fabric Virtual Circuit
 ---
 
-# metal_virtual_circuit
+# metal_virtual_circuit (Data Source)
+
+!> **PROVIDER DEPRECATED:** Equinix Metal Provider is now Deprecated. Please consider using [`equinix_metal_virtual_circuit`](https://registry.terraform.io/providers/equinix/equinix/latest/docs/data-sources/equinix_metal_virtual_circuit) data source from the [Equinix provider](https://registry.terraform.io/providers/equinix/equinix/latest/docs) instead of `metal_virtual_circuit`. [See the Metal provider section for more details](../index.md#equinix-metal-provider) on the new provider and available migration guides.
 
 Use this data source to retrieve a virtual circuit resource from [Equinix Fabric - software-defined interconnections](https://metal.equinix.com/developers/docs/networking/fabric/)
 

diff --git a/docs/data-sources/vlan.md b/docs/data-sources/vlan.md
@@ -5,7 +5,9 @@ description: |-
   Provides an Equinix Metal Virtual Network datasource. This can be used to read the attributes of existing VLANs.
 ---
 
-# metal_vlan
+# metal_vlan (Data Source)
+
+!> **PROVIDER DEPRECATED:** Equinix Metal Provider is now Deprecated. Please consider using [`equinix_metal_vlan`](https://registry.terraform.io/providers/equinix/equinix/latest/docs/data-sources/equinix_metal_vlan) data source from the [Equinix provider](https://registry.terraform.io/providers/equinix/equinix/latest/docs) instead of `metal_vlan`. [See the Metal provider section for more details](../index.md#equinix-metal-provider) on the new provider and available migration guides.
 
 Provides an Equinix Metal Virtual Network datasource. VLANs data sources can be
 searched by VLAN UUID, or project UUID and vxlan number.

diff --git a/docs/data-sources/volume.md b/docs/data-sources/volume.md
@@ -5,5 +5,6 @@ description: |-
   (Removed) Provides an Equinix Metal Block Storage Volume Datasource.
 ---
 
-Datasource `metal_volume` was removed in version 3.0.0, and the API support was deprecated on June 1st 2021. See https://metal.equinix.com/developers/docs/storage/elastic-block-storage/#elastic-block-storage for more details.
+!> **PROVIDER DEPRECATED:** Equinix Metal Provider is now Deprecated. [See the Metal provider section for more details](../index.md#equinix-metal-provider) on the new provider and available migration guides.
 
+Datasource `metal_volume` was removed in version 3.0.0, and the API support was deprecated on June 1st 2021. See https://metal.equinix.com/developers/docs/storage/elastic-block-storage/#elastic-block-storage for more details.
diff --git a/docs/data-sources/vrf.md b/docs/data-sources/vrf.md
@@ -7,6 +7,8 @@ description: |-
 
 # metal_virtual_circuit (Data Source)
 
+!> **PROVIDER DEPRECATED:** Equinix Metal Provider is now Deprecated. Please consider using [`equinix_metal_virtual_circuit`](https://registry.terraform.io/providers/equinix/equinix/latest/docs/data-sources/equinix_metal_virtual_circuit) data source from the [Equinix provider](https://registry.terraform.io/providers/equinix/equinix/latest/docs) instead of `metal_virtual_circuit`. [See the Metal provider section for more details](../index.md#equinix-metal-provider) on the new provider and available migration guides.
+
 Use this data source to retrieve a VRF resource.
 
 ~> VRF features are not generally available. The interfaces related to VRF resources may change ahead of general availability.

diff --git a/docs/guides/migration_guide_facilities_to_metros_devices.md b/docs/guides/migration_guide_facilities_to_metros_devices.md
@@ -6,6 +6,8 @@ description: |-
 
 # Metros vs. Facilities
 
+!> **PROVIDER DEPRECATED:** Equinix Metal Provider is now Deprecated. [See the Metal provider section for more details](../index.md#equinix-metal-provider) on the new provider and available migration guides.
+
 In April 2021, Equinix Metal rolled out a new location concept - [metros](https://feedback.equinixmetal.com/changelog/new-metros-feature-live). A metro is an Equinix-wide concept for data centers which are grouped together geographically. Data centers within a metro share capacity and networking features. You can read more about metros at https://metal.equinix.com/developers/docs/locations/metros/.
 
 Before the introduction of metros, resources were deployed to a single `facility` location.  When provisioning `metal_device` resources, the facility could be chosen by Equinix Metal with a user-supplied list of `facilities`, or a wildcard `any` facility.  The individual facility locations use a code like "sv15" or "ny5". Metros group facilities. For example, metro "sv" contains the "sv15" facility, among others. If you specify a metro when creating a resource, it will be deployed to one of the facilities in the metro group. You can then find the deployed facility using a read-only attribute of the resource (e.g. `deployed_facility` for `metal_device` resources).

diff --git a/docs/guides/migration_guide_packet.md b/docs/guides/migration_guide_packet.md
@@ -6,6 +6,8 @@ description: |-
 
 # Migrating from packethost/packet to equinix/metal
 
+!> **PROVIDER DEPRECATED:** Equinix Metal Provider is now Deprecated. [See the Metal provider section for more details](../index.md#equinix-metal-provider) on the new provider and available migration guides.
+
 Packet is now Equinix Metal, and the name of the Terraform provider changed too. This (terraform-provider-metal, provider equinix/metal) is the current provider for Equinix Metal.
 
 If you've been using terraform-provider-packet, and you want to use a newer provider version to manage resources in Equinix Metal, you will need to change the references in you HCL files. You can just change the names of the resources, e.g. from `packet_device` to `metal_device`. That should work, but it will cause the `packet_device` to be destroyed and new `metal_device` to be created instead. Re-creation of the resources might be undesirable, and this guide shows how to migrate to metal_ resources without the re-creation.