Method: projects.traceSinks.patch

HTTP request
Path parameters
Query parameters
Request body
Response body
Authorization scopes
Try it!

Updates a sink. This method updates fields in the existing sink according to the provided update mask. The sink's name cannot be changed nor any output-only fields (e.g. the writerIdentity).

HTTP request

PATCH https://cloudtrace.googleapis.com/v2beta1/{name=projects/*/traceSinks/*}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters

name

string

Required. The full resource name of the sink to update, including the parent resource and the sink identifier:

 "projects/[PROJECT_NUMBER]/traceSinks/[SINK_ID]"

Example: "projects/12345/traceSinks/my-sink-id" .

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

cloudtrace.tracesinks.update

Query parameters

Parameters

Parameters
`updateMask`	`string ( FieldMask format)` Required. Field mask that specifies the fields in `traceSink` that are to be updated. A sink field is overwritten if, and only if, it is in the update mask. `name` and `writerIdentity` fields cannot be updated. An empty `updateMask` is considered an error. For a detailed `FieldMask` definition, see https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask Example: `updateMask=outputConfig` . This is a comma-separated list of fully qualified names of fields. Example: `"user.displayName,photo"` .

updateMask

string ( FieldMask format)

Required. Field mask that specifies the fields in traceSink that are to be updated. A sink field is overwritten if, and only if, it is in the update mask. name and writerIdentity fields cannot be updated.

An empty updateMask is considered an error.

For a detailed FieldMask definition, see https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask

Example: updateMask=outputConfig .

This is a comma-separated list of fully qualified names of fields. Example: "user.displayName,photo" .

Request body

The request body contains an instance of TraceSink .

Response body

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

Authorization scopes

Requires one of the following OAuth scopes:

https://www.googleapis.com/auth/trace.append
https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview .