MENU
      submit

        submit


        기사 요약

        VPC 환경에서 이용 가능합니다.

        AI 앱을 실행합니다.

        요청

        요청 파라미터

        파라미터명필수 여부타입제약 사항설명
        aiWorkspaceIdYESString최대 22자까지 입력- AI 워크스페이스 식별자 UUID(base62)
        - aiWorkspaceId는 AI Workspaces의 getList API를 통해서 획득 가능
        namePrefixYESString최소 2자에서 최대 8자까지 입력AI 앱 이름 설정 시 필요한 접두사
        queueNameYESString- YARN 큐 이름
        - 기본값: gpu
        dataYESAiAppDataAiAppData 데이터 타입
        dockerYESAiAppDockerAiAppDocker 데이터 타입
        resourceYESAiAppResourceAiAppResource 데이터 타입

        요청 헤더

        공통 가이드 참조

        요청 바디

        • JSON
          {
              "aiWorkspaceId": "string",
              "data": {
                  "input": [
                  {
                      "hdfs": "string",
                      "path": "string"
                  }
                  ],
                  "output": [
                  {
                      "hdfs": "string",
                      "overwrite": true,
                      "path": "string"
                  }
                  ]
              },
              "docker": {
                  "args": "string",
                  "command": "string",
                  "env": {
                  "additionalProp1": "string",
                  "additionalProp2": "string",
                  "additionalProp3": "string"
                  },
                  "exposeTcpPorts": [
                  0
                  ],
                  "image": "string",
                  "workdir": "string"
              },
              "namePrefix": "string",
              "queueName": "gpu",
              "resource": {
                  "cpuCount": 0,
                  "gpuCount": 0,
                  "gpuModel": "T4",
                  "memoryMb": 0
              }
          }
          JSON
        • XML
          <?xml version="1.0" encoding="UTF-8"?>
          <SubmitAiAppRequest>
              <aiWorkspaceId>string</aiWorkspaceId>
              <data>
                  <input>
                      <hdfs>string</hdfs>
                      <path>string</path>
                  </input>
                  <output>
                      <hdfs>string</hdfs>
                      <overwrite>true</overwrite>
                      <path>string</path>
                  </output>
              </data>
              <docker>
                  <args>string</args>
                  <command>string</command>
                  <env>
                      <additionalProp>string</additionalProp>
                  </env>
                  <exposeTcpPorts>0</exposeTcpPorts>
                  <image>string</image>
                  <workdir>string</workdir>
              </docker>
              <namePrefix>string</namePrefix>
              <queueName>gpu</queueName>
              <resource>
                  <cpuCount>0</cpuCount>
                  <gpuCount>0</gpuCount>
                  <gpuModel>T4</gpuModel>
                  <memoryMb>0</memoryMb>
              </resource>
          </SubmitAiAppRequest>
          XML

        응답

        응답 바디

        SubmitAiAppResponse

        • JSON
          {
              "accountName": "string",
              "elapsedMillis": 0,
              "finalStatus": "string",
              "finishedAt": "2023-05-17T01:14:15.647Z",
              "id": "string",
              "message": "string",
              "name": "string",
              "queueName": "gpu",
              "startedAt": "2023-05-17T01:14:15.647Z",
              "state": "string",
              "success": true
          }
          JSON
        • XML
          <?xml version="1.0" encoding="UTF-8"?>
          <SubmitAiAppResponse>
              <accountName>string</accountName>
              <elapsedMillis>0</elapsedMillis>
              <finalStatus>string</finalStatus>
              <finishedAt>2023-05-17T01:17:12.603Z</finishedAt>
              <id>string</id>
              <message>string</message>
              <name>string</name>
              <queueName>gpu</queueName>
              <startedAt>2023-05-17T01:17:12.603Z</startedAt>
              <state>string</state>
              <success>true</success>
          </SubmitAiAppResponse>
          XML

        오류코드

        DataForest 개요 참조

        예시

        요청 예시

        POST https://df.apigw.ntruss.com/api/v2/aiapps/submit
        HOST: df.apigw.ntruss.com
        Content-Type: application/json
        x-ncp-apigw-signature-v2: Azm1WBMWDgEONUCUbsVkB4tRIpc053uOHU8bitbQRtU=
        x-ncp-apigw-timestamp: 1658898041497
        x-ncp-iam-access-key: 17F9A6E9F72BD92ED94B
        
        {
          "aiWorkspaceId": "6ZKSGoSJMMwctK257nxgiL",
          "data": {
            "input": [
              {
                "hdfs": "/user/<계정-이름>/data_in",
                "path": "data_in"
              }
            ],
            "output": [
              {
                "hdfs": "/user/<계정-이름>/data_out",
                "overwrite": false,
                "path": "data_out"
              }
            ]
          },
          "docker": {
            "command": "<실행할 스크립트 또는 명령어>",
            "image": "<Docker 이미지>:<Docker 이미지 버전>",
            "workdir": "<AI 워크스페이스-이름>"
          },
          "namePrefix": "****",
          "queueName": "gpu",
          "resource": {
            "cpuCount": 1,
            "gpuCount": 1,
            "gpuModel": "<GPU-모델>",
            "memoryMb": integer
          }
        }
        HTTP
        curl -X POST "https://df.apigw.ntruss.com/api/v2/aiapps/submit" \
        -H "accept: application/json" \
        -H "Content-Type: application/json" \
        -H "x-ncp-apigw-timestamp:1505290625682" \
        -H "x-ncp-iam-access-key:D78BB444D6D3C84CA38A" \
        -H "x-ncp-apigw-signature-v2:WTPItrmMIfLUk/UyUIyoQbA/z5hq9o3G8eQMolUzTEo=" \
        -d "{ \"aiWorkspaceId\": \"6ZKSGoSJMMwctK257nxgiL\", \"data\": { \"input\": [ { \"hdfs\": \"/user/<계정-이름>/data_in\", \"path\": \"data_in\" } ], \"output\": [ { \"hdfs\": \"/user/<계정-이름>/data_out\", \"overwrite\": false, \"path\": \"data_out\" } ] }, \"docker\": { \"args\": \"string\", \"command\": \"<실행할 스크립트 또는 명령어>\", \"env\": {  }, \"exposeTcpPorts\": [ 0 ], \"image\": \"<Docker 이미지>:<Docker 이미지 버전>\", \"workdir\": \"<AI 워크스페이스-이름>\" }, \"namePrefix\": \"****\", \"queueName\": \"gpu\", \"resource\": { \"cpuCount\": 1, \"gpuCount\": 1, \"gpuModel\": \"<GPU-모델>\", \"memoryMb\": integer }}" \
        Bash

        응답 예시

        • HTTP
          HTTP StatusDescription
          200OK
        • BASH
          {
              "success": true,
              "id": "dN2vdAwrCMZdUzGKKiFy6Z",
              "accountName": "<계정-이름>",
              "name": "****-cvbp-1zqz",
              "queueName": "gpu",
              "startedAt": "2022-08-01T11:08:33.086+09:00",
              "finishedAt": "1970-01-01T09:00:00+09:00",
              "elapsedMillis": integer,
              "state": "ACCEPTED",
              "finalStatus": "UNDEFINED"
          }
          JSON

        이 문서가 도움이 되었습니까?

        Changing your password will log you out immediately. Use the new password to log back in.
        First name must have atleast 2 characters. Numbers and special characters are not allowed.
        Last name must have atleast 1 characters. Numbers and special characters are not allowed.
        Enter a valid email
        Enter a valid password
        Your profile has been successfully updated.