Create logging topic

Create a new Kafka topic within the client’s LaaS namespace for the specified project and region. If a topic with the same name exists, it will be updated.

PUT /cloud/v1/laas/{project_id}/{region_id}/topics

Create logging topic

cURL

curl --request PUT \
  --url https://api.gcore.com/cloud/v1/laas/{project_id}/{region_id}/topics \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "my-topic",
  "index_pattern": {
    "id": "exampletopicindexpatternid"
  },
  "retention_policy": {
    "period": 45
  },
  "size_in_bytes": 0
}
'

201

{
  "index_pattern": {
    "id": "exampletopicindexpatternid"
  },
  "name": "my-topic",
  "retention_policy": {
    "period": 45
  },
  "size_in_bytes": 1
}

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

Path Parameters

project_id · integer · required

Project ID

region_id · integer · required

Region ID

Body

application/json

name · string · required

Kafka topic name to be used in log shipper config to write logs to LaaS

Required string length: 1 - 223

Pattern: ^[a-z0-9](?:[-a-z0-9]*[a-z0-9])?(?:\.[a-z0-9](?:[-a-z0-9]*[a-z0-9])*)*$

Example:

"my-topic"

index_pattern · IndexPatternSerializer · object

Index Pattern data

Show child attributes

Example:

{ "id": "exampletopicindexpatternid" }

retention_policy · LaasIndexRetentionPolicyPydanticSerializer · object

Show child attributes

Example:

{ "period": 45 }

size_in_bytes · integer · default: 0

Size of the topic in bytes

Required range: x >= 0

Response

201

application/json

LaaS Kafka topic

index_pattern · IndexPatternSerializer · object · required

Index Pattern data

Show child attributes

Example:

{ "id": "exampletopicindexpatternid" }

name · string · required

Kafka topic name to be used in log shipper config to write logs to LaaS

Example:

"my-topic"

retention_policy · LaasIndexRetentionPolicyPydanticSerializer · object · required

Show child attributes

Example:

{ "period": 45 }

size_in_bytes · integer · required

Size of the topic in bytes

Required range: x >= 0