submit
- 인쇄
- PDF
submit
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
VPC 환경에서 이용 가능합니다.
AI 앱을 실행합니다.
요청
요청 파라미터
파라미터명 | 필수 여부 | 타입 | 제약 사항 | 설명 |
---|---|---|---|---|
aiWorkspaceId | YES | String | 최대 22자까지 입력 | - AI 워크스페이스 식별자 UUID(base62) - aiWorkspaceId는 AI Workspaces의 getList API를 통해서 획득 가능 |
namePrefix | YES | String | 최소 2자에서 최대 8자까지 입력 | AI 앱 이름 설정 시 필요한 접두사 |
queueName | YES | String | - YARN 큐 이름 - 기본값: gpu | |
data | YES | AiAppData | AiAppData 데이터 타입 | |
docker | YES | AiAppDocker | AiAppDocker 데이터 타입 | |
resource | YES | AiAppResource | AiAppResource 데이터 타입 |
요청 헤더
요청 바디
- 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 } }
- 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>
응답
응답 바디
- 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 }
- 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>
오류코드
예시
요청 예시
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
}
}
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 }}" \
응답 예시
- HTTP
HTTP Status Description 200 OK - 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" }
이 문서가 도움이 되었습니까?