Application Mapping REST Interface
Data
Application mapping is a list of dictionary entries. Each entry specifies one particular mapping:
- application_uuid The internal UUID of the mapped application.
- hosts A list of all hosts assigned in the particular mapping.
- prefixes A list of all prefixes assigned in the particular mapping.
For more information regarding application mapping concepts, see Application Mapping, Paths, Preconditions.
For more information regarding editing application mapping using the user interface, see Editing Application Mapping.
Getting the configured customer keys
- Request
Method | GET |
|---|---|
URL | /application-mapping/ |
Arguments | – |
- Response
Reason code | Arguments | Meaning |
|---|---|---|
200 | | dictionary containing all customer keys that are available An underscore stands for the empty "[Default Customer Key]" |
401 | – | no login |
403 | – | not enough rights |
500 | – | internal server error |
Getting the application mapping for a specific customer key
- Request
Method | GET |
|---|---|
URL | /application-mapping/customer_key The empty “[Default Customer Key]” needs to be addressed as “_” (underscore). |
Arguments | – |
- Response
Reason code | Arguments | Meaning |
|---|---|---|
200 | | dictionary containing all customer keys that are available An underscore stands for the empty "[Default Customer Key]" |
401 | – | no login |
403 | – | not enough rights |
404 | – | no application mapping exists for the given customer key |
500 | – | internal server error |
- Example
The following request retrieves the application mapping for the empty [Default Customer Key].
$ curl -n https://something.com:8087/api/af/latest/application-mapping/_ { "__name": "_", "__path": "/api/af/latest/application-mapping/_/", "__subnodes": [], "customer_key": "", "mapping": [ { "application_uuid": "6b35f8fb2d65288d-5dbded6e7c4389a81c1b28d43eea8628", "hosts": [ "api.something.de" ], "prefixes": [ "" ] }, { ...