Method: projects.locations.entryGroups.entries.tags.reconcile

tags.reconcile creates or updates a list of tags on the entry. If the ReconcileTagsRequest.force_delete_missing parameter is set, the operation deletes tags not included in the input tag list.

tags.reconcile returns a long-running operation resource that can be queried with Operations.GetOperation to return ReconcileTagsMetadata and a ReconcileTagsResponse message.

HTTP request

POST https://datacatalog.googleapis.com/v1/{parent}/tags:reconcile

Path parameters

Parameters
parent

string

Required. Name of Entry to be tagged. It takes the form projects/{project}/locations/{location}/entryGroups/{entrygroup}/entries/{entries}.

Request body

The request body contains data with the following structure:

JSON representation
{
  "tagTemplate": string,
  "forceDeleteMissing": boolean,
  "tags": [
    {
      object (Tag)
    }
  ]
}
Fields
tagTemplate

string

Required. The name of the tag template, which is used for reconciliation.

forceDeleteMissing

boolean

If set to true, deletes entry tags related to a tag template not listed in the tags source from an entry. If set to false, unlisted tags are retained.

tags[]

object (Tag)

A list of tags to apply to an entry. A tag can specify a tag template, which must be the template specified in the ReconcileTagsRequest. The sole entry and each of its columns must be mentioned at most once.

Response body

If successful, the response body contains an instance of Operation.

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the Authentication Overview.