Get New Least Privilege Access Suggestions for an Asset
GET/iam/api/v1/assets/:assetId/custom-least-privileged-access
Generate Custom least privileged access configuration for the asset. Applying this configuration will minimize the amount of policies/roles used while preserve all the actions used in the last specified last X days
Request
Path Parameters
assetId stringrequired
The UAI of the asset.
Query Parameters
output_format stringrequired
Possible values: [JSON
, TERRAFORM
, CF
]
Output format type. One of: JSON / TERRAFORM/ CF
lookback_duration_days int32required
Amount of days to look back for used actions
Example: 90
Responses
- 200
- 400
- 401
- 403
- 404
- 429
OK
- application/json
- Schema
- Example (from schema)
Schema
- Array [
- ]
- Array [
- ]
nextPageToken string
Next page token
permissionsInAssetCount int32
Number of actions in asset
permissionsInLeastPrivilegedCount int32
Number of actions in least privileged access
analysis object[]
Least Privileged result analysis
action string
configurationName string
keep boolean
value object[]
Least Privileged Access items
formatType string
Format type of the access policy
snippet string
The access policy
{
"nextPageToken": "++fdfkjsdlfsdfdFDSFDFSDFdfdssfdFDS",
"permissionsInAssetCount": 10,
"permissionsInLeastPrivilegedCount": 10,
"analysis": [
{
"action": "string",
"configurationName": "string",
"keep": true
}
],
"value": [
{
"formatType": "TERRAFORM",
"snippet": "Terraform code for creating a policy"
}
]
}
Bad request
- application/json
- Schema
- Example (from schema)
Schema
error object
code stringrequired
message stringrequired
target string
details string[]
innerError
{
"error": {
"code": "string",
"message": "string",
"target": "string",
"details": [
"string"
]
}
}
Unauthorized
- application/json
- Schema
- Example (from schema)
Schema
error object
code stringrequired
message stringrequired
target string
details string[]
innerError
{
"error": {
"code": "string",
"message": "string",
"target": "string",
"details": [
"string"
]
}
}
Forbidden
- application/json
- Schema
- Example (from schema)
Schema
error object
code stringrequired
message stringrequired
target string
details string[]
innerError
{
"error": {
"code": "string",
"message": "string",
"target": "string",
"details": [
"string"
]
}
}
Not found
- application/json
- Schema
- Example (from schema)
Schema
error object
code stringrequired
message stringrequired
target string
details string[]
innerError
{
"error": {
"code": "string",
"message": "string",
"target": "string",
"details": [
"string"
]
}
}
Throttled
Response Headers
X-RateLimit-Remaining integer
X-RateLimit-Requested-Tokens integer
X-RateLimit-Burst-Capacity integer
X-RateLimit-Replenish-Rate integer
Loading...