이 섹션의 다중 페이지 출력 화면임. 여기를 클릭하여 프린트.

이 페이지의 일반 화면으로 돌아가기.

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’ 형식 사용
    설명선택서비스 설명을 100자 이내로 입력
    메시지 크기필수메시지 크기값(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
    태그선택태그 추가
    • 자원당 최대 50개까지 추가가 가능
    • 태그 추가 버튼을 클릭한 후 Key, Value 값을 입력 또는 선택
    표. Queue 생성 정보 입력 항목
    1. 생성을 알리는 팝업창이 열리면 확인 버튼을 클릭하세요.

    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 유형
    구성 설정Queue 구성 정보
    • 메시지의 크기, 보존 기간, 암호화 사용 여부 표시
    • 수정 버튼을 클릭하여 수정 가능
      • 자세한 내용은 [Queue 구성 설정하기](#queue-구성-설정하기 참고)
    설명Queue 설명
    • 수정 버튼을 클릭하여 수정 가능
    IP 접근 허용 목록Queue 서비스에 접근이 허용된 IP 목록
    • IP Address 추가 버튼을 클릭하여 새로운 IP 등록 가능
    • 등록된 IP의 삭제 버튼을 클릭하여 제외 가능
    표. Queue 상세 - 상세 탭 항목

    메시지 관리

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

    참고
    • 메시지는 최대 10개까지 표시됩니다.
    • 메시지를 관리하는 방법은 메시지 관리하기를 참고하세요.
    구분상세 설명
    메세지 폴링Queue로부터 Console로 메시지 폴링 수행 및 메시지 목록 새로고침
    더보기메시지의 전송, 삭제, 제거 가능
    • 메시지 전송: 새로운 메시지를 전송
    • 삭제: 메시지 목록에서 선택한 메시지를 삭제
    • 제거: Queue에 포함된 모든 메시지를 삭제
    메시지 목록메시지 ID, 메시지 전송 일시, 메시지 수신 일시, 메시지 크기 확인 가능
    • 메시지 ID를 클릭하여 메시지 본문과 메타 정보 확인 가능
    • 삭제 버튼을 클릭하여 해당 메시지 삭제 가능
    메시지 전송 일시스냅샷 용량
    메시지 수신 일시스냅샷 생성된 일시
    메시지 크기스냅샷의 상태
    • Available: 생성 완료, 복구 가능
    • Creating: 생성 중
    • Error: 비정상 상태
    • Deleting: 삭제 중
    • Error Deleting: 삭제 중 비정상 상태
    • Restoring: 복구 중
    표. 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 제외하기

    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까지 입력 가능
    메타 정보선택메시지에 추가할 메타 정보의 사용 여부 선택
    • 사용 시 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의 모든 메시지를 삭제할 수 있습니다.

    주의
    • 메시지 제거를 통해 삭제한 메시지는 복구되지 않습니다.
    • 동일한 제거 요청이 진행 중인 경우, 삭제되지 않습니다. 잠시 후, 다시 메시지 제거를 진행하세요.

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

    1. 모든 서비스 > Application > Queue Service 메뉴를 클릭하세요. Queue Service의 Service Home 페이지로 이동합니다.
    2. Service Home 페이지에서 Queue 메뉴를 클릭하세요. Queue 목록 페이지로 이동합니다.
    3. Queue 목록 페이지에서 Queue 메시지를 제거할 자원을 클릭하세요. Queue 상세 페이지로 이동합니다.
    4. Queue 상세 페이지의 메시지 관리 탭을 클릭하세요.
    5. 메시지 목록 상단의 더보기 > 메시지 제거 버튼을 클릭하세요.
    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와 연계하여 인터넷 통신이 아닌 사용자 VPC에서 Queue Service와 직접 통신하여 보안성을 강화하여 서비스를 사용하실 수 있습니다.

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

    1. PrivateLink Endpoint 생성을 위한 Queue Service의 PrivateLink Service ID를 확인하세요.
      • Queue Service의 PrivateLink Service ID는 문의하기를 통하여 지원 받으실 수 있습니다.
    2. PrivateLink Endpoint를 생성하세요.
    참고
    • PrivateLink Service 연결시 사용 승인이 자동으로 처리됩니다.
    • PrivateLink Endpoint의 Security Group을 확인하여 접근 대상 VM IP의 등록 여부를 확인하십시오.
    주의
    PrivateLink Endpoint를 통해 연결하는 경우 IAM 정책과 인증키의 IP 접근제어는 사용할 수 없습니다.