Method: projects.locations.targets.delete

1 つの Target を削除します。

HTTP リクエスト

DELETE https://clouddeploy.googleapis.com/v1/{name=projects/*/locations/*/targets/*}

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
name

string

必須。削除する Target の名前。形式は projects/{projectId}/locations/{location_name}/targets/{target_name} にする必要があります。

クエリ パラメータ

パラメータ
requestId

string

省略可。リクエストを識別するリクエスト ID。一意のリクエスト ID を指定することで、リクエストの再試行が必要なときに、リクエストが完了していれば、サーバーがリクエストを無視できるようになります。サーバーは、最初のリクエストから少なくとも 60 分間はこれを保証します。

たとえば、最初のリクエストを行い、そのリクエストがタイムアウトしたとします。同じリクエスト ID で再度リクエストを行うと、サーバーは元のオペレーションを同じリクエスト ID で受信していたかどうかを確認できます。受信していた場合は、2 回目のリクエストは無視されます。これにより、クライアントが重複するコミットを誤って作成することを防ぐことができます。

リクエスト ID は有効な UUID でなければなりません。ただし、ゼロ UUID(00000000-0000-0000-0000-000000000000)はサポートされていません。

allowMissing

boolean

省略可。true に設定すると、すでに削除されたか、存在しない Target の削除が成功します。

validateOnly

boolean

省略可。設定されている場合、リクエストを検証し、レビューをプレビューしますが、実際の投稿は行いません。

etag

string

省略可。このチェックサムは、他のフィールドの値に基づいてサーバーによって計算されて、更新リクエストと削除リクエストで送信され、続行する前にクライアントが最新の値を持っていることを確認できます。

リクエストの本文

リクエストの本文は空にする必要があります。

レスポンスの本文

成功した場合、レスポンスの本文には Operation のインスタンスが含まれます。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/cloud-platform

詳細については、認証の概要をご覧ください。

IAM 権限

name リソースに対する次の IAM 権限が必要です。

  • clouddeploy.targets.delete

詳細については、IAM のドキュメントをご覧ください。