Releasing version 2.5.1

Author: waruwaruwaru

CHANGELOG.md

@@ -3,6 +3,16 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](http://keepachangelog.com/).
 
+## 2.5.1 - 2021-10-12
+### Added
+- Support for the Data Labeling Service
+- Support for querying and setting Application Performance Monitoring configurations in the Application Performance Monitoring service
+- Support for the run-once monitor feature and network data collection in the Application Performance Monitoring service
+- Support for Oracle Enterprise Manager bridges, source auto-association, source event types mapping, and partitioning and searching data by LogSet in the Logging Analytics service
+- Support for Log events APIs used by plugins like fluentd, fluentbit, etc. to upload data in the Logging Analytics service
+- Support for a new ActionType: FAILED in work requests in the VMware Provisioning service
+- Support for calling Oracle Cloud Infrastructure services in the il-jerusalem-1 region
+
 ## 2.5.0 - 2021-10-05
 ### Added
 - Support for configuring Binlog variables in the MySQL Database service.

examples/javascript/data-labeling.js

@@ -0,0 +1,240 @@
+/**
+ * Copyright (c) 2021, 2022 Oracle and/or its affiliates.  All rights reserved.
+ * This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
+ */
+
+/**
+ *  @param args Arguments to provide to the example. The following arguments are expected:
+ * <ul>
+ *  <li>The first argument is the OCID of the compartment.</li>
+ *  <li>The second argument is the namespace.</li>
+ *  <li>The third argument is name of the bucket.</li>
+ *  <li>The fourth argument is object prefix.</li>
+ *  <li>The fifth argument is object name.</li>
+ * </ul>
+ */
+
+const common = require("oci-common");
+const cp = require("oci-datalabelingservice");
+const dp = require("oci-datalabelingservicedataplane");
+
+const args = process.argv.slice(2);
+console.log(args);
+if (args.length !== 5) {
+  console.error(
+    "Unexpected number of arguments received. Consult the script header comments for expected arguments"
+  );
+  process.exit(-1);
+}
+
+const compartmentId = args[0];
+const namespace = args[1];
+const bucket = args[2];
+const prefix = args[3];
+const objectName = args[4];
+let datasetId = "";
+
+const provider = new common.ConfigFileAuthenticationDetailsProvider();
+
+const dlsCPClient = new cp.DataLabelingManagementClient({
+  authenticationDetailsProvider: provider
+});
+
+const dlsDPClient = new dp.DataLabelingClient({
+  authenticationDetailsProvider: provider
+});
+
+async function listDataset() {
+  const datasetList = await dlsCPClient.listDatasets({
+    compartmentId
+  });
+  return datasetList.datasetCollection.items;
+}
+
+/**
+ * @description Polls and fetches workrequest details for a particular workrequestId.
+ */
+async function checkWorkRequestForSucceed(workRequestId) {
+  return new Promise(async (resolve, reject) => {
+    let timer = 0;
+    (async function refresh() {
+      clearTimeout(timer);
+      try {
+        const { workRequest } = await dlsCPClient
+          .getWorkRequest({
+            workRequestId
+          })
+          .catch(error => {
+            console.error(error);
+            throw new Error(`get Work request : ${error}`);
+          });
+        const { operationType, status, timeAccepted, percentComplete } = workRequest;
+        console.table([
+          {
+            workRequestId,
+            operationType,
+            status,
+            timeAccepted,
+            percentComplete
+          }
+        ]);
+        if (workRequest.status === "SUCCEEDED") {
+          resolve(workRequest.status);
+          return;
+        }
+        if (workRequest.status === "FAILED") {
+          console.error("workRequest failed", workRequest);
+          reject(workRequest.status);
+          return;
+        }
+      } catch (error) {
+        reject(error);
+        return;
+      }
+      timer = setTimeout(refresh, 3000);
+    })();
+  });
+}
+
+async function createDataset() {
+  return dlsCPClient.createDataset({
+    createDatasetDetails: {
+      compartmentId,
+      displayName: `typescript-sdk-example`,
+      datasetSourceDetails: {
+        sourceType: "OBJECT_STORAGE",
+        namespace,
+        bucket,
+        prefix
+      },
+      datasetFormatDetails: {
+        formatType: "IMAGE"
+      },
+      annotationFormat: "MULTI_LABEL",
+      labelSet: {
+        items: [
+          {
+            name: "label1"
+          },
+          {
+            name: "label2"
+          }
+        ]
+      },
+      definedTags: {},
+      freeformTags: {}
+    }
+  });
+}
+
+async function addLabels() {
+  return dlsCPClient.addDatasetLabels({
+    datasetId,
+    addDatasetLabelsDetails: {
+      labelSet: {
+        items: [{ name: "label3" }]
+      }
+    }
+  });
+}
+
+async function deleteDataset() {
+  return dlsCPClient.deleteDataset({
+    datasetId
+  });
+}
+
+async function getDataset() {
+  const { dataset } = await dlsDPClient.getDataset({ datasetId });
+  return dataset;
+}
+
+async function listRecords() {
+  const { recordCollection: { items = [] } = {} } = await dlsDPClient.listRecords({
+    compartmentId,
+    datasetId
+  });
+  return items;
+}
+
+async function getRecord(recordId) {
+  const { record } = await dlsDPClient.getRecord({
+    recordId
+  });
+  return record;
+}
+
+async function createRecord() {
+  const { datasetSourceDetails: { sourceType = "" } = {} } = await getDataset();
+  return dlsDPClient.createRecord({
+    createRecordDetails: {
+      compartmentId,
+      datasetId,
+      name: objectName,
+      sourceDetails: {
+        relativePath: objectName,
+        sourceType
+      }
+    }
+  });
+}
+
+const getEntities = ({ label }) => {
+  return [
+    {
+      labels: [
+        {
+          label
+        }
+      ],
+      entityType: "GENERIC"
+    }
+  ];
+};
+
+async function createAnnotation(recordId) {
+  const {
+    labelSet: { items = [] }
+  } = await getDataset();
+  const label = items[0].name || "";
+  return dlsDPClient.createAnnotation({
+    createAnnotationDetails: {
+      compartmentId,
+      recordId,
+      entities: getEntities({ label })
+    }
+  });
+}
+
+async function listAnnotation(id) {
+  return dlsDPClient.listAnnotations({
+    compartmentId,
+    datasetId,
+    id
+  });
+}
+
+(async () => {
+  try {
+    await listDataset();
+    let { dataset, opcWorkRequestId } = await createDataset();
+    datasetId = dataset.id;
+    console.log("Dataset Created");
+    await checkWorkRequestForSucceed(opcWorkRequestId);
+    ({ opcWorkRequestId } = await addLabels());
+    await checkWorkRequestForSucceed(opcWorkRequestId);
+    console.log("Labels Added");
+    const { record } = await createRecord();
+    console.log("Record created");
+    await getRecord(record.id);
+    const { annotation } = await createAnnotation(record.id);
+    console.log("Annotation created");
+    await listRecords();
+    await listAnnotation(annotation.id);
+  } catch (error) {
+    console.log("Error executing example" + error);
+  } finally {
+    await deleteDataset();
+  }
+  console.debug("DONE");
+})();