Get Snapshot
GET/accounts/{account_id}/magic/connectors/{connector_id}/telemetry/snapshots/{snapshot_t}
Get Snapshot
Security
API Token
The preferred authorization scheme for interacting with the Cloudflare API. Create a token.
Example:
API Email + API Key
The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key.
Example:
The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys.
Example:
Accepted Permissions (at least one required)
Path Parameters
Get Snapshot
curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/magic/connectors/$CONNECTOR_ID/telemetry/snapshots/$SNAPSHOT_T \
-H "Authorization: Bearer $CLOUDFLARE_API_TOKEN"{
"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",
"connector_id": "connector_id"
}
],
"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,
"connector_id": "connector_id",
"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",
"connector_id": "connector_id",
"ip_addresses": [
{
"interface_name": "interface_name",
"ip_address": "ip_address",
"connector_id": "connector_id"
}
],
"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,
"connector_id": "connector_id",
"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,
"connector_id": "connector_id"
}
],
"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",
"connector_id": "connector_id",
"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",
"connector_id": "connector_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"
}
]
}Returns Examples
{
"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",
"connector_id": "connector_id"
}
],
"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,
"connector_id": "connector_id",
"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",
"connector_id": "connector_id",
"ip_addresses": [
{
"interface_name": "interface_name",
"ip_address": "ip_address",
"connector_id": "connector_id"
}
],
"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,
"connector_id": "connector_id",
"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,
"connector_id": "connector_id"
}
],
"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",
"connector_id": "connector_id",
"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",
"connector_id": "connector_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"
}
]
}