summaryrefslogtreecommitdiff
path: root/doc/api/group_protected_environments.md
diff options
context:
space:
mode:
Diffstat (limited to 'doc/api/group_protected_environments.md')
-rw-r--r--doc/api/group_protected_environments.md26
1 files changed, 15 insertions, 11 deletions
diff --git a/doc/api/group_protected_environments.md b/doc/api/group_protected_environments.md
index 0e1cd149c51..6ce4e1791b0 100644
--- a/doc/api/group_protected_environments.md
+++ b/doc/api/group_protected_environments.md
@@ -48,12 +48,13 @@ Example response:
"name":"production",
"deploy_access_levels":[
{
- "access_level":40,
- "access_level_description":"Maintainers",
- "user_id":null,
- "group_id":null
+ "access_level": 40,
+ "access_level_description": "Maintainers",
+ "user_id": null,
+ "group_id": null
}
- ]
+ ],
+ "required_approval_count": 0
}
]
```
@@ -87,7 +88,8 @@ Example response:
"user_id":null,
"group_id":null
}
- ]
+ ],
+ "required_approval_count": 0
}
```
@@ -104,6 +106,7 @@ POST /groups/:id/protected_environments
| `id` | integer/string | yes | The ID or [URL-encoded path of the group](index.md#namespaced-path-encoding) maintained by the authenticated user. |
| `name` | string | yes | The deployment tier of the protected environment. One of `production`, `staging`, `testing`, `development`, or `other`. Read more about [deployment tiers](../ci/environments/index.md#deployment-tier-of-environments).|
| `deploy_access_levels` | array | yes | Array of access levels allowed to deploy, with each described by a hash. One of `user_id`, `group_id` or `access_level`. They take the form of `{user_id: integer}`, `{group_id: integer}` or `{access_level: integer}` respectively. |
+| `required_approval_count` | integer | no | The number of approvals required to deploy to this environment. This is part of Deployment Approvals, which isn't yet available for use. For details, see [issue](https://gitlab.com/gitlab-org/gitlab/-/issues/343864). |
The assignable `user_id` are the users who belong to the given group with the Maintainer role (or above).
The assignable `group_id` are the sub-groups under the given group.
@@ -119,12 +122,13 @@ Example response:
"name":"production",
"deploy_access_levels":[
{
- "access_level":40,
- "access_level_description":"protected-access-group",
- "user_id":null,
- "group_id":9899826
+ "access_level": 40,
+ "access_level_description": "protected-access-group",
+ "user_id": null,
+ "group_id": 9899826
}
- ]
+ ],
+ "required_approval_count": 0
}
```