The page has been translated by Gen AI.

How to guides

Create Queue Service

You can create and use a Queue Service from the Samsung Cloud Platform Console.
To create a Queue Service, follow these steps.

  1. Click the All Services > Application > Queue Service menu. Go to the Service Home page of Queue Service.
  2. Click the Create Queue button on the Service Home page. It navigates to the Create Queue page.
  3. After entering the information required to create the service on the Queue creation page, click the Confirm button.
Category
Required
Detailed description
TypeRequiredSelect service type
  • Basic, FIFO select
Queue nameRequiredEnter queue name
  • Start with a lowercase English letter and include lowercase letters, numbers, and special characters (-) within 3 ~ 64 characters
  • Standard type: cannot include ‘.fifo’ in the name
  • FIFO type: use the format ’name+.fifo
DescriptionSelectEnter service description within 100 characters
Message SizeRequiredEnter the message size value (KB) between 1 and 256
  • Up to 50 can be added per resource
Message retention periodRequiredEnter message retention period
  • Select a unit period and then enter the desired value
    • seconds: 60 ~ 1,209,600
    • minutes: 1 ~ 20,160
    • hours: 1 ~ 336
    • days: 1 ~ 14
EncryptionRequiredChoose whether to use encryption
  • Create new: Go to the KMS page and create a new KMS encryption
  • Do not use: Do not use encryption
  • KMS encryption: Select when using KMS
    • Data Key reuse period: After selecting the unit period, enter the desired value
      • Minutes: 5 ~ 1,440
      • Hours: 1 ~ 24
TagSelectAdd Tag
  • Up to 50 can be added per resource
  • After clicking the Add Tag button, enter or select Key, Value values
Table. Queue creation information input items
  1. When the popup notifying creation opens, click the Confirm button.

Queue is charged based on usage.

Queue Service Check detailed information

You can view detailed information and messages about the Queue Service.
To view detailed information of the Queue Service, follow the steps below.

  1. All Services > Application > Queue Service Click the menu. Go to the Service Home page of Queue Service.
  2. Click the Queue menu on the Service Home page. It moves to the Queue List page.
  3. Click the resource to view detailed information on the Queue list page. It moves to the Queue details page.
    • Queue Details page displays status information and additional feature information, and consists of Details, Message Management, Tags, Task History tabs.
CategoryDetailed description
Queue Service statusDescribes the status of Queue Service
  • Creating: Creating
  • Available: Creation completed, server connection possible
  • Deleting: Service termination in progress
  • Error Deleting: Abnormal state during deletion
  • Inactive: Abnormal state
  • Error: Abnormal state during creation
Service terminationService termination button
Table. Queue Service status information and additional features

Detailed Information

On the Queue list page, you can view detailed information of the selected resource and, if necessary, edit the information.

CategoryDetailed description
serviceservice name
Resource TypeResource Type
SRNUnique resource ID in Samsung Cloud Platform
  • In Queue Service, it means resource SRN
Resource NameResource Name
  • In Queue Service, it means the Queue name
Resource IDUnique resource ID of the service
CreatorUser who created the service
Creation DateTimeDate and time the service was created
EditorUser who modified the service
Modification Date/TimeDate/Time when the service was modified
Volume nameVolume name
typeQueue type
Configuration SettingsQueue configuration information
  • Displays message size, retention period, and whether encryption is used
  • Click the Edit button to modify
    • For more details, see [Configure Queue Settings](#queue-configuration-settings reference)
DescriptionQueue description
  • Click the Edit button to edit
IP Access Allow ListList of IPs allowed to access the Queue service
  • Click the Add IP Address button to register a new IP
  • Click the Delete button of a registered IP to remove it
Table. Queue Details - Details Tab Items

Message Management

Queue list page allows you to view and manage the message list of the selected resource.

Reference
  • Messages are displayed up to a maximum of 10.
  • How to manage messages, see Message Management.
CategoryDetailed description
Message pollingPerform message polling from Queue to Console and refresh the message list
MoreMessage sending, deletion, removal possible
  • Message Sending: Send a new message
  • Delete: Delete the selected message from the message list
  • Remove: Delete all messages included in the Queue
Message ListMessage ID, message sent datetime, message received datetime, message size can be checked
  • Click the Message ID to view the message body and meta information
  • Delete button can be clicked to delete the message
Message Sent Date/TimeSnapshot Size
Message Received TimeSnapshot Creation Time
Message SizeSnapshot Status
  • Available: Creation complete, recoverable
  • Creating: Creating
  • Error: Abnormal state
  • Deleting: Deleting
  • Error Deleting: Abnormal state while deleting
  • Restoring: Restoring
Table. Queue Details - Message Management Tab Items

Tag

On the Queue list page, you can view the tag information of the selected resource, and you can add, modify, or delete it.

CategoryDetailed description
Tag ListTag List
  • You can view the Key, Value information of tags
  • Up to 50 tags can be added per resource
  • When entering tags, search and select from the existing list of created Keys and Values
Table. Queue Details - Tag Tab Items

Work History

Queuee 목록 page allows you to view the operation history of the selected resource.

CategoryDetailed description
Work History ListResource Change History
  • Work Date and Time, Resource Type, Resource ID, Resource Name, Work Details, Event Topic, Work Result, Verify Operator Information
Table. Queue Details - Work History Tab Items

Queue configuration setup

You can reconfigure the settings configured when creating the Queue Service.
To reset the Queue configuration, follow these steps.

  1. Click the All Services > Application > Queue Service menu. Go to the Service Home page of Queue Service.
  2. Click the Queue menu on the Service Home page. Navigate to the Queue list page.
  3. Queue List page, click the resource to reconfigure the Queue. Queue Details page will be opened.
  4. Click the Edit button of the Configuration Settings item. The Edit Configuration Settings popup window opens.
  5. Modify Configuration Settings After modifying the configuration information in the popup window, click the Confirm button.
Category
Required
Detailed description
Message SizeRequiredEnter the message size value (KB) between 1 and 256
  • Up to 50 can be added per resource
Message retention periodRequiredEnter message retention period
  • Select a unit period, then enter the desired value
    • seconds: 60 ~ 1,209,600
    • minutes: 1 ~ 20,160
    • hours: 1 ~ 336
    • days: 1 ~ 14
EncryptionRequiredChoose whether to use encryption
  • Create new: Go to the KMS page and create a new KMS encryption
  • Do not use: Do not use encryption
  • KMS encryption: Select when using KMS
    • Data Key reuse period: After selecting the unit period, enter the desired value
      • Minutes: 5 ~ 1,440
      • Hours: 1 ~ 24
Table. Queue configuration settings edit input items

Manage IP Access Allowance

You can manage IPs that can access the Queue Service.

Add Accessible IP

To add an accessible IP, follow the steps below.

  1. All Services > Application > Queue Service Click the menu. Go to the Service Home page of Queue Service.
  2. Click the Queue menu on the Service Home page. It navigates to the Queue List page.
  3. On the Queue list page, click the resource to add an accessible IP. It navigates to the Queue details page.
  4. Click the Add IP Address button of the IP Access Allow List item. The Add IP Address popup opens.
  5. After entering the IP to add to the IP Access Allow List, click the Confirm button.
    • Click the + button to add multiple IPs at once (up to 10).
  6. When the popup notifying the addition of IP opens, click the Confirm button.

Exclude accessible IP

To exclude IPs registered in the IP Access Allow List, follow the steps below.

  1. All Services > Application > Queue Service Click the menu. Navigate to the Service Home page of Queue Service.
  2. Service Home page, click the Queue menu. Navigate to the Queue list page.
  3. Click the resource to exclude the accessible IP on the Queue List page. You will be taken to the Queue Details page.
  4. IP Access Allow List After checking the IP to exclude from the item, click the Delete button at the top of the list.
  • IP Access Allow List you can also individually exclude by clicking the Delete button of the IP you want to remove.
  1. When the popup notifying IP deletion opens, click the Confirm button.

Message Management

You can send or manage queue messages.

Send Message

To send a Queue message, follow the steps below.

  1. All Services > Application > Queue Service Click the menu. Go to the Service Home page of Queue Service.
  2. Click the Queue menu on the Service Home page. Move to the Queue list page.
  3. Click the resource to send a Queue message on the Queue List page. You will be taken to the Queue Details page.
  4. Queue Details page’s Message Management tab, click it.
  5. Click the More > Send Message button at the top of the message list. The Send Message popup window will open.
  6. Message Sending After entering the message information to be sent in the popup window, click the Confirm button.
Category
Required
Detailed description
Message bodyRequiredEnter the message to send
  • Up to 262,244 bytes can be entered
Meta InformationSelectSelect whether to use meta information to add to the message
  • If used, up to 10 Key, Value entries can be entered
EncryptionRequiredChoose whether to use encryption
  • Create new: Go to the KMS page and create a new KMS encryption
  • Do not use: Do not use encryption
  • KMS encryption: Select when using KMS
    • Data Key reuse period: After selecting the unit period, enter the desired value
      • Minutes: 5 ~ 1,440
      • Hours: 1 ~ 24
Table. Message Sending Input Items

Delete individual messages

You can delete Queue messages individually. To delete a message, follow the steps below.

  1. All Services > Application > Queue Service Click the menu. Go to the Service Home page of Queue Service.
  2. Click the Queue menu on the Service Home page. Navigate to the Queue List page.
  3. On the Queue List page, click the resource to delete the Queue message. You will be taken to the Queue Details page.
  4. Click the Message Management tab on the Queue Details page.
  5. After selecting all messages to delete from the message list, click the More > Delete button at the top of the list.
    • You can also delete individually by clicking the Delete button at the far right of the message you want to delete in the message list.
  6. If a popup window notifying message deletion opens, click the Confirm button.

Remove all messages

You can delete all messages in the queue.

Caution
  • Message removal deletes messages that cannot be recovered.
  • If the same removal request is in progress, it will not be deleted. Please try removing the message again after a moment.

To delete all messages, follow the steps below.

  1. All Services > Application > Queue Service Click the menu. Navigate to the Service Home page of Queue Service.
  2. Click the Queue menu on the Service Home page. Go to the Queue List page.
  3. Queue List page, click the resource to remove the Queue message. Navigate to the Queue Details page.
  4. Click the Message Management tab on the Queue Details page.
  5. Click the More > Remove Message button at the top of the message list.
  6. When the popup notifying message deletion opens, click the Confirm button.

Queue Service Cancel

You can reduce operating costs by canceling the unused Queue Service.
However, if you terminate the service, the currently operating service may be discontinued immediately, so you should proceed with the termination after fully considering the impact that may occur when the service is discontinued.

Caution
All messages are deleted upon termination and cannot be recovered.

To cancel the Queue Service, follow the steps below.

  1. All Services > Application > Queue Service Click the menu. Navigate to the Service Home page of Queue Service.
  2. Click the Queue menu on the Service Home page. It moves to the Queue List page.
  3. Queue List page, after selecting the resource to cancel, click the Cancel Service button.
    • After moving to the Queue Details page of the resource to be terminated, you can also terminate individually by clicking the Terminate Service button.
  4. If a popup notifying service termination opens, click the Confirm button.

PrivateLink Service Integration

Queue Service can be used by integrating with PrivateLink Service, allowing direct communication with Queue Service from the user’s VPC instead of internet communication, thereby enhancing security.

Follow the steps below to integrate the Queue Service with the PrivateLink Service.

  1. Check the PrivateLink Service ID of the Queue Service for creating a PrivateLink Endpoint.
    • The PrivateLink Service ID of Queue Service can be obtained by contacting us.
  2. Create a PrivateLink Endpoint.
Reference
  • PrivateLink Service usage approval is automatically processed when connected.
  • Check the Security Group of the PrivateLink Endpoint to verify whether the target VM IP is registered.
Caution
When connecting via PrivateLink Endpoint, IAM policies and IP access control for authentication keys cannot be used.
Message API reference
Overview