Merge pull request #107399 from Juliako/se

new topic

Author: American-Dipper

articles/media-services/latest/TOC.yml

@@ -8,12 +8,12 @@
     displayName: release notes
     href: release-notes.md
 - name: Quickstarts
+  expanded: true
   items:
   - name: Live event with portal and Wirecast
     displayName: live, event, portal, wirecast
     href: live-events-wirecast-quickstart.md
 - name: Tutorials
-  expanded: true
   items:
   - name: Encode remote file and stream video
     items:
@@ -42,7 +42,7 @@
     href: protect-with-drm.md   
 - name: Samples
   items:    
-  - name: Media Services samples
+  - name: Media Services v3 samples
     displayName: .NET, Java
     href: https://docs.microsoft.com/samples/browse/?products=azure-media-services
   - name: Media Services v3 REST samples
@@ -70,9 +70,7 @@
     items:
     - name: Transforms and Jobs
       href: transforms-jobs-concept.md 
-      displayName: preset, schema 
-    - name: Error codes
-      href: job-error-codes.md         
+      displayName: preset, schema         
   - name: Encoding content
     items:
     - name: Overview
@@ -91,9 +89,7 @@
       href: analyzing-video-audio-files-concept.md
       displayName: analyzing, presets, jobs
     - name: Transforms and Jobs
-      href: transforms-jobs-concept.md 
-    - name: Job error codes
-      href: job-error-codes.md     
+      href: transforms-jobs-concept.md    
   - name: Live streaming 
     items:
     - name: Overview
@@ -114,10 +110,6 @@
       href: live-event-states-billing.md
     - name: Latency
       href: live-event-latency.md  
-    - name: Become an on-premises encoder partner
-      href: become-on-premises-encoder-partner.md      
-    - name: Live Event error codes
-      href: live-event-error-codes.md
   - name: Packaging and delivery
     items:
     - name: Dynamic packaging
@@ -137,9 +129,7 @@
       displayName: URLs
       href: streaming-locators-concept.md
     - name: Streaming Policies 
-      href: streaming-policy-concept.md  
-    - name: Streaming Endpoint error codes  
-      href: streaming-endpoint-error-codes.md          
+      href: streaming-policy-concept.md        
   - name: Content protection
     items:
     - name: Dynamic encryption and key delivery
@@ -211,20 +201,24 @@
   items:
   - name: Get started
     items:
-    - name: Create an account - portal
-      href: create-account-portal.md
-    - name: Create an account - CLI
-      href: create-account-cli-how-to.md  
-      displayName: storage
-    - name: Reset the account credentials - CLI
+    - name: Create an account
+      items:
+      - name: With portal
+        href: create-account-portal.md
+      - name: With CLI
+        href: create-account-cli-how-to.md  
+        displayName: storage
+    - name: Reset the account credentials
       href: cli-reset-account-credentials.md   
-    - name: Access APIs - portal
-      href: access-api-portal.md   
-    - name: Access APIs - CLI
-      href: access-api-cli-how-to.md
-    - name: Scale Media Reserved Units - CLI
+    - name: Access APIs
+      items:
+      - name: With portal
+        href: access-api-portal.md   
+      - name: With CLI
+        href: access-api-cli-how-to.md
+    - name: Scale Media Reserved Units
       href: media-reserved-units-cli-how-to.md   
-    - name: Create an Asset - CLI
+    - name: Create an Asset
       href: cli-create-asset.md 
   - name: Developer guides
     items:
@@ -244,31 +238,33 @@
         href: configure-connect-python-howto.md
   - name: Upload content
     items:
-    - name: From HTTPS - .NET
+    - name: From HTTPS
       displayName: upload
       href: job-input-from-http-how-to.md
-    - name: From a local file - .NET
-      displayName: upload
-      href: job-input-from-local-file-how-to.md  
-    - name: From a local file - REST
-      displayName: upload
-      href: upload-files-rest-how-to.md
-    - name: From a local file - CLI
-      href: cli-upload-file-asset.md     
+    - name: From a local file
+      items:
+      - name: With .NET
+        displayName: upload
+        href: job-input-from-local-file-how-to.md  
+      - name: With REST
+        displayName: upload
+        href: upload-files-rest-how-to.md
+      - name: With CLI
+        href: cli-upload-file-asset.md     
   - name: Create transforms and jobs
     items:
-    - name: Create transforms - CLI
+    - name: Create transforms
       href: cli-create-transform.md
-    - name: Create jobs - CLI
+    - name: Create jobs
       href: cli-create-jobs.md
     - name: Jobs with multiple transform outputs
       href: job-multiple-transform-outputs.md
   - name: Encode content 
     items:
-    - name: HTTPS as Job input - .NET
+    - name: HTTPS as Job input
       displayName: encode, encoding
       href: job-input-from-http-how-to.md
-    - name: Local file as Job input - .NET
+    - name: Local file as Job input
       displayName: encode, encoding
       href: job-input-from-local-file-how-to.md    
     - name: Encode with a custom Transform
@@ -289,7 +285,15 @@
         displayName: subclipping, clip, edit, trim, clipping
       - name: With REST
         href: subclip-video-rest-howto.md
-        displayName: subclipping, clip, edit, trim, clipping        
+        displayName: subclipping, clip, edit, trim, clipping  
+    - name: Job error codes
+      href: job-error-codes.md         
+  - name: Stream live
+    items:
+    - name: Become an on-premises encoder partner
+      href: become-on-premises-encoder-partner.md      
+    - name: Live Event error codes
+      href: live-event-error-codes.md    
   - name: Use Event Grid
     items:
     - name: Monitor events - Portal
@@ -304,7 +308,7 @@
       href: media-services-diagnostic-logs-howto.md
   - name: Protect content
     items:
-    - name: Get content key policy - .NET
+    - name: Get content key policy
       href: get-content-key-policy-dotnet-howto.md   
     - name: Offline FairPlay for iOS 
       href: offline-fairplay-for-ios.md
@@ -325,7 +329,9 @@
       displayName: filters
   - name: Deliver content
     items:
-    - name: Publish an asset - CLI
+    - name: Manage streaming endpoints
+      href: manage-streaming-endpoints-howto.md
+    - name: Publish an asset
       href: cli-publish-asset.md
     - name: Create a streaming locator and build URLs
       href: create-streaming-locator-build-url.md

articles/media-services/latest/manage-streaming-endpoints-howto.md

@@ -0,0 +1,102 @@
+---
+
+title: Manage streaming endpoints with Azure Media Services v3
+description: This article demonstrates how to manage streaming endpoints with Azure Media Services v3.
+services: media-services
+documentationcenter: ''
+author: Juliako
+writer: juliako
+manager: femila
+editor: ''
+
+ms.service: media-services
+ms.workload: media
+ms.tgt_pltfrm: na
+ms.devlang: na
+ms.topic: article
+ms.date: 03/11/2020
+ms.author: juliako
+
+---
+
+# Manage streaming endpoints with  Media Services v3
+
+When your Media Services account is created a **default** streaming endpoint is added to your account in the **Stopped** state. To start streaming your content and take advantage of [dynamic packaging](dynamic-packaging-overview.md) and [dynamic encryption](content-protection-overview.md), the streaming endpoint from which you want to stream content has to be in the **Running** state.
+
+This article shows you how to start your streaming endpoint.
+ 
+> [!NOTE]
+> You are only billed when your Streaming Endpoint is in running state.
+    
+## Prerequisites
+
+Review: 
+
+* [Media Services concepts](concepts-overview.md)
+* [Streaming Endpoint concept](streaming-endpoint-concept.md)
+* [Dynamic packaging](dynamic-packaging-overview.md)
+
+## Use the Azure portal
+
+1. Sign in at the [Azure portal](https://portal.azure.com/).
+1. On the left, select  **Streaming Endpoints**.
+1. Select the streaming endpoint you want to start, click **Start**.
+
+## Use the Java SDK
+
+```java
+if (streamingEndpoint != null) {
+// Start The Streaming Endpoint if it is not running.
+if (streamingEndpoint.resourceState() != StreamingEndpointResourceState.RUNNING) {
+    manager.streamingEndpoints().startAsync(config.getResourceGroup(), config.getAccountName(), STREAMING_ENDPOINT_NAME).await();
+}
+```
+
+The samples [in this repository](https://docs.microsoft.com/samples/azure-samples/media-services-v3-dotnet/azure-media-services-v3-samples-using-net/) shows how to start the default streaming endpoint with .NET.
+
+## Use the .NET SDK
+
+```charp
+StreamingEndpoint streamingEndpoint = await client.StreamingEndpoints.GetAsync(config.ResourceGroup, config.AccountName, DefaultStreamingEndpointName);
+
+if (streamingEndpoint != null)
+{
+    if (streamingEndpoint.ResourceState != StreamingEndpointResourceState.Running)
+    {
+        await client.StreamingEndpoints.StartAsync(config.ResourceGroup, config.AccountName, DefaultStreamingEndpointName);
+    }
+```
+
+The samples [in this repository](https://docs.microsoft.com/samples/azure-samples/media-services-v3-java/azure-media-services-v3-samples-using-java/) shows how to start the default streaming endpoint with Java.
+
+## Use CLI
+
+```cli
+az ams streaming-endpoint start [--account-name]
+                                [--ids]
+                                [--name]
+                                [--no-wait]
+                                [--resource-group]
+                                [--subscription]
+```
+
+For more information, see [az ams streaming-endpoint start](https://docs.microsoft.com/cli/azure/ams/streaming-endpoint?view=azure-cli-latest#az-ams-streaming-endpoint-start).
+
+## Use REST
+
+```rest
+POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/streamingEndpoints/myStreamingEndpoint1/start?api-version=2018-07-01
+```
+
+For more information, see: 
+
+* The [start a StreamingEndpoint](https://docs.microsoft.com/rest/api/media/streamingendpoints/start) reference documentation.
+* Starting a streaming endpoint is an asynchronous operation. 
+
+    For details on how to monitor a long-running operations see[Long-running operations](media-services-apis-overview.md)
+* This [Postman collection](https://github.com/Azure-Samples/media-services-v3-rest-postman/blob/master/Postman/Media%20Services%20v3.postman_collection.json) contains examples of multiple REST operations including on how to start a streaming endpoint.
+
+## Next steps
+
+* [Media Services v3 OpenAPI Specification (Swagger)](https://github.com/Azure/azure-rest-api-specs/tree/master/specification/mediaservices/resource-manager/Microsoft.Media/stable/2018-07-01)
+* [Streaming Endpoint operations](https://docs.microsoft.com/rest/api/media/streamingendpoints)

articles/media-services/latest/streaming-endpoint-concept.md

@@ -114,7 +114,7 @@ This section gives details about some of the Streaming Endpoint's properties. Fo
     > [!NOTE]
     > Streaming Endpoints located in the same data center can't share the same custom host name.
 
-    Currently, Media Services doesn’t support SSL with custom domains.
+    Currently, Media Services doesn't support SSL with custom domains.
 
 - `maxCacheAge` -  Overrides the default max-age HTTP cache control header set by the streaming endpoint on media fragments and on-demand manifests. The value is set in seconds.
 - `resourceState` -
@@ -161,4 +161,4 @@ Check out the [Azure Media Services community](media-services-community.md) arti
 
 ## Next steps
 
-The sample [in this repository](https://github.com/Azure-Samples/media-services-v3-dotnet-quickstarts/blob/master/AMSV3Quickstarts/EncodeAndStreamFiles/Program.cs) shows how to start the default streaming endpoint with .NET.
+[Manage streaming endpoints](manage-streaming-endpoints-howto.md)