이 문서에서는 Pub/Sub Lite 주제를 생성, 확인, 삭제하는 방법을 설명합니다.
라이트 주제 개요
Pub/Sub Lite 서비스는 구독자가 메시지를 수신할 수 있도록 게시자가 메시지를 전송할 수 있는 주제가 필요합니다. Pub/Sub Lite 내에서는 영역 또는 리전 라이트 주제를 만들 수 있습니다.
영역 라이트 및 리전 라이트 주제는 데이터 복제 방식에서만 차이가 있습니다. 다른 주제 속성은 이 문서의 뒷부분에서 설명한 것과 동일합니다.
라이트 주제에서 데이터 복제
Pub/Sub 라이트 리전 주제는 단일 리전의 두 영역에 데이터를 저장합니다. Pub/Sub 라이트 영역 주제는 단일 영역 내에서만 데이터를 복제합니다. Pub/Sub 라이트는 데이터를 비동기식으로 복제합니다.
Pub/Sub 라이트의 가용성은 애플리케이션 프런트엔드 및 스토리지가 모두 포함된 기본 구성요소의 가용성에 따라 달라집니다.
Pub/Sub Lite 영역 주제의 가용성은 구성된 영역에서의 애플리케이션 프런트엔드 및 스토리지의 가용성에 따라 달라집니다. 애플리케이션 프런트엔드 또는 스토리지에 영역 오류가 발생하면 중단 기간 동안 영역 라이트 주제를 사용할 수 없습니다.
Pub/Sub Lite 리전 주제의 가용성은 구성된 리전에서 애플리케이션 프런트엔드 및 스토리지의 가용성에 따라 달라집니다. 다음 유형의 오류가 발생할 수 있습니다.
애플리케이션 프런트엔드 또는 스토리지에 영역 오류가 발생해도 리전 라이트 주제는 사용 가능한 상태로 유지됩니다.
애플리케이션 프런트엔드와 스토리지 모두 영역 오류가 발생하면 두 구성요소 모두 동시에 중단되지 않는 한 리전 라이트 주제가 사용 가능한 상태로 유지됩니다.
애플리케이션 프런트엔드와 스토리지 모두 동시에 중단되면 해당 중단 기간 동안 리전 라이트 주제를 사용할 수 없습니다. 이 시간 중에는 클라이언트가 메시지를 게시하거나 소비하지 못할 수 있지만 여전히 올바른 순서로 메시지가 전달됩니다.
리전 라이트 주제는 대부분의 단일 영역 오류 유형에 대한 보호 기능을 제공합니다. 하지만 드물지만 일부 경우에는 복제의 비동기식 특성으로 인해 단일 영역에서 여러 구성요소에 대한 동시 오류가 발생할 수 있습니다. 따라서 리전 라이트 주제를 사용할 수 없게 됩니다.
라이트 주제의 속성
라이트 주제에는 다음과 같은 속성이 있습니다.
파티션 개수. 파티션이란 Pub/Sub Lite에서 동시 로드의 기본 단위입니다. 라이트 주제는 하나 이상의 파티션을 포함할 수 있습니다.
파티션 용량. 파티션 용량은 다음 세 가지 속성으로 기술됩니다.
게시 처리량(MiBps). 메시지를 게시할 수 있는 최대 속도입니다.
구독 처리량(MiBps). 메시지가 라이트 구독으로 전달되는 최대 속도입니다.
스토리지(GiB). 파티션의 최대 메시지 크기입니다. 파티션의 최소 구성 가능 용량은 30GiB입니다.
라이트 주제의 스토리지 용량. 라이트 주제의 모든 파티션은 동일하게 구성된 스토리지 용량을 갖습니다. 라이트 주제의 총 스토리지 용량은 해당 주제에서 총 파티션의 스토리지 용량 합계입니다. 예를 들어 라이트 주제에 8개 파티션이 있고 각 파티션 크기가 30GiB이면 라이트 주제의 총 스토리지 용량은 240GiB(8 x 30)입니다.
라이트 주제의 처리량 용량. 처리량 용량은 라이트 주제에 있는 모든 파티션의 총 게시 및 구독 처리량 용량으로 구성됩니다. 모두 합해서 1GiBps의 게시 처리량을 지원할 수 있는 주제가 있더라도 실제로 처리량을 제한하는 것은 파티션별 게시 한도입니다.
구독자 클라이언트 및 구독 한도. Pub/Sub Lite는 단일 파티션 및 단일 구독에 대한 단일 구독자 클라이언트를 지원합니다. 예를 들어 파티션이 5개 있는 주제에 대한 구독은 여기에서 메시지를 소비하는 구독자 클라이언트를 최대 5개까지만 포함할 수 있습니다. 구독자 클라이언트를 더 많이 구성하면, 여분의 클라이언트가 유휴 상태로 유지됩니다. 동일한 주제에 구독이 2개면 각 구독당 5개 클라인트씩 총 10개의 구독자 클라이언트가 포함될 수 있습니다.
예약. 예약은 여러 주제에 대해 처리량 용량을 프로비저닝하고 관리할 수 있는 가장 쉬운 방법입니다. 예약을 통한 처리량 용량 프로비저닝은 리전 라이트의 경우 필수이고 영역 라이트 주제의 경우 선택사항입니다.
영역 라이트 주제에 예약을 사용하지 않을 경우에는 주제에 대해 게시 및 구독 처리량 용량을 명시적으로 프로비저닝해야 합니다. 예약이 없으면 라이트 주제의 모든 파티션에 동일한 처리량 용량이 구성됩니다. 자세한 내용은 예약 없이 처리량 용량 구성을 참조하세요.
스토리지 구성. 스토리지를 구성하려면 스토리지 용량과 선택사항인 메시지 보관 기간은 모두 지정해야 합니다.
메시지 보관 기간. 라이트 주제가 메시지를 저장하는 최대 기간입니다. 메시지 보관 기간을 지정하지 않으면 스토리지 용량을 초과할 때까지 라이트 주제에 메시지가 저장됩니다.
스토리지 용량. Pub/Sub Lite 주제 용량은 주제의 파티션 수와 각 파티션의 스토리지 용량에 따라 결정됩니다. 파티션당 스토리지는 각 파티션의 스토리지(바이트)입니다. 리전 라이트 주제는 게시된 각 바이트당 2바이트의 스토리지를 사용합니다. 영역 라이트 주제는 게시된 각 바이트당 1바이트의 스토리지를 사용합니다.
스토리지 용량을 초과하는 경우 Pub/Sub Lite 서비스가 메시지를 계속 게시합니다. 하지만 더 많은 스토리지 용량을 만들기 위해 파티션에서 가장 오래된 메시지가 삭제됩니다. 메시지가 메시지 보관 기간 내에 있더라도 가장 오래된 메시지 삭제가 수행됩니다. 새로 게시되는 메시지의 공간 확보를 위해 제거가 필요한 경우가 아닌 한 TTL이 만료되기 전에는 서비스에서 메시지가 삭제되지 않습니다. 용량 가격에 대한 자세한 내용은 Pub/Sub Lite 가격 책정을 참조하세요.
주제 이름 지정 가이드라인
Pub/Sub 라이트 리소스 이름은 주제, 구독, 예약과 같은 Pub/Sub 라이트 리소스를 고유하게 식별합니다. 리소스 이름은 다음 형식이어야 합니다.
projects/project-identifier/collection/ID
project-identifier
: Google Cloud 콘솔에서 사용 가능한 프로젝트 ID 또는 프로젝트 번호여야 합니다. 예를 들어my-cool-project
는 프로젝트 ID입니다.123456789123
은 프로젝트 번호입니다.collection
:topics
,subscriptions
,reservations
중 하나여야 합니다.ID
: 다음 가이드라인을 준수하세요.goog
문자열로 시작하지 않도록 합니다.- 문자로 시작합니다.
- 3~255자여야 합니다.
- 다음 문자(글자
[A-Za-z]
, 숫자[0-9]
, 대시-
, 밑줄_
, 마침표.
, 물결표~
, 더하기 기호+
, 퍼센트 기호%
)만 포함해야 합니다.
URL로 인코딩하지 않고 리소스 이름에 이전 목록의 특수문자를 사용할 수 있습니다. 하지만 다른 특수문자를 URL에 사용하는 경우 올바르게 암호화되거나 디코딩되었는지 확인해야 합니다. 예를 들어
mi-tópico
는 잘못된 ID입니다. 그러나mi-t%C3%B3pico
는 유효합니다. 이 형식은 REST를 호출할 때 중요합니다.
라이트 주제의 처리량 용량 증가
라이트 예약을 사용하지 않는 경우 영역 라이트 주제의 각 파티션의 처리량 용량을 다음 한도로 설정된 값으로 설정할 수 있습니다.
4~16MiBps 사이의 게시 처리량
4~32MiBps 사이의 구독 처리량
이러한 한도는 라이트 예약과 연결된 파티션에도 적용됩니다. 예약을 사용할 경우 각 파티션에서 예약의 총 용량이 초과되지 않는 한 지정된 한도 내에서 모든 처리 용량을 사용할 수 있습니다. 선택적으로 파티션당 실제 처리량 한도를 낮게 설정해서 트래픽을 더 예측 가능하게 만들 수 있습니다.
수평 확장을 위해서는 주제에서 파티션 수를 늘릴 수 있습니다. 주제의 파티션 수는 줄일 수 없습니다.
파티션 수를 변경해도 메시지의 상대적 순서는 유지되지 않습니다. 내부적으로 메시지는 해시 함수를 사용하여 파티션에 할당됩니다. 주제에서 파티션 수를 업데이트하면 이 해시 함수가 변경됩니다. 파티션 수 업데이트 후 게시된 동일한 키를 가진 메시지는 업데이트 전에 게시된 것과 다른 파티션에 매핑될 수 있습니다.
또한 주제 크기 조정이 모든 게시자에 전달되는 데 몇 초 정도 걸립니다. 잠시 동안은 일부 게시자에 새 해시 함수가 사용되고 일부에서는 여전히 이전 항목이 사용됩니다.
라이트 주제의 스토리지 용량 늘리기
라이트 주제에서 스토리지를 늘리거나 줄일 수도 있습니다. 라이트 주제는 각 파티션에 동일한 양의 스토리지를 프로비저닝합니다. 스토리지를 60 GiB로 늘리면 각 파티션은 60 GiB의 스토리지를 얻게 됩니다.
라이트 주제의 스토리지 용량을 줄이면 Pub/Sub Lite 서비스가 가장 오래된 메시지를 먼저 삭제합니다.
용량 가격에 대한 자세한 내용은 Pub/Sub Lite 가격 책정을 참조하세요.
라이트 주제 만들기
Google Cloud 콘솔, Google Cloud CLI, Pub/Sub Lite API를 사용하여 라이트 주제를 만들 수 있습니다.
사용 가능한 리전 및 영역 목록은 Pub/Sub 라이트 위치를 참조하세요.
콘솔
라이트 주제 페이지로 이동합니다.
라이트 주제 만들기를 클릭합니다.
영역 라이트 주제를 만들려면 리전과 리전 내에서 영역을 선택합니다.
영역 라이트 주제를 만들기 위해 리전을 선택합니다.
주제가 생성된 후에는 위치를 업데이트할 수 없습니다.
이름 섹션에서 라이트 주제 ID를 입력합니다.
라이트 주제 이름에는 라이트 주제 ID, 위치, 프로젝트 번호가 포함됩니다.
처리량 섹션에서 다음을 수행합니다.
예약을 선택하거나 만듭니다.
이는 영역 라이트 주제의 경우 선택사항이며 리전 라이트 주제의 경우 필수입니다.
최대 게시 처리량과 최대 구독 처리량을 입력합니다.
입력에 따라 파티션 수가 자동으로 설정됩니다. 주제를 저장한 후 이 숫자를 수정할 수 있습니다.
메시지 스토리지 섹션에서 다음을 수행합니다.
파티션당 스토리지를 입력합니다.
메시지 보관 기간에 대해 두 옵션 중 하나를 선택합니다.
변경사항을 검토하고 만들기를 클릭합니다.
gcloud
라이트 주제를 만들려면 gcloud pubsub lite-topics create
명령어를 사용합니다.
gcloud pubsub lite-topics create TOPIC_ID \ --location=LOCATION \ --partitions=NUMBER_OF_PARTITIONS \ --per-partition-bytes=STORAGE_PER_PARTITION \ [--throughput-reservation=RESERVATION_NAME \] [--message-retention-period=MESSAGE_RETENTION_PERIOD]
다음을 바꿉니다.
TOPIC_ID: 라이트 주제의 ID
LOCATION: Pub/Sub Lite가 지원하는 위치의 이름
NUMBER_OF_PARTITIONS: 라이트 주제의 파티션 수(정수)
STORAGE_PER_PARTITION: 각 파티션의 스토리지 용량(예:
30GiB
)RESERVATION_NAME:
projects/123456789/locations/us-west1/reservations/my-reservation
과 같은 라이트 예약의 정규화된 경로MESSAGE_RETENTION_PERIOD: 라이트 주제에서 메시지를 저장하는 시간(예:
1d
또는2w
)
요청이 성공하면 명령줄에 확인 메시지가 표시됩니다.
Created [TOPIC_ID].
프로토콜
라이트 주제를 만들려면 다음과 같이 POST
요청을 보내세요.
POST https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID Authorization: Bearer $(gcloud auth print-access-token)
다음을 바꿉니다.
REGION: 라이트 주제를 저장할 리전
PROJECT_NUMBER: 라이트 주제를 만들 프로젝트의 프로젝트 번호입니다.
LOCATION: Pub/Sub Lite가 지원하는 위치의 이름
TOPIC_ID: 라이트 주제의 ID
요청 본문에 다음 필드를 지정합니다.
{ "partitionConfig": { "count": NUMBER_OF_PARTITIONS, "capacity": { "publishMibPerSec": publish_CAPACITY, "subscribeMibPerSec": subscribe_CAPACITY, } }, "retentionConfig": { "perPartitionBytes": STORAGE_PER_PARTITION, "period": MESSAGE_RETENTION_PERIOD, }, "reservationConfig": { "throughputReservation": RESERVATION_NAME } }
다음을 바꿉니다.
NUMBER_OF_PARTITIONS: 라이트 주제의 파티션 수(정수)
STORAGE_PER_PARTITION: 각 파티션의 스토리지 용량(예:
30GiB
)publish_CAPACITY: 각 파티션의 게시 처리량 용량(정수)
subscribe_CAPACITY: 각 파티션의 게시 처리량 용량(정수)
MESSAGE_RETENTION_PERIOD: 라이트 주제에서 메시지를 저장하는 시간(예:
1d
또는2w
)RESERVATION_NAME:
projects/123456789/locations/us-west1/reservations/my-reservation
과 같은 라이트 예약의 정규화된 경로
요청이 성공하는 경우 응답은 JSON 형식의 라이트 주제입니다.
{ "name": projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID, "partitionConfig": { "count": NUMBER_OF_PARTITIONS, "capacity": { "publishMibPerSec": publish_CAPACITY, "subscribeMibPerSec": subscribe_CAPACITY, } }, "retentionConfig": { "perPartitionBytes": STORAGE_PER_PARTITION, "period": MESSAGE_RETENTION_PERIOD, }, "reservationConfig": { "throughputReservation": RESERVATION_NAME } }
Go
이 샘플을 실행하기 전에 Pub/Sub Lite 클라이언트 라이브러리의 Go 설정 안내를 따르세요.
자바
이 샘플을 실행하기 전에 Pub/Sub Lite 클라이언트 라이브러리의 자바 설정 안내를 따르세요.
Python
이 샘플을 실행하기 전에 Pub/Sub Lite 클라이언트 라이브러리의 Python 설정 안내를 따르세요.
라이트 주제를 만든 후에는 파티션당 처리량과 스토리지 용량을 확장할 수 있습니다. 파티션 수 또한 늘릴 수 있지만 줄일 수는 없습니다.
라이트 주제 업데이트
라이트 주제의 다음 속성을 업데이트할 수 있습니다.
라이트 주제와 연관된 예약
주제의 파티션 수(증가만 가능)
게시 및 구독 처리량 용량 한도
파티션당 스토리지
메시지 보관 유형
주제의 처리량 용량 또는 스토리지 용량을 확장하기 전에 처리량 용량 확장 및 스토리지 용량 확장을 참조하세요.
Google Cloud 콘솔, Google Cloud CLI, Pub/Sub Lite API를 사용하여 라이트 주제를 업데이트할 수 있습니다.
콘솔
라이트 주제 페이지로 이동합니다.
라이트 주제 ID를 클릭합니다.
수정을 클릭합니다.
다음 업데이트 중 일부 또는 모두를 수행할 수 있습니다.
- 다른 예약을 사용합니다. 영역 주제의 경우 예약을 사용하지 않도록 선택할 수 있습니다.
- 파티션 수를 입력합니다. 이 값을 늘릴 수 있지만, 줄일 수는 없습니다.
- 최대 허용되는 게시 및 구독 처리량을 사용 설정 또는 사용 중지합니다.
- 영역 주제의 경우 예약된 게시 및 구독 처리량을 업데이트합니다. 예약이 연결된 주제의 경우 업데이트된 처리량에 새로운 최대 한도가 반영됩니다.
- 파티션당 스토리지 용량을 수정합니다.
- 메시지 보관 기간을 수정합니다.
업데이트를 클릭합니다.
gcloud
라이트 주제를 업데이트하려면 gcloud pubsub lite-topics update
명령어를 사용합니다.
gcloud pubsub lite-topics update TOPIC_ID \ --location=LOCATION \ --partitions=NUMBER_OF_PARTITIONS \ --per-partition-publish-mib=publish_CAPACITY \ --per-partition-subscribe-mib=subscribe_CAPACITY \ --per-partition-bytes=STORAGE_PER_PARTITION \ --message-retention-period=MESSAGE_RETENTION_PERIOD
다음을 바꿉니다.
TOPIC_ID: 라이트 주제의 ID
LOCATION: 라이트 주제가 있는 위치의 이름
NUMBER_OF_PARTITIONS: 라이트 주제를 위해 구성할 파티션 수
publish_CAPACITY: 각 파티션의 게시 처리량 용량(정수)
subscribe_CAPACITY: 각 파티션의 게시 처리량 용량(정수)
STORAGE_PER_PARTITION: 각 파티션의 스토리지 용량(예:
30GiB
)MESSAGE_RETENTION_PERIOD: 라이트 주제에서 메시지를 저장하는 시간(예:
1d
또는2w
)
요청이 성공하면 명령줄에 라이트 주제가 표시됩니다.
name: projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID partitionConfig: count: NUMBER_OF_PARTITIONS capacity: publishMibPerSec: publish_CAPACITY subscribeMibPerSec: subscribe_CAPACITY retentionConfig: perPartitionBytes: STORAGE_PER_PARTITION period: MESSAGE_RETENTION_PERIOD
프로토콜
라이트 주제를 업데이트하려면 다음과 같이 PATCH
요청을 보내세요.
PATCH https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID?updateMask=partitionConfig.capacity,retentionConfig.perPartitionBytes,retentionConfig.period,partitionConfig.count Authorization: Bearer $(gcloud auth print-access-token)
다음을 바꿉니다.
REGION: 라이트 주제가 있는 리전
PROJECT_NUMBER: 라이트 주제가 있는 프로젝트의 프로젝트 번호
LOCATION: 라이트 주제가 있는 위치의 이름
TOPIC_ID: 라이트 주제의 ID
요청 본문에 다음 필드를 지정합니다.
{ "partitionConfig": { "count": NUMBER_OF_PARTITIONS, "capacity": { "publishMibPerSec": publish_CAPACITY, "subscribeMibPerSec": subscribe_CAPACITY, } }, "retentionConfig": { "perPartitionBytes": STORAGE_PER_PARTITION, "period": MESSAGE_RETENTION_PERIOD, }, }
다음을 바꿉니다.
publish_CAPACITY: 각 파티션의 게시 처리량 용량(정수)
subscribe_CAPACITY: 각 파티션의 게시 처리량 용량(정수)
STORAGE_PER_PARTITION: 각 파티션의 스토리지 용량(예:
30GiB
)MESSAGE_RETENTION_PERIOD: 라이트 주제에서 메시지를 저장하는 시간(예:
1d
또는2w
)NUMBER_OF_PARTITIONS: 라이트 주제를 위해 구성할 파티션 수
요청이 성공하는 경우 응답은 JSON 형식의 라이트 주제입니다.
{ "name": projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID, "partitionConfig": { "count": NUMBER_OF_PARTITIONS, "capacity": { "publishMibPerSec": publish_CAPACITY, "subscribeMibPerSec": subscribe_CAPACITY, } }, "retentionConfig": { "perPartitionBytes": STORAGE_PER_PARTITION, "period": MESSAGE_RETENTION_PERIOD, }, }
Go
이 샘플을 실행하기 전에 Pub/Sub Lite 클라이언트 라이브러리의 Go 설정 안내를 따르세요.
자바
이 샘플을 실행하기 전에 Pub/Sub Lite 클라이언트 라이브러리의 자바 설정 안내를 따르세요.
Python
이 샘플을 실행하기 전에 Pub/Sub Lite 클라이언트 라이브러리의 Python 설정 안내를 따르세요.
라이트 주제 세부정보 보기
Google Cloud 콘솔, Google Cloud CLI, Pub/Sub Lite API를 사용하여 라이트 주제에 대한 세부정보를 가져올 수 있습니다.
콘솔
라이트 주제 페이지로 이동합니다.
라이트 주제 ID를 클릭합니다.
gcloud
라이트 주제에 대한 세부정보를 가져오려면 gcloud pubsub lite-topics describe
명령어를 사용합니다.
gcloud pubsub lite-topics describe TOPIC_ID \ --location=LOCATION
다음을 바꿉니다.
TOPIC_ID: 라이트 주제의 ID
LOCATION: 라이트 주제가 있는 위치의 이름
요청이 성공하면 명령줄에 라이트 주제가 표시됩니다.
name: projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID partitionConfig: count: NUMBER_OF_PARTITIONS capacity: publishMibPerSec: publish_CAPACITY subscribeMibPerSec: subscribe_CAPACITY retentionConfig: perPartitionBytes: STORAGE_PER_PARTITION period: MESSAGE_RETENTION_PERIOD
프로토콜
라이트 주제에 대한 세부정보를 가져오려면 다음과 같이 GET
요청을 보냅니다.
GET https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID Authorization: Bearer $(gcloud auth print-access-token)
다음을 바꿉니다.
REGION: 라이트 주제가 있는 리전
PROJECT_NUMBER: 라이트 주제가 있는 프로젝트의 프로젝트 번호
LOCATION: 라이트 주제가 있는 위치의 이름
TOPIC_ID: 라이트 주제의 ID
요청이 성공하는 경우 응답은 JSON 형식의 라이트 주제입니다.
{ "name": projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID, "partitionConfig": { "count": NUMBER_OF_PARTITIONS, "capacity": { "publishMibPerSec": publish_CAPACITY, "subscribeMibPerSec": subscribe_CAPACITY, } }, "retentionConfig": { "perPartitionBytes": STORAGE_PER_PARTITION, "period": MESSAGE_RETENTION_PERIOD, }, }
Go
이 샘플을 실행하기 전에 Pub/Sub Lite 클라이언트 라이브러리의 Go 설정 안내를 따르세요.
자바
이 샘플을 실행하기 전에 Pub/Sub Lite 클라이언트 라이브러리의 자바 설정 안내를 따르세요.
Python
이 샘플을 실행하기 전에 Pub/Sub Lite 클라이언트 라이브러리의 Python 설정 안내를 따르세요.
라이트 주제 나열
Google Cloud 콘솔, Google Cloud CLI, Pub/Sub Lite API를 사용하여 프로젝트의 라이트 주제를 나열할 수 있습니다.
콘솔
프로젝트의 라이트 주제 목록을 보려면 라이트 주제 페이지로 이동하세요.
gcloud
- 프로젝트의 라이트 주제를 나열하려면
gcloud pubsub lite-topics list
명령어를 사용합니다.
gcloud pubsub lite-topics list \ --location=LOCATION
LOCATION을 라이트 주제가 있는 위치의 이름으로 바꿉니다.
요청이 성공하면 명령줄에 라이트 주제가 표시됩니다.
--- name: projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID partitionConfig: count: NUMBER_OF_PARTITIONS capacity: publishMibPerSec: publish_CAPACITY subscribeMibPerSec: subscribe_CAPACITY retentionConfig: perPartitionBytes: STORAGE_PER_PARTITION period: MESSAGE_RETENTION_PERIOND --- name: projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID partitionConfig: count: NUMBER_OF_PARTITIONS capacity: publishMibPerSec: publish_CAPACITY subscribeMibPerSec: subscribe_CAPACITY retentionConfig: perPartitionBytes: STORAGE_PER_PARTITION period: MESSAGE_RETENTION_PERIOND
프로토콜
프로젝트의 라이트 주제를 나열하려면 다음과 같이 GET
요청을 보냅니다.
GET https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/topics Authorization: Bearer $(gcloud auth print-access-token)
다음을 바꿉니다.
REGION: 라이트 주제가 있는 리전
PROJECT_NUMBER: 라이트 주제가 있는 프로젝트의 프로젝트 번호
요청이 성공하는 경우 응답은 JSON 형식의 라이트 주제 목록입니다.
{ "topics": [ { "name": "projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID", }, { "name": "projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID", } ] }
Go
이 샘플을 실행하기 전에 Pub/Sub Lite 클라이언트 라이브러리의 Go 설정 안내를 따르세요.
자바
이 샘플을 실행하기 전에 Pub/Sub Lite 클라이언트 라이브러리의 자바 설정 안내를 따르세요.
Python
이 샘플을 실행하기 전에 Pub/Sub Lite 클라이언트 라이브러리의 Python 설정 안내를 따르세요.
라이트 주제 삭제
Google Cloud 콘솔, Google Cloud CLI, Pub/Sub Lite API를 사용하여 라이트 주제를 삭제할 수 있습니다.
콘솔
라이트 주제 페이지로 이동합니다.
라이트 주제 ID를 클릭합니다.
주제 세부정보 페이지에서 삭제를 클릭합니다.
표시되는 필드에
delete
를 입력하여 라이트 주제를 삭제할지 여부를 확인합니다.삭제를 클릭합니다.
gcloud
라이트 주제를 삭제하려면 gcloud pubsub lite-topics delete
명령어를 사용합니다.
delete
명령어를 실행합니다.gcloud pubsub lite-topics delete TOPIC_ID \ --location=LOCATION
다음을 바꿉니다.
TOPIC_ID: 라이트 주제의 ID
LOCATION: 라이트 주제가 있는 위치의 이름
확인하려면
Y
를 입력합니다.
요청이 성공하면 응답은 다음과 같습니다.
Deleted topic [TOPIC_ID].
프로토콜
라이트 주제를 삭제하려면 다음과 같이 DELETE
요청을 보냅니다.
DELETE https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID Authorization: Bearer $(gcloud auth print-access-token)
다음을 바꿉니다.
REGION: 라이트 주제가 있는 리전
PROJECT_NUMBER: 라이트 주제가 있는 프로젝트의 프로젝트 번호
LOCATION: 라이트 주제가 있는 위치의 이름
TOPIC_ID: 라이트 주제의 ID
요청이 성공하면 응답은 빈 JSON 객체입니다.
Go
이 샘플을 실행하기 전에 Pub/Sub Lite 클라이언트 라이브러리의 Go 설정 안내를 따르세요.
자바
이 샘플을 실행하기 전에 Pub/Sub Lite 클라이언트 라이브러리의 자바 설정 안내를 따르세요.
Python
이 샘플을 실행하기 전에 Pub/Sub Lite 클라이언트 라이브러리의 Python 설정 안내를 따르세요.
라이트 주제를 삭제하면 라이트 주제에 메시지를 게시할 수 없습니다. 라이트 주제에 대한 라이트 구독이 여전히 존재하지만 라이트 구독에서 메시지를 받을 수 없습니다.
다음 단계
- 라이트 주제에 메시지를 게시합니다.
- 라이트 주제에 대해 라이트 구독을 만듭니다.
- 라이트 구독에서 메시지를 수신합니다.