- 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 um novo DataAgent num determinado projeto e localização.
Pedido HTTP
POST https://geminidataanalytics.googleapis.com/v1beta/{parent=projects/*/locations/*}/dataAgents
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. |
Parâmetros de consulta
Parâmetros | |
---|---|
dataAgentId |
Opcional. ID do objeto de pedido. Tem de ser único no elemento principal. O formato permitido é: |
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 DataAgent
.
Corpo da resposta
Se for bem-sucedido, o corpo da resposta contém uma instância recém-criada de Operation
.
Â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
:
geminidataanalytics.dataAgents.create
Para mais informações, consulte a documentação do IAM.