From c2e7ea8e117824af2a0fbd84b8d5e69184314faa Mon Sep 17 00:00:00 2001 From: hzoppetti Date: Wed, 18 Dec 2019 08:19:10 -0500 Subject: [PATCH 1/7] changed None to null for last successful when no last successful backup date is found --- openapi.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/openapi.yaml b/openapi.yaml index 763cd1420..86e370dbe 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -15129,7 +15129,7 @@ components: last_successful: type: string format: date-time - description: The last successful backup date. 'None' if there was no previous backup. + description: The last successful backup date. 'null' if there was no previous backup. readOnly: true example: '2018-01-01T00:01:01' watchdog_enabled: From 0cf090acd8d980171cf819da9dc359d8acae826c Mon Sep 17 00:00:00 2001 From: hzoppetti Date: Wed, 18 Dec 2019 10:21:32 -0500 Subject: [PATCH 2/7] removed beta note from object storage endpoints --- openapi.yaml | 89 ---------------------------------------------------- 1 file changed, 89 deletions(-) diff --git a/openapi.yaml b/openapi.yaml index 763cd1420..4125bda73 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -9598,12 +9598,6 @@ paths: This endpoint is available for convenience. It is recommended that instead you use the more [fully-featured S3 API](https://docs.ceph.com/docs/mimic/radosgw/s3/serviceops/) directly. - - - **Beta**: This endpoint is in beta. Please make sure to prepend all requests with - `/v4beta` instead of `/v4`, and be aware that this endpoint may receive breaking - updates in the future. This notice will be removed when this endpoint is out of - beta. tags: - Object Storage security: @@ -9649,12 +9643,6 @@ paths: This endpoint is available for convenience. It is recommended that instead you use the more [fully-featured S3 API](https://docs.ceph.com/docs/mimic/radosgw/s3/bucketops/#put-bucket) directly. - - - **Beta**: This endpoint is in beta. Please make sure to prepend all requests with - `/v4beta` instead of `/v4`, and be aware that this endpoint may receive breaking - updates in the future. This notice will be removed when this endpoint is out of - beta. tags: - Object Storage security: @@ -9752,12 +9740,6 @@ paths: This endpoint is available for convenience. It is recommended that instead you use the more [fully-featured S3 API](https://docs.ceph.com/docs/mimic/radosgw/s3/bucketops/#get-bucket) directly. - - - **Beta**: This endpoint is in beta. Please make sure to prepend all requests with - `/v4beta` instead of `/v4`, and be aware that this endpoint may receive breaking - updates in the future. This notice will be removed when this endpoint is out of - beta. tags: - Object Storage security: @@ -9794,12 +9776,6 @@ paths: This endpoint is available for convenience. It is recommended that instead you use the more [fully- featured S3 API](https://docs.ceph.com/docs/mimic/radosgw/s3/bucketops/#delete-bucket) directly. - - - **Beta**: This endpoint is in beta. Please make sure to prepend all requests with - `/v4beta` instead of `/v4`, and be aware that this endpoint may receive breaking - updates in the future. This notice will be removed when this endpoint is out of - beta. tags: - Object Storage security: @@ -9849,12 +9825,6 @@ paths: This endpoint is available for convenience. It is recommended that instead you use the more more [fully-featured S3 API](https://docs.ceph.com/docs/mimic/radosgw/s3/bucketops/#put-bucket-acl) directly. - - - **Beta**: This endpoint is in beta. Please make sure to prepend all requests with - `/v4beta` instead of `/v4`, and be aware that this endpoint may receive breaking - updates in the future. This notice will be removed when this endpoint is out of - beta. tags: - Object Storage security: @@ -9932,12 +9902,6 @@ paths: This endpoint is available for convenience. It is recommended that instead you use the more [fully-featured S3 API](https://docs.ceph.com/docs/luminous/radosgw/s3/bucketops/#get-bucket) directly. - - - **Beta**: This endpoint is in beta. Please make sure to prepend all requests with - `/v4beta` instead of `/v4`, and be aware that this endpoint may receive breaking - updates in the future. This notice will be removed when this endpoint is out of - beta. tags: - Object Storage security: @@ -10024,12 +9988,6 @@ paths: This endpoint is available for convenience. It is recommended that instead you use the more [fully-featured S3 API](https://docs.ceph.com/docs/mimic/radosgw/s3/) directly. - - - **Beta**: This endpoint is in beta. Please make sure to prepend all requests with - `/v4beta` instead of `/v4`, and be aware that this endpoint may receive breaking - updates in the future. This notice will be removed when this endpoint is out of - beta. tags: - Object Storage security: @@ -10111,12 +10069,6 @@ paths: Returns a paginated list of Object Storage Clusters that are available for use. Users can connect to the clusters with third party clients to create buckets and upload objects. - - - **Beta**: This endpoint is in beta. Please make sure to prepend all requests with - `/v4beta` instead of `/v4`, and be aware that this endpoint may receive breaking - updates in the future. This notice will be removed when this endpoint is out of - beta. tags: - Object Storage responses: @@ -10164,12 +10116,6 @@ paths: summary: View Cluster description: | Returns a single Object Storage Cluster. - - - **Beta**: This endpoint is in beta. Please make sure to prepend all requests with - `/v4beta` instead of `/v4`, and be aware that this endpoint may receive breaking - updates in the future. This notice will be removed when this endpoint is out of - beta. tags: - Object Storage responses: @@ -10202,12 +10148,6 @@ paths: description: | Returns a paginated list of Object Storage Keys for authenticating to the Object Storage S3 API. - - - **Beta**: This endpoint is in beta. Please make sure to prepend all requests with - `/v4beta` instead of `/v4`, and be aware that this endpoint may receive breaking - updates in the future. This notice will be removed when this endpoint is out of - beta. security: - personalAccessToken: [] - oauth: @@ -10248,12 +10188,6 @@ paths: summary: Create an Object Storage Key description: | Provisions a new Object Storage Key on your account. - - - **Beta**: This endpoint is in beta. Please make sure to prepend all requests with - `/v4beta` instead of `/v4`, and be aware that this endpoint may receive breaking - updates in the future. This notice will be removed when this endpoint is out of - beta. tags: - Object Storage security: @@ -10316,12 +10250,6 @@ paths: summary: View Object Storage Key description: | Returns a single Object Storage Key provisioned for your account. - - - **Beta**: This endpoint is in beta. Please make sure to prepend all requests with - `/v4beta` instead of `/v4`, and be aware that this endpoint may receive breaking - updates in the future. This notice will be removed when this endpoint is out of - beta. security: - personalAccessToken: [] - oauth: @@ -10354,12 +10282,6 @@ paths: summary: Update an Object Storage Key description: | Updates an Object Storage Key on your account. - - - **Beta**: This endpoint is in beta. Please make sure to prepend all requests with - `/v4beta` instead of `/v4`, and be aware that this endpoint may receive breaking - updates in the future. This notice will be removed when this endpoint is out of - beta. security: - personalAccessToken: [] - oauth: @@ -10403,12 +10325,6 @@ paths: summary: Revoke Object Storage Key description: | Revokes an Object Storage Key. This keypair will no longer be usable by third-party clients. - - - **Beta**: This endpoint is in beta. Please make sure to prepend all requests with - `/v4beta` instead of `/v4`, and be aware that this endpoint may receive breaking - updates in the future. This notice will be removed when this endpoint is out of - beta. security: - personalAccessToken: [] - oauth: @@ -10451,11 +10367,6 @@ paths: guide. - To delete large amounts of objects, consult our guide on [Lifecycle Policies](https://www.linode.com/docs/platform/object-storage/lifecycle-policies/). - - **Beta**: This endpoint is in beta. Please make sure to prepend all requests with - `/v4beta` instead of `/v4`, and be aware that this endpoint may receive breaking - updates in the future. This notice will be removed when this endpoint is out of - beta. security: - personalAccessToken: [] - oauth: From ddd1b8b67cc37dbe80a8028e57f26a0c3e49f16c Mon Sep 17 00:00:00 2001 From: leslitagordita Date: Mon, 23 Dec 2019 09:46:45 -0500 Subject: [PATCH 3/7] Remove APIv3 section --- openapi.yaml | 3 --- 1 file changed, 3 deletions(-) diff --git a/openapi.yaml b/openapi.yaml index 763cd1420..4f37b9536 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -299,9 +299,6 @@ info: Endpoints that do not have CLI examples are currently unavailable through the CLI, but can be accessed via other methods such as Shell commands and other third-party applications. - # APIv3 - - View the [Linode APIv3 Documentation](https://linode.com/apiv3). contact: name: Linode url: / From a948d167087d3977c69f6614fa33565317ee79d5 Mon Sep 17 00:00:00 2001 From: hzoppetti Date: Thu, 9 Jan 2020 10:26:02 -0500 Subject: [PATCH 4/7] updated ints to nums, updated examples, changed type to exclude prepay --- openapi.yaml | 34 +++++++++++++++++----------------- 1 file changed, 17 insertions(+), 17 deletions(-) diff --git a/openapi.yaml b/openapi.yaml index 763cd1420..a8d0d831b 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -14370,44 +14370,44 @@ components: example: Invoice x-linode-cli-display: 3 subtotal: - type: integer + type: number readOnly: true description: The amount of the Invoice before taxes in US Dollars. - example: 120 + example: 120.25 x-linode-cli-display: 4 tax: - type: integer + type: number readOnly: true description: The amount of tax levied on the Invoice in US Dollars. - example: 12 + example: 12.25 x-linode-cli-display: 5 total: - type: integer + type: number readOnly: true description: The amount of the Invoice after taxes in US Dollars. - example: 132 + example: 132.50 x-linode-cli-display: 6 InvoiceItem: type: object description: An InvoiceItem object. properties: amount: - type: integer + type: number readOnly: true description: The price, in US dollars, of the Invoice Item. Equal to the unit price multiplied by quantity. - example: 20 + example: 20.25 x-linode-cli-display: 4 tax: - type: integer + type: number readOnly: true description: The amount of tax levied on this Item in US Dollars. - example: 2 + example: 1.25 x-linode-cli-display: 5 total: - type: integer + type: number readOnly: true description: The price of this Item after taxes in US Dollars. - example: 22 + example: 21.50 x-linode-cli-display: 6 from: type: string @@ -14426,7 +14426,7 @@ components: type: integer readOnly: true description: The quantity of this Item for the specified Invoice. - example: 2 + example: 4 to: type: string readOnly: true @@ -14437,16 +14437,16 @@ components: type: type: string readOnly: true - description: The type of service, ether `prepay` or `misc`. + description: The type of service, ether `hourly` or `misc`. enum: - hourly - - prepay - misc + example: hourly unitprice: - type: integer + type: number readOnly: true description: The monthly service fee in US Dollars for this Item. - example: 10 + example: 5.05 IPAddress: type: object description: > From 97af78d22001ca2e6dfb41965045ab66491c647c Mon Sep 17 00:00:00 2001 From: hzoppetti Date: Thu, 9 Jan 2020 11:28:19 -0500 Subject: [PATCH 5/7] update domain status enum to only include active and disabled --- openapi.yaml | 2 -- 1 file changed, 2 deletions(-) diff --git a/openapi.yaml b/openapi.yaml index 763cd1420..88fd9ff6a 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -13501,8 +13501,6 @@ components: enum: - disabled - active - - edit_mode - - has_errors description: > Used to control whether this Domain is currently being rendered. example: active From 96dadbb9633f33afe8f69b0f70e062423a861d08 Mon Sep 17 00:00:00 2001 From: nmelehan Date: Fri, 10 Jan 2020 16:10:11 -0500 Subject: [PATCH 6/7] Update examples for InvoiceItem amount and total properties Updated examples fit the arithmetic for the properties --- openapi.yaml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/openapi.yaml b/openapi.yaml index a8d0d831b..1fa44262a 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -14395,7 +14395,7 @@ components: type: number readOnly: true description: The price, in US dollars, of the Invoice Item. Equal to the unit price multiplied by quantity. - example: 20.25 + example: 20.20 x-linode-cli-display: 4 tax: type: number @@ -14407,7 +14407,7 @@ components: type: number readOnly: true description: The price of this Item after taxes in US Dollars. - example: 21.50 + example: 21.45 x-linode-cli-display: 6 from: type: string From 773e80de1ba79b1db2adba5720f8527a2863f93c Mon Sep 17 00:00:00 2001 From: hzoppetti Date: Tue, 14 Jan 2020 09:25:19 -0500 Subject: [PATCH 7/7] obj storage out of beta --- openapi.yaml | 60 ++++++++++++++++++++++++++-------------------------- 1 file changed, 30 insertions(+), 30 deletions(-) diff --git a/openapi.yaml b/openapi.yaml index b9e80623d..aa4f87643 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -9587,7 +9587,7 @@ paths: operationId: getObjectStorageBuckets x-linode-cli-skip: true servers: - - url: https://api.linode.com/v4beta + - url: https://api.linode.com/v4 summary: List Object Storage Buckets description: | Returns a paginated list of all Object Storage Buckets that you own. @@ -9625,12 +9625,12 @@ paths: - lang: Shell source: > curl -H "Authorization: Bearer $TOKEN" \ - https://api.linode.com/v4beta/object-storage/buckets/ + https://api.linode.com/v4/object-storage/buckets/ post: operationId: createObjectStorageBucket x-linode-cli-skip: true servers: - - url: https://api.linode.com/v4beta + - url: https://api.linode.com/v4 summary: Create Object Storage Bucket description: | Creates an Object Storage Bucket in the cluster specified. If the @@ -9710,7 +9710,7 @@ paths: "cors_enabled": true, "acl": "private" }' \ - https://api.linode.com/v4beta/object-storage/buckets/ + https://api.linode.com/v4/object-storage/buckets/ /object-storage/buckets/{clusterId}/{bucket}: parameters: - name: clusterId @@ -9729,7 +9729,7 @@ paths: operationId: getObjectStorageBucket x-linode-cli-skip: true servers: - - url: https://api.linode.com/v4beta + - url: https://api.linode.com/v4 summary: View Object Storage Bucket description: | Returns a single Object Storage Bucket. @@ -9756,12 +9756,12 @@ paths: - lang: Shell source: > curl -H "Authorization: Bearer $TOKEN" \ - https://api.linode.com/v4beta/object-storage/buckets/us-east-1/example-bucket + https://api.linode.com/v4/object-storage/buckets/us-east-1/example-bucket delete: operationId: deleteObjectStorageBucket x-linode-cli-skip: true servers: - - url: https://api.linode.com/v4beta + - url: https://api.linode.com/v4 summary: Remove Object Storage Bucket description: > Removes a single bucket. While buckets containing objects _may_ be @@ -9793,7 +9793,7 @@ paths: source: > curl -H "Authorization: Bearer $TOKEN" \ -X DELETE \ - https://api.linode.com/v4beta/object-storage/buckets/us-east-1/example-bucket + https://api.linode.com/v4/object-storage/buckets/us-east-1/example-bucket /object-storage/buckets/{clusterId}/{bucket}/access: parameters: - name: clusterId @@ -9812,7 +9812,7 @@ paths: operationId: modifyObjectStorageBucketAccess x-linode-cli-skip: true servers: - - url: https://api.linode.com/v4beta + - url: https://api.linode.com/v4 summary: Modify Object Storage Bucket Access description: | Allows changing basic Cross-origin Resource Sharing (CORS) and Access Control Level (ACL) settings. @@ -9869,7 +9869,7 @@ paths: "cors_enabled": true, "acl": "private" }' \ - https://api.linode.com/v4beta/object-storage/buckets/us-east-1/example-bucket/access + https://api.linode.com/v4/object-storage/buckets/us-east-1/example-bucket/access /object-storage/buckets/{clusterId}/{bucket}/object-list: parameters: - name: clusterId @@ -9888,7 +9888,7 @@ paths: operationId: getObjectStorageBucketContent x-linode-cli-skip: true servers: - - url: https://api.linode.com/v4beta + - url: https://api.linode.com/v4 summary: List Object Storage Bucket Contents description: | Returns the contents of a bucket. The contents are paginated using a `marker`, @@ -9955,7 +9955,7 @@ paths: - lang: Shell source: > curl -H "Authorization: Bearer $TOKEN" \ - https://api.linode.com/v4beta/object-storage/buckets/us-east-1/example-bucket/object-list + https://api.linode.com/v4/object-storage/buckets/us-east-1/example-bucket/object-list /object-storage/buckets/{clusterId}/{bucket}/object-url: parameters: - name: clusterId @@ -9974,7 +9974,7 @@ paths: operationId: createObjectStorageObjectURL x-linode-cli-skip: true servers: - - url: https://api.linode.com/v4beta + - url: https://api.linode.com/v4 summary: Create Object Storage Object URL description: | Creates a pre-signed URL to access a single Object in a bucket. This @@ -10053,14 +10053,14 @@ paths: "method": "GET", "name": "example" }' \ - https://api.linode.com/v4beta/object-storage/buckets/us-east-1/example-bucket/object-url + https://api.linode.com/v4/object-storage/buckets/us-east-1/example-bucket/object-url /object-storage/clusters: x-linode-cli-command: object-storage get: operationId: getObjectStorageClusters x-linode-cli-action: clusters-list servers: - - url: https://api.linode.com/v4beta + - url: https://api.linode.com/v4 summary: List Clusters description: | Returns a paginated list of Object Storage Clusters that are available for @@ -10092,7 +10092,7 @@ paths: - lang: Shell source: > curl -H "Authorization: Bearer $TOKEN" \ - https://api.linode.com/v4beta/object-storage/clusters + https://api.linode.com/v4/object-storage/clusters - lang: CLI source: > linode-cli object-storage clusters-list @@ -10109,7 +10109,7 @@ paths: operationId: getObjectStorageCluster x-linode-cli-action: clusters-view servers: - - url: https://api.linode.com/v4beta + - url: https://api.linode.com/v4 summary: View Cluster description: | Returns a single Object Storage Cluster. @@ -10128,7 +10128,7 @@ paths: - lang: Shell source: > curl -H "Authorization: Bearer $TOKEN" \ - https://api.linode.com/v4beta/object-storage/clusters/us-east-1 + https://api.linode.com/v4/object-storage/clusters/us-east-1 - lang: CLI source: > linode-cli object-storage clusters-view us-east-1 @@ -10138,7 +10138,7 @@ paths: operationId: getObjectStorageKeys x-linode-cli-action: keys-list servers: - - url: https://api.linode.com/v4beta + - url: https://api.linode.com/v4 tags: - Object Storage summary: List Object Storage Keys @@ -10173,7 +10173,7 @@ paths: - lang: Shell source: > curl -H "Authorization: Bearer $TOKEN" \ - https://api.linode.com/v4beta/object-storage/keys + https://api.linode.com/v4/object-storage/keys - lang: CLI source: > linode-cli object-storage keys-list @@ -10181,7 +10181,7 @@ paths: operationId: createObjectStorageKeys x-linode-cli-action: keys-create servers: - - url: https://api.linode.com/v4beta + - url: https://api.linode.com/v4 summary: Create an Object Storage Key description: | Provisions a new Object Storage Key on your account. @@ -10225,7 +10225,7 @@ paths: -X POST -d '{ "label": "my-object-storage-key" }' \ - https://api.linode.com/v4beta/object-storage/keys + https://api.linode.com/v4/object-storage/keys - lang: CLI source: > linode-cli object-storage keys-create \ @@ -10243,7 +10243,7 @@ paths: operationId: getObjectStorageKey x-linode-cli-action: keys-view servers: - - url: https://api.linode.com/v4beta + - url: https://api.linode.com/v4 summary: View Object Storage Key description: | Returns a single Object Storage Key provisioned for your account. @@ -10266,7 +10266,7 @@ paths: - lang: Shell source: > curl -H "Authorization: Bearer $TOKEN" \ - https://api.linode.com/v4beta/object-storage/keys/12345 + https://api.linode.com/v4/object-storage/keys/12345 - lang: CLI source: > linode-cli object-storage keys-view \ @@ -10275,7 +10275,7 @@ paths: operationId: updateObjectStorageKey x-linode-cli-action: keys-update servers: - - url: https://api.linode.com/v4beta + - url: https://api.linode.com/v4 summary: Update an Object Storage Key description: | Updates an Object Storage Key on your account. @@ -10308,7 +10308,7 @@ paths: -x PUT -d '{ "label": "my-object-storage-key" }' \ - https://api.linode.com/v4beta/object-storage/keys/12345 + https://api.linode.com/v4/object-storage/keys/12345 - lang: CLI source: > linode-cli object-storage keys-update \ @@ -10318,7 +10318,7 @@ paths: operationId: deleteObjectStorageKey x-linode-cli-action: keys-delete servers: - - url: https://api.linode.com/v4beta + - url: https://api.linode.com/v4 summary: Revoke Object Storage Key description: | Revokes an Object Storage Key. This keypair will no longer be usable by third-party clients. @@ -10342,7 +10342,7 @@ paths: source: > curl -H "Authorization: Bearer $TOKEN" \ -x DELETE \ - https://api.linode.com/v4beta/object-storage/keys/12345 + https://api.linode.com/v4/object-storage/keys/12345 - lang: CLI source: > linode-cli object-storage keys-delete \ @@ -10353,7 +10353,7 @@ paths: operationId: cancelObjectStorage x-linode-cli-action: cancel servers: - - url: https://api.linode.com/v4beta + - url: https://api.linode.com/v4 summary: Cancel Object Storage description: | Cancel Object Storage on an Account. All buckets on the Account must be empty @@ -10384,7 +10384,7 @@ paths: source: > curl -H "Authorization: Bearer $TOKEN" \ -X POST \ - https://api.linode.com/v4beta/object-storage/cancel + https://api.linode.com/v4/object-storage/cancel - lang: CLI source: > linode-cli object-storage cancel