Method: folders.locations.buckets.patch

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

Updates a log bucket.

If the bucket has a lifecycleState of DELETE_REQUESTED , then FAILED_PRECONDITION will be returned.

After a bucket has been created, the bucket's location cannot be changed.

HTTP request

PATCH https://logging.googleapis.com/v2/{name=folders/*/locations/*/buckets/*}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters

name

string

Required. The full resource name of the bucket to update.

 "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
"organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
"billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
"folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"

For example:

"projects/my-project/locations/global/buckets/my-bucket"

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

logging.buckets.update

Query parameters

Parameters

Parameters
`updateMask`	`string ( FieldMask format)` Required. Field mask that specifies the fields in `bucket` that need an update. A bucket field will be overwritten if, and only if, it is in the update mask. `name` and output only fields cannot be updated. For a detailed `FieldMask` definition, see: https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMask For example: `updateMask=retentionDays` 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 bucket that need an update. A bucket field will be overwritten if, and only if, it is in the update mask. name and output only fields cannot be updated.

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

For example: updateMask=retentionDays

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 LogBucket .

Response body

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

Authorization scopes

Requires one of the following OAuth scopes:

https://www.googleapis.com/auth/logging.admin
https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview .