Method: projects.testMatrices.create

Creates and runs a matrix of tests according to the given specifications. Unsupported environments will be returned in the state UNSUPPORTED. A test matrix is limited to use at most 2000 devices in parallel.

The returned matrix will not yet contain the executions that will be created for this matrix. Execution creation happens later on and will require a call to testMatrices.get.

May return any of the following canonical error codes:

  • PERMISSION_DENIED - if the user is not authorized to write to project
  • INVALID_ARGUMENT - if the request is malformed or if the matrix tries to use too many simultaneous devices.

HTTP request

POST https://testing.googleapis.com/v1/projects/{projectId}/testMatrices

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
projectId

string

The GCE project under which this job will run.

Query parameters

Parameters
requestId

string

A string id used to detect duplicated requests. Ids are automatically scoped to a project, so users should ensure the ID is unique per-project. A UUID is recommended.

Optional, but strongly recommended.

Request body

The request body contains an instance of TestMatrix.

Response body

If successful, the response body contains a newly created instance of TestMatrix.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.