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 usesgRPC 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 ofTestMatrix.

Response body

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

Authorization scopes

Requires the following OAuth scope:

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

For more information, see theAuthentication Overview.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2024-07-25 UTC.