Method: projects.locations.dataAgents.create

Cria um novo DataAgent num determinado projeto e localização.

Pedido HTTP

POST https://geminidataanalytics.googleapis.com/v1alpha/{parent=projects/*/locations/*}/dataAgents

O URL usa a sintaxe de transcodificação de gRPC.

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. Valor para o pai ou a mãe.

Parâmetros de consulta

Parâmetros
dataAgentId

string

Opcional. ID do objeto de pedido. Tem de ser único no elemento principal. O formato permitido é: ^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$. Se não for fornecido, o servidor gera automaticamente um valor para o ID.

requestId

string

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.