technical diversion – DBaaS Rest APIs

We are going to take a side trip today. I was at Collaborate 2016 and one of the questions that came up was how do you provision 40 database instances for a lab. I really did not want to sit and click through 40 screens and log into 40 accounts so I decided to do a little research. It turns out that there is a relatively robust REST api that allows you to create, read, update, and delete database instances. The DBaaS Rest Api Documentation is a good place to start to figure out how this works.

To list instances that are running in the database service use the following command, note that “c url” should be shortened to remove the space. Dang blogging software! Note to make things easier and to allow us to script creation we define three variables on the command line. I did most of this testing on a Mac so it should translate to Linux and Cygwin. The three variables that we need to create are

  • ODOMAIN – instance domain that we are using in the Oracle cloud
  • OUID – username that we log in as
  • OPASS – password for this instance domain/username 

export ODOMAIN=mydomain
export OUID=cloud.admin
export OPASS=mypassword
c url -i -X GET -u $OUID:$OPASS -H "X-ID-TENANT-NAME: $ODOMAIN" -H "Content-Type:application/json" https://dbaas.oraclecloud.com/jaas/db/api/v1.1/instances/$ODOMAIN

What should return is

HTTP/1.1 200 OK
Date: Sun, 10 Apr 2016 18:42:42 GMT
Server: Oracle-Application-Server-11g
Content-Length: 1023
X-ORACLE-DMS-ECID: 005C2NB3ot26uHFpR05Eid0005mk0001dW
X-ORACLE-DMS-ECID: 005C2NB3ot26uHFpR05Eid0005mk0001dW
X-Frame-Options: DENY
X-Frame-Options: DENY
Vary: Accept-Encoding,User-Agent
Content-Language: en
Content-Type: application/json
{"uri":"https:\/\/dbaas.oraclecloud.com:443\/paas\/service\/dbcs\/api\/v1.1\/instances\/metcsgse00027","service_type":"dbaas","implementation_version":"1.0","services":[{"service_name":"test-hp","version":"12.1.0.2","status":"Running","description":"Example service instance","identity_domain":"metcsgse00027","creation_time":"Sun Apr 10 18:5:26 UTC 2016","last_modified_time":"Sun Apr 10 18:5:26 UTC 2016","created_by":"cloud.admin","sm_plugin_version":"16.2.1.1","service_uri":"https:\/\/dbaas.oraclecloud.com:443\/paas\/service\/dbcs\/api\/v1.1\/instances\/metcsgse00027\/test-hp"},{"service_name":"db12c-hp","version":"12.1.0.2","status":"Running","description":"Example service instance","identity_domain":"metcsgse00027","creation_time":"Sun Apr 10 18:1:21 UTC 2016","last_modified_time":"Sun Apr 10 18:1:21 UTC 2016","created_by":"cloud.admin","sm_plugin_version":"16.2.1.1","service_uri":"https:\/\/dbaas.oraclecloud.com:443\/paas\/service\/dbcs\/api\/v1.1\/instances\/metcsgse00027\/db12c-hp"}],"subscriptions":[]}

If you get back anything other than a 200 it means that you have the identity domain, username, or password incorrect. Note that we get back a json structure that contains two database instances that were previously created, test-hp and db12c-hp. Both are up and running. Both are 12.1.0.2 instances. We don’t know much more than these but can dive a little deeper by requesting more information by included the service name as part of the request. A screen shot of the deeper detail is shown below.

A list of the most common commands are shown in the screen shot below

The key options to remember are:

  • list: -X GET
  • stop: -X POST –data ‘{ “lifecycleState” : “Stop” }’
  • restart: -X POST –data ‘{ “lifecycleState” : “Restart” }’
  • delete: -X DELETE **need to add the instance name at the end, for example db12c-hp in request above
  • create: -X POST –data @createDB.json

In the create option we include a json file that defines everything for the database instance.

{
"serviceName": "test-hp",
"version": "12.1.0.2",
"level": "PAAS",
"edition": "EE_HP",
"subscriptionType": "HOURLY",
"description": "Example service instance",
"shape": "oc3",
"vmPublicKeyText": "ssh-rsa AAAAB3NzaC1yc2EAAAABJQAAAQEAnrfxP1Tn50Rvuy3zgsdZ3ghooCclOiEoAyIl81Da0gzd9ozVgFn5uuSM77AhCPaoDUnWTnMS2vQ4JRDIdW52DckayHfo4q5Z4N9dhyf9n66xWZM6qyqlzRKMLB0oYaF7MQQ6QaGB89055q23Vp+Pk5Eo+XPUxnfDR6frOYZYnpONyZ5+Qv6pmYKyxAyH+eObZkxFMAVx67VSPzStimNjnjiLrWxluh4g3XiZ1KEhmTQEFaLKlH2qdxKaSmhVg7EA88n9tQDWDwonw49VXUn/TaDgVBG7vsWzGWkRkyEN57AhUhRazs0tEPuGI2jXY3V8Q00w3wW38S/dgDcPFdQF0Q== rsa-key-20160107",
"parameters": [
{
"type": "db",
"usableStorage": "20",
"adminPassword": "Test123_",
"sid": "ORCL",
"pdb": "PDB1",
"failoverDatabase": "no",
"backupDestination": "none"
}
]
}

The vmPublicKeyText is our id_rsa.pub file that we use to connect to the service. I did not include a backup space but could have. I did not in this example because we have to embed a password in this space and I did not want to show a service with username and password.

Overall, I prefer scripting everything and running this from a command line. Call me old school but sitting for hours and clicking through screens when I can script it and get a notification when it is done appeals to me.

Post Views: 4,941

870 thoughts on “technical diversion – DBaaS Rest APIs”

  331. betway365 ยินดีต้อนรับเข้าสู่เว็บไซต์ คาสิโนออนไลน์ เราคือเว็บที่มี คาสิโนออนไลน์ ที่ครบครันที่สุด บาคาร่า บาคาร่าออนไลน์ และกราฟิกสวยที่สุด

    Reply

  584. Your writing is perfect and complete. bitcoincasino However, I think it will be more wonderful if your post includes additional topics that I am thinking of. I have a lot of posts on my site similar to your topic. Would you like to visit once?

    Reply

  744. Can Zithromax 1 gram Look after Gonorrhea? Gonorrhea is a bacterial infection and is treated with antibiotics. The first-line treatment is an injection of ceftriaxone, paired with an oral seven-day positively of doxycycline or azithromycin. Doxycycline solitary is not resolute sufficiently to talk to a gonorrhea infection.

    Reply

  790. Men with ED may feel hesitant to seek new relationships or pursue new romantic interests, fearing potential rejection or judgment based on their sexual difficulties.

    fildena for sale http://fildena.makeup/ order fildena 100mg without prescription

    Reply

  808. Maintaining a healthy weight is crucial for overall sexual health. Obesity is closely linked to ED, as it can lead to hormonal imbalances, reduced testosterone levels, and impaired blood flow. By adopting a balanced diet and engaging in regular exercise, individuals can manage their weight and potentially improve erectile function.. buy vardenafil http://illevitrain.com/ viagra for men amazon

    Reply

  836. Экспресс-строения здания: финансовая польза в каждом блоке!
    В современной реальности, где время имеет значение, быстровозводимые здания стали решением по сути для компаний. Эти современные объекты сочетают в себе солидную надежность, экономическую эффективность и быстрый монтаж, что обуславливает их наилучшим вариантом для коммерческих мероприятий.
    Проект быстровозводимого здания цена
    1. Молниеносное строительство: Секунды – определяющие финансовые ресурсы в бизнесе, и здания с высокой скоростью строительства позволяют существенно сократить сроки строительства. Это высоко оценивается в условиях, когда актуально быстро начать вести дело и начать прибыльное ведение бизнеса.
    2. Финансовая выгода: За счет улучшения процессов изготовления элементов и сборки на объекте, расходы на скоростройки часто бывает менее, по сопоставлению с традиционными строительными задачами. Это способствует сбережению денежных ресурсов и получить лучшую инвестиционную отдачу.
    Подробнее на http://www.scholding.ru/
    В заключение, экспресс-конструкции – это идеальное решение для коммерческих проектов. Они объединяют в себе быстроту возведения, финансовую эффективность и высокую прочность, что дает им возможность первоклассным вариантом для предприятий, имеющих целью быстрый бизнес-старт и гарантировать прибыль. Не упустите момент экономии времени и средств, лучшие скоростроительные строения для вашего следующего делового мероприятия!

    Reply

  838. Эффективное теплоизоляция облицовки — прекрасие и экономическая эффективность в приватном недвижимости!
    Согласитесь, ваш жилье заслуживает превосходного! Теплоизоляция облицовки – не только решение для экономии на отопительных расходах, это вклад в удобство и стойкость вашего недвижимости.
    ✨ Почему тепловая изоляция с нашей компанией?
    Искусство: Наши – опытные. Наш коллектив заботимся о каждом аспекте, чтобы обеспечить вашему жилью идеальное тепловая изоляция.
    Расценки теплоизоляции: Наша компания ценим ваш средства. Стоимость утепления фасада с декоративной штукатуркой – от 1350 руб./кв.м. Это вложение капитала в ваше удовлетворительное будущее!
    Сбережение энергии: Забудьте о термопотерях! Наши не только сохраняют тепловую атмосферу, но и дарят вашему дому новый уровень уюта энергоэффективности.
    Создайте свой домашний интерьер теплым и уютным и элегантным!
    Подробнее на n-dom.ru/

    Не предоставляйте без внимания свой домовладение на произвольное стечение обстоятельств. Доверьтесь нашей команде и создайте тепло вместе с нами-мастерами!

    Reply

  845. Наша группа искусных исполнителей предоставлена предоставлять вам актуальные методы, которые не только ассигнуруют надежную протекцию от холодильности, но и дарят вашему зданию трендовый вид.
    Мы работаем с новейшими материалами, подтверждая долгосрочный срок службы работы и блестящие решения. Теплоизоляция внешнего слоя – это не только сбережение на огреве, но и внимание о окружающей природе. Энергоэффективные методы, какие мы претворяем в жизнь, способствуют не только жилищу, но и сохранению природных ресурсов.
    Самое ключевое: Утепления стен дома цена работы у нас открывается всего от 1250 рублей за метр квадратный! Это бюджетное решение, которое изменит ваш жилище в реальный уютный угол с минимальными расходами.
    Наши произведения – это не исключительно теплоизоляция, это созидание площади, в котором любой элемент показывает ваш свой образ действия. Мы рассмотрим все ваши просьбы, чтобы преобразить ваш дом еще еще более приятным и привлекательным.
    Подробнее на http://www.ppu-prof.ru
    Не откладывайте дела о своем ларце на потом! Обращайтесь к специалистам, и мы сделаем ваш помещение не только согретым, но и по последней моде. Заинтересовались? Подробнее о наших услугах вы можете узнать на интернет-портале. Добро пожаловать в мир комфорта и стандартов.

    Reply

  847. Уважаемые Гости!
    Предоставляем вам оригинальное понятие в мире оформления домашней обстановки – шторы плиссе. Если вы рассчитываете к совершенству в всякой части вашего дома, то эти перила будут безупречным паттерном для вас.
    Что делает шторы плиссе столькими неповторимыми? Они совмещают в себе в себе выгоду, действенность и пользу. Благодаря особенной литере, последним материалам, шторы плиссе идеально подходятся для какова угодно комнаты, будь то палата, койка, плита или рабочее поле.
    Закажите шторы плиссе – прообразите уют и красочность в вашем доме!
    Чем манят шторы плиссе для вас? Во-первых, их своеобразный декор, который прибавляет к индивидуальность и вкус вашему жилищу. Вы можете выискать из различных текстур, оттенков и подходов, чтобы выделить самобытность вашего дома.
    Кроме того, шторы плиссе предлагают многочисленный ассортимент практических вариантов. Они могут контролировать степень сияния в помещении, преграждать от солнечного света, обеспечивать секретность и создавать уютную атмосферу в вашем жилище.
    Наш ресурс: tulpan-pmr.ru
    Мы сами поможем вам подобрать шторы плиссе, которые идеально гармонизируются с для вашего обстановки!

    Reply

  861. Мы специалисты SEO-специалистов, работающих над увеличением посещаемости и рейтинга вашего сайта в поисковых системах.
    Мы постигли успехи в своей области и хотим поделиться с вами нашим опытом и навыками.
    Какие услуги мы предоставляем:
    • раскрутка сайта визитки
    • Подробный анализ вашего сайта и создание персонализированной стратегии продвижения.
    • Повышение эффективности контента и технических аспектов вашего сайта.
    • Ежемесячный мониторинг и анализ данных для постоянного совершенствования вашего онлайн-присутствия.
    Подробнее https://seo-prodvizhenie-ulyanovsk1.ru/
    Уже много клиентов оценили результаты: повышение посещаемости, улучшение позиций в поисковых запросах и, конечно же, рост бизнеса. У нас вы можете получить бесплатную консультацию, чтобы обсудить ваши потребности и помочь вам разработать стратегию продвижения, соответствующую вашим целям и бюджету.
    Не упустите шанс улучшить свой бизнес в онлайн-мире. Обратитесь к нам прямо сейчас.

    Reply

  862. As new data emerges and our understanding of COVID-19 evolves, ongoing research into stromectol’s efficacy and safety will be crucial. ivermectin 12mg Collaboration and open dialogue among scientists, clinicians, and policymakers will facilitate the rapid dissemination of knowledge and inform public health interventions.

    Reply

  863. stromectol for scabies dosage, featuring ivermectin, has been evaluated for its potential to reduce the transmission of soil-transmitted helminths in endemic regions through targeted treatment interventions. By deploying mass drug administration programs in communities at high risk of infection, public health authorities aim to break the cycle of transmission and prevent the spread of parasitic diseases within vulnerable populations.

    Reply

Leave a Reply

Your email address will not be published. Required fields are marked *