| 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. column |
Include Page
...
_ARADGComplianceNote
...
| Panel | ||
|---|---|---|
| ||
On this page:
|
REST API resources
| Resource | URI template | methods | description | permissions | comments |
|---|---|---|---|---|---|
| Accounts |  You usually won't interact with accounts via the API currently, please see the Connectors resource instead! | ||||
| /accounts | GET|POST | Get all accounts (IAM users). | Administrator | ||
| /accounts/{id} | GET|DELETE|PUT | Get an account (IAM user) identified by its id. | Administrator | ||
| Connectors |  This is the main resource to interact with currently in order to retrieve temporary AWS credentials. | ||||
/connectors | GET | Get all AWS connectors. | Configurable |  You only need GET for the intended usage as a token vendor, but POST will be added in a subsequent release regardless. | |
| /connectors/{id} | GET | Get an AWS connector identified by its id. | Configurable | You only need GET for the intended usage as a token vendor, but DELETE|PUT will be added in a subsequent release regardless. | |
| /connectors/{id}/credentials | GET | Get the temporary security credentials via an AWS connector identified by its id. | Configurable | This is the main resource to use for calling AWS Services in turn. |
_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-for-aws/2.0 |
| Insert excerpt | ||||||
|---|---|---|---|---|---|---|
|
Frequently Asked Questions (FAQ)
| Questionslist macro | ||||||||
|---|---|---|---|---|---|---|---|---|
|