typedprovidersdeprecate

Descontinuar una versión del ciclo de vida del proveedor tipado, con retroceso activo opcional.

Notas clave

• Requiere los campos de ámbito tenant_id y namespace_id.
• La desactivación de la versión activa requiere un rollback_if_active=true explícito.
• La reversión selecciona la versión activa más reciente que no está en desuso.

Entradas

• namespace_id (requerido): Identificador de espacio de nombres.
• provider_id (requerido): Identificador de proveedor tipado.
• rollback_if_active (opcional): Revertir la versión activa antes de descontinuar cuando sea necesario.
• tenant_id (required): Identificador del inquilino.
• version (requerido): Versión del ciclo de vida a desaprobar.

Esquema de Entrada

{
  "$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"
}

Salidas

• active_version (requerido): Una de 2 variantes de esquema.
• deprecated_version (requerido): Versión del ciclo de vida obsoleta.
• provider_id (requerido): Identificador de proveedor tipado.
• rolled_back_from (requerido): Una de 2 variantes de esquema.

Esquema de Salida

{
  "$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"
}

Ejemplos

Descontinuar una versión de proveedor tipado con reversión.

Entrada:

{
  "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"
}