@leaflow/sdk 0.1.0

package/dist/generated/compute/models/zoneView.js

@@ -0,0 +1,26 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * Leaflow 计算用户 API
+ * 用户自己用的接口：云服务器、云硬盘、快照、私有网络、子网、路由、安全组、网卡、公网 IP。
+
+## 怎么带身份
+
+每个请求都要带 `Authorization: Bearer <项目令牌>`。先在 auth.leaflow.net 登录拿到账号令牌，再用它向 IAM 换取项目令牌（`POST /api/v1/projects/{projectId}/token`）。一张项目令牌同时说明当前用户和当前项目。
+
+**路径和请求头上都没有 `project_id`**：当前项目由令牌决定。
+
+失败时按出路区分：`IDENTITY_EXPIRED` 表示令牌过期，重新换取即可，无需重新登录；`PROJECT_FORBIDDEN` 表示当前账号不是该项目成员；`PROJECT_UNAVAILABLE` 表示项目欠费或正在删除；`PROJECT_NOT_WRITABLE` 表示项目仍可访问但不再接受写入。
+
+**欠费停服的项目仍然可以删除资源。** 新建和修改会返回 `PROJECT_NOT_WRITABLE`，`DELETE` 照常放行——云硬盘和公网 IP 在停服期间仍然计费，删除是止损手段。
+
+## 通用约定
+
+- **操作是异步的。** 创建云服务器、创建云硬盘、变更配置在返回时尚未完成，资源处于 `provisioning` 等中间状态，需轮询 GET 确认结果。查询单个资源时会同步一次当前状态。
+- **可用区。** 云硬盘与云服务器必须位于同一可用区才能挂载。机型和硬盘类型各自绑定在一个可用区上，选定类型即选定可用区。
+- **IPv6 不单独售卖。** IPv6 地址通过 SLAAC 下发到网卡，启用 IPv6 是私有网络上的一个开关，而非一次购买。
+- **公网 IP 有冷却期。** 释放后短时间内既不能重新申领，也不会分配给其他用户，以免仍指向该地址的 DNS 记录和访问白名单立即失效。
+- **密码只返回一次。** 创建或重装时若由平台生成密码，它仅出现在该次响应中，请及时保存。
+ * OpenAPI spec version: 1.0.0
+ */
+export {};

package/dist/generated/compute/models/zonesOutputBody.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * Leaflow 计算用户 API
+ * 用户自己用的接口：云服务器、云硬盘、快照、私有网络、子网、路由、安全组、网卡、公网 IP。
+
+## 怎么带身份
+
+每个请求都要带 `Authorization: Bearer <项目令牌>`。先在 auth.leaflow.net 登录拿到账号令牌，再用它向 IAM 换取项目令牌（`POST /api/v1/projects/{projectId}/token`）。一张项目令牌同时说明当前用户和当前项目。
+
+**路径和请求头上都没有 `project_id`**：当前项目由令牌决定。
+
+失败时按出路区分：`IDENTITY_EXPIRED` 表示令牌过期，重新换取即可，无需重新登录；`PROJECT_FORBIDDEN` 表示当前账号不是该项目成员；`PROJECT_UNAVAILABLE` 表示项目欠费或正在删除；`PROJECT_NOT_WRITABLE` 表示项目仍可访问但不再接受写入。
+
+**欠费停服的项目仍然可以删除资源。** 新建和修改会返回 `PROJECT_NOT_WRITABLE`，`DELETE` 照常放行——云硬盘和公网 IP 在停服期间仍然计费，删除是止损手段。
+
+## 通用约定
+
+- **操作是异步的。** 创建云服务器、创建云硬盘、变更配置在返回时尚未完成，资源处于 `provisioning` 等中间状态，需轮询 GET 确认结果。查询单个资源时会同步一次当前状态。
+- **可用区。** 云硬盘与云服务器必须位于同一可用区才能挂载。机型和硬盘类型各自绑定在一个可用区上，选定类型即选定可用区。
+- **IPv6 不单独售卖。** IPv6 地址通过 SLAAC 下发到网卡，启用 IPv6 是私有网络上的一个开关，而非一次购买。
+- **公网 IP 有冷却期。** 释放后短时间内既不能重新申领，也不会分配给其他用户，以免仍指向该地址的 DNS 记录和访问白名单立即失效。
+- **密码只返回一次。** 创建或重装时若由平台生成密码，它仅出现在该次响应中，请及时保存。
+ * OpenAPI spec version: 1.0.0
+ */
+import type { ZonesOutputBodyItems } from './zonesOutputBodyItems';
+export interface ZonesOutputBody {
+    items: ZonesOutputBodyItems;
+}

package/dist/generated/compute/models/zonesOutputBody.js

@@ -0,0 +1 @@
+export {};

package/dist/generated/compute/models/zonesOutputBodyItems.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * Leaflow 计算用户 API
+ * 用户自己用的接口：云服务器、云硬盘、快照、私有网络、子网、路由、安全组、网卡、公网 IP。
+
+## 怎么带身份
+
+每个请求都要带 `Authorization: Bearer <项目令牌>`。先在 auth.leaflow.net 登录拿到账号令牌，再用它向 IAM 换取项目令牌（`POST /api/v1/projects/{projectId}/token`）。一张项目令牌同时说明当前用户和当前项目。
+
+**路径和请求头上都没有 `project_id`**：当前项目由令牌决定。
+
+失败时按出路区分：`IDENTITY_EXPIRED` 表示令牌过期，重新换取即可，无需重新登录；`PROJECT_FORBIDDEN` 表示当前账号不是该项目成员；`PROJECT_UNAVAILABLE` 表示项目欠费或正在删除；`PROJECT_NOT_WRITABLE` 表示项目仍可访问但不再接受写入。
+
+**欠费停服的项目仍然可以删除资源。** 新建和修改会返回 `PROJECT_NOT_WRITABLE`，`DELETE` 照常放行——云硬盘和公网 IP 在停服期间仍然计费，删除是止损手段。
+
+## 通用约定
+
+- **操作是异步的。** 创建云服务器、创建云硬盘、变更配置在返回时尚未完成，资源处于 `provisioning` 等中间状态，需轮询 GET 确认结果。查询单个资源时会同步一次当前状态。
+- **可用区。** 云硬盘与云服务器必须位于同一可用区才能挂载。机型和硬盘类型各自绑定在一个可用区上，选定类型即选定可用区。
+- **IPv6 不单独售卖。** IPv6 地址通过 SLAAC 下发到网卡，启用 IPv6 是私有网络上的一个开关，而非一次购买。
+- **公网 IP 有冷却期。** 释放后短时间内既不能重新申领，也不会分配给其他用户，以免仍指向该地址的 DNS 记录和访问白名单立即失效。
+- **密码只返回一次。** 创建或重装时若由平台生成密码，它仅出现在该次响应中，请及时保存。
+ * OpenAPI spec version: 1.0.0
+ */
+import type { ZoneView } from './zoneView';
+export type ZonesOutputBodyItems = ZoneView[] | null;

package/dist/generated/compute/models/zonesOutputBodyItems.js

@@ -0,0 +1 @@
+export {};

package/dist/generated/iam/index.d.ts

@@ -0,0 +1,237 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * Leaflow IAM 用户 API
+ * 用户和项目自己用的接口：账号、项目、成员、角色、邀请、SSH 公钥。
+
+## 两种令牌
+
+1. 在 auth.leaflow.net 登录，拿到**账号令牌**；
+2. 带着它调 `GET /api/v1/projects` 列出参与的项目。首次调用会自动登记账号，姓名与邮箱取自登录信息；
+3. 选定项目后调 `POST /api/v1/projects/{projectId}/token` 换取**项目令牌**，后续请求一律使用它。
+
+两种令牌都放在 `Authorization: Bearer` 里。
+
+项目令牌过期后重新执行第 3 步；账号令牌过期则先在 auth.leaflow.net 续期。没有单独的项目令牌续期接口。
+
+## 成员关系只给事实
+
+`GET /projects/{projectId}/membership` 返回的是这个人在项目里持有哪些角色和权限，不返回「能否执行某个操作」的结论——那需要一份「哪个操作要哪条权限」的对照表，而它由各个服务分别声明。
+ * OpenAPI spec version: 1.0.0
+ */
+import type { AcceptInvitationByTokenInputBody, AcceptInvitationOutputBody, AccountView, CreateProjectInputBody, CreateProjectSSHKeyInputBody, CreateRoleInputBody, CreateUserSSHKeyInputBody, ExchangeTokenOutputBody, IdentityVerificationView, IssueInvitationInputBody, IssueInvitationOutputBody, ListInvitationsOutputBody, ListMembersOutputBody, ListMembersParams, ListMyInvitationsParams, ListMySshKeysParams, ListPermissionsOutputBody, ListProjectInvitationsParams, ListProjectSshKeysParams, ListProjectsOutputBody, ListProjectsParams, ListRolesOutputBody, ListSSHKeysOutputBody, MemberView, MembershipView, ProjectListItem, RenameProjectSSHKeyInputBody, RenameUserSSHKeyInputBody, RoleView, SSHKeyView, SetMemberRolesInputBody, SubmitIdentityVerificationInputBody, TransferOwnershipInputBody, TransferOwnershipOutputBody, UpdateProjectInputBody, UpdateRoleInputBody } from './models';
+/**
+* @summary 查看当前账号
+*/
+export declare const getAccount: () => Promise<AccountView>;
+/**
+ * 没交过材料时答 UNVERIFIED，不是 404。姓名和证件号不会出现在任何响应里。
+ * @summary 查看实名核验状态
+ */
+export declare const getIdentityVerification: () => Promise<IdentityVerificationView>;
+/**
+ * 已经在等人审的和已经核过的都会被拒。被驳回之后可以改了再交。
+ * @summary 提交实名核验材料
+ */
+export declare const submitIdentityVerification: (submitIdentityVerificationInputBody: SubmitIdentityVerificationInputBody) => Promise<IdentityVerificationView>;
+/**
+ * 按当前账号的邮箱查，因为要约是寄给一个地址的——被邀请的人当时可能还没注册。
+ * @summary 列出寄给我的要约
+ */
+export declare const listMyInvitations: (params?: ListMyInvitationsParams) => Promise<ListInvitationsOutputBody>;
+/**
+ * token 对不上和这份要约已经不作数了是同一个回答：持有者对这两种情况能做的事完全一样，分开报会把这个接口变成一个可以拿来试 token 的探针。
+ * @summary 顺着邀请链接接受
+ */
+export declare const acceptInvitationByToken: (acceptInvitationByTokenInputBody: AcceptInvitationByTokenInputBody) => Promise<AcceptInvitationOutputBody>;
+/**
+ * 不需要 token：token 证明的是「你就是这份要约寄给的那个人」，而当前账号的邮箱对得上这份要约，证明的是同一件事。
+ * @summary 接受一份列在我名下的要约
+ */
+export declare const acceptInvitation: (invitationId: string) => Promise<AcceptInvitationOutputBody>;
+/**
+ * @summary 列出我的公钥
+ */
+export declare const listMySshKeys: (params?: ListMySshKeysParams) => Promise<ListSSHKeysOutputBody>;
+/**
+ * @summary 添加一把我的公钥
+ */
+export declare const createMySshKey: (createUserSSHKeyInputBody: CreateUserSSHKeyInputBody) => Promise<SSHKeyView>;
+/**
+ * 行留着，状态变成 REVOKED。事故之后要问的是当时信任的是哪把钥匙。
+ * @summary 吊销我的一把公钥
+ */
+export declare const revokeMySshKey: (keyId: string) => Promise<SSHKeyView>;
+/**
+ * @summary 查看我的一把公钥
+ */
+export declare const getMySshKey: (keyId: string) => Promise<SSHKeyView>;
+/**
+ * 只有名字能改：公钥、类型、指纹是同一样东西的三种说法，改其中一个会让这一行描述一把并不存在的钥匙。
+ * @summary 给我的公钥改名
+ */
+export declare const renameMySshKey: (keyId: string, renameUserSSHKeyInputBody: RenameUserSSHKeyInputBody) => Promise<SSHKeyView>;
+/**
+ * 幂等：已经同意过的不会被推到今天——那一列是法务要的证据，说的是他哪一次同意的。
+ * @summary 同意服务条款
+ */
+export declare const acceptTerms: () => Promise<AccountView>;
+/**
+ * **只有 IAM 这一份。** 别的服务的操作不在这里——权限目录是各服务各自声明、由 各个服务自己声明的，IAM 认识它们就等于要跟着每个下游一起发版。
+ * @summary 列出 IAM 自己声明的权限
+ */
+export declare const listPermissions: () => Promise<ListPermissionsOutputBody>;
+/**
+ * 默认不含已删除的项目——那些是已经不存在了的东西，要看必须明确用 status=DELETED 点名。
+ * @summary 列出我参与的项目
+ */
+export declare const listProjects: (params?: ListProjectsParams) => Promise<ListProjectsOutputBody>;
+/**
+ * 建的人就是所有者。项目会连带预置 OWNER、ADMIN 两个内置角色和一个空权限的 member 角色。
+ * @summary 建一个项目
+ */
+export declare const createProject: (createProjectInputBody: CreateProjectInputBody) => Promise<ProjectListItem>;
+/**
+ * 只有所有者能做，而且没有回头路：项目进入 DELETING，各服务开始清掉它下面的资源。项目行本身永远留着——查一个删掉的项目查得到，答案是它没了，而不是一个 404。
+ * @summary 删除项目
+ */
+export declare const deleteProject: (projectId: string) => Promise<ProjectListItem>;
+/**
+ * 在项目里就看得到，不需要额外的读权限。
+ * @summary 查看一个项目
+ */
+export declare const getProject: (projectId: string) => Promise<ProjectListItem>;
+/**
+ * @summary 改项目的名称与描述
+ */
+export declare const updateProject: (projectId: string, updateProjectInputBody: UpdateProjectInputBody) => Promise<ProjectListItem>;
+/**
+ * 在项目里就看得到，和成员列表同一条规则：谁被请了也是「这个项目有谁」的一部分。
+ * @summary 列出这个项目还在等的要约
+ */
+export declare const listProjectInvitations: (projectId: string, params?: ListProjectInvitationsParams) => Promise<ListInvitationsOutputBody>;
+/**
+ * 要约站 14 天。有上限是因为里面那些角色是按发出那一刻的项目校验的，一份活得比它所依据的安排还久的要约会授出现在没人打算授的权限。
+ * @summary 发出一份邀请
+ */
+export declare const issueInvitation: (projectId: string, issueInvitationInputBody: IssueInvitationInputBody) => Promise<IssueInvitationOutputBody>;
+/**
+ * @summary 撤回一份还没被兑现的要约
+ */
+export declare const revokeInvitation: (projectId: string, invitationId: string) => Promise<void>;
+/**
+ * @summary 列出项目成员
+ */
+export declare const listMembers: (projectId: string, params?: ListMembersParams) => Promise<ListMembersOutputBody>;
+/**
+ * 移除别人要 iam:members.manage；退出只要求自己在这个项目里——任何人都可能被拉进一个项目，那么任何人就得能出去。所有者两条路都不行，先转移所有权。
+ * @summary 移除成员，或者自己退出
+ */
+export declare const removeMember: (projectId: string, userId: string) => Promise<void>;
+/**
+ * 整体替换而不是增删：调用方拿到的就是一份完整清单，让它自己算差集只会让「我以为我取消了那个角色」这种事变得可能。所有者身上的 OWNER 不受影响。
+ * @summary 设置一个成员持有的角色
+ */
+export declare const setMemberRoles: (projectId: string, userId: string, setMemberRolesInputBody: SetMemberRolesInputBody) => Promise<MemberView>;
+/**
+ * 只给事实，不给结论：这里没有 allowed，因为 IAM 不知道你要做的是哪个操作——哪个操作需要哪条权限那份目录属于各个服务，判断在它们那边。
+ * @summary 查看我在这个项目里的身份
+ */
+export declare const getProjectMembership: (projectId: string) => Promise<MembershipView>;
+/**
+ * @summary 列出项目里的角色
+ */
+export declare const listRoles: (projectId: string) => Promise<ListRolesOutputBody>;
+/**
+ * @summary 建一个角色
+ */
+export declare const createRole: (projectId: string, createRoleInputBody: CreateRoleInputBody) => Promise<RoleView>;
+/**
+ * 还有人持有时会被拒。级联摘掉那些绑定等于把每个持有者悄悄降级——请求里没有一个字说了这件事，事后也查不到。
+ * @summary 删一个角色
+ */
+export declare const deleteRole: (projectId: string, code: string) => Promise<void>;
+/**
+ * @summary 查看一个角色
+ */
+export declare const getRole: (projectId: string, code: string) => Promise<RoleView>;
+/**
+ * 名称、描述和权限整体替换。改完会在同一个事务里重新编译持有它的每一个成员——角色的权限变了，就是那些人的权限变了，而下一次请求是拿编译结果判定的。
+ * @summary 改一个角色
+ */
+export declare const updateRole: (projectId: string, code: string, updateRoleInputBody: UpdateRoleInputBody) => Promise<RoleView>;
+/**
+ * @summary 列出项目的公钥
+ */
+export declare const listProjectSshKeys: (projectId: string, params?: ListProjectSshKeysParams) => Promise<ListSSHKeysOutputBody>;
+/**
+ * @summary 给项目添加一把公钥
+ */
+export declare const createProjectSshKey: (projectId: string, createProjectSSHKeyInputBody: CreateProjectSSHKeyInputBody) => Promise<SSHKeyView>;
+/**
+ * @summary 吊销项目的一把公钥
+ */
+export declare const revokeProjectSshKey: (projectId: string, keyId: string) => Promise<SSHKeyView>;
+/**
+ * @summary 查看项目的一把公钥
+ */
+export declare const getProjectSshKey: (projectId: string, keyId: string) => Promise<SSHKeyView>;
+/**
+ * @summary 给项目的公钥改名
+ */
+export declare const renameProjectSshKey: (projectId: string, keyId: string, renameProjectSSHKeyInputBody: RenameProjectSSHKeyInputBody) => Promise<SSHKeyView>;
+/**
+ * 选定一个项目后，用账号令牌换取该项目的令牌。
+
+**只接受 auth.leaflow.net 签发的账号令牌，不接受项目令牌。** 项目令牌过期后，先在 auth.leaflow.net 续期账号令牌，再重新调用这个接口。
+
+换取时会确认账号可用、项目存在，且**调用者是该项目的成员**。非成员无法换取。
+
+令牌只表明身份（用户与项目），**不包含权限**：权限在每次请求时实时判定，所以角色调整立即生效，不必等待令牌过期。
+
+项目处于停用、封禁或删除中时**仍可换取令牌**：这些状态限制的是写入，不影响查看项目当前状况。
+ * @summary 换一张项目令牌
+ */
+export declare const exchangeProjectToken: (projectId: string) => Promise<ExchangeTokenOutputBody>;
+/**
+ * OWNER 唯一的移动方式，只有所有者本人能发起——能像普通角色那样授予的话，任何管理员都可以顺手把自己变成所有者。
+ * @summary 转移项目所有权
+ */
+export declare const transferProjectOwnership: (projectId: string, transferOwnershipInputBody: TransferOwnershipInputBody) => Promise<TransferOwnershipOutputBody>;
+export type GetAccountResult = NonNullable<Awaited<ReturnType<typeof getAccount>>>;
+export type GetIdentityVerificationResult = NonNullable<Awaited<ReturnType<typeof getIdentityVerification>>>;
+export type SubmitIdentityVerificationResult = NonNullable<Awaited<ReturnType<typeof submitIdentityVerification>>>;
+export type ListMyInvitationsResult = NonNullable<Awaited<ReturnType<typeof listMyInvitations>>>;
+export type AcceptInvitationByTokenResult = NonNullable<Awaited<ReturnType<typeof acceptInvitationByToken>>>;
+export type AcceptInvitationResult = NonNullable<Awaited<ReturnType<typeof acceptInvitation>>>;
+export type ListMySshKeysResult = NonNullable<Awaited<ReturnType<typeof listMySshKeys>>>;
+export type CreateMySshKeyResult = NonNullable<Awaited<ReturnType<typeof createMySshKey>>>;
+export type RevokeMySshKeyResult = NonNullable<Awaited<ReturnType<typeof revokeMySshKey>>>;
+export type GetMySshKeyResult = NonNullable<Awaited<ReturnType<typeof getMySshKey>>>;
+export type RenameMySshKeyResult = NonNullable<Awaited<ReturnType<typeof renameMySshKey>>>;
+export type AcceptTermsResult = NonNullable<Awaited<ReturnType<typeof acceptTerms>>>;
+export type ListPermissionsResult = NonNullable<Awaited<ReturnType<typeof listPermissions>>>;
+export type ListProjectsResult = NonNullable<Awaited<ReturnType<typeof listProjects>>>;
+export type CreateProjectResult = NonNullable<Awaited<ReturnType<typeof createProject>>>;
+export type DeleteProjectResult = NonNullable<Awaited<ReturnType<typeof deleteProject>>>;
+export type GetProjectResult = NonNullable<Awaited<ReturnType<typeof getProject>>>;
+export type UpdateProjectResult = NonNullable<Awaited<ReturnType<typeof updateProject>>>;
+export type ListProjectInvitationsResult = NonNullable<Awaited<ReturnType<typeof listProjectInvitations>>>;
+export type IssueInvitationResult = NonNullable<Awaited<ReturnType<typeof issueInvitation>>>;
+export type RevokeInvitationResult = NonNullable<Awaited<ReturnType<typeof revokeInvitation>>>;
+export type ListMembersResult = NonNullable<Awaited<ReturnType<typeof listMembers>>>;
+export type RemoveMemberResult = NonNullable<Awaited<ReturnType<typeof removeMember>>>;
+export type SetMemberRolesResult = NonNullable<Awaited<ReturnType<typeof setMemberRoles>>>;
+export type GetProjectMembershipResult = NonNullable<Awaited<ReturnType<typeof getProjectMembership>>>;
+export type ListRolesResult = NonNullable<Awaited<ReturnType<typeof listRoles>>>;
+export type CreateRoleResult = NonNullable<Awaited<ReturnType<typeof createRole>>>;
+export type DeleteRoleResult = NonNullable<Awaited<ReturnType<typeof deleteRole>>>;
+export type GetRoleResult = NonNullable<Awaited<ReturnType<typeof getRole>>>;
+export type UpdateRoleResult = NonNullable<Awaited<ReturnType<typeof updateRole>>>;
+export type ListProjectSshKeysResult = NonNullable<Awaited<ReturnType<typeof listProjectSshKeys>>>;
+export type CreateProjectSshKeyResult = NonNullable<Awaited<ReturnType<typeof createProjectSshKey>>>;
+export type RevokeProjectSshKeyResult = NonNullable<Awaited<ReturnType<typeof revokeProjectSshKey>>>;
+export type GetProjectSshKeyResult = NonNullable<Awaited<ReturnType<typeof getProjectSshKey>>>;
+export type RenameProjectSshKeyResult = NonNullable<Awaited<ReturnType<typeof renameProjectSshKey>>>;
+export type ExchangeProjectTokenResult = NonNullable<Awaited<ReturnType<typeof exchangeProjectToken>>>;
+export type TransferProjectOwnershipResult = NonNullable<Awaited<ReturnType<typeof transferProjectOwnership>>>;

package/dist/generated/iam/index.js

@@ -0,0 +1,322 @@
+import { request } from '../../http';
+/**
+* @summary 查看当前账号
+*/
+export const getAccount = () => {
+    return request({ url: `/api/v1/me`, method: 'GET'
+    });
+};
+/**
+ * 没交过材料时答 UNVERIFIED，不是 404。姓名和证件号不会出现在任何响应里。
+ * @summary 查看实名核验状态
+ */
+export const getIdentityVerification = () => {
+    return request({ url: `/api/v1/me/identity-verification`, method: 'GET'
+    });
+};
+/**
+ * 已经在等人审的和已经核过的都会被拒。被驳回之后可以改了再交。
+ * @summary 提交实名核验材料
+ */
+export const submitIdentityVerification = (submitIdentityVerificationInputBody) => {
+    return request({ url: `/api/v1/me/identity-verification`, method: 'POST',
+        headers: { 'Content-Type': 'application/json', },
+        data: submitIdentityVerificationInputBody
+    });
+};
+/**
+ * 按当前账号的邮箱查，因为要约是寄给一个地址的——被邀请的人当时可能还没注册。
+ * @summary 列出寄给我的要约
+ */
+export const listMyInvitations = (params) => {
+    return request({ url: `/api/v1/me/invitations`, method: 'GET',
+        params
+    });
+};
+/**
+ * token 对不上和这份要约已经不作数了是同一个回答：持有者对这两种情况能做的事完全一样，分开报会把这个接口变成一个可以拿来试 token 的探针。
+ * @summary 顺着邀请链接接受
+ */
+export const acceptInvitationByToken = (acceptInvitationByTokenInputBody) => {
+    return request({ url: `/api/v1/me/invitations/accept`, method: 'POST',
+        headers: { 'Content-Type': 'application/json', },
+        data: acceptInvitationByTokenInputBody
+    });
+};
+/**
+ * 不需要 token：token 证明的是「你就是这份要约寄给的那个人」，而当前账号的邮箱对得上这份要约，证明的是同一件事。
+ * @summary 接受一份列在我名下的要约
+ */
+export const acceptInvitation = (invitationId) => {
+    return request({ url: `/api/v1/me/invitations/${invitationId}/accept`, method: 'POST'
+    });
+};
+/**
+ * @summary 列出我的公钥
+ */
+export const listMySshKeys = (params) => {
+    return request({ url: `/api/v1/me/ssh-keys`, method: 'GET',
+        params
+    });
+};
+/**
+ * @summary 添加一把我的公钥
+ */
+export const createMySshKey = (createUserSSHKeyInputBody) => {
+    return request({ url: `/api/v1/me/ssh-keys`, method: 'POST',
+        headers: { 'Content-Type': 'application/json', },
+        data: createUserSSHKeyInputBody
+    });
+};
+/**
+ * 行留着，状态变成 REVOKED。事故之后要问的是当时信任的是哪把钥匙。
+ * @summary 吊销我的一把公钥
+ */
+export const revokeMySshKey = (keyId) => {
+    return request({ url: `/api/v1/me/ssh-keys/${keyId}`, method: 'DELETE'
+    });
+};
+/**
+ * @summary 查看我的一把公钥
+ */
+export const getMySshKey = (keyId) => {
+    return request({ url: `/api/v1/me/ssh-keys/${keyId}`, method: 'GET'
+    });
+};
+/**
+ * 只有名字能改：公钥、类型、指纹是同一样东西的三种说法，改其中一个会让这一行描述一把并不存在的钥匙。
+ * @summary 给我的公钥改名
+ */
+export const renameMySshKey = (keyId, renameUserSSHKeyInputBody) => {
+    return request({ url: `/api/v1/me/ssh-keys/${keyId}`, method: 'PATCH',
+        headers: { 'Content-Type': 'application/json', },
+        data: renameUserSSHKeyInputBody
+    });
+};
+/**
+ * 幂等：已经同意过的不会被推到今天——那一列是法务要的证据，说的是他哪一次同意的。
+ * @summary 同意服务条款
+ */
+export const acceptTerms = () => {
+    return request({ url: `/api/v1/me/terms`, method: 'POST'
+    });
+};
+/**
+ * **只有 IAM 这一份。** 别的服务的操作不在这里——权限目录是各服务各自声明、由 各个服务自己声明的，IAM 认识它们就等于要跟着每个下游一起发版。
+ * @summary 列出 IAM 自己声明的权限
+ */
+export const listPermissions = () => {
+    return request({ url: `/api/v1/permissions`, method: 'GET'
+    });
+};
+/**
+ * 默认不含已删除的项目——那些是已经不存在了的东西，要看必须明确用 status=DELETED 点名。
+ * @summary 列出我参与的项目
+ */
+export const listProjects = (params) => {
+    return request({ url: `/api/v1/projects`, method: 'GET',
+        params
+    });
+};
+/**
+ * 建的人就是所有者。项目会连带预置 OWNER、ADMIN 两个内置角色和一个空权限的 member 角色。
+ * @summary 建一个项目
+ */
+export const createProject = (createProjectInputBody) => {
+    return request({ url: `/api/v1/projects`, method: 'POST',
+        headers: { 'Content-Type': 'application/json', },
+        data: createProjectInputBody
+    });
+};
+/**
+ * 只有所有者能做，而且没有回头路：项目进入 DELETING，各服务开始清掉它下面的资源。项目行本身永远留着——查一个删掉的项目查得到，答案是它没了，而不是一个 404。
+ * @summary 删除项目
+ */
+export const deleteProject = (projectId) => {
+    return request({ url: `/api/v1/projects/${projectId}`, method: 'DELETE'
+    });
+};
+/**
+ * 在项目里就看得到，不需要额外的读权限。
+ * @summary 查看一个项目
+ */
+export const getProject = (projectId) => {
+    return request({ url: `/api/v1/projects/${projectId}`, method: 'GET'
+    });
+};
+/**
+ * @summary 改项目的名称与描述
+ */
+export const updateProject = (projectId, updateProjectInputBody) => {
+    return request({ url: `/api/v1/projects/${projectId}`, method: 'PATCH',
+        headers: { 'Content-Type': 'application/json', },
+        data: updateProjectInputBody
+    });
+};
+/**
+ * 在项目里就看得到，和成员列表同一条规则：谁被请了也是「这个项目有谁」的一部分。
+ * @summary 列出这个项目还在等的要约
+ */
+export const listProjectInvitations = (projectId, params) => {
+    return request({ url: `/api/v1/projects/${projectId}/invitations`, method: 'GET',
+        params
+    });
+};
+/**
+ * 要约站 14 天。有上限是因为里面那些角色是按发出那一刻的项目校验的，一份活得比它所依据的安排还久的要约会授出现在没人打算授的权限。
+ * @summary 发出一份邀请
+ */
+export const issueInvitation = (projectId, issueInvitationInputBody) => {
+    return request({ url: `/api/v1/projects/${projectId}/invitations`, method: 'POST',
+        headers: { 'Content-Type': 'application/json', },
+        data: issueInvitationInputBody
+    });
+};
+/**
+ * @summary 撤回一份还没被兑现的要约
+ */
+export const revokeInvitation = (projectId, invitationId) => {
+    return request({ url: `/api/v1/projects/${projectId}/invitations/${invitationId}`, method: 'DELETE'
+    });
+};
+/**
+ * @summary 列出项目成员
+ */
+export const listMembers = (projectId, params) => {
+    return request({ url: `/api/v1/projects/${projectId}/members`, method: 'GET',
+        params
+    });
+};
+/**
+ * 移除别人要 iam:members.manage；退出只要求自己在这个项目里——任何人都可能被拉进一个项目，那么任何人就得能出去。所有者两条路都不行，先转移所有权。
+ * @summary 移除成员，或者自己退出
+ */
+export const removeMember = (projectId, userId) => {
+    return request({ url: `/api/v1/projects/${projectId}/members/${userId}`, method: 'DELETE'
+    });
+};
+/**
+ * 整体替换而不是增删：调用方拿到的就是一份完整清单，让它自己算差集只会让「我以为我取消了那个角色」这种事变得可能。所有者身上的 OWNER 不受影响。
+ * @summary 设置一个成员持有的角色
+ */
+export const setMemberRoles = (projectId, userId, setMemberRolesInputBody) => {
+    return request({ url: `/api/v1/projects/${projectId}/members/${userId}/roles`, method: 'PUT',
+        headers: { 'Content-Type': 'application/json', },
+        data: setMemberRolesInputBody
+    });
+};
+/**
+ * 只给事实，不给结论：这里没有 allowed，因为 IAM 不知道你要做的是哪个操作——哪个操作需要哪条权限那份目录属于各个服务，判断在它们那边。
+ * @summary 查看我在这个项目里的身份
+ */
+export const getProjectMembership = (projectId) => {
+    return request({ url: `/api/v1/projects/${projectId}/membership`, method: 'GET'
+    });
+};
+/**
+ * @summary 列出项目里的角色
+ */
+export const listRoles = (projectId) => {
+    return request({ url: `/api/v1/projects/${projectId}/roles`, method: 'GET'
+    });
+};
+/**
+ * @summary 建一个角色
+ */
+export const createRole = (projectId, createRoleInputBody) => {
+    return request({ url: `/api/v1/projects/${projectId}/roles`, method: 'POST',
+        headers: { 'Content-Type': 'application/json', },
+        data: createRoleInputBody
+    });
+};
+/**
+ * 还有人持有时会被拒。级联摘掉那些绑定等于把每个持有者悄悄降级——请求里没有一个字说了这件事，事后也查不到。
+ * @summary 删一个角色
+ */
+export const deleteRole = (projectId, code) => {
+    return request({ url: `/api/v1/projects/${projectId}/roles/${code}`, method: 'DELETE'
+    });
+};
+/**
+ * @summary 查看一个角色
+ */
+export const getRole = (projectId, code) => {
+    return request({ url: `/api/v1/projects/${projectId}/roles/${code}`, method: 'GET'
+    });
+};
+/**
+ * 名称、描述和权限整体替换。改完会在同一个事务里重新编译持有它的每一个成员——角色的权限变了，就是那些人的权限变了，而下一次请求是拿编译结果判定的。
+ * @summary 改一个角色
+ */
+export const updateRole = (projectId, code, updateRoleInputBody) => {
+    return request({ url: `/api/v1/projects/${projectId}/roles/${code}`, method: 'PUT',
+        headers: { 'Content-Type': 'application/json', },
+        data: updateRoleInputBody
+    });
+};
+/**
+ * @summary 列出项目的公钥
+ */
+export const listProjectSshKeys = (projectId, params) => {
+    return request({ url: `/api/v1/projects/${projectId}/ssh-keys`, method: 'GET',
+        params
+    });
+};
+/**
+ * @summary 给项目添加一把公钥
+ */
+export const createProjectSshKey = (projectId, createProjectSSHKeyInputBody) => {
+    return request({ url: `/api/v1/projects/${projectId}/ssh-keys`, method: 'POST',
+        headers: { 'Content-Type': 'application/json', },
+        data: createProjectSSHKeyInputBody
+    });
+};
+/**
+ * @summary 吊销项目的一把公钥
+ */
+export const revokeProjectSshKey = (projectId, keyId) => {
+    return request({ url: `/api/v1/projects/${projectId}/ssh-keys/${keyId}`, method: 'DELETE'
+    });
+};
+/**
+ * @summary 查看项目的一把公钥
+ */
+export const getProjectSshKey = (projectId, keyId) => {
+    return request({ url: `/api/v1/projects/${projectId}/ssh-keys/${keyId}`, method: 'GET'
+    });
+};
+/**
+ * @summary 给项目的公钥改名
+ */
+export const renameProjectSshKey = (projectId, keyId, renameProjectSSHKeyInputBody) => {
+    return request({ url: `/api/v1/projects/${projectId}/ssh-keys/${keyId}`, method: 'PATCH',
+        headers: { 'Content-Type': 'application/json', },
+        data: renameProjectSSHKeyInputBody
+    });
+};
+/**
+ * 选定一个项目后，用账号令牌换取该项目的令牌。
+
+**只接受 auth.leaflow.net 签发的账号令牌，不接受项目令牌。** 项目令牌过期后，先在 auth.leaflow.net 续期账号令牌，再重新调用这个接口。
+
+换取时会确认账号可用、项目存在，且**调用者是该项目的成员**。非成员无法换取。
+
+令牌只表明身份（用户与项目），**不包含权限**：权限在每次请求时实时判定，所以角色调整立即生效，不必等待令牌过期。
+
+项目处于停用、封禁或删除中时**仍可换取令牌**：这些状态限制的是写入，不影响查看项目当前状况。
+ * @summary 换一张项目令牌
+ */
+export const exchangeProjectToken = (projectId) => {
+    return request({ url: `/api/v1/projects/${projectId}/token`, method: 'POST'
+    });
+};
+/**
+ * OWNER 唯一的移动方式，只有所有者本人能发起——能像普通角色那样授予的话，任何管理员都可以顺手把自己变成所有者。
+ * @summary 转移项目所有权
+ */
+export const transferProjectOwnership = (projectId, transferOwnershipInputBody) => {
+    return request({ url: `/api/v1/projects/${projectId}/transfer-ownership`, method: 'POST',
+        headers: { 'Content-Type': 'application/json', },
+        data: transferOwnershipInputBody
+    });
+};