Creating an Authority Using REST

  • Article

[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.]

To create an authority using the REST interface, you define an XML payload that describes the authority that you want to create, including the required Id metadata property. For example:

<s:Authority xmlns:s='https://schemas.microsoft.com/sitka/2008/03/'>
   <s:Id>NewAuthorityId</s:Id>
</s:Authority>

Note

When you create an authority, the AuthorityId must contain only lowercase letters, numbers, or dashes. Within the service, each authority must have a unique id.

After the payload has been defined, you send an HTTP request to the service using the POST method on that request. This operation sends the payload to the service. After completing the operation, the service returns a response with a HTTP status that indicates whether the operation succeeded or failed.

The following topics provide working examples in various programming languages.

Creating an Authority Using REST (C#)

Creating an Authority Using REST (Java)

Creating an Authority Using REST (Ruby)

Creating an Authority Using REST (VB)

See Also

Concepts

Guidelines and Limitations
SDS Data Model Overview (Authorities, Containers, Entities and Flexible Entities)
Examples of Using SOAP and REST Interfaces with the SQL Data Services