Method: projects.locations.dataAgents.create

Cria um novo DataAgent em determinado projeto e local.

Solicitação HTTP

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

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

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. Valor do elemento principal.

Parâmetros de consulta

Parâmetros
dataAgentId

string

Opcional. ID do objeto solicitante. Precisa ser exclusivo no elemento pai. O formato permitido é: ^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$. Se não for fornecido, o servidor vai gerar automaticamente um valor para o ID.
requestId

string

Opcional. Um ID de solicitação opcional para identificar solicitações. Especifique um ID de solicitação exclusivo para que, se precisar repetir a solicitação, o servidor saberá que é preciso ignorar a solicitação se ela já tiver sido concluída. O servidor vai garantir isso por pelo menos 60 minutos após a primeira solicitação.

Por exemplo, considere uma situação em que você faz uma solicitação inicial e ela expira. Se você fizer a solicitação novamente com o mesmo ID, o servidor poderá verificar se a operação original com o mesmo ID foi recebida e, em caso afirmativo, vai ignorar a segunda solicitação. Isso evita que os clientes criem compromissos duplicados acidentalmente.

O ID da solicitação precisa ser um UUID válido, com exceção de que o UUID zero não é aceito (00000000-0000-0000-0000-000000000000).

Corpo da solicitação

O corpo da solicitação contém uma instância de DataAgent.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta incluirá uma instância de Operation.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso parent:

  • geminidataanalytics.dataAgents.create

Para mais informações, consulte a documentação do IAM.