summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorNejc Habjan <nejc.habjan@siemens.com>2022-07-28 13:22:05 +0200
committerJohn Villalovos <john@sodarock.com>2022-07-28 07:41:36 -0700
commit4a6f8d67a94a3d104a24081ad1dbad5b2e3d9c3e (patch)
treeaaa580ac0cbd93c2695d5eab5d9df2d2165d159d
parent263fe3d24836b34dccdcee0221bd417e0b74fb2e (diff)
downloadgitlab-4a6f8d67a94a3d104a24081ad1dbad5b2e3d9c3e.tar.gz
docs(cli): showcase use of token scopes
-rw-r--r--docs/cli-examples.rst49
1 files changed, 48 insertions, 1 deletions
diff --git a/docs/cli-examples.rst b/docs/cli-examples.rst
index 49956a6..94ce6c8 100644
--- a/docs/cli-examples.rst
+++ b/docs/cli-examples.rst
@@ -111,6 +111,12 @@ Get a specific user by id:
$ gitlab user get --id 3
+Create a user impersonation token (admin-only):
+
+.. code-block:: console
+
+ gitlab user-impersonation-token create --user-id 2 --name test-token --scopes api,read_user
+
Deploy tokens
-------------
@@ -119,7 +125,7 @@ Create a deploy token for a project:
.. code-block:: console
$ gitlab -v project-deploy-token create --project-id 2 \
- --name bar --username root --expires-at "2021-09-09" --scopes "read_repository"
+ --name bar --username root --expires-at "2021-09-09" --scopes "api,read_repository"
List deploy tokens for a group:
@@ -127,6 +133,47 @@ List deploy tokens for a group:
$ gitlab -v group-deploy-token list --group-id 3
+Resource access tokens
+----------------------
+
+Create a project access token:
+
+.. code-block:: console
+
+ $ gitlab -v project-access-token create --project-id 2 \
+ --name project-token --expires-at "2023-01-01" --scopes "api,read_repository"
+
+List project access tokens:
+
+.. code-block:: console
+
+ $ gitlab -v project-access-token list --project-id 3
+
+Revoke a project access token:
+
+.. code-block:: console
+
+ $ gitlab project-access-token delete --project-id 3 --id 1
+
+Create a group access token:
+
+.. code-block:: console
+
+ $ gitlab -v group-access-token create --group-id 2 \
+ --name group-token --expires-at "2022-01-01" --scopes "api,read_repository"
+
+List group access tokens:
+
+.. code-block:: console
+
+ $ gitlab -v group-access-token list --group-id 3
+
+Revoke a group access token:
+
+.. code-block:: console
+
+ $ gitlab group-access-token delete --group-id 3 --id 1
+
Packages
--------