| Section | |||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Getting started
The Identity Federation for AWS REST API is based on open standards, so you can use any web development language or command line tool capable of generating an HTTP request to access the API, e.g. the popular cURL (a CLI tool for transferring data with URL syntax) or the highly recommended HTTPie (a CLI, cURL-like tool for humans). All resources can be used like the regular JIRA REST API (or Stash REST API, see info below):
| Tip | ||
|---|---|---|
| ||
The easiest way to explore and experiment with the Identity Federation for AWS API is by means of the Atlassian REST API Browser, simply select the Identity Federation for AWS resources. |
Include Page _ARADGComplianceNote _ARADGComplianceNote
Structure of the REST URIs
The Identity Federation for AWS REST API provides access to resources (data entities) via URI paths. To use the REST API, your application will make an HTTP request and parse the response. The Identity Federation for AWS REST API uses JSON as its communication format, and the standard HTTP methods like GET, PUT, POST and DELETE. URIs for Identity Federation for AWS REST API resources are keyed by the add-on namespace and have the following structure:
| Code Block |
|---|
http://host:port/context/rest/identity-federation-aws/1.0 |
...
| Resource | URI template | methods | description | permissions | comments |
|---|---|---|---|---|---|
| Connectors |  This is the main resource to interact with currently in order to retrieve temporary AWS security credentials. | ||||
| GET | Get all AWS connectors. | Configurable | |||
| /connectors/{id} | GET | Get an AWS connector identified by its id. | Configurable | . | |
| /connectors/{id}/credentials | GET | Get the temporary AWS security credentials via a AWS connector identified by its id. | Configurable |  This is the main resource to use for calling AWS services in turn. |
...