Support for Git Operations
APIM supports Git integration. You can now effectively manage your API versions by associating them to source control repositories like Git and other Git hosting options supported by SnapLogic. You can create APIs from Git repositories, reusing existing SnapLogic Assets tracked in Git. Your Org must have Git integration set up. With Git integration, you can track, update, and manage versions of SnapLogic project files, pipelines, tasks, and accounts, using either the SnapLogic graphical interface or the SnapLogic Public APIs. When you create API Versions using SnapLogic Assets, the APIM console displays the Git operations available to you.
Info |
---|
APIM support for Git does not extend to API Proxies. |
Prerequisites
Cloudplex instances need a Cloudplex FeedMaster node and a load balancer for the API Policy Manager to work.
Contact support@snaplogic.com to provision the Cloudplex FeedMaster node and the load balancer as needed.
When the load balancer becomes available, your Org admin must update the Load Balancer URL in the Snaplex Settings. Learn how: Updating a Snaplex
You must use the load balancer URL in your Triggered and Ultra Task endpoints.
The API Management feature must be enabled for your Org. Contact SnapLogic Support to subscribe to this feature.
API Management Architecture
The following diagram illustrates the components of API Management Architecture.
The Design-First Workflow
You can create a new API in the /apim
space of the API Manager and import or reference an API specification that defines the API. The new API comprises a Pipeline that is the scaffolding for the API and the Task used to call it. You can then create versions, add API policies, and modify the underlying SnapLogic assets to build the business logic for your API.
The following video demonstrates the workflow:
Learn more: Creating the API using Design First
The Pipeline-First Workflow
You can also create an API in the API Manager by referencing existing Projects in Manager. This allows you to design, build, and test your Pipeline first, thereby taking advantage of your existing SnapLogic infrastructure. As you build Pipelines and create Triggered Tasks from them, you vet them for production individually and concurrently. When your Pipeline and Tasks are production-ready, you can create APIs in the API Manager.
The following video demonstrates the workflow:
Learn more: Creating the API from Existing Project Assets
Limitations
Orgs with APIM should not use Enhanced Encryption for the following reasons:
Orgs with Enhanced Encryption do not support subscriptions on the Developer Portal.
Org admins who rotate keys for their Groundplexes must also reconfigure all API policies as well for them to work.
Only one instance of an API policy type is applicable at each level in the hierarchy.
API Manager does not support Scheduled Tasks. When you open a Task in an API version, you do not have the option to change the Run Policy to Scheduled.
In Designer, when you open a Pipeline in an API version, the Snaplex selector in the Edit Pipeline dialog window only shows the Snaplex instances from the global shared folder.
In Designer, if you open the Snap dialog window from a Pipeline in the API Management -
/apim
space, the asset or account selectors display only the assets from the global shared folder, in addition to those in the current version.You can change the Snaplex for an unpublished API version. To do so, go to API Manager, choose the API, go to the Versions tab, choose the version, click Edit Details, and choose from the Server dropdown. Note: This field is disabled if the API version is published or if the Snaplex is down.