Merge pull request #197522 from v-krishnag/restjob

update rest api jobs

Author: PRMerger5

articles/iot-central/core/howto-manage-jobs-with-rest-api.md

@@ -226,17 +226,50 @@ The response to this request looks like the following example:
 
 ## Create a job
 
-Use the following request to retrieve the details of the devices in a job:
+Use the following request to create a job:
 
 ```http
 PUT https://{your app subdomain}.azureiotcentral.com/api/jobs/job-006?api-version=1.2-preview
 ```
 
+The `group` field in the request body identifies a device group in your IoT Central application. A job uses a device group to identify the set of devices the job operates on.
+
+
+If you don't already have a suitable device group, you can create one with REST API call. The following example creates a device group with `group1` as the group ID:
+
+```http
+PUT https://{subdomain}.{baseDomain}/api/deviceGroups/group1?api-version=1.2-preview
+```
+
+When you create a device group, you define a `filter` that selects the devices to include in the group. A filter identifies a device template and any properties to match. The following example creates device group that contains all devices associated with the "dtmi:modelDefinition:dtdlv2" device template where the `provisioned` property is `true`.
+
+```json
+{
+  "displayName": "Device group 1",
+  "description": "Custom device group.",
+  "filter": "SELECT * FROM devices WHERE $template = \"dtmi:modelDefinition:dtdlv2\" AND $provisioned = true"
+}
+```
+
+The response to this request looks like the following example: 
+
+```json
+{
+  "id": "group1",
+  "displayName": "Device group 1",
+  "description": "Custom device group.",
+  "filter": "SELECT * FROM devices WHERE $template = \"dtmi:modelDefinition:dtdlv2\" AND $provisioned = true"
+}
+```
+
+You can now use the `id` value from the response to create a new job.
+
+
 ```json
 {
   "displayName": "Set target temperature",
   "description": "Set target temperature device property",
-  "group": "833d7a7d-8f99-4e04-9e56-745806bdba6e",
+  "group": "group1",
   "batch": {
     "type": "percentage",
     "value": 25
@@ -264,7 +297,7 @@ The response to this request looks like the following example. The initial job s
   "id": "job-006",
   "displayName": "Set target temperature",
   "description": "Set target temperature device property",
-  "group": "833d7a7d-8f99-4e04-9e56-745806bdba6e",
+  "group": "group1",
   "batch": {
     "type": "percentage",
     "value": 25