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.3
1.1.2: 1.2
1.1.3: 1.1
1.1.4: 1.0

1.2: Add a user to a group

1.2.1: 1.3
1.2.2: 1.2
1.2.3: 1.1
1.2.4: 1.0

1.3: Assign policies to the group

1.3.1: 1.3
1.3.2: 1.2
1.3.3: 1.1
1.3.4: 1.0

1.4: Assign policies to user

1.4.1: 1.3
1.4.2: 1.2
1.4.3: 1.1
1.4.4: 1.0

1.5: Attach policies to Role

1.5.1: 1.3
1.5.2: 1.2
1.5.3: 1.1
1.5.4: 1.0

1.6: Create a group

1.6.1: 1.3
1.6.2: 1.2
1.6.3: 1.1
1.6.4: 1.0

1.7: Create a policy

1.7.1: 1.3
1.7.2: 1.2
1.7.3: 1.1
1.7.4: 1.0

1.8: Create a saml provider

1.8.1: 1.3
1.8.2: 1.2
1.8.3: 1.1
1.8.4: 1.0

1.9: Create an access key

1.9.1: 1.3
1.9.2: 1.2
1.9.3: 1.1
1.9.4: 1.0

1.10: Create IAM user

1.10.1: 1.3
1.10.2: 1.2
1.10.3: 1.1
1.10.4: 1.0

1.11: Create role

1.11.1: 1.3
1.11.2: 1.2
1.11.3: 1.1
1.11.4: 1.0

1.12: Delete bulk role

1.12.1: 1.3
1.12.2: 1.2
1.12.3: 1.1
1.12.4: 1.0

1.13: Delete IAM user

1.13.1: 1.3
1.13.2: 1.2
1.13.3: 1.1

1.14: Delete IAM users

1.14.1: 1.3
1.14.2: 1.2
1.14.3: 1.1
1.14.4: 1.0

1.15: Delete role

1.15.1: 1.3
1.15.2: 1.2
1.15.3: 1.1
1.15.4: 1.0

1.16: Delete the policy

1.16.1: 1.3
1.16.2: 1.2
1.16.3: 1.1
1.16.4: 1.0

1.17: Delete the resource based policy

1.17.1: 1.3
1.17.2: 1.2
1.17.3: 1.1
1.17.4: 1.0

1.18: Delete user policy

1.18.1: 1.3
1.18.2: 1.2
1.18.3: 1.1
1.18.4: 1.0

1.19: Detach policies to Role

1.19.1: 1.3
1.19.2: 1.2
1.19.3: 1.1
1.19.4: 1.0

1.20: Detach policy to Role

1.20.1: 1.3
1.20.2: 1.2
1.20.3: 1.1
1.20.4: 1.0

1.21: Get a Group

1.21.1: 1.3
1.21.2: 1.2
1.21.3: 1.1
1.21.4: 1.0

1.22: Get a specific policy binding list

1.22.1: 1.3
1.22.2: 1.2
1.22.3: 1.1
1.22.4: 1.0

1.23: Get an access key

1.23.1: 1.3
1.23.2: 1.2
1.23.3: 1.1
1.23.4: 1.0

1.24: Get endpoint list

1.24.1: 1.3
1.24.2: 1.2
1.24.3: 1.1
1.24.4: 1.0

1.25: Get IAM users

1.25.1: 1.3
1.25.2: 1.2
1.25.3: 1.1
1.25.4: 1.0

1.26: Get policy list

1.26.1: 1.3
1.26.2: 1.2
1.26.3: 1.1
1.26.4: 1.0

1.27: Get role

1.27.1: 1.3
1.27.2: 1.2
1.27.3: 1.1
1.27.4: 1.0

1.28: Get role list

1.28.1: 1.3
1.28.2: 1.2
1.28.3: 1.1
1.28.4: 1.0

1.29: Get Role Policy-Binding list

1.29.1: 1.3
1.29.2: 1.2
1.29.3: 1.1
1.29.4: 1.0

1.30: Get saml provider information

1.30.1: 1.3
1.30.2: 1.2
1.30.3: 1.1
1.30.4: 1.0

1.31: Get service account

1.31.1: 1.3
1.31.2: 1.2
1.31.3: 1.1
1.31.4: 1.0

1.32: Get user policy-binding list

1.32.1: 1.3
1.32.2: 1.2
1.32.3: 1.1
1.32.4: 1.0

1.33: Group Member list

1.33.1: 1.3
1.33.2: 1.2
1.33.3: 1.1
1.33.4: 1.0

1.34: List access keys

1.34.1: 1.3
1.34.2: 1.2
1.34.3: 1.1
1.34.4: 1.0

1.35: List Groups

1.35.1: 1.3
1.35.2: 1.2
1.35.3: 1.1
1.35.4: 1.0

1.36: List IAM users

1.36.1: 1.3
1.36.2: 1.2
1.36.3: 1.1
1.36.4: 1.0

1.37: List saml providers

1.37.1: 1.3
1.37.2: 1.2
1.37.3: 1.1
1.37.4: 1.0

1.38: List service accounts

1.38.1: 1.3
1.38.2: 1.2
1.38.3: 1.1
1.38.4: 1.0

1.39: Modify a Group

1.39.1: 1.3
1.39.2: 1.2
1.39.3: 1.1
1.39.4: 1.0

1.40: Query policy list

1.40.1: 1.3
1.40.2: 1.2
1.40.3: 1.1
1.40.4: 1.0

1.41: Remove a permission into the resource based policy

1.41.1: 1.3
1.41.2: 1.2
1.41.3: 1.1
1.41.4: 1.0

1.42: Remove a User from a Group

1.42.1: 1.3
1.42.2: 1.2
1.42.3: 1.1
1.42.4: 1.0

1.43: Remove policies

1.43.1: 1.3
1.43.2: 1.2
1.43.3: 1.1
1.43.4: 1.0

1.44: Remove policy assignment from group

1.44.1: 1.3
1.44.2: 1.2
1.44.3: 1.1
1.44.4: 1.0

1.45: Remove saml providers

1.45.1: 1.3
1.45.2: 1.2
1.45.3: 1.1
1.45.4: 1.0

1.46: Remove the access key

1.46.1: 1.3
1.46.2: 1.2
1.46.3: 1.1
1.46.4: 1.0

1.47: Remove the access keys

1.47.1: 1.3
1.47.2: 1.2
1.47.3: 1.1
1.47.4: 1.0

1.48: Remove the Group

1.48.1: 1.3
1.48.2: 1.2
1.48.3: 1.1
1.48.4: 1.0

1.49: Send Temporary Access Key OTP

1.49.1: 1.3
1.49.2: 1.2
1.49.3: 1.1
1.49.4: 1.0

1.50: Set a permission into the resource based policy

1.50.1: 1.3
1.50.2: 1.2
1.50.3: 1.1
1.50.4: 1.0

1.51: Set an access key

1.51.1: 1.3
1.51.2: 1.2
1.51.3: 1.1
1.51.4: 1.0

1.52: Set role

1.52.1: 1.3
1.52.2: 1.2
1.52.3: 1.1
1.52.4: 1.0

1.53: Set role trust policy

1.53.1: 1.3
1.53.2: 1.2
1.53.3: 1.1
1.53.4: 1.0

1.54: Set the policy

1.54.1: 1.3
1.54.2: 1.2
1.54.3: 1.1
1.54.4: 1.0

1.55: Set the policy group binding

1.55.1: 1.3
1.55.2: 1.2
1.55.3: 1.1
1.55.4: 1.0

1.56: Set the resource based policy

1.56.1: 1.3
1.56.2: 1.2
1.56.3: 1.1
1.56.4: 1.0

1.57: Show group policy

1.57.1: 1.3
1.57.2: 1.2
1.57.3: 1.1
1.57.4: 1.0

1.58: Show the policy

1.58.1: 1.3
1.58.2: 1.2
1.58.3: 1.1
1.58.4: 1.0

1.59: Show the resource based policy

1.59.1: 1.3
1.59.2: 1.2
1.59.3: 1.1
1.59.4: 1.0

1.60: Update IAM user

1.60.1: 1.3
1.60.2: 1.2
1.60.3: 1.1
1.60.4: 1.0

1.61: Update IAM user password

1.61.1: 1.3
1.61.2: 1.2
1.61.3: 1.1
1.61.4: 1.0

1.62: Update saml provider information

1.62.1: 1.3
1.62.2: 1.2
1.62.3: 1.1
1.62.4: 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: RoleCreateRequestV1Dot3
2.54: RolePageResponse
2.55: RolePolicyBindingPageResponse
2.56: RolePolicyBindingRequest
2.57: RolePolicyBindingResponse
2.58: RoleSetRequest
2.59: RoleShowResponse
2.60: RoleTrustPolicyPrincipal
2.61: RoleTrustPolicyRequest
2.62: RoleTrustPolicyShowResponse
2.63: SamlProviderCreateRequest
2.64: SamlProviderCreateResponse
2.65: SamlProviderDetailResponse
2.66: SamlProviderResponse
2.67: SamlProviderUpdateRequestData
2.68: ServiceAccount
2.69: ServiceAccountDetail
2.70: ServiceAccountListResponse
2.71: ServiceAccountShowResponse
2.72: Statement
2.73: StatementCreateRequest
2.74: StatementResponse
2.75: UserPolicyPageResponse
2.76: UserPolicyRequest
2.77: UserPolicyResponse
2.78: 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

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Status	Not Before
1.3	CURRENT	-
1.2	SUPPORTED	20260930
1.1	DEPRECATED	20260531
1.0	DEPRECATED	20260223

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.3

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

Description

Add a permission into the resource based policy

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	srn required	Samsung Resource Name 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.3"

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

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

Description

Add a permission into the resource based policy

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

Parameters

Type	Name	Description	Schema	Default
path	srn required	Samsung Resource Name 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.3 - 1.1

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

Description

Add a permission into the resource based policy

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	srn required	Samsung Resource Name 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.4 - 1.0

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

Description

Add a permission into the resource based policy

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	srn required	Samsung Resource Name 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.3

post /v1/groups/{group_id}/members

Description

Add a user to a group

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

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

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

post /v1/groups/{group_id}/members

Description

Add a user to a group

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

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.3 - 1.1

post /v1/groups/{group_id}/members

Description

Add a user to a group

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.4 - 1.0

post /v1/groups/{group_id}/members

Description

Add a user to a group

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.3

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

Description

Assign policies to the group

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

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

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

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

Description

Assign policies to the group

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

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.3 - 1.1

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

Description

Assign policies to the group

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.4 - 1.0

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

Description

Assign policies to the group

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.3

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

Description

Assign policies to user

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	user_id required	User 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.3"

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

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

Description

Assign policies to user

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

Parameters

Type	Name	Description	Schema	Default
path	user_id required	User 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.3 - 1.1

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

Description

Assign policies to user

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	user_id required	User 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.4 - 1.0

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

Description

Assign policies to user

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	user_id required	User 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.3

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

Description

Attach policies to Role

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	role_id required	Role 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.3"

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

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

Description

Attach policies to Role

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

Parameters

Type	Name	Description	Schema	Default
path	role_id required	Role 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.3 - 1.1

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

Description

Attach policies to Role

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	role_id required	Role 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.4 - 1.0

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

Description

Attach policies to Role

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	role_id required	Role 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.3

post /v1/groups

Description

Create a group

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

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

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

post /v1/groups

Description

Create a group

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

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.3 - 1.1

post /v1/groups

Description

Create a group

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.4 - 1.0

post /v1/groups

Description

Create a group

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.3

post /v1/policies

Description

Create a policy

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

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

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

post /v1/policies

Description

Create a policy

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

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.3 - 1.1

post /v1/policies

Description

Create a policy

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.4 - 1.0

post /v1/policies

Description

Create a policy

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.3

post /v1/saml-providers

Description

Create a saml provider

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

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

post /v1/saml-providers

Description

Create a saml provider

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

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.3 - 1.1

post /v1/saml-providers

Description

Create a saml provider

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.4 - 1.0

post /v1/saml-providers

Description

Create a saml provider

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.3

post /v1/access-keys

Description

Create an access key

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

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

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

post /v1/access-keys

Description

Create an access key

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

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.3 - 1.1

post /v1/access-keys

Description

Create an access key

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.4 - 1.0

post /v1/access-keys

Description

Create an access key

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.3

post /v1/accounts/{account_id}/users

Description

Create IAM user

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	account_id required	Account ID Field 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.3"

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

post /v1/accounts/{account_id}/users

Description

Create IAM user

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

Parameters

Type	Name	Description	Schema	Default
path	account_id required	Account ID Field 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.3 - 1.1

post /v1/accounts/{account_id}/users

Description

Create IAM user

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	account_id required	Account ID Field 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.4 - 1.0

post /v1/accounts/{account_id}/users

Description

Create IAM user

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	account_id required	Account ID Field 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.3

post /v1/roles

Description

Create role

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

Parameters

Type	Name	Description	Schema	Default
body	body required		RoleCreateRequestV1Dot3

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

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"
        }
    ],
    "role_type": "USER_DEFINED",
    "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.2

post /v1/roles

Description

Create role

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

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.3 - 1.1

post /v1/roles

Description

Create role

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.4 - 1.0

post /v1/roles

Description

Create role

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.3

delete /v1/roles/bulk

Description

Delete bulk role

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

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
409	Conflict	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.3"

Request body

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

Example HTTP response

Response 204

1.12.2 - 1.2

delete /v1/roles/bulk

Description

Delete bulk role

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

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.3 - 1.1

delete /v1/roles/bulk

Description

Delete bulk role

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.4 - 1.0

delete /v1/roles/bulk

Description

Delete bulk role

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.3

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

Description

Delete IAM user

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	account_id required	Account ID Field 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.3"

Example HTTP response

Response 204

1.13.2 - 1.2

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

Description

Delete IAM user

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

Parameters

Type	Name	Description	Schema	Default
path	account_id required	Account ID Field 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.3 - 1.1

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

Description

Delete IAM user

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	account_id required	Account ID Field 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.3

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

Description

Delete IAM users

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	account_id required	Account ID Field 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.3"

Request body

{
    "user_ids": [
        ""
    ]
}

Example HTTP response

Response 204

1.14.2 - 1.2

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

Description

Delete IAM users

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

Parameters

Type	Name	Description	Schema	Default
path	account_id required	Account ID Field 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.3 - 1.1

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

Description

Delete IAM users

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	account_id required	Account ID Field 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.4 - 1.0

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

Description

Delete IAM users

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	account_id required	Account ID Field 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.3

delete /v1/roles/{role_id}

Description

Delete role

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	role_id required	Role 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
409	Conflict	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.3"

Example HTTP response

Response 204

1.15.2 - 1.2

delete /v1/roles/{role_id}

Description

Delete role

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

Parameters

Type	Name	Description	Schema	Default
path	role_id required	Role 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.3 - 1.1

delete /v1/roles/{role_id}

Description

Delete role

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	role_id required	Role 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.4 - 1.0

delete /v1/roles/{role_id}

Description

Delete role

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	role_id required	Role 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.3

delete /v1/policies/{policy_id}

Description

Delete the policy

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

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

Example HTTP response

Response 204

1.16.2 - 1.2

delete /v1/policies/{policy_id}

Description

Delete the policy

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

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.3 - 1.1

delete /v1/policies/{policy_id}

Description

Delete the policy

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.4 - 1.0

delete /v1/policies/{policy_id}

Description

Delete the policy

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.3

delete /v1/resource-policies/{srn}

Description

Delete the resource based policy

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	srn required	Samsung Resource Name 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.3"

Example HTTP response

Response 204

1.17.2 - 1.2

delete /v1/resource-policies/{srn}

Description

Delete the resource based policy

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

Parameters

Type	Name	Description	Schema	Default
path	srn required	Samsung Resource Name 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.3 - 1.1

delete /v1/resource-policies/{srn}

Description

Delete the resource based policy

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	srn required	Samsung Resource Name 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.4 - 1.0

delete /v1/resource-policies/{srn}

Description

Delete the resource based policy

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	srn required	Samsung Resource Name 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.3

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

Description

Delete user policy

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	user_id required	User 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.3"

Example HTTP response

Response 204

1.18.2 - 1.2

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

Description

Delete user policy

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

Parameters

Type	Name	Description	Schema	Default
path	user_id required	User 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.3 - 1.1

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

Description

Delete user policy

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	user_id required	User 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.4 - 1.0

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

Description

Delete user policy

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	user_id required	User 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.3

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

Description

Detach policies to Role

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	role_id required	Role 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.3"

Request body

{
    "policy_ids": [
        ""
    ]
}

Example HTTP response

Response 204

1.19.2 - 1.2

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

Description

Detach policies to Role

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

Parameters

Type	Name	Description	Schema	Default
path	role_id required	Role 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.3 - 1.1

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

Description

Detach policies to Role

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	role_id required	Role 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.4 - 1.0

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

Description

Detach policies to Role

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	role_id required	Role 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.3

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

Description

Detach policy to Role

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	role_id required	Role ID Example :	string	None
path	policy_id required	Policy ID Attached to Role 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.3"

Example HTTP response

Response 204

1.20.2 - 1.2

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

Description

Detach policy to Role

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

Parameters

Type	Name	Description	Schema	Default
path	role_id required	Role ID Example :	string	None
path	policy_id required	Policy ID Attached to Role 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.3 - 1.1

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

Description

Detach policy to Role

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	role_id required	Role ID Example :	string	None
path	policy_id required	Policy ID Attached to Role 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.4 - 1.0

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

Description

Detach policy to Role

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	role_id required	Role ID Example :	string	None
path	policy_id required	Policy ID Attached to Role 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.3

get /v1/groups/{group_id}

Description

Get a Group

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

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

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

get /v1/groups/{group_id}

Description

Get a Group

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

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.3 - 1.1

get /v1/groups/{group_id}

Description

Get a Group

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.4 - 1.0

get /v1/groups/{group_id}

Description

Get a Group

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.3

get /v1/policies/{policy_id}/bindings

Description

Get a specific policy binding list

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

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

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

get /v1/policies/{policy_id}/bindings

Description

Get a specific policy binding list

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

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.3 - 1.1

get /v1/policies/{policy_id}/bindings

Description

Get a specific policy binding list

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.4 - 1.0

get /v1/policies/{policy_id}/bindings

Description

Get a specific policy binding list

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.3

get /v1/access-keys/{access_key_id}

Description

Get an access key

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

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

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

get /v1/access-keys/{access_key_id}

Description

Get an access key

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

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.3 - 1.1

get /v1/access-keys/{access_key_id}

Description

Get an access key

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.4 - 1.0

get /v1/access-keys/{access_key_id}

Description

Get an access key

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.3

get /v1/endpoints

Description

Get endpoint list

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

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

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

get /v1/endpoints

Description

Get endpoint list

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

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.3 - 1.1

get /v1/endpoints

Description

Get endpoint list

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.4 - 1.0

get /v1/endpoints

Description

Get endpoint list

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.3

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

Description

Get IAM users

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	account_id required	Account ID Field 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.3"

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

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

Description

Get IAM users

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

Parameters

Type	Name	Description	Schema	Default
path	account_id required	Account ID Field 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.3 - 1.1

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

Description

Get IAM users

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	account_id required	Account ID Field 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.4 - 1.0

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

Description

Get IAM users

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	account_id required	Account ID Field 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.3

get /v1/policies

Description

Get policy list

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

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	Creator Last Name, First Name Example : `test1`	any of [string, null]	None
query	creator_email optional	Creator Email Example : `test@test.com`	any of [string, null]	None
query	modifier_name optional	Modifier Last Name, First Name Example : `test1`	any of [string, null]	None
query	modifier_email optional	Modifier Email Example : `test@test.com`	any of [string, null]	None
query	exclude_group_id optional	Group ID to Exclude Example : `a946662dc4314dac93da413a32457459`	any of [string, null]	None
query	exclude_user_id optional	User ID to Exclude 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.3"

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

get /v1/policies

Description

Get policy list

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

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	Creator Last Name, First Name Example : `test1`	any of [string, null]	None
query	creator_email optional	Creator Email Example : `test@test.com`	any of [string, null]	None
query	modifier_name optional	Modifier Last Name, First Name Example : `test1`	any of [string, null]	None
query	modifier_email optional	Modifier Email Example : `test@test.com`	any of [string, null]	None
query	exclude_group_id optional	Group ID to Exclude Example : `a946662dc4314dac93da413a32457459`	any of [string, null]	None
query	exclude_user_id optional	User ID to Exclude 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.3 - 1.1

get /v1/policies

Description

Get policy list

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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	Creator Last Name, First Name Example : `test1`	any of [string, null]	None
query	creator_email optional	Creator Email Example : `test@test.com`	any of [string, null]	None
query	modifier_name optional	Modifier Last Name, First Name Example : `test1`	any of [string, null]	None
query	modifier_email optional	Modifier Email Example : `test@test.com`	any of [string, null]	None
query	exclude_group_id optional	Group ID to Exclude Example : `a946662dc4314dac93da413a32457459`	any of [string, null]	None
query	exclude_user_id optional	User ID to Exclude 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.4 - 1.0

get /v1/policies

Description

Get policy list

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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	Creator Last Name, First Name Example : `test1`	any of [string, null]	None
query	creator_email optional	Creator Email Example : `test@test.com`	any of [string, null]	None
query	modifier_name optional	Modifier Last Name, First Name Example : `test1`	any of [string, null]	None
query	modifier_email optional	Modifier Email Example : `test@test.com`	any of [string, null]	None
query	exclude_group_id optional	Group ID to Exclude Example : `a946662dc4314dac93da413a32457459`	any of [string, null]	None
query	exclude_user_id optional	User ID to Exclude 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.3

get /v1/roles/{role_id}

Description

Get role

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	role_id required	Role 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.3"

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

get /v1/roles/{role_id}

Description

Get role

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

Parameters

Type	Name	Description	Schema	Default
path	role_id required	Role 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.3 - 1.1

get /v1/roles/{role_id}

Description

Get role

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	role_id required	Role 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.4 - 1.0

get /v1/roles/{role_id}

Description

Get role

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	role_id required	Role 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.3

get /v1/roles

Description

Get role list

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

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	Role Name Example :	any of [string, null]	None
query	role_type optional	Role Type Example :	any of [string, null]	None
query	account_id optional	Account ID Example :	any of [string, null]	None
query	exclude_policy_id optional	Policy Exception 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.3"

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

get /v1/roles

Description

Get role list

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

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	Role Name Example :	any of [string, null]	None
query	role_type optional	Role Type Example :	any of [string, null]	None
query	account_id optional	Account ID Example :	any of [string, null]	None
query	exclude_policy_id optional	Policy Exception 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.3 - 1.1

get /v1/roles

Description

Get role list

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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	Role Name Example :	any of [string, null]	None
query	role_type optional	Role Type Example :	any of [string, null]	None
query	account_id optional	Account ID Example :	any of [string, null]	None
query	exclude_policy_id optional	Policy Exception 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.4 - 1.0

get /v1/roles

Description

Get role list

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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	Role Name Example :	any of [string, null]	None
query	role_type optional	Role Type Example :	any of [string, null]	None
query	account_id optional	Account ID Example :	any of [string, null]	None
query	exclude_policy_id optional	Policy Exception 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.3

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

Description

Get Role Policy-Binding list

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	role_id required	Role 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 Attached to Role Example :	any of [string, null]	None
query	policy_name optional	Policy Name Attached to Role Example :	any of [string, null]	None
query	policy_type optional	Policy Type List Attached to Role 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.3"

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

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

Description

Get Role Policy-Binding list

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

Parameters

Type	Name	Description	Schema	Default
path	role_id required	Role 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 Attached to Role Example :	any of [string, null]	None
query	policy_name optional	Policy Name Attached to Role Example :	any of [string, null]	None
query	policy_type optional	Policy Type List Attached to Role 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.3 - 1.1

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

Description

Get Role Policy-Binding list

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	role_id required	Role 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 Attached to Role Example :	any of [string, null]	None
query	policy_name optional	Policy Name Attached to Role Example :	any of [string, null]	None
query	policy_type optional	Policy Type List Attached to Role 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.4 - 1.0

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

Description

Get Role Policy-Binding list

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	role_id required	Role 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 Attached to Role Example :	any of [string, null]	None
query	policy_name optional	Policy Name Attached to Role Example :	any of [string, null]	None
query	policy_type optional	Policy Type List Attached to Role 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.3

get /v1/saml-providers/{saml_provider_id}

Description

Get saml provider information

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	saml_provider_id required	Credential Provider 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.3"

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

get /v1/saml-providers/{saml_provider_id}

Description

Get saml provider information

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

Parameters

Type	Name	Description	Schema	Default
path	saml_provider_id required	Credential Provider 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.3 - 1.1

get /v1/saml-providers/{saml_provider_id}

Description

Get saml provider information

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	saml_provider_id required	Credential Provider 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.4 - 1.0

get /v1/saml-providers/{saml_provider_id}

Description

Get saml provider information

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	saml_provider_id required	Credential Provider 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.3

get /v1/service-accounts/{service_account_id}

Description

Get service account

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

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

Example HTTP response

Response 200

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

1.31.2 - 1.2

get /v1/service-accounts/{service_account_id}

Description

Get service account

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

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.3 - 1.1

get /v1/service-accounts/{service_account_id}

Description

Get service account

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.4 - 1.0

get /v1/service-accounts/{service_account_id}

Description

Get service account

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.3

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

Description

Get user policy-binding list

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	user_id required	User 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.3"

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

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

Description

Get user policy-binding list

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

Parameters

Type	Name	Description	Schema	Default
path	user_id required	User 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.3 - 1.1

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

Description

Get user policy-binding list

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	user_id required	User 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.4 - 1.0

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

Description

Get user policy-binding list

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	user_id required	User 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.3

get /v1/groups/{group_id}/members

Description

Group Member list

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

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 Last Name, First Name 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	Creator Last Name, First Name Example : `Kim Samsung`	any of [string, null]	None
query	creator_email optional	Creator 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.3"

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

get /v1/groups/{group_id}/members

Description

Group Member list

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

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 Last Name, First Name 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	Creator Last Name, First Name Example : `Kim Samsung`	any of [string, null]	None
query	creator_email optional	Creator 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.3 - 1.1

get /v1/groups/{group_id}/members

Description

Group Member list

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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 Last Name, First Name 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	Creator Last Name, First Name Example : `Kim Samsung`	any of [string, null]	None
query	creator_email optional	Creator 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.4 - 1.0

get /v1/groups/{group_id}/members

Description

Group Member list

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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 Last Name, First Name 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	Creator Last Name, First Name Example : `Kim Samsung`	any of [string, null]	None
query	creator_email optional	Creator 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.3

get /v1/access-keys

Description

List access keys

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

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

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

get /v1/access-keys

Description

List access keys

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

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.3 - 1.1

get /v1/access-keys

Description

List access keys

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.4 - 1.0

get /v1/access-keys

Description

List access keys

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.3

get /v1/groups

Description

List Groups

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

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 Name 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 ID List Example : `629114aa440b456797cc5da5d3d2ef5d,f2b62d3cba5f42a796783266507ce765`	any of [string, null]	None
query	has_member optional	Group Member Existence Example : `false`	any of [string, null]	None
query	has_role optional	Group Role Existence Example : `false`	any of [string, null]	None
query	is_completed optional	Group Completion Status Example : `false`	any of [string, null]	None
query	creator_name optional	Creator Last Name, First Name Example : `Kim Samsung`	any of [string, null]	None
query	creator_email optional	Creator Email Example : `samsung.kim@samsung.com`	any of [string, null]	None
query	modifier_name optional	Modifier Last Name, First Name Example : `Kim Samsung`	any of [string, null]	None
query	modifier_email optional	Modifier Email Example : `samsung.kim@samsung.com`	any of [string, null]	None
query	exclude_user_id optional	User ID to Exclude Example : `f39c460fade34fecb05ede8f904b24b7`	any of [string, null]	None
query	exclude_policy_id optional	Policy ID to Exclude 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.3"

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

get /v1/groups

Description

List Groups

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

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 Name 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 ID List Example : `629114aa440b456797cc5da5d3d2ef5d,f2b62d3cba5f42a796783266507ce765`	any of [string, null]	None
query	has_member optional	Group Member Existence Example : `false`	any of [string, null]	None
query	has_role optional	Group Role Existence Example : `false`	any of [string, null]	None
query	is_completed optional	Group Completion Status Example : `false`	any of [string, null]	None
query	creator_name optional	Creator Last Name, First Name Example : `Kim Samsung`	any of [string, null]	None
query	creator_email optional	Creator Email Example : `samsung.kim@samsung.com`	any of [string, null]	None
query	modifier_name optional	Modifier Last Name, First Name Example : `Kim Samsung`	any of [string, null]	None
query	modifier_email optional	Modifier Email Example : `samsung.kim@samsung.com`	any of [string, null]	None
query	exclude_user_id optional	User ID to Exclude Example : `f39c460fade34fecb05ede8f904b24b7`	any of [string, null]	None
query	exclude_policy_id optional	Policy ID to Exclude 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.3 - 1.1

get /v1/groups

Description

List Groups

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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 Name 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 ID List Example : `629114aa440b456797cc5da5d3d2ef5d,f2b62d3cba5f42a796783266507ce765`	any of [string, null]	None
query	has_member optional	Group Member Existence Example : `false`	any of [string, null]	None
query	has_role optional	Group Role Existence Example : `false`	any of [string, null]	None
query	is_completed optional	Group Completion Status Example : `false`	any of [string, null]	None
query	creator_name optional	Creator Last Name, First Name Example : `Kim Samsung`	any of [string, null]	None
query	creator_email optional	Creator Email Example : `samsung.kim@samsung.com`	any of [string, null]	None
query	modifier_name optional	Modifier Last Name, First Name Example : `Kim Samsung`	any of [string, null]	None
query	modifier_email optional	Modifier Email Example : `samsung.kim@samsung.com`	any of [string, null]	None
query	exclude_user_id optional	User ID to Exclude Example : `f39c460fade34fecb05ede8f904b24b7`	any of [string, null]	None
query	exclude_policy_id optional	Policy ID to Exclude 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.4 - 1.0

get /v1/groups

Description

List Groups

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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 Name 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 ID List Example : `629114aa440b456797cc5da5d3d2ef5d,f2b62d3cba5f42a796783266507ce765`	any of [string, null]	None
query	has_member optional	Group Member Existence Example : `false`	any of [string, null]	None
query	has_role optional	Group Role Existence Example : `false`	any of [string, null]	None
query	is_completed optional	Group Completion Status Example : `false`	any of [string, null]	None
query	creator_name optional	Creator Last Name, First Name Example : `Kim Samsung`	any of [string, null]	None
query	creator_email optional	Creator Email Example : `samsung.kim@samsung.com`	any of [string, null]	None
query	modifier_name optional	Modifier Last Name, First Name Example : `Kim Samsung`	any of [string, null]	None
query	modifier_email optional	Modifier Email Example : `samsung.kim@samsung.com`	any of [string, null]	None
query	exclude_user_id optional	User ID to Exclude Example : `f39c460fade34fecb05ede8f904b24b7`	any of [string, null]	None
query	exclude_policy_id optional	Policy ID to Exclude 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.3

get /v1/accounts/{account_id}/users

Description

List IAM users

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	account_id required	Account ID Field 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	User Email Example :	any of [string, null]	None
query	nation_id optional	Nation ID Example :	any of [string, null]	None
query	phone_number optional	User Phone Number Example :	any of [string, null]	None
query	user_name optional	User Name Example :	any of [string, null]	None
query	exclude_group_id optional	Exception Target Group Example :	any of [string, null]	None
query	exclude_policy_id optional	Exception Target Policy 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.3"

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

get /v1/accounts/{account_id}/users

Description

List IAM users

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

Parameters

Type	Name	Description	Schema	Default
path	account_id required	Account ID Field 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	User Email Example :	any of [string, null]	None
query	nation_id optional	Nation ID Example :	any of [string, null]	None
query	phone_number optional	User Phone Number Example :	any of [string, null]	None
query	user_name optional	User Name Example :	any of [string, null]	None
query	exclude_group_id optional	Exception Target Group Example :	any of [string, null]	None
query	exclude_policy_id optional	Exception Target Policy 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.3 - 1.1

get /v1/accounts/{account_id}/users

Description

List IAM users

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	account_id required	Account ID Field 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	User Email Example :	any of [string, null]	None
query	nation_id optional	Nation ID Example :	any of [string, null]	None
query	phone_number optional	User Phone Number Example :	any of [string, null]	None
query	user_name optional	User Name Example :	any of [string, null]	None
query	exclude_group_id optional	Exception Target Group Example :	any of [string, null]	None
query	exclude_policy_id optional	Exception Target Policy 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.4 - 1.0

get /v1/accounts/{account_id}/users

Description

List IAM users

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	account_id required	Account ID Field 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	User Email Example :	any of [string, null]	None
query	nation_id optional	Nation ID Example :	any of [string, null]	None
query	phone_number optional	User Phone Number Example :	any of [string, null]	None
query	user_name optional	User Name Example :	any of [string, null]	None
query	exclude_group_id optional	Exception Target Group Example :	any of [string, null]	None
query	exclude_policy_id optional	Exception Target Policy 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.3

get /v1/saml-providers

Description

List saml providers

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

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	Credential Provider Type Example :	any of [string, null]	None
query	saml_provider_name optional	Credential Provider Name 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.3"

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

get /v1/saml-providers

Description

List saml providers

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

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	Credential Provider Type Example :	any of [string, null]	None
query	saml_provider_name optional	Credential Provider Name 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.3 - 1.1

get /v1/saml-providers

Description

List saml providers

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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	Credential Provider Type Example :	any of [string, null]	None
query	saml_provider_name optional	Credential Provider Name 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.4 - 1.0

get /v1/saml-providers

Description

List saml providers

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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	Credential Provider Type Example :	any of [string, null]	None
query	saml_provider_name optional	Credential Provider Name 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.3

get /v1/service-accounts

Description

List service accounts

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

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

Example HTTP response

Response 200

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

1.38.2 - 1.2

get /v1/service-accounts

Description

List service accounts

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

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.3 - 1.1

get /v1/service-accounts

Description

List service accounts

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.4 - 1.0

get /v1/service-accounts

Description

List service accounts

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.3

put /v1/groups/{group_id}

Description

Modify a Group

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

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

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

put /v1/groups/{group_id}

Description

Modify a Group

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

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.3 - 1.1

put /v1/groups/{group_id}

Description

Modify a Group

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.4 - 1.0

put /v1/groups/{group_id}

Description

Modify a Group

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.3

post /v1/policies/list

Description

Query policy list

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

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	Creator Last Name, First Name Example : `test1`	any of [string, null]	None
query	creator_email optional	Creator Email Example : `test@test.com`	any of [string, null]	None
query	modifier_name optional	Modifier Last Name, First Name Example : `test1`	any of [string, null]	None
query	modifier_email optional	Modifier Email Example : `test@test.com`	any of [string, null]	None
query	exclude_group_id optional	Group ID to Exclude Example : `a946662dc4314dac93da413a32457459`	any of [string, null]	None
query	exclude_user_id optional	User ID to Exclude 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.3"

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

post /v1/policies/list

Description

Query policy list

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

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	Creator Last Name, First Name Example : `test1`	any of [string, null]	None
query	creator_email optional	Creator Email Example : `test@test.com`	any of [string, null]	None
query	modifier_name optional	Modifier Last Name, First Name Example : `test1`	any of [string, null]	None
query	modifier_email optional	Modifier Email Example : `test@test.com`	any of [string, null]	None
query	exclude_group_id optional	Group ID to Exclude Example : `a946662dc4314dac93da413a32457459`	any of [string, null]	None
query	exclude_user_id optional	User ID to Exclude 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.3 - 1.1

post /v1/policies/list

Description

Query policy list

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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	Creator Last Name, First Name Example : `test1`	any of [string, null]	None
query	creator_email optional	Creator Email Example : `test@test.com`	any of [string, null]	None
query	modifier_name optional	Modifier Last Name, First Name Example : `test1`	any of [string, null]	None
query	modifier_email optional	Modifier Email Example : `test@test.com`	any of [string, null]	None
query	exclude_group_id optional	Group ID to Exclude Example : `a946662dc4314dac93da413a32457459`	any of [string, null]	None
query	exclude_user_id optional	User ID to Exclude 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.4 - 1.0

post /v1/policies/list

Description

Query policy list

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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	Creator Last Name, First Name Example : `test1`	any of [string, null]	None
query	creator_email optional	Creator Email Example : `test@test.com`	any of [string, null]	None
query	modifier_name optional	Modifier Last Name, First Name Example : `test1`	any of [string, null]	None
query	modifier_email optional	Modifier Email Example : `test@test.com`	any of [string, null]	None
query	exclude_group_id optional	Group ID to Exclude Example : `a946662dc4314dac93da413a32457459`	any of [string, null]	None
query	exclude_user_id optional	User ID to Exclude 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.3

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

Description

Remove a permission into the resource based policy

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	srn required	Samsung Resource Name 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.3"

Example HTTP response

Response 204

1.41.2 - 1.2

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

Description

Remove a permission into the resource based policy

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

Parameters

Type	Name	Description	Schema	Default
path	srn required	Samsung Resource Name 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.3 - 1.1

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

Description

Remove a permission into the resource based policy

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	srn required	Samsung Resource Name 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.4 - 1.0

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

Description

Remove a permission into the resource based policy

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	srn required	Samsung Resource Name 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.3

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

Description

Remove a User from a Group

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

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

Example HTTP response

Response 204

1.42.2 - 1.2

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

Description

Remove a User from a Group

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

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.3 - 1.1

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

Description

Remove a User from a Group

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.4 - 1.0

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

Description

Remove a User from a Group

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.3

delete /v1/policies/bulk

Description

Remove policies

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

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

Request body

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

Example HTTP response

Response 204

1.43.2 - 1.2

delete /v1/policies/bulk

Description

Remove policies

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

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.3 - 1.1

delete /v1/policies/bulk

Description

Remove policies

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.4 - 1.0

delete /v1/policies/bulk

Description

Remove policies

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.3

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

Description

Remove policy assignment from group

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

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

Example HTTP response

Response 204

1.44.2 - 1.2

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

Description

Remove policy assignment from group

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

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.3 - 1.1

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

Description

Remove policy assignment from group

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.4 - 1.0

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

Description

Remove policy assignment from group

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.3

delete /v1/saml-providers/bulk

Description

Remove saml providers

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

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

Request body

{
    "ids": [
        ""
    ]
}

Example HTTP response

Response 204

1.45.2 - 1.2

delete /v1/saml-providers/bulk

Description

Remove saml providers

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

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.3 - 1.1

delete /v1/saml-providers/bulk

Description

Remove saml providers

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.4 - 1.0

delete /v1/saml-providers/bulk

Description

Remove saml providers

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.3

delete /v1/access-keys/{access_key_id}

Description

Remove the access key

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

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

Example HTTP response

Response 204

1.46.2 - 1.2

delete /v1/access-keys/{access_key_id}

Description

Remove the access key

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

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.3 - 1.1

delete /v1/access-keys/{access_key_id}

Description

Remove the access key

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.4 - 1.0

delete /v1/access-keys/{access_key_id}

Description

Remove the access key

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.3

delete /v1/access-keys/bulk

Description

Remove the access keys

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

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

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

delete /v1/access-keys/bulk

Description

Remove the access keys

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

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.3 - 1.1

delete /v1/access-keys/bulk

Description

Remove the access keys

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.4 - 1.0

delete /v1/access-keys/bulk

Description

Remove the access keys

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.3

delete /v1/groups/{group_id}

Description

Remove the Group

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

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

Example HTTP response

Response 204

1.48.2 - 1.2

delete /v1/groups/{group_id}

Description

Remove the Group

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

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.3 - 1.1

delete /v1/groups/{group_id}

Description

Remove the Group

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.4 - 1.0

delete /v1/groups/{group_id}

Description

Remove the Group

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.3

post /v1/access-keys/send-otp

Description

Send Temporary Access Key OTP

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

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

Request body

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

Example HTTP response

Response 204

1.49.2 - 1.2

post /v1/access-keys/send-otp

Description

Send Temporary Access Key OTP

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

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.3 - 1.1

post /v1/access-keys/send-otp

Description

Send Temporary Access Key OTP

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.4 - 1.0

post /v1/access-keys/send-otp

Description

Send Temporary Access Key OTP

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.3

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

Description

Set a permission into the resource based policy

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	srn required	Samsung Resource Name 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.3"

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

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

Description

Set a permission into the resource based policy

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

Parameters

Type	Name	Description	Schema	Default
path	srn required	Samsung Resource Name 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.3 - 1.1

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

Description

Set a permission into the resource based policy

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	srn required	Samsung Resource Name 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.4 - 1.0

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

Description

Set a permission into the resource based policy

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	srn required	Samsung Resource Name 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.3

put /v1/access-keys/{access_key_id}

Description

Set or update an access key

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

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

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

put /v1/access-keys/{access_key_id}

Description

Set or update an access key

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

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.3 - 1.1

put /v1/access-keys/{access_key_id}

Description

Set or update an access key

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.4 - 1.0

put /v1/access-keys/{access_key_id}

Description

Set or update an access key

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.3

put /v1/roles/{role_id}

Description

Set role

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	role_id required	Role 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.3"

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

put /v1/roles/{role_id}

Description

Set role

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

Parameters

Type	Name	Description	Schema	Default
path	role_id required	Role 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.3 - 1.1

put /v1/roles/{role_id}

Description

Set role

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	role_id required	Role 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.4 - 1.0

put /v1/roles/{role_id}

Description

Set role

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	role_id required	Role 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.3

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

Description

Set role trust policy

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	role_id required	Role 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.3"

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

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

Description

Set role trust policy

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

Parameters

Type	Name	Description	Schema	Default
path	role_id required	Role 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.3 - 1.1

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

Description

Set role trust policy

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	role_id required	Role 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.4 - 1.0

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

Description

Set role trust policy

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	role_id required	Role 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.3

put /v1/policies/{policy_id}

Description

Set the policy

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

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

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

put /v1/policies/{policy_id}

Description

Set the policy

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

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.3 - 1.1

put /v1/policies/{policy_id}

Description

Set the policy

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.4 - 1.0

put /v1/policies/{policy_id}

Description

Set the policy

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.3

put /v1/policies/{policy_id}/bindings

Description

Set the policy group binding

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

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

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

put /v1/policies/{policy_id}/bindings

Description

Set the policy group binding

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

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.3 - 1.1

put /v1/policies/{policy_id}/bindings

Description

Set the policy group binding

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.4 - 1.0

put /v1/policies/{policy_id}/bindings

Description

Set the policy group binding

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.3

put /v1/resource-policies/{srn}

Description

Set the resource based policy

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	srn required	Samsung Resource Name 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.3"

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

put /v1/resource-policies/{srn}

Description

Set the resource based policy

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

Parameters

Type	Name	Description	Schema	Default
path	srn required	Samsung Resource Name 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.3 - 1.1

put /v1/resource-policies/{srn}

Description

Set the resource based policy

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	srn required	Samsung Resource Name 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.4 - 1.0

put /v1/resource-policies/{srn}

Description

Set the resource based policy

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	srn required	Samsung Resource Name 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.3

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

Description

Show group policy

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

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

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

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

Description

Show group policy

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

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 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.3 - 1.1

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

Description

Show group policy

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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 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.4 - 1.0

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

Description

Show group policy

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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 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.3

get /v1/policies/{policy_id}

Description

Show the policy

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

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

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

get /v1/policies/{policy_id}

Description

Show the policy

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

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.3 - 1.1

get /v1/policies/{policy_id}

Description

Show the policy

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.4 - 1.0

get /v1/policies/{policy_id}

Description

Show the policy

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
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.3

get /v1/resource-policies/{srn}

Description

Show the resource based policy

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	srn required	Samsung Resource Name 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.3"

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

get /v1/resource-policies/{srn}

Description

Show the resource based policy

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

Parameters

Type	Name	Description	Schema	Default
path	srn required	Samsung Resource Name 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.3 - 1.1

get /v1/resource-policies/{srn}

Description

Show the resource based policy

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	srn required	Samsung Resource Name 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.4 - 1.0

get /v1/resource-policies/{srn}

Description

Show the resource based policy

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	srn required	Samsung Resource Name 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.3

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

Description

Update IAM user

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	account_id required	Account ID Field 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.3"

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

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

Description

Update IAM user

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

Parameters

Type	Name	Description	Schema	Default
path	account_id required	Account ID Field 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.3 - 1.1

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

Description

Update IAM user

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	account_id required	Account ID Field 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.4 - 1.0

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

Description

Update IAM user

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	account_id required	Account ID Field 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.3

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

Description

Update IAM user password

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	account_id required	Account ID Field 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.3"

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

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

Description

Update IAM user password

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

Parameters

Type	Name	Description	Schema	Default
path	account_id required	Account ID Field 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.3 - 1.1

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

Description

Update IAM user password

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	account_id required	Account ID Field 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.4 - 1.0

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

Description

Update IAM user password

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	account_id required	Account ID Field 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.3

put /v1/saml-providers/{saml_provider_id}

Description

Update saml provider information

State ACTIVE (CURRENT)

Version	Not Before
1.3	-

Parameters

Type	Name	Description	Schema	Default
path	saml_provider_id required	Credential Provider 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.3,"
"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.2

put /v1/saml-providers/{saml_provider_id}

Description

Update saml provider information

State ACTIVE (SUPPORTED)

Version	Not Before
1.2	20260930

Parameters

Type	Name	Description	Schema	Default
path	saml_provider_id required	Credential Provider 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.3 - 1.1

put /v1/saml-providers/{saml_provider_id}

Description

Update saml provider information

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	saml_provider_id required	Credential Provider 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.4 - 1.0

put /v1/saml-providers/{saml_provider_id}

Description

Update saml provider information

State ACTIVE (DEPRECATED)

Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.

Version	Not Before
1.0	20260223

Parameters

Type	Name	Description	Schema	Default
path	saml_provider_id required	Credential Provider 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	Activation Status 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 Used for Temporary Access Key Creation 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, MESSENGER)

2.4 - AccessKeyResponse

Name	Description	Schema	Default
access_key required		AccessKey

2.5 - AccessKeyUpdateRequest

Name	Description	Schema	Default
is_enabled optional	Activation Status Example : `true`	boolean	True

2.6 - CreatedGroupMember

Name	Description	Schema	Default
created_at required	Created At Example : `2024-05-17T00:23:17Z`	string (date-time)
created_by required	Creator Example : `ef50cdc207f05f6fb8f20219f229ed1f`	string
creator_email optional	Creator Email Example : `samsung.kim@samsung.com`	string	-
creator_name optional	Creator Last Name, First Name Example : `Kim Samsung`	string	-
user_email optional	Group Member Email Example : `samsung.kim@samsung.com`	string	-
user_id required	User ID Example : `f39c460fade34fecb05ede8f904b24b7`	string
user_name optional	Group Member Last Name, First Name 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	Created At Example : `2024-05-17T00:23:17Z`	string (date-time)
created_by required	Creator Example : `ef50cdc207f05f6fb8f20219f229ed1f`	string
creator_email optional	Creator Email Example : `samsung.kim@samsung.com`	string	-
creator_name optional	Creator Last Name, First Name Example : `Kim Samsung`	string	-
description required	Group Description Example : `Descriptions for group`	any of [string, null]
domain_name required	Domain Name Example : `scp`	string
id required	ID Example : `f39c460fade34fecb05ede8f904b24b7`	string
members optional	Group Member List	any of [array[GroupMember], null]
modified_at required	Modified At Example : `2024-05-17T00:23:17Z`	string (date-time)
modified_by required	Modifier Example : `ef50cdc207f05f6fb8f20219f229ed1f`	string
modifier_email optional	Modifier Email Example : `samsung.kim@samsung.com`	string	-
modifier_name optional	Modifier Last Name, First Name Example : `Kim Samsung`	string	-
name required	Group Name 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	Resource Name Example : `group`	any of [string, null]	group
roles required	Role Information	any of [array[Role], null]
service_name optional	Service Name Example : `Identity Access Management`	any of [string, null]	Identity Access Management
service_type optional	Service Type Example : `iam`	any of [string, null]	iam
srn optional	Samsung Resource Name Example : `srn:dev1:::::iam:group/0e0688b33641451a83d2ab8878666fda`	any of [string, null]
type required	Group Types Example : `USER_DEFINED`	string

2.9 - GroupCreateRequest

Name	Description	Schema
description required	Group Description Example : `Descriptions for group`	any of [string, null]
name required	Group Name 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	Created At Example : `2024-05-17T00:23:17Z`	string (date-time)
created_by required	Creator Example : `ef50cdc207f05f6fb8f20219f229ed1f`	string
creator_created_at required	Created At Example : `2024-05-17T00:23:17Z`	string (date-time)
creator_email optional	Creator 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	Creator Last Name, First Name Example : `Kim Samsung`	string	-
group_names optional	Group Names Example : `['TestGroup', 'SampleGroup']`	array[string]
user_created_at required	Created At Example : `2024-05-17T00:23:17Z`	string (date-time)
user_email optional	Group Member 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	Group Member Last Name, First Name 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	Group 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 Description Example : `Descriptions for group`	any of [string, null]
name required	Group Name 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	Company Name 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 Authentication Status Example :	boolean
first_name optional	User Name Example :	any of [string, null]
id required	ID Example :	string
last_login_at optional	Last Login Example :	any of [string (date-time), null]
last_name optional	User Last Name Example :	any of [string, null]
last_password_update_at optional	Last Password Update Time 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	Password Example :	string
password_reuse_count required	Password Reuse Count Example :	integer
phone_authenticated required	Phone Authentication Status Example :	boolean
policies required	User Policies	any of [array[Policy], null]
state optional	Status 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	User Description Example :	any of [string, null]
group_ids optional	Group IDs Example :	any of [array[string], null]
password required	Password Example :	string
policy_ids optional	Policy IDs Field 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	User Name Example : Pattern : `^[a-zA-Z0-9\+\.\@\-\_]$` Maximum length* : `64`	string

2.23 - IAMUserDeleteRequest

Name	Description	Schema	Default
user_ids optional	User ID List 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	Company Name 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	Creator Last Name, First 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 Authentication Status Example :	boolean
first_name optional	User Name Example :	any of [string, null]
id required	ID Example :	string
last_login_at optional	Last Login Example :	any of [string (date-time), null]
last_name optional	User Last Name Example :	any of [string, null]
last_password_update_at optional	Last Password Update Time 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	Modifier Last Name, First Name Example :	any of [string, null]
name optional	Name Example :	any of [string, null]
password_reuse_count required	Password Reuse Count Example :	integer
phone_authenticated required	Phone Authentication Status Example :	boolean
policies required	User Policies	any of [array[Policy], null]
resource_type optional	Service Example : `User`	any of [string, null]	User
service optional	Service Example : `iam`	any of [string, null]	iam
service_name optional	Service Name Example : `Identity Access Management`	any of [string, null]	Identity Access Management
srn required	Samsung Resource Name Example :	any of [string, null]
state optional	Status 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	Password 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	Company Name 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 Authentication Status Example :	boolean
first_name optional	User Name Example :	any of [string, null]
groups optional	Group Names Example :	any of [array[string], null]
id required	ID Example :	string
last_login_at optional	Last Login Example :	any of [string (date-time), null]
last_name optional	User Last Name Example :	any of [string, null]
last_password_update_at optional	Last Password Update Time 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	Password Reuse Count Example :	integer
phone_authenticated required	Phone Authentication Status Example :	boolean
policies required	User Policies	any of [array[Policy], null]
state optional	Status 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	User Description Example :	any of [string, null]
password_reuse_count required	Password Reuse Count 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	ID List Example : `['37f2e31ff86b415698d7e8eeafab445d']`	array[string]

2.33 - ListSamlProviderRemoveRequest

Name	Description	Schema	Default
ids optional	Credential 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	Account 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	Creator Email Example : `samsung.kim@samsung.com`	any of [string, null]	-
creator_name optional	Creator Last Name, First Name Example : `Kim Samsung`	any of [string, null]
default_version_id optional	Default Version Id Example : `c1b1fc611eb34eccbccfb563f77395ee`	string
description optional	Description Example : `Descriptions for policy`	any of [string, null]
domain_name required	Domain Name 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	Modifier Email Example : `samsung.kim@samsung.com`	any of [string, null]	-
modifier_name optional	Modifier Last Name, First Name 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	Service Name 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	Samsung Resource Name 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 [Group, 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 [Role, 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 [UserResponse, 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 Versions	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 to Exclude Example : `['37f2e31ff86b415698d7e8eeafab445d']`	any of [array[string], null]

2.42 - PolicySetRequest

Name	Description	Schema
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_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	Account 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	Creator Email Example : `samsung.kim@samsung.com`	any of [string, null]	-
creator_name optional	Creator Last Name, First Name Example : `Kim Samsung`	any of [string, null]
default_version_id optional	Default Version Id Example : `c1b1fc611eb34eccbccfb563f77395ee`	string
description optional	Description Example : `Descriptions for policy`	any of [string, null]
domain_name required	Domain Name 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	Modifier Email Example : `samsung.kim@samsung.com`	any of [string, null]	-
modifier_name optional	Modifier Last Name, First Name 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	Service Name 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	Samsung Resource Name 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	Account 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	Creator Email Example : `samsung.kim@samsung.com`	any of [string, null]	-
creator_name optional	Creator Last Name, First Name Example : `Kim Samsung`	any of [string, null]
default_version_id optional	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	Modifier Email Example : `samsung.kim@samsung.com`	any of [string, null]	-
modifier_name optional	Modifier Last Name, First Name 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	Service Name 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	Account ID Example :	any of [string, null]
assume_role_policy_document required	Role Trust Policy	PolicyDocument
created_at required	Created At Example : `2024-05-17T00:23:17Z`	string (date-time)
created_by required	Creator Example : `ef50cdc207f05f6fb8f20219f229ed1f`	string
creator_email optional	Creator Email Example :	any of [string, null]
creator_name optional	Creator Last Name, First Name Example :	any of [string, null]
description required	Role Description Example :	any of [string, null]
id required	ID Example : `f39c460fade34fecb05ede8f904b24b7`	string
max_session_duration required	Role Maximum Session Duration (seconds) Example :	integer
modified_at required	Modified At Example : `2024-05-17T00:23:17Z`	string (date-time)
modified_by required	Modifier Example : `ef50cdc207f05f6fb8f20219f229ed1f`	string
modifier_email optional	Modifier Email Example :	any of [string, null]
modifier_name optional	Modifier Last Name, First Name Example :	any of [string, null]
name required	Role Name Example :	string
policies required	Policy List Attached to Role	any of [array[Policy], null]
type optional	Role Type Example : `USER_DEFINED`	enum (USER_DEFINED, SERVICE, SERVICE_LINKED)	USER_DEFINED

2.51 - RoleBulkDeleteRequest

Name	Description	Schema
account_id optional	Account ID Example :	any of [string, null]
role_ids optional	Role ID List Example :	any of [array[string], null]
role_names optional	Role Name List Example :	any of [array[string], null]

2.52 - RoleCreateRequest

Name	Description	Schema	Default
account_id optional	Account ID Example :	any of [string, null]
assume_role_policy_document optional	Role Trust Policy 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	Role Description Example :	any of [string, null]
max_session_duration optional	Role Maximum Session Duration (seconds) Example : `3600` Minimum : `3600` Maximum : `43200`	integer	3600
name required	Role Name Example : Pattern : `^[a-zA-Z0-9\+\=\,\.\@\-\_]$` Maximum length* : `64`	string
policy_ids required	Policy ID List to Attach to Role Example : `['37f2e31ff86b415698d7e8eeafab445d']`	array[string]
principals optional	Trust Policy Principal List Example : `[{'type': 'SRN', 'value': 'srn:e:1234:::iam:user/abc1234'}]`	any of [array[RoleTrustPolicyPrincipal], null]
tags optional	Role Tag Example : `[{'key': 'company', 'value': 'SDS'}]`	any of [array[object[string]], null]

2.53 - RoleCreateRequestV1Dot3

Name	Description	Schema	Default
account_id optional	Account ID Example :	any of [string, null]
assume_role_policy_document optional	Role Trust Policy 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	Role Description Example :	any of [string, null]
max_session_duration optional	Role Maximum Session Duration (seconds) Example : `3600` Minimum : `3600` Maximum : `43200`	integer	3600
name required	Role Name Example : Pattern : `^[a-zA-Z0-9\+\=\,\.\@\-\_]$` Maximum length* : `64`	string
policy_ids required	Policy ID List to Attach to Role Example : `['37f2e31ff86b415698d7e8eeafab445d']`	array[string]
principals optional	Trust Policy Principal List Example : `[{'type': 'SRN', 'value': 'srn:e:1234:::iam:user/abc1234'}]`	any of [array[RoleTrustPolicyPrincipal], null]
role_type optional	Role Type Example : `USER_DEFINED`	any of [string, null]	USER_DEFINED
tags optional	Role Tag Example : `[{'key': 'company', 'value': 'SDS'}]`	any of [array[object[string]], null]

2.54 - 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.55 - 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.56 - RolePolicyBindingRequest

Name	Description	Schema	Default
policy_ids required	Policy ID List to Attach to Role	array[string]

2.57 - RolePolicyBindingResponse

Name	Description	Schema	Default
policies required		array[Policy]

2.58 - RoleSetRequest

Name	Description	Schema	Default
description optional	Role Description Example :	any of [string, null]
max_session_duration optional	Role Maximum Session Duration (seconds) Example : `3600`	any of [integer, null]

2.59 - RoleShowResponse

Name	Description	Schema	Default
role required		Role

2.60 - RoleTrustPolicyPrincipal

Name	Description	Schema	Default
type required	Trust Policy Principal Type Example :	string
value required	Trust Policy Principal Example :	string

2.61 - RoleTrustPolicyRequest

Name	Description	Schema	Default
assume_role_policy_document required	Role Trust Policy Example : `{'Statement': [{'Action': ['sts:AssumeRole'], 'Condition': {}, 'Effect': 'Allow', 'Principal': 'srn:e:1234:::iam:user/abc1234', 'Resource': [], 'Sid': 'statement1'}], 'Version': '2024-07-01'}`	PolicyDocument

2.62 - 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.63 - SamlProviderCreateRequest

Name	Description	Schema
description optional	Credential Provider Description Example : `SAML provider Description`	any of [string, null]
federation_type required	Credential Provider Type Example : `SAML`	string
file optional	Metadata File Example : `keycloak-idp-saml.xml`	string (binary)
saml_provider_name required	Credential Provider Name Example : `IdpTest`	string
tags optional	Tags Example : `[{'key': 'company', 'value': 'SDS'}]`	any of [array[object[string]], null]

2.64 - 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	Creator Example :	any of [string, null]
description optional	Credential Provider Description Example :	any of [string, null]
federation_type optional	Credential Provider Type Example :	any of [string, null]
id required	ID Example : `0fdd87aab8cb46f59b7c1f81ed03fb3e`	string
idp_cert_end optional	Validity Period Example :	any of [string (date-time), null]
idp_file_name optional	Metadata File Name Example :	any of [string, null]
idp_file_size optional	Metadata File Size Example :	any of [integer, null]
idp_issuer_url optional	Issuer URL Example :	any of [string, null]
idp_sso_url optional	SSO Service Location 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	Modifier Example :	any of [string, null]
saml_provider_name optional	Credential Provider Name Example :	any of [string, null]

2.65 - 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	Creator Example :	any of [string, null]
description optional	Credential Provider Description Example :	any of [string, null]
federation_type optional	Credential Provider Type Example :	any of [string, null]
id required	ID Example : `0fdd87aab8cb46f59b7c1f81ed03fb3e`	string
idp_cert_end optional	Validity Period Example :	any of [string (date-time), null]
idp_file_data optional	Metadata Content Example :	any of [string, null]
idp_file_name optional	Metadata File Name Example :	any of [string, null]
idp_file_size optional	Metadata File Size Example :	any of [integer, null]
idp_issuer_url optional	Issuer URL Example :	any of [string, null]
idp_sso_url optional	SSO Service Location 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	Modifier Example :	any of [string, null]
saml_provider_name optional	Credential Provider Name Example :	any of [string, null]

2.66 - 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	Creator Example :	any of [string, null]
description optional	Credential Provider Description Example :	any of [string, null]
federation_type optional	Credential Provider Type 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	Modifier Example :	any of [string, null]
saml_provider_name optional	Credential Provider Name Example :	any of [string, null]

2.67 - SamlProviderUpdateRequestData

Name	Description	Schema
description optional	Credential Provider Description Example : `SAML provider Description`	string
file optional	Metadata File Example : `keycloak-idp-saml.xml`	string (binary)
saml_provider_name optional	Credential Provider Name Example : `IdpTest`	any of [string, null]
tags optional	Tags Example : `[{'key': 'company', 'value': 'SDS'}]`	any of [array[object[string]], null]

2.68 - 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.69 - 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.70 - ServiceAccountListResponse

Name	Description	Schema	Default
service_accounts required		array[ServiceAccount]

2.71 - ServiceAccountShowResponse

Name	Description	Schema	Default
service_account required		ServiceAccountDetail

2.72 - 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.73 - 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.74 - 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.75 - 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	User ID Example :	string

2.76 - UserPolicyRequest

Name	Description	Schema	Default
policy_ids optional	User Policy Bindings	array[string]

2.77 - UserPolicyResponse

Name	Description	Schema	Default
policies required	User Policy	array[Policy]
user_id required	User ID Example :	string

2.78 - UserResponse

Name	Description	Schema
account_id optional	Account ID Example :	any of [string, null]
company_name optional	Company Name 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 Authentication Status Example :	boolean
first_name optional	User Name Example :	any of [string, null]
id required	ID Example :	string
last_login_at optional	Last Login Example :	any of [string (date-time), null]
last_name optional	User Last Name Example :	any of [string, null]
last_password_update_at optional	Last Password Update Time 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	Password Reuse Count Example :	integer
phone_authenticated required	Phone Authentication Status Example :	boolean
policies required	User Policies	any of [array[Policy], null]
state optional	Status 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]