Creating an Authority Using REST (Ruby)

[This document supports a preliminary release of a software product that may be changed substantially prior to final commercial release. This document is provided for informational purposes only.]

As described in Creating an Authority Using REST, this topic provides a Ruby sample to create an authority. You will need to update the code and do the following:

  • Provide your own credentials.
  • Provide the id value for the authority being created.
  • Set proxy information.
require 'base64' 
require 'bigdecimal'
require 'net/https'
require 'openssl'
require 'rexml/document'
require 'uri'

# Provide your own credentials and sample authority id you want to create
USER_NAME = '<UserName>'
PASSWORD = '<Password>'
SAMPLE_AUTHORITY_ID = '<AuthorityIdToCreate>'
# Provide proxy information
PROXY_ADDRESS = nil 
PROXY_PORT = nil 
PROXY_USER = nil 
PROXY_PASSWORD = nil 
  
SVC_ENDPOINT = 'data.database.windows.net' 
SVC_VERSION = 'v1'

# setup credentials 
Credentials = Struct.new("Credentials", :un, :pw)
myCred = Credentials.new(USER_NAME, PASSWORD)

#setup proxy information -- if you don't have to use a proxy you can set everything to nil
Proxy_info = Struct.new("Proxy_info", :addr, :port, :user, :pw)
myProxy = Proxy_info.new(PROXY_ADDRESS, PROXY_PORT, PROXY_USER, PROXY_PASSWORD)

reqXml = REXML::Document.new()
reqXml.add_element('s:Authority')
reqXml.root().add_attribute('xmlns:s', 'https://schemas.microsoft.com/sitka/2008/03/')
reqXml.root().add_element("s:Id")
reqXml.root().elements["s:Id"].text = SAMPLE_AUTHORITY_ID


authorityUri = SAMPLE_AUTHORITY_ID + '.' + SVC_ENDPOINT
reqPath= '/' + SVC_VERSION + '/'

# Open an HTTP session to SSDS
SSDS = Net::HTTP::Proxy(myProxy.addr, myProxy.port, myProxy.user, myProxy.pw).new('data.database.windows.net', 443)
SSDS.use_ssl=true
SSDS.verify_mode=OpenSSL::SSL::VERIFY_NONE
SSDS.verify_mode=OpenSSL::SSL::VERIFY_NONE
SSDS.start()

# now we want to post to the open session
# build request to post to the open sesson
myReq = Net::HTTP::Post.new(reqPath)       
myReq['Content-Type'] = 'application/x-ssds+xml'
myReq['Content-Length'] = reqXml.to_s.size.to_s
# add to my request the basic auth 
myReq.basic_auth(myCred.un,  myCred.pw)

# send the requst 
response = SSDS.request(myReq, reqXml.to_s)

method = 'POST'
case response
  when Net::HTTPSuccess     then 
    puts SAMPLE_AUTHORITY_ID + ' created'
    error = false
  when Net::HTTPForbidden then
    puts "SSDS Access denied"
    error = true
  when Net::HTTPBadRequest then
    puts "Request is not valid"
    error = true
  when Net::HTTPConflict   then
    puts "SSDS Authority already exists"
    error = true
  else
    puts "Unexpected Error"
    error = true
  end
  if(error)
# process the http response body 
    xml = REXML::Document.new(response.body)
    puts "SSDS #{method} Error: #{xml.root().elements[1].name} =>  #{xml.root().elements[1].text}"
    puts "SSDS #{method} Error: #{xml.root().elements[2].name} =>  #{xml.root().elements[2].text}"
  end
  
  
  

See Also

Concepts

Creating an Authority Using REST
Examples of Using REST Interface with the SQL Data Services
Guidelines and Limitations