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’ 접미어를 포함하여 입력
          • 영문 소문자로 시작
          • 영문 소문자와 특수문자(-)를 사용하여 3 ~ 64자로 입력로 시작
        컨텐츠 기반 중복 제거선택컨텐츠 기반 중복 제거 기능 사용 여부 선택
        • FIFO 유형을 선택한 경우에만 설정 가능
        중복 제거 범위필수중복 제거 범위를 선택
        • 대기열 내 메시지: 대기열 내 메시지 중에서 중복 항목을 제거
        • 그룹 단위의 메시지: 그룹 단위의 메시지 내에서 중복 항목을 제거
        • FIFO 유형을 선택한 경우에만 설정 가능
        설명선택서비스 설명을 100자 이내로 입력
        표. Queue 생성 - 서비스 정보 입력
      • 구성 설정 영역에서 필요한 정보를 입력 또는 선택하세요.
        구분
        필수 여부
        상세 설명
        메시지 크기필수메시지 크기값(KB)을 1 ~ 256 사이로 입력
        • 자원당 최대 50개까지 추가가 가능
        메시지 보존 기간필수메시지 보존 기간을 입력
        • 단위 기간을 선택한 후, 원하는 값을 입력
          • : 60 ~ 1,209,600
          • : 1 ~ 20,160
          • : 1 ~ 336
          • : 1 ~ 14
        암호화필수암호화 사용 여부 선택
        • 신규 생성: KMS 페이지로 이동하여 새로운 KMS 암호화를 생성
        • 사용 안함: 암호화 사용 안함
        • KMS 암호화: KMS 사용 시 선택
          • Data Key 재사용 기간: 단위 기간을 선택한 후, 원하는 값을 입력
            • : 5 ~ 1,440
            • : 1 ~ 24
        표. Queue 생성 - 구성 설정 항목
      • 추가 정보 입력 영역에서 필요한 정보를 입력 또는 선택하세요.
        구분
        필수 여부
        상세 설명
        태그선택태그 추가
        • 자원당 최대 50개까지 추가가 가능
        • 태그 추가 버튼을 클릭한 후 Key, Value 값을 입력 또는 선택
        표. Queue 생성 - 추가 정보 입력 항목
    4. 요약 패널에서 생성한 상세 정보와 예상 청구 금액을 확인하고, 생성 버튼을 클릭하세요.

      • 생성이 완료되면, 페이지에서 생성한 자원을 확인하세요.
    참고
    Queue는 사용량에 따라 요금이 부과됩니다.

    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 목록 페이지에서 선택한 자원의 상세 정보를 확인하고, 필요한 경우 정보를 수정할 수 있습니다.

    구분상세 설명
    서비스서비스명
    자원 유형자원 유형
    SRNSamsung Cloud Platform에서의 고유 자원 ID
    • Queue Service에서는 자원 SRN을 의미
    자원명자원 이름
    • Queue Service에서는 Queue 이름을 의미
    자원 ID서비스의 고유 자원 ID
    생성자서비스를 생성한 사용자
    생성 일시서비스를 생성한 일시
    수정자서비스를 수정한 사용자
    수정 일시서비스를 수정한 일시
    유형Queue 유형
    컨텐츠 기반 중복 제거컨텐츠 기반 중복 제거 기능 사용 여부
    • FIFO 유형을 사용하는 경우에만 표시
    • 수정 버튼을 클릭하여 사용 여부 변경 가능
    중복 제거 범위중복 제거 범위
    • FIFO 을 사용하는 경우에만 표시
    • 대기열 내 메시지: 대기열 내 메시지 중에서 중복 항목을 제거
    • 그룹 단위의 메시지: 그룹 단위의 메시지 내에서 중복 항목을 제거
    • 수정 버튼을 클릭하여 범위 변경 가능
    구성 설정Queue 구성 정보
    • 메시지의 크기, 보존 기간, 암호화 사용 여부 표시
      • KMS 암호화 사용 시 Data Key 재사용 기간 표시
      • 수정 버튼을 클릭하여 수정 가능
    PrivateLink Service IDPrivateLink 서비스 ID
    설명Queue 설명
    • 수정 버튼을 클릭하여 수정 가능
    IP 접근 허용 목록Queue 서비스에 접근이 허용된 IP 목록
    • IP Address 추가 버튼을 클릭하여 새로운 IP 등록 가능
    • 목록에 등록된IP Address를 선택한 후, 삭제 버튼을 클릭하여 제외 가능
    • IP Address는 최대 150개까지 추가 가능
    표. Queue 상세 - 상세 탭 항목

    메시지 관리

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

    참고
    • 메시지는 최대 10개까지 표시됩니다.
    • 목록에 메시지가 없는 경우, 메시지 폴링 버튼을 클릭하여 메시지를 불러올 수 있습니다.
    • 메시지를 관리하는 방법은 메시지 관리하기를 참고하세요.
    구분상세 설명
    메세지 폴링Queue로부터 Console로 메시지 폴링 수행 후, 메시지 목록 새로고침
    더보기메시지의 전송, 삭제, 제거 가능
    • 메시지 전송: 새로운 메시지를 전송
    • 삭제: 메시지 목록에서 선택한 메시지를 삭제
    • 제거: Queue에 포함된 모든 메시지를 삭제
    메시지 목록메시지 ID, 메시지 전송 일시, 메시지 수신 일시, 메시지 크기(byte) 확인 가능
    • 메시지 ID를 클릭하여 메시지 본문과 메타 정보 확인 가능
    • 삭제 버튼을 클릭하여 해당 메시지 삭제 가능
    표. Queue 상세 - 메시지 관리 탭 항목

    태그

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

    구분상세 설명
    태그 목록태그 목록
    • 태그의 Key, Value 정보 확인 가능
    • 태그는 자원 당 최대 50개까지 추가 가능
    • 태그 입력 시 기존에 생성된 Key와 Value 목록을 검색하여 선택
    표. Queue 상세 - 태그 탭 항목

    작업 이력

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

    구분상세 설명
    작업 이력 목록자원 변경 이력
    • 작업 일시, 자원 유형, 자원 ID, 자원명, 작업 내역, 이벤트 토픽, 작업 결과, 작업자 정보 확인
    표. Queue 상세 - 작업 이력 탭 항목

    Queue 구성 설정하기

    Queue Service 생성 시 설정한 구성을 다시 설정할 수 있습니다.
    Queue 구성을 다시 설정하려면 다음 절차를 따르세요.

    1. 모든 서비스 > Application > Queue Service 메뉴를 클릭하세요. Queue Service의 Service Home 페이지로 이동합니다.
    2. Service Home 페이지에서 Queue 메뉴를 클릭하세요. Queue 목록 페이지로 이동합니다.
    3. Queue 목록 페이지에서 Queue 구성을 다시 설정할 자원을 클릭하세요. Queue 상세 페이지로 이동합니다.
    4. 구성 설정 항목의 수정 버튼을 클릭하세요. 구성 설정 수정 팝업창이 열립니다.
    5. 구성 설정 수정 팝업창에서 구성 정보를 수정한 후, 확인 버튼을 클릭하세요.
      구분
      필수 여부
      상세 설명
      메시지 크기필수메시지 크기값(KB)을 1 ~ 256 사이로 입력
      • 자원당 최대 50개까지 추가가 가능
      메시지 보존 기간필수메시지 보존 기간을 입력
      • 단위 기간을 선택한 후, 원하는 값을 입력
        • : 60 ~ 1,209,600
        • : 1 ~ 20,160
        • : 1 ~ 336
        • : 1 ~ 14
      암호화필수암호화 사용 여부 선택
      • 신규 생성: KMS 페이지로 이동하여 새로운 KMS 암호화를 생성
      • 사용 안함: 암호화 사용 안함
      • KMS 암호화: KMS 사용 시 선택
        • Data Key 재사용 기간: 단위 기간을 선택한 후, 원하는 값을 입력
          • : 5 ~ 1,440
          • : 1 ~ 24
      표. Queue 구성 설정 수정 입력 항목

    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 Address는 최대 150개까지 추가할 수 있습니다.

    접근 가능 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. 메시지 목록에서 삭제할 메시지를 모두 선택한 후, 목록 상단의 더보기 > 삭제 버튼을 클릭하세요.
      • 메시지 목록에서 삭제할 메시지의 오른쪽 끝에 있는 삭제 버튼을 클릭하여 개별적으로 삭제할 수도 있습니다.
    6. 메시지 삭제를 알리는 팝업창이 열리면 확인 버튼을 클릭하세요.

    Queue 내의 모든 메시지 비우기

    Queue 비우기로 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와 직접 통신하므로 보안성이 강화됩니다.

    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 Service 연결시 사용 승인이 자동으로 처리됩니다.
    • PrivateLink Endpoint의 Security Group을 확인하여 접근 대상 VM IP의 등록 여부를 확인하세요.
    주의
    PrivateLink Endpoint를 통해 연결하는 경우, IAM 정책과 인증키의 IP 접근 제어를 사용할 수 없습니다.