diff --git a/AssetAdministrationShellRepositoryServiceSpecification/V3.2_SSP-001.yaml b/AssetAdministrationShellRepositoryServiceSpecification/V3.2_SSP-001.yaml index afc7a9c8..6c8d5ec8 100644 --- a/AssetAdministrationShellRepositoryServiceSpecification/V3.2_SSP-001.yaml +++ b/AssetAdministrationShellRepositoryServiceSpecification/V3.2_SSP-001.yaml @@ -130,6 +130,8 @@ paths: operationId: GetAssetAdministrationShellById x-semanticIds: - https://admin-shell.io/aas/API/GetAssetAdministrationShellById/3/2 + parameters: + - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/parameters/Date' responses: '200': description: Requested Asset Administration Shell @@ -505,6 +507,7 @@ paths: parameters: - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/parameters/Level' - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/parameters/Extent' + - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/parameters/Date' responses: '200': description: Requested Submodel @@ -700,6 +703,7 @@ paths: parameters: - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/parameters/Level' - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/parameters/Extent' + - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/parameters/Date' responses: '200': description: Requested Submodel diff --git a/AssetAdministrationShellRepositoryServiceSpecification/V3.2_SSP-002.yaml b/AssetAdministrationShellRepositoryServiceSpecification/V3.2_SSP-002.yaml index 31f26a60..39280b57 100644 --- a/AssetAdministrationShellRepositoryServiceSpecification/V3.2_SSP-002.yaml +++ b/AssetAdministrationShellRepositoryServiceSpecification/V3.2_SSP-002.yaml @@ -92,6 +92,8 @@ paths: operationId: GetAssetAdministrationShellById x-semanticIds: - https://admin-shell.io/aas/API/GetAssetAdministrationShellById/3/2 + parameters: + - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/parameters/Date' responses: '200': description: Requested Asset Administration Shell @@ -244,6 +246,7 @@ paths: parameters: - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/parameters/Level' - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/parameters/Extent' + - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/parameters/Date' responses: '200': description: Requested Submodel @@ -307,6 +310,7 @@ paths: parameters: - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/parameters/Level' - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/parameters/Extent' + - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/parameters/Date' responses: '200': description: Requested Submodel diff --git a/Entire-API-Collection/V3.2.yaml b/Entire-API-Collection/V3.2.yaml index c0f9de15..9ace92f0 100644 --- a/Entire-API-Collection/V3.2.yaml +++ b/Entire-API-Collection/V3.2.yaml @@ -344,6 +344,7 @@ paths: parameters: - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/parameters/Level' - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/parameters/Extent' + - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/parameters/Date' responses: '200': description: Requested Submodel @@ -548,6 +549,7 @@ paths: parameters: - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/parameters/Level' - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/parameters/Extent' + - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/parameters/Date' responses: '200': description: Requested Submodel @@ -2956,6 +2958,8 @@ paths: operationId: GetAssetAdministrationShellById x-semanticIds: - https://admin-shell.io/aas/API/GetAssetAdministrationShellById/3/2 + parameters: + - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/parameters/Date' responses: '200': description: Requested Asset Administration Shell @@ -3331,6 +3335,7 @@ paths: parameters: - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/parameters/Level' - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/parameters/Extent' + - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/parameters/Date' responses: '200': description: Requested Submodel @@ -3527,6 +3532,7 @@ paths: parameters: - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/parameters/Level' - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/parameters/Extent' + - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/parameters/Date' responses: '200': description: Requested Submodel @@ -4852,6 +4858,7 @@ paths: parameters: - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/parameters/Level' - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/parameters/Extent' + - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/parameters/Date' responses: '200': description: Requested Submodel @@ -5053,6 +5060,7 @@ paths: parameters: - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/parameters/Level' - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/parameters/Extent' + - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/parameters/Date' responses: '200': description: Requested Submodel diff --git a/Part2-API-Schemas/openapi.yaml b/Part2-API-Schemas/openapi.yaml index 1783b4dc..b0fc38b5 100644 --- a/Part2-API-Schemas/openapi.yaml +++ b/Part2-API-Schemas/openapi.yaml @@ -5,7 +5,7 @@ info: description: >- The schemas implementing the [Specification of the Asset Administration Shell: Part 2](https://industrialdigitaltwin.org/en/content-hub/aasspecifications). - Copyright: Industrial Digital Twin Association (IDTA) 2025 + Copyright: Industrial Digital Twin Association (IDTA) 2026 contact: name: Industrial Digital Twin Association (IDTA) email: info@idtwin.org @@ -60,6 +60,14 @@ components: required: false schema: type: string + Date: + name: date + in: query + description: Date and time of the requested version of the Asset Administration Shell in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format. If not provided, the latest version is returned. + required: false + schema: + type: string + format: date-time Extent: name: extent in: query diff --git a/SubmodelRepositoryServiceSpecification/V3.2_SSP-001.yaml b/SubmodelRepositoryServiceSpecification/V3.2_SSP-001.yaml index baa302cd..32bb397b 100644 --- a/SubmodelRepositoryServiceSpecification/V3.2_SSP-001.yaml +++ b/SubmodelRepositoryServiceSpecification/V3.2_SSP-001.yaml @@ -246,6 +246,7 @@ paths: parameters: - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/parameters/Level' - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/parameters/Extent' + - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/parameters/Date' responses: '200': description: Requested Submodel @@ -447,6 +448,7 @@ paths: parameters: - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/parameters/Level' - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/parameters/Extent' + - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/parameters/Date' responses: '200': description: Requested Submodel diff --git a/SubmodelRepositoryServiceSpecification/V3.2_SSP-002.yaml b/SubmodelRepositoryServiceSpecification/V3.2_SSP-002.yaml index 90417aa8..5dbb9169 100644 --- a/SubmodelRepositoryServiceSpecification/V3.2_SSP-002.yaml +++ b/SubmodelRepositoryServiceSpecification/V3.2_SSP-002.yaml @@ -208,6 +208,7 @@ paths: parameters: - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/parameters/Level' - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/parameters/Extent' + - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/parameters/Date' responses: '200': description: Requested Submodel @@ -269,6 +270,7 @@ paths: parameters: - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/parameters/Level' - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/parameters/Extent' + - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/parameters/Date' responses: '200': description: Requested Submodel diff --git a/documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc b/documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc index 071a5952..3754500a 100644 --- a/documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc +++ b/documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc @@ -15,6 +15,7 @@ Note: Changes in Metamodel (IDTA-01001) will not be listed here, although they h Major Changes: * ... +* Add new operations GetAssetAdministrationShellVersionByIdAndDate and GetSubmodelVersionByIdAndDate to retrieve a specific version of an AAS or Submodel from a given point in time. Minor Changes: @@ -28,11 +29,21 @@ Minor Changes: [%autowidth,width="100%",cols="40%,15%,45%",options="header",] |=== h|Operation h|Kind of Change h|Comment + | a| GetAssetAdministrationShellVersionByIdAndDate | New a| new API-Operation for AAS Repository interface to retrieve a specific version of an AAS from a given point in time. + | GetSubmodelVersionByIdAndDate | New a| new API-Operation for Submodel Repository interface to retrieve a specific version of a Submodel from a given point in time. | GenerateSerializationByIds|change a| Added a note to clarify the intended behavior for transitively referenced concept descriptions. (https://github.com/admin-shell-io/aas-specs-api/issues/510[#510]) | 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]) |=== +=== Interface Changes w.r.t. V3.1.1 to V3.2 + +[%autowidth,width="100%",cols="10%,29%,10%,51%",options="header",] +|=== +h|BWC h|Interface h|Kind of Change h|Comment +| === + + == Changes w.r.t. V3.1 to V3.1.1 Major Changes: @@ -63,6 +74,7 @@ h|Operation h|Kind of Change h|Comment |=== + == Changes w.r.t. V3.0.4 to V3.1 Major Changes: diff --git a/documentation/IDTA-01002-3/modules/ROOT/pages/http-rest-api/http-rest-api.adoc b/documentation/IDTA-01002-3/modules/ROOT/pages/http-rest-api/http-rest-api.adoc index 0a2a1831..87f51e16 100644 --- a/documentation/IDTA-01002-3/modules/ROOT/pages/http-rest-api/http-rest-api.adoc +++ b/documentation/IDTA-01002-3/modules/ROOT/pages/http-rest-api/http-rest-api.adoc @@ -526,6 +526,8 @@ base64url-encoded identifier path-suffix=$reference or no suffix normal +date=\{dateTime\} is the date and time for which the version of the AAS shall be retrieved, e.g. "2024-01-01T12:00:00Z" for January 1st, 2024 at 12:00:00 UTC. + |PostAssetAdministrationShell |POST |/shells | |PutAssetAdministrationShellById |PUT |/shells/\{aasIdentifier} |base64url-encoded identifier |DeleteAssetAdministrationShellById |DELETE |/shells/\{aasIdentifier} |base64url-encoded identifier @@ -557,6 +559,8 @@ path-suffix=$metadata or no suffix for normal base64url-encoded identifier +date=\{dateTime\} is the date and time for which the version of the Submodel shall be retrieved, e.g. "2024-01-01T12:00:00Z" for January 1st, 2024 at 12:00:00 UTC. Only applicable for the 'normal' and 'value' operations. + |PostSubmodel |POST |/submodels | |PutSubmodelById |PUT |/submodels/\{submodelIdentifier} |base64url-encoded identifier |PatchSubmodelById |PATCH |/submodels/\{submodelIdentifier} |path-suffix=$metadata/$value or no suffix for normal diff --git a/documentation/IDTA-01002-3/modules/ROOT/pages/http-rest-api/service-specifications-and-profiles.adoc b/documentation/IDTA-01002-3/modules/ROOT/pages/http-rest-api/service-specifications-and-profiles.adoc index e282da3b..b616df2f 100644 --- a/documentation/IDTA-01002-3/modules/ROOT/pages/http-rest-api/service-specifications-and-profiles.adoc +++ b/documentation/IDTA-01002-3/modules/ROOT/pages/http-rest-api/service-specifications-and-profiles.adoc @@ -64,7 +64,7 @@ The name of the service specification ends with "ServiceSpecification". The supported service specification or profile can be discovered at the /description endpoint. This endpoint will return the related profile string. It is sufficient to only expose the latest service specification identifier in case a server supports different minor versions of a service specification at the same time. -For instance, if both "https://admin-shell.io/aas/API/3/2/SubmodelRegistryServiceSpecification/SSP-002" and "https://admin-shell.io/aas/API/3/2/SubmodelRegistryServiceSpecification/SSP-002" are supported, the server may only include "https://admin-shell.io/aas/API/3/2/SubmodelRegistryServiceSpecification/SSP-002" in its profiles list. +For instance, if both "https://admin-shell.io/aas/API/3/1/SubmodelRegistryServiceSpecification/SSP-002" and "https://admin-shell.io/aas/API/3/2/SubmodelRegistryServiceSpecification/SSP-002" are supported, the server may only include "https://admin-shell.io/aas/API/3/2/SubmodelRegistryServiceSpecification/SSP-002" in its profiles list. Clients shall understand that lower minor versions of service specifications are supported even if only one service specification identifier is provided. @@ -665,18 +665,18 @@ xref:specification/interfaces.adoc#GetSelfDescription[GetDescription] See: https://app.swaggerhub.com/apis/Plattform_i40/DiscoveryServiceSpecification/V3.2.0_SSP-002 -[#asset-administration-shell-repository-service-specification-service-specification] +[#asset-administration-shell-repository-service-specification] == Asset Administration Shell Repository Service Specification [%autowidth,width="100%",cols="42%,58%",options="header",] |=== h|Service Specification / Profiles h|Description -|<> |Full feature set -|<> |Only read operations; is included in the profile AssetAdministrationShellRepositoryServiceSpecification/SSP-001 -|<> |Query operations +|<> |Full feature set +|<> |Only read operations; is included in the profile AssetAdministrationShellRepositoryServiceSpecification/SSP-001 +|<> |Query operations |=== -[#asset-administration-shell-repository-service-specification-service-specification-ssp-001] +[#asset-administration-shell-repository-service-specification-ssp-001] === Asset Administration Shell Repository Service Specification – Full Profile [%autowidth,width="100%",cols="30%,70%",options="header",] @@ -688,6 +688,7 @@ h|Feature h|Appearance _AAS Repository API:_ + xref:specification/interfaces.adoc#GetAllAssetAdministrationShells[GetAllAssetAdministrationShells] + xref:specification/interfaces.adoc#GetAssetAdministrationShellById[GetAssetAdministrationShellById] + +xref:specification/interfaces.adoc#GetAssetAdministrationShellVersionByIdAndDate[GetAssetAdministrationShellVersionByIdAndDate] + xref:specification/interfaces.adoc#GetAllAssetAdministrationShellsByAssetId[GetAllAssetAdministrationShellsByAssetId] + xref:specification/interfaces.adoc#GetAllAssetAdministrationShellsByIdShort[GetAllAssetAdministrationShellsByIdShort] + xref:specification/interfaces.adoc#PostAssetAdministrationShell[PostAssetAdministrationShell] + @@ -707,6 +708,7 @@ xref:specification/interfaces.adoc#DeleteThumbnail[DeleteThumbnail] __Submodel Repository API by superpath:__ + xref:specification/interfaces.adoc#GetAllSubmodels[GetAllSubmodels] + xref:specification/interfaces.adoc#GetSubmodelById[GetSubmodelById] + +xref:specification/interfaces.adoc#GetSubmodelVersionByIdAndDate[GetSubmodelVersionByIdAndDate] + xref:specification/interfaces.adoc#GetAllSubmodelsBySemanticId[GetAllSubmodelsBySemanticId] + xref:specification/interfaces.adoc#GetAllSubmodelsByIdShort[GetAllSubmodelsByIdShort] + xref:specification/interfaces.adoc#PostSubmodel[PostSubmodel] + @@ -762,6 +764,7 @@ h|Feature h|Appearance _AAS Repository API:_ + xref:specification/interfaces.adoc#GetAllAssetAdministrationShells[GetAllAssetAdministrationShells] + xref:specification/interfaces.adoc#GetAssetAdministrationShellById[GetAssetAdministrationShellById] + +xref:specification/interfaces.adoc#GetAssetAdministrationShellVersionByIdAndDate[GetAssetAdministrationShellVersionByIdAndDate] + xref:specification/interfaces.adoc#GetAllAssetAdministrationShellsByAssetId[GetAllAssetAdministrationShellsByAssetId] + xref:specification/interfaces.adoc#GetAllAssetAdministrationShellsByIdShort[] @@ -850,6 +853,7 @@ h|Feature h|Appearance __Submodel Repository API:__ + xref:specification/interfaces.adoc#GetAllSubmodels[GetAllSubmodels] + xref:specification/interfaces.adoc#GetSubmodelById[GetSubmodelById] + +xref:specification/interfaces.adoc#GetSubmodelVersionByIdAndDate[GetSubmodelVersionByIdAndDate] + xref:specification/interfaces.adoc#GetAllSubmodelsBySemanticId[GetAllSubmodelsBySemanticId] + xref:specification/interfaces.adoc#GetAllSubmodelsByIdShort[GetAllSubmodelsByIdShort] + xref:specification/interfaces.adoc#PostSubmodel[PostSubmodel] + @@ -904,6 +908,7 @@ h|Feature h|Appearance _Submodel Repository API:_ + xref:specification/interfaces.adoc#GetAllSubmodels[GetAllSubmodels] + xref:specification/interfaces.adoc#GetSubmodelById[GetSubmodelById] + +xref:specification/interfaces.adoc#GetSubmodelVersionByIdAndDate[GetSubmodelVersionByIdAndDate] + xref:specification/interfaces.adoc#GetAllSubmodelsBySemanticId[GetAllSubmodelsBySemanticId] + xref:specification/interfaces.adoc#GetAllSubmodelsByIdShort[GetAllSubmodelsByIdShort] @@ -1069,17 +1074,17 @@ xref:specification/interfaces.adoc#GetSelfDescription[GetDescription] See: https://app.swaggerhub.com/apis/Plattform_i40/SubmodelRepositoryServiceSpecification/V3.2.0_SSP-005 -[#concept-description-repository-service-specification-service-specification] +[#concept-description-repository-service-specification] == Concept Description Repository Service Specification [cols="59%,41%"] |=== h|Service Specification / Profiles h|Description -|<> |Full feature set -|<> |Query operations +|<> |Full feature set +|<> |Query operations |=== -[#concept-description-repository-service-specification-service-specification-ssp-001] +[#concept-description-repository-service-specification-ssp-001] === Concept Description Repository Service Specification – Full Profile [%autowidth,width="100%",cols="30%,70%",options="header",] @@ -1111,7 +1116,7 @@ xref:specification/interfaces.adoc#GetSelfDescription[GetDescription] See: https://app.swaggerhub.com/apis/Plattform_i40/ConceptDescriptionRepositoryServiceSpecification/V3.2.0_SSP-001 -[#concept-description-repository-service-specification-service-specification-ssp-002] +[#concept-description-repository-service-specification-ssp-002] === Concept Description Repository Service Specification – Query Profile [%autowidth, width="100%", cols="30%,70%",options="header",] @@ -1132,4 +1137,3 @@ xref:specification/interfaces.adoc#GetSelfDescription[GetDescription] |=== See: https://app.swaggerhub.com/apis/Plattform_i40/ConceptDescriptionRepositoryServiceSpecification/V3.2.0_SSP-002 - diff --git a/documentation/IDTA-01002-3/modules/ROOT/pages/specification/interfaces.adoc b/documentation/IDTA-01002-3/modules/ROOT/pages/specification/interfaces.adoc index dc144ebd..f526594b 100644 --- a/documentation/IDTA-01002-3/modules/ROOT/pages/specification/interfaces.adoc +++ b/documentation/IDTA-01002-3/modules/ROOT/pages/specification/interfaces.adoc @@ -54,7 +54,7 @@ e|xref:DeleteThumbnail[DeleteThumbnail] a|Deletes the thumbnail |=== h|Operation Name 4+e|[[GetAssetAdministrationShell]]GetAssetAdministrationShell h|Explanation 4+a|Returns the Asset Administration Shell -h|semanticId 4+|`\https://admin-shell.io/aas/API/GetAssetAdministrationShell/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/GetAssetAdministrationShell/3/1` h|Name h|Description h|Mand. h|Type h|Card. @@ -72,7 +72,7 @@ e|payload a|Requested Asset Administration Shell |yes | link:https://industriald |=== h|*Operation Name* 4+e|[[PutAssetAdministrationShell]]PutAssetAdministrationShell h|Explanation 4+a|Replaces the Asset Administration Shell -h|*semanticId* 4+|`\https://admin-shell.io/aas/API/PutAssetAdministrationShell/3/2` +h|*semanticId* 4+|`\https://admin-shell.io/aas/API/PutAssetAdministrationShell/3/1` h|Name h|*Description* h|*Mand.* h|*Type* h|*Card.* 5+h|Input Parameter @@ -89,7 +89,7 @@ e|payload a|AssetAdministrationShell |no |Replaced link:https://industrialdigita |=== h|Operation Name 4+e|[[GetAllSubmodelReferences]]GetAllSubmodelReferences h|Explanation 4+a|Returns all Submodel References -h|semanticId 4+|`\https://admin-shell.io/aas/API/GetAllSubmodelReferences/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/GetAllSubmodelReferences/3/1` h|Name h|Description h|Mand. h|Type h|Card. @@ -109,7 +109,7 @@ e|payload a|Requested Submodel References |yes |link:https://industrialdigitaltw |=== h|Operation Name 4+e|[[PostSubmodelReference]]PostSubmodelReference h|Explanation 4+a|Creates a Submodel Reference at the Asset Administration Shell -h|semanticId 4+|`\https://admin-shell.io/aas/API/PostSubmodelReference/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/PostSubmodelReference/3/1` h|Name h| Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -126,7 +126,7 @@ e|payload | Created Submodel Reference |yes |link:https://industrialdigitaltwin. |=== h|Operation Name 4+e|[[DeleteSubmodelReference]]DeleteSubmodelReference h|Explanation 4+a|Deletes the Submodel Reference from the Asset Administration Shell -h|semanticId 4+|`\https://admin-shell.io/aas/API/DeleteSubmodelReference/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/DeleteSubmodelReference/3/1` h|Name h| Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -142,7 +142,7 @@ e|statusCode | Status code |yes |xref:specification/interfaces-payload.adoc#Stat |=== h|Operation Name 4+e|[[GetAssetInformation]]GetAssetInformation h|Explanation 4+a|Returns the Asset Information -h|semanticId 4+|`\https://admin-shell.io/aas/API/GetAssetInformation/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/GetAssetInformation/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -158,7 +158,7 @@ e|payload a|Requested Asset Information |yes |link:https://industrialdigitaltwin |=== h|*Operation Name* 4+e|[[PutAssetInformation]]PutAssetInformation h|Explanation 4+a|Replaces the Asset Information -h|semanticId 4+|`\https://admin-shell.io/aas/API/PutAssetInformation/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/PutAssetInformation/3/1` h|Name h|Description h|Mand. h|Type h|Card. @@ -178,7 +178,7 @@ e|statusCode a|Status code |yes |xref:specification/interfaces-payload.adoc#Stat |=== h|Operation Name 4+e|[[GetThumbnail]]GetThumbnail h|Explanation 4+a|Returns the thumbnail file -h|semanticId 4+|`\https://admin-shell.io/aas/API/GetThumbnail/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/GetThumbnail/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -194,7 +194,7 @@ e|payload a|Requested thumbnail file |yes | xref:specification/interfaces-payloa |=== h|Operation Name 4+e|[[PutThumbnail]]PutThumbnail h|Explanation 4+a|Replaces the thumbnail file -h|semanticId 4+|`\https://admin-shell.io/aas/API/PutThumbnail/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/PutThumbnail/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -210,7 +210,7 @@ e|statusCode a|Status code |yes |xref:specification/interfaces-payload.adoc#Stat |=== h|Operation Name 4+e|[[DeleteThumbnail]]DeleteThumbnail h|Explanation 4+a|Deletes the thumbnail file -h|semanticId 4+|`\https://admin-shell.io/aas/API/DeleteThumbnail/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/DeleteThumbnail/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -254,7 +254,7 @@ e|xref:GetOperationAsyncResult[GetOperationAsyncResult] a|Returns the OperationR |=== h|Operation Name 4+e|[[GetSubmodel]]GetSubmodel h|Explanation 4+a|Returns the Submodel -h|semanticId 4+|`\https://admin-shell.io/aas/API/GetSubmodel/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/GetSubmodel/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -271,7 +271,7 @@ h|Name h|Description h|Mand. h|Type h|Card. |=== h|Operation Name 4+e|[[GetAllSubmodelElements]]GetAllSubmodelElements h|Explanation 4+a|Returns all submodel elements including their hierarchy -h|semanticId 4+|`\https://admin-shell.io/aas/API/GetAllSubmodelElements/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/GetAllSubmodelElements/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -290,7 +290,7 @@ h|Name h|Description h|Mand. h|Type h|Card. |=== h|Operation Name 4+e|[[GetSubmodelElementByPath]]GetSubmodelElementByPath h|Explanation 4+a|Returns a specific submodel element from the Submodel at a specified path -h|semanticId 4+|`\https://admin-shell.io/aas/API/GetSubmodelElementByPath/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/GetSubmodelElementByPath/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -308,7 +308,7 @@ h|Name h|Description h|Mand. h|Type h|Card. |=== h|Operation Name 4+e|[[GetFileByPath]]GetFileByPath h|Explanation 4+a|Returns a specific file from the Submodel at a specified path -h|semanticId 4+|`\https://admin-shell.io/aas/API/GetFileByPath/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/GetFileByPath/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -325,7 +325,7 @@ h|Name h|Description h|Mand. h|Type h|Card. |=== h|Operation Name 4+e|[[PutFileByPath]]PutFileByPath h|Explanation 4+a|Replaces the file of an existing submodel element at a specified path within the submodel element hierarchy -h|semanticId 4+|`\https://admin-shell.io/aas/API/PutFileByPath/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/PutFileByPath/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -342,7 +342,7 @@ h|Name h|Description h|Mand. h|Type h|Card. |=== h|Operation Name 4+e|[[DeleteFileByPath]]DeleteFileByPath h|Explanation 4+a|Deletes the file of an existing submodel element at a specified path within the submodel element hierarchy -h|semanticId 4+|`\https://admin-shell.io/aas/API/DeleteFileByPath/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/DeleteFileByPath/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -358,7 +358,7 @@ h|Name h|Description h|Mand. h|Type h|Card. |=== h|Operation Name 4+e|[[PutSubmodel]]PutSubmodel h|Explanation 4+a|Replaces the Submodel -h|semanticId 4+|`\https://admin-shell.io/aas/API/PutSubmodel/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/PutSubmodel/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -375,7 +375,7 @@ h|Name h|Description h|Mand. h|Type h|Card. |=== h|Operation Name 4+e|[[PatchSubmodel]]PatchSubmodel h|Explanation 4+a|Updates the Submodel -h|semanticId 4+|`\https://admin-shell.io/aas/API/PatchSubmodel/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/PatchSubmodel/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -411,7 +411,7 @@ Note: the creation of the idShort is out of scope and must be handled in a propr ==== -h|semanticId 4+|`\https://admin-shell.io/aas/API/PostSubmodelElement/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/PostSubmodelElement/3/1` h|Name h|Description h|Mand. h|Type h|Card. @@ -441,7 +441,7 @@ Note: the creation of the idShort is out of scope and must be handled in a propr ==== -h|semanticId 4+|`\https://admin-shell.io/aas/API/PostSubmodelElementByPath/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/PostSubmodelElementByPath/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -463,7 +463,7 @@ Note: if the PostSubmodelElementByPath is executed towards a SubmodelElementList |=== h|Operation Name 4+e|[[PutSubmodelElementByPath]]PutSubmodelElementByPath h|Explanation 4+a|Replaces an existing submodel element or creates a new submodel element at a specified path within the submodel element hierarchy -h|semanticId 4+|`\https://admin-shell.io/aas/API/PutSubmodelElementByPath/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/PutSubmodelElementByPath/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -481,7 +481,7 @@ h|Name h|Description h|Mand. h|Type h|Card. |=== h|Operation Name 4+e|[[PatchSubmodelElementByPath]]PatchSubmodelElementByPath h|Explanation 4+a|Updates an existing submodel element at a specified path within the submodel element hierarchy -h|semanticId 4+|`\https://admin-shell.io/aas/API/PatchSubmodelElementByPath/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/PatchSubmodelElementByPath/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -513,7 +513,7 @@ Note: values remain unchanged with content=metadata. h|Operation Name 4+e|[[GetSubmodelElementValueByPath]]GetSubmodelElementValueByPath h|Explanation 4+a|Returns a specific submodel element value from the Submodel at a specified path according to the ValueOnly-serialization as defined in xref:bibliography.adoc#bib1[[1]] // Previously pointing to Clause 11.4.1 -h|semanticId 4+|`\https://admin-shell.io/aas/API/GetSubmodelElementValueByPath/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/GetSubmodelElementValueByPath/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -531,7 +531,7 @@ h|Name h|Description h|Mand. h|Type h|Card. h|Operation Name 4+e|[[PatchSubmodelElementValueByPath]]PatchSubmodelElementValueByPath h|Explanation 4+a|Sets the value of the submodel element at a specified path according to the ValueOnly-serialization as defined in xref:bibliography.adoc#bib1[[1]] // Previously pointing to Clause 11.4.1 -h|semanticId 4+|`\https://admin-shell.io/aas/API/PatchSubmodelElementValueByPath/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/PatchSubmodelElementValueByPath/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -548,7 +548,7 @@ h|Name h|Description h|Mand. h|Type h|Card. |=== h|Operation Name 4+e|[[DeleteSubmodelElementByPath]]DeleteSubmodelElementByPath h|Explanation 4+a|Deletes a submodel element at a specified path within the submodel elements hierarchy -h|semanticId 4+|`\https://admin-shell.io/aas/API/DeleteSubmodelElementByPath/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/DeleteSubmodelElementByPath/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -564,7 +564,7 @@ h|Name h|Description h|Mand. h|Type h|Card. |=== h|Operation Name 4+e|[[InvokeOperationSync]]InvokeOperationSync h|Explanation 4+a|Synchronously invokes an Operation at a specified path -h|semanticId 4+|`\https://admin-shell.io/aas/API/InvokeOperationSync/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/InvokeOperationSync/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -583,7 +583,7 @@ h|Name h|Description h|Mand. h|Type h|Card. |=== h|Operation Name 4+e|[[InvokeOperationAsync]]InvokeOperationAsync h|Explanation 4+a|Asynchronously invokes an Operation at a specified path -h|semanticId 4+|`\https://admin-shell.io/aas/API/InvokeOperationAsync/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/InvokeOperationAsync/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -603,7 +603,7 @@ h|Name h|Description h|Mand. h|Type h|Card. |=== h|Operation Name 4+e|[[GetOperationAsyncStatus]]GetOperationAsyncStatus h|Explanation 4+a|Returns the current status of an asynchronously invoked operation -h|semanticId 4+|`\https://admin-shell.io/aas/API/GetOperationAsnycStatus/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/GetOperationAsnycStatus/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -620,7 +620,7 @@ h|Name h|Description h|Mand. h|Type h|Card. |=== h|Operation Name 4+e|[[GetOperationAsyncResult]]GetOperationAsyncResult h|Explanation 4+a|Returns the OperationResult of an asynchronously invoked operation -h|semanticId 4+|`\https://admin-shell.io/aas/API/GetOperationAsnycResult/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/GetOperationAsnycResult/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -648,7 +648,7 @@ h|Operation Name h|[[Description]]Description |=== h|Operation Name 4+e|[[GenerateSerializationByIds]]GenerateSerializationByIds h|Explanation 4+a|Returns an appropriate serialization based on the specified format (see xref:specification/interfaces.adoc#SerializationFormat[SerializationFormat]). -h|semanticId 4+|`\https://admin-shell.io/aas/API/GenerateSerializationByIds/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/GenerateSerializationByIds/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -703,7 +703,7 @@ e|xref:DeleteAASXByPackageId[DeleteAASXByPackageId] |Deletes a specific AASX pac |=== h|Operation Name 4+e|[[GetAllAASXPackageIds]]GetAllAASXPackageIds h|Explanation 4+a|Returns a list of available AASX packages at the server -h|semanticId 4+|`\https://admin-shell.io/aas/API/GetAllAASXPackageIds/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/GetAllAASXPackageIds/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -722,7 +722,7 @@ h|Name h|Description h|Mand. h|Type h|Card. |=== h|Operation Name 4+e|[[GetAASXByPackageId]]GetAASXByPackageId h|Explanation 4+a|Returns a specific AASX package from the server -h|semanticId 4+|`\https://admin-shell.io/aas/API/GetAASXByPackageId/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/GetAASXByPackageId/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -740,7 +740,7 @@ h|Name h|Description h|Mand. h|Type h|Card. |=== h|Operation Name 4+e|[[PostAASXPackage]]PostAASXPackage h|Explanation 4+a|Creates an AASX package at the server -h|semanticId 4+|`\https://admin-shell.io/aas/API/PostAASXPackage/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/PostAASXPackage/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -769,7 +769,7 @@ Servers may simply store the AASX files with their related given aasIds. |=== h|Operation Name 4+e|[[PutAASXByPackageId]]PutAASXByPackageId h|Explanation 4+a|Replaces or creates the AASX package at the server -h|semanticId 4+|`\https://admin-shell.io/aas/API/PutAASXByPackageId/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/PutAASXByPackageId/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -798,7 +798,7 @@ Servers may simply store the AASX files with their related given aasIds. |=== h|Operation Name 4+e|[[DeleteAASXByPackageId]]DeleteAASXByPackageId h|Explanation 4+a|Deletes a specific AASX package from the server -h|semanticId 4+|`\https://admin-shell.io/aas/API/DeleteAASXByPackageId/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/DeleteAASXByPackageId/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -847,7 +847,7 @@ h|Operation Name h|Description |=== h|Operation Name 4+e|[[GetAllAssetAdministrationShellDescriptors]]GetAllAssetAdministrationShellDescriptors h|Explanation 4+a|Returns all Asset Administration Shell Descriptors -h|semanticId 4+|`\https://admin-shell.io/aas/API/GetAllAssetAdministrationShellDescriptors/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/GetAllAssetAdministrationShellDescriptors/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -867,7 +867,7 @@ h|Name h|Description h|Mand. h|Type h|Card. |=== h|Operation Name 4+e|[[GetAssetAdministrationShellDescriptorById]]GetAssetAdministrationShellDescriptorById h|Explanation 4+a|Returns a specific Asset Administration Shell Descriptor -h|semanticId 4+|`\https://admin-shell.io/aas/API/GetAssetAdministrationShellDescriptorById/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/GetAssetAdministrationShellDescriptorById/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -884,7 +884,7 @@ h|Name h|Description h|Mand. h|Type h|Card. |=== h|Operation Name 4+e|[[PostAssetAdministrationShellDescriptor]]PostAssetAdministrationShellDescriptor h|Explanation 4+a|Creates a new Asset Administration Shell Descriptor, i.e., registers an AAS -h|semanticId 4+|`\https://admin-shell.io/aas/API/PostAssetAdministrationShellDescriptor/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/PostAssetAdministrationShellDescriptor/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -901,7 +901,7 @@ h|Name h|Description h|Mand. h|Type h|Card. |=== h|Operation Name 4+e|[[CreateBulkAssetAdministrationShellDescriptors]]CreateBulkAssetAdministrationShellDescriptors h|Explanation 4+a|Creates multiple new Asset Administration Shell Descriptors, i.e., registers multiple Asset Administration Shells -h|semanticId 4+|`\https://admin-shell.io/aas/API/CreateBulkAssetAdministrationShellDescriptors/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/CreateBulkAssetAdministrationShellDescriptors/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -917,7 +917,7 @@ h|Name h|Description h|Mand. h|Type h|Card. |=== h|Operation Name 4+e|[[PutAssetAdministrationShellDescriptorById]]PutAssetAdministrationShellDescriptorById h|Explanation 4+a|Creates or replaces an existing Asset Administration Shell Descriptor, i.e., replaces registration information -h|semanticId 4+|`\https://admin-shell.io/aas/API/PutAssetAdministrationShellDescriptorById/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/PutAssetAdministrationShellDescriptorById/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -935,7 +935,7 @@ h|Name h|Description h|Mand. h|Type h|Card. h|Operation Name 4+e|[[PutBulkAssetAdministrationShellDescriptorsById]]PutBulkAssetAdministrationShellDescriptorsById h|Explanation 4+a|Updates multiple existing Asset Administration Shell Descriptors or creates them if they do not exist -h|semanticId 4+|`\https://admin-shell.io/aas/API/PutBulkAssetAdministrationShellDescriptorsById/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/PutBulkAssetAdministrationShellDescriptorsById/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -951,7 +951,7 @@ h|Name h|Description h|Mand. h|Type h|Card. |=== h|Operation Name 4+e|[[DeleteAssetAdministrationShellDescriptorById]]DeleteAssetAdministrationShellDescriptorById h|Explanation 4+a|Deletes an Asset Administration Shell Descriptor, i.e., de-registers an AAS -h|semanticId 4+|`\https://admin-shell.io/aas/API/DeleteAssetAdministrationShellDescriptorById/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/DeleteAssetAdministrationShellDescriptorById/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -967,7 +967,7 @@ h|Name h|Description h|Mand. h|Type h|Card. |=== h|Operation Name 4+e|[[DeleteBulkAssetAdministrationShellDescriptorsById]]DeleteBulkAssetAdministrationShellDescriptorsById h|Explanation 4+a|Deletes multiple Asset Administration Shell Descriptors, i.e., de-registers multiple Asset Administration Shells -h|semanticId 4+|`\https://admin-shell.io/aas/API/DeleteBulkAssetAdministrationShellDescriptorsById/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/DeleteBulkAssetAdministrationShellDescriptorsById/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -984,7 +984,7 @@ h|Name h|Description h|Mand. h|Type h|Card. |=== h|Operation Name 4+e|[[QueryAssetAdministrationShellDescriptors]]QueryAssetAdministrationShellDescriptors h|Explanation 4+a| Returns all Asset Administration Shell Descriptors that conform to a certain input query. -h|semanticId 4+|`\https://admin-shell.io/aas/API/QueryAssetAdministrationShellDescriptors/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/QueryAssetAdministrationShellDescriptors/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -1021,7 +1021,7 @@ e|xref:QuerySubmodelDescriptors[QuerySubmodelDescriptors] a| Returns all Submode |=== h|Operation Name 4+e|[[GetAllSubmodelDescriptors]]GetAllSubmodelDescriptors h|Explanation 4+a|Returns all submodel descriptors -h|semanticId 4+|`\https://admin-shell.io/aas/API/GetAllSubmodelDescriptors/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/GetAllSubmodelDescriptors/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -1039,7 +1039,7 @@ e|payload a|List of requested submodel descriptors |no |xref:specification/inter |=== h|Operation Name 4+e|[[GetSubmodelDescriptorById]]GetSubmodelDescriptorById h|Explanation 4+a|Returns a specific Submodel Descriptor -h|semanticId 4+|`\https://admin-shell.io/aas/API/GetSubmodelDescriptorById/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/GetSubmodelDescriptorById/3/1` = h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -1056,7 +1056,7 @@ e|payload a|Requested submodel descriptor |yes |xref:specification/interfaces-pa |=== h|Operation Name 4+e|[[PostSubmodelDescriptor]]PostSubmodelDescriptor h|Explanation 4+a|Creates a new submodel descriptor, i.e. registers a submodel -h|semanticId 4+|`\https://admin-shell.io/aas/API/PostSubmodelDescriptor/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/PostSubmodelDescriptor/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -1073,7 +1073,7 @@ e|payload a|Created submodel descriptor |yes | xref:specification/interfaces-pay |=== h|Operation Name 4+e|[[PostBulkSubmodelDescriptors]]PostBulkSubmodelDescriptors h|Explanation 4+a|Creates one or more new submodel descriptors, i.e., registers several submodels -h|semanticId 4+|`\https://admin-shell.io/aas/API/PostBulkSubmodelDescriptors/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/PostBulkSubmodelDescriptors/3/1` h|Name h|Description h|Mand. h|Type h|Card. @@ -1094,7 +1094,7 @@ Descriptor a|Object containing the Submodel’s identification and endpoint i |=== h|Operation Name 4+e|[[PutSubmodelDescriptorById]]PutSubmodelDescriptorById h|Explanation 4+a|Replaces an existing submodel descriptor, i.e., replaces registration information -h|semanticId 4+|`\https://admin-shell.io/aas/API/PutSubmodelDescriptorById/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/PutSubmodelDescriptorById/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -1112,7 +1112,7 @@ e|payload a|Replaced submodel descriptor |no | xref:specification/interfaces-pay |=== h|Operation Name 4+e|[[PutBulkSubmodelDescriptorsById]]PutBulkSubmodelDescriptorsById h|Explanation 4+a|Replaces one or more existing submodel descriptors, i.e., replaces registration information of several submodels -h|semanticId 4+|`\https://admin-shell.io/aas/API/PutBulkSubmodelDescriptorsById/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/PutBulkSubmodelDescriptorsById/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -1130,7 +1130,7 @@ Descriptor |Object containing the Submodel’s identification and endpoint infor |=== h|Operation Name 4+e|[[DeleteSubmodelDescriptorById]]DeleteSubmodelDescriptorById h|Explanation 4+a|Deletes a Submodel Descriptor, i.e., de-registers a submodel -h|semanticId 4+|`\https://admin-shell.io/aas/API/DeleteSubmodelDescriptorById/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/DeleteSubmodelDescriptorById/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -1146,7 +1146,7 @@ h|Name h|Description h|Mand. h|Type h|Card. |=== h|Operation Name 4+e|[[DeleteBulkSubmodelDescriptorsById]]DeleteBulkSubmodelDescriptorsById h|Explanation 4+a|Deletes one or more submodel descriptors, i.e., de-registers several submodels -h|semanticId 4+|`\https://admin-shell.io/aas/API/DeleteBulkSubmodelDescriptorsById/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/DeleteBulkSubmodelDescriptorsById/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -1162,7 +1162,7 @@ h|Name h|Description h|Mand. h|Type h|Card. |=== h|Operation Name 4+e|[[QuerySubmodelDescriptors]]QuerySubmodelDescriptors h|Explanation 4+a| Returns all Submodel Descriptors that conform to a certain input query. -h|semanticId 4+|`\https://admin-shell.io/aas/API/QuerySubmodelDescriptors/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/QuerySubmodelDescriptors/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -1199,6 +1199,7 @@ e|xref:GetAllAssetAdministrationShells[GetAllAssetAdministrationShells] |Returns e|xref:GetAssetAdministrationShellById[GetAssetAdministrationShellById] |Returns a specific Asset Administration Shell e|xref:GetAllAssetAdministrationShellsByAssetId[GetAllAssetAdministrationShellsByAssetId] |Returns all Asset Administration Shells that are linked to a globally unique asset identifier or to specific asset ids e|xref:GetAllAssetAdministrationShellsByIdShort[GetAllAssetAdministrationShellsByIdShort] |Returns all Asset Administration Shells with a specific idShort +e|xref:GetAssetAdministrationShellVersionByIdAndDate[GetAssetAdministrationShellVersionByIdAndDate] |Explanation 4+a|Returns a specific Asset Administration Shell at a specific point in time. e|xref:PostAssetAdministrationShell[PostAssetAdministrationShell] a| Creates a new Asset Administration Shell. The ID of the new Asset Administration Shell must be set in the payload. @@ -1221,7 +1222,7 @@ e|xref:QueryAssetAdministrationShells[QueryAssetAdministrationShells] a| Returns |=== h|Operation Name 4+e|[[GetAllAssetAdministrationShells]]GetAllAssetAdministrationShells h|Explanation 4+a|Returns all Asset Administration Shells -h|semanticId 4+|`\https://admin-shell.io/aas/API/GetAllAssetAdministrationShells/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/GetAllAssetAdministrationShells/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -1240,7 +1241,7 @@ e|payload a|List of Asset Administration Shells |no |link:https://industrialdigi |=== h|Operation Name 4+e|[[GetAssetAdministrationShellById]]GetAssetAdministrationShellById h|Explanation 4+a|Returns a specific Asset Administration Shell -h|semanticId 4+|`\https://admin-shell.io/aas/API/GetAssetAdministrationShellById/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/GetAssetAdministrationShellById/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -1260,7 +1261,7 @@ h|Name h|Description h|Mand. h|Type h|Card. |=== h|Operation Name 4+e|[[GetAllAssetAdministrationShellsByAssetId]]GetAllAssetAdministrationShellsByAssetId h|Explanation 4+a|Returns all Asset Administration Shells that are linked to a globally unique asset identifier or to specific asset ids -h|semanticId 4+|`\https://admin-shell.io/aas/API/GetAllAssetAdministrationShellsByAssetId/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/GetAllAssetAdministrationShellsByAssetId/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -1283,7 +1284,7 @@ The name of the specific asset identifier or the predefined name “_globalAsset |=== h|Operation Name 4+e|[[GetAllAssetAdministrationShellsByIdShort]]GetAllAssetAdministrationShellsByIdShort h|Explanation 4+a|Returns all Asset Administration Shells with a specific _idShort_ -h|semanticId 4+|`\https://admin-shell.io/aas/API/GetAllAssetAdministrationShellsByIdShort/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/GetAllAssetAdministrationShellsByIdShort/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -1296,6 +1297,26 @@ h|Name h|Description h|Mand. h|Type h|Card. |payload |Requested Asset Administration Shells |no |link:https://industrialdigitaltwin.io/aas-specifications/IDTA-01001/v3.1/spec-metamodel/core.html#AssetAdministrationShell[AssetAdministrationShell] |1..* |=== + +==== Operation GetAssetAdministrationShellVersionByIdAndDate + +[.table-with-appendix-table] +[width=100%,cols="25%,35%,10%,20%,10%"] +|=== +h|Operation Name 4+e|[[GetAssetAdministrationShellVersionByIdAndDate]]GetAssetAdministrationShellVersionByIdAndDate +h|Explanation 4+a|Returns a specific Asset Administration Shell at a specific point in time. If no date is provided, the latest version is returned. +h|semanticId 4+|`\https://admin-shell.io/aas/API/GetAssetAdministrationShellVersionByIdAndDate/3/2` + +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 +|date |The point in time at which the Asset Administration Shell version is requested |no |link:https://industrialdigitaltwin.io/aas-specifications/IDTA-01001/v3.2/spec-metamodel/datatypes.html#DateTimeUtc[DateTimeUtc] | 1 +5+h|Output Parameter +|statusCode |Status code |yes |xref:specification/interfaces-payload.adoc#StatusCode[StatusCode] |1 +|payload |Requested Asset Administration Shell Version at the specified date |no |link:https://industrialdigitaltwin.io/aas-specifications/IDTA-01001/v3.2/spec-metamodel/core.html#AssetAdministrationShell[AssetAdministrationShell] |1 +|=== + + ==== Operation PostAssetAdministrationShell [.table-with-appendix-table] @@ -1312,7 +1333,7 @@ Note: the creation of the idShort is out of scope and must be handled in a propr ==== -h|semanticId 4+|`\https://admin-shell.io/aas/API/PostAssetAdministrationShell/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/PostAssetAdministrationShell/3/1` h|Name h|Description h|Mand. h|Type h|Card. @@ -1334,7 +1355,7 @@ h|Name h|Description h|Mand. h|Type h|Card. |=== h|Operation Name 4+e|[[PutAssetAdministrationShellById]]PutAssetAdministrationShellById h|Explanation 4+a|Creates or replaces an existing Asset Administration Shell -h|semanticId 4+|`\https://admin-shell.io/aas/API/PutAssetAdministrationShellById/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/PutAssetAdministrationShellById/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -1355,7 +1376,7 @@ Note: The `id` of the contained Asset Administration Shell object has to be exac |=== h|Operation Name 4+e|[[DeleteAssetAdministrationShellById]]DeleteAssetAdministrationShellById h|Explanation 4+a|Deletes an Asset Administration Shell -h|semanticId 4+|`\https://admin-shell.io/aas/API/DeleteAssetAdministrationShellById/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/DeleteAssetAdministrationShellById/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -1372,7 +1393,7 @@ h|Name h|Description h|Mand. h|Type h|Card. |=== h|Operation Name 4+e|[[QueryAssetAdministrationShells]]QueryAssetAdministrationShells h|Explanation 4+a| Returns all Asset Administration Shells that conform to a certain input query. -h|semanticId 4+|`\https://admin-shell.io/aas/API/QueryAssetAdministrationShells/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/QueryAssetAdministrationShells/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -1393,6 +1414,7 @@ h|Name h|Description h|Mand. h|Type h|Card. h|Operation Name h|Description e|xref:GetAllSubmodels[GetAllSubmodels] |Returns all Submodels e|xref:GetSubmodelById[GetSubmodelById]|Returns a specific Submodel +e|xref:GetSubmodelVersionByIdAndDate[GetSubmodelVersionByIdAndDate]|Returns a specific version of a Submodel from a given point in time e|xref:GetAllSubmodelsBySemanticId[GetAllSubmodelsBySemanticId] |Returns all Submodels with a specific SemanticId e|xref:GetAllSubmodelsByIdShort[GetAllSubmodelsByIdShort] |Returns all Submodels with a specific _idShort_ e|xref:PostSubmodel[PostSubmodel] a| @@ -1418,7 +1440,7 @@ e|xref:QuerySubmodels[QuerySubmodels] a| Returns all Submodels that conform to a |=== h|Operation Name 4+e|[[GetAllSubmodels]]GetAllSubmodels h|Explanation 4+a|Returns all Submodels -h|semanticId 4+|`\https://admin-shell.io/aas/API/GetAllSubmodels/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/GetAllSubmodels/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -1437,7 +1459,7 @@ h|Name h|Description h|Mand. h|Type h|Card. |=== h|Operation Name 4+e|[[GetSubmodelById]]GetSubmodelById h|Explanation 4+a|Returns a specific Submodel -h|semanticId 4+|`\https://admin-shell.io/aas/API/GetSubmodelById/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/GetSubmodelById/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -1448,6 +1470,26 @@ h|Name h|Description h|Mand. h|Type h|Card. |payload |Requested Submodel |yes | link:https://industrialdigitaltwin.io/aas-specifications/IDTA-01001/v3.1/spec-metamodel/core.html#Submodel[Submodel] |1 |=== + +==== Operation GetSubmodelVersionByIdAndDate + +[.table-with-appendix-table] +[width=100%,cols="25%,35%,10%,20%,10%"] +|=== +h|Operation Name 4+e|[[GetSubmodelVersionByIdAndDate]]GetSubmodelVersionByIdAndDate +h|Explanation 4+a|Returns a specific version of a Submodel from a given point in time. If no date is provided, the latest version is returned. +h|semanticId 4+|`\https://admin-shell.io/aas/API/GetSubmodelVersionByIdAndDate/3/2` + +h|Name h|Description h|Mand. h|Type h|Card. +5+h|Input Parameter +|id |The Submodel’s unique ID |yes |link:https://industrialdigitaltwin.io/aas-specifications/IDTA-01001/v3.1/spec-metamodel/datatypes.html#Identifier[Identifier] |1 +|date |The point in time at which the Submodel version is requested |no |link:https://industrialdigitaltwin.io/aas-specifications/IDTA-01001/v3.2/spec-metamodel/datatypes.html#DateTimeUtc[DateTimeUtc] |1 +5+h|Output Parameter +|statusCode |Status code |yes |xref:specification/interfaces-payload.adoc#StatusCode[StatusCode] |1 +|payload |Requested Submodel Version at the specified date |no | link:https://industrialdigitaltwin.io/aas-specifications/IDTA-01001/v3.2/spec-metamodel/core.html#Submodel[Submodel] |1 +|=== + + ==== Operation GetAllSubmodelsBySemanticId [.table-with-appendix-table] @@ -1457,7 +1499,7 @@ h|Operation Name 4+e|[[GetAllSubmodelsBySemanticId]]GetAllSubmodelsBySemanticId h|Explanation 4+a| Returns all Submodels with a specific SemanticId or SupplementalSemanticId. If either the semanticId fits to the input parameter or at least one of the SupplementalSemanticIds, the submodel is returned. -h|semanticId 4+|`\https://admin-shell.io/aas/API/GetAllSubmodelsBySemanticId/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/GetAllSubmodelsBySemanticId/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -1477,7 +1519,7 @@ h|Name h|Description h|Mand. h|Type h|Card. |=== h|Operation Name 4+e|[[GetAllSubmodelsByIdShort]]GetAllSubmodelsByIdShort h|Explanation 4+a|Returns all Submodels with a specific _idShort_ -h|semanticId 4+|`\https://admin-shell.io/aas/API/GetAllSubmodelsByIdShort/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/GetAllSubmodelsByIdShort/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -1506,7 +1548,7 @@ Note: the creation of the idShort is out of scope and must be handled in a propr ==== -h|semanticId 4+|`\https://admin-shell.io/aas/API/PostSubmodel/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/PostSubmodel/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -1523,7 +1565,7 @@ h|Name h|Description h|Mand. h|Type h|Card. |=== h|Operation Name 4+e|[[PutSubmodelById]]PutSubmodelById h|Explanation 4+a|Creates a new or replaces an existing Submodel -h|semanticId 4+|`\https://admin-shell.io/aas/API/PutSubmodelById/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/PutSubmodelById/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -1540,7 +1582,7 @@ h|Name h|Description h|Mand. h|Type h|Card. |=== h|Operation Name 4+e|[[PatchSubmodelById]]PatchSubmodelById h|Explanation 4+a|Updates an existing Submodel -h|semanticId 4+|`\https://admin-shell.io/aas/API/PatchSubmodelById/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/PatchSubmodelById/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -1567,7 +1609,7 @@ Note: values remain unchanged with content=metadata. |=== h|Operation Name 4+e|[[DeleteSubmodelById]]DeleteSubmodelById h|Explanation 4+a|Deletes a Submodel -h|semanticId 4+|`\https://admin-shell.io/aas/API/DeleteSubmodelById/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/DeleteSubmodelById/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -1585,7 +1627,7 @@ e|statusCode a|Status code |yes |xref:specification/interfaces-payload.adoc#Stat |=== h|Operation Name 4+e|[[QuerySubmodels]]QuerySubmodels h|Explanation 4+a| Returns all Submodels that conform to a certain input query. -h|semanticId 4+|`\https://admin-shell.io/aas/API/QuerySubmodels/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/QuerySubmodels/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -1631,7 +1673,7 @@ e|xref:QueryConceptDescriptions[QueryConceptDescriptions] | Returns all Concept |=== h|Operation Name 4+e|[[GetAllConceptDescriptions]]GetAllConceptDescriptions h|Explanation 4+a|Returns all Concept Descriptions -h|semanticId 4+|`\https://admin-shell.io/aas/API/GetAllConceptDescriptions/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/GetAllConceptDescriptions/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -1649,7 +1691,7 @@ h|Name h|Description h|Mand. h|Type h|Card. |=== h|Operation Name 4+e|[[GetConceptDescriptionById]]GetConceptDescriptionById h|Explanation 4+a|Returns a specific Concept Description -h|semanticId 4+|`\https://admin-shell.io/aas/API/GetConceptDescriptionById/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/GetConceptDescriptionById/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -1666,7 +1708,7 @@ h|Name h|Description h|Mand. h|Type h|Card. |=== h|Operation Name 4+e|[[GetAllConceptDescriptionsByIdShort]]GetAllConceptDescriptionsByIdShort h|Explanation 4+a|Returns all Concept Descriptions with a specific _idShort_ -h|semanticId 4+|`\https://admin-shell.io/aas/API/GetAllConceptDescriptionsByIdShort/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/GetAllConceptDescriptionsByIdShort/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -1685,7 +1727,7 @@ h|Name h|Description h|Mand. h|Type h|Card. |=== h|Operation Name 4+e|[[GetAllConceptDescriptionsByIsCaseOf]]GetAllConceptDescriptionsByIsCaseOf h|Explanation 4+a|Returns all Concept Descriptions with a specific _IsCaseOf_ reference -h|semanticId 4+|`\https://admin-shell.io/aas/API/GetAllConceptDescriptionsByIsCaseOf/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/GetAllConceptDescriptionsByIsCaseOf/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -1704,7 +1746,7 @@ h|Name h|Description h|Mand. h|Type h|Card. |=== h|Operation Name 4+e|[[GetAllConceptDescriptionsByDataSpecificationReference]]GetAllConceptDescriptionsByDataSpecificationReference h|Explanation 4+a|Returns all Concept Descriptions with a specific _dataSpecification_ reference -h|semanticId 4+|`\https://admin-shell.io/aas/API/GetAllConceptDescriptionsByDataSpecificationReference/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/GetAllConceptDescriptionsByDataSpecificationReference/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -1732,7 +1774,7 @@ Note: the creation of the idShort is out of scope and must be handled in a propr ==== -h|semanticId 4+|`\https://admin-shell.io/aas/API/PostConceptDescription/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/PostConceptDescription/3/1` h|Name h|Description h|Mand. h|Type h|Card. @@ -1753,7 +1795,7 @@ h|Name h|Description h|Mand. h|Type h|Card. |=== h|Operation Name 4+e|[[PutConceptDescriptionById]]PutConceptDescriptionById h|Explanation 4+a|Creates or replaces an existing Concept Description -h|semanticId 4+|`\https://admin-shell.io/aas/API/PutConceptDescriptionById/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/PutConceptDescriptionById/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -1770,7 +1812,7 @@ h|Name h|Description h|Mand. h|Type h|Card. |=== h|Operation Name 4+e|[[DeleteConceptDescriptionById]]DeleteConceptDescriptionById h|Explanation 4+a|Deletes a Concept Description -h|semanticId 4+|`\https://admin-shell.io/aas/API/DeleteConceptDescriptionById/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/DeleteConceptDescriptionById/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -1786,7 +1828,7 @@ h|Name h|Description h|Mand. h|Type h|Card. |=== h|Operation Name 4+e|[[QueryConceptDescriptions]]QueryConceptDescriptions h|Explanation 4+a|Returns a list of Concept Descriptions based on an input query. -h|semanticId 4+|`\https://admin-shell.io/aas/API/QueryConceptDescriptions/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/QueryConceptDescriptions/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -1827,7 +1869,7 @@ e| xref:DeleteAllAssetLinksById[DeleteAllAssetLinksById] |Deletes all asset ide |=== h|Operation Name 4+e|[[GetAllAssetAdministrationShellIdsByAssetLink]]GetAllAssetAdministrationShellIdsByAssetLink \<> 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/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/GetAllAssetAdministrationShellIdsByAssetLink/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -1856,7 +1898,7 @@ It is the predefined key “_globalAssetId_” that would refer to the _AssetInf |=== h|Operation Name 4+e|[[GetAllAssetLinksById]]GetAllAssetLinksById h|Explanation 4+a|Returns a list of asset identifier key-value-pairs based on an Asset Administration Shell id to edit discoverable content -h|semanticId 4+|`\https://admin-shell.io/aas/API/GetAllAssetLinksById/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/GetAllAssetLinksById/3/1` h|Name h|Description h|Mand. h|Type h|Card. @@ -1884,7 +1926,7 @@ It is the predefined name “_globalAssetId_” that would refer to the _AssetIn |=== 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/2` +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 @@ -1913,7 +1955,7 @@ It is the predefined key “_globalAssetId_” that would refer to the _AssetInf h|Operation Name 4+e|[[PostAllAssetLinksById]]PostAllAssetLinksById h|Explanation 4+a| Creates or replaces all asset links associated to the Asset Administration Shell. -h|semanticId 4+|`\https://admin-shell.io/aas/API/PostAllAssetLinksById/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/PostAllAssetLinksById/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -1944,7 +1986,7 @@ Potentially included semanticId or supplementalSemanticIds are ignored. |=== h|Operation Name 4+e|[[DeleteAllAssetLinksById]]DeleteAllAssetLinksById h|Explanation 4+a|Deletes all asset identifier key-value-pairs linked to an Asset Administration Shell to edit discoverable content -h|semanticId 4+|`\https://admin-shell.io/aas/API/DeleteAllAssetLinksById/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/DeleteAllAssetLinksById/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter @@ -1971,7 +2013,7 @@ e|xref:GetSelfDescription[GetSelfDescription] |Returns a description object cont |=== h|Operation Name 4+e|[[GetSelfDescription]]GetSelfDescription h|Explanation 4+a|Returns a description object containing the capabilities and supported features of the server. -h|semanticId 4+|`\https://admin-shell.io/aas/API/GetSelfDescription/3/2` +h|semanticId 4+|`\https://admin-shell.io/aas/API/GetSelfDescription/3/1` h|Name h|Description h|Mand. h|Type h|Card. 5+h|Output Parameter