Method: projects.locations.dataAgents.create

Tạo một DataAgent mới trong một dự án và vị trí nhất định.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
parent

string

Bắt buộc. Giá trị cho phần tử mẹ.

Tham số truy vấn

Thông số
dataAgentId

string

Không bắt buộc. Mã nhận dạng của đối tượng yêu cầu. Phải là duy nhất trong phần tử mẹ. Định dạng được phép là: ^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$.

requestId

string

Không bắt buộc. Mã yêu cầu không bắt buộc để xác định yêu cầu. Chỉ định một mã yêu cầu duy nhất để nếu bạn phải thử lại yêu cầu, máy chủ sẽ biết bỏ qua yêu cầu nếu yêu cầu đó đã hoàn tất. Máy chủ sẽ đảm bảo điều đó trong ít nhất 60 phút kể từ yêu cầu đầu tiên.

Ví dụ: hãy xem xét trường hợp bạn đưa ra một yêu cầu ban đầu và yêu cầu đó hết thời gian chờ. Nếu bạn gửi lại yêu cầu có cùng mã yêu cầu, máy chủ có thể kiểm tra xem liệu đã nhận được thao tác ban đầu có cùng mã yêu cầu hay chưa. Nếu có, máy chủ sẽ bỏ qua yêu cầu thứ hai. Điều này giúp khách hàng không vô tình tạo các cam kết trùng lặp.

Mã yêu cầu phải là một UUID hợp lệ, ngoại trừ trường hợp không hỗ trợ UUID rỗng (00000000-0000-0000-0000-000000000000).

Nội dung yêu cầu

Nội dung yêu cầu chứa một bản sao của DataAgent.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một thực thể Operation mới tạo.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem Authentication Overview.