Missing Required `name {}` Block in `oci_identity_domains_user` Resource Documentation

[nratineau]

Community Note

• Please vote on this issue by adding a 👍 reaction to the original issue to help the community and maintainers prioritize this request
• Please do not leave "+1" or "me too" comments, they generate extra noise for issue followers and do not help prioritize the request
• If you are interested in working on this issue or have submitted a pull request, please leave a comment

Terraform Version and Provider Version

Terraform v1.7.x  
Oracle OCI Provider v7.4.0 (also applies to v7.5.0)

---

Affected Resource(s)

• oci_identity_domains_user - Doc: oci_identity_domains_user

---

Expected Behavior

The Terraform documentation at oci_identity_domains_user should include the required name {} block in its example and attribute list.

This block is mandatory for the user creation to succeed when using the SCIM schema:

name {
  given_name  = "Example"
  family_name = "User"
}

---

Actual Behavior

The example provided in the documentation does not include the name {} block as required, which leads to the following error during execution if you don't set it:

Error: 400-BadErrorResponse, 
│ Suggestion: Please retry or contact support for help with service: Identity Domains User
│ Documentation: https://registry.terraform.io/providers/oracle/oci/latest/docs/resources/identity_domains_user 
│ API Reference:  
│ Request Target: POST https://<idcs-url>.identity.oraclecloud.com/admin/v1/Users 
│ Provider version: 7.4.0, released on 2025-06-08. This provider is 1 Update(s) behind to current. 
│ Service: Identity Domains User 
│ Operation Name: CreateUser 
│ OPC request ID: <request-ID>
...
Debug:
[DEBUG] provider.terraform-provider-oci_v7.4.0: {"schemas":["urn:ietf:params:scim:api:messages:2.0:Error","urn:ietf:params:scim:api:oracle:idcs:extension:messages:Error"],"detail":"Missing required attribute(s): name.","status":"400","urn:ietf:params:scim:api:oracle:idcs:extension:messages:Error":{"messageId":"error.common.validation.missingReqAttributes"}}

Terraform debug output confirms the failure is due to a missing name field in the API payload.

---

Steps to Reproduce

1. Use the example in the documentation without a name {} block.
2. Run terraform apply.
3. Observe the API error: Missing required attribute(s): name.

---

Notes

• The name block (containing given_name and family_name) is required by the OCI SCIM API.
• Adding the name block resolves the issue.

---

Suggested Fix

Update the documentation to reflect this required block.