fix(cloudProject): creation and import for cloudProject in the US

[Stoakes]

Description

This PR fixes public cloud project creation for OVH US. It also improves cloud project documentation so that creation in the US is easier for end user.

Because of some differences in Agora, the result is different between OVH EU/CA on one side & OVH US on the other. There's been some internal discussions about changing that (I can provide more details in PM) and they haven't landed on a result and are not expected to in any near future.

This PR works around the issue by making extra call to find out serviceName if the initial serviceName determination attempt failed.

Type of change

• Bug fix (non-breaking change which fixes an issue)
• Improvement (improve existing resource(s) or datasource(s))
• Documentation update

How Has This Been Tested?

I manually tested it by successfully creating & importing a cloud project on OVH-US.

Test Configuration:

• Terraform version: terraform version: Terraform v1.4.2
• Existing HCL configuration you used:

export OVH_ENDPOINT=ovh-us

data "ovh_order_cart" "aaa_cart" {
  ovh_subsidiary = "us"
  description    = "us public cloud project cart"
}

data "ovh_order_cart_product_plan" "cloud" {
  cart_id        = data.ovh_order_cart.aaa_cart.id
  price_capacity = "renew"
  product        = "cloud"
  plan_code      = "project" # naming is different in the us.
}

resource "ovh_cloud_project" "cloud_project" {
  ovh_subsidiary = data.ovh_order_cart.aaa_cart.ovh_subsidiary
  description    = "us cloud project"
  payment_mean   = "ovh-account"

  plan {
    duration     = data.ovh_order_cart_product_plan.cloud.selected_price.0.duration
    plan_code    = data.ovh_order_cart_product_plan.cloud.plan_code
    pricing_mode = data.ovh_order_cart_product_plan.cloud.selected_price.0.pricing_mode
  }
}

And also `terraform import ovh_cloud_project.cloud_project <project_id>

Checklist:

• My code follows the style guidelines of this project
• I have performed a self-review of my code
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation
• My changes generate no new warnings or issues
• I have added acceptance tests that prove my fix is effective or that my feature works
• New and existing acceptance tests pass locally with my changes
• I ran successfully go mod vendor if I added or modify go.mod file

[Stoakes]

Hello,

Is there anything missing on this PR ? Or can we merge it ?

[scraly]

We are waiting for an US account in order to test everything as the user will do.

[Stoakes]

Creation of public cloud project patched.

The deletion (and update) of a public cloud project in the US is not working yet because /me/notification/email/history (used for project confirmation deletion) is not available in the US.

@yomovh & myself will see how we deal with it.

[Stoakes]

We don't want to put too much US specific logic in the provider and will work into getting resources ordered through /order deletable in the US.

So for now, as agreed with @yomovh, I added a notice about the known issue that a public cloud project cannot be deleted in the US through Terraform.

[yomovh]

Thanks for your PR

[scraly]

After all the things we saw, edited and fixed, now, the PR is good for me 💪