Create groups
post
/fscmRestApi/resources/11.13.18.05/assetGroups
Request
Header Parameters
-
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.
-
Upsert-Mode:
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:
Assignments
The Assignments resource manages the assignment and detachment of assets from groups. -
GroupDescription: string
Title:
Description
Maximum Length:240
Description 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 Values
The Grouping Attribute Values resource stores values for the grouping attributes as defined in the grouping rule. -
groupMember: array
Group Members
Title:
Group Members
The Group Members resource stores members of groups. -
GroupName: string
Title:
Name
Maximum Length:120
Name of the asset group. If you don't provide a value, the application uses the group number. -
GroupNumber: string
Title:
Number
Maximum Length:30
Number 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:
255
Abbreviation 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 Rules
The Asset Validation Rules resource stores values for the excluded assets in the group.
Nested Schema : Assignments
Type:
array
Title:
Assignments
The Assignments resource manages the assignment and detachment of assets from groups.
Show Source
Nested Schema : Grouping Attribute Values
Type:
array
Title:
Grouping Attribute Values
The Grouping Attribute Values resource stores values for the grouping attributes as defined in the grouping rule.
Show Source
Nested Schema : Group Members
Type:
array
Title:
Group Members
The Group Members resource stores members of groups.
Show Source
Nested Schema : Asset Validation Rules
Type:
array
Title:
Asset Validation Rules
The 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:
255
Default Value:BaseAssetNumber
Number 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 Date
Date 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 Date
Date 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:
30
Abbreviation that uniquely identifies the asset validation rule. You can provide either the validation code or name. -
ValidationName: string
Maximum Length:
255
Name 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:
Assignments
The Assignments resource manages the assignment and detachment of assets from groups. -
GroupDescription: string
Title:
Description
Maximum Length:240
Description 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 Values
The Grouping Attribute Values resource stores values for the grouping attributes as defined in the grouping rule. -
groupMember: array
Group Members
Title:
Group Members
The Group Members resource stores members of groups. -
GroupName: string
Title:
Name
Maximum Length:120
Name of the asset group. If you don't provide a value, the application uses the group number. -
GroupNumber: string
Title:
Number
Maximum Length:30
Number 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:
255
Abbreviation that uniquely identifies the asset group rule with which the group is associated. -
GroupRuleName: string
Title:
Group Rule
Read Only:true
Maximum Length:120
Name 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:
Links
The link relations associated with the resource instance. -
validationRule: array
Asset Validation Rules
Title:
Asset Validation Rules
The Asset Validation Rules resource stores values for the excluded assets in the group.
Nested Schema : Assignments
Type:
array
Title:
Assignments
The Assignments resource manages the assignment and detachment of assets from groups.
Show Source
Nested Schema : Grouping Attribute Values
Type:
array
Title:
Grouping Attribute Values
The Grouping Attribute Values resource stores values for the grouping attributes as defined in the grouping rule.
Show Source
Nested Schema : Group Members
Type:
array
Title:
Group Members
The Group Members resource stores members of groups.
Show Source
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Nested Schema : Asset Validation Rules
Type:
array
Title:
Asset Validation Rules
The 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:
255
Default Value:BaseAssetNumber
Number 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 Date
Date 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:
Links
The link relations associated with the resource instance.
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Nested Schema : link
Type:
Show Source
object
-
href: string
Title:
hyperlink reference
The URI to the related resource. -
kind: string
Title:
kind
Allowed Values:[ "collection", "item", "describe", "other" ]
The kind of the related resource. -
name: string
Title:
name
The name of the link to the related resource. -
properties: object
properties
-
rel: string
Title:
relation
Allowed 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:
Links
The link relations associated with the resource instance.
Nested Schema : Links
Type:
array
Title:
Links
The 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 Date
Date 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.
-
links: array
Links
Title:
Links
The link relations associated with the resource instance.
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Nested Schema : assetGroups-validationRule-item-response
Type:
Show Source
object
-
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
ValidationCode: string
Maximum Length:
30
Abbreviation that uniquely identifies the asset validation rule. You can provide either the validation code or name. -
ValidationName: string
Maximum Length:
255
Name 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:
array
Title:
Links
The 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: