Get

/iamroles/{id}/

This endpoint returns details of a specified IAM Role.

Security

HTTP

Type basic

Basic authentication using VMS user name and password

API Key: ApiToken

Header parameter nameApiToken

Send current valid API token in an Authorization header with format Api-Token .

Path parameters

id

integerRequired

IAM Role ID

Responses

200

IAM Role information

Expand All

object

Identity and Access Management Role

id

integer

The ID of the role.

guid

string

The unique global ID for the role.

name

string

The name of the role.

description

string

A description of the role.

max_session_duration

integer

Maximum duration for validity of temporary access keys that can be requested and granted to a user requesting to assume temporary access keys to assume the role (seconds). Default - 129600 (36 hours). Minimum: 900 (15 minutes).

trust_policy

string

The trust policy, in json format. A trust policy is specific to an IAM role and defines which users are allowed to assume the role, and under which conditions.

tenant

object (PartialTenantInfo)

id

integer

Tenant ID

name

string

Tenant Name

vid

integer

A VAST user ID that points to the IAM role.

Return Details of a IAM Role