Update docs for v17.11.0 release

Author: gitlab-terraform-provider-bot

CHANGELOG.md

@@ -1,3 +1,34 @@
+## 17.11.0 (2025-04-17)
+
+This release was tested against GitLab 17.11, 17.10, and 17.9 for both CE and EE
+
+### FEATURES (1 change)
+
+- resource/gitlab_group_dependency_proxy:  [Adds support for managing the docker hub Group Dependency Proxy](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/commit/cf17cddf5da2310d621db6a7e20a3b9edff21d49) by @PatrickRice ([merge request](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/2418)) 
+
+### IMPROVEMENTS (9 changes)
+
+- resource/gitlab_project_job_token_scopes:  [Add support for `Enabled`](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/commit/08856986d33ea1eec8b93d972c4ede3726d7bbd4) by @qa-andreas-grub ([merge request](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/2422)) 
+- resource/gitlab_group_ldap_link: [Add support for `member_role_id` to support custom roles]() by @PatrickRice ([merge request](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/2430)) 
+- resource/gitlab_project:  [Add support for ci_id_token_sub_claim_components](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/commit/7c2ac93acfdbc199ca77421a8004310f52bb30d0) by @bakkerduncan ([merge request](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/2367)) 
+- resource/gitlab_project:  [Add ci_delete_pipelines_in_seconds](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/commit/59cd615f91f3fdd627a0e65026b5c6afb97154b9) by @ztzxt ([merge request](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/2391)) 
+- resource/gitlab_project:  [Improved documentation for `squash_option`](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/commit/3899c8601f13dc72e824801d94c231383aad3d8c)  @heidi.berry ([merge request](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/2431)) 
+- resource/gitlab_integration_jira: [Added deprecation notice for `project_key`](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/commit/e1f812e4361e1ca4f1baf1b8d610e4161569f13c) by @heidi.berry ([merge request](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/2426)) 
+- [Add support for new `planner` role to multiple membership resources](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/commit/34d30d81f4a76ddd6089170d0530b87db5148650) by @heidi.berry ([merge request](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/2419)) 
+- [Update documentation URLs for multiple integration resources](gitlab.com/gitlab-org/terraform-provider-gitlab/-/commit/d9f459c07a26aaf46c40371ab69f2854049f962b) by @@bas.bremer ([merge request](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/2411)) 
+- [Add token descriptions to project, group, and personal access tokens](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/commit/4b8dd0f9fba392c29a4d9a194562324499f48857) by @PatrickRice ([merge request](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/2416)) 
+
+### BUG FIXES (8 changes)
+
+- resource/gitlab_project_mirror:  [Fixes an issue where `mirror_branch_regex` would cause a perpetual plan](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/commit/255e947781a7096358601f3f79c3b201b75c8596) by @mness ([merge request](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/2424)) 
+- resource/gitlab_project_variable:  [Fixed an issue where removing project variables outside of TF could break the state file](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/commit/8fc8b3fa729322efceed0cacb7145d7947c09bec) by @jonathand2 ([merge request](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/2417)) 
+- resource/gitlab_group_variable:  [Fixed an issue where removing group variables outside of TF could break the state file](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/commit/8fc8b3fa729322efceed0cacb7145d7947c09bec) by @jonathand2 ([merge request](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/2417)) 
+- resource/gitlab_group:  [Fix an issue where `membership_lock` was set to false if not specified in the config](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/commit/2d4055b0169b184c4067babe80de9e4cce99c88e) by @PatrickRice ([merge request](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/2406)) 
+- resource/gitlab_group_issue_board:  [Fix an issue with group issue board error handling that would cause the provider to panic](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/commit/6a8e6ce3c09814e185eb9d2f3d15194154b1f47c) by @PatrickRice ([merge request](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/2409)) 
+- resource/gitlab_group_issue_board:  [Added error handling to provide earlier error detection and messaging](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/commit/53539a09ca3c9a60ad8b62b5a54c742ce78f6cf1) by @heidi.berry ([merge request](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/2429)) 
+- resource/gitlab_group_membership:  [Fix an error where expires_at and member_role_id were not computed](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/commit/bf0bc0cf79b0568d2531eafd32725a9259afbc88) by @PatrickRice ([merge request](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/2405))
+- resource/gitlab_instance_service_account: [Refactor a system panic that could happen when waiting for delete](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/commit/5dfaddb1b4d738610fc9bc62e4f249fc124f5bd2) by @timofurrer ([merge request](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/2386)) 
+
 ## 17.10.0 (2025-03-20)
 
 This release was tested against GitLab 17.10, 17.9, and 17.8 for both CE and EE

docs/data-sources/branch.md

@@ -45,7 +45,7 @@ data "gitlab_branch" "foo" {
 - `developer_can_merge` (Boolean) Bool, true if developer level access allows to merge branch.
 - `developer_can_push` (Boolean) Bool, true if developer level access allows git push.
 - `id` (String) The ID of this resource.
-- `merged` (Boolean) Bool, true if the branch has been merged into it's parent.
+- `merged` (Boolean) Bool, true if the branch has been merged into its parent.
 - `protected` (Boolean) Bool, true if branch has branch protection.
 - `web_url` (String) The url of the created branch (https.)
 

docs/data-sources/group.md

@@ -4,14 +4,14 @@ page_title: "gitlab_group Data Source - terraform-provider-gitlab"
 subcategory: ""
 description: |-
   The gitlab_group data source allows details of a group to be retrieved by its id or full path.
-  Upstream API: GitLab REST API docs https://docs.gitlab.com/api/groups/#details-of-a-group
+  Upstream API: GitLab REST API docs https://docs.gitlab.com/api/groups/#get-a-single-group
 ---
 
 # gitlab_group (Data Source)
 
 The `gitlab_group` data source allows details of a group to be retrieved by its id or full path.
 
-**Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/api/groups/#details-of-a-group)
+**Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/api/groups/#get-a-single-group)
 
 ## Example Usage
 

docs/data-sources/group_hook.md

@@ -4,14 +4,14 @@ page_title: "gitlab_group_hook Data Source - terraform-provider-gitlab"
 subcategory: ""
 description: |-
   The gitlab_group_hook data source allows to retrieve details about a hook in a group.
-  Upstream API: GitLab REST API docs https://docs.gitlab.com/api/groups/#get-group-hook
+  Upstream API: GitLab REST API docs https://docs.gitlab.com/api/group_webhooks/#get-a-group-hook
 ---
 
 # gitlab_group_hook (Data Source)
 
 The `gitlab_group_hook` data source allows to retrieve details about a hook in a group.
 
-**Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/api/groups/#get-group-hook)
+**Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/api/group_webhooks/#get-a-group-hook)
 
 ## Example Usage
 

docs/data-sources/group_hooks.md

@@ -4,14 +4,14 @@ page_title: "gitlab_group_hooks Data Source - terraform-provider-gitlab"
 subcategory: ""
 description: |-
   The gitlab_group_hooks data source allows to retrieve details about hooks in a group.
-  Upstream API: GitLab REST API docs https://docs.gitlab.com/api/groups/#list-group-hooks
+  Upstream API: GitLab REST API docs https://docs.gitlab.com/api/group_webhooks/#list-group-hooks
 ---
 
 # gitlab_group_hooks (Data Source)
 
 The `gitlab_group_hooks` data source allows to retrieve details about hooks in a group.
 
-**Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/api/groups/#list-group-hooks)
+**Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/api/group_webhooks/#list-group-hooks)
 
 ## Example Usage
 

docs/data-sources/group_subgroups.md

@@ -4,14 +4,14 @@ page_title: "gitlab_group_subgroups Data Source - terraform-provider-gitlab"
 subcategory: ""
 description: |-
   The gitlab_group_subgroups data source allows to get subgroups of a group.
-  Upstream API: GitLab REST API docs https://docs.gitlab.com/api/groups/#list-a-groups-subgroups
+  Upstream API: GitLab REST API docs https://docs.gitlab.com/api/groups/#list-subgroups
 ---
 
 # gitlab_group_subgroups (Data Source)
 
 The `gitlab_group_subgroups` data source allows to get subgroups of a group.
 
-**Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/api/groups/#list-a-groups-subgroups)
+**Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/api/groups/#list-subgroups)
 
 ## Example Usage
 

docs/data-sources/project.md

@@ -4,14 +4,14 @@ page_title: "gitlab_project Data Source - terraform-provider-gitlab"
 subcategory: ""
 description: |-
   The gitlab_project data source allows details of a project to be retrieved by either its ID or its path with namespace.
-  Upstream API: GitLab REST API docs https://docs.gitlab.com/api/projects/#get-single-project
+  Upstream API: GitLab REST API docs https://docs.gitlab.com/api/projects/#get-a-single-project
 ---
 
 # gitlab_project (Data Source)
 
 The `gitlab_project` data source allows details of a project to be retrieved by either its ID or its path with namespace.
 
-**Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/api/projects/#get-single-project)
+**Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/api/projects/#get-a-single-project)
 
 ## Example Usage
 
@@ -33,6 +33,7 @@ data "gitlab_project" "example" {
 ### Optional
 
 - `ci_default_git_depth` (Number) Default number of revisions for shallow cloning.
+- `ci_id_token_sub_claim_components` (List of String) Fields included in the sub claim of the ID Token. Accepts an array starting with project_path. The array might also include ref_type and ref. Defaults to ["project_path", "ref_type", "ref"]. Introduced in GitLab 17.10.
 - `id` (String) The integer that uniquely identifies the project within the gitlab install.
 - `path_with_namespace` (String) The path of the repository with namespace.
 - `public_builds` (Boolean) If true, jobs can be viewed by non-project members.
@@ -50,6 +51,7 @@ data "gitlab_project" "example" {
 - `build_timeout` (Number) The maximum amount of time, in seconds, that a job can run.
 - `builds_access_level` (String) Set the builds access level. Valid values are `disabled`, `private`, `enabled`.
 - `ci_config_path` (String) CI config file path for the project.
+- `ci_delete_pipelines_in_seconds` (Number) Pipelines older than the configured time are deleted.
 - `ci_pipeline_variables_minimum_override_role` (String) The minimum role required to set variables when running pipelines and jobs. Introduced in GitLab 17.1. Valid values are `developer`, `maintainer`, `owner`, `no_one_allowed`
 - `ci_restrict_pipeline_cancellation_role` (String) The role required to cancel a pipeline or job. Premium and Ultimate only. Valid values are `developer`, `maintainer`, `no one`
 - `ci_separated_caches` (Boolean) Use separate caches for protected branches.

docs/data-sources/project_hook.md

@@ -4,14 +4,14 @@ page_title: "gitlab_project_hook Data Source - terraform-provider-gitlab"
 subcategory: ""
 description: |-
   The gitlab_project_hook data source allows to retrieve details about a hook in a project.
-  Upstream API: GitLab REST API docs https://docs.gitlab.com/api/projects/#get-project-hook
+  Upstream API: GitLab REST API docs https://docs.gitlab.com/api/project_webhooks/#get-a-project-webhook
 ---
 
 # gitlab_project_hook (Data Source)
 
 The `gitlab_project_hook` data source allows to retrieve details about a hook in a project.
 
-**Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/api/projects/#get-project-hook)
+**Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/api/project_webhooks/#get-a-project-webhook)
 
 ## Example Usage
 

docs/data-sources/project_hooks.md

@@ -4,14 +4,14 @@ page_title: "gitlab_project_hooks Data Source - terraform-provider-gitlab"
 subcategory: ""
 description: |-
   The gitlab_project_hooks data source allows to retrieve details about hooks in a project.
-  Upstream API: GitLab REST API docs https://docs.gitlab.com/api/projects/#list-project-hooks
+  Upstream API: GitLab REST API docs https://docs.gitlab.com/api/project_webhooks/#list-webhooks-for-a-project
 ---
 
 # gitlab_project_hooks (Data Source)
 
 The `gitlab_project_hooks` data source allows to retrieve details about hooks in a project.
 
-**Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/api/projects/#list-project-hooks)
+**Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/api/project_webhooks/#list-webhooks-for-a-project)
 
 ## Example Usage
 

docs/data-sources/projects.md

@@ -96,7 +96,9 @@ Read-Only:
 - `builds_access_level` (String)
 - `ci_config_path` (String)
 - `ci_default_git_depth` (Number)
+- `ci_delete_pipelines_in_seconds` (Number)
 - `ci_forward_deployment_enabled` (Boolean)
+- `ci_id_token_sub_claim_components` (List of String)
 - `ci_pipeline_variables_minimum_override_role` (String)
 - `ci_restrict_pipeline_cancellation_role` (String)
 - `container_expiration_policy` (List of Object) (see [below for nested schema](#nestedobjatt--projects--container_expiration_policy))

docs/data-sources/user.md

@@ -6,7 +6,7 @@ description: |-
   The gitlab_user data source allows details of a user to be retrieved by either the user ID, username or email address.
   -> Some attributes might not be returned depending on if you're an admin or not.
   ~> When using the email attribute, an exact match is not guaranteed. The most related match will be returned. The most related match will prioritize an exact match if one is available.
-  Upstream API: GitLab REST API docs https://docs.gitlab.com/api/users/#single-user
+  Upstream API: GitLab REST API docs https://docs.gitlab.com/api/users/#get-a-single-user
 ---
 
 # gitlab_user (Data Source)
@@ -17,7 +17,7 @@ The `gitlab_user` data source allows details of a user to be retrieved by either
 
 ~> When using the `email` attribute, an exact match is not guaranteed. The most related match will be returned. The most related match will prioritize an exact match if one is available.
 
-**Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/api/users/#single-user)
+**Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/api/users/#get-a-single-user)
 
 ## Example Usage
 

docs/data-sources/user_sshkeys.md

@@ -4,14 +4,14 @@ page_title: "gitlab_user_sshkeys Data Source - terraform-provider-gitlab"
 subcategory: ""
 description: |-
   The gitlab_user_sshkeys data source allows a list of SSH keys to be retrieved by either the user ID or username.
-  Upstream API: GitLab REST API docs https://docs.gitlab.com/api/users/#list-ssh-keys-for-user
+  Upstream API: GitLab REST API docs https://docs.gitlab.com/api/user_keys/#list-all-ssh-keys-for-a-user
 ---
 
 # gitlab_user_sshkeys (Data Source)
 
 The `gitlab_user_sshkeys` data source allows a list of SSH keys to be retrieved by either the user ID or username.
 
-**Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/api/users/#list-ssh-keys-for-user)
+**Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/api/user_keys/#list-all-ssh-keys-for-a-user)
 
 
 

docs/data-sources/users.md

@@ -6,7 +6,7 @@ description: |-
   The gitlab_users data source allows details of multiple users to be retrieved given some optional filter criteria.
   -> Some attributes might not be returned depending on if you're an admin or not.
   -> Some available options require administrator privileges.
-  Upstream API: GitLab REST API docs https://docs.gitlab.com/ce/api/users/#list-users
+  Upstream API: GitLab REST API docs https://docs.gitlab.com/api/users/#list-users
 ---
 
 # gitlab_users (Data Source)
@@ -17,7 +17,7 @@ The `gitlab_users` data source allows details of multiple users to be retrieved
 
 -> Some available options require administrator privileges.
 
-**Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/ce/api/users/#list-users)
+**Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/api/users/#list-users)
 
 ## Example Usage
 

docs/development/CreatingANewResource.md

@@ -308,9 +308,9 @@ func (r *gitlabApplicationResource) Create(ctx context.Context, req resource.Cre
 
 	// configure GitLab API call
 	options := &gitlab.CreateApplicationOptions{
-		Name:        gitlab.String(data.Name.ValueString()),
-		RedirectURI: gitlab.String(data.RedirectURL.ValueString()),
-		Scopes:      gitlab.String(formatted_scopes),
+		Name:        gitlab.Ptr(data.Name.ValueString()),
+		RedirectURI: gitlab.Ptr(data.RedirectURL.ValueString()),
+		Scopes:      gitlab.Ptr(formatted_scopes),
 	}
 
 	if !data.Confidential.IsNull() {

docs/resources/branch.md

@@ -51,7 +51,7 @@ resource "gitlab_branch" "example" {
 - `developer_can_merge` (Boolean) Bool, true if developer level access allows to merge branch.
 - `developer_can_push` (Boolean) Bool, true if developer level access allows git push.
 - `id` (String) The ID of this resource.
-- `merged` (Boolean) Bool, true if the branch has been merged into it's parent.
+- `merged` (Boolean) Bool, true if the branch has been merged into its parent.
 - `protected` (Boolean) Bool, true if branch has branch protection.
 - `web_url` (String) The url of the created branch (https).
 

docs/resources/group_access_token.md

@@ -52,7 +52,8 @@ resource "gitlab_group_variable" "example" {
 
 ### Optional
 
-- `access_level` (String) The access level for the group access token. Valid values are: `no one`, `minimal`, `guest`, `reporter`, `developer`, `maintainer`, `owner`. Default is `maintainer`.
+- `access_level` (String) The access level for the group access token. Valid values are: `no one`, `minimal`, `guest`, `planner`, `reporter`, `developer`, `maintainer`, `owner`. Default is `maintainer`.
+- `description` (String) The description of the group access token.
 - `expires_at` (String) When the token will expire, YYYY-MM-DD format.
 - `rotation_configuration` (Attributes) The configuration for when to rotate a token automatically. Will not rotate a token until `terraform apply` is run. (see [below for nested schema](#nestedatt--rotation_configuration))