:original_name: swr_02_0046.html

.. _swr_02_0046:

Creating Image Permissions
==========================

Function
--------

Grant permissions of an image to certain users so that they can manage, edit, and read the image.

URI
---

POST /v2/manage/namespaces/{*namespace*}/repos/{*repository*}/access

For details about parameters, see :ref:`Table 1 <swr_02_0046__table73271639103420>`.

.. _swr_02_0046__table73271639103420:

.. table:: **Table 1** Parameter description

   ========== ========= ====== ==================
   Parameter  Mandatory Type   Description
   ========== ========= ====== ==================
   namespace  Yes       String Organization name.
   repository Yes       String Image name.
   ========== ========= ====== ==================

Request
-------

-  Request parameters

   .. table:: **Table 2** Request body parameter description

      +-------------------+-----------+--------------------------------------------------------+--------------+
      | Parameter         | Mandatory | Type                                                   | Description. |
      +===================+===========+========================================================+==============+
      | *[Array element]* | Yes       | Array of :ref:`objects <swr_02_0046__table6912142367>` | User list    |
      +-------------------+-----------+--------------------------------------------------------+--------------+

   .. _swr_02_0046__table6912142367:

   .. table:: **Table 3** *[Array element]* parameters decription

      +-----------------+-----------------+-----------------+-------------------------------------+
      | Parameter       | Mandatory       | Type            | Description                         |
      +=================+=================+=================+=====================================+
      | user_id         | Yes             | String          | User ID.                            |
      +-----------------+-----------------+-----------------+-------------------------------------+
      | user_name       | Yes             | String          | Username.                           |
      +-----------------+-----------------+-----------------+-------------------------------------+
      | auth            | Yes             | Integer         | User permission that is configured. |
      |                 |                 |                 |                                     |
      |                 |                 |                 | -  7: Manage                        |
      |                 |                 |                 | -  3: Write                         |
      |                 |                 |                 | -  1: Read                          |
      +-----------------+-----------------+-----------------+-------------------------------------+

-  Example request

   .. code-block:: text

      POST https://{Endpoint}/v2/manage/namespaces/group/repos/busybox/access

   Body:

   .. code-block::

      [
          {
              "user_id": "fb3f175c1fd146ab8cdae3272be6107b",
              "user_name": "user01",
              "auth": 1
          }
      ]

Response
--------

-  Response parameters

   N/A

-  Example response

   .. code-block::

      {}

Status Code
-----------

=========== =========================
Status Code Description
=========== =========================
201         Creation successful.
400         Request error.
401         Authentication failed.
404         The image does not exist.
500         Internal error.
=========== =========================