Merge pull request #191305 from IngridAtMicrosoft/jobs

denrea · web-flow · commit b990ee5fea25 · 2022-03-10T13:31:58.000-08:00
Jobs
diff --git a/articles/media-services/latest/TOC.yml b/articles/media-services/latest/TOC.yml
@@ -552,9 +552,18 @@
       href: transform-delete-transform-how-to.md
   - name: Create jobs
     items:
-    - name: Create jobs
-      href: job-create-cli-how-to.md
-      displayName: CLI, create job, jobs, submit job, encode with CLI, encode
+    - name: Create or start a job
+      href: job-create-how-to.md
+    - name: List jobs
+      href: job-list-how-to.md
+    - name: Show or get the details of a job
+      href: job-show-how-to.md
+    - name: Cancel a job
+      href: job-cancel-how-to.md
+    - name: Update a job
+      href: job-update-how-to.md
+    - name: Delete a job
+      href: job-delete-how-to.md
     - name: Create job input with a local file
       displayName: upload, upload file, ingest file, local file, uploading, CLI
       href: job-input-from-local-file-how-to.md
diff --git a/articles/media-services/latest/includes/task-cancel-job-cli.md b/articles/media-services/latest/includes/task-cancel-job-cli.md
@@ -0,0 +1,13 @@
+---
+author: IngridAtMicrosoft
+ms.service: media-services 
+ms.topic: include
+ms.date: 03/10/2022
+ms.author: inhenkel
+---
+
+## Cancel a job with the CLI
+
+:::code language="azurecli" source="~/media-services-v3-python/cli/code-snippets.sh" id="AmsJobCancel" interactive="azurecli-interactive":::
+
+For more information about this command, see the [CLI reference](/cli/azure/ams/job?view=azure-cli-latest#az-ams-job-cancel).
diff --git a/articles/media-services/latest/includes/task-cancel-job-rest.md b/articles/media-services/latest/includes/task-cancel-job-rest.md
@@ -0,0 +1,11 @@
+---
+author: IngridAtMicrosoft
+ms.service: media-services 
+ms.topic: include
+ms.date: 03/10/2022
+ms.author: inhenkel
+---
+
+## Cancel a job with REST
+
+See the Media Services [REST API](/rest/api/media/jobs/cancel-job)
diff --git a/articles/media-services/latest/includes/task-create-job-cli.md b/articles/media-services/latest/includes/task-create-job-cli.md
@@ -0,0 +1,13 @@
+---
+author: IngridAtMicrosoft
+ms.service: media-services 
+ms.topic: include
+ms.date: 03/10/2022
+ms.author: inhenkel
+---
+
+## Create a job with the CLI
+
+:::code language="azurecli" source="~/media-services-v3-python/cli/code-snippets.sh" id="AmsJobStart" interactive="azurecli-interactive":::
+
+For more information about this command, see the [CLI reference](/cli/azure/ams/job?view=azure-cli-latest#az-ams-job-start).
diff --git a/articles/media-services/latest/includes/task-create-job-rest.md b/articles/media-services/latest/includes/task-create-job-rest.md
@@ -0,0 +1,11 @@
+---
+author: IngridAtMicrosoft
+ms.service: media-services 
+ms.topic: include
+ms.date: 03/10/2022
+ms.author: inhenkel
+---
+
+## Create a job with REST
+
+See the Media Services [REST API](/rest/api/media/jobs/create)
diff --git a/articles/media-services/latest/includes/task-delete-job-cli.md b/articles/media-services/latest/includes/task-delete-job-cli.md
@@ -0,0 +1,13 @@
+---
+author: IngridAtMicrosoft
+ms.service: media-services 
+ms.topic: include
+ms.date: 03/10/2022
+ms.author: inhenkel
+---
+
+## Delete a job with the CLI
+
+:::code language="azurecli" source="~/media-services-v3-python/cli/code-snippets.sh" id="AmsJobDelete" interactive="azurecli-interactive":::
+
+For more information about this command, see the [CLI reference](/cli/azure/ams/job?view=azure-cli-latest#az-ams-job-delete).
diff --git a/articles/media-services/latest/includes/task-delete-job-rest.md b/articles/media-services/latest/includes/task-delete-job-rest.md
@@ -0,0 +1,11 @@
+---
+author: IngridAtMicrosoft
+ms.service: media-services 
+ms.topic: include
+ms.date: 03/10/2022
+ms.author: inhenkel
+---
+
+## Delete a job with REST
+
+See the Media Services [REST API](/rest/api/media/jobs/delete)
diff --git a/articles/media-services/latest/includes/task-get-job-rest.md b/articles/media-services/latest/includes/task-get-job-rest.md
@@ -0,0 +1,11 @@
+---
+author: IngridAtMicrosoft
+ms.service: media-services 
+ms.topic: include
+ms.date: 03/10/2022
+ms.author: inhenkel
+---
+
+## Get a job with REST
+
+See the Media Services [REST API](/rest/api/media/jobs/get)
diff --git a/articles/media-services/latest/includes/task-list-job-cli.md b/articles/media-services/latest/includes/task-list-job-cli.md
@@ -0,0 +1,13 @@
+---
+author: IngridAtMicrosoft
+ms.service: media-services 
+ms.topic: include
+ms.date: 03/10/2022
+ms.author: inhenkel
+---
+
+## List jobs with the CLI
+
+:::code language="azurecli" source="~/media-services-v3-python/cli/code-snippets.sh" id="AmsJobList" interactive="azurecli-interactive":::
+
+For more information about this command, see the [CLI reference](/cli/azure/ams/job?view=azure-cli-latest#az-ams-job-list).
diff --git a/articles/media-services/latest/includes/task-list-job-rest.md b/articles/media-services/latest/includes/task-list-job-rest.md
@@ -0,0 +1,11 @@
+---
+author: IngridAtMicrosoft
+ms.service: media-services 
+ms.topic: include
+ms.date: 03/10/2022
+ms.author: inhenkel
+---
+
+## List jobs with REST
+
+See the Media Services [REST API](/rest/api/media/jobs/list)
diff --git a/articles/media-services/latest/includes/task-show-job-cli.md b/articles/media-services/latest/includes/task-show-job-cli.md
@@ -0,0 +1,13 @@
+---
+author: IngridAtMicrosoft
+ms.service: media-services 
+ms.topic: include
+ms.date: 03/10/2022
+ms.author: inhenkel
+---
+
+## Show the details of a job with the CLI
+
+:::code language="azurecli" source="~/media-services-v3-python/cli/code-snippets.sh" id="AmsJobShow" interactive="azurecli-interactive":::
+
+For more information about this command, see the [CLI reference](/cli/azure/ams/job?view=azure-cli-latest#az-ams-job-show).
diff --git a/articles/media-services/latest/includes/task-start-job-cli.md b/articles/media-services/latest/includes/task-start-job-cli.md
@@ -0,0 +1,13 @@
+---
+author: IngridAtMicrosoft
+ms.service: media-services 
+ms.topic: include
+ms.date: 08/18/2020
+ms.author: inhenkel
+---
+
+## Start a job with the CLI
+
+:::code language="azurecli" source="~/media-services-v3-python/cli/code-snippets.sh" id="AmsJobStart" interactive="azurecli-interactive":::
+
+For more information about this command, see the [CLI reference](/cli/azure/ams/job?view=azure-cli-latest#az-ams-job-start).
diff --git a/articles/media-services/latest/includes/task-update-job-cli.md b/articles/media-services/latest/includes/task-update-job-cli.md
@@ -0,0 +1,13 @@
+---
+author: IngridAtMicrosoft
+ms.service: media-services 
+ms.topic: include
+ms.date: 03/10/2022
+ms.author: inhenkel
+---
+
+## Update a job with the CLI
+
+:::code language="azurecli" source="~/media-services-v3-python/cli/code-snippets.sh" id="AmsJobUpdate" interactive="azurecli-interactive":::
+
+For more information about this command, see the [CLI reference](/cli/azure/ams/job?view=azure-cli-latest#az-ams-job-update).
diff --git a/articles/media-services/latest/includes/task-update-job-rest.md b/articles/media-services/latest/includes/task-update-job-rest.md
@@ -0,0 +1,11 @@
+---
+author: IngridAtMicrosoft
+ms.service: media-services 
+ms.topic: include
+ms.date: 03/10/2022
+ms.author: inhenkel
+---
+
+## Update a job with REST
+
+See the Media Services [REST API](/rest/api/media/jobs/update)
diff --git a/articles/media-services/latest/job-cancel-how-to.md b/articles/media-services/latest/job-cancel-how-to.md
@@ -0,0 +1,29 @@
+---
+title: Cancel a job
+description: This article shows how to cancel a job.
+services: media-services
+author: IngridAtMicrosoft
+manager: femila 
+ms.service: media-services
+ms.topic: how-to
+ms.date: 03/10/2022
+ms.author: inhenkel
+---
+
+# Cancel a job
+
+[!INCLUDE [media services api v3 logo](./includes/v3-hr.md)]
+
+## Methods
+
+Use the following methods to cancel a job.
+
+## [CLI](#tab/cli/)
+
+[!INCLUDE [Create an asset with CLI](includes/task-cancel-job-cli.md)]
+
+## [REST](#tab/rest/)
+
+[!INCLUDE [Create an asset with CLI](includes/task-cancel-job-rest.md)]
+
+---
diff --git a/articles/media-services/latest/job-create-how-to.md b/articles/media-services/latest/job-create-how-to.md
@@ -20,64 +20,16 @@ In Media Services v3, when you submit Jobs to process your videos, you have to t
 
 [Create a Media Services account](./account-create-how-to.md).
 
-## [Portal](#tab/rest/)
+## [Portal](#tab/portal/)
 
-[!INCLUDE [task general transform creation](./includes/task-create-job-portal.md)]
+[!INCLUDE [rest](./includes/task-create-job-portal.md)]
 
 ## [CLI](#tab/cli/)
 
-## Example script
+[!INCLUDE [cli](./includes/task-create-job-cli.md)]
 
-When you run `az ams job start`, you can set a label on the job's output. The label can later be used to identify what this output asset is for. 
+## [REST](#tab/rest/)
 
-- If you assign a value to the label, set ‘--output-assets’ to “assetname=label”
-- If you do not assign a value to the label, set ‘--output-assets’ to “assetname=”.
-  Notice that you add "=" to the `output-assets`. 
-
-```azurecli
-az ams job start \
-  --name testJob001 \
-  --transform-name testEncodingTransform \
-  --base-uri 'https://nimbuscdn-nimbuspm.streaming.mediaservices.windows.net/2b533311-b215-4409-80af-529c3e853622/' \
-  --files 'Ignite-short.mp4' \
-  --output-assets testOutputAssetName= \
-  -a amsaccount \
-  -g amsResourceGroup 
-```
-
-You get a response similar to this:
-
-```
-{
-  "correlationData": {},
-  "created": "2019-02-15T05:08:26.266104+00:00",
-  "description": null,
-  "id": "/subscriptions/<id>/resourceGroups/amsResourceGroup/providers/Microsoft.Media/mediaservices/amsaccount/transforms/testEncodingTransform/jobs/testJob001",
-  "input": {
-    "baseUri": "https://nimbuscdn-nimbuspm.streaming.mediaservices.windows.net/2b533311-b215-4409-80af-529c3e853622/",
-    "files": [
-      "Ignite-short.mp4"
-    ],
-    "label": null,
-    "odatatype": "#Microsoft.Media.JobInputHttp"
-  },
-  "lastModified": "2019-02-15T05:08:26.266104+00:00",
-  "name": "testJob001",
-  "outputs": [
-    {
-      "assetName": "testOutputAssetName",
-      "error": null,
-      "label": "",
-      "odatatype": "#Microsoft.Media.JobOutputAsset",
-      "progress": 0,
-      "state": "Queued"
-    }
-  ],
-  "priority": "Normal",
-  "resourceGroup": "amsResourceGroup",
-  "state": "Queued",
-  "type": "Microsoft.Media/mediaservices/transforms/jobs"
-}
-```
+[!INCLUDE [cli](./includes/task-create-job-rest.md)]
 
 ---
diff --git a/articles/media-services/latest/job-delete-how-to.md b/articles/media-services/latest/job-delete-how-to.md
@@ -0,0 +1,29 @@
+---
+title: Delete a job
+description: This article shows how to delete a job.
+services: media-services
+author: IngridAtMicrosoft
+manager: femila 
+ms.service: media-services
+ms.topic: how-to
+ms.date: 03/10/2022
+ms.author: inhenkel
+---
+
+# Delete a job
+
+[!INCLUDE [media services api v3 logo](./includes/v3-hr.md)]
+
+## Methods
+
+Use the following methods to delete a job.
+
+## [CLI](#tab/cli/)
+
+[!INCLUDE [Create an asset with CLI](includes/task-delete-job-cli.md)]
+
+## [REST](#tab/rest/)
+
+[!INCLUDE [Create an asset with CLI](includes/task-delete-job-rest.md)]
+
+---
diff --git a/articles/media-services/latest/job-list-how-to.md b/articles/media-services/latest/job-list-how-to.md
@@ -0,0 +1,29 @@
+---
+title: List jobs
+description: This article shows how to list jobs.
+services: media-services
+author: IngridAtMicrosoft
+manager: femila 
+ms.service: media-services
+ms.topic: how-to
+ms.date: 03/10/2022
+ms.author: inhenkel
+---
+
+# List jobs
+
+[!INCLUDE [media services api v3 logo](./includes/v3-hr.md)]
+
+## Methods
+
+Use the following methods to list jobs.
+
+## [CLI](#tab/cli/)
+
+[!INCLUDE [Create an asset with CLI](includes/task-list-job-cli.md)]
+
+## [REST](#tab/rest/)
+
+[!INCLUDE [Create an asset with CLI](includes/task-list-job-rest.md)]
+
+---
diff --git a/articles/media-services/latest/job-show-how-to.md b/articles/media-services/latest/job-show-how-to.md
@@ -0,0 +1,29 @@
+---
+title: Show or get a job
+description: This article shows how to show or get a job.
+services: media-services
+author: IngridAtMicrosoft
+manager: femila 
+ms.service: media-services
+ms.topic: how-to
+ms.date: 03/10/2022
+ms.author: inhenkel
+---
+
+# Show the details of a job
+
+[!INCLUDE [media services api v3 logo](./includes/v3-hr.md)]
+
+## Methods
+
+Use the following methods to show or get a job.
+
+## [CLI](#tab/cli/)
+
+[!INCLUDE [Create an asset with CLI](includes/task-show-job-cli.md)]
+
+## [REST](#tab/rest/)
+
+[!INCLUDE [Create an asset with CLI](includes/task-get-job-rest.md)]
+
+---
diff --git a/articles/media-services/latest/job-update-how-to.md b/articles/media-services/latest/job-update-how-to.md
