Skip to content

PJSIPSetMaintenance - [res_pjsip_maintenance]

Synopsis

Enable or disable maintenance mode for a PJSIP endpoint.

Since

20.20.0, 22.10.0, 23.4.0

Description

Enables or disables maintenance mode for the specified PJSIP endpoint. While in maintenance mode, new inbound out-of-dialog requests are rejected with 503 Service Unavailable (except SUBSCRIBE/REGISTER with Expires: 0), and outbound originations via Dial() or ARI are refused before any SIP session or channel is created. In-progress dialogs are unaffected.

A 'PJSIPMaintenanceStatus' event is emitted when the state changes.

Syntax

Action: PJSIPSetMaintenance
ActionID: <value>
Endpoint: <value>
State: <value>
Arguments

  • ActionID - ActionID for this transaction. Will be returned.

  • Endpoint - The PJSIP endpoint name, or 'all' to toggle maintenance mode for every configured endpoint.

  • State - Desired maintenance state.

    • on

    • off

Generated Version

This documentation was generated from Asterisk branch 22 using version GIT