ConflictError
extends AuthzError
in package
`409 Conflict` on the §27 management surface — CONTRACT.md §27.4 rule 7.
Extends AuthzError because §2 already maps 409 there as a resource-level
refusal; rule 7 KEEPS that mapping rather than moving it. A catch (AuthzError $e)
written before §27 existed therefore behaves exactly as it did.
reason_code (contract 1.62, §36.4). A 409 of the network operations says which
conflict it is in a reason_code member of its body (stale_version, strands_profile,
has_children, site_gone, duplicate_name, duplicate_vlan, duplicate_rank,
profile_exists, other, ...). self::getReasonCode() returns it verbatim — the
vocabulary is open, so a value this SDK has never seen comes back as the server wrote it —
and null when the body carries none (a server before 1.1.0, or a conflict of another
namespace). A caller branches on that code and never on the message, which is for a person.
Table of Contents
Methods
- __construct() : mixed
- getAction() : string|null
- Action the caller was denied (e.g. `users:delete`).
- getReasonCode() : string|null
- The `reason_code` the server named for this conflict (§36.3 rule 2, §36.4).
- getResourceId() : string|null
- Resource the denial applies to.
Methods
__construct()
public
__construct(string $message[, string|null $reasonCode = null ]) : mixed
Parameters
- $message : string
-
Describes what already exists, or what state forbids the write.
- $reasonCode : string|null = null
-
The
reason_codemember of the409body, as written, ornullwhen the body had none.
getAction()
Action the caller was denied (e.g. `users:delete`).
public
getAction() : string|null
Return values
string|null —null when the server did not report an action.
getReasonCode()
The `reason_code` the server named for this conflict (§36.3 rule 2, §36.4).
public
getReasonCode() : string|null
Return values
string|null —The code verbatim (an unknown one included), or null when the
response carried none. Never parsed out of the message.
getResourceId()
Resource the denial applies to.
public
getResourceId() : string|null
Return values
string|null —null for a global (non-resource-scoped) denial, or when the
server did not report a resource.