Accounting Transactions
This section describes the services available through Moab Web Services for interacting with the Transaction object in Moab Accounting Manager. It contains the URLs, request bodies, and responses delivered to and from MWS as an intermediary for MAM.
The Fields: Transactions reference contains the type and description of the default fields for the Transaction object.
Supported methods
| Resource | GET | PUT | POST | DELETE |
|---|---|---|---|---|
| /rest/accounting/transactions | Get All Transactions | -- | -- | -- |
| /rest/accounting/transactions/<id> | Get Single Transaction | -- | -- | -- |
This topic contains these sections:
The HTTP GET method is used to retrieve Transaction information.
Quick reference
GET http://localhost:8080/mws/rest/accounting/transactions?api-version=3 GET http://localhost:8080/mws/rest/accounting/transactions/<id>?api-version=3
URLs and parameters
GET http://localhost:8080/mws/rest/accounting/transactions?api-version=3&proxy-user=<user>[&query=<query_conditions>][&fields=<fields_to_display>[&sort=<fields_to_sort>]|&show-all=(true|false)]
| Parameter | Required | Type | Valid values | Description | Example |
|---|---|---|---|---|---|
| proxy-user | Yes | String | -- | Perform action as defined MAM user. | proxy-user=amy |
| query | No | JSON | -- |
Results are restricted to those having the specified field values.
The query parameter does not support the full Mongo query syntax. Only querying for a simple, non-nested JSON object is allowed. |
query={"action":"Charge","account":"chemistry"} |
| fields | No | String | -- | Comma-separated list of field names to display. | fields=id |
| sort | No | JSON | -- | Sort the results. Use 1 for ascending and -1 for descending. Should be used in conjunction with the Accounting Transactions parameter. | sort={"id":1} |
| show-all | No | Boolean | true or false | true shows all fields including metadata and hidden fields. Default is false. | show-all=true |
See Global URL Parameters for available URL parameters.
Sample response
GET http://localhost:8080/mws/rest/accounting/transactions?api-version=3&proxy-user=moab&query={"instance":"job.1"}&fields=object,action,instance,amount&pretty=true
------------------------------------
{
"totalCount": 310,
"resultCount": 3,
"results": [
{
"object": "UsageRecord",
"action": "Reserve",
"instance": "job.1",
"amount": 57600
},
{
"object": "UsageRecord",
"action": "Charge",
"instance": "job.1",
"amount": 11520
},
{
"object": "UsageRecord",
"action": "Refund",
"instance": "job.1",
"amount": 11520
}
]
}
URLs and parameters
GET http://localhost:8080/mws/rest/accounting/transactions/<id>?api-version=3&proxy-user=<user>[&fields=<fields_to_display>|&show-all=(true|false)]
| Parameter | Required | Type | Valid values | Description | Example |
|---|---|---|---|---|---|
| id | Yes | String | -- | The unique identifier of the object. | -- |
| fields | No | String | -- | Comma-separated list of field names to display. | fields=id |
| show-all | No | Boolean | true or false | true shows all fields including metadata and hidden fields. Default is false. | show-all=true |
See Global URL Parameters for available URL parameters.
Sample response
GET http://localhost:8080/mws/rest/accounting/transactions/1?api-version=3&proxy-user=moab&pretty=true
------------------------------------
{
"id": 1,
"object": "Organization",
"action": "Create",
"actor": "scottmo",
"key": "sciences",
"child": "",
"count": 1,
"instance": "",
"amount": "",
"delta": "",
"user": "",
"account": "",
"machine": "",
"fund": "",
"allocation": "",
"usageRecord": "",
"duration": "",
"description": ""
}
Related Topics