Creates a new flood test and returns its details. This may be a long-running request.
Note to windows users when using curl be sure to prepend the flood_files[] value with an @ symbol if using curl. This indicates to curl the rest should be a file name to read the data from e.g. -F "flood_files[]=@C:/Users/tim/mytest.jmx"
Copy POST https://api.flood.io/floods
Launch a flood on a new grid
Copy curl -u ${API_TOKEN} : -X POST https://api.flood.io/floods \
-F "flood[tool]=jmeter" \
-F "flood[threads]=10" \
-F "flood[privacy]=public" \
-F "flood[name]=MyTest" \
-F "flood[tag_list]=ci,shakeout" \
-F "flood_files[]=@jmeter-with-plugins.jmx" \
-F "flood[grids][][infrastructure]=demand" \
-F "flood[grids][][instance_quantity]=1" \
-F "flood[grids][][region]=us-west-2" \
-F "flood[grids][][instance_type]=m4.xlarge" \
-F "flood[grids][][stop_after]=60"
Lauch a flood on multiple new grids
Copy curl -u ${FLOOD_API_TOKEN} : -X POST https://api.flood.io/floods \
-F "flood[tool]=jmeter" \
-F "flood[threads]=10" \
-F "flood[privacy]=public" \
-F "flood[name]=MyTest" \
-F "flood_files[]=@jmeter-with-plugins.jmx" \
-F "flood[grids][][infrastructure]=demand" \
-F "flood[grids][][instance_quantity]=1" \
-F "flood[grids][][region]=ap-southeast-2" \
-F "flood[grids][][instance_type]=m4.xlarge" \
-F "flood[grids][][stop_after]=60" \
-F "flood[grids][][infrastructure]=demand" \
-F "flood[grids][][instance_quantity]=1" \
-F "flood[grids][][region]=ap-southeast-2" \
-F "flood[grids][][instance_type]=m4.xlarge" \
-F "flood[grids][][stop_after]=60" | jq -r .
Launch flood on an existing grid
Copy curl -u ${API_TOKEN} : -X POST https://api.flood.io/floods \
-F "flood[tool]=jmeter" \
-F "flood[threads]=50" \
-F "flood_files[]=@/path/to/testplan.jmx" \
-F "flood_files[]=@/path/to/testdata.csv" \
-F "flood[grids][][uuid]=qpjrj4MnKmR3VgxOLtuMww"
Copy {
"_links" : {
"self" : {
"href" : "/api/floods/VCFstUfl0AMdtaKYBo5d7A"
}
} ,
"uuid" : "VCFstUfl0AMdtaKYBo5d7A" ,
"batch_id" : "1VVGD5LBVvuatWEJ9SB8aA" ,
"apdex" : null ,
"tool" : "jmeter" ,
"name" : "MyTest" ,
"notes" : null ,
"threads" : 10 ,
"rampup" : null ,
"duration" : null ,
"tag_list" : [
"ci" ,
"shakeout"
] ,
"status" : "queued" ,
"permalink" : "https://flood.io/VCFstUfl0AMdtaKYBo5d7A" ,
"remote_errors" : null ,
"started" : null ,
"stopped" : null ,
"_embedded" : {
"grids" : [
{
"_links" : {
"self" : {
"href" : "/api/grids/hg8ZjZcifgsuQvDfcnBONw"
}
} ,
"uuid" : "hg8ZjZcifgsuQvDfcnBONw" ,
"batch_id" : "1VVGD5LBVvuatWEJ9SB8aA" ,
"name" : "jubilant-peak-production-hg8ZjZcifgsuQvDfcnBONw" ,
"region" : "us-west-2" ,
"origin" : "US West (Oregon)" ,
"instance_quantity" : 1 ,
"instance_type" : "m4.xlarge" ,
"infrastructure" : "demand" ,
"stop_after" : 60 ,
"status" : "starting" ,
"nodes" : []
}
] ,
"files" : [
{
"name" : "lRFFUcXvSIp7pHftfnC7x8" ,
"href" : "..."
}
] ,
"archives" : []
}
}