1.0

get /v1/roles

Description

Get role list

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
query	size optional	size Example : `20`	any of [integer, null]	20
query	page optional	page Example : `0`	any of [integer, null]	0
query	sort optional	sort Example : `created_at:desc`	any of [string, null]	None
query	name optional	역할명 Example :	any of [string, null]	None
query	role_type optional	역할 유형 Example :	any of [string, null]	None
query	account_id optional	역할이 속한 계정의 ID Example :	any of [string, null]	None
query	exclude_policy_id optional	예외 대상 정책 Example :	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	RolePageResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/roles

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = iam 1.0"

Example HTTP response

Response 200

{
    "count": 20,
    "page": 0,
    "roles": [
        {
            "account_id": "",
            "assume_role_policy_document": {
                "Statement": [
                    {
                        "Action": [
                            "iam:*"
                        ],
                        "Condition": {
                            "StringEquals": {
                                "scp:RequestedRegion": [
                                    "kr-west1"
                                ]
                            }
                        },
                        "Effect": "Allow",
                        "NotAction": [],
                        "Principal": [],
                        "Resource": [
                            "*"
                        ],
                        "Sid": "Statement1"
                    }
                ],
                "Version": "2024-07-01"
            },
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "ef50cdc207f05f6fb8f20219f229ed1f",
            "creator_email": "",
            "creator_name": "",
            "description": "",
            "id": "f39c460fade34fecb05ede8f904b24b7",
            "max_session_duration": "",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "ef50cdc207f05f6fb8f20219f229ed1f",
            "modifier_email": "",
            "modifier_name": "",
            "name": "",
            "policies": [
                {
                    "account_id": "e99c73a8690d4ae39ae75e38a26f2b99",
                    "created_at": "2024-05-17T00:23:17Z",
                    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
                    "creator_email": "samsung.kim@samsung.com",
                    "creator_name": "Kim Samsung",
                    "default_version_id": "c1b1fc611eb34eccbccfb563f77395ee",
                    "description": "Descriptions for policy",
                    "domain_name": "scp",
                    "id": "37f2e31ff86b415698d7e8eeafab445d",
                    "modified_at": "2024-05-17T00:23:17Z",
                    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
                    "modifier_email": "samsung.kim@samsung.com",
                    "modifier_name": "Kim Samsung",
                    "policy_category": "IDENTITY_BASED",
                    "policy_name": "PolicyName",
                    "policy_type": "USER_DEFINED",
                    "policy_versions": [
                        {
                            "created_at": "2024-05-17T00:23:17Z",
                            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
                            "id": "c1b1fc611eb34eccbccfb563f77395ee",
                            "modified_at": "2024-05-17T00:23:17Z",
                            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
                            "policy_document": {
                                "Statement": [
                                    {
                                        "Action": [
                                            "iam:*"
                                        ],
                                        "Condition": {
                                            "StringEquals": {
                                                "scp:RequestedRegion": [
                                                    "kr-west1"
                                                ]
                                            }
                                        },
                                        "Effect": "Allow",
                                        "NotAction": [],
                                        "Principal": [],
                                        "Resource": [
                                            "*"
                                        ],
                                        "Sid": "Statement1"
                                    }
                                ],
                                "Version": "2024-07-01"
                            },
                            "policy_id": "37f2e31ff86b415698d7e8eeafab445d",
                            "policy_version_name": "PolicyVersion-1"
                        }
                    ],
                    "resource_type": "policy",
                    "service_name": "Identity Access Management",
                    "service_type": "iam",
                    "srn": "srn:qa2:::::iam:policy/37f2e31ff86b415698d7e8eeafab445d",
                    "state": "ACTIVE"
                }
            ],
            "type": "USER_DEFINED"
        }
    ],
    "size": 20,
    "sort": [
        "created_at:asc"
    ]
}