Create groups
post
/fscmRestApi/resources/11.13.18.05/assetGroups
Request
Header Parameters
-
Metadata-Context: string
If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
-
REST-Framework-Version: string
The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
-
Upsert-Mode: string
Contains one of the following values: true or false. If true, the server performs an Upsert operation instead of a Create operation. During an Upsert operation, the server attempts to find an existing resource that matches the payload. If a match is found, the server updates the existing resource instead of creating a new one. If not found or false (default), the server performs a Create operation. Note that the Upsert operation isn't supported for date-effective REST resources.
Supported Media Types
- application/json
Root Schema : schema
Type:
Show Source
object-
assignments: array
Assignments
Title:
AssignmentsThe Assignments resource manages the assignment and detachment of assets from groups. -
GroupDescription: string
Title:
DescriptionMaximum Length:240Description of the asset group. You can use this attribute to describe the group features, characteristics, and so on. -
GroupId: integer
(int64)
Value that uniquely identifies the group. The application generates this value when it creates the group. This attribute is read-only.
-
groupingAttributeValues: array
Grouping Attribute Values
Title:
Grouping Attribute ValuesThe Grouping Attribute Values resource stores values for the grouping attributes as defined in the grouping rule. -
groupMember: array
Group Members
Title:
Group MembersThe Group Members resource stores members of groups. -
GroupName: string
Title:
NameMaximum Length:120Name of the asset group. If you don't provide a value, the application uses the group number. -
GroupNumber: string
Title:
NumberMaximum Length:30Number that identifies the group. This attribute is optional. If you don't provide a value, the application uses the group identifier. -
GroupRuleCode: string
Maximum Length:
255Abbreviation that uniquely identifies the asset group rule with which the group is associated. -
InactiveOnDate: string
(date)
Date and time when the asset group becomes inactive. When the group becomes inactive you can't add assets to it anymore.
-
validationRule: array
Asset Validation Rules
Title:
Asset Validation RulesThe Asset Validation Rules resource stores values for the excluded assets in the group.
Nested Schema : Assignments
Type:
arrayTitle:
AssignmentsThe Assignments resource manages the assignment and detachment of assets from groups.
Show Source
Nested Schema : Grouping Attribute Values
Type:
arrayTitle:
Grouping Attribute ValuesThe Grouping Attribute Values resource stores values for the grouping attributes as defined in the grouping rule.
Show Source
Nested Schema : Group Members
Type:
arrayTitle:
Group MembersThe Group Members resource stores members of groups.
Show Source
Nested Schema : Asset Validation Rules
Type:
arrayTitle:
Asset Validation RulesThe Asset Validation Rules resource stores values for the excluded assets in the group.
Show Source
Nested Schema : schema
Type:
Show Source
object-
AssetId: integer
(int64)
Value that uniquely identifies the asset belonging to the group. You can provide either the asset identifier or the asset number to create an asset group assignment.
-
AssetNumber: string
Maximum Length:
255Default Value:BaseAssetNumberNumber that uniquely identifies the asset belonging to the group. You can provide either the asset identifier or the asset number to create an asset group assignment. -
AssignmentEndDate: string
(date)
Title:
Assignment End DateDate when the assignment becomes inactive. This attribute is read-only. -
GroupId: integer
(int64)
Value that uniquely identifies the group. This value is automatically populated from the parent group. This attribute is read-only.
-
GroupMemberId: integer
(int64)
Value that uniquely identifies the group member. The application generates this value when it creates the assignment. This attribute is read-only.
Nested Schema : assetGroups-groupingAttributeValues-item-post-request
Type:
Show Source
object-
AttributeCode: string
Abbreviation that uniquely identifies the attribute. You can provide either the attribute code or the attribute name. A grouping attribute identifier is required to create the grouping attribute value.
-
AttributeName: string
Name of the attribute. You can provide either the attribute code or the attribute name. A grouping attribute identifier is required to create the grouping attribute value.
-
AttributeValue: string
Value for the attribute for the group. This attribute is required.
-
GroupValueId: integer
(int64)
Value that uniquely identifies the group attribute value. The application generates this value when it creates the group. This attribute is read-only.
Nested Schema : assetGroups-groupMember-item-post-request
Type:
Show Source
object-
ActiveEndDate: string
(date)
Title:
Assignment End DateDate and time when the group member becomes inactive. When the group member becomes inactive you can't add a record to it anymore. -
AssetId: integer
(int64)
Value that stores the unique identifier of the asset.
-
GroupId: integer
(int64)
Value that stores the unique identifier of the group.
-
GroupMemberId: integer
(int64)
Value that uniquely identifies the group member. The application generates this value when it creates the group member. This attribute is read-only.
Nested Schema : assetGroups-validationRule-item-post-request
Type:
Show Source
object-
ValidationCode: string
Maximum Length:
30Abbreviation that uniquely identifies the asset validation rule. You can provide either the validation code or name. -
ValidationName: string
Maximum Length:
255Name of the asset validation rule. You can provide either the validation code or name. Valid values are Exclude Asset from Contract and Exclude Asset from Service Request. -
ValidationRuleId: integer
(int64)
Value that uniquely identifies the group validation rule. The application generates this value when it creates the group validation rule. This attribute is read-only.
Response
Supported Media Types
- application/json
Default Response
The following table describes the default response for this task.
Headers
-
Metadata-Context:
If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
-
REST-Framework-Version:
The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Root Schema : assetGroups-item-response
Type:
Show Source
object-
assignments: array
Assignments
Title:
AssignmentsThe Assignments resource manages the assignment and detachment of assets from groups. -
GroupDescription: string
Title:
DescriptionMaximum Length:240Description of the asset group. You can use this attribute to describe the group features, characteristics, and so on. -
GroupId: integer
(int64)
Value that uniquely identifies the group. The application generates this value when it creates the group. This attribute is read-only.
-
groupingAttributeValues: array
Grouping Attribute Values
Title:
Grouping Attribute ValuesThe Grouping Attribute Values resource stores values for the grouping attributes as defined in the grouping rule. -
groupMember: array
Group Members
Title:
Group MembersThe Group Members resource stores members of groups. -
GroupName: string
Title:
NameMaximum Length:120Name of the asset group. If you don't provide a value, the application uses the group number. -
GroupNumber: string
Title:
NumberMaximum Length:30Number that identifies the group. This attribute is optional. If you don't provide a value, the application uses the group identifier. -
GroupRuleCode: string
Maximum Length:
255Abbreviation that uniquely identifies the asset group rule with which the group is associated. -
GroupRuleName: string
Title:
Group RuleRead Only:trueMaximum Length:120Name that identifies an asset group rule with which the group is associated. -
InactiveOnDate: string
(date)
Date and time when the asset group becomes inactive. When the group becomes inactive you can't add assets to it anymore.
-
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
validationRule: array
Asset Validation Rules
Title:
Asset Validation RulesThe Asset Validation Rules resource stores values for the excluded assets in the group.
Nested Schema : Assignments
Type:
arrayTitle:
AssignmentsThe Assignments resource manages the assignment and detachment of assets from groups.
Show Source
Nested Schema : Grouping Attribute Values
Type:
arrayTitle:
Grouping Attribute ValuesThe Grouping Attribute Values resource stores values for the grouping attributes as defined in the grouping rule.
Show Source
Nested Schema : Group Members
Type:
arrayTitle:
Group MembersThe Group Members resource stores members of groups.
Show Source
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : Asset Validation Rules
Type:
arrayTitle:
Asset Validation RulesThe Asset Validation Rules resource stores values for the excluded assets in the group.
Show Source
Nested Schema : assetGroups-assignments-item-response
Type:
Show Source
object-
AssetId: integer
(int64)
Value that uniquely identifies the asset belonging to the group. You can provide either the asset identifier or the asset number to create an asset group assignment.
-
AssetNumber: string
Maximum Length:
255Default Value:BaseAssetNumberNumber that uniquely identifies the asset belonging to the group. You can provide either the asset identifier or the asset number to create an asset group assignment. -
AssignmentEndDate: string
(date)
Title:
Assignment End DateDate when the assignment becomes inactive. This attribute is read-only. -
GroupId: integer
(int64)
Value that uniquely identifies the group. This value is automatically populated from the parent group. This attribute is read-only.
-
GroupMemberId: integer
(int64)
Value that uniquely identifies the group member. The application generates this value when it creates the assignment. This attribute is read-only.
-
links: array
Links
Title:
LinksThe link relations associated with the resource instance.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : link
Type:
Show Source
object-
href: string
Title:
hyperlink referenceThe URI to the related resource. -
kind: string
Title:
kindAllowed Values:[ "collection", "item", "describe", "other" ]The kind of the related resource. -
name: string
Title:
nameThe name of the link to the related resource. -
properties: object
properties
-
rel: string
Title:
relationAllowed Values:[ "self", "lov", "parent", "canonical", "child", "enclosure", "action", "custom" ]The name of the relation to the resource instance. Example: self.
Nested Schema : properties
Type:
Show Source
object-
changeIndicator: string
Change indicator or the ETag value of the resource instance.
Nested Schema : assetGroups-groupingAttributeValues-item-response
Type:
Show Source
object-
AttributeCode: string
Abbreviation that uniquely identifies the attribute. You can provide either the attribute code or the attribute name. A grouping attribute identifier is required to create the grouping attribute value.
-
AttributeName: string
Name of the attribute. You can provide either the attribute code or the attribute name. A grouping attribute identifier is required to create the grouping attribute value.
-
AttributeValue: string
Value for the attribute for the group. This attribute is required.
-
GroupValueId: integer
(int64)
Value that uniquely identifies the group attribute value. The application generates this value when it creates the group. This attribute is read-only.
-
links: array
Links
Title:
LinksThe link relations associated with the resource instance.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : assetGroups-groupMember-item-response
Type:
Show Source
object-
ActiveEndDate: string
(date)
Title:
Assignment End DateDate and time when the group member becomes inactive. When the group member becomes inactive you can't add a record to it anymore. -
AssetId: integer
(int64)
Value that stores the unique identifier of the asset.
-
AssetNumber: string
Read Only:
trueMaximum Length:255Number that uniquely identifies an asset. -
GroupId: integer
(int64)
Value that stores the unique identifier of the group.
-
GroupMemberId: integer
(int64)
Value that uniquely identifies the group member. The application generates this value when it creates the group member. This attribute is read-only.
-
links: array
Links
Title:
LinksThe link relations associated with the resource instance.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : assetGroups-validationRule-item-response
Type:
Show Source
object-
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
ValidationCode: string
Maximum Length:
30Abbreviation that uniquely identifies the asset validation rule. You can provide either the validation code or name. -
ValidationName: string
Maximum Length:
255Name of the asset validation rule. You can provide either the validation code or name. Valid values are Exclude Asset from Contract and Exclude Asset from Service Request. -
ValidationRuleId: integer
(int64)
Value that uniquely identifies the group validation rule. The application generates this value when it creates the group validation rule. This attribute is read-only.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Links
- assignments
-
Parameters:
- GroupId:
$request.path.GroupId
The Assignments resource manages the assignment and detachment of assets from groups. - GroupId:
- groupMember
-
Parameters:
- GroupId:
$request.path.GroupId
The Group Members resource stores members of groups. - GroupId:
- groupingAttributeValues
-
Parameters:
- GroupId:
$request.path.GroupId
The Grouping Attribute Values resource stores values for the grouping attributes as defined in the grouping rule. - GroupId:
- validationRule
-
Parameters:
- GroupId:
$request.path.GroupId
The Asset Validation Rules resource stores values for the excluded assets in the group. - GroupId: