Метаданные песочницы

Метаданные связывают песочницу с сущностями приложения: сессией, пользователем, задачей или окружением. Ключи и значения — строки. Они возвращаются при получении информации и списка песочниц.

import { Sandbox } from "@abox-dev/sdk";

const sandbox = await Sandbox.create({
  metadata: { sessionId: "session-42", environment: "development" },
});

try {
  const paginator = Sandbox.list({
    query: { metadata: { sessionId: "session-42" } },
  });
  const sandboxes = await paginator.nextItems();
  console.log(sandboxes[0].metadata);
} finally {
  await sandbox.kill();
}

Фильтрация выполняется в API AgentBox, поэтому приложению не нужно сначала загружать все песочницы. Несколько пар выбирают песочницы, которые совпадают по каждой из них.

Метаданные доступны участникам проекта и клиентам API. Не храните в них API-ключи, пароли и другие секреты. Передавайте секреты среды выполнения через предназначенный для этого механизм или переменные окружения с нужной областью доступа.