راهنمای استفاده از API آویاتو

aws configure set aws_access_key_id YOUR_ACCESS_KEY_ID
aws configure set aws_secret_access_key YOUR_SECRET_ACCESS_KEY
aws s3api put-object \
  --endpoint-url https://s3.aviato.ir \
  --region aviato-1 \
  --bucket YOUR_BUCKET_NAME \
  --key uploads/invoice-2026-07.pdf \
  --body ./invoice-2026-07.pdf
aws s3api get-object \
  --endpoint-url https://s3.aviato.ir \
  --region aviato-1 \
  --bucket YOUR_BUCKET_NAME \
  --key uploads/invoice-2026-07.pdf \
  ./invoice-downloaded.pdf

use Aws\\S3\\S3Client;
$s3 = new S3Client([
    'version' => 'latest',
    'region' => 'aviato-1',
    'endpoint' => 'https://s3.aviato.ir',
    'use_path_style_endpoint' => true,
    'credentials' => [
        'key' => 'YOUR_ACCESS_KEY_ID',
        'secret' => 'YOUR_SECRET_ACCESS_KEY',
    ],
]);
$s3->putObject([
    'Bucket' => 'YOUR_BUCKET_NAME',
    'Key' => 'uploads/invoice-2026-07.pdf',
    'SourceFile' => __DIR__.'/invoice-2026-07.pdf',
    'ContentType' => 'application/pdf',
]);
$s3->getObject([
    'Bucket' => 'YOUR_BUCKET_NAME',
    'Key' => 'uploads/invoice-2026-07.pdf',
    'SaveAs' => __DIR__.'/invoice-downloaded.pdf',
]);

import { S3Client, PutObjectCommand, GetObjectCommand } from '@aws-sdk/client-s3';
import { createReadStream, createWriteStream } from 'node:fs';
import { pipeline } from 'node:stream/promises';
const s3 = new S3Client({
  region: 'aviato-1',
  endpoint: 'https://s3.aviato.ir',
  forcePathStyle: true,
  credentials: { accessKeyId: 'YOUR_ACCESS_KEY_ID', secretAccessKey: 'YOUR_SECRET_ACCESS_KEY' },
});
await s3.send(new PutObjectCommand({ Bucket: 'YOUR_BUCKET_NAME', Key: 'uploads/invoice-2026-07.pdf', Body: createReadStream('./invoice-2026-07.pdf'), ContentType: 'application/pdf' }));
const object = await s3.send(new GetObjectCommand({ Bucket: 'YOUR_BUCKET_NAME', Key: 'uploads/invoice-2026-07.pdf' }));
await pipeline(object.Body, createWriteStream('./invoice-downloaded.pdf'));

curl -X GET "https://aviato.ir/api/v1/projects/YOUR_PROJECT_UUID/virtual-machines/options" \
  -H "Accept: application/json" -H "Authorization: Bearer YOUR_API_KEY"

$response = Http::withToken('YOUR_API_KEY')
    ->acceptJson()
    ->get('https://aviato.ir/api/v1/projects/YOUR_PROJECT_UUID/virtual-machines/options');
$options = $response->json('data');

const response = await fetch('https://aviato.ir/api/v1/projects/YOUR_PROJECT_UUID/virtual-machines/options', {
  headers: {
    Accept: 'application/json',
    Authorization: 'Bearer YOUR_API_KEY',
  },
});
const options = (await response.json()).data;

curl -X POST "https://aviato.ir/api/v1/projects/YOUR_PROJECT_UUID/virtual-machines" \
  -H "Accept: application/json" -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"infrastructure_location_id":12,"cloud_image_id":4,"vm_bundle_id":2,"display_name":"My Production Server","login_username":"ubuntu","ssh_public_key":"ssh-ed25519 ..."}'

$response = Http::withToken('YOUR_API_KEY')
    ->acceptJson()
    ->post('https://aviato.ir/api/v1/projects/YOUR_PROJECT_UUID/virtual-machines', [
        'infrastructure_location_id' => 12,
        'cloud_image_id' => 4,
        'vm_bundle_id' => 2,
        'display_name' => 'My Production Server',
        'login_username' => 'ubuntu',
        'ssh_public_key' => 'ssh-ed25519 ...',
    ]);
$createdVm = $response->json('data');

const response = await fetch('https://aviato.ir/api/v1/projects/YOUR_PROJECT_UUID/virtual-machines', {
  method: 'POST',
  headers: {
    Accept: 'application/json',
    Authorization: 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    infrastructure_location_id: 12, cloud_image_id: 4, vm_bundle_id: 2,
    display_name: 'My Production Server', login_username: 'ubuntu',
    ssh_public_key: 'ssh-ed25519 ...',
  }),
});
const createdVm = (await response.json()).data;

curl -X GET "https://aviato.ir/api/v1/projects/YOUR_PROJECT_UUID/virtual-machines?per_page=25" \
  -H "Accept: application/json" -H "Authorization: Bearer YOUR_API_KEY"

$vms = Http::withToken('YOUR_API_KEY')
    ->acceptJson()
    ->get('https://aviato.ir/api/v1/projects/YOUR_PROJECT_UUID/virtual-machines', ['per_page' => 25])
    ->json('data');

const response = await fetch('https://aviato.ir/api/v1/projects/YOUR_PROJECT_UUID/virtual-machines?per_page=25', {
  headers: { Accept: 'application/json', Authorization: 'Bearer YOUR_API_KEY' },
});
const vms = (await response.json()).data;

curl -X GET "https://aviato.ir/api/v1/projects/YOUR_PROJECT_UUID/virtual-machines/YOUR_VM_UUID" \
  -H "Accept: application/json" -H "Authorization: Bearer YOUR_API_KEY"

$vm = Http::withToken('YOUR_API_KEY')
    ->acceptJson()
    ->get('https://aviato.ir/api/v1/projects/YOUR_PROJECT_UUID/virtual-machines/YOUR_VM_UUID')
    ->json('data');

const response = await fetch('https://aviato.ir/api/v1/projects/YOUR_PROJECT_UUID/virtual-machines/YOUR_VM_UUID', {
  headers: { Accept: 'application/json', Authorization: 'Bearer YOUR_API_KEY' },
});
const vm = (await response.json()).data;

curl -X DELETE "https://aviato.ir/api/v1/projects/YOUR_PROJECT_UUID/virtual-machines/YOUR_VM_UUID" \
  -H "Accept: application/json" -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"confirmation":"My Production Server"}'

$response = Http::withToken('YOUR_API_KEY')
    ->acceptJson()
    ->delete('https://aviato.ir/api/v1/projects/YOUR_PROJECT_UUID/virtual-machines/YOUR_VM_UUID', [
        'confirmation' => 'My Production Server',
    ]);

const response = await fetch('https://aviato.ir/api/v1/projects/YOUR_PROJECT_UUID/virtual-machines/YOUR_VM_UUID', {
  method: 'DELETE',
  headers: {
    Accept: 'application/json',
    Authorization: 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ confirmation: 'My Production Server' }),
});
const deletion = (await response.json()).data;