Merge pull request #513 from admin-shell-io/SeBa/fix-PutAssetAdministrationShellById

Add Parameter "id" and a new Note to PutAssetAdministrationShellById

Author: BirgitBoss

documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc

@@ -19,6 +19,7 @@ Major Changes:
 
 Minor Changes:
 
+* ...
 * Added the `ServerNotImplemented` status code to the xref:specification/interfaces-payload.adoc#table-status-codes[Status Codes]. Note that the HTTP API mentioned this status code already, therefore, no change in OpenAPI or other related files. (https://github.com/admin-shell-io/aas-specs-api/issues/499[#499])
 
 
@@ -29,6 +30,7 @@ Minor Changes:
 |===
 h|Operation  h|Kind of Change h|Comment
 
+ | PutAssetAdministrationShellById|change a| Added the missing `id` input parameter and a note explaining the behavior in case the AAS identifier does not match the value of `id`. (https://github.com/admin-shell-io/aas-specs-api/issues/506[#506])
 
 |===
 

documentation/IDTA-01002-3/modules/ROOT/pages/specification/interfaces.adoc

@@ -1331,8 +1331,12 @@ h|semanticId 4+|`\https://admin-shell.io/aas/API/PutAssetAdministrationShellById
 
 h|Name h|Description h|Mand. h|Type h|Card.
 5+h|Input Parameter
+|id |The Asset Administration Shell’s unique ID |yes |link:https://industrialdigitaltwin.io/aas-specifications/IDTA-01001/v3.1/spec-metamodel/datatypes.html#Identifier[Identifier] |1
 |aas |Asset Administration Shell object |yes |link:https://industrialdigitaltwin.io/aas-specifications/IDTA-01001/v3.1/spec-metamodel/core.html#AssetAdministrationShell[AssetAdministrationShell] |1
 5+h|Output Parameter
+====
+Note: The `id` of the contained Asset Administration Shell object has to be exactly the same as in the `id` input parameter. A server shall respond with a `ClientErrorBadRequest` otherwise.
+====
 |statusCode |Status code |yes |xref:specification/interfaces-payload.adoc#StatusCode[StatusCode] |1
 |payload |Replaced Asset Administration Shell | no |link:https://industrialdigitaltwin.io/aas-specifications/IDTA-01001/v3.1/spec-metamodel/core.html#AssetAdministrationShell[AssetAdministrationShell] |1
 |===