Method: organizations.hostQueries.create

Submit a query at host level to be processed in the background. If the submission of the query succeeds, the API returns a 201 status and an ID that refer to the query. In addition to the HTTP status 201, the state of "enqueued" means that the request succeeded.

HTTP request

POST https://apigee.googleapis.com/v1/{parent=organizations/*}/hostQueries

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. The parent resource name. Must be of the form organizations/{org}.

Authorization requires the following IAM permission on the specified resource parent:

  • apigee.hostqueries.create

Request body

The request body contains an instance of Query.

Response body

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

Authorization scopes

Requires the following OAuth scope:

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