Commit Graph

197 Commits (fix-mono-get-started)

Author SHA1 Message Date
Jason Stirnaman f1d82f4b00 fix(api-docs): Update API reference directories and generation script for influxdb3 URL paths, update links and names in reference content 2025-01-28 10:53:07 -06:00
Paul Dix b78162d24c Add plugin documentation for Core and Enterprise 2025-01-19 18:07:40 -05:00
Scott Anderson a62f69ffaf
InfluxDB Clustered partial writes (#5594)
* updated status code information for partial writes

* docs: add environment variable tuning explanation (#5579)

* WIP clustered partial writes

* fixed yaml error

* fixed duplicate key in clustered api docs

* Apply suggestions from code review

Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>

* Update content/influxdb/clustered/admin/env-vars.md

* Apply suggestions from code review

* add placeholder release notes for next clustered version

* update clustered release notes, remove option license info

---------

Co-authored-by: Jack <56563911+jdockerty@users.noreply.github.com>
Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>
2024-09-27 09:30:39 -06:00
Jason Stirnaman 92b115b1b4 fix(api): Fix Cloud Dedicated /ping descriptions
- Cloud Dedicated /ping only reports querier, not ingester, health
- Update v1 docs API and client library recommendations.

Closes 5610
2024-09-25 16:31:55 -05:00
Ben Tasker bae9b0e1b0
docs: correct description of status codes (#5587)
* docs: correct description of status codes

* Update api-docs/cloud-dedicated/v2/ref.yml

Co-authored-by: Fraser Savage <fraser@savage.engineer>

* Update api-docs/cloud-dedicated/v2/ref.yml

Co-authored-by: Fraser Savage <fraser@savage.engineer>

* Apply suggestions from code review

Co-authored-by: Fraser Savage <fraser@savage.engineer>

---------

Co-authored-by: Fraser Savage <fraser@savage.engineer>
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
2024-09-03 14:17:07 -06:00
Fraser Savage 9f0c7c6283
refactor(write-api): Punctuation and wording changes from code review
This makes the changes more consistent with wider writing style.

Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>
2024-09-03 15:37:02 +01:00
Fraser Savage 5d74f97926
fix(write-api): Partial writes now return a 400 response code in dedicated
This updates some of the other wording around the troubleshooting table
to reflect the product's current state more closely.
2024-09-02 17:52:40 +01:00
Fraser Savage 8305b7cde4
fix(write-api): Partial writes now return a 400 response code in serverless
This updates some of the other wording around the troubleshooting table
to reflect the product's current state more closely.
2024-09-02 17:47:40 +01:00
Fraser Savage e448b6a223
fix(write-api): Serverless write requests outside retention return 400
Partial writes are the only mode of operation on serverless clusters.
This means that any requests where all points are outside the retention
policy of a bucket receive a 400 bad request.
2024-09-02 16:50:34 +01:00
Fraser Savage 57eb8c6aa4
refactor(write-api): Use proper product terms for Dedicated
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
2024-08-09 16:17:43 +01:00
Fraser Savage 749c59b525
fix(write-api): Update Cloud Dedicated outside-retention failure to HTTP 422 2024-08-09 15:51:18 +01:00
Fraser Savage c83339029c
fix(write-api): Update Cloud Serverless outside-retention failure to HTTP 422 2024-08-09 15:45:38 +01:00
Jacob Marble ef61afc6ec fix(write-api): Serverless write 201 response codes
Helps https://github.com/influxdata/idpe/issues/18710

InfluxDB v3 Serverless will soon return 201 or 204, in cases where it
currently returns 204.
2024-08-07 12:57:04 -07:00
Scott Anderson 5c7d3407ad
Update the placeholder URL for dedicated (#5527)
* update the placeholder URL for dedicated

* added dedicated URL migration
2024-07-22 16:55:00 -06:00
Dustin Eaton a0ea0fcb41 fix: use int64 for retention period in API spec
This updates the Cloud Dedicated Management API spec to use the `int64`
format for the `ClusterDatabaseRetentionPeriod` schema, which matches
the corresponding type in IOx's namespace API.
2024-06-04 16:16:02 -05:00
Jason Stirnaman df3d9cad38 Merge remote-tracking branch 'origin/master' into jstirnaman/issue5463 2024-05-16 12:50:53 -05:00
Jason Stirnaman 8acbb22312 fix: add missing partial and schema descriptions for InfluxQL JSON response
- Closes #5364
- part of https://github.com/influxdata/DAR/issues/424
- depends on https://github.com/influxdata/openapi/pull/651
2024-05-16 12:48:55 -05:00
Jason Stirnaman dbcb5dcac2
Apply suggestions from code review
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
2024-05-10 15:21:30 -05:00
Jason Stirnaman e16405282d chore(v3): increase suggested wait for token activation
- part of https://github.com/influxdata/DAR/issues/425
- Tokens currently can take minutes to sync
- Add Notable behaviors to guides and references
2024-05-10 14:38:35 -05:00
Jason Stirnaman 0de7e563a3 feat(v3): Add influxctl cluster list and get task-based, and use them to find account ID and cluster ID for the HTTP API. Closes #5433 2024-04-19 11:58:17 -05:00
Jason Stirnaman 3d08263f38 fix(api): Update HTTP API landing page in Dedicated
- Adds a custom short title field in OpenAPI info.
- Uses the new field for nav menu item names.
- Adds identifiers to avoid duplicate name warnings.
- Cleans up variation in frontmatter.
2024-04-16 16:29:27 -05:00
Abdullah Sabaa Allil 248c9c0b39
fix broken curl post commands (#5423)
* fix broken curl post commands

* fix broken curl post commands

---------

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
2024-04-15 15:20:24 -06:00
Jason Stirnaman ac4b1c53c8
feat(v3): Restructure API docs for v3 (#5408)
* v3 management API
Fixes #5397

- Adds an API reference doc for the  HTTP management API openapi spec (https://github.com/influxdata/granite/blob/main/openapi.yaml) (Cloud Dedicated only)
- Doesn't fetch changes for any specs except for the Management spec.
- Adds summaries and fixes descriptions in spec overrides.
- Removes versions in spec overrides.
- Adds configuration for generating API reference docs, Hugo frontmatter, setting the default API (for the [product]/api/ URL)
- Restructures `/api-docs` to better allow for multiple APIs (and customizations) per product
- Adds `[product]/api/v2/` docs URL for cloud products (currently set as the "default" API, `[product]/api`)
- Refactors `generate-api-docs` to remove specific conditions and use the new directory structure.
- Redocly update fixes some theme formatting issues

- Tested the following URLs:

   - http://localhost:1313/influxdb/v2/api/
   - http://localhost:1313/influxdb/v2/api/v1-compatibility/
   - http://localhost:1313/influxdb/cloud/api/
   - http://localhost:1313/influxdb/cloud/api/v2/
   - http://localhost:1313/influxdb/cloud-dedicated/api/
   - http://localhost:1313/influxdb/cloud-dedicated/api/v2/
   - http://localhost:1313/influxdb/cloud/api/v1-compatibility/
   - http://localhost:1313/influxdb/cloud-dedicated/api/v1-compatibility/
   - http://localhost:1313/influxdb/cloud-serverless/
   - http://localhost:1313/influxdb/cloud-serverless/api/v2/
   - http://localhost:1313/influxdb/cloud-serverless/api/v1-compatibility/
   - http://localhost:1313/influxdb/clustered/api/
   - http://localhost:1313/influxdb/clustered/api/v2/
   - http://localhost:1313/influxdb/clustered/api/v1-compatibility/

* fix(v3): Remove Management API from menu

* Update api-docs/cloud-dedicated/v2/content/info.yml

* show management api in nav, update nav names

---------

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
Co-authored-by: Scott Anderson <scott@influxdata.com>
2024-04-09 17:02:12 -06:00
Scott Anderson da1b1105ea
Update v3 token management docs and add management tokens (#5373)
* new token management structure, updated links

* task-based management token docs

* added related links to influxctl management docs

* remove draft status from management token admin docs

* standardize references to identity provider

* Apply suggestions from code review

Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>

---------

Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>
2024-03-21 13:42:41 -06:00
Jason Stirnaman 5230b11796
fix(v2): (Closes #5320) Remove attribute from OSS /api/v2/query schema. OSS doesn't support parameterized queries. See upstream PR: https://github.com/influxdata/openapi/pull/646 (#5325) 2024-02-15 17:20:57 -06:00
Jason Stirnaman 7479ceabf2
Revert "Revert "feature(v3): Write: partial writes write good lines and reject bad li… (#5169)" (#5280)" (#5304)
This reverts commit 624eb0205b.
2024-01-17 13:20:25 -06:00
Jason Stirnaman d61107a3d3
feature(v3): Cloud Dedicated write API: partial writes write good lines and reject bad li… (#5273)
* feature(v3): Write: partial writes write good lines and reject bad lines #5160

- Documents the proposed partial writes feature for Serverless and Dedicated.
- Updates Troubleshoot writes and API docs.

* chore(v3): update write status codes (#5160)

* Update content/influxdb/cloud-serverless/write-data/troubleshoot.md

* chore(v3): cleanup partial write descriptions in API ref and troubleshooting guide
2023-12-18 12:43:44 -06:00
Jason Stirnaman 624eb0205b
Revert "feature(v3): Write: partial writes write good lines and reject bad li… (#5169)" (#5280)
This reverts commit 90948e67dc.
2023-12-15 09:27:57 -06:00
Jason Stirnaman af4b0cd970
Revert "chore: add note about partial write failures (#5275)" (#5279)
This reverts commit 4416294c5c.
2023-12-15 09:26:08 -06:00
Jacob Marble 4416294c5c
chore: add note about partial write failures (#5275)
* chore: add note about partial write failures

Helps https://github.com/influxdata/influxdb_iox/issues/5226

* chore: integrate feedback

Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>

---------

Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>
2023-12-14 12:29:50 -06:00
Jason Stirnaman 90948e67dc
feature(v3): Write: partial writes write good lines and reject bad li… (#5169)
* feature(v3): Serverless write API: writes good lines, rejects bad lines #5160

- Documents the proposed partial writes feature for Serverless and Dedicated.
- If some points are written, returns 201 status code.
- Updates Troubleshoot writes and API docs.

* feature(v3): Serverless write API: writes good lines, rejects bad lines #5160

- Documents the proposed partial writes feature for Serverless and Dedicated.
- If some points are written, returns 201 status code.
- Updates Troubleshoot writes and API docs.

* fix: Serverless cleanup

* fix: Serverless write API: restore 204 and explain 201 and 400 status codes.

* Apply suggestions from code review

* fix: Serverless write API: 201 superseded by 204 to maintain v2 compat.

- Documents https://github.com/influxdata/idpe/pull/18398.

* fix: Serverless write API: 201 superseded by 204 to maintain v2 compat.

- Documents https://github.com/influxdata/idpe/pull/18398.

* Update content/influxdb/cloud-serverless/write-data/troubleshoot.md

* Update content/influxdb/cloud-serverless/write-data/troubleshoot.md

* Update content/influxdb/cloud-serverless/write-data/troubleshoot.md
2023-12-13 16:20:51 -06:00
Jason Stirnaman de0f526bdf
Reorganize Serverless DBRP for v1 queries and writes, explain DBRP and auto bucket defaults (#5257)
* chore(v3): DBRP: Update Serverless API ref (#5234)

* chore(ci): Tests: substitute placeholders in JSON body parameters

* chore(v3): DBRP: copy page from influxql to admin/dbrps.

* chore(ci): Trying to prevent "a Influx..."

* chore(ci): Allow autogen

* chore(serverless): DBRP glossary entry

* chore(v2): add default DBRP note

* chore(v3): use product-name shortcode

* chore(v3): use product-name shortcode, clarify retention period and mapping

* chore(serverless): Create Bucket:

- add missing example for Data Explorer
- move Retention Period syntax and define retentionRules syntax
- setup for tests

* chore(serverless): Create Bucket:

- add missing example for Data Explorer
- move Retention Period syntax and define retentionRules syntax
- setup for tests

* chore(serverless): Update bucket: alias to match other products

* chore(v3): Serverless for prototyping: update with DBRP behavior

* Serverless auto-generated buckets have 3-day default retention period
Fixes #5234

- v1-compat guide:
  - passes tests
  - explains DBRPs (default, automatic, and management)
  - migrate DBRP content from query-data/influxql/dbrp
- v2-compat guide:
  - fix TOC
  - add list code example
- rename influxdb-v1-api to api/v1-http, migrate params from v1-compat guide, and explain DBRP in context
- add write-data/api/v1-http and migrate content from v1-compat guide
- move optimize and troubleshooting up to /query-data
- add Related items support for paths containing http
- substitute placeholders in tests

* chore(test): update configuration in README

* fix(serverless): Optimize queries parent

* fix(serverless): create-bucket cleanup

* fix: cleanup

* fix: close tag

* Apply suggestions from code review

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Apply suggestions from code review

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* fix(v3): permission to create dbrp-mapped bucket

---------

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
2023-12-05 16:48:25 -06:00
Andreas Deininger c9488e3465
Fixing typos (#5242)
* Fixing typos

* Update content/enterprise_influxdb/v1/flux/guides/rate.md

---------

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
2023-11-27 09:32:55 -07:00
Scott Anderson 636f5ada45
V2 nav reorg (#5213)
* nest reference docs menu in v2 and cloud

* move migrate data into write data

* nest notebooks under tools

* nest templates under tools

* nest telegraf configs under tools

* cleanup weights and titles of tools sections

* reorg org and bucket management under admin

* add backup/restore to admin, clean up related links

* restructure security sections under admin

* Apply suggestions from code review

Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>

* updated serverless cli docs to address pr feedback

* Update content/influxdb/cloud/admin/organizations/delete-org.md

Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>

* port v2 install changes to new structure

* address pr feedback and ported missing content to serverless

---------

Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>
2023-11-06 15:53:12 -07:00
Jason Stirnaman fa9bba758e
chore(api): add API compatibility overview to API ref (#5192)
* chore(api): add API compatibility overview to API ref

- add API compatibility trait tag
- add getswagger -B option to reuse existing contract and prevent fetching
- add /write description

* Update api-docs/cloud-dedicated/ref.yml

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update api-docs/cloud-dedicated/ref.yml

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update api-docs/clustered/ref.yml

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update api-docs/clustered/ref.yml

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

---------

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
2023-10-25 11:35:38 -05:00
Jason Stirnaman e0bafcd9a1
fix: fix v3 write descriptions, Add v3 Troubleshoot writing data #5135 (#5140)
* fix: fix v3 write descriptions, Add v3 Troubleshoot writing data #5135

* Update content/influxdb/cloud-dedicated/write-data/troubleshoot.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update content/influxdb/cloud-serverless/write-data/troubleshoot.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update content/influxdb/clustered/write-data/troubleshoot.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

---------

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
2023-09-18 13:03:47 -05:00
Scott Anderson 35ad46c4c2
Version restructure (#5133)
* mass changes for version restructure

* fixed latest-patch and flux version generator

* updated hugo configs

* fixed flux frontmatter injector

* fixed flux frontmatter injector

* WIP api generator updates for version restructure (#5128)

* fixed telegraf plugin list

* removed latest shortcode

* fixed current-version

* fixed product dropdown crosslinking

* fixed alt links

* WIP fixing links

* fixed broken links

* updated api doc generation

* fixed additional resources

* added version redirects to edge.js

* fixed search placeholder

* fixed paged titles
2023-09-12 23:33:31 -06:00
Jason Stirnaman 1f64b24893
Fix api related links (#4956)
* wip: fix serverless api related links.

* fix(serverless): remove, replace, alias broken links, and/or mark for pending content

- See the annotated link checker report.
(closes 404s for links in Cloud Serverless API reference #4955)
2023-05-25 16:36:05 -05:00
Jason Stirnaman 6e01923a81
chore(api-ref): update API ref scripts for v3: (#4949)
* chore(api-ref): update API ref scripts for v3:

- Replace cloud-iox with cloud-serverless and cloud-dedicated in getswagger.sh
- Add cloud-dedicated API ref (handcrafted) with query, write, and ping paths.
- Remove separate v1-compat docs for Serverless and Dedicated.
The v1 paths are included in contracts/ref.
- Add Bearer Auth scheme.
- Remove separate v1 docs buttons from api/_index.md

* Update api-docs/cloud-dedicated/ref.yml

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update api-docs/cloud-dedicated/ref.yml

---------

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
2023-05-23 13:52:45 -05:00
Jason Stirnaman 3999b37e40
Fix cleanup api (#4922)
* fix(serverless): remove 'delete' mentions from '/write'.

* fix(serverless): replace bucket-name metadata key with database

* fix(dedicated): update API and client library links

* fix(dedicated): replace iox-namespace-name metadata key with database
2023-05-08 08:46:59 -05:00
Scott Anderson f08a1b19ac hotfix: updated api docs from cloud-iox to cloud-serverless 2023-04-26 08:10:32 -06:00
Scott Anderson 1871c4e62b
InfluxDB 2.7.0 API docs (#4858) 2023-04-11 09:56:00 -06:00
Jason Stirnaman e4e4878a3d
4806 document different ways to execute queries against iox (#4822)
* hotfix(cloud-iox): update buckets docs URLs

* fix(ui): update menu item name

* fix: buckets: update cloud-iox URL, add Update using API
2023-03-22 11:20:39 -05:00
Jason Stirnaman 6aad82f4d1
4806 document different ways to execute queries against iox (#4820)
* fix(cloud-iox): typo.

* fix(cloud-iox): typo

* fix(iox): revise DATE_BIN example and link to reference.

* feat(iox): execute queries and visualize data with SQL in IOx.

* feat(cloud-iox): execute queries with Data Explorer (#4806).

- Publish steps for Execute Queries with Data Explorer.
- Remove pages not ready for IOx.
- Fix links in Get Started.
- Fix tags.

* feat(iox): Add API to IOx Reference, consolidate Cloud and OSS pages (#4788).

* fix(cloud-iox): IOx Data Explorer and Flux links.

* fix(cloud-iox): 1.x API menu.

* fix(cloud-iox): remove visualization types until we've verified links, etc.

* fix(cloud-iox): delete additional 1.x reference docs for now, revise Data Explorer.

* fix(api): replace cloud with cloud-iox in URLs, remove errant externalDocs link.

* feat(cloud-iox): add admin/accounts with data-usage and limits pages.

* fix(cloud): revise and remove outdated info from account management.

* fix(iox): punctuation.

* fix(cloud-iox): update link paths.

* fix(cloud-iox): update link paths for cloud-iox.

* patch(cloud-iox): quick fix for v1compat link paths
2023-03-21 16:34:13 -05:00
Jason Stirnaman 8129c5b4c5
fix for reverted 4788 build the http api reference for iox relevant endpoints (#4803)
* feature(cloud-iox): add cloud-iox API reference content.

* feature(api): revise tagging, add cloud-iox API:

- Closes #4788.
- Generates cloud-iox/api.
- Changes handling of tags and x-tagGroups.
- Configures custom All Endpoints list for cloud-iox.
- Simplifies the nav with other grouping tags.
Any custom x-tagGroups configured in
[platform]/content/tag-groups.yml take precedence over
those already defined in the spec.
If you assign a list of tags to 'All endpoints' x-tagGroup,
the decorator
will use that list and remove Operations not tagged with
those tags.
If you assign an empty array([]) to the 'All endpoints' x-tagGroup,
the decorator will list all resource-like tags.
TODO: document in CONTRIBUTING.
TODO: unset x-tagGroups from openapi.

* Apply suggestions from code review

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* fix(api): unintended deletion of API operations

---------

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
2023-03-15 11:36:17 -05:00
Jason Stirnaman 63b524bf0b
Revert "4788 build the http api reference for iox relevant endpoints (#4801)" (#4802)
This reverts commit da6c2e467d.
2023-03-15 10:36:14 -05:00
Jason Stirnaman da6c2e467d
4788 build the http api reference for iox relevant endpoints (#4801)
* feature(cloud-iox): add cloud-iox API reference content.

* feature(api): revise tagging, add cloud-iox API:

- Closes #4788.
- Generates cloud-iox/api.
- Changes handling of tags and x-tagGroups.
- Configures custom All Endpoints list for cloud-iox.
- Simplifies the nav with other grouping tags.
Any custom x-tagGroups configured in
[platform]/content/tag-groups.yml take precedence over
those already defined in the spec.
If you assign a list of tags to 'All endpoints' x-tagGroup,
the decorator
will use that list and remove Operations not tagged with
those tags.
If you assign an empty array([]) to the 'All endpoints' x-tagGroup,
the decorator will list all resource-like tags.
TODO: document in CONTRIBUTING.
TODO: unset x-tagGroups from openapi.

* Apply suggestions from code review

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

---------

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
2023-03-15 10:20:56 -05:00
Jason Stirnaman f431862a4a
Fix api version (#4697)
* chore: remove unused and deprecated properties:

- Remove unused apis key.
- Remove deprecated styleguide property, replace with root-level plugins and extends.

* chore: pass api-docs path to the custom plugin:

- Pass pwd of the calling script as process.env.API_DOCS_ROOT_PATH to plugins to help resolve custom content files.
- Remove lint execution because the exit code always results in execution of the next elif condition.

* chore: simplify api-docs custom content:

- move content overrides from api-docs/openapi/content to api-docs/[version]/content.
- fix version and version numbers in links.
- update cloud and v2.6 from openapi repo.
- move content.js module to docs-content.js and docs-plugin.js.
- revert decorator functions back to taking content as a data argument.
- remove unused servers.yml definition.

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
2023-01-11 13:03:21 -07:00
Scott Anderson 0775371951
InfluxDB v2.6.0 (#4672)
* created 2.6 docs set

* fixed config.toml file

* fixed taxonomies

* fixed 2.6 file strucure

* added CLI 2.6 release notes (#4668)

* New influxd inspect commands (#4670)

* added new influxd inspect commands

* updated the index page with new commands

* Apply suggestions from code review

* added examples for influxd inspect report-db

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
Co-authored-by: Scott Anderson <scott@influxdata.com>

* OSS 2.6 release notes (#4669)

* WIp release notes

* WIP release notes

* added links

* added detail

* Update content/influxdb/v2.6/reference/release-notes/influxdb.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update content/influxdb/v2.6/reference/release-notes/influxdb.md

Co-authored-by: Jeffrey Smith II <jeffreyssmith2nd@gmail.com>

* minor updates to release notes

* minor updates to previous release notes

* more minor updates to release notes

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
Co-authored-by: Jeffrey Smith II <jeffreyssmith2nd@gmail.com>
Co-authored-by: Scott Anderson <scott@influxdata.com>

* fixed typos

* add 2.6 openapi spec (#4671)

* fix all 2.6 links in 2.5

Co-authored-by: lwandzura <51929958+lwandzura@users.noreply.github.com>
Co-authored-by: Jeffrey Smith II <jeffreyssmith2nd@gmail.com>
2022-12-15 16:43:27 -07:00
Jason Stirnaman fff1693ed3
chore(api): update to latest openapi: (#4624)
- authorizations docs
- update Authorizations tag to Authorizations (API tokens)
- update link in influxdb/content/v2.5 to match
- replace /latest/ with /v2.4/ in latest.
2022-11-08 15:36:18 -06:00
Jason Stirnaman 7030280056
chore(api): add OSS v2.5 API docs, use plugin to set info.license, up… (#4618)
* chore(api): add OSS v2.5 API docs, use plugin to set info.license, update docs with latest changes.

* fix(api): fix OSS version in links.
2022-11-04 17:37:04 -05:00
Jason Stirnaman 149c98b415
hotfix: fix bad link path (#4547)
- Create a bucket with an explicit schema
2022-10-07 16:55:01 -05:00
Jason Stirnaman eae9000521
chore: Update API ref docs from openapi Cloud and OSS (#4546) 2022-10-07 16:20:14 -05:00
Jason Stirnaman eeaab0f240
chore(api): Updates API specs for users and auths. Fixes whitespace, punctuation, grammar, links, and other style issues. (#4469) 2022-09-21 09:22:49 -05:00
Jason Stirnaman 260ed64b3b
fix(api): Check all nodes for a description field (#4458)
- Replace named nodes in decorator with the any key.
- If the node description field is a string, replace URLs.
2022-09-15 11:44:08 -05:00
sunbryely-influxdata 1ba9d6fa1d
Update api-docs/v2.4/ref.yml
Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>
2022-09-09 10:09:43 -07:00
sunbryely-influxdata 6b7aba0029
Update api-docs/cloud/ref.yml
Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>
2022-09-09 10:09:23 -07:00
sunbryely-influxdata df953e01e8
Update api-docs/cloud/ref.yml
Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>
2022-09-09 10:09:07 -07:00
sunbryely-influxdata b15e37b144
Update api-docs/cloud/ref.yml
Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>
2022-09-09 10:09:00 -07:00
Sunbrye Ly ceed42b669 feat: release api docs updates 2022-09-08 12:36:19 -07:00
Jason Stirnaman 31f18dd373
Chore/update api docs (#4411)
* feat: add MIT license to api content

* chore: whitespace

* chore(api): update to openapi Cloud and OSS to master HEAD.

Co-authored-by: Sunbrye Ly <sunbryely@Sunbryes-MacBook-Pro.local>
2022-09-06 08:58:31 -05:00
sunbryely-influxdata 03f9183ba6
feat: add MIT license to api content (#4401)
* feat: add MIT license to api content

* chore: whitespace

Co-authored-by: Sunbrye Ly <sunbryely@Sunbryes-MacBook-Pro.local>
Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>
2022-09-01 17:15:51 -05:00
Jason Stirnaman 272b19b259
hotfix(api): add info content for v2.4 API (#4391)
* hotfix(api): add info content for v2.4 API

* Update api-docs/openapi/content/v2.4/v1compat/info.yml

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>
2022-08-29 15:15:02 -05:00
Scott Anderson 20a409294f
InfluxDB OSS 2.4 (#4361)
* created OSS 2.4

* port nav-item shortcode fixes to 2.4

* update set() example in influxdb faq

* port schema exploration updates to 2.4

* replace indexDB with InfluxDB

* OSS and Enterprise FAQ update (#4310)

* add info about relative time ranges and task retries, closes influxdata/EAR#3415

* add delete faqs, closes influxdata/EAR#3412

* restructure enterprise faq, add entropy faq, closes influxdata/EAR#3364

* add faq about total query time, closes influxdata/EAR#3509

* port MQTT changes into influxdb 2.4

* Influx CLI 2.4 (#4340)

* feat: added CLI scripts documentation (#4223)

* feat: added CLI scripts documentation

* chore: address feedback

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* chore: more feedback

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* moved scripts cli docs into 2.4

* Add users to an org as an owner and other fixes (#4258)

* document adding users to an org as an owner and other fixes, closes #4171

* update content around owners

* InfluxQL shell documentation (#4263)

* added influx v1 shell command docs, closes #4173

* add influxql shell process docs, closes #4172

* add links to influxql shell process docs

* Apply suggestions from code review

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* Apply suggestions from code review

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* feat: documented invokable scripts within tasks functionality in the CLI (#4295)

* feat: documented invokable scripts within tasks functionality in the CLI

* chore: added updated_in frontmatter

* add information about cli configs with username/password (#4328)

Co-authored-by: Andrew Depke <andrewdepke@gmail.com>
Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* influx CLI 2.4 release notes (#4267)

* feat: added CLI scripts documentation (#4223)

* feat: added CLI scripts documentation

* chore: address feedback

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* chore: more feedback

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* moved scripts cli docs into 2.4

* influx CLI 2.4 release notes

* Update content/influxdb/v2.4/reference/release-notes/influx-cli.md

* update release notes with cli username/password support

Co-authored-by: Andrew Depke <andrewdepke@gmail.com>

* 2.4 Virtual DBRPs (#4342)

* WIP auto-add dbrp

* add dbrp management docs

* Update replication docs for InfluxDB 2.4 (#4343)

* update replication docs

* Apply suggestions from code review

Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>

* Apply suggestions from code review

Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>

Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>

* port postman install update to 2.4

* port influx stacks init fix to all influxdb versions

* API docs for 2.4 (#4357)

* api docs for 2.4

* updated to latest swaggerV1Compat.yml

* update edge.js

* Oss 2.4 release notes (#4352)

* added initial notes

* added updates

* updated the release notes

* made a few updates, changed TBD

* Update content/influxdb/v2.4/reference/release-notes/influxdb.md

Co-authored-by: Sam Dillard <sam@influxdata.com>

* Update content/influxdb/v2.4/reference/release-notes/influxdb.md

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* Update content/influxdb/v2.4/reference/release-notes/influxdb.md

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* Update content/influxdb/v2.4/reference/release-notes/influxdb.md

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* Update content/influxdb/v2.4/reference/release-notes/influxdb.md

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* Update content/influxdb/v2.4/reference/release-notes/influxdb.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update content/influxdb/v2.4/reference/release-notes/influxdb.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update content/influxdb/v2.4/reference/release-notes/influxdb.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update content/influxdb/v2.4/reference/release-notes/influxdb.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update content/influxdb/v2.4/reference/release-notes/influxdb.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update content/influxdb/v2.4/reference/release-notes/influxdb.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update content/influxdb/v2.4/reference/release-notes/influxdb.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update content/influxdb/v2.4/reference/release-notes/influxdb.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update content/influxdb/v2.4/reference/release-notes/influxdb.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update content/influxdb/v2.4/reference/release-notes/influxdb.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update content/influxdb/v2.4/reference/release-notes/influxdb.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update content/influxdb/v2.4/reference/release-notes/influxdb.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update content/influxdb/v2.4/reference/release-notes/influxdb.md

Co-authored-by: Sam Dillard <sam@influxdata.com>
Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* added date to influx-cli 2.4.0 release

Co-authored-by: lwandzura <51929958+lwandzura@users.noreply.github.com>
Co-authored-by: Andrew Depke <andrewdepke@gmail.com>
Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>
Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>
Co-authored-by: Sam Dillard <sam@influxdata.com>
2022-08-19 10:27:54 -05:00
Scott Anderson 00d767a683
fix api-docs tagging command (#4358)
Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>
2022-08-19 09:57:53 -05:00
Jason Stirnaman 1051145790
chore: update file path in README 2022-08-15 13:18:08 -05:00
Jason Stirnaman 7d120aae35
Update README with alias for local openapi testing
Add an example alias `gsd` that generates the local contracts, validates them with OATS, bundles and lints them with openapi-cli, and then generates the HTML with redoc-cli.
2022-08-15 13:06:33 -05:00
Jason Stirnaman e64a59b4d0
Chore/lint api defs (#4334)
* chore: update property names in redocly config.

* chore(api): lint the bundle output for openapi spec errors, set Cloud version, rename variable.

- Runs openapi-cli lint after generating the bundle output. This detects errors before pushing to openapi repo only to have the CI OATS validation fail. Only report the first 2 errors so we're not inundated with non-critical warnings.
- Renames INFLUXDB_VERSION to INFLUXDB_PLATFORM for clarity.
- Add a Cloud version to make the spec legal.
2022-08-12 11:48:21 -05:00
Jason Stirnaman 5470549e3d
chore: update property names in redocly config. (#4329) 2022-08-12 10:31:21 -05:00
Jason Stirnaman 22b0fe769b
chore(api): update Cloud and v2.3 API specs with latest openapi updates. (#4265)
Cloud: 0cb1ba2
OSS: 95559e3737b24f40bd0d90ea49f0dfbf84eea371
2022-07-28 16:21:09 -05:00
Jason Stirnaman b5fdb24d41
Feat/api helpers (#4243)
* feat: add ast to glossary

* adding to 2.2

* hotfix(tasks): update duplicate-oss tag to fix broken icon render.

* chore: make API ref shortcode regex non-greedy.

- Make regex used to replace INFLUXDB_DOCS_URL shortcode in the API spec lazy so that it only matches each instance of the shortcode when more than appear in a description.

* fix(glossary): simplify AST and fix agent.

* feat(glossary): add RFC3339Nano entry to use with API docs.

Co-authored-by: Sunbrye Ly <sunbryely@Sunbryes-MacBook-Pro.local>
Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>
2022-07-22 16:53:00 -05:00
Sunbrye Ly 01cec20b96 hotfix:400-error 2022-07-21 12:52:37 -07:00
Jason Stirnaman b15f2fdfdc
Api/update specs (#4226)
* chore(api): update specs

- tasks with scripts for cloud
- improve task endpoint docs

* chore: update cloud and oss api specs for cloud tasks-with-scripts.

- Tasks can be used with invokable scripts.
- Reset docs-release/oss branch to head of master due to changes for
  tasks. Doesn't appear to be anything new in OSS that would break.
2022-07-19 14:58:35 -05:00
Jason Stirnaman 064d9d0a25
chore/api-tags flatten tags (#4191)
* chore(api):

- Replace some x-tagGroups with tags to flatten the navigation and redundant headings.
- Remove unnecessary x-tagGroups from 1.x compat docs.

* chore: remove unused tag-group files.

* chore: update api-docs README

- Document the generate -c flag.
- Cleanup.

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>
2022-07-12 12:21:35 -05:00
Jason Stirnaman 91a8b7c826
Chore/improve api docs generation (#4196)
* chore: getswagger quality-of-life

- Exit on invalid options.
- Show curl output, e.g. if the filepath is incorrect.
- Replace $_ with $outFile for readability.
- Replace context with platform, the common jargon.

* chore(api): generate.sh quality-of-life

- Only regenerate HTML for a spec version if the current file differs from master.
- Refactor to remove code repetition.

* chore: generate.sh generates all versions by default

- Add a -c flag that only generates changed files (for development).
- More refactoring.
2022-07-08 16:30:02 -05:00
Jason Stirnaman e76dfb1ff4
Revert "Chore/improve api docs generation (#4190)" (#4194)
This reverts commit ee7239189c.
Got 404s for API docs pages after deploy.
2022-07-08 10:48:41 -05:00
Jason Stirnaman ee7239189c
Chore/improve api docs generation (#4190)
* chore: getswagger quality-of-life

- Exit on invalid options.
- Show curl output, e.g. if the filepath is incorrect.
- Replace $_ with $outFile for readability.
- Replace context with platform, the common jargon.

* chore(api): generate.sh quality-of-life

- Only regenerate HTML for a spec version if the current file differs from master.
- Refactor to remove code repetition.
2022-07-08 09:55:04 -05:00
Jason Stirnaman 72c31b5d12
Chore/upgrade hugo (#4164)
* fix: Upgrade Hugo and CSS dependencies to fix code samples

Upgrade to latest version of hugo-extended.
Upgrade to latest compatible version of PostCSS.
Fixes syntax highlighting for JavaScript code samples.

* chore: add openapi elements and reimplement Regex to replace shortcode.
2022-06-28 16:17:05 -05:00
Jason Stirnaman 88d3057f21
fix(api): reimplement Regex to replace shortcode. (#4161)
* fix(api): reimplement Regex to replace shortcode.

- Update README with more detailed instructions for updating API docs.
- Use regular expression instead of string to replace URL shortcode, just in case of extra whitespace or line breaks.
- Look for shortcode in additional nodes, especially Parameters.
- Regenerate docs with URL shortcode replacement.

* Update api-docs/README.md

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* Update api-docs/README.md

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* Update api-docs/README.md

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* Update api-docs/README.md

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* Update api-docs/README.md

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* Update api-docs/README.md

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* Update api-docs/README.md

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* Update api-docs/README.md

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* Update api-docs/openapi/plugins/decorators/replace-shortcodes.js

* Update api-docs/README.md

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>
2022-06-27 08:53:32 -05:00
Jason Stirnaman d6b4f8cf04
chore: add OSS v2.3 API docs. (#4152) 2022-06-22 15:36:39 -07:00
Jason Stirnaman 2468a7675e
fix: replace download button with spec link. (#4013)
- Closes #3810 - Remove download button and add a link to the spec source in Github.
2022-05-12 16:48:02 -05:00
Jason Stirnaman 0e51239263
Fix API ref descriptions for `delete` and `write` (#4009)
* fix: update /delete, /write, error refs, and misc. grammar.

* chore: update name to @redocly/cli
2022-05-12 12:29:30 -05:00
Jason Stirnaman afbe39b8a2
Fix/api reference (#3977)
* chore: add decorator to strip trailing slash from path URLs

* chore: openapi processing

- remove custom tags and revert to managing tags in influxdata/openapi.
- remove security scheme content; revert to managing in influxdata/openapi.
- delete unused decorator
- fix strip-version-prefix--replace regex
- revert to bold for h4-h6
- use docs-release/influxdb-oss release branch for OSS docs.
- update README

* Update api-docs/README.md

Co-authored-by: sunbryely-influxdata <101659702+sunbryely-influxdata@users.noreply.github.com>

* chore: add instruction for updating the release branch.

* Update api-docs/README.md

* Update api-docs/README.md

* Update api-docs/README.md

* Update api-docs/README.md

* chore: update cloud API spec

- tag updates
- Invokable rename
- Cleanup.

* Update api-docs/README.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

Co-authored-by: sunbryely-influxdata <101659702+sunbryely-influxdata@users.noreply.github.com>
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
2022-04-26 17:16:36 -05:00
kelseiv d674758ec0
base update to 2.2 (#3744)
* base update to 2.2

* draft release notes

* draft InfluxDB 2.2 release notes

* move release notes to new PR

* update api for 2.2

* fix menu items

* Update data/products.yml

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update data/products.yml

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* frontmatter fixes

* Feat/oss v2 2 metrics (#3762)

* feat: copy v2.1 metrics to v2.2.

* feat: new storage metrics in v2.2

* feat: v2.2 storage metrics.

* fix: revert 2.1 paths.

* Update "Get started with tasks" (#3763)

* update get started with tasks, closes influxdata/DAR#272

* Apply suggestions from code review

Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>

Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>

* update nats config options, update influxd-flags logic, related to #3766 (#3771)

* updated token create API examples, closes influxdata/DAR#267 (#3773)

* ported scalar values update to 2.2

* Chore/move openapicli process (#3801)

* Internal measurements for monitoring Enterprise (#3698)

* Add 1.21.4 (#3789)

* Add 1.21.4

* Update content/telegraf/v1.21/about_the_project/release-notes-changelog.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Add apt and knot plugins

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* InfluxDB Enterprise 1.9.6 (#3650)

* Document meta-node HTTP access logging (#3486)
* Document `influxd-ctl backup -estimate` flag (#3484)
  Closes #3480
* add new option for SIGTERM (#3496)
* Document `-meta-only-overwrite-force` restore flag for Enterprise (#3487)
* Document `max-concurrent-deletes` option (#3697)
* Update Enterprise cluster metrics: add `openConnections` (#3703)
  Closes #3653
* Remove marketplace offerings from Enterprise
* Use bytes in certain Enterprise config examples (#3743)
* InfluxDB Enterprise 1.9: remove default values from configuration headings (#3759)

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
Co-authored-by: Sam Arnold <sarnold@influxdata.com>

* fix: bad link. (#3793)

* Update products.yml

* Feat/3411 link to cloud limits (#3795)

* feat: link from write error responses to related Cloud limits topics.

* feat: link Troubleshooting writes to Cloud limits.

* fix: grammar.

* Update content/influxdb/cloud/write-data/troubleshoot.md

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* First updates for the new brand (#3796)

* first pass with new branding, logos, fonts

* updated table font sizes

* removed unnecessary file

* Update assets/styles/layouts/_sidebar.scss

Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>

* a few last style updates

Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>

* chore: move openapi-cli postprocessing to the getSwagger step.

* chore: convert the content generators to functions so they're not executed on import (which broke the linter). Move the generators into the decorators and remove options args to simplify. Update and simplify the README. Update the oss v2.1 contract.

* README

Co-authored-by: pierwill <19642016+pierwill@users.noreply.github.com>
Co-authored-by: noramullen1 <42354779+noramullen1@users.noreply.github.com>
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>
Co-authored-by: Sam Arnold <sarnold@influxdata.com>

* port menu url fix from master to 2.2

* Feat/oss 2 2 config (#3774)

* wip: add new server-config CLI command and /api/v2/config path. Fix Operator token doc. (#3523)

* feat: document OSS-only  and . Deprecate assets-path: ""
(closes #3523)

* chore: add toc

* Replace run-time with runtime. (#3774)

* Update content/influxdb/v2.2/reference/cli/influx/server-config/_index.md

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* formatted all flux examples in influxdb 2.2

* Fix/set tag groups (#3823)

* fix: replacement of Info: in contracts.
fix: add missing const declarations.
fix: add a decorator to remove redundant servers with empty URLs
  -- all servers should be root now since paths are explicit.

* fix: invalid mix of tags as strings and objects in root.tags. Convert all tags to objects with a default description.

* fix: use tag objects instead of mixing strings and objects in x-tagGroups -- fixes validation errors.

* port data retention and deletion updates to 2.2

* ported updated current version shortcode to 2.2

* Feat/3414 v2.2 debug pprof (#3844)

* feat: update API reference for OSS v2.2. Adds /debug/pprof.

* feat: add v2.2 runtime reference.

* fix: update URLs.

* port hardening-enabled config info, closes #3867, closes #3866 (#3873)

* Fix/3855 oss2.2 (#3857)

* fix: update npm example in v2.2. (#3855)

* fix: cardinality for ossv2.2 (#3850)

* updating placeholders in 2.2

* Document `influx remote` and `influx replication` (#3469)

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* ported migration docs into 2.2

* updated edge.js

* porting various minor changes into 2.2

* InfluxDB 2.2 release notes (#3745)

* draft 2.2 release notes
* remove flux lines; regroup other items
* update link to Flux RNs
* update release notes
* Update content/influxdb/v2.2/reference/release-notes/influxdb.md
* fix frontmatter
* fix link; update version
* edit
* revert for review clarity
* Update influxdb.md
* note about technical preview & feature overview
* edit from Jason
* Update content/influxdb/v2.2/reference/release-notes/influxdb.md
* Update content/influxdb/v2.2/reference/release-notes/influxdb.md
Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>
* Updates per Tim H and Sam feedback
* Update content/influxdb/v2.2/reference/release-notes/influxdb.md
Co-authored-by: pierwill <19642016+pierwill@users.noreply.github.com>
* Update content/influxdb/v2.2/reference/release-notes/influxdb.md
Co-authored-by: pierwill <19642016+pierwill@users.noreply.github.com>
* Update content/influxdb/v2.2/reference/release-notes/influxdb.md
Co-authored-by: pierwill <19642016+pierwill@users.noreply.github.com>
* changes made from feedback
* changed technical preview notes
* Update content/influxdb/v2.2/reference/release-notes/influxdb.md
Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>
* Update content/influxdb/v2.2/reference/release-notes/influxdb.md
Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>
* add link to OSS metrics page
* Update content/influxdb/v2.2/reference/release-notes/influxdb.md
Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>
* Add security section to influxdb/v2.2/reference/release-notes/influxdb.md (#3898)
* edits from Sam
* edit from sam
* Update content/influxdb/v2.2/reference/release-notes/influxdb.md
Co-authored-by: pierwill <19642016+pierwill@users.noreply.github.com>
* Update content/influxdb/v2.2/reference/release-notes/influxdb.md
Co-authored-by: pierwill <19642016+pierwill@users.noreply.github.com>
* Update content/influxdb/v2.2/reference/release-notes/influxdb.m
Co-authored-by: pierwill <19642016+pierwill@users.noreply.github.com>
* Update content/influxdb/v2.2/reference/release-notes/influxdb.md
Co-authored-by: pierwill <19642016+pierwill@users.noreply.github.com>
* edits
* Update content/influxdb/v2.2/reference/release-notes/influxdb.md
Co-authored-by: Sam Dillard <sam@influxdata.com>
* edit from Sam
* edit from Sam
* edits from Tim
Co-authored-by: lwandzura <51929958+lwandzura@users.noreply.github.com>
Co-authored-by: pierwill <19642016+pierwill@users.noreply.github.com>
Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>
Co-authored-by: Jamie Strandboge <jamie@strandboge.com>
Co-authored-by: Sam Dillard <sam@influxdata.com>

* Recover credentials (#3915)

* draft recover creds
* add relate
* add new option to index
* Update content/influxdb/v2.2/users/recover-credentials.md
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
* Update content/influxdb/v2.2/users/recover-credentials.md
* edit from SamA; add note
* sync headers
* add overview bullets; update links
* context from SamA
* Update content/influxdb/v2.2/users/recover-credentials.md
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
* Update content/influxdb/v2.2/users/recover-credentials.md
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
* Update content/influxdb/v2.2/users/recover-credentials.md
Co-authored-by: Sam Dillard <sam@influxdata.com>
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
Co-authored-by: Sam Dillard <sam@influxdata.com>

* update couple stray versions

* add technical preview to the glossary

* update release date

* fix link

* Add documentation for replications max-age (#3936)

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
Co-authored-by: pierwill <19642016+pierwill@users.noreply.github.com>
Co-authored-by: Scott Anderson <scott@influxdata.com>
Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>
Co-authored-by: noramullen1 <42354779+noramullen1@users.noreply.github.com>
Co-authored-by: Sam Arnold <sarnold@influxdata.com>
Co-authored-by: Sunbrye Ly <sunbryely@Sunbryes-MacBook-Pro.local>
Co-authored-by: sunbryely-influxdata <101659702+sunbryely-influxdata@users.noreply.github.com>
Co-authored-by: Dane Strandboge <dane@strandboge.com>
2022-04-06 15:07:21 -07:00
Jason Stirnaman 5fb76b21eb
Feat/api metrics (#3531)
* fix: update UI create task instructions. (#3374)

* fix: use oss update-task for cloud. Fix update-task instructions. Fix syntax.

* feat(api): document /metric path. (#3527, #2567)

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>
2022-01-12 13:11:25 -06:00
Jason Stirnaman b100bbf256
Fix/api securityschemes (#3488)
* fix: oss and cloud auth. Add bearer scheme for OSS.

* chore: Add an openapi CLI decorator that replaces INFLUXDB_DOCS_URL 'shortcodes' with the correct URL in specs.

* fix: API authentication descriptions and schemes in /api/v2 and V1Compat. Remove QueryString and Basic auth schemes from /api/v2 and add them to V1Compat, along with Token auth. Hook up the replace-docs-url-shortcode which is primarily for V1Compat for now due to the way that contract is managed. Add tag groups to V1Compat.

* fix: add v1compat Info description. Comment out Bearer auth in OSS until it's available in Cloud.

* fix: add replace-shortcodes decorator. Fix v1-compat tag-groups. Fix spec titles.

* fix: restore BasicAuth scheme definition for the users operations that reference them. Still need examples for these.

* fix: remove 1.x BasicAuth references where they don't belong.

* chore: sync from openapi master.

* fix: use replace-shortcodes to replace full Docs URLs in the contracts with absolute local paths to avoid roundtrips. Improve v1compat titles.

* Update api-docs/cloud/swaggerV1Compat.yml

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update api-docs/cloud/swaggerV1Compat.yml

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update api-docs/cloud/swaggerV1Compat.yml

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update api-docs/cloud/swaggerV1Compat.yml

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update api-docs/cloud/swaggerV1Compat.yml

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
2021-12-21 14:34:49 -06:00
Jason Stirnaman 22ec8b91e4
chore: update API docs to latest contract. Recombines /write for cloud and OSS. (#3451) 2021-12-01 13:25:23 -06:00
Jason Stirnaman 6210d25dfe
fix: API ref - content encoding header descriptions. (#3378) 2021-11-19 12:44:29 -06:00
kelseiv 5ffaff1c67
invokable (#3405)
* invokable

* update filename and add alias

* fix: rename samples to api-invokable-scripts

Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>
2021-11-16 12:05:07 -08:00
Scott Anderson 04b47d149b
InfluxDB 2.1 (#3367)
* base changes for influxdb 2.1

* remove duplicates in draft

* draft categories

* add categories

* Document wildcards in SHOW MEASUREMENTS ON queries (#3273)

* InfluxQL: document wildcards in SHOW MEASUREMENTS ON queries

This applies to InfluxDB 2.1.

See #3201

* latest notes

* Update `influxd --store` values (#3272)

* Use Unix ~ alias
* Add sqlite path to file layout doc
* add sqlite to filesystem diagrams

* draft 2.1 release notes +questions

* revert to check RNs changes in separately

* latest release notes

* Restructure installation docs for separate CLI package (#3280)

* influxdb and cli install revamp

* reorganized CLI install instructions

* remove unnecessary short-code parameters

* updated docs to address PR feedback

* Apply suggestions from code review

Co-authored-by: pierwill <19642016+pierwill@users.noreply.github.com>
Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* Apply suggestions from code review

* update linux install instructions

Co-authored-by: pierwill <19642016+pierwill@users.noreply.github.com>
Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* release note updates

* updates

* add support for annotations in OSS 2.1 (#3286)

* Document support for bearer auth sytax (#3297)

* 2.1 oss notebooks (#3281)

* Move notebooks to OSS (addresses #2951 )

* Update content/influxdb/v2.1/notebooks/clean-data.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update content/influxdb/v2.1/notebooks/create-notebook.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update content/influxdb/v2.1/notebooks/manage-notebooks.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update content/influxdb/v2.1/notebooks/overview.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update content/influxdb/v2.1/notebooks/_index.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update content/influxdb/v2.1/notebooks/troubleshoot-notebooks.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update content/influxdb/v2.1/notebooks/clean-data.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update content/influxdb/v2.1/notebooks/clean-data.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update content/influxdb/v2.1/notebooks/clean-data.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update content/influxdb/v2.1/notebooks/create-notebook.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update content/influxdb/v2.1/notebooks/create-notebook.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update content/influxdb/v2.1/notebooks/create-notebook.md

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* Update content/influxdb/v2.1/notebooks/create-notebook.md

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* Update content/influxdb/v2.1/notebooks/create-notebook.md

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* Update content/influxdb/v2.1/notebooks/create-notebook.md

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* Update content/influxdb/v2.1/notebooks/create-notebook.md

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* Update content/influxdb/v2.1/notebooks/create-notebook.md

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* Update content/influxdb/v2.1/notebooks/create-notebook.md

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* Update content/influxdb/v2.1/notebooks/create-notebook.md

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* Update content/influxdb/v2.1/notebooks/create-notebook.md

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* Update content/influxdb/v2.1/notebooks/create-notebook.md

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* Update content/influxdb/v2.1/notebooks/create-notebook.md

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* Update content/influxdb/v2.1/notebooks/create-notebook.md

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* Update content/influxdb/v2.1/notebooks/create-notebook.md

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* Update content/influxdb/v2.1/notebooks/overview.md

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* Update content/influxdb/v2.1/notebooks/overview.md

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* Update content/influxdb/v2.1/notebooks/overview.md

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* Update content/influxdb/v2.1/notebooks/overview.md

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* Update content/influxdb/v2.1/notebooks/overview.md

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* Update content/influxdb/v2.1/notebooks/overview.md

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* Update content/influxdb/v2.1/notebooks/overview.md

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* Update content/influxdb/v2.1/notebooks/create-notebook.md

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* Update content/influxdb/v2.1/notebooks/create-notebook.md

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* Update content/influxdb/v2.1/notebooks/create-notebook.md

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* Update content/influxdb/v2.1/notebooks/create-notebook.md

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* Update content/influxdb/v2.1/notebooks/create-notebook.md

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* Update content/influxdb/v2.1/notebooks/create-notebook.md

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* Update content/influxdb/v2.1/notebooks/create-notebook.md

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* Update content/influxdb/v2.1/notebooks/create-notebook.md

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* Update content/influxdb/v2.1/notebooks/create-notebook.md

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* Add PR feedback

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* Fix link in bearer auth sytax doc (#3298)

* Updated CLI docs content and added version metadata (#3285)

* added metadata styles and data to cli docs

* added missing ui-disabled influxd config flag

* added updated versions to influx cli metadata

* added metadata to all cloud influx cli docs

* updated influx ping in cloud to have oss only tag

* Update influxd documentation for 2.1 (#3302)

* update and dynamically generate links to influxd flags (#3288)

* remove 2.1 config options from 2.0

* New influxd commands (#3291)

* added basic influxd recovery commands

* added influxd recover commands, WIP for other influxd inspect commands

* updated all influxd inspect commands

* Apply suggestions from code review

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* updated influxd docs to address PR feedback

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* Add static legend to band and graph visualizations (#3315)

* update band vis to include static legend

* upd graph and graph-single-stat w static legend

* update 2.1 links

* update to latest Flux links

* fix Flux links

* Influxdb 2.1 release notes (#3279)

* draft release notes

* latest RN changes

* test

* revert

* for review purposes

* incorporate changes from new changelog

* add note about new metadata included in CLI docs

* edit

* more edits

* add overview features list

* tweak verbiage about Telegraf support

* Update content/influxdb/v2.1/reference/release-notes/influxdb.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update content/influxdb/v2.1/reference/release-notes/influxdb.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update content/influxdb/v2.1/reference/release-notes/influxdb.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update content/influxdb/v2.1/reference/release-notes/influxdb.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update content/influxdb/v2.1/reference/release-notes/influxdb.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update content/influxdb/v2.1/reference/release-notes/influxdb.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update content/influxdb/v2.1/reference/release-notes/influxdb.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update content/influxdb/v2.1/reference/release-notes/influxdb.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update content/influxdb/v2.1/reference/release-notes/influxdb.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update content/influxdb/v2.1/reference/release-notes/influxdb.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update content/influxdb/v2.1/reference/release-notes/influxdb.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* add link

* add edits from Scott, Dan, and Will

* edits from dan

* highlight and distinguish CLI separation changes

* add links to new API endpoints

* formatting upd

* edits for secrets

* mv Flux location support after rsv merge conflicts

* edits from Tim

* update influxql link

* rmv SLQ metastore link

* minor updates to 2.1 release notes

* prep

* Update content/influxdb/v2.1/reference/release-notes/influxdb.md

Co-authored-by: Greg <2653109+glinton@users.noreply.github.com>

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
Co-authored-by: Scott Anderson <scott@influxdata.com>
Co-authored-by: Greg <2653109+glinton@users.noreply.github.com>

* add new Telegraf plugins to release notes

* edit from Will

* 2.1 upgrade and downgrade instructions (#3332)

* influxd downgrade command, add upgrade instructions, closes #3331

* Apply suggestions from code review

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* Apply suggestions from code review

Co-authored-by: Daniel Moran <danxmoran@gmail.com>

* udpated downgrade docs to address PR feedback

* remove references to localhost:1313

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>
Co-authored-by: Daniel Moran <danxmoran@gmail.com>

* updated flux version in release notes, added other new items, closes #3338 (#3344)

* Chore/update oss api (#3341)

* Standardize the term "key-value" (#3283)

* s|key/value|key-value
* Use en dash in prefix to open compound "time series"

* CLI 2.2 (#3269)

* add -b shorthand to influx delete

* add cli 2.2 release notes

* add example for all-access token

* edits

* updates to influx auth create

* edits for operator token

* remove inaccurate env var

* Update influx-cli.md

* Update influx-cli.md

* make capitalization consistent with other docs

* make headers parallel

* Update content/influxdb/cloud/reference/release-notes/influx-cli.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update content/influxdb/cloud/reference/release-notes/influx-cli.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update content/influxdb/cloud/reference/release-notes/influx-cli.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* edits from Scott and Dan

* Update content/influxdb/v2.0/reference/cli/influx/auth/create.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update content/influxdb/v2.0/reference/cli/influx/auth/create.md

Co-authored-by: Daniel Moran <danxmoran@gmail.com>

* Update content/influxdb/v2.0/reference/cli/influx/auth/create.md

Co-authored-by: Daniel Moran <danxmoran@gmail.com>

* edits to CLI

* add oss-only shortcode and fix formatting

* format updates

* fix links

* add oss-only inline

* fix list

* Update content/influxdb/v2.0/security/tokens/create-token.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update content/influxdb/v2.0/security/tokens/create-token.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update content/influxdb/v2.0/security/tokens/create-token.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* edits from Dan

* emphasize recommendation

* edit from Dan re limits and page size

* edit f Sam

* update release date

* remove vague description

* Update content/influxdb/cloud/reference/release-notes/influx-cli.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update content/influxdb/v2.0/reference/cli/influx/auth/create.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update content/influxdb/v2.0/reference/cli/influx/auth/create.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update content/influxdb/cloud/reference/release-notes/influx-cli.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update content/influxdb/cloud/reference/release-notes/influx-cli.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* edits from Scott

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
Co-authored-by: Daniel Moran <danxmoran@gmail.com>

* add cloud updates in Sept (#3210)

* Fix numbering in AWS install doc (#3293)

Closes #3292

* Document new API Invocable Scripts feature (was named-functions) (#3282)

* feat: add api-guides/guides and guides/api-invocable-scripts for the API-invocable scripts (managed functions) feature (##2547, #2233).

* feat: document API-invocable scripts. Add example for creating and invoking a script with POST. Unable to make GET work with query parameters.

* feat: moved API-invocable scripts under api-guide. Remove guides directory. Add docs for list and find. Add example for list. Add shortcuts and glossary links. Verified with team-compute that GET /invoke and python are not supported yet.

* feat: rename example function for simplicity since there's no GET for now.

* feat: add find_and_update example (#2547).

* feat: add update example. Clarify, expand invoke example. Add links. (#2547)

* Update content/influxdb/cloud/api-guide/api-invocable-scripts/_index.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* fix: remove accidental commit of generated redoc-static.html

* feat: manual update to cloud swagger. Merges meta, auth, tags, and x-tagGroups from src/cloud.yml to aggregate contracts/ref/cloud.yml.

* fix: replace /functions with /scripts

* feat: get swaggers from contracts/ref. Still requires copy-paste of info, tags, and auth from contracts/cloud.yml and contracts/oss.yml

* feat: invocable scripts (#2547)

* Update content/influxdb/cloud/api-guide/api-invocable-scripts/_index.md

Co-authored-by: pierwill <19642016+pierwill@users.noreply.github.com>

* feat: new section for params (#2547).

* fix: swagger server url (#2547)

* Update content/influxdb/cloud/api-guide/api-invocable-scripts/_index.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* feat: remove jq and function where there's no clear need.

Co-authored-by: pierwill <19642016+pierwill@users.noreply.github.com>

* fix: add Invocable Scripts tag description. (#3296)

* Fix api invocable (#3299)

* fix: scripts api path.

* fix: bad comma

* Fix api invocable (#3306)

* fix: scripts api path.

* fix: bad comma

* feat: add invocable scripts example for sending multiple parameter values.

* fix: endpoint text. (#3308)

* Fix api invocable (#3310)

* fix: measurement -> point

* fix: cloud API ref. Remove private paths. Patch description and orgID params into ScriptCreateRequest.

* updated token naming and other typos, closes influxdata/DAR#244 (#3309)

* Flux 0.136 (#3311)

* Flux 0.136.0 release notes

* Update pagerduty package for flux 0.136.0 (#3303)

* Add Flux ServiceNow package (#3304)

* added Flux servicenow package

* Apply suggestions from code review

* Enterprise dar updates (#3313)

* removed references to web server in enteprise cluster docs, closes influxdata/DAR#245

* updated enterprise upgrade instructions, closes influxdata/DAR#243

* Apply suggestions from code review

Co-authored-by: pierwill <19642016+pierwill@users.noreply.github.com>

Co-authored-by: pierwill <19642016+pierwill@users.noreply.github.com>

* fix: mjs example path (#3305) (#3316)

* 3240 fix nodejs alias (#3317)

* fix: mjs example path (#3305)

* fix: add alias to node.js client library (#3240)

* Edit description for amd_rocm_smi Telegraf plugin (#3186)

* Edit description for amd_rocm_smi Telegraf plugin

Edit name and description for amd_rocm_smi Telegraf plugin. 

Not sure if this is the only location that it needs to be udpated.

* cpl minor updates

Co-authored-by: Kelly <kelly@influxdata.com>

* remove influxql support from v2 api, closes influxdata/DAR#246 (#3326)

* Telegraf 1.20.3 (#3328)

* Telegraf 1.20.3

* Update content/telegraf/v1.20/about_the_project/release-notes-changelog.md

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* Update content/telegraf/v1.20/about_the_project/release-notes-changelog.md

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* Update content/telegraf/v1.20/about_the_project/release-notes-changelog.md

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* Address PR feedback

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* docs: update telegraf configuration.md (#3300)

* docs: update telegraf configuration.md

* add note about rate limits

* fix: correct debian/ubuntu install instructions (#3312)

* fix: correct debian/ubuntu install instructions

This consolidates the Debian and Ubutnu install instructions into one
section. The install instructions can be the same for both as they use
the same package manager (i.e. apt).

This removes the use of the now deprecated pipe to apt-key.

This removes references to starting the service, as the service starts
on install and does not require an extra step. Also all supported
operating systems are using systemd at this point so no need to call
that out seperatly.

Removes an extra 'sudo' in deb instructions.

* missing word

* added flux 0.137.0 release notes, added vertica sql support docs (#3318)

* Update _index.md (#3195)

broken link for external plugin repo

* Addresses #3284 (#3334)

* Updates to Flux `to()` (#3260)

Closes https://github.com/influxdata/DAR/issues/236.
Closes #3258.

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Fix shim and other link (#3336)

* Update Kapacitor security docs (#3325)

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* Include TLS setup in Enterprise post-install steps  (#3271)

- Rename TLS guide file.
- Use term "TLS" in title and introduction of TLS guide.

Closes #3270.

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* Flux 0.138.0 and 0.139.0 (#3335)

* added release notes for flux 0.138 and 0.139 and related updates

* updated spec with related implementation issue

* Apply suggestions from code review

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* updated to address PR feedback, added related links to int, uint, and bitwise docs

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* hotfix load data link

* add aliases and fix load data link in oss

* API Ref docs processing (#3337)

* chore: API Reference Docs custom processing. Pulls contracts/ref files and applies custom content (tags, x-tagGroups, securitySchemes, info) before writing results to cloud/ref.yml and v2.0/ref.yml.
Rename source files from swagger.yml to ref.yml to avoid confusion and in case we need to bundle additional specs in the future.
Add an OpenAPI CLI docs-plugin with content and decorators.

* chore: update api-docs/README.md

* fix: add strip-version-prefix to remove /api/v2 added incorrectly to some paths during contract generation - also fixed in openapi repo so future contracts won't need this decorator. Fix server urls. Cleanup.

* chore: update cloud contract.

* chore: update oss API contract.

* Apply suggestions from code review

Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>

* Apply suggestions from code review

Co-authored-by: pierwill <19642016+pierwill@users.noreply.github.com>
Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
Co-authored-by: Daniel Moran <danxmoran@gmail.com>
Co-authored-by: Samantha Wang <32681364+sjwang90@users.noreply.github.com>
Co-authored-by: Kelly <kelly@influxdata.com>
Co-authored-by: noramullen1 <42354779+noramullen1@users.noreply.github.com>
Co-authored-by: Joshua Powers <powersj@influxdata.com>
Co-authored-by: bgilmore-iot <85192039+bgilmore-iot@users.noreply.github.com>

* edit from Tim: update v2.0 to v2.1 in API section

* fix 2.1 links

* Fix/api ref 2.1 (#3363)

* fix: cloud-specific v1compat auth examples.

* fix: openapi. Disabled securityScheme replacement. Cleaned up placeholders. Added links.

* fix: update API auth descriptions. add API ref v2.1. Update links in openapi content.

* fix: updates URLs to v2.1 in API ref docs

* add verify-tsm to 2.1 release notes

* Clockface updates for 2.1 and Cloud (#3364)

* versioned old icomoon font

* updated all existing icons with versioned style

* Revert "updated all existing icons with versioned style"

This reverts commit 79b6cdf539.

* versioned icon shortcode

* update icons and new styles for clockface v3

* updated nav-icon shortcode and styles

* updated account nav icon styles

* misc updates

* general style updates

* updated oss versions on the homepage

* fixed tick card colors on homepage

Co-authored-by: Kelly <kelly@influxdata.com>
Co-authored-by: pierwill <19642016+pierwill@users.noreply.github.com>
Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com>
Co-authored-by: noramullen1 <42354779+noramullen1@users.noreply.github.com>
Co-authored-by: Greg <2653109+glinton@users.noreply.github.com>
Co-authored-by: Daniel Moran <danxmoran@gmail.com>
Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>
Co-authored-by: Samantha Wang <32681364+sjwang90@users.noreply.github.com>
Co-authored-by: Joshua Powers <powersj@influxdata.com>
Co-authored-by: bgilmore-iot <85192039+bgilmore-iot@users.noreply.github.com>
2021-11-08 09:48:11 -08:00
Jason Stirnaman 754d1a1bef
fix: Authorization, not Authentication, header (#3342)
(closes https://github.com/influxdata/DAR/issues/241)
2021-11-03 16:53:56 -05:00
Jason Stirnaman 2bddffb52b
API Ref docs processing (#3337)
* chore: API Reference Docs custom processing. Pulls contracts/ref files and applies custom content (tags, x-tagGroups, securitySchemes, info) before writing results to cloud/ref.yml and v2.0/ref.yml.
Rename source files from swagger.yml to ref.yml to avoid confusion and in case we need to bundle additional specs in the future.
Add an OpenAPI CLI docs-plugin with content and decorators.

* chore: update api-docs/README.md

* fix: add strip-version-prefix to remove /api/v2 added incorrectly to some paths during contract generation - also fixed in openapi repo so future contracts won't need this decorator. Fix server urls. Cleanup.

* chore: update cloud contract.
2021-11-03 14:18:02 -05:00
Scott Anderson 1660b035d7
remove influxql support from v2 api, closes influxdata/DAR#246 (#3326) 2021-10-28 15:07:48 -06:00
Jason Stirnaman ba3f0385ea
Fix api invocable (#3310)
* fix: measurement -> point

* fix: cloud API ref. Remove private paths. Patch description and orgID params into ScriptCreateRequest.
2021-10-26 10:55:24 -05:00
Jason Stirnaman e20b55cb9b
fix: add Invocable Scripts tag description. (#3296) 2021-10-25 11:07:53 -05:00
Jason Stirnaman 6587ee1fdc
Document new API Invocable Scripts feature (was named-functions) (#3282)
* feat: add api-guides/guides and guides/api-invocable-scripts for the API-invocable scripts (managed functions) feature (##2547, #2233).

* feat: document API-invocable scripts. Add example for creating and invoking a script with POST. Unable to make GET work with query parameters.

* feat: moved API-invocable scripts under api-guide. Remove guides directory. Add docs for list and find. Add example for list. Add shortcuts and glossary links. Verified with team-compute that GET /invoke and python are not supported yet.

* feat: rename example function for simplicity since there's no GET for now.

* feat: add find_and_update example (#2547).

* feat: add update example. Clarify, expand invoke example. Add links. (#2547)

* Update content/influxdb/cloud/api-guide/api-invocable-scripts/_index.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* fix: remove accidental commit of generated redoc-static.html

* feat: manual update to cloud swagger. Merges meta, auth, tags, and x-tagGroups from src/cloud.yml to aggregate contracts/ref/cloud.yml.

* fix: replace /functions with /scripts

* feat: get swaggers from contracts/ref. Still requires copy-paste of info, tags, and auth from contracts/cloud.yml and contracts/oss.yml

* feat: invocable scripts (#2547)

* Update content/influxdb/cloud/api-guide/api-invocable-scripts/_index.md

Co-authored-by: pierwill <19642016+pierwill@users.noreply.github.com>

* feat: new section for params (#2547).

* fix: swagger server url (#2547)

* Update content/influxdb/cloud/api-guide/api-invocable-scripts/_index.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* feat: remove jq and function where there's no clear need.

Co-authored-by: pierwill <19642016+pierwill@users.noreply.github.com>
2021-10-25 08:30:31 -05:00
pierwill 327974edd6
Standardize the term "key-value" (#3283)
* s|key/value|key-value
* Use en dash in prefix to open compound "time series"
2021-10-21 11:19:48 -05:00
Jason Stirnaman a53304ef79
feat: update to latest openapi master. Adds and updates Response codes in Overview and /write. Adds Response samples for /write, resuable for other paths. Updates Authentication in Overview. Adds group heading Data I/O endpoints for /write and /query. (#3253) 2021-10-18 15:00:31 -05:00
kelseiv 5f84fb79f8
Add InfluxDB 2.0.9 release notes and new influxd flux-log-enabled option (#3170) 2021-10-11 14:15:39 -07:00
Jason Stirnaman 48505c805c
Fix api docs dependencies (#3229)
* fix: broken install URL. Closes #3122.

* fix: remove redoc-cli from package.json. Set redoc-cli@version specifier in generate-api-docs.sh instead. Remove the requirement to run yarn install just for redoc-cli.

* fix: update README with npx help.

* Update api-docs/README.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Update api-docs/README.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* fix: replace prompt override option for compatibility with npm@6.

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
2021-10-07 14:21:05 -05:00