- Pedido HTTP
- Parâmetros de caminho
- Parâmetros de consulta
- Corpo do pedido
- Corpo da resposta
- Âmbitos de autorização
- Autorizações de IAM
Cria uma nova investigação num determinado projeto.
Pedido HTTP
POST https://geminicloudassist.googleapis.com/v1alpha/{parent=projects/*/locations/*}/investigations
O URL usa a sintaxe de transcodificação de gRPC.
Parâmetros de caminho
| Parâmetros | |
|---|---|
parent |
Obrigatório. Valor para o pai ou a mãe. A localização tem de ser definida como "global". |
Parâmetros de consulta
| Parâmetros | |
|---|---|
investigationId |
Opcional. ID a usar para a investigação, que se torna o componente final do nome do recurso da investigação. Este valor deve ter entre 4 e 63 carateres, e os carateres válidos são /[a-z][0-9]-/. Se não for fornecido, o servidor gera um ID exclusivo para a investigação. |
requestId |
Opcional. Um ID de pedido opcional para identificar pedidos. Especifique um ID de pedido exclusivo para que, se tiver de repetir o pedido, o servidor saiba que deve ignorá-lo se já tiver sido concluído. O servidor garante que, durante, pelo menos, 60 minutos desde o primeiro pedido. Por exemplo, considere uma situação em que faz um pedido inicial e o pedido excede o tempo limite. Se fizer o pedido novamente com o mesmo ID do pedido, o servidor pode verificar se a operação original com o mesmo ID do pedido foi recebida e, em caso afirmativo, ignora o segundo pedido. Isto impede que os clientes criem acidentalmente compromissos duplicados. O ID do pedido tem de ser um UUID válido, exceto o UUID zero, que não é suportado (00000000-0000-0000-0000-000000000000). |
Corpo do pedido
O corpo do pedido contém uma instância de Investigation.
Corpo da resposta
Se for bem-sucedido, o corpo da resposta contém uma instância recém-criada de Investigation.
Âmbitos de autorização
Requer o seguinte âmbito do OAuth:
https://www.googleapis.com/auth/cloud-platform
Para mais informações, consulte o Authentication Overview.
Autorizações de IAM
Requer a seguinte autorização de IAM no recurso parent:
geminicloudassist.investigations.create
Para mais informações, consulte a documentação do IAM.