指定されたプロジェクトとロケーションで新しい Investigation を作成します。
HTTP リクエスト
POST https://geminicloudassist.googleapis.com/v1alpha/{parent=projects/*/locations/*}/investigations
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ | |
---|---|
parent |
必須。親の値。 |
クエリ パラメータ
パラメータ | |
---|---|
investigationId |
省略可。Investigation に使用する ID。Investigation のリソース名の最終的なコンポーネントになります。 この値は 4~63 文字で、有効な文字は /[a-z][0-9]-/ です。 指定しない場合、サーバーは Investigation の一意の ID を生成します。 |
requestId |
省略可。リクエストを識別するリクエスト ID(省略可)。一意のリクエスト ID を指定することで、リクエストの再試行が必要なときに、リクエストが完了していれば、サーバーがリクエストを無視できるようになります。サーバーは、最初のリクエストから少なくとも 60 分間はこれを保証します。 たとえば、最初のリクエストを行い、そのリクエストがタイムアウトしたとします。同じリクエスト ID で再度リクエストを行うと、サーバーは元のオペレーションを同じリクエスト ID で受信していたかどうかを確認できます。受信していた場合は、2 回目のリクエストは無視されます。これにより、クライアントが重複するコミットを誤って作成することを防ぐことができます。 リクエスト ID は有効な UUID でなければなりません。ただし、ゼロ UUID(00000000-0000-0000-0000-000000000000)はサポートされていません。 |
リクエストの本文
リクエストの本文には Investigation
のインスタンスが含まれます。
レスポンスの本文
成功した場合、レスポンスの本文には、新しく作成された Investigation
のインスタンスが含まれます。
認可スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/cloud-platform
詳細については、Authentication Overview をご覧ください。
IAM 権限
parent
リソースに対する次の IAM 権限が必要です。
geminicloudassist.investigations.create
詳細については、IAM のドキュメントをご覧ください。