Import Software Image from URL/device - Crosswork Network Controller 7.1 APIs

{"type":"api","title":"Import Software Image from URL/device","meta":{"id":"/apps/pubhub/media/crosswork-network-controller-7-1/f445c17e25a1120e8fbde4bd413083d0fd88b2b3/6a2ef59a-ba2d-3415-a824-195345c9d1ae","info":{"contact":{"email":"support@cisco.com","name":"Crosswork Team, Cisco"},"description":"Software Images APIs allow the user to perform CRUD operations on SWIM service.","license":{"name":"Cisco Software License Agreement","url":"http://www.cisco.com/public/sw-license-agreement.html"},"title":"APIs exposed by SWIM service","version":"1.0.0"},"x-parser-conf":{"overview":{"markdownPath":"reference/EMF/swim-api-overview.md"}},"openapi":"3.0.0","servers":[{"url":"https://{server_ip}:30603/crosswork/swim/{version}","variables":{"version":{"description":"API version","default":"v1"}}}]},"spec":{"responses":{"200":{"content":{"application/json":{"schema":{"description":"Swim job result DTO wrapper","example":{"swimJobResultDTO":{"jobId":"445446","jobStatus":"Image activation scheduled successfully."}},"properties":{"swimJobResultDTO":{"description":"Swim job result DTO","properties":{"jobId":{"description":"Job Id","type":"string"},"jobStatus":{"description":"Job status","type":"string"}},"type":"object","$$ref":"#/components/schemas/SwimJobResultDTO"}},"type":"object","$$ref":"#/components/schemas/SwimJobResultDTOWrapper"}}},"description":"OK"},"400":{"description":"Bad Request - Invalid request"},"500":{"description":"Internal Server Error - operation-failed"}},"tags":["Operation APIs"],"operationId":"collect_1","requestBody":{"content":{"application/json":{"schema":{"description":"Collection Job","properties":{"collectionJobDTO":{"description":"Collection Job DTO","properties":{"deviceIdString":{"description":"Device Id string","example":"446450","type":"string"},"force":{"description":"Overriding the image in SWIM repository","example":false,"type":"boolean"},"imageDetails":{"description":"Image Details","example":{"family":"","md5CheckSum":"","platform":"","vendorName":"Cisco Systems","version":""},"properties":{"family":{"description":"Family","type":"string"},"md5CheckSum":{"description":"Md5 checksum","type":"string"},"platform":{"description":"Platform","type":"string"},"vendorName":{"description":"Vendor name","type":"string"},"version":{"description":"Version","type":"string"}},"type":"object","$$ref":"#/components/schemas/ImageDetails"},"jobDTO":{"description":"Job DTO","example":{"description":"description","jobName":"jobName","jobSchedule":{"daily":false,"dayOfWeek":"","dayRepetition":"","fortnight":false,"hourRepetition":"","hourly":false,"jobScheduleTime":{"endDate":"undefined","hour":"","minute":"","startDate":""},"minute":false,"monthly":false,"monthlyDay":"","monthlyMonth":"","monthlyWeek":"","monthlyWeekDay":"","noOfRepetitions":"0","now":true,"weekly":false,"yearly":false},"jobSpecification":{"taskSpecification":{"domainSpecId":"100"}},"jobType":"jobType","userName":""},"properties":{"parameters":{"description":"Parameters","items":{"description":"Property name and value","properties":{"instanceCreatedOn":{"description":"Instance created on","format":"date-time","type":"string"},"instanceId":{"description":"Instance Id","format":"int64","type":"integer"},"instanceTenantId":{"description":"Instance tenant Id","type":"string"},"instanceUpdatedOn":{"description":"Instance updated on","format":"date-time","type":"string"},"instanceUuid":{"description":"Instance uuid","type":"string"},"instanceVersion":{"description":"Instance version","format":"int32","type":"integer"},"lazyLoadedEntities":{"description":"Lazy loaded entities","additionalProperties":{"description":"Lazy load info","type":"object","$$ref":"#/components/schemas/LazyLoadInfo"},"type":"object"},"propertyName":{"description":"Property name","type":"string"}},"type":"object","$$ref":"#/components/schemas/PropertyNameAndValue"},"type":"array","uniqueItems":true},"customFlag":{"description":"Custom flag","type":"string"},"description":{"description":"Description","type":"string"},"jobName":{"description":"Job Name","type":"string"},"jobSchedule":{"description":"Job Schedule","properties":{"daily":{"description":"Daily","type":"boolean"},"dayOfWeek":{"description":"Day of week","type":"string"},"dayRepetition":{"description":"Day repetition","type":"string"},"fortnight":{"description":"Fortnight","type":"boolean"},"hourRepetition":{"description":"Hour repetition","type":"string"},"hourly":{"description":"Hourly","type":"boolean"},"jobScheduleTime":{"description":"Job schedule time","properties":{"day":{"description":"Day","type":"string"},"endDate":{"description":"End date","type":"string"},"hour":{"description":"Hour","type":"string"},"minute":{"description":"Minute","type":"string"},"month":{"description":"Month","type":"string"},"startDate":{"description":"Start date","type":"string"},"year":{"description":"Year","type":"string"}},"type":"object","xml":{"name":"JobTimeDto"},"$$ref":"#/components/schemas/JobTimeDto"},"minute":{"description":"Minute","type":"boolean"},"monthly":{"description":"Monthly","type":"boolean"},"monthlyDay":{"description":"Monthly day","type":"string"},"monthlyMonth":{"description":"Monthly month","type":"string"},"monthlyWeek":{"description":"Monthly week","type":"string"},"monthlyWeekDay":{"description":"Monthly weekday","type":"string"},"noOfRepetitions":{"description":"Number of repetitions","type":"string"},"now":{"description":"Now","type":"boolean"},"weekly":{"description":"Weekly","type":"boolean"},"yearly":{"description":"Yearly","type":"boolean"}},"type":"object","xml":{"name":"JobScheduleDto"},"$$ref":"#/components/schemas/JobScheduleDto"},"jobSpecification":{"description":"Job Specification","properties":{"runTaskInParallel":{"description":"Run task in parallel","type":"boolean"},"runTaskInSequence":{"description":"Run task in sequence","type":"boolean"},"taskSpecification":{"description":"Task specification","properties":{"domainSpecId":{"description":"Domain Specification Id","type":"string"},"taskName":{"description":"Task name","type":"string"}},"type":"object","$$ref":"#/components/schemas/TaskElementSpecificationDto"}},"type":"object","$$ref":"#/components/schemas/JobSpecificationDto"},"jobType":{"description":"Job type","type":"string"},"userName":{"description":"Username","type":"string"}},"type":"object","xml":{"name":"JobDto"},"$$ref":"#/components/schemas/JobDto"},"repId":{"description":"Repository Id","example":0,"format":"int32","type":"integer"},"sourceType":{"description":"Source type","example":"FILE","type":"string"},"urlString":{"description":"Url string","example":"/mnt/xftpdata/swim-images/NCS540-iosxr-k9-7.7.21.tar","type":"string"},"vrfName":{"description":"Vrf name","example":"Mgmt-intf","type":"string"}},"type":"object","$$ref":"#/components/schemas/CollectionJobDTO"}},"type":"object","$$ref":"#/components/schemas/CollectionJobDTOWrapper"},"example":{"collectionJobDTO":{"jobDTO":{"jobSchedule":{"daily":false,"monthly":false,"now":true,"weekly":false,"minute":false,"yearly":false,"fortnight":false,"hourly":false,"hourRepetition":"","dayRepetition":"","noOfRepetitions":"0","monthlyDay":"","monthlyMonth":"","monthlyWeek":"","monthlyWeekDay":"","dayOfWeek":"","jobScheduleTime":{"hour":"","minute":"","startDate":"","endDate":""}},"jobSpecification":{"taskSpecification":{"domainSpecId":"100"}},"jobName":"image_collection_protocol_10-09-2024_11-04-32_AM","userName":"","jobType":"Software Image Import","description":"Collect image from PROTOCOL"},"sourceType":"PROTOCOL","repId":0,"urlString":"ftp://username:password@ipAddress/ftp/upload/ncs4200rsp3-universalk9_npe.17.08.01.SPA.bin","imageDetails":{"vendorName":"Cisco Systems","platform":"","version":"","family":"","md5CheckSum":""},"force":true,"deviceIdString":"","vrfName":""}}}},"required":true},"summary":"Import Software Image from URL/device.","__originalOperationId":"collect_1","method":"post","path":"/collect"}}