Yes, there are management APIs in Apigee Edge for every operation that you can perform on the system. The index to all the methods is here. Helpfully, the APIs are all available via smartdocs, so you can invoke the APIs directly from your browser, to test them out.
I will try to answer your specific questions as well.
1. Adding API proxies to API Products.
You use the PUT verb and pass all product attributes. Suppose your existing product has two apiproxies, as shown by this query in curl :
$ curl -n -X GET ${mgmtserver}/v1/o/${orgname}/apiproducts/Prod1
{
"apiResources" : [ ],
"approvalType" : "auto",
"attributes" : [ {
"name" : "access",
"value" : "public"
} ],
"createdAt" : 1436383882428,
"createdBy" : "DChiesa@apigee.com",
"description" : "",
"displayName" : "Prod1",
"environments" : [ "test" ],
"lastModifiedAt" : 1440022507579,
"lastModifiedBy" : "DChiesa@apigee.com",
"name" : "Prod1",
"proxies" : [ "producttest1", "tokentest" ],
"quota" : "1000",
"quotaInterval" : "1",
"quotaTimeUnit" : "minute",
"scopes" : [ "" ]
}
To add another API proxy, use this kind of command:
$ curl -n -i \
-H "Content-Type:application/json" \
-X PUT ${mgmtserver}/v1/o/${orgname}/apiproducts/Prod1 \
-d '{
"approvalType" : "auto",
"attributes" : [ {
"name" : "access",
"value" : "public"
} ],
"displayName" : "Prod1",
"apiResources" : [ "/**" ],
"description" : "Testing update of product via mgmt API",
"environments": [ "test" ],
"proxies": [ "ytd911", "producttest1", "tokentest" ],
"quota": "1000",
"quotaInterval": "1",
"quotaTimeUnit": "minute"
}'
Upon query you should see the additional API proxy in the list:
$ curl -n -X GET ${mgmtserver}/v1/o/${orgname}/apiproducts/Prod1
{
"apiResources" : [ "/**" ],
"approvalType" : "auto",
"attributes" : [ {
"name" : "access",
"value" : "public"
} ],
"createdAt" : 1436383882428,
"createdBy" : "DChiesa@apigee.com",
"description" : "Testing update of product via mgmt API",
"displayName" : "Prod1",
"environments" : [ "test" ],
"lastModifiedAt" : 1448301574794,
"lastModifiedBy" : "DChiesa@apigee.com",
"name" : "Prod1",
"proxies" : [ "ytd911", "producttest1", "tokentest" ],
"quota" : "1000",
"quotaInterval" : "1",
"quotaTimeUnit" : "minute",
"scopes" : [ ]
}see the documentation here.
2. Update of API Proxies
For any API Proxy, you can update specific items, or you can import and deploy entirely new API proxy bundles. You don't specify exactly which path you'd prefer. In most cases customers perform the latter, because the API Proxy configuration is stored in source code control. They'll check out the latest copy from their git repo (or other repository), zip up the contents, and then import the entire bundle as a new revision of the API proxy.
This involves multiple steps. To zip up a bundle, you should use something like this:
zip -r apiproxy.zip apiproxy -x "*/*.*~" -x "*/#*.*#"
Then, to import the proxy as a new revision,
curl -n -X POST \
-H "Content-Type: application/octet-stream" \
"${mgmtserver}/v1/o/${orgname}/apis/?action=import&name=${apiname}" \
-T apiproxy.zip
You must examine the output of this command to determine the revision of the newly-imported bundle. You can then query the deployment status of other revisions
curl -n -X GET "${mgmtserver}/v1/o/${orgname}/apis/${apiname}/deployments"
...parse the output of that, undeploy the previously deployed revisions, from any environments in which they are deployed, like so:
curl -n -X POST \
"${mgmtserver}/v1/o/${orgname}/apis/${apiname}/revisions/${rev}/deployments?action=undeploy&env=${env}"
and then deploy the newly-imported revision:
curl -n -X POST \
"${mgmtserver}/v1/o/${orgname}/apis/${apiname}/revisions/$rev/deployments?action=deploy&env=${environment}" This action will affect all API Products which contain the specific api proxies.
3. Deleting API Proxies.
To delete an API proxy, you must first remove its association from any containing API Products, using the PUT command provided in the answer to question 1, that I gave above.
Then, undeploy any revisions you wish to delete, as shown in the answer to Question 2.
Then you can delete individual revisions, like so:
curl -n -X DELETE \
"${mgmtserver}/v1/o/${orgname}/apis/${apiproxy}/revisions/${rev}"or delete the API Proxy and ALL its revisions, like this:
curl -n -X DELETE \
"${mgmtserver}/v1/o/${orgname}/apis/${apiproxy}"
LinkedIn
Twitter
