TrueNAS API: Полное руководство по автоматизации и интеграции

1. Система → API Keys → Добавить
2. Укажи имя ключа (например, "ansible-automation")
3. Скопируй сгенерированный токен — он покажется только один раз!

curl -X GET \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  https://your-truenas-ip/api/v2.0/system/version \
  -k

import requests
import json

class TrueNASClient:
    def __init__(self, host, api_key):
        self.base_url = f"https://{host}/api/v2.0"
        self.headers = {
            "Authorization": f"Bearer {api_key}",
            "Content-Type": "application/json"
        }
        self.session = requests.Session()
        self.session.headers.update(self.headers)
        self.session.verify = False  # Отключаем для самоподписанных сертов
        
    def get_system_info(self):
        """Получаем информацию о системе"""
        response = self.session.get(f"{self.base_url}/system/info")
        return response.json()
    
    def get_pool_health(self):
        """Проверяем состояние всех пулов"""
        response = self.session.get(f"{self.base_url}/pool")
        pools = response.json()
        
        health_status = []
        for pool in pools:
            pool_response = self.session.get(f"{self.base_url}/pool/id/{pool['id']}")
            pool_data = pool_response.json()
            
            health_status.append({
                "name": pool_data["name"],
                "health": pool_data["healthy"],
                "status": pool_data["status"],
                "used_gb": round(pool_data["used"]["parsed"] / 1024**3, 2),
                "free_gb": round(pool_data["available"]["parsed"] / 1024**3, 2)
            })
        
        return health_status

# Использование
if __name__ == "__main__":
    client = TrueNASClient("192.168.1.100", "your-api-token-here")
    
    print("=== System Information ===")
    system_info = client.get_system_info()
    print(f"Hostname: {system_info['hostname']}")
    print(f"Version: {system_info['version']}")
    
    print("\n=== Pool Health ===")
    pools = client.get_pool_health()
    for pool in pools:
        status_icon = "✅" if pool["health"] else "❌"
        print(f"{status_icon} {pool['name']}: {pool['status']}")
        print(f"   Used: {pool['used_gb']} GB, Free: {pool['free_gb']} GB")

def create_smb_share(self, path, name, comment="", readonly=False):
    """Создаем SMB общую папку"""
    share_data = {
        "path": path,
        "name": name,
        "comment": comment,
        "ro": readonly,
        "guestok": False,
        "hostsallow": [],
        "hostsdeny": [],
        "aal": "NONE",
        "abe": False,
        "acl": False,
        "durablehandle": True,
        "streams": True,
        "timemachine": False,
        "recyclebin": False
    }
    
    response = self.session.post(
        f"{self.base_url}/sharing/smb",
        json=share_data
    )
    
    if response.status_code == 200:
        print(f"SMB share '{name}' created successfully")
        return response.json()
    else:
        print(f"Failed to create SMB share: {response.text}")
        return None

# Создаем шару для бэкапов
client.create_smb_share(
    path="/mnt/pool01/backups",
    name="backups",
    comment="Automated backup share",
    readonly=True
)

---
- name: Manage TrueNAS users via API
  hosts: localhost
  vars:
    truenas_host: "{{ lookup('env', 'TRUENAS_HOST') }}"
    truenas_token: "{{ lookup('env', 'TRUENAS_TOKEN') }}"
    
  tasks:
    - name: Create user on TrueNAS
      uri:
        url: "https://{{ truenas_host }}/api/v2.0/user"
        method: POST
        headers:
          Authorization: "Bearer {{ truenas_token }}"
          Content-Type: "application/json"
        body_format: json
        body:
          username: "{{ item.username }}"
          full_name: "{{ item.full_name }}"
          password: "{{ item.password }}"
          group: {{ item.group }}
          home: "/mnt/pool01/homes/{{ item.username }}"
          shell: "/usr/bin/bash"
        validate_certs: no
      loop: "{{ users_to_create }}"
      loop_control:
        label: "{{ item.username }}"
      no_log: true  # Скрываем пароли в логах

    - name: Ensure user's home directory exists
      uri:
        url: "https://{{ truenas_host }}/api/v2.0/filesystem/mkdir"
        method: POST
        headers:
          Authorization: "Bearer {{ truenas_token }}"
          Content-Type: "application/json"
        body_format: json
        body:
          path: "/mnt/pool01/homes/{{ item.username }}"
        validate_certs: no
      loop: "{{ users_to_create }}"
      loop_control:
        label: "{{ item.username }}"

#!/bin/bash

# Zabbix внешний скрипт для мониторинга TrueNAS
TRUENAS_HOST="$1"
API_TOKEN="$2"
METRIC="$3"
POOL_NAME="$4"

case $METRIC in
    "pool.health")
        # Возвращаем 1 если пул здоров, 0 если нет
        response=$(curl -s -k -H "Authorization: Bearer $API_TOKEN" \
          "https://$TRUENAS_HOST/api/v2.0/pool?name=$POOL_NAME")
        healthy=$(echo $response | jq -r '.[0].healthy')
        [[ "$healthy" == "true" ]] && echo 1 || echo 0
        ;;
    "pool.used")
        # Использованное место в процентах
        response=$(curl -s -k -H "Authorization: Bearer $API_TOKEN" \
          "https://$TRUENAS_HOST/api/v2.0/pool?name=$POOL_NAME")
        used=$(echo $response | jq -r '.[0].used.parsed')
        total=$(echo $response | jq -r '.[0].size.parsed')
        if [[ $total -gt 0 ]]; then
            echo "scale=2; $used * 100 / $total" | bc
        else
            echo 0
        fi
        ;;
    "system.uptime")
        # Аптайм системы в секундах
        response=$(curl -s -k -H "Authorization: Bearer $API_TOKEN" \
          "https://$TRUENAS_HOST/api/v2.0/system/info")
        echo $response | jq -r '.uptime_seconds'
        ;;
    *)
        echo "Unknown metric: $METRIC"
        exit 1
        ;;
esac