Update Ingest Point

Updates an ingest point's name or description.

Request

Request syntax:

PATCH /managed-slicer/slicers/ingest-points/Ingest Point ID

Request URL variable:

Define the following variable when submitting the above request:

VariableA variable represents a value that must be replaced. A variable consists of either a URL segment (e.g., "0001" in /0001/) or a query string value (e.g., "3" in mediaTypes=3).Description
Ingest Point ID RequiredReplace this variable with the system-defined ID assigned to the desired ingest point. Use the Get All Ingest Points endpoint to retrieve a list of ingest points and their system-defined IDs.

Request body parameters:

Pass the following request body parameters:

NameData TypeDescription
descStringSets the ingest point's description.
endpoint_nameStringSets the ingest point's name.

Response

The response for a successful request contains the following properties:

NameData TypeDescription
@idStringIndicates the relative path to a resource-specific endpoint.
@typeStringReturns IngestPoint.
createdStringIndicates the timestamp at which this ingest point was created.
descStringIndicates the ingest point's description.
endpoint_nameStringIndicates the ingest point's name.
idStringIndicates the ingest point's system-defined ID.
ingest_pointDictionaryContains the ingest point's hostname and ports.
lastmodStringIndicates the timestamp at which this ingest point was last modified.
server_region_idStringIndicates the system-defined ID for the region assigned to the ingest point.
stream_type_id DeprecatedStringThis property has been replaced by stream_type_name.
stream_type_nameStringIndicates the ingest point's protocol.

ingest_point Dictionary

The ingest_point dictionary describes an ingest point through the following properties:

NameData TypeDescription
creation_timeStringIndicates the timestamp (UTC) at which the ingest point was created. Example: Jun 7, 2023 4:13:44 PM
ingest_point_idStringIndicates the ingest point's system-defined ID.
reserved_domain_nameStringIndicates the ingest point's domain.
reserved_portsDictionaryContains all of the ports associated with the ingest point.
secure_rtmp_urlStringRTMP Only Indicates the URL to which your encoder should push a RTMP feed. This URL uses the RTMP scheme.
server_regionStringIndicates the ingest point's region.
slicer_account_nameStringReserved for future use.
statusStringIndicates whether a managed slicer has been associated with this ingest point. Valid values are: IN_USENOT_IN_USE
stream_rtmp_urlStringRTMPS Only Indicates the URL to which your encoder should push a RTMP feed. This URL, which uses the rtmps scheme, is secured using a TLS connection.
reserved_ports Dictionary

The reserved_ports dictionary describes an ingest point's ports through the following properties:

NameData TypeDescription
portNumberIndicates the ingest point's port.
port_fec2NumberIndicates the ingest point's port for the row forward error correction (FEC) stream.
port_fec4NumberIndicates the ingest point's port for the column forward error correction (FEC) stream.

Sample Request/Response

Call the update_ingest_point module (Python 3) to update an ingest point. This module imports names from the api_auth module.

import json, requests
from api_auth import APICredentials, APIParams

class IngestPoint:
    def __init__(self):
        self.host = "https://services.uplynk.com"

    def run(self):
        self._update_ingest_point()

    def _update_ingest_point(self):
        ingest_point_id = 'f0a214a437024a9c85c59f6f1bd55b3e'  # Replace with the desired ingest point ID.
        url = "{}{}{}".format(self.host, "/api/v4/managed-slicer/slicers/ingest-points/", ingest_point_id)

        headers = {'Content-Type': 'application/json'}

        payload = {
            'desc': 'Basketball - East Coast Ingest' # Replace with the desired description.
        }

        response = requests.patch(
            url, params=APIParams(APICredentials()).get_params({}), data=json.dumps(payload), headers=headers
        )

        print(response.json())

IngestPoint().run()

Response:

{
	'@id': '/api/v4/managed-slicer/slicers/ingest-points/f0a214a437024a9c85c59f6f1bd55b3e',
	'@type': 'IngestPoint',
	'id': 'f0a214a437024a9c85c59f6f1bd55b3e',
	'created': '2022-03-04T23:28:20.255Z',
	'lastmod': '2022-03-04T23:28:20.255Z',
	'desc': 'Basketball - East Coast Ingest',
	'ingest_point': {
		'ingest_point_id': 'f0a214a4-3702-4a9c-85c5-9f6f1bd55b3e',
		'reserved_domain_name': 'ingest-stage-1-us-east-2.mss-develop.aws.oath.cloud',
		'reserved_ports': {
			'port': 46255,
			'port_fec2': 46257,
			'port_fec4': 46259
		},
		'server_region': 'us-east-2',
		'status': 'NOT_IN_USE'
	},
	'stream_type_name': 'UDP',
	'server_region_id': '4ae28f7a33c44473861b40d1c7e3072e',
	'stream_type_id': 'b348ad0563b44f85b48407e280499eda'
}