GeezerVison

Bases: object

Class providing access to the administrative root resource for an ArcGIS Video Server site.

Exposes manager objects for the collection of resources that provide access to additional resources and operations for administering a Video Server site.

Objects of this class are not initialized directly. Use the admin property of a VideoServer object to obtain an instance:

Example: Initialize an AdminVideoServer object for a Video Server site:

from arcgis.gis import GIS
gis = GIS(profile="your_enterprise_admin_profile")

server_mgr = gis.admin.servers
vid_server = server_mgr.get(function="VideoServer")[0]

vid_admin = vid_server.admin
print(f"Video server admin object: {vid_admin}")
print(f"Type of object: {type(vid_admin)}")

Output:

Video server admin object: < AdminVideoServer @ https://example.com:21443/arcgis/admin >
Type of object: <class 'arcgis.gis.video.admin.api.AdminVideoServer'>

property about: dict[str, Any]

Return hardware, extension, and license metadata from the Video Server About resource. Detailed explanation and example of output information provided at the link.

Returns:

A python dict with current information. The key-value pairs will vary depending on the server configuration.

Example: Get server about metadata

from arcgis.gis import GIS

gis = GIS(profile="your_enterprise_admin_profile")
vid_server = gis.admin.servers.get(function="VideoServer")[0]

about_info = vid_server.admin.about
about_info

Output:

{'currentBuild': '1547',
 'serverRole': 'FEDERATED_SERVER',
 'lastUpdated': 1785280314492,
 ...
 'serverType': 'ARCGIS_VIDEO_SERVER',
 'machines': [...],
  ...
 'serverFunction': 'VideoServer',
 'webAdaptors': [...]
}

property backup_restore_info: dict[str, Any]

Reports information regarding the current backup settings for Video Server. This will include timestamps and flags for full and incremental backup and restore activity.

Example: Get backup and restore information for the current site:

from arcgis.gis import GIS
gis = GIS(profile="your_enterprise_admin_profile")

vid_server = gis.admin.servers.get(function="VideoServer")[0]
backup_info = vid_server.admin.backup_restore_info
backup_info

Output: Example return values

{
    'incrementalBackupTimeStamp': 0,
    'incrementalRestoreTimeStamp': 0,
    'incrementalBackupEnabled': False,
    'fullBackupTimeStamp': 0,
    'fullRestoreTimeStamp': 0,
    'backupModeTimeStamp': 0
}

property data: DataManager

Return a resource with information and management capabilities for the data items of the server. Provides the capability to find, register, and validate datastores.

Returns:

A DataManager object.

delete_site() → dict[str, Any]

Delete the current site configuration and release server resources.

Note

This is an unrecoverable operation. Use caution because it removes services, settings, and site configuration.

delete_upload(id: str) → dict[str, Any]

Delete a previously uploaded item by its identifier.

Parameter	Description
id	Required string. The file_id value for the uploaded item to delete.

Returns:

A python dict containing a status key or an error message if the delete failed.

Example: Delete an uploaded item by its ID

from arcgis.gis import GIS
gis = GIS(profile="your_enterprise_admin_profile")
vid_server = gis.admin.servers.get(function="VideoServer")[0]
vid_admin = vid_server.admin

upload_list = vid_admin.uploads()
# Get the upload at the first index position of the list
upload_id = upload_list[0].file_id

response = vid_admin.delete_upload(id=upload_id)

export_site(destination: str, validate: bool) → dict[str, Any]

Export the current site configuration to a destination path. See the Export Site reference documentation for full description of the operation.

Parameter	Description
destination	Required string. The file path or a reference ID from the server to the stored configuration information.
validate	Required boolean. Indicates whether the operation will validate the site archive before exporting.

import_site(location: str, validate: bool) → dict[str, Any]

Import a site configuration into the current site. Replaces existing services and administrative configuration with the imported site archive content. See the Import Site reference documentation for full description of the operation.

Parameter	Description
location	Required string. The file path to the site archive to import.
validate	Required boolean. Indicates whether the operation will validate the site archive before importing.

property info: dict[str, Any]

Return site-level metadata about the current Video Server site.

The response contains deployment metadata and login information for the current site and session.

Returns:

A python dict of metadata information:

Example: Administrative metadata for the current session:

from arcgis.gis import GIS
gis = GIS(profile="your_enterprise_admin_profile")

vid_server = gis.admin.servers.get(function="VideoServer")[0]
vid_admin_info = vid_server.admin.info
print("Video server admin info:")
vid_admin_info

Output:

{'fullVersion': '12.2.0',
 'configStoreVersion': '3',
 'loggedInUserPrivilege': 'ADMINISTER',
 'currentversion': '12.2.0',
 'loggedInUser': 'VidServer_admin',
 'currentbuild': '1000'}

property logs: LogsManager

Return the logs manager for querying, cleaning, and configuring logs.

Returns:

LogsManager

property machines: MachineManager

Provides access to a MachineManager helper class to manage the machine resources, with ability to perform machine-level inspection and administration operations.

Example: Access the machine manager

from arcgis.gis import GIS

gis = GIS(profile="your_enterprise_admin_profile")
vid_server = gis.admin.servers.get(function="VideoServer")[0]

machine_mgr = vid_server.admin.machines
print(type(machine_mgr))

Output:

<class 'arcgis.gis.video.admin.machines.api.MachineManager'>

property mode: dict[str, Any]

Get or set the current site mode of the Video Server site. See the Video Server Mode documentation for detailed explanantion of the resource this property accesses.

Returns:

A python dict with current site mode information, typically including siteMode, copyConfigLocal, and lastModified keys.

To set the site mode, assign the mode property to a new SiteMode object of either READ_ONLY or EDITABLE. Use:

• READ_ONLY to block most administrative operations and service publishing.

• EDITABLE to allow normal operations. An error is returned if the update fails.

Example: Set the site mode to READ_ONLY:

from arcgis.gis import GIS
from arcgis.gis.video.admin import SiteMode

gis = GIS(profile="your_enterprise_admin_profile")

vid_server = gis.admin.servers.get(function="VideoServer")[0]
vid_admin = vid_server.admin

vid_admin.mode = SiteMode.READ_ONLY

property queue_info: dict[str, Any]

Provides details about the system store that handles the messaging and stability for the Video Server site.

Primary functions include updating service changes so webhooks can query them, and coordinating multiple video uploads to ensure system reliability.

Returns:

A python dict of information with queueLength, numListeners, and name keys.

Example: Get queue information for the current site

from arcgis.gis import GIS

gis = GIS(profile="your_enterprise_admin_profile")
vid_server = gis.admin.servers.get(function="VideoServer")[0]

queue_info = vid_server.admin.queue_info
queue_info

Output:

{'queueLength': 0, 'numListeners': 3, 'name': 'default'}

property security: SecurityManager

Return the security manager to manage all security operations avialable for a Video Server site.

Returns:

SecurityManager

property services: ServiceManager

Return the services manager for administrative service operations.

Returns:

ServiceManager

property session: EsriSession

Return the current session object.

Example: Access the active session object

from arcgis.gis import GIS

gis = GIS(profile="your_enterprise_admin_profile")
vid_server = gis.admin.servers.get(function="VideoServer")[0]
vid_admin = vid_server.admin

current_session = vid_admin.session
print(type(current_session))

Output:

<class 'arcgis.auth._auth._token.EsriSession'>

property system: SystemManager

Return the system manager for server-wide configuration resources.

Returns:

SystemManager

Example: Access the system manager

from arcgis.gis import GIS

gis = GIS(profile="your_enterprise_admin_profile")
vid_server = gis.admin.servers.get(function="VideoServer")[0]

system_mgr = vid_server.admin.system
print(type(system_mgr))

Output:

<class 'arcgis.gis.video.admin.system.api.SystemManager'>

uploads() → Iterable[Upload]

Get the uploaded items currently stored on the server.

Returns:

A Python list of Upload objects representing the uploaded items currently stored on the server.

Example: Get the list of uploaded items

from arcgis.gis import GIS
gis = GIS(profile="your_enterprise_admin_profile")
vid_server = gis.admin.servers.get(function="VideoServer")[0]
vid_admin = vid_server.admin

uploaded_items = vid_admin.uploads()

print(f"Object Type: {type(uploaded_items[0])}")
for upload in uploaded_items:
    print(f"Upload ID: {upload.file_id}, File Name: {upload.file_name}")

Output: Example of printing some properties of the uploaded items

Object Type: <class 'arcgis.gis.video.admin.model.Upload'>
Upload ID: i01214f77-e32a-4e38-bafe-9a330a4ab7f6, File Name: Factory_1.mpg

property url: str

Returns the root administrative resource URL endpoint.

Example: Read the admin root URL

from arcgis.gis import GIS

gis = GIS(profile="your_enterprise_admin_profile")
vid_server = gis.admin.servers.get(function="VideoServer")[0]
vid_admin = vid_server.admin

print(vid_admin.url)

Output:

https://example.com:21443/arcgis/admin

Bases: object

Manager object for the server records written by the various components of the Video Server instance. Supports setting retrieval/updates, log querying, log cleanup, and error report access.

Returned by the logs property.

clean() → bool

Delete all log records across site machines. The server will periodically clean up old log records without running this operation, but this operation can be used to immediately remove all log records.

Returns:

A boolean indicating success (True) or failure (False).

error_reports() → dict[str, Any]

Return the list of available error report files.

Returns:

A dictionary with the error report listing

get_error_report(filename: str) → str

Return the text contents of a specific error report file.

Argument	Description
filename	Required string. The name of the error report file to retrieve. This should be one of the files returned by the error_reports() method.

Returns:

A dictionary with the error report listing

property properties: dict[str, Any]

Return metadata information about the logs endpoint of the Video Server, including available operations and resources.

query(query: LogQuery) → Iterable[LogQueryResult]

Operation to query and retrieve all the log messages across the entire ArcGIS Video Server site.

Argument	Description
query	Required LogQuery object containing criteria to refine the output.

Returns:

An iterable of LogQueryResult objects.

property session: EsriSession

Return the current session object.

property settings: LogSettings

Retrieve and/or set information about the current log settings.

Returns:

A LogSettings object.

property url: str

The current URL

Class to manage the current log settings for the Video Server deployment.

field directory: str | None [Required]

The location on the server where the logs reside

field error_report_count: int [Required]

The number of error reports to keep on the server.

field level: LogLevel | None [Required]

The logging level for the server

field log_age: int [Required]

The length the logs will keep on the server.

Constraints:

• gt = 0

• le = 90

A class representing the query parameters used as the query argument when using the query() method to query the logs.

field end_time: _dt.datetime | None = None

The oldest time to include in the result set. You can use this to limit the query to the last few minutes or hours as needed.

field filter: Filter = Filter(codes=[], process_ids=[], request_ids=None, component=<Component.ALL: '*'>, services='*', machines='*')

Filtering provides flexibility and specificity by combining any of the filter properties from the Filter dataclass.

field level: LogLevel | None [Required]

The logging level for the server

field page_size: int = 1000

The maximum number of log records to be returned by this query. The default messages per page is 1000. The limit is 10000 records.

Constraints:

• gt = 0

• le = 1000

field start_time: _dt.datetime | None = None

The most recent time to query. If the hasMore member of the response object is true, pass the endTime member as the startTime parameter for the next request to get the next set of records. Time can be specified in milliseconds since UNIX epoch or as an ArcGIS Server time stamp.

serialize_as_json_string(f: Filter, _info) → str

serialize_time_epoch(dt: datetime, _info) → int | str

Filter criteria for narrowing log query results for use as the filter value in a LogQuery object.

field codes: list[int] | None = []

Specifies the log codes assigned to server logs. To query all codes, set the value to [].

field component: Component | None = Component.ALL

Specifies the server components delivering the log message. To query logs from all components, set the value to ALL.

field machines: str | list[str] | None = '*'

Specifies whether to query all or a specific machine in your server site. To query logs from all machines, set the value to *.

field process_ids: list[int] | None = []

Specifies the machine process IDs to query. The default is all process ids.

field request_ids: list[str] | None = None

Specifies an ID assigned to a specific server request.

field services: str | list[str] | None = '*'

Specifies whether to query all, none, or a specific service in your site. To query logs from all services, set the value to *.

serialize_list_with_brackets(items: List[str], _info)

Object returned by the query method of the LogsManager.

field end_time: _dt.datetime | int | None = None

The most recent time to query.

field has_more: bool [Required]

Indicates whether additional result pages are available.

field messages: list[dict] | None = None

The list of messages from the query result.

field start_time: _dt.datetime | int | None = None

The most recent time to query.

Supported server log severity levels.

DEBUG = 'DEBUG'

FINE = 'FINE'

INFO = 'INFO'

OFF = 'OFF'

SEVERE = 'SEVERE'

VERBOSE = 'VERBOSE'

WARNING = 'WARNING'

Bases: object

Manage the video server site security resources. Exposes security configuration, server-role transitions, and primary site administrator (PSA) operations.

Objects of this class are not meant to be instantiated directly, but instead are accessed through the security property of the AdminVideoServer object.

Example: Initialize a SecurityManager object

from arcgis.gis import GIS

gis=GIS(profile="your_enterprise_admin_profile")

vid_server = gis.admin.servers.get(role="VideoServer")[0]
vid_admin = vid_server.admin

security_mgr = vid_admin.security
security_mgr

Output:

< SecurityManager @ https://example.site.com/videoserver/admin/security >

change_server_role(role: ServerRole, function: str | None = None) → None

Change server role or function. Video Server deployments may perform queue-store synchronization during role changes depending on server function.

Parameter	Description
role	A required ServerRole member representing the new server role.
function	The new server function to assign (optional). Only valid values is VideoServer.

property config: SecurityConfiguration

Gets a SecurityConfiguration object containing information about the security resource endpoint.

property properties: dict[str, Any]

Return security root metadata and available child resources.

property psa_properties: dict[str, Any]

Return PSA account metadata.

property session: EsriSession

Return the current session object.

set_psa_access(enabled: bool) → dict[str, str]

Enable or disable PSA account login access.

Parameter	Description
enabled	A Python boolean indicating whether to enable or disable PSA access.

update_psa(username: str | None = None, password: str | None = None) → dict[str, str]

Update PSA credentials.

property url: str

Get the current URL endpoint for the security resource.

Federation metadata linking Video Server to Portal for ArcGIS.

field portal_mode: str [Required]

The portal mode. This must be ‘ARCGIS_PORTAL_FEDERATION’.

field portal_url: str [Required]

The URL of Portal for ArcGIS.

field private_hosting_server_url: str [Required]

The private URL of the portal’s hosting server.

field private_portal_url: str [Required]

The internal URL of Portal for ArcGIS.

field server_id: str [Required]

The ID of the server federated with the portal.

field server_url: str [Required]

The external URL of the server federated with the portal.

Helper class for getting, setting, and managing the security operations on a video server deployment. Objects of this class are returned by the config property of a SecurityManager object, and can be updated and used to set new configuration values.

field allow_direct_access: bool [Required]

A Boolean that indicates whether a user with administrator privileges can access the server through port 2180. If true, all users with administrative access can access the Administrator Directory and ArcGIS Video Server Manager through port 2180. If false, users in the identity store cannot access the server through port 2180; users must access the site through ArcGIS Web Adaptor. The default value is true.

field allow_internet_cors_access: bool [Required]

A Boolean that controls the value of the Access-Control-Allow-Private-Network response header in a CORS preflight request to a REST service URL. This property supports the Private Network Access web specification (previously CORS-RFC1918), which aims to restrict websites accessed over a private network from making internal cross-origin requests.

field authentication_mode: str [Required]

Current authentication mode active for the deployment.

field authentication_tier: AuthenticationTier [Required]

Specifies the tier at which requests to access video services will be authenticated.

field cipher_suites: str [Required]

The cipher suites ArcGIS Video Server will use. The Valid cipher suites section below outlines the ciphers enabled by default, as well as valid ciphers that can be enabled.

field https_protocols: str [Required]

The TLS protocols ArcGIS Video Server will use. TLSv1.2 and TLSv1.3 (support for TLSv1.3 was added at 10.9) is enabled by default. You can also enable TLSv1 and TLSv1.1. Values must be separated by commas.

field portal_properties: PortalProperties [Required]

The properties used when federating ArcGIS Video Server with Portal for ArcGIS.

field server_function: str [Required]

The designated function of the server. This should be ‘VideoServer’ for a Video Server site.

field server_role: ServerRole [Required]

The name of the server role.

field server_type: str [Required]

The type of server. For a Video Server, this should be ‘ARCGIS_VIDEO_SERVER’.

field token_service_key: str [Required]

Internal signing/encryption key material used by the server token service.

Authentication tier options accepted by security configuration updates.

ARCGIS_PORTAL = 'ARCGIS_PORTAL'

GIS_SERVER = 'GIS_SERVER'

WEB_ADAPTOR = 'WEB_ADAPTOR'

Supported administrative server role values.

FEDERATED_SERVER = 'FEDERATED_SERVER'

STANDALONE_SERVER = 'STANDALONE_SERVER'

Bases: object

Manager object for administrative operations on Video Server services. This manager provides operations for listing services, checking existence, creating empty containers, and retrieving service resources.

Objects of this type are returned by the services property of a AdminVideoServer instance.

Example: Get a ServiceManager for a Video Server instance

from arcgis.gis import GIS
from arcgis.gis.video import VideoServer

gis = GIS(profile="your_enterprise_admin_profile")
vid_server = gis.admin.servers.get(function="VideoServer")[0]
svc_mgr = vid_server.admin.services
svc_mgr

Output:

< ServiceManager @ https://exampleserver.domain.com/webadaptor/video/admin/services >

create(service_name: str) → CreateResponse

Create a new video service container for layers.

Returns:

CreateResponse

exists(service_name: str) → bool

Check whether a named service exists.

Parameter	Description
service_name	Required string. Name of the service to check.

Returns:

A Python bool indicating whether the service exists.

get(service_name: str) → Service

Return a service resource by name.

Parameter	Description
service_name	Required string. Name of the service to retrieve.

Returns:

A Service object.

list() → Generator[Service, None, None]

Retrieves all registered video services from the server.

Returns:

A Python Generator of Service objects.

property session: EsriSession

Return the current session object.

property types: dict[str, Any]

Provides metadata for all the different services types and extensions that can be enabled on each service.

ArcGIS Video Server only reports Video Services.

property url: str

The current URL for the resource endpoint.

Response object returned by the create() method of the ServiceManager.

field item_id: str [Required]

The id of the service

field name: str [Required]

The name of the service

field success: bool [Required]

The result of the create request indicating if the service was created

Portal association details for a service.

field portal_items: List[PortalItem] [Required]

Associated items in the Portal.

Bases: object

Represent a single administrative video service resource.

Objects of this type are returned by the get or list methods.

delete(skip_portal_delete: bool) → bool

Delete this service.

Parameter	Description
skip_portal_delete	Optional bool. When True, the backing Portal item is not deleted. Default is False.

Returns:

A Python bool indicating whether the service was successfully deleted.

property info: BasicServiceInfo

Return service metadata for this video service resource.

Returns:

BasicServiceInfo

property session: EsriSession

Return the current session object.

property url: str

The current URL

Basic metadata for an individual video service returned by the info property.

field description: str [Required]

If the chosen video service includes a description, it will be output as a string in the description property.

field extensions: List[str] [Required]

If any extensions were used to publish the service, they will be listed as part of the extensions property.

field portal_properties: PortalProperties [Required]

Linked Portal item metadata for the service.

field service_name: str [Required]

The name of the selected video service.

field type: str [Required]

The type of service. For ArcGIS Video Server, this will always appear as VideoServer.

Information for any associated item in the connected ArcGIS Portal.

field item_id: str [Required]

The ID of the portal item.

field type: str [Required]

The type of the portal item.

Extended metadata for a video layer hosted by a service.

field copyright_text: str [Required]

Any associated copyright text

field created: str [Required]

When the layer was created

field description: str [Required]

The description of the layer, if provided

field id: int [Required]

The id of the video layer

field name: str [Required]

The name of the video layer

field service_type: str [Required]

The type of the service (ONDEMAND or LIVESTREAM)

field source_file: str [Required]

The file used to create the layer if the type is ONDEMAND

field source_files_info: list [Required]

Further information for any associated source files

field supported_query_formats: bool [Required]

Formats supported by layer query operations, such as JSON or GeoJSON.

field supports_export_clip: bool [Required]

Indicates if a clip can be exported from this video layer

field supports_export_frameset: bool [Required]

Indicates if framesets can be exported from this video layer

field supports_mensuration: bool [Required]

Indicates if the video layer supports mensuration.

field supports_previews: bool [Required]

Indicates if the video layer supports previews.

Metadata describing a source file associated with a video layer.

field content_type: str [Required]

The source file’s content type

field id: int [Required]

The assigned id for the source file

field name: str [Required]

The source file name

field size: str [Required]

The size of the source file (in bytes)

Bases: object

Manager object to access a collection of miscellaneous server-wide resources to get information on system properties, licensing details, config-store metadata, directories, web adaptors, and livestream protocol/port configuration.

Objects of this type are returned by the system property.

property config_store: dict[str, str]

Retrieve information on all the server’s configurations, typically including all resources such as machines, services and security rules. The config store is the authoritative site configuration repository used by all machines in the deployment.

Returns:

A Python dict descibing configuration information.

property directories: DirectoryManager

Retrieves an object to manage all the server directories.

Returns:

A DirectoryManager object.

property indexer: IndexManager

Return the index manager for status and reindex operations.

Returns:

A IndexManager object.

licenses(by_machine: bool) → dict[str, Any]

Return information about the current license level of Video Server and all extensions. The information is returned as a Python dict object. The by_machine parameter controls whether the license information is returned per machine.

Returns:

A Python dict describing license information.

property livestream: LivestreamManager

Provide access to a manager object for all livestream configuration and endpoint options.

Returns:

A LivestreamManager object.

property properties: dict[str, Any]

Retrieves a Python dict or sets the properties to a new SystemUpdateParameters object with Video Server system configuration properties.

property session: EsriSession

Return the current session object.

property url: str

The current resource endpoint for system resources.

property web_adaptors: WebAdaptorManager

Gets a manager object for the web adaptor(s) in the deployment.

Returns:

A WebAdaptorManager object.

Object that can be used to update system properties by creating a new instance and assigning it to the properties attribute of a SystemManager object.

Fields left as None are omitted from the update payload so existing server settings can remain unchanged.

field disableServicesDirectory: bool | None [Required]

Whether the public services directory UI is disabled.

field maxFileUploadSize: int | None [Required]

Maximum upload size allowed by the server, in megabytes.

field max_frame_count: int | None [Required]

Maximum frame count processed per request for relevant server workflows.

ALL = 'ALL'

COVERAGE = 'COVERAGE'

FOOTPRINTS = 'FOOTPRINTS'

SERVICE = 'SERVICE'

Bases: object

Manager object for all the server directories. Objects of this type are returned by the directories property.

info(id: str) → DirectoryInformation

Return metadata for a single directory by ID.

Returns:

A Python DirectoryInformation object.

property list: list[DirectoryInformation]

Return registered directory definitions.

Returns:

A Python list of DirectoryInformation objects.

property session: EsriSession

Return the current session object.

property url: str

The current URL

Metadata for a registered system directory.

field id: str [Required]

The id of the directory

field name: str [Required]

The name of the directory

field path: str [Required]

The path to the directory

field type: str [Required]

The designated type for the directory contents

Bases: object

Manage index status and reindex operations for the system. Objects of this type are returned by the indexer property.

reindex(mode: ReindexMode) → dict[str, str]

Start a reindex operation for the requested mode.

Parameter	Description
mode	Required ReindexMode enum.

Returns:

A Python dict indicating results of the operation.

property session: EsriSession

Return the current session object.

property status: dict[str, str]

Return current index status as a Python dict.

property url: str

The current URL

Bases: object

Manage livestream protocol and port settings. Objects of this class are not created directly, but are returned by the livestream property.

property client_mode_protocols: ClientModeProtocols

Provide client playback protocol enablement flags as a ClientModeProtocols object.

property properties: LivestreamInformation

Return the combined livestream configuration document.

Returns:

dict[str, Any]

property server_mode_protocols: ServerModeProtocols

This resource displays whether WebRTC, HTTPS, Secure Reliable Transport (SRT), User Datagram Protocol (UPD), Real-Time Messaging Protocol (RTMP, RTMPS), and Real-Time Streaming Protocol (RTSP, RTSPS) livestreams are enabled or disabled. The attribute provides access to a ServerModeProtocols object.

property server_ports: ServerPorts

Retreives a ServerPorts object with configured ingest/listener ports for livestream protocols.

property session: EsriSession

Return the current session object.

set_client_mode_protocols(protocols: ClientModeProtocols) → dict[str, Any]

Sets whether HTTPS, Real-Time Messaging Protocol (RTMP, RTMPS), and Real-Time Streaming Protocol (RTSP, RTSPS) livestreams are enabled or disabled.

Returns:

dict[str, Any]

set_server_mode_protocols(protocols: ServerModeProtocols) → dict[str, Any]

Sets whether WebRTC, HTTPS, Secure Reliable Transport (SRT), User Datagram Protocol (UPD), Real-Time Messaging Protocol (RTMP, RTMPS), and Real-Time Streaming Protocol (RTSP, RTSPS) livestreams are enabled or disabled.

Returns:

dict[str, Any]

set_server_ports(ports: ServerPorts) → dict[str, Any]

Update livestream ingest/listener ports.

Returns:

dict[str, Any]

property url: str

The current URL

Combined livestream configuration information returned by the properties attribute of the LivestreamManager object.

field client_mode_protocols: ClientModeProtocols | None [Required]

Protocol enablement for client playback workflows.

field livestream_ports: ServerPorts | None [Required]

Configured ingest/listener ports for livestream protocols.

field server_mode_protocols: ServerModeProtocols | None [Required]

Protocol enablement for server-side ingest workflows.

Protocol enablement flags for client playback mode.

field https: bool | None [Required]

Indicates whether HTTPS streams are enabled.

field rtmp: bool | None [Required]

Indicates whether RTMP streams are enabled.

field rtmps: bool | None [Required]

Indicates whether RTMPS streams are enabled.

field rtsp: bool | None [Required]

Indicates whether RTSP streams are enabled.

field rtsps: bool | None [Required]

Indicates whether RTSPS streams are enabled.

Protocol enablement flags for livestream ingest in server mode.

field rtmp: bool | None [Required]

Indicates whether RTMP streams are allowed in Server Mode.

field rtmp_listen: bool | None [Required]

Indicates whether listening for RTMP streams is allowed in Server Mode.

field rtsp: bool | None [Required]

Indicates whether RTSP streams are allowed in Server Mode.

field rtsp_listen: bool | None [Required]

Indicates whether listening for RTSP streams is allowed in Server Mode.

field srt: bool | None [Required]

Indicates whether SRT streams are allowed in Server Mode.

field srt_listen: bool | None [Required]

Indicates whether listening for SRT streams is allowed in Server Mode.

field udp: bool | None [Required]

Indicates whether SRT streams are allowed in Server Mode.

field udp_listen: bool | None [Required]

Indicates whether listening for UDP streams is allowed in Server Mode.

Livestream listener port settings.

field range_max: int | None = 65535

The maximum SRT/UDP port value.

Constraints:

• gt = 0

field range_min: int | None = 49152

The minimum SRT/UDP port value.

Constraints:

• gt = 0

field rtmp_port: int | None = 1935

The default port for RTMP livestreams.

Constraints:

• gt = 0

field rtsp_port: int | None = 554

The default port for RTSP livestreams.

Constraints:

• gt = 0

Bases: object

Represent a single registered ArcGIS Web Adaptor.

Web adaptors provide the external entry point and reverse-proxy layer for ArcGIS Video Server requests.

Objects of this class are not created directly, but are instead returned by the list() method.

property properties: dict[str, Any]

Return endpoint JSON properties.

property session: EsriSession

Return the current session object.

unregister() → dict[str, str]

Unregister this web adaptor from the site.

property url: str

The current URL

Bases: object

Manage web adaptor resources for the video server site. Objects of this class are returned by the web_adaptors attribute of a SystemManager object.

property config: dict[str, str]

Get or set the shared web adaptor configuration.

Includes settings such as shared key material used by registered web adaptors. Set the configuration by assigning a dictionary to this property.

Parameter	Description
config	Required dict. The configuration items to be updated for this web adaptor. Always include the web adaptor’s sharedkey attribute.

list() → list

Returns a list of all registered web adaptors.

Returns:

A Python list of WebAdaptor objects.

property properties: dict[str, Any]

Return web adaptor collection metadata.

property session: EsriSession

Return the current session object.

property url: str

The current URL

Bases: object

Manage datastore registration and validation for Video Server. Data items describe connections to folders, cloud stores, object stores, and relational stores used by ArcGIS Video Server services. The class intializes an object created using the Data resource of a Video Server site.

Objects of this class are not initialized directy, but instead are accessed using the data property on an AdminVideoServer instance.

Example: Access the data manager for a Video Server instance:

from arcgis.gis import GIS
gis = GIS(profile="your_enterprise_admin_profile")

vid_server = gis.admin.servers.get(function="VideoServer")[0]
vid_admin = vid_server.admin
data_mgr = vid_admin.data

Example: Chaining properties together to access the data manager:

from arcgis.gis import GIS
gis = GIS(profile="your_enterprise_admin_profile")

vid_admin = gis.admin.servers.get(function="VideoServer")[0].admin
data_mgr = vid_admin.data
data_mgr

Output:

< DataManager @ https://example.com:21443/arcgis/admin/video/data >

add_cloud_store(item_desc: CloudStoreItemDescription) → dict[str, Any]

Sends a CloudStoreItemDescription to register a cloud-store as a data item with the server’s datastore.

add_database(item_desc: NoSQLItemDescription) → dict[str, Any]

Sends a NoSQLItemDescription to register a nosql database as a data item with the server’s datastore.

add_folder(item_desc: FolderItemDescription) → dict[str, Any]

Sends a FolderItemDescription to register a folder as a data item with the server’s datastore.

add_object_store(item_desc: ObjectStoreItemDescription) → dict[str, Any]

Sends a ObjectStoreItemDescription to register an object-store as a data item with the server’s datastore.

configure() → dict[str, Any]

Registers any currently relevant data items in the ArcGIS Enterprise data stores with the Video Server data store.

property default_item: DataItem | None

Get or set the the default data item. With proper permissiions, you can assign a data item object to this property to set one.

find_items(search_params: DataItemSearchParams) → dict[str, str]

Search for registered data items, defining an optional DataItemSearchParams object to filter what is returned.

Returns:

A Python dictionary containing an items key whose value is a list of dictionary objects providing properties of each registered data item.

Example: Finding data items

from arcgis.gis import GIS
from arcgis.gis.video.admin.data.model import DataItemSearchParams

gis = GIS(profile="your_enterprise_admin_profile")
vid_server = gis.admin.servers.get(function="VideoServer")[0]
vid_admin = vid_server.admin

data_mgr = vid_admin.data

dsearch_params = DataItemSearchParams(
    types="nosql"
)

data_items = data_mgr.find_items(search_params=dsearch_params)
print(data_items)

Output:

{
    "items": [
        {
            'path': '/nosqlDatabases/VideoDataStore_queue_P8KS6bwY',
            'name': 'pwDDgfqR',
            'id': '8fae8142-....-....-....-69202e52c315',
            'type': 'nosql',
            'info': {'hostname': 'EXAMPLE.COM',
                'password': 'v2...t_ifHJ-kE....-Ku_M.',
                'port': 45671,
                'username': '5pwr8oxn'
        }
    ]
}

property items: Generator[DataItem, None, None]

Retrieves a Python Generator of registered DataItem objects on the server

Returns:

A Python Generator for iterating over the objects of type DataItem.

Example: Get the list of registered data items for VideoServer

from arcgis.gis import GIS
gis = GIS(profile="your_enterprise_admin_profile")

vid_server = gis.admin.servers.get(function="VideoServer")[0]

data_mgr = vid_server.admin.data

item_generator = data_mgr.items
for data_item in item_generator:
    print(f"{data_item.properties['type']:15} {type(data_item)}")

Output:

nosql            <class 'arcgis.gis.video.admin.data.api.DataItem'>
folder           <class 'arcgis.gis.video.admin.data.api.DataItem'>
folder           <class 'arcgis.gis.video.admin.data.api.DataItem'>

register(item_desc: NoSQLItemDescription | FolderItemDescription | CloudStoreItemDescription | ObjectStoreItemDescription | dict[str, Any]) → dict[str, Any]

Registers a new DataItem with the server’s data store by submitting one of the following instances for the the item_desc argument:

• FolderItemDescription

• CloudStoreItemDescription

• ObjectStoreItemDescription

• NoSQLItemDescription

The method sends the argument as a JSONencoded request to the server.

property session: EsriSession

Return the current session object.

synchronize_data_stores() → dict[str, Any]

Verfies that the connectivity for all registered data items are accessible to all server nodes in the site and can used within the server’s data store.

Returns:

A Python dictionary containing a status key indicating success or failure of the operation.

property url: str

The resource endpoint for managing the data holdings of the Video Server server.

validate_data_item(item_desc: dict[str, str]) → dict[str, Any]

Checks to ensure that the key-value pairs representing the definition of a data item are valid.

Verifies that the path or connection details are reachable from all site machines before registration.

Bases: object

Represent a single registered data item resource.

Instances provide item metadata, machine-level validation resources, and item unregister support.

Objects of this class are not initialized directly; it is recommended to retrieve them using the items property of the DataManager.

Example: retrieve DataItem objects from DataManager.items

from arcgis.gis import GIS

gis = GIS(profile="your_enterprise_admin_profile")
vid_server = gis.admin.servers.get(function="VideoServer")[0]
vid_admin = vid_server.admin

data_mgr = vid_admin.data

data_item_list = list(data_mgr.items)
data_item_list

Output:

[< DataItem @ https://EXAMPLE.COM:21443/arcgis/admin/data/items/c8900a422f9b5e9141194a4d9146c584 >,
 < DataItem @ https://EXAMPLE.COM:21443/arcgis/admin/data/items/75eaee91-8f4a-42e3-8f76-ae96291e5379 >,
 < DataItem @ https://EXAMPLE.COM:21443/arcgis/admin/data/items/9eaa9491-f888-4af7-85b1-68802e44c311 >]

delete(force: bool) → dict[str, Any]

Unregisters this data item from the server’s data store.

property machines: Generator[Machine, None, None]

Retrieves a Python Generator for iterating over the machine resources associated with this data item.

Returns:

A Python Generator of machine objects.

property properties: dict[str, Any]

Retrieves a Python dictionary containing information about the DataItem, including its type, server path, name, and id value.

property session: EsriSession

Return the current EsriSession object.

property url: str

The resource endpoint for the registered data item.