Feat/add custom role resource and data source

[Markus-Schwer]

Description

relates to STACKITIAM-1100

Checklist

• Issue was linked above
• Code format was applied: make fmt
• Examples were added / adjusted (see examples/ directory)
• Docs are up-to-date: make generate-docs (will be checked by CI)
• Unit tests got implemented or updated
• Acceptance tests got implemented or updated (see e.g. here)
• Unit tests are passing: make test (will be checked by CI)
• No linter issues: make lint (will be checked by CI)

[Markus-Schwer]

I will add the examples on monday

[Markus-Schwer]

To clarify: this PR cannot be merged right now, because the API it uses is not public yet. We will make it public soon. When it is public, I will use the newly generated SDK and test this change again. Then it can be merged. For now I would still appreciate it if you review the changes, so that we can quickly merge this PR once the API is released.

[github-actions]

This PR was marked as stale after 7 days of inactivity and will be closed after another 7 days of further inactivity. If this PR should be kept open, just add a comment, remove the stale label or push new commits to it.

[marceljk]

When the role_id remains always the same between in-place updates, this is correct

[Markus-Schwer]

I changed it to RequiresReplace, same as resource_id

[marceljk]

Please revert this change. This will trigger always a recreate for this resource, even if only the name should be updated.

Terraform will perform the following actions:

  # stackit_authorization_project_custom_role.name must be replaced
-/+ resource "stackit_authorization_project_custom_role" "name" {
      ~ id          = "66b03760-125b-4c63-9624-741e8a4*****,e623f5a5-4152-4546-bea7-43f6d0939e87" -> (known after apply)
      ~ name        = "my.custom.role" -> "my.custom.roles"
      ~ role_id     = "e623f5a5-4152-4546-bea7-43f6d0939e87" -> (known after apply) # forces replacement
        # (3 unchanged attributes hidden)
    }

UseStateForUnknown was here correct

[marceljk]

Please revert this change. This will trigger always a recreate for this resource, even if only the name should be updated.

Terraform will perform the following actions:

  # stackit_authorization_project_custom_role.name must be replaced
-/+ resource "stackit_authorization_project_custom_role" "name" {
      ~ id          = "66b03760-125b-4c63-9624-741e8a4*****,e623f5a5-4152-4546-bea7-43f6d0939e87" -> (known after apply)
      ~ name        = "my.custom.role" -> "my.custom.roles"
      ~ role_id     = "e623f5a5-4152-4546-bea7-43f6d0939e87" -> (known after apply) # forces replacement
        # (3 unchanged attributes hidden)
    }

UseStateForUnknown was here correct

[cgoetz-inovex]

The description main and resource_id reads a bit weird when applied to the datasource schema.
Maybe we could reword these to be a bit more general.

But also not sure if worth fixing.