why does datadog_logs_pipeline_order require name?

[dhduvall]

The name attribute in a datadog_logs_pipeline_order resource is required, even though it doesn't exist as part of the object returned by the API. The doc string for the attribute even says so itself! A freshly imported resource immediately requires being changed, which, while harmless as far as I can tell, is a red herring, and could very well lead someone to spend a whole bunch of time trying to figure out what's going on.

What's the purpose of this attribute?

resource "datadog_logs_pipeline_order" "pipeline-order" {
  name = "logs-pipeline-order"
  pipelines = [
    datadog_logs_custom_pipeline.one.id,
    datadog_logs_integration_pipeline.python.id,
    datadog_logs_custom_pipeline.two.id,
  ]
}

$ curl -X GET -H "DD-API-KEY: $DD_API_KEY" -H "DD-APPLICATION-KEY: $DD_APP_KEY" https://api.datadoghq.com/api/v1/logs/config/pipeline-order | jq
{
  "pipeline_ids": [
    "53E4i5QvRCispIKqAcMouQ",
    "b8SxsNzwQ1-RKfAQNFy4cQ",
    "LZgoIzHdS8a7uhH5kDPksA"
  ]
}

$ tofu apply
...
  # datadog_logs_pipeline_order.pipeline-order will be updated in-place
  ~ resource "datadog_logs_pipeline_order" "pipeline-order" {
        id        = "logs-pipeline-order"
      + name      = "logs-pipeline-order"
        # (1 unchanged attribute hidden)
    }

$ curl -X GET -H "DD-API-KEY: $DD_API_KEY" -H "DD-APPLICATION-KEY: $DD_APP_KEY" https://api.datadoghq.com/api/v1/logs/config/pipeline-order | jq
{
  "pipeline_ids": [
    "53E4i5QvRCispIKqAcMouQ",
    "b8SxsNzwQ1-RKfAQNFy4cQ",
    "LZgoIzHdS8a7uhH5kDPksA"
  ]
}