Skip to main content

StopPrincipal

POST 
/admin/v1/customers/:customer_id/principals/:id/stop

StopPrincipal applies the emergency stop to a record of an install in directory identity mode, which is a principal that has no project (decision record 104). It requires a reason, and it writes one STOP_PRINCIPAL audit row with the reason in the transaction of the stop. The management plane and the data plane each keep an answer for 30 seconds, so a token call of the stopped caller can still be served for about 60 seconds. A second stop changes nothing and answers changed false. LiftPrincipalStop undoes a stop.

It refuses with FAILED_PRECONDITION, and writes a failed audit row, a principal that has a project, which is every principal of an install in built-in identity mode.

Request​

Responses​

Success