DELETEDATASET()`¶

About DeleteDataset¶

Deletes a dataset version or an entire dataset (all versions + name claim). Asynchronous 202.

State transitions: - If datasetVersion is absent (full delete): status transitions to DELETING immediately. - If datasetVersion is provided (version-specific delete): status transitions to UPDATING.

State guard (full delete): Returns ConflictException (DATASET_NOT_READY) if the dataset status is in {CREATING, UPDATING}. Deletion is allowed from ACTIVE, CREATE_FAILED, UPDATE_FAILED, and DELETE_FAILED states.

State guard (version-specific delete): Returns ConflictException (DATASET_NOT_READY) if the dataset status is not in {ACTIVE, CREATE_FAILED, UPDATE_FAILED}.

Fails with ConflictException (REFERENCED_BY_EVAL_JOB) if referenced by an active evaluation job (full delete only).

If the delete workflow fails after retries, status is set to DELETE_FAILED (full delete) or UPDATE_FAILED (version-specific delete). Calling DeleteDataset on a DELETE_FAILED dataset re-triggers the delete workflow (idempotent retry path).

Version parameter: - If datasetVersion is absent: deletes ALL versions and the Dataset record itself. - If datasetVersion is provided: deletes only that specific DatasetVersion. Returns ResourceNotFoundException if the specified version does not exist.

Method Signature¶

METHODS /AWS1/IF_BDO~DELETEDATASET
  IMPORTING
    !IV_DATASETID TYPE /AWS1/BDODATASETID OPTIONAL
    !IV_DATASETVERSION TYPE /AWS1/BDODATASETVERSION OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_bdodeletedatasetrsp
  RAISING
    /AWS1/CX_BDOACCESSDENIEDEX
    /AWS1/CX_BDOCONFLICTEXCEPTION
    /AWS1/CX_BDOINTERNALSERVEREX
    /AWS1/CX_BDORESOURCENOTFOUNDEX
    /AWS1/CX_BDOTHROTTLINGEX
    /AWS1/CX_BDOVALIDATIONEX
    /AWS1/CX_BDOCLIENTEXC
    /AWS1/CX_BDOSERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING¶

Required arguments:¶

`iv_datasetid` `TYPE /AWS1/BDODATASETID` `/AWS1/BDODATASETID`¶

The unique identifier of the dataset to delete.

Optional arguments:¶

`iv_datasetversion` `TYPE /AWS1/BDODATASETVERSION` `/AWS1/BDODATASETVERSION`¶

Optional version to delete. Use "DRAFT" or omit to delete the draft. Returns ResourceNotFoundException if the specified version does not exist.

RETURNING¶

`oo_output` `TYPE REF TO /aws1/cl_bdodeletedatasetrsp` `/AWS1/CL_BDODELETEDATASETRSP`¶

Examples¶

Syntax Example¶

This is an example of the syntax for calling the method. It includes every possible argument and initializes every possible value. The data provided is not necessarily semantically accurate (for example the value "string" may be provided for something that is intended to be an instance ID, or in some cases two arguments may be mutually exclusive). The syntax shows the ABAP syntax for creating the various data structures.

DATA(lo_result) = lo_client->deletedataset(
  iv_datasetid = |string|
  iv_datasetversion = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lv_datasetarn = lo_result->get_datasetarn( ).
  lv_datasetid = lo_result->get_datasetid( ).
  lv_datasetstatus = lo_result->get_status( ).
  lv_datasetversion = lo_result->get_datasetversion( ).
  lv_timestamp = lo_result->get_updatedat( ).
ENDIF.

/AWS1/IF_BDO=>DELETEDATASET()¶