update the UCS api yaml

Reviewed-by: Sidelnikov, Anton <a.sidelnikov@t-systems.com>
Co-authored-by: Hasko, Vladimir <vladimir.hasko@t-systems.com>
Co-committed-by: Hasko, Vladimir <vladimir.hasko@t-systems.com>

.gitea/workflows/openapi.yml

@@ -43,40 +43,22 @@ jobs:
           git fetch origin $BASE_SHA
           echo "changed_files=$(git diff --name-only ${BASE_SHA}...HEAD | grep -E '^docs/[^/]+/openapi/.*\.(yaml|yml)$' | xargs)" >> $GITHUB_OUTPUT
 
-      - name: List changed files
-        run: |
-          for file in ${{ steps.changed-files.outputs.changed_files }}; do
-            echo "$file was changed"
-          done
-
-      - name: Get changed OpenAPI files (branch URLs)
+      - name: Get commit SHA and build file URLs
         id: changed-urls
         run: |
-          BASE_SHA="${{ gitea.event.pull_request.base.sha }}"
-          git fetch origin $BASE_SHA
-
-          # Use PR branch if available, otherwise push branch
-          BRANCH="${{ gitea.head_ref }}"
-          if [ -z "$BRANCH" ]; then
-            BRANCH="${{ gitea.ref_name }}"
+          # Determine the HEAD SHA to use for URL construction
+          if [ -n "${{ gitea.event.pull_request.head.sha }}" ]; then
+            HEAD_SHA="${{ gitea.event.pull_request.head.sha }}"
+          else
+            HEAD_SHA="${{ gitea.sha }}"
           fi
 
           REPO_URL="${{ gitea.server_url }}/${{ gitea.repository }}"
 
-          # Only docs/*/openapi/*.yaml or yml
-          # FILES=$(git diff --name-only ${BASE_SHA}...HEAD \
-          #   | grep -E '^docs/[^/]+/openapi/.*\.(yaml|yml)$' || true)
-
-          echo "changed urls"
-
-          for file in ${{ steps.changed-files.outputs.changed_files }}; do
-            echo "$REPO_URL/raw/branch/$BRANCH/$file"
-          done
-          
           echo "changed_urls<<EOF" >> $GITHUB_OUTPUT
 
           for file in ${{ steps.changed-files.outputs.changed_files }}; do
-            echo "$REPO_URL/raw/branch/$BRANCH/$file"
+            echo "$REPO_URL/src/commit/$HEAD_SHA/$file"
           done >> $GITHUB_OUTPUT
 
           echo "EOF" >> $GITHUB_OUTPUT
@@ -103,14 +85,14 @@ jobs:
           OPENAPI_TOKEN="$(curl -X POST "https://${API_URL}/api/token/machine" \
               -H "X-Internal-Api-Key: $INTERNAL_OPENAPI_KEY" | jq -r .access_token)"
           echo "::add-mask::$OPENAPI_TOKEN"
-          
+
           while IFS= read -r url; do
             [ -z "$url" ] && continue
 
             echo "=============================="
             echo "Validating: $url"
 
-            # --- 1. trigger validation using file_content ---
+            # --- 1. trigger validation using commit-based URL ---
             VALIDATION_RESPONSE=$(curl -sS -X POST "https://${API_URL}/api/validate" \
               -H "Content-Type: application/json" \
               -H "Authorization: Bearer $OPENAPI_TOKEN" \
@@ -177,7 +159,7 @@ jobs:
 
             # fallback if API doesn't return UI link
             REPORT_URL="https://${REPORTPORTAL_URL}/ui/#openapi/launches/all/$LAUNCH_ID"
-            
+
             # --- 5. summary ---
             echo ""
             echo "📊 Validation summary"

docs/taurusdb/umn/en-us_topic_0000002521462469.html

@@ -18,9 +18,9 @@
 </table>
 </div>
 </div>
-<div class="section" id="EN-US_TOPIC_0000002521462469__en-us_topic_0000002009238626_section1351019822913"><h4 class="sectiontitle">Constraints</h4><p id="EN-US_TOPIC_0000002521462469__en-us_topic_0000002009238626_p4303131342914">Collecting abnormal snapshots will cause about 5% of instance performance loss.</p>
+<div class="section" id="EN-US_TOPIC_0000002521462469__en-us_topic_0000002009238626_section1351019822913"><h4 class="sectiontitle">Constraints</h4><p id="EN-US_TOPIC_0000002521462469__en-us_topic_0000002009238626_p4303131342914">Collecting anomaly snapshots will cause about 5% of instance performance loss.</p>
 </div>
-<div class="section" id="EN-US_TOPIC_0000002521462469__en-us_topic_0000002009238626_section8871312173416"><h4 class="sectiontitle">Procedure</h4><ol id="EN-US_TOPIC_0000002521462469__en-us_topic_0000002009238626_ol14861938171620"><li id="EN-US_TOPIC_0000002521462469__en-us_topic_0000002009238626_li20781201244718"><span>Log in to the management console.</span></li><li id="EN-US_TOPIC_0000002521462469__en-us_topic_0000002009238626_li1178113129471"><span>Click <span><img id="EN-US_TOPIC_0000002521462469__en-us_topic_0000002518288963_en-us_topic_0179843894_image192529212293" src="en-us_image_0000002518409421.png"></span> in the upper left corner and select a region and project.</span></li><li id="EN-US_TOPIC_0000002521462469__en-us_topic_0000002009238626_li1878271212473"><span>Click <span><img id="EN-US_TOPIC_0000002521462469__en-us_topic_0000002518288963_en-us_topic_0179843894_image280016113225" src="en-us_image_0000002486209558.png"></span> in the upper left corner of the page and choose <strong id="EN-US_TOPIC_0000002521462469__en-us_topic_0000002518288963_b157244310216">Databases</strong> &gt; <strong id="EN-US_TOPIC_0000002521462469__en-us_topic_0000002518288963_b135721243182114">TaurusDB</strong>.</span></li><li id="EN-US_TOPIC_0000002521462469__en-us_topic_0000002009238626_en-us_topic_0000001615182888_en-us_topic_0000001321889334_li1426913204172"><span>On the <strong id="EN-US_TOPIC_0000002521462469__en-us_topic_0000002009238626_b6878931111417">Instances</strong> page, click the instance name.</span></li><li id="EN-US_TOPIC_0000002521462469__en-us_topic_0000002009238626_en-us_topic_0000001615182888_en-us_topic_0000001321889334_li499974911328"><span>In the navigation pane, choose <strong id="EN-US_TOPIC_0000002521462469__en-us_topic_0000002009238626_b177461934142616">DBA Assistant</strong> &gt; <strong id="EN-US_TOPIC_0000002521462469__en-us_topic_0000002009238626_b187471534152611">Historical Diagnosis</strong>.</span></li><li id="EN-US_TOPIC_0000002521462469__en-us_topic_0000002009238626_li1831331143515"><span>Click <span class="uicontrol" id="EN-US_TOPIC_0000002521462469__en-us_topic_0000002009238626_uicontrol753120103611"><b>Anomaly Snapshots</b></span>.</span></li><li id="EN-US_TOPIC_0000002521462469__en-us_topic_0000002009238626_li2791198371"><span>Click <span><img id="EN-US_TOPIC_0000002521462469__en-us_topic_0000002009238626_image4684554103818" src="en-us_image_0000002527170671.png"></span> on the right of <span class="uicontrol" id="EN-US_TOPIC_0000002521462469__en-us_topic_0000002009238626_uicontrol67458303561"><b>Collect Abnormal Snapshots</b></span> to enable anomaly diagnosis.</span><p><p id="EN-US_TOPIC_0000002521462469__en-us_topic_0000002009238626_p197259149457">After anomaly diagnosis is enabled, if any anomaly listed in <a href="#EN-US_TOPIC_0000002521462469__en-us_topic_0000002009238626_table9521791237">Table 1</a> occurs, you can view its snapshots. Anomaly snapshot records are retained for seven days and will be deleted after this time expires. A maximum of 100 records can be retained for a single node.</p>
+<div class="section" id="EN-US_TOPIC_0000002521462469__en-us_topic_0000002009238626_section8871312173416"><h4 class="sectiontitle">Procedure</h4><ol id="EN-US_TOPIC_0000002521462469__en-us_topic_0000002009238626_ol14861938171620"><li id="EN-US_TOPIC_0000002521462469__en-us_topic_0000002009238626_li20781201244718"><span>Log in to the management console.</span></li><li id="EN-US_TOPIC_0000002521462469__en-us_topic_0000002009238626_li1178113129471"><span>Click <span><img id="EN-US_TOPIC_0000002521462469__en-us_topic_0000002518288963_en-us_topic_0179843894_image192529212293" src="en-us_image_0000002518409421.png"></span> in the upper left corner and select a region and project.</span></li><li id="EN-US_TOPIC_0000002521462469__en-us_topic_0000002009238626_li1878271212473"><span>Click <span><img id="EN-US_TOPIC_0000002521462469__en-us_topic_0000002518288963_en-us_topic_0179843894_image280016113225" src="en-us_image_0000002486209558.png"></span> in the upper left corner of the page and choose <strong id="EN-US_TOPIC_0000002521462469__en-us_topic_0000002518288963_b157244310216">Databases</strong> &gt; <strong id="EN-US_TOPIC_0000002521462469__en-us_topic_0000002518288963_b135721243182114">TaurusDB</strong>.</span></li><li id="EN-US_TOPIC_0000002521462469__en-us_topic_0000002009238626_en-us_topic_0000001615182888_en-us_topic_0000001321889334_li1426913204172"><span>On the <strong id="EN-US_TOPIC_0000002521462469__en-us_topic_0000002009238626_b6878931111417">Instances</strong> page, click the instance name.</span></li><li id="EN-US_TOPIC_0000002521462469__en-us_topic_0000002009238626_en-us_topic_0000001615182888_en-us_topic_0000001321889334_li499974911328"><span>In the navigation pane, choose <strong id="EN-US_TOPIC_0000002521462469__en-us_topic_0000002009238626_b177461934142616">DBA Assistant</strong> &gt; <strong id="EN-US_TOPIC_0000002521462469__en-us_topic_0000002009238626_b187471534152611">Historical Diagnosis</strong>.</span></li><li id="EN-US_TOPIC_0000002521462469__en-us_topic_0000002009238626_li1831331143515"><span>Click <span class="uicontrol" id="EN-US_TOPIC_0000002521462469__en-us_topic_0000002009238626_uicontrol753120103611"><b>Anomaly Snapshots</b></span>.</span></li><li id="EN-US_TOPIC_0000002521462469__en-us_topic_0000002009238626_li2791198371"><span>Click <span><img id="EN-US_TOPIC_0000002521462469__en-us_topic_0000002009238626_image4684554103818" src="en-us_image_0000002527170671.png"></span> on the right of <span class="uicontrol" id="EN-US_TOPIC_0000002521462469__en-us_topic_0000002009238626_uicontrol67458303561"><b>Anomaly Collection</b></span> to enable anomaly diagnosis.</span><p><p id="EN-US_TOPIC_0000002521462469__en-us_topic_0000002009238626_p197259149457">After anomaly diagnosis is enabled, if any anomaly listed in <a href="#EN-US_TOPIC_0000002521462469__en-us_topic_0000002009238626_table9521791237">Table 1</a> occurs, you can view its snapshots. Anomaly snapshot records are retained for seven days and will be deleted after this time expires. A maximum of 100 records can be retained for a single node.</p>
 <p id="EN-US_TOPIC_0000002521462469__en-us_topic_0000002009238626_p4161815457">Click <span class="uicontrol" id="EN-US_TOPIC_0000002521462469__en-us_topic_0000002009238626_uicontrol3272103320457"><b>Diagnosis Details</b></span> in the <strong id="EN-US_TOPIC_0000002521462469__en-us_topic_0000002009238626_b421611473416">Operation</strong> column to view diagnosis result details and optimization suggestions.</p>
 <p id="EN-US_TOPIC_0000002521462469__en-us_topic_0000002009238626_p16316859114914">Click the <strong id="EN-US_TOPIC_0000002521462469__en-us_topic_0000002009238626_b957613586510">Anomaly Snapshots</strong> tab to view session snapshots, metadata lock snapshots, InnoDB lock snapshots, and transaction snapshots.</p>
 </p></li></ol>