Skip to main content

Create and manage project

Project in KakaoCloud is for owning services and using their resources. The project creation and management described in this document are only available to users assigned the following IAM roles.

Project Management by IAM role​

FunctionOrg OwnerOrg AdminOrg ReaderProject AdminProject MemberProject Reader
View all projects      ✓     ✓          
Create project✓
Edit project details✓
Set default project✓
Request project deletion✓

Create project​

To use resources in KakaoCloud, you must first create a project within the organization. Only Org Admin can create projects.

info

Before creating a project, a payment method must be registered. For information on how to register a payment method, refer to Manage Payment Method.

  1. Select the IAM from the KakaoCloud Console.

  2. In the Projects tab, click the [Create project] button.

  3. Enter the necessary information for project creation, then click the [Create] button.

    Image: Create Project Create project

    CategoryDescription
    Organization nameAutomatically filled with the organization name registered by the Org Owner at the time of initial sign-up
    Project nicknameName of the project to be created
    Project nameA unique identifier for the project in the API
    - Cannot be changed later
    Description (optional)Description of the project

Manage project​

View all projects​

Org Admin can view all projects within the organization. Project Admin and Project Member can only view projects they are part of.

  1. Select the IAM from the KakaoCloud Console.

  2. In the Projects tab, view all projects of the organization.

Modify project information​

Org Admin can edit project information, such as the project name and description.

  1. Select the IAM from the KakaoCloud Console.

  2. In the Projects tab, select the [More] icon for the project you want to edit, then choose Modify project.

    • Project information can only be modified within the organization to which the project belongs. Therefore, you must select the organization to which the project belongs before modifying its information.

  3. In the Modify project popup, modify the Project nickname or Description, then click the [Save] button.

    Image: Edit Project Information Modify project

    CategoryDescription
    Project nicknameName of the project to be created
    Description (Optional)Description of the project

Set default project​

When logging into the KakaoCloud Console, if there's no recent project information, you are redirected to the dashboard of the default project. Only one default project can be set, and it can be freely changed.
Org Admin can set a user's default project.

info

Org Admin or Org Owner can set a default project, but users can change it themselves. For instructions on how to set your own default project, refer to Set default project.

  1. Select the IAM from the KakaoCloud Console.
  2. In the Users tab, select the user for whom you want to set a default project.
  3. In the User Info, click the IAM roles tab and select Set default project.
  4. In the pop-up window, select a project and click the [Set] button.

Delete project​

Users with the Org Admin role can request the deletion of a project by leaving an inquiry at the Helpdesk.
The feature to directly delete projects from the console is planned for future support.

caution

When a project is deleted, all resources created within that project are also deleted and cannot be recovered.

  1. Click the [Ask a Question] button located at the top right of the Helpdesk.

  2. Click the [Technical Inquiry] button, enter the required information, and click the [Register] button.

    CategoryDescription
    Question TypeChoose between General or Technical Inquiry
    - For project deletion, select Technical Inquiry
    Type DetailThe detailed type of question
    - For project deletion, select Service > Delete Project
    Project NameThe name of the project you wish to delete
    TitleThe title of your question
    QuestionThe detailed content of your question
    - Enable secret post if necessary
    Attach FileAttach a file if necessary

Manage service account​

Service account is not actual IAM user accounts but an account used to access or control resources within a project. It can be used instead of IAM user accounts to issue API tokens for project-level use. The management of service account described in this document is only available to users assigned the following IAM roles.

Service Account Management by IAM role​

FunctionOrg OwnerOrg AdminOrg ReaderProject AdminProject MemberProject Reader
View service account                ✓      ✓  ✓
Create service account✓✓
Change service account Status✓✓
Delete service account✓✓
Add and delete service access key✓✓
View service account✓✓✓

View service account​

Service account is used by project members to call APIs with API authentication tokens of the service account to access or control resources in KakaoCloud services. The method to view service accounts is as follows.

info

You can issue an API authentication token using the access key of service account. At this time, you cannot add an access key with the service account's API authentication token, nor can you delete the corresponding service account and its access keys.
- You also cannot create new service accounts or delete other service accounts and access keys.

  1. Select the IAM from the KakaoCloud Console.

  2. In the Service account tab, view the service accounts created for the project.

    • For service accounts, the [Add access key] button is displayed next to the ID.
    CategoryDescription
    ActivationService account status
    - 🟢 Active: The default state in which the service account can be used
    - ⚪️ Inactive: A state where the service account use is restricted
    NameName of the service account
    - Name entered by the user
    IDService account ID
    - Format: {user input}-project unique ID@kc.serviceaccount.com
    [Add access key] ButtonClick to move to the add service account access key popup
    - Only clickable for service accounts

Create service account​

Service account is not actual IAM user accounts but are used by project members to call APIs with API authentication tokens of the service account to access or control resources in KakaoCloud services. The method to create a service account is as follows.

info

You can create up to 100 service accounts per project, including inactive accounts.

  1. Select the IAM from the KakaoCloud Console.

  2. In the Service account tab, click the [Create Service Account] button.

  3. In the Create service account popup, enter the required information and click the [Create] button.

    Image: Create Service Account Create service account

    CategoryDescription
    ProjectAutomatically filled with the name of the project to which the service account belongs
    Service account- Name: Name of the service account
    - Email format ({user input}-project unique ID@kc.serviceaccount.com) is automatically generated
    Project-level roleAutomatically filled with the project member role

Change service account state​

You can change a service account to an active or inactive status. Be careful when deactivating a service account as the issued access key and API authentication token are immediately expired, and some resources may not be usable temporarily.

  1. Select the IAM from the KakaoCloud Console.
  2. In the Service account tab, select the [More] icon for the service account whose status you want to change, then choose Service account Info.
  3. In the popup window, change the activation status and click the [Save] button.

Delete service account​

You can delete service accounts that are no longer in use.

caution

Please note that when you delete a service account, the access keys and API authentication tokens issued by that account will expire immediately.

  1. Select the IAM from the KakaoCloud Console.
  2. In the Service account tab, click the checkbox for the service account you wish to delete, and click the [Delete service account] button.
  3. In the Delete service account popup, enter Delete service account and click the [Delete] button.

Issue access key for service account​

To use 카카오클라우드 API, you must issue API authentication token information, Access key (Access key ID and Secret access key).

caution
  • The secret access key issued when adding an access key cannot be viewed again after issuance.
  • You cannot temporarily suspend the use of an access key or specify an expiration date.

  1. Select the IAM from the KakaoCloud Console.

  2. In the Service account tab, click the [Add access key] button for the service account to which you want to add an access key.

  3. In the Add access key popup, enter the required information and click the [Add] button.

    Image: Add Service Account Access Key Add access key for service account

    CategoryDescription
    Service accountThe ID format {user input}-project unique ID@kc.serviceaccount.com, automatically filled
    Project-level info- Project nickname (Project Name): Automatically filled with the name of the belonging project
    - Project-level role: Automatically filled with the project member role
    Access key nameName for the service account access key
    - Cannot use duplicate names within the project
    Description (Optional)Cannot be modified after the access key is created

  4. Confirm the issued access key ID and secret access key, and click the [Copy] button to copy the secret access key.

    • Since the secret access key cannot be viewed again after creation, be sure to copy it to your clipboard and keep it safely stored.

  5. Click the [Ok] button to complete the creation of the access key.

Delete access key for service account​

You can delete Access key (Access key ID and Secret access key) that is no longer in use.

caution

Please note that the API authentication token issued with that access key is immediately expired when an access key is deleted.

  1. Select the IAM from the KakaoCloud Console.
  2. In the Service account tab, select the service account to delete an access key.
  3. On the details page, select the access key you wish to delete, and click the [Delete Access Key] button.
  4. In the Delete access key popup, confirm the access key and click the [Delete] button.

View service account​

Service account is used by KakaoCloud services in the background to access resources directly or perform user requests. These accounts are automatically created when using certain KakaoCloud services and cannot be deleted or modified by users. The method to view service accounts is as follows.

  1. Select the IAM from the KakaoCloud Console.

  2. In the Service account tab, view the service accounts and service agents created for the project.

    CategoryDescription
    State     Service account status
    - 🟢 Active: The default state in which the service account can be used
    - ⚪️ Inactive: A state where the service account use is restricted
    NameName of the service agent
    - Automatically generated with the name of the KakaoCloud service being used
    IDService agent ID
    - Format: project unique ID@service name.kic.serviceaccount.com

Appendix. Check Project ID​

When a project is created in the KakaoCloud, a unique Project ID is generated for that project.
The Project ID can be found in the URI displayed in the console's address bar (value of project_id).

For example, in https://console.kakaocloud.com/transit-gateway/transit-gateways?project_id=073fc84cbd86412ef9f6d269780ef89bb&region=kr-central-2, the Project ID value is 073fc84cbd86412ef9f6d269780ef89bb, up to before &.

Last updated on