큐 및 태스크 관리

다음과 같은 방법으로 큐와 작업을 관리할 수 있습니다.

• Google Cloud 콘솔에서 다음을 수행합니다.
• 터미널 또는 Cloud Shell에서 Google Cloud CLI 사용
• Cloud Tasks API에 요청을 전송하는 경우

큐에서 태스크 삭제

할 일이 예약되었거나 디스패치된 경우 삭제할 수 있습니다. 예를 들어 여러 번 재시도해도 완료가 안되는 태스크의 경우 삭제가 필요할 수 있습니다. 작업이 성공적으로 완료되었거나 일관되게 실패한 후 재시도 횟수가 소진된 경우에는 작업을 삭제할 수 없습니다.

콘솔

1. Google Cloud 콘솔에서 Cloud Tasks > 대기열 페이지로 이동합니다.

   대기열로 이동

2. 삭제할 태스크가 있는 큐의 이름을 클릭합니다.

3. 삭제할 작업의 체크박스를 선택합니다.

4. 할 일 삭제를 클릭합니다.

5. 메시지가 표시되면 삭제를 클릭합니다.

gcloud

gcloud tasks delete 명령어를 사용하여 태스크를 삭제합니다.

gcloud tasks delete TASK_NAME \
    --queue=QUEUE_ID \
    --location=LOCATION

다음을 바꿉니다.

• TASK_NAME: 삭제할 작업의 이름
• QUEUE_ID: 작업이 속한 대기열의 이름
• LOCATION: 큐가 배포되는 리전입니다(예: us-central1).

REST

작업을 삭제하려면 projects.locations.queues.tasks.delete 메서드를 사용합니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

• QUEUE_ID: 태스크가 속한 대기열의 이름
• TASK_NAME: 삭제할 작업의 이름
• PROJECT_ID: Google Cloud프로젝트 ID
• LOCATION: 큐가 있는 리전입니다(예: us-central1).

요청 본문은 비어 있어야 합니다.

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하거나 gcloud CLI에 자동으로 로그인하는 Cloud Shell을 사용하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

다음 명령어를 실행합니다.

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID/tasks/TASK_NAME"

PowerShell(Windows)

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID/tasks/TASK_NAME" | Select-Object -Expand Content

API 탐색기(브라우저)

메서드 참조 페이지를 엽니다. 페이지 오른쪽에 API 탐색기 패널이 열립니다. 이 도구를 사용하여 요청을 보낼 수 있습니다. 모든 필수 필드를 입력하고 실행을 클릭합니다.

성공한 경우 응답 본문은 비어 있습니다.

큐에서 모든 태스크 삭제

태스크를 삭제하여 큐에서 모든 태스크를 삭제할 수 있습니다. 삭제 호출 전에 생성된 모든 태스크는 완전히 삭제됩니다. 하지만 삭제 작업이 적용되는 데 최대 1분이 걸릴 수 있으며 삭제가 적용되기 전에 작업이 디스패치될 수 있습니다.

경고: 삭제 호출과 가까운 시점 (몇 초 이내)에 생성된 태스크도 삭제됩니다.

콘솔

1. Google Cloud 콘솔에서 Cloud Tasks > 대기열 페이지로 이동합니다.

   대기열로 이동

2. 삭제할 태스크가 있는 큐의 이름을 클릭합니다.

3. 큐 삭제를 클릭합니다.

4. 메시지가 표시되면 삭제를 클릭합니다.

gcloud

gcloud tasks queues purge 명령어를 사용하여 대기열을 삭제합니다.

gcloud tasks queues purge QUEUE_ID \
    --location=LOCATION

다음을 바꿉니다.

• QUEUE_ID: 삭제하려는 대기열의 이름
• LOCATION: 큐가 배포되는 리전입니다(예: us-central1).

REST

대기열을 삭제하려면 projects.locations.queues.purge 메서드를 사용합니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

• QUEUE_ID: 삭제할 큐의 이름
• PROJECT_ID: Google Cloud프로젝트 ID
• LOCATION: 큐가 배포되는 리전입니다(예: us-central1).

요청 본문은 비어 있어야 합니다.

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하거나 gcloud CLI에 자동으로 로그인하는 Cloud Shell을 사용하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

다음 명령어를 실행합니다.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID:purge"

PowerShell(Windows)

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID:purge" | Select-Object -Expand Content

API 탐색기(브라우저)

메서드 참조 페이지를 엽니다. 페이지 오른쪽에 API 탐색기 패널이 열립니다. 이 도구를 사용하여 요청을 보낼 수 있습니다. 모든 필수 필드를 입력하고 실행을 클릭합니다.

성공하면 응답 본문에 Queue 인스턴스가 포함됩니다.

{
  "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID",
  "rateLimits": {
    "maxDispatchesPerSecond": 500,
    "maxBurstSize": 100,
    "maxConcurrentDispatches": 1000
  },
  "retryConfig": {
    "maxAttempts": 100,
    "minBackoff": "0.100s",
    "maxBackoff": "3600s",
    "maxDoublings": 16
  },
  "state": "RUNNING",
  "purgeTime": "2025-03-28T13:06:30.110255Z"
}

대기열 일시중지 또는 다시 시작

대기열을 일시중지하거나 재개할 수 있습니다. 큐를 일시중지하면 태스크의 실행 및 전송이 중지됩니다. 태스크를 만들고 큐에 푸시하거나 추가할 수는 있지만 태스크가 처리되지는 않습니다. 대기열이 재개되면 백로그된 작업이 대기열 백로그에 추가된 순서대로 처리됩니다.

콘솔

1. Google Cloud 콘솔에서 Cloud Tasks > 대기열 페이지로 이동합니다.

   대기열로 이동

2. 일시중지하려는 대기열의 체크박스를 선택합니다.

3. 대기열 일시중지를 클릭합니다.

4. 메시지가 표시되면 일시중지를 클릭합니다.

5. 대기열을 재개하려면 대기열 재개를 클릭합니다.

gcloud

1. gcloud tasks queues pause 명령어를 사용하여 대기열을 일시중지합니다.

   gcloud tasks queues pause QUEUE_ID \
       --location=LOCATION

   다음을 바꿉니다.

   • QUEUE_ID: 일시중지할 대기열의 이름
   • LOCATION: 큐가 배포되는 리전입니다(예: us-central1).

2. gcloud tasks queues resume 명령어를 사용하여 대기열을 재개합니다.

   gcloud tasks queues resume QUEUE_ID \
       --location=LOCATION

REST

1. 대기열을 일시중지하려면 projects.locations.queues.pause 메서드를 사용합니다.

   요청 데이터를 사용하기 전에 다음을 바꿉니다.

   • QUEUE_ID: 일시중지할 대기열의 이름
   • PROJECT_ID: Google Cloud프로젝트 ID
   • LOCATION: 큐가 배포되는 리전입니다(예: us-central1).

   요청 본문은 비어 있어야 합니다.

   요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

   cURL(Linux, macOS, Cloud Shell)

   참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하거나 gcloud CLI에 자동으로 로그인하는 Cloud Shell을 사용하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

   다음 명령어를 실행합니다.

   curl -X POST \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d "" \
        "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID:pause"

   PowerShell(Windows)

   참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

   다음 명령어를 실행합니다.

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method POST `
       -Headers $headers `
       -Uri "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID:pause" | Select-Object -Expand Content

   API 탐색기(브라우저)

   메서드 참조 페이지를 엽니다. 페이지 오른쪽에 API 탐색기 패널이 열립니다. 이 도구를 사용하여 요청을 보낼 수 있습니다. 모든 필수 필드를 입력하고 실행을 클릭합니다.

   성공하면 응답 본문에 Queue 인스턴스가 포함됩니다.

   {
     "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID",
     "rateLimits": {
       "maxDispatchesPerSecond": 500,
       "maxBurstSize": 100,
       "maxConcurrentDispatches": 1000
     },
     "retryConfig": {
       "maxAttempts": 100,
       "minBackoff": "0.100s",
       "maxBackoff": "3600s",
       "maxDoublings": 16
     },
     "state": "PAUSED"
   }
   

2. 대기열을 재개하려면 projects.locations.queues.resume 메서드를 사용합니다.

   요청 데이터를 사용하기 전에 다음을 바꿉니다.

   • QUEUE_ID: 재개할 큐의 이름
   • PROJECT_ID: Google Cloud프로젝트 ID
   • LOCATION: 큐가 배포되는 리전입니다(예: us-central1).

   요청 본문은 비어 있어야 합니다.

   요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

   cURL(Linux, macOS, Cloud Shell)

   참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하거나 gcloud CLI에 자동으로 로그인하는 Cloud Shell을 사용하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

   다음 명령어를 실행합니다.

   curl -X POST \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d "" \
        "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID:resume"

   PowerShell(Windows)

   참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

   다음 명령어를 실행합니다.

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method POST `
       -Headers $headers `
       -Uri "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID:resume" | Select-Object -Expand Content

   API 탐색기(브라우저)

   메서드 참조 페이지를 엽니다. 페이지 오른쪽에 API 탐색기 패널이 열립니다. 이 도구를 사용하여 요청을 보낼 수 있습니다. 모든 필수 필드를 입력하고 실행을 클릭합니다.

   성공하면 응답 본문에 Queue 인스턴스가 포함됩니다.

   {
     "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID",
     "rateLimits": {
       "maxDispatchesPerSecond": 500,
       "maxBurstSize": 100,
       "maxConcurrentDispatches": 1000
     },
     "retryConfig": {
       "maxAttempts": 100,
       "minBackoff": "0.100s",
       "maxBackoff": "3600s",
       "maxDoublings": 16
     },
     "state": "RUNNING"
   }
   

큐 삭제

대기열을 삭제할 수 있습니다. 대기열의 모든 작업도 삭제됩니다. 대기열을 삭제한 경우 동일한 이름으로 다시 만들려면 3일이 지나야 합니다. 이 대기 기간은 삭제 시 실행 중이거나 실행 대기 중인 작업에서 예기치 않은 동작을 방지합니다. 또한 삭제 또는 재생성 주기의 내부 프로세스 오류도 방지됩니다.

콘솔

1. Google Cloud 콘솔에서 Cloud Tasks > 대기열 페이지로 이동합니다.

   대기열로 이동

2. 삭제할 대기열의 체크박스를 선택합니다.

3. 큐 삭제를 클릭합니다.

4. 프롬프트에서 대기열 이름을 입력한 다음 확인을 클릭합니다.

gcloud

gcloud tasks queues delete 명령어를 사용하여 대기열을 삭제합니다.

gcloud tasks queues delete QUEUE_ID \
    --location=LOCATION

다음을 바꿉니다.

• QUEUE_ID: 삭제할 대기열의 이름
• LOCATION: 큐가 배포되는 리전입니다(예: us-central1).

REST

대기열을 삭제하려면 projects.locations.queues.delete 메서드를 사용합니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

• QUEUE_ID: 삭제할 대기열의 이름
• PROJECT_ID: Google Cloud프로젝트 ID
• LOCATION: 큐가 배포되는 리전입니다(예: us-central1).

요청 본문은 비어 있어야 합니다.

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하거나 gcloud CLI에 자동으로 로그인하는 Cloud Shell을 사용하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

다음 명령어를 실행합니다.

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID"

PowerShell(Windows)

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID" | Select-Object -Expand Content

API 탐색기(브라우저)

메서드 참조 페이지를 엽니다. 페이지 오른쪽에 API 탐색기 패널이 열립니다. 이 도구를 사용하여 요청을 보낼 수 있습니다. 모든 필수 필드를 입력하고 실행을 클릭합니다.

성공한 경우 응답 본문은 비어 있습니다.