이 페이지는 Cloud Translation API를 통해 번역되었습니다.

큐 및 태스크 관리
컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

다음과 같은 방법으로 큐 및 태스크를 관리할 수 있습니다.

Google Cloud Console 사용
터미널 또는 Cloud Shell에서 Google Cloud CLI 사용
Cloud Tasks API에 요청을 전송합니다.

큐에서 태스크 삭제

할 일이 예약되었거나 전송된 경우 삭제할 수 있습니다. 예를 들어 여러 번 재시도해도 완료가 안되는 태스크의 경우 삭제가 필요할 수 있습니다. 태스크가 성공적으로 완료되었거나 지속적으로 실패한 후 재시도가 더 이상 남지 않은 경우에는 태스크를 삭제할 수 없습니다.

콘솔

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

대기열로 이동
삭제하려는 태스크의 큐 이름을 클릭합니다.
삭제하려는 작업의 체크박스를 선택합니다.
할 일 삭제를 클릭합니다.
메시지가 표시되면 삭제를 클릭합니다.

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분이 걸릴 수 있으며 삭제가 적용되기 전에 태스크가 전달될 수 있습니다.

콘솔

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

대기열로 이동
삭제하려는 태스크의 큐 이름을 클릭합니다.
큐 삭제를 클릭합니다.
메시지가 표시되면 삭제를 클릭합니다.

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)

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

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)

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

$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 탐색기(브라우저)

성공하면 응답 본문에 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"
}

현재 재생목록 일시중지 또는 재개

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

콘솔

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

대기열로 이동
일시중지하려는 대기열의 체크박스를 선택합니다.
대기열 일시중지를 클릭합니다.
메시지가 표시되면 일시중지를 클릭합니다.
대기열을 재개하려면 대기열 재개를 클릭합니다.

gcloud

gcloud tasks queues pause 명령어를 사용하여 큐를 일시중지합니다.
```
gcloud tasks queues pause QUEUE_ID \
    --location=LOCATION
```
다음을 바꿉니다.
- QUEUE_ID: 일시중지하려는 대기열의 이름
- LOCATION: 큐가 배포되는 리전입니다(예: us-central1).
gcloud tasks queues resume 명령어를 사용하여 큐를 재개합니다.
```
gcloud tasks queues resume QUEUE_ID \
    --location=LOCATION
```

REST

대기열을 일시중지하려면 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"
}
```
대기열을 재개하려면 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일이 지나야 합니다. 이 대기 시간은 삭제 시 실행 중이거나 실행 대기 중인 태스크에서 예기치 않은 동작이 발생하지 않도록 합니다. 또한 삭제 또는 재생성 주기에서 내부 프로세스 오류가 방지됩니다.

콘솔

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

대기열로 이동
삭제할 대기열의 체크박스를 선택합니다.
대기열 삭제를 클릭합니다.
메시지가 표시되면 대기열 이름을 입력한 다음 확인을 클릭합니다.

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)

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

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)

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

$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 탐색기(브라우저)

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

큐 및 태스크 관리 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

큐에서 태스크 삭제

콘솔

gcloud

REST

cURL(Linux, macOS, Cloud Shell)

PowerShell(Windows)

API 탐색기(브라우저)

큐에서 모든 태스크 삭제

콘솔

gcloud

REST

cURL(Linux, macOS, Cloud Shell)

PowerShell(Windows)

API 탐색기(브라우저)

현재 재생목록 일시중지 또는 재개

콘솔

gcloud

REST

cURL(Linux, macOS, Cloud Shell)

PowerShell(Windows)

API 탐색기(브라우저)

cURL(Linux, macOS, Cloud Shell)

PowerShell(Windows)

API 탐색기(브라우저)

큐 삭제

콘솔

gcloud

REST

cURL(Linux, macOS, Cloud Shell)

PowerShell(Windows)

API 탐색기(브라우저)

큐 및 태스크 관리
컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.