harbor/api/v2.0/swagger.yaml
He Weiwei c729e3b9e0 feat(swagger): generate apis v2.0 from swagger.yaml
Signed-off-by: He Weiwei <hweiwei@vmware.com>
2020-01-14 02:20:18 +00:00

244 lines
6.3 KiB
YAML

swagger: '2.0'
info:
title: Harbor API
description: These APIs provide services for manipulating Harbor project.
version: '2.0'
host: localhost
schemes:
- http
- https
basePath: /api/v2.0
produces:
- application/json
consumes:
- application/json
securityDefinitions:
basicAuth:
type: basic
security:
- basicAuth: []
paths:
/projects/{project_id}/repositories/{repository_id}/artifacts/{artifact_id}:
get:
summary: Read artifact by id
description: endpoint returns artifact by id
tags:
- artifact
operationId: readArtifact
parameters:
- $ref: '#/parameters/requestId'
- $ref: '#/parameters/projectId'
- $ref: '#/parameters/repositoryId'
- $ref: '#/parameters/artifactId'
responses:
'200':
description: OK
schema:
$ref: '#/definitions/Artifact'
'401':
$ref: '#/responses/401'
'403':
$ref: '#/responses/403'
'500':
$ref: '#/responses/500'
delete:
summary: Delete artifact by id
description: endpoint to delete the artifact by id
tags:
- artifact
operationId: deleteArtifact
parameters:
- $ref: '#/parameters/requestId'
- $ref: '#/parameters/projectId'
- $ref: '#/parameters/repositoryId'
- $ref: '#/parameters/artifactId'
responses:
'200':
description: Artifact is deleted successfully.
'401':
$ref: '#/responses/401'
'403':
$ref: '#/responses/403'
'500':
$ref: '#/responses/500'
/projects/{project_id}/repositories/{repository_id}/artifacts:
get:
summary: List artifacts of the repository
description: endpoint returns all artifacts of the repository.
tags:
- artifact
operationId: listArtifacts
parameters:
- $ref: '#/parameters/requestId'
- $ref: '#/parameters/projectId'
- $ref: '#/parameters/repositoryId'
- $ref: '#/parameters/page'
- $ref: '#/parameters/pageSize'
- name: label
in: query
description: Response for artifact include label info when it's true
type: boolean
required: false
default: false
- name: signature
in: query
description: Response for artifact include signature info when it's true
type: boolean
required: false
default: false
- name: vulnerability
in: query
description: Response for artifact include vulnerability info when it's true
type: boolean
required: false
default: false
responses:
'200':
description: OK
headers:
X-Total-Count:
description: The total count of artifacts
type: integer
Link:
description: Link refers to the previous page and next page
type: string
schema:
type: array
items:
$ref: '#/definitions/Artifact'
'401':
$ref: '#/responses/401'
'403':
$ref: '#/responses/403'
'500':
$ref: '#/responses/500'
parameters:
requestId:
name: X-Request-Id
description: A unique id for the request
in: header
type: string
required: false
minLength: 1
projectId:
name: project_id
in: path
description: The id of the project
required: true
type: integer
format: int64
repositoryId:
name: repository_id
in: path
description: The id of the repository
required: true
type: integer
format: int64
artifactId:
name: artifact_id
in: path
description: The id of the artifact
required: true
type: integer
format: int64
page:
name: page
in: query
type: integer
format: int32
required: false
description: 'The page number, default is 1.'
default: 1
pageSize:
name: page_size
in: query
type: integer
format: int32
required: false
description: 'The size of per page, default is 10, maximum is 100.'
default: 10
responses:
'401':
description: UnauthorizedError
headers:
X-Request-Id:
description: The request id this is a response to
type: string
schema:
$ref: '#/definitions/Error'
'403':
description: ForbiddenError
headers:
X-Request-Id:
description: The request id this is a response to
type: string
schema:
$ref: '#/definitions/Error'
'500':
description: InternalServerError
headers:
X-Request-Id:
description: The request id this is a response to
type: string
schema:
$ref: '#/definitions/Error'
definitions:
Error:
description: a model for all the error response coming from harbor
type: object
properties:
code:
type: string
description: The error code
message:
type: string
description: The error message
x-go-type:
import:
package: "github.com/goharbor/harbor/src/internal/error"
alias: "ierrors"
type: "Error"
Artifact:
type: object
properties:
id:
type: integer
format: int64
description: The id of the artifact
type:
type: string
description: The type of the artifact, eg image, chart, etc
repository:
$ref: '#/definitions/Repository'
description: The repository of the artifact
tags:
description: The list of tags that attached to the artifact
media_type:
type: string
description: The specific media type for the artifact
digest:
type: string
description: The digest of the artifact
size:
type: string
format: int64
description: The size of the artifact
upload_time:
type: string
format: date-time
description: The upload time for the artifact
labels:
description: The list of labels that attached to the artifact
signature:
description: The signature attached to the artifact
Repository:
type: object
properties:
id:
type: integer
format: int64
description: The id of the repository
name:
type: string
description: The name of repository.