Sign in

Revoke a database share

Revokes a shared snapshot, deleting the underlying storage snapshot. The share is identified by its share token.

delete/spaces/{space_id}/shares/{share_token}

Path parameters

space_idstring required

Ghost space ID.

share_tokenstring required

Share token returned from listShares or shareDatabase (begins with gs_).

Response

Share revoked

share_tokenstring required

Token passed to createDatabase (via share_token) to create a new database from the shared snapshot in another space. Also used to revoke the share via revokeShare. Always begins with gs_.

database_idstring required

ID of the source database.

database_namestring required

Name of the source database.

created_atstring date-time required

Time the share was created.

expires_atstring date-time

Time the share expires. Absent if the share does not expire.

revoked_atstring date-time

Time the share was revoked. Absent if the share is still active.

Changes

Changed in 5 of the 21 revisions of this API.221

  • 42816b90d8d61See the full diff
    • ●

      added the new signups_disabled enum value to the code response property for the response status default

      response-property-enum-value-added

  • d0e78bae6ce11See the full diff
    • ●

      added the new compute_limit_exceeded enum value to the code response property for the response status default

      response-property-enum-value-added

  • bdf92f48aec11See the full diff
    • ○

      added the optional property code to the response with the default status

      response-optional-property-added

  • 9a3d6f2f9f9f1See the full diff
    • ▲

      added the pattern ^gs_[A-Za-z0-9_-]+$ to the path request parameter share_token

      request-parameter-pattern-added

  • a7becb6668ec1See the full diff
    • ▲

      api path removed without deprecation

      api-path-removed-without-deprecation

    This revision also has 33 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog