REST Resource: projects.locations.curations

Resource: Curation

A curation resource in the API Hub.

JSON representation
{"name":string,"displayName":string,"description":string,"endpoint":{object (Endpoint)},"pluginInstanceActions":[{object (PluginInstanceActionID)}],"lastExecutionState":enum (LastExecutionState),"lastExecutionErrorCode":enum (ErrorCode),"lastExecutionErrorMessage":string,"createTime":string,"updateTime":string}
Fields
name

string

Identifier. The name of the curation.

Format:projects/{project}/locations/{location}/curations/{curation}

displayName

string

Required. The display name of the curation.

description

string

Optional. The description of the curation.

endpoint

object (Endpoint)

Required. The endpoint to be triggered for curation.

pluginInstanceActions[]

object (PluginInstanceActionID)

Output only. The plugin instances and associated actions that are using the curation. Note: A particular curation could be used by multiple plugin instances or multiple actions in a plugin instance.

lastExecutionState

enum (LastExecutionState)

Output only. The last execution state of the curation.

lastExecutionErrorCode

enum (ErrorCode)

Output only. The error code of the last execution of the curation. The error code is populated only when the last execution state is failed.

lastExecutionErrorMessage

string

Output only. Error message describing the failure, if any, during the last execution of the curation.

createTime

string (Timestamp format)

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

Uses RFC 3339, where generated output will always be Z-normalized and use 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 curation was last updated.

Uses RFC 3339, where generated output will always be Z-normalized and use 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".

Endpoint

The endpoint to be triggered for curation. The endpoint will be invoked with a request payload containing [ApiMetadata][google.cloud.apihub.v1.ApiHub.ApiMetadata]. Response should contain curated data in the form of [ApiMetadata][google.cloud.apihub.v1.ApiHub.ApiMetadata].

JSON representation
{// Union fieldendpoint_details can be only one of the following:"applicationIntegrationEndpointDetails":{object (ApplicationIntegrationEndpointDetails)}// End of list of possible types for union fieldendpoint_details.}
Fields
Union fieldendpoint_details. The details of the endpoint to be triggered for curation.endpoint_details can be only one of the following:
applicationIntegrationEndpointDetails

object (ApplicationIntegrationEndpointDetails)

Required. The details of the Application Integration endpoint to be triggered for curation.

ApplicationIntegrationEndpointDetails

The details of the Application Integration endpoint to be triggered for curation.

JSON representation
{"uri":string,"triggerId":string}
Fields
uri

string

Required. The endpoint URI should be a valid REST URI for triggering an Application Integration. Format:https://integrations.googleapis.com/v1/{name=projects/*/locations/*/integrations/*}:execute orhttps://{location}-integrations.googleapis.com/v1/{name=projects/*/locations/*/integrations/*}:execute

triggerId

string

Required. The API trigger ID of the Application Integration workflow.

PluginInstanceActionID

The plugin instance and associated action that is using the curation.

JSON representation
{"pluginInstance":string,"actionId":string}
Fields
pluginInstance

string

Output only. Plugin instance that is using the curation. Format isprojects/{project}/locations/{location}/plugins/{plugin}/instances/{instance}

actionId

string

Output only. The action ID that is using the curation. This should map to one of the action IDs specified in action configs in the plugin.

LastExecutionState

The state of the last execution of the curation.

Enums
LAST_EXECUTION_STATE_UNSPECIFIEDDefault unspecified state.
SUCCEEDEDThe last curation execution was successful.
FAILEDThe last curation execution failed.

ErrorCode

The error codes for failed executions.

Enums
ERROR_CODE_UNSPECIFIEDDefault unspecified error code.
INTERNAL_ERRORThe execution failed due to an internal error.
UNAUTHORIZEDThe curation is not authorized to trigger the endpoint uri.

Methods

create

 Create a curation resource in the API hub.

delete

 Delete a curation resource in the API hub.

get

 Get curation resource details.

list

 List curation resources in the API hub.

patch

 Update a curation resource in the API hub.

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 2025-12-11 UTC.