Merge pull request #104663 from Juliako/multipleoutputs

started adding content

Author: TedA-M

articles/media-services/latest/TOC.yml

@@ -228,7 +228,9 @@
       href: cli-create-transform.md
     - name: Create jobs - CLI
       href: cli-create-jobs.md
-  - name: Encode content
+    - name: Jobs with multiple transform outputs
+      href: job-multiple-transform-outputs.md
+  - name: Encode content 
     items:
     - name: HTTPS as Job input - .NET
       displayName: encode, encoding

articles/media-services/latest/job-multiple-transform-outputs.md

@@ -0,0 +1,134 @@
+---
+title: Create an Azure Media Services job with multiple transform outputs
+description: This topic demonstrates how to create an  Azure Media Services job with multiple transform outputs.
+services: media-services
+documentationcenter: ''
+author: Juliako
+manager: femila
+editor: ''
+
+ms.service: media-services
+ms.workload: 
+ms.topic: article
+ms.date: 02/17/2020
+ms.author: juliako
+---
+
+# Create a job with multiple transform outputs
+
+This topic shows how to create a Transform with two Transform Outputs. The first one calls for the input to be encoded for adaptive bitrate streaming with a built-in [AdaptiveStreaming](encoding-concept.md#builtinstandardencoderpreset) preset. The second one calls for the audio signal in the input video to be processed with the [AudioAnalyzerPreset](analyzing-video-audio-files-concept.md#built-in-presets). After the Transform is created, you can submit a job that will process your video accordingly. Since in this example we are specifying two Transform Outputs, we must specify two Job Outputs. You can choose to direct both Job Outputs to the same Asset (as shown below), or you can have the results be written to separate Assets.
+ 
+
+> [!TIP]
+> Before you start developing, review [Developing with Media Services v3 APIs](media-services-apis-overview.md) (includes information on accessing APIs, naming conventions, etc.)
+
+## Create a transform
+
+The following code shows how to create a transform that produces two outputs.
+
+```csharp
+private static async Task<Transform> GetOrCreateTransformAsync(
+    IAzureMediaServicesClient client,
+    string resourceGroupName,
+    string accountName,
+    string transformName)
+{
+    // Does a Transform already exist with the desired name? Assume that an existing Transform with the desired name
+    // also uses the same recipe or Preset for processing content.
+    Transform transform = await client.Transforms.GetAsync(resourceGroupName, accountName, transformName);
+
+    if (transform == null)
+    {
+        // You need to specify what you want it to produce as an output
+        TransformOutput[] output = new TransformOutput[]
+        {
+            new TransformOutput
+            {
+                Preset = new BuiltInStandardEncoderPreset()
+                {
+                    // This sample uses the built-in encoding preset for Adaptive Bitrate Streaming.
+                    PresetName = EncoderNamedPreset.AdaptiveStreaming
+                }
+            },
+            // Create an analyzer preset with video insights.
+            new TransformOutput(new AudioAnalyzerPreset("en-US"))
+        };
+
+        // Create the Transform with the output defined above
+        transform = await client.Transforms.CreateOrUpdateAsync(resourceGroupName, accountName, transformName, output);
+    }
+
+    return transform;
+}
+```
+## Submit a job
+
+Create a job with an HTTPS URL input and with two job outputs.
+
+```csharp
+private static async Task<Job> SubmitJobAsync(IAzureMediaServicesClient client,
+    string resourceGroup,
+    string accountName,
+    string transformName)
+{
+    // Output from the encoding Job must be written to an Asset, so let's create one
+    string outputAssetName1 = $"output-" + Guid.NewGuid().ToString("N");
+    Asset outputAsset = await client.Assets.CreateOrUpdateAsync(resourceGroup, accountName, outputAssetName1, new Asset());
+
+    // This example shows how to encode from any HTTPs source URL - a new feature of the v3 API.  
+    // Change the URL to any accessible HTTPs URL or SAS URL from Azure.
+    JobInputHttp jobInput =
+        new JobInputHttp(files: new[] { "https://nimbuscdn-nimbuspm.streaming.mediaservices.windows.net/2b533311-b215-4409-80af-529c3e853622/Ignite-short.mp4" });
+
+    JobOutput[] jobOutputs =
+    {
+        // Since we are specifying two Transform Outputs, two Job Outputs are needed.
+        // In this example, the first Job Output is for the results from adaptive bitrate encoding,
+        // and the second is for the results from audio analysis. In this example, both are written to the
+        // same output Asset. Or, you can specify different Assets.
+        
+        new JobOutputAsset(outputAsset.Name),
+        new JobOutputAsset(outputAsset.Name)
+
+    };
+
+    // In this example, we are using a unique job name.
+    //
+    // If you already have a job with the desired name, use the Jobs.Get method
+    // to get the existing job. In Media Services v3, Get methods on entities returns null 
+    // if the entity doesn't exist (a case-insensitive check on the name).
+    Job job;
+    try
+    {
+        string jobName = $"job-" + Guid.NewGuid().ToString("N");
+        job = await client.Jobs.CreateAsync(
+                    resourceGroup,
+                    accountName,
+                    transformName,
+                    jobName,
+                    new Job
+                    {
+                        Input = jobInput,
+                        Outputs = jobOutputs,
+                    });
+    }
+    catch (Exception exception)
+    {
+        if (exception.GetBaseException() is ApiErrorException apiException)
+        {
+            Console.Error.WriteLine(
+                $"ERROR: API call failed with error code '{apiException.Body.Error.Code}' and message '{apiException.Body.Error.Message}'.");
+        }
+        throw exception;
+    }
+
+    return job;
+}
+```
+## Job error codes
+
+See [Error codes](https://docs.microsoft.com/rest/api/media/jobs/get#joberrorcode).
+
+## Next steps
+
+[Azure Media Services v3 samples using .NET](https://github.com/Azure-Samples/media-services-v3-dotnet/tree/master/)