v3: builds

[karenetheridge]

• New endpoints:

  • GET /build/:build_id_or_name
  • POST /build/:build_id_or_name
  • GET /build/:build_id_or_name/user
  • POST /build/:build_id_or_name/user?send_mail=<1|0>
  • DELETE /build/:build_id_or_name/user/-target_user_id_or_email?send_mail=<1|0>
  • GET /build/:build_id_or_name/organization
  • POST /build/:build_id_or_name/organization?send_mail=<1|0>
  • DELETE /build/:build_id_or_name/organization/:organization_id_or_name?send_mail=<1|0>
  • GET /build/:build_id_or_name/device
  • POST /build/:build_id_or_name/device/:device_id_or_serial_number
  • DELETE /build/:build_id_or_name/device/:device_id_or_serial_number
  • GET /build/:build_id_or_name/rack
  • POST /build/:build_id_or_name/rack/:rack_id
  • DELETE /build/:build_id_or_name/rack/:rack_id

• role checks everywhere now take builds into consideration (device and rack existence in a build, user-build and organization-build role entries)

• some state changes may not be right: more discussion/consideration needed (for example, what side effects should occur when a build, device or rack changes state, and which state transitions should not be permitted)