typedprovidersdeprecate

Desaconsellar una versió del cicle de vida del proveïdor tipat, amb una reversió activa opcional.

Notes clau

• Requereix els camps de l’abast tenant_id i namespace_id.
• La desactivació de la versió activa requereix un rollback_if_active=true explícit.
• La reversió selecciona la versió activa anterior més recent que no està obsoleta.

Inputs

• namespace_id (requerit): Identificador de l’espai de noms.
• provider_id (requerit): Identificador del proveïdor tipat.
• rollback_if_active (opcional): Revertir la versió activa abans de desactivar-la quan sigui necessari.
• tenant_id (required): Identificador del llogater.
• version (requerit): Versió del cicle de vida a desactivar.

Input Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "namespace_id": {
      "description": "Namespace identifier.",
      "minimum": 1,
      "type": "integer"
    },
    "provider_id": {
      "description": "Typed provider identifier.",
      "type": "string"
    },
    "rollback_if_active": {
      "description": "Rollback active version before deprecating when required.",
      "type": "boolean"
    },
    "tenant_id": {
      "description": "Tenant identifier.",
      "minimum": 1,
      "type": "integer"
    },
    "version": {
      "description": "Lifecycle version to deprecate.",
      "type": "string"
    }
  },
  "required": [
    "tenant_id",
    "namespace_id",
    "provider_id",
    "version"
  ],
  "type": "object"
}

Sortides

• active_version (requerit): Una de les 2 variants d’esquema.
• deprecated_version (requerit): Versió del cicle de vida obsoleta.
• provider_id (requerit): Identificador del proveïdor tipat.
• rolled_back_from (requerit): Una de les 2 variants d’esquema.

Esquema de sortida

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "active_version": {
      "oneOf": [
        {
          "type": "null"
        },
        {
          "description": "Current active version after deprecation.",
          "type": "string"
        }
      ]
    },
    "deprecated_version": {
      "description": "Deprecated lifecycle version.",
      "type": "string"
    },
    "provider_id": {
      "description": "Typed provider identifier.",
      "type": "string"
    },
    "rolled_back_from": {
      "oneOf": [
        {
          "type": "null"
        },
        {
          "description": "Former active version when rollback occurred.",
          "type": "string"
        }
      ]
    }
  },
  "required": [
    "provider_id",
    "deprecated_version",
    "active_version",
    "rolled_back_from"
  ],
  "type": "object"
}

Exemples

Deprecació d’una versió de proveïdor tipada amb retrocés.

Input:

{
  "namespace_id": 1,
  "provider_id": "asset_api",
  "rollback_if_active": true,
  "tenant_id": 1,
  "version": "2026-02-17.2"
}

Output:

{
  "active_version": "2026-02-17.1",
  "deprecated_version": "2026-02-17.2",
  "provider_id": "asset_api",
  "rolled_back_from": "2026-02-17.2"
}