Buckets: listChannels

Retrieves a list of active Object Change Notification channels for a bucket, ordered in the list lexicographically by name.

Required permissions

The authenticated user must have the storage.buckets.get IAM permission to use this method.

GET https://storage.googleapis.com/storage/v1/b/ bucket 
/channels

In addition to standard query parameters , the following query parameters apply to this method:

Parameter name

Value

Description

Path parameters

bucket

string

Name of the bucket to list active channels for.

Do not supply a request body with this method.

If successful, this method returns a response body with the following structure:

 { 
  
 "kind" 
 : 
  
 "storage#channels" 
 , 
  
 "items" 
 : 
  
 [ 
  
  cha 
 nnel 
  
 i 
 nf 
 orma 
 t 
 io 
 n 
 
  
 ] 
 }

Property name	Value	Description	Notes
`kind`	`string`	The kind of item this is. For lists of active channels for buckets, this is always `"storage#channels"` .
`items[]`	`list`	The list of channels .

For information about status and error codes returned by this API, see the reference page .