{ Community }
  • Academy
  • Docs
  • Developers
  • Resources
    • Community Articles
    • Apigee on GitHub
    • Code Samples
    • Videos & eBooks
    • Accelerator Methodology
  • Support
  • Ask a Question
  • Spaces
    • General
    • Edge/API Management
    • Developer Portal
    • API Design
    • APIM on Istio
    • Extensions
    • Business of APIs
    • Academy/Certification
    • Analytics
    • Events
    • Integration (AWS, PCF, Etc.)
    • Microgateway
    • Monetization
    • Private Cloud Deployment
    • Insights
    • IoT Apigee Link
    • BaaS/Usergrid
    • BaaS Transition/Migration
    • Apigee-127
    • New Customers
    • Topics
    • Questions
    • Articles
    • Ideas
    • Leaderboard
    • Badges
  • Log in
  • Sign up

Get answers, ideas, and support from the Apigee Community

  • Home /
  • General /
avatar image
0
Question by Charlie Perrins · Jul 18, 2017 at 10:52 AM · 232 Views OpenAPI - Swagger Specrevisionspecapi specs

Can you use an updated API Spec document to generate a new revision of an existing Proxy?

I am fairly new to Apigee - have looked for an answer to this in the docs but can't find one.

I have created a simple API Spec and have used that to generate a working API Proxy - it's a proof of concept, just a couple of endpoints, but everything is working the way I wanted it to.

I now want to expand my proof of concept so I will add a few more endpoints to my API Spec swagger document.

Can I somehow import the new version of the spec into my Proxy as a new Revision using the web management interface? Or do I have to delete the Proxy and start again? It seems like there must be a process for taking changes in a Spec and updating a Proxy - but I can't work out how to do it.

Thanks - any advice appreciated

Comment
Add comment
10 |5000 characters needed characters left characters exceeded
▼
  • Viewable by all users
  • Viewable by Apigeeks only
  • Viewable by the original poster
  • Viewable by moderators
  • Viewable by moderators and the original poster
  • Advanced visibility
Viewable by all users

Close

1 Answer

· Add your answer
  • Sort: 
avatar image
0

Answer by williamssean · Nov 28, 2017 at 09:59 PM

Hello @Charlie Perrins.

If you have not modified the proxy by adding policies to the request flows, then you would delete the proxy and create it again with the updated Open API specification.

If you already modified the proxy by adding policies, then you should save that proxy as a new revision and then manually update the proxy according to the new Open API specification.

You can also import the updated Open API specification as a new revision using the openapi2apigee Node.js tool, but this assumes that you have not modified the current proxy revision.

The openapi2apigee Node.js tool performs the following:

  • It creates a proxy bundle locally based on the Open API spec and it will upload and deploy that proxy to Apigee Edge.
  • if the proxy already exists in Edge, then it will import the proxy as a new revision and deploy it if the appropriate command line arg is specified.

Comment
Add comment Show 1 · Link
10 |5000 characters needed characters left characters exceeded
▼
  • Viewable by all users
  • Viewable by Apigeeks only
  • Viewable by the original poster
  • Viewable by moderators
  • Viewable by moderators and the original poster
  • Advanced visibility
Viewable by all users
avatar image williamssean ♦ · Dec 01, 2017 at 11:39 PM 0
Link

@Charlie Perrins

Here are the instructions to update the proxy based on an updated OpenAPI spec from the UI.

1) Here is my Pet store proxy in Apigee Edge

2) Update the OpenAPI spec with the spec editor.

3) Go back to the proxy and save it as a new revision.

4) Click the Develop tab.

5) Click the + button next to default in the Proxy Endpoints section. Select the new path and click the Add button.

6) Save the proxy bundle.

Thanks @Sai Saran Vaidyanathan!

screen-shot-2017-12-01-at-33841-pm.png (25.2 kB)
screen-shot-2017-12-01-at-34043-pm.png (173.6 kB)
screen-shot-2017-12-01-at-34230-pm.png (87.1 kB)

Your answer

Hint: You can notify a user about this post by typing @username

Up to 5 attachments (including images) can be used with a maximum of 5.0 MB each and 25.0 MB total.

Follow this Question

Answers Answers and Comments

38 People are following this question.

avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image avatar image

Related Questions

Swagger Spec fails for PUT request 1 Answer

openapi spec generator tool not working 3 Answers

How do I simulate a given Swagger example response value in API Studio? 3 Answers

is apigee having Road map to import the swagger specs to apigee edge directly? 1 Answer

How to get the revision of only the deployed api proxy? 1 Answer

  • Products
    • Edge - APIs
    • Insights - Big Data
    • Plans
  • Developers
    • Overview
    • Documentation
  • Resources
    • Overview
    • Blog
    • Apigee Institute
    • Academy
    • Documentation
  • Company
    • Overview
    • Press
    • Customers
    • Partners
    • Team
    • Events
    • Careers
    • Contact Us
  • Support
    • Support Overview
    • Documentation
    • Status
    • Edge Support Portal
    • Privacy Policy
    • Terms & Conditions
© 2019 Apigee Corp. All rights reserved. - Apigee Community Terms of Use - Powered by AnswerHub
  • Anonymous
  • Sign in
  • Create
  • Ask a question
  • Create an article
  • Post an idea
  • Spaces
  • General
  • Edge/API Management
  • Developer Portal
  • API Design
  • APIM on Istio
  • Extensions
  • Business of APIs
  • Academy/Certification
  • Analytics
  • Events
  • Integration (AWS, PCF, Etc.)
  • Microgateway
  • Monetization
  • Private Cloud Deployment
  • Insights
  • IoT Apigee Link
  • BaaS/Usergrid
  • BaaS Transition/Migration
  • Apigee-127
  • New Customers
  • Explore
  • Topics
  • Questions
  • Articles
  • Ideas
  • Members
  • Badges