Create event

Create a single notification event threshold. Configure alerts for when storage usage, file count, traffic, or requests exceed specified limits for a storage or bucket.

POST /storage/notifications/v1/event

Create event

cURL

curl --request POST \
  --url https://api.gcore.com/storage/notifications/v1/event \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "reaching_used_space, reaching_files_quantity, reaching_used_traffic, reaching_used_requests",
  "bucket_name": "<string>",
  "bytes": 500,
  "count": 5,
  "storage_name": "<string>",
  "uuid": "<string>"
}
'

200

{
  "name": "reaching_used_space, reaching_files_quantity, reaching_used_traffic, reaching_used_requests",
  "bucket_name": "<string>",
  "bytes": 500,
  "count": 5,
  "storage_name": "<string>",
  "uuid": "<string>"
}

Authorizations

Authorization · string · header · required

API key for authentication. Make sure to include the word apikey, followed by a single space and then your token. Example: apikey 1234$abcdef

Query Parameters

client_id · integer<int64>

Client ID

Body

application/json

Event for storage notification

name · string · required

name of type notification

Example:

"reaching_used_space, reaching_files_quantity, reaching_used_traffic, reaching_used_requests"

bucket_name · string

bytes · integer<uint64>

Bytes as limit

Example:

500

count · integer<uint64>

Count as limit

Example:

5

storage_name · string

uuid · string

Response

200

application/json

EventResponse

Event for storage notification

name · string · required

name of type notification

Example:

"reaching_used_space, reaching_files_quantity, reaching_used_traffic, reaching_used_requests"

bucket_name · string

bytes · integer<uint64>

Bytes as limit

Example:

500

count · integer<uint64>

Count as limit

Example:

5

storage_name · string

uuid · string