이 섹션의 다중 페이지 출력 화면임. 여기를 클릭하여 프린트.
APIs
- 1: AcceptInvitation
- 2: AttachPolicyBindings
- 3: CancelInvitations
- 4: CreateAccount
- 5: CreateDelegationPolicy
- 6: CreateInvitation
- 7: CreateOrganization
- 8: CreateOrganizationUnit
- 9: CreateServiceControlPolicy
- 10: DeclineInvitation
- 11: DeleteDelegationPolicy
- 12: DeleteOrganization
- 13: DeleteOrganizationUnits
- 14: DeleteServiceControlPolicies
- 15: LeaveOrganization
- 16: ListAccountInvitations
- 17: ListAccounts
- 18: ListOrganizationInvitations
- 19: ListOrganizations
- 20: ListOrganizationUnits
- 21: ListParents
- 22: ListPoliciesForTarget
- 23: ListServiceControlPolicies
- 24: ListTargetsForPolicy
- 25: MoveAccount
- 26: RemoveAccounts
- 27: RemovePolicyBindings
- 28: SetDelegationPolicy
- 29: SetOrganization
- 30: SetOrganizationUnit
- 31: SetServiceControlPolicy
- 32: ShowAccount
- 33: ShowDelegationPolicy
- 34: ShowOrganization
- 35: ShowOrganizationUnit
- 36: ShowServiceControlPolicy
1 - AcceptInvitation
1.1 - 1.1
put /v1/invitations/{invitation_id}/accept
Description
accept a specific invitation
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| path | invitation_id required | 초대 ID Example : 138c2fc8c29a449dbfa8681f8f1d78e2 | string | None |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | InvitationAcceptResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/invitations/{invitation_id}/accept
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.1"
Example HTTP response
Response 200
{
"failed_id": {
"error_code": "Invitation.AlreadySentError",
"failed_caused": "Account b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0 is not found",
"failed_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"failed_name": "My Organization"
},
"master_account_email": "score@samsung.com",
"success_id": {
"success_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"success_name": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5"
}
}
1.2 - 1.0
put /v1/invitations/{invitation_id}/accept
Description
accept a specific invitation
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| path | invitation_id required | 초대 ID Example : 138c2fc8c29a449dbfa8681f8f1d78e2 | string | None |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | InvitationAcceptResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/invitations/{invitation_id}/accept
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.0"
Example HTTP response
Response 200
{
"failed_id": {
"error_code": "Invitation.AlreadySentError",
"failed_caused": "Account b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0 is not found",
"failed_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"failed_name": "My Organization"
},
"master_account_email": "score@samsung.com",
"success_id": {
"success_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"success_name": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5"
}
}
2 - AttachPolicyBindings
2.1 - 1.1
post /v1/assignments/policy-bindings
Description
attach policy bindings
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| body | body required | PolicyAttachRequest |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | ControlPolicyAssignmentResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/assignments/policy-bindings
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.1"
Request body
{
"entity": "POLICY",
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"policy_ids": [
"f98e76d54c32b10a9z8y7x6w5v4u3"
],
"target_ids": [
"ou-1a2b3c4d5e6f7g8h9i0j1k2l3m4n5"
]
}
Example HTTP response
Response 200
{
"failed_ids": [
{
"error_code": "Conflict",
"failed_caused": "Account 482d111a302547fbbd11ee0141ea23bb is not found",
"failed_id": "ou-1a2b3c4d5e6f7g8h9i0j1k2l3m4n5"
}
],
"success_ids": [
"ou-1a2b3c4d5e6f7g8h9i0j1k2l3m4n5"
]
}
2.2 - 1.0
post /v1/assignments/policy-bindings
Description
attach policy bindings
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| body | body required | PolicyAttachRequest |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | ControlPolicyAssignmentResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/assignments/policy-bindings
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.0"
Request body
{
"entity": "POLICY",
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"policy_ids": [
"f98e76d54c32b10a9z8y7x6w5v4u3"
],
"target_ids": [
"ou-1a2b3c4d5e6f7g8h9i0j1k2l3m4n5"
]
}
Example HTTP response
Response 200
{
"failed_ids": [
{
"error_code": "Conflict",
"failed_caused": "Account 482d111a302547fbbd11ee0141ea23bb is not found",
"failed_id": "ou-1a2b3c4d5e6f7g8h9i0j1k2l3m4n5"
}
],
"success_ids": [
"ou-1a2b3c4d5e6f7g8h9i0j1k2l3m4n5"
]
}
3 - CancelInvitations
3.1 - 1.1
put /v1/invitations/cancel
Description
cancel invitations
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| body | body required | InvitationCancelRequest |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | InvitationCancelResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/invitations/cancel
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.1"
Request body
{
"ids": [
"138c2fc8c29a449dbfa8681f8f1d78e2"
],
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5"
}
Example HTTP response
Response 200
{
"success_ids": [
"138c2fc8c29a449dbfa8681f8f1d78e2"
]
}
3.2 - 1.0
put /v1/invitations/cancel
Description
cancel invitations
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| body | body required | InvitationCancelRequest |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | InvitationCancelResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/invitations/cancel
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.0"
Request body
{
"ids": [
"138c2fc8c29a449dbfa8681f8f1d78e2"
],
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5"
}
Example HTTP response
Response 200
{
"success_ids": [
"138c2fc8c29a449dbfa8681f8f1d78e2"
]
}
4 - CreateAccount
4.1 - 1.1
post /v1/organization-accounts
Description
create a account
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| body | body required | OrganizationUserCreateRequest |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 201 | Created | AccountCreateResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/organization-accounts
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.1"
Request body
{
"login_id": "log-archive@samsung.com",
"name": "score-account",
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"role_name": "OrganizationAccountAccessRole"
}
Example HTTP response
Response 201
{
"failed": {
"error_code": "Organization.AccountNotRemovable",
"failed_caused": "Account b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0 is not found"
},
"success": {
"success_id": "b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0",
"success_name": "score-account"
}
}
4.2 - 1.0
post /v1/organization-accounts
Description
create a account
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| body | body required | OrganizationUserCreateRequest |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 201 | Created | AccountCreateResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/organization-accounts
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.0"
Request body
{
"login_id": "log-archive@samsung.com",
"name": "score-account",
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"role_name": "OrganizationAccountAccessRole"
}
Example HTTP response
Response 201
{
"failed": {
"error_code": "Organization.AccountNotRemovable",
"failed_caused": "Account b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0 is not found"
},
"success": {
"success_id": "b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0",
"success_name": "score-account"
}
}
5 - CreateDelegationPolicy
5.1 - 1.1
post /v1/delegation-policies
Description
create a delegation policy
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| body | body required | DelegationPolicyCreateRequest |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 201 | Created | DelegationPolicyShowResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/delegation-policies
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.1"
Request body
{
"document": {
"Statement": [
{
"Action": [
"organization:CreateServiceControlPolicy",
"organization:DeleteServiceControlPolicies",
"organization:SetServiceControlPolicy",
"organization:ShowServiceControlPolicy",
"organization:ListServiceControlPolicies",
"organization:ShowAccount",
"organization:ListAccounts",
"organization:ListOrganizationUnits",
"organization:ListOrganizationInvitations",
"organization:ListParents",
"organization:ListPoliciesForTarget",
"organization:ListTargetsForPolicy",
"organization:AttachPolicyBindings",
"organization:RemovePolicyBindings",
"organization:ShowDelegatePolicy"
],
"Effect": "Allow",
"Principal": {
"scp": [
"srn:dev2::f045159f40c64125a1fe61bd71d1c14c:::iam:user/e3a6e3f99c1040639e9a3c8f8b7427df"
]
},
"Resource": [
"*"
],
"Sid": "statement1"
}
],
"Version": "2024-07-01"
},
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5"
}
Example HTTP response
Response 201
{
"policy": {
"created_at": "2024-12-19 01:09:05.000",
"created_by": "c23fb561c689455993874fa5d5ed4a2f",
"document": {
"Statement": [
{
"Action": [
"organization:CreateServiceControlPolicy",
"organization:DeleteServiceControlPolicies",
"organization:SetServiceControlPolicy",
"organization:ShowServiceControlPolicy",
"organization:ListServiceControlPolicies",
"organization:ShowAccount",
"organization:ListAccounts",
"organization:ListOrganizationUnits",
"organization:ListOrganizationInvitations",
"organization:ListParents",
"organization:ListPoliciesForTarget",
"organization:ListTargetsForPolicy",
"organization:AttachPolicyBindings",
"organization:RemovePolicyBindings",
"organization:ShowDelegatePolicy"
],
"Effect": "Allow",
"Principal": {
"scp": [
"srn:dev2::f045159f40c64125a1fe61bd71d1c14c:::iam:user/e3a6e3f99c1040639e9a3c8f8b7427df"
]
},
"Resource": [
"*"
],
"Sid": "statement1"
}
],
"Version": "2024-07-01"
},
"modified_at": "2023-10-15 14:30:00",
"modified_by": "c23fb561c689455993874fa5d5ed4a2f",
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5"
}
}
5.2 - 1.0
post /v1/delegation-policies
Description
create a delegation policy
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| body | body required | DelegationPolicyCreateRequest |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 201 | Created | DelegationPolicyShowResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/delegation-policies
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.0"
Request body
{
"document": {
"Statement": [
{
"Action": [
"organization:CreateServiceControlPolicy",
"organization:DeleteServiceControlPolicies",
"organization:SetServiceControlPolicy",
"organization:ShowServiceControlPolicy",
"organization:ListServiceControlPolicies",
"organization:ShowAccount",
"organization:ListAccounts",
"organization:ListOrganizationUnits",
"organization:ListOrganizationInvitations",
"organization:ListParents",
"organization:ListPoliciesForTarget",
"organization:ListTargetsForPolicy",
"organization:AttachPolicyBindings",
"organization:RemovePolicyBindings",
"organization:ShowDelegatePolicy"
],
"Effect": "Allow",
"Principal": {
"scp": [
"srn:dev2::f045159f40c64125a1fe61bd71d1c14c:::iam:user/e3a6e3f99c1040639e9a3c8f8b7427df"
]
},
"Resource": [
"*"
],
"Sid": "statement1"
}
],
"Version": "2024-07-01"
},
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5"
}
Example HTTP response
Response 201
{
"policy": {
"created_at": "2024-12-19 01:09:05.000",
"created_by": "c23fb561c689455993874fa5d5ed4a2f",
"document": {
"Statement": [
{
"Action": [
"organization:CreateServiceControlPolicy",
"organization:DeleteServiceControlPolicies",
"organization:SetServiceControlPolicy",
"organization:ShowServiceControlPolicy",
"organization:ListServiceControlPolicies",
"organization:ShowAccount",
"organization:ListAccounts",
"organization:ListOrganizationUnits",
"organization:ListOrganizationInvitations",
"organization:ListParents",
"organization:ListPoliciesForTarget",
"organization:ListTargetsForPolicy",
"organization:AttachPolicyBindings",
"organization:RemovePolicyBindings",
"organization:ShowDelegatePolicy"
],
"Effect": "Allow",
"Principal": {
"scp": [
"srn:dev2::f045159f40c64125a1fe61bd71d1c14c:::iam:user/e3a6e3f99c1040639e9a3c8f8b7427df"
]
},
"Resource": [
"*"
],
"Sid": "statement1"
}
],
"Version": "2024-07-01"
},
"modified_at": "2023-10-15 14:30:00",
"modified_by": "c23fb561c689455993874fa5d5ed4a2f",
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5"
}
}
6 - CreateInvitation
6.1 - 1.1
post /v1/invitations
Description
create an invitation
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| body | body required | InvitationCreateRequest |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 201 | Created | InvitationCreateResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/invitations
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.1"
Request body
{
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"target_login_ids": [
"score-1@samsung.com"
]
}
Example HTTP response
Response 201
{
"failed_ids": [
{
"error_code": "Invitation.AlreadySentError",
"failed_caused": "Account b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0 is not found",
"failed_id": [
"score-1@samsung.com"
]
}
],
"success_ids": [
"log-archive@samsung.com"
]
}
6.2 - 1.0
post /v1/invitations
Description
create an invitation
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| body | body required | InvitationCreateRequest |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 201 | Created | InvitationCreateResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/invitations
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.0"
Request body
{
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"target_login_ids": [
"score-1@samsung.com"
]
}
Example HTTP response
Response 201
{
"failed_ids": [
{
"error_code": "Invitation.AlreadySentError",
"failed_caused": "Account b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0 is not found",
"failed_id": [
"score-1@samsung.com"
]
}
],
"success_ids": [
"log-archive@samsung.com"
]
}
7 - CreateOrganization
7.1 - 1.1
post /v1/organizations
Description
create a organization
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| body | body required | OrganizationCreateRequest |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 201 | Created | OrganizationShowResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
| 409 | Conflict | None |
Example HTTP request
Request path
/v1/organizations
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.1"
Request body
{
"name": "My Organization"
}
Example HTTP response
Response 201
{
"organization": {
"created_at": "2024-12-19 01:09:05.000",
"created_by": "c23fb561c689455993874fa5d5ed4a2f",
"creator_name": "John Doe na",
"delegation_account_id": "124e7d6c5b4a3z2y1x0w9v8u7t6s5r",
"id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"master_account_email": "admin@example.com",
"master_account_id": "9f8e7d6c5b4a3z2y1x0w9v8u7t6s5r",
"modified_at": "2023-10-15 14:30:00",
"modified_by": "c23fb561c689455993874fa5d5ed4a2f",
"modifier_name": "Alice",
"name": "My Organization",
"root_unit_id": "r-abcd7d6c5b4a3z2y1x0w9v8u7t6s5r",
"srn": "srn:dev2::1b8c29a138d78e24bf1fa86812fcaa:kr-west1::organizations/organization/o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"use_scp_yn": true
}
}
7.2 - 1.0
post /v1/organizations
Description
create a organization
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| body | body required | OrganizationCreateRequest |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 201 | Created | OrganizationShowResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
| 409 | Conflict | None |
Example HTTP request
Request path
/v1/organizations
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.0"
Request body
{
"name": "My Organization"
}
Example HTTP response
Response 201
{
"organization": {
"created_at": "2024-12-19 01:09:05.000",
"created_by": "c23fb561c689455993874fa5d5ed4a2f",
"creator_name": "John Doe na",
"delegation_account_id": "124e7d6c5b4a3z2y1x0w9v8u7t6s5r",
"id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"master_account_email": "admin@example.com",
"master_account_id": "9f8e7d6c5b4a3z2y1x0w9v8u7t6s5r",
"modified_at": "2023-10-15 14:30:00",
"modified_by": "c23fb561c689455993874fa5d5ed4a2f",
"modifier_name": "Alice",
"name": "My Organization",
"root_unit_id": "r-abcd7d6c5b4a3z2y1x0w9v8u7t6s5r",
"srn": "srn:dev2::1b8c29a138d78e24bf1fa86812fcaa:kr-west1::organizations/organization/o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"use_scp_yn": true
}
}
8 - CreateOrganizationUnit
8.1 - 1.1
post /v1/organization-units
Description
create an organization unit
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| body | body required | OrganizationUnitCreateRequest |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 201 | Created | OrganizationUnitCreateResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/organization-units
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.1"
Request body
{
"description": "에스코어 조직 단위",
"name": "score-organization-unit",
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"parent_unit_id": "ou-fc8c29a138d78e24bf1fa86812fc8b",
"policy_ids": [
"f98e76d54c32b10a9z8y7x6w5v4u3"
]
}
Example HTTP response
Response 201
{
"organization_unit": {
"control_policies": [
{
"policy_id": "f98e76d54c32b10a9z8y7x6w5v4u3",
"policy_name": "test-policy-name"
}
],
"created_at": "2024-12-19 01:09:05.000",
"created_by": "c23fb561c689455993874fa5d5ed4a2f",
"creator_name": "John Doe na",
"depth": 1,
"description": "에스코어 조직 단위",
"id": "ou-c29a138f8f1d78e24dbfa8681fc2fc8",
"modified_at": "2023-10-15 14:30:00",
"modified_by": "c23fb561c689455993874fa5d5ed4a2f",
"modifier_name": "Alice",
"name": "score-organization-unit",
"parent_unit_id": "ou-fc8c29a138d78e24bf1fa86812fc8b",
"service_name": "Organization",
"srn": "srn:dev2::1b8c29a138d78e24bf1fa86812fcaa:kr-west1::organizations/ou/ou-c29a138f8f1d78e24dbfa8681fc2fc8",
"type": "OU"
}
}
8.2 - 1.0
post /v1/organization-units
Description
create an organization unit
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| body | body required | OrganizationUnitCreateRequest |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 201 | Created | OrganizationUnitCreateResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/organization-units
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.0"
Request body
{
"description": "에스코어 조직 단위",
"name": "score-organization-unit",
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"parent_unit_id": "ou-fc8c29a138d78e24bf1fa86812fc8b",
"policy_ids": [
"f98e76d54c32b10a9z8y7x6w5v4u3"
]
}
Example HTTP response
Response 201
{
"organization_unit": {
"control_policies": [
{
"policy_id": "f98e76d54c32b10a9z8y7x6w5v4u3",
"policy_name": "test-policy-name"
}
],
"created_at": "2024-12-19 01:09:05.000",
"created_by": "c23fb561c689455993874fa5d5ed4a2f",
"creator_name": "John Doe na",
"depth": 1,
"description": "에스코어 조직 단위",
"id": "ou-c29a138f8f1d78e24dbfa8681fc2fc8",
"modified_at": "2023-10-15 14:30:00",
"modified_by": "c23fb561c689455993874fa5d5ed4a2f",
"modifier_name": "Alice",
"name": "score-organization-unit",
"parent_unit_id": "ou-fc8c29a138d78e24bf1fa86812fc8b",
"service_name": "Organization",
"srn": "srn:dev2::1b8c29a138d78e24bf1fa86812fcaa:kr-west1::organizations/ou/ou-c29a138f8f1d78e24dbfa8681fc2fc8",
"type": "OU"
}
}
9 - CreateServiceControlPolicy
9.1 - 1.1
post /v1/service-control-policies
Description
create a service control policy
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| body | body required | ServiceControlPolicyCreateRequest |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 201 | Created | ServiceControlPolicyShowResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/service-control-policies
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.1"
Request body
{
"description": "This is an example policy.",
"document": {
"Statement": [
{
"Action": [
"*"
],
"Effect": "Allow",
"Resource": [
"*"
],
"Sid": "statement1"
}
],
"Version": "2024-07-01"
},
"name": "MyPolicy",
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"type": "MANAGED"
}
Example HTTP response
Response 201
{
"policy": {
"category": "SCP",
"created_at": "2024-12-19 01:09:05.000",
"created_by": "c23fb561c689455993874fa5d5ed4a2f",
"creator_name": "John Doe na",
"description": "This is an example policy.",
"document": {
"Statement": [
{
"Action": [
"*"
],
"Effect": "Allow",
"Resource": [
"*"
],
"Sid": "statement1"
}
],
"Version": "2024-07-01"
},
"id": "138c2fc8c29a449dbfa8681f8f1d78e2",
"modified_at": "2023-10-15 14:30:00",
"modified_by": "c23fb561c689455993874fa5d5ed4a2f",
"modifier_name": "Alice",
"name": "MyPolicy",
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"service_name": "Organization",
"source": "ORGANIZATION",
"srn": "srn:dev2::1b8c29a138d78e24bf1fa86812fcaa:kr-west1::organizations/service-control-policy/138c2fc8c29a449dbfa8681f8f1d78e2",
"state": "ACTIVE",
"type": "MANAGED"
}
}
9.2 - 1.0
post /v1/service-control-policies
Description
create a service control policy
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| body | body required | ServiceControlPolicyCreateRequest |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 201 | Created | ServiceControlPolicyShowResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/service-control-policies
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.0"
Request body
{
"description": "This is an example policy.",
"document": {
"Statement": [
{
"Action": [
"*"
],
"Effect": "Allow",
"Resource": [
"*"
],
"Sid": "statement1"
}
],
"Version": "2024-07-01"
},
"name": "MyPolicy",
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"type": "MANAGED"
}
Example HTTP response
Response 201
{
"policy": {
"category": "SCP",
"created_at": "2024-12-19 01:09:05.000",
"created_by": "c23fb561c689455993874fa5d5ed4a2f",
"creator_name": "John Doe na",
"description": "This is an example policy.",
"document": {
"Statement": [
{
"Action": [
"*"
],
"Effect": "Allow",
"Resource": [
"*"
],
"Sid": "statement1"
}
],
"Version": "2024-07-01"
},
"id": "138c2fc8c29a449dbfa8681f8f1d78e2",
"modified_at": "2023-10-15 14:30:00",
"modified_by": "c23fb561c689455993874fa5d5ed4a2f",
"modifier_name": "Alice",
"name": "MyPolicy",
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"service_name": "Organization",
"source": "ORGANIZATION",
"srn": "srn:dev2::1b8c29a138d78e24bf1fa86812fcaa:kr-west1::organizations/service-control-policy/138c2fc8c29a449dbfa8681f8f1d78e2",
"state": "ACTIVE",
"type": "MANAGED"
}
}
10 - DeclineInvitation
10.1 - 1.1
put /v1/invitations/{invitation_id}/decline
Description
decline a specific invitation
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| path | invitation_id required | 초대 ID Example : 138c2fc8c29a449dbfa8681f8f1d78e2 | string | None |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | InvitationShowResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/invitations/{invitation_id}/decline
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.1"
Example HTTP response
Response 200
{
"invitation": {
"created_at": "2024-12-19 01:09:05.000",
"created_by": "c23fb561c689455993874fa5d5ed4a2f",
"expired_time": "2024-04-30T12:34:56.789Z",
"id": "138c2fc8c29a449dbfa8681f8f1d78e2",
"master_account_id": "9f8e7d6c5b4a3z2y1x0w9v8u7t6s5r",
"modified_at": "2023-10-15 14:30:00",
"modified_by": "c23fb561c689455993874fa5d5ed4a2f",
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"requested_time": "2024-04-17T12:34:56.789Z",
"state": "REFUSED",
"target_account_id": "338c2fc8c29a449dbfa8681f8f1d78e5"
}
}
10.2 - 1.0
put /v1/invitations/{invitation_id}/decline
Description
decline a specific invitation
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| path | invitation_id required | 초대 ID Example : 138c2fc8c29a449dbfa8681f8f1d78e2 | string | None |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | InvitationShowResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/invitations/{invitation_id}/decline
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.0"
Example HTTP response
Response 200
{
"invitation": {
"created_at": "2024-12-19 01:09:05.000",
"created_by": "c23fb561c689455993874fa5d5ed4a2f",
"expired_time": "2024-04-30T12:34:56.789Z",
"id": "138c2fc8c29a449dbfa8681f8f1d78e2",
"master_account_id": "9f8e7d6c5b4a3z2y1x0w9v8u7t6s5r",
"modified_at": "2023-10-15 14:30:00",
"modified_by": "c23fb561c689455993874fa5d5ed4a2f",
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"requested_time": "2024-04-17T12:34:56.789Z",
"state": "REFUSED",
"target_account_id": "338c2fc8c29a449dbfa8681f8f1d78e5"
}
}
11 - DeleteDelegationPolicy
11.1 - 1.1
delete /v1/delegation-policies
Description
delete a specific delegation policy
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| query | organization_id optional | 조직 ID Example : o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5 | any of [string, null] | None |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 204 | No Content | None |
| 403 | Forbidden | None |
Example HTTP request
Request path
/v1/delegation-policies
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.1"
Example HTTP response
Response 204
11.2 - 1.0
delete /v1/delegation-policies
Description
delete a specific delegation policy
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| query | organization_id optional | 조직 ID Example : o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5 | any of [string, null] | None |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 204 | No Content | None |
| 403 | Forbidden | None |
Example HTTP request
Request path
/v1/delegation-policies
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.0"
Example HTTP response
Response 204
12 - DeleteOrganization
12.1 - 1.1
delete /v1/organizations/{organization_id}
Description
delete a specific organization
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| path | organization_id required | 조직 ID Example : o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5 | string | None |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | OrganizationDeleteResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/organizations/{organization_id}
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.1"
Example HTTP response
Response 200
{
"failed": {
"error_code": "Organization.delete.MemberAccountIsExist",
"failed_caused": "Payment method registration required.",
"failed_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5"
},
"success": "My Organization"
}
12.2 - 1.0
delete /v1/organizations/{organization_id}
Description
delete a specific organization
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| path | organization_id required | 조직 ID Example : o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5 | string | None |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | OrganizationDeleteResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/organizations/{organization_id}
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.0"
Example HTTP response
Response 200
{
"failed": {
"error_code": "Organization.delete.MemberAccountIsExist",
"failed_caused": "Payment method registration required.",
"failed_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5"
},
"success": "My Organization"
}
13 - DeleteOrganizationUnits
13.1 - 1.1
delete /v1/organization-units
Description
delete organization units
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| body | body required | OrganizationUnitDeleteRequest |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | OrganizationUnitDeleteResponse |
| 403 | Forbidden | None |
Example HTTP request
Request path
/v1/organization-units
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.1"
Request body
{
"ids": [
"ou-c29a138f8f1d78e24dbfa8681fc2fc8"
],
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5"
}
Example HTTP response
Response 200
{
"failed_ids": [
{
"error_code": "Organization.UnitNotRemovable",
"failed_caused": "Account b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0 is not found",
"failed_id": "ou-abc1f2h1j0l9n8p7r6t5v4x3z2y1w0"
}
],
"success_ids": [
"ou-c29a138f8f1d78e24dbfa8681fc2fc8"
]
}
13.2 - 1.0
delete /v1/organization-units
Description
delete organization units
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| body | body required | OrganizationUnitDeleteRequest |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | OrganizationUnitDeleteResponse |
| 403 | Forbidden | None |
Example HTTP request
Request path
/v1/organization-units
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.0"
Request body
{
"ids": [
"ou-c29a138f8f1d78e24dbfa8681fc2fc8"
],
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5"
}
Example HTTP response
Response 200
{
"failed_ids": [
{
"error_code": "Organization.UnitNotRemovable",
"failed_caused": "Account b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0 is not found",
"failed_id": "ou-abc1f2h1j0l9n8p7r6t5v4x3z2y1w0"
}
],
"success_ids": [
"ou-c29a138f8f1d78e24dbfa8681fc2fc8"
]
}
14 - DeleteServiceControlPolicies
14.1 - 1.1
delete /v1/service-control-policies
Description
delete service control policies
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| body | body required | ServiceControlPolicyDeleteRequest |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | ServiceControlPolicyDeleteResponse |
| 403 | Forbidden | None |
Example HTTP request
Request path
/v1/service-control-policies
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.1"
Request body
{
"ids": [
"138c2fc8c29a449dbfa8681f8f1d78e2"
],
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5"
}
Example HTTP response
Response 200
{
"failed_ids": [
{
"binding_targets": [
{
"id": "ou-c29a138f8f1d78e24dbfa8681fc2fc8 또는 b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0",
"name": "score-organization-unit 또는 score-account",
"type": "OU"
}
],
"error_code": "Policy.PolicyInUseError",
"failed_caused": "The specified policy is in use and cannot be deleted.",
"failed_id": "138c2fc8c29a449dbfa8681f8f1d78e2"
}
],
"success_ids": [
""
]
}
14.2 - 1.0
delete /v1/service-control-policies
Description
delete service control policies
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| body | body required | ServiceControlPolicyDeleteRequest |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | ServiceControlPolicyDeleteResponse |
| 403 | Forbidden | None |
Example HTTP request
Request path
/v1/service-control-policies
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.0"
Request body
{
"ids": [
"138c2fc8c29a449dbfa8681f8f1d78e2"
],
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5"
}
Example HTTP response
Response 200
{
"failed_ids": [
{
"binding_targets": [
{
"id": "ou-c29a138f8f1d78e24dbfa8681fc2fc8 또는 b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0",
"name": "score-organization-unit 또는 score-account",
"type": "OU"
}
],
"error_code": "Policy.PolicyInUseError",
"failed_caused": "The specified policy is in use and cannot be deleted.",
"failed_id": "138c2fc8c29a449dbfa8681f8f1d78e2"
}
],
"success_ids": [
""
]
}
15 - LeaveOrganization
15.1 - 1.1
delete /v1/organizations/{organization_id}/membership
Description
leave a specific organization
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| path | organization_id required | 조직 ID Example : o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5 | string | None |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | OrganizationLeaveResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/organizations/{organization_id}/membership
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.1"
Example HTTP response
Response 200
{
"failed": {
"error_code": "Organization.AccountNotRemovable",
"failed_caused": "Payment method registration required.",
"failed_id": "b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0",
"failed_name": "My Organization"
},
"success": {
"success_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"success_name": "My Organization"
}
}
15.2 - 1.0
delete /v1/organizations/{organization_id}/membership
Description
leave a specific organization
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| path | organization_id required | 조직 ID Example : o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5 | string | None |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | OrganizationLeaveResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/organizations/{organization_id}/membership
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.0"
Example HTTP response
Response 200
{
"failed": {
"error_code": "Organization.AccountNotRemovable",
"failed_caused": "Payment method registration required.",
"failed_id": "b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0",
"failed_name": "My Organization"
},
"success": {
"success_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"success_name": "My Organization"
}
}
16 - ListAccountInvitations
16.1 - 1.1
get /v1/account-invitations
Description
get account invitation list
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | AccountInvitationResponse |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/account-invitations
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.1"
Example HTTP response
Response 200
{
"account_invitations": [
{
"created_at": "2024-12-19 01:09:05.000",
"created_by": "c23fb561c689455993874fa5d5ed4a2f",
"expired_time": "2024-04-30T12:34:56.789Z",
"id": "0a36e0746dbf4908acf0357829701381",
"master_account_email": "admin@example.com",
"master_account_id": "9f8e7d6c5b4a3z2y1x0w9v8u7t6s5r",
"master_account_login_id": "log-archive@samsung.com",
"master_account_name": "CoreKim",
"modified_at": "2023-10-15 14:30:00",
"modified_by": "c23fb561c689455993874fa5d5ed4a2f",
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"organization_name": "My Organization",
"requested_time": "2024-04-17T12:34:56.789Z",
"state": "INVITING",
"target_account_id": "338c2fc8c29a449dbfa8681f8f1d78e5"
}
],
"count": 5
}
16.2 - 1.0
get /v1/account-invitations
Description
get account invitation list
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | AccountInvitationResponse |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/account-invitations
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.0"
Example HTTP response
Response 200
{
"account_invitations": [
{
"created_at": "2024-12-19 01:09:05.000",
"created_by": "c23fb561c689455993874fa5d5ed4a2f",
"expired_time": "2024-04-30T12:34:56.789Z",
"id": "0a36e0746dbf4908acf0357829701381",
"master_account_email": "admin@example.com",
"master_account_id": "9f8e7d6c5b4a3z2y1x0w9v8u7t6s5r",
"master_account_login_id": "log-archive@samsung.com",
"master_account_name": "CoreKim",
"modified_at": "2023-10-15 14:30:00",
"modified_by": "c23fb561c689455993874fa5d5ed4a2f",
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"organization_name": "My Organization",
"requested_time": "2024-04-17T12:34:56.789Z",
"state": "INVITING",
"target_account_id": "338c2fc8c29a449dbfa8681f8f1d78e5"
}
],
"count": 5
}
17 - ListAccounts
17.1 - 1.1
get /v1/organization-accounts
Description
get accounts list
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| query | organization_id optional | 조직 ID Example : o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5 | any of [string, null] | 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 | id optional | 조직 계정 ID Example : b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0 | any of [string, null] | None |
| query | name optional | 계정명 Example : score-account | any of [string, null] | None |
| query | email optional | 계정 이메일 Example : score@samsung.com | any of [string, null] | None |
| query | login_id optional | 로그인 ID Example : log-archive@samsung.com | any of [string, null] | None |
| query | joined_start_date optional | 가입 조회 시작 일시 Example : 2024-05-17T12:34:56.789Z | any of [string, null] | None |
| query | joined_end_date optional | 가입 조회 종료 일시 Example : 2024-05-17T12:34:56.789Z | any of [string, null] | None |
| query | joined_method optional | 가입 방법 Example : INVITED | any of [enum (INVITED, CREATED, CLOUD_CONTROL), null] | None |
| query | exclude_policy_id optional | 제외할 정책 ID Example : 238c2fc8c29a449dbfa8681f8f1d78e2 | any of [string, null] | None |
| query | parent_unit_id optional | ROOT 또는 부모 조직 단위 ID Example : ou-fc8c29a138d78e24bf1fa86812fc8b | any of [string, null] | None |
| query | parent_unit_name optional | ROOT 또는 부모 조직 단위명 Example : parent-unit-name | any of [string, null] | None |
| query | type optional | 계정 유형 Example : MEMBER | any of [enum (MANAGEMENT, DELEGATION, MEMBER, NONE, LOG_ARCHIVE, AUDIT), null] | None |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | AccountPageResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/organization-accounts
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.1"
Example HTTP response
Response 200
{
"accounts": [
{
"created_at": "2024-12-19 01:09:05.000",
"created_by": "c23fb561c689455993874fa5d5ed4a2f",
"email": "score@samsung.com",
"id": "0a36e0746dbf4908acf0357829701381",
"joined_method": "INVITED",
"joined_time": "2024-05-17T12:34:56.789Z",
"login_id": "log-archive@samsung.com",
"modified_at": "2023-10-15 14:30:00",
"modified_by": "c23fb561c689455993874fa5d5ed4a2f",
"name": "score-account",
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"parent_unit_id": "ou-fc8c29a138d78e24bf1fa86812fc8b",
"parent_unit_name": "parent-unit-name",
"state": "ACTIVE",
"type": "MEMBER"
}
],
"count": 20,
"page": 0,
"size": 20,
"sort": [
"created_at:asc"
]
}
17.2 - 1.0
get /v1/organization-accounts
Description
get accounts list
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| query | organization_id optional | 조직 ID Example : o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5 | any of [string, null] | 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 | id optional | 조직 계정 ID Example : b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0 | any of [string, null] | None |
| query | name optional | 계정명 Example : score-account | any of [string, null] | None |
| query | email optional | 계정 이메일 Example : score@samsung.com | any of [string, null] | None |
| query | login_id optional | 로그인 ID Example : log-archive@samsung.com | any of [string, null] | None |
| query | joined_start_date optional | 가입 조회 시작 일시 Example : 2024-05-17T12:34:56.789Z | any of [string, null] | None |
| query | joined_end_date optional | 가입 조회 종료 일시 Example : 2024-05-17T12:34:56.789Z | any of [string, null] | None |
| query | joined_method optional | 가입 방법 Example : INVITED | any of [enum (INVITED, CREATED, CLOUD_CONTROL), null] | None |
| query | exclude_policy_id optional | 제외할 정책 ID Example : 238c2fc8c29a449dbfa8681f8f1d78e2 | any of [string, null] | None |
| query | parent_unit_id optional | ROOT 또는 부모 조직 단위 ID Example : ou-fc8c29a138d78e24bf1fa86812fc8b | any of [string, null] | None |
| query | parent_unit_name optional | ROOT 또는 부모 조직 단위명 Example : parent-unit-name | any of [string, null] | None |
| query | type optional | 계정 유형 Example : MEMBER | any of [enum (MANAGEMENT, DELEGATION, MEMBER, NONE, LOG_ARCHIVE, AUDIT), null] | None |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | AccountPageResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/organization-accounts
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.0"
Example HTTP response
Response 200
{
"accounts": [
{
"created_at": "2024-12-19 01:09:05.000",
"created_by": "c23fb561c689455993874fa5d5ed4a2f",
"email": "score@samsung.com",
"id": "0a36e0746dbf4908acf0357829701381",
"joined_method": "INVITED",
"joined_time": "2024-05-17T12:34:56.789Z",
"login_id": "log-archive@samsung.com",
"modified_at": "2023-10-15 14:30:00",
"modified_by": "c23fb561c689455993874fa5d5ed4a2f",
"name": "score-account",
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"parent_unit_id": "ou-fc8c29a138d78e24bf1fa86812fc8b",
"parent_unit_name": "parent-unit-name",
"state": "ACTIVE",
"type": "MEMBER"
}
],
"count": 20,
"page": 0,
"size": 20,
"sort": [
"created_at:asc"
]
}
18 - ListOrganizationInvitations
18.1 - 1.1
get /v1/organization-invitations
Description
get organization invitation list
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| query | organization_id optional | 조직 ID Example : o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5 | any of [string, null] | 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 | account_id optional | 관리자 계정명 Example : 9f8e7d6c5b4a3z2y1x0w9v8u7t6s5r | any of [string, null] | None |
| query | account_name optional | 관리자 계정명 Example : CoreKim | any of [string, null] | None |
| query | account_email optional | 관리자 계정 이메일 Example : admin@example.com | any of [string, null] | None |
| query | state optional | 초대 상태 Example : INVITING | any of [enum (INVITING, REFUSED, INVITED, CANCELED, EXPIRED), null] | None |
| query | login_id optional | 로그인 ID Example : log-archive@samsung.com | any of [string, null] | None |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | OrganizationInvitationPageResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/organization-invitations
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.1"
Example HTTP response
Response 200
{
"count": 20,
"organization_invitations": [
{
"account_email": "admin@example.com",
"account_name": "CoreKim",
"created_at": "2024-12-19 01:09:05.000",
"created_by": "c23fb561c689455993874fa5d5ed4a2f",
"id": "0a36e0746dbf4908acf0357829701381",
"login_id": "log-archive@samsung.com",
"modified_at": "2023-10-15 14:30:00",
"modified_by": "c23fb561c689455993874fa5d5ed4a2f",
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"state": "INVITING",
"target_account_id": "9f8e7d6c5b4a3z2y1x0w9v8u7t6s5r"
}
],
"page": 0,
"size": 20,
"sort": [
"created_at:asc"
]
}
18.2 - 1.0
get /v1/organization-invitations
Description
get organization invitation list
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| query | organization_id optional | 조직 ID Example : o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5 | any of [string, null] | 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 | account_id optional | 관리자 계정명 Example : 9f8e7d6c5b4a3z2y1x0w9v8u7t6s5r | any of [string, null] | None |
| query | account_name optional | 관리자 계정명 Example : CoreKim | any of [string, null] | None |
| query | account_email optional | 관리자 계정 이메일 Example : admin@example.com | any of [string, null] | None |
| query | state optional | 초대 상태 Example : INVITING | any of [enum (INVITING, REFUSED, INVITED, CANCELED, EXPIRED), null] | None |
| query | login_id optional | 로그인 ID Example : log-archive@samsung.com | any of [string, null] | None |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | OrganizationInvitationPageResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/organization-invitations
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.0"
Example HTTP response
Response 200
{
"count": 20,
"organization_invitations": [
{
"account_email": "admin@example.com",
"account_name": "CoreKim",
"created_at": "2024-12-19 01:09:05.000",
"created_by": "c23fb561c689455993874fa5d5ed4a2f",
"id": "0a36e0746dbf4908acf0357829701381",
"login_id": "log-archive@samsung.com",
"modified_at": "2023-10-15 14:30:00",
"modified_by": "c23fb561c689455993874fa5d5ed4a2f",
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"state": "INVITING",
"target_account_id": "9f8e7d6c5b4a3z2y1x0w9v8u7t6s5r"
}
],
"page": 0,
"size": 20,
"sort": [
"created_at:asc"
]
}
19 - ListOrganizations
19.1 - 1.1
get /v1/organizations
Description
get organizations list
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| query | organization_id optional | 조직 ID Example : o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5 | any of [string, null] | 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 | name optional | 조직 이름 Example : My Organization | any of [string, null] | None |
| query | master_account_id optional | 조직 계정 ID Example : b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0 | any of [string, null] | None |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | OrganizationPageResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/organizations
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.1"
Example HTTP response
Response 200
{
"count": 20,
"organizations": [
{
"created_at": "2024-12-19 01:09:05.000",
"created_by": "c23fb561c689455993874fa5d5ed4a2f",
"delegation_account_id": "124e7d6c5b4a3z2y1x0w9v8u7t6s5r",
"id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"master_account_id": "9f8e7d6c5b4a3z2y1x0w9v8u7t6s5r",
"modified_at": "2023-10-15 14:30:00",
"modified_by": "c23fb561c689455993874fa5d5ed4a2f",
"name": "My Organization",
"root_unit_id": "r-abcd7d6c5b4a3z2y1x0w9v8u7t6s5r",
"use_scp_yn": true
}
],
"page": 0,
"size": 20,
"sort": [
"created_at:asc"
]
}
19.2 - 1.0
get /v1/organizations
Description
get organizations list
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| query | organization_id optional | 조직 ID Example : o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5 | any of [string, null] | 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 | name optional | 조직 이름 Example : My Organization | any of [string, null] | None |
| query | master_account_id optional | 조직 계정 ID Example : b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0 | any of [string, null] | None |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | OrganizationPageResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/organizations
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.0"
Example HTTP response
Response 200
{
"count": 20,
"organizations": [
{
"created_at": "2024-12-19 01:09:05.000",
"created_by": "c23fb561c689455993874fa5d5ed4a2f",
"delegation_account_id": "124e7d6c5b4a3z2y1x0w9v8u7t6s5r",
"id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"master_account_id": "9f8e7d6c5b4a3z2y1x0w9v8u7t6s5r",
"modified_at": "2023-10-15 14:30:00",
"modified_by": "c23fb561c689455993874fa5d5ed4a2f",
"name": "My Organization",
"root_unit_id": "r-abcd7d6c5b4a3z2y1x0w9v8u7t6s5r",
"use_scp_yn": true
}
],
"page": 0,
"size": 20,
"sort": [
"created_at:asc"
]
}
20 - ListOrganizationUnits
20.1 - 1.1
get /v1/organization-units
Description
get organization unit list
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| query | organization_id optional | 조직 ID Example : o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5 | any of [string, null] | None |
| query | parent_unit_id required | ROOT 또는 부모 조직 단위 ID Example : ou-fc8c29a138d78e24bf1fa86812fc8b | string | None |
| query | name optional | 조직 단위명 Example : score-organization-unit | any of [string, null] | None |
| query | exclude_policy_id optional | 제외할 정책 ID Example : 238c2fc8c29a449dbfa8681f8f1d78e2 | any of [string, null] | None |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | OrganizationUnitListResponseV1dot1 |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/organization-units?parent_unit_id={parent_unit_id}
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.1"
Example HTTP response
Response 200
{
"organization_units": [
{
"created_at": "2024-12-19 01:09:05.000",
"depth": 1,
"email": "score@samsung.com",
"id": "ou-c29a138f8f1d78e24dbfa8681fc2fc8",
"joined_method": "INVITED",
"joined_time": "2024-05-17T12:34:56.789Z",
"login_id": "log-archive@samsung.com",
"name": "score-organization-unit",
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"parent_unit_id": "ou-fc8c29a138d78e24bf1fa86812fc8b",
"parent_unit_name": "parent-unit-name",
"type": "MEMBER"
}
]
}
20.2 - 1.0
get /v1/organization-units
Description
get organization unit list
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| query | organization_id optional | 조직 ID Example : o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5 | any of [string, null] | None |
| query | parent_unit_id required | ROOT 또는 부모 조직 단위 ID Example : ou-fc8c29a138d78e24bf1fa86812fc8b | string | None |
| query | name optional | 조직 단위명 Example : score-organization-unit | any of [string, null] | None |
| query | exclude_policy_id optional | 제외할 정책 ID Example : 238c2fc8c29a449dbfa8681f8f1d78e2 | any of [string, null] | None |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | OrganizationUnitListResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/organization-units?parent_unit_id={parent_unit_id}
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.0"
Example HTTP response
Response 200
{
"organization_units": [
{
"created_at": "2024-12-19 01:09:05.000",
"depth": 1,
"email": "score@samsung.com",
"id": "ou-c29a138f8f1d78e24dbfa8681fc2fc8",
"joined_method": "INVITED",
"joined_time": "2024-05-17T12:34:56.789Z",
"login_id": "log-archive@samsung.com",
"name": "score-organization-unit",
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"parent_unit_id": "ou-fc8c29a138d78e24bf1fa86812fc8b",
"type": "MEMBER"
}
]
}
21 - ListParents
21.1 - 1.1
get /v1/organization-units/{unit_id}/parents
Description
get organization unit parent list
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| path | unit_id required | 조직 단위 ID Example : ou-c29a138f8f1d78e24dbfa8681fc2fc8 | string | None |
| query | organization_id optional | 조직 ID Example : o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5 | any of [string, null] | None |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | OrganizationUnitParentsResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/organization-units/{unit_id}/parents
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.1"
Example HTTP response
Response 200
{
"parents": [
{
"created_at": "2024-12-19 01:09:05.000",
"created_by": "c23fb561c689455993874fa5d5ed4a2f",
"creator_name": "John Doe na",
"depth": 1,
"description": "에스코어 조직 단위",
"id": "ou-c29a138f8f1d78e24dbfa8681fc2fc8",
"modified_at": "2023-10-15 14:30:00",
"modified_by": "c23fb561c689455993874fa5d5ed4a2f",
"modifier_name": "Alice",
"name": "score-organization-unit",
"parent_unit_id": "ou-fc8c29a138d78e24bf1fa86812fc8b",
"service_name": "Organization",
"srn": "srn:dev2::1b8c29a138d78e24bf1fa86812fcaa:kr-west1::organizations/ou/ou-c29a138f8f1d78e24dbfa8681fc2fc8",
"type": "OU"
}
]
}
21.2 - 1.0
get /v1/organization-units/{unit_id}/parents
Description
get organization unit parent list
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| path | unit_id required | 조직 단위 ID Example : ou-c29a138f8f1d78e24dbfa8681fc2fc8 | string | None |
| query | organization_id optional | 조직 ID Example : o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5 | any of [string, null] | None |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | OrganizationUnitParentsResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/organization-units/{unit_id}/parents
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.0"
Example HTTP response
Response 200
{
"parents": [
{
"created_at": "2024-12-19 01:09:05.000",
"created_by": "c23fb561c689455993874fa5d5ed4a2f",
"creator_name": "John Doe na",
"depth": 1,
"description": "에스코어 조직 단위",
"id": "ou-c29a138f8f1d78e24dbfa8681fc2fc8",
"modified_at": "2023-10-15 14:30:00",
"modified_by": "c23fb561c689455993874fa5d5ed4a2f",
"modifier_name": "Alice",
"name": "score-organization-unit",
"parent_unit_id": "ou-fc8c29a138d78e24bf1fa86812fc8b",
"service_name": "Organization",
"srn": "srn:dev2::1b8c29a138d78e24bf1fa86812fcaa:kr-west1::organizations/ou/ou-c29a138f8f1d78e24dbfa8681fc2fc8",
"type": "OU"
}
]
}
22 - ListPoliciesForTarget
22.1 - 1.1
get /v1/assignments/policies
Description
list policies for target
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| query | organization_id optional | 조직 ID Example : o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5 | any of [string, null] | 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 | target_id required | 타겟 ID Example : ou-1a2b3c4d5e6f7g8h9i0j1k2l3m4n5 | string | None |
| query | policy_category optional | 정책 카테고리 Example : SCP | any of [enum (SCP, RCP, TAG, DGP), null] | SCP |
| query | name optional | 제어 정책 이름 Example : test-policy-name | any of [string, null] | None |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | ListPoliciesForTargetResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/assignments/policies?target_id={target_id}
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.1"
Example HTTP response
Response 200
{
"count": 20,
"page": 0,
"policies": [
{
"created_at": "2024-12-19 01:09:05.000",
"created_by": "c23fb561c689455993874fa5d5ed4a2f",
"id": "0a36e0746dbf4908acf0357829701381",
"link_types": {
"DIRECTED": [
{
"target_id": "1a2b3c4d5e6f7g8h9i0j1k2l3m4n5",
"target_name": "example-target",
"target_type": "OU"
}
],
"INHERITED": [
{
"target_id": "2a2b3c4d5e6f7g8h9i0j1k2l3m4n5",
"target_name": "root",
"target_type": "ROOT"
}
]
},
"modified_at": "2023-10-15 14:30:00",
"modified_by": "c23fb561c689455993874fa5d5ed4a2f",
"policy_name": "test-policy-name",
"policy_type": "SYSTEM_MANAGED",
"source": "ORGANIZATION"
}
],
"size": 20,
"sort": [
"created_at:asc"
]
}
22.2 - 1.0
get /v1/assignments/policies
Description
list policies for target
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| query | organization_id optional | 조직 ID Example : o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5 | any of [string, null] | 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 | target_id required | 타겟 ID Example : ou-1a2b3c4d5e6f7g8h9i0j1k2l3m4n5 | string | None |
| query | policy_category optional | 정책 카테고리 Example : SCP | any of [enum (SCP, RCP, TAG, DGP), null] | SCP |
| query | name optional | 제어 정책 이름 Example : test-policy-name | any of [string, null] | None |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | ListPoliciesForTargetResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/assignments/policies?target_id={target_id}
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.0"
Example HTTP response
Response 200
{
"count": 20,
"page": 0,
"policies": [
{
"created_at": "2024-12-19 01:09:05.000",
"created_by": "c23fb561c689455993874fa5d5ed4a2f",
"id": "0a36e0746dbf4908acf0357829701381",
"link_types": {
"DIRECTED": [
{
"target_id": "1a2b3c4d5e6f7g8h9i0j1k2l3m4n5",
"target_name": "example-target",
"target_type": "OU"
}
],
"INHERITED": [
{
"target_id": "2a2b3c4d5e6f7g8h9i0j1k2l3m4n5",
"target_name": "root",
"target_type": "ROOT"
}
]
},
"modified_at": "2023-10-15 14:30:00",
"modified_by": "c23fb561c689455993874fa5d5ed4a2f",
"policy_name": "test-policy-name",
"policy_type": "SYSTEM_MANAGED",
"source": "ORGANIZATION"
}
],
"size": 20,
"sort": [
"created_at:asc"
]
}
23 - ListServiceControlPolicies
23.1 - 1.1
get /v1/service-control-policies
Description
get service control policies list
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
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 | organization_id required | 조직 ID Example : o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5 | string | None |
| query | id optional | 서비스 제어 정책 ID Example : 138c2fc8c29a449dbfa8681f8f1d78e2 | any of [string, null] | None |
| query | name optional | 서비스 제어 정책 이름 Example : MyPolicy | any of [array[string], string, null] | None |
| query | type optional | 서비스 제어 정책 유형 Example : MANAGED | any of [enum (SYSTEM_MANAGED, USER_DEFINED), null] | None |
| query | exclude_target_id optional | 제외 대상 ID Example : 112c2fc8c29a449dbfa8681f8f1d7442 | any of [string, null] | None |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | ServiceControlPolicyPageResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/service-control-policies?organization_id={organization_id}
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.1"
Example HTTP response
Response 200
{
"count": 20,
"page": 0,
"policies": [
{
"category": "SCP",
"created_at": "2024-12-19 01:09:05.000",
"created_by": "c23fb561c689455993874fa5d5ed4a2f",
"creator_name": "John Doe na",
"description": "This is an example policy.",
"document": {
"Statement": [
{
"Action": [
"*"
],
"Effect": "Allow",
"Resource": [
"*"
],
"Sid": "statement1"
}
],
"Version": "2024-07-01"
},
"id": "138c2fc8c29a449dbfa8681f8f1d78e2",
"modified_at": "2023-10-15 14:30:00",
"modified_by": "c23fb561c689455993874fa5d5ed4a2f",
"modifier_name": "Alice",
"name": "MyPolicy",
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"source": "ORGANIZATION",
"state": "ACTIVE",
"type": "MANAGED"
}
],
"size": 20,
"sort": [
"created_at:asc"
]
}
23.2 - 1.0
get /v1/service-control-policies
Description
get service control policies list
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
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 | organization_id required | 조직 ID Example : o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5 | string | None |
| query | id optional | 서비스 제어 정책 ID Example : 138c2fc8c29a449dbfa8681f8f1d78e2 | any of [string, null] | None |
| query | name optional | 서비스 제어 정책 이름 Example : MyPolicy | any of [array[string], string, null] | None |
| query | type optional | 서비스 제어 정책 유형 Example : MANAGED | any of [enum (SYSTEM_MANAGED, USER_DEFINED), null] | None |
| query | exclude_target_id optional | 제외 대상 ID Example : 112c2fc8c29a449dbfa8681f8f1d7442 | any of [string, null] | None |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | ServiceControlPolicyPageResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/service-control-policies?organization_id={organization_id}
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.0"
Example HTTP response
Response 200
{
"count": 20,
"page": 0,
"policies": [
{
"category": "SCP",
"created_at": "2024-12-19 01:09:05.000",
"created_by": "c23fb561c689455993874fa5d5ed4a2f",
"creator_name": "John Doe na",
"description": "This is an example policy.",
"document": {
"Statement": [
{
"Action": [
"*"
],
"Effect": "Allow",
"Resource": [
"*"
],
"Sid": "statement1"
}
],
"Version": "2024-07-01"
},
"id": "138c2fc8c29a449dbfa8681f8f1d78e2",
"modified_at": "2023-10-15 14:30:00",
"modified_by": "c23fb561c689455993874fa5d5ed4a2f",
"modifier_name": "Alice",
"name": "MyPolicy",
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"source": "ORGANIZATION",
"state": "ACTIVE",
"type": "MANAGED"
}
],
"size": 20,
"sort": [
"created_at:asc"
]
}
24 - ListTargetsForPolicy
24.1 - 1.1
get /v1/assignments/targets
Description
list targets for policy
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| query | organization_id optional | 조직 ID Example : o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5 | any of [string, null] | 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 required | 제어 정책 ID Example : f98e76d54c32b10a9z8y7x6w5v4u3 | string | None |
| query | policy_category optional | 정책 카테고리 Example : SCP | any of [enum (SCP, RCP, TAG, DGP), null] | SCP |
| query | target_type required | 타겟 유형 Example : OU | enum (ROOT, ACCOUNT, OU) | None |
| query | name optional | 타겟명 Example : example-target | any of [string, null] | None |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | ListTargetsForPolicyResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/assignments/targets?policy_id={policy_id}&target_type={target_type}
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.1"
Example HTTP response
Response 200
{
"count": 20,
"page": 0,
"size": 20,
"sort": [
"created_at:asc"
],
"targets": [
{
"control_policies": [
{
"policy_id": "f98e76d54c32b10a9z8y7x6w5v4u3",
"policy_name": "test-policy-name"
}
],
"created_at": "2024-12-19 01:09:05.000",
"created_by": "c23fb561c689455993874fa5d5ed4a2f",
"id": "0a36e0746dbf4908acf0357829701381",
"modified_at": "2023-10-15 14:30:00",
"modified_by": "c23fb561c689455993874fa5d5ed4a2f",
"target_name": "example-target"
}
]
}
24.2 - 1.0
get /v1/assignments/targets
Description
list targets for policy
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| query | organization_id optional | 조직 ID Example : o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5 | any of [string, null] | 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 required | 제어 정책 ID Example : f98e76d54c32b10a9z8y7x6w5v4u3 | string | None |
| query | policy_category optional | 정책 카테고리 Example : SCP | any of [enum (SCP, RCP, TAG, DGP), null] | SCP |
| query | target_type required | 타겟 유형 Example : OU | enum (ROOT, ACCOUNT, OU) | None |
| query | name optional | 타겟명 Example : example-target | any of [string, null] | None |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | ListTargetsForPolicyResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/assignments/targets?policy_id={policy_id}&target_type={target_type}
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.0"
Example HTTP response
Response 200
{
"count": 20,
"page": 0,
"size": 20,
"sort": [
"created_at:asc"
],
"targets": [
{
"control_policies": [
{
"policy_id": "f98e76d54c32b10a9z8y7x6w5v4u3",
"policy_name": "test-policy-name"
}
],
"created_at": "2024-12-19 01:09:05.000",
"created_by": "c23fb561c689455993874fa5d5ed4a2f",
"id": "0a36e0746dbf4908acf0357829701381",
"modified_at": "2023-10-15 14:30:00",
"modified_by": "c23fb561c689455993874fa5d5ed4a2f",
"target_name": "example-target"
}
]
}
25 - MoveAccount
25.1 - 1.1
put /v1/organization-accounts/parent
Description
move a specific account to a different OU
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| body | body required | MoveAccountRequest |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | AccountMoveResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/organization-accounts/parent
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.1"
Request body
{
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"parent_unit_id": "ou-1a2b3c4d5e6f7g8h9i0j1k2l3m4n5",
"target_account_ids": [
"b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0"
]
}
Example HTTP response
Response 200
{
"success_ids": [
{
"success_id": "b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0",
"success_name": "score-account",
"target_id": "ou-c29a138f8f1d78e24dbfa8681fc2fc8",
"target_name": "score-organization-unit"
}
]
}
25.2 - 1.0
put /v1/organization-accounts/parent
Description
move a specific account to a different OU
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| body | body required | MoveAccountRequest |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | AccountMoveResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/organization-accounts/parent
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.0"
Request body
{
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"parent_unit_id": "ou-1a2b3c4d5e6f7g8h9i0j1k2l3m4n5",
"target_account_ids": [
"b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0"
]
}
Example HTTP response
Response 200
{
"success_ids": [
{
"success_id": "b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0",
"success_name": "score-account",
"target_id": "ou-c29a138f8f1d78e24dbfa8681fc2fc8",
"target_name": "score-organization-unit"
}
]
}
26 - RemoveAccounts
26.1 - 1.1
delete /v1/organization-accounts
Description
Remove accounts from organization
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| body | body required | RemoveAccountsRequest |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | AccountRemoveResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/organization-accounts
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.1"
Request body
{
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"target_account_ids": [
"b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0"
]
}
Example HTTP response
Response 200
{
"failed_ids": [
{
"error_code": "Organization.AccountNotRemovable",
"failed_caused": "Account b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0 is not found",
"failed_id": "1a5xz23h1j0l9n8p7r6t5v4x3z2y1w0",
"failed_name": "score-account"
}
],
"success_ids": [
{
"success_id": "b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0",
"success_name": "score-account"
}
]
}
26.2 - 1.0
delete /v1/organization-accounts
Description
Remove accounts from organization
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| body | body required | RemoveAccountsRequest |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | AccountRemoveResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/organization-accounts
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.0"
Request body
{
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"target_account_ids": [
"b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0"
]
}
Example HTTP response
Response 200
{
"failed_ids": [
{
"error_code": "Organization.AccountNotRemovable",
"failed_caused": "Account b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0 is not found",
"failed_id": "1a5xz23h1j0l9n8p7r6t5v4x3z2y1w0",
"failed_name": "score-account"
}
],
"success_ids": [
{
"success_id": "b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0",
"success_name": "score-account"
}
]
}
27 - RemovePolicyBindings
27.1 - 1.1
delete /v1/assignments/policy-bindings
Description
remove policy bindings
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| body | body required | PolicyRemoveRequest |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | ControlPolicyAssignmentResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/assignments/policy-bindings
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.1"
Request body
{
"entity": "POLICY",
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"policy_ids": [
"f98e76d54c32b10a9z8y7x6w5v4u3"
],
"target_ids": [
"ou-1a2b3c4d5e6f7g8h9i0j1k2l3m4n5"
]
}
Example HTTP response
Response 200
{
"failed_ids": [
{
"error_code": "Conflict",
"failed_caused": "Account 482d111a302547fbbd11ee0141ea23bb is not found",
"failed_id": "ou-1a2b3c4d5e6f7g8h9i0j1k2l3m4n5"
}
],
"success_ids": [
"ou-1a2b3c4d5e6f7g8h9i0j1k2l3m4n5"
]
}
27.2 - 1.0
delete /v1/assignments/policy-bindings
Description
remove policy bindings
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| body | body required | PolicyRemoveRequest |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | ControlPolicyAssignmentResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/assignments/policy-bindings
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.0"
Request body
{
"entity": "POLICY",
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"policy_ids": [
"f98e76d54c32b10a9z8y7x6w5v4u3"
],
"target_ids": [
"ou-1a2b3c4d5e6f7g8h9i0j1k2l3m4n5"
]
}
Example HTTP response
Response 200
{
"failed_ids": [
{
"error_code": "Conflict",
"failed_caused": "Account 482d111a302547fbbd11ee0141ea23bb is not found",
"failed_id": "ou-1a2b3c4d5e6f7g8h9i0j1k2l3m4n5"
}
],
"success_ids": [
"ou-1a2b3c4d5e6f7g8h9i0j1k2l3m4n5"
]
}
28 - SetDelegationPolicy
28.1 - 1.1
put /v1/delegation-policies
Description
set a specific delegation policy
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| body | body required | DelegationPolicySetRequest |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | DelegationPolicyShowResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/delegation-policies
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.1"
Request body
{
"document": {
"Statement": [
{
"Action": [
"organization:CreateServiceControlPolicy",
"organization:DeleteServiceControlPolicies",
"organization:SetServiceControlPolicy",
"organization:ShowServiceControlPolicy",
"organization:ListServiceControlPolicies",
"organization:ShowAccount",
"organization:ListAccounts",
"organization:ListOrganizationUnits",
"organization:ListOrganizationInvitations",
"organization:ListParents",
"organization:ListPoliciesForTarget",
"organization:ListTargetsForPolicy",
"organization:AttachPolicyBindings",
"organization:RemovePolicyBindings",
"organization:ShowDelegatePolicy"
],
"Effect": "Allow",
"Principal": {
"scp": [
"srn:dev2::f045159f40c64125a1fe61bd71d1c14c:::iam:user/e3a6e3f99c1040639e9a3c8f8b7427df"
]
},
"Resource": [
"*"
],
"Sid": "statement1"
}
],
"Version": "2024-07-01"
},
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5"
}
Example HTTP response
Response 200
{
"policy": {
"created_at": "2024-12-19 01:09:05.000",
"created_by": "c23fb561c689455993874fa5d5ed4a2f",
"document": {
"Statement": [
{
"Action": [
"organization:CreateServiceControlPolicy",
"organization:DeleteServiceControlPolicies",
"organization:SetServiceControlPolicy",
"organization:ShowServiceControlPolicy",
"organization:ListServiceControlPolicies",
"organization:ShowAccount",
"organization:ListAccounts",
"organization:ListOrganizationUnits",
"organization:ListOrganizationInvitations",
"organization:ListParents",
"organization:ListPoliciesForTarget",
"organization:ListTargetsForPolicy",
"organization:AttachPolicyBindings",
"organization:RemovePolicyBindings",
"organization:ShowDelegatePolicy"
],
"Effect": "Allow",
"Principal": {
"scp": [
"srn:dev2::f045159f40c64125a1fe61bd71d1c14c:::iam:user/e3a6e3f99c1040639e9a3c8f8b7427df"
]
},
"Resource": [
"*"
],
"Sid": "statement1"
}
],
"Version": "2024-07-01"
},
"modified_at": "2023-10-15 14:30:00",
"modified_by": "c23fb561c689455993874fa5d5ed4a2f",
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5"
}
}
28.2 - 1.0
put /v1/delegation-policies
Description
set a specific delegation policy
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| body | body required | DelegationPolicySetRequest |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | DelegationPolicyShowResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/delegation-policies
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.0"
Request body
{
"document": {
"Statement": [
{
"Action": [
"organization:CreateServiceControlPolicy",
"organization:DeleteServiceControlPolicies",
"organization:SetServiceControlPolicy",
"organization:ShowServiceControlPolicy",
"organization:ListServiceControlPolicies",
"organization:ShowAccount",
"organization:ListAccounts",
"organization:ListOrganizationUnits",
"organization:ListOrganizationInvitations",
"organization:ListParents",
"organization:ListPoliciesForTarget",
"organization:ListTargetsForPolicy",
"organization:AttachPolicyBindings",
"organization:RemovePolicyBindings",
"organization:ShowDelegatePolicy"
],
"Effect": "Allow",
"Principal": {
"scp": [
"srn:dev2::f045159f40c64125a1fe61bd71d1c14c:::iam:user/e3a6e3f99c1040639e9a3c8f8b7427df"
]
},
"Resource": [
"*"
],
"Sid": "statement1"
}
],
"Version": "2024-07-01"
},
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5"
}
Example HTTP response
Response 200
{
"policy": {
"created_at": "2024-12-19 01:09:05.000",
"created_by": "c23fb561c689455993874fa5d5ed4a2f",
"document": {
"Statement": [
{
"Action": [
"organization:CreateServiceControlPolicy",
"organization:DeleteServiceControlPolicies",
"organization:SetServiceControlPolicy",
"organization:ShowServiceControlPolicy",
"organization:ListServiceControlPolicies",
"organization:ShowAccount",
"organization:ListAccounts",
"organization:ListOrganizationUnits",
"organization:ListOrganizationInvitations",
"organization:ListParents",
"organization:ListPoliciesForTarget",
"organization:ListTargetsForPolicy",
"organization:AttachPolicyBindings",
"organization:RemovePolicyBindings",
"organization:ShowDelegatePolicy"
],
"Effect": "Allow",
"Principal": {
"scp": [
"srn:dev2::f045159f40c64125a1fe61bd71d1c14c:::iam:user/e3a6e3f99c1040639e9a3c8f8b7427df"
]
},
"Resource": [
"*"
],
"Sid": "statement1"
}
],
"Version": "2024-07-01"
},
"modified_at": "2023-10-15 14:30:00",
"modified_by": "c23fb561c689455993874fa5d5ed4a2f",
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5"
}
}
29 - SetOrganization
29.1 - 1.1
put /v1/organizations/{organization_id}
Description
set a specific organization
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| path | organization_id required | 조직 ID Example : o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5 | string | None |
| body | body required | OrganizationSetRequest |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | OrganizationShowResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
| 409 | Conflict | None |
Example HTTP request
Request path
/v1/organizations/{organization_id}
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.1"
Request body
{
"delegation_account_id": "124e7d6c5b4a3z2y1x0w9v8u7t6s5r",
"name": "My Organization",
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"use_scp_yn": true
}
Example HTTP response
Response 200
{
"organization": {
"created_at": "2024-12-19 01:09:05.000",
"created_by": "c23fb561c689455993874fa5d5ed4a2f",
"creator_name": "John Doe na",
"delegation_account_id": "124e7d6c5b4a3z2y1x0w9v8u7t6s5r",
"id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"master_account_email": "admin@example.com",
"master_account_id": "9f8e7d6c5b4a3z2y1x0w9v8u7t6s5r",
"modified_at": "2023-10-15 14:30:00",
"modified_by": "c23fb561c689455993874fa5d5ed4a2f",
"modifier_name": "Alice",
"name": "My Organization",
"root_unit_id": "r-abcd7d6c5b4a3z2y1x0w9v8u7t6s5r",
"srn": "srn:dev2::1b8c29a138d78e24bf1fa86812fcaa:kr-west1::organizations/organization/o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"use_scp_yn": true
}
}
29.2 - 1.0
put /v1/organizations/{organization_id}
Description
set a specific organization
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| path | organization_id required | 조직 ID Example : o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5 | string | None |
| body | body required | OrganizationSetRequest |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | OrganizationShowResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
| 409 | Conflict | None |
Example HTTP request
Request path
/v1/organizations/{organization_id}
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.0"
Request body
{
"delegation_account_id": "124e7d6c5b4a3z2y1x0w9v8u7t6s5r",
"name": "My Organization",
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"use_scp_yn": true
}
Example HTTP response
Response 200
{
"organization": {
"created_at": "2024-12-19 01:09:05.000",
"created_by": "c23fb561c689455993874fa5d5ed4a2f",
"creator_name": "John Doe na",
"delegation_account_id": "124e7d6c5b4a3z2y1x0w9v8u7t6s5r",
"id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"master_account_email": "admin@example.com",
"master_account_id": "9f8e7d6c5b4a3z2y1x0w9v8u7t6s5r",
"modified_at": "2023-10-15 14:30:00",
"modified_by": "c23fb561c689455993874fa5d5ed4a2f",
"modifier_name": "Alice",
"name": "My Organization",
"root_unit_id": "r-abcd7d6c5b4a3z2y1x0w9v8u7t6s5r",
"srn": "srn:dev2::1b8c29a138d78e24bf1fa86812fcaa:kr-west1::organizations/organization/o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"use_scp_yn": true
}
}
30 - SetOrganizationUnit
30.1 - 1.1
put /v1/organization-units/{unit_id}
Description
set a specific organization unit
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| path | unit_id required | 조직 단위 ID Example : ou-c29a138f8f1d78e24dbfa8681fc2fc8 | string | None |
| body | body required | OrganizationUnitSetRequest |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | OrganizationUnitShowResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/organization-units/{unit_id}
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.1"
Request body
{
"description": "에스코어 조직 단위",
"name": "score-organization-unit",
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5"
}
Example HTTP response
Response 200
{
"organization_unit": {
"created_at": "2024-12-19 01:09:05.000",
"created_by": "c23fb561c689455993874fa5d5ed4a2f",
"creator_name": "John Doe na",
"depth": 1,
"description": "에스코어 조직 단위",
"id": "ou-c29a138f8f1d78e24dbfa8681fc2fc8",
"modified_at": "2023-10-15 14:30:00",
"modified_by": "c23fb561c689455993874fa5d5ed4a2f",
"modifier_name": "Alice",
"name": "score-organization-unit",
"parent_unit_id": "ou-fc8c29a138d78e24bf1fa86812fc8b",
"service_name": "Organization",
"srn": "srn:dev2::1b8c29a138d78e24bf1fa86812fcaa:kr-west1::organizations/ou/ou-c29a138f8f1d78e24dbfa8681fc2fc8",
"type": "OU"
}
}
30.2 - 1.0
put /v1/organization-units/{unit_id}
Description
set a specific organization unit
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| path | unit_id required | 조직 단위 ID Example : ou-c29a138f8f1d78e24dbfa8681fc2fc8 | string | None |
| body | body required | OrganizationUnitSetRequest |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | OrganizationUnitShowResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/organization-units/{unit_id}
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.0"
Request body
{
"description": "에스코어 조직 단위",
"name": "score-organization-unit",
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5"
}
Example HTTP response
Response 200
{
"organization_unit": {
"created_at": "2024-12-19 01:09:05.000",
"created_by": "c23fb561c689455993874fa5d5ed4a2f",
"creator_name": "John Doe na",
"depth": 1,
"description": "에스코어 조직 단위",
"id": "ou-c29a138f8f1d78e24dbfa8681fc2fc8",
"modified_at": "2023-10-15 14:30:00",
"modified_by": "c23fb561c689455993874fa5d5ed4a2f",
"modifier_name": "Alice",
"name": "score-organization-unit",
"parent_unit_id": "ou-fc8c29a138d78e24bf1fa86812fc8b",
"service_name": "Organization",
"srn": "srn:dev2::1b8c29a138d78e24bf1fa86812fcaa:kr-west1::organizations/ou/ou-c29a138f8f1d78e24dbfa8681fc2fc8",
"type": "OU"
}
}
31 - SetServiceControlPolicy
31.1 - 1.1
put /v1/service-control-policies/{policy_id}
Description
set a specific service control policy
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| path | policy_id required | 서비스 제어 정책 ID Example : 138c2fc8c29a449dbfa8681f8f1d78e2 | string | None |
| body | body required | ServiceControlPolicySetRequest |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | ServiceControlPolicyShowResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/service-control-policies/{policy_id}
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.1"
Request body
{
"description": "This is an example policy.",
"document": {
"Statement": [
{
"Action": [
"*"
],
"Effect": "Allow",
"Resource": [
"*"
],
"Sid": "statement1"
}
],
"Version": "2024-07-01"
},
"name": "MyPolicy",
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5"
}
Example HTTP response
Response 200
{
"policy": {
"category": "SCP",
"created_at": "2024-12-19 01:09:05.000",
"created_by": "c23fb561c689455993874fa5d5ed4a2f",
"creator_name": "John Doe na",
"description": "This is an example policy.",
"document": {
"Statement": [
{
"Action": [
"*"
],
"Effect": "Allow",
"Resource": [
"*"
],
"Sid": "statement1"
}
],
"Version": "2024-07-01"
},
"id": "138c2fc8c29a449dbfa8681f8f1d78e2",
"modified_at": "2023-10-15 14:30:00",
"modified_by": "c23fb561c689455993874fa5d5ed4a2f",
"modifier_name": "Alice",
"name": "MyPolicy",
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"service_name": "Organization",
"source": "ORGANIZATION",
"srn": "srn:dev2::1b8c29a138d78e24bf1fa86812fcaa:kr-west1::organizations/service-control-policy/138c2fc8c29a449dbfa8681f8f1d78e2",
"state": "ACTIVE",
"type": "MANAGED"
}
}
31.2 - 1.0
put /v1/service-control-policies/{policy_id}
Description
set a specific service control policy
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| path | policy_id required | 서비스 제어 정책 ID Example : 138c2fc8c29a449dbfa8681f8f1d78e2 | string | None |
| body | body required | ServiceControlPolicySetRequest |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | ServiceControlPolicyShowResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/service-control-policies/{policy_id}
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.0"
Request body
{
"description": "This is an example policy.",
"document": {
"Statement": [
{
"Action": [
"*"
],
"Effect": "Allow",
"Resource": [
"*"
],
"Sid": "statement1"
}
],
"Version": "2024-07-01"
},
"name": "MyPolicy",
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5"
}
Example HTTP response
Response 200
{
"policy": {
"category": "SCP",
"created_at": "2024-12-19 01:09:05.000",
"created_by": "c23fb561c689455993874fa5d5ed4a2f",
"creator_name": "John Doe na",
"description": "This is an example policy.",
"document": {
"Statement": [
{
"Action": [
"*"
],
"Effect": "Allow",
"Resource": [
"*"
],
"Sid": "statement1"
}
],
"Version": "2024-07-01"
},
"id": "138c2fc8c29a449dbfa8681f8f1d78e2",
"modified_at": "2023-10-15 14:30:00",
"modified_by": "c23fb561c689455993874fa5d5ed4a2f",
"modifier_name": "Alice",
"name": "MyPolicy",
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"service_name": "Organization",
"source": "ORGANIZATION",
"srn": "srn:dev2::1b8c29a138d78e24bf1fa86812fcaa:kr-west1::organizations/service-control-policy/138c2fc8c29a449dbfa8681f8f1d78e2",
"state": "ACTIVE",
"type": "MANAGED"
}
}
32 - ShowAccount
32.1 - 1.1
get /v1/organization-accounts/{account_id}
Description
show a specific account
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| path | account_id required | 조직 계정 ID Example : b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0 | string | None |
| query | organization_id optional | 조직 ID Example : o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5 | any of [string, null] | None |
| query | lazy_policy optional | 연결된 정책 조회 여부 Example : True | any of [boolean, null] | True |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | AccountShowResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/organization-accounts/{account_id}
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.1"
Example HTTP response
Response 200
{
"account": {
"control_policies": [
{
"policy_id": "f98e76d54c32b10a9z8y7x6w5v4u3",
"policy_name": "test-policy-name"
}
],
"created_at": "2024-12-19 01:09:05.000",
"created_by": "c23fb561c689455993874fa5d5ed4a2f",
"creator_name": "John Doe na",
"email": "score@samsung.com",
"id": "0a36e0746dbf4908acf0357829701381",
"joined_method": "INVITED",
"joined_time": "2024-05-17T12:34:56.789Z",
"login_id": "log-archive@samsung.com",
"modified_at": "2023-10-15 14:30:00",
"modified_by": "c23fb561c689455993874fa5d5ed4a2f",
"modifier_name": "Alice",
"name": "score-account",
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"parent_unit_id": "ou-fc8c29a138d78e24bf1fa86812fc8b",
"parent_unit_name": "parent-unit-name",
"srn": "srn:dev2::1b8c29a138d78e24bf1fa86812fcaa:kr-west1::organizations/account/b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0",
"state": "ACTIVE",
"type": "MEMBER"
}
}
32.2 - 1.0
get /v1/organization-accounts/{account_id}
Description
show a specific account
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| path | account_id required | 조직 계정 ID Example : b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0 | string | None |
| query | organization_id optional | 조직 ID Example : o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5 | any of [string, null] | None |
| query | lazy_policy optional | 연결된 정책 조회 여부 Example : True | any of [boolean, null] | True |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | AccountShowResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/organization-accounts/{account_id}
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.0"
Example HTTP response
Response 200
{
"account": {
"control_policies": [
{
"policy_id": "f98e76d54c32b10a9z8y7x6w5v4u3",
"policy_name": "test-policy-name"
}
],
"created_at": "2024-12-19 01:09:05.000",
"created_by": "c23fb561c689455993874fa5d5ed4a2f",
"creator_name": "John Doe na",
"email": "score@samsung.com",
"id": "0a36e0746dbf4908acf0357829701381",
"joined_method": "INVITED",
"joined_time": "2024-05-17T12:34:56.789Z",
"login_id": "log-archive@samsung.com",
"modified_at": "2023-10-15 14:30:00",
"modified_by": "c23fb561c689455993874fa5d5ed4a2f",
"modifier_name": "Alice",
"name": "score-account",
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"parent_unit_id": "ou-fc8c29a138d78e24bf1fa86812fc8b",
"parent_unit_name": "parent-unit-name",
"srn": "srn:dev2::1b8c29a138d78e24bf1fa86812fcaa:kr-west1::organizations/account/b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0",
"state": "ACTIVE",
"type": "MEMBER"
}
}
33 - ShowDelegationPolicy
33.1 - 1.1
get /v1/delegation-policies
Description
show a specific delegation policy
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| query | organization_id optional | 조직 ID Example : o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5 | any of [string, null] | None |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | DelegationPolicyShowResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/delegation-policies
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.1"
Example HTTP response
Response 200
{
"policy": {
"created_at": "2024-12-19 01:09:05.000",
"created_by": "c23fb561c689455993874fa5d5ed4a2f",
"document": {
"Statement": [
{
"Action": [
"organization:CreateServiceControlPolicy",
"organization:DeleteServiceControlPolicies",
"organization:SetServiceControlPolicy",
"organization:ShowServiceControlPolicy",
"organization:ListServiceControlPolicies",
"organization:ShowAccount",
"organization:ListAccounts",
"organization:ListOrganizationUnits",
"organization:ListOrganizationInvitations",
"organization:ListParents",
"organization:ListPoliciesForTarget",
"organization:ListTargetsForPolicy",
"organization:AttachPolicyBindings",
"organization:RemovePolicyBindings",
"organization:ShowDelegatePolicy"
],
"Effect": "Allow",
"Principal": {
"scp": [
"srn:dev2::f045159f40c64125a1fe61bd71d1c14c:::iam:user/e3a6e3f99c1040639e9a3c8f8b7427df"
]
},
"Resource": [
"*"
],
"Sid": "statement1"
}
],
"Version": "2024-07-01"
},
"modified_at": "2023-10-15 14:30:00",
"modified_by": "c23fb561c689455993874fa5d5ed4a2f",
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5"
}
}
33.2 - 1.0
get /v1/delegation-policies
Description
show a specific delegation policy
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| query | organization_id optional | 조직 ID Example : o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5 | any of [string, null] | None |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | DelegationPolicyShowResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/delegation-policies
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.0"
Example HTTP response
Response 200
{
"policy": {
"created_at": "2024-12-19 01:09:05.000",
"created_by": "c23fb561c689455993874fa5d5ed4a2f",
"document": {
"Statement": [
{
"Action": [
"organization:CreateServiceControlPolicy",
"organization:DeleteServiceControlPolicies",
"organization:SetServiceControlPolicy",
"organization:ShowServiceControlPolicy",
"organization:ListServiceControlPolicies",
"organization:ShowAccount",
"organization:ListAccounts",
"organization:ListOrganizationUnits",
"organization:ListOrganizationInvitations",
"organization:ListParents",
"organization:ListPoliciesForTarget",
"organization:ListTargetsForPolicy",
"organization:AttachPolicyBindings",
"organization:RemovePolicyBindings",
"organization:ShowDelegatePolicy"
],
"Effect": "Allow",
"Principal": {
"scp": [
"srn:dev2::f045159f40c64125a1fe61bd71d1c14c:::iam:user/e3a6e3f99c1040639e9a3c8f8b7427df"
]
},
"Resource": [
"*"
],
"Sid": "statement1"
}
],
"Version": "2024-07-01"
},
"modified_at": "2023-10-15 14:30:00",
"modified_by": "c23fb561c689455993874fa5d5ed4a2f",
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5"
}
}
34 - ShowOrganization
34.1 - 1.1
get /v1/organizations/{organization_id}
Description
show a specific organization
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| path | organization_id required | 조직 ID Example : o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5 | string | None |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | OrganizationShowResponse |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/organizations/{organization_id}
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.1"
Example HTTP response
Response 200
{
"organization": {
"created_at": "2024-12-19 01:09:05.000",
"created_by": "c23fb561c689455993874fa5d5ed4a2f",
"creator_name": "John Doe na",
"delegation_account_id": "124e7d6c5b4a3z2y1x0w9v8u7t6s5r",
"id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"master_account_email": "admin@example.com",
"master_account_id": "9f8e7d6c5b4a3z2y1x0w9v8u7t6s5r",
"modified_at": "2023-10-15 14:30:00",
"modified_by": "c23fb561c689455993874fa5d5ed4a2f",
"modifier_name": "Alice",
"name": "My Organization",
"root_unit_id": "r-abcd7d6c5b4a3z2y1x0w9v8u7t6s5r",
"srn": "srn:dev2::1b8c29a138d78e24bf1fa86812fcaa:kr-west1::organizations/organization/o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"use_scp_yn": true
}
}
34.2 - 1.0
get /v1/organizations/{organization_id}
Description
show a specific organization
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| path | organization_id required | 조직 ID Example : o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5 | string | None |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | OrganizationShowResponse |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/organizations/{organization_id}
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.0"
Example HTTP response
Response 200
{
"organization": {
"created_at": "2024-12-19 01:09:05.000",
"created_by": "c23fb561c689455993874fa5d5ed4a2f",
"creator_name": "John Doe na",
"delegation_account_id": "124e7d6c5b4a3z2y1x0w9v8u7t6s5r",
"id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"master_account_email": "admin@example.com",
"master_account_id": "9f8e7d6c5b4a3z2y1x0w9v8u7t6s5r",
"modified_at": "2023-10-15 14:30:00",
"modified_by": "c23fb561c689455993874fa5d5ed4a2f",
"modifier_name": "Alice",
"name": "My Organization",
"root_unit_id": "r-abcd7d6c5b4a3z2y1x0w9v8u7t6s5r",
"srn": "srn:dev2::1b8c29a138d78e24bf1fa86812fcaa:kr-west1::organizations/organization/o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"use_scp_yn": true
}
}
35 - ShowOrganizationUnit
35.1 - 1.1
get /v1/organization-units/{unit_id}
Description
show a specific organization unit
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| path | unit_id required | 조직 단위 ID Example : ou-c29a138f8f1d78e24dbfa8681fc2fc8 | string | None |
| query | organization_id optional | 조직 ID Example : o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5 | any of [string, null] | None |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | OrganizationUnitShowResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/organization-units/{unit_id}
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.1"
Example HTTP response
Response 200
{
"organization_unit": {
"created_at": "2024-12-19 01:09:05.000",
"created_by": "c23fb561c689455993874fa5d5ed4a2f",
"creator_name": "John Doe na",
"depth": 1,
"description": "에스코어 조직 단위",
"id": "ou-c29a138f8f1d78e24dbfa8681fc2fc8",
"modified_at": "2023-10-15 14:30:00",
"modified_by": "c23fb561c689455993874fa5d5ed4a2f",
"modifier_name": "Alice",
"name": "score-organization-unit",
"parent_unit_id": "ou-fc8c29a138d78e24bf1fa86812fc8b",
"service_name": "Organization",
"srn": "srn:dev2::1b8c29a138d78e24bf1fa86812fcaa:kr-west1::organizations/ou/ou-c29a138f8f1d78e24dbfa8681fc2fc8",
"type": "OU"
}
}
35.2 - 1.0
get /v1/organization-units/{unit_id}
Description
show a specific organization unit
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| path | unit_id required | 조직 단위 ID Example : ou-c29a138f8f1d78e24dbfa8681fc2fc8 | string | None |
| query | organization_id optional | 조직 ID Example : o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5 | any of [string, null] | None |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | OrganizationUnitShowResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/organization-units/{unit_id}
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.0"
Example HTTP response
Response 200
{
"organization_unit": {
"created_at": "2024-12-19 01:09:05.000",
"created_by": "c23fb561c689455993874fa5d5ed4a2f",
"creator_name": "John Doe na",
"depth": 1,
"description": "에스코어 조직 단위",
"id": "ou-c29a138f8f1d78e24dbfa8681fc2fc8",
"modified_at": "2023-10-15 14:30:00",
"modified_by": "c23fb561c689455993874fa5d5ed4a2f",
"modifier_name": "Alice",
"name": "score-organization-unit",
"parent_unit_id": "ou-fc8c29a138d78e24bf1fa86812fc8b",
"service_name": "Organization",
"srn": "srn:dev2::1b8c29a138d78e24bf1fa86812fcaa:kr-west1::organizations/ou/ou-c29a138f8f1d78e24dbfa8681fc2fc8",
"type": "OU"
}
}
36 - ShowServiceControlPolicy
36.1 - 1.1
get /v1/service-control-policies/{policy_id}
Description
show a specific service control policy
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.1 | - |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| path | policy_id required | 서비스 제어 정책 ID Example : 138c2fc8c29a449dbfa8681f8f1d78e2 | string | None |
| query | organization_id optional | 조직 ID Example : o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5 | any of [string, null] | None |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | ServiceControlPolicyShowResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/service-control-policies/{policy_id}
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.1"
Example HTTP response
Response 200
{
"policy": {
"category": "SCP",
"created_at": "2024-12-19 01:09:05.000",
"created_by": "c23fb561c689455993874fa5d5ed4a2f",
"creator_name": "John Doe na",
"description": "This is an example policy.",
"document": {
"Statement": [
{
"Action": [
"*"
],
"Effect": "Allow",
"Resource": [
"*"
],
"Sid": "statement1"
}
],
"Version": "2024-07-01"
},
"id": "138c2fc8c29a449dbfa8681f8f1d78e2",
"modified_at": "2023-10-15 14:30:00",
"modified_by": "c23fb561c689455993874fa5d5ed4a2f",
"modifier_name": "Alice",
"name": "MyPolicy",
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"service_name": "Organization",
"source": "ORGANIZATION",
"srn": "srn:dev2::1b8c29a138d78e24bf1fa86812fcaa:kr-west1::organizations/service-control-policy/138c2fc8c29a449dbfa8681f8f1d78e2",
"state": "ACTIVE",
"type": "MANAGED"
}
}
36.2 - 1.0
get /v1/service-control-policies/{policy_id}
Description
show a specific service control policy
상태 ACTIVE (DEPRECATED)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | 20251231 |
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| path | policy_id required | 서비스 제어 정책 ID Example : 138c2fc8c29a449dbfa8681f8f1d78e2 | string | None |
| query | organization_id optional | 조직 ID Example : o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5 | any of [string, null] | None |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | OK | ServiceControlPolicyShowResponse |
| 400 | Bad Request | None |
| 403 | Forbidden | None |
| 404 | Not Found | None |
Example HTTP request
Request path
/v1/service-control-policies/{policy_id}
Request header
"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = organization 1.0"
Example HTTP response
Response 200
{
"policy": {
"category": "SCP",
"created_at": "2024-12-19 01:09:05.000",
"created_by": "c23fb561c689455993874fa5d5ed4a2f",
"creator_name": "John Doe na",
"description": "This is an example policy.",
"document": {
"Statement": [
{
"Action": [
"*"
],
"Effect": "Allow",
"Resource": [
"*"
],
"Sid": "statement1"
}
],
"Version": "2024-07-01"
},
"id": "138c2fc8c29a449dbfa8681f8f1d78e2",
"modified_at": "2023-10-15 14:30:00",
"modified_by": "c23fb561c689455993874fa5d5ed4a2f",
"modifier_name": "Alice",
"name": "MyPolicy",
"organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
"service_name": "Organization",
"source": "ORGANIZATION",
"srn": "srn:dev2::1b8c29a138d78e24bf1fa86812fcaa:kr-west1::organizations/service-control-policy/138c2fc8c29a449dbfa8681f8f1d78e2",
"state": "ACTIVE",
"type": "MANAGED"
}
}