This operation creates new tags for one or more entities, in a CommCell environment.
Request
Syntax
Send the request using either XML or JSON.
GET <webservice>/tags
Host: <host name>
Accept: {application/xml | application/json}
Authtoken: <authentication token>
Content-type: application/json
<create_entity_tag_template.json>
where <webservice> is the root path used to route the API requests to the Web Server.
For more information, see Available Web Services for REST API.
Request Headers
Name | Description |
---|---|
Host | The host name of the Web Server or the Web Console that is used in the API request. |
Accept | The format of the response. Valid values are: application/xml or application/json. |
Authtoken | The authentication token that is received after a successful log on. For more information about receiving an authentication token, see Authentication. |
Request Body
Download the JSON file that is required for this request: create_entity_tag_template.json. The following table displays the parameters for the request body.
Name | Description | Elements |
---|---|---|
entityType | The type of the entity. Valid values are:
| tags |
entityId | The ID for the entity of a particular entity type. | tags |
name | The entity tag name. Valid values are a maximum of 512 characters in length and can consist of any combination of characters. | tag |
value | The entity tag value. Valid values are a maximum of 1024 characters in length and can consist of any combination of characters. | tag |
Response
Response Parameters
Name | Description | Elements |
---|---|---|
errorCode | The error code. Valid values are:
| Api_GenericResp |
Examples
Sample Request
POST <webservice>/tags
Accept: application/json
Authtoken: QSDK 38568012f4d1e8ee1841d283a47aa3ba78e124ea58354b5fc60f4dab8a63347d05cf5552484dafda3bfa4c5db84e580b1cb37bcf8e65b39f7f8549a443e6f78a2c7be3f31b3d845e24776c835e498e8e883bb40c46bd15af4f40ca94e823acedcdd4e9659e74b34a07a85c4586cd2ed914b6dce015874783ef768fda78183a4208930954a377f66eb56c8b92cexampl4s437a19317ca6ce7f3233d5a01aca35dbad93468b833f2cf71010809006a937670adce711ca8be46638e8
Content-Type: application/json
{
"entityTag": [
{
"entityType": 3,
"entityId": 9,
"tag": [
{
"name": "Brand",
"value": "ABC"
}
]
},
{
"entityType": 3,
"entityId": 8,
"tag": [
{
"name": "Brand",
"value": "XYZ"
}
]
}
]
}
Sample Response
{}