> ## Documentation Index
> Fetch the complete documentation index at: https://ppio.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 查询 Endpoint 详情



## OpenAPI

````yaml gpus/v2-spec/get-endpoint.json GET /gpus/v2/endpoints/{endpoint_id}
openapi: 3.0.0
info:
  title: PPIO GPU API v2
  version: 2.0.0
servers:
  - url: https://api.ppio.com
security: []
paths:
  /gpus/v2/endpoints/{endpoint_id}:
    get:
      summary: 查询 Endpoint 详情
      parameters:
        - name: Authorization
          in: header
          required: true
          schema:
            type: string
          description: Bearer 身份验证格式,例如:Bearer `{{API 密钥}}`。
        - name: endpoint_id
          in: path
          required: true
          schema:
            type: string
          description: Endpoint ID。字符串,长度限制:1-255 字符。
      responses:
        '200':
          description: 查询成功
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    description: Endpoint ID
                    example: endpoint-id
                  type:
                    type: string
                    description: Endpoint 类型。可选值:`sync`、`async`
                  name:
                    type: string
                    description: Endpoint 名称
                    example: example-endpoint
                  app_name:
                    type: string
                    description: 应用名称
                    example: example-app
                  status:
                    type: object
                    description: Endpoint 状态信息
                    properties:
                      status:
                        type: string
                        description: 状态值
                        example: running
                      error:
                        type: string
                        description: 错误码或错误类型
                        example: ''
                      message:
                        type: string
                        description: 状态说明或错误信息
                        example: ''
                  url:
                    type: string
                    description: 访问地址
                    example: https://endpoint.example.com/endpoint-id
                  product_id:
                    type: string
                    description: Serverless 产品 ID
                  worker_config:
                    type: object
                    description: Worker 配置
                    example:
                      min_replicas: 0
                      max_replicas: 2
                      idle_timeout: 300
                      max_concurrent_per_worker: 10
                      gpu_num: 1
                      rootfs_size_gb: 20
                      min_cuda_version: '12.4'
                      request_timeout: 60
                  policy:
                    type: object
                    description: 策略配置
                    example:
                      type: queue
                      value: 100
                  image:
                    type: string
                    description: 镜像地址
                    example: registry.example.com/namespace/image:tag
                  registry_auth_id:
                    type: string
                    description: 镜像仓库认证 ID
                    example: registry-auth-id
                  entrypoint:
                    type: string
                    description: 容器 entrypoint
                    example: ''
                  command:
                    type: string
                    description: 启动命令
                    example: cargo run
                  volumes:
                    type: array
                    description: 挂载卷列表
                    items:
                      type: object
                    example:
                      - id: storage-id
                        type: network
                        mount_point: /data
                  envs:
                    type: array
                    description: 环境变量列表
                    items:
                      type: object
                    example:
                      - key: ENV_NAME
                        value: ENV_VALUE
                  ports:
                    type: array
                    items:
                      type: integer
                    description: 端口号列表
                    example:
                      - 8080
                  workers:
                    type: array
                    description: Worker 列表
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: Worker ID
                          example: worker-id
                        status:
                          type: object
                          description: Worker 状态
                          properties:
                            status:
                              type: string
                              description: 状态值
                              example: ready
                            error:
                              type: string
                              description: 错误码或错误类型
                              example: ''
                            message:
                              type: string
                              description: 状态说明或错误信息
                              example: ''
                        log:
                          type: string
                          description: Worker 日志访问地址
                          example: https://logs.example.com/worker-id
                        health:
                          type: boolean
                          description: Worker 是否健康
                          example: true
                        drain:
                          type: boolean
                          description: Worker 是否停止接收请求
                          example: false
                  health_check:
                    type: object
                    description: 健康检查配置
                    example:
                      path: /healthz
                      port: 8080
                  region_id:
                    type: string
                    description: 区域 ID
                    example: region-id
                  member_id:
                    type: string
                    description: 成员 ID
                    example: member-id
                  owner_id:
                    type: string
                    description: 所有者 ID
                    example: 550e8400-e29b-41d4-a716-446655440000
                  created_at:
                    type: integer
                    description: 创建时间。Unix 时间戳
                    example: 1710000000

````