api.go 118 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285228622872288228922902291229222932294229522962297229822992300230123022303230423052306230723082309231023112312231323142315231623172318231923202321232223232324232523262327232823292330233123322333233423352336233723382339234023412342234323442345234623472348234923502351235223532354235523562357235823592360236123622363236423652366236723682369237023712372237323742375237623772378237923802381238223832384238523862387238823892390239123922393239423952396239723982399240024012402240324042405240624072408240924102411241224132414241524162417241824192420242124222423242424252426242724282429243024312432243324342435243624372438243924402441244224432444244524462447244824492450245124522453245424552456245724582459246024612462246324642465246624672468246924702471247224732474247524762477247824792480248124822483248424852486248724882489249024912492249324942495249624972498249925002501250225032504250525062507250825092510251125122513251425152516251725182519252025212522252325242525252625272528252925302531253225332534253525362537253825392540254125422543254425452546254725482549255025512552255325542555255625572558255925602561256225632564256525662567256825692570257125722573257425752576257725782579258025812582258325842585258625872588258925902591259225932594259525962597259825992600260126022603260426052606260726082609261026112612261326142615261626172618261926202621262226232624262526262627262826292630263126322633263426352636263726382639264026412642264326442645264626472648264926502651265226532654265526562657265826592660266126622663266426652666266726682669267026712672267326742675267626772678267926802681268226832684268526862687268826892690269126922693269426952696269726982699270027012702270327042705270627072708270927102711271227132714271527162717271827192720272127222723272427252726272727282729273027312732273327342735273627372738273927402741274227432744274527462747274827492750275127522753275427552756275727582759276027612762276327642765276627672768276927702771277227732774277527762777277827792780278127822783278427852786278727882789279027912792279327942795279627972798279928002801280228032804280528062807280828092810281128122813281428152816281728182819282028212822282328242825282628272828282928302831283228332834283528362837283828392840284128422843284428452846284728482849285028512852285328542855285628572858285928602861286228632864286528662867286828692870287128722873287428752876287728782879288028812882288328842885288628872888288928902891289228932894289528962897289828992900290129022903290429052906290729082909291029112912291329142915291629172918291929202921292229232924292529262927292829292930293129322933293429352936293729382939294029412942294329442945294629472948294929502951295229532954295529562957295829592960296129622963296429652966296729682969297029712972297329742975297629772978297929802981298229832984298529862987298829892990299129922993299429952996299729982999300030013002300330043005300630073008300930103011301230133014301530163017301830193020302130223023302430253026302730283029303030313032303330343035303630373038303930403041304230433044304530463047304830493050305130523053305430553056305730583059306030613062306330643065306630673068306930703071307230733074307530763077307830793080308130823083308430853086308730883089309030913092309330943095309630973098309931003101310231033104310531063107310831093110311131123113311431153116311731183119312031213122312331243125312631273128312931303131313231333134313531363137313831393140314131423143314431453146314731483149315031513152315331543155315631573158315931603161316231633164316531663167316831693170317131723173317431753176317731783179318031813182318331843185318631873188318931903191319231933194319531963197319831993200320132023203320432053206320732083209321032113212321332143215321632173218321932203221322232233224322532263227322832293230323132323233323432353236323732383239324032413242324332443245324632473248324932503251325232533254325532563257325832593260326132623263326432653266326732683269327032713272327332743275327632773278327932803281328232833284328532863287328832893290329132923293329432953296329732983299330033013302330333043305330633073308330933103311331233133314331533163317331833193320332133223323332433253326332733283329333033313332333333343335333633373338333933403341334233433344334533463347334833493350335133523353335433553356335733583359336033613362336333643365336633673368336933703371337233733374337533763377337833793380338133823383338433853386338733883389339033913392339333943395339633973398339934003401340234033404340534063407340834093410341134123413341434153416341734183419342034213422342334243425342634273428342934303431343234333434343534363437343834393440344134423443
  1. // THIS FILE IS AUTOMATICALLY GENERATED. DO NOT EDIT.
  2. // Package ecs provides a client for Amazon EC2 Container Service.
  3. package ecs
  4. import (
  5. "time"
  6. "github.com/aws/aws-sdk-go/aws/awsutil"
  7. "github.com/aws/aws-sdk-go/aws/request"
  8. )
  9. const opCreateCluster = "CreateCluster"
  10. // CreateClusterRequest generates a request for the CreateCluster operation.
  11. func (c *ECS) CreateClusterRequest(input *CreateClusterInput) (req *request.Request, output *CreateClusterOutput) {
  12. op := &request.Operation{
  13. Name: opCreateCluster,
  14. HTTPMethod: "POST",
  15. HTTPPath: "/",
  16. }
  17. if input == nil {
  18. input = &CreateClusterInput{}
  19. }
  20. req = c.newRequest(op, input, output)
  21. output = &CreateClusterOutput{}
  22. req.Data = output
  23. return
  24. }
  25. // Creates a new Amazon ECS cluster. By default, your account will receive a
  26. // default cluster when you launch your first container instance. However, you
  27. // can create your own cluster with a unique name with the CreateCluster action.
  28. func (c *ECS) CreateCluster(input *CreateClusterInput) (*CreateClusterOutput, error) {
  29. req, out := c.CreateClusterRequest(input)
  30. err := req.Send()
  31. return out, err
  32. }
  33. const opCreateService = "CreateService"
  34. // CreateServiceRequest generates a request for the CreateService operation.
  35. func (c *ECS) CreateServiceRequest(input *CreateServiceInput) (req *request.Request, output *CreateServiceOutput) {
  36. op := &request.Operation{
  37. Name: opCreateService,
  38. HTTPMethod: "POST",
  39. HTTPPath: "/",
  40. }
  41. if input == nil {
  42. input = &CreateServiceInput{}
  43. }
  44. req = c.newRequest(op, input, output)
  45. output = &CreateServiceOutput{}
  46. req.Data = output
  47. return
  48. }
  49. // Runs and maintains a desired number of tasks from a specified task definition.
  50. // If the number of tasks running in a service drops below desiredCount, Amazon
  51. // ECS will spawn another instantiation of the task in the specified cluster.
  52. func (c *ECS) CreateService(input *CreateServiceInput) (*CreateServiceOutput, error) {
  53. req, out := c.CreateServiceRequest(input)
  54. err := req.Send()
  55. return out, err
  56. }
  57. const opDeleteCluster = "DeleteCluster"
  58. // DeleteClusterRequest generates a request for the DeleteCluster operation.
  59. func (c *ECS) DeleteClusterRequest(input *DeleteClusterInput) (req *request.Request, output *DeleteClusterOutput) {
  60. op := &request.Operation{
  61. Name: opDeleteCluster,
  62. HTTPMethod: "POST",
  63. HTTPPath: "/",
  64. }
  65. if input == nil {
  66. input = &DeleteClusterInput{}
  67. }
  68. req = c.newRequest(op, input, output)
  69. output = &DeleteClusterOutput{}
  70. req.Data = output
  71. return
  72. }
  73. // Deletes the specified cluster. You must deregister all container instances
  74. // from this cluster before you may delete it. You can list the container instances
  75. // in a cluster with ListContainerInstances and deregister them with DeregisterContainerInstance.
  76. func (c *ECS) DeleteCluster(input *DeleteClusterInput) (*DeleteClusterOutput, error) {
  77. req, out := c.DeleteClusterRequest(input)
  78. err := req.Send()
  79. return out, err
  80. }
  81. const opDeleteService = "DeleteService"
  82. // DeleteServiceRequest generates a request for the DeleteService operation.
  83. func (c *ECS) DeleteServiceRequest(input *DeleteServiceInput) (req *request.Request, output *DeleteServiceOutput) {
  84. op := &request.Operation{
  85. Name: opDeleteService,
  86. HTTPMethod: "POST",
  87. HTTPPath: "/",
  88. }
  89. if input == nil {
  90. input = &DeleteServiceInput{}
  91. }
  92. req = c.newRequest(op, input, output)
  93. output = &DeleteServiceOutput{}
  94. req.Data = output
  95. return
  96. }
  97. // Deletes a specified service within a cluster.
  98. func (c *ECS) DeleteService(input *DeleteServiceInput) (*DeleteServiceOutput, error) {
  99. req, out := c.DeleteServiceRequest(input)
  100. err := req.Send()
  101. return out, err
  102. }
  103. const opDeregisterContainerInstance = "DeregisterContainerInstance"
  104. // DeregisterContainerInstanceRequest generates a request for the DeregisterContainerInstance operation.
  105. func (c *ECS) DeregisterContainerInstanceRequest(input *DeregisterContainerInstanceInput) (req *request.Request, output *DeregisterContainerInstanceOutput) {
  106. op := &request.Operation{
  107. Name: opDeregisterContainerInstance,
  108. HTTPMethod: "POST",
  109. HTTPPath: "/",
  110. }
  111. if input == nil {
  112. input = &DeregisterContainerInstanceInput{}
  113. }
  114. req = c.newRequest(op, input, output)
  115. output = &DeregisterContainerInstanceOutput{}
  116. req.Data = output
  117. return
  118. }
  119. // Deregisters an Amazon ECS container instance from the specified cluster.
  120. // This instance will no longer be available to run tasks.
  121. //
  122. // If you intend to use the container instance for some other purpose after
  123. // deregistration, you should stop all of the tasks running on the container
  124. // instance before deregistration to avoid any orphaned tasks from consuming
  125. // resources.
  126. //
  127. // Deregistering a container instance removes the instance from a cluster,
  128. // but it does not terminate the EC2 instance; if you are finished using the
  129. // instance, be sure to terminate it in the Amazon EC2 console to stop billing.
  130. //
  131. // When you terminate a container instance, it is automatically deregistered
  132. // from your cluster.
  133. func (c *ECS) DeregisterContainerInstance(input *DeregisterContainerInstanceInput) (*DeregisterContainerInstanceOutput, error) {
  134. req, out := c.DeregisterContainerInstanceRequest(input)
  135. err := req.Send()
  136. return out, err
  137. }
  138. const opDeregisterTaskDefinition = "DeregisterTaskDefinition"
  139. // DeregisterTaskDefinitionRequest generates a request for the DeregisterTaskDefinition operation.
  140. func (c *ECS) DeregisterTaskDefinitionRequest(input *DeregisterTaskDefinitionInput) (req *request.Request, output *DeregisterTaskDefinitionOutput) {
  141. op := &request.Operation{
  142. Name: opDeregisterTaskDefinition,
  143. HTTPMethod: "POST",
  144. HTTPPath: "/",
  145. }
  146. if input == nil {
  147. input = &DeregisterTaskDefinitionInput{}
  148. }
  149. req = c.newRequest(op, input, output)
  150. output = &DeregisterTaskDefinitionOutput{}
  151. req.Data = output
  152. return
  153. }
  154. // Deregisters the specified task definition by family and revision. Upon deregistration,
  155. // the task definition is marked as INACTIVE. Existing tasks and services that
  156. // reference an INACTIVE task definition continue to run without disruption.
  157. // Existing services that reference an INACTIVE task definition can still scale
  158. // up or down by modifying the service's desired count.
  159. //
  160. // You cannot use an INACTIVE task definition to run new tasks or create new
  161. // services, and you cannot update an existing service to reference an INACTIVE
  162. // task definition (although there may be up to a 10 minute window following
  163. // deregistration where these restrictions have not yet taken effect).
  164. func (c *ECS) DeregisterTaskDefinition(input *DeregisterTaskDefinitionInput) (*DeregisterTaskDefinitionOutput, error) {
  165. req, out := c.DeregisterTaskDefinitionRequest(input)
  166. err := req.Send()
  167. return out, err
  168. }
  169. const opDescribeClusters = "DescribeClusters"
  170. // DescribeClustersRequest generates a request for the DescribeClusters operation.
  171. func (c *ECS) DescribeClustersRequest(input *DescribeClustersInput) (req *request.Request, output *DescribeClustersOutput) {
  172. op := &request.Operation{
  173. Name: opDescribeClusters,
  174. HTTPMethod: "POST",
  175. HTTPPath: "/",
  176. }
  177. if input == nil {
  178. input = &DescribeClustersInput{}
  179. }
  180. req = c.newRequest(op, input, output)
  181. output = &DescribeClustersOutput{}
  182. req.Data = output
  183. return
  184. }
  185. // Describes one or more of your clusters.
  186. func (c *ECS) DescribeClusters(input *DescribeClustersInput) (*DescribeClustersOutput, error) {
  187. req, out := c.DescribeClustersRequest(input)
  188. err := req.Send()
  189. return out, err
  190. }
  191. const opDescribeContainerInstances = "DescribeContainerInstances"
  192. // DescribeContainerInstancesRequest generates a request for the DescribeContainerInstances operation.
  193. func (c *ECS) DescribeContainerInstancesRequest(input *DescribeContainerInstancesInput) (req *request.Request, output *DescribeContainerInstancesOutput) {
  194. op := &request.Operation{
  195. Name: opDescribeContainerInstances,
  196. HTTPMethod: "POST",
  197. HTTPPath: "/",
  198. }
  199. if input == nil {
  200. input = &DescribeContainerInstancesInput{}
  201. }
  202. req = c.newRequest(op, input, output)
  203. output = &DescribeContainerInstancesOutput{}
  204. req.Data = output
  205. return
  206. }
  207. // Describes Amazon EC2 Container Service container instances. Returns metadata
  208. // about registered and remaining resources on each container instance requested.
  209. func (c *ECS) DescribeContainerInstances(input *DescribeContainerInstancesInput) (*DescribeContainerInstancesOutput, error) {
  210. req, out := c.DescribeContainerInstancesRequest(input)
  211. err := req.Send()
  212. return out, err
  213. }
  214. const opDescribeServices = "DescribeServices"
  215. // DescribeServicesRequest generates a request for the DescribeServices operation.
  216. func (c *ECS) DescribeServicesRequest(input *DescribeServicesInput) (req *request.Request, output *DescribeServicesOutput) {
  217. op := &request.Operation{
  218. Name: opDescribeServices,
  219. HTTPMethod: "POST",
  220. HTTPPath: "/",
  221. }
  222. if input == nil {
  223. input = &DescribeServicesInput{}
  224. }
  225. req = c.newRequest(op, input, output)
  226. output = &DescribeServicesOutput{}
  227. req.Data = output
  228. return
  229. }
  230. // Describes the specified services running in your cluster.
  231. func (c *ECS) DescribeServices(input *DescribeServicesInput) (*DescribeServicesOutput, error) {
  232. req, out := c.DescribeServicesRequest(input)
  233. err := req.Send()
  234. return out, err
  235. }
  236. const opDescribeTaskDefinition = "DescribeTaskDefinition"
  237. // DescribeTaskDefinitionRequest generates a request for the DescribeTaskDefinition operation.
  238. func (c *ECS) DescribeTaskDefinitionRequest(input *DescribeTaskDefinitionInput) (req *request.Request, output *DescribeTaskDefinitionOutput) {
  239. op := &request.Operation{
  240. Name: opDescribeTaskDefinition,
  241. HTTPMethod: "POST",
  242. HTTPPath: "/",
  243. }
  244. if input == nil {
  245. input = &DescribeTaskDefinitionInput{}
  246. }
  247. req = c.newRequest(op, input, output)
  248. output = &DescribeTaskDefinitionOutput{}
  249. req.Data = output
  250. return
  251. }
  252. // Describes a task definition. You can specify a family and revision to find
  253. // information on a specific task definition, or you can simply specify the
  254. // family to find the latest ACTIVE revision in that family.
  255. //
  256. // You can only describe INACTIVE task definitions while an active task or
  257. // service references them.
  258. func (c *ECS) DescribeTaskDefinition(input *DescribeTaskDefinitionInput) (*DescribeTaskDefinitionOutput, error) {
  259. req, out := c.DescribeTaskDefinitionRequest(input)
  260. err := req.Send()
  261. return out, err
  262. }
  263. const opDescribeTasks = "DescribeTasks"
  264. // DescribeTasksRequest generates a request for the DescribeTasks operation.
  265. func (c *ECS) DescribeTasksRequest(input *DescribeTasksInput) (req *request.Request, output *DescribeTasksOutput) {
  266. op := &request.Operation{
  267. Name: opDescribeTasks,
  268. HTTPMethod: "POST",
  269. HTTPPath: "/",
  270. }
  271. if input == nil {
  272. input = &DescribeTasksInput{}
  273. }
  274. req = c.newRequest(op, input, output)
  275. output = &DescribeTasksOutput{}
  276. req.Data = output
  277. return
  278. }
  279. // Describes a specified task or tasks.
  280. func (c *ECS) DescribeTasks(input *DescribeTasksInput) (*DescribeTasksOutput, error) {
  281. req, out := c.DescribeTasksRequest(input)
  282. err := req.Send()
  283. return out, err
  284. }
  285. const opDiscoverPollEndpoint = "DiscoverPollEndpoint"
  286. // DiscoverPollEndpointRequest generates a request for the DiscoverPollEndpoint operation.
  287. func (c *ECS) DiscoverPollEndpointRequest(input *DiscoverPollEndpointInput) (req *request.Request, output *DiscoverPollEndpointOutput) {
  288. op := &request.Operation{
  289. Name: opDiscoverPollEndpoint,
  290. HTTPMethod: "POST",
  291. HTTPPath: "/",
  292. }
  293. if input == nil {
  294. input = &DiscoverPollEndpointInput{}
  295. }
  296. req = c.newRequest(op, input, output)
  297. output = &DiscoverPollEndpointOutput{}
  298. req.Data = output
  299. return
  300. }
  301. // This action is only used by the Amazon EC2 Container Service agent, and it
  302. // is not intended for use outside of the agent.
  303. //
  304. // Returns an endpoint for the Amazon EC2 Container Service agent to poll for
  305. // updates.
  306. func (c *ECS) DiscoverPollEndpoint(input *DiscoverPollEndpointInput) (*DiscoverPollEndpointOutput, error) {
  307. req, out := c.DiscoverPollEndpointRequest(input)
  308. err := req.Send()
  309. return out, err
  310. }
  311. const opListClusters = "ListClusters"
  312. // ListClustersRequest generates a request for the ListClusters operation.
  313. func (c *ECS) ListClustersRequest(input *ListClustersInput) (req *request.Request, output *ListClustersOutput) {
  314. op := &request.Operation{
  315. Name: opListClusters,
  316. HTTPMethod: "POST",
  317. HTTPPath: "/",
  318. Paginator: &request.Paginator{
  319. InputTokens: []string{"nextToken"},
  320. OutputTokens: []string{"nextToken"},
  321. LimitToken: "maxResults",
  322. TruncationToken: "",
  323. },
  324. }
  325. if input == nil {
  326. input = &ListClustersInput{}
  327. }
  328. req = c.newRequest(op, input, output)
  329. output = &ListClustersOutput{}
  330. req.Data = output
  331. return
  332. }
  333. // Returns a list of existing clusters.
  334. func (c *ECS) ListClusters(input *ListClustersInput) (*ListClustersOutput, error) {
  335. req, out := c.ListClustersRequest(input)
  336. err := req.Send()
  337. return out, err
  338. }
  339. func (c *ECS) ListClustersPages(input *ListClustersInput, fn func(p *ListClustersOutput, lastPage bool) (shouldContinue bool)) error {
  340. page, _ := c.ListClustersRequest(input)
  341. return page.EachPage(func(p interface{}, lastPage bool) bool {
  342. return fn(p.(*ListClustersOutput), lastPage)
  343. })
  344. }
  345. const opListContainerInstances = "ListContainerInstances"
  346. // ListContainerInstancesRequest generates a request for the ListContainerInstances operation.
  347. func (c *ECS) ListContainerInstancesRequest(input *ListContainerInstancesInput) (req *request.Request, output *ListContainerInstancesOutput) {
  348. op := &request.Operation{
  349. Name: opListContainerInstances,
  350. HTTPMethod: "POST",
  351. HTTPPath: "/",
  352. Paginator: &request.Paginator{
  353. InputTokens: []string{"nextToken"},
  354. OutputTokens: []string{"nextToken"},
  355. LimitToken: "maxResults",
  356. TruncationToken: "",
  357. },
  358. }
  359. if input == nil {
  360. input = &ListContainerInstancesInput{}
  361. }
  362. req = c.newRequest(op, input, output)
  363. output = &ListContainerInstancesOutput{}
  364. req.Data = output
  365. return
  366. }
  367. // Returns a list of container instances in a specified cluster.
  368. func (c *ECS) ListContainerInstances(input *ListContainerInstancesInput) (*ListContainerInstancesOutput, error) {
  369. req, out := c.ListContainerInstancesRequest(input)
  370. err := req.Send()
  371. return out, err
  372. }
  373. func (c *ECS) ListContainerInstancesPages(input *ListContainerInstancesInput, fn func(p *ListContainerInstancesOutput, lastPage bool) (shouldContinue bool)) error {
  374. page, _ := c.ListContainerInstancesRequest(input)
  375. return page.EachPage(func(p interface{}, lastPage bool) bool {
  376. return fn(p.(*ListContainerInstancesOutput), lastPage)
  377. })
  378. }
  379. const opListServices = "ListServices"
  380. // ListServicesRequest generates a request for the ListServices operation.
  381. func (c *ECS) ListServicesRequest(input *ListServicesInput) (req *request.Request, output *ListServicesOutput) {
  382. op := &request.Operation{
  383. Name: opListServices,
  384. HTTPMethod: "POST",
  385. HTTPPath: "/",
  386. Paginator: &request.Paginator{
  387. InputTokens: []string{"nextToken"},
  388. OutputTokens: []string{"nextToken"},
  389. LimitToken: "maxResults",
  390. TruncationToken: "",
  391. },
  392. }
  393. if input == nil {
  394. input = &ListServicesInput{}
  395. }
  396. req = c.newRequest(op, input, output)
  397. output = &ListServicesOutput{}
  398. req.Data = output
  399. return
  400. }
  401. // Lists the services that are running in a specified cluster.
  402. func (c *ECS) ListServices(input *ListServicesInput) (*ListServicesOutput, error) {
  403. req, out := c.ListServicesRequest(input)
  404. err := req.Send()
  405. return out, err
  406. }
  407. func (c *ECS) ListServicesPages(input *ListServicesInput, fn func(p *ListServicesOutput, lastPage bool) (shouldContinue bool)) error {
  408. page, _ := c.ListServicesRequest(input)
  409. return page.EachPage(func(p interface{}, lastPage bool) bool {
  410. return fn(p.(*ListServicesOutput), lastPage)
  411. })
  412. }
  413. const opListTaskDefinitionFamilies = "ListTaskDefinitionFamilies"
  414. // ListTaskDefinitionFamiliesRequest generates a request for the ListTaskDefinitionFamilies operation.
  415. func (c *ECS) ListTaskDefinitionFamiliesRequest(input *ListTaskDefinitionFamiliesInput) (req *request.Request, output *ListTaskDefinitionFamiliesOutput) {
  416. op := &request.Operation{
  417. Name: opListTaskDefinitionFamilies,
  418. HTTPMethod: "POST",
  419. HTTPPath: "/",
  420. Paginator: &request.Paginator{
  421. InputTokens: []string{"nextToken"},
  422. OutputTokens: []string{"nextToken"},
  423. LimitToken: "maxResults",
  424. TruncationToken: "",
  425. },
  426. }
  427. if input == nil {
  428. input = &ListTaskDefinitionFamiliesInput{}
  429. }
  430. req = c.newRequest(op, input, output)
  431. output = &ListTaskDefinitionFamiliesOutput{}
  432. req.Data = output
  433. return
  434. }
  435. // Returns a list of task definition families that are registered to your account
  436. // (which may include task definition families that no longer have any ACTIVE
  437. // task definitions). You can filter the results with the familyPrefix parameter.
  438. func (c *ECS) ListTaskDefinitionFamilies(input *ListTaskDefinitionFamiliesInput) (*ListTaskDefinitionFamiliesOutput, error) {
  439. req, out := c.ListTaskDefinitionFamiliesRequest(input)
  440. err := req.Send()
  441. return out, err
  442. }
  443. func (c *ECS) ListTaskDefinitionFamiliesPages(input *ListTaskDefinitionFamiliesInput, fn func(p *ListTaskDefinitionFamiliesOutput, lastPage bool) (shouldContinue bool)) error {
  444. page, _ := c.ListTaskDefinitionFamiliesRequest(input)
  445. return page.EachPage(func(p interface{}, lastPage bool) bool {
  446. return fn(p.(*ListTaskDefinitionFamiliesOutput), lastPage)
  447. })
  448. }
  449. const opListTaskDefinitions = "ListTaskDefinitions"
  450. // ListTaskDefinitionsRequest generates a request for the ListTaskDefinitions operation.
  451. func (c *ECS) ListTaskDefinitionsRequest(input *ListTaskDefinitionsInput) (req *request.Request, output *ListTaskDefinitionsOutput) {
  452. op := &request.Operation{
  453. Name: opListTaskDefinitions,
  454. HTTPMethod: "POST",
  455. HTTPPath: "/",
  456. Paginator: &request.Paginator{
  457. InputTokens: []string{"nextToken"},
  458. OutputTokens: []string{"nextToken"},
  459. LimitToken: "maxResults",
  460. TruncationToken: "",
  461. },
  462. }
  463. if input == nil {
  464. input = &ListTaskDefinitionsInput{}
  465. }
  466. req = c.newRequest(op, input, output)
  467. output = &ListTaskDefinitionsOutput{}
  468. req.Data = output
  469. return
  470. }
  471. // Returns a list of task definitions that are registered to your account. You
  472. // can filter the results by family name with the familyPrefix parameter or
  473. // by status with the status parameter.
  474. func (c *ECS) ListTaskDefinitions(input *ListTaskDefinitionsInput) (*ListTaskDefinitionsOutput, error) {
  475. req, out := c.ListTaskDefinitionsRequest(input)
  476. err := req.Send()
  477. return out, err
  478. }
  479. func (c *ECS) ListTaskDefinitionsPages(input *ListTaskDefinitionsInput, fn func(p *ListTaskDefinitionsOutput, lastPage bool) (shouldContinue bool)) error {
  480. page, _ := c.ListTaskDefinitionsRequest(input)
  481. return page.EachPage(func(p interface{}, lastPage bool) bool {
  482. return fn(p.(*ListTaskDefinitionsOutput), lastPage)
  483. })
  484. }
  485. const opListTasks = "ListTasks"
  486. // ListTasksRequest generates a request for the ListTasks operation.
  487. func (c *ECS) ListTasksRequest(input *ListTasksInput) (req *request.Request, output *ListTasksOutput) {
  488. op := &request.Operation{
  489. Name: opListTasks,
  490. HTTPMethod: "POST",
  491. HTTPPath: "/",
  492. Paginator: &request.Paginator{
  493. InputTokens: []string{"nextToken"},
  494. OutputTokens: []string{"nextToken"},
  495. LimitToken: "maxResults",
  496. TruncationToken: "",
  497. },
  498. }
  499. if input == nil {
  500. input = &ListTasksInput{}
  501. }
  502. req = c.newRequest(op, input, output)
  503. output = &ListTasksOutput{}
  504. req.Data = output
  505. return
  506. }
  507. // Returns a list of tasks for a specified cluster. You can filter the results
  508. // by family name, by a particular container instance, or by the desired status
  509. // of the task with the family, containerInstance, and desiredStatus parameters.
  510. func (c *ECS) ListTasks(input *ListTasksInput) (*ListTasksOutput, error) {
  511. req, out := c.ListTasksRequest(input)
  512. err := req.Send()
  513. return out, err
  514. }
  515. func (c *ECS) ListTasksPages(input *ListTasksInput, fn func(p *ListTasksOutput, lastPage bool) (shouldContinue bool)) error {
  516. page, _ := c.ListTasksRequest(input)
  517. return page.EachPage(func(p interface{}, lastPage bool) bool {
  518. return fn(p.(*ListTasksOutput), lastPage)
  519. })
  520. }
  521. const opRegisterContainerInstance = "RegisterContainerInstance"
  522. // RegisterContainerInstanceRequest generates a request for the RegisterContainerInstance operation.
  523. func (c *ECS) RegisterContainerInstanceRequest(input *RegisterContainerInstanceInput) (req *request.Request, output *RegisterContainerInstanceOutput) {
  524. op := &request.Operation{
  525. Name: opRegisterContainerInstance,
  526. HTTPMethod: "POST",
  527. HTTPPath: "/",
  528. }
  529. if input == nil {
  530. input = &RegisterContainerInstanceInput{}
  531. }
  532. req = c.newRequest(op, input, output)
  533. output = &RegisterContainerInstanceOutput{}
  534. req.Data = output
  535. return
  536. }
  537. // This action is only used by the Amazon EC2 Container Service agent, and it
  538. // is not intended for use outside of the agent.
  539. //
  540. // Registers an Amazon EC2 instance into the specified cluster. This instance
  541. // will become available to place containers on.
  542. func (c *ECS) RegisterContainerInstance(input *RegisterContainerInstanceInput) (*RegisterContainerInstanceOutput, error) {
  543. req, out := c.RegisterContainerInstanceRequest(input)
  544. err := req.Send()
  545. return out, err
  546. }
  547. const opRegisterTaskDefinition = "RegisterTaskDefinition"
  548. // RegisterTaskDefinitionRequest generates a request for the RegisterTaskDefinition operation.
  549. func (c *ECS) RegisterTaskDefinitionRequest(input *RegisterTaskDefinitionInput) (req *request.Request, output *RegisterTaskDefinitionOutput) {
  550. op := &request.Operation{
  551. Name: opRegisterTaskDefinition,
  552. HTTPMethod: "POST",
  553. HTTPPath: "/",
  554. }
  555. if input == nil {
  556. input = &RegisterTaskDefinitionInput{}
  557. }
  558. req = c.newRequest(op, input, output)
  559. output = &RegisterTaskDefinitionOutput{}
  560. req.Data = output
  561. return
  562. }
  563. // Registers a new task definition from the supplied family and containerDefinitions.
  564. // Optionally, you can add data volumes to your containers with the volumes
  565. // parameter. For more information on task definition parameters and defaults,
  566. // see Amazon ECS Task Definitions (http://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_defintions.html)
  567. // in the Amazon EC2 Container Service Developer Guide.
  568. func (c *ECS) RegisterTaskDefinition(input *RegisterTaskDefinitionInput) (*RegisterTaskDefinitionOutput, error) {
  569. req, out := c.RegisterTaskDefinitionRequest(input)
  570. err := req.Send()
  571. return out, err
  572. }
  573. const opRunTask = "RunTask"
  574. // RunTaskRequest generates a request for the RunTask operation.
  575. func (c *ECS) RunTaskRequest(input *RunTaskInput) (req *request.Request, output *RunTaskOutput) {
  576. op := &request.Operation{
  577. Name: opRunTask,
  578. HTTPMethod: "POST",
  579. HTTPPath: "/",
  580. }
  581. if input == nil {
  582. input = &RunTaskInput{}
  583. }
  584. req = c.newRequest(op, input, output)
  585. output = &RunTaskOutput{}
  586. req.Data = output
  587. return
  588. }
  589. // Start a task using random placement and the default Amazon ECS scheduler.
  590. // If you want to use your own scheduler or place a task on a specific container
  591. // instance, use StartTask instead.
  592. //
  593. // The count parameter is limited to 10 tasks per call.
  594. func (c *ECS) RunTask(input *RunTaskInput) (*RunTaskOutput, error) {
  595. req, out := c.RunTaskRequest(input)
  596. err := req.Send()
  597. return out, err
  598. }
  599. const opStartTask = "StartTask"
  600. // StartTaskRequest generates a request for the StartTask operation.
  601. func (c *ECS) StartTaskRequest(input *StartTaskInput) (req *request.Request, output *StartTaskOutput) {
  602. op := &request.Operation{
  603. Name: opStartTask,
  604. HTTPMethod: "POST",
  605. HTTPPath: "/",
  606. }
  607. if input == nil {
  608. input = &StartTaskInput{}
  609. }
  610. req = c.newRequest(op, input, output)
  611. output = &StartTaskOutput{}
  612. req.Data = output
  613. return
  614. }
  615. // Starts a new task from the specified task definition on the specified container
  616. // instance or instances. If you want to use the default Amazon ECS scheduler
  617. // to place your task, use RunTask instead.
  618. //
  619. // The list of container instances to start tasks on is limited to 10.
  620. func (c *ECS) StartTask(input *StartTaskInput) (*StartTaskOutput, error) {
  621. req, out := c.StartTaskRequest(input)
  622. err := req.Send()
  623. return out, err
  624. }
  625. const opStopTask = "StopTask"
  626. // StopTaskRequest generates a request for the StopTask operation.
  627. func (c *ECS) StopTaskRequest(input *StopTaskInput) (req *request.Request, output *StopTaskOutput) {
  628. op := &request.Operation{
  629. Name: opStopTask,
  630. HTTPMethod: "POST",
  631. HTTPPath: "/",
  632. }
  633. if input == nil {
  634. input = &StopTaskInput{}
  635. }
  636. req = c.newRequest(op, input, output)
  637. output = &StopTaskOutput{}
  638. req.Data = output
  639. return
  640. }
  641. // Stops a running task.
  642. func (c *ECS) StopTask(input *StopTaskInput) (*StopTaskOutput, error) {
  643. req, out := c.StopTaskRequest(input)
  644. err := req.Send()
  645. return out, err
  646. }
  647. const opSubmitContainerStateChange = "SubmitContainerStateChange"
  648. // SubmitContainerStateChangeRequest generates a request for the SubmitContainerStateChange operation.
  649. func (c *ECS) SubmitContainerStateChangeRequest(input *SubmitContainerStateChangeInput) (req *request.Request, output *SubmitContainerStateChangeOutput) {
  650. op := &request.Operation{
  651. Name: opSubmitContainerStateChange,
  652. HTTPMethod: "POST",
  653. HTTPPath: "/",
  654. }
  655. if input == nil {
  656. input = &SubmitContainerStateChangeInput{}
  657. }
  658. req = c.newRequest(op, input, output)
  659. output = &SubmitContainerStateChangeOutput{}
  660. req.Data = output
  661. return
  662. }
  663. // This action is only used by the Amazon EC2 Container Service agent, and it
  664. // is not intended for use outside of the agent.
  665. //
  666. // Sent to acknowledge that a container changed states.
  667. func (c *ECS) SubmitContainerStateChange(input *SubmitContainerStateChangeInput) (*SubmitContainerStateChangeOutput, error) {
  668. req, out := c.SubmitContainerStateChangeRequest(input)
  669. err := req.Send()
  670. return out, err
  671. }
  672. const opSubmitTaskStateChange = "SubmitTaskStateChange"
  673. // SubmitTaskStateChangeRequest generates a request for the SubmitTaskStateChange operation.
  674. func (c *ECS) SubmitTaskStateChangeRequest(input *SubmitTaskStateChangeInput) (req *request.Request, output *SubmitTaskStateChangeOutput) {
  675. op := &request.Operation{
  676. Name: opSubmitTaskStateChange,
  677. HTTPMethod: "POST",
  678. HTTPPath: "/",
  679. }
  680. if input == nil {
  681. input = &SubmitTaskStateChangeInput{}
  682. }
  683. req = c.newRequest(op, input, output)
  684. output = &SubmitTaskStateChangeOutput{}
  685. req.Data = output
  686. return
  687. }
  688. // This action is only used by the Amazon EC2 Container Service agent, and it
  689. // is not intended for use outside of the agent.
  690. //
  691. // Sent to acknowledge that a task changed states.
  692. func (c *ECS) SubmitTaskStateChange(input *SubmitTaskStateChangeInput) (*SubmitTaskStateChangeOutput, error) {
  693. req, out := c.SubmitTaskStateChangeRequest(input)
  694. err := req.Send()
  695. return out, err
  696. }
  697. const opUpdateContainerAgent = "UpdateContainerAgent"
  698. // UpdateContainerAgentRequest generates a request for the UpdateContainerAgent operation.
  699. func (c *ECS) UpdateContainerAgentRequest(input *UpdateContainerAgentInput) (req *request.Request, output *UpdateContainerAgentOutput) {
  700. op := &request.Operation{
  701. Name: opUpdateContainerAgent,
  702. HTTPMethod: "POST",
  703. HTTPPath: "/",
  704. }
  705. if input == nil {
  706. input = &UpdateContainerAgentInput{}
  707. }
  708. req = c.newRequest(op, input, output)
  709. output = &UpdateContainerAgentOutput{}
  710. req.Data = output
  711. return
  712. }
  713. // Updates the Amazon ECS container agent on a specified container instance.
  714. // Updating the Amazon ECS container agent does not interrupt running tasks
  715. // or services on the container instance. The process for updating the agent
  716. // differs depending on whether your container instance was launched with the
  717. // Amazon ECS-optimized AMI or another operating system.
  718. //
  719. // UpdateContainerAgent requires the Amazon ECS-optimized AMI or Amazon Linux
  720. // with the ecs-init service installed and running. For help updating the Amazon
  721. // ECS container agent on other operating systems, see Manually Updating the
  722. // Amazon ECS Container Agent (http://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-agent-update.html#manually_update_agent)
  723. // in the Amazon EC2 Container Service Developer Guide.
  724. func (c *ECS) UpdateContainerAgent(input *UpdateContainerAgentInput) (*UpdateContainerAgentOutput, error) {
  725. req, out := c.UpdateContainerAgentRequest(input)
  726. err := req.Send()
  727. return out, err
  728. }
  729. const opUpdateService = "UpdateService"
  730. // UpdateServiceRequest generates a request for the UpdateService operation.
  731. func (c *ECS) UpdateServiceRequest(input *UpdateServiceInput) (req *request.Request, output *UpdateServiceOutput) {
  732. op := &request.Operation{
  733. Name: opUpdateService,
  734. HTTPMethod: "POST",
  735. HTTPPath: "/",
  736. }
  737. if input == nil {
  738. input = &UpdateServiceInput{}
  739. }
  740. req = c.newRequest(op, input, output)
  741. output = &UpdateServiceOutput{}
  742. req.Data = output
  743. return
  744. }
  745. // Modify the desired count or task definition used in a service.
  746. //
  747. // You can add to or subtract from the number of instantiations of a task definition
  748. // in a service by specifying the cluster that the service is running in and
  749. // a new desiredCount parameter.
  750. //
  751. // You can use UpdateService to modify your task definition and deploy a new
  752. // version of your service, one task at a time. If you modify the task definition
  753. // with UpdateService, Amazon ECS spawns a task with the new version of the
  754. // task definition and then stops an old task after the new version is running.
  755. // Because UpdateService starts a new version of the task before stopping an
  756. // old version, your cluster must have capacity to support one more instantiation
  757. // of the task when UpdateService is run. If your cluster cannot support another
  758. // instantiation of the task used in your service, you can reduce the desired
  759. // count of your service by one before modifying the task definition.
  760. func (c *ECS) UpdateService(input *UpdateServiceInput) (*UpdateServiceOutput, error) {
  761. req, out := c.UpdateServiceRequest(input)
  762. err := req.Send()
  763. return out, err
  764. }
  765. // A regional grouping of one or more container instances on which you can run
  766. // task requests. Each account receives a default cluster the first time you
  767. // use the Amazon ECS service, but you may also create other clusters. Clusters
  768. // may contain more than one instance type simultaneously.
  769. type Cluster struct {
  770. // The number of services that are running on the cluster in an ACTIVE state.
  771. // You can view these services with ListServices.
  772. ActiveServicesCount *int64 `locationName:"activeServicesCount" type:"integer"`
  773. // The Amazon Resource Name (ARN) that identifies the cluster. The ARN contains
  774. // the arn:aws:ecs namespace, followed by the region of the cluster, the AWS
  775. // account ID of the cluster owner, the cluster namespace, and then the cluster
  776. // name. For example, arn:aws:ecs:region:012345678910:cluster/test.
  777. ClusterArn *string `locationName:"clusterArn" type:"string"`
  778. // A user-generated string that you can use to identify your cluster.
  779. ClusterName *string `locationName:"clusterName" type:"string"`
  780. // The number of tasks in the cluster that are in the PENDING state.
  781. PendingTasksCount *int64 `locationName:"pendingTasksCount" type:"integer"`
  782. // The number of container instances registered into the cluster.
  783. RegisteredContainerInstancesCount *int64 `locationName:"registeredContainerInstancesCount" type:"integer"`
  784. // The number of tasks in the cluster that are in the RUNNING state.
  785. RunningTasksCount *int64 `locationName:"runningTasksCount" type:"integer"`
  786. // The status of the cluster. The valid values are ACTIVE or INACTIVE. ACTIVE
  787. // indicates that you can register container instances with the cluster and
  788. // the associated instances can accept tasks.
  789. Status *string `locationName:"status" type:"string"`
  790. metadataCluster `json:"-" xml:"-"`
  791. }
  792. type metadataCluster struct {
  793. SDKShapeTraits bool `type:"structure"`
  794. }
  795. // String returns the string representation
  796. func (s Cluster) String() string {
  797. return awsutil.Prettify(s)
  798. }
  799. // GoString returns the string representation
  800. func (s Cluster) GoString() string {
  801. return s.String()
  802. }
  803. // A docker container that is part of a task.
  804. type Container struct {
  805. // The Amazon Resource Name (ARN) of the container.
  806. ContainerArn *string `locationName:"containerArn" type:"string"`
  807. // The exit code returned from the container.
  808. ExitCode *int64 `locationName:"exitCode" type:"integer"`
  809. // The last known status of the container.
  810. LastStatus *string `locationName:"lastStatus" type:"string"`
  811. // The name of the container.
  812. Name *string `locationName:"name" type:"string"`
  813. // The network bindings associated with the container.
  814. NetworkBindings []*NetworkBinding `locationName:"networkBindings" type:"list"`
  815. // A short (255 max characters) human-readable string to provide additional
  816. // detail about a running or stopped container.
  817. Reason *string `locationName:"reason" type:"string"`
  818. // The Amazon Resource Name (ARN) of the task.
  819. TaskArn *string `locationName:"taskArn" type:"string"`
  820. metadataContainer `json:"-" xml:"-"`
  821. }
  822. type metadataContainer struct {
  823. SDKShapeTraits bool `type:"structure"`
  824. }
  825. // String returns the string representation
  826. func (s Container) String() string {
  827. return awsutil.Prettify(s)
  828. }
  829. // GoString returns the string representation
  830. func (s Container) GoString() string {
  831. return s.String()
  832. }
  833. // Container definitions are used in task definitions to describe the different
  834. // containers that are launched as part of a task.
  835. type ContainerDefinition struct {
  836. // The CMD that is passed to the container. For more information on the Docker
  837. // CMD parameter, see https://docs.docker.com/reference/builder/#cmd (https://docs.docker.com/reference/builder/#cmd).
  838. Command []*string `locationName:"command" type:"list"`
  839. // The number of cpu units reserved for the container. A container instance
  840. // has 1,024 cpu units for every CPU core. This parameter specifies the minimum
  841. // amount of CPU to reserve for a container, and containers share unallocated
  842. // CPU units with other containers on the instance with the same ratio as their
  843. // allocated amount.
  844. //
  845. // For example, if you run a single-container task on a single-core instance
  846. // type with 512 CPU units specified for that container, and that is the only
  847. // task running on the container instance, that container could use the full
  848. // 1,024 CPU unit share at any given time. However, if you launched another
  849. // copy of the same task on that container instance, each task would be guaranteed
  850. // a minimum of 512 CPU units when needed, and each container could float to
  851. // higher CPU usage if the other container was not using it, but if both tasks
  852. // were 100% active all of the time, they would be limited to 512 CPU units.
  853. //
  854. // The Docker daemon on the container instance uses the CPU value to calculate
  855. // the relative CPU share ratios for running containers. For more information,
  856. // see CPU share constraint (https://docs.docker.com/reference/run/#cpu-share-constraint)
  857. // in the Docker documentation. The minimum valid CPU share value that the Linux
  858. // kernel will allow is 2; however, the CPU parameter is not required, and you
  859. // can use CPU values below 2 in your container definitions. For CPU values
  860. // below 2 (including null), the behavior varies based on your Amazon ECS container
  861. // agent version:
  862. //
  863. // Agent versions less than or equal to 1.1.0: Null and zero CPU values are
  864. // passed to Docker as 0, which Docker then converts to 1,024 CPU shares. CPU
  865. // values of 1 are passed to Docker as 1, which the Linux kernel converts to
  866. // 2 CPU shares. Agent versions greater than or equal to 1.2.0: Null, zero,
  867. // and CPU values of 1 are passed to Docker as 2.
  868. Cpu *int64 `locationName:"cpu" type:"integer"`
  869. // Early versions of the Amazon ECS container agent do not properly handle entryPoint
  870. // parameters. If you have problems using entryPoint, update your container
  871. // agent or enter your commands and arguments as command array items instead.
  872. //
  873. // The ENTRYPOINT that is passed to the container. For more information on
  874. // the Docker ENTRYPOINT parameter, see https://docs.docker.com/reference/builder/#entrypoint
  875. // (https://docs.docker.com/reference/builder/#entrypoint).
  876. EntryPoint []*string `locationName:"entryPoint" type:"list"`
  877. // The environment variables to pass to a container.
  878. Environment []*KeyValuePair `locationName:"environment" type:"list"`
  879. // If the essential parameter of a container is marked as true, the failure
  880. // of that container will stop the task. If the essential parameter of a container
  881. // is marked as false, then its failure will not affect the rest of the containers
  882. // in a task. If this parameter is omitted, a container is assumed to be essential.
  883. //
  884. // All tasks must have at least one essential container.
  885. Essential *bool `locationName:"essential" type:"boolean"`
  886. // The image used to start a container. This string is passed directly to the
  887. // Docker daemon. Images in the Docker Hub registry are available by default.
  888. // Other repositories are specified with repository-url/image:tag.
  889. Image *string `locationName:"image" type:"string"`
  890. // The link parameter allows containers to communicate with each other without
  891. // the need for port mappings, using the name parameter. The name:internalName
  892. // construct is analogous to name:alias in Docker links. For more information
  893. // on linking Docker containers, see https://docs.docker.com/userguide/dockerlinks/
  894. // (https://docs.docker.com/userguide/dockerlinks/).
  895. //
  896. // Containers that are collocated on a single container instance may be able
  897. // to communicate with each other without requiring links or host port mappings.
  898. // Network isolation is achieved on the container instance using security groups
  899. // and VPC settings.
  900. Links []*string `locationName:"links" type:"list"`
  901. // The number of MiB of memory reserved for the container. If your container
  902. // attempts to exceed the memory allocated here, the container is killed.
  903. Memory *int64 `locationName:"memory" type:"integer"`
  904. // The mount points for data volumes in your container.
  905. MountPoints []*MountPoint `locationName:"mountPoints" type:"list"`
  906. // The name of a container. If you are linking multiple containers together
  907. // in a task definition, the name of one container can be entered in the links
  908. // of another container to connect the containers.
  909. Name *string `locationName:"name" type:"string"`
  910. // The list of port mappings for the container.
  911. PortMappings []*PortMapping `locationName:"portMappings" type:"list"`
  912. // Data volumes to mount from another container.
  913. VolumesFrom []*VolumeFrom `locationName:"volumesFrom" type:"list"`
  914. metadataContainerDefinition `json:"-" xml:"-"`
  915. }
  916. type metadataContainerDefinition struct {
  917. SDKShapeTraits bool `type:"structure"`
  918. }
  919. // String returns the string representation
  920. func (s ContainerDefinition) String() string {
  921. return awsutil.Prettify(s)
  922. }
  923. // GoString returns the string representation
  924. func (s ContainerDefinition) GoString() string {
  925. return s.String()
  926. }
  927. // An Amazon EC2 instance that is running the Amazon ECS agent and has been
  928. // registered with a cluster.
  929. type ContainerInstance struct {
  930. // This parameter returns true if the agent is actually connected to Amazon
  931. // ECS. Registered instances with an agent that may be unhealthy or stopped
  932. // will return false, and instances without a connected agent cannot accept
  933. // placement request.
  934. AgentConnected *bool `locationName:"agentConnected" type:"boolean"`
  935. // The status of the most recent agent update. If an update has never been requested,
  936. // this value is NULL.
  937. AgentUpdateStatus *string `locationName:"agentUpdateStatus" type:"string" enum:"AgentUpdateStatus"`
  938. // The Amazon Resource Name (ARN) of the container instance. The ARN contains
  939. // the arn:aws:ecs namespace, followed by the region of the container instance,
  940. // the AWS account ID of the container instance owner, the container-instance
  941. // namespace, and then the container instance UUID. For example, arn:aws:ecs:region:aws_account_id:container-instance/container_instance_UUID.
  942. ContainerInstanceArn *string `locationName:"containerInstanceArn" type:"string"`
  943. // The Amazon EC2 instance ID of the container instance.
  944. Ec2InstanceId *string `locationName:"ec2InstanceId" type:"string"`
  945. // The number of tasks on the container instance that are in the PENDING status.
  946. PendingTasksCount *int64 `locationName:"pendingTasksCount" type:"integer"`
  947. // The registered resources on the container instance that are in use by current
  948. // tasks.
  949. RegisteredResources []*Resource `locationName:"registeredResources" type:"list"`
  950. // The remaining resources of the container instance that are available for
  951. // new tasks.
  952. RemainingResources []*Resource `locationName:"remainingResources" type:"list"`
  953. // The number of tasks on the container instance that are in the RUNNING status.
  954. RunningTasksCount *int64 `locationName:"runningTasksCount" type:"integer"`
  955. // The status of the container instance. The valid values are ACTIVE or INACTIVE.
  956. // ACTIVE indicates that the container instance can accept tasks.
  957. Status *string `locationName:"status" type:"string"`
  958. // The version information for the Amazon ECS container agent and Docker daemon
  959. // running on the container instance.
  960. VersionInfo *VersionInfo `locationName:"versionInfo" type:"structure"`
  961. metadataContainerInstance `json:"-" xml:"-"`
  962. }
  963. type metadataContainerInstance struct {
  964. SDKShapeTraits bool `type:"structure"`
  965. }
  966. // String returns the string representation
  967. func (s ContainerInstance) String() string {
  968. return awsutil.Prettify(s)
  969. }
  970. // GoString returns the string representation
  971. func (s ContainerInstance) GoString() string {
  972. return s.String()
  973. }
  974. // The overrides that should be sent to a container.
  975. type ContainerOverride struct {
  976. // The command to send to the container that overrides the default command from
  977. // the Docker image or the task definition.
  978. Command []*string `locationName:"command" type:"list"`
  979. // The environment variables to send to the container. You can add new environment
  980. // variables, which are added to the container at launch, or you can override
  981. // the existing environment variables from the Docker image or the task definition.
  982. Environment []*KeyValuePair `locationName:"environment" type:"list"`
  983. // The name of the container that receives the override.
  984. Name *string `locationName:"name" type:"string"`
  985. metadataContainerOverride `json:"-" xml:"-"`
  986. }
  987. type metadataContainerOverride struct {
  988. SDKShapeTraits bool `type:"structure"`
  989. }
  990. // String returns the string representation
  991. func (s ContainerOverride) String() string {
  992. return awsutil.Prettify(s)
  993. }
  994. // GoString returns the string representation
  995. func (s ContainerOverride) GoString() string {
  996. return s.String()
  997. }
  998. type CreateClusterInput struct {
  999. // The name of your cluster. If you do not specify a name for your cluster,
  1000. // you will create a cluster named default. Up to 255 letters (uppercase and
  1001. // lowercase), numbers, hyphens, and underscores are allowed.
  1002. ClusterName *string `locationName:"clusterName" type:"string"`
  1003. metadataCreateClusterInput `json:"-" xml:"-"`
  1004. }
  1005. type metadataCreateClusterInput struct {
  1006. SDKShapeTraits bool `type:"structure"`
  1007. }
  1008. // String returns the string representation
  1009. func (s CreateClusterInput) String() string {
  1010. return awsutil.Prettify(s)
  1011. }
  1012. // GoString returns the string representation
  1013. func (s CreateClusterInput) GoString() string {
  1014. return s.String()
  1015. }
  1016. type CreateClusterOutput struct {
  1017. // The full description of your new cluster.
  1018. Cluster *Cluster `locationName:"cluster" type:"structure"`
  1019. metadataCreateClusterOutput `json:"-" xml:"-"`
  1020. }
  1021. type metadataCreateClusterOutput struct {
  1022. SDKShapeTraits bool `type:"structure"`
  1023. }
  1024. // String returns the string representation
  1025. func (s CreateClusterOutput) String() string {
  1026. return awsutil.Prettify(s)
  1027. }
  1028. // GoString returns the string representation
  1029. func (s CreateClusterOutput) GoString() string {
  1030. return s.String()
  1031. }
  1032. type CreateServiceInput struct {
  1033. // Unique, case-sensitive identifier you provide to ensure the idempotency of
  1034. // the request. Up to 32 ASCII characters are allowed.
  1035. ClientToken *string `locationName:"clientToken" type:"string"`
  1036. // The short name or full Amazon Resource Name (ARN) of the cluster that you
  1037. // want to run your service on. If you do not specify a cluster, the default
  1038. // cluster is assumed.
  1039. Cluster *string `locationName:"cluster" type:"string"`
  1040. // The number of instantiations of the specified task definition that you would
  1041. // like to place and keep running on your cluster.
  1042. DesiredCount *int64 `locationName:"desiredCount" type:"integer" required:"true"`
  1043. // A list of load balancer objects, containing the load balancer name, the container
  1044. // name (as it appears in a container definition), and the container port to
  1045. // access from the load balancer.
  1046. LoadBalancers []*LoadBalancer `locationName:"loadBalancers" type:"list"`
  1047. // The name or full Amazon Resource Name (ARN) of the IAM role that allows your
  1048. // Amazon ECS container agent to make calls to your load balancer on your behalf.
  1049. // This parameter is only required if you are using a load balancer with your
  1050. // service.
  1051. Role *string `locationName:"role" type:"string"`
  1052. // The name of your service. Up to 255 letters (uppercase and lowercase), numbers,
  1053. // hyphens, and underscores are allowed. Service names must be unique within
  1054. // a cluster, but you can have similarly named services in multiple clusters
  1055. // within a region or across multiple regions.
  1056. ServiceName *string `locationName:"serviceName" type:"string" required:"true"`
  1057. // The family and revision (family:revision) or full Amazon Resource Name (ARN)
  1058. // of the task definition that you want to run in your service. If a revision
  1059. // is not specified, the latest ACTIVE revision is used.
  1060. TaskDefinition *string `locationName:"taskDefinition" type:"string" required:"true"`
  1061. metadataCreateServiceInput `json:"-" xml:"-"`
  1062. }
  1063. type metadataCreateServiceInput struct {
  1064. SDKShapeTraits bool `type:"structure"`
  1065. }
  1066. // String returns the string representation
  1067. func (s CreateServiceInput) String() string {
  1068. return awsutil.Prettify(s)
  1069. }
  1070. // GoString returns the string representation
  1071. func (s CreateServiceInput) GoString() string {
  1072. return s.String()
  1073. }
  1074. type CreateServiceOutput struct {
  1075. // The full description of your service following the create call.
  1076. Service *Service `locationName:"service" type:"structure"`
  1077. metadataCreateServiceOutput `json:"-" xml:"-"`
  1078. }
  1079. type metadataCreateServiceOutput struct {
  1080. SDKShapeTraits bool `type:"structure"`
  1081. }
  1082. // String returns the string representation
  1083. func (s CreateServiceOutput) String() string {
  1084. return awsutil.Prettify(s)
  1085. }
  1086. // GoString returns the string representation
  1087. func (s CreateServiceOutput) GoString() string {
  1088. return s.String()
  1089. }
  1090. type DeleteClusterInput struct {
  1091. // The short name or full Amazon Resource Name (ARN) of the cluster that you
  1092. // want to delete.
  1093. Cluster *string `locationName:"cluster" type:"string" required:"true"`
  1094. metadataDeleteClusterInput `json:"-" xml:"-"`
  1095. }
  1096. type metadataDeleteClusterInput struct {
  1097. SDKShapeTraits bool `type:"structure"`
  1098. }
  1099. // String returns the string representation
  1100. func (s DeleteClusterInput) String() string {
  1101. return awsutil.Prettify(s)
  1102. }
  1103. // GoString returns the string representation
  1104. func (s DeleteClusterInput) GoString() string {
  1105. return s.String()
  1106. }
  1107. type DeleteClusterOutput struct {
  1108. // The full description of the deleted cluster.
  1109. Cluster *Cluster `locationName:"cluster" type:"structure"`
  1110. metadataDeleteClusterOutput `json:"-" xml:"-"`
  1111. }
  1112. type metadataDeleteClusterOutput struct {
  1113. SDKShapeTraits bool `type:"structure"`
  1114. }
  1115. // String returns the string representation
  1116. func (s DeleteClusterOutput) String() string {
  1117. return awsutil.Prettify(s)
  1118. }
  1119. // GoString returns the string representation
  1120. func (s DeleteClusterOutput) GoString() string {
  1121. return s.String()
  1122. }
  1123. type DeleteServiceInput struct {
  1124. // The name of the cluster that hosts the service you want to delete.
  1125. Cluster *string `locationName:"cluster" type:"string"`
  1126. // The name of the service you want to delete.
  1127. Service *string `locationName:"service" type:"string" required:"true"`
  1128. metadataDeleteServiceInput `json:"-" xml:"-"`
  1129. }
  1130. type metadataDeleteServiceInput struct {
  1131. SDKShapeTraits bool `type:"structure"`
  1132. }
  1133. // String returns the string representation
  1134. func (s DeleteServiceInput) String() string {
  1135. return awsutil.Prettify(s)
  1136. }
  1137. // GoString returns the string representation
  1138. func (s DeleteServiceInput) GoString() string {
  1139. return s.String()
  1140. }
  1141. type DeleteServiceOutput struct {
  1142. // Details on a service within a cluster
  1143. Service *Service `locationName:"service" type:"structure"`
  1144. metadataDeleteServiceOutput `json:"-" xml:"-"`
  1145. }
  1146. type metadataDeleteServiceOutput struct {
  1147. SDKShapeTraits bool `type:"structure"`
  1148. }
  1149. // String returns the string representation
  1150. func (s DeleteServiceOutput) String() string {
  1151. return awsutil.Prettify(s)
  1152. }
  1153. // GoString returns the string representation
  1154. func (s DeleteServiceOutput) GoString() string {
  1155. return s.String()
  1156. }
  1157. // The details of an Amazon ECS service deployment.
  1158. type Deployment struct {
  1159. // The Unix time in seconds and milliseconds when the service was created.
  1160. CreatedAt *time.Time `locationName:"createdAt" type:"timestamp" timestampFormat:"unix"`
  1161. // The most recent desired count of tasks that was specified for the service
  1162. // to deploy and/or maintain.
  1163. DesiredCount *int64 `locationName:"desiredCount" type:"integer"`
  1164. // The ID of the deployment.
  1165. Id *string `locationName:"id" type:"string"`
  1166. // The number of tasks in the deployment that are in the PENDING status.
  1167. PendingCount *int64 `locationName:"pendingCount" type:"integer"`
  1168. // The number of tasks in the deployment that are in the RUNNING status.
  1169. RunningCount *int64 `locationName:"runningCount" type:"integer"`
  1170. // The status of the deployment. Valid values are PRIMARY (for the most recent
  1171. // deployment), ACTIVE (for previous deployments that still have tasks running,
  1172. // but are being replaced with the PRIMARY deployment), and INACTIVE (for deployments
  1173. // that have been completely replaced).
  1174. Status *string `locationName:"status" type:"string"`
  1175. // The most recent task definition that was specified for the service to use.
  1176. TaskDefinition *string `locationName:"taskDefinition" type:"string"`
  1177. // The Unix time in seconds and milliseconds when the service was last updated.
  1178. UpdatedAt *time.Time `locationName:"updatedAt" type:"timestamp" timestampFormat:"unix"`
  1179. metadataDeployment `json:"-" xml:"-"`
  1180. }
  1181. type metadataDeployment struct {
  1182. SDKShapeTraits bool `type:"structure"`
  1183. }
  1184. // String returns the string representation
  1185. func (s Deployment) String() string {
  1186. return awsutil.Prettify(s)
  1187. }
  1188. // GoString returns the string representation
  1189. func (s Deployment) GoString() string {
  1190. return s.String()
  1191. }
  1192. type DeregisterContainerInstanceInput struct {
  1193. // The short name or full Amazon Resource Name (ARN) of the cluster that hosts
  1194. // the container instance you want to deregister. If you do not specify a cluster,
  1195. // the default cluster is assumed.
  1196. Cluster *string `locationName:"cluster" type:"string"`
  1197. // The container instance UUID or full Amazon Resource Name (ARN) of the container
  1198. // instance you want to deregister. The ARN contains the arn:aws:ecs namespace,
  1199. // followed by the region of the container instance, the AWS account ID of the
  1200. // container instance owner, the container-instance namespace, and then the
  1201. // container instance UUID. For example, arn:aws:ecs:region:aws_account_id:container-instance/container_instance_UUID.
  1202. ContainerInstance *string `locationName:"containerInstance" type:"string" required:"true"`
  1203. // Force the deregistration of the container instance. If you have tasks running
  1204. // on the container instance when you deregister it with the force option, these
  1205. // tasks remain running and they will continue to pass Elastic Load Balancing
  1206. // load balancer health checks until you terminate the instance or the tasks
  1207. // stop through some other means, but they are orphaned (no longer monitored
  1208. // or accounted for by Amazon ECS). If an orphaned task on your container instance
  1209. // is part of an Amazon ECS service, then the service scheduler will start another
  1210. // copy of that task on a different container instance if possible.
  1211. Force *bool `locationName:"force" type:"boolean"`
  1212. metadataDeregisterContainerInstanceInput `json:"-" xml:"-"`
  1213. }
  1214. type metadataDeregisterContainerInstanceInput struct {
  1215. SDKShapeTraits bool `type:"structure"`
  1216. }
  1217. // String returns the string representation
  1218. func (s DeregisterContainerInstanceInput) String() string {
  1219. return awsutil.Prettify(s)
  1220. }
  1221. // GoString returns the string representation
  1222. func (s DeregisterContainerInstanceInput) GoString() string {
  1223. return s.String()
  1224. }
  1225. type DeregisterContainerInstanceOutput struct {
  1226. // An Amazon EC2 instance that is running the Amazon ECS agent and has been
  1227. // registered with a cluster.
  1228. ContainerInstance *ContainerInstance `locationName:"containerInstance" type:"structure"`
  1229. metadataDeregisterContainerInstanceOutput `json:"-" xml:"-"`
  1230. }
  1231. type metadataDeregisterContainerInstanceOutput struct {
  1232. SDKShapeTraits bool `type:"structure"`
  1233. }
  1234. // String returns the string representation
  1235. func (s DeregisterContainerInstanceOutput) String() string {
  1236. return awsutil.Prettify(s)
  1237. }
  1238. // GoString returns the string representation
  1239. func (s DeregisterContainerInstanceOutput) GoString() string {
  1240. return s.String()
  1241. }
  1242. type DeregisterTaskDefinitionInput struct {
  1243. // The family and revision (family:revision) or full Amazon Resource Name (ARN)
  1244. // of the task definition that you want to deregister. You must specify a revision.
  1245. TaskDefinition *string `locationName:"taskDefinition" type:"string" required:"true"`
  1246. metadataDeregisterTaskDefinitionInput `json:"-" xml:"-"`
  1247. }
  1248. type metadataDeregisterTaskDefinitionInput struct {
  1249. SDKShapeTraits bool `type:"structure"`
  1250. }
  1251. // String returns the string representation
  1252. func (s DeregisterTaskDefinitionInput) String() string {
  1253. return awsutil.Prettify(s)
  1254. }
  1255. // GoString returns the string representation
  1256. func (s DeregisterTaskDefinitionInput) GoString() string {
  1257. return s.String()
  1258. }
  1259. type DeregisterTaskDefinitionOutput struct {
  1260. // The full description of the deregistered task.
  1261. TaskDefinition *TaskDefinition `locationName:"taskDefinition" type:"structure"`
  1262. metadataDeregisterTaskDefinitionOutput `json:"-" xml:"-"`
  1263. }
  1264. type metadataDeregisterTaskDefinitionOutput struct {
  1265. SDKShapeTraits bool `type:"structure"`
  1266. }
  1267. // String returns the string representation
  1268. func (s DeregisterTaskDefinitionOutput) String() string {
  1269. return awsutil.Prettify(s)
  1270. }
  1271. // GoString returns the string representation
  1272. func (s DeregisterTaskDefinitionOutput) GoString() string {
  1273. return s.String()
  1274. }
  1275. type DescribeClustersInput struct {
  1276. // A space-separated list of cluster names or full cluster Amazon Resource Name
  1277. // (ARN) entries. If you do not specify a cluster, the default cluster is assumed.
  1278. Clusters []*string `locationName:"clusters" type:"list"`
  1279. metadataDescribeClustersInput `json:"-" xml:"-"`
  1280. }
  1281. type metadataDescribeClustersInput struct {
  1282. SDKShapeTraits bool `type:"structure"`
  1283. }
  1284. // String returns the string representation
  1285. func (s DescribeClustersInput) String() string {
  1286. return awsutil.Prettify(s)
  1287. }
  1288. // GoString returns the string representation
  1289. func (s DescribeClustersInput) GoString() string {
  1290. return s.String()
  1291. }
  1292. type DescribeClustersOutput struct {
  1293. // The list of clusters.
  1294. Clusters []*Cluster `locationName:"clusters" type:"list"`
  1295. Failures []*Failure `locationName:"failures" type:"list"`
  1296. metadataDescribeClustersOutput `json:"-" xml:"-"`
  1297. }
  1298. type metadataDescribeClustersOutput struct {
  1299. SDKShapeTraits bool `type:"structure"`
  1300. }
  1301. // String returns the string representation
  1302. func (s DescribeClustersOutput) String() string {
  1303. return awsutil.Prettify(s)
  1304. }
  1305. // GoString returns the string representation
  1306. func (s DescribeClustersOutput) GoString() string {
  1307. return s.String()
  1308. }
  1309. type DescribeContainerInstancesInput struct {
  1310. // The short name or full Amazon Resource Name (ARN) of the cluster that hosts
  1311. // the container instances you want to describe. If you do not specify a cluster,
  1312. // the default cluster is assumed.
  1313. Cluster *string `locationName:"cluster" type:"string"`
  1314. // A space-separated list of container instance UUIDs or full Amazon Resource
  1315. // Name (ARN) entries.
  1316. ContainerInstances []*string `locationName:"containerInstances" type:"list" required:"true"`
  1317. metadataDescribeContainerInstancesInput `json:"-" xml:"-"`
  1318. }
  1319. type metadataDescribeContainerInstancesInput struct {
  1320. SDKShapeTraits bool `type:"structure"`
  1321. }
  1322. // String returns the string representation
  1323. func (s DescribeContainerInstancesInput) String() string {
  1324. return awsutil.Prettify(s)
  1325. }
  1326. // GoString returns the string representation
  1327. func (s DescribeContainerInstancesInput) GoString() string {
  1328. return s.String()
  1329. }
  1330. type DescribeContainerInstancesOutput struct {
  1331. // The list of container instances.
  1332. ContainerInstances []*ContainerInstance `locationName:"containerInstances" type:"list"`
  1333. Failures []*Failure `locationName:"failures" type:"list"`
  1334. metadataDescribeContainerInstancesOutput `json:"-" xml:"-"`
  1335. }
  1336. type metadataDescribeContainerInstancesOutput struct {
  1337. SDKShapeTraits bool `type:"structure"`
  1338. }
  1339. // String returns the string representation
  1340. func (s DescribeContainerInstancesOutput) String() string {
  1341. return awsutil.Prettify(s)
  1342. }
  1343. // GoString returns the string representation
  1344. func (s DescribeContainerInstancesOutput) GoString() string {
  1345. return s.String()
  1346. }
  1347. type DescribeServicesInput struct {
  1348. // The name of the cluster that hosts the service you want to describe.
  1349. Cluster *string `locationName:"cluster" type:"string"`
  1350. // A list of services you want to describe.
  1351. Services []*string `locationName:"services" type:"list" required:"true"`
  1352. metadataDescribeServicesInput `json:"-" xml:"-"`
  1353. }
  1354. type metadataDescribeServicesInput struct {
  1355. SDKShapeTraits bool `type:"structure"`
  1356. }
  1357. // String returns the string representation
  1358. func (s DescribeServicesInput) String() string {
  1359. return awsutil.Prettify(s)
  1360. }
  1361. // GoString returns the string representation
  1362. func (s DescribeServicesInput) GoString() string {
  1363. return s.String()
  1364. }
  1365. type DescribeServicesOutput struct {
  1366. // Any failures associated with the call.
  1367. Failures []*Failure `locationName:"failures" type:"list"`
  1368. // The list of services described.
  1369. Services []*Service `locationName:"services" type:"list"`
  1370. metadataDescribeServicesOutput `json:"-" xml:"-"`
  1371. }
  1372. type metadataDescribeServicesOutput struct {
  1373. SDKShapeTraits bool `type:"structure"`
  1374. }
  1375. // String returns the string representation
  1376. func (s DescribeServicesOutput) String() string {
  1377. return awsutil.Prettify(s)
  1378. }
  1379. // GoString returns the string representation
  1380. func (s DescribeServicesOutput) GoString() string {
  1381. return s.String()
  1382. }
  1383. type DescribeTaskDefinitionInput struct {
  1384. // The family for the latest ACTIVE revision, family and revision (family:revision)
  1385. // for a specific revision in the family, or full Amazon Resource Name (ARN)
  1386. // of the task definition that you want to describe.
  1387. TaskDefinition *string `locationName:"taskDefinition" type:"string" required:"true"`
  1388. metadataDescribeTaskDefinitionInput `json:"-" xml:"-"`
  1389. }
  1390. type metadataDescribeTaskDefinitionInput struct {
  1391. SDKShapeTraits bool `type:"structure"`
  1392. }
  1393. // String returns the string representation
  1394. func (s DescribeTaskDefinitionInput) String() string {
  1395. return awsutil.Prettify(s)
  1396. }
  1397. // GoString returns the string representation
  1398. func (s DescribeTaskDefinitionInput) GoString() string {
  1399. return s.String()
  1400. }
  1401. type DescribeTaskDefinitionOutput struct {
  1402. // The full task definition description.
  1403. TaskDefinition *TaskDefinition `locationName:"taskDefinition" type:"structure"`
  1404. metadataDescribeTaskDefinitionOutput `json:"-" xml:"-"`
  1405. }
  1406. type metadataDescribeTaskDefinitionOutput struct {
  1407. SDKShapeTraits bool `type:"structure"`
  1408. }
  1409. // String returns the string representation
  1410. func (s DescribeTaskDefinitionOutput) String() string {
  1411. return awsutil.Prettify(s)
  1412. }
  1413. // GoString returns the string representation
  1414. func (s DescribeTaskDefinitionOutput) GoString() string {
  1415. return s.String()
  1416. }
  1417. type DescribeTasksInput struct {
  1418. // The short name or full Amazon Resource Name (ARN) of the cluster that hosts
  1419. // the task you want to describe. If you do not specify a cluster, the default
  1420. // cluster is assumed.
  1421. Cluster *string `locationName:"cluster" type:"string"`
  1422. // A space-separated list of task UUIDs or full Amazon Resource Name (ARN) entries.
  1423. Tasks []*string `locationName:"tasks" type:"list" required:"true"`
  1424. metadataDescribeTasksInput `json:"-" xml:"-"`
  1425. }
  1426. type metadataDescribeTasksInput struct {
  1427. SDKShapeTraits bool `type:"structure"`
  1428. }
  1429. // String returns the string representation
  1430. func (s DescribeTasksInput) String() string {
  1431. return awsutil.Prettify(s)
  1432. }
  1433. // GoString returns the string representation
  1434. func (s DescribeTasksInput) GoString() string {
  1435. return s.String()
  1436. }
  1437. type DescribeTasksOutput struct {
  1438. Failures []*Failure `locationName:"failures" type:"list"`
  1439. // The list of tasks.
  1440. Tasks []*Task `locationName:"tasks" type:"list"`
  1441. metadataDescribeTasksOutput `json:"-" xml:"-"`
  1442. }
  1443. type metadataDescribeTasksOutput struct {
  1444. SDKShapeTraits bool `type:"structure"`
  1445. }
  1446. // String returns the string representation
  1447. func (s DescribeTasksOutput) String() string {
  1448. return awsutil.Prettify(s)
  1449. }
  1450. // GoString returns the string representation
  1451. func (s DescribeTasksOutput) GoString() string {
  1452. return s.String()
  1453. }
  1454. type DiscoverPollEndpointInput struct {
  1455. // The cluster that the container instance belongs to.
  1456. Cluster *string `locationName:"cluster" type:"string"`
  1457. // The container instance UUID or full Amazon Resource Name (ARN) of the container
  1458. // instance. The ARN contains the arn:aws:ecs namespace, followed by the region
  1459. // of the container instance, the AWS account ID of the container instance owner,
  1460. // the container-instance namespace, and then the container instance UUID. For
  1461. // example, arn:aws:ecs:region:aws_account_id:container-instance/container_instance_UUID.
  1462. ContainerInstance *string `locationName:"containerInstance" type:"string"`
  1463. metadataDiscoverPollEndpointInput `json:"-" xml:"-"`
  1464. }
  1465. type metadataDiscoverPollEndpointInput struct {
  1466. SDKShapeTraits bool `type:"structure"`
  1467. }
  1468. // String returns the string representation
  1469. func (s DiscoverPollEndpointInput) String() string {
  1470. return awsutil.Prettify(s)
  1471. }
  1472. // GoString returns the string representation
  1473. func (s DiscoverPollEndpointInput) GoString() string {
  1474. return s.String()
  1475. }
  1476. type DiscoverPollEndpointOutput struct {
  1477. // The endpoint for the Amazon ECS agent to poll.
  1478. Endpoint *string `locationName:"endpoint" type:"string"`
  1479. // The telemetry endpoint for the Amazon ECS agent.
  1480. TelemetryEndpoint *string `locationName:"telemetryEndpoint" type:"string"`
  1481. metadataDiscoverPollEndpointOutput `json:"-" xml:"-"`
  1482. }
  1483. type metadataDiscoverPollEndpointOutput struct {
  1484. SDKShapeTraits bool `type:"structure"`
  1485. }
  1486. // String returns the string representation
  1487. func (s DiscoverPollEndpointOutput) String() string {
  1488. return awsutil.Prettify(s)
  1489. }
  1490. // GoString returns the string representation
  1491. func (s DiscoverPollEndpointOutput) GoString() string {
  1492. return s.String()
  1493. }
  1494. // A failed resource.
  1495. type Failure struct {
  1496. // The Amazon Resource Name (ARN) of the failed resource.
  1497. Arn *string `locationName:"arn" type:"string"`
  1498. // The reason for the failure.
  1499. Reason *string `locationName:"reason" type:"string"`
  1500. metadataFailure `json:"-" xml:"-"`
  1501. }
  1502. type metadataFailure struct {
  1503. SDKShapeTraits bool `type:"structure"`
  1504. }
  1505. // String returns the string representation
  1506. func (s Failure) String() string {
  1507. return awsutil.Prettify(s)
  1508. }
  1509. // GoString returns the string representation
  1510. func (s Failure) GoString() string {
  1511. return s.String()
  1512. }
  1513. // Details on a container instance host volume.
  1514. type HostVolumeProperties struct {
  1515. // The path on the host container instance that is presented to the container.
  1516. // If this parameter is empty, then the Docker daemon has assigned a host path
  1517. // for you.
  1518. SourcePath *string `locationName:"sourcePath" type:"string"`
  1519. metadataHostVolumeProperties `json:"-" xml:"-"`
  1520. }
  1521. type metadataHostVolumeProperties struct {
  1522. SDKShapeTraits bool `type:"structure"`
  1523. }
  1524. // String returns the string representation
  1525. func (s HostVolumeProperties) String() string {
  1526. return awsutil.Prettify(s)
  1527. }
  1528. // GoString returns the string representation
  1529. func (s HostVolumeProperties) GoString() string {
  1530. return s.String()
  1531. }
  1532. // A key and value pair object.
  1533. type KeyValuePair struct {
  1534. // The name of the key value pair. For environment variables, this is the name
  1535. // of the environment variable.
  1536. Name *string `locationName:"name" type:"string"`
  1537. // The value of the key value pair. For environment variables, this is the value
  1538. // of the environment variable.
  1539. Value *string `locationName:"value" type:"string"`
  1540. metadataKeyValuePair `json:"-" xml:"-"`
  1541. }
  1542. type metadataKeyValuePair struct {
  1543. SDKShapeTraits bool `type:"structure"`
  1544. }
  1545. // String returns the string representation
  1546. func (s KeyValuePair) String() string {
  1547. return awsutil.Prettify(s)
  1548. }
  1549. // GoString returns the string representation
  1550. func (s KeyValuePair) GoString() string {
  1551. return s.String()
  1552. }
  1553. type ListClustersInput struct {
  1554. // The maximum number of cluster results returned by ListClusters in paginated
  1555. // output. When this parameter is used, ListClusters only returns maxResults
  1556. // results in a single page along with a nextToken response element. The remaining
  1557. // results of the initial request can be seen by sending another ListClusters
  1558. // request with the returned nextToken value. This value can be between 1 and
  1559. // 100. If this parameter is not used, then ListClusters returns up to 100 results
  1560. // and a nextToken value if applicable.
  1561. MaxResults *int64 `locationName:"maxResults" type:"integer"`
  1562. // The nextToken value returned from a previous paginated ListClusters request
  1563. // where maxResults was used and the results exceeded the value of that parameter.
  1564. // Pagination continues from the end of the previous results that returned the
  1565. // nextToken value. This value is null when there are no more results to return.
  1566. NextToken *string `locationName:"nextToken" type:"string"`
  1567. metadataListClustersInput `json:"-" xml:"-"`
  1568. }
  1569. type metadataListClustersInput struct {
  1570. SDKShapeTraits bool `type:"structure"`
  1571. }
  1572. // String returns the string representation
  1573. func (s ListClustersInput) String() string {
  1574. return awsutil.Prettify(s)
  1575. }
  1576. // GoString returns the string representation
  1577. func (s ListClustersInput) GoString() string {
  1578. return s.String()
  1579. }
  1580. type ListClustersOutput struct {
  1581. // The list of full Amazon Resource Name (ARN) entries for each cluster associated
  1582. // with your account.
  1583. ClusterArns []*string `locationName:"clusterArns" type:"list"`
  1584. // The nextToken value to include in a future ListClusters request. When the
  1585. // results of a ListClusters request exceed maxResults, this value can be used
  1586. // to retrieve the next page of results. This value is null when there are no
  1587. // more results to return.
  1588. NextToken *string `locationName:"nextToken" type:"string"`
  1589. metadataListClustersOutput `json:"-" xml:"-"`
  1590. }
  1591. type metadataListClustersOutput struct {
  1592. SDKShapeTraits bool `type:"structure"`
  1593. }
  1594. // String returns the string representation
  1595. func (s ListClustersOutput) String() string {
  1596. return awsutil.Prettify(s)
  1597. }
  1598. // GoString returns the string representation
  1599. func (s ListClustersOutput) GoString() string {
  1600. return s.String()
  1601. }
  1602. type ListContainerInstancesInput struct {
  1603. // The short name or full Amazon Resource Name (ARN) of the cluster that hosts
  1604. // the container instances you want to list. If you do not specify a cluster,
  1605. // the default cluster is assumed..
  1606. Cluster *string `locationName:"cluster" type:"string"`
  1607. // The maximum number of container instance results returned by ListContainerInstances
  1608. // in paginated output. When this parameter is used, ListContainerInstances
  1609. // only returns maxResults results in a single page along with a nextToken response
  1610. // element. The remaining results of the initial request can be seen by sending
  1611. // another ListContainerInstances request with the returned nextToken value.
  1612. // This value can be between 1 and 100. If this parameter is not used, then
  1613. // ListContainerInstances returns up to 100 results and a nextToken value if
  1614. // applicable.
  1615. MaxResults *int64 `locationName:"maxResults" type:"integer"`
  1616. // The nextToken value returned from a previous paginated ListContainerInstances
  1617. // request where maxResults was used and the results exceeded the value of that
  1618. // parameter. Pagination continues from the end of the previous results that
  1619. // returned the nextToken value. This value is null when there are no more results
  1620. // to return.
  1621. NextToken *string `locationName:"nextToken" type:"string"`
  1622. metadataListContainerInstancesInput `json:"-" xml:"-"`
  1623. }
  1624. type metadataListContainerInstancesInput struct {
  1625. SDKShapeTraits bool `type:"structure"`
  1626. }
  1627. // String returns the string representation
  1628. func (s ListContainerInstancesInput) String() string {
  1629. return awsutil.Prettify(s)
  1630. }
  1631. // GoString returns the string representation
  1632. func (s ListContainerInstancesInput) GoString() string {
  1633. return s.String()
  1634. }
  1635. type ListContainerInstancesOutput struct {
  1636. // The list of container instance full Amazon Resource Name (ARN) entries for
  1637. // each container instance associated with the specified cluster.
  1638. ContainerInstanceArns []*string `locationName:"containerInstanceArns" type:"list"`
  1639. // The nextToken value to include in a future ListContainerInstances request.
  1640. // When the results of a ListContainerInstances request exceed maxResults, this
  1641. // value can be used to retrieve the next page of results. This value is null
  1642. // when there are no more results to return.
  1643. NextToken *string `locationName:"nextToken" type:"string"`
  1644. metadataListContainerInstancesOutput `json:"-" xml:"-"`
  1645. }
  1646. type metadataListContainerInstancesOutput struct {
  1647. SDKShapeTraits bool `type:"structure"`
  1648. }
  1649. // String returns the string representation
  1650. func (s ListContainerInstancesOutput) String() string {
  1651. return awsutil.Prettify(s)
  1652. }
  1653. // GoString returns the string representation
  1654. func (s ListContainerInstancesOutput) GoString() string {
  1655. return s.String()
  1656. }
  1657. type ListServicesInput struct {
  1658. // The short name or full Amazon Resource Name (ARN) of the cluster that hosts
  1659. // the services you want to list. If you do not specify a cluster, the default
  1660. // cluster is assumed..
  1661. Cluster *string `locationName:"cluster" type:"string"`
  1662. // The maximum number of container instance results returned by ListServices
  1663. // in paginated output. When this parameter is used, ListServices only returns
  1664. // maxResults results in a single page along with a nextToken response element.
  1665. // The remaining results of the initial request can be seen by sending another
  1666. // ListServices request with the returned nextToken value. This value can be
  1667. // between 1 and 100. If this parameter is not used, then ListServices returns
  1668. // up to 100 results and a nextToken value if applicable.
  1669. MaxResults *int64 `locationName:"maxResults" type:"integer"`
  1670. // The nextToken value returned from a previous paginated ListServices request
  1671. // where maxResults was used and the results exceeded the value of that parameter.
  1672. // Pagination continues from the end of the previous results that returned the
  1673. // nextToken value. This value is null when there are no more results to return.
  1674. NextToken *string `locationName:"nextToken" type:"string"`
  1675. metadataListServicesInput `json:"-" xml:"-"`
  1676. }
  1677. type metadataListServicesInput struct {
  1678. SDKShapeTraits bool `type:"structure"`
  1679. }
  1680. // String returns the string representation
  1681. func (s ListServicesInput) String() string {
  1682. return awsutil.Prettify(s)
  1683. }
  1684. // GoString returns the string representation
  1685. func (s ListServicesInput) GoString() string {
  1686. return s.String()
  1687. }
  1688. type ListServicesOutput struct {
  1689. // The nextToken value to include in a future ListServices request. When the
  1690. // results of a ListServices request exceed maxResults, this value can be used
  1691. // to retrieve the next page of results. This value is null when there are no
  1692. // more results to return.
  1693. NextToken *string `locationName:"nextToken" type:"string"`
  1694. // The list of full Amazon Resource Name (ARN) entries for each service associated
  1695. // with the specified cluster.
  1696. ServiceArns []*string `locationName:"serviceArns" type:"list"`
  1697. metadataListServicesOutput `json:"-" xml:"-"`
  1698. }
  1699. type metadataListServicesOutput struct {
  1700. SDKShapeTraits bool `type:"structure"`
  1701. }
  1702. // String returns the string representation
  1703. func (s ListServicesOutput) String() string {
  1704. return awsutil.Prettify(s)
  1705. }
  1706. // GoString returns the string representation
  1707. func (s ListServicesOutput) GoString() string {
  1708. return s.String()
  1709. }
  1710. type ListTaskDefinitionFamiliesInput struct {
  1711. // The familyPrefix is a string that is used to filter the results of ListTaskDefinitionFamilies.
  1712. // If you specify a familyPrefix, only task definition family names that begin
  1713. // with the familyPrefix string are returned.
  1714. FamilyPrefix *string `locationName:"familyPrefix" type:"string"`
  1715. // The maximum number of task definition family results returned by ListTaskDefinitionFamilies
  1716. // in paginated output. When this parameter is used, ListTaskDefinitions only
  1717. // returns maxResults results in a single page along with a nextToken response
  1718. // element. The remaining results of the initial request can be seen by sending
  1719. // another ListTaskDefinitionFamilies request with the returned nextToken value.
  1720. // This value can be between 1 and 100. If this parameter is not used, then
  1721. // ListTaskDefinitionFamilies returns up to 100 results and a nextToken value
  1722. // if applicable.
  1723. MaxResults *int64 `locationName:"maxResults" type:"integer"`
  1724. // The nextToken value returned from a previous paginated ListTaskDefinitionFamilies
  1725. // request where maxResults was used and the results exceeded the value of that
  1726. // parameter. Pagination continues from the end of the previous results that
  1727. // returned the nextToken value. This value is null when there are no more results
  1728. // to return.
  1729. NextToken *string `locationName:"nextToken" type:"string"`
  1730. metadataListTaskDefinitionFamiliesInput `json:"-" xml:"-"`
  1731. }
  1732. type metadataListTaskDefinitionFamiliesInput struct {
  1733. SDKShapeTraits bool `type:"structure"`
  1734. }
  1735. // String returns the string representation
  1736. func (s ListTaskDefinitionFamiliesInput) String() string {
  1737. return awsutil.Prettify(s)
  1738. }
  1739. // GoString returns the string representation
  1740. func (s ListTaskDefinitionFamiliesInput) GoString() string {
  1741. return s.String()
  1742. }
  1743. type ListTaskDefinitionFamiliesOutput struct {
  1744. // The list of task definition family names that match the ListTaskDefinitionFamilies
  1745. // request.
  1746. Families []*string `locationName:"families" type:"list"`
  1747. // The nextToken value to include in a future ListTaskDefinitionFamilies request.
  1748. // When the results of a ListTaskDefinitionFamilies request exceed maxResults,
  1749. // this value can be used to retrieve the next page of results. This value is
  1750. // null when there are no more results to return.
  1751. NextToken *string `locationName:"nextToken" type:"string"`
  1752. metadataListTaskDefinitionFamiliesOutput `json:"-" xml:"-"`
  1753. }
  1754. type metadataListTaskDefinitionFamiliesOutput struct {
  1755. SDKShapeTraits bool `type:"structure"`
  1756. }
  1757. // String returns the string representation
  1758. func (s ListTaskDefinitionFamiliesOutput) String() string {
  1759. return awsutil.Prettify(s)
  1760. }
  1761. // GoString returns the string representation
  1762. func (s ListTaskDefinitionFamiliesOutput) GoString() string {
  1763. return s.String()
  1764. }
  1765. type ListTaskDefinitionsInput struct {
  1766. // The full family name that you want to filter the ListTaskDefinitions results
  1767. // with. Specifying a familyPrefix will limit the listed task definitions to
  1768. // task definition revisions that belong to that family.
  1769. FamilyPrefix *string `locationName:"familyPrefix" type:"string"`
  1770. // The maximum number of task definition results returned by ListTaskDefinitions
  1771. // in paginated output. When this parameter is used, ListTaskDefinitions only
  1772. // returns maxResults results in a single page along with a nextToken response
  1773. // element. The remaining results of the initial request can be seen by sending
  1774. // another ListTaskDefinitions request with the returned nextToken value. This
  1775. // value can be between 1 and 100. If this parameter is not used, then ListTaskDefinitions
  1776. // returns up to 100 results and a nextToken value if applicable.
  1777. MaxResults *int64 `locationName:"maxResults" type:"integer"`
  1778. // The nextToken value returned from a previous paginated ListTaskDefinitions
  1779. // request where maxResults was used and the results exceeded the value of that
  1780. // parameter. Pagination continues from the end of the previous results that
  1781. // returned the nextToken value. This value is null when there are no more results
  1782. // to return.
  1783. NextToken *string `locationName:"nextToken" type:"string"`
  1784. // The order in which to sort the results. Valid values are ASC and DESC. By
  1785. // default (ASC), task definitions are listed lexicographically by family name
  1786. // and in ascending numerical order by revision so that the newest task definitions
  1787. // in a family are listed last. Setting this parameter to DESC reverses the
  1788. // sort order on family name and revision so that the newest task definitions
  1789. // in a family are listed first.
  1790. Sort *string `locationName:"sort" type:"string" enum:"SortOrder"`
  1791. // The task definition status that you want to filter the ListTaskDefinitions
  1792. // results with. By default, only ACTIVE task definitions are listed. By setting
  1793. // this parameter to INACTIVE, you can view task definitions that are INACTIVE
  1794. // as long as an active task or service still references them. If you paginate
  1795. // the resulting output, be sure to keep the status value constant in each subsequent
  1796. // request.
  1797. Status *string `locationName:"status" type:"string" enum:"TaskDefinitionStatus"`
  1798. metadataListTaskDefinitionsInput `json:"-" xml:"-"`
  1799. }
  1800. type metadataListTaskDefinitionsInput struct {
  1801. SDKShapeTraits bool `type:"structure"`
  1802. }
  1803. // String returns the string representation
  1804. func (s ListTaskDefinitionsInput) String() string {
  1805. return awsutil.Prettify(s)
  1806. }
  1807. // GoString returns the string representation
  1808. func (s ListTaskDefinitionsInput) GoString() string {
  1809. return s.String()
  1810. }
  1811. type ListTaskDefinitionsOutput struct {
  1812. // The nextToken value to include in a future ListTaskDefinitions request. When
  1813. // the results of a ListTaskDefinitions request exceed maxResults, this value
  1814. // can be used to retrieve the next page of results. This value is null when
  1815. // there are no more results to return.
  1816. NextToken *string `locationName:"nextToken" type:"string"`
  1817. // The list of task definition Amazon Resource Name (ARN) entries for the ListTaskDefintions
  1818. // request.
  1819. TaskDefinitionArns []*string `locationName:"taskDefinitionArns" type:"list"`
  1820. metadataListTaskDefinitionsOutput `json:"-" xml:"-"`
  1821. }
  1822. type metadataListTaskDefinitionsOutput struct {
  1823. SDKShapeTraits bool `type:"structure"`
  1824. }
  1825. // String returns the string representation
  1826. func (s ListTaskDefinitionsOutput) String() string {
  1827. return awsutil.Prettify(s)
  1828. }
  1829. // GoString returns the string representation
  1830. func (s ListTaskDefinitionsOutput) GoString() string {
  1831. return s.String()
  1832. }
  1833. type ListTasksInput struct {
  1834. // The short name or full Amazon Resource Name (ARN) of the cluster that hosts
  1835. // the tasks you want to list. If you do not specify a cluster, the default
  1836. // cluster is assumed..
  1837. Cluster *string `locationName:"cluster" type:"string"`
  1838. // The container instance UUID or full Amazon Resource Name (ARN) of the container
  1839. // instance that you want to filter the ListTasks results with. Specifying a
  1840. // containerInstance will limit the results to tasks that belong to that container
  1841. // instance.
  1842. ContainerInstance *string `locationName:"containerInstance" type:"string"`
  1843. // The task status that you want to filter the ListTasks results with. Specifying
  1844. // a desiredStatus of STOPPED will limit the results to tasks that are in the
  1845. // STOPPED status, which can be useful for debugging tasks that are not starting
  1846. // properly or have died or finished. The default status filter is RUNNING.
  1847. DesiredStatus *string `locationName:"desiredStatus" type:"string" enum:"DesiredStatus"`
  1848. // The name of the family that you want to filter the ListTasks results with.
  1849. // Specifying a family will limit the results to tasks that belong to that family.
  1850. Family *string `locationName:"family" type:"string"`
  1851. // The maximum number of task results returned by ListTasks in paginated output.
  1852. // When this parameter is used, ListTasks only returns maxResults results in
  1853. // a single page along with a nextToken response element. The remaining results
  1854. // of the initial request can be seen by sending another ListTasks request with
  1855. // the returned nextToken value. This value can be between 1 and 100. If this
  1856. // parameter is not used, then ListTasks returns up to 100 results and a nextToken
  1857. // value if applicable.
  1858. MaxResults *int64 `locationName:"maxResults" type:"integer"`
  1859. // The nextToken value returned from a previous paginated ListTasks request
  1860. // where maxResults was used and the results exceeded the value of that parameter.
  1861. // Pagination continues from the end of the previous results that returned the
  1862. // nextToken value. This value is null when there are no more results to return.
  1863. NextToken *string `locationName:"nextToken" type:"string"`
  1864. // The name of the service that you want to filter the ListTasks results with.
  1865. // Specifying a serviceName will limit the results to tasks that belong to that
  1866. // service.
  1867. ServiceName *string `locationName:"serviceName" type:"string"`
  1868. // The startedBy value that you want to filter the task results with. Specifying
  1869. // a startedBy value will limit the results to tasks that were started with
  1870. // that value.
  1871. StartedBy *string `locationName:"startedBy" type:"string"`
  1872. metadataListTasksInput `json:"-" xml:"-"`
  1873. }
  1874. type metadataListTasksInput struct {
  1875. SDKShapeTraits bool `type:"structure"`
  1876. }
  1877. // String returns the string representation
  1878. func (s ListTasksInput) String() string {
  1879. return awsutil.Prettify(s)
  1880. }
  1881. // GoString returns the string representation
  1882. func (s ListTasksInput) GoString() string {
  1883. return s.String()
  1884. }
  1885. type ListTasksOutput struct {
  1886. // The nextToken value to include in a future ListTasks request. When the results
  1887. // of a ListTasks request exceed maxResults, this value can be used to retrieve
  1888. // the next page of results. This value is null when there are no more results
  1889. // to return.
  1890. NextToken *string `locationName:"nextToken" type:"string"`
  1891. // The list of task Amazon Resource Name (ARN) entries for the ListTasks request.
  1892. TaskArns []*string `locationName:"taskArns" type:"list"`
  1893. metadataListTasksOutput `json:"-" xml:"-"`
  1894. }
  1895. type metadataListTasksOutput struct {
  1896. SDKShapeTraits bool `type:"structure"`
  1897. }
  1898. // String returns the string representation
  1899. func (s ListTasksOutput) String() string {
  1900. return awsutil.Prettify(s)
  1901. }
  1902. // GoString returns the string representation
  1903. func (s ListTasksOutput) GoString() string {
  1904. return s.String()
  1905. }
  1906. // Details on a load balancer that is used with a service.
  1907. type LoadBalancer struct {
  1908. // The name of the container to associate with the load balancer.
  1909. ContainerName *string `locationName:"containerName" type:"string"`
  1910. // The port on the container to associate with the load balancer. This port
  1911. // must correspond to a containerPort in the service's task definition. Your
  1912. // container instances must allow ingress traffic on the hostPort of the port
  1913. // mapping.
  1914. ContainerPort *int64 `locationName:"containerPort" type:"integer"`
  1915. // The name of the load balancer.
  1916. LoadBalancerName *string `locationName:"loadBalancerName" type:"string"`
  1917. metadataLoadBalancer `json:"-" xml:"-"`
  1918. }
  1919. type metadataLoadBalancer struct {
  1920. SDKShapeTraits bool `type:"structure"`
  1921. }
  1922. // String returns the string representation
  1923. func (s LoadBalancer) String() string {
  1924. return awsutil.Prettify(s)
  1925. }
  1926. // GoString returns the string representation
  1927. func (s LoadBalancer) GoString() string {
  1928. return s.String()
  1929. }
  1930. // Details on a volume mount point that is used in a container definition.
  1931. type MountPoint struct {
  1932. // The path on the container to mount the host volume at.
  1933. ContainerPath *string `locationName:"containerPath" type:"string"`
  1934. // If this value is true, the container has read-only access to the volume.
  1935. // If this value is false, then the container can write to the volume. The default
  1936. // value is false.
  1937. ReadOnly *bool `locationName:"readOnly" type:"boolean"`
  1938. // The name of the volume to mount.
  1939. SourceVolume *string `locationName:"sourceVolume" type:"string"`
  1940. metadataMountPoint `json:"-" xml:"-"`
  1941. }
  1942. type metadataMountPoint struct {
  1943. SDKShapeTraits bool `type:"structure"`
  1944. }
  1945. // String returns the string representation
  1946. func (s MountPoint) String() string {
  1947. return awsutil.Prettify(s)
  1948. }
  1949. // GoString returns the string representation
  1950. func (s MountPoint) GoString() string {
  1951. return s.String()
  1952. }
  1953. // Details on the network bindings between a container and its host container
  1954. // instance.
  1955. type NetworkBinding struct {
  1956. // The IP address that the container is bound to on the container instance.
  1957. BindIP *string `locationName:"bindIP" type:"string"`
  1958. // The port number on the container that is be used with the network binding.
  1959. ContainerPort *int64 `locationName:"containerPort" type:"integer"`
  1960. // The port number on the host that is used with the network binding.
  1961. HostPort *int64 `locationName:"hostPort" type:"integer"`
  1962. // The protocol used for the network binding.
  1963. Protocol *string `locationName:"protocol" type:"string" enum:"TransportProtocol"`
  1964. metadataNetworkBinding `json:"-" xml:"-"`
  1965. }
  1966. type metadataNetworkBinding struct {
  1967. SDKShapeTraits bool `type:"structure"`
  1968. }
  1969. // String returns the string representation
  1970. func (s NetworkBinding) String() string {
  1971. return awsutil.Prettify(s)
  1972. }
  1973. // GoString returns the string representation
  1974. func (s NetworkBinding) GoString() string {
  1975. return s.String()
  1976. }
  1977. // Port mappings allow containers to access ports on the host container instance
  1978. // to send or receive traffic. Port mappings are specified as part of the container
  1979. // definition.
  1980. type PortMapping struct {
  1981. // The port number on the container that is bound to the user-specified or automatically
  1982. // assigned host port. If you specify a container port and not a host port,
  1983. // your container will automatically receive a host port in the ephemeral port
  1984. // range (for more information, see hostPort).
  1985. ContainerPort *int64 `locationName:"containerPort" type:"integer"`
  1986. // The port number on the container instance to reserve for your container.
  1987. // You can specify a non-reserved host port for your container port mapping,
  1988. // or you can omit the hostPort (or set it to 0) while specifying a containerPort
  1989. // and your container will automatically receive a port in the ephemeral port
  1990. // range for your container instance operating system and Docker version.
  1991. //
  1992. // The default ephemeral port range is 49153 to 65535, and this range is used
  1993. // for Docker versions prior to 1.6.0. For Docker version 1.6.0 and later, the
  1994. // Docker daemon tries to read the ephemeral port range from /proc/sys/net/ipv4/ip_local_port_range;
  1995. // if this kernel parameter is unavailable, the default ephemeral port range
  1996. // is used. You should not attempt to specify a host port in the ephemeral port
  1997. // range, since these are reserved for automatic assignment. In general, ports
  1998. // below 32768 are outside of the ephemeral port range.
  1999. //
  2000. // The default reserved ports are 22 for SSH, the Docker ports 2375 and 2376,
  2001. // and the Amazon ECS Container Agent port 51678. Any host port that was previously
  2002. // specified in a running task is also reserved while the task is running (once
  2003. // a task stops, the host port is released).The current reserved ports are displayed
  2004. // in the remainingResources of DescribeContainerInstances output, and a container
  2005. // instance may have up to 50 reserved ports at a time, including the default
  2006. // reserved ports (automatically assigned ports do not count toward this limit).
  2007. HostPort *int64 `locationName:"hostPort" type:"integer"`
  2008. // The protocol used for the port mapping. Valid values are tcp and udp. The
  2009. // default is tcp.
  2010. Protocol *string `locationName:"protocol" type:"string" enum:"TransportProtocol"`
  2011. metadataPortMapping `json:"-" xml:"-"`
  2012. }
  2013. type metadataPortMapping struct {
  2014. SDKShapeTraits bool `type:"structure"`
  2015. }
  2016. // String returns the string representation
  2017. func (s PortMapping) String() string {
  2018. return awsutil.Prettify(s)
  2019. }
  2020. // GoString returns the string representation
  2021. func (s PortMapping) GoString() string {
  2022. return s.String()
  2023. }
  2024. type RegisterContainerInstanceInput struct {
  2025. // The short name or full Amazon Resource Name (ARN) of the cluster that you
  2026. // want to register your container instance with. If you do not specify a cluster,
  2027. // the default cluster is assumed..
  2028. Cluster *string `locationName:"cluster" type:"string"`
  2029. // The Amazon Resource Name (ARN) of the container instance (if it was previously
  2030. // registered).
  2031. ContainerInstanceArn *string `locationName:"containerInstanceArn" type:"string"`
  2032. // The instance identity document for the Amazon EC2 instance to register. This
  2033. // document can be found by running the following command from the instance:
  2034. // curl http://169.254.169.254/latest/dynamic/instance-identity/document/
  2035. InstanceIdentityDocument *string `locationName:"instanceIdentityDocument" type:"string"`
  2036. // The instance identity document signature for the Amazon EC2 instance to register.
  2037. // This signature can be found by running the following command from the instance:
  2038. // curl http://169.254.169.254/latest/dynamic/instance-identity/signature/
  2039. InstanceIdentityDocumentSignature *string `locationName:"instanceIdentityDocumentSignature" type:"string"`
  2040. // The resources available on the instance.
  2041. TotalResources []*Resource `locationName:"totalResources" type:"list"`
  2042. // The version information for the Amazon ECS container agent and Docker daemon
  2043. // running on the container instance.
  2044. VersionInfo *VersionInfo `locationName:"versionInfo" type:"structure"`
  2045. metadataRegisterContainerInstanceInput `json:"-" xml:"-"`
  2046. }
  2047. type metadataRegisterContainerInstanceInput struct {
  2048. SDKShapeTraits bool `type:"structure"`
  2049. }
  2050. // String returns the string representation
  2051. func (s RegisterContainerInstanceInput) String() string {
  2052. return awsutil.Prettify(s)
  2053. }
  2054. // GoString returns the string representation
  2055. func (s RegisterContainerInstanceInput) GoString() string {
  2056. return s.String()
  2057. }
  2058. type RegisterContainerInstanceOutput struct {
  2059. // An Amazon EC2 instance that is running the Amazon ECS agent and has been
  2060. // registered with a cluster.
  2061. ContainerInstance *ContainerInstance `locationName:"containerInstance" type:"structure"`
  2062. metadataRegisterContainerInstanceOutput `json:"-" xml:"-"`
  2063. }
  2064. type metadataRegisterContainerInstanceOutput struct {
  2065. SDKShapeTraits bool `type:"structure"`
  2066. }
  2067. // String returns the string representation
  2068. func (s RegisterContainerInstanceOutput) String() string {
  2069. return awsutil.Prettify(s)
  2070. }
  2071. // GoString returns the string representation
  2072. func (s RegisterContainerInstanceOutput) GoString() string {
  2073. return s.String()
  2074. }
  2075. type RegisterTaskDefinitionInput struct {
  2076. // A list of container definitions in JSON format that describe the different
  2077. // containers that make up your task.
  2078. ContainerDefinitions []*ContainerDefinition `locationName:"containerDefinitions" type:"list" required:"true"`
  2079. // You must specify a family for a task definition, which allows you to track
  2080. // multiple versions of the same task definition. You can think of the family
  2081. // as a name for your task definition. Up to 255 letters (uppercase and lowercase),
  2082. // numbers, hyphens, and underscores are allowed.
  2083. Family *string `locationName:"family" type:"string" required:"true"`
  2084. // A list of volume definitions in JSON format that containers in your task
  2085. // may use.
  2086. Volumes []*Volume `locationName:"volumes" type:"list"`
  2087. metadataRegisterTaskDefinitionInput `json:"-" xml:"-"`
  2088. }
  2089. type metadataRegisterTaskDefinitionInput struct {
  2090. SDKShapeTraits bool `type:"structure"`
  2091. }
  2092. // String returns the string representation
  2093. func (s RegisterTaskDefinitionInput) String() string {
  2094. return awsutil.Prettify(s)
  2095. }
  2096. // GoString returns the string representation
  2097. func (s RegisterTaskDefinitionInput) GoString() string {
  2098. return s.String()
  2099. }
  2100. type RegisterTaskDefinitionOutput struct {
  2101. // Details of a task definition.
  2102. TaskDefinition *TaskDefinition `locationName:"taskDefinition" type:"structure"`
  2103. metadataRegisterTaskDefinitionOutput `json:"-" xml:"-"`
  2104. }
  2105. type metadataRegisterTaskDefinitionOutput struct {
  2106. SDKShapeTraits bool `type:"structure"`
  2107. }
  2108. // String returns the string representation
  2109. func (s RegisterTaskDefinitionOutput) String() string {
  2110. return awsutil.Prettify(s)
  2111. }
  2112. // GoString returns the string representation
  2113. func (s RegisterTaskDefinitionOutput) GoString() string {
  2114. return s.String()
  2115. }
  2116. // Describes the resources available for a container instance.
  2117. type Resource struct {
  2118. // When the doubleValue type is set, the value of the resource must be a double
  2119. // precision floating-point type.
  2120. DoubleValue *float64 `locationName:"doubleValue" type:"double"`
  2121. // When the integerValue type is set, the value of the resource must be an integer.
  2122. IntegerValue *int64 `locationName:"integerValue" type:"integer"`
  2123. // When the longValue type is set, the value of the resource must be an extended
  2124. // precision floating-point type.
  2125. LongValue *int64 `locationName:"longValue" type:"long"`
  2126. // The name of the resource, such as CPU, MEMORY, PORTS, or a user-defined resource.
  2127. Name *string `locationName:"name" type:"string"`
  2128. // When the stringSetValue type is set, the value of the resource must be a
  2129. // string type.
  2130. StringSetValue []*string `locationName:"stringSetValue" type:"list"`
  2131. // The type of the resource, such as INTEGER, DOUBLE, LONG, or STRINGSET.
  2132. Type *string `locationName:"type" type:"string"`
  2133. metadataResource `json:"-" xml:"-"`
  2134. }
  2135. type metadataResource struct {
  2136. SDKShapeTraits bool `type:"structure"`
  2137. }
  2138. // String returns the string representation
  2139. func (s Resource) String() string {
  2140. return awsutil.Prettify(s)
  2141. }
  2142. // GoString returns the string representation
  2143. func (s Resource) GoString() string {
  2144. return s.String()
  2145. }
  2146. type RunTaskInput struct {
  2147. // The short name or full Amazon Resource Name (ARN) of the cluster that you
  2148. // want to run your task on. If you do not specify a cluster, the default cluster
  2149. // is assumed..
  2150. Cluster *string `locationName:"cluster" type:"string"`
  2151. // The number of instantiations of the specified task that you would like to
  2152. // place on your cluster.
  2153. //
  2154. // The count parameter is limited to 10 tasks per call.
  2155. Count *int64 `locationName:"count" type:"integer"`
  2156. // A list of container overrides in JSON format that specify the name of a container
  2157. // in the specified task definition and the overrides it should receive. You
  2158. // can override the default command for a container (that is specified in the
  2159. // task definition or Docker image) with a command override. You can also override
  2160. // existing environment variables (that are specified in the task definition
  2161. // or Docker image) on a container or add new environment variables to it with
  2162. // an environment override.
  2163. //
  2164. // A total of 8192 characters are allowed for overrides. This limit includes
  2165. // the JSON formatting characters of the override structure.
  2166. Overrides *TaskOverride `locationName:"overrides" type:"structure"`
  2167. // An optional tag specified when a task is started. For example if you automatically
  2168. // trigger a task to run a batch process job, you could apply a unique identifier
  2169. // for that job to your task with the startedBy parameter. You can then identify
  2170. // which tasks belong to that job by filtering the results of a ListTasks call
  2171. // with the startedBy value.
  2172. //
  2173. // If a task is started by an Amazon ECS service, then the startedBy parameter
  2174. // contains the deployment ID of the service that starts it.
  2175. StartedBy *string `locationName:"startedBy" type:"string"`
  2176. // The family and revision (family:revision) or full Amazon Resource Name (ARN)
  2177. // of the task definition that you want to run. If a revision is not specified,
  2178. // the latest ACTIVE revision is used.
  2179. TaskDefinition *string `locationName:"taskDefinition" type:"string" required:"true"`
  2180. metadataRunTaskInput `json:"-" xml:"-"`
  2181. }
  2182. type metadataRunTaskInput struct {
  2183. SDKShapeTraits bool `type:"structure"`
  2184. }
  2185. // String returns the string representation
  2186. func (s RunTaskInput) String() string {
  2187. return awsutil.Prettify(s)
  2188. }
  2189. // GoString returns the string representation
  2190. func (s RunTaskInput) GoString() string {
  2191. return s.String()
  2192. }
  2193. type RunTaskOutput struct {
  2194. // Any failed tasks from your RunTask action are listed here.
  2195. Failures []*Failure `locationName:"failures" type:"list"`
  2196. // A full description of the tasks that were run. Each task that was successfully
  2197. // placed on your cluster will be described here.
  2198. Tasks []*Task `locationName:"tasks" type:"list"`
  2199. metadataRunTaskOutput `json:"-" xml:"-"`
  2200. }
  2201. type metadataRunTaskOutput struct {
  2202. SDKShapeTraits bool `type:"structure"`
  2203. }
  2204. // String returns the string representation
  2205. func (s RunTaskOutput) String() string {
  2206. return awsutil.Prettify(s)
  2207. }
  2208. // GoString returns the string representation
  2209. func (s RunTaskOutput) GoString() string {
  2210. return s.String()
  2211. }
  2212. // Details on a service within a cluster
  2213. type Service struct {
  2214. // The Amazon Resource Name (ARN) of the of the cluster that hosts the service.
  2215. ClusterArn *string `locationName:"clusterArn" type:"string"`
  2216. // The current state of deployments for the service.
  2217. Deployments []*Deployment `locationName:"deployments" type:"list"`
  2218. // The desired number of instantiations of the task definition to keep running
  2219. // on the service. This value is specified when the service is created with
  2220. // CreateService, and it can be modified with UpdateService.
  2221. DesiredCount *int64 `locationName:"desiredCount" type:"integer"`
  2222. // The event stream for your service. A maximum of 100 of the latest events
  2223. // are displayed.
  2224. Events []*ServiceEvent `locationName:"events" type:"list"`
  2225. // A list of load balancer objects, containing the load balancer name, the container
  2226. // name (as it appears in a container definition), and the container port to
  2227. // access from the load balancer.
  2228. LoadBalancers []*LoadBalancer `locationName:"loadBalancers" type:"list"`
  2229. // The number of tasks in the cluster that are in the PENDING state.
  2230. PendingCount *int64 `locationName:"pendingCount" type:"integer"`
  2231. // The Amazon Resource Name (ARN) of the IAM role associated with the service
  2232. // that allows the Amazon ECS container agent to register container instances
  2233. // with a load balancer.
  2234. RoleArn *string `locationName:"roleArn" type:"string"`
  2235. // The number of tasks in the cluster that are in the RUNNING state.
  2236. RunningCount *int64 `locationName:"runningCount" type:"integer"`
  2237. // The Amazon Resource Name (ARN) that identifies the service. The ARN contains
  2238. // the arn:aws:ecs namespace, followed by the region of the service, the AWS
  2239. // account ID of the service owner, the service namespace, and then the service
  2240. // name. For example, arn:aws:ecs:region:012345678910:service/my-service.
  2241. ServiceArn *string `locationName:"serviceArn" type:"string"`
  2242. // A user-generated string that you can use to identify your service.
  2243. ServiceName *string `locationName:"serviceName" type:"string"`
  2244. // The status of the service. The valid values are ACTIVE, DRAINING, or INACTIVE.
  2245. Status *string `locationName:"status" type:"string"`
  2246. // The task definition to use for tasks in the service. This value is specified
  2247. // when the service is created with CreateService, and it can be modified with
  2248. // UpdateService.
  2249. TaskDefinition *string `locationName:"taskDefinition" type:"string"`
  2250. metadataService `json:"-" xml:"-"`
  2251. }
  2252. type metadataService struct {
  2253. SDKShapeTraits bool `type:"structure"`
  2254. }
  2255. // String returns the string representation
  2256. func (s Service) String() string {
  2257. return awsutil.Prettify(s)
  2258. }
  2259. // GoString returns the string representation
  2260. func (s Service) GoString() string {
  2261. return s.String()
  2262. }
  2263. // Details on an event associated with a service.
  2264. type ServiceEvent struct {
  2265. // The Unix time in seconds and milliseconds when the event was triggered.
  2266. CreatedAt *time.Time `locationName:"createdAt" type:"timestamp" timestampFormat:"unix"`
  2267. // The ID string of the event.
  2268. Id *string `locationName:"id" type:"string"`
  2269. // The event message.
  2270. Message *string `locationName:"message" type:"string"`
  2271. metadataServiceEvent `json:"-" xml:"-"`
  2272. }
  2273. type metadataServiceEvent struct {
  2274. SDKShapeTraits bool `type:"structure"`
  2275. }
  2276. // String returns the string representation
  2277. func (s ServiceEvent) String() string {
  2278. return awsutil.Prettify(s)
  2279. }
  2280. // GoString returns the string representation
  2281. func (s ServiceEvent) GoString() string {
  2282. return s.String()
  2283. }
  2284. type StartTaskInput struct {
  2285. // The short name or full Amazon Resource Name (ARN) of the cluster that you
  2286. // want to start your task on. If you do not specify a cluster, the default
  2287. // cluster is assumed..
  2288. Cluster *string `locationName:"cluster" type:"string"`
  2289. // The container instance UUIDs or full Amazon Resource Name (ARN) entries for
  2290. // the container instances on which you would like to place your task.
  2291. //
  2292. // The list of container instances to start tasks on is limited to 10.
  2293. ContainerInstances []*string `locationName:"containerInstances" type:"list" required:"true"`
  2294. // A list of container overrides in JSON format that specify the name of a container
  2295. // in the specified task definition and the overrides it should receive. You
  2296. // can override the default command for a container (that is specified in the
  2297. // task definition or Docker image) with a command override. You can also override
  2298. // existing environment variables (that are specified in the task definition
  2299. // or Docker image) on a container or add new environment variables to it with
  2300. // an environment override.
  2301. //
  2302. // A total of 8192 characters are allowed for overrides. This limit includes
  2303. // the JSON formatting characters of the override structure.
  2304. Overrides *TaskOverride `locationName:"overrides" type:"structure"`
  2305. // An optional tag specified when a task is started. For example if you automatically
  2306. // trigger a task to run a batch process job, you could apply a unique identifier
  2307. // for that job to your task with the startedBy parameter. You can then identify
  2308. // which tasks belong to that job by filtering the results of a ListTasks call
  2309. // with the startedBy value.
  2310. //
  2311. // If a task is started by an Amazon ECS service, then the startedBy parameter
  2312. // contains the deployment ID of the service that starts it.
  2313. StartedBy *string `locationName:"startedBy" type:"string"`
  2314. // The family and revision (family:revision) or full Amazon Resource Name (ARN)
  2315. // of the task definition that you want to start. If a revision is not specified,
  2316. // the latest ACTIVE revision is used.
  2317. TaskDefinition *string `locationName:"taskDefinition" type:"string" required:"true"`
  2318. metadataStartTaskInput `json:"-" xml:"-"`
  2319. }
  2320. type metadataStartTaskInput struct {
  2321. SDKShapeTraits bool `type:"structure"`
  2322. }
  2323. // String returns the string representation
  2324. func (s StartTaskInput) String() string {
  2325. return awsutil.Prettify(s)
  2326. }
  2327. // GoString returns the string representation
  2328. func (s StartTaskInput) GoString() string {
  2329. return s.String()
  2330. }
  2331. type StartTaskOutput struct {
  2332. // Any failed tasks from your StartTask action are listed here.
  2333. Failures []*Failure `locationName:"failures" type:"list"`
  2334. // A full description of the tasks that were started. Each task that was successfully
  2335. // placed on your container instances will be described here.
  2336. Tasks []*Task `locationName:"tasks" type:"list"`
  2337. metadataStartTaskOutput `json:"-" xml:"-"`
  2338. }
  2339. type metadataStartTaskOutput struct {
  2340. SDKShapeTraits bool `type:"structure"`
  2341. }
  2342. // String returns the string representation
  2343. func (s StartTaskOutput) String() string {
  2344. return awsutil.Prettify(s)
  2345. }
  2346. // GoString returns the string representation
  2347. func (s StartTaskOutput) GoString() string {
  2348. return s.String()
  2349. }
  2350. type StopTaskInput struct {
  2351. // The short name or full Amazon Resource Name (ARN) of the cluster that hosts
  2352. // the task you want to stop. If you do not specify a cluster, the default cluster
  2353. // is assumed..
  2354. Cluster *string `locationName:"cluster" type:"string"`
  2355. // The task UUIDs or full Amazon Resource Name (ARN) entry of the task you would
  2356. // like to stop.
  2357. Task *string `locationName:"task" type:"string" required:"true"`
  2358. metadataStopTaskInput `json:"-" xml:"-"`
  2359. }
  2360. type metadataStopTaskInput struct {
  2361. SDKShapeTraits bool `type:"structure"`
  2362. }
  2363. // String returns the string representation
  2364. func (s StopTaskInput) String() string {
  2365. return awsutil.Prettify(s)
  2366. }
  2367. // GoString returns the string representation
  2368. func (s StopTaskInput) GoString() string {
  2369. return s.String()
  2370. }
  2371. type StopTaskOutput struct {
  2372. // Details on a task in a cluster.
  2373. Task *Task `locationName:"task" type:"structure"`
  2374. metadataStopTaskOutput `json:"-" xml:"-"`
  2375. }
  2376. type metadataStopTaskOutput struct {
  2377. SDKShapeTraits bool `type:"structure"`
  2378. }
  2379. // String returns the string representation
  2380. func (s StopTaskOutput) String() string {
  2381. return awsutil.Prettify(s)
  2382. }
  2383. // GoString returns the string representation
  2384. func (s StopTaskOutput) GoString() string {
  2385. return s.String()
  2386. }
  2387. type SubmitContainerStateChangeInput struct {
  2388. // The short name or full Amazon Resource Name (ARN) of the cluster that hosts
  2389. // the container.
  2390. Cluster *string `locationName:"cluster" type:"string"`
  2391. // The name of the container.
  2392. ContainerName *string `locationName:"containerName" type:"string"`
  2393. // The exit code returned for the state change request.
  2394. ExitCode *int64 `locationName:"exitCode" type:"integer"`
  2395. // The network bindings of the container.
  2396. NetworkBindings []*NetworkBinding `locationName:"networkBindings" type:"list"`
  2397. // The reason for the state change request.
  2398. Reason *string `locationName:"reason" type:"string"`
  2399. // The status of the state change request.
  2400. Status *string `locationName:"status" type:"string"`
  2401. // The task UUID or full Amazon Resource Name (ARN) of the task that hosts the
  2402. // container.
  2403. Task *string `locationName:"task" type:"string"`
  2404. metadataSubmitContainerStateChangeInput `json:"-" xml:"-"`
  2405. }
  2406. type metadataSubmitContainerStateChangeInput struct {
  2407. SDKShapeTraits bool `type:"structure"`
  2408. }
  2409. // String returns the string representation
  2410. func (s SubmitContainerStateChangeInput) String() string {
  2411. return awsutil.Prettify(s)
  2412. }
  2413. // GoString returns the string representation
  2414. func (s SubmitContainerStateChangeInput) GoString() string {
  2415. return s.String()
  2416. }
  2417. type SubmitContainerStateChangeOutput struct {
  2418. // Acknowledgement of the state change.
  2419. Acknowledgment *string `locationName:"acknowledgment" type:"string"`
  2420. metadataSubmitContainerStateChangeOutput `json:"-" xml:"-"`
  2421. }
  2422. type metadataSubmitContainerStateChangeOutput struct {
  2423. SDKShapeTraits bool `type:"structure"`
  2424. }
  2425. // String returns the string representation
  2426. func (s SubmitContainerStateChangeOutput) String() string {
  2427. return awsutil.Prettify(s)
  2428. }
  2429. // GoString returns the string representation
  2430. func (s SubmitContainerStateChangeOutput) GoString() string {
  2431. return s.String()
  2432. }
  2433. type SubmitTaskStateChangeInput struct {
  2434. // The short name or full Amazon Resource Name (ARN) of the cluster that hosts
  2435. // the task.
  2436. Cluster *string `locationName:"cluster" type:"string"`
  2437. // The reason for the state change request.
  2438. Reason *string `locationName:"reason" type:"string"`
  2439. // The status of the state change request.
  2440. Status *string `locationName:"status" type:"string"`
  2441. // The task UUID or full Amazon Resource Name (ARN) of the task in the state
  2442. // change request.
  2443. Task *string `locationName:"task" type:"string"`
  2444. metadataSubmitTaskStateChangeInput `json:"-" xml:"-"`
  2445. }
  2446. type metadataSubmitTaskStateChangeInput struct {
  2447. SDKShapeTraits bool `type:"structure"`
  2448. }
  2449. // String returns the string representation
  2450. func (s SubmitTaskStateChangeInput) String() string {
  2451. return awsutil.Prettify(s)
  2452. }
  2453. // GoString returns the string representation
  2454. func (s SubmitTaskStateChangeInput) GoString() string {
  2455. return s.String()
  2456. }
  2457. type SubmitTaskStateChangeOutput struct {
  2458. // Acknowledgement of the state change.
  2459. Acknowledgment *string `locationName:"acknowledgment" type:"string"`
  2460. metadataSubmitTaskStateChangeOutput `json:"-" xml:"-"`
  2461. }
  2462. type metadataSubmitTaskStateChangeOutput struct {
  2463. SDKShapeTraits bool `type:"structure"`
  2464. }
  2465. // String returns the string representation
  2466. func (s SubmitTaskStateChangeOutput) String() string {
  2467. return awsutil.Prettify(s)
  2468. }
  2469. // GoString returns the string representation
  2470. func (s SubmitTaskStateChangeOutput) GoString() string {
  2471. return s.String()
  2472. }
  2473. // Details on a task in a cluster.
  2474. type Task struct {
  2475. // The Amazon Resource Name (ARN) of the of the cluster that hosts the task.
  2476. ClusterArn *string `locationName:"clusterArn" type:"string"`
  2477. // The Amazon Resource Name (ARN) of the container instances that host the task.
  2478. ContainerInstanceArn *string `locationName:"containerInstanceArn" type:"string"`
  2479. // The containers associated with the task.
  2480. Containers []*Container `locationName:"containers" type:"list"`
  2481. // The desired status of the task.
  2482. DesiredStatus *string `locationName:"desiredStatus" type:"string"`
  2483. // The last known status of the task.
  2484. LastStatus *string `locationName:"lastStatus" type:"string"`
  2485. // One or more container overrides.
  2486. Overrides *TaskOverride `locationName:"overrides" type:"structure"`
  2487. // The tag specified when a task is started. If the task is started by an Amazon
  2488. // ECS service, then the startedBy parameter contains the deployment ID of the
  2489. // service that starts it.
  2490. StartedBy *string `locationName:"startedBy" type:"string"`
  2491. // The Amazon Resource Name (ARN) of the task.
  2492. TaskArn *string `locationName:"taskArn" type:"string"`
  2493. // The Amazon Resource Name (ARN) of the of the task definition that creates
  2494. // the task.
  2495. TaskDefinitionArn *string `locationName:"taskDefinitionArn" type:"string"`
  2496. metadataTask `json:"-" xml:"-"`
  2497. }
  2498. type metadataTask struct {
  2499. SDKShapeTraits bool `type:"structure"`
  2500. }
  2501. // String returns the string representation
  2502. func (s Task) String() string {
  2503. return awsutil.Prettify(s)
  2504. }
  2505. // GoString returns the string representation
  2506. func (s Task) GoString() string {
  2507. return s.String()
  2508. }
  2509. // Details of a task definition.
  2510. type TaskDefinition struct {
  2511. // A list of container definitions in JSON format that describe the different
  2512. // containers that make up your task. For more information on container definition
  2513. // parameters and defaults, see Amazon ECS Task Definitions (http://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_defintions.html)
  2514. // in the Amazon EC2 Container Service Developer Guide.
  2515. ContainerDefinitions []*ContainerDefinition `locationName:"containerDefinitions" type:"list"`
  2516. // The family of your task definition. You can think of the family as the name
  2517. // of your task definition.
  2518. Family *string `locationName:"family" type:"string"`
  2519. // The revision of the task in a particular family. You can think of the revision
  2520. // as a version number of a task definition in a family. When you register a
  2521. // task definition for the first time, the revision is 1, and each time you
  2522. // register a new revision of a task definition in the same family, the revision
  2523. // value always increases by one (even if you have deregistered previous revisions
  2524. // in this family).
  2525. Revision *int64 `locationName:"revision" type:"integer"`
  2526. // The status of the task definition.
  2527. Status *string `locationName:"status" type:"string" enum:"TaskDefinitionStatus"`
  2528. // The full Amazon Resource Name (ARN) of the of the task definition.
  2529. TaskDefinitionArn *string `locationName:"taskDefinitionArn" type:"string"`
  2530. // The list of volumes in a task. For more information on volume definition
  2531. // parameters and defaults, see Amazon ECS Task Definitions (http://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_defintions.html)
  2532. // in the Amazon EC2 Container Service Developer Guide.
  2533. Volumes []*Volume `locationName:"volumes" type:"list"`
  2534. metadataTaskDefinition `json:"-" xml:"-"`
  2535. }
  2536. type metadataTaskDefinition struct {
  2537. SDKShapeTraits bool `type:"structure"`
  2538. }
  2539. // String returns the string representation
  2540. func (s TaskDefinition) String() string {
  2541. return awsutil.Prettify(s)
  2542. }
  2543. // GoString returns the string representation
  2544. func (s TaskDefinition) GoString() string {
  2545. return s.String()
  2546. }
  2547. // The overrides associated with a task.
  2548. type TaskOverride struct {
  2549. // One or more container overrides sent to a task.
  2550. ContainerOverrides []*ContainerOverride `locationName:"containerOverrides" type:"list"`
  2551. metadataTaskOverride `json:"-" xml:"-"`
  2552. }
  2553. type metadataTaskOverride struct {
  2554. SDKShapeTraits bool `type:"structure"`
  2555. }
  2556. // String returns the string representation
  2557. func (s TaskOverride) String() string {
  2558. return awsutil.Prettify(s)
  2559. }
  2560. // GoString returns the string representation
  2561. func (s TaskOverride) GoString() string {
  2562. return s.String()
  2563. }
  2564. type UpdateContainerAgentInput struct {
  2565. // The short name or full Amazon Resource Name (ARN) of the cluster that your
  2566. // container instance is running on. If you do not specify a cluster, the default
  2567. // cluster is assumed.
  2568. Cluster *string `locationName:"cluster" type:"string"`
  2569. // The container instance UUID or full Amazon Resource Name (ARN) entries for
  2570. // the container instance on which you would like to update the Amazon ECS container
  2571. // agent.
  2572. ContainerInstance *string `locationName:"containerInstance" type:"string" required:"true"`
  2573. metadataUpdateContainerAgentInput `json:"-" xml:"-"`
  2574. }
  2575. type metadataUpdateContainerAgentInput struct {
  2576. SDKShapeTraits bool `type:"structure"`
  2577. }
  2578. // String returns the string representation
  2579. func (s UpdateContainerAgentInput) String() string {
  2580. return awsutil.Prettify(s)
  2581. }
  2582. // GoString returns the string representation
  2583. func (s UpdateContainerAgentInput) GoString() string {
  2584. return s.String()
  2585. }
  2586. type UpdateContainerAgentOutput struct {
  2587. // An Amazon EC2 instance that is running the Amazon ECS agent and has been
  2588. // registered with a cluster.
  2589. ContainerInstance *ContainerInstance `locationName:"containerInstance" type:"structure"`
  2590. metadataUpdateContainerAgentOutput `json:"-" xml:"-"`
  2591. }
  2592. type metadataUpdateContainerAgentOutput struct {
  2593. SDKShapeTraits bool `type:"structure"`
  2594. }
  2595. // String returns the string representation
  2596. func (s UpdateContainerAgentOutput) String() string {
  2597. return awsutil.Prettify(s)
  2598. }
  2599. // GoString returns the string representation
  2600. func (s UpdateContainerAgentOutput) GoString() string {
  2601. return s.String()
  2602. }
  2603. type UpdateServiceInput struct {
  2604. // The short name or full Amazon Resource Name (ARN) of the cluster that your
  2605. // service is running on. If you do not specify a cluster, the default cluster
  2606. // is assumed.
  2607. Cluster *string `locationName:"cluster" type:"string"`
  2608. // The number of instantiations of the task that you would like to place and
  2609. // keep running in your service.
  2610. DesiredCount *int64 `locationName:"desiredCount" type:"integer"`
  2611. // The name of the service that you want to update.
  2612. Service *string `locationName:"service" type:"string" required:"true"`
  2613. // The family and revision (family:revision) or full Amazon Resource Name (ARN)
  2614. // of the task definition that you want to run in your service. If a revision
  2615. // is not specified, the latest ACTIVE revision is used. If you modify the task
  2616. // definition with UpdateService, Amazon ECS spawns a task with the new version
  2617. // of the task definition and then stops an old task after the new version is
  2618. // running.
  2619. TaskDefinition *string `locationName:"taskDefinition" type:"string"`
  2620. metadataUpdateServiceInput `json:"-" xml:"-"`
  2621. }
  2622. type metadataUpdateServiceInput struct {
  2623. SDKShapeTraits bool `type:"structure"`
  2624. }
  2625. // String returns the string representation
  2626. func (s UpdateServiceInput) String() string {
  2627. return awsutil.Prettify(s)
  2628. }
  2629. // GoString returns the string representation
  2630. func (s UpdateServiceInput) GoString() string {
  2631. return s.String()
  2632. }
  2633. type UpdateServiceOutput struct {
  2634. // The full description of your service following the update call.
  2635. Service *Service `locationName:"service" type:"structure"`
  2636. metadataUpdateServiceOutput `json:"-" xml:"-"`
  2637. }
  2638. type metadataUpdateServiceOutput struct {
  2639. SDKShapeTraits bool `type:"structure"`
  2640. }
  2641. // String returns the string representation
  2642. func (s UpdateServiceOutput) String() string {
  2643. return awsutil.Prettify(s)
  2644. }
  2645. // GoString returns the string representation
  2646. func (s UpdateServiceOutput) GoString() string {
  2647. return s.String()
  2648. }
  2649. // The Docker and Amazon ECS container agent version information on a container
  2650. // instance.
  2651. type VersionInfo struct {
  2652. // The Git commit hash for the Amazon ECS container agent build on the amazon-ecs-agent
  2653. // (https://github.com/aws/amazon-ecs-agent/commits/master) GitHub repository.
  2654. AgentHash *string `locationName:"agentHash" type:"string"`
  2655. // The version number of the Amazon ECS container agent.
  2656. AgentVersion *string `locationName:"agentVersion" type:"string"`
  2657. // The Docker version running on the container instance.
  2658. DockerVersion *string `locationName:"dockerVersion" type:"string"`
  2659. metadataVersionInfo `json:"-" xml:"-"`
  2660. }
  2661. type metadataVersionInfo struct {
  2662. SDKShapeTraits bool `type:"structure"`
  2663. }
  2664. // String returns the string representation
  2665. func (s VersionInfo) String() string {
  2666. return awsutil.Prettify(s)
  2667. }
  2668. // GoString returns the string representation
  2669. func (s VersionInfo) GoString() string {
  2670. return s.String()
  2671. }
  2672. // A data volume used in a task definition.
  2673. type Volume struct {
  2674. // The path on the host container instance that is presented to the containers
  2675. // which access the volume. If this parameter is empty, then the Docker daemon
  2676. // assigns a host path for you.
  2677. Host *HostVolumeProperties `locationName:"host" type:"structure"`
  2678. // The name of the volume. This name is referenced in the sourceVolume parameter
  2679. // of container definition mountPoints.
  2680. Name *string `locationName:"name" type:"string"`
  2681. metadataVolume `json:"-" xml:"-"`
  2682. }
  2683. type metadataVolume struct {
  2684. SDKShapeTraits bool `type:"structure"`
  2685. }
  2686. // String returns the string representation
  2687. func (s Volume) String() string {
  2688. return awsutil.Prettify(s)
  2689. }
  2690. // GoString returns the string representation
  2691. func (s Volume) GoString() string {
  2692. return s.String()
  2693. }
  2694. // Details on a data volume from another container.
  2695. type VolumeFrom struct {
  2696. // If this value is true, the container has read-only access to the volume.
  2697. // If this value is false, then the container can write to the volume. The default
  2698. // value is false.
  2699. ReadOnly *bool `locationName:"readOnly" type:"boolean"`
  2700. // The name of the container to mount volumes from.
  2701. SourceContainer *string `locationName:"sourceContainer" type:"string"`
  2702. metadataVolumeFrom `json:"-" xml:"-"`
  2703. }
  2704. type metadataVolumeFrom struct {
  2705. SDKShapeTraits bool `type:"structure"`
  2706. }
  2707. // String returns the string representation
  2708. func (s VolumeFrom) String() string {
  2709. return awsutil.Prettify(s)
  2710. }
  2711. // GoString returns the string representation
  2712. func (s VolumeFrom) GoString() string {
  2713. return s.String()
  2714. }
  2715. const (
  2716. // @enum AgentUpdateStatus
  2717. AgentUpdateStatusPending = "PENDING"
  2718. // @enum AgentUpdateStatus
  2719. AgentUpdateStatusStaging = "STAGING"
  2720. // @enum AgentUpdateStatus
  2721. AgentUpdateStatusStaged = "STAGED"
  2722. // @enum AgentUpdateStatus
  2723. AgentUpdateStatusUpdating = "UPDATING"
  2724. // @enum AgentUpdateStatus
  2725. AgentUpdateStatusUpdated = "UPDATED"
  2726. // @enum AgentUpdateStatus
  2727. AgentUpdateStatusFailed = "FAILED"
  2728. )
  2729. const (
  2730. // @enum DesiredStatus
  2731. DesiredStatusRunning = "RUNNING"
  2732. // @enum DesiredStatus
  2733. DesiredStatusPending = "PENDING"
  2734. // @enum DesiredStatus
  2735. DesiredStatusStopped = "STOPPED"
  2736. )
  2737. const (
  2738. // @enum SortOrder
  2739. SortOrderAsc = "ASC"
  2740. // @enum SortOrder
  2741. SortOrderDesc = "DESC"
  2742. )
  2743. const (
  2744. // @enum TaskDefinitionStatus
  2745. TaskDefinitionStatusActive = "ACTIVE"
  2746. // @enum TaskDefinitionStatus
  2747. TaskDefinitionStatusInactive = "INACTIVE"
  2748. )
  2749. const (
  2750. // @enum TransportProtocol
  2751. TransportProtocolTcp = "tcp"
  2752. // @enum TransportProtocol
  2753. TransportProtocolUdp = "udp"
  2754. )