Method: projects.locations.deliveryPipelines.targets.patch

1 つの共有の Target のパラメータを更新します。

HTTP リクエスト

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

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

パスパラメータ

パラメータ
target.name

string

省略可。Target の名前。形式は projects/{project}/locations/{location}/ deliveryPipelines/{deliveryPipeline}/targets/[a-z][a-z0-9-]{0,62} です。

クエリ パラメータ

パラメータ
updateMask

string (FieldMask format)

必須。フィールド マスクは、更新によって Target リソースで上書きするフィールドを指定するために使用されます。updateMask で指定されたフィールドは、リクエスト全体ではなく、リソースに対する相対フィールドです。マスクに含まれるフィールドは上書きされます。ユーザーがマスクを指定しなければ、すべてのフィールドが上書きされます。

完全修飾フィールド名のカンマ区切りリスト。例: "user.displayName,photo"。
requestId

string

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

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

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

boolean

省略可。true に設定した場合、存在しない Target を更新すると、新しい Target が作成されます。
validateOnly

boolean

省略可。true に設定すると、リクエストが検証され、ユーザーに想定される結果が提供されますが、実際の変更は行われません。

リクエストの本文

リクエストの本文には Target のインスタンスが含まれます。

レスポンスの本文

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

認証スコープ

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

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

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