Install Provider
Queue installation of a provider from the store, or install a failed installation again.
The installation reaches READY asynchronously. Installing a failed installation again keeps its stored version, upgrade policy and config wherever the request omits them.
Returns:
The installation in PENDING, new or a failed one installed again.
Poll GET /providers/installed until the installation reaches
READY or FAILED.
Body
Request model for installing a store provider.
Attributes: provider_name: Store provider name to install (org/name format). version: Specific version to install (None = latest published on a first install, the stored version when installing a failed installation again). upgrade_policy: How upgrades should be handled (None = manual on a first install, kept when installing a failed installation again). config: Environment variables passed only to this provider's child process.
Response
Successful Response
Public-facing response model for a provider installation.
Excludes the internal infrastructure field current_image, which is
not meaningful to API consumers.
Attributes:
prefix: Namespace token of the installed provider.
name: Provider short name within the prefix.
installed_version: Semver of the currently installed version.
current_version: Version currently deployed (None if never deployed).
upgrade_policy: Whether upgrades are applied automatically or manually.
config: Environment variables passed only to this provider's child process.
installed_at: Timestamp when the provider was first installed.
created_at: Creation timestamp.
updated_at: Last update timestamp.
lifecycle_state: Deploy lifecycle state of the installation
(PENDING/PROCESSING/READY/FAILED/DELETING).
health: Rolling reachability signal (healthy or
degraded). Independent of lifecycle_state.
health_message: Optional detail string for the last health
transition; None when healthy or unset.
Lifecycle state of a ProviderInstallation.
Mirrors the resource lifecycle pattern: a single linear state owned
by the installation row that platform workers transition forward.
Distinct from :class:DeploymentStatus, which reflects the observed
state of the underlying kubernetes Deployment.
States: PENDING: Installation row created; no deploy attempt yet. PROCESSING: Deploy in flight (artifact apply or upgrade running). READY: Provider self-registered and is reachable. FAILED: Deploy or registration failed terminally. DELETING: Uninstall in progress; row will be removed when done.
pending, processing, ready, failed, deleting healthy, degraded Slash-joined prefix/name canonical string of the owning provider.
Returns: Display form of the provider identity this installation targets.
How a tenant wants installed providers to be upgraded.
auto, manual