Ruby library for version 2 of DigitalOcean's API.
Please note that version 2 of DigitalOcean's API is in beta, and is still being developed. Everything is subject to change.
gem install bargeRuby 1.9 and up is required. See the .travis.yml file for a list of supported rubies.
barge = Barge::Client.new(access_token: 'token')or
barge = Barge::Client.new do |config|
config.access_token = 'token'
endHashie::Mash is used so that attributes can be accessed using dot notation:
droplet = barge.droplet.show(droplet_id)
droplet.name # => "foo"
droplet.image.id # => 123
droplet.size!.vcpus # => 1Notice that size! and not size was used. This is because size already is
a method, and Hashie::Mash will not override it. You can also use square
brackets:
droplet[:size][:vcpus] # => 1
droplet['size']['vcpus'] # => 1You can use success? to check if a successful HTTP status code was returned:
barge.droplet.create(options).success? # => truebarge.action.allbarge.action.show(action_id)barge.droplet.create(options)See the API documentation for options.
barge.droplet.allbarge.droplet.show(droplet_id)barge.droplet.backups(droplet_id)barge.droplet.snapshots(droplet_id)barge.droplet.destroy(droplet_id)barge.droplet.rename(droplet_id, 'new name')barge.droplet.reboot(droplet_id)barge.droplet.shutdown(droplet_id)barge.droplet.power_off(droplet_id)barge.droplet.power_cycle(droplet_id)barge.droplet.power_on(droplet_id)barge.droplet.resize(droplet_id, 'size slug')Where size slug is for example 1024mb.
barge.droplet.rebuild(droplet_id, image_id)barge.droplet.restore(droplet_id, image_id)barge.droplet.password_reset(droplet_id)barge.droplet.show_action(droplet_id, action_id)barge.image.allBy ID:
barge.image.show(image_id)By image slug (public images):
barge.image.show('image slug')Where image slug is for example ubuntu-13-10-x64.
barge.image.update(image_id, options)See the API documentation for options.
barge.image.destroy(image_id)barge.image.transfer(image_id, 'region slug')Where region slug is for example sfo1.
barge.image.show_action(image_id, action_id)barge.domain.create(options)See the API documentation for options.
barge.domain.allbarge.domain.show(domain_name)barge.domain.destroy(domain_name)barge.domain.create_record(domain_name, options)See the API documentation for options.
barge.domain.recordsbarge.domain.show_record(domain_name, record_id)barge.domain.update_record(domain_name, record_id, options)barge.domain.destroy_record(domain_name, record_id)barge.key.create(options)See the API documentation for options.
barge.key.allbarge.key.show(key_id_or_fingerprint)barge.key.destroy(key_id)barge.region.allbarge.size.all
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent