Method: projects.locations.apis.versions.operations.create

Create an apiOperation in an API version. An apiOperation can be created only if the version has no apiOperations which were created by parsing a spec.

HTTP request

POST https://apihub.googleapis.com/v1/{parent=projects/*/locations/*/apis/*/versions/*}/operations

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. The parent resource for the operation resource. Format: projects/{project}/locations/{location}/apis/{api}/versions/{version}

Query parameters

Parameters
apiOperationId

string

Optional. The ID to use for the operation resource, which will become the final component of the operation's resource name. This field is optional.

  • If provided, the same will be used. The service will throw an error if the specified id is already used by another operation resource in the API hub.
  • If not provided, a system generated id will be used.

This value should be 4-500 characters, overall resource name which will be of format projects/{project}/locations/{location}/apis/{api}/versions/{version}/operations/{operation}, its length is limited to 700 characters, and valid characters are /[a-z][A-Z][0-9]-_/.

Request body

The request body contains an instance of ApiOperation.

Response body

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

Authorization scopes

Requires the following OAuth scope:

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

IAM Permissions

Requires the following IAM permission on the parent resource:

  • apihub.apiOperations.create

For more information, see the IAM documentation.