Files
oci-portal/docs/swagger.yaml
T
wangdefa 81d4650f3d
CI / test (push) Successful in 31s
Release / release (push) Successful in 57s
代理批量关联租户接口、关于页运行时与资源指标
2026-07-13 12:23:18 +08:00

4191 lines
95 KiB
YAML

basePath: /
definitions:
internal_api.attachBootVolumeRequest:
properties:
bootVolumeId:
type: string
region:
type: string
required:
- bootVolumeId
type: object
internal_api.attachVnicRequest:
properties:
assignIpv6:
description: AssignIpv6 为 true 时同时自动分配一个 IPv6(要求子网已启用 IPv6)。
type: boolean
assignPublicIp:
type: boolean
displayName:
type: string
privateIp:
type: string
region:
type: string
subnetId:
type: string
required:
- subnetId
type: object
internal_api.attachVolumeRequest:
properties:
readOnly:
type: boolean
region:
type: string
volumeId:
type: string
required:
- volumeId
type: object
internal_api.createConsoleConnectionRequest:
properties:
region:
type: string
sshPublicKey:
type: string
required:
- sshPublicKey
type: object
internal_api.createIdpRequest:
properties:
assertionAttribute:
type: string
description:
type: string
iconUrl:
type: string
jitAssignAdminGroup:
type: boolean
jitCreate:
type: boolean
jitEnabled:
type: boolean
jitMapEmail:
type: boolean
jitUpdate:
type: boolean
metadata:
type: string
name:
type: string
nameIdFormat:
type: string
userStoreAttribute:
type: string
required:
- metadata
- name
type: object
internal_api.createInstanceRequest:
properties:
assignIpv6:
type: boolean
assignPublicIp:
type: boolean
availabilityDomain:
description: 为空时默认使用第一个可用域
type: string
bootVolumeId:
type: string
bootVolumeSizeGBs:
type: integer
bootVolumeVpusPerGB:
type: integer
compartmentId:
description: 为空时建在租户根
type: string
count:
description: 批量创建数量,缺省 1,上限 10
type: integer
displayName:
type: string
generateRootPassword:
description: 服务端生成随机 root 密码并写入 TAG RootPassword
type: boolean
imageId:
type: string
memoryInGBs:
type: number
ocpus:
type: number
region:
type: string
rootPassword:
type: string
shape:
type: string
sshPublicKey:
type: string
subnetId:
description: 为空时自动创建 VCN 与子网
type: string
userData:
type: string
required:
- displayName
- shape
type: object
internal_api.createSecurityListRequest:
properties:
displayName:
type: string
egressRules:
items:
$ref: '#/definitions/oci-portal_internal_oci.SecurityRule'
type: array
ingressRules:
items:
$ref: '#/definitions/oci-portal_internal_oci.SecurityRule'
type: array
region:
type: string
vcnId:
type: string
required:
- displayName
- vcnId
type: object
internal_api.createSubnetRequest:
properties:
cidrBlock:
type: string
displayName:
type: string
dnsLabel:
type: string
ipv6CidrBlock:
type: string
prohibitPublicIp:
type: boolean
region:
type: string
vcnId:
type: string
required:
- cidrBlock
- displayName
- vcnId
type: object
internal_api.createTaskRequest:
properties:
cronExpr:
type: string
name:
type: string
payload:
items:
type: integer
type: array
type:
type: string
required:
- cronExpr
- name
- type
type: object
internal_api.createTenantUserRequest:
properties:
addToAdminGroup:
type: boolean
description:
type: string
email:
type: string
familyName:
type: string
givenName:
type: string
grantDomainAdmin:
description: 同时勾选时先授身份域管理员,再加入管理员组
type: boolean
name:
type: string
required:
- familyName
- givenName
- name
type: object
internal_api.createVCNRequest:
properties:
cidrBlock:
type: string
compartmentId:
description: 为空时建在租户根
type: string
displayName:
type: string
dnsLabel:
type: string
enableIpv6:
description: 缺省默认启用
type: boolean
region:
type: string
required:
- cidrBlock
- displayName
type: object
internal_api.enableIPv6Request:
properties:
region:
type: string
type: object
internal_api.importRequest:
properties:
alias:
type: string
configIni:
type: string
fingerprint:
type: string
group:
description: 面板内自定义分组,可空
type: string
multiCompartment:
description: 开启后 compartment 入库缓存
type: boolean
multiRegion:
description: 开启后订阅区域入库缓存
type: boolean
passphrase:
type: string
privateKey:
type: string
proxyId:
description: 关联出站代理,null 直连
type: integer
region:
type: string
tenancyOcid:
type: string
userOcid:
type: string
required:
- alias
- privateKey
type: object
internal_api.instanceActionRequest:
properties:
action:
type: string
region:
type: string
required:
- action
type: object
internal_api.loginRequest:
properties:
password:
maxLength: 128
type: string
totpCode:
description: 两步验证码;账号已启用 TOTP 时必填,缺失返回 428
maxLength: 8
type: string
username:
description: 字段长度上限防超长输入撑爆登录守卫与 bcrypt(S-03)
maxLength: 64
type: string
required:
- password
- username
type: object
internal_api.renameRequest:
properties:
displayName:
type: string
region:
type: string
required:
- displayName
type: object
internal_api.subscribeRegionRequest:
properties:
regionKey:
type: string
required:
- regionKey
type: object
internal_api.updateBootVolumeRequest:
properties:
displayName:
type: string
region:
type: string
sizeInGBs:
type: integer
vpusPerGB:
type: integer
type: object
internal_api.updateInstanceRequest:
properties:
displayName:
type: string
memoryInGBs:
type: number
ocpus:
type: number
region:
type: string
shape:
description: 更换 shape,运行中实例会自动重启
type: string
type: object
internal_api.updateNotifyChannelRequest:
properties:
bodyTemplate:
type: string
enabled:
type: boolean
from:
type: string
host:
type: string
port:
type: integer
secret:
type: string
server:
type: string
to:
type: string
topic:
type: string
url:
type: string
username:
type: string
type: object
internal_api.updateSecurityListRequest:
properties:
displayName:
type: string
egressRules:
items:
$ref: '#/definitions/oci-portal_internal_oci.SecurityRule'
type: array
ingressRules:
items:
$ref: '#/definitions/oci-portal_internal_oci.SecurityRule'
type: array
region:
type: string
type: object
internal_api.updateTaskRequest:
properties:
cronExpr:
type: string
name:
type: string
payload:
items:
type: integer
type: array
status:
type: string
type: object
internal_api.updateTelegramRequest:
properties:
botToken:
type: string
chatId:
type: string
enabled:
type: boolean
type: object
internal_api.updateTenantUserRequest:
properties:
addToAdminGroup:
type: boolean
description:
type: string
email:
type: string
familyName:
type: string
givenName:
type: string
grantDomainAdmin:
type: boolean
type: object
oci-portal_internal_oci.SecurityRule:
properties:
description:
type: string
destination:
type: string
icmpCode:
type: integer
icmpType:
type: integer
isStateless:
type: boolean
portMax:
type: integer
portMin:
type: integer
protocol:
description: all、6(TCP)、17(UDP)、1(ICMP)、58(ICMPv6)
type: string
source:
type: string
type: object
oci-portal_internal_service.ChannelInput:
properties:
enabled:
type: boolean
group:
type: string
name:
type: string
ociConfigId:
type: integer
priority:
type: integer
region:
type: string
weight:
type: integer
type: object
oci-portal_internal_service.NotifyEventsView:
properties:
logEventIdentity:
type: boolean
logEventInstance:
type: boolean
logEventLogin:
type: boolean
logEventPolicy:
type: boolean
logEventRegion:
type: boolean
loginLock:
type: boolean
modelDeprecated:
type: boolean
snatchSuccess:
type: boolean
taskFail:
type: boolean
taskRecover:
type: boolean
taskStop:
type: boolean
tenantDead:
type: boolean
type: object
oci-portal_internal_service.OAuthProvidersView:
properties:
githubClientId:
type: string
githubDisabled:
type: boolean
githubDisplayName:
type: string
githubSecretSet:
type: boolean
oidcClientId:
type: string
oidcDisabled:
type: boolean
oidcDisplayName:
type: string
oidcIssuer:
type: string
oidcSecretSet:
type: boolean
type: object
oci-portal_internal_service.ProxyInput:
properties:
host:
type: string
name:
type: string
password:
type: string
port:
type: integer
type:
type: string
username:
type: string
required:
- host
- port
- type
type: object
oci-portal_internal_service.SecuritySettings:
properties:
appUrl:
description: 面板公网基址;优先于 PUBLIC_URL 环境变量,回传链路与 OAuth 回调用
type: string
ipRateBurst:
type: integer
ipRateRps:
description: 全局 IP 限速令牌桶
type: integer
loginFailLimit:
description: 登录守卫:LockMinutes 分钟窗口内失败 FailLimit 次锁 LockMinutes 分钟
type: integer
loginLockMinutes:
type: integer
realIpHeader:
description: 真实IP请求头:空 = 直连(RemoteAddr);反代后必须选择与反代匹配的头
type: string
type: object
oci-portal_internal_service.TaskSettingsView:
properties:
snatchAuthFailLimit:
type: integer
type: object
oci-portal_internal_service.UpdateCredentialsInput:
properties:
currentPassword:
type: string
newPassword:
type: string
newUsername:
type: string
required:
- currentPassword
type: object
oci-portal_internal_service.UpdateOAuthInput:
properties:
githubClientId:
type: string
githubClientSecret:
type: string
githubDisabled:
type: boolean
githubDisplayName:
type: string
oidcClientId:
type: string
oidcClientSecret:
type: string
oidcDisabled:
type: boolean
oidcDisplayName:
type: string
oidcIssuer:
type: string
type: object
info:
contact: {}
description: '自托管 OCI 多租户管理面板 API。业务接口用 JWT(Bearer);AI 网关端点(/ai/v1/*)用独立网关密钥(Authorization:
Bearer 或 x-api-key)。'
title: OCI Portal API
version: 0.0.1
paths:
/ai/v1/chat/completions:
post:
parameters:
- description: OpenAI chat/completions 请求体(支持 stream;经 Responses 转换直通)
in: body
name: body
required: true
schema:
type: object
responses:
"200":
description: 'OpenAI 兼容响应(流式为 SSE,末尾 data: [DONE])'
schema:
additionalProperties: true
type: object
summary: OpenAI Chat Completions 兼容端点
tags:
- AI 网关
/ai/v1/embeddings:
post:
parameters:
- description: OpenAI embeddings 请求体
in: body
name: body
required: true
schema:
type: object
responses:
"200":
description: OpenAI 兼容响应
schema:
additionalProperties: true
type: object
summary: OpenAI 兼容向量嵌入
tags:
- AI 网关
/ai/v1/messages:
post:
parameters:
- description: Anthropic messages 请求体(支持 stream;经 OCI OpenAI 兼容面直通)
in: body
name: body
required: true
schema:
type: object
responses:
"200":
description: Anthropic 兼容响应(流式为 SSE)
schema:
additionalProperties: true
type: object
summary: Anthropic Messages 兼容端点
tags:
- AI 网关
/ai/v1/models:
get:
responses:
"200":
description: OpenAI 兼容 models 列表
schema:
additionalProperties: true
type: object
summary: 可用模型列表
tags:
- AI 网关
/ai/v1/responses:
post:
parameters:
- description: OpenAI responses 请求体(支持 stream;web_search/x_search 服务端工具仅非流式)
in: body
name: body
required: true
schema:
type: object
responses:
"200":
description: OpenAI 兼容响应(流式为 SSE)
schema:
additionalProperties: true
type: object
summary: OpenAI Responses 兼容端点
tags:
- AI 网关
/api/v1/about:
get:
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 返回构建、运行时长与资源占用信息,「设置 · 关于」页展示
tags:
- 设置
/api/v1/ai-blacklist:
get:
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 模型黑名单列表
tags:
- AI 管理
post:
parameters:
- description: '请求体:{name: 模型名}'
in: body
name: body
required: true
schema:
type: object
responses:
"201":
description: Created
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 添加模型黑名单
tags:
- AI 管理
/api/v1/ai-blacklist/{id}:
delete:
parameters:
- description: 黑名单条目 ID
in: path
name: id
required: true
type: integer
responses:
"204":
description: 无内容
security:
- BearerAuth: []
summary: 移除模型黑名单(重新同步后模型恢复入池)
tags:
- AI 管理
/api/v1/ai-channels:
get:
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: '---- 渠道 ----'
tags:
- AI 管理
post:
parameters:
- description: 请求体
in: body
name: body
required: true
schema:
$ref: '#/definitions/oci-portal_internal_service.ChannelInput'
responses:
"201":
description: Created
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 创建 AI 渠道
tags:
- AI 管理
/api/v1/ai-channels/{id}:
delete:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
responses:
"204":
description: 无内容
security:
- BearerAuth: []
summary: 删除 AI 渠道
tags:
- AI 管理
put:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: 请求体
in: body
name: body
required: true
schema:
$ref: '#/definitions/oci-portal_internal_service.ChannelInput'
responses:
"204":
description: 无内容
security:
- BearerAuth: []
summary: 更新 AI 渠道
tags:
- AI 管理
/api/v1/ai-channels/{id}/probe:
post:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 触发探测:服务可见性 + 模型同步 + 配额试调,返回更新后的渠道
tags:
- AI 管理
/api/v1/ai-channels/{id}/sync-models:
post:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 同步渠道模型缓存
tags:
- AI 管理
/api/v1/ai-content-logs:
get:
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 分页查询内容日志
tags:
- AI 管理
/api/v1/ai-keys:
get:
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: '---- 密钥 ----'
tags:
- AI 管理
post:
parameters:
- description: 请求体(见接口说明)
in: body
name: body
required: true
schema:
type: object
responses:
"201":
description: Created
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 生成密钥
tags:
- AI 管理
/api/v1/ai-keys/{id}:
delete:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
responses:
"204":
description: 无内容
security:
- BearerAuth: []
summary: 删除 AI 网关密钥
tags:
- AI 管理
put:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: 请求体(见接口说明)
in: body
name: body
required: true
schema:
type: object
responses:
"204":
description: 无内容
security:
- BearerAuth: []
summary: 更新 AI 网关密钥
tags:
- AI 管理
/api/v1/ai-keys/{id}/content-log:
put:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: 请求体(见接口说明)
in: body
name: body
required: true
schema:
type: object
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 设置密钥内容日志窗口
tags:
- AI 管理
/api/v1/ai-logs:
get:
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: AI 调用日志列表
tags:
- AI 管理
/api/v1/ai-models:
get:
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: '---- 聚合模型与调用日志 ----'
tags:
- AI 管理
/api/v1/auth/credentials:
get:
responses:
"200":
description: username 与 passwordLoginDisabled
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 登录凭据摘要
tags:
- 认证
put:
parameters:
- description: 新凭据(当前密码必验)
in: body
name: body
required: true
schema:
$ref: '#/definitions/oci-portal_internal_service.UpdateCredentialsInput'
responses:
"204":
description: 已更新,请重新登录
"401":
description: 当前密码错误
schema:
additionalProperties:
type: string
type: object
security:
- BearerAuth: []
summary: 修改登录凭据
tags:
- 认证
/api/v1/auth/identities:
get:
responses:
"200":
description: items
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 已绑定外部身份
tags:
- 认证
/api/v1/auth/identities/{id}:
delete:
parameters:
- description: 身份 ID
in: path
name: id
required: true
type: integer
responses:
"204":
description: 已解绑
"409":
description: 最后一个身份不可解绑
schema:
additionalProperties:
type: string
type: object
security:
- BearerAuth: []
summary: 解绑外部身份
tags:
- 认证
/api/v1/auth/login:
post:
consumes:
- application/json
parameters:
- description: 登录凭据
in: body
name: body
required: true
schema:
$ref: '#/definitions/internal_api.loginRequest'
produces:
- application/json
responses:
"200":
description: token 与 expiresAt
schema:
additionalProperties: true
type: object
"401":
description: 凭据错误
schema:
additionalProperties:
type: string
type: object
"428":
description: 需要两步验证码(totpRequired=true)
schema:
additionalProperties: true
type: object
summary: 登录
tags:
- 认证
/api/v1/auth/logout:
post:
responses:
"204":
description: 令牌已吊销
security:
- BearerAuth: []
summary: 登出
tags:
- 认证
/api/v1/auth/oauth/{provider}/authorize:
get:
parameters:
- description: oidc / github
in: path
name: provider
required: true
type: string
- description: bind=绑定当前账号(需 Bearer),缺省登录
in: query
name: mode
type: string
responses:
"200":
description: url
schema:
additionalProperties:
type: string
type: object
summary: 外部登录授权跳转
tags:
- 认证
/api/v1/auth/oauth/{provider}/callback:
get:
parameters:
- description: oidc / github
in: path
name: provider
required: true
type: string
- description: 授权流程 state
in: query
name: state
required: true
type: string
- description: 授权码
in: query
name: code
required: true
type: string
responses:
"302":
description: 登录 token 经 fragment 回前端,绑定回设置页
summary: 外部登录回调
tags:
- 认证
/api/v1/auth/oauth/providers:
get:
responses:
"200":
description: providers 与 passwordLoginDisabled
schema:
additionalProperties: true
type: object
summary: 外部登录 provider 列表
tags:
- 认证
/api/v1/auth/password-login:
put:
parameters:
- description: '{disabled: bool}'
in: body
name: body
required: true
schema:
type: object
responses:
"204":
description: 已保存
"409":
description: 未绑定外部身份
schema:
additionalProperties:
type: string
type: object
security:
- BearerAuth: []
summary: 密码登录开关
tags:
- 认证
/api/v1/auth/revoke-sessions:
post:
responses:
"200":
description: 新 token 与 expiresAt
schema:
additionalProperties:
type: string
type: object
security:
- BearerAuth: []
summary: 撤销全部会话
tags:
- 认证
/api/v1/auth/totp:
get:
responses:
"200":
description: enabled
schema:
additionalProperties:
type: boolean
type: object
security:
- BearerAuth: []
summary: 两步验证状态
tags:
- 认证
/api/v1/auth/totp/activate:
post:
parameters:
- description: '{code: 6 位验证码}'
in: body
name: body
required: true
schema:
type: object
responses:
"204":
description: 已启用
security:
- BearerAuth: []
summary: 激活两步验证
tags:
- 认证
/api/v1/auth/totp/disable:
post:
parameters:
- description: '{password 或 code 任一确认}'
in: body
name: body
required: true
schema:
type: object
responses:
"204":
description: 已停用
security:
- BearerAuth: []
summary: 停用两步验证
tags:
- 认证
/api/v1/auth/totp/setup:
post:
responses:
"200":
description: secret 与 otpauthUri
schema:
additionalProperties:
type: string
type: object
"409":
description: 已启用
schema:
additionalProperties:
type: string
type: object
security:
- BearerAuth: []
summary: 发起两步验证设置
tags:
- 认证
/api/v1/console-sessions/{sessionId}:
delete:
parameters:
- description: 会话 ID
in: path
name: sessionId
required: true
type: string
responses:
"204":
description: 无内容
security:
- BearerAuth: []
summary: 关闭网页控制台会话
tags:
- 网页控制台
/api/v1/console-sessions/{sessionId}/ws:
get:
parameters:
- description: 会话 ID
in: path
name: sessionId
required: true
type: string
- description: JWT(浏览器 WebSocket 无法带头,经 query 传递)
in: query
name: token
required: true
type: string
responses:
"101":
description: 升级为 WebSocket
summary: 控制台 WebSocket 数据面
tags:
- 网页控制台
/api/v1/log-events:
get:
parameters:
- description: 按配置过滤
in: query
name: configId
type: integer
- description: 关键字
in: query
name: q
type: string
responses:
"200":
description: items 与 total
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 回传日志事件列表
tags:
- 任务与日志回传
/api/v1/oci-configs:
get:
responses:
"200":
description: items
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 租户配置列表
tags:
- 租户配置
post:
parameters:
- description: API Key 配置(私钥密文落库)
in: body
name: body
required: true
schema:
$ref: '#/definitions/internal_api.importRequest'
responses:
"201":
description: Created
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 导入租户配置
tags:
- 租户配置
/api/v1/oci-configs/{id}:
delete:
description: 删除租户配置及其本地关联任务、快照、回传、告警和 AI 渠道数据,并撤销 Webhook 密钥;不删除 OCI 云端资源。
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
responses:
"204":
description: 无内容
security:
- BearerAuth: []
summary: 删除租户配置
tags:
- 租户配置
get:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 租户配置详情
tags:
- 租户配置
put:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: 可更新字段(别名/分组/代理/多区域开关等)
in: body
name: body
required: true
schema:
type: object
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 更新租户配置
tags:
- 租户配置
/api/v1/oci-configs/{id}/audit-events:
get:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: 续查游标(上次响应原样带回)
in: query
name: cursor
type: string
- description: 单批目标条数,缺省 100,上限 200
in: query
name: limit
type: integer
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 批式懒加载查询租户 OCI 审计事件
tags:
- 租户 IAM
/api/v1/oci-configs/{id}/audit-events/detail:
get:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 按 eventId 取回原始事件 JSON:缓存命中秒开,
tags:
- 租户 IAM
/api/v1/oci-configs/{id}/availability-domains:
get:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 可用域列表
tags:
- 租户配置
/api/v1/oci-configs/{id}/boot-volume-attachments/{attachmentId}:
delete:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: attachmentId
in: path
name: attachmentId
required: true
type: string
responses:
"204":
description: 无内容
security:
- BearerAuth: []
summary: 分离引导卷
tags:
- 存储
/api/v1/oci-configs/{id}/boot-volumes:
get:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 引导卷列表
tags:
- 存储
/api/v1/oci-configs/{id}/boot-volumes/{bootVolumeId}:
delete:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: bootVolumeId
in: path
name: bootVolumeId
required: true
type: string
responses:
"204":
description: 无内容
security:
- BearerAuth: []
summary: 删除引导卷
tags:
- 存储
get:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: bootVolumeId
in: path
name: bootVolumeId
required: true
type: string
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 引导卷详情
tags:
- 存储
put:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: bootVolumeId
in: path
name: bootVolumeId
required: true
type: string
- description: 请求体
in: body
name: body
required: true
schema:
$ref: '#/definitions/internal_api.updateBootVolumeRequest'
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 更新引导卷
tags:
- 存储
/api/v1/oci-configs/{id}/cached-compartments:
get:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 返回筛选器用区间列表:未开多区间支持返回空数组
tags:
- 租户配置
/api/v1/oci-configs/{id}/cached-regions:
get:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 返回筛选器用区域列表:未开多区域支持只含默认区域
tags:
- 租户配置
/api/v1/oci-configs/{id}/compartments:
get:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 列出租户下全部 ACTIVE compartment
tags:
- 租户配置
/api/v1/oci-configs/{id}/console-connections/{connectionId}:
delete:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: connectionId
in: path
name: connectionId
required: true
type: string
responses:
"204":
description: 无内容
security:
- BearerAuth: []
summary: 删除实例控制台连接
tags:
- 计算
/api/v1/oci-configs/{id}/costs:
get:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 配置成本快照
tags:
- 成本
/api/v1/oci-configs/{id}/domains:
get:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 租户身份域列表
tags:
- 租户 IAM
/api/v1/oci-configs/{id}/identity-providers:
get:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: 身份域 OCID(缺省 Default 域)
in: query
name: domainId
type: string
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 身份提供商列表
tags:
- 租户 IAM
post:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: 身份域 OCID(缺省 Default 域)
in: query
name: domainId
type: string
- description: 请求体
in: body
name: body
required: true
schema:
$ref: '#/definitions/internal_api.createIdpRequest'
responses:
"201":
description: Created
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 创建身份提供商(SAML)
tags:
- 租户 IAM
/api/v1/oci-configs/{id}/identity-providers/{idpId}:
delete:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: 身份域 OCID(缺省 Default 域)
in: query
name: domainId
type: string
- description: idpId
in: path
name: idpId
required: true
type: string
responses:
"204":
description: 无内容
security:
- BearerAuth: []
summary: 删除身份提供商
tags:
- 租户 IAM
/api/v1/oci-configs/{id}/identity-providers/{idpId}/activate:
post:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: 身份域 OCID(缺省 Default 域)
in: query
name: domainId
type: string
- description: idpId
in: path
name: idpId
required: true
type: string
- description: 请求体(见接口说明)
in: body
name: body
required: true
schema:
type: object
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 激活身份提供商
tags:
- 租户 IAM
/api/v1/oci-configs/{id}/identity-settings:
get:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: 身份域 OCID(缺省 Default 域)
in: query
name: domainId
type: string
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 身份域设置
tags:
- 租户 IAM
put:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: 身份域 OCID(缺省 Default 域)
in: query
name: domainId
type: string
- description: 请求体(见接口说明)
in: body
name: body
required: true
schema:
type: object
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 更新身份域设置
tags:
- 租户 IAM
/api/v1/oci-configs/{id}/images:
get:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 镜像列表
tags:
- 租户配置
/api/v1/oci-configs/{id}/images/{imageId}:
get:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: imageId
in: path
name: imageId
required: true
type: string
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 镜像详情
tags:
- 租户配置
/api/v1/oci-configs/{id}/instances:
get:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 实例列表
tags:
- 计算
post:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: 请求体
in: body
name: body
required: true
schema:
$ref: '#/definitions/internal_api.createInstanceRequest'
responses:
"201":
description: Created
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 创建实例
tags:
- 计算
/api/v1/oci-configs/{id}/instances/{instanceId}:
delete:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: instanceId
in: path
name: instanceId
required: true
type: string
responses:
"204":
description: 无内容
security:
- BearerAuth: []
summary: 终止实例
tags:
- 计算
get:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: instanceId
in: path
name: instanceId
required: true
type: string
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 实例详情
tags:
- 计算
put:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: instanceId
in: path
name: instanceId
required: true
type: string
- description: 请求体
in: body
name: body
required: true
schema:
$ref: '#/definitions/internal_api.updateInstanceRequest'
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 更新实例
tags:
- 计算
/api/v1/oci-configs/{id}/instances/{instanceId}/action:
post:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: instanceId
in: path
name: instanceId
required: true
type: string
- description: 请求体
in: body
name: body
required: true
schema:
$ref: '#/definitions/internal_api.instanceActionRequest'
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 实例电源操作(启停/重启)
tags:
- 计算
/api/v1/oci-configs/{id}/instances/{instanceId}/boot-volume-attachments:
get:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: instanceId
in: path
name: instanceId
required: true
type: string
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 引导卷附件列表
tags:
- 存储
post:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: instanceId
in: path
name: instanceId
required: true
type: string
- description: 请求体
in: body
name: body
required: true
schema:
$ref: '#/definitions/internal_api.attachBootVolumeRequest'
responses:
"201":
description: Created
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 附加引导卷
tags:
- 存储
/api/v1/oci-configs/{id}/instances/{instanceId}/change-public-ip:
post:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: instanceId
in: path
name: instanceId
required: true
type: string
- description: 请求体(见接口说明)
in: body
name: body
required: true
schema:
type: object
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: '---- 实例 IP ----'
tags:
- 计算
/api/v1/oci-configs/{id}/instances/{instanceId}/console-connections:
get:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: instanceId
in: path
name: instanceId
required: true
type: string
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 实例控制台连接列表
tags:
- 计算
post:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: instanceId
in: path
name: instanceId
required: true
type: string
- description: 请求体
in: body
name: body
required: true
schema:
$ref: '#/definitions/internal_api.createConsoleConnectionRequest'
responses:
"201":
description: Created
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 创建实例控制台连接
tags:
- 计算
/api/v1/oci-configs/{id}/instances/{instanceId}/console-sessions:
post:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: 实例 OCID
in: path
name: instanceId
required: true
type: string
- description: '{type: serial|vnc}'
in: body
name: body
required: true
schema:
type: object
responses:
"200":
description: sessionId 与 wsPath
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 创建网页控制台会话
tags:
- 网页控制台
/api/v1/oci-configs/{id}/instances/{instanceId}/ipv6-addresses:
delete:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: instanceId
in: path
name: instanceId
required: true
type: string
responses:
"204":
description: 无内容
security:
- BearerAuth: []
summary: 移除实例 IPv6 地址
tags:
- 计算
post:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: instanceId
in: path
name: instanceId
required: true
type: string
- description: 请求体(见接口说明)
in: body
name: body
required: true
schema:
type: object
responses:
"201":
description: Created
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 实例添加 IPv6 地址
tags:
- 计算
/api/v1/oci-configs/{id}/instances/{instanceId}/replace-boot-volume:
post:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: instanceId
in: path
name: instanceId
required: true
type: string
- description: 请求体
in: body
name: body
required: true
schema:
$ref: '#/definitions/internal_api.attachBootVolumeRequest'
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 更换实例引导卷
tags:
- 存储
/api/v1/oci-configs/{id}/instances/{instanceId}/traffic:
get:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: instanceId
in: path
name: instanceId
required: true
type: string
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: '---- 流量与成本 ----'
tags:
- 计算
/api/v1/oci-configs/{id}/instances/{instanceId}/vnics:
get:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: instanceId
in: path
name: instanceId
required: true
type: string
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 实例 VNIC 列表
tags:
- 计算
post:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: instanceId
in: path
name: instanceId
required: true
type: string
- description: 请求体
in: body
name: body
required: true
schema:
$ref: '#/definitions/internal_api.attachVnicRequest'
responses:
"201":
description: Created
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 附加 VNIC
tags:
- 计算
/api/v1/oci-configs/{id}/instances/{instanceId}/volume-attachments:
get:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: instanceId
in: path
name: instanceId
required: true
type: string
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 卷附件列表
tags:
- 存储
post:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: instanceId
in: path
name: instanceId
required: true
type: string
- description: 请求体
in: body
name: body
required: true
schema:
$ref: '#/definitions/internal_api.attachVolumeRequest'
responses:
"201":
description: Created
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 附加块存储卷
tags:
- 存储
/api/v1/oci-configs/{id}/limits:
get:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 服务限额查询
tags:
- 租户配置
/api/v1/oci-configs/{id}/limits/services:
get:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 限额服务列表
tags:
- 租户配置
/api/v1/oci-configs/{id}/log-relay:
delete:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
responses:
"204":
description: 无内容
security:
- BearerAuth: []
summary: 逆序销毁链路并撤销 secret
tags:
- 任务与日志回传
get:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 查询 OCI 侧链路状态与关键事件清单
tags:
- 任务与日志回传
post:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 一键建立回传链路
tags:
- 任务与日志回传
/api/v1/oci-configs/{id}/log-webhook:
delete:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
responses:
"204":
description: 无内容
security:
- BearerAuth: []
summary: 撤销配置的回传 secret,旧回调地址随即失效
tags:
- 任务与日志回传
get:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 查询配置的回调地址
tags:
- 任务与日志回传
post:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 生成
tags:
- 任务与日志回传
/api/v1/oci-configs/{id}/notification-recipients:
get:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: 身份域 OCID(缺省 Default 域)
in: query
name: domainId
type: string
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: '---- 域通知收件人与密码策略 ----'
tags:
- 租户 IAM
put:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: 身份域 OCID(缺省 Default 域)
in: query
name: domainId
type: string
- description: 请求体(见接口说明)
in: body
name: body
required: true
schema:
type: object
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 更新通知收件人
tags:
- 租户 IAM
/api/v1/oci-configs/{id}/password-policies:
get:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: 身份域 OCID(缺省 Default 域)
in: query
name: domainId
type: string
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 密码策略列表
tags:
- 租户 IAM
/api/v1/oci-configs/{id}/password-policies/{policyId}:
put:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: 身份域 OCID(缺省 Default 域)
in: query
name: domainId
type: string
- description: policyId
in: path
name: policyId
required: true
type: string
- description: 请求体(见接口说明)
in: body
name: body
required: true
schema:
type: object
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 更新密码策略
tags:
- 租户 IAM
/api/v1/oci-configs/{id}/region-subscriptions:
get:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 区域订阅列表
tags:
- 租户配置
post:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: 请求体
in: body
name: body
required: true
schema:
$ref: '#/definitions/internal_api.subscribeRegionRequest'
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 订阅新区域
tags:
- 租户配置
/api/v1/oci-configs/{id}/saml-metadata:
get:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: 身份域 OCID(缺省 Default 域)
in: query
name: domainId
type: string
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 下载 SAML 元数据
tags:
- 租户 IAM
/api/v1/oci-configs/{id}/security-lists:
get:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 安全列表清单
tags:
- 网络
post:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: 请求体
in: body
name: body
required: true
schema:
$ref: '#/definitions/internal_api.createSecurityListRequest'
responses:
"201":
description: Created
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 创建安全列表
tags:
- 网络
/api/v1/oci-configs/{id}/security-lists/{securityListId}:
delete:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: securityListId
in: path
name: securityListId
required: true
type: string
responses:
"204":
description: 无内容
security:
- BearerAuth: []
summary: 删除安全列表
tags:
- 网络
get:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: securityListId
in: path
name: securityListId
required: true
type: string
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 安全列表详情
tags:
- 网络
put:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: securityListId
in: path
name: securityListId
required: true
type: string
- description: 请求体
in: body
name: body
required: true
schema:
$ref: '#/definitions/internal_api.updateSecurityListRequest'
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 更新安全列表
tags:
- 网络
/api/v1/oci-configs/{id}/shapes:
get:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 实例形状列表
tags:
- 租户配置
/api/v1/oci-configs/{id}/sign-on-exemptions:
post:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: 身份域 OCID(缺省 Default 域)
in: query
name: domainId
type: string
- description: 请求体(见接口说明)
in: body
name: body
required: true
schema:
type: object
responses:
"201":
description: Created
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 创建 MFA 豁免规则
tags:
- 租户 IAM
/api/v1/oci-configs/{id}/sign-on-exemptions/{ruleId}:
delete:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: 身份域 OCID(缺省 Default 域)
in: query
name: domainId
type: string
- description: ruleId
in: path
name: ruleId
required: true
type: string
responses:
"204":
description: 无内容
security:
- BearerAuth: []
summary: 删除 MFA 豁免规则
tags:
- 租户 IAM
/api/v1/oci-configs/{id}/sign-on-rules:
get:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: 身份域 OCID(缺省 Default 域)
in: query
name: domainId
type: string
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 单点登录规则列表
tags:
- 租户 IAM
/api/v1/oci-configs/{id}/subnets:
get:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 子网列表
tags:
- 网络
post:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: 请求体
in: body
name: body
required: true
schema:
$ref: '#/definitions/internal_api.createSubnetRequest'
responses:
"201":
description: Created
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 创建子网
tags:
- 网络
/api/v1/oci-configs/{id}/subnets/{subnetId}:
delete:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: subnetId
in: path
name: subnetId
required: true
type: string
responses:
"204":
description: 无内容
security:
- BearerAuth: []
summary: 删除子网
tags:
- 网络
get:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: subnetId
in: path
name: subnetId
required: true
type: string
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 子网详情
tags:
- 网络
put:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: subnetId
in: path
name: subnetId
required: true
type: string
- description: 请求体
in: body
name: body
required: true
schema:
$ref: '#/definitions/internal_api.renameRequest'
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 更新子网
tags:
- 网络
/api/v1/oci-configs/{id}/subscriptions:
get:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 订阅列表
tags:
- 租户配置
/api/v1/oci-configs/{id}/subscriptions/{subscriptionId}:
get:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: subscriptionId
in: path
name: subscriptionId
required: true
type: string
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 订阅详情
tags:
- 租户配置
/api/v1/oci-configs/{id}/users:
get:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: 身份域 OCID(缺省 Default 域)
in: query
name: domainId
type: string
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 租户 IAM 用户列表
tags:
- 租户 IAM
post:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: 身份域 OCID(缺省 Default 域)
in: query
name: domainId
type: string
- description: 请求体
in: body
name: body
required: true
schema:
$ref: '#/definitions/internal_api.createTenantUserRequest'
responses:
"201":
description: Created
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 创建租户 IAM 用户
tags:
- 租户 IAM
/api/v1/oci-configs/{id}/users/{userId}:
delete:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: 身份域 OCID(缺省 Default 域)
in: query
name: domainId
type: string
- description: userId
in: path
name: userId
required: true
type: string
responses:
"204":
description: 无内容
security:
- BearerAuth: []
summary: 删除租户 IAM 用户
tags:
- 租户 IAM
get:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: 身份域 OCID(缺省 Default 域)
in: query
name: domainId
type: string
- description: userId
in: path
name: userId
required: true
type: string
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 租户用户详情
tags:
- 租户 IAM
put:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: 身份域 OCID(缺省 Default 域)
in: query
name: domainId
type: string
- description: userId
in: path
name: userId
required: true
type: string
- description: 请求体
in: body
name: body
required: true
schema:
$ref: '#/definitions/internal_api.updateTenantUserRequest'
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 更新租户 IAM 用户
tags:
- 租户 IAM
/api/v1/oci-configs/{id}/users/{userId}/api-keys:
delete:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: userId
in: path
name: userId
required: true
type: string
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 清除用户全部 API Key
tags:
- 租户 IAM
/api/v1/oci-configs/{id}/users/{userId}/mfa-devices:
delete:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: 身份域 OCID(缺省 Default 域)
in: query
name: domainId
type: string
- description: userId
in: path
name: userId
required: true
type: string
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 清除用户 MFA 设备
tags:
- 租户 IAM
/api/v1/oci-configs/{id}/users/{userId}/reset-password:
post:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: 身份域 OCID(缺省 Default 域)
in: query
name: domainId
type: string
- description: userId
in: path
name: userId
required: true
type: string
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 重置租户用户密码
tags:
- 租户 IAM
/api/v1/oci-configs/{id}/vcns:
get:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: VCN 列表
tags:
- 网络
post:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: 请求体
in: body
name: body
required: true
schema:
$ref: '#/definitions/internal_api.createVCNRequest'
responses:
"201":
description: Created
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 创建 VCN
tags:
- 网络
/api/v1/oci-configs/{id}/vcns/{vcnId}:
delete:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: vcnId
in: path
name: vcnId
required: true
type: string
responses:
"204":
description: 无内容
security:
- BearerAuth: []
summary: 删除 VCN
tags:
- 网络
get:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: vcnId
in: path
name: vcnId
required: true
type: string
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: VCN 详情
tags:
- 网络
put:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: vcnId
in: path
name: vcnId
required: true
type: string
- description: 请求体
in: body
name: body
required: true
schema:
$ref: '#/definitions/internal_api.renameRequest'
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 更新 VCN
tags:
- 网络
/api/v1/oci-configs/{id}/vcns/{vcnId}/enable-ipv6:
post:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: vcnId
in: path
name: vcnId
required: true
type: string
- description: 请求体
in: body
name: body
required: true
schema:
$ref: '#/definitions/internal_api.enableIPv6Request'
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: VCN 启用 IPv6
tags:
- 网络
/api/v1/oci-configs/{id}/verify:
post:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 验证配置连通性并刷新画像
tags:
- 租户配置
/api/v1/oci-configs/{id}/vnic-attachments/{attachmentId}:
delete:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: attachmentId
in: path
name: attachmentId
required: true
type: string
responses:
"204":
description: 无内容
security:
- BearerAuth: []
summary: 分离 VNIC
tags:
- 计算
/api/v1/oci-configs/{id}/vnics/{vnicId}/ipv6-addresses:
post:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: vnicId
in: path
name: vnicId
required: true
type: string
- description: 请求体(见接口说明)
in: body
name: body
required: true
schema:
type: object
responses:
"201":
description: Created
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 为指定 VNIC 添加 IPv6
tags:
- 计算
/api/v1/oci-configs/{id}/volume-attachments/{attachmentId}:
delete:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
- description: attachmentId
in: path
name: attachmentId
required: true
type: string
responses:
"204":
description: 无内容
security:
- BearerAuth: []
summary: 分离块存储卷
tags:
- 存储
/api/v1/oci-configs/{id}/volumes:
get:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 块存储卷列表
tags:
- 存储
/api/v1/overview:
get:
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 返回总览页聚合数据
tags:
- 租户配置
/api/v1/proxies:
get:
responses:
"200":
description: items
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 代理列表
tags:
- 设置
post:
parameters:
- description: 代理配置(密码只写不回)
in: body
name: body
required: true
schema:
$ref: '#/definitions/oci-portal_internal_service.ProxyInput'
responses:
"201":
description: Created
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 创建代理
tags:
- 设置
/api/v1/proxies/{id}:
delete:
parameters:
- description: 代理 ID
in: path
name: id
required: true
type: integer
responses:
"204":
description: 无内容
security:
- BearerAuth: []
summary: 删除代理
tags:
- 设置
put:
parameters:
- description: 代理 ID
in: path
name: id
required: true
type: integer
- description: 代理配置(密码缺省沿用)
in: body
name: body
required: true
schema:
$ref: '#/definitions/oci-portal_internal_service.ProxyInput'
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 更新代理
tags:
- 设置
/api/v1/proxies/{id}/probe:
post:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 手动重测代理出口地区,同步返回最新视图
tags:
- 设置
/api/v1/proxies/{id}/tenants:
put:
parameters:
- description: 代理 ID
in: path
name: id
required: true
type: integer
- description: 请求体 {\
in: body
name: body
required: true
schema:
type: object
responses:
"200":
description: usedBy
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 设置代理关联的租户全集
tags:
- 设置
/api/v1/proxies/import:
post:
parameters:
- description: 请求体(见接口说明)
in: body
name: body
required: true
schema:
type: object
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 批量导入代理
tags:
- 设置
/api/v1/regions:
get:
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 返回本地维护的完整区域表
tags:
- 租户配置
/api/v1/settings/notify-channels:
get:
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 返回全部通知渠道的脱敏视图
tags:
- 设置
/api/v1/settings/notify-channels/{type}:
put:
parameters:
- description: 渠道类型(webhook/ntfy/bark/smtp)
in: path
name: type
required: true
type: string
- description: 请求体
in: body
name: body
required: true
schema:
$ref: '#/definitions/internal_api.updateNotifyChannelRequest'
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 保存单渠道配置并返回全渠道最新视图
tags:
- 设置
/api/v1/settings/notify-channels/{type}/test:
post:
parameters:
- description: 渠道类型(webhook/ntfy/bark/smtp)
in: path
name: type
required: true
type: string
responses:
"204":
description: 无内容
security:
- BearerAuth: []
summary: 向指定渠道发送测试消息
tags:
- 设置
/api/v1/settings/notify-events:
get:
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 返回全部通知事件开关
tags:
- 设置
put:
parameters:
- description: 请求体
in: body
name: body
required: true
schema:
$ref: '#/definitions/oci-portal_internal_service.NotifyEventsView'
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 全量保存五个事件开关并返回最新值
tags:
- 设置
/api/v1/settings/notify-templates:
get:
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 返回全部通知模板
tags:
- 设置
/api/v1/settings/notify-templates/{kind}:
put:
parameters:
- description: kind
in: path
name: kind
required: true
type: string
- description: 请求体(见接口说明)
in: body
name: body
required: true
schema:
type: object
responses:
"204":
description: 无内容
security:
- BearerAuth: []
summary: 保存单个通知模板
tags:
- 设置
/api/v1/settings/notify-templates/{kind}/test:
post:
parameters:
- description: kind
in: path
name: kind
required: true
type: string
- description: 请求体(见接口说明)
in: body
name: body
required: true
schema:
type: object
responses:
"204":
description: 无内容
security:
- BearerAuth: []
summary: 用示例变量渲染模板并同步发送测试消息
tags:
- 设置
/api/v1/settings/oauth:
get:
responses:
"200":
description: OK
schema:
$ref: '#/definitions/oci-portal_internal_service.OAuthProvidersView'
security:
- BearerAuth: []
summary: OAuth provider 配置
tags:
- 设置
put:
parameters:
- description: provider 配置
in: body
name: body
required: true
schema:
$ref: '#/definitions/oci-portal_internal_service.UpdateOAuthInput'
responses:
"200":
description: OK
schema:
$ref: '#/definitions/oci-portal_internal_service.OAuthProvidersView'
security:
- BearerAuth: []
summary: 保存 OAuth provider 配置
tags:
- 设置
/api/v1/settings/security:
get:
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 返回安全设置
tags:
- 设置
put:
parameters:
- description: 请求体
in: body
name: body
required: true
schema:
$ref: '#/definitions/oci-portal_internal_service.SecuritySettings'
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 保存安全设置并返回最新值
tags:
- 设置
/api/v1/settings/task:
get:
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 返回任务行为设置
tags:
- 设置
put:
parameters:
- description: 请求体
in: body
name: body
required: true
schema:
$ref: '#/definitions/oci-portal_internal_service.TaskSettingsView'
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 保存任务行为设置并返回最新值
tags:
- 设置
/api/v1/settings/telegram:
get:
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 返回脱敏后的 Telegram 配置,绝不回 token 明文
tags:
- 设置
put:
parameters:
- description: 请求体
in: body
name: body
required: true
schema:
$ref: '#/definitions/internal_api.updateTelegramRequest'
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 保存配置并返回最新脱敏视图
tags:
- 设置
/api/v1/settings/telegram/test:
post:
responses:
"204":
description: 无内容
security:
- BearerAuth: []
summary: 用当前已保存配置同步发送一条测试消息
tags:
- 设置
/api/v1/system-logs:
get:
responses:
"200":
description: items 与 total
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 系统操作日志列表
tags:
- 设置
/api/v1/tasks:
get:
responses:
"200":
description: OK
schema:
items:
additionalProperties: true
type: object
type: array
security:
- BearerAuth: []
summary: 任务列表
tags:
- 任务与日志回传
post:
parameters:
- description: 任务定义(类型/cron/payload)
in: body
name: body
required: true
schema:
$ref: '#/definitions/internal_api.createTaskRequest'
responses:
"201":
description: Created
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 创建任务
tags:
- 任务与日志回传
/api/v1/tasks/{id}:
delete:
parameters:
- description: 任务 ID
in: path
name: id
required: true
type: integer
responses:
"204":
description: 无内容
security:
- BearerAuth: []
summary: 删除任务
tags:
- 任务与日志回传
get:
parameters:
- description: 任务 ID
in: path
name: id
required: true
type: integer
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 任务详情
tags:
- 任务与日志回传
put:
parameters:
- description: 任务 ID
in: path
name: id
required: true
type: integer
- description: 可更新字段
in: body
name: body
required: true
schema:
$ref: '#/definitions/internal_api.updateTaskRequest'
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 更新任务
tags:
- 任务与日志回传
/api/v1/tasks/{id}/logs:
get:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
responses:
"200":
description: OK
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 任务执行日志
tags:
- 任务与日志回传
/api/v1/tasks/{id}/run:
post:
parameters:
- description: 配置 ID
in: path
name: id
required: true
type: integer
responses:
"202":
description: Accepted
schema:
additionalProperties: true
type: object
"409":
description: 任务正在执行中
schema:
additionalProperties: true
type: object
security:
- BearerAuth: []
summary: 立即执行任务(异步触发,结果经任务日志轮询获取)
tags:
- 任务与日志回传
/api/v1/webhooks/oci-logs/{secret}:
post:
parameters:
- description: 面板生成的回传密钥(鉴权凭据)
in: path
name: secret
required: true
type: string
- description: ONS 消息原文(SubscriptionConfirmation / Notification)
in: body
name: body
required: true
schema:
type: object
responses:
"200":
description: 已受理
"403":
description: 时间戳超窗或证书源非 Oracle 域
schema:
additionalProperties:
type: string
type: object
"404":
description: secret 无效(不暴露端点存在性)
summary: OCI 日志回传入口(ONS HTTPS 订阅投递)
tags:
- 任务与日志回传
securityDefinitions:
BearerAuth:
description: '登录接口返回的 JWT,格式: Bearer <token>'
in: header
name: Authorization
type: apiKey
swagger: "2.0"