Jump to

• Request
• Response
• Examples

Run an R Function on Specified Data with Script Owner Specified

post

/api/r-scripts/v1/table-apply/{scriptName}/{ownerName}

Runs an R function on the specified data with script owner specified.

Request

Supported Media Types

• application/json

Path Parameters

• ownerName(required): string
  The owner of the R script
• scriptName(required): string
  The name of the R script

Body ()

A JSON str of (name - value) pairs specifying arguments of the request and additional arguments to the script

Root Schema : EmbedScriptComputeTab

Type: object

Show Source

• asyncFlag: boolean
  Whether to execute the job asynchronously.
• envName: string
  Name of the conda environment.
• graphicsFlag: boolean
  Whether to capture images rendered in the script to the result.
• input(required): string
  Query statement specifying input data.
• parameters: string
  A JSON str of (name - value) pairs specifying keyword arguments to be passed into the script.
• service: string
  Allowed Values: [ "LOW", "MEDIUM", "HIGH" ]

  LEVEL of the service. Default is LOW.
• timeout: integer(int32)
  Minimum Value: 1800

  Maximum Value: 43200

  The timeout limit (in seconds, default 1800s) of asynchronous job. Must be used together with `asyncFlag`=true.

{
    "type":"object",
    "required":[
        "input"
    ],
    "properties":{
        "parameters":{
            "type":"string",
            "description":"A JSON str of (name - value) pairs specifying keyword arguments to be passed into the script."
        },
        "graphicsFlag":{
            "type":"boolean",
            "description":"Whether to capture images rendered in the script to the result."
        },
        "asyncFlag":{
            "type":"boolean",
            "description":"Whether to execute the job asynchronously."
        },
        "timeout":{
            "type":"integer",
            "format":"int32",
            "description":"The timeout limit (in seconds, default 1800s) of asynchronous job. Must be used together with `asyncFlag`=true.",
            "minimum":"1800",
            "maximum":"43200"
        },
        "service":{
            "type":"string",
            "description":"LEVEL of the service. Default is LOW.",
            "enum":[
                "LOW",
                "MEDIUM",
                "HIGH"
            ]
        },
        "envName":{
            "type":"string",
            "description":"Name of the conda environment."
        },
        "input":{
            "type":"string",
            "description":"Query statement specifying input data."
        }
    }
}

Example Request (application/json)

{"input":"SWIM", "asyncFlag":true, "timeout":7200}

Back to Top

Response

Supported Media Types

• application/json

200 Response

By default, returns the job result.

Body ()

Root Schema : JSONObject

Type: object

Show Source

• empty: boolean

{
    "type":"object",
    "properties":{
        "empty":{
            "type":"boolean"
        }
    }
}

201 Response

If asyncFlag=True, returns the location header where the status of the job can be fetched.

Headers

• Location: string(uri)

400 Response

Invalid parameters specified, output exceeding size limit or other script execution error.

Body ()

Root Schema : InvalidParameterValueException

Type: object

Show Source

• errorCode(required): integer(int64)
• errorMessage: string
• parameterName: string
• parameterValue: string

{
    "type":"object",
    "required":[
        "debug",
        "errorCode"
    ],
    "properties":{
        "errorMessage":{
            "type":"string"
        },
        "errorCode":{
            "type":"integer",
            "format":"int64"
        },
        "parameterName":{
            "type":"string"
        },
        "parameterValue":{
            "type":"string"
        }
    }
}

500 Response

Problem connecting to Broker, executing job or other unexpected error.

Body ()

Root Schema : ComputeContainerException

Type: object

Show Source

• errorCode(required): integer(int64)
• errorMessage: string

{
    "type":"object",
    "required":[
        "debug",
        "errorCode"
    ],
    "properties":{
        "errorMessage":{
            "type":"string"
        },
        "errorCode":{
            "type":"integer",
            "format":"int64"
        }
    }
}

Back to Top

Examples

The following example runs the script named my.predict and specifies the script owner.

curl -i -X POST --header "Authorization: Bearer ${token}" \
--header 'Content-Type: application/json' --header 'Accept: application/json' \
-d '{"input":"IRIS"}' \
"<oml-cloud-service-location-url>}/oml/api/r-scripts/v1/table-apply/my.predict/<owner_name>"

Response Headers

The response headers are the following:

HTTP/1.1 200 OK
Date: Thu, 28 Jul 2022 21:04:18 GMT
Content-Type: application/json
Content-Length: 1820
Connection: keep-alive
Cache-Control: no-cache, no-store, must-revalidate
Pragma: no-cache
X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1;mode=block
Strict-Transport-Security: max-age=31536000; includeSubDomains
X-Content-Type-Options: nosniff
Content-Security-Policy: frame-ancestors 'none'

Response Body

The a portion of the response body in JSON format is the following:

{"result":[{"PRED":4.7227,"Sepal.Length":4.6},{"PRED":4.5396,"Sepal.Length":4.3},{"PRED":4.6902,"Sepal.Length":5},{"PRED":5.0869,"Sepal.Length":5.8},{"PRED":4.6739,"Sepal.Length":4.4},{"PRED":4.7731,"Sepal.Length":4.4},...

Back to Top