datadog-api-client-ruby
This repository contains a Ruby API client for the Datadog API. The code is generated using openapi-generator and apigentools.
Datadog API Collection
- API version: 1.0
Collection of all Datadog Public endpoints.
For more information, please visit https://www.datadoghq.com/support/
Automatically generated by the OpenAPI Generator
Requirements
Building and using the API client library requires:
- Ruby 2.2+
Installation
To install the API client library, simply execute:
gem install datadog_api_client --pre
Getting Started
Please follow the installation instruction and execute the following Ruby code:
require 'time'
require 'datadog_api_client'
# setup authorization
DatadogAPIClient::V1.configure do |config|
# Configure API key authorization: apiKeyAuth
config.api_key['apiKeyAuth'] = ENV["DD_CLIENT_API_KEY"]
# Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
# config.api_key_prefix['apiKeyAuth'] = 'Bearer'
# Configure API key authorization: appKeyAuth
config.api_key['appKeyAuth'] = ENV["DD_CLIENT_APP_KEY"]
# Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
# config.api_key_prefix['appKeyAuth'] = 'Bearer'
end
api_instance = DatadogAPIClient::V1::AWSIntegrationApi.new
body = DatadogAPIClient::V1::AWSAccount.new({
account_id: "123456789012",
role_name: "DatadogAWSIntegrationRole",
}) # AWSAccount | AWS Request Object
begin
# Create an AWS integration
result = api_instance.create_aws_account(body)
p result
rescue DatadogAPIClient::V1::ApiError => e
puts "Error when calling AWSIntegrationApi->create_aws_account: #{e}"
end
Unstable Endpoints
This client includes access to Datadog API endpoints while they are in an unstable state and may undergo breaking changes. An extra configuration step is required to enable these endpoints:
DatadogAPIClient::V1.configure do |config|
config.unstable_operations[:"<OperationName>"] = true
end
where <OperationName>
is the name of the method used to interact with that endpoint. For example: list_log_indexes
, or get_logs_index
Documentation for API Endpoints and Models
Documentation for API endpoints and models can be found under the docs
directory.
Documentation for Authorization
Authenticate with the API by providing your API and Application keys in the configuration:
DatadogAPIClient::V1.configure do |config|
config.api_key["apiKeyAuth"] = "YOUR_API_KEY"
config.api_key["appKeyAuth"] = "YOUR_APPLICATION_KEY"
end