# Connectors ## List Connectors `magic_transit.connectors.list(ConnectorListParams**kwargs) -> SyncSinglePage[ConnectorListResponse]` **get** `/accounts/{account_id}/magic/connectors` List Connectors ### Parameters - `account_id: str` Account identifier ### Returns - `class ConnectorListResponse: …` - `id: str` - `activated: bool` - `interrupt_window_days_of_week: List[Literal["Sunday", "Monday", "Tuesday", 4 more]]` Allowed days of the week for upgrades. Default is all days. - `"Sunday"` - `"Monday"` - `"Tuesday"` - `"Wednesday"` - `"Thursday"` - `"Friday"` - `"Saturday"` - `interrupt_window_duration_hours: float` - `interrupt_window_embargo_dates: List[str]` List of dates (YYYY-MM-DD) when upgrades are blocked. - `interrupt_window_hour_of_day: float` - `last_updated: str` - `notes: str` - `timezone: str` - `device: Optional[Device]` - `id: str` - `serial_number: Optional[str]` - `last_heartbeat: Optional[str]` - `last_seen_version: Optional[str]` - `license_key: Optional[str]` ### Example ```python import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) page = client.magic_transit.connectors.list( account_id="023e105f4ecef8ad9ca31a8372d0c353", ) page = page.result[0] print(page.id) ``` #### Response ```json { "errors": [ { "code": 0, "message": "message" } ], "messages": [ { "code": 0, "message": "message" } ], "result": [ { "id": "id", "activated": true, "interrupt_window_days_of_week": [ "Sunday" ], "interrupt_window_duration_hours": 1, "interrupt_window_embargo_dates": [ "string" ], "interrupt_window_hour_of_day": 0, "last_updated": "last_updated", "notes": "notes", "timezone": "timezone", "device": { "id": "id", "serial_number": "serial_number" }, "last_heartbeat": "last_heartbeat", "last_seen_version": "last_seen_version", "license_key": "license_key" } ], "success": true } ``` ## Fetch Connector `magic_transit.connectors.get(strconnector_id, ConnectorGetParams**kwargs) -> ConnectorGetResponse` **get** `/accounts/{account_id}/magic/connectors/{connector_id}` Fetch Connector ### Parameters - `account_id: str` Account identifier - `connector_id: str` ### Returns - `class ConnectorGetResponse: …` - `id: str` - `activated: bool` - `interrupt_window_days_of_week: List[Literal["Sunday", "Monday", "Tuesday", 4 more]]` Allowed days of the week for upgrades. Default is all days. - `"Sunday"` - `"Monday"` - `"Tuesday"` - `"Wednesday"` - `"Thursday"` - `"Friday"` - `"Saturday"` - `interrupt_window_duration_hours: float` - `interrupt_window_embargo_dates: List[str]` List of dates (YYYY-MM-DD) when upgrades are blocked. - `interrupt_window_hour_of_day: float` - `last_updated: str` - `notes: str` - `timezone: str` - `device: Optional[Device]` - `id: str` - `serial_number: Optional[str]` - `last_heartbeat: Optional[str]` - `last_seen_version: Optional[str]` - `license_key: Optional[str]` ### Example ```python import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) connector = client.magic_transit.connectors.get( connector_id="connector_id", account_id="023e105f4ecef8ad9ca31a8372d0c353", ) print(connector.id) ``` #### Response ```json { "errors": [ { "code": 0, "message": "message" } ], "messages": [ { "code": 0, "message": "message" } ], "result": { "id": "id", "activated": true, "interrupt_window_days_of_week": [ "Sunday" ], "interrupt_window_duration_hours": 1, "interrupt_window_embargo_dates": [ "string" ], "interrupt_window_hour_of_day": 0, "last_updated": "last_updated", "notes": "notes", "timezone": "timezone", "device": { "id": "id", "serial_number": "serial_number" }, "last_heartbeat": "last_heartbeat", "last_seen_version": "last_seen_version", "license_key": "license_key" }, "success": true } ``` ## Add a connector to your account `magic_transit.connectors.create(ConnectorCreateParams**kwargs) -> ConnectorCreateResponse` **post** `/accounts/{account_id}/magic/connectors` Add a connector to your account ### Parameters - `account_id: str` Account identifier - `device: Device` Exactly one of id, serial_number, or provision_license must be provided. - `id: Optional[str]` - `provision_license: Optional[bool]` When true, create and provision a new licence key for the connector. - `serial_number: Optional[str]` - `activated: Optional[bool]` - `interrupt_window_days_of_week: Optional[List[Literal["Sunday", "Monday", "Tuesday", 4 more]]]` Allowed days of the week for upgrades. Default is all days. - `"Sunday"` - `"Monday"` - `"Tuesday"` - `"Wednesday"` - `"Thursday"` - `"Friday"` - `"Saturday"` - `interrupt_window_duration_hours: Optional[float]` - `interrupt_window_embargo_dates: Optional[SequenceNotStr[str]]` List of dates (YYYY-MM-DD) when upgrades are blocked. - `interrupt_window_hour_of_day: Optional[float]` - `notes: Optional[str]` - `timezone: Optional[str]` ### Returns - `class ConnectorCreateResponse: …` - `id: str` - `activated: bool` - `interrupt_window_days_of_week: List[Literal["Sunday", "Monday", "Tuesday", 4 more]]` Allowed days of the week for upgrades. Default is all days. - `"Sunday"` - `"Monday"` - `"Tuesday"` - `"Wednesday"` - `"Thursday"` - `"Friday"` - `"Saturday"` - `interrupt_window_duration_hours: float` - `interrupt_window_embargo_dates: List[str]` List of dates (YYYY-MM-DD) when upgrades are blocked. - `interrupt_window_hour_of_day: float` - `last_updated: str` - `notes: str` - `timezone: str` - `device: Optional[Device]` - `id: str` - `serial_number: Optional[str]` - `last_heartbeat: Optional[str]` - `last_seen_version: Optional[str]` - `license_key: Optional[str]` ### Example ```python import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) connector = client.magic_transit.connectors.create( account_id="023e105f4ecef8ad9ca31a8372d0c353", device={}, ) print(connector.id) ``` #### Response ```json { "errors": [ { "code": 0, "message": "message" } ], "messages": [ { "code": 0, "message": "message" } ], "result": { "id": "id", "activated": true, "interrupt_window_days_of_week": [ "Sunday" ], "interrupt_window_duration_hours": 1, "interrupt_window_embargo_dates": [ "string" ], "interrupt_window_hour_of_day": 0, "last_updated": "last_updated", "notes": "notes", "timezone": "timezone", "device": { "id": "id", "serial_number": "serial_number" }, "last_heartbeat": "last_heartbeat", "last_seen_version": "last_seen_version", "license_key": "license_key" }, "success": true } ``` ## Replace Connector or Re-provision License Key `magic_transit.connectors.update(strconnector_id, ConnectorUpdateParams**kwargs) -> ConnectorUpdateResponse` **put** `/accounts/{account_id}/magic/connectors/{connector_id}` Replace Connector or Re-provision License Key ### Parameters - `account_id: str` Account identifier - `connector_id: str` - `activated: Optional[bool]` - `interrupt_window_days_of_week: Optional[List[Literal["Sunday", "Monday", "Tuesday", 4 more]]]` Allowed days of the week for upgrades. Default is all days. - `"Sunday"` - `"Monday"` - `"Tuesday"` - `"Wednesday"` - `"Thursday"` - `"Friday"` - `"Saturday"` - `interrupt_window_duration_hours: Optional[float]` - `interrupt_window_embargo_dates: Optional[SequenceNotStr[str]]` List of dates (YYYY-MM-DD) when upgrades are blocked. - `interrupt_window_hour_of_day: Optional[float]` - `notes: Optional[str]` - `provision_license: Optional[bool]` When true, regenerate license key for the connector. - `timezone: Optional[str]` ### Returns - `class ConnectorUpdateResponse: …` - `id: str` - `activated: bool` - `interrupt_window_days_of_week: List[Literal["Sunday", "Monday", "Tuesday", 4 more]]` Allowed days of the week for upgrades. Default is all days. - `"Sunday"` - `"Monday"` - `"Tuesday"` - `"Wednesday"` - `"Thursday"` - `"Friday"` - `"Saturday"` - `interrupt_window_duration_hours: float` - `interrupt_window_embargo_dates: List[str]` List of dates (YYYY-MM-DD) when upgrades are blocked. - `interrupt_window_hour_of_day: float` - `last_updated: str` - `notes: str` - `timezone: str` - `device: Optional[Device]` - `id: str` - `serial_number: Optional[str]` - `last_heartbeat: Optional[str]` - `last_seen_version: Optional[str]` - `license_key: Optional[str]` ### Example ```python import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) connector = client.magic_transit.connectors.update( connector_id="connector_id", account_id="023e105f4ecef8ad9ca31a8372d0c353", ) print(connector.id) ``` #### Response ```json { "errors": [ { "code": 0, "message": "message" } ], "messages": [ { "code": 0, "message": "message" } ], "result": { "id": "id", "activated": true, "interrupt_window_days_of_week": [ "Sunday" ], "interrupt_window_duration_hours": 1, "interrupt_window_embargo_dates": [ "string" ], "interrupt_window_hour_of_day": 0, "last_updated": "last_updated", "notes": "notes", "timezone": "timezone", "device": { "id": "id", "serial_number": "serial_number" }, "last_heartbeat": "last_heartbeat", "last_seen_version": "last_seen_version", "license_key": "license_key" }, "success": true } ``` ## Edit Connector to update specific properties or Re-provision License Key `magic_transit.connectors.edit(strconnector_id, ConnectorEditParams**kwargs) -> ConnectorEditResponse` **patch** `/accounts/{account_id}/magic/connectors/{connector_id}` Edit Connector to update specific properties or Re-provision License Key ### Parameters - `account_id: str` Account identifier - `connector_id: str` - `activated: Optional[bool]` - `interrupt_window_days_of_week: Optional[List[Literal["Sunday", "Monday", "Tuesday", 4 more]]]` Allowed days of the week for upgrades. Default is all days. - `"Sunday"` - `"Monday"` - `"Tuesday"` - `"Wednesday"` - `"Thursday"` - `"Friday"` - `"Saturday"` - `interrupt_window_duration_hours: Optional[float]` - `interrupt_window_embargo_dates: Optional[SequenceNotStr[str]]` List of dates (YYYY-MM-DD) when upgrades are blocked. - `interrupt_window_hour_of_day: Optional[float]` - `notes: Optional[str]` - `provision_license: Optional[bool]` When true, regenerate license key for the connector. - `timezone: Optional[str]` ### Returns - `class ConnectorEditResponse: …` - `id: str` - `activated: bool` - `interrupt_window_days_of_week: List[Literal["Sunday", "Monday", "Tuesday", 4 more]]` Allowed days of the week for upgrades. Default is all days. - `"Sunday"` - `"Monday"` - `"Tuesday"` - `"Wednesday"` - `"Thursday"` - `"Friday"` - `"Saturday"` - `interrupt_window_duration_hours: float` - `interrupt_window_embargo_dates: List[str]` List of dates (YYYY-MM-DD) when upgrades are blocked. - `interrupt_window_hour_of_day: float` - `last_updated: str` - `notes: str` - `timezone: str` - `device: Optional[Device]` - `id: str` - `serial_number: Optional[str]` - `last_heartbeat: Optional[str]` - `last_seen_version: Optional[str]` - `license_key: Optional[str]` ### Example ```python import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) response = client.magic_transit.connectors.edit( connector_id="connector_id", account_id="023e105f4ecef8ad9ca31a8372d0c353", ) print(response.id) ``` #### Response ```json { "errors": [ { "code": 0, "message": "message" } ], "messages": [ { "code": 0, "message": "message" } ], "result": { "id": "id", "activated": true, "interrupt_window_days_of_week": [ "Sunday" ], "interrupt_window_duration_hours": 1, "interrupt_window_embargo_dates": [ "string" ], "interrupt_window_hour_of_day": 0, "last_updated": "last_updated", "notes": "notes", "timezone": "timezone", "device": { "id": "id", "serial_number": "serial_number" }, "last_heartbeat": "last_heartbeat", "last_seen_version": "last_seen_version", "license_key": "license_key" }, "success": true } ``` ## Remove a connector from your account `magic_transit.connectors.delete(strconnector_id, ConnectorDeleteParams**kwargs) -> ConnectorDeleteResponse` **delete** `/accounts/{account_id}/magic/connectors/{connector_id}` Remove a connector from your account ### Parameters - `account_id: str` Account identifier - `connector_id: str` ### Returns - `class ConnectorDeleteResponse: …` - `id: str` - `activated: bool` - `interrupt_window_days_of_week: List[Literal["Sunday", "Monday", "Tuesday", 4 more]]` Allowed days of the week for upgrades. Default is all days. - `"Sunday"` - `"Monday"` - `"Tuesday"` - `"Wednesday"` - `"Thursday"` - `"Friday"` - `"Saturday"` - `interrupt_window_duration_hours: float` - `interrupt_window_embargo_dates: List[str]` List of dates (YYYY-MM-DD) when upgrades are blocked. - `interrupt_window_hour_of_day: float` - `last_updated: str` - `notes: str` - `timezone: str` - `device: Optional[Device]` - `id: str` - `serial_number: Optional[str]` - `last_heartbeat: Optional[str]` - `last_seen_version: Optional[str]` - `license_key: Optional[str]` ### Example ```python import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) connector = client.magic_transit.connectors.delete( connector_id="connector_id", account_id="023e105f4ecef8ad9ca31a8372d0c353", ) print(connector.id) ``` #### Response ```json { "errors": [ { "code": 0, "message": "message" } ], "messages": [ { "code": 0, "message": "message" } ], "result": { "id": "id", "activated": true, "interrupt_window_days_of_week": [ "Sunday" ], "interrupt_window_duration_hours": 1, "interrupt_window_embargo_dates": [ "string" ], "interrupt_window_hour_of_day": 0, "last_updated": "last_updated", "notes": "notes", "timezone": "timezone", "device": { "id": "id", "serial_number": "serial_number" }, "last_heartbeat": "last_heartbeat", "last_seen_version": "last_seen_version", "license_key": "license_key" }, "success": true } ``` ## Domain Types ### Connector List Response - `class ConnectorListResponse: …` - `id: str` - `activated: bool` - `interrupt_window_days_of_week: List[Literal["Sunday", "Monday", "Tuesday", 4 more]]` Allowed days of the week for upgrades. Default is all days. - `"Sunday"` - `"Monday"` - `"Tuesday"` - `"Wednesday"` - `"Thursday"` - `"Friday"` - `"Saturday"` - `interrupt_window_duration_hours: float` - `interrupt_window_embargo_dates: List[str]` List of dates (YYYY-MM-DD) when upgrades are blocked. - `interrupt_window_hour_of_day: float` - `last_updated: str` - `notes: str` - `timezone: str` - `device: Optional[Device]` - `id: str` - `serial_number: Optional[str]` - `last_heartbeat: Optional[str]` - `last_seen_version: Optional[str]` - `license_key: Optional[str]` ### Connector Get Response - `class ConnectorGetResponse: …` - `id: str` - `activated: bool` - `interrupt_window_days_of_week: List[Literal["Sunday", "Monday", "Tuesday", 4 more]]` Allowed days of the week for upgrades. Default is all days. - `"Sunday"` - `"Monday"` - `"Tuesday"` - `"Wednesday"` - `"Thursday"` - `"Friday"` - `"Saturday"` - `interrupt_window_duration_hours: float` - `interrupt_window_embargo_dates: List[str]` List of dates (YYYY-MM-DD) when upgrades are blocked. - `interrupt_window_hour_of_day: float` - `last_updated: str` - `notes: str` - `timezone: str` - `device: Optional[Device]` - `id: str` - `serial_number: Optional[str]` - `last_heartbeat: Optional[str]` - `last_seen_version: Optional[str]` - `license_key: Optional[str]` ### Connector Create Response - `class ConnectorCreateResponse: …` - `id: str` - `activated: bool` - `interrupt_window_days_of_week: List[Literal["Sunday", "Monday", "Tuesday", 4 more]]` Allowed days of the week for upgrades. Default is all days. - `"Sunday"` - `"Monday"` - `"Tuesday"` - `"Wednesday"` - `"Thursday"` - `"Friday"` - `"Saturday"` - `interrupt_window_duration_hours: float` - `interrupt_window_embargo_dates: List[str]` List of dates (YYYY-MM-DD) when upgrades are blocked. - `interrupt_window_hour_of_day: float` - `last_updated: str` - `notes: str` - `timezone: str` - `device: Optional[Device]` - `id: str` - `serial_number: Optional[str]` - `last_heartbeat: Optional[str]` - `last_seen_version: Optional[str]` - `license_key: Optional[str]` ### Connector Update Response - `class ConnectorUpdateResponse: …` - `id: str` - `activated: bool` - `interrupt_window_days_of_week: List[Literal["Sunday", "Monday", "Tuesday", 4 more]]` Allowed days of the week for upgrades. Default is all days. - `"Sunday"` - `"Monday"` - `"Tuesday"` - `"Wednesday"` - `"Thursday"` - `"Friday"` - `"Saturday"` - `interrupt_window_duration_hours: float` - `interrupt_window_embargo_dates: List[str]` List of dates (YYYY-MM-DD) when upgrades are blocked. - `interrupt_window_hour_of_day: float` - `last_updated: str` - `notes: str` - `timezone: str` - `device: Optional[Device]` - `id: str` - `serial_number: Optional[str]` - `last_heartbeat: Optional[str]` - `last_seen_version: Optional[str]` - `license_key: Optional[str]` ### Connector Edit Response - `class ConnectorEditResponse: …` - `id: str` - `activated: bool` - `interrupt_window_days_of_week: List[Literal["Sunday", "Monday", "Tuesday", 4 more]]` Allowed days of the week for upgrades. Default is all days. - `"Sunday"` - `"Monday"` - `"Tuesday"` - `"Wednesday"` - `"Thursday"` - `"Friday"` - `"Saturday"` - `interrupt_window_duration_hours: float` - `interrupt_window_embargo_dates: List[str]` List of dates (YYYY-MM-DD) when upgrades are blocked. - `interrupt_window_hour_of_day: float` - `last_updated: str` - `notes: str` - `timezone: str` - `device: Optional[Device]` - `id: str` - `serial_number: Optional[str]` - `last_heartbeat: Optional[str]` - `last_seen_version: Optional[str]` - `license_key: Optional[str]` ### Connector Delete Response - `class ConnectorDeleteResponse: …` - `id: str` - `activated: bool` - `interrupt_window_days_of_week: List[Literal["Sunday", "Monday", "Tuesday", 4 more]]` Allowed days of the week for upgrades. Default is all days. - `"Sunday"` - `"Monday"` - `"Tuesday"` - `"Wednesday"` - `"Thursday"` - `"Friday"` - `"Saturday"` - `interrupt_window_duration_hours: float` - `interrupt_window_embargo_dates: List[str]` List of dates (YYYY-MM-DD) when upgrades are blocked. - `interrupt_window_hour_of_day: float` - `last_updated: str` - `notes: str` - `timezone: str` - `device: Optional[Device]` - `id: str` - `serial_number: Optional[str]` - `last_heartbeat: Optional[str]` - `last_seen_version: Optional[str]` - `license_key: Optional[str]` # Events ## List Events `magic_transit.connectors.events.list(strconnector_id, EventListParams**kwargs) -> EventListResponse` **get** `/accounts/{account_id}/magic/connectors/{connector_id}/telemetry/events` List Events ### Parameters - `account_id: str` Account identifier - `connector_id: str` - `from_: float` - `to: float` - `cursor: Optional[str]` - `k: Optional[str]` Filter by event kind - `limit: Optional[float]` ### Returns - `class EventListResponse: …` - `count: float` - `items: List[Item]` - `a: float` Time the Event was collected (seconds since the Unix epoch) - `k: str` Kind - `n: float` Sequence number, used to order events with the same timestamp - `t: float` Time the Event was recorded (seconds since the Unix epoch) - `cursor: Optional[str]` ### Example ```python import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) events = client.magic_transit.connectors.events.list( connector_id="connector_id", account_id="023e105f4ecef8ad9ca31a8372d0c353", from_=0, to=0, ) print(events.count) ``` #### Response ```json { "result": { "count": 0, "items": [ { "a": 0, "k": "k", "n": 0, "t": 0 } ], "cursor": "cursor" }, "success": true, "errors": [ { "code": 0, "message": "message" } ], "messages": [ { "code": 0, "message": "message" } ] } ``` ## Get Event `magic_transit.connectors.events.get(floatevent_n, EventGetParams**kwargs) -> EventGetResponse` **get** `/accounts/{account_id}/magic/connectors/{connector_id}/telemetry/events/{event_t}.{event_n}` Get Event ### Parameters - `account_id: str` Account identifier - `connector_id: str` - `event_t: float` - `event_n: float` ### Returns - `class EventGetResponse: …` Recorded Event - `e: E` - `class EInit: …` - `k: Literal["Init"]` Initialized process - `"Init"` - `class ELeave: …` - `k: Literal["Leave"]` Stopped process - `"Leave"` - `class EStartAttestation: …` - `k: Literal["StartAttestation"]` Started attestation - `"StartAttestation"` - `class EFinishAttestationSuccess: …` - `k: Literal["FinishAttestationSuccess"]` Finished attestation - `"FinishAttestationSuccess"` - `class EFinishAttestationFailure: …` - `k: Literal["FinishAttestationFailure"]` Failed attestation - `"FinishAttestationFailure"` - `class EStartRotateCryptKey: …` - `k: Literal["StartRotateCryptKey"]` Started crypt key rotation - `"StartRotateCryptKey"` - `class EFinishRotateCryptKeySuccess: …` - `k: Literal["FinishRotateCryptKeySuccess"]` Finished crypt key rotation - `"FinishRotateCryptKeySuccess"` - `class EFinishRotateCryptKeyFailure: …` - `k: Literal["FinishRotateCryptKeyFailure"]` Failed crypt key rotation - `"FinishRotateCryptKeyFailure"` - `class EStartRotatePki: …` - `k: Literal["StartRotatePki"]` Started PKI rotation - `"StartRotatePki"` - `class EFinishRotatePkiSuccess: …` - `k: Literal["FinishRotatePkiSuccess"]` Finished PKI rotation - `"FinishRotatePkiSuccess"` - `class EFinishRotatePkiFailure: …` - `k: Literal["FinishRotatePkiFailure"]` Failed PKI rotation - `"FinishRotatePkiFailure"` - `class EStartUpgrade: …` - `k: Literal["StartUpgrade"]` Started upgrade - `"StartUpgrade"` - `url: str` Location of upgrade bundle - `class EFinishUpgradeSuccess: …` - `k: Literal["FinishUpgradeSuccess"]` Finished upgrade - `"FinishUpgradeSuccess"` - `class EFinishUpgradeFailure: …` - `k: Literal["FinishUpgradeFailure"]` Failed upgrade - `"FinishUpgradeFailure"` - `class EReconcile: …` - `k: Literal["Reconcile"]` Reconciled - `"Reconcile"` - `class EConfigureCloudflaredTunnel: …` - `k: Literal["ConfigureCloudflaredTunnel"]` Configured Cloudflared tunnel - `"ConfigureCloudflaredTunnel"` - `n: float` Sequence number, used to order events with the same timestamp - `t: float` Time the Event was recorded (seconds since the Unix epoch) - `v: Optional[str]` Version ### Example ```python import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) event = client.magic_transit.connectors.events.get( event_n=0, account_id="023e105f4ecef8ad9ca31a8372d0c353", connector_id="connector_id", event_t=0, ) print(event.e) ``` #### Response ```json { "result": { "e": { "k": "Init" }, "n": 0, "t": 0, "v": "v" }, "success": true, "errors": [ { "code": 0, "message": "message" } ], "messages": [ { "code": 0, "message": "message" } ] } ``` ## Domain Types ### Event List Response - `class EventListResponse: …` - `count: float` - `items: List[Item]` - `a: float` Time the Event was collected (seconds since the Unix epoch) - `k: str` Kind - `n: float` Sequence number, used to order events with the same timestamp - `t: float` Time the Event was recorded (seconds since the Unix epoch) - `cursor: Optional[str]` ### Event Get Response - `class EventGetResponse: …` Recorded Event - `e: E` - `class EInit: …` - `k: Literal["Init"]` Initialized process - `"Init"` - `class ELeave: …` - `k: Literal["Leave"]` Stopped process - `"Leave"` - `class EStartAttestation: …` - `k: Literal["StartAttestation"]` Started attestation - `"StartAttestation"` - `class EFinishAttestationSuccess: …` - `k: Literal["FinishAttestationSuccess"]` Finished attestation - `"FinishAttestationSuccess"` - `class EFinishAttestationFailure: …` - `k: Literal["FinishAttestationFailure"]` Failed attestation - `"FinishAttestationFailure"` - `class EStartRotateCryptKey: …` - `k: Literal["StartRotateCryptKey"]` Started crypt key rotation - `"StartRotateCryptKey"` - `class EFinishRotateCryptKeySuccess: …` - `k: Literal["FinishRotateCryptKeySuccess"]` Finished crypt key rotation - `"FinishRotateCryptKeySuccess"` - `class EFinishRotateCryptKeyFailure: …` - `k: Literal["FinishRotateCryptKeyFailure"]` Failed crypt key rotation - `"FinishRotateCryptKeyFailure"` - `class EStartRotatePki: …` - `k: Literal["StartRotatePki"]` Started PKI rotation - `"StartRotatePki"` - `class EFinishRotatePkiSuccess: …` - `k: Literal["FinishRotatePkiSuccess"]` Finished PKI rotation - `"FinishRotatePkiSuccess"` - `class EFinishRotatePkiFailure: …` - `k: Literal["FinishRotatePkiFailure"]` Failed PKI rotation - `"FinishRotatePkiFailure"` - `class EStartUpgrade: …` - `k: Literal["StartUpgrade"]` Started upgrade - `"StartUpgrade"` - `url: str` Location of upgrade bundle - `class EFinishUpgradeSuccess: …` - `k: Literal["FinishUpgradeSuccess"]` Finished upgrade - `"FinishUpgradeSuccess"` - `class EFinishUpgradeFailure: …` - `k: Literal["FinishUpgradeFailure"]` Failed upgrade - `"FinishUpgradeFailure"` - `class EReconcile: …` - `k: Literal["Reconcile"]` Reconciled - `"Reconcile"` - `class EConfigureCloudflaredTunnel: …` - `k: Literal["ConfigureCloudflaredTunnel"]` Configured Cloudflared tunnel - `"ConfigureCloudflaredTunnel"` - `n: float` Sequence number, used to order events with the same timestamp - `t: float` Time the Event was recorded (seconds since the Unix epoch) - `v: Optional[str]` Version # Latest ## Get latest Events `magic_transit.connectors.events.latest.list(strconnector_id, LatestListParams**kwargs) -> LatestListResponse` **get** `/accounts/{account_id}/magic/connectors/{connector_id}/telemetry/events/latest` Get latest Events ### Parameters - `account_id: str` Account identifier - `connector_id: str` ### Returns - `class LatestListResponse: …` - `count: float` - `items: List[Item]` - `e: ItemE` - `class ItemEInit: …` - `k: Literal["Init"]` Initialized process - `"Init"` - `class ItemELeave: …` - `k: Literal["Leave"]` Stopped process - `"Leave"` - `class ItemEStartAttestation: …` - `k: Literal["StartAttestation"]` Started attestation - `"StartAttestation"` - `class ItemEFinishAttestationSuccess: …` - `k: Literal["FinishAttestationSuccess"]` Finished attestation - `"FinishAttestationSuccess"` - `class ItemEFinishAttestationFailure: …` - `k: Literal["FinishAttestationFailure"]` Failed attestation - `"FinishAttestationFailure"` - `class ItemEStartRotateCryptKey: …` - `k: Literal["StartRotateCryptKey"]` Started crypt key rotation - `"StartRotateCryptKey"` - `class ItemEFinishRotateCryptKeySuccess: …` - `k: Literal["FinishRotateCryptKeySuccess"]` Finished crypt key rotation - `"FinishRotateCryptKeySuccess"` - `class ItemEFinishRotateCryptKeyFailure: …` - `k: Literal["FinishRotateCryptKeyFailure"]` Failed crypt key rotation - `"FinishRotateCryptKeyFailure"` - `class ItemEStartRotatePki: …` - `k: Literal["StartRotatePki"]` Started PKI rotation - `"StartRotatePki"` - `class ItemEFinishRotatePkiSuccess: …` - `k: Literal["FinishRotatePkiSuccess"]` Finished PKI rotation - `"FinishRotatePkiSuccess"` - `class ItemEFinishRotatePkiFailure: …` - `k: Literal["FinishRotatePkiFailure"]` Failed PKI rotation - `"FinishRotatePkiFailure"` - `class ItemEStartUpgrade: …` - `k: Literal["StartUpgrade"]` Started upgrade - `"StartUpgrade"` - `url: str` Location of upgrade bundle - `class ItemEFinishUpgradeSuccess: …` - `k: Literal["FinishUpgradeSuccess"]` Finished upgrade - `"FinishUpgradeSuccess"` - `class ItemEFinishUpgradeFailure: …` - `k: Literal["FinishUpgradeFailure"]` Failed upgrade - `"FinishUpgradeFailure"` - `class ItemEReconcile: …` - `k: Literal["Reconcile"]` Reconciled - `"Reconcile"` - `class ItemEConfigureCloudflaredTunnel: …` - `k: Literal["ConfigureCloudflaredTunnel"]` Configured Cloudflared tunnel - `"ConfigureCloudflaredTunnel"` - `n: float` Sequence number, used to order events with the same timestamp - `t: float` Time the Event was recorded (seconds since the Unix epoch) - `v: Optional[str]` Version ### Example ```python import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) latests = client.magic_transit.connectors.events.latest.list( connector_id="connector_id", account_id="023e105f4ecef8ad9ca31a8372d0c353", ) print(latests.count) ``` #### Response ```json { "result": { "count": 0, "items": [ { "e": { "k": "Init" }, "n": 0, "t": 0, "v": "v" } ] }, "success": true, "errors": [ { "code": 0, "message": "message" } ], "messages": [ { "code": 0, "message": "message" } ] } ``` ## Domain Types ### Latest List Response - `class LatestListResponse: …` - `count: float` - `items: List[Item]` - `e: ItemE` - `class ItemEInit: …` - `k: Literal["Init"]` Initialized process - `"Init"` - `class ItemELeave: …` - `k: Literal["Leave"]` Stopped process - `"Leave"` - `class ItemEStartAttestation: …` - `k: Literal["StartAttestation"]` Started attestation - `"StartAttestation"` - `class ItemEFinishAttestationSuccess: …` - `k: Literal["FinishAttestationSuccess"]` Finished attestation - `"FinishAttestationSuccess"` - `class ItemEFinishAttestationFailure: …` - `k: Literal["FinishAttestationFailure"]` Failed attestation - `"FinishAttestationFailure"` - `class ItemEStartRotateCryptKey: …` - `k: Literal["StartRotateCryptKey"]` Started crypt key rotation - `"StartRotateCryptKey"` - `class ItemEFinishRotateCryptKeySuccess: …` - `k: Literal["FinishRotateCryptKeySuccess"]` Finished crypt key rotation - `"FinishRotateCryptKeySuccess"` - `class ItemEFinishRotateCryptKeyFailure: …` - `k: Literal["FinishRotateCryptKeyFailure"]` Failed crypt key rotation - `"FinishRotateCryptKeyFailure"` - `class ItemEStartRotatePki: …` - `k: Literal["StartRotatePki"]` Started PKI rotation - `"StartRotatePki"` - `class ItemEFinishRotatePkiSuccess: …` - `k: Literal["FinishRotatePkiSuccess"]` Finished PKI rotation - `"FinishRotatePkiSuccess"` - `class ItemEFinishRotatePkiFailure: …` - `k: Literal["FinishRotatePkiFailure"]` Failed PKI rotation - `"FinishRotatePkiFailure"` - `class ItemEStartUpgrade: …` - `k: Literal["StartUpgrade"]` Started upgrade - `"StartUpgrade"` - `url: str` Location of upgrade bundle - `class ItemEFinishUpgradeSuccess: …` - `k: Literal["FinishUpgradeSuccess"]` Finished upgrade - `"FinishUpgradeSuccess"` - `class ItemEFinishUpgradeFailure: …` - `k: Literal["FinishUpgradeFailure"]` Failed upgrade - `"FinishUpgradeFailure"` - `class ItemEReconcile: …` - `k: Literal["Reconcile"]` Reconciled - `"Reconcile"` - `class ItemEConfigureCloudflaredTunnel: …` - `k: Literal["ConfigureCloudflaredTunnel"]` Configured Cloudflared tunnel - `"ConfigureCloudflaredTunnel"` - `n: float` Sequence number, used to order events with the same timestamp - `t: float` Time the Event was recorded (seconds since the Unix epoch) - `v: Optional[str]` Version # Snapshots ## List Snapshots `magic_transit.connectors.snapshots.list(strconnector_id, SnapshotListParams**kwargs) -> SnapshotListResponse` **get** `/accounts/{account_id}/magic/connectors/{connector_id}/telemetry/snapshots` List Snapshots ### Parameters - `account_id: str` Account identifier - `connector_id: str` - `from_: float` - `to: float` - `cursor: Optional[str]` - `limit: Optional[float]` ### Returns - `class SnapshotListResponse: …` - `count: float` - `items: List[Item]` - `a: float` Time the Snapshot was collected (seconds since the Unix epoch) - `t: float` Time the Snapshot was recorded (seconds since the Unix epoch) - `cursor: Optional[str]` ### Example ```python import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) snapshots = client.magic_transit.connectors.snapshots.list( connector_id="connector_id", account_id="023e105f4ecef8ad9ca31a8372d0c353", from_=0, to=0, ) print(snapshots.count) ``` #### Response ```json { "result": { "count": 0, "items": [ { "a": 0, "t": 0 } ], "cursor": "cursor" }, "success": true, "errors": [ { "code": 0, "message": "message" } ], "messages": [ { "code": 0, "message": "message" } ] } ``` ## Get Snapshot `magic_transit.connectors.snapshots.get(floatsnapshot_t, SnapshotGetParams**kwargs) -> SnapshotGetResponse` **get** `/accounts/{account_id}/magic/connectors/{connector_id}/telemetry/snapshots/{snapshot_t}` Get Snapshot ### Parameters - `account_id: str` Account identifier - `connector_id: str` - `snapshot_t: float` ### Returns - `class SnapshotGetResponse: …` Snapshot - `count_reclaim_failures: float` Count of failures to reclaim space - `count_reclaimed_paths: float` Count of reclaimed paths - `count_record_failed: float` Count of failed snapshot recordings - `count_transmit_failures: float` Count of failed snapshot transmissions - `t: float` Time the Snapshot was recorded (seconds since the Unix epoch) - `v: str` Version - `bonds: Optional[List[Bond]]` - `name: str` Name of the network interface - `status: str` Current status of the network interface - `cpu_count: Optional[float]` Count of processors/cores - `cpu_pressure_10s: Optional[float]` Percentage of time over a 10 second window that tasks were stalled - `cpu_pressure_300s: Optional[float]` Percentage of time over a 5 minute window that tasks were stalled - `cpu_pressure_60s: Optional[float]` Percentage of time over a 1 minute window that tasks were stalled - `cpu_pressure_total_us: Optional[float]` Total stall time (microseconds) - `cpu_time_guest_ms: Optional[float]` Time spent running a virtual CPU or guest OS (milliseconds) - `cpu_time_guest_nice_ms: Optional[float]` Time spent running a niced guest (milliseconds) - `cpu_time_idle_ms: Optional[float]` Time spent in idle state (milliseconds) - `cpu_time_iowait_ms: Optional[float]` Time spent wait for I/O to complete (milliseconds) - `cpu_time_irq_ms: Optional[float]` Time spent servicing interrupts (milliseconds) - `cpu_time_nice_ms: Optional[float]` Time spent in low-priority user mode (milliseconds) - `cpu_time_softirq_ms: Optional[float]` Time spent servicing softirqs (milliseconds) - `cpu_time_steal_ms: Optional[float]` Time stolen (milliseconds) - `cpu_time_system_ms: Optional[float]` Time spent in system mode (milliseconds) - `cpu_time_user_ms: Optional[float]` Time spent in user mode (milliseconds) - `delta: Optional[float]` Number of network operations applied during state transition - `dhcp_leases: Optional[List[DHCPLease]]` - `client_id: str` Client ID of the device the IP Address was leased to - `expiry_time: float` Expiry time of the DHCP lease (seconds since the Unix epoch) - `hostname: str` Hostname of the device the IP Address was leased to - `interface_name: str` Name of the network interface - `ip_address: str` IP Address that was leased - `mac_address: str` MAC Address of the device the IP Address was leased to - `disks: Optional[List[Disk]]` - `in_progress: float` I/Os currently in progress - `major: float` Device major number - `merged: float` Reads merged - `minor: float` Device minor number - `name: str` Device name - `reads: float` Reads completed successfully - `sectors_read: float` Sectors read successfully - `sectors_written: float` Sectors written successfully - `time_in_progress_ms: float` Time spent doing I/Os (milliseconds) - `time_reading_ms: float` Time spent reading (milliseconds) - `time_writing_ms: float` Time spent writing (milliseconds) - `weighted_time_in_progress_ms: float` Weighted time spent doing I/Os (milliseconds) - `writes: float` Writes completed - `writes_merged: float` Writes merged - `discards: Optional[float]` Discards completed successfully - `discards_merged: Optional[float]` Discards merged - `flushes: Optional[float]` Flushes completed successfully - `sectors_discarded: Optional[float]` Sectors discarded - `time_discarding_ms: Optional[float]` Time spent discarding (milliseconds) - `time_flushing_ms: Optional[float]` Time spent flushing (milliseconds) - `epsilon: Optional[float]` Simulated number of network operations applied during state transition - `ha_state: Optional[str]` Name of high availability state - `ha_value: Optional[float]` Numeric value associated with high availability state (0 = disabled, 1 = active, 2 = standby, 3 = stopped, 4 = fault) - `interfaces: Optional[List[Interface]]` - `name: str` Name of the network interface - `operstate: str` UP/DOWN state of the network interface - `ip_addresses: Optional[List[InterfaceIPAddress]]` - `interface_name: str` Name of the network interface - `ip_address: str` IP address of the network interface - `speed: Optional[float]` Speed of the network interface (bits per second) - `io_pressure_full_10s: Optional[float]` Percentage of time over a 10 second window that all tasks were stalled - `io_pressure_full_300s: Optional[float]` Percentage of time over a 5 minute window that all tasks were stalled - `io_pressure_full_60s: Optional[float]` Percentage of time over a 1 minute window that all tasks were stalled - `io_pressure_full_total_us: Optional[float]` Total stall time (microseconds) - `io_pressure_some_10s: Optional[float]` Percentage of time over a 10 second window that some tasks were stalled - `io_pressure_some_300s: Optional[float]` Percentage of time over a 3 minute window that some tasks were stalled - `io_pressure_some_60s: Optional[float]` Percentage of time over a 1 minute window that some tasks were stalled - `io_pressure_some_total_us: Optional[float]` Total stall time (microseconds) - `kernel_btime: Optional[float]` Boot time (seconds since Unix epoch) - `kernel_ctxt: Optional[float]` Number of context switches that the system underwent - `kernel_processes: Optional[float]` Number of forks since boot - `kernel_processes_blocked: Optional[float]` Number of processes blocked waiting for I/O - `kernel_processes_running: Optional[float]` Number of processes in runnable state - `load_average_15m: Optional[float]` The fifteen-minute load average - `load_average_1m: Optional[float]` The one-minute load average - `load_average_5m: Optional[float]` The five-minute load average - `load_average_cur: Optional[float]` Number of currently runnable kernel scheduling entities - `load_average_max: Optional[float]` Number of kernel scheduling entities that currently exist on the system - `memory_active_bytes: Optional[float]` Memory that has been used more recently - `memory_anon_hugepages_bytes: Optional[float]` Non-file backed huge pages mapped into user-space page tables - `memory_anon_pages_bytes: Optional[float]` Non-file backed pages mapped into user-space page tables - `memory_available_bytes: Optional[float]` Estimate of how much memory is available for starting new applications - `memory_bounce_bytes: Optional[float]` Memory used for block device bounce buffers - `memory_buffers_bytes: Optional[float]` Relatively temporary storage for raw disk blocks - `memory_cached_bytes: Optional[float]` In-memory cache for files read from the disk - `memory_cma_free_bytes: Optional[float]` Free CMA (Contiguous Memory Allocator) pages - `memory_cma_total_bytes: Optional[float]` Total CMA (Contiguous Memory Allocator) pages - `memory_commit_limit_bytes: Optional[float]` Total amount of memory currently available to be allocated on the system - `memory_committed_as_bytes: Optional[float]` Amount of memory presently allocated on the system - `memory_dirty_bytes: Optional[float]` Memory which is waiting to get written back to the disk - `memory_free_bytes: Optional[float]` The sum of LowFree and HighFree - `memory_high_free_bytes: Optional[float]` Amount of free highmem - `memory_high_total_bytes: Optional[float]` Total amount of highmem - `memory_hugepages_free: Optional[float]` The number of huge pages in the pool that are not yet allocated - `memory_hugepages_rsvd: Optional[float]` Number of huge pages for which a commitment has been made, but no allocation has yet been made - `memory_hugepages_surp: Optional[float]` Number of huge pages in the pool above the threshold - `memory_hugepages_total: Optional[float]` The size of the pool of huge pages - `memory_hugepagesize_bytes: Optional[float]` The size of huge pages - `memory_inactive_bytes: Optional[float]` Memory which has been less recently used - `memory_k_reclaimable_bytes: Optional[float]` Kernel allocations that the kernel will attempt to reclaim under memory pressure - `memory_kernel_stack_bytes: Optional[float]` Amount of memory allocated to kernel stacks - `memory_low_free_bytes: Optional[float]` Amount of free lowmem - `memory_low_total_bytes: Optional[float]` Total amount of lowmem - `memory_mapped_bytes: Optional[float]` Files which have been mapped into memory - `memory_page_tables_bytes: Optional[float]` Amount of memory dedicated to the lowest level of page tables - `memory_per_cpu_bytes: Optional[float]` Memory allocated to the per-cpu alloctor used to back per-cpu allocations - `memory_pressure_full_10s: Optional[float]` Percentage of time over a 10 second window that all tasks were stalled - `memory_pressure_full_300s: Optional[float]` Percentage of time over a 5 minute window that all tasks were stalled - `memory_pressure_full_60s: Optional[float]` Percentage of time over a 1 minute window that all tasks were stalled - `memory_pressure_full_total_us: Optional[float]` Total stall time (microseconds) - `memory_pressure_some_10s: Optional[float]` Percentage of time over a 10 second window that some tasks were stalled - `memory_pressure_some_300s: Optional[float]` Percentage of time over a 5 minute window that some tasks were stalled - `memory_pressure_some_60s: Optional[float]` Percentage of time over a 1 minute window that some tasks were stalled - `memory_pressure_some_total_us: Optional[float]` Total stall time (microseconds) - `memory_s_reclaimable_bytes: Optional[float]` Part of slab that can be reclaimed on memory pressure - `memory_s_unreclaim_bytes: Optional[float]` Part of slab that cannot be reclaimed on memory pressure - `memory_secondary_page_tables_bytes: Optional[float]` Amount of memory dedicated to the lowest level of page tables - `memory_shmem_bytes: Optional[float]` Amount of memory consumed by tmpfs - `memory_shmem_hugepages_bytes: Optional[float]` Memory used by shmem and tmpfs, allocated with huge pages - `memory_shmem_pmd_mapped_bytes: Optional[float]` Shared memory mapped into user space with huge pages - `memory_slab_bytes: Optional[float]` In-kernel data structures cache - `memory_swap_cached_bytes: Optional[float]` Memory swapped out and back in while still in swap file - `memory_swap_free_bytes: Optional[float]` Amount of swap space that is currently unused - `memory_swap_total_bytes: Optional[float]` Total amount of swap space available - `memory_total_bytes: Optional[float]` Total usable RAM - `memory_vmalloc_chunk_bytes: Optional[float]` Largest contiguous block of vmalloc area which is free - `memory_vmalloc_total_bytes: Optional[float]` Total size of vmalloc memory area - `memory_vmalloc_used_bytes: Optional[float]` Amount of vmalloc area which is used - `memory_writeback_bytes: Optional[float]` Memory which is actively being written back to the disk - `memory_writeback_tmp_bytes: Optional[float]` Memory used by FUSE for temporary writeback buffers - `memory_z_swap_bytes: Optional[float]` Memory consumed by the zswap backend, compressed - `memory_z_swapped_bytes: Optional[float]` Amount of anonymous memory stored in zswap, uncompressed - `mounts: Optional[List[Mount]]` - `file_system: str` File system on disk (EXT4, NTFS, etc.) - `kind: str` Kind of disk (HDD, SSD, etc.) - `mount_point: str` Path where disk is mounted - `name: str` Name of the disk mount - `available_bytes: Optional[float]` Available disk size (bytes) - `is_read_only: Optional[bool]` Determines whether the disk is read-only - `is_removable: Optional[bool]` Determines whether the disk is removable - `total_bytes: Optional[float]` Total disk size (bytes) - `netdevs: Optional[List[Netdev]]` - `name: str` Name of the network device - `recv_bytes: float` Total bytes received - `recv_compressed: float` Compressed packets received - `recv_drop: float` Packets dropped - `recv_errs: float` Bad packets received - `recv_fifo: float` FIFO overruns - `recv_frame: float` Frame alignment errors - `recv_multicast: float` Multicast packets received - `recv_packets: float` Total packets received - `sent_bytes: float` Total bytes transmitted - `sent_carrier: float` Number of packets not sent due to carrier errors - `sent_colls: float` Number of collisions - `sent_compressed: float` Number of compressed packets transmitted - `sent_drop: float` Number of packets dropped during transmission - `sent_errs: float` Number of transmission errors - `sent_fifo: float` FIFO overruns - `sent_packets: float` Total packets transmitted - `snmp_icmp_in_addr_mask_reps: Optional[float]` Number of ICMP Address Mask Reply messages received - `snmp_icmp_in_addr_masks: Optional[float]` Number of ICMP Address Mask Request messages received - `snmp_icmp_in_csum_errors: Optional[float]` Number of ICMP messages received with bad checksums - `snmp_icmp_in_dest_unreachs: Optional[float]` Number of ICMP Destination Unreachable messages received - `snmp_icmp_in_echo_reps: Optional[float]` Number of ICMP Echo Reply messages received - `snmp_icmp_in_echos: Optional[float]` Number of ICMP Echo (request) messages received - `snmp_icmp_in_errors: Optional[float]` Number of ICMP messages received with ICMP-specific errors - `snmp_icmp_in_msgs: Optional[float]` Number of ICMP messages received - `snmp_icmp_in_parm_probs: Optional[float]` Number of ICMP Parameter Problem messages received - `snmp_icmp_in_redirects: Optional[float]` Number of ICMP Redirect messages received - `snmp_icmp_in_src_quenchs: Optional[float]` Number of ICMP Source Quench messages received - `snmp_icmp_in_time_excds: Optional[float]` Number of ICMP Time Exceeded messages received - `snmp_icmp_in_timestamp_reps: Optional[float]` Number of ICMP Address Mask Request messages received - `snmp_icmp_in_timestamps: Optional[float]` Number of ICMP Timestamp (request) messages received - `snmp_icmp_out_addr_mask_reps: Optional[float]` Number of ICMP Address Mask Reply messages sent - `snmp_icmp_out_addr_masks: Optional[float]` Number of ICMP Address Mask Request messages sent - `snmp_icmp_out_dest_unreachs: Optional[float]` Number of ICMP Destination Unreachable messages sent - `snmp_icmp_out_echo_reps: Optional[float]` Number of ICMP Echo Reply messages sent - `snmp_icmp_out_echos: Optional[float]` Number of ICMP Echo (request) messages sent - `snmp_icmp_out_errors: Optional[float]` Number of ICMP messages which this entity did not send due to ICMP-specific errors - `snmp_icmp_out_msgs: Optional[float]` Number of ICMP messages attempted to send - `snmp_icmp_out_parm_probs: Optional[float]` Number of ICMP Parameter Problem messages sent - `snmp_icmp_out_redirects: Optional[float]` Number of ICMP Redirect messages sent - `snmp_icmp_out_src_quenchs: Optional[float]` Number of ICMP Source Quench messages sent - `snmp_icmp_out_time_excds: Optional[float]` Number of ICMP Time Exceeded messages sent - `snmp_icmp_out_timestamp_reps: Optional[float]` Number of ICMP Timestamp Reply messages sent - `snmp_icmp_out_timestamps: Optional[float]` Number of ICMP Timestamp (request) messages sent - `snmp_ip_default_ttl: Optional[float]` Default value of the Time-To-Live field of the IP header - `snmp_ip_forw_datagrams: Optional[float]` Number of datagrams forwarded to their final destination - `snmp_ip_forwarding_enabled: Optional[bool]` Set when acting as an IP gateway - `snmp_ip_frag_creates: Optional[float]` Number of datagrams generated by fragmentation - `snmp_ip_frag_fails: Optional[float]` Number of datagrams discarded because fragmentation failed - `snmp_ip_frag_oks: Optional[float]` Number of datagrams successfully fragmented - `snmp_ip_in_addr_errors: Optional[float]` Number of input datagrams discarded due to errors in the IP address - `snmp_ip_in_delivers: Optional[float]` Number of input datagrams successfully delivered to IP user-protocols - `snmp_ip_in_discards: Optional[float]` Number of input datagrams otherwise discarded - `snmp_ip_in_hdr_errors: Optional[float]` Number of input datagrams discarded due to errors in the IP header - `snmp_ip_in_receives: Optional[float]` Number of input datagrams received from interfaces - `snmp_ip_in_unknown_protos: Optional[float]` Number of input datagrams discarded due unknown or unsupported protocol - `snmp_ip_out_discards: Optional[float]` Number of output datagrams otherwise discarded - `snmp_ip_out_no_routes: Optional[float]` Number of output datagrams discarded because no route matched - `snmp_ip_out_requests: Optional[float]` Number of datagrams supplied for transmission - `snmp_ip_reasm_fails: Optional[float]` Number of failures detected by the reassembly algorithm - `snmp_ip_reasm_oks: Optional[float]` Number of datagrams successfully reassembled - `snmp_ip_reasm_reqds: Optional[float]` Number of fragments received which needed to be reassembled - `snmp_ip_reasm_timeout: Optional[float]` Number of seconds fragments are held while awaiting reassembly - `snmp_tcp_active_opens: Optional[float]` Number of times TCP transitions to SYN-SENT from CLOSED - `snmp_tcp_attempt_fails: Optional[float]` Number of times TCP transitions to CLOSED from SYN-SENT or SYN-RCVD, plus transitions to LISTEN from SYN-RCVD - `snmp_tcp_curr_estab: Optional[float]` Number of TCP connections in ESTABLISHED or CLOSE-WAIT - `snmp_tcp_estab_resets: Optional[float]` Number of times TCP transitions to CLOSED from ESTABLISHED or CLOSE-WAIT - `snmp_tcp_in_csum_errors: Optional[float]` Number of TCP segments received with checksum errors - `snmp_tcp_in_errs: Optional[float]` Number of TCP segments received in error - `snmp_tcp_in_segs: Optional[float]` Number of TCP segments received - `snmp_tcp_max_conn: Optional[float]` Limit on the total number of TCP connections - `snmp_tcp_out_rsts: Optional[float]` Number of TCP segments sent with RST flag - `snmp_tcp_out_segs: Optional[float]` Number of TCP segments sent - `snmp_tcp_passive_opens: Optional[float]` Number of times TCP transitions to SYN-RCVD from LISTEN - `snmp_tcp_retrans_segs: Optional[float]` Number of TCP segments retransmitted - `snmp_tcp_rto_max: Optional[float]` Maximum value permitted by a TCP implementation for the retransmission timeout (milliseconds) - `snmp_tcp_rto_min: Optional[float]` Minimum value permitted by a TCP implementation for the retransmission timeout (milliseconds) - `snmp_udp_in_datagrams: Optional[float]` Number of UDP datagrams delivered to UDP applications - `snmp_udp_in_errors: Optional[float]` Number of UDP datagrams failed to be delivered for reasons other than lack of application at the destination port - `snmp_udp_no_ports: Optional[float]` Number of UDP datagrams received for which there was not application at the destination port - `snmp_udp_out_datagrams: Optional[float]` Number of UDP datagrams sent - `system_boot_time_s: Optional[float]` Boottime of the system (seconds since the Unix epoch) - `thermals: Optional[List[Thermal]]` - `label: str` Sensor identifier for the component - `critical_celcius: Optional[float]` Critical failure temperature of the component (degrees Celsius) - `current_celcius: Optional[float]` Current temperature of the component (degrees Celsius) - `max_celcius: Optional[float]` Maximum temperature of the component (degrees Celsius) - `tunnels: Optional[List[Tunnel]]` - `health_state: str` Name of tunnel health state (unknown, healthy, degraded, down) - `health_value: float` Numeric value associated with tunnel state (0 = unknown, 1 = healthy, 2 = degraded, 3 = down) - `interface_name: str` The tunnel interface name (i.e. xfrm1, xfrm3.99, etc.) - `tunnel_id: str` Tunnel identifier - `probed_mtu: Optional[float]` MTU as measured between the two ends of the tunnel - `recent_healthy_pings: Optional[float]` Number of recent healthy pings for this tunnel - `recent_unhealthy_pings: Optional[float]` Number of recent unhealthy pings for this tunnel - `uptime_idle_ms: Optional[float]` Sum of how much time each core has spent idle - `uptime_total_ms: Optional[float]` Uptime of the system, including time spent in suspend ### Example ```python import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) snapshot = client.magic_transit.connectors.snapshots.get( snapshot_t=0, account_id="023e105f4ecef8ad9ca31a8372d0c353", connector_id="connector_id", ) print(snapshot.cpu_time_idle_ms) ``` #### Response ```json { "result": { "count_reclaim_failures": 0, "count_reclaimed_paths": 0, "count_record_failed": 0, "count_transmit_failures": 0, "t": 0, "v": "v", "bonds": [ { "name": "name", "status": "status" } ], "cpu_count": 0, "cpu_pressure_10s": 0, "cpu_pressure_300s": 0, "cpu_pressure_60s": 0, "cpu_pressure_total_us": 0, "cpu_time_guest_ms": 0, "cpu_time_guest_nice_ms": 0, "cpu_time_idle_ms": 0, "cpu_time_iowait_ms": 0, "cpu_time_irq_ms": 0, "cpu_time_nice_ms": 0, "cpu_time_softirq_ms": 0, "cpu_time_steal_ms": 0, "cpu_time_system_ms": 0, "cpu_time_user_ms": 0, "delta": 0, "dhcp_leases": [ { "client_id": "client_id", "expiry_time": 0, "hostname": "hostname", "interface_name": "interface_name", "ip_address": "ip_address", "mac_address": "mac_address" } ], "disks": [ { "in_progress": 0, "major": 0, "merged": 0, "minor": 0, "name": "name", "reads": 0, "sectors_read": 0, "sectors_written": 0, "time_in_progress_ms": 0, "time_reading_ms": 0, "time_writing_ms": 0, "weighted_time_in_progress_ms": 0, "writes": 0, "writes_merged": 0, "discards": 0, "discards_merged": 0, "flushes": 0, "sectors_discarded": 0, "time_discarding_ms": 0, "time_flushing_ms": 0 } ], "epsilon": 0, "ha_state": "ha_state", "ha_value": 0, "interfaces": [ { "name": "name", "operstate": "operstate", "ip_addresses": [ { "interface_name": "interface_name", "ip_address": "ip_address" } ], "speed": 0 } ], "io_pressure_full_10s": 0, "io_pressure_full_300s": 0, "io_pressure_full_60s": 0, "io_pressure_full_total_us": 0, "io_pressure_some_10s": 0, "io_pressure_some_300s": 0, "io_pressure_some_60s": 0, "io_pressure_some_total_us": 0, "kernel_btime": 0, "kernel_ctxt": 0, "kernel_processes": 0, "kernel_processes_blocked": 0, "kernel_processes_running": 0, "load_average_15m": 0, "load_average_1m": 0, "load_average_5m": 0, "load_average_cur": 0, "load_average_max": 0, "memory_active_bytes": 0, "memory_anon_hugepages_bytes": 0, "memory_anon_pages_bytes": 0, "memory_available_bytes": 0, "memory_bounce_bytes": 0, "memory_buffers_bytes": 0, "memory_cached_bytes": 0, "memory_cma_free_bytes": 0, "memory_cma_total_bytes": 0, "memory_commit_limit_bytes": 0, "memory_committed_as_bytes": 0, "memory_dirty_bytes": 0, "memory_free_bytes": 0, "memory_high_free_bytes": 0, "memory_high_total_bytes": 0, "memory_hugepages_free": 0, "memory_hugepages_rsvd": 0, "memory_hugepages_surp": 0, "memory_hugepages_total": 0, "memory_hugepagesize_bytes": 0, "memory_inactive_bytes": 0, "memory_k_reclaimable_bytes": 0, "memory_kernel_stack_bytes": 0, "memory_low_free_bytes": 0, "memory_low_total_bytes": 0, "memory_mapped_bytes": 0, "memory_page_tables_bytes": 0, "memory_per_cpu_bytes": 0, "memory_pressure_full_10s": 0, "memory_pressure_full_300s": 0, "memory_pressure_full_60s": 0, "memory_pressure_full_total_us": 0, "memory_pressure_some_10s": 0, "memory_pressure_some_300s": 0, "memory_pressure_some_60s": 0, "memory_pressure_some_total_us": 0, "memory_s_reclaimable_bytes": 0, "memory_s_unreclaim_bytes": 0, "memory_secondary_page_tables_bytes": 0, "memory_shmem_bytes": 0, "memory_shmem_hugepages_bytes": 0, "memory_shmem_pmd_mapped_bytes": 0, "memory_slab_bytes": 0, "memory_swap_cached_bytes": 0, "memory_swap_free_bytes": 0, "memory_swap_total_bytes": 0, "memory_total_bytes": 0, "memory_vmalloc_chunk_bytes": 0, "memory_vmalloc_total_bytes": 0, "memory_vmalloc_used_bytes": 0, "memory_writeback_bytes": 0, "memory_writeback_tmp_bytes": 0, "memory_z_swap_bytes": 0, "memory_z_swapped_bytes": 0, "mounts": [ { "file_system": "file_system", "kind": "kind", "mount_point": "mount_point", "name": "name", "available_bytes": 0, "is_read_only": true, "is_removable": true, "total_bytes": 0 } ], "netdevs": [ { "name": "name", "recv_bytes": 0, "recv_compressed": 0, "recv_drop": 0, "recv_errs": 0, "recv_fifo": 0, "recv_frame": 0, "recv_multicast": 0, "recv_packets": 0, "sent_bytes": 0, "sent_carrier": 0, "sent_colls": 0, "sent_compressed": 0, "sent_drop": 0, "sent_errs": 0, "sent_fifo": 0, "sent_packets": 0 } ], "snmp_icmp_in_addr_mask_reps": 0, "snmp_icmp_in_addr_masks": 0, "snmp_icmp_in_csum_errors": 0, "snmp_icmp_in_dest_unreachs": 0, "snmp_icmp_in_echo_reps": 0, "snmp_icmp_in_echos": 0, "snmp_icmp_in_errors": 0, "snmp_icmp_in_msgs": 0, "snmp_icmp_in_parm_probs": 0, "snmp_icmp_in_redirects": 0, "snmp_icmp_in_src_quenchs": 0, "snmp_icmp_in_time_excds": 0, "snmp_icmp_in_timestamp_reps": 0, "snmp_icmp_in_timestamps": 0, "snmp_icmp_out_addr_mask_reps": 0, "snmp_icmp_out_addr_masks": 0, "snmp_icmp_out_dest_unreachs": 0, "snmp_icmp_out_echo_reps": 0, "snmp_icmp_out_echos": 0, "snmp_icmp_out_errors": 0, "snmp_icmp_out_msgs": 0, "snmp_icmp_out_parm_probs": 0, "snmp_icmp_out_redirects": 0, "snmp_icmp_out_src_quenchs": 0, "snmp_icmp_out_time_excds": 0, "snmp_icmp_out_timestamp_reps": 0, "snmp_icmp_out_timestamps": 0, "snmp_ip_default_ttl": 0, "snmp_ip_forw_datagrams": 0, "snmp_ip_forwarding_enabled": true, "snmp_ip_frag_creates": 0, "snmp_ip_frag_fails": 0, "snmp_ip_frag_oks": 0, "snmp_ip_in_addr_errors": 0, "snmp_ip_in_delivers": 0, "snmp_ip_in_discards": 0, "snmp_ip_in_hdr_errors": 0, "snmp_ip_in_receives": 0, "snmp_ip_in_unknown_protos": 0, "snmp_ip_out_discards": 0, "snmp_ip_out_no_routes": 0, "snmp_ip_out_requests": 0, "snmp_ip_reasm_fails": 0, "snmp_ip_reasm_oks": 0, "snmp_ip_reasm_reqds": 0, "snmp_ip_reasm_timeout": 0, "snmp_tcp_active_opens": 0, "snmp_tcp_attempt_fails": 0, "snmp_tcp_curr_estab": 0, "snmp_tcp_estab_resets": 0, "snmp_tcp_in_csum_errors": 0, "snmp_tcp_in_errs": 0, "snmp_tcp_in_segs": 0, "snmp_tcp_max_conn": 0, "snmp_tcp_out_rsts": 0, "snmp_tcp_out_segs": 0, "snmp_tcp_passive_opens": 0, "snmp_tcp_retrans_segs": 0, "snmp_tcp_rto_max": 0, "snmp_tcp_rto_min": 0, "snmp_udp_in_datagrams": 0, "snmp_udp_in_errors": 0, "snmp_udp_no_ports": 0, "snmp_udp_out_datagrams": 0, "system_boot_time_s": 0, "thermals": [ { "label": "label", "critical_celcius": 0, "current_celcius": 0, "max_celcius": 0 } ], "tunnels": [ { "health_state": "health_state", "health_value": 0, "interface_name": "interface_name", "tunnel_id": "tunnel_id", "probed_mtu": 0, "recent_healthy_pings": 0, "recent_unhealthy_pings": 0 } ], "uptime_idle_ms": 0, "uptime_total_ms": 0 }, "success": true, "errors": [ { "code": 0, "message": "message" } ], "messages": [ { "code": 0, "message": "message" } ] } ``` ## Domain Types ### Snapshot List Response - `class SnapshotListResponse: …` - `count: float` - `items: List[Item]` - `a: float` Time the Snapshot was collected (seconds since the Unix epoch) - `t: float` Time the Snapshot was recorded (seconds since the Unix epoch) - `cursor: Optional[str]` ### Snapshot Get Response - `class SnapshotGetResponse: …` Snapshot - `count_reclaim_failures: float` Count of failures to reclaim space - `count_reclaimed_paths: float` Count of reclaimed paths - `count_record_failed: float` Count of failed snapshot recordings - `count_transmit_failures: float` Count of failed snapshot transmissions - `t: float` Time the Snapshot was recorded (seconds since the Unix epoch) - `v: str` Version - `bonds: Optional[List[Bond]]` - `name: str` Name of the network interface - `status: str` Current status of the network interface - `cpu_count: Optional[float]` Count of processors/cores - `cpu_pressure_10s: Optional[float]` Percentage of time over a 10 second window that tasks were stalled - `cpu_pressure_300s: Optional[float]` Percentage of time over a 5 minute window that tasks were stalled - `cpu_pressure_60s: Optional[float]` Percentage of time over a 1 minute window that tasks were stalled - `cpu_pressure_total_us: Optional[float]` Total stall time (microseconds) - `cpu_time_guest_ms: Optional[float]` Time spent running a virtual CPU or guest OS (milliseconds) - `cpu_time_guest_nice_ms: Optional[float]` Time spent running a niced guest (milliseconds) - `cpu_time_idle_ms: Optional[float]` Time spent in idle state (milliseconds) - `cpu_time_iowait_ms: Optional[float]` Time spent wait for I/O to complete (milliseconds) - `cpu_time_irq_ms: Optional[float]` Time spent servicing interrupts (milliseconds) - `cpu_time_nice_ms: Optional[float]` Time spent in low-priority user mode (milliseconds) - `cpu_time_softirq_ms: Optional[float]` Time spent servicing softirqs (milliseconds) - `cpu_time_steal_ms: Optional[float]` Time stolen (milliseconds) - `cpu_time_system_ms: Optional[float]` Time spent in system mode (milliseconds) - `cpu_time_user_ms: Optional[float]` Time spent in user mode (milliseconds) - `delta: Optional[float]` Number of network operations applied during state transition - `dhcp_leases: Optional[List[DHCPLease]]` - `client_id: str` Client ID of the device the IP Address was leased to - `expiry_time: float` Expiry time of the DHCP lease (seconds since the Unix epoch) - `hostname: str` Hostname of the device the IP Address was leased to - `interface_name: str` Name of the network interface - `ip_address: str` IP Address that was leased - `mac_address: str` MAC Address of the device the IP Address was leased to - `disks: Optional[List[Disk]]` - `in_progress: float` I/Os currently in progress - `major: float` Device major number - `merged: float` Reads merged - `minor: float` Device minor number - `name: str` Device name - `reads: float` Reads completed successfully - `sectors_read: float` Sectors read successfully - `sectors_written: float` Sectors written successfully - `time_in_progress_ms: float` Time spent doing I/Os (milliseconds) - `time_reading_ms: float` Time spent reading (milliseconds) - `time_writing_ms: float` Time spent writing (milliseconds) - `weighted_time_in_progress_ms: float` Weighted time spent doing I/Os (milliseconds) - `writes: float` Writes completed - `writes_merged: float` Writes merged - `discards: Optional[float]` Discards completed successfully - `discards_merged: Optional[float]` Discards merged - `flushes: Optional[float]` Flushes completed successfully - `sectors_discarded: Optional[float]` Sectors discarded - `time_discarding_ms: Optional[float]` Time spent discarding (milliseconds) - `time_flushing_ms: Optional[float]` Time spent flushing (milliseconds) - `epsilon: Optional[float]` Simulated number of network operations applied during state transition - `ha_state: Optional[str]` Name of high availability state - `ha_value: Optional[float]` Numeric value associated with high availability state (0 = disabled, 1 = active, 2 = standby, 3 = stopped, 4 = fault) - `interfaces: Optional[List[Interface]]` - `name: str` Name of the network interface - `operstate: str` UP/DOWN state of the network interface - `ip_addresses: Optional[List[InterfaceIPAddress]]` - `interface_name: str` Name of the network interface - `ip_address: str` IP address of the network interface - `speed: Optional[float]` Speed of the network interface (bits per second) - `io_pressure_full_10s: Optional[float]` Percentage of time over a 10 second window that all tasks were stalled - `io_pressure_full_300s: Optional[float]` Percentage of time over a 5 minute window that all tasks were stalled - `io_pressure_full_60s: Optional[float]` Percentage of time over a 1 minute window that all tasks were stalled - `io_pressure_full_total_us: Optional[float]` Total stall time (microseconds) - `io_pressure_some_10s: Optional[float]` Percentage of time over a 10 second window that some tasks were stalled - `io_pressure_some_300s: Optional[float]` Percentage of time over a 3 minute window that some tasks were stalled - `io_pressure_some_60s: Optional[float]` Percentage of time over a 1 minute window that some tasks were stalled - `io_pressure_some_total_us: Optional[float]` Total stall time (microseconds) - `kernel_btime: Optional[float]` Boot time (seconds since Unix epoch) - `kernel_ctxt: Optional[float]` Number of context switches that the system underwent - `kernel_processes: Optional[float]` Number of forks since boot - `kernel_processes_blocked: Optional[float]` Number of processes blocked waiting for I/O - `kernel_processes_running: Optional[float]` Number of processes in runnable state - `load_average_15m: Optional[float]` The fifteen-minute load average - `load_average_1m: Optional[float]` The one-minute load average - `load_average_5m: Optional[float]` The five-minute load average - `load_average_cur: Optional[float]` Number of currently runnable kernel scheduling entities - `load_average_max: Optional[float]` Number of kernel scheduling entities that currently exist on the system - `memory_active_bytes: Optional[float]` Memory that has been used more recently - `memory_anon_hugepages_bytes: Optional[float]` Non-file backed huge pages mapped into user-space page tables - `memory_anon_pages_bytes: Optional[float]` Non-file backed pages mapped into user-space page tables - `memory_available_bytes: Optional[float]` Estimate of how much memory is available for starting new applications - `memory_bounce_bytes: Optional[float]` Memory used for block device bounce buffers - `memory_buffers_bytes: Optional[float]` Relatively temporary storage for raw disk blocks - `memory_cached_bytes: Optional[float]` In-memory cache for files read from the disk - `memory_cma_free_bytes: Optional[float]` Free CMA (Contiguous Memory Allocator) pages - `memory_cma_total_bytes: Optional[float]` Total CMA (Contiguous Memory Allocator) pages - `memory_commit_limit_bytes: Optional[float]` Total amount of memory currently available to be allocated on the system - `memory_committed_as_bytes: Optional[float]` Amount of memory presently allocated on the system - `memory_dirty_bytes: Optional[float]` Memory which is waiting to get written back to the disk - `memory_free_bytes: Optional[float]` The sum of LowFree and HighFree - `memory_high_free_bytes: Optional[float]` Amount of free highmem - `memory_high_total_bytes: Optional[float]` Total amount of highmem - `memory_hugepages_free: Optional[float]` The number of huge pages in the pool that are not yet allocated - `memory_hugepages_rsvd: Optional[float]` Number of huge pages for which a commitment has been made, but no allocation has yet been made - `memory_hugepages_surp: Optional[float]` Number of huge pages in the pool above the threshold - `memory_hugepages_total: Optional[float]` The size of the pool of huge pages - `memory_hugepagesize_bytes: Optional[float]` The size of huge pages - `memory_inactive_bytes: Optional[float]` Memory which has been less recently used - `memory_k_reclaimable_bytes: Optional[float]` Kernel allocations that the kernel will attempt to reclaim under memory pressure - `memory_kernel_stack_bytes: Optional[float]` Amount of memory allocated to kernel stacks - `memory_low_free_bytes: Optional[float]` Amount of free lowmem - `memory_low_total_bytes: Optional[float]` Total amount of lowmem - `memory_mapped_bytes: Optional[float]` Files which have been mapped into memory - `memory_page_tables_bytes: Optional[float]` Amount of memory dedicated to the lowest level of page tables - `memory_per_cpu_bytes: Optional[float]` Memory allocated to the per-cpu alloctor used to back per-cpu allocations - `memory_pressure_full_10s: Optional[float]` Percentage of time over a 10 second window that all tasks were stalled - `memory_pressure_full_300s: Optional[float]` Percentage of time over a 5 minute window that all tasks were stalled - `memory_pressure_full_60s: Optional[float]` Percentage of time over a 1 minute window that all tasks were stalled - `memory_pressure_full_total_us: Optional[float]` Total stall time (microseconds) - `memory_pressure_some_10s: Optional[float]` Percentage of time over a 10 second window that some tasks were stalled - `memory_pressure_some_300s: Optional[float]` Percentage of time over a 5 minute window that some tasks were stalled - `memory_pressure_some_60s: Optional[float]` Percentage of time over a 1 minute window that some tasks were stalled - `memory_pressure_some_total_us: Optional[float]` Total stall time (microseconds) - `memory_s_reclaimable_bytes: Optional[float]` Part of slab that can be reclaimed on memory pressure - `memory_s_unreclaim_bytes: Optional[float]` Part of slab that cannot be reclaimed on memory pressure - `memory_secondary_page_tables_bytes: Optional[float]` Amount of memory dedicated to the lowest level of page tables - `memory_shmem_bytes: Optional[float]` Amount of memory consumed by tmpfs - `memory_shmem_hugepages_bytes: Optional[float]` Memory used by shmem and tmpfs, allocated with huge pages - `memory_shmem_pmd_mapped_bytes: Optional[float]` Shared memory mapped into user space with huge pages - `memory_slab_bytes: Optional[float]` In-kernel data structures cache - `memory_swap_cached_bytes: Optional[float]` Memory swapped out and back in while still in swap file - `memory_swap_free_bytes: Optional[float]` Amount of swap space that is currently unused - `memory_swap_total_bytes: Optional[float]` Total amount of swap space available - `memory_total_bytes: Optional[float]` Total usable RAM - `memory_vmalloc_chunk_bytes: Optional[float]` Largest contiguous block of vmalloc area which is free - `memory_vmalloc_total_bytes: Optional[float]` Total size of vmalloc memory area - `memory_vmalloc_used_bytes: Optional[float]` Amount of vmalloc area which is used - `memory_writeback_bytes: Optional[float]` Memory which is actively being written back to the disk - `memory_writeback_tmp_bytes: Optional[float]` Memory used by FUSE for temporary writeback buffers - `memory_z_swap_bytes: Optional[float]` Memory consumed by the zswap backend, compressed - `memory_z_swapped_bytes: Optional[float]` Amount of anonymous memory stored in zswap, uncompressed - `mounts: Optional[List[Mount]]` - `file_system: str` File system on disk (EXT4, NTFS, etc.) - `kind: str` Kind of disk (HDD, SSD, etc.) - `mount_point: str` Path where disk is mounted - `name: str` Name of the disk mount - `available_bytes: Optional[float]` Available disk size (bytes) - `is_read_only: Optional[bool]` Determines whether the disk is read-only - `is_removable: Optional[bool]` Determines whether the disk is removable - `total_bytes: Optional[float]` Total disk size (bytes) - `netdevs: Optional[List[Netdev]]` - `name: str` Name of the network device - `recv_bytes: float` Total bytes received - `recv_compressed: float` Compressed packets received - `recv_drop: float` Packets dropped - `recv_errs: float` Bad packets received - `recv_fifo: float` FIFO overruns - `recv_frame: float` Frame alignment errors - `recv_multicast: float` Multicast packets received - `recv_packets: float` Total packets received - `sent_bytes: float` Total bytes transmitted - `sent_carrier: float` Number of packets not sent due to carrier errors - `sent_colls: float` Number of collisions - `sent_compressed: float` Number of compressed packets transmitted - `sent_drop: float` Number of packets dropped during transmission - `sent_errs: float` Number of transmission errors - `sent_fifo: float` FIFO overruns - `sent_packets: float` Total packets transmitted - `snmp_icmp_in_addr_mask_reps: Optional[float]` Number of ICMP Address Mask Reply messages received - `snmp_icmp_in_addr_masks: Optional[float]` Number of ICMP Address Mask Request messages received - `snmp_icmp_in_csum_errors: Optional[float]` Number of ICMP messages received with bad checksums - `snmp_icmp_in_dest_unreachs: Optional[float]` Number of ICMP Destination Unreachable messages received - `snmp_icmp_in_echo_reps: Optional[float]` Number of ICMP Echo Reply messages received - `snmp_icmp_in_echos: Optional[float]` Number of ICMP Echo (request) messages received - `snmp_icmp_in_errors: Optional[float]` Number of ICMP messages received with ICMP-specific errors - `snmp_icmp_in_msgs: Optional[float]` Number of ICMP messages received - `snmp_icmp_in_parm_probs: Optional[float]` Number of ICMP Parameter Problem messages received - `snmp_icmp_in_redirects: Optional[float]` Number of ICMP Redirect messages received - `snmp_icmp_in_src_quenchs: Optional[float]` Number of ICMP Source Quench messages received - `snmp_icmp_in_time_excds: Optional[float]` Number of ICMP Time Exceeded messages received - `snmp_icmp_in_timestamp_reps: Optional[float]` Number of ICMP Address Mask Request messages received - `snmp_icmp_in_timestamps: Optional[float]` Number of ICMP Timestamp (request) messages received - `snmp_icmp_out_addr_mask_reps: Optional[float]` Number of ICMP Address Mask Reply messages sent - `snmp_icmp_out_addr_masks: Optional[float]` Number of ICMP Address Mask Request messages sent - `snmp_icmp_out_dest_unreachs: Optional[float]` Number of ICMP Destination Unreachable messages sent - `snmp_icmp_out_echo_reps: Optional[float]` Number of ICMP Echo Reply messages sent - `snmp_icmp_out_echos: Optional[float]` Number of ICMP Echo (request) messages sent - `snmp_icmp_out_errors: Optional[float]` Number of ICMP messages which this entity did not send due to ICMP-specific errors - `snmp_icmp_out_msgs: Optional[float]` Number of ICMP messages attempted to send - `snmp_icmp_out_parm_probs: Optional[float]` Number of ICMP Parameter Problem messages sent - `snmp_icmp_out_redirects: Optional[float]` Number of ICMP Redirect messages sent - `snmp_icmp_out_src_quenchs: Optional[float]` Number of ICMP Source Quench messages sent - `snmp_icmp_out_time_excds: Optional[float]` Number of ICMP Time Exceeded messages sent - `snmp_icmp_out_timestamp_reps: Optional[float]` Number of ICMP Timestamp Reply messages sent - `snmp_icmp_out_timestamps: Optional[float]` Number of ICMP Timestamp (request) messages sent - `snmp_ip_default_ttl: Optional[float]` Default value of the Time-To-Live field of the IP header - `snmp_ip_forw_datagrams: Optional[float]` Number of datagrams forwarded to their final destination - `snmp_ip_forwarding_enabled: Optional[bool]` Set when acting as an IP gateway - `snmp_ip_frag_creates: Optional[float]` Number of datagrams generated by fragmentation - `snmp_ip_frag_fails: Optional[float]` Number of datagrams discarded because fragmentation failed - `snmp_ip_frag_oks: Optional[float]` Number of datagrams successfully fragmented - `snmp_ip_in_addr_errors: Optional[float]` Number of input datagrams discarded due to errors in the IP address - `snmp_ip_in_delivers: Optional[float]` Number of input datagrams successfully delivered to IP user-protocols - `snmp_ip_in_discards: Optional[float]` Number of input datagrams otherwise discarded - `snmp_ip_in_hdr_errors: Optional[float]` Number of input datagrams discarded due to errors in the IP header - `snmp_ip_in_receives: Optional[float]` Number of input datagrams received from interfaces - `snmp_ip_in_unknown_protos: Optional[float]` Number of input datagrams discarded due unknown or unsupported protocol - `snmp_ip_out_discards: Optional[float]` Number of output datagrams otherwise discarded - `snmp_ip_out_no_routes: Optional[float]` Number of output datagrams discarded because no route matched - `snmp_ip_out_requests: Optional[float]` Number of datagrams supplied for transmission - `snmp_ip_reasm_fails: Optional[float]` Number of failures detected by the reassembly algorithm - `snmp_ip_reasm_oks: Optional[float]` Number of datagrams successfully reassembled - `snmp_ip_reasm_reqds: Optional[float]` Number of fragments received which needed to be reassembled - `snmp_ip_reasm_timeout: Optional[float]` Number of seconds fragments are held while awaiting reassembly - `snmp_tcp_active_opens: Optional[float]` Number of times TCP transitions to SYN-SENT from CLOSED - `snmp_tcp_attempt_fails: Optional[float]` Number of times TCP transitions to CLOSED from SYN-SENT or SYN-RCVD, plus transitions to LISTEN from SYN-RCVD - `snmp_tcp_curr_estab: Optional[float]` Number of TCP connections in ESTABLISHED or CLOSE-WAIT - `snmp_tcp_estab_resets: Optional[float]` Number of times TCP transitions to CLOSED from ESTABLISHED or CLOSE-WAIT - `snmp_tcp_in_csum_errors: Optional[float]` Number of TCP segments received with checksum errors - `snmp_tcp_in_errs: Optional[float]` Number of TCP segments received in error - `snmp_tcp_in_segs: Optional[float]` Number of TCP segments received - `snmp_tcp_max_conn: Optional[float]` Limit on the total number of TCP connections - `snmp_tcp_out_rsts: Optional[float]` Number of TCP segments sent with RST flag - `snmp_tcp_out_segs: Optional[float]` Number of TCP segments sent - `snmp_tcp_passive_opens: Optional[float]` Number of times TCP transitions to SYN-RCVD from LISTEN - `snmp_tcp_retrans_segs: Optional[float]` Number of TCP segments retransmitted - `snmp_tcp_rto_max: Optional[float]` Maximum value permitted by a TCP implementation for the retransmission timeout (milliseconds) - `snmp_tcp_rto_min: Optional[float]` Minimum value permitted by a TCP implementation for the retransmission timeout (milliseconds) - `snmp_udp_in_datagrams: Optional[float]` Number of UDP datagrams delivered to UDP applications - `snmp_udp_in_errors: Optional[float]` Number of UDP datagrams failed to be delivered for reasons other than lack of application at the destination port - `snmp_udp_no_ports: Optional[float]` Number of UDP datagrams received for which there was not application at the destination port - `snmp_udp_out_datagrams: Optional[float]` Number of UDP datagrams sent - `system_boot_time_s: Optional[float]` Boottime of the system (seconds since the Unix epoch) - `thermals: Optional[List[Thermal]]` - `label: str` Sensor identifier for the component - `critical_celcius: Optional[float]` Critical failure temperature of the component (degrees Celsius) - `current_celcius: Optional[float]` Current temperature of the component (degrees Celsius) - `max_celcius: Optional[float]` Maximum temperature of the component (degrees Celsius) - `tunnels: Optional[List[Tunnel]]` - `health_state: str` Name of tunnel health state (unknown, healthy, degraded, down) - `health_value: float` Numeric value associated with tunnel state (0 = unknown, 1 = healthy, 2 = degraded, 3 = down) - `interface_name: str` The tunnel interface name (i.e. xfrm1, xfrm3.99, etc.) - `tunnel_id: str` Tunnel identifier - `probed_mtu: Optional[float]` MTU as measured between the two ends of the tunnel - `recent_healthy_pings: Optional[float]` Number of recent healthy pings for this tunnel - `recent_unhealthy_pings: Optional[float]` Number of recent unhealthy pings for this tunnel - `uptime_idle_ms: Optional[float]` Sum of how much time each core has spent idle - `uptime_total_ms: Optional[float]` Uptime of the system, including time spent in suspend # Latest ## Get latest Snapshots `magic_transit.connectors.snapshots.latest.list(strconnector_id, LatestListParams**kwargs) -> LatestListResponse` **get** `/accounts/{account_id}/magic/connectors/{connector_id}/telemetry/snapshots/latest` Get latest Snapshots ### Parameters - `account_id: str` Account identifier - `connector_id: str` ### Returns - `class LatestListResponse: …` - `count: float` - `items: List[Item]` - `count_reclaim_failures: float` Count of failures to reclaim space - `count_reclaimed_paths: float` Count of reclaimed paths - `count_record_failed: float` Count of failed snapshot recordings - `count_transmit_failures: float` Count of failed snapshot transmissions - `t: float` Time the Snapshot was recorded (seconds since the Unix epoch) - `v: str` Version - `bonds: Optional[List[ItemBond]]` - `name: str` Name of the network interface - `status: str` Current status of the network interface - `cpu_count: Optional[float]` Count of processors/cores - `cpu_pressure_10s: Optional[float]` Percentage of time over a 10 second window that tasks were stalled - `cpu_pressure_300s: Optional[float]` Percentage of time over a 5 minute window that tasks were stalled - `cpu_pressure_60s: Optional[float]` Percentage of time over a 1 minute window that tasks were stalled - `cpu_pressure_total_us: Optional[float]` Total stall time (microseconds) - `cpu_time_guest_ms: Optional[float]` Time spent running a virtual CPU or guest OS (milliseconds) - `cpu_time_guest_nice_ms: Optional[float]` Time spent running a niced guest (milliseconds) - `cpu_time_idle_ms: Optional[float]` Time spent in idle state (milliseconds) - `cpu_time_iowait_ms: Optional[float]` Time spent wait for I/O to complete (milliseconds) - `cpu_time_irq_ms: Optional[float]` Time spent servicing interrupts (milliseconds) - `cpu_time_nice_ms: Optional[float]` Time spent in low-priority user mode (milliseconds) - `cpu_time_softirq_ms: Optional[float]` Time spent servicing softirqs (milliseconds) - `cpu_time_steal_ms: Optional[float]` Time stolen (milliseconds) - `cpu_time_system_ms: Optional[float]` Time spent in system mode (milliseconds) - `cpu_time_user_ms: Optional[float]` Time spent in user mode (milliseconds) - `delta: Optional[float]` Number of network operations applied during state transition - `dhcp_leases: Optional[List[ItemDHCPLease]]` - `client_id: str` Client ID of the device the IP Address was leased to - `expiry_time: float` Expiry time of the DHCP lease (seconds since the Unix epoch) - `hostname: str` Hostname of the device the IP Address was leased to - `interface_name: str` Name of the network interface - `ip_address: str` IP Address that was leased - `mac_address: str` MAC Address of the device the IP Address was leased to - `disks: Optional[List[ItemDisk]]` - `in_progress: float` I/Os currently in progress - `major: float` Device major number - `merged: float` Reads merged - `minor: float` Device minor number - `name: str` Device name - `reads: float` Reads completed successfully - `sectors_read: float` Sectors read successfully - `sectors_written: float` Sectors written successfully - `time_in_progress_ms: float` Time spent doing I/Os (milliseconds) - `time_reading_ms: float` Time spent reading (milliseconds) - `time_writing_ms: float` Time spent writing (milliseconds) - `weighted_time_in_progress_ms: float` Weighted time spent doing I/Os (milliseconds) - `writes: float` Writes completed - `writes_merged: float` Writes merged - `discards: Optional[float]` Discards completed successfully - `discards_merged: Optional[float]` Discards merged - `flushes: Optional[float]` Flushes completed successfully - `sectors_discarded: Optional[float]` Sectors discarded - `time_discarding_ms: Optional[float]` Time spent discarding (milliseconds) - `time_flushing_ms: Optional[float]` Time spent flushing (milliseconds) - `epsilon: Optional[float]` Simulated number of network operations applied during state transition - `ha_state: Optional[str]` Name of high availability state - `ha_value: Optional[float]` Numeric value associated with high availability state (0 = disabled, 1 = active, 2 = standby, 3 = stopped, 4 = fault) - `interfaces: Optional[List[ItemInterface]]` - `name: str` Name of the network interface - `operstate: str` UP/DOWN state of the network interface - `ip_addresses: Optional[List[ItemInterfaceIPAddress]]` - `interface_name: str` Name of the network interface - `ip_address: str` IP address of the network interface - `speed: Optional[float]` Speed of the network interface (bits per second) - `io_pressure_full_10s: Optional[float]` Percentage of time over a 10 second window that all tasks were stalled - `io_pressure_full_300s: Optional[float]` Percentage of time over a 5 minute window that all tasks were stalled - `io_pressure_full_60s: Optional[float]` Percentage of time over a 1 minute window that all tasks were stalled - `io_pressure_full_total_us: Optional[float]` Total stall time (microseconds) - `io_pressure_some_10s: Optional[float]` Percentage of time over a 10 second window that some tasks were stalled - `io_pressure_some_300s: Optional[float]` Percentage of time over a 3 minute window that some tasks were stalled - `io_pressure_some_60s: Optional[float]` Percentage of time over a 1 minute window that some tasks were stalled - `io_pressure_some_total_us: Optional[float]` Total stall time (microseconds) - `kernel_btime: Optional[float]` Boot time (seconds since Unix epoch) - `kernel_ctxt: Optional[float]` Number of context switches that the system underwent - `kernel_processes: Optional[float]` Number of forks since boot - `kernel_processes_blocked: Optional[float]` Number of processes blocked waiting for I/O - `kernel_processes_running: Optional[float]` Number of processes in runnable state - `load_average_15m: Optional[float]` The fifteen-minute load average - `load_average_1m: Optional[float]` The one-minute load average - `load_average_5m: Optional[float]` The five-minute load average - `load_average_cur: Optional[float]` Number of currently runnable kernel scheduling entities - `load_average_max: Optional[float]` Number of kernel scheduling entities that currently exist on the system - `memory_active_bytes: Optional[float]` Memory that has been used more recently - `memory_anon_hugepages_bytes: Optional[float]` Non-file backed huge pages mapped into user-space page tables - `memory_anon_pages_bytes: Optional[float]` Non-file backed pages mapped into user-space page tables - `memory_available_bytes: Optional[float]` Estimate of how much memory is available for starting new applications - `memory_bounce_bytes: Optional[float]` Memory used for block device bounce buffers - `memory_buffers_bytes: Optional[float]` Relatively temporary storage for raw disk blocks - `memory_cached_bytes: Optional[float]` In-memory cache for files read from the disk - `memory_cma_free_bytes: Optional[float]` Free CMA (Contiguous Memory Allocator) pages - `memory_cma_total_bytes: Optional[float]` Total CMA (Contiguous Memory Allocator) pages - `memory_commit_limit_bytes: Optional[float]` Total amount of memory currently available to be allocated on the system - `memory_committed_as_bytes: Optional[float]` Amount of memory presently allocated on the system - `memory_dirty_bytes: Optional[float]` Memory which is waiting to get written back to the disk - `memory_free_bytes: Optional[float]` The sum of LowFree and HighFree - `memory_high_free_bytes: Optional[float]` Amount of free highmem - `memory_high_total_bytes: Optional[float]` Total amount of highmem - `memory_hugepages_free: Optional[float]` The number of huge pages in the pool that are not yet allocated - `memory_hugepages_rsvd: Optional[float]` Number of huge pages for which a commitment has been made, but no allocation has yet been made - `memory_hugepages_surp: Optional[float]` Number of huge pages in the pool above the threshold - `memory_hugepages_total: Optional[float]` The size of the pool of huge pages - `memory_hugepagesize_bytes: Optional[float]` The size of huge pages - `memory_inactive_bytes: Optional[float]` Memory which has been less recently used - `memory_k_reclaimable_bytes: Optional[float]` Kernel allocations that the kernel will attempt to reclaim under memory pressure - `memory_kernel_stack_bytes: Optional[float]` Amount of memory allocated to kernel stacks - `memory_low_free_bytes: Optional[float]` Amount of free lowmem - `memory_low_total_bytes: Optional[float]` Total amount of lowmem - `memory_mapped_bytes: Optional[float]` Files which have been mapped into memory - `memory_page_tables_bytes: Optional[float]` Amount of memory dedicated to the lowest level of page tables - `memory_per_cpu_bytes: Optional[float]` Memory allocated to the per-cpu alloctor used to back per-cpu allocations - `memory_pressure_full_10s: Optional[float]` Percentage of time over a 10 second window that all tasks were stalled - `memory_pressure_full_300s: Optional[float]` Percentage of time over a 5 minute window that all tasks were stalled - `memory_pressure_full_60s: Optional[float]` Percentage of time over a 1 minute window that all tasks were stalled - `memory_pressure_full_total_us: Optional[float]` Total stall time (microseconds) - `memory_pressure_some_10s: Optional[float]` Percentage of time over a 10 second window that some tasks were stalled - `memory_pressure_some_300s: Optional[float]` Percentage of time over a 5 minute window that some tasks were stalled - `memory_pressure_some_60s: Optional[float]` Percentage of time over a 1 minute window that some tasks were stalled - `memory_pressure_some_total_us: Optional[float]` Total stall time (microseconds) - `memory_s_reclaimable_bytes: Optional[float]` Part of slab that can be reclaimed on memory pressure - `memory_s_unreclaim_bytes: Optional[float]` Part of slab that cannot be reclaimed on memory pressure - `memory_secondary_page_tables_bytes: Optional[float]` Amount of memory dedicated to the lowest level of page tables - `memory_shmem_bytes: Optional[float]` Amount of memory consumed by tmpfs - `memory_shmem_hugepages_bytes: Optional[float]` Memory used by shmem and tmpfs, allocated with huge pages - `memory_shmem_pmd_mapped_bytes: Optional[float]` Shared memory mapped into user space with huge pages - `memory_slab_bytes: Optional[float]` In-kernel data structures cache - `memory_swap_cached_bytes: Optional[float]` Memory swapped out and back in while still in swap file - `memory_swap_free_bytes: Optional[float]` Amount of swap space that is currently unused - `memory_swap_total_bytes: Optional[float]` Total amount of swap space available - `memory_total_bytes: Optional[float]` Total usable RAM - `memory_vmalloc_chunk_bytes: Optional[float]` Largest contiguous block of vmalloc area which is free - `memory_vmalloc_total_bytes: Optional[float]` Total size of vmalloc memory area - `memory_vmalloc_used_bytes: Optional[float]` Amount of vmalloc area which is used - `memory_writeback_bytes: Optional[float]` Memory which is actively being written back to the disk - `memory_writeback_tmp_bytes: Optional[float]` Memory used by FUSE for temporary writeback buffers - `memory_z_swap_bytes: Optional[float]` Memory consumed by the zswap backend, compressed - `memory_z_swapped_bytes: Optional[float]` Amount of anonymous memory stored in zswap, uncompressed - `mounts: Optional[List[ItemMount]]` - `file_system: str` File system on disk (EXT4, NTFS, etc.) - `kind: str` Kind of disk (HDD, SSD, etc.) - `mount_point: str` Path where disk is mounted - `name: str` Name of the disk mount - `available_bytes: Optional[float]` Available disk size (bytes) - `is_read_only: Optional[bool]` Determines whether the disk is read-only - `is_removable: Optional[bool]` Determines whether the disk is removable - `total_bytes: Optional[float]` Total disk size (bytes) - `netdevs: Optional[List[ItemNetdev]]` - `name: str` Name of the network device - `recv_bytes: float` Total bytes received - `recv_compressed: float` Compressed packets received - `recv_drop: float` Packets dropped - `recv_errs: float` Bad packets received - `recv_fifo: float` FIFO overruns - `recv_frame: float` Frame alignment errors - `recv_multicast: float` Multicast packets received - `recv_packets: float` Total packets received - `sent_bytes: float` Total bytes transmitted - `sent_carrier: float` Number of packets not sent due to carrier errors - `sent_colls: float` Number of collisions - `sent_compressed: float` Number of compressed packets transmitted - `sent_drop: float` Number of packets dropped during transmission - `sent_errs: float` Number of transmission errors - `sent_fifo: float` FIFO overruns - `sent_packets: float` Total packets transmitted - `snmp_icmp_in_addr_mask_reps: Optional[float]` Number of ICMP Address Mask Reply messages received - `snmp_icmp_in_addr_masks: Optional[float]` Number of ICMP Address Mask Request messages received - `snmp_icmp_in_csum_errors: Optional[float]` Number of ICMP messages received with bad checksums - `snmp_icmp_in_dest_unreachs: Optional[float]` Number of ICMP Destination Unreachable messages received - `snmp_icmp_in_echo_reps: Optional[float]` Number of ICMP Echo Reply messages received - `snmp_icmp_in_echos: Optional[float]` Number of ICMP Echo (request) messages received - `snmp_icmp_in_errors: Optional[float]` Number of ICMP messages received with ICMP-specific errors - `snmp_icmp_in_msgs: Optional[float]` Number of ICMP messages received - `snmp_icmp_in_parm_probs: Optional[float]` Number of ICMP Parameter Problem messages received - `snmp_icmp_in_redirects: Optional[float]` Number of ICMP Redirect messages received - `snmp_icmp_in_src_quenchs: Optional[float]` Number of ICMP Source Quench messages received - `snmp_icmp_in_time_excds: Optional[float]` Number of ICMP Time Exceeded messages received - `snmp_icmp_in_timestamp_reps: Optional[float]` Number of ICMP Address Mask Request messages received - `snmp_icmp_in_timestamps: Optional[float]` Number of ICMP Timestamp (request) messages received - `snmp_icmp_out_addr_mask_reps: Optional[float]` Number of ICMP Address Mask Reply messages sent - `snmp_icmp_out_addr_masks: Optional[float]` Number of ICMP Address Mask Request messages sent - `snmp_icmp_out_dest_unreachs: Optional[float]` Number of ICMP Destination Unreachable messages sent - `snmp_icmp_out_echo_reps: Optional[float]` Number of ICMP Echo Reply messages sent - `snmp_icmp_out_echos: Optional[float]` Number of ICMP Echo (request) messages sent - `snmp_icmp_out_errors: Optional[float]` Number of ICMP messages which this entity did not send due to ICMP-specific errors - `snmp_icmp_out_msgs: Optional[float]` Number of ICMP messages attempted to send - `snmp_icmp_out_parm_probs: Optional[float]` Number of ICMP Parameter Problem messages sent - `snmp_icmp_out_redirects: Optional[float]` Number of ICMP Redirect messages sent - `snmp_icmp_out_src_quenchs: Optional[float]` Number of ICMP Source Quench messages sent - `snmp_icmp_out_time_excds: Optional[float]` Number of ICMP Time Exceeded messages sent - `snmp_icmp_out_timestamp_reps: Optional[float]` Number of ICMP Timestamp Reply messages sent - `snmp_icmp_out_timestamps: Optional[float]` Number of ICMP Timestamp (request) messages sent - `snmp_ip_default_ttl: Optional[float]` Default value of the Time-To-Live field of the IP header - `snmp_ip_forw_datagrams: Optional[float]` Number of datagrams forwarded to their final destination - `snmp_ip_forwarding_enabled: Optional[bool]` Set when acting as an IP gateway - `snmp_ip_frag_creates: Optional[float]` Number of datagrams generated by fragmentation - `snmp_ip_frag_fails: Optional[float]` Number of datagrams discarded because fragmentation failed - `snmp_ip_frag_oks: Optional[float]` Number of datagrams successfully fragmented - `snmp_ip_in_addr_errors: Optional[float]` Number of input datagrams discarded due to errors in the IP address - `snmp_ip_in_delivers: Optional[float]` Number of input datagrams successfully delivered to IP user-protocols - `snmp_ip_in_discards: Optional[float]` Number of input datagrams otherwise discarded - `snmp_ip_in_hdr_errors: Optional[float]` Number of input datagrams discarded due to errors in the IP header - `snmp_ip_in_receives: Optional[float]` Number of input datagrams received from interfaces - `snmp_ip_in_unknown_protos: Optional[float]` Number of input datagrams discarded due unknown or unsupported protocol - `snmp_ip_out_discards: Optional[float]` Number of output datagrams otherwise discarded - `snmp_ip_out_no_routes: Optional[float]` Number of output datagrams discarded because no route matched - `snmp_ip_out_requests: Optional[float]` Number of datagrams supplied for transmission - `snmp_ip_reasm_fails: Optional[float]` Number of failures detected by the reassembly algorithm - `snmp_ip_reasm_oks: Optional[float]` Number of datagrams successfully reassembled - `snmp_ip_reasm_reqds: Optional[float]` Number of fragments received which needed to be reassembled - `snmp_ip_reasm_timeout: Optional[float]` Number of seconds fragments are held while awaiting reassembly - `snmp_tcp_active_opens: Optional[float]` Number of times TCP transitions to SYN-SENT from CLOSED - `snmp_tcp_attempt_fails: Optional[float]` Number of times TCP transitions to CLOSED from SYN-SENT or SYN-RCVD, plus transitions to LISTEN from SYN-RCVD - `snmp_tcp_curr_estab: Optional[float]` Number of TCP connections in ESTABLISHED or CLOSE-WAIT - `snmp_tcp_estab_resets: Optional[float]` Number of times TCP transitions to CLOSED from ESTABLISHED or CLOSE-WAIT - `snmp_tcp_in_csum_errors: Optional[float]` Number of TCP segments received with checksum errors - `snmp_tcp_in_errs: Optional[float]` Number of TCP segments received in error - `snmp_tcp_in_segs: Optional[float]` Number of TCP segments received - `snmp_tcp_max_conn: Optional[float]` Limit on the total number of TCP connections - `snmp_tcp_out_rsts: Optional[float]` Number of TCP segments sent with RST flag - `snmp_tcp_out_segs: Optional[float]` Number of TCP segments sent - `snmp_tcp_passive_opens: Optional[float]` Number of times TCP transitions to SYN-RCVD from LISTEN - `snmp_tcp_retrans_segs: Optional[float]` Number of TCP segments retransmitted - `snmp_tcp_rto_max: Optional[float]` Maximum value permitted by a TCP implementation for the retransmission timeout (milliseconds) - `snmp_tcp_rto_min: Optional[float]` Minimum value permitted by a TCP implementation for the retransmission timeout (milliseconds) - `snmp_udp_in_datagrams: Optional[float]` Number of UDP datagrams delivered to UDP applications - `snmp_udp_in_errors: Optional[float]` Number of UDP datagrams failed to be delivered for reasons other than lack of application at the destination port - `snmp_udp_no_ports: Optional[float]` Number of UDP datagrams received for which there was not application at the destination port - `snmp_udp_out_datagrams: Optional[float]` Number of UDP datagrams sent - `system_boot_time_s: Optional[float]` Boottime of the system (seconds since the Unix epoch) - `thermals: Optional[List[ItemThermal]]` - `label: str` Sensor identifier for the component - `critical_celcius: Optional[float]` Critical failure temperature of the component (degrees Celsius) - `current_celcius: Optional[float]` Current temperature of the component (degrees Celsius) - `max_celcius: Optional[float]` Maximum temperature of the component (degrees Celsius) - `tunnels: Optional[List[ItemTunnel]]` - `health_state: str` Name of tunnel health state (unknown, healthy, degraded, down) - `health_value: float` Numeric value associated with tunnel state (0 = unknown, 1 = healthy, 2 = degraded, 3 = down) - `interface_name: str` The tunnel interface name (i.e. xfrm1, xfrm3.99, etc.) - `tunnel_id: str` Tunnel identifier - `probed_mtu: Optional[float]` MTU as measured between the two ends of the tunnel - `recent_healthy_pings: Optional[float]` Number of recent healthy pings for this tunnel - `recent_unhealthy_pings: Optional[float]` Number of recent unhealthy pings for this tunnel - `uptime_idle_ms: Optional[float]` Sum of how much time each core has spent idle - `uptime_total_ms: Optional[float]` Uptime of the system, including time spent in suspend ### Example ```python import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) latests = client.magic_transit.connectors.snapshots.latest.list( connector_id="connector_id", account_id="023e105f4ecef8ad9ca31a8372d0c353", ) print(latests.count) ``` #### Response ```json { "result": { "count": 0, "items": [ { "count_reclaim_failures": 0, "count_reclaimed_paths": 0, "count_record_failed": 0, "count_transmit_failures": 0, "t": 0, "v": "v", "bonds": [ { "name": "name", "status": "status" } ], "cpu_count": 0, "cpu_pressure_10s": 0, "cpu_pressure_300s": 0, "cpu_pressure_60s": 0, "cpu_pressure_total_us": 0, "cpu_time_guest_ms": 0, "cpu_time_guest_nice_ms": 0, "cpu_time_idle_ms": 0, "cpu_time_iowait_ms": 0, "cpu_time_irq_ms": 0, "cpu_time_nice_ms": 0, "cpu_time_softirq_ms": 0, "cpu_time_steal_ms": 0, "cpu_time_system_ms": 0, "cpu_time_user_ms": 0, "delta": 0, "dhcp_leases": [ { "client_id": "client_id", "expiry_time": 0, "hostname": "hostname", "interface_name": "interface_name", "ip_address": "ip_address", "mac_address": "mac_address" } ], "disks": [ { "in_progress": 0, "major": 0, "merged": 0, "minor": 0, "name": "name", "reads": 0, "sectors_read": 0, "sectors_written": 0, "time_in_progress_ms": 0, "time_reading_ms": 0, "time_writing_ms": 0, "weighted_time_in_progress_ms": 0, "writes": 0, "writes_merged": 0, "discards": 0, "discards_merged": 0, "flushes": 0, "sectors_discarded": 0, "time_discarding_ms": 0, "time_flushing_ms": 0 } ], "epsilon": 0, "ha_state": "ha_state", "ha_value": 0, "interfaces": [ { "name": "name", "operstate": "operstate", "ip_addresses": [ { "interface_name": "interface_name", "ip_address": "ip_address" } ], "speed": 0 } ], "io_pressure_full_10s": 0, "io_pressure_full_300s": 0, "io_pressure_full_60s": 0, "io_pressure_full_total_us": 0, "io_pressure_some_10s": 0, "io_pressure_some_300s": 0, "io_pressure_some_60s": 0, "io_pressure_some_total_us": 0, "kernel_btime": 0, "kernel_ctxt": 0, "kernel_processes": 0, "kernel_processes_blocked": 0, "kernel_processes_running": 0, "load_average_15m": 0, "load_average_1m": 0, "load_average_5m": 0, "load_average_cur": 0, "load_average_max": 0, "memory_active_bytes": 0, "memory_anon_hugepages_bytes": 0, "memory_anon_pages_bytes": 0, "memory_available_bytes": 0, "memory_bounce_bytes": 0, "memory_buffers_bytes": 0, "memory_cached_bytes": 0, "memory_cma_free_bytes": 0, "memory_cma_total_bytes": 0, "memory_commit_limit_bytes": 0, "memory_committed_as_bytes": 0, "memory_dirty_bytes": 0, "memory_free_bytes": 0, "memory_high_free_bytes": 0, "memory_high_total_bytes": 0, "memory_hugepages_free": 0, "memory_hugepages_rsvd": 0, "memory_hugepages_surp": 0, "memory_hugepages_total": 0, "memory_hugepagesize_bytes": 0, "memory_inactive_bytes": 0, "memory_k_reclaimable_bytes": 0, "memory_kernel_stack_bytes": 0, "memory_low_free_bytes": 0, "memory_low_total_bytes": 0, "memory_mapped_bytes": 0, "memory_page_tables_bytes": 0, "memory_per_cpu_bytes": 0, "memory_pressure_full_10s": 0, "memory_pressure_full_300s": 0, "memory_pressure_full_60s": 0, "memory_pressure_full_total_us": 0, "memory_pressure_some_10s": 0, "memory_pressure_some_300s": 0, "memory_pressure_some_60s": 0, "memory_pressure_some_total_us": 0, "memory_s_reclaimable_bytes": 0, "memory_s_unreclaim_bytes": 0, "memory_secondary_page_tables_bytes": 0, "memory_shmem_bytes": 0, "memory_shmem_hugepages_bytes": 0, "memory_shmem_pmd_mapped_bytes": 0, "memory_slab_bytes": 0, "memory_swap_cached_bytes": 0, "memory_swap_free_bytes": 0, "memory_swap_total_bytes": 0, "memory_total_bytes": 0, "memory_vmalloc_chunk_bytes": 0, "memory_vmalloc_total_bytes": 0, "memory_vmalloc_used_bytes": 0, "memory_writeback_bytes": 0, "memory_writeback_tmp_bytes": 0, "memory_z_swap_bytes": 0, "memory_z_swapped_bytes": 0, "mounts": [ { "file_system": "file_system", "kind": "kind", "mount_point": "mount_point", "name": "name", "available_bytes": 0, "is_read_only": true, "is_removable": true, "total_bytes": 0 } ], "netdevs": [ { "name": "name", "recv_bytes": 0, "recv_compressed": 0, "recv_drop": 0, "recv_errs": 0, "recv_fifo": 0, "recv_frame": 0, "recv_multicast": 0, "recv_packets": 0, "sent_bytes": 0, "sent_carrier": 0, "sent_colls": 0, "sent_compressed": 0, "sent_drop": 0, "sent_errs": 0, "sent_fifo": 0, "sent_packets": 0 } ], "snmp_icmp_in_addr_mask_reps": 0, "snmp_icmp_in_addr_masks": 0, "snmp_icmp_in_csum_errors": 0, "snmp_icmp_in_dest_unreachs": 0, "snmp_icmp_in_echo_reps": 0, "snmp_icmp_in_echos": 0, "snmp_icmp_in_errors": 0, "snmp_icmp_in_msgs": 0, "snmp_icmp_in_parm_probs": 0, "snmp_icmp_in_redirects": 0, "snmp_icmp_in_src_quenchs": 0, "snmp_icmp_in_time_excds": 0, "snmp_icmp_in_timestamp_reps": 0, "snmp_icmp_in_timestamps": 0, "snmp_icmp_out_addr_mask_reps": 0, "snmp_icmp_out_addr_masks": 0, "snmp_icmp_out_dest_unreachs": 0, "snmp_icmp_out_echo_reps": 0, "snmp_icmp_out_echos": 0, "snmp_icmp_out_errors": 0, "snmp_icmp_out_msgs": 0, "snmp_icmp_out_parm_probs": 0, "snmp_icmp_out_redirects": 0, "snmp_icmp_out_src_quenchs": 0, "snmp_icmp_out_time_excds": 0, "snmp_icmp_out_timestamp_reps": 0, "snmp_icmp_out_timestamps": 0, "snmp_ip_default_ttl": 0, "snmp_ip_forw_datagrams": 0, "snmp_ip_forwarding_enabled": true, "snmp_ip_frag_creates": 0, "snmp_ip_frag_fails": 0, "snmp_ip_frag_oks": 0, "snmp_ip_in_addr_errors": 0, "snmp_ip_in_delivers": 0, "snmp_ip_in_discards": 0, "snmp_ip_in_hdr_errors": 0, "snmp_ip_in_receives": 0, "snmp_ip_in_unknown_protos": 0, "snmp_ip_out_discards": 0, "snmp_ip_out_no_routes": 0, "snmp_ip_out_requests": 0, "snmp_ip_reasm_fails": 0, "snmp_ip_reasm_oks": 0, "snmp_ip_reasm_reqds": 0, "snmp_ip_reasm_timeout": 0, "snmp_tcp_active_opens": 0, "snmp_tcp_attempt_fails": 0, "snmp_tcp_curr_estab": 0, "snmp_tcp_estab_resets": 0, "snmp_tcp_in_csum_errors": 0, "snmp_tcp_in_errs": 0, "snmp_tcp_in_segs": 0, "snmp_tcp_max_conn": 0, "snmp_tcp_out_rsts": 0, "snmp_tcp_out_segs": 0, "snmp_tcp_passive_opens": 0, "snmp_tcp_retrans_segs": 0, "snmp_tcp_rto_max": 0, "snmp_tcp_rto_min": 0, "snmp_udp_in_datagrams": 0, "snmp_udp_in_errors": 0, "snmp_udp_no_ports": 0, "snmp_udp_out_datagrams": 0, "system_boot_time_s": 0, "thermals": [ { "label": "label", "critical_celcius": 0, "current_celcius": 0, "max_celcius": 0 } ], "tunnels": [ { "health_state": "health_state", "health_value": 0, "interface_name": "interface_name", "tunnel_id": "tunnel_id", "probed_mtu": 0, "recent_healthy_pings": 0, "recent_unhealthy_pings": 0 } ], "uptime_idle_ms": 0, "uptime_total_ms": 0 } ] }, "success": true, "errors": [ { "code": 0, "message": "message" } ], "messages": [ { "code": 0, "message": "message" } ] } ``` ## Domain Types ### Latest List Response - `class LatestListResponse: …` - `count: float` - `items: List[Item]` - `count_reclaim_failures: float` Count of failures to reclaim space - `count_reclaimed_paths: float` Count of reclaimed paths - `count_record_failed: float` Count of failed snapshot recordings - `count_transmit_failures: float` Count of failed snapshot transmissions - `t: float` Time the Snapshot was recorded (seconds since the Unix epoch) - `v: str` Version - `bonds: Optional[List[ItemBond]]` - `name: str` Name of the network interface - `status: str` Current status of the network interface - `cpu_count: Optional[float]` Count of processors/cores - `cpu_pressure_10s: Optional[float]` Percentage of time over a 10 second window that tasks were stalled - `cpu_pressure_300s: Optional[float]` Percentage of time over a 5 minute window that tasks were stalled - `cpu_pressure_60s: Optional[float]` Percentage of time over a 1 minute window that tasks were stalled - `cpu_pressure_total_us: Optional[float]` Total stall time (microseconds) - `cpu_time_guest_ms: Optional[float]` Time spent running a virtual CPU or guest OS (milliseconds) - `cpu_time_guest_nice_ms: Optional[float]` Time spent running a niced guest (milliseconds) - `cpu_time_idle_ms: Optional[float]` Time spent in idle state (milliseconds) - `cpu_time_iowait_ms: Optional[float]` Time spent wait for I/O to complete (milliseconds) - `cpu_time_irq_ms: Optional[float]` Time spent servicing interrupts (milliseconds) - `cpu_time_nice_ms: Optional[float]` Time spent in low-priority user mode (milliseconds) - `cpu_time_softirq_ms: Optional[float]` Time spent servicing softirqs (milliseconds) - `cpu_time_steal_ms: Optional[float]` Time stolen (milliseconds) - `cpu_time_system_ms: Optional[float]` Time spent in system mode (milliseconds) - `cpu_time_user_ms: Optional[float]` Time spent in user mode (milliseconds) - `delta: Optional[float]` Number of network operations applied during state transition - `dhcp_leases: Optional[List[ItemDHCPLease]]` - `client_id: str` Client ID of the device the IP Address was leased to - `expiry_time: float` Expiry time of the DHCP lease (seconds since the Unix epoch) - `hostname: str` Hostname of the device the IP Address was leased to - `interface_name: str` Name of the network interface - `ip_address: str` IP Address that was leased - `mac_address: str` MAC Address of the device the IP Address was leased to - `disks: Optional[List[ItemDisk]]` - `in_progress: float` I/Os currently in progress - `major: float` Device major number - `merged: float` Reads merged - `minor: float` Device minor number - `name: str` Device name - `reads: float` Reads completed successfully - `sectors_read: float` Sectors read successfully - `sectors_written: float` Sectors written successfully - `time_in_progress_ms: float` Time spent doing I/Os (milliseconds) - `time_reading_ms: float` Time spent reading (milliseconds) - `time_writing_ms: float` Time spent writing (milliseconds) - `weighted_time_in_progress_ms: float` Weighted time spent doing I/Os (milliseconds) - `writes: float` Writes completed - `writes_merged: float` Writes merged - `discards: Optional[float]` Discards completed successfully - `discards_merged: Optional[float]` Discards merged - `flushes: Optional[float]` Flushes completed successfully - `sectors_discarded: Optional[float]` Sectors discarded - `time_discarding_ms: Optional[float]` Time spent discarding (milliseconds) - `time_flushing_ms: Optional[float]` Time spent flushing (milliseconds) - `epsilon: Optional[float]` Simulated number of network operations applied during state transition - `ha_state: Optional[str]` Name of high availability state - `ha_value: Optional[float]` Numeric value associated with high availability state (0 = disabled, 1 = active, 2 = standby, 3 = stopped, 4 = fault) - `interfaces: Optional[List[ItemInterface]]` - `name: str` Name of the network interface - `operstate: str` UP/DOWN state of the network interface - `ip_addresses: Optional[List[ItemInterfaceIPAddress]]` - `interface_name: str` Name of the network interface - `ip_address: str` IP address of the network interface - `speed: Optional[float]` Speed of the network interface (bits per second) - `io_pressure_full_10s: Optional[float]` Percentage of time over a 10 second window that all tasks were stalled - `io_pressure_full_300s: Optional[float]` Percentage of time over a 5 minute window that all tasks were stalled - `io_pressure_full_60s: Optional[float]` Percentage of time over a 1 minute window that all tasks were stalled - `io_pressure_full_total_us: Optional[float]` Total stall time (microseconds) - `io_pressure_some_10s: Optional[float]` Percentage of time over a 10 second window that some tasks were stalled - `io_pressure_some_300s: Optional[float]` Percentage of time over a 3 minute window that some tasks were stalled - `io_pressure_some_60s: Optional[float]` Percentage of time over a 1 minute window that some tasks were stalled - `io_pressure_some_total_us: Optional[float]` Total stall time (microseconds) - `kernel_btime: Optional[float]` Boot time (seconds since Unix epoch) - `kernel_ctxt: Optional[float]` Number of context switches that the system underwent - `kernel_processes: Optional[float]` Number of forks since boot - `kernel_processes_blocked: Optional[float]` Number of processes blocked waiting for I/O - `kernel_processes_running: Optional[float]` Number of processes in runnable state - `load_average_15m: Optional[float]` The fifteen-minute load average - `load_average_1m: Optional[float]` The one-minute load average - `load_average_5m: Optional[float]` The five-minute load average - `load_average_cur: Optional[float]` Number of currently runnable kernel scheduling entities - `load_average_max: Optional[float]` Number of kernel scheduling entities that currently exist on the system - `memory_active_bytes: Optional[float]` Memory that has been used more recently - `memory_anon_hugepages_bytes: Optional[float]` Non-file backed huge pages mapped into user-space page tables - `memory_anon_pages_bytes: Optional[float]` Non-file backed pages mapped into user-space page tables - `memory_available_bytes: Optional[float]` Estimate of how much memory is available for starting new applications - `memory_bounce_bytes: Optional[float]` Memory used for block device bounce buffers - `memory_buffers_bytes: Optional[float]` Relatively temporary storage for raw disk blocks - `memory_cached_bytes: Optional[float]` In-memory cache for files read from the disk - `memory_cma_free_bytes: Optional[float]` Free CMA (Contiguous Memory Allocator) pages - `memory_cma_total_bytes: Optional[float]` Total CMA (Contiguous Memory Allocator) pages - `memory_commit_limit_bytes: Optional[float]` Total amount of memory currently available to be allocated on the system - `memory_committed_as_bytes: Optional[float]` Amount of memory presently allocated on the system - `memory_dirty_bytes: Optional[float]` Memory which is waiting to get written back to the disk - `memory_free_bytes: Optional[float]` The sum of LowFree and HighFree - `memory_high_free_bytes: Optional[float]` Amount of free highmem - `memory_high_total_bytes: Optional[float]` Total amount of highmem - `memory_hugepages_free: Optional[float]` The number of huge pages in the pool that are not yet allocated - `memory_hugepages_rsvd: Optional[float]` Number of huge pages for which a commitment has been made, but no allocation has yet been made - `memory_hugepages_surp: Optional[float]` Number of huge pages in the pool above the threshold - `memory_hugepages_total: Optional[float]` The size of the pool of huge pages - `memory_hugepagesize_bytes: Optional[float]` The size of huge pages - `memory_inactive_bytes: Optional[float]` Memory which has been less recently used - `memory_k_reclaimable_bytes: Optional[float]` Kernel allocations that the kernel will attempt to reclaim under memory pressure - `memory_kernel_stack_bytes: Optional[float]` Amount of memory allocated to kernel stacks - `memory_low_free_bytes: Optional[float]` Amount of free lowmem - `memory_low_total_bytes: Optional[float]` Total amount of lowmem - `memory_mapped_bytes: Optional[float]` Files which have been mapped into memory - `memory_page_tables_bytes: Optional[float]` Amount of memory dedicated to the lowest level of page tables - `memory_per_cpu_bytes: Optional[float]` Memory allocated to the per-cpu alloctor used to back per-cpu allocations - `memory_pressure_full_10s: Optional[float]` Percentage of time over a 10 second window that all tasks were stalled - `memory_pressure_full_300s: Optional[float]` Percentage of time over a 5 minute window that all tasks were stalled - `memory_pressure_full_60s: Optional[float]` Percentage of time over a 1 minute window that all tasks were stalled - `memory_pressure_full_total_us: Optional[float]` Total stall time (microseconds) - `memory_pressure_some_10s: Optional[float]` Percentage of time over a 10 second window that some tasks were stalled - `memory_pressure_some_300s: Optional[float]` Percentage of time over a 5 minute window that some tasks were stalled - `memory_pressure_some_60s: Optional[float]` Percentage of time over a 1 minute window that some tasks were stalled - `memory_pressure_some_total_us: Optional[float]` Total stall time (microseconds) - `memory_s_reclaimable_bytes: Optional[float]` Part of slab that can be reclaimed on memory pressure - `memory_s_unreclaim_bytes: Optional[float]` Part of slab that cannot be reclaimed on memory pressure - `memory_secondary_page_tables_bytes: Optional[float]` Amount of memory dedicated to the lowest level of page tables - `memory_shmem_bytes: Optional[float]` Amount of memory consumed by tmpfs - `memory_shmem_hugepages_bytes: Optional[float]` Memory used by shmem and tmpfs, allocated with huge pages - `memory_shmem_pmd_mapped_bytes: Optional[float]` Shared memory mapped into user space with huge pages - `memory_slab_bytes: Optional[float]` In-kernel data structures cache - `memory_swap_cached_bytes: Optional[float]` Memory swapped out and back in while still in swap file - `memory_swap_free_bytes: Optional[float]` Amount of swap space that is currently unused - `memory_swap_total_bytes: Optional[float]` Total amount of swap space available - `memory_total_bytes: Optional[float]` Total usable RAM - `memory_vmalloc_chunk_bytes: Optional[float]` Largest contiguous block of vmalloc area which is free - `memory_vmalloc_total_bytes: Optional[float]` Total size of vmalloc memory area - `memory_vmalloc_used_bytes: Optional[float]` Amount of vmalloc area which is used - `memory_writeback_bytes: Optional[float]` Memory which is actively being written back to the disk - `memory_writeback_tmp_bytes: Optional[float]` Memory used by FUSE for temporary writeback buffers - `memory_z_swap_bytes: Optional[float]` Memory consumed by the zswap backend, compressed - `memory_z_swapped_bytes: Optional[float]` Amount of anonymous memory stored in zswap, uncompressed - `mounts: Optional[List[ItemMount]]` - `file_system: str` File system on disk (EXT4, NTFS, etc.) - `kind: str` Kind of disk (HDD, SSD, etc.) - `mount_point: str` Path where disk is mounted - `name: str` Name of the disk mount - `available_bytes: Optional[float]` Available disk size (bytes) - `is_read_only: Optional[bool]` Determines whether the disk is read-only - `is_removable: Optional[bool]` Determines whether the disk is removable - `total_bytes: Optional[float]` Total disk size (bytes) - `netdevs: Optional[List[ItemNetdev]]` - `name: str` Name of the network device - `recv_bytes: float` Total bytes received - `recv_compressed: float` Compressed packets received - `recv_drop: float` Packets dropped - `recv_errs: float` Bad packets received - `recv_fifo: float` FIFO overruns - `recv_frame: float` Frame alignment errors - `recv_multicast: float` Multicast packets received - `recv_packets: float` Total packets received - `sent_bytes: float` Total bytes transmitted - `sent_carrier: float` Number of packets not sent due to carrier errors - `sent_colls: float` Number of collisions - `sent_compressed: float` Number of compressed packets transmitted - `sent_drop: float` Number of packets dropped during transmission - `sent_errs: float` Number of transmission errors - `sent_fifo: float` FIFO overruns - `sent_packets: float` Total packets transmitted - `snmp_icmp_in_addr_mask_reps: Optional[float]` Number of ICMP Address Mask Reply messages received - `snmp_icmp_in_addr_masks: Optional[float]` Number of ICMP Address Mask Request messages received - `snmp_icmp_in_csum_errors: Optional[float]` Number of ICMP messages received with bad checksums - `snmp_icmp_in_dest_unreachs: Optional[float]` Number of ICMP Destination Unreachable messages received - `snmp_icmp_in_echo_reps: Optional[float]` Number of ICMP Echo Reply messages received - `snmp_icmp_in_echos: Optional[float]` Number of ICMP Echo (request) messages received - `snmp_icmp_in_errors: Optional[float]` Number of ICMP messages received with ICMP-specific errors - `snmp_icmp_in_msgs: Optional[float]` Number of ICMP messages received - `snmp_icmp_in_parm_probs: Optional[float]` Number of ICMP Parameter Problem messages received - `snmp_icmp_in_redirects: Optional[float]` Number of ICMP Redirect messages received - `snmp_icmp_in_src_quenchs: Optional[float]` Number of ICMP Source Quench messages received - `snmp_icmp_in_time_excds: Optional[float]` Number of ICMP Time Exceeded messages received - `snmp_icmp_in_timestamp_reps: Optional[float]` Number of ICMP Address Mask Request messages received - `snmp_icmp_in_timestamps: Optional[float]` Number of ICMP Timestamp (request) messages received - `snmp_icmp_out_addr_mask_reps: Optional[float]` Number of ICMP Address Mask Reply messages sent - `snmp_icmp_out_addr_masks: Optional[float]` Number of ICMP Address Mask Request messages sent - `snmp_icmp_out_dest_unreachs: Optional[float]` Number of ICMP Destination Unreachable messages sent - `snmp_icmp_out_echo_reps: Optional[float]` Number of ICMP Echo Reply messages sent - `snmp_icmp_out_echos: Optional[float]` Number of ICMP Echo (request) messages sent - `snmp_icmp_out_errors: Optional[float]` Number of ICMP messages which this entity did not send due to ICMP-specific errors - `snmp_icmp_out_msgs: Optional[float]` Number of ICMP messages attempted to send - `snmp_icmp_out_parm_probs: Optional[float]` Number of ICMP Parameter Problem messages sent - `snmp_icmp_out_redirects: Optional[float]` Number of ICMP Redirect messages sent - `snmp_icmp_out_src_quenchs: Optional[float]` Number of ICMP Source Quench messages sent - `snmp_icmp_out_time_excds: Optional[float]` Number of ICMP Time Exceeded messages sent - `snmp_icmp_out_timestamp_reps: Optional[float]` Number of ICMP Timestamp Reply messages sent - `snmp_icmp_out_timestamps: Optional[float]` Number of ICMP Timestamp (request) messages sent - `snmp_ip_default_ttl: Optional[float]` Default value of the Time-To-Live field of the IP header - `snmp_ip_forw_datagrams: Optional[float]` Number of datagrams forwarded to their final destination - `snmp_ip_forwarding_enabled: Optional[bool]` Set when acting as an IP gateway - `snmp_ip_frag_creates: Optional[float]` Number of datagrams generated by fragmentation - `snmp_ip_frag_fails: Optional[float]` Number of datagrams discarded because fragmentation failed - `snmp_ip_frag_oks: Optional[float]` Number of datagrams successfully fragmented - `snmp_ip_in_addr_errors: Optional[float]` Number of input datagrams discarded due to errors in the IP address - `snmp_ip_in_delivers: Optional[float]` Number of input datagrams successfully delivered to IP user-protocols - `snmp_ip_in_discards: Optional[float]` Number of input datagrams otherwise discarded - `snmp_ip_in_hdr_errors: Optional[float]` Number of input datagrams discarded due to errors in the IP header - `snmp_ip_in_receives: Optional[float]` Number of input datagrams received from interfaces - `snmp_ip_in_unknown_protos: Optional[float]` Number of input datagrams discarded due unknown or unsupported protocol - `snmp_ip_out_discards: Optional[float]` Number of output datagrams otherwise discarded - `snmp_ip_out_no_routes: Optional[float]` Number of output datagrams discarded because no route matched - `snmp_ip_out_requests: Optional[float]` Number of datagrams supplied for transmission - `snmp_ip_reasm_fails: Optional[float]` Number of failures detected by the reassembly algorithm - `snmp_ip_reasm_oks: Optional[float]` Number of datagrams successfully reassembled - `snmp_ip_reasm_reqds: Optional[float]` Number of fragments received which needed to be reassembled - `snmp_ip_reasm_timeout: Optional[float]` Number of seconds fragments are held while awaiting reassembly - `snmp_tcp_active_opens: Optional[float]` Number of times TCP transitions to SYN-SENT from CLOSED - `snmp_tcp_attempt_fails: Optional[float]` Number of times TCP transitions to CLOSED from SYN-SENT or SYN-RCVD, plus transitions to LISTEN from SYN-RCVD - `snmp_tcp_curr_estab: Optional[float]` Number of TCP connections in ESTABLISHED or CLOSE-WAIT - `snmp_tcp_estab_resets: Optional[float]` Number of times TCP transitions to CLOSED from ESTABLISHED or CLOSE-WAIT - `snmp_tcp_in_csum_errors: Optional[float]` Number of TCP segments received with checksum errors - `snmp_tcp_in_errs: Optional[float]` Number of TCP segments received in error - `snmp_tcp_in_segs: Optional[float]` Number of TCP segments received - `snmp_tcp_max_conn: Optional[float]` Limit on the total number of TCP connections - `snmp_tcp_out_rsts: Optional[float]` Number of TCP segments sent with RST flag - `snmp_tcp_out_segs: Optional[float]` Number of TCP segments sent - `snmp_tcp_passive_opens: Optional[float]` Number of times TCP transitions to SYN-RCVD from LISTEN - `snmp_tcp_retrans_segs: Optional[float]` Number of TCP segments retransmitted - `snmp_tcp_rto_max: Optional[float]` Maximum value permitted by a TCP implementation for the retransmission timeout (milliseconds) - `snmp_tcp_rto_min: Optional[float]` Minimum value permitted by a TCP implementation for the retransmission timeout (milliseconds) - `snmp_udp_in_datagrams: Optional[float]` Number of UDP datagrams delivered to UDP applications - `snmp_udp_in_errors: Optional[float]` Number of UDP datagrams failed to be delivered for reasons other than lack of application at the destination port - `snmp_udp_no_ports: Optional[float]` Number of UDP datagrams received for which there was not application at the destination port - `snmp_udp_out_datagrams: Optional[float]` Number of UDP datagrams sent - `system_boot_time_s: Optional[float]` Boottime of the system (seconds since the Unix epoch) - `thermals: Optional[List[ItemThermal]]` - `label: str` Sensor identifier for the component - `critical_celcius: Optional[float]` Critical failure temperature of the component (degrees Celsius) - `current_celcius: Optional[float]` Current temperature of the component (degrees Celsius) - `max_celcius: Optional[float]` Maximum temperature of the component (degrees Celsius) - `tunnels: Optional[List[ItemTunnel]]` - `health_state: str` Name of tunnel health state (unknown, healthy, degraded, down) - `health_value: float` Numeric value associated with tunnel state (0 = unknown, 1 = healthy, 2 = degraded, 3 = down) - `interface_name: str` The tunnel interface name (i.e. xfrm1, xfrm3.99, etc.) - `tunnel_id: str` Tunnel identifier - `probed_mtu: Optional[float]` MTU as measured between the two ends of the tunnel - `recent_healthy_pings: Optional[float]` Number of recent healthy pings for this tunnel - `recent_unhealthy_pings: Optional[float]` Number of recent unhealthy pings for this tunnel - `uptime_idle_ms: Optional[float]` Sum of how much time each core has spent idle - `uptime_total_ms: Optional[float]` Uptime of the system, including time spent in suspend