Interface DataLabelingManagement
-
- All Superinterfaces:
AutoCloseable
- All Known Implementing Classes:
DataLabelingManagementClient
@Generated(value="OracleSDKGenerator", comments="API Version: 20211001") public interface DataLabelingManagement extends AutoCloseable
Use Data Labeling Management API to create, list, edit & delete datasets.This service client uses CircuitBreakerUtils.DEFAULT_CIRCUIT_BREAKER for all the operations by default if no circuit breaker configuration is defined by the user.
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description AddDatasetLabelsResponse
addDatasetLabels(AddDatasetLabelsRequest request)
Add Labels to the Dataset LabelSet until the maximum number of Labels has been reached.ChangeDatasetCompartmentResponse
changeDatasetCompartment(ChangeDatasetCompartmentRequest request)
Moves a Dataset resource from one compartment identifier to another.CreateDatasetResponse
createDataset(CreateDatasetRequest request)
Creates a new Dataset.DeleteDatasetResponse
deleteDataset(DeleteDatasetRequest request)
Deletes a Dataset resource by identifierGenerateDatasetRecordsResponse
generateDatasetRecords(GenerateDatasetRecordsRequest request)
Generates Record resources from the Dataset’s data sourceGetDatasetResponse
getDataset(GetDatasetRequest request)
Gets a Dataset by identifierString
getEndpoint()
Gets the set endpoint for REST call (ex, https://www.example.com)DataLabelingManagementPaginators
getPaginators()
Gets the pre-configured paginators available for list operations in this service which may return multiple pages of data.DataLabelingManagementWaiters
getWaiters()
Gets the pre-configured waiters available for resources for this service.GetWorkRequestResponse
getWorkRequest(GetWorkRequestRequest request)
Gets the status of the work request with the given ID.ImportPreAnnotatedDataResponse
importPreAnnotatedData(ImportPreAnnotatedDataRequest request)
Imports records and annotations from dataset files into existing Dataset.ListAnnotationFormatsResponse
listAnnotationFormats(ListAnnotationFormatsRequest request)
These are a static list in a given region.ListDatasetsResponse
listDatasets(ListDatasetsRequest request)
Returns a list of Datasets.ListWorkRequestErrorsResponse
listWorkRequestErrors(ListWorkRequestErrorsRequest request)
Return a (paginated) list of errors for a given work request.ListWorkRequestLogsResponse
listWorkRequestLogs(ListWorkRequestLogsRequest request)
Return a (paginated) list of logs for a given work request.ListWorkRequestsResponse
listWorkRequests(ListWorkRequestsRequest request)
Lists the work requests in a compartment.void
refreshClient()
Rebuilds the client from scratch.RemoveDatasetLabelsResponse
removeDatasetLabels(RemoveDatasetLabelsRequest request)
Removes the labels from the Dataset Labelset.RenameDatasetLabelsResponse
renameDatasetLabels(RenameDatasetLabelsRequest request)
Renames the labels from the Dataset Labelset.void
setEndpoint(String endpoint)
Sets the endpoint to call (ex, https://www.example.com).void
setRegion(Region region)
Sets the region to call (ex, Region.US_PHOENIX_1).void
setRegion(String regionId)
Sets the region to call (ex, ‘us-phoenix-1’).SnapshotDatasetResponse
snapshotDataset(SnapshotDatasetRequest request)
Writes the dataset records and annotations in a consolidated format out to an object storage reference for consumption.UpdateDatasetResponse
updateDataset(UpdateDatasetRequest request)
Updates the Datasetvoid
useRealmSpecificEndpointTemplate(boolean realmSpecificEndpointTemplateEnabled)
Determines whether realm specific endpoint should be used or not.-
Methods inherited from interface java.lang.AutoCloseable
close
-
-
-
-
Method Detail
-
refreshClient
void refreshClient()
Rebuilds the client from scratch.Useful to refresh certificates.
-
setEndpoint
void setEndpoint(String endpoint)
Sets the endpoint to call (ex, https://www.example.com).- Parameters:
endpoint
- The endpoint of the service.
-
getEndpoint
String getEndpoint()
Gets the set endpoint for REST call (ex, https://www.example.com)
-
setRegion
void setRegion(Region region)
Sets the region to call (ex, Region.US_PHOENIX_1).Note, this will call
setEndpoint
after resolving the endpoint. If the service is not available in this Region, however, an IllegalArgumentException will be raised.- Parameters:
region
- The region of the service.
-
setRegion
void setRegion(String regionId)
Sets the region to call (ex, ‘us-phoenix-1’).Note, this will first try to map the region ID to a known Region and call
setRegion
.If no known Region could be determined, it will create an endpoint based on the default endpoint format (
Region.formatDefaultRegionEndpoint(Service, String)
and then callsetEndpoint
.- Parameters:
regionId
- The public region ID.
-
useRealmSpecificEndpointTemplate
void useRealmSpecificEndpointTemplate(boolean realmSpecificEndpointTemplateEnabled)
Determines whether realm specific endpoint should be used or not.Set realmSpecificEndpointTemplateEnabled to “true” if the user wants to enable use of realm specific endpoint template, otherwise set it to “false”
- Parameters:
realmSpecificEndpointTemplateEnabled
- flag to enable the use of realm specific endpoint template
-
addDatasetLabels
AddDatasetLabelsResponse addDatasetLabels(AddDatasetLabelsRequest request)
Add Labels to the Dataset LabelSet until the maximum number of Labels has been reached.- Parameters:
request
- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
- Throws:
BmcException
- when an error occurs. This operation uses RetryConfiguration.SDK_DEFAULT_RETRY_CONFIGURATION as default if no retry strategy is provided. The specifics of the default retry strategy are described here https://docs.oracle.com/en-us/iaas/Content/API/SDKDocs/javasdkconcepts.htm#javasdkconcepts_topic_RetriesExample: Click <a href=“https://docs.oracle.com/en-us/iaas/tools/java-sdk-examples/3.63.0/datalabelingservice/AddDatasetLabelsExample.java.html"target=”_blank"rel=“noopener noreferrer”>here to see how to use AddDatasetLabels API.
-
changeDatasetCompartment
ChangeDatasetCompartmentResponse changeDatasetCompartment(ChangeDatasetCompartmentRequest request)
Moves a Dataset resource from one compartment identifier to another.When provided, If-Match is checked against ETag values of the resource.
- Parameters:
request
- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
- Throws:
BmcException
- when an error occurs. This operation uses RetryConfiguration.SDK_DEFAULT_RETRY_CONFIGURATION as default if no retry strategy is provided. The specifics of the default retry strategy are described here https://docs.oracle.com/en-us/iaas/Content/API/SDKDocs/javasdkconcepts.htm#javasdkconcepts_topic_RetriesExample: Click <a href=“https://docs.oracle.com/en-us/iaas/tools/java-sdk-examples/3.63.0/datalabelingservice/ChangeDatasetCompartmentExample.java.html"target=”_blank"rel=“noopener noreferrer”>here to see how to use ChangeDatasetCompartment API.
-
createDataset
CreateDatasetResponse createDataset(CreateDatasetRequest request)
Creates a new Dataset.- Parameters:
request
- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
- Throws:
BmcException
- when an error occurs. This operation uses RetryConfiguration.SDK_DEFAULT_RETRY_CONFIGURATION as default if no retry strategy is provided. The specifics of the default retry strategy are described here https://docs.oracle.com/en-us/iaas/Content/API/SDKDocs/javasdkconcepts.htm#javasdkconcepts_topic_RetriesExample: Click <a href=“https://docs.oracle.com/en-us/iaas/tools/java-sdk-examples/3.63.0/datalabelingservice/CreateDatasetExample.java.html"target=”_blank"rel=“noopener noreferrer”>here to see how to use CreateDataset API.
-
deleteDataset
DeleteDatasetResponse deleteDataset(DeleteDatasetRequest request)
Deletes a Dataset resource by identifier- Parameters:
request
- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
- Throws:
BmcException
- when an error occurs. This operation uses RetryConfiguration.SDK_DEFAULT_RETRY_CONFIGURATION as default if no retry strategy is provided. The specifics of the default retry strategy are described here https://docs.oracle.com/en-us/iaas/Content/API/SDKDocs/javasdkconcepts.htm#javasdkconcepts_topic_RetriesExample: Click <a href=“https://docs.oracle.com/en-us/iaas/tools/java-sdk-examples/3.63.0/datalabelingservice/DeleteDatasetExample.java.html"target=”_blank"rel=“noopener noreferrer”>here to see how to use DeleteDataset API.
-
generateDatasetRecords
GenerateDatasetRecordsResponse generateDatasetRecords(GenerateDatasetRecordsRequest request)
Generates Record resources from the Dataset’s data source- Parameters:
request
- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
- Throws:
BmcException
- when an error occurs. This operation uses RetryConfiguration.SDK_DEFAULT_RETRY_CONFIGURATION as default if no retry strategy is provided. The specifics of the default retry strategy are described here https://docs.oracle.com/en-us/iaas/Content/API/SDKDocs/javasdkconcepts.htm#javasdkconcepts_topic_RetriesExample: Click <a href=“https://docs.oracle.com/en-us/iaas/tools/java-sdk-examples/3.63.0/datalabelingservice/GenerateDatasetRecordsExample.java.html"target=”_blank"rel=“noopener noreferrer”>here to see how to use GenerateDatasetRecords API.
-
getDataset
GetDatasetResponse getDataset(GetDatasetRequest request)
Gets a Dataset by identifier- Parameters:
request
- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
- Throws:
BmcException
- when an error occurs. This operation uses RetryConfiguration.SDK_DEFAULT_RETRY_CONFIGURATION as default if no retry strategy is provided. The specifics of the default retry strategy are described here https://docs.oracle.com/en-us/iaas/Content/API/SDKDocs/javasdkconcepts.htm#javasdkconcepts_topic_RetriesExample: Click <a href=“https://docs.oracle.com/en-us/iaas/tools/java-sdk-examples/3.63.0/datalabelingservice/GetDatasetExample.java.html"target=”_blank"rel=“noopener noreferrer”>here to see how to use GetDataset API.
-
getWorkRequest
GetWorkRequestResponse getWorkRequest(GetWorkRequestRequest request)
Gets the status of the work request with the given ID.- Parameters:
request
- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
- Throws:
BmcException
- when an error occurs. This operation uses RetryConfiguration.SDK_DEFAULT_RETRY_CONFIGURATION as default if no retry strategy is provided. The specifics of the default retry strategy are described here https://docs.oracle.com/en-us/iaas/Content/API/SDKDocs/javasdkconcepts.htm#javasdkconcepts_topic_RetriesExample: Click <a href=“https://docs.oracle.com/en-us/iaas/tools/java-sdk-examples/3.63.0/datalabelingservice/GetWorkRequestExample.java.html"target=”_blank"rel=“noopener noreferrer”>here to see how to use GetWorkRequest API.
-
importPreAnnotatedData
ImportPreAnnotatedDataResponse importPreAnnotatedData(ImportPreAnnotatedDataRequest request)
Imports records and annotations from dataset files into existing Dataset.- Parameters:
request
- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
- Throws:
BmcException
- when an error occurs. This operation uses RetryConfiguration.SDK_DEFAULT_RETRY_CONFIGURATION as default if no retry strategy is provided. The specifics of the default retry strategy are described here https://docs.oracle.com/en-us/iaas/Content/API/SDKDocs/javasdkconcepts.htm#javasdkconcepts_topic_RetriesExample: Click <a href=“https://docs.oracle.com/en-us/iaas/tools/java-sdk-examples/3.63.0/datalabelingservice/ImportPreAnnotatedDataExample.java.html"target=”_blank"rel=“noopener noreferrer”>here to see how to use ImportPreAnnotatedData API.
-
listAnnotationFormats
ListAnnotationFormatsResponse listAnnotationFormats(ListAnnotationFormatsRequest request)
These are a static list in a given region.- Parameters:
request
- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
- Throws:
BmcException
- when an error occurs. This operation uses RetryConfiguration.SDK_DEFAULT_RETRY_CONFIGURATION as default if no retry strategy is provided. The specifics of the default retry strategy are described here https://docs.oracle.com/en-us/iaas/Content/API/SDKDocs/javasdkconcepts.htm#javasdkconcepts_topic_RetriesExample: Click <a href=“https://docs.oracle.com/en-us/iaas/tools/java-sdk-examples/3.63.0/datalabelingservice/ListAnnotationFormatsExample.java.html"target=”_blank"rel=“noopener noreferrer”>here to see how to use ListAnnotationFormats API.
-
listDatasets
ListDatasetsResponse listDatasets(ListDatasetsRequest request)
Returns a list of Datasets.- Parameters:
request
- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
- Throws:
BmcException
- when an error occurs. This operation uses RetryConfiguration.SDK_DEFAULT_RETRY_CONFIGURATION as default if no retry strategy is provided. The specifics of the default retry strategy are described here https://docs.oracle.com/en-us/iaas/Content/API/SDKDocs/javasdkconcepts.htm#javasdkconcepts_topic_RetriesExample: Click <a href=“https://docs.oracle.com/en-us/iaas/tools/java-sdk-examples/3.63.0/datalabelingservice/ListDatasetsExample.java.html"target=”_blank"rel=“noopener noreferrer”>here to see how to use ListDatasets API.
-
listWorkRequestErrors
ListWorkRequestErrorsResponse listWorkRequestErrors(ListWorkRequestErrorsRequest request)
Return a (paginated) list of errors for a given work request.- Parameters:
request
- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
- Throws:
BmcException
- when an error occurs. This operation uses RetryConfiguration.SDK_DEFAULT_RETRY_CONFIGURATION as default if no retry strategy is provided. The specifics of the default retry strategy are described here https://docs.oracle.com/en-us/iaas/Content/API/SDKDocs/javasdkconcepts.htm#javasdkconcepts_topic_RetriesExample: Click <a href=“https://docs.oracle.com/en-us/iaas/tools/java-sdk-examples/3.63.0/datalabelingservice/ListWorkRequestErrorsExample.java.html"target=”_blank"rel=“noopener noreferrer”>here to see how to use ListWorkRequestErrors API.
-
listWorkRequestLogs
ListWorkRequestLogsResponse listWorkRequestLogs(ListWorkRequestLogsRequest request)
Return a (paginated) list of logs for a given work request.- Parameters:
request
- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
- Throws:
BmcException
- when an error occurs. This operation uses RetryConfiguration.SDK_DEFAULT_RETRY_CONFIGURATION as default if no retry strategy is provided. The specifics of the default retry strategy are described here https://docs.oracle.com/en-us/iaas/Content/API/SDKDocs/javasdkconcepts.htm#javasdkconcepts_topic_RetriesExample: Click <a href=“https://docs.oracle.com/en-us/iaas/tools/java-sdk-examples/3.63.0/datalabelingservice/ListWorkRequestLogsExample.java.html"target=”_blank"rel=“noopener noreferrer”>here to see how to use ListWorkRequestLogs API.
-
listWorkRequests
ListWorkRequestsResponse listWorkRequests(ListWorkRequestsRequest request)
Lists the work requests in a compartment.- Parameters:
request
- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
- Throws:
BmcException
- when an error occurs. This operation uses RetryConfiguration.SDK_DEFAULT_RETRY_CONFIGURATION as default if no retry strategy is provided. The specifics of the default retry strategy are described here https://docs.oracle.com/en-us/iaas/Content/API/SDKDocs/javasdkconcepts.htm#javasdkconcepts_topic_RetriesExample: Click <a href=“https://docs.oracle.com/en-us/iaas/tools/java-sdk-examples/3.63.0/datalabelingservice/ListWorkRequestsExample.java.html"target=”_blank"rel=“noopener noreferrer”>here to see how to use ListWorkRequests API.
-
removeDatasetLabels
RemoveDatasetLabelsResponse removeDatasetLabels(RemoveDatasetLabelsRequest request)
Removes the labels from the Dataset Labelset.Labels can only be removed if there are no Annotations associated with the Dataset that reference the Label names.
- Parameters:
request
- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
- Throws:
BmcException
- when an error occurs. This operation uses RetryConfiguration.SDK_DEFAULT_RETRY_CONFIGURATION as default if no retry strategy is provided. The specifics of the default retry strategy are described here https://docs.oracle.com/en-us/iaas/Content/API/SDKDocs/javasdkconcepts.htm#javasdkconcepts_topic_RetriesExample: Click <a href=“https://docs.oracle.com/en-us/iaas/tools/java-sdk-examples/3.63.0/datalabelingservice/RemoveDatasetLabelsExample.java.html"target=”_blank"rel=“noopener noreferrer”>here to see how to use RemoveDatasetLabels API.
-
renameDatasetLabels
RenameDatasetLabelsResponse renameDatasetLabels(RenameDatasetLabelsRequest request)
Renames the labels from the Dataset Labelset.Labels that are renamed will be reflected in Annotations associated with the Dataset that reference the Label names.
- Parameters:
request
- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
- Throws:
BmcException
- when an error occurs. This operation uses RetryConfiguration.SDK_DEFAULT_RETRY_CONFIGURATION as default if no retry strategy is provided. The specifics of the default retry strategy are described here https://docs.oracle.com/en-us/iaas/Content/API/SDKDocs/javasdkconcepts.htm#javasdkconcepts_topic_RetriesExample: Click <a href=“https://docs.oracle.com/en-us/iaas/tools/java-sdk-examples/3.63.0/datalabelingservice/RenameDatasetLabelsExample.java.html"target=”_blank"rel=“noopener noreferrer”>here to see how to use RenameDatasetLabels API.
-
snapshotDataset
SnapshotDatasetResponse snapshotDataset(SnapshotDatasetRequest request)
Writes the dataset records and annotations in a consolidated format out to an object storage reference for consumption.While the snapshot takes place, there may be a time while records and annotations cannot be created to ensure the snapshot is a point in time.
- Parameters:
request
- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
- Throws:
BmcException
- when an error occurs. This operation uses RetryConfiguration.SDK_DEFAULT_RETRY_CONFIGURATION as default if no retry strategy is provided. The specifics of the default retry strategy are described here https://docs.oracle.com/en-us/iaas/Content/API/SDKDocs/javasdkconcepts.htm#javasdkconcepts_topic_RetriesExample: Click <a href=“https://docs.oracle.com/en-us/iaas/tools/java-sdk-examples/3.63.0/datalabelingservice/SnapshotDatasetExample.java.html"target=”_blank"rel=“noopener noreferrer”>here to see how to use SnapshotDataset API.
-
updateDataset
UpdateDatasetResponse updateDataset(UpdateDatasetRequest request)
Updates the Dataset- Parameters:
request
- The request object containing the details to send- Returns:
- A response object containing details about the completed operation
- Throws:
BmcException
- when an error occurs. This operation uses RetryConfiguration.SDK_DEFAULT_RETRY_CONFIGURATION as default if no retry strategy is provided. The specifics of the default retry strategy are described here https://docs.oracle.com/en-us/iaas/Content/API/SDKDocs/javasdkconcepts.htm#javasdkconcepts_topic_RetriesExample: Click <a href=“https://docs.oracle.com/en-us/iaas/tools/java-sdk-examples/3.63.0/datalabelingservice/UpdateDatasetExample.java.html"target=”_blank"rel=“noopener noreferrer”>here to see how to use UpdateDataset API.
-
getWaiters
DataLabelingManagementWaiters getWaiters()
Gets the pre-configured waiters available for resources for this service.- Returns:
- The service waiters.
-
getPaginators
DataLabelingManagementPaginators getPaginators()
Gets the pre-configured paginators available for list operations in this service which may return multiple pages of data.These paginators provide an
Iterable
interface so that service responses, or resources/records, can be iterated through without having to manually deal with pagination and page tokens.- Returns:
- The service paginators.
-
-