vantage-client 0.0.8 → 0.1.0.beta.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4de56e7e8c4c46c81e737a595e267c9738740d0a833510b5ffcea74d6da9f745
-  data.tar.gz: 8e962db8863adb741e65c256cd233837b4c5754292ecd3288d04bb2f08270337
+  metadata.gz: 0ba97924389a3cead3481d19d7f95993018c6df91015ad0b0df04d2c179b5abc
+  data.tar.gz: e376f9f9fc5d811c5d9f4f6ef6fc251e5156646048ec8e7e923b4f72f1713a7b
 SHA512:
-  metadata.gz: 4f9250fc146291fbc5fd06bfcfc736db973606b09b1e894ca29c5d1860262ed45082dc03ef44cd8ae6c1ea45e82f5d38417a4be8fb4cb2faa8a43ca0886f085b
-  data.tar.gz: 6f76f2de489b007d304201f9acdbcd561ff7ee6418548279e480f9dacd7f9e0e8d933362afa2a4706e823ee6b1b8921f20e460b4d231566c6b538e657d18a063
+  metadata.gz: b813831e4dad14c149b0f50e09e792a93b2fcea7b1446ab5e4f05f195f72a8eb7c73f8d543a791b506834abc5dd8ee7164703d918aa573451482b695c52327d0
+  data.tar.gz: da561d16a3a8b7ef6a3ed5f470c9297c365338e4518dc90e6031fda3669920fef977570105fa78e541456f753e4233be96c915867cbfb639560c8b723fa67319

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    vantage-client (0.0.6)
+    vantage-client (0.1.0.beta.2)
       addressable (~> 2.3, >= 2.3.0)
       json (~> 2.1, >= 2.1.0)
       typhoeus (~> 1.0, >= 1.0.1)

data/README.md

@@ -1,113 +1,171 @@
 [![Build Status](https://www.travis-ci.com/vantage-sh/vantage-ruby.svg?branch=main)](https://www.travis-ci.com/vantage-sh/vantage-ruby)
 
-# vantage-client
+# Vantage Ruby Client
 
-Vantage - the Ruby gem for the Vantage
+![Vantage Picture](https://uploads-ssl.webflow.com/5f9ba05ba40d6414f341df34/5f9bb1764b6670c6f7739564_moutain-scene.svg)
 
-Vantage API
 
-This SDK is automatically generated by the [Swagger Codegen](https://github.com/swagger-api/swagger-codegen) project:
+[Vantage](http://vantage.sh/) is a cloud cost transparency platform. This is the official Ruby client for the [Vantage API](http://vantage.readme.io/). You can use the API to get EC2 instance price and product information through a few simple-to-use API calls. The data offered through this API is heavily inspired from data avaiable from [ec2instances.info](http://ec2instances.info/). The feedback we get from users is that this API is significantly easier than learning and using AWS Pricing APIs. We have plans to expand the data available through this API in the future.
 
-- API version: 1.0.0
-- Package version: 0.0.6
-- Build package: io.swagger.codegen.languages.RubyClientCodegen
-For more information, please visit [https://www.vantage.sh](https://www.vantage.sh)
+## Need Help?
 
-## Installation
-
-### Build a gem
-
-To build the Ruby code into a gem:
+Feel free to join us in our [community Slack](https://join.slack.com/t/vantagecommunity/shared_invite/zt-oey52myv-gq4AWRKkX25kjp1UGziPTw) in the #api channel. We're happy to chat and help. You're also welcome to email support@vantage.sh or ping [@JoinVantage](https://twitter.com/joinvantage) on Twitter and we're happy to give assistance. Lastly, we monitor issues on this repo if you have any feature requests or issues. 
 
-```shell
-gem build vantage-client.gemspec
-```
+## Installation
 
-Then either install the gem locally:
+The easiest way to get going is to install the client through RubyGems:
 
 ```shell
-gem install ./vantage-client-0.0.6.gem
+gem install vantage-client
 ```
-(for development, run `gem install --dev ./vantage-client-0.0.6.gem` to install the development dependencies)
-
-or publish the gem to a gem hosting service, e.g. [RubyGems](https://rubygems.org/).
-
-Finally add this to the Gemfile:
 
-    gem 'vantage-client', '~> 0.0.6'
+## Generate a Free API Token
+The Vantage API is provided completely for free but requires an API token to use. To generate a free API token, follow these steps:
 
-### Install from Git
+* Head to [http://vantage.sh/](http://vantage.sh/)
+* Register a free account and confirm your email
+* When you're asked _"What would you like to do first?"_ click _"Access Cloud Pricing API"_
+* Create an API token from the account profile page and you're all set
 
-If the Ruby gem is hosted at a git repository: https://github.com/YOUR_GIT_USERNAME/YOUR_GIT_REPO, then add the following in the Gemfile:
+You'll only need to do this once and you can use your API token for all usage going forward. 
 
-    gem 'vantage-client', :git => 'https://github.com/YOUR_GIT_USERNAME/YOUR_GIT_REPO.git'
+## API Primitives
 
-### Include the Ruby code directly
+The Vantage API is currently organized into four different primitives. Understanding the relationships between these primitives will be helpful as you onboard to the API. Since Vantage only supports EC2 on AWS at the moment, this is provided mainly to show how we are looking at support for future data:
 
-Include the Ruby code directly using `-I` as follows:
+* **Providers**: Providers are the highest level API Primitive. A Provider represents either cloud infrastructure provider or a cloud service provider. Some examples of Providers include AWS, GCP or Azure. Providers offer many Services, which is documented below.
+* **Services**: Services are what Providers offer to their customers. A Service is always tied to a Provider. Some examples of Services are EC2 or S3 from a Provider of AWS. A Service has one or more Products offered, which is documented below.
+* **Products**: Products are what Services ultimately price on. Using the example of a Provider of 'AWS' and a Service of 'EC2', Products would be the individual EC2 Instance Types available such as 'm5d.16xlarge' or 'c5.xlarge'. A Product has one or more Prices, which is documented below.
+* **Prices**: A Product has one or more Prices available to it. For example with EC2 instance types, a single instance type may have potential prices including an on-demand price, a spot price or a reserved instance price.
 
-```shell
-ruby -Ilib script.rb
-```
 
 ## Getting Started
 
-Please follow the [installation](#installation) procedure and then run the following code:
+Once you've installed the client, you'll want to confirm your API token is working correctly. We offer a "ping" endpoint for testing this and overall API healthiness:
+
 ```ruby
 # Load the gem
 require 'vantage-client'
 
-# Setup authorization
+# Configure Vantage with your API token. Replace "YOUR_API_TOKEN" with the token you generate. 
 Vantage.configure do |config|
-  # Configure OAuth2 access token for authorization: oauth2
-  config.access_token = 'YOUR ACCESS TOKEN'
+  config.access_token = 'YOUR_API_TOKEN'
 end
 
-api_instance = Vantage::PingApi.new
+api_instance = Vantage::CostsApi.new
+
+report_id = 'report_id_example' # String | 
+
+opts = { 
+  start_date: 'start_date_example', # String | Query costs by the first date you would like to filter from. ISO 8601 Formatted - 2021-07-15 or 2021-07-15T19:20:48+00:00.
+  end_date: 'end_date_example' # String | Query costs by the last date you would like to filter to. ISO 8601 Formatted - 2021-07-15 or 2021-07-15T19:20:48+00:00.
+}
 
 begin
-  api_instance.ping
+  result = api_instance.get_costs(report_id, opts)
+  p result
 rescue Vantage::ApiError => e
-  puts "Exception when calling PingApi->ping: #{e}"
+  puts "Exception when calling CostsApi->get_costs: #{e}"
+end
+
+# {
+#   :ping => "pong"
+# }
+
+```
+
+## Getting EC2 Instance Information
+
+Getting EC2 instance product information is one of the most used functions of the API. Here's an example of how to get product information for a c5.xlarge EC2 instance:
+
+```ruby
+
+# Load the gem
+require 'vantage-client'
+
+# Configure Vantage with your API token. Replace "YOUR_API_TOKEN" with the token you generate. 
+Vantage.configure do |config|
+  config.access_token = 'YOUR_API_TOKEN'
 end
 
+# The Vantage::PricesApi class helps get simple information 
+vantage_client = Vantage::PricesApi.new
+
+# Find all instances with the instance type name of 'c5.xlarge'
+response = vantage_client.get_products(name: 'c5.xlarge')
+
+# See the entire response
+puts response.products.first
+# { 
+#   :id=>"aws-ec2-c5_xlarge", 
+#   :category=>"compute", 
+#   :name=>"c5.xlarge", 
+#   :service_id=>"aws-ec2", 
+#   :provider_id=>"aws", 
+#   :details=>{
+#     :gpu=>0, 
+#     :name=>"C5 High-CPU Extra Large", 
+#     :vcpu=>4, 
+#     :memory=>8.0, 
+#     :storage=>nil, 
+#     :clock_speed_ghz=>3.0, 
+#     :physical_processor_description=>"Intel Xeon Platinum 8124M", 
+#     :network_performance_description=>"Up to 10 Gigabit"
+#   }
+# }
+
 ```
 
-## Documentation for API Endpoints
+## Getting EC2 Instance Pricing
+
+Getting the price of an EC2 instance is also easy to do. Here's an example of how to get the price for a c5.xlarge. You'll need the product ID from the prior call to retrive prices. Note that Vantage will return all prices across all regions, platforms and lifecycle so client-side you'll want to filter for the appropriate region, platform and lifecycle.
+
+The price returned in the example below will give you the **on-demand** price for a **linux** EC2 instance in **us-east-1**.
+
+```ruby 
 
-All URIs are relative to *https://api.vantage.sh*
+# Load the gem
+require 'vantage-client'
 
-Class | Method | HTTP request | Description
------------- | ------------- | ------------- | -------------
-*Vantage::PingApi* | [**ping**](docs/PingApi.md#ping) | **GET** /v1/ping | 
-*Vantage::PricesApi* | [**get_price**](docs/PricesApi.md#get_price) | **GET** /v1/products/{product_id}/prices/{id} | 
-*Vantage::PricesApi* | [**get_prices**](docs/PricesApi.md#get_prices) | **GET** /v1/products/{product_id}/prices | 
-*Vantage::PricesApi* | [**get_product**](docs/PricesApi.md#get_product) | **GET** /v1/products/{id} | 
-*Vantage::PricesApi* | [**get_products**](docs/PricesApi.md#get_products) | **GET** /v1/products | 
-*Vantage::PricesApi* | [**get_providers**](docs/PricesApi.md#get_providers) | **GET** /v1/providers | 
-*Vantage::PricesApi* | [**get_services**](docs/PricesApi.md#get_services) | **GET** /v1/services | 
+# Configure Vantage with your API token.  Replace "YOUR_API_TOKEN" with the token you generate. 
+Vantage.configure do |config|
+  config.access_token = 'YOUR_API_TOKEN'
+end
 
+# The Vantage::PricesApi class helps get simple information 
+vantage_client = Vantage::PricesApi.new
+
+# Find all prices using the product ID returned in the previous example
+# Note that this will return all prices across all regions and platform types by default.
+response = vantage_client.get_prices('aws-ec2-c5_xlarge')
+
+puts response.prices.first
+# {
+#   :id=>"aws-ec2-c5_xlarge-us_east_1-on_demand-linux", 
+#   :unit=>"hour", 
+#   :region=>"us-east-1", 
+#   :rate_type=>"compute", 
+#   :currency=>"USD", 
+#   :amount=>0.17, 
+#   :details=>{
+#     :platform=>"linux", 
+#     :lifecycle=>"on-demand"
+#   }
+# }
+```
 
 ## Documentation for Models
 
+ - [Vantage::Cost](docs/Cost.md)
+ - [Vantage::Costs](docs/Costs.md)
  - [Vantage::Price](docs/Price.md)
  - [Vantage::Prices](docs/Prices.md)
  - [Vantage::Product](docs/Product.md)
  - [Vantage::Products](docs/Products.md)
  - [Vantage::Provider](docs/Provider.md)
  - [Vantage::Providers](docs/Providers.md)
+ - [Vantage::Report](docs/Report.md)
+ - [Vantage::Reports](docs/Reports.md)
  - [Vantage::Service](docs/Service.md)
  - [Vantage::Services](docs/Services.md)
 
-
-## Documentation for Authorization
-
-
-### oauth2
-
-- **Type**: OAuth
-- **Flow**: application
-- **Authorization URL**: 
-- **Scopes**: 
-  - read: Grants read access
-

data/docs/Cost.md

@@ -0,0 +1,11 @@
+# Vantage::Cost
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**accrued_at** | **String** | The date the cost was accrued. ISO 8601 Formatted - 2021-07-15 or 2021-07-15T19:20:48+00:00. | [optional] 
+**amount** | **String** | The amount of the cost. | [optional] 
+**provider** | **String** | The service provider where the cost was incurred. e.g. AWS | [optional] 
+**service** | **String** | The service which incurred the cost. e.g. Amazon ElastiCache | [optional] 
+
+

data/docs/Costs.md

@@ -0,0 +1,11 @@
+# Vantage::Costs
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**links** | **Object** |  | [optional] 
+**total** | **String** | The sum of all amounts of costs for the entire report for the requested period. | [optional] 
+**currency** | **String** | The currency both the total and cost amount values are represented in. e.g. USD | [optional] 
+**costs** | [**Array<Cost>**](Cost.md) |  | [optional] 
+
+

data/docs/CostsApi.md

@@ -0,0 +1,177 @@
+# Vantage::CostsApi
+
+All URIs are relative to *https://api.vantage.sh*
+
+Method | HTTP request | Description
+------------- | ------------- | -------------
+[**get_costs**](CostsApi.md#get_costs) | **GET** /v1/reports/{report_id}/costs | 
+[**get_report**](CostsApi.md#get_report) | **GET** /v1/reports/{report_id} | 
+[**get_reports**](CostsApi.md#get_reports) | **GET** /v1/reports | 
+
+
+# **get_costs**
+> Costs get_costs(report_id, opts)
+
+
+
+Return available Costs for the specified Cost Report and optional time period. If no time period is specified it will return all available costs for the report.
+
+### Example
+```ruby
+# load the gem
+require 'vantage-client'
+# setup authorization
+Vantage.configure do |config|
+  # Configure OAuth2 access token for authorization: oauth2
+  config.access_token = 'YOUR ACCESS TOKEN'
+end
+
+api_instance = Vantage::CostsApi.new
+
+report_id = 'report_id_example' # String | 
+
+opts = { 
+  start_date: 'start_date_example', # String | Query costs by the first date you would like to filter from. ISO 8601 Formatted - 2021-07-15 or 2021-07-15T19:20:48+00:00.
+  end_date: 'end_date_example', # String | Query costs by the last date you would like to filter to. ISO 8601 Formatted - 2021-07-15 or 2021-07-15T19:20:48+00:00.
+  page: 2, # Integer | The page of results to return.
+  limit: 500 # Integer | The amount of results to return. The maximum is 1000
+}
+
+begin
+  result = api_instance.get_costs(report_id, opts)
+  p result
+rescue Vantage::ApiError => e
+  puts "Exception when calling CostsApi->get_costs: #{e}"
+end
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **report_id** | **String**|  | 
+ **start_date** | **String**| Query costs by the first date you would like to filter from. ISO 8601 Formatted - 2021-07-15 or 2021-07-15T19:20:48+00:00. | [optional] 
+ **end_date** | **String**| Query costs by the last date you would like to filter to. ISO 8601 Formatted - 2021-07-15 or 2021-07-15T19:20:48+00:00. | [optional] 
+ **page** | **Integer**| The page of results to return. | [optional] 
+ **limit** | **Integer**| The amount of results to return. The maximum is 1000 | [optional] 
+
+### Return type
+
+[**Costs**](Costs.md)
+
+### Authorization
+
+[oauth2](../README.md#oauth2)
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/json
+
+
+
+# **get_report**
+> Report get_report(report_id)
+
+
+
+Return a Cost Report.
+
+### Example
+```ruby
+# load the gem
+require 'vantage-client'
+# setup authorization
+Vantage.configure do |config|
+  # Configure OAuth2 access token for authorization: oauth2
+  config.access_token = 'YOUR ACCESS TOKEN'
+end
+
+api_instance = Vantage::CostsApi.new
+
+report_id = 'report_id_example' # String | 
+
+
+begin
+  result = api_instance.get_report(report_id)
+  p result
+rescue Vantage::ApiError => e
+  puts "Exception when calling CostsApi->get_report: #{e}"
+end
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **report_id** | **String**|  | 
+
+### Return type
+
+[**Report**](Report.md)
+
+### Authorization
+
+[oauth2](../README.md#oauth2)
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/json
+
+
+
+# **get_reports**
+> Reports get_reports(opts)
+
+
+
+Return all Cost Reports.
+
+### Example
+```ruby
+# load the gem
+require 'vantage-client'
+# setup authorization
+Vantage.configure do |config|
+  # Configure OAuth2 access token for authorization: oauth2
+  config.access_token = 'YOUR ACCESS TOKEN'
+end
+
+api_instance = Vantage::CostsApi.new
+
+opts = { 
+  page: 2, # Integer | The page of results to return.
+  limit: 500 # Integer | The amount of results to return. The maximum is 1000
+}
+
+begin
+  result = api_instance.get_reports(opts)
+  p result
+rescue Vantage::ApiError => e
+  puts "Exception when calling CostsApi->get_reports: #{e}"
+end
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **page** | **Integer**| The page of results to return. | [optional] 
+ **limit** | **Integer**| The amount of results to return. The maximum is 1000 | [optional] 
+
+### Return type
+
+[**Reports**](Reports.md)
+
+### Authorization
+
+[oauth2](../README.md#oauth2)
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/json
+
+
+

data/docs/PingApi.md

@@ -12,7 +12,7 @@ Method | HTTP request | Description
 
 
 
-This is a health check endpoint that can be used to determine Vantage API healthiness. It will return a 200 success with the raw text of \"pong\" if everything is running smoothly.
+This is a health check endpoint that can be used to determine Vantage API healthiness. It will return 200 if everything is running smoothly.
 
 ### Example
 ```ruby

data/docs/PricesApi.md

@@ -67,7 +67,7 @@ Name | Type | Description  | Notes
 
 
 # **get_prices**
-> Prices get_prices(product_id)
+> Prices get_prices(product_id, opts)
 
 
 
@@ -87,9 +87,13 @@ api_instance = Vantage::PricesApi.new
 
 product_id = 'product_id_example' # String | 
 
+opts = { 
+  page: 2, # Integer | The page of results to return.
+  limit: 500 # Integer | The amount of results to return. The maximum is 1000
+}
 
 begin
-  result = api_instance.get_prices(product_id)
+  result = api_instance.get_prices(product_id, opts)
   p result
 rescue Vantage::ApiError => e
   puts "Exception when calling PricesApi->get_prices: #{e}"
@@ -101,6 +105,8 @@ end
 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
  **product_id** | **String**|  | 
+ **page** | **Integer**| The page of results to return. | [optional] 
+ **limit** | **Integer**| The amount of results to return. The maximum is 1000 | [optional] 
 
 ### Return type
 
@@ -190,7 +196,9 @@ api_instance = Vantage::PricesApi.new
 opts = { 
   provider_id: 'provider_id_example', # String | Query by Provider to list all Products across all Services for a Provider. e.g. aws
   service_id: 'service_id_example', # String | Query by Service to list all Products for a specific provider service. e.g. aws-ec2
-  name: 'name_example' # String | Query by name of the Product to see a list of products which match that name. e.g. m5a.16xlarge
+  name: 'name_example', # String | Query by name of the Product to see a list of products which match that name. e.g. m5a.16xlarge
+  page: 2, # Integer | The page of results to return.
+  limit: 500 # Integer | The amount of results to return. The maximum is 1000
 }
 
 begin
@@ -208,6 +216,8 @@ Name | Type | Description  | Notes
  **provider_id** | **String**| Query by Provider to list all Products across all Services for a Provider. e.g. aws | [optional] 
  **service_id** | **String**| Query by Service to list all Products for a specific provider service. e.g. aws-ec2 | [optional] 
  **name** | **String**| Query by name of the Product to see a list of products which match that name. e.g. m5a.16xlarge | [optional] 
+ **page** | **Integer**| The page of results to return. | [optional] 
+ **limit** | **Integer**| The amount of results to return. The maximum is 1000 | [optional] 
 
 ### Return type
 
@@ -225,7 +235,7 @@ Name | Type | Description  | Notes
 
 
 # **get_providers**
-> Providers get_providers
+> Providers get_providers(opts)
 
 
 
@@ -243,8 +253,13 @@ end
 
 api_instance = Vantage::PricesApi.new
 
+opts = { 
+  page: 2, # Integer | The page of results to return.
+  limit: 500 # Integer | The amount of results to return. The maximum is 1000
+}
+
 begin
-  result = api_instance.get_providers
+  result = api_instance.get_providers(opts)
   p result
 rescue Vantage::ApiError => e
   puts "Exception when calling PricesApi->get_providers: #{e}"
@@ -252,7 +267,11 @@ end
 ```
 
 ### Parameters
-This endpoint does not need any parameter.
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **page** | **Integer**| The page of results to return. | [optional] 
+ **limit** | **Integer**| The amount of results to return. The maximum is 1000 | [optional] 
 
 ### Return type
 
@@ -289,7 +308,9 @@ end
 api_instance = Vantage::PricesApi.new
 
 opts = { 
-  provider_id: 'provider_id_example' # String | Query services for a specific provider. e.g. aws
+  provider_id: 'provider_id_example', # String | Query services for a specific provider. e.g. aws
+  page: 2, # Integer | The page of results to return.
+  limit: 500 # Integer | The amount of results to return. The maximum is 1000
 }
 
 begin
@@ -305,6 +326,8 @@ end
 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
  **provider_id** | **String**| Query services for a specific provider. e.g. aws | [optional] 
+ **page** | **Integer**| The page of results to return. | [optional] 
+ **limit** | **Integer**| The amount of results to return. The maximum is 1000 | [optional] 
 
 ### Return type
 

data/docs/Report.md

@@ -0,0 +1,13 @@
+# Vantage::Report
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**id** | **String** |  | [optional] 
+**title** | **String** | The title of the cost report. | [optional] 
+**earliest_cost_date** | **String** | The date and time, in UTC, the report was created. ISO 8601 Formatted - 2021-01-01 or 2021-01-01T00:00:00Z. | [optional] 
+**latest_cost_date** | **String** | The date and time, in UTC, the report was created. ISO 8601 Formatted - 2021-07-31 or 2021-07-31T00:00:00Z. | [optional] 
+**created_at** | **String** | The date and time, in UTC, the report was created. ISO 8601 Formatted - 2021-07-15 or 2021-07-15T00:00:00Z. | [optional] 
+**workspace** | **String** | The name of the workspace the report is a part of. | [optional] 
+
+

data/docs/Reports.md

@@ -0,0 +1,9 @@
+# Vantage::Reports
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**links** | **Object** |  | [optional] 
+**reports** | [**Array<Report>**](Report.md) |  | [optional] 
+
+