Creates a data release.

Takes DataReleaseInitiation JSON as input. Kicks off the Data Release Creation Workflow.

Only USGS identities or members of USGS Data Release Create group can create a data release using this endpoint.

If successful, returns a success message and the data model for the data release that was created only once the document has been written to the Globus Search Index

If unsuccessful, returns an error message.

Invalidates the user's group membership cache so that they can see their new group membership. Uses :func:crud.DataRelease.create.

Data Release Management Groups

Optionally, a user may choose to control access to a data release. This is done by providing Globus groups upon data release creation. For more information about Globus groups, visit: https://docs.globus.org/api/groups/.

A read-only and a read-write group will need to be created in Globus.

.. code-block::

from globus_sdk import GroupsClient, AccessTokenAuthorizer

# 1. Obtain an authorizer (using your access token)
# See https://globus-sdk-python.readthedocs.io/en/3.x-line/user_guide/getting_started/minimal_script.html
authorizer = AccessTokenAuthorizer("<YOUR_ACCESS_TOKEN>")

# 2. Initialize the GroupsClient
groups_client = GroupsClient(authorizer=authorizer)

# 3. Create the group
# See https://globus-sdk-python.readthedocs.io/en/3.x-line/services/groups.html
group_data = {
    "name": "Read-write group",
    "description": "Read-write permissions group for data release",
}
new_group = groups_client.create_group(group_data)

print(f"Group created with ID: {new_group['id']}")

The Horizon service will need to be given permission in the group. Please contact

.. code-block::

import globus_sdk

# 1. Setup the GroupsClient (assumes you have a valid authorizer)
groups_client = globus_sdk.GroupsClient(authorizer=your_authorizer)

# 2. Add the identity with the 'manager' role
group_id = "your-group-uuid"
identity_id = "contact ask-sdm@usgs.gov for the value to use"

response = groups_client.add_member(
    group_id, 
    identity_id, 
    role="manager"
)

print(f"Successfully added manager: {response}")

The resulting UUIDs from the creation of the groups should be saved and included in the request to create the data release.

:param release: The DataReleaseInitiation JSON of the data release to create. :param token: A valid bearer token for the user.