2022-04-11 09:35:06 +00:00
|
|
|
swagger: "2.0"
|
|
|
|
info:
|
|
|
|
title: REST API NeoFS
|
|
|
|
description: REST API NeoFS
|
|
|
|
version: v1
|
|
|
|
|
|
|
|
host: localhost:8090
|
|
|
|
basePath: /v1
|
|
|
|
schemes:
|
|
|
|
- http
|
|
|
|
# - https
|
|
|
|
|
|
|
|
securityDefinitions:
|
|
|
|
BearerAuth:
|
|
|
|
type: apiKey
|
|
|
|
in: header
|
|
|
|
name: Authorization
|
2022-04-11 11:18:26 +00:00
|
|
|
description: Bearer token body to provide with NeoFS request. Must have 'Bearer ' prefix.
|
2022-04-11 09:35:06 +00:00
|
|
|
|
|
|
|
security:
|
|
|
|
- BearerAuth: [ ]
|
|
|
|
|
2022-04-11 11:18:26 +00:00
|
|
|
parameters:
|
|
|
|
signatureParam:
|
|
|
|
in: header
|
|
|
|
name: X-Neofs-Token-Signature
|
|
|
|
description: Base64 encoded signature for bearer token
|
|
|
|
type: string
|
|
|
|
required: true
|
|
|
|
signatureKeyParam:
|
|
|
|
in: header
|
|
|
|
name: X-Neofs-Token-Signature-Key
|
|
|
|
description: Hex encoded the public part of the key that signed the bearer token
|
|
|
|
type: string
|
|
|
|
required: true
|
|
|
|
|
2022-04-11 09:35:06 +00:00
|
|
|
paths:
|
|
|
|
/auth:
|
|
|
|
post:
|
|
|
|
operationId: auth
|
|
|
|
summary: Form bearer token to futher requests
|
|
|
|
security: [ ]
|
|
|
|
parameters:
|
|
|
|
- in: header
|
|
|
|
description: Supported operation scope for token
|
|
|
|
name: X-Neofs-Token-Scope
|
|
|
|
type: string
|
|
|
|
enum:
|
|
|
|
- object
|
|
|
|
- container
|
|
|
|
required: true
|
|
|
|
- in: header
|
|
|
|
description: Public key of user
|
|
|
|
name: X-Neofs-Token-Signature-Key
|
|
|
|
type: string
|
|
|
|
required: true
|
|
|
|
- in: header
|
|
|
|
description: Token lifetime in epoch
|
|
|
|
name: X-Neofs-Token-Lifetime
|
|
|
|
type: integer
|
|
|
|
default: 100
|
|
|
|
- in: body
|
|
|
|
name: token
|
|
|
|
required: true
|
|
|
|
description: Bearer token
|
|
|
|
schema:
|
|
|
|
$ref: '#/definitions/Bearer'
|
|
|
|
consumes:
|
|
|
|
- application/json
|
|
|
|
produces:
|
|
|
|
- application/json
|
|
|
|
responses:
|
|
|
|
200:
|
|
|
|
description: Base64 encoded stable binary marshaled bearer token
|
|
|
|
schema:
|
|
|
|
$ref: '#/definitions/TokenResponse'
|
|
|
|
400:
|
|
|
|
description: Bad request
|
|
|
|
schema:
|
|
|
|
$ref: '#/definitions/Error'
|
|
|
|
|
|
|
|
/objects:
|
|
|
|
parameters:
|
2022-04-11 11:18:26 +00:00
|
|
|
- $ref: '#/parameters/signatureParam'
|
|
|
|
- $ref: '#/parameters/signatureKeyParam'
|
2022-04-11 09:35:06 +00:00
|
|
|
put:
|
|
|
|
operationId: putObject
|
|
|
|
summary: Upload object to NeoFS
|
|
|
|
parameters:
|
|
|
|
- in: body
|
|
|
|
required: true
|
|
|
|
name: object
|
|
|
|
description: Object info to upload
|
|
|
|
schema:
|
|
|
|
type: object
|
|
|
|
properties:
|
|
|
|
containerId:
|
|
|
|
type: string
|
|
|
|
fileName:
|
|
|
|
type: string
|
|
|
|
payload:
|
|
|
|
type: string
|
|
|
|
required:
|
|
|
|
- containerId
|
|
|
|
- fileName
|
|
|
|
example:
|
|
|
|
containerId: 5HZTn5qkRnmgSz9gSrw22CEdPPk6nQhkwf2Mgzyvkikv
|
|
|
|
fileName: myFile.txt
|
|
|
|
payload: Y29udGVudCBvZiBmaWxl
|
|
|
|
consumes:
|
|
|
|
- application/json
|
|
|
|
produces:
|
|
|
|
- application/json
|
|
|
|
responses:
|
|
|
|
200:
|
|
|
|
description: Address of uploaded objects
|
|
|
|
schema:
|
|
|
|
type: object
|
|
|
|
properties:
|
|
|
|
objectId:
|
|
|
|
type: string
|
|
|
|
containerId:
|
|
|
|
type: string
|
|
|
|
required:
|
|
|
|
- objectId
|
|
|
|
- containerId
|
|
|
|
example:
|
|
|
|
objectId: 8N3o7Dtr6T1xteCt6eRwhpmJ7JhME58Hyu1dvaswuTDd
|
|
|
|
containerId: 5HZTn5qkRnmgSz9gSrw22CEdPPk6nQhkwf2Mgzyvkikv
|
|
|
|
400:
|
|
|
|
description: Bad request
|
|
|
|
schema:
|
|
|
|
$ref: '#/definitions/Error'
|
|
|
|
|
2022-04-11 11:18:26 +00:00
|
|
|
/objects/{containerId}/{objectId}:
|
2022-04-11 09:35:06 +00:00
|
|
|
parameters:
|
2022-04-11 11:18:26 +00:00
|
|
|
- $ref: '#/parameters/signatureParam'
|
|
|
|
- $ref: '#/parameters/signatureKeyParam'
|
|
|
|
- in: path
|
|
|
|
name: containerId
|
2022-04-11 09:35:06 +00:00
|
|
|
type: string
|
|
|
|
required: true
|
2022-04-11 11:18:26 +00:00
|
|
|
description: Base58 encoded container id
|
|
|
|
- in: path
|
|
|
|
name: objectId
|
2022-04-11 09:35:06 +00:00
|
|
|
type: string
|
|
|
|
required: true
|
2022-04-11 11:18:26 +00:00
|
|
|
description: Base58 encoded object id
|
|
|
|
get:
|
|
|
|
operationId: getObjectInfo
|
|
|
|
summary: Get object info by address and
|
|
|
|
responses:
|
|
|
|
200:
|
|
|
|
description: Object info
|
|
|
|
schema:
|
|
|
|
$ref: '#/definitions/ObjectInfo'
|
|
|
|
400:
|
|
|
|
description: Bad request
|
|
|
|
schema:
|
|
|
|
$ref: '#/definitions/Error'
|
|
|
|
|
|
|
|
/containers:
|
|
|
|
parameters:
|
|
|
|
- $ref: '#/parameters/signatureParam'
|
|
|
|
- $ref: '#/parameters/signatureKeyParam'
|
2022-04-11 09:35:06 +00:00
|
|
|
put:
|
|
|
|
operationId: putContainer
|
|
|
|
summary: Create new container in NeoFS
|
|
|
|
parameters:
|
|
|
|
- in: body
|
|
|
|
name: container
|
|
|
|
required: true
|
|
|
|
description: Container info
|
|
|
|
schema:
|
|
|
|
type: object
|
|
|
|
properties:
|
|
|
|
containerName:
|
|
|
|
type: string
|
|
|
|
placementPolicy:
|
|
|
|
type: string
|
|
|
|
basicAcl:
|
|
|
|
type: string
|
|
|
|
required:
|
|
|
|
- containerName
|
|
|
|
example:
|
|
|
|
containerId: container
|
|
|
|
placementPolicy: "REP 3"
|
|
|
|
basicAcl: public-read-write
|
|
|
|
responses:
|
|
|
|
200:
|
|
|
|
description: Address of uploaded objects
|
|
|
|
schema:
|
|
|
|
type: object
|
|
|
|
properties:
|
|
|
|
containerId:
|
|
|
|
type: string
|
|
|
|
required:
|
|
|
|
- containerId
|
|
|
|
example:
|
|
|
|
containerId: 5HZTn5qkRnmgSz9gSrw22CEdPPk6nQhkwf2Mgzyvkikv
|
|
|
|
400:
|
|
|
|
description: Bad request
|
|
|
|
schema:
|
|
|
|
$ref: '#/definitions/Error'
|
|
|
|
|
|
|
|
/containers/{containerId}:
|
|
|
|
get:
|
|
|
|
operationId: getContainer
|
|
|
|
summary: Get container by id
|
|
|
|
security: [ ]
|
|
|
|
parameters:
|
|
|
|
- in: path
|
|
|
|
name: containerId
|
|
|
|
type: string
|
|
|
|
required: true
|
|
|
|
description: Base58 encoded container id
|
|
|
|
responses:
|
|
|
|
200:
|
|
|
|
description: Container info
|
|
|
|
schema:
|
|
|
|
$ref: '#/definitions/ContainerInfo'
|
|
|
|
400:
|
|
|
|
description: Bad request
|
|
|
|
schema:
|
|
|
|
$ref: '#/definitions/Error'
|
|
|
|
|
|
|
|
definitions:
|
|
|
|
Bearer:
|
|
|
|
type: object
|
|
|
|
properties:
|
|
|
|
object:
|
|
|
|
type: array
|
|
|
|
items:
|
|
|
|
$ref: '#/definitions/Record'
|
|
|
|
container:
|
|
|
|
$ref: '#/definitions/Rule'
|
|
|
|
Record:
|
|
|
|
type: object
|
|
|
|
properties:
|
|
|
|
action:
|
|
|
|
$ref: '#/definitions/Action'
|
|
|
|
operation:
|
|
|
|
$ref: '#/definitions/Operation'
|
|
|
|
filters:
|
|
|
|
type: array
|
|
|
|
items:
|
|
|
|
$ref: '#/definitions/Filter'
|
|
|
|
targets:
|
|
|
|
type: array
|
|
|
|
items:
|
|
|
|
$ref: '#/definitions/Target'
|
|
|
|
required:
|
|
|
|
- action
|
|
|
|
- operation
|
|
|
|
- filters
|
|
|
|
- targets
|
|
|
|
example:
|
|
|
|
operation: GET
|
|
|
|
action: ALLOW
|
|
|
|
filters: [ ]
|
|
|
|
targets:
|
|
|
|
- role: OTHERS
|
|
|
|
keys: [ ]
|
|
|
|
Action:
|
|
|
|
type: string
|
|
|
|
enum:
|
|
|
|
- ALLOW
|
|
|
|
- DENY
|
|
|
|
Operation:
|
|
|
|
type: string
|
|
|
|
enum:
|
|
|
|
- GET
|
|
|
|
- HEAD
|
|
|
|
- PUT
|
|
|
|
- DELETE
|
|
|
|
- SEARCH
|
|
|
|
- RANGE
|
|
|
|
- RANGEHASH
|
|
|
|
Filter:
|
|
|
|
type: object
|
|
|
|
properties:
|
|
|
|
headerType:
|
|
|
|
$ref: '#/definitions/HeaderType'
|
|
|
|
matchType:
|
|
|
|
$ref: '#/definitions/MatchType'
|
|
|
|
key:
|
|
|
|
type: string
|
|
|
|
value:
|
|
|
|
type: string
|
|
|
|
required:
|
|
|
|
- headerType
|
|
|
|
- matchType
|
|
|
|
- key
|
|
|
|
- value
|
|
|
|
example:
|
|
|
|
headerType: OBJECT
|
|
|
|
matchType: STRING_NOT_EQUAL
|
|
|
|
key: FileName
|
|
|
|
value: myfile
|
|
|
|
HeaderType:
|
|
|
|
type: string
|
|
|
|
enum:
|
|
|
|
- REQUEST
|
|
|
|
- OBJECT
|
|
|
|
- SERVICE
|
|
|
|
MatchType:
|
|
|
|
type: string
|
|
|
|
enum:
|
|
|
|
- STRING_EQUAL
|
|
|
|
- STRING_NOT_EQUAL
|
|
|
|
Target:
|
|
|
|
type: object
|
|
|
|
properties:
|
|
|
|
role:
|
|
|
|
$ref: '#/definitions/Role'
|
|
|
|
keys:
|
|
|
|
type: array
|
|
|
|
items:
|
|
|
|
type: string
|
|
|
|
required:
|
|
|
|
- role
|
|
|
|
- keys
|
|
|
|
example:
|
|
|
|
role: USER
|
|
|
|
keys:
|
|
|
|
- 021dc56fc6d81d581ae7605a8e00e0e0bab6cbad566a924a527339475a97a8e38e
|
|
|
|
Role:
|
|
|
|
type: string
|
|
|
|
enum:
|
|
|
|
- USER
|
|
|
|
- SYSTEM
|
|
|
|
- OTHERS
|
|
|
|
Rule:
|
|
|
|
type: object
|
|
|
|
properties:
|
|
|
|
verb:
|
|
|
|
$ref: '#/definitions/Verb'
|
|
|
|
containerId:
|
|
|
|
type: string
|
|
|
|
required:
|
|
|
|
- verb
|
|
|
|
Verb:
|
|
|
|
type: string
|
|
|
|
enum:
|
|
|
|
- PUT
|
|
|
|
- DELETE
|
|
|
|
- SETEACL
|
|
|
|
TokenResponse:
|
|
|
|
type: object
|
|
|
|
properties:
|
|
|
|
type:
|
|
|
|
$ref: '#/definitions/TokenType'
|
|
|
|
token:
|
|
|
|
type: string
|
|
|
|
required:
|
|
|
|
- type
|
|
|
|
- token
|
|
|
|
example:
|
|
|
|
- type: object
|
|
|
|
token: sometoken-todo-add
|
|
|
|
- type: container
|
|
|
|
token: ChCpanIBJCpJuJz42KOmGMSnEhsKGTWquaX2Lq6GhhO4faOYkLD0f9WkXuYJlq4aBAhnGAMiIQJgFcIEghQB5lq3AJZOVswInwc1IGhlQ7NCUh4DFO3UATIECAEQAQ==
|
|
|
|
TokenType:
|
|
|
|
type: string
|
|
|
|
enum:
|
|
|
|
- object
|
|
|
|
- container
|
|
|
|
ContainerInfo:
|
|
|
|
type: object
|
|
|
|
properties:
|
|
|
|
containerId:
|
|
|
|
type: string
|
|
|
|
version:
|
|
|
|
type: string
|
|
|
|
ownerId:
|
|
|
|
type: string
|
|
|
|
basicAcl:
|
|
|
|
type: string
|
|
|
|
placementPolicy:
|
|
|
|
type: string
|
|
|
|
attributes:
|
|
|
|
type: array
|
|
|
|
items:
|
|
|
|
$ref: '#/definitions/Attribute'
|
2022-04-11 11:18:26 +00:00
|
|
|
required:
|
|
|
|
- containerId
|
|
|
|
- version
|
|
|
|
- ownerId
|
|
|
|
- basicAcl
|
|
|
|
- placementPolicy
|
|
|
|
- attributes
|
2022-04-11 09:35:06 +00:00
|
|
|
example:
|
|
|
|
containerId: 5HZTn5qkRnmgSz9gSrw22CEdPPk6nQhkwf2Mgzyvkikv
|
|
|
|
version: "2.11"
|
|
|
|
ownerId: NbUgTSFvPmsRxmGeWpuuGeJUoRoi6PErcM
|
|
|
|
basicAcl: "0x1fbf9fff"
|
|
|
|
placementPolicy: "REP 2"
|
|
|
|
attribute:
|
|
|
|
- key: Timestamp
|
|
|
|
value: "1648810072"
|
|
|
|
- key: Name
|
|
|
|
value: container
|
2022-04-11 11:18:26 +00:00
|
|
|
ObjectInfo:
|
|
|
|
type: object
|
|
|
|
properties:
|
|
|
|
containerId:
|
|
|
|
type: string
|
|
|
|
objectId:
|
|
|
|
type: string
|
|
|
|
ownerId:
|
|
|
|
type: string
|
|
|
|
attributes:
|
|
|
|
type: array
|
|
|
|
items:
|
|
|
|
$ref: '#/definitions/Attribute'
|
|
|
|
required:
|
|
|
|
- containerId
|
|
|
|
- objectId
|
|
|
|
- ownerId
|
|
|
|
- attributes
|
|
|
|
example:
|
|
|
|
containerId: 5HZTn5qkRnmgSz9gSrw22CEdPPk6nQhkwf2Mgzyvkikv
|
|
|
|
objectId: 8N3o7Dtr6T1xteCt6eRwhpmJ7JhME58Hyu1dvaswuTDd
|
|
|
|
ownerId: NbUgTSFvPmsRxmGeWpuuGeJUoRoi6PErcM
|
|
|
|
attribute:
|
|
|
|
- key: Timestamp
|
|
|
|
value: "1648810072"
|
|
|
|
- key: Name
|
|
|
|
value: object
|
|
|
|
|
2022-04-11 09:35:06 +00:00
|
|
|
Attribute:
|
|
|
|
type: object
|
|
|
|
properties:
|
|
|
|
key:
|
|
|
|
type: string
|
|
|
|
value:
|
|
|
|
type: string
|
2022-04-11 11:18:26 +00:00
|
|
|
required:
|
|
|
|
- key
|
|
|
|
- value
|
2022-04-11 09:35:06 +00:00
|
|
|
Principal:
|
|
|
|
type: string
|
|
|
|
Error:
|
|
|
|
type: string
|