Assign Shell groups
Shell groups allow to structure a (large) set of Asset Administration Shells, possibly with very similar Submodels (aspects).
A Shell group is an entity in the Digital Twin Registry to which a Shell may be related. A Shell may be a member in several Shell groups.
For each tenant, each Shell group must have a unique name. Additionally, the group can have a textual description.
For each Shell group there might be attached up to 50 Submodel Templates. See also Use Submodel Descriptor Templates for further information about managing Submodel Templates.
Managing Shell groups
Shell groups have their own REST resource that offers the corresponding CRUD operations to create, retrieve, update, or delete a Shell group.
Refer to the description of the Shell Group endpoint
in the API docs.
| The Update and Patch REST operations affect the name and description of an existing Shell group and do not allow to change the set of Submodel Templates attached to the group. For de-attaching or attaching Submodel templates to Shell groups, please follow details described at this page: Use Submodel Descriptor Templates. |
Relating Shells and Shell groups
The relation of a Shell with one or more Shell groups is managed solely via the Asset Administration Shell Registry endpoint, which is used for all Shell and submodel descriptor operations.
-
Its Registration endpoint
allows to register a Shell with a list of Shell groups. -
The Update endpoint
allows to modify the set of Shell groups in which a Shell is a member.
Example
To create a Shell group, it is enough to give it a name and a description in the request.
{
"name": "ABCD",
"description": "This is an example description for the ABCD Shell group"
}Upon the creation of the Shell group, a group id is automatically generated. This id is then included in the request, when you assign Shells to the particular group.