为运行中的沙箱挂载存储卷

以下之一：

• Volume{32 个属性}

  • managed_byobject | nullrequired{2 个属性}

    它所属的数据库 (/v1/databases)，或它所属的托管应用安装 (/v1/installations)，只有它们能修改它：其他任何会修改它的调用都会被拒绝，返回 409 managed_by_database 或 managed_by_installation。null：不受任何东西管理。

    • objectdatabase或installationrequired
    • idstringrequired

    }
  • idstringrequired

    其 id。

    pattern: ^vol-[0-9a-hjkmnp-tv-z]{16}$
  • objectstringrequired
  • namestring | nullrequired
  • size_bytesintegerrequired

    最大容量：4 KiB 块的整数倍。

    format: int64 · minimum: 16777216
  • used_bytesintegerrequired

    它在逻辑上保存的数据量：写入过、且此后没有被丢弃的 4 KiB 数据块（客户机的 fstrim 会归还它们，节点每分钟请求一次），包括其文件系统自身的部分。按此计费（storage_gb_hours，每 GB·月 $0.05）；分叉出的存储卷也按其保存的全部数据计费，其中包括其快照保存的数据：从 10 GB 的快照分叉出的存储卷按 10 GB 的存储卷计费，无论它在对象存储中与快照及原存储卷共享了多少数据。以其节点最后报告的为准；没有节点持有它时，以控制平面最后收到的为准。

    format: int64 · minimum: 0
  • attached_to数组，元素为stringrequired

    挂载它的沙箱，按 id 列出，与存储卷 API 一贯的写法相同：最多一个（attachments 说明挂载在哪里、以何种方式挂载）。

    pattern: ^sbx-[0-9a-hjkmnp-tv-z]{16}$
  • regionrequired{2 个变体}

    以下之一：

    • string
    • null

    }
  • homerequired{2 个变体}

    保存其副本的对象存储所在的区域：即创建它的区域 (region)，直到它迁到挂载它的区域（通过 POST /v1/volumes/{id}/home，或者在那里待满一小时后自动迁移）。其节点不向对象存储复制任何东西时为 null。云盘以外类型的存储卷为 null (kind)。

    以下之一：

    • string
    • null

    }
  • home_moveobject | nullrequired{6 个属性}

    正在进行的归属区域迁移（迁到持有它的区域）：何时以及为何请求迁移（user：POST /v1/volumes/{id}/home；away：在那里被持有了一小时；back：在归属区域迁过去之前，又回到归属区域被持有，从另一个区域的对象存储取回：它在那里写入的内容会复制回归属区域，归属区域保持不变），到目前为止已复制了多少个对象、多少字节，还剩多少个对象，以及中途停止时最后遇到的错误（它会自行继续）。没有正在进行的迁移时为 null。云盘以外类型的存储卷为 null (kind)。

    • asked_atstringrequired

      format: date-time
    • asked_bystring | nullrequired
    • copied_objectsinteger | nullrequired

      minimum: 0
    • copied_bytesinteger | nullrequired

      format: int64 · minimum: 0
    • objects_leftinteger | nullrequired

      minimum: 0
    • errorstring | nullrequired

    }
  • statusstringrequired

    ready；restoring：从备份创建，尚未全部就绪；failed：那次恢复已放弃，只能删除它；unavailable：其节点现在连不上（它保持上次看到的样子）。

  • leaserequired{2 个变体}

    有沙箱以读写方式挂载它时提供；否则为 null。云盘以外类型的存储卷为 null (kind)。

    以下之一：

    • VolumeLease
    • null

    }
  • app_idstring | nullrequired

    对于键控实例的存储卷（应用版本的 key_drives）：所属的应用。云盘以外类型的存储卷为 null (kind)。

  • keystring | nullrequired

    以及它所属的键：它随该键的实例创建，不会挂载到其他沙箱，并随键一起删除。云盘以外类型的存储卷为 null (kind)。

  • created_atstringrequired

    format: date-time
  • cache_bytesinteger | nullrequired

    它在节点 NVMe 上的缓存：节点在那里最多保存多少，缓存为整个存储卷时（默认）即其大小；其余部分只在对象存储中，读取时会取回（客户机等待对象存储）并保留，同时最久未使用的数据在对象存储保存了它之后被逐出（对象存储还没保存的数据从不逐出，因此在对象存储收到之前，存储卷可能暂时超出其缓存）。小于 64 MiB 时按 64 MiB 计，即客户机一次读取连同预读带来的量。按小时作为存储卷的 NVMe 缓存计费，最多按其保存的数据量计（GET /v1/usage 的 cache_gb_hours），与其保存的数据（used_bytes、storage_gb_hours）分开计费：全部缓存时两项都计费，完全不缓存时只计后一项。数据库的存储卷缓存其四分之一，至少 1 GiB。分叉出的存储卷沿用原存储卷的缓存设置。云盘以外类型的存储卷为 null (kind)。

    format: int64 · minimum: 0
  • cached_bytesinteger | nullrequired

    它现在在节点 NVMe 上的量：写入过和读取过、且此后没有被逐出的数据。没有节点持有它时为 null，来自早于缓存功能的节点时也为 null。云盘以外类型的存储卷为 null (kind)。

    format: int64 · minimum: 0
  • history_secondsinteger | nullrequired

    存储卷最多能按时间恢复或分叉到多久以前（其版本窗口，slice DB8：reports/storage/drives.md 4.7）：3600 到 86400 秒（一小时到一天）。有写入的存储卷每个时间段（30 秒）都会得到一个版本，即存储卷在某一时刻的状态（为最后那部分会暂停其虚拟机，最长两秒），按此时长保留；这些版本保留的、存储卷已不再需要的数据，像快照一样计费（history.exclusive_bytes，计入 dhist-<the volume's id without vol-> 名下的存储计量项）。null（或 0）：不保留，即默认值；设为 null 时，已保留的版本会被删除。云盘以外类型的存储卷为 null (kind)。

    format: int64 · maximum: 86400 · minimum: 3600
  • historyobject | nullrequired{5 个属性}

    有版本窗口时为其版本窗口 (history_seconds)；否则为 null。云盘以外类型的存储卷为 null (kind)。

    • fromstring | nullrequired

      它最早能恢复到的时间：窗口的开始，如果其第一个版本更晚则为第一个版本的时间；还没有版本时为 null。

      format: date-time
    • versionsintegerrequired

      窗口保留了多少个版本 (GET /v1/volumes/{id}/versions)。

      minimum: 0
    • exclusive_bytesintegerrequired

      其版本单独保存的数据：它们从存储卷的最新版本、其快照以及其他所有存储卷都不需要的对象中读取的数据，以对象存储回收程序最近一次的计算为准。版本窗口按此计费，与快照一样。

      format: int64 · minimum: 0
    • exclusive_atstring | nullrequired

      回收程序计算出这个结果的时间；null：尚未计算。

      format: date-time
    • keep_bytesinteger | nullrequired

      窗口最多保留的旧数据量（免费版的数据库：1 GB，与 Tiger 的保留量相同）：超出时最旧的版本会被删除。null：没有限制。

      format: int64 · minimum: 0

    }
  • attachments数组，元素为objectrequired{3 个属性}

    挂载它的沙箱，以及挂载位置和方式：最多一个。云盘以外类型的存储卷为空。

    • sandbox_idstringrequired

      pattern: ^sbx-[0-9a-hjkmnp-tv-z]{16}$
    • pathstring | nullrequired

      沙箱挂载它的位置：一个绝对路径。如果控制平面只从节点的盘点中得知这次挂载，则为 null。

    • modestringrequired

      read_write：唯一的写入者。其快照的只读挂载不在这里：那是沙箱自己的存储卷 (view_of)，要用快照的 id 移除。

    }
  • parent_volume_idstring | nullrequired

    本存储卷从哪个存储卷分叉而来 (POST /v1/volumes/{id}/fork)，那个存储卷可能已被删除；不是分叉出的存储卷为 null。云盘以外类型的存储卷为 null (kind)。

    pattern: ^vol-[0-9a-hjkmnp-tv-z]{16}$
  • root_volume_idstring | nullrequired

    其分叉链上的第一个存储卷（父存储卷的根；父存储卷本身不是分叉时即为父存储卷）；不是分叉出的存储卷为 null。云盘以外类型的存储卷为 null (kind)。

    pattern: ^vol-[0-9a-hjkmnp-tv-z]{16}$
  • kindstringrequired

    drive：本节所说的存储卷，同一时间只属于一个沙箱的磁盘，复制到对象存储中（为项目密钥创建的存储卷，除共享存储卷外都是这种）。shared：由节点保存、可同时供任意多个沙箱使用的文件系统（POST /v1/volumes，带上 shared: true），其余特性它都没有：没有租约、没有归属区域、没有快照、分叉或版本，也没有自己的缓存。plain：运营方创建的存储卷（单个节点上的文件系统，从不复制）。

  • sharedbooleanrequired

    是否为共享存储卷（kind 为 shared）。

  • host_failureobject | nullrequired

    其节点宿主机上一次硬宕机后，其磁盘上有哪些不确定的地方，以其节点的说法为准；null：没有。

  • from_backupstring | nullrequired

    创建它所依据的备份（POST /v1/volumes，带上 from_backup）；创建时为空的存储卷为 null。

  • failurestring | nullrequired

    无法从其备份创建的原因（status 为 failed）；其他情况为 null。

  • restore_attemptinteger | nullrequired

    对于从备份创建的存储卷，这是第几次尝试创建它（2：第一次在另一个节点上失败了）；创建时为空的存储卷为 null。

    maximum: 2 · minimum: 1
  • first_failurestring | nullrequired

    restore_attempt 为 2 时，第一次尝试失败的原因；其他情况为 null。

  • placement_refusalsarray | nullrequired

    对于从备份创建的存储卷：在某个节点创建它之前拒绝创建它的节点，以及拒绝的原因；第一个节点就创建了它时为 null。

  • backupsobject | nullrequired{3 个属性}

    其备份规则（PATCH /v1/volumes/{id}，带上 backups；其备份见 /v1/volumes/{id}/backups）：是否每天备份、保留多少个每日备份，以及每个备份保留多久。其节点没有给出时为 null。

    • dailyoptionalboolean
    • keepoptionalinteger
    • expires_in_daysoptionalinteger

    }
  • durabilityoptionalstring | null

    持久化方式，在创建时确定 (DriveCreate.durability)。standard：客户机的 fsync 立即返回（写入已在其节点上），宿主机丢失时最多丢失最后一秒的写入。strict：客户机的 fsync 以及其文件系统的每次刷写，都要等对象存储保存了此前的全部写入才返回：客户机同步过的数据不会随宿主机丢失，每次 fsync 都要等待一次对对象存储的请求（几十毫秒）。云盘以外类型的存储卷为 null (kind)。

  }
• VolumeSnapshot{10 个属性}

  • idstringrequired

    pattern: ^dsnap-[0-9a-hjkmnp-tv-z]{16}$
  • objectstringrequired
  • namestring | nullrequired
  • consistencystring | nullrequired

    创建快照时如何暂停客户机的写入：frozen，由沙箱的代理程序冻结其文件系统 (fs_consistent)，对文件系统而言是一致的；paused，暂停其虚拟机，相当于断电时的状态；at_rest，当时没有运行中的沙箱以读写方式挂载该存储卷。

  • used_bytesintegerrequired

    创建快照时存储卷保存的数据量（其 used_bytes）。

    format: int64 · minimum: 0
  • exclusive_bytesintegerrequired

    它单独保存的数据：其版本从存储卷的最新版本、更新的快照以及所有分叉都不需要的对象中读取的数据（两个快照共同保存的对象计在较旧的那个上），以存储回收程序最近一次的计算为准；在此之前为 0。按此按小时计费。

    format: int64 · minimum: 0
  • exclusive_atstring | nullrequired

    回收程序计算出这个结果的时间；null：尚未计算。

    format: date-time
  • versionobjectrequired{2 个属性}

    它对应的存储卷版本。

    • numberintegerrequired

      format: int64 · minimum: 0
    • epochintegerrequired

      format: int64 · minimum: 0

    }
  • created_atstringrequired

    format: date-time
  • volume_idstringrequired

    它所属的存储卷，该存储卷可能已被删除。

    pattern: ^vol-[0-9a-hjkmnp-tv-z]{16}$

  }