fastly-ruby

A Ruby client library for interacting with most facets of the Fastly API.

To install via RubyGems, add the following to your project's Gemfile:

gem 'fastly', '~> 8.1.0'

Then run bundle install.

# Load the gem
require 'fastly'

# Authorize the client with a Fastly API token.
Fastly.configure do |config|
# Configure API key authorization: token
  config.api_token = 'YOUR API KEY'
end

api_instance = Fastly::AclApi.new

opts = {
  service_id: 'SU1Z0isxPaozGVKXdv0eY', # String
  version_id: 56, # Integer
  name: 'my_acl', # String
}

begin
  result = api_instance.create_acl(opts)
  p result
rescue Fastly::ApiError => e
  puts "Exception when calling AclApi->create_acl: #{e}"
end

The Fastly API requires an API token for most operations. Set it in the Ruby client by assigning to api_token of a configuration as shown:

# Authorize the client with a Fastly API token.
Fastly.configure do |config|
  # Configure API key authorization: token
  config.api_token = 'YOUR API KEY'
end

Alternatively, set the FASTLY_API_TOKEN environment variable instead of setting api_token.

The main documentation for the Fastly API can be found on our Developer Hub.

The fastly-ruby API client currently does not support the following endpoints:

• /alerts/definitions/{definition_id} (DELETE, GET, PUT)
• /alerts/definitions (GET, POST)
• /alerts/history (GET)
• /resources/stores/kv/{store_id}/batch (PUT)
• /tls/activations/{tls_activation_id} (GET, PATCH)
• /tls/activations (GET)
• /v1/channel/{service_id}/ts/h/limit/{max_entries} (GET)
• /v1/channel/{service_id}/ts/h (GET)
• /v1/channel/{service_id}/ts/{start_timestamp} (GET)

If you encounter any non-security-related bug or unexpected behavior, please file an issue using the bug report template.

Please see our SECURITY.md for guidance on reporting security-related issues.

MIT.