Page tree

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space DEV and version r0682

D s api version

D toc

Create an AWS roles object, which is associated with an AWS configuration object. 


NOTE: APIs for AWS roles apply only to instances of the

D s platform
that are hosted on AWS and configured for user mode of authentication.


NOTE: In most cases, you do not need to create awsRole objects. These objects are automatically created for you when you create an awsConfig object. For more information, see API Workflow - Manage AWS Configurations.


Required Permissions

At least one of the following roles is required to use this endpoint:

  • Workspace admin

  • D s item
For more information, see API Authentication.


Request Type: POST


Code Block

Request Body:

The following is an example request for such an AWS roles object. The IAM role arn is associated with the specific AWS configuration object:

Code Block
  "role": "<my_iam_role_arn>"

Request Body with assignment:

When you create an AWS role object, you can optionally pass in a person or workspace identifier. Based on this identifier, the 

D s platform
 attempts to assign the new object to the appropriate person or workspace identifiers through the referenced AWS configuration object.

Person Id:

Code Block
  "role": "<my_iam_role_arn>",
  "personId": 99

Workspace Id:

Code Block
  "role": "<my_iam_role_arn>",
  "workspaceId": 1


Response Status Code - Success:  201 - Created

Response Body:

Code Block
    "createdFrom": "api",
    "id": 1,
    "role": "<my_iam_role_arn>",
    "awsConfigId": 2,
    "updatedAt": "2019-07-15T23:18:59.360Z",
    "createdAt": "2019-07-15T23:18:59.360Z",
    "deleted_at": null


For more information, see API AWSRoles Get List v4.