Merge pull request camaraproject#550 from tlohmar/new_409_error_code

New 409 error code called INCOMPATIBLE_STATE

Author: rartych

artifacts/CAMARA_common.yaml

@@ -484,6 +484,7 @@ components:
                       - ABORTED
                       - ALREADY_EXISTS
                       - CONFLICT
+                      - INCOMPATIBLE_STATE
                       - "{{SPECIFIC_CODE}}"
           examples:
             GENERIC_409_ABORTED:
@@ -504,6 +505,12 @@ components:
                 status: 409
                 code: CONFLICT
                 message: A specified resource duplicate entry found.
+            GENERIC_409_INCOMPATIBLE_STATE:
+              description: A resource referenced in the request is in an incompatible state for the requested operation
+              value:
+                status: 409
+                code: INCOMPATIBLE_STATE
+                message: A referenced resource is in an incompatible state.                
             GENERIC_409_{{SPECIFIC_CODE}}:
               description: Specific conflict situation that is relevant in the context of the API
               value:

documentation/CAMARA-API-Design-Guide.md

@@ -278,6 +278,8 @@ In the following, we elaborate on the existing client errors. In particular, we
 |       409        |        `ABORTED`        | Concurrency conflict.                                               | Concurrency of processes of the same nature/scope                                                                               |
 |       409        |    `ALREADY_EXISTS`     | The resource that a client tried to create already exists.          | Trying to create an existing resource                                                                                           |
 |       409        |       `CONFLICT`        | A specified resource duplicate entry found.                         | Duplication of an existing resource                                                                                             |
+|       409        |       `INCOMPATIBLE_STATE`     | A referenced resource is in an incompatible state. | A resource referenced in the request is in an incompatible state for the requested operation                                                                                             |
+
 |       409        |   `{{SPECIFIC_CODE}}`   | `{{SPECIFIC_CODE_MESSAGE}}`                                         | Specific conflict situation that is relevant in the context of the API                                                          |
 
 <font size="3"><span style="color: blue"> Service Exceptions </span></font>