Skip to content

Observability

All operations require authentication.

7 operationsv2/okms/resource
Agent setup

List log kindsBeta

GET
/v2/okms/resource/{okmsId}/log/kind

Returns the names of the log kinds the service emits, which can be forwarded to a stream.

Path parameters

okmsId
required
stringuuid

Okms ID

Headers

X-Pagination-Cursor
string

Pagination cursor

X-Pagination-Size
integer

Pagination size

Response

200LogKind[]successful operation
additionalReturnedFields
read-only
string[]

List of additional log fields managed in this log kind

createdAt
read-only
stringdate-time

Creation date of the log kind

displayName
read-only
string

Log kind display name

kindId
read-only
stringuuid

Identifier of the log kind

name
read-only
string

Log kind name

updatedAt
read-only
stringdate-time

Last update date of the log kind

Example uses okmsId = 00000000-0000-0000-0000-000000000000

$ curl https://api.eu.ovhcloud.com/v2/okms/resource/{okmsId}/log/kind \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
[ { "additionalReturnedFields": [ "string" ], "createdAt": "2024-01-01T12:00:00Z", "displayName": "string", "kindId": "00000000-0000-0000-0000-000000000000", "name": "string", "updatedAt": "2024-01-01T12:00:00Z" }]

Get a log kindBeta

GET
/v2/okms/resource/{okmsId}/log/kind/{name}

Returns a log kind and the additional fields its logs carry.

Path parameters

name
required
string

Name

okmsId
required
stringuuid

Okms ID

Response

200LogKindsuccessful operation
additionalReturnedFields
read-only
string[]

List of additional log fields managed in this log kind

createdAt
read-only
stringdate-time

Creation date of the log kind

displayName
read-only
string

Log kind display name

kindId
read-only
stringuuid

Identifier of the log kind

name
read-only
string

Log kind name

updatedAt
read-only
stringdate-time

Last update date of the log kind

Example uses name = string, okmsId = 00000000-0000-0000-0000-000000000000

$ curl https://api.eu.ovhcloud.com/v2/okms/resource/{okmsId}/log/kind/{name} \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "additionalReturnedFields": [ "string" ], "createdAt": "2024-01-01T12:00:00Z", "displayName": "string", "kindId": "00000000-0000-0000-0000-000000000000", "name": "string", "updatedAt": "2024-01-01T12:00:00Z"}

List log subscriptionsBeta

GET
/v2/okms/resource/{okmsId}/log/subscription

Returns the identifiers of the log subscriptions of the service. Filter them by log kind with the kind parameter.

Path parameters

okmsId
required
stringuuid

Okms ID

Query parameters

kind
string

Filter on a specific kind, for example audit

Headers

X-Pagination-Cursor
string

Pagination cursor

X-Pagination-Size
integer

Pagination size

Response

200LogSubscription[]successful operation
createdAt
read-only
stringdate-time

Creation date of the subscription

kind
read-only
string

Log kind name of this subscription

resource
read-only
LogSubscriptionResource

Subscribed resource, where the logs come from

serviceName
read-only
string

Name of the destination log service

streamId
read-only
string

Identifier of the destination log stream

subscriptionId
read-only
stringuuid

Unique identifier of the subscription, used to change or stop the forwarding

updatedAt
read-only
stringdate-time

Last update date of the subscription

Example uses okmsId = 00000000-0000-0000-0000-000000000000

$ curl https://api.eu.ovhcloud.com/v2/okms/resource/{okmsId}/log/subscription \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
[ { "createdAt": "2024-01-01T12:00:00Z", "kind": "string", "resource": { "name": "string", "type": "string" }, "serviceName": "string", "streamId": "string", "subscriptionId": "00000000-0000-0000-0000-000000000000", "updatedAt": "2024-01-01T12:00:00Z" }]

Create a log subscriptionBeta

POST
/v2/okms/resource/{okmsId}/log/subscription

Forwards the logs of one kind to a Logs Data Platform stream. The subscription is created asynchronously and the response returns the operation identifier.

Path parameters

okmsId
required
stringuuid

Okms ID

Request body (required)

kind
required
string

Log kind name to subscribe to

streamId
required
stringuuid

Identifier of the customer log stream

Response

200LogSubscriptionResponsesuccessful operation
operationId
read-only
stringuuid

Identifier of the operation

serviceName
read-only
string

Operation owner's service name

Example uses okmsId = 00000000-0000-0000-0000-000000000000

$ curl https://api.eu.ovhcloud.com/v2/okms/resource/{okmsId}/log/subscription \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "operationId": "00000000-0000-0000-0000-000000000000", "serviceName": "string"}

Get a log subscriptionBeta

GET
/v2/okms/resource/{okmsId}/log/subscription/{subscriptionId}

Returns the log kind and the destination stream of a subscription.

Path parameters

okmsId
required
stringuuid

Okms ID

subscriptionId
required
stringuuid

Subscription ID

Response

200LogSubscriptionsuccessful operation
createdAt
read-only
stringdate-time

Creation date of the subscription

kind
read-only
string

Log kind name of this subscription

resource
read-only
LogSubscriptionResource

Subscribed resource, where the logs come from

serviceName
read-only
string

Name of the destination log service

streamId
read-only
string

Identifier of the destination log stream

subscriptionId
read-only
stringuuid

Unique identifier of the subscription, used to change or stop the forwarding

updatedAt
read-only
stringdate-time

Last update date of the subscription

Example uses okmsId = 00000000-0000-0000-0000-000000000000, subscriptionId = 00000000-0000-0000-0000-000000000000

$ curl https://api.eu.ovhcloud.com/v2/okms/resource/{okmsId}/log/subscription/{subscriptionId} \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "createdAt": "2024-01-01T12:00:00Z", "kind": "string", "resource": { "name": "string", "type": "string" }, "serviceName": "string", "streamId": "string", "subscriptionId": "00000000-0000-0000-0000-000000000000", "updatedAt": "2024-01-01T12:00:00Z"}

Delete a log subscriptionBeta

DELETE
/v2/okms/resource/{okmsId}/log/subscription/{subscriptionId}

Deletes the subscription and stops forwarding logs to the stream. The deletion runs asynchronously and the response returns the operation identifier.

Path parameters

okmsId
required
stringuuid

Okms ID

subscriptionId
required
stringuuid

Subscription ID

Response

200LogSubscriptionResponsesuccessful operation
operationId
read-only
stringuuid

Identifier of the operation

serviceName
read-only
string

Operation owner's service name

Example uses okmsId = 00000000-0000-0000-0000-000000000000, subscriptionId = 00000000-0000-0000-0000-000000000000

$ curl https://api.eu.ovhcloud.com/v2/okms/resource/{okmsId}/log/subscription/{subscriptionId} \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "operationId": "00000000-0000-0000-0000-000000000000", "serviceName": "string"}

Generate a temporary log URLBeta

POST
/v2/okms/resource/{okmsId}/log/url

Returns a temporary signed URL for read-only access to the logs of the given kind. The link expires.

Path parameters

okmsId
required
stringuuid

Okms ID

Request body (required)

kind
required
string

Log kind name

Response

200TemporaryLogsLinksuccessful operation
expirationDate
read-only
stringdate-time

Temporary url expiration date

url
read-only
string

Temporary url

Example uses okmsId = 00000000-0000-0000-0000-000000000000

$ curl https://api.eu.ovhcloud.com/v2/okms/resource/{okmsId}/log/url \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "expirationDate": "2024-01-01T12:00:00Z", "url": "string"}