Deprecate GetAllAssetAdministrationShellIdsByAssetLink (#376)

* Deprecate GetAllAssetAdministrationShellIdsByAssetLink 

* Deprecate GetAllAssetAdministrationShellIdsByAssetLink in interface definition

* Add SearchAllAssetAdministrationShellIdsByAssetLink in interface definition

* Added AssetLink class

* Update link for AssetLink

---------

Co-authored-by: sebbader-sap <[email protected]>

Author: juileetikekar

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

@@ -260,6 +260,21 @@ a|TLSA according to RFC 6698
 a|Decentralized Identifiers according to the W3C Recommendation xref:bibliography.adoc#bib7[[7\]]
 |===
 
+=== AssetLink
+
+[.table-with-appendix-table]
+[cols="25%,40%,25%,10%"]
+|===
+h|Class Name 3+e|[[AssetLink]]AssetLink
+h|Explanation 3+a|Asset identifier derieved from either SpecificAssetId or GlobalAssetId
+h|Inherits from 3+|-
+h|semanticId 3+|`\https://admin-shell.io/aas/API/DataTypes/AssetLink/3/1`
+
+h|Attribute h|Explanation h| Type h|Card.
+e|name |Name of the Asset identifier, i.e., "globalAssetId", a serial number, manufacturer part ID, or customer part IDs | link:https://admin-shell-io.github.io/aas-specs-antora/IDTA-01001/v3.1/spec-metamodel/datatypes.html#LabelType[LabelType] |1
+e|value |Value of the Asset Identifier |  link:https://admin-shell-io.github.io/aas-specs-antora/IDTA-01001/v3.1/spec-metamodel/datatypes.html#Identifier[Identifier] |1
+|===
+
 [#service-description]
 === ServiceDescription
 

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

@@ -1812,7 +1812,7 @@ e| xref:DeleteAllAssetLinksById[DeleteAllAssetLinksById]  |Deletes all asset ide
 [.table-with-appendix-table]
 [width=100%,cols="25%,35%,10%,20%,10%"]
 |===
-h|Operation Name 4+e|[[GetAllAssetAdministrationShellIdsByAssetLink]]GetAllAssetAdministrationShellIdsByAssetLink
+h|Operation Name 4+e|[[GetAllAssetAdministrationShellIdsByAssetLink]]GetAllAssetAdministrationShellIdsByAssetLink \<<Deprecated>>
 h|Explanation 4+a|Returns a list of Asset Administration Shell ids based on asset identifier key-value-pairs
 h|semanticId 4+|`\https://admin-shell.io/aas/API/GetAllAssetAdministrationShellIdsByAssetLink/3/1`
 
@@ -1864,6 +1864,34 @@ It is the predefined name “_globalAssetId_” that would refer to the _AssetIn
 |no |link:https://admin-shell-io.github.io/aas-specs-antora/IDTA-01001/v3.1/spec-metamodel/core.html#SpecificAssetId[SpecificAssetId] |1..*
 |===
 
+==== Operation SearchAllAssetAdministrationShellIdsByAssetLink
+
+[.table-with-appendix-table]
+[width=100%,cols="25%,35%,10%,20%,10%"]
+|===
+h|Operation Name 4+e|[[SearchAllAssetAdministrationShellIdsByAssetLink]]SearchAllAssetAdministrationShellIdsByAssetLink
+h|Explanation 4+a|Returns a list of Asset Administration Shell IDs linked to specific asset identifiers or the global asset ID
+h|semanticId 4+|`https://admin-shell.io/aas/API/SearchAllAssetAdministrationShellIdsByAssetLink/3/1`
+
+h|Name h|Description h|Mand. h|Type h|Card.
+5+h|Input Parameter
+|assetLinks a|
+A list of AssetLinks that all shall match. An AssetLink might be either derived from a SpecificAssetId ("name": "<specificAssetId.name>", "value": "<specificAssetId.value>") or a globalAssetId ("name": "globalAssetId", "value": "<globalAssetId-value>"). 
+
+====
+Note: The name for the globalAssetId is defined in Contraint AASd-116 in IDTA-0001.
+It is the predefined key “_globalAssetId_” that would refer to the _AssetInformation/globalAssetId_.
+====
+
+
+|yes |link:https://admin-shell-io.github.io/aas-specs-antora/IDTA-01002/v3.1/specification/interfaces-payload.html#AssetLink[AssetLink] |1..*
+|limit |The maximum size of the result set |no |nonNegativeInteger |1
+|cursor |The position from which to resume a result listing |no |string |1
+5+h|Output Parameter
+|statusCode |Status code |yes |xref:specification/interfaces-payload.adoc#StatusCode[StatusCode] |1
+|payload |Identifiers of all Asset Administration Shells which contain all asset identifier key-value-pairs in their asset information, i.e. AND-match of key-value-pairs per Asset Administration Shell |no |link:https://admin-shell-io.github.io/aas-specs-antora/IDTA-01001/v3.1/spec-metamodel/datatypes.html#Identifier[Identifier] |1..*
+|===
+
 ==== Operation PostAllAssetLinksById
 
 [.table-with-appendix-table]