Deletes a live output. Deleting a live output does not delete the asset the live output is writing to.
You can delete a live output directly, or delete the parent live event to remove all associated live outputs in one operation.
DELETE https://{{api-endpoint}}/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaservices/{accountName}/liveEvents/{liveEventName}/liveOutputs/{liveOutputName}In this article:
URI Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
liveOutputName |
path | True | string | Name of the live output to delete under the specified live event. Becomes the last segment of the resource ID and must be unique within the parent Live Event. Use a URL-safe name. |
liveEventName |
path | True | string |
The name of the live event, maximum length is 32. Regex pattern: |
accountName |
path | True | string | The RMS account name. |
resourceGroupName |
path | True | string | The name of the resource group within the Azure subscription. |
subscriptionId |
path | True | string | The unique identifier for a Microsoft Azure subscription. |
api-version |
query | True | string |
The version of the API to be used with the client request. Required for compatibility; any value accepted; no effect. |
Responses
| Name | Type | Description |
|---|---|---|
| 200 OK | OK. The request has succeeded. |
|
| 202 Accepted | Accepted. The request has been accepted for processing and the operation will complete asynchronously. See https://go.microsoft.com/fwlink/?linkid=2087017 for details on monitoring asynchronous Azure operations using the Azure-AsyncOperation response header. |
|
| 204 No content | No content. The request has been accepted but the live output was not found. | |
| Other Status Codes | ErrorResponse | Detailed error information. |
Examples
Sample Request
DELETE https://{{api-endpoint}}/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mrg-groupname/providers/Microsoft.Media/mediaservices/default/liveEvents/liveEvent1/liveOutputs/LiveOutput1?api-version=2022-11-01Sample Response
Status code: 200
Status code: 202
Status code: 204
Definitions
| Name | Description |
|---|---|
| ErrorAdditionalInfo | The resource management error additional info. |
| ErrorDetail | The error detail. |
| ErrorResponse | Error response. |
ErrorAdditionalInfo
The resource management error additional info.
| Name | Type | Description |
|---|---|---|
| info | object | The additional info. |
| type | string | The additional info type. |
ErrorDetail
The error detail.
| Name | Type | Description |
|---|---|---|
| additionalInfo | ErrorAdditionalInfo | The error additional info. |
| code | string | The error code. |
| details | ErrorDetail | The error details. |
| message | string | The error message. |
| target | string | The error target. |
ErrorResponse
Error response
| Name | Type | Description |
|---|---|---|
| error | ErrorDetail | The error object. |