Get a location in Landing Zone to upload a file.

Request

Creates a new location in the landing zone to upload a file. If a FileID isn't provided in the request, the File service generates a Universally Unique Identifier (UUID) to be stored in FileID. If a FileID is provided and is already registered in the system, an error is returned.

Required roles: 'service.file.editors'. Users added to groups 'users.datalake.editors', 'users.datalake.admins', 'users.datalake.ops' would be added to group 'service.file.editors' by default.

Security

bearer

data-partition-idstringrequired

desired data partition id.

Example:slb-osdu-prod-des-prod-testing

Bodyapplication/json

FileIDstring(FileID)^[\w,\s-]+(\.\w+)?$

Unique Identifier for the file

curl -i -X POST \
  https://as5.api.enterprisedata.slb.com/api/file/v2/getLocation \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'data-partition-id: slb-osdu-prod-des-prod-testing' \
  -d '{
    "FileID": "string"
  }'

Responses

Created location

Bodyapplication/json

FileIDstring(FileID)^[\w,\s-]+(\.\w+)?$

Unique Identifier for the file

Locationobject

Example:

{
  "SignedURL": "GCS signed URL"
}

Response

{
  "FileID": "string",
  "Location": {
    "SignedURL": "GCS signed URL"
  }
}