Skip to content
URL:
https://<root>/services/isLivestreamAddressAvailable
Methods:
POST
Version Introduced:
12.0

Description

The isLivestreamAddressAvailable operation queries existing services to determine if a livestream address or port is available or if it is already in use. This operation uses the URL, IP address, and livestream's port to determine availability.

This operation is available for Secure Reliable Transport (SRT), User Datagram Protocol (UPD), Real-Time Messaging Protocol (RTMP), and Real-Time Streaming Protocol (RTSP) livestreams.

Request parameters

ParameterDetails

address

(Required)

Either the URL and port, or the IP and port, for a UPD, RTMP, RTSP, or SRT livestream. The input should be in the form of a string.

Example:

Use dark colors for code blocksCopy
1
2
3
address=25.10.10.10:9000 //IP and port

address=sample.livestream.com:4000 //URL and port

f

(Required)

The output format for this operation. The default value is html.

Values: html | json | pjson

token

(Required)

Users interacting programmatically with this endpoint must generate a token that must be included as a request parameter. A token can be obtained using the Generate Token operation.

Example usage

The following is a sample POST request for the isLivestreamAddressAvailable operation:

Use dark colors for code blocksCopy
1
2
3
4
5
6
POST /arcgis/rest/services/sampleService/VideoServer/layerId/update/poster HTTP/1.1
Host: organization.example.com:21443
Content-Type: application/x-www-form-urlencoded
Content-Length: []

address=rtsp://test.sample.com:554/test&f=pjson&token=<token>

JSON Response syntax

Use dark colors for code blocksCopy
1
2
3
{
    "available": <true | false>
}

JSON Response example

Use dark colors for code blocksCopy
1
2
3
{
    "available": true
}

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.