Skip to content

Commit f81a3cf

Browse files
authored
Merge pull request #108808 from msebolt/azurecli-updates-pr4
azurecli updates
2 parents 0385769 + 80c225c commit f81a3cf

26 files changed

+310
-236
lines changed

articles/media-services/latest/azure-clouds-regions.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -34,11 +34,11 @@ Azure Media Services v3 is available via Azure Resource Manager manifest in glob
3434

3535
[Regions in which the Azure Media Services service is deployed](https://azure.microsoft.com/global-infrastructure/services/?products=media-services)
3636

37-
### Region code name
37+
### Region code name
3838

3939
When you need to supply the **location** parameter, you need to provide the region code name as the **location** value. To get the code name of the region that your account is in and that your call should be routed to, you can run the following line in [Azure CLI](https://docs.microsoft.com/cli/azure/?view=azure-cli-latest)
4040

41-
```bash
41+
```azurecli-interactive
4242
az account list-locations
4343
```
4444

@@ -63,18 +63,18 @@ The following endpoints are important to know when connecting to Media Services
6363

6464
### Global Azure
6565

66-
|Endpoints ||
67-
| --- | --- |
66+
|Endpoints||
67+
| --- | --- |
6868
| Azure Resource Manager | `https://management.azure.com/` |
69-
| Authentication | `https://login.microsoftonline.com/` |
69+
| Authentication | `https://login.microsoftonline.com/` |
7070
| Token audience | `https://management.core.windows.net/` |
7171

7272
### Azure Government
7373

7474
|Endpoints||
75-
| --- | --- |
75+
| --- | --- |
7676
| Azure Resource Manager | `https://management.usgovcloudapi.net/` |
77-
| Authentication | `https://login.microsoftonline.us/` |
77+
| Authentication | `https://login.microsoftonline.us/` |
7878
| Token audience | `https://management.core.usgovcloudapi.net/` |
7979

8080
### Azure Germany
@@ -88,7 +88,7 @@ The following endpoints are important to know when connecting to Media Services
8888
### Azure China 21Vianet
8989

9090
|Endpoints||
91-
| --- | --- |
91+
| --- | --- |
9292
| Azure Resource Manager | `https://management.chinacloudapi.cn/` |
9393
| Authentication | `https://login.chinacloudapi.cn/` |
9494
| Token audience | `https://management.core.chinacloudapi.cn/` |

articles/media-services/latest/cli-reset-account-credentials.md

Lines changed: 6 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,6 @@ documentationcenter: ''
66
author: Juliako
77
manager: femila
88
editor:
9-
109
ms.assetid:
1110
ms.service: media-services
1211
ms.devlang: azurecli
@@ -17,29 +16,29 @@ ms.date: 08/20/2019
1716
ms.author: juliako
1817
---
1918

20-
# CLI example: Reset the account credentials
19+
# Azure CLI example: Reset the account credentials
2120

2221
The Azure CLI script in this article shows how to reset your account credentials and get the app.config settings back.
2322

24-
## Prerequisites
23+
## Prerequisites
2524

2625
[Create a Media Services account](create-account-cli-how-to.md).
2726

2827
[!INCLUDE [media-services-cli-instructions.md](../../../includes/media-services-cli-instructions.md)]
2928

3029
## Example script
3130

32-
```
31+
```azurecli-interactive
3332
# Update the following variables for your own settings:
3433
resourceGroup=amsResourceGroup
3534
amsAccountName=amsmediaaccountname
3635
3736
az ams account sp reset-credentials \
3837
--account-name $amsAccountName \
39-
--resource-group $resourceGroup
38+
--resource-group $resourceGroup
4039
```
4140

4241
## Next steps
4342

44-
* [az ams](https://docs.microsoft.com/cli/azure/ams?view=azure-cli-latest)
45-
* [Reset credentials](https://docs.microsoft.com/cli/azure/ams/account/sp?view=azure-cli-latest#az-ams-account-sp-reset-credentials)
43+
* [az ams](/cli/azure/ams)
44+
* [Reset credentials](/cli/azure/ams/account/sp#az-ams-account-sp-reset-credentials)

articles/media-services/latest/cli-upload-file-asset.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -17,11 +17,11 @@ ms.date: 05/01/2019
1717
ms.author: juliako
1818
---
1919

20-
# CLI example: Upload a local file to a container
20+
# Azure CLI example: Upload a local file to a container
2121

2222
The Azure CLI script in this article shows how to upload a local file to a storage container.
2323

24-
## Prerequisites
24+
## Prerequisites
2525

2626
* [Create a Media Services account](create-account-cli-how-to.md).
2727
* Review [manage assets](manage-asset-concept.md).
@@ -30,7 +30,7 @@ The Azure CLI script in this article shows how to upload a local file to a stora
3030

3131
## Example script
3232

33-
```Azure CLI
33+
```azurecli-interactive
3434
#!/bin/bash
3535
# Update the following variables for your own settings:
3636
storageAccountName=build2018storage

articles/media-services/latest/custom-preset-cli-howto.md

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,11 @@
11
---
2-
title: Encode custom transform using Media Services v3 CLI - Azure | Microsoft Docs
3-
description: This topic shows how to use Azure Media Services v3 to encode a custom transform using CLI.
2+
title: Encode custom transform using Media Services v3 Azure CLI | Microsoft Docs
3+
description: This topic shows how to use Azure Media Services v3 to encode a custom transform using Azure CLI.
44
services: media-services
55
documentationcenter: ''
66
author: Juliako
77
manager: femila
88
editor: ''
9-
109
ms.service: media-services
1110
ms.workload:
1211
ms.topic: article
@@ -16,7 +15,7 @@ ms.author: juliako
1615

1716
---
1817

19-
# How to encode with a custom transform - CLI
18+
# How to encode with a custom transform - Azure CLI
2019

2120
When encoding with Azure Media Services, you can get started quickly with one of the recommended built-in presets, based on industry best practices, as demonstrated in the [Streaming files](stream-files-cli-quickstart.md#create-a-transform-for-adaptive-bitrate-encoding) quickstart. You can also build a custom preset to target your specific scenario or device requirements.
2221

@@ -27,19 +26,21 @@ When creating custom presets, the following considerations apply:
2726
* All values for height and width on AVC content must be a multiple of 4.
2827
* In Azure Media Services v3, all of the encoding bitrates are in bits per second. This is different from the presets with our v2 APIs, which used kilobits/second as the unit. For example, if the bitrate in v2 was specified as 128 (kilobits/second), in v3 it would be set to 128000 (bits/second).
2928

30-
## Prerequisites
29+
## Prerequisites
30+
31+
[Create a Media Services account](create-account-cli-how-to.md).
3132

32-
[Create a Media Services account](create-account-cli-how-to.md). <br/>Make sure to remember the resource group name and the Media Services account name.
33+
Make sure to remember the resource group name and the Media Services account name.
3334

3435
[!INCLUDE [media-services-cli-instructions](../../../includes/media-services-cli-instructions.md)]
3536

3637
## Define a custom preset
3738

38-
The following example defines the request body of a new Transform. We define a set of outputs that we want to be generated when this Transform is used.
39+
The following example defines the request body of a new Transform. We define a set of outputs that we want to be generated when this Transform is used.
3940

4041
In this example, we first add an AacAudio layer for the audio encoding and two H264Video layers for the video encoding. In the video layers, we assign labels so that they can be used in the output file names. Next, we want the output to also include thumbnails. In the example below we specify images in PNG format, generated at 50% of the resolution of the input video, and at three timestamps - {25%, 50%, 75} of the length of the input video. Lastly, we specify the format for the output files - one for video + audio, and another for the thumbnails. Since we have multiple H264Layers, we have to use macros that produce unique names per layer. We can either use a `{Label}` or `{Bitrate}` macro, the example shows the former.
4142

42-
We are going to save this transform in a file. In this example, we name the file `customPreset.json`.
43+
We are going to save this transform in a file. In this example, we name the file `customPreset.json`.
4344

4445
```json
4546
{
@@ -117,25 +118,24 @@ We are going to save this transform in a file. In this example, we name the file
117118
}
118119
]
119120
}
120-
121121
```
122122

123123
## Create a new transform
124124

125125
In this example, we create a **Transform** that is based on the custom preset we defined earlier. When creating a Transform, you should first check if one already exist. If the Transform exists, reuse it. The following `show` command returns the `customTransformName` transform if it exists:
126126

127-
```cli
127+
```azurecli-interactive
128128
az ams transform show -a amsaccount -g amsResourceGroup -n customTransformName
129129
```
130130

131-
The following CLI command creates the Transform based on the custom preset (defined earlier).
131+
The following Azure CLI command creates the Transform based on the custom preset (defined earlier).
132132

133-
```cli
133+
```azurecli-interactive
134134
az ams transform create -a amsaccount -g amsResourceGroup -n customTransformName --description "Basic Transform using a custom encoding preset" --preset customPreset.json
135135
```
136136

137-
For Media Services to apply the Transform to the specified video or audio, you need to submit a Job under that Transform. For a complete example that shows how to submit a job under a transform, see [Quickstart: Stream video files - CLI](stream-files-cli-quickstart.md).
137+
For Media Services to apply the Transform to the specified video or audio, you need to submit a Job under that Transform. For a complete example that shows how to submit a job under a transform, see [Quickstart: Stream video files - Azure CLI](stream-files-cli-quickstart.md).
138138

139139
## See also
140140

141-
[Azure CLI](https://docs.microsoft.com/cli/azure/ams?view=azure-cli-latest)
141+
[Azure CLI](/cli/azure/ams)

articles/media-services/latest/media-services-diagnostic-logs-howto.md

Lines changed: 6 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -6,22 +6,20 @@ documentationcenter: ''
66
author: Juliako
77
manager: femila
88
editor: ''
9-
109
ms.service: media-services
1110
ms.workload: media
1211
ms.tgt_pltfrm: na
1312
ms.devlang: na
1413
ms.topic: article
1514
ms.date: 07/08/2019
1615
ms.author: juliako
17-
1816
---
1917

2018
# Monitor Media Services diagnostic logs
2119

2220
[Azure Monitor](../../azure-monitor/overview.md) enables you to monitor metrics and diagnostic logs that help you understand how your applications are performing. For detailed description of this feature and to see why you would want to use Azure Media Services metrics and diagnostics logs, see [Monitor Media Services metrics and diagnostic logs](media-services-metrics-diagnostic-logs.md).
2321

24-
This article shows you how to route data to the storage account and then view the data.
22+
This article shows you how to route data to the storage account and then view the data.
2523

2624
## Prerequisites
2725

@@ -31,7 +29,7 @@ This article shows you how to route data to the storage account and then view th
3129
## Route data to the storage account using the portal
3230

3331
1. Log in to the Azure portal at https://portal.azure.com.
34-
1. Navigate to your Media Services account in and click **Diagnostic Settings** under **Monitor**. Here you see a list of all resources in your subscription that produce monitoring data through Azure Monitor.
32+
1. Navigate to your Media Services account in and click **Diagnostic Settings** under **Monitor**. Here you see a list of all resources in your subscription that produce monitoring data through Azure Monitor.
3533

3634
![Diagnostic settings section](media/media-services-diagnostic-logs/logs01.png)
3735

@@ -50,11 +48,11 @@ This article shows you how to route data to the storage account and then view th
5048

5149
Monitoring data from your resource is now flowing into the storage account.
5250

53-
## Route data to the storage account using the CLI
51+
## Route data to the storage account using the Azure CLI
5452

55-
To enable storage of diagnostic logs in a Storage Account, you would run the following `az monitor diagnostic-settings` CLI command:
53+
To enable storage of diagnostic logs in a Storage Account, you would run the following `az monitor diagnostic-settings` Azure CLI command:
5654

57-
```cli
55+
```azurecli-interactive
5856
az monitor diagnostic-settings create --name <diagnostic name> \
5957
--storage-account <name or ID of storage account> \
6058
--resource <target resource object ID> \
@@ -72,7 +70,7 @@ az monitor diagnostic-settings create --name <diagnostic name> \
7270

7371
For example:
7472

75-
```cli
73+
```azurecli-interactive
7674
az monitor diagnostic-settings create --name amsv3diagnostic \
7775
--storage-account storageaccountforams \
7876
--resource "/subscriptions/00000000-0000-0000-0000-0000000000/resourceGroups/amsResourceGroup/providers/Microsoft.Media/mediaservices/amsaccount" \

articles/media-services/latest/media-services-metrics-howto.md

Lines changed: 8 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -6,22 +6,20 @@ documentationcenter: ''
66
author: Juliako
77
manager: femila
88
editor: ''
9-
109
ms.service: media-services
1110
ms.workload: media
1211
ms.tgt_pltfrm: na
1312
ms.devlang: na
1413
ms.topic: article
1514
ms.date: 07/08/2019
1615
ms.author: juliako
17-
1816
---
1917

20-
# Monitor Media Services metrics
18+
# Monitor Media Services metrics
2119

2220
[Azure Monitor](../../azure-monitor/overview.md) enables you to monitor metrics and diagnostic logs that help you understand how your applications are performing. For detailed description of this feature and to see why you would want to use Azure Media Services metrics and diagnostics logs, see [Monitor Media Services metrics and diagnostic logs](media-services-metrics-diagnostic-logs.md).
2321

24-
Azure Monitor provides several ways to interact with metrics, including charting them in the portal, accessing them through the REST API, or querying them using CLI. This article shows how to monitor metrics with the Azure portal charts and Azure CLI.
22+
Azure Monitor provides several ways to interact with metrics, including charting them in the portal, accessing them through the REST API, or querying them using Azure CLI. This article shows how to monitor metrics with the Azure portal charts and Azure CLI.
2523

2624
## Prerequisites
2725

@@ -32,18 +30,18 @@ Azure Monitor provides several ways to interact with metrics, including charting
3230

3331
1. Sign in to the Azure portal at https://portal.azure.com.
3432
1. Navigate to your Azure Media Services account and select **Metrics**.
35-
1. Click the **RESOURCE** box and select the resource for which you want to monitor metrics.
33+
1. Click the **RESOURCE** box and select the resource for which you want to monitor metrics.
3634

37-
The **Select a resource** window appears on the right with the list of resources available to you. In this case you see
35+
The **Select a resource** window appears on the right with the list of resources available to you. In this case you see:
3836

3937
* &lt;Media Services account name&gt;
4038
* &lt;Media Services account name&gt;/&lt;streaming endpoint name&gt;
4139
* &lt;storage account name&gt;
4240

4341
Select the resource and press **Apply**. For details about supported resources and metrics, see [Monitor Media Services metrics](media-services-metrics-diagnostic-logs.md).
44-
42+
4543
![Metrics](media/media-services-metrics/metrics02.png)
46-
44+
4745
> [!NOTE]
4846
> To switch between resources for which you want to monitor metrics, click on the **RESOURCE** box again and repeat this step.
4947
1. (Optionally) give your chart a name (edit the name by pressing the pencil at the top).
@@ -54,9 +52,9 @@ Azure Monitor provides several ways to interact with metrics, including charting
5452

5553
## View metrics with Azure CLI
5654

57-
To get "Egress" metrics with CLI, you would run the following `az monitor metrics` CLI command:
55+
To get "Egress" metrics with Azure CLI, you would run the following `az monitor metrics` command:
5856

59-
```cli
57+
```azurecli-interactive
6058
az monitor metrics list --resource \
6159
"/subscriptions/<subscription id>/resourcegroups/<resource group name>/providers/Microsoft.Media/mediaservices/<Media Services account name>/streamingendpoints/<streaming endpoint name>" \
6260
--metric "Egress"

0 commit comments

Comments
 (0)