Migrate from CAPI to Patterns

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 1 minute de lecture
  • Migrate from Cloud API (CAPI)-based Cloud Discovery to Patterns-based Cloud Discovery. The task requires supported instance and few plugins. Migration works for Amazon Web Services (AWS) and Microsoft Azure. Administrator can perform this task after the initial instance is set up.

    Avant de commencer

    Ensure that your ServiceNow AI Platform has the following:

    • The release version is Paris or later.
    • The Discovery and Service Mapping Patterns (sn_itom_pattern) plugin.

    Role required: discovery_admin

    Pourquoi et quand exécuter cette tâche

    When the migration is triggered, the script disables the appropriate CAPI discovery steps for the cloud environment to prevent them being triggered during cloud discovery. Also, the script enables the appropriate cloud patterns for the environment that is used to run future cloud discovery. After the migration, discovery uses the latest patterns instead of the legacy discovery method, CAPI.

    Remarque :

    The CAPI-based discovery method is going to be deprecated in the future.

    Procédure

    1. Navigate to All > Pattern Designer > Migrate CPG to Pattern.
    2. On the CAPI to Pattern Migration page, read the instructions and select Run Prerequisites Check.
    3. After the Prerequisite scan is passed, you can either choose as follows:
      • Migrate All—Migrate both AWS and Azure together.
      • Migrate AWS or Migrate Azure—Migrate each instance one at a time.
    4. Select Migrate and confirm to proceed migration.
      Remarque :

      For any issues while migrating, see the troubleshooting steps documented in the CAPI to Pattern Migration: Procedure for switching from CAPI-based Cloud Discovery to pattern-based Cloud Discovery [KB0827153] article in the Now Support Knowledge Base.