MCP Tools Reference: bigquerydatatransfer.googleapis.com

Tool: list_transfer_logs

List transfer logs for a transfer run by its resource name.

The following example shows a MCP call to list transfer logs for a transfer run.

list_transfer_logs(parent="projects/myproject/locations/myregion/transferConfigs/mytransferconfig/runs/mytransferrun")

The following sample demonstrate how to use curl to invoke the list_transfer_logs MCP tool.

Curl Request 
                  
curl --location 'https://bigquerydatatransfer.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "list_transfer_logs",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Input Schema

A request to get user facing log messages associated with data transfer run.

ListTransferLogsRequest

JSON representation 
{
  "parent": string,
  "pageToken": string,
  "pageSize": integer,
  "messageTypes": [
    enum (MessageSeverity)
  ]
}
Fields
parent

string

Required. Transfer run name. If you are using the regionless method, the location must be US and the name should be in the following form:

  • projects/{project_id}/transferConfigs/{config_id}/runs/{run_id}

If you are using the regionalized method, the name should be in the following form:

  • projects/{project_id}/locations/{location_id}/transferConfigs/{config_id}/runs/{run_id}
pageToken

string

Pagination token, which can be used to request a specific page of ListTransferLogsRequest list results. For multiple-page results, ListTransferLogsResponse outputs a next_page token, which can be used as the page_token value to request the next page of list results.
pageSize

integer

Page size. The default page size is the maximum value of 1000 results.
messageTypes[]

enum (MessageSeverity)

Message types to return. If not populated - INFO, WARNING and ERROR messages are returned.

MessageSeverity

Represents data transfer user facing message severity.

Enums
MESSAGE_SEVERITY_UNSPECIFIED No severity specified.
INFO Informational message.
WARNING Warning message.
ERROR Error message.

Output Schema

The returned list transfer run messages.

ListTransferLogsResponse

JSON representation 
{
  "transferMessages": [
    {
      object (TransferMessage)
    }
  ],
  "nextPageToken": string
}
Fields
transferMessages[]

object (TransferMessage)

Output only. The stored pipeline transfer messages.
nextPageToken

string

Output only. The next-pagination token. For multiple-page list results, this token can be used as the GetTransferRunLogRequest.page_token to request the next page of list results.

TransferMessage

JSON representation 
{
  "messageTime": string,
  "severity": enum (MessageSeverity),
  "messageText": string
}
Fields
messageTime

string (Timestamp format)

Time when message was logged.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
severity

enum (MessageSeverity)

Message severity.
messageText

string

Message text.

Timestamp

JSON representation 
{
  "seconds": string,
  "nanos": integer
}
Fields
seconds

string (int64 format)

Represents seconds of UTC time since Unix epoch 1970-01-01T00:00:00Z. Must be between -62135596800 and 253402300799 inclusive (which corresponds to 0001-01-01T00:00:00Z to 9999-12-31T23:59:59Z).
nanos

integer

Non-negative fractions of a second at nanosecond resolution. This field is the nanosecond portion of the duration, not an alternative to seconds. Negative second values with fractions must still have non-negative nanos values that count forward in time. Must be between 0 and 999,999,999 inclusive.

MessageSeverity

Represents data transfer user facing message severity.

Enums
MESSAGE_SEVERITY_UNSPECIFIED No severity specified.
INFO Informational message.
WARNING Warning message.
ERROR Error message.

Tool Annotations

Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌