移動

• リクエスト
• レスポンス
• 例

スクリプト所有者が指定されたグループ化データに対するPython関数の実行

post

/py-scripts/v2/group-apply/{scriptName}/{ownerName}

スクリプト所有者が指定されたPython関数を、列値でグループ化されたデータに対して実行します。

リクエスト

パス・パラメータ

• ownerName(必須): string
  Pythonスクリプトの所有者
• scriptName(必須): string
  Pythonスクリプトの名前

サポートされているメディア・タイプ

• application/json

リクエスト本文 - application/json ()

ルート・スキーマ: schema

型: object

ソースの表示

• asyncFlag: boolean
  ジョブを非同期で実行するかどうか。
• envName: string
  conda環境の名前。
• graphicsFlag: boolean
  スクリプトでレンダリングされたイメージを結果に取得するかどうか。
• groupBy(必須): string
  グループ化する列。列のリストを設定するには、カンマ区切りリストを指定します。
• input(必須): string
  入力データを指定する問合せ文。
• orderBy: string
  順序付けする列。列のリストを設定するには、カンマ区切りリストを指定します。
• parallel: integer (int32)
  並列度。
• parallelFlag: boolean
  ジョブを並列で実行するかどうか。
• parameters: string
  スクリプトに渡されるキーワード引数を指定する(名前 - 値)ペアのJSON文字列。
• service: string
  指定可能な値: [ "LOW, MEDIUM, HIGH, TP, TPURGENT" ]

  サービスのLEVEL。デフォルトはLOWです。
• timeout: integer (int32)
  最小値: 1800

  最大値: 43200

  非同期ジョブのタイムアウト制限(秒単位、デフォルトは1800秒)。`asyncFlag`=trueとともに使用する必要があります。

{
    "required":[
        "groupBy",
        "input"
    ],
    "type":"object",
    "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, TP, TPURGENT"
            ]
        },
        "envName":{
            "type":"string",
            "description":"Name of the conda environment."
        },
        "input":{
            "type":"string",
            "description":"Query statement specifying input data."
        },
        "groupBy":{
            "type":"string",
            "description":"Columns to group by. To set a list of columns, provide a comma-separated list."
        },
        "orderBy":{
            "type":"string",
            "description":"Columns to order by. To set a list of columns, provide a comma-separated list."
        },
        "parallelFlag":{
            "type":"boolean",
            "description":"Whether to execute job in parallelism."
        },
        "parallel":{
            "type":"integer",
            "description":"Degree of parallel.",
            "format":"int32"
        }
    }
}

先頭に戻る

レスポンス

サポートされているメディア・タイプ

• application/json

200レスポンス

デフォルトでは、ジョブの結果を返します。

本文()

ルート・スキーマ: JSONObject

型: object

ソースの表示

• empty: boolean

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

201レスポンス

asyncFlag=trueの場合、ジョブのステータスをフェッチできるロケーション・ヘッダーを返します。

ヘッダー

• Location:

400レスポンス

無効なパラメータが指定され、出力がサイズ制限を超えているか、他のスクリプト実行エラーが発生しました。

本文()

ルート・スキーマ: InvalidParameterValueException

型: object

ソースの表示

• errorCode(必須): 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レスポンス

ブローカへの接続中、ジョブの実行中に問題が発生したか、または他の予期しないエラーが発生しました。

本文()

ルート・スキーマ: ComputeContainerException

型: object

ソースの表示

• errorCode(必須): integer (int64)
• errorMessage: string

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

先頭に戻る

例

次の例では、group_countというスクリプトを実行し、スクリプト所有者を指定します。

curl -i -X POST --header "Authorization: Bearer ${token}" \
--header 'Content-Type: application/json' --header 'Accept: application/json' \
-d '{"input":"select * from IRIS", "parameters":"{\"oml_input_type\":\"pandas.DataFrame\"}", "groupBy":"Species", "orderBy":"Sepal_Length"}' \
"<oml-cloud-service-location-url>/oml/api/py-scripts/v2/group-apply/group_count/<owner_name>"

レスポンス・ヘッダー

レスポンス・ヘッダーは次のとおりです。

HTTP/1.1 200 OK
Date: Mon, 17 Aug 2020 21:06:54 GMT
Content-Type: application/json
Content-Length: 5045
Connection: keep-alive
Cache-Control: no-cache, no-store, private
X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1;mode=block
Strict-Transport-Security: max-age=31536000; includeSubDomains
X-Content-Type-Options: nosniff
Set-Cookie: JSESSIONID=node0bucgs4gt7hci1gxvgtqc1hjdv647.node0; Path=/oml; Secure; HttpOnly
Expires: Thu, 01 Jan 1970 00:00:00 GMT

レスポンス本文

JSON形式のレスポンス本文の一部を次に示します。

{"result":{"versicolor_8":{"SEPAL_LENGTH":{"0":5.7},"SPECIES":{"0":"versicolor"},"COUNT":{"0":5}},
"versicolor_7":{"SEPAL_LENGTH":{"0":5.6},"SPECIES":{"0":"versicolor"},"COUNT":{"0":2}},...}

先頭に戻る