Update swagger docs for InfluxDB 2.0.2 (#1862)

pull/1869/head
Scott Anderson 2020-11-18 15:36:24 -07:00 committed by GitHub
parent 37fdef02ca
commit a834314640
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
4 changed files with 348 additions and 118 deletions

View File

@ -1873,6 +1873,7 @@ paths:
$ref: "#/components/schemas/Error" $ref: "#/components/schemas/Error"
/delete: /delete:
post: post:
operationId: PostDelete
summary: Delete time series data from InfluxDB summary: Delete time series data from InfluxDB
requestBody: requestBody:
description: Predicate delete request description: Predicate delete request
@ -1990,7 +1991,7 @@ paths:
operationId: PostSources operationId: PostSources
tags: tags:
- Sources - Sources
summary: Creates a source summary: Create a source
parameters: parameters:
- $ref: "#/components/parameters/TraceSpan" - $ref: "#/components/parameters/TraceSpan"
requestBody: requestBody:
@ -2814,7 +2815,7 @@ paths:
operationId: GetDashboardsIDLabels operationId: GetDashboardsIDLabels
tags: tags:
- Dashboards - Dashboards
summary: list all labels for a dashboard summary: List all labels for a dashboard
parameters: parameters:
- $ref: "#/components/parameters/TraceSpan" - $ref: "#/components/parameters/TraceSpan"
- in: path - in: path
@ -3305,7 +3306,7 @@ paths:
operationId: DeleteAuthorizationsID operationId: DeleteAuthorizationsID
tags: tags:
- Authorizations - Authorizations
summary: Delete a authorization summary: Delete an authorization
parameters: parameters:
- $ref: "#/components/parameters/TraceSpan" - $ref: "#/components/parameters/TraceSpan"
- in: path - in: path
@ -3681,7 +3682,7 @@ paths:
operationId: DeleteBucketsIDLabelsID operationId: DeleteBucketsIDLabelsID
tags: tags:
- Buckets - Buckets
summary: delete a label from a bucket summary: Delete a label from a bucket
parameters: parameters:
- $ref: "#/components/parameters/TraceSpan" - $ref: "#/components/parameters/TraceSpan"
- in: path - in: path
@ -8479,45 +8480,6 @@ components:
TaskStatusType: TaskStatusType:
type: string type: string
enum: [active, inactive] enum: [active, inactive]
Invite:
properties:
id:
description: the idpe id of the invite
readOnly: true
type: string
email:
type: string
role:
type: string
enum:
- member
- owner
expiresAt:
format: date-time
type: string
links:
type: object
readOnly: true
example:
self: "/api/v2/invites/1"
properties:
self:
type: string
format: uri
required: [id, email, role]
Invites:
type: object
properties:
links:
type: object
properties:
self:
type: string
format: uri
invites:
type: array
items:
$ref: "#/components/schemas/Invite"
User: User:
properties: properties:
id: id:
@ -8978,8 +8940,32 @@ components:
$ref: "#/components/schemas/Legend" $ref: "#/components/schemas/Legend"
xColumn: xColumn:
type: string type: string
generateXAxisTicks:
type: array
items:
type: string
xTotalTicks:
type: integer
xTickStart:
type: number
format: float
xTickStep:
type: number
format: float
yColumn: yColumn:
type: string type: string
generateYAxisTicks:
type: array
items:
type: string
yTotalTicks:
type: integer
yTickStart:
type: number
format: float
yTickStep:
type: number
format: float
shadeBelow: shadeBelow:
type: boolean type: boolean
hoverDimension: hoverDimension:
@ -8990,6 +8976,8 @@ components:
enum: [overlaid, stacked] enum: [overlaid, stacked]
geom: geom:
$ref: "#/components/schemas/XYGeom" $ref: "#/components/schemas/XYGeom"
legendColorizeRows:
type: boolean
legendOpacity: legendOpacity:
type: number type: number
format: float format: float
@ -9039,8 +9027,32 @@ components:
$ref: "#/components/schemas/Legend" $ref: "#/components/schemas/Legend"
xColumn: xColumn:
type: string type: string
generateXAxisTicks:
type: array
items:
type: string
xTotalTicks:
type: integer
xTickStart:
type: number
format: float
xTickStep:
type: number
format: float
yColumn: yColumn:
type: string type: string
generateYAxisTicks:
type: array
items:
type: string
yTotalTicks:
type: integer
yTickStart:
type: number
format: float
yTickStep:
type: number
format: float
upperColumn: upperColumn:
type: string type: string
mainColumn: mainColumn:
@ -9052,6 +9064,8 @@ components:
enum: [auto, x, y, xy] enum: [auto, x, y, xy]
geom: geom:
$ref: "#/components/schemas/XYGeom" $ref: "#/components/schemas/XYGeom"
legendColorizeRows:
type: boolean
legendOpacity: legendOpacity:
type: number type: number
format: float format: float
@ -9101,8 +9115,32 @@ components:
$ref: "#/components/schemas/Legend" $ref: "#/components/schemas/Legend"
xColumn: xColumn:
type: string type: string
generateXAxisTicks:
type: array
items:
type: string
xTotalTicks:
type: integer
xTickStart:
type: number
format: float
xTickStep:
type: number
format: float
yColumn: yColumn:
type: string type: string
generateYAxisTicks:
type: array
items:
type: string
yTotalTicks:
type: integer
yTickStart:
type: number
format: float
yTickStep:
type: number
format: float
shadeBelow: shadeBelow:
type: boolean type: boolean
hoverDimension: hoverDimension:
@ -9117,6 +9155,8 @@ components:
type: string type: string
decimalPlaces: decimalPlaces:
$ref: "#/components/schemas/DecimalPlaces" $ref: "#/components/schemas/DecimalPlaces"
legendColorizeRows:
type: boolean
legendOpacity: legendOpacity:
type: number type: number
format: float format: float
@ -9167,6 +9207,18 @@ components:
type: boolean type: boolean
xColumn: xColumn:
type: string type: string
generateXAxisTicks:
type: array
items:
type: string
xTotalTicks:
type: integer
xTickStart:
type: number
format: float
xTickStep:
type: number
format: float
ySeriesColumns: ySeriesColumns:
type: array type: array
items: items:
@ -9197,6 +9249,8 @@ components:
type: string type: string
ySuffix: ySuffix:
type: string type: string
legendColorizeRows:
type: boolean
legendOpacity: legendOpacity:
type: number type: number
format: float format: float
@ -9248,8 +9302,32 @@ components:
type: boolean type: boolean
xColumn: xColumn:
type: string type: string
generateXAxisTicks:
type: array
items:
type: string
xTotalTicks:
type: integer
xTickStart:
type: number
format: float
xTickStep:
type: number
format: float
yColumn: yColumn:
type: string type: string
generateYAxisTicks:
type: array
items:
type: string
yTotalTicks:
type: integer
yTickStart:
type: number
format: float
yTickStep:
type: number
format: float
fillColumns: fillColumns:
type: array type: array
items: items:
@ -9280,6 +9358,8 @@ components:
type: string type: string
ySuffix: ySuffix:
type: string type: string
legendColorizeRows:
type: boolean
legendOpacity: legendOpacity:
type: number type: number
format: float format: float
@ -9330,8 +9410,32 @@ components:
type: boolean type: boolean
xColumn: xColumn:
type: string type: string
generateXAxisTicks:
type: array
items:
type: string
xTotalTicks:
type: integer
xTickStart:
type: number
format: float
xTickStep:
type: number
format: float
yColumn: yColumn:
type: string type: string
generateYAxisTicks:
type: array
items:
type: string
yTotalTicks:
type: integer
yTickStart:
type: number
format: float
yTickStep:
type: number
format: float
xDomain: xDomain:
type: array type: array
items: items:
@ -9356,6 +9460,8 @@ components:
type: string type: string
binSize: binSize:
type: number type: number
legendColorizeRows:
type: boolean
legendOpacity: legendOpacity:
type: number type: number
format: float format: float
@ -9409,11 +9515,6 @@ components:
$ref: "#/components/schemas/Legend" $ref: "#/components/schemas/Legend"
decimalPlaces: decimalPlaces:
$ref: "#/components/schemas/DecimalPlaces" $ref: "#/components/schemas/DecimalPlaces"
legendOpacity:
type: number
format: float
legendOrientationThreshold:
type: integer
HistogramViewProperties: HistogramViewProperties:
type: object type: object
required: required:
@ -9468,6 +9569,8 @@ components:
enum: [overlaid, stacked] enum: [overlaid, stacked]
binCount: binCount:
type: integer type: integer
legendColorizeRows:
type: boolean
legendOpacity: legendOpacity:
type: number type: number
format: float format: float
@ -9635,6 +9738,8 @@ components:
type: array type: array
items: items:
$ref: "#/components/schemas/DashboardColor" $ref: "#/components/schemas/DashboardColor"
legendColorizeRows:
type: boolean
legendOpacity: legendOpacity:
type: number type: number
format: float format: float
@ -10159,6 +10264,10 @@ components:
bucketID: bucketID:
type: string type: string
description: The ID of the bucket to write to. description: The ID of the bucket to write to.
allowInsecure:
type: boolean
description: Skip TLS verification on endpoint.
default: false
ScraperTargetResponse: ScraperTargetResponse:
type: object type: object
allOf: allOf:
@ -11704,12 +11813,7 @@ components:
type: string type: string
enum: ["slack", "pagerduty", "http", "telegram"] enum: ["slack", "pagerduty", "http", "telegram"]
DBRP: DBRP:
required: type: object
- orgID
- org
- bucketID
- database
- retention_policy
properties: properties:
id: id:
type: string type: string
@ -11735,6 +11839,17 @@ components:
description: Specify if this mapping represents the default retention policy for the database specificed. description: Specify if this mapping represents the default retention policy for the database specificed.
links: links:
$ref: "#/components/schemas/Links" $ref: "#/components/schemas/Links"
oneOf:
- required:
- orgID
- bucketID
- database
- retention_policy
- required:
- org
- bucketID
- database
- retention_policy
DBRPs: DBRPs:
properties: properties:
notificationEndpoints: notificationEndpoints:

View File

@ -1,17 +1,17 @@
openapi: "3.0.0" openapi: "3.0.0"
info: info:
title: InfluxDB API Service (v1 compatible endpoints) title: Influx API Service (V1 compatible endpoints)
version: 0.1.0 version: 0.1.0
servers: servers:
- url: / - url: /
description: InfluxDB v1 compatible API endpoints. description: V1 compatible api endpoints.
paths: paths:
/write: /write:
post: # technically this functions with other methods as well post: # technically this functions with other methods as well
operationId: PostWriteV1 operationId: PostWriteV1
tags: tags:
- Write - Write
summary: Write time series data into InfluxDB in a v1 compatible format summary: Write time series data into InfluxDB in a V1 compatible format
requestBody: requestBody:
description: Line protocol body description: Line protocol body
required: true required: true
@ -103,7 +103,7 @@ paths:
operationId: PostQueryV1 operationId: PostQueryV1
tags: tags:
- Query - Query
summary: Query InfluxDB in a v1 compatible format summary: Query InfluxDB in a V1 compatible format
requestBody: requestBody:
description: InfluxQL query to execute. description: InfluxQL query to execute.
content: content:

View File

@ -1873,6 +1873,7 @@ paths:
$ref: "#/components/schemas/Error" $ref: "#/components/schemas/Error"
/delete: /delete:
post: post:
operationId: PostDelete
summary: Delete time series data from InfluxDB summary: Delete time series data from InfluxDB
requestBody: requestBody:
description: Predicate delete request description: Predicate delete request
@ -1990,7 +1991,7 @@ paths:
operationId: PostSources operationId: PostSources
tags: tags:
- Sources - Sources
summary: Creates a source summary: Create a source
parameters: parameters:
- $ref: "#/components/parameters/TraceSpan" - $ref: "#/components/parameters/TraceSpan"
requestBody: requestBody:
@ -2814,7 +2815,7 @@ paths:
operationId: GetDashboardsIDLabels operationId: GetDashboardsIDLabels
tags: tags:
- Dashboards - Dashboards
summary: list all labels for a dashboard summary: List all labels for a dashboard
parameters: parameters:
- $ref: "#/components/parameters/TraceSpan" - $ref: "#/components/parameters/TraceSpan"
- in: path - in: path
@ -3305,7 +3306,7 @@ paths:
operationId: DeleteAuthorizationsID operationId: DeleteAuthorizationsID
tags: tags:
- Authorizations - Authorizations
summary: Delete a authorization summary: Delete an authorization
parameters: parameters:
- $ref: "#/components/parameters/TraceSpan" - $ref: "#/components/parameters/TraceSpan"
- in: path - in: path
@ -3681,7 +3682,7 @@ paths:
operationId: DeleteBucketsIDLabelsID operationId: DeleteBucketsIDLabelsID
tags: tags:
- Buckets - Buckets
summary: delete a label from a bucket summary: Delete a label from a bucket
parameters: parameters:
- $ref: "#/components/parameters/TraceSpan" - $ref: "#/components/parameters/TraceSpan"
- in: path - in: path
@ -8479,45 +8480,6 @@ components:
TaskStatusType: TaskStatusType:
type: string type: string
enum: [active, inactive] enum: [active, inactive]
Invite:
properties:
id:
description: the idpe id of the invite
readOnly: true
type: string
email:
type: string
role:
type: string
enum:
- member
- owner
expiresAt:
format: date-time
type: string
links:
type: object
readOnly: true
example:
self: "/api/v2/invites/1"
properties:
self:
type: string
format: uri
required: [id, email, role]
Invites:
type: object
properties:
links:
type: object
properties:
self:
type: string
format: uri
invites:
type: array
items:
$ref: "#/components/schemas/Invite"
User: User:
properties: properties:
id: id:
@ -8978,8 +8940,32 @@ components:
$ref: "#/components/schemas/Legend" $ref: "#/components/schemas/Legend"
xColumn: xColumn:
type: string type: string
generateXAxisTicks:
type: array
items:
type: string
xTotalTicks:
type: integer
xTickStart:
type: number
format: float
xTickStep:
type: number
format: float
yColumn: yColumn:
type: string type: string
generateYAxisTicks:
type: array
items:
type: string
yTotalTicks:
type: integer
yTickStart:
type: number
format: float
yTickStep:
type: number
format: float
shadeBelow: shadeBelow:
type: boolean type: boolean
hoverDimension: hoverDimension:
@ -8990,6 +8976,8 @@ components:
enum: [overlaid, stacked] enum: [overlaid, stacked]
geom: geom:
$ref: "#/components/schemas/XYGeom" $ref: "#/components/schemas/XYGeom"
legendColorizeRows:
type: boolean
legendOpacity: legendOpacity:
type: number type: number
format: float format: float
@ -9039,8 +9027,32 @@ components:
$ref: "#/components/schemas/Legend" $ref: "#/components/schemas/Legend"
xColumn: xColumn:
type: string type: string
generateXAxisTicks:
type: array
items:
type: string
xTotalTicks:
type: integer
xTickStart:
type: number
format: float
xTickStep:
type: number
format: float
yColumn: yColumn:
type: string type: string
generateYAxisTicks:
type: array
items:
type: string
yTotalTicks:
type: integer
yTickStart:
type: number
format: float
yTickStep:
type: number
format: float
upperColumn: upperColumn:
type: string type: string
mainColumn: mainColumn:
@ -9052,6 +9064,8 @@ components:
enum: [auto, x, y, xy] enum: [auto, x, y, xy]
geom: geom:
$ref: "#/components/schemas/XYGeom" $ref: "#/components/schemas/XYGeom"
legendColorizeRows:
type: boolean
legendOpacity: legendOpacity:
type: number type: number
format: float format: float
@ -9101,8 +9115,32 @@ components:
$ref: "#/components/schemas/Legend" $ref: "#/components/schemas/Legend"
xColumn: xColumn:
type: string type: string
generateXAxisTicks:
type: array
items:
type: string
xTotalTicks:
type: integer
xTickStart:
type: number
format: float
xTickStep:
type: number
format: float
yColumn: yColumn:
type: string type: string
generateYAxisTicks:
type: array
items:
type: string
yTotalTicks:
type: integer
yTickStart:
type: number
format: float
yTickStep:
type: number
format: float
shadeBelow: shadeBelow:
type: boolean type: boolean
hoverDimension: hoverDimension:
@ -9117,6 +9155,8 @@ components:
type: string type: string
decimalPlaces: decimalPlaces:
$ref: "#/components/schemas/DecimalPlaces" $ref: "#/components/schemas/DecimalPlaces"
legendColorizeRows:
type: boolean
legendOpacity: legendOpacity:
type: number type: number
format: float format: float
@ -9167,6 +9207,18 @@ components:
type: boolean type: boolean
xColumn: xColumn:
type: string type: string
generateXAxisTicks:
type: array
items:
type: string
xTotalTicks:
type: integer
xTickStart:
type: number
format: float
xTickStep:
type: number
format: float
ySeriesColumns: ySeriesColumns:
type: array type: array
items: items:
@ -9197,6 +9249,8 @@ components:
type: string type: string
ySuffix: ySuffix:
type: string type: string
legendColorizeRows:
type: boolean
legendOpacity: legendOpacity:
type: number type: number
format: float format: float
@ -9248,8 +9302,32 @@ components:
type: boolean type: boolean
xColumn: xColumn:
type: string type: string
generateXAxisTicks:
type: array
items:
type: string
xTotalTicks:
type: integer
xTickStart:
type: number
format: float
xTickStep:
type: number
format: float
yColumn: yColumn:
type: string type: string
generateYAxisTicks:
type: array
items:
type: string
yTotalTicks:
type: integer
yTickStart:
type: number
format: float
yTickStep:
type: number
format: float
fillColumns: fillColumns:
type: array type: array
items: items:
@ -9280,6 +9358,8 @@ components:
type: string type: string
ySuffix: ySuffix:
type: string type: string
legendColorizeRows:
type: boolean
legendOpacity: legendOpacity:
type: number type: number
format: float format: float
@ -9330,8 +9410,32 @@ components:
type: boolean type: boolean
xColumn: xColumn:
type: string type: string
generateXAxisTicks:
type: array
items:
type: string
xTotalTicks:
type: integer
xTickStart:
type: number
format: float
xTickStep:
type: number
format: float
yColumn: yColumn:
type: string type: string
generateYAxisTicks:
type: array
items:
type: string
yTotalTicks:
type: integer
yTickStart:
type: number
format: float
yTickStep:
type: number
format: float
xDomain: xDomain:
type: array type: array
items: items:
@ -9356,6 +9460,8 @@ components:
type: string type: string
binSize: binSize:
type: number type: number
legendColorizeRows:
type: boolean
legendOpacity: legendOpacity:
type: number type: number
format: float format: float
@ -9409,11 +9515,6 @@ components:
$ref: "#/components/schemas/Legend" $ref: "#/components/schemas/Legend"
decimalPlaces: decimalPlaces:
$ref: "#/components/schemas/DecimalPlaces" $ref: "#/components/schemas/DecimalPlaces"
legendOpacity:
type: number
format: float
legendOrientationThreshold:
type: integer
HistogramViewProperties: HistogramViewProperties:
type: object type: object
required: required:
@ -9468,6 +9569,8 @@ components:
enum: [overlaid, stacked] enum: [overlaid, stacked]
binCount: binCount:
type: integer type: integer
legendColorizeRows:
type: boolean
legendOpacity: legendOpacity:
type: number type: number
format: float format: float
@ -9635,6 +9738,8 @@ components:
type: array type: array
items: items:
$ref: "#/components/schemas/DashboardColor" $ref: "#/components/schemas/DashboardColor"
legendColorizeRows:
type: boolean
legendOpacity: legendOpacity:
type: number type: number
format: float format: float
@ -10159,6 +10264,10 @@ components:
bucketID: bucketID:
type: string type: string
description: The ID of the bucket to write to. description: The ID of the bucket to write to.
allowInsecure:
type: boolean
description: Skip TLS verification on endpoint.
default: false
ScraperTargetResponse: ScraperTargetResponse:
type: object type: object
allOf: allOf:
@ -11704,12 +11813,7 @@ components:
type: string type: string
enum: ["slack", "pagerduty", "http", "telegram"] enum: ["slack", "pagerduty", "http", "telegram"]
DBRP: DBRP:
required: type: object
- orgID
- org
- bucketID
- database
- retention_policy
properties: properties:
id: id:
type: string type: string
@ -11735,6 +11839,17 @@ components:
description: Specify if this mapping represents the default retention policy for the database specificed. description: Specify if this mapping represents the default retention policy for the database specificed.
links: links:
$ref: "#/components/schemas/Links" $ref: "#/components/schemas/Links"
oneOf:
- required:
- orgID
- bucketID
- database
- retention_policy
- required:
- org
- bucketID
- database
- retention_policy
DBRPs: DBRPs:
properties: properties:
notificationEndpoints: notificationEndpoints:

View File

@ -1,17 +1,17 @@
openapi: "3.0.0" openapi: "3.0.0"
info: info:
title: InfluxDB API Service (v1 compatible endpoints) title: Influx API Service (V1 compatible endpoints)
version: 0.1.0 version: 0.1.0
servers: servers:
- url: / - url: /
description: InfluxDB v1 compatible API endpoints. description: V1 compatible api endpoints.
paths: paths:
/write: /write:
post: # technically this functions with other methods as well post: # technically this functions with other methods as well
operationId: PostWriteV1 operationId: PostWriteV1
tags: tags:
- Write - Write
summary: Write time series data into InfluxDB in a v1 compatible format summary: Write time series data into InfluxDB in a V1 compatible format
requestBody: requestBody:
description: Line protocol body description: Line protocol body
required: true required: true
@ -103,7 +103,7 @@ paths:
operationId: PostQueryV1 operationId: PostQueryV1
tags: tags:
- Query - Query
summary: Query InfluxDB in a v1 compatible format summary: Query InfluxDB in a V1 compatible format
requestBody: requestBody:
description: InfluxQL query to execute. description: InfluxQL query to execute.
content: content: