REST Resource: projects.locations.apis.versions.operations

Resource: ApiOperation

Represents an operation contained in an API version in the API hub. An operation is added/updated/deleted in an API version when a new spec is added or an existing spec is updated/deleted in a version. Currently, an operation will be created only corresponding to OpenAPI spec as parsing is supported for OpenAPI spec. Alternatively operations can be managed via create,update and delete APIs, creation of apiOperation can be possible only for version with no parsed operations and update/delete can be possible only for operations created via create API.

JSON representation 
{
  "name": string,
  "spec": string,
  "details": {
    object (OperationDetails)
  },
  "createTime": string,
  "updateTime": string,
  "attributes": {
    string: {
      object (AttributeValues)
    },
    ...
  },
  "sourceMetadata": [
    {
      object (SourceMetadata)
    }
  ]
}
Fields
name

string

Identifier. The name of the operation.

Format: projects/{project}/locations/{location}/apis/{api}/versions/{version}/operations/{operation}
spec

string

Output only. The name of the spec will be of the format: projects/{project}/locations/{location}/apis/{api}/versions/{version}/specs/{spec} Note:The name of the spec will be empty if the operation is created via operations.create API.
details

object (OperationDetails)

Optional. Operation details. Note: Even though this field is optional, it is required for operations.create API and we will fail the request if not provided.
createTime

string (Timestamp format)

Output only. The time at which the operation was created.

Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Output only. The time at which the operation was last updated.

Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
attributes

map (key: string, value: object (AttributeValues))

Optional. The list of user defined attributes associated with the API operation resource. The key is the attribute name. It will be of the format: projects/{project}/locations/{location}/attributes/{attribute}. The value is the attribute values associated with the resource.

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
sourceMetadata[]

object (SourceMetadata)

Output only. The list of sources and metadata from the sources of the API operation.

OperationDetails

The operation details parsed from the spec.

JSON representation 
{
  "description": string,
  "documentation": {
    object (Documentation)
  },
  "deprecated": boolean,

  // Union field operation can be only one of the following:
  "httpOperation": {
    object (HttpOperation)
  }
  // End of list of possible types for union field operation.
}
Fields
description

string

Optional. Description of the operation behavior. For OpenAPI spec, this will map to operation.description in the spec, in case description is empty, operation.summary will be used.
documentation

object (Documentation)

Optional. Additional external documentation for this operation. For OpenAPI spec, this will map to operation.documentation in the spec.
deprecated

boolean

Optional. For OpenAPI spec, this will be set if operation.deprecatedis marked as true in the spec.

Union field operation.

operation can be only one of the following:
httpOperation

object (HttpOperation)

The HTTP Operation.

HttpOperation

The HTTP Operation.

JSON representation 
{
  "path": {
    object (Path)
  },
  "method": enum (Method)
}
Fields
path

object (Path)

Optional. The path details for the Operation. Note: Even though this field is optional, it is required for operations.create API and we will fail the request if not provided.
method

enum (Method)

Optional. Operation method Note: Even though this field is optional, it is required for operations.create API and we will fail the request if not provided.

Path

The path details derived from the spec.

JSON representation 
{
  "path": string,
  "description": string
}
Fields
path

string

Optional. Complete path relative to server endpoint. Note: Even though this field is optional, it is required for operations.create API and we will fail the request if not provided.
description

string

Optional. A short description for the path applicable to all operations.

Method

Enumeration of Method types.

Enums
METHOD_UNSPECIFIED Method unspecified.
GET Get Operation type.
PUT Put Operation type.
POST Post Operation type.
DELETE Delete Operation type.
OPTIONS Options Operation type.
HEAD Head Operation type.
PATCH Patch Operation type.
TRACE Trace Operation type.

Methods

create

 Create an apiOperation in an API version.

delete

 Delete an operation in an API version and we can delete only the operations created via create API.

get

 Get details about a particular operation in API version.

list

 List operations in an API version.

patch

 Update an operation in an API version.