Cloud Tasks キューを作成する

コンソール

1. Google Cloud コンソールで、[Cloud Tasks] > [キュー] ページに移動します。

   [キュー] に移動

2. add_box [キューを作成] をクリックします。

3. キュー名を入力します（例: my-queue）。

4. [リージョン] リストで、キューが実行されるサポートされているロケーション（asia-south1 など）を選択します。

   組織がリソース ロケーションを制限していて、us-central1 または us-central2 のいずれかでキューを作成する場合、組織のポリシーにより（どちらか 1 つのリージョンでのみキューを作成する場合でも）us-central1とus-central2 の両方でキューの作成が許可されている必要があります。

5. 必要に応じて、キューをさらに構成できます。

6. [作成] をクリックします。

gcloud

gcloud tasks queues create コマンドを使用して、キューを作成します。

  gcloud tasks queues create QUEUE_ID \
      --location=LOCATION

次のように置き換えます。

• QUEUE_ID: キューに割り当てる識別子（例: my-queue）。

• LOCATION: キューが実行されるサポートされているリージョン（例: asia-south1）。

  組織がリソース ロケーションを制限していて、us-central1 または us-central2 のいずれかでキューを作成する場合、組織のポリシーにより（どちらか 1 つのリージョンでのみキューを作成する場合でも）us-central1とus-central2 の両方でキューの作成が許可されている必要があります。

gcloud CLI コマンドの他のフラグを使用すると、レート制限、再試行オプション、キュータイプなどを構成できます。

REST API

キューを作成するには、projects.locations.queues.create メソッドを使用します。

リクエストのデータを使用する前に、次のように置き換えます。

• PROJECT_ID: 実際の Google Cloud プロジェクト ID。
• LOCATION: キューが実行されるサポートされているリージョン（例: asia-south1）。

  組織がリソース ロケーションを制限していて、us-central1 または us-central2 のいずれかでキューを作成する場合、組織のポリシーにより（どちらか 1 つのリージョンでのみキューを作成する場合でも）us-central1とus-central2 の両方でキューの作成が許可されている必要があります。

• QUEUE_ID: キューに割り当てる識別子（例: my-queue）。

リクエストの本文（JSON）:

{
  "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID"
}

リクエストを送信するには、次のいずれかのオプションを展開します。

cat > request.json << 'EOF'
{
  "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID"
}
EOF

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

@'
{
  "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID"
}
'@  | Out-File -FilePath request.json -Encoding utf8

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

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues" | Select-Object -Expand Content

成功した場合、レスポンスの本文には、新しく作成された 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"
}

コンソール

1. Google Cloud コンソールで、[Cloud Tasks] > [キュー] ページに移動します。

   [キュー] に移動

   緑色のチェックマーク check_circle は、キューが実行中であることを示します。

2. 詳細を表示するには、キューの名前をクリックし、[構成] タブをクリックします。

gcloud

gcloud tasks queues describe コマンドを使用して、キューが正常に作成されたことを確認します。

gcloud tasks queues describe QUEUE_ID \
    --location=LOCATION

次のように置き換えます。

• QUEUE_ID: キュー ID（略称）
• LOCATION: キューの場所

出力例を以下に示します。

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

REST API

キューを取得するには、projects.locations.queues.get メソッドを使用します。

リクエストのデータを使用する前に、次のように置き換えます。

• PROJECT_ID: 実際の Google Cloud プロジェクト ID。
• LOCATION: キューがデプロイされているリージョン（例: us-central1）。
• QUEUE_ID: キューの短い ID（例: my-queue）。

リクエストを送信するには、次のいずれかのオプションを展開します。

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

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

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

成功した場合、レスポンスの本文には 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"
}