| 1131 | | * '''Service:''' Experiments |
| 1132 | | * '''Operation:''' realizeExperiment |
| 1133 | | * '''Input Parameters:''' |
| 1134 | | * Userid - the user making the request (the owner on success) |
| 1135 | | * Owner - the experiment owner |
| 1136 | | * Name - a string containing the experiment to realize |
| 1137 | | * Notify - a flag, if true send the user a notification when realization is complete |
| 1138 | | * '''Return Values:''' |
| 1139 | | * None |
| 1140 | | |
| 1141 | | The user can either poll the experiment using {{{viewExperiments}}} and examining the {{{StateDetail}}} field or poll for a notification that the realization is complete. |
| 1142 | | |
| 1143 | | If the realization fails - as indicated by the {{{State}}} variable in a {{{viewExperiments}}} response, the {{{Log}}} and {{{FaultInfo}}} fields characterize the error. |
| 1144 | | |
| 1145 | | To release an experiment's resources: |
| 1146 | | |
| 1147 | | * '''Service:''' Experiments |
| 1148 | | * '''Operation:''' releaseExperiment |
| 1149 | | * '''Input Parameters:''' |
| 1150 | | * Userid - the user making the request (the owner on success) |
| 1151 | | * Owner - the experiment owner |
| 1152 | | * Name - a string containing the experiment to release |
| 1153 | | * Notify - a flag, if true send the user a notification when realization is complete |
| 1154 | | * '''Return Values:''' |
| 1155 | | * None |
| 1156 | | |
| 1157 | | After {{{releaseExperiment}}} succeeds, experiment state remains in the testbed, but containers are stopped and resources are returned to the testbed. |
| 1158 | | |
