This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

IAM

1: APIs

1.1: Add a permission into the resource based policy

1.1.1: 1.2
1.1.2: 1.1
1.1.3: 1.0

1.2: Add a user to a group

1.2.1: 1.2
1.2.2: 1.1
1.2.3: 1.0

1.3: Assign policies to the group

1.3.1: 1.2
1.3.2: 1.1
1.3.3: 1.0

1.4: Assign policies to user

1.4.1: 1.2
1.4.2: 1.1
1.4.3: 1.0

1.5: Attach policies to Role

1.5.1: 1.2
1.5.2: 1.1
1.5.3: 1.0

1.6: Create a group

1.6.1: 1.2
1.6.2: 1.1
1.6.3: 1.0

1.7: Create a policy

1.7.1: 1.2
1.7.2: 1.1
1.7.3: 1.0

1.8: Create a saml provider

1.8.1: 1.2
1.8.2: 1.1
1.8.3: 1.0

1.9: Create an access key

1.9.1: 1.2
1.9.2: 1.1
1.9.3: 1.0

1.10: Create IAM user

1.10.1: 1.2
1.10.2: 1.1
1.10.3: 1.0

1.11: Create role

1.11.1: 1.2
1.11.2: 1.1
1.11.3: 1.0

1.12: Delete bulk role

1.12.1: 1.2
1.12.2: 1.1
1.12.3: 1.0

1.13: Delete IAM user

1.13.1: 1.2
1.13.2: 1.1

1.14: Delete IAM users

1.14.1: 1.2
1.14.2: 1.1
1.14.3: 1.0

1.15: Delete role

1.15.1: 1.2
1.15.2: 1.1
1.15.3: 1.0

1.16: Delete the policy

1.16.1: 1.2
1.16.2: 1.1
1.16.3: 1.0

1.17: Delete the resource based policy

1.17.1: 1.2
1.17.2: 1.1
1.17.3: 1.0

1.18: Delete user policy

1.18.1: 1.2
1.18.2: 1.1
1.18.3: 1.0

1.19: Detach policies to Role

1.19.1: 1.2
1.19.2: 1.1
1.19.3: 1.0

1.20: Detach policy to Role

1.20.1: 1.2
1.20.2: 1.1
1.20.3: 1.0

1.21: Get a Group

1.21.1: 1.2
1.21.2: 1.1
1.21.3: 1.0

1.22: Get a specific policy binding list

1.22.1: 1.2
1.22.2: 1.1
1.22.3: 1.0

1.23: Get an access key

1.23.1: 1.2
1.23.2: 1.1
1.23.3: 1.0

1.24: Get endpoint list

1.24.1: 1.2
1.24.2: 1.1
1.24.3: 1.0

1.25: Get IAM users

1.25.1: 1.2
1.25.2: 1.1
1.25.3: 1.0

1.26: Get policy list

1.26.1: 1.2
1.26.2: 1.1
1.26.3: 1.0

1.27: Get role

1.27.1: 1.2
1.27.2: 1.1
1.27.3: 1.0

1.28: Get role list

1.28.1: 1.2
1.28.2: 1.1
1.28.3: 1.0

1.29: Get Role Policy-Binding list

1.29.1: 1.2
1.29.2: 1.1
1.29.3: 1.0

1.30: Get saml provider information

1.30.1: 1.2
1.30.2: 1.1
1.30.3: 1.0

1.31: Get service account

1.31.1: 1.2
1.31.2: 1.1
1.31.3: 1.0

1.32: Get user policy-binding list

1.32.1: 1.2
1.32.2: 1.1
1.32.3: 1.0

1.33: Group Member list

1.33.1: 1.2
1.33.2: 1.1
1.33.3: 1.0

1.34: List access keys

1.34.1: 1.2
1.34.2: 1.1
1.34.3: 1.0

1.35: List Groups

1.35.1: 1.2
1.35.2: 1.1
1.35.3: 1.0

1.36: List IAM users

1.36.1: 1.2
1.36.2: 1.1
1.36.3: 1.0

1.37: List saml providers

1.37.1: 1.2
1.37.2: 1.1
1.37.3: 1.0

1.38: List service accounts

1.38.1: 1.2
1.38.2: 1.1
1.38.3: 1.0

1.39: Modify a Group

1.39.1: 1.2
1.39.2: 1.1
1.39.3: 1.0

1.40: Query policy list

1.40.1: 1.2
1.40.2: 1.1
1.40.3: 1.0

1.41: Remove a permission into the resource based policy

1.41.1: 1.2
1.41.2: 1.1
1.41.3: 1.0

1.42: Remove a User from a Group

1.42.1: 1.2
1.42.2: 1.1
1.42.3: 1.0

1.43: Remove policies

1.43.1: 1.2
1.43.2: 1.1
1.43.3: 1.0

1.44: Remove policy assignment from group

1.44.1: 1.2
1.44.2: 1.1
1.44.3: 1.0

1.45: Remove saml providers

1.45.1: 1.2
1.45.2: 1.1
1.45.3: 1.0

1.46: Remove the access key

1.46.1: 1.2
1.46.2: 1.1
1.46.3: 1.0

1.47: Remove the access keys

1.47.1: 1.2
1.47.2: 1.1
1.47.3: 1.0

1.48: Remove the Group

1.48.1: 1.2
1.48.2: 1.1
1.48.3: 1.0

1.49: Send Temporary Access Key OTP

1.49.1: 1.2
1.49.2: 1.1
1.49.3: 1.0

1.50: Set a permission into the resource based policy

1.50.1: 1.2
1.50.2: 1.1
1.50.3: 1.0

1.51: Set an access key

1.51.1: 1.2
1.51.2: 1.1
1.51.3: 1.0

1.52: Set role

1.52.1: 1.2
1.52.2: 1.1
1.52.3: 1.0

1.53: Set role trust policy

1.53.1: 1.2
1.53.2: 1.1
1.53.3: 1.0

1.54: Set the policy

1.54.1: 1.2
1.54.2: 1.1
1.54.3: 1.0

1.55: Set the policy group binding

1.55.1: 1.2
1.55.2: 1.1
1.55.3: 1.0

1.56: Set the resource based policy

1.56.1: 1.2
1.56.2: 1.1
1.56.3: 1.0

1.57: Show group policy

1.57.1: 1.2
1.57.2: 1.1
1.57.3: 1.0

1.58: Show the policy

1.58.1: 1.2
1.58.2: 1.1
1.58.3: 1.0

1.59: Show the resource based policy

1.59.1: 1.2
1.59.2: 1.1
1.59.3: 1.0

1.60: Update IAM user

1.60.1: 1.2
1.60.2: 1.1
1.60.3: 1.0

1.61: Update IAM user password

1.61.1: 1.2
1.61.2: 1.1
1.61.3: 1.0

1.62: Update saml provider information

1.62.1: 1.2
1.62.2: 1.1
1.62.3: 1.0

2: Models

2.1: AccessKey
2.2: AccessKeyCreateRequest
2.3: AccessKeyOtpRequest
2.4: AccessKeyResponse
2.5: AccessKeyUpdateRequest
2.6: CreatedGroupMember
2.7: EndpointsResponse
2.8: Group
2.9: GroupCreateRequest
2.10: GroupMember
2.11: GroupMemberCreateRequest
2.12: GroupMemberCreateResponse
2.13: GroupMemberPageResponse
2.14: GroupPageResponse
2.15: GroupPolicyBindingRequest
2.16: GroupPolicyPageResponse
2.17: GroupPolicyResponse
2.18: GroupSetRequest
2.19: GroupShowResponse
2.20: IAMCreateUserResponse
2.21: IamPolicyDocument
2.22: IAMUserCreateRequest
2.23: IAMUserDeleteRequest
2.24: IAMUserDetailResponse
2.25: IAMUserPasswordUpdateRequest
2.26: IAMUserResponse
2.27: IAMUserUpdateRequest
2.28: ListAccessKeyRemoveRequest
2.29: ListAccessKeyResponse
2.30: ListEndpointsResponse
2.31: ListIAMUserResponse
2.32: ListPolicyRemoveRequest
2.33: ListSamlProviderRemoveRequest
2.34: ListSamlProviderResponse
2.35: Policy
2.36: PolicyBindingPageResponse
2.37: PolicyBindingSetRequest
2.38: PolicyCreateRequest
2.39: PolicyDocument
2.40: PolicyPageResponse
2.41: PolicyQueryRequest
2.42: PolicySetRequest
2.43: PolicyShowResponse
2.44: PolicyVersion
2.45: PolicyVersionCreateRequest
2.46: ResourcePolicySetRequest
2.47: ResourcePolicyShowResponse
2.48: ResourcePolicyVersion
2.49: ResourcePolicyVersionCreateRequest
2.50: Role
2.51: RoleBulkDeleteRequest
2.52: RoleCreateRequest
2.53: RolePageResponse
2.54: RolePolicyBindingPageResponse
2.55: RolePolicyBindingRequest
2.56: RolePolicyBindingResponse
2.57: RoleSetRequest
2.58: RoleShowResponse
2.59: RoleTrustPolicyPrincipal
2.60: RoleTrustPolicyRequest
2.61: RoleTrustPolicyShowResponse
2.62: SamlProviderCreateRequest
2.63: SamlProviderCreateResponse
2.64: SamlProviderDetailResponse
2.65: SamlProviderResponse
2.66: SamlProviderUpdateRequestData
2.67: ServiceAccount
2.68: ServiceAccountDetail
2.69: ServiceAccountListResponse
2.70: ServiceAccountShowResponse
2.71: Statement
2.72: StatementCreateRequest
2.73: StatementResponse
2.74: UserPolicyPageResponse
2.75: UserPolicyRequest
2.76: UserPolicyResponse
2.77: UserResponse

Overview

Provides an Application Programming Interface (API) that supports programmatic use of IaaS/PaaS products provided by SCP.

This guide provides a brief description of IAM service and how to call API. The API is provided as a RESTful API, and it responds in JSON format.

Version

Version	Status	Supported Until
1.0	DEPRECATED	20260223
1.1	SUPPORTED	20260531
1.2	CURRENT	-

OpenAPI URL

https://iam.{environment}.samsungsdscloud.com

Environment and Region List

environment	region
s	kr-west1
s	kr-east1
g	kr-south1
g	kr-south2
g	kr-south3
e	kr-west1
e	kr-east1

1 - APIs

1.1 - Add a permission into the resource based policy

1.1.1 - 1.2

post /v1/resource-policies/{srn}/statements

Description

Add a permission into the resource based policy

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	srn required	삼성 리소스 자원명 Example : `c3JuOmRldjI6OjEyMzQ1Njc4OTAxMDIzNDU2OTA6a3Itd2VzdDE6OnZpcnR1YWxzZXJ2ZXI6dmlydHVhbC1zZXJ2ZXIvYWJjZGUtMTIzNC01NTU1LTY2NjY=`	string	None
body	body required		StatementCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	StatementResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
409	Conflict	None

Example HTTP request

Request path

/v1/resource-policies/{srn}/statements

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.2"

Request body

{
    "Action": [
        "virtualserver:ShowVirtualServer"
    ],
    "Condition": {
        "StringEquals": {
            "scp:RequestedRegion": [
                "kr-west1"
            ]
        }
    },
    "Effect": "Allow",
    "NotAction": [],
    "Principal": "*",
    "Resource": [
        "srn:dev2::1234567890102345690:kr-west1::virtualserver:virtual-server/abcde-1234-5555-6666"
    ],
    "Sid": "Statement1"
}

Example HTTP response

Response 201

{
    "Statement": {
        "Action": [
            "virtualserver:ShowVirtualServer"
        ],
        "Condition": {
            "StringEquals": {
                "scp:RequestedRegion": [
                    "kr-west1"
                ]
            }
        },
        "Effect": "Allow",
        "Principal": "*",
        "Resource": [
            "srn:dev2::1234567890102345690:kr-west1::virtualserver:virtual-server/abcde-1234-5555-6666"
        ],
        "Sid": "Statement1"
    }
}

1.1.2 - 1.1

post /v1/resource-policies/{srn}/statements

Description

Add a permission into the resource based policy

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	srn required	삼성 리소스 자원명 Example : `c3JuOmRldjI6OjEyMzQ1Njc4OTAxMDIzNDU2OTA6a3Itd2VzdDE6OnZpcnR1YWxzZXJ2ZXI6dmlydHVhbC1zZXJ2ZXIvYWJjZGUtMTIzNC01NTU1LTY2NjY=`	string	None
body	body required		StatementCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	StatementResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
409	Conflict	None

Example HTTP request

Request path

/v1/resource-policies/{srn}/statements

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.1"

Request body

{
    "Action": [
        "virtualserver:ShowVirtualServer"
    ],
    "Condition": {
        "StringEquals": {
            "scp:RequestedRegion": [
                "kr-west1"
            ]
        }
    },
    "Effect": "Allow",
    "NotAction": [],
    "Principal": "*",
    "Resource": [
        "srn:dev2::1234567890102345690:kr-west1::virtualserver:virtual-server/abcde-1234-5555-6666"
    ],
    "Sid": "Statement1"
}

Example HTTP response

Response 201

{
    "Statement": {
        "Action": [
            "virtualserver:ShowVirtualServer"
        ],
        "Condition": {
            "StringEquals": {
                "scp:RequestedRegion": [
                    "kr-west1"
                ]
            }
        },
        "Effect": "Allow",
        "Principal": "*",
        "Resource": [
            "srn:dev2::1234567890102345690:kr-west1::virtualserver:virtual-server/abcde-1234-5555-6666"
        ],
        "Sid": "Statement1"
    }
}

1.1.3 - 1.0

post /v1/resource-policies/{srn}/statements

Description

Add a permission into the resource based policy

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	srn required	삼성 리소스 자원명 Example : `c3JuOmRldjI6OjEyMzQ1Njc4OTAxMDIzNDU2OTA6a3Itd2VzdDE6OnZpcnR1YWxzZXJ2ZXI6dmlydHVhbC1zZXJ2ZXIvYWJjZGUtMTIzNC01NTU1LTY2NjY=`	string	None
body	body required		StatementCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	StatementResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
409	Conflict	None

Example HTTP request

Request path

/v1/resource-policies/{srn}/statements

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"

Request body

{
    "Action": [
        "virtualserver:ShowVirtualServer"
    ],
    "Condition": {
        "StringEquals": {
            "scp:RequestedRegion": [
                "kr-west1"
            ]
        }
    },
    "Effect": "Allow",
    "NotAction": [],
    "Principal": "*",
    "Resource": [
        "srn:dev2::1234567890102345690:kr-west1::virtualserver:virtual-server/abcde-1234-5555-6666"
    ],
    "Sid": "Statement1"
}

Example HTTP response

Response 201

{
    "Statement": {
        "Action": [
            "virtualserver:ShowVirtualServer"
        ],
        "Condition": {
            "StringEquals": {
                "scp:RequestedRegion": [
                    "kr-west1"
                ]
            }
        },
        "Effect": "Allow",
        "Principal": "*",
        "Resource": [
            "srn:dev2::1234567890102345690:kr-west1::virtualserver:virtual-server/abcde-1234-5555-6666"
        ],
        "Sid": "Statement1"
    }
}

1.2 - Add a user to a group

1.2.1 - 1.2

post /v1/groups/{group_id}/members

Description

Add a user to a group

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	group_id required	Group ID Example : `a946662dc4314dac93da413a32457459`	string	None
body	body required		GroupMemberCreateRequest

Responses

HTTP Code	Description	Schema
200	OK	GroupMemberCreateResponse
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/groups/{group_id}/members

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.2"

Request body

{
    "user_id": "f39c460fade34fecb05ede8f904b24b7"
}

Example HTTP response

Response 200

{
    "group_member": {
        "created_at": "2024-05-17T00:23:17Z",
        "created_by": "ef50cdc207f05f6fb8f20219f229ed1f",
        "creator_email": "samsung.kim@samsung.com",
        "creator_name": "Kim Samsung",
        "user_email": "samsung.kim@samsung.com",
        "user_id": "f39c460fade34fecb05ede8f904b24b7",
        "user_name": "Kim Samsung"
    }
}

1.2.2 - 1.1

post /v1/groups/{group_id}/members

Description

Add a user to a group

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	group_id required	Group ID Example : `a946662dc4314dac93da413a32457459`	string	None
body	body required		GroupMemberCreateRequest

Responses

HTTP Code	Description	Schema
200	OK	GroupMemberCreateResponse
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/groups/{group_id}/members

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.1"

Request body

{
    "user_id": "f39c460fade34fecb05ede8f904b24b7"
}

Example HTTP response

Response 200

{
    "group_member": {
        "created_at": "2024-05-17T00:23:17Z",
        "created_by": "ef50cdc207f05f6fb8f20219f229ed1f",
        "creator_email": "samsung.kim@samsung.com",
        "creator_name": "Kim Samsung",
        "user_email": "samsung.kim@samsung.com",
        "user_id": "f39c460fade34fecb05ede8f904b24b7",
        "user_name": "Kim Samsung"
    }
}

1.2.3 - 1.0

post /v1/groups/{group_id}/members

Description

Add a user to a group

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	group_id required	Group ID Example : `a946662dc4314dac93da413a32457459`	string	None
body	body required		GroupMemberCreateRequest

Responses

HTTP Code	Description	Schema
200	OK	GroupMemberCreateResponse
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/groups/{group_id}/members

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"

Request body

{
    "user_id": "f39c460fade34fecb05ede8f904b24b7"
}

Example HTTP response

Response 200

{
    "group_member": {
        "created_at": "2024-05-17T00:23:17Z",
        "created_by": "ef50cdc207f05f6fb8f20219f229ed1f",
        "creator_email": "samsung.kim@samsung.com",
        "creator_name": "Kim Samsung",
        "user_email": "samsung.kim@samsung.com",
        "user_id": "f39c460fade34fecb05ede8f904b24b7",
        "user_name": "Kim Samsung"
    }
}

1.3 - Assign policies to the group

1.3.1 - 1.2

post /v1/groups/{group_id}/policy-bindings

Description

Assign policies to the group

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	group_id required	Group ID Example : `a946662dc4314dac93da413a32457459`	string	None
body	body required		GroupPolicyBindingRequest

Responses

HTTP Code	Description	Schema
200	OK	GroupPolicyResponse
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/groups/{group_id}/policy-bindings

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.2"

Request body

{
    "policy_ids": [
        "37f2e31ff86b415698d7e8eeafab445d"
    ]
}

Example HTTP response

Response 200

{
    "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"
        }
    ]
}

1.3.2 - 1.1

post /v1/groups/{group_id}/policy-bindings

Description

Assign policies to the group

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	group_id required	Group ID Example : `a946662dc4314dac93da413a32457459`	string	None
body	body required		GroupPolicyBindingRequest

Responses

HTTP Code	Description	Schema
200	OK	GroupPolicyResponse
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/groups/{group_id}/policy-bindings

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.1"

Request body

{
    "policy_ids": [
        "37f2e31ff86b415698d7e8eeafab445d"
    ]
}

Example HTTP response

Response 200

{
    "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"
        }
    ]
}

1.3.3 - 1.0

post /v1/groups/{group_id}/policy-bindings

Description

Assign policies to the group

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	group_id required	Group ID Example : `a946662dc4314dac93da413a32457459`	string	None
body	body required		GroupPolicyBindingRequest

Responses

HTTP Code	Description	Schema
200	OK	GroupPolicyResponse
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/groups/{group_id}/policy-bindings

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"

Request body

{
    "policy_ids": [
        "37f2e31ff86b415698d7e8eeafab445d"
    ]
}

Example HTTP response

Response 200

{
    "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"
        }
    ]
}

1.4 - Assign policies to user

1.4.1 - 1.2

post /v1/users/{user_id}/policy-bindings

Description

Assign policies to user

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	user_id required	사용자 ID Example :	string	None
body	body required		UserPolicyRequest

Responses

HTTP Code	Description	Schema
200	OK	UserPolicyResponse
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/users/{user_id}/policy-bindings

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.2"

Request body

{
    "policy_ids": [
        ""
    ]
}

Example HTTP response

Response 200

{
    "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"
        }
    ],
    "user_id": ""
}

1.4.2 - 1.1

post /v1/users/{user_id}/policy-bindings

Description

Assign policies to user

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	user_id required	사용자 ID Example :	string	None
body	body required		UserPolicyRequest

Responses

HTTP Code	Description	Schema
200	OK	UserPolicyResponse
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/users/{user_id}/policy-bindings

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.1"

Request body

{
    "policy_ids": [
        ""
    ]
}

Example HTTP response

Response 200

{
    "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"
        }
    ],
    "user_id": ""
}

1.4.3 - 1.0

post /v1/users/{user_id}/policy-bindings

Description

Assign policies to user

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	user_id required	사용자 ID Example :	string	None
body	body required		UserPolicyRequest

Responses

HTTP Code	Description	Schema
200	OK	UserPolicyResponse
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/users/{user_id}/policy-bindings

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"

Request body

{
    "policy_ids": [
        ""
    ]
}

Example HTTP response

Response 200

{
    "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"
        }
    ],
    "user_id": ""
}

1.5 - Attach policies to Role

1.5.1 - 1.2

post /v1/roles/{role_id}/policy-bindings

Description

Attach policies to Role

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	role_id required	역할 ID Example :	string	None
body	body required		RolePolicyBindingRequest

Responses

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

Example HTTP request

Request path

/v1/roles/{role_id}/policy-bindings

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.2"

Request body

{
    "policy_ids": [
        ""
    ]
}

Example HTTP response

Response 200

{
    "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"
        }
    ]
}

1.5.2 - 1.1

post /v1/roles/{role_id}/policy-bindings

Description

Attach policies to Role

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	role_id required	역할 ID Example :	string	None
body	body required		RolePolicyBindingRequest

Responses

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

Example HTTP request

Request path

/v1/roles/{role_id}/policy-bindings

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.1"

Request body

{
    "policy_ids": [
        ""
    ]
}

Example HTTP response

Response 200

{
    "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"
        }
    ]
}

1.5.3 - 1.0

post /v1/roles/{role_id}/policy-bindings

Description

Attach policies to Role

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	role_id required	역할 ID Example :	string	None
body	body required		RolePolicyBindingRequest

Responses

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

Example HTTP request

Request path

/v1/roles/{role_id}/policy-bindings

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"

Request body

{
    "policy_ids": [
        ""
    ]
}

Example HTTP response

Response 200

{
    "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"
        }
    ]
}

1.6 - Create a group

1.6.1 - 1.2

post /v1/groups

Description

Create a group

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
body	body required		GroupCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	GroupShowResponse
400	Bad Request	None
401	Unauthorized	None
409	Conflict	None

Example HTTP request

Request path

/v1/groups

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.2"

Request body

{
    "description": "Descriptions for group",
    "name": "TestGroup",
    "policy_ids": [
        "37f2e31ff86b415698d7e8eeafab445d"
    ],
    "tags": [
        {
            "key": "company",
            "value": "SDS"
        }
    ],
    "user_ids": [
        "f39c460fade34fecb05ede8f904b24b7"
    ]
}

Example HTTP response

Response 201

{
    "group": {
        "created_at": "2024-05-17T00:23:17Z",
        "created_by": "ef50cdc207f05f6fb8f20219f229ed1f",
        "creator_email": "samsung.kim@samsung.com",
        "creator_name": "Kim Samsung",
        "description": "Descriptions for group",
        "domain_name": "scp",
        "id": "f39c460fade34fecb05ede8f904b24b7",
        "members": [
            {
                "created_at": "2024-05-17T00:23:17Z",
                "created_by": "ef50cdc207f05f6fb8f20219f229ed1f",
                "creator_created_at": "2024-05-17T00:23:17Z",
                "creator_email": "samsung.kim@samsung.com",
                "creator_last_login_at": "2024-05-17T00:23:17Z",
                "creator_name": "Kim Samsung",
                "group_names": [
                    "TestGroup",
                    "SampleGroup"
                ],
                "user_created_at": "2024-05-17T00:23:17Z",
                "user_email": "samsung.kim@samsung.com",
                "user_id": "f39c460fade34fecb05ede8f904b24b7",
                "user_last_login_at": "2024-05-17T00:23:17Z",
                "user_name": "Kim Samsung"
            }
        ],
        "modified_at": "2024-05-17T00:23:17Z",
        "modified_by": "ef50cdc207f05f6fb8f20219f229ed1f",
        "modifier_email": "samsung.kim@samsung.com",
        "modifier_name": "Kim Samsung",
        "name": "TestGroup",
        "policies": [],
        "resource_type": "group",
        "roles": [],
        "service_name": "Identity Access Management",
        "service_type": "iam",
        "srn": "srn:dev1:::::iam:group/0e0688b33641451a83d2ab8878666fda",
        "type": "USER_DEFINED"
    }
}

1.6.2 - 1.1

post /v1/groups

Description

Create a group

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
body	body required		GroupCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	GroupShowResponse
400	Bad Request	None
401	Unauthorized	None
409	Conflict	None

Example HTTP request

Request path

/v1/groups

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.1"

Request body

{
    "description": "Descriptions for group",
    "name": "TestGroup",
    "policy_ids": [
        "37f2e31ff86b415698d7e8eeafab445d"
    ],
    "tags": [
        {
            "key": "company",
            "value": "SDS"
        }
    ],
    "user_ids": [
        "f39c460fade34fecb05ede8f904b24b7"
    ]
}

Example HTTP response

Response 201

{
    "group": {
        "created_at": "2024-05-17T00:23:17Z",
        "created_by": "ef50cdc207f05f6fb8f20219f229ed1f",
        "creator_email": "samsung.kim@samsung.com",
        "creator_name": "Kim Samsung",
        "description": "Descriptions for group",
        "domain_name": "scp",
        "id": "f39c460fade34fecb05ede8f904b24b7",
        "members": [
            {
                "created_at": "2024-05-17T00:23:17Z",
                "created_by": "ef50cdc207f05f6fb8f20219f229ed1f",
                "creator_created_at": "2024-05-17T00:23:17Z",
                "creator_email": "samsung.kim@samsung.com",
                "creator_last_login_at": "2024-05-17T00:23:17Z",
                "creator_name": "Kim Samsung",
                "group_names": [
                    "TestGroup",
                    "SampleGroup"
                ],
                "user_created_at": "2024-05-17T00:23:17Z",
                "user_email": "samsung.kim@samsung.com",
                "user_id": "f39c460fade34fecb05ede8f904b24b7",
                "user_last_login_at": "2024-05-17T00:23:17Z",
                "user_name": "Kim Samsung"
            }
        ],
        "modified_at": "2024-05-17T00:23:17Z",
        "modified_by": "ef50cdc207f05f6fb8f20219f229ed1f",
        "modifier_email": "samsung.kim@samsung.com",
        "modifier_name": "Kim Samsung",
        "name": "TestGroup",
        "policies": [],
        "resource_type": "group",
        "roles": [],
        "service_name": "Identity Access Management",
        "service_type": "iam",
        "srn": "srn:dev1:::::iam:group/0e0688b33641451a83d2ab8878666fda",
        "type": "USER_DEFINED"
    }
}

1.6.3 - 1.0

post /v1/groups

Description

Create a group

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
body	body required		GroupCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	GroupShowResponse
400	Bad Request	None
401	Unauthorized	None
409	Conflict	None

Example HTTP request

Request path

/v1/groups

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"

Request body

{
    "description": "Descriptions for group",
    "name": "TestGroup",
    "policy_ids": [
        "37f2e31ff86b415698d7e8eeafab445d"
    ],
    "tags": [
        {
            "key": "company",
            "value": "SDS"
        }
    ],
    "user_ids": [
        "f39c460fade34fecb05ede8f904b24b7"
    ]
}

Example HTTP response

Response 201

{
    "group": {
        "created_at": "2024-05-17T00:23:17Z",
        "created_by": "ef50cdc207f05f6fb8f20219f229ed1f",
        "creator_email": "samsung.kim@samsung.com",
        "creator_name": "Kim Samsung",
        "description": "Descriptions for group",
        "domain_name": "scp",
        "id": "f39c460fade34fecb05ede8f904b24b7",
        "members": [
            {
                "created_at": "2024-05-17T00:23:17Z",
                "created_by": "ef50cdc207f05f6fb8f20219f229ed1f",
                "creator_created_at": "2024-05-17T00:23:17Z",
                "creator_email": "samsung.kim@samsung.com",
                "creator_last_login_at": "2024-05-17T00:23:17Z",
                "creator_name": "Kim Samsung",
                "group_names": [
                    "TestGroup",
                    "SampleGroup"
                ],
                "user_created_at": "2024-05-17T00:23:17Z",
                "user_email": "samsung.kim@samsung.com",
                "user_id": "f39c460fade34fecb05ede8f904b24b7",
                "user_last_login_at": "2024-05-17T00:23:17Z",
                "user_name": "Kim Samsung"
            }
        ],
        "modified_at": "2024-05-17T00:23:17Z",
        "modified_by": "ef50cdc207f05f6fb8f20219f229ed1f",
        "modifier_email": "samsung.kim@samsung.com",
        "modifier_name": "Kim Samsung",
        "name": "TestGroup",
        "policies": [],
        "resource_type": "group",
        "roles": [],
        "service_name": "Identity Access Management",
        "service_type": "iam",
        "srn": "srn:dev1:::::iam:group/0e0688b33641451a83d2ab8878666fda",
        "type": "USER_DEFINED"
    }
}

1.7 - Create a policy

1.7.1 - 1.2

post /v1/policies

Description

Create a policy

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
body	body required		PolicyCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	PolicyShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
409	Conflict	None

Example HTTP request

Request path

/v1/policies

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.2"

Request body

{
    "default_version_id": "c1b1fc611eb34eccbccfb563f77395ee",
    "description": "Descriptions for policy",
    "policy_category": "IDENTITY_BASED",
    "policy_name": "PolicyName",
    "policy_type": "USER_DEFINED",
    "policy_version": {
        "policy_document": {
            "Statement": [
                {
                    "Action": [
                        "iam:*"
                    ],
                    "Condition": {
                        "StringEquals": {
                            "scp:RequestedRegion": [
                                "kr-west1"
                            ]
                        }
                    },
                    "Effect": "Allow",
                    "Principal": null,
                    "Resource": [
                        "*"
                    ],
                    "Sid": "Statement1"
                }
            ],
            "Version": "2024-07-01"
        },
        "policy_id": "37f2e31ff86b415698d7e8eeafab445d",
        "policy_version_id": "c1b1fc611eb34eccbccfb563f77395ee",
        "policy_version_name": "PolicyVersion-1"
    },
    "service_type": "scp-iam",
    "tags": [
        {
            "key": "foo",
            "value": "bar"
        }
    ]
}

Example HTTP response

Response 201

{
    "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"
}

1.7.2 - 1.1

post /v1/policies

Description

Create a policy

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
body	body required		PolicyCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	PolicyShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
409	Conflict	None

Example HTTP request

Request path

/v1/policies

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.1"

Request body

{
    "default_version_id": "c1b1fc611eb34eccbccfb563f77395ee",
    "description": "Descriptions for policy",
    "policy_category": "IDENTITY_BASED",
    "policy_name": "PolicyName",
    "policy_type": "USER_DEFINED",
    "policy_version": {
        "policy_document": {
            "Statement": [
                {
                    "Action": [
                        "iam:*"
                    ],
                    "Condition": {
                        "StringEquals": {
                            "scp:RequestedRegion": [
                                "kr-west1"
                            ]
                        }
                    },
                    "Effect": "Allow",
                    "Principal": null,
                    "Resource": [
                        "*"
                    ],
                    "Sid": "Statement1"
                }
            ],
            "Version": "2024-07-01"
        },
        "policy_id": "37f2e31ff86b415698d7e8eeafab445d",
        "policy_version_id": "c1b1fc611eb34eccbccfb563f77395ee",
        "policy_version_name": "PolicyVersion-1"
    },
    "service_type": "scp-iam",
    "tags": [
        {
            "key": "foo",
            "value": "bar"
        }
    ]
}

Example HTTP response

Response 201

{
    "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"
}

1.7.3 - 1.0

post /v1/policies

Description

Create a policy

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
body	body required		PolicyCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	PolicyShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
409	Conflict	None

Example HTTP request

Request path

/v1/policies

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"

Request body

{
    "default_version_id": "c1b1fc611eb34eccbccfb563f77395ee",
    "description": "Descriptions for policy",
    "policy_category": "IDENTITY_BASED",
    "policy_name": "PolicyName",
    "policy_type": "USER_DEFINED",
    "policy_version": {
        "policy_document": {
            "Statement": [
                {
                    "Action": [
                        "iam:*"
                    ],
                    "Condition": {
                        "StringEquals": {
                            "scp:RequestedRegion": [
                                "kr-west1"
                            ]
                        }
                    },
                    "Effect": "Allow",
                    "Principal": null,
                    "Resource": [
                        "*"
                    ],
                    "Sid": "Statement1"
                }
            ],
            "Version": "2024-07-01"
        },
        "policy_id": "37f2e31ff86b415698d7e8eeafab445d",
        "policy_version_id": "c1b1fc611eb34eccbccfb563f77395ee",
        "policy_version_name": "PolicyVersion-1"
    },
    "service_type": "scp-iam",
    "tags": [
        {
            "key": "foo",
            "value": "bar"
        }
    ]
}

Example HTTP response

Response 201

{
    "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"
}

1.8 - Create a saml provider

1.8.1 - 1.2

post /v1/saml-providers

Description

Create a saml provider

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
body	body required		SamlProviderCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	SamlProviderCreateResponse
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/saml-providers

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.2,"
"Content-Type = multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW"

Request body

------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="description"

SAML provider Description
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="federation_type"

SAML
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="file"; filename="keycloak-idp-saml.xml"
Content-Type: application/xml

(data)
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="saml_provider_name"

IdpTest
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="tags"

[{'key': 'company', 'value': 'SDS'}]
------WebKitFormBoundary7MA4YWxkTrZu0gW--

Example HTTP response

Response 201

{
    "account_id": "",
    "acs_url": "",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "creator_name": "",
    "description": "",
    "federation_type": "",
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "idp_cert_end": "",
    "idp_file_name": "",
    "idp_file_size": "",
    "idp_issuer_url": "",
    "idp_sso_url": "",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "modifier_name": "",
    "saml_provider_name": ""
}

1.8.2 - 1.1

post /v1/saml-providers

Description

Create a saml provider

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
body	body required		SamlProviderCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	SamlProviderCreateResponse
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/saml-providers

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.1,"
"Content-Type = multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW"

Request body

------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="description"

SAML provider Description
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="federation_type"

SAML
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="file"; filename="keycloak-idp-saml.xml"
Content-Type: application/xml

(data)
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="saml_provider_name"

IdpTest
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="tags"

[{'key': 'company', 'value': 'SDS'}]
------WebKitFormBoundary7MA4YWxkTrZu0gW--

Example HTTP response

Response 201

{
    "account_id": "",
    "acs_url": "",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "creator_name": "",
    "description": "",
    "federation_type": "",
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "idp_cert_end": "",
    "idp_file_name": "",
    "idp_file_size": "",
    "idp_issuer_url": "",
    "idp_sso_url": "",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "modifier_name": "",
    "saml_provider_name": ""
}

1.8.3 - 1.0

post /v1/saml-providers

Description

Create a saml provider

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
body	body required		SamlProviderCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	SamlProviderCreateResponse
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/saml-providers

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,"
"Content-Type = multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW"

Request body

------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="description"

SAML provider Description
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="federation_type"

SAML
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="file"; filename="keycloak-idp-saml.xml"
Content-Type: application/xml

(data)
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="saml_provider_name"

IdpTest
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="tags"

[{'key': 'company', 'value': 'SDS'}]
------WebKitFormBoundary7MA4YWxkTrZu0gW--

Example HTTP response

Response 201

{
    "account_id": "",
    "acs_url": "",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "creator_name": "",
    "description": "",
    "federation_type": "",
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "idp_cert_end": "",
    "idp_file_name": "",
    "idp_file_size": "",
    "idp_issuer_url": "",
    "idp_sso_url": "",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "modifier_name": "",
    "saml_provider_name": ""
}

1.9 - Create an access key

1.9.1 - 1.2

post /v1/access-keys

Description

Create an access key

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
body	body required		AccessKeyCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	AccessKeyResponse
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/access-keys

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.2"

Request body

{
    "access_key_type": "PERMANENT",
    "account_id": "f39c460fade34fecb05ede8f904b24b7",
    "description": "description",
    "duration": "P1Y2M10DT2H30M15S",
    "parent_access_key_id": "92d6eid9e9ae4f868s842910k11573a3",
    "passcode": "000000"
}

Example HTTP response

Response 201

{
    "access_key": {
        "access_key": "b754b12b39da4ce29a40c5e324650bd0",
        "access_key_type": "PERMANENT",
        "account_id": "f39c460fade34fecb05ede8f904b24b7",
        "created_at": "2024-05-17T00:23:17Z",
        "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "description": "description",
        "expiration_timestamp": "9999-12-31T23:59:59Z",
        "id": "6558fc9df5b54c8a985465bdf637e097",
        "is_enabled": "true",
        "modified_at": "2024-05-17T00:23:17Z",
        "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "parent_access_key_id": "92d6eid9e9ae4f868s842910k11573a3",
        "secret_key": "c4150149-f7c6-46bc-9faa-d2b9d20e0899"
    }
}

1.9.2 - 1.1

post /v1/access-keys

Description

Create an access key

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
body	body required		AccessKeyCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	AccessKeyResponse
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/access-keys

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.1"

Request body

{
    "access_key_type": "PERMANENT",
    "account_id": "f39c460fade34fecb05ede8f904b24b7",
    "description": "description",
    "duration": "P1Y2M10DT2H30M15S",
    "parent_access_key_id": "92d6eid9e9ae4f868s842910k11573a3",
    "passcode": "000000"
}

Example HTTP response

Response 201

{
    "access_key": {
        "access_key": "b754b12b39da4ce29a40c5e324650bd0",
        "access_key_type": "PERMANENT",
        "account_id": "f39c460fade34fecb05ede8f904b24b7",
        "created_at": "2024-05-17T00:23:17Z",
        "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "description": "description",
        "expiration_timestamp": "9999-12-31T23:59:59Z",
        "id": "6558fc9df5b54c8a985465bdf637e097",
        "is_enabled": "true",
        "modified_at": "2024-05-17T00:23:17Z",
        "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "parent_access_key_id": "92d6eid9e9ae4f868s842910k11573a3",
        "secret_key": "c4150149-f7c6-46bc-9faa-d2b9d20e0899"
    }
}

1.9.3 - 1.0

post /v1/access-keys

Description

Create an access key

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
body	body required		AccessKeyCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	AccessKeyResponse
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/access-keys

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"

Request body

{
    "access_key_type": "PERMANENT",
    "account_id": "f39c460fade34fecb05ede8f904b24b7",
    "description": "description",
    "duration": "P1Y2M10DT2H30M15S",
    "parent_access_key_id": "92d6eid9e9ae4f868s842910k11573a3",
    "passcode": "000000"
}

Example HTTP response

Response 201

{
    "access_key": {
        "access_key": "b754b12b39da4ce29a40c5e324650bd0",
        "access_key_type": "PERMANENT",
        "account_id": "f39c460fade34fecb05ede8f904b24b7",
        "created_at": "2024-05-17T00:23:17Z",
        "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "description": "description",
        "expiration_timestamp": "9999-12-31T23:59:59Z",
        "id": "6558fc9df5b54c8a985465bdf637e097",
        "is_enabled": "true",
        "modified_at": "2024-05-17T00:23:17Z",
        "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "parent_access_key_id": "92d6eid9e9ae4f868s842910k11573a3",
        "secret_key": "c4150149-f7c6-46bc-9faa-d2b9d20e0899"
    }
}

1.10 - Create IAM user

1.10.1 - 1.2

post /v1/accounts/{account_id}/users

Description

Create IAM user

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	account_id required	Account ID Example :	string	None
body	body required		IAMUserCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	IAMCreateUserResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/accounts/{account_id}/users

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.2"

Request body

{
    "description": "",
    "group_ids": [
        ""
    ],
    "password": "",
    "policy_ids": [
        ""
    ],
    "tags": [
        ""
    ],
    "temporary_password": "",
    "user_name": ""
}

Example HTTP response

Response 201

{
    "account_id": "",
    "company_name": "",
    "console_url": "",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "description": "",
    "dst_offset": "",
    "email": "",
    "email_authenticated": "",
    "first_name": "",
    "id": "",
    "last_login_at": "",
    "last_name": "",
    "last_password_update_at": "",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "",
    "password": "",
    "password_reuse_count": "",
    "phone_authenticated": "",
    "policies": [],
    "state": "",
    "timezone": "",
    "type": "",
    "tz_id": "",
    "user_name": "",
    "utc_offset": ""
}

1.10.2 - 1.1

post /v1/accounts/{account_id}/users

Description

Create IAM user

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	account_id required	Account ID Example :	string	None
body	body required		IAMUserCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	IAMCreateUserResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/accounts/{account_id}/users

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.1"

Request body

{
    "description": "",
    "group_ids": [
        ""
    ],
    "password": "",
    "policy_ids": [
        ""
    ],
    "tags": [
        ""
    ],
    "temporary_password": "",
    "user_name": ""
}

Example HTTP response

Response 201

{
    "account_id": "",
    "company_name": "",
    "console_url": "",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "description": "",
    "dst_offset": "",
    "email": "",
    "email_authenticated": "",
    "first_name": "",
    "id": "",
    "last_login_at": "",
    "last_name": "",
    "last_password_update_at": "",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "",
    "password": "",
    "password_reuse_count": "",
    "phone_authenticated": "",
    "policies": [],
    "state": "",
    "timezone": "",
    "type": "",
    "tz_id": "",
    "user_name": "",
    "utc_offset": ""
}

1.10.3 - 1.0

post /v1/accounts/{account_id}/users

Description

Create IAM user

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	account_id required	Account ID Example :	string	None
body	body required		IAMUserCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	IAMCreateUserResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/accounts/{account_id}/users

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"

Request body

{
    "description": "",
    "group_ids": [
        ""
    ],
    "password": "",
    "policy_ids": [
        ""
    ],
    "tags": [
        ""
    ],
    "temporary_password": "",
    "user_name": ""
}

Example HTTP response

Response 201

{
    "account_id": "",
    "company_name": "",
    "console_url": "",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "description": "",
    "dst_offset": "",
    "email": "",
    "email_authenticated": "",
    "first_name": "",
    "id": "",
    "last_login_at": "",
    "last_name": "",
    "last_password_update_at": "",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "",
    "password": "",
    "password_reuse_count": "",
    "phone_authenticated": "",
    "policies": [],
    "state": "",
    "timezone": "",
    "type": "",
    "tz_id": "",
    "user_name": "",
    "utc_offset": ""
}

1.11 - Create role

1.11.1 - 1.2

post /v1/roles

Description

Create role

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
body	body required		RoleCreateRequest

Responses

HTTP Code	Description	Schema
202	Accepted	RoleShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None
409	Conflict	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.2"

Request body

{
    "account_id": "",
    "assume_role_policy_document": {
        "Statement": [
            {
                "Action": [
                    "sts:AssumeRole"
                ],
                "Condition": {},
                "Effect": "Allow",
                "Principal": "srn:e:1234:::iam:user/abc1234",
                "Resource": [],
                "Sid": "statement1"
            }
        ],
        "Version": "2024-07-01"
    },
    "description": "",
    "max_session_duration": 3600,
    "name": "",
    "policy_ids": [
        "37f2e31ff86b415698d7e8eeafab445d"
    ],
    "principals": [
        {
            "type": "SRN",
            "value": "srn:e:1234:::iam:user/abc1234"
        }
    ],
    "tags": [
        {
            "key": "company",
            "value": "SDS"
        }
    ]
}

Example HTTP response

Response 202

{
    "role": {
        "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"
    }
}

1.11.2 - 1.1

post /v1/roles

Description

Create role

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
body	body required		RoleCreateRequest

Responses

HTTP Code	Description	Schema
202	Accepted	RoleShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None
409	Conflict	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.1"

Request body

{
    "account_id": "",
    "assume_role_policy_document": {
        "Statement": [
            {
                "Action": [
                    "sts:AssumeRole"
                ],
                "Condition": {},
                "Effect": "Allow",
                "Principal": "srn:e:1234:::iam:user/abc1234",
                "Resource": [],
                "Sid": "statement1"
            }
        ],
        "Version": "2024-07-01"
    },
    "description": "",
    "max_session_duration": 3600,
    "name": "",
    "policy_ids": [
        "37f2e31ff86b415698d7e8eeafab445d"
    ],
    "principals": [
        {
            "type": "SRN",
            "value": "srn:e:1234:::iam:user/abc1234"
        }
    ],
    "tags": [
        {
            "key": "company",
            "value": "SDS"
        }
    ]
}

Example HTTP response

Response 202

{
    "role": {
        "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"
    }
}

1.11.3 - 1.0

post /v1/roles

Description

Create role

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
body	body required		RoleCreateRequest

Responses

HTTP Code	Description	Schema
202	Accepted	RoleShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None
409	Conflict	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"

Request body

{
    "account_id": "",
    "assume_role_policy_document": {
        "Statement": [
            {
                "Action": [
                    "sts:AssumeRole"
                ],
                "Condition": {},
                "Effect": "Allow",
                "Principal": "srn:e:1234:::iam:user/abc1234",
                "Resource": [],
                "Sid": "statement1"
            }
        ],
        "Version": "2024-07-01"
    },
    "description": "",
    "max_session_duration": 3600,
    "name": "",
    "policy_ids": [
        "37f2e31ff86b415698d7e8eeafab445d"
    ],
    "principals": [
        {
            "type": "SRN",
            "value": "srn:e:1234:::iam:user/abc1234"
        }
    ],
    "tags": [
        {
            "key": "company",
            "value": "SDS"
        }
    ]
}

Example HTTP response

Response 202

{
    "role": {
        "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"
    }
}

1.12 - Delete bulk role

1.12.1 - 1.2

delete /v1/roles/bulk

Description

Delete bulk role

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
body	body required		RoleBulkDeleteRequest

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/roles/bulk

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.2"

Request body

{
    "account_id": "",
    "role_ids": [
        ""
    ],
    "role_names": [
        ""
    ]
}

Example HTTP response

Response 204

1.12.2 - 1.1

delete /v1/roles/bulk

Description

Delete bulk role

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
body	body required		RoleBulkDeleteRequest

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/roles/bulk

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.1"

Request body

{
    "account_id": "",
    "role_ids": [
        ""
    ],
    "role_names": [
        ""
    ]
}

Example HTTP response

Response 204

1.12.3 - 1.0

delete /v1/roles/bulk

Description

Delete bulk role

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
body	body required		RoleBulkDeleteRequest

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/roles/bulk

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"

Request body

{
    "account_id": "",
    "role_ids": [
        ""
    ],
    "role_names": [
        ""
    ]
}

Example HTTP response

Response 204

1.13 - Delete IAM user

1.13.1 - 1.2

delete /v1/accounts/{account_id}/users/{user_id}

Description

Delete IAM user

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	account_id required	Account ID Example :	string	None
path	user_id required	User ID Example :	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/accounts/{account_id}/users/{user_id}

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.2"

Example HTTP response

Response 204

1.13.2 - 1.1

delete /v1/accounts/{account_id}/users/{user_id}

Description

Delete IAM user

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	account_id required	Account ID Example :	string	None
path	user_id required	User ID Example :	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/accounts/{account_id}/users/{user_id}

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.1"

Example HTTP response

Response 204

1.14 - Delete IAM users

1.14.1 - 1.2

delete /v1/accounts/{account_id}/users/bulk

Description

Delete IAM users

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	account_id required	Account ID Example :	string	None
body	body required		IAMUserDeleteRequest

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/accounts/{account_id}/users/bulk

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.2"

Request body

{
    "user_ids": [
        ""
    ]
}

Example HTTP response

Response 204

1.14.2 - 1.1

delete /v1/accounts/{account_id}/users/bulk

Description

Delete IAM users

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	account_id required	Account ID Example :	string	None
body	body required		IAMUserDeleteRequest

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/accounts/{account_id}/users/bulk

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.1"

Request body

{
    "user_ids": [
        ""
    ]
}

Example HTTP response

Response 204

1.14.3 - 1.0

delete /v1/accounts/{account_id}/users/bulk

Description

Delete IAM users

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	account_id required	Account ID Example :	string	None
body	body required		IAMUserDeleteRequest

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/accounts/{account_id}/users/bulk

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"

Request body

{
    "user_ids": [
        ""
    ]
}

Example HTTP response

Response 204

1.15 - Delete role

1.15.1 - 1.2

delete /v1/roles/{role_id}

Description

Delete role

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	role_id required	역할 ID Example :	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/roles/{role_id}

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.2"

Example HTTP response

Response 204

1.15.2 - 1.1

delete /v1/roles/{role_id}

Description

Delete role

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	role_id required	역할 ID Example :	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/roles/{role_id}

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.1"

Example HTTP response

Response 204

1.15.3 - 1.0

delete /v1/roles/{role_id}

Description

Delete role

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	role_id required	역할 ID Example :	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/roles/{role_id}

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 204

1.16 - Delete the policy

1.16.1 - 1.2

delete /v1/policies/{policy_id}

Description

Delete the policy

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	policy_id required	Policy ID Example : `37f2e31ff86b415698d7e8eeafab445d`	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/policies/{policy_id}

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.2"

Example HTTP response

Response 204

1.16.2 - 1.1

delete /v1/policies/{policy_id}

Description

Delete the policy

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	policy_id required	Policy ID Example : `37f2e31ff86b415698d7e8eeafab445d`	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/policies/{policy_id}

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.1"

Example HTTP response

Response 204

1.16.3 - 1.0

delete /v1/policies/{policy_id}

Description

Delete the policy

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	policy_id required	Policy ID Example : `37f2e31ff86b415698d7e8eeafab445d`	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/policies/{policy_id}

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 204

1.17 - Delete the resource based policy

1.17.1 - 1.2

delete /v1/resource-policies/{srn}

Description

Delete the resource based policy

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	srn required	삼성 리소스 자원명 Example : `c3JuOmRldjI6OjEyMzQ1Njc4OTAxMDIzNDU2OTA6a3Itd2VzdDE6OnZpcnR1YWxzZXJ2ZXI6dmlydHVhbC1zZXJ2ZXIvYWJjZGUtMTIzNC01NTU1LTY2NjY=`	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/resource-policies/{srn}

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.2"

Example HTTP response

Response 204

1.17.2 - 1.1

delete /v1/resource-policies/{srn}

Description

Delete the resource based policy

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	srn required	삼성 리소스 자원명 Example : `c3JuOmRldjI6OjEyMzQ1Njc4OTAxMDIzNDU2OTA6a3Itd2VzdDE6OnZpcnR1YWxzZXJ2ZXI6dmlydHVhbC1zZXJ2ZXIvYWJjZGUtMTIzNC01NTU1LTY2NjY=`	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/resource-policies/{srn}

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.1"

Example HTTP response

Response 204

1.17.3 - 1.0

delete /v1/resource-policies/{srn}

Description

Delete the resource based policy

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	srn required	삼성 리소스 자원명 Example : `c3JuOmRldjI6OjEyMzQ1Njc4OTAxMDIzNDU2OTA6a3Itd2VzdDE6OnZpcnR1YWxzZXJ2ZXI6dmlydHVhbC1zZXJ2ZXIvYWJjZGUtMTIzNC01NTU1LTY2NjY=`	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/resource-policies/{srn}

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 204

1.18 - Delete user policy

1.18.1 - 1.2

delete /v1/users/{user_id}/policy-bindings/{policy_id}

Description

Delete user policy

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	user_id required	사용자 ID Example :	string	None
path	policy_id required	Policy ID Example :	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/users/{user_id}/policy-bindings/{policy_id}

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.2"

Example HTTP response

Response 204

1.18.2 - 1.1

delete /v1/users/{user_id}/policy-bindings/{policy_id}

Description

Delete user policy

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	user_id required	사용자 ID Example :	string	None
path	policy_id required	Policy ID Example :	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/users/{user_id}/policy-bindings/{policy_id}

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.1"

Example HTTP response

Response 204

1.18.3 - 1.0

delete /v1/users/{user_id}/policy-bindings/{policy_id}

Description

Delete user policy

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	user_id required	사용자 ID Example :	string	None
path	policy_id required	Policy ID Example :	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/users/{user_id}/policy-bindings/{policy_id}

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 204

1.19 - Detach policies to Role

1.19.1 - 1.2

delete /v1/roles/{role_id}/policy-bindings

Description

Detach policies to Role

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	role_id required	역할 ID Example :	string	None
body	body required		RolePolicyBindingRequest

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/roles/{role_id}/policy-bindings

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.2"

Request body

{
    "policy_ids": [
        ""
    ]
}

Example HTTP response

Response 204

1.19.2 - 1.1

delete /v1/roles/{role_id}/policy-bindings

Description

Detach policies to Role

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	role_id required	역할 ID Example :	string	None
body	body required		RolePolicyBindingRequest

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/roles/{role_id}/policy-bindings

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.1"

Request body

{
    "policy_ids": [
        ""
    ]
}

Example HTTP response

Response 204

1.19.3 - 1.0

delete /v1/roles/{role_id}/policy-bindings

Description

Detach policies to Role

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	role_id required	역할 ID Example :	string	None
body	body required		RolePolicyBindingRequest

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/roles/{role_id}/policy-bindings

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"

Request body

{
    "policy_ids": [
        ""
    ]
}

Example HTTP response

Response 204

1.20 - Detach policy to Role

1.20.1 - 1.2

delete /v1/roles/{role_id}/policy-bindings/{policy_id}

Description

Detach policy to Role

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	role_id required	역할 ID Example :	string	None
path	policy_id required	역할에 연결된 정책 ID Example :	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/roles/{role_id}/policy-bindings/{policy_id}

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.2"

Example HTTP response

Response 204

1.20.2 - 1.1

delete /v1/roles/{role_id}/policy-bindings/{policy_id}

Description

Detach policy to Role

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	role_id required	역할 ID Example :	string	None
path	policy_id required	역할에 연결된 정책 ID Example :	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/roles/{role_id}/policy-bindings/{policy_id}

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.1"

Example HTTP response

Response 204

1.20.3 - 1.0

delete /v1/roles/{role_id}/policy-bindings/{policy_id}

Description

Detach policy to Role

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	role_id required	역할 ID Example :	string	None
path	policy_id required	역할에 연결된 정책 ID Example :	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/roles/{role_id}/policy-bindings/{policy_id}

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 204

1.21 - Get a Group

1.21.1 - 1.2

get /v1/groups/{group_id}

Description

Get a Group

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	group_id required	Group ID Example : `a946662dc4314dac93da413a32457459`	string	None

Responses

HTTP Code	Description	Schema
200	OK	GroupShowResponse
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/groups/{group_id}

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.2"

Example HTTP response

Response 200

{
    "group": {
        "created_at": "2024-05-17T00:23:17Z",
        "created_by": "ef50cdc207f05f6fb8f20219f229ed1f",
        "creator_email": "samsung.kim@samsung.com",
        "creator_name": "Kim Samsung",
        "description": "Descriptions for group",
        "domain_name": "scp",
        "id": "f39c460fade34fecb05ede8f904b24b7",
        "members": [
            {
                "created_at": "2024-05-17T00:23:17Z",
                "created_by": "ef50cdc207f05f6fb8f20219f229ed1f",
                "creator_created_at": "2024-05-17T00:23:17Z",
                "creator_email": "samsung.kim@samsung.com",
                "creator_last_login_at": "2024-05-17T00:23:17Z",
                "creator_name": "Kim Samsung",
                "group_names": [
                    "TestGroup",
                    "SampleGroup"
                ],
                "user_created_at": "2024-05-17T00:23:17Z",
                "user_email": "samsung.kim@samsung.com",
                "user_id": "f39c460fade34fecb05ede8f904b24b7",
                "user_last_login_at": "2024-05-17T00:23:17Z",
                "user_name": "Kim Samsung"
            }
        ],
        "modified_at": "2024-05-17T00:23:17Z",
        "modified_by": "ef50cdc207f05f6fb8f20219f229ed1f",
        "modifier_email": "samsung.kim@samsung.com",
        "modifier_name": "Kim Samsung",
        "name": "TestGroup",
        "policies": [],
        "resource_type": "group",
        "roles": [],
        "service_name": "Identity Access Management",
        "service_type": "iam",
        "srn": "srn:dev1:::::iam:group/0e0688b33641451a83d2ab8878666fda",
        "type": "USER_DEFINED"
    }
}

1.21.2 - 1.1

get /v1/groups/{group_id}

Description

Get a Group

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	group_id required	Group ID Example : `a946662dc4314dac93da413a32457459`	string	None

Responses

HTTP Code	Description	Schema
200	OK	GroupShowResponse
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/groups/{group_id}

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.1"

Example HTTP response

Response 200

{
    "group": {
        "created_at": "2024-05-17T00:23:17Z",
        "created_by": "ef50cdc207f05f6fb8f20219f229ed1f",
        "creator_email": "samsung.kim@samsung.com",
        "creator_name": "Kim Samsung",
        "description": "Descriptions for group",
        "domain_name": "scp",
        "id": "f39c460fade34fecb05ede8f904b24b7",
        "members": [
            {
                "created_at": "2024-05-17T00:23:17Z",
                "created_by": "ef50cdc207f05f6fb8f20219f229ed1f",
                "creator_created_at": "2024-05-17T00:23:17Z",
                "creator_email": "samsung.kim@samsung.com",
                "creator_last_login_at": "2024-05-17T00:23:17Z",
                "creator_name": "Kim Samsung",
                "group_names": [
                    "TestGroup",
                    "SampleGroup"
                ],
                "user_created_at": "2024-05-17T00:23:17Z",
                "user_email": "samsung.kim@samsung.com",
                "user_id": "f39c460fade34fecb05ede8f904b24b7",
                "user_last_login_at": "2024-05-17T00:23:17Z",
                "user_name": "Kim Samsung"
            }
        ],
        "modified_at": "2024-05-17T00:23:17Z",
        "modified_by": "ef50cdc207f05f6fb8f20219f229ed1f",
        "modifier_email": "samsung.kim@samsung.com",
        "modifier_name": "Kim Samsung",
        "name": "TestGroup",
        "policies": [],
        "resource_type": "group",
        "roles": [],
        "service_name": "Identity Access Management",
        "service_type": "iam",
        "srn": "srn:dev1:::::iam:group/0e0688b33641451a83d2ab8878666fda",
        "type": "USER_DEFINED"
    }
}

1.21.3 - 1.0

get /v1/groups/{group_id}

Description

Get a Group

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	group_id required	Group ID Example : `a946662dc4314dac93da413a32457459`	string	None

Responses

HTTP Code	Description	Schema
200	OK	GroupShowResponse
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/groups/{group_id}

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

{
    "group": {
        "created_at": "2024-05-17T00:23:17Z",
        "created_by": "ef50cdc207f05f6fb8f20219f229ed1f",
        "creator_email": "samsung.kim@samsung.com",
        "creator_name": "Kim Samsung",
        "description": "Descriptions for group",
        "domain_name": "scp",
        "id": "f39c460fade34fecb05ede8f904b24b7",
        "members": [
            {
                "created_at": "2024-05-17T00:23:17Z",
                "created_by": "ef50cdc207f05f6fb8f20219f229ed1f",
                "creator_created_at": "2024-05-17T00:23:17Z",
                "creator_email": "samsung.kim@samsung.com",
                "creator_last_login_at": "2024-05-17T00:23:17Z",
                "creator_name": "Kim Samsung",
                "group_names": [
                    "TestGroup",
                    "SampleGroup"
                ],
                "user_created_at": "2024-05-17T00:23:17Z",
                "user_email": "samsung.kim@samsung.com",
                "user_id": "f39c460fade34fecb05ede8f904b24b7",
                "user_last_login_at": "2024-05-17T00:23:17Z",
                "user_name": "Kim Samsung"
            }
        ],
        "modified_at": "2024-05-17T00:23:17Z",
        "modified_by": "ef50cdc207f05f6fb8f20219f229ed1f",
        "modifier_email": "samsung.kim@samsung.com",
        "modifier_name": "Kim Samsung",
        "name": "TestGroup",
        "policies": [],
        "resource_type": "group",
        "roles": [],
        "service_name": "Identity Access Management",
        "service_type": "iam",
        "srn": "srn:dev1:::::iam:group/0e0688b33641451a83d2ab8878666fda",
        "type": "USER_DEFINED"
    }
}

1.22 - Get a specific policy binding list

1.22.1 - 1.2

get /v1/policies/{policy_id}/bindings

Description

Get a specific policy binding list

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	policy_id required	Policy ID Example : `37f2e31ff86b415698d7e8eeafab445d`	string	None
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	identity_id optional	Identity ID Example : `f39c460fade34fecb05ede8f904b24b7`	any of [string, null]	None
query	identity_type optional	Identity Type Example : `GROUP`	any of [string, null]	None
query	name optional	Name Example : `TestGroup`	any of [string, null]	None

Responses

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

Example HTTP request

Request path

/v1/policies/{policy_id}/bindings

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.2"

Example HTTP response

Response 200

{
    "count": 20,
    "groups": [
        {
            "created_at": "2025-03-26T10:18:04Z",
            "created_by": "4a816a3f5099442ebb52daefc1f7be32",
            "creator_email": "-",
            "creator_name": "-",
            "description": "openapi-ga2-test-group",
            "domain_name": "scp",
            "id": "19fca177a57940daa5817960373c6542",
            "modified_at": "2025-03-26T10:18:04Z",
            "modified_by": "4a816a3f5099442ebb52daefc1f7be32",
            "modifier_email": "-",
            "modifier_name": "-",
            "name": "openapi-ga2-testgroup5",
            "policies": [],
            "roles": [],
            "srn": "srn:dev2::1d9cc99917ff41bb992276ac0ae9e4c8:::iam:group/19fca177a57940daa5817960373c6542",
            "type": "USER_DEFINED"
        }
    ],
    "page": 0,
    "policy_id": "37f2e31ff86b415698d7e8eeafab445d",
    "roles": [
        {
            "account_id": "d7aba97100564b34a0f4f77c4bc7a303",
            "assume_role_policy_document": {
                "Statement": [
                    {
                        "Action": "*",
                        "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": "string",
            "id": "f39c460fade34fecb05ede8f904b24b7",
            "max_session_duration": 0,
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "ef50cdc207f05f6fb8f20219f229ed1f",
            "modifier_email": "-",
            "modifier_name": "-",
            "name": "string",
            "type": "DEFAULT"
        }
    ],
    "size": 20,
    "sort": [
        "created_at:asc"
    ],
    "users": [
        {
            "access_control": false,
            "account_id": "d7aba97100564b34a0f4f77c4bc7a303",
            "account_name": "",
            "allowed_ip_addresses": "",
            "company_name": "",
            "created_at": "2024-11-15T06:57:42.000000Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "description": "",
            "domain_name": "scp",
            "dst_offset": "+09:00",
            "email": "samsung.kim@samsung.com",
            "email_authenticate_code": "8ada8861bad2423295e4bb576bee5886",
            "email_authenticated": true,
            "first_name": "",
            "groups": [],
            "id": "90dddfc2b1e04edba54ba2b41539a9ac",
            "keycloak_id": "127e3d8c-66dc-4b1b-b38b-9a1d0c6d5507",
            "keystone_credential": "",
            "last_login_at": "2024-11-25T06:57:42.000000Z",
            "last_name": "",
            "last_password_update_at": "",
            "login_id": "",
            "modified_at": "2024-11-17T06:57:42.000000Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "nation_id": "+82",
            "phone_authenticated": false,
            "phone_number": "0000000000",
            "policies": [],
            "state": "ACTIVE",
            "temporary_password": false,
            "term_region_id": "1",
            "timezone": "Asia/Seoul",
            "type": "IAM",
            "tz_id": "Asia/Seoul",
            "user_name": "Kim Samsung",
            "utc_offset": "+09:00"
        }
    ]
}

1.22.2 - 1.1

get /v1/policies/{policy_id}/bindings

Description

Get a specific policy binding list

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	policy_id required	Policy ID Example : `37f2e31ff86b415698d7e8eeafab445d`	string	None
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	identity_id optional	Identity ID Example : `f39c460fade34fecb05ede8f904b24b7`	any of [string, null]	None
query	identity_type optional	Identity Type Example : `GROUP`	any of [string, null]	None
query	name optional	Name Example : `TestGroup`	any of [string, null]	None

Responses

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

Example HTTP request

Request path

/v1/policies/{policy_id}/bindings

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.1"

Example HTTP response

Response 200

{
    "count": 20,
    "groups": [
        {
            "created_at": "2025-03-26T10:18:04Z",
            "created_by": "4a816a3f5099442ebb52daefc1f7be32",
            "creator_email": "-",
            "creator_name": "-",
            "description": "openapi-ga2-test-group",
            "domain_name": "scp",
            "id": "19fca177a57940daa5817960373c6542",
            "modified_at": "2025-03-26T10:18:04Z",
            "modified_by": "4a816a3f5099442ebb52daefc1f7be32",
            "modifier_email": "-",
            "modifier_name": "-",
            "name": "openapi-ga2-testgroup5",
            "policies": [],
            "roles": [],
            "srn": "srn:dev2::1d9cc99917ff41bb992276ac0ae9e4c8:::iam:group/19fca177a57940daa5817960373c6542",
            "type": "USER_DEFINED"
        }
    ],
    "page": 0,
    "policy_id": "37f2e31ff86b415698d7e8eeafab445d",
    "roles": [
        {
            "account_id": "d7aba97100564b34a0f4f77c4bc7a303",
            "assume_role_policy_document": {
                "Statement": [
                    {
                        "Action": "*",
                        "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": "string",
            "id": "f39c460fade34fecb05ede8f904b24b7",
            "max_session_duration": 0,
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "ef50cdc207f05f6fb8f20219f229ed1f",
            "modifier_email": "-",
            "modifier_name": "-",
            "name": "string",
            "type": "DEFAULT"
        }
    ],
    "size": 20,
    "sort": [
        "created_at:asc"
    ],
    "users": [
        {
            "access_control": false,
            "account_id": "d7aba97100564b34a0f4f77c4bc7a303",
            "account_name": "",
            "allowed_ip_addresses": "",
            "company_name": "",
            "created_at": "2024-11-15T06:57:42.000000Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "description": "",
            "domain_name": "scp",
            "dst_offset": "+09:00",
            "email": "samsung.kim@samsung.com",
            "email_authenticate_code": "8ada8861bad2423295e4bb576bee5886",
            "email_authenticated": true,
            "first_name": "",
            "groups": [],
            "id": "90dddfc2b1e04edba54ba2b41539a9ac",
            "keycloak_id": "127e3d8c-66dc-4b1b-b38b-9a1d0c6d5507",
            "keystone_credential": "",
            "last_login_at": "2024-11-25T06:57:42.000000Z",
            "last_name": "",
            "last_password_update_at": "",
            "login_id": "",
            "modified_at": "2024-11-17T06:57:42.000000Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "nation_id": "+82",
            "phone_authenticated": false,
            "phone_number": "0000000000",
            "policies": [],
            "state": "ACTIVE",
            "temporary_password": false,
            "term_region_id": "1",
            "timezone": "Asia/Seoul",
            "type": "IAM",
            "tz_id": "Asia/Seoul",
            "user_name": "Kim Samsung",
            "utc_offset": "+09:00"
        }
    ]
}

1.22.3 - 1.0

get /v1/policies/{policy_id}/bindings

Description

Get a specific policy binding list

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	policy_id required	Policy ID Example : `37f2e31ff86b415698d7e8eeafab445d`	string	None
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	identity_id optional	Identity ID Example : `f39c460fade34fecb05ede8f904b24b7`	any of [string, null]	None
query	identity_type optional	Identity Type Example : `GROUP`	any of [string, null]	None
query	name optional	Name Example : `TestGroup`	any of [string, null]	None

Responses

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

Example HTTP request

Request path

/v1/policies/{policy_id}/bindings

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,
    "groups": [
        {
            "created_at": "2025-03-26T10:18:04Z",
            "created_by": "4a816a3f5099442ebb52daefc1f7be32",
            "creator_email": "-",
            "creator_name": "-",
            "description": "openapi-ga2-test-group",
            "domain_name": "scp",
            "id": "19fca177a57940daa5817960373c6542",
            "modified_at": "2025-03-26T10:18:04Z",
            "modified_by": "4a816a3f5099442ebb52daefc1f7be32",
            "modifier_email": "-",
            "modifier_name": "-",
            "name": "openapi-ga2-testgroup5",
            "policies": [],
            "roles": [],
            "srn": "srn:dev2::1d9cc99917ff41bb992276ac0ae9e4c8:::iam:group/19fca177a57940daa5817960373c6542",
            "type": "USER_DEFINED"
        }
    ],
    "page": 0,
    "policy_id": "37f2e31ff86b415698d7e8eeafab445d",
    "roles": [
        {
            "account_id": "d7aba97100564b34a0f4f77c4bc7a303",
            "assume_role_policy_document": {
                "Statement": [
                    {
                        "Action": "*",
                        "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": "string",
            "id": "f39c460fade34fecb05ede8f904b24b7",
            "max_session_duration": 0,
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "ef50cdc207f05f6fb8f20219f229ed1f",
            "modifier_email": "-",
            "modifier_name": "-",
            "name": "string",
            "type": "DEFAULT"
        }
    ],
    "size": 20,
    "sort": [
        "created_at:asc"
    ],
    "users": [
        {
            "access_control": false,
            "account_id": "d7aba97100564b34a0f4f77c4bc7a303",
            "account_name": "",
            "allowed_ip_addresses": "",
            "company_name": "",
            "created_at": "2024-11-15T06:57:42.000000Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "description": "",
            "domain_name": "scp",
            "dst_offset": "+09:00",
            "email": "samsung.kim@samsung.com",
            "email_authenticate_code": "8ada8861bad2423295e4bb576bee5886",
            "email_authenticated": true,
            "first_name": "",
            "groups": [],
            "id": "90dddfc2b1e04edba54ba2b41539a9ac",
            "keycloak_id": "127e3d8c-66dc-4b1b-b38b-9a1d0c6d5507",
            "keystone_credential": "",
            "last_login_at": "2024-11-25T06:57:42.000000Z",
            "last_name": "",
            "last_password_update_at": "",
            "login_id": "",
            "modified_at": "2024-11-17T06:57:42.000000Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "nation_id": "+82",
            "phone_authenticated": false,
            "phone_number": "0000000000",
            "policies": [],
            "state": "ACTIVE",
            "temporary_password": false,
            "term_region_id": "1",
            "timezone": "Asia/Seoul",
            "type": "IAM",
            "tz_id": "Asia/Seoul",
            "user_name": "Kim Samsung",
            "utc_offset": "+09:00"
        }
    ]
}

1.23 - Get an access key

1.23.1 - 1.2

get /v1/access-keys/{access_key_id}

Description

Get an access key

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	access_key_id required	Access key ID Example : `f39c460fade34fecb05ede8f904b24b7`	string	None

Responses

HTTP Code	Description	Schema
200	OK	AccessKeyResponse
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/access-keys/{access_key_id}

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.2"

Example HTTP response

Response 200

{
    "access_key": {
        "access_key": "b754b12b39da4ce29a40c5e324650bd0",
        "access_key_type": "PERMANENT",
        "account_id": "f39c460fade34fecb05ede8f904b24b7",
        "created_at": "2024-05-17T00:23:17Z",
        "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "description": "description",
        "expiration_timestamp": "9999-12-31T23:59:59Z",
        "id": "6558fc9df5b54c8a985465bdf637e097",
        "is_enabled": "true",
        "modified_at": "2024-05-17T00:23:17Z",
        "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "parent_access_key_id": "92d6eid9e9ae4f868s842910k11573a3",
        "secret_key": "c4150149-f7c6-46bc-9faa-d2b9d20e0899"
    }
}

1.23.2 - 1.1

get /v1/access-keys/{access_key_id}

Description

Get an access key

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	access_key_id required	Access key ID Example : `f39c460fade34fecb05ede8f904b24b7`	string	None

Responses

HTTP Code	Description	Schema
200	OK	AccessKeyResponse
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/access-keys/{access_key_id}

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.1"

Example HTTP response

Response 200

{
    "access_key": {
        "access_key": "b754b12b39da4ce29a40c5e324650bd0",
        "access_key_type": "PERMANENT",
        "account_id": "f39c460fade34fecb05ede8f904b24b7",
        "created_at": "2024-05-17T00:23:17Z",
        "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "description": "description",
        "expiration_timestamp": "9999-12-31T23:59:59Z",
        "id": "6558fc9df5b54c8a985465bdf637e097",
        "is_enabled": "true",
        "modified_at": "2024-05-17T00:23:17Z",
        "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "parent_access_key_id": "92d6eid9e9ae4f868s842910k11573a3",
        "secret_key": "c4150149-f7c6-46bc-9faa-d2b9d20e0899"
    }
}

1.23.3 - 1.0

get /v1/access-keys/{access_key_id}

Description

Get an access key

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	access_key_id required	Access key ID Example : `f39c460fade34fecb05ede8f904b24b7`	string	None

Responses

HTTP Code	Description	Schema
200	OK	AccessKeyResponse
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/access-keys/{access_key_id}

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

{
    "access_key": {
        "access_key": "b754b12b39da4ce29a40c5e324650bd0",
        "access_key_type": "PERMANENT",
        "account_id": "f39c460fade34fecb05ede8f904b24b7",
        "created_at": "2024-05-17T00:23:17Z",
        "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "description": "description",
        "expiration_timestamp": "9999-12-31T23:59:59Z",
        "id": "6558fc9df5b54c8a985465bdf637e097",
        "is_enabled": "true",
        "modified_at": "2024-05-17T00:23:17Z",
        "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "parent_access_key_id": "92d6eid9e9ae4f868s842910k11573a3",
        "secret_key": "c4150149-f7c6-46bc-9faa-d2b9d20e0899"
    }
}

1.24 - Get endpoint list

1.24.1 - 1.2

get /v1/endpoints

Description

Get endpoint list

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Responses

HTTP Code	Description	Schema
200	OK	ListEndpointsResponse
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/endpoints

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.2"

Example HTTP response

Response 200

{
    "endpoints": [
        {
            "region": "kr-west1",
            "service_name": "scp-iam",
            "service_type": "scp-iam",
            "url": "https://iam.dev2.samsungsdscloud.com"
        }
    ]
}

1.24.2 - 1.1

get /v1/endpoints

Description

Get endpoint list

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Responses

HTTP Code	Description	Schema
200	OK	ListEndpointsResponse
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/endpoints

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.1"

Example HTTP response

Response 200

{
    "endpoints": [
        {
            "region": "kr-west1",
            "service_name": "scp-iam",
            "service_type": "scp-iam",
            "url": "https://iam.dev2.samsungsdscloud.com"
        }
    ]
}

1.24.3 - 1.0

get /v1/endpoints

Description

Get endpoint list

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Responses

HTTP Code	Description	Schema
200	OK	ListEndpointsResponse
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/endpoints

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

{
    "endpoints": [
        {
            "region": "kr-west1",
            "service_name": "scp-iam",
            "service_type": "scp-iam",
            "url": "https://iam.dev2.samsungsdscloud.com"
        }
    ]
}

1.25 - Get IAM users

1.25.1 - 1.2

get /v1/accounts/{account_id}/users/{user_id}

Description

Get IAM users

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	account_id required	Account ID Example :	string	None
path	user_id required	User ID Example :	string	None

Responses

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

Example HTTP request

Request path

/v1/accounts/{account_id}/users/{user_id}

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.2"

Example HTTP response

Response 200

{
    "account_id": "",
    "company_name": "",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "created_by_name": "",
    "description": "",
    "dst_offset": "",
    "email": "",
    "email_authenticated": "",
    "first_name": "",
    "id": "",
    "last_login_at": "",
    "last_name": "",
    "last_password_update_at": "",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "modified_by_name": "",
    "name": "",
    "password_reuse_count": "",
    "phone_authenticated": "",
    "policies": [],
    "resource_type": "User",
    "service": "iam",
    "service_name": "Identity Access Management",
    "srn": "",
    "state": "",
    "timezone": "",
    "type": "",
    "tz_id": "",
    "user_name": "",
    "utc_offset": ""
}

1.25.2 - 1.1

get /v1/accounts/{account_id}/users/{user_id}

Description

Get IAM users

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	account_id required	Account ID Example :	string	None
path	user_id required	User ID Example :	string	None

Responses

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

Example HTTP request

Request path

/v1/accounts/{account_id}/users/{user_id}

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.1"

Example HTTP response

Response 200

{
    "account_id": "",
    "company_name": "",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "created_by_name": "",
    "description": "",
    "dst_offset": "",
    "email": "",
    "email_authenticated": "",
    "first_name": "",
    "id": "",
    "last_login_at": "",
    "last_name": "",
    "last_password_update_at": "",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "modified_by_name": "",
    "name": "",
    "password_reuse_count": "",
    "phone_authenticated": "",
    "policies": [],
    "resource_type": "User",
    "service": "iam",
    "service_name": "Identity Access Management",
    "srn": "",
    "state": "",
    "timezone": "",
    "type": "",
    "tz_id": "",
    "user_name": "",
    "utc_offset": ""
}

1.25.3 - 1.0

get /v1/accounts/{account_id}/users/{user_id}

Description

Get IAM users

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	account_id required	Account ID Example :	string	None
path	user_id required	User ID Example :	string	None

Responses

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

Example HTTP request

Request path

/v1/accounts/{account_id}/users/{user_id}

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

{
    "account_id": "",
    "company_name": "",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "created_by_name": "",
    "description": "",
    "dst_offset": "",
    "email": "",
    "email_authenticated": "",
    "first_name": "",
    "id": "",
    "last_login_at": "",
    "last_name": "",
    "last_password_update_at": "",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "modified_by_name": "",
    "name": "",
    "password_reuse_count": "",
    "phone_authenticated": "",
    "policies": [],
    "resource_type": "User",
    "service": "iam",
    "service_name": "Identity Access Management",
    "srn": "",
    "state": "",
    "timezone": "",
    "type": "",
    "tz_id": "",
    "user_name": "",
    "utc_offset": ""
}

1.26 - Get policy list

1.26.1 - 1.2

get /v1/policies

Description

Get policy list

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

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	id optional	Policy ID Example : `37f2e31ff86b415698d7e8eeafab445d`	any of [string, null]	None
query	policy_name optional	Policy Name Example : `ViewerAccess`	any of [string, null]	None
query	policy_type optional	Policy Type Example : `SYSTEM_MANAGED`	any of [string, array[string], null]	None
query	service_type optional	Service Type Example : `scp-iam`	any of [string, array[string], null]	None
query	creator_name optional	Policy 생성자 성, 이름 Example : `test1`	any of [string, null]	None
query	creator_email optional	Policy 생성자 Email Example : `test@test.com`	any of [string, null]	None
query	modifier_name optional	Policy 수정자 성, 이름 Example : `test1`	any of [string, null]	None
query	modifier_email optional	Policy 수정자 Email Example : `test@test.com`	any of [string, null]	None
query	exclude_group_id optional	제외할 Group ID Example : `a946662dc4314dac93da413a32457459`	any of [string, null]	None
query	exclude_user_id optional	제외할 User ID Example :	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	PolicyPageResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/policies

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.2"

Example HTTP response

Response 200

{
    "count": 20,
    "page": 0,
    "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"
        }
    ],
    "size": 20,
    "sort": [
        "created_at:asc"
    ]
}

1.26.2 - 1.1

get /v1/policies

Description

Get policy list

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

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	id optional	Policy ID Example : `37f2e31ff86b415698d7e8eeafab445d`	any of [string, null]	None
query	policy_name optional	Policy Name Example : `ViewerAccess`	any of [string, null]	None
query	policy_type optional	Policy Type Example : `SYSTEM_MANAGED`	any of [string, array[string], null]	None
query	service_type optional	Service Type Example : `scp-iam`	any of [string, array[string], null]	None
query	creator_name optional	Policy 생성자 성, 이름 Example : `test1`	any of [string, null]	None
query	creator_email optional	Policy 생성자 Email Example : `test@test.com`	any of [string, null]	None
query	modifier_name optional	Policy 수정자 성, 이름 Example : `test1`	any of [string, null]	None
query	modifier_email optional	Policy 수정자 Email Example : `test@test.com`	any of [string, null]	None
query	exclude_group_id optional	제외할 Group ID Example : `a946662dc4314dac93da413a32457459`	any of [string, null]	None
query	exclude_user_id optional	제외할 User ID Example :	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	PolicyPageResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/policies

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.1"

Example HTTP response

Response 200

{
    "count": 20,
    "page": 0,
    "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"
        }
    ],
    "size": 20,
    "sort": [
        "created_at:asc"
    ]
}

1.26.3 - 1.0

get /v1/policies

Description

Get policy 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	id optional	Policy ID Example : `37f2e31ff86b415698d7e8eeafab445d`	any of [string, null]	None
query	policy_name optional	Policy Name Example : `ViewerAccess`	any of [string, null]	None
query	policy_type optional	Policy Type Example : `SYSTEM_MANAGED`	any of [string, array[string], null]	None
query	service_type optional	Service Type Example : `scp-iam`	any of [string, array[string], null]	None
query	creator_name optional	Policy 생성자 성, 이름 Example : `test1`	any of [string, null]	None
query	creator_email optional	Policy 생성자 Email Example : `test@test.com`	any of [string, null]	None
query	modifier_name optional	Policy 수정자 성, 이름 Example : `test1`	any of [string, null]	None
query	modifier_email optional	Policy 수정자 Email Example : `test@test.com`	any of [string, null]	None
query	exclude_group_id optional	제외할 Group ID Example : `a946662dc4314dac93da413a32457459`	any of [string, null]	None
query	exclude_user_id optional	제외할 User ID Example :	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	PolicyPageResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/policies

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,
    "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"
        }
    ],
    "size": 20,
    "sort": [
        "created_at:asc"
    ]
}

1.27 - Get role

1.27.1 - 1.2

get /v1/roles/{role_id}

Description

Get role

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	role_id required	역할 ID Example :	string	None

Responses

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

Example HTTP request

Request path

/v1/roles/{role_id}

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.2"

Example HTTP response

Response 200

{
    "role": {
        "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"
    }
}

1.27.2 - 1.1

get /v1/roles/{role_id}

Description

Get role

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	role_id required	역할 ID Example :	string	None

Responses

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

Example HTTP request

Request path

/v1/roles/{role_id}

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.1"

Example HTTP response

Response 200

{
    "role": {
        "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"
    }
}

1.27.3 - 1.0

get /v1/roles/{role_id}

Description

Get role

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	role_id required	역할 ID Example :	string	None

Responses

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

Example HTTP request

Request path

/v1/roles/{role_id}

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

{
    "role": {
        "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"
    }
}

1.28 - Get role list

1.28.1 - 1.2

get /v1/roles

Description

Get role list

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

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.2"

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"
    ]
}

1.28.2 - 1.1

get /v1/roles

Description

Get role list

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

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.1"

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"
    ]
}

1.28.3 - 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"
    ]
}

1.29 - Get Role Policy-Binding list

1.29.1 - 1.2

get /v1/roles/{role_id}/policy-bindings

Description

Get Role Policy-Binding list

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	role_id required	역할 ID Example :	string	None
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	policy_id optional	역할에 연결된 정책 ID Example :	any of [string, null]	None
query	policy_name optional	역할에 연결된 정책 이름 Example :	any of [string, null]	None
query	policy_type optional	역할에 연결된 정책 유형 목록 Example : `['SYSTEM_MANAGED', 'USER_DEFINED', 'INLINE']`	any of [string, array[string], null]	None

Responses

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

Example HTTP request

Request path

/v1/roles/{role_id}/policy-bindings

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.2"

Example HTTP response

Response 200

{
    "count": 20,
    "page": 0,
    "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"
        }
    ],
    "size": 20,
    "sort": [
        "created_at:asc"
    ]
}

1.29.2 - 1.1

get /v1/roles/{role_id}/policy-bindings

Description

Get Role Policy-Binding list

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	role_id required	역할 ID Example :	string	None
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	policy_id optional	역할에 연결된 정책 ID Example :	any of [string, null]	None
query	policy_name optional	역할에 연결된 정책 이름 Example :	any of [string, null]	None
query	policy_type optional	역할에 연결된 정책 유형 목록 Example : `['SYSTEM_MANAGED', 'USER_DEFINED', 'INLINE']`	any of [string, array[string], null]	None

Responses

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

Example HTTP request

Request path

/v1/roles/{role_id}/policy-bindings

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.1"

Example HTTP response

Response 200

{
    "count": 20,
    "page": 0,
    "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"
        }
    ],
    "size": 20,
    "sort": [
        "created_at:asc"
    ]
}

1.29.3 - 1.0

get /v1/roles/{role_id}/policy-bindings

Description

Get Role Policy-Binding list

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	role_id required	역할 ID Example :	string	None
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	policy_id optional	역할에 연결된 정책 ID Example :	any of [string, null]	None
query	policy_name optional	역할에 연결된 정책 이름 Example :	any of [string, null]	None
query	policy_type optional	역할에 연결된 정책 유형 목록 Example : `['SYSTEM_MANAGED', 'USER_DEFINED', 'INLINE']`	any of [string, array[string], null]	None

Responses

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

Example HTTP request

Request path

/v1/roles/{role_id}/policy-bindings

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,
    "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"
        }
    ],
    "size": 20,
    "sort": [
        "created_at:asc"
    ]
}

1.30 - Get saml provider information

1.30.1 - 1.2

get /v1/saml-providers/{saml_provider_id}

Description

Get saml provider information

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	saml_provider_id required	자격증명공급자 ID Example :	string	None

Responses

HTTP Code	Description	Schema
200	OK	SamlProviderDetailResponse
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/saml-providers/{saml_provider_id}

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.2"

Example HTTP response

Response 200

{
    "account_id": "",
    "acs_url": "",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "creator_name": "",
    "description": "",
    "federation_type": "",
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "idp_cert_end": "",
    "idp_file_data": "",
    "idp_file_name": "",
    "idp_file_size": "",
    "idp_issuer_url": "",
    "idp_sso_url": "",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "modifier_name": "",
    "saml_provider_name": ""
}

1.30.2 - 1.1

get /v1/saml-providers/{saml_provider_id}

Description

Get saml provider information

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	saml_provider_id required	자격증명공급자 ID Example :	string	None

Responses

HTTP Code	Description	Schema
200	OK	SamlProviderDetailResponse
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/saml-providers/{saml_provider_id}

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.1"

Example HTTP response

Response 200

{
    "account_id": "",
    "acs_url": "",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "creator_name": "",
    "description": "",
    "federation_type": "",
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "idp_cert_end": "",
    "idp_file_data": "",
    "idp_file_name": "",
    "idp_file_size": "",
    "idp_issuer_url": "",
    "idp_sso_url": "",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "modifier_name": "",
    "saml_provider_name": ""
}

1.30.3 - 1.0

get /v1/saml-providers/{saml_provider_id}

Description

Get saml provider information

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	saml_provider_id required	자격증명공급자 ID Example :	string	None

Responses

HTTP Code	Description	Schema
200	OK	SamlProviderDetailResponse
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/saml-providers/{saml_provider_id}

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

{
    "account_id": "",
    "acs_url": "",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "creator_name": "",
    "description": "",
    "federation_type": "",
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "idp_cert_end": "",
    "idp_file_data": "",
    "idp_file_name": "",
    "idp_file_size": "",
    "idp_issuer_url": "",
    "idp_sso_url": "",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "modifier_name": "",
    "saml_provider_name": ""
}

1.31 - Get service account

1.31.1 - 1.2

get /v1/service-accounts/{service_account_id}

Description

Get service account

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	service_account_id required	Service Account ID Example :	string	None

Responses

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

Example HTTP request

Request path

/v1/service-accounts/{service_account_id}

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.2"

Example HTTP response

Response 200

{
    "service_account": {
        "id": "",
        "name": "",
        "password": "",
        "service": ""
    }
}

1.31.2 - 1.1

get /v1/service-accounts/{service_account_id}

Description

Get service account

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	service_account_id required	Service Account ID Example :	string	None

Responses

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

Example HTTP request

Request path

/v1/service-accounts/{service_account_id}

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.1"

Example HTTP response

Response 200

{
    "service_account": {
        "id": "",
        "name": "",
        "password": "",
        "service": ""
    }
}

1.31.3 - 1.0

get /v1/service-accounts/{service_account_id}

Description

Get service account

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	service_account_id required	Service Account ID Example :	string	None

Responses

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

Example HTTP request

Request path

/v1/service-accounts/{service_account_id}

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

{
    "service_account": {
        "id": "",
        "name": "",
        "password": "",
        "service": ""
    }
}

1.32 - Get user policy-binding list

1.32.1 - 1.2

get /v1/users/{user_id}/policy-bindings

Description

Get user policy-binding list

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	user_id required	사용자 ID Example :	string	None
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	policy_id optional	Policy Id Example :	any of [string, null]	None
query	policy_name optional	Policy Name Example : `ViewerAccess`	any of [string, null]	None
query	policy_type optional	Policy Type List Example : `['SYSTEM_MANAGED', 'USER_DEFINED']`	any of [string, array[string], null]	None

Responses

HTTP Code	Description	Schema
200	OK	UserPolicyPageResponse
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/users/{user_id}/policy-bindings

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.2"

Example HTTP response

Response 200

{
    "count": 20,
    "page": 0,
    "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"
        }
    ],
    "size": 20,
    "sort": [
        "created_at:asc"
    ],
    "user_id": ""
}

1.32.2 - 1.1

get /v1/users/{user_id}/policy-bindings

Description

Get user policy-binding list

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	user_id required	사용자 ID Example :	string	None
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	policy_id optional	Policy Id Example :	any of [string, null]	None
query	policy_name optional	Policy Name Example : `ViewerAccess`	any of [string, null]	None
query	policy_type optional	Policy Type List Example : `['SYSTEM_MANAGED', 'USER_DEFINED']`	any of [string, array[string], null]	None

Responses

HTTP Code	Description	Schema
200	OK	UserPolicyPageResponse
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/users/{user_id}/policy-bindings

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.1"

Example HTTP response

Response 200

{
    "count": 20,
    "page": 0,
    "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"
        }
    ],
    "size": 20,
    "sort": [
        "created_at:asc"
    ],
    "user_id": ""
}

1.32.3 - 1.0

get /v1/users/{user_id}/policy-bindings

Description

Get user policy-binding list

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	user_id required	사용자 ID Example :	string	None
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	policy_id optional	Policy Id Example :	any of [string, null]	None
query	policy_name optional	Policy Name Example : `ViewerAccess`	any of [string, null]	None
query	policy_type optional	Policy Type List Example : `['SYSTEM_MANAGED', 'USER_DEFINED']`	any of [string, array[string], null]	None

Responses

HTTP Code	Description	Schema
200	OK	UserPolicyPageResponse
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/users/{user_id}/policy-bindings

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,
    "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"
        }
    ],
    "size": 20,
    "sort": [
        "created_at:asc"
    ],
    "user_id": ""
}

1.33 - Group Member list

1.33.1 - 1.2

get /v1/groups/{group_id}/members

Description

Group Member list

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	group_id required	Group ID Example : `a946662dc4314dac93da413a32457459`	string	None
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	user_name optional	Group Member 성, 이름 Example : `Kim Samsung`	any of [string, null]	None
query	user_email optional	Group Member Email Example : `samsung.kim@samsung.com`	any of [string, null]	None
query	creator_name optional	Group Member 생성자 성, 이름 Example : `Kim Samsung`	any of [string, null]	None
query	creator_email optional	Group Member 생성자 Email Example : `samsung.kim@samsung.com`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	GroupMemberPageResponse
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/groups/{group_id}/members

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.2"

Example HTTP response

Response 200

{
    "count": 20,
    "group_members": [
        {
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "ef50cdc207f05f6fb8f20219f229ed1f",
            "creator_created_at": "2024-05-17T00:23:17Z",
            "creator_email": "samsung.kim@samsung.com",
            "creator_last_login_at": "2024-05-17T00:23:17Z",
            "creator_name": "Kim Samsung",
            "group_names": [
                "TestGroup",
                "SampleGroup"
            ],
            "user_created_at": "2024-05-17T00:23:17Z",
            "user_email": "samsung.kim@samsung.com",
            "user_id": "f39c460fade34fecb05ede8f904b24b7",
            "user_last_login_at": "2024-05-17T00:23:17Z",
            "user_name": "Kim Samsung"
        }
    ],
    "page": 0,
    "size": 20,
    "sort": [
        "created_at:asc"
    ]
}

1.33.2 - 1.1

get /v1/groups/{group_id}/members

Description

Group Member list

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	group_id required	Group ID Example : `a946662dc4314dac93da413a32457459`	string	None
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	user_name optional	Group Member 성, 이름 Example : `Kim Samsung`	any of [string, null]	None
query	user_email optional	Group Member Email Example : `samsung.kim@samsung.com`	any of [string, null]	None
query	creator_name optional	Group Member 생성자 성, 이름 Example : `Kim Samsung`	any of [string, null]	None
query	creator_email optional	Group Member 생성자 Email Example : `samsung.kim@samsung.com`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	GroupMemberPageResponse
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/groups/{group_id}/members

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.1"

Example HTTP response

Response 200

{
    "count": 20,
    "group_members": [
        {
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "ef50cdc207f05f6fb8f20219f229ed1f",
            "creator_created_at": "2024-05-17T00:23:17Z",
            "creator_email": "samsung.kim@samsung.com",
            "creator_last_login_at": "2024-05-17T00:23:17Z",
            "creator_name": "Kim Samsung",
            "group_names": [
                "TestGroup",
                "SampleGroup"
            ],
            "user_created_at": "2024-05-17T00:23:17Z",
            "user_email": "samsung.kim@samsung.com",
            "user_id": "f39c460fade34fecb05ede8f904b24b7",
            "user_last_login_at": "2024-05-17T00:23:17Z",
            "user_name": "Kim Samsung"
        }
    ],
    "page": 0,
    "size": 20,
    "sort": [
        "created_at:asc"
    ]
}

1.33.3 - 1.0

get /v1/groups/{group_id}/members

Description

Group Member list

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	group_id required	Group ID Example : `a946662dc4314dac93da413a32457459`	string	None
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	user_name optional	Group Member 성, 이름 Example : `Kim Samsung`	any of [string, null]	None
query	user_email optional	Group Member Email Example : `samsung.kim@samsung.com`	any of [string, null]	None
query	creator_name optional	Group Member 생성자 성, 이름 Example : `Kim Samsung`	any of [string, null]	None
query	creator_email optional	Group Member 생성자 Email Example : `samsung.kim@samsung.com`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	GroupMemberPageResponse
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/groups/{group_id}/members

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,
    "group_members": [
        {
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "ef50cdc207f05f6fb8f20219f229ed1f",
            "creator_created_at": "2024-05-17T00:23:17Z",
            "creator_email": "samsung.kim@samsung.com",
            "creator_last_login_at": "2024-05-17T00:23:17Z",
            "creator_name": "Kim Samsung",
            "group_names": [
                "TestGroup",
                "SampleGroup"
            ],
            "user_created_at": "2024-05-17T00:23:17Z",
            "user_email": "samsung.kim@samsung.com",
            "user_id": "f39c460fade34fecb05ede8f904b24b7",
            "user_last_login_at": "2024-05-17T00:23:17Z",
            "user_name": "Kim Samsung"
        }
    ],
    "page": 0,
    "size": 20,
    "sort": [
        "created_at:asc"
    ]
}

1.34 - List access keys

1.34.1 - 1.2

get /v1/access-keys

Description

List access keys

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
query	with_count optional	with count Example : `true`	any of [string, null]	None
query	limit optional	limit Example : `20`	any of [integer, null]	None
query	marker optional	marker Example : `607e0938521643b5b4b266f343fae693`	any of [string, null]	None
query	sort optional	sort Example : `created_at:desc`	any of [string, null]	None
query	account_id optional	Account Id Example : `f39c460fade34fecb05ede8f904b24b7`	any of [string, null]	None
query	access_key_type optional	Access key type Example : `PERMANENT`	any of [string, null]	None
query	parent_access_key_id optional	Parent access key ID Example : `f39c460fade34fecb05ede8f904b24b7`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	ListAccessKeyResponse
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/access-keys

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.2"

Example HTTP response

Response 200

{
    "access_keys": [
        {
            "access_key": "b754b12b39da4ce29a40c5e324650bd0",
            "access_key_type": "PERMANENT",
            "account_id": "f39c460fade34fecb05ede8f904b24b7",
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "description": "description",
            "expiration_timestamp": "9999-12-31T23:59:59Z",
            "id": "6558fc9df5b54c8a985465bdf637e097",
            "is_enabled": "true",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "parent_access_key_id": "92d6eid9e9ae4f868s842910k11573a3",
            "secret_key": "c4150149-f7c6-46bc-9faa-d2b9d20e0899"
        }
    ],
    "count": 20,
    "links": [
        {
            "href": "http://scp.samsungsdscloud.com/v1/access-keys?with_count=true&limit=20",
            "rel": "first"
        },
        {
            "href": "http://scp.samsungsdscloud.com/v1/access-keys?with_count=true&limit=20",
            "rel": "self"
        }
    ]
}

1.34.2 - 1.1

get /v1/access-keys

Description

List access keys

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
query	with_count optional	with count Example : `true`	any of [string, null]	None
query	limit optional	limit Example : `20`	any of [integer, null]	None
query	marker optional	marker Example : `607e0938521643b5b4b266f343fae693`	any of [string, null]	None
query	sort optional	sort Example : `created_at:desc`	any of [string, null]	None
query	account_id optional	Account Id Example : `f39c460fade34fecb05ede8f904b24b7`	any of [string, null]	None
query	access_key_type optional	Access key type Example : `PERMANENT`	any of [string, null]	None
query	parent_access_key_id optional	Parent access key ID Example : `f39c460fade34fecb05ede8f904b24b7`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	ListAccessKeyResponse
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/access-keys

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.1"

Example HTTP response

Response 200

{
    "access_keys": [
        {
            "access_key": "b754b12b39da4ce29a40c5e324650bd0",
            "access_key_type": "PERMANENT",
            "account_id": "f39c460fade34fecb05ede8f904b24b7",
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "description": "description",
            "expiration_timestamp": "9999-12-31T23:59:59Z",
            "id": "6558fc9df5b54c8a985465bdf637e097",
            "is_enabled": "true",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "parent_access_key_id": "92d6eid9e9ae4f868s842910k11573a3",
            "secret_key": "c4150149-f7c6-46bc-9faa-d2b9d20e0899"
        }
    ],
    "count": 20,
    "links": [
        {
            "href": "http://scp.samsungsdscloud.com/v1/access-keys?with_count=true&limit=20",
            "rel": "first"
        },
        {
            "href": "http://scp.samsungsdscloud.com/v1/access-keys?with_count=true&limit=20",
            "rel": "self"
        }
    ]
}

1.34.3 - 1.0

get /v1/access-keys

Description

List access keys

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
query	with_count optional	with count Example : `true`	any of [string, null]	None
query	limit optional	limit Example : `20`	any of [integer, null]	None
query	marker optional	marker Example : `607e0938521643b5b4b266f343fae693`	any of [string, null]	None
query	sort optional	sort Example : `created_at:desc`	any of [string, null]	None
query	account_id optional	Account Id Example : `f39c460fade34fecb05ede8f904b24b7`	any of [string, null]	None
query	access_key_type optional	Access key type Example : `PERMANENT`	any of [string, null]	None
query	parent_access_key_id optional	Parent access key ID Example : `f39c460fade34fecb05ede8f904b24b7`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	ListAccessKeyResponse
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/access-keys

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

{
    "access_keys": [
        {
            "access_key": "b754b12b39da4ce29a40c5e324650bd0",
            "access_key_type": "PERMANENT",
            "account_id": "f39c460fade34fecb05ede8f904b24b7",
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "description": "description",
            "expiration_timestamp": "9999-12-31T23:59:59Z",
            "id": "6558fc9df5b54c8a985465bdf637e097",
            "is_enabled": "true",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "parent_access_key_id": "92d6eid9e9ae4f868s842910k11573a3",
            "secret_key": "c4150149-f7c6-46bc-9faa-d2b9d20e0899"
        }
    ],
    "count": 20,
    "links": [
        {
            "href": "http://scp.samsungsdscloud.com/v1/access-keys?with_count=true&limit=20",
            "rel": "first"
        },
        {
            "href": "http://scp.samsungsdscloud.com/v1/access-keys?with_count=true&limit=20",
            "rel": "self"
        }
    ]
}

1.35 - List Groups

1.35.1 - 1.2

get /v1/groups

Description

List Groups

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

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	Group 이름 Example : `TestGroup`	any of [string, null]	None
query	types optional	Group Types Example : `USER_DEFINED,DEFAULT`	any of [string, null]	None
query	ids optional	Group IDs Example : `629114aa440b456797cc5da5d3d2ef5d,f2b62d3cba5f42a796783266507ce765`	any of [string, null]	None
query	has_member optional	Group Member 존재 여부 Example : `false`	any of [string, null]	None
query	has_role optional	Group Role 존재 여부 Example : `false`	any of [string, null]	None
query	is_completed optional	Group 완결 여부 Example : `false`	any of [string, null]	None
query	creator_name optional	Group 생성자 성, 이름 Example : `Kim Samsung`	any of [string, null]	None
query	creator_email optional	Group 생성자 Email Example : `samsung.kim@samsung.com`	any of [string, null]	None
query	modifier_name optional	Group 수정자 성, 이름 Example : `Kim Samsung`	any of [string, null]	None
query	modifier_email optional	Group 수정자 Email Example : `samsung.kim@samsung.com`	any of [string, null]	None
query	exclude_user_id optional	제외할 사용자 ID Example : `f39c460fade34fecb05ede8f904b24b7`	any of [string, null]	None
query	exclude_policy_id optional	제외할 정책 ID Example : `37f2e31ff86b415698d7e8eeafab445d`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	GroupPageResponse
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/groups

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.2"

Example HTTP response

Response 200

{
    "count": 20,
    "groups": [
        {
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "ef50cdc207f05f6fb8f20219f229ed1f",
            "creator_email": "samsung.kim@samsung.com",
            "creator_name": "Kim Samsung",
            "description": "Descriptions for group",
            "domain_name": "scp",
            "id": "f39c460fade34fecb05ede8f904b24b7",
            "members": [
                {
                    "created_at": "2024-05-17T00:23:17Z",
                    "created_by": "ef50cdc207f05f6fb8f20219f229ed1f",
                    "creator_created_at": "2024-05-17T00:23:17Z",
                    "creator_email": "samsung.kim@samsung.com",
                    "creator_last_login_at": "2024-05-17T00:23:17Z",
                    "creator_name": "Kim Samsung",
                    "group_names": [
                        "TestGroup",
                        "SampleGroup"
                    ],
                    "user_created_at": "2024-05-17T00:23:17Z",
                    "user_email": "samsung.kim@samsung.com",
                    "user_id": "f39c460fade34fecb05ede8f904b24b7",
                    "user_last_login_at": "2024-05-17T00:23:17Z",
                    "user_name": "Kim Samsung"
                }
            ],
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "ef50cdc207f05f6fb8f20219f229ed1f",
            "modifier_email": "samsung.kim@samsung.com",
            "modifier_name": "Kim Samsung",
            "name": "TestGroup",
            "policies": [],
            "resource_type": "group",
            "roles": [],
            "service_name": "Identity Access Management",
            "service_type": "iam",
            "srn": "srn:dev1:::::iam:group/0e0688b33641451a83d2ab8878666fda",
            "type": "USER_DEFINED"
        }
    ],
    "page": 0,
    "size": 20,
    "sort": [
        "created_at:asc"
    ]
}

1.35.2 - 1.1

get /v1/groups

Description

List Groups

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

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	Group 이름 Example : `TestGroup`	any of [string, null]	None
query	types optional	Group Types Example : `USER_DEFINED,DEFAULT`	any of [string, null]	None
query	ids optional	Group IDs Example : `629114aa440b456797cc5da5d3d2ef5d,f2b62d3cba5f42a796783266507ce765`	any of [string, null]	None
query	has_member optional	Group Member 존재 여부 Example : `false`	any of [string, null]	None
query	has_role optional	Group Role 존재 여부 Example : `false`	any of [string, null]	None
query	is_completed optional	Group 완결 여부 Example : `false`	any of [string, null]	None
query	creator_name optional	Group 생성자 성, 이름 Example : `Kim Samsung`	any of [string, null]	None
query	creator_email optional	Group 생성자 Email Example : `samsung.kim@samsung.com`	any of [string, null]	None
query	modifier_name optional	Group 수정자 성, 이름 Example : `Kim Samsung`	any of [string, null]	None
query	modifier_email optional	Group 수정자 Email Example : `samsung.kim@samsung.com`	any of [string, null]	None
query	exclude_user_id optional	제외할 사용자 ID Example : `f39c460fade34fecb05ede8f904b24b7`	any of [string, null]	None
query	exclude_policy_id optional	제외할 정책 ID Example : `37f2e31ff86b415698d7e8eeafab445d`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	GroupPageResponse
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/groups

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.1"

Example HTTP response

Response 200

{
    "count": 20,
    "groups": [
        {
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "ef50cdc207f05f6fb8f20219f229ed1f",
            "creator_email": "samsung.kim@samsung.com",
            "creator_name": "Kim Samsung",
            "description": "Descriptions for group",
            "domain_name": "scp",
            "id": "f39c460fade34fecb05ede8f904b24b7",
            "members": [
                {
                    "created_at": "2024-05-17T00:23:17Z",
                    "created_by": "ef50cdc207f05f6fb8f20219f229ed1f",
                    "creator_created_at": "2024-05-17T00:23:17Z",
                    "creator_email": "samsung.kim@samsung.com",
                    "creator_last_login_at": "2024-05-17T00:23:17Z",
                    "creator_name": "Kim Samsung",
                    "group_names": [
                        "TestGroup",
                        "SampleGroup"
                    ],
                    "user_created_at": "2024-05-17T00:23:17Z",
                    "user_email": "samsung.kim@samsung.com",
                    "user_id": "f39c460fade34fecb05ede8f904b24b7",
                    "user_last_login_at": "2024-05-17T00:23:17Z",
                    "user_name": "Kim Samsung"
                }
            ],
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "ef50cdc207f05f6fb8f20219f229ed1f",
            "modifier_email": "samsung.kim@samsung.com",
            "modifier_name": "Kim Samsung",
            "name": "TestGroup",
            "policies": [],
            "resource_type": "group",
            "roles": [],
            "service_name": "Identity Access Management",
            "service_type": "iam",
            "srn": "srn:dev1:::::iam:group/0e0688b33641451a83d2ab8878666fda",
            "type": "USER_DEFINED"
        }
    ],
    "page": 0,
    "size": 20,
    "sort": [
        "created_at:asc"
    ]
}

1.35.3 - 1.0

get /v1/groups

Description

List Groups

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	Group 이름 Example : `TestGroup`	any of [string, null]	None
query	types optional	Group Types Example : `USER_DEFINED,DEFAULT`	any of [string, null]	None
query	ids optional	Group IDs Example : `629114aa440b456797cc5da5d3d2ef5d,f2b62d3cba5f42a796783266507ce765`	any of [string, null]	None
query	has_member optional	Group Member 존재 여부 Example : `false`	any of [string, null]	None
query	has_role optional	Group Role 존재 여부 Example : `false`	any of [string, null]	None
query	is_completed optional	Group 완결 여부 Example : `false`	any of [string, null]	None
query	creator_name optional	Group 생성자 성, 이름 Example : `Kim Samsung`	any of [string, null]	None
query	creator_email optional	Group 생성자 Email Example : `samsung.kim@samsung.com`	any of [string, null]	None
query	modifier_name optional	Group 수정자 성, 이름 Example : `Kim Samsung`	any of [string, null]	None
query	modifier_email optional	Group 수정자 Email Example : `samsung.kim@samsung.com`	any of [string, null]	None
query	exclude_user_id optional	제외할 사용자 ID Example : `f39c460fade34fecb05ede8f904b24b7`	any of [string, null]	None
query	exclude_policy_id optional	제외할 정책 ID Example : `37f2e31ff86b415698d7e8eeafab445d`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	GroupPageResponse
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/groups

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,
    "groups": [
        {
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "ef50cdc207f05f6fb8f20219f229ed1f",
            "creator_email": "samsung.kim@samsung.com",
            "creator_name": "Kim Samsung",
            "description": "Descriptions for group",
            "domain_name": "scp",
            "id": "f39c460fade34fecb05ede8f904b24b7",
            "members": [
                {
                    "created_at": "2024-05-17T00:23:17Z",
                    "created_by": "ef50cdc207f05f6fb8f20219f229ed1f",
                    "creator_created_at": "2024-05-17T00:23:17Z",
                    "creator_email": "samsung.kim@samsung.com",
                    "creator_last_login_at": "2024-05-17T00:23:17Z",
                    "creator_name": "Kim Samsung",
                    "group_names": [
                        "TestGroup",
                        "SampleGroup"
                    ],
                    "user_created_at": "2024-05-17T00:23:17Z",
                    "user_email": "samsung.kim@samsung.com",
                    "user_id": "f39c460fade34fecb05ede8f904b24b7",
                    "user_last_login_at": "2024-05-17T00:23:17Z",
                    "user_name": "Kim Samsung"
                }
            ],
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "ef50cdc207f05f6fb8f20219f229ed1f",
            "modifier_email": "samsung.kim@samsung.com",
            "modifier_name": "Kim Samsung",
            "name": "TestGroup",
            "policies": [],
            "resource_type": "group",
            "roles": [],
            "service_name": "Identity Access Management",
            "service_type": "iam",
            "srn": "srn:dev1:::::iam:group/0e0688b33641451a83d2ab8878666fda",
            "type": "USER_DEFINED"
        }
    ],
    "page": 0,
    "size": 20,
    "sort": [
        "created_at:asc"
    ]
}

1.36 - List IAM users

1.36.1 - 1.2

get /v1/accounts/{account_id}/users

Description

List IAM users

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	account_id required	Account ID Example :	string	None
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	login_id optional	Login ID Example :	any of [string, null]	None
query	email optional	사용자 Email Example :	any of [string, null]	None
query	nation_id optional	국가 ID Example :	any of [string, null]	None
query	phone_number optional	사용자 휴대 전화 번호 Example :	any of [string, null]	None
query	user_name optional	사용자 이름 Example :	any of [string, null]	None
query	exclude_group_id optional	예외 대상 그룹 Example :	any of [string, null]	None
query	exclude_policy_id optional	예외 대상 정책 Example :	any of [string, null]	None
query	type optional	User Type Example :	any of [string, null]	None

Responses

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

Example HTTP request

Request path

/v1/accounts/{account_id}/users

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.2"

Example HTTP response

Response 200

{
    "count": 20,
    "page": 0,
    "size": 20,
    "sort": [
        "created_at:asc"
    ],
    "users": [
        {
            "account_id": "",
            "company_name": "",
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "description": "",
            "dst_offset": "",
            "email": "",
            "email_authenticated": "",
            "first_name": "",
            "groups": [
                ""
            ],
            "id": "",
            "last_login_at": "",
            "last_name": "",
            "last_password_update_at": "",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "name": "",
            "password_reuse_count": "",
            "phone_authenticated": "",
            "policies": [],
            "state": "",
            "timezone": "",
            "type": "",
            "tz_id": "",
            "user_name": "",
            "utc_offset": ""
        }
    ]
}

1.36.2 - 1.1

get /v1/accounts/{account_id}/users

Description

List IAM users

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	account_id required	Account ID Example :	string	None
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	login_id optional	Login ID Example :	any of [string, null]	None
query	email optional	사용자 Email Example :	any of [string, null]	None
query	nation_id optional	국가 ID Example :	any of [string, null]	None
query	phone_number optional	사용자 휴대 전화 번호 Example :	any of [string, null]	None
query	user_name optional	사용자 이름 Example :	any of [string, null]	None
query	exclude_group_id optional	예외 대상 그룹 Example :	any of [string, null]	None
query	exclude_policy_id optional	예외 대상 정책 Example :	any of [string, null]	None
query	type optional	User Type Example :	any of [string, null]	None

Responses

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

Example HTTP request

Request path

/v1/accounts/{account_id}/users

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.1"

Example HTTP response

Response 200

{
    "count": 20,
    "page": 0,
    "size": 20,
    "sort": [
        "created_at:asc"
    ],
    "users": [
        {
            "account_id": "",
            "company_name": "",
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "description": "",
            "dst_offset": "",
            "email": "",
            "email_authenticated": "",
            "first_name": "",
            "groups": [
                ""
            ],
            "id": "",
            "last_login_at": "",
            "last_name": "",
            "last_password_update_at": "",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "name": "",
            "password_reuse_count": "",
            "phone_authenticated": "",
            "policies": [],
            "state": "",
            "timezone": "",
            "type": "",
            "tz_id": "",
            "user_name": "",
            "utc_offset": ""
        }
    ]
}

1.36.3 - 1.0

get /v1/accounts/{account_id}/users

Description

List IAM users

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	account_id required	Account ID Example :	string	None
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	login_id optional	Login ID Example :	any of [string, null]	None
query	email optional	사용자 Email Example :	any of [string, null]	None
query	nation_id optional	국가 ID Example :	any of [string, null]	None
query	phone_number optional	사용자 휴대 전화 번호 Example :	any of [string, null]	None
query	user_name optional	사용자 이름 Example :	any of [string, null]	None
query	exclude_group_id optional	예외 대상 그룹 Example :	any of [string, null]	None
query	exclude_policy_id optional	예외 대상 정책 Example :	any of [string, null]	None
query	type optional	User Type Example :	any of [string, null]	None

Responses

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

Example HTTP request

Request path

/v1/accounts/{account_id}/users

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,
    "size": 20,
    "sort": [
        "created_at:asc"
    ],
    "users": [
        {
            "account_id": "",
            "company_name": "",
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "description": "",
            "dst_offset": "",
            "email": "",
            "email_authenticated": "",
            "first_name": "",
            "groups": [
                ""
            ],
            "id": "",
            "last_login_at": "",
            "last_name": "",
            "last_password_update_at": "",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "name": "",
            "password_reuse_count": "",
            "phone_authenticated": "",
            "policies": [],
            "state": "",
            "timezone": "",
            "type": "",
            "tz_id": "",
            "user_name": "",
            "utc_offset": ""
        }
    ]
}

1.37 - List saml providers

1.37.1 - 1.2

get /v1/saml-providers

Description

List saml providers

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

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	federation_type optional	자격증명공급자 유형 Example :	any of [string, null]	None
query	saml_provider_name optional	자격증명공급자 이름 Example :	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	ListSamlProviderResponse
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/saml-providers

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.2"

Example HTTP response

Response 200

{
    "count": 20,
    "page": 0,
    "saml_providers": [
        {
            "account_id": "",
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "creator_name": "",
            "description": "",
            "federation_type": "",
            "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "modifier_name": "",
            "saml_provider_name": ""
        }
    ],
    "size": 20,
    "sort": [
        "created_at:asc"
    ]
}

1.37.2 - 1.1

get /v1/saml-providers

Description

List saml providers

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

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	federation_type optional	자격증명공급자 유형 Example :	any of [string, null]	None
query	saml_provider_name optional	자격증명공급자 이름 Example :	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	ListSamlProviderResponse
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/saml-providers

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.1"

Example HTTP response

Response 200

{
    "count": 20,
    "page": 0,
    "saml_providers": [
        {
            "account_id": "",
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "creator_name": "",
            "description": "",
            "federation_type": "",
            "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "modifier_name": "",
            "saml_provider_name": ""
        }
    ],
    "size": 20,
    "sort": [
        "created_at:asc"
    ]
}

1.37.3 - 1.0

get /v1/saml-providers

Description

List saml providers

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	federation_type optional	자격증명공급자 유형 Example :	any of [string, null]	None
query	saml_provider_name optional	자격증명공급자 이름 Example :	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	ListSamlProviderResponse
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/saml-providers

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,
    "saml_providers": [
        {
            "account_id": "",
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "creator_name": "",
            "description": "",
            "federation_type": "",
            "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "modifier_name": "",
            "saml_provider_name": ""
        }
    ],
    "size": 20,
    "sort": [
        "created_at:asc"
    ]
}

1.38 - List service accounts

1.38.1 - 1.2

get /v1/service-accounts

Description

List service accounts

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
query	name optional	Service Account Name Example :	any of [string, null]	None
query	service optional	Service Account’s Service Example :	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	ServiceAccountListResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/service-accounts

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.2"

Example HTTP response

Response 200

{
    "service_accounts": [
        {
            "id": "",
            "name": "",
            "service": ""
        }
    ]
}

1.38.2 - 1.1

get /v1/service-accounts

Description

List service accounts

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
query	name optional	Service Account Name Example :	any of [string, null]	None
query	service optional	Service Account’s Service Example :	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	ServiceAccountListResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/service-accounts

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.1"

Example HTTP response

Response 200

{
    "service_accounts": [
        {
            "id": "",
            "name": "",
            "service": ""
        }
    ]
}

1.38.3 - 1.0

get /v1/service-accounts

Description

List service accounts

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
query	name optional	Service Account Name Example :	any of [string, null]	None
query	service optional	Service Account’s Service Example :	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	ServiceAccountListResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/service-accounts

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

{
    "service_accounts": [
        {
            "id": "",
            "name": "",
            "service": ""
        }
    ]
}

1.39 - Modify a Group

1.39.1 - 1.2

put /v1/groups/{group_id}

Description

Modify a Group

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	group_id required	Group ID Example : `a946662dc4314dac93da413a32457459`	string	None
body	body required		GroupSetRequest

Responses

HTTP Code	Description	Schema
200	OK	GroupShowResponse
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/groups/{group_id}

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.2"

Request body

{
    "description": "Descriptions for group",
    "name": "TestGroup"
}

Example HTTP response

Response 200

{
    "group": {
        "created_at": "2024-05-17T00:23:17Z",
        "created_by": "ef50cdc207f05f6fb8f20219f229ed1f",
        "creator_email": "samsung.kim@samsung.com",
        "creator_name": "Kim Samsung",
        "description": "Descriptions for group",
        "domain_name": "scp",
        "id": "f39c460fade34fecb05ede8f904b24b7",
        "members": [
            {
                "created_at": "2024-05-17T00:23:17Z",
                "created_by": "ef50cdc207f05f6fb8f20219f229ed1f",
                "creator_created_at": "2024-05-17T00:23:17Z",
                "creator_email": "samsung.kim@samsung.com",
                "creator_last_login_at": "2024-05-17T00:23:17Z",
                "creator_name": "Kim Samsung",
                "group_names": [
                    "TestGroup",
                    "SampleGroup"
                ],
                "user_created_at": "2024-05-17T00:23:17Z",
                "user_email": "samsung.kim@samsung.com",
                "user_id": "f39c460fade34fecb05ede8f904b24b7",
                "user_last_login_at": "2024-05-17T00:23:17Z",
                "user_name": "Kim Samsung"
            }
        ],
        "modified_at": "2024-05-17T00:23:17Z",
        "modified_by": "ef50cdc207f05f6fb8f20219f229ed1f",
        "modifier_email": "samsung.kim@samsung.com",
        "modifier_name": "Kim Samsung",
        "name": "TestGroup",
        "policies": [],
        "resource_type": "group",
        "roles": [],
        "service_name": "Identity Access Management",
        "service_type": "iam",
        "srn": "srn:dev1:::::iam:group/0e0688b33641451a83d2ab8878666fda",
        "type": "USER_DEFINED"
    }
}

1.39.2 - 1.1

put /v1/groups/{group_id}

Description

Modify a Group

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	group_id required	Group ID Example : `a946662dc4314dac93da413a32457459`	string	None
body	body required		GroupSetRequest

Responses

HTTP Code	Description	Schema
200	OK	GroupShowResponse
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/groups/{group_id}

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.1"

Request body

{
    "description": "Descriptions for group",
    "name": "TestGroup"
}

Example HTTP response

Response 200

{
    "group": {
        "created_at": "2024-05-17T00:23:17Z",
        "created_by": "ef50cdc207f05f6fb8f20219f229ed1f",
        "creator_email": "samsung.kim@samsung.com",
        "creator_name": "Kim Samsung",
        "description": "Descriptions for group",
        "domain_name": "scp",
        "id": "f39c460fade34fecb05ede8f904b24b7",
        "members": [
            {
                "created_at": "2024-05-17T00:23:17Z",
                "created_by": "ef50cdc207f05f6fb8f20219f229ed1f",
                "creator_created_at": "2024-05-17T00:23:17Z",
                "creator_email": "samsung.kim@samsung.com",
                "creator_last_login_at": "2024-05-17T00:23:17Z",
                "creator_name": "Kim Samsung",
                "group_names": [
                    "TestGroup",
                    "SampleGroup"
                ],
                "user_created_at": "2024-05-17T00:23:17Z",
                "user_email": "samsung.kim@samsung.com",
                "user_id": "f39c460fade34fecb05ede8f904b24b7",
                "user_last_login_at": "2024-05-17T00:23:17Z",
                "user_name": "Kim Samsung"
            }
        ],
        "modified_at": "2024-05-17T00:23:17Z",
        "modified_by": "ef50cdc207f05f6fb8f20219f229ed1f",
        "modifier_email": "samsung.kim@samsung.com",
        "modifier_name": "Kim Samsung",
        "name": "TestGroup",
        "policies": [],
        "resource_type": "group",
        "roles": [],
        "service_name": "Identity Access Management",
        "service_type": "iam",
        "srn": "srn:dev1:::::iam:group/0e0688b33641451a83d2ab8878666fda",
        "type": "USER_DEFINED"
    }
}

1.39.3 - 1.0

put /v1/groups/{group_id}

Description

Modify a Group

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	group_id required	Group ID Example : `a946662dc4314dac93da413a32457459`	string	None
body	body required		GroupSetRequest

Responses

HTTP Code	Description	Schema
200	OK	GroupShowResponse
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/groups/{group_id}

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"

Request body

{
    "description": "Descriptions for group",
    "name": "TestGroup"
}

Example HTTP response

Response 200

{
    "group": {
        "created_at": "2024-05-17T00:23:17Z",
        "created_by": "ef50cdc207f05f6fb8f20219f229ed1f",
        "creator_email": "samsung.kim@samsung.com",
        "creator_name": "Kim Samsung",
        "description": "Descriptions for group",
        "domain_name": "scp",
        "id": "f39c460fade34fecb05ede8f904b24b7",
        "members": [
            {
                "created_at": "2024-05-17T00:23:17Z",
                "created_by": "ef50cdc207f05f6fb8f20219f229ed1f",
                "creator_created_at": "2024-05-17T00:23:17Z",
                "creator_email": "samsung.kim@samsung.com",
                "creator_last_login_at": "2024-05-17T00:23:17Z",
                "creator_name": "Kim Samsung",
                "group_names": [
                    "TestGroup",
                    "SampleGroup"
                ],
                "user_created_at": "2024-05-17T00:23:17Z",
                "user_email": "samsung.kim@samsung.com",
                "user_id": "f39c460fade34fecb05ede8f904b24b7",
                "user_last_login_at": "2024-05-17T00:23:17Z",
                "user_name": "Kim Samsung"
            }
        ],
        "modified_at": "2024-05-17T00:23:17Z",
        "modified_by": "ef50cdc207f05f6fb8f20219f229ed1f",
        "modifier_email": "samsung.kim@samsung.com",
        "modifier_name": "Kim Samsung",
        "name": "TestGroup",
        "policies": [],
        "resource_type": "group",
        "roles": [],
        "service_name": "Identity Access Management",
        "service_type": "iam",
        "srn": "srn:dev1:::::iam:group/0e0688b33641451a83d2ab8878666fda",
        "type": "USER_DEFINED"
    }
}

1.40 - Query policy list

1.40.1 - 1.2

post /v1/policies/list

Description

Query policy list

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

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	id optional	Policy ID Example : `37f2e31ff86b415698d7e8eeafab445d`	any of [string, null]	None
query	policy_name optional	Policy Name Example : `ViewerAccess`	any of [string, null]	None
query	policy_type optional	Policy Type Example : `SYSTEM_MANAGED`	any of [string, array[string], null]	None
query	service_type optional	Service Type Example : `scp-iam`	any of [string, array[string], null]	None
query	creator_name optional	Policy 생성자 성, 이름 Example : `test1`	any of [string, null]	None
query	creator_email optional	Policy 생성자 Email Example : `test@test.com`	any of [string, null]	None
query	modifier_name optional	Policy 수정자 성, 이름 Example : `test1`	any of [string, null]	None
query	modifier_email optional	Policy 수정자 Email Example : `test@test.com`	any of [string, null]	None
query	exclude_group_id optional	제외할 Group ID Example : `a946662dc4314dac93da413a32457459`	any of [string, null]	None
query	exclude_user_id optional	제외할 User ID Example :	any of [string, null]	None
body	body required		PolicyQueryRequest

Responses

HTTP Code	Description	Schema
200	OK	PolicyPageResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/policies/list

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.2"

Request body

{
    "excluded_policy_ids": [
        "37f2e31ff86b415698d7e8eeafab445d"
    ]
}

Example HTTP response

Response 200

{
    "count": 20,
    "page": 0,
    "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"
        }
    ],
    "size": 20,
    "sort": [
        "created_at:asc"
    ]
}

1.40.2 - 1.1

post /v1/policies/list

Description

Query policy list

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

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	id optional	Policy ID Example : `37f2e31ff86b415698d7e8eeafab445d`	any of [string, null]	None
query	policy_name optional	Policy Name Example : `ViewerAccess`	any of [string, null]	None
query	policy_type optional	Policy Type Example : `SYSTEM_MANAGED`	any of [string, array[string], null]	None
query	service_type optional	Service Type Example : `scp-iam`	any of [string, array[string], null]	None
query	creator_name optional	Policy 생성자 성, 이름 Example : `test1`	any of [string, null]	None
query	creator_email optional	Policy 생성자 Email Example : `test@test.com`	any of [string, null]	None
query	modifier_name optional	Policy 수정자 성, 이름 Example : `test1`	any of [string, null]	None
query	modifier_email optional	Policy 수정자 Email Example : `test@test.com`	any of [string, null]	None
query	exclude_group_id optional	제외할 Group ID Example : `a946662dc4314dac93da413a32457459`	any of [string, null]	None
query	exclude_user_id optional	제외할 User ID Example :	any of [string, null]	None
body	body required		PolicyQueryRequest

Responses

HTTP Code	Description	Schema
200	OK	PolicyPageResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/policies/list

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.1"

Request body

{
    "excluded_policy_ids": [
        "37f2e31ff86b415698d7e8eeafab445d"
    ]
}

Example HTTP response

Response 200

{
    "count": 20,
    "page": 0,
    "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"
        }
    ],
    "size": 20,
    "sort": [
        "created_at:asc"
    ]
}

1.40.3 - 1.0

post /v1/policies/list

Description

Query policy 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	id optional	Policy ID Example : `37f2e31ff86b415698d7e8eeafab445d`	any of [string, null]	None
query	policy_name optional	Policy Name Example : `ViewerAccess`	any of [string, null]	None
query	policy_type optional	Policy Type Example : `SYSTEM_MANAGED`	any of [string, array[string], null]	None
query	service_type optional	Service Type Example : `scp-iam`	any of [string, array[string], null]	None
query	creator_name optional	Policy 생성자 성, 이름 Example : `test1`	any of [string, null]	None
query	creator_email optional	Policy 생성자 Email Example : `test@test.com`	any of [string, null]	None
query	modifier_name optional	Policy 수정자 성, 이름 Example : `test1`	any of [string, null]	None
query	modifier_email optional	Policy 수정자 Email Example : `test@test.com`	any of [string, null]	None
query	exclude_group_id optional	제외할 Group ID Example : `a946662dc4314dac93da413a32457459`	any of [string, null]	None
query	exclude_user_id optional	제외할 User ID Example :	any of [string, null]	None
body	body required		PolicyQueryRequest

Responses

HTTP Code	Description	Schema
200	OK	PolicyPageResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None

Example HTTP request

Request path

/v1/policies/list

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"

Request body

{
    "excluded_policy_ids": [
        "37f2e31ff86b415698d7e8eeafab445d"
    ]
}

Example HTTP response

Response 200

{
    "count": 20,
    "page": 0,
    "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"
        }
    ],
    "size": 20,
    "sort": [
        "created_at:asc"
    ]
}

1.41 - Remove a permission into the resource based policy

1.41.1 - 1.2

delete /v1/resource-policies/{srn}/statements/{sid}

Description

Remove a permission into the resource based policy

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	srn required	삼성 리소스 자원명 Example : `c3JuOmRldjI6OjEyMzQ1Njc4OTAxMDIzNDU2OTA6a3Itd2VzdDE6OnZpcnR1YWxzZXJ2ZXI6dmlydHVhbC1zZXJ2ZXIvYWJjZGUtMTIzNC01NTU1LTY2NjY=`	string	None
path	sid required	Statement ID Example : `Statement1`	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/resource-policies/{srn}/statements/{sid}

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.2"

Example HTTP response

Response 204

1.41.2 - 1.1

delete /v1/resource-policies/{srn}/statements/{sid}

Description

Remove a permission into the resource based policy

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	srn required	삼성 리소스 자원명 Example : `c3JuOmRldjI6OjEyMzQ1Njc4OTAxMDIzNDU2OTA6a3Itd2VzdDE6OnZpcnR1YWxzZXJ2ZXI6dmlydHVhbC1zZXJ2ZXIvYWJjZGUtMTIzNC01NTU1LTY2NjY=`	string	None
path	sid required	Statement ID Example : `Statement1`	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/resource-policies/{srn}/statements/{sid}

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.1"

Example HTTP response

Response 204

1.41.3 - 1.0

delete /v1/resource-policies/{srn}/statements/{sid}

Description

Remove a permission into the resource based policy

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	srn required	삼성 리소스 자원명 Example : `c3JuOmRldjI6OjEyMzQ1Njc4OTAxMDIzNDU2OTA6a3Itd2VzdDE6OnZpcnR1YWxzZXJ2ZXI6dmlydHVhbC1zZXJ2ZXIvYWJjZGUtMTIzNC01NTU1LTY2NjY=`	string	None
path	sid required	Statement ID Example : `Statement1`	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/resource-policies/{srn}/statements/{sid}

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 204

1.42 - Remove a User from a Group

1.42.1 - 1.2

delete /v1/groups/{group_id}/members/{user_id}

Description

Remove a User from a Group

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	group_id required	Group ID Example : `a946662dc4314dac93da413a32457459`	string	None
path	user_id required	User ID Example : `ef50cdc207f05f6fb8f20219f229ed1f`	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/groups/{group_id}/members/{user_id}

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.2"

Example HTTP response

Response 204

1.42.2 - 1.1

delete /v1/groups/{group_id}/members/{user_id}

Description

Remove a User from a Group

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	group_id required	Group ID Example : `a946662dc4314dac93da413a32457459`	string	None
path	user_id required	User ID Example : `ef50cdc207f05f6fb8f20219f229ed1f`	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/groups/{group_id}/members/{user_id}

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.1"

Example HTTP response

Response 204

1.42.3 - 1.0

delete /v1/groups/{group_id}/members/{user_id}

Description

Remove a User from a Group

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	group_id required	Group ID Example : `a946662dc4314dac93da413a32457459`	string	None
path	user_id required	User ID Example : `ef50cdc207f05f6fb8f20219f229ed1f`	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/groups/{group_id}/members/{user_id}

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 204

1.43 - Remove policies

1.43.1 - 1.2

delete /v1/policies/bulk

Description

Remove policies

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
body	body required		ListPolicyRemoveRequest

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/policies/bulk

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.2"

Request body

{
    "ids": [
        "37f2e31ff86b415698d7e8eeafab445d"
    ]
}

Example HTTP response

Response 204

1.43.2 - 1.1

delete /v1/policies/bulk

Description

Remove policies

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
body	body required		ListPolicyRemoveRequest

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/policies/bulk

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.1"

Request body

{
    "ids": [
        "37f2e31ff86b415698d7e8eeafab445d"
    ]
}

Example HTTP response

Response 204

1.43.3 - 1.0

delete /v1/policies/bulk

Description

Remove policies

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
body	body required		ListPolicyRemoveRequest

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/policies/bulk

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"

Request body

{
    "ids": [
        "37f2e31ff86b415698d7e8eeafab445d"
    ]
}

Example HTTP response

Response 204

1.44 - Remove policy assignment from group

1.44.1 - 1.2

delete /v1/groups/{group_id}/policy-bindings/{policy_id}

Description

Remove policy assignment from group

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	group_id required	Group ID Example : `a946662dc4314dac93da413a32457459`	string	None
path	policy_id required	Policy ID Example : `37f2e31ff86b415698d7e8eeafab445d`	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/groups/{group_id}/policy-bindings/{policy_id}

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.2"

Example HTTP response

Response 204

1.44.2 - 1.1

delete /v1/groups/{group_id}/policy-bindings/{policy_id}

Description

Remove policy assignment from group

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	group_id required	Group ID Example : `a946662dc4314dac93da413a32457459`	string	None
path	policy_id required	Policy ID Example : `37f2e31ff86b415698d7e8eeafab445d`	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/groups/{group_id}/policy-bindings/{policy_id}

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.1"

Example HTTP response

Response 204

1.44.3 - 1.0

delete /v1/groups/{group_id}/policy-bindings/{policy_id}

Description

Remove policy assignment from group

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	group_id required	Group ID Example : `a946662dc4314dac93da413a32457459`	string	None
path	policy_id required	Policy ID Example : `37f2e31ff86b415698d7e8eeafab445d`	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/groups/{group_id}/policy-bindings/{policy_id}

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 204

1.45 - Remove saml providers

1.45.1 - 1.2

delete /v1/saml-providers/bulk

Description

Remove saml providers

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
body	body required		ListSamlProviderRemoveRequest

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/saml-providers/bulk

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.2"

Request body

{
    "ids": [
        ""
    ]
}

Example HTTP response

Response 204

1.45.2 - 1.1

delete /v1/saml-providers/bulk

Description

Remove saml providers

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
body	body required		ListSamlProviderRemoveRequest

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/saml-providers/bulk

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.1"

Request body

{
    "ids": [
        ""
    ]
}

Example HTTP response

Response 204

1.45.3 - 1.0

delete /v1/saml-providers/bulk

Description

Remove saml providers

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
body	body required		ListSamlProviderRemoveRequest

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/saml-providers/bulk

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"

Request body

{
    "ids": [
        ""
    ]
}

Example HTTP response

Response 204

1.46 - Remove the access key

1.46.1 - 1.2

delete /v1/access-keys/{access_key_id}

Description

Remove the access key

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	access_key_id required	Access key ID Example : `f39c460fade34fecb05ede8f904b24b7`	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/access-keys/{access_key_id}

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.2"

Example HTTP response

Response 204

1.46.2 - 1.1

delete /v1/access-keys/{access_key_id}

Description

Remove the access key

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	access_key_id required	Access key ID Example : `f39c460fade34fecb05ede8f904b24b7`	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/access-keys/{access_key_id}

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.1"

Example HTTP response

Response 204

1.46.3 - 1.0

delete /v1/access-keys/{access_key_id}

Description

Remove the access key

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	access_key_id required	Access key ID Example : `f39c460fade34fecb05ede8f904b24b7`	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/access-keys/{access_key_id}

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 204

1.47 - Remove the access keys

1.47.1 - 1.2

delete /v1/access-keys/bulk

Description

Remove the access keys

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
body	body required		ListAccessKeyRemoveRequest

Responses

HTTP Code	Description	Schema
200	OK	ListAccessKeyResponse
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/access-keys/bulk

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.2"

Request body

{
    "ids": [
        ""
    ],
    "limit": 20,
    "marker": "607e0938521643b5b4b266f343fae693",
    "sort": "created_at:desc",
    "with_count": "true"
}

Example HTTP response

Response 200

{
    "access_keys": [
        {
            "access_key": "b754b12b39da4ce29a40c5e324650bd0",
            "access_key_type": "PERMANENT",
            "account_id": "f39c460fade34fecb05ede8f904b24b7",
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "description": "description",
            "expiration_timestamp": "9999-12-31T23:59:59Z",
            "id": "6558fc9df5b54c8a985465bdf637e097",
            "is_enabled": "true",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "parent_access_key_id": "92d6eid9e9ae4f868s842910k11573a3",
            "secret_key": "c4150149-f7c6-46bc-9faa-d2b9d20e0899"
        }
    ],
    "count": 20,
    "links": [
        {
            "href": "http://scp.samsungsdscloud.com/v1/access-keys?with_count=true&limit=20",
            "rel": "first"
        },
        {
            "href": "http://scp.samsungsdscloud.com/v1/access-keys?with_count=true&limit=20",
            "rel": "self"
        }
    ]
}

1.47.2 - 1.1

delete /v1/access-keys/bulk

Description

Remove the access keys

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
body	body required		ListAccessKeyRemoveRequest

Responses

HTTP Code	Description	Schema
200	OK	ListAccessKeyResponse
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/access-keys/bulk

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.1"

Request body

{
    "ids": [
        ""
    ],
    "limit": 20,
    "marker": "607e0938521643b5b4b266f343fae693",
    "sort": "created_at:desc",
    "with_count": "true"
}

Example HTTP response

Response 200

{
    "access_keys": [
        {
            "access_key": "b754b12b39da4ce29a40c5e324650bd0",
            "access_key_type": "PERMANENT",
            "account_id": "f39c460fade34fecb05ede8f904b24b7",
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "description": "description",
            "expiration_timestamp": "9999-12-31T23:59:59Z",
            "id": "6558fc9df5b54c8a985465bdf637e097",
            "is_enabled": "true",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "parent_access_key_id": "92d6eid9e9ae4f868s842910k11573a3",
            "secret_key": "c4150149-f7c6-46bc-9faa-d2b9d20e0899"
        }
    ],
    "count": 20,
    "links": [
        {
            "href": "http://scp.samsungsdscloud.com/v1/access-keys?with_count=true&limit=20",
            "rel": "first"
        },
        {
            "href": "http://scp.samsungsdscloud.com/v1/access-keys?with_count=true&limit=20",
            "rel": "self"
        }
    ]
}

1.47.3 - 1.0

delete /v1/access-keys/bulk

Description

Remove the access keys

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
body	body required		ListAccessKeyRemoveRequest

Responses

HTTP Code	Description	Schema
200	OK	ListAccessKeyResponse
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/access-keys/bulk

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"

Request body

{
    "ids": [
        ""
    ],
    "limit": 20,
    "marker": "607e0938521643b5b4b266f343fae693",
    "sort": "created_at:desc",
    "with_count": "true"
}

Example HTTP response

Response 200

{
    "access_keys": [
        {
            "access_key": "b754b12b39da4ce29a40c5e324650bd0",
            "access_key_type": "PERMANENT",
            "account_id": "f39c460fade34fecb05ede8f904b24b7",
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "description": "description",
            "expiration_timestamp": "9999-12-31T23:59:59Z",
            "id": "6558fc9df5b54c8a985465bdf637e097",
            "is_enabled": "true",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "parent_access_key_id": "92d6eid9e9ae4f868s842910k11573a3",
            "secret_key": "c4150149-f7c6-46bc-9faa-d2b9d20e0899"
        }
    ],
    "count": 20,
    "links": [
        {
            "href": "http://scp.samsungsdscloud.com/v1/access-keys?with_count=true&limit=20",
            "rel": "first"
        },
        {
            "href": "http://scp.samsungsdscloud.com/v1/access-keys?with_count=true&limit=20",
            "rel": "self"
        }
    ]
}

1.48 - Remove the Group

1.48.1 - 1.2

delete /v1/groups/{group_id}

Description

Remove the Group

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	group_id required	Group ID Example : `a946662dc4314dac93da413a32457459`	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/groups/{group_id}

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.2"

Example HTTP response

Response 204

1.48.2 - 1.1

delete /v1/groups/{group_id}

Description

Remove the Group

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	group_id required	Group ID Example : `a946662dc4314dac93da413a32457459`	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/groups/{group_id}

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.1"

Example HTTP response

Response 204

1.48.3 - 1.0

delete /v1/groups/{group_id}

Description

Remove the Group

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	group_id required	Group ID Example : `a946662dc4314dac93da413a32457459`	string	None

Responses

HTTP Code	Description	Schema
204	No Content	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/groups/{group_id}

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 204

1.49 - Send Temporary Access Key OTP

1.49.1 - 1.2

post /v1/access-keys/send-otp

Description

Send Temporary Access Key OTP

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
body	body required		AccessKeyOtpRequest

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/access-keys/send-otp

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.2"

Request body

{
    "locale": "ko_KR",
    "method": "PHONE"
}

Example HTTP response

Response 204

1.49.2 - 1.1

post /v1/access-keys/send-otp

Description

Send Temporary Access Key OTP

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
body	body required		AccessKeyOtpRequest

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/access-keys/send-otp

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.1"

Request body

{
    "locale": "ko_KR",
    "method": "PHONE"
}

Example HTTP response

Response 204

1.49.3 - 1.0

post /v1/access-keys/send-otp

Description

Send Temporary Access Key OTP

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
body	body required		AccessKeyOtpRequest

Responses

HTTP Code	Description	Schema
204	No Content	None
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/access-keys/send-otp

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"

Request body

{
    "locale": "ko_KR",
    "method": "PHONE"
}

Example HTTP response

Response 204

1.50 - Set a permission into the resource based policy

1.50.1 - 1.2

put /v1/resource-policies/{srn}/statements/{sid}

Description

Set a permission into the resource based policy

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	srn required	삼성 리소스 자원명 Example : `c3JuOmRldjI6OjEyMzQ1Njc4OTAxMDIzNDU2OTA6a3Itd2VzdDE6OnZpcnR1YWxzZXJ2ZXI6dmlydHVhbC1zZXJ2ZXIvYWJjZGUtMTIzNC01NTU1LTY2NjY=`	string	None
path	sid required	Statement ID Example : `Statement1`	string	None
body	body required		StatementCreateRequest

Responses

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

Example HTTP request

Request path

/v1/resource-policies/{srn}/statements/{sid}

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.2"

Request body

{
    "Action": [
        "virtualserver:ShowVirtualServer"
    ],
    "Condition": {
        "StringEquals": {
            "scp:RequestedRegion": [
                "kr-west1"
            ]
        }
    },
    "Effect": "Allow",
    "NotAction": [],
    "Principal": "*",
    "Resource": [
        "srn:dev2::1234567890102345690:kr-west1::virtualserver:virtual-server/abcde-1234-5555-6666"
    ],
    "Sid": "Statement1"
}

Example HTTP response

Response 200

{
    "Statement": {
        "Action": [
            "virtualserver:ShowVirtualServer"
        ],
        "Condition": {
            "StringEquals": {
                "scp:RequestedRegion": [
                    "kr-west1"
                ]
            }
        },
        "Effect": "Allow",
        "Principal": "*",
        "Resource": [
            "srn:dev2::1234567890102345690:kr-west1::virtualserver:virtual-server/abcde-1234-5555-6666"
        ],
        "Sid": "Statement1"
    }
}

1.50.2 - 1.1

put /v1/resource-policies/{srn}/statements/{sid}

Description

Set a permission into the resource based policy

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	srn required	삼성 리소스 자원명 Example : `c3JuOmRldjI6OjEyMzQ1Njc4OTAxMDIzNDU2OTA6a3Itd2VzdDE6OnZpcnR1YWxzZXJ2ZXI6dmlydHVhbC1zZXJ2ZXIvYWJjZGUtMTIzNC01NTU1LTY2NjY=`	string	None
path	sid required	Statement ID Example : `Statement1`	string	None
body	body required		StatementCreateRequest

Responses

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

Example HTTP request

Request path

/v1/resource-policies/{srn}/statements/{sid}

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.1"

Request body

{
    "Action": [
        "virtualserver:ShowVirtualServer"
    ],
    "Condition": {
        "StringEquals": {
            "scp:RequestedRegion": [
                "kr-west1"
            ]
        }
    },
    "Effect": "Allow",
    "NotAction": [],
    "Principal": "*",
    "Resource": [
        "srn:dev2::1234567890102345690:kr-west1::virtualserver:virtual-server/abcde-1234-5555-6666"
    ],
    "Sid": "Statement1"
}

Example HTTP response

Response 200

{
    "Statement": {
        "Action": [
            "virtualserver:ShowVirtualServer"
        ],
        "Condition": {
            "StringEquals": {
                "scp:RequestedRegion": [
                    "kr-west1"
                ]
            }
        },
        "Effect": "Allow",
        "Principal": "*",
        "Resource": [
            "srn:dev2::1234567890102345690:kr-west1::virtualserver:virtual-server/abcde-1234-5555-6666"
        ],
        "Sid": "Statement1"
    }
}

1.50.3 - 1.0

put /v1/resource-policies/{srn}/statements/{sid}

Description

Set a permission into the resource based policy

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	srn required	삼성 리소스 자원명 Example : `c3JuOmRldjI6OjEyMzQ1Njc4OTAxMDIzNDU2OTA6a3Itd2VzdDE6OnZpcnR1YWxzZXJ2ZXI6dmlydHVhbC1zZXJ2ZXIvYWJjZGUtMTIzNC01NTU1LTY2NjY=`	string	None
path	sid required	Statement ID Example : `Statement1`	string	None
body	body required		StatementCreateRequest

Responses

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

Example HTTP request

Request path

/v1/resource-policies/{srn}/statements/{sid}

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"

Request body

{
    "Action": [
        "virtualserver:ShowVirtualServer"
    ],
    "Condition": {
        "StringEquals": {
            "scp:RequestedRegion": [
                "kr-west1"
            ]
        }
    },
    "Effect": "Allow",
    "NotAction": [],
    "Principal": "*",
    "Resource": [
        "srn:dev2::1234567890102345690:kr-west1::virtualserver:virtual-server/abcde-1234-5555-6666"
    ],
    "Sid": "Statement1"
}

Example HTTP response

Response 200

{
    "Statement": {
        "Action": [
            "virtualserver:ShowVirtualServer"
        ],
        "Condition": {
            "StringEquals": {
                "scp:RequestedRegion": [
                    "kr-west1"
                ]
            }
        },
        "Effect": "Allow",
        "Principal": "*",
        "Resource": [
            "srn:dev2::1234567890102345690:kr-west1::virtualserver:virtual-server/abcde-1234-5555-6666"
        ],
        "Sid": "Statement1"
    }
}

1.51 - Set an access key

1.51.1 - 1.2

put /v1/access-keys/{access_key_id}

Description

Set or update an access key

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	access_key_id required	Access key ID Example : `f39c460fade34fecb05ede8f904b24b7`	string	None
body	body required		AccessKeyUpdateRequest

Responses

HTTP Code	Description	Schema
200	OK	AccessKeyResponse
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/access-keys/{access_key_id}

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.2"

Request body

{
    "is_enabled": "true"
}

Example HTTP response

Response 200

{
    "access_key": {
        "access_key": "b754b12b39da4ce29a40c5e324650bd0",
        "access_key_type": "PERMANENT",
        "account_id": "f39c460fade34fecb05ede8f904b24b7",
        "created_at": "2024-05-17T00:23:17Z",
        "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "description": "description",
        "expiration_timestamp": "9999-12-31T23:59:59Z",
        "id": "6558fc9df5b54c8a985465bdf637e097",
        "is_enabled": "true",
        "modified_at": "2024-05-17T00:23:17Z",
        "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "parent_access_key_id": "92d6eid9e9ae4f868s842910k11573a3",
        "secret_key": "c4150149-f7c6-46bc-9faa-d2b9d20e0899"
    }
}

1.51.2 - 1.1

put /v1/access-keys/{access_key_id}

Description

Set or update an access key

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	access_key_id required	Access key ID Example : `f39c460fade34fecb05ede8f904b24b7`	string	None
body	body required		AccessKeyUpdateRequest

Responses

HTTP Code	Description	Schema
200	OK	AccessKeyResponse
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/access-keys/{access_key_id}

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.1"

Request body

{
    "is_enabled": "true"
}

Example HTTP response

Response 200

{
    "access_key": {
        "access_key": "b754b12b39da4ce29a40c5e324650bd0",
        "access_key_type": "PERMANENT",
        "account_id": "f39c460fade34fecb05ede8f904b24b7",
        "created_at": "2024-05-17T00:23:17Z",
        "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "description": "description",
        "expiration_timestamp": "9999-12-31T23:59:59Z",
        "id": "6558fc9df5b54c8a985465bdf637e097",
        "is_enabled": "true",
        "modified_at": "2024-05-17T00:23:17Z",
        "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "parent_access_key_id": "92d6eid9e9ae4f868s842910k11573a3",
        "secret_key": "c4150149-f7c6-46bc-9faa-d2b9d20e0899"
    }
}

1.51.3 - 1.0

put /v1/access-keys/{access_key_id}

Description

Set or update an access key

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	access_key_id required	Access key ID Example : `f39c460fade34fecb05ede8f904b24b7`	string	None
body	body required		AccessKeyUpdateRequest

Responses

HTTP Code	Description	Schema
200	OK	AccessKeyResponse
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/access-keys/{access_key_id}

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"

Request body

{
    "is_enabled": "true"
}

Example HTTP response

Response 200

{
    "access_key": {
        "access_key": "b754b12b39da4ce29a40c5e324650bd0",
        "access_key_type": "PERMANENT",
        "account_id": "f39c460fade34fecb05ede8f904b24b7",
        "created_at": "2024-05-17T00:23:17Z",
        "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "description": "description",
        "expiration_timestamp": "9999-12-31T23:59:59Z",
        "id": "6558fc9df5b54c8a985465bdf637e097",
        "is_enabled": "true",
        "modified_at": "2024-05-17T00:23:17Z",
        "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
        "parent_access_key_id": "92d6eid9e9ae4f868s842910k11573a3",
        "secret_key": "c4150149-f7c6-46bc-9faa-d2b9d20e0899"
    }
}

1.52 - Set role

1.52.1 - 1.2

put /v1/roles/{role_id}

Description

Set role

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	role_id required	역할 ID Example :	string	None
body	body required		RoleSetRequest

Responses

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

Example HTTP request

Request path

/v1/roles/{role_id}

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.2"

Request body

{
    "description": "",
    "max_session_duration": 3600
}

Example HTTP response

Response 200

{
    "role": {
        "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"
    }
}

1.52.2 - 1.1

put /v1/roles/{role_id}

Description

Set role

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	role_id required	역할 ID Example :	string	None
body	body required		RoleSetRequest

Responses

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

Example HTTP request

Request path

/v1/roles/{role_id}

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.1"

Request body

{
    "description": "",
    "max_session_duration": 3600
}

Example HTTP response

Response 200

{
    "role": {
        "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"
    }
}

1.52.3 - 1.0

put /v1/roles/{role_id}

Description

Set role

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	role_id required	역할 ID Example :	string	None
body	body required		RoleSetRequest

Responses

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

Example HTTP request

Request path

/v1/roles/{role_id}

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"

Request body

{
    "description": "",
    "max_session_duration": 3600
}

Example HTTP response

Response 200

{
    "role": {
        "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"
    }
}

1.53 - Set role trust policy

1.53.1 - 1.2

put /v1/roles/{role_id}/trust-policy

Description

Set role trust policy

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	role_id required	역할 ID Example :	string	None
body	body required		RoleTrustPolicyRequest

Responses

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

Example HTTP request

Request path

/v1/roles/{role_id}/trust-policy

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.2"

Request body

{
    "assume_role_policy_document": {
        "Statement": [
            {
                "Action": [
                    "sts:AssumeRole"
                ],
                "Condition": {},
                "Effect": "Allow",
                "Principal": "srn:e:1234:::iam:user/abc1234",
                "Resource": [],
                "Sid": "statement1"
            }
        ],
        "Version": "2024-07-01"
    }
}

Example HTTP response

Response 200

{
    "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": "90dddfc2b1e04edba54ba2b41539a9ac",
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac"
}

1.53.2 - 1.1

put /v1/roles/{role_id}/trust-policy

Description

Set role trust policy

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	role_id required	역할 ID Example :	string	None
body	body required		RoleTrustPolicyRequest

Responses

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

Example HTTP request

Request path

/v1/roles/{role_id}/trust-policy

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.1"

Request body

{
    "assume_role_policy_document": {
        "Statement": [
            {
                "Action": [
                    "sts:AssumeRole"
                ],
                "Condition": {},
                "Effect": "Allow",
                "Principal": "srn:e:1234:::iam:user/abc1234",
                "Resource": [],
                "Sid": "statement1"
            }
        ],
        "Version": "2024-07-01"
    }
}

Example HTTP response

Response 200

{
    "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": "90dddfc2b1e04edba54ba2b41539a9ac",
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac"
}

1.53.3 - 1.0

put /v1/roles/{role_id}/trust-policy

Description

Set role trust policy

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	role_id required	역할 ID Example :	string	None
body	body required		RoleTrustPolicyRequest

Responses

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

Example HTTP request

Request path

/v1/roles/{role_id}/trust-policy

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"

Request body

{
    "assume_role_policy_document": {
        "Statement": [
            {
                "Action": [
                    "sts:AssumeRole"
                ],
                "Condition": {},
                "Effect": "Allow",
                "Principal": "srn:e:1234:::iam:user/abc1234",
                "Resource": [],
                "Sid": "statement1"
            }
        ],
        "Version": "2024-07-01"
    }
}

Example HTTP response

Response 200

{
    "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": "90dddfc2b1e04edba54ba2b41539a9ac",
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac"
}

1.54 - Set the policy

1.54.1 - 1.2

put /v1/policies/{policy_id}

Description

Set the policy

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	policy_id required	Policy ID Example : `37f2e31ff86b415698d7e8eeafab445d`	string	None
body	body required		PolicySetRequest

Responses

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

Example HTTP request

Request path

/v1/policies/{policy_id}

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.2"

Request body

{
    "default_version_id": "c1b1fc611eb34eccbccfb563f77395ee",
    "description": "Descriptions for policy",
    "policy_name": "Policy1",
    "policy_version": {
        "policy_document": {
            "Statement": [
                {
                    "Action": [
                        "iam:*"
                    ],
                    "Condition": {
                        "StringEquals": {
                            "scp:RequestedRegion": [
                                "kr-west1"
                            ]
                        }
                    },
                    "Effect": "Allow",
                    "Principal": null,
                    "Resource": [
                        "*"
                    ],
                    "Sid": "Statement1"
                }
            ],
            "Version": "2024-07-01"
        },
        "policy_id": "37f2e31ff86b415698d7e8eeafab445d",
        "policy_version_id": "c1b1fc611eb34eccbccfb563f77395ee",
        "policy_version_name": "PolicyVersion-1"
    }
}

Example HTTP response

Response 200

{
    "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"
}

1.54.2 - 1.1

put /v1/policies/{policy_id}

Description

Set the policy

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	policy_id required	Policy ID Example : `37f2e31ff86b415698d7e8eeafab445d`	string	None
body	body required		PolicySetRequest

Responses

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

Example HTTP request

Request path

/v1/policies/{policy_id}

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.1"

Request body

{
    "default_version_id": "c1b1fc611eb34eccbccfb563f77395ee",
    "description": "Descriptions for policy",
    "policy_name": "Policy1",
    "policy_version": {
        "policy_document": {
            "Statement": [
                {
                    "Action": [
                        "iam:*"
                    ],
                    "Condition": {
                        "StringEquals": {
                            "scp:RequestedRegion": [
                                "kr-west1"
                            ]
                        }
                    },
                    "Effect": "Allow",
                    "Principal": null,
                    "Resource": [
                        "*"
                    ],
                    "Sid": "Statement1"
                }
            ],
            "Version": "2024-07-01"
        },
        "policy_id": "37f2e31ff86b415698d7e8eeafab445d",
        "policy_version_id": "c1b1fc611eb34eccbccfb563f77395ee",
        "policy_version_name": "PolicyVersion-1"
    }
}

Example HTTP response

Response 200

{
    "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"
}

1.54.3 - 1.0

put /v1/policies/{policy_id}

Description

Set the policy

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	policy_id required	Policy ID Example : `37f2e31ff86b415698d7e8eeafab445d`	string	None
body	body required		PolicySetRequest

Responses

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

Example HTTP request

Request path

/v1/policies/{policy_id}

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"

Request body

{
    "default_version_id": "c1b1fc611eb34eccbccfb563f77395ee",
    "description": "Descriptions for policy",
    "policy_name": "Policy1",
    "policy_version": {
        "policy_document": {
            "Statement": [
                {
                    "Action": [
                        "iam:*"
                    ],
                    "Condition": {
                        "StringEquals": {
                            "scp:RequestedRegion": [
                                "kr-west1"
                            ]
                        }
                    },
                    "Effect": "Allow",
                    "Principal": null,
                    "Resource": [
                        "*"
                    ],
                    "Sid": "Statement1"
                }
            ],
            "Version": "2024-07-01"
        },
        "policy_id": "37f2e31ff86b415698d7e8eeafab445d",
        "policy_version_id": "c1b1fc611eb34eccbccfb563f77395ee",
        "policy_version_name": "PolicyVersion-1"
    }
}

Example HTTP response

Response 200

{
    "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"
}

1.55 - Set the policy group binding

1.55.1 - 1.2

put /v1/policies/{policy_id}/bindings

Description

Set the policy group binding

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	policy_id required	Policy ID Example : `37f2e31ff86b415698d7e8eeafab445d`	string	None
body	body required		PolicyBindingSetRequest

Responses

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

Example HTTP request

Request path

/v1/policies/{policy_id}/bindings

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.2"

Request body

{
    "add_ids": [
        "a946662dc4314dac93da413a32457459"
    ],
    "identity_type": "GROUP",
    "remove_ids": [
        "a946662dc4314dac93da413a32457459"
    ]
}

Example HTTP response

Response 200

{
    "count": 20,
    "groups": [
        {
            "created_at": "2025-03-26T10:18:04Z",
            "created_by": "4a816a3f5099442ebb52daefc1f7be32",
            "creator_email": "-",
            "creator_name": "-",
            "description": "openapi-ga2-test-group",
            "domain_name": "scp",
            "id": "19fca177a57940daa5817960373c6542",
            "modified_at": "2025-03-26T10:18:04Z",
            "modified_by": "4a816a3f5099442ebb52daefc1f7be32",
            "modifier_email": "-",
            "modifier_name": "-",
            "name": "openapi-ga2-testgroup5",
            "policies": [],
            "roles": [],
            "srn": "srn:dev2::1d9cc99917ff41bb992276ac0ae9e4c8:::iam:group/19fca177a57940daa5817960373c6542",
            "type": "USER_DEFINED"
        }
    ],
    "page": 0,
    "policy_id": "37f2e31ff86b415698d7e8eeafab445d",
    "roles": [
        {
            "account_id": "d7aba97100564b34a0f4f77c4bc7a303",
            "assume_role_policy_document": {
                "Statement": [
                    {
                        "Action": "*",
                        "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": "string",
            "id": "f39c460fade34fecb05ede8f904b24b7",
            "max_session_duration": 0,
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "ef50cdc207f05f6fb8f20219f229ed1f",
            "modifier_email": "-",
            "modifier_name": "-",
            "name": "string",
            "type": "DEFAULT"
        }
    ],
    "size": 20,
    "sort": [
        "created_at:asc"
    ],
    "users": [
        {
            "access_control": false,
            "account_id": "d7aba97100564b34a0f4f77c4bc7a303",
            "account_name": "",
            "allowed_ip_addresses": "",
            "company_name": "",
            "created_at": "2024-11-15T06:57:42.000000Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "description": "",
            "domain_name": "scp",
            "dst_offset": "+09:00",
            "email": "samsung.kim@samsung.com",
            "email_authenticate_code": "8ada8861bad2423295e4bb576bee5886",
            "email_authenticated": true,
            "first_name": "",
            "groups": [],
            "id": "90dddfc2b1e04edba54ba2b41539a9ac",
            "keycloak_id": "127e3d8c-66dc-4b1b-b38b-9a1d0c6d5507",
            "keystone_credential": "",
            "last_login_at": "2024-11-25T06:57:42.000000Z",
            "last_name": "",
            "last_password_update_at": "",
            "login_id": "",
            "modified_at": "2024-11-17T06:57:42.000000Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "nation_id": "+82",
            "phone_authenticated": false,
            "phone_number": "0000000000",
            "policies": [],
            "state": "ACTIVE",
            "temporary_password": false,
            "term_region_id": "1",
            "timezone": "Asia/Seoul",
            "type": "IAM",
            "tz_id": "Asia/Seoul",
            "user_name": "Kim Samsung",
            "utc_offset": "+09:00"
        }
    ]
}

1.55.2 - 1.1

put /v1/policies/{policy_id}/bindings

Description

Set the policy group binding

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	policy_id required	Policy ID Example : `37f2e31ff86b415698d7e8eeafab445d`	string	None
body	body required		PolicyBindingSetRequest

Responses

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

Example HTTP request

Request path

/v1/policies/{policy_id}/bindings

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.1"

Request body

{
    "add_ids": [
        "a946662dc4314dac93da413a32457459"
    ],
    "identity_type": "GROUP",
    "remove_ids": [
        "a946662dc4314dac93da413a32457459"
    ]
}

Example HTTP response

Response 200

{
    "count": 20,
    "groups": [
        {
            "created_at": "2025-03-26T10:18:04Z",
            "created_by": "4a816a3f5099442ebb52daefc1f7be32",
            "creator_email": "-",
            "creator_name": "-",
            "description": "openapi-ga2-test-group",
            "domain_name": "scp",
            "id": "19fca177a57940daa5817960373c6542",
            "modified_at": "2025-03-26T10:18:04Z",
            "modified_by": "4a816a3f5099442ebb52daefc1f7be32",
            "modifier_email": "-",
            "modifier_name": "-",
            "name": "openapi-ga2-testgroup5",
            "policies": [],
            "roles": [],
            "srn": "srn:dev2::1d9cc99917ff41bb992276ac0ae9e4c8:::iam:group/19fca177a57940daa5817960373c6542",
            "type": "USER_DEFINED"
        }
    ],
    "page": 0,
    "policy_id": "37f2e31ff86b415698d7e8eeafab445d",
    "roles": [
        {
            "account_id": "d7aba97100564b34a0f4f77c4bc7a303",
            "assume_role_policy_document": {
                "Statement": [
                    {
                        "Action": "*",
                        "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": "string",
            "id": "f39c460fade34fecb05ede8f904b24b7",
            "max_session_duration": 0,
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "ef50cdc207f05f6fb8f20219f229ed1f",
            "modifier_email": "-",
            "modifier_name": "-",
            "name": "string",
            "type": "DEFAULT"
        }
    ],
    "size": 20,
    "sort": [
        "created_at:asc"
    ],
    "users": [
        {
            "access_control": false,
            "account_id": "d7aba97100564b34a0f4f77c4bc7a303",
            "account_name": "",
            "allowed_ip_addresses": "",
            "company_name": "",
            "created_at": "2024-11-15T06:57:42.000000Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "description": "",
            "domain_name": "scp",
            "dst_offset": "+09:00",
            "email": "samsung.kim@samsung.com",
            "email_authenticate_code": "8ada8861bad2423295e4bb576bee5886",
            "email_authenticated": true,
            "first_name": "",
            "groups": [],
            "id": "90dddfc2b1e04edba54ba2b41539a9ac",
            "keycloak_id": "127e3d8c-66dc-4b1b-b38b-9a1d0c6d5507",
            "keystone_credential": "",
            "last_login_at": "2024-11-25T06:57:42.000000Z",
            "last_name": "",
            "last_password_update_at": "",
            "login_id": "",
            "modified_at": "2024-11-17T06:57:42.000000Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "nation_id": "+82",
            "phone_authenticated": false,
            "phone_number": "0000000000",
            "policies": [],
            "state": "ACTIVE",
            "temporary_password": false,
            "term_region_id": "1",
            "timezone": "Asia/Seoul",
            "type": "IAM",
            "tz_id": "Asia/Seoul",
            "user_name": "Kim Samsung",
            "utc_offset": "+09:00"
        }
    ]
}

1.55.3 - 1.0

put /v1/policies/{policy_id}/bindings

Description

Set the policy group binding

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	policy_id required	Policy ID Example : `37f2e31ff86b415698d7e8eeafab445d`	string	None
body	body required		PolicyBindingSetRequest

Responses

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

Example HTTP request

Request path

/v1/policies/{policy_id}/bindings

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"

Request body

{
    "add_ids": [
        "a946662dc4314dac93da413a32457459"
    ],
    "identity_type": "GROUP",
    "remove_ids": [
        "a946662dc4314dac93da413a32457459"
    ]
}

Example HTTP response

Response 200

{
    "count": 20,
    "groups": [
        {
            "created_at": "2025-03-26T10:18:04Z",
            "created_by": "4a816a3f5099442ebb52daefc1f7be32",
            "creator_email": "-",
            "creator_name": "-",
            "description": "openapi-ga2-test-group",
            "domain_name": "scp",
            "id": "19fca177a57940daa5817960373c6542",
            "modified_at": "2025-03-26T10:18:04Z",
            "modified_by": "4a816a3f5099442ebb52daefc1f7be32",
            "modifier_email": "-",
            "modifier_name": "-",
            "name": "openapi-ga2-testgroup5",
            "policies": [],
            "roles": [],
            "srn": "srn:dev2::1d9cc99917ff41bb992276ac0ae9e4c8:::iam:group/19fca177a57940daa5817960373c6542",
            "type": "USER_DEFINED"
        }
    ],
    "page": 0,
    "policy_id": "37f2e31ff86b415698d7e8eeafab445d",
    "roles": [
        {
            "account_id": "d7aba97100564b34a0f4f77c4bc7a303",
            "assume_role_policy_document": {
                "Statement": [
                    {
                        "Action": "*",
                        "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": "string",
            "id": "f39c460fade34fecb05ede8f904b24b7",
            "max_session_duration": 0,
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "ef50cdc207f05f6fb8f20219f229ed1f",
            "modifier_email": "-",
            "modifier_name": "-",
            "name": "string",
            "type": "DEFAULT"
        }
    ],
    "size": 20,
    "sort": [
        "created_at:asc"
    ],
    "users": [
        {
            "access_control": false,
            "account_id": "d7aba97100564b34a0f4f77c4bc7a303",
            "account_name": "",
            "allowed_ip_addresses": "",
            "company_name": "",
            "created_at": "2024-11-15T06:57:42.000000Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "description": "",
            "domain_name": "scp",
            "dst_offset": "+09:00",
            "email": "samsung.kim@samsung.com",
            "email_authenticate_code": "8ada8861bad2423295e4bb576bee5886",
            "email_authenticated": true,
            "first_name": "",
            "groups": [],
            "id": "90dddfc2b1e04edba54ba2b41539a9ac",
            "keycloak_id": "127e3d8c-66dc-4b1b-b38b-9a1d0c6d5507",
            "keystone_credential": "",
            "last_login_at": "2024-11-25T06:57:42.000000Z",
            "last_name": "",
            "last_password_update_at": "",
            "login_id": "",
            "modified_at": "2024-11-17T06:57:42.000000Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "nation_id": "+82",
            "phone_authenticated": false,
            "phone_number": "0000000000",
            "policies": [],
            "state": "ACTIVE",
            "temporary_password": false,
            "term_region_id": "1",
            "timezone": "Asia/Seoul",
            "type": "IAM",
            "tz_id": "Asia/Seoul",
            "user_name": "Kim Samsung",
            "utc_offset": "+09:00"
        }
    ]
}

1.56 - Set the resource based policy

1.56.1 - 1.2

put /v1/resource-policies/{srn}

Description

Set the resource based policy

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	srn required	삼성 리소스 자원명 Example : `c3JuOmRldjI6OjEyMzQ1Njc4OTAxMDIzNDU2OTA6a3Itd2VzdDE6OnZpcnR1YWxzZXJ2ZXI6dmlydHVhbC1zZXJ2ZXIvYWJjZGUtMTIzNC01NTU1LTY2NjY=`	string	None
body	body required		ResourcePolicySetRequest

Responses

HTTP Code	Description	Schema
200	OK	ResourcePolicyShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
409	Conflict	None

Example HTTP request

Request path

/v1/resource-policies/{srn}

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.2"

Request body

{
    "policy_version": {
        "policy_document": {
            "Statement": [
                {
                    "Action": [
                        "virtualserver:ShowVirtualServer"
                    ],
                    "Condition": {
                        "StringEquals": {
                            "scp:RequestedRegion": [
                                "kr-west1"
                            ]
                        }
                    },
                    "Effect": "Allow",
                    "Principal": "*",
                    "Resource": [
                        "srn:dev2::1234567890102345690:kr-west1::virtualserver:virtual-server/abcde-1234-5555-6666"
                    ],
                    "Sid": "Statement1"
                }
            ],
            "Version": "2024-07-01"
        },
        "policy_id": "37f2e31ff86b415698d7e8eeafab445d",
        "policy_version_id": "c1b1fc611eb34eccbccfb563f77395ee",
        "policy_version_name": "PolicyVersion-1"
    }
}

Example HTTP response

Response 200

{
    "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": "f39c460fade34fecb05ede8f904b24b7",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "modifier_email": "samsung.kim@samsung.com",
    "modifier_name": "Kim Samsung",
    "policy_category": "RESOURCE_BASED",
    "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": [
                            "virtualserver:ShowVirtualServer"
                        ],
                        "Condition": {
                            "StringEquals": {
                                "scp:RequestedRegion": [
                                    "kr-west1"
                                ]
                            }
                        },
                        "Effect": "Allow",
                        "Principal": "*",
                        "Resource": [
                            "srn:dev2::1234567890102345690:kr-west1::virtualserver:virtual-server/abcde-1234-5555-6666"
                        ],
                        "Sid": "Statement1"
                    }
                ],
                "Version": "2024-07-01"
            }
        }
    ],
    "service_name": "Identity Access Management"
}

1.56.2 - 1.1

put /v1/resource-policies/{srn}

Description

Set the resource based policy

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	srn required	삼성 리소스 자원명 Example : `c3JuOmRldjI6OjEyMzQ1Njc4OTAxMDIzNDU2OTA6a3Itd2VzdDE6OnZpcnR1YWxzZXJ2ZXI6dmlydHVhbC1zZXJ2ZXIvYWJjZGUtMTIzNC01NTU1LTY2NjY=`	string	None
body	body required		ResourcePolicySetRequest

Responses

HTTP Code	Description	Schema
200	OK	ResourcePolicyShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
409	Conflict	None

Example HTTP request

Request path

/v1/resource-policies/{srn}

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.1"

Request body

{
    "policy_version": {
        "policy_document": {
            "Statement": [
                {
                    "Action": [
                        "virtualserver:ShowVirtualServer"
                    ],
                    "Condition": {
                        "StringEquals": {
                            "scp:RequestedRegion": [
                                "kr-west1"
                            ]
                        }
                    },
                    "Effect": "Allow",
                    "Principal": "*",
                    "Resource": [
                        "srn:dev2::1234567890102345690:kr-west1::virtualserver:virtual-server/abcde-1234-5555-6666"
                    ],
                    "Sid": "Statement1"
                }
            ],
            "Version": "2024-07-01"
        },
        "policy_id": "37f2e31ff86b415698d7e8eeafab445d",
        "policy_version_id": "c1b1fc611eb34eccbccfb563f77395ee",
        "policy_version_name": "PolicyVersion-1"
    }
}

Example HTTP response

Response 200

{
    "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": "f39c460fade34fecb05ede8f904b24b7",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "modifier_email": "samsung.kim@samsung.com",
    "modifier_name": "Kim Samsung",
    "policy_category": "RESOURCE_BASED",
    "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": [
                            "virtualserver:ShowVirtualServer"
                        ],
                        "Condition": {
                            "StringEquals": {
                                "scp:RequestedRegion": [
                                    "kr-west1"
                                ]
                            }
                        },
                        "Effect": "Allow",
                        "Principal": "*",
                        "Resource": [
                            "srn:dev2::1234567890102345690:kr-west1::virtualserver:virtual-server/abcde-1234-5555-6666"
                        ],
                        "Sid": "Statement1"
                    }
                ],
                "Version": "2024-07-01"
            }
        }
    ],
    "service_name": "Identity Access Management"
}

1.56.3 - 1.0

put /v1/resource-policies/{srn}

Description

Set the resource based policy

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	srn required	삼성 리소스 자원명 Example : `c3JuOmRldjI6OjEyMzQ1Njc4OTAxMDIzNDU2OTA6a3Itd2VzdDE6OnZpcnR1YWxzZXJ2ZXI6dmlydHVhbC1zZXJ2ZXIvYWJjZGUtMTIzNC01NTU1LTY2NjY=`	string	None
body	body required		ResourcePolicySetRequest

Responses

HTTP Code	Description	Schema
200	OK	ResourcePolicyShowResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
409	Conflict	None

Example HTTP request

Request path

/v1/resource-policies/{srn}

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"

Request body

{
    "policy_version": {
        "policy_document": {
            "Statement": [
                {
                    "Action": [
                        "virtualserver:ShowVirtualServer"
                    ],
                    "Condition": {
                        "StringEquals": {
                            "scp:RequestedRegion": [
                                "kr-west1"
                            ]
                        }
                    },
                    "Effect": "Allow",
                    "Principal": "*",
                    "Resource": [
                        "srn:dev2::1234567890102345690:kr-west1::virtualserver:virtual-server/abcde-1234-5555-6666"
                    ],
                    "Sid": "Statement1"
                }
            ],
            "Version": "2024-07-01"
        },
        "policy_id": "37f2e31ff86b415698d7e8eeafab445d",
        "policy_version_id": "c1b1fc611eb34eccbccfb563f77395ee",
        "policy_version_name": "PolicyVersion-1"
    }
}

Example HTTP response

Response 200

{
    "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": "f39c460fade34fecb05ede8f904b24b7",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "modifier_email": "samsung.kim@samsung.com",
    "modifier_name": "Kim Samsung",
    "policy_category": "RESOURCE_BASED",
    "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": [
                            "virtualserver:ShowVirtualServer"
                        ],
                        "Condition": {
                            "StringEquals": {
                                "scp:RequestedRegion": [
                                    "kr-west1"
                                ]
                            }
                        },
                        "Effect": "Allow",
                        "Principal": "*",
                        "Resource": [
                            "srn:dev2::1234567890102345690:kr-west1::virtualserver:virtual-server/abcde-1234-5555-6666"
                        ],
                        "Sid": "Statement1"
                    }
                ],
                "Version": "2024-07-01"
            }
        }
    ],
    "service_name": "Identity Access Management"
}

1.57 - Show group policy

1.57.1 - 1.2

get /v1/groups/{group_id}/policy-bindings

Description

Show group policy

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	group_id required	Group ID Example : `a946662dc4314dac93da413a32457459`	string	None
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	policy_id optional	Policy Id Example : `37f2e31ff86b415698d7e8eeafab445d`	any of [string, null]	None
query	policy_name optional	Policy Name Example : `ViewerAccess`	any of [string, null]	None
query	policy_type optional	Policy Type List Example : `['SYSTEM_MANAGED', 'USER_DEFINED']`	any of [string, array[string], null]	None

Responses

HTTP Code	Description	Schema
200	OK	GroupPolicyPageResponse
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/groups/{group_id}/policy-bindings

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.2"

Example HTTP response

Response 200

{
    "count": 20,
    "page": 0,
    "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"
        }
    ],
    "size": 20,
    "sort": [
        "created_at:asc"
    ]
}

1.57.2 - 1.1

get /v1/groups/{group_id}/policy-bindings

Description

Show group policy

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	group_id required	Group ID Example : `a946662dc4314dac93da413a32457459`	string	None
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	policy_id optional	Policy Id Example : `37f2e31ff86b415698d7e8eeafab445d`	any of [string, null]	None
query	policy_name optional	Policy Name Example : `ViewerAccess`	any of [string, null]	None
query	policy_type optional	Policy Type List Example : `['SYSTEM_MANAGED', 'USER_DEFINED']`	any of [string, array[string], null]	None

Responses

HTTP Code	Description	Schema
200	OK	GroupPolicyPageResponse
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/groups/{group_id}/policy-bindings

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.1"

Example HTTP response

Response 200

{
    "count": 20,
    "page": 0,
    "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"
        }
    ],
    "size": 20,
    "sort": [
        "created_at:asc"
    ]
}

1.57.3 - 1.0

get /v1/groups/{group_id}/policy-bindings

Description

Show group policy

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	group_id required	Group ID Example : `a946662dc4314dac93da413a32457459`	string	None
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	policy_id optional	Policy Id Example : `37f2e31ff86b415698d7e8eeafab445d`	any of [string, null]	None
query	policy_name optional	Policy Name Example : `ViewerAccess`	any of [string, null]	None
query	policy_type optional	Policy Type List Example : `['SYSTEM_MANAGED', 'USER_DEFINED']`	any of [string, array[string], null]	None

Responses

HTTP Code	Description	Schema
200	OK	GroupPolicyPageResponse
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/groups/{group_id}/policy-bindings

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,
    "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"
        }
    ],
    "size": 20,
    "sort": [
        "created_at:asc"
    ]
}

1.58 - Show the policy

1.58.1 - 1.2

get /v1/policies/{policy_id}

Description

Show the policy

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	policy_id required	Policy ID Example : `37f2e31ff86b415698d7e8eeafab445d`	string	None

Responses

HTTP Code	Description	Schema
200	OK	PolicyShowResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/policies/{policy_id}

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.2"

Example HTTP response

Response 200

{
    "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"
}

1.58.2 - 1.1

get /v1/policies/{policy_id}

Description

Show the policy

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	policy_id required	Policy ID Example : `37f2e31ff86b415698d7e8eeafab445d`	string	None

Responses

HTTP Code	Description	Schema
200	OK	PolicyShowResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/policies/{policy_id}

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.1"

Example HTTP response

Response 200

{
    "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"
}

1.58.3 - 1.0

get /v1/policies/{policy_id}

Description

Show the policy

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	policy_id required	Policy ID Example : `37f2e31ff86b415698d7e8eeafab445d`	string	None

Responses

HTTP Code	Description	Schema
200	OK	PolicyShowResponse
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/policies/{policy_id}

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

{
    "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"
}

1.59 - Show the resource based policy

1.59.1 - 1.2

get /v1/resource-policies/{srn}

Description

Show the resource based policy

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	srn required	삼성 리소스 자원명 Example : `c3JuOmRldjI6OjEyMzQ1Njc4OTAxMDIzNDU2OTA6a3Itd2VzdDE6OnZpcnR1YWxzZXJ2ZXI6dmlydHVhbC1zZXJ2ZXIvYWJjZGUtMTIzNC01NTU1LTY2NjY=`	string	None

Responses

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

Example HTTP request

Request path

/v1/resource-policies/{srn}

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.2"

Example HTTP response

Response 200

{
    "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": "f39c460fade34fecb05ede8f904b24b7",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "modifier_email": "samsung.kim@samsung.com",
    "modifier_name": "Kim Samsung",
    "policy_category": "RESOURCE_BASED",
    "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": [
                            "virtualserver:ShowVirtualServer"
                        ],
                        "Condition": {
                            "StringEquals": {
                                "scp:RequestedRegion": [
                                    "kr-west1"
                                ]
                            }
                        },
                        "Effect": "Allow",
                        "Principal": "*",
                        "Resource": [
                            "srn:dev2::1234567890102345690:kr-west1::virtualserver:virtual-server/abcde-1234-5555-6666"
                        ],
                        "Sid": "Statement1"
                    }
                ],
                "Version": "2024-07-01"
            }
        }
    ],
    "service_name": "Identity Access Management"
}

1.59.2 - 1.1

get /v1/resource-policies/{srn}

Description

Show the resource based policy

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	srn required	삼성 리소스 자원명 Example : `c3JuOmRldjI6OjEyMzQ1Njc4OTAxMDIzNDU2OTA6a3Itd2VzdDE6OnZpcnR1YWxzZXJ2ZXI6dmlydHVhbC1zZXJ2ZXIvYWJjZGUtMTIzNC01NTU1LTY2NjY=`	string	None

Responses

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

Example HTTP request

Request path

/v1/resource-policies/{srn}

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.1"

Example HTTP response

Response 200

{
    "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": "f39c460fade34fecb05ede8f904b24b7",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "modifier_email": "samsung.kim@samsung.com",
    "modifier_name": "Kim Samsung",
    "policy_category": "RESOURCE_BASED",
    "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": [
                            "virtualserver:ShowVirtualServer"
                        ],
                        "Condition": {
                            "StringEquals": {
                                "scp:RequestedRegion": [
                                    "kr-west1"
                                ]
                            }
                        },
                        "Effect": "Allow",
                        "Principal": "*",
                        "Resource": [
                            "srn:dev2::1234567890102345690:kr-west1::virtualserver:virtual-server/abcde-1234-5555-6666"
                        ],
                        "Sid": "Statement1"
                    }
                ],
                "Version": "2024-07-01"
            }
        }
    ],
    "service_name": "Identity Access Management"
}

1.59.3 - 1.0

get /v1/resource-policies/{srn}

Description

Show the resource based policy

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	srn required	삼성 리소스 자원명 Example : `c3JuOmRldjI6OjEyMzQ1Njc4OTAxMDIzNDU2OTA6a3Itd2VzdDE6OnZpcnR1YWxzZXJ2ZXI6dmlydHVhbC1zZXJ2ZXIvYWJjZGUtMTIzNC01NTU1LTY2NjY=`	string	None

Responses

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

Example HTTP request

Request path

/v1/resource-policies/{srn}

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

{
    "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": "f39c460fade34fecb05ede8f904b24b7",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "modifier_email": "samsung.kim@samsung.com",
    "modifier_name": "Kim Samsung",
    "policy_category": "RESOURCE_BASED",
    "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": [
                            "virtualserver:ShowVirtualServer"
                        ],
                        "Condition": {
                            "StringEquals": {
                                "scp:RequestedRegion": [
                                    "kr-west1"
                                ]
                            }
                        },
                        "Effect": "Allow",
                        "Principal": "*",
                        "Resource": [
                            "srn:dev2::1234567890102345690:kr-west1::virtualserver:virtual-server/abcde-1234-5555-6666"
                        ],
                        "Sid": "Statement1"
                    }
                ],
                "Version": "2024-07-01"
            }
        }
    ],
    "service_name": "Identity Access Management"
}

1.60 - Update IAM user

1.60.1 - 1.2

put /v1/accounts/{account_id}/users/{user_id}

Description

Update IAM user

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	account_id required	Account ID Example :	string	None
path	user_id required	User ID Example :	string	None
body	body required		IAMUserUpdateRequest

Responses

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

Example HTTP request

Request path

/v1/accounts/{account_id}/users/{user_id}

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.2"

Request body

{
    "description": "",
    "password_reuse_count": ""
}

Example HTTP response

Response 200

{
    "account_id": "",
    "company_name": "",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "description": "",
    "dst_offset": "",
    "email": "",
    "email_authenticated": "",
    "first_name": "",
    "id": "",
    "last_login_at": "",
    "last_name": "",
    "last_password_update_at": "",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "",
    "password_reuse_count": "",
    "phone_authenticated": "",
    "policies": [],
    "state": "",
    "timezone": "",
    "type": "",
    "tz_id": "",
    "user_name": "",
    "utc_offset": ""
}

1.60.2 - 1.1

put /v1/accounts/{account_id}/users/{user_id}

Description

Update IAM user

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	account_id required	Account ID Example :	string	None
path	user_id required	User ID Example :	string	None
body	body required		IAMUserUpdateRequest

Responses

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

Example HTTP request

Request path

/v1/accounts/{account_id}/users/{user_id}

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.1"

Request body

{
    "description": "",
    "password_reuse_count": ""
}

Example HTTP response

Response 200

{
    "account_id": "",
    "company_name": "",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "description": "",
    "dst_offset": "",
    "email": "",
    "email_authenticated": "",
    "first_name": "",
    "id": "",
    "last_login_at": "",
    "last_name": "",
    "last_password_update_at": "",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "",
    "password_reuse_count": "",
    "phone_authenticated": "",
    "policies": [],
    "state": "",
    "timezone": "",
    "type": "",
    "tz_id": "",
    "user_name": "",
    "utc_offset": ""
}

1.60.3 - 1.0

put /v1/accounts/{account_id}/users/{user_id}

Description

Update IAM user

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	account_id required	Account ID Example :	string	None
path	user_id required	User ID Example :	string	None
body	body required		IAMUserUpdateRequest

Responses

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

Example HTTP request

Request path

/v1/accounts/{account_id}/users/{user_id}

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"

Request body

{
    "description": "",
    "password_reuse_count": ""
}

Example HTTP response

Response 200

{
    "account_id": "",
    "company_name": "",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "description": "",
    "dst_offset": "",
    "email": "",
    "email_authenticated": "",
    "first_name": "",
    "id": "",
    "last_login_at": "",
    "last_name": "",
    "last_password_update_at": "",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "",
    "password_reuse_count": "",
    "phone_authenticated": "",
    "policies": [],
    "state": "",
    "timezone": "",
    "type": "",
    "tz_id": "",
    "user_name": "",
    "utc_offset": ""
}

1.61 - Update IAM user password

1.61.1 - 1.2

put /v1/accounts/{account_id}/users/{user_id}/password

Description

Update IAM user password

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	account_id required	Account ID Example :	string	None
path	user_id required	User ID Example :	string	None
body	body required		IAMUserPasswordUpdateRequest

Responses

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

Example HTTP request

Request path

/v1/accounts/{account_id}/users/{user_id}/password

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.2"

Request body

{
    "password": "",
    "temporary_password": false
}

Example HTTP response

Response 200

{
    "account_id": "",
    "company_name": "",
    "console_url": "",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "description": "",
    "dst_offset": "",
    "email": "",
    "email_authenticated": "",
    "first_name": "",
    "id": "",
    "last_login_at": "",
    "last_name": "",
    "last_password_update_at": "",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "",
    "password": "",
    "password_reuse_count": "",
    "phone_authenticated": "",
    "policies": [],
    "state": "",
    "timezone": "",
    "type": "",
    "tz_id": "",
    "user_name": "",
    "utc_offset": ""
}

1.61.2 - 1.1

put /v1/accounts/{account_id}/users/{user_id}/password

Description

Update IAM user password

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	account_id required	Account ID Example :	string	None
path	user_id required	User ID Example :	string	None
body	body required		IAMUserPasswordUpdateRequest

Responses

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

Example HTTP request

Request path

/v1/accounts/{account_id}/users/{user_id}/password

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.1"

Request body

{
    "password": "",
    "temporary_password": false
}

Example HTTP response

Response 200

{
    "account_id": "",
    "company_name": "",
    "console_url": "",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "description": "",
    "dst_offset": "",
    "email": "",
    "email_authenticated": "",
    "first_name": "",
    "id": "",
    "last_login_at": "",
    "last_name": "",
    "last_password_update_at": "",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "",
    "password": "",
    "password_reuse_count": "",
    "phone_authenticated": "",
    "policies": [],
    "state": "",
    "timezone": "",
    "type": "",
    "tz_id": "",
    "user_name": "",
    "utc_offset": ""
}

1.61.3 - 1.0

put /v1/accounts/{account_id}/users/{user_id}/password

Description

Update IAM user password

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	account_id required	Account ID Example :	string	None
path	user_id required	User ID Example :	string	None
body	body required		IAMUserPasswordUpdateRequest

Responses

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

Example HTTP request

Request path

/v1/accounts/{account_id}/users/{user_id}/password

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"

Request body

{
    "password": "",
    "temporary_password": false
}

Example HTTP response

Response 200

{
    "account_id": "",
    "company_name": "",
    "console_url": "",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "description": "",
    "dst_offset": "",
    "email": "",
    "email_authenticated": "",
    "first_name": "",
    "id": "",
    "last_login_at": "",
    "last_name": "",
    "last_password_update_at": "",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "name": "",
    "password": "",
    "password_reuse_count": "",
    "phone_authenticated": "",
    "policies": [],
    "state": "",
    "timezone": "",
    "type": "",
    "tz_id": "",
    "user_name": "",
    "utc_offset": ""
}

1.62 - Update saml provider information

1.62.1 - 1.2

put /v1/saml-providers/{saml_provider_id}

Description

Update saml provider information

State ACTIVE (CURRENT)

Version	Supported Until
1.2	-

Parameters

Type	Name	Description	Schema	Default
path	saml_provider_id required	자격증명공급자 ID Example :	string	None
body	body required		SamlProviderUpdateRequestData

Responses

HTTP Code	Description	Schema
200	OK	SamlProviderDetailResponse
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/saml-providers/{saml_provider_id}

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.2,"
"Content-Type = multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW"

Request body

------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="description"

SAML provider Description
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="file"; filename="keycloak-idp-saml.xml"
Content-Type: application/xml

(data)
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="saml_provider_name"

IdpTest
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="tags"

[{'key': 'company', 'value': 'SDS'}]
------WebKitFormBoundary7MA4YWxkTrZu0gW--

Example HTTP response

Response 200

{
    "account_id": "",
    "acs_url": "",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "creator_name": "",
    "description": "",
    "federation_type": "",
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "idp_cert_end": "",
    "idp_file_data": "",
    "idp_file_name": "",
    "idp_file_size": "",
    "idp_issuer_url": "",
    "idp_sso_url": "",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "modifier_name": "",
    "saml_provider_name": ""
}

1.62.2 - 1.1

put /v1/saml-providers/{saml_provider_id}

Description

Update saml provider information

State ACTIVE (SUPPORTED)

Version	Supported Until
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	saml_provider_id required	자격증명공급자 ID Example :	string	None
body	body required		SamlProviderUpdateRequestData

Responses

HTTP Code	Description	Schema
200	OK	SamlProviderDetailResponse
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/saml-providers/{saml_provider_id}

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.1,"
"Content-Type = multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW"

Request body

------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="description"

SAML provider Description
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="file"; filename="keycloak-idp-saml.xml"
Content-Type: application/xml

(data)
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="saml_provider_name"

IdpTest
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="tags"

[{'key': 'company', 'value': 'SDS'}]
------WebKitFormBoundary7MA4YWxkTrZu0gW--

Example HTTP response

Response 200

{
    "account_id": "",
    "acs_url": "",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "creator_name": "",
    "description": "",
    "federation_type": "",
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "idp_cert_end": "",
    "idp_file_data": "",
    "idp_file_name": "",
    "idp_file_size": "",
    "idp_issuer_url": "",
    "idp_sso_url": "",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "modifier_name": "",
    "saml_provider_name": ""
}

1.62.3 - 1.0

put /v1/saml-providers/{saml_provider_id}

Description

Update saml provider information

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	saml_provider_id required	자격증명공급자 ID Example :	string	None
body	body required		SamlProviderUpdateRequestData

Responses

HTTP Code	Description	Schema
200	OK	SamlProviderDetailResponse
400	Bad Request	None
401	Unauthorized	None
404	Not Found	None

Example HTTP request

Request path

/v1/saml-providers/{saml_provider_id}

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,"
"Content-Type = multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW"

Request body

------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="description"

SAML provider Description
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="file"; filename="keycloak-idp-saml.xml"
Content-Type: application/xml

(data)
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="saml_provider_name"

IdpTest
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="tags"

[{'key': 'company', 'value': 'SDS'}]
------WebKitFormBoundary7MA4YWxkTrZu0gW--

Example HTTP response

Response 200

{
    "account_id": "",
    "acs_url": "",
    "created_at": "2024-05-17T00:23:17Z",
    "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "creator_name": "",
    "description": "",
    "federation_type": "",
    "id": "0fdd87aab8cb46f59b7c1f81ed03fb3e",
    "idp_cert_end": "",
    "idp_file_data": "",
    "idp_file_name": "",
    "idp_file_size": "",
    "idp_issuer_url": "",
    "idp_sso_url": "",
    "modified_at": "2024-05-17T00:23:17Z",
    "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
    "modifier_name": "",
    "saml_provider_name": ""
}

2 - Models

2.1 - AccessKey

Name	Description	Schema
access_key required	Access Key Example : `b754b12b39da4ce29a40c5e324650bd0`	string
access_key_type required	Access key type Example : `PERMANENT`	enum (PERMANENT, TEMPORARY, SECRET_VAULT_TEMPORARY)
account_id required	Account Id Example : `f39c460fade34fecb05ede8f904b24b7`	string
created_at required	Created At Example : `2024-05-17T00:23:17Z`	string (date-time)
created_by required	Created By Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
description optional	Description Example : `description`	any of [string, null]
expiration_timestamp required	Access key expiration timestamp Example : `9999-12-31T23:59:59Z`	string (date-time)
id required	ID Example : `6558fc9df5b54c8a985465bdf637e097`	string
is_enabled required	활성화 여부 Example : `true`	boolean
modified_at required	Modified At Example : `2024-05-17T00:23:17Z`	string (date-time)
modified_by required	Modified By Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
parent_access_key_id required	Parent access key ID which is used for temporary access key to create by Example : `92d6eid9e9ae4f868s842910k11573a3`	any of [string, null]
secret_key required	Secret Key Example : `c4150149-f7c6-46bc-9faa-d2b9d20e0899`	string

2.2 - AccessKeyCreateRequest

Name	Description	Schema
access_key_type required	Access key type Example : `PERMANENT`	enum (PERMANENT, TEMPORARY)
account_id optional	Account Id Example : `f39c460fade34fecb05ede8f904b24b7`	string
description optional	Description Example : `description`	any of [string, null]
duration optional	Expiration duration Example : `P1Y2M10DT2H30M15S`	any of [string, null]
parent_access_key_id optional	Required access key for creating temporary access key Example : `92d6eid9e9ae4f868s842910k11573a3`	any of [string, null]
passcode optional	Required for temporary access key Example : `000000`	any of [string, null]

2.3 - AccessKeyOtpRequest

Name	Description	Schema	Default
locale optional	Locale Example : `ko_KR`	enum (ko_KR, en_US)
method optional	OTP method (EMAIL or PHONE) Example : `PHONE`	enum (PHONE, EMAIL)

2.4 - AccessKeyResponse

Name	Description	Schema	Default
access_key required		AccessKey

2.5 - AccessKeyUpdateRequest

Name	Description	Schema	Default
is_enabled optional	활성화 여부 Example : `true`	boolean	True

2.6 - CreatedGroupMember

Name	Description	Schema	Default
created_at required	생성 일시 Example : `2024-05-17T00:23:17Z`	string (date-time)
created_by required	생성자 Example : `ef50cdc207f05f6fb8f20219f229ed1f`	string
creator_email optional	생성자 Email Example : `samsung.kim@samsung.com`	string	-
creator_name optional	생성자 성, 이름 Example : `Kim Samsung`	string	-
user_email optional	User Email Example : `samsung.kim@samsung.com`	string	-
user_id required	User ID Example : `f39c460fade34fecb05ede8f904b24b7`	string
user_name optional	User 성, 이름 Example : `Kim Samsung`	string	-

2.7 - EndpointsResponse

Name	Description	Schema
region required	Region Example : `kr-west1`	string
service_name required	Service name Example : `scp-iam`	string
service_type required	Service type Example : `scp-iam`	string
url required	URL Example : `https://iam.dev2.samsungsdscloud.com`	string

2.8 - Group

Name	Description	Schema	Default
created_at required	생성 일시 Example : `2024-05-17T00:23:17Z`	string (date-time)
created_by required	생성자 Example : `ef50cdc207f05f6fb8f20219f229ed1f`	string
creator_email optional	생성자 Email Example : `samsung.kim@samsung.com`	string	-
creator_name optional	생성자 성, 이름 Example : `Kim Samsung`	string	-
description required	Group 설명 Example : `Descriptions for group`	any of [string, null]
domain_name required	도메인 이름 Example : `scp`	string
id required	ID Example : `f39c460fade34fecb05ede8f904b24b7`	string
members optional	Project Group Member List	any of [array[GroupMember], null]
modified_at required	수정 일시 Example : `2024-05-17T00:23:17Z`	string (date-time)
modified_by required	수정자 Example : `ef50cdc207f05f6fb8f20219f229ed1f`	string
modifier_email optional	수정자 Email Example : `samsung.kim@samsung.com`	string	-
modifier_name optional	수정자 성, 이름 Example : `Kim Samsung`	string	-
name required	Group 이름 Example : `TestGroup` Pattern : `^[a-zA-Z0-9\-.,_+=@ㄱ-ㅎㅏ-ㅣ가-힣]$` Minimum length* : `3` Maximum length : `24`	string
policies required	Policy	any of [array[Policy], null]
resource_type optional	리소스 명 Example : `group`	any of [string, null]	group
roles required	Role 정보	any of [array[Role], null]
service_name optional	서비스 Display 명 Example : `Identity Access Management`	any of [string, null]	Identity Access Management
service_type optional	서비스 명 Example : `iam`	any of [string, null]	iam
srn optional	Group SRN Example : `srn:dev1:::::iam:group/0e0688b33641451a83d2ab8878666fda`	any of [string, null]
type required	Group Type Example : `USER_DEFINED`	string

2.9 - GroupCreateRequest

Name	Description	Schema
description required	Group 설명 Example : `Descriptions for group`	any of [string, null]
name required	Group 이름 Example : `TestGroup` Pattern : `^[a-zA-Z0-9\-.,_+=@ㄱ-ㅎㅏ-ㅣ가-힣]$` Minimum length* : `3` Maximum length : `24`	string
policy_ids optional	Group Policy ID List Example : `['37f2e31ff86b415698d7e8eeafab445d']`	any of [array[string], null]
tags optional	Group Tag Example : `[{'key': 'company', 'value': 'SDS'}]`	any of [array[object[string]], null]
user_ids optional	Group Member User ID List Example : `['f39c460fade34fecb05ede8f904b24b7']`	any of [array[string], null]

2.10 - GroupMember

Name	Description	Schema	Default
created_at required	생성 일시 Example : `2024-05-17T00:23:17Z`	string (date-time)
created_by required	생성자 Example : `ef50cdc207f05f6fb8f20219f229ed1f`	string
creator_created_at required	생성 일시 Example : `2024-05-17T00:23:17Z`	string (date-time)
creator_email optional	생성자 Email Example : `samsung.kim@samsung.com`	string	-
creator_last_login_at optional	Group Member last login at Example : `2024-05-17T00:23:17Z`	any of [string (date-time), null]
creator_name optional	생성자 성, 이름 Example : `Kim Samsung`	string	-
group_names optional	Group names Example : `['TestGroup', 'SampleGroup']`	array[string]
user_created_at required	생성 일시 Example : `2024-05-17T00:23:17Z`	string (date-time)
user_email optional	User Email Example : `samsung.kim@samsung.com`	string	-
user_id required	User ID Example : `f39c460fade34fecb05ede8f904b24b7`	string
user_last_login_at optional	Group Member last login at Example : `2024-05-17T00:23:17Z`	any of [string (date-time), null]
user_name optional	User 성, 이름 Example : `Kim Samsung`	string	-

2.11 - GroupMemberCreateRequest

Name	Description	Schema	Default
user_id required	Group Member User ID Example : `f39c460fade34fecb05ede8f904b24b7`	string

2.12 - GroupMemberCreateResponse

Name	Description	Schema	Default
group_member required		CreatedGroupMember

2.13 - GroupMemberPageResponse

Name	Description	Schema
count required	count Example : `20`	integer
group_members required		array[GroupMember]
page required	page Example : `0`	integer
size required	size Example : `20`	integer
sort optional	sort Example : `['created_at:asc']`	any of [array[string], null]

2.14 - GroupPageResponse

Name	Description	Schema
count required	count Example : `20`	integer
groups required		array[Group]
page required	page Example : `0`	integer
size required	size Example : `20`	integer
sort optional	sort Example : `['created_at:asc']`	any of [array[string], null]

2.15 - GroupPolicyBindingRequest

Name	Description	Schema	Default
policy_ids required	Policy ID List Example : `['37f2e31ff86b415698d7e8eeafab445d']`	array[string]

2.16 - GroupPolicyPageResponse

Name	Description	Schema
count required	count Example : `20`	integer
page required	page Example : `0`	integer
policies required		array[Policy]
size required	size Example : `20`	integer
sort optional	sort Example : `['created_at:asc']`	any of [array[string], null]

2.17 - GroupPolicyResponse

Name	Description	Schema	Default
policies required		array[Policy]

2.18 - GroupSetRequest

Name	Description	Schema	Default
description required	Group 설명 Example : `Descriptions for group`	any of [string, null]
name required	Group 이름 Example : `TestGroup` Pattern : `^[a-zA-Z0-9\-.,_+=@ㄱ-ㅎㅏ-ㅣ가-힣]$` Minimum length* : `3` Maximum length : `24`	string

2.19 - GroupShowResponse

Name	Description	Schema	Default
group required		Group

2.20 - IAMCreateUserResponse

Name	Description	Schema
account_id optional	Account ID Example :	any of [string, null]
company_name optional	회사 이름 Example :	any of [string, null]
console_url required	Console URL Example :	string
created_at required	Created At Example : `2024-05-17T00:23:17Z`	string (date-time)
created_by required	Created By Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
description optional	User Description Example :	any of [string, null]
dst_offset optional	DST Offset Example :	any of [string, null]
email optional	User Email Example :	any of [string, null]
email_authenticated required	email 인증 여부 Example :	boolean
first_name optional	사용자 이름 Example :	any of [string, null]
id required	ID Example :	string
last_login_at optional	마지막 로그인 Example :	any of [string (date-time), null]
last_name optional	사용자 성 Example :	any of [string, null]
last_password_update_at optional	마지막 비밀번호 수정시간 Example :	any of [string (date-time), null]
modified_at required	Modified At Example : `2024-05-17T00:23:17Z`	string (date-time)
modified_by required	Modified By Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
name optional	Name Example :	any of [string, null]
password required	비밀 번호 Example :	string
password_reuse_count required	비밀 번호 재사용 가능 횟수 Example :	integer
phone_authenticated required	휴대폰 인증 여부 Example :	boolean
policies required	User Policies	any of [array[Policy], null]
state optional	상태 Example :	any of [string, null]
timezone optional	Timezone ID Example :	any of [string, null]
type required	Type Example :	string
tz_id optional	Timezone ID Example :	any of [string, null]
user_name optional	User Name Example :	any of [string, null]
utc_offset optional	UTC Offset Example :	any of [string, null]

2.21 - IamPolicyDocument

Name	Description	Schema	Default
Statement required	Statement	array[Statement]
Version required	Policy Version Example : `2024-07-01`	string

2.22 - IAMUserCreateRequest

Name	Description	Schema
description optional	description Example :	any of [string, null]
group_ids optional	Group IDs Example :	any of [array[string], null]
password required	비밀 번호 Example :	string
policy_ids optional	Policy IDs Example :	any of [array[string], null]
tags optional	User Tag Example :	any of [array[object[string]], null]
temporary_password required	temporary Example :	boolean
user_name required	사용자 이름 Example : Pattern : `^[a-zA-Z0-9\+\.\@\-\_]$` Maximum length* : `64`	string

2.23 - IAMUserDeleteRequest

Name	Description	Schema	Default
user_ids optional	사용자 ID 목록 Example :	any of [array[string], null]

2.24 - IAMUserDetailResponse

Name	Description	Schema	Default
account_id optional	Account ID Example :	any of [string, null]
company_name optional	회사 이름 Example :	any of [string, null]
created_at required	Created At Example : `2024-05-17T00:23:17Z`	string (date-time)
created_by required	Created By Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
created_by_name optional	created_by_name Example :	any of [string, null]
description optional	User Description Example :	any of [string, null]
dst_offset optional	DST Offset Example :	any of [string, null]
email optional	User Email Example :	any of [string, null]
email_authenticated required	email 인증 여부 Example :	boolean
first_name optional	사용자 이름 Example :	any of [string, null]
id required	ID Example :	string
last_login_at optional	마지막 로그인 Example :	any of [string (date-time), null]
last_name optional	사용자 성 Example :	any of [string, null]
last_password_update_at optional	마지막 비밀번호 수정시간 Example :	any of [string (date-time), null]
modified_at required	Modified At Example : `2024-05-17T00:23:17Z`	string (date-time)
modified_by required	Modified By Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
modified_by_name optional	modified_by_name Example :	any of [string, null]
name optional	Name Example :	any of [string, null]
password_reuse_count required	비밀 번호 재사용 가능 횟수 Example :	integer
phone_authenticated required	휴대폰 인증 여부 Example :	boolean
policies required	User Policies	any of [array[Policy], null]
resource_type optional	service Example : `User`	any of [string, null]	User
service optional	서비스 명 Example : `iam`	any of [string, null]	iam
service_name optional	서비스 Display 명 Example : `Identity Access Management`	any of [string, null]	Identity Access Management
srn required	SRN Example :	any of [string, null]
state optional	상태 Example :	any of [string, null]
timezone optional	Timezone ID Example :	any of [string, null]
type required	Type Example :	string
tz_id optional	Timezone ID Example :	any of [string, null]
user_name optional	User Name Example :	any of [string, null]
utc_offset optional	UTC Offset Example :	any of [string, null]

2.25 - IAMUserPasswordUpdateRequest

Name	Description	Schema	Default
password required	비밀 번호 Example :	string
temporary_password optional	temporary Example : `False`	any of [boolean, null]

2.26 - IAMUserResponse

Name	Description	Schema
account_id optional	Account ID Example :	any of [string, null]
company_name optional	회사 이름 Example :	any of [string, null]
created_at required	Created At Example : `2024-05-17T00:23:17Z`	string (date-time)
created_by required	Created By Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
description optional	User Description Example :	any of [string, null]
dst_offset optional	DST Offset Example :	any of [string, null]
email optional	User Email Example :	any of [string, null]
email_authenticated required	email 인증 여부 Example :	boolean
first_name optional	사용자 이름 Example :	any of [string, null]
groups optional	group names Example :	any of [array[string], null]
id required	ID Example :	string
last_login_at optional	마지막 로그인 Example :	any of [string (date-time), null]
last_name optional	사용자 성 Example :	any of [string, null]
last_password_update_at optional	마지막 비밀번호 수정시간 Example :	any of [string (date-time), null]
modified_at required	Modified At Example : `2024-05-17T00:23:17Z`	string (date-time)
modified_by required	Modified By Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
name optional	Name Example :	any of [string, null]
password_reuse_count required	비밀 번호 재사용 가능 횟수 Example :	integer
phone_authenticated required	휴대폰 인증 여부 Example :	boolean
policies required	User Policies	any of [array[Policy], null]
state optional	상태 Example :	any of [string, null]
timezone optional	Timezone ID Example :	any of [string, null]
type required	Type Example :	string
tz_id optional	Timezone ID Example :	any of [string, null]
user_name optional	User Name Example :	any of [string, null]
utc_offset optional	UTC Offset Example :	any of [string, null]

2.27 - IAMUserUpdateRequest

Name	Description	Schema	Default
description optional	description Example :	any of [string, null]
password_reuse_count required	비밀 번호 재사용 가능 횟수 Example : Maximum : `24`	integer

2.28 - ListAccessKeyRemoveRequest

Name	Description	Schema
ids optional	Access key id list	array[string]
limit optional	limit Example : `20`	any of [integer, null]
marker optional	marker Example : `607e0938521643b5b4b266f343fae693`	any of [string, null]
sort optional	sort Example : `created_at:desc`	any of [string, null]
with_count optional	with count Example : `true`	any of [string, null]

2.29 - ListAccessKeyResponse

Name	Description	Schema
access_keys required		array[AccessKey]
count optional	total count Example : `20`	any of [integer, null]
links optional	links Example : `[{'href': 'http://scp.samsungsdscloud.com/v1/access-keys?with_count=true&limit=20', 'rel': 'first'}, {'href': 'http://scp.samsungsdscloud.com/v1/access-keys?with_count=true&limit=20', 'rel': 'self'}]`	any of [array[object], null]

2.30 - ListEndpointsResponse

Name	Description	Schema	Default
endpoints required		array[EndpointsResponse]

2.31 - ListIAMUserResponse

Name	Description	Schema
count required	count Example : `20`	integer
page required	page Example : `0`	integer
size required	size Example : `20`	integer
sort optional	sort Example : `['created_at:asc']`	any of [array[string], null]
users required		array[IAMUserResponse]

2.32 - ListPolicyRemoveRequest

Name	Description	Schema	Default
ids optional	Policy id list Example : `['37f2e31ff86b415698d7e8eeafab445d']`	array[string]

2.33 - ListSamlProviderRemoveRequest

Name	Description	Schema	Default
ids optional	Saml provider id list	array[string]

2.34 - ListSamlProviderResponse

Name	Description	Schema
count required	count Example : `20`	integer
page required	page Example : `0`	integer
saml_providers required		array[SamlProviderResponse]
size required	size Example : `20`	integer
sort optional	sort Example : `['created_at:asc']`	any of [array[string], null]

2.35 - Policy

Name	Description	Schema	Default
account_id required	Project Id Example : `e99c73a8690d4ae39ae75e38a26f2b99`	any of [string, null]
created_at required	Created At Example : `2024-05-17T00:23:17Z`	string (date-time)
created_by required	Created By Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
creator_email optional	생성자 Email Example : `samsung.kim@samsung.com`	any of [string, null]
creator_name optional	생성자 성, 이름 Example : `Kim Samsung`	any of [string, null]
default_version_id optional	Policy Default Version Id Example : `c1b1fc611eb34eccbccfb563f77395ee`	string
description optional	Description Example : `Descriptions for policy`	any of [string, null]
domain_name required	도메인 이름 Example : `scp`	string
id optional	Policy ID Example : `37f2e31ff86b415698d7e8eeafab445d`	string
modified_at required	Modified At Example : `2024-05-17T00:23:17Z`	string (date-time)
modified_by required	Modified By Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
modifier_email optional	수정자 Email Example : `samsung.kim@samsung.com`	any of [string, null]
modifier_name optional	수정자 성, 이름 Example : `Kim Samsung`	any of [string, null]
policy_category optional	Policy Category Example : `IDENTITY_BASED`	enum (IDENTITY_BASED, RESOURCE_BASED, SESSION)
policy_name optional	Policy Name Example : `PolicyName` Pattern : `^[a-zA-Z0-9\-.,_+=@ㄱ-ㅎㅏ-ㅣ가-힣]$` Minimum length* : `3` Maximum length : `128`	string
policy_type optional	Policy Type Example : `USER_DEFINED`	enum (SYSTEM_MANAGED, USER_DEFINED, INLINE)
policy_versions optional	Policy Versions	array[PolicyVersion]
resource_type optional	Resource Type Example : `policy`	any of [string, null]	policy
service_name optional	서비스 Display 명 Example : `Identity Access Management`	any of [string, null]	Identity Access Management
service_type optional	Service Type Example : `iam`	any of [string, null]	iam
srn required	삼성 리소스 자원명 Example : `srn:qa2:::::iam:policy/37f2e31ff86b415698d7e8eeafab445d`	string
state optional	Policy State Example : `ACTIVE`	enum (ACTIVE, INACTIVE, DELETED)	ACTIVE

2.36 - PolicyBindingPageResponse

Name	Description	Schema
count required	count Example : `20`	integer
groups optional	Group Example : [{'created_at': '2025-03-26T10:18:04Z', 'created_by': '4a816a3f5099442ebb52daefc1f7be32', 'creator_email': '-', 'creator_name': '-', 'description': 'openapi-ga2-test-group', 'domain_name': 'scp', 'id': '19fca177a57940daa5817960373c6542', 'modified_at': '2025-03-26T10:18:04Z', 'modified_by': '4a816a3f5099442ebb52daefc1f7be32', 'modifier_email': '-', 'modifier_name': '-', 'name': 'openapi-ga2-testgroup5', 'policies': [], 'roles': [], 'srn': 'srn:dev2::1d9cc99917ff41bb992276ac0ae9e4c8:::iam:group/19fca177a57940daa5817960373c6542', 'type': 'USER_DEFINED'}]	any of [array[object], null]
page required	page Example : `0`	integer
policy_id optional	Policy ID Example : `37f2e31ff86b415698d7e8eeafab445d`	string
roles optional	Role Example : [{'account_id': 'd7aba97100564b34a0f4f77c4bc7a303', 'assume_role_policy_document': {'Statement': [{'Action': '', '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': 'string', 'id': 'f39c460fade34fecb05ede8f904b24b7', 'max_session_duration': 0, 'modified_at': '2024-05-17T00:23:17Z', 'modified_by': 'ef50cdc207f05f6fb8f20219f229ed1f', 'modifier_email': '-', 'modifier_name': '-', 'name': 'string', 'type': 'DEFAULT'}]	any of [array[object], null]
size required	size Example : `20`	integer
sort optional	sort Example : `['created_at:asc']`	any of [array[string], null]
users optional	User Example : [{'access_control': False, 'account_id': 'd7aba97100564b34a0f4f77c4bc7a303', 'account_name': '', 'allowed_ip_addresses': '', 'company_name': '', 'created_at': '2024-11-15T06:57:42.000000Z', 'created_by': '90dddfc2b1e04edba54ba2b41539a9ac', 'description': '', 'domain_name': 'scp', 'dst_offset': '+09:00', 'email': 'samsung.kim@samsung.com', 'email_authenticate_code': '8ada8861bad2423295e4bb576bee5886', 'email_authenticated': True, 'first_name': '', 'groups': [], 'id': '90dddfc2b1e04edba54ba2b41539a9ac', 'keycloak_id': '127e3d8c-66dc-4b1b-b38b-9a1d0c6d5507', 'keystone_credential': '', 'last_login_at': '2024-11-25T06:57:42.000000Z', 'last_name': '', 'last_password_update_at': '', 'login_id': '', 'modified_at': '2024-11-17T06:57:42.000000Z', 'modified_by': '90dddfc2b1e04edba54ba2b41539a9ac', 'nation_id': '+82', 'phone_authenticated': False, 'phone_number': '0000000000', 'policies': [], 'state': 'ACTIVE', 'temporary_password': False, 'term_region_id': '1', 'timezone': 'Asia/Seoul', 'type': 'IAM', 'tz_id': 'Asia/Seoul', 'user_name': 'Kim Samsung', 'utc_offset': '+09:00'}]	any of [array[object], null]

2.37 - PolicyBindingSetRequest

Name	Description	Schema
add_ids optional	ID List Example : `['a946662dc4314dac93da413a32457459']`	any of [array[string], null]
identity_type required	Identity Type Example : `GROUP`	string
remove_ids optional	ID List Example : `['a946662dc4314dac93da413a32457459']`	any of [array[string], null]

2.38 - PolicyCreateRequest

Name	Description	Schema	Default
default_version_id optional	Default Version Id Example : `c1b1fc611eb34eccbccfb563f77395ee`	any of [string, null]
description optional	Description Example : `Descriptions for policy`	any of [string, null]
policy_category optional	Policy Category Example : `IDENTITY_BASED`	enum (IDENTITY_BASED, RESOURCE_BASED, SESSION)	IDENTITY_BASED
policy_name required	Policy Name Example : `PolicyName` Pattern : `^[a-zA-Z0-9\-.,_+=@ㄱ-ㅎㅏ-ㅣ가-힣]$` Minimum length* : `3` Maximum length : `128`	string
policy_type optional	Policy Type Example : `USER_DEFINED`	enum (SYSTEM_MANAGED, USER_DEFINED, INLINE)	USER_DEFINED
policy_version required	Policy Version	PolicyVersionCreateRequest
service_type optional	Service Type Example : `scp-iam`	any of [string, null]
tags optional	Policy Tag Example : `[{'key': 'foo', 'value': 'bar'}]`	any of [array[object[string]], null]

2.39 - PolicyDocument

Name	Description	Schema	Default
Statement required	Statement	array[Statement]
Version required	Policy Version Example : `2024-07-01`	string

2.40 - PolicyPageResponse

Name	Description	Schema
count required	count Example : `20`	integer
page required	page Example : `0`	integer
policies required		array[Policy]
size required	size Example : `20`	integer
sort optional	sort Example : `['created_at:asc']`	any of [array[string], null]

2.41 - PolicyQueryRequest

Name	Description	Schema	Default
excluded_policy_ids optional	제외할 Policy IDs Example : `['37f2e31ff86b415698d7e8eeafab445d']`	any of [array[string], null]

2.42 - PolicySetRequest

Name	Description	Schema
default_version_id optional	Policy Default Version Id Example : `c1b1fc611eb34eccbccfb563f77395ee`	any of [string, null]
description optional	Description Example : `Descriptions for policy`	any of [string, null]
policy_name optional	Policy Name Example : `Policy1` Pattern : `^[a-zA-Z0-9\-.,_+=@ㄱ-ㅎㅏ-ㅣ가-힣]*$`	any of [string, null]
policy_version optional	Policy Versions	any of [PolicyVersionCreateRequest, null]

2.43 - PolicyShowResponse

Name	Description	Schema	Default
account_id required	Project Id Example : `e99c73a8690d4ae39ae75e38a26f2b99`	any of [string, null]
created_at required	Created At Example : `2024-05-17T00:23:17Z`	string (date-time)
created_by required	Created By Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
creator_email optional	생성자 Email Example : `samsung.kim@samsung.com`	any of [string, null]
creator_name optional	생성자 성, 이름 Example : `Kim Samsung`	any of [string, null]
default_version_id optional	Policy Default Version Id Example : `c1b1fc611eb34eccbccfb563f77395ee`	string
description optional	Description Example : `Descriptions for policy`	any of [string, null]
domain_name required	도메인 이름 Example : `scp`	string
id optional	Policy ID Example : `37f2e31ff86b415698d7e8eeafab445d`	string
modified_at required	Modified At Example : `2024-05-17T00:23:17Z`	string (date-time)
modified_by required	Modified By Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
modifier_email optional	수정자 Email Example : `samsung.kim@samsung.com`	any of [string, null]
modifier_name optional	수정자 성, 이름 Example : `Kim Samsung`	any of [string, null]
policy_category optional	Policy Category Example : `IDENTITY_BASED`	enum (IDENTITY_BASED, RESOURCE_BASED, SESSION)
policy_name optional	Policy Name Example : `PolicyName` Pattern : `^[a-zA-Z0-9\-.,_+=@ㄱ-ㅎㅏ-ㅣ가-힣]$` Minimum length* : `3` Maximum length : `128`	string
policy_type optional	Policy Type Example : `USER_DEFINED`	enum (SYSTEM_MANAGED, USER_DEFINED, INLINE)
policy_versions optional	Policy Versions	array[PolicyVersion]
resource_type optional	Resource Type Example : `policy`	any of [string, null]	policy
service_name optional	서비스 Display 명 Example : `Identity Access Management`	any of [string, null]	Identity Access Management
service_type optional	Service Type Example : `iam`	any of [string, null]	iam
srn required	삼성 리소스 자원명 Example : `srn:qa2:::::iam:policy/37f2e31ff86b415698d7e8eeafab445d`	string
state optional	Policy State Example : `ACTIVE`	enum (ACTIVE, INACTIVE, DELETED)	ACTIVE

2.44 - PolicyVersion

Name	Description	Schema
created_at required	Created At Example : `2024-05-17T00:23:17Z`	string (date-time)
created_by required	Created By Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
id optional	Policy Version Id Example : `c1b1fc611eb34eccbccfb563f77395ee`	string
modified_at required	Modified At Example : `2024-05-17T00:23:17Z`	string (date-time)
modified_by required	Modified By Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
policy_document required	Policy Document	IamPolicyDocument
policy_id optional	Policy ID Example : `37f2e31ff86b415698d7e8eeafab445d`	string
policy_version_name optional	Policy Version Name Example : `PolicyVersion-1`	string

2.45 - PolicyVersionCreateRequest

Name	Description	Schema	Default
policy_document required	Policy Document Example : `{'Statement': [{'Action': ['iam:'], 'Condition': {'StringEquals': {'scp:RequestedRegion': ['kr-west1']}}, 'Effect': 'Allow', 'Principal': None, 'Resource': [''], 'Sid': 'Statement1'}], 'Version': '2024-07-01'}`	IamPolicyDocument
policy_id optional	Policy ID Example : `37f2e31ff86b415698d7e8eeafab445d`	string
policy_version_id optional	Policy Version Id Example : `c1b1fc611eb34eccbccfb563f77395ee`	string
policy_version_name optional	Policy Version Name Example : `PolicyVersion-1`	string	POLICY_VERSION_1

2.46 - ResourcePolicySetRequest

Name	Description	Schema	Default
policy_version required	Description	ResourcePolicyVersionCreateRequest

2.47 - ResourcePolicyShowResponse

Name	Description	Schema	Default
account_id required	Project Id Example : `e99c73a8690d4ae39ae75e38a26f2b99`	any of [string, null]
created_at required	Created At Example : `2024-05-17T00:23:17Z`	string (date-time)
created_by required	Created By Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
creator_email optional	생성자 Email Example : `samsung.kim@samsung.com`	any of [string, null]
creator_name optional	생성자 성, 이름 Example : `Kim Samsung`	any of [string, null]
default_version_id optional	Policy Default Version Id Example : `f39c460fade34fecb05ede8f904b24b7`	string
modified_at required	Modified At Example : `2024-05-17T00:23:17Z`	string (date-time)
modified_by required	Modified By Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
modifier_email optional	수정자 Email Example : `samsung.kim@samsung.com`	any of [string, null]
modifier_name optional	수정자 성, 이름 Example : `Kim Samsung`	any of [string, null]
policy_category optional	Policy Category Example : `RESOURCE_BASED`	enum (IDENTITY_BASED, RESOURCE_BASED, SESSION)
policy_type optional	Policy Type Example : `USER_DEFINED`	enum (SYSTEM_MANAGED, USER_DEFINED, INLINE)
policy_versions optional	Policy Versions	array[ResourcePolicyVersion]
service_name optional	서비스 Display 명 Example : `Identity Access Management`	any of [string, null]	Identity Access Management

2.48 - ResourcePolicyVersion

Name	Description	Schema
created_at required	Created At Example : `2024-05-17T00:23:17Z`	string (date-time)
created_by required	Created By Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
id optional	Policy Version Id Example : `c1b1fc611eb34eccbccfb563f77395ee`	string
modified_at required	Modified At Example : `2024-05-17T00:23:17Z`	string (date-time)
modified_by required	Modified By Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
policy_document required	Policy Document Example : `{'Statement': [{'Action': ['virtualserver:ShowVirtualServer'], 'Condition': {'StringEquals': {'scp:RequestedRegion': ['kr-west1']}}, 'Effect': 'Allow', 'Principal': '*', 'Resource': ['srn:dev2::1234567890102345690:kr-west1::virtualserver:virtual-server/abcde-1234-5555-6666'], 'Sid': 'Statement1'}], 'Version': '2024-07-01'}`	IamPolicyDocument

2.49 - ResourcePolicyVersionCreateRequest

Name	Description	Schema	Default
policy_document required	Policy Document Example : `{'Statement': [{'Action': ['virtualserver:ShowVirtualServer'], 'Condition': {'StringEquals': {'scp:RequestedRegion': ['kr-west1']}}, 'Effect': 'Allow', 'Principal': '*', 'Resource': ['srn:dev2::1234567890102345690:kr-west1::virtualserver:virtual-server/abcde-1234-5555-6666'], 'Sid': 'Statement1'}], 'Version': '2024-07-01'}`	IamPolicyDocument
policy_id optional	Policy ID Example : `37f2e31ff86b415698d7e8eeafab445d`	any of [string, null]
policy_version_id optional	Policy Version Id Example : `c1b1fc611eb34eccbccfb563f77395ee`	any of [string, null]
policy_version_name optional	Policy Version Name Example : `PolicyVersion-1`	string	POLICY_VERSION_1

2.50 - Role

Name	Description	Schema	Default
account_id optional	역할이 속한 계정의 ID Example :	any of [string, null]
assume_role_policy_document required	역할 신뢰 정책	PolicyDocument
created_at required	생성 일시 Example : `2024-05-17T00:23:17Z`	string (date-time)
created_by required	생성자 Example : `ef50cdc207f05f6fb8f20219f229ed1f`	string
creator_email optional	생성자 Email Example :	any of [string, null]
creator_name optional	생성자 성, 이름 Example :	any of [string, null]
description required	역할 설명 Example :	any of [string, null]
id required	ID Example : `f39c460fade34fecb05ede8f904b24b7`	string
max_session_duration required	역할 세션 최대 지속 시간(초) Example :	integer
modified_at required	수정 일시 Example : `2024-05-17T00:23:17Z`	string (date-time)
modified_by required	수정자 Example : `ef50cdc207f05f6fb8f20219f229ed1f`	string
modifier_email optional	수정자 Email Example :	any of [string, null]
modifier_name optional	수정자 성, 이름 Example :	any of [string, null]
name required	역할명 Example :	string
policies required	역할에 연결된 정책 목록	any of [array[Policy], null]
type optional	역할 유형 Example : `USER_DEFINED`	enum (USER_DEFINED, SERVICE, SERVICE_LINKED)	USER_DEFINED

2.51 - RoleBulkDeleteRequest

Name	Description	Schema
account_id optional	역할이 속한 계정의 ID Example :	any of [string, null]
role_ids optional	역할 ID 목록 Example :	any of [array[string], null]
role_names optional	역할명 목록 Example :	any of [array[string], null]

2.52 - RoleCreateRequest

Name	Description	Schema	Default
account_id optional	역할이 속한 계정의 ID Example :	any of [string, null]
assume_role_policy_document optional	역할 신뢰 정책 Example : `{'Statement': [{'Action': ['sts:AssumeRole'], 'Condition': {}, 'Effect': 'Allow', 'Principal': 'srn:e:1234:::iam:user/abc1234', 'Resource': [], 'Sid': 'statement1'}], 'Version': '2024-07-01'}`	any of [PolicyDocument, null]
description optional	역할 설명 Example :	any of [string, null]
max_session_duration optional	역할 세션 최대 지속 시간(초) Example : `3600` Minimum : `3600` Maximum : `43200`	integer	3600
name required	역할명 Example : Pattern : `^[a-zA-Z0-9\+\=\,\.\@\-\_]$` Maximum length* : `64`	string
policy_ids required	역할에 연결할 정책 ID 목록 Example : `['37f2e31ff86b415698d7e8eeafab445d']`	array[string]
principals optional	신뢰 정책 수행 주체 목록 Example : `[{'type': 'SRN', 'value': 'srn:e:1234:::iam:user/abc1234'}]`	any of [array[RoleTrustPolicyPrincipal], null]
tags optional	역할 태그 Example : `[{'key': 'company', 'value': 'SDS'}]`	any of [array[object[string]], null]

2.53 - RolePageResponse

Name	Description	Schema
count required	count Example : `20`	integer
page required	page Example : `0`	integer
roles required		array[Role]
size required	size Example : `20`	integer
sort optional	sort Example : `['created_at:asc']`	any of [array[string], null]

2.54 - RolePolicyBindingPageResponse

Name	Description	Schema
count required	count Example : `20`	integer
page required	page Example : `0`	integer
policies required		array[Policy]
size required	size Example : `20`	integer
sort optional	sort Example : `['created_at:asc']`	any of [array[string], null]

2.55 - RolePolicyBindingRequest

Name	Description	Schema	Default
policy_ids required	Policy ID List	array[string]

2.56 - RolePolicyBindingResponse

Name	Description	Schema	Default
policies required		array[Policy]

2.57 - RoleSetRequest

Name	Description	Schema	Default
description optional	역할 설명 Example :	any of [string, null]
max_session_duration optional	역할 세션 최대 지속 시간(초) Example : `3600`	any of [integer, null]

2.58 - RoleShowResponse

Name	Description	Schema	Default
role required		Role

2.59 - RoleTrustPolicyPrincipal

Name	Description	Schema	Default
type required	신뢰 정책 수행 주체 유형 Example :	string
value required	신뢰 정책 수행 주체 Example :	string

2.60 - RoleTrustPolicyRequest

Name	Description	Schema	Default
assume_role_policy_document required	역할 신뢰 정책 Example : `{'Statement': [{'Action': ['sts:AssumeRole'], 'Condition': {}, 'Effect': 'Allow', 'Principal': 'srn:e:1234:::iam:user/abc1234', 'Resource': [], 'Sid': 'statement1'}], 'Version': '2024-07-01'}`	PolicyDocument

2.61 - RoleTrustPolicyShowResponse

Name	Description	Schema
assume_role_policy_document required		PolicyDocument
created_at required	Created At Example : `2024-05-17T00:23:17Z`	string (date-time)
created_by required	Created By Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
id required	ID Example : `0fdd87aab8cb46f59b7c1f81ed03fb3e`	string
modified_at required	Modified At Example : `2024-05-17T00:23:17Z`	string (date-time)
modified_by required	Modified By Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string

2.62 - SamlProviderCreateRequest

Name	Description	Schema
description optional	자격증명공급자 설명 Example : `SAML provider Description`	any of [string, null]
federation_type required	자격증명공급자 유형 Example : `SAML`	string
file optional	메타데이터 파일 Example : `keycloak-idp-saml.xml`	string (binary)
saml_provider_name required	자격증명공급자 이름 Example : `IdpTest`	string
tags optional	태그 Example : `[{'key': 'company', 'value': 'SDS'}]`	any of [array[object[string]], null]

2.63 - SamlProviderCreateResponse

Name	Description	Schema
account_id required	Account ID Example :	string
acs_url optional	ACS URL Example :	any of [string, null]
created_at required	Created At Example : `2024-05-17T00:23:17Z`	string (date-time)
created_by required	Created By Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
creator_name optional	생성자 Example :	any of [string, null]
description optional	자격증명공급자 설명 Example :	any of [string, null]
federation_type optional	자격증명공급자 유형 Example :	any of [string, null]
id required	ID Example : `0fdd87aab8cb46f59b7c1f81ed03fb3e`	string
idp_cert_end optional	유효기간 Example :	any of [string (date-time), null]
idp_file_name optional	메타데이터 파일 이름 Example :	any of [string, null]
idp_file_size optional	메타데이터 파일 크기 Example :	any of [integer, null]
idp_issuer_url optional	발행자 URL Example :	any of [string, null]
idp_sso_url optional	SSO 서비스 위치 Example :	any of [string, null]
modified_at required	Modified At Example : `2024-05-17T00:23:17Z`	string (date-time)
modified_by required	Modified By Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
modifier_name optional	수정자 Example :	any of [string, null]
saml_provider_name optional	자격증명공급자 이름 Example :	any of [string, null]

2.64 - SamlProviderDetailResponse

Name	Description	Schema
account_id required	Account ID Example :	string
acs_url optional	ACS URL Example :	any of [string, null]
created_at required	Created At Example : `2024-05-17T00:23:17Z`	string (date-time)
created_by required	Created By Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
creator_name optional	생성자 Example :	any of [string, null]
description optional	자격증명공급자 설명 Example :	any of [string, null]
federation_type optional	자격증명공급자 유형 Example :	any of [string, null]
id required	ID Example : `0fdd87aab8cb46f59b7c1f81ed03fb3e`	string
idp_cert_end optional	유효기간 Example :	any of [string (date-time), null]
idp_file_data optional	메타데이터 내용 Example :	any of [string, null]
idp_file_name optional	메타데이터 파일 이름 Example :	any of [string, null]
idp_file_size optional	메타데이터 파일 크기 Example :	any of [integer, null]
idp_issuer_url optional	발행자 URL Example :	any of [string, null]
idp_sso_url optional	SSO 서비스 위치 Example :	any of [string, null]
modified_at required	Modified At Example : `2024-05-17T00:23:17Z`	string (date-time)
modified_by required	Modified By Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
modifier_name optional	수정자 Example :	any of [string, null]
saml_provider_name optional	자격증명공급자 이름 Example :	any of [string, null]

2.65 - SamlProviderResponse

Name	Description	Schema
account_id required	Account ID Example :	string
created_at required	Created At Example : `2024-05-17T00:23:17Z`	string (date-time)
created_by required	Created By Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
creator_name optional	생성자 Example :	any of [string, null]
description optional	자격증명공급자 설명 Example :	any of [string, null]
federation_type optional	자격증명공급자 유형 Example :	any of [string, null]
id required	ID Example : `0fdd87aab8cb46f59b7c1f81ed03fb3e`	string
modified_at required	Modified At Example : `2024-05-17T00:23:17Z`	string (date-time)
modified_by required	Modified By Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
modifier_name optional	수정자 Example :	any of [string, null]
saml_provider_name optional	자격증명공급자 이름 Example :	any of [string, null]

2.66 - SamlProviderUpdateRequestData

Name	Description	Schema
description optional	자격증명공급자 설명 Example : `SAML provider Description`	string
file optional	메타데이터 파일 Example : `keycloak-idp-saml.xml`	string (binary)
saml_provider_name optional	자격증명공급자 이름 Example : `IdpTest`	any of [string, null]
tags optional	태그 Example : `[{'key': 'company', 'value': 'SDS'}]`	any of [array[object[string]], null]

2.67 - ServiceAccount

Name	Description	Schema
id required	Service Account ID Example :	string
name required	Service Account Name Example :	string
service required	Service Account’s Service Example :	string

2.68 - ServiceAccountDetail

Name	Description	Schema
id required	Service Account ID Example :	string
name required	Service Account Name Example :	string
password required	Service Account’s Password Example :	string
service required	Service Account’s Service Example :	string

2.69 - ServiceAccountListResponse

Name	Description	Schema	Default
service_accounts required		array[ServiceAccount]

2.70 - ServiceAccountShowResponse

Name	Description	Schema	Default
service_account required		ServiceAccountDetail

2.71 - Statement

Name	Description	Schema	Default
Action optional	Action Example : `['iam:*']`	any of [array[string], null]
Condition optional	Condition Example : `{'StringEquals': {'scp:RequestedRegion': ['kr-west1']}}`	any of [object[object[array[object]]], null]
Effect required	Effect Example : `Allow`	string
NotAction optional	NotAction Example :	any of [array[string], null]
Principal optional	Principal Example :	any of [string, object[array[string]], null]
Resource optional	Resource Example : `['*']`	array[string]
Sid optional	Statement Id Example : `Statement1`	string	statement1

2.72 - StatementCreateRequest

Name	Description	Schema	Default
Action optional	Action Example : `['virtualserver:ShowVirtualServer']`	any of [array[string], null]
Condition optional	Condition Example : `{'StringEquals': {'scp:RequestedRegion': ['kr-west1']}}`	any of [object[object[array[object]]], null]
Effect required	Effect Example : `Allow`	string
NotAction optional	NotAction Example :	any of [array[string], null]
Principal optional	Principal Example : `*`	any of [string, object[array[string]], null]
Resource optional	Resource Example : `['srn:dev2::1234567890102345690:kr-west1::virtualserver:virtual-server/abcde-1234-5555-6666']`	array[string]
Sid optional	Statement Id Example : `Statement1`	string	statement1

2.73 - StatementResponse

Name	Description	Schema	Default
Statement required	Statement Example : `{'Action': ['virtualserver:ShowVirtualServer'], 'Condition': {'StringEquals': {'scp:RequestedRegion': ['kr-west1']}}, 'Effect': 'Allow', 'Principal': '*', 'Resource': ['srn:dev2::1234567890102345690:kr-west1::virtualserver:virtual-server/abcde-1234-5555-6666'], 'Sid': 'Statement1'}`	Statement

2.74 - UserPolicyPageResponse

Name	Description	Schema
count required	count Example : `20`	integer
page required	page Example : `0`	integer
policies required	User policy	array[Policy]
size required	size Example : `20`	integer
sort optional	sort Example : `['created_at:asc']`	any of [array[string], null]
user_id required	사용자 ID Example :	string

2.75 - UserPolicyRequest

Name	Description	Schema	Default
policy_ids optional	User Policy Bindings	array[string]

2.76 - UserPolicyResponse

Name	Description	Schema	Default
policies required	User policy	array[Policy]
user_id required	사용자 ID Example :	string

2.77 - UserResponse

Name	Description	Schema
account_id optional	Account ID Example :	any of [string, null]
company_name optional	회사 이름 Example :	any of [string, null]
created_at required	Created At Example : `2024-05-17T00:23:17Z`	string (date-time)
created_by required	Created By Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
description optional	User Description Example :	any of [string, null]
dst_offset optional	DST Offset Example :	any of [string, null]
email optional	User Email Example :	any of [string, null]
email_authenticated required	email 인증 여부 Example :	boolean
first_name optional	사용자 이름 Example :	any of [string, null]
id required	ID Example :	string
last_login_at optional	마지막 로그인 Example :	any of [string (date-time), null]
last_name optional	사용자 성 Example :	any of [string, null]
last_password_update_at optional	마지막 비밀번호 수정시간 Example :	any of [string (date-time), null]
modified_at required	Modified At Example : `2024-05-17T00:23:17Z`	string (date-time)
modified_by required	Modified By Example : `90dddfc2b1e04edba54ba2b41539a9ac`	string
name optional	Name Example :	any of [string, null]
password_reuse_count required	비밀 번호 재사용 가능 횟수 Example :	integer
phone_authenticated required	휴대폰 인증 여부 Example :	boolean
policies required	User Policies	any of [array[Policy], null]
state optional	상태 Example :	any of [string, null]
timezone optional	Timezone ID Example :	any of [string, null]
type required	Type Example :	string
tz_id optional	Timezone ID Example :	any of [string, null]
user_name optional	User Name Example :	any of [string, null]
utc_offset optional	UTC Offset Example :	any of [string, null]