typedprovidersdeprecate

إلغاء إصدار دورة حياة موفر مخصص، مع إمكانية التراجع النشط.

ملاحظات رئيسية

• يتطلب حقول tenant_id و namespace_id.
• يتطلب إلغاء النسخة النشطة تراجعًا صريحًا إذا كانت نشطة = true.
• التراجع يختار أحدث إصدار نشط غير مهمل.

مدخلات

• namespace_id (مطلوب): معرف مساحة الاسم.
• provider_id (مطلوب): معرف المزود المكتوب.
• rollback_if_active (اختياري): تراجع عن النسخة النشطة قبل إلغاء استخدامها عند الحاجة.
• tenant_id (مطلوب): معرف المستأجر.
• version (مطلوب): إصدار دورة الحياة لإلغاء الاستخدام.

مخطط الإدخال

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

المخرجات

• active_version (مطلوب): واحدة من نسختين من المخطط.
• deprecated_version (مطلوب): إصدار دورة حياة قديم.
• provider_id (مطلوب): معرف المزود المكتوب.
• rolled_back_from (مطلوب): واحدة من نسختين من المخطط.

مخطط الإخراج

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

أمثلة

إلغاء إصدار مزود مكتوب مع إمكانية التراجع.

مدخل:

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