Jump to

• Request
• Response

(Preview) Get one deployment log event

get

/20260430/aiDataPlatforms/{aiDataPlatformId}/mlops/api/2.0/model-deployments/{deploymentId}/monitoring/logs/{logId}

(Preview) Returns one deployment log event with its full, redacted message, located by the opaque expiring locator returned from a log search.

Request

Path Parameters

• aiDataPlatformId(required): string
  Minimum Length: 1

  Maximum Length: 500

  The [OCID](/iaas/Content/General/Concepts/identifiers.htm) of the AI Data Platform (Data Lake) instance.
• deploymentId(required): string
  Minimum Length: 32

  Maximum Length: 32

  Pattern: ^[0-9a-f]{32}$

  The unique 32-character hexadecimal ID of the model deployment.
• logId(required): string
  Minimum Length: 1

  Maximum Length: 4096

  The opaque, expiring log locator returned by a deployment log search. It binds the platform, deployment, and source event identity, and grants no permission by itself.

Header Parameters

• opc-request-id: string
  Maximum Length: 255

  Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. The only valid characters for request IDs are letters, numbers, underscore, and dash.

Back to Top

Response

Supported Media Types

• application/json

200 Response

Successful operation. The log event is returned.

Headers

• opc-request-id: string
  Unique Oracle-assigned ID for the request. If you need to contact Oracle about a particular request, please provide the request ID.

Body ()

Root Schema : DeploymentLogDetail

Type: object

One deployment log event with its full message and metadata.

Show Source

• deploymentId(required): string
  Maximum Length: 255

  The model deployment the log event belongs to.
• level(required): string
  Allowed Values: [ "DEBUG", "INFO", "WARNING", "ERROR", "CRITICAL", "UNKNOWN" ]

  Normalized severity. Unrecognized producer values are returned as UNKNOWN.
• logId(required): string
  Maximum Length: 4096

  The opaque, expiring locator this event was resolved from.
• message(required): object DeploymentLogMessage
  The log event's message, subject to redaction and size limits.
• metadata(required): object DeploymentLogMetadata
  Selected metadata of a log event. Every field may be null when the event does not carry it.
• recordId(required): string
  Maximum Length: 128

  Stable identity of the ingested log record.
• timestamp(required): string(date-time)
  Displayed event time (RFC 3339 UTC). Producer event time when available; otherwise the publish time, per timestampSource.
• timestampSource(required): string
  Allowed Values: [ "EVENT_TIME", "PUBLISH_TIME" ]

  EVENT_TIME when the producer timestamp was valid; PUBLISH_TIME when the displayed value fell back to the provider publish time.

{
    "description":"One deployment log event with its full message and metadata.",
    "type":"object",
    "required":[
        "deploymentId",
        "recordId",
        "logId",
        "timestamp",
        "timestampSource",
        "level",
        "message",
        "metadata"
    ],
    "properties":{
        "deploymentId":{
            "description":"The model deployment the log event belongs to.",
            "type":"string",
            "maxLength":255
        },
        "recordId":{
            "description":"Stable identity of the ingested log record.",
            "type":"string",
            "maxLength":128
        },
        "logId":{
            "description":"The opaque, expiring locator this event was resolved from.",
            "type":"string",
            "maxLength":4096
        },
        "timestamp":{
            "description":"Displayed event time (RFC 3339 UTC). Producer event time when available; otherwise the publish time, per timestampSource.",
            "type":"string",
            "format":"date-time"
        },
        "timestampSource":{
            "description":"EVENT_TIME when the producer timestamp was valid; PUBLISH_TIME when the displayed value fell back to the provider publish time.",
            "type":"string",
            "enum":[
                "EVENT_TIME",
                "PUBLISH_TIME"
            ]
        },
        "level":{
            "description":"Normalized severity. Unrecognized producer values are returned as UNKNOWN.",
            "type":"string",
            "enum":[
                "DEBUG",
                "INFO",
                "WARNING",
                "ERROR",
                "CRITICAL",
                "UNKNOWN"
            ]
        },
        "message":{
            "$ref":"#/definitions/DeploymentLogMessage"
        },
        "metadata":{
            "$ref":"#/definitions/DeploymentLogMetadata"
        }
    }
}

Nested Schema : DeploymentLogMessage

Type: object

The log event's message, subject to redaction and size limits.

Show Source

• isTruncated(required): boolean
  Whether the text was truncated to the size limit.
• state(required): string
  Allowed Values: [ "AVAILABLE", "REDACTED", "NOT_AUTHORIZED", "UNKNOWN" ]

  Whether the message text is available. Text is only present for AVAILABLE.
• text: string
  Maximum Length: 65536

  Display text of the log event. Treat as untrusted display data. Null when the state denies or lacks content.

{
    "description":"The log event's message, subject to redaction and size limits.",
    "type":"object",
    "required":[
        "state",
        "isTruncated"
    ],
    "properties":{
        "state":{
            "description":"Whether the message text is available. Text is only present for AVAILABLE.",
            "type":"string",
            "enum":[
                "AVAILABLE",
                "REDACTED",
                "NOT_AUTHORIZED",
                "UNKNOWN"
            ]
        },
        "text":{
            "description":"Display text of the log event. Treat as untrusted display data. Null when the state denies or lacks content.",
            "type":"string",
            "maxLength":65536
        },
        "isTruncated":{
            "description":"Whether the text was truncated to the size limit.",
            "type":"boolean"
        }
    }
}

Nested Schema : DeploymentLogMetadata

Type: object

Selected metadata of a log event. Every field may be null when the event does not carry it.

Show Source

• errorCode: string
  Maximum Length: 255

  Producer error code, when the event carries one.
• opcRequestId: string
  Maximum Length: 1024

  Original request identifier. Absent when the event carries none. Model deployment lifecycle events are not emitted per request and never carry one.
• region: string
  Maximum Length: 64

  Region the event was emitted from, when the event carries one.
• replicaId: string
  Maximum Length: 255

  Emitting replica or source scope, when the event carries one.
• source: string
  Maximum Length: 255

  Logical producer of the event within the deployment runtime.

{
    "description":"Selected metadata of a log event. Every field may be null when the event does not carry it.",
    "type":"object",
    "properties":{
        "replicaId":{
            "description":"Emitting replica or source scope, when the event carries one.",
            "type":"string",
            "maxLength":255
        },
        "opcRequestId":{
            "description":"Original request identifier. Absent when the event carries none. Model deployment lifecycle events are not emitted per request and never carry one.",
            "type":"string",
            "maxLength":1024
        },
        "source":{
            "description":"Logical producer of the event within the deployment runtime.",
            "type":"string",
            "maxLength":255
        },
        "region":{
            "description":"Region the event was emitted from, when the event carries one.",
            "type":"string",
            "maxLength":64
        },
        "errorCode":{
            "description":"Producer error code, when the event carries one.",
            "type":"string",
            "maxLength":255
        }
    }
}

400 Response

Bad Request (invalid query parameters, malformed headers, and so on).

Headers

• opc-request-id: string
  Unique Oracle-assigned ID for the request. If you need to contact Oracle about a particular request, please provide the request ID.

Body ()

Root Schema : Error

Type: object

Error information.

Show Source

• code(required): string
  A short error code that defines the error, meant for programmatic parsing.
• message(required): string
  A human-readable error message.

{
    "description":"Error information.",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "description":"A short error code that defines the error, meant for programmatic parsing.",
            "type":"string"
        },
        "message":{
            "description":"A human-readable error message.",
            "type":"string"
        }
    }
}

401 Response

Unauthorized (missing or expired credentials, and so on).

Headers

• opc-request-id: string
  Unique Oracle-assigned ID for the request. If you need to contact Oracle about a particular request, please provide the request ID.

Body ()

Root Schema : Error

Type: object

Error information.

Show Source

• code(required): string
  A short error code that defines the error, meant for programmatic parsing.
• message(required): string
  A human-readable error message.

{
    "description":"Error information.",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "description":"A short error code that defines the error, meant for programmatic parsing.",
            "type":"string"
        },
        "message":{
            "description":"A human-readable error message.",
            "type":"string"
        }
    }
}

404 Response

Not Found. The requested resource was not found.

Headers

• opc-request-id: string
  Unique Oracle-assigned ID for the request. If you need to contact Oracle about a particular request, please provide the request ID.

Body ()

Root Schema : Error

Type: object

Error information.

Show Source

• code(required): string
  A short error code that defines the error, meant for programmatic parsing.
• message(required): string
  A human-readable error message.

{
    "description":"Error information.",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "description":"A short error code that defines the error, meant for programmatic parsing.",
            "type":"string"
        },
        "message":{
            "description":"A human-readable error message.",
            "type":"string"
        }
    }
}

429 Response

Too Many Requests. Too many requests sent to the server in a short period.

Headers

• opc-request-id: string
  Unique Oracle-assigned ID for the request. If you need to contact Oracle about a particular request, please provide the request ID.

Body ()

Root Schema : Error

Type: object

Error information.

Show Source

• code(required): string
  A short error code that defines the error, meant for programmatic parsing.
• message(required): string
  A human-readable error message.

{
    "description":"Error information.",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "description":"A short error code that defines the error, meant for programmatic parsing.",
            "type":"string"
        },
        "message":{
            "description":"A human-readable error message.",
            "type":"string"
        }
    }
}

500 Response

Internal Server Error. The server encountered an unexpected condition preventing fulfilment of the request.

Headers

• opc-request-id: string
  Unique Oracle-assigned ID for the request. If you need to contact Oracle about a particular request, please provide the request ID.

Body ()

Root Schema : Error

Type: object

Error information.

Show Source

• code(required): string
  A short error code that defines the error, meant for programmatic parsing.
• message(required): string
  A human-readable error message.

{
    "description":"Error information.",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "description":"A short error code that defines the error, meant for programmatic parsing.",
            "type":"string"
        },
        "message":{
            "description":"A human-readable error message.",
            "type":"string"
        }
    }
}

Default Response

Unknown Error. Error is not recognized by the system.

Headers

• opc-request-id: string
  Unique Oracle-assigned ID for the request. If you need to contact Oracle about a particular request, please provide the request ID.

Body ()

Root Schema : Error

Type: object

Error information.

Show Source

• code(required): string
  A short error code that defines the error, meant for programmatic parsing.
• message(required): string
  A human-readable error message.

{
    "description":"Error information.",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "description":"A short error code that defines the error, meant for programmatic parsing.",
            "type":"string"
        },
        "message":{
            "description":"A human-readable error message.",
            "type":"string"
        }
    }
}

Back to Top