Creating an Authority Using REST
[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='http://schemas.microsoft.com/sitka/2008/03/'> <s:Id>NewAuthorityId</s:Id> </s:Authority>
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.