Changes to ccn_api-ref from docs/doc-exports#1451 (CCN API 20250121 version)

Reviewed-by: Hajba, László Antal <laszlo-antal.hajba@t-systems.com> Co-authored-by: OpenTelekomCloud Proposal Bot <proposalbot@otc-service.com> Co-committed-by: OpenTelekomCloud Proposal Bot <proposalbot@otc-service.com>
2026-01-29 15:26:58 +00:00
parent b6e0030d26
commit 78ec06e743
42 changed files with 6944 additions and 3 deletions
--- a/api-ref/source/appendix/obtaining_a_project_id.rst
+++ b/api-ref/source/appendix/obtaining_a_project_id.rst
@ -0,0 +1,72 @@
+:original_name: cc_01_0027.html
+
+.. _cc_01_0027:
+
+Obtaining a Project ID
+======================
+
+Scenarios
+---------
+
+A project ID is required for some URLs when an API is called. Therefore, you need to obtain a project ID in advance. Two methods are available:
+
+-  :ref:`Obtain the Project ID by Calling an API <cc_01_0027__en-us_topic_0121673684_section86806471133>`
+-  :ref:`Obtain the Project ID from the Console <cc_01_0027__en-us_topic_0121673684_section32975495318>`
+
+.. _cc_01_0027__en-us_topic_0121673684_section86806471133:
+
+Obtain the Project ID by Calling an API
+---------------------------------------
+
+You can obtain the project ID by calling the IAM API used to query project information based on the specified criteria.
+
+The API used to obtain a project ID is GET https://{Endpoint}/v3/projects. {Endpoint} is the IAM endpoint and can be obtained from `Regions and Endpoints <https://docs.otc.t-systems.com/regions-and-endpoints/index.html>`__.
+
+The following is an example response. The value of **id** is the project ID.
+
+.. code-block::
+
+   {
+       "projects": [
+           {
+               "domain_id": "65ewtrgaggshhk1223245sghjlse684b",
+               "is_domain": false,
+               "parent_id": "65ewtrgaggshhk1223245sghjlse684b",
+               "name": "project_name",
+               "description": "",
+               "links": {
+                   "next": null,
+                   "previous": null,
+                   "self": "https://www.example.com/v3/projects/a4adasfjljaaaakla12334jklga9sasfg"
+               },
+               "id": "a4adasfjljaaaakla12334jklga9sasfg",
+               "enabled": true
+           }
+       ],
+       "links": {
+           "next": null,
+           "previous": null,
+           "self": "https://www.example.com/v3/projects"
+       }
+   }
+
+.. _cc_01_0027__en-us_topic_0121673684_section32975495318:
+
+Obtain a Project ID from the Console
+------------------------------------
+
+A project ID needs to be specified in the URIs of some APIs. Therefore, you need to obtain the project ID before calling APIs. The following procedure describes how to obtain a project ID:
+
+#. Log in to the management console.
+
+#. Click the username and select **My Credentials** from the drop-down list.
+
+   On the **My Credentials** page, view project IDs in the project list.
+
+
+   .. figure:: /_static/images/en-us_image_0000001508295281.png
+      :alt: **Figure 1** Viewing project IDs
+
+      **Figure 1** Viewing project IDs
+
+   In multi-project scenarios, expand the region, and obtain your sub-project ID from the **Project ID** column.