Add optional conditional requests (ETag, If-Match, If-None-Match)

AasxFileServerServiceSpecification/V3.2_SSP-001.yaml

@@ -125,6 +125,8 @@ paths:
       operationId: GetAASXByPackageId
       x-semanticIds:
         - https://admin-shell.io/aas/API/GetAASXByPackageId/3/2
+      parameters:
+        - $ref: '../Part2-API-Schemas/openapi.yaml#/components/parameters/IfNoneMatch'
       responses:
         '200':
           description: Requested AASX package
@@ -133,11 +135,15 @@ paths:
               schema:
                 type: string
               description: Filename of the package
+            ETag:
+              $ref: '../Part2-API-Schemas/openapi.yaml#/components/headers/ETag'
           content:
             application/asset-administration-shell-package:
               schema:
                 type: string
                 format: binary
+        '304':
+          $ref: '../Part2-API-Schemas/openapi.yaml#/components/responses/not-modified'
         '400':
           $ref: '../Part2-API-Schemas/openapi.yaml#/components/responses/bad-request'
         '401':
@@ -180,6 +186,9 @@ paths:
               file:
                 contentType: application/asset-administration-shell-package
         required: true
+      parameters:
+        - $ref: '../Part2-API-Schemas/openapi.yaml#/components/parameters/IfMatch'
+        - $ref: '../Part2-API-Schemas/openapi.yaml#/components/parameters/IfNoneMatch'
       responses:
         '201':
           description: AASX package stored successfully
@@ -200,6 +209,8 @@ paths:
           $ref: '../Part2-API-Schemas/openapi.yaml#/components/responses/unauthorized'
         '403':
           $ref: '../Part2-API-Schemas/openapi.yaml#/components/responses/forbidden'
+        '412':
+          $ref: '../Part2-API-Schemas/openapi.yaml#/components/responses/precondition-failed'
         '500':
           $ref: '../Part2-API-Schemas/openapi.yaml#/components/responses/internal-server-error'
         default:
@@ -211,6 +222,8 @@ paths:
       operationId: DeleteAASXByPackageId
       x-semanticIds:
         - https://admin-shell.io/aas/API/DeleteAASXByPackageId/3/2
+      parameters:
+        - $ref: '../Part2-API-Schemas/openapi.yaml#/components/parameters/IfMatch'
       responses:
         '204':
           description: Deleted successfully
@@ -222,6 +235,8 @@ paths:
           $ref: '../Part2-API-Schemas/openapi.yaml#/components/responses/forbidden'
         '404':
           $ref: '../Part2-API-Schemas/openapi.yaml#/components/responses/not-found'
+        '412':
+          $ref: '../Part2-API-Schemas/openapi.yaml#/components/responses/precondition-failed'
         '500':
           $ref: '../Part2-API-Schemas/openapi.yaml#/components/responses/internal-server-error'
         default:

AssetAdministrationShellRegistryServiceSpecification/V3.2_SSP-001.yaml

@@ -101,13 +101,19 @@ paths:
           explode: false
           schema:
             type: string
+        - $ref: '../Part2-API-Schemas/openapi.yaml#/components/parameters/IfNoneMatch'
       responses:
         '200':
           description: Requested Asset Administration Shell Descriptor
+          headers:
+            ETag:
+              $ref: '../Part2-API-Schemas/openapi.yaml#/components/headers/ETag'
           content:
             application/json:
               schema:
                 $ref: '../Part2-API-Schemas/openapi.yaml#/components/schemas/AssetAdministrationShellDescriptor'
+        '304':
+          $ref: '../Part2-API-Schemas/openapi.yaml#/components/responses/not-modified'
         '400':
           $ref: '../Part2-API-Schemas/openapi.yaml#/components/responses/bad-request'
         '403':
@@ -134,6 +140,8 @@ paths:
           explode: false
           schema:
             type: string
+        - $ref: '../Part2-API-Schemas/openapi.yaml#/components/parameters/IfMatch'
+        - $ref: '../Part2-API-Schemas/openapi.yaml#/components/parameters/IfNoneMatch'
       requestBody:
         description: Asset Administration Shell Descriptor object
         content:
@@ -159,6 +167,8 @@ paths:
           $ref: '../Part2-API-Schemas/openapi.yaml#/components/responses/bad-request'
         '403':
           $ref: '../Part2-API-Schemas/openapi.yaml#/components/responses/forbidden'
+        '412':
+          $ref: '../Part2-API-Schemas/openapi.yaml#/components/responses/precondition-failed'
         '500':
           $ref: '../Part2-API-Schemas/openapi.yaml#/components/responses/internal-server-error'    
         default:
@@ -179,13 +189,16 @@ paths:
           explode: false
           schema:
             type: string
+        - $ref: '../Part2-API-Schemas/openapi.yaml#/components/parameters/IfMatch'
       responses:
         '204':
           description: Asset Administration Shell Descriptor deleted successfully
         '400':
           $ref: '../Part2-API-Schemas/openapi.yaml#/components/responses/bad-request'
         '404':
           $ref: '../Part2-API-Schemas/openapi.yaml#/components/responses/not-found'
+        '412':
+          $ref: '../Part2-API-Schemas/openapi.yaml#/components/responses/precondition-failed'
         '500':
           $ref: '../Part2-API-Schemas/openapi.yaml#/components/responses/internal-server-error'    
         default:
@@ -234,6 +247,8 @@ paths:
             schema:
               $ref: '../Part2-API-Schemas/openapi.yaml#/components/schemas/SubmodelDescriptor'
         required: true
+      parameters:
+        - $ref: '../Part2-API-Schemas/openapi.yaml#/components/parameters/IfMatch'
       responses:
         '201':
           description: Submodel Descriptor created successfully
@@ -242,6 +257,8 @@ paths:
               description: URL of the newly created resource
               schema:
                 type: string
+            ETag:
+              $ref: '../Part2-API-Schemas/openapi.yaml#/components/headers/ETag'
           content:
             application/json:
               schema:
@@ -254,6 +271,8 @@ paths:
           $ref: '../Part2-API-Schemas/openapi.yaml#/components/responses/not-found'
         '409':
           $ref: '../Part2-API-Schemas/openapi.yaml#/components/responses/conflict'
+        '412':
+          $ref: '../Part2-API-Schemas/openapi.yaml#/components/responses/precondition-failed'
         '500':
           $ref: '../Part2-API-Schemas/openapi.yaml#/components/responses/internal-server-error'    
         default:
@@ -269,13 +288,20 @@ paths:
       operationId: GetSubmodelDescriptorByIdThroughSuperpath
       x-semanticIds:
         - https://admin-shell.io/aas/API/GetSubmodelDescriptorById/3/2
+      parameters:
+        - $ref: '../Part2-API-Schemas/openapi.yaml#/components/parameters/IfNoneMatch'
       responses:
         '200':
           description: Requested Submodel Descriptor
+          headers:
+            ETag:
+              $ref: '../Part2-API-Schemas/openapi.yaml#/components/headers/ETag'
           content:
             application/json:
               schema:
                 $ref: '../Part2-API-Schemas/openapi.yaml#/components/schemas/SubmodelDescriptor'
+        '304':
+          $ref: '../Part2-API-Schemas/openapi.yaml#/components/responses/not-modified'
         '400':
           $ref: '../Part2-API-Schemas/openapi.yaml#/components/responses/bad-request'
         '403':
@@ -300,6 +326,9 @@ paths:
             schema:
               $ref: '../Part2-API-Schemas/openapi.yaml#/components/schemas/SubmodelDescriptor'
         required: true
+      parameters:
+        - $ref: '../Part2-API-Schemas/openapi.yaml#/components/parameters/IfMatch'
+        - $ref: '../Part2-API-Schemas/openapi.yaml#/components/parameters/IfNoneMatch'
       responses:
         '201':
           description: Submodel Descriptor created successfully
@@ -320,6 +349,8 @@ paths:
           $ref: '../Part2-API-Schemas/openapi.yaml#/components/responses/forbidden'
         '404':
           $ref: '../Part2-API-Schemas/openapi.yaml#/components/responses/not-found'
+        '412':
+          $ref: '../Part2-API-Schemas/openapi.yaml#/components/responses/precondition-failed'
         '500':
           $ref: '../Part2-API-Schemas/openapi.yaml#/components/responses/internal-server-error'    
         default:
@@ -331,13 +362,17 @@ paths:
       operationId: DeleteSubmodelDescriptorByIdThroughSuperpath
       x-semanticIds:
         - https://admin-shell.io/aas/API/DeleteSubmodelDescriptorById/3/2
+      parameters:
+        - $ref: '../Part2-API-Schemas/openapi.yaml#/components/parameters/IfMatch'
       responses:
         '204':
           description: Submodel Descriptor deleted successfully
         '400':
           $ref: '../Part2-API-Schemas/openapi.yaml#/components/responses/bad-request'
         '404':
           $ref: '../Part2-API-Schemas/openapi.yaml#/components/responses/not-found'
+        '412':
+          $ref: '../Part2-API-Schemas/openapi.yaml#/components/responses/precondition-failed'
         '500':
           $ref: '../Part2-API-Schemas/openapi.yaml#/components/responses/internal-server-error'    
         default:

AssetAdministrationShellRegistryServiceSpecification/V3.2_SSP-002.yaml

@@ -65,13 +65,19 @@ paths:
           explode: false
           schema:
             type: string
+        - $ref: '../Part2-API-Schemas/openapi.yaml#/components/parameters/IfNoneMatch'
       responses:
         '200':
           description: Requested Asset Administration Shell Descriptor
+          headers:
+            ETag:
+              $ref: '../Part2-API-Schemas/openapi.yaml#/components/headers/ETag'
           content:
             application/json:
               schema:
                 $ref: '../Part2-API-Schemas/openapi.yaml#/components/schemas/AssetAdministrationShellDescriptor'
+        '304':
+          $ref: '../Part2-API-Schemas/openapi.yaml#/components/responses/not-modified'
         '400':
           $ref: '../Part2-API-Schemas/openapi.yaml#/components/responses/bad-request'
         '403':
@@ -123,13 +129,20 @@ paths:
       operationId: GetSubmodelDescriptorByIdThroughSuperpath
       x-semanticIds:
         - https://admin-shell.io/aas/API/GetSubmodelDescriptorById/3/2
+      parameters:
+        - $ref: '../Part2-API-Schemas/openapi.yaml#/components/parameters/IfNoneMatch'
       responses:
         '200':
           description: Requested Submodel Descriptor
+          headers:
+            ETag:
+              $ref: '../Part2-API-Schemas/openapi.yaml#/components/headers/ETag'
           content:
             application/json:
               schema:
                 $ref: '../Part2-API-Schemas/openapi.yaml#/components/schemas/SubmodelDescriptor'
+        '304':
+          $ref: '../Part2-API-Schemas/openapi.yaml#/components/responses/not-modified'
         '400':
           $ref: '../Part2-API-Schemas/openapi.yaml#/components/responses/bad-request'
         '403':

AssetAdministrationShellRegistryServiceSpecification/V3.2_SSP-005.yaml

@@ -65,13 +65,19 @@ paths:
           explode: false
           schema:
             type: string
+        - $ref: '../Part2-API-Schemas/openapi.yaml#/components/parameters/IfNoneMatch'
       responses:
         '200':
           description: Requested Asset Administration Shell Descriptor
+          headers:
+            ETag:
+              $ref: '../Part2-API-Schemas/openapi.yaml#/components/headers/ETag'
           content:
             application/json:
               schema:
                 $ref: '../Part2-API-Schemas/openapi.yaml#/components/schemas/AssetAdministrationShellDescriptor'
+        '304':
+          $ref: '../Part2-API-Schemas/openapi.yaml#/components/responses/not-modified'
         '400':
           $ref: '../Part2-API-Schemas/openapi.yaml#/components/responses/bad-request'
         '403':