| 1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476247724782479248024812482248324842485248624872488248924902491249224932494249524962497249824992500250125022503250425052506250725082509251025112512251325142515251625172518251925202521252225232524252525262527252825292530253125322533253425352536253725382539254025412542254325442545254625472548254925502551255225532554255525562557255825592560256125622563256425652566256725682569257025712572257325742575257625772578257925802581258225832584258525862587258825892590259125922593259425952596259725982599260026012602260326042605260626072608260926102611261226132614261526162617261826192620262126222623262426252626262726282629263026312632263326342635263626372638263926402641264226432644264526462647264826492650265126522653265426552656265726582659266026612662266326642665266626672668266926702671267226732674267526762677267826792680268126822683268426852686268726882689269026912692269326942695269626972698269927002701270227032704270527062707270827092710271127122713271427152716271727182719272027212722272327242725272627272728272927302731273227332734273527362737273827392740274127422743274427452746274727482749275027512752275327542755275627572758275927602761276227632764276527662767276827692770277127722773277427752776277727782779278027812782278327842785278627872788278927902791279227932794279527962797279827992800280128022803280428052806280728082809281028112812281328142815281628172818281928202821282228232824282528262827282828292830283128322833283428352836283728382839284028412842284328442845284628472848284928502851285228532854285528562857285828592860286128622863286428652866286728682869287028712872287328742875287628772878287928802881288228832884288528862887288828892890289128922893289428952896289728982899290029012902290329042905290629072908290929102911291229132914291529162917291829192920292129222923292429252926292729282929293029312932293329342935293629372938293929402941294229432944294529462947294829492950295129522953295429552956295729582959296029612962296329642965296629672968296929702971297229732974297529762977297829792980298129822983298429852986298729882989299029912992299329942995299629972998299930003001300230033004300530063007300830093010301130123013301430153016301730183019302030213022302330243025302630273028302930303031303230333034303530363037303830393040304130423043304430453046304730483049305030513052305330543055305630573058305930603061306230633064306530663067306830693070307130723073307430753076307730783079308030813082308330843085308630873088308930903091309230933094309530963097309830993100310131023103310431053106310731083109311031113112311331143115311631173118311931203121312231233124312531263127312831293130313131323133313431353136313731383139314031413142314331443145314631473148314931503151315231533154315531563157315831593160316131623163316431653166316731683169317031713172317331743175317631773178317931803181318231833184318531863187318831893190319131923193319431953196319731983199320032013202320332043205320632073208320932103211321232133214321532163217321832193220322132223223322432253226322732283229323032313232323332343235323632373238323932403241324232433244324532463247324832493250325132523253325432553256325732583259326032613262326332643265326632673268326932703271327232733274327532763277327832793280328132823283328432853286328732883289329032913292329332943295329632973298329933003301330233033304330533063307330833093310331133123313331433153316331733183319332033213322332333243325332633273328332933303331333233333334333533363337333833393340334133423343334433453346334733483349335033513352335333543355335633573358335933603361336233633364336533663367336833693370337133723373337433753376337733783379338033813382338333843385338633873388338933903391339233933394339533963397339833993400340134023403340434053406340734083409341034113412341334143415341634173418341934203421342234233424342534263427342834293430343134323433343434353436343734383439344034413442344334443445344634473448344934503451345234533454345534563457345834593460346134623463346434653466346734683469347034713472347334743475347634773478347934803481348234833484348534863487348834893490349134923493349434953496349734983499350035013502350335043505350635073508350935103511351235133514351535163517351835193520352135223523352435253526352735283529353035313532353335343535353635373538353935403541354235433544354535463547354835493550355135523553355435553556355735583559356035613562356335643565356635673568356935703571357235733574357535763577357835793580358135823583358435853586358735883589359035913592359335943595359635973598359936003601360236033604360536063607360836093610361136123613361436153616361736183619362036213622362336243625362636273628362936303631363236333634363536363637363836393640364136423643364436453646364736483649365036513652365336543655365636573658365936603661366236633664366536663667366836693670367136723673367436753676367736783679368036813682368336843685368636873688368936903691369236933694369536963697369836993700370137023703370437053706370737083709371037113712371337143715371637173718371937203721372237233724372537263727372837293730373137323733373437353736373737383739374037413742374337443745374637473748374937503751375237533754375537563757375837593760376137623763376437653766376737683769377037713772377337743775377637773778377937803781378237833784378537863787378837893790379137923793379437953796379737983799380038013802380338043805380638073808380938103811381238133814381538163817381838193820382138223823382438253826382738283829383038313832383338343835383638373838383938403841384238433844384538463847384838493850385138523853385438553856385738583859386038613862386338643865386638673868386938703871387238733874387538763877387838793880388138823883388438853886388738883889389038913892389338943895389638973898389939003901390239033904390539063907390839093910391139123913391439153916391739183919392039213922392339243925392639273928392939303931393239333934393539363937393839393940394139423943394439453946394739483949395039513952395339543955395639573958395939603961396239633964396539663967396839693970397139723973397439753976397739783979398039813982398339843985398639873988398939903991399239933994399539963997399839994000400140024003400440054006400740084009401040114012401340144015401640174018401940204021402240234024402540264027402840294030403140324033403440354036403740384039404040414042404340444045404640474048404940504051405240534054405540564057405840594060406140624063406440654066406740684069407040714072407340744075407640774078407940804081408240834084408540864087408840894090409140924093409440954096409740984099410041014102410341044105410641074108410941104111411241134114411541164117411841194120412141224123412441254126412741284129413041314132413341344135413641374138413941404141414241434144414541464147414841494150415141524153415441554156415741584159416041614162416341644165416641674168416941704171417241734174417541764177417841794180418141824183418441854186418741884189419041914192419341944195419641974198419942004201420242034204420542064207420842094210421142124213421442154216421742184219422042214222422342244225422642274228422942304231423242334234423542364237423842394240424142424243424442454246424742484249425042514252425342544255425642574258425942604261426242634264426542664267426842694270427142724273427442754276427742784279428042814282428342844285428642874288428942904291429242934294429542964297429842994300430143024303430443054306430743084309431043114312431343144315431643174318431943204321432243234324432543264327432843294330433143324333433443354336433743384339434043414342434343444345434643474348434943504351435243534354435543564357435843594360436143624363436443654366436743684369437043714372437343744375437643774378437943804381438243834384438543864387438843894390439143924393439443954396439743984399440044014402440344044405440644074408440944104411441244134414441544164417441844194420442144224423442444254426442744284429443044314432443344344435443644374438443944404441444244434444444544464447444844494450445144524453445444554456445744584459446044614462446344644465446644674468446944704471447244734474447544764477447844794480448144824483448444854486448744884489449044914492449344944495449644974498449945004501450245034504450545064507450845094510451145124513451445154516451745184519452045214522452345244525452645274528452945304531453245334534453545364537453845394540454145424543454445454546454745484549455045514552455345544555455645574558455945604561456245634564456545664567456845694570457145724573457445754576457745784579458045814582458345844585458645874588458945904591459245934594459545964597459845994600460146024603460446054606460746084609461046114612461346144615461646174618461946204621462246234624462546264627462846294630463146324633463446354636463746384639464046414642464346444645464646474648464946504651465246534654465546564657465846594660466146624663466446654666466746684669467046714672467346744675467646774678467946804681468246834684468546864687468846894690469146924693469446954696469746984699470047014702470347044705470647074708470947104711471247134714471547164717471847194720472147224723472447254726472747284729473047314732473347344735473647374738473947404741474247434744474547464747474847494750475147524753475447554756475747584759476047614762476347644765476647674768476947704771477247734774477547764777477847794780478147824783478447854786478747884789479047914792479347944795479647974798479948004801480248034804480548064807480848094810481148124813481448154816481748184819482048214822482348244825482648274828482948304831483248334834483548364837483848394840484148424843484448454846484748484849485048514852485348544855485648574858485948604861486248634864486548664867486848694870487148724873487448754876487748784879488048814882488348844885488648874888488948904891489248934894489548964897489848994900490149024903490449054906490749084909491049114912491349144915491649174918491949204921492249234924492549264927492849294930493149324933493449354936493749384939494049414942494349444945494649474948494949504951495249534954495549564957495849594960496149624963496449654966496749684969497049714972497349744975497649774978497949804981498249834984498549864987498849894990499149924993499449954996499749984999500050015002500350045005500650075008500950105011501250135014501550165017501850195020502150225023502450255026502750285029503050315032503350345035503650375038503950405041504250435044504550465047504850495050505150525053505450555056505750585059506050615062506350645065506650675068506950705071507250735074507550765077507850795080508150825083508450855086508750885089509050915092509350945095509650975098509951005101510251035104510551065107510851095110511151125113511451155116511751185119512051215122512351245125512651275128512951305131513251335134513551365137513851395140514151425143514451455146514751485149515051515152515351545155515651575158515951605161516251635164516551665167516851695170517151725173517451755176517751785179518051815182518351845185518651875188518951905191519251935194519551965197519851995200520152025203520452055206520752085209521052115212521352145215521652175218521952205221522252235224522552265227522852295230523152325233523452355236523752385239524052415242524352445245524652475248524952505251525252535254525552565257525852595260526152625263526452655266526752685269527052715272527352745275527652775278527952805281528252835284528552865287528852895290529152925293529452955296529752985299530053015302530353045305530653075308530953105311531253135314531553165317531853195320532153225323532453255326532753285329533053315332533353345335533653375338533953405341534253435344534553465347534853495350535153525353535453555356535753585359536053615362536353645365536653675368536953705371537253735374537553765377537853795380538153825383538453855386538753885389539053915392539353945395539653975398539954005401540254035404540554065407540854095410541154125413541454155416541754185419542054215422542354245425542654275428542954305431543254335434543554365437543854395440544154425443544454455446544754485449545054515452545354545455545654575458545954605461546254635464546554665467546854695470547154725473547454755476547754785479548054815482548354845485548654875488548954905491549254935494549554965497549854995500550155025503550455055506 |
- // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
- package datasync
- import (
- "fmt"
- "time"
- "github.com/aws/aws-sdk-go/aws"
- "github.com/aws/aws-sdk-go/aws/awsutil"
- "github.com/aws/aws-sdk-go/aws/request"
- "github.com/aws/aws-sdk-go/private/protocol"
- "github.com/aws/aws-sdk-go/private/protocol/jsonrpc"
- )
- const opCancelTaskExecution = "CancelTaskExecution"
- // CancelTaskExecutionRequest generates a "aws/request.Request" representing the
- // client's request for the CancelTaskExecution operation. The "output" return
- // value will be populated with the request's response once the request completes
- // successfully.
- //
- // Use "Send" method on the returned Request to send the API call to the service.
- // the "output" return value is not valid until after Send returns without error.
- //
- // See CancelTaskExecution for more information on using the CancelTaskExecution
- // API call, and error handling.
- //
- // This method is useful when you want to inject custom logic or configuration
- // into the SDK's request lifecycle. Such as custom headers, or retry logic.
- //
- //
- // // Example sending a request using the CancelTaskExecutionRequest method.
- // req, resp := client.CancelTaskExecutionRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/CancelTaskExecution
- func (c *DataSync) CancelTaskExecutionRequest(input *CancelTaskExecutionInput) (req *request.Request, output *CancelTaskExecutionOutput) {
- op := &request.Operation{
- Name: opCancelTaskExecution,
- HTTPMethod: "POST",
- HTTPPath: "/",
- }
- if input == nil {
- input = &CancelTaskExecutionInput{}
- }
- output = &CancelTaskExecutionOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Swap(jsonrpc.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler)
- return
- }
- // CancelTaskExecution API operation for AWS DataSync.
- //
- // Cancels execution of a task.
- //
- // When you cancel a task execution, the transfer of some files are abruptly
- // interrupted. The contents of files that are transferred to the destination
- // might be incomplete or inconsistent with the source files. However, if you
- // start a new task execution on the same task and you allow the task execution
- // to complete, file content on the destination is complete and consistent.
- // This applies to other unexpected failures that interrupt a task execution.
- // In all of these cases, AWS DataSync successfully complete the transfer when
- // you start the next task execution.
- //
- // Returns awserr.Error for service API and SDK errors. Use runtime type assertions
- // with awserr.Error's Code and Message methods to get detailed information about
- // the error.
- //
- // See the AWS API reference guide for AWS DataSync's
- // API operation CancelTaskExecution for usage and error information.
- //
- // Returned Error Codes:
- // * ErrCodeInvalidRequestException "InvalidRequestException"
- // This exception is thrown when the client submits a malformed request.
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/CancelTaskExecution
- func (c *DataSync) CancelTaskExecution(input *CancelTaskExecutionInput) (*CancelTaskExecutionOutput, error) {
- req, out := c.CancelTaskExecutionRequest(input)
- return out, req.Send()
- }
- // CancelTaskExecutionWithContext is the same as CancelTaskExecution with the addition of
- // the ability to pass a context and additional request options.
- //
- // See CancelTaskExecution for details on how to use this API operation.
- //
- // The context must be non-nil and will be used for request cancellation. If
- // the context is nil a panic will occur. In the future the SDK may create
- // sub-contexts for http.Requests. See https://golang.org/pkg/context/
- // for more information on using Contexts.
- func (c *DataSync) CancelTaskExecutionWithContext(ctx aws.Context, input *CancelTaskExecutionInput, opts ...request.Option) (*CancelTaskExecutionOutput, error) {
- req, out := c.CancelTaskExecutionRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opCreateAgent = "CreateAgent"
- // CreateAgentRequest generates a "aws/request.Request" representing the
- // client's request for the CreateAgent operation. The "output" return
- // value will be populated with the request's response once the request completes
- // successfully.
- //
- // Use "Send" method on the returned Request to send the API call to the service.
- // the "output" return value is not valid until after Send returns without error.
- //
- // See CreateAgent for more information on using the CreateAgent
- // API call, and error handling.
- //
- // This method is useful when you want to inject custom logic or configuration
- // into the SDK's request lifecycle. Such as custom headers, or retry logic.
- //
- //
- // // Example sending a request using the CreateAgentRequest method.
- // req, resp := client.CreateAgentRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/CreateAgent
- func (c *DataSync) CreateAgentRequest(input *CreateAgentInput) (req *request.Request, output *CreateAgentOutput) {
- op := &request.Operation{
- Name: opCreateAgent,
- HTTPMethod: "POST",
- HTTPPath: "/",
- }
- if input == nil {
- input = &CreateAgentInput{}
- }
- output = &CreateAgentOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // CreateAgent API operation for AWS DataSync.
- //
- // Activates an AWS DataSync agent that you have deployed on your host. The
- // activation process associates your agent with your account. In the activation
- // process, you specify information such as the AWS Region that you want to
- // activate the agent in. You activate the agent in the AWS Region where your
- // target locations (in Amazon S3 or Amazon EFS) reside. Your tasks are created
- // in this AWS Region.
- //
- // You can use an agent for more than one location. If a task uses multiple
- // agents, all of them need to have status AVAILABLE for the task to run. If
- // you use multiple agents for a source location, the status of all the agents
- // must be AVAILABLE for the task to run. For more information, see Activating
- // a Sync Agent (https://docs.aws.amazon.com/sync-service/latest/userguide/working-with-sync-agents.html#activating-sync-agent)
- // in the AWS DataSync User Guide.
- //
- // Agents are automatically updated by AWS on a regular basis, using a mechanism
- // that ensures minimal interruption to your tasks.
- //
- // Returns awserr.Error for service API and SDK errors. Use runtime type assertions
- // with awserr.Error's Code and Message methods to get detailed information about
- // the error.
- //
- // See the AWS API reference guide for AWS DataSync's
- // API operation CreateAgent for usage and error information.
- //
- // Returned Error Codes:
- // * ErrCodeInvalidRequestException "InvalidRequestException"
- // This exception is thrown when the client submits a malformed request.
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/CreateAgent
- func (c *DataSync) CreateAgent(input *CreateAgentInput) (*CreateAgentOutput, error) {
- req, out := c.CreateAgentRequest(input)
- return out, req.Send()
- }
- // CreateAgentWithContext is the same as CreateAgent with the addition of
- // the ability to pass a context and additional request options.
- //
- // See CreateAgent for details on how to use this API operation.
- //
- // The context must be non-nil and will be used for request cancellation. If
- // the context is nil a panic will occur. In the future the SDK may create
- // sub-contexts for http.Requests. See https://golang.org/pkg/context/
- // for more information on using Contexts.
- func (c *DataSync) CreateAgentWithContext(ctx aws.Context, input *CreateAgentInput, opts ...request.Option) (*CreateAgentOutput, error) {
- req, out := c.CreateAgentRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opCreateLocationEfs = "CreateLocationEfs"
- // CreateLocationEfsRequest generates a "aws/request.Request" representing the
- // client's request for the CreateLocationEfs operation. The "output" return
- // value will be populated with the request's response once the request completes
- // successfully.
- //
- // Use "Send" method on the returned Request to send the API call to the service.
- // the "output" return value is not valid until after Send returns without error.
- //
- // See CreateLocationEfs for more information on using the CreateLocationEfs
- // API call, and error handling.
- //
- // This method is useful when you want to inject custom logic or configuration
- // into the SDK's request lifecycle. Such as custom headers, or retry logic.
- //
- //
- // // Example sending a request using the CreateLocationEfsRequest method.
- // req, resp := client.CreateLocationEfsRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/CreateLocationEfs
- func (c *DataSync) CreateLocationEfsRequest(input *CreateLocationEfsInput) (req *request.Request, output *CreateLocationEfsOutput) {
- op := &request.Operation{
- Name: opCreateLocationEfs,
- HTTPMethod: "POST",
- HTTPPath: "/",
- }
- if input == nil {
- input = &CreateLocationEfsInput{}
- }
- output = &CreateLocationEfsOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // CreateLocationEfs API operation for AWS DataSync.
- //
- // Creates an endpoint for an Amazon EFS file system.
- //
- // Returns awserr.Error for service API and SDK errors. Use runtime type assertions
- // with awserr.Error's Code and Message methods to get detailed information about
- // the error.
- //
- // See the AWS API reference guide for AWS DataSync's
- // API operation CreateLocationEfs for usage and error information.
- //
- // Returned Error Codes:
- // * ErrCodeInvalidRequestException "InvalidRequestException"
- // This exception is thrown when the client submits a malformed request.
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/CreateLocationEfs
- func (c *DataSync) CreateLocationEfs(input *CreateLocationEfsInput) (*CreateLocationEfsOutput, error) {
- req, out := c.CreateLocationEfsRequest(input)
- return out, req.Send()
- }
- // CreateLocationEfsWithContext is the same as CreateLocationEfs with the addition of
- // the ability to pass a context and additional request options.
- //
- // See CreateLocationEfs for details on how to use this API operation.
- //
- // The context must be non-nil and will be used for request cancellation. If
- // the context is nil a panic will occur. In the future the SDK may create
- // sub-contexts for http.Requests. See https://golang.org/pkg/context/
- // for more information on using Contexts.
- func (c *DataSync) CreateLocationEfsWithContext(ctx aws.Context, input *CreateLocationEfsInput, opts ...request.Option) (*CreateLocationEfsOutput, error) {
- req, out := c.CreateLocationEfsRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opCreateLocationNfs = "CreateLocationNfs"
- // CreateLocationNfsRequest generates a "aws/request.Request" representing the
- // client's request for the CreateLocationNfs operation. The "output" return
- // value will be populated with the request's response once the request completes
- // successfully.
- //
- // Use "Send" method on the returned Request to send the API call to the service.
- // the "output" return value is not valid until after Send returns without error.
- //
- // See CreateLocationNfs for more information on using the CreateLocationNfs
- // API call, and error handling.
- //
- // This method is useful when you want to inject custom logic or configuration
- // into the SDK's request lifecycle. Such as custom headers, or retry logic.
- //
- //
- // // Example sending a request using the CreateLocationNfsRequest method.
- // req, resp := client.CreateLocationNfsRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/CreateLocationNfs
- func (c *DataSync) CreateLocationNfsRequest(input *CreateLocationNfsInput) (req *request.Request, output *CreateLocationNfsOutput) {
- op := &request.Operation{
- Name: opCreateLocationNfs,
- HTTPMethod: "POST",
- HTTPPath: "/",
- }
- if input == nil {
- input = &CreateLocationNfsInput{}
- }
- output = &CreateLocationNfsOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // CreateLocationNfs API operation for AWS DataSync.
- //
- // Creates an endpoint for a Network File System (NFS) file system.
- //
- // Returns awserr.Error for service API and SDK errors. Use runtime type assertions
- // with awserr.Error's Code and Message methods to get detailed information about
- // the error.
- //
- // See the AWS API reference guide for AWS DataSync's
- // API operation CreateLocationNfs for usage and error information.
- //
- // Returned Error Codes:
- // * ErrCodeInvalidRequestException "InvalidRequestException"
- // This exception is thrown when the client submits a malformed request.
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/CreateLocationNfs
- func (c *DataSync) CreateLocationNfs(input *CreateLocationNfsInput) (*CreateLocationNfsOutput, error) {
- req, out := c.CreateLocationNfsRequest(input)
- return out, req.Send()
- }
- // CreateLocationNfsWithContext is the same as CreateLocationNfs with the addition of
- // the ability to pass a context and additional request options.
- //
- // See CreateLocationNfs for details on how to use this API operation.
- //
- // The context must be non-nil and will be used for request cancellation. If
- // the context is nil a panic will occur. In the future the SDK may create
- // sub-contexts for http.Requests. See https://golang.org/pkg/context/
- // for more information on using Contexts.
- func (c *DataSync) CreateLocationNfsWithContext(ctx aws.Context, input *CreateLocationNfsInput, opts ...request.Option) (*CreateLocationNfsOutput, error) {
- req, out := c.CreateLocationNfsRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opCreateLocationS3 = "CreateLocationS3"
- // CreateLocationS3Request generates a "aws/request.Request" representing the
- // client's request for the CreateLocationS3 operation. The "output" return
- // value will be populated with the request's response once the request completes
- // successfully.
- //
- // Use "Send" method on the returned Request to send the API call to the service.
- // the "output" return value is not valid until after Send returns without error.
- //
- // See CreateLocationS3 for more information on using the CreateLocationS3
- // API call, and error handling.
- //
- // This method is useful when you want to inject custom logic or configuration
- // into the SDK's request lifecycle. Such as custom headers, or retry logic.
- //
- //
- // // Example sending a request using the CreateLocationS3Request method.
- // req, resp := client.CreateLocationS3Request(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/CreateLocationS3
- func (c *DataSync) CreateLocationS3Request(input *CreateLocationS3Input) (req *request.Request, output *CreateLocationS3Output) {
- op := &request.Operation{
- Name: opCreateLocationS3,
- HTTPMethod: "POST",
- HTTPPath: "/",
- }
- if input == nil {
- input = &CreateLocationS3Input{}
- }
- output = &CreateLocationS3Output{}
- req = c.newRequest(op, input, output)
- return
- }
- // CreateLocationS3 API operation for AWS DataSync.
- //
- // Creates an endpoint for an Amazon S3 bucket.
- //
- // For AWS DataSync to access a destination S3 bucket, it needs an AWS Identity
- // and Access Management (IAM) role that has the required permissions. You can
- // set up the required permissions by creating an IAM policy that grants the
- // required permissions and attaching the policy to the role. An example of
- // such a policy is shown in the examples section. For more information, see
- // Configuring Amazon S3 Location Settings (https://docs.aws.amazon.com/sync-service/latest/userguide/configuring-s3-locations.html)
- // in the AWS DataSync User Guide.
- //
- // Returns awserr.Error for service API and SDK errors. Use runtime type assertions
- // with awserr.Error's Code and Message methods to get detailed information about
- // the error.
- //
- // See the AWS API reference guide for AWS DataSync's
- // API operation CreateLocationS3 for usage and error information.
- //
- // Returned Error Codes:
- // * ErrCodeInvalidRequestException "InvalidRequestException"
- // This exception is thrown when the client submits a malformed request.
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/CreateLocationS3
- func (c *DataSync) CreateLocationS3(input *CreateLocationS3Input) (*CreateLocationS3Output, error) {
- req, out := c.CreateLocationS3Request(input)
- return out, req.Send()
- }
- // CreateLocationS3WithContext is the same as CreateLocationS3 with the addition of
- // the ability to pass a context and additional request options.
- //
- // See CreateLocationS3 for details on how to use this API operation.
- //
- // The context must be non-nil and will be used for request cancellation. If
- // the context is nil a panic will occur. In the future the SDK may create
- // sub-contexts for http.Requests. See https://golang.org/pkg/context/
- // for more information on using Contexts.
- func (c *DataSync) CreateLocationS3WithContext(ctx aws.Context, input *CreateLocationS3Input, opts ...request.Option) (*CreateLocationS3Output, error) {
- req, out := c.CreateLocationS3Request(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opCreateTask = "CreateTask"
- // CreateTaskRequest generates a "aws/request.Request" representing the
- // client's request for the CreateTask operation. The "output" return
- // value will be populated with the request's response once the request completes
- // successfully.
- //
- // Use "Send" method on the returned Request to send the API call to the service.
- // the "output" return value is not valid until after Send returns without error.
- //
- // See CreateTask for more information on using the CreateTask
- // API call, and error handling.
- //
- // This method is useful when you want to inject custom logic or configuration
- // into the SDK's request lifecycle. Such as custom headers, or retry logic.
- //
- //
- // // Example sending a request using the CreateTaskRequest method.
- // req, resp := client.CreateTaskRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/CreateTask
- func (c *DataSync) CreateTaskRequest(input *CreateTaskInput) (req *request.Request, output *CreateTaskOutput) {
- op := &request.Operation{
- Name: opCreateTask,
- HTTPMethod: "POST",
- HTTPPath: "/",
- }
- if input == nil {
- input = &CreateTaskInput{}
- }
- output = &CreateTaskOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // CreateTask API operation for AWS DataSync.
- //
- // Creates a task. A task is a set of two locations (source and destination)
- // and a set of default OverrideOptions that you use to control the behavior
- // of a task. If you don't specify default values for Options when you create
- // a task, AWS DataSync populates them with safe service defaults.
- //
- // When you initially create a task, it enters the INITIALIZING status and then
- // the CREATING status. In CREATING status, AWS DataSync attempts to mount the
- // source Network File System (NFS) location. The task transitions to the AVAILABLE
- // status without waiting for the destination location to mount. Instead, AWS
- // DataSync mounts a destination before every task execution and then unmounts
- // it after every task execution.
- //
- // If an agent that is associated with a source (NFS) location goes offline,
- // the task transitions to the UNAVAILABLE status. If the status of the task
- // remains in the CREATING status for more than a few minutes, it means that
- // your agent might be having trouble mounting the source NFS file system. Check
- // the task's ErrorCode and ErrorDetail. Mount issues are often caused by either
- // a misconfigured firewall or a mistyped NFS server host name.
- //
- // Returns awserr.Error for service API and SDK errors. Use runtime type assertions
- // with awserr.Error's Code and Message methods to get detailed information about
- // the error.
- //
- // See the AWS API reference guide for AWS DataSync's
- // API operation CreateTask for usage and error information.
- //
- // Returned Error Codes:
- // * ErrCodeInvalidRequestException "InvalidRequestException"
- // This exception is thrown when the client submits a malformed request.
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/CreateTask
- func (c *DataSync) CreateTask(input *CreateTaskInput) (*CreateTaskOutput, error) {
- req, out := c.CreateTaskRequest(input)
- return out, req.Send()
- }
- // CreateTaskWithContext is the same as CreateTask with the addition of
- // the ability to pass a context and additional request options.
- //
- // See CreateTask for details on how to use this API operation.
- //
- // The context must be non-nil and will be used for request cancellation. If
- // the context is nil a panic will occur. In the future the SDK may create
- // sub-contexts for http.Requests. See https://golang.org/pkg/context/
- // for more information on using Contexts.
- func (c *DataSync) CreateTaskWithContext(ctx aws.Context, input *CreateTaskInput, opts ...request.Option) (*CreateTaskOutput, error) {
- req, out := c.CreateTaskRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opDeleteAgent = "DeleteAgent"
- // DeleteAgentRequest generates a "aws/request.Request" representing the
- // client's request for the DeleteAgent operation. The "output" return
- // value will be populated with the request's response once the request completes
- // successfully.
- //
- // Use "Send" method on the returned Request to send the API call to the service.
- // the "output" return value is not valid until after Send returns without error.
- //
- // See DeleteAgent for more information on using the DeleteAgent
- // API call, and error handling.
- //
- // This method is useful when you want to inject custom logic or configuration
- // into the SDK's request lifecycle. Such as custom headers, or retry logic.
- //
- //
- // // Example sending a request using the DeleteAgentRequest method.
- // req, resp := client.DeleteAgentRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DeleteAgent
- func (c *DataSync) DeleteAgentRequest(input *DeleteAgentInput) (req *request.Request, output *DeleteAgentOutput) {
- op := &request.Operation{
- Name: opDeleteAgent,
- HTTPMethod: "POST",
- HTTPPath: "/",
- }
- if input == nil {
- input = &DeleteAgentInput{}
- }
- output = &DeleteAgentOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Swap(jsonrpc.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler)
- return
- }
- // DeleteAgent API operation for AWS DataSync.
- //
- // Deletes an agent. To specify which agent to delete, use the Amazon Resource
- // Name (ARN) of the agent in your request. The operation disassociates the
- // agent from your AWS account. However, it doesn't delete the agent virtual
- // machine (VM) from your on-premises environment.
- //
- // After you delete an agent, you can't reactivate it and you longer pay software
- // charges for it.
- //
- // Returns awserr.Error for service API and SDK errors. Use runtime type assertions
- // with awserr.Error's Code and Message methods to get detailed information about
- // the error.
- //
- // See the AWS API reference guide for AWS DataSync's
- // API operation DeleteAgent for usage and error information.
- //
- // Returned Error Codes:
- // * ErrCodeInvalidRequestException "InvalidRequestException"
- // This exception is thrown when the client submits a malformed request.
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DeleteAgent
- func (c *DataSync) DeleteAgent(input *DeleteAgentInput) (*DeleteAgentOutput, error) {
- req, out := c.DeleteAgentRequest(input)
- return out, req.Send()
- }
- // DeleteAgentWithContext is the same as DeleteAgent with the addition of
- // the ability to pass a context and additional request options.
- //
- // See DeleteAgent for details on how to use this API operation.
- //
- // The context must be non-nil and will be used for request cancellation. If
- // the context is nil a panic will occur. In the future the SDK may create
- // sub-contexts for http.Requests. See https://golang.org/pkg/context/
- // for more information on using Contexts.
- func (c *DataSync) DeleteAgentWithContext(ctx aws.Context, input *DeleteAgentInput, opts ...request.Option) (*DeleteAgentOutput, error) {
- req, out := c.DeleteAgentRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opDeleteLocation = "DeleteLocation"
- // DeleteLocationRequest generates a "aws/request.Request" representing the
- // client's request for the DeleteLocation operation. The "output" return
- // value will be populated with the request's response once the request completes
- // successfully.
- //
- // Use "Send" method on the returned Request to send the API call to the service.
- // the "output" return value is not valid until after Send returns without error.
- //
- // See DeleteLocation for more information on using the DeleteLocation
- // API call, and error handling.
- //
- // This method is useful when you want to inject custom logic or configuration
- // into the SDK's request lifecycle. Such as custom headers, or retry logic.
- //
- //
- // // Example sending a request using the DeleteLocationRequest method.
- // req, resp := client.DeleteLocationRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DeleteLocation
- func (c *DataSync) DeleteLocationRequest(input *DeleteLocationInput) (req *request.Request, output *DeleteLocationOutput) {
- op := &request.Operation{
- Name: opDeleteLocation,
- HTTPMethod: "POST",
- HTTPPath: "/",
- }
- if input == nil {
- input = &DeleteLocationInput{}
- }
- output = &DeleteLocationOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Swap(jsonrpc.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler)
- return
- }
- // DeleteLocation API operation for AWS DataSync.
- //
- // Deletes the configuration of a location used by AWS DataSync.
- //
- // Returns awserr.Error for service API and SDK errors. Use runtime type assertions
- // with awserr.Error's Code and Message methods to get detailed information about
- // the error.
- //
- // See the AWS API reference guide for AWS DataSync's
- // API operation DeleteLocation for usage and error information.
- //
- // Returned Error Codes:
- // * ErrCodeInvalidRequestException "InvalidRequestException"
- // This exception is thrown when the client submits a malformed request.
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DeleteLocation
- func (c *DataSync) DeleteLocation(input *DeleteLocationInput) (*DeleteLocationOutput, error) {
- req, out := c.DeleteLocationRequest(input)
- return out, req.Send()
- }
- // DeleteLocationWithContext is the same as DeleteLocation with the addition of
- // the ability to pass a context and additional request options.
- //
- // See DeleteLocation for details on how to use this API operation.
- //
- // The context must be non-nil and will be used for request cancellation. If
- // the context is nil a panic will occur. In the future the SDK may create
- // sub-contexts for http.Requests. See https://golang.org/pkg/context/
- // for more information on using Contexts.
- func (c *DataSync) DeleteLocationWithContext(ctx aws.Context, input *DeleteLocationInput, opts ...request.Option) (*DeleteLocationOutput, error) {
- req, out := c.DeleteLocationRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opDeleteTask = "DeleteTask"
- // DeleteTaskRequest generates a "aws/request.Request" representing the
- // client's request for the DeleteTask operation. The "output" return
- // value will be populated with the request's response once the request completes
- // successfully.
- //
- // Use "Send" method on the returned Request to send the API call to the service.
- // the "output" return value is not valid until after Send returns without error.
- //
- // See DeleteTask for more information on using the DeleteTask
- // API call, and error handling.
- //
- // This method is useful when you want to inject custom logic or configuration
- // into the SDK's request lifecycle. Such as custom headers, or retry logic.
- //
- //
- // // Example sending a request using the DeleteTaskRequest method.
- // req, resp := client.DeleteTaskRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DeleteTask
- func (c *DataSync) DeleteTaskRequest(input *DeleteTaskInput) (req *request.Request, output *DeleteTaskOutput) {
- op := &request.Operation{
- Name: opDeleteTask,
- HTTPMethod: "POST",
- HTTPPath: "/",
- }
- if input == nil {
- input = &DeleteTaskInput{}
- }
- output = &DeleteTaskOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Swap(jsonrpc.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler)
- return
- }
- // DeleteTask API operation for AWS DataSync.
- //
- // Deletes a task.
- //
- // Returns awserr.Error for service API and SDK errors. Use runtime type assertions
- // with awserr.Error's Code and Message methods to get detailed information about
- // the error.
- //
- // See the AWS API reference guide for AWS DataSync's
- // API operation DeleteTask for usage and error information.
- //
- // Returned Error Codes:
- // * ErrCodeInvalidRequestException "InvalidRequestException"
- // This exception is thrown when the client submits a malformed request.
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DeleteTask
- func (c *DataSync) DeleteTask(input *DeleteTaskInput) (*DeleteTaskOutput, error) {
- req, out := c.DeleteTaskRequest(input)
- return out, req.Send()
- }
- // DeleteTaskWithContext is the same as DeleteTask with the addition of
- // the ability to pass a context and additional request options.
- //
- // See DeleteTask for details on how to use this API operation.
- //
- // The context must be non-nil and will be used for request cancellation. If
- // the context is nil a panic will occur. In the future the SDK may create
- // sub-contexts for http.Requests. See https://golang.org/pkg/context/
- // for more information on using Contexts.
- func (c *DataSync) DeleteTaskWithContext(ctx aws.Context, input *DeleteTaskInput, opts ...request.Option) (*DeleteTaskOutput, error) {
- req, out := c.DeleteTaskRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opDescribeAgent = "DescribeAgent"
- // DescribeAgentRequest generates a "aws/request.Request" representing the
- // client's request for the DescribeAgent operation. The "output" return
- // value will be populated with the request's response once the request completes
- // successfully.
- //
- // Use "Send" method on the returned Request to send the API call to the service.
- // the "output" return value is not valid until after Send returns without error.
- //
- // See DescribeAgent for more information on using the DescribeAgent
- // API call, and error handling.
- //
- // This method is useful when you want to inject custom logic or configuration
- // into the SDK's request lifecycle. Such as custom headers, or retry logic.
- //
- //
- // // Example sending a request using the DescribeAgentRequest method.
- // req, resp := client.DescribeAgentRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeAgent
- func (c *DataSync) DescribeAgentRequest(input *DescribeAgentInput) (req *request.Request, output *DescribeAgentOutput) {
- op := &request.Operation{
- Name: opDescribeAgent,
- HTTPMethod: "POST",
- HTTPPath: "/",
- }
- if input == nil {
- input = &DescribeAgentInput{}
- }
- output = &DescribeAgentOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // DescribeAgent API operation for AWS DataSync.
- //
- // Returns metadata such as the name, the network interfaces, and the status
- // (that is, whether the agent is running or not) for an agent. To specify which
- // agent to describe, use the Amazon Resource Name (ARN) of the agent in your
- // request.
- //
- // Returns awserr.Error for service API and SDK errors. Use runtime type assertions
- // with awserr.Error's Code and Message methods to get detailed information about
- // the error.
- //
- // See the AWS API reference guide for AWS DataSync's
- // API operation DescribeAgent for usage and error information.
- //
- // Returned Error Codes:
- // * ErrCodeInvalidRequestException "InvalidRequestException"
- // This exception is thrown when the client submits a malformed request.
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeAgent
- func (c *DataSync) DescribeAgent(input *DescribeAgentInput) (*DescribeAgentOutput, error) {
- req, out := c.DescribeAgentRequest(input)
- return out, req.Send()
- }
- // DescribeAgentWithContext is the same as DescribeAgent with the addition of
- // the ability to pass a context and additional request options.
- //
- // See DescribeAgent for details on how to use this API operation.
- //
- // The context must be non-nil and will be used for request cancellation. If
- // the context is nil a panic will occur. In the future the SDK may create
- // sub-contexts for http.Requests. See https://golang.org/pkg/context/
- // for more information on using Contexts.
- func (c *DataSync) DescribeAgentWithContext(ctx aws.Context, input *DescribeAgentInput, opts ...request.Option) (*DescribeAgentOutput, error) {
- req, out := c.DescribeAgentRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opDescribeLocationEfs = "DescribeLocationEfs"
- // DescribeLocationEfsRequest generates a "aws/request.Request" representing the
- // client's request for the DescribeLocationEfs operation. The "output" return
- // value will be populated with the request's response once the request completes
- // successfully.
- //
- // Use "Send" method on the returned Request to send the API call to the service.
- // the "output" return value is not valid until after Send returns without error.
- //
- // See DescribeLocationEfs for more information on using the DescribeLocationEfs
- // API call, and error handling.
- //
- // This method is useful when you want to inject custom logic or configuration
- // into the SDK's request lifecycle. Such as custom headers, or retry logic.
- //
- //
- // // Example sending a request using the DescribeLocationEfsRequest method.
- // req, resp := client.DescribeLocationEfsRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeLocationEfs
- func (c *DataSync) DescribeLocationEfsRequest(input *DescribeLocationEfsInput) (req *request.Request, output *DescribeLocationEfsOutput) {
- op := &request.Operation{
- Name: opDescribeLocationEfs,
- HTTPMethod: "POST",
- HTTPPath: "/",
- }
- if input == nil {
- input = &DescribeLocationEfsInput{}
- }
- output = &DescribeLocationEfsOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // DescribeLocationEfs API operation for AWS DataSync.
- //
- // Returns metadata, such as the path information about an Amazon EFS location.
- //
- // Returns awserr.Error for service API and SDK errors. Use runtime type assertions
- // with awserr.Error's Code and Message methods to get detailed information about
- // the error.
- //
- // See the AWS API reference guide for AWS DataSync's
- // API operation DescribeLocationEfs for usage and error information.
- //
- // Returned Error Codes:
- // * ErrCodeInvalidRequestException "InvalidRequestException"
- // This exception is thrown when the client submits a malformed request.
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeLocationEfs
- func (c *DataSync) DescribeLocationEfs(input *DescribeLocationEfsInput) (*DescribeLocationEfsOutput, error) {
- req, out := c.DescribeLocationEfsRequest(input)
- return out, req.Send()
- }
- // DescribeLocationEfsWithContext is the same as DescribeLocationEfs with the addition of
- // the ability to pass a context and additional request options.
- //
- // See DescribeLocationEfs for details on how to use this API operation.
- //
- // The context must be non-nil and will be used for request cancellation. If
- // the context is nil a panic will occur. In the future the SDK may create
- // sub-contexts for http.Requests. See https://golang.org/pkg/context/
- // for more information on using Contexts.
- func (c *DataSync) DescribeLocationEfsWithContext(ctx aws.Context, input *DescribeLocationEfsInput, opts ...request.Option) (*DescribeLocationEfsOutput, error) {
- req, out := c.DescribeLocationEfsRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opDescribeLocationNfs = "DescribeLocationNfs"
- // DescribeLocationNfsRequest generates a "aws/request.Request" representing the
- // client's request for the DescribeLocationNfs operation. The "output" return
- // value will be populated with the request's response once the request completes
- // successfully.
- //
- // Use "Send" method on the returned Request to send the API call to the service.
- // the "output" return value is not valid until after Send returns without error.
- //
- // See DescribeLocationNfs for more information on using the DescribeLocationNfs
- // API call, and error handling.
- //
- // This method is useful when you want to inject custom logic or configuration
- // into the SDK's request lifecycle. Such as custom headers, or retry logic.
- //
- //
- // // Example sending a request using the DescribeLocationNfsRequest method.
- // req, resp := client.DescribeLocationNfsRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeLocationNfs
- func (c *DataSync) DescribeLocationNfsRequest(input *DescribeLocationNfsInput) (req *request.Request, output *DescribeLocationNfsOutput) {
- op := &request.Operation{
- Name: opDescribeLocationNfs,
- HTTPMethod: "POST",
- HTTPPath: "/",
- }
- if input == nil {
- input = &DescribeLocationNfsInput{}
- }
- output = &DescribeLocationNfsOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // DescribeLocationNfs API operation for AWS DataSync.
- //
- // Returns metadata, such as the path information, about a NFS location.
- //
- // Returns awserr.Error for service API and SDK errors. Use runtime type assertions
- // with awserr.Error's Code and Message methods to get detailed information about
- // the error.
- //
- // See the AWS API reference guide for AWS DataSync's
- // API operation DescribeLocationNfs for usage and error information.
- //
- // Returned Error Codes:
- // * ErrCodeInvalidRequestException "InvalidRequestException"
- // This exception is thrown when the client submits a malformed request.
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeLocationNfs
- func (c *DataSync) DescribeLocationNfs(input *DescribeLocationNfsInput) (*DescribeLocationNfsOutput, error) {
- req, out := c.DescribeLocationNfsRequest(input)
- return out, req.Send()
- }
- // DescribeLocationNfsWithContext is the same as DescribeLocationNfs with the addition of
- // the ability to pass a context and additional request options.
- //
- // See DescribeLocationNfs for details on how to use this API operation.
- //
- // The context must be non-nil and will be used for request cancellation. If
- // the context is nil a panic will occur. In the future the SDK may create
- // sub-contexts for http.Requests. See https://golang.org/pkg/context/
- // for more information on using Contexts.
- func (c *DataSync) DescribeLocationNfsWithContext(ctx aws.Context, input *DescribeLocationNfsInput, opts ...request.Option) (*DescribeLocationNfsOutput, error) {
- req, out := c.DescribeLocationNfsRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opDescribeLocationS3 = "DescribeLocationS3"
- // DescribeLocationS3Request generates a "aws/request.Request" representing the
- // client's request for the DescribeLocationS3 operation. The "output" return
- // value will be populated with the request's response once the request completes
- // successfully.
- //
- // Use "Send" method on the returned Request to send the API call to the service.
- // the "output" return value is not valid until after Send returns without error.
- //
- // See DescribeLocationS3 for more information on using the DescribeLocationS3
- // API call, and error handling.
- //
- // This method is useful when you want to inject custom logic or configuration
- // into the SDK's request lifecycle. Such as custom headers, or retry logic.
- //
- //
- // // Example sending a request using the DescribeLocationS3Request method.
- // req, resp := client.DescribeLocationS3Request(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeLocationS3
- func (c *DataSync) DescribeLocationS3Request(input *DescribeLocationS3Input) (req *request.Request, output *DescribeLocationS3Output) {
- op := &request.Operation{
- Name: opDescribeLocationS3,
- HTTPMethod: "POST",
- HTTPPath: "/",
- }
- if input == nil {
- input = &DescribeLocationS3Input{}
- }
- output = &DescribeLocationS3Output{}
- req = c.newRequest(op, input, output)
- return
- }
- // DescribeLocationS3 API operation for AWS DataSync.
- //
- // Returns metadata, such as bucket name, about an Amazon S3 bucket location.
- //
- // Returns awserr.Error for service API and SDK errors. Use runtime type assertions
- // with awserr.Error's Code and Message methods to get detailed information about
- // the error.
- //
- // See the AWS API reference guide for AWS DataSync's
- // API operation DescribeLocationS3 for usage and error information.
- //
- // Returned Error Codes:
- // * ErrCodeInvalidRequestException "InvalidRequestException"
- // This exception is thrown when the client submits a malformed request.
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeLocationS3
- func (c *DataSync) DescribeLocationS3(input *DescribeLocationS3Input) (*DescribeLocationS3Output, error) {
- req, out := c.DescribeLocationS3Request(input)
- return out, req.Send()
- }
- // DescribeLocationS3WithContext is the same as DescribeLocationS3 with the addition of
- // the ability to pass a context and additional request options.
- //
- // See DescribeLocationS3 for details on how to use this API operation.
- //
- // The context must be non-nil and will be used for request cancellation. If
- // the context is nil a panic will occur. In the future the SDK may create
- // sub-contexts for http.Requests. See https://golang.org/pkg/context/
- // for more information on using Contexts.
- func (c *DataSync) DescribeLocationS3WithContext(ctx aws.Context, input *DescribeLocationS3Input, opts ...request.Option) (*DescribeLocationS3Output, error) {
- req, out := c.DescribeLocationS3Request(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opDescribeTask = "DescribeTask"
- // DescribeTaskRequest generates a "aws/request.Request" representing the
- // client's request for the DescribeTask operation. The "output" return
- // value will be populated with the request's response once the request completes
- // successfully.
- //
- // Use "Send" method on the returned Request to send the API call to the service.
- // the "output" return value is not valid until after Send returns without error.
- //
- // See DescribeTask for more information on using the DescribeTask
- // API call, and error handling.
- //
- // This method is useful when you want to inject custom logic or configuration
- // into the SDK's request lifecycle. Such as custom headers, or retry logic.
- //
- //
- // // Example sending a request using the DescribeTaskRequest method.
- // req, resp := client.DescribeTaskRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeTask
- func (c *DataSync) DescribeTaskRequest(input *DescribeTaskInput) (req *request.Request, output *DescribeTaskOutput) {
- op := &request.Operation{
- Name: opDescribeTask,
- HTTPMethod: "POST",
- HTTPPath: "/",
- }
- if input == nil {
- input = &DescribeTaskInput{}
- }
- output = &DescribeTaskOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // DescribeTask API operation for AWS DataSync.
- //
- // Returns metadata about a task.
- //
- // Returns awserr.Error for service API and SDK errors. Use runtime type assertions
- // with awserr.Error's Code and Message methods to get detailed information about
- // the error.
- //
- // See the AWS API reference guide for AWS DataSync's
- // API operation DescribeTask for usage and error information.
- //
- // Returned Error Codes:
- // * ErrCodeInvalidRequestException "InvalidRequestException"
- // This exception is thrown when the client submits a malformed request.
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeTask
- func (c *DataSync) DescribeTask(input *DescribeTaskInput) (*DescribeTaskOutput, error) {
- req, out := c.DescribeTaskRequest(input)
- return out, req.Send()
- }
- // DescribeTaskWithContext is the same as DescribeTask with the addition of
- // the ability to pass a context and additional request options.
- //
- // See DescribeTask for details on how to use this API operation.
- //
- // The context must be non-nil and will be used for request cancellation. If
- // the context is nil a panic will occur. In the future the SDK may create
- // sub-contexts for http.Requests. See https://golang.org/pkg/context/
- // for more information on using Contexts.
- func (c *DataSync) DescribeTaskWithContext(ctx aws.Context, input *DescribeTaskInput, opts ...request.Option) (*DescribeTaskOutput, error) {
- req, out := c.DescribeTaskRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opDescribeTaskExecution = "DescribeTaskExecution"
- // DescribeTaskExecutionRequest generates a "aws/request.Request" representing the
- // client's request for the DescribeTaskExecution operation. The "output" return
- // value will be populated with the request's response once the request completes
- // successfully.
- //
- // Use "Send" method on the returned Request to send the API call to the service.
- // the "output" return value is not valid until after Send returns without error.
- //
- // See DescribeTaskExecution for more information on using the DescribeTaskExecution
- // API call, and error handling.
- //
- // This method is useful when you want to inject custom logic or configuration
- // into the SDK's request lifecycle. Such as custom headers, or retry logic.
- //
- //
- // // Example sending a request using the DescribeTaskExecutionRequest method.
- // req, resp := client.DescribeTaskExecutionRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeTaskExecution
- func (c *DataSync) DescribeTaskExecutionRequest(input *DescribeTaskExecutionInput) (req *request.Request, output *DescribeTaskExecutionOutput) {
- op := &request.Operation{
- Name: opDescribeTaskExecution,
- HTTPMethod: "POST",
- HTTPPath: "/",
- }
- if input == nil {
- input = &DescribeTaskExecutionInput{}
- }
- output = &DescribeTaskExecutionOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // DescribeTaskExecution API operation for AWS DataSync.
- //
- // Returns detailed metadata about a task that is being executed.
- //
- // Returns awserr.Error for service API and SDK errors. Use runtime type assertions
- // with awserr.Error's Code and Message methods to get detailed information about
- // the error.
- //
- // See the AWS API reference guide for AWS DataSync's
- // API operation DescribeTaskExecution for usage and error information.
- //
- // Returned Error Codes:
- // * ErrCodeInvalidRequestException "InvalidRequestException"
- // This exception is thrown when the client submits a malformed request.
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeTaskExecution
- func (c *DataSync) DescribeTaskExecution(input *DescribeTaskExecutionInput) (*DescribeTaskExecutionOutput, error) {
- req, out := c.DescribeTaskExecutionRequest(input)
- return out, req.Send()
- }
- // DescribeTaskExecutionWithContext is the same as DescribeTaskExecution with the addition of
- // the ability to pass a context and additional request options.
- //
- // See DescribeTaskExecution for details on how to use this API operation.
- //
- // The context must be non-nil and will be used for request cancellation. If
- // the context is nil a panic will occur. In the future the SDK may create
- // sub-contexts for http.Requests. See https://golang.org/pkg/context/
- // for more information on using Contexts.
- func (c *DataSync) DescribeTaskExecutionWithContext(ctx aws.Context, input *DescribeTaskExecutionInput, opts ...request.Option) (*DescribeTaskExecutionOutput, error) {
- req, out := c.DescribeTaskExecutionRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opListAgents = "ListAgents"
- // ListAgentsRequest generates a "aws/request.Request" representing the
- // client's request for the ListAgents operation. The "output" return
- // value will be populated with the request's response once the request completes
- // successfully.
- //
- // Use "Send" method on the returned Request to send the API call to the service.
- // the "output" return value is not valid until after Send returns without error.
- //
- // See ListAgents for more information on using the ListAgents
- // API call, and error handling.
- //
- // This method is useful when you want to inject custom logic or configuration
- // into the SDK's request lifecycle. Such as custom headers, or retry logic.
- //
- //
- // // Example sending a request using the ListAgentsRequest method.
- // req, resp := client.ListAgentsRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/ListAgents
- func (c *DataSync) ListAgentsRequest(input *ListAgentsInput) (req *request.Request, output *ListAgentsOutput) {
- op := &request.Operation{
- Name: opListAgents,
- HTTPMethod: "POST",
- HTTPPath: "/",
- Paginator: &request.Paginator{
- InputTokens: []string{"NextToken"},
- OutputTokens: []string{"NextToken"},
- LimitToken: "MaxResults",
- TruncationToken: "",
- },
- }
- if input == nil {
- input = &ListAgentsInput{}
- }
- output = &ListAgentsOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // ListAgents API operation for AWS DataSync.
- //
- // Returns a list of agents owned by an AWS account in the AWS Region specified
- // in the request. The returned list is ordered by agent Amazon Resource Name
- // (ARN).
- //
- // By default, this operation returns a maximum of 100 agents. This operation
- // supports pagination that enables you to optionally reduce the number of agents
- // returned in a response.
- //
- // If you have more agents than are returned in a response (that is, the response
- // returns only a truncated list of your agents), the response contains a marker
- // that you can specify in your next request to fetch the next page of agents.
- //
- // Returns awserr.Error for service API and SDK errors. Use runtime type assertions
- // with awserr.Error's Code and Message methods to get detailed information about
- // the error.
- //
- // See the AWS API reference guide for AWS DataSync's
- // API operation ListAgents for usage and error information.
- //
- // Returned Error Codes:
- // * ErrCodeInvalidRequestException "InvalidRequestException"
- // This exception is thrown when the client submits a malformed request.
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/ListAgents
- func (c *DataSync) ListAgents(input *ListAgentsInput) (*ListAgentsOutput, error) {
- req, out := c.ListAgentsRequest(input)
- return out, req.Send()
- }
- // ListAgentsWithContext is the same as ListAgents with the addition of
- // the ability to pass a context and additional request options.
- //
- // See ListAgents for details on how to use this API operation.
- //
- // The context must be non-nil and will be used for request cancellation. If
- // the context is nil a panic will occur. In the future the SDK may create
- // sub-contexts for http.Requests. See https://golang.org/pkg/context/
- // for more information on using Contexts.
- func (c *DataSync) ListAgentsWithContext(ctx aws.Context, input *ListAgentsInput, opts ...request.Option) (*ListAgentsOutput, error) {
- req, out := c.ListAgentsRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- // ListAgentsPages iterates over the pages of a ListAgents operation,
- // calling the "fn" function with the response data for each page. To stop
- // iterating, return false from the fn function.
- //
- // See ListAgents method for more information on how to use this operation.
- //
- // Note: This operation can generate multiple requests to a service.
- //
- // // Example iterating over at most 3 pages of a ListAgents operation.
- // pageNum := 0
- // err := client.ListAgentsPages(params,
- // func(page *ListAgentsOutput, lastPage bool) bool {
- // pageNum++
- // fmt.Println(page)
- // return pageNum <= 3
- // })
- //
- func (c *DataSync) ListAgentsPages(input *ListAgentsInput, fn func(*ListAgentsOutput, bool) bool) error {
- return c.ListAgentsPagesWithContext(aws.BackgroundContext(), input, fn)
- }
- // ListAgentsPagesWithContext same as ListAgentsPages except
- // it takes a Context and allows setting request options on the pages.
- //
- // The context must be non-nil and will be used for request cancellation. If
- // the context is nil a panic will occur. In the future the SDK may create
- // sub-contexts for http.Requests. See https://golang.org/pkg/context/
- // for more information on using Contexts.
- func (c *DataSync) ListAgentsPagesWithContext(ctx aws.Context, input *ListAgentsInput, fn func(*ListAgentsOutput, bool) bool, opts ...request.Option) error {
- p := request.Pagination{
- NewRequest: func() (*request.Request, error) {
- var inCpy *ListAgentsInput
- if input != nil {
- tmp := *input
- inCpy = &tmp
- }
- req, _ := c.ListAgentsRequest(inCpy)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return req, nil
- },
- }
- cont := true
- for p.Next() && cont {
- cont = fn(p.Page().(*ListAgentsOutput), !p.HasNextPage())
- }
- return p.Err()
- }
- const opListLocations = "ListLocations"
- // ListLocationsRequest generates a "aws/request.Request" representing the
- // client's request for the ListLocations operation. The "output" return
- // value will be populated with the request's response once the request completes
- // successfully.
- //
- // Use "Send" method on the returned Request to send the API call to the service.
- // the "output" return value is not valid until after Send returns without error.
- //
- // See ListLocations for more information on using the ListLocations
- // API call, and error handling.
- //
- // This method is useful when you want to inject custom logic or configuration
- // into the SDK's request lifecycle. Such as custom headers, or retry logic.
- //
- //
- // // Example sending a request using the ListLocationsRequest method.
- // req, resp := client.ListLocationsRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/ListLocations
- func (c *DataSync) ListLocationsRequest(input *ListLocationsInput) (req *request.Request, output *ListLocationsOutput) {
- op := &request.Operation{
- Name: opListLocations,
- HTTPMethod: "POST",
- HTTPPath: "/",
- Paginator: &request.Paginator{
- InputTokens: []string{"NextToken"},
- OutputTokens: []string{"NextToken"},
- LimitToken: "MaxResults",
- TruncationToken: "",
- },
- }
- if input == nil {
- input = &ListLocationsInput{}
- }
- output = &ListLocationsOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // ListLocations API operation for AWS DataSync.
- //
- // Returns a lists of source and destination locations.
- //
- // If you have more locations than are returned in a response (that is, the
- // response returns only a truncated list of your agents), the response contains
- // a token that you can specify in your next request to fetch the next page
- // of locations.
- //
- // Returns awserr.Error for service API and SDK errors. Use runtime type assertions
- // with awserr.Error's Code and Message methods to get detailed information about
- // the error.
- //
- // See the AWS API reference guide for AWS DataSync's
- // API operation ListLocations for usage and error information.
- //
- // Returned Error Codes:
- // * ErrCodeInvalidRequestException "InvalidRequestException"
- // This exception is thrown when the client submits a malformed request.
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/ListLocations
- func (c *DataSync) ListLocations(input *ListLocationsInput) (*ListLocationsOutput, error) {
- req, out := c.ListLocationsRequest(input)
- return out, req.Send()
- }
- // ListLocationsWithContext is the same as ListLocations with the addition of
- // the ability to pass a context and additional request options.
- //
- // See ListLocations for details on how to use this API operation.
- //
- // The context must be non-nil and will be used for request cancellation. If
- // the context is nil a panic will occur. In the future the SDK may create
- // sub-contexts for http.Requests. See https://golang.org/pkg/context/
- // for more information on using Contexts.
- func (c *DataSync) ListLocationsWithContext(ctx aws.Context, input *ListLocationsInput, opts ...request.Option) (*ListLocationsOutput, error) {
- req, out := c.ListLocationsRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- // ListLocationsPages iterates over the pages of a ListLocations operation,
- // calling the "fn" function with the response data for each page. To stop
- // iterating, return false from the fn function.
- //
- // See ListLocations method for more information on how to use this operation.
- //
- // Note: This operation can generate multiple requests to a service.
- //
- // // Example iterating over at most 3 pages of a ListLocations operation.
- // pageNum := 0
- // err := client.ListLocationsPages(params,
- // func(page *ListLocationsOutput, lastPage bool) bool {
- // pageNum++
- // fmt.Println(page)
- // return pageNum <= 3
- // })
- //
- func (c *DataSync) ListLocationsPages(input *ListLocationsInput, fn func(*ListLocationsOutput, bool) bool) error {
- return c.ListLocationsPagesWithContext(aws.BackgroundContext(), input, fn)
- }
- // ListLocationsPagesWithContext same as ListLocationsPages except
- // it takes a Context and allows setting request options on the pages.
- //
- // The context must be non-nil and will be used for request cancellation. If
- // the context is nil a panic will occur. In the future the SDK may create
- // sub-contexts for http.Requests. See https://golang.org/pkg/context/
- // for more information on using Contexts.
- func (c *DataSync) ListLocationsPagesWithContext(ctx aws.Context, input *ListLocationsInput, fn func(*ListLocationsOutput, bool) bool, opts ...request.Option) error {
- p := request.Pagination{
- NewRequest: func() (*request.Request, error) {
- var inCpy *ListLocationsInput
- if input != nil {
- tmp := *input
- inCpy = &tmp
- }
- req, _ := c.ListLocationsRequest(inCpy)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return req, nil
- },
- }
- cont := true
- for p.Next() && cont {
- cont = fn(p.Page().(*ListLocationsOutput), !p.HasNextPage())
- }
- return p.Err()
- }
- const opListTagsForResource = "ListTagsForResource"
- // ListTagsForResourceRequest generates a "aws/request.Request" representing the
- // client's request for the ListTagsForResource operation. The "output" return
- // value will be populated with the request's response once the request completes
- // successfully.
- //
- // Use "Send" method on the returned Request to send the API call to the service.
- // the "output" return value is not valid until after Send returns without error.
- //
- // See ListTagsForResource for more information on using the ListTagsForResource
- // API call, and error handling.
- //
- // This method is useful when you want to inject custom logic or configuration
- // into the SDK's request lifecycle. Such as custom headers, or retry logic.
- //
- //
- // // Example sending a request using the ListTagsForResourceRequest method.
- // req, resp := client.ListTagsForResourceRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/ListTagsForResource
- func (c *DataSync) ListTagsForResourceRequest(input *ListTagsForResourceInput) (req *request.Request, output *ListTagsForResourceOutput) {
- op := &request.Operation{
- Name: opListTagsForResource,
- HTTPMethod: "POST",
- HTTPPath: "/",
- Paginator: &request.Paginator{
- InputTokens: []string{"NextToken"},
- OutputTokens: []string{"NextToken"},
- LimitToken: "MaxResults",
- TruncationToken: "",
- },
- }
- if input == nil {
- input = &ListTagsForResourceInput{}
- }
- output = &ListTagsForResourceOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // ListTagsForResource API operation for AWS DataSync.
- //
- // Returns all the tags associated with a specified resources.
- //
- // Returns awserr.Error for service API and SDK errors. Use runtime type assertions
- // with awserr.Error's Code and Message methods to get detailed information about
- // the error.
- //
- // See the AWS API reference guide for AWS DataSync's
- // API operation ListTagsForResource for usage and error information.
- //
- // Returned Error Codes:
- // * ErrCodeInvalidRequestException "InvalidRequestException"
- // This exception is thrown when the client submits a malformed request.
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/ListTagsForResource
- func (c *DataSync) ListTagsForResource(input *ListTagsForResourceInput) (*ListTagsForResourceOutput, error) {
- req, out := c.ListTagsForResourceRequest(input)
- return out, req.Send()
- }
- // ListTagsForResourceWithContext is the same as ListTagsForResource with the addition of
- // the ability to pass a context and additional request options.
- //
- // See ListTagsForResource for details on how to use this API operation.
- //
- // The context must be non-nil and will be used for request cancellation. If
- // the context is nil a panic will occur. In the future the SDK may create
- // sub-contexts for http.Requests. See https://golang.org/pkg/context/
- // for more information on using Contexts.
- func (c *DataSync) ListTagsForResourceWithContext(ctx aws.Context, input *ListTagsForResourceInput, opts ...request.Option) (*ListTagsForResourceOutput, error) {
- req, out := c.ListTagsForResourceRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- // ListTagsForResourcePages iterates over the pages of a ListTagsForResource operation,
- // calling the "fn" function with the response data for each page. To stop
- // iterating, return false from the fn function.
- //
- // See ListTagsForResource method for more information on how to use this operation.
- //
- // Note: This operation can generate multiple requests to a service.
- //
- // // Example iterating over at most 3 pages of a ListTagsForResource operation.
- // pageNum := 0
- // err := client.ListTagsForResourcePages(params,
- // func(page *ListTagsForResourceOutput, lastPage bool) bool {
- // pageNum++
- // fmt.Println(page)
- // return pageNum <= 3
- // })
- //
- func (c *DataSync) ListTagsForResourcePages(input *ListTagsForResourceInput, fn func(*ListTagsForResourceOutput, bool) bool) error {
- return c.ListTagsForResourcePagesWithContext(aws.BackgroundContext(), input, fn)
- }
- // ListTagsForResourcePagesWithContext same as ListTagsForResourcePages except
- // it takes a Context and allows setting request options on the pages.
- //
- // The context must be non-nil and will be used for request cancellation. If
- // the context is nil a panic will occur. In the future the SDK may create
- // sub-contexts for http.Requests. See https://golang.org/pkg/context/
- // for more information on using Contexts.
- func (c *DataSync) ListTagsForResourcePagesWithContext(ctx aws.Context, input *ListTagsForResourceInput, fn func(*ListTagsForResourceOutput, bool) bool, opts ...request.Option) error {
- p := request.Pagination{
- NewRequest: func() (*request.Request, error) {
- var inCpy *ListTagsForResourceInput
- if input != nil {
- tmp := *input
- inCpy = &tmp
- }
- req, _ := c.ListTagsForResourceRequest(inCpy)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return req, nil
- },
- }
- cont := true
- for p.Next() && cont {
- cont = fn(p.Page().(*ListTagsForResourceOutput), !p.HasNextPage())
- }
- return p.Err()
- }
- const opListTaskExecutions = "ListTaskExecutions"
- // ListTaskExecutionsRequest generates a "aws/request.Request" representing the
- // client's request for the ListTaskExecutions operation. The "output" return
- // value will be populated with the request's response once the request completes
- // successfully.
- //
- // Use "Send" method on the returned Request to send the API call to the service.
- // the "output" return value is not valid until after Send returns without error.
- //
- // See ListTaskExecutions for more information on using the ListTaskExecutions
- // API call, and error handling.
- //
- // This method is useful when you want to inject custom logic or configuration
- // into the SDK's request lifecycle. Such as custom headers, or retry logic.
- //
- //
- // // Example sending a request using the ListTaskExecutionsRequest method.
- // req, resp := client.ListTaskExecutionsRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/ListTaskExecutions
- func (c *DataSync) ListTaskExecutionsRequest(input *ListTaskExecutionsInput) (req *request.Request, output *ListTaskExecutionsOutput) {
- op := &request.Operation{
- Name: opListTaskExecutions,
- HTTPMethod: "POST",
- HTTPPath: "/",
- Paginator: &request.Paginator{
- InputTokens: []string{"NextToken"},
- OutputTokens: []string{"NextToken"},
- LimitToken: "MaxResults",
- TruncationToken: "",
- },
- }
- if input == nil {
- input = &ListTaskExecutionsInput{}
- }
- output = &ListTaskExecutionsOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // ListTaskExecutions API operation for AWS DataSync.
- //
- // Returns a list of executed tasks.
- //
- // Returns awserr.Error for service API and SDK errors. Use runtime type assertions
- // with awserr.Error's Code and Message methods to get detailed information about
- // the error.
- //
- // See the AWS API reference guide for AWS DataSync's
- // API operation ListTaskExecutions for usage and error information.
- //
- // Returned Error Codes:
- // * ErrCodeInvalidRequestException "InvalidRequestException"
- // This exception is thrown when the client submits a malformed request.
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/ListTaskExecutions
- func (c *DataSync) ListTaskExecutions(input *ListTaskExecutionsInput) (*ListTaskExecutionsOutput, error) {
- req, out := c.ListTaskExecutionsRequest(input)
- return out, req.Send()
- }
- // ListTaskExecutionsWithContext is the same as ListTaskExecutions with the addition of
- // the ability to pass a context and additional request options.
- //
- // See ListTaskExecutions for details on how to use this API operation.
- //
- // The context must be non-nil and will be used for request cancellation. If
- // the context is nil a panic will occur. In the future the SDK may create
- // sub-contexts for http.Requests. See https://golang.org/pkg/context/
- // for more information on using Contexts.
- func (c *DataSync) ListTaskExecutionsWithContext(ctx aws.Context, input *ListTaskExecutionsInput, opts ...request.Option) (*ListTaskExecutionsOutput, error) {
- req, out := c.ListTaskExecutionsRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- // ListTaskExecutionsPages iterates over the pages of a ListTaskExecutions operation,
- // calling the "fn" function with the response data for each page. To stop
- // iterating, return false from the fn function.
- //
- // See ListTaskExecutions method for more information on how to use this operation.
- //
- // Note: This operation can generate multiple requests to a service.
- //
- // // Example iterating over at most 3 pages of a ListTaskExecutions operation.
- // pageNum := 0
- // err := client.ListTaskExecutionsPages(params,
- // func(page *ListTaskExecutionsOutput, lastPage bool) bool {
- // pageNum++
- // fmt.Println(page)
- // return pageNum <= 3
- // })
- //
- func (c *DataSync) ListTaskExecutionsPages(input *ListTaskExecutionsInput, fn func(*ListTaskExecutionsOutput, bool) bool) error {
- return c.ListTaskExecutionsPagesWithContext(aws.BackgroundContext(), input, fn)
- }
- // ListTaskExecutionsPagesWithContext same as ListTaskExecutionsPages except
- // it takes a Context and allows setting request options on the pages.
- //
- // The context must be non-nil and will be used for request cancellation. If
- // the context is nil a panic will occur. In the future the SDK may create
- // sub-contexts for http.Requests. See https://golang.org/pkg/context/
- // for more information on using Contexts.
- func (c *DataSync) ListTaskExecutionsPagesWithContext(ctx aws.Context, input *ListTaskExecutionsInput, fn func(*ListTaskExecutionsOutput, bool) bool, opts ...request.Option) error {
- p := request.Pagination{
- NewRequest: func() (*request.Request, error) {
- var inCpy *ListTaskExecutionsInput
- if input != nil {
- tmp := *input
- inCpy = &tmp
- }
- req, _ := c.ListTaskExecutionsRequest(inCpy)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return req, nil
- },
- }
- cont := true
- for p.Next() && cont {
- cont = fn(p.Page().(*ListTaskExecutionsOutput), !p.HasNextPage())
- }
- return p.Err()
- }
- const opListTasks = "ListTasks"
- // ListTasksRequest generates a "aws/request.Request" representing the
- // client's request for the ListTasks operation. The "output" return
- // value will be populated with the request's response once the request completes
- // successfully.
- //
- // Use "Send" method on the returned Request to send the API call to the service.
- // the "output" return value is not valid until after Send returns without error.
- //
- // See ListTasks for more information on using the ListTasks
- // API call, and error handling.
- //
- // This method is useful when you want to inject custom logic or configuration
- // into the SDK's request lifecycle. Such as custom headers, or retry logic.
- //
- //
- // // Example sending a request using the ListTasksRequest method.
- // req, resp := client.ListTasksRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/ListTasks
- func (c *DataSync) ListTasksRequest(input *ListTasksInput) (req *request.Request, output *ListTasksOutput) {
- op := &request.Operation{
- Name: opListTasks,
- HTTPMethod: "POST",
- HTTPPath: "/",
- Paginator: &request.Paginator{
- InputTokens: []string{"NextToken"},
- OutputTokens: []string{"NextToken"},
- LimitToken: "MaxResults",
- TruncationToken: "",
- },
- }
- if input == nil {
- input = &ListTasksInput{}
- }
- output = &ListTasksOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // ListTasks API operation for AWS DataSync.
- //
- // Returns a list of all the tasks.
- //
- // Returns awserr.Error for service API and SDK errors. Use runtime type assertions
- // with awserr.Error's Code and Message methods to get detailed information about
- // the error.
- //
- // See the AWS API reference guide for AWS DataSync's
- // API operation ListTasks for usage and error information.
- //
- // Returned Error Codes:
- // * ErrCodeInvalidRequestException "InvalidRequestException"
- // This exception is thrown when the client submits a malformed request.
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/ListTasks
- func (c *DataSync) ListTasks(input *ListTasksInput) (*ListTasksOutput, error) {
- req, out := c.ListTasksRequest(input)
- return out, req.Send()
- }
- // ListTasksWithContext is the same as ListTasks with the addition of
- // the ability to pass a context and additional request options.
- //
- // See ListTasks for details on how to use this API operation.
- //
- // The context must be non-nil and will be used for request cancellation. If
- // the context is nil a panic will occur. In the future the SDK may create
- // sub-contexts for http.Requests. See https://golang.org/pkg/context/
- // for more information on using Contexts.
- func (c *DataSync) ListTasksWithContext(ctx aws.Context, input *ListTasksInput, opts ...request.Option) (*ListTasksOutput, error) {
- req, out := c.ListTasksRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- // ListTasksPages iterates over the pages of a ListTasks operation,
- // calling the "fn" function with the response data for each page. To stop
- // iterating, return false from the fn function.
- //
- // See ListTasks method for more information on how to use this operation.
- //
- // Note: This operation can generate multiple requests to a service.
- //
- // // Example iterating over at most 3 pages of a ListTasks operation.
- // pageNum := 0
- // err := client.ListTasksPages(params,
- // func(page *ListTasksOutput, lastPage bool) bool {
- // pageNum++
- // fmt.Println(page)
- // return pageNum <= 3
- // })
- //
- func (c *DataSync) ListTasksPages(input *ListTasksInput, fn func(*ListTasksOutput, bool) bool) error {
- return c.ListTasksPagesWithContext(aws.BackgroundContext(), input, fn)
- }
- // ListTasksPagesWithContext same as ListTasksPages except
- // it takes a Context and allows setting request options on the pages.
- //
- // The context must be non-nil and will be used for request cancellation. If
- // the context is nil a panic will occur. In the future the SDK may create
- // sub-contexts for http.Requests. See https://golang.org/pkg/context/
- // for more information on using Contexts.
- func (c *DataSync) ListTasksPagesWithContext(ctx aws.Context, input *ListTasksInput, fn func(*ListTasksOutput, bool) bool, opts ...request.Option) error {
- p := request.Pagination{
- NewRequest: func() (*request.Request, error) {
- var inCpy *ListTasksInput
- if input != nil {
- tmp := *input
- inCpy = &tmp
- }
- req, _ := c.ListTasksRequest(inCpy)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return req, nil
- },
- }
- cont := true
- for p.Next() && cont {
- cont = fn(p.Page().(*ListTasksOutput), !p.HasNextPage())
- }
- return p.Err()
- }
- const opStartTaskExecution = "StartTaskExecution"
- // StartTaskExecutionRequest generates a "aws/request.Request" representing the
- // client's request for the StartTaskExecution operation. The "output" return
- // value will be populated with the request's response once the request completes
- // successfully.
- //
- // Use "Send" method on the returned Request to send the API call to the service.
- // the "output" return value is not valid until after Send returns without error.
- //
- // See StartTaskExecution for more information on using the StartTaskExecution
- // API call, and error handling.
- //
- // This method is useful when you want to inject custom logic or configuration
- // into the SDK's request lifecycle. Such as custom headers, or retry logic.
- //
- //
- // // Example sending a request using the StartTaskExecutionRequest method.
- // req, resp := client.StartTaskExecutionRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/StartTaskExecution
- func (c *DataSync) StartTaskExecutionRequest(input *StartTaskExecutionInput) (req *request.Request, output *StartTaskExecutionOutput) {
- op := &request.Operation{
- Name: opStartTaskExecution,
- HTTPMethod: "POST",
- HTTPPath: "/",
- }
- if input == nil {
- input = &StartTaskExecutionInput{}
- }
- output = &StartTaskExecutionOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // StartTaskExecution API operation for AWS DataSync.
- //
- // Starts a specific invocation of a task. A TaskExecution value represents
- // an individual run of a task. Each task can have at most one TaskExecution
- // at a time.
- //
- // TaskExecution has the following transition phases: INITIALIZING | PREPARING
- // | TRANSFERRING | VERIFYING | SUCCESS/FAILURE.
- //
- // For detailed information, see Task Execution in Components and Terminology
- // (https://docs.aws.amazon.com/sync-service/latest/userguide/how-awssync-works.html#terminology)
- // in the AWS DataSync User Guide.
- //
- // Returns awserr.Error for service API and SDK errors. Use runtime type assertions
- // with awserr.Error's Code and Message methods to get detailed information about
- // the error.
- //
- // See the AWS API reference guide for AWS DataSync's
- // API operation StartTaskExecution for usage and error information.
- //
- // Returned Error Codes:
- // * ErrCodeInvalidRequestException "InvalidRequestException"
- // This exception is thrown when the client submits a malformed request.
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/StartTaskExecution
- func (c *DataSync) StartTaskExecution(input *StartTaskExecutionInput) (*StartTaskExecutionOutput, error) {
- req, out := c.StartTaskExecutionRequest(input)
- return out, req.Send()
- }
- // StartTaskExecutionWithContext is the same as StartTaskExecution with the addition of
- // the ability to pass a context and additional request options.
- //
- // See StartTaskExecution for details on how to use this API operation.
- //
- // The context must be non-nil and will be used for request cancellation. If
- // the context is nil a panic will occur. In the future the SDK may create
- // sub-contexts for http.Requests. See https://golang.org/pkg/context/
- // for more information on using Contexts.
- func (c *DataSync) StartTaskExecutionWithContext(ctx aws.Context, input *StartTaskExecutionInput, opts ...request.Option) (*StartTaskExecutionOutput, error) {
- req, out := c.StartTaskExecutionRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opTagResource = "TagResource"
- // TagResourceRequest generates a "aws/request.Request" representing the
- // client's request for the TagResource operation. The "output" return
- // value will be populated with the request's response once the request completes
- // successfully.
- //
- // Use "Send" method on the returned Request to send the API call to the service.
- // the "output" return value is not valid until after Send returns without error.
- //
- // See TagResource for more information on using the TagResource
- // API call, and error handling.
- //
- // This method is useful when you want to inject custom logic or configuration
- // into the SDK's request lifecycle. Such as custom headers, or retry logic.
- //
- //
- // // Example sending a request using the TagResourceRequest method.
- // req, resp := client.TagResourceRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/TagResource
- func (c *DataSync) TagResourceRequest(input *TagResourceInput) (req *request.Request, output *TagResourceOutput) {
- op := &request.Operation{
- Name: opTagResource,
- HTTPMethod: "POST",
- HTTPPath: "/",
- }
- if input == nil {
- input = &TagResourceInput{}
- }
- output = &TagResourceOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Swap(jsonrpc.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler)
- return
- }
- // TagResource API operation for AWS DataSync.
- //
- // Applies a key-value pair to an AWS resource.
- //
- // Returns awserr.Error for service API and SDK errors. Use runtime type assertions
- // with awserr.Error's Code and Message methods to get detailed information about
- // the error.
- //
- // See the AWS API reference guide for AWS DataSync's
- // API operation TagResource for usage and error information.
- //
- // Returned Error Codes:
- // * ErrCodeInvalidRequestException "InvalidRequestException"
- // This exception is thrown when the client submits a malformed request.
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/TagResource
- func (c *DataSync) TagResource(input *TagResourceInput) (*TagResourceOutput, error) {
- req, out := c.TagResourceRequest(input)
- return out, req.Send()
- }
- // TagResourceWithContext is the same as TagResource with the addition of
- // the ability to pass a context and additional request options.
- //
- // See TagResource for details on how to use this API operation.
- //
- // The context must be non-nil and will be used for request cancellation. If
- // the context is nil a panic will occur. In the future the SDK may create
- // sub-contexts for http.Requests. See https://golang.org/pkg/context/
- // for more information on using Contexts.
- func (c *DataSync) TagResourceWithContext(ctx aws.Context, input *TagResourceInput, opts ...request.Option) (*TagResourceOutput, error) {
- req, out := c.TagResourceRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opUntagResource = "UntagResource"
- // UntagResourceRequest generates a "aws/request.Request" representing the
- // client's request for the UntagResource operation. The "output" return
- // value will be populated with the request's response once the request completes
- // successfully.
- //
- // Use "Send" method on the returned Request to send the API call to the service.
- // the "output" return value is not valid until after Send returns without error.
- //
- // See UntagResource for more information on using the UntagResource
- // API call, and error handling.
- //
- // This method is useful when you want to inject custom logic or configuration
- // into the SDK's request lifecycle. Such as custom headers, or retry logic.
- //
- //
- // // Example sending a request using the UntagResourceRequest method.
- // req, resp := client.UntagResourceRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UntagResource
- func (c *DataSync) UntagResourceRequest(input *UntagResourceInput) (req *request.Request, output *UntagResourceOutput) {
- op := &request.Operation{
- Name: opUntagResource,
- HTTPMethod: "POST",
- HTTPPath: "/",
- }
- if input == nil {
- input = &UntagResourceInput{}
- }
- output = &UntagResourceOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Swap(jsonrpc.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler)
- return
- }
- // UntagResource API operation for AWS DataSync.
- //
- // Removes a tag from an AWS resource.
- //
- // Returns awserr.Error for service API and SDK errors. Use runtime type assertions
- // with awserr.Error's Code and Message methods to get detailed information about
- // the error.
- //
- // See the AWS API reference guide for AWS DataSync's
- // API operation UntagResource for usage and error information.
- //
- // Returned Error Codes:
- // * ErrCodeInvalidRequestException "InvalidRequestException"
- // This exception is thrown when the client submits a malformed request.
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UntagResource
- func (c *DataSync) UntagResource(input *UntagResourceInput) (*UntagResourceOutput, error) {
- req, out := c.UntagResourceRequest(input)
- return out, req.Send()
- }
- // UntagResourceWithContext is the same as UntagResource with the addition of
- // the ability to pass a context and additional request options.
- //
- // See UntagResource for details on how to use this API operation.
- //
- // The context must be non-nil and will be used for request cancellation. If
- // the context is nil a panic will occur. In the future the SDK may create
- // sub-contexts for http.Requests. See https://golang.org/pkg/context/
- // for more information on using Contexts.
- func (c *DataSync) UntagResourceWithContext(ctx aws.Context, input *UntagResourceInput, opts ...request.Option) (*UntagResourceOutput, error) {
- req, out := c.UntagResourceRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opUpdateAgent = "UpdateAgent"
- // UpdateAgentRequest generates a "aws/request.Request" representing the
- // client's request for the UpdateAgent operation. The "output" return
- // value will be populated with the request's response once the request completes
- // successfully.
- //
- // Use "Send" method on the returned Request to send the API call to the service.
- // the "output" return value is not valid until after Send returns without error.
- //
- // See UpdateAgent for more information on using the UpdateAgent
- // API call, and error handling.
- //
- // This method is useful when you want to inject custom logic or configuration
- // into the SDK's request lifecycle. Such as custom headers, or retry logic.
- //
- //
- // // Example sending a request using the UpdateAgentRequest method.
- // req, resp := client.UpdateAgentRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateAgent
- func (c *DataSync) UpdateAgentRequest(input *UpdateAgentInput) (req *request.Request, output *UpdateAgentOutput) {
- op := &request.Operation{
- Name: opUpdateAgent,
- HTTPMethod: "POST",
- HTTPPath: "/",
- }
- if input == nil {
- input = &UpdateAgentInput{}
- }
- output = &UpdateAgentOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Swap(jsonrpc.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler)
- return
- }
- // UpdateAgent API operation for AWS DataSync.
- //
- // Updates the name of an agent.
- //
- // Returns awserr.Error for service API and SDK errors. Use runtime type assertions
- // with awserr.Error's Code and Message methods to get detailed information about
- // the error.
- //
- // See the AWS API reference guide for AWS DataSync's
- // API operation UpdateAgent for usage and error information.
- //
- // Returned Error Codes:
- // * ErrCodeInvalidRequestException "InvalidRequestException"
- // This exception is thrown when the client submits a malformed request.
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateAgent
- func (c *DataSync) UpdateAgent(input *UpdateAgentInput) (*UpdateAgentOutput, error) {
- req, out := c.UpdateAgentRequest(input)
- return out, req.Send()
- }
- // UpdateAgentWithContext is the same as UpdateAgent with the addition of
- // the ability to pass a context and additional request options.
- //
- // See UpdateAgent for details on how to use this API operation.
- //
- // The context must be non-nil and will be used for request cancellation. If
- // the context is nil a panic will occur. In the future the SDK may create
- // sub-contexts for http.Requests. See https://golang.org/pkg/context/
- // for more information on using Contexts.
- func (c *DataSync) UpdateAgentWithContext(ctx aws.Context, input *UpdateAgentInput, opts ...request.Option) (*UpdateAgentOutput, error) {
- req, out := c.UpdateAgentRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opUpdateTask = "UpdateTask"
- // UpdateTaskRequest generates a "aws/request.Request" representing the
- // client's request for the UpdateTask operation. The "output" return
- // value will be populated with the request's response once the request completes
- // successfully.
- //
- // Use "Send" method on the returned Request to send the API call to the service.
- // the "output" return value is not valid until after Send returns without error.
- //
- // See UpdateTask for more information on using the UpdateTask
- // API call, and error handling.
- //
- // This method is useful when you want to inject custom logic or configuration
- // into the SDK's request lifecycle. Such as custom headers, or retry logic.
- //
- //
- // // Example sending a request using the UpdateTaskRequest method.
- // req, resp := client.UpdateTaskRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateTask
- func (c *DataSync) UpdateTaskRequest(input *UpdateTaskInput) (req *request.Request, output *UpdateTaskOutput) {
- op := &request.Operation{
- Name: opUpdateTask,
- HTTPMethod: "POST",
- HTTPPath: "/",
- }
- if input == nil {
- input = &UpdateTaskInput{}
- }
- output = &UpdateTaskOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Swap(jsonrpc.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler)
- return
- }
- // UpdateTask API operation for AWS DataSync.
- //
- // Updates the metadata associated with a task.
- //
- // Returns awserr.Error for service API and SDK errors. Use runtime type assertions
- // with awserr.Error's Code and Message methods to get detailed information about
- // the error.
- //
- // See the AWS API reference guide for AWS DataSync's
- // API operation UpdateTask for usage and error information.
- //
- // Returned Error Codes:
- // * ErrCodeInvalidRequestException "InvalidRequestException"
- // This exception is thrown when the client submits a malformed request.
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateTask
- func (c *DataSync) UpdateTask(input *UpdateTaskInput) (*UpdateTaskOutput, error) {
- req, out := c.UpdateTaskRequest(input)
- return out, req.Send()
- }
- // UpdateTaskWithContext is the same as UpdateTask with the addition of
- // the ability to pass a context and additional request options.
- //
- // See UpdateTask for details on how to use this API operation.
- //
- // The context must be non-nil and will be used for request cancellation. If
- // the context is nil a panic will occur. In the future the SDK may create
- // sub-contexts for http.Requests. See https://golang.org/pkg/context/
- // for more information on using Contexts.
- func (c *DataSync) UpdateTaskWithContext(ctx aws.Context, input *UpdateTaskInput, opts ...request.Option) (*UpdateTaskOutput, error) {
- req, out := c.UpdateTaskRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- // Represents a single entry in a list of agents. AgentListEntry returns an
- // array that contains a list of agents when the ListAgents operation is called.
- type AgentListEntry struct {
- _ struct{} `type:"structure"`
- // The Amazon Resource Name (ARN) of the agent.
- AgentArn *string `type:"string"`
- // The name of the agent.
- Name *string `min:"1" type:"string"`
- // The status of the agent.
- Status *string `type:"string" enum:"AgentStatus"`
- }
- // String returns the string representation
- func (s AgentListEntry) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s AgentListEntry) GoString() string {
- return s.String()
- }
- // SetAgentArn sets the AgentArn field's value.
- func (s *AgentListEntry) SetAgentArn(v string) *AgentListEntry {
- s.AgentArn = &v
- return s
- }
- // SetName sets the Name field's value.
- func (s *AgentListEntry) SetName(v string) *AgentListEntry {
- s.Name = &v
- return s
- }
- // SetStatus sets the Status field's value.
- func (s *AgentListEntry) SetStatus(v string) *AgentListEntry {
- s.Status = &v
- return s
- }
- // CancelTaskExecutionRequest
- type CancelTaskExecutionInput struct {
- _ struct{} `type:"structure"`
- // The Amazon Resource Name (ARN) of the task execution to cancel.
- //
- // TaskExecutionArn is a required field
- TaskExecutionArn *string `type:"string" required:"true"`
- }
- // String returns the string representation
- func (s CancelTaskExecutionInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s CancelTaskExecutionInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *CancelTaskExecutionInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "CancelTaskExecutionInput"}
- if s.TaskExecutionArn == nil {
- invalidParams.Add(request.NewErrParamRequired("TaskExecutionArn"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetTaskExecutionArn sets the TaskExecutionArn field's value.
- func (s *CancelTaskExecutionInput) SetTaskExecutionArn(v string) *CancelTaskExecutionInput {
- s.TaskExecutionArn = &v
- return s
- }
- type CancelTaskExecutionOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation
- func (s CancelTaskExecutionOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s CancelTaskExecutionOutput) GoString() string {
- return s.String()
- }
- // CreateAgentRequest
- type CreateAgentInput struct {
- _ struct{} `type:"structure"`
- // Your agent activation key. You can get the activation key either by sending
- // an HTTP GET request with redirects that enable you to get the agent IP address
- // (port 80). Alternatively, you can get it from the AWS DataSync console.
- //
- // The redirect URL returned in the response provides you the activation key
- // for your agent in the query string parameter activationKey. It might also
- // include other activation-related parameters; however, these are merely defaults.
- // The arguments you pass to this API call determine the actual configuration
- // of your agent. For more information, see Activating a Sync Agent (https://docs.aws.amazon.com/sync-service/latest/userguide/working-with-sync-agents.html#activating-sync-agent)
- // in the AWS DataSync User Guide.
- //
- // ActivationKey is a required field
- ActivationKey *string `type:"string" required:"true"`
- // The name you configured for your agent. This value is a text reference that
- // is used to identify the agent in the console.
- AgentName *string `min:"1" type:"string"`
- // The key-value pair that represents the tag you want to associate with the
- // agent. The value can be an empty string. This value helps you manage, filter,
- // and search for your agents.
- //
- // Valid characters for key and value are letters, spaces, and numbers representable
- // in UTF-8 format, and the following special characters: + - = . _ : / @.
- Tags []*TagListEntry `type:"list"`
- }
- // String returns the string representation
- func (s CreateAgentInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s CreateAgentInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *CreateAgentInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "CreateAgentInput"}
- if s.ActivationKey == nil {
- invalidParams.Add(request.NewErrParamRequired("ActivationKey"))
- }
- if s.AgentName != nil && len(*s.AgentName) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("AgentName", 1))
- }
- if s.Tags != nil {
- for i, v := range s.Tags {
- if v == nil {
- continue
- }
- if err := v.Validate(); err != nil {
- invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Tags", i), err.(request.ErrInvalidParams))
- }
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetActivationKey sets the ActivationKey field's value.
- func (s *CreateAgentInput) SetActivationKey(v string) *CreateAgentInput {
- s.ActivationKey = &v
- return s
- }
- // SetAgentName sets the AgentName field's value.
- func (s *CreateAgentInput) SetAgentName(v string) *CreateAgentInput {
- s.AgentName = &v
- return s
- }
- // SetTags sets the Tags field's value.
- func (s *CreateAgentInput) SetTags(v []*TagListEntry) *CreateAgentInput {
- s.Tags = v
- return s
- }
- // CreateAgentResponse
- type CreateAgentOutput struct {
- _ struct{} `type:"structure"`
- // The Amazon Resource Name (ARN) of the agent. Use the ListAgents operation
- // to return a list of agents for your account and AWS Region.
- AgentArn *string `type:"string"`
- }
- // String returns the string representation
- func (s CreateAgentOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s CreateAgentOutput) GoString() string {
- return s.String()
- }
- // SetAgentArn sets the AgentArn field's value.
- func (s *CreateAgentOutput) SetAgentArn(v string) *CreateAgentOutput {
- s.AgentArn = &v
- return s
- }
- // CreateLocationEfsRequest
- type CreateLocationEfsInput struct {
- _ struct{} `type:"structure"`
- // The subnet and security group that the Amazon EFS file system uses.
- //
- // Ec2Config is a required field
- Ec2Config *Ec2Config `type:"structure" required:"true"`
- // The Amazon Resource Name (ARN) for the Amazon EFS file system.
- //
- // EfsFilesystemArn is a required field
- EfsFilesystemArn *string `type:"string" required:"true"`
- // A subdirectory in the location’s path. This subdirectory in the EFS file
- // system is used to read data from the EFS source location or write data to
- // the EFS destination. By default, AWS DataSync uses the root directory.
- //
- // Subdirectory is a required field
- Subdirectory *string `type:"string" required:"true"`
- // The key-value pair that represents a tag that you want to add to the resource.
- // The value can be an empty string. This value helps you manage, filter, and
- // search for your resources. We recommend that you create a name tag for your
- // location.
- Tags []*TagListEntry `type:"list"`
- }
- // String returns the string representation
- func (s CreateLocationEfsInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s CreateLocationEfsInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *CreateLocationEfsInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "CreateLocationEfsInput"}
- if s.Ec2Config == nil {
- invalidParams.Add(request.NewErrParamRequired("Ec2Config"))
- }
- if s.EfsFilesystemArn == nil {
- invalidParams.Add(request.NewErrParamRequired("EfsFilesystemArn"))
- }
- if s.Subdirectory == nil {
- invalidParams.Add(request.NewErrParamRequired("Subdirectory"))
- }
- if s.Ec2Config != nil {
- if err := s.Ec2Config.Validate(); err != nil {
- invalidParams.AddNested("Ec2Config", err.(request.ErrInvalidParams))
- }
- }
- if s.Tags != nil {
- for i, v := range s.Tags {
- if v == nil {
- continue
- }
- if err := v.Validate(); err != nil {
- invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Tags", i), err.(request.ErrInvalidParams))
- }
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetEc2Config sets the Ec2Config field's value.
- func (s *CreateLocationEfsInput) SetEc2Config(v *Ec2Config) *CreateLocationEfsInput {
- s.Ec2Config = v
- return s
- }
- // SetEfsFilesystemArn sets the EfsFilesystemArn field's value.
- func (s *CreateLocationEfsInput) SetEfsFilesystemArn(v string) *CreateLocationEfsInput {
- s.EfsFilesystemArn = &v
- return s
- }
- // SetSubdirectory sets the Subdirectory field's value.
- func (s *CreateLocationEfsInput) SetSubdirectory(v string) *CreateLocationEfsInput {
- s.Subdirectory = &v
- return s
- }
- // SetTags sets the Tags field's value.
- func (s *CreateLocationEfsInput) SetTags(v []*TagListEntry) *CreateLocationEfsInput {
- s.Tags = v
- return s
- }
- // CreateLocationEfs
- type CreateLocationEfsOutput struct {
- _ struct{} `type:"structure"`
- // The Amazon Resource Name (ARN) of the Amazon EFS file system location that
- // is created.
- LocationArn *string `type:"string"`
- }
- // String returns the string representation
- func (s CreateLocationEfsOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s CreateLocationEfsOutput) GoString() string {
- return s.String()
- }
- // SetLocationArn sets the LocationArn field's value.
- func (s *CreateLocationEfsOutput) SetLocationArn(v string) *CreateLocationEfsOutput {
- s.LocationArn = &v
- return s
- }
- // CreateLocationNfsRequest
- type CreateLocationNfsInput struct {
- _ struct{} `type:"structure"`
- // Contains a list of Amazon Resource Names (ARNs) of agents that are used to
- // connect to an NFS server.
- //
- // OnPremConfig is a required field
- OnPremConfig *OnPremConfig `type:"structure" required:"true"`
- // The name of the NFS server. This value is the IP address or Domain Name Service
- // (DNS) name of the NFS server. An agent that is installed on-premises uses
- // this host name to mount the NFS server in a network.
- //
- // This name must either be DNS-compliant or must be an IP version 4 (IPv4)
- // address.
- //
- // ServerHostname is a required field
- ServerHostname *string `type:"string" required:"true"`
- // The subdirectory in the NFS file system that is used to read data from the
- // NFS source location or write data to the NFS destination. The NFS path should
- // be a path that's exported by the NFS server, or a subdirectory of that path.
- // The path should be such that it can be mounted by other NFS clients in your
- // network.
- //
- // To see all the paths exported by your NFS server. run "showmount -e nfs-server-name"
- // from an NFS client that has access to your server. You can specify any directory
- // that appears in the results, and any subdirectory of that directory. Ensure
- // that the NFS export is accessible without Kerberos authentication.
- //
- // To transfer all the data in the folder you specified, DataSync needs to have
- // permissions to read all the data. To ensure this, either configure the NFS
- // export with no_root_squash, or ensure that the permissions for all of the
- // files that you want sync allow read access for all users. Doing either enables
- // the agent to read the files. For the agent to access directories, you must
- // additionally enable all execute access. For information about NFS export
- // configuration, see 18.7. The /etc/exports Configuration File (https://www.centos.org/docs/5/html/Deployment_Guide-en-US/s1-nfs-server-config-exports.html)
- // in the Centos documentation.
- //
- // Subdirectory is a required field
- Subdirectory *string `type:"string" required:"true"`
- // The key-value pair that represents the tag that you want to add to the location.
- // The value can be an empty string. We recommend using tags to name your resources.
- Tags []*TagListEntry `type:"list"`
- }
- // String returns the string representation
- func (s CreateLocationNfsInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s CreateLocationNfsInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *CreateLocationNfsInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "CreateLocationNfsInput"}
- if s.OnPremConfig == nil {
- invalidParams.Add(request.NewErrParamRequired("OnPremConfig"))
- }
- if s.ServerHostname == nil {
- invalidParams.Add(request.NewErrParamRequired("ServerHostname"))
- }
- if s.Subdirectory == nil {
- invalidParams.Add(request.NewErrParamRequired("Subdirectory"))
- }
- if s.OnPremConfig != nil {
- if err := s.OnPremConfig.Validate(); err != nil {
- invalidParams.AddNested("OnPremConfig", err.(request.ErrInvalidParams))
- }
- }
- if s.Tags != nil {
- for i, v := range s.Tags {
- if v == nil {
- continue
- }
- if err := v.Validate(); err != nil {
- invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Tags", i), err.(request.ErrInvalidParams))
- }
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetOnPremConfig sets the OnPremConfig field's value.
- func (s *CreateLocationNfsInput) SetOnPremConfig(v *OnPremConfig) *CreateLocationNfsInput {
- s.OnPremConfig = v
- return s
- }
- // SetServerHostname sets the ServerHostname field's value.
- func (s *CreateLocationNfsInput) SetServerHostname(v string) *CreateLocationNfsInput {
- s.ServerHostname = &v
- return s
- }
- // SetSubdirectory sets the Subdirectory field's value.
- func (s *CreateLocationNfsInput) SetSubdirectory(v string) *CreateLocationNfsInput {
- s.Subdirectory = &v
- return s
- }
- // SetTags sets the Tags field's value.
- func (s *CreateLocationNfsInput) SetTags(v []*TagListEntry) *CreateLocationNfsInput {
- s.Tags = v
- return s
- }
- // CreateLocationNfsResponse
- type CreateLocationNfsOutput struct {
- _ struct{} `type:"structure"`
- // The Amazon Resource Name (ARN) of the source NFS file system location that
- // is created.
- LocationArn *string `type:"string"`
- }
- // String returns the string representation
- func (s CreateLocationNfsOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s CreateLocationNfsOutput) GoString() string {
- return s.String()
- }
- // SetLocationArn sets the LocationArn field's value.
- func (s *CreateLocationNfsOutput) SetLocationArn(v string) *CreateLocationNfsOutput {
- s.LocationArn = &v
- return s
- }
- // CreateLocationS3Request
- type CreateLocationS3Input struct {
- _ struct{} `type:"structure"`
- // The Amazon Resource Name (ARN) of the Amazon S3 bucket.
- //
- // S3BucketArn is a required field
- S3BucketArn *string `type:"string" required:"true"`
- // The Amazon Resource Name (ARN) of the AWS Identity and Access Management
- // (IAM) role that is used to access an Amazon S3 bucket. For detailed information
- // about using such a role, see Components and Terminology (https://alpha-aws-docs.aws.amazon.com/sync-service/latest/userguide/create-locations-cli.html#create-location-s3-cli)
- // in the AWS DataSync User Guide.
- //
- // S3Config is a required field
- S3Config *S3Config `type:"structure" required:"true"`
- // A subdirectory in the Amazon S3 bucket. This subdirectory in Amazon S3 is
- // used to read data from the S3 source location or write data to the S3 destination.
- //
- // Subdirectory is a required field
- Subdirectory *string `type:"string" required:"true"`
- // The key-value pair that represents the tag that you want to add to the location.
- // The value can be an empty string. We recommend using tags to name your resources.
- Tags []*TagListEntry `type:"list"`
- }
- // String returns the string representation
- func (s CreateLocationS3Input) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s CreateLocationS3Input) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *CreateLocationS3Input) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "CreateLocationS3Input"}
- if s.S3BucketArn == nil {
- invalidParams.Add(request.NewErrParamRequired("S3BucketArn"))
- }
- if s.S3Config == nil {
- invalidParams.Add(request.NewErrParamRequired("S3Config"))
- }
- if s.Subdirectory == nil {
- invalidParams.Add(request.NewErrParamRequired("Subdirectory"))
- }
- if s.S3Config != nil {
- if err := s.S3Config.Validate(); err != nil {
- invalidParams.AddNested("S3Config", err.(request.ErrInvalidParams))
- }
- }
- if s.Tags != nil {
- for i, v := range s.Tags {
- if v == nil {
- continue
- }
- if err := v.Validate(); err != nil {
- invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Tags", i), err.(request.ErrInvalidParams))
- }
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetS3BucketArn sets the S3BucketArn field's value.
- func (s *CreateLocationS3Input) SetS3BucketArn(v string) *CreateLocationS3Input {
- s.S3BucketArn = &v
- return s
- }
- // SetS3Config sets the S3Config field's value.
- func (s *CreateLocationS3Input) SetS3Config(v *S3Config) *CreateLocationS3Input {
- s.S3Config = v
- return s
- }
- // SetSubdirectory sets the Subdirectory field's value.
- func (s *CreateLocationS3Input) SetSubdirectory(v string) *CreateLocationS3Input {
- s.Subdirectory = &v
- return s
- }
- // SetTags sets the Tags field's value.
- func (s *CreateLocationS3Input) SetTags(v []*TagListEntry) *CreateLocationS3Input {
- s.Tags = v
- return s
- }
- // CreateLocationS3Response
- type CreateLocationS3Output struct {
- _ struct{} `type:"structure"`
- // The Amazon Resource Name (ARN) of the source Amazon S3 bucket location that
- // is created.
- LocationArn *string `type:"string"`
- }
- // String returns the string representation
- func (s CreateLocationS3Output) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s CreateLocationS3Output) GoString() string {
- return s.String()
- }
- // SetLocationArn sets the LocationArn field's value.
- func (s *CreateLocationS3Output) SetLocationArn(v string) *CreateLocationS3Output {
- s.LocationArn = &v
- return s
- }
- // CreateTaskRequest
- type CreateTaskInput struct {
- _ struct{} `type:"structure"`
- // The Amazon Resource Name (ARN) of the Amazon CloudWatch log group that is
- // used to monitor and log events in the task. For more information on these
- // groups, see Working with Log Groups and Log Streams (https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html)
- // in the Amazon CloudWatch User Guide.
- //
- // For more information about how to useCloudWatchLogs with DataSync, see Monitoring
- // Your Task (https://docs.aws.amazon.com/datasync/latest/userguide/monitor-datasync.html).
- CloudWatchLogGroupArn *string `type:"string"`
- // The Amazon Resource Name (ARN) of an AWS storage resource's location.
- //
- // DestinationLocationArn is a required field
- DestinationLocationArn *string `type:"string" required:"true"`
- // The name of a task. This value is a text reference that is used to identify
- // the task in the console.
- Name *string `min:"1" type:"string"`
- // The set of configuration options that control the behavior of a single execution
- // of the task that occurs when you call StartTaskExecution. You can configure
- // these options to preserve metadata such as user ID (UID) and group ID (GID),
- // file permissions, data integrity verification, and so on.
- //
- // For each individual task execution, you can override these options by specifying
- // the OverrideOptions before starting a the task execution. For more information,
- // see the operation.
- Options *Options `type:"structure"`
- // The Amazon Resource Name (ARN) of the source location for the task.
- //
- // SourceLocationArn is a required field
- SourceLocationArn *string `type:"string" required:"true"`
- // The key-value pair that represents the tag that you want to add to the resource.
- // The value can be an empty string.
- Tags []*TagListEntry `type:"list"`
- }
- // String returns the string representation
- func (s CreateTaskInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s CreateTaskInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *CreateTaskInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "CreateTaskInput"}
- if s.DestinationLocationArn == nil {
- invalidParams.Add(request.NewErrParamRequired("DestinationLocationArn"))
- }
- if s.Name != nil && len(*s.Name) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Name", 1))
- }
- if s.SourceLocationArn == nil {
- invalidParams.Add(request.NewErrParamRequired("SourceLocationArn"))
- }
- if s.Options != nil {
- if err := s.Options.Validate(); err != nil {
- invalidParams.AddNested("Options", err.(request.ErrInvalidParams))
- }
- }
- if s.Tags != nil {
- for i, v := range s.Tags {
- if v == nil {
- continue
- }
- if err := v.Validate(); err != nil {
- invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Tags", i), err.(request.ErrInvalidParams))
- }
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetCloudWatchLogGroupArn sets the CloudWatchLogGroupArn field's value.
- func (s *CreateTaskInput) SetCloudWatchLogGroupArn(v string) *CreateTaskInput {
- s.CloudWatchLogGroupArn = &v
- return s
- }
- // SetDestinationLocationArn sets the DestinationLocationArn field's value.
- func (s *CreateTaskInput) SetDestinationLocationArn(v string) *CreateTaskInput {
- s.DestinationLocationArn = &v
- return s
- }
- // SetName sets the Name field's value.
- func (s *CreateTaskInput) SetName(v string) *CreateTaskInput {
- s.Name = &v
- return s
- }
- // SetOptions sets the Options field's value.
- func (s *CreateTaskInput) SetOptions(v *Options) *CreateTaskInput {
- s.Options = v
- return s
- }
- // SetSourceLocationArn sets the SourceLocationArn field's value.
- func (s *CreateTaskInput) SetSourceLocationArn(v string) *CreateTaskInput {
- s.SourceLocationArn = &v
- return s
- }
- // SetTags sets the Tags field's value.
- func (s *CreateTaskInput) SetTags(v []*TagListEntry) *CreateTaskInput {
- s.Tags = v
- return s
- }
- // CreateTaskResponse
- type CreateTaskOutput struct {
- _ struct{} `type:"structure"`
- // The Amazon Resource Name (ARN) of the task.
- TaskArn *string `type:"string"`
- }
- // String returns the string representation
- func (s CreateTaskOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s CreateTaskOutput) GoString() string {
- return s.String()
- }
- // SetTaskArn sets the TaskArn field's value.
- func (s *CreateTaskOutput) SetTaskArn(v string) *CreateTaskOutput {
- s.TaskArn = &v
- return s
- }
- // DeleteAgentRequest
- type DeleteAgentInput struct {
- _ struct{} `type:"structure"`
- // The Amazon Resource Name (ARN) of the agent to delete. Use the ListAgents
- // operation to return a list of agents for your account and AWS Region.
- //
- // AgentArn is a required field
- AgentArn *string `type:"string" required:"true"`
- }
- // String returns the string representation
- func (s DeleteAgentInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s DeleteAgentInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *DeleteAgentInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "DeleteAgentInput"}
- if s.AgentArn == nil {
- invalidParams.Add(request.NewErrParamRequired("AgentArn"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetAgentArn sets the AgentArn field's value.
- func (s *DeleteAgentInput) SetAgentArn(v string) *DeleteAgentInput {
- s.AgentArn = &v
- return s
- }
- type DeleteAgentOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation
- func (s DeleteAgentOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s DeleteAgentOutput) GoString() string {
- return s.String()
- }
- // DeleteLocation
- type DeleteLocationInput struct {
- _ struct{} `type:"structure"`
- // The Amazon Resource Name (ARN) of the location to delete.
- //
- // LocationArn is a required field
- LocationArn *string `type:"string" required:"true"`
- }
- // String returns the string representation
- func (s DeleteLocationInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s DeleteLocationInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *DeleteLocationInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "DeleteLocationInput"}
- if s.LocationArn == nil {
- invalidParams.Add(request.NewErrParamRequired("LocationArn"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetLocationArn sets the LocationArn field's value.
- func (s *DeleteLocationInput) SetLocationArn(v string) *DeleteLocationInput {
- s.LocationArn = &v
- return s
- }
- type DeleteLocationOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation
- func (s DeleteLocationOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s DeleteLocationOutput) GoString() string {
- return s.String()
- }
- // DeleteTask
- type DeleteTaskInput struct {
- _ struct{} `type:"structure"`
- // The Amazon Resource Name (ARN) of the task to delete.
- //
- // TaskArn is a required field
- TaskArn *string `type:"string" required:"true"`
- }
- // String returns the string representation
- func (s DeleteTaskInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s DeleteTaskInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *DeleteTaskInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "DeleteTaskInput"}
- if s.TaskArn == nil {
- invalidParams.Add(request.NewErrParamRequired("TaskArn"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetTaskArn sets the TaskArn field's value.
- func (s *DeleteTaskInput) SetTaskArn(v string) *DeleteTaskInput {
- s.TaskArn = &v
- return s
- }
- type DeleteTaskOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation
- func (s DeleteTaskOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s DeleteTaskOutput) GoString() string {
- return s.String()
- }
- // DescribeAgent
- type DescribeAgentInput struct {
- _ struct{} `type:"structure"`
- // The Amazon Resource Name (ARN) of the agent to describe.
- //
- // AgentArn is a required field
- AgentArn *string `type:"string" required:"true"`
- }
- // String returns the string representation
- func (s DescribeAgentInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s DescribeAgentInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *DescribeAgentInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "DescribeAgentInput"}
- if s.AgentArn == nil {
- invalidParams.Add(request.NewErrParamRequired("AgentArn"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetAgentArn sets the AgentArn field's value.
- func (s *DescribeAgentInput) SetAgentArn(v string) *DescribeAgentInput {
- s.AgentArn = &v
- return s
- }
- // DescribeAgentResponse
- type DescribeAgentOutput struct {
- _ struct{} `type:"structure"`
- // The Amazon Resource Name (ARN) of the agent.
- AgentArn *string `type:"string"`
- // The time that the agent was activated (that is, created in your account).
- CreationTime *time.Time `type:"timestamp"`
- // The time that the agent was last connected.
- LastConnectionTime *time.Time `type:"timestamp"`
- // The name of the agent.
- Name *string `min:"1" type:"string"`
- // The status of the agent. If the status is ONLINE, then the agent is configured
- // properly and is available to use. The Running status is the normal running
- // status for an agent. If the status is OFFLINE, the agent's VM is turned off
- // or the agent is in an unhealthy state. When the issue that caused the unhealthy
- // state is resolved, the agent returns to ONLINE status.
- Status *string `type:"string" enum:"AgentStatus"`
- }
- // String returns the string representation
- func (s DescribeAgentOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s DescribeAgentOutput) GoString() string {
- return s.String()
- }
- // SetAgentArn sets the AgentArn field's value.
- func (s *DescribeAgentOutput) SetAgentArn(v string) *DescribeAgentOutput {
- s.AgentArn = &v
- return s
- }
- // SetCreationTime sets the CreationTime field's value.
- func (s *DescribeAgentOutput) SetCreationTime(v time.Time) *DescribeAgentOutput {
- s.CreationTime = &v
- return s
- }
- // SetLastConnectionTime sets the LastConnectionTime field's value.
- func (s *DescribeAgentOutput) SetLastConnectionTime(v time.Time) *DescribeAgentOutput {
- s.LastConnectionTime = &v
- return s
- }
- // SetName sets the Name field's value.
- func (s *DescribeAgentOutput) SetName(v string) *DescribeAgentOutput {
- s.Name = &v
- return s
- }
- // SetStatus sets the Status field's value.
- func (s *DescribeAgentOutput) SetStatus(v string) *DescribeAgentOutput {
- s.Status = &v
- return s
- }
- // DescribeLocationEfsRequest
- type DescribeLocationEfsInput struct {
- _ struct{} `type:"structure"`
- // The Amazon Resource Name (ARN) of the EFS location to describe.
- //
- // LocationArn is a required field
- LocationArn *string `type:"string" required:"true"`
- }
- // String returns the string representation
- func (s DescribeLocationEfsInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s DescribeLocationEfsInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *DescribeLocationEfsInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "DescribeLocationEfsInput"}
- if s.LocationArn == nil {
- invalidParams.Add(request.NewErrParamRequired("LocationArn"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetLocationArn sets the LocationArn field's value.
- func (s *DescribeLocationEfsInput) SetLocationArn(v string) *DescribeLocationEfsInput {
- s.LocationArn = &v
- return s
- }
- // DescribeLocationEfsResponse
- type DescribeLocationEfsOutput struct {
- _ struct{} `type:"structure"`
- // The time that the EFS location was created.
- CreationTime *time.Time `type:"timestamp"`
- // The subnet and the security group that the target Amazon EFS file system
- // uses. The subnet must have at least one mount target for that file system.
- // The security group that you provide needs to be able to communicate with
- // the security group on the mount target in the subnet specified.
- //
- // The exact relationship between security group M (of the mount target) and
- // security group S (which you provide for DataSync to use at this stage) is
- // as follows:
- //
- // * Security group M (which you associate with the mount target) must allow
- // inbound access for the Transmission Control Protocol (TCP) on the NFS
- // port (2049) from security group S. You can enable inbound connections
- // either by IP address (CIDR range) or security group.
- //
- // * Security group S (provided to DataSync to access EFS) should have a
- // rule that enables outbound connections to the NFS port on one of the file
- // system’s mount targets. You can enable outbound connections either by
- // IP address (CIDR range) or security group. For information about security
- // groups and mount targets, see Security Groups for Amazon EC2 Instances
- // and Mount Targets (https://docs.aws.amazon.com/efs/latest/ug/security-considerations.html#network-access)
- // in the Amazon EFS User Guide.
- Ec2Config *Ec2Config `type:"structure"`
- // The Amazon resource Name (ARN) of the EFS location that was described.
- LocationArn *string `type:"string"`
- // The URL of the EFS location that was described.
- LocationUri *string `type:"string"`
- }
- // String returns the string representation
- func (s DescribeLocationEfsOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s DescribeLocationEfsOutput) GoString() string {
- return s.String()
- }
- // SetCreationTime sets the CreationTime field's value.
- func (s *DescribeLocationEfsOutput) SetCreationTime(v time.Time) *DescribeLocationEfsOutput {
- s.CreationTime = &v
- return s
- }
- // SetEc2Config sets the Ec2Config field's value.
- func (s *DescribeLocationEfsOutput) SetEc2Config(v *Ec2Config) *DescribeLocationEfsOutput {
- s.Ec2Config = v
- return s
- }
- // SetLocationArn sets the LocationArn field's value.
- func (s *DescribeLocationEfsOutput) SetLocationArn(v string) *DescribeLocationEfsOutput {
- s.LocationArn = &v
- return s
- }
- // SetLocationUri sets the LocationUri field's value.
- func (s *DescribeLocationEfsOutput) SetLocationUri(v string) *DescribeLocationEfsOutput {
- s.LocationUri = &v
- return s
- }
- // DescribeLocationNfsRequest
- type DescribeLocationNfsInput struct {
- _ struct{} `type:"structure"`
- // The Amazon resource Name (ARN) of the NFS location to describe.
- //
- // LocationArn is a required field
- LocationArn *string `type:"string" required:"true"`
- }
- // String returns the string representation
- func (s DescribeLocationNfsInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s DescribeLocationNfsInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *DescribeLocationNfsInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "DescribeLocationNfsInput"}
- if s.LocationArn == nil {
- invalidParams.Add(request.NewErrParamRequired("LocationArn"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetLocationArn sets the LocationArn field's value.
- func (s *DescribeLocationNfsInput) SetLocationArn(v string) *DescribeLocationNfsInput {
- s.LocationArn = &v
- return s
- }
- // DescribeLocationNfsResponse
- type DescribeLocationNfsOutput struct {
- _ struct{} `type:"structure"`
- // The time that the NFS location was created.
- CreationTime *time.Time `type:"timestamp"`
- // The Amazon resource Name (ARN) of the NFS location that was described.
- LocationArn *string `type:"string"`
- // The URL of the source NFS location that was described.
- LocationUri *string `type:"string"`
- // A list of Amazon Resource Names (ARNs) of agents to use for a Network File
- // System (NFS) location.
- OnPremConfig *OnPremConfig `type:"structure"`
- }
- // String returns the string representation
- func (s DescribeLocationNfsOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s DescribeLocationNfsOutput) GoString() string {
- return s.String()
- }
- // SetCreationTime sets the CreationTime field's value.
- func (s *DescribeLocationNfsOutput) SetCreationTime(v time.Time) *DescribeLocationNfsOutput {
- s.CreationTime = &v
- return s
- }
- // SetLocationArn sets the LocationArn field's value.
- func (s *DescribeLocationNfsOutput) SetLocationArn(v string) *DescribeLocationNfsOutput {
- s.LocationArn = &v
- return s
- }
- // SetLocationUri sets the LocationUri field's value.
- func (s *DescribeLocationNfsOutput) SetLocationUri(v string) *DescribeLocationNfsOutput {
- s.LocationUri = &v
- return s
- }
- // SetOnPremConfig sets the OnPremConfig field's value.
- func (s *DescribeLocationNfsOutput) SetOnPremConfig(v *OnPremConfig) *DescribeLocationNfsOutput {
- s.OnPremConfig = v
- return s
- }
- // DescribeLocationS3Request
- type DescribeLocationS3Input struct {
- _ struct{} `type:"structure"`
- // The Amazon Resource Name (ARN) of the Amazon S3 bucket location to describe.
- //
- // LocationArn is a required field
- LocationArn *string `type:"string" required:"true"`
- }
- // String returns the string representation
- func (s DescribeLocationS3Input) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s DescribeLocationS3Input) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *DescribeLocationS3Input) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "DescribeLocationS3Input"}
- if s.LocationArn == nil {
- invalidParams.Add(request.NewErrParamRequired("LocationArn"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetLocationArn sets the LocationArn field's value.
- func (s *DescribeLocationS3Input) SetLocationArn(v string) *DescribeLocationS3Input {
- s.LocationArn = &v
- return s
- }
- // DescribeLocationS3Response
- type DescribeLocationS3Output struct {
- _ struct{} `type:"structure"`
- // The time that the Amazon S3 bucket location was created.
- CreationTime *time.Time `type:"timestamp"`
- // The Amazon Resource Name (ARN) of the Amazon S3 bucket location.
- LocationArn *string `type:"string"`
- // The URL of the Amazon S3 location that was described.
- LocationUri *string `type:"string"`
- // The Amazon Resource Name (ARN) of the AWS Identity and Access Management
- // (IAM) role that is used to access an Amazon S3 bucket. For detailed information
- // about using such a role, see Components and Terminology (https://alpha-aws-docs.aws.amazon.com/sync-service/latest/userguide/create-locations-cli.html#create-location-s3-cli)
- // in the AWS DataSync User Guide.
- S3Config *S3Config `type:"structure"`
- }
- // String returns the string representation
- func (s DescribeLocationS3Output) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s DescribeLocationS3Output) GoString() string {
- return s.String()
- }
- // SetCreationTime sets the CreationTime field's value.
- func (s *DescribeLocationS3Output) SetCreationTime(v time.Time) *DescribeLocationS3Output {
- s.CreationTime = &v
- return s
- }
- // SetLocationArn sets the LocationArn field's value.
- func (s *DescribeLocationS3Output) SetLocationArn(v string) *DescribeLocationS3Output {
- s.LocationArn = &v
- return s
- }
- // SetLocationUri sets the LocationUri field's value.
- func (s *DescribeLocationS3Output) SetLocationUri(v string) *DescribeLocationS3Output {
- s.LocationUri = &v
- return s
- }
- // SetS3Config sets the S3Config field's value.
- func (s *DescribeLocationS3Output) SetS3Config(v *S3Config) *DescribeLocationS3Output {
- s.S3Config = v
- return s
- }
- // DescribeTaskExecutionRequest
- type DescribeTaskExecutionInput struct {
- _ struct{} `type:"structure"`
- // The Amazon Resource Name (ARN) of the task that is being executed.
- //
- // TaskExecutionArn is a required field
- TaskExecutionArn *string `type:"string" required:"true"`
- }
- // String returns the string representation
- func (s DescribeTaskExecutionInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s DescribeTaskExecutionInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *DescribeTaskExecutionInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "DescribeTaskExecutionInput"}
- if s.TaskExecutionArn == nil {
- invalidParams.Add(request.NewErrParamRequired("TaskExecutionArn"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetTaskExecutionArn sets the TaskExecutionArn field's value.
- func (s *DescribeTaskExecutionInput) SetTaskExecutionArn(v string) *DescribeTaskExecutionInput {
- s.TaskExecutionArn = &v
- return s
- }
- // DescribeTaskExecutionResponse
- type DescribeTaskExecutionOutput struct {
- _ struct{} `type:"structure"`
- // The physical number of bytes transferred over the network.
- BytesTransferred *int64 `type:"long"`
- // The number of logical bytes written to the destination AWS storage resource.
- BytesWritten *int64 `type:"long"`
- // The estimated physical number of bytes that is to be transferred over the
- // network.
- EstimatedBytesToTransfer *int64 `type:"long"`
- // The expected number of files that is to be transferred over the network.
- // This value is calculated during the PREPARING phase, before the TRANSFERRING
- // phase. This value is the expected number of files to be transferred. It's
- // calculated based on comparing the content of the source and destination locations
- // and finding the delta that needs to be transferred.
- EstimatedFilesToTransfer *int64 `type:"long"`
- // The actual number of files that was transferred over the network. This value
- // is calculated and updated on an ongoing basis during the TRANSFERRING phase.
- // It's updated periodically when each file is read from the source and sent
- // over the network.
- //
- // If failures occur during a transfer, this value can be less than EstimatedFilesToTransfer.
- // This value can also be greater than EstimatedFilesTransferred in some cases.
- // This element is implementation-specific for some location types, so don't
- // use it as an indicator for a correct file number or to monitor your task
- // execution.
- FilesTransferred *int64 `type:"long"`
- // Represents the options that are available to control the behavior of a StartTaskExecution
- // operation. Behavior includes preserving metadata such as user ID (UID), group
- // ID (GID), and file permissions, and also overwriting files in the destination,
- // data integrity verification, and so on.
- //
- // A task has a set of default options associated with it. If you don't specify
- // an option in StartTaskExecution, the default value is used. You can override
- // the defaults options on each task execution by specifying an overriding Options
- // value to StartTaskExecution.
- Options *Options `type:"structure"`
- // The result of the task execution.
- Result *TaskExecutionResultDetail `type:"structure"`
- // The time that the task execution was started.
- StartTime *time.Time `type:"timestamp"`
- // The status of the task. For detailed information about sync statuses, see
- // Understanding Sync Task Statuses (https://docs.aws.amazon.com/sync-service/latest/userguide/understand-sync-task-statuses.html).
- Status *string `type:"string" enum:"TaskExecutionStatus"`
- // The Amazon Resource Name (ARN) of the task execution that was described.
- // TaskExecutionArn is hierarchical and includes TaskArn for the task that was
- // executed.
- //
- // For example, a TaskExecution value with the ARN arn:aws:sync:us-east-1:209870788375:task/task-0208075f79cedf4a2/execution/exec-08ef1e88ec491019b
- // executed the task with the ARN arn:aws:sync:us-east-1:209870788375:task/task-0208075f79cedf4a2.
- TaskExecutionArn *string `type:"string"`
- }
- // String returns the string representation
- func (s DescribeTaskExecutionOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s DescribeTaskExecutionOutput) GoString() string {
- return s.String()
- }
- // SetBytesTransferred sets the BytesTransferred field's value.
- func (s *DescribeTaskExecutionOutput) SetBytesTransferred(v int64) *DescribeTaskExecutionOutput {
- s.BytesTransferred = &v
- return s
- }
- // SetBytesWritten sets the BytesWritten field's value.
- func (s *DescribeTaskExecutionOutput) SetBytesWritten(v int64) *DescribeTaskExecutionOutput {
- s.BytesWritten = &v
- return s
- }
- // SetEstimatedBytesToTransfer sets the EstimatedBytesToTransfer field's value.
- func (s *DescribeTaskExecutionOutput) SetEstimatedBytesToTransfer(v int64) *DescribeTaskExecutionOutput {
- s.EstimatedBytesToTransfer = &v
- return s
- }
- // SetEstimatedFilesToTransfer sets the EstimatedFilesToTransfer field's value.
- func (s *DescribeTaskExecutionOutput) SetEstimatedFilesToTransfer(v int64) *DescribeTaskExecutionOutput {
- s.EstimatedFilesToTransfer = &v
- return s
- }
- // SetFilesTransferred sets the FilesTransferred field's value.
- func (s *DescribeTaskExecutionOutput) SetFilesTransferred(v int64) *DescribeTaskExecutionOutput {
- s.FilesTransferred = &v
- return s
- }
- // SetOptions sets the Options field's value.
- func (s *DescribeTaskExecutionOutput) SetOptions(v *Options) *DescribeTaskExecutionOutput {
- s.Options = v
- return s
- }
- // SetResult sets the Result field's value.
- func (s *DescribeTaskExecutionOutput) SetResult(v *TaskExecutionResultDetail) *DescribeTaskExecutionOutput {
- s.Result = v
- return s
- }
- // SetStartTime sets the StartTime field's value.
- func (s *DescribeTaskExecutionOutput) SetStartTime(v time.Time) *DescribeTaskExecutionOutput {
- s.StartTime = &v
- return s
- }
- // SetStatus sets the Status field's value.
- func (s *DescribeTaskExecutionOutput) SetStatus(v string) *DescribeTaskExecutionOutput {
- s.Status = &v
- return s
- }
- // SetTaskExecutionArn sets the TaskExecutionArn field's value.
- func (s *DescribeTaskExecutionOutput) SetTaskExecutionArn(v string) *DescribeTaskExecutionOutput {
- s.TaskExecutionArn = &v
- return s
- }
- // DescribeTaskRequest
- type DescribeTaskInput struct {
- _ struct{} `type:"structure"`
- // The Amazon Resource Name (ARN) of the task to describe.
- //
- // TaskArn is a required field
- TaskArn *string `type:"string" required:"true"`
- }
- // String returns the string representation
- func (s DescribeTaskInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s DescribeTaskInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *DescribeTaskInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "DescribeTaskInput"}
- if s.TaskArn == nil {
- invalidParams.Add(request.NewErrParamRequired("TaskArn"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetTaskArn sets the TaskArn field's value.
- func (s *DescribeTaskInput) SetTaskArn(v string) *DescribeTaskInput {
- s.TaskArn = &v
- return s
- }
- // DescribeTaskResponse
- type DescribeTaskOutput struct {
- _ struct{} `type:"structure"`
- // The Amazon Resource Name (ARN) of the Amazon CloudWatch log group that was
- // used to monitor and log events in the task. For more information on these
- // groups, see Working with Log Groups and Log Streams (https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html)
- // in the Amazon CloudWatch User Guide.
- CloudWatchLogGroupArn *string `type:"string"`
- // The time that the task was created.
- CreationTime *time.Time `type:"timestamp"`
- // The Amazon Resource Name (ARN) of the task execution that is syncing files.
- CurrentTaskExecutionArn *string `type:"string"`
- // The Amazon Resource Name (ARN) of the AWS storage resource's location.
- DestinationLocationArn *string `type:"string"`
- // Errors that AWS DataSync encountered during execution of the task. You can
- // use this error code to help troubleshoot issues.
- ErrorCode *string `type:"string"`
- // Detailed description of an error that was encountered during the task execution.
- // You can use this information to help troubleshoot issues.
- ErrorDetail *string `type:"string"`
- // The name of the task that was described.
- Name *string `min:"1" type:"string"`
- // The set of configuration options that control the behavior of a single execution
- // of the task that occurs when you call StartTaskExecution. You can configure
- // these options to preserve metadata such as user ID (UID) and group (GID),
- // file permissions, data integrity verification, and so on.
- //
- // For each individual task execution, you can override these options by specifying
- // the overriding OverrideOptions value to operation.
- Options *Options `type:"structure"`
- // The Amazon Resource Name (ARN) of the source file system's location.
- SourceLocationArn *string `type:"string"`
- // The status of the task that was described. For detailed information about
- // sync statuses, see Understanding Sync Task Statuses (https://docs.aws.amazon.com/sync-service/latest/userguide/understand-sync-task-statuses.html).
- Status *string `type:"string" enum:"TaskStatus"`
- // The Amazon Resource Name (ARN) of the task that was described.
- TaskArn *string `type:"string"`
- }
- // String returns the string representation
- func (s DescribeTaskOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s DescribeTaskOutput) GoString() string {
- return s.String()
- }
- // SetCloudWatchLogGroupArn sets the CloudWatchLogGroupArn field's value.
- func (s *DescribeTaskOutput) SetCloudWatchLogGroupArn(v string) *DescribeTaskOutput {
- s.CloudWatchLogGroupArn = &v
- return s
- }
- // SetCreationTime sets the CreationTime field's value.
- func (s *DescribeTaskOutput) SetCreationTime(v time.Time) *DescribeTaskOutput {
- s.CreationTime = &v
- return s
- }
- // SetCurrentTaskExecutionArn sets the CurrentTaskExecutionArn field's value.
- func (s *DescribeTaskOutput) SetCurrentTaskExecutionArn(v string) *DescribeTaskOutput {
- s.CurrentTaskExecutionArn = &v
- return s
- }
- // SetDestinationLocationArn sets the DestinationLocationArn field's value.
- func (s *DescribeTaskOutput) SetDestinationLocationArn(v string) *DescribeTaskOutput {
- s.DestinationLocationArn = &v
- return s
- }
- // SetErrorCode sets the ErrorCode field's value.
- func (s *DescribeTaskOutput) SetErrorCode(v string) *DescribeTaskOutput {
- s.ErrorCode = &v
- return s
- }
- // SetErrorDetail sets the ErrorDetail field's value.
- func (s *DescribeTaskOutput) SetErrorDetail(v string) *DescribeTaskOutput {
- s.ErrorDetail = &v
- return s
- }
- // SetName sets the Name field's value.
- func (s *DescribeTaskOutput) SetName(v string) *DescribeTaskOutput {
- s.Name = &v
- return s
- }
- // SetOptions sets the Options field's value.
- func (s *DescribeTaskOutput) SetOptions(v *Options) *DescribeTaskOutput {
- s.Options = v
- return s
- }
- // SetSourceLocationArn sets the SourceLocationArn field's value.
- func (s *DescribeTaskOutput) SetSourceLocationArn(v string) *DescribeTaskOutput {
- s.SourceLocationArn = &v
- return s
- }
- // SetStatus sets the Status field's value.
- func (s *DescribeTaskOutput) SetStatus(v string) *DescribeTaskOutput {
- s.Status = &v
- return s
- }
- // SetTaskArn sets the TaskArn field's value.
- func (s *DescribeTaskOutput) SetTaskArn(v string) *DescribeTaskOutput {
- s.TaskArn = &v
- return s
- }
- // The subnet and the security group that the target Amazon EFS file system
- // uses. The subnet must have at least one mount target for that file system.
- // The security group that you provide needs to be able to communicate with
- // the security group on the mount target in the subnet specified.
- //
- // The exact relationship between security group M (of the mount target) and
- // security group S (which you provide for DataSync to use at this stage) is
- // as follows:
- //
- // * Security group M (which you associate with the mount target) must allow
- // inbound access for the Transmission Control Protocol (TCP) on the NFS
- // port (2049) from security group S. You can enable inbound connections
- // either by IP address (CIDR range) or security group.
- //
- // * Security group S (provided to DataSync to access EFS) should have a
- // rule that enables outbound connections to the NFS port on one of the file
- // system’s mount targets. You can enable outbound connections either by
- // IP address (CIDR range) or security group. For information about security
- // groups and mount targets, see Security Groups for Amazon EC2 Instances
- // and Mount Targets (https://docs.aws.amazon.com/efs/latest/ug/security-considerations.html#network-access)
- // in the Amazon EFS User Guide.
- type Ec2Config struct {
- _ struct{} `type:"structure"`
- // The Amazon Resource Names (ARNs) of the security groups that are configured
- // for the Amazon EC2 resource.
- //
- // SecurityGroupArns is a required field
- SecurityGroupArns []*string `min:"1" type:"list" required:"true"`
- // The ARN of the subnet that the Amazon EC2 resource belongs in.
- //
- // SubnetArn is a required field
- SubnetArn *string `type:"string" required:"true"`
- }
- // String returns the string representation
- func (s Ec2Config) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s Ec2Config) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *Ec2Config) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "Ec2Config"}
- if s.SecurityGroupArns == nil {
- invalidParams.Add(request.NewErrParamRequired("SecurityGroupArns"))
- }
- if s.SecurityGroupArns != nil && len(s.SecurityGroupArns) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("SecurityGroupArns", 1))
- }
- if s.SubnetArn == nil {
- invalidParams.Add(request.NewErrParamRequired("SubnetArn"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetSecurityGroupArns sets the SecurityGroupArns field's value.
- func (s *Ec2Config) SetSecurityGroupArns(v []*string) *Ec2Config {
- s.SecurityGroupArns = v
- return s
- }
- // SetSubnetArn sets the SubnetArn field's value.
- func (s *Ec2Config) SetSubnetArn(v string) *Ec2Config {
- s.SubnetArn = &v
- return s
- }
- // ListAgentsRequest
- type ListAgentsInput struct {
- _ struct{} `type:"structure"`
- // The maximum number of agents to list.
- MaxResults *int64 `type:"integer"`
- // An opaque string that indicates the position at which to begin the next list
- // of agents.
- NextToken *string `type:"string"`
- }
- // String returns the string representation
- func (s ListAgentsInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s ListAgentsInput) GoString() string {
- return s.String()
- }
- // SetMaxResults sets the MaxResults field's value.
- func (s *ListAgentsInput) SetMaxResults(v int64) *ListAgentsInput {
- s.MaxResults = &v
- return s
- }
- // SetNextToken sets the NextToken field's value.
- func (s *ListAgentsInput) SetNextToken(v string) *ListAgentsInput {
- s.NextToken = &v
- return s
- }
- // ListAgentsResponse
- type ListAgentsOutput struct {
- _ struct{} `type:"structure"`
- // A list of agents in your account.
- Agents []*AgentListEntry `type:"list"`
- // An opaque string that indicates the position at which to begin returning
- // the next list of agents.
- NextToken *string `type:"string"`
- }
- // String returns the string representation
- func (s ListAgentsOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s ListAgentsOutput) GoString() string {
- return s.String()
- }
- // SetAgents sets the Agents field's value.
- func (s *ListAgentsOutput) SetAgents(v []*AgentListEntry) *ListAgentsOutput {
- s.Agents = v
- return s
- }
- // SetNextToken sets the NextToken field's value.
- func (s *ListAgentsOutput) SetNextToken(v string) *ListAgentsOutput {
- s.NextToken = &v
- return s
- }
- // ListLocationsRequest
- type ListLocationsInput struct {
- _ struct{} `type:"structure"`
- // The maximum number of locations to return.
- MaxResults *int64 `type:"integer"`
- // An opaque string that indicates the position at which to begin the next list
- // of locations.
- NextToken *string `type:"string"`
- }
- // String returns the string representation
- func (s ListLocationsInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s ListLocationsInput) GoString() string {
- return s.String()
- }
- // SetMaxResults sets the MaxResults field's value.
- func (s *ListLocationsInput) SetMaxResults(v int64) *ListLocationsInput {
- s.MaxResults = &v
- return s
- }
- // SetNextToken sets the NextToken field's value.
- func (s *ListLocationsInput) SetNextToken(v string) *ListLocationsInput {
- s.NextToken = &v
- return s
- }
- // ListLocationsResponse
- type ListLocationsOutput struct {
- _ struct{} `type:"structure"`
- // An array that contains a list of locations.
- Locations []*LocationListEntry `type:"list"`
- // An opaque string that indicates the position at which to begin returning
- // the next list of locations.
- NextToken *string `type:"string"`
- }
- // String returns the string representation
- func (s ListLocationsOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s ListLocationsOutput) GoString() string {
- return s.String()
- }
- // SetLocations sets the Locations field's value.
- func (s *ListLocationsOutput) SetLocations(v []*LocationListEntry) *ListLocationsOutput {
- s.Locations = v
- return s
- }
- // SetNextToken sets the NextToken field's value.
- func (s *ListLocationsOutput) SetNextToken(v string) *ListLocationsOutput {
- s.NextToken = &v
- return s
- }
- // ListTagsForResourceRequest
- type ListTagsForResourceInput struct {
- _ struct{} `type:"structure"`
- // The maximum number of locations to return.
- MaxResults *int64 `type:"integer"`
- // An opaque string that indicates the position at which to begin the next list
- // of locations.
- NextToken *string `type:"string"`
- // The Amazon Resource Name (ARN) of the resource whose tags to list.
- //
- // ResourceArn is a required field
- ResourceArn *string `type:"string" required:"true"`
- }
- // String returns the string representation
- func (s ListTagsForResourceInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s ListTagsForResourceInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *ListTagsForResourceInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "ListTagsForResourceInput"}
- if s.ResourceArn == nil {
- invalidParams.Add(request.NewErrParamRequired("ResourceArn"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetMaxResults sets the MaxResults field's value.
- func (s *ListTagsForResourceInput) SetMaxResults(v int64) *ListTagsForResourceInput {
- s.MaxResults = &v
- return s
- }
- // SetNextToken sets the NextToken field's value.
- func (s *ListTagsForResourceInput) SetNextToken(v string) *ListTagsForResourceInput {
- s.NextToken = &v
- return s
- }
- // SetResourceArn sets the ResourceArn field's value.
- func (s *ListTagsForResourceInput) SetResourceArn(v string) *ListTagsForResourceInput {
- s.ResourceArn = &v
- return s
- }
- // ListTagsForResourceResponse
- type ListTagsForResourceOutput struct {
- _ struct{} `type:"structure"`
- // An opaque string that indicates the position at which to begin returning
- // the next list of resource tags.
- NextToken *string `type:"string"`
- // Array of resource tags.
- Tags []*TagListEntry `type:"list"`
- }
- // String returns the string representation
- func (s ListTagsForResourceOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s ListTagsForResourceOutput) GoString() string {
- return s.String()
- }
- // SetNextToken sets the NextToken field's value.
- func (s *ListTagsForResourceOutput) SetNextToken(v string) *ListTagsForResourceOutput {
- s.NextToken = &v
- return s
- }
- // SetTags sets the Tags field's value.
- func (s *ListTagsForResourceOutput) SetTags(v []*TagListEntry) *ListTagsForResourceOutput {
- s.Tags = v
- return s
- }
- // ListTaskExecutions
- type ListTaskExecutionsInput struct {
- _ struct{} `type:"structure"`
- // The maximum number of executed tasks to list.
- MaxResults *int64 `type:"integer"`
- // An opaque string that indicates the position at which to begin the next list
- // of the executed tasks.
- NextToken *string `type:"string"`
- // The Amazon Resource Name (ARN) of the task whose tasks you want to list.
- TaskArn *string `type:"string"`
- }
- // String returns the string representation
- func (s ListTaskExecutionsInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s ListTaskExecutionsInput) GoString() string {
- return s.String()
- }
- // SetMaxResults sets the MaxResults field's value.
- func (s *ListTaskExecutionsInput) SetMaxResults(v int64) *ListTaskExecutionsInput {
- s.MaxResults = &v
- return s
- }
- // SetNextToken sets the NextToken field's value.
- func (s *ListTaskExecutionsInput) SetNextToken(v string) *ListTaskExecutionsInput {
- s.NextToken = &v
- return s
- }
- // SetTaskArn sets the TaskArn field's value.
- func (s *ListTaskExecutionsInput) SetTaskArn(v string) *ListTaskExecutionsInput {
- s.TaskArn = &v
- return s
- }
- // ListTaskExecutionsResponse
- type ListTaskExecutionsOutput struct {
- _ struct{} `type:"structure"`
- // An opaque string that indicates the position at which to begin returning
- // the next list of executed tasks.
- NextToken *string `type:"string"`
- // A list of executed tasks.
- TaskExecutions []*TaskExecutionListEntry `type:"list"`
- }
- // String returns the string representation
- func (s ListTaskExecutionsOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s ListTaskExecutionsOutput) GoString() string {
- return s.String()
- }
- // SetNextToken sets the NextToken field's value.
- func (s *ListTaskExecutionsOutput) SetNextToken(v string) *ListTaskExecutionsOutput {
- s.NextToken = &v
- return s
- }
- // SetTaskExecutions sets the TaskExecutions field's value.
- func (s *ListTaskExecutionsOutput) SetTaskExecutions(v []*TaskExecutionListEntry) *ListTaskExecutionsOutput {
- s.TaskExecutions = v
- return s
- }
- // ListTasksRequest
- type ListTasksInput struct {
- _ struct{} `type:"structure"`
- // The maximum number of tasks to return.
- MaxResults *int64 `type:"integer"`
- // An opaque string that indicates the position at which to begin the next list
- // of tasks.
- NextToken *string `type:"string"`
- }
- // String returns the string representation
- func (s ListTasksInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s ListTasksInput) GoString() string {
- return s.String()
- }
- // SetMaxResults sets the MaxResults field's value.
- func (s *ListTasksInput) SetMaxResults(v int64) *ListTasksInput {
- s.MaxResults = &v
- return s
- }
- // SetNextToken sets the NextToken field's value.
- func (s *ListTasksInput) SetNextToken(v string) *ListTasksInput {
- s.NextToken = &v
- return s
- }
- // ListTasksResponse
- type ListTasksOutput struct {
- _ struct{} `type:"structure"`
- // An opaque string that indicates the position at which to begin returning
- // the next list of tasks.
- NextToken *string `type:"string"`
- // A list of all the tasks that are returned.
- Tasks []*TaskListEntry `type:"list"`
- }
- // String returns the string representation
- func (s ListTasksOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s ListTasksOutput) GoString() string {
- return s.String()
- }
- // SetNextToken sets the NextToken field's value.
- func (s *ListTasksOutput) SetNextToken(v string) *ListTasksOutput {
- s.NextToken = &v
- return s
- }
- // SetTasks sets the Tasks field's value.
- func (s *ListTasksOutput) SetTasks(v []*TaskListEntry) *ListTasksOutput {
- s.Tasks = v
- return s
- }
- // Represents a single entry in a list of locations. LocationListEntry returns
- // an array that contains a list of locations when the ListLocations operation
- // is called.
- type LocationListEntry struct {
- _ struct{} `type:"structure"`
- // The Amazon Resource Name (ARN) of the location. For Network File System (NFS)
- // or Amazon EFS, the location is the export path. For Amazon S3, the location
- // is the prefix path that you want to mount and use as the root of the location.
- LocationArn *string `type:"string"`
- // Represents a list of URLs of a location. LocationUri returns an array that
- // contains a list of locations when the ListLocations operation is called.
- //
- // Format: TYPE://GLOBAL_ID/SUBDIR.
- //
- // TYPE designates the type of location. Valid values: NFS | EFS | S3.
- //
- // GLOBAL_ID is the globally unique identifier of the resource that backs the
- // location. An example for EFS is us-east-2.fs-abcd1234. An example for Amazon
- // S3 is the bucket name, such as myBucket. An example for NFS is a valid IPv4
- // address or a host name compliant with Domain Name Service (DNS).
- //
- // SUBDIR is a valid file system path, delimited by forward slashes as is the
- // *nix convention. For NFS and Amazon EFS, it's the export path to mount the
- // location. For Amazon S3, it's the prefix path that you mount to and treat
- // as the root of the location.
- LocationUri *string `type:"string"`
- }
- // String returns the string representation
- func (s LocationListEntry) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s LocationListEntry) GoString() string {
- return s.String()
- }
- // SetLocationArn sets the LocationArn field's value.
- func (s *LocationListEntry) SetLocationArn(v string) *LocationListEntry {
- s.LocationArn = &v
- return s
- }
- // SetLocationUri sets the LocationUri field's value.
- func (s *LocationListEntry) SetLocationUri(v string) *LocationListEntry {
- s.LocationUri = &v
- return s
- }
- // A list of Amazon Resource Names (ARNs) of agents to use for a Network File
- // System (NFS) location.
- type OnPremConfig struct {
- _ struct{} `type:"structure"`
- // ARNs)of the agents to use for an NFS location.
- //
- // AgentArns is a required field
- AgentArns []*string `min:"1" type:"list" required:"true"`
- }
- // String returns the string representation
- func (s OnPremConfig) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s OnPremConfig) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *OnPremConfig) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "OnPremConfig"}
- if s.AgentArns == nil {
- invalidParams.Add(request.NewErrParamRequired("AgentArns"))
- }
- if s.AgentArns != nil && len(s.AgentArns) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("AgentArns", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetAgentArns sets the AgentArns field's value.
- func (s *OnPremConfig) SetAgentArns(v []*string) *OnPremConfig {
- s.AgentArns = v
- return s
- }
- // Represents the options that are available to control the behavior of a StartTaskExecution
- // operation. Behavior includes preserving metadata such as user ID (UID), group
- // ID (GID), and file permissions, and also overwriting files in the destination,
- // data integrity verification, and so on.
- //
- // A task has a set of default options associated with it. If you don't specify
- // an option in StartTaskExecution, the default value is used. You can override
- // the defaults options on each task execution by specifying an overriding Options
- // value to StartTaskExecution.
- type Options struct {
- _ struct{} `type:"structure"`
- // A file metadata value that shows the last time a file was accessed (that
- // is, when the file was read or written to). If you set Atime to BEST_EFFORT,
- // DataSync attempts to preserve the original Atime attribute on all source
- // files (that is, the version before the PREPARING phase). However, Atime's
- // behavior is not fully standard across platforms, so AWS DataSync can only
- // do this on a best-effort basis.
- //
- // Default value: BEST_EFFORT.
- //
- // BEST_EFFORT: Attempt to preserve the per-file Atime value (recommended).
- //
- // NONE: Ignore Atime.
- //
- // If Atime is set to BEST_EFFORT, Mtime must be set to PRESERVE.
- //
- // If Atime is set to NONE, Mtime must also be NONE.
- Atime *string `type:"string" enum:"Atime"`
- // A value that limits the bandwidth used by AWS DataSync. For example, if you
- // want AWS DataSync to use a maximum of 1 MB, set this value to 1048576 (=1024*1024).
- BytesPerSecond *int64 `type:"long"`
- // The group ID (GID) of the file's owners.
- //
- // Default value: INT_VALUE. This preserves the integer value of the ID.
- //
- // INT_VALUE: Preserve the integer value of user ID (UID) and GID (recommended).
- //
- // NONE: Ignore UID and GID.
- Gid *string `type:"string" enum:"Gid"`
- // A value that indicates the last time that a file was modified (that is, a
- // file was written to) before the PREPARING phase.
- //
- // Default value: PRESERVE.
- //
- // PRESERVE: Preserve original Mtime (recommended)
- //
- // NONE: Ignore Mtime.
- //
- // If Mtime is set to PRESERVE, Atime must be set to BEST_EFFORT.
- //
- // If Mtime is set to NONE, Atime must also be set to NONE.
- Mtime *string `type:"string" enum:"Mtime"`
- // A value that determines which users or groups can access a file for a specific
- // purpose such as reading, writing, or execution of the file.
- //
- // Default value: PRESERVE.
- //
- // PRESERVE: Preserve POSIX-style permissions (recommended).
- //
- // NONE: Ignore permissions.
- //
- // AWS DataSync can preserve extant permissions of a source location.
- PosixPermissions *string `type:"string" enum:"PosixPermissions"`
- // A value that specifies whether files in the destination that don't exist
- // in the source file system should be preserved.
- //
- // Default value: PRESERVE.
- //
- // PRESERVE: Ignore such destination files (recommended).
- //
- // REMOVE: Delete destination files that aren’t present in the source.
- PreserveDeletedFiles *string `type:"string" enum:"PreserveDeletedFiles"`
- // A value that determines whether AWS DataSync should preserve the metadata
- // of block and character devices in the source file system, and recreate the
- // files with that device name and metadata on the destination.
- //
- // AWS DataSync can't sync the actual contents of such devices, because they
- // are nonterminal and don't return an end-of-file (EOF) marker.
- //
- // Default value: NONE.
- //
- // NONE: Ignore special devices (recommended).
- //
- // PRESERVE: Preserve character and block device metadata. This option isn't
- // currently supported for Amazon EFS.
- PreserveDevices *string `type:"string" enum:"PreserveDevices"`
- // The user ID (UID) of the file's owner.
- //
- // Default value: INT_VALUE. This preserves the integer value of the ID.
- //
- // INT_VALUE: Preserve the integer value of UID and group ID (GID) (recommended).
- //
- // NONE: Ignore UID and GID.
- Uid *string `type:"string" enum:"Uid"`
- // A value that determines whether a data integrity verification should be performed
- // at the end of a task execution after all data and metadata have been transferred.
- //
- // Default value: POINT_IN_TIME_CONSISTENT.
- //
- // POINT_IN_TIME_CONSISTENT: Perform verification (recommended).
- //
- // NONE: Skip verification.
- VerifyMode *string `type:"string" enum:"VerifyMode"`
- }
- // String returns the string representation
- func (s Options) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s Options) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *Options) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "Options"}
- if s.BytesPerSecond != nil && *s.BytesPerSecond < -1 {
- invalidParams.Add(request.NewErrParamMinValue("BytesPerSecond", -1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetAtime sets the Atime field's value.
- func (s *Options) SetAtime(v string) *Options {
- s.Atime = &v
- return s
- }
- // SetBytesPerSecond sets the BytesPerSecond field's value.
- func (s *Options) SetBytesPerSecond(v int64) *Options {
- s.BytesPerSecond = &v
- return s
- }
- // SetGid sets the Gid field's value.
- func (s *Options) SetGid(v string) *Options {
- s.Gid = &v
- return s
- }
- // SetMtime sets the Mtime field's value.
- func (s *Options) SetMtime(v string) *Options {
- s.Mtime = &v
- return s
- }
- // SetPosixPermissions sets the PosixPermissions field's value.
- func (s *Options) SetPosixPermissions(v string) *Options {
- s.PosixPermissions = &v
- return s
- }
- // SetPreserveDeletedFiles sets the PreserveDeletedFiles field's value.
- func (s *Options) SetPreserveDeletedFiles(v string) *Options {
- s.PreserveDeletedFiles = &v
- return s
- }
- // SetPreserveDevices sets the PreserveDevices field's value.
- func (s *Options) SetPreserveDevices(v string) *Options {
- s.PreserveDevices = &v
- return s
- }
- // SetUid sets the Uid field's value.
- func (s *Options) SetUid(v string) *Options {
- s.Uid = &v
- return s
- }
- // SetVerifyMode sets the VerifyMode field's value.
- func (s *Options) SetVerifyMode(v string) *Options {
- s.VerifyMode = &v
- return s
- }
- // The Amazon Resource Name (ARN) of the AWS Identity and Access Management
- // (IAM) role that is used to access an Amazon S3 bucket. For detailed information
- // about using such a role, see Components and Terminology (https://alpha-aws-docs.aws.amazon.com/sync-service/latest/userguide/create-locations-cli.html#create-location-s3-cli)
- // in the AWS DataSync User Guide.
- type S3Config struct {
- _ struct{} `type:"structure"`
- // The Amazon S3 bucket to access. This bucket is used as a parameter in the
- // CreateLocationS3 operation.
- //
- // BucketAccessRoleArn is a required field
- BucketAccessRoleArn *string `type:"string" required:"true"`
- }
- // String returns the string representation
- func (s S3Config) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s S3Config) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *S3Config) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "S3Config"}
- if s.BucketAccessRoleArn == nil {
- invalidParams.Add(request.NewErrParamRequired("BucketAccessRoleArn"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucketAccessRoleArn sets the BucketAccessRoleArn field's value.
- func (s *S3Config) SetBucketAccessRoleArn(v string) *S3Config {
- s.BucketAccessRoleArn = &v
- return s
- }
- // StartTaskExecutionRequest
- type StartTaskExecutionInput struct {
- _ struct{} `type:"structure"`
- // Represents the options that are available to control the behavior of a StartTaskExecution
- // operation. Behavior includes preserving metadata such as user ID (UID), group
- // ID (GID), and file permissions, and also overwriting files in the destination,
- // data integrity verification, and so on.
- //
- // A task has a set of default options associated with it. If you don't specify
- // an option in StartTaskExecution, the default value is used. You can override
- // the defaults options on each task execution by specifying an overriding Options
- // value to StartTaskExecution.
- OverrideOptions *Options `type:"structure"`
- // The Amazon Resource Name (ARN) of the task to start.
- //
- // TaskArn is a required field
- TaskArn *string `type:"string" required:"true"`
- }
- // String returns the string representation
- func (s StartTaskExecutionInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s StartTaskExecutionInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *StartTaskExecutionInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "StartTaskExecutionInput"}
- if s.TaskArn == nil {
- invalidParams.Add(request.NewErrParamRequired("TaskArn"))
- }
- if s.OverrideOptions != nil {
- if err := s.OverrideOptions.Validate(); err != nil {
- invalidParams.AddNested("OverrideOptions", err.(request.ErrInvalidParams))
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetOverrideOptions sets the OverrideOptions field's value.
- func (s *StartTaskExecutionInput) SetOverrideOptions(v *Options) *StartTaskExecutionInput {
- s.OverrideOptions = v
- return s
- }
- // SetTaskArn sets the TaskArn field's value.
- func (s *StartTaskExecutionInput) SetTaskArn(v string) *StartTaskExecutionInput {
- s.TaskArn = &v
- return s
- }
- // StartTaskExecutionResponse
- type StartTaskExecutionOutput struct {
- _ struct{} `type:"structure"`
- // The Amazon Resource Name (ARN) of the specific task execution that was started.
- TaskExecutionArn *string `type:"string"`
- }
- // String returns the string representation
- func (s StartTaskExecutionOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s StartTaskExecutionOutput) GoString() string {
- return s.String()
- }
- // SetTaskExecutionArn sets the TaskExecutionArn field's value.
- func (s *StartTaskExecutionOutput) SetTaskExecutionArn(v string) *StartTaskExecutionOutput {
- s.TaskExecutionArn = &v
- return s
- }
- // Represents a single entry in a list of AWS resource tags. TagListEntry returns
- // an array that contains a list of tasks when the ListTagsForResource operation
- // is called.
- type TagListEntry struct {
- _ struct{} `type:"structure"`
- // The key for an AWS resource tag.
- Key *string `min:"1" type:"string"`
- // The value for an AWS resource tag.
- Value *string `min:"1" type:"string"`
- }
- // String returns the string representation
- func (s TagListEntry) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s TagListEntry) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *TagListEntry) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "TagListEntry"}
- if s.Key != nil && len(*s.Key) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Key", 1))
- }
- if s.Value != nil && len(*s.Value) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Value", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetKey sets the Key field's value.
- func (s *TagListEntry) SetKey(v string) *TagListEntry {
- s.Key = &v
- return s
- }
- // SetValue sets the Value field's value.
- func (s *TagListEntry) SetValue(v string) *TagListEntry {
- s.Value = &v
- return s
- }
- // TagResourceRequest
- type TagResourceInput struct {
- _ struct{} `type:"structure"`
- // The Amazon Resource Name (ARN) of the resource to apply the tag to.
- //
- // ResourceArn is a required field
- ResourceArn *string `type:"string" required:"true"`
- // The tags to apply.
- //
- // Tags is a required field
- Tags []*TagListEntry `type:"list" required:"true"`
- }
- // String returns the string representation
- func (s TagResourceInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s TagResourceInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *TagResourceInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "TagResourceInput"}
- if s.ResourceArn == nil {
- invalidParams.Add(request.NewErrParamRequired("ResourceArn"))
- }
- if s.Tags == nil {
- invalidParams.Add(request.NewErrParamRequired("Tags"))
- }
- if s.Tags != nil {
- for i, v := range s.Tags {
- if v == nil {
- continue
- }
- if err := v.Validate(); err != nil {
- invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Tags", i), err.(request.ErrInvalidParams))
- }
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetResourceArn sets the ResourceArn field's value.
- func (s *TagResourceInput) SetResourceArn(v string) *TagResourceInput {
- s.ResourceArn = &v
- return s
- }
- // SetTags sets the Tags field's value.
- func (s *TagResourceInput) SetTags(v []*TagListEntry) *TagResourceInput {
- s.Tags = v
- return s
- }
- type TagResourceOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation
- func (s TagResourceOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s TagResourceOutput) GoString() string {
- return s.String()
- }
- // Represents a single entry in a list of task executions. TaskExecutionListEntry
- // returns an array that contains a list of specific invocations of a task when
- // ListTaskExecutions operation is called.
- type TaskExecutionListEntry struct {
- _ struct{} `type:"structure"`
- // The status of a task execution.
- Status *string `type:"string" enum:"TaskExecutionStatus"`
- // The Amazon Resource Name (ARN) of the task that was executed.
- TaskExecutionArn *string `type:"string"`
- }
- // String returns the string representation
- func (s TaskExecutionListEntry) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s TaskExecutionListEntry) GoString() string {
- return s.String()
- }
- // SetStatus sets the Status field's value.
- func (s *TaskExecutionListEntry) SetStatus(v string) *TaskExecutionListEntry {
- s.Status = &v
- return s
- }
- // SetTaskExecutionArn sets the TaskExecutionArn field's value.
- func (s *TaskExecutionListEntry) SetTaskExecutionArn(v string) *TaskExecutionListEntry {
- s.TaskExecutionArn = &v
- return s
- }
- // Describes the detailed result of a TaskExecution operation. This result includes
- // the time in milliseconds spent in each phase, the status of the task execution,
- // and the errors encountered.
- type TaskExecutionResultDetail struct {
- _ struct{} `type:"structure"`
- // Errors that AWS DataSync encountered during execution of the task. You can
- // use this error code to help troubleshoot issues.
- ErrorCode *string `type:"string"`
- // Detailed description of an error that was encountered during the task execution.
- // You can use this information to help troubleshoot issues.
- ErrorDetail *string `type:"string"`
- // The total time in milliseconds that AWS DataSync spent in the PREPARING phase.
- PrepareDuration *int64 `type:"long"`
- // The status of the PREPARING phase.
- PrepareStatus *string `type:"string" enum:"PhaseStatus"`
- // The total time in milliseconds that AWS DataSync spent in the TRANSFERRING
- // phase.
- TransferDuration *int64 `type:"long"`
- // The status of the TRANSFERRING Phase.
- TransferStatus *string `type:"string" enum:"PhaseStatus"`
- // The total time in milliseconds that AWS DataSync spent in the VERIFYING phase.
- VerifyDuration *int64 `type:"long"`
- // The status of the VERIFYING Phase.
- VerifyStatus *string `type:"string" enum:"PhaseStatus"`
- }
- // String returns the string representation
- func (s TaskExecutionResultDetail) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s TaskExecutionResultDetail) GoString() string {
- return s.String()
- }
- // SetErrorCode sets the ErrorCode field's value.
- func (s *TaskExecutionResultDetail) SetErrorCode(v string) *TaskExecutionResultDetail {
- s.ErrorCode = &v
- return s
- }
- // SetErrorDetail sets the ErrorDetail field's value.
- func (s *TaskExecutionResultDetail) SetErrorDetail(v string) *TaskExecutionResultDetail {
- s.ErrorDetail = &v
- return s
- }
- // SetPrepareDuration sets the PrepareDuration field's value.
- func (s *TaskExecutionResultDetail) SetPrepareDuration(v int64) *TaskExecutionResultDetail {
- s.PrepareDuration = &v
- return s
- }
- // SetPrepareStatus sets the PrepareStatus field's value.
- func (s *TaskExecutionResultDetail) SetPrepareStatus(v string) *TaskExecutionResultDetail {
- s.PrepareStatus = &v
- return s
- }
- // SetTransferDuration sets the TransferDuration field's value.
- func (s *TaskExecutionResultDetail) SetTransferDuration(v int64) *TaskExecutionResultDetail {
- s.TransferDuration = &v
- return s
- }
- // SetTransferStatus sets the TransferStatus field's value.
- func (s *TaskExecutionResultDetail) SetTransferStatus(v string) *TaskExecutionResultDetail {
- s.TransferStatus = &v
- return s
- }
- // SetVerifyDuration sets the VerifyDuration field's value.
- func (s *TaskExecutionResultDetail) SetVerifyDuration(v int64) *TaskExecutionResultDetail {
- s.VerifyDuration = &v
- return s
- }
- // SetVerifyStatus sets the VerifyStatus field's value.
- func (s *TaskExecutionResultDetail) SetVerifyStatus(v string) *TaskExecutionResultDetail {
- s.VerifyStatus = &v
- return s
- }
- // Represents a single entry in a list of tasks. TaskListEntry returns an array
- // that contains a list of tasks when the ListTasks operation is called. A task
- // includes the source and destination file systems to sync and the options
- // to use for the tasks.
- type TaskListEntry struct {
- _ struct{} `type:"structure"`
- // The name of the task.
- Name *string `min:"1" type:"string"`
- // The status of the task.
- Status *string `type:"string" enum:"TaskStatus"`
- // The Amazon Resource Name (ARN) of the task.
- TaskArn *string `type:"string"`
- }
- // String returns the string representation
- func (s TaskListEntry) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s TaskListEntry) GoString() string {
- return s.String()
- }
- // SetName sets the Name field's value.
- func (s *TaskListEntry) SetName(v string) *TaskListEntry {
- s.Name = &v
- return s
- }
- // SetStatus sets the Status field's value.
- func (s *TaskListEntry) SetStatus(v string) *TaskListEntry {
- s.Status = &v
- return s
- }
- // SetTaskArn sets the TaskArn field's value.
- func (s *TaskListEntry) SetTaskArn(v string) *TaskListEntry {
- s.TaskArn = &v
- return s
- }
- // UntagResourceRequest
- type UntagResourceInput struct {
- _ struct{} `type:"structure"`
- // The keys in the key-value pair in the tag to remove.
- //
- // Keys is a required field
- Keys []*string `min:"1" type:"list" required:"true"`
- // The Amazon Resource Name (ARN) of the resource to remove the tag from.
- //
- // ResourceArn is a required field
- ResourceArn *string `type:"string" required:"true"`
- }
- // String returns the string representation
- func (s UntagResourceInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s UntagResourceInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *UntagResourceInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "UntagResourceInput"}
- if s.Keys == nil {
- invalidParams.Add(request.NewErrParamRequired("Keys"))
- }
- if s.Keys != nil && len(s.Keys) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Keys", 1))
- }
- if s.ResourceArn == nil {
- invalidParams.Add(request.NewErrParamRequired("ResourceArn"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetKeys sets the Keys field's value.
- func (s *UntagResourceInput) SetKeys(v []*string) *UntagResourceInput {
- s.Keys = v
- return s
- }
- // SetResourceArn sets the ResourceArn field's value.
- func (s *UntagResourceInput) SetResourceArn(v string) *UntagResourceInput {
- s.ResourceArn = &v
- return s
- }
- type UntagResourceOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation
- func (s UntagResourceOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s UntagResourceOutput) GoString() string {
- return s.String()
- }
- // UpdateAgentRequest
- type UpdateAgentInput struct {
- _ struct{} `type:"structure"`
- // The Amazon Resource Name (ARN) of the agent to update.
- //
- // AgentArn is a required field
- AgentArn *string `type:"string" required:"true"`
- // The name that you want to use to configure the agent.
- Name *string `min:"1" type:"string"`
- }
- // String returns the string representation
- func (s UpdateAgentInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s UpdateAgentInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *UpdateAgentInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "UpdateAgentInput"}
- if s.AgentArn == nil {
- invalidParams.Add(request.NewErrParamRequired("AgentArn"))
- }
- if s.Name != nil && len(*s.Name) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Name", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetAgentArn sets the AgentArn field's value.
- func (s *UpdateAgentInput) SetAgentArn(v string) *UpdateAgentInput {
- s.AgentArn = &v
- return s
- }
- // SetName sets the Name field's value.
- func (s *UpdateAgentInput) SetName(v string) *UpdateAgentInput {
- s.Name = &v
- return s
- }
- type UpdateAgentOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation
- func (s UpdateAgentOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s UpdateAgentOutput) GoString() string {
- return s.String()
- }
- // UpdateTaskResponse
- type UpdateTaskInput struct {
- _ struct{} `type:"structure"`
- // The name of the task to update.
- Name *string `min:"1" type:"string"`
- // Represents the options that are available to control the behavior of a StartTaskExecution
- // operation. Behavior includes preserving metadata such as user ID (UID), group
- // ID (GID), and file permissions, and also overwriting files in the destination,
- // data integrity verification, and so on.
- //
- // A task has a set of default options associated with it. If you don't specify
- // an option in StartTaskExecution, the default value is used. You can override
- // the defaults options on each task execution by specifying an overriding Options
- // value to StartTaskExecution.
- Options *Options `type:"structure"`
- // The Amazon Resource Name (ARN) of the resource name of the task to update.
- //
- // TaskArn is a required field
- TaskArn *string `type:"string" required:"true"`
- }
- // String returns the string representation
- func (s UpdateTaskInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s UpdateTaskInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *UpdateTaskInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "UpdateTaskInput"}
- if s.Name != nil && len(*s.Name) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Name", 1))
- }
- if s.TaskArn == nil {
- invalidParams.Add(request.NewErrParamRequired("TaskArn"))
- }
- if s.Options != nil {
- if err := s.Options.Validate(); err != nil {
- invalidParams.AddNested("Options", err.(request.ErrInvalidParams))
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetName sets the Name field's value.
- func (s *UpdateTaskInput) SetName(v string) *UpdateTaskInput {
- s.Name = &v
- return s
- }
- // SetOptions sets the Options field's value.
- func (s *UpdateTaskInput) SetOptions(v *Options) *UpdateTaskInput {
- s.Options = v
- return s
- }
- // SetTaskArn sets the TaskArn field's value.
- func (s *UpdateTaskInput) SetTaskArn(v string) *UpdateTaskInput {
- s.TaskArn = &v
- return s
- }
- type UpdateTaskOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation
- func (s UpdateTaskOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s UpdateTaskOutput) GoString() string {
- return s.String()
- }
- const (
- // AgentStatusOnline is a AgentStatus enum value
- AgentStatusOnline = "ONLINE"
- // AgentStatusOffline is a AgentStatus enum value
- AgentStatusOffline = "OFFLINE"
- )
- const (
- // AtimeNone is a Atime enum value
- AtimeNone = "NONE"
- // AtimeBestEffort is a Atime enum value
- AtimeBestEffort = "BEST_EFFORT"
- )
- const (
- // GidNone is a Gid enum value
- GidNone = "NONE"
- // GidIntValue is a Gid enum value
- GidIntValue = "INT_VALUE"
- // GidName is a Gid enum value
- GidName = "NAME"
- // GidBoth is a Gid enum value
- GidBoth = "BOTH"
- )
- const (
- // MtimeNone is a Mtime enum value
- MtimeNone = "NONE"
- // MtimePreserve is a Mtime enum value
- MtimePreserve = "PRESERVE"
- )
- const (
- // PhaseStatusPending is a PhaseStatus enum value
- PhaseStatusPending = "PENDING"
- // PhaseStatusSuccess is a PhaseStatus enum value
- PhaseStatusSuccess = "SUCCESS"
- // PhaseStatusError is a PhaseStatus enum value
- PhaseStatusError = "ERROR"
- )
- const (
- // PosixPermissionsNone is a PosixPermissions enum value
- PosixPermissionsNone = "NONE"
- // PosixPermissionsBestEffort is a PosixPermissions enum value
- PosixPermissionsBestEffort = "BEST_EFFORT"
- // PosixPermissionsPreserve is a PosixPermissions enum value
- PosixPermissionsPreserve = "PRESERVE"
- )
- const (
- // PreserveDeletedFilesPreserve is a PreserveDeletedFiles enum value
- PreserveDeletedFilesPreserve = "PRESERVE"
- // PreserveDeletedFilesRemove is a PreserveDeletedFiles enum value
- PreserveDeletedFilesRemove = "REMOVE"
- )
- const (
- // PreserveDevicesNone is a PreserveDevices enum value
- PreserveDevicesNone = "NONE"
- // PreserveDevicesPreserve is a PreserveDevices enum value
- PreserveDevicesPreserve = "PRESERVE"
- )
- const (
- // TaskExecutionStatusLaunching is a TaskExecutionStatus enum value
- TaskExecutionStatusLaunching = "LAUNCHING"
- // TaskExecutionStatusPreparing is a TaskExecutionStatus enum value
- TaskExecutionStatusPreparing = "PREPARING"
- // TaskExecutionStatusTransferring is a TaskExecutionStatus enum value
- TaskExecutionStatusTransferring = "TRANSFERRING"
- // TaskExecutionStatusVerifying is a TaskExecutionStatus enum value
- TaskExecutionStatusVerifying = "VERIFYING"
- // TaskExecutionStatusSuccess is a TaskExecutionStatus enum value
- TaskExecutionStatusSuccess = "SUCCESS"
- // TaskExecutionStatusError is a TaskExecutionStatus enum value
- TaskExecutionStatusError = "ERROR"
- )
- const (
- // TaskStatusAvailable is a TaskStatus enum value
- TaskStatusAvailable = "AVAILABLE"
- // TaskStatusCreating is a TaskStatus enum value
- TaskStatusCreating = "CREATING"
- // TaskStatusRunning is a TaskStatus enum value
- TaskStatusRunning = "RUNNING"
- // TaskStatusUnavailable is a TaskStatus enum value
- TaskStatusUnavailable = "UNAVAILABLE"
- )
- const (
- // UidNone is a Uid enum value
- UidNone = "NONE"
- // UidIntValue is a Uid enum value
- UidIntValue = "INT_VALUE"
- // UidName is a Uid enum value
- UidName = "NAME"
- // UidBoth is a Uid enum value
- UidBoth = "BOTH"
- )
- const (
- // VerifyModePointInTimeConsistent is a VerifyMode enum value
- VerifyModePointInTimeConsistent = "POINT_IN_TIME_CONSISTENT"
- // VerifyModeNone is a VerifyMode enum value
- VerifyModeNone = "NONE"
- )
|