How to guides

Queue Service 생성하기

Samsung Cloud Platform Console에서 Queue Service를 생성하여 사용할 수 있습니다.
Queue Service를 생성하려면 다음 절차를 따르세요.

1. 모든 서비스 > Application > Queue Service 메뉴를 클릭하세요. Queue Service의 Service Home 페이지로 이동합니다.

2. Service Home 페이지에서 Queue 생성 버튼을 클릭하세요. Queue 생성 페이지로 이동합니다.

3. Queue 생성 페이지에서 서비스 생성에 필요한 정보들을 입력하고, 상세 옵션을 선택하세요.

   • 서비스 정보 입력 영역에서 필요한 정보를 입력 또는 선택하세요.

     구분	필수 여부	상세 설명
     유형	필수	서비스 유형을 선택 기본: 메시지 순서 비유지 FIFO: 선입선출 메시지 전송 및 메시지 유지
     Queue명	필수	Queue 이름을 입력 영문 소문자로 시작하여 영문 소문자, 숫자, 특수문자(-) 포함 3 ~ 64자 이내로 입력 기본 유형: 이름에 ‘.fifo’ 접미어 사용 불가 FIFO 유형: 이름에 .fifo’ 접미어를 포함하여 입력
     중복 제거 범위	필수	중복 제거 범위를 선택 대기열 내 메시지: 대기열 내 메시지 중에서 중복 항목을 제거 그룹 단위의 메시지: 그룹 단위의 메시지 내에서 중복 항목을 제거 FIFO 유형을 선택한 경우에만 설정 가능
     컨텐츠 기반 중복 제거	선택	메시지 본문 내용을 해싱하여 중복된 메시지를 제거 FIFO 유형을 선택한 경우에만 설정 가능
     설명	선택	서비스 설명을 100자 이내로 입력

     표. Queue 생성 - 서비스 정보 입력 항목
   • 메시지 설정 영역에서 필요한 정보를 입력 또는 선택하세요.

     구분	필수 여부	상세 설명
     메시지 크기	필수	메시지 크기값(KB)을 1 ~ 256 사이로 입력 자원당 최대 50개까지 추가가 가능
     메시지 보존 기간	필수	메시지 보존 기간을 입력 단위 기간을 선택한 후, 원하는 값을 입력 초: 60 ~ 1,209,600 분: 1 ~ 20,160 시: 1 ~ 336 일: 1 ~ 14
     전송 지연 시간	필수	메시지 전송 시 지연 시간을 입력 단위 시간을 선택한 후, 원하는 값을 입력 초: 0 ~ 900 분: 0 ~ 15 FIFO 유형을 선택한 경우, 설정 불가
     표시 제한 시간	필수	메시지 노출까지 대기 시간을 입력 단위 시간을 선택한 후, 원하는 값을 입력 초: 0 ~ 43,200 분: 0 ~ 720 시: 0 ~ 12
     메시지 수신 대기 시간	필수	메시지 폴링 타임아웃 시간(초)을 0 ~ 20 사이로 입력

     표. Queue 생성 - 메시지 설정 항목
   • 메시지 설정 영역에서 필요한 정보를 입력 또는 선택하세요.

     구분	필수 여부	상세 설명
     암호화	필수	암호화 사용 여부 선택 신규 생성: KMS 페이지로 이동하여 새로운 KMS 암호화를 생성 사용 안함: 암호화 사용 안함 KMS 암호화: KMS 사용 시 선택 Data Key 재사용 기간: 단위 기간을 선택한 후, 원하는 값을 입력 분: 5 ~ 1,440 시: 1 ~ 24 KMS-Managed-Key: KMS-Managed-Key 사용 시 선택

     표. Queue 생성 - 암호화 설정 항목
   • 리드라이브 설정 영역에서 필요한 정보를 입력 또는 선택하세요.

     구분	필수 여부	상세 설명
     리드라이브 허용	필수	리드라이브 허용 방법 선택 모두 차단: 리드라이브 허용하지 않음 모두 허용: 모든 Queue 자원의 리드라이브로 Queue 사용 가능 최대 수신 시도 횟수: 수신을 시도할 최대 횟수를 1 ~ 10 사이로 입력 특정 Queue: 특정 Queue 자원만 리드라이브 사용 가능 리드라이브 허용 Queue: 추가 버튼을 클릭하여 리드라이브 허용 Queue 자원을 최대 10개까지 추가 가능 최대 수신 시도 횟수: 수신을 시도할 최대 횟수를 1 ~ 10 사이로 입력
     리드라이브 대상 Queue	필수	생성 대상 자원의 리드라이브 Queue 대상 선택 사용 안함: 리드라이브 대상 Queue 미선택 재전송 회수 리드라이브 대상 Queue 자원 선택 시 1 ~ 10 이내로 입력 가능

     표. Queue 생성 - 리드라이브 설정 항목
   • 추가 정보 입력 영역에서 필요한 정보를 입력 또는 선택하세요.

     구분	필수 여부	상세 설명
     태그	선택	태그 추가 자원당 최대 50개까지 추가가 가능 태그 추가 버튼을 클릭한 후 Key, Value 값을 입력 또는 선택

     표. Queue 생성 - 추가 정보 입력 항목

4. 요약 패널에서 생성한 상세 정보와 예상 청구 금액을 확인하고, 생성 버튼을 클릭하세요.

   • 생성이 완료되면, 페이지에서 생성한 자원을 확인하세요.

Queue Service 상세 정보 확인하기

Queue Service에 대한 상세 정보와 메시지를 확인할 수 있습니다.
Queue Service의 상세 정보를 확인하려면 다음 절차를 따르세요.

1. 모든 서비스 > Application > Queue Service 메뉴를 클릭하세요. Queue Service의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 Queue 메뉴를 클릭하세요. Queue 목록 페이지로 이동합니다.
3. Queue 목록 페이지에서 상세 정보를 확인할 자원을 클릭하세요. Queue 상세 페이지로 이동합니다.
   • Queue 상세 페이지에는 상태 정보 및 부가 기능 정보가 표시되며, 상세 정보, 메시지 관리, 태그, 작업 이력 탭으로 구성됩니다.

     구분	상세 설명
     Queue Service 상태	Queue Service의 상태를 표현 Creating: 생성 중 Available: 생성 완료, 서버 연결 가능 Deleting: 서비스 해지 중 Error Deleting: 삭제 중 비정상 상태 Inactive: 비정상 상태 Error: 생성 중 비정상 상태
     서비스 해지	서비스 해지 버튼

     표. Queue Service 상태 정보 및 부가 기능 항목

상세 정보

Queue 목록 페이지에서 선택한 자원의 상세 정보를 확인하고, 필요한 경우 정보를 수정할 수 있습니다.

메시지 관리

Queue 목록 페이지에서 선택한 자원의 매시지 목록을 확인하고 관리할 수 있습니다.

태그

Queue 목록 페이지에서 선택한 자원의 태그 정보를 확인하고, 추가하거나 변경 또는 삭제할 수 있습니다.

작업 이력

Queue 목록 페이지에서 선택한 자원의 작업 이력을 확인할 수 있습니다.

Queue Service 자원 관리하기

생성된 Queue Service 자원의 메시지 설정, 암호화, IP 접근 제어 등의 설정 정보를 변경할 수 있습니다.

메시지 설정 수정하기

메시지 설정을 수정할 수 있습니다.
메시지 설정을 수정하려면 다음 절차를 따르세요.

1. 모든 서비스 > Application > Queue Service 메뉴를 클릭하세요. Queue Service의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 Queue 메뉴를 클릭하세요. Queue 목록 페이지로 이동합니다.
3. Queue 목록 페이지에서 메시지 설정을 수정할 자원을 클릭하세요. Queue 상세 페이지로 이동합니다.
4. 메시지 설정 항목의 수정 버튼을 클릭하세요. 메시지 설정 수정 팝업창이 열립니다.
5. 메시지 설정 수정 팝업창에서 구성 정보를 수정한 후, 확인 버튼을 클릭하세요.

   구분	필수 여부	상세 설명
   메시지 크기	필수	메시지 크기값(KB)을 1 ~ 256 사이로 입력 자원당 최대 50개까지 추가가 가능
   메시지 보존 기간	필수	메시지 보존 기간을 입력 단위 기간을 선택한 후, 원하는 값을 입력 초: 60 ~ 1,209,600 분: 1 ~ 20,160 시: 1 ~ 336 일: 1 ~ 14
   전송 지연 시간	필수	메시지 전송 시 지연 시간을 입력 단위 시간을 선택한 후, 원하는 값을 입력 초: 0 ~ 900 분: 0 ~ 15 FIFO 유형을 선택한 경우, 설정 불가
   표시 제한 시간	필수	메시지 노출까지 대기 시간을 입력 단위 시간을 선택한 후, 원하는 값을 입력 초: 0 ~ 43,200 분: 0 ~ 720 시: 0 ~ 12
   메시지 수신 대기 시간	필수	메시지 폴링 타임아웃 시간(초)을 0 ~ 20 사이로 입력

   표. 메시지 설정 수정 입력 항목

암호화 설정 수정하기

암호화 설정을 수정할 수 있습니다.
암호화 설정을 수정하려면 다음 절차를 따르세요.

1. 모든 서비스 > Application > Queue Service 메뉴를 클릭하세요. Queue Service의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 Queue 메뉴를 클릭하세요. Queue 목록 페이지로 이동합니다.
3. Queue 목록 페이지에서 암호화 설정을 수정할 자원을 클릭하세요. Queue 상세 페이지로 이동합니다.
4. 암호화 항목의 수정 버튼을 클릭하세요. 암호화 설정 수정 팝업창이 열립니다.
5. 암호화 설정 수정 팝업창에서 설정 정보를 수정한 후, 확인 버튼을 클릭하세요.

   구분	필수 여부	상세 설명
   암호화	필수	암호화 사용 여부 및 종류 선택 신규 생성: KMS 페이지로 이동하여 새로운 KMS 암호화를 생성 사용 안함: 암호화 사용 안함 KMS 암호화: KMS 사용 시 선택 KMS-Managed-Key: KMS-Managed-Key 사용 시 선택
   Data Key 재사용 기간	필수	단위 기간을 선택한 후, 원하는 값을 입력 분: 5 ~ 1,440 시: 1 ~ 24 KMS 암호화 사용 시 설정 필요

   표. 암호화 설정 수정 입력 항목

리드라이브 설정 수정하기

리드라이브 설정을 수정할 수 있습니다.
리드라이브 설정을 수정하려면 다음 절차를 따르세요.

1. 모든 서비스 > Application > Queue Service 메뉴를 클릭하세요. Queue Service의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 Queue 메뉴를 클릭하세요. Queue 목록 페이지로 이동합니다.
3. Queue 목록 페이지에서 리드라이브 설정을 수정할 자원을 클릭하세요. Queue 상세 페이지로 이동합니다.
4. 리드라이브 설정 항목의 수정 버튼을 클릭하세요. 리드라이브 허용 수정 팝업창이 열립니다.
5. 리드라이브 허용 수정 팝업창에서 설정 정보를 수정한 후, 확인 버튼을 클릭하세요.

   구분	필수 여부	상세 설명
   리드라이브 허용	필수	리드라이브 허용 방법 선택 모두 차단: 리드라이브 허용하지 않음 모두 허용: 모든 Queue 자원의 리드라이브로 Queue 사용 가능 특정 Queue: 특정 Queue 자원만 리드라이브 사용 가능 리드라이브 허용 Queue 목록에서 추가 버튼을 클릭하여 리드라이브 대상 Queue 자원을 최대 10개까지 추가 가능
   리드라이브 대상 Queue	필수	생성 대상 자원의 리드라이브 Queue 대상 선택 사용 안함: 리드라이브 대상 Queue 미선택 재전송 회수 리드라이브 대상 Queue 자원 선택 시 1 ~ 10 이내로 입력 가능

   표. 리드라이브 허용 수정 항목

IP 접근 허용 관리하기

Queue Service에 접근 가능한 IP를 관리할 수 있습니다.

접근 가능 IP 추가하기

접근 가능 IP를 추가하려면 다음 절차를 따르세요.

1. 모든 서비스 > Application > Queue Service 메뉴를 클릭하세요. Queue Service의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 Queue 메뉴를 클릭하세요. Queue 목록 페이지로 이동합니다.
3. Queue 목록 페이지에서 접근 가능 IP를 추가할 자원을 클릭하세요. Queue 상세 페이지로 이동합니다.
4. IP 접근 허용 목록 항목의 IP Address 추가 버튼을 클릭하세요. IP Address 추가 팝업창이 열립니다.
5. IP 접근 허용 목록에 추가할 IP를 입력한 후, 확인 버튼을 클릭하세요.
   • + 버튼을 클릭하여 여러 개의 IP를 동시에 추가할 수 있습니다(최대 10개).
6. IP 추가를 알리는 팝업창이 열리면 확인 버튼을 클릭하세요.

접근 가능 IP 제외하기

IP 접근 허용 목록에 등록된 IP를 제외하려면 다음 절차를 따르세요.

1. 모든 서비스 > Application > Queue Service 메뉴를 클릭하세요. Queue Service의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 Queue 메뉴를 클릭하세요. Queue 목록 페이지로 이동합니다.
3. Queue 목록 페이지에서 접근 가능 IP를 제외할 자원을 클릭하세요. Queue 상세 페이지로 이동합니다.
4. IP 접근 허용 목록 항목에서 제외할 IP를 체크한 후, 목록 상단의 삭제 버튼을 클릭하세요.
   • IP 접근 허용 목록에서 제외하려는 IP의 삭제 버튼을 클릭하여 개별적으로 제외할 수도 있습니다.
5. IP 삭제를 알리는 팝업창이 열리면 확인 버튼을 클릭하세요.

메시지 관리하기

Queue 메시지를 전송하거나 관리할 수 있습니다.

메시지 전송하기

Queue 메시지를 전송하려면 다음 절차를 따르세요.

1. 모든 서비스 > Application > Queue Service 메뉴를 클릭하세요. Queue Service의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 Queue 메뉴를 클릭하세요. Queue 목록 페이지로 이동합니다.
3. Queue 목록 페이지에서 Queue 메시지를 전송할 자원을 클릭하세요. Queue 상세 페이지로 이동합니다.
4. Queue 상세 페이지의 메시지 관리 탭을 클릭하세요.
5. 메시지 목록 상단의 더보기 > 메시지 전송 버튼을 클릭하세요. 메시지 전송 팝업창이 열립니다.
6. 메시지 전송 팝업창에서 전송할 메시지 정보를 입력한 후, 확인 버튼을 클릭하세요.

   구분	필수 여부	상세 설명
   메시지 본문	필수	보낼 메시지를 입력 최대 262,244 byte까지 입력 가능
   메시지 그룹 ID	필수	영문, 숫자, 특수문자를 사용하여 128자 이내로 입력 FIFO 유형을 사용하는 경우에만 표시
   메시지 중복 제거 ID	필수/선택	영문, 숫자, 특수문자를 사용하여 128자 이내로 입력 FIFO 유형을 사용하는 경우에만 표시 컨텐츠 기반 중복 제거 기능을 사용하는 경우, 입력 여부 선택 가능
   메타 정보	선택	메시지에 추가할 메타 정보의 사용 여부 선택 사용 시 Key, Value 정보를 최대 10개까지 입력 가능
   암호화	필수	암호화 사용 여부 선택 신규 생성: KMS 페이지로 이동하여 새로운 KMS 암호화를 생성 사용 안함: 암호화 사용 안함 KMS 암호화: KMS 사용 시 선택 Data Key 재사용 기간: 단위 기간을 선택한 후, 원하는 값을 입력 분: 5 ~ 1,440 시: 1 ~ 24

   표. 메시지 전송 입력 항목

메시지 상세 정보 확인하기

Queue 메시지의 내용과 상세 정보를 확인할 수 있습니다. 메시지 상세 정보를 확인하려면 다음 절차를 따르세요.

1. 모든 서비스 > Application > Queue Service 메뉴를 클릭하세요. Queue Service의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 Queue 메뉴를 클릭하세요. Queue 목록 페이지로 이동합니다.
3. Queue 목록 페이지에서 Queue 메시지를 확인할 자원을 클릭하세요. Queue 상세 페이지로 이동합니다.
4. Queue 상세 페이지의 메시지 관리 탭을 클릭하세요.
5. 메시지 목록에서 상세 정보를 확인할 메시지 ID를 클릭하세요. 메시지 상세 정보 팝업창이 열립니다.

   구분	상세 설명
   메시지 ID	메시지 고유 ID
   메시지 크기	메시지 용량
   메시지 전송 일시	메시지 전송 일자 및 시간
   메시지 수신 일시	메시지 수신 일자 및 시간
   메시지 그룹 ID	메시지의 그룹 ID FIFO 유형을 사용하는 경우에만 표시
   메시지 중복 제거 ID	메시지에 설정된 중복 제거 ID FIFO 유형을 사용하는 경우에만 표시
   메시지 본문	메시지 내용
   메타 정보	메시지의 메타 정보(Key, Value)값

   표. 메시지 상세 정보 항목

메시지 개별 삭제하기

Queue 메시지를 개별적으로 삭제할 수 있습니다. 메시지를 삭제하려면 다음 절차를 따르세요.

1. 모든 서비스 > Application > Queue Service 메뉴를 클릭하세요. Queue Service의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 Queue 메뉴를 클릭하세요. Queue 목록 페이지로 이동합니다.
3. Queue 목록 페이지에서 Queue 메시지를 삭제할 자원을 클릭하세요. Queue 상세 페이지로 이동합니다.
4. Queue 상세 페이지의 메시지 관리 탭을 클릭하세요.
5. 메시지 목록에서 삭제할 메시지를 모두 선택한 후, 목록 상단의 더보기 > 삭제 버튼을 클릭하세요.
   • 메시지 목록에서 삭제할 메시지의 오른쪽 끝에 있는 삭제 버튼을 클릭하여 개별적으로 삭제할 수도 있습니다.
6. 메시지 삭제를 알리는 팝업창이 열리면 확인 버튼을 클릭하세요.

Queue 내의 모든 메시지 비우기

Queue 비우기로 Queue 내의 모든 메시지를 삭제할 수 있습니다.

모든 메시지를 삭제하려면 다음 절차를 따르세요.

1. 모든 서비스 > Application > Queue Service 메뉴를 클릭하세요. Queue Service의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 Queue 메뉴를 클릭하세요. Queue 목록 페이지로 이동합니다.
3. Queue 목록 페이지에서 Queue 메시지를 제거할 자원을 클릭하세요. Queue 상세 페이지로 이동합니다.
4. Queue 상세 페이지의 메시지 관리 탭을 클릭하세요.
5. 메시지 목록 상단의 더보기 > Queue 비우기 버튼을 클릭하세요.
6. 메시지 삭제를 알리는 팝업창이 열리면 확인 버튼을 클릭하세요.

Queue Service 해지하기

사용하지 않는 Queue Service를 해지하여 운영 비용을 절감할 수 있습니다.
단, 서비스를 해지하면 운영 중인 서비스가 즉시 중단될 수 있으므로 서비스 중단 시 발생하는 영향을 충분히 고려한 후 해지 작업을 진행해야 합니다.

Queue Service를 해지하려면 다음 절차를 따르세요.

1. 모든 서비스 > Application > Queue Service 메뉴를 클릭하세요. Queue Service의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 Queue 메뉴를 클릭하세요. Queue 목록 페이지로 이동합니다.
3. Queue 목록 페이지에서 해지할 자원을 선택한 후, 서비스 해지 버튼을 클릭하세요.
   • 해지할 자원의 Queue 상세 페이지로 이동한 후, 서비스 해지 버튼을 클릭하여 개별적으로 해지할 수도 있습니다.
4. 서비스 해지를 알리는 팝업창이 열리면 확인 버튼을 클릭하세요.

PrivateLink 서비스 연계하기

Queue Service는 PrivateLink Service와 연계하여 인터넷 통신을 사용하지 않고 직접 통신할 수 있습니다.
PrivateLink Service와 연계하면 사용자의 VPC에서 Queue Service와 직접 통신하므로 보안성이 강화됩니다.

PrivateLink Endpoint 생성 및 연결하기

Queue Service와 PrivateLink Service를 연계하기 위하여 다음 절차를 따르세요.

1. PrivateLink Endpoint 생성을 위한 Queue Service의 PrivateLink Service ID를 확인하세요.
   • Queue Service의 PrivateLink Service ID는 Queue 상세 페이지의 PrivateLink Service ID에서 확인할 수 있습니다.
2. PrivateLink Endpoint를 생성하세요.
   • PrivateLink Endpoint의 생성 방법은 PrivateLink Endpoint 생성하기를 참고하세요.