HI Isuru, please consider these requirements, too:
- It should be possible to introduce a dedicated EXPORTER and IMPORTER role (scope) with less privileges than ADMIN. Just be to able to EXPORT (IMPORT). - It should be possible to IMPORT APIs on behalf of a user. This would be very helpful when staging APIs, by that not the mostly technical "IMPORT" user will be the "creator" of an API (same applies to other API-calls like publishing an API). - It should be possible to EXPORT a subset of APIs based on TAG(s) and maybe other attributes Thanks, Jochen Akalanka Pagoda Arachchi <darsha...@wso2.com> schrieb am Mi., 11. Jan. 2017 um 11:02 Uhr: > Hi Isuru, > > Will importing an already available API updated the existing API? This > would be useful for someone when following agile development to create APIs. > > What are the options provided to update the endpoint URIs? For an example > if an API is created in a UAT environment and need to move that to PROD, > how can someone update the endpoints URIs to match the PROD environment. > > Thanks, > Akalanka. > > On Wed, Jan 11, 2017 at 3:15 PM, Isuru Haththotuwa <isu...@wso2.com> > wrote: > > > > On Wed, Jan 11, 2017 at 11:01 AM, Nuwan Dias <nuw...@wso2.com> wrote: > > > > On Tue, Jan 10, 2017 at 11:22 AM, Isuru Haththotuwa <isu...@wso2.com> > wrote: > > Hi Devs, > > This is to discuss subject. > > *Requirement:* > > Once an API is exported, its possible to be directly imported in to > another APIM deployment in a separate environment. For an admin user, it > should be possible to export all APIs in one deployment to another one. > > The following information will be available in exported data, related to a > single API: > > - Docs > - API definition (JSON formatted) > - Swagger file (JSON formatted) > - Gateway configuration > - API thumbnails (image) > > Several new resources will be added to the publisher rest API to cater > this, as follows: > > *GET **/apis/{apiId}**/export-config* > > > I don't think this URI is correct. A user of this API won't know the API > ID. Hence I think the correct URI should be as *GET > /export/api?name=Foo&version=v1* > > Agreed. Api Id is an internal detail. Hence the correct way should be to > use api name and version to uniquely identify an API. > > > - Produces a form/multipart output as a zip archive, which will have > the following structure and which will comprise of the above mentioned > items: > > * <provider-name>-<api-name>-<* > > *api-version>.zip |* > > > * | --- Docs | |* > * | | --- *<documentation_id> > * | * > * |* > * | | ---* documentation > metadata (json) > * | | ---* documentation > content (optional) > > * |* > > > * | --- Gateway-Config | > |* > * | | --- *gateway config file > > * |* > * | --- *thumbnail file > > * |* > * | --- *api definition (json) > > * |* > * | --- *swagger definition (json) > > > Note that there can be multiple docs for a single API. > > *GET **/apis/export-config* > > - Produces a zip archive comprising of the above structure for each > API in the system. This operation will be permitted for admin users only. > > > *POST **/apis**/{apiId}**/import-config* > > - Consumes the same zip archive produced by the /{apiId/}export-config > resource as a form/multipart input, extracts and inserts the relevant data. > > > *POST * > */apis/import-config* > > - Consumes the same zip archive produced by the /export-config > resource as a form/multipart input, extracts and inserts the relevant data > for all APIs. Should be permitted only for admin users. > > > This does not consider the endpoint information [1] yet. Would need to > incorporate that here in a suitable way. > > Please share your feedback. > > [1]. [Architecture] [APIM][C5] - Definining Endpoint for Resource from > Rest API > > -- > Thanks and Regards, > > Isuru H. > +94 716 358 048 <071%20635%208048>* <http://wso2.com/>* > > > > _______________________________________________ > Architecture mailing list > Architecture@wso2.org > https://mail.wso2.org/cgi-bin/mailman/listinfo/architecture > > > > > -- > Nuwan Dias > > Software Architect - WSO2, Inc. http://wso2.com > email : nuw...@wso2.com > Phone : +94 777 775 729 <077%20777%205729> > > _______________________________________________ > Architecture mailing list > Architecture@wso2.org > https://mail.wso2.org/cgi-bin/mailman/listinfo/architecture > > > > > -- > Thanks and Regards, > > Isuru H. > +94 716 358 048 <+94%2071%20635%208048>* <http://wso2.com/>* > > > > _______________________________________________ > Architecture mailing list > Architecture@wso2.org > https://mail.wso2.org/cgi-bin/mailman/listinfo/architecture > > > > > -- > *Darshana Akalanka Pagoda Arachchi,* > *Senior Software Engineer, WSO2* > *+94777118016 <+94%2077%20711%208016>* > _______________________________________________ > Architecture mailing list > Architecture@wso2.org > https://mail.wso2.org/cgi-bin/mailman/listinfo/architecture >
_______________________________________________ Architecture mailing list Architecture@wso2.org https://mail.wso2.org/cgi-bin/mailman/listinfo/architecture