| 1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476247724782479248024812482248324842485248624872488248924902491249224932494249524962497249824992500250125022503250425052506250725082509251025112512251325142515251625172518251925202521252225232524252525262527252825292530253125322533253425352536253725382539254025412542254325442545254625472548254925502551255225532554255525562557255825592560256125622563256425652566256725682569257025712572257325742575257625772578257925802581258225832584258525862587258825892590259125922593259425952596259725982599260026012602260326042605260626072608260926102611261226132614261526162617261826192620262126222623262426252626262726282629263026312632263326342635263626372638263926402641264226432644264526462647264826492650265126522653265426552656265726582659266026612662266326642665266626672668266926702671267226732674267526762677267826792680268126822683268426852686268726882689269026912692269326942695269626972698269927002701270227032704270527062707270827092710271127122713271427152716271727182719272027212722272327242725272627272728272927302731273227332734273527362737273827392740274127422743274427452746274727482749275027512752275327542755275627572758275927602761276227632764276527662767276827692770277127722773277427752776277727782779278027812782278327842785278627872788278927902791279227932794279527962797279827992800280128022803280428052806280728082809281028112812281328142815281628172818281928202821282228232824282528262827282828292830283128322833283428352836283728382839284028412842284328442845284628472848284928502851285228532854285528562857285828592860286128622863286428652866286728682869287028712872287328742875287628772878287928802881288228832884288528862887288828892890289128922893289428952896289728982899290029012902290329042905290629072908290929102911291229132914291529162917291829192920292129222923292429252926292729282929293029312932293329342935293629372938293929402941294229432944294529462947294829492950295129522953295429552956295729582959296029612962296329642965296629672968296929702971297229732974297529762977297829792980298129822983298429852986298729882989299029912992299329942995299629972998299930003001300230033004300530063007300830093010301130123013301430153016301730183019302030213022302330243025302630273028302930303031303230333034303530363037303830393040304130423043304430453046304730483049305030513052305330543055305630573058305930603061306230633064306530663067306830693070307130723073307430753076307730783079308030813082308330843085308630873088308930903091309230933094309530963097309830993100310131023103310431053106310731083109311031113112311331143115311631173118311931203121312231233124312531263127312831293130313131323133313431353136313731383139314031413142314331443145314631473148314931503151315231533154315531563157315831593160316131623163316431653166316731683169317031713172317331743175317631773178317931803181318231833184318531863187318831893190319131923193319431953196319731983199320032013202320332043205320632073208320932103211321232133214321532163217321832193220322132223223322432253226322732283229323032313232323332343235323632373238323932403241324232433244324532463247324832493250325132523253325432553256325732583259326032613262326332643265326632673268326932703271327232733274327532763277327832793280328132823283328432853286328732883289329032913292329332943295329632973298329933003301330233033304330533063307330833093310331133123313331433153316331733183319332033213322332333243325332633273328332933303331333233333334333533363337333833393340334133423343334433453346334733483349335033513352335333543355335633573358335933603361336233633364336533663367336833693370337133723373337433753376337733783379338033813382338333843385338633873388338933903391339233933394339533963397339833993400340134023403340434053406340734083409341034113412341334143415341634173418341934203421342234233424342534263427342834293430343134323433343434353436343734383439344034413442344334443445344634473448344934503451345234533454345534563457345834593460346134623463346434653466346734683469347034713472347334743475347634773478347934803481348234833484348534863487348834893490349134923493349434953496349734983499350035013502350335043505350635073508350935103511351235133514351535163517351835193520352135223523352435253526352735283529353035313532353335343535353635373538353935403541354235433544354535463547354835493550355135523553355435553556355735583559356035613562356335643565356635673568356935703571357235733574357535763577357835793580358135823583358435853586358735883589359035913592359335943595359635973598359936003601360236033604360536063607360836093610361136123613361436153616361736183619362036213622362336243625362636273628362936303631363236333634363536363637363836393640364136423643364436453646364736483649365036513652365336543655365636573658365936603661366236633664366536663667366836693670367136723673367436753676367736783679368036813682368336843685368636873688368936903691369236933694369536963697369836993700370137023703370437053706370737083709371037113712371337143715371637173718371937203721372237233724372537263727372837293730373137323733373437353736373737383739374037413742374337443745374637473748374937503751375237533754375537563757375837593760376137623763376437653766376737683769377037713772377337743775377637773778377937803781378237833784378537863787378837893790379137923793379437953796379737983799380038013802380338043805380638073808380938103811381238133814381538163817381838193820382138223823382438253826382738283829383038313832383338343835383638373838383938403841384238433844384538463847384838493850385138523853385438553856385738583859386038613862386338643865386638673868386938703871387238733874387538763877387838793880388138823883388438853886388738883889389038913892389338943895389638973898389939003901390239033904390539063907390839093910391139123913391439153916391739183919392039213922392339243925392639273928392939303931393239333934393539363937393839393940394139423943394439453946394739483949395039513952395339543955395639573958395939603961396239633964396539663967396839693970397139723973397439753976397739783979398039813982398339843985398639873988398939903991399239933994399539963997399839994000400140024003400440054006400740084009401040114012401340144015401640174018401940204021402240234024402540264027402840294030403140324033403440354036403740384039404040414042404340444045404640474048404940504051405240534054405540564057405840594060406140624063406440654066406740684069407040714072407340744075407640774078407940804081408240834084408540864087408840894090409140924093409440954096409740984099410041014102410341044105410641074108410941104111411241134114411541164117411841194120412141224123412441254126412741284129413041314132413341344135413641374138413941404141414241434144414541464147414841494150415141524153415441554156415741584159416041614162416341644165416641674168416941704171417241734174417541764177417841794180418141824183418441854186418741884189419041914192419341944195419641974198419942004201420242034204420542064207420842094210421142124213421442154216421742184219422042214222422342244225422642274228422942304231423242334234423542364237423842394240424142424243424442454246424742484249425042514252425342544255425642574258425942604261426242634264426542664267426842694270427142724273427442754276427742784279428042814282428342844285428642874288428942904291429242934294429542964297429842994300430143024303430443054306430743084309431043114312431343144315431643174318431943204321432243234324432543264327432843294330433143324333433443354336433743384339434043414342434343444345434643474348434943504351435243534354435543564357435843594360436143624363436443654366436743684369437043714372437343744375437643774378437943804381438243834384438543864387438843894390439143924393439443954396439743984399440044014402440344044405440644074408440944104411441244134414441544164417441844194420442144224423442444254426442744284429443044314432443344344435443644374438443944404441444244434444444544464447444844494450445144524453445444554456445744584459446044614462446344644465446644674468446944704471447244734474447544764477447844794480448144824483448444854486448744884489449044914492449344944495449644974498449945004501450245034504450545064507450845094510451145124513451445154516451745184519452045214522452345244525452645274528452945304531453245334534453545364537453845394540454145424543454445454546454745484549455045514552455345544555455645574558455945604561456245634564456545664567456845694570457145724573457445754576457745784579458045814582458345844585458645874588458945904591459245934594459545964597459845994600460146024603460446054606460746084609461046114612461346144615461646174618461946204621462246234624462546264627462846294630463146324633463446354636463746384639464046414642464346444645464646474648464946504651465246534654465546564657465846594660466146624663466446654666466746684669467046714672467346744675467646774678467946804681468246834684468546864687468846894690469146924693469446954696469746984699470047014702470347044705470647074708470947104711471247134714471547164717471847194720472147224723472447254726472747284729473047314732473347344735473647374738473947404741474247434744474547464747474847494750475147524753475447554756475747584759476047614762476347644765476647674768476947704771477247734774477547764777477847794780478147824783478447854786478747884789479047914792479347944795479647974798479948004801480248034804480548064807480848094810481148124813481448154816481748184819482048214822482348244825482648274828482948304831483248334834483548364837483848394840484148424843484448454846484748484849485048514852485348544855485648574858485948604861486248634864486548664867486848694870487148724873487448754876487748784879488048814882488348844885488648874888488948904891489248934894489548964897489848994900490149024903490449054906490749084909491049114912491349144915491649174918491949204921492249234924492549264927492849294930493149324933493449354936493749384939494049414942494349444945494649474948494949504951495249534954495549564957495849594960496149624963496449654966496749684969497049714972497349744975497649774978497949804981498249834984498549864987498849894990499149924993499449954996499749984999500050015002500350045005500650075008500950105011501250135014501550165017501850195020502150225023502450255026502750285029503050315032503350345035503650375038503950405041504250435044504550465047504850495050505150525053505450555056505750585059506050615062506350645065506650675068506950705071507250735074507550765077507850795080508150825083508450855086508750885089509050915092509350945095509650975098509951005101510251035104510551065107510851095110511151125113511451155116511751185119512051215122512351245125512651275128512951305131513251335134513551365137513851395140514151425143514451455146514751485149515051515152515351545155515651575158515951605161516251635164516551665167516851695170517151725173517451755176517751785179518051815182518351845185518651875188518951905191519251935194519551965197519851995200520152025203520452055206520752085209521052115212521352145215521652175218521952205221522252235224522552265227522852295230523152325233523452355236523752385239524052415242524352445245524652475248524952505251525252535254525552565257525852595260526152625263526452655266526752685269527052715272527352745275527652775278527952805281528252835284528552865287528852895290529152925293529452955296529752985299530053015302530353045305530653075308530953105311531253135314531553165317531853195320532153225323532453255326532753285329533053315332533353345335533653375338533953405341534253435344534553465347534853495350535153525353535453555356535753585359536053615362536353645365536653675368536953705371537253735374537553765377537853795380538153825383538453855386538753885389539053915392539353945395539653975398539954005401540254035404540554065407540854095410541154125413541454155416541754185419542054215422542354245425542654275428542954305431543254335434543554365437543854395440544154425443544454455446544754485449545054515452545354545455545654575458545954605461546254635464546554665467546854695470547154725473547454755476547754785479548054815482548354845485548654875488548954905491549254935494549554965497549854995500550155025503550455055506550755085509551055115512551355145515551655175518551955205521552255235524552555265527552855295530553155325533553455355536553755385539554055415542554355445545554655475548554955505551555255535554555555565557555855595560556155625563556455655566556755685569557055715572557355745575557655775578557955805581558255835584558555865587558855895590559155925593559455955596559755985599560056015602560356045605560656075608560956105611561256135614561556165617561856195620562156225623562456255626562756285629563056315632563356345635563656375638563956405641564256435644564556465647564856495650565156525653565456555656565756585659566056615662566356645665566656675668566956705671567256735674567556765677567856795680568156825683568456855686568756885689569056915692569356945695569656975698569957005701570257035704570557065707570857095710571157125713571457155716571757185719572057215722572357245725572657275728572957305731573257335734573557365737573857395740574157425743574457455746574757485749575057515752575357545755575657575758575957605761576257635764576557665767576857695770577157725773577457755776577757785779578057815782578357845785578657875788578957905791579257935794579557965797579857995800580158025803580458055806580758085809581058115812581358145815581658175818581958205821582258235824582558265827582858295830583158325833583458355836583758385839584058415842584358445845584658475848584958505851585258535854585558565857585858595860586158625863586458655866586758685869587058715872587358745875587658775878587958805881588258835884588558865887588858895890589158925893589458955896589758985899590059015902590359045905590659075908590959105911591259135914591559165917591859195920592159225923592459255926592759285929593059315932593359345935593659375938593959405941594259435944594559465947594859495950595159525953595459555956595759585959596059615962596359645965596659675968596959705971597259735974597559765977597859795980598159825983598459855986598759885989599059915992599359945995599659975998599960006001600260036004600560066007600860096010601160126013601460156016601760186019602060216022602360246025602660276028602960306031603260336034603560366037603860396040604160426043604460456046604760486049605060516052605360546055605660576058605960606061606260636064606560666067606860696070607160726073607460756076607760786079608060816082608360846085608660876088608960906091609260936094609560966097609860996100610161026103610461056106610761086109611061116112611361146115611661176118611961206121612261236124612561266127612861296130613161326133613461356136613761386139614061416142614361446145614661476148614961506151615261536154615561566157615861596160616161626163616461656166616761686169617061716172617361746175617661776178617961806181618261836184618561866187618861896190619161926193619461956196619761986199620062016202620362046205620662076208620962106211621262136214621562166217621862196220622162226223622462256226622762286229623062316232623362346235623662376238623962406241624262436244624562466247624862496250625162526253625462556256625762586259626062616262626362646265626662676268626962706271627262736274627562766277627862796280628162826283628462856286628762886289629062916292629362946295629662976298629963006301630263036304630563066307630863096310631163126313631463156316631763186319632063216322632363246325632663276328632963306331633263336334633563366337633863396340634163426343634463456346634763486349635063516352635363546355635663576358635963606361636263636364636563666367636863696370637163726373637463756376637763786379638063816382638363846385638663876388638963906391639263936394639563966397639863996400640164026403640464056406640764086409641064116412641364146415641664176418641964206421642264236424642564266427642864296430643164326433643464356436643764386439644064416442644364446445644664476448644964506451645264536454645564566457645864596460646164626463646464656466646764686469647064716472647364746475647664776478647964806481648264836484648564866487648864896490649164926493649464956496649764986499650065016502650365046505650665076508650965106511651265136514651565166517651865196520652165226523652465256526652765286529653065316532653365346535653665376538653965406541654265436544654565466547654865496550655165526553655465556556655765586559656065616562656365646565656665676568656965706571657265736574657565766577657865796580658165826583658465856586658765886589659065916592659365946595659665976598659966006601660266036604660566066607660866096610661166126613661466156616661766186619662066216622662366246625662666276628662966306631663266336634663566366637663866396640664166426643664466456646664766486649665066516652665366546655665666576658665966606661666266636664666566666667666866696670667166726673667466756676667766786679668066816682668366846685668666876688668966906691669266936694669566966697669866996700670167026703670467056706670767086709671067116712671367146715671667176718671967206721672267236724672567266727672867296730673167326733673467356736673767386739674067416742674367446745674667476748674967506751675267536754675567566757675867596760676167626763676467656766676767686769677067716772677367746775677667776778677967806781678267836784678567866787678867896790679167926793679467956796679767986799680068016802680368046805680668076808680968106811681268136814681568166817681868196820682168226823682468256826682768286829683068316832683368346835683668376838683968406841684268436844684568466847684868496850685168526853685468556856685768586859686068616862686368646865686668676868686968706871687268736874687568766877687868796880688168826883688468856886688768886889689068916892689368946895689668976898689969006901690269036904690569066907690869096910691169126913691469156916691769186919692069216922692369246925692669276928692969306931693269336934693569366937693869396940694169426943694469456946694769486949695069516952695369546955695669576958695969606961696269636964696569666967696869696970697169726973697469756976697769786979698069816982698369846985698669876988698969906991699269936994699569966997699869997000700170027003700470057006700770087009701070117012701370147015701670177018701970207021702270237024702570267027702870297030703170327033703470357036703770387039704070417042704370447045704670477048704970507051705270537054705570567057705870597060706170627063706470657066706770687069707070717072707370747075707670777078707970807081708270837084708570867087708870897090709170927093709470957096709770987099710071017102710371047105710671077108710971107111711271137114711571167117711871197120712171227123712471257126712771287129713071317132713371347135713671377138713971407141714271437144714571467147714871497150715171527153715471557156715771587159716071617162716371647165716671677168716971707171717271737174717571767177717871797180718171827183718471857186718771887189719071917192719371947195719671977198719972007201720272037204720572067207720872097210721172127213721472157216721772187219722072217222722372247225722672277228722972307231723272337234723572367237723872397240724172427243724472457246724772487249725072517252725372547255725672577258725972607261726272637264726572667267726872697270727172727273727472757276727772787279728072817282728372847285728672877288728972907291729272937294729572967297729872997300730173027303730473057306730773087309731073117312731373147315731673177318731973207321732273237324732573267327732873297330733173327333733473357336733773387339734073417342734373447345734673477348734973507351735273537354735573567357735873597360736173627363736473657366736773687369737073717372737373747375737673777378737973807381738273837384738573867387738873897390739173927393739473957396739773987399740074017402740374047405740674077408740974107411741274137414741574167417741874197420742174227423742474257426742774287429743074317432743374347435743674377438743974407441744274437444744574467447744874497450745174527453745474557456745774587459746074617462746374647465746674677468746974707471747274737474747574767477747874797480748174827483748474857486748774887489749074917492749374947495749674977498749975007501750275037504750575067507750875097510751175127513751475157516751775187519752075217522752375247525752675277528752975307531753275337534753575367537753875397540754175427543754475457546754775487549755075517552755375547555755675577558755975607561756275637564756575667567756875697570757175727573757475757576757775787579758075817582758375847585758675877588758975907591759275937594759575967597759875997600760176027603760476057606760776087609761076117612761376147615761676177618761976207621762276237624762576267627762876297630763176327633763476357636763776387639764076417642764376447645764676477648764976507651765276537654765576567657765876597660766176627663766476657666766776687669767076717672767376747675767676777678767976807681768276837684768576867687768876897690769176927693769476957696769776987699770077017702770377047705770677077708770977107711771277137714771577167717771877197720772177227723772477257726772777287729773077317732773377347735773677377738773977407741774277437744774577467747774877497750775177527753775477557756775777587759776077617762776377647765776677677768776977707771777277737774777577767777777877797780778177827783778477857786778777887789779077917792779377947795779677977798779978007801780278037804780578067807780878097810781178127813781478157816781778187819782078217822782378247825782678277828782978307831783278337834783578367837783878397840784178427843784478457846784778487849785078517852785378547855785678577858785978607861786278637864786578667867786878697870787178727873787478757876787778787879788078817882788378847885788678877888788978907891789278937894789578967897789878997900790179027903790479057906790779087909791079117912791379147915791679177918791979207921792279237924792579267927792879297930793179327933793479357936793779387939794079417942794379447945794679477948794979507951795279537954795579567957795879597960796179627963796479657966796779687969797079717972797379747975797679777978797979807981798279837984798579867987798879897990799179927993799479957996799779987999800080018002800380048005800680078008800980108011801280138014801580168017801880198020802180228023802480258026802780288029803080318032803380348035803680378038803980408041804280438044804580468047804880498050805180528053805480558056805780588059806080618062806380648065806680678068806980708071807280738074807580768077807880798080808180828083808480858086808780888089809080918092809380948095809680978098809981008101810281038104810581068107810881098110811181128113811481158116811781188119812081218122812381248125812681278128812981308131813281338134813581368137813881398140814181428143814481458146814781488149815081518152815381548155815681578158815981608161816281638164816581668167816881698170817181728173817481758176817781788179818081818182818381848185818681878188818981908191819281938194819581968197819881998200820182028203820482058206820782088209821082118212821382148215821682178218821982208221822282238224822582268227822882298230823182328233823482358236823782388239824082418242824382448245824682478248824982508251825282538254825582568257825882598260826182628263826482658266826782688269827082718272827382748275827682778278827982808281828282838284828582868287828882898290829182928293829482958296829782988299830083018302830383048305830683078308830983108311831283138314831583168317831883198320832183228323832483258326832783288329833083318332833383348335833683378338833983408341834283438344834583468347834883498350835183528353835483558356835783588359836083618362836383648365836683678368836983708371837283738374837583768377837883798380838183828383838483858386838783888389839083918392839383948395839683978398839984008401840284038404840584068407840884098410841184128413841484158416841784188419842084218422842384248425842684278428842984308431843284338434843584368437843884398440844184428443844484458446844784488449845084518452845384548455845684578458845984608461846284638464846584668467846884698470847184728473847484758476847784788479848084818482848384848485848684878488848984908491849284938494849584968497849884998500850185028503850485058506850785088509851085118512851385148515851685178518851985208521852285238524852585268527852885298530853185328533853485358536853785388539854085418542854385448545854685478548854985508551855285538554855585568557855885598560856185628563856485658566856785688569857085718572857385748575857685778578857985808581858285838584858585868587858885898590859185928593859485958596859785988599860086018602860386048605860686078608860986108611861286138614861586168617861886198620862186228623862486258626862786288629863086318632863386348635863686378638863986408641864286438644864586468647864886498650865186528653865486558656865786588659866086618662866386648665866686678668866986708671867286738674867586768677867886798680868186828683868486858686868786888689869086918692869386948695869686978698869987008701870287038704870587068707870887098710871187128713871487158716871787188719872087218722872387248725872687278728872987308731873287338734873587368737873887398740874187428743874487458746874787488749875087518752875387548755875687578758875987608761876287638764876587668767876887698770877187728773877487758776877787788779878087818782878387848785878687878788878987908791879287938794879587968797879887998800880188028803880488058806880788088809881088118812881388148815881688178818881988208821882288238824882588268827882888298830883188328833883488358836883788388839884088418842884388448845884688478848884988508851885288538854885588568857885888598860886188628863886488658866886788688869887088718872887388748875887688778878887988808881888288838884888588868887888888898890889188928893889488958896889788988899890089018902890389048905890689078908890989108911891289138914891589168917891889198920892189228923892489258926892789288929893089318932893389348935893689378938893989408941894289438944894589468947894889498950895189528953895489558956895789588959896089618962896389648965896689678968896989708971897289738974897589768977897889798980898189828983898489858986898789888989899089918992899389948995899689978998899990009001900290039004900590069007900890099010901190129013901490159016901790189019902090219022902390249025902690279028902990309031903290339034903590369037903890399040904190429043904490459046904790489049905090519052905390549055905690579058905990609061906290639064906590669067906890699070907190729073907490759076907790789079908090819082908390849085908690879088908990909091909290939094909590969097909890999100910191029103910491059106910791089109911091119112911391149115911691179118911991209121912291239124912591269127912891299130913191329133913491359136913791389139914091419142914391449145914691479148914991509151915291539154915591569157915891599160916191629163916491659166916791689169917091719172917391749175917691779178917991809181918291839184918591869187918891899190919191929193919491959196919791989199920092019202920392049205920692079208920992109211921292139214921592169217921892199220922192229223922492259226922792289229923092319232923392349235923692379238923992409241924292439244924592469247924892499250925192529253925492559256925792589259926092619262926392649265926692679268926992709271927292739274927592769277927892799280928192829283928492859286928792889289929092919292929392949295929692979298929993009301930293039304930593069307930893099310931193129313931493159316931793189319932093219322932393249325932693279328932993309331933293339334933593369337933893399340934193429343934493459346934793489349935093519352935393549355935693579358935993609361936293639364936593669367936893699370937193729373937493759376937793789379938093819382938393849385938693879388938993909391939293939394939593969397939893999400940194029403940494059406940794089409941094119412941394149415941694179418941994209421942294239424942594269427942894299430943194329433943494359436943794389439944094419442944394449445944694479448944994509451945294539454945594569457945894599460946194629463946494659466946794689469947094719472947394749475947694779478947994809481948294839484948594869487948894899490949194929493949494959496949794989499950095019502950395049505950695079508950995109511951295139514951595169517951895199520952195229523952495259526952795289529953095319532953395349535953695379538953995409541954295439544954595469547954895499550955195529553955495559556955795589559956095619562956395649565956695679568956995709571957295739574957595769577957895799580958195829583958495859586958795889589959095919592959395949595959695979598959996009601960296039604960596069607960896099610961196129613961496159616961796189619962096219622962396249625962696279628962996309631963296339634963596369637963896399640964196429643964496459646964796489649965096519652965396549655965696579658965996609661966296639664966596669667966896699670967196729673967496759676967796789679968096819682968396849685968696879688968996909691969296939694969596969697969896999700970197029703970497059706970797089709971097119712971397149715971697179718971997209721972297239724972597269727972897299730973197329733973497359736973797389739974097419742974397449745974697479748974997509751975297539754975597569757975897599760976197629763976497659766976797689769977097719772977397749775977697779778977997809781978297839784978597869787978897899790979197929793979497959796979797989799980098019802980398049805980698079808980998109811981298139814981598169817981898199820982198229823982498259826982798289829983098319832983398349835983698379838983998409841984298439844984598469847984898499850985198529853985498559856985798589859986098619862986398649865986698679868986998709871987298739874987598769877987898799880988198829883988498859886988798889889989098919892989398949895989698979898989999009901990299039904990599069907990899099910991199129913991499159916991799189919992099219922992399249925992699279928992999309931993299339934993599369937993899399940994199429943994499459946994799489949995099519952995399549955995699579958995999609961996299639964996599669967996899699970997199729973997499759976997799789979998099819982998399849985998699879988998999909991999299939994999599969997999899991000010001100021000310004100051000610007100081000910010100111001210013100141001510016100171001810019100201002110022100231002410025100261002710028100291003010031100321003310034100351003610037100381003910040100411004210043100441004510046100471004810049100501005110052100531005410055100561005710058100591006010061100621006310064100651006610067100681006910070100711007210073100741007510076100771007810079100801008110082100831008410085100861008710088100891009010091100921009310094100951009610097100981009910100101011010210103101041010510106101071010810109101101011110112101131011410115101161011710118101191012010121101221012310124101251012610127101281012910130101311013210133101341013510136101371013810139101401014110142101431014410145101461014710148101491015010151101521015310154101551015610157101581015910160101611016210163101641016510166101671016810169101701017110172101731017410175101761017710178101791018010181101821018310184101851018610187101881018910190101911019210193101941019510196101971019810199102001020110202102031020410205102061020710208102091021010211102121021310214102151021610217102181021910220102211022210223102241022510226102271022810229102301023110232102331023410235102361023710238102391024010241102421024310244102451024610247102481024910250102511025210253102541025510256102571025810259102601026110262102631026410265102661026710268102691027010271102721027310274102751027610277102781027910280102811028210283102841028510286102871028810289102901029110292102931029410295102961029710298102991030010301103021030310304103051030610307103081030910310103111031210313103141031510316103171031810319103201032110322103231032410325103261032710328103291033010331103321033310334103351033610337103381033910340103411034210343103441034510346103471034810349103501035110352103531035410355103561035710358103591036010361103621036310364103651036610367103681036910370103711037210373103741037510376103771037810379103801038110382103831038410385103861038710388103891039010391103921039310394103951039610397103981039910400104011040210403104041040510406104071040810409104101041110412104131041410415104161041710418104191042010421104221042310424104251042610427104281042910430104311043210433104341043510436104371043810439104401044110442104431044410445104461044710448104491045010451104521045310454104551045610457104581045910460104611046210463104641046510466104671046810469104701047110472104731047410475104761047710478104791048010481104821048310484104851048610487104881048910490104911049210493104941049510496104971049810499105001050110502105031050410505105061050710508105091051010511105121051310514105151051610517105181051910520105211052210523105241052510526105271052810529105301053110532105331053410535105361053710538105391054010541105421054310544105451054610547105481054910550105511055210553105541055510556105571055810559105601056110562105631056410565105661056710568105691057010571105721057310574105751057610577105781057910580105811058210583105841058510586105871058810589105901059110592105931059410595105961059710598105991060010601106021060310604106051060610607106081060910610106111061210613106141061510616106171061810619106201062110622106231062410625106261062710628106291063010631106321063310634106351063610637106381063910640106411064210643106441064510646106471064810649106501065110652106531065410655106561065710658106591066010661106621066310664106651066610667106681066910670106711067210673106741067510676106771067810679106801068110682106831068410685106861068710688106891069010691106921069310694106951069610697106981069910700107011070210703107041070510706107071070810709107101071110712107131071410715107161071710718107191072010721107221072310724107251072610727107281072910730107311073210733107341073510736107371073810739107401074110742107431074410745107461074710748107491075010751107521075310754107551075610757107581075910760107611076210763107641076510766107671076810769107701077110772107731077410775107761077710778107791078010781107821078310784107851078610787107881078910790107911079210793107941079510796107971079810799108001080110802108031080410805108061080710808108091081010811108121081310814108151081610817108181081910820108211082210823108241082510826108271082810829108301083110832108331083410835108361083710838108391084010841108421084310844108451084610847108481084910850108511085210853108541085510856108571085810859108601086110862108631086410865108661086710868108691087010871108721087310874108751087610877108781087910880108811088210883108841088510886108871088810889108901089110892108931089410895108961089710898108991090010901109021090310904109051090610907109081090910910109111091210913109141091510916109171091810919109201092110922109231092410925109261092710928109291093010931109321093310934109351093610937109381093910940109411094210943109441094510946109471094810949109501095110952109531095410955109561095710958109591096010961109621096310964109651096610967109681096910970109711097210973109741097510976109771097810979109801098110982109831098410985109861098710988109891099010991109921099310994109951099610997109981099911000110011100211003110041100511006110071100811009110101101111012110131101411015110161101711018110191102011021110221102311024110251102611027110281102911030110311103211033110341103511036110371103811039110401104111042110431104411045110461104711048110491105011051110521105311054110551105611057110581105911060110611106211063110641106511066110671106811069110701107111072110731107411075110761107711078110791108011081110821108311084110851108611087110881108911090110911109211093110941109511096110971109811099111001110111102111031110411105111061110711108111091111011111111121111311114111151111611117111181111911120111211112211123111241112511126111271112811129111301113111132111331113411135111361113711138111391114011141111421114311144111451114611147111481114911150111511115211153111541115511156111571115811159111601116111162111631116411165111661116711168111691117011171111721117311174111751117611177111781117911180111811118211183111841118511186111871118811189111901119111192111931119411195111961119711198111991120011201112021120311204112051120611207112081120911210112111121211213112141121511216112171121811219112201122111222112231122411225112261122711228112291123011231112321123311234112351123611237112381123911240112411124211243112441124511246112471124811249112501125111252112531125411255112561125711258112591126011261112621126311264112651126611267112681126911270112711127211273112741127511276112771127811279112801128111282112831128411285112861128711288112891129011291112921129311294112951129611297112981129911300113011130211303113041130511306113071130811309113101131111312113131131411315113161131711318113191132011321113221132311324113251132611327113281132911330113311133211333113341133511336113371133811339113401134111342113431134411345113461134711348113491135011351113521135311354113551135611357113581135911360113611136211363113641136511366113671136811369113701137111372113731137411375113761137711378113791138011381113821138311384113851138611387113881138911390113911139211393113941139511396113971139811399114001140111402114031140411405114061140711408114091141011411114121141311414114151141611417114181141911420114211142211423114241142511426114271142811429114301143111432114331143411435114361143711438114391144011441114421144311444114451144611447114481144911450114511145211453114541145511456114571145811459114601146111462114631146411465114661146711468114691147011471114721147311474114751147611477114781147911480114811148211483114841148511486114871148811489114901149111492114931149411495114961149711498114991150011501115021150311504115051150611507115081150911510115111151211513115141151511516115171151811519115201152111522115231152411525115261152711528115291153011531115321153311534115351153611537115381153911540115411154211543115441154511546115471154811549115501155111552115531155411555115561155711558115591156011561115621156311564115651156611567115681156911570115711157211573115741157511576115771157811579115801158111582115831158411585115861158711588115891159011591115921159311594115951159611597115981159911600116011160211603116041160511606116071160811609116101161111612116131161411615116161161711618116191162011621116221162311624116251162611627116281162911630116311163211633116341163511636116371163811639116401164111642116431164411645116461164711648116491165011651116521165311654116551165611657116581165911660116611166211663116641166511666116671166811669116701167111672116731167411675116761167711678116791168011681116821168311684116851168611687116881168911690116911169211693116941169511696116971169811699117001170111702117031170411705117061170711708117091171011711117121171311714117151171611717117181171911720117211172211723117241172511726117271172811729117301173111732117331173411735117361173711738117391174011741117421174311744117451174611747117481174911750117511175211753117541175511756117571175811759117601176111762117631176411765117661176711768117691177011771117721177311774117751177611777117781177911780117811178211783117841178511786117871178811789117901179111792117931179411795117961179711798117991180011801118021180311804118051180611807118081180911810118111181211813118141181511816118171181811819118201182111822118231182411825118261182711828118291183011831118321183311834118351183611837118381183911840118411184211843118441184511846118471184811849118501185111852118531185411855118561185711858118591186011861118621186311864118651186611867118681186911870118711187211873118741187511876118771187811879118801188111882118831188411885118861188711888118891189011891118921189311894118951189611897118981189911900119011190211903119041190511906119071190811909119101191111912119131191411915119161191711918119191192011921119221192311924119251192611927119281192911930119311193211933119341193511936119371193811939119401194111942119431194411945119461194711948119491195011951119521195311954119551195611957119581195911960119611196211963119641196511966119671196811969119701197111972119731197411975119761197711978119791198011981119821198311984119851198611987119881198911990119911199211993119941199511996119971199811999120001200112002120031200412005120061200712008120091201012011120121201312014120151201612017120181201912020120211202212023120241202512026120271202812029120301203112032120331203412035120361203712038120391204012041120421204312044120451204612047120481204912050120511205212053120541205512056120571205812059120601206112062120631206412065120661206712068120691207012071120721207312074120751207612077120781207912080120811208212083120841208512086120871208812089120901209112092120931209412095120961209712098120991210012101121021210312104121051210612107121081210912110121111211212113121141211512116121171211812119121201212112122121231212412125121261212712128121291213012131121321213312134121351213612137121381213912140121411214212143121441214512146121471214812149121501215112152121531215412155121561215712158121591216012161121621216312164121651216612167121681216912170121711217212173121741217512176121771217812179121801218112182121831218412185121861218712188121891219012191121921219312194121951219612197121981219912200122011220212203122041220512206122071220812209122101221112212122131221412215122161221712218122191222012221122221222312224122251222612227122281222912230122311223212233122341223512236122371223812239122401224112242122431224412245122461224712248122491225012251122521225312254122551225612257122581225912260122611226212263122641226512266122671226812269122701227112272122731227412275122761227712278122791228012281122821228312284122851228612287122881228912290122911229212293122941229512296122971229812299123001230112302123031230412305123061230712308123091231012311123121231312314123151231612317123181231912320123211232212323123241232512326123271232812329123301233112332123331233412335123361233712338123391234012341123421234312344123451234612347123481234912350123511235212353123541235512356123571235812359123601236112362123631236412365123661236712368123691237012371123721237312374123751237612377123781237912380123811238212383123841238512386123871238812389123901239112392123931239412395123961239712398123991240012401124021240312404124051240612407124081240912410124111241212413124141241512416124171241812419124201242112422124231242412425124261242712428124291243012431124321243312434124351243612437124381243912440124411244212443124441244512446124471244812449124501245112452124531245412455124561245712458124591246012461124621246312464124651246612467124681246912470124711247212473124741247512476124771247812479124801248112482124831248412485124861248712488124891249012491124921249312494124951249612497124981249912500125011250212503125041250512506125071250812509125101251112512125131251412515125161251712518125191252012521125221252312524125251252612527125281252912530125311253212533125341253512536125371253812539125401254112542125431254412545125461254712548125491255012551125521255312554125551255612557125581255912560125611256212563125641256512566125671256812569125701257112572125731257412575125761257712578125791258012581125821258312584125851258612587125881258912590125911259212593125941259512596125971259812599126001260112602126031260412605126061260712608126091261012611126121261312614126151261612617126181261912620126211262212623126241262512626126271262812629126301263112632126331263412635126361263712638126391264012641126421264312644126451264612647126481264912650126511265212653126541265512656126571265812659126601266112662126631266412665126661266712668126691267012671126721267312674126751267612677126781267912680126811268212683126841268512686126871268812689126901269112692126931269412695126961269712698126991270012701127021270312704127051270612707127081270912710127111271212713127141271512716127171271812719127201272112722127231272412725127261272712728127291273012731127321273312734127351273612737127381273912740127411274212743127441274512746127471274812749127501275112752127531275412755127561275712758127591276012761127621276312764127651276612767127681276912770127711277212773127741277512776127771277812779127801278112782127831278412785127861278712788127891279012791127921279312794127951279612797127981279912800128011280212803128041280512806128071280812809128101281112812128131281412815128161281712818128191282012821128221282312824128251282612827128281282912830128311283212833128341283512836128371283812839128401284112842128431284412845128461284712848128491285012851128521285312854128551285612857128581285912860128611286212863128641286512866128671286812869128701287112872128731287412875128761287712878128791288012881128821288312884128851288612887128881288912890128911289212893128941289512896128971289812899129001290112902129031290412905129061290712908129091291012911129121291312914129151291612917129181291912920129211292212923129241292512926129271292812929129301293112932129331293412935129361293712938129391294012941129421294312944129451294612947129481294912950129511295212953129541295512956129571295812959129601296112962129631296412965129661296712968129691297012971129721297312974129751297612977129781297912980129811298212983129841298512986129871298812989129901299112992129931299412995129961299712998129991300013001130021300313004130051300613007130081300913010130111301213013130141301513016130171301813019130201302113022130231302413025130261302713028130291303013031130321303313034130351303613037130381303913040130411304213043130441304513046130471304813049130501305113052130531305413055130561305713058130591306013061130621306313064130651306613067130681306913070130711307213073130741307513076130771307813079130801308113082130831308413085130861308713088130891309013091130921309313094130951309613097130981309913100131011310213103131041310513106131071310813109131101311113112131131311413115131161311713118131191312013121131221312313124131251312613127131281312913130131311313213133131341313513136131371313813139131401314113142131431314413145131461314713148131491315013151131521315313154131551315613157131581315913160131611316213163131641316513166131671316813169131701317113172131731317413175131761317713178131791318013181131821318313184131851318613187131881318913190131911319213193131941319513196131971319813199132001320113202132031320413205132061320713208132091321013211132121321313214132151321613217132181321913220132211322213223132241322513226132271322813229132301323113232132331323413235132361323713238132391324013241132421324313244132451324613247132481324913250132511325213253132541325513256132571325813259132601326113262132631326413265132661326713268132691327013271132721327313274132751327613277132781327913280132811328213283132841328513286132871328813289132901329113292132931329413295132961329713298132991330013301133021330313304133051330613307133081330913310133111331213313133141331513316133171331813319133201332113322133231332413325133261332713328133291333013331133321333313334133351333613337133381333913340133411334213343133441334513346133471334813349133501335113352133531335413355133561335713358133591336013361133621336313364133651336613367133681336913370133711337213373133741337513376133771337813379133801338113382133831338413385133861338713388133891339013391133921339313394133951339613397133981339913400134011340213403134041340513406134071340813409134101341113412134131341413415134161341713418134191342013421134221342313424134251342613427134281342913430134311343213433134341343513436134371343813439134401344113442134431344413445134461344713448134491345013451134521345313454134551345613457134581345913460134611346213463134641346513466134671346813469134701347113472134731347413475134761347713478134791348013481134821348313484134851348613487134881348913490134911349213493134941349513496134971349813499135001350113502135031350413505135061350713508135091351013511135121351313514135151351613517135181351913520135211352213523135241352513526135271352813529135301353113532135331353413535135361353713538135391354013541135421354313544135451354613547135481354913550135511355213553135541355513556135571355813559135601356113562135631356413565135661356713568135691357013571135721357313574135751357613577135781357913580135811358213583135841358513586135871358813589135901359113592135931359413595135961359713598135991360013601136021360313604136051360613607136081360913610136111361213613136141361513616136171361813619136201362113622136231362413625136261362713628136291363013631136321363313634136351363613637136381363913640136411364213643136441364513646136471364813649136501365113652136531365413655136561365713658136591366013661136621366313664136651366613667136681366913670136711367213673136741367513676136771367813679136801368113682136831368413685136861368713688136891369013691136921369313694136951369613697136981369913700137011370213703137041370513706137071370813709137101371113712137131371413715137161371713718137191372013721137221372313724137251372613727137281372913730137311373213733137341373513736137371373813739137401374113742137431374413745137461374713748137491375013751137521375313754137551375613757137581375913760137611376213763137641376513766137671376813769137701377113772137731377413775137761377713778137791378013781137821378313784137851378613787137881378913790137911379213793137941379513796137971379813799138001380113802138031380413805138061380713808138091381013811138121381313814138151381613817138181381913820138211382213823138241382513826138271382813829138301383113832138331383413835138361383713838138391384013841138421384313844138451384613847138481384913850138511385213853138541385513856138571385813859138601386113862138631386413865138661386713868138691387013871138721387313874138751387613877138781387913880138811388213883138841388513886138871388813889138901389113892138931389413895138961389713898138991390013901139021390313904139051390613907139081390913910139111391213913139141391513916139171391813919139201392113922139231392413925139261392713928139291393013931139321393313934139351393613937139381393913940139411394213943139441394513946139471394813949139501395113952139531395413955139561395713958139591396013961139621396313964139651396613967139681396913970139711397213973139741397513976139771397813979139801398113982139831398413985139861398713988139891399013991139921399313994139951399613997139981399914000140011400214003140041400514006140071400814009140101401114012140131401414015140161401714018140191402014021140221402314024140251402614027140281402914030140311403214033140341403514036140371403814039140401404114042140431404414045140461404714048140491405014051140521405314054140551405614057140581405914060140611406214063140641406514066140671406814069140701407114072140731407414075140761407714078140791408014081140821408314084140851408614087140881408914090140911409214093140941409514096140971409814099141001410114102141031410414105141061410714108141091411014111141121411314114141151411614117141181411914120141211412214123141241412514126141271412814129141301413114132141331413414135141361413714138141391414014141141421414314144141451414614147141481414914150141511415214153141541415514156141571415814159141601416114162141631416414165141661416714168141691417014171141721417314174141751417614177141781417914180141811418214183141841418514186141871418814189141901419114192141931419414195141961419714198141991420014201142021420314204142051420614207142081420914210142111421214213142141421514216142171421814219142201422114222142231422414225142261422714228142291423014231142321423314234142351423614237142381423914240142411424214243142441424514246142471424814249142501425114252142531425414255142561425714258142591426014261142621426314264142651426614267142681426914270142711427214273142741427514276142771427814279142801428114282142831428414285142861428714288142891429014291142921429314294142951429614297142981429914300143011430214303143041430514306143071430814309143101431114312143131431414315143161431714318143191432014321143221432314324143251432614327143281432914330143311433214333143341433514336143371433814339143401434114342143431434414345143461434714348143491435014351143521435314354143551435614357143581435914360143611436214363143641436514366143671436814369143701437114372143731437414375143761437714378143791438014381143821438314384143851438614387143881438914390143911439214393143941439514396143971439814399144001440114402144031440414405144061440714408144091441014411144121441314414144151441614417144181441914420144211442214423144241442514426144271442814429144301443114432144331443414435144361443714438144391444014441144421444314444144451444614447144481444914450144511445214453144541445514456144571445814459144601446114462144631446414465144661446714468144691447014471144721447314474144751447614477144781447914480144811448214483144841448514486144871448814489144901449114492144931449414495144961449714498144991450014501145021450314504145051450614507145081450914510145111451214513145141451514516145171451814519145201452114522145231452414525145261452714528145291453014531145321453314534145351453614537145381453914540145411454214543145441454514546145471454814549145501455114552145531455414555145561455714558145591456014561145621456314564145651456614567145681456914570145711457214573145741457514576145771457814579145801458114582145831458414585145861458714588145891459014591145921459314594145951459614597145981459914600146011460214603146041460514606146071460814609146101461114612146131461414615146161461714618146191462014621146221462314624146251462614627146281462914630146311463214633146341463514636146371463814639146401464114642146431464414645146461464714648146491465014651146521465314654146551465614657146581465914660146611466214663146641466514666146671466814669146701467114672146731467414675146761467714678146791468014681146821468314684146851468614687146881468914690146911469214693146941469514696146971469814699147001470114702147031470414705147061470714708147091471014711147121471314714147151471614717147181471914720147211472214723147241472514726147271472814729147301473114732147331473414735147361473714738147391474014741147421474314744147451474614747147481474914750147511475214753147541475514756147571475814759147601476114762147631476414765147661476714768147691477014771147721477314774147751477614777147781477914780147811478214783147841478514786147871478814789147901479114792147931479414795147961479714798147991480014801148021480314804148051480614807148081480914810148111481214813148141481514816148171481814819148201482114822148231482414825148261482714828148291483014831148321483314834148351483614837148381483914840148411484214843148441484514846148471484814849148501485114852148531485414855148561485714858148591486014861148621486314864148651486614867148681486914870148711487214873148741487514876148771487814879148801488114882148831488414885148861488714888148891489014891148921489314894148951489614897148981489914900149011490214903149041490514906149071490814909149101491114912149131491414915149161491714918149191492014921149221492314924149251492614927149281492914930149311493214933149341493514936149371493814939149401494114942149431494414945149461494714948149491495014951149521495314954149551495614957149581495914960149611496214963149641496514966149671496814969149701497114972149731497414975149761497714978149791498014981149821498314984149851498614987149881498914990149911499214993149941499514996149971499814999150001500115002150031500415005150061500715008150091501015011150121501315014150151501615017150181501915020150211502215023150241502515026150271502815029150301503115032150331503415035150361503715038150391504015041150421504315044150451504615047150481504915050150511505215053150541505515056150571505815059150601506115062150631506415065150661506715068150691507015071150721507315074150751507615077150781507915080150811508215083150841508515086150871508815089150901509115092150931509415095150961509715098150991510015101151021510315104151051510615107151081510915110151111511215113151141511515116151171511815119151201512115122151231512415125151261512715128151291513015131151321513315134151351513615137151381513915140151411514215143151441514515146151471514815149151501515115152151531515415155151561515715158151591516015161151621516315164151651516615167151681516915170151711517215173151741517515176151771517815179151801518115182151831518415185151861518715188151891519015191151921519315194151951519615197151981519915200152011520215203152041520515206152071520815209152101521115212152131521415215152161521715218152191522015221152221522315224152251522615227152281522915230152311523215233152341523515236152371523815239152401524115242152431524415245152461524715248152491525015251152521525315254152551525615257152581525915260152611526215263152641526515266152671526815269152701527115272152731527415275152761527715278152791528015281152821528315284152851528615287152881528915290152911529215293152941529515296152971529815299153001530115302153031530415305153061530715308153091531015311153121531315314153151531615317153181531915320153211532215323153241532515326153271532815329153301533115332153331533415335153361533715338153391534015341153421534315344153451534615347153481534915350153511535215353153541535515356153571535815359153601536115362153631536415365153661536715368153691537015371153721537315374153751537615377153781537915380153811538215383153841538515386153871538815389153901539115392153931539415395153961539715398153991540015401154021540315404154051540615407154081540915410154111541215413154141541515416154171541815419154201542115422154231542415425154261542715428154291543015431154321543315434154351543615437154381543915440154411544215443154441544515446154471544815449154501545115452154531545415455154561545715458154591546015461154621546315464154651546615467154681546915470154711547215473154741547515476154771547815479154801548115482154831548415485154861548715488154891549015491154921549315494154951549615497154981549915500155011550215503155041550515506155071550815509155101551115512155131551415515155161551715518155191552015521155221552315524155251552615527155281552915530155311553215533155341553515536155371553815539155401554115542155431554415545155461554715548155491555015551155521555315554155551555615557155581555915560155611556215563155641556515566155671556815569155701557115572155731557415575155761557715578155791558015581155821558315584155851558615587155881558915590155911559215593155941559515596155971559815599156001560115602156031560415605156061560715608156091561015611156121561315614156151561615617156181561915620156211562215623156241562515626156271562815629156301563115632156331563415635156361563715638156391564015641156421564315644156451564615647156481564915650156511565215653156541565515656156571565815659156601566115662156631566415665156661566715668156691567015671156721567315674156751567615677156781567915680156811568215683156841568515686156871568815689156901569115692156931569415695156961569715698156991570015701157021570315704157051570615707157081570915710157111571215713157141571515716157171571815719157201572115722157231572415725157261572715728157291573015731157321573315734157351573615737157381573915740157411574215743157441574515746157471574815749157501575115752157531575415755157561575715758157591576015761157621576315764157651576615767157681576915770157711577215773157741577515776157771577815779157801578115782157831578415785157861578715788157891579015791157921579315794157951579615797157981579915800158011580215803158041580515806158071580815809158101581115812158131581415815158161581715818158191582015821158221582315824158251582615827158281582915830158311583215833158341583515836158371583815839158401584115842158431584415845158461584715848158491585015851158521585315854158551585615857158581585915860158611586215863158641586515866158671586815869158701587115872158731587415875158761587715878158791588015881158821588315884158851588615887158881588915890158911589215893158941589515896158971589815899159001590115902159031590415905159061590715908159091591015911159121591315914159151591615917159181591915920159211592215923159241592515926159271592815929159301593115932159331593415935159361593715938159391594015941159421594315944159451594615947159481594915950159511595215953159541595515956159571595815959159601596115962159631596415965159661596715968159691597015971159721597315974159751597615977159781597915980159811598215983159841598515986159871598815989159901599115992159931599415995159961599715998159991600016001160021600316004160051600616007160081600916010160111601216013160141601516016160171601816019160201602116022160231602416025160261602716028160291603016031160321603316034160351603616037160381603916040160411604216043160441604516046160471604816049160501605116052160531605416055160561605716058160591606016061160621606316064160651606616067160681606916070160711607216073160741607516076160771607816079160801608116082160831608416085160861608716088160891609016091160921609316094160951609616097160981609916100161011610216103161041610516106161071610816109161101611116112161131611416115161161611716118161191612016121161221612316124161251612616127161281612916130161311613216133161341613516136161371613816139161401614116142161431614416145161461614716148161491615016151161521615316154161551615616157161581615916160161611616216163161641616516166161671616816169161701617116172161731617416175161761617716178161791618016181161821618316184161851618616187161881618916190161911619216193161941619516196161971619816199162001620116202162031620416205162061620716208162091621016211162121621316214162151621616217162181621916220162211622216223162241622516226162271622816229162301623116232162331623416235162361623716238162391624016241162421624316244162451624616247162481624916250162511625216253162541625516256162571625816259162601626116262162631626416265162661626716268162691627016271162721627316274162751627616277162781627916280162811628216283162841628516286162871628816289162901629116292162931629416295162961629716298162991630016301163021630316304163051630616307163081630916310163111631216313163141631516316163171631816319163201632116322163231632416325163261632716328163291633016331163321633316334163351633616337163381633916340163411634216343163441634516346163471634816349163501635116352163531635416355163561635716358163591636016361163621636316364163651636616367163681636916370163711637216373163741637516376163771637816379163801638116382163831638416385163861638716388163891639016391163921639316394163951639616397163981639916400164011640216403164041640516406164071640816409164101641116412164131641416415164161641716418164191642016421164221642316424164251642616427164281642916430164311643216433164341643516436164371643816439164401644116442164431644416445164461644716448164491645016451164521645316454164551645616457164581645916460164611646216463164641646516466164671646816469164701647116472164731647416475164761647716478164791648016481164821648316484164851648616487164881648916490164911649216493164941649516496164971649816499165001650116502165031650416505165061650716508165091651016511165121651316514165151651616517165181651916520165211652216523165241652516526165271652816529165301653116532165331653416535165361653716538165391654016541165421654316544165451654616547165481654916550165511655216553165541655516556165571655816559165601656116562165631656416565165661656716568165691657016571165721657316574165751657616577165781657916580165811658216583165841658516586165871658816589165901659116592165931659416595165961659716598165991660016601166021660316604166051660616607166081660916610166111661216613166141661516616166171661816619166201662116622166231662416625166261662716628166291663016631166321663316634166351663616637166381663916640166411664216643166441664516646166471664816649166501665116652166531665416655166561665716658166591666016661166621666316664166651666616667166681666916670166711667216673166741667516676166771667816679166801668116682166831668416685166861668716688166891669016691166921669316694166951669616697166981669916700167011670216703167041670516706167071670816709167101671116712167131671416715167161671716718167191672016721167221672316724167251672616727167281672916730167311673216733167341673516736167371673816739167401674116742167431674416745167461674716748167491675016751167521675316754167551675616757167581675916760167611676216763167641676516766167671676816769167701677116772167731677416775167761677716778167791678016781167821678316784167851678616787167881678916790167911679216793167941679516796167971679816799168001680116802168031680416805168061680716808168091681016811168121681316814168151681616817168181681916820168211682216823168241682516826168271682816829168301683116832168331683416835168361683716838168391684016841168421684316844168451684616847168481684916850168511685216853168541685516856168571685816859168601686116862168631686416865168661686716868168691687016871168721687316874168751687616877168781687916880168811688216883168841688516886168871688816889168901689116892168931689416895168961689716898168991690016901169021690316904169051690616907169081690916910169111691216913169141691516916169171691816919169201692116922169231692416925169261692716928169291693016931169321693316934169351693616937169381693916940169411694216943169441694516946169471694816949169501695116952169531695416955169561695716958169591696016961169621696316964169651696616967169681696916970169711697216973169741697516976169771697816979169801698116982169831698416985169861698716988169891699016991169921699316994169951699616997169981699917000170011700217003170041700517006170071700817009170101701117012170131701417015170161701717018170191702017021170221702317024170251702617027170281702917030170311703217033170341703517036170371703817039170401704117042170431704417045170461704717048170491705017051170521705317054170551705617057170581705917060170611706217063170641706517066170671706817069170701707117072170731707417075170761707717078170791708017081170821708317084170851708617087170881708917090170911709217093170941709517096170971709817099171001710117102171031710417105171061710717108171091711017111171121711317114171151711617117171181711917120171211712217123171241712517126171271712817129171301713117132171331713417135171361713717138171391714017141171421714317144171451714617147171481714917150171511715217153171541715517156171571715817159171601716117162171631716417165171661716717168171691717017171171721717317174171751717617177171781717917180171811718217183171841718517186171871718817189171901719117192171931719417195171961719717198171991720017201172021720317204172051720617207172081720917210172111721217213172141721517216172171721817219172201722117222172231722417225172261722717228172291723017231172321723317234172351723617237172381723917240172411724217243172441724517246172471724817249172501725117252172531725417255172561725717258172591726017261172621726317264172651726617267172681726917270172711727217273172741727517276172771727817279172801728117282172831728417285172861728717288172891729017291172921729317294172951729617297172981729917300173011730217303173041730517306173071730817309173101731117312173131731417315173161731717318173191732017321173221732317324173251732617327173281732917330173311733217333173341733517336173371733817339173401734117342173431734417345173461734717348173491735017351173521735317354173551735617357173581735917360173611736217363173641736517366173671736817369173701737117372173731737417375173761737717378173791738017381173821738317384173851738617387173881738917390173911739217393173941739517396173971739817399174001740117402174031740417405174061740717408174091741017411174121741317414174151741617417174181741917420174211742217423174241742517426174271742817429174301743117432174331743417435174361743717438174391744017441174421744317444174451744617447174481744917450174511745217453174541745517456174571745817459174601746117462174631746417465174661746717468174691747017471174721747317474174751747617477174781747917480174811748217483174841748517486174871748817489174901749117492174931749417495174961749717498174991750017501175021750317504175051750617507175081750917510175111751217513175141751517516175171751817519175201752117522175231752417525175261752717528175291753017531175321753317534175351753617537175381753917540175411754217543175441754517546175471754817549175501755117552175531755417555175561755717558175591756017561175621756317564175651756617567175681756917570175711757217573175741757517576175771757817579175801758117582175831758417585175861758717588175891759017591175921759317594175951759617597175981759917600176011760217603176041760517606176071760817609176101761117612176131761417615176161761717618176191762017621176221762317624176251762617627176281762917630176311763217633176341763517636176371763817639176401764117642176431764417645176461764717648176491765017651176521765317654176551765617657176581765917660176611766217663176641766517666176671766817669176701767117672176731767417675176761767717678176791768017681176821768317684176851768617687176881768917690176911769217693176941769517696176971769817699177001770117702177031770417705177061770717708177091771017711177121771317714177151771617717177181771917720177211772217723177241772517726177271772817729177301773117732177331773417735177361773717738177391774017741177421774317744177451774617747177481774917750177511775217753177541775517756177571775817759177601776117762177631776417765177661776717768177691777017771177721777317774177751777617777177781777917780177811778217783177841778517786177871778817789177901779117792177931779417795177961779717798177991780017801178021780317804178051780617807178081780917810178111781217813178141781517816178171781817819178201782117822178231782417825178261782717828178291783017831178321783317834178351783617837178381783917840178411784217843178441784517846178471784817849178501785117852178531785417855178561785717858178591786017861178621786317864178651786617867178681786917870178711787217873178741787517876178771787817879178801788117882178831788417885178861788717888178891789017891178921789317894178951789617897178981789917900179011790217903179041790517906179071790817909179101791117912179131791417915179161791717918179191792017921179221792317924179251792617927179281792917930179311793217933179341793517936179371793817939179401794117942179431794417945179461794717948179491795017951179521795317954179551795617957179581795917960179611796217963179641796517966179671796817969179701797117972179731797417975179761797717978179791798017981179821798317984179851798617987179881798917990179911799217993179941799517996179971799817999180001800118002180031800418005180061800718008180091801018011180121801318014180151801618017180181801918020180211802218023180241802518026180271802818029180301803118032180331803418035180361803718038180391804018041180421804318044180451804618047180481804918050180511805218053180541805518056180571805818059180601806118062180631806418065180661806718068180691807018071180721807318074180751807618077180781807918080180811808218083180841808518086180871808818089180901809118092180931809418095180961809718098180991810018101181021810318104181051810618107181081810918110181111811218113181141811518116181171811818119181201812118122181231812418125181261812718128181291813018131181321813318134181351813618137181381813918140181411814218143181441814518146181471814818149181501815118152181531815418155181561815718158181591816018161181621816318164181651816618167181681816918170181711817218173181741817518176181771817818179181801818118182181831818418185181861818718188181891819018191181921819318194181951819618197181981819918200182011820218203182041820518206182071820818209182101821118212182131821418215182161821718218182191822018221182221822318224182251822618227182281822918230182311823218233182341823518236182371823818239182401824118242182431824418245182461824718248182491825018251182521825318254182551825618257182581825918260182611826218263182641826518266182671826818269182701827118272182731827418275182761827718278182791828018281182821828318284182851828618287182881828918290182911829218293182941829518296182971829818299183001830118302183031830418305183061830718308183091831018311183121831318314183151831618317183181831918320183211832218323183241832518326183271832818329183301833118332183331833418335183361833718338183391834018341183421834318344183451834618347183481834918350183511835218353183541835518356183571835818359183601836118362183631836418365183661836718368183691837018371183721837318374183751837618377183781837918380183811838218383183841838518386183871838818389183901839118392183931839418395183961839718398183991840018401184021840318404184051840618407184081840918410184111841218413184141841518416184171841818419184201842118422184231842418425184261842718428184291843018431184321843318434184351843618437184381843918440184411844218443184441844518446184471844818449184501845118452184531845418455184561845718458184591846018461184621846318464184651846618467184681846918470184711847218473184741847518476184771847818479184801848118482184831848418485184861848718488184891849018491184921849318494184951849618497184981849918500185011850218503185041850518506185071850818509185101851118512185131851418515185161851718518185191852018521185221852318524185251852618527185281852918530185311853218533185341853518536185371853818539185401854118542185431854418545185461854718548185491855018551185521855318554185551855618557185581855918560185611856218563185641856518566185671856818569185701857118572185731857418575185761857718578185791858018581185821858318584185851858618587185881858918590185911859218593185941859518596185971859818599186001860118602186031860418605186061860718608186091861018611186121861318614186151861618617186181861918620186211862218623186241862518626186271862818629186301863118632186331863418635186361863718638186391864018641186421864318644186451864618647186481864918650186511865218653186541865518656186571865818659186601866118662186631866418665186661866718668186691867018671186721867318674186751867618677186781867918680186811868218683186841868518686186871868818689186901869118692186931869418695186961869718698186991870018701187021870318704187051870618707187081870918710187111871218713187141871518716187171871818719187201872118722187231872418725187261872718728187291873018731187321873318734187351873618737187381873918740187411874218743187441874518746187471874818749187501875118752187531875418755187561875718758187591876018761187621876318764187651876618767187681876918770187711877218773187741877518776187771877818779187801878118782187831878418785187861878718788187891879018791187921879318794187951879618797187981879918800188011880218803188041880518806188071880818809188101881118812188131881418815188161881718818188191882018821188221882318824188251882618827188281882918830188311883218833188341883518836188371883818839188401884118842188431884418845188461884718848188491885018851188521885318854188551885618857188581885918860188611886218863188641886518866188671886818869188701887118872188731887418875188761887718878188791888018881188821888318884188851888618887188881888918890188911889218893188941889518896188971889818899189001890118902189031890418905189061890718908189091891018911189121891318914189151891618917189181891918920189211892218923189241892518926189271892818929189301893118932189331893418935189361893718938189391894018941189421894318944189451894618947189481894918950189511895218953189541895518956189571895818959189601896118962189631896418965189661896718968189691897018971189721897318974189751897618977189781897918980189811898218983189841898518986189871898818989189901899118992189931899418995189961899718998189991900019001190021900319004190051900619007190081900919010190111901219013190141901519016190171901819019190201902119022190231902419025190261902719028190291903019031190321903319034190351903619037190381903919040190411904219043190441904519046190471904819049190501905119052190531905419055190561905719058190591906019061190621906319064190651906619067190681906919070190711907219073190741907519076190771907819079190801908119082190831908419085190861908719088190891909019091190921909319094190951909619097190981909919100191011910219103191041910519106191071910819109191101911119112191131911419115191161911719118191191912019121191221912319124191251912619127191281912919130191311913219133191341913519136191371913819139191401914119142191431914419145191461914719148191491915019151191521915319154191551915619157191581915919160191611916219163191641916519166191671916819169191701917119172191731917419175191761917719178191791918019181191821918319184191851918619187191881918919190191911919219193191941919519196191971919819199192001920119202192031920419205192061920719208192091921019211192121921319214192151921619217192181921919220192211922219223192241922519226192271922819229192301923119232192331923419235192361923719238192391924019241192421924319244192451924619247192481924919250192511925219253192541925519256192571925819259192601926119262192631926419265192661926719268192691927019271192721927319274192751927619277192781927919280192811928219283192841928519286192871928819289192901929119292192931929419295192961929719298192991930019301193021930319304193051930619307193081930919310193111931219313193141931519316193171931819319193201932119322193231932419325193261932719328193291933019331193321933319334193351933619337193381933919340193411934219343193441934519346193471934819349193501935119352193531935419355193561935719358193591936019361193621936319364193651936619367193681936919370193711937219373193741937519376193771937819379193801938119382193831938419385193861938719388193891939019391193921939319394193951939619397193981939919400194011940219403194041940519406194071940819409194101941119412194131941419415194161941719418194191942019421194221942319424194251942619427194281942919430194311943219433194341943519436194371943819439194401944119442194431944419445194461944719448194491945019451194521945319454194551945619457194581945919460194611946219463194641946519466194671946819469194701947119472194731947419475194761947719478194791948019481194821948319484194851948619487194881948919490194911949219493194941949519496194971949819499195001950119502195031950419505195061950719508195091951019511195121951319514195151951619517195181951919520195211952219523195241952519526195271952819529195301953119532195331953419535195361953719538195391954019541195421954319544195451954619547195481954919550195511955219553195541955519556195571955819559195601956119562195631956419565195661956719568195691957019571195721957319574195751957619577195781957919580195811958219583195841958519586195871958819589195901959119592195931959419595195961959719598195991960019601196021960319604196051960619607196081960919610196111961219613196141961519616196171961819619196201962119622196231962419625196261962719628196291963019631196321963319634196351963619637196381963919640196411964219643196441964519646196471964819649196501965119652196531965419655196561965719658196591966019661196621966319664196651966619667196681966919670196711967219673196741967519676196771967819679196801968119682196831968419685196861968719688196891969019691196921969319694196951969619697196981969919700197011970219703197041970519706197071970819709197101971119712197131971419715197161971719718197191972019721197221972319724197251972619727197281972919730197311973219733197341973519736197371973819739197401974119742197431974419745197461974719748197491975019751197521975319754197551975619757197581975919760197611976219763197641976519766197671976819769197701977119772197731977419775197761977719778197791978019781197821978319784197851978619787197881978919790197911979219793197941979519796197971979819799198001980119802198031980419805198061980719808198091981019811198121981319814198151981619817198181981919820198211982219823198241982519826198271982819829198301983119832198331983419835198361983719838198391984019841198421984319844198451984619847198481984919850198511985219853198541985519856198571985819859198601986119862198631986419865198661986719868198691987019871198721987319874198751987619877198781987919880198811988219883198841988519886198871988819889198901989119892198931989419895198961989719898198991990019901199021990319904199051990619907199081990919910199111991219913199141991519916199171991819919199201992119922199231992419925199261992719928199291993019931199321993319934199351993619937199381993919940199411994219943199441994519946199471994819949199501995119952199531995419955199561995719958199591996019961199621996319964199651996619967199681996919970199711997219973199741997519976199771997819979199801998119982199831998419985199861998719988199891999019991199921999319994199951999619997199981999920000200012000220003200042000520006200072000820009200102001120012200132001420015200162001720018200192002020021200222002320024200252002620027200282002920030200312003220033200342003520036200372003820039200402004120042200432004420045200462004720048200492005020051200522005320054200552005620057200582005920060200612006220063200642006520066200672006820069200702007120072200732007420075200762007720078200792008020081200822008320084200852008620087200882008920090200912009220093200942009520096200972009820099201002010120102201032010420105201062010720108201092011020111201122011320114201152011620117201182011920120201212012220123201242012520126201272012820129201302013120132201332013420135201362013720138201392014020141201422014320144201452014620147201482014920150201512015220153201542015520156201572015820159201602016120162201632016420165201662016720168201692017020171201722017320174201752017620177201782017920180201812018220183201842018520186201872018820189201902019120192201932019420195201962019720198201992020020201202022020320204202052020620207202082020920210202112021220213202142021520216202172021820219202202022120222202232022420225202262022720228202292023020231202322023320234202352023620237202382023920240202412024220243202442024520246202472024820249202502025120252202532025420255202562025720258202592026020261202622026320264202652026620267202682026920270202712027220273202742027520276202772027820279202802028120282202832028420285202862028720288202892029020291202922029320294202952029620297202982029920300203012030220303203042030520306203072030820309203102031120312203132031420315203162031720318203192032020321203222032320324203252032620327203282032920330203312033220333203342033520336203372033820339203402034120342203432034420345203462034720348203492035020351203522035320354203552035620357203582035920360203612036220363203642036520366203672036820369203702037120372203732037420375203762037720378203792038020381203822038320384203852038620387203882038920390203912039220393203942039520396203972039820399204002040120402204032040420405204062040720408204092041020411204122041320414204152041620417204182041920420204212042220423204242042520426204272042820429204302043120432204332043420435204362043720438204392044020441204422044320444204452044620447204482044920450204512045220453204542045520456204572045820459204602046120462204632046420465204662046720468204692047020471204722047320474204752047620477204782047920480204812048220483204842048520486204872048820489204902049120492204932049420495204962049720498204992050020501205022050320504205052050620507205082050920510205112051220513205142051520516205172051820519205202052120522205232052420525205262052720528205292053020531205322053320534205352053620537205382053920540205412054220543205442054520546205472054820549205502055120552205532055420555205562055720558205592056020561205622056320564205652056620567205682056920570205712057220573205742057520576205772057820579205802058120582205832058420585205862058720588205892059020591205922059320594205952059620597205982059920600206012060220603206042060520606206072060820609206102061120612206132061420615206162061720618206192062020621206222062320624206252062620627206282062920630206312063220633206342063520636206372063820639206402064120642206432064420645206462064720648206492065020651206522065320654206552065620657206582065920660206612066220663206642066520666206672066820669206702067120672206732067420675206762067720678206792068020681206822068320684206852068620687206882068920690206912069220693206942069520696206972069820699207002070120702207032070420705207062070720708207092071020711207122071320714207152071620717207182071920720207212072220723207242072520726207272072820729207302073120732207332073420735207362073720738207392074020741207422074320744207452074620747207482074920750207512075220753207542075520756207572075820759207602076120762207632076420765207662076720768207692077020771207722077320774207752077620777207782077920780207812078220783207842078520786207872078820789207902079120792207932079420795207962079720798207992080020801208022080320804208052080620807208082080920810208112081220813208142081520816208172081820819208202082120822208232082420825208262082720828208292083020831208322083320834208352083620837208382083920840208412084220843208442084520846208472084820849208502085120852208532085420855208562085720858208592086020861208622086320864208652086620867208682086920870208712087220873208742087520876208772087820879208802088120882208832088420885208862088720888208892089020891208922089320894208952089620897208982089920900209012090220903209042090520906209072090820909209102091120912209132091420915209162091720918209192092020921209222092320924209252092620927209282092920930209312093220933209342093520936209372093820939209402094120942209432094420945209462094720948209492095020951209522095320954209552095620957209582095920960209612096220963209642096520966209672096820969209702097120972209732097420975209762097720978209792098020981209822098320984209852098620987209882098920990209912099220993209942099520996209972099820999210002100121002210032100421005210062100721008210092101021011210122101321014210152101621017210182101921020210212102221023210242102521026210272102821029210302103121032210332103421035210362103721038210392104021041210422104321044210452104621047210482104921050210512105221053210542105521056210572105821059210602106121062210632106421065210662106721068210692107021071210722107321074210752107621077210782107921080210812108221083210842108521086210872108821089210902109121092210932109421095210962109721098210992110021101211022110321104211052110621107211082110921110211112111221113211142111521116211172111821119211202112121122211232112421125211262112721128211292113021131211322113321134211352113621137211382113921140211412114221143211442114521146211472114821149211502115121152211532115421155211562115721158211592116021161211622116321164211652116621167211682116921170211712117221173211742117521176211772117821179211802118121182211832118421185211862118721188211892119021191211922119321194211952119621197211982119921200212012120221203212042120521206212072120821209212102121121212212132121421215212162121721218212192122021221212222122321224212252122621227212282122921230212312123221233212342123521236212372123821239212402124121242212432124421245212462124721248212492125021251212522125321254212552125621257212582125921260212612126221263212642126521266212672126821269212702127121272212732127421275212762127721278212792128021281212822128321284212852128621287212882128921290212912129221293212942129521296212972129821299213002130121302213032130421305213062130721308213092131021311213122131321314213152131621317213182131921320213212132221323213242132521326213272132821329213302133121332213332133421335213362133721338213392134021341213422134321344213452134621347213482134921350213512135221353213542135521356213572135821359213602136121362213632136421365213662136721368213692137021371213722137321374213752137621377213782137921380213812138221383213842138521386213872138821389213902139121392213932139421395213962139721398213992140021401214022140321404214052140621407214082140921410214112141221413214142141521416214172141821419214202142121422214232142421425214262142721428214292143021431214322143321434214352143621437214382143921440214412144221443214442144521446214472144821449214502145121452214532145421455214562145721458214592146021461214622146321464214652146621467214682146921470214712147221473214742147521476214772147821479214802148121482214832148421485214862148721488214892149021491214922149321494214952149621497214982149921500215012150221503215042150521506215072150821509215102151121512215132151421515215162151721518215192152021521215222152321524215252152621527215282152921530215312153221533215342153521536215372153821539215402154121542215432154421545215462154721548215492155021551215522155321554215552155621557215582155921560215612156221563215642156521566215672156821569215702157121572215732157421575215762157721578215792158021581215822158321584215852158621587215882158921590215912159221593215942159521596215972159821599216002160121602216032160421605216062160721608216092161021611216122161321614216152161621617216182161921620216212162221623216242162521626216272162821629216302163121632216332163421635216362163721638216392164021641216422164321644216452164621647216482164921650216512165221653216542165521656216572165821659216602166121662216632166421665216662166721668216692167021671216722167321674216752167621677216782167921680216812168221683216842168521686216872168821689216902169121692216932169421695216962169721698216992170021701217022170321704217052170621707217082170921710217112171221713217142171521716217172171821719217202172121722217232172421725217262172721728217292173021731217322173321734217352173621737217382173921740217412174221743217442174521746217472174821749217502175121752217532175421755217562175721758217592176021761217622176321764217652176621767217682176921770217712177221773217742177521776217772177821779217802178121782217832178421785217862178721788217892179021791217922179321794217952179621797217982179921800218012180221803218042180521806218072180821809218102181121812218132181421815218162181721818218192182021821218222182321824218252182621827218282182921830218312183221833218342183521836218372183821839218402184121842218432184421845218462184721848218492185021851218522185321854218552185621857218582185921860218612186221863218642186521866218672186821869218702187121872218732187421875218762187721878218792188021881218822188321884218852188621887218882188921890218912189221893218942189521896218972189821899219002190121902219032190421905219062190721908219092191021911219122191321914219152191621917219182191921920219212192221923219242192521926219272192821929219302193121932219332193421935219362193721938219392194021941219422194321944219452194621947219482194921950219512195221953219542195521956219572195821959219602196121962219632196421965219662196721968219692197021971219722197321974219752197621977219782197921980219812198221983219842198521986219872198821989219902199121992219932199421995219962199721998219992200022001220022200322004220052200622007220082200922010220112201222013220142201522016220172201822019220202202122022220232202422025220262202722028220292203022031220322203322034220352203622037220382203922040220412204222043220442204522046220472204822049220502205122052220532205422055220562205722058220592206022061220622206322064220652206622067220682206922070220712207222073220742207522076220772207822079220802208122082220832208422085220862208722088220892209022091220922209322094220952209622097220982209922100221012210222103221042210522106221072210822109221102211122112221132211422115221162211722118221192212022121221222212322124221252212622127221282212922130221312213222133221342213522136221372213822139221402214122142221432214422145221462214722148221492215022151221522215322154221552215622157221582215922160221612216222163221642216522166221672216822169221702217122172221732217422175221762217722178221792218022181221822218322184221852218622187221882218922190221912219222193221942219522196221972219822199222002220122202222032220422205222062220722208222092221022211222122221322214222152221622217222182221922220222212222222223222242222522226222272222822229222302223122232222332223422235222362223722238222392224022241222422224322244222452224622247222482224922250222512225222253222542225522256222572225822259222602226122262222632226422265222662226722268222692227022271222722227322274222752227622277222782227922280222812228222283222842228522286222872228822289222902229122292222932229422295222962229722298222992230022301223022230322304223052230622307223082230922310223112231222313223142231522316223172231822319223202232122322223232232422325223262232722328223292233022331223322233322334223352233622337223382233922340223412234222343223442234522346223472234822349223502235122352223532235422355223562235722358223592236022361223622236322364223652236622367223682236922370223712237222373223742237522376223772237822379223802238122382223832238422385223862238722388223892239022391223922239322394223952239622397223982239922400224012240222403224042240522406224072240822409224102241122412224132241422415224162241722418224192242022421224222242322424224252242622427224282242922430224312243222433224342243522436224372243822439224402244122442224432244422445224462244722448224492245022451224522245322454224552245622457224582245922460224612246222463224642246522466224672246822469224702247122472224732247422475224762247722478224792248022481224822248322484224852248622487224882248922490224912249222493224942249522496224972249822499225002250122502225032250422505225062250722508225092251022511225122251322514225152251622517225182251922520225212252222523225242252522526225272252822529225302253122532225332253422535225362253722538225392254022541225422254322544225452254622547225482254922550225512255222553225542255522556225572255822559225602256122562225632256422565225662256722568225692257022571225722257322574225752257622577225782257922580225812258222583225842258522586225872258822589225902259122592225932259422595225962259722598225992260022601226022260322604226052260622607226082260922610226112261222613226142261522616226172261822619226202262122622226232262422625226262262722628226292263022631226322263322634226352263622637226382263922640226412264222643226442264522646226472264822649226502265122652226532265422655226562265722658226592266022661226622266322664226652266622667226682266922670226712267222673226742267522676226772267822679226802268122682226832268422685226862268722688226892269022691226922269322694226952269622697226982269922700227012270222703227042270522706227072270822709227102271122712227132271422715227162271722718227192272022721227222272322724227252272622727227282272922730227312273222733227342273522736227372273822739227402274122742227432274422745227462274722748227492275022751227522275322754227552275622757227582275922760227612276222763227642276522766227672276822769227702277122772227732277422775227762277722778227792278022781227822278322784227852278622787227882278922790227912279222793227942279522796227972279822799228002280122802228032280422805228062280722808228092281022811228122281322814228152281622817228182281922820228212282222823228242282522826228272282822829228302283122832228332283422835228362283722838228392284022841228422284322844228452284622847228482284922850228512285222853228542285522856228572285822859228602286122862228632286422865228662286722868228692287022871228722287322874228752287622877228782287922880228812288222883228842288522886228872288822889228902289122892228932289422895228962289722898228992290022901229022290322904229052290622907229082290922910229112291222913229142291522916229172291822919229202292122922229232292422925229262292722928229292293022931229322293322934229352293622937229382293922940229412294222943229442294522946229472294822949229502295122952229532295422955229562295722958229592296022961229622296322964229652296622967229682296922970229712297222973229742297522976229772297822979229802298122982229832298422985229862298722988229892299022991229922299322994229952299622997229982299923000230012300223003230042300523006230072300823009230102301123012230132301423015230162301723018230192302023021230222302323024230252302623027230282302923030230312303223033230342303523036230372303823039230402304123042230432304423045230462304723048230492305023051230522305323054230552305623057230582305923060230612306223063230642306523066230672306823069230702307123072230732307423075230762307723078230792308023081230822308323084230852308623087230882308923090230912309223093230942309523096230972309823099231002310123102231032310423105231062310723108231092311023111231122311323114231152311623117231182311923120231212312223123231242312523126231272312823129231302313123132231332313423135231362313723138231392314023141231422314323144231452314623147231482314923150231512315223153231542315523156231572315823159231602316123162231632316423165231662316723168231692317023171231722317323174231752317623177231782317923180231812318223183231842318523186231872318823189231902319123192231932319423195231962319723198231992320023201232022320323204232052320623207232082320923210232112321223213232142321523216232172321823219232202322123222232232322423225232262322723228232292323023231232322323323234232352323623237232382323923240232412324223243232442324523246232472324823249232502325123252232532325423255232562325723258232592326023261232622326323264232652326623267232682326923270232712327223273232742327523276232772327823279232802328123282232832328423285232862328723288232892329023291232922329323294232952329623297232982329923300233012330223303233042330523306233072330823309233102331123312233132331423315233162331723318233192332023321233222332323324233252332623327233282332923330233312333223333233342333523336233372333823339233402334123342233432334423345233462334723348233492335023351233522335323354233552335623357233582335923360233612336223363233642336523366233672336823369233702337123372233732337423375233762337723378233792338023381233822338323384233852338623387233882338923390233912339223393233942339523396233972339823399234002340123402234032340423405234062340723408234092341023411234122341323414234152341623417234182341923420234212342223423234242342523426234272342823429234302343123432234332343423435234362343723438234392344023441234422344323444234452344623447234482344923450234512345223453234542345523456234572345823459234602346123462234632346423465234662346723468234692347023471234722347323474234752347623477234782347923480234812348223483234842348523486234872348823489234902349123492234932349423495234962349723498234992350023501235022350323504235052350623507235082350923510235112351223513235142351523516235172351823519235202352123522235232352423525235262352723528235292353023531235322353323534235352353623537235382353923540235412354223543235442354523546235472354823549235502355123552235532355423555235562355723558235592356023561235622356323564235652356623567235682356923570235712357223573235742357523576235772357823579235802358123582235832358423585235862358723588235892359023591235922359323594235952359623597235982359923600236012360223603236042360523606236072360823609236102361123612236132361423615236162361723618236192362023621236222362323624236252362623627236282362923630236312363223633236342363523636236372363823639236402364123642236432364423645236462364723648236492365023651236522365323654236552365623657236582365923660236612366223663236642366523666236672366823669236702367123672236732367423675236762367723678236792368023681236822368323684236852368623687236882368923690236912369223693236942369523696236972369823699237002370123702237032370423705237062370723708237092371023711237122371323714237152371623717237182371923720237212372223723237242372523726237272372823729237302373123732237332373423735237362373723738237392374023741237422374323744237452374623747237482374923750237512375223753237542375523756237572375823759237602376123762237632376423765237662376723768237692377023771237722377323774237752377623777237782377923780237812378223783237842378523786237872378823789237902379123792237932379423795237962379723798237992380023801238022380323804238052380623807238082380923810238112381223813238142381523816238172381823819238202382123822238232382423825238262382723828238292383023831238322383323834238352383623837238382383923840238412384223843238442384523846238472384823849238502385123852238532385423855238562385723858238592386023861238622386323864238652386623867238682386923870238712387223873238742387523876238772387823879238802388123882238832388423885238862388723888238892389023891238922389323894238952389623897238982389923900239012390223903239042390523906239072390823909239102391123912239132391423915239162391723918239192392023921239222392323924239252392623927239282392923930239312393223933239342393523936239372393823939239402394123942239432394423945239462394723948239492395023951239522395323954239552395623957239582395923960239612396223963239642396523966239672396823969239702397123972239732397423975239762397723978239792398023981239822398323984239852398623987239882398923990239912399223993239942399523996239972399823999240002400124002240032400424005240062400724008240092401024011240122401324014240152401624017240182401924020240212402224023240242402524026240272402824029240302403124032240332403424035240362403724038240392404024041240422404324044240452404624047240482404924050240512405224053240542405524056240572405824059240602406124062240632406424065240662406724068240692407024071240722407324074240752407624077240782407924080240812408224083240842408524086240872408824089240902409124092240932409424095240962409724098240992410024101241022410324104241052410624107241082410924110241112411224113241142411524116241172411824119241202412124122241232412424125241262412724128241292413024131241322413324134241352413624137241382413924140241412414224143241442414524146241472414824149241502415124152241532415424155241562415724158241592416024161241622416324164241652416624167241682416924170241712417224173241742417524176241772417824179241802418124182241832418424185241862418724188241892419024191241922419324194241952419624197241982419924200242012420224203242042420524206242072420824209242102421124212242132421424215242162421724218242192422024221242222422324224242252422624227242282422924230242312423224233242342423524236242372423824239242402424124242242432424424245242462424724248242492425024251242522425324254242552425624257242582425924260242612426224263242642426524266242672426824269242702427124272242732427424275242762427724278242792428024281242822428324284242852428624287242882428924290242912429224293242942429524296242972429824299243002430124302243032430424305243062430724308243092431024311243122431324314243152431624317243182431924320243212432224323243242432524326243272432824329243302433124332243332433424335243362433724338243392434024341243422434324344243452434624347243482434924350243512435224353243542435524356243572435824359243602436124362243632436424365243662436724368243692437024371243722437324374243752437624377243782437924380243812438224383243842438524386243872438824389243902439124392243932439424395243962439724398243992440024401244022440324404244052440624407244082440924410244112441224413244142441524416244172441824419244202442124422244232442424425244262442724428244292443024431244322443324434244352443624437244382443924440244412444224443244442444524446244472444824449244502445124452244532445424455244562445724458244592446024461244622446324464244652446624467244682446924470244712447224473244742447524476244772447824479244802448124482244832448424485244862448724488244892449024491244922449324494244952449624497244982449924500245012450224503245042450524506245072450824509245102451124512245132451424515245162451724518245192452024521245222452324524245252452624527245282452924530245312453224533245342453524536245372453824539245402454124542245432454424545245462454724548245492455024551245522455324554245552455624557245582455924560245612456224563245642456524566245672456824569245702457124572245732457424575245762457724578245792458024581245822458324584245852458624587245882458924590245912459224593245942459524596245972459824599246002460124602246032460424605246062460724608246092461024611246122461324614246152461624617246182461924620246212462224623246242462524626246272462824629246302463124632246332463424635246362463724638246392464024641246422464324644246452464624647246482464924650246512465224653246542465524656246572465824659246602466124662246632466424665246662466724668246692467024671246722467324674246752467624677246782467924680246812468224683246842468524686246872468824689246902469124692246932469424695246962469724698246992470024701247022470324704247052470624707247082470924710247112471224713247142471524716247172471824719247202472124722247232472424725247262472724728247292473024731247322473324734247352473624737247382473924740247412474224743247442474524746247472474824749247502475124752247532475424755247562475724758247592476024761247622476324764247652476624767247682476924770247712477224773247742477524776247772477824779247802478124782247832478424785247862478724788247892479024791247922479324794247952479624797247982479924800248012480224803248042480524806248072480824809248102481124812248132481424815248162481724818248192482024821248222482324824248252482624827248282482924830248312483224833248342483524836248372483824839248402484124842248432484424845248462484724848248492485024851248522485324854248552485624857248582485924860248612486224863248642486524866248672486824869248702487124872248732487424875248762487724878248792488024881248822488324884248852488624887248882488924890248912489224893248942489524896248972489824899249002490124902249032490424905249062490724908249092491024911249122491324914249152491624917249182491924920249212492224923249242492524926249272492824929249302493124932249332493424935249362493724938249392494024941249422494324944249452494624947249482494924950249512495224953249542495524956249572495824959249602496124962249632496424965249662496724968249692497024971249722497324974249752497624977249782497924980249812498224983249842498524986249872498824989249902499124992249932499424995249962499724998249992500025001250022500325004250052500625007250082500925010250112501225013250142501525016250172501825019250202502125022250232502425025250262502725028250292503025031250322503325034250352503625037250382503925040250412504225043250442504525046250472504825049250502505125052250532505425055250562505725058250592506025061250622506325064250652506625067250682506925070250712507225073250742507525076250772507825079250802508125082250832508425085250862508725088250892509025091250922509325094250952509625097250982509925100251012510225103251042510525106251072510825109251102511125112251132511425115251162511725118251192512025121251222512325124251252512625127251282512925130251312513225133251342513525136251372513825139251402514125142251432514425145251462514725148251492515025151251522515325154251552515625157251582515925160251612516225163251642516525166251672516825169251702517125172251732517425175251762517725178251792518025181251822518325184251852518625187251882518925190251912519225193251942519525196251972519825199252002520125202252032520425205252062520725208252092521025211252122521325214252152521625217252182521925220252212522225223252242522525226252272522825229252302523125232252332523425235252362523725238252392524025241252422524325244252452524625247252482524925250252512525225253252542525525256252572525825259252602526125262252632526425265252662526725268252692527025271252722527325274252752527625277252782527925280252812528225283252842528525286252872528825289252902529125292252932529425295252962529725298252992530025301253022530325304253052530625307253082530925310253112531225313253142531525316253172531825319253202532125322253232532425325253262532725328253292533025331253322533325334253352533625337253382533925340253412534225343253442534525346253472534825349253502535125352253532535425355253562535725358253592536025361253622536325364253652536625367253682536925370253712537225373253742537525376253772537825379253802538125382253832538425385253862538725388253892539025391253922539325394253952539625397253982539925400254012540225403254042540525406254072540825409254102541125412254132541425415254162541725418254192542025421254222542325424254252542625427254282542925430254312543225433254342543525436254372543825439254402544125442254432544425445254462544725448254492545025451254522545325454254552545625457254582545925460254612546225463254642546525466254672546825469254702547125472254732547425475254762547725478254792548025481254822548325484254852548625487254882548925490254912549225493254942549525496254972549825499255002550125502255032550425505255062550725508255092551025511255122551325514255152551625517255182551925520255212552225523255242552525526255272552825529255302553125532255332553425535255362553725538255392554025541255422554325544255452554625547255482554925550255512555225553255542555525556255572555825559255602556125562255632556425565255662556725568255692557025571255722557325574255752557625577255782557925580255812558225583255842558525586255872558825589255902559125592255932559425595255962559725598255992560025601256022560325604256052560625607256082560925610256112561225613256142561525616256172561825619256202562125622256232562425625256262562725628256292563025631256322563325634256352563625637256382563925640256412564225643256442564525646256472564825649256502565125652256532565425655256562565725658256592566025661256622566325664256652566625667256682566925670256712567225673256742567525676256772567825679256802568125682256832568425685256862568725688256892569025691256922569325694256952569625697256982569925700257012570225703257042570525706257072570825709257102571125712257132571425715257162571725718257192572025721257222572325724257252572625727257282572925730257312573225733257342573525736257372573825739257402574125742257432574425745257462574725748257492575025751257522575325754257552575625757257582575925760257612576225763257642576525766257672576825769257702577125772257732577425775257762577725778257792578025781257822578325784257852578625787257882578925790257912579225793257942579525796257972579825799258002580125802258032580425805258062580725808258092581025811258122581325814258152581625817258182581925820258212582225823258242582525826258272582825829258302583125832258332583425835258362583725838258392584025841258422584325844258452584625847258482584925850258512585225853258542585525856258572585825859258602586125862258632586425865258662586725868258692587025871258722587325874258752587625877258782587925880258812588225883258842588525886258872588825889258902589125892258932589425895258962589725898258992590025901259022590325904259052590625907259082590925910259112591225913259142591525916259172591825919259202592125922259232592425925259262592725928259292593025931259322593325934259352593625937259382593925940259412594225943259442594525946259472594825949259502595125952259532595425955259562595725958259592596025961259622596325964259652596625967259682596925970259712597225973259742597525976259772597825979259802598125982259832598425985259862598725988259892599025991259922599325994259952599625997259982599926000260012600226003260042600526006260072600826009260102601126012260132601426015260162601726018260192602026021260222602326024260252602626027260282602926030260312603226033260342603526036260372603826039260402604126042260432604426045260462604726048260492605026051260522605326054260552605626057260582605926060260612606226063260642606526066260672606826069260702607126072260732607426075260762607726078260792608026081260822608326084260852608626087260882608926090260912609226093260942609526096260972609826099261002610126102261032610426105261062610726108261092611026111261122611326114261152611626117261182611926120261212612226123261242612526126261272612826129261302613126132261332613426135261362613726138261392614026141261422614326144261452614626147261482614926150261512615226153261542615526156261572615826159261602616126162261632616426165261662616726168261692617026171261722617326174261752617626177261782617926180261812618226183261842618526186261872618826189261902619126192261932619426195261962619726198261992620026201262022620326204262052620626207262082620926210262112621226213262142621526216262172621826219262202622126222262232622426225262262622726228262292623026231262322623326234262352623626237262382623926240262412624226243262442624526246262472624826249262502625126252262532625426255262562625726258262592626026261262622626326264262652626626267262682626926270262712627226273262742627526276262772627826279262802628126282262832628426285262862628726288262892629026291262922629326294262952629626297262982629926300263012630226303263042630526306263072630826309263102631126312263132631426315263162631726318263192632026321263222632326324263252632626327263282632926330263312633226333263342633526336263372633826339263402634126342263432634426345263462634726348263492635026351263522635326354263552635626357263582635926360263612636226363263642636526366263672636826369263702637126372263732637426375263762637726378263792638026381263822638326384263852638626387263882638926390263912639226393263942639526396263972639826399264002640126402264032640426405264062640726408264092641026411264122641326414264152641626417264182641926420264212642226423264242642526426264272642826429264302643126432264332643426435264362643726438264392644026441264422644326444264452644626447264482644926450264512645226453264542645526456264572645826459264602646126462264632646426465264662646726468264692647026471264722647326474264752647626477264782647926480264812648226483264842648526486264872648826489264902649126492264932649426495264962649726498264992650026501265022650326504265052650626507265082650926510265112651226513265142651526516265172651826519265202652126522265232652426525265262652726528265292653026531265322653326534265352653626537265382653926540265412654226543265442654526546265472654826549265502655126552265532655426555265562655726558265592656026561265622656326564265652656626567265682656926570265712657226573265742657526576265772657826579265802658126582265832658426585265862658726588265892659026591265922659326594265952659626597265982659926600266012660226603266042660526606266072660826609266102661126612266132661426615266162661726618266192662026621266222662326624266252662626627266282662926630266312663226633266342663526636266372663826639266402664126642266432664426645266462664726648266492665026651266522665326654266552665626657266582665926660266612666226663266642666526666266672666826669266702667126672266732667426675266762667726678266792668026681266822668326684266852668626687266882668926690266912669226693266942669526696266972669826699267002670126702267032670426705267062670726708267092671026711267122671326714267152671626717267182671926720267212672226723267242672526726267272672826729267302673126732267332673426735267362673726738267392674026741267422674326744267452674626747267482674926750267512675226753267542675526756267572675826759267602676126762267632676426765267662676726768267692677026771267722677326774267752677626777267782677926780267812678226783267842678526786267872678826789267902679126792267932679426795267962679726798267992680026801268022680326804268052680626807268082680926810268112681226813268142681526816268172681826819268202682126822268232682426825268262682726828268292683026831268322683326834268352683626837268382683926840268412684226843268442684526846268472684826849268502685126852268532685426855268562685726858268592686026861268622686326864268652686626867268682686926870268712687226873268742687526876268772687826879268802688126882268832688426885268862688726888268892689026891268922689326894268952689626897268982689926900269012690226903269042690526906269072690826909269102691126912269132691426915269162691726918269192692026921269222692326924269252692626927269282692926930269312693226933269342693526936269372693826939269402694126942269432694426945269462694726948269492695026951269522695326954269552695626957269582695926960269612696226963269642696526966269672696826969269702697126972269732697426975269762697726978269792698026981269822698326984269852698626987269882698926990269912699226993269942699526996269972699826999270002700127002270032700427005270062700727008270092701027011270122701327014270152701627017270182701927020270212702227023270242702527026270272702827029270302703127032270332703427035270362703727038270392704027041270422704327044270452704627047270482704927050270512705227053270542705527056270572705827059270602706127062270632706427065270662706727068270692707027071270722707327074270752707627077270782707927080270812708227083270842708527086270872708827089270902709127092270932709427095270962709727098270992710027101271022710327104271052710627107271082710927110271112711227113271142711527116271172711827119271202712127122271232712427125271262712727128271292713027131271322713327134271352713627137271382713927140271412714227143271442714527146271472714827149271502715127152271532715427155271562715727158271592716027161271622716327164271652716627167271682716927170271712717227173271742717527176271772717827179271802718127182271832718427185271862718727188271892719027191271922719327194271952719627197271982719927200272012720227203272042720527206272072720827209272102721127212272132721427215272162721727218272192722027221272222722327224272252722627227272282722927230272312723227233272342723527236272372723827239272402724127242272432724427245272462724727248272492725027251272522725327254272552725627257272582725927260272612726227263272642726527266272672726827269272702727127272272732727427275272762727727278272792728027281272822728327284272852728627287272882728927290272912729227293272942729527296272972729827299273002730127302273032730427305273062730727308273092731027311273122731327314273152731627317273182731927320273212732227323273242732527326273272732827329273302733127332273332733427335273362733727338273392734027341273422734327344273452734627347273482734927350273512735227353273542735527356273572735827359273602736127362273632736427365273662736727368273692737027371273722737327374273752737627377273782737927380273812738227383273842738527386273872738827389273902739127392273932739427395273962739727398273992740027401274022740327404274052740627407274082740927410274112741227413274142741527416274172741827419274202742127422274232742427425274262742727428274292743027431274322743327434274352743627437274382743927440274412744227443274442744527446274472744827449274502745127452274532745427455274562745727458274592746027461274622746327464274652746627467274682746927470274712747227473274742747527476274772747827479274802748127482274832748427485274862748727488274892749027491274922749327494274952749627497274982749927500275012750227503275042750527506275072750827509275102751127512275132751427515275162751727518275192752027521275222752327524275252752627527275282752927530275312753227533275342753527536275372753827539275402754127542275432754427545275462754727548275492755027551275522755327554275552755627557275582755927560275612756227563275642756527566275672756827569275702757127572275732757427575275762757727578275792758027581275822758327584275852758627587275882758927590275912759227593275942759527596275972759827599276002760127602276032760427605276062760727608276092761027611276122761327614276152761627617276182761927620276212762227623276242762527626276272762827629276302763127632276332763427635276362763727638276392764027641276422764327644276452764627647276482764927650276512765227653276542765527656276572765827659276602766127662276632766427665276662766727668276692767027671276722767327674276752767627677276782767927680276812768227683276842768527686276872768827689276902769127692276932769427695276962769727698276992770027701277022770327704277052770627707277082770927710277112771227713277142771527716277172771827719277202772127722277232772427725277262772727728277292773027731277322773327734277352773627737277382773927740277412774227743277442774527746277472774827749277502775127752277532775427755277562775727758277592776027761277622776327764277652776627767277682776927770277712777227773277742777527776277772777827779277802778127782277832778427785277862778727788277892779027791277922779327794277952779627797277982779927800278012780227803278042780527806278072780827809278102781127812278132781427815278162781727818278192782027821278222782327824278252782627827278282782927830278312783227833278342783527836278372783827839278402784127842278432784427845278462784727848278492785027851278522785327854278552785627857278582785927860278612786227863278642786527866278672786827869278702787127872278732787427875278762787727878278792788027881278822788327884278852788627887278882788927890278912789227893278942789527896278972789827899279002790127902279032790427905279062790727908279092791027911279122791327914279152791627917279182791927920279212792227923279242792527926279272792827929279302793127932279332793427935279362793727938279392794027941279422794327944279452794627947279482794927950279512795227953279542795527956279572795827959279602796127962279632796427965279662796727968279692797027971279722797327974279752797627977279782797927980279812798227983279842798527986279872798827989279902799127992279932799427995279962799727998279992800028001280022800328004280052800628007280082800928010280112801228013280142801528016280172801828019280202802128022280232802428025280262802728028280292803028031280322803328034280352803628037280382803928040280412804228043280442804528046280472804828049280502805128052280532805428055280562805728058280592806028061280622806328064280652806628067280682806928070280712807228073280742807528076280772807828079280802808128082280832808428085280862808728088280892809028091280922809328094280952809628097280982809928100281012810228103281042810528106281072810828109281102811128112281132811428115281162811728118281192812028121281222812328124281252812628127281282812928130281312813228133281342813528136281372813828139281402814128142281432814428145281462814728148281492815028151281522815328154281552815628157281582815928160281612816228163281642816528166281672816828169281702817128172281732817428175281762817728178281792818028181281822818328184281852818628187281882818928190281912819228193281942819528196281972819828199282002820128202282032820428205282062820728208282092821028211282122821328214282152821628217282182821928220282212822228223282242822528226282272822828229282302823128232282332823428235282362823728238282392824028241282422824328244282452824628247282482824928250282512825228253282542825528256282572825828259282602826128262282632826428265282662826728268282692827028271282722827328274282752827628277282782827928280282812828228283282842828528286282872828828289282902829128292282932829428295282962829728298282992830028301283022830328304283052830628307283082830928310283112831228313283142831528316283172831828319283202832128322283232832428325283262832728328283292833028331283322833328334283352833628337283382833928340283412834228343283442834528346283472834828349283502835128352283532835428355283562835728358283592836028361283622836328364283652836628367283682836928370283712837228373283742837528376283772837828379283802838128382283832838428385283862838728388283892839028391283922839328394283952839628397283982839928400284012840228403284042840528406284072840828409284102841128412284132841428415284162841728418284192842028421284222842328424284252842628427284282842928430284312843228433284342843528436284372843828439284402844128442284432844428445284462844728448284492845028451284522845328454284552845628457284582845928460284612846228463284642846528466284672846828469284702847128472284732847428475284762847728478284792848028481284822848328484284852848628487284882848928490284912849228493284942849528496284972849828499285002850128502285032850428505285062850728508285092851028511285122851328514285152851628517285182851928520285212852228523285242852528526285272852828529285302853128532285332853428535285362853728538285392854028541285422854328544285452854628547285482854928550285512855228553285542855528556285572855828559285602856128562285632856428565285662856728568285692857028571285722857328574285752857628577285782857928580285812858228583285842858528586285872858828589285902859128592285932859428595285962859728598285992860028601286022860328604286052860628607286082860928610286112861228613286142861528616286172861828619286202862128622286232862428625286262862728628286292863028631286322863328634286352863628637286382863928640286412864228643286442864528646286472864828649286502865128652286532865428655286562865728658286592866028661286622866328664286652866628667286682866928670286712867228673286742867528676286772867828679286802868128682286832868428685286862868728688286892869028691286922869328694286952869628697286982869928700287012870228703287042870528706287072870828709287102871128712287132871428715287162871728718287192872028721287222872328724287252872628727287282872928730287312873228733287342873528736287372873828739287402874128742287432874428745287462874728748287492875028751287522875328754287552875628757287582875928760287612876228763287642876528766287672876828769287702877128772287732877428775287762877728778287792878028781287822878328784287852878628787287882878928790287912879228793287942879528796287972879828799288002880128802288032880428805288062880728808288092881028811288122881328814288152881628817288182881928820288212882228823288242882528826288272882828829288302883128832288332883428835288362883728838288392884028841288422884328844288452884628847288482884928850288512885228853288542885528856288572885828859288602886128862288632886428865288662886728868288692887028871288722887328874288752887628877288782887928880288812888228883288842888528886288872888828889288902889128892288932889428895288962889728898288992890028901289022890328904289052890628907289082890928910289112891228913289142891528916289172891828919289202892128922289232892428925289262892728928289292893028931289322893328934289352893628937289382893928940289412894228943289442894528946289472894828949289502895128952289532895428955289562895728958289592896028961289622896328964289652896628967289682896928970289712897228973289742897528976289772897828979289802898128982289832898428985289862898728988289892899028991289922899328994289952899628997289982899929000290012900229003290042900529006290072900829009290102901129012290132901429015290162901729018290192902029021290222902329024290252902629027290282902929030290312903229033290342903529036290372903829039290402904129042290432904429045290462904729048290492905029051290522905329054290552905629057290582905929060290612906229063290642906529066290672906829069290702907129072290732907429075290762907729078290792908029081290822908329084290852908629087290882908929090290912909229093290942909529096290972909829099291002910129102291032910429105291062910729108291092911029111291122911329114291152911629117291182911929120291212912229123291242912529126291272912829129291302913129132291332913429135291362913729138291392914029141291422914329144291452914629147291482914929150291512915229153291542915529156291572915829159291602916129162291632916429165291662916729168291692917029171291722917329174291752917629177291782917929180291812918229183291842918529186291872918829189291902919129192291932919429195291962919729198291992920029201292022920329204292052920629207292082920929210292112921229213292142921529216292172921829219292202922129222292232922429225292262922729228292292923029231292322923329234292352923629237292382923929240292412924229243292442924529246292472924829249292502925129252292532925429255292562925729258292592926029261292622926329264292652926629267292682926929270292712927229273292742927529276292772927829279292802928129282292832928429285292862928729288292892929029291292922929329294292952929629297292982929929300293012930229303293042930529306293072930829309293102931129312293132931429315293162931729318293192932029321293222932329324293252932629327293282932929330293312933229333293342933529336293372933829339293402934129342293432934429345293462934729348293492935029351293522935329354293552935629357293582935929360293612936229363293642936529366293672936829369293702937129372293732937429375293762937729378293792938029381293822938329384293852938629387293882938929390293912939229393293942939529396293972939829399294002940129402294032940429405294062940729408294092941029411294122941329414294152941629417294182941929420294212942229423294242942529426294272942829429294302943129432294332943429435294362943729438294392944029441294422944329444294452944629447294482944929450294512945229453294542945529456294572945829459294602946129462294632946429465294662946729468294692947029471294722947329474294752947629477294782947929480294812948229483294842948529486294872948829489294902949129492294932949429495294962949729498294992950029501295022950329504295052950629507295082950929510295112951229513295142951529516295172951829519295202952129522295232952429525295262952729528295292953029531295322953329534295352953629537295382953929540295412954229543295442954529546295472954829549295502955129552295532955429555295562955729558295592956029561295622956329564295652956629567295682956929570295712957229573295742957529576295772957829579295802958129582295832958429585295862958729588295892959029591295922959329594295952959629597295982959929600296012960229603296042960529606296072960829609296102961129612296132961429615296162961729618296192962029621296222962329624296252962629627296282962929630296312963229633296342963529636296372963829639296402964129642296432964429645296462964729648296492965029651296522965329654296552965629657296582965929660296612966229663296642966529666296672966829669296702967129672296732967429675296762967729678296792968029681296822968329684296852968629687296882968929690296912969229693296942969529696296972969829699297002970129702297032970429705297062970729708297092971029711297122971329714297152971629717297182971929720297212972229723297242972529726297272972829729297302973129732297332973429735297362973729738297392974029741297422974329744297452974629747297482974929750297512975229753297542975529756297572975829759297602976129762297632976429765297662976729768297692977029771297722977329774297752977629777297782977929780297812978229783297842978529786297872978829789297902979129792297932979429795297962979729798297992980029801298022980329804298052980629807298082980929810298112981229813298142981529816298172981829819298202982129822298232982429825298262982729828298292983029831298322983329834298352983629837298382983929840298412984229843298442984529846298472984829849298502985129852298532985429855298562985729858298592986029861298622986329864298652986629867298682986929870298712987229873298742987529876298772987829879298802988129882298832988429885298862988729888298892989029891298922989329894298952989629897298982989929900299012990229903299042990529906299072990829909299102991129912299132991429915299162991729918299192992029921299222992329924299252992629927299282992929930299312993229933299342993529936299372993829939299402994129942299432994429945299462994729948299492995029951299522995329954299552995629957299582995929960299612996229963299642996529966299672996829969299702997129972299732997429975299762997729978299792998029981299822998329984299852998629987299882998929990299912999229993299942999529996299972999829999300003000130002300033000430005300063000730008300093001030011300123001330014300153001630017300183001930020300213002230023300243002530026300273002830029300303003130032300333003430035300363003730038300393004030041300423004330044300453004630047300483004930050300513005230053300543005530056300573005830059300603006130062300633006430065300663006730068300693007030071300723007330074300753007630077300783007930080300813008230083300843008530086300873008830089300903009130092300933009430095300963009730098300993010030101301023010330104301053010630107301083010930110301113011230113301143011530116301173011830119301203012130122301233012430125301263012730128301293013030131301323013330134301353013630137301383013930140301413014230143301443014530146301473014830149301503015130152301533015430155301563015730158301593016030161301623016330164301653016630167301683016930170301713017230173301743017530176301773017830179301803018130182301833018430185301863018730188301893019030191301923019330194301953019630197301983019930200302013020230203302043020530206302073020830209302103021130212302133021430215302163021730218302193022030221302223022330224302253022630227302283022930230302313023230233302343023530236302373023830239302403024130242302433024430245302463024730248302493025030251302523025330254302553025630257302583025930260302613026230263302643026530266302673026830269302703027130272302733027430275302763027730278302793028030281302823028330284302853028630287302883028930290302913029230293302943029530296302973029830299303003030130302303033030430305303063030730308303093031030311303123031330314303153031630317303183031930320303213032230323303243032530326303273032830329303303033130332303333033430335303363033730338303393034030341303423034330344303453034630347303483034930350303513035230353303543035530356303573035830359303603036130362303633036430365303663036730368303693037030371303723037330374303753037630377303783037930380303813038230383303843038530386303873038830389303903039130392303933039430395303963039730398303993040030401304023040330404304053040630407304083040930410304113041230413304143041530416304173041830419304203042130422304233042430425304263042730428304293043030431304323043330434304353043630437304383043930440304413044230443304443044530446304473044830449304503045130452304533045430455304563045730458304593046030461304623046330464304653046630467304683046930470304713047230473304743047530476304773047830479304803048130482304833048430485304863048730488304893049030491304923049330494304953049630497304983049930500305013050230503305043050530506305073050830509305103051130512305133051430515305163051730518305193052030521305223052330524305253052630527305283052930530305313053230533305343053530536305373053830539305403054130542305433054430545305463054730548305493055030551305523055330554305553055630557305583055930560305613056230563305643056530566305673056830569305703057130572305733057430575305763057730578305793058030581305823058330584305853058630587305883058930590305913059230593305943059530596305973059830599306003060130602306033060430605306063060730608306093061030611306123061330614306153061630617306183061930620306213062230623306243062530626306273062830629306303063130632306333063430635306363063730638306393064030641306423064330644306453064630647306483064930650306513065230653306543065530656306573065830659306603066130662306633066430665306663066730668306693067030671306723067330674306753067630677306783067930680306813068230683306843068530686306873068830689306903069130692306933069430695306963069730698306993070030701307023070330704307053070630707307083070930710307113071230713307143071530716307173071830719307203072130722307233072430725307263072730728307293073030731307323073330734307353073630737307383073930740307413074230743307443074530746307473074830749307503075130752307533075430755307563075730758307593076030761307623076330764307653076630767307683076930770307713077230773307743077530776307773077830779307803078130782307833078430785307863078730788307893079030791307923079330794307953079630797307983079930800308013080230803308043080530806308073080830809308103081130812308133081430815308163081730818308193082030821308223082330824308253082630827308283082930830308313083230833308343083530836308373083830839308403084130842308433084430845308463084730848308493085030851308523085330854308553085630857308583085930860308613086230863308643086530866308673086830869308703087130872308733087430875308763087730878308793088030881308823088330884308853088630887308883088930890308913089230893308943089530896308973089830899309003090130902309033090430905309063090730908309093091030911309123091330914309153091630917309183091930920309213092230923309243092530926309273092830929309303093130932309333093430935309363093730938309393094030941309423094330944309453094630947309483094930950309513095230953309543095530956309573095830959309603096130962309633096430965309663096730968309693097030971309723097330974309753097630977309783097930980309813098230983309843098530986309873098830989309903099130992309933099430995309963099730998309993100031001310023100331004310053100631007310083100931010310113101231013310143101531016310173101831019310203102131022310233102431025310263102731028310293103031031310323103331034310353103631037310383103931040310413104231043310443104531046310473104831049310503105131052310533105431055310563105731058310593106031061310623106331064310653106631067310683106931070310713107231073310743107531076310773107831079310803108131082310833108431085310863108731088310893109031091310923109331094310953109631097310983109931100311013110231103311043110531106311073110831109311103111131112311133111431115311163111731118311193112031121311223112331124311253112631127311283112931130311313113231133311343113531136311373113831139311403114131142311433114431145311463114731148311493115031151311523115331154311553115631157311583115931160311613116231163311643116531166311673116831169311703117131172311733117431175311763117731178311793118031181311823118331184311853118631187311883118931190311913119231193311943119531196311973119831199312003120131202312033120431205312063120731208312093121031211312123121331214312153121631217312183121931220312213122231223312243122531226312273122831229312303123131232312333123431235312363123731238312393124031241312423124331244312453124631247312483124931250312513125231253312543125531256312573125831259312603126131262312633126431265312663126731268312693127031271312723127331274312753127631277312783127931280312813128231283312843128531286312873128831289312903129131292312933129431295312963129731298312993130031301313023130331304313053130631307313083130931310313113131231313313143131531316313173131831319313203132131322313233132431325313263132731328313293133031331313323133331334313353133631337313383133931340313413134231343313443134531346313473134831349313503135131352313533135431355313563135731358313593136031361313623136331364313653136631367313683136931370313713137231373313743137531376313773137831379313803138131382313833138431385313863138731388313893139031391313923139331394313953139631397313983139931400314013140231403314043140531406314073140831409314103141131412314133141431415314163141731418314193142031421314223142331424314253142631427314283142931430314313143231433314343143531436314373143831439314403144131442314433144431445314463144731448314493145031451314523145331454314553145631457314583145931460314613146231463314643146531466314673146831469314703147131472314733147431475314763147731478314793148031481314823148331484314853148631487314883148931490314913149231493314943149531496314973149831499315003150131502315033150431505315063150731508315093151031511315123151331514315153151631517315183151931520315213152231523315243152531526315273152831529315303153131532315333153431535315363153731538315393154031541315423154331544315453154631547315483154931550315513155231553315543155531556315573155831559315603156131562315633156431565315663156731568315693157031571315723157331574315753157631577315783157931580315813158231583315843158531586315873158831589315903159131592315933159431595315963159731598315993160031601316023160331604316053160631607316083160931610316113161231613316143161531616316173161831619316203162131622316233162431625316263162731628316293163031631316323163331634316353163631637316383163931640316413164231643316443164531646316473164831649316503165131652316533165431655316563165731658316593166031661316623166331664316653166631667316683166931670316713167231673316743167531676316773167831679316803168131682316833168431685316863168731688316893169031691316923169331694316953169631697316983169931700317013170231703317043170531706317073170831709317103171131712317133171431715317163171731718317193172031721317223172331724317253172631727317283172931730317313173231733317343173531736317373173831739317403174131742317433174431745317463174731748317493175031751317523175331754317553175631757317583175931760317613176231763317643176531766317673176831769317703177131772317733177431775317763177731778317793178031781317823178331784317853178631787317883178931790317913179231793317943179531796317973179831799318003180131802318033180431805318063180731808318093181031811318123181331814318153181631817318183181931820318213182231823318243182531826318273182831829318303183131832318333183431835318363183731838318393184031841318423184331844318453184631847318483184931850318513185231853318543185531856318573185831859318603186131862318633186431865318663186731868318693187031871318723187331874318753187631877318783187931880318813188231883318843188531886318873188831889318903189131892318933189431895318963189731898318993190031901319023190331904319053190631907319083190931910319113191231913319143191531916319173191831919319203192131922319233192431925319263192731928319293193031931319323193331934319353193631937319383193931940319413194231943319443194531946319473194831949319503195131952319533195431955319563195731958319593196031961319623196331964319653196631967319683196931970319713197231973319743197531976319773197831979319803198131982319833198431985319863198731988319893199031991319923199331994319953199631997319983199932000320013200232003320043200532006320073200832009320103201132012320133201432015320163201732018320193202032021320223202332024320253202632027320283202932030320313203232033320343203532036320373203832039320403204132042320433204432045320463204732048320493205032051320523205332054320553205632057320583205932060320613206232063320643206532066320673206832069320703207132072320733207432075320763207732078320793208032081320823208332084320853208632087320883208932090320913209232093320943209532096320973209832099321003210132102321033210432105321063210732108321093211032111321123211332114321153211632117321183211932120321213212232123321243212532126321273212832129321303213132132321333213432135321363213732138321393214032141321423214332144321453214632147321483214932150321513215232153321543215532156321573215832159321603216132162321633216432165321663216732168321693217032171321723217332174321753217632177321783217932180321813218232183321843218532186321873218832189321903219132192321933219432195321963219732198321993220032201322023220332204322053220632207322083220932210322113221232213322143221532216322173221832219322203222132222322233222432225322263222732228322293223032231322323223332234322353223632237322383223932240322413224232243322443224532246322473224832249322503225132252322533225432255322563225732258322593226032261322623226332264322653226632267322683226932270322713227232273322743227532276322773227832279322803228132282322833228432285322863228732288322893229032291322923229332294322953229632297322983229932300323013230232303323043230532306323073230832309323103231132312323133231432315323163231732318323193232032321323223232332324323253232632327323283232932330323313233232333323343233532336323373233832339323403234132342323433234432345323463234732348323493235032351323523235332354323553235632357323583235932360323613236232363323643236532366323673236832369323703237132372323733237432375323763237732378323793238032381323823238332384323853238632387323883238932390323913239232393323943239532396323973239832399324003240132402324033240432405324063240732408324093241032411324123241332414324153241632417324183241932420324213242232423324243242532426324273242832429324303243132432324333243432435324363243732438324393244032441324423244332444324453244632447324483244932450324513245232453324543245532456324573245832459324603246132462324633246432465324663246732468324693247032471324723247332474324753247632477324783247932480324813248232483324843248532486324873248832489324903249132492324933249432495324963249732498324993250032501325023250332504325053250632507325083250932510325113251232513325143251532516325173251832519325203252132522325233252432525325263252732528325293253032531325323253332534325353253632537325383253932540325413254232543325443254532546325473254832549325503255132552325533255432555325563255732558325593256032561325623256332564325653256632567325683256932570325713257232573325743257532576325773257832579325803258132582325833258432585325863258732588325893259032591325923259332594325953259632597325983259932600326013260232603326043260532606326073260832609326103261132612326133261432615326163261732618326193262032621326223262332624326253262632627326283262932630326313263232633326343263532636326373263832639326403264132642326433264432645326463264732648326493265032651326523265332654326553265632657326583265932660326613266232663326643266532666326673266832669326703267132672326733267432675326763267732678326793268032681326823268332684326853268632687326883268932690326913269232693326943269532696326973269832699327003270132702327033270432705327063270732708327093271032711327123271332714327153271632717327183271932720327213272232723327243272532726327273272832729327303273132732327333273432735327363273732738327393274032741327423274332744327453274632747327483274932750327513275232753327543275532756327573275832759327603276132762327633276432765327663276732768327693277032771327723277332774327753277632777327783277932780327813278232783327843278532786327873278832789327903279132792327933279432795327963279732798327993280032801328023280332804328053280632807328083280932810328113281232813328143281532816328173281832819328203282132822328233282432825328263282732828328293283032831328323283332834328353283632837328383283932840328413284232843328443284532846328473284832849328503285132852328533285432855328563285732858328593286032861328623286332864328653286632867328683286932870328713287232873328743287532876328773287832879328803288132882328833288432885328863288732888328893289032891328923289332894328953289632897328983289932900329013290232903329043290532906329073290832909329103291132912329133291432915329163291732918329193292032921329223292332924329253292632927329283292932930329313293232933329343293532936329373293832939329403294132942329433294432945329463294732948329493295032951329523295332954329553295632957329583295932960329613296232963329643296532966329673296832969329703297132972329733297432975329763297732978329793298032981329823298332984329853298632987329883298932990329913299232993329943299532996329973299832999330003300133002330033300433005330063300733008330093301033011330123301333014330153301633017330183301933020330213302233023330243302533026330273302833029330303303133032330333303433035330363303733038330393304033041330423304333044330453304633047330483304933050330513305233053330543305533056330573305833059330603306133062330633306433065330663306733068330693307033071330723307333074330753307633077330783307933080330813308233083330843308533086330873308833089330903309133092330933309433095330963309733098330993310033101331023310333104331053310633107331083310933110331113311233113331143311533116331173311833119331203312133122331233312433125331263312733128331293313033131331323313333134331353313633137331383313933140331413314233143331443314533146331473314833149331503315133152331533315433155331563315733158331593316033161331623316333164331653316633167331683316933170331713317233173331743317533176331773317833179331803318133182331833318433185331863318733188331893319033191331923319333194331953319633197331983319933200332013320233203332043320533206332073320833209332103321133212332133321433215332163321733218332193322033221332223322333224332253322633227332283322933230332313323233233332343323533236332373323833239332403324133242332433324433245332463324733248332493325033251332523325333254332553325633257332583325933260332613326233263332643326533266332673326833269332703327133272332733327433275332763327733278332793328033281332823328333284332853328633287332883328933290332913329233293332943329533296332973329833299333003330133302333033330433305333063330733308333093331033311333123331333314333153331633317333183331933320333213332233323333243332533326333273332833329333303333133332333333333433335333363333733338333393334033341333423334333344333453334633347333483334933350333513335233353333543335533356333573335833359333603336133362333633336433365333663336733368333693337033371333723337333374333753337633377333783337933380333813338233383333843338533386333873338833389333903339133392333933339433395333963339733398333993340033401334023340333404334053340633407334083340933410334113341233413334143341533416334173341833419334203342133422334233342433425334263342733428334293343033431334323343333434334353343633437334383343933440334413344233443334443344533446334473344833449334503345133452334533345433455334563345733458334593346033461334623346333464334653346633467334683346933470334713347233473334743347533476334773347833479334803348133482334833348433485334863348733488334893349033491334923349333494334953349633497334983349933500335013350233503335043350533506335073350833509335103351133512335133351433515335163351733518335193352033521335223352333524335253352633527335283352933530335313353233533335343353533536335373353833539335403354133542335433354433545335463354733548335493355033551335523355333554335553355633557335583355933560335613356233563335643356533566335673356833569335703357133572335733357433575335763357733578335793358033581335823358333584335853358633587335883358933590335913359233593335943359533596335973359833599336003360133602336033360433605336063360733608336093361033611336123361333614336153361633617336183361933620336213362233623336243362533626336273362833629336303363133632336333363433635336363363733638336393364033641336423364333644336453364633647336483364933650336513365233653336543365533656336573365833659336603366133662336633366433665336663366733668336693367033671336723367333674336753367633677336783367933680336813368233683336843368533686336873368833689336903369133692336933369433695336963369733698336993370033701337023370333704337053370633707337083370933710337113371233713337143371533716337173371833719337203372133722337233372433725337263372733728337293373033731337323373333734337353373633737337383373933740337413374233743337443374533746337473374833749337503375133752337533375433755337563375733758337593376033761337623376333764337653376633767337683376933770337713377233773337743377533776337773377833779337803378133782337833378433785337863378733788337893379033791337923379333794337953379633797337983379933800338013380233803338043380533806338073380833809338103381133812338133381433815338163381733818338193382033821338223382333824338253382633827338283382933830338313383233833338343383533836338373383833839338403384133842338433384433845338463384733848338493385033851338523385333854338553385633857338583385933860338613386233863338643386533866338673386833869338703387133872338733387433875338763387733878338793388033881338823388333884338853388633887338883388933890338913389233893338943389533896338973389833899339003390133902339033390433905339063390733908339093391033911339123391333914339153391633917339183391933920339213392233923339243392533926339273392833929339303393133932339333393433935339363393733938339393394033941339423394333944339453394633947339483394933950339513395233953339543395533956339573395833959339603396133962339633396433965339663396733968339693397033971339723397333974339753397633977339783397933980339813398233983339843398533986339873398833989339903399133992339933399433995339963399733998339993400034001340023400334004340053400634007340083400934010340113401234013340143401534016340173401834019340203402134022340233402434025340263402734028340293403034031340323403334034340353403634037340383403934040340413404234043340443404534046340473404834049340503405134052340533405434055340563405734058340593406034061340623406334064340653406634067340683406934070340713407234073340743407534076340773407834079340803408134082340833408434085340863408734088340893409034091340923409334094340953409634097340983409934100341013410234103341043410534106341073410834109341103411134112341133411434115341163411734118341193412034121341223412334124341253412634127341283412934130341313413234133341343413534136341373413834139341403414134142341433414434145341463414734148341493415034151341523415334154341553415634157341583415934160341613416234163341643416534166341673416834169341703417134172341733417434175341763417734178341793418034181341823418334184341853418634187341883418934190341913419234193341943419534196341973419834199342003420134202342033420434205342063420734208342093421034211342123421334214342153421634217342183421934220342213422234223342243422534226342273422834229342303423134232342333423434235342363423734238342393424034241342423424334244342453424634247342483424934250342513425234253342543425534256342573425834259342603426134262342633426434265342663426734268342693427034271342723427334274342753427634277342783427934280342813428234283342843428534286342873428834289342903429134292342933429434295342963429734298342993430034301343023430334304343053430634307343083430934310343113431234313343143431534316343173431834319343203432134322343233432434325343263432734328343293433034331343323433334334343353433634337343383433934340343413434234343343443434534346343473434834349343503435134352343533435434355343563435734358343593436034361343623436334364343653436634367343683436934370343713437234373343743437534376343773437834379343803438134382343833438434385343863438734388343893439034391343923439334394343953439634397343983439934400344013440234403344043440534406344073440834409344103441134412344133441434415344163441734418344193442034421344223442334424344253442634427344283442934430344313443234433344343443534436344373443834439344403444134442344433444434445344463444734448344493445034451344523445334454344553445634457344583445934460344613446234463344643446534466344673446834469344703447134472344733447434475344763447734478344793448034481344823448334484344853448634487344883448934490344913449234493344943449534496344973449834499345003450134502345033450434505345063450734508345093451034511345123451334514345153451634517345183451934520345213452234523345243452534526345273452834529345303453134532345333453434535345363453734538345393454034541345423454334544345453454634547345483454934550345513455234553345543455534556345573455834559345603456134562345633456434565345663456734568345693457034571345723457334574345753457634577345783457934580345813458234583345843458534586345873458834589345903459134592345933459434595345963459734598345993460034601346023460334604346053460634607346083460934610346113461234613346143461534616346173461834619346203462134622346233462434625346263462734628346293463034631346323463334634346353463634637346383463934640346413464234643346443464534646346473464834649346503465134652346533465434655346563465734658346593466034661346623466334664346653466634667346683466934670346713467234673346743467534676346773467834679346803468134682346833468434685346863468734688346893469034691346923469334694346953469634697346983469934700347013470234703347043470534706347073470834709347103471134712347133471434715347163471734718347193472034721347223472334724347253472634727347283472934730347313473234733347343473534736347373473834739347403474134742347433474434745347463474734748347493475034751347523475334754347553475634757347583475934760347613476234763347643476534766347673476834769347703477134772347733477434775347763477734778347793478034781347823478334784347853478634787347883478934790347913479234793347943479534796347973479834799348003480134802348033480434805348063480734808348093481034811348123481334814348153481634817348183481934820348213482234823348243482534826348273482834829348303483134832348333483434835348363483734838348393484034841348423484334844348453484634847348483484934850348513485234853348543485534856348573485834859348603486134862348633486434865348663486734868348693487034871348723487334874348753487634877348783487934880348813488234883348843488534886348873488834889348903489134892348933489434895348963489734898348993490034901349023490334904349053490634907349083490934910349113491234913349143491534916349173491834919349203492134922349233492434925349263492734928349293493034931349323493334934349353493634937349383493934940349413494234943349443494534946349473494834949349503495134952349533495434955349563495734958349593496034961349623496334964349653496634967349683496934970349713497234973349743497534976349773497834979349803498134982349833498434985349863498734988349893499034991349923499334994349953499634997349983499935000350013500235003350043500535006350073500835009350103501135012350133501435015350163501735018350193502035021350223502335024350253502635027350283502935030350313503235033350343503535036350373503835039350403504135042350433504435045350463504735048350493505035051350523505335054350553505635057350583505935060350613506235063350643506535066350673506835069350703507135072350733507435075350763507735078350793508035081350823508335084350853508635087350883508935090350913509235093350943509535096350973509835099351003510135102351033510435105351063510735108351093511035111351123511335114351153511635117351183511935120351213512235123351243512535126351273512835129351303513135132351333513435135351363513735138351393514035141351423514335144351453514635147351483514935150351513515235153351543515535156351573515835159351603516135162351633516435165351663516735168351693517035171351723517335174351753517635177351783517935180351813518235183351843518535186351873518835189351903519135192351933519435195351963519735198351993520035201352023520335204352053520635207352083520935210352113521235213352143521535216352173521835219352203522135222352233522435225352263522735228352293523035231352323523335234352353523635237352383523935240352413524235243352443524535246352473524835249352503525135252352533525435255352563525735258352593526035261352623526335264352653526635267352683526935270352713527235273352743527535276352773527835279352803528135282352833528435285352863528735288352893529035291352923529335294352953529635297352983529935300353013530235303353043530535306353073530835309353103531135312353133531435315353163531735318353193532035321353223532335324353253532635327353283532935330353313533235333353343533535336353373533835339353403534135342353433534435345353463534735348353493535035351353523535335354353553535635357353583535935360353613536235363353643536535366353673536835369353703537135372353733537435375353763537735378353793538035381353823538335384353853538635387353883538935390353913539235393353943539535396353973539835399354003540135402354033540435405354063540735408354093541035411354123541335414354153541635417354183541935420354213542235423354243542535426354273542835429354303543135432354333543435435354363543735438354393544035441354423544335444354453544635447354483544935450354513545235453354543545535456354573545835459354603546135462354633546435465354663546735468354693547035471354723547335474354753547635477354783547935480354813548235483354843548535486354873548835489354903549135492354933549435495354963549735498354993550035501355023550335504355053550635507355083550935510355113551235513355143551535516355173551835519355203552135522355233552435525355263552735528355293553035531355323553335534355353553635537355383553935540355413554235543355443554535546355473554835549355503555135552355533555435555355563555735558355593556035561355623556335564355653556635567355683556935570355713557235573355743557535576355773557835579355803558135582355833558435585355863558735588355893559035591355923559335594355953559635597355983559935600356013560235603356043560535606356073560835609356103561135612356133561435615356163561735618356193562035621356223562335624356253562635627356283562935630356313563235633356343563535636356373563835639356403564135642356433564435645356463564735648356493565035651356523565335654356553565635657356583565935660356613566235663356643566535666356673566835669356703567135672356733567435675356763567735678356793568035681356823568335684356853568635687356883568935690356913569235693356943569535696356973569835699357003570135702357033570435705357063570735708357093571035711357123571335714357153571635717357183571935720357213572235723357243572535726357273572835729357303573135732357333573435735357363573735738357393574035741357423574335744357453574635747357483574935750357513575235753357543575535756357573575835759357603576135762357633576435765357663576735768357693577035771357723577335774357753577635777357783577935780357813578235783357843578535786357873578835789357903579135792357933579435795357963579735798357993580035801358023580335804358053580635807358083580935810358113581235813358143581535816358173581835819358203582135822358233582435825358263582735828358293583035831358323583335834358353583635837358383583935840358413584235843358443584535846358473584835849358503585135852358533585435855358563585735858358593586035861358623586335864358653586635867358683586935870358713587235873358743587535876358773587835879358803588135882358833588435885358863588735888358893589035891358923589335894358953589635897358983589935900359013590235903359043590535906359073590835909359103591135912359133591435915359163591735918359193592035921359223592335924359253592635927359283592935930359313593235933359343593535936359373593835939359403594135942359433594435945359463594735948359493595035951359523595335954359553595635957359583595935960359613596235963359643596535966359673596835969359703597135972359733597435975359763597735978359793598035981359823598335984359853598635987359883598935990359913599235993359943599535996359973599835999360003600136002360033600436005360063600736008360093601036011360123601336014360153601636017360183601936020360213602236023360243602536026360273602836029360303603136032360333603436035360363603736038360393604036041360423604336044360453604636047360483604936050360513605236053360543605536056360573605836059360603606136062360633606436065360663606736068360693607036071360723607336074360753607636077360783607936080360813608236083360843608536086360873608836089360903609136092360933609436095360963609736098360993610036101361023610336104361053610636107361083610936110361113611236113361143611536116361173611836119361203612136122361233612436125361263612736128361293613036131361323613336134361353613636137361383613936140361413614236143361443614536146361473614836149361503615136152361533615436155361563615736158361593616036161361623616336164361653616636167361683616936170361713617236173361743617536176361773617836179361803618136182361833618436185361863618736188361893619036191361923619336194361953619636197361983619936200362013620236203362043620536206362073620836209362103621136212362133621436215362163621736218362193622036221362223622336224362253622636227362283622936230362313623236233362343623536236362373623836239362403624136242362433624436245362463624736248362493625036251362523625336254362553625636257362583625936260362613626236263362643626536266362673626836269362703627136272362733627436275362763627736278362793628036281362823628336284362853628636287362883628936290362913629236293362943629536296362973629836299363003630136302363033630436305363063630736308363093631036311363123631336314363153631636317363183631936320363213632236323363243632536326363273632836329363303633136332363333633436335363363633736338363393634036341363423634336344363453634636347363483634936350363513635236353363543635536356363573635836359363603636136362363633636436365363663636736368363693637036371363723637336374363753637636377363783637936380363813638236383363843638536386363873638836389363903639136392363933639436395363963639736398363993640036401364023640336404364053640636407364083640936410364113641236413364143641536416364173641836419364203642136422364233642436425364263642736428364293643036431364323643336434364353643636437364383643936440364413644236443364443644536446364473644836449364503645136452364533645436455364563645736458364593646036461364623646336464364653646636467364683646936470364713647236473364743647536476364773647836479364803648136482364833648436485364863648736488364893649036491364923649336494364953649636497364983649936500365013650236503365043650536506365073650836509365103651136512365133651436515365163651736518365193652036521365223652336524365253652636527365283652936530365313653236533365343653536536365373653836539365403654136542365433654436545365463654736548365493655036551365523655336554365553655636557365583655936560365613656236563365643656536566365673656836569365703657136572365733657436575365763657736578365793658036581365823658336584365853658636587365883658936590365913659236593365943659536596365973659836599366003660136602366033660436605366063660736608366093661036611366123661336614366153661636617366183661936620366213662236623366243662536626366273662836629366303663136632366333663436635366363663736638366393664036641366423664336644366453664636647366483664936650366513665236653366543665536656366573665836659366603666136662366633666436665366663666736668366693667036671366723667336674366753667636677366783667936680366813668236683366843668536686366873668836689366903669136692366933669436695366963669736698366993670036701367023670336704367053670636707367083670936710367113671236713367143671536716367173671836719367203672136722367233672436725367263672736728367293673036731367323673336734367353673636737367383673936740367413674236743367443674536746367473674836749367503675136752367533675436755367563675736758367593676036761367623676336764367653676636767367683676936770367713677236773367743677536776367773677836779367803678136782367833678436785367863678736788367893679036791367923679336794367953679636797367983679936800368013680236803368043680536806368073680836809368103681136812368133681436815368163681736818368193682036821368223682336824368253682636827368283682936830368313683236833368343683536836368373683836839368403684136842368433684436845368463684736848368493685036851368523685336854368553685636857368583685936860368613686236863368643686536866368673686836869368703687136872368733687436875368763687736878368793688036881368823688336884368853688636887368883688936890368913689236893368943689536896368973689836899369003690136902369033690436905369063690736908369093691036911369123691336914369153691636917369183691936920369213692236923369243692536926369273692836929369303693136932369333693436935369363693736938369393694036941369423694336944369453694636947369483694936950369513695236953369543695536956369573695836959369603696136962369633696436965369663696736968369693697036971369723697336974369753697636977369783697936980369813698236983369843698536986369873698836989369903699136992369933699436995369963699736998369993700037001370023700337004370053700637007370083700937010370113701237013370143701537016370173701837019370203702137022370233702437025370263702737028370293703037031370323703337034370353703637037370383703937040370413704237043370443704537046370473704837049370503705137052370533705437055370563705737058370593706037061370623706337064370653706637067370683706937070370713707237073370743707537076370773707837079370803708137082370833708437085370863708737088370893709037091370923709337094370953709637097370983709937100371013710237103371043710537106371073710837109371103711137112371133711437115371163711737118371193712037121371223712337124371253712637127371283712937130371313713237133371343713537136371373713837139371403714137142371433714437145371463714737148371493715037151371523715337154371553715637157371583715937160371613716237163371643716537166371673716837169371703717137172371733717437175371763717737178371793718037181371823718337184371853718637187371883718937190371913719237193371943719537196371973719837199372003720137202372033720437205372063720737208372093721037211372123721337214372153721637217372183721937220372213722237223372243722537226372273722837229372303723137232372333723437235372363723737238372393724037241372423724337244372453724637247372483724937250372513725237253372543725537256372573725837259372603726137262372633726437265372663726737268372693727037271372723727337274372753727637277372783727937280372813728237283372843728537286372873728837289372903729137292372933729437295372963729737298372993730037301373023730337304373053730637307373083730937310373113731237313373143731537316373173731837319373203732137322373233732437325373263732737328373293733037331373323733337334373353733637337373383733937340373413734237343373443734537346373473734837349373503735137352373533735437355373563735737358373593736037361373623736337364373653736637367373683736937370373713737237373373743737537376373773737837379373803738137382373833738437385373863738737388373893739037391373923739337394373953739637397373983739937400374013740237403374043740537406374073740837409374103741137412374133741437415374163741737418374193742037421374223742337424374253742637427374283742937430374313743237433374343743537436374373743837439374403744137442374433744437445374463744737448374493745037451374523745337454374553745637457374583745937460374613746237463374643746537466374673746837469374703747137472374733747437475374763747737478374793748037481374823748337484374853748637487374883748937490374913749237493374943749537496374973749837499375003750137502375033750437505375063750737508375093751037511375123751337514375153751637517375183751937520375213752237523375243752537526375273752837529375303753137532375333753437535375363753737538375393754037541375423754337544375453754637547375483754937550375513755237553375543755537556375573755837559375603756137562375633756437565375663756737568375693757037571375723757337574375753757637577375783757937580375813758237583375843758537586375873758837589375903759137592375933759437595375963759737598375993760037601376023760337604376053760637607376083760937610376113761237613376143761537616376173761837619376203762137622376233762437625376263762737628376293763037631376323763337634376353763637637376383763937640376413764237643376443764537646376473764837649376503765137652376533765437655376563765737658376593766037661376623766337664376653766637667376683766937670376713767237673376743767537676376773767837679376803768137682376833768437685376863768737688376893769037691376923769337694376953769637697376983769937700377013770237703377043770537706377073770837709377103771137712377133771437715377163771737718377193772037721377223772337724377253772637727377283772937730377313773237733377343773537736377373773837739377403774137742377433774437745377463774737748377493775037751377523775337754377553775637757377583775937760377613776237763377643776537766377673776837769377703777137772377733777437775377763777737778377793778037781377823778337784377853778637787377883778937790377913779237793377943779537796377973779837799378003780137802378033780437805378063780737808378093781037811378123781337814378153781637817378183781937820378213782237823378243782537826378273782837829378303783137832378333783437835378363783737838378393784037841378423784337844378453784637847378483784937850378513785237853378543785537856378573785837859378603786137862378633786437865378663786737868378693787037871378723787337874378753787637877378783787937880378813788237883378843788537886378873788837889378903789137892378933789437895378963789737898378993790037901379023790337904379053790637907379083790937910379113791237913379143791537916379173791837919379203792137922379233792437925379263792737928379293793037931379323793337934379353793637937379383793937940379413794237943379443794537946379473794837949379503795137952379533795437955379563795737958379593796037961379623796337964379653796637967379683796937970379713797237973379743797537976379773797837979379803798137982379833798437985379863798737988379893799037991379923799337994379953799637997379983799938000380013800238003380043800538006380073800838009380103801138012380133801438015380163801738018380193802038021380223802338024380253802638027380283802938030380313803238033380343803538036380373803838039380403804138042380433804438045380463804738048380493805038051380523805338054380553805638057380583805938060380613806238063380643806538066380673806838069380703807138072380733807438075380763807738078380793808038081380823808338084380853808638087380883808938090380913809238093380943809538096380973809838099381003810138102381033810438105381063810738108381093811038111381123811338114381153811638117381183811938120381213812238123381243812538126381273812838129381303813138132381333813438135381363813738138381393814038141381423814338144381453814638147381483814938150381513815238153381543815538156381573815838159381603816138162381633816438165381663816738168381693817038171381723817338174381753817638177381783817938180381813818238183381843818538186381873818838189381903819138192381933819438195381963819738198381993820038201382023820338204382053820638207382083820938210382113821238213382143821538216382173821838219382203822138222382233822438225382263822738228382293823038231382323823338234382353823638237382383823938240382413824238243382443824538246382473824838249382503825138252382533825438255382563825738258382593826038261382623826338264382653826638267382683826938270382713827238273382743827538276382773827838279382803828138282382833828438285382863828738288382893829038291382923829338294382953829638297382983829938300383013830238303383043830538306383073830838309383103831138312383133831438315383163831738318383193832038321383223832338324383253832638327383283832938330383313833238333383343833538336383373833838339383403834138342383433834438345383463834738348383493835038351383523835338354383553835638357383583835938360383613836238363383643836538366383673836838369383703837138372383733837438375383763837738378383793838038381383823838338384383853838638387383883838938390383913839238393383943839538396383973839838399384003840138402384033840438405384063840738408384093841038411384123841338414384153841638417384183841938420384213842238423384243842538426384273842838429384303843138432384333843438435384363843738438384393844038441384423844338444384453844638447384483844938450384513845238453384543845538456384573845838459384603846138462384633846438465384663846738468384693847038471384723847338474384753847638477384783847938480384813848238483384843848538486384873848838489384903849138492384933849438495384963849738498384993850038501385023850338504385053850638507385083850938510385113851238513385143851538516385173851838519385203852138522385233852438525385263852738528385293853038531385323853338534385353853638537385383853938540385413854238543385443854538546385473854838549385503855138552385533855438555385563855738558385593856038561385623856338564385653856638567385683856938570385713857238573385743857538576385773857838579385803858138582385833858438585385863858738588385893859038591385923859338594385953859638597385983859938600386013860238603386043860538606386073860838609386103861138612386133861438615386163861738618386193862038621386223862338624386253862638627386283862938630386313863238633386343863538636386373863838639386403864138642386433864438645386463864738648386493865038651386523865338654386553865638657386583865938660386613866238663386643866538666386673866838669386703867138672386733867438675386763867738678386793868038681386823868338684386853868638687386883868938690386913869238693386943869538696386973869838699387003870138702387033870438705387063870738708387093871038711387123871338714387153871638717387183871938720387213872238723387243872538726387273872838729387303873138732387333873438735387363873738738387393874038741387423874338744387453874638747387483874938750387513875238753387543875538756387573875838759387603876138762387633876438765387663876738768387693877038771387723877338774387753877638777387783877938780387813878238783387843878538786387873878838789387903879138792387933879438795387963879738798387993880038801388023880338804388053880638807388083880938810388113881238813388143881538816388173881838819388203882138822388233882438825388263882738828388293883038831388323883338834388353883638837388383883938840388413884238843388443884538846388473884838849388503885138852388533885438855388563885738858388593886038861388623886338864388653886638867388683886938870388713887238873388743887538876388773887838879388803888138882388833888438885388863888738888388893889038891388923889338894388953889638897388983889938900389013890238903389043890538906389073890838909389103891138912389133891438915389163891738918389193892038921389223892338924389253892638927389283892938930389313893238933389343893538936389373893838939389403894138942389433894438945389463894738948389493895038951389523895338954389553895638957389583895938960389613896238963389643896538966389673896838969389703897138972389733897438975389763897738978389793898038981389823898338984389853898638987389883898938990389913899238993389943899538996389973899838999390003900139002390033900439005390063900739008390093901039011390123901339014390153901639017390183901939020390213902239023390243902539026390273902839029390303903139032390333903439035390363903739038390393904039041390423904339044390453904639047390483904939050390513905239053390543905539056390573905839059390603906139062390633906439065390663906739068390693907039071390723907339074390753907639077390783907939080390813908239083390843908539086390873908839089390903909139092390933909439095390963909739098390993910039101391023910339104391053910639107391083910939110391113911239113391143911539116391173911839119391203912139122391233912439125391263912739128391293913039131391323913339134391353913639137391383913939140391413914239143391443914539146391473914839149391503915139152391533915439155391563915739158391593916039161391623916339164391653916639167391683916939170391713917239173391743917539176391773917839179391803918139182391833918439185391863918739188391893919039191391923919339194391953919639197391983919939200392013920239203392043920539206392073920839209392103921139212392133921439215392163921739218392193922039221392223922339224392253922639227392283922939230392313923239233392343923539236392373923839239392403924139242392433924439245392463924739248392493925039251392523925339254392553925639257392583925939260392613926239263392643926539266392673926839269392703927139272392733927439275392763927739278392793928039281392823928339284392853928639287392883928939290392913929239293392943929539296392973929839299393003930139302393033930439305393063930739308393093931039311393123931339314393153931639317393183931939320393213932239323393243932539326393273932839329393303933139332393333933439335393363933739338393393934039341393423934339344393453934639347393483934939350393513935239353393543935539356393573935839359393603936139362393633936439365393663936739368393693937039371393723937339374393753937639377393783937939380393813938239383393843938539386393873938839389393903939139392393933939439395393963939739398393993940039401394023940339404394053940639407394083940939410394113941239413394143941539416394173941839419394203942139422394233942439425394263942739428394293943039431394323943339434394353943639437394383943939440394413944239443394443944539446394473944839449394503945139452394533945439455394563945739458394593946039461394623946339464394653946639467394683946939470394713947239473394743947539476394773947839479394803948139482394833948439485394863948739488394893949039491394923949339494394953949639497394983949939500395013950239503395043950539506395073950839509395103951139512395133951439515395163951739518395193952039521395223952339524395253952639527395283952939530395313953239533395343953539536395373953839539395403954139542395433954439545395463954739548395493955039551395523955339554395553955639557395583955939560395613956239563395643956539566395673956839569395703957139572395733957439575395763957739578395793958039581395823958339584395853958639587395883958939590395913959239593395943959539596395973959839599396003960139602396033960439605396063960739608396093961039611396123961339614396153961639617396183961939620396213962239623396243962539626396273962839629396303963139632396333963439635396363963739638396393964039641396423964339644396453964639647396483964939650396513965239653396543965539656396573965839659396603966139662396633966439665396663966739668396693967039671396723967339674396753967639677396783967939680396813968239683396843968539686396873968839689396903969139692396933969439695396963969739698396993970039701397023970339704397053970639707397083970939710397113971239713397143971539716397173971839719397203972139722397233972439725397263972739728397293973039731397323973339734397353973639737397383973939740397413974239743397443974539746397473974839749397503975139752397533975439755397563975739758397593976039761397623976339764397653976639767397683976939770397713977239773397743977539776397773977839779397803978139782397833978439785397863978739788397893979039791397923979339794397953979639797397983979939800398013980239803398043980539806398073980839809398103981139812398133981439815398163981739818398193982039821398223982339824398253982639827398283982939830398313983239833398343983539836398373983839839398403984139842398433984439845398463984739848398493985039851398523985339854398553985639857398583985939860398613986239863398643986539866398673986839869398703987139872398733987439875398763987739878398793988039881398823988339884398853988639887398883988939890398913989239893398943989539896398973989839899399003990139902399033990439905399063990739908399093991039911399123991339914399153991639917399183991939920399213992239923399243992539926399273992839929399303993139932399333993439935399363993739938399393994039941399423994339944399453994639947399483994939950399513995239953399543995539956399573995839959399603996139962399633996439965399663996739968399693997039971399723997339974399753997639977399783997939980399813998239983399843998539986399873998839989399903999139992399933999439995399963999739998399994000040001400024000340004400054000640007400084000940010400114001240013400144001540016400174001840019400204002140022400234002440025400264002740028400294003040031400324003340034400354003640037400384003940040400414004240043400444004540046400474004840049400504005140052400534005440055400564005740058400594006040061400624006340064400654006640067400684006940070400714007240073400744007540076400774007840079400804008140082400834008440085400864008740088400894009040091400924009340094400954009640097400984009940100401014010240103401044010540106401074010840109401104011140112401134011440115401164011740118401194012040121401224012340124401254012640127401284012940130401314013240133401344013540136401374013840139401404014140142401434014440145401464014740148401494015040151401524015340154401554015640157401584015940160401614016240163401644016540166401674016840169401704017140172401734017440175401764017740178401794018040181401824018340184401854018640187401884018940190401914019240193401944019540196401974019840199402004020140202402034020440205402064020740208402094021040211402124021340214402154021640217402184021940220402214022240223402244022540226402274022840229402304023140232402334023440235402364023740238402394024040241402424024340244402454024640247402484024940250402514025240253402544025540256402574025840259402604026140262402634026440265402664026740268402694027040271402724027340274402754027640277402784027940280402814028240283402844028540286402874028840289402904029140292402934029440295402964029740298402994030040301403024030340304403054030640307403084030940310403114031240313403144031540316403174031840319403204032140322403234032440325403264032740328403294033040331403324033340334403354033640337403384033940340403414034240343403444034540346403474034840349403504035140352403534035440355403564035740358403594036040361403624036340364403654036640367403684036940370403714037240373403744037540376403774037840379403804038140382403834038440385403864038740388403894039040391403924039340394403954039640397403984039940400404014040240403404044040540406404074040840409404104041140412404134041440415404164041740418404194042040421404224042340424404254042640427404284042940430404314043240433404344043540436404374043840439404404044140442404434044440445404464044740448404494045040451404524045340454404554045640457404584045940460404614046240463404644046540466404674046840469404704047140472404734047440475404764047740478404794048040481404824048340484404854048640487404884048940490404914049240493404944049540496404974049840499405004050140502405034050440505405064050740508405094051040511405124051340514405154051640517405184051940520405214052240523405244052540526405274052840529405304053140532405334053440535405364053740538405394054040541405424054340544405454054640547405484054940550405514055240553405544055540556405574055840559405604056140562405634056440565405664056740568405694057040571405724057340574405754057640577405784057940580405814058240583405844058540586405874058840589405904059140592405934059440595405964059740598405994060040601406024060340604406054060640607406084060940610406114061240613406144061540616406174061840619406204062140622406234062440625406264062740628406294063040631406324063340634406354063640637406384063940640406414064240643406444064540646406474064840649406504065140652406534065440655406564065740658406594066040661406624066340664406654066640667406684066940670406714067240673406744067540676406774067840679406804068140682406834068440685406864068740688406894069040691406924069340694406954069640697406984069940700407014070240703407044070540706407074070840709407104071140712407134071440715407164071740718407194072040721407224072340724407254072640727407284072940730407314073240733407344073540736407374073840739407404074140742407434074440745407464074740748407494075040751407524075340754407554075640757407584075940760407614076240763407644076540766407674076840769407704077140772407734077440775407764077740778407794078040781407824078340784407854078640787407884078940790407914079240793407944079540796407974079840799408004080140802408034080440805408064080740808408094081040811408124081340814408154081640817408184081940820408214082240823408244082540826408274082840829408304083140832408334083440835408364083740838408394084040841408424084340844408454084640847408484084940850408514085240853408544085540856408574085840859408604086140862408634086440865408664086740868408694087040871408724087340874408754087640877408784087940880408814088240883408844088540886408874088840889408904089140892408934089440895408964089740898408994090040901409024090340904409054090640907409084090940910409114091240913409144091540916409174091840919409204092140922409234092440925409264092740928409294093040931409324093340934409354093640937409384093940940409414094240943409444094540946409474094840949409504095140952409534095440955409564095740958409594096040961409624096340964409654096640967409684096940970409714097240973409744097540976409774097840979409804098140982409834098440985409864098740988409894099040991409924099340994409954099640997409984099941000410014100241003410044100541006410074100841009410104101141012410134101441015410164101741018410194102041021410224102341024410254102641027410284102941030410314103241033410344103541036410374103841039410404104141042410434104441045410464104741048410494105041051410524105341054410554105641057410584105941060410614106241063410644106541066410674106841069410704107141072410734107441075410764107741078410794108041081410824108341084410854108641087410884108941090410914109241093410944109541096410974109841099411004110141102411034110441105411064110741108411094111041111411124111341114411154111641117411184111941120411214112241123411244112541126411274112841129411304113141132411334113441135411364113741138411394114041141411424114341144411454114641147411484114941150411514115241153411544115541156411574115841159411604116141162411634116441165411664116741168411694117041171411724117341174411754117641177411784117941180411814118241183411844118541186411874118841189411904119141192411934119441195411964119741198411994120041201412024120341204412054120641207412084120941210412114121241213412144121541216412174121841219412204122141222412234122441225412264122741228412294123041231412324123341234412354123641237412384123941240412414124241243412444124541246412474124841249412504125141252412534125441255412564125741258412594126041261412624126341264412654126641267412684126941270412714127241273412744127541276412774127841279412804128141282412834128441285412864128741288412894129041291412924129341294412954129641297412984129941300413014130241303413044130541306413074130841309413104131141312413134131441315413164131741318413194132041321413224132341324413254132641327413284132941330413314133241333413344133541336413374133841339413404134141342413434134441345413464134741348413494135041351413524135341354413554135641357413584135941360413614136241363413644136541366413674136841369413704137141372413734137441375413764137741378413794138041381413824138341384413854138641387413884138941390413914139241393413944139541396413974139841399414004140141402414034140441405414064140741408414094141041411414124141341414414154141641417414184141941420414214142241423414244142541426414274142841429414304143141432414334143441435414364143741438414394144041441414424144341444414454144641447414484144941450414514145241453414544145541456414574145841459414604146141462414634146441465414664146741468414694147041471414724147341474414754147641477414784147941480414814148241483414844148541486414874148841489414904149141492414934149441495414964149741498414994150041501415024150341504415054150641507415084150941510415114151241513415144151541516415174151841519415204152141522415234152441525415264152741528415294153041531415324153341534415354153641537415384153941540415414154241543415444154541546415474154841549415504155141552415534155441555415564155741558415594156041561415624156341564415654156641567415684156941570415714157241573415744157541576415774157841579415804158141582415834158441585415864158741588415894159041591415924159341594415954159641597415984159941600416014160241603416044160541606416074160841609416104161141612416134161441615416164161741618416194162041621416224162341624416254162641627416284162941630416314163241633416344163541636416374163841639416404164141642416434164441645416464164741648416494165041651416524165341654416554165641657416584165941660416614166241663416644166541666416674166841669416704167141672416734167441675416764167741678416794168041681416824168341684416854168641687416884168941690416914169241693416944169541696416974169841699417004170141702417034170441705417064170741708417094171041711417124171341714417154171641717417184171941720417214172241723417244172541726417274172841729417304173141732417334173441735417364173741738417394174041741417424174341744417454174641747417484174941750417514175241753417544175541756417574175841759417604176141762417634176441765417664176741768417694177041771417724177341774417754177641777417784177941780417814178241783417844178541786417874178841789417904179141792417934179441795417964179741798417994180041801418024180341804418054180641807418084180941810418114181241813418144181541816418174181841819418204182141822418234182441825418264182741828418294183041831418324183341834418354183641837418384183941840418414184241843418444184541846418474184841849418504185141852418534185441855418564185741858418594186041861418624186341864418654186641867418684186941870418714187241873418744187541876418774187841879418804188141882418834188441885418864188741888418894189041891418924189341894418954189641897418984189941900419014190241903419044190541906419074190841909419104191141912419134191441915419164191741918419194192041921419224192341924419254192641927419284192941930419314193241933419344193541936419374193841939419404194141942419434194441945419464194741948419494195041951419524195341954419554195641957419584195941960419614196241963419644196541966419674196841969419704197141972419734197441975419764197741978419794198041981419824198341984419854198641987419884198941990419914199241993419944199541996419974199841999420004200142002420034200442005420064200742008420094201042011420124201342014420154201642017420184201942020420214202242023420244202542026420274202842029420304203142032420334203442035420364203742038420394204042041420424204342044420454204642047420484204942050420514205242053420544205542056420574205842059420604206142062420634206442065420664206742068420694207042071420724207342074420754207642077420784207942080420814208242083420844208542086420874208842089420904209142092420934209442095420964209742098420994210042101421024210342104421054210642107421084210942110421114211242113 |
- // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
- package s3
- import (
- "bytes"
- "fmt"
- "io"
- "sync"
- "time"
- "github.com/aws/aws-sdk-go/aws"
- "github.com/aws/aws-sdk-go/aws/awserr"
- "github.com/aws/aws-sdk-go/aws/awsutil"
- "github.com/aws/aws-sdk-go/aws/client"
- "github.com/aws/aws-sdk-go/aws/request"
- "github.com/aws/aws-sdk-go/aws/signer/v4"
- "github.com/aws/aws-sdk-go/internal/s3shared/arn"
- "github.com/aws/aws-sdk-go/private/checksum"
- "github.com/aws/aws-sdk-go/private/protocol"
- "github.com/aws/aws-sdk-go/private/protocol/eventstream"
- "github.com/aws/aws-sdk-go/private/protocol/eventstream/eventstreamapi"
- "github.com/aws/aws-sdk-go/private/protocol/rest"
- "github.com/aws/aws-sdk-go/private/protocol/restxml"
- )
- const opAbortMultipartUpload = "AbortMultipartUpload"
- // AbortMultipartUploadRequest generates a "aws/request.Request" representing the
- // client's request for the AbortMultipartUpload 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 AbortMultipartUpload for more information on using the AbortMultipartUpload
- // 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 AbortMultipartUploadRequest method.
- // req, resp := client.AbortMultipartUploadRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/AbortMultipartUpload
- func (c *S3) AbortMultipartUploadRequest(input *AbortMultipartUploadInput) (req *request.Request, output *AbortMultipartUploadOutput) {
- op := &request.Operation{
- Name: opAbortMultipartUpload,
- HTTPMethod: "DELETE",
- HTTPPath: "/{Bucket}/{Key+}",
- }
- if input == nil {
- input = &AbortMultipartUploadInput{}
- }
- output = &AbortMultipartUploadOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // AbortMultipartUpload API operation for Amazon Simple Storage Service.
- //
- // This action aborts a multipart upload. After a multipart upload is aborted,
- // no additional parts can be uploaded using that upload ID. The storage consumed
- // by any previously uploaded parts will be freed. However, if any part uploads
- // are currently in progress, those part uploads might or might not succeed.
- // As a result, it might be necessary to abort a given multipart upload multiple
- // times in order to completely free all storage consumed by all parts.
- //
- // To verify that all parts have been removed, so you don't get charged for
- // the part storage, you should call the ListParts (https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html)
- // action and ensure that the parts list is empty.
- //
- // For information about permissions required to use the multipart upload, see
- // Multipart Upload and Permissions (https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html).
- //
- // The following operations are related to AbortMultipartUpload:
- //
- // - CreateMultipartUpload (https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html)
- //
- // - UploadPart (https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html)
- //
- // - CompleteMultipartUpload (https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html)
- //
- // - ListParts (https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html)
- //
- // - ListMultipartUploads (https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation AbortMultipartUpload for usage and error information.
- //
- // Returned Error Codes:
- // - ErrCodeNoSuchUpload "NoSuchUpload"
- // The specified multipart upload does not exist.
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/AbortMultipartUpload
- func (c *S3) AbortMultipartUpload(input *AbortMultipartUploadInput) (*AbortMultipartUploadOutput, error) {
- req, out := c.AbortMultipartUploadRequest(input)
- return out, req.Send()
- }
- // AbortMultipartUploadWithContext is the same as AbortMultipartUpload with the addition of
- // the ability to pass a context and additional request options.
- //
- // See AbortMultipartUpload 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 *S3) AbortMultipartUploadWithContext(ctx aws.Context, input *AbortMultipartUploadInput, opts ...request.Option) (*AbortMultipartUploadOutput, error) {
- req, out := c.AbortMultipartUploadRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opCompleteMultipartUpload = "CompleteMultipartUpload"
- // CompleteMultipartUploadRequest generates a "aws/request.Request" representing the
- // client's request for the CompleteMultipartUpload 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 CompleteMultipartUpload for more information on using the CompleteMultipartUpload
- // 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 CompleteMultipartUploadRequest method.
- // req, resp := client.CompleteMultipartUploadRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/CompleteMultipartUpload
- func (c *S3) CompleteMultipartUploadRequest(input *CompleteMultipartUploadInput) (req *request.Request, output *CompleteMultipartUploadOutput) {
- op := &request.Operation{
- Name: opCompleteMultipartUpload,
- HTTPMethod: "POST",
- HTTPPath: "/{Bucket}/{Key+}",
- }
- if input == nil {
- input = &CompleteMultipartUploadInput{}
- }
- output = &CompleteMultipartUploadOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // CompleteMultipartUpload API operation for Amazon Simple Storage Service.
- //
- // Completes a multipart upload by assembling previously uploaded parts.
- //
- // You first initiate the multipart upload and then upload all parts using the
- // UploadPart (https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html)
- // operation. After successfully uploading all relevant parts of an upload,
- // you call this action to complete the upload. Upon receiving this request,
- // Amazon S3 concatenates all the parts in ascending order by part number to
- // create a new object. In the Complete Multipart Upload request, you must provide
- // the parts list. You must ensure that the parts list is complete. This action
- // concatenates the parts that you provide in the list. For each part in the
- // list, you must provide the part number and the ETag value, returned after
- // that part was uploaded.
- //
- // Processing of a Complete Multipart Upload request could take several minutes
- // to complete. After Amazon S3 begins processing the request, it sends an HTTP
- // response header that specifies a 200 OK response. While processing is in
- // progress, Amazon S3 periodically sends white space characters to keep the
- // connection from timing out. Because a request could fail after the initial
- // 200 OK response has been sent, it is important that you check the response
- // body to determine whether the request succeeded.
- //
- // Note that if CompleteMultipartUpload fails, applications should be prepared
- // to retry the failed requests. For more information, see Amazon S3 Error Best
- // Practices (https://docs.aws.amazon.com/AmazonS3/latest/dev/ErrorBestPractices.html).
- //
- // You cannot use Content-Type: application/x-www-form-urlencoded with Complete
- // Multipart Upload requests. Also, if you do not provide a Content-Type header,
- // CompleteMultipartUpload returns a 200 OK response.
- //
- // For more information about multipart uploads, see Uploading Objects Using
- // Multipart Upload (https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html).
- //
- // For information about permissions required to use the multipart upload API,
- // see Multipart Upload and Permissions (https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html).
- //
- // CompleteMultipartUpload has the following special errors:
- //
- // - Error code: EntityTooSmall Description: Your proposed upload is smaller
- // than the minimum allowed object size. Each part must be at least 5 MB
- // in size, except the last part. 400 Bad Request
- //
- // - Error code: InvalidPart Description: One or more of the specified parts
- // could not be found. The part might not have been uploaded, or the specified
- // entity tag might not have matched the part's entity tag. 400 Bad Request
- //
- // - Error code: InvalidPartOrder Description: The list of parts was not
- // in ascending order. The parts list must be specified in order by part
- // number. 400 Bad Request
- //
- // - Error code: NoSuchUpload Description: The specified multipart upload
- // does not exist. The upload ID might be invalid, or the multipart upload
- // might have been aborted or completed. 404 Not Found
- //
- // The following operations are related to CompleteMultipartUpload:
- //
- // - CreateMultipartUpload (https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html)
- //
- // - UploadPart (https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html)
- //
- // - AbortMultipartUpload (https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html)
- //
- // - ListParts (https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html)
- //
- // - ListMultipartUploads (https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation CompleteMultipartUpload for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/CompleteMultipartUpload
- func (c *S3) CompleteMultipartUpload(input *CompleteMultipartUploadInput) (*CompleteMultipartUploadOutput, error) {
- req, out := c.CompleteMultipartUploadRequest(input)
- return out, req.Send()
- }
- // CompleteMultipartUploadWithContext is the same as CompleteMultipartUpload with the addition of
- // the ability to pass a context and additional request options.
- //
- // See CompleteMultipartUpload 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 *S3) CompleteMultipartUploadWithContext(ctx aws.Context, input *CompleteMultipartUploadInput, opts ...request.Option) (*CompleteMultipartUploadOutput, error) {
- req, out := c.CompleteMultipartUploadRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opCopyObject = "CopyObject"
- // CopyObjectRequest generates a "aws/request.Request" representing the
- // client's request for the CopyObject 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 CopyObject for more information on using the CopyObject
- // 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 CopyObjectRequest method.
- // req, resp := client.CopyObjectRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/CopyObject
- func (c *S3) CopyObjectRequest(input *CopyObjectInput) (req *request.Request, output *CopyObjectOutput) {
- op := &request.Operation{
- Name: opCopyObject,
- HTTPMethod: "PUT",
- HTTPPath: "/{Bucket}/{Key+}",
- }
- if input == nil {
- input = &CopyObjectInput{}
- }
- output = &CopyObjectOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // CopyObject API operation for Amazon Simple Storage Service.
- //
- // Creates a copy of an object that is already stored in Amazon S3.
- //
- // You can store individual objects of up to 5 TB in Amazon S3. You create a
- // copy of your object up to 5 GB in size in a single atomic action using this
- // API. However, to copy an object greater than 5 GB, you must use the multipart
- // upload Upload Part - Copy (UploadPartCopy) API. For more information, see
- // Copy Object Using the REST Multipart Upload API (https://docs.aws.amazon.com/AmazonS3/latest/dev/CopyingObjctsUsingRESTMPUapi.html).
- //
- // All copy requests must be authenticated. Additionally, you must have read
- // access to the source object and write access to the destination bucket. For
- // more information, see REST Authentication (https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html).
- // Both the Region that you want to copy the object from and the Region that
- // you want to copy the object to must be enabled for your account.
- //
- // A copy request might return an error when Amazon S3 receives the copy request
- // or while Amazon S3 is copying the files. If the error occurs before the copy
- // action starts, you receive a standard Amazon S3 error. If the error occurs
- // during the copy operation, the error response is embedded in the 200 OK response.
- // This means that a 200 OK response can contain either a success or an error.
- // Design your application to parse the contents of the response and handle
- // it appropriately.
- //
- // If the copy is successful, you receive a response with information about
- // the copied object.
- //
- // If the request is an HTTP 1.1 request, the response is chunk encoded. If
- // it were not, it would not contain the content-length, and you would need
- // to read the entire body.
- //
- // The copy request charge is based on the storage class and Region that you
- // specify for the destination object. For pricing information, see Amazon S3
- // pricing (http://aws.amazon.com/s3/pricing/).
- //
- // Amazon S3 transfer acceleration does not support cross-Region copies. If
- // you request a cross-Region copy using a transfer acceleration endpoint, you
- // get a 400 Bad Request error. For more information, see Transfer Acceleration
- // (https://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration.html).
- //
- // # Metadata
- //
- // When copying an object, you can preserve all metadata (default) or specify
- // new metadata. However, the ACL is not preserved and is set to private for
- // the user making the request. To override the default ACL setting, specify
- // a new ACL when generating a copy request. For more information, see Using
- // ACLs (https://docs.aws.amazon.com/AmazonS3/latest/dev/S3_ACLs_UsingACLs.html).
- //
- // To specify whether you want the object metadata copied from the source object
- // or replaced with metadata provided in the request, you can optionally add
- // the x-amz-metadata-directive header. When you grant permissions, you can
- // use the s3:x-amz-metadata-directive condition key to enforce certain metadata
- // behavior when objects are uploaded. For more information, see Specifying
- // Conditions in a Policy (https://docs.aws.amazon.com/AmazonS3/latest/dev/amazon-s3-policy-keys.html)
- // in the Amazon S3 User Guide. For a complete list of Amazon S3-specific condition
- // keys, see Actions, Resources, and Condition Keys for Amazon S3 (https://docs.aws.amazon.com/AmazonS3/latest/dev/list_amazons3.html).
- //
- // x-amz-copy-source-if Headers
- //
- // To only copy an object under certain conditions, such as whether the Etag
- // matches or whether the object was modified before or after a specified date,
- // use the following request parameters:
- //
- // - x-amz-copy-source-if-match
- //
- // - x-amz-copy-source-if-none-match
- //
- // - x-amz-copy-source-if-unmodified-since
- //
- // - x-amz-copy-source-if-modified-since
- //
- // If both the x-amz-copy-source-if-match and x-amz-copy-source-if-unmodified-since
- // headers are present in the request and evaluate as follows, Amazon S3 returns
- // 200 OK and copies the data:
- //
- // - x-amz-copy-source-if-match condition evaluates to true
- //
- // - x-amz-copy-source-if-unmodified-since condition evaluates to false
- //
- // If both the x-amz-copy-source-if-none-match and x-amz-copy-source-if-modified-since
- // headers are present in the request and evaluate as follows, Amazon S3 returns
- // the 412 Precondition Failed response code:
- //
- // - x-amz-copy-source-if-none-match condition evaluates to false
- //
- // - x-amz-copy-source-if-modified-since condition evaluates to true
- //
- // All headers with the x-amz- prefix, including x-amz-copy-source, must be
- // signed.
- //
- // # Server-side encryption
- //
- // When you perform a CopyObject operation, you can optionally use the appropriate
- // encryption-related headers to encrypt the object using server-side encryption
- // with Amazon Web Services managed encryption keys (SSE-S3 or SSE-KMS) or a
- // customer-provided encryption key. With server-side encryption, Amazon S3
- // encrypts your data as it writes it to disks in its data centers and decrypts
- // the data when you access it. For more information about server-side encryption,
- // see Using Server-Side Encryption (https://docs.aws.amazon.com/AmazonS3/latest/dev/serv-side-encryption.html).
- //
- // If a target object uses SSE-KMS, you can enable an S3 Bucket Key for the
- // object. For more information, see Amazon S3 Bucket Keys (https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-key.html)
- // in the Amazon S3 User Guide.
- //
- // # Access Control List (ACL)-Specific Request Headers
- //
- // When copying an object, you can optionally use headers to grant ACL-based
- // permissions. By default, all objects are private. Only the owner has full
- // access control. When adding a new object, you can grant permissions to individual
- // Amazon Web Services accounts or to predefined groups defined by Amazon S3.
- // These permissions are then added to the ACL on the object. For more information,
- // see Access Control List (ACL) Overview (https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html)
- // and Managing ACLs Using the REST API (https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-using-rest-api.html).
- //
- // If the bucket that you're copying objects to uses the bucket owner enforced
- // setting for S3 Object Ownership, ACLs are disabled and no longer affect permissions.
- // Buckets that use this setting only accept PUT requests that don't specify
- // an ACL or PUT requests that specify bucket owner full control ACLs, such
- // as the bucket-owner-full-control canned ACL or an equivalent form of this
- // ACL expressed in the XML format.
- //
- // For more information, see Controlling ownership of objects and disabling
- // ACLs (https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html)
- // in the Amazon S3 User Guide.
- //
- // If your bucket uses the bucket owner enforced setting for Object Ownership,
- // all objects written to the bucket by any account will be owned by the bucket
- // owner.
- //
- // # Checksums
- //
- // When copying an object, if it has a checksum, that checksum will be copied
- // to the new object by default. When you copy the object over, you may optionally
- // specify a different checksum algorithm to use with the x-amz-checksum-algorithm
- // header.
- //
- // # Storage Class Options
- //
- // You can use the CopyObject action to change the storage class of an object
- // that is already stored in Amazon S3 using the StorageClass parameter. For
- // more information, see Storage Classes (https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html)
- // in the Amazon S3 User Guide.
- //
- // # Versioning
- //
- // By default, x-amz-copy-source identifies the current version of an object
- // to copy. If the current version is a delete marker, Amazon S3 behaves as
- // if the object was deleted. To copy a different version, use the versionId
- // subresource.
- //
- // If you enable versioning on the target bucket, Amazon S3 generates a unique
- // version ID for the object being copied. This version ID is different from
- // the version ID of the source object. Amazon S3 returns the version ID of
- // the copied object in the x-amz-version-id response header in the response.
- //
- // If you do not enable versioning or suspend it on the target bucket, the version
- // ID that Amazon S3 generates is always null.
- //
- // If the source object's storage class is GLACIER, you must restore a copy
- // of this object before you can use it as a source object for the copy operation.
- // For more information, see RestoreObject (https://docs.aws.amazon.com/AmazonS3/latest/API/API_RestoreObject.html).
- //
- // The following operations are related to CopyObject:
- //
- // - PutObject (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html)
- //
- // - GetObject (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html)
- //
- // For more information, see Copying Objects (https://docs.aws.amazon.com/AmazonS3/latest/dev/CopyingObjectsExamples.html).
- //
- // 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 Amazon Simple Storage Service's
- // API operation CopyObject for usage and error information.
- //
- // Returned Error Codes:
- // - ErrCodeObjectNotInActiveTierError "ObjectNotInActiveTierError"
- // The source object of the COPY action is not in the active tier and is only
- // stored in Amazon S3 Glacier.
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/CopyObject
- func (c *S3) CopyObject(input *CopyObjectInput) (*CopyObjectOutput, error) {
- req, out := c.CopyObjectRequest(input)
- return out, req.Send()
- }
- // CopyObjectWithContext is the same as CopyObject with the addition of
- // the ability to pass a context and additional request options.
- //
- // See CopyObject 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 *S3) CopyObjectWithContext(ctx aws.Context, input *CopyObjectInput, opts ...request.Option) (*CopyObjectOutput, error) {
- req, out := c.CopyObjectRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opCreateBucket = "CreateBucket"
- // CreateBucketRequest generates a "aws/request.Request" representing the
- // client's request for the CreateBucket 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 CreateBucket for more information on using the CreateBucket
- // 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 CreateBucketRequest method.
- // req, resp := client.CreateBucketRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/CreateBucket
- func (c *S3) CreateBucketRequest(input *CreateBucketInput) (req *request.Request, output *CreateBucketOutput) {
- op := &request.Operation{
- Name: opCreateBucket,
- HTTPMethod: "PUT",
- HTTPPath: "/{Bucket}",
- }
- if input == nil {
- input = &CreateBucketInput{}
- }
- output = &CreateBucketOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // CreateBucket API operation for Amazon Simple Storage Service.
- //
- // Creates a new S3 bucket. To create a bucket, you must register with Amazon
- // S3 and have a valid Amazon Web Services Access Key ID to authenticate requests.
- // Anonymous requests are never allowed to create buckets. By creating the bucket,
- // you become the bucket owner.
- //
- // Not every string is an acceptable bucket name. For information about bucket
- // naming restrictions, see Bucket naming rules (https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucketnamingrules.html).
- //
- // If you want to create an Amazon S3 on Outposts bucket, see Create Bucket
- // (https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_CreateBucket.html).
- //
- // By default, the bucket is created in the US East (N. Virginia) Region. You
- // can optionally specify a Region in the request body. You might choose a Region
- // to optimize latency, minimize costs, or address regulatory requirements.
- // For example, if you reside in Europe, you will probably find it advantageous
- // to create buckets in the Europe (Ireland) Region. For more information, see
- // Accessing a bucket (https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingBucket.html#access-bucket-intro).
- //
- // If you send your create bucket request to the s3.amazonaws.com endpoint,
- // the request goes to the us-east-1 Region. Accordingly, the signature calculations
- // in Signature Version 4 must use us-east-1 as the Region, even if the location
- // constraint in the request specifies another Region where the bucket is to
- // be created. If you create a bucket in a Region other than US East (N. Virginia),
- // your application must be able to handle 307 redirect. For more information,
- // see Virtual hosting of buckets (https://docs.aws.amazon.com/AmazonS3/latest/dev/VirtualHosting.html).
- //
- // Access control lists (ACLs)
- //
- // When creating a bucket using this operation, you can optionally configure
- // the bucket ACL to specify the accounts or groups that should be granted specific
- // permissions on the bucket.
- //
- // If your CreateBucket request sets bucket owner enforced for S3 Object Ownership
- // and specifies a bucket ACL that provides access to an external Amazon Web
- // Services account, your request fails with a 400 error and returns the InvalidBucketAclWithObjectOwnership
- // error code. For more information, see Controlling object ownership (https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html)
- // in the Amazon S3 User Guide.
- //
- // There are two ways to grant the appropriate permissions using the request
- // headers.
- //
- // - Specify a canned ACL using the x-amz-acl request header. Amazon S3 supports
- // a set of predefined ACLs, known as canned ACLs. Each canned ACL has a
- // predefined set of grantees and permissions. For more information, see
- // Canned ACL (https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL).
- //
- // - Specify access permissions explicitly using the x-amz-grant-read, x-amz-grant-write,
- // x-amz-grant-read-acp, x-amz-grant-write-acp, and x-amz-grant-full-control
- // headers. These headers map to the set of permissions Amazon S3 supports
- // in an ACL. For more information, see Access control list (ACL) overview
- // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/acl-overview.html).
- // You specify each grantee as a type=value pair, where the type is one of
- // the following: id – if the value specified is the canonical user ID
- // of an Amazon Web Services account uri – if you are granting permissions
- // to a predefined group emailAddress – if the value specified is the email
- // address of an Amazon Web Services account Using email addresses to specify
- // a grantee is only supported in the following Amazon Web Services Regions:
- // US East (N. Virginia) US West (N. California) US West (Oregon) Asia Pacific
- // (Singapore) Asia Pacific (Sydney) Asia Pacific (Tokyo) Europe (Ireland)
- // South America (São Paulo) For a list of all the Amazon S3 supported Regions
- // and endpoints, see Regions and Endpoints (https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region)
- // in the Amazon Web Services General Reference. For example, the following
- // x-amz-grant-read header grants the Amazon Web Services accounts identified
- // by account IDs permissions to read object data and its metadata: x-amz-grant-read:
- // id="11112222333", id="444455556666"
- //
- // You can use either a canned ACL or specify access permissions explicitly.
- // You cannot do both.
- //
- // # Permissions
- //
- // In addition to s3:CreateBucket, the following permissions are required when
- // your CreateBucket includes specific headers:
- //
- // - ACLs - If your CreateBucket request specifies ACL permissions and the
- // ACL is public-read, public-read-write, authenticated-read, or if you specify
- // access permissions explicitly through any other ACL, both s3:CreateBucket
- // and s3:PutBucketAcl permissions are needed. If the ACL the CreateBucket
- // request is private or doesn't specify any ACLs, only s3:CreateBucket permission
- // is needed.
- //
- // - Object Lock - If ObjectLockEnabledForBucket is set to true in your CreateBucket
- // request, s3:PutBucketObjectLockConfiguration and s3:PutBucketVersioning
- // permissions are required.
- //
- // - S3 Object Ownership - If your CreateBucket request includes the the
- // x-amz-object-ownership header, s3:PutBucketOwnershipControls permission
- // is required.
- //
- // The following operations are related to CreateBucket:
- //
- // - PutObject (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html)
- //
- // - DeleteBucket (https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucket.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation CreateBucket for usage and error information.
- //
- // Returned Error Codes:
- //
- // - ErrCodeBucketAlreadyExists "BucketAlreadyExists"
- // The requested bucket name is not available. The bucket namespace is shared
- // by all users of the system. Select a different name and try again.
- //
- // - ErrCodeBucketAlreadyOwnedByYou "BucketAlreadyOwnedByYou"
- // The bucket you tried to create already exists, and you own it. Amazon S3
- // returns this error in all Amazon Web Services Regions except in the North
- // Virginia Region. For legacy compatibility, if you re-create an existing bucket
- // that you already own in the North Virginia Region, Amazon S3 returns 200
- // OK and resets the bucket access control lists (ACLs).
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/CreateBucket
- func (c *S3) CreateBucket(input *CreateBucketInput) (*CreateBucketOutput, error) {
- req, out := c.CreateBucketRequest(input)
- return out, req.Send()
- }
- // CreateBucketWithContext is the same as CreateBucket with the addition of
- // the ability to pass a context and additional request options.
- //
- // See CreateBucket 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 *S3) CreateBucketWithContext(ctx aws.Context, input *CreateBucketInput, opts ...request.Option) (*CreateBucketOutput, error) {
- req, out := c.CreateBucketRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opCreateMultipartUpload = "CreateMultipartUpload"
- // CreateMultipartUploadRequest generates a "aws/request.Request" representing the
- // client's request for the CreateMultipartUpload 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 CreateMultipartUpload for more information on using the CreateMultipartUpload
- // 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 CreateMultipartUploadRequest method.
- // req, resp := client.CreateMultipartUploadRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/CreateMultipartUpload
- func (c *S3) CreateMultipartUploadRequest(input *CreateMultipartUploadInput) (req *request.Request, output *CreateMultipartUploadOutput) {
- op := &request.Operation{
- Name: opCreateMultipartUpload,
- HTTPMethod: "POST",
- HTTPPath: "/{Bucket}/{Key+}?uploads",
- }
- if input == nil {
- input = &CreateMultipartUploadInput{}
- }
- output = &CreateMultipartUploadOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // CreateMultipartUpload API operation for Amazon Simple Storage Service.
- //
- // This action initiates a multipart upload and returns an upload ID. This upload
- // ID is used to associate all of the parts in the specific multipart upload.
- // You specify this upload ID in each of your subsequent upload part requests
- // (see UploadPart (https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html)).
- // You also include this upload ID in the final request to either complete or
- // abort the multipart upload request.
- //
- // For more information about multipart uploads, see Multipart Upload Overview
- // (https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html).
- //
- // If you have configured a lifecycle rule to abort incomplete multipart uploads,
- // the upload must complete within the number of days specified in the bucket
- // lifecycle configuration. Otherwise, the incomplete multipart upload becomes
- // eligible for an abort action and Amazon S3 aborts the multipart upload. For
- // more information, see Aborting Incomplete Multipart Uploads Using a Bucket
- // Lifecycle Policy (https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html#mpu-abort-incomplete-mpu-lifecycle-config).
- //
- // For information about the permissions required to use the multipart upload
- // API, see Multipart Upload and Permissions (https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html).
- //
- // For request signing, multipart upload is just a series of regular requests.
- // You initiate a multipart upload, send one or more requests to upload parts,
- // and then complete the multipart upload process. You sign each request individually.
- // There is nothing special about signing multipart upload requests. For more
- // information about signing, see Authenticating Requests (Amazon Web Services
- // Signature Version 4) (https://docs.aws.amazon.com/AmazonS3/latest/API/sig-v4-authenticating-requests.html).
- //
- // After you initiate a multipart upload and upload one or more parts, to stop
- // being charged for storing the uploaded parts, you must either complete or
- // abort the multipart upload. Amazon S3 frees up the space used to store the
- // parts and stop charging you for storing them only after you either complete
- // or abort a multipart upload.
- //
- // You can optionally request server-side encryption. For server-side encryption,
- // Amazon S3 encrypts your data as it writes it to disks in its data centers
- // and decrypts it when you access it. You can provide your own encryption key,
- // or use Amazon Web Services KMS keys or Amazon S3-managed encryption keys.
- // If you choose to provide your own encryption key, the request headers you
- // provide in UploadPart (https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html)
- // and UploadPartCopy (https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html)
- // requests must match the headers you used in the request to initiate the upload
- // by using CreateMultipartUpload.
- //
- // To perform a multipart upload with encryption using an Amazon Web Services
- // KMS key, the requester must have permission to the kms:Decrypt and kms:GenerateDataKey*
- // actions on the key. These permissions are required because Amazon S3 must
- // decrypt and read data from the encrypted file parts before it completes the
- // multipart upload. For more information, see Multipart upload API and permissions
- // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/mpuoverview.html#mpuAndPermissions)
- // in the Amazon S3 User Guide.
- //
- // If your Identity and Access Management (IAM) user or role is in the same
- // Amazon Web Services account as the KMS key, then you must have these permissions
- // on the key policy. If your IAM user or role belongs to a different account
- // than the key, then you must have the permissions on both the key policy and
- // your IAM user or role.
- //
- // For more information, see Protecting Data Using Server-Side Encryption (https://docs.aws.amazon.com/AmazonS3/latest/dev/serv-side-encryption.html).
- //
- // # Access Permissions
- //
- // When copying an object, you can optionally specify the accounts or groups
- // that should be granted specific permissions on the new object. There are
- // two ways to grant the permissions using the request headers:
- //
- // - Specify a canned ACL with the x-amz-acl request header. For more information,
- // see Canned ACL (https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL).
- //
- // - Specify access permissions explicitly with the x-amz-grant-read, x-amz-grant-read-acp,
- // x-amz-grant-write-acp, and x-amz-grant-full-control headers. These parameters
- // map to the set of permissions that Amazon S3 supports in an ACL. For more
- // information, see Access Control List (ACL) Overview (https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html).
- //
- // You can use either a canned ACL or specify access permissions explicitly.
- // You cannot do both.
- //
- // # Server-Side- Encryption-Specific Request Headers
- //
- // You can optionally tell Amazon S3 to encrypt data at rest using server-side
- // encryption. Server-side encryption is for data encryption at rest. Amazon
- // S3 encrypts your data as it writes it to disks in its data centers and decrypts
- // it when you access it. The option you use depends on whether you want to
- // use Amazon Web Services managed encryption keys or provide your own encryption
- // key.
- //
- // - Use encryption keys managed by Amazon S3 or customer managed key stored
- // in Amazon Web Services Key Management Service (Amazon Web Services KMS)
- // – If you want Amazon Web Services to manage the keys used to encrypt
- // data, specify the following headers in the request. x-amz-server-side-encryption
- // x-amz-server-side-encryption-aws-kms-key-id x-amz-server-side-encryption-context
- // If you specify x-amz-server-side-encryption:aws:kms, but don't provide
- // x-amz-server-side-encryption-aws-kms-key-id, Amazon S3 uses the Amazon
- // Web Services managed key in Amazon Web Services KMS to protect the data.
- // All GET and PUT requests for an object protected by Amazon Web Services
- // KMS fail if you don't make them with SSL or by using SigV4. For more information
- // about server-side encryption with KMS key (SSE-KMS), see Protecting Data
- // Using Server-Side Encryption with KMS keys (https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingKMSEncryption.html).
- //
- // - Use customer-provided encryption keys – If you want to manage your
- // own encryption keys, provide all the following headers in the request.
- // x-amz-server-side-encryption-customer-algorithm x-amz-server-side-encryption-customer-key
- // x-amz-server-side-encryption-customer-key-MD5 For more information about
- // server-side encryption with KMS keys (SSE-KMS), see Protecting Data Using
- // Server-Side Encryption with KMS keys (https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingKMSEncryption.html).
- //
- // # Access-Control-List (ACL)-Specific Request Headers
- //
- // You also can use the following access control–related headers with this
- // operation. By default, all objects are private. Only the owner has full access
- // control. When adding a new object, you can grant permissions to individual
- // Amazon Web Services accounts or to predefined groups defined by Amazon S3.
- // These permissions are then added to the access control list (ACL) on the
- // object. For more information, see Using ACLs (https://docs.aws.amazon.com/AmazonS3/latest/dev/S3_ACLs_UsingACLs.html).
- // With this operation, you can grant access permissions using one of the following
- // two methods:
- //
- // - Specify a canned ACL (x-amz-acl) — Amazon S3 supports a set of predefined
- // ACLs, known as canned ACLs. Each canned ACL has a predefined set of grantees
- // and permissions. For more information, see Canned ACL (https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL).
- //
- // - Specify access permissions explicitly — To explicitly grant access
- // permissions to specific Amazon Web Services accounts or groups, use the
- // following headers. Each header maps to specific permissions that Amazon
- // S3 supports in an ACL. For more information, see Access Control List (ACL)
- // Overview (https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html).
- // In the header, you specify a list of grantees who get the specific permission.
- // To grant permissions explicitly, use: x-amz-grant-read x-amz-grant-write
- // x-amz-grant-read-acp x-amz-grant-write-acp x-amz-grant-full-control You
- // specify each grantee as a type=value pair, where the type is one of the
- // following: id – if the value specified is the canonical user ID of an
- // Amazon Web Services account uri – if you are granting permissions to
- // a predefined group emailAddress – if the value specified is the email
- // address of an Amazon Web Services account Using email addresses to specify
- // a grantee is only supported in the following Amazon Web Services Regions:
- // US East (N. Virginia) US West (N. California) US West (Oregon) Asia Pacific
- // (Singapore) Asia Pacific (Sydney) Asia Pacific (Tokyo) Europe (Ireland)
- // South America (São Paulo) For a list of all the Amazon S3 supported Regions
- // and endpoints, see Regions and Endpoints (https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region)
- // in the Amazon Web Services General Reference. For example, the following
- // x-amz-grant-read header grants the Amazon Web Services accounts identified
- // by account IDs permissions to read object data and its metadata: x-amz-grant-read:
- // id="11112222333", id="444455556666"
- //
- // The following operations are related to CreateMultipartUpload:
- //
- // - UploadPart (https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html)
- //
- // - CompleteMultipartUpload (https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html)
- //
- // - AbortMultipartUpload (https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html)
- //
- // - ListParts (https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html)
- //
- // - ListMultipartUploads (https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation CreateMultipartUpload for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/CreateMultipartUpload
- func (c *S3) CreateMultipartUpload(input *CreateMultipartUploadInput) (*CreateMultipartUploadOutput, error) {
- req, out := c.CreateMultipartUploadRequest(input)
- return out, req.Send()
- }
- // CreateMultipartUploadWithContext is the same as CreateMultipartUpload with the addition of
- // the ability to pass a context and additional request options.
- //
- // See CreateMultipartUpload 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 *S3) CreateMultipartUploadWithContext(ctx aws.Context, input *CreateMultipartUploadInput, opts ...request.Option) (*CreateMultipartUploadOutput, error) {
- req, out := c.CreateMultipartUploadRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opDeleteBucket = "DeleteBucket"
- // DeleteBucketRequest generates a "aws/request.Request" representing the
- // client's request for the DeleteBucket 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 DeleteBucket for more information on using the DeleteBucket
- // 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 DeleteBucketRequest method.
- // req, resp := client.DeleteBucketRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucket
- func (c *S3) DeleteBucketRequest(input *DeleteBucketInput) (req *request.Request, output *DeleteBucketOutput) {
- op := &request.Operation{
- Name: opDeleteBucket,
- HTTPMethod: "DELETE",
- HTTPPath: "/{Bucket}",
- }
- if input == nil {
- input = &DeleteBucketInput{}
- }
- output = &DeleteBucketOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Swap(restxml.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler)
- return
- }
- // DeleteBucket API operation for Amazon Simple Storage Service.
- //
- // Deletes the S3 bucket. All objects (including all object versions and delete
- // markers) in the bucket must be deleted before the bucket itself can be deleted.
- //
- // Related Resources
- //
- // - CreateBucket (https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html)
- //
- // - DeleteObject (https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation DeleteBucket for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucket
- func (c *S3) DeleteBucket(input *DeleteBucketInput) (*DeleteBucketOutput, error) {
- req, out := c.DeleteBucketRequest(input)
- return out, req.Send()
- }
- // DeleteBucketWithContext is the same as DeleteBucket with the addition of
- // the ability to pass a context and additional request options.
- //
- // See DeleteBucket 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 *S3) DeleteBucketWithContext(ctx aws.Context, input *DeleteBucketInput, opts ...request.Option) (*DeleteBucketOutput, error) {
- req, out := c.DeleteBucketRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opDeleteBucketAnalyticsConfiguration = "DeleteBucketAnalyticsConfiguration"
- // DeleteBucketAnalyticsConfigurationRequest generates a "aws/request.Request" representing the
- // client's request for the DeleteBucketAnalyticsConfiguration 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 DeleteBucketAnalyticsConfiguration for more information on using the DeleteBucketAnalyticsConfiguration
- // 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 DeleteBucketAnalyticsConfigurationRequest method.
- // req, resp := client.DeleteBucketAnalyticsConfigurationRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketAnalyticsConfiguration
- func (c *S3) DeleteBucketAnalyticsConfigurationRequest(input *DeleteBucketAnalyticsConfigurationInput) (req *request.Request, output *DeleteBucketAnalyticsConfigurationOutput) {
- op := &request.Operation{
- Name: opDeleteBucketAnalyticsConfiguration,
- HTTPMethod: "DELETE",
- HTTPPath: "/{Bucket}?analytics",
- }
- if input == nil {
- input = &DeleteBucketAnalyticsConfigurationInput{}
- }
- output = &DeleteBucketAnalyticsConfigurationOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Swap(restxml.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler)
- return
- }
- // DeleteBucketAnalyticsConfiguration API operation for Amazon Simple Storage Service.
- //
- // Deletes an analytics configuration for the bucket (specified by the analytics
- // configuration ID).
- //
- // To use this operation, you must have permissions to perform the s3:PutAnalyticsConfiguration
- // action. The bucket owner has this permission by default. The bucket owner
- // can grant this permission to others. For more information about permissions,
- // see Permissions Related to Bucket Subresource Operations (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources)
- // and Managing Access Permissions to Your Amazon S3 Resources (https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html).
- //
- // For information about the Amazon S3 analytics feature, see Amazon S3 Analytics
- // – Storage Class Analysis (https://docs.aws.amazon.com/AmazonS3/latest/dev/analytics-storage-class.html).
- //
- // The following operations are related to DeleteBucketAnalyticsConfiguration:
- //
- // - GetBucketAnalyticsConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketAnalyticsConfiguration.html)
- //
- // - ListBucketAnalyticsConfigurations (https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBucketAnalyticsConfigurations.html)
- //
- // - PutBucketAnalyticsConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketAnalyticsConfiguration.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation DeleteBucketAnalyticsConfiguration for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketAnalyticsConfiguration
- func (c *S3) DeleteBucketAnalyticsConfiguration(input *DeleteBucketAnalyticsConfigurationInput) (*DeleteBucketAnalyticsConfigurationOutput, error) {
- req, out := c.DeleteBucketAnalyticsConfigurationRequest(input)
- return out, req.Send()
- }
- // DeleteBucketAnalyticsConfigurationWithContext is the same as DeleteBucketAnalyticsConfiguration with the addition of
- // the ability to pass a context and additional request options.
- //
- // See DeleteBucketAnalyticsConfiguration 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 *S3) DeleteBucketAnalyticsConfigurationWithContext(ctx aws.Context, input *DeleteBucketAnalyticsConfigurationInput, opts ...request.Option) (*DeleteBucketAnalyticsConfigurationOutput, error) {
- req, out := c.DeleteBucketAnalyticsConfigurationRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opDeleteBucketCors = "DeleteBucketCors"
- // DeleteBucketCorsRequest generates a "aws/request.Request" representing the
- // client's request for the DeleteBucketCors 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 DeleteBucketCors for more information on using the DeleteBucketCors
- // 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 DeleteBucketCorsRequest method.
- // req, resp := client.DeleteBucketCorsRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketCors
- func (c *S3) DeleteBucketCorsRequest(input *DeleteBucketCorsInput) (req *request.Request, output *DeleteBucketCorsOutput) {
- op := &request.Operation{
- Name: opDeleteBucketCors,
- HTTPMethod: "DELETE",
- HTTPPath: "/{Bucket}?cors",
- }
- if input == nil {
- input = &DeleteBucketCorsInput{}
- }
- output = &DeleteBucketCorsOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Swap(restxml.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler)
- return
- }
- // DeleteBucketCors API operation for Amazon Simple Storage Service.
- //
- // Deletes the cors configuration information set for the bucket.
- //
- // To use this operation, you must have permission to perform the s3:PutBucketCORS
- // action. The bucket owner has this permission by default and can grant this
- // permission to others.
- //
- // For information about cors, see Enabling Cross-Origin Resource Sharing (https://docs.aws.amazon.com/AmazonS3/latest/dev/cors.html)
- // in the Amazon S3 User Guide.
- //
- // Related Resources:
- //
- // - PutBucketCors (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketCors.html)
- //
- // - RESTOPTIONSobject (https://docs.aws.amazon.com/AmazonS3/latest/API/RESTOPTIONSobject.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation DeleteBucketCors for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketCors
- func (c *S3) DeleteBucketCors(input *DeleteBucketCorsInput) (*DeleteBucketCorsOutput, error) {
- req, out := c.DeleteBucketCorsRequest(input)
- return out, req.Send()
- }
- // DeleteBucketCorsWithContext is the same as DeleteBucketCors with the addition of
- // the ability to pass a context and additional request options.
- //
- // See DeleteBucketCors 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 *S3) DeleteBucketCorsWithContext(ctx aws.Context, input *DeleteBucketCorsInput, opts ...request.Option) (*DeleteBucketCorsOutput, error) {
- req, out := c.DeleteBucketCorsRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opDeleteBucketEncryption = "DeleteBucketEncryption"
- // DeleteBucketEncryptionRequest generates a "aws/request.Request" representing the
- // client's request for the DeleteBucketEncryption 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 DeleteBucketEncryption for more information on using the DeleteBucketEncryption
- // 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 DeleteBucketEncryptionRequest method.
- // req, resp := client.DeleteBucketEncryptionRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketEncryption
- func (c *S3) DeleteBucketEncryptionRequest(input *DeleteBucketEncryptionInput) (req *request.Request, output *DeleteBucketEncryptionOutput) {
- op := &request.Operation{
- Name: opDeleteBucketEncryption,
- HTTPMethod: "DELETE",
- HTTPPath: "/{Bucket}?encryption",
- }
- if input == nil {
- input = &DeleteBucketEncryptionInput{}
- }
- output = &DeleteBucketEncryptionOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Swap(restxml.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler)
- return
- }
- // DeleteBucketEncryption API operation for Amazon Simple Storage Service.
- //
- // This implementation of the DELETE action removes default encryption from
- // the bucket. For information about the Amazon S3 default encryption feature,
- // see Amazon S3 Default Bucket Encryption (https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html)
- // in the Amazon S3 User Guide.
- //
- // To use this operation, you must have permissions to perform the s3:PutEncryptionConfiguration
- // action. The bucket owner has this permission by default. The bucket owner
- // can grant this permission to others. For more information about permissions,
- // see Permissions Related to Bucket Subresource Operations (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources)
- // and Managing Access Permissions to your Amazon S3 Resources (https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html)
- // in the Amazon S3 User Guide.
- //
- // Related Resources
- //
- // - PutBucketEncryption (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketEncryption.html)
- //
- // - GetBucketEncryption (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketEncryption.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation DeleteBucketEncryption for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketEncryption
- func (c *S3) DeleteBucketEncryption(input *DeleteBucketEncryptionInput) (*DeleteBucketEncryptionOutput, error) {
- req, out := c.DeleteBucketEncryptionRequest(input)
- return out, req.Send()
- }
- // DeleteBucketEncryptionWithContext is the same as DeleteBucketEncryption with the addition of
- // the ability to pass a context and additional request options.
- //
- // See DeleteBucketEncryption 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 *S3) DeleteBucketEncryptionWithContext(ctx aws.Context, input *DeleteBucketEncryptionInput, opts ...request.Option) (*DeleteBucketEncryptionOutput, error) {
- req, out := c.DeleteBucketEncryptionRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opDeleteBucketIntelligentTieringConfiguration = "DeleteBucketIntelligentTieringConfiguration"
- // DeleteBucketIntelligentTieringConfigurationRequest generates a "aws/request.Request" representing the
- // client's request for the DeleteBucketIntelligentTieringConfiguration 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 DeleteBucketIntelligentTieringConfiguration for more information on using the DeleteBucketIntelligentTieringConfiguration
- // 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 DeleteBucketIntelligentTieringConfigurationRequest method.
- // req, resp := client.DeleteBucketIntelligentTieringConfigurationRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketIntelligentTieringConfiguration
- func (c *S3) DeleteBucketIntelligentTieringConfigurationRequest(input *DeleteBucketIntelligentTieringConfigurationInput) (req *request.Request, output *DeleteBucketIntelligentTieringConfigurationOutput) {
- op := &request.Operation{
- Name: opDeleteBucketIntelligentTieringConfiguration,
- HTTPMethod: "DELETE",
- HTTPPath: "/{Bucket}?intelligent-tiering",
- }
- if input == nil {
- input = &DeleteBucketIntelligentTieringConfigurationInput{}
- }
- output = &DeleteBucketIntelligentTieringConfigurationOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Swap(restxml.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler)
- return
- }
- // DeleteBucketIntelligentTieringConfiguration API operation for Amazon Simple Storage Service.
- //
- // Deletes the S3 Intelligent-Tiering configuration from the specified bucket.
- //
- // The S3 Intelligent-Tiering storage class is designed to optimize storage
- // costs by automatically moving data to the most cost-effective storage access
- // tier, without performance impact or operational overhead. S3 Intelligent-Tiering
- // delivers automatic cost savings in three low latency and high throughput
- // access tiers. To get the lowest storage cost on data that can be accessed
- // in minutes to hours, you can choose to activate additional archiving capabilities.
- //
- // The S3 Intelligent-Tiering storage class is the ideal storage class for data
- // with unknown, changing, or unpredictable access patterns, independent of
- // object size or retention period. If the size of an object is less than 128
- // KB, it is not monitored and not eligible for auto-tiering. Smaller objects
- // can be stored, but they are always charged at the Frequent Access tier rates
- // in the S3 Intelligent-Tiering storage class.
- //
- // For more information, see Storage class for automatically optimizing frequently
- // and infrequently accessed objects (https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html#sc-dynamic-data-access).
- //
- // Operations related to DeleteBucketIntelligentTieringConfiguration include:
- //
- // - GetBucketIntelligentTieringConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketIntelligentTieringConfiguration.html)
- //
- // - PutBucketIntelligentTieringConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketIntelligentTieringConfiguration.html)
- //
- // - ListBucketIntelligentTieringConfigurations (https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBucketIntelligentTieringConfigurations.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation DeleteBucketIntelligentTieringConfiguration for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketIntelligentTieringConfiguration
- func (c *S3) DeleteBucketIntelligentTieringConfiguration(input *DeleteBucketIntelligentTieringConfigurationInput) (*DeleteBucketIntelligentTieringConfigurationOutput, error) {
- req, out := c.DeleteBucketIntelligentTieringConfigurationRequest(input)
- return out, req.Send()
- }
- // DeleteBucketIntelligentTieringConfigurationWithContext is the same as DeleteBucketIntelligentTieringConfiguration with the addition of
- // the ability to pass a context and additional request options.
- //
- // See DeleteBucketIntelligentTieringConfiguration 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 *S3) DeleteBucketIntelligentTieringConfigurationWithContext(ctx aws.Context, input *DeleteBucketIntelligentTieringConfigurationInput, opts ...request.Option) (*DeleteBucketIntelligentTieringConfigurationOutput, error) {
- req, out := c.DeleteBucketIntelligentTieringConfigurationRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opDeleteBucketInventoryConfiguration = "DeleteBucketInventoryConfiguration"
- // DeleteBucketInventoryConfigurationRequest generates a "aws/request.Request" representing the
- // client's request for the DeleteBucketInventoryConfiguration 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 DeleteBucketInventoryConfiguration for more information on using the DeleteBucketInventoryConfiguration
- // 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 DeleteBucketInventoryConfigurationRequest method.
- // req, resp := client.DeleteBucketInventoryConfigurationRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketInventoryConfiguration
- func (c *S3) DeleteBucketInventoryConfigurationRequest(input *DeleteBucketInventoryConfigurationInput) (req *request.Request, output *DeleteBucketInventoryConfigurationOutput) {
- op := &request.Operation{
- Name: opDeleteBucketInventoryConfiguration,
- HTTPMethod: "DELETE",
- HTTPPath: "/{Bucket}?inventory",
- }
- if input == nil {
- input = &DeleteBucketInventoryConfigurationInput{}
- }
- output = &DeleteBucketInventoryConfigurationOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Swap(restxml.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler)
- return
- }
- // DeleteBucketInventoryConfiguration API operation for Amazon Simple Storage Service.
- //
- // Deletes an inventory configuration (identified by the inventory ID) from
- // the bucket.
- //
- // To use this operation, you must have permissions to perform the s3:PutInventoryConfiguration
- // action. The bucket owner has this permission by default. The bucket owner
- // can grant this permission to others. For more information about permissions,
- // see Permissions Related to Bucket Subresource Operations (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources)
- // and Managing Access Permissions to Your Amazon S3 Resources (https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html).
- //
- // For information about the Amazon S3 inventory feature, see Amazon S3 Inventory
- // (https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-inventory.html).
- //
- // Operations related to DeleteBucketInventoryConfiguration include:
- //
- // - GetBucketInventoryConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketInventoryConfiguration.html)
- //
- // - PutBucketInventoryConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketInventoryConfiguration.html)
- //
- // - ListBucketInventoryConfigurations (https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBucketInventoryConfigurations.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation DeleteBucketInventoryConfiguration for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketInventoryConfiguration
- func (c *S3) DeleteBucketInventoryConfiguration(input *DeleteBucketInventoryConfigurationInput) (*DeleteBucketInventoryConfigurationOutput, error) {
- req, out := c.DeleteBucketInventoryConfigurationRequest(input)
- return out, req.Send()
- }
- // DeleteBucketInventoryConfigurationWithContext is the same as DeleteBucketInventoryConfiguration with the addition of
- // the ability to pass a context and additional request options.
- //
- // See DeleteBucketInventoryConfiguration 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 *S3) DeleteBucketInventoryConfigurationWithContext(ctx aws.Context, input *DeleteBucketInventoryConfigurationInput, opts ...request.Option) (*DeleteBucketInventoryConfigurationOutput, error) {
- req, out := c.DeleteBucketInventoryConfigurationRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opDeleteBucketLifecycle = "DeleteBucketLifecycle"
- // DeleteBucketLifecycleRequest generates a "aws/request.Request" representing the
- // client's request for the DeleteBucketLifecycle 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 DeleteBucketLifecycle for more information on using the DeleteBucketLifecycle
- // 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 DeleteBucketLifecycleRequest method.
- // req, resp := client.DeleteBucketLifecycleRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketLifecycle
- func (c *S3) DeleteBucketLifecycleRequest(input *DeleteBucketLifecycleInput) (req *request.Request, output *DeleteBucketLifecycleOutput) {
- op := &request.Operation{
- Name: opDeleteBucketLifecycle,
- HTTPMethod: "DELETE",
- HTTPPath: "/{Bucket}?lifecycle",
- }
- if input == nil {
- input = &DeleteBucketLifecycleInput{}
- }
- output = &DeleteBucketLifecycleOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Swap(restxml.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler)
- return
- }
- // DeleteBucketLifecycle API operation for Amazon Simple Storage Service.
- //
- // Deletes the lifecycle configuration from the specified bucket. Amazon S3
- // removes all the lifecycle configuration rules in the lifecycle subresource
- // associated with the bucket. Your objects never expire, and Amazon S3 no longer
- // automatically deletes any objects on the basis of rules contained in the
- // deleted lifecycle configuration.
- //
- // To use this operation, you must have permission to perform the s3:PutLifecycleConfiguration
- // action. By default, the bucket owner has this permission and the bucket owner
- // can grant this permission to others.
- //
- // There is usually some time lag before lifecycle configuration deletion is
- // fully propagated to all the Amazon S3 systems.
- //
- // For more information about the object expiration, see Elements to Describe
- // Lifecycle Actions (https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html#intro-lifecycle-rules-actions).
- //
- // Related actions include:
- //
- // - PutBucketLifecycleConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html)
- //
- // - GetBucketLifecycleConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation DeleteBucketLifecycle for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketLifecycle
- func (c *S3) DeleteBucketLifecycle(input *DeleteBucketLifecycleInput) (*DeleteBucketLifecycleOutput, error) {
- req, out := c.DeleteBucketLifecycleRequest(input)
- return out, req.Send()
- }
- // DeleteBucketLifecycleWithContext is the same as DeleteBucketLifecycle with the addition of
- // the ability to pass a context and additional request options.
- //
- // See DeleteBucketLifecycle 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 *S3) DeleteBucketLifecycleWithContext(ctx aws.Context, input *DeleteBucketLifecycleInput, opts ...request.Option) (*DeleteBucketLifecycleOutput, error) {
- req, out := c.DeleteBucketLifecycleRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opDeleteBucketMetricsConfiguration = "DeleteBucketMetricsConfiguration"
- // DeleteBucketMetricsConfigurationRequest generates a "aws/request.Request" representing the
- // client's request for the DeleteBucketMetricsConfiguration 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 DeleteBucketMetricsConfiguration for more information on using the DeleteBucketMetricsConfiguration
- // 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 DeleteBucketMetricsConfigurationRequest method.
- // req, resp := client.DeleteBucketMetricsConfigurationRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketMetricsConfiguration
- func (c *S3) DeleteBucketMetricsConfigurationRequest(input *DeleteBucketMetricsConfigurationInput) (req *request.Request, output *DeleteBucketMetricsConfigurationOutput) {
- op := &request.Operation{
- Name: opDeleteBucketMetricsConfiguration,
- HTTPMethod: "DELETE",
- HTTPPath: "/{Bucket}?metrics",
- }
- if input == nil {
- input = &DeleteBucketMetricsConfigurationInput{}
- }
- output = &DeleteBucketMetricsConfigurationOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Swap(restxml.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler)
- return
- }
- // DeleteBucketMetricsConfiguration API operation for Amazon Simple Storage Service.
- //
- // Deletes a metrics configuration for the Amazon CloudWatch request metrics
- // (specified by the metrics configuration ID) from the bucket. Note that this
- // doesn't include the daily storage metrics.
- //
- // To use this operation, you must have permissions to perform the s3:PutMetricsConfiguration
- // action. The bucket owner has this permission by default. The bucket owner
- // can grant this permission to others. For more information about permissions,
- // see Permissions Related to Bucket Subresource Operations (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources)
- // and Managing Access Permissions to Your Amazon S3 Resources (https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html).
- //
- // For information about CloudWatch request metrics for Amazon S3, see Monitoring
- // Metrics with Amazon CloudWatch (https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html).
- //
- // The following operations are related to DeleteBucketMetricsConfiguration:
- //
- // - GetBucketMetricsConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketMetricsConfiguration.html)
- //
- // - PutBucketMetricsConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketMetricsConfiguration.html)
- //
- // - ListBucketMetricsConfigurations (https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBucketMetricsConfigurations.html)
- //
- // - Monitoring Metrics with Amazon CloudWatch (https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation DeleteBucketMetricsConfiguration for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketMetricsConfiguration
- func (c *S3) DeleteBucketMetricsConfiguration(input *DeleteBucketMetricsConfigurationInput) (*DeleteBucketMetricsConfigurationOutput, error) {
- req, out := c.DeleteBucketMetricsConfigurationRequest(input)
- return out, req.Send()
- }
- // DeleteBucketMetricsConfigurationWithContext is the same as DeleteBucketMetricsConfiguration with the addition of
- // the ability to pass a context and additional request options.
- //
- // See DeleteBucketMetricsConfiguration 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 *S3) DeleteBucketMetricsConfigurationWithContext(ctx aws.Context, input *DeleteBucketMetricsConfigurationInput, opts ...request.Option) (*DeleteBucketMetricsConfigurationOutput, error) {
- req, out := c.DeleteBucketMetricsConfigurationRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opDeleteBucketOwnershipControls = "DeleteBucketOwnershipControls"
- // DeleteBucketOwnershipControlsRequest generates a "aws/request.Request" representing the
- // client's request for the DeleteBucketOwnershipControls 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 DeleteBucketOwnershipControls for more information on using the DeleteBucketOwnershipControls
- // 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 DeleteBucketOwnershipControlsRequest method.
- // req, resp := client.DeleteBucketOwnershipControlsRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketOwnershipControls
- func (c *S3) DeleteBucketOwnershipControlsRequest(input *DeleteBucketOwnershipControlsInput) (req *request.Request, output *DeleteBucketOwnershipControlsOutput) {
- op := &request.Operation{
- Name: opDeleteBucketOwnershipControls,
- HTTPMethod: "DELETE",
- HTTPPath: "/{Bucket}?ownershipControls",
- }
- if input == nil {
- input = &DeleteBucketOwnershipControlsInput{}
- }
- output = &DeleteBucketOwnershipControlsOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Swap(restxml.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler)
- return
- }
- // DeleteBucketOwnershipControls API operation for Amazon Simple Storage Service.
- //
- // Removes OwnershipControls for an Amazon S3 bucket. To use this operation,
- // you must have the s3:PutBucketOwnershipControls permission. For more information
- // about Amazon S3 permissions, see Specifying Permissions in a Policy (https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html).
- //
- // For information about Amazon S3 Object Ownership, see Using Object Ownership
- // (https://docs.aws.amazon.com/AmazonS3/latest/dev/about-object-ownership.html).
- //
- // The following operations are related to DeleteBucketOwnershipControls:
- //
- // - GetBucketOwnershipControls
- //
- // - PutBucketOwnershipControls
- //
- // 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 Amazon Simple Storage Service's
- // API operation DeleteBucketOwnershipControls for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketOwnershipControls
- func (c *S3) DeleteBucketOwnershipControls(input *DeleteBucketOwnershipControlsInput) (*DeleteBucketOwnershipControlsOutput, error) {
- req, out := c.DeleteBucketOwnershipControlsRequest(input)
- return out, req.Send()
- }
- // DeleteBucketOwnershipControlsWithContext is the same as DeleteBucketOwnershipControls with the addition of
- // the ability to pass a context and additional request options.
- //
- // See DeleteBucketOwnershipControls 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 *S3) DeleteBucketOwnershipControlsWithContext(ctx aws.Context, input *DeleteBucketOwnershipControlsInput, opts ...request.Option) (*DeleteBucketOwnershipControlsOutput, error) {
- req, out := c.DeleteBucketOwnershipControlsRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opDeleteBucketPolicy = "DeleteBucketPolicy"
- // DeleteBucketPolicyRequest generates a "aws/request.Request" representing the
- // client's request for the DeleteBucketPolicy 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 DeleteBucketPolicy for more information on using the DeleteBucketPolicy
- // 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 DeleteBucketPolicyRequest method.
- // req, resp := client.DeleteBucketPolicyRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketPolicy
- func (c *S3) DeleteBucketPolicyRequest(input *DeleteBucketPolicyInput) (req *request.Request, output *DeleteBucketPolicyOutput) {
- op := &request.Operation{
- Name: opDeleteBucketPolicy,
- HTTPMethod: "DELETE",
- HTTPPath: "/{Bucket}?policy",
- }
- if input == nil {
- input = &DeleteBucketPolicyInput{}
- }
- output = &DeleteBucketPolicyOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Swap(restxml.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler)
- return
- }
- // DeleteBucketPolicy API operation for Amazon Simple Storage Service.
- //
- // This implementation of the DELETE action uses the policy subresource to delete
- // the policy of a specified bucket. If you are using an identity other than
- // the root user of the Amazon Web Services account that owns the bucket, the
- // calling identity must have the DeleteBucketPolicy permissions on the specified
- // bucket and belong to the bucket owner's account to use this operation.
- //
- // If you don't have DeleteBucketPolicy permissions, Amazon S3 returns a 403
- // Access Denied error. If you have the correct permissions, but you're not
- // using an identity that belongs to the bucket owner's account, Amazon S3 returns
- // a 405 Method Not Allowed error.
- //
- // As a security precaution, the root user of the Amazon Web Services account
- // that owns a bucket can always use this operation, even if the policy explicitly
- // denies the root user the ability to perform this action.
- //
- // For more information about bucket policies, see Using Bucket Policies and
- // UserPolicies (https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html).
- //
- // The following operations are related to DeleteBucketPolicy
- //
- // - CreateBucket (https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html)
- //
- // - DeleteObject (https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation DeleteBucketPolicy for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketPolicy
- func (c *S3) DeleteBucketPolicy(input *DeleteBucketPolicyInput) (*DeleteBucketPolicyOutput, error) {
- req, out := c.DeleteBucketPolicyRequest(input)
- return out, req.Send()
- }
- // DeleteBucketPolicyWithContext is the same as DeleteBucketPolicy with the addition of
- // the ability to pass a context and additional request options.
- //
- // See DeleteBucketPolicy 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 *S3) DeleteBucketPolicyWithContext(ctx aws.Context, input *DeleteBucketPolicyInput, opts ...request.Option) (*DeleteBucketPolicyOutput, error) {
- req, out := c.DeleteBucketPolicyRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opDeleteBucketReplication = "DeleteBucketReplication"
- // DeleteBucketReplicationRequest generates a "aws/request.Request" representing the
- // client's request for the DeleteBucketReplication 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 DeleteBucketReplication for more information on using the DeleteBucketReplication
- // 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 DeleteBucketReplicationRequest method.
- // req, resp := client.DeleteBucketReplicationRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketReplication
- func (c *S3) DeleteBucketReplicationRequest(input *DeleteBucketReplicationInput) (req *request.Request, output *DeleteBucketReplicationOutput) {
- op := &request.Operation{
- Name: opDeleteBucketReplication,
- HTTPMethod: "DELETE",
- HTTPPath: "/{Bucket}?replication",
- }
- if input == nil {
- input = &DeleteBucketReplicationInput{}
- }
- output = &DeleteBucketReplicationOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Swap(restxml.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler)
- return
- }
- // DeleteBucketReplication API operation for Amazon Simple Storage Service.
- //
- // Deletes the replication configuration from the bucket.
- //
- // To use this operation, you must have permissions to perform the s3:PutReplicationConfiguration
- // action. The bucket owner has these permissions by default and can grant it
- // to others. For more information about permissions, see Permissions Related
- // to Bucket Subresource Operations (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources)
- // and Managing Access Permissions to Your Amazon S3 Resources (https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html).
- //
- // It can take a while for the deletion of a replication configuration to fully
- // propagate.
- //
- // For information about replication configuration, see Replication (https://docs.aws.amazon.com/AmazonS3/latest/dev/replication.html)
- // in the Amazon S3 User Guide.
- //
- // The following operations are related to DeleteBucketReplication:
- //
- // - PutBucketReplication (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketReplication.html)
- //
- // - GetBucketReplication (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketReplication.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation DeleteBucketReplication for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketReplication
- func (c *S3) DeleteBucketReplication(input *DeleteBucketReplicationInput) (*DeleteBucketReplicationOutput, error) {
- req, out := c.DeleteBucketReplicationRequest(input)
- return out, req.Send()
- }
- // DeleteBucketReplicationWithContext is the same as DeleteBucketReplication with the addition of
- // the ability to pass a context and additional request options.
- //
- // See DeleteBucketReplication 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 *S3) DeleteBucketReplicationWithContext(ctx aws.Context, input *DeleteBucketReplicationInput, opts ...request.Option) (*DeleteBucketReplicationOutput, error) {
- req, out := c.DeleteBucketReplicationRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opDeleteBucketTagging = "DeleteBucketTagging"
- // DeleteBucketTaggingRequest generates a "aws/request.Request" representing the
- // client's request for the DeleteBucketTagging 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 DeleteBucketTagging for more information on using the DeleteBucketTagging
- // 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 DeleteBucketTaggingRequest method.
- // req, resp := client.DeleteBucketTaggingRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketTagging
- func (c *S3) DeleteBucketTaggingRequest(input *DeleteBucketTaggingInput) (req *request.Request, output *DeleteBucketTaggingOutput) {
- op := &request.Operation{
- Name: opDeleteBucketTagging,
- HTTPMethod: "DELETE",
- HTTPPath: "/{Bucket}?tagging",
- }
- if input == nil {
- input = &DeleteBucketTaggingInput{}
- }
- output = &DeleteBucketTaggingOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Swap(restxml.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler)
- return
- }
- // DeleteBucketTagging API operation for Amazon Simple Storage Service.
- //
- // Deletes the tags from the bucket.
- //
- // To use this operation, you must have permission to perform the s3:PutBucketTagging
- // action. By default, the bucket owner has this permission and can grant this
- // permission to others.
- //
- // The following operations are related to DeleteBucketTagging:
- //
- // - GetBucketTagging (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketTagging.html)
- //
- // - PutBucketTagging (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketTagging.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation DeleteBucketTagging for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketTagging
- func (c *S3) DeleteBucketTagging(input *DeleteBucketTaggingInput) (*DeleteBucketTaggingOutput, error) {
- req, out := c.DeleteBucketTaggingRequest(input)
- return out, req.Send()
- }
- // DeleteBucketTaggingWithContext is the same as DeleteBucketTagging with the addition of
- // the ability to pass a context and additional request options.
- //
- // See DeleteBucketTagging 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 *S3) DeleteBucketTaggingWithContext(ctx aws.Context, input *DeleteBucketTaggingInput, opts ...request.Option) (*DeleteBucketTaggingOutput, error) {
- req, out := c.DeleteBucketTaggingRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opDeleteBucketWebsite = "DeleteBucketWebsite"
- // DeleteBucketWebsiteRequest generates a "aws/request.Request" representing the
- // client's request for the DeleteBucketWebsite 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 DeleteBucketWebsite for more information on using the DeleteBucketWebsite
- // 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 DeleteBucketWebsiteRequest method.
- // req, resp := client.DeleteBucketWebsiteRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketWebsite
- func (c *S3) DeleteBucketWebsiteRequest(input *DeleteBucketWebsiteInput) (req *request.Request, output *DeleteBucketWebsiteOutput) {
- op := &request.Operation{
- Name: opDeleteBucketWebsite,
- HTTPMethod: "DELETE",
- HTTPPath: "/{Bucket}?website",
- }
- if input == nil {
- input = &DeleteBucketWebsiteInput{}
- }
- output = &DeleteBucketWebsiteOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Swap(restxml.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler)
- return
- }
- // DeleteBucketWebsite API operation for Amazon Simple Storage Service.
- //
- // This action removes the website configuration for a bucket. Amazon S3 returns
- // a 200 OK response upon successfully deleting a website configuration on the
- // specified bucket. You will get a 200 OK response if the website configuration
- // you are trying to delete does not exist on the bucket. Amazon S3 returns
- // a 404 response if the bucket specified in the request does not exist.
- //
- // This DELETE action requires the S3:DeleteBucketWebsite permission. By default,
- // only the bucket owner can delete the website configuration attached to a
- // bucket. However, bucket owners can grant other users permission to delete
- // the website configuration by writing a bucket policy granting them the S3:DeleteBucketWebsite
- // permission.
- //
- // For more information about hosting websites, see Hosting Websites on Amazon
- // S3 (https://docs.aws.amazon.com/AmazonS3/latest/dev/WebsiteHosting.html).
- //
- // The following operations are related to DeleteBucketWebsite:
- //
- // - GetBucketWebsite (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketWebsite.html)
- //
- // - PutBucketWebsite (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketWebsite.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation DeleteBucketWebsite for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketWebsite
- func (c *S3) DeleteBucketWebsite(input *DeleteBucketWebsiteInput) (*DeleteBucketWebsiteOutput, error) {
- req, out := c.DeleteBucketWebsiteRequest(input)
- return out, req.Send()
- }
- // DeleteBucketWebsiteWithContext is the same as DeleteBucketWebsite with the addition of
- // the ability to pass a context and additional request options.
- //
- // See DeleteBucketWebsite 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 *S3) DeleteBucketWebsiteWithContext(ctx aws.Context, input *DeleteBucketWebsiteInput, opts ...request.Option) (*DeleteBucketWebsiteOutput, error) {
- req, out := c.DeleteBucketWebsiteRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opDeleteObject = "DeleteObject"
- // DeleteObjectRequest generates a "aws/request.Request" representing the
- // client's request for the DeleteObject 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 DeleteObject for more information on using the DeleteObject
- // 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 DeleteObjectRequest method.
- // req, resp := client.DeleteObjectRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteObject
- func (c *S3) DeleteObjectRequest(input *DeleteObjectInput) (req *request.Request, output *DeleteObjectOutput) {
- op := &request.Operation{
- Name: opDeleteObject,
- HTTPMethod: "DELETE",
- HTTPPath: "/{Bucket}/{Key+}",
- }
- if input == nil {
- input = &DeleteObjectInput{}
- }
- output = &DeleteObjectOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // DeleteObject API operation for Amazon Simple Storage Service.
- //
- // Removes the null version (if there is one) of an object and inserts a delete
- // marker, which becomes the latest version of the object. If there isn't a
- // null version, Amazon S3 does not remove any objects but will still respond
- // that the command was successful.
- //
- // To remove a specific version, you must be the bucket owner and you must use
- // the version Id subresource. Using this subresource permanently deletes the
- // version. If the object deleted is a delete marker, Amazon S3 sets the response
- // header, x-amz-delete-marker, to true.
- //
- // If the object you want to delete is in a bucket where the bucket versioning
- // configuration is MFA Delete enabled, you must include the x-amz-mfa request
- // header in the DELETE versionId request. Requests that include x-amz-mfa must
- // use HTTPS.
- //
- // For more information about MFA Delete, see Using MFA Delete (https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMFADelete.html).
- // To see sample requests that use versioning, see Sample Request (https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectDELETE.html#ExampleVersionObjectDelete).
- //
- // You can delete objects by explicitly calling DELETE Object or configure its
- // lifecycle (PutBucketLifecycle (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycle.html))
- // to enable Amazon S3 to remove them for you. If you want to block users or
- // accounts from removing or deleting objects from your bucket, you must deny
- // them the s3:DeleteObject, s3:DeleteObjectVersion, and s3:PutLifeCycleConfiguration
- // actions.
- //
- // The following action is related to DeleteObject:
- //
- // - PutObject (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation DeleteObject for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteObject
- func (c *S3) DeleteObject(input *DeleteObjectInput) (*DeleteObjectOutput, error) {
- req, out := c.DeleteObjectRequest(input)
- return out, req.Send()
- }
- // DeleteObjectWithContext is the same as DeleteObject with the addition of
- // the ability to pass a context and additional request options.
- //
- // See DeleteObject 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 *S3) DeleteObjectWithContext(ctx aws.Context, input *DeleteObjectInput, opts ...request.Option) (*DeleteObjectOutput, error) {
- req, out := c.DeleteObjectRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opDeleteObjectTagging = "DeleteObjectTagging"
- // DeleteObjectTaggingRequest generates a "aws/request.Request" representing the
- // client's request for the DeleteObjectTagging 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 DeleteObjectTagging for more information on using the DeleteObjectTagging
- // 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 DeleteObjectTaggingRequest method.
- // req, resp := client.DeleteObjectTaggingRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteObjectTagging
- func (c *S3) DeleteObjectTaggingRequest(input *DeleteObjectTaggingInput) (req *request.Request, output *DeleteObjectTaggingOutput) {
- op := &request.Operation{
- Name: opDeleteObjectTagging,
- HTTPMethod: "DELETE",
- HTTPPath: "/{Bucket}/{Key+}?tagging",
- }
- if input == nil {
- input = &DeleteObjectTaggingInput{}
- }
- output = &DeleteObjectTaggingOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // DeleteObjectTagging API operation for Amazon Simple Storage Service.
- //
- // Removes the entire tag set from the specified object. For more information
- // about managing object tags, see Object Tagging (https://docs.aws.amazon.com/AmazonS3/latest/dev/object-tagging.html).
- //
- // To use this operation, you must have permission to perform the s3:DeleteObjectTagging
- // action.
- //
- // To delete tags of a specific object version, add the versionId query parameter
- // in the request. You will need permission for the s3:DeleteObjectVersionTagging
- // action.
- //
- // The following operations are related to DeleteBucketMetricsConfiguration:
- //
- // - PutObjectTagging (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectTagging.html)
- //
- // - GetObjectTagging (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectTagging.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation DeleteObjectTagging for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteObjectTagging
- func (c *S3) DeleteObjectTagging(input *DeleteObjectTaggingInput) (*DeleteObjectTaggingOutput, error) {
- req, out := c.DeleteObjectTaggingRequest(input)
- return out, req.Send()
- }
- // DeleteObjectTaggingWithContext is the same as DeleteObjectTagging with the addition of
- // the ability to pass a context and additional request options.
- //
- // See DeleteObjectTagging 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 *S3) DeleteObjectTaggingWithContext(ctx aws.Context, input *DeleteObjectTaggingInput, opts ...request.Option) (*DeleteObjectTaggingOutput, error) {
- req, out := c.DeleteObjectTaggingRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opDeleteObjects = "DeleteObjects"
- // DeleteObjectsRequest generates a "aws/request.Request" representing the
- // client's request for the DeleteObjects 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 DeleteObjects for more information on using the DeleteObjects
- // 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 DeleteObjectsRequest method.
- // req, resp := client.DeleteObjectsRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteObjects
- func (c *S3) DeleteObjectsRequest(input *DeleteObjectsInput) (req *request.Request, output *DeleteObjectsOutput) {
- op := &request.Operation{
- Name: opDeleteObjects,
- HTTPMethod: "POST",
- HTTPPath: "/{Bucket}?delete",
- }
- if input == nil {
- input = &DeleteObjectsInput{}
- }
- output = &DeleteObjectsOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Build.PushBackNamed(request.NamedHandler{
- Name: "contentMd5Handler",
- Fn: checksum.AddBodyContentMD5Handler,
- })
- return
- }
- // DeleteObjects API operation for Amazon Simple Storage Service.
- //
- // This action enables you to delete multiple objects from a bucket using a
- // single HTTP request. If you know the object keys that you want to delete,
- // then this action provides a suitable alternative to sending individual delete
- // requests, reducing per-request overhead.
- //
- // The request contains a list of up to 1000 keys that you want to delete. In
- // the XML, you provide the object key names, and optionally, version IDs if
- // you want to delete a specific version of the object from a versioning-enabled
- // bucket. For each key, Amazon S3 performs a delete action and returns the
- // result of that delete, success, or failure, in the response. Note that if
- // the object specified in the request is not found, Amazon S3 returns the result
- // as deleted.
- //
- // The action supports two modes for the response: verbose and quiet. By default,
- // the action uses verbose mode in which the response includes the result of
- // deletion of each key in your request. In quiet mode the response includes
- // only keys where the delete action encountered an error. For a successful
- // deletion, the action does not return any information about the delete in
- // the response body.
- //
- // When performing this action on an MFA Delete enabled bucket, that attempts
- // to delete any versioned objects, you must include an MFA token. If you do
- // not provide one, the entire request will fail, even if there are non-versioned
- // objects you are trying to delete. If you provide an invalid token, whether
- // there are versioned keys in the request or not, the entire Multi-Object Delete
- // request will fail. For information about MFA Delete, see MFA Delete (https://docs.aws.amazon.com/AmazonS3/latest/dev/Versioning.html#MultiFactorAuthenticationDelete).
- //
- // Finally, the Content-MD5 header is required for all Multi-Object Delete requests.
- // Amazon S3 uses the header value to ensure that your request body has not
- // been altered in transit.
- //
- // The following operations are related to DeleteObjects:
- //
- // - CreateMultipartUpload (https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html)
- //
- // - UploadPart (https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html)
- //
- // - CompleteMultipartUpload (https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html)
- //
- // - ListParts (https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html)
- //
- // - AbortMultipartUpload (https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation DeleteObjects for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteObjects
- func (c *S3) DeleteObjects(input *DeleteObjectsInput) (*DeleteObjectsOutput, error) {
- req, out := c.DeleteObjectsRequest(input)
- return out, req.Send()
- }
- // DeleteObjectsWithContext is the same as DeleteObjects with the addition of
- // the ability to pass a context and additional request options.
- //
- // See DeleteObjects 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 *S3) DeleteObjectsWithContext(ctx aws.Context, input *DeleteObjectsInput, opts ...request.Option) (*DeleteObjectsOutput, error) {
- req, out := c.DeleteObjectsRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opDeletePublicAccessBlock = "DeletePublicAccessBlock"
- // DeletePublicAccessBlockRequest generates a "aws/request.Request" representing the
- // client's request for the DeletePublicAccessBlock 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 DeletePublicAccessBlock for more information on using the DeletePublicAccessBlock
- // 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 DeletePublicAccessBlockRequest method.
- // req, resp := client.DeletePublicAccessBlockRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeletePublicAccessBlock
- func (c *S3) DeletePublicAccessBlockRequest(input *DeletePublicAccessBlockInput) (req *request.Request, output *DeletePublicAccessBlockOutput) {
- op := &request.Operation{
- Name: opDeletePublicAccessBlock,
- HTTPMethod: "DELETE",
- HTTPPath: "/{Bucket}?publicAccessBlock",
- }
- if input == nil {
- input = &DeletePublicAccessBlockInput{}
- }
- output = &DeletePublicAccessBlockOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Swap(restxml.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler)
- return
- }
- // DeletePublicAccessBlock API operation for Amazon Simple Storage Service.
- //
- // Removes the PublicAccessBlock configuration for an Amazon S3 bucket. To use
- // this operation, you must have the s3:PutBucketPublicAccessBlock permission.
- // For more information about permissions, see Permissions Related to Bucket
- // Subresource Operations (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources)
- // and Managing Access Permissions to Your Amazon S3 Resources (https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html).
- //
- // The following operations are related to DeletePublicAccessBlock:
- //
- // - Using Amazon S3 Block Public Access (https://docs.aws.amazon.com/AmazonS3/latest/dev/access-control-block-public-access.html)
- //
- // - GetPublicAccessBlock (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetPublicAccessBlock.html)
- //
- // - PutPublicAccessBlock (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutPublicAccessBlock.html)
- //
- // - GetBucketPolicyStatus (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketPolicyStatus.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation DeletePublicAccessBlock for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeletePublicAccessBlock
- func (c *S3) DeletePublicAccessBlock(input *DeletePublicAccessBlockInput) (*DeletePublicAccessBlockOutput, error) {
- req, out := c.DeletePublicAccessBlockRequest(input)
- return out, req.Send()
- }
- // DeletePublicAccessBlockWithContext is the same as DeletePublicAccessBlock with the addition of
- // the ability to pass a context and additional request options.
- //
- // See DeletePublicAccessBlock 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 *S3) DeletePublicAccessBlockWithContext(ctx aws.Context, input *DeletePublicAccessBlockInput, opts ...request.Option) (*DeletePublicAccessBlockOutput, error) {
- req, out := c.DeletePublicAccessBlockRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opGetBucketAccelerateConfiguration = "GetBucketAccelerateConfiguration"
- // GetBucketAccelerateConfigurationRequest generates a "aws/request.Request" representing the
- // client's request for the GetBucketAccelerateConfiguration 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 GetBucketAccelerateConfiguration for more information on using the GetBucketAccelerateConfiguration
- // 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 GetBucketAccelerateConfigurationRequest method.
- // req, resp := client.GetBucketAccelerateConfigurationRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketAccelerateConfiguration
- func (c *S3) GetBucketAccelerateConfigurationRequest(input *GetBucketAccelerateConfigurationInput) (req *request.Request, output *GetBucketAccelerateConfigurationOutput) {
- op := &request.Operation{
- Name: opGetBucketAccelerateConfiguration,
- HTTPMethod: "GET",
- HTTPPath: "/{Bucket}?accelerate",
- }
- if input == nil {
- input = &GetBucketAccelerateConfigurationInput{}
- }
- output = &GetBucketAccelerateConfigurationOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // GetBucketAccelerateConfiguration API operation for Amazon Simple Storage Service.
- //
- // This implementation of the GET action uses the accelerate subresource to
- // return the Transfer Acceleration state of a bucket, which is either Enabled
- // or Suspended. Amazon S3 Transfer Acceleration is a bucket-level feature that
- // enables you to perform faster data transfers to and from Amazon S3.
- //
- // To use this operation, you must have permission to perform the s3:GetAccelerateConfiguration
- // action. The bucket owner has this permission by default. The bucket owner
- // can grant this permission to others. For more information about permissions,
- // see Permissions Related to Bucket Subresource Operations (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources)
- // and Managing Access Permissions to your Amazon S3 Resources (https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html)
- // in the Amazon S3 User Guide.
- //
- // You set the Transfer Acceleration state of an existing bucket to Enabled
- // or Suspended by using the PutBucketAccelerateConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketAccelerateConfiguration.html)
- // operation.
- //
- // A GET accelerate request does not return a state value for a bucket that
- // has no transfer acceleration state. A bucket has no Transfer Acceleration
- // state if a state has never been set on the bucket.
- //
- // For more information about transfer acceleration, see Transfer Acceleration
- // (https://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration.html)
- // in the Amazon S3 User Guide.
- //
- // Related Resources
- //
- // - PutBucketAccelerateConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketAccelerateConfiguration.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation GetBucketAccelerateConfiguration for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketAccelerateConfiguration
- func (c *S3) GetBucketAccelerateConfiguration(input *GetBucketAccelerateConfigurationInput) (*GetBucketAccelerateConfigurationOutput, error) {
- req, out := c.GetBucketAccelerateConfigurationRequest(input)
- return out, req.Send()
- }
- // GetBucketAccelerateConfigurationWithContext is the same as GetBucketAccelerateConfiguration with the addition of
- // the ability to pass a context and additional request options.
- //
- // See GetBucketAccelerateConfiguration 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 *S3) GetBucketAccelerateConfigurationWithContext(ctx aws.Context, input *GetBucketAccelerateConfigurationInput, opts ...request.Option) (*GetBucketAccelerateConfigurationOutput, error) {
- req, out := c.GetBucketAccelerateConfigurationRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opGetBucketAcl = "GetBucketAcl"
- // GetBucketAclRequest generates a "aws/request.Request" representing the
- // client's request for the GetBucketAcl 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 GetBucketAcl for more information on using the GetBucketAcl
- // 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 GetBucketAclRequest method.
- // req, resp := client.GetBucketAclRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketAcl
- func (c *S3) GetBucketAclRequest(input *GetBucketAclInput) (req *request.Request, output *GetBucketAclOutput) {
- op := &request.Operation{
- Name: opGetBucketAcl,
- HTTPMethod: "GET",
- HTTPPath: "/{Bucket}?acl",
- }
- if input == nil {
- input = &GetBucketAclInput{}
- }
- output = &GetBucketAclOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // GetBucketAcl API operation for Amazon Simple Storage Service.
- //
- // This implementation of the GET action uses the acl subresource to return
- // the access control list (ACL) of a bucket. To use GET to return the ACL of
- // the bucket, you must have READ_ACP access to the bucket. If READ_ACP permission
- // is granted to the anonymous user, you can return the ACL of the bucket without
- // using an authorization header.
- //
- // If your bucket uses the bucket owner enforced setting for S3 Object Ownership,
- // requests to read ACLs are still supported and return the bucket-owner-full-control
- // ACL with the owner being the account that created the bucket. For more information,
- // see Controlling object ownership and disabling ACLs (https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html)
- // in the Amazon S3 User Guide.
- //
- // Related Resources
- //
- // - ListObjects (https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjects.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation GetBucketAcl for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketAcl
- func (c *S3) GetBucketAcl(input *GetBucketAclInput) (*GetBucketAclOutput, error) {
- req, out := c.GetBucketAclRequest(input)
- return out, req.Send()
- }
- // GetBucketAclWithContext is the same as GetBucketAcl with the addition of
- // the ability to pass a context and additional request options.
- //
- // See GetBucketAcl 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 *S3) GetBucketAclWithContext(ctx aws.Context, input *GetBucketAclInput, opts ...request.Option) (*GetBucketAclOutput, error) {
- req, out := c.GetBucketAclRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opGetBucketAnalyticsConfiguration = "GetBucketAnalyticsConfiguration"
- // GetBucketAnalyticsConfigurationRequest generates a "aws/request.Request" representing the
- // client's request for the GetBucketAnalyticsConfiguration 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 GetBucketAnalyticsConfiguration for more information on using the GetBucketAnalyticsConfiguration
- // 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 GetBucketAnalyticsConfigurationRequest method.
- // req, resp := client.GetBucketAnalyticsConfigurationRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketAnalyticsConfiguration
- func (c *S3) GetBucketAnalyticsConfigurationRequest(input *GetBucketAnalyticsConfigurationInput) (req *request.Request, output *GetBucketAnalyticsConfigurationOutput) {
- op := &request.Operation{
- Name: opGetBucketAnalyticsConfiguration,
- HTTPMethod: "GET",
- HTTPPath: "/{Bucket}?analytics",
- }
- if input == nil {
- input = &GetBucketAnalyticsConfigurationInput{}
- }
- output = &GetBucketAnalyticsConfigurationOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // GetBucketAnalyticsConfiguration API operation for Amazon Simple Storage Service.
- //
- // This implementation of the GET action returns an analytics configuration
- // (identified by the analytics configuration ID) from the bucket.
- //
- // To use this operation, you must have permissions to perform the s3:GetAnalyticsConfiguration
- // action. The bucket owner has this permission by default. The bucket owner
- // can grant this permission to others. For more information about permissions,
- // see Permissions Related to Bucket Subresource Operations (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources)
- // and Managing Access Permissions to Your Amazon S3 Resources (https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html)
- // in the Amazon S3 User Guide.
- //
- // For information about Amazon S3 analytics feature, see Amazon S3 Analytics
- // – Storage Class Analysis (https://docs.aws.amazon.com/AmazonS3/latest/dev/analytics-storage-class.html)
- // in the Amazon S3 User Guide.
- //
- // Related Resources
- //
- // - DeleteBucketAnalyticsConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketAnalyticsConfiguration.html)
- //
- // - ListBucketAnalyticsConfigurations (https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBucketAnalyticsConfigurations.html)
- //
- // - PutBucketAnalyticsConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketAnalyticsConfiguration.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation GetBucketAnalyticsConfiguration for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketAnalyticsConfiguration
- func (c *S3) GetBucketAnalyticsConfiguration(input *GetBucketAnalyticsConfigurationInput) (*GetBucketAnalyticsConfigurationOutput, error) {
- req, out := c.GetBucketAnalyticsConfigurationRequest(input)
- return out, req.Send()
- }
- // GetBucketAnalyticsConfigurationWithContext is the same as GetBucketAnalyticsConfiguration with the addition of
- // the ability to pass a context and additional request options.
- //
- // See GetBucketAnalyticsConfiguration 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 *S3) GetBucketAnalyticsConfigurationWithContext(ctx aws.Context, input *GetBucketAnalyticsConfigurationInput, opts ...request.Option) (*GetBucketAnalyticsConfigurationOutput, error) {
- req, out := c.GetBucketAnalyticsConfigurationRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opGetBucketCors = "GetBucketCors"
- // GetBucketCorsRequest generates a "aws/request.Request" representing the
- // client's request for the GetBucketCors 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 GetBucketCors for more information on using the GetBucketCors
- // 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 GetBucketCorsRequest method.
- // req, resp := client.GetBucketCorsRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketCors
- func (c *S3) GetBucketCorsRequest(input *GetBucketCorsInput) (req *request.Request, output *GetBucketCorsOutput) {
- op := &request.Operation{
- Name: opGetBucketCors,
- HTTPMethod: "GET",
- HTTPPath: "/{Bucket}?cors",
- }
- if input == nil {
- input = &GetBucketCorsInput{}
- }
- output = &GetBucketCorsOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // GetBucketCors API operation for Amazon Simple Storage Service.
- //
- // Returns the Cross-Origin Resource Sharing (CORS) configuration information
- // set for the bucket.
- //
- // To use this operation, you must have permission to perform the s3:GetBucketCORS
- // action. By default, the bucket owner has this permission and can grant it
- // to others.
- //
- // For more information about CORS, see Enabling Cross-Origin Resource Sharing
- // (https://docs.aws.amazon.com/AmazonS3/latest/dev/cors.html).
- //
- // The following operations are related to GetBucketCors:
- //
- // - PutBucketCors (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketCors.html)
- //
- // - DeleteBucketCors (https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketCors.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation GetBucketCors for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketCors
- func (c *S3) GetBucketCors(input *GetBucketCorsInput) (*GetBucketCorsOutput, error) {
- req, out := c.GetBucketCorsRequest(input)
- return out, req.Send()
- }
- // GetBucketCorsWithContext is the same as GetBucketCors with the addition of
- // the ability to pass a context and additional request options.
- //
- // See GetBucketCors 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 *S3) GetBucketCorsWithContext(ctx aws.Context, input *GetBucketCorsInput, opts ...request.Option) (*GetBucketCorsOutput, error) {
- req, out := c.GetBucketCorsRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opGetBucketEncryption = "GetBucketEncryption"
- // GetBucketEncryptionRequest generates a "aws/request.Request" representing the
- // client's request for the GetBucketEncryption 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 GetBucketEncryption for more information on using the GetBucketEncryption
- // 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 GetBucketEncryptionRequest method.
- // req, resp := client.GetBucketEncryptionRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketEncryption
- func (c *S3) GetBucketEncryptionRequest(input *GetBucketEncryptionInput) (req *request.Request, output *GetBucketEncryptionOutput) {
- op := &request.Operation{
- Name: opGetBucketEncryption,
- HTTPMethod: "GET",
- HTTPPath: "/{Bucket}?encryption",
- }
- if input == nil {
- input = &GetBucketEncryptionInput{}
- }
- output = &GetBucketEncryptionOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // GetBucketEncryption API operation for Amazon Simple Storage Service.
- //
- // Returns the default encryption configuration for an Amazon S3 bucket. If
- // the bucket does not have a default encryption configuration, GetBucketEncryption
- // returns ServerSideEncryptionConfigurationNotFoundError.
- //
- // For information about the Amazon S3 default encryption feature, see Amazon
- // S3 Default Bucket Encryption (https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html).
- //
- // To use this operation, you must have permission to perform the s3:GetEncryptionConfiguration
- // action. The bucket owner has this permission by default. The bucket owner
- // can grant this permission to others. For more information about permissions,
- // see Permissions Related to Bucket Subresource Operations (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources)
- // and Managing Access Permissions to Your Amazon S3 Resources (https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html).
- //
- // The following operations are related to GetBucketEncryption:
- //
- // - PutBucketEncryption (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketEncryption.html)
- //
- // - DeleteBucketEncryption (https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketEncryption.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation GetBucketEncryption for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketEncryption
- func (c *S3) GetBucketEncryption(input *GetBucketEncryptionInput) (*GetBucketEncryptionOutput, error) {
- req, out := c.GetBucketEncryptionRequest(input)
- return out, req.Send()
- }
- // GetBucketEncryptionWithContext is the same as GetBucketEncryption with the addition of
- // the ability to pass a context and additional request options.
- //
- // See GetBucketEncryption 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 *S3) GetBucketEncryptionWithContext(ctx aws.Context, input *GetBucketEncryptionInput, opts ...request.Option) (*GetBucketEncryptionOutput, error) {
- req, out := c.GetBucketEncryptionRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opGetBucketIntelligentTieringConfiguration = "GetBucketIntelligentTieringConfiguration"
- // GetBucketIntelligentTieringConfigurationRequest generates a "aws/request.Request" representing the
- // client's request for the GetBucketIntelligentTieringConfiguration 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 GetBucketIntelligentTieringConfiguration for more information on using the GetBucketIntelligentTieringConfiguration
- // 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 GetBucketIntelligentTieringConfigurationRequest method.
- // req, resp := client.GetBucketIntelligentTieringConfigurationRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketIntelligentTieringConfiguration
- func (c *S3) GetBucketIntelligentTieringConfigurationRequest(input *GetBucketIntelligentTieringConfigurationInput) (req *request.Request, output *GetBucketIntelligentTieringConfigurationOutput) {
- op := &request.Operation{
- Name: opGetBucketIntelligentTieringConfiguration,
- HTTPMethod: "GET",
- HTTPPath: "/{Bucket}?intelligent-tiering",
- }
- if input == nil {
- input = &GetBucketIntelligentTieringConfigurationInput{}
- }
- output = &GetBucketIntelligentTieringConfigurationOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // GetBucketIntelligentTieringConfiguration API operation for Amazon Simple Storage Service.
- //
- // Gets the S3 Intelligent-Tiering configuration from the specified bucket.
- //
- // The S3 Intelligent-Tiering storage class is designed to optimize storage
- // costs by automatically moving data to the most cost-effective storage access
- // tier, without performance impact or operational overhead. S3 Intelligent-Tiering
- // delivers automatic cost savings in three low latency and high throughput
- // access tiers. To get the lowest storage cost on data that can be accessed
- // in minutes to hours, you can choose to activate additional archiving capabilities.
- //
- // The S3 Intelligent-Tiering storage class is the ideal storage class for data
- // with unknown, changing, or unpredictable access patterns, independent of
- // object size or retention period. If the size of an object is less than 128
- // KB, it is not monitored and not eligible for auto-tiering. Smaller objects
- // can be stored, but they are always charged at the Frequent Access tier rates
- // in the S3 Intelligent-Tiering storage class.
- //
- // For more information, see Storage class for automatically optimizing frequently
- // and infrequently accessed objects (https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html#sc-dynamic-data-access).
- //
- // Operations related to GetBucketIntelligentTieringConfiguration include:
- //
- // - DeleteBucketIntelligentTieringConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketIntelligentTieringConfiguration.html)
- //
- // - PutBucketIntelligentTieringConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketIntelligentTieringConfiguration.html)
- //
- // - ListBucketIntelligentTieringConfigurations (https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBucketIntelligentTieringConfigurations.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation GetBucketIntelligentTieringConfiguration for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketIntelligentTieringConfiguration
- func (c *S3) GetBucketIntelligentTieringConfiguration(input *GetBucketIntelligentTieringConfigurationInput) (*GetBucketIntelligentTieringConfigurationOutput, error) {
- req, out := c.GetBucketIntelligentTieringConfigurationRequest(input)
- return out, req.Send()
- }
- // GetBucketIntelligentTieringConfigurationWithContext is the same as GetBucketIntelligentTieringConfiguration with the addition of
- // the ability to pass a context and additional request options.
- //
- // See GetBucketIntelligentTieringConfiguration 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 *S3) GetBucketIntelligentTieringConfigurationWithContext(ctx aws.Context, input *GetBucketIntelligentTieringConfigurationInput, opts ...request.Option) (*GetBucketIntelligentTieringConfigurationOutput, error) {
- req, out := c.GetBucketIntelligentTieringConfigurationRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opGetBucketInventoryConfiguration = "GetBucketInventoryConfiguration"
- // GetBucketInventoryConfigurationRequest generates a "aws/request.Request" representing the
- // client's request for the GetBucketInventoryConfiguration 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 GetBucketInventoryConfiguration for more information on using the GetBucketInventoryConfiguration
- // 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 GetBucketInventoryConfigurationRequest method.
- // req, resp := client.GetBucketInventoryConfigurationRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketInventoryConfiguration
- func (c *S3) GetBucketInventoryConfigurationRequest(input *GetBucketInventoryConfigurationInput) (req *request.Request, output *GetBucketInventoryConfigurationOutput) {
- op := &request.Operation{
- Name: opGetBucketInventoryConfiguration,
- HTTPMethod: "GET",
- HTTPPath: "/{Bucket}?inventory",
- }
- if input == nil {
- input = &GetBucketInventoryConfigurationInput{}
- }
- output = &GetBucketInventoryConfigurationOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // GetBucketInventoryConfiguration API operation for Amazon Simple Storage Service.
- //
- // Returns an inventory configuration (identified by the inventory configuration
- // ID) from the bucket.
- //
- // To use this operation, you must have permissions to perform the s3:GetInventoryConfiguration
- // action. The bucket owner has this permission by default and can grant this
- // permission to others. For more information about permissions, see Permissions
- // Related to Bucket Subresource Operations (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources)
- // and Managing Access Permissions to Your Amazon S3 Resources (https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html).
- //
- // For information about the Amazon S3 inventory feature, see Amazon S3 Inventory
- // (https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-inventory.html).
- //
- // The following operations are related to GetBucketInventoryConfiguration:
- //
- // - DeleteBucketInventoryConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketInventoryConfiguration.html)
- //
- // - ListBucketInventoryConfigurations (https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBucketInventoryConfigurations.html)
- //
- // - PutBucketInventoryConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketInventoryConfiguration.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation GetBucketInventoryConfiguration for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketInventoryConfiguration
- func (c *S3) GetBucketInventoryConfiguration(input *GetBucketInventoryConfigurationInput) (*GetBucketInventoryConfigurationOutput, error) {
- req, out := c.GetBucketInventoryConfigurationRequest(input)
- return out, req.Send()
- }
- // GetBucketInventoryConfigurationWithContext is the same as GetBucketInventoryConfiguration with the addition of
- // the ability to pass a context and additional request options.
- //
- // See GetBucketInventoryConfiguration 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 *S3) GetBucketInventoryConfigurationWithContext(ctx aws.Context, input *GetBucketInventoryConfigurationInput, opts ...request.Option) (*GetBucketInventoryConfigurationOutput, error) {
- req, out := c.GetBucketInventoryConfigurationRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opGetBucketLifecycle = "GetBucketLifecycle"
- // GetBucketLifecycleRequest generates a "aws/request.Request" representing the
- // client's request for the GetBucketLifecycle 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 GetBucketLifecycle for more information on using the GetBucketLifecycle
- // 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 GetBucketLifecycleRequest method.
- // req, resp := client.GetBucketLifecycleRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketLifecycle
- //
- // Deprecated: GetBucketLifecycle has been deprecated
- func (c *S3) GetBucketLifecycleRequest(input *GetBucketLifecycleInput) (req *request.Request, output *GetBucketLifecycleOutput) {
- if c.Client.Config.Logger != nil {
- c.Client.Config.Logger.Log("This operation, GetBucketLifecycle, has been deprecated")
- }
- op := &request.Operation{
- Name: opGetBucketLifecycle,
- HTTPMethod: "GET",
- HTTPPath: "/{Bucket}?lifecycle",
- }
- if input == nil {
- input = &GetBucketLifecycleInput{}
- }
- output = &GetBucketLifecycleOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // GetBucketLifecycle API operation for Amazon Simple Storage Service.
- //
- // For an updated version of this API, see GetBucketLifecycleConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html).
- // If you configured a bucket lifecycle using the filter element, you should
- // see the updated version of this topic. This topic is provided for backward
- // compatibility.
- //
- // Returns the lifecycle configuration information set on the bucket. For information
- // about lifecycle configuration, see Object Lifecycle Management (https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html).
- //
- // To use this operation, you must have permission to perform the s3:GetLifecycleConfiguration
- // action. The bucket owner has this permission by default. The bucket owner
- // can grant this permission to others. For more information about permissions,
- // see Permissions Related to Bucket Subresource Operations (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources)
- // and Managing Access Permissions to Your Amazon S3 Resources (https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html).
- //
- // GetBucketLifecycle has the following special error:
- //
- // - Error code: NoSuchLifecycleConfiguration Description: The lifecycle
- // configuration does not exist. HTTP Status Code: 404 Not Found SOAP Fault
- // Code Prefix: Client
- //
- // The following operations are related to GetBucketLifecycle:
- //
- // - GetBucketLifecycleConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html)
- //
- // - PutBucketLifecycle (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycle.html)
- //
- // - DeleteBucketLifecycle (https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation GetBucketLifecycle for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketLifecycle
- //
- // Deprecated: GetBucketLifecycle has been deprecated
- func (c *S3) GetBucketLifecycle(input *GetBucketLifecycleInput) (*GetBucketLifecycleOutput, error) {
- req, out := c.GetBucketLifecycleRequest(input)
- return out, req.Send()
- }
- // GetBucketLifecycleWithContext is the same as GetBucketLifecycle with the addition of
- // the ability to pass a context and additional request options.
- //
- // See GetBucketLifecycle 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.
- //
- // Deprecated: GetBucketLifecycleWithContext has been deprecated
- func (c *S3) GetBucketLifecycleWithContext(ctx aws.Context, input *GetBucketLifecycleInput, opts ...request.Option) (*GetBucketLifecycleOutput, error) {
- req, out := c.GetBucketLifecycleRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opGetBucketLifecycleConfiguration = "GetBucketLifecycleConfiguration"
- // GetBucketLifecycleConfigurationRequest generates a "aws/request.Request" representing the
- // client's request for the GetBucketLifecycleConfiguration 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 GetBucketLifecycleConfiguration for more information on using the GetBucketLifecycleConfiguration
- // 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 GetBucketLifecycleConfigurationRequest method.
- // req, resp := client.GetBucketLifecycleConfigurationRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketLifecycleConfiguration
- func (c *S3) GetBucketLifecycleConfigurationRequest(input *GetBucketLifecycleConfigurationInput) (req *request.Request, output *GetBucketLifecycleConfigurationOutput) {
- op := &request.Operation{
- Name: opGetBucketLifecycleConfiguration,
- HTTPMethod: "GET",
- HTTPPath: "/{Bucket}?lifecycle",
- }
- if input == nil {
- input = &GetBucketLifecycleConfigurationInput{}
- }
- output = &GetBucketLifecycleConfigurationOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // GetBucketLifecycleConfiguration API operation for Amazon Simple Storage Service.
- //
- // Bucket lifecycle configuration now supports specifying a lifecycle rule using
- // an object key name prefix, one or more object tags, or a combination of both.
- // Accordingly, this section describes the latest API. The response describes
- // the new filter element that you can use to specify a filter to select a subset
- // of objects to which the rule applies. If you are using a previous version
- // of the lifecycle configuration, it still works. For the earlier action, see
- // GetBucketLifecycle (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycle.html).
- //
- // Returns the lifecycle configuration information set on the bucket. For information
- // about lifecycle configuration, see Object Lifecycle Management (https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html).
- //
- // To use this operation, you must have permission to perform the s3:GetLifecycleConfiguration
- // action. The bucket owner has this permission, by default. The bucket owner
- // can grant this permission to others. For more information about permissions,
- // see Permissions Related to Bucket Subresource Operations (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources)
- // and Managing Access Permissions to Your Amazon S3 Resources (https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html).
- //
- // GetBucketLifecycleConfiguration has the following special error:
- //
- // - Error code: NoSuchLifecycleConfiguration Description: The lifecycle
- // configuration does not exist. HTTP Status Code: 404 Not Found SOAP Fault
- // Code Prefix: Client
- //
- // The following operations are related to GetBucketLifecycleConfiguration:
- //
- // - GetBucketLifecycle (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycle.html)
- //
- // - PutBucketLifecycle (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycle.html)
- //
- // - DeleteBucketLifecycle (https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation GetBucketLifecycleConfiguration for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketLifecycleConfiguration
- func (c *S3) GetBucketLifecycleConfiguration(input *GetBucketLifecycleConfigurationInput) (*GetBucketLifecycleConfigurationOutput, error) {
- req, out := c.GetBucketLifecycleConfigurationRequest(input)
- return out, req.Send()
- }
- // GetBucketLifecycleConfigurationWithContext is the same as GetBucketLifecycleConfiguration with the addition of
- // the ability to pass a context and additional request options.
- //
- // See GetBucketLifecycleConfiguration 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 *S3) GetBucketLifecycleConfigurationWithContext(ctx aws.Context, input *GetBucketLifecycleConfigurationInput, opts ...request.Option) (*GetBucketLifecycleConfigurationOutput, error) {
- req, out := c.GetBucketLifecycleConfigurationRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opGetBucketLocation = "GetBucketLocation"
- // GetBucketLocationRequest generates a "aws/request.Request" representing the
- // client's request for the GetBucketLocation 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 GetBucketLocation for more information on using the GetBucketLocation
- // 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 GetBucketLocationRequest method.
- // req, resp := client.GetBucketLocationRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketLocation
- func (c *S3) GetBucketLocationRequest(input *GetBucketLocationInput) (req *request.Request, output *GetBucketLocationOutput) {
- op := &request.Operation{
- Name: opGetBucketLocation,
- HTTPMethod: "GET",
- HTTPPath: "/{Bucket}?location",
- }
- if input == nil {
- input = &GetBucketLocationInput{}
- }
- output = &GetBucketLocationOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // GetBucketLocation API operation for Amazon Simple Storage Service.
- //
- // Returns the Region the bucket resides in. You set the bucket's Region using
- // the LocationConstraint request parameter in a CreateBucket request. For more
- // information, see CreateBucket (https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html).
- //
- // To use this implementation of the operation, you must be the bucket owner.
- //
- // To use this API against an access point, provide the alias of the access
- // point in place of the bucket name.
- //
- // The following operations are related to GetBucketLocation:
- //
- // - GetObject (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html)
- //
- // - CreateBucket (https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation GetBucketLocation for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketLocation
- func (c *S3) GetBucketLocation(input *GetBucketLocationInput) (*GetBucketLocationOutput, error) {
- req, out := c.GetBucketLocationRequest(input)
- return out, req.Send()
- }
- // GetBucketLocationWithContext is the same as GetBucketLocation with the addition of
- // the ability to pass a context and additional request options.
- //
- // See GetBucketLocation 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 *S3) GetBucketLocationWithContext(ctx aws.Context, input *GetBucketLocationInput, opts ...request.Option) (*GetBucketLocationOutput, error) {
- req, out := c.GetBucketLocationRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opGetBucketLogging = "GetBucketLogging"
- // GetBucketLoggingRequest generates a "aws/request.Request" representing the
- // client's request for the GetBucketLogging 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 GetBucketLogging for more information on using the GetBucketLogging
- // 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 GetBucketLoggingRequest method.
- // req, resp := client.GetBucketLoggingRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketLogging
- func (c *S3) GetBucketLoggingRequest(input *GetBucketLoggingInput) (req *request.Request, output *GetBucketLoggingOutput) {
- op := &request.Operation{
- Name: opGetBucketLogging,
- HTTPMethod: "GET",
- HTTPPath: "/{Bucket}?logging",
- }
- if input == nil {
- input = &GetBucketLoggingInput{}
- }
- output = &GetBucketLoggingOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // GetBucketLogging API operation for Amazon Simple Storage Service.
- //
- // Returns the logging status of a bucket and the permissions users have to
- // view and modify that status. To use GET, you must be the bucket owner.
- //
- // The following operations are related to GetBucketLogging:
- //
- // - CreateBucket (https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html)
- //
- // - PutBucketLogging (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLogging.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation GetBucketLogging for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketLogging
- func (c *S3) GetBucketLogging(input *GetBucketLoggingInput) (*GetBucketLoggingOutput, error) {
- req, out := c.GetBucketLoggingRequest(input)
- return out, req.Send()
- }
- // GetBucketLoggingWithContext is the same as GetBucketLogging with the addition of
- // the ability to pass a context and additional request options.
- //
- // See GetBucketLogging 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 *S3) GetBucketLoggingWithContext(ctx aws.Context, input *GetBucketLoggingInput, opts ...request.Option) (*GetBucketLoggingOutput, error) {
- req, out := c.GetBucketLoggingRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opGetBucketMetricsConfiguration = "GetBucketMetricsConfiguration"
- // GetBucketMetricsConfigurationRequest generates a "aws/request.Request" representing the
- // client's request for the GetBucketMetricsConfiguration 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 GetBucketMetricsConfiguration for more information on using the GetBucketMetricsConfiguration
- // 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 GetBucketMetricsConfigurationRequest method.
- // req, resp := client.GetBucketMetricsConfigurationRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketMetricsConfiguration
- func (c *S3) GetBucketMetricsConfigurationRequest(input *GetBucketMetricsConfigurationInput) (req *request.Request, output *GetBucketMetricsConfigurationOutput) {
- op := &request.Operation{
- Name: opGetBucketMetricsConfiguration,
- HTTPMethod: "GET",
- HTTPPath: "/{Bucket}?metrics",
- }
- if input == nil {
- input = &GetBucketMetricsConfigurationInput{}
- }
- output = &GetBucketMetricsConfigurationOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // GetBucketMetricsConfiguration API operation for Amazon Simple Storage Service.
- //
- // Gets a metrics configuration (specified by the metrics configuration ID)
- // from the bucket. Note that this doesn't include the daily storage metrics.
- //
- // To use this operation, you must have permissions to perform the s3:GetMetricsConfiguration
- // action. The bucket owner has this permission by default. The bucket owner
- // can grant this permission to others. For more information about permissions,
- // see Permissions Related to Bucket Subresource Operations (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources)
- // and Managing Access Permissions to Your Amazon S3 Resources (https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html).
- //
- // For information about CloudWatch request metrics for Amazon S3, see Monitoring
- // Metrics with Amazon CloudWatch (https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html).
- //
- // The following operations are related to GetBucketMetricsConfiguration:
- //
- // - PutBucketMetricsConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketMetricsConfiguration.html)
- //
- // - DeleteBucketMetricsConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketMetricsConfiguration.html)
- //
- // - ListBucketMetricsConfigurations (https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBucketMetricsConfigurations.html)
- //
- // - Monitoring Metrics with Amazon CloudWatch (https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation GetBucketMetricsConfiguration for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketMetricsConfiguration
- func (c *S3) GetBucketMetricsConfiguration(input *GetBucketMetricsConfigurationInput) (*GetBucketMetricsConfigurationOutput, error) {
- req, out := c.GetBucketMetricsConfigurationRequest(input)
- return out, req.Send()
- }
- // GetBucketMetricsConfigurationWithContext is the same as GetBucketMetricsConfiguration with the addition of
- // the ability to pass a context and additional request options.
- //
- // See GetBucketMetricsConfiguration 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 *S3) GetBucketMetricsConfigurationWithContext(ctx aws.Context, input *GetBucketMetricsConfigurationInput, opts ...request.Option) (*GetBucketMetricsConfigurationOutput, error) {
- req, out := c.GetBucketMetricsConfigurationRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opGetBucketNotification = "GetBucketNotification"
- // GetBucketNotificationRequest generates a "aws/request.Request" representing the
- // client's request for the GetBucketNotification 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 GetBucketNotification for more information on using the GetBucketNotification
- // 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 GetBucketNotificationRequest method.
- // req, resp := client.GetBucketNotificationRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketNotification
- //
- // Deprecated: GetBucketNotification has been deprecated
- func (c *S3) GetBucketNotificationRequest(input *GetBucketNotificationConfigurationRequest) (req *request.Request, output *NotificationConfigurationDeprecated) {
- if c.Client.Config.Logger != nil {
- c.Client.Config.Logger.Log("This operation, GetBucketNotification, has been deprecated")
- }
- op := &request.Operation{
- Name: opGetBucketNotification,
- HTTPMethod: "GET",
- HTTPPath: "/{Bucket}?notification",
- }
- if input == nil {
- input = &GetBucketNotificationConfigurationRequest{}
- }
- output = &NotificationConfigurationDeprecated{}
- req = c.newRequest(op, input, output)
- return
- }
- // GetBucketNotification API operation for Amazon Simple Storage Service.
- //
- // No longer used, see GetBucketNotificationConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketNotificationConfiguration.html).
- //
- // 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 Amazon Simple Storage Service's
- // API operation GetBucketNotification for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketNotification
- //
- // Deprecated: GetBucketNotification has been deprecated
- func (c *S3) GetBucketNotification(input *GetBucketNotificationConfigurationRequest) (*NotificationConfigurationDeprecated, error) {
- req, out := c.GetBucketNotificationRequest(input)
- return out, req.Send()
- }
- // GetBucketNotificationWithContext is the same as GetBucketNotification with the addition of
- // the ability to pass a context and additional request options.
- //
- // See GetBucketNotification 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.
- //
- // Deprecated: GetBucketNotificationWithContext has been deprecated
- func (c *S3) GetBucketNotificationWithContext(ctx aws.Context, input *GetBucketNotificationConfigurationRequest, opts ...request.Option) (*NotificationConfigurationDeprecated, error) {
- req, out := c.GetBucketNotificationRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opGetBucketNotificationConfiguration = "GetBucketNotificationConfiguration"
- // GetBucketNotificationConfigurationRequest generates a "aws/request.Request" representing the
- // client's request for the GetBucketNotificationConfiguration 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 GetBucketNotificationConfiguration for more information on using the GetBucketNotificationConfiguration
- // 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 GetBucketNotificationConfigurationRequest method.
- // req, resp := client.GetBucketNotificationConfigurationRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketNotificationConfiguration
- func (c *S3) GetBucketNotificationConfigurationRequest(input *GetBucketNotificationConfigurationRequest) (req *request.Request, output *NotificationConfiguration) {
- op := &request.Operation{
- Name: opGetBucketNotificationConfiguration,
- HTTPMethod: "GET",
- HTTPPath: "/{Bucket}?notification",
- }
- if input == nil {
- input = &GetBucketNotificationConfigurationRequest{}
- }
- output = &NotificationConfiguration{}
- req = c.newRequest(op, input, output)
- return
- }
- // GetBucketNotificationConfiguration API operation for Amazon Simple Storage Service.
- //
- // Returns the notification configuration of a bucket.
- //
- // If notifications are not enabled on the bucket, the action returns an empty
- // NotificationConfiguration element.
- //
- // By default, you must be the bucket owner to read the notification configuration
- // of a bucket. However, the bucket owner can use a bucket policy to grant permission
- // to other users to read this configuration with the s3:GetBucketNotification
- // permission.
- //
- // For more information about setting and reading the notification configuration
- // on a bucket, see Setting Up Notification of Bucket Events (https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html).
- // For more information about bucket policies, see Using Bucket Policies (https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html).
- //
- // The following action is related to GetBucketNotification:
- //
- // - PutBucketNotification (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketNotification.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation GetBucketNotificationConfiguration for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketNotificationConfiguration
- func (c *S3) GetBucketNotificationConfiguration(input *GetBucketNotificationConfigurationRequest) (*NotificationConfiguration, error) {
- req, out := c.GetBucketNotificationConfigurationRequest(input)
- return out, req.Send()
- }
- // GetBucketNotificationConfigurationWithContext is the same as GetBucketNotificationConfiguration with the addition of
- // the ability to pass a context and additional request options.
- //
- // See GetBucketNotificationConfiguration 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 *S3) GetBucketNotificationConfigurationWithContext(ctx aws.Context, input *GetBucketNotificationConfigurationRequest, opts ...request.Option) (*NotificationConfiguration, error) {
- req, out := c.GetBucketNotificationConfigurationRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opGetBucketOwnershipControls = "GetBucketOwnershipControls"
- // GetBucketOwnershipControlsRequest generates a "aws/request.Request" representing the
- // client's request for the GetBucketOwnershipControls 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 GetBucketOwnershipControls for more information on using the GetBucketOwnershipControls
- // 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 GetBucketOwnershipControlsRequest method.
- // req, resp := client.GetBucketOwnershipControlsRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketOwnershipControls
- func (c *S3) GetBucketOwnershipControlsRequest(input *GetBucketOwnershipControlsInput) (req *request.Request, output *GetBucketOwnershipControlsOutput) {
- op := &request.Operation{
- Name: opGetBucketOwnershipControls,
- HTTPMethod: "GET",
- HTTPPath: "/{Bucket}?ownershipControls",
- }
- if input == nil {
- input = &GetBucketOwnershipControlsInput{}
- }
- output = &GetBucketOwnershipControlsOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // GetBucketOwnershipControls API operation for Amazon Simple Storage Service.
- //
- // Retrieves OwnershipControls for an Amazon S3 bucket. To use this operation,
- // you must have the s3:GetBucketOwnershipControls permission. For more information
- // about Amazon S3 permissions, see Specifying permissions in a policy (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html).
- //
- // For information about Amazon S3 Object Ownership, see Using Object Ownership
- // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html).
- //
- // The following operations are related to GetBucketOwnershipControls:
- //
- // - PutBucketOwnershipControls
- //
- // - DeleteBucketOwnershipControls
- //
- // 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 Amazon Simple Storage Service's
- // API operation GetBucketOwnershipControls for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketOwnershipControls
- func (c *S3) GetBucketOwnershipControls(input *GetBucketOwnershipControlsInput) (*GetBucketOwnershipControlsOutput, error) {
- req, out := c.GetBucketOwnershipControlsRequest(input)
- return out, req.Send()
- }
- // GetBucketOwnershipControlsWithContext is the same as GetBucketOwnershipControls with the addition of
- // the ability to pass a context and additional request options.
- //
- // See GetBucketOwnershipControls 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 *S3) GetBucketOwnershipControlsWithContext(ctx aws.Context, input *GetBucketOwnershipControlsInput, opts ...request.Option) (*GetBucketOwnershipControlsOutput, error) {
- req, out := c.GetBucketOwnershipControlsRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opGetBucketPolicy = "GetBucketPolicy"
- // GetBucketPolicyRequest generates a "aws/request.Request" representing the
- // client's request for the GetBucketPolicy 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 GetBucketPolicy for more information on using the GetBucketPolicy
- // 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 GetBucketPolicyRequest method.
- // req, resp := client.GetBucketPolicyRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketPolicy
- func (c *S3) GetBucketPolicyRequest(input *GetBucketPolicyInput) (req *request.Request, output *GetBucketPolicyOutput) {
- op := &request.Operation{
- Name: opGetBucketPolicy,
- HTTPMethod: "GET",
- HTTPPath: "/{Bucket}?policy",
- }
- if input == nil {
- input = &GetBucketPolicyInput{}
- }
- output = &GetBucketPolicyOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // GetBucketPolicy API operation for Amazon Simple Storage Service.
- //
- // Returns the policy of a specified bucket. If you are using an identity other
- // than the root user of the Amazon Web Services account that owns the bucket,
- // the calling identity must have the GetBucketPolicy permissions on the specified
- // bucket and belong to the bucket owner's account in order to use this operation.
- //
- // If you don't have GetBucketPolicy permissions, Amazon S3 returns a 403 Access
- // Denied error. If you have the correct permissions, but you're not using an
- // identity that belongs to the bucket owner's account, Amazon S3 returns a
- // 405 Method Not Allowed error.
- //
- // As a security precaution, the root user of the Amazon Web Services account
- // that owns a bucket can always use this operation, even if the policy explicitly
- // denies the root user the ability to perform this action.
- //
- // For more information about bucket policies, see Using Bucket Policies and
- // User Policies (https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html).
- //
- // The following action is related to GetBucketPolicy:
- //
- // - GetObject (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation GetBucketPolicy for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketPolicy
- func (c *S3) GetBucketPolicy(input *GetBucketPolicyInput) (*GetBucketPolicyOutput, error) {
- req, out := c.GetBucketPolicyRequest(input)
- return out, req.Send()
- }
- // GetBucketPolicyWithContext is the same as GetBucketPolicy with the addition of
- // the ability to pass a context and additional request options.
- //
- // See GetBucketPolicy 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 *S3) GetBucketPolicyWithContext(ctx aws.Context, input *GetBucketPolicyInput, opts ...request.Option) (*GetBucketPolicyOutput, error) {
- req, out := c.GetBucketPolicyRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opGetBucketPolicyStatus = "GetBucketPolicyStatus"
- // GetBucketPolicyStatusRequest generates a "aws/request.Request" representing the
- // client's request for the GetBucketPolicyStatus 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 GetBucketPolicyStatus for more information on using the GetBucketPolicyStatus
- // 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 GetBucketPolicyStatusRequest method.
- // req, resp := client.GetBucketPolicyStatusRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketPolicyStatus
- func (c *S3) GetBucketPolicyStatusRequest(input *GetBucketPolicyStatusInput) (req *request.Request, output *GetBucketPolicyStatusOutput) {
- op := &request.Operation{
- Name: opGetBucketPolicyStatus,
- HTTPMethod: "GET",
- HTTPPath: "/{Bucket}?policyStatus",
- }
- if input == nil {
- input = &GetBucketPolicyStatusInput{}
- }
- output = &GetBucketPolicyStatusOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // GetBucketPolicyStatus API operation for Amazon Simple Storage Service.
- //
- // Retrieves the policy status for an Amazon S3 bucket, indicating whether the
- // bucket is public. In order to use this operation, you must have the s3:GetBucketPolicyStatus
- // permission. For more information about Amazon S3 permissions, see Specifying
- // Permissions in a Policy (https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html).
- //
- // For more information about when Amazon S3 considers a bucket public, see
- // The Meaning of "Public" (https://docs.aws.amazon.com/AmazonS3/latest/dev/access-control-block-public-access.html#access-control-block-public-access-policy-status).
- //
- // The following operations are related to GetBucketPolicyStatus:
- //
- // - Using Amazon S3 Block Public Access (https://docs.aws.amazon.com/AmazonS3/latest/dev/access-control-block-public-access.html)
- //
- // - GetPublicAccessBlock (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetPublicAccessBlock.html)
- //
- // - PutPublicAccessBlock (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutPublicAccessBlock.html)
- //
- // - DeletePublicAccessBlock (https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeletePublicAccessBlock.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation GetBucketPolicyStatus for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketPolicyStatus
- func (c *S3) GetBucketPolicyStatus(input *GetBucketPolicyStatusInput) (*GetBucketPolicyStatusOutput, error) {
- req, out := c.GetBucketPolicyStatusRequest(input)
- return out, req.Send()
- }
- // GetBucketPolicyStatusWithContext is the same as GetBucketPolicyStatus with the addition of
- // the ability to pass a context and additional request options.
- //
- // See GetBucketPolicyStatus 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 *S3) GetBucketPolicyStatusWithContext(ctx aws.Context, input *GetBucketPolicyStatusInput, opts ...request.Option) (*GetBucketPolicyStatusOutput, error) {
- req, out := c.GetBucketPolicyStatusRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opGetBucketReplication = "GetBucketReplication"
- // GetBucketReplicationRequest generates a "aws/request.Request" representing the
- // client's request for the GetBucketReplication 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 GetBucketReplication for more information on using the GetBucketReplication
- // 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 GetBucketReplicationRequest method.
- // req, resp := client.GetBucketReplicationRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketReplication
- func (c *S3) GetBucketReplicationRequest(input *GetBucketReplicationInput) (req *request.Request, output *GetBucketReplicationOutput) {
- op := &request.Operation{
- Name: opGetBucketReplication,
- HTTPMethod: "GET",
- HTTPPath: "/{Bucket}?replication",
- }
- if input == nil {
- input = &GetBucketReplicationInput{}
- }
- output = &GetBucketReplicationOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // GetBucketReplication API operation for Amazon Simple Storage Service.
- //
- // Returns the replication configuration of a bucket.
- //
- // It can take a while to propagate the put or delete a replication configuration
- // to all Amazon S3 systems. Therefore, a get request soon after put or delete
- // can return a wrong result.
- //
- // For information about replication configuration, see Replication (https://docs.aws.amazon.com/AmazonS3/latest/dev/replication.html)
- // in the Amazon S3 User Guide.
- //
- // This action requires permissions for the s3:GetReplicationConfiguration action.
- // For more information about permissions, see Using Bucket Policies and User
- // Policies (https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html).
- //
- // If you include the Filter element in a replication configuration, you must
- // also include the DeleteMarkerReplication and Priority elements. The response
- // also returns those elements.
- //
- // For information about GetBucketReplication errors, see List of replication-related
- // error codes (https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#ReplicationErrorCodeList)
- //
- // The following operations are related to GetBucketReplication:
- //
- // - PutBucketReplication (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketReplication.html)
- //
- // - DeleteBucketReplication (https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketReplication.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation GetBucketReplication for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketReplication
- func (c *S3) GetBucketReplication(input *GetBucketReplicationInput) (*GetBucketReplicationOutput, error) {
- req, out := c.GetBucketReplicationRequest(input)
- return out, req.Send()
- }
- // GetBucketReplicationWithContext is the same as GetBucketReplication with the addition of
- // the ability to pass a context and additional request options.
- //
- // See GetBucketReplication 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 *S3) GetBucketReplicationWithContext(ctx aws.Context, input *GetBucketReplicationInput, opts ...request.Option) (*GetBucketReplicationOutput, error) {
- req, out := c.GetBucketReplicationRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opGetBucketRequestPayment = "GetBucketRequestPayment"
- // GetBucketRequestPaymentRequest generates a "aws/request.Request" representing the
- // client's request for the GetBucketRequestPayment 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 GetBucketRequestPayment for more information on using the GetBucketRequestPayment
- // 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 GetBucketRequestPaymentRequest method.
- // req, resp := client.GetBucketRequestPaymentRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketRequestPayment
- func (c *S3) GetBucketRequestPaymentRequest(input *GetBucketRequestPaymentInput) (req *request.Request, output *GetBucketRequestPaymentOutput) {
- op := &request.Operation{
- Name: opGetBucketRequestPayment,
- HTTPMethod: "GET",
- HTTPPath: "/{Bucket}?requestPayment",
- }
- if input == nil {
- input = &GetBucketRequestPaymentInput{}
- }
- output = &GetBucketRequestPaymentOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // GetBucketRequestPayment API operation for Amazon Simple Storage Service.
- //
- // Returns the request payment configuration of a bucket. To use this version
- // of the operation, you must be the bucket owner. For more information, see
- // Requester Pays Buckets (https://docs.aws.amazon.com/AmazonS3/latest/dev/RequesterPaysBuckets.html).
- //
- // The following operations are related to GetBucketRequestPayment:
- //
- // - ListObjects (https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjects.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation GetBucketRequestPayment for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketRequestPayment
- func (c *S3) GetBucketRequestPayment(input *GetBucketRequestPaymentInput) (*GetBucketRequestPaymentOutput, error) {
- req, out := c.GetBucketRequestPaymentRequest(input)
- return out, req.Send()
- }
- // GetBucketRequestPaymentWithContext is the same as GetBucketRequestPayment with the addition of
- // the ability to pass a context and additional request options.
- //
- // See GetBucketRequestPayment 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 *S3) GetBucketRequestPaymentWithContext(ctx aws.Context, input *GetBucketRequestPaymentInput, opts ...request.Option) (*GetBucketRequestPaymentOutput, error) {
- req, out := c.GetBucketRequestPaymentRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opGetBucketTagging = "GetBucketTagging"
- // GetBucketTaggingRequest generates a "aws/request.Request" representing the
- // client's request for the GetBucketTagging 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 GetBucketTagging for more information on using the GetBucketTagging
- // 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 GetBucketTaggingRequest method.
- // req, resp := client.GetBucketTaggingRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketTagging
- func (c *S3) GetBucketTaggingRequest(input *GetBucketTaggingInput) (req *request.Request, output *GetBucketTaggingOutput) {
- op := &request.Operation{
- Name: opGetBucketTagging,
- HTTPMethod: "GET",
- HTTPPath: "/{Bucket}?tagging",
- }
- if input == nil {
- input = &GetBucketTaggingInput{}
- }
- output = &GetBucketTaggingOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // GetBucketTagging API operation for Amazon Simple Storage Service.
- //
- // Returns the tag set associated with the bucket.
- //
- // To use this operation, you must have permission to perform the s3:GetBucketTagging
- // action. By default, the bucket owner has this permission and can grant this
- // permission to others.
- //
- // GetBucketTagging has the following special error:
- //
- // - Error code: NoSuchTagSet Description: There is no tag set associated
- // with the bucket.
- //
- // The following operations are related to GetBucketTagging:
- //
- // - PutBucketTagging (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketTagging.html)
- //
- // - DeleteBucketTagging (https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketTagging.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation GetBucketTagging for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketTagging
- func (c *S3) GetBucketTagging(input *GetBucketTaggingInput) (*GetBucketTaggingOutput, error) {
- req, out := c.GetBucketTaggingRequest(input)
- return out, req.Send()
- }
- // GetBucketTaggingWithContext is the same as GetBucketTagging with the addition of
- // the ability to pass a context and additional request options.
- //
- // See GetBucketTagging 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 *S3) GetBucketTaggingWithContext(ctx aws.Context, input *GetBucketTaggingInput, opts ...request.Option) (*GetBucketTaggingOutput, error) {
- req, out := c.GetBucketTaggingRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opGetBucketVersioning = "GetBucketVersioning"
- // GetBucketVersioningRequest generates a "aws/request.Request" representing the
- // client's request for the GetBucketVersioning 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 GetBucketVersioning for more information on using the GetBucketVersioning
- // 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 GetBucketVersioningRequest method.
- // req, resp := client.GetBucketVersioningRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketVersioning
- func (c *S3) GetBucketVersioningRequest(input *GetBucketVersioningInput) (req *request.Request, output *GetBucketVersioningOutput) {
- op := &request.Operation{
- Name: opGetBucketVersioning,
- HTTPMethod: "GET",
- HTTPPath: "/{Bucket}?versioning",
- }
- if input == nil {
- input = &GetBucketVersioningInput{}
- }
- output = &GetBucketVersioningOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // GetBucketVersioning API operation for Amazon Simple Storage Service.
- //
- // Returns the versioning state of a bucket.
- //
- // To retrieve the versioning state of a bucket, you must be the bucket owner.
- //
- // This implementation also returns the MFA Delete status of the versioning
- // state. If the MFA Delete status is enabled, the bucket owner must use an
- // authentication device to change the versioning state of the bucket.
- //
- // The following operations are related to GetBucketVersioning:
- //
- // - GetObject (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html)
- //
- // - PutObject (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html)
- //
- // - DeleteObject (https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation GetBucketVersioning for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketVersioning
- func (c *S3) GetBucketVersioning(input *GetBucketVersioningInput) (*GetBucketVersioningOutput, error) {
- req, out := c.GetBucketVersioningRequest(input)
- return out, req.Send()
- }
- // GetBucketVersioningWithContext is the same as GetBucketVersioning with the addition of
- // the ability to pass a context and additional request options.
- //
- // See GetBucketVersioning 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 *S3) GetBucketVersioningWithContext(ctx aws.Context, input *GetBucketVersioningInput, opts ...request.Option) (*GetBucketVersioningOutput, error) {
- req, out := c.GetBucketVersioningRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opGetBucketWebsite = "GetBucketWebsite"
- // GetBucketWebsiteRequest generates a "aws/request.Request" representing the
- // client's request for the GetBucketWebsite 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 GetBucketWebsite for more information on using the GetBucketWebsite
- // 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 GetBucketWebsiteRequest method.
- // req, resp := client.GetBucketWebsiteRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketWebsite
- func (c *S3) GetBucketWebsiteRequest(input *GetBucketWebsiteInput) (req *request.Request, output *GetBucketWebsiteOutput) {
- op := &request.Operation{
- Name: opGetBucketWebsite,
- HTTPMethod: "GET",
- HTTPPath: "/{Bucket}?website",
- }
- if input == nil {
- input = &GetBucketWebsiteInput{}
- }
- output = &GetBucketWebsiteOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // GetBucketWebsite API operation for Amazon Simple Storage Service.
- //
- // Returns the website configuration for a bucket. To host website on Amazon
- // S3, you can configure a bucket as website by adding a website configuration.
- // For more information about hosting websites, see Hosting Websites on Amazon
- // S3 (https://docs.aws.amazon.com/AmazonS3/latest/dev/WebsiteHosting.html).
- //
- // This GET action requires the S3:GetBucketWebsite permission. By default,
- // only the bucket owner can read the bucket website configuration. However,
- // bucket owners can allow other users to read the website configuration by
- // writing a bucket policy granting them the S3:GetBucketWebsite permission.
- //
- // The following operations are related to DeleteBucketWebsite:
- //
- // - DeleteBucketWebsite (https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketWebsite.html)
- //
- // - PutBucketWebsite (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketWebsite.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation GetBucketWebsite for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketWebsite
- func (c *S3) GetBucketWebsite(input *GetBucketWebsiteInput) (*GetBucketWebsiteOutput, error) {
- req, out := c.GetBucketWebsiteRequest(input)
- return out, req.Send()
- }
- // GetBucketWebsiteWithContext is the same as GetBucketWebsite with the addition of
- // the ability to pass a context and additional request options.
- //
- // See GetBucketWebsite 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 *S3) GetBucketWebsiteWithContext(ctx aws.Context, input *GetBucketWebsiteInput, opts ...request.Option) (*GetBucketWebsiteOutput, error) {
- req, out := c.GetBucketWebsiteRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opGetObject = "GetObject"
- // GetObjectRequest generates a "aws/request.Request" representing the
- // client's request for the GetObject 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 GetObject for more information on using the GetObject
- // 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 GetObjectRequest method.
- // req, resp := client.GetObjectRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetObject
- func (c *S3) GetObjectRequest(input *GetObjectInput) (req *request.Request, output *GetObjectOutput) {
- op := &request.Operation{
- Name: opGetObject,
- HTTPMethod: "GET",
- HTTPPath: "/{Bucket}/{Key+}",
- }
- if input == nil {
- input = &GetObjectInput{}
- }
- output = &GetObjectOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // GetObject API operation for Amazon Simple Storage Service.
- //
- // Retrieves objects from Amazon S3. To use GET, you must have READ access to
- // the object. If you grant READ access to the anonymous user, you can return
- // the object without using an authorization header.
- //
- // An Amazon S3 bucket has no directory hierarchy such as you would find in
- // a typical computer file system. You can, however, create a logical hierarchy
- // by using object key names that imply a folder structure. For example, instead
- // of naming an object sample.jpg, you can name it photos/2006/February/sample.jpg.
- //
- // To get an object from such a logical hierarchy, specify the full key name
- // for the object in the GET operation. For a virtual hosted-style request example,
- // if you have the object photos/2006/February/sample.jpg, specify the resource
- // as /photos/2006/February/sample.jpg. For a path-style request example, if
- // you have the object photos/2006/February/sample.jpg in the bucket named examplebucket,
- // specify the resource as /examplebucket/photos/2006/February/sample.jpg. For
- // more information about request types, see HTTP Host Header Bucket Specification
- // (https://docs.aws.amazon.com/AmazonS3/latest/dev/VirtualHosting.html#VirtualHostingSpecifyBucket).
- //
- // For more information about returning the ACL of an object, see GetObjectAcl
- // (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAcl.html).
- //
- // If the object you are retrieving is stored in the S3 Glacier or S3 Glacier
- // Deep Archive storage class, or S3 Intelligent-Tiering Archive or S3 Intelligent-Tiering
- // Deep Archive tiers, before you can retrieve the object you must first restore
- // a copy using RestoreObject (https://docs.aws.amazon.com/AmazonS3/latest/API/API_RestoreObject.html).
- // Otherwise, this action returns an InvalidObjectStateError error. For information
- // about restoring archived objects, see Restoring Archived Objects (https://docs.aws.amazon.com/AmazonS3/latest/dev/restoring-objects.html).
- //
- // Encryption request headers, like x-amz-server-side-encryption, should not
- // be sent for GET requests if your object uses server-side encryption with
- // KMS keys (SSE-KMS) or server-side encryption with Amazon S3–managed encryption
- // keys (SSE-S3). If your object does use these types of keys, you’ll get
- // an HTTP 400 BadRequest error.
- //
- // If you encrypt an object by using server-side encryption with customer-provided
- // encryption keys (SSE-C) when you store the object in Amazon S3, then when
- // you GET the object, you must use the following headers:
- //
- // - x-amz-server-side-encryption-customer-algorithm
- //
- // - x-amz-server-side-encryption-customer-key
- //
- // - x-amz-server-side-encryption-customer-key-MD5
- //
- // For more information about SSE-C, see Server-Side Encryption (Using Customer-Provided
- // Encryption Keys) (https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html).
- //
- // Assuming you have the relevant permission to read object tags, the response
- // also returns the x-amz-tagging-count header that provides the count of number
- // of tags associated with the object. You can use GetObjectTagging (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectTagging.html)
- // to retrieve the tag set associated with an object.
- //
- // # Permissions
- //
- // You need the relevant read object (or version) permission for this operation.
- // For more information, see Specifying Permissions in a Policy (https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html).
- // If the object you request does not exist, the error Amazon S3 returns depends
- // on whether you also have the s3:ListBucket permission.
- //
- // - If you have the s3:ListBucket permission on the bucket, Amazon S3 will
- // return an HTTP status code 404 ("no such key") error.
- //
- // - If you don’t have the s3:ListBucket permission, Amazon S3 will return
- // an HTTP status code 403 ("access denied") error.
- //
- // # Versioning
- //
- // By default, the GET action returns the current version of an object. To return
- // a different version, use the versionId subresource.
- //
- // - If you supply a versionId, you need the s3:GetObjectVersion permission
- // to access a specific version of an object. If you request a specific version,
- // you do not need to have the s3:GetObject permission.
- //
- // - If the current version of the object is a delete marker, Amazon S3 behaves
- // as if the object was deleted and includes x-amz-delete-marker: true in
- // the response.
- //
- // For more information about versioning, see PutBucketVersioning (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketVersioning.html).
- //
- // # Overriding Response Header Values
- //
- // There are times when you want to override certain response header values
- // in a GET response. For example, you might override the Content-Disposition
- // response header value in your GET request.
- //
- // You can override values for a set of response headers using the following
- // query parameters. These response header values are sent only on a successful
- // request, that is, when status code 200 OK is returned. The set of headers
- // you can override using these parameters is a subset of the headers that Amazon
- // S3 accepts when you create an object. The response headers that you can override
- // for the GET response are Content-Type, Content-Language, Expires, Cache-Control,
- // Content-Disposition, and Content-Encoding. To override these header values
- // in the GET response, you use the following request parameters.
- //
- // You must sign the request, either using an Authorization header or a presigned
- // URL, when using these parameters. They cannot be used with an unsigned (anonymous)
- // request.
- //
- // - response-content-type
- //
- // - response-content-language
- //
- // - response-expires
- //
- // - response-cache-control
- //
- // - response-content-disposition
- //
- // - response-content-encoding
- //
- // # Additional Considerations about Request Headers
- //
- // If both of the If-Match and If-Unmodified-Since headers are present in the
- // request as follows: If-Match condition evaluates to true, and; If-Unmodified-Since
- // condition evaluates to false; then, S3 returns 200 OK and the data requested.
- //
- // If both of the If-None-Match and If-Modified-Since headers are present in
- // the request as follows:If-None-Match condition evaluates to false, and; If-Modified-Since
- // condition evaluates to true; then, S3 returns 304 Not Modified response code.
- //
- // For more information about conditional requests, see RFC 7232 (https://tools.ietf.org/html/rfc7232).
- //
- // The following operations are related to GetObject:
- //
- // - ListBuckets (https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html)
- //
- // - GetObjectAcl (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAcl.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation GetObject for usage and error information.
- //
- // Returned Error Codes:
- //
- // - ErrCodeNoSuchKey "NoSuchKey"
- // The specified key does not exist.
- //
- // - ErrCodeInvalidObjectState "InvalidObjectState"
- // Object is archived and inaccessible until restored.
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetObject
- func (c *S3) GetObject(input *GetObjectInput) (*GetObjectOutput, error) {
- req, out := c.GetObjectRequest(input)
- return out, req.Send()
- }
- // GetObjectWithContext is the same as GetObject with the addition of
- // the ability to pass a context and additional request options.
- //
- // See GetObject 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 *S3) GetObjectWithContext(ctx aws.Context, input *GetObjectInput, opts ...request.Option) (*GetObjectOutput, error) {
- req, out := c.GetObjectRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opGetObjectAcl = "GetObjectAcl"
- // GetObjectAclRequest generates a "aws/request.Request" representing the
- // client's request for the GetObjectAcl 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 GetObjectAcl for more information on using the GetObjectAcl
- // 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 GetObjectAclRequest method.
- // req, resp := client.GetObjectAclRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetObjectAcl
- func (c *S3) GetObjectAclRequest(input *GetObjectAclInput) (req *request.Request, output *GetObjectAclOutput) {
- op := &request.Operation{
- Name: opGetObjectAcl,
- HTTPMethod: "GET",
- HTTPPath: "/{Bucket}/{Key+}?acl",
- }
- if input == nil {
- input = &GetObjectAclInput{}
- }
- output = &GetObjectAclOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // GetObjectAcl API operation for Amazon Simple Storage Service.
- //
- // Returns the access control list (ACL) of an object. To use this operation,
- // you must have s3:GetObjectAcl permissions or READ_ACP access to the object.
- // For more information, see Mapping of ACL permissions and access policy permissions
- // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/acl-overview.html#acl-access-policy-permission-mapping)
- // in the Amazon S3 User Guide
- //
- // This action is not supported by Amazon S3 on Outposts.
- //
- // # Versioning
- //
- // By default, GET returns ACL information about the current version of an object.
- // To return ACL information about a different version, use the versionId subresource.
- //
- // If your bucket uses the bucket owner enforced setting for S3 Object Ownership,
- // requests to read ACLs are still supported and return the bucket-owner-full-control
- // ACL with the owner being the account that created the bucket. For more information,
- // see Controlling object ownership and disabling ACLs (https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html)
- // in the Amazon S3 User Guide.
- //
- // The following operations are related to GetObjectAcl:
- //
- // - GetObject (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html)
- //
- // - GetObjectAttributes (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAttributes.html)
- //
- // - DeleteObject (https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html)
- //
- // - PutObject (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation GetObjectAcl for usage and error information.
- //
- // Returned Error Codes:
- // - ErrCodeNoSuchKey "NoSuchKey"
- // The specified key does not exist.
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetObjectAcl
- func (c *S3) GetObjectAcl(input *GetObjectAclInput) (*GetObjectAclOutput, error) {
- req, out := c.GetObjectAclRequest(input)
- return out, req.Send()
- }
- // GetObjectAclWithContext is the same as GetObjectAcl with the addition of
- // the ability to pass a context and additional request options.
- //
- // See GetObjectAcl 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 *S3) GetObjectAclWithContext(ctx aws.Context, input *GetObjectAclInput, opts ...request.Option) (*GetObjectAclOutput, error) {
- req, out := c.GetObjectAclRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opGetObjectAttributes = "GetObjectAttributes"
- // GetObjectAttributesRequest generates a "aws/request.Request" representing the
- // client's request for the GetObjectAttributes 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 GetObjectAttributes for more information on using the GetObjectAttributes
- // 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 GetObjectAttributesRequest method.
- // req, resp := client.GetObjectAttributesRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetObjectAttributes
- func (c *S3) GetObjectAttributesRequest(input *GetObjectAttributesInput) (req *request.Request, output *GetObjectAttributesOutput) {
- op := &request.Operation{
- Name: opGetObjectAttributes,
- HTTPMethod: "GET",
- HTTPPath: "/{Bucket}/{Key+}?attributes",
- }
- if input == nil {
- input = &GetObjectAttributesInput{}
- }
- output = &GetObjectAttributesOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // GetObjectAttributes API operation for Amazon Simple Storage Service.
- //
- // Retrieves all the metadata from an object without returning the object itself.
- // This action is useful if you're interested only in an object's metadata.
- // To use GetObjectAttributes, you must have READ access to the object.
- //
- // GetObjectAttributes combines the functionality of GetObjectAcl, GetObjectLegalHold,
- // GetObjectLockConfiguration, GetObjectRetention, GetObjectTagging, HeadObject,
- // and ListParts. All of the data returned with each of those individual calls
- // can be returned with a single call to GetObjectAttributes.
- //
- // If you encrypt an object by using server-side encryption with customer-provided
- // encryption keys (SSE-C) when you store the object in Amazon S3, then when
- // you retrieve the metadata from the object, you must use the following headers:
- //
- // - x-amz-server-side-encryption-customer-algorithm
- //
- // - x-amz-server-side-encryption-customer-key
- //
- // - x-amz-server-side-encryption-customer-key-MD5
- //
- // For more information about SSE-C, see Server-Side Encryption (Using Customer-Provided
- // Encryption Keys) (https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html)
- // in the Amazon S3 User Guide.
- //
- // - Encryption request headers, such as x-amz-server-side-encryption, should
- // not be sent for GET requests if your object uses server-side encryption
- // with Amazon Web Services KMS keys stored in Amazon Web Services Key Management
- // Service (SSE-KMS) or server-side encryption with Amazon S3 managed encryption
- // keys (SSE-S3). If your object does use these types of keys, you'll get
- // an HTTP 400 Bad Request error.
- //
- // - The last modified property in this case is the creation date of the
- // object.
- //
- // Consider the following when using request headers:
- //
- // - If both of the If-Match and If-Unmodified-Since headers are present
- // in the request as follows, then Amazon S3 returns the HTTP status code
- // 200 OK and the data requested: If-Match condition evaluates to true. If-Unmodified-Since
- // condition evaluates to false.
- //
- // - If both of the If-None-Match and If-Modified-Since headers are present
- // in the request as follows, then Amazon S3 returns the HTTP status code
- // 304 Not Modified: If-None-Match condition evaluates to false. If-Modified-Since
- // condition evaluates to true.
- //
- // For more information about conditional requests, see RFC 7232 (https://tools.ietf.org/html/rfc7232).
- //
- // # Permissions
- //
- // The permissions that you need to use this operation depend on whether the
- // bucket is versioned. If the bucket is versioned, you need both the s3:GetObjectVersion
- // and s3:GetObjectVersionAttributes permissions for this operation. If the
- // bucket is not versioned, you need the s3:GetObject and s3:GetObjectAttributes
- // permissions. For more information, see Specifying Permissions in a Policy
- // (https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html)
- // in the Amazon S3 User Guide. If the object that you request does not exist,
- // the error Amazon S3 returns depends on whether you also have the s3:ListBucket
- // permission.
- //
- // - If you have the s3:ListBucket permission on the bucket, Amazon S3 returns
- // an HTTP status code 404 Not Found ("no such key") error.
- //
- // - If you don't have the s3:ListBucket permission, Amazon S3 returns an
- // HTTP status code 403 Forbidden ("access denied") error.
- //
- // The following actions are related to GetObjectAttributes:
- //
- // - GetObject (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html)
- //
- // - GetObjectAcl (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAcl.html)
- //
- // - GetObjectLegalHold (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectLegalHold.html)
- //
- // - GetObjectLockConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectLockConfiguration.html)
- //
- // - GetObjectRetention (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectRetention.html)
- //
- // - GetObjectTagging (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectTagging.html)
- //
- // - HeadObject (https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadObject.html)
- //
- // - ListParts (https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation GetObjectAttributes for usage and error information.
- //
- // Returned Error Codes:
- // - ErrCodeNoSuchKey "NoSuchKey"
- // The specified key does not exist.
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetObjectAttributes
- func (c *S3) GetObjectAttributes(input *GetObjectAttributesInput) (*GetObjectAttributesOutput, error) {
- req, out := c.GetObjectAttributesRequest(input)
- return out, req.Send()
- }
- // GetObjectAttributesWithContext is the same as GetObjectAttributes with the addition of
- // the ability to pass a context and additional request options.
- //
- // See GetObjectAttributes 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 *S3) GetObjectAttributesWithContext(ctx aws.Context, input *GetObjectAttributesInput, opts ...request.Option) (*GetObjectAttributesOutput, error) {
- req, out := c.GetObjectAttributesRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opGetObjectLegalHold = "GetObjectLegalHold"
- // GetObjectLegalHoldRequest generates a "aws/request.Request" representing the
- // client's request for the GetObjectLegalHold 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 GetObjectLegalHold for more information on using the GetObjectLegalHold
- // 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 GetObjectLegalHoldRequest method.
- // req, resp := client.GetObjectLegalHoldRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetObjectLegalHold
- func (c *S3) GetObjectLegalHoldRequest(input *GetObjectLegalHoldInput) (req *request.Request, output *GetObjectLegalHoldOutput) {
- op := &request.Operation{
- Name: opGetObjectLegalHold,
- HTTPMethod: "GET",
- HTTPPath: "/{Bucket}/{Key+}?legal-hold",
- }
- if input == nil {
- input = &GetObjectLegalHoldInput{}
- }
- output = &GetObjectLegalHoldOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // GetObjectLegalHold API operation for Amazon Simple Storage Service.
- //
- // Gets an object's current legal hold status. For more information, see Locking
- // Objects (https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html).
- //
- // This action is not supported by Amazon S3 on Outposts.
- //
- // The following action is related to GetObjectLegalHold:
- //
- // - GetObjectAttributes (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAttributes.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation GetObjectLegalHold for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetObjectLegalHold
- func (c *S3) GetObjectLegalHold(input *GetObjectLegalHoldInput) (*GetObjectLegalHoldOutput, error) {
- req, out := c.GetObjectLegalHoldRequest(input)
- return out, req.Send()
- }
- // GetObjectLegalHoldWithContext is the same as GetObjectLegalHold with the addition of
- // the ability to pass a context and additional request options.
- //
- // See GetObjectLegalHold 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 *S3) GetObjectLegalHoldWithContext(ctx aws.Context, input *GetObjectLegalHoldInput, opts ...request.Option) (*GetObjectLegalHoldOutput, error) {
- req, out := c.GetObjectLegalHoldRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opGetObjectLockConfiguration = "GetObjectLockConfiguration"
- // GetObjectLockConfigurationRequest generates a "aws/request.Request" representing the
- // client's request for the GetObjectLockConfiguration 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 GetObjectLockConfiguration for more information on using the GetObjectLockConfiguration
- // 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 GetObjectLockConfigurationRequest method.
- // req, resp := client.GetObjectLockConfigurationRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetObjectLockConfiguration
- func (c *S3) GetObjectLockConfigurationRequest(input *GetObjectLockConfigurationInput) (req *request.Request, output *GetObjectLockConfigurationOutput) {
- op := &request.Operation{
- Name: opGetObjectLockConfiguration,
- HTTPMethod: "GET",
- HTTPPath: "/{Bucket}?object-lock",
- }
- if input == nil {
- input = &GetObjectLockConfigurationInput{}
- }
- output = &GetObjectLockConfigurationOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // GetObjectLockConfiguration API operation for Amazon Simple Storage Service.
- //
- // Gets the Object Lock configuration for a bucket. The rule specified in the
- // Object Lock configuration will be applied by default to every new object
- // placed in the specified bucket. For more information, see Locking Objects
- // (https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html).
- //
- // The following action is related to GetObjectLockConfiguration:
- //
- // - GetObjectAttributes (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAttributes.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation GetObjectLockConfiguration for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetObjectLockConfiguration
- func (c *S3) GetObjectLockConfiguration(input *GetObjectLockConfigurationInput) (*GetObjectLockConfigurationOutput, error) {
- req, out := c.GetObjectLockConfigurationRequest(input)
- return out, req.Send()
- }
- // GetObjectLockConfigurationWithContext is the same as GetObjectLockConfiguration with the addition of
- // the ability to pass a context and additional request options.
- //
- // See GetObjectLockConfiguration 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 *S3) GetObjectLockConfigurationWithContext(ctx aws.Context, input *GetObjectLockConfigurationInput, opts ...request.Option) (*GetObjectLockConfigurationOutput, error) {
- req, out := c.GetObjectLockConfigurationRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opGetObjectRetention = "GetObjectRetention"
- // GetObjectRetentionRequest generates a "aws/request.Request" representing the
- // client's request for the GetObjectRetention 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 GetObjectRetention for more information on using the GetObjectRetention
- // 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 GetObjectRetentionRequest method.
- // req, resp := client.GetObjectRetentionRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetObjectRetention
- func (c *S3) GetObjectRetentionRequest(input *GetObjectRetentionInput) (req *request.Request, output *GetObjectRetentionOutput) {
- op := &request.Operation{
- Name: opGetObjectRetention,
- HTTPMethod: "GET",
- HTTPPath: "/{Bucket}/{Key+}?retention",
- }
- if input == nil {
- input = &GetObjectRetentionInput{}
- }
- output = &GetObjectRetentionOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // GetObjectRetention API operation for Amazon Simple Storage Service.
- //
- // Retrieves an object's retention settings. For more information, see Locking
- // Objects (https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html).
- //
- // This action is not supported by Amazon S3 on Outposts.
- //
- // The following action is related to GetObjectRetention:
- //
- // - GetObjectAttributes (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAttributes.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation GetObjectRetention for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetObjectRetention
- func (c *S3) GetObjectRetention(input *GetObjectRetentionInput) (*GetObjectRetentionOutput, error) {
- req, out := c.GetObjectRetentionRequest(input)
- return out, req.Send()
- }
- // GetObjectRetentionWithContext is the same as GetObjectRetention with the addition of
- // the ability to pass a context and additional request options.
- //
- // See GetObjectRetention 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 *S3) GetObjectRetentionWithContext(ctx aws.Context, input *GetObjectRetentionInput, opts ...request.Option) (*GetObjectRetentionOutput, error) {
- req, out := c.GetObjectRetentionRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opGetObjectTagging = "GetObjectTagging"
- // GetObjectTaggingRequest generates a "aws/request.Request" representing the
- // client's request for the GetObjectTagging 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 GetObjectTagging for more information on using the GetObjectTagging
- // 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 GetObjectTaggingRequest method.
- // req, resp := client.GetObjectTaggingRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetObjectTagging
- func (c *S3) GetObjectTaggingRequest(input *GetObjectTaggingInput) (req *request.Request, output *GetObjectTaggingOutput) {
- op := &request.Operation{
- Name: opGetObjectTagging,
- HTTPMethod: "GET",
- HTTPPath: "/{Bucket}/{Key+}?tagging",
- }
- if input == nil {
- input = &GetObjectTaggingInput{}
- }
- output = &GetObjectTaggingOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // GetObjectTagging API operation for Amazon Simple Storage Service.
- //
- // Returns the tag-set of an object. You send the GET request against the tagging
- // subresource associated with the object.
- //
- // To use this operation, you must have permission to perform the s3:GetObjectTagging
- // action. By default, the GET action returns information about current version
- // of an object. For a versioned bucket, you can have multiple versions of an
- // object in your bucket. To retrieve tags of any other version, use the versionId
- // query parameter. You also need permission for the s3:GetObjectVersionTagging
- // action.
- //
- // By default, the bucket owner has this permission and can grant this permission
- // to others.
- //
- // For information about the Amazon S3 object tagging feature, see Object Tagging
- // (https://docs.aws.amazon.com/AmazonS3/latest/dev/object-tagging.html).
- //
- // The following actions are related to GetObjectTagging:
- //
- // - DeleteObjectTagging (https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObjectTagging.html)
- //
- // - GetObjectAttributes (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAttributes.html)
- //
- // - PutObjectTagging (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectTagging.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation GetObjectTagging for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetObjectTagging
- func (c *S3) GetObjectTagging(input *GetObjectTaggingInput) (*GetObjectTaggingOutput, error) {
- req, out := c.GetObjectTaggingRequest(input)
- return out, req.Send()
- }
- // GetObjectTaggingWithContext is the same as GetObjectTagging with the addition of
- // the ability to pass a context and additional request options.
- //
- // See GetObjectTagging 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 *S3) GetObjectTaggingWithContext(ctx aws.Context, input *GetObjectTaggingInput, opts ...request.Option) (*GetObjectTaggingOutput, error) {
- req, out := c.GetObjectTaggingRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opGetObjectTorrent = "GetObjectTorrent"
- // GetObjectTorrentRequest generates a "aws/request.Request" representing the
- // client's request for the GetObjectTorrent 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 GetObjectTorrent for more information on using the GetObjectTorrent
- // 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 GetObjectTorrentRequest method.
- // req, resp := client.GetObjectTorrentRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetObjectTorrent
- func (c *S3) GetObjectTorrentRequest(input *GetObjectTorrentInput) (req *request.Request, output *GetObjectTorrentOutput) {
- op := &request.Operation{
- Name: opGetObjectTorrent,
- HTTPMethod: "GET",
- HTTPPath: "/{Bucket}/{Key+}?torrent",
- }
- if input == nil {
- input = &GetObjectTorrentInput{}
- }
- output = &GetObjectTorrentOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // GetObjectTorrent API operation for Amazon Simple Storage Service.
- //
- // Returns torrent files from a bucket. BitTorrent can save you bandwidth when
- // you're distributing large files. For more information about BitTorrent, see
- // Using BitTorrent with Amazon S3 (https://docs.aws.amazon.com/AmazonS3/latest/dev/S3Torrent.html).
- //
- // You can get torrent only for objects that are less than 5 GB in size, and
- // that are not encrypted using server-side encryption with a customer-provided
- // encryption key.
- //
- // To use GET, you must have READ access to the object.
- //
- // This action is not supported by Amazon S3 on Outposts.
- //
- // The following action is related to GetObjectTorrent:
- //
- // - GetObject (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation GetObjectTorrent for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetObjectTorrent
- func (c *S3) GetObjectTorrent(input *GetObjectTorrentInput) (*GetObjectTorrentOutput, error) {
- req, out := c.GetObjectTorrentRequest(input)
- return out, req.Send()
- }
- // GetObjectTorrentWithContext is the same as GetObjectTorrent with the addition of
- // the ability to pass a context and additional request options.
- //
- // See GetObjectTorrent 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 *S3) GetObjectTorrentWithContext(ctx aws.Context, input *GetObjectTorrentInput, opts ...request.Option) (*GetObjectTorrentOutput, error) {
- req, out := c.GetObjectTorrentRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opGetPublicAccessBlock = "GetPublicAccessBlock"
- // GetPublicAccessBlockRequest generates a "aws/request.Request" representing the
- // client's request for the GetPublicAccessBlock 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 GetPublicAccessBlock for more information on using the GetPublicAccessBlock
- // 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 GetPublicAccessBlockRequest method.
- // req, resp := client.GetPublicAccessBlockRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetPublicAccessBlock
- func (c *S3) GetPublicAccessBlockRequest(input *GetPublicAccessBlockInput) (req *request.Request, output *GetPublicAccessBlockOutput) {
- op := &request.Operation{
- Name: opGetPublicAccessBlock,
- HTTPMethod: "GET",
- HTTPPath: "/{Bucket}?publicAccessBlock",
- }
- if input == nil {
- input = &GetPublicAccessBlockInput{}
- }
- output = &GetPublicAccessBlockOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // GetPublicAccessBlock API operation for Amazon Simple Storage Service.
- //
- // Retrieves the PublicAccessBlock configuration for an Amazon S3 bucket. To
- // use this operation, you must have the s3:GetBucketPublicAccessBlock permission.
- // For more information about Amazon S3 permissions, see Specifying Permissions
- // in a Policy (https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html).
- //
- // When Amazon S3 evaluates the PublicAccessBlock configuration for a bucket
- // or an object, it checks the PublicAccessBlock configuration for both the
- // bucket (or the bucket that contains the object) and the bucket owner's account.
- // If the PublicAccessBlock settings are different between the bucket and the
- // account, Amazon S3 uses the most restrictive combination of the bucket-level
- // and account-level settings.
- //
- // For more information about when Amazon S3 considers a bucket or an object
- // public, see The Meaning of "Public" (https://docs.aws.amazon.com/AmazonS3/latest/dev/access-control-block-public-access.html#access-control-block-public-access-policy-status).
- //
- // The following operations are related to GetPublicAccessBlock:
- //
- // - Using Amazon S3 Block Public Access (https://docs.aws.amazon.com/AmazonS3/latest/dev/access-control-block-public-access.html)
- //
- // - PutPublicAccessBlock (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutPublicAccessBlock.html)
- //
- // - GetPublicAccessBlock (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetPublicAccessBlock.html)
- //
- // - DeletePublicAccessBlock (https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeletePublicAccessBlock.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation GetPublicAccessBlock for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetPublicAccessBlock
- func (c *S3) GetPublicAccessBlock(input *GetPublicAccessBlockInput) (*GetPublicAccessBlockOutput, error) {
- req, out := c.GetPublicAccessBlockRequest(input)
- return out, req.Send()
- }
- // GetPublicAccessBlockWithContext is the same as GetPublicAccessBlock with the addition of
- // the ability to pass a context and additional request options.
- //
- // See GetPublicAccessBlock 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 *S3) GetPublicAccessBlockWithContext(ctx aws.Context, input *GetPublicAccessBlockInput, opts ...request.Option) (*GetPublicAccessBlockOutput, error) {
- req, out := c.GetPublicAccessBlockRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opHeadBucket = "HeadBucket"
- // HeadBucketRequest generates a "aws/request.Request" representing the
- // client's request for the HeadBucket 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 HeadBucket for more information on using the HeadBucket
- // 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 HeadBucketRequest method.
- // req, resp := client.HeadBucketRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/HeadBucket
- func (c *S3) HeadBucketRequest(input *HeadBucketInput) (req *request.Request, output *HeadBucketOutput) {
- op := &request.Operation{
- Name: opHeadBucket,
- HTTPMethod: "HEAD",
- HTTPPath: "/{Bucket}",
- }
- if input == nil {
- input = &HeadBucketInput{}
- }
- output = &HeadBucketOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Swap(restxml.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler)
- return
- }
- // HeadBucket API operation for Amazon Simple Storage Service.
- //
- // This action is useful to determine if a bucket exists and you have permission
- // to access it. The action returns a 200 OK if the bucket exists and you have
- // permission to access it.
- //
- // If the bucket does not exist or you do not have permission to access it,
- // the HEAD request returns a generic 404 Not Found or 403 Forbidden code. A
- // message body is not included, so you cannot determine the exception beyond
- // these error codes.
- //
- // To use this operation, you must have permissions to perform the s3:ListBucket
- // action. The bucket owner has this permission by default and can grant this
- // permission to others. For more information about permissions, see Permissions
- // Related to Bucket Subresource Operations (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources)
- // and Managing Access Permissions to Your Amazon S3 Resources (https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html).
- //
- // To use this API against an access point, you must provide the alias of the
- // access point in place of the bucket name or specify the access point ARN.
- // When using the access point ARN, you must direct requests to the access point
- // hostname. The access point hostname takes the form AccessPointName-AccountId.s3-accesspoint.Region.amazonaws.com.
- // When using the Amazon Web Services SDKs, you provide the ARN in place of
- // the bucket name. For more information see, Using access points (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html).
- //
- // 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 Amazon Simple Storage Service's
- // API operation HeadBucket for usage and error information.
- //
- // Returned Error Codes:
- // - ErrCodeNoSuchBucket "NoSuchBucket"
- // The specified bucket does not exist.
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/HeadBucket
- func (c *S3) HeadBucket(input *HeadBucketInput) (*HeadBucketOutput, error) {
- req, out := c.HeadBucketRequest(input)
- return out, req.Send()
- }
- // HeadBucketWithContext is the same as HeadBucket with the addition of
- // the ability to pass a context and additional request options.
- //
- // See HeadBucket 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 *S3) HeadBucketWithContext(ctx aws.Context, input *HeadBucketInput, opts ...request.Option) (*HeadBucketOutput, error) {
- req, out := c.HeadBucketRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opHeadObject = "HeadObject"
- // HeadObjectRequest generates a "aws/request.Request" representing the
- // client's request for the HeadObject 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 HeadObject for more information on using the HeadObject
- // 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 HeadObjectRequest method.
- // req, resp := client.HeadObjectRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/HeadObject
- func (c *S3) HeadObjectRequest(input *HeadObjectInput) (req *request.Request, output *HeadObjectOutput) {
- op := &request.Operation{
- Name: opHeadObject,
- HTTPMethod: "HEAD",
- HTTPPath: "/{Bucket}/{Key+}",
- }
- if input == nil {
- input = &HeadObjectInput{}
- }
- output = &HeadObjectOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // HeadObject API operation for Amazon Simple Storage Service.
- //
- // The HEAD action retrieves metadata from an object without returning the object
- // itself. This action is useful if you're only interested in an object's metadata.
- // To use HEAD, you must have READ access to the object.
- //
- // A HEAD request has the same options as a GET action on an object. The response
- // is identical to the GET response except that there is no response body. Because
- // of this, if the HEAD request generates an error, it returns a generic 404
- // Not Found or 403 Forbidden code. It is not possible to retrieve the exact
- // exception beyond these error codes.
- //
- // If you encrypt an object by using server-side encryption with customer-provided
- // encryption keys (SSE-C) when you store the object in Amazon S3, then when
- // you retrieve the metadata from the object, you must use the following headers:
- //
- // - x-amz-server-side-encryption-customer-algorithm
- //
- // - x-amz-server-side-encryption-customer-key
- //
- // - x-amz-server-side-encryption-customer-key-MD5
- //
- // For more information about SSE-C, see Server-Side Encryption (Using Customer-Provided
- // Encryption Keys) (https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html).
- //
- // - Encryption request headers, like x-amz-server-side-encryption, should
- // not be sent for GET requests if your object uses server-side encryption
- // with KMS keys (SSE-KMS) or server-side encryption with Amazon S3–managed
- // encryption keys (SSE-S3). If your object does use these types of keys,
- // you’ll get an HTTP 400 BadRequest error.
- //
- // - The last modified property in this case is the creation date of the
- // object.
- //
- // Request headers are limited to 8 KB in size. For more information, see Common
- // Request Headers (https://docs.aws.amazon.com/AmazonS3/latest/API/RESTCommonRequestHeaders.html).
- //
- // Consider the following when using request headers:
- //
- // - Consideration 1 – If both of the If-Match and If-Unmodified-Since
- // headers are present in the request as follows: If-Match condition evaluates
- // to true, and; If-Unmodified-Since condition evaluates to false; Then Amazon
- // S3 returns 200 OK and the data requested.
- //
- // - Consideration 2 – If both of the If-None-Match and If-Modified-Since
- // headers are present in the request as follows: If-None-Match condition
- // evaluates to false, and; If-Modified-Since condition evaluates to true;
- // Then Amazon S3 returns the 304 Not Modified response code.
- //
- // For more information about conditional requests, see RFC 7232 (https://tools.ietf.org/html/rfc7232).
- //
- // # Permissions
- //
- // You need the relevant read object (or version) permission for this operation.
- // For more information, see Specifying Permissions in a Policy (https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html).
- // If the object you request does not exist, the error Amazon S3 returns depends
- // on whether you also have the s3:ListBucket permission.
- //
- // - If you have the s3:ListBucket permission on the bucket, Amazon S3 returns
- // an HTTP status code 404 ("no such key") error.
- //
- // - If you don’t have the s3:ListBucket permission, Amazon S3 returns
- // an HTTP status code 403 ("access denied") error.
- //
- // The following actions are related to HeadObject:
- //
- // - GetObject (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html)
- //
- // - GetObjectAttributes (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAttributes.html)
- //
- // See http://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#RESTErrorResponses
- // for more information on returned errors.
- //
- // 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 Amazon Simple Storage Service's
- // API operation HeadObject for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/HeadObject
- func (c *S3) HeadObject(input *HeadObjectInput) (*HeadObjectOutput, error) {
- req, out := c.HeadObjectRequest(input)
- return out, req.Send()
- }
- // HeadObjectWithContext is the same as HeadObject with the addition of
- // the ability to pass a context and additional request options.
- //
- // See HeadObject 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 *S3) HeadObjectWithContext(ctx aws.Context, input *HeadObjectInput, opts ...request.Option) (*HeadObjectOutput, error) {
- req, out := c.HeadObjectRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opListBucketAnalyticsConfigurations = "ListBucketAnalyticsConfigurations"
- // ListBucketAnalyticsConfigurationsRequest generates a "aws/request.Request" representing the
- // client's request for the ListBucketAnalyticsConfigurations 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 ListBucketAnalyticsConfigurations for more information on using the ListBucketAnalyticsConfigurations
- // 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 ListBucketAnalyticsConfigurationsRequest method.
- // req, resp := client.ListBucketAnalyticsConfigurationsRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListBucketAnalyticsConfigurations
- func (c *S3) ListBucketAnalyticsConfigurationsRequest(input *ListBucketAnalyticsConfigurationsInput) (req *request.Request, output *ListBucketAnalyticsConfigurationsOutput) {
- op := &request.Operation{
- Name: opListBucketAnalyticsConfigurations,
- HTTPMethod: "GET",
- HTTPPath: "/{Bucket}?analytics",
- }
- if input == nil {
- input = &ListBucketAnalyticsConfigurationsInput{}
- }
- output = &ListBucketAnalyticsConfigurationsOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // ListBucketAnalyticsConfigurations API operation for Amazon Simple Storage Service.
- //
- // Lists the analytics configurations for the bucket. You can have up to 1,000
- // analytics configurations per bucket.
- //
- // This action supports list pagination and does not return more than 100 configurations
- // at a time. You should always check the IsTruncated element in the response.
- // If there are no more configurations to list, IsTruncated is set to false.
- // If there are more configurations to list, IsTruncated is set to true, and
- // there will be a value in NextContinuationToken. You use the NextContinuationToken
- // value to continue the pagination of the list by passing the value in continuation-token
- // in the request to GET the next page.
- //
- // To use this operation, you must have permissions to perform the s3:GetAnalyticsConfiguration
- // action. The bucket owner has this permission by default. The bucket owner
- // can grant this permission to others. For more information about permissions,
- // see Permissions Related to Bucket Subresource Operations (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources)
- // and Managing Access Permissions to Your Amazon S3 Resources (https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html).
- //
- // For information about Amazon S3 analytics feature, see Amazon S3 Analytics
- // – Storage Class Analysis (https://docs.aws.amazon.com/AmazonS3/latest/dev/analytics-storage-class.html).
- //
- // The following operations are related to ListBucketAnalyticsConfigurations:
- //
- // - GetBucketAnalyticsConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketAnalyticsConfiguration.html)
- //
- // - DeleteBucketAnalyticsConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketAnalyticsConfiguration.html)
- //
- // - PutBucketAnalyticsConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketAnalyticsConfiguration.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation ListBucketAnalyticsConfigurations for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListBucketAnalyticsConfigurations
- func (c *S3) ListBucketAnalyticsConfigurations(input *ListBucketAnalyticsConfigurationsInput) (*ListBucketAnalyticsConfigurationsOutput, error) {
- req, out := c.ListBucketAnalyticsConfigurationsRequest(input)
- return out, req.Send()
- }
- // ListBucketAnalyticsConfigurationsWithContext is the same as ListBucketAnalyticsConfigurations with the addition of
- // the ability to pass a context and additional request options.
- //
- // See ListBucketAnalyticsConfigurations 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 *S3) ListBucketAnalyticsConfigurationsWithContext(ctx aws.Context, input *ListBucketAnalyticsConfigurationsInput, opts ...request.Option) (*ListBucketAnalyticsConfigurationsOutput, error) {
- req, out := c.ListBucketAnalyticsConfigurationsRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opListBucketIntelligentTieringConfigurations = "ListBucketIntelligentTieringConfigurations"
- // ListBucketIntelligentTieringConfigurationsRequest generates a "aws/request.Request" representing the
- // client's request for the ListBucketIntelligentTieringConfigurations 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 ListBucketIntelligentTieringConfigurations for more information on using the ListBucketIntelligentTieringConfigurations
- // 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 ListBucketIntelligentTieringConfigurationsRequest method.
- // req, resp := client.ListBucketIntelligentTieringConfigurationsRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListBucketIntelligentTieringConfigurations
- func (c *S3) ListBucketIntelligentTieringConfigurationsRequest(input *ListBucketIntelligentTieringConfigurationsInput) (req *request.Request, output *ListBucketIntelligentTieringConfigurationsOutput) {
- op := &request.Operation{
- Name: opListBucketIntelligentTieringConfigurations,
- HTTPMethod: "GET",
- HTTPPath: "/{Bucket}?intelligent-tiering",
- }
- if input == nil {
- input = &ListBucketIntelligentTieringConfigurationsInput{}
- }
- output = &ListBucketIntelligentTieringConfigurationsOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // ListBucketIntelligentTieringConfigurations API operation for Amazon Simple Storage Service.
- //
- // Lists the S3 Intelligent-Tiering configuration from the specified bucket.
- //
- // The S3 Intelligent-Tiering storage class is designed to optimize storage
- // costs by automatically moving data to the most cost-effective storage access
- // tier, without performance impact or operational overhead. S3 Intelligent-Tiering
- // delivers automatic cost savings in three low latency and high throughput
- // access tiers. To get the lowest storage cost on data that can be accessed
- // in minutes to hours, you can choose to activate additional archiving capabilities.
- //
- // The S3 Intelligent-Tiering storage class is the ideal storage class for data
- // with unknown, changing, or unpredictable access patterns, independent of
- // object size or retention period. If the size of an object is less than 128
- // KB, it is not monitored and not eligible for auto-tiering. Smaller objects
- // can be stored, but they are always charged at the Frequent Access tier rates
- // in the S3 Intelligent-Tiering storage class.
- //
- // For more information, see Storage class for automatically optimizing frequently
- // and infrequently accessed objects (https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html#sc-dynamic-data-access).
- //
- // Operations related to ListBucketIntelligentTieringConfigurations include:
- //
- // - DeleteBucketIntelligentTieringConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketIntelligentTieringConfiguration.html)
- //
- // - PutBucketIntelligentTieringConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketIntelligentTieringConfiguration.html)
- //
- // - GetBucketIntelligentTieringConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketIntelligentTieringConfiguration.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation ListBucketIntelligentTieringConfigurations for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListBucketIntelligentTieringConfigurations
- func (c *S3) ListBucketIntelligentTieringConfigurations(input *ListBucketIntelligentTieringConfigurationsInput) (*ListBucketIntelligentTieringConfigurationsOutput, error) {
- req, out := c.ListBucketIntelligentTieringConfigurationsRequest(input)
- return out, req.Send()
- }
- // ListBucketIntelligentTieringConfigurationsWithContext is the same as ListBucketIntelligentTieringConfigurations with the addition of
- // the ability to pass a context and additional request options.
- //
- // See ListBucketIntelligentTieringConfigurations 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 *S3) ListBucketIntelligentTieringConfigurationsWithContext(ctx aws.Context, input *ListBucketIntelligentTieringConfigurationsInput, opts ...request.Option) (*ListBucketIntelligentTieringConfigurationsOutput, error) {
- req, out := c.ListBucketIntelligentTieringConfigurationsRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opListBucketInventoryConfigurations = "ListBucketInventoryConfigurations"
- // ListBucketInventoryConfigurationsRequest generates a "aws/request.Request" representing the
- // client's request for the ListBucketInventoryConfigurations 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 ListBucketInventoryConfigurations for more information on using the ListBucketInventoryConfigurations
- // 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 ListBucketInventoryConfigurationsRequest method.
- // req, resp := client.ListBucketInventoryConfigurationsRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListBucketInventoryConfigurations
- func (c *S3) ListBucketInventoryConfigurationsRequest(input *ListBucketInventoryConfigurationsInput) (req *request.Request, output *ListBucketInventoryConfigurationsOutput) {
- op := &request.Operation{
- Name: opListBucketInventoryConfigurations,
- HTTPMethod: "GET",
- HTTPPath: "/{Bucket}?inventory",
- }
- if input == nil {
- input = &ListBucketInventoryConfigurationsInput{}
- }
- output = &ListBucketInventoryConfigurationsOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // ListBucketInventoryConfigurations API operation for Amazon Simple Storage Service.
- //
- // Returns a list of inventory configurations for the bucket. You can have up
- // to 1,000 analytics configurations per bucket.
- //
- // This action supports list pagination and does not return more than 100 configurations
- // at a time. Always check the IsTruncated element in the response. If there
- // are no more configurations to list, IsTruncated is set to false. If there
- // are more configurations to list, IsTruncated is set to true, and there is
- // a value in NextContinuationToken. You use the NextContinuationToken value
- // to continue the pagination of the list by passing the value in continuation-token
- // in the request to GET the next page.
- //
- // To use this operation, you must have permissions to perform the s3:GetInventoryConfiguration
- // action. The bucket owner has this permission by default. The bucket owner
- // can grant this permission to others. For more information about permissions,
- // see Permissions Related to Bucket Subresource Operations (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources)
- // and Managing Access Permissions to Your Amazon S3 Resources (https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html).
- //
- // For information about the Amazon S3 inventory feature, see Amazon S3 Inventory
- // (https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-inventory.html)
- //
- // The following operations are related to ListBucketInventoryConfigurations:
- //
- // - GetBucketInventoryConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketInventoryConfiguration.html)
- //
- // - DeleteBucketInventoryConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketInventoryConfiguration.html)
- //
- // - PutBucketInventoryConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketInventoryConfiguration.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation ListBucketInventoryConfigurations for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListBucketInventoryConfigurations
- func (c *S3) ListBucketInventoryConfigurations(input *ListBucketInventoryConfigurationsInput) (*ListBucketInventoryConfigurationsOutput, error) {
- req, out := c.ListBucketInventoryConfigurationsRequest(input)
- return out, req.Send()
- }
- // ListBucketInventoryConfigurationsWithContext is the same as ListBucketInventoryConfigurations with the addition of
- // the ability to pass a context and additional request options.
- //
- // See ListBucketInventoryConfigurations 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 *S3) ListBucketInventoryConfigurationsWithContext(ctx aws.Context, input *ListBucketInventoryConfigurationsInput, opts ...request.Option) (*ListBucketInventoryConfigurationsOutput, error) {
- req, out := c.ListBucketInventoryConfigurationsRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opListBucketMetricsConfigurations = "ListBucketMetricsConfigurations"
- // ListBucketMetricsConfigurationsRequest generates a "aws/request.Request" representing the
- // client's request for the ListBucketMetricsConfigurations 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 ListBucketMetricsConfigurations for more information on using the ListBucketMetricsConfigurations
- // 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 ListBucketMetricsConfigurationsRequest method.
- // req, resp := client.ListBucketMetricsConfigurationsRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListBucketMetricsConfigurations
- func (c *S3) ListBucketMetricsConfigurationsRequest(input *ListBucketMetricsConfigurationsInput) (req *request.Request, output *ListBucketMetricsConfigurationsOutput) {
- op := &request.Operation{
- Name: opListBucketMetricsConfigurations,
- HTTPMethod: "GET",
- HTTPPath: "/{Bucket}?metrics",
- }
- if input == nil {
- input = &ListBucketMetricsConfigurationsInput{}
- }
- output = &ListBucketMetricsConfigurationsOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // ListBucketMetricsConfigurations API operation for Amazon Simple Storage Service.
- //
- // Lists the metrics configurations for the bucket. The metrics configurations
- // are only for the request metrics of the bucket and do not provide information
- // on daily storage metrics. You can have up to 1,000 configurations per bucket.
- //
- // This action supports list pagination and does not return more than 100 configurations
- // at a time. Always check the IsTruncated element in the response. If there
- // are no more configurations to list, IsTruncated is set to false. If there
- // are more configurations to list, IsTruncated is set to true, and there is
- // a value in NextContinuationToken. You use the NextContinuationToken value
- // to continue the pagination of the list by passing the value in continuation-token
- // in the request to GET the next page.
- //
- // To use this operation, you must have permissions to perform the s3:GetMetricsConfiguration
- // action. The bucket owner has this permission by default. The bucket owner
- // can grant this permission to others. For more information about permissions,
- // see Permissions Related to Bucket Subresource Operations (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources)
- // and Managing Access Permissions to Your Amazon S3 Resources (https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html).
- //
- // For more information about metrics configurations and CloudWatch request
- // metrics, see Monitoring Metrics with Amazon CloudWatch (https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html).
- //
- // The following operations are related to ListBucketMetricsConfigurations:
- //
- // - PutBucketMetricsConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketMetricsConfiguration.html)
- //
- // - GetBucketMetricsConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketMetricsConfiguration.html)
- //
- // - DeleteBucketMetricsConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketMetricsConfiguration.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation ListBucketMetricsConfigurations for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListBucketMetricsConfigurations
- func (c *S3) ListBucketMetricsConfigurations(input *ListBucketMetricsConfigurationsInput) (*ListBucketMetricsConfigurationsOutput, error) {
- req, out := c.ListBucketMetricsConfigurationsRequest(input)
- return out, req.Send()
- }
- // ListBucketMetricsConfigurationsWithContext is the same as ListBucketMetricsConfigurations with the addition of
- // the ability to pass a context and additional request options.
- //
- // See ListBucketMetricsConfigurations 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 *S3) ListBucketMetricsConfigurationsWithContext(ctx aws.Context, input *ListBucketMetricsConfigurationsInput, opts ...request.Option) (*ListBucketMetricsConfigurationsOutput, error) {
- req, out := c.ListBucketMetricsConfigurationsRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opListBuckets = "ListBuckets"
- // ListBucketsRequest generates a "aws/request.Request" representing the
- // client's request for the ListBuckets 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 ListBuckets for more information on using the ListBuckets
- // 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 ListBucketsRequest method.
- // req, resp := client.ListBucketsRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListBuckets
- func (c *S3) ListBucketsRequest(input *ListBucketsInput) (req *request.Request, output *ListBucketsOutput) {
- op := &request.Operation{
- Name: opListBuckets,
- HTTPMethod: "GET",
- HTTPPath: "/",
- }
- if input == nil {
- input = &ListBucketsInput{}
- }
- output = &ListBucketsOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // ListBuckets API operation for Amazon Simple Storage Service.
- //
- // Returns a list of all buckets owned by the authenticated sender of the request.
- // To use this operation, you must have the s3:ListAllMyBuckets permission.
- //
- // 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 Amazon Simple Storage Service's
- // API operation ListBuckets for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListBuckets
- func (c *S3) ListBuckets(input *ListBucketsInput) (*ListBucketsOutput, error) {
- req, out := c.ListBucketsRequest(input)
- return out, req.Send()
- }
- // ListBucketsWithContext is the same as ListBuckets with the addition of
- // the ability to pass a context and additional request options.
- //
- // See ListBuckets 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 *S3) ListBucketsWithContext(ctx aws.Context, input *ListBucketsInput, opts ...request.Option) (*ListBucketsOutput, error) {
- req, out := c.ListBucketsRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opListMultipartUploads = "ListMultipartUploads"
- // ListMultipartUploadsRequest generates a "aws/request.Request" representing the
- // client's request for the ListMultipartUploads 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 ListMultipartUploads for more information on using the ListMultipartUploads
- // 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 ListMultipartUploadsRequest method.
- // req, resp := client.ListMultipartUploadsRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListMultipartUploads
- func (c *S3) ListMultipartUploadsRequest(input *ListMultipartUploadsInput) (req *request.Request, output *ListMultipartUploadsOutput) {
- op := &request.Operation{
- Name: opListMultipartUploads,
- HTTPMethod: "GET",
- HTTPPath: "/{Bucket}?uploads",
- Paginator: &request.Paginator{
- InputTokens: []string{"KeyMarker", "UploadIdMarker"},
- OutputTokens: []string{"NextKeyMarker", "NextUploadIdMarker"},
- LimitToken: "MaxUploads",
- TruncationToken: "IsTruncated",
- },
- }
- if input == nil {
- input = &ListMultipartUploadsInput{}
- }
- output = &ListMultipartUploadsOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // ListMultipartUploads API operation for Amazon Simple Storage Service.
- //
- // This action lists in-progress multipart uploads. An in-progress multipart
- // upload is a multipart upload that has been initiated using the Initiate Multipart
- // Upload request, but has not yet been completed or aborted.
- //
- // This action returns at most 1,000 multipart uploads in the response. 1,000
- // multipart uploads is the maximum number of uploads a response can include,
- // which is also the default value. You can further limit the number of uploads
- // in a response by specifying the max-uploads parameter in the response. If
- // additional multipart uploads satisfy the list criteria, the response will
- // contain an IsTruncated element with the value true. To list the additional
- // multipart uploads, use the key-marker and upload-id-marker request parameters.
- //
- // In the response, the uploads are sorted by key. If your application has initiated
- // more than one multipart upload using the same object key, then uploads in
- // the response are first sorted by key. Additionally, uploads are sorted in
- // ascending order within each key by the upload initiation time.
- //
- // For more information on multipart uploads, see Uploading Objects Using Multipart
- // Upload (https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html).
- //
- // For information on permissions required to use the multipart upload API,
- // see Multipart Upload and Permissions (https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html).
- //
- // The following operations are related to ListMultipartUploads:
- //
- // - CreateMultipartUpload (https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html)
- //
- // - UploadPart (https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html)
- //
- // - CompleteMultipartUpload (https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html)
- //
- // - ListParts (https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html)
- //
- // - AbortMultipartUpload (https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation ListMultipartUploads for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListMultipartUploads
- func (c *S3) ListMultipartUploads(input *ListMultipartUploadsInput) (*ListMultipartUploadsOutput, error) {
- req, out := c.ListMultipartUploadsRequest(input)
- return out, req.Send()
- }
- // ListMultipartUploadsWithContext is the same as ListMultipartUploads with the addition of
- // the ability to pass a context and additional request options.
- //
- // See ListMultipartUploads 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 *S3) ListMultipartUploadsWithContext(ctx aws.Context, input *ListMultipartUploadsInput, opts ...request.Option) (*ListMultipartUploadsOutput, error) {
- req, out := c.ListMultipartUploadsRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- // ListMultipartUploadsPages iterates over the pages of a ListMultipartUploads operation,
- // calling the "fn" function with the response data for each page. To stop
- // iterating, return false from the fn function.
- //
- // See ListMultipartUploads 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 ListMultipartUploads operation.
- // pageNum := 0
- // err := client.ListMultipartUploadsPages(params,
- // func(page *s3.ListMultipartUploadsOutput, lastPage bool) bool {
- // pageNum++
- // fmt.Println(page)
- // return pageNum <= 3
- // })
- func (c *S3) ListMultipartUploadsPages(input *ListMultipartUploadsInput, fn func(*ListMultipartUploadsOutput, bool) bool) error {
- return c.ListMultipartUploadsPagesWithContext(aws.BackgroundContext(), input, fn)
- }
- // ListMultipartUploadsPagesWithContext same as ListMultipartUploadsPages 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 *S3) ListMultipartUploadsPagesWithContext(ctx aws.Context, input *ListMultipartUploadsInput, fn func(*ListMultipartUploadsOutput, bool) bool, opts ...request.Option) error {
- p := request.Pagination{
- NewRequest: func() (*request.Request, error) {
- var inCpy *ListMultipartUploadsInput
- if input != nil {
- tmp := *input
- inCpy = &tmp
- }
- req, _ := c.ListMultipartUploadsRequest(inCpy)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return req, nil
- },
- }
- for p.Next() {
- if !fn(p.Page().(*ListMultipartUploadsOutput), !p.HasNextPage()) {
- break
- }
- }
- return p.Err()
- }
- const opListObjectVersions = "ListObjectVersions"
- // ListObjectVersionsRequest generates a "aws/request.Request" representing the
- // client's request for the ListObjectVersions 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 ListObjectVersions for more information on using the ListObjectVersions
- // 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 ListObjectVersionsRequest method.
- // req, resp := client.ListObjectVersionsRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListObjectVersions
- func (c *S3) ListObjectVersionsRequest(input *ListObjectVersionsInput) (req *request.Request, output *ListObjectVersionsOutput) {
- op := &request.Operation{
- Name: opListObjectVersions,
- HTTPMethod: "GET",
- HTTPPath: "/{Bucket}?versions",
- Paginator: &request.Paginator{
- InputTokens: []string{"KeyMarker", "VersionIdMarker"},
- OutputTokens: []string{"NextKeyMarker", "NextVersionIdMarker"},
- LimitToken: "MaxKeys",
- TruncationToken: "IsTruncated",
- },
- }
- if input == nil {
- input = &ListObjectVersionsInput{}
- }
- output = &ListObjectVersionsOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // ListObjectVersions API operation for Amazon Simple Storage Service.
- //
- // Returns metadata about all versions of the objects in a bucket. You can also
- // use request parameters as selection criteria to return metadata about a subset
- // of all the object versions.
- //
- // To use this operation, you must have permissions to perform the s3:ListBucketVersions
- // action. Be aware of the name difference.
- //
- // A 200 OK response can contain valid or invalid XML. Make sure to design your
- // application to parse the contents of the response and handle it appropriately.
- //
- // To use this operation, you must have READ access to the bucket.
- //
- // This action is not supported by Amazon S3 on Outposts.
- //
- // The following operations are related to ListObjectVersions:
- //
- // - ListObjectsV2 (https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjectsV2.html)
- //
- // - GetObject (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html)
- //
- // - PutObject (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html)
- //
- // - DeleteObject (https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation ListObjectVersions for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListObjectVersions
- func (c *S3) ListObjectVersions(input *ListObjectVersionsInput) (*ListObjectVersionsOutput, error) {
- req, out := c.ListObjectVersionsRequest(input)
- return out, req.Send()
- }
- // ListObjectVersionsWithContext is the same as ListObjectVersions with the addition of
- // the ability to pass a context and additional request options.
- //
- // See ListObjectVersions 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 *S3) ListObjectVersionsWithContext(ctx aws.Context, input *ListObjectVersionsInput, opts ...request.Option) (*ListObjectVersionsOutput, error) {
- req, out := c.ListObjectVersionsRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- // ListObjectVersionsPages iterates over the pages of a ListObjectVersions operation,
- // calling the "fn" function with the response data for each page. To stop
- // iterating, return false from the fn function.
- //
- // See ListObjectVersions 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 ListObjectVersions operation.
- // pageNum := 0
- // err := client.ListObjectVersionsPages(params,
- // func(page *s3.ListObjectVersionsOutput, lastPage bool) bool {
- // pageNum++
- // fmt.Println(page)
- // return pageNum <= 3
- // })
- func (c *S3) ListObjectVersionsPages(input *ListObjectVersionsInput, fn func(*ListObjectVersionsOutput, bool) bool) error {
- return c.ListObjectVersionsPagesWithContext(aws.BackgroundContext(), input, fn)
- }
- // ListObjectVersionsPagesWithContext same as ListObjectVersionsPages 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 *S3) ListObjectVersionsPagesWithContext(ctx aws.Context, input *ListObjectVersionsInput, fn func(*ListObjectVersionsOutput, bool) bool, opts ...request.Option) error {
- p := request.Pagination{
- NewRequest: func() (*request.Request, error) {
- var inCpy *ListObjectVersionsInput
- if input != nil {
- tmp := *input
- inCpy = &tmp
- }
- req, _ := c.ListObjectVersionsRequest(inCpy)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return req, nil
- },
- }
- for p.Next() {
- if !fn(p.Page().(*ListObjectVersionsOutput), !p.HasNextPage()) {
- break
- }
- }
- return p.Err()
- }
- const opListObjects = "ListObjects"
- // ListObjectsRequest generates a "aws/request.Request" representing the
- // client's request for the ListObjects 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 ListObjects for more information on using the ListObjects
- // 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 ListObjectsRequest method.
- // req, resp := client.ListObjectsRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListObjects
- func (c *S3) ListObjectsRequest(input *ListObjectsInput) (req *request.Request, output *ListObjectsOutput) {
- op := &request.Operation{
- Name: opListObjects,
- HTTPMethod: "GET",
- HTTPPath: "/{Bucket}",
- Paginator: &request.Paginator{
- InputTokens: []string{"Marker"},
- OutputTokens: []string{"NextMarker || Contents[-1].Key"},
- LimitToken: "MaxKeys",
- TruncationToken: "IsTruncated",
- },
- }
- if input == nil {
- input = &ListObjectsInput{}
- }
- output = &ListObjectsOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // ListObjects API operation for Amazon Simple Storage Service.
- //
- // Returns some or all (up to 1,000) of the objects in a bucket. You can use
- // the request parameters as selection criteria to return a subset of the objects
- // in a bucket. A 200 OK response can contain valid or invalid XML. Be sure
- // to design your application to parse the contents of the response and handle
- // it appropriately.
- //
- // This action has been revised. We recommend that you use the newer version,
- // ListObjectsV2 (https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjectsV2.html),
- // when developing applications. For backward compatibility, Amazon S3 continues
- // to support ListObjects.
- //
- // The following operations are related to ListObjects:
- //
- // - ListObjectsV2 (https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjectsV2.html)
- //
- // - GetObject (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html)
- //
- // - PutObject (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html)
- //
- // - CreateBucket (https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html)
- //
- // - ListBuckets (https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation ListObjects for usage and error information.
- //
- // Returned Error Codes:
- // - ErrCodeNoSuchBucket "NoSuchBucket"
- // The specified bucket does not exist.
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListObjects
- func (c *S3) ListObjects(input *ListObjectsInput) (*ListObjectsOutput, error) {
- req, out := c.ListObjectsRequest(input)
- return out, req.Send()
- }
- // ListObjectsWithContext is the same as ListObjects with the addition of
- // the ability to pass a context and additional request options.
- //
- // See ListObjects 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 *S3) ListObjectsWithContext(ctx aws.Context, input *ListObjectsInput, opts ...request.Option) (*ListObjectsOutput, error) {
- req, out := c.ListObjectsRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- // ListObjectsPages iterates over the pages of a ListObjects operation,
- // calling the "fn" function with the response data for each page. To stop
- // iterating, return false from the fn function.
- //
- // See ListObjects 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 ListObjects operation.
- // pageNum := 0
- // err := client.ListObjectsPages(params,
- // func(page *s3.ListObjectsOutput, lastPage bool) bool {
- // pageNum++
- // fmt.Println(page)
- // return pageNum <= 3
- // })
- func (c *S3) ListObjectsPages(input *ListObjectsInput, fn func(*ListObjectsOutput, bool) bool) error {
- return c.ListObjectsPagesWithContext(aws.BackgroundContext(), input, fn)
- }
- // ListObjectsPagesWithContext same as ListObjectsPages 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 *S3) ListObjectsPagesWithContext(ctx aws.Context, input *ListObjectsInput, fn func(*ListObjectsOutput, bool) bool, opts ...request.Option) error {
- p := request.Pagination{
- NewRequest: func() (*request.Request, error) {
- var inCpy *ListObjectsInput
- if input != nil {
- tmp := *input
- inCpy = &tmp
- }
- req, _ := c.ListObjectsRequest(inCpy)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return req, nil
- },
- }
- for p.Next() {
- if !fn(p.Page().(*ListObjectsOutput), !p.HasNextPage()) {
- break
- }
- }
- return p.Err()
- }
- const opListObjectsV2 = "ListObjectsV2"
- // ListObjectsV2Request generates a "aws/request.Request" representing the
- // client's request for the ListObjectsV2 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 ListObjectsV2 for more information on using the ListObjectsV2
- // 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 ListObjectsV2Request method.
- // req, resp := client.ListObjectsV2Request(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListObjectsV2
- func (c *S3) ListObjectsV2Request(input *ListObjectsV2Input) (req *request.Request, output *ListObjectsV2Output) {
- op := &request.Operation{
- Name: opListObjectsV2,
- HTTPMethod: "GET",
- HTTPPath: "/{Bucket}?list-type=2",
- Paginator: &request.Paginator{
- InputTokens: []string{"ContinuationToken"},
- OutputTokens: []string{"NextContinuationToken"},
- LimitToken: "MaxKeys",
- TruncationToken: "",
- },
- }
- if input == nil {
- input = &ListObjectsV2Input{}
- }
- output = &ListObjectsV2Output{}
- req = c.newRequest(op, input, output)
- return
- }
- // ListObjectsV2 API operation for Amazon Simple Storage Service.
- //
- // Returns some or all (up to 1,000) of the objects in a bucket with each request.
- // You can use the request parameters as selection criteria to return a subset
- // of the objects in a bucket. A 200 OK response can contain valid or invalid
- // XML. Make sure to design your application to parse the contents of the response
- // and handle it appropriately. Objects are returned sorted in an ascending
- // order of the respective key names in the list. For more information about
- // listing objects, see Listing object keys programmatically (https://docs.aws.amazon.com/AmazonS3/latest/userguide/ListingKeysUsingAPIs.html)
- //
- // To use this operation, you must have READ access to the bucket.
- //
- // To use this action in an Identity and Access Management (IAM) policy, you
- // must have permissions to perform the s3:ListBucket action. The bucket owner
- // has this permission by default and can grant this permission to others. For
- // more information about permissions, see Permissions Related to Bucket Subresource
- // Operations (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources)
- // and Managing Access Permissions to Your Amazon S3 Resources (https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html).
- //
- // This section describes the latest revision of this action. We recommend that
- // you use this revised API for application development. For backward compatibility,
- // Amazon S3 continues to support the prior version of this API, ListObjects
- // (https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjects.html).
- //
- // To get a list of your buckets, see ListBuckets (https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html).
- //
- // The following operations are related to ListObjectsV2:
- //
- // - GetObject (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html)
- //
- // - PutObject (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html)
- //
- // - CreateBucket (https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation ListObjectsV2 for usage and error information.
- //
- // Returned Error Codes:
- // - ErrCodeNoSuchBucket "NoSuchBucket"
- // The specified bucket does not exist.
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListObjectsV2
- func (c *S3) ListObjectsV2(input *ListObjectsV2Input) (*ListObjectsV2Output, error) {
- req, out := c.ListObjectsV2Request(input)
- return out, req.Send()
- }
- // ListObjectsV2WithContext is the same as ListObjectsV2 with the addition of
- // the ability to pass a context and additional request options.
- //
- // See ListObjectsV2 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 *S3) ListObjectsV2WithContext(ctx aws.Context, input *ListObjectsV2Input, opts ...request.Option) (*ListObjectsV2Output, error) {
- req, out := c.ListObjectsV2Request(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- // ListObjectsV2Pages iterates over the pages of a ListObjectsV2 operation,
- // calling the "fn" function with the response data for each page. To stop
- // iterating, return false from the fn function.
- //
- // See ListObjectsV2 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 ListObjectsV2 operation.
- // pageNum := 0
- // err := client.ListObjectsV2Pages(params,
- // func(page *s3.ListObjectsV2Output, lastPage bool) bool {
- // pageNum++
- // fmt.Println(page)
- // return pageNum <= 3
- // })
- func (c *S3) ListObjectsV2Pages(input *ListObjectsV2Input, fn func(*ListObjectsV2Output, bool) bool) error {
- return c.ListObjectsV2PagesWithContext(aws.BackgroundContext(), input, fn)
- }
- // ListObjectsV2PagesWithContext same as ListObjectsV2Pages 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 *S3) ListObjectsV2PagesWithContext(ctx aws.Context, input *ListObjectsV2Input, fn func(*ListObjectsV2Output, bool) bool, opts ...request.Option) error {
- p := request.Pagination{
- NewRequest: func() (*request.Request, error) {
- var inCpy *ListObjectsV2Input
- if input != nil {
- tmp := *input
- inCpy = &tmp
- }
- req, _ := c.ListObjectsV2Request(inCpy)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return req, nil
- },
- }
- for p.Next() {
- if !fn(p.Page().(*ListObjectsV2Output), !p.HasNextPage()) {
- break
- }
- }
- return p.Err()
- }
- const opListParts = "ListParts"
- // ListPartsRequest generates a "aws/request.Request" representing the
- // client's request for the ListParts 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 ListParts for more information on using the ListParts
- // 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 ListPartsRequest method.
- // req, resp := client.ListPartsRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListParts
- func (c *S3) ListPartsRequest(input *ListPartsInput) (req *request.Request, output *ListPartsOutput) {
- op := &request.Operation{
- Name: opListParts,
- HTTPMethod: "GET",
- HTTPPath: "/{Bucket}/{Key+}",
- Paginator: &request.Paginator{
- InputTokens: []string{"PartNumberMarker"},
- OutputTokens: []string{"NextPartNumberMarker"},
- LimitToken: "MaxParts",
- TruncationToken: "IsTruncated",
- },
- }
- if input == nil {
- input = &ListPartsInput{}
- }
- output = &ListPartsOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // ListParts API operation for Amazon Simple Storage Service.
- //
- // Lists the parts that have been uploaded for a specific multipart upload.
- // This operation must include the upload ID, which you obtain by sending the
- // initiate multipart upload request (see CreateMultipartUpload (https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html)).
- // This request returns a maximum of 1,000 uploaded parts. The default number
- // of parts returned is 1,000 parts. You can restrict the number of parts returned
- // by specifying the max-parts request parameter. If your multipart upload consists
- // of more than 1,000 parts, the response returns an IsTruncated field with
- // the value of true, and a NextPartNumberMarker element. In subsequent ListParts
- // requests you can include the part-number-marker query string parameter and
- // set its value to the NextPartNumberMarker field value from the previous response.
- //
- // If the upload was created using a checksum algorithm, you will need to have
- // permission to the kms:Decrypt action for the request to succeed.
- //
- // For more information on multipart uploads, see Uploading Objects Using Multipart
- // Upload (https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html).
- //
- // For information on permissions required to use the multipart upload API,
- // see Multipart Upload and Permissions (https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html).
- //
- // The following operations are related to ListParts:
- //
- // - CreateMultipartUpload (https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html)
- //
- // - UploadPart (https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html)
- //
- // - CompleteMultipartUpload (https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html)
- //
- // - AbortMultipartUpload (https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html)
- //
- // - GetObjectAttributes (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAttributes.html)
- //
- // - ListMultipartUploads (https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation ListParts for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListParts
- func (c *S3) ListParts(input *ListPartsInput) (*ListPartsOutput, error) {
- req, out := c.ListPartsRequest(input)
- return out, req.Send()
- }
- // ListPartsWithContext is the same as ListParts with the addition of
- // the ability to pass a context and additional request options.
- //
- // See ListParts 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 *S3) ListPartsWithContext(ctx aws.Context, input *ListPartsInput, opts ...request.Option) (*ListPartsOutput, error) {
- req, out := c.ListPartsRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- // ListPartsPages iterates over the pages of a ListParts operation,
- // calling the "fn" function with the response data for each page. To stop
- // iterating, return false from the fn function.
- //
- // See ListParts 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 ListParts operation.
- // pageNum := 0
- // err := client.ListPartsPages(params,
- // func(page *s3.ListPartsOutput, lastPage bool) bool {
- // pageNum++
- // fmt.Println(page)
- // return pageNum <= 3
- // })
- func (c *S3) ListPartsPages(input *ListPartsInput, fn func(*ListPartsOutput, bool) bool) error {
- return c.ListPartsPagesWithContext(aws.BackgroundContext(), input, fn)
- }
- // ListPartsPagesWithContext same as ListPartsPages 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 *S3) ListPartsPagesWithContext(ctx aws.Context, input *ListPartsInput, fn func(*ListPartsOutput, bool) bool, opts ...request.Option) error {
- p := request.Pagination{
- NewRequest: func() (*request.Request, error) {
- var inCpy *ListPartsInput
- if input != nil {
- tmp := *input
- inCpy = &tmp
- }
- req, _ := c.ListPartsRequest(inCpy)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return req, nil
- },
- }
- for p.Next() {
- if !fn(p.Page().(*ListPartsOutput), !p.HasNextPage()) {
- break
- }
- }
- return p.Err()
- }
- const opPutBucketAccelerateConfiguration = "PutBucketAccelerateConfiguration"
- // PutBucketAccelerateConfigurationRequest generates a "aws/request.Request" representing the
- // client's request for the PutBucketAccelerateConfiguration 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 PutBucketAccelerateConfiguration for more information on using the PutBucketAccelerateConfiguration
- // 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 PutBucketAccelerateConfigurationRequest method.
- // req, resp := client.PutBucketAccelerateConfigurationRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketAccelerateConfiguration
- func (c *S3) PutBucketAccelerateConfigurationRequest(input *PutBucketAccelerateConfigurationInput) (req *request.Request, output *PutBucketAccelerateConfigurationOutput) {
- op := &request.Operation{
- Name: opPutBucketAccelerateConfiguration,
- HTTPMethod: "PUT",
- HTTPPath: "/{Bucket}?accelerate",
- }
- if input == nil {
- input = &PutBucketAccelerateConfigurationInput{}
- }
- output = &PutBucketAccelerateConfigurationOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Swap(restxml.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler)
- return
- }
- // PutBucketAccelerateConfiguration API operation for Amazon Simple Storage Service.
- //
- // Sets the accelerate configuration of an existing bucket. Amazon S3 Transfer
- // Acceleration is a bucket-level feature that enables you to perform faster
- // data transfers to Amazon S3.
- //
- // To use this operation, you must have permission to perform the s3:PutAccelerateConfiguration
- // action. The bucket owner has this permission by default. The bucket owner
- // can grant this permission to others. For more information about permissions,
- // see Permissions Related to Bucket Subresource Operations (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources)
- // and Managing Access Permissions to Your Amazon S3 Resources (https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html).
- //
- // The Transfer Acceleration state of a bucket can be set to one of the following
- // two values:
- //
- // - Enabled – Enables accelerated data transfers to the bucket.
- //
- // - Suspended – Disables accelerated data transfers to the bucket.
- //
- // The GetBucketAccelerateConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketAccelerateConfiguration.html)
- // action returns the transfer acceleration state of a bucket.
- //
- // After setting the Transfer Acceleration state of a bucket to Enabled, it
- // might take up to thirty minutes before the data transfer rates to the bucket
- // increase.
- //
- // The name of the bucket used for Transfer Acceleration must be DNS-compliant
- // and must not contain periods (".").
- //
- // For more information about transfer acceleration, see Transfer Acceleration
- // (https://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration.html).
- //
- // The following operations are related to PutBucketAccelerateConfiguration:
- //
- // - GetBucketAccelerateConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketAccelerateConfiguration.html)
- //
- // - CreateBucket (https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation PutBucketAccelerateConfiguration for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketAccelerateConfiguration
- func (c *S3) PutBucketAccelerateConfiguration(input *PutBucketAccelerateConfigurationInput) (*PutBucketAccelerateConfigurationOutput, error) {
- req, out := c.PutBucketAccelerateConfigurationRequest(input)
- return out, req.Send()
- }
- // PutBucketAccelerateConfigurationWithContext is the same as PutBucketAccelerateConfiguration with the addition of
- // the ability to pass a context and additional request options.
- //
- // See PutBucketAccelerateConfiguration 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 *S3) PutBucketAccelerateConfigurationWithContext(ctx aws.Context, input *PutBucketAccelerateConfigurationInput, opts ...request.Option) (*PutBucketAccelerateConfigurationOutput, error) {
- req, out := c.PutBucketAccelerateConfigurationRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opPutBucketAcl = "PutBucketAcl"
- // PutBucketAclRequest generates a "aws/request.Request" representing the
- // client's request for the PutBucketAcl 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 PutBucketAcl for more information on using the PutBucketAcl
- // 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 PutBucketAclRequest method.
- // req, resp := client.PutBucketAclRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketAcl
- func (c *S3) PutBucketAclRequest(input *PutBucketAclInput) (req *request.Request, output *PutBucketAclOutput) {
- op := &request.Operation{
- Name: opPutBucketAcl,
- HTTPMethod: "PUT",
- HTTPPath: "/{Bucket}?acl",
- }
- if input == nil {
- input = &PutBucketAclInput{}
- }
- output = &PutBucketAclOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Swap(restxml.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler)
- req.Handlers.Build.PushBackNamed(request.NamedHandler{
- Name: "contentMd5Handler",
- Fn: checksum.AddBodyContentMD5Handler,
- })
- return
- }
- // PutBucketAcl API operation for Amazon Simple Storage Service.
- //
- // Sets the permissions on an existing bucket using access control lists (ACL).
- // For more information, see Using ACLs (https://docs.aws.amazon.com/AmazonS3/latest/dev/S3_ACLs_UsingACLs.html).
- // To set the ACL of a bucket, you must have WRITE_ACP permission.
- //
- // You can use one of the following two ways to set a bucket's permissions:
- //
- // - Specify the ACL in the request body
- //
- // - Specify permissions using request headers
- //
- // You cannot specify access permission using both the body and the request
- // headers.
- //
- // Depending on your application needs, you may choose to set the ACL on a bucket
- // using either the request body or the headers. For example, if you have an
- // existing application that updates a bucket ACL using the request body, then
- // you can continue to use that approach.
- //
- // If your bucket uses the bucket owner enforced setting for S3 Object Ownership,
- // ACLs are disabled and no longer affect permissions. You must use policies
- // to grant access to your bucket and the objects in it. Requests to set ACLs
- // or update ACLs fail and return the AccessControlListNotSupported error code.
- // Requests to read ACLs are still supported. For more information, see Controlling
- // object ownership (https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html)
- // in the Amazon S3 User Guide.
- //
- // # Access Permissions
- //
- // You can set access permissions using one of the following methods:
- //
- // - Specify a canned ACL with the x-amz-acl request header. Amazon S3 supports
- // a set of predefined ACLs, known as canned ACLs. Each canned ACL has a
- // predefined set of grantees and permissions. Specify the canned ACL name
- // as the value of x-amz-acl. If you use this header, you cannot use other
- // access control-specific headers in your request. For more information,
- // see Canned ACL (https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL).
- //
- // - Specify access permissions explicitly with the x-amz-grant-read, x-amz-grant-read-acp,
- // x-amz-grant-write-acp, and x-amz-grant-full-control headers. When using
- // these headers, you specify explicit access permissions and grantees (Amazon
- // Web Services accounts or Amazon S3 groups) who will receive the permission.
- // If you use these ACL-specific headers, you cannot use the x-amz-acl header
- // to set a canned ACL. These parameters map to the set of permissions that
- // Amazon S3 supports in an ACL. For more information, see Access Control
- // List (ACL) Overview (https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html).
- // You specify each grantee as a type=value pair, where the type is one of
- // the following: id – if the value specified is the canonical user ID
- // of an Amazon Web Services account uri – if you are granting permissions
- // to a predefined group emailAddress – if the value specified is the email
- // address of an Amazon Web Services account Using email addresses to specify
- // a grantee is only supported in the following Amazon Web Services Regions:
- // US East (N. Virginia) US West (N. California) US West (Oregon) Asia Pacific
- // (Singapore) Asia Pacific (Sydney) Asia Pacific (Tokyo) Europe (Ireland)
- // South America (São Paulo) For a list of all the Amazon S3 supported Regions
- // and endpoints, see Regions and Endpoints (https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region)
- // in the Amazon Web Services General Reference. For example, the following
- // x-amz-grant-write header grants create, overwrite, and delete objects
- // permission to LogDelivery group predefined by Amazon S3 and two Amazon
- // Web Services accounts identified by their email addresses. x-amz-grant-write:
- // uri="http://acs.amazonaws.com/groups/s3/LogDelivery", id="111122223333",
- // id="555566667777"
- //
- // You can use either a canned ACL or specify access permissions explicitly.
- // You cannot do both.
- //
- // # Grantee Values
- //
- // You can specify the person (grantee) to whom you're assigning access rights
- // (using request elements) in the following ways:
- //
- // - By the person's ID: <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- // xsi:type="CanonicalUser"><ID><>ID<></ID><DisplayName><>GranteesEmail<></DisplayName>
- // </Grantee> DisplayName is optional and ignored in the request
- //
- // - By URI: <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- // xsi:type="Group"><URI><>http://acs.amazonaws.com/groups/global/AuthenticatedUsers<></URI></Grantee>
- //
- // - By Email address: <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- // xsi:type="AmazonCustomerByEmail"><EmailAddress><>Grantees@email.com<></EmailAddress>lt;/Grantee>
- // The grantee is resolved to the CanonicalUser and, in a response to a GET
- // Object acl request, appears as the CanonicalUser. Using email addresses
- // to specify a grantee is only supported in the following Amazon Web Services
- // Regions: US East (N. Virginia) US West (N. California) US West (Oregon)
- // Asia Pacific (Singapore) Asia Pacific (Sydney) Asia Pacific (Tokyo) Europe
- // (Ireland) South America (São Paulo) For a list of all the Amazon S3 supported
- // Regions and endpoints, see Regions and Endpoints (https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region)
- // in the Amazon Web Services General Reference.
- //
- // Related Resources
- //
- // - CreateBucket (https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html)
- //
- // - DeleteBucket (https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucket.html)
- //
- // - GetObjectAcl (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAcl.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation PutBucketAcl for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketAcl
- func (c *S3) PutBucketAcl(input *PutBucketAclInput) (*PutBucketAclOutput, error) {
- req, out := c.PutBucketAclRequest(input)
- return out, req.Send()
- }
- // PutBucketAclWithContext is the same as PutBucketAcl with the addition of
- // the ability to pass a context and additional request options.
- //
- // See PutBucketAcl 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 *S3) PutBucketAclWithContext(ctx aws.Context, input *PutBucketAclInput, opts ...request.Option) (*PutBucketAclOutput, error) {
- req, out := c.PutBucketAclRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opPutBucketAnalyticsConfiguration = "PutBucketAnalyticsConfiguration"
- // PutBucketAnalyticsConfigurationRequest generates a "aws/request.Request" representing the
- // client's request for the PutBucketAnalyticsConfiguration 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 PutBucketAnalyticsConfiguration for more information on using the PutBucketAnalyticsConfiguration
- // 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 PutBucketAnalyticsConfigurationRequest method.
- // req, resp := client.PutBucketAnalyticsConfigurationRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketAnalyticsConfiguration
- func (c *S3) PutBucketAnalyticsConfigurationRequest(input *PutBucketAnalyticsConfigurationInput) (req *request.Request, output *PutBucketAnalyticsConfigurationOutput) {
- op := &request.Operation{
- Name: opPutBucketAnalyticsConfiguration,
- HTTPMethod: "PUT",
- HTTPPath: "/{Bucket}?analytics",
- }
- if input == nil {
- input = &PutBucketAnalyticsConfigurationInput{}
- }
- output = &PutBucketAnalyticsConfigurationOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Swap(restxml.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler)
- return
- }
- // PutBucketAnalyticsConfiguration API operation for Amazon Simple Storage Service.
- //
- // Sets an analytics configuration for the bucket (specified by the analytics
- // configuration ID). You can have up to 1,000 analytics configurations per
- // bucket.
- //
- // You can choose to have storage class analysis export analysis reports sent
- // to a comma-separated values (CSV) flat file. See the DataExport request element.
- // Reports are updated daily and are based on the object filters that you configure.
- // When selecting data export, you specify a destination bucket and an optional
- // destination prefix where the file is written. You can export the data to
- // a destination bucket in a different account. However, the destination bucket
- // must be in the same Region as the bucket that you are making the PUT analytics
- // configuration to. For more information, see Amazon S3 Analytics – Storage
- // Class Analysis (https://docs.aws.amazon.com/AmazonS3/latest/dev/analytics-storage-class.html).
- //
- // You must create a bucket policy on the destination bucket where the exported
- // file is written to grant permissions to Amazon S3 to write objects to the
- // bucket. For an example policy, see Granting Permissions for Amazon S3 Inventory
- // and Storage Class Analysis (https://docs.aws.amazon.com/AmazonS3/latest/dev/example-bucket-policies.html#example-bucket-policies-use-case-9).
- //
- // To use this operation, you must have permissions to perform the s3:PutAnalyticsConfiguration
- // action. The bucket owner has this permission by default. The bucket owner
- // can grant this permission to others. For more information about permissions,
- // see Permissions Related to Bucket Subresource Operations (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources)
- // and Managing Access Permissions to Your Amazon S3 Resources (https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html).
- //
- // Special Errors
- //
- // - HTTP Error: HTTP 400 Bad Request Code: InvalidArgument Cause: Invalid
- // argument.
- //
- // - HTTP Error: HTTP 400 Bad Request Code: TooManyConfigurations Cause:
- // You are attempting to create a new configuration but have already reached
- // the 1,000-configuration limit.
- //
- // - HTTP Error: HTTP 403 Forbidden Code: AccessDenied Cause: You are not
- // the owner of the specified bucket, or you do not have the s3:PutAnalyticsConfiguration
- // bucket permission to set the configuration on the bucket.
- //
- // Related Resources
- //
- // - GetBucketAnalyticsConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketAnalyticsConfiguration.html)
- //
- // - DeleteBucketAnalyticsConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketAnalyticsConfiguration.html)
- //
- // - ListBucketAnalyticsConfigurations (https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBucketAnalyticsConfigurations.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation PutBucketAnalyticsConfiguration for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketAnalyticsConfiguration
- func (c *S3) PutBucketAnalyticsConfiguration(input *PutBucketAnalyticsConfigurationInput) (*PutBucketAnalyticsConfigurationOutput, error) {
- req, out := c.PutBucketAnalyticsConfigurationRequest(input)
- return out, req.Send()
- }
- // PutBucketAnalyticsConfigurationWithContext is the same as PutBucketAnalyticsConfiguration with the addition of
- // the ability to pass a context and additional request options.
- //
- // See PutBucketAnalyticsConfiguration 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 *S3) PutBucketAnalyticsConfigurationWithContext(ctx aws.Context, input *PutBucketAnalyticsConfigurationInput, opts ...request.Option) (*PutBucketAnalyticsConfigurationOutput, error) {
- req, out := c.PutBucketAnalyticsConfigurationRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opPutBucketCors = "PutBucketCors"
- // PutBucketCorsRequest generates a "aws/request.Request" representing the
- // client's request for the PutBucketCors 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 PutBucketCors for more information on using the PutBucketCors
- // 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 PutBucketCorsRequest method.
- // req, resp := client.PutBucketCorsRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketCors
- func (c *S3) PutBucketCorsRequest(input *PutBucketCorsInput) (req *request.Request, output *PutBucketCorsOutput) {
- op := &request.Operation{
- Name: opPutBucketCors,
- HTTPMethod: "PUT",
- HTTPPath: "/{Bucket}?cors",
- }
- if input == nil {
- input = &PutBucketCorsInput{}
- }
- output = &PutBucketCorsOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Swap(restxml.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler)
- req.Handlers.Build.PushBackNamed(request.NamedHandler{
- Name: "contentMd5Handler",
- Fn: checksum.AddBodyContentMD5Handler,
- })
- return
- }
- // PutBucketCors API operation for Amazon Simple Storage Service.
- //
- // Sets the cors configuration for your bucket. If the configuration exists,
- // Amazon S3 replaces it.
- //
- // To use this operation, you must be allowed to perform the s3:PutBucketCORS
- // action. By default, the bucket owner has this permission and can grant it
- // to others.
- //
- // You set this configuration on a bucket so that the bucket can service cross-origin
- // requests. For example, you might want to enable a request whose origin is
- // http://www.example.com to access your Amazon S3 bucket at my.example.bucket.com
- // by using the browser's XMLHttpRequest capability.
- //
- // To enable cross-origin resource sharing (CORS) on a bucket, you add the cors
- // subresource to the bucket. The cors subresource is an XML document in which
- // you configure rules that identify origins and the HTTP methods that can be
- // executed on your bucket. The document is limited to 64 KB in size.
- //
- // When Amazon S3 receives a cross-origin request (or a pre-flight OPTIONS request)
- // against a bucket, it evaluates the cors configuration on the bucket and uses
- // the first CORSRule rule that matches the incoming browser request to enable
- // a cross-origin request. For a rule to match, the following conditions must
- // be met:
- //
- // - The request's Origin header must match AllowedOrigin elements.
- //
- // - The request method (for example, GET, PUT, HEAD, and so on) or the Access-Control-Request-Method
- // header in case of a pre-flight OPTIONS request must be one of the AllowedMethod
- // elements.
- //
- // - Every header specified in the Access-Control-Request-Headers request
- // header of a pre-flight request must match an AllowedHeader element.
- //
- // For more information about CORS, go to Enabling Cross-Origin Resource Sharing
- // (https://docs.aws.amazon.com/AmazonS3/latest/dev/cors.html) in the Amazon
- // S3 User Guide.
- //
- // Related Resources
- //
- // - GetBucketCors (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketCors.html)
- //
- // - DeleteBucketCors (https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketCors.html)
- //
- // - RESTOPTIONSobject (https://docs.aws.amazon.com/AmazonS3/latest/API/RESTOPTIONSobject.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation PutBucketCors for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketCors
- func (c *S3) PutBucketCors(input *PutBucketCorsInput) (*PutBucketCorsOutput, error) {
- req, out := c.PutBucketCorsRequest(input)
- return out, req.Send()
- }
- // PutBucketCorsWithContext is the same as PutBucketCors with the addition of
- // the ability to pass a context and additional request options.
- //
- // See PutBucketCors 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 *S3) PutBucketCorsWithContext(ctx aws.Context, input *PutBucketCorsInput, opts ...request.Option) (*PutBucketCorsOutput, error) {
- req, out := c.PutBucketCorsRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opPutBucketEncryption = "PutBucketEncryption"
- // PutBucketEncryptionRequest generates a "aws/request.Request" representing the
- // client's request for the PutBucketEncryption 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 PutBucketEncryption for more information on using the PutBucketEncryption
- // 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 PutBucketEncryptionRequest method.
- // req, resp := client.PutBucketEncryptionRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketEncryption
- func (c *S3) PutBucketEncryptionRequest(input *PutBucketEncryptionInput) (req *request.Request, output *PutBucketEncryptionOutput) {
- op := &request.Operation{
- Name: opPutBucketEncryption,
- HTTPMethod: "PUT",
- HTTPPath: "/{Bucket}?encryption",
- }
- if input == nil {
- input = &PutBucketEncryptionInput{}
- }
- output = &PutBucketEncryptionOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Swap(restxml.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler)
- req.Handlers.Build.PushBackNamed(request.NamedHandler{
- Name: "contentMd5Handler",
- Fn: checksum.AddBodyContentMD5Handler,
- })
- return
- }
- // PutBucketEncryption API operation for Amazon Simple Storage Service.
- //
- // This action uses the encryption subresource to configure default encryption
- // and Amazon S3 Bucket Key for an existing bucket.
- //
- // Default encryption for a bucket can use server-side encryption with Amazon
- // S3-managed keys (SSE-S3) or customer managed keys (SSE-KMS). If you specify
- // default encryption using SSE-KMS, you can also configure Amazon S3 Bucket
- // Key. When the default encryption is SSE-KMS, if you upload an object to the
- // bucket and do not specify the KMS key to use for encryption, Amazon S3 uses
- // the default Amazon Web Services managed KMS key for your account. For information
- // about default encryption, see Amazon S3 default bucket encryption (https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html)
- // in the Amazon S3 User Guide. For more information about S3 Bucket Keys, see
- // Amazon S3 Bucket Keys (https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-key.html)
- // in the Amazon S3 User Guide.
- //
- // This action requires Amazon Web Services Signature Version 4. For more information,
- // see Authenticating Requests (Amazon Web Services Signature Version 4) (https://docs.aws.amazon.com/AmazonS3/latest/API/sig-v4-authenticating-requests.html).
- //
- // To use this operation, you must have permissions to perform the s3:PutEncryptionConfiguration
- // action. The bucket owner has this permission by default. The bucket owner
- // can grant this permission to others. For more information about permissions,
- // see Permissions Related to Bucket Subresource Operations (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources)
- // and Managing Access Permissions to Your Amazon S3 Resources (https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html)
- // in the Amazon S3 User Guide.
- //
- // Related Resources
- //
- // - GetBucketEncryption (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketEncryption.html)
- //
- // - DeleteBucketEncryption (https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketEncryption.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation PutBucketEncryption for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketEncryption
- func (c *S3) PutBucketEncryption(input *PutBucketEncryptionInput) (*PutBucketEncryptionOutput, error) {
- req, out := c.PutBucketEncryptionRequest(input)
- return out, req.Send()
- }
- // PutBucketEncryptionWithContext is the same as PutBucketEncryption with the addition of
- // the ability to pass a context and additional request options.
- //
- // See PutBucketEncryption 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 *S3) PutBucketEncryptionWithContext(ctx aws.Context, input *PutBucketEncryptionInput, opts ...request.Option) (*PutBucketEncryptionOutput, error) {
- req, out := c.PutBucketEncryptionRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opPutBucketIntelligentTieringConfiguration = "PutBucketIntelligentTieringConfiguration"
- // PutBucketIntelligentTieringConfigurationRequest generates a "aws/request.Request" representing the
- // client's request for the PutBucketIntelligentTieringConfiguration 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 PutBucketIntelligentTieringConfiguration for more information on using the PutBucketIntelligentTieringConfiguration
- // 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 PutBucketIntelligentTieringConfigurationRequest method.
- // req, resp := client.PutBucketIntelligentTieringConfigurationRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketIntelligentTieringConfiguration
- func (c *S3) PutBucketIntelligentTieringConfigurationRequest(input *PutBucketIntelligentTieringConfigurationInput) (req *request.Request, output *PutBucketIntelligentTieringConfigurationOutput) {
- op := &request.Operation{
- Name: opPutBucketIntelligentTieringConfiguration,
- HTTPMethod: "PUT",
- HTTPPath: "/{Bucket}?intelligent-tiering",
- }
- if input == nil {
- input = &PutBucketIntelligentTieringConfigurationInput{}
- }
- output = &PutBucketIntelligentTieringConfigurationOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Swap(restxml.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler)
- return
- }
- // PutBucketIntelligentTieringConfiguration API operation for Amazon Simple Storage Service.
- //
- // Puts a S3 Intelligent-Tiering configuration to the specified bucket. You
- // can have up to 1,000 S3 Intelligent-Tiering configurations per bucket.
- //
- // The S3 Intelligent-Tiering storage class is designed to optimize storage
- // costs by automatically moving data to the most cost-effective storage access
- // tier, without performance impact or operational overhead. S3 Intelligent-Tiering
- // delivers automatic cost savings in three low latency and high throughput
- // access tiers. To get the lowest storage cost on data that can be accessed
- // in minutes to hours, you can choose to activate additional archiving capabilities.
- //
- // The S3 Intelligent-Tiering storage class is the ideal storage class for data
- // with unknown, changing, or unpredictable access patterns, independent of
- // object size or retention period. If the size of an object is less than 128
- // KB, it is not monitored and not eligible for auto-tiering. Smaller objects
- // can be stored, but they are always charged at the Frequent Access tier rates
- // in the S3 Intelligent-Tiering storage class.
- //
- // For more information, see Storage class for automatically optimizing frequently
- // and infrequently accessed objects (https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html#sc-dynamic-data-access).
- //
- // Operations related to PutBucketIntelligentTieringConfiguration include:
- //
- // - DeleteBucketIntelligentTieringConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketIntelligentTieringConfiguration.html)
- //
- // - GetBucketIntelligentTieringConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketIntelligentTieringConfiguration.html)
- //
- // - ListBucketIntelligentTieringConfigurations (https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBucketIntelligentTieringConfigurations.html)
- //
- // You only need S3 Intelligent-Tiering enabled on a bucket if you want to automatically
- // move objects stored in the S3 Intelligent-Tiering storage class to the Archive
- // Access or Deep Archive Access tier.
- //
- // Special Errors
- //
- // - HTTP 400 Bad Request Error Code: InvalidArgument Cause: Invalid Argument
- //
- // - HTTP 400 Bad Request Error Code: TooManyConfigurations Cause: You are
- // attempting to create a new configuration but have already reached the
- // 1,000-configuration limit.
- //
- // - HTTP 403 Forbidden Error Code: AccessDenied Cause: You are not the owner
- // of the specified bucket, or you do not have the s3:PutIntelligentTieringConfiguration
- // bucket permission to set the configuration on the bucket.
- //
- // 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 Amazon Simple Storage Service's
- // API operation PutBucketIntelligentTieringConfiguration for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketIntelligentTieringConfiguration
- func (c *S3) PutBucketIntelligentTieringConfiguration(input *PutBucketIntelligentTieringConfigurationInput) (*PutBucketIntelligentTieringConfigurationOutput, error) {
- req, out := c.PutBucketIntelligentTieringConfigurationRequest(input)
- return out, req.Send()
- }
- // PutBucketIntelligentTieringConfigurationWithContext is the same as PutBucketIntelligentTieringConfiguration with the addition of
- // the ability to pass a context and additional request options.
- //
- // See PutBucketIntelligentTieringConfiguration 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 *S3) PutBucketIntelligentTieringConfigurationWithContext(ctx aws.Context, input *PutBucketIntelligentTieringConfigurationInput, opts ...request.Option) (*PutBucketIntelligentTieringConfigurationOutput, error) {
- req, out := c.PutBucketIntelligentTieringConfigurationRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opPutBucketInventoryConfiguration = "PutBucketInventoryConfiguration"
- // PutBucketInventoryConfigurationRequest generates a "aws/request.Request" representing the
- // client's request for the PutBucketInventoryConfiguration 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 PutBucketInventoryConfiguration for more information on using the PutBucketInventoryConfiguration
- // 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 PutBucketInventoryConfigurationRequest method.
- // req, resp := client.PutBucketInventoryConfigurationRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketInventoryConfiguration
- func (c *S3) PutBucketInventoryConfigurationRequest(input *PutBucketInventoryConfigurationInput) (req *request.Request, output *PutBucketInventoryConfigurationOutput) {
- op := &request.Operation{
- Name: opPutBucketInventoryConfiguration,
- HTTPMethod: "PUT",
- HTTPPath: "/{Bucket}?inventory",
- }
- if input == nil {
- input = &PutBucketInventoryConfigurationInput{}
- }
- output = &PutBucketInventoryConfigurationOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Swap(restxml.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler)
- return
- }
- // PutBucketInventoryConfiguration API operation for Amazon Simple Storage Service.
- //
- // This implementation of the PUT action adds an inventory configuration (identified
- // by the inventory ID) to the bucket. You can have up to 1,000 inventory configurations
- // per bucket.
- //
- // Amazon S3 inventory generates inventories of the objects in the bucket on
- // a daily or weekly basis, and the results are published to a flat file. The
- // bucket that is inventoried is called the source bucket, and the bucket where
- // the inventory flat file is stored is called the destination bucket. The destination
- // bucket must be in the same Amazon Web Services Region as the source bucket.
- //
- // When you configure an inventory for a source bucket, you specify the destination
- // bucket where you want the inventory to be stored, and whether to generate
- // the inventory daily or weekly. You can also configure what object metadata
- // to include and whether to inventory all object versions or only current versions.
- // For more information, see Amazon S3 Inventory (https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-inventory.html)
- // in the Amazon S3 User Guide.
- //
- // You must create a bucket policy on the destination bucket to grant permissions
- // to Amazon S3 to write objects to the bucket in the defined location. For
- // an example policy, see Granting Permissions for Amazon S3 Inventory and Storage
- // Class Analysis (https://docs.aws.amazon.com/AmazonS3/latest/dev/example-bucket-policies.html#example-bucket-policies-use-case-9).
- //
- // To use this operation, you must have permissions to perform the s3:PutInventoryConfiguration
- // action. The bucket owner has this permission by default and can grant this
- // permission to others. For more information about permissions, see Permissions
- // Related to Bucket Subresource Operations (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources)
- // and Managing Access Permissions to Your Amazon S3 Resources (https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html)
- // in the Amazon S3 User Guide.
- //
- // Special Errors
- //
- // - HTTP 400 Bad Request Error Code: InvalidArgument Cause: Invalid Argument
- //
- // - HTTP 400 Bad Request Error Code: TooManyConfigurations Cause: You are
- // attempting to create a new configuration but have already reached the
- // 1,000-configuration limit.
- //
- // - HTTP 403 Forbidden Error Code: AccessDenied Cause: You are not the owner
- // of the specified bucket, or you do not have the s3:PutInventoryConfiguration
- // bucket permission to set the configuration on the bucket.
- //
- // Related Resources
- //
- // - GetBucketInventoryConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketInventoryConfiguration.html)
- //
- // - DeleteBucketInventoryConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketInventoryConfiguration.html)
- //
- // - ListBucketInventoryConfigurations (https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBucketInventoryConfigurations.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation PutBucketInventoryConfiguration for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketInventoryConfiguration
- func (c *S3) PutBucketInventoryConfiguration(input *PutBucketInventoryConfigurationInput) (*PutBucketInventoryConfigurationOutput, error) {
- req, out := c.PutBucketInventoryConfigurationRequest(input)
- return out, req.Send()
- }
- // PutBucketInventoryConfigurationWithContext is the same as PutBucketInventoryConfiguration with the addition of
- // the ability to pass a context and additional request options.
- //
- // See PutBucketInventoryConfiguration 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 *S3) PutBucketInventoryConfigurationWithContext(ctx aws.Context, input *PutBucketInventoryConfigurationInput, opts ...request.Option) (*PutBucketInventoryConfigurationOutput, error) {
- req, out := c.PutBucketInventoryConfigurationRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opPutBucketLifecycle = "PutBucketLifecycle"
- // PutBucketLifecycleRequest generates a "aws/request.Request" representing the
- // client's request for the PutBucketLifecycle 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 PutBucketLifecycle for more information on using the PutBucketLifecycle
- // 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 PutBucketLifecycleRequest method.
- // req, resp := client.PutBucketLifecycleRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketLifecycle
- //
- // Deprecated: PutBucketLifecycle has been deprecated
- func (c *S3) PutBucketLifecycleRequest(input *PutBucketLifecycleInput) (req *request.Request, output *PutBucketLifecycleOutput) {
- if c.Client.Config.Logger != nil {
- c.Client.Config.Logger.Log("This operation, PutBucketLifecycle, has been deprecated")
- }
- op := &request.Operation{
- Name: opPutBucketLifecycle,
- HTTPMethod: "PUT",
- HTTPPath: "/{Bucket}?lifecycle",
- }
- if input == nil {
- input = &PutBucketLifecycleInput{}
- }
- output = &PutBucketLifecycleOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Swap(restxml.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler)
- req.Handlers.Build.PushBackNamed(request.NamedHandler{
- Name: "contentMd5Handler",
- Fn: checksum.AddBodyContentMD5Handler,
- })
- return
- }
- // PutBucketLifecycle API operation for Amazon Simple Storage Service.
- //
- // For an updated version of this API, see PutBucketLifecycleConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html).
- // This version has been deprecated. Existing lifecycle configurations will
- // work. For new lifecycle configurations, use the updated API.
- //
- // Creates a new lifecycle configuration for the bucket or replaces an existing
- // lifecycle configuration. For information about lifecycle configuration, see
- // Object Lifecycle Management (https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html)
- // in the Amazon S3 User Guide.
- //
- // By default, all Amazon S3 resources, including buckets, objects, and related
- // subresources (for example, lifecycle configuration and website configuration)
- // are private. Only the resource owner, the Amazon Web Services account that
- // created the resource, can access it. The resource owner can optionally grant
- // access permissions to others by writing an access policy. For this operation,
- // users must get the s3:PutLifecycleConfiguration permission.
- //
- // You can also explicitly deny permissions. Explicit denial also supersedes
- // any other permissions. If you want to prevent users or accounts from removing
- // or deleting objects from your bucket, you must deny them permissions for
- // the following actions:
- //
- // - s3:DeleteObject
- //
- // - s3:DeleteObjectVersion
- //
- // - s3:PutLifecycleConfiguration
- //
- // For more information about permissions, see Managing Access Permissions to
- // your Amazon S3 Resources (https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html)
- // in the Amazon S3 User Guide.
- //
- // For more examples of transitioning objects to storage classes such as STANDARD_IA
- // or ONEZONE_IA, see Examples of Lifecycle Configuration (https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html#lifecycle-configuration-examples).
- //
- // Related Resources
- //
- // - GetBucketLifecycle (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycle.html)(Deprecated)
- //
- // - GetBucketLifecycleConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html)
- //
- // - RestoreObject (https://docs.aws.amazon.com/AmazonS3/latest/API/API_RestoreObject.html)
- //
- // - By default, a resource owner—in this case, a bucket owner, which is
- // the Amazon Web Services account that created the bucket—can perform
- // any of the operations. A resource owner can also grant others permission
- // to perform the operation. For more information, see the following topics
- // in the Amazon S3 User Guide: Specifying Permissions in a Policy (https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html)
- // Managing Access Permissions to your Amazon S3 Resources (https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation PutBucketLifecycle for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketLifecycle
- //
- // Deprecated: PutBucketLifecycle has been deprecated
- func (c *S3) PutBucketLifecycle(input *PutBucketLifecycleInput) (*PutBucketLifecycleOutput, error) {
- req, out := c.PutBucketLifecycleRequest(input)
- return out, req.Send()
- }
- // PutBucketLifecycleWithContext is the same as PutBucketLifecycle with the addition of
- // the ability to pass a context and additional request options.
- //
- // See PutBucketLifecycle 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.
- //
- // Deprecated: PutBucketLifecycleWithContext has been deprecated
- func (c *S3) PutBucketLifecycleWithContext(ctx aws.Context, input *PutBucketLifecycleInput, opts ...request.Option) (*PutBucketLifecycleOutput, error) {
- req, out := c.PutBucketLifecycleRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opPutBucketLifecycleConfiguration = "PutBucketLifecycleConfiguration"
- // PutBucketLifecycleConfigurationRequest generates a "aws/request.Request" representing the
- // client's request for the PutBucketLifecycleConfiguration 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 PutBucketLifecycleConfiguration for more information on using the PutBucketLifecycleConfiguration
- // 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 PutBucketLifecycleConfigurationRequest method.
- // req, resp := client.PutBucketLifecycleConfigurationRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketLifecycleConfiguration
- func (c *S3) PutBucketLifecycleConfigurationRequest(input *PutBucketLifecycleConfigurationInput) (req *request.Request, output *PutBucketLifecycleConfigurationOutput) {
- op := &request.Operation{
- Name: opPutBucketLifecycleConfiguration,
- HTTPMethod: "PUT",
- HTTPPath: "/{Bucket}?lifecycle",
- }
- if input == nil {
- input = &PutBucketLifecycleConfigurationInput{}
- }
- output = &PutBucketLifecycleConfigurationOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Swap(restxml.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler)
- req.Handlers.Build.PushBackNamed(request.NamedHandler{
- Name: "contentMd5Handler",
- Fn: checksum.AddBodyContentMD5Handler,
- })
- return
- }
- // PutBucketLifecycleConfiguration API operation for Amazon Simple Storage Service.
- //
- // Creates a new lifecycle configuration for the bucket or replaces an existing
- // lifecycle configuration. Keep in mind that this will overwrite an existing
- // lifecycle configuration, so if you want to retain any configuration details,
- // they must be included in the new lifecycle configuration. For information
- // about lifecycle configuration, see Managing your storage lifecycle (https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html).
- //
- // Bucket lifecycle configuration now supports specifying a lifecycle rule using
- // an object key name prefix, one or more object tags, or a combination of both.
- // Accordingly, this section describes the latest API. The previous version
- // of the API supported filtering based only on an object key name prefix, which
- // is supported for backward compatibility. For the related API description,
- // see PutBucketLifecycle (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycle.html).
- //
- // # Rules
- //
- // You specify the lifecycle configuration in your request body. The lifecycle
- // configuration is specified as XML consisting of one or more rules. An Amazon
- // S3 Lifecycle configuration can have up to 1,000 rules. This limit is not
- // adjustable. Each rule consists of the following:
- //
- // - Filter identifying a subset of objects to which the rule applies. The
- // filter can be based on a key name prefix, object tags, or a combination
- // of both.
- //
- // - Status whether the rule is in effect.
- //
- // - One or more lifecycle transition and expiration actions that you want
- // Amazon S3 to perform on the objects identified by the filter. If the state
- // of your bucket is versioning-enabled or versioning-suspended, you can
- // have many versions of the same object (one current version and zero or
- // more noncurrent versions). Amazon S3 provides predefined actions that
- // you can specify for current and noncurrent object versions.
- //
- // For more information, see Object Lifecycle Management (https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html)
- // and Lifecycle Configuration Elements (https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html).
- //
- // # Permissions
- //
- // By default, all Amazon S3 resources are private, including buckets, objects,
- // and related subresources (for example, lifecycle configuration and website
- // configuration). Only the resource owner (that is, the Amazon Web Services
- // account that created it) can access the resource. The resource owner can
- // optionally grant access permissions to others by writing an access policy.
- // For this operation, a user must get the s3:PutLifecycleConfiguration permission.
- //
- // You can also explicitly deny permissions. Explicit deny also supersedes any
- // other permissions. If you want to block users or accounts from removing or
- // deleting objects from your bucket, you must deny them permissions for the
- // following actions:
- //
- // - s3:DeleteObject
- //
- // - s3:DeleteObjectVersion
- //
- // - s3:PutLifecycleConfiguration
- //
- // For more information about permissions, see Managing Access Permissions to
- // Your Amazon S3 Resources (https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html).
- //
- // The following are related to PutBucketLifecycleConfiguration:
- //
- // - Examples of Lifecycle Configuration (https://docs.aws.amazon.com/AmazonS3/latest/dev/lifecycle-configuration-examples.html)
- //
- // - GetBucketLifecycleConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html)
- //
- // - DeleteBucketLifecycle (https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation PutBucketLifecycleConfiguration for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketLifecycleConfiguration
- func (c *S3) PutBucketLifecycleConfiguration(input *PutBucketLifecycleConfigurationInput) (*PutBucketLifecycleConfigurationOutput, error) {
- req, out := c.PutBucketLifecycleConfigurationRequest(input)
- return out, req.Send()
- }
- // PutBucketLifecycleConfigurationWithContext is the same as PutBucketLifecycleConfiguration with the addition of
- // the ability to pass a context and additional request options.
- //
- // See PutBucketLifecycleConfiguration 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 *S3) PutBucketLifecycleConfigurationWithContext(ctx aws.Context, input *PutBucketLifecycleConfigurationInput, opts ...request.Option) (*PutBucketLifecycleConfigurationOutput, error) {
- req, out := c.PutBucketLifecycleConfigurationRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opPutBucketLogging = "PutBucketLogging"
- // PutBucketLoggingRequest generates a "aws/request.Request" representing the
- // client's request for the PutBucketLogging 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 PutBucketLogging for more information on using the PutBucketLogging
- // 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 PutBucketLoggingRequest method.
- // req, resp := client.PutBucketLoggingRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketLogging
- func (c *S3) PutBucketLoggingRequest(input *PutBucketLoggingInput) (req *request.Request, output *PutBucketLoggingOutput) {
- op := &request.Operation{
- Name: opPutBucketLogging,
- HTTPMethod: "PUT",
- HTTPPath: "/{Bucket}?logging",
- }
- if input == nil {
- input = &PutBucketLoggingInput{}
- }
- output = &PutBucketLoggingOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Swap(restxml.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler)
- req.Handlers.Build.PushBackNamed(request.NamedHandler{
- Name: "contentMd5Handler",
- Fn: checksum.AddBodyContentMD5Handler,
- })
- return
- }
- // PutBucketLogging API operation for Amazon Simple Storage Service.
- //
- // Set the logging parameters for a bucket and to specify permissions for who
- // can view and modify the logging parameters. All logs are saved to buckets
- // in the same Amazon Web Services Region as the source bucket. To set the logging
- // status of a bucket, you must be the bucket owner.
- //
- // The bucket owner is automatically granted FULL_CONTROL to all logs. You use
- // the Grantee request element to grant access to other people. The Permissions
- // request element specifies the kind of access the grantee has to the logs.
- //
- // If the target bucket for log delivery uses the bucket owner enforced setting
- // for S3 Object Ownership, you can't use the Grantee request element to grant
- // access to others. Permissions can only be granted using policies. For more
- // information, see Permissions for server access log delivery (https://docs.aws.amazon.com/AmazonS3/latest/userguide/enable-server-access-logging.html#grant-log-delivery-permissions-general)
- // in the Amazon S3 User Guide.
- //
- // # Grantee Values
- //
- // You can specify the person (grantee) to whom you're assigning access rights
- // (using request elements) in the following ways:
- //
- // - By the person's ID: <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- // xsi:type="CanonicalUser"><ID><>ID<></ID><DisplayName><>GranteesEmail<></DisplayName>
- // </Grantee> DisplayName is optional and ignored in the request.
- //
- // - By Email address: <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- // xsi:type="AmazonCustomerByEmail"><EmailAddress><>Grantees@email.com<></EmailAddress></Grantee>
- // The grantee is resolved to the CanonicalUser and, in a response to a GET
- // Object acl request, appears as the CanonicalUser.
- //
- // - By URI: <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- // xsi:type="Group"><URI><>http://acs.amazonaws.com/groups/global/AuthenticatedUsers<></URI></Grantee>
- //
- // To enable logging, you use LoggingEnabled and its children request elements.
- // To disable logging, you use an empty BucketLoggingStatus request element:
- //
- // <BucketLoggingStatus xmlns="http://doc.s3.amazonaws.com/2006-03-01" />
- //
- // For more information about server access logging, see Server Access Logging
- // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/ServerLogs.html) in
- // the Amazon S3 User Guide.
- //
- // For more information about creating a bucket, see CreateBucket (https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html).
- // For more information about returning the logging status of a bucket, see
- // GetBucketLogging (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLogging.html).
- //
- // The following operations are related to PutBucketLogging:
- //
- // - PutObject (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html)
- //
- // - DeleteBucket (https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucket.html)
- //
- // - CreateBucket (https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html)
- //
- // - GetBucketLogging (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLogging.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation PutBucketLogging for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketLogging
- func (c *S3) PutBucketLogging(input *PutBucketLoggingInput) (*PutBucketLoggingOutput, error) {
- req, out := c.PutBucketLoggingRequest(input)
- return out, req.Send()
- }
- // PutBucketLoggingWithContext is the same as PutBucketLogging with the addition of
- // the ability to pass a context and additional request options.
- //
- // See PutBucketLogging 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 *S3) PutBucketLoggingWithContext(ctx aws.Context, input *PutBucketLoggingInput, opts ...request.Option) (*PutBucketLoggingOutput, error) {
- req, out := c.PutBucketLoggingRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opPutBucketMetricsConfiguration = "PutBucketMetricsConfiguration"
- // PutBucketMetricsConfigurationRequest generates a "aws/request.Request" representing the
- // client's request for the PutBucketMetricsConfiguration 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 PutBucketMetricsConfiguration for more information on using the PutBucketMetricsConfiguration
- // 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 PutBucketMetricsConfigurationRequest method.
- // req, resp := client.PutBucketMetricsConfigurationRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketMetricsConfiguration
- func (c *S3) PutBucketMetricsConfigurationRequest(input *PutBucketMetricsConfigurationInput) (req *request.Request, output *PutBucketMetricsConfigurationOutput) {
- op := &request.Operation{
- Name: opPutBucketMetricsConfiguration,
- HTTPMethod: "PUT",
- HTTPPath: "/{Bucket}?metrics",
- }
- if input == nil {
- input = &PutBucketMetricsConfigurationInput{}
- }
- output = &PutBucketMetricsConfigurationOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Swap(restxml.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler)
- return
- }
- // PutBucketMetricsConfiguration API operation for Amazon Simple Storage Service.
- //
- // Sets a metrics configuration (specified by the metrics configuration ID)
- // for the bucket. You can have up to 1,000 metrics configurations per bucket.
- // If you're updating an existing metrics configuration, note that this is a
- // full replacement of the existing metrics configuration. If you don't include
- // the elements you want to keep, they are erased.
- //
- // To use this operation, you must have permissions to perform the s3:PutMetricsConfiguration
- // action. The bucket owner has this permission by default. The bucket owner
- // can grant this permission to others. For more information about permissions,
- // see Permissions Related to Bucket Subresource Operations (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources)
- // and Managing Access Permissions to Your Amazon S3 Resources (https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html).
- //
- // For information about CloudWatch request metrics for Amazon S3, see Monitoring
- // Metrics with Amazon CloudWatch (https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html).
- //
- // The following operations are related to PutBucketMetricsConfiguration:
- //
- // - DeleteBucketMetricsConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketMetricsConfiguration.html)
- //
- // - GetBucketMetricsConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketMetricsConfiguration.html)
- //
- // - ListBucketMetricsConfigurations (https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBucketMetricsConfigurations.html)
- //
- // GetBucketLifecycle has the following special error:
- //
- // - Error code: TooManyConfigurations Description: You are attempting to
- // create a new configuration but have already reached the 1,000-configuration
- // limit. HTTP Status Code: HTTP 400 Bad 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 Amazon Simple Storage Service's
- // API operation PutBucketMetricsConfiguration for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketMetricsConfiguration
- func (c *S3) PutBucketMetricsConfiguration(input *PutBucketMetricsConfigurationInput) (*PutBucketMetricsConfigurationOutput, error) {
- req, out := c.PutBucketMetricsConfigurationRequest(input)
- return out, req.Send()
- }
- // PutBucketMetricsConfigurationWithContext is the same as PutBucketMetricsConfiguration with the addition of
- // the ability to pass a context and additional request options.
- //
- // See PutBucketMetricsConfiguration 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 *S3) PutBucketMetricsConfigurationWithContext(ctx aws.Context, input *PutBucketMetricsConfigurationInput, opts ...request.Option) (*PutBucketMetricsConfigurationOutput, error) {
- req, out := c.PutBucketMetricsConfigurationRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opPutBucketNotification = "PutBucketNotification"
- // PutBucketNotificationRequest generates a "aws/request.Request" representing the
- // client's request for the PutBucketNotification 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 PutBucketNotification for more information on using the PutBucketNotification
- // 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 PutBucketNotificationRequest method.
- // req, resp := client.PutBucketNotificationRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketNotification
- //
- // Deprecated: PutBucketNotification has been deprecated
- func (c *S3) PutBucketNotificationRequest(input *PutBucketNotificationInput) (req *request.Request, output *PutBucketNotificationOutput) {
- if c.Client.Config.Logger != nil {
- c.Client.Config.Logger.Log("This operation, PutBucketNotification, has been deprecated")
- }
- op := &request.Operation{
- Name: opPutBucketNotification,
- HTTPMethod: "PUT",
- HTTPPath: "/{Bucket}?notification",
- }
- if input == nil {
- input = &PutBucketNotificationInput{}
- }
- output = &PutBucketNotificationOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Swap(restxml.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler)
- req.Handlers.Build.PushBackNamed(request.NamedHandler{
- Name: "contentMd5Handler",
- Fn: checksum.AddBodyContentMD5Handler,
- })
- return
- }
- // PutBucketNotification API operation for Amazon Simple Storage Service.
- //
- // No longer used, see the PutBucketNotificationConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketNotificationConfiguration.html)
- // operation.
- //
- // 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 Amazon Simple Storage Service's
- // API operation PutBucketNotification for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketNotification
- //
- // Deprecated: PutBucketNotification has been deprecated
- func (c *S3) PutBucketNotification(input *PutBucketNotificationInput) (*PutBucketNotificationOutput, error) {
- req, out := c.PutBucketNotificationRequest(input)
- return out, req.Send()
- }
- // PutBucketNotificationWithContext is the same as PutBucketNotification with the addition of
- // the ability to pass a context and additional request options.
- //
- // See PutBucketNotification 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.
- //
- // Deprecated: PutBucketNotificationWithContext has been deprecated
- func (c *S3) PutBucketNotificationWithContext(ctx aws.Context, input *PutBucketNotificationInput, opts ...request.Option) (*PutBucketNotificationOutput, error) {
- req, out := c.PutBucketNotificationRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opPutBucketNotificationConfiguration = "PutBucketNotificationConfiguration"
- // PutBucketNotificationConfigurationRequest generates a "aws/request.Request" representing the
- // client's request for the PutBucketNotificationConfiguration 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 PutBucketNotificationConfiguration for more information on using the PutBucketNotificationConfiguration
- // 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 PutBucketNotificationConfigurationRequest method.
- // req, resp := client.PutBucketNotificationConfigurationRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketNotificationConfiguration
- func (c *S3) PutBucketNotificationConfigurationRequest(input *PutBucketNotificationConfigurationInput) (req *request.Request, output *PutBucketNotificationConfigurationOutput) {
- op := &request.Operation{
- Name: opPutBucketNotificationConfiguration,
- HTTPMethod: "PUT",
- HTTPPath: "/{Bucket}?notification",
- }
- if input == nil {
- input = &PutBucketNotificationConfigurationInput{}
- }
- output = &PutBucketNotificationConfigurationOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Swap(restxml.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler)
- return
- }
- // PutBucketNotificationConfiguration API operation for Amazon Simple Storage Service.
- //
- // Enables notifications of specified events for a bucket. For more information
- // about event notifications, see Configuring Event Notifications (https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html).
- //
- // Using this API, you can replace an existing notification configuration. The
- // configuration is an XML file that defines the event types that you want Amazon
- // S3 to publish and the destination where you want Amazon S3 to publish an
- // event notification when it detects an event of the specified type.
- //
- // By default, your bucket has no event notifications configured. That is, the
- // notification configuration will be an empty NotificationConfiguration.
- //
- // <NotificationConfiguration>
- //
- // </NotificationConfiguration>
- //
- // This action replaces the existing notification configuration with the configuration
- // you include in the request body.
- //
- // After Amazon S3 receives this request, it first verifies that any Amazon
- // Simple Notification Service (Amazon SNS) or Amazon Simple Queue Service (Amazon
- // SQS) destination exists, and that the bucket owner has permission to publish
- // to it by sending a test notification. In the case of Lambda destinations,
- // Amazon S3 verifies that the Lambda function permissions grant Amazon S3 permission
- // to invoke the function from the Amazon S3 bucket. For more information, see
- // Configuring Notifications for Amazon S3 Events (https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html).
- //
- // You can disable notifications by adding the empty NotificationConfiguration
- // element.
- //
- // For more information about the number of event notification configurations
- // that you can create per bucket, see Amazon S3 service quotas (https://docs.aws.amazon.com/general/latest/gr/s3.html#limits_s3)
- // in Amazon Web Services General Reference.
- //
- // By default, only the bucket owner can configure notifications on a bucket.
- // However, bucket owners can use a bucket policy to grant permission to other
- // users to set this configuration with s3:PutBucketNotification permission.
- //
- // The PUT notification is an atomic operation. For example, suppose your notification
- // configuration includes SNS topic, SQS queue, and Lambda function configurations.
- // When you send a PUT request with this configuration, Amazon S3 sends test
- // messages to your SNS topic. If the message fails, the entire PUT action will
- // fail, and Amazon S3 will not add the configuration to your bucket.
- //
- // # Responses
- //
- // If the configuration in the request body includes only one TopicConfiguration
- // specifying only the s3:ReducedRedundancyLostObject event type, the response
- // will also include the x-amz-sns-test-message-id header containing the message
- // ID of the test notification sent to the topic.
- //
- // The following action is related to PutBucketNotificationConfiguration:
- //
- // - GetBucketNotificationConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketNotificationConfiguration.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation PutBucketNotificationConfiguration for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketNotificationConfiguration
- func (c *S3) PutBucketNotificationConfiguration(input *PutBucketNotificationConfigurationInput) (*PutBucketNotificationConfigurationOutput, error) {
- req, out := c.PutBucketNotificationConfigurationRequest(input)
- return out, req.Send()
- }
- // PutBucketNotificationConfigurationWithContext is the same as PutBucketNotificationConfiguration with the addition of
- // the ability to pass a context and additional request options.
- //
- // See PutBucketNotificationConfiguration 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 *S3) PutBucketNotificationConfigurationWithContext(ctx aws.Context, input *PutBucketNotificationConfigurationInput, opts ...request.Option) (*PutBucketNotificationConfigurationOutput, error) {
- req, out := c.PutBucketNotificationConfigurationRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opPutBucketOwnershipControls = "PutBucketOwnershipControls"
- // PutBucketOwnershipControlsRequest generates a "aws/request.Request" representing the
- // client's request for the PutBucketOwnershipControls 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 PutBucketOwnershipControls for more information on using the PutBucketOwnershipControls
- // 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 PutBucketOwnershipControlsRequest method.
- // req, resp := client.PutBucketOwnershipControlsRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketOwnershipControls
- func (c *S3) PutBucketOwnershipControlsRequest(input *PutBucketOwnershipControlsInput) (req *request.Request, output *PutBucketOwnershipControlsOutput) {
- op := &request.Operation{
- Name: opPutBucketOwnershipControls,
- HTTPMethod: "PUT",
- HTTPPath: "/{Bucket}?ownershipControls",
- }
- if input == nil {
- input = &PutBucketOwnershipControlsInput{}
- }
- output = &PutBucketOwnershipControlsOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Swap(restxml.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler)
- req.Handlers.Build.PushBackNamed(request.NamedHandler{
- Name: "contentMd5Handler",
- Fn: checksum.AddBodyContentMD5Handler,
- })
- return
- }
- // PutBucketOwnershipControls API operation for Amazon Simple Storage Service.
- //
- // Creates or modifies OwnershipControls for an Amazon S3 bucket. To use this
- // operation, you must have the s3:PutBucketOwnershipControls permission. For
- // more information about Amazon S3 permissions, see Specifying permissions
- // in a policy (https://docs.aws.amazon.com/AmazonS3/latest/user-guide/using-with-s3-actions.html).
- //
- // For information about Amazon S3 Object Ownership, see Using object ownership
- // (https://docs.aws.amazon.com/AmazonS3/latest/user-guide/about-object-ownership.html).
- //
- // The following operations are related to PutBucketOwnershipControls:
- //
- // - GetBucketOwnershipControls
- //
- // - DeleteBucketOwnershipControls
- //
- // 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 Amazon Simple Storage Service's
- // API operation PutBucketOwnershipControls for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketOwnershipControls
- func (c *S3) PutBucketOwnershipControls(input *PutBucketOwnershipControlsInput) (*PutBucketOwnershipControlsOutput, error) {
- req, out := c.PutBucketOwnershipControlsRequest(input)
- return out, req.Send()
- }
- // PutBucketOwnershipControlsWithContext is the same as PutBucketOwnershipControls with the addition of
- // the ability to pass a context and additional request options.
- //
- // See PutBucketOwnershipControls 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 *S3) PutBucketOwnershipControlsWithContext(ctx aws.Context, input *PutBucketOwnershipControlsInput, opts ...request.Option) (*PutBucketOwnershipControlsOutput, error) {
- req, out := c.PutBucketOwnershipControlsRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opPutBucketPolicy = "PutBucketPolicy"
- // PutBucketPolicyRequest generates a "aws/request.Request" representing the
- // client's request for the PutBucketPolicy 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 PutBucketPolicy for more information on using the PutBucketPolicy
- // 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 PutBucketPolicyRequest method.
- // req, resp := client.PutBucketPolicyRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketPolicy
- func (c *S3) PutBucketPolicyRequest(input *PutBucketPolicyInput) (req *request.Request, output *PutBucketPolicyOutput) {
- op := &request.Operation{
- Name: opPutBucketPolicy,
- HTTPMethod: "PUT",
- HTTPPath: "/{Bucket}?policy",
- }
- if input == nil {
- input = &PutBucketPolicyInput{}
- }
- output = &PutBucketPolicyOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Swap(restxml.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler)
- req.Handlers.Build.PushBackNamed(request.NamedHandler{
- Name: "contentMd5Handler",
- Fn: checksum.AddBodyContentMD5Handler,
- })
- return
- }
- // PutBucketPolicy API operation for Amazon Simple Storage Service.
- //
- // Applies an Amazon S3 bucket policy to an Amazon S3 bucket. If you are using
- // an identity other than the root user of the Amazon Web Services account that
- // owns the bucket, the calling identity must have the PutBucketPolicy permissions
- // on the specified bucket and belong to the bucket owner's account in order
- // to use this operation.
- //
- // If you don't have PutBucketPolicy permissions, Amazon S3 returns a 403 Access
- // Denied error. If you have the correct permissions, but you're not using an
- // identity that belongs to the bucket owner's account, Amazon S3 returns a
- // 405 Method Not Allowed error.
- //
- // As a security precaution, the root user of the Amazon Web Services account
- // that owns a bucket can always use this operation, even if the policy explicitly
- // denies the root user the ability to perform this action.
- //
- // For more information, see Bucket policy examples (https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-bucket-policies.html).
- //
- // The following operations are related to PutBucketPolicy:
- //
- // - CreateBucket (https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html)
- //
- // - DeleteBucket (https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucket.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation PutBucketPolicy for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketPolicy
- func (c *S3) PutBucketPolicy(input *PutBucketPolicyInput) (*PutBucketPolicyOutput, error) {
- req, out := c.PutBucketPolicyRequest(input)
- return out, req.Send()
- }
- // PutBucketPolicyWithContext is the same as PutBucketPolicy with the addition of
- // the ability to pass a context and additional request options.
- //
- // See PutBucketPolicy 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 *S3) PutBucketPolicyWithContext(ctx aws.Context, input *PutBucketPolicyInput, opts ...request.Option) (*PutBucketPolicyOutput, error) {
- req, out := c.PutBucketPolicyRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opPutBucketReplication = "PutBucketReplication"
- // PutBucketReplicationRequest generates a "aws/request.Request" representing the
- // client's request for the PutBucketReplication 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 PutBucketReplication for more information on using the PutBucketReplication
- // 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 PutBucketReplicationRequest method.
- // req, resp := client.PutBucketReplicationRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketReplication
- func (c *S3) PutBucketReplicationRequest(input *PutBucketReplicationInput) (req *request.Request, output *PutBucketReplicationOutput) {
- op := &request.Operation{
- Name: opPutBucketReplication,
- HTTPMethod: "PUT",
- HTTPPath: "/{Bucket}?replication",
- }
- if input == nil {
- input = &PutBucketReplicationInput{}
- }
- output = &PutBucketReplicationOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Swap(restxml.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler)
- req.Handlers.Build.PushBackNamed(request.NamedHandler{
- Name: "contentMd5Handler",
- Fn: checksum.AddBodyContentMD5Handler,
- })
- return
- }
- // PutBucketReplication API operation for Amazon Simple Storage Service.
- //
- // Creates a replication configuration or replaces an existing one. For more
- // information, see Replication (https://docs.aws.amazon.com/AmazonS3/latest/dev/replication.html)
- // in the Amazon S3 User Guide.
- //
- // Specify the replication configuration in the request body. In the replication
- // configuration, you provide the name of the destination bucket or buckets
- // where you want Amazon S3 to replicate objects, the IAM role that Amazon S3
- // can assume to replicate objects on your behalf, and other relevant information.
- //
- // A replication configuration must include at least one rule, and can contain
- // a maximum of 1,000. Each rule identifies a subset of objects to replicate
- // by filtering the objects in the source bucket. To choose additional subsets
- // of objects to replicate, add a rule for each subset.
- //
- // To specify a subset of the objects in the source bucket to apply a replication
- // rule to, add the Filter element as a child of the Rule element. You can filter
- // objects based on an object key prefix, one or more object tags, or both.
- // When you add the Filter element in the configuration, you must also add the
- // following elements: DeleteMarkerReplication, Status, and Priority.
- //
- // If you are using an earlier version of the replication configuration, Amazon
- // S3 handles replication of delete markers differently. For more information,
- // see Backward Compatibility (https://docs.aws.amazon.com/AmazonS3/latest/dev/replication-add-config.html#replication-backward-compat-considerations).
- //
- // For information about enabling versioning on a bucket, see Using Versioning
- // (https://docs.aws.amazon.com/AmazonS3/latest/dev/Versioning.html).
- //
- // # Handling Replication of Encrypted Objects
- //
- // By default, Amazon S3 doesn't replicate objects that are stored at rest using
- // server-side encryption with KMS keys. To replicate Amazon Web Services KMS-encrypted
- // objects, add the following: SourceSelectionCriteria, SseKmsEncryptedObjects,
- // Status, EncryptionConfiguration, and ReplicaKmsKeyID. For information about
- // replication configuration, see Replicating Objects Created with SSE Using
- // KMS keys (https://docs.aws.amazon.com/AmazonS3/latest/dev/replication-config-for-kms-objects.html).
- //
- // For information on PutBucketReplication errors, see List of replication-related
- // error codes (https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#ReplicationErrorCodeList)
- //
- // # Permissions
- //
- // To create a PutBucketReplication request, you must have s3:PutReplicationConfiguration
- // permissions for the bucket.
- //
- // By default, a resource owner, in this case the Amazon Web Services account
- // that created the bucket, can perform this operation. The resource owner can
- // also grant others permissions to perform the operation. For more information
- // about permissions, see Specifying Permissions in a Policy (https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html)
- // and Managing Access Permissions to Your Amazon S3 Resources (https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html).
- //
- // To perform this operation, the user or role performing the action must have
- // the iam:PassRole (https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_passrole.html)
- // permission.
- //
- // The following operations are related to PutBucketReplication:
- //
- // - GetBucketReplication (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketReplication.html)
- //
- // - DeleteBucketReplication (https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketReplication.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation PutBucketReplication for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketReplication
- func (c *S3) PutBucketReplication(input *PutBucketReplicationInput) (*PutBucketReplicationOutput, error) {
- req, out := c.PutBucketReplicationRequest(input)
- return out, req.Send()
- }
- // PutBucketReplicationWithContext is the same as PutBucketReplication with the addition of
- // the ability to pass a context and additional request options.
- //
- // See PutBucketReplication 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 *S3) PutBucketReplicationWithContext(ctx aws.Context, input *PutBucketReplicationInput, opts ...request.Option) (*PutBucketReplicationOutput, error) {
- req, out := c.PutBucketReplicationRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opPutBucketRequestPayment = "PutBucketRequestPayment"
- // PutBucketRequestPaymentRequest generates a "aws/request.Request" representing the
- // client's request for the PutBucketRequestPayment 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 PutBucketRequestPayment for more information on using the PutBucketRequestPayment
- // 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 PutBucketRequestPaymentRequest method.
- // req, resp := client.PutBucketRequestPaymentRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketRequestPayment
- func (c *S3) PutBucketRequestPaymentRequest(input *PutBucketRequestPaymentInput) (req *request.Request, output *PutBucketRequestPaymentOutput) {
- op := &request.Operation{
- Name: opPutBucketRequestPayment,
- HTTPMethod: "PUT",
- HTTPPath: "/{Bucket}?requestPayment",
- }
- if input == nil {
- input = &PutBucketRequestPaymentInput{}
- }
- output = &PutBucketRequestPaymentOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Swap(restxml.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler)
- req.Handlers.Build.PushBackNamed(request.NamedHandler{
- Name: "contentMd5Handler",
- Fn: checksum.AddBodyContentMD5Handler,
- })
- return
- }
- // PutBucketRequestPayment API operation for Amazon Simple Storage Service.
- //
- // Sets the request payment configuration for a bucket. By default, the bucket
- // owner pays for downloads from the bucket. This configuration parameter enables
- // the bucket owner (only) to specify that the person requesting the download
- // will be charged for the download. For more information, see Requester Pays
- // Buckets (https://docs.aws.amazon.com/AmazonS3/latest/dev/RequesterPaysBuckets.html).
- //
- // The following operations are related to PutBucketRequestPayment:
- //
- // - CreateBucket (https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html)
- //
- // - GetBucketRequestPayment (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketRequestPayment.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation PutBucketRequestPayment for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketRequestPayment
- func (c *S3) PutBucketRequestPayment(input *PutBucketRequestPaymentInput) (*PutBucketRequestPaymentOutput, error) {
- req, out := c.PutBucketRequestPaymentRequest(input)
- return out, req.Send()
- }
- // PutBucketRequestPaymentWithContext is the same as PutBucketRequestPayment with the addition of
- // the ability to pass a context and additional request options.
- //
- // See PutBucketRequestPayment 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 *S3) PutBucketRequestPaymentWithContext(ctx aws.Context, input *PutBucketRequestPaymentInput, opts ...request.Option) (*PutBucketRequestPaymentOutput, error) {
- req, out := c.PutBucketRequestPaymentRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opPutBucketTagging = "PutBucketTagging"
- // PutBucketTaggingRequest generates a "aws/request.Request" representing the
- // client's request for the PutBucketTagging 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 PutBucketTagging for more information on using the PutBucketTagging
- // 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 PutBucketTaggingRequest method.
- // req, resp := client.PutBucketTaggingRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketTagging
- func (c *S3) PutBucketTaggingRequest(input *PutBucketTaggingInput) (req *request.Request, output *PutBucketTaggingOutput) {
- op := &request.Operation{
- Name: opPutBucketTagging,
- HTTPMethod: "PUT",
- HTTPPath: "/{Bucket}?tagging",
- }
- if input == nil {
- input = &PutBucketTaggingInput{}
- }
- output = &PutBucketTaggingOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Swap(restxml.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler)
- req.Handlers.Build.PushBackNamed(request.NamedHandler{
- Name: "contentMd5Handler",
- Fn: checksum.AddBodyContentMD5Handler,
- })
- return
- }
- // PutBucketTagging API operation for Amazon Simple Storage Service.
- //
- // Sets the tags for a bucket.
- //
- // Use tags to organize your Amazon Web Services bill to reflect your own cost
- // structure. To do this, sign up to get your Amazon Web Services account bill
- // with tag key values included. Then, to see the cost of combined resources,
- // organize your billing information according to resources with the same tag
- // key values. For example, you can tag several resources with a specific application
- // name, and then organize your billing information to see the total cost of
- // that application across several services. For more information, see Cost
- // Allocation and Tagging (https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html)
- // and Using Cost Allocation in Amazon S3 Bucket Tags (https://docs.aws.amazon.com/AmazonS3/latest/dev/CostAllocTagging.html).
- //
- // When this operation sets the tags for a bucket, it will overwrite any current
- // tags the bucket already has. You cannot use this operation to add tags to
- // an existing list of tags.
- //
- // To use this operation, you must have permissions to perform the s3:PutBucketTagging
- // action. The bucket owner has this permission by default and can grant this
- // permission to others. For more information about permissions, see Permissions
- // Related to Bucket Subresource Operations (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources)
- // and Managing Access Permissions to Your Amazon S3 Resources (https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html).
- //
- // PutBucketTagging has the following special errors:
- //
- // - Error code: InvalidTagError Description: The tag provided was not a
- // valid tag. This error can occur if the tag did not pass input validation.
- // For information about tag restrictions, see User-Defined Tag Restrictions
- // (https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/allocation-tag-restrictions.html)
- // and Amazon Web Services-Generated Cost Allocation Tag Restrictions (https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/aws-tag-restrictions.html).
- //
- // - Error code: MalformedXMLError Description: The XML provided does not
- // match the schema.
- //
- // - Error code: OperationAbortedError Description: A conflicting conditional
- // action is currently in progress against this resource. Please try again.
- //
- // - Error code: InternalError Description: The service was unable to apply
- // the provided tag to the bucket.
- //
- // The following operations are related to PutBucketTagging:
- //
- // - GetBucketTagging (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketTagging.html)
- //
- // - DeleteBucketTagging (https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketTagging.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation PutBucketTagging for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketTagging
- func (c *S3) PutBucketTagging(input *PutBucketTaggingInput) (*PutBucketTaggingOutput, error) {
- req, out := c.PutBucketTaggingRequest(input)
- return out, req.Send()
- }
- // PutBucketTaggingWithContext is the same as PutBucketTagging with the addition of
- // the ability to pass a context and additional request options.
- //
- // See PutBucketTagging 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 *S3) PutBucketTaggingWithContext(ctx aws.Context, input *PutBucketTaggingInput, opts ...request.Option) (*PutBucketTaggingOutput, error) {
- req, out := c.PutBucketTaggingRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opPutBucketVersioning = "PutBucketVersioning"
- // PutBucketVersioningRequest generates a "aws/request.Request" representing the
- // client's request for the PutBucketVersioning 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 PutBucketVersioning for more information on using the PutBucketVersioning
- // 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 PutBucketVersioningRequest method.
- // req, resp := client.PutBucketVersioningRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketVersioning
- func (c *S3) PutBucketVersioningRequest(input *PutBucketVersioningInput) (req *request.Request, output *PutBucketVersioningOutput) {
- op := &request.Operation{
- Name: opPutBucketVersioning,
- HTTPMethod: "PUT",
- HTTPPath: "/{Bucket}?versioning",
- }
- if input == nil {
- input = &PutBucketVersioningInput{}
- }
- output = &PutBucketVersioningOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Swap(restxml.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler)
- req.Handlers.Build.PushBackNamed(request.NamedHandler{
- Name: "contentMd5Handler",
- Fn: checksum.AddBodyContentMD5Handler,
- })
- return
- }
- // PutBucketVersioning API operation for Amazon Simple Storage Service.
- //
- // Sets the versioning state of an existing bucket.
- //
- // You can set the versioning state with one of the following values:
- //
- // Enabled—Enables versioning for the objects in the bucket. All objects added
- // to the bucket receive a unique version ID.
- //
- // Suspended—Disables versioning for the objects in the bucket. All objects
- // added to the bucket receive the version ID null.
- //
- // If the versioning state has never been set on a bucket, it has no versioning
- // state; a GetBucketVersioning (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketVersioning.html)
- // request does not return a versioning state value.
- //
- // In order to enable MFA Delete, you must be the bucket owner. If you are the
- // bucket owner and want to enable MFA Delete in the bucket versioning configuration,
- // you must include the x-amz-mfa request header and the Status and the MfaDelete
- // request elements in a request to set the versioning state of the bucket.
- //
- // If you have an object expiration lifecycle policy in your non-versioned bucket
- // and you want to maintain the same permanent delete behavior when you enable
- // versioning, you must add a noncurrent expiration policy. The noncurrent expiration
- // lifecycle policy will manage the deletes of the noncurrent object versions
- // in the version-enabled bucket. (A version-enabled bucket maintains one current
- // and zero or more noncurrent object versions.) For more information, see Lifecycle
- // and Versioning (https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html#lifecycle-and-other-bucket-config).
- //
- // Related Resources
- //
- // - CreateBucket (https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html)
- //
- // - DeleteBucket (https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucket.html)
- //
- // - GetBucketVersioning (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketVersioning.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation PutBucketVersioning for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketVersioning
- func (c *S3) PutBucketVersioning(input *PutBucketVersioningInput) (*PutBucketVersioningOutput, error) {
- req, out := c.PutBucketVersioningRequest(input)
- return out, req.Send()
- }
- // PutBucketVersioningWithContext is the same as PutBucketVersioning with the addition of
- // the ability to pass a context and additional request options.
- //
- // See PutBucketVersioning 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 *S3) PutBucketVersioningWithContext(ctx aws.Context, input *PutBucketVersioningInput, opts ...request.Option) (*PutBucketVersioningOutput, error) {
- req, out := c.PutBucketVersioningRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opPutBucketWebsite = "PutBucketWebsite"
- // PutBucketWebsiteRequest generates a "aws/request.Request" representing the
- // client's request for the PutBucketWebsite 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 PutBucketWebsite for more information on using the PutBucketWebsite
- // 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 PutBucketWebsiteRequest method.
- // req, resp := client.PutBucketWebsiteRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketWebsite
- func (c *S3) PutBucketWebsiteRequest(input *PutBucketWebsiteInput) (req *request.Request, output *PutBucketWebsiteOutput) {
- op := &request.Operation{
- Name: opPutBucketWebsite,
- HTTPMethod: "PUT",
- HTTPPath: "/{Bucket}?website",
- }
- if input == nil {
- input = &PutBucketWebsiteInput{}
- }
- output = &PutBucketWebsiteOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Swap(restxml.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler)
- req.Handlers.Build.PushBackNamed(request.NamedHandler{
- Name: "contentMd5Handler",
- Fn: checksum.AddBodyContentMD5Handler,
- })
- return
- }
- // PutBucketWebsite API operation for Amazon Simple Storage Service.
- //
- // Sets the configuration of the website that is specified in the website subresource.
- // To configure a bucket as a website, you can add this subresource on the bucket
- // with website configuration information such as the file name of the index
- // document and any redirect rules. For more information, see Hosting Websites
- // on Amazon S3 (https://docs.aws.amazon.com/AmazonS3/latest/dev/WebsiteHosting.html).
- //
- // This PUT action requires the S3:PutBucketWebsite permission. By default,
- // only the bucket owner can configure the website attached to a bucket; however,
- // bucket owners can allow other users to set the website configuration by writing
- // a bucket policy that grants them the S3:PutBucketWebsite permission.
- //
- // To redirect all website requests sent to the bucket's website endpoint, you
- // add a website configuration with the following elements. Because all requests
- // are sent to another website, you don't need to provide index document name
- // for the bucket.
- //
- // - WebsiteConfiguration
- //
- // - RedirectAllRequestsTo
- //
- // - HostName
- //
- // - Protocol
- //
- // If you want granular control over redirects, you can use the following elements
- // to add routing rules that describe conditions for redirecting requests and
- // information about the redirect destination. In this case, the website configuration
- // must provide an index document for the bucket, because some requests might
- // not be redirected.
- //
- // - WebsiteConfiguration
- //
- // - IndexDocument
- //
- // - Suffix
- //
- // - ErrorDocument
- //
- // - Key
- //
- // - RoutingRules
- //
- // - RoutingRule
- //
- // - Condition
- //
- // - HttpErrorCodeReturnedEquals
- //
- // - KeyPrefixEquals
- //
- // - Redirect
- //
- // - Protocol
- //
- // - HostName
- //
- // - ReplaceKeyPrefixWith
- //
- // - ReplaceKeyWith
- //
- // - HttpRedirectCode
- //
- // Amazon S3 has a limitation of 50 routing rules per website configuration.
- // If you require more than 50 routing rules, you can use object redirect. For
- // more information, see Configuring an Object Redirect (https://docs.aws.amazon.com/AmazonS3/latest/dev/how-to-page-redirect.html)
- // in the Amazon S3 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 Amazon Simple Storage Service's
- // API operation PutBucketWebsite for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketWebsite
- func (c *S3) PutBucketWebsite(input *PutBucketWebsiteInput) (*PutBucketWebsiteOutput, error) {
- req, out := c.PutBucketWebsiteRequest(input)
- return out, req.Send()
- }
- // PutBucketWebsiteWithContext is the same as PutBucketWebsite with the addition of
- // the ability to pass a context and additional request options.
- //
- // See PutBucketWebsite 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 *S3) PutBucketWebsiteWithContext(ctx aws.Context, input *PutBucketWebsiteInput, opts ...request.Option) (*PutBucketWebsiteOutput, error) {
- req, out := c.PutBucketWebsiteRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opPutObject = "PutObject"
- // PutObjectRequest generates a "aws/request.Request" representing the
- // client's request for the PutObject 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 PutObject for more information on using the PutObject
- // 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 PutObjectRequest method.
- // req, resp := client.PutObjectRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutObject
- func (c *S3) PutObjectRequest(input *PutObjectInput) (req *request.Request, output *PutObjectOutput) {
- op := &request.Operation{
- Name: opPutObject,
- HTTPMethod: "PUT",
- HTTPPath: "/{Bucket}/{Key+}",
- }
- if input == nil {
- input = &PutObjectInput{}
- }
- output = &PutObjectOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // PutObject API operation for Amazon Simple Storage Service.
- //
- // Adds an object to a bucket. You must have WRITE permissions on a bucket to
- // add an object to it.
- //
- // Amazon S3 never adds partial objects; if you receive a success response,
- // Amazon S3 added the entire object to the bucket.
- //
- // Amazon S3 is a distributed system. If it receives multiple write requests
- // for the same object simultaneously, it overwrites all but the last object
- // written. Amazon S3 does not provide object locking; if you need this, make
- // sure to build it into your application layer or use versioning instead.
- //
- // To ensure that data is not corrupted traversing the network, use the Content-MD5
- // header. When you use this header, Amazon S3 checks the object against the
- // provided MD5 value and, if they do not match, returns an error. Additionally,
- // you can calculate the MD5 while putting an object to Amazon S3 and compare
- // the returned ETag to the calculated MD5 value.
- //
- // - To successfully complete the PutObject request, you must have the s3:PutObject
- // in your IAM permissions.
- //
- // - To successfully change the objects acl of your PutObject request, you
- // must have the s3:PutObjectAcl in your IAM permissions.
- //
- // - The Content-MD5 header is required for any request to upload an object
- // with a retention period configured using Amazon S3 Object Lock. For more
- // information about Amazon S3 Object Lock, see Amazon S3 Object Lock Overview
- // (https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock-overview.html)
- // in the Amazon S3 User Guide.
- //
- // # Server-side Encryption
- //
- // You can optionally request server-side encryption. With server-side encryption,
- // Amazon S3 encrypts your data as it writes it to disks in its data centers
- // and decrypts the data when you access it. You have the option to provide
- // your own encryption key or use Amazon Web Services managed encryption keys
- // (SSE-S3 or SSE-KMS). For more information, see Using Server-Side Encryption
- // (https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html).
- //
- // If you request server-side encryption using Amazon Web Services Key Management
- // Service (SSE-KMS), you can enable an S3 Bucket Key at the object-level. For
- // more information, see Amazon S3 Bucket Keys (https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-key.html)
- // in the Amazon S3 User Guide.
- //
- // # Access Control List (ACL)-Specific Request Headers
- //
- // You can use headers to grant ACL- based permissions. By default, all objects
- // are private. Only the owner has full access control. When adding a new object,
- // you can grant permissions to individual Amazon Web Services accounts or to
- // predefined groups defined by Amazon S3. These permissions are then added
- // to the ACL on the object. For more information, see Access Control List (ACL)
- // Overview (https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html)
- // and Managing ACLs Using the REST API (https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-using-rest-api.html).
- //
- // If the bucket that you're uploading objects to uses the bucket owner enforced
- // setting for S3 Object Ownership, ACLs are disabled and no longer affect permissions.
- // Buckets that use this setting only accept PUT requests that don't specify
- // an ACL or PUT requests that specify bucket owner full control ACLs, such
- // as the bucket-owner-full-control canned ACL or an equivalent form of this
- // ACL expressed in the XML format. PUT requests that contain other ACLs (for
- // example, custom grants to certain Amazon Web Services accounts) fail and
- // return a 400 error with the error code AccessControlListNotSupported.
- //
- // For more information, see Controlling ownership of objects and disabling
- // ACLs (https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html)
- // in the Amazon S3 User Guide.
- //
- // If your bucket uses the bucket owner enforced setting for Object Ownership,
- // all objects written to the bucket by any account will be owned by the bucket
- // owner.
- //
- // # Storage Class Options
- //
- // By default, Amazon S3 uses the STANDARD Storage Class to store newly created
- // objects. The STANDARD storage class provides high durability and high availability.
- // Depending on performance needs, you can specify a different Storage Class.
- // Amazon S3 on Outposts only uses the OUTPOSTS Storage Class. For more information,
- // see Storage Classes (https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html)
- // in the Amazon S3 User Guide.
- //
- // # Versioning
- //
- // If you enable versioning for a bucket, Amazon S3 automatically generates
- // a unique version ID for the object being stored. Amazon S3 returns this ID
- // in the response. When you enable versioning for a bucket, if Amazon S3 receives
- // multiple write requests for the same object simultaneously, it stores all
- // of the objects.
- //
- // For more information about versioning, see Adding Objects to Versioning Enabled
- // Buckets (https://docs.aws.amazon.com/AmazonS3/latest/dev/AddingObjectstoVersioningEnabledBuckets.html).
- // For information about returning the versioning state of a bucket, see GetBucketVersioning
- // (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketVersioning.html).
- //
- // Related Resources
- //
- // - CopyObject (https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html)
- //
- // - DeleteObject (https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation PutObject for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutObject
- func (c *S3) PutObject(input *PutObjectInput) (*PutObjectOutput, error) {
- req, out := c.PutObjectRequest(input)
- return out, req.Send()
- }
- // PutObjectWithContext is the same as PutObject with the addition of
- // the ability to pass a context and additional request options.
- //
- // See PutObject 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 *S3) PutObjectWithContext(ctx aws.Context, input *PutObjectInput, opts ...request.Option) (*PutObjectOutput, error) {
- req, out := c.PutObjectRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opPutObjectAcl = "PutObjectAcl"
- // PutObjectAclRequest generates a "aws/request.Request" representing the
- // client's request for the PutObjectAcl 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 PutObjectAcl for more information on using the PutObjectAcl
- // 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 PutObjectAclRequest method.
- // req, resp := client.PutObjectAclRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutObjectAcl
- func (c *S3) PutObjectAclRequest(input *PutObjectAclInput) (req *request.Request, output *PutObjectAclOutput) {
- op := &request.Operation{
- Name: opPutObjectAcl,
- HTTPMethod: "PUT",
- HTTPPath: "/{Bucket}/{Key+}?acl",
- }
- if input == nil {
- input = &PutObjectAclInput{}
- }
- output = &PutObjectAclOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Build.PushBackNamed(request.NamedHandler{
- Name: "contentMd5Handler",
- Fn: checksum.AddBodyContentMD5Handler,
- })
- return
- }
- // PutObjectAcl API operation for Amazon Simple Storage Service.
- //
- // Uses the acl subresource to set the access control list (ACL) permissions
- // for a new or existing object in an S3 bucket. You must have WRITE_ACP permission
- // to set the ACL of an object. For more information, see What permissions can
- // I grant? (https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#permissions)
- // in the Amazon S3 User Guide.
- //
- // This action is not supported by Amazon S3 on Outposts.
- //
- // Depending on your application needs, you can choose to set the ACL on an
- // object using either the request body or the headers. For example, if you
- // have an existing application that updates a bucket ACL using the request
- // body, you can continue to use that approach. For more information, see Access
- // Control List (ACL) Overview (https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html)
- // in the Amazon S3 User Guide.
- //
- // If your bucket uses the bucket owner enforced setting for S3 Object Ownership,
- // ACLs are disabled and no longer affect permissions. You must use policies
- // to grant access to your bucket and the objects in it. Requests to set ACLs
- // or update ACLs fail and return the AccessControlListNotSupported error code.
- // Requests to read ACLs are still supported. For more information, see Controlling
- // object ownership (https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html)
- // in the Amazon S3 User Guide.
- //
- // # Access Permissions
- //
- // You can set access permissions using one of the following methods:
- //
- // - Specify a canned ACL with the x-amz-acl request header. Amazon S3 supports
- // a set of predefined ACLs, known as canned ACLs. Each canned ACL has a
- // predefined set of grantees and permissions. Specify the canned ACL name
- // as the value of x-amz-acl. If you use this header, you cannot use other
- // access control-specific headers in your request. For more information,
- // see Canned ACL (https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL).
- //
- // - Specify access permissions explicitly with the x-amz-grant-read, x-amz-grant-read-acp,
- // x-amz-grant-write-acp, and x-amz-grant-full-control headers. When using
- // these headers, you specify explicit access permissions and grantees (Amazon
- // Web Services accounts or Amazon S3 groups) who will receive the permission.
- // If you use these ACL-specific headers, you cannot use x-amz-acl header
- // to set a canned ACL. These parameters map to the set of permissions that
- // Amazon S3 supports in an ACL. For more information, see Access Control
- // List (ACL) Overview (https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html).
- // You specify each grantee as a type=value pair, where the type is one of
- // the following: id – if the value specified is the canonical user ID
- // of an Amazon Web Services account uri – if you are granting permissions
- // to a predefined group emailAddress – if the value specified is the email
- // address of an Amazon Web Services account Using email addresses to specify
- // a grantee is only supported in the following Amazon Web Services Regions:
- // US East (N. Virginia) US West (N. California) US West (Oregon) Asia Pacific
- // (Singapore) Asia Pacific (Sydney) Asia Pacific (Tokyo) Europe (Ireland)
- // South America (São Paulo) For a list of all the Amazon S3 supported Regions
- // and endpoints, see Regions and Endpoints (https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region)
- // in the Amazon Web Services General Reference. For example, the following
- // x-amz-grant-read header grants list objects permission to the two Amazon
- // Web Services accounts identified by their email addresses. x-amz-grant-read:
- // emailAddress="xyz@amazon.com", emailAddress="abc@amazon.com"
- //
- // You can use either a canned ACL or specify access permissions explicitly.
- // You cannot do both.
- //
- // # Grantee Values
- //
- // You can specify the person (grantee) to whom you're assigning access rights
- // (using request elements) in the following ways:
- //
- // - By the person's ID: <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- // xsi:type="CanonicalUser"><ID><>ID<></ID><DisplayName><>GranteesEmail<></DisplayName>
- // </Grantee> DisplayName is optional and ignored in the request.
- //
- // - By URI: <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- // xsi:type="Group"><URI><>http://acs.amazonaws.com/groups/global/AuthenticatedUsers<></URI></Grantee>
- //
- // - By Email address: <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- // xsi:type="AmazonCustomerByEmail"><EmailAddress><>Grantees@email.com<></EmailAddress>lt;/Grantee>
- // The grantee is resolved to the CanonicalUser and, in a response to a GET
- // Object acl request, appears as the CanonicalUser. Using email addresses
- // to specify a grantee is only supported in the following Amazon Web Services
- // Regions: US East (N. Virginia) US West (N. California) US West (Oregon)
- // Asia Pacific (Singapore) Asia Pacific (Sydney) Asia Pacific (Tokyo) Europe
- // (Ireland) South America (São Paulo) For a list of all the Amazon S3 supported
- // Regions and endpoints, see Regions and Endpoints (https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region)
- // in the Amazon Web Services General Reference.
- //
- // # Versioning
- //
- // The ACL of an object is set at the object version level. By default, PUT
- // sets the ACL of the current version of an object. To set the ACL of a different
- // version, use the versionId subresource.
- //
- // Related Resources
- //
- // - CopyObject (https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html)
- //
- // - GetObject (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation PutObjectAcl for usage and error information.
- //
- // Returned Error Codes:
- // - ErrCodeNoSuchKey "NoSuchKey"
- // The specified key does not exist.
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutObjectAcl
- func (c *S3) PutObjectAcl(input *PutObjectAclInput) (*PutObjectAclOutput, error) {
- req, out := c.PutObjectAclRequest(input)
- return out, req.Send()
- }
- // PutObjectAclWithContext is the same as PutObjectAcl with the addition of
- // the ability to pass a context and additional request options.
- //
- // See PutObjectAcl 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 *S3) PutObjectAclWithContext(ctx aws.Context, input *PutObjectAclInput, opts ...request.Option) (*PutObjectAclOutput, error) {
- req, out := c.PutObjectAclRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opPutObjectLegalHold = "PutObjectLegalHold"
- // PutObjectLegalHoldRequest generates a "aws/request.Request" representing the
- // client's request for the PutObjectLegalHold 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 PutObjectLegalHold for more information on using the PutObjectLegalHold
- // 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 PutObjectLegalHoldRequest method.
- // req, resp := client.PutObjectLegalHoldRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutObjectLegalHold
- func (c *S3) PutObjectLegalHoldRequest(input *PutObjectLegalHoldInput) (req *request.Request, output *PutObjectLegalHoldOutput) {
- op := &request.Operation{
- Name: opPutObjectLegalHold,
- HTTPMethod: "PUT",
- HTTPPath: "/{Bucket}/{Key+}?legal-hold",
- }
- if input == nil {
- input = &PutObjectLegalHoldInput{}
- }
- output = &PutObjectLegalHoldOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Build.PushBackNamed(request.NamedHandler{
- Name: "contentMd5Handler",
- Fn: checksum.AddBodyContentMD5Handler,
- })
- return
- }
- // PutObjectLegalHold API operation for Amazon Simple Storage Service.
- //
- // Applies a legal hold configuration to the specified object. For more information,
- // see Locking Objects (https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html).
- //
- // This action is not supported by Amazon S3 on Outposts.
- //
- // 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 Amazon Simple Storage Service's
- // API operation PutObjectLegalHold for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutObjectLegalHold
- func (c *S3) PutObjectLegalHold(input *PutObjectLegalHoldInput) (*PutObjectLegalHoldOutput, error) {
- req, out := c.PutObjectLegalHoldRequest(input)
- return out, req.Send()
- }
- // PutObjectLegalHoldWithContext is the same as PutObjectLegalHold with the addition of
- // the ability to pass a context and additional request options.
- //
- // See PutObjectLegalHold 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 *S3) PutObjectLegalHoldWithContext(ctx aws.Context, input *PutObjectLegalHoldInput, opts ...request.Option) (*PutObjectLegalHoldOutput, error) {
- req, out := c.PutObjectLegalHoldRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opPutObjectLockConfiguration = "PutObjectLockConfiguration"
- // PutObjectLockConfigurationRequest generates a "aws/request.Request" representing the
- // client's request for the PutObjectLockConfiguration 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 PutObjectLockConfiguration for more information on using the PutObjectLockConfiguration
- // 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 PutObjectLockConfigurationRequest method.
- // req, resp := client.PutObjectLockConfigurationRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutObjectLockConfiguration
- func (c *S3) PutObjectLockConfigurationRequest(input *PutObjectLockConfigurationInput) (req *request.Request, output *PutObjectLockConfigurationOutput) {
- op := &request.Operation{
- Name: opPutObjectLockConfiguration,
- HTTPMethod: "PUT",
- HTTPPath: "/{Bucket}?object-lock",
- }
- if input == nil {
- input = &PutObjectLockConfigurationInput{}
- }
- output = &PutObjectLockConfigurationOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Build.PushBackNamed(request.NamedHandler{
- Name: "contentMd5Handler",
- Fn: checksum.AddBodyContentMD5Handler,
- })
- return
- }
- // PutObjectLockConfiguration API operation for Amazon Simple Storage Service.
- //
- // Places an Object Lock configuration on the specified bucket. The rule specified
- // in the Object Lock configuration will be applied by default to every new
- // object placed in the specified bucket. For more information, see Locking
- // Objects (https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html).
- //
- // - The DefaultRetention settings require both a mode and a period.
- //
- // - The DefaultRetention period can be either Days or Years but you must
- // select one. You cannot specify Days and Years at the same time.
- //
- // - You can only enable Object Lock for new buckets. If you want to turn
- // on Object Lock for an existing bucket, contact Amazon Web Services Support.
- //
- // 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 Amazon Simple Storage Service's
- // API operation PutObjectLockConfiguration for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutObjectLockConfiguration
- func (c *S3) PutObjectLockConfiguration(input *PutObjectLockConfigurationInput) (*PutObjectLockConfigurationOutput, error) {
- req, out := c.PutObjectLockConfigurationRequest(input)
- return out, req.Send()
- }
- // PutObjectLockConfigurationWithContext is the same as PutObjectLockConfiguration with the addition of
- // the ability to pass a context and additional request options.
- //
- // See PutObjectLockConfiguration 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 *S3) PutObjectLockConfigurationWithContext(ctx aws.Context, input *PutObjectLockConfigurationInput, opts ...request.Option) (*PutObjectLockConfigurationOutput, error) {
- req, out := c.PutObjectLockConfigurationRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opPutObjectRetention = "PutObjectRetention"
- // PutObjectRetentionRequest generates a "aws/request.Request" representing the
- // client's request for the PutObjectRetention 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 PutObjectRetention for more information on using the PutObjectRetention
- // 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 PutObjectRetentionRequest method.
- // req, resp := client.PutObjectRetentionRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutObjectRetention
- func (c *S3) PutObjectRetentionRequest(input *PutObjectRetentionInput) (req *request.Request, output *PutObjectRetentionOutput) {
- op := &request.Operation{
- Name: opPutObjectRetention,
- HTTPMethod: "PUT",
- HTTPPath: "/{Bucket}/{Key+}?retention",
- }
- if input == nil {
- input = &PutObjectRetentionInput{}
- }
- output = &PutObjectRetentionOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Build.PushBackNamed(request.NamedHandler{
- Name: "contentMd5Handler",
- Fn: checksum.AddBodyContentMD5Handler,
- })
- return
- }
- // PutObjectRetention API operation for Amazon Simple Storage Service.
- //
- // Places an Object Retention configuration on an object. For more information,
- // see Locking Objects (https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html).
- // Users or accounts require the s3:PutObjectRetention permission in order to
- // place an Object Retention configuration on objects. Bypassing a Governance
- // Retention configuration requires the s3:BypassGovernanceRetention permission.
- //
- // This action is not supported by Amazon S3 on Outposts.
- //
- // 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 Amazon Simple Storage Service's
- // API operation PutObjectRetention for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutObjectRetention
- func (c *S3) PutObjectRetention(input *PutObjectRetentionInput) (*PutObjectRetentionOutput, error) {
- req, out := c.PutObjectRetentionRequest(input)
- return out, req.Send()
- }
- // PutObjectRetentionWithContext is the same as PutObjectRetention with the addition of
- // the ability to pass a context and additional request options.
- //
- // See PutObjectRetention 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 *S3) PutObjectRetentionWithContext(ctx aws.Context, input *PutObjectRetentionInput, opts ...request.Option) (*PutObjectRetentionOutput, error) {
- req, out := c.PutObjectRetentionRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opPutObjectTagging = "PutObjectTagging"
- // PutObjectTaggingRequest generates a "aws/request.Request" representing the
- // client's request for the PutObjectTagging 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 PutObjectTagging for more information on using the PutObjectTagging
- // 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 PutObjectTaggingRequest method.
- // req, resp := client.PutObjectTaggingRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutObjectTagging
- func (c *S3) PutObjectTaggingRequest(input *PutObjectTaggingInput) (req *request.Request, output *PutObjectTaggingOutput) {
- op := &request.Operation{
- Name: opPutObjectTagging,
- HTTPMethod: "PUT",
- HTTPPath: "/{Bucket}/{Key+}?tagging",
- }
- if input == nil {
- input = &PutObjectTaggingInput{}
- }
- output = &PutObjectTaggingOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Build.PushBackNamed(request.NamedHandler{
- Name: "contentMd5Handler",
- Fn: checksum.AddBodyContentMD5Handler,
- })
- return
- }
- // PutObjectTagging API operation for Amazon Simple Storage Service.
- //
- // Sets the supplied tag-set to an object that already exists in a bucket.
- //
- // A tag is a key-value pair. You can associate tags with an object by sending
- // a PUT request against the tagging subresource that is associated with the
- // object. You can retrieve tags by sending a GET request. For more information,
- // see GetObjectTagging (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectTagging.html).
- //
- // For tagging-related restrictions related to characters and encodings, see
- // Tag Restrictions (https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/allocation-tag-restrictions.html).
- // Note that Amazon S3 limits the maximum number of tags to 10 tags per object.
- //
- // To use this operation, you must have permission to perform the s3:PutObjectTagging
- // action. By default, the bucket owner has this permission and can grant this
- // permission to others.
- //
- // To put tags of any other version, use the versionId query parameter. You
- // also need permission for the s3:PutObjectVersionTagging action.
- //
- // For information about the Amazon S3 object tagging feature, see Object Tagging
- // (https://docs.aws.amazon.com/AmazonS3/latest/dev/object-tagging.html).
- //
- // Special Errors
- //
- // - Code: InvalidTagError Cause: The tag provided was not a valid tag. This
- // error can occur if the tag did not pass input validation. For more information,
- // see Object Tagging (https://docs.aws.amazon.com/AmazonS3/latest/dev/object-tagging.html).
- //
- // - Code: MalformedXMLError Cause: The XML provided does not match the schema.
- //
- // - Code: OperationAbortedError Cause: A conflicting conditional action
- // is currently in progress against this resource. Please try again.
- //
- // - Code: InternalError Cause: The service was unable to apply the provided
- // tag to the object.
- //
- // Related Resources
- //
- // - GetObjectTagging (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectTagging.html)
- //
- // - DeleteObjectTagging (https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObjectTagging.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation PutObjectTagging for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutObjectTagging
- func (c *S3) PutObjectTagging(input *PutObjectTaggingInput) (*PutObjectTaggingOutput, error) {
- req, out := c.PutObjectTaggingRequest(input)
- return out, req.Send()
- }
- // PutObjectTaggingWithContext is the same as PutObjectTagging with the addition of
- // the ability to pass a context and additional request options.
- //
- // See PutObjectTagging 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 *S3) PutObjectTaggingWithContext(ctx aws.Context, input *PutObjectTaggingInput, opts ...request.Option) (*PutObjectTaggingOutput, error) {
- req, out := c.PutObjectTaggingRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opPutPublicAccessBlock = "PutPublicAccessBlock"
- // PutPublicAccessBlockRequest generates a "aws/request.Request" representing the
- // client's request for the PutPublicAccessBlock 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 PutPublicAccessBlock for more information on using the PutPublicAccessBlock
- // 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 PutPublicAccessBlockRequest method.
- // req, resp := client.PutPublicAccessBlockRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutPublicAccessBlock
- func (c *S3) PutPublicAccessBlockRequest(input *PutPublicAccessBlockInput) (req *request.Request, output *PutPublicAccessBlockOutput) {
- op := &request.Operation{
- Name: opPutPublicAccessBlock,
- HTTPMethod: "PUT",
- HTTPPath: "/{Bucket}?publicAccessBlock",
- }
- if input == nil {
- input = &PutPublicAccessBlockInput{}
- }
- output = &PutPublicAccessBlockOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Swap(restxml.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler)
- req.Handlers.Build.PushBackNamed(request.NamedHandler{
- Name: "contentMd5Handler",
- Fn: checksum.AddBodyContentMD5Handler,
- })
- return
- }
- // PutPublicAccessBlock API operation for Amazon Simple Storage Service.
- //
- // Creates or modifies the PublicAccessBlock configuration for an Amazon S3
- // bucket. To use this operation, you must have the s3:PutBucketPublicAccessBlock
- // permission. For more information about Amazon S3 permissions, see Specifying
- // Permissions in a Policy (https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html).
- //
- // When Amazon S3 evaluates the PublicAccessBlock configuration for a bucket
- // or an object, it checks the PublicAccessBlock configuration for both the
- // bucket (or the bucket that contains the object) and the bucket owner's account.
- // If the PublicAccessBlock configurations are different between the bucket
- // and the account, Amazon S3 uses the most restrictive combination of the bucket-level
- // and account-level settings.
- //
- // For more information about when Amazon S3 considers a bucket or an object
- // public, see The Meaning of "Public" (https://docs.aws.amazon.com/AmazonS3/latest/dev/access-control-block-public-access.html#access-control-block-public-access-policy-status).
- //
- // Related Resources
- //
- // - GetPublicAccessBlock (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetPublicAccessBlock.html)
- //
- // - DeletePublicAccessBlock (https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeletePublicAccessBlock.html)
- //
- // - GetBucketPolicyStatus (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketPolicyStatus.html)
- //
- // - Using Amazon S3 Block Public Access (https://docs.aws.amazon.com/AmazonS3/latest/dev/access-control-block-public-access.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation PutPublicAccessBlock for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutPublicAccessBlock
- func (c *S3) PutPublicAccessBlock(input *PutPublicAccessBlockInput) (*PutPublicAccessBlockOutput, error) {
- req, out := c.PutPublicAccessBlockRequest(input)
- return out, req.Send()
- }
- // PutPublicAccessBlockWithContext is the same as PutPublicAccessBlock with the addition of
- // the ability to pass a context and additional request options.
- //
- // See PutPublicAccessBlock 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 *S3) PutPublicAccessBlockWithContext(ctx aws.Context, input *PutPublicAccessBlockInput, opts ...request.Option) (*PutPublicAccessBlockOutput, error) {
- req, out := c.PutPublicAccessBlockRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opRestoreObject = "RestoreObject"
- // RestoreObjectRequest generates a "aws/request.Request" representing the
- // client's request for the RestoreObject 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 RestoreObject for more information on using the RestoreObject
- // 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 RestoreObjectRequest method.
- // req, resp := client.RestoreObjectRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/RestoreObject
- func (c *S3) RestoreObjectRequest(input *RestoreObjectInput) (req *request.Request, output *RestoreObjectOutput) {
- op := &request.Operation{
- Name: opRestoreObject,
- HTTPMethod: "POST",
- HTTPPath: "/{Bucket}/{Key+}?restore",
- }
- if input == nil {
- input = &RestoreObjectInput{}
- }
- output = &RestoreObjectOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // RestoreObject API operation for Amazon Simple Storage Service.
- //
- // # Restores an archived copy of an object back into Amazon S3
- //
- // This action is not supported by Amazon S3 on Outposts.
- //
- // This action performs the following types of requests:
- //
- // - select - Perform a select query on an archived object
- //
- // - restore an archive - Restore an archived object
- //
- // To use this operation, you must have permissions to perform the s3:RestoreObject
- // action. The bucket owner has this permission by default and can grant this
- // permission to others. For more information about permissions, see Permissions
- // Related to Bucket Subresource Operations (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources)
- // and Managing Access Permissions to Your Amazon S3 Resources (https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html)
- // in the Amazon S3 User Guide.
- //
- // # Querying Archives with Select Requests
- //
- // You use a select type of request to perform SQL queries on archived objects.
- // The archived objects that are being queried by the select request must be
- // formatted as uncompressed comma-separated values (CSV) files. You can run
- // queries and custom analytics on your archived data without having to restore
- // your data to a hotter Amazon S3 tier. For an overview about select requests,
- // see Querying Archived Objects (https://docs.aws.amazon.com/AmazonS3/latest/dev/querying-glacier-archives.html)
- // in the Amazon S3 User Guide.
- //
- // When making a select request, do the following:
- //
- // - Define an output location for the select query's output. This must be
- // an Amazon S3 bucket in the same Amazon Web Services Region as the bucket
- // that contains the archive object that is being queried. The Amazon Web
- // Services account that initiates the job must have permissions to write
- // to the S3 bucket. You can specify the storage class and encryption for
- // the output objects stored in the bucket. For more information about output,
- // see Querying Archived Objects (https://docs.aws.amazon.com/AmazonS3/latest/dev/querying-glacier-archives.html)
- // in the Amazon S3 User Guide. For more information about the S3 structure
- // in the request body, see the following: PutObject (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html)
- // Managing Access with ACLs (https://docs.aws.amazon.com/AmazonS3/latest/dev/S3_ACLs_UsingACLs.html)
- // in the Amazon S3 User Guide Protecting Data Using Server-Side Encryption
- // (https://docs.aws.amazon.com/AmazonS3/latest/dev/serv-side-encryption.html)
- // in the Amazon S3 User Guide
- //
- // - Define the SQL expression for the SELECT type of restoration for your
- // query in the request body's SelectParameters structure. You can use expressions
- // like the following examples. The following expression returns all records
- // from the specified object. SELECT * FROM Object Assuming that you are
- // not using any headers for data stored in the object, you can specify columns
- // with positional headers. SELECT s._1, s._2 FROM Object s WHERE s._3 >
- // 100 If you have headers and you set the fileHeaderInfo in the CSV structure
- // in the request body to USE, you can specify headers in the query. (If
- // you set the fileHeaderInfo field to IGNORE, the first row is skipped for
- // the query.) You cannot mix ordinal positions with header column names.
- // SELECT s.Id, s.FirstName, s.SSN FROM S3Object s
- //
- // For more information about using SQL with S3 Glacier Select restore, see
- // SQL Reference for Amazon S3 Select and S3 Glacier Select (https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-glacier-select-sql-reference.html)
- // in the Amazon S3 User Guide.
- //
- // When making a select request, you can also do the following:
- //
- // - To expedite your queries, specify the Expedited tier. For more information
- // about tiers, see "Restoring Archives," later in this topic.
- //
- // - Specify details about the data serialization format of both the input
- // object that is being queried and the serialization of the CSV-encoded
- // query results.
- //
- // The following are additional important facts about the select feature:
- //
- // - The output results are new Amazon S3 objects. Unlike archive retrievals,
- // they are stored until explicitly deleted-manually or through a lifecycle
- // policy.
- //
- // - You can issue more than one select request on the same Amazon S3 object.
- // Amazon S3 doesn't deduplicate requests, so avoid issuing duplicate requests.
- //
- // - Amazon S3 accepts a select request even if the object has already been
- // restored. A select request doesn’t return error response 409.
- //
- // # Restoring objects
- //
- // Objects that you archive to the S3 Glacier or S3 Glacier Deep Archive storage
- // class, and S3 Intelligent-Tiering Archive or S3 Intelligent-Tiering Deep
- // Archive tiers are not accessible in real time. For objects in Archive Access
- // or Deep Archive Access tiers you must first initiate a restore request, and
- // then wait until the object is moved into the Frequent Access tier. For objects
- // in S3 Glacier or S3 Glacier Deep Archive storage classes you must first initiate
- // a restore request, and then wait until a temporary copy of the object is
- // available. To access an archived object, you must restore the object for
- // the duration (number of days) that you specify.
- //
- // To restore a specific object version, you can provide a version ID. If you
- // don't provide a version ID, Amazon S3 restores the current version.
- //
- // When restoring an archived object (or using a select request), you can specify
- // one of the following data access tier options in the Tier element of the
- // request body:
- //
- // - Expedited - Expedited retrievals allow you to quickly access your data
- // stored in the S3 Glacier storage class or S3 Intelligent-Tiering Archive
- // tier when occasional urgent requests for a subset of archives are required.
- // For all but the largest archived objects (250 MB+), data accessed using
- // Expedited retrievals is typically made available within 1–5 minutes.
- // Provisioned capacity ensures that retrieval capacity for Expedited retrievals
- // is available when you need it. Expedited retrievals and provisioned capacity
- // are not available for objects stored in the S3 Glacier Deep Archive storage
- // class or S3 Intelligent-Tiering Deep Archive tier.
- //
- // - Standard - Standard retrievals allow you to access any of your archived
- // objects within several hours. This is the default option for retrieval
- // requests that do not specify the retrieval option. Standard retrievals
- // typically finish within 3–5 hours for objects stored in the S3 Glacier
- // storage class or S3 Intelligent-Tiering Archive tier. They typically finish
- // within 12 hours for objects stored in the S3 Glacier Deep Archive storage
- // class or S3 Intelligent-Tiering Deep Archive tier. Standard retrievals
- // are free for objects stored in S3 Intelligent-Tiering.
- //
- // - Bulk - Bulk retrievals are the lowest-cost retrieval option in S3 Glacier,
- // enabling you to retrieve large amounts, even petabytes, of data inexpensively.
- // Bulk retrievals typically finish within 5–12 hours for objects stored
- // in the S3 Glacier storage class or S3 Intelligent-Tiering Archive tier.
- // They typically finish within 48 hours for objects stored in the S3 Glacier
- // Deep Archive storage class or S3 Intelligent-Tiering Deep Archive tier.
- // Bulk retrievals are free for objects stored in S3 Intelligent-Tiering.
- //
- // For more information about archive retrieval options and provisioned capacity
- // for Expedited data access, see Restoring Archived Objects (https://docs.aws.amazon.com/AmazonS3/latest/dev/restoring-objects.html)
- // in the Amazon S3 User Guide.
- //
- // You can use Amazon S3 restore speed upgrade to change the restore speed to
- // a faster speed while it is in progress. For more information, see Upgrading
- // the speed of an in-progress restore (https://docs.aws.amazon.com/AmazonS3/latest/dev/restoring-objects.html#restoring-objects-upgrade-tier.title.html)
- // in the Amazon S3 User Guide.
- //
- // To get the status of object restoration, you can send a HEAD request. Operations
- // return the x-amz-restore header, which provides information about the restoration
- // status, in the response. You can use Amazon S3 event notifications to notify
- // you when a restore is initiated or completed. For more information, see Configuring
- // Amazon S3 Event Notifications (https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html)
- // in the Amazon S3 User Guide.
- //
- // After restoring an archived object, you can update the restoration period
- // by reissuing the request with a new period. Amazon S3 updates the restoration
- // period relative to the current time and charges only for the request-there
- // are no data transfer charges. You cannot update the restoration period when
- // Amazon S3 is actively processing your current restore request for the object.
- //
- // If your bucket has a lifecycle configuration with a rule that includes an
- // expiration action, the object expiration overrides the life span that you
- // specify in a restore request. For example, if you restore an object copy
- // for 10 days, but the object is scheduled to expire in 3 days, Amazon S3 deletes
- // the object in 3 days. For more information about lifecycle configuration,
- // see PutBucketLifecycleConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html)
- // and Object Lifecycle Management (https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html)
- // in Amazon S3 User Guide.
- //
- // # Responses
- //
- // A successful action returns either the 200 OK or 202 Accepted status code.
- //
- // - If the object is not previously restored, then Amazon S3 returns 202
- // Accepted in the response.
- //
- // - If the object is previously restored, Amazon S3 returns 200 OK in the
- // response.
- //
- // Special Errors
- //
- // - Code: RestoreAlreadyInProgress Cause: Object restore is already in progress.
- // (This error does not apply to SELECT type requests.) HTTP Status Code:
- // 409 Conflict SOAP Fault Code Prefix: Client
- //
- // - Code: GlacierExpeditedRetrievalNotAvailable Cause: expedited retrievals
- // are currently not available. Try again later. (Returned if there is insufficient
- // capacity to process the Expedited request. This error applies only to
- // Expedited retrievals and not to S3 Standard or Bulk retrievals.) HTTP
- // Status Code: 503 SOAP Fault Code Prefix: N/A
- //
- // Related Resources
- //
- // - PutBucketLifecycleConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html)
- //
- // - GetBucketNotificationConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketNotificationConfiguration.html)
- //
- // - SQL Reference for Amazon S3 Select and S3 Glacier Select (https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-glacier-select-sql-reference.html)
- // in the Amazon S3 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 Amazon Simple Storage Service's
- // API operation RestoreObject for usage and error information.
- //
- // Returned Error Codes:
- // - ErrCodeObjectAlreadyInActiveTierError "ObjectAlreadyInActiveTierError"
- // This action is not allowed against this storage tier.
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/RestoreObject
- func (c *S3) RestoreObject(input *RestoreObjectInput) (*RestoreObjectOutput, error) {
- req, out := c.RestoreObjectRequest(input)
- return out, req.Send()
- }
- // RestoreObjectWithContext is the same as RestoreObject with the addition of
- // the ability to pass a context and additional request options.
- //
- // See RestoreObject 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 *S3) RestoreObjectWithContext(ctx aws.Context, input *RestoreObjectInput, opts ...request.Option) (*RestoreObjectOutput, error) {
- req, out := c.RestoreObjectRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opSelectObjectContent = "SelectObjectContent"
- // SelectObjectContentRequest generates a "aws/request.Request" representing the
- // client's request for the SelectObjectContent 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 SelectObjectContent for more information on using the SelectObjectContent
- // 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 SelectObjectContentRequest method.
- // req, resp := client.SelectObjectContentRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/SelectObjectContent
- func (c *S3) SelectObjectContentRequest(input *SelectObjectContentInput) (req *request.Request, output *SelectObjectContentOutput) {
- op := &request.Operation{
- Name: opSelectObjectContent,
- HTTPMethod: "POST",
- HTTPPath: "/{Bucket}/{Key+}?select&select-type=2",
- }
- if input == nil {
- input = &SelectObjectContentInput{}
- }
- output = &SelectObjectContentOutput{}
- req = c.newRequest(op, input, output)
- es := NewSelectObjectContentEventStream()
- req.Handlers.Unmarshal.PushBack(es.setStreamCloser)
- output.EventStream = es
- req.Handlers.Send.Swap(client.LogHTTPResponseHandler.Name, client.LogHTTPResponseHeaderHandler)
- req.Handlers.Unmarshal.Swap(restxml.UnmarshalHandler.Name, rest.UnmarshalHandler)
- req.Handlers.Unmarshal.PushBack(es.runOutputStream)
- req.Handlers.Unmarshal.PushBack(es.runOnStreamPartClose)
- return
- }
- // SelectObjectContent API operation for Amazon Simple Storage Service.
- //
- // This action filters the contents of an Amazon S3 object based on a simple
- // structured query language (SQL) statement. In the request, along with the
- // SQL expression, you must also specify a data serialization format (JSON,
- // CSV, or Apache Parquet) of the object. Amazon S3 uses this format to parse
- // object data into records, and returns only records that match the specified
- // SQL expression. You must also specify the data serialization format for the
- // response.
- //
- // This action is not supported by Amazon S3 on Outposts.
- //
- // For more information about Amazon S3 Select, see Selecting Content from Objects
- // (https://docs.aws.amazon.com/AmazonS3/latest/dev/selecting-content-from-objects.html)
- // and SELECT Command (https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-glacier-select-sql-reference-select.html)
- // in the Amazon S3 User Guide.
- //
- // For more information about using SQL with Amazon S3 Select, see SQL Reference
- // for Amazon S3 Select and S3 Glacier Select (https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-glacier-select-sql-reference.html)
- // in the Amazon S3 User Guide.
- //
- // # Permissions
- //
- // You must have s3:GetObject permission for this operation. Amazon S3 Select
- // does not support anonymous access. For more information about permissions,
- // see Specifying Permissions in a Policy (https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html)
- // in the Amazon S3 User Guide.
- //
- // # Object Data Formats
- //
- // You can use Amazon S3 Select to query objects that have the following format
- // properties:
- //
- // - CSV, JSON, and Parquet - Objects must be in CSV, JSON, or Parquet format.
- //
- // - UTF-8 - UTF-8 is the only encoding type Amazon S3 Select supports.
- //
- // - GZIP or BZIP2 - CSV and JSON files can be compressed using GZIP or BZIP2.
- // GZIP and BZIP2 are the only compression formats that Amazon S3 Select
- // supports for CSV and JSON files. Amazon S3 Select supports columnar compression
- // for Parquet using GZIP or Snappy. Amazon S3 Select does not support whole-object
- // compression for Parquet objects.
- //
- // - Server-side encryption - Amazon S3 Select supports querying objects
- // that are protected with server-side encryption. For objects that are encrypted
- // with customer-provided encryption keys (SSE-C), you must use HTTPS, and
- // you must use the headers that are documented in the GetObject (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html).
- // For more information about SSE-C, see Server-Side Encryption (Using Customer-Provided
- // Encryption Keys) (https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html)
- // in the Amazon S3 User Guide. For objects that are encrypted with Amazon
- // S3 managed encryption keys (SSE-S3) and Amazon Web Services KMS keys (SSE-KMS),
- // server-side encryption is handled transparently, so you don't need to
- // specify anything. For more information about server-side encryption, including
- // SSE-S3 and SSE-KMS, see Protecting Data Using Server-Side Encryption (https://docs.aws.amazon.com/AmazonS3/latest/dev/serv-side-encryption.html)
- // in the Amazon S3 User Guide.
- //
- // # Working with the Response Body
- //
- // Given the response size is unknown, Amazon S3 Select streams the response
- // as a series of messages and includes a Transfer-Encoding header with chunked
- // as its value in the response. For more information, see Appendix: SelectObjectContent
- // Response (https://docs.aws.amazon.com/AmazonS3/latest/API/RESTSelectObjectAppendix.html).
- //
- // # GetObject Support
- //
- // The SelectObjectContent action does not support the following GetObject functionality.
- // For more information, see GetObject (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html).
- //
- // - Range: Although you can specify a scan range for an Amazon S3 Select
- // request (see SelectObjectContentRequest - ScanRange (https://docs.aws.amazon.com/AmazonS3/latest/API/API_SelectObjectContent.html#AmazonS3-SelectObjectContent-request-ScanRange)
- // in the request parameters), you cannot specify the range of bytes of an
- // object to return.
- //
- // - GLACIER, DEEP_ARCHIVE and REDUCED_REDUNDANCY storage classes: You cannot
- // specify the GLACIER, DEEP_ARCHIVE, or REDUCED_REDUNDANCY storage classes.
- // For more information, about storage classes see Storage Classes (https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMetadata.html#storage-class-intro)
- // in the Amazon S3 User Guide.
- //
- // # Special Errors
- //
- // For a list of special errors for this operation, see List of SELECT Object
- // Content Error Codes (https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#SelectObjectContentErrorCodeList)
- //
- // Related Resources
- //
- // - GetObject (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html)
- //
- // - GetBucketLifecycleConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html)
- //
- // - PutBucketLifecycleConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation SelectObjectContent for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/SelectObjectContent
- func (c *S3) SelectObjectContent(input *SelectObjectContentInput) (*SelectObjectContentOutput, error) {
- req, out := c.SelectObjectContentRequest(input)
- return out, req.Send()
- }
- // SelectObjectContentWithContext is the same as SelectObjectContent with the addition of
- // the ability to pass a context and additional request options.
- //
- // See SelectObjectContent 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 *S3) SelectObjectContentWithContext(ctx aws.Context, input *SelectObjectContentInput, opts ...request.Option) (*SelectObjectContentOutput, error) {
- req, out := c.SelectObjectContentRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- var _ awserr.Error
- // SelectObjectContentEventStream provides the event stream handling for the SelectObjectContent.
- //
- // For testing and mocking the event stream this type should be initialized via
- // the NewSelectObjectContentEventStream constructor function. Using the functional options
- // to pass in nested mock behavior.
- type SelectObjectContentEventStream struct {
- // Reader is the EventStream reader for the SelectObjectContentEventStream
- // events. This value is automatically set by the SDK when the API call is made
- // Use this member when unit testing your code with the SDK to mock out the
- // EventStream Reader.
- //
- // Must not be nil.
- Reader SelectObjectContentEventStreamReader
- outputReader io.ReadCloser
- // StreamCloser is the io.Closer for the EventStream connection. For HTTP
- // EventStream this is the response Body. The stream will be closed when
- // the Close method of the EventStream is called.
- StreamCloser io.Closer
- done chan struct{}
- closeOnce sync.Once
- err *eventstreamapi.OnceError
- }
- // NewSelectObjectContentEventStream initializes an SelectObjectContentEventStream.
- // This function should only be used for testing and mocking the SelectObjectContentEventStream
- // stream within your application.
- //
- // The Reader member must be set before reading events from the stream.
- //
- // The StreamCloser member should be set to the underlying io.Closer,
- // (e.g. http.Response.Body), that will be closed when the stream Close method
- // is called.
- //
- // es := NewSelectObjectContentEventStream(func(o *SelectObjectContentEventStream){
- // es.Reader = myMockStreamReader
- // es.StreamCloser = myMockStreamCloser
- // })
- func NewSelectObjectContentEventStream(opts ...func(*SelectObjectContentEventStream)) *SelectObjectContentEventStream {
- es := &SelectObjectContentEventStream{
- done: make(chan struct{}),
- err: eventstreamapi.NewOnceError(),
- }
- for _, fn := range opts {
- fn(es)
- }
- return es
- }
- func (es *SelectObjectContentEventStream) setStreamCloser(r *request.Request) {
- es.StreamCloser = r.HTTPResponse.Body
- }
- func (es *SelectObjectContentEventStream) runOnStreamPartClose(r *request.Request) {
- if es.done == nil {
- return
- }
- go es.waitStreamPartClose()
- }
- func (es *SelectObjectContentEventStream) waitStreamPartClose() {
- var outputErrCh <-chan struct{}
- if v, ok := es.Reader.(interface{ ErrorSet() <-chan struct{} }); ok {
- outputErrCh = v.ErrorSet()
- }
- var outputClosedCh <-chan struct{}
- if v, ok := es.Reader.(interface{ Closed() <-chan struct{} }); ok {
- outputClosedCh = v.Closed()
- }
- select {
- case <-es.done:
- case <-outputErrCh:
- es.err.SetError(es.Reader.Err())
- es.Close()
- case <-outputClosedCh:
- if err := es.Reader.Err(); err != nil {
- es.err.SetError(es.Reader.Err())
- }
- es.Close()
- }
- }
- // Events returns a channel to read events from.
- //
- // These events are:
- //
- // - ContinuationEvent
- // - EndEvent
- // - ProgressEvent
- // - RecordsEvent
- // - StatsEvent
- // - SelectObjectContentEventStreamUnknownEvent
- func (es *SelectObjectContentEventStream) Events() <-chan SelectObjectContentEventStreamEvent {
- return es.Reader.Events()
- }
- func (es *SelectObjectContentEventStream) runOutputStream(r *request.Request) {
- var opts []func(*eventstream.Decoder)
- if r.Config.Logger != nil && r.Config.LogLevel.Matches(aws.LogDebugWithEventStreamBody) {
- opts = append(opts, eventstream.DecodeWithLogger(r.Config.Logger))
- }
- unmarshalerForEvent := unmarshalerForSelectObjectContentEventStreamEvent{
- metadata: protocol.ResponseMetadata{
- StatusCode: r.HTTPResponse.StatusCode,
- RequestID: r.RequestID,
- },
- }.UnmarshalerForEventName
- decoder := eventstream.NewDecoder(r.HTTPResponse.Body, opts...)
- eventReader := eventstreamapi.NewEventReader(decoder,
- protocol.HandlerPayloadUnmarshal{
- Unmarshalers: r.Handlers.UnmarshalStream,
- },
- unmarshalerForEvent,
- )
- es.outputReader = r.HTTPResponse.Body
- es.Reader = newReadSelectObjectContentEventStream(eventReader)
- }
- // Close closes the stream. This will also cause the stream to be closed.
- // Close must be called when done using the stream API. Not calling Close
- // may result in resource leaks.
- //
- // You can use the closing of the Reader's Events channel to terminate your
- // application's read from the API's stream.
- func (es *SelectObjectContentEventStream) Close() (err error) {
- es.closeOnce.Do(es.safeClose)
- return es.Err()
- }
- func (es *SelectObjectContentEventStream) safeClose() {
- if es.done != nil {
- close(es.done)
- }
- es.Reader.Close()
- if es.outputReader != nil {
- es.outputReader.Close()
- }
- es.StreamCloser.Close()
- }
- // Err returns any error that occurred while reading or writing EventStream
- // Events from the service API's response. Returns nil if there were no errors.
- func (es *SelectObjectContentEventStream) Err() error {
- if err := es.err.Err(); err != nil {
- return err
- }
- if err := es.Reader.Err(); err != nil {
- return err
- }
- return nil
- }
- const opUploadPart = "UploadPart"
- // UploadPartRequest generates a "aws/request.Request" representing the
- // client's request for the UploadPart 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 UploadPart for more information on using the UploadPart
- // 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 UploadPartRequest method.
- // req, resp := client.UploadPartRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/UploadPart
- func (c *S3) UploadPartRequest(input *UploadPartInput) (req *request.Request, output *UploadPartOutput) {
- op := &request.Operation{
- Name: opUploadPart,
- HTTPMethod: "PUT",
- HTTPPath: "/{Bucket}/{Key+}",
- }
- if input == nil {
- input = &UploadPartInput{}
- }
- output = &UploadPartOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // UploadPart API operation for Amazon Simple Storage Service.
- //
- // Uploads a part in a multipart upload.
- //
- // In this operation, you provide part data in your request. However, you have
- // an option to specify your existing Amazon S3 object as a data source for
- // the part you are uploading. To upload a part from an existing object, you
- // use the UploadPartCopy (https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html)
- // operation.
- //
- // You must initiate a multipart upload (see CreateMultipartUpload (https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html))
- // before you can upload any part. In response to your initiate request, Amazon
- // S3 returns an upload ID, a unique identifier, that you must include in your
- // upload part request.
- //
- // Part numbers can be any number from 1 to 10,000, inclusive. A part number
- // uniquely identifies a part and also defines its position within the object
- // being created. If you upload a new part using the same part number that was
- // used with a previous part, the previously uploaded part is overwritten.
- //
- // For information about maximum and minimum part sizes and other multipart
- // upload specifications, see Multipart upload limits (https://docs.aws.amazon.com/AmazonS3/latest/userguide/qfacts.html)
- // in the Amazon S3 User Guide.
- //
- // To ensure that data is not corrupted when traversing the network, specify
- // the Content-MD5 header in the upload part request. Amazon S3 checks the part
- // data against the provided MD5 value. If they do not match, Amazon S3 returns
- // an error.
- //
- // If the upload request is signed with Signature Version 4, then Amazon Web
- // Services S3 uses the x-amz-content-sha256 header as a checksum instead of
- // Content-MD5. For more information see Authenticating Requests: Using the
- // Authorization Header (Amazon Web Services Signature Version 4) (https://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-auth-using-authorization-header.html).
- //
- // Note: After you initiate multipart upload and upload one or more parts, you
- // must either complete or abort multipart upload in order to stop getting charged
- // for storage of the uploaded parts. Only after you either complete or abort
- // multipart upload, Amazon S3 frees up the parts storage and stops charging
- // you for the parts storage.
- //
- // For more information on multipart uploads, go to Multipart Upload Overview
- // (https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html) in the
- // Amazon S3 User Guide .
- //
- // For information on the permissions required to use the multipart upload API,
- // go to Multipart Upload and Permissions (https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html)
- // in the Amazon S3 User Guide.
- //
- // You can optionally request server-side encryption where Amazon S3 encrypts
- // your data as it writes it to disks in its data centers and decrypts it for
- // you when you access it. You have the option of providing your own encryption
- // key, or you can use the Amazon Web Services managed encryption keys. If you
- // choose to provide your own encryption key, the request headers you provide
- // in the request must match the headers you used in the request to initiate
- // the upload by using CreateMultipartUpload (https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html).
- // For more information, go to Using Server-Side Encryption (https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html)
- // in the Amazon S3 User Guide.
- //
- // Server-side encryption is supported by the S3 Multipart Upload actions. Unless
- // you are using a customer-provided encryption key, you don't need to specify
- // the encryption parameters in each UploadPart request. Instead, you only need
- // to specify the server-side encryption parameters in the initial Initiate
- // Multipart request. For more information, see CreateMultipartUpload (https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html).
- //
- // If you requested server-side encryption using a customer-provided encryption
- // key in your initiate multipart upload request, you must provide identical
- // encryption information in each part upload using the following headers.
- //
- // - x-amz-server-side-encryption-customer-algorithm
- //
- // - x-amz-server-side-encryption-customer-key
- //
- // - x-amz-server-side-encryption-customer-key-MD5
- //
- // Special Errors
- //
- // - Code: NoSuchUpload Cause: The specified multipart upload does not exist.
- // The upload ID might be invalid, or the multipart upload might have been
- // aborted or completed. HTTP Status Code: 404 Not Found SOAP Fault Code
- // Prefix: Client
- //
- // Related Resources
- //
- // - CreateMultipartUpload (https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html)
- //
- // - CompleteMultipartUpload (https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html)
- //
- // - AbortMultipartUpload (https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html)
- //
- // - ListParts (https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html)
- //
- // - ListMultipartUploads (https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation UploadPart for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/UploadPart
- func (c *S3) UploadPart(input *UploadPartInput) (*UploadPartOutput, error) {
- req, out := c.UploadPartRequest(input)
- return out, req.Send()
- }
- // UploadPartWithContext is the same as UploadPart with the addition of
- // the ability to pass a context and additional request options.
- //
- // See UploadPart 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 *S3) UploadPartWithContext(ctx aws.Context, input *UploadPartInput, opts ...request.Option) (*UploadPartOutput, error) {
- req, out := c.UploadPartRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opUploadPartCopy = "UploadPartCopy"
- // UploadPartCopyRequest generates a "aws/request.Request" representing the
- // client's request for the UploadPartCopy 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 UploadPartCopy for more information on using the UploadPartCopy
- // 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 UploadPartCopyRequest method.
- // req, resp := client.UploadPartCopyRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/UploadPartCopy
- func (c *S3) UploadPartCopyRequest(input *UploadPartCopyInput) (req *request.Request, output *UploadPartCopyOutput) {
- op := &request.Operation{
- Name: opUploadPartCopy,
- HTTPMethod: "PUT",
- HTTPPath: "/{Bucket}/{Key+}",
- }
- if input == nil {
- input = &UploadPartCopyInput{}
- }
- output = &UploadPartCopyOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // UploadPartCopy API operation for Amazon Simple Storage Service.
- //
- // Uploads a part by copying data from an existing object as data source. You
- // specify the data source by adding the request header x-amz-copy-source in
- // your request and a byte range by adding the request header x-amz-copy-source-range
- // in your request.
- //
- // For information about maximum and minimum part sizes and other multipart
- // upload specifications, see Multipart upload limits (https://docs.aws.amazon.com/AmazonS3/latest/userguide/qfacts.html)
- // in the Amazon S3 User Guide.
- //
- // Instead of using an existing object as part data, you might use the UploadPart
- // (https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html) action
- // and provide data in your request.
- //
- // You must initiate a multipart upload before you can upload any part. In response
- // to your initiate request. Amazon S3 returns a unique identifier, the upload
- // ID, that you must include in your upload part request.
- //
- // For more information about using the UploadPartCopy operation, see the following:
- //
- // - For conceptual information about multipart uploads, see Uploading Objects
- // Using Multipart Upload (https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html)
- // in the Amazon S3 User Guide.
- //
- // - For information about permissions required to use the multipart upload
- // API, see Multipart Upload and Permissions (https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html)
- // in the Amazon S3 User Guide.
- //
- // - For information about copying objects using a single atomic action vs.
- // a multipart upload, see Operations on Objects (https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectOperations.html)
- // in the Amazon S3 User Guide.
- //
- // - For information about using server-side encryption with customer-provided
- // encryption keys with the UploadPartCopy operation, see CopyObject (https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html)
- // and UploadPart (https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html).
- //
- // Note the following additional considerations about the request headers x-amz-copy-source-if-match,
- // x-amz-copy-source-if-none-match, x-amz-copy-source-if-unmodified-since, and
- // x-amz-copy-source-if-modified-since:
- //
- // - Consideration 1 - If both of the x-amz-copy-source-if-match and x-amz-copy-source-if-unmodified-since
- // headers are present in the request as follows: x-amz-copy-source-if-match
- // condition evaluates to true, and; x-amz-copy-source-if-unmodified-since
- // condition evaluates to false; Amazon S3 returns 200 OK and copies the
- // data.
- //
- // - Consideration 2 - If both of the x-amz-copy-source-if-none-match and
- // x-amz-copy-source-if-modified-since headers are present in the request
- // as follows: x-amz-copy-source-if-none-match condition evaluates to false,
- // and; x-amz-copy-source-if-modified-since condition evaluates to true;
- // Amazon S3 returns 412 Precondition Failed response code.
- //
- // # Versioning
- //
- // If your bucket has versioning enabled, you could have multiple versions of
- // the same object. By default, x-amz-copy-source identifies the current version
- // of the object to copy. If the current version is a delete marker and you
- // don't specify a versionId in the x-amz-copy-source, Amazon S3 returns a 404
- // error, because the object does not exist. If you specify versionId in the
- // x-amz-copy-source and the versionId is a delete marker, Amazon S3 returns
- // an HTTP 400 error, because you are not allowed to specify a delete marker
- // as a version for the x-amz-copy-source.
- //
- // You can optionally specify a specific version of the source object to copy
- // by adding the versionId subresource as shown in the following example:
- //
- // x-amz-copy-source: /bucket/object?versionId=version id
- //
- // Special Errors
- //
- // - Code: NoSuchUpload Cause: The specified multipart upload does not exist.
- // The upload ID might be invalid, or the multipart upload might have been
- // aborted or completed. HTTP Status Code: 404 Not Found
- //
- // - Code: InvalidRequest Cause: The specified copy source is not supported
- // as a byte-range copy source. HTTP Status Code: 400 Bad Request
- //
- // Related Resources
- //
- // - CreateMultipartUpload (https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html)
- //
- // - UploadPart (https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html)
- //
- // - CompleteMultipartUpload (https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html)
- //
- // - AbortMultipartUpload (https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html)
- //
- // - ListParts (https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html)
- //
- // - ListMultipartUploads (https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html)
- //
- // 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 Amazon Simple Storage Service's
- // API operation UploadPartCopy for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/UploadPartCopy
- func (c *S3) UploadPartCopy(input *UploadPartCopyInput) (*UploadPartCopyOutput, error) {
- req, out := c.UploadPartCopyRequest(input)
- return out, req.Send()
- }
- // UploadPartCopyWithContext is the same as UploadPartCopy with the addition of
- // the ability to pass a context and additional request options.
- //
- // See UploadPartCopy 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 *S3) UploadPartCopyWithContext(ctx aws.Context, input *UploadPartCopyInput, opts ...request.Option) (*UploadPartCopyOutput, error) {
- req, out := c.UploadPartCopyRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opWriteGetObjectResponse = "WriteGetObjectResponse"
- // WriteGetObjectResponseRequest generates a "aws/request.Request" representing the
- // client's request for the WriteGetObjectResponse 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 WriteGetObjectResponse for more information on using the WriteGetObjectResponse
- // 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 WriteGetObjectResponseRequest method.
- // req, resp := client.WriteGetObjectResponseRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/WriteGetObjectResponse
- func (c *S3) WriteGetObjectResponseRequest(input *WriteGetObjectResponseInput) (req *request.Request, output *WriteGetObjectResponseOutput) {
- op := &request.Operation{
- Name: opWriteGetObjectResponse,
- HTTPMethod: "POST",
- HTTPPath: "/WriteGetObjectResponse",
- }
- if input == nil {
- input = &WriteGetObjectResponseInput{}
- }
- output = &WriteGetObjectResponseOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Sign.Remove(v4.SignRequestHandler)
- handler := v4.BuildNamedHandler("v4.CustomSignerHandler", v4.WithUnsignedPayload)
- req.Handlers.Sign.PushFrontNamed(handler)
- req.Handlers.Unmarshal.Swap(restxml.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler)
- req.Handlers.Build.PushBackNamed(protocol.NewHostPrefixHandler("{RequestRoute}.", input.hostLabels))
- req.Handlers.Build.PushBackNamed(protocol.ValidateEndpointHostHandler)
- return
- }
- // WriteGetObjectResponse API operation for Amazon Simple Storage Service.
- //
- // Passes transformed objects to a GetObject operation when using Object Lambda
- // access points. For information about Object Lambda access points, see Transforming
- // objects with Object Lambda access points (https://docs.aws.amazon.com/AmazonS3/latest/userguide/transforming-objects.html)
- // in the Amazon S3 User Guide.
- //
- // This operation supports metadata that can be returned by GetObject (https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html),
- // in addition to RequestRoute, RequestToken, StatusCode, ErrorCode, and ErrorMessage.
- // The GetObject response metadata is supported so that the WriteGetObjectResponse
- // caller, typically an Lambda function, can provide the same metadata when
- // it internally invokes GetObject. When WriteGetObjectResponse is called by
- // a customer-owned Lambda function, the metadata returned to the end user GetObject
- // call might differ from what Amazon S3 would normally return.
- //
- // You can include any number of metadata headers. When including a metadata
- // header, it should be prefaced with x-amz-meta. For example, x-amz-meta-my-custom-header:
- // MyCustomValue. The primary use case for this is to forward GetObject metadata.
- //
- // Amazon Web Services provides some prebuilt Lambda functions that you can
- // use with S3 Object Lambda to detect and redact personally identifiable information
- // (PII) and decompress S3 objects. These Lambda functions are available in
- // the Amazon Web Services Serverless Application Repository, and can be selected
- // through the Amazon Web Services Management Console when you create your Object
- // Lambda access point.
- //
- // Example 1: PII Access Control - This Lambda function uses Amazon Comprehend,
- // a natural language processing (NLP) service using machine learning to find
- // insights and relationships in text. It automatically detects personally identifiable
- // information (PII) such as names, addresses, dates, credit card numbers, and
- // social security numbers from documents in your Amazon S3 bucket.
- //
- // Example 2: PII Redaction - This Lambda function uses Amazon Comprehend, a
- // natural language processing (NLP) service using machine learning to find
- // insights and relationships in text. It automatically redacts personally identifiable
- // information (PII) such as names, addresses, dates, credit card numbers, and
- // social security numbers from documents in your Amazon S3 bucket.
- //
- // Example 3: Decompression - The Lambda function S3ObjectLambdaDecompression,
- // is equipped to decompress objects stored in S3 in one of six compressed file
- // formats including bzip2, gzip, snappy, zlib, zstandard and ZIP.
- //
- // For information on how to view and use these functions, see Using Amazon
- // Web Services built Lambda functions (https://docs.aws.amazon.com/AmazonS3/latest/userguide/olap-examples.html)
- // in the Amazon S3 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 Amazon Simple Storage Service's
- // API operation WriteGetObjectResponse for usage and error information.
- // See also, https://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/WriteGetObjectResponse
- func (c *S3) WriteGetObjectResponse(input *WriteGetObjectResponseInput) (*WriteGetObjectResponseOutput, error) {
- req, out := c.WriteGetObjectResponseRequest(input)
- return out, req.Send()
- }
- // WriteGetObjectResponseWithContext is the same as WriteGetObjectResponse with the addition of
- // the ability to pass a context and additional request options.
- //
- // See WriteGetObjectResponse 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 *S3) WriteGetObjectResponseWithContext(ctx aws.Context, input *WriteGetObjectResponseInput, opts ...request.Option) (*WriteGetObjectResponseOutput, error) {
- req, out := c.WriteGetObjectResponseRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- // Specifies the days since the initiation of an incomplete multipart upload
- // that Amazon S3 will wait before permanently removing all parts of the upload.
- // For more information, see Aborting Incomplete Multipart Uploads Using a Bucket
- // Lifecycle Policy (https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html#mpu-abort-incomplete-mpu-lifecycle-config)
- // in the Amazon S3 User Guide.
- type AbortIncompleteMultipartUpload struct {
- _ struct{} `type:"structure"`
- // Specifies the number of days after which Amazon S3 aborts an incomplete multipart
- // upload.
- DaysAfterInitiation *int64 `type:"integer"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s AbortIncompleteMultipartUpload) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s AbortIncompleteMultipartUpload) GoString() string {
- return s.String()
- }
- // SetDaysAfterInitiation sets the DaysAfterInitiation field's value.
- func (s *AbortIncompleteMultipartUpload) SetDaysAfterInitiation(v int64) *AbortIncompleteMultipartUpload {
- s.DaysAfterInitiation = &v
- return s
- }
- type AbortMultipartUploadInput struct {
- _ struct{} `locationName:"AbortMultipartUploadRequest" type:"structure"`
- // The bucket name to which the upload was taking place.
- //
- // When using this action with an access point, you must direct requests to
- // the access point hostname. The access point hostname takes the form AccessPointName-AccountId.s3-accesspoint.Region.amazonaws.com.
- // When using this action with an access point through the Amazon Web Services
- // SDKs, you provide the access point ARN in place of the bucket name. For more
- // information about access point ARNs, see Using access points (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html)
- // in the Amazon S3 User Guide.
- //
- // When using this action with Amazon S3 on Outposts, you must direct requests
- // to the S3 on Outposts hostname. The S3 on Outposts hostname takes the form
- // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When
- // using this action with S3 on Outposts through the Amazon Web Services SDKs,
- // you provide the Outposts bucket ARN in place of the bucket name. For more
- // information about S3 on Outposts ARNs, see Using Amazon S3 on Outposts (https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html)
- // in the Amazon S3 User Guide.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // Key of the object for which the multipart upload was initiated.
- //
- // Key is a required field
- Key *string `location:"uri" locationName:"Key" min:"1" type:"string" required:"true"`
- // Confirms that the requester knows that they will be charged for the request.
- // Bucket owners need not specify this parameter in their requests. For information
- // about downloading objects from Requester Pays buckets, see Downloading Objects
- // in Requester Pays Buckets (https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html)
- // in the Amazon S3 User Guide.
- RequestPayer *string `location:"header" locationName:"x-amz-request-payer" type:"string" enum:"RequestPayer"`
- // Upload ID that identifies the multipart upload.
- //
- // UploadId is a required field
- UploadId *string `location:"querystring" locationName:"uploadId" type:"string" required:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s AbortMultipartUploadInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s AbortMultipartUploadInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *AbortMultipartUploadInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "AbortMultipartUploadInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.Key == nil {
- invalidParams.Add(request.NewErrParamRequired("Key"))
- }
- if s.Key != nil && len(*s.Key) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Key", 1))
- }
- if s.UploadId == nil {
- invalidParams.Add(request.NewErrParamRequired("UploadId"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *AbortMultipartUploadInput) SetBucket(v string) *AbortMultipartUploadInput {
- s.Bucket = &v
- return s
- }
- func (s *AbortMultipartUploadInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *AbortMultipartUploadInput) SetExpectedBucketOwner(v string) *AbortMultipartUploadInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetKey sets the Key field's value.
- func (s *AbortMultipartUploadInput) SetKey(v string) *AbortMultipartUploadInput {
- s.Key = &v
- return s
- }
- // SetRequestPayer sets the RequestPayer field's value.
- func (s *AbortMultipartUploadInput) SetRequestPayer(v string) *AbortMultipartUploadInput {
- s.RequestPayer = &v
- return s
- }
- // SetUploadId sets the UploadId field's value.
- func (s *AbortMultipartUploadInput) SetUploadId(v string) *AbortMultipartUploadInput {
- s.UploadId = &v
- return s
- }
- func (s *AbortMultipartUploadInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *AbortMultipartUploadInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s AbortMultipartUploadInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type AbortMultipartUploadOutput struct {
- _ struct{} `type:"structure"`
- // If present, indicates that the requester was successfully charged for the
- // request.
- RequestCharged *string `location:"header" locationName:"x-amz-request-charged" type:"string" enum:"RequestCharged"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s AbortMultipartUploadOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s AbortMultipartUploadOutput) GoString() string {
- return s.String()
- }
- // SetRequestCharged sets the RequestCharged field's value.
- func (s *AbortMultipartUploadOutput) SetRequestCharged(v string) *AbortMultipartUploadOutput {
- s.RequestCharged = &v
- return s
- }
- // Configures the transfer acceleration state for an Amazon S3 bucket. For more
- // information, see Amazon S3 Transfer Acceleration (https://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration.html)
- // in the Amazon S3 User Guide.
- type AccelerateConfiguration struct {
- _ struct{} `type:"structure"`
- // Specifies the transfer acceleration status of the bucket.
- Status *string `type:"string" enum:"BucketAccelerateStatus"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s AccelerateConfiguration) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s AccelerateConfiguration) GoString() string {
- return s.String()
- }
- // SetStatus sets the Status field's value.
- func (s *AccelerateConfiguration) SetStatus(v string) *AccelerateConfiguration {
- s.Status = &v
- return s
- }
- // Contains the elements that set the ACL permissions for an object per grantee.
- type AccessControlPolicy struct {
- _ struct{} `type:"structure"`
- // A list of grants.
- Grants []*Grant `locationName:"AccessControlList" locationNameList:"Grant" type:"list"`
- // Container for the bucket owner's display name and ID.
- Owner *Owner `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s AccessControlPolicy) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s AccessControlPolicy) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *AccessControlPolicy) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "AccessControlPolicy"}
- if s.Grants != nil {
- for i, v := range s.Grants {
- if v == nil {
- continue
- }
- if err := v.Validate(); err != nil {
- invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Grants", i), err.(request.ErrInvalidParams))
- }
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetGrants sets the Grants field's value.
- func (s *AccessControlPolicy) SetGrants(v []*Grant) *AccessControlPolicy {
- s.Grants = v
- return s
- }
- // SetOwner sets the Owner field's value.
- func (s *AccessControlPolicy) SetOwner(v *Owner) *AccessControlPolicy {
- s.Owner = v
- return s
- }
- // A container for information about access control for replicas.
- type AccessControlTranslation struct {
- _ struct{} `type:"structure"`
- // Specifies the replica ownership. For default and valid values, see PUT bucket
- // replication (https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTreplication.html)
- // in the Amazon S3 API Reference.
- //
- // Owner is a required field
- Owner *string `type:"string" required:"true" enum:"OwnerOverride"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s AccessControlTranslation) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s AccessControlTranslation) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *AccessControlTranslation) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "AccessControlTranslation"}
- if s.Owner == nil {
- invalidParams.Add(request.NewErrParamRequired("Owner"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetOwner sets the Owner field's value.
- func (s *AccessControlTranslation) SetOwner(v string) *AccessControlTranslation {
- s.Owner = &v
- return s
- }
- // A conjunction (logical AND) of predicates, which is used in evaluating a
- // metrics filter. The operator must have at least two predicates in any combination,
- // and an object must match all of the predicates for the filter to apply.
- type AnalyticsAndOperator struct {
- _ struct{} `type:"structure"`
- // The prefix to use when evaluating an AND predicate: The prefix that an object
- // must have to be included in the metrics results.
- Prefix *string `type:"string"`
- // The list of tags to use when evaluating an AND predicate.
- Tags []*Tag `locationName:"Tag" locationNameList:"Tag" type:"list" flattened:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s AnalyticsAndOperator) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s AnalyticsAndOperator) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *AnalyticsAndOperator) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "AnalyticsAndOperator"}
- 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
- }
- // SetPrefix sets the Prefix field's value.
- func (s *AnalyticsAndOperator) SetPrefix(v string) *AnalyticsAndOperator {
- s.Prefix = &v
- return s
- }
- // SetTags sets the Tags field's value.
- func (s *AnalyticsAndOperator) SetTags(v []*Tag) *AnalyticsAndOperator {
- s.Tags = v
- return s
- }
- // Specifies the configuration and any analyses for the analytics filter of
- // an Amazon S3 bucket.
- type AnalyticsConfiguration struct {
- _ struct{} `type:"structure"`
- // The filter used to describe a set of objects for analyses. A filter must
- // have exactly one prefix, one tag, or one conjunction (AnalyticsAndOperator).
- // If no filter is provided, all objects will be considered in any analysis.
- Filter *AnalyticsFilter `type:"structure"`
- // The ID that identifies the analytics configuration.
- //
- // Id is a required field
- Id *string `type:"string" required:"true"`
- // Contains data related to access patterns to be collected and made available
- // to analyze the tradeoffs between different storage classes.
- //
- // StorageClassAnalysis is a required field
- StorageClassAnalysis *StorageClassAnalysis `type:"structure" required:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s AnalyticsConfiguration) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s AnalyticsConfiguration) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *AnalyticsConfiguration) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "AnalyticsConfiguration"}
- if s.Id == nil {
- invalidParams.Add(request.NewErrParamRequired("Id"))
- }
- if s.StorageClassAnalysis == nil {
- invalidParams.Add(request.NewErrParamRequired("StorageClassAnalysis"))
- }
- if s.Filter != nil {
- if err := s.Filter.Validate(); err != nil {
- invalidParams.AddNested("Filter", err.(request.ErrInvalidParams))
- }
- }
- if s.StorageClassAnalysis != nil {
- if err := s.StorageClassAnalysis.Validate(); err != nil {
- invalidParams.AddNested("StorageClassAnalysis", err.(request.ErrInvalidParams))
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetFilter sets the Filter field's value.
- func (s *AnalyticsConfiguration) SetFilter(v *AnalyticsFilter) *AnalyticsConfiguration {
- s.Filter = v
- return s
- }
- // SetId sets the Id field's value.
- func (s *AnalyticsConfiguration) SetId(v string) *AnalyticsConfiguration {
- s.Id = &v
- return s
- }
- // SetStorageClassAnalysis sets the StorageClassAnalysis field's value.
- func (s *AnalyticsConfiguration) SetStorageClassAnalysis(v *StorageClassAnalysis) *AnalyticsConfiguration {
- s.StorageClassAnalysis = v
- return s
- }
- // Where to publish the analytics results.
- type AnalyticsExportDestination struct {
- _ struct{} `type:"structure"`
- // A destination signifying output to an S3 bucket.
- //
- // S3BucketDestination is a required field
- S3BucketDestination *AnalyticsS3BucketDestination `type:"structure" required:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s AnalyticsExportDestination) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s AnalyticsExportDestination) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *AnalyticsExportDestination) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "AnalyticsExportDestination"}
- if s.S3BucketDestination == nil {
- invalidParams.Add(request.NewErrParamRequired("S3BucketDestination"))
- }
- if s.S3BucketDestination != nil {
- if err := s.S3BucketDestination.Validate(); err != nil {
- invalidParams.AddNested("S3BucketDestination", err.(request.ErrInvalidParams))
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetS3BucketDestination sets the S3BucketDestination field's value.
- func (s *AnalyticsExportDestination) SetS3BucketDestination(v *AnalyticsS3BucketDestination) *AnalyticsExportDestination {
- s.S3BucketDestination = v
- return s
- }
- // The filter used to describe a set of objects for analyses. A filter must
- // have exactly one prefix, one tag, or one conjunction (AnalyticsAndOperator).
- // If no filter is provided, all objects will be considered in any analysis.
- type AnalyticsFilter struct {
- _ struct{} `type:"structure"`
- // A conjunction (logical AND) of predicates, which is used in evaluating an
- // analytics filter. The operator must have at least two predicates.
- And *AnalyticsAndOperator `type:"structure"`
- // The prefix to use when evaluating an analytics filter.
- Prefix *string `type:"string"`
- // The tag to use when evaluating an analytics filter.
- Tag *Tag `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s AnalyticsFilter) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s AnalyticsFilter) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *AnalyticsFilter) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "AnalyticsFilter"}
- if s.And != nil {
- if err := s.And.Validate(); err != nil {
- invalidParams.AddNested("And", err.(request.ErrInvalidParams))
- }
- }
- if s.Tag != nil {
- if err := s.Tag.Validate(); err != nil {
- invalidParams.AddNested("Tag", err.(request.ErrInvalidParams))
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetAnd sets the And field's value.
- func (s *AnalyticsFilter) SetAnd(v *AnalyticsAndOperator) *AnalyticsFilter {
- s.And = v
- return s
- }
- // SetPrefix sets the Prefix field's value.
- func (s *AnalyticsFilter) SetPrefix(v string) *AnalyticsFilter {
- s.Prefix = &v
- return s
- }
- // SetTag sets the Tag field's value.
- func (s *AnalyticsFilter) SetTag(v *Tag) *AnalyticsFilter {
- s.Tag = v
- return s
- }
- // Contains information about where to publish the analytics results.
- type AnalyticsS3BucketDestination struct {
- _ struct{} `type:"structure"`
- // The Amazon Resource Name (ARN) of the bucket to which data is exported.
- //
- // Bucket is a required field
- Bucket *string `type:"string" required:"true"`
- // The account ID that owns the destination S3 bucket. If no account ID is provided,
- // the owner is not validated before exporting data.
- //
- // Although this value is optional, we strongly recommend that you set it to
- // help prevent problems if the destination bucket ownership changes.
- BucketAccountId *string `type:"string"`
- // Specifies the file format used when exporting data to Amazon S3.
- //
- // Format is a required field
- Format *string `type:"string" required:"true" enum:"AnalyticsS3ExportFileFormat"`
- // The prefix to use when exporting data. The prefix is prepended to all results.
- Prefix *string `type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s AnalyticsS3BucketDestination) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s AnalyticsS3BucketDestination) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *AnalyticsS3BucketDestination) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "AnalyticsS3BucketDestination"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Format == nil {
- invalidParams.Add(request.NewErrParamRequired("Format"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *AnalyticsS3BucketDestination) SetBucket(v string) *AnalyticsS3BucketDestination {
- s.Bucket = &v
- return s
- }
- func (s *AnalyticsS3BucketDestination) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetBucketAccountId sets the BucketAccountId field's value.
- func (s *AnalyticsS3BucketDestination) SetBucketAccountId(v string) *AnalyticsS3BucketDestination {
- s.BucketAccountId = &v
- return s
- }
- // SetFormat sets the Format field's value.
- func (s *AnalyticsS3BucketDestination) SetFormat(v string) *AnalyticsS3BucketDestination {
- s.Format = &v
- return s
- }
- // SetPrefix sets the Prefix field's value.
- func (s *AnalyticsS3BucketDestination) SetPrefix(v string) *AnalyticsS3BucketDestination {
- s.Prefix = &v
- return s
- }
- // In terms of implementation, a Bucket is a resource. An Amazon S3 bucket name
- // is globally unique, and the namespace is shared by all Amazon Web Services
- // accounts.
- type Bucket struct {
- _ struct{} `type:"structure"`
- // Date the bucket was created. This date can change when making changes to
- // your bucket, such as editing its bucket policy.
- CreationDate *time.Time `type:"timestamp"`
- // The name of the bucket.
- Name *string `type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s Bucket) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s Bucket) GoString() string {
- return s.String()
- }
- // SetCreationDate sets the CreationDate field's value.
- func (s *Bucket) SetCreationDate(v time.Time) *Bucket {
- s.CreationDate = &v
- return s
- }
- // SetName sets the Name field's value.
- func (s *Bucket) SetName(v string) *Bucket {
- s.Name = &v
- return s
- }
- // Specifies the lifecycle configuration for objects in an Amazon S3 bucket.
- // For more information, see Object Lifecycle Management (https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html)
- // in the Amazon S3 User Guide.
- type BucketLifecycleConfiguration struct {
- _ struct{} `type:"structure"`
- // A lifecycle rule for individual objects in an Amazon S3 bucket.
- //
- // Rules is a required field
- Rules []*LifecycleRule `locationName:"Rule" type:"list" flattened:"true" required:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s BucketLifecycleConfiguration) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s BucketLifecycleConfiguration) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *BucketLifecycleConfiguration) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "BucketLifecycleConfiguration"}
- if s.Rules == nil {
- invalidParams.Add(request.NewErrParamRequired("Rules"))
- }
- if s.Rules != nil {
- for i, v := range s.Rules {
- if v == nil {
- continue
- }
- if err := v.Validate(); err != nil {
- invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Rules", i), err.(request.ErrInvalidParams))
- }
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetRules sets the Rules field's value.
- func (s *BucketLifecycleConfiguration) SetRules(v []*LifecycleRule) *BucketLifecycleConfiguration {
- s.Rules = v
- return s
- }
- // Container for logging status information.
- type BucketLoggingStatus struct {
- _ struct{} `type:"structure"`
- // Describes where logs are stored and the prefix that Amazon S3 assigns to
- // all log object keys for a bucket. For more information, see PUT Bucket logging
- // (https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTlogging.html)
- // in the Amazon S3 API Reference.
- LoggingEnabled *LoggingEnabled `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s BucketLoggingStatus) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s BucketLoggingStatus) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *BucketLoggingStatus) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "BucketLoggingStatus"}
- if s.LoggingEnabled != nil {
- if err := s.LoggingEnabled.Validate(); err != nil {
- invalidParams.AddNested("LoggingEnabled", err.(request.ErrInvalidParams))
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetLoggingEnabled sets the LoggingEnabled field's value.
- func (s *BucketLoggingStatus) SetLoggingEnabled(v *LoggingEnabled) *BucketLoggingStatus {
- s.LoggingEnabled = v
- return s
- }
- // Describes the cross-origin access configuration for objects in an Amazon
- // S3 bucket. For more information, see Enabling Cross-Origin Resource Sharing
- // (https://docs.aws.amazon.com/AmazonS3/latest/dev/cors.html) in the Amazon
- // S3 User Guide.
- type CORSConfiguration struct {
- _ struct{} `type:"structure"`
- // A set of origins and methods (cross-origin access that you want to allow).
- // You can add up to 100 rules to the configuration.
- //
- // CORSRules is a required field
- CORSRules []*CORSRule `locationName:"CORSRule" type:"list" flattened:"true" required:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s CORSConfiguration) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s CORSConfiguration) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *CORSConfiguration) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "CORSConfiguration"}
- if s.CORSRules == nil {
- invalidParams.Add(request.NewErrParamRequired("CORSRules"))
- }
- if s.CORSRules != nil {
- for i, v := range s.CORSRules {
- if v == nil {
- continue
- }
- if err := v.Validate(); err != nil {
- invalidParams.AddNested(fmt.Sprintf("%s[%v]", "CORSRules", i), err.(request.ErrInvalidParams))
- }
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetCORSRules sets the CORSRules field's value.
- func (s *CORSConfiguration) SetCORSRules(v []*CORSRule) *CORSConfiguration {
- s.CORSRules = v
- return s
- }
- // Specifies a cross-origin access rule for an Amazon S3 bucket.
- type CORSRule struct {
- _ struct{} `type:"structure"`
- // Headers that are specified in the Access-Control-Request-Headers header.
- // These headers are allowed in a preflight OPTIONS request. In response to
- // any preflight OPTIONS request, Amazon S3 returns any requested headers that
- // are allowed.
- AllowedHeaders []*string `locationName:"AllowedHeader" type:"list" flattened:"true"`
- // An HTTP method that you allow the origin to execute. Valid values are GET,
- // PUT, HEAD, POST, and DELETE.
- //
- // AllowedMethods is a required field
- AllowedMethods []*string `locationName:"AllowedMethod" type:"list" flattened:"true" required:"true"`
- // One or more origins you want customers to be able to access the bucket from.
- //
- // AllowedOrigins is a required field
- AllowedOrigins []*string `locationName:"AllowedOrigin" type:"list" flattened:"true" required:"true"`
- // One or more headers in the response that you want customers to be able to
- // access from their applications (for example, from a JavaScript XMLHttpRequest
- // object).
- ExposeHeaders []*string `locationName:"ExposeHeader" type:"list" flattened:"true"`
- // Unique identifier for the rule. The value cannot be longer than 255 characters.
- ID *string `type:"string"`
- // The time in seconds that your browser is to cache the preflight response
- // for the specified resource.
- MaxAgeSeconds *int64 `type:"integer"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s CORSRule) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s CORSRule) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *CORSRule) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "CORSRule"}
- if s.AllowedMethods == nil {
- invalidParams.Add(request.NewErrParamRequired("AllowedMethods"))
- }
- if s.AllowedOrigins == nil {
- invalidParams.Add(request.NewErrParamRequired("AllowedOrigins"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetAllowedHeaders sets the AllowedHeaders field's value.
- func (s *CORSRule) SetAllowedHeaders(v []*string) *CORSRule {
- s.AllowedHeaders = v
- return s
- }
- // SetAllowedMethods sets the AllowedMethods field's value.
- func (s *CORSRule) SetAllowedMethods(v []*string) *CORSRule {
- s.AllowedMethods = v
- return s
- }
- // SetAllowedOrigins sets the AllowedOrigins field's value.
- func (s *CORSRule) SetAllowedOrigins(v []*string) *CORSRule {
- s.AllowedOrigins = v
- return s
- }
- // SetExposeHeaders sets the ExposeHeaders field's value.
- func (s *CORSRule) SetExposeHeaders(v []*string) *CORSRule {
- s.ExposeHeaders = v
- return s
- }
- // SetID sets the ID field's value.
- func (s *CORSRule) SetID(v string) *CORSRule {
- s.ID = &v
- return s
- }
- // SetMaxAgeSeconds sets the MaxAgeSeconds field's value.
- func (s *CORSRule) SetMaxAgeSeconds(v int64) *CORSRule {
- s.MaxAgeSeconds = &v
- return s
- }
- // Describes how an uncompressed comma-separated values (CSV)-formatted input
- // object is formatted.
- type CSVInput struct {
- _ struct{} `type:"structure"`
- // Specifies that CSV field values may contain quoted record delimiters and
- // such records should be allowed. Default value is FALSE. Setting this value
- // to TRUE may lower performance.
- AllowQuotedRecordDelimiter *bool `type:"boolean"`
- // A single character used to indicate that a row should be ignored when the
- // character is present at the start of that row. You can specify any character
- // to indicate a comment line.
- Comments *string `type:"string"`
- // A single character used to separate individual fields in a record. You can
- // specify an arbitrary delimiter.
- FieldDelimiter *string `type:"string"`
- // Describes the first line of input. Valid values are:
- //
- // * NONE: First line is not a header.
- //
- // * IGNORE: First line is a header, but you can't use the header values
- // to indicate the column in an expression. You can use column position (such
- // as _1, _2, …) to indicate the column (SELECT s._1 FROM OBJECT s).
- //
- // * Use: First line is a header, and you can use the header value to identify
- // a column in an expression (SELECT "name" FROM OBJECT).
- FileHeaderInfo *string `type:"string" enum:"FileHeaderInfo"`
- // A single character used for escaping when the field delimiter is part of
- // the value. For example, if the value is a, b, Amazon S3 wraps this field
- // value in quotation marks, as follows: " a , b ".
- //
- // Type: String
- //
- // Default: "
- //
- // Ancestors: CSV
- QuoteCharacter *string `type:"string"`
- // A single character used for escaping the quotation mark character inside
- // an already escaped value. For example, the value """ a , b """ is parsed
- // as " a , b ".
- QuoteEscapeCharacter *string `type:"string"`
- // A single character used to separate individual records in the input. Instead
- // of the default value, you can specify an arbitrary delimiter.
- RecordDelimiter *string `type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s CSVInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s CSVInput) GoString() string {
- return s.String()
- }
- // SetAllowQuotedRecordDelimiter sets the AllowQuotedRecordDelimiter field's value.
- func (s *CSVInput) SetAllowQuotedRecordDelimiter(v bool) *CSVInput {
- s.AllowQuotedRecordDelimiter = &v
- return s
- }
- // SetComments sets the Comments field's value.
- func (s *CSVInput) SetComments(v string) *CSVInput {
- s.Comments = &v
- return s
- }
- // SetFieldDelimiter sets the FieldDelimiter field's value.
- func (s *CSVInput) SetFieldDelimiter(v string) *CSVInput {
- s.FieldDelimiter = &v
- return s
- }
- // SetFileHeaderInfo sets the FileHeaderInfo field's value.
- func (s *CSVInput) SetFileHeaderInfo(v string) *CSVInput {
- s.FileHeaderInfo = &v
- return s
- }
- // SetQuoteCharacter sets the QuoteCharacter field's value.
- func (s *CSVInput) SetQuoteCharacter(v string) *CSVInput {
- s.QuoteCharacter = &v
- return s
- }
- // SetQuoteEscapeCharacter sets the QuoteEscapeCharacter field's value.
- func (s *CSVInput) SetQuoteEscapeCharacter(v string) *CSVInput {
- s.QuoteEscapeCharacter = &v
- return s
- }
- // SetRecordDelimiter sets the RecordDelimiter field's value.
- func (s *CSVInput) SetRecordDelimiter(v string) *CSVInput {
- s.RecordDelimiter = &v
- return s
- }
- // Describes how uncompressed comma-separated values (CSV)-formatted results
- // are formatted.
- type CSVOutput struct {
- _ struct{} `type:"structure"`
- // The value used to separate individual fields in a record. You can specify
- // an arbitrary delimiter.
- FieldDelimiter *string `type:"string"`
- // A single character used for escaping when the field delimiter is part of
- // the value. For example, if the value is a, b, Amazon S3 wraps this field
- // value in quotation marks, as follows: " a , b ".
- QuoteCharacter *string `type:"string"`
- // The single character used for escaping the quote character inside an already
- // escaped value.
- QuoteEscapeCharacter *string `type:"string"`
- // Indicates whether to use quotation marks around output fields.
- //
- // * ALWAYS: Always use quotation marks for output fields.
- //
- // * ASNEEDED: Use quotation marks for output fields when needed.
- QuoteFields *string `type:"string" enum:"QuoteFields"`
- // A single character used to separate individual records in the output. Instead
- // of the default value, you can specify an arbitrary delimiter.
- RecordDelimiter *string `type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s CSVOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s CSVOutput) GoString() string {
- return s.String()
- }
- // SetFieldDelimiter sets the FieldDelimiter field's value.
- func (s *CSVOutput) SetFieldDelimiter(v string) *CSVOutput {
- s.FieldDelimiter = &v
- return s
- }
- // SetQuoteCharacter sets the QuoteCharacter field's value.
- func (s *CSVOutput) SetQuoteCharacter(v string) *CSVOutput {
- s.QuoteCharacter = &v
- return s
- }
- // SetQuoteEscapeCharacter sets the QuoteEscapeCharacter field's value.
- func (s *CSVOutput) SetQuoteEscapeCharacter(v string) *CSVOutput {
- s.QuoteEscapeCharacter = &v
- return s
- }
- // SetQuoteFields sets the QuoteFields field's value.
- func (s *CSVOutput) SetQuoteFields(v string) *CSVOutput {
- s.QuoteFields = &v
- return s
- }
- // SetRecordDelimiter sets the RecordDelimiter field's value.
- func (s *CSVOutput) SetRecordDelimiter(v string) *CSVOutput {
- s.RecordDelimiter = &v
- return s
- }
- // Contains all the possible checksum or digest values for an object.
- type Checksum struct {
- _ struct{} `type:"structure"`
- // The base64-encoded, 32-bit CRC32 checksum of the object. This will only be
- // present if it was uploaded with the object. With multipart uploads, this
- // may not be a checksum value of the object. For more information about how
- // checksums are calculated with multipart uploads, see Checking object integrity
- // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
- // in the Amazon S3 User Guide.
- ChecksumCRC32 *string `type:"string"`
- // The base64-encoded, 32-bit CRC32C checksum of the object. This will only
- // be present if it was uploaded with the object. With multipart uploads, this
- // may not be a checksum value of the object. For more information about how
- // checksums are calculated with multipart uploads, see Checking object integrity
- // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
- // in the Amazon S3 User Guide.
- ChecksumCRC32C *string `type:"string"`
- // The base64-encoded, 160-bit SHA-1 digest of the object. This will only be
- // present if it was uploaded with the object. With multipart uploads, this
- // may not be a checksum value of the object. For more information about how
- // checksums are calculated with multipart uploads, see Checking object integrity
- // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
- // in the Amazon S3 User Guide.
- ChecksumSHA1 *string `type:"string"`
- // The base64-encoded, 256-bit SHA-256 digest of the object. This will only
- // be present if it was uploaded with the object. With multipart uploads, this
- // may not be a checksum value of the object. For more information about how
- // checksums are calculated with multipart uploads, see Checking object integrity
- // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
- // in the Amazon S3 User Guide.
- ChecksumSHA256 *string `type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s Checksum) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s Checksum) GoString() string {
- return s.String()
- }
- // SetChecksumCRC32 sets the ChecksumCRC32 field's value.
- func (s *Checksum) SetChecksumCRC32(v string) *Checksum {
- s.ChecksumCRC32 = &v
- return s
- }
- // SetChecksumCRC32C sets the ChecksumCRC32C field's value.
- func (s *Checksum) SetChecksumCRC32C(v string) *Checksum {
- s.ChecksumCRC32C = &v
- return s
- }
- // SetChecksumSHA1 sets the ChecksumSHA1 field's value.
- func (s *Checksum) SetChecksumSHA1(v string) *Checksum {
- s.ChecksumSHA1 = &v
- return s
- }
- // SetChecksumSHA256 sets the ChecksumSHA256 field's value.
- func (s *Checksum) SetChecksumSHA256(v string) *Checksum {
- s.ChecksumSHA256 = &v
- return s
- }
- // Container for specifying the Lambda notification configuration.
- type CloudFunctionConfiguration struct {
- _ struct{} `type:"structure"`
- // Lambda cloud function ARN that Amazon S3 can invoke when it detects events
- // of the specified type.
- CloudFunction *string `type:"string"`
- // The bucket event for which to send notifications.
- //
- // Deprecated: Event has been deprecated
- Event *string `deprecated:"true" type:"string" enum:"Event"`
- // Bucket events for which to send notifications.
- Events []*string `locationName:"Event" type:"list" flattened:"true" enum:"Event"`
- // An optional unique identifier for configurations in a notification configuration.
- // If you don't provide one, Amazon S3 will assign an ID.
- Id *string `type:"string"`
- // The role supporting the invocation of the Lambda function
- InvocationRole *string `type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s CloudFunctionConfiguration) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s CloudFunctionConfiguration) GoString() string {
- return s.String()
- }
- // SetCloudFunction sets the CloudFunction field's value.
- func (s *CloudFunctionConfiguration) SetCloudFunction(v string) *CloudFunctionConfiguration {
- s.CloudFunction = &v
- return s
- }
- // SetEvent sets the Event field's value.
- func (s *CloudFunctionConfiguration) SetEvent(v string) *CloudFunctionConfiguration {
- s.Event = &v
- return s
- }
- // SetEvents sets the Events field's value.
- func (s *CloudFunctionConfiguration) SetEvents(v []*string) *CloudFunctionConfiguration {
- s.Events = v
- return s
- }
- // SetId sets the Id field's value.
- func (s *CloudFunctionConfiguration) SetId(v string) *CloudFunctionConfiguration {
- s.Id = &v
- return s
- }
- // SetInvocationRole sets the InvocationRole field's value.
- func (s *CloudFunctionConfiguration) SetInvocationRole(v string) *CloudFunctionConfiguration {
- s.InvocationRole = &v
- return s
- }
- // Container for all (if there are any) keys between Prefix and the next occurrence
- // of the string specified by a delimiter. CommonPrefixes lists keys that act
- // like subdirectories in the directory specified by Prefix. For example, if
- // the prefix is notes/ and the delimiter is a slash (/) as in notes/summer/july,
- // the common prefix is notes/summer/.
- type CommonPrefix struct {
- _ struct{} `type:"structure"`
- // Container for the specified common prefix.
- Prefix *string `type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s CommonPrefix) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s CommonPrefix) GoString() string {
- return s.String()
- }
- // SetPrefix sets the Prefix field's value.
- func (s *CommonPrefix) SetPrefix(v string) *CommonPrefix {
- s.Prefix = &v
- return s
- }
- type CompleteMultipartUploadInput struct {
- _ struct{} `locationName:"CompleteMultipartUploadRequest" type:"structure" payload:"MultipartUpload"`
- // Name of the bucket to which the multipart upload was initiated.
- //
- // When using this action with an access point, you must direct requests to
- // the access point hostname. The access point hostname takes the form AccessPointName-AccountId.s3-accesspoint.Region.amazonaws.com.
- // When using this action with an access point through the Amazon Web Services
- // SDKs, you provide the access point ARN in place of the bucket name. For more
- // information about access point ARNs, see Using access points (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html)
- // in the Amazon S3 User Guide.
- //
- // When using this action with Amazon S3 on Outposts, you must direct requests
- // to the S3 on Outposts hostname. The S3 on Outposts hostname takes the form
- // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When
- // using this action with S3 on Outposts through the Amazon Web Services SDKs,
- // you provide the Outposts bucket ARN in place of the bucket name. For more
- // information about S3 on Outposts ARNs, see Using Amazon S3 on Outposts (https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html)
- // in the Amazon S3 User Guide.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // This header can be used as a data integrity check to verify that the data
- // received is the same data that was originally sent. This header specifies
- // the base64-encoded, 32-bit CRC32 checksum of the object. For more information,
- // see Checking object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
- // in the Amazon S3 User Guide.
- ChecksumCRC32 *string `location:"header" locationName:"x-amz-checksum-crc32" type:"string"`
- // This header can be used as a data integrity check to verify that the data
- // received is the same data that was originally sent. This header specifies
- // the base64-encoded, 32-bit CRC32C checksum of the object. For more information,
- // see Checking object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
- // in the Amazon S3 User Guide.
- ChecksumCRC32C *string `location:"header" locationName:"x-amz-checksum-crc32c" type:"string"`
- // This header can be used as a data integrity check to verify that the data
- // received is the same data that was originally sent. This header specifies
- // the base64-encoded, 160-bit SHA-1 digest of the object. For more information,
- // see Checking object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
- // in the Amazon S3 User Guide.
- ChecksumSHA1 *string `location:"header" locationName:"x-amz-checksum-sha1" type:"string"`
- // This header can be used as a data integrity check to verify that the data
- // received is the same data that was originally sent. This header specifies
- // the base64-encoded, 256-bit SHA-256 digest of the object. For more information,
- // see Checking object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
- // in the Amazon S3 User Guide.
- ChecksumSHA256 *string `location:"header" locationName:"x-amz-checksum-sha256" type:"string"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // Object key for which the multipart upload was initiated.
- //
- // Key is a required field
- Key *string `location:"uri" locationName:"Key" min:"1" type:"string" required:"true"`
- // The container for the multipart upload request information.
- MultipartUpload *CompletedMultipartUpload `locationName:"CompleteMultipartUpload" type:"structure" xmlURI:"http://s3.amazonaws.com/doc/2006-03-01/"`
- // Confirms that the requester knows that they will be charged for the request.
- // Bucket owners need not specify this parameter in their requests. For information
- // about downloading objects from Requester Pays buckets, see Downloading Objects
- // in Requester Pays Buckets (https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html)
- // in the Amazon S3 User Guide.
- RequestPayer *string `location:"header" locationName:"x-amz-request-payer" type:"string" enum:"RequestPayer"`
- // The server-side encryption (SSE) algorithm used to encrypt the object. This
- // parameter is needed only when the object was created using a checksum algorithm.
- // For more information, see Protecting data using SSE-C keys (https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html)
- // in the Amazon S3 User Guide.
- SSECustomerAlgorithm *string `location:"header" locationName:"x-amz-server-side-encryption-customer-algorithm" type:"string"`
- // The server-side encryption (SSE) customer managed key. This parameter is
- // needed only when the object was created using a checksum algorithm. For more
- // information, see Protecting data using SSE-C keys (https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html)
- // in the Amazon S3 User Guide.
- //
- // SSECustomerKey is a sensitive parameter and its value will be
- // replaced with "sensitive" in string returned by CompleteMultipartUploadInput's
- // String and GoString methods.
- SSECustomerKey *string `marshal-as:"blob" location:"header" locationName:"x-amz-server-side-encryption-customer-key" type:"string" sensitive:"true"`
- // The MD5 server-side encryption (SSE) customer managed key. This parameter
- // is needed only when the object was created using a checksum algorithm. For
- // more information, see Protecting data using SSE-C keys (https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html)
- // in the Amazon S3 User Guide.
- SSECustomerKeyMD5 *string `location:"header" locationName:"x-amz-server-side-encryption-customer-key-MD5" type:"string"`
- // ID for the initiated multipart upload.
- //
- // UploadId is a required field
- UploadId *string `location:"querystring" locationName:"uploadId" type:"string" required:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s CompleteMultipartUploadInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s CompleteMultipartUploadInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *CompleteMultipartUploadInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "CompleteMultipartUploadInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.Key == nil {
- invalidParams.Add(request.NewErrParamRequired("Key"))
- }
- if s.Key != nil && len(*s.Key) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Key", 1))
- }
- if s.UploadId == nil {
- invalidParams.Add(request.NewErrParamRequired("UploadId"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *CompleteMultipartUploadInput) SetBucket(v string) *CompleteMultipartUploadInput {
- s.Bucket = &v
- return s
- }
- func (s *CompleteMultipartUploadInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetChecksumCRC32 sets the ChecksumCRC32 field's value.
- func (s *CompleteMultipartUploadInput) SetChecksumCRC32(v string) *CompleteMultipartUploadInput {
- s.ChecksumCRC32 = &v
- return s
- }
- // SetChecksumCRC32C sets the ChecksumCRC32C field's value.
- func (s *CompleteMultipartUploadInput) SetChecksumCRC32C(v string) *CompleteMultipartUploadInput {
- s.ChecksumCRC32C = &v
- return s
- }
- // SetChecksumSHA1 sets the ChecksumSHA1 field's value.
- func (s *CompleteMultipartUploadInput) SetChecksumSHA1(v string) *CompleteMultipartUploadInput {
- s.ChecksumSHA1 = &v
- return s
- }
- // SetChecksumSHA256 sets the ChecksumSHA256 field's value.
- func (s *CompleteMultipartUploadInput) SetChecksumSHA256(v string) *CompleteMultipartUploadInput {
- s.ChecksumSHA256 = &v
- return s
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *CompleteMultipartUploadInput) SetExpectedBucketOwner(v string) *CompleteMultipartUploadInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetKey sets the Key field's value.
- func (s *CompleteMultipartUploadInput) SetKey(v string) *CompleteMultipartUploadInput {
- s.Key = &v
- return s
- }
- // SetMultipartUpload sets the MultipartUpload field's value.
- func (s *CompleteMultipartUploadInput) SetMultipartUpload(v *CompletedMultipartUpload) *CompleteMultipartUploadInput {
- s.MultipartUpload = v
- return s
- }
- // SetRequestPayer sets the RequestPayer field's value.
- func (s *CompleteMultipartUploadInput) SetRequestPayer(v string) *CompleteMultipartUploadInput {
- s.RequestPayer = &v
- return s
- }
- // SetSSECustomerAlgorithm sets the SSECustomerAlgorithm field's value.
- func (s *CompleteMultipartUploadInput) SetSSECustomerAlgorithm(v string) *CompleteMultipartUploadInput {
- s.SSECustomerAlgorithm = &v
- return s
- }
- // SetSSECustomerKey sets the SSECustomerKey field's value.
- func (s *CompleteMultipartUploadInput) SetSSECustomerKey(v string) *CompleteMultipartUploadInput {
- s.SSECustomerKey = &v
- return s
- }
- func (s *CompleteMultipartUploadInput) getSSECustomerKey() (v string) {
- if s.SSECustomerKey == nil {
- return v
- }
- return *s.SSECustomerKey
- }
- // SetSSECustomerKeyMD5 sets the SSECustomerKeyMD5 field's value.
- func (s *CompleteMultipartUploadInput) SetSSECustomerKeyMD5(v string) *CompleteMultipartUploadInput {
- s.SSECustomerKeyMD5 = &v
- return s
- }
- // SetUploadId sets the UploadId field's value.
- func (s *CompleteMultipartUploadInput) SetUploadId(v string) *CompleteMultipartUploadInput {
- s.UploadId = &v
- return s
- }
- func (s *CompleteMultipartUploadInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *CompleteMultipartUploadInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s CompleteMultipartUploadInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type CompleteMultipartUploadOutput struct {
- _ struct{} `type:"structure"`
- // The name of the bucket that contains the newly created object. Does not return
- // the access point ARN or access point alias if used.
- //
- // When using this action with an access point, you must direct requests to
- // the access point hostname. The access point hostname takes the form AccessPointName-AccountId.s3-accesspoint.Region.amazonaws.com.
- // When using this action with an access point through the Amazon Web Services
- // SDKs, you provide the access point ARN in place of the bucket name. For more
- // information about access point ARNs, see Using access points (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html)
- // in the Amazon S3 User Guide.
- //
- // When using this action with Amazon S3 on Outposts, you must direct requests
- // to the S3 on Outposts hostname. The S3 on Outposts hostname takes the form
- // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When
- // using this action with S3 on Outposts through the Amazon Web Services SDKs,
- // you provide the Outposts bucket ARN in place of the bucket name. For more
- // information about S3 on Outposts ARNs, see Using Amazon S3 on Outposts (https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html)
- // in the Amazon S3 User Guide.
- Bucket *string `type:"string"`
- // Indicates whether the multipart upload uses an S3 Bucket Key for server-side
- // encryption with Amazon Web Services KMS (SSE-KMS).
- BucketKeyEnabled *bool `location:"header" locationName:"x-amz-server-side-encryption-bucket-key-enabled" type:"boolean"`
- // The base64-encoded, 32-bit CRC32 checksum of the object. This will only be
- // present if it was uploaded with the object. With multipart uploads, this
- // may not be a checksum value of the object. For more information about how
- // checksums are calculated with multipart uploads, see Checking object integrity
- // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
- // in the Amazon S3 User Guide.
- ChecksumCRC32 *string `type:"string"`
- // The base64-encoded, 32-bit CRC32C checksum of the object. This will only
- // be present if it was uploaded with the object. With multipart uploads, this
- // may not be a checksum value of the object. For more information about how
- // checksums are calculated with multipart uploads, see Checking object integrity
- // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
- // in the Amazon S3 User Guide.
- ChecksumCRC32C *string `type:"string"`
- // The base64-encoded, 160-bit SHA-1 digest of the object. This will only be
- // present if it was uploaded with the object. With multipart uploads, this
- // may not be a checksum value of the object. For more information about how
- // checksums are calculated with multipart uploads, see Checking object integrity
- // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
- // in the Amazon S3 User Guide.
- ChecksumSHA1 *string `type:"string"`
- // The base64-encoded, 256-bit SHA-256 digest of the object. This will only
- // be present if it was uploaded with the object. With multipart uploads, this
- // may not be a checksum value of the object. For more information about how
- // checksums are calculated with multipart uploads, see Checking object integrity
- // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
- // in the Amazon S3 User Guide.
- ChecksumSHA256 *string `type:"string"`
- // Entity tag that identifies the newly created object's data. Objects with
- // different object data will have different entity tags. The entity tag is
- // an opaque string. The entity tag may or may not be an MD5 digest of the object
- // data. If the entity tag is not an MD5 digest of the object data, it will
- // contain one or more nonhexadecimal characters and/or will consist of less
- // than 32 or more than 32 hexadecimal digits. For more information about how
- // the entity tag is calculated, see Checking object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
- // in the Amazon S3 User Guide.
- ETag *string `type:"string"`
- // If the object expiration is configured, this will contain the expiration
- // date (expiry-date) and rule ID (rule-id). The value of rule-id is URL-encoded.
- Expiration *string `location:"header" locationName:"x-amz-expiration" type:"string"`
- // The object key of the newly created object.
- Key *string `min:"1" type:"string"`
- // The URI that identifies the newly created object.
- Location *string `type:"string"`
- // If present, indicates that the requester was successfully charged for the
- // request.
- RequestCharged *string `location:"header" locationName:"x-amz-request-charged" type:"string" enum:"RequestCharged"`
- // If present, specifies the ID of the Amazon Web Services Key Management Service
- // (Amazon Web Services KMS) symmetric customer managed key that was used for
- // the object.
- //
- // SSEKMSKeyId is a sensitive parameter and its value will be
- // replaced with "sensitive" in string returned by CompleteMultipartUploadOutput's
- // String and GoString methods.
- SSEKMSKeyId *string `location:"header" locationName:"x-amz-server-side-encryption-aws-kms-key-id" type:"string" sensitive:"true"`
- // If you specified server-side encryption either with an Amazon S3-managed
- // encryption key or an Amazon Web Services KMS key in your initiate multipart
- // upload request, the response includes this header. It confirms the encryption
- // algorithm that Amazon S3 used to encrypt the object.
- ServerSideEncryption *string `location:"header" locationName:"x-amz-server-side-encryption" type:"string" enum:"ServerSideEncryption"`
- // Version ID of the newly created object, in case the bucket has versioning
- // turned on.
- VersionId *string `location:"header" locationName:"x-amz-version-id" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s CompleteMultipartUploadOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s CompleteMultipartUploadOutput) GoString() string {
- return s.String()
- }
- // SetBucket sets the Bucket field's value.
- func (s *CompleteMultipartUploadOutput) SetBucket(v string) *CompleteMultipartUploadOutput {
- s.Bucket = &v
- return s
- }
- func (s *CompleteMultipartUploadOutput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetBucketKeyEnabled sets the BucketKeyEnabled field's value.
- func (s *CompleteMultipartUploadOutput) SetBucketKeyEnabled(v bool) *CompleteMultipartUploadOutput {
- s.BucketKeyEnabled = &v
- return s
- }
- // SetChecksumCRC32 sets the ChecksumCRC32 field's value.
- func (s *CompleteMultipartUploadOutput) SetChecksumCRC32(v string) *CompleteMultipartUploadOutput {
- s.ChecksumCRC32 = &v
- return s
- }
- // SetChecksumCRC32C sets the ChecksumCRC32C field's value.
- func (s *CompleteMultipartUploadOutput) SetChecksumCRC32C(v string) *CompleteMultipartUploadOutput {
- s.ChecksumCRC32C = &v
- return s
- }
- // SetChecksumSHA1 sets the ChecksumSHA1 field's value.
- func (s *CompleteMultipartUploadOutput) SetChecksumSHA1(v string) *CompleteMultipartUploadOutput {
- s.ChecksumSHA1 = &v
- return s
- }
- // SetChecksumSHA256 sets the ChecksumSHA256 field's value.
- func (s *CompleteMultipartUploadOutput) SetChecksumSHA256(v string) *CompleteMultipartUploadOutput {
- s.ChecksumSHA256 = &v
- return s
- }
- // SetETag sets the ETag field's value.
- func (s *CompleteMultipartUploadOutput) SetETag(v string) *CompleteMultipartUploadOutput {
- s.ETag = &v
- return s
- }
- // SetExpiration sets the Expiration field's value.
- func (s *CompleteMultipartUploadOutput) SetExpiration(v string) *CompleteMultipartUploadOutput {
- s.Expiration = &v
- return s
- }
- // SetKey sets the Key field's value.
- func (s *CompleteMultipartUploadOutput) SetKey(v string) *CompleteMultipartUploadOutput {
- s.Key = &v
- return s
- }
- // SetLocation sets the Location field's value.
- func (s *CompleteMultipartUploadOutput) SetLocation(v string) *CompleteMultipartUploadOutput {
- s.Location = &v
- return s
- }
- // SetRequestCharged sets the RequestCharged field's value.
- func (s *CompleteMultipartUploadOutput) SetRequestCharged(v string) *CompleteMultipartUploadOutput {
- s.RequestCharged = &v
- return s
- }
- // SetSSEKMSKeyId sets the SSEKMSKeyId field's value.
- func (s *CompleteMultipartUploadOutput) SetSSEKMSKeyId(v string) *CompleteMultipartUploadOutput {
- s.SSEKMSKeyId = &v
- return s
- }
- // SetServerSideEncryption sets the ServerSideEncryption field's value.
- func (s *CompleteMultipartUploadOutput) SetServerSideEncryption(v string) *CompleteMultipartUploadOutput {
- s.ServerSideEncryption = &v
- return s
- }
- // SetVersionId sets the VersionId field's value.
- func (s *CompleteMultipartUploadOutput) SetVersionId(v string) *CompleteMultipartUploadOutput {
- s.VersionId = &v
- return s
- }
- // The container for the completed multipart upload details.
- type CompletedMultipartUpload struct {
- _ struct{} `type:"structure"`
- // Array of CompletedPart data types.
- //
- // If you do not supply a valid Part with your request, the service sends back
- // an HTTP 400 response.
- Parts []*CompletedPart `locationName:"Part" type:"list" flattened:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s CompletedMultipartUpload) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s CompletedMultipartUpload) GoString() string {
- return s.String()
- }
- // SetParts sets the Parts field's value.
- func (s *CompletedMultipartUpload) SetParts(v []*CompletedPart) *CompletedMultipartUpload {
- s.Parts = v
- return s
- }
- // Details of the parts that were uploaded.
- type CompletedPart struct {
- _ struct{} `type:"structure"`
- // The base64-encoded, 32-bit CRC32 checksum of the object. This will only be
- // present if it was uploaded with the object. With multipart uploads, this
- // may not be a checksum value of the object. For more information about how
- // checksums are calculated with multipart uploads, see Checking object integrity
- // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
- // in the Amazon S3 User Guide.
- ChecksumCRC32 *string `type:"string"`
- // The base64-encoded, 32-bit CRC32C checksum of the object. This will only
- // be present if it was uploaded with the object. With multipart uploads, this
- // may not be a checksum value of the object. For more information about how
- // checksums are calculated with multipart uploads, see Checking object integrity
- // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
- // in the Amazon S3 User Guide.
- ChecksumCRC32C *string `type:"string"`
- // The base64-encoded, 160-bit SHA-1 digest of the object. This will only be
- // present if it was uploaded with the object. With multipart uploads, this
- // may not be a checksum value of the object. For more information about how
- // checksums are calculated with multipart uploads, see Checking object integrity
- // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
- // in the Amazon S3 User Guide.
- ChecksumSHA1 *string `type:"string"`
- // The base64-encoded, 256-bit SHA-256 digest of the object. This will only
- // be present if it was uploaded with the object. With multipart uploads, this
- // may not be a checksum value of the object. For more information about how
- // checksums are calculated with multipart uploads, see Checking object integrity
- // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
- // in the Amazon S3 User Guide.
- ChecksumSHA256 *string `type:"string"`
- // Entity tag returned when the part was uploaded.
- ETag *string `type:"string"`
- // Part number that identifies the part. This is a positive integer between
- // 1 and 10,000.
- PartNumber *int64 `type:"integer"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s CompletedPart) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s CompletedPart) GoString() string {
- return s.String()
- }
- // SetChecksumCRC32 sets the ChecksumCRC32 field's value.
- func (s *CompletedPart) SetChecksumCRC32(v string) *CompletedPart {
- s.ChecksumCRC32 = &v
- return s
- }
- // SetChecksumCRC32C sets the ChecksumCRC32C field's value.
- func (s *CompletedPart) SetChecksumCRC32C(v string) *CompletedPart {
- s.ChecksumCRC32C = &v
- return s
- }
- // SetChecksumSHA1 sets the ChecksumSHA1 field's value.
- func (s *CompletedPart) SetChecksumSHA1(v string) *CompletedPart {
- s.ChecksumSHA1 = &v
- return s
- }
- // SetChecksumSHA256 sets the ChecksumSHA256 field's value.
- func (s *CompletedPart) SetChecksumSHA256(v string) *CompletedPart {
- s.ChecksumSHA256 = &v
- return s
- }
- // SetETag sets the ETag field's value.
- func (s *CompletedPart) SetETag(v string) *CompletedPart {
- s.ETag = &v
- return s
- }
- // SetPartNumber sets the PartNumber field's value.
- func (s *CompletedPart) SetPartNumber(v int64) *CompletedPart {
- s.PartNumber = &v
- return s
- }
- // A container for describing a condition that must be met for the specified
- // redirect to apply. For example, 1. If request is for pages in the /docs folder,
- // redirect to the /documents folder. 2. If request results in HTTP error 4xx,
- // redirect request to another host where you might process the error.
- type Condition struct {
- _ struct{} `type:"structure"`
- // The HTTP error code when the redirect is applied. In the event of an error,
- // if the error code equals this value, then the specified redirect is applied.
- // Required when parent element Condition is specified and sibling KeyPrefixEquals
- // is not specified. If both are specified, then both must be true for the redirect
- // to be applied.
- HttpErrorCodeReturnedEquals *string `type:"string"`
- // The object key name prefix when the redirect is applied. For example, to
- // redirect requests for ExamplePage.html, the key prefix will be ExamplePage.html.
- // To redirect request for all pages with the prefix docs/, the key prefix will
- // be /docs, which identifies all objects in the docs/ folder. Required when
- // the parent element Condition is specified and sibling HttpErrorCodeReturnedEquals
- // is not specified. If both conditions are specified, both must be true for
- // the redirect to be applied.
- //
- // Replacement must be made for object keys containing special characters (such
- // as carriage returns) when using XML requests. For more information, see XML
- // related object key constraints (https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html#object-key-xml-related-constraints).
- KeyPrefixEquals *string `type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s Condition) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s Condition) GoString() string {
- return s.String()
- }
- // SetHttpErrorCodeReturnedEquals sets the HttpErrorCodeReturnedEquals field's value.
- func (s *Condition) SetHttpErrorCodeReturnedEquals(v string) *Condition {
- s.HttpErrorCodeReturnedEquals = &v
- return s
- }
- // SetKeyPrefixEquals sets the KeyPrefixEquals field's value.
- func (s *Condition) SetKeyPrefixEquals(v string) *Condition {
- s.KeyPrefixEquals = &v
- return s
- }
- type ContinuationEvent struct {
- _ struct{} `locationName:"ContinuationEvent" type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ContinuationEvent) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ContinuationEvent) GoString() string {
- return s.String()
- }
- // The ContinuationEvent is and event in the SelectObjectContentEventStream group of events.
- func (s *ContinuationEvent) eventSelectObjectContentEventStream() {}
- // UnmarshalEvent unmarshals the EventStream Message into the ContinuationEvent value.
- // This method is only used internally within the SDK's EventStream handling.
- func (s *ContinuationEvent) UnmarshalEvent(
- payloadUnmarshaler protocol.PayloadUnmarshaler,
- msg eventstream.Message,
- ) error {
- return nil
- }
- // MarshalEvent marshals the type into an stream event value. This method
- // should only used internally within the SDK's EventStream handling.
- func (s *ContinuationEvent) MarshalEvent(pm protocol.PayloadMarshaler) (msg eventstream.Message, err error) {
- msg.Headers.Set(eventstreamapi.MessageTypeHeader, eventstream.StringValue(eventstreamapi.EventMessageType))
- return msg, err
- }
- type CopyObjectInput struct {
- _ struct{} `locationName:"CopyObjectRequest" type:"structure"`
- // The canned ACL to apply to the object.
- //
- // This action is not supported by Amazon S3 on Outposts.
- ACL *string `location:"header" locationName:"x-amz-acl" type:"string" enum:"ObjectCannedACL"`
- // The name of the destination bucket.
- //
- // When using this action with an access point, you must direct requests to
- // the access point hostname. The access point hostname takes the form AccessPointName-AccountId.s3-accesspoint.Region.amazonaws.com.
- // When using this action with an access point through the Amazon Web Services
- // SDKs, you provide the access point ARN in place of the bucket name. For more
- // information about access point ARNs, see Using access points (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html)
- // in the Amazon S3 User Guide.
- //
- // When using this action with Amazon S3 on Outposts, you must direct requests
- // to the S3 on Outposts hostname. The S3 on Outposts hostname takes the form
- // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When
- // using this action with S3 on Outposts through the Amazon Web Services SDKs,
- // you provide the Outposts bucket ARN in place of the bucket name. For more
- // information about S3 on Outposts ARNs, see Using Amazon S3 on Outposts (https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html)
- // in the Amazon S3 User Guide.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // Specifies whether Amazon S3 should use an S3 Bucket Key for object encryption
- // with server-side encryption using AWS KMS (SSE-KMS). Setting this header
- // to true causes Amazon S3 to use an S3 Bucket Key for object encryption with
- // SSE-KMS.
- //
- // Specifying this header with a COPY action doesn’t affect bucket-level settings
- // for S3 Bucket Key.
- BucketKeyEnabled *bool `location:"header" locationName:"x-amz-server-side-encryption-bucket-key-enabled" type:"boolean"`
- // Specifies caching behavior along the request/reply chain.
- CacheControl *string `location:"header" locationName:"Cache-Control" type:"string"`
- // Indicates the algorithm you want Amazon S3 to use to create the checksum
- // for the object. For more information, see Checking object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
- // in the Amazon S3 User Guide.
- ChecksumAlgorithm *string `location:"header" locationName:"x-amz-checksum-algorithm" type:"string" enum:"ChecksumAlgorithm"`
- // Specifies presentational information for the object.
- ContentDisposition *string `location:"header" locationName:"Content-Disposition" type:"string"`
- // Specifies what content encodings have been applied to the object and thus
- // what decoding mechanisms must be applied to obtain the media-type referenced
- // by the Content-Type header field.
- ContentEncoding *string `location:"header" locationName:"Content-Encoding" type:"string"`
- // The language the content is in.
- ContentLanguage *string `location:"header" locationName:"Content-Language" type:"string"`
- // A standard MIME type describing the format of the object data.
- ContentType *string `location:"header" locationName:"Content-Type" type:"string"`
- // Specifies the source object for the copy operation. You specify the value
- // in one of two formats, depending on whether you want to access the source
- // object through an access point (https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-points.html):
- //
- // * For objects not accessed through an access point, specify the name of
- // the source bucket and the key of the source object, separated by a slash
- // (/). For example, to copy the object reports/january.pdf from the bucket
- // awsexamplebucket, use awsexamplebucket/reports/january.pdf. The value
- // must be URL-encoded.
- //
- // * For objects accessed through access points, specify the Amazon Resource
- // Name (ARN) of the object as accessed through the access point, in the
- // format arn:aws:s3:<Region>:<account-id>:accesspoint/<access-point-name>/object/<key>.
- // For example, to copy the object reports/january.pdf through access point
- // my-access-point owned by account 123456789012 in Region us-west-2, use
- // the URL encoding of arn:aws:s3:us-west-2:123456789012:accesspoint/my-access-point/object/reports/january.pdf.
- // The value must be URL encoded. Amazon S3 supports copy operations using
- // access points only when the source and destination buckets are in the
- // same Amazon Web Services Region. Alternatively, for objects accessed through
- // Amazon S3 on Outposts, specify the ARN of the object as accessed in the
- // format arn:aws:s3-outposts:<Region>:<account-id>:outpost/<outpost-id>/object/<key>.
- // For example, to copy the object reports/january.pdf through outpost my-outpost
- // owned by account 123456789012 in Region us-west-2, use the URL encoding
- // of arn:aws:s3-outposts:us-west-2:123456789012:outpost/my-outpost/object/reports/january.pdf.
- // The value must be URL-encoded.
- //
- // To copy a specific version of an object, append ?versionId=<version-id> to
- // the value (for example, awsexamplebucket/reports/january.pdf?versionId=QUpfdndhfd8438MNFDN93jdnJFkdmqnh893).
- // If you don't specify a version ID, Amazon S3 copies the latest version of
- // the source object.
- //
- // CopySource is a required field
- CopySource *string `location:"header" locationName:"x-amz-copy-source" type:"string" required:"true"`
- // Copies the object if its entity tag (ETag) matches the specified tag.
- CopySourceIfMatch *string `location:"header" locationName:"x-amz-copy-source-if-match" type:"string"`
- // Copies the object if it has been modified since the specified time.
- CopySourceIfModifiedSince *time.Time `location:"header" locationName:"x-amz-copy-source-if-modified-since" type:"timestamp"`
- // Copies the object if its entity tag (ETag) is different than the specified
- // ETag.
- CopySourceIfNoneMatch *string `location:"header" locationName:"x-amz-copy-source-if-none-match" type:"string"`
- // Copies the object if it hasn't been modified since the specified time.
- CopySourceIfUnmodifiedSince *time.Time `location:"header" locationName:"x-amz-copy-source-if-unmodified-since" type:"timestamp"`
- // Specifies the algorithm to use when decrypting the source object (for example,
- // AES256).
- CopySourceSSECustomerAlgorithm *string `location:"header" locationName:"x-amz-copy-source-server-side-encryption-customer-algorithm" type:"string"`
- // Specifies the customer-provided encryption key for Amazon S3 to use to decrypt
- // the source object. The encryption key provided in this header must be one
- // that was used when the source object was created.
- //
- // CopySourceSSECustomerKey is a sensitive parameter and its value will be
- // replaced with "sensitive" in string returned by CopyObjectInput's
- // String and GoString methods.
- CopySourceSSECustomerKey *string `marshal-as:"blob" location:"header" locationName:"x-amz-copy-source-server-side-encryption-customer-key" type:"string" sensitive:"true"`
- // Specifies the 128-bit MD5 digest of the encryption key according to RFC 1321.
- // Amazon S3 uses this header for a message integrity check to ensure that the
- // encryption key was transmitted without error.
- CopySourceSSECustomerKeyMD5 *string `location:"header" locationName:"x-amz-copy-source-server-side-encryption-customer-key-MD5" type:"string"`
- // The account ID of the expected destination bucket owner. If the destination
- // bucket is owned by a different account, the request fails with the HTTP status
- // code 403 Forbidden (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // The account ID of the expected source bucket owner. If the source bucket
- // is owned by a different account, the request fails with the HTTP status code
- // 403 Forbidden (access denied).
- ExpectedSourceBucketOwner *string `location:"header" locationName:"x-amz-source-expected-bucket-owner" type:"string"`
- // The date and time at which the object is no longer cacheable.
- Expires *time.Time `location:"header" locationName:"Expires" type:"timestamp"`
- // Gives the grantee READ, READ_ACP, and WRITE_ACP permissions on the object.
- //
- // This action is not supported by Amazon S3 on Outposts.
- GrantFullControl *string `location:"header" locationName:"x-amz-grant-full-control" type:"string"`
- // Allows grantee to read the object data and its metadata.
- //
- // This action is not supported by Amazon S3 on Outposts.
- GrantRead *string `location:"header" locationName:"x-amz-grant-read" type:"string"`
- // Allows grantee to read the object ACL.
- //
- // This action is not supported by Amazon S3 on Outposts.
- GrantReadACP *string `location:"header" locationName:"x-amz-grant-read-acp" type:"string"`
- // Allows grantee to write the ACL for the applicable object.
- //
- // This action is not supported by Amazon S3 on Outposts.
- GrantWriteACP *string `location:"header" locationName:"x-amz-grant-write-acp" type:"string"`
- // The key of the destination object.
- //
- // Key is a required field
- Key *string `location:"uri" locationName:"Key" min:"1" type:"string" required:"true"`
- // A map of metadata to store with the object in S3.
- Metadata map[string]*string `location:"headers" locationName:"x-amz-meta-" type:"map"`
- // Specifies whether the metadata is copied from the source object or replaced
- // with metadata provided in the request.
- MetadataDirective *string `location:"header" locationName:"x-amz-metadata-directive" type:"string" enum:"MetadataDirective"`
- // Specifies whether you want to apply a legal hold to the copied object.
- ObjectLockLegalHoldStatus *string `location:"header" locationName:"x-amz-object-lock-legal-hold" type:"string" enum:"ObjectLockLegalHoldStatus"`
- // The Object Lock mode that you want to apply to the copied object.
- ObjectLockMode *string `location:"header" locationName:"x-amz-object-lock-mode" type:"string" enum:"ObjectLockMode"`
- // The date and time when you want the copied object's Object Lock to expire.
- ObjectLockRetainUntilDate *time.Time `location:"header" locationName:"x-amz-object-lock-retain-until-date" type:"timestamp" timestampFormat:"iso8601"`
- // Confirms that the requester knows that they will be charged for the request.
- // Bucket owners need not specify this parameter in their requests. For information
- // about downloading objects from Requester Pays buckets, see Downloading Objects
- // in Requester Pays Buckets (https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html)
- // in the Amazon S3 User Guide.
- RequestPayer *string `location:"header" locationName:"x-amz-request-payer" type:"string" enum:"RequestPayer"`
- // Specifies the algorithm to use to when encrypting the object (for example,
- // AES256).
- SSECustomerAlgorithm *string `location:"header" locationName:"x-amz-server-side-encryption-customer-algorithm" type:"string"`
- // Specifies the customer-provided encryption key for Amazon S3 to use in encrypting
- // data. This value is used to store the object and then it is discarded; Amazon
- // S3 does not store the encryption key. The key must be appropriate for use
- // with the algorithm specified in the x-amz-server-side-encryption-customer-algorithm
- // header.
- //
- // SSECustomerKey is a sensitive parameter and its value will be
- // replaced with "sensitive" in string returned by CopyObjectInput's
- // String and GoString methods.
- SSECustomerKey *string `marshal-as:"blob" location:"header" locationName:"x-amz-server-side-encryption-customer-key" type:"string" sensitive:"true"`
- // Specifies the 128-bit MD5 digest of the encryption key according to RFC 1321.
- // Amazon S3 uses this header for a message integrity check to ensure that the
- // encryption key was transmitted without error.
- SSECustomerKeyMD5 *string `location:"header" locationName:"x-amz-server-side-encryption-customer-key-MD5" type:"string"`
- // Specifies the Amazon Web Services KMS Encryption Context to use for object
- // encryption. The value of this header is a base64-encoded UTF-8 string holding
- // JSON with the encryption context key-value pairs.
- //
- // SSEKMSEncryptionContext is a sensitive parameter and its value will be
- // replaced with "sensitive" in string returned by CopyObjectInput's
- // String and GoString methods.
- SSEKMSEncryptionContext *string `location:"header" locationName:"x-amz-server-side-encryption-context" type:"string" sensitive:"true"`
- // Specifies the Amazon Web Services KMS key ID to use for object encryption.
- // All GET and PUT requests for an object protected by Amazon Web Services KMS
- // will fail if not made via SSL or using SigV4. For information about configuring
- // using any of the officially supported Amazon Web Services SDKs and Amazon
- // Web Services CLI, see Specifying the Signature Version in Request Authentication
- // (https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingAWSSDK.html#specify-signature-version)
- // in the Amazon S3 User Guide.
- //
- // SSEKMSKeyId is a sensitive parameter and its value will be
- // replaced with "sensitive" in string returned by CopyObjectInput's
- // String and GoString methods.
- SSEKMSKeyId *string `location:"header" locationName:"x-amz-server-side-encryption-aws-kms-key-id" type:"string" sensitive:"true"`
- // The server-side encryption algorithm used when storing this object in Amazon
- // S3 (for example, AES256, aws:kms).
- ServerSideEncryption *string `location:"header" locationName:"x-amz-server-side-encryption" type:"string" enum:"ServerSideEncryption"`
- // By default, Amazon S3 uses the STANDARD Storage Class to store newly created
- // objects. The STANDARD storage class provides high durability and high availability.
- // Depending on performance needs, you can specify a different Storage Class.
- // Amazon S3 on Outposts only uses the OUTPOSTS Storage Class. For more information,
- // see Storage Classes (https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html)
- // in the Amazon S3 User Guide.
- StorageClass *string `location:"header" locationName:"x-amz-storage-class" type:"string" enum:"StorageClass"`
- // The tag-set for the object destination object this value must be used in
- // conjunction with the TaggingDirective. The tag-set must be encoded as URL
- // Query parameters.
- Tagging *string `location:"header" locationName:"x-amz-tagging" type:"string"`
- // Specifies whether the object tag-set are copied from the source object or
- // replaced with tag-set provided in the request.
- TaggingDirective *string `location:"header" locationName:"x-amz-tagging-directive" type:"string" enum:"TaggingDirective"`
- // If the bucket is configured as a website, redirects requests for this object
- // to another object in the same bucket or to an external URL. Amazon S3 stores
- // the value of this header in the object metadata.
- WebsiteRedirectLocation *string `location:"header" locationName:"x-amz-website-redirect-location" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s CopyObjectInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s CopyObjectInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *CopyObjectInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "CopyObjectInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.CopySource == nil {
- invalidParams.Add(request.NewErrParamRequired("CopySource"))
- }
- if s.Key == nil {
- invalidParams.Add(request.NewErrParamRequired("Key"))
- }
- if s.Key != nil && len(*s.Key) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Key", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetACL sets the ACL field's value.
- func (s *CopyObjectInput) SetACL(v string) *CopyObjectInput {
- s.ACL = &v
- return s
- }
- // SetBucket sets the Bucket field's value.
- func (s *CopyObjectInput) SetBucket(v string) *CopyObjectInput {
- s.Bucket = &v
- return s
- }
- func (s *CopyObjectInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetBucketKeyEnabled sets the BucketKeyEnabled field's value.
- func (s *CopyObjectInput) SetBucketKeyEnabled(v bool) *CopyObjectInput {
- s.BucketKeyEnabled = &v
- return s
- }
- // SetCacheControl sets the CacheControl field's value.
- func (s *CopyObjectInput) SetCacheControl(v string) *CopyObjectInput {
- s.CacheControl = &v
- return s
- }
- // SetChecksumAlgorithm sets the ChecksumAlgorithm field's value.
- func (s *CopyObjectInput) SetChecksumAlgorithm(v string) *CopyObjectInput {
- s.ChecksumAlgorithm = &v
- return s
- }
- // SetContentDisposition sets the ContentDisposition field's value.
- func (s *CopyObjectInput) SetContentDisposition(v string) *CopyObjectInput {
- s.ContentDisposition = &v
- return s
- }
- // SetContentEncoding sets the ContentEncoding field's value.
- func (s *CopyObjectInput) SetContentEncoding(v string) *CopyObjectInput {
- s.ContentEncoding = &v
- return s
- }
- // SetContentLanguage sets the ContentLanguage field's value.
- func (s *CopyObjectInput) SetContentLanguage(v string) *CopyObjectInput {
- s.ContentLanguage = &v
- return s
- }
- // SetContentType sets the ContentType field's value.
- func (s *CopyObjectInput) SetContentType(v string) *CopyObjectInput {
- s.ContentType = &v
- return s
- }
- // SetCopySource sets the CopySource field's value.
- func (s *CopyObjectInput) SetCopySource(v string) *CopyObjectInput {
- s.CopySource = &v
- return s
- }
- // SetCopySourceIfMatch sets the CopySourceIfMatch field's value.
- func (s *CopyObjectInput) SetCopySourceIfMatch(v string) *CopyObjectInput {
- s.CopySourceIfMatch = &v
- return s
- }
- // SetCopySourceIfModifiedSince sets the CopySourceIfModifiedSince field's value.
- func (s *CopyObjectInput) SetCopySourceIfModifiedSince(v time.Time) *CopyObjectInput {
- s.CopySourceIfModifiedSince = &v
- return s
- }
- // SetCopySourceIfNoneMatch sets the CopySourceIfNoneMatch field's value.
- func (s *CopyObjectInput) SetCopySourceIfNoneMatch(v string) *CopyObjectInput {
- s.CopySourceIfNoneMatch = &v
- return s
- }
- // SetCopySourceIfUnmodifiedSince sets the CopySourceIfUnmodifiedSince field's value.
- func (s *CopyObjectInput) SetCopySourceIfUnmodifiedSince(v time.Time) *CopyObjectInput {
- s.CopySourceIfUnmodifiedSince = &v
- return s
- }
- // SetCopySourceSSECustomerAlgorithm sets the CopySourceSSECustomerAlgorithm field's value.
- func (s *CopyObjectInput) SetCopySourceSSECustomerAlgorithm(v string) *CopyObjectInput {
- s.CopySourceSSECustomerAlgorithm = &v
- return s
- }
- // SetCopySourceSSECustomerKey sets the CopySourceSSECustomerKey field's value.
- func (s *CopyObjectInput) SetCopySourceSSECustomerKey(v string) *CopyObjectInput {
- s.CopySourceSSECustomerKey = &v
- return s
- }
- func (s *CopyObjectInput) getCopySourceSSECustomerKey() (v string) {
- if s.CopySourceSSECustomerKey == nil {
- return v
- }
- return *s.CopySourceSSECustomerKey
- }
- // SetCopySourceSSECustomerKeyMD5 sets the CopySourceSSECustomerKeyMD5 field's value.
- func (s *CopyObjectInput) SetCopySourceSSECustomerKeyMD5(v string) *CopyObjectInput {
- s.CopySourceSSECustomerKeyMD5 = &v
- return s
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *CopyObjectInput) SetExpectedBucketOwner(v string) *CopyObjectInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetExpectedSourceBucketOwner sets the ExpectedSourceBucketOwner field's value.
- func (s *CopyObjectInput) SetExpectedSourceBucketOwner(v string) *CopyObjectInput {
- s.ExpectedSourceBucketOwner = &v
- return s
- }
- // SetExpires sets the Expires field's value.
- func (s *CopyObjectInput) SetExpires(v time.Time) *CopyObjectInput {
- s.Expires = &v
- return s
- }
- // SetGrantFullControl sets the GrantFullControl field's value.
- func (s *CopyObjectInput) SetGrantFullControl(v string) *CopyObjectInput {
- s.GrantFullControl = &v
- return s
- }
- // SetGrantRead sets the GrantRead field's value.
- func (s *CopyObjectInput) SetGrantRead(v string) *CopyObjectInput {
- s.GrantRead = &v
- return s
- }
- // SetGrantReadACP sets the GrantReadACP field's value.
- func (s *CopyObjectInput) SetGrantReadACP(v string) *CopyObjectInput {
- s.GrantReadACP = &v
- return s
- }
- // SetGrantWriteACP sets the GrantWriteACP field's value.
- func (s *CopyObjectInput) SetGrantWriteACP(v string) *CopyObjectInput {
- s.GrantWriteACP = &v
- return s
- }
- // SetKey sets the Key field's value.
- func (s *CopyObjectInput) SetKey(v string) *CopyObjectInput {
- s.Key = &v
- return s
- }
- // SetMetadata sets the Metadata field's value.
- func (s *CopyObjectInput) SetMetadata(v map[string]*string) *CopyObjectInput {
- s.Metadata = v
- return s
- }
- // SetMetadataDirective sets the MetadataDirective field's value.
- func (s *CopyObjectInput) SetMetadataDirective(v string) *CopyObjectInput {
- s.MetadataDirective = &v
- return s
- }
- // SetObjectLockLegalHoldStatus sets the ObjectLockLegalHoldStatus field's value.
- func (s *CopyObjectInput) SetObjectLockLegalHoldStatus(v string) *CopyObjectInput {
- s.ObjectLockLegalHoldStatus = &v
- return s
- }
- // SetObjectLockMode sets the ObjectLockMode field's value.
- func (s *CopyObjectInput) SetObjectLockMode(v string) *CopyObjectInput {
- s.ObjectLockMode = &v
- return s
- }
- // SetObjectLockRetainUntilDate sets the ObjectLockRetainUntilDate field's value.
- func (s *CopyObjectInput) SetObjectLockRetainUntilDate(v time.Time) *CopyObjectInput {
- s.ObjectLockRetainUntilDate = &v
- return s
- }
- // SetRequestPayer sets the RequestPayer field's value.
- func (s *CopyObjectInput) SetRequestPayer(v string) *CopyObjectInput {
- s.RequestPayer = &v
- return s
- }
- // SetSSECustomerAlgorithm sets the SSECustomerAlgorithm field's value.
- func (s *CopyObjectInput) SetSSECustomerAlgorithm(v string) *CopyObjectInput {
- s.SSECustomerAlgorithm = &v
- return s
- }
- // SetSSECustomerKey sets the SSECustomerKey field's value.
- func (s *CopyObjectInput) SetSSECustomerKey(v string) *CopyObjectInput {
- s.SSECustomerKey = &v
- return s
- }
- func (s *CopyObjectInput) getSSECustomerKey() (v string) {
- if s.SSECustomerKey == nil {
- return v
- }
- return *s.SSECustomerKey
- }
- // SetSSECustomerKeyMD5 sets the SSECustomerKeyMD5 field's value.
- func (s *CopyObjectInput) SetSSECustomerKeyMD5(v string) *CopyObjectInput {
- s.SSECustomerKeyMD5 = &v
- return s
- }
- // SetSSEKMSEncryptionContext sets the SSEKMSEncryptionContext field's value.
- func (s *CopyObjectInput) SetSSEKMSEncryptionContext(v string) *CopyObjectInput {
- s.SSEKMSEncryptionContext = &v
- return s
- }
- // SetSSEKMSKeyId sets the SSEKMSKeyId field's value.
- func (s *CopyObjectInput) SetSSEKMSKeyId(v string) *CopyObjectInput {
- s.SSEKMSKeyId = &v
- return s
- }
- // SetServerSideEncryption sets the ServerSideEncryption field's value.
- func (s *CopyObjectInput) SetServerSideEncryption(v string) *CopyObjectInput {
- s.ServerSideEncryption = &v
- return s
- }
- // SetStorageClass sets the StorageClass field's value.
- func (s *CopyObjectInput) SetStorageClass(v string) *CopyObjectInput {
- s.StorageClass = &v
- return s
- }
- // SetTagging sets the Tagging field's value.
- func (s *CopyObjectInput) SetTagging(v string) *CopyObjectInput {
- s.Tagging = &v
- return s
- }
- // SetTaggingDirective sets the TaggingDirective field's value.
- func (s *CopyObjectInput) SetTaggingDirective(v string) *CopyObjectInput {
- s.TaggingDirective = &v
- return s
- }
- // SetWebsiteRedirectLocation sets the WebsiteRedirectLocation field's value.
- func (s *CopyObjectInput) SetWebsiteRedirectLocation(v string) *CopyObjectInput {
- s.WebsiteRedirectLocation = &v
- return s
- }
- func (s *CopyObjectInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *CopyObjectInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s CopyObjectInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type CopyObjectOutput struct {
- _ struct{} `type:"structure" payload:"CopyObjectResult"`
- // Indicates whether the copied object uses an S3 Bucket Key for server-side
- // encryption with Amazon Web Services KMS (SSE-KMS).
- BucketKeyEnabled *bool `location:"header" locationName:"x-amz-server-side-encryption-bucket-key-enabled" type:"boolean"`
- // Container for all response elements.
- CopyObjectResult *CopyObjectResult `type:"structure"`
- // Version of the copied object in the destination bucket.
- CopySourceVersionId *string `location:"header" locationName:"x-amz-copy-source-version-id" type:"string"`
- // If the object expiration is configured, the response includes this header.
- Expiration *string `location:"header" locationName:"x-amz-expiration" type:"string"`
- // If present, indicates that the requester was successfully charged for the
- // request.
- RequestCharged *string `location:"header" locationName:"x-amz-request-charged" type:"string" enum:"RequestCharged"`
- // If server-side encryption with a customer-provided encryption key was requested,
- // the response will include this header confirming the encryption algorithm
- // used.
- SSECustomerAlgorithm *string `location:"header" locationName:"x-amz-server-side-encryption-customer-algorithm" type:"string"`
- // If server-side encryption with a customer-provided encryption key was requested,
- // the response will include this header to provide round-trip message integrity
- // verification of the customer-provided encryption key.
- SSECustomerKeyMD5 *string `location:"header" locationName:"x-amz-server-side-encryption-customer-key-MD5" type:"string"`
- // If present, specifies the Amazon Web Services KMS Encryption Context to use
- // for object encryption. The value of this header is a base64-encoded UTF-8
- // string holding JSON with the encryption context key-value pairs.
- //
- // SSEKMSEncryptionContext is a sensitive parameter and its value will be
- // replaced with "sensitive" in string returned by CopyObjectOutput's
- // String and GoString methods.
- SSEKMSEncryptionContext *string `location:"header" locationName:"x-amz-server-side-encryption-context" type:"string" sensitive:"true"`
- // If present, specifies the ID of the Amazon Web Services Key Management Service
- // (Amazon Web Services KMS) symmetric customer managed key that was used for
- // the object.
- //
- // SSEKMSKeyId is a sensitive parameter and its value will be
- // replaced with "sensitive" in string returned by CopyObjectOutput's
- // String and GoString methods.
- SSEKMSKeyId *string `location:"header" locationName:"x-amz-server-side-encryption-aws-kms-key-id" type:"string" sensitive:"true"`
- // The server-side encryption algorithm used when storing this object in Amazon
- // S3 (for example, AES256, aws:kms).
- ServerSideEncryption *string `location:"header" locationName:"x-amz-server-side-encryption" type:"string" enum:"ServerSideEncryption"`
- // Version ID of the newly created copy.
- VersionId *string `location:"header" locationName:"x-amz-version-id" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s CopyObjectOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s CopyObjectOutput) GoString() string {
- return s.String()
- }
- // SetBucketKeyEnabled sets the BucketKeyEnabled field's value.
- func (s *CopyObjectOutput) SetBucketKeyEnabled(v bool) *CopyObjectOutput {
- s.BucketKeyEnabled = &v
- return s
- }
- // SetCopyObjectResult sets the CopyObjectResult field's value.
- func (s *CopyObjectOutput) SetCopyObjectResult(v *CopyObjectResult) *CopyObjectOutput {
- s.CopyObjectResult = v
- return s
- }
- // SetCopySourceVersionId sets the CopySourceVersionId field's value.
- func (s *CopyObjectOutput) SetCopySourceVersionId(v string) *CopyObjectOutput {
- s.CopySourceVersionId = &v
- return s
- }
- // SetExpiration sets the Expiration field's value.
- func (s *CopyObjectOutput) SetExpiration(v string) *CopyObjectOutput {
- s.Expiration = &v
- return s
- }
- // SetRequestCharged sets the RequestCharged field's value.
- func (s *CopyObjectOutput) SetRequestCharged(v string) *CopyObjectOutput {
- s.RequestCharged = &v
- return s
- }
- // SetSSECustomerAlgorithm sets the SSECustomerAlgorithm field's value.
- func (s *CopyObjectOutput) SetSSECustomerAlgorithm(v string) *CopyObjectOutput {
- s.SSECustomerAlgorithm = &v
- return s
- }
- // SetSSECustomerKeyMD5 sets the SSECustomerKeyMD5 field's value.
- func (s *CopyObjectOutput) SetSSECustomerKeyMD5(v string) *CopyObjectOutput {
- s.SSECustomerKeyMD5 = &v
- return s
- }
- // SetSSEKMSEncryptionContext sets the SSEKMSEncryptionContext field's value.
- func (s *CopyObjectOutput) SetSSEKMSEncryptionContext(v string) *CopyObjectOutput {
- s.SSEKMSEncryptionContext = &v
- return s
- }
- // SetSSEKMSKeyId sets the SSEKMSKeyId field's value.
- func (s *CopyObjectOutput) SetSSEKMSKeyId(v string) *CopyObjectOutput {
- s.SSEKMSKeyId = &v
- return s
- }
- // SetServerSideEncryption sets the ServerSideEncryption field's value.
- func (s *CopyObjectOutput) SetServerSideEncryption(v string) *CopyObjectOutput {
- s.ServerSideEncryption = &v
- return s
- }
- // SetVersionId sets the VersionId field's value.
- func (s *CopyObjectOutput) SetVersionId(v string) *CopyObjectOutput {
- s.VersionId = &v
- return s
- }
- // Container for all response elements.
- type CopyObjectResult struct {
- _ struct{} `type:"structure"`
- // The base64-encoded, 32-bit CRC32 checksum of the object. This will only be
- // present if it was uploaded with the object. With multipart uploads, this
- // may not be a checksum value of the object. For more information about how
- // checksums are calculated with multipart uploads, see Checking object integrity
- // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
- // in the Amazon S3 User Guide.
- ChecksumCRC32 *string `type:"string"`
- // The base64-encoded, 32-bit CRC32C checksum of the object. This will only
- // be present if it was uploaded with the object. With multipart uploads, this
- // may not be a checksum value of the object. For more information about how
- // checksums are calculated with multipart uploads, see Checking object integrity
- // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
- // in the Amazon S3 User Guide.
- ChecksumCRC32C *string `type:"string"`
- // The base64-encoded, 160-bit SHA-1 digest of the object. This will only be
- // present if it was uploaded with the object. With multipart uploads, this
- // may not be a checksum value of the object. For more information about how
- // checksums are calculated with multipart uploads, see Checking object integrity
- // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
- // in the Amazon S3 User Guide.
- ChecksumSHA1 *string `type:"string"`
- // The base64-encoded, 256-bit SHA-256 digest of the object. This will only
- // be present if it was uploaded with the object. With multipart uploads, this
- // may not be a checksum value of the object. For more information about how
- // checksums are calculated with multipart uploads, see Checking object integrity
- // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
- // in the Amazon S3 User Guide.
- ChecksumSHA256 *string `type:"string"`
- // Returns the ETag of the new object. The ETag reflects only changes to the
- // contents of an object, not its metadata.
- ETag *string `type:"string"`
- // Creation date of the object.
- LastModified *time.Time `type:"timestamp"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s CopyObjectResult) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s CopyObjectResult) GoString() string {
- return s.String()
- }
- // SetChecksumCRC32 sets the ChecksumCRC32 field's value.
- func (s *CopyObjectResult) SetChecksumCRC32(v string) *CopyObjectResult {
- s.ChecksumCRC32 = &v
- return s
- }
- // SetChecksumCRC32C sets the ChecksumCRC32C field's value.
- func (s *CopyObjectResult) SetChecksumCRC32C(v string) *CopyObjectResult {
- s.ChecksumCRC32C = &v
- return s
- }
- // SetChecksumSHA1 sets the ChecksumSHA1 field's value.
- func (s *CopyObjectResult) SetChecksumSHA1(v string) *CopyObjectResult {
- s.ChecksumSHA1 = &v
- return s
- }
- // SetChecksumSHA256 sets the ChecksumSHA256 field's value.
- func (s *CopyObjectResult) SetChecksumSHA256(v string) *CopyObjectResult {
- s.ChecksumSHA256 = &v
- return s
- }
- // SetETag sets the ETag field's value.
- func (s *CopyObjectResult) SetETag(v string) *CopyObjectResult {
- s.ETag = &v
- return s
- }
- // SetLastModified sets the LastModified field's value.
- func (s *CopyObjectResult) SetLastModified(v time.Time) *CopyObjectResult {
- s.LastModified = &v
- return s
- }
- // Container for all response elements.
- type CopyPartResult struct {
- _ struct{} `type:"structure"`
- // The base64-encoded, 32-bit CRC32 checksum of the object. This will only be
- // present if it was uploaded with the object. With multipart uploads, this
- // may not be a checksum value of the object. For more information about how
- // checksums are calculated with multipart uploads, see Checking object integrity
- // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
- // in the Amazon S3 User Guide.
- ChecksumCRC32 *string `type:"string"`
- // The base64-encoded, 32-bit CRC32C checksum of the object. This will only
- // be present if it was uploaded with the object. With multipart uploads, this
- // may not be a checksum value of the object. For more information about how
- // checksums are calculated with multipart uploads, see Checking object integrity
- // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
- // in the Amazon S3 User Guide.
- ChecksumCRC32C *string `type:"string"`
- // The base64-encoded, 160-bit SHA-1 digest of the object. This will only be
- // present if it was uploaded with the object. With multipart uploads, this
- // may not be a checksum value of the object. For more information about how
- // checksums are calculated with multipart uploads, see Checking object integrity
- // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
- // in the Amazon S3 User Guide.
- ChecksumSHA1 *string `type:"string"`
- // The base64-encoded, 256-bit SHA-256 digest of the object. This will only
- // be present if it was uploaded with the object. With multipart uploads, this
- // may not be a checksum value of the object. For more information about how
- // checksums are calculated with multipart uploads, see Checking object integrity
- // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
- // in the Amazon S3 User Guide.
- ChecksumSHA256 *string `type:"string"`
- // Entity tag of the object.
- ETag *string `type:"string"`
- // Date and time at which the object was uploaded.
- LastModified *time.Time `type:"timestamp"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s CopyPartResult) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s CopyPartResult) GoString() string {
- return s.String()
- }
- // SetChecksumCRC32 sets the ChecksumCRC32 field's value.
- func (s *CopyPartResult) SetChecksumCRC32(v string) *CopyPartResult {
- s.ChecksumCRC32 = &v
- return s
- }
- // SetChecksumCRC32C sets the ChecksumCRC32C field's value.
- func (s *CopyPartResult) SetChecksumCRC32C(v string) *CopyPartResult {
- s.ChecksumCRC32C = &v
- return s
- }
- // SetChecksumSHA1 sets the ChecksumSHA1 field's value.
- func (s *CopyPartResult) SetChecksumSHA1(v string) *CopyPartResult {
- s.ChecksumSHA1 = &v
- return s
- }
- // SetChecksumSHA256 sets the ChecksumSHA256 field's value.
- func (s *CopyPartResult) SetChecksumSHA256(v string) *CopyPartResult {
- s.ChecksumSHA256 = &v
- return s
- }
- // SetETag sets the ETag field's value.
- func (s *CopyPartResult) SetETag(v string) *CopyPartResult {
- s.ETag = &v
- return s
- }
- // SetLastModified sets the LastModified field's value.
- func (s *CopyPartResult) SetLastModified(v time.Time) *CopyPartResult {
- s.LastModified = &v
- return s
- }
- // The configuration information for the bucket.
- type CreateBucketConfiguration struct {
- _ struct{} `type:"structure"`
- // Specifies the Region where the bucket will be created. If you don't specify
- // a Region, the bucket is created in the US East (N. Virginia) Region (us-east-1).
- LocationConstraint *string `type:"string" enum:"BucketLocationConstraint"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s CreateBucketConfiguration) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s CreateBucketConfiguration) GoString() string {
- return s.String()
- }
- // SetLocationConstraint sets the LocationConstraint field's value.
- func (s *CreateBucketConfiguration) SetLocationConstraint(v string) *CreateBucketConfiguration {
- s.LocationConstraint = &v
- return s
- }
- type CreateBucketInput struct {
- _ struct{} `locationName:"CreateBucketRequest" type:"structure" payload:"CreateBucketConfiguration"`
- // The canned ACL to apply to the bucket.
- ACL *string `location:"header" locationName:"x-amz-acl" type:"string" enum:"BucketCannedACL"`
- // The name of the bucket to create.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The configuration information for the bucket.
- CreateBucketConfiguration *CreateBucketConfiguration `locationName:"CreateBucketConfiguration" type:"structure" xmlURI:"http://s3.amazonaws.com/doc/2006-03-01/"`
- // Allows grantee the read, write, read ACP, and write ACP permissions on the
- // bucket.
- GrantFullControl *string `location:"header" locationName:"x-amz-grant-full-control" type:"string"`
- // Allows grantee to list the objects in the bucket.
- GrantRead *string `location:"header" locationName:"x-amz-grant-read" type:"string"`
- // Allows grantee to read the bucket ACL.
- GrantReadACP *string `location:"header" locationName:"x-amz-grant-read-acp" type:"string"`
- // Allows grantee to create new objects in the bucket.
- //
- // For the bucket and object owners of existing objects, also allows deletions
- // and overwrites of those objects.
- GrantWrite *string `location:"header" locationName:"x-amz-grant-write" type:"string"`
- // Allows grantee to write the ACL for the applicable bucket.
- GrantWriteACP *string `location:"header" locationName:"x-amz-grant-write-acp" type:"string"`
- // Specifies whether you want S3 Object Lock to be enabled for the new bucket.
- ObjectLockEnabledForBucket *bool `location:"header" locationName:"x-amz-bucket-object-lock-enabled" type:"boolean"`
- // The container element for object ownership for a bucket's ownership controls.
- //
- // BucketOwnerPreferred - Objects uploaded to the bucket change ownership to
- // the bucket owner if the objects are uploaded with the bucket-owner-full-control
- // canned ACL.
- //
- // ObjectWriter - The uploading account will own the object if the object is
- // uploaded with the bucket-owner-full-control canned ACL.
- //
- // BucketOwnerEnforced - Access control lists (ACLs) are disabled and no longer
- // affect permissions. The bucket owner automatically owns and has full control
- // over every object in the bucket. The bucket only accepts PUT requests that
- // don't specify an ACL or bucket owner full control ACLs, such as the bucket-owner-full-control
- // canned ACL or an equivalent form of this ACL expressed in the XML format.
- ObjectOwnership *string `location:"header" locationName:"x-amz-object-ownership" type:"string" enum:"ObjectOwnership"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s CreateBucketInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s CreateBucketInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *CreateBucketInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "CreateBucketInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetACL sets the ACL field's value.
- func (s *CreateBucketInput) SetACL(v string) *CreateBucketInput {
- s.ACL = &v
- return s
- }
- // SetBucket sets the Bucket field's value.
- func (s *CreateBucketInput) SetBucket(v string) *CreateBucketInput {
- s.Bucket = &v
- return s
- }
- func (s *CreateBucketInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetCreateBucketConfiguration sets the CreateBucketConfiguration field's value.
- func (s *CreateBucketInput) SetCreateBucketConfiguration(v *CreateBucketConfiguration) *CreateBucketInput {
- s.CreateBucketConfiguration = v
- return s
- }
- // SetGrantFullControl sets the GrantFullControl field's value.
- func (s *CreateBucketInput) SetGrantFullControl(v string) *CreateBucketInput {
- s.GrantFullControl = &v
- return s
- }
- // SetGrantRead sets the GrantRead field's value.
- func (s *CreateBucketInput) SetGrantRead(v string) *CreateBucketInput {
- s.GrantRead = &v
- return s
- }
- // SetGrantReadACP sets the GrantReadACP field's value.
- func (s *CreateBucketInput) SetGrantReadACP(v string) *CreateBucketInput {
- s.GrantReadACP = &v
- return s
- }
- // SetGrantWrite sets the GrantWrite field's value.
- func (s *CreateBucketInput) SetGrantWrite(v string) *CreateBucketInput {
- s.GrantWrite = &v
- return s
- }
- // SetGrantWriteACP sets the GrantWriteACP field's value.
- func (s *CreateBucketInput) SetGrantWriteACP(v string) *CreateBucketInput {
- s.GrantWriteACP = &v
- return s
- }
- // SetObjectLockEnabledForBucket sets the ObjectLockEnabledForBucket field's value.
- func (s *CreateBucketInput) SetObjectLockEnabledForBucket(v bool) *CreateBucketInput {
- s.ObjectLockEnabledForBucket = &v
- return s
- }
- // SetObjectOwnership sets the ObjectOwnership field's value.
- func (s *CreateBucketInput) SetObjectOwnership(v string) *CreateBucketInput {
- s.ObjectOwnership = &v
- return s
- }
- type CreateBucketOutput struct {
- _ struct{} `type:"structure"`
- // A forward slash followed by the name of the bucket.
- Location *string `location:"header" locationName:"Location" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s CreateBucketOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s CreateBucketOutput) GoString() string {
- return s.String()
- }
- // SetLocation sets the Location field's value.
- func (s *CreateBucketOutput) SetLocation(v string) *CreateBucketOutput {
- s.Location = &v
- return s
- }
- type CreateMultipartUploadInput struct {
- _ struct{} `locationName:"CreateMultipartUploadRequest" type:"structure"`
- // The canned ACL to apply to the object.
- //
- // This action is not supported by Amazon S3 on Outposts.
- ACL *string `location:"header" locationName:"x-amz-acl" type:"string" enum:"ObjectCannedACL"`
- // The name of the bucket to which to initiate the upload
- //
- // When using this action with an access point, you must direct requests to
- // the access point hostname. The access point hostname takes the form AccessPointName-AccountId.s3-accesspoint.Region.amazonaws.com.
- // When using this action with an access point through the Amazon Web Services
- // SDKs, you provide the access point ARN in place of the bucket name. For more
- // information about access point ARNs, see Using access points (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html)
- // in the Amazon S3 User Guide.
- //
- // When using this action with Amazon S3 on Outposts, you must direct requests
- // to the S3 on Outposts hostname. The S3 on Outposts hostname takes the form
- // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When
- // using this action with S3 on Outposts through the Amazon Web Services SDKs,
- // you provide the Outposts bucket ARN in place of the bucket name. For more
- // information about S3 on Outposts ARNs, see Using Amazon S3 on Outposts (https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html)
- // in the Amazon S3 User Guide.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // Specifies whether Amazon S3 should use an S3 Bucket Key for object encryption
- // with server-side encryption using AWS KMS (SSE-KMS). Setting this header
- // to true causes Amazon S3 to use an S3 Bucket Key for object encryption with
- // SSE-KMS.
- //
- // Specifying this header with an object action doesn’t affect bucket-level
- // settings for S3 Bucket Key.
- BucketKeyEnabled *bool `location:"header" locationName:"x-amz-server-side-encryption-bucket-key-enabled" type:"boolean"`
- // Specifies caching behavior along the request/reply chain.
- CacheControl *string `location:"header" locationName:"Cache-Control" type:"string"`
- // Indicates the algorithm you want Amazon S3 to use to create the checksum
- // for the object. For more information, see Checking object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
- // in the Amazon S3 User Guide.
- ChecksumAlgorithm *string `location:"header" locationName:"x-amz-checksum-algorithm" type:"string" enum:"ChecksumAlgorithm"`
- // Specifies presentational information for the object.
- ContentDisposition *string `location:"header" locationName:"Content-Disposition" type:"string"`
- // Specifies what content encodings have been applied to the object and thus
- // what decoding mechanisms must be applied to obtain the media-type referenced
- // by the Content-Type header field.
- ContentEncoding *string `location:"header" locationName:"Content-Encoding" type:"string"`
- // The language the content is in.
- ContentLanguage *string `location:"header" locationName:"Content-Language" type:"string"`
- // A standard MIME type describing the format of the object data.
- ContentType *string `location:"header" locationName:"Content-Type" type:"string"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // The date and time at which the object is no longer cacheable.
- Expires *time.Time `location:"header" locationName:"Expires" type:"timestamp"`
- // Gives the grantee READ, READ_ACP, and WRITE_ACP permissions on the object.
- //
- // This action is not supported by Amazon S3 on Outposts.
- GrantFullControl *string `location:"header" locationName:"x-amz-grant-full-control" type:"string"`
- // Allows grantee to read the object data and its metadata.
- //
- // This action is not supported by Amazon S3 on Outposts.
- GrantRead *string `location:"header" locationName:"x-amz-grant-read" type:"string"`
- // Allows grantee to read the object ACL.
- //
- // This action is not supported by Amazon S3 on Outposts.
- GrantReadACP *string `location:"header" locationName:"x-amz-grant-read-acp" type:"string"`
- // Allows grantee to write the ACL for the applicable object.
- //
- // This action is not supported by Amazon S3 on Outposts.
- GrantWriteACP *string `location:"header" locationName:"x-amz-grant-write-acp" type:"string"`
- // Object key for which the multipart upload is to be initiated.
- //
- // Key is a required field
- Key *string `location:"uri" locationName:"Key" min:"1" type:"string" required:"true"`
- // A map of metadata to store with the object in S3.
- Metadata map[string]*string `location:"headers" locationName:"x-amz-meta-" type:"map"`
- // Specifies whether you want to apply a legal hold to the uploaded object.
- ObjectLockLegalHoldStatus *string `location:"header" locationName:"x-amz-object-lock-legal-hold" type:"string" enum:"ObjectLockLegalHoldStatus"`
- // Specifies the Object Lock mode that you want to apply to the uploaded object.
- ObjectLockMode *string `location:"header" locationName:"x-amz-object-lock-mode" type:"string" enum:"ObjectLockMode"`
- // Specifies the date and time when you want the Object Lock to expire.
- ObjectLockRetainUntilDate *time.Time `location:"header" locationName:"x-amz-object-lock-retain-until-date" type:"timestamp" timestampFormat:"iso8601"`
- // Confirms that the requester knows that they will be charged for the request.
- // Bucket owners need not specify this parameter in their requests. For information
- // about downloading objects from Requester Pays buckets, see Downloading Objects
- // in Requester Pays Buckets (https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html)
- // in the Amazon S3 User Guide.
- RequestPayer *string `location:"header" locationName:"x-amz-request-payer" type:"string" enum:"RequestPayer"`
- // Specifies the algorithm to use to when encrypting the object (for example,
- // AES256).
- SSECustomerAlgorithm *string `location:"header" locationName:"x-amz-server-side-encryption-customer-algorithm" type:"string"`
- // Specifies the customer-provided encryption key for Amazon S3 to use in encrypting
- // data. This value is used to store the object and then it is discarded; Amazon
- // S3 does not store the encryption key. The key must be appropriate for use
- // with the algorithm specified in the x-amz-server-side-encryption-customer-algorithm
- // header.
- //
- // SSECustomerKey is a sensitive parameter and its value will be
- // replaced with "sensitive" in string returned by CreateMultipartUploadInput's
- // String and GoString methods.
- SSECustomerKey *string `marshal-as:"blob" location:"header" locationName:"x-amz-server-side-encryption-customer-key" type:"string" sensitive:"true"`
- // Specifies the 128-bit MD5 digest of the encryption key according to RFC 1321.
- // Amazon S3 uses this header for a message integrity check to ensure that the
- // encryption key was transmitted without error.
- SSECustomerKeyMD5 *string `location:"header" locationName:"x-amz-server-side-encryption-customer-key-MD5" type:"string"`
- // Specifies the Amazon Web Services KMS Encryption Context to use for object
- // encryption. The value of this header is a base64-encoded UTF-8 string holding
- // JSON with the encryption context key-value pairs.
- //
- // SSEKMSEncryptionContext is a sensitive parameter and its value will be
- // replaced with "sensitive" in string returned by CreateMultipartUploadInput's
- // String and GoString methods.
- SSEKMSEncryptionContext *string `location:"header" locationName:"x-amz-server-side-encryption-context" type:"string" sensitive:"true"`
- // Specifies the ID of the symmetric customer managed key to use for object
- // encryption. All GET and PUT requests for an object protected by Amazon Web
- // Services KMS will fail if not made via SSL or using SigV4. For information
- // about configuring using any of the officially supported Amazon Web Services
- // SDKs and Amazon Web Services CLI, see Specifying the Signature Version in
- // Request Authentication (https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingAWSSDK.html#specify-signature-version)
- // in the Amazon S3 User Guide.
- //
- // SSEKMSKeyId is a sensitive parameter and its value will be
- // replaced with "sensitive" in string returned by CreateMultipartUploadInput's
- // String and GoString methods.
- SSEKMSKeyId *string `location:"header" locationName:"x-amz-server-side-encryption-aws-kms-key-id" type:"string" sensitive:"true"`
- // The server-side encryption algorithm used when storing this object in Amazon
- // S3 (for example, AES256, aws:kms).
- ServerSideEncryption *string `location:"header" locationName:"x-amz-server-side-encryption" type:"string" enum:"ServerSideEncryption"`
- // By default, Amazon S3 uses the STANDARD Storage Class to store newly created
- // objects. The STANDARD storage class provides high durability and high availability.
- // Depending on performance needs, you can specify a different Storage Class.
- // Amazon S3 on Outposts only uses the OUTPOSTS Storage Class. For more information,
- // see Storage Classes (https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html)
- // in the Amazon S3 User Guide.
- StorageClass *string `location:"header" locationName:"x-amz-storage-class" type:"string" enum:"StorageClass"`
- // The tag-set for the object. The tag-set must be encoded as URL Query parameters.
- Tagging *string `location:"header" locationName:"x-amz-tagging" type:"string"`
- // If the bucket is configured as a website, redirects requests for this object
- // to another object in the same bucket or to an external URL. Amazon S3 stores
- // the value of this header in the object metadata.
- WebsiteRedirectLocation *string `location:"header" locationName:"x-amz-website-redirect-location" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s CreateMultipartUploadInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s CreateMultipartUploadInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *CreateMultipartUploadInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "CreateMultipartUploadInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.Key == nil {
- invalidParams.Add(request.NewErrParamRequired("Key"))
- }
- if s.Key != nil && len(*s.Key) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Key", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetACL sets the ACL field's value.
- func (s *CreateMultipartUploadInput) SetACL(v string) *CreateMultipartUploadInput {
- s.ACL = &v
- return s
- }
- // SetBucket sets the Bucket field's value.
- func (s *CreateMultipartUploadInput) SetBucket(v string) *CreateMultipartUploadInput {
- s.Bucket = &v
- return s
- }
- func (s *CreateMultipartUploadInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetBucketKeyEnabled sets the BucketKeyEnabled field's value.
- func (s *CreateMultipartUploadInput) SetBucketKeyEnabled(v bool) *CreateMultipartUploadInput {
- s.BucketKeyEnabled = &v
- return s
- }
- // SetCacheControl sets the CacheControl field's value.
- func (s *CreateMultipartUploadInput) SetCacheControl(v string) *CreateMultipartUploadInput {
- s.CacheControl = &v
- return s
- }
- // SetChecksumAlgorithm sets the ChecksumAlgorithm field's value.
- func (s *CreateMultipartUploadInput) SetChecksumAlgorithm(v string) *CreateMultipartUploadInput {
- s.ChecksumAlgorithm = &v
- return s
- }
- // SetContentDisposition sets the ContentDisposition field's value.
- func (s *CreateMultipartUploadInput) SetContentDisposition(v string) *CreateMultipartUploadInput {
- s.ContentDisposition = &v
- return s
- }
- // SetContentEncoding sets the ContentEncoding field's value.
- func (s *CreateMultipartUploadInput) SetContentEncoding(v string) *CreateMultipartUploadInput {
- s.ContentEncoding = &v
- return s
- }
- // SetContentLanguage sets the ContentLanguage field's value.
- func (s *CreateMultipartUploadInput) SetContentLanguage(v string) *CreateMultipartUploadInput {
- s.ContentLanguage = &v
- return s
- }
- // SetContentType sets the ContentType field's value.
- func (s *CreateMultipartUploadInput) SetContentType(v string) *CreateMultipartUploadInput {
- s.ContentType = &v
- return s
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *CreateMultipartUploadInput) SetExpectedBucketOwner(v string) *CreateMultipartUploadInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetExpires sets the Expires field's value.
- func (s *CreateMultipartUploadInput) SetExpires(v time.Time) *CreateMultipartUploadInput {
- s.Expires = &v
- return s
- }
- // SetGrantFullControl sets the GrantFullControl field's value.
- func (s *CreateMultipartUploadInput) SetGrantFullControl(v string) *CreateMultipartUploadInput {
- s.GrantFullControl = &v
- return s
- }
- // SetGrantRead sets the GrantRead field's value.
- func (s *CreateMultipartUploadInput) SetGrantRead(v string) *CreateMultipartUploadInput {
- s.GrantRead = &v
- return s
- }
- // SetGrantReadACP sets the GrantReadACP field's value.
- func (s *CreateMultipartUploadInput) SetGrantReadACP(v string) *CreateMultipartUploadInput {
- s.GrantReadACP = &v
- return s
- }
- // SetGrantWriteACP sets the GrantWriteACP field's value.
- func (s *CreateMultipartUploadInput) SetGrantWriteACP(v string) *CreateMultipartUploadInput {
- s.GrantWriteACP = &v
- return s
- }
- // SetKey sets the Key field's value.
- func (s *CreateMultipartUploadInput) SetKey(v string) *CreateMultipartUploadInput {
- s.Key = &v
- return s
- }
- // SetMetadata sets the Metadata field's value.
- func (s *CreateMultipartUploadInput) SetMetadata(v map[string]*string) *CreateMultipartUploadInput {
- s.Metadata = v
- return s
- }
- // SetObjectLockLegalHoldStatus sets the ObjectLockLegalHoldStatus field's value.
- func (s *CreateMultipartUploadInput) SetObjectLockLegalHoldStatus(v string) *CreateMultipartUploadInput {
- s.ObjectLockLegalHoldStatus = &v
- return s
- }
- // SetObjectLockMode sets the ObjectLockMode field's value.
- func (s *CreateMultipartUploadInput) SetObjectLockMode(v string) *CreateMultipartUploadInput {
- s.ObjectLockMode = &v
- return s
- }
- // SetObjectLockRetainUntilDate sets the ObjectLockRetainUntilDate field's value.
- func (s *CreateMultipartUploadInput) SetObjectLockRetainUntilDate(v time.Time) *CreateMultipartUploadInput {
- s.ObjectLockRetainUntilDate = &v
- return s
- }
- // SetRequestPayer sets the RequestPayer field's value.
- func (s *CreateMultipartUploadInput) SetRequestPayer(v string) *CreateMultipartUploadInput {
- s.RequestPayer = &v
- return s
- }
- // SetSSECustomerAlgorithm sets the SSECustomerAlgorithm field's value.
- func (s *CreateMultipartUploadInput) SetSSECustomerAlgorithm(v string) *CreateMultipartUploadInput {
- s.SSECustomerAlgorithm = &v
- return s
- }
- // SetSSECustomerKey sets the SSECustomerKey field's value.
- func (s *CreateMultipartUploadInput) SetSSECustomerKey(v string) *CreateMultipartUploadInput {
- s.SSECustomerKey = &v
- return s
- }
- func (s *CreateMultipartUploadInput) getSSECustomerKey() (v string) {
- if s.SSECustomerKey == nil {
- return v
- }
- return *s.SSECustomerKey
- }
- // SetSSECustomerKeyMD5 sets the SSECustomerKeyMD5 field's value.
- func (s *CreateMultipartUploadInput) SetSSECustomerKeyMD5(v string) *CreateMultipartUploadInput {
- s.SSECustomerKeyMD5 = &v
- return s
- }
- // SetSSEKMSEncryptionContext sets the SSEKMSEncryptionContext field's value.
- func (s *CreateMultipartUploadInput) SetSSEKMSEncryptionContext(v string) *CreateMultipartUploadInput {
- s.SSEKMSEncryptionContext = &v
- return s
- }
- // SetSSEKMSKeyId sets the SSEKMSKeyId field's value.
- func (s *CreateMultipartUploadInput) SetSSEKMSKeyId(v string) *CreateMultipartUploadInput {
- s.SSEKMSKeyId = &v
- return s
- }
- // SetServerSideEncryption sets the ServerSideEncryption field's value.
- func (s *CreateMultipartUploadInput) SetServerSideEncryption(v string) *CreateMultipartUploadInput {
- s.ServerSideEncryption = &v
- return s
- }
- // SetStorageClass sets the StorageClass field's value.
- func (s *CreateMultipartUploadInput) SetStorageClass(v string) *CreateMultipartUploadInput {
- s.StorageClass = &v
- return s
- }
- // SetTagging sets the Tagging field's value.
- func (s *CreateMultipartUploadInput) SetTagging(v string) *CreateMultipartUploadInput {
- s.Tagging = &v
- return s
- }
- // SetWebsiteRedirectLocation sets the WebsiteRedirectLocation field's value.
- func (s *CreateMultipartUploadInput) SetWebsiteRedirectLocation(v string) *CreateMultipartUploadInput {
- s.WebsiteRedirectLocation = &v
- return s
- }
- func (s *CreateMultipartUploadInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *CreateMultipartUploadInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s CreateMultipartUploadInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type CreateMultipartUploadOutput struct {
- _ struct{} `type:"structure"`
- // If the bucket has a lifecycle rule configured with an action to abort incomplete
- // multipart uploads and the prefix in the lifecycle rule matches the object
- // name in the request, the response includes this header. The header indicates
- // when the initiated multipart upload becomes eligible for an abort operation.
- // For more information, see Aborting Incomplete Multipart Uploads Using a Bucket
- // Lifecycle Policy (https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html#mpu-abort-incomplete-mpu-lifecycle-config).
- //
- // The response also includes the x-amz-abort-rule-id header that provides the
- // ID of the lifecycle configuration rule that defines this action.
- AbortDate *time.Time `location:"header" locationName:"x-amz-abort-date" type:"timestamp"`
- // This header is returned along with the x-amz-abort-date header. It identifies
- // the applicable lifecycle configuration rule that defines the action to abort
- // incomplete multipart uploads.
- AbortRuleId *string `location:"header" locationName:"x-amz-abort-rule-id" type:"string"`
- // The name of the bucket to which the multipart upload was initiated. Does
- // not return the access point ARN or access point alias if used.
- //
- // When using this action with an access point, you must direct requests to
- // the access point hostname. The access point hostname takes the form AccessPointName-AccountId.s3-accesspoint.Region.amazonaws.com.
- // When using this action with an access point through the Amazon Web Services
- // SDKs, you provide the access point ARN in place of the bucket name. For more
- // information about access point ARNs, see Using access points (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html)
- // in the Amazon S3 User Guide.
- //
- // When using this action with Amazon S3 on Outposts, you must direct requests
- // to the S3 on Outposts hostname. The S3 on Outposts hostname takes the form
- // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When
- // using this action with S3 on Outposts through the Amazon Web Services SDKs,
- // you provide the Outposts bucket ARN in place of the bucket name. For more
- // information about S3 on Outposts ARNs, see Using Amazon S3 on Outposts (https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html)
- // in the Amazon S3 User Guide.
- Bucket *string `locationName:"Bucket" type:"string"`
- // Indicates whether the multipart upload uses an S3 Bucket Key for server-side
- // encryption with Amazon Web Services KMS (SSE-KMS).
- BucketKeyEnabled *bool `location:"header" locationName:"x-amz-server-side-encryption-bucket-key-enabled" type:"boolean"`
- // The algorithm that was used to create a checksum of the object.
- ChecksumAlgorithm *string `location:"header" locationName:"x-amz-checksum-algorithm" type:"string" enum:"ChecksumAlgorithm"`
- // Object key for which the multipart upload was initiated.
- Key *string `min:"1" type:"string"`
- // If present, indicates that the requester was successfully charged for the
- // request.
- RequestCharged *string `location:"header" locationName:"x-amz-request-charged" type:"string" enum:"RequestCharged"`
- // If server-side encryption with a customer-provided encryption key was requested,
- // the response will include this header confirming the encryption algorithm
- // used.
- SSECustomerAlgorithm *string `location:"header" locationName:"x-amz-server-side-encryption-customer-algorithm" type:"string"`
- // If server-side encryption with a customer-provided encryption key was requested,
- // the response will include this header to provide round-trip message integrity
- // verification of the customer-provided encryption key.
- SSECustomerKeyMD5 *string `location:"header" locationName:"x-amz-server-side-encryption-customer-key-MD5" type:"string"`
- // If present, specifies the Amazon Web Services KMS Encryption Context to use
- // for object encryption. The value of this header is a base64-encoded UTF-8
- // string holding JSON with the encryption context key-value pairs.
- //
- // SSEKMSEncryptionContext is a sensitive parameter and its value will be
- // replaced with "sensitive" in string returned by CreateMultipartUploadOutput's
- // String and GoString methods.
- SSEKMSEncryptionContext *string `location:"header" locationName:"x-amz-server-side-encryption-context" type:"string" sensitive:"true"`
- // If present, specifies the ID of the Amazon Web Services Key Management Service
- // (Amazon Web Services KMS) symmetric customer managed key that was used for
- // the object.
- //
- // SSEKMSKeyId is a sensitive parameter and its value will be
- // replaced with "sensitive" in string returned by CreateMultipartUploadOutput's
- // String and GoString methods.
- SSEKMSKeyId *string `location:"header" locationName:"x-amz-server-side-encryption-aws-kms-key-id" type:"string" sensitive:"true"`
- // The server-side encryption algorithm used when storing this object in Amazon
- // S3 (for example, AES256, aws:kms).
- ServerSideEncryption *string `location:"header" locationName:"x-amz-server-side-encryption" type:"string" enum:"ServerSideEncryption"`
- // ID for the initiated multipart upload.
- UploadId *string `type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s CreateMultipartUploadOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s CreateMultipartUploadOutput) GoString() string {
- return s.String()
- }
- // SetAbortDate sets the AbortDate field's value.
- func (s *CreateMultipartUploadOutput) SetAbortDate(v time.Time) *CreateMultipartUploadOutput {
- s.AbortDate = &v
- return s
- }
- // SetAbortRuleId sets the AbortRuleId field's value.
- func (s *CreateMultipartUploadOutput) SetAbortRuleId(v string) *CreateMultipartUploadOutput {
- s.AbortRuleId = &v
- return s
- }
- // SetBucket sets the Bucket field's value.
- func (s *CreateMultipartUploadOutput) SetBucket(v string) *CreateMultipartUploadOutput {
- s.Bucket = &v
- return s
- }
- func (s *CreateMultipartUploadOutput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetBucketKeyEnabled sets the BucketKeyEnabled field's value.
- func (s *CreateMultipartUploadOutput) SetBucketKeyEnabled(v bool) *CreateMultipartUploadOutput {
- s.BucketKeyEnabled = &v
- return s
- }
- // SetChecksumAlgorithm sets the ChecksumAlgorithm field's value.
- func (s *CreateMultipartUploadOutput) SetChecksumAlgorithm(v string) *CreateMultipartUploadOutput {
- s.ChecksumAlgorithm = &v
- return s
- }
- // SetKey sets the Key field's value.
- func (s *CreateMultipartUploadOutput) SetKey(v string) *CreateMultipartUploadOutput {
- s.Key = &v
- return s
- }
- // SetRequestCharged sets the RequestCharged field's value.
- func (s *CreateMultipartUploadOutput) SetRequestCharged(v string) *CreateMultipartUploadOutput {
- s.RequestCharged = &v
- return s
- }
- // SetSSECustomerAlgorithm sets the SSECustomerAlgorithm field's value.
- func (s *CreateMultipartUploadOutput) SetSSECustomerAlgorithm(v string) *CreateMultipartUploadOutput {
- s.SSECustomerAlgorithm = &v
- return s
- }
- // SetSSECustomerKeyMD5 sets the SSECustomerKeyMD5 field's value.
- func (s *CreateMultipartUploadOutput) SetSSECustomerKeyMD5(v string) *CreateMultipartUploadOutput {
- s.SSECustomerKeyMD5 = &v
- return s
- }
- // SetSSEKMSEncryptionContext sets the SSEKMSEncryptionContext field's value.
- func (s *CreateMultipartUploadOutput) SetSSEKMSEncryptionContext(v string) *CreateMultipartUploadOutput {
- s.SSEKMSEncryptionContext = &v
- return s
- }
- // SetSSEKMSKeyId sets the SSEKMSKeyId field's value.
- func (s *CreateMultipartUploadOutput) SetSSEKMSKeyId(v string) *CreateMultipartUploadOutput {
- s.SSEKMSKeyId = &v
- return s
- }
- // SetServerSideEncryption sets the ServerSideEncryption field's value.
- func (s *CreateMultipartUploadOutput) SetServerSideEncryption(v string) *CreateMultipartUploadOutput {
- s.ServerSideEncryption = &v
- return s
- }
- // SetUploadId sets the UploadId field's value.
- func (s *CreateMultipartUploadOutput) SetUploadId(v string) *CreateMultipartUploadOutput {
- s.UploadId = &v
- return s
- }
- // The container element for specifying the default Object Lock retention settings
- // for new objects placed in the specified bucket.
- //
- // - The DefaultRetention settings require both a mode and a period.
- //
- // - The DefaultRetention period can be either Days or Years but you must
- // select one. You cannot specify Days and Years at the same time.
- type DefaultRetention struct {
- _ struct{} `type:"structure"`
- // The number of days that you want to specify for the default retention period.
- // Must be used with Mode.
- Days *int64 `type:"integer"`
- // The default Object Lock retention mode you want to apply to new objects placed
- // in the specified bucket. Must be used with either Days or Years.
- Mode *string `type:"string" enum:"ObjectLockRetentionMode"`
- // The number of years that you want to specify for the default retention period.
- // Must be used with Mode.
- Years *int64 `type:"integer"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DefaultRetention) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DefaultRetention) GoString() string {
- return s.String()
- }
- // SetDays sets the Days field's value.
- func (s *DefaultRetention) SetDays(v int64) *DefaultRetention {
- s.Days = &v
- return s
- }
- // SetMode sets the Mode field's value.
- func (s *DefaultRetention) SetMode(v string) *DefaultRetention {
- s.Mode = &v
- return s
- }
- // SetYears sets the Years field's value.
- func (s *DefaultRetention) SetYears(v int64) *DefaultRetention {
- s.Years = &v
- return s
- }
- // Container for the objects to delete.
- type Delete struct {
- _ struct{} `type:"structure"`
- // The objects to delete.
- //
- // Objects is a required field
- Objects []*ObjectIdentifier `locationName:"Object" type:"list" flattened:"true" required:"true"`
- // Element to enable quiet mode for the request. When you add this element,
- // you must set its value to true.
- Quiet *bool `type:"boolean"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s Delete) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s Delete) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *Delete) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "Delete"}
- if s.Objects == nil {
- invalidParams.Add(request.NewErrParamRequired("Objects"))
- }
- if s.Objects != nil {
- for i, v := range s.Objects {
- if v == nil {
- continue
- }
- if err := v.Validate(); err != nil {
- invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Objects", i), err.(request.ErrInvalidParams))
- }
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetObjects sets the Objects field's value.
- func (s *Delete) SetObjects(v []*ObjectIdentifier) *Delete {
- s.Objects = v
- return s
- }
- // SetQuiet sets the Quiet field's value.
- func (s *Delete) SetQuiet(v bool) *Delete {
- s.Quiet = &v
- return s
- }
- type DeleteBucketAnalyticsConfigurationInput struct {
- _ struct{} `locationName:"DeleteBucketAnalyticsConfigurationRequest" type:"structure"`
- // The name of the bucket from which an analytics configuration is deleted.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // The ID that identifies the analytics configuration.
- //
- // Id is a required field
- Id *string `location:"querystring" locationName:"id" type:"string" required:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteBucketAnalyticsConfigurationInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteBucketAnalyticsConfigurationInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *DeleteBucketAnalyticsConfigurationInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "DeleteBucketAnalyticsConfigurationInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.Id == nil {
- invalidParams.Add(request.NewErrParamRequired("Id"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *DeleteBucketAnalyticsConfigurationInput) SetBucket(v string) *DeleteBucketAnalyticsConfigurationInput {
- s.Bucket = &v
- return s
- }
- func (s *DeleteBucketAnalyticsConfigurationInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *DeleteBucketAnalyticsConfigurationInput) SetExpectedBucketOwner(v string) *DeleteBucketAnalyticsConfigurationInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetId sets the Id field's value.
- func (s *DeleteBucketAnalyticsConfigurationInput) SetId(v string) *DeleteBucketAnalyticsConfigurationInput {
- s.Id = &v
- return s
- }
- func (s *DeleteBucketAnalyticsConfigurationInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *DeleteBucketAnalyticsConfigurationInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s DeleteBucketAnalyticsConfigurationInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type DeleteBucketAnalyticsConfigurationOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteBucketAnalyticsConfigurationOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteBucketAnalyticsConfigurationOutput) GoString() string {
- return s.String()
- }
- type DeleteBucketCorsInput struct {
- _ struct{} `locationName:"DeleteBucketCorsRequest" type:"structure"`
- // Specifies the bucket whose cors configuration is being deleted.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteBucketCorsInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteBucketCorsInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *DeleteBucketCorsInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "DeleteBucketCorsInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *DeleteBucketCorsInput) SetBucket(v string) *DeleteBucketCorsInput {
- s.Bucket = &v
- return s
- }
- func (s *DeleteBucketCorsInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *DeleteBucketCorsInput) SetExpectedBucketOwner(v string) *DeleteBucketCorsInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- func (s *DeleteBucketCorsInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *DeleteBucketCorsInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s DeleteBucketCorsInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type DeleteBucketCorsOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteBucketCorsOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteBucketCorsOutput) GoString() string {
- return s.String()
- }
- type DeleteBucketEncryptionInput struct {
- _ struct{} `locationName:"DeleteBucketEncryptionRequest" type:"structure"`
- // The name of the bucket containing the server-side encryption configuration
- // to delete.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteBucketEncryptionInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteBucketEncryptionInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *DeleteBucketEncryptionInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "DeleteBucketEncryptionInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *DeleteBucketEncryptionInput) SetBucket(v string) *DeleteBucketEncryptionInput {
- s.Bucket = &v
- return s
- }
- func (s *DeleteBucketEncryptionInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *DeleteBucketEncryptionInput) SetExpectedBucketOwner(v string) *DeleteBucketEncryptionInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- func (s *DeleteBucketEncryptionInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *DeleteBucketEncryptionInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s DeleteBucketEncryptionInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type DeleteBucketEncryptionOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteBucketEncryptionOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteBucketEncryptionOutput) GoString() string {
- return s.String()
- }
- type DeleteBucketInput struct {
- _ struct{} `locationName:"DeleteBucketRequest" type:"structure"`
- // Specifies the bucket being deleted.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteBucketInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteBucketInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *DeleteBucketInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "DeleteBucketInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *DeleteBucketInput) SetBucket(v string) *DeleteBucketInput {
- s.Bucket = &v
- return s
- }
- func (s *DeleteBucketInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *DeleteBucketInput) SetExpectedBucketOwner(v string) *DeleteBucketInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- func (s *DeleteBucketInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *DeleteBucketInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s DeleteBucketInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type DeleteBucketIntelligentTieringConfigurationInput struct {
- _ struct{} `locationName:"DeleteBucketIntelligentTieringConfigurationRequest" type:"structure"`
- // The name of the Amazon S3 bucket whose configuration you want to modify or
- // retrieve.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The ID used to identify the S3 Intelligent-Tiering configuration.
- //
- // Id is a required field
- Id *string `location:"querystring" locationName:"id" type:"string" required:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteBucketIntelligentTieringConfigurationInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteBucketIntelligentTieringConfigurationInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *DeleteBucketIntelligentTieringConfigurationInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "DeleteBucketIntelligentTieringConfigurationInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.Id == nil {
- invalidParams.Add(request.NewErrParamRequired("Id"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *DeleteBucketIntelligentTieringConfigurationInput) SetBucket(v string) *DeleteBucketIntelligentTieringConfigurationInput {
- s.Bucket = &v
- return s
- }
- func (s *DeleteBucketIntelligentTieringConfigurationInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetId sets the Id field's value.
- func (s *DeleteBucketIntelligentTieringConfigurationInput) SetId(v string) *DeleteBucketIntelligentTieringConfigurationInput {
- s.Id = &v
- return s
- }
- func (s *DeleteBucketIntelligentTieringConfigurationInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *DeleteBucketIntelligentTieringConfigurationInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s DeleteBucketIntelligentTieringConfigurationInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type DeleteBucketIntelligentTieringConfigurationOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteBucketIntelligentTieringConfigurationOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteBucketIntelligentTieringConfigurationOutput) GoString() string {
- return s.String()
- }
- type DeleteBucketInventoryConfigurationInput struct {
- _ struct{} `locationName:"DeleteBucketInventoryConfigurationRequest" type:"structure"`
- // The name of the bucket containing the inventory configuration to delete.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // The ID used to identify the inventory configuration.
- //
- // Id is a required field
- Id *string `location:"querystring" locationName:"id" type:"string" required:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteBucketInventoryConfigurationInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteBucketInventoryConfigurationInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *DeleteBucketInventoryConfigurationInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "DeleteBucketInventoryConfigurationInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.Id == nil {
- invalidParams.Add(request.NewErrParamRequired("Id"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *DeleteBucketInventoryConfigurationInput) SetBucket(v string) *DeleteBucketInventoryConfigurationInput {
- s.Bucket = &v
- return s
- }
- func (s *DeleteBucketInventoryConfigurationInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *DeleteBucketInventoryConfigurationInput) SetExpectedBucketOwner(v string) *DeleteBucketInventoryConfigurationInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetId sets the Id field's value.
- func (s *DeleteBucketInventoryConfigurationInput) SetId(v string) *DeleteBucketInventoryConfigurationInput {
- s.Id = &v
- return s
- }
- func (s *DeleteBucketInventoryConfigurationInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *DeleteBucketInventoryConfigurationInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s DeleteBucketInventoryConfigurationInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type DeleteBucketInventoryConfigurationOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteBucketInventoryConfigurationOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteBucketInventoryConfigurationOutput) GoString() string {
- return s.String()
- }
- type DeleteBucketLifecycleInput struct {
- _ struct{} `locationName:"DeleteBucketLifecycleRequest" type:"structure"`
- // The bucket name of the lifecycle to delete.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteBucketLifecycleInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteBucketLifecycleInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *DeleteBucketLifecycleInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "DeleteBucketLifecycleInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *DeleteBucketLifecycleInput) SetBucket(v string) *DeleteBucketLifecycleInput {
- s.Bucket = &v
- return s
- }
- func (s *DeleteBucketLifecycleInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *DeleteBucketLifecycleInput) SetExpectedBucketOwner(v string) *DeleteBucketLifecycleInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- func (s *DeleteBucketLifecycleInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *DeleteBucketLifecycleInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s DeleteBucketLifecycleInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type DeleteBucketLifecycleOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteBucketLifecycleOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteBucketLifecycleOutput) GoString() string {
- return s.String()
- }
- type DeleteBucketMetricsConfigurationInput struct {
- _ struct{} `locationName:"DeleteBucketMetricsConfigurationRequest" type:"structure"`
- // The name of the bucket containing the metrics configuration to delete.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // The ID used to identify the metrics configuration.
- //
- // Id is a required field
- Id *string `location:"querystring" locationName:"id" type:"string" required:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteBucketMetricsConfigurationInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteBucketMetricsConfigurationInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *DeleteBucketMetricsConfigurationInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "DeleteBucketMetricsConfigurationInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.Id == nil {
- invalidParams.Add(request.NewErrParamRequired("Id"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *DeleteBucketMetricsConfigurationInput) SetBucket(v string) *DeleteBucketMetricsConfigurationInput {
- s.Bucket = &v
- return s
- }
- func (s *DeleteBucketMetricsConfigurationInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *DeleteBucketMetricsConfigurationInput) SetExpectedBucketOwner(v string) *DeleteBucketMetricsConfigurationInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetId sets the Id field's value.
- func (s *DeleteBucketMetricsConfigurationInput) SetId(v string) *DeleteBucketMetricsConfigurationInput {
- s.Id = &v
- return s
- }
- func (s *DeleteBucketMetricsConfigurationInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *DeleteBucketMetricsConfigurationInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s DeleteBucketMetricsConfigurationInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type DeleteBucketMetricsConfigurationOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteBucketMetricsConfigurationOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteBucketMetricsConfigurationOutput) GoString() string {
- return s.String()
- }
- type DeleteBucketOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteBucketOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteBucketOutput) GoString() string {
- return s.String()
- }
- type DeleteBucketOwnershipControlsInput struct {
- _ struct{} `locationName:"DeleteBucketOwnershipControlsRequest" type:"structure"`
- // The Amazon S3 bucket whose OwnershipControls you want to delete.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteBucketOwnershipControlsInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteBucketOwnershipControlsInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *DeleteBucketOwnershipControlsInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "DeleteBucketOwnershipControlsInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *DeleteBucketOwnershipControlsInput) SetBucket(v string) *DeleteBucketOwnershipControlsInput {
- s.Bucket = &v
- return s
- }
- func (s *DeleteBucketOwnershipControlsInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *DeleteBucketOwnershipControlsInput) SetExpectedBucketOwner(v string) *DeleteBucketOwnershipControlsInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- func (s *DeleteBucketOwnershipControlsInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *DeleteBucketOwnershipControlsInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s DeleteBucketOwnershipControlsInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type DeleteBucketOwnershipControlsOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteBucketOwnershipControlsOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteBucketOwnershipControlsOutput) GoString() string {
- return s.String()
- }
- type DeleteBucketPolicyInput struct {
- _ struct{} `locationName:"DeleteBucketPolicyRequest" type:"structure"`
- // The bucket name.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteBucketPolicyInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteBucketPolicyInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *DeleteBucketPolicyInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "DeleteBucketPolicyInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *DeleteBucketPolicyInput) SetBucket(v string) *DeleteBucketPolicyInput {
- s.Bucket = &v
- return s
- }
- func (s *DeleteBucketPolicyInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *DeleteBucketPolicyInput) SetExpectedBucketOwner(v string) *DeleteBucketPolicyInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- func (s *DeleteBucketPolicyInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *DeleteBucketPolicyInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s DeleteBucketPolicyInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type DeleteBucketPolicyOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteBucketPolicyOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteBucketPolicyOutput) GoString() string {
- return s.String()
- }
- type DeleteBucketReplicationInput struct {
- _ struct{} `locationName:"DeleteBucketReplicationRequest" type:"structure"`
- // The bucket name.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteBucketReplicationInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteBucketReplicationInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *DeleteBucketReplicationInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "DeleteBucketReplicationInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *DeleteBucketReplicationInput) SetBucket(v string) *DeleteBucketReplicationInput {
- s.Bucket = &v
- return s
- }
- func (s *DeleteBucketReplicationInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *DeleteBucketReplicationInput) SetExpectedBucketOwner(v string) *DeleteBucketReplicationInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- func (s *DeleteBucketReplicationInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *DeleteBucketReplicationInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s DeleteBucketReplicationInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type DeleteBucketReplicationOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteBucketReplicationOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteBucketReplicationOutput) GoString() string {
- return s.String()
- }
- type DeleteBucketTaggingInput struct {
- _ struct{} `locationName:"DeleteBucketTaggingRequest" type:"structure"`
- // The bucket that has the tag set to be removed.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteBucketTaggingInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteBucketTaggingInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *DeleteBucketTaggingInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "DeleteBucketTaggingInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *DeleteBucketTaggingInput) SetBucket(v string) *DeleteBucketTaggingInput {
- s.Bucket = &v
- return s
- }
- func (s *DeleteBucketTaggingInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *DeleteBucketTaggingInput) SetExpectedBucketOwner(v string) *DeleteBucketTaggingInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- func (s *DeleteBucketTaggingInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *DeleteBucketTaggingInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s DeleteBucketTaggingInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type DeleteBucketTaggingOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteBucketTaggingOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteBucketTaggingOutput) GoString() string {
- return s.String()
- }
- type DeleteBucketWebsiteInput struct {
- _ struct{} `locationName:"DeleteBucketWebsiteRequest" type:"structure"`
- // The bucket name for which you want to remove the website configuration.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteBucketWebsiteInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteBucketWebsiteInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *DeleteBucketWebsiteInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "DeleteBucketWebsiteInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *DeleteBucketWebsiteInput) SetBucket(v string) *DeleteBucketWebsiteInput {
- s.Bucket = &v
- return s
- }
- func (s *DeleteBucketWebsiteInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *DeleteBucketWebsiteInput) SetExpectedBucketOwner(v string) *DeleteBucketWebsiteInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- func (s *DeleteBucketWebsiteInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *DeleteBucketWebsiteInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s DeleteBucketWebsiteInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type DeleteBucketWebsiteOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteBucketWebsiteOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteBucketWebsiteOutput) GoString() string {
- return s.String()
- }
- // Information about the delete marker.
- type DeleteMarkerEntry struct {
- _ struct{} `type:"structure"`
- // Specifies whether the object is (true) or is not (false) the latest version
- // of an object.
- IsLatest *bool `type:"boolean"`
- // The object key.
- Key *string `min:"1" type:"string"`
- // Date and time the object was last modified.
- LastModified *time.Time `type:"timestamp"`
- // The account that created the delete marker.>
- Owner *Owner `type:"structure"`
- // Version ID of an object.
- VersionId *string `type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteMarkerEntry) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteMarkerEntry) GoString() string {
- return s.String()
- }
- // SetIsLatest sets the IsLatest field's value.
- func (s *DeleteMarkerEntry) SetIsLatest(v bool) *DeleteMarkerEntry {
- s.IsLatest = &v
- return s
- }
- // SetKey sets the Key field's value.
- func (s *DeleteMarkerEntry) SetKey(v string) *DeleteMarkerEntry {
- s.Key = &v
- return s
- }
- // SetLastModified sets the LastModified field's value.
- func (s *DeleteMarkerEntry) SetLastModified(v time.Time) *DeleteMarkerEntry {
- s.LastModified = &v
- return s
- }
- // SetOwner sets the Owner field's value.
- func (s *DeleteMarkerEntry) SetOwner(v *Owner) *DeleteMarkerEntry {
- s.Owner = v
- return s
- }
- // SetVersionId sets the VersionId field's value.
- func (s *DeleteMarkerEntry) SetVersionId(v string) *DeleteMarkerEntry {
- s.VersionId = &v
- return s
- }
- // Specifies whether Amazon S3 replicates delete markers. If you specify a Filter
- // in your replication configuration, you must also include a DeleteMarkerReplication
- // element. If your Filter includes a Tag element, the DeleteMarkerReplication
- // Status must be set to Disabled, because Amazon S3 does not support replicating
- // delete markers for tag-based rules. For an example configuration, see Basic
- // Rule Configuration (https://docs.aws.amazon.com/AmazonS3/latest/dev/replication-add-config.html#replication-config-min-rule-config).
- //
- // For more information about delete marker replication, see Basic Rule Configuration
- // (https://docs.aws.amazon.com/AmazonS3/latest/dev/delete-marker-replication.html).
- //
- // If you are using an earlier version of the replication configuration, Amazon
- // S3 handles replication of delete markers differently. For more information,
- // see Backward Compatibility (https://docs.aws.amazon.com/AmazonS3/latest/dev/replication-add-config.html#replication-backward-compat-considerations).
- type DeleteMarkerReplication struct {
- _ struct{} `type:"structure"`
- // Indicates whether to replicate delete markers.
- //
- // Indicates whether to replicate delete markers.
- Status *string `type:"string" enum:"DeleteMarkerReplicationStatus"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteMarkerReplication) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteMarkerReplication) GoString() string {
- return s.String()
- }
- // SetStatus sets the Status field's value.
- func (s *DeleteMarkerReplication) SetStatus(v string) *DeleteMarkerReplication {
- s.Status = &v
- return s
- }
- type DeleteObjectInput struct {
- _ struct{} `locationName:"DeleteObjectRequest" type:"structure"`
- // The bucket name of the bucket containing the object.
- //
- // When using this action with an access point, you must direct requests to
- // the access point hostname. The access point hostname takes the form AccessPointName-AccountId.s3-accesspoint.Region.amazonaws.com.
- // When using this action with an access point through the Amazon Web Services
- // SDKs, you provide the access point ARN in place of the bucket name. For more
- // information about access point ARNs, see Using access points (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html)
- // in the Amazon S3 User Guide.
- //
- // When using this action with Amazon S3 on Outposts, you must direct requests
- // to the S3 on Outposts hostname. The S3 on Outposts hostname takes the form
- // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When
- // using this action with S3 on Outposts through the Amazon Web Services SDKs,
- // you provide the Outposts bucket ARN in place of the bucket name. For more
- // information about S3 on Outposts ARNs, see Using Amazon S3 on Outposts (https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html)
- // in the Amazon S3 User Guide.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // Indicates whether S3 Object Lock should bypass Governance-mode restrictions
- // to process this operation. To use this header, you must have the s3:BypassGovernanceRetention
- // permission.
- BypassGovernanceRetention *bool `location:"header" locationName:"x-amz-bypass-governance-retention" type:"boolean"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // Key name of the object to delete.
- //
- // Key is a required field
- Key *string `location:"uri" locationName:"Key" min:"1" type:"string" required:"true"`
- // The concatenation of the authentication device's serial number, a space,
- // and the value that is displayed on your authentication device. Required to
- // permanently delete a versioned object if versioning is configured with MFA
- // delete enabled.
- MFA *string `location:"header" locationName:"x-amz-mfa" type:"string"`
- // Confirms that the requester knows that they will be charged for the request.
- // Bucket owners need not specify this parameter in their requests. For information
- // about downloading objects from Requester Pays buckets, see Downloading Objects
- // in Requester Pays Buckets (https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html)
- // in the Amazon S3 User Guide.
- RequestPayer *string `location:"header" locationName:"x-amz-request-payer" type:"string" enum:"RequestPayer"`
- // VersionId used to reference a specific version of the object.
- VersionId *string `location:"querystring" locationName:"versionId" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteObjectInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteObjectInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *DeleteObjectInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "DeleteObjectInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.Key == nil {
- invalidParams.Add(request.NewErrParamRequired("Key"))
- }
- if s.Key != nil && len(*s.Key) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Key", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *DeleteObjectInput) SetBucket(v string) *DeleteObjectInput {
- s.Bucket = &v
- return s
- }
- func (s *DeleteObjectInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetBypassGovernanceRetention sets the BypassGovernanceRetention field's value.
- func (s *DeleteObjectInput) SetBypassGovernanceRetention(v bool) *DeleteObjectInput {
- s.BypassGovernanceRetention = &v
- return s
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *DeleteObjectInput) SetExpectedBucketOwner(v string) *DeleteObjectInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetKey sets the Key field's value.
- func (s *DeleteObjectInput) SetKey(v string) *DeleteObjectInput {
- s.Key = &v
- return s
- }
- // SetMFA sets the MFA field's value.
- func (s *DeleteObjectInput) SetMFA(v string) *DeleteObjectInput {
- s.MFA = &v
- return s
- }
- // SetRequestPayer sets the RequestPayer field's value.
- func (s *DeleteObjectInput) SetRequestPayer(v string) *DeleteObjectInput {
- s.RequestPayer = &v
- return s
- }
- // SetVersionId sets the VersionId field's value.
- func (s *DeleteObjectInput) SetVersionId(v string) *DeleteObjectInput {
- s.VersionId = &v
- return s
- }
- func (s *DeleteObjectInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *DeleteObjectInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s DeleteObjectInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type DeleteObjectOutput struct {
- _ struct{} `type:"structure"`
- // Specifies whether the versioned object that was permanently deleted was (true)
- // or was not (false) a delete marker.
- DeleteMarker *bool `location:"header" locationName:"x-amz-delete-marker" type:"boolean"`
- // If present, indicates that the requester was successfully charged for the
- // request.
- RequestCharged *string `location:"header" locationName:"x-amz-request-charged" type:"string" enum:"RequestCharged"`
- // Returns the version ID of the delete marker created as a result of the DELETE
- // operation.
- VersionId *string `location:"header" locationName:"x-amz-version-id" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteObjectOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteObjectOutput) GoString() string {
- return s.String()
- }
- // SetDeleteMarker sets the DeleteMarker field's value.
- func (s *DeleteObjectOutput) SetDeleteMarker(v bool) *DeleteObjectOutput {
- s.DeleteMarker = &v
- return s
- }
- // SetRequestCharged sets the RequestCharged field's value.
- func (s *DeleteObjectOutput) SetRequestCharged(v string) *DeleteObjectOutput {
- s.RequestCharged = &v
- return s
- }
- // SetVersionId sets the VersionId field's value.
- func (s *DeleteObjectOutput) SetVersionId(v string) *DeleteObjectOutput {
- s.VersionId = &v
- return s
- }
- type DeleteObjectTaggingInput struct {
- _ struct{} `locationName:"DeleteObjectTaggingRequest" type:"structure"`
- // The bucket name containing the objects from which to remove the tags.
- //
- // When using this action with an access point, you must direct requests to
- // the access point hostname. The access point hostname takes the form AccessPointName-AccountId.s3-accesspoint.Region.amazonaws.com.
- // When using this action with an access point through the Amazon Web Services
- // SDKs, you provide the access point ARN in place of the bucket name. For more
- // information about access point ARNs, see Using access points (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html)
- // in the Amazon S3 User Guide.
- //
- // When using this action with Amazon S3 on Outposts, you must direct requests
- // to the S3 on Outposts hostname. The S3 on Outposts hostname takes the form
- // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When
- // using this action with S3 on Outposts through the Amazon Web Services SDKs,
- // you provide the Outposts bucket ARN in place of the bucket name. For more
- // information about S3 on Outposts ARNs, see Using Amazon S3 on Outposts (https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html)
- // in the Amazon S3 User Guide.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // The key that identifies the object in the bucket from which to remove all
- // tags.
- //
- // Key is a required field
- Key *string `location:"uri" locationName:"Key" min:"1" type:"string" required:"true"`
- // The versionId of the object that the tag-set will be removed from.
- VersionId *string `location:"querystring" locationName:"versionId" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteObjectTaggingInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteObjectTaggingInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *DeleteObjectTaggingInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "DeleteObjectTaggingInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.Key == nil {
- invalidParams.Add(request.NewErrParamRequired("Key"))
- }
- if s.Key != nil && len(*s.Key) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Key", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *DeleteObjectTaggingInput) SetBucket(v string) *DeleteObjectTaggingInput {
- s.Bucket = &v
- return s
- }
- func (s *DeleteObjectTaggingInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *DeleteObjectTaggingInput) SetExpectedBucketOwner(v string) *DeleteObjectTaggingInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetKey sets the Key field's value.
- func (s *DeleteObjectTaggingInput) SetKey(v string) *DeleteObjectTaggingInput {
- s.Key = &v
- return s
- }
- // SetVersionId sets the VersionId field's value.
- func (s *DeleteObjectTaggingInput) SetVersionId(v string) *DeleteObjectTaggingInput {
- s.VersionId = &v
- return s
- }
- func (s *DeleteObjectTaggingInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *DeleteObjectTaggingInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s DeleteObjectTaggingInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type DeleteObjectTaggingOutput struct {
- _ struct{} `type:"structure"`
- // The versionId of the object the tag-set was removed from.
- VersionId *string `location:"header" locationName:"x-amz-version-id" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteObjectTaggingOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteObjectTaggingOutput) GoString() string {
- return s.String()
- }
- // SetVersionId sets the VersionId field's value.
- func (s *DeleteObjectTaggingOutput) SetVersionId(v string) *DeleteObjectTaggingOutput {
- s.VersionId = &v
- return s
- }
- type DeleteObjectsInput struct {
- _ struct{} `locationName:"DeleteObjectsRequest" type:"structure" payload:"Delete"`
- // The bucket name containing the objects to delete.
- //
- // When using this action with an access point, you must direct requests to
- // the access point hostname. The access point hostname takes the form AccessPointName-AccountId.s3-accesspoint.Region.amazonaws.com.
- // When using this action with an access point through the Amazon Web Services
- // SDKs, you provide the access point ARN in place of the bucket name. For more
- // information about access point ARNs, see Using access points (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html)
- // in the Amazon S3 User Guide.
- //
- // When using this action with Amazon S3 on Outposts, you must direct requests
- // to the S3 on Outposts hostname. The S3 on Outposts hostname takes the form
- // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When
- // using this action with S3 on Outposts through the Amazon Web Services SDKs,
- // you provide the Outposts bucket ARN in place of the bucket name. For more
- // information about S3 on Outposts ARNs, see Using Amazon S3 on Outposts (https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html)
- // in the Amazon S3 User Guide.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // Specifies whether you want to delete this object even if it has a Governance-type
- // Object Lock in place. To use this header, you must have the s3:BypassGovernanceRetention
- // permission.
- BypassGovernanceRetention *bool `location:"header" locationName:"x-amz-bypass-governance-retention" type:"boolean"`
- // Indicates the algorithm used to create the checksum for the object when using
- // the SDK. This header will not provide any additional functionality if not
- // using the SDK. When sending this header, there must be a corresponding x-amz-checksum
- // or x-amz-trailer header sent. Otherwise, Amazon S3 fails the request with
- // the HTTP status code 400 Bad Request. For more information, see Checking
- // object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
- // in the Amazon S3 User Guide.
- //
- // If you provide an individual checksum, Amazon S3 ignores any provided ChecksumAlgorithm
- // parameter.
- //
- // This checksum algorithm must be the same for all parts and it match the checksum
- // value supplied in the CreateMultipartUpload request.
- //
- // The AWS SDK for Go v1 does not support automatic computing request payload
- // checksum. This feature is available in the AWS SDK for Go v2. If a value
- // is specified for this parameter, the matching algorithm's checksum member
- // must be populated with the algorithm's checksum of the request payload.
- //
- // The SDK will automatically compute the Content-MD5 checksum for this operation.
- // The AWS SDK for Go v2 allows you to configure alternative checksum algorithm
- // to be used.
- ChecksumAlgorithm *string `location:"header" locationName:"x-amz-sdk-checksum-algorithm" type:"string" enum:"ChecksumAlgorithm"`
- // Container for the request.
- //
- // Delete is a required field
- Delete *Delete `locationName:"Delete" type:"structure" required:"true" xmlURI:"http://s3.amazonaws.com/doc/2006-03-01/"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // The concatenation of the authentication device's serial number, a space,
- // and the value that is displayed on your authentication device. Required to
- // permanently delete a versioned object if versioning is configured with MFA
- // delete enabled.
- MFA *string `location:"header" locationName:"x-amz-mfa" type:"string"`
- // Confirms that the requester knows that they will be charged for the request.
- // Bucket owners need not specify this parameter in their requests. For information
- // about downloading objects from Requester Pays buckets, see Downloading Objects
- // in Requester Pays Buckets (https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html)
- // in the Amazon S3 User Guide.
- RequestPayer *string `location:"header" locationName:"x-amz-request-payer" type:"string" enum:"RequestPayer"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteObjectsInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteObjectsInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *DeleteObjectsInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "DeleteObjectsInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.Delete == nil {
- invalidParams.Add(request.NewErrParamRequired("Delete"))
- }
- if s.Delete != nil {
- if err := s.Delete.Validate(); err != nil {
- invalidParams.AddNested("Delete", err.(request.ErrInvalidParams))
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *DeleteObjectsInput) SetBucket(v string) *DeleteObjectsInput {
- s.Bucket = &v
- return s
- }
- func (s *DeleteObjectsInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetBypassGovernanceRetention sets the BypassGovernanceRetention field's value.
- func (s *DeleteObjectsInput) SetBypassGovernanceRetention(v bool) *DeleteObjectsInput {
- s.BypassGovernanceRetention = &v
- return s
- }
- // SetChecksumAlgorithm sets the ChecksumAlgorithm field's value.
- func (s *DeleteObjectsInput) SetChecksumAlgorithm(v string) *DeleteObjectsInput {
- s.ChecksumAlgorithm = &v
- return s
- }
- // SetDelete sets the Delete field's value.
- func (s *DeleteObjectsInput) SetDelete(v *Delete) *DeleteObjectsInput {
- s.Delete = v
- return s
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *DeleteObjectsInput) SetExpectedBucketOwner(v string) *DeleteObjectsInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetMFA sets the MFA field's value.
- func (s *DeleteObjectsInput) SetMFA(v string) *DeleteObjectsInput {
- s.MFA = &v
- return s
- }
- // SetRequestPayer sets the RequestPayer field's value.
- func (s *DeleteObjectsInput) SetRequestPayer(v string) *DeleteObjectsInput {
- s.RequestPayer = &v
- return s
- }
- func (s *DeleteObjectsInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *DeleteObjectsInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s DeleteObjectsInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type DeleteObjectsOutput struct {
- _ struct{} `type:"structure"`
- // Container element for a successful delete. It identifies the object that
- // was successfully deleted.
- Deleted []*DeletedObject `type:"list" flattened:"true"`
- // Container for a failed delete action that describes the object that Amazon
- // S3 attempted to delete and the error it encountered.
- Errors []*Error `locationName:"Error" type:"list" flattened:"true"`
- // If present, indicates that the requester was successfully charged for the
- // request.
- RequestCharged *string `location:"header" locationName:"x-amz-request-charged" type:"string" enum:"RequestCharged"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteObjectsOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeleteObjectsOutput) GoString() string {
- return s.String()
- }
- // SetDeleted sets the Deleted field's value.
- func (s *DeleteObjectsOutput) SetDeleted(v []*DeletedObject) *DeleteObjectsOutput {
- s.Deleted = v
- return s
- }
- // SetErrors sets the Errors field's value.
- func (s *DeleteObjectsOutput) SetErrors(v []*Error) *DeleteObjectsOutput {
- s.Errors = v
- return s
- }
- // SetRequestCharged sets the RequestCharged field's value.
- func (s *DeleteObjectsOutput) SetRequestCharged(v string) *DeleteObjectsOutput {
- s.RequestCharged = &v
- return s
- }
- type DeletePublicAccessBlockInput struct {
- _ struct{} `locationName:"DeletePublicAccessBlockRequest" type:"structure"`
- // The Amazon S3 bucket whose PublicAccessBlock configuration you want to delete.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeletePublicAccessBlockInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeletePublicAccessBlockInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *DeletePublicAccessBlockInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "DeletePublicAccessBlockInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *DeletePublicAccessBlockInput) SetBucket(v string) *DeletePublicAccessBlockInput {
- s.Bucket = &v
- return s
- }
- func (s *DeletePublicAccessBlockInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *DeletePublicAccessBlockInput) SetExpectedBucketOwner(v string) *DeletePublicAccessBlockInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- func (s *DeletePublicAccessBlockInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *DeletePublicAccessBlockInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s DeletePublicAccessBlockInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type DeletePublicAccessBlockOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeletePublicAccessBlockOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeletePublicAccessBlockOutput) GoString() string {
- return s.String()
- }
- // Information about the deleted object.
- type DeletedObject struct {
- _ struct{} `type:"structure"`
- // Specifies whether the versioned object that was permanently deleted was (true)
- // or was not (false) a delete marker. In a simple DELETE, this header indicates
- // whether (true) or not (false) a delete marker was created.
- DeleteMarker *bool `type:"boolean"`
- // The version ID of the delete marker created as a result of the DELETE operation.
- // If you delete a specific object version, the value returned by this header
- // is the version ID of the object version deleted.
- DeleteMarkerVersionId *string `type:"string"`
- // The name of the deleted object.
- Key *string `min:"1" type:"string"`
- // The version ID of the deleted object.
- VersionId *string `type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeletedObject) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s DeletedObject) GoString() string {
- return s.String()
- }
- // SetDeleteMarker sets the DeleteMarker field's value.
- func (s *DeletedObject) SetDeleteMarker(v bool) *DeletedObject {
- s.DeleteMarker = &v
- return s
- }
- // SetDeleteMarkerVersionId sets the DeleteMarkerVersionId field's value.
- func (s *DeletedObject) SetDeleteMarkerVersionId(v string) *DeletedObject {
- s.DeleteMarkerVersionId = &v
- return s
- }
- // SetKey sets the Key field's value.
- func (s *DeletedObject) SetKey(v string) *DeletedObject {
- s.Key = &v
- return s
- }
- // SetVersionId sets the VersionId field's value.
- func (s *DeletedObject) SetVersionId(v string) *DeletedObject {
- s.VersionId = &v
- return s
- }
- // Specifies information about where to publish analysis or configuration results
- // for an Amazon S3 bucket and S3 Replication Time Control (S3 RTC).
- type Destination struct {
- _ struct{} `type:"structure"`
- // Specify this only in a cross-account scenario (where source and destination
- // bucket owners are not the same), and you want to change replica ownership
- // to the Amazon Web Services account that owns the destination bucket. If this
- // is not specified in the replication configuration, the replicas are owned
- // by same Amazon Web Services account that owns the source object.
- AccessControlTranslation *AccessControlTranslation `type:"structure"`
- // Destination bucket owner account ID. In a cross-account scenario, if you
- // direct Amazon S3 to change replica ownership to the Amazon Web Services account
- // that owns the destination bucket by specifying the AccessControlTranslation
- // property, this is the account ID of the destination bucket owner. For more
- // information, see Replication Additional Configuration: Changing the Replica
- // Owner (https://docs.aws.amazon.com/AmazonS3/latest/dev/replication-change-owner.html)
- // in the Amazon S3 User Guide.
- Account *string `type:"string"`
- // The Amazon Resource Name (ARN) of the bucket where you want Amazon S3 to
- // store the results.
- //
- // Bucket is a required field
- Bucket *string `type:"string" required:"true"`
- // A container that provides information about encryption. If SourceSelectionCriteria
- // is specified, you must specify this element.
- EncryptionConfiguration *EncryptionConfiguration `type:"structure"`
- // A container specifying replication metrics-related settings enabling replication
- // metrics and events.
- Metrics *Metrics `type:"structure"`
- // A container specifying S3 Replication Time Control (S3 RTC), including whether
- // S3 RTC is enabled and the time when all objects and operations on objects
- // must be replicated. Must be specified together with a Metrics block.
- ReplicationTime *ReplicationTime `type:"structure"`
- // The storage class to use when replicating objects, such as S3 Standard or
- // reduced redundancy. By default, Amazon S3 uses the storage class of the source
- // object to create the object replica.
- //
- // For valid values, see the StorageClass element of the PUT Bucket replication
- // (https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTreplication.html)
- // action in the Amazon S3 API Reference.
- StorageClass *string `type:"string" enum:"StorageClass"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s Destination) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s Destination) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *Destination) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "Destination"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.AccessControlTranslation != nil {
- if err := s.AccessControlTranslation.Validate(); err != nil {
- invalidParams.AddNested("AccessControlTranslation", err.(request.ErrInvalidParams))
- }
- }
- if s.Metrics != nil {
- if err := s.Metrics.Validate(); err != nil {
- invalidParams.AddNested("Metrics", err.(request.ErrInvalidParams))
- }
- }
- if s.ReplicationTime != nil {
- if err := s.ReplicationTime.Validate(); err != nil {
- invalidParams.AddNested("ReplicationTime", err.(request.ErrInvalidParams))
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetAccessControlTranslation sets the AccessControlTranslation field's value.
- func (s *Destination) SetAccessControlTranslation(v *AccessControlTranslation) *Destination {
- s.AccessControlTranslation = v
- return s
- }
- // SetAccount sets the Account field's value.
- func (s *Destination) SetAccount(v string) *Destination {
- s.Account = &v
- return s
- }
- // SetBucket sets the Bucket field's value.
- func (s *Destination) SetBucket(v string) *Destination {
- s.Bucket = &v
- return s
- }
- func (s *Destination) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetEncryptionConfiguration sets the EncryptionConfiguration field's value.
- func (s *Destination) SetEncryptionConfiguration(v *EncryptionConfiguration) *Destination {
- s.EncryptionConfiguration = v
- return s
- }
- // SetMetrics sets the Metrics field's value.
- func (s *Destination) SetMetrics(v *Metrics) *Destination {
- s.Metrics = v
- return s
- }
- // SetReplicationTime sets the ReplicationTime field's value.
- func (s *Destination) SetReplicationTime(v *ReplicationTime) *Destination {
- s.ReplicationTime = v
- return s
- }
- // SetStorageClass sets the StorageClass field's value.
- func (s *Destination) SetStorageClass(v string) *Destination {
- s.StorageClass = &v
- return s
- }
- // Contains the type of server-side encryption used.
- type Encryption struct {
- _ struct{} `type:"structure"`
- // The server-side encryption algorithm used when storing job results in Amazon
- // S3 (for example, AES256, aws:kms).
- //
- // EncryptionType is a required field
- EncryptionType *string `type:"string" required:"true" enum:"ServerSideEncryption"`
- // If the encryption type is aws:kms, this optional value can be used to specify
- // the encryption context for the restore results.
- KMSContext *string `type:"string"`
- // If the encryption type is aws:kms, this optional value specifies the ID of
- // the symmetric customer managed key to use for encryption of job results.
- // Amazon S3 only supports symmetric keys. For more information, see Using symmetric
- // and asymmetric keys (https://docs.aws.amazon.com/kms/latest/developerguide/symmetric-asymmetric.html)
- // in the Amazon Web Services Key Management Service Developer Guide.
- //
- // KMSKeyId is a sensitive parameter and its value will be
- // replaced with "sensitive" in string returned by Encryption's
- // String and GoString methods.
- KMSKeyId *string `type:"string" sensitive:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s Encryption) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s Encryption) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *Encryption) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "Encryption"}
- if s.EncryptionType == nil {
- invalidParams.Add(request.NewErrParamRequired("EncryptionType"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetEncryptionType sets the EncryptionType field's value.
- func (s *Encryption) SetEncryptionType(v string) *Encryption {
- s.EncryptionType = &v
- return s
- }
- // SetKMSContext sets the KMSContext field's value.
- func (s *Encryption) SetKMSContext(v string) *Encryption {
- s.KMSContext = &v
- return s
- }
- // SetKMSKeyId sets the KMSKeyId field's value.
- func (s *Encryption) SetKMSKeyId(v string) *Encryption {
- s.KMSKeyId = &v
- return s
- }
- // Specifies encryption-related information for an Amazon S3 bucket that is
- // a destination for replicated objects.
- type EncryptionConfiguration struct {
- _ struct{} `type:"structure"`
- // Specifies the ID (Key ARN or Alias ARN) of the customer managed Amazon Web
- // Services KMS key stored in Amazon Web Services Key Management Service (KMS)
- // for the destination bucket. Amazon S3 uses this key to encrypt replica objects.
- // Amazon S3 only supports symmetric, customer managed KMS keys. For more information,
- // see Using symmetric and asymmetric keys (https://docs.aws.amazon.com/kms/latest/developerguide/symmetric-asymmetric.html)
- // in the Amazon Web Services Key Management Service Developer Guide.
- ReplicaKmsKeyID *string `type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s EncryptionConfiguration) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s EncryptionConfiguration) GoString() string {
- return s.String()
- }
- // SetReplicaKmsKeyID sets the ReplicaKmsKeyID field's value.
- func (s *EncryptionConfiguration) SetReplicaKmsKeyID(v string) *EncryptionConfiguration {
- s.ReplicaKmsKeyID = &v
- return s
- }
- // A message that indicates the request is complete and no more messages will
- // be sent. You should not assume that the request is complete until the client
- // receives an EndEvent.
- type EndEvent struct {
- _ struct{} `locationName:"EndEvent" type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s EndEvent) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s EndEvent) GoString() string {
- return s.String()
- }
- // The EndEvent is and event in the SelectObjectContentEventStream group of events.
- func (s *EndEvent) eventSelectObjectContentEventStream() {}
- // UnmarshalEvent unmarshals the EventStream Message into the EndEvent value.
- // This method is only used internally within the SDK's EventStream handling.
- func (s *EndEvent) UnmarshalEvent(
- payloadUnmarshaler protocol.PayloadUnmarshaler,
- msg eventstream.Message,
- ) error {
- return nil
- }
- // MarshalEvent marshals the type into an stream event value. This method
- // should only used internally within the SDK's EventStream handling.
- func (s *EndEvent) MarshalEvent(pm protocol.PayloadMarshaler) (msg eventstream.Message, err error) {
- msg.Headers.Set(eventstreamapi.MessageTypeHeader, eventstream.StringValue(eventstreamapi.EventMessageType))
- return msg, err
- }
- // Container for all error elements.
- type Error struct {
- _ struct{} `type:"structure"`
- // The error code is a string that uniquely identifies an error condition. It
- // is meant to be read and understood by programs that detect and handle errors
- // by type.
- //
- // Amazon S3 error codes
- //
- // * Code: AccessDenied Description: Access Denied HTTP Status Code: 403
- // Forbidden SOAP Fault Code Prefix: Client
- //
- // * Code: AccountProblem Description: There is a problem with your Amazon
- // Web Services account that prevents the action from completing successfully.
- // Contact Amazon Web Services Support for further assistance. HTTP Status
- // Code: 403 Forbidden SOAP Fault Code Prefix: Client
- //
- // * Code: AllAccessDisabled Description: All access to this Amazon S3 resource
- // has been disabled. Contact Amazon Web Services Support for further assistance.
- // HTTP Status Code: 403 Forbidden SOAP Fault Code Prefix: Client
- //
- // * Code: AmbiguousGrantByEmailAddress Description: The email address you
- // provided is associated with more than one account. HTTP Status Code: 400
- // Bad Request SOAP Fault Code Prefix: Client
- //
- // * Code: AuthorizationHeaderMalformed Description: The authorization header
- // you provided is invalid. HTTP Status Code: 400 Bad Request HTTP Status
- // Code: N/A
- //
- // * Code: BadDigest Description: The Content-MD5 you specified did not match
- // what we received. HTTP Status Code: 400 Bad Request SOAP Fault Code Prefix:
- // Client
- //
- // * Code: BucketAlreadyExists Description: The requested bucket name is
- // not available. The bucket namespace is shared by all users of the system.
- // Please select a different name and try again. HTTP Status Code: 409 Conflict
- // SOAP Fault Code Prefix: Client
- //
- // * Code: BucketAlreadyOwnedByYou Description: The bucket you tried to create
- // already exists, and you own it. Amazon S3 returns this error in all Amazon
- // Web Services Regions except in the North Virginia Region. For legacy compatibility,
- // if you re-create an existing bucket that you already own in the North
- // Virginia Region, Amazon S3 returns 200 OK and resets the bucket access
- // control lists (ACLs). Code: 409 Conflict (in all Regions except the North
- // Virginia Region) SOAP Fault Code Prefix: Client
- //
- // * Code: BucketNotEmpty Description: The bucket you tried to delete is
- // not empty. HTTP Status Code: 409 Conflict SOAP Fault Code Prefix: Client
- //
- // * Code: CredentialsNotSupported Description: This request does not support
- // credentials. HTTP Status Code: 400 Bad Request SOAP Fault Code Prefix:
- // Client
- //
- // * Code: CrossLocationLoggingProhibited Description: Cross-location logging
- // not allowed. Buckets in one geographic location cannot log information
- // to a bucket in another location. HTTP Status Code: 403 Forbidden SOAP
- // Fault Code Prefix: Client
- //
- // * Code: EntityTooSmall Description: Your proposed upload is smaller than
- // the minimum allowed object size. HTTP Status Code: 400 Bad Request SOAP
- // Fault Code Prefix: Client
- //
- // * Code: EntityTooLarge Description: Your proposed upload exceeds the maximum
- // allowed object size. HTTP Status Code: 400 Bad Request SOAP Fault Code
- // Prefix: Client
- //
- // * Code: ExpiredToken Description: The provided token has expired. HTTP
- // Status Code: 400 Bad Request SOAP Fault Code Prefix: Client
- //
- // * Code: IllegalVersioningConfigurationException Description: Indicates
- // that the versioning configuration specified in the request is invalid.
- // HTTP Status Code: 400 Bad Request SOAP Fault Code Prefix: Client
- //
- // * Code: IncompleteBody Description: You did not provide the number of
- // bytes specified by the Content-Length HTTP header HTTP Status Code: 400
- // Bad Request SOAP Fault Code Prefix: Client
- //
- // * Code: IncorrectNumberOfFilesInPostRequest Description: POST requires
- // exactly one file upload per request. HTTP Status Code: 400 Bad Request
- // SOAP Fault Code Prefix: Client
- //
- // * Code: InlineDataTooLarge Description: Inline data exceeds the maximum
- // allowed size. HTTP Status Code: 400 Bad Request SOAP Fault Code Prefix:
- // Client
- //
- // * Code: InternalError Description: We encountered an internal error. Please
- // try again. HTTP Status Code: 500 Internal Server Error SOAP Fault Code
- // Prefix: Server
- //
- // * Code: InvalidAccessKeyId Description: The Amazon Web Services access
- // key ID you provided does not exist in our records. HTTP Status Code: 403
- // Forbidden SOAP Fault Code Prefix: Client
- //
- // * Code: InvalidAddressingHeader Description: You must specify the Anonymous
- // role. HTTP Status Code: N/A SOAP Fault Code Prefix: Client
- //
- // * Code: InvalidArgument Description: Invalid Argument HTTP Status Code:
- // 400 Bad Request SOAP Fault Code Prefix: Client
- //
- // * Code: InvalidBucketName Description: The specified bucket is not valid.
- // HTTP Status Code: 400 Bad Request SOAP Fault Code Prefix: Client
- //
- // * Code: InvalidBucketState Description: The request is not valid with
- // the current state of the bucket. HTTP Status Code: 409 Conflict SOAP Fault
- // Code Prefix: Client
- //
- // * Code: InvalidDigest Description: The Content-MD5 you specified is not
- // valid. HTTP Status Code: 400 Bad Request SOAP Fault Code Prefix: Client
- //
- // * Code: InvalidEncryptionAlgorithmError Description: The encryption request
- // you specified is not valid. The valid value is AES256. HTTP Status Code:
- // 400 Bad Request SOAP Fault Code Prefix: Client
- //
- // * Code: InvalidLocationConstraint Description: The specified location
- // constraint is not valid. For more information about Regions, see How to
- // Select a Region for Your Buckets (https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingBucket.html#access-bucket-intro).
- // HTTP Status Code: 400 Bad Request SOAP Fault Code Prefix: Client
- //
- // * Code: InvalidObjectState Description: The action is not valid for the
- // current state of the object. HTTP Status Code: 403 Forbidden SOAP Fault
- // Code Prefix: Client
- //
- // * Code: InvalidPart Description: One or more of the specified parts could
- // not be found. The part might not have been uploaded, or the specified
- // entity tag might not have matched the part's entity tag. HTTP Status Code:
- // 400 Bad Request SOAP Fault Code Prefix: Client
- //
- // * Code: InvalidPartOrder Description: The list of parts was not in ascending
- // order. Parts list must be specified in order by part number. HTTP Status
- // Code: 400 Bad Request SOAP Fault Code Prefix: Client
- //
- // * Code: InvalidPayer Description: All access to this object has been disabled.
- // Please contact Amazon Web Services Support for further assistance. HTTP
- // Status Code: 403 Forbidden SOAP Fault Code Prefix: Client
- //
- // * Code: InvalidPolicyDocument Description: The content of the form does
- // not meet the conditions specified in the policy document. HTTP Status
- // Code: 400 Bad Request SOAP Fault Code Prefix: Client
- //
- // * Code: InvalidRange Description: The requested range cannot be satisfied.
- // HTTP Status Code: 416 Requested Range Not Satisfiable SOAP Fault Code
- // Prefix: Client
- //
- // * Code: InvalidRequest Description: Please use AWS4-HMAC-SHA256. HTTP
- // Status Code: 400 Bad Request Code: N/A
- //
- // * Code: InvalidRequest Description: SOAP requests must be made over an
- // HTTPS connection. HTTP Status Code: 400 Bad Request SOAP Fault Code Prefix:
- // Client
- //
- // * Code: InvalidRequest Description: Amazon S3 Transfer Acceleration is
- // not supported for buckets with non-DNS compliant names. HTTP Status Code:
- // 400 Bad Request Code: N/A
- //
- // * Code: InvalidRequest Description: Amazon S3 Transfer Acceleration is
- // not supported for buckets with periods (.) in their names. HTTP Status
- // Code: 400 Bad Request Code: N/A
- //
- // * Code: InvalidRequest Description: Amazon S3 Transfer Accelerate endpoint
- // only supports virtual style requests. HTTP Status Code: 400 Bad Request
- // Code: N/A
- //
- // * Code: InvalidRequest Description: Amazon S3 Transfer Accelerate is not
- // configured on this bucket. HTTP Status Code: 400 Bad Request Code: N/A
- //
- // * Code: InvalidRequest Description: Amazon S3 Transfer Accelerate is disabled
- // on this bucket. HTTP Status Code: 400 Bad Request Code: N/A
- //
- // * Code: InvalidRequest Description: Amazon S3 Transfer Acceleration is
- // not supported on this bucket. Contact Amazon Web Services Support for
- // more information. HTTP Status Code: 400 Bad Request Code: N/A
- //
- // * Code: InvalidRequest Description: Amazon S3 Transfer Acceleration cannot
- // be enabled on this bucket. Contact Amazon Web Services Support for more
- // information. HTTP Status Code: 400 Bad Request Code: N/A
- //
- // * Code: InvalidSecurity Description: The provided security credentials
- // are not valid. HTTP Status Code: 403 Forbidden SOAP Fault Code Prefix:
- // Client
- //
- // * Code: InvalidSOAPRequest Description: The SOAP request body is invalid.
- // HTTP Status Code: 400 Bad Request SOAP Fault Code Prefix: Client
- //
- // * Code: InvalidStorageClass Description: The storage class you specified
- // is not valid. HTTP Status Code: 400 Bad Request SOAP Fault Code Prefix:
- // Client
- //
- // * Code: InvalidTargetBucketForLogging Description: The target bucket for
- // logging does not exist, is not owned by you, or does not have the appropriate
- // grants for the log-delivery group. HTTP Status Code: 400 Bad Request SOAP
- // Fault Code Prefix: Client
- //
- // * Code: InvalidToken Description: The provided token is malformed or otherwise
- // invalid. HTTP Status Code: 400 Bad Request SOAP Fault Code Prefix: Client
- //
- // * Code: InvalidURI Description: Couldn't parse the specified URI. HTTP
- // Status Code: 400 Bad Request SOAP Fault Code Prefix: Client
- //
- // * Code: KeyTooLongError Description: Your key is too long. HTTP Status
- // Code: 400 Bad Request SOAP Fault Code Prefix: Client
- //
- // * Code: MalformedACLError Description: The XML you provided was not well-formed
- // or did not validate against our published schema. HTTP Status Code: 400
- // Bad Request SOAP Fault Code Prefix: Client
- //
- // * Code: MalformedPOSTRequest Description: The body of your POST request
- // is not well-formed multipart/form-data. HTTP Status Code: 400 Bad Request
- // SOAP Fault Code Prefix: Client
- //
- // * Code: MalformedXML Description: This happens when the user sends malformed
- // XML (XML that doesn't conform to the published XSD) for the configuration.
- // The error message is, "The XML you provided was not well-formed or did
- // not validate against our published schema." HTTP Status Code: 400 Bad
- // Request SOAP Fault Code Prefix: Client
- //
- // * Code: MaxMessageLengthExceeded Description: Your request was too big.
- // HTTP Status Code: 400 Bad Request SOAP Fault Code Prefix: Client
- //
- // * Code: MaxPostPreDataLengthExceededError Description: Your POST request
- // fields preceding the upload file were too large. HTTP Status Code: 400
- // Bad Request SOAP Fault Code Prefix: Client
- //
- // * Code: MetadataTooLarge Description: Your metadata headers exceed the
- // maximum allowed metadata size. HTTP Status Code: 400 Bad Request SOAP
- // Fault Code Prefix: Client
- //
- // * Code: MethodNotAllowed Description: The specified method is not allowed
- // against this resource. HTTP Status Code: 405 Method Not Allowed SOAP Fault
- // Code Prefix: Client
- //
- // * Code: MissingAttachment Description: A SOAP attachment was expected,
- // but none were found. HTTP Status Code: N/A SOAP Fault Code Prefix: Client
- //
- // * Code: MissingContentLength Description: You must provide the Content-Length
- // HTTP header. HTTP Status Code: 411 Length Required SOAP Fault Code Prefix:
- // Client
- //
- // * Code: MissingRequestBodyError Description: This happens when the user
- // sends an empty XML document as a request. The error message is, "Request
- // body is empty." HTTP Status Code: 400 Bad Request SOAP Fault Code Prefix:
- // Client
- //
- // * Code: MissingSecurityElement Description: The SOAP 1.1 request is missing
- // a security element. HTTP Status Code: 400 Bad Request SOAP Fault Code
- // Prefix: Client
- //
- // * Code: MissingSecurityHeader Description: Your request is missing a required
- // header. HTTP Status Code: 400 Bad Request SOAP Fault Code Prefix: Client
- //
- // * Code: NoLoggingStatusForKey Description: There is no such thing as a
- // logging status subresource for a key. HTTP Status Code: 400 Bad Request
- // SOAP Fault Code Prefix: Client
- //
- // * Code: NoSuchBucket Description: The specified bucket does not exist.
- // HTTP Status Code: 404 Not Found SOAP Fault Code Prefix: Client
- //
- // * Code: NoSuchBucketPolicy Description: The specified bucket does not
- // have a bucket policy. HTTP Status Code: 404 Not Found SOAP Fault Code
- // Prefix: Client
- //
- // * Code: NoSuchKey Description: The specified key does not exist. HTTP
- // Status Code: 404 Not Found SOAP Fault Code Prefix: Client
- //
- // * Code: NoSuchLifecycleConfiguration Description: The lifecycle configuration
- // does not exist. HTTP Status Code: 404 Not Found SOAP Fault Code Prefix:
- // Client
- //
- // * Code: NoSuchUpload Description: The specified multipart upload does
- // not exist. The upload ID might be invalid, or the multipart upload might
- // have been aborted or completed. HTTP Status Code: 404 Not Found SOAP Fault
- // Code Prefix: Client
- //
- // * Code: NoSuchVersion Description: Indicates that the version ID specified
- // in the request does not match an existing version. HTTP Status Code: 404
- // Not Found SOAP Fault Code Prefix: Client
- //
- // * Code: NotImplemented Description: A header you provided implies functionality
- // that is not implemented. HTTP Status Code: 501 Not Implemented SOAP Fault
- // Code Prefix: Server
- //
- // * Code: NotSignedUp Description: Your account is not signed up for the
- // Amazon S3 service. You must sign up before you can use Amazon S3. You
- // can sign up at the following URL: Amazon S3 (http://aws.amazon.com/s3)
- // HTTP Status Code: 403 Forbidden SOAP Fault Code Prefix: Client
- //
- // * Code: OperationAborted Description: A conflicting conditional action
- // is currently in progress against this resource. Try again. HTTP Status
- // Code: 409 Conflict SOAP Fault Code Prefix: Client
- //
- // * Code: PermanentRedirect Description: The bucket you are attempting to
- // access must be addressed using the specified endpoint. Send all future
- // requests to this endpoint. HTTP Status Code: 301 Moved Permanently SOAP
- // Fault Code Prefix: Client
- //
- // * Code: PreconditionFailed Description: At least one of the preconditions
- // you specified did not hold. HTTP Status Code: 412 Precondition Failed
- // SOAP Fault Code Prefix: Client
- //
- // * Code: Redirect Description: Temporary redirect. HTTP Status Code: 307
- // Moved Temporarily SOAP Fault Code Prefix: Client
- //
- // * Code: RestoreAlreadyInProgress Description: Object restore is already
- // in progress. HTTP Status Code: 409 Conflict SOAP Fault Code Prefix: Client
- //
- // * Code: RequestIsNotMultiPartContent Description: Bucket POST must be
- // of the enclosure-type multipart/form-data. HTTP Status Code: 400 Bad Request
- // SOAP Fault Code Prefix: Client
- //
- // * Code: RequestTimeout Description: Your socket connection to the server
- // was not read from or written to within the timeout period. HTTP Status
- // Code: 400 Bad Request SOAP Fault Code Prefix: Client
- //
- // * Code: RequestTimeTooSkewed Description: The difference between the request
- // time and the server's time is too large. HTTP Status Code: 403 Forbidden
- // SOAP Fault Code Prefix: Client
- //
- // * Code: RequestTorrentOfBucketError Description: Requesting the torrent
- // file of a bucket is not permitted. HTTP Status Code: 400 Bad Request SOAP
- // Fault Code Prefix: Client
- //
- // * Code: SignatureDoesNotMatch Description: The request signature we calculated
- // does not match the signature you provided. Check your Amazon Web Services
- // secret access key and signing method. For more information, see REST Authentication
- // (https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html)
- // and SOAP Authentication (https://docs.aws.amazon.com/AmazonS3/latest/dev/SOAPAuthentication.html)
- // for details. HTTP Status Code: 403 Forbidden SOAP Fault Code Prefix: Client
- //
- // * Code: ServiceUnavailable Description: Reduce your request rate. HTTP
- // Status Code: 503 Service Unavailable SOAP Fault Code Prefix: Server
- //
- // * Code: SlowDown Description: Reduce your request rate. HTTP Status Code:
- // 503 Slow Down SOAP Fault Code Prefix: Server
- //
- // * Code: TemporaryRedirect Description: You are being redirected to the
- // bucket while DNS updates. HTTP Status Code: 307 Moved Temporarily SOAP
- // Fault Code Prefix: Client
- //
- // * Code: TokenRefreshRequired Description: The provided token must be refreshed.
- // HTTP Status Code: 400 Bad Request SOAP Fault Code Prefix: Client
- //
- // * Code: TooManyBuckets Description: You have attempted to create more
- // buckets than allowed. HTTP Status Code: 400 Bad Request SOAP Fault Code
- // Prefix: Client
- //
- // * Code: UnexpectedContent Description: This request does not support content.
- // HTTP Status Code: 400 Bad Request SOAP Fault Code Prefix: Client
- //
- // * Code: UnresolvableGrantByEmailAddress Description: The email address
- // you provided does not match any account on record. HTTP Status Code: 400
- // Bad Request SOAP Fault Code Prefix: Client
- //
- // * Code: UserKeyMustBeSpecified Description: The bucket POST must contain
- // the specified field name. If it is specified, check the order of the fields.
- // HTTP Status Code: 400 Bad Request SOAP Fault Code Prefix: Client
- Code *string `type:"string"`
- // The error key.
- Key *string `min:"1" type:"string"`
- // The error message contains a generic description of the error condition in
- // English. It is intended for a human audience. Simple programs display the
- // message directly to the end user if they encounter an error condition they
- // don't know how or don't care to handle. Sophisticated programs with more
- // exhaustive error handling and proper internationalization are more likely
- // to ignore the error message.
- Message *string `type:"string"`
- // The version ID of the error.
- VersionId *string `type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s Error) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s Error) GoString() string {
- return s.String()
- }
- // SetCode sets the Code field's value.
- func (s *Error) SetCode(v string) *Error {
- s.Code = &v
- return s
- }
- // SetKey sets the Key field's value.
- func (s *Error) SetKey(v string) *Error {
- s.Key = &v
- return s
- }
- // SetMessage sets the Message field's value.
- func (s *Error) SetMessage(v string) *Error {
- s.Message = &v
- return s
- }
- // SetVersionId sets the VersionId field's value.
- func (s *Error) SetVersionId(v string) *Error {
- s.VersionId = &v
- return s
- }
- // The error information.
- type ErrorDocument struct {
- _ struct{} `type:"structure"`
- // The object key name to use when a 4XX class error occurs.
- //
- // Replacement must be made for object keys containing special characters (such
- // as carriage returns) when using XML requests. For more information, see XML
- // related object key constraints (https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html#object-key-xml-related-constraints).
- //
- // Key is a required field
- Key *string `min:"1" type:"string" required:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ErrorDocument) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ErrorDocument) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *ErrorDocument) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "ErrorDocument"}
- if s.Key == nil {
- invalidParams.Add(request.NewErrParamRequired("Key"))
- }
- if s.Key != nil && len(*s.Key) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Key", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetKey sets the Key field's value.
- func (s *ErrorDocument) SetKey(v string) *ErrorDocument {
- s.Key = &v
- return s
- }
- // A container for specifying the configuration for Amazon EventBridge.
- type EventBridgeConfiguration struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s EventBridgeConfiguration) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s EventBridgeConfiguration) GoString() string {
- return s.String()
- }
- // Optional configuration to replicate existing source bucket objects. For more
- // information, see Replicating Existing Objects (https://docs.aws.amazon.com/AmazonS3/latest/dev/replication-what-is-isnot-replicated.html#existing-object-replication)
- // in the Amazon S3 User Guide.
- type ExistingObjectReplication struct {
- _ struct{} `type:"structure"`
- // Status is a required field
- Status *string `type:"string" required:"true" enum:"ExistingObjectReplicationStatus"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ExistingObjectReplication) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ExistingObjectReplication) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *ExistingObjectReplication) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "ExistingObjectReplication"}
- if s.Status == nil {
- invalidParams.Add(request.NewErrParamRequired("Status"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetStatus sets the Status field's value.
- func (s *ExistingObjectReplication) SetStatus(v string) *ExistingObjectReplication {
- s.Status = &v
- return s
- }
- // Specifies the Amazon S3 object key name to filter on and whether to filter
- // on the suffix or prefix of the key name.
- type FilterRule struct {
- _ struct{} `type:"structure"`
- // The object key name prefix or suffix identifying one or more objects to which
- // the filtering rule applies. The maximum length is 1,024 characters. Overlapping
- // prefixes and suffixes are not supported. For more information, see Configuring
- // Event Notifications (https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html)
- // in the Amazon S3 User Guide.
- Name *string `type:"string" enum:"FilterRuleName"`
- // The value that the filter searches for in object key names.
- Value *string `type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s FilterRule) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s FilterRule) GoString() string {
- return s.String()
- }
- // SetName sets the Name field's value.
- func (s *FilterRule) SetName(v string) *FilterRule {
- s.Name = &v
- return s
- }
- // SetValue sets the Value field's value.
- func (s *FilterRule) SetValue(v string) *FilterRule {
- s.Value = &v
- return s
- }
- type GetBucketAccelerateConfigurationInput struct {
- _ struct{} `locationName:"GetBucketAccelerateConfigurationRequest" type:"structure"`
- // The name of the bucket for which the accelerate configuration is retrieved.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketAccelerateConfigurationInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketAccelerateConfigurationInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *GetBucketAccelerateConfigurationInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "GetBucketAccelerateConfigurationInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *GetBucketAccelerateConfigurationInput) SetBucket(v string) *GetBucketAccelerateConfigurationInput {
- s.Bucket = &v
- return s
- }
- func (s *GetBucketAccelerateConfigurationInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *GetBucketAccelerateConfigurationInput) SetExpectedBucketOwner(v string) *GetBucketAccelerateConfigurationInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- func (s *GetBucketAccelerateConfigurationInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *GetBucketAccelerateConfigurationInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s GetBucketAccelerateConfigurationInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type GetBucketAccelerateConfigurationOutput struct {
- _ struct{} `type:"structure"`
- // The accelerate configuration of the bucket.
- Status *string `type:"string" enum:"BucketAccelerateStatus"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketAccelerateConfigurationOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketAccelerateConfigurationOutput) GoString() string {
- return s.String()
- }
- // SetStatus sets the Status field's value.
- func (s *GetBucketAccelerateConfigurationOutput) SetStatus(v string) *GetBucketAccelerateConfigurationOutput {
- s.Status = &v
- return s
- }
- type GetBucketAclInput struct {
- _ struct{} `locationName:"GetBucketAclRequest" type:"structure"`
- // Specifies the S3 bucket whose ACL is being requested.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketAclInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketAclInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *GetBucketAclInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "GetBucketAclInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *GetBucketAclInput) SetBucket(v string) *GetBucketAclInput {
- s.Bucket = &v
- return s
- }
- func (s *GetBucketAclInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *GetBucketAclInput) SetExpectedBucketOwner(v string) *GetBucketAclInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- func (s *GetBucketAclInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *GetBucketAclInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s GetBucketAclInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type GetBucketAclOutput struct {
- _ struct{} `type:"structure"`
- // A list of grants.
- Grants []*Grant `locationName:"AccessControlList" locationNameList:"Grant" type:"list"`
- // Container for the bucket owner's display name and ID.
- Owner *Owner `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketAclOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketAclOutput) GoString() string {
- return s.String()
- }
- // SetGrants sets the Grants field's value.
- func (s *GetBucketAclOutput) SetGrants(v []*Grant) *GetBucketAclOutput {
- s.Grants = v
- return s
- }
- // SetOwner sets the Owner field's value.
- func (s *GetBucketAclOutput) SetOwner(v *Owner) *GetBucketAclOutput {
- s.Owner = v
- return s
- }
- type GetBucketAnalyticsConfigurationInput struct {
- _ struct{} `locationName:"GetBucketAnalyticsConfigurationRequest" type:"structure"`
- // The name of the bucket from which an analytics configuration is retrieved.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // The ID that identifies the analytics configuration.
- //
- // Id is a required field
- Id *string `location:"querystring" locationName:"id" type:"string" required:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketAnalyticsConfigurationInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketAnalyticsConfigurationInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *GetBucketAnalyticsConfigurationInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "GetBucketAnalyticsConfigurationInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.Id == nil {
- invalidParams.Add(request.NewErrParamRequired("Id"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *GetBucketAnalyticsConfigurationInput) SetBucket(v string) *GetBucketAnalyticsConfigurationInput {
- s.Bucket = &v
- return s
- }
- func (s *GetBucketAnalyticsConfigurationInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *GetBucketAnalyticsConfigurationInput) SetExpectedBucketOwner(v string) *GetBucketAnalyticsConfigurationInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetId sets the Id field's value.
- func (s *GetBucketAnalyticsConfigurationInput) SetId(v string) *GetBucketAnalyticsConfigurationInput {
- s.Id = &v
- return s
- }
- func (s *GetBucketAnalyticsConfigurationInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *GetBucketAnalyticsConfigurationInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s GetBucketAnalyticsConfigurationInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type GetBucketAnalyticsConfigurationOutput struct {
- _ struct{} `type:"structure" payload:"AnalyticsConfiguration"`
- // The configuration and any analyses for the analytics filter.
- AnalyticsConfiguration *AnalyticsConfiguration `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketAnalyticsConfigurationOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketAnalyticsConfigurationOutput) GoString() string {
- return s.String()
- }
- // SetAnalyticsConfiguration sets the AnalyticsConfiguration field's value.
- func (s *GetBucketAnalyticsConfigurationOutput) SetAnalyticsConfiguration(v *AnalyticsConfiguration) *GetBucketAnalyticsConfigurationOutput {
- s.AnalyticsConfiguration = v
- return s
- }
- type GetBucketCorsInput struct {
- _ struct{} `locationName:"GetBucketCorsRequest" type:"structure"`
- // The bucket name for which to get the cors configuration.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketCorsInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketCorsInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *GetBucketCorsInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "GetBucketCorsInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *GetBucketCorsInput) SetBucket(v string) *GetBucketCorsInput {
- s.Bucket = &v
- return s
- }
- func (s *GetBucketCorsInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *GetBucketCorsInput) SetExpectedBucketOwner(v string) *GetBucketCorsInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- func (s *GetBucketCorsInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *GetBucketCorsInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s GetBucketCorsInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type GetBucketCorsOutput struct {
- _ struct{} `type:"structure"`
- // A set of origins and methods (cross-origin access that you want to allow).
- // You can add up to 100 rules to the configuration.
- CORSRules []*CORSRule `locationName:"CORSRule" type:"list" flattened:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketCorsOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketCorsOutput) GoString() string {
- return s.String()
- }
- // SetCORSRules sets the CORSRules field's value.
- func (s *GetBucketCorsOutput) SetCORSRules(v []*CORSRule) *GetBucketCorsOutput {
- s.CORSRules = v
- return s
- }
- type GetBucketEncryptionInput struct {
- _ struct{} `locationName:"GetBucketEncryptionRequest" type:"structure"`
- // The name of the bucket from which the server-side encryption configuration
- // is retrieved.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketEncryptionInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketEncryptionInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *GetBucketEncryptionInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "GetBucketEncryptionInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *GetBucketEncryptionInput) SetBucket(v string) *GetBucketEncryptionInput {
- s.Bucket = &v
- return s
- }
- func (s *GetBucketEncryptionInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *GetBucketEncryptionInput) SetExpectedBucketOwner(v string) *GetBucketEncryptionInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- func (s *GetBucketEncryptionInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *GetBucketEncryptionInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s GetBucketEncryptionInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type GetBucketEncryptionOutput struct {
- _ struct{} `type:"structure" payload:"ServerSideEncryptionConfiguration"`
- // Specifies the default server-side-encryption configuration.
- ServerSideEncryptionConfiguration *ServerSideEncryptionConfiguration `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketEncryptionOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketEncryptionOutput) GoString() string {
- return s.String()
- }
- // SetServerSideEncryptionConfiguration sets the ServerSideEncryptionConfiguration field's value.
- func (s *GetBucketEncryptionOutput) SetServerSideEncryptionConfiguration(v *ServerSideEncryptionConfiguration) *GetBucketEncryptionOutput {
- s.ServerSideEncryptionConfiguration = v
- return s
- }
- type GetBucketIntelligentTieringConfigurationInput struct {
- _ struct{} `locationName:"GetBucketIntelligentTieringConfigurationRequest" type:"structure"`
- // The name of the Amazon S3 bucket whose configuration you want to modify or
- // retrieve.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The ID used to identify the S3 Intelligent-Tiering configuration.
- //
- // Id is a required field
- Id *string `location:"querystring" locationName:"id" type:"string" required:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketIntelligentTieringConfigurationInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketIntelligentTieringConfigurationInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *GetBucketIntelligentTieringConfigurationInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "GetBucketIntelligentTieringConfigurationInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.Id == nil {
- invalidParams.Add(request.NewErrParamRequired("Id"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *GetBucketIntelligentTieringConfigurationInput) SetBucket(v string) *GetBucketIntelligentTieringConfigurationInput {
- s.Bucket = &v
- return s
- }
- func (s *GetBucketIntelligentTieringConfigurationInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetId sets the Id field's value.
- func (s *GetBucketIntelligentTieringConfigurationInput) SetId(v string) *GetBucketIntelligentTieringConfigurationInput {
- s.Id = &v
- return s
- }
- func (s *GetBucketIntelligentTieringConfigurationInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *GetBucketIntelligentTieringConfigurationInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s GetBucketIntelligentTieringConfigurationInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type GetBucketIntelligentTieringConfigurationOutput struct {
- _ struct{} `type:"structure" payload:"IntelligentTieringConfiguration"`
- // Container for S3 Intelligent-Tiering configuration.
- IntelligentTieringConfiguration *IntelligentTieringConfiguration `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketIntelligentTieringConfigurationOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketIntelligentTieringConfigurationOutput) GoString() string {
- return s.String()
- }
- // SetIntelligentTieringConfiguration sets the IntelligentTieringConfiguration field's value.
- func (s *GetBucketIntelligentTieringConfigurationOutput) SetIntelligentTieringConfiguration(v *IntelligentTieringConfiguration) *GetBucketIntelligentTieringConfigurationOutput {
- s.IntelligentTieringConfiguration = v
- return s
- }
- type GetBucketInventoryConfigurationInput struct {
- _ struct{} `locationName:"GetBucketInventoryConfigurationRequest" type:"structure"`
- // The name of the bucket containing the inventory configuration to retrieve.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // The ID used to identify the inventory configuration.
- //
- // Id is a required field
- Id *string `location:"querystring" locationName:"id" type:"string" required:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketInventoryConfigurationInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketInventoryConfigurationInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *GetBucketInventoryConfigurationInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "GetBucketInventoryConfigurationInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.Id == nil {
- invalidParams.Add(request.NewErrParamRequired("Id"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *GetBucketInventoryConfigurationInput) SetBucket(v string) *GetBucketInventoryConfigurationInput {
- s.Bucket = &v
- return s
- }
- func (s *GetBucketInventoryConfigurationInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *GetBucketInventoryConfigurationInput) SetExpectedBucketOwner(v string) *GetBucketInventoryConfigurationInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetId sets the Id field's value.
- func (s *GetBucketInventoryConfigurationInput) SetId(v string) *GetBucketInventoryConfigurationInput {
- s.Id = &v
- return s
- }
- func (s *GetBucketInventoryConfigurationInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *GetBucketInventoryConfigurationInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s GetBucketInventoryConfigurationInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type GetBucketInventoryConfigurationOutput struct {
- _ struct{} `type:"structure" payload:"InventoryConfiguration"`
- // Specifies the inventory configuration.
- InventoryConfiguration *InventoryConfiguration `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketInventoryConfigurationOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketInventoryConfigurationOutput) GoString() string {
- return s.String()
- }
- // SetInventoryConfiguration sets the InventoryConfiguration field's value.
- func (s *GetBucketInventoryConfigurationOutput) SetInventoryConfiguration(v *InventoryConfiguration) *GetBucketInventoryConfigurationOutput {
- s.InventoryConfiguration = v
- return s
- }
- type GetBucketLifecycleConfigurationInput struct {
- _ struct{} `locationName:"GetBucketLifecycleConfigurationRequest" type:"structure"`
- // The name of the bucket for which to get the lifecycle information.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketLifecycleConfigurationInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketLifecycleConfigurationInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *GetBucketLifecycleConfigurationInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "GetBucketLifecycleConfigurationInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *GetBucketLifecycleConfigurationInput) SetBucket(v string) *GetBucketLifecycleConfigurationInput {
- s.Bucket = &v
- return s
- }
- func (s *GetBucketLifecycleConfigurationInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *GetBucketLifecycleConfigurationInput) SetExpectedBucketOwner(v string) *GetBucketLifecycleConfigurationInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- func (s *GetBucketLifecycleConfigurationInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *GetBucketLifecycleConfigurationInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s GetBucketLifecycleConfigurationInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type GetBucketLifecycleConfigurationOutput struct {
- _ struct{} `type:"structure"`
- // Container for a lifecycle rule.
- Rules []*LifecycleRule `locationName:"Rule" type:"list" flattened:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketLifecycleConfigurationOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketLifecycleConfigurationOutput) GoString() string {
- return s.String()
- }
- // SetRules sets the Rules field's value.
- func (s *GetBucketLifecycleConfigurationOutput) SetRules(v []*LifecycleRule) *GetBucketLifecycleConfigurationOutput {
- s.Rules = v
- return s
- }
- type GetBucketLifecycleInput struct {
- _ struct{} `locationName:"GetBucketLifecycleRequest" type:"structure"`
- // The name of the bucket for which to get the lifecycle information.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketLifecycleInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketLifecycleInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *GetBucketLifecycleInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "GetBucketLifecycleInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *GetBucketLifecycleInput) SetBucket(v string) *GetBucketLifecycleInput {
- s.Bucket = &v
- return s
- }
- func (s *GetBucketLifecycleInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *GetBucketLifecycleInput) SetExpectedBucketOwner(v string) *GetBucketLifecycleInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- func (s *GetBucketLifecycleInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *GetBucketLifecycleInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s GetBucketLifecycleInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type GetBucketLifecycleOutput struct {
- _ struct{} `type:"structure"`
- // Container for a lifecycle rule.
- Rules []*Rule `locationName:"Rule" type:"list" flattened:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketLifecycleOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketLifecycleOutput) GoString() string {
- return s.String()
- }
- // SetRules sets the Rules field's value.
- func (s *GetBucketLifecycleOutput) SetRules(v []*Rule) *GetBucketLifecycleOutput {
- s.Rules = v
- return s
- }
- type GetBucketLocationInput struct {
- _ struct{} `locationName:"GetBucketLocationRequest" type:"structure"`
- // The name of the bucket for which to get the location.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketLocationInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketLocationInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *GetBucketLocationInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "GetBucketLocationInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *GetBucketLocationInput) SetBucket(v string) *GetBucketLocationInput {
- s.Bucket = &v
- return s
- }
- func (s *GetBucketLocationInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *GetBucketLocationInput) SetExpectedBucketOwner(v string) *GetBucketLocationInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- func (s *GetBucketLocationInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *GetBucketLocationInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s GetBucketLocationInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type GetBucketLocationOutput struct {
- _ struct{} `type:"structure"`
- // Specifies the Region where the bucket resides. For a list of all the Amazon
- // S3 supported location constraints by Region, see Regions and Endpoints (https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region).
- // Buckets in Region us-east-1 have a LocationConstraint of null.
- LocationConstraint *string `type:"string" enum:"BucketLocationConstraint"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketLocationOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketLocationOutput) GoString() string {
- return s.String()
- }
- // SetLocationConstraint sets the LocationConstraint field's value.
- func (s *GetBucketLocationOutput) SetLocationConstraint(v string) *GetBucketLocationOutput {
- s.LocationConstraint = &v
- return s
- }
- type GetBucketLoggingInput struct {
- _ struct{} `locationName:"GetBucketLoggingRequest" type:"structure"`
- // The bucket name for which to get the logging information.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketLoggingInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketLoggingInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *GetBucketLoggingInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "GetBucketLoggingInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *GetBucketLoggingInput) SetBucket(v string) *GetBucketLoggingInput {
- s.Bucket = &v
- return s
- }
- func (s *GetBucketLoggingInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *GetBucketLoggingInput) SetExpectedBucketOwner(v string) *GetBucketLoggingInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- func (s *GetBucketLoggingInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *GetBucketLoggingInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s GetBucketLoggingInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type GetBucketLoggingOutput struct {
- _ struct{} `type:"structure"`
- // Describes where logs are stored and the prefix that Amazon S3 assigns to
- // all log object keys for a bucket. For more information, see PUT Bucket logging
- // (https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTlogging.html)
- // in the Amazon S3 API Reference.
- LoggingEnabled *LoggingEnabled `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketLoggingOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketLoggingOutput) GoString() string {
- return s.String()
- }
- // SetLoggingEnabled sets the LoggingEnabled field's value.
- func (s *GetBucketLoggingOutput) SetLoggingEnabled(v *LoggingEnabled) *GetBucketLoggingOutput {
- s.LoggingEnabled = v
- return s
- }
- type GetBucketMetricsConfigurationInput struct {
- _ struct{} `locationName:"GetBucketMetricsConfigurationRequest" type:"structure"`
- // The name of the bucket containing the metrics configuration to retrieve.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // The ID used to identify the metrics configuration.
- //
- // Id is a required field
- Id *string `location:"querystring" locationName:"id" type:"string" required:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketMetricsConfigurationInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketMetricsConfigurationInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *GetBucketMetricsConfigurationInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "GetBucketMetricsConfigurationInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.Id == nil {
- invalidParams.Add(request.NewErrParamRequired("Id"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *GetBucketMetricsConfigurationInput) SetBucket(v string) *GetBucketMetricsConfigurationInput {
- s.Bucket = &v
- return s
- }
- func (s *GetBucketMetricsConfigurationInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *GetBucketMetricsConfigurationInput) SetExpectedBucketOwner(v string) *GetBucketMetricsConfigurationInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetId sets the Id field's value.
- func (s *GetBucketMetricsConfigurationInput) SetId(v string) *GetBucketMetricsConfigurationInput {
- s.Id = &v
- return s
- }
- func (s *GetBucketMetricsConfigurationInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *GetBucketMetricsConfigurationInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s GetBucketMetricsConfigurationInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type GetBucketMetricsConfigurationOutput struct {
- _ struct{} `type:"structure" payload:"MetricsConfiguration"`
- // Specifies the metrics configuration.
- MetricsConfiguration *MetricsConfiguration `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketMetricsConfigurationOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketMetricsConfigurationOutput) GoString() string {
- return s.String()
- }
- // SetMetricsConfiguration sets the MetricsConfiguration field's value.
- func (s *GetBucketMetricsConfigurationOutput) SetMetricsConfiguration(v *MetricsConfiguration) *GetBucketMetricsConfigurationOutput {
- s.MetricsConfiguration = v
- return s
- }
- type GetBucketNotificationConfigurationRequest struct {
- _ struct{} `locationName:"GetBucketNotificationConfigurationRequest" type:"structure"`
- // The name of the bucket for which to get the notification configuration.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketNotificationConfigurationRequest) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketNotificationConfigurationRequest) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *GetBucketNotificationConfigurationRequest) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "GetBucketNotificationConfigurationRequest"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *GetBucketNotificationConfigurationRequest) SetBucket(v string) *GetBucketNotificationConfigurationRequest {
- s.Bucket = &v
- return s
- }
- func (s *GetBucketNotificationConfigurationRequest) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *GetBucketNotificationConfigurationRequest) SetExpectedBucketOwner(v string) *GetBucketNotificationConfigurationRequest {
- s.ExpectedBucketOwner = &v
- return s
- }
- func (s *GetBucketNotificationConfigurationRequest) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *GetBucketNotificationConfigurationRequest) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s GetBucketNotificationConfigurationRequest) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type GetBucketOwnershipControlsInput struct {
- _ struct{} `locationName:"GetBucketOwnershipControlsRequest" type:"structure"`
- // The name of the Amazon S3 bucket whose OwnershipControls you want to retrieve.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketOwnershipControlsInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketOwnershipControlsInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *GetBucketOwnershipControlsInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "GetBucketOwnershipControlsInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *GetBucketOwnershipControlsInput) SetBucket(v string) *GetBucketOwnershipControlsInput {
- s.Bucket = &v
- return s
- }
- func (s *GetBucketOwnershipControlsInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *GetBucketOwnershipControlsInput) SetExpectedBucketOwner(v string) *GetBucketOwnershipControlsInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- func (s *GetBucketOwnershipControlsInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *GetBucketOwnershipControlsInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s GetBucketOwnershipControlsInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type GetBucketOwnershipControlsOutput struct {
- _ struct{} `type:"structure" payload:"OwnershipControls"`
- // The OwnershipControls (BucketOwnerEnforced, BucketOwnerPreferred, or ObjectWriter)
- // currently in effect for this Amazon S3 bucket.
- OwnershipControls *OwnershipControls `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketOwnershipControlsOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketOwnershipControlsOutput) GoString() string {
- return s.String()
- }
- // SetOwnershipControls sets the OwnershipControls field's value.
- func (s *GetBucketOwnershipControlsOutput) SetOwnershipControls(v *OwnershipControls) *GetBucketOwnershipControlsOutput {
- s.OwnershipControls = v
- return s
- }
- type GetBucketPolicyInput struct {
- _ struct{} `locationName:"GetBucketPolicyRequest" type:"structure"`
- // The bucket name for which to get the bucket policy.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketPolicyInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketPolicyInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *GetBucketPolicyInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "GetBucketPolicyInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *GetBucketPolicyInput) SetBucket(v string) *GetBucketPolicyInput {
- s.Bucket = &v
- return s
- }
- func (s *GetBucketPolicyInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *GetBucketPolicyInput) SetExpectedBucketOwner(v string) *GetBucketPolicyInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- func (s *GetBucketPolicyInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *GetBucketPolicyInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s GetBucketPolicyInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type GetBucketPolicyOutput struct {
- _ struct{} `type:"structure" payload:"Policy"`
- // The bucket policy as a JSON document.
- Policy *string `type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketPolicyOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketPolicyOutput) GoString() string {
- return s.String()
- }
- // SetPolicy sets the Policy field's value.
- func (s *GetBucketPolicyOutput) SetPolicy(v string) *GetBucketPolicyOutput {
- s.Policy = &v
- return s
- }
- type GetBucketPolicyStatusInput struct {
- _ struct{} `locationName:"GetBucketPolicyStatusRequest" type:"structure"`
- // The name of the Amazon S3 bucket whose policy status you want to retrieve.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketPolicyStatusInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketPolicyStatusInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *GetBucketPolicyStatusInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "GetBucketPolicyStatusInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *GetBucketPolicyStatusInput) SetBucket(v string) *GetBucketPolicyStatusInput {
- s.Bucket = &v
- return s
- }
- func (s *GetBucketPolicyStatusInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *GetBucketPolicyStatusInput) SetExpectedBucketOwner(v string) *GetBucketPolicyStatusInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- func (s *GetBucketPolicyStatusInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *GetBucketPolicyStatusInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s GetBucketPolicyStatusInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type GetBucketPolicyStatusOutput struct {
- _ struct{} `type:"structure" payload:"PolicyStatus"`
- // The policy status for the specified bucket.
- PolicyStatus *PolicyStatus `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketPolicyStatusOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketPolicyStatusOutput) GoString() string {
- return s.String()
- }
- // SetPolicyStatus sets the PolicyStatus field's value.
- func (s *GetBucketPolicyStatusOutput) SetPolicyStatus(v *PolicyStatus) *GetBucketPolicyStatusOutput {
- s.PolicyStatus = v
- return s
- }
- type GetBucketReplicationInput struct {
- _ struct{} `locationName:"GetBucketReplicationRequest" type:"structure"`
- // The bucket name for which to get the replication information.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketReplicationInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketReplicationInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *GetBucketReplicationInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "GetBucketReplicationInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *GetBucketReplicationInput) SetBucket(v string) *GetBucketReplicationInput {
- s.Bucket = &v
- return s
- }
- func (s *GetBucketReplicationInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *GetBucketReplicationInput) SetExpectedBucketOwner(v string) *GetBucketReplicationInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- func (s *GetBucketReplicationInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *GetBucketReplicationInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s GetBucketReplicationInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type GetBucketReplicationOutput struct {
- _ struct{} `type:"structure" payload:"ReplicationConfiguration"`
- // A container for replication rules. You can add up to 1,000 rules. The maximum
- // size of a replication configuration is 2 MB.
- ReplicationConfiguration *ReplicationConfiguration `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketReplicationOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketReplicationOutput) GoString() string {
- return s.String()
- }
- // SetReplicationConfiguration sets the ReplicationConfiguration field's value.
- func (s *GetBucketReplicationOutput) SetReplicationConfiguration(v *ReplicationConfiguration) *GetBucketReplicationOutput {
- s.ReplicationConfiguration = v
- return s
- }
- type GetBucketRequestPaymentInput struct {
- _ struct{} `locationName:"GetBucketRequestPaymentRequest" type:"structure"`
- // The name of the bucket for which to get the payment request configuration
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketRequestPaymentInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketRequestPaymentInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *GetBucketRequestPaymentInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "GetBucketRequestPaymentInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *GetBucketRequestPaymentInput) SetBucket(v string) *GetBucketRequestPaymentInput {
- s.Bucket = &v
- return s
- }
- func (s *GetBucketRequestPaymentInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *GetBucketRequestPaymentInput) SetExpectedBucketOwner(v string) *GetBucketRequestPaymentInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- func (s *GetBucketRequestPaymentInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *GetBucketRequestPaymentInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s GetBucketRequestPaymentInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type GetBucketRequestPaymentOutput struct {
- _ struct{} `type:"structure"`
- // Specifies who pays for the download and request fees.
- Payer *string `type:"string" enum:"Payer"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketRequestPaymentOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketRequestPaymentOutput) GoString() string {
- return s.String()
- }
- // SetPayer sets the Payer field's value.
- func (s *GetBucketRequestPaymentOutput) SetPayer(v string) *GetBucketRequestPaymentOutput {
- s.Payer = &v
- return s
- }
- type GetBucketTaggingInput struct {
- _ struct{} `locationName:"GetBucketTaggingRequest" type:"structure"`
- // The name of the bucket for which to get the tagging information.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketTaggingInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketTaggingInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *GetBucketTaggingInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "GetBucketTaggingInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *GetBucketTaggingInput) SetBucket(v string) *GetBucketTaggingInput {
- s.Bucket = &v
- return s
- }
- func (s *GetBucketTaggingInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *GetBucketTaggingInput) SetExpectedBucketOwner(v string) *GetBucketTaggingInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- func (s *GetBucketTaggingInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *GetBucketTaggingInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s GetBucketTaggingInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type GetBucketTaggingOutput struct {
- _ struct{} `type:"structure"`
- // Contains the tag set.
- //
- // TagSet is a required field
- TagSet []*Tag `locationNameList:"Tag" type:"list" required:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketTaggingOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketTaggingOutput) GoString() string {
- return s.String()
- }
- // SetTagSet sets the TagSet field's value.
- func (s *GetBucketTaggingOutput) SetTagSet(v []*Tag) *GetBucketTaggingOutput {
- s.TagSet = v
- return s
- }
- type GetBucketVersioningInput struct {
- _ struct{} `locationName:"GetBucketVersioningRequest" type:"structure"`
- // The name of the bucket for which to get the versioning information.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketVersioningInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketVersioningInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *GetBucketVersioningInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "GetBucketVersioningInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *GetBucketVersioningInput) SetBucket(v string) *GetBucketVersioningInput {
- s.Bucket = &v
- return s
- }
- func (s *GetBucketVersioningInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *GetBucketVersioningInput) SetExpectedBucketOwner(v string) *GetBucketVersioningInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- func (s *GetBucketVersioningInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *GetBucketVersioningInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s GetBucketVersioningInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type GetBucketVersioningOutput struct {
- _ struct{} `type:"structure"`
- // Specifies whether MFA delete is enabled in the bucket versioning configuration.
- // This element is only returned if the bucket has been configured with MFA
- // delete. If the bucket has never been so configured, this element is not returned.
- MFADelete *string `locationName:"MfaDelete" type:"string" enum:"MFADeleteStatus"`
- // The versioning state of the bucket.
- Status *string `type:"string" enum:"BucketVersioningStatus"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketVersioningOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketVersioningOutput) GoString() string {
- return s.String()
- }
- // SetMFADelete sets the MFADelete field's value.
- func (s *GetBucketVersioningOutput) SetMFADelete(v string) *GetBucketVersioningOutput {
- s.MFADelete = &v
- return s
- }
- // SetStatus sets the Status field's value.
- func (s *GetBucketVersioningOutput) SetStatus(v string) *GetBucketVersioningOutput {
- s.Status = &v
- return s
- }
- type GetBucketWebsiteInput struct {
- _ struct{} `locationName:"GetBucketWebsiteRequest" type:"structure"`
- // The bucket name for which to get the website configuration.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketWebsiteInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketWebsiteInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *GetBucketWebsiteInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "GetBucketWebsiteInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *GetBucketWebsiteInput) SetBucket(v string) *GetBucketWebsiteInput {
- s.Bucket = &v
- return s
- }
- func (s *GetBucketWebsiteInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *GetBucketWebsiteInput) SetExpectedBucketOwner(v string) *GetBucketWebsiteInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- func (s *GetBucketWebsiteInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *GetBucketWebsiteInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s GetBucketWebsiteInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type GetBucketWebsiteOutput struct {
- _ struct{} `type:"structure"`
- // The object key name of the website error document to use for 4XX class errors.
- ErrorDocument *ErrorDocument `type:"structure"`
- // The name of the index document for the website (for example index.html).
- IndexDocument *IndexDocument `type:"structure"`
- // Specifies the redirect behavior of all requests to a website endpoint of
- // an Amazon S3 bucket.
- RedirectAllRequestsTo *RedirectAllRequestsTo `type:"structure"`
- // Rules that define when a redirect is applied and the redirect behavior.
- RoutingRules []*RoutingRule `locationNameList:"RoutingRule" type:"list"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketWebsiteOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetBucketWebsiteOutput) GoString() string {
- return s.String()
- }
- // SetErrorDocument sets the ErrorDocument field's value.
- func (s *GetBucketWebsiteOutput) SetErrorDocument(v *ErrorDocument) *GetBucketWebsiteOutput {
- s.ErrorDocument = v
- return s
- }
- // SetIndexDocument sets the IndexDocument field's value.
- func (s *GetBucketWebsiteOutput) SetIndexDocument(v *IndexDocument) *GetBucketWebsiteOutput {
- s.IndexDocument = v
- return s
- }
- // SetRedirectAllRequestsTo sets the RedirectAllRequestsTo field's value.
- func (s *GetBucketWebsiteOutput) SetRedirectAllRequestsTo(v *RedirectAllRequestsTo) *GetBucketWebsiteOutput {
- s.RedirectAllRequestsTo = v
- return s
- }
- // SetRoutingRules sets the RoutingRules field's value.
- func (s *GetBucketWebsiteOutput) SetRoutingRules(v []*RoutingRule) *GetBucketWebsiteOutput {
- s.RoutingRules = v
- return s
- }
- type GetObjectAclInput struct {
- _ struct{} `locationName:"GetObjectAclRequest" type:"structure"`
- // The bucket name that contains the object for which to get the ACL information.
- //
- // When using this action with an access point, you must direct requests to
- // the access point hostname. The access point hostname takes the form AccessPointName-AccountId.s3-accesspoint.Region.amazonaws.com.
- // When using this action with an access point through the Amazon Web Services
- // SDKs, you provide the access point ARN in place of the bucket name. For more
- // information about access point ARNs, see Using access points (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html)
- // in the Amazon S3 User Guide.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // The key of the object for which to get the ACL information.
- //
- // Key is a required field
- Key *string `location:"uri" locationName:"Key" min:"1" type:"string" required:"true"`
- // Confirms that the requester knows that they will be charged for the request.
- // Bucket owners need not specify this parameter in their requests. For information
- // about downloading objects from Requester Pays buckets, see Downloading Objects
- // in Requester Pays Buckets (https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html)
- // in the Amazon S3 User Guide.
- RequestPayer *string `location:"header" locationName:"x-amz-request-payer" type:"string" enum:"RequestPayer"`
- // VersionId used to reference a specific version of the object.
- VersionId *string `location:"querystring" locationName:"versionId" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetObjectAclInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetObjectAclInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *GetObjectAclInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "GetObjectAclInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.Key == nil {
- invalidParams.Add(request.NewErrParamRequired("Key"))
- }
- if s.Key != nil && len(*s.Key) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Key", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *GetObjectAclInput) SetBucket(v string) *GetObjectAclInput {
- s.Bucket = &v
- return s
- }
- func (s *GetObjectAclInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *GetObjectAclInput) SetExpectedBucketOwner(v string) *GetObjectAclInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetKey sets the Key field's value.
- func (s *GetObjectAclInput) SetKey(v string) *GetObjectAclInput {
- s.Key = &v
- return s
- }
- // SetRequestPayer sets the RequestPayer field's value.
- func (s *GetObjectAclInput) SetRequestPayer(v string) *GetObjectAclInput {
- s.RequestPayer = &v
- return s
- }
- // SetVersionId sets the VersionId field's value.
- func (s *GetObjectAclInput) SetVersionId(v string) *GetObjectAclInput {
- s.VersionId = &v
- return s
- }
- func (s *GetObjectAclInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *GetObjectAclInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s GetObjectAclInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type GetObjectAclOutput struct {
- _ struct{} `type:"structure"`
- // A list of grants.
- Grants []*Grant `locationName:"AccessControlList" locationNameList:"Grant" type:"list"`
- // Container for the bucket owner's display name and ID.
- Owner *Owner `type:"structure"`
- // If present, indicates that the requester was successfully charged for the
- // request.
- RequestCharged *string `location:"header" locationName:"x-amz-request-charged" type:"string" enum:"RequestCharged"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetObjectAclOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetObjectAclOutput) GoString() string {
- return s.String()
- }
- // SetGrants sets the Grants field's value.
- func (s *GetObjectAclOutput) SetGrants(v []*Grant) *GetObjectAclOutput {
- s.Grants = v
- return s
- }
- // SetOwner sets the Owner field's value.
- func (s *GetObjectAclOutput) SetOwner(v *Owner) *GetObjectAclOutput {
- s.Owner = v
- return s
- }
- // SetRequestCharged sets the RequestCharged field's value.
- func (s *GetObjectAclOutput) SetRequestCharged(v string) *GetObjectAclOutput {
- s.RequestCharged = &v
- return s
- }
- type GetObjectAttributesInput struct {
- _ struct{} `locationName:"GetObjectAttributesRequest" type:"structure"`
- // The name of the bucket that contains the object.
- //
- // When using this action with an access point, you must direct requests to
- // the access point hostname. The access point hostname takes the form AccessPointName-AccountId.s3-accesspoint.Region.amazonaws.com.
- // When using this action with an access point through the Amazon Web Services
- // SDKs, you provide the access point ARN in place of the bucket name. For more
- // information about access point ARNs, see Using access points (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html)
- // in the Amazon S3 User Guide.
- //
- // When using this action with Amazon S3 on Outposts, you must direct requests
- // to the S3 on Outposts hostname. The S3 on Outposts hostname takes the form
- // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When
- // using this action with S3 on Outposts through the Amazon Web Services SDKs,
- // you provide the Outposts bucket ARN in place of the bucket name. For more
- // information about S3 on Outposts ARNs, see Using Amazon S3 on Outposts (https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html)
- // in the Amazon S3 User Guide.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // The object key.
- //
- // Key is a required field
- Key *string `location:"uri" locationName:"Key" min:"1" type:"string" required:"true"`
- // Sets the maximum number of parts to return.
- MaxParts *int64 `location:"header" locationName:"x-amz-max-parts" type:"integer"`
- // An XML header that specifies the fields at the root level that you want returned
- // in the response. Fields that you do not specify are not returned.
- //
- // ObjectAttributes is a required field
- ObjectAttributes []*string `location:"header" locationName:"x-amz-object-attributes" type:"list" required:"true" enum:"ObjectAttributes"`
- // Specifies the part after which listing should begin. Only parts with higher
- // part numbers will be listed.
- PartNumberMarker *int64 `location:"header" locationName:"x-amz-part-number-marker" type:"integer"`
- // Confirms that the requester knows that they will be charged for the request.
- // Bucket owners need not specify this parameter in their requests. For information
- // about downloading objects from Requester Pays buckets, see Downloading Objects
- // in Requester Pays Buckets (https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html)
- // in the Amazon S3 User Guide.
- RequestPayer *string `location:"header" locationName:"x-amz-request-payer" type:"string" enum:"RequestPayer"`
- // Specifies the algorithm to use when encrypting the object (for example, AES256).
- SSECustomerAlgorithm *string `location:"header" locationName:"x-amz-server-side-encryption-customer-algorithm" type:"string"`
- // Specifies the customer-provided encryption key for Amazon S3 to use in encrypting
- // data. This value is used to store the object and then it is discarded; Amazon
- // S3 does not store the encryption key. The key must be appropriate for use
- // with the algorithm specified in the x-amz-server-side-encryption-customer-algorithm
- // header.
- //
- // SSECustomerKey is a sensitive parameter and its value will be
- // replaced with "sensitive" in string returned by GetObjectAttributesInput's
- // String and GoString methods.
- SSECustomerKey *string `marshal-as:"blob" location:"header" locationName:"x-amz-server-side-encryption-customer-key" type:"string" sensitive:"true"`
- // Specifies the 128-bit MD5 digest of the encryption key according to RFC 1321.
- // Amazon S3 uses this header for a message integrity check to ensure that the
- // encryption key was transmitted without error.
- SSECustomerKeyMD5 *string `location:"header" locationName:"x-amz-server-side-encryption-customer-key-MD5" type:"string"`
- // The version ID used to reference a specific version of the object.
- VersionId *string `location:"querystring" locationName:"versionId" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetObjectAttributesInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetObjectAttributesInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *GetObjectAttributesInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "GetObjectAttributesInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.Key == nil {
- invalidParams.Add(request.NewErrParamRequired("Key"))
- }
- if s.Key != nil && len(*s.Key) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Key", 1))
- }
- if s.ObjectAttributes == nil {
- invalidParams.Add(request.NewErrParamRequired("ObjectAttributes"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *GetObjectAttributesInput) SetBucket(v string) *GetObjectAttributesInput {
- s.Bucket = &v
- return s
- }
- func (s *GetObjectAttributesInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *GetObjectAttributesInput) SetExpectedBucketOwner(v string) *GetObjectAttributesInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetKey sets the Key field's value.
- func (s *GetObjectAttributesInput) SetKey(v string) *GetObjectAttributesInput {
- s.Key = &v
- return s
- }
- // SetMaxParts sets the MaxParts field's value.
- func (s *GetObjectAttributesInput) SetMaxParts(v int64) *GetObjectAttributesInput {
- s.MaxParts = &v
- return s
- }
- // SetObjectAttributes sets the ObjectAttributes field's value.
- func (s *GetObjectAttributesInput) SetObjectAttributes(v []*string) *GetObjectAttributesInput {
- s.ObjectAttributes = v
- return s
- }
- // SetPartNumberMarker sets the PartNumberMarker field's value.
- func (s *GetObjectAttributesInput) SetPartNumberMarker(v int64) *GetObjectAttributesInput {
- s.PartNumberMarker = &v
- return s
- }
- // SetRequestPayer sets the RequestPayer field's value.
- func (s *GetObjectAttributesInput) SetRequestPayer(v string) *GetObjectAttributesInput {
- s.RequestPayer = &v
- return s
- }
- // SetSSECustomerAlgorithm sets the SSECustomerAlgorithm field's value.
- func (s *GetObjectAttributesInput) SetSSECustomerAlgorithm(v string) *GetObjectAttributesInput {
- s.SSECustomerAlgorithm = &v
- return s
- }
- // SetSSECustomerKey sets the SSECustomerKey field's value.
- func (s *GetObjectAttributesInput) SetSSECustomerKey(v string) *GetObjectAttributesInput {
- s.SSECustomerKey = &v
- return s
- }
- func (s *GetObjectAttributesInput) getSSECustomerKey() (v string) {
- if s.SSECustomerKey == nil {
- return v
- }
- return *s.SSECustomerKey
- }
- // SetSSECustomerKeyMD5 sets the SSECustomerKeyMD5 field's value.
- func (s *GetObjectAttributesInput) SetSSECustomerKeyMD5(v string) *GetObjectAttributesInput {
- s.SSECustomerKeyMD5 = &v
- return s
- }
- // SetVersionId sets the VersionId field's value.
- func (s *GetObjectAttributesInput) SetVersionId(v string) *GetObjectAttributesInput {
- s.VersionId = &v
- return s
- }
- func (s *GetObjectAttributesInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *GetObjectAttributesInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s GetObjectAttributesInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type GetObjectAttributesOutput struct {
- _ struct{} `type:"structure"`
- // The checksum or digest of the object.
- Checksum *Checksum `type:"structure"`
- // Specifies whether the object retrieved was (true) or was not (false) a delete
- // marker. If false, this response header does not appear in the response.
- DeleteMarker *bool `location:"header" locationName:"x-amz-delete-marker" type:"boolean"`
- // An ETag is an opaque identifier assigned by a web server to a specific version
- // of a resource found at a URL.
- ETag *string `type:"string"`
- // The creation date of the object.
- LastModified *time.Time `location:"header" locationName:"Last-Modified" type:"timestamp"`
- // A collection of parts associated with a multipart upload.
- ObjectParts *GetObjectAttributesParts `type:"structure"`
- // The size of the object in bytes.
- ObjectSize *int64 `type:"long"`
- // If present, indicates that the requester was successfully charged for the
- // request.
- RequestCharged *string `location:"header" locationName:"x-amz-request-charged" type:"string" enum:"RequestCharged"`
- // Provides the storage class information of the object. Amazon S3 returns this
- // header for all objects except for S3 Standard storage class objects.
- //
- // For more information, see Storage Classes (https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html).
- StorageClass *string `type:"string" enum:"StorageClass"`
- // The version ID of the object.
- VersionId *string `location:"header" locationName:"x-amz-version-id" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetObjectAttributesOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetObjectAttributesOutput) GoString() string {
- return s.String()
- }
- // SetChecksum sets the Checksum field's value.
- func (s *GetObjectAttributesOutput) SetChecksum(v *Checksum) *GetObjectAttributesOutput {
- s.Checksum = v
- return s
- }
- // SetDeleteMarker sets the DeleteMarker field's value.
- func (s *GetObjectAttributesOutput) SetDeleteMarker(v bool) *GetObjectAttributesOutput {
- s.DeleteMarker = &v
- return s
- }
- // SetETag sets the ETag field's value.
- func (s *GetObjectAttributesOutput) SetETag(v string) *GetObjectAttributesOutput {
- s.ETag = &v
- return s
- }
- // SetLastModified sets the LastModified field's value.
- func (s *GetObjectAttributesOutput) SetLastModified(v time.Time) *GetObjectAttributesOutput {
- s.LastModified = &v
- return s
- }
- // SetObjectParts sets the ObjectParts field's value.
- func (s *GetObjectAttributesOutput) SetObjectParts(v *GetObjectAttributesParts) *GetObjectAttributesOutput {
- s.ObjectParts = v
- return s
- }
- // SetObjectSize sets the ObjectSize field's value.
- func (s *GetObjectAttributesOutput) SetObjectSize(v int64) *GetObjectAttributesOutput {
- s.ObjectSize = &v
- return s
- }
- // SetRequestCharged sets the RequestCharged field's value.
- func (s *GetObjectAttributesOutput) SetRequestCharged(v string) *GetObjectAttributesOutput {
- s.RequestCharged = &v
- return s
- }
- // SetStorageClass sets the StorageClass field's value.
- func (s *GetObjectAttributesOutput) SetStorageClass(v string) *GetObjectAttributesOutput {
- s.StorageClass = &v
- return s
- }
- // SetVersionId sets the VersionId field's value.
- func (s *GetObjectAttributesOutput) SetVersionId(v string) *GetObjectAttributesOutput {
- s.VersionId = &v
- return s
- }
- // A collection of parts associated with a multipart upload.
- type GetObjectAttributesParts struct {
- _ struct{} `type:"structure"`
- // Indicates whether the returned list of parts is truncated. A value of true
- // indicates that the list was truncated. A list can be truncated if the number
- // of parts exceeds the limit returned in the MaxParts element.
- IsTruncated *bool `type:"boolean"`
- // The maximum number of parts allowed in the response.
- MaxParts *int64 `type:"integer"`
- // When a list is truncated, this element specifies the last part in the list,
- // as well as the value to use for the PartNumberMarker request parameter in
- // a subsequent request.
- NextPartNumberMarker *int64 `type:"integer"`
- // The marker for the current part.
- PartNumberMarker *int64 `type:"integer"`
- // A container for elements related to a particular part. A response can contain
- // zero or more Parts elements.
- Parts []*ObjectPart `locationName:"Part" type:"list" flattened:"true"`
- // The total number of parts.
- TotalPartsCount *int64 `locationName:"PartsCount" type:"integer"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetObjectAttributesParts) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetObjectAttributesParts) GoString() string {
- return s.String()
- }
- // SetIsTruncated sets the IsTruncated field's value.
- func (s *GetObjectAttributesParts) SetIsTruncated(v bool) *GetObjectAttributesParts {
- s.IsTruncated = &v
- return s
- }
- // SetMaxParts sets the MaxParts field's value.
- func (s *GetObjectAttributesParts) SetMaxParts(v int64) *GetObjectAttributesParts {
- s.MaxParts = &v
- return s
- }
- // SetNextPartNumberMarker sets the NextPartNumberMarker field's value.
- func (s *GetObjectAttributesParts) SetNextPartNumberMarker(v int64) *GetObjectAttributesParts {
- s.NextPartNumberMarker = &v
- return s
- }
- // SetPartNumberMarker sets the PartNumberMarker field's value.
- func (s *GetObjectAttributesParts) SetPartNumberMarker(v int64) *GetObjectAttributesParts {
- s.PartNumberMarker = &v
- return s
- }
- // SetParts sets the Parts field's value.
- func (s *GetObjectAttributesParts) SetParts(v []*ObjectPart) *GetObjectAttributesParts {
- s.Parts = v
- return s
- }
- // SetTotalPartsCount sets the TotalPartsCount field's value.
- func (s *GetObjectAttributesParts) SetTotalPartsCount(v int64) *GetObjectAttributesParts {
- s.TotalPartsCount = &v
- return s
- }
- type GetObjectInput struct {
- _ struct{} `locationName:"GetObjectRequest" type:"structure"`
- // The bucket name containing the object.
- //
- // When using this action with an access point, you must direct requests to
- // the access point hostname. The access point hostname takes the form AccessPointName-AccountId.s3-accesspoint.Region.amazonaws.com.
- // When using this action with an access point through the Amazon Web Services
- // SDKs, you provide the access point ARN in place of the bucket name. For more
- // information about access point ARNs, see Using access points (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html)
- // in the Amazon S3 User Guide.
- //
- // When using an Object Lambda access point the hostname takes the form AccessPointName-AccountId.s3-object-lambda.Region.amazonaws.com.
- //
- // When using this action with Amazon S3 on Outposts, you must direct requests
- // to the S3 on Outposts hostname. The S3 on Outposts hostname takes the form
- // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When
- // using this action with S3 on Outposts through the Amazon Web Services SDKs,
- // you provide the Outposts bucket ARN in place of the bucket name. For more
- // information about S3 on Outposts ARNs, see Using Amazon S3 on Outposts (https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html)
- // in the Amazon S3 User Guide.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // To retrieve the checksum, this mode must be enabled.
- //
- // The AWS SDK for Go v1 does not support automatic response payload checksum
- // validation. This feature is available in the AWS SDK for Go v2.
- ChecksumMode *string `location:"header" locationName:"x-amz-checksum-mode" type:"string" enum:"ChecksumMode"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // Return the object only if its entity tag (ETag) is the same as the one specified;
- // otherwise, return a 412 (precondition failed) error.
- IfMatch *string `location:"header" locationName:"If-Match" type:"string"`
- // Return the object only if it has been modified since the specified time;
- // otherwise, return a 304 (not modified) error.
- IfModifiedSince *time.Time `location:"header" locationName:"If-Modified-Since" type:"timestamp"`
- // Return the object only if its entity tag (ETag) is different from the one
- // specified; otherwise, return a 304 (not modified) error.
- IfNoneMatch *string `location:"header" locationName:"If-None-Match" type:"string"`
- // Return the object only if it has not been modified since the specified time;
- // otherwise, return a 412 (precondition failed) error.
- IfUnmodifiedSince *time.Time `location:"header" locationName:"If-Unmodified-Since" type:"timestamp"`
- // Key of the object to get.
- //
- // Key is a required field
- Key *string `location:"uri" locationName:"Key" min:"1" type:"string" required:"true"`
- // Part number of the object being read. This is a positive integer between
- // 1 and 10,000. Effectively performs a 'ranged' GET request for the part specified.
- // Useful for downloading just a part of an object.
- PartNumber *int64 `location:"querystring" locationName:"partNumber" type:"integer"`
- // Downloads the specified range bytes of an object. For more information about
- // the HTTP Range header, see https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35
- // (https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35).
- //
- // Amazon S3 doesn't support retrieving multiple ranges of data per GET request.
- Range *string `location:"header" locationName:"Range" type:"string"`
- // Confirms that the requester knows that they will be charged for the request.
- // Bucket owners need not specify this parameter in their requests. For information
- // about downloading objects from Requester Pays buckets, see Downloading Objects
- // in Requester Pays Buckets (https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html)
- // in the Amazon S3 User Guide.
- RequestPayer *string `location:"header" locationName:"x-amz-request-payer" type:"string" enum:"RequestPayer"`
- // Sets the Cache-Control header of the response.
- ResponseCacheControl *string `location:"querystring" locationName:"response-cache-control" type:"string"`
- // Sets the Content-Disposition header of the response
- ResponseContentDisposition *string `location:"querystring" locationName:"response-content-disposition" type:"string"`
- // Sets the Content-Encoding header of the response.
- ResponseContentEncoding *string `location:"querystring" locationName:"response-content-encoding" type:"string"`
- // Sets the Content-Language header of the response.
- ResponseContentLanguage *string `location:"querystring" locationName:"response-content-language" type:"string"`
- // Sets the Content-Type header of the response.
- ResponseContentType *string `location:"querystring" locationName:"response-content-type" type:"string"`
- // Sets the Expires header of the response.
- ResponseExpires *time.Time `location:"querystring" locationName:"response-expires" type:"timestamp" timestampFormat:"rfc822"`
- // Specifies the algorithm to use to when decrypting the object (for example,
- // AES256).
- SSECustomerAlgorithm *string `location:"header" locationName:"x-amz-server-side-encryption-customer-algorithm" type:"string"`
- // Specifies the customer-provided encryption key for Amazon S3 used to encrypt
- // the data. This value is used to decrypt the object when recovering it and
- // must match the one used when storing the data. The key must be appropriate
- // for use with the algorithm specified in the x-amz-server-side-encryption-customer-algorithm
- // header.
- //
- // SSECustomerKey is a sensitive parameter and its value will be
- // replaced with "sensitive" in string returned by GetObjectInput's
- // String and GoString methods.
- SSECustomerKey *string `marshal-as:"blob" location:"header" locationName:"x-amz-server-side-encryption-customer-key" type:"string" sensitive:"true"`
- // Specifies the 128-bit MD5 digest of the encryption key according to RFC 1321.
- // Amazon S3 uses this header for a message integrity check to ensure that the
- // encryption key was transmitted without error.
- SSECustomerKeyMD5 *string `location:"header" locationName:"x-amz-server-side-encryption-customer-key-MD5" type:"string"`
- // VersionId used to reference a specific version of the object.
- VersionId *string `location:"querystring" locationName:"versionId" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetObjectInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetObjectInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *GetObjectInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "GetObjectInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.Key == nil {
- invalidParams.Add(request.NewErrParamRequired("Key"))
- }
- if s.Key != nil && len(*s.Key) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Key", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *GetObjectInput) SetBucket(v string) *GetObjectInput {
- s.Bucket = &v
- return s
- }
- func (s *GetObjectInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetChecksumMode sets the ChecksumMode field's value.
- func (s *GetObjectInput) SetChecksumMode(v string) *GetObjectInput {
- s.ChecksumMode = &v
- return s
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *GetObjectInput) SetExpectedBucketOwner(v string) *GetObjectInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetIfMatch sets the IfMatch field's value.
- func (s *GetObjectInput) SetIfMatch(v string) *GetObjectInput {
- s.IfMatch = &v
- return s
- }
- // SetIfModifiedSince sets the IfModifiedSince field's value.
- func (s *GetObjectInput) SetIfModifiedSince(v time.Time) *GetObjectInput {
- s.IfModifiedSince = &v
- return s
- }
- // SetIfNoneMatch sets the IfNoneMatch field's value.
- func (s *GetObjectInput) SetIfNoneMatch(v string) *GetObjectInput {
- s.IfNoneMatch = &v
- return s
- }
- // SetIfUnmodifiedSince sets the IfUnmodifiedSince field's value.
- func (s *GetObjectInput) SetIfUnmodifiedSince(v time.Time) *GetObjectInput {
- s.IfUnmodifiedSince = &v
- return s
- }
- // SetKey sets the Key field's value.
- func (s *GetObjectInput) SetKey(v string) *GetObjectInput {
- s.Key = &v
- return s
- }
- // SetPartNumber sets the PartNumber field's value.
- func (s *GetObjectInput) SetPartNumber(v int64) *GetObjectInput {
- s.PartNumber = &v
- return s
- }
- // SetRange sets the Range field's value.
- func (s *GetObjectInput) SetRange(v string) *GetObjectInput {
- s.Range = &v
- return s
- }
- // SetRequestPayer sets the RequestPayer field's value.
- func (s *GetObjectInput) SetRequestPayer(v string) *GetObjectInput {
- s.RequestPayer = &v
- return s
- }
- // SetResponseCacheControl sets the ResponseCacheControl field's value.
- func (s *GetObjectInput) SetResponseCacheControl(v string) *GetObjectInput {
- s.ResponseCacheControl = &v
- return s
- }
- // SetResponseContentDisposition sets the ResponseContentDisposition field's value.
- func (s *GetObjectInput) SetResponseContentDisposition(v string) *GetObjectInput {
- s.ResponseContentDisposition = &v
- return s
- }
- // SetResponseContentEncoding sets the ResponseContentEncoding field's value.
- func (s *GetObjectInput) SetResponseContentEncoding(v string) *GetObjectInput {
- s.ResponseContentEncoding = &v
- return s
- }
- // SetResponseContentLanguage sets the ResponseContentLanguage field's value.
- func (s *GetObjectInput) SetResponseContentLanguage(v string) *GetObjectInput {
- s.ResponseContentLanguage = &v
- return s
- }
- // SetResponseContentType sets the ResponseContentType field's value.
- func (s *GetObjectInput) SetResponseContentType(v string) *GetObjectInput {
- s.ResponseContentType = &v
- return s
- }
- // SetResponseExpires sets the ResponseExpires field's value.
- func (s *GetObjectInput) SetResponseExpires(v time.Time) *GetObjectInput {
- s.ResponseExpires = &v
- return s
- }
- // SetSSECustomerAlgorithm sets the SSECustomerAlgorithm field's value.
- func (s *GetObjectInput) SetSSECustomerAlgorithm(v string) *GetObjectInput {
- s.SSECustomerAlgorithm = &v
- return s
- }
- // SetSSECustomerKey sets the SSECustomerKey field's value.
- func (s *GetObjectInput) SetSSECustomerKey(v string) *GetObjectInput {
- s.SSECustomerKey = &v
- return s
- }
- func (s *GetObjectInput) getSSECustomerKey() (v string) {
- if s.SSECustomerKey == nil {
- return v
- }
- return *s.SSECustomerKey
- }
- // SetSSECustomerKeyMD5 sets the SSECustomerKeyMD5 field's value.
- func (s *GetObjectInput) SetSSECustomerKeyMD5(v string) *GetObjectInput {
- s.SSECustomerKeyMD5 = &v
- return s
- }
- // SetVersionId sets the VersionId field's value.
- func (s *GetObjectInput) SetVersionId(v string) *GetObjectInput {
- s.VersionId = &v
- return s
- }
- func (s *GetObjectInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *GetObjectInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s GetObjectInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type GetObjectLegalHoldInput struct {
- _ struct{} `locationName:"GetObjectLegalHoldRequest" type:"structure"`
- // The bucket name containing the object whose legal hold status you want to
- // retrieve.
- //
- // When using this action with an access point, you must direct requests to
- // the access point hostname. The access point hostname takes the form AccessPointName-AccountId.s3-accesspoint.Region.amazonaws.com.
- // When using this action with an access point through the Amazon Web Services
- // SDKs, you provide the access point ARN in place of the bucket name. For more
- // information about access point ARNs, see Using access points (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html)
- // in the Amazon S3 User Guide.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // The key name for the object whose legal hold status you want to retrieve.
- //
- // Key is a required field
- Key *string `location:"uri" locationName:"Key" min:"1" type:"string" required:"true"`
- // Confirms that the requester knows that they will be charged for the request.
- // Bucket owners need not specify this parameter in their requests. For information
- // about downloading objects from Requester Pays buckets, see Downloading Objects
- // in Requester Pays Buckets (https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html)
- // in the Amazon S3 User Guide.
- RequestPayer *string `location:"header" locationName:"x-amz-request-payer" type:"string" enum:"RequestPayer"`
- // The version ID of the object whose legal hold status you want to retrieve.
- VersionId *string `location:"querystring" locationName:"versionId" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetObjectLegalHoldInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetObjectLegalHoldInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *GetObjectLegalHoldInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "GetObjectLegalHoldInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.Key == nil {
- invalidParams.Add(request.NewErrParamRequired("Key"))
- }
- if s.Key != nil && len(*s.Key) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Key", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *GetObjectLegalHoldInput) SetBucket(v string) *GetObjectLegalHoldInput {
- s.Bucket = &v
- return s
- }
- func (s *GetObjectLegalHoldInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *GetObjectLegalHoldInput) SetExpectedBucketOwner(v string) *GetObjectLegalHoldInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetKey sets the Key field's value.
- func (s *GetObjectLegalHoldInput) SetKey(v string) *GetObjectLegalHoldInput {
- s.Key = &v
- return s
- }
- // SetRequestPayer sets the RequestPayer field's value.
- func (s *GetObjectLegalHoldInput) SetRequestPayer(v string) *GetObjectLegalHoldInput {
- s.RequestPayer = &v
- return s
- }
- // SetVersionId sets the VersionId field's value.
- func (s *GetObjectLegalHoldInput) SetVersionId(v string) *GetObjectLegalHoldInput {
- s.VersionId = &v
- return s
- }
- func (s *GetObjectLegalHoldInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *GetObjectLegalHoldInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s GetObjectLegalHoldInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type GetObjectLegalHoldOutput struct {
- _ struct{} `type:"structure" payload:"LegalHold"`
- // The current legal hold status for the specified object.
- LegalHold *ObjectLockLegalHold `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetObjectLegalHoldOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetObjectLegalHoldOutput) GoString() string {
- return s.String()
- }
- // SetLegalHold sets the LegalHold field's value.
- func (s *GetObjectLegalHoldOutput) SetLegalHold(v *ObjectLockLegalHold) *GetObjectLegalHoldOutput {
- s.LegalHold = v
- return s
- }
- type GetObjectLockConfigurationInput struct {
- _ struct{} `locationName:"GetObjectLockConfigurationRequest" type:"structure"`
- // The bucket whose Object Lock configuration you want to retrieve.
- //
- // When using this action with an access point, you must direct requests to
- // the access point hostname. The access point hostname takes the form AccessPointName-AccountId.s3-accesspoint.Region.amazonaws.com.
- // When using this action with an access point through the Amazon Web Services
- // SDKs, you provide the access point ARN in place of the bucket name. For more
- // information about access point ARNs, see Using access points (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html)
- // in the Amazon S3 User Guide.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetObjectLockConfigurationInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetObjectLockConfigurationInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *GetObjectLockConfigurationInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "GetObjectLockConfigurationInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *GetObjectLockConfigurationInput) SetBucket(v string) *GetObjectLockConfigurationInput {
- s.Bucket = &v
- return s
- }
- func (s *GetObjectLockConfigurationInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *GetObjectLockConfigurationInput) SetExpectedBucketOwner(v string) *GetObjectLockConfigurationInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- func (s *GetObjectLockConfigurationInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *GetObjectLockConfigurationInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s GetObjectLockConfigurationInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type GetObjectLockConfigurationOutput struct {
- _ struct{} `type:"structure" payload:"ObjectLockConfiguration"`
- // The specified bucket's Object Lock configuration.
- ObjectLockConfiguration *ObjectLockConfiguration `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetObjectLockConfigurationOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetObjectLockConfigurationOutput) GoString() string {
- return s.String()
- }
- // SetObjectLockConfiguration sets the ObjectLockConfiguration field's value.
- func (s *GetObjectLockConfigurationOutput) SetObjectLockConfiguration(v *ObjectLockConfiguration) *GetObjectLockConfigurationOutput {
- s.ObjectLockConfiguration = v
- return s
- }
- type GetObjectOutput struct {
- _ struct{} `type:"structure" payload:"Body"`
- // Indicates that a range of bytes was specified.
- AcceptRanges *string `location:"header" locationName:"accept-ranges" type:"string"`
- // Object data.
- Body io.ReadCloser `type:"blob"`
- // Indicates whether the object uses an S3 Bucket Key for server-side encryption
- // with Amazon Web Services KMS (SSE-KMS).
- BucketKeyEnabled *bool `location:"header" locationName:"x-amz-server-side-encryption-bucket-key-enabled" type:"boolean"`
- // Specifies caching behavior along the request/reply chain.
- CacheControl *string `location:"header" locationName:"Cache-Control" type:"string"`
- // The base64-encoded, 32-bit CRC32 checksum of the object. This will only be
- // present if it was uploaded with the object. With multipart uploads, this
- // may not be a checksum value of the object. For more information about how
- // checksums are calculated with multipart uploads, see Checking object integrity
- // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
- // in the Amazon S3 User Guide.
- ChecksumCRC32 *string `location:"header" locationName:"x-amz-checksum-crc32" type:"string"`
- // The base64-encoded, 32-bit CRC32C checksum of the object. This will only
- // be present if it was uploaded with the object. With multipart uploads, this
- // may not be a checksum value of the object. For more information about how
- // checksums are calculated with multipart uploads, see Checking object integrity
- // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
- // in the Amazon S3 User Guide.
- ChecksumCRC32C *string `location:"header" locationName:"x-amz-checksum-crc32c" type:"string"`
- // The base64-encoded, 160-bit SHA-1 digest of the object. This will only be
- // present if it was uploaded with the object. With multipart uploads, this
- // may not be a checksum value of the object. For more information about how
- // checksums are calculated with multipart uploads, see Checking object integrity
- // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
- // in the Amazon S3 User Guide.
- ChecksumSHA1 *string `location:"header" locationName:"x-amz-checksum-sha1" type:"string"`
- // The base64-encoded, 256-bit SHA-256 digest of the object. This will only
- // be present if it was uploaded with the object. With multipart uploads, this
- // may not be a checksum value of the object. For more information about how
- // checksums are calculated with multipart uploads, see Checking object integrity
- // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
- // in the Amazon S3 User Guide.
- ChecksumSHA256 *string `location:"header" locationName:"x-amz-checksum-sha256" type:"string"`
- // Specifies presentational information for the object.
- ContentDisposition *string `location:"header" locationName:"Content-Disposition" type:"string"`
- // Specifies what content encodings have been applied to the object and thus
- // what decoding mechanisms must be applied to obtain the media-type referenced
- // by the Content-Type header field.
- ContentEncoding *string `location:"header" locationName:"Content-Encoding" type:"string"`
- // The language the content is in.
- ContentLanguage *string `location:"header" locationName:"Content-Language" type:"string"`
- // Size of the body in bytes.
- ContentLength *int64 `location:"header" locationName:"Content-Length" type:"long"`
- // The portion of the object returned in the response.
- ContentRange *string `location:"header" locationName:"Content-Range" type:"string"`
- // A standard MIME type describing the format of the object data.
- ContentType *string `location:"header" locationName:"Content-Type" type:"string"`
- // Specifies whether the object retrieved was (true) or was not (false) a Delete
- // Marker. If false, this response header does not appear in the response.
- DeleteMarker *bool `location:"header" locationName:"x-amz-delete-marker" type:"boolean"`
- // An entity tag (ETag) is an opaque identifier assigned by a web server to
- // a specific version of a resource found at a URL.
- ETag *string `location:"header" locationName:"ETag" type:"string"`
- // If the object expiration is configured (see PUT Bucket lifecycle), the response
- // includes this header. It includes the expiry-date and rule-id key-value pairs
- // providing object expiration information. The value of the rule-id is URL-encoded.
- Expiration *string `location:"header" locationName:"x-amz-expiration" type:"string"`
- // The date and time at which the object is no longer cacheable.
- Expires *string `location:"header" locationName:"Expires" type:"string"`
- // Creation date of the object.
- LastModified *time.Time `location:"header" locationName:"Last-Modified" type:"timestamp"`
- // A map of metadata to store with the object in S3.
- //
- // By default unmarshaled keys are written as a map keys in following canonicalized format:
- // the first letter and any letter following a hyphen will be capitalized, and the rest as lowercase.
- // Set `aws.Config.LowerCaseHeaderMaps` to `true` to write unmarshaled keys to the map as lowercase.
- Metadata map[string]*string `location:"headers" locationName:"x-amz-meta-" type:"map"`
- // This is set to the number of metadata entries not returned in x-amz-meta
- // headers. This can happen if you create metadata using an API like SOAP that
- // supports more flexible metadata than the REST API. For example, using SOAP,
- // you can create metadata whose values are not legal HTTP headers.
- MissingMeta *int64 `location:"header" locationName:"x-amz-missing-meta" type:"integer"`
- // Indicates whether this object has an active legal hold. This field is only
- // returned if you have permission to view an object's legal hold status.
- ObjectLockLegalHoldStatus *string `location:"header" locationName:"x-amz-object-lock-legal-hold" type:"string" enum:"ObjectLockLegalHoldStatus"`
- // The Object Lock mode currently in place for this object.
- ObjectLockMode *string `location:"header" locationName:"x-amz-object-lock-mode" type:"string" enum:"ObjectLockMode"`
- // The date and time when this object's Object Lock will expire.
- ObjectLockRetainUntilDate *time.Time `location:"header" locationName:"x-amz-object-lock-retain-until-date" type:"timestamp" timestampFormat:"iso8601"`
- // The count of parts this object has. This value is only returned if you specify
- // partNumber in your request and the object was uploaded as a multipart upload.
- PartsCount *int64 `location:"header" locationName:"x-amz-mp-parts-count" type:"integer"`
- // Amazon S3 can return this if your request involves a bucket that is either
- // a source or destination in a replication rule.
- ReplicationStatus *string `location:"header" locationName:"x-amz-replication-status" type:"string" enum:"ReplicationStatus"`
- // If present, indicates that the requester was successfully charged for the
- // request.
- RequestCharged *string `location:"header" locationName:"x-amz-request-charged" type:"string" enum:"RequestCharged"`
- // Provides information about object restoration action and expiration time
- // of the restored object copy.
- Restore *string `location:"header" locationName:"x-amz-restore" type:"string"`
- // If server-side encryption with a customer-provided encryption key was requested,
- // the response will include this header confirming the encryption algorithm
- // used.
- SSECustomerAlgorithm *string `location:"header" locationName:"x-amz-server-side-encryption-customer-algorithm" type:"string"`
- // If server-side encryption with a customer-provided encryption key was requested,
- // the response will include this header to provide round-trip message integrity
- // verification of the customer-provided encryption key.
- SSECustomerKeyMD5 *string `location:"header" locationName:"x-amz-server-side-encryption-customer-key-MD5" type:"string"`
- // If present, specifies the ID of the Amazon Web Services Key Management Service
- // (Amazon Web Services KMS) symmetric customer managed key that was used for
- // the object.
- //
- // SSEKMSKeyId is a sensitive parameter and its value will be
- // replaced with "sensitive" in string returned by GetObjectOutput's
- // String and GoString methods.
- SSEKMSKeyId *string `location:"header" locationName:"x-amz-server-side-encryption-aws-kms-key-id" type:"string" sensitive:"true"`
- // The server-side encryption algorithm used when storing this object in Amazon
- // S3 (for example, AES256, aws:kms).
- ServerSideEncryption *string `location:"header" locationName:"x-amz-server-side-encryption" type:"string" enum:"ServerSideEncryption"`
- // Provides storage class information of the object. Amazon S3 returns this
- // header for all objects except for S3 Standard storage class objects.
- StorageClass *string `location:"header" locationName:"x-amz-storage-class" type:"string" enum:"StorageClass"`
- // The number of tags, if any, on the object.
- TagCount *int64 `location:"header" locationName:"x-amz-tagging-count" type:"integer"`
- // Version of the object.
- VersionId *string `location:"header" locationName:"x-amz-version-id" type:"string"`
- // If the bucket is configured as a website, redirects requests for this object
- // to another object in the same bucket or to an external URL. Amazon S3 stores
- // the value of this header in the object metadata.
- WebsiteRedirectLocation *string `location:"header" locationName:"x-amz-website-redirect-location" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetObjectOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetObjectOutput) GoString() string {
- return s.String()
- }
- // SetAcceptRanges sets the AcceptRanges field's value.
- func (s *GetObjectOutput) SetAcceptRanges(v string) *GetObjectOutput {
- s.AcceptRanges = &v
- return s
- }
- // SetBody sets the Body field's value.
- func (s *GetObjectOutput) SetBody(v io.ReadCloser) *GetObjectOutput {
- s.Body = v
- return s
- }
- // SetBucketKeyEnabled sets the BucketKeyEnabled field's value.
- func (s *GetObjectOutput) SetBucketKeyEnabled(v bool) *GetObjectOutput {
- s.BucketKeyEnabled = &v
- return s
- }
- // SetCacheControl sets the CacheControl field's value.
- func (s *GetObjectOutput) SetCacheControl(v string) *GetObjectOutput {
- s.CacheControl = &v
- return s
- }
- // SetChecksumCRC32 sets the ChecksumCRC32 field's value.
- func (s *GetObjectOutput) SetChecksumCRC32(v string) *GetObjectOutput {
- s.ChecksumCRC32 = &v
- return s
- }
- // SetChecksumCRC32C sets the ChecksumCRC32C field's value.
- func (s *GetObjectOutput) SetChecksumCRC32C(v string) *GetObjectOutput {
- s.ChecksumCRC32C = &v
- return s
- }
- // SetChecksumSHA1 sets the ChecksumSHA1 field's value.
- func (s *GetObjectOutput) SetChecksumSHA1(v string) *GetObjectOutput {
- s.ChecksumSHA1 = &v
- return s
- }
- // SetChecksumSHA256 sets the ChecksumSHA256 field's value.
- func (s *GetObjectOutput) SetChecksumSHA256(v string) *GetObjectOutput {
- s.ChecksumSHA256 = &v
- return s
- }
- // SetContentDisposition sets the ContentDisposition field's value.
- func (s *GetObjectOutput) SetContentDisposition(v string) *GetObjectOutput {
- s.ContentDisposition = &v
- return s
- }
- // SetContentEncoding sets the ContentEncoding field's value.
- func (s *GetObjectOutput) SetContentEncoding(v string) *GetObjectOutput {
- s.ContentEncoding = &v
- return s
- }
- // SetContentLanguage sets the ContentLanguage field's value.
- func (s *GetObjectOutput) SetContentLanguage(v string) *GetObjectOutput {
- s.ContentLanguage = &v
- return s
- }
- // SetContentLength sets the ContentLength field's value.
- func (s *GetObjectOutput) SetContentLength(v int64) *GetObjectOutput {
- s.ContentLength = &v
- return s
- }
- // SetContentRange sets the ContentRange field's value.
- func (s *GetObjectOutput) SetContentRange(v string) *GetObjectOutput {
- s.ContentRange = &v
- return s
- }
- // SetContentType sets the ContentType field's value.
- func (s *GetObjectOutput) SetContentType(v string) *GetObjectOutput {
- s.ContentType = &v
- return s
- }
- // SetDeleteMarker sets the DeleteMarker field's value.
- func (s *GetObjectOutput) SetDeleteMarker(v bool) *GetObjectOutput {
- s.DeleteMarker = &v
- return s
- }
- // SetETag sets the ETag field's value.
- func (s *GetObjectOutput) SetETag(v string) *GetObjectOutput {
- s.ETag = &v
- return s
- }
- // SetExpiration sets the Expiration field's value.
- func (s *GetObjectOutput) SetExpiration(v string) *GetObjectOutput {
- s.Expiration = &v
- return s
- }
- // SetExpires sets the Expires field's value.
- func (s *GetObjectOutput) SetExpires(v string) *GetObjectOutput {
- s.Expires = &v
- return s
- }
- // SetLastModified sets the LastModified field's value.
- func (s *GetObjectOutput) SetLastModified(v time.Time) *GetObjectOutput {
- s.LastModified = &v
- return s
- }
- // SetMetadata sets the Metadata field's value.
- func (s *GetObjectOutput) SetMetadata(v map[string]*string) *GetObjectOutput {
- s.Metadata = v
- return s
- }
- // SetMissingMeta sets the MissingMeta field's value.
- func (s *GetObjectOutput) SetMissingMeta(v int64) *GetObjectOutput {
- s.MissingMeta = &v
- return s
- }
- // SetObjectLockLegalHoldStatus sets the ObjectLockLegalHoldStatus field's value.
- func (s *GetObjectOutput) SetObjectLockLegalHoldStatus(v string) *GetObjectOutput {
- s.ObjectLockLegalHoldStatus = &v
- return s
- }
- // SetObjectLockMode sets the ObjectLockMode field's value.
- func (s *GetObjectOutput) SetObjectLockMode(v string) *GetObjectOutput {
- s.ObjectLockMode = &v
- return s
- }
- // SetObjectLockRetainUntilDate sets the ObjectLockRetainUntilDate field's value.
- func (s *GetObjectOutput) SetObjectLockRetainUntilDate(v time.Time) *GetObjectOutput {
- s.ObjectLockRetainUntilDate = &v
- return s
- }
- // SetPartsCount sets the PartsCount field's value.
- func (s *GetObjectOutput) SetPartsCount(v int64) *GetObjectOutput {
- s.PartsCount = &v
- return s
- }
- // SetReplicationStatus sets the ReplicationStatus field's value.
- func (s *GetObjectOutput) SetReplicationStatus(v string) *GetObjectOutput {
- s.ReplicationStatus = &v
- return s
- }
- // SetRequestCharged sets the RequestCharged field's value.
- func (s *GetObjectOutput) SetRequestCharged(v string) *GetObjectOutput {
- s.RequestCharged = &v
- return s
- }
- // SetRestore sets the Restore field's value.
- func (s *GetObjectOutput) SetRestore(v string) *GetObjectOutput {
- s.Restore = &v
- return s
- }
- // SetSSECustomerAlgorithm sets the SSECustomerAlgorithm field's value.
- func (s *GetObjectOutput) SetSSECustomerAlgorithm(v string) *GetObjectOutput {
- s.SSECustomerAlgorithm = &v
- return s
- }
- // SetSSECustomerKeyMD5 sets the SSECustomerKeyMD5 field's value.
- func (s *GetObjectOutput) SetSSECustomerKeyMD5(v string) *GetObjectOutput {
- s.SSECustomerKeyMD5 = &v
- return s
- }
- // SetSSEKMSKeyId sets the SSEKMSKeyId field's value.
- func (s *GetObjectOutput) SetSSEKMSKeyId(v string) *GetObjectOutput {
- s.SSEKMSKeyId = &v
- return s
- }
- // SetServerSideEncryption sets the ServerSideEncryption field's value.
- func (s *GetObjectOutput) SetServerSideEncryption(v string) *GetObjectOutput {
- s.ServerSideEncryption = &v
- return s
- }
- // SetStorageClass sets the StorageClass field's value.
- func (s *GetObjectOutput) SetStorageClass(v string) *GetObjectOutput {
- s.StorageClass = &v
- return s
- }
- // SetTagCount sets the TagCount field's value.
- func (s *GetObjectOutput) SetTagCount(v int64) *GetObjectOutput {
- s.TagCount = &v
- return s
- }
- // SetVersionId sets the VersionId field's value.
- func (s *GetObjectOutput) SetVersionId(v string) *GetObjectOutput {
- s.VersionId = &v
- return s
- }
- // SetWebsiteRedirectLocation sets the WebsiteRedirectLocation field's value.
- func (s *GetObjectOutput) SetWebsiteRedirectLocation(v string) *GetObjectOutput {
- s.WebsiteRedirectLocation = &v
- return s
- }
- type GetObjectRetentionInput struct {
- _ struct{} `locationName:"GetObjectRetentionRequest" type:"structure"`
- // The bucket name containing the object whose retention settings you want to
- // retrieve.
- //
- // When using this action with an access point, you must direct requests to
- // the access point hostname. The access point hostname takes the form AccessPointName-AccountId.s3-accesspoint.Region.amazonaws.com.
- // When using this action with an access point through the Amazon Web Services
- // SDKs, you provide the access point ARN in place of the bucket name. For more
- // information about access point ARNs, see Using access points (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html)
- // in the Amazon S3 User Guide.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // The key name for the object whose retention settings you want to retrieve.
- //
- // Key is a required field
- Key *string `location:"uri" locationName:"Key" min:"1" type:"string" required:"true"`
- // Confirms that the requester knows that they will be charged for the request.
- // Bucket owners need not specify this parameter in their requests. For information
- // about downloading objects from Requester Pays buckets, see Downloading Objects
- // in Requester Pays Buckets (https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html)
- // in the Amazon S3 User Guide.
- RequestPayer *string `location:"header" locationName:"x-amz-request-payer" type:"string" enum:"RequestPayer"`
- // The version ID for the object whose retention settings you want to retrieve.
- VersionId *string `location:"querystring" locationName:"versionId" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetObjectRetentionInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetObjectRetentionInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *GetObjectRetentionInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "GetObjectRetentionInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.Key == nil {
- invalidParams.Add(request.NewErrParamRequired("Key"))
- }
- if s.Key != nil && len(*s.Key) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Key", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *GetObjectRetentionInput) SetBucket(v string) *GetObjectRetentionInput {
- s.Bucket = &v
- return s
- }
- func (s *GetObjectRetentionInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *GetObjectRetentionInput) SetExpectedBucketOwner(v string) *GetObjectRetentionInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetKey sets the Key field's value.
- func (s *GetObjectRetentionInput) SetKey(v string) *GetObjectRetentionInput {
- s.Key = &v
- return s
- }
- // SetRequestPayer sets the RequestPayer field's value.
- func (s *GetObjectRetentionInput) SetRequestPayer(v string) *GetObjectRetentionInput {
- s.RequestPayer = &v
- return s
- }
- // SetVersionId sets the VersionId field's value.
- func (s *GetObjectRetentionInput) SetVersionId(v string) *GetObjectRetentionInput {
- s.VersionId = &v
- return s
- }
- func (s *GetObjectRetentionInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *GetObjectRetentionInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s GetObjectRetentionInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type GetObjectRetentionOutput struct {
- _ struct{} `type:"structure" payload:"Retention"`
- // The container element for an object's retention settings.
- Retention *ObjectLockRetention `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetObjectRetentionOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetObjectRetentionOutput) GoString() string {
- return s.String()
- }
- // SetRetention sets the Retention field's value.
- func (s *GetObjectRetentionOutput) SetRetention(v *ObjectLockRetention) *GetObjectRetentionOutput {
- s.Retention = v
- return s
- }
- type GetObjectTaggingInput struct {
- _ struct{} `locationName:"GetObjectTaggingRequest" type:"structure"`
- // The bucket name containing the object for which to get the tagging information.
- //
- // When using this action with an access point, you must direct requests to
- // the access point hostname. The access point hostname takes the form AccessPointName-AccountId.s3-accesspoint.Region.amazonaws.com.
- // When using this action with an access point through the Amazon Web Services
- // SDKs, you provide the access point ARN in place of the bucket name. For more
- // information about access point ARNs, see Using access points (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html)
- // in the Amazon S3 User Guide.
- //
- // When using this action with Amazon S3 on Outposts, you must direct requests
- // to the S3 on Outposts hostname. The S3 on Outposts hostname takes the form
- // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When
- // using this action with S3 on Outposts through the Amazon Web Services SDKs,
- // you provide the Outposts bucket ARN in place of the bucket name. For more
- // information about S3 on Outposts ARNs, see Using Amazon S3 on Outposts (https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html)
- // in the Amazon S3 User Guide.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // Object key for which to get the tagging information.
- //
- // Key is a required field
- Key *string `location:"uri" locationName:"Key" min:"1" type:"string" required:"true"`
- // Confirms that the requester knows that they will be charged for the request.
- // Bucket owners need not specify this parameter in their requests. For information
- // about downloading objects from Requester Pays buckets, see Downloading Objects
- // in Requester Pays Buckets (https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html)
- // in the Amazon S3 User Guide.
- RequestPayer *string `location:"header" locationName:"x-amz-request-payer" type:"string" enum:"RequestPayer"`
- // The versionId of the object for which to get the tagging information.
- VersionId *string `location:"querystring" locationName:"versionId" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetObjectTaggingInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetObjectTaggingInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *GetObjectTaggingInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "GetObjectTaggingInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.Key == nil {
- invalidParams.Add(request.NewErrParamRequired("Key"))
- }
- if s.Key != nil && len(*s.Key) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Key", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *GetObjectTaggingInput) SetBucket(v string) *GetObjectTaggingInput {
- s.Bucket = &v
- return s
- }
- func (s *GetObjectTaggingInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *GetObjectTaggingInput) SetExpectedBucketOwner(v string) *GetObjectTaggingInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetKey sets the Key field's value.
- func (s *GetObjectTaggingInput) SetKey(v string) *GetObjectTaggingInput {
- s.Key = &v
- return s
- }
- // SetRequestPayer sets the RequestPayer field's value.
- func (s *GetObjectTaggingInput) SetRequestPayer(v string) *GetObjectTaggingInput {
- s.RequestPayer = &v
- return s
- }
- // SetVersionId sets the VersionId field's value.
- func (s *GetObjectTaggingInput) SetVersionId(v string) *GetObjectTaggingInput {
- s.VersionId = &v
- return s
- }
- func (s *GetObjectTaggingInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *GetObjectTaggingInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s GetObjectTaggingInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type GetObjectTaggingOutput struct {
- _ struct{} `type:"structure"`
- // Contains the tag set.
- //
- // TagSet is a required field
- TagSet []*Tag `locationNameList:"Tag" type:"list" required:"true"`
- // The versionId of the object for which you got the tagging information.
- VersionId *string `location:"header" locationName:"x-amz-version-id" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetObjectTaggingOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetObjectTaggingOutput) GoString() string {
- return s.String()
- }
- // SetTagSet sets the TagSet field's value.
- func (s *GetObjectTaggingOutput) SetTagSet(v []*Tag) *GetObjectTaggingOutput {
- s.TagSet = v
- return s
- }
- // SetVersionId sets the VersionId field's value.
- func (s *GetObjectTaggingOutput) SetVersionId(v string) *GetObjectTaggingOutput {
- s.VersionId = &v
- return s
- }
- type GetObjectTorrentInput struct {
- _ struct{} `locationName:"GetObjectTorrentRequest" type:"structure"`
- // The name of the bucket containing the object for which to get the torrent
- // files.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // The object key for which to get the information.
- //
- // Key is a required field
- Key *string `location:"uri" locationName:"Key" min:"1" type:"string" required:"true"`
- // Confirms that the requester knows that they will be charged for the request.
- // Bucket owners need not specify this parameter in their requests. For information
- // about downloading objects from Requester Pays buckets, see Downloading Objects
- // in Requester Pays Buckets (https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html)
- // in the Amazon S3 User Guide.
- RequestPayer *string `location:"header" locationName:"x-amz-request-payer" type:"string" enum:"RequestPayer"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetObjectTorrentInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetObjectTorrentInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *GetObjectTorrentInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "GetObjectTorrentInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.Key == nil {
- invalidParams.Add(request.NewErrParamRequired("Key"))
- }
- if s.Key != nil && len(*s.Key) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Key", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *GetObjectTorrentInput) SetBucket(v string) *GetObjectTorrentInput {
- s.Bucket = &v
- return s
- }
- func (s *GetObjectTorrentInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *GetObjectTorrentInput) SetExpectedBucketOwner(v string) *GetObjectTorrentInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetKey sets the Key field's value.
- func (s *GetObjectTorrentInput) SetKey(v string) *GetObjectTorrentInput {
- s.Key = &v
- return s
- }
- // SetRequestPayer sets the RequestPayer field's value.
- func (s *GetObjectTorrentInput) SetRequestPayer(v string) *GetObjectTorrentInput {
- s.RequestPayer = &v
- return s
- }
- func (s *GetObjectTorrentInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *GetObjectTorrentInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s GetObjectTorrentInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type GetObjectTorrentOutput struct {
- _ struct{} `type:"structure" payload:"Body"`
- // A Bencoded dictionary as defined by the BitTorrent specification
- Body io.ReadCloser `type:"blob"`
- // If present, indicates that the requester was successfully charged for the
- // request.
- RequestCharged *string `location:"header" locationName:"x-amz-request-charged" type:"string" enum:"RequestCharged"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetObjectTorrentOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetObjectTorrentOutput) GoString() string {
- return s.String()
- }
- // SetBody sets the Body field's value.
- func (s *GetObjectTorrentOutput) SetBody(v io.ReadCloser) *GetObjectTorrentOutput {
- s.Body = v
- return s
- }
- // SetRequestCharged sets the RequestCharged field's value.
- func (s *GetObjectTorrentOutput) SetRequestCharged(v string) *GetObjectTorrentOutput {
- s.RequestCharged = &v
- return s
- }
- type GetPublicAccessBlockInput struct {
- _ struct{} `locationName:"GetPublicAccessBlockRequest" type:"structure"`
- // The name of the Amazon S3 bucket whose PublicAccessBlock configuration you
- // want to retrieve.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetPublicAccessBlockInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetPublicAccessBlockInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *GetPublicAccessBlockInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "GetPublicAccessBlockInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *GetPublicAccessBlockInput) SetBucket(v string) *GetPublicAccessBlockInput {
- s.Bucket = &v
- return s
- }
- func (s *GetPublicAccessBlockInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *GetPublicAccessBlockInput) SetExpectedBucketOwner(v string) *GetPublicAccessBlockInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- func (s *GetPublicAccessBlockInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *GetPublicAccessBlockInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s GetPublicAccessBlockInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type GetPublicAccessBlockOutput struct {
- _ struct{} `type:"structure" payload:"PublicAccessBlockConfiguration"`
- // The PublicAccessBlock configuration currently in effect for this Amazon S3
- // bucket.
- PublicAccessBlockConfiguration *PublicAccessBlockConfiguration `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetPublicAccessBlockOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GetPublicAccessBlockOutput) GoString() string {
- return s.String()
- }
- // SetPublicAccessBlockConfiguration sets the PublicAccessBlockConfiguration field's value.
- func (s *GetPublicAccessBlockOutput) SetPublicAccessBlockConfiguration(v *PublicAccessBlockConfiguration) *GetPublicAccessBlockOutput {
- s.PublicAccessBlockConfiguration = v
- return s
- }
- // Container for S3 Glacier job parameters.
- type GlacierJobParameters struct {
- _ struct{} `type:"structure"`
- // Retrieval tier at which the restore will be processed.
- //
- // Tier is a required field
- Tier *string `type:"string" required:"true" enum:"Tier"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GlacierJobParameters) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s GlacierJobParameters) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *GlacierJobParameters) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "GlacierJobParameters"}
- if s.Tier == nil {
- invalidParams.Add(request.NewErrParamRequired("Tier"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetTier sets the Tier field's value.
- func (s *GlacierJobParameters) SetTier(v string) *GlacierJobParameters {
- s.Tier = &v
- return s
- }
- // Container for grant information.
- type Grant struct {
- _ struct{} `type:"structure"`
- // The person being granted permissions.
- Grantee *Grantee `type:"structure" xmlPrefix:"xsi" xmlURI:"http://www.w3.org/2001/XMLSchema-instance"`
- // Specifies the permission given to the grantee.
- Permission *string `type:"string" enum:"Permission"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s Grant) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s Grant) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *Grant) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "Grant"}
- if s.Grantee != nil {
- if err := s.Grantee.Validate(); err != nil {
- invalidParams.AddNested("Grantee", err.(request.ErrInvalidParams))
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetGrantee sets the Grantee field's value.
- func (s *Grant) SetGrantee(v *Grantee) *Grant {
- s.Grantee = v
- return s
- }
- // SetPermission sets the Permission field's value.
- func (s *Grant) SetPermission(v string) *Grant {
- s.Permission = &v
- return s
- }
- // Container for the person being granted permissions.
- type Grantee struct {
- _ struct{} `type:"structure" xmlPrefix:"xsi" xmlURI:"http://www.w3.org/2001/XMLSchema-instance"`
- // Screen name of the grantee.
- DisplayName *string `type:"string"`
- // Email address of the grantee.
- //
- // Using email addresses to specify a grantee is only supported in the following
- // Amazon Web Services Regions:
- //
- // * US East (N. Virginia)
- //
- // * US West (N. California)
- //
- // * US West (Oregon)
- //
- // * Asia Pacific (Singapore)
- //
- // * Asia Pacific (Sydney)
- //
- // * Asia Pacific (Tokyo)
- //
- // * Europe (Ireland)
- //
- // * South America (São Paulo)
- //
- // For a list of all the Amazon S3 supported Regions and endpoints, see Regions
- // and Endpoints (https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region)
- // in the Amazon Web Services General Reference.
- EmailAddress *string `type:"string"`
- // The canonical user ID of the grantee.
- ID *string `type:"string"`
- // Type of grantee
- //
- // Type is a required field
- Type *string `locationName:"xsi:type" type:"string" xmlAttribute:"true" required:"true" enum:"Type"`
- // URI of the grantee group.
- URI *string `type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s Grantee) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s Grantee) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *Grantee) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "Grantee"}
- if s.Type == nil {
- invalidParams.Add(request.NewErrParamRequired("Type"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetDisplayName sets the DisplayName field's value.
- func (s *Grantee) SetDisplayName(v string) *Grantee {
- s.DisplayName = &v
- return s
- }
- // SetEmailAddress sets the EmailAddress field's value.
- func (s *Grantee) SetEmailAddress(v string) *Grantee {
- s.EmailAddress = &v
- return s
- }
- // SetID sets the ID field's value.
- func (s *Grantee) SetID(v string) *Grantee {
- s.ID = &v
- return s
- }
- // SetType sets the Type field's value.
- func (s *Grantee) SetType(v string) *Grantee {
- s.Type = &v
- return s
- }
- // SetURI sets the URI field's value.
- func (s *Grantee) SetURI(v string) *Grantee {
- s.URI = &v
- return s
- }
- type HeadBucketInput struct {
- _ struct{} `locationName:"HeadBucketRequest" type:"structure"`
- // The bucket name.
- //
- // When using this action with an access point, you must direct requests to
- // the access point hostname. The access point hostname takes the form AccessPointName-AccountId.s3-accesspoint.Region.amazonaws.com.
- // When using this action with an access point through the Amazon Web Services
- // SDKs, you provide the access point ARN in place of the bucket name. For more
- // information about access point ARNs, see Using access points (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html)
- // in the Amazon S3 User Guide.
- //
- // When using this action with Amazon S3 on Outposts, you must direct requests
- // to the S3 on Outposts hostname. The S3 on Outposts hostname takes the form
- // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When
- // using this action with S3 on Outposts through the Amazon Web Services SDKs,
- // you provide the Outposts bucket ARN in place of the bucket name. For more
- // information about S3 on Outposts ARNs, see Using Amazon S3 on Outposts (https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html)
- // in the Amazon S3 User Guide.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s HeadBucketInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s HeadBucketInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *HeadBucketInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "HeadBucketInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *HeadBucketInput) SetBucket(v string) *HeadBucketInput {
- s.Bucket = &v
- return s
- }
- func (s *HeadBucketInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *HeadBucketInput) SetExpectedBucketOwner(v string) *HeadBucketInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- func (s *HeadBucketInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *HeadBucketInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s HeadBucketInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type HeadBucketOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s HeadBucketOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s HeadBucketOutput) GoString() string {
- return s.String()
- }
- type HeadObjectInput struct {
- _ struct{} `locationName:"HeadObjectRequest" type:"structure"`
- // The name of the bucket containing the object.
- //
- // When using this action with an access point, you must direct requests to
- // the access point hostname. The access point hostname takes the form AccessPointName-AccountId.s3-accesspoint.Region.amazonaws.com.
- // When using this action with an access point through the Amazon Web Services
- // SDKs, you provide the access point ARN in place of the bucket name. For more
- // information about access point ARNs, see Using access points (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html)
- // in the Amazon S3 User Guide.
- //
- // When using this action with Amazon S3 on Outposts, you must direct requests
- // to the S3 on Outposts hostname. The S3 on Outposts hostname takes the form
- // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When
- // using this action with S3 on Outposts through the Amazon Web Services SDKs,
- // you provide the Outposts bucket ARN in place of the bucket name. For more
- // information about S3 on Outposts ARNs, see Using Amazon S3 on Outposts (https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html)
- // in the Amazon S3 User Guide.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // To retrieve the checksum, this parameter must be enabled.
- //
- // In addition, if you enable ChecksumMode and the object is encrypted with
- // Amazon Web Services Key Management Service (Amazon Web Services KMS), you
- // must have permission to use the kms:Decrypt action for the request to succeed.
- ChecksumMode *string `location:"header" locationName:"x-amz-checksum-mode" type:"string" enum:"ChecksumMode"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // Return the object only if its entity tag (ETag) is the same as the one specified;
- // otherwise, return a 412 (precondition failed) error.
- IfMatch *string `location:"header" locationName:"If-Match" type:"string"`
- // Return the object only if it has been modified since the specified time;
- // otherwise, return a 304 (not modified) error.
- IfModifiedSince *time.Time `location:"header" locationName:"If-Modified-Since" type:"timestamp"`
- // Return the object only if its entity tag (ETag) is different from the one
- // specified; otherwise, return a 304 (not modified) error.
- IfNoneMatch *string `location:"header" locationName:"If-None-Match" type:"string"`
- // Return the object only if it has not been modified since the specified time;
- // otherwise, return a 412 (precondition failed) error.
- IfUnmodifiedSince *time.Time `location:"header" locationName:"If-Unmodified-Since" type:"timestamp"`
- // The object key.
- //
- // Key is a required field
- Key *string `location:"uri" locationName:"Key" min:"1" type:"string" required:"true"`
- // Part number of the object being read. This is a positive integer between
- // 1 and 10,000. Effectively performs a 'ranged' HEAD request for the part specified.
- // Useful querying about the size of the part and the number of parts in this
- // object.
- PartNumber *int64 `location:"querystring" locationName:"partNumber" type:"integer"`
- // Because HeadObject returns only the metadata for an object, this parameter
- // has no effect.
- Range *string `location:"header" locationName:"Range" type:"string"`
- // Confirms that the requester knows that they will be charged for the request.
- // Bucket owners need not specify this parameter in their requests. For information
- // about downloading objects from Requester Pays buckets, see Downloading Objects
- // in Requester Pays Buckets (https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html)
- // in the Amazon S3 User Guide.
- RequestPayer *string `location:"header" locationName:"x-amz-request-payer" type:"string" enum:"RequestPayer"`
- // Specifies the algorithm to use to when encrypting the object (for example,
- // AES256).
- SSECustomerAlgorithm *string `location:"header" locationName:"x-amz-server-side-encryption-customer-algorithm" type:"string"`
- // Specifies the customer-provided encryption key for Amazon S3 to use in encrypting
- // data. This value is used to store the object and then it is discarded; Amazon
- // S3 does not store the encryption key. The key must be appropriate for use
- // with the algorithm specified in the x-amz-server-side-encryption-customer-algorithm
- // header.
- //
- // SSECustomerKey is a sensitive parameter and its value will be
- // replaced with "sensitive" in string returned by HeadObjectInput's
- // String and GoString methods.
- SSECustomerKey *string `marshal-as:"blob" location:"header" locationName:"x-amz-server-side-encryption-customer-key" type:"string" sensitive:"true"`
- // Specifies the 128-bit MD5 digest of the encryption key according to RFC 1321.
- // Amazon S3 uses this header for a message integrity check to ensure that the
- // encryption key was transmitted without error.
- SSECustomerKeyMD5 *string `location:"header" locationName:"x-amz-server-side-encryption-customer-key-MD5" type:"string"`
- // VersionId used to reference a specific version of the object.
- VersionId *string `location:"querystring" locationName:"versionId" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s HeadObjectInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s HeadObjectInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *HeadObjectInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "HeadObjectInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.Key == nil {
- invalidParams.Add(request.NewErrParamRequired("Key"))
- }
- if s.Key != nil && len(*s.Key) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Key", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *HeadObjectInput) SetBucket(v string) *HeadObjectInput {
- s.Bucket = &v
- return s
- }
- func (s *HeadObjectInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetChecksumMode sets the ChecksumMode field's value.
- func (s *HeadObjectInput) SetChecksumMode(v string) *HeadObjectInput {
- s.ChecksumMode = &v
- return s
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *HeadObjectInput) SetExpectedBucketOwner(v string) *HeadObjectInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetIfMatch sets the IfMatch field's value.
- func (s *HeadObjectInput) SetIfMatch(v string) *HeadObjectInput {
- s.IfMatch = &v
- return s
- }
- // SetIfModifiedSince sets the IfModifiedSince field's value.
- func (s *HeadObjectInput) SetIfModifiedSince(v time.Time) *HeadObjectInput {
- s.IfModifiedSince = &v
- return s
- }
- // SetIfNoneMatch sets the IfNoneMatch field's value.
- func (s *HeadObjectInput) SetIfNoneMatch(v string) *HeadObjectInput {
- s.IfNoneMatch = &v
- return s
- }
- // SetIfUnmodifiedSince sets the IfUnmodifiedSince field's value.
- func (s *HeadObjectInput) SetIfUnmodifiedSince(v time.Time) *HeadObjectInput {
- s.IfUnmodifiedSince = &v
- return s
- }
- // SetKey sets the Key field's value.
- func (s *HeadObjectInput) SetKey(v string) *HeadObjectInput {
- s.Key = &v
- return s
- }
- // SetPartNumber sets the PartNumber field's value.
- func (s *HeadObjectInput) SetPartNumber(v int64) *HeadObjectInput {
- s.PartNumber = &v
- return s
- }
- // SetRange sets the Range field's value.
- func (s *HeadObjectInput) SetRange(v string) *HeadObjectInput {
- s.Range = &v
- return s
- }
- // SetRequestPayer sets the RequestPayer field's value.
- func (s *HeadObjectInput) SetRequestPayer(v string) *HeadObjectInput {
- s.RequestPayer = &v
- return s
- }
- // SetSSECustomerAlgorithm sets the SSECustomerAlgorithm field's value.
- func (s *HeadObjectInput) SetSSECustomerAlgorithm(v string) *HeadObjectInput {
- s.SSECustomerAlgorithm = &v
- return s
- }
- // SetSSECustomerKey sets the SSECustomerKey field's value.
- func (s *HeadObjectInput) SetSSECustomerKey(v string) *HeadObjectInput {
- s.SSECustomerKey = &v
- return s
- }
- func (s *HeadObjectInput) getSSECustomerKey() (v string) {
- if s.SSECustomerKey == nil {
- return v
- }
- return *s.SSECustomerKey
- }
- // SetSSECustomerKeyMD5 sets the SSECustomerKeyMD5 field's value.
- func (s *HeadObjectInput) SetSSECustomerKeyMD5(v string) *HeadObjectInput {
- s.SSECustomerKeyMD5 = &v
- return s
- }
- // SetVersionId sets the VersionId field's value.
- func (s *HeadObjectInput) SetVersionId(v string) *HeadObjectInput {
- s.VersionId = &v
- return s
- }
- func (s *HeadObjectInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *HeadObjectInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s HeadObjectInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type HeadObjectOutput struct {
- _ struct{} `type:"structure"`
- // Indicates that a range of bytes was specified.
- AcceptRanges *string `location:"header" locationName:"accept-ranges" type:"string"`
- // The archive state of the head object.
- ArchiveStatus *string `location:"header" locationName:"x-amz-archive-status" type:"string" enum:"ArchiveStatus"`
- // Indicates whether the object uses an S3 Bucket Key for server-side encryption
- // with Amazon Web Services KMS (SSE-KMS).
- BucketKeyEnabled *bool `location:"header" locationName:"x-amz-server-side-encryption-bucket-key-enabled" type:"boolean"`
- // Specifies caching behavior along the request/reply chain.
- CacheControl *string `location:"header" locationName:"Cache-Control" type:"string"`
- // The base64-encoded, 32-bit CRC32 checksum of the object. This will only be
- // present if it was uploaded with the object. With multipart uploads, this
- // may not be a checksum value of the object. For more information about how
- // checksums are calculated with multipart uploads, see Checking object integrity
- // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
- // in the Amazon S3 User Guide.
- ChecksumCRC32 *string `location:"header" locationName:"x-amz-checksum-crc32" type:"string"`
- // The base64-encoded, 32-bit CRC32C checksum of the object. This will only
- // be present if it was uploaded with the object. With multipart uploads, this
- // may not be a checksum value of the object. For more information about how
- // checksums are calculated with multipart uploads, see Checking object integrity
- // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
- // in the Amazon S3 User Guide.
- ChecksumCRC32C *string `location:"header" locationName:"x-amz-checksum-crc32c" type:"string"`
- // The base64-encoded, 160-bit SHA-1 digest of the object. This will only be
- // present if it was uploaded with the object. With multipart uploads, this
- // may not be a checksum value of the object. For more information about how
- // checksums are calculated with multipart uploads, see Checking object integrity
- // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
- // in the Amazon S3 User Guide.
- ChecksumSHA1 *string `location:"header" locationName:"x-amz-checksum-sha1" type:"string"`
- // The base64-encoded, 256-bit SHA-256 digest of the object. This will only
- // be present if it was uploaded with the object. With multipart uploads, this
- // may not be a checksum value of the object. For more information about how
- // checksums are calculated with multipart uploads, see Checking object integrity
- // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
- // in the Amazon S3 User Guide.
- ChecksumSHA256 *string `location:"header" locationName:"x-amz-checksum-sha256" type:"string"`
- // Specifies presentational information for the object.
- ContentDisposition *string `location:"header" locationName:"Content-Disposition" type:"string"`
- // Specifies what content encodings have been applied to the object and thus
- // what decoding mechanisms must be applied to obtain the media-type referenced
- // by the Content-Type header field.
- ContentEncoding *string `location:"header" locationName:"Content-Encoding" type:"string"`
- // The language the content is in.
- ContentLanguage *string `location:"header" locationName:"Content-Language" type:"string"`
- // Size of the body in bytes.
- ContentLength *int64 `location:"header" locationName:"Content-Length" type:"long"`
- // A standard MIME type describing the format of the object data.
- ContentType *string `location:"header" locationName:"Content-Type" type:"string"`
- // Specifies whether the object retrieved was (true) or was not (false) a Delete
- // Marker. If false, this response header does not appear in the response.
- DeleteMarker *bool `location:"header" locationName:"x-amz-delete-marker" type:"boolean"`
- // An entity tag (ETag) is an opaque identifier assigned by a web server to
- // a specific version of a resource found at a URL.
- ETag *string `location:"header" locationName:"ETag" type:"string"`
- // If the object expiration is configured (see PUT Bucket lifecycle), the response
- // includes this header. It includes the expiry-date and rule-id key-value pairs
- // providing object expiration information. The value of the rule-id is URL-encoded.
- Expiration *string `location:"header" locationName:"x-amz-expiration" type:"string"`
- // The date and time at which the object is no longer cacheable.
- Expires *string `location:"header" locationName:"Expires" type:"string"`
- // Creation date of the object.
- LastModified *time.Time `location:"header" locationName:"Last-Modified" type:"timestamp"`
- // A map of metadata to store with the object in S3.
- //
- // By default unmarshaled keys are written as a map keys in following canonicalized format:
- // the first letter and any letter following a hyphen will be capitalized, and the rest as lowercase.
- // Set `aws.Config.LowerCaseHeaderMaps` to `true` to write unmarshaled keys to the map as lowercase.
- Metadata map[string]*string `location:"headers" locationName:"x-amz-meta-" type:"map"`
- // This is set to the number of metadata entries not returned in x-amz-meta
- // headers. This can happen if you create metadata using an API like SOAP that
- // supports more flexible metadata than the REST API. For example, using SOAP,
- // you can create metadata whose values are not legal HTTP headers.
- MissingMeta *int64 `location:"header" locationName:"x-amz-missing-meta" type:"integer"`
- // Specifies whether a legal hold is in effect for this object. This header
- // is only returned if the requester has the s3:GetObjectLegalHold permission.
- // This header is not returned if the specified version of this object has never
- // had a legal hold applied. For more information about S3 Object Lock, see
- // Object Lock (https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html).
- ObjectLockLegalHoldStatus *string `location:"header" locationName:"x-amz-object-lock-legal-hold" type:"string" enum:"ObjectLockLegalHoldStatus"`
- // The Object Lock mode, if any, that's in effect for this object. This header
- // is only returned if the requester has the s3:GetObjectRetention permission.
- // For more information about S3 Object Lock, see Object Lock (https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html).
- ObjectLockMode *string `location:"header" locationName:"x-amz-object-lock-mode" type:"string" enum:"ObjectLockMode"`
- // The date and time when the Object Lock retention period expires. This header
- // is only returned if the requester has the s3:GetObjectRetention permission.
- ObjectLockRetainUntilDate *time.Time `location:"header" locationName:"x-amz-object-lock-retain-until-date" type:"timestamp" timestampFormat:"iso8601"`
- // The count of parts this object has. This value is only returned if you specify
- // partNumber in your request and the object was uploaded as a multipart upload.
- PartsCount *int64 `location:"header" locationName:"x-amz-mp-parts-count" type:"integer"`
- // Amazon S3 can return this header if your request involves a bucket that is
- // either a source or a destination in a replication rule.
- //
- // In replication, you have a source bucket on which you configure replication
- // and destination bucket or buckets where Amazon S3 stores object replicas.
- // When you request an object (GetObject) or object metadata (HeadObject) from
- // these buckets, Amazon S3 will return the x-amz-replication-status header
- // in the response as follows:
- //
- // * If requesting an object from the source bucket, Amazon S3 will return
- // the x-amz-replication-status header if the object in your request is eligible
- // for replication. For example, suppose that in your replication configuration,
- // you specify object prefix TaxDocs requesting Amazon S3 to replicate objects
- // with key prefix TaxDocs. Any objects you upload with this key name prefix,
- // for example TaxDocs/document1.pdf, are eligible for replication. For any
- // object request with this key name prefix, Amazon S3 will return the x-amz-replication-status
- // header with value PENDING, COMPLETED or FAILED indicating object replication
- // status.
- //
- // * If requesting an object from a destination bucket, Amazon S3 will return
- // the x-amz-replication-status header with value REPLICA if the object in
- // your request is a replica that Amazon S3 created and there is no replica
- // modification replication in progress.
- //
- // * When replicating objects to multiple destination buckets, the x-amz-replication-status
- // header acts differently. The header of the source object will only return
- // a value of COMPLETED when replication is successful to all destinations.
- // The header will remain at value PENDING until replication has completed
- // for all destinations. If one or more destinations fails replication the
- // header will return FAILED.
- //
- // For more information, see Replication (https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html).
- ReplicationStatus *string `location:"header" locationName:"x-amz-replication-status" type:"string" enum:"ReplicationStatus"`
- // If present, indicates that the requester was successfully charged for the
- // request.
- RequestCharged *string `location:"header" locationName:"x-amz-request-charged" type:"string" enum:"RequestCharged"`
- // If the object is an archived object (an object whose storage class is GLACIER),
- // the response includes this header if either the archive restoration is in
- // progress (see RestoreObject (https://docs.aws.amazon.com/AmazonS3/latest/API/API_RestoreObject.html)
- // or an archive copy is already restored.
- //
- // If an archive copy is already restored, the header value indicates when Amazon
- // S3 is scheduled to delete the object copy. For example:
- //
- // x-amz-restore: ongoing-request="false", expiry-date="Fri, 21 Dec 2012 00:00:00
- // GMT"
- //
- // If the object restoration is in progress, the header returns the value ongoing-request="true".
- //
- // For more information about archiving objects, see Transitioning Objects:
- // General Considerations (https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html#lifecycle-transition-general-considerations).
- Restore *string `location:"header" locationName:"x-amz-restore" type:"string"`
- // If server-side encryption with a customer-provided encryption key was requested,
- // the response will include this header confirming the encryption algorithm
- // used.
- SSECustomerAlgorithm *string `location:"header" locationName:"x-amz-server-side-encryption-customer-algorithm" type:"string"`
- // If server-side encryption with a customer-provided encryption key was requested,
- // the response will include this header to provide round-trip message integrity
- // verification of the customer-provided encryption key.
- SSECustomerKeyMD5 *string `location:"header" locationName:"x-amz-server-side-encryption-customer-key-MD5" type:"string"`
- // If present, specifies the ID of the Amazon Web Services Key Management Service
- // (Amazon Web Services KMS) symmetric customer managed key that was used for
- // the object.
- //
- // SSEKMSKeyId is a sensitive parameter and its value will be
- // replaced with "sensitive" in string returned by HeadObjectOutput's
- // String and GoString methods.
- SSEKMSKeyId *string `location:"header" locationName:"x-amz-server-side-encryption-aws-kms-key-id" type:"string" sensitive:"true"`
- // If the object is stored using server-side encryption either with an Amazon
- // Web Services KMS key or an Amazon S3-managed encryption key, the response
- // includes this header with the value of the server-side encryption algorithm
- // used when storing this object in Amazon S3 (for example, AES256, aws:kms).
- ServerSideEncryption *string `location:"header" locationName:"x-amz-server-side-encryption" type:"string" enum:"ServerSideEncryption"`
- // Provides storage class information of the object. Amazon S3 returns this
- // header for all objects except for S3 Standard storage class objects.
- //
- // For more information, see Storage Classes (https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html).
- StorageClass *string `location:"header" locationName:"x-amz-storage-class" type:"string" enum:"StorageClass"`
- // Version of the object.
- VersionId *string `location:"header" locationName:"x-amz-version-id" type:"string"`
- // If the bucket is configured as a website, redirects requests for this object
- // to another object in the same bucket or to an external URL. Amazon S3 stores
- // the value of this header in the object metadata.
- WebsiteRedirectLocation *string `location:"header" locationName:"x-amz-website-redirect-location" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s HeadObjectOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s HeadObjectOutput) GoString() string {
- return s.String()
- }
- // SetAcceptRanges sets the AcceptRanges field's value.
- func (s *HeadObjectOutput) SetAcceptRanges(v string) *HeadObjectOutput {
- s.AcceptRanges = &v
- return s
- }
- // SetArchiveStatus sets the ArchiveStatus field's value.
- func (s *HeadObjectOutput) SetArchiveStatus(v string) *HeadObjectOutput {
- s.ArchiveStatus = &v
- return s
- }
- // SetBucketKeyEnabled sets the BucketKeyEnabled field's value.
- func (s *HeadObjectOutput) SetBucketKeyEnabled(v bool) *HeadObjectOutput {
- s.BucketKeyEnabled = &v
- return s
- }
- // SetCacheControl sets the CacheControl field's value.
- func (s *HeadObjectOutput) SetCacheControl(v string) *HeadObjectOutput {
- s.CacheControl = &v
- return s
- }
- // SetChecksumCRC32 sets the ChecksumCRC32 field's value.
- func (s *HeadObjectOutput) SetChecksumCRC32(v string) *HeadObjectOutput {
- s.ChecksumCRC32 = &v
- return s
- }
- // SetChecksumCRC32C sets the ChecksumCRC32C field's value.
- func (s *HeadObjectOutput) SetChecksumCRC32C(v string) *HeadObjectOutput {
- s.ChecksumCRC32C = &v
- return s
- }
- // SetChecksumSHA1 sets the ChecksumSHA1 field's value.
- func (s *HeadObjectOutput) SetChecksumSHA1(v string) *HeadObjectOutput {
- s.ChecksumSHA1 = &v
- return s
- }
- // SetChecksumSHA256 sets the ChecksumSHA256 field's value.
- func (s *HeadObjectOutput) SetChecksumSHA256(v string) *HeadObjectOutput {
- s.ChecksumSHA256 = &v
- return s
- }
- // SetContentDisposition sets the ContentDisposition field's value.
- func (s *HeadObjectOutput) SetContentDisposition(v string) *HeadObjectOutput {
- s.ContentDisposition = &v
- return s
- }
- // SetContentEncoding sets the ContentEncoding field's value.
- func (s *HeadObjectOutput) SetContentEncoding(v string) *HeadObjectOutput {
- s.ContentEncoding = &v
- return s
- }
- // SetContentLanguage sets the ContentLanguage field's value.
- func (s *HeadObjectOutput) SetContentLanguage(v string) *HeadObjectOutput {
- s.ContentLanguage = &v
- return s
- }
- // SetContentLength sets the ContentLength field's value.
- func (s *HeadObjectOutput) SetContentLength(v int64) *HeadObjectOutput {
- s.ContentLength = &v
- return s
- }
- // SetContentType sets the ContentType field's value.
- func (s *HeadObjectOutput) SetContentType(v string) *HeadObjectOutput {
- s.ContentType = &v
- return s
- }
- // SetDeleteMarker sets the DeleteMarker field's value.
- func (s *HeadObjectOutput) SetDeleteMarker(v bool) *HeadObjectOutput {
- s.DeleteMarker = &v
- return s
- }
- // SetETag sets the ETag field's value.
- func (s *HeadObjectOutput) SetETag(v string) *HeadObjectOutput {
- s.ETag = &v
- return s
- }
- // SetExpiration sets the Expiration field's value.
- func (s *HeadObjectOutput) SetExpiration(v string) *HeadObjectOutput {
- s.Expiration = &v
- return s
- }
- // SetExpires sets the Expires field's value.
- func (s *HeadObjectOutput) SetExpires(v string) *HeadObjectOutput {
- s.Expires = &v
- return s
- }
- // SetLastModified sets the LastModified field's value.
- func (s *HeadObjectOutput) SetLastModified(v time.Time) *HeadObjectOutput {
- s.LastModified = &v
- return s
- }
- // SetMetadata sets the Metadata field's value.
- func (s *HeadObjectOutput) SetMetadata(v map[string]*string) *HeadObjectOutput {
- s.Metadata = v
- return s
- }
- // SetMissingMeta sets the MissingMeta field's value.
- func (s *HeadObjectOutput) SetMissingMeta(v int64) *HeadObjectOutput {
- s.MissingMeta = &v
- return s
- }
- // SetObjectLockLegalHoldStatus sets the ObjectLockLegalHoldStatus field's value.
- func (s *HeadObjectOutput) SetObjectLockLegalHoldStatus(v string) *HeadObjectOutput {
- s.ObjectLockLegalHoldStatus = &v
- return s
- }
- // SetObjectLockMode sets the ObjectLockMode field's value.
- func (s *HeadObjectOutput) SetObjectLockMode(v string) *HeadObjectOutput {
- s.ObjectLockMode = &v
- return s
- }
- // SetObjectLockRetainUntilDate sets the ObjectLockRetainUntilDate field's value.
- func (s *HeadObjectOutput) SetObjectLockRetainUntilDate(v time.Time) *HeadObjectOutput {
- s.ObjectLockRetainUntilDate = &v
- return s
- }
- // SetPartsCount sets the PartsCount field's value.
- func (s *HeadObjectOutput) SetPartsCount(v int64) *HeadObjectOutput {
- s.PartsCount = &v
- return s
- }
- // SetReplicationStatus sets the ReplicationStatus field's value.
- func (s *HeadObjectOutput) SetReplicationStatus(v string) *HeadObjectOutput {
- s.ReplicationStatus = &v
- return s
- }
- // SetRequestCharged sets the RequestCharged field's value.
- func (s *HeadObjectOutput) SetRequestCharged(v string) *HeadObjectOutput {
- s.RequestCharged = &v
- return s
- }
- // SetRestore sets the Restore field's value.
- func (s *HeadObjectOutput) SetRestore(v string) *HeadObjectOutput {
- s.Restore = &v
- return s
- }
- // SetSSECustomerAlgorithm sets the SSECustomerAlgorithm field's value.
- func (s *HeadObjectOutput) SetSSECustomerAlgorithm(v string) *HeadObjectOutput {
- s.SSECustomerAlgorithm = &v
- return s
- }
- // SetSSECustomerKeyMD5 sets the SSECustomerKeyMD5 field's value.
- func (s *HeadObjectOutput) SetSSECustomerKeyMD5(v string) *HeadObjectOutput {
- s.SSECustomerKeyMD5 = &v
- return s
- }
- // SetSSEKMSKeyId sets the SSEKMSKeyId field's value.
- func (s *HeadObjectOutput) SetSSEKMSKeyId(v string) *HeadObjectOutput {
- s.SSEKMSKeyId = &v
- return s
- }
- // SetServerSideEncryption sets the ServerSideEncryption field's value.
- func (s *HeadObjectOutput) SetServerSideEncryption(v string) *HeadObjectOutput {
- s.ServerSideEncryption = &v
- return s
- }
- // SetStorageClass sets the StorageClass field's value.
- func (s *HeadObjectOutput) SetStorageClass(v string) *HeadObjectOutput {
- s.StorageClass = &v
- return s
- }
- // SetVersionId sets the VersionId field's value.
- func (s *HeadObjectOutput) SetVersionId(v string) *HeadObjectOutput {
- s.VersionId = &v
- return s
- }
- // SetWebsiteRedirectLocation sets the WebsiteRedirectLocation field's value.
- func (s *HeadObjectOutput) SetWebsiteRedirectLocation(v string) *HeadObjectOutput {
- s.WebsiteRedirectLocation = &v
- return s
- }
- // Container for the Suffix element.
- type IndexDocument struct {
- _ struct{} `type:"structure"`
- // A suffix that is appended to a request that is for a directory on the website
- // endpoint (for example,if the suffix is index.html and you make a request
- // to samplebucket/images/ the data that is returned will be for the object
- // with the key name images/index.html) The suffix must not be empty and must
- // not include a slash character.
- //
- // Replacement must be made for object keys containing special characters (such
- // as carriage returns) when using XML requests. For more information, see XML
- // related object key constraints (https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html#object-key-xml-related-constraints).
- //
- // Suffix is a required field
- Suffix *string `type:"string" required:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s IndexDocument) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s IndexDocument) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *IndexDocument) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "IndexDocument"}
- if s.Suffix == nil {
- invalidParams.Add(request.NewErrParamRequired("Suffix"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetSuffix sets the Suffix field's value.
- func (s *IndexDocument) SetSuffix(v string) *IndexDocument {
- s.Suffix = &v
- return s
- }
- // Container element that identifies who initiated the multipart upload.
- type Initiator struct {
- _ struct{} `type:"structure"`
- // Name of the Principal.
- DisplayName *string `type:"string"`
- // If the principal is an Amazon Web Services account, it provides the Canonical
- // User ID. If the principal is an IAM User, it provides a user ARN value.
- ID *string `type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s Initiator) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s Initiator) GoString() string {
- return s.String()
- }
- // SetDisplayName sets the DisplayName field's value.
- func (s *Initiator) SetDisplayName(v string) *Initiator {
- s.DisplayName = &v
- return s
- }
- // SetID sets the ID field's value.
- func (s *Initiator) SetID(v string) *Initiator {
- s.ID = &v
- return s
- }
- // Describes the serialization format of the object.
- type InputSerialization struct {
- _ struct{} `type:"structure"`
- // Describes the serialization of a CSV-encoded object.
- CSV *CSVInput `type:"structure"`
- // Specifies object's compression format. Valid values: NONE, GZIP, BZIP2. Default
- // Value: NONE.
- CompressionType *string `type:"string" enum:"CompressionType"`
- // Specifies JSON as object's input serialization format.
- JSON *JSONInput `type:"structure"`
- // Specifies Parquet as object's input serialization format.
- Parquet *ParquetInput `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s InputSerialization) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s InputSerialization) GoString() string {
- return s.String()
- }
- // SetCSV sets the CSV field's value.
- func (s *InputSerialization) SetCSV(v *CSVInput) *InputSerialization {
- s.CSV = v
- return s
- }
- // SetCompressionType sets the CompressionType field's value.
- func (s *InputSerialization) SetCompressionType(v string) *InputSerialization {
- s.CompressionType = &v
- return s
- }
- // SetJSON sets the JSON field's value.
- func (s *InputSerialization) SetJSON(v *JSONInput) *InputSerialization {
- s.JSON = v
- return s
- }
- // SetParquet sets the Parquet field's value.
- func (s *InputSerialization) SetParquet(v *ParquetInput) *InputSerialization {
- s.Parquet = v
- return s
- }
- // A container for specifying S3 Intelligent-Tiering filters. The filters determine
- // the subset of objects to which the rule applies.
- type IntelligentTieringAndOperator struct {
- _ struct{} `type:"structure"`
- // An object key name prefix that identifies the subset of objects to which
- // the configuration applies.
- Prefix *string `type:"string"`
- // All of these tags must exist in the object's tag set in order for the configuration
- // to apply.
- Tags []*Tag `locationName:"Tag" locationNameList:"Tag" type:"list" flattened:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s IntelligentTieringAndOperator) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s IntelligentTieringAndOperator) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *IntelligentTieringAndOperator) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "IntelligentTieringAndOperator"}
- 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
- }
- // SetPrefix sets the Prefix field's value.
- func (s *IntelligentTieringAndOperator) SetPrefix(v string) *IntelligentTieringAndOperator {
- s.Prefix = &v
- return s
- }
- // SetTags sets the Tags field's value.
- func (s *IntelligentTieringAndOperator) SetTags(v []*Tag) *IntelligentTieringAndOperator {
- s.Tags = v
- return s
- }
- // Specifies the S3 Intelligent-Tiering configuration for an Amazon S3 bucket.
- //
- // For information about the S3 Intelligent-Tiering storage class, see Storage
- // class for automatically optimizing frequently and infrequently accessed objects
- // (https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html#sc-dynamic-data-access).
- type IntelligentTieringConfiguration struct {
- _ struct{} `type:"structure"`
- // Specifies a bucket filter. The configuration only includes objects that meet
- // the filter's criteria.
- Filter *IntelligentTieringFilter `type:"structure"`
- // The ID used to identify the S3 Intelligent-Tiering configuration.
- //
- // Id is a required field
- Id *string `type:"string" required:"true"`
- // Specifies the status of the configuration.
- //
- // Status is a required field
- Status *string `type:"string" required:"true" enum:"IntelligentTieringStatus"`
- // Specifies the S3 Intelligent-Tiering storage class tier of the configuration.
- //
- // Tierings is a required field
- Tierings []*Tiering `locationName:"Tiering" type:"list" flattened:"true" required:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s IntelligentTieringConfiguration) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s IntelligentTieringConfiguration) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *IntelligentTieringConfiguration) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "IntelligentTieringConfiguration"}
- if s.Id == nil {
- invalidParams.Add(request.NewErrParamRequired("Id"))
- }
- if s.Status == nil {
- invalidParams.Add(request.NewErrParamRequired("Status"))
- }
- if s.Tierings == nil {
- invalidParams.Add(request.NewErrParamRequired("Tierings"))
- }
- if s.Filter != nil {
- if err := s.Filter.Validate(); err != nil {
- invalidParams.AddNested("Filter", err.(request.ErrInvalidParams))
- }
- }
- if s.Tierings != nil {
- for i, v := range s.Tierings {
- if v == nil {
- continue
- }
- if err := v.Validate(); err != nil {
- invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Tierings", i), err.(request.ErrInvalidParams))
- }
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetFilter sets the Filter field's value.
- func (s *IntelligentTieringConfiguration) SetFilter(v *IntelligentTieringFilter) *IntelligentTieringConfiguration {
- s.Filter = v
- return s
- }
- // SetId sets the Id field's value.
- func (s *IntelligentTieringConfiguration) SetId(v string) *IntelligentTieringConfiguration {
- s.Id = &v
- return s
- }
- // SetStatus sets the Status field's value.
- func (s *IntelligentTieringConfiguration) SetStatus(v string) *IntelligentTieringConfiguration {
- s.Status = &v
- return s
- }
- // SetTierings sets the Tierings field's value.
- func (s *IntelligentTieringConfiguration) SetTierings(v []*Tiering) *IntelligentTieringConfiguration {
- s.Tierings = v
- return s
- }
- // The Filter is used to identify objects that the S3 Intelligent-Tiering configuration
- // applies to.
- type IntelligentTieringFilter struct {
- _ struct{} `type:"structure"`
- // A conjunction (logical AND) of predicates, which is used in evaluating a
- // metrics filter. The operator must have at least two predicates, and an object
- // must match all of the predicates in order for the filter to apply.
- And *IntelligentTieringAndOperator `type:"structure"`
- // An object key name prefix that identifies the subset of objects to which
- // the rule applies.
- //
- // Replacement must be made for object keys containing special characters (such
- // as carriage returns) when using XML requests. For more information, see XML
- // related object key constraints (https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html#object-key-xml-related-constraints).
- Prefix *string `type:"string"`
- // A container of a key value name pair.
- Tag *Tag `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s IntelligentTieringFilter) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s IntelligentTieringFilter) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *IntelligentTieringFilter) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "IntelligentTieringFilter"}
- if s.And != nil {
- if err := s.And.Validate(); err != nil {
- invalidParams.AddNested("And", err.(request.ErrInvalidParams))
- }
- }
- if s.Tag != nil {
- if err := s.Tag.Validate(); err != nil {
- invalidParams.AddNested("Tag", err.(request.ErrInvalidParams))
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetAnd sets the And field's value.
- func (s *IntelligentTieringFilter) SetAnd(v *IntelligentTieringAndOperator) *IntelligentTieringFilter {
- s.And = v
- return s
- }
- // SetPrefix sets the Prefix field's value.
- func (s *IntelligentTieringFilter) SetPrefix(v string) *IntelligentTieringFilter {
- s.Prefix = &v
- return s
- }
- // SetTag sets the Tag field's value.
- func (s *IntelligentTieringFilter) SetTag(v *Tag) *IntelligentTieringFilter {
- s.Tag = v
- return s
- }
- // Specifies the inventory configuration for an Amazon S3 bucket. For more information,
- // see GET Bucket inventory (https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketGETInventoryConfig.html)
- // in the Amazon S3 API Reference.
- type InventoryConfiguration struct {
- _ struct{} `type:"structure"`
- // Contains information about where to publish the inventory results.
- //
- // Destination is a required field
- Destination *InventoryDestination `type:"structure" required:"true"`
- // Specifies an inventory filter. The inventory only includes objects that meet
- // the filter's criteria.
- Filter *InventoryFilter `type:"structure"`
- // The ID used to identify the inventory configuration.
- //
- // Id is a required field
- Id *string `type:"string" required:"true"`
- // Object versions to include in the inventory list. If set to All, the list
- // includes all the object versions, which adds the version-related fields VersionId,
- // IsLatest, and DeleteMarker to the list. If set to Current, the list does
- // not contain these version-related fields.
- //
- // IncludedObjectVersions is a required field
- IncludedObjectVersions *string `type:"string" required:"true" enum:"InventoryIncludedObjectVersions"`
- // Specifies whether the inventory is enabled or disabled. If set to True, an
- // inventory list is generated. If set to False, no inventory list is generated.
- //
- // IsEnabled is a required field
- IsEnabled *bool `type:"boolean" required:"true"`
- // Contains the optional fields that are included in the inventory results.
- OptionalFields []*string `locationNameList:"Field" type:"list" enum:"InventoryOptionalField"`
- // Specifies the schedule for generating inventory results.
- //
- // Schedule is a required field
- Schedule *InventorySchedule `type:"structure" required:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s InventoryConfiguration) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s InventoryConfiguration) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *InventoryConfiguration) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "InventoryConfiguration"}
- if s.Destination == nil {
- invalidParams.Add(request.NewErrParamRequired("Destination"))
- }
- if s.Id == nil {
- invalidParams.Add(request.NewErrParamRequired("Id"))
- }
- if s.IncludedObjectVersions == nil {
- invalidParams.Add(request.NewErrParamRequired("IncludedObjectVersions"))
- }
- if s.IsEnabled == nil {
- invalidParams.Add(request.NewErrParamRequired("IsEnabled"))
- }
- if s.Schedule == nil {
- invalidParams.Add(request.NewErrParamRequired("Schedule"))
- }
- if s.Destination != nil {
- if err := s.Destination.Validate(); err != nil {
- invalidParams.AddNested("Destination", err.(request.ErrInvalidParams))
- }
- }
- if s.Filter != nil {
- if err := s.Filter.Validate(); err != nil {
- invalidParams.AddNested("Filter", err.(request.ErrInvalidParams))
- }
- }
- if s.Schedule != nil {
- if err := s.Schedule.Validate(); err != nil {
- invalidParams.AddNested("Schedule", err.(request.ErrInvalidParams))
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetDestination sets the Destination field's value.
- func (s *InventoryConfiguration) SetDestination(v *InventoryDestination) *InventoryConfiguration {
- s.Destination = v
- return s
- }
- // SetFilter sets the Filter field's value.
- func (s *InventoryConfiguration) SetFilter(v *InventoryFilter) *InventoryConfiguration {
- s.Filter = v
- return s
- }
- // SetId sets the Id field's value.
- func (s *InventoryConfiguration) SetId(v string) *InventoryConfiguration {
- s.Id = &v
- return s
- }
- // SetIncludedObjectVersions sets the IncludedObjectVersions field's value.
- func (s *InventoryConfiguration) SetIncludedObjectVersions(v string) *InventoryConfiguration {
- s.IncludedObjectVersions = &v
- return s
- }
- // SetIsEnabled sets the IsEnabled field's value.
- func (s *InventoryConfiguration) SetIsEnabled(v bool) *InventoryConfiguration {
- s.IsEnabled = &v
- return s
- }
- // SetOptionalFields sets the OptionalFields field's value.
- func (s *InventoryConfiguration) SetOptionalFields(v []*string) *InventoryConfiguration {
- s.OptionalFields = v
- return s
- }
- // SetSchedule sets the Schedule field's value.
- func (s *InventoryConfiguration) SetSchedule(v *InventorySchedule) *InventoryConfiguration {
- s.Schedule = v
- return s
- }
- // Specifies the inventory configuration for an Amazon S3 bucket.
- type InventoryDestination struct {
- _ struct{} `type:"structure"`
- // Contains the bucket name, file format, bucket owner (optional), and prefix
- // (optional) where inventory results are published.
- //
- // S3BucketDestination is a required field
- S3BucketDestination *InventoryS3BucketDestination `type:"structure" required:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s InventoryDestination) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s InventoryDestination) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *InventoryDestination) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "InventoryDestination"}
- if s.S3BucketDestination == nil {
- invalidParams.Add(request.NewErrParamRequired("S3BucketDestination"))
- }
- if s.S3BucketDestination != nil {
- if err := s.S3BucketDestination.Validate(); err != nil {
- invalidParams.AddNested("S3BucketDestination", err.(request.ErrInvalidParams))
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetS3BucketDestination sets the S3BucketDestination field's value.
- func (s *InventoryDestination) SetS3BucketDestination(v *InventoryS3BucketDestination) *InventoryDestination {
- s.S3BucketDestination = v
- return s
- }
- // Contains the type of server-side encryption used to encrypt the inventory
- // results.
- type InventoryEncryption struct {
- _ struct{} `type:"structure"`
- // Specifies the use of SSE-KMS to encrypt delivered inventory reports.
- SSEKMS *SSEKMS `locationName:"SSE-KMS" type:"structure"`
- // Specifies the use of SSE-S3 to encrypt delivered inventory reports.
- SSES3 *SSES3 `locationName:"SSE-S3" type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s InventoryEncryption) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s InventoryEncryption) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *InventoryEncryption) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "InventoryEncryption"}
- if s.SSEKMS != nil {
- if err := s.SSEKMS.Validate(); err != nil {
- invalidParams.AddNested("SSEKMS", err.(request.ErrInvalidParams))
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetSSEKMS sets the SSEKMS field's value.
- func (s *InventoryEncryption) SetSSEKMS(v *SSEKMS) *InventoryEncryption {
- s.SSEKMS = v
- return s
- }
- // SetSSES3 sets the SSES3 field's value.
- func (s *InventoryEncryption) SetSSES3(v *SSES3) *InventoryEncryption {
- s.SSES3 = v
- return s
- }
- // Specifies an inventory filter. The inventory only includes objects that meet
- // the filter's criteria.
- type InventoryFilter struct {
- _ struct{} `type:"structure"`
- // The prefix that an object must have to be included in the inventory results.
- //
- // Prefix is a required field
- Prefix *string `type:"string" required:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s InventoryFilter) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s InventoryFilter) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *InventoryFilter) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "InventoryFilter"}
- if s.Prefix == nil {
- invalidParams.Add(request.NewErrParamRequired("Prefix"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetPrefix sets the Prefix field's value.
- func (s *InventoryFilter) SetPrefix(v string) *InventoryFilter {
- s.Prefix = &v
- return s
- }
- // Contains the bucket name, file format, bucket owner (optional), and prefix
- // (optional) where inventory results are published.
- type InventoryS3BucketDestination struct {
- _ struct{} `type:"structure"`
- // The account ID that owns the destination S3 bucket. If no account ID is provided,
- // the owner is not validated before exporting data.
- //
- // Although this value is optional, we strongly recommend that you set it to
- // help prevent problems if the destination bucket ownership changes.
- AccountId *string `type:"string"`
- // The Amazon Resource Name (ARN) of the bucket where inventory results will
- // be published.
- //
- // Bucket is a required field
- Bucket *string `type:"string" required:"true"`
- // Contains the type of server-side encryption used to encrypt the inventory
- // results.
- Encryption *InventoryEncryption `type:"structure"`
- // Specifies the output format of the inventory results.
- //
- // Format is a required field
- Format *string `type:"string" required:"true" enum:"InventoryFormat"`
- // The prefix that is prepended to all inventory results.
- Prefix *string `type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s InventoryS3BucketDestination) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s InventoryS3BucketDestination) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *InventoryS3BucketDestination) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "InventoryS3BucketDestination"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Format == nil {
- invalidParams.Add(request.NewErrParamRequired("Format"))
- }
- if s.Encryption != nil {
- if err := s.Encryption.Validate(); err != nil {
- invalidParams.AddNested("Encryption", err.(request.ErrInvalidParams))
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetAccountId sets the AccountId field's value.
- func (s *InventoryS3BucketDestination) SetAccountId(v string) *InventoryS3BucketDestination {
- s.AccountId = &v
- return s
- }
- // SetBucket sets the Bucket field's value.
- func (s *InventoryS3BucketDestination) SetBucket(v string) *InventoryS3BucketDestination {
- s.Bucket = &v
- return s
- }
- func (s *InventoryS3BucketDestination) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetEncryption sets the Encryption field's value.
- func (s *InventoryS3BucketDestination) SetEncryption(v *InventoryEncryption) *InventoryS3BucketDestination {
- s.Encryption = v
- return s
- }
- // SetFormat sets the Format field's value.
- func (s *InventoryS3BucketDestination) SetFormat(v string) *InventoryS3BucketDestination {
- s.Format = &v
- return s
- }
- // SetPrefix sets the Prefix field's value.
- func (s *InventoryS3BucketDestination) SetPrefix(v string) *InventoryS3BucketDestination {
- s.Prefix = &v
- return s
- }
- // Specifies the schedule for generating inventory results.
- type InventorySchedule struct {
- _ struct{} `type:"structure"`
- // Specifies how frequently inventory results are produced.
- //
- // Frequency is a required field
- Frequency *string `type:"string" required:"true" enum:"InventoryFrequency"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s InventorySchedule) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s InventorySchedule) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *InventorySchedule) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "InventorySchedule"}
- if s.Frequency == nil {
- invalidParams.Add(request.NewErrParamRequired("Frequency"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetFrequency sets the Frequency field's value.
- func (s *InventorySchedule) SetFrequency(v string) *InventorySchedule {
- s.Frequency = &v
- return s
- }
- // Specifies JSON as object's input serialization format.
- type JSONInput struct {
- _ struct{} `type:"structure"`
- // The type of JSON. Valid values: Document, Lines.
- Type *string `type:"string" enum:"JSONType"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s JSONInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s JSONInput) GoString() string {
- return s.String()
- }
- // SetType sets the Type field's value.
- func (s *JSONInput) SetType(v string) *JSONInput {
- s.Type = &v
- return s
- }
- // Specifies JSON as request's output serialization format.
- type JSONOutput struct {
- _ struct{} `type:"structure"`
- // The value used to separate individual records in the output. If no value
- // is specified, Amazon S3 uses a newline character ('\n').
- RecordDelimiter *string `type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s JSONOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s JSONOutput) GoString() string {
- return s.String()
- }
- // SetRecordDelimiter sets the RecordDelimiter field's value.
- func (s *JSONOutput) SetRecordDelimiter(v string) *JSONOutput {
- s.RecordDelimiter = &v
- return s
- }
- // A container for object key name prefix and suffix filtering rules.
- type KeyFilter struct {
- _ struct{} `type:"structure"`
- // A list of containers for the key-value pair that defines the criteria for
- // the filter rule.
- FilterRules []*FilterRule `locationName:"FilterRule" type:"list" flattened:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s KeyFilter) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s KeyFilter) GoString() string {
- return s.String()
- }
- // SetFilterRules sets the FilterRules field's value.
- func (s *KeyFilter) SetFilterRules(v []*FilterRule) *KeyFilter {
- s.FilterRules = v
- return s
- }
- // A container for specifying the configuration for Lambda notifications.
- type LambdaFunctionConfiguration struct {
- _ struct{} `type:"structure"`
- // The Amazon S3 bucket event for which to invoke the Lambda function. For more
- // information, see Supported Event Types (https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html)
- // in the Amazon S3 User Guide.
- //
- // Events is a required field
- Events []*string `locationName:"Event" type:"list" flattened:"true" required:"true" enum:"Event"`
- // Specifies object key name filtering rules. For information about key name
- // filtering, see Configuring Event Notifications (https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html)
- // in the Amazon S3 User Guide.
- Filter *NotificationConfigurationFilter `type:"structure"`
- // An optional unique identifier for configurations in a notification configuration.
- // If you don't provide one, Amazon S3 will assign an ID.
- Id *string `type:"string"`
- // The Amazon Resource Name (ARN) of the Lambda function that Amazon S3 invokes
- // when the specified event type occurs.
- //
- // LambdaFunctionArn is a required field
- LambdaFunctionArn *string `locationName:"CloudFunction" type:"string" required:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s LambdaFunctionConfiguration) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s LambdaFunctionConfiguration) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *LambdaFunctionConfiguration) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "LambdaFunctionConfiguration"}
- if s.Events == nil {
- invalidParams.Add(request.NewErrParamRequired("Events"))
- }
- if s.LambdaFunctionArn == nil {
- invalidParams.Add(request.NewErrParamRequired("LambdaFunctionArn"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetEvents sets the Events field's value.
- func (s *LambdaFunctionConfiguration) SetEvents(v []*string) *LambdaFunctionConfiguration {
- s.Events = v
- return s
- }
- // SetFilter sets the Filter field's value.
- func (s *LambdaFunctionConfiguration) SetFilter(v *NotificationConfigurationFilter) *LambdaFunctionConfiguration {
- s.Filter = v
- return s
- }
- // SetId sets the Id field's value.
- func (s *LambdaFunctionConfiguration) SetId(v string) *LambdaFunctionConfiguration {
- s.Id = &v
- return s
- }
- // SetLambdaFunctionArn sets the LambdaFunctionArn field's value.
- func (s *LambdaFunctionConfiguration) SetLambdaFunctionArn(v string) *LambdaFunctionConfiguration {
- s.LambdaFunctionArn = &v
- return s
- }
- // Container for lifecycle rules. You can add as many as 1000 rules.
- type LifecycleConfiguration struct {
- _ struct{} `type:"structure"`
- // Specifies lifecycle configuration rules for an Amazon S3 bucket.
- //
- // Rules is a required field
- Rules []*Rule `locationName:"Rule" type:"list" flattened:"true" required:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s LifecycleConfiguration) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s LifecycleConfiguration) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *LifecycleConfiguration) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "LifecycleConfiguration"}
- if s.Rules == nil {
- invalidParams.Add(request.NewErrParamRequired("Rules"))
- }
- if s.Rules != nil {
- for i, v := range s.Rules {
- if v == nil {
- continue
- }
- if err := v.Validate(); err != nil {
- invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Rules", i), err.(request.ErrInvalidParams))
- }
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetRules sets the Rules field's value.
- func (s *LifecycleConfiguration) SetRules(v []*Rule) *LifecycleConfiguration {
- s.Rules = v
- return s
- }
- // Container for the expiration for the lifecycle of the object.
- type LifecycleExpiration struct {
- _ struct{} `type:"structure"`
- // Indicates at what date the object is to be moved or deleted. Should be in
- // GMT ISO 8601 Format.
- Date *time.Time `type:"timestamp" timestampFormat:"iso8601"`
- // Indicates the lifetime, in days, of the objects that are subject to the rule.
- // The value must be a non-zero positive integer.
- Days *int64 `type:"integer"`
- // Indicates whether Amazon S3 will remove a delete marker with no noncurrent
- // versions. If set to true, the delete marker will be expired; if set to false
- // the policy takes no action. This cannot be specified with Days or Date in
- // a Lifecycle Expiration Policy.
- ExpiredObjectDeleteMarker *bool `type:"boolean"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s LifecycleExpiration) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s LifecycleExpiration) GoString() string {
- return s.String()
- }
- // SetDate sets the Date field's value.
- func (s *LifecycleExpiration) SetDate(v time.Time) *LifecycleExpiration {
- s.Date = &v
- return s
- }
- // SetDays sets the Days field's value.
- func (s *LifecycleExpiration) SetDays(v int64) *LifecycleExpiration {
- s.Days = &v
- return s
- }
- // SetExpiredObjectDeleteMarker sets the ExpiredObjectDeleteMarker field's value.
- func (s *LifecycleExpiration) SetExpiredObjectDeleteMarker(v bool) *LifecycleExpiration {
- s.ExpiredObjectDeleteMarker = &v
- return s
- }
- // A lifecycle rule for individual objects in an Amazon S3 bucket.
- type LifecycleRule struct {
- _ struct{} `type:"structure"`
- // Specifies the days since the initiation of an incomplete multipart upload
- // that Amazon S3 will wait before permanently removing all parts of the upload.
- // For more information, see Aborting Incomplete Multipart Uploads Using a Bucket
- // Lifecycle Policy (https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html#mpu-abort-incomplete-mpu-lifecycle-config)
- // in the Amazon S3 User Guide.
- AbortIncompleteMultipartUpload *AbortIncompleteMultipartUpload `type:"structure"`
- // Specifies the expiration for the lifecycle of the object in the form of date,
- // days and, whether the object has a delete marker.
- Expiration *LifecycleExpiration `type:"structure"`
- // The Filter is used to identify objects that a Lifecycle Rule applies to.
- // A Filter must have exactly one of Prefix, Tag, or And specified. Filter is
- // required if the LifecycleRule does not contain a Prefix element.
- Filter *LifecycleRuleFilter `type:"structure"`
- // Unique identifier for the rule. The value cannot be longer than 255 characters.
- ID *string `type:"string"`
- // Specifies when noncurrent object versions expire. Upon expiration, Amazon
- // S3 permanently deletes the noncurrent object versions. You set this lifecycle
- // configuration action on a bucket that has versioning enabled (or suspended)
- // to request that Amazon S3 delete noncurrent object versions at a specific
- // period in the object's lifetime.
- NoncurrentVersionExpiration *NoncurrentVersionExpiration `type:"structure"`
- // Specifies the transition rule for the lifecycle rule that describes when
- // noncurrent objects transition to a specific storage class. If your bucket
- // is versioning-enabled (or versioning is suspended), you can set this action
- // to request that Amazon S3 transition noncurrent object versions to a specific
- // storage class at a set period in the object's lifetime.
- NoncurrentVersionTransitions []*NoncurrentVersionTransition `locationName:"NoncurrentVersionTransition" type:"list" flattened:"true"`
- // Prefix identifying one or more objects to which the rule applies. This is
- // no longer used; use Filter instead.
- //
- // Replacement must be made for object keys containing special characters (such
- // as carriage returns) when using XML requests. For more information, see XML
- // related object key constraints (https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html#object-key-xml-related-constraints).
- //
- // Deprecated: Prefix has been deprecated
- Prefix *string `deprecated:"true" type:"string"`
- // If 'Enabled', the rule is currently being applied. If 'Disabled', the rule
- // is not currently being applied.
- //
- // Status is a required field
- Status *string `type:"string" required:"true" enum:"ExpirationStatus"`
- // Specifies when an Amazon S3 object transitions to a specified storage class.
- Transitions []*Transition `locationName:"Transition" type:"list" flattened:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s LifecycleRule) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s LifecycleRule) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *LifecycleRule) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "LifecycleRule"}
- if s.Status == nil {
- invalidParams.Add(request.NewErrParamRequired("Status"))
- }
- if s.Filter != nil {
- if err := s.Filter.Validate(); err != nil {
- invalidParams.AddNested("Filter", err.(request.ErrInvalidParams))
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetAbortIncompleteMultipartUpload sets the AbortIncompleteMultipartUpload field's value.
- func (s *LifecycleRule) SetAbortIncompleteMultipartUpload(v *AbortIncompleteMultipartUpload) *LifecycleRule {
- s.AbortIncompleteMultipartUpload = v
- return s
- }
- // SetExpiration sets the Expiration field's value.
- func (s *LifecycleRule) SetExpiration(v *LifecycleExpiration) *LifecycleRule {
- s.Expiration = v
- return s
- }
- // SetFilter sets the Filter field's value.
- func (s *LifecycleRule) SetFilter(v *LifecycleRuleFilter) *LifecycleRule {
- s.Filter = v
- return s
- }
- // SetID sets the ID field's value.
- func (s *LifecycleRule) SetID(v string) *LifecycleRule {
- s.ID = &v
- return s
- }
- // SetNoncurrentVersionExpiration sets the NoncurrentVersionExpiration field's value.
- func (s *LifecycleRule) SetNoncurrentVersionExpiration(v *NoncurrentVersionExpiration) *LifecycleRule {
- s.NoncurrentVersionExpiration = v
- return s
- }
- // SetNoncurrentVersionTransitions sets the NoncurrentVersionTransitions field's value.
- func (s *LifecycleRule) SetNoncurrentVersionTransitions(v []*NoncurrentVersionTransition) *LifecycleRule {
- s.NoncurrentVersionTransitions = v
- return s
- }
- // SetPrefix sets the Prefix field's value.
- func (s *LifecycleRule) SetPrefix(v string) *LifecycleRule {
- s.Prefix = &v
- return s
- }
- // SetStatus sets the Status field's value.
- func (s *LifecycleRule) SetStatus(v string) *LifecycleRule {
- s.Status = &v
- return s
- }
- // SetTransitions sets the Transitions field's value.
- func (s *LifecycleRule) SetTransitions(v []*Transition) *LifecycleRule {
- s.Transitions = v
- return s
- }
- // This is used in a Lifecycle Rule Filter to apply a logical AND to two or
- // more predicates. The Lifecycle Rule will apply to any object matching all
- // of the predicates configured inside the And operator.
- type LifecycleRuleAndOperator struct {
- _ struct{} `type:"structure"`
- // Minimum object size to which the rule applies.
- ObjectSizeGreaterThan *int64 `type:"long"`
- // Maximum object size to which the rule applies.
- ObjectSizeLessThan *int64 `type:"long"`
- // Prefix identifying one or more objects to which the rule applies.
- Prefix *string `type:"string"`
- // All of these tags must exist in the object's tag set in order for the rule
- // to apply.
- Tags []*Tag `locationName:"Tag" locationNameList:"Tag" type:"list" flattened:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s LifecycleRuleAndOperator) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s LifecycleRuleAndOperator) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *LifecycleRuleAndOperator) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "LifecycleRuleAndOperator"}
- 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
- }
- // SetObjectSizeGreaterThan sets the ObjectSizeGreaterThan field's value.
- func (s *LifecycleRuleAndOperator) SetObjectSizeGreaterThan(v int64) *LifecycleRuleAndOperator {
- s.ObjectSizeGreaterThan = &v
- return s
- }
- // SetObjectSizeLessThan sets the ObjectSizeLessThan field's value.
- func (s *LifecycleRuleAndOperator) SetObjectSizeLessThan(v int64) *LifecycleRuleAndOperator {
- s.ObjectSizeLessThan = &v
- return s
- }
- // SetPrefix sets the Prefix field's value.
- func (s *LifecycleRuleAndOperator) SetPrefix(v string) *LifecycleRuleAndOperator {
- s.Prefix = &v
- return s
- }
- // SetTags sets the Tags field's value.
- func (s *LifecycleRuleAndOperator) SetTags(v []*Tag) *LifecycleRuleAndOperator {
- s.Tags = v
- return s
- }
- // The Filter is used to identify objects that a Lifecycle Rule applies to.
- // A Filter must have exactly one of Prefix, Tag, or And specified.
- type LifecycleRuleFilter struct {
- _ struct{} `type:"structure"`
- // This is used in a Lifecycle Rule Filter to apply a logical AND to two or
- // more predicates. The Lifecycle Rule will apply to any object matching all
- // of the predicates configured inside the And operator.
- And *LifecycleRuleAndOperator `type:"structure"`
- // Minimum object size to which the rule applies.
- ObjectSizeGreaterThan *int64 `type:"long"`
- // Maximum object size to which the rule applies.
- ObjectSizeLessThan *int64 `type:"long"`
- // Prefix identifying one or more objects to which the rule applies.
- //
- // Replacement must be made for object keys containing special characters (such
- // as carriage returns) when using XML requests. For more information, see XML
- // related object key constraints (https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html#object-key-xml-related-constraints).
- Prefix *string `type:"string"`
- // This tag must exist in the object's tag set in order for the rule to apply.
- Tag *Tag `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s LifecycleRuleFilter) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s LifecycleRuleFilter) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *LifecycleRuleFilter) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "LifecycleRuleFilter"}
- if s.And != nil {
- if err := s.And.Validate(); err != nil {
- invalidParams.AddNested("And", err.(request.ErrInvalidParams))
- }
- }
- if s.Tag != nil {
- if err := s.Tag.Validate(); err != nil {
- invalidParams.AddNested("Tag", err.(request.ErrInvalidParams))
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetAnd sets the And field's value.
- func (s *LifecycleRuleFilter) SetAnd(v *LifecycleRuleAndOperator) *LifecycleRuleFilter {
- s.And = v
- return s
- }
- // SetObjectSizeGreaterThan sets the ObjectSizeGreaterThan field's value.
- func (s *LifecycleRuleFilter) SetObjectSizeGreaterThan(v int64) *LifecycleRuleFilter {
- s.ObjectSizeGreaterThan = &v
- return s
- }
- // SetObjectSizeLessThan sets the ObjectSizeLessThan field's value.
- func (s *LifecycleRuleFilter) SetObjectSizeLessThan(v int64) *LifecycleRuleFilter {
- s.ObjectSizeLessThan = &v
- return s
- }
- // SetPrefix sets the Prefix field's value.
- func (s *LifecycleRuleFilter) SetPrefix(v string) *LifecycleRuleFilter {
- s.Prefix = &v
- return s
- }
- // SetTag sets the Tag field's value.
- func (s *LifecycleRuleFilter) SetTag(v *Tag) *LifecycleRuleFilter {
- s.Tag = v
- return s
- }
- type ListBucketAnalyticsConfigurationsInput struct {
- _ struct{} `locationName:"ListBucketAnalyticsConfigurationsRequest" type:"structure"`
- // The name of the bucket from which analytics configurations are retrieved.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The ContinuationToken that represents a placeholder from where this request
- // should begin.
- ContinuationToken *string `location:"querystring" locationName:"continuation-token" type:"string"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ListBucketAnalyticsConfigurationsInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ListBucketAnalyticsConfigurationsInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *ListBucketAnalyticsConfigurationsInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "ListBucketAnalyticsConfigurationsInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *ListBucketAnalyticsConfigurationsInput) SetBucket(v string) *ListBucketAnalyticsConfigurationsInput {
- s.Bucket = &v
- return s
- }
- func (s *ListBucketAnalyticsConfigurationsInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetContinuationToken sets the ContinuationToken field's value.
- func (s *ListBucketAnalyticsConfigurationsInput) SetContinuationToken(v string) *ListBucketAnalyticsConfigurationsInput {
- s.ContinuationToken = &v
- return s
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *ListBucketAnalyticsConfigurationsInput) SetExpectedBucketOwner(v string) *ListBucketAnalyticsConfigurationsInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- func (s *ListBucketAnalyticsConfigurationsInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *ListBucketAnalyticsConfigurationsInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s ListBucketAnalyticsConfigurationsInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type ListBucketAnalyticsConfigurationsOutput struct {
- _ struct{} `type:"structure"`
- // The list of analytics configurations for a bucket.
- AnalyticsConfigurationList []*AnalyticsConfiguration `locationName:"AnalyticsConfiguration" type:"list" flattened:"true"`
- // The marker that is used as a starting point for this analytics configuration
- // list response. This value is present if it was sent in the request.
- ContinuationToken *string `type:"string"`
- // Indicates whether the returned list of analytics configurations is complete.
- // A value of true indicates that the list is not complete and the NextContinuationToken
- // will be provided for a subsequent request.
- IsTruncated *bool `type:"boolean"`
- // NextContinuationToken is sent when isTruncated is true, which indicates that
- // there are more analytics configurations to list. The next request must include
- // this NextContinuationToken. The token is obfuscated and is not a usable value.
- NextContinuationToken *string `type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ListBucketAnalyticsConfigurationsOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ListBucketAnalyticsConfigurationsOutput) GoString() string {
- return s.String()
- }
- // SetAnalyticsConfigurationList sets the AnalyticsConfigurationList field's value.
- func (s *ListBucketAnalyticsConfigurationsOutput) SetAnalyticsConfigurationList(v []*AnalyticsConfiguration) *ListBucketAnalyticsConfigurationsOutput {
- s.AnalyticsConfigurationList = v
- return s
- }
- // SetContinuationToken sets the ContinuationToken field's value.
- func (s *ListBucketAnalyticsConfigurationsOutput) SetContinuationToken(v string) *ListBucketAnalyticsConfigurationsOutput {
- s.ContinuationToken = &v
- return s
- }
- // SetIsTruncated sets the IsTruncated field's value.
- func (s *ListBucketAnalyticsConfigurationsOutput) SetIsTruncated(v bool) *ListBucketAnalyticsConfigurationsOutput {
- s.IsTruncated = &v
- return s
- }
- // SetNextContinuationToken sets the NextContinuationToken field's value.
- func (s *ListBucketAnalyticsConfigurationsOutput) SetNextContinuationToken(v string) *ListBucketAnalyticsConfigurationsOutput {
- s.NextContinuationToken = &v
- return s
- }
- type ListBucketIntelligentTieringConfigurationsInput struct {
- _ struct{} `locationName:"ListBucketIntelligentTieringConfigurationsRequest" type:"structure"`
- // The name of the Amazon S3 bucket whose configuration you want to modify or
- // retrieve.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The ContinuationToken that represents a placeholder from where this request
- // should begin.
- ContinuationToken *string `location:"querystring" locationName:"continuation-token" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ListBucketIntelligentTieringConfigurationsInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ListBucketIntelligentTieringConfigurationsInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *ListBucketIntelligentTieringConfigurationsInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "ListBucketIntelligentTieringConfigurationsInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *ListBucketIntelligentTieringConfigurationsInput) SetBucket(v string) *ListBucketIntelligentTieringConfigurationsInput {
- s.Bucket = &v
- return s
- }
- func (s *ListBucketIntelligentTieringConfigurationsInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetContinuationToken sets the ContinuationToken field's value.
- func (s *ListBucketIntelligentTieringConfigurationsInput) SetContinuationToken(v string) *ListBucketIntelligentTieringConfigurationsInput {
- s.ContinuationToken = &v
- return s
- }
- func (s *ListBucketIntelligentTieringConfigurationsInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *ListBucketIntelligentTieringConfigurationsInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s ListBucketIntelligentTieringConfigurationsInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type ListBucketIntelligentTieringConfigurationsOutput struct {
- _ struct{} `type:"structure"`
- // The ContinuationToken that represents a placeholder from where this request
- // should begin.
- ContinuationToken *string `type:"string"`
- // The list of S3 Intelligent-Tiering configurations for a bucket.
- IntelligentTieringConfigurationList []*IntelligentTieringConfiguration `locationName:"IntelligentTieringConfiguration" type:"list" flattened:"true"`
- // Indicates whether the returned list of analytics configurations is complete.
- // A value of true indicates that the list is not complete and the NextContinuationToken
- // will be provided for a subsequent request.
- IsTruncated *bool `type:"boolean"`
- // The marker used to continue this inventory configuration listing. Use the
- // NextContinuationToken from this response to continue the listing in a subsequent
- // request. The continuation token is an opaque value that Amazon S3 understands.
- NextContinuationToken *string `type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ListBucketIntelligentTieringConfigurationsOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ListBucketIntelligentTieringConfigurationsOutput) GoString() string {
- return s.String()
- }
- // SetContinuationToken sets the ContinuationToken field's value.
- func (s *ListBucketIntelligentTieringConfigurationsOutput) SetContinuationToken(v string) *ListBucketIntelligentTieringConfigurationsOutput {
- s.ContinuationToken = &v
- return s
- }
- // SetIntelligentTieringConfigurationList sets the IntelligentTieringConfigurationList field's value.
- func (s *ListBucketIntelligentTieringConfigurationsOutput) SetIntelligentTieringConfigurationList(v []*IntelligentTieringConfiguration) *ListBucketIntelligentTieringConfigurationsOutput {
- s.IntelligentTieringConfigurationList = v
- return s
- }
- // SetIsTruncated sets the IsTruncated field's value.
- func (s *ListBucketIntelligentTieringConfigurationsOutput) SetIsTruncated(v bool) *ListBucketIntelligentTieringConfigurationsOutput {
- s.IsTruncated = &v
- return s
- }
- // SetNextContinuationToken sets the NextContinuationToken field's value.
- func (s *ListBucketIntelligentTieringConfigurationsOutput) SetNextContinuationToken(v string) *ListBucketIntelligentTieringConfigurationsOutput {
- s.NextContinuationToken = &v
- return s
- }
- type ListBucketInventoryConfigurationsInput struct {
- _ struct{} `locationName:"ListBucketInventoryConfigurationsRequest" type:"structure"`
- // The name of the bucket containing the inventory configurations to retrieve.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The marker used to continue an inventory configuration listing that has been
- // truncated. Use the NextContinuationToken from a previously truncated list
- // response to continue the listing. The continuation token is an opaque value
- // that Amazon S3 understands.
- ContinuationToken *string `location:"querystring" locationName:"continuation-token" type:"string"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ListBucketInventoryConfigurationsInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ListBucketInventoryConfigurationsInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *ListBucketInventoryConfigurationsInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "ListBucketInventoryConfigurationsInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *ListBucketInventoryConfigurationsInput) SetBucket(v string) *ListBucketInventoryConfigurationsInput {
- s.Bucket = &v
- return s
- }
- func (s *ListBucketInventoryConfigurationsInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetContinuationToken sets the ContinuationToken field's value.
- func (s *ListBucketInventoryConfigurationsInput) SetContinuationToken(v string) *ListBucketInventoryConfigurationsInput {
- s.ContinuationToken = &v
- return s
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *ListBucketInventoryConfigurationsInput) SetExpectedBucketOwner(v string) *ListBucketInventoryConfigurationsInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- func (s *ListBucketInventoryConfigurationsInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *ListBucketInventoryConfigurationsInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s ListBucketInventoryConfigurationsInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type ListBucketInventoryConfigurationsOutput struct {
- _ struct{} `type:"structure"`
- // If sent in the request, the marker that is used as a starting point for this
- // inventory configuration list response.
- ContinuationToken *string `type:"string"`
- // The list of inventory configurations for a bucket.
- InventoryConfigurationList []*InventoryConfiguration `locationName:"InventoryConfiguration" type:"list" flattened:"true"`
- // Tells whether the returned list of inventory configurations is complete.
- // A value of true indicates that the list is not complete and the NextContinuationToken
- // is provided for a subsequent request.
- IsTruncated *bool `type:"boolean"`
- // The marker used to continue this inventory configuration listing. Use the
- // NextContinuationToken from this response to continue the listing in a subsequent
- // request. The continuation token is an opaque value that Amazon S3 understands.
- NextContinuationToken *string `type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ListBucketInventoryConfigurationsOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ListBucketInventoryConfigurationsOutput) GoString() string {
- return s.String()
- }
- // SetContinuationToken sets the ContinuationToken field's value.
- func (s *ListBucketInventoryConfigurationsOutput) SetContinuationToken(v string) *ListBucketInventoryConfigurationsOutput {
- s.ContinuationToken = &v
- return s
- }
- // SetInventoryConfigurationList sets the InventoryConfigurationList field's value.
- func (s *ListBucketInventoryConfigurationsOutput) SetInventoryConfigurationList(v []*InventoryConfiguration) *ListBucketInventoryConfigurationsOutput {
- s.InventoryConfigurationList = v
- return s
- }
- // SetIsTruncated sets the IsTruncated field's value.
- func (s *ListBucketInventoryConfigurationsOutput) SetIsTruncated(v bool) *ListBucketInventoryConfigurationsOutput {
- s.IsTruncated = &v
- return s
- }
- // SetNextContinuationToken sets the NextContinuationToken field's value.
- func (s *ListBucketInventoryConfigurationsOutput) SetNextContinuationToken(v string) *ListBucketInventoryConfigurationsOutput {
- s.NextContinuationToken = &v
- return s
- }
- type ListBucketMetricsConfigurationsInput struct {
- _ struct{} `locationName:"ListBucketMetricsConfigurationsRequest" type:"structure"`
- // The name of the bucket containing the metrics configurations to retrieve.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The marker that is used to continue a metrics configuration listing that
- // has been truncated. Use the NextContinuationToken from a previously truncated
- // list response to continue the listing. The continuation token is an opaque
- // value that Amazon S3 understands.
- ContinuationToken *string `location:"querystring" locationName:"continuation-token" type:"string"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ListBucketMetricsConfigurationsInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ListBucketMetricsConfigurationsInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *ListBucketMetricsConfigurationsInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "ListBucketMetricsConfigurationsInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *ListBucketMetricsConfigurationsInput) SetBucket(v string) *ListBucketMetricsConfigurationsInput {
- s.Bucket = &v
- return s
- }
- func (s *ListBucketMetricsConfigurationsInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetContinuationToken sets the ContinuationToken field's value.
- func (s *ListBucketMetricsConfigurationsInput) SetContinuationToken(v string) *ListBucketMetricsConfigurationsInput {
- s.ContinuationToken = &v
- return s
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *ListBucketMetricsConfigurationsInput) SetExpectedBucketOwner(v string) *ListBucketMetricsConfigurationsInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- func (s *ListBucketMetricsConfigurationsInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *ListBucketMetricsConfigurationsInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s ListBucketMetricsConfigurationsInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type ListBucketMetricsConfigurationsOutput struct {
- _ struct{} `type:"structure"`
- // The marker that is used as a starting point for this metrics configuration
- // list response. This value is present if it was sent in the request.
- ContinuationToken *string `type:"string"`
- // Indicates whether the returned list of metrics configurations is complete.
- // A value of true indicates that the list is not complete and the NextContinuationToken
- // will be provided for a subsequent request.
- IsTruncated *bool `type:"boolean"`
- // The list of metrics configurations for a bucket.
- MetricsConfigurationList []*MetricsConfiguration `locationName:"MetricsConfiguration" type:"list" flattened:"true"`
- // The marker used to continue a metrics configuration listing that has been
- // truncated. Use the NextContinuationToken from a previously truncated list
- // response to continue the listing. The continuation token is an opaque value
- // that Amazon S3 understands.
- NextContinuationToken *string `type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ListBucketMetricsConfigurationsOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ListBucketMetricsConfigurationsOutput) GoString() string {
- return s.String()
- }
- // SetContinuationToken sets the ContinuationToken field's value.
- func (s *ListBucketMetricsConfigurationsOutput) SetContinuationToken(v string) *ListBucketMetricsConfigurationsOutput {
- s.ContinuationToken = &v
- return s
- }
- // SetIsTruncated sets the IsTruncated field's value.
- func (s *ListBucketMetricsConfigurationsOutput) SetIsTruncated(v bool) *ListBucketMetricsConfigurationsOutput {
- s.IsTruncated = &v
- return s
- }
- // SetMetricsConfigurationList sets the MetricsConfigurationList field's value.
- func (s *ListBucketMetricsConfigurationsOutput) SetMetricsConfigurationList(v []*MetricsConfiguration) *ListBucketMetricsConfigurationsOutput {
- s.MetricsConfigurationList = v
- return s
- }
- // SetNextContinuationToken sets the NextContinuationToken field's value.
- func (s *ListBucketMetricsConfigurationsOutput) SetNextContinuationToken(v string) *ListBucketMetricsConfigurationsOutput {
- s.NextContinuationToken = &v
- return s
- }
- type ListBucketsInput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ListBucketsInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ListBucketsInput) GoString() string {
- return s.String()
- }
- type ListBucketsOutput struct {
- _ struct{} `type:"structure"`
- // The list of buckets owned by the requester.
- Buckets []*Bucket `locationNameList:"Bucket" type:"list"`
- // The owner of the buckets listed.
- Owner *Owner `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ListBucketsOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ListBucketsOutput) GoString() string {
- return s.String()
- }
- // SetBuckets sets the Buckets field's value.
- func (s *ListBucketsOutput) SetBuckets(v []*Bucket) *ListBucketsOutput {
- s.Buckets = v
- return s
- }
- // SetOwner sets the Owner field's value.
- func (s *ListBucketsOutput) SetOwner(v *Owner) *ListBucketsOutput {
- s.Owner = v
- return s
- }
- type ListMultipartUploadsInput struct {
- _ struct{} `locationName:"ListMultipartUploadsRequest" type:"structure"`
- // The name of the bucket to which the multipart upload was initiated.
- //
- // When using this action with an access point, you must direct requests to
- // the access point hostname. The access point hostname takes the form AccessPointName-AccountId.s3-accesspoint.Region.amazonaws.com.
- // When using this action with an access point through the Amazon Web Services
- // SDKs, you provide the access point ARN in place of the bucket name. For more
- // information about access point ARNs, see Using access points (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html)
- // in the Amazon S3 User Guide.
- //
- // When using this action with Amazon S3 on Outposts, you must direct requests
- // to the S3 on Outposts hostname. The S3 on Outposts hostname takes the form
- // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When
- // using this action with S3 on Outposts through the Amazon Web Services SDKs,
- // you provide the Outposts bucket ARN in place of the bucket name. For more
- // information about S3 on Outposts ARNs, see Using Amazon S3 on Outposts (https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html)
- // in the Amazon S3 User Guide.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // Character you use to group keys.
- //
- // All keys that contain the same string between the prefix, if specified, and
- // the first occurrence of the delimiter after the prefix are grouped under
- // a single result element, CommonPrefixes. If you don't specify the prefix
- // parameter, then the substring starts at the beginning of the key. The keys
- // that are grouped under CommonPrefixes result element are not returned elsewhere
- // in the response.
- Delimiter *string `location:"querystring" locationName:"delimiter" type:"string"`
- // Requests Amazon S3 to encode the object keys in the response and specifies
- // the encoding method to use. An object key may contain any Unicode character;
- // however, XML 1.0 parser cannot parse some characters, such as characters
- // with an ASCII value from 0 to 10. For characters that are not supported in
- // XML 1.0, you can add this parameter to request that Amazon S3 encode the
- // keys in the response.
- EncodingType *string `location:"querystring" locationName:"encoding-type" type:"string" enum:"EncodingType"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // Together with upload-id-marker, this parameter specifies the multipart upload
- // after which listing should begin.
- //
- // If upload-id-marker is not specified, only the keys lexicographically greater
- // than the specified key-marker will be included in the list.
- //
- // If upload-id-marker is specified, any multipart uploads for a key equal to
- // the key-marker might also be included, provided those multipart uploads have
- // upload IDs lexicographically greater than the specified upload-id-marker.
- KeyMarker *string `location:"querystring" locationName:"key-marker" type:"string"`
- // Sets the maximum number of multipart uploads, from 1 to 1,000, to return
- // in the response body. 1,000 is the maximum number of uploads that can be
- // returned in a response.
- MaxUploads *int64 `location:"querystring" locationName:"max-uploads" type:"integer"`
- // Lists in-progress uploads only for those keys that begin with the specified
- // prefix. You can use prefixes to separate a bucket into different grouping
- // of keys. (You can think of using prefix to make groups in the same way you'd
- // use a folder in a file system.)
- Prefix *string `location:"querystring" locationName:"prefix" type:"string"`
- // Together with key-marker, specifies the multipart upload after which listing
- // should begin. If key-marker is not specified, the upload-id-marker parameter
- // is ignored. Otherwise, any multipart uploads for a key equal to the key-marker
- // might be included in the list only if they have an upload ID lexicographically
- // greater than the specified upload-id-marker.
- UploadIdMarker *string `location:"querystring" locationName:"upload-id-marker" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ListMultipartUploadsInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ListMultipartUploadsInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *ListMultipartUploadsInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "ListMultipartUploadsInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *ListMultipartUploadsInput) SetBucket(v string) *ListMultipartUploadsInput {
- s.Bucket = &v
- return s
- }
- func (s *ListMultipartUploadsInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetDelimiter sets the Delimiter field's value.
- func (s *ListMultipartUploadsInput) SetDelimiter(v string) *ListMultipartUploadsInput {
- s.Delimiter = &v
- return s
- }
- // SetEncodingType sets the EncodingType field's value.
- func (s *ListMultipartUploadsInput) SetEncodingType(v string) *ListMultipartUploadsInput {
- s.EncodingType = &v
- return s
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *ListMultipartUploadsInput) SetExpectedBucketOwner(v string) *ListMultipartUploadsInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetKeyMarker sets the KeyMarker field's value.
- func (s *ListMultipartUploadsInput) SetKeyMarker(v string) *ListMultipartUploadsInput {
- s.KeyMarker = &v
- return s
- }
- // SetMaxUploads sets the MaxUploads field's value.
- func (s *ListMultipartUploadsInput) SetMaxUploads(v int64) *ListMultipartUploadsInput {
- s.MaxUploads = &v
- return s
- }
- // SetPrefix sets the Prefix field's value.
- func (s *ListMultipartUploadsInput) SetPrefix(v string) *ListMultipartUploadsInput {
- s.Prefix = &v
- return s
- }
- // SetUploadIdMarker sets the UploadIdMarker field's value.
- func (s *ListMultipartUploadsInput) SetUploadIdMarker(v string) *ListMultipartUploadsInput {
- s.UploadIdMarker = &v
- return s
- }
- func (s *ListMultipartUploadsInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *ListMultipartUploadsInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s ListMultipartUploadsInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type ListMultipartUploadsOutput struct {
- _ struct{} `type:"structure"`
- // The name of the bucket to which the multipart upload was initiated. Does
- // not return the access point ARN or access point alias if used.
- Bucket *string `type:"string"`
- // If you specify a delimiter in the request, then the result returns each distinct
- // key prefix containing the delimiter in a CommonPrefixes element. The distinct
- // key prefixes are returned in the Prefix child element.
- CommonPrefixes []*CommonPrefix `type:"list" flattened:"true"`
- // Contains the delimiter you specified in the request. If you don't specify
- // a delimiter in your request, this element is absent from the response.
- Delimiter *string `type:"string"`
- // Encoding type used by Amazon S3 to encode object keys in the response.
- //
- // If you specify encoding-type request parameter, Amazon S3 includes this element
- // in the response, and returns encoded key name values in the following response
- // elements:
- //
- // Delimiter, KeyMarker, Prefix, NextKeyMarker, Key.
- EncodingType *string `type:"string" enum:"EncodingType"`
- // Indicates whether the returned list of multipart uploads is truncated. A
- // value of true indicates that the list was truncated. The list can be truncated
- // if the number of multipart uploads exceeds the limit allowed or specified
- // by max uploads.
- IsTruncated *bool `type:"boolean"`
- // The key at or after which the listing began.
- KeyMarker *string `type:"string"`
- // Maximum number of multipart uploads that could have been included in the
- // response.
- MaxUploads *int64 `type:"integer"`
- // When a list is truncated, this element specifies the value that should be
- // used for the key-marker request parameter in a subsequent request.
- NextKeyMarker *string `type:"string"`
- // When a list is truncated, this element specifies the value that should be
- // used for the upload-id-marker request parameter in a subsequent request.
- NextUploadIdMarker *string `type:"string"`
- // When a prefix is provided in the request, this field contains the specified
- // prefix. The result contains only keys starting with the specified prefix.
- Prefix *string `type:"string"`
- // Upload ID after which listing began.
- UploadIdMarker *string `type:"string"`
- // Container for elements related to a particular multipart upload. A response
- // can contain zero or more Upload elements.
- Uploads []*MultipartUpload `locationName:"Upload" type:"list" flattened:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ListMultipartUploadsOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ListMultipartUploadsOutput) GoString() string {
- return s.String()
- }
- // SetBucket sets the Bucket field's value.
- func (s *ListMultipartUploadsOutput) SetBucket(v string) *ListMultipartUploadsOutput {
- s.Bucket = &v
- return s
- }
- func (s *ListMultipartUploadsOutput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetCommonPrefixes sets the CommonPrefixes field's value.
- func (s *ListMultipartUploadsOutput) SetCommonPrefixes(v []*CommonPrefix) *ListMultipartUploadsOutput {
- s.CommonPrefixes = v
- return s
- }
- // SetDelimiter sets the Delimiter field's value.
- func (s *ListMultipartUploadsOutput) SetDelimiter(v string) *ListMultipartUploadsOutput {
- s.Delimiter = &v
- return s
- }
- // SetEncodingType sets the EncodingType field's value.
- func (s *ListMultipartUploadsOutput) SetEncodingType(v string) *ListMultipartUploadsOutput {
- s.EncodingType = &v
- return s
- }
- // SetIsTruncated sets the IsTruncated field's value.
- func (s *ListMultipartUploadsOutput) SetIsTruncated(v bool) *ListMultipartUploadsOutput {
- s.IsTruncated = &v
- return s
- }
- // SetKeyMarker sets the KeyMarker field's value.
- func (s *ListMultipartUploadsOutput) SetKeyMarker(v string) *ListMultipartUploadsOutput {
- s.KeyMarker = &v
- return s
- }
- // SetMaxUploads sets the MaxUploads field's value.
- func (s *ListMultipartUploadsOutput) SetMaxUploads(v int64) *ListMultipartUploadsOutput {
- s.MaxUploads = &v
- return s
- }
- // SetNextKeyMarker sets the NextKeyMarker field's value.
- func (s *ListMultipartUploadsOutput) SetNextKeyMarker(v string) *ListMultipartUploadsOutput {
- s.NextKeyMarker = &v
- return s
- }
- // SetNextUploadIdMarker sets the NextUploadIdMarker field's value.
- func (s *ListMultipartUploadsOutput) SetNextUploadIdMarker(v string) *ListMultipartUploadsOutput {
- s.NextUploadIdMarker = &v
- return s
- }
- // SetPrefix sets the Prefix field's value.
- func (s *ListMultipartUploadsOutput) SetPrefix(v string) *ListMultipartUploadsOutput {
- s.Prefix = &v
- return s
- }
- // SetUploadIdMarker sets the UploadIdMarker field's value.
- func (s *ListMultipartUploadsOutput) SetUploadIdMarker(v string) *ListMultipartUploadsOutput {
- s.UploadIdMarker = &v
- return s
- }
- // SetUploads sets the Uploads field's value.
- func (s *ListMultipartUploadsOutput) SetUploads(v []*MultipartUpload) *ListMultipartUploadsOutput {
- s.Uploads = v
- return s
- }
- type ListObjectVersionsInput struct {
- _ struct{} `locationName:"ListObjectVersionsRequest" type:"structure"`
- // The bucket name that contains the objects.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // A delimiter is a character that you specify to group keys. All keys that
- // contain the same string between the prefix and the first occurrence of the
- // delimiter are grouped under a single result element in CommonPrefixes. These
- // groups are counted as one result against the max-keys limitation. These keys
- // are not returned elsewhere in the response.
- Delimiter *string `location:"querystring" locationName:"delimiter" type:"string"`
- // Requests Amazon S3 to encode the object keys in the response and specifies
- // the encoding method to use. An object key may contain any Unicode character;
- // however, XML 1.0 parser cannot parse some characters, such as characters
- // with an ASCII value from 0 to 10. For characters that are not supported in
- // XML 1.0, you can add this parameter to request that Amazon S3 encode the
- // keys in the response.
- EncodingType *string `location:"querystring" locationName:"encoding-type" type:"string" enum:"EncodingType"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // Specifies the key to start with when listing objects in a bucket.
- KeyMarker *string `location:"querystring" locationName:"key-marker" type:"string"`
- // Sets the maximum number of keys returned in the response. By default the
- // action returns up to 1,000 key names. The response might contain fewer keys
- // but will never contain more. If additional keys satisfy the search criteria,
- // but were not returned because max-keys was exceeded, the response contains
- // <isTruncated>true</isTruncated>. To return the additional keys, see key-marker
- // and version-id-marker.
- MaxKeys *int64 `location:"querystring" locationName:"max-keys" type:"integer"`
- // Use this parameter to select only those keys that begin with the specified
- // prefix. You can use prefixes to separate a bucket into different groupings
- // of keys. (You can think of using prefix to make groups in the same way you'd
- // use a folder in a file system.) You can use prefix with delimiter to roll
- // up numerous objects into a single result under CommonPrefixes.
- Prefix *string `location:"querystring" locationName:"prefix" type:"string"`
- // Specifies the object version you want to start listing from.
- VersionIdMarker *string `location:"querystring" locationName:"version-id-marker" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ListObjectVersionsInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ListObjectVersionsInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *ListObjectVersionsInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "ListObjectVersionsInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *ListObjectVersionsInput) SetBucket(v string) *ListObjectVersionsInput {
- s.Bucket = &v
- return s
- }
- func (s *ListObjectVersionsInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetDelimiter sets the Delimiter field's value.
- func (s *ListObjectVersionsInput) SetDelimiter(v string) *ListObjectVersionsInput {
- s.Delimiter = &v
- return s
- }
- // SetEncodingType sets the EncodingType field's value.
- func (s *ListObjectVersionsInput) SetEncodingType(v string) *ListObjectVersionsInput {
- s.EncodingType = &v
- return s
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *ListObjectVersionsInput) SetExpectedBucketOwner(v string) *ListObjectVersionsInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetKeyMarker sets the KeyMarker field's value.
- func (s *ListObjectVersionsInput) SetKeyMarker(v string) *ListObjectVersionsInput {
- s.KeyMarker = &v
- return s
- }
- // SetMaxKeys sets the MaxKeys field's value.
- func (s *ListObjectVersionsInput) SetMaxKeys(v int64) *ListObjectVersionsInput {
- s.MaxKeys = &v
- return s
- }
- // SetPrefix sets the Prefix field's value.
- func (s *ListObjectVersionsInput) SetPrefix(v string) *ListObjectVersionsInput {
- s.Prefix = &v
- return s
- }
- // SetVersionIdMarker sets the VersionIdMarker field's value.
- func (s *ListObjectVersionsInput) SetVersionIdMarker(v string) *ListObjectVersionsInput {
- s.VersionIdMarker = &v
- return s
- }
- func (s *ListObjectVersionsInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *ListObjectVersionsInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s ListObjectVersionsInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type ListObjectVersionsOutput struct {
- _ struct{} `type:"structure"`
- // All of the keys rolled up into a common prefix count as a single return when
- // calculating the number of returns.
- CommonPrefixes []*CommonPrefix `type:"list" flattened:"true"`
- // Container for an object that is a delete marker.
- DeleteMarkers []*DeleteMarkerEntry `locationName:"DeleteMarker" type:"list" flattened:"true"`
- // The delimiter grouping the included keys. A delimiter is a character that
- // you specify to group keys. All keys that contain the same string between
- // the prefix and the first occurrence of the delimiter are grouped under a
- // single result element in CommonPrefixes. These groups are counted as one
- // result against the max-keys limitation. These keys are not returned elsewhere
- // in the response.
- Delimiter *string `type:"string"`
- // Encoding type used by Amazon S3 to encode object key names in the XML response.
- //
- // If you specify encoding-type request parameter, Amazon S3 includes this element
- // in the response, and returns encoded key name values in the following response
- // elements:
- //
- // KeyMarker, NextKeyMarker, Prefix, Key, and Delimiter.
- EncodingType *string `type:"string" enum:"EncodingType"`
- // A flag that indicates whether Amazon S3 returned all of the results that
- // satisfied the search criteria. If your results were truncated, you can make
- // a follow-up paginated request using the NextKeyMarker and NextVersionIdMarker
- // response parameters as a starting place in another request to return the
- // rest of the results.
- IsTruncated *bool `type:"boolean"`
- // Marks the last key returned in a truncated response.
- KeyMarker *string `type:"string"`
- // Specifies the maximum number of objects to return.
- MaxKeys *int64 `type:"integer"`
- // The bucket name.
- Name *string `type:"string"`
- // When the number of responses exceeds the value of MaxKeys, NextKeyMarker
- // specifies the first key not returned that satisfies the search criteria.
- // Use this value for the key-marker request parameter in a subsequent request.
- NextKeyMarker *string `type:"string"`
- // When the number of responses exceeds the value of MaxKeys, NextVersionIdMarker
- // specifies the first object version not returned that satisfies the search
- // criteria. Use this value for the version-id-marker request parameter in a
- // subsequent request.
- NextVersionIdMarker *string `type:"string"`
- // Selects objects that start with the value supplied by this parameter.
- Prefix *string `type:"string"`
- // Marks the last version of the key returned in a truncated response.
- VersionIdMarker *string `type:"string"`
- // Container for version information.
- Versions []*ObjectVersion `locationName:"Version" type:"list" flattened:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ListObjectVersionsOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ListObjectVersionsOutput) GoString() string {
- return s.String()
- }
- // SetCommonPrefixes sets the CommonPrefixes field's value.
- func (s *ListObjectVersionsOutput) SetCommonPrefixes(v []*CommonPrefix) *ListObjectVersionsOutput {
- s.CommonPrefixes = v
- return s
- }
- // SetDeleteMarkers sets the DeleteMarkers field's value.
- func (s *ListObjectVersionsOutput) SetDeleteMarkers(v []*DeleteMarkerEntry) *ListObjectVersionsOutput {
- s.DeleteMarkers = v
- return s
- }
- // SetDelimiter sets the Delimiter field's value.
- func (s *ListObjectVersionsOutput) SetDelimiter(v string) *ListObjectVersionsOutput {
- s.Delimiter = &v
- return s
- }
- // SetEncodingType sets the EncodingType field's value.
- func (s *ListObjectVersionsOutput) SetEncodingType(v string) *ListObjectVersionsOutput {
- s.EncodingType = &v
- return s
- }
- // SetIsTruncated sets the IsTruncated field's value.
- func (s *ListObjectVersionsOutput) SetIsTruncated(v bool) *ListObjectVersionsOutput {
- s.IsTruncated = &v
- return s
- }
- // SetKeyMarker sets the KeyMarker field's value.
- func (s *ListObjectVersionsOutput) SetKeyMarker(v string) *ListObjectVersionsOutput {
- s.KeyMarker = &v
- return s
- }
- // SetMaxKeys sets the MaxKeys field's value.
- func (s *ListObjectVersionsOutput) SetMaxKeys(v int64) *ListObjectVersionsOutput {
- s.MaxKeys = &v
- return s
- }
- // SetName sets the Name field's value.
- func (s *ListObjectVersionsOutput) SetName(v string) *ListObjectVersionsOutput {
- s.Name = &v
- return s
- }
- // SetNextKeyMarker sets the NextKeyMarker field's value.
- func (s *ListObjectVersionsOutput) SetNextKeyMarker(v string) *ListObjectVersionsOutput {
- s.NextKeyMarker = &v
- return s
- }
- // SetNextVersionIdMarker sets the NextVersionIdMarker field's value.
- func (s *ListObjectVersionsOutput) SetNextVersionIdMarker(v string) *ListObjectVersionsOutput {
- s.NextVersionIdMarker = &v
- return s
- }
- // SetPrefix sets the Prefix field's value.
- func (s *ListObjectVersionsOutput) SetPrefix(v string) *ListObjectVersionsOutput {
- s.Prefix = &v
- return s
- }
- // SetVersionIdMarker sets the VersionIdMarker field's value.
- func (s *ListObjectVersionsOutput) SetVersionIdMarker(v string) *ListObjectVersionsOutput {
- s.VersionIdMarker = &v
- return s
- }
- // SetVersions sets the Versions field's value.
- func (s *ListObjectVersionsOutput) SetVersions(v []*ObjectVersion) *ListObjectVersionsOutput {
- s.Versions = v
- return s
- }
- type ListObjectsInput struct {
- _ struct{} `locationName:"ListObjectsRequest" type:"structure"`
- // The name of the bucket containing the objects.
- //
- // When using this action with an access point, you must direct requests to
- // the access point hostname. The access point hostname takes the form AccessPointName-AccountId.s3-accesspoint.Region.amazonaws.com.
- // When using this action with an access point through the Amazon Web Services
- // SDKs, you provide the access point ARN in place of the bucket name. For more
- // information about access point ARNs, see Using access points (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html)
- // in the Amazon S3 User Guide.
- //
- // When using this action with Amazon S3 on Outposts, you must direct requests
- // to the S3 on Outposts hostname. The S3 on Outposts hostname takes the form
- // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When
- // using this action with S3 on Outposts through the Amazon Web Services SDKs,
- // you provide the Outposts bucket ARN in place of the bucket name. For more
- // information about S3 on Outposts ARNs, see Using Amazon S3 on Outposts (https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html)
- // in the Amazon S3 User Guide.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // A delimiter is a character you use to group keys.
- Delimiter *string `location:"querystring" locationName:"delimiter" type:"string"`
- // Requests Amazon S3 to encode the object keys in the response and specifies
- // the encoding method to use. An object key may contain any Unicode character;
- // however, XML 1.0 parser cannot parse some characters, such as characters
- // with an ASCII value from 0 to 10. For characters that are not supported in
- // XML 1.0, you can add this parameter to request that Amazon S3 encode the
- // keys in the response.
- EncodingType *string `location:"querystring" locationName:"encoding-type" type:"string" enum:"EncodingType"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // Marker is where you want Amazon S3 to start listing from. Amazon S3 starts
- // listing after this specified key. Marker can be any key in the bucket.
- Marker *string `location:"querystring" locationName:"marker" type:"string"`
- // Sets the maximum number of keys returned in the response. By default the
- // action returns up to 1,000 key names. The response might contain fewer keys
- // but will never contain more.
- MaxKeys *int64 `location:"querystring" locationName:"max-keys" type:"integer"`
- // Limits the response to keys that begin with the specified prefix.
- Prefix *string `location:"querystring" locationName:"prefix" type:"string"`
- // Confirms that the requester knows that she or he will be charged for the
- // list objects request. Bucket owners need not specify this parameter in their
- // requests.
- RequestPayer *string `location:"header" locationName:"x-amz-request-payer" type:"string" enum:"RequestPayer"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ListObjectsInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ListObjectsInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *ListObjectsInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "ListObjectsInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *ListObjectsInput) SetBucket(v string) *ListObjectsInput {
- s.Bucket = &v
- return s
- }
- func (s *ListObjectsInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetDelimiter sets the Delimiter field's value.
- func (s *ListObjectsInput) SetDelimiter(v string) *ListObjectsInput {
- s.Delimiter = &v
- return s
- }
- // SetEncodingType sets the EncodingType field's value.
- func (s *ListObjectsInput) SetEncodingType(v string) *ListObjectsInput {
- s.EncodingType = &v
- return s
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *ListObjectsInput) SetExpectedBucketOwner(v string) *ListObjectsInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetMarker sets the Marker field's value.
- func (s *ListObjectsInput) SetMarker(v string) *ListObjectsInput {
- s.Marker = &v
- return s
- }
- // SetMaxKeys sets the MaxKeys field's value.
- func (s *ListObjectsInput) SetMaxKeys(v int64) *ListObjectsInput {
- s.MaxKeys = &v
- return s
- }
- // SetPrefix sets the Prefix field's value.
- func (s *ListObjectsInput) SetPrefix(v string) *ListObjectsInput {
- s.Prefix = &v
- return s
- }
- // SetRequestPayer sets the RequestPayer field's value.
- func (s *ListObjectsInput) SetRequestPayer(v string) *ListObjectsInput {
- s.RequestPayer = &v
- return s
- }
- func (s *ListObjectsInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *ListObjectsInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s ListObjectsInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type ListObjectsOutput struct {
- _ struct{} `type:"structure"`
- // All of the keys (up to 1,000) rolled up in a common prefix count as a single
- // return when calculating the number of returns.
- //
- // A response can contain CommonPrefixes only if you specify a delimiter.
- //
- // CommonPrefixes contains all (if there are any) keys between Prefix and the
- // next occurrence of the string specified by the delimiter.
- //
- // CommonPrefixes lists keys that act like subdirectories in the directory specified
- // by Prefix.
- //
- // For example, if the prefix is notes/ and the delimiter is a slash (/) as
- // in notes/summer/july, the common prefix is notes/summer/. All of the keys
- // that roll up into a common prefix count as a single return when calculating
- // the number of returns.
- CommonPrefixes []*CommonPrefix `type:"list" flattened:"true"`
- // Metadata about each object returned.
- Contents []*Object `type:"list" flattened:"true"`
- // Causes keys that contain the same string between the prefix and the first
- // occurrence of the delimiter to be rolled up into a single result element
- // in the CommonPrefixes collection. These rolled-up keys are not returned elsewhere
- // in the response. Each rolled-up result counts as only one return against
- // the MaxKeys value.
- Delimiter *string `type:"string"`
- // Encoding type used by Amazon S3 to encode object keys in the response.
- EncodingType *string `type:"string" enum:"EncodingType"`
- // A flag that indicates whether Amazon S3 returned all of the results that
- // satisfied the search criteria.
- IsTruncated *bool `type:"boolean"`
- // Indicates where in the bucket listing begins. Marker is included in the response
- // if it was sent with the request.
- Marker *string `type:"string"`
- // The maximum number of keys returned in the response body.
- MaxKeys *int64 `type:"integer"`
- // The bucket name.
- Name *string `type:"string"`
- // When response is truncated (the IsTruncated element value in the response
- // is true), you can use the key name in this field as marker in the subsequent
- // request to get next set of objects. Amazon S3 lists objects in alphabetical
- // order Note: This element is returned only if you have delimiter request parameter
- // specified. If response does not include the NextMarker and it is truncated,
- // you can use the value of the last Key in the response as the marker in the
- // subsequent request to get the next set of object keys.
- NextMarker *string `type:"string"`
- // Keys that begin with the indicated prefix.
- Prefix *string `type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ListObjectsOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ListObjectsOutput) GoString() string {
- return s.String()
- }
- // SetCommonPrefixes sets the CommonPrefixes field's value.
- func (s *ListObjectsOutput) SetCommonPrefixes(v []*CommonPrefix) *ListObjectsOutput {
- s.CommonPrefixes = v
- return s
- }
- // SetContents sets the Contents field's value.
- func (s *ListObjectsOutput) SetContents(v []*Object) *ListObjectsOutput {
- s.Contents = v
- return s
- }
- // SetDelimiter sets the Delimiter field's value.
- func (s *ListObjectsOutput) SetDelimiter(v string) *ListObjectsOutput {
- s.Delimiter = &v
- return s
- }
- // SetEncodingType sets the EncodingType field's value.
- func (s *ListObjectsOutput) SetEncodingType(v string) *ListObjectsOutput {
- s.EncodingType = &v
- return s
- }
- // SetIsTruncated sets the IsTruncated field's value.
- func (s *ListObjectsOutput) SetIsTruncated(v bool) *ListObjectsOutput {
- s.IsTruncated = &v
- return s
- }
- // SetMarker sets the Marker field's value.
- func (s *ListObjectsOutput) SetMarker(v string) *ListObjectsOutput {
- s.Marker = &v
- return s
- }
- // SetMaxKeys sets the MaxKeys field's value.
- func (s *ListObjectsOutput) SetMaxKeys(v int64) *ListObjectsOutput {
- s.MaxKeys = &v
- return s
- }
- // SetName sets the Name field's value.
- func (s *ListObjectsOutput) SetName(v string) *ListObjectsOutput {
- s.Name = &v
- return s
- }
- // SetNextMarker sets the NextMarker field's value.
- func (s *ListObjectsOutput) SetNextMarker(v string) *ListObjectsOutput {
- s.NextMarker = &v
- return s
- }
- // SetPrefix sets the Prefix field's value.
- func (s *ListObjectsOutput) SetPrefix(v string) *ListObjectsOutput {
- s.Prefix = &v
- return s
- }
- type ListObjectsV2Input struct {
- _ struct{} `locationName:"ListObjectsV2Request" type:"structure"`
- // Bucket name to list.
- //
- // When using this action with an access point, you must direct requests to
- // the access point hostname. The access point hostname takes the form AccessPointName-AccountId.s3-accesspoint.Region.amazonaws.com.
- // When using this action with an access point through the Amazon Web Services
- // SDKs, you provide the access point ARN in place of the bucket name. For more
- // information about access point ARNs, see Using access points (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html)
- // in the Amazon S3 User Guide.
- //
- // When using this action with Amazon S3 on Outposts, you must direct requests
- // to the S3 on Outposts hostname. The S3 on Outposts hostname takes the form
- // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When
- // using this action with S3 on Outposts through the Amazon Web Services SDKs,
- // you provide the Outposts bucket ARN in place of the bucket name. For more
- // information about S3 on Outposts ARNs, see Using Amazon S3 on Outposts (https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html)
- // in the Amazon S3 User Guide.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // ContinuationToken indicates Amazon S3 that the list is being continued on
- // this bucket with a token. ContinuationToken is obfuscated and is not a real
- // key.
- ContinuationToken *string `location:"querystring" locationName:"continuation-token" type:"string"`
- // A delimiter is a character you use to group keys.
- Delimiter *string `location:"querystring" locationName:"delimiter" type:"string"`
- // Encoding type used by Amazon S3 to encode object keys in the response.
- EncodingType *string `location:"querystring" locationName:"encoding-type" type:"string" enum:"EncodingType"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // The owner field is not present in listV2 by default, if you want to return
- // owner field with each key in the result then set the fetch owner field to
- // true.
- FetchOwner *bool `location:"querystring" locationName:"fetch-owner" type:"boolean"`
- // Sets the maximum number of keys returned in the response. By default the
- // action returns up to 1,000 key names. The response might contain fewer keys
- // but will never contain more.
- MaxKeys *int64 `location:"querystring" locationName:"max-keys" type:"integer"`
- // Limits the response to keys that begin with the specified prefix.
- Prefix *string `location:"querystring" locationName:"prefix" type:"string"`
- // Confirms that the requester knows that she or he will be charged for the
- // list objects request in V2 style. Bucket owners need not specify this parameter
- // in their requests.
- RequestPayer *string `location:"header" locationName:"x-amz-request-payer" type:"string" enum:"RequestPayer"`
- // StartAfter is where you want Amazon S3 to start listing from. Amazon S3 starts
- // listing after this specified key. StartAfter can be any key in the bucket.
- StartAfter *string `location:"querystring" locationName:"start-after" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ListObjectsV2Input) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ListObjectsV2Input) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *ListObjectsV2Input) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "ListObjectsV2Input"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *ListObjectsV2Input) SetBucket(v string) *ListObjectsV2Input {
- s.Bucket = &v
- return s
- }
- func (s *ListObjectsV2Input) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetContinuationToken sets the ContinuationToken field's value.
- func (s *ListObjectsV2Input) SetContinuationToken(v string) *ListObjectsV2Input {
- s.ContinuationToken = &v
- return s
- }
- // SetDelimiter sets the Delimiter field's value.
- func (s *ListObjectsV2Input) SetDelimiter(v string) *ListObjectsV2Input {
- s.Delimiter = &v
- return s
- }
- // SetEncodingType sets the EncodingType field's value.
- func (s *ListObjectsV2Input) SetEncodingType(v string) *ListObjectsV2Input {
- s.EncodingType = &v
- return s
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *ListObjectsV2Input) SetExpectedBucketOwner(v string) *ListObjectsV2Input {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetFetchOwner sets the FetchOwner field's value.
- func (s *ListObjectsV2Input) SetFetchOwner(v bool) *ListObjectsV2Input {
- s.FetchOwner = &v
- return s
- }
- // SetMaxKeys sets the MaxKeys field's value.
- func (s *ListObjectsV2Input) SetMaxKeys(v int64) *ListObjectsV2Input {
- s.MaxKeys = &v
- return s
- }
- // SetPrefix sets the Prefix field's value.
- func (s *ListObjectsV2Input) SetPrefix(v string) *ListObjectsV2Input {
- s.Prefix = &v
- return s
- }
- // SetRequestPayer sets the RequestPayer field's value.
- func (s *ListObjectsV2Input) SetRequestPayer(v string) *ListObjectsV2Input {
- s.RequestPayer = &v
- return s
- }
- // SetStartAfter sets the StartAfter field's value.
- func (s *ListObjectsV2Input) SetStartAfter(v string) *ListObjectsV2Input {
- s.StartAfter = &v
- return s
- }
- func (s *ListObjectsV2Input) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *ListObjectsV2Input) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s ListObjectsV2Input) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type ListObjectsV2Output struct {
- _ struct{} `type:"structure"`
- // All of the keys (up to 1,000) rolled up into a common prefix count as a single
- // return when calculating the number of returns.
- //
- // A response can contain CommonPrefixes only if you specify a delimiter.
- //
- // CommonPrefixes contains all (if there are any) keys between Prefix and the
- // next occurrence of the string specified by a delimiter.
- //
- // CommonPrefixes lists keys that act like subdirectories in the directory specified
- // by Prefix.
- //
- // For example, if the prefix is notes/ and the delimiter is a slash (/) as
- // in notes/summer/july, the common prefix is notes/summer/. All of the keys
- // that roll up into a common prefix count as a single return when calculating
- // the number of returns.
- CommonPrefixes []*CommonPrefix `type:"list" flattened:"true"`
- // Metadata about each object returned.
- Contents []*Object `type:"list" flattened:"true"`
- // If ContinuationToken was sent with the request, it is included in the response.
- ContinuationToken *string `type:"string"`
- // Causes keys that contain the same string between the prefix and the first
- // occurrence of the delimiter to be rolled up into a single result element
- // in the CommonPrefixes collection. These rolled-up keys are not returned elsewhere
- // in the response. Each rolled-up result counts as only one return against
- // the MaxKeys value.
- Delimiter *string `type:"string"`
- // Encoding type used by Amazon S3 to encode object key names in the XML response.
- //
- // If you specify the encoding-type request parameter, Amazon S3 includes this
- // element in the response, and returns encoded key name values in the following
- // response elements:
- //
- // Delimiter, Prefix, Key, and StartAfter.
- EncodingType *string `type:"string" enum:"EncodingType"`
- // Set to false if all of the results were returned. Set to true if more keys
- // are available to return. If the number of results exceeds that specified
- // by MaxKeys, all of the results might not be returned.
- IsTruncated *bool `type:"boolean"`
- // KeyCount is the number of keys returned with this request. KeyCount will
- // always be less than or equals to MaxKeys field. Say you ask for 50 keys,
- // your result will include less than equals 50 keys
- KeyCount *int64 `type:"integer"`
- // Sets the maximum number of keys returned in the response. By default the
- // action returns up to 1,000 key names. The response might contain fewer keys
- // but will never contain more.
- MaxKeys *int64 `type:"integer"`
- // The bucket name.
- //
- // When using this action with an access point, you must direct requests to
- // the access point hostname. The access point hostname takes the form AccessPointName-AccountId.s3-accesspoint.Region.amazonaws.com.
- // When using this action with an access point through the Amazon Web Services
- // SDKs, you provide the access point ARN in place of the bucket name. For more
- // information about access point ARNs, see Using access points (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html)
- // in the Amazon S3 User Guide.
- //
- // When using this action with Amazon S3 on Outposts, you must direct requests
- // to the S3 on Outposts hostname. The S3 on Outposts hostname takes the form
- // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When
- // using this action with S3 on Outposts through the Amazon Web Services SDKs,
- // you provide the Outposts bucket ARN in place of the bucket name. For more
- // information about S3 on Outposts ARNs, see Using Amazon S3 on Outposts (https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html)
- // in the Amazon S3 User Guide.
- Name *string `type:"string"`
- // NextContinuationToken is sent when isTruncated is true, which means there
- // are more keys in the bucket that can be listed. The next list requests to
- // Amazon S3 can be continued with this NextContinuationToken. NextContinuationToken
- // is obfuscated and is not a real key
- NextContinuationToken *string `type:"string"`
- // Keys that begin with the indicated prefix.
- Prefix *string `type:"string"`
- // If StartAfter was sent with the request, it is included in the response.
- StartAfter *string `type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ListObjectsV2Output) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ListObjectsV2Output) GoString() string {
- return s.String()
- }
- // SetCommonPrefixes sets the CommonPrefixes field's value.
- func (s *ListObjectsV2Output) SetCommonPrefixes(v []*CommonPrefix) *ListObjectsV2Output {
- s.CommonPrefixes = v
- return s
- }
- // SetContents sets the Contents field's value.
- func (s *ListObjectsV2Output) SetContents(v []*Object) *ListObjectsV2Output {
- s.Contents = v
- return s
- }
- // SetContinuationToken sets the ContinuationToken field's value.
- func (s *ListObjectsV2Output) SetContinuationToken(v string) *ListObjectsV2Output {
- s.ContinuationToken = &v
- return s
- }
- // SetDelimiter sets the Delimiter field's value.
- func (s *ListObjectsV2Output) SetDelimiter(v string) *ListObjectsV2Output {
- s.Delimiter = &v
- return s
- }
- // SetEncodingType sets the EncodingType field's value.
- func (s *ListObjectsV2Output) SetEncodingType(v string) *ListObjectsV2Output {
- s.EncodingType = &v
- return s
- }
- // SetIsTruncated sets the IsTruncated field's value.
- func (s *ListObjectsV2Output) SetIsTruncated(v bool) *ListObjectsV2Output {
- s.IsTruncated = &v
- return s
- }
- // SetKeyCount sets the KeyCount field's value.
- func (s *ListObjectsV2Output) SetKeyCount(v int64) *ListObjectsV2Output {
- s.KeyCount = &v
- return s
- }
- // SetMaxKeys sets the MaxKeys field's value.
- func (s *ListObjectsV2Output) SetMaxKeys(v int64) *ListObjectsV2Output {
- s.MaxKeys = &v
- return s
- }
- // SetName sets the Name field's value.
- func (s *ListObjectsV2Output) SetName(v string) *ListObjectsV2Output {
- s.Name = &v
- return s
- }
- // SetNextContinuationToken sets the NextContinuationToken field's value.
- func (s *ListObjectsV2Output) SetNextContinuationToken(v string) *ListObjectsV2Output {
- s.NextContinuationToken = &v
- return s
- }
- // SetPrefix sets the Prefix field's value.
- func (s *ListObjectsV2Output) SetPrefix(v string) *ListObjectsV2Output {
- s.Prefix = &v
- return s
- }
- // SetStartAfter sets the StartAfter field's value.
- func (s *ListObjectsV2Output) SetStartAfter(v string) *ListObjectsV2Output {
- s.StartAfter = &v
- return s
- }
- type ListPartsInput struct {
- _ struct{} `locationName:"ListPartsRequest" type:"structure"`
- // The name of the bucket to which the parts are being uploaded.
- //
- // When using this action with an access point, you must direct requests to
- // the access point hostname. The access point hostname takes the form AccessPointName-AccountId.s3-accesspoint.Region.amazonaws.com.
- // When using this action with an access point through the Amazon Web Services
- // SDKs, you provide the access point ARN in place of the bucket name. For more
- // information about access point ARNs, see Using access points (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html)
- // in the Amazon S3 User Guide.
- //
- // When using this action with Amazon S3 on Outposts, you must direct requests
- // to the S3 on Outposts hostname. The S3 on Outposts hostname takes the form
- // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When
- // using this action with S3 on Outposts through the Amazon Web Services SDKs,
- // you provide the Outposts bucket ARN in place of the bucket name. For more
- // information about S3 on Outposts ARNs, see Using Amazon S3 on Outposts (https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html)
- // in the Amazon S3 User Guide.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // Object key for which the multipart upload was initiated.
- //
- // Key is a required field
- Key *string `location:"uri" locationName:"Key" min:"1" type:"string" required:"true"`
- // Sets the maximum number of parts to return.
- MaxParts *int64 `location:"querystring" locationName:"max-parts" type:"integer"`
- // Specifies the part after which listing should begin. Only parts with higher
- // part numbers will be listed.
- PartNumberMarker *int64 `location:"querystring" locationName:"part-number-marker" type:"integer"`
- // Confirms that the requester knows that they will be charged for the request.
- // Bucket owners need not specify this parameter in their requests. For information
- // about downloading objects from Requester Pays buckets, see Downloading Objects
- // in Requester Pays Buckets (https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html)
- // in the Amazon S3 User Guide.
- RequestPayer *string `location:"header" locationName:"x-amz-request-payer" type:"string" enum:"RequestPayer"`
- // The server-side encryption (SSE) algorithm used to encrypt the object. This
- // parameter is needed only when the object was created using a checksum algorithm.
- // For more information, see Protecting data using SSE-C keys (https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html)
- // in the Amazon S3 User Guide.
- SSECustomerAlgorithm *string `location:"header" locationName:"x-amz-server-side-encryption-customer-algorithm" type:"string"`
- // The server-side encryption (SSE) customer managed key. This parameter is
- // needed only when the object was created using a checksum algorithm. For more
- // information, see Protecting data using SSE-C keys (https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html)
- // in the Amazon S3 User Guide.
- //
- // SSECustomerKey is a sensitive parameter and its value will be
- // replaced with "sensitive" in string returned by ListPartsInput's
- // String and GoString methods.
- SSECustomerKey *string `marshal-as:"blob" location:"header" locationName:"x-amz-server-side-encryption-customer-key" type:"string" sensitive:"true"`
- // The MD5 server-side encryption (SSE) customer managed key. This parameter
- // is needed only when the object was created using a checksum algorithm. For
- // more information, see Protecting data using SSE-C keys (https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html)
- // in the Amazon S3 User Guide.
- SSECustomerKeyMD5 *string `location:"header" locationName:"x-amz-server-side-encryption-customer-key-MD5" type:"string"`
- // Upload ID identifying the multipart upload whose parts are being listed.
- //
- // UploadId is a required field
- UploadId *string `location:"querystring" locationName:"uploadId" type:"string" required:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ListPartsInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ListPartsInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *ListPartsInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "ListPartsInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.Key == nil {
- invalidParams.Add(request.NewErrParamRequired("Key"))
- }
- if s.Key != nil && len(*s.Key) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Key", 1))
- }
- if s.UploadId == nil {
- invalidParams.Add(request.NewErrParamRequired("UploadId"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *ListPartsInput) SetBucket(v string) *ListPartsInput {
- s.Bucket = &v
- return s
- }
- func (s *ListPartsInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *ListPartsInput) SetExpectedBucketOwner(v string) *ListPartsInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetKey sets the Key field's value.
- func (s *ListPartsInput) SetKey(v string) *ListPartsInput {
- s.Key = &v
- return s
- }
- // SetMaxParts sets the MaxParts field's value.
- func (s *ListPartsInput) SetMaxParts(v int64) *ListPartsInput {
- s.MaxParts = &v
- return s
- }
- // SetPartNumberMarker sets the PartNumberMarker field's value.
- func (s *ListPartsInput) SetPartNumberMarker(v int64) *ListPartsInput {
- s.PartNumberMarker = &v
- return s
- }
- // SetRequestPayer sets the RequestPayer field's value.
- func (s *ListPartsInput) SetRequestPayer(v string) *ListPartsInput {
- s.RequestPayer = &v
- return s
- }
- // SetSSECustomerAlgorithm sets the SSECustomerAlgorithm field's value.
- func (s *ListPartsInput) SetSSECustomerAlgorithm(v string) *ListPartsInput {
- s.SSECustomerAlgorithm = &v
- return s
- }
- // SetSSECustomerKey sets the SSECustomerKey field's value.
- func (s *ListPartsInput) SetSSECustomerKey(v string) *ListPartsInput {
- s.SSECustomerKey = &v
- return s
- }
- func (s *ListPartsInput) getSSECustomerKey() (v string) {
- if s.SSECustomerKey == nil {
- return v
- }
- return *s.SSECustomerKey
- }
- // SetSSECustomerKeyMD5 sets the SSECustomerKeyMD5 field's value.
- func (s *ListPartsInput) SetSSECustomerKeyMD5(v string) *ListPartsInput {
- s.SSECustomerKeyMD5 = &v
- return s
- }
- // SetUploadId sets the UploadId field's value.
- func (s *ListPartsInput) SetUploadId(v string) *ListPartsInput {
- s.UploadId = &v
- return s
- }
- func (s *ListPartsInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *ListPartsInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s ListPartsInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type ListPartsOutput struct {
- _ struct{} `type:"structure"`
- // If the bucket has a lifecycle rule configured with an action to abort incomplete
- // multipart uploads and the prefix in the lifecycle rule matches the object
- // name in the request, then the response includes this header indicating when
- // the initiated multipart upload will become eligible for abort operation.
- // For more information, see Aborting Incomplete Multipart Uploads Using a Bucket
- // Lifecycle Policy (https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html#mpu-abort-incomplete-mpu-lifecycle-config).
- //
- // The response will also include the x-amz-abort-rule-id header that will provide
- // the ID of the lifecycle configuration rule that defines this action.
- AbortDate *time.Time `location:"header" locationName:"x-amz-abort-date" type:"timestamp"`
- // This header is returned along with the x-amz-abort-date header. It identifies
- // applicable lifecycle configuration rule that defines the action to abort
- // incomplete multipart uploads.
- AbortRuleId *string `location:"header" locationName:"x-amz-abort-rule-id" type:"string"`
- // The name of the bucket to which the multipart upload was initiated. Does
- // not return the access point ARN or access point alias if used.
- Bucket *string `type:"string"`
- // The algorithm that was used to create a checksum of the object.
- ChecksumAlgorithm *string `type:"string" enum:"ChecksumAlgorithm"`
- // Container element that identifies who initiated the multipart upload. If
- // the initiator is an Amazon Web Services account, this element provides the
- // same information as the Owner element. If the initiator is an IAM User, this
- // element provides the user ARN and display name.
- Initiator *Initiator `type:"structure"`
- // Indicates whether the returned list of parts is truncated. A true value indicates
- // that the list was truncated. A list can be truncated if the number of parts
- // exceeds the limit returned in the MaxParts element.
- IsTruncated *bool `type:"boolean"`
- // Object key for which the multipart upload was initiated.
- Key *string `min:"1" type:"string"`
- // Maximum number of parts that were allowed in the response.
- MaxParts *int64 `type:"integer"`
- // When a list is truncated, this element specifies the last part in the list,
- // as well as the value to use for the part-number-marker request parameter
- // in a subsequent request.
- NextPartNumberMarker *int64 `type:"integer"`
- // Container element that identifies the object owner, after the object is created.
- // If multipart upload is initiated by an IAM user, this element provides the
- // parent account ID and display name.
- Owner *Owner `type:"structure"`
- // When a list is truncated, this element specifies the last part in the list,
- // as well as the value to use for the part-number-marker request parameter
- // in a subsequent request.
- PartNumberMarker *int64 `type:"integer"`
- // Container for elements related to a particular part. A response can contain
- // zero or more Part elements.
- Parts []*Part `locationName:"Part" type:"list" flattened:"true"`
- // If present, indicates that the requester was successfully charged for the
- // request.
- RequestCharged *string `location:"header" locationName:"x-amz-request-charged" type:"string" enum:"RequestCharged"`
- // Class of storage (STANDARD or REDUCED_REDUNDANCY) used to store the uploaded
- // object.
- StorageClass *string `type:"string" enum:"StorageClass"`
- // Upload ID identifying the multipart upload whose parts are being listed.
- UploadId *string `type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ListPartsOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ListPartsOutput) GoString() string {
- return s.String()
- }
- // SetAbortDate sets the AbortDate field's value.
- func (s *ListPartsOutput) SetAbortDate(v time.Time) *ListPartsOutput {
- s.AbortDate = &v
- return s
- }
- // SetAbortRuleId sets the AbortRuleId field's value.
- func (s *ListPartsOutput) SetAbortRuleId(v string) *ListPartsOutput {
- s.AbortRuleId = &v
- return s
- }
- // SetBucket sets the Bucket field's value.
- func (s *ListPartsOutput) SetBucket(v string) *ListPartsOutput {
- s.Bucket = &v
- return s
- }
- func (s *ListPartsOutput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetChecksumAlgorithm sets the ChecksumAlgorithm field's value.
- func (s *ListPartsOutput) SetChecksumAlgorithm(v string) *ListPartsOutput {
- s.ChecksumAlgorithm = &v
- return s
- }
- // SetInitiator sets the Initiator field's value.
- func (s *ListPartsOutput) SetInitiator(v *Initiator) *ListPartsOutput {
- s.Initiator = v
- return s
- }
- // SetIsTruncated sets the IsTruncated field's value.
- func (s *ListPartsOutput) SetIsTruncated(v bool) *ListPartsOutput {
- s.IsTruncated = &v
- return s
- }
- // SetKey sets the Key field's value.
- func (s *ListPartsOutput) SetKey(v string) *ListPartsOutput {
- s.Key = &v
- return s
- }
- // SetMaxParts sets the MaxParts field's value.
- func (s *ListPartsOutput) SetMaxParts(v int64) *ListPartsOutput {
- s.MaxParts = &v
- return s
- }
- // SetNextPartNumberMarker sets the NextPartNumberMarker field's value.
- func (s *ListPartsOutput) SetNextPartNumberMarker(v int64) *ListPartsOutput {
- s.NextPartNumberMarker = &v
- return s
- }
- // SetOwner sets the Owner field's value.
- func (s *ListPartsOutput) SetOwner(v *Owner) *ListPartsOutput {
- s.Owner = v
- return s
- }
- // SetPartNumberMarker sets the PartNumberMarker field's value.
- func (s *ListPartsOutput) SetPartNumberMarker(v int64) *ListPartsOutput {
- s.PartNumberMarker = &v
- return s
- }
- // SetParts sets the Parts field's value.
- func (s *ListPartsOutput) SetParts(v []*Part) *ListPartsOutput {
- s.Parts = v
- return s
- }
- // SetRequestCharged sets the RequestCharged field's value.
- func (s *ListPartsOutput) SetRequestCharged(v string) *ListPartsOutput {
- s.RequestCharged = &v
- return s
- }
- // SetStorageClass sets the StorageClass field's value.
- func (s *ListPartsOutput) SetStorageClass(v string) *ListPartsOutput {
- s.StorageClass = &v
- return s
- }
- // SetUploadId sets the UploadId field's value.
- func (s *ListPartsOutput) SetUploadId(v string) *ListPartsOutput {
- s.UploadId = &v
- return s
- }
- // Describes an Amazon S3 location that will receive the results of the restore
- // request.
- type Location struct {
- _ struct{} `type:"structure"`
- // A list of grants that control access to the staged results.
- AccessControlList []*Grant `locationNameList:"Grant" type:"list"`
- // The name of the bucket where the restore results will be placed.
- //
- // BucketName is a required field
- BucketName *string `type:"string" required:"true"`
- // The canned ACL to apply to the restore results.
- CannedACL *string `type:"string" enum:"ObjectCannedACL"`
- // Contains the type of server-side encryption used.
- Encryption *Encryption `type:"structure"`
- // The prefix that is prepended to the restore results for this request.
- //
- // Prefix is a required field
- Prefix *string `type:"string" required:"true"`
- // The class of storage used to store the restore results.
- StorageClass *string `type:"string" enum:"StorageClass"`
- // The tag-set that is applied to the restore results.
- Tagging *Tagging `type:"structure"`
- // A list of metadata to store with the restore results in S3.
- UserMetadata []*MetadataEntry `locationNameList:"MetadataEntry" type:"list"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s Location) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s Location) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *Location) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "Location"}
- if s.BucketName == nil {
- invalidParams.Add(request.NewErrParamRequired("BucketName"))
- }
- if s.Prefix == nil {
- invalidParams.Add(request.NewErrParamRequired("Prefix"))
- }
- if s.AccessControlList != nil {
- for i, v := range s.AccessControlList {
- if v == nil {
- continue
- }
- if err := v.Validate(); err != nil {
- invalidParams.AddNested(fmt.Sprintf("%s[%v]", "AccessControlList", i), err.(request.ErrInvalidParams))
- }
- }
- }
- if s.Encryption != nil {
- if err := s.Encryption.Validate(); err != nil {
- invalidParams.AddNested("Encryption", err.(request.ErrInvalidParams))
- }
- }
- if s.Tagging != nil {
- if err := s.Tagging.Validate(); err != nil {
- invalidParams.AddNested("Tagging", err.(request.ErrInvalidParams))
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetAccessControlList sets the AccessControlList field's value.
- func (s *Location) SetAccessControlList(v []*Grant) *Location {
- s.AccessControlList = v
- return s
- }
- // SetBucketName sets the BucketName field's value.
- func (s *Location) SetBucketName(v string) *Location {
- s.BucketName = &v
- return s
- }
- // SetCannedACL sets the CannedACL field's value.
- func (s *Location) SetCannedACL(v string) *Location {
- s.CannedACL = &v
- return s
- }
- // SetEncryption sets the Encryption field's value.
- func (s *Location) SetEncryption(v *Encryption) *Location {
- s.Encryption = v
- return s
- }
- // SetPrefix sets the Prefix field's value.
- func (s *Location) SetPrefix(v string) *Location {
- s.Prefix = &v
- return s
- }
- // SetStorageClass sets the StorageClass field's value.
- func (s *Location) SetStorageClass(v string) *Location {
- s.StorageClass = &v
- return s
- }
- // SetTagging sets the Tagging field's value.
- func (s *Location) SetTagging(v *Tagging) *Location {
- s.Tagging = v
- return s
- }
- // SetUserMetadata sets the UserMetadata field's value.
- func (s *Location) SetUserMetadata(v []*MetadataEntry) *Location {
- s.UserMetadata = v
- return s
- }
- // Describes where logs are stored and the prefix that Amazon S3 assigns to
- // all log object keys for a bucket. For more information, see PUT Bucket logging
- // (https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTlogging.html)
- // in the Amazon S3 API Reference.
- type LoggingEnabled struct {
- _ struct{} `type:"structure"`
- // Specifies the bucket where you want Amazon S3 to store server access logs.
- // You can have your logs delivered to any bucket that you own, including the
- // same bucket that is being logged. You can also configure multiple buckets
- // to deliver their logs to the same target bucket. In this case, you should
- // choose a different TargetPrefix for each source bucket so that the delivered
- // log files can be distinguished by key.
- //
- // TargetBucket is a required field
- TargetBucket *string `type:"string" required:"true"`
- // Container for granting information.
- //
- // Buckets that use the bucket owner enforced setting for Object Ownership don't
- // support target grants. For more information, see Permissions for server access
- // log delivery (https://docs.aws.amazon.com/AmazonS3/latest/userguide/enable-server-access-logging.html#grant-log-delivery-permissions-general)
- // in the Amazon S3 User Guide.
- TargetGrants []*TargetGrant `locationNameList:"Grant" type:"list"`
- // A prefix for all log object keys. If you store log files from multiple Amazon
- // S3 buckets in a single bucket, you can use a prefix to distinguish which
- // log files came from which bucket.
- //
- // TargetPrefix is a required field
- TargetPrefix *string `type:"string" required:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s LoggingEnabled) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s LoggingEnabled) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *LoggingEnabled) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "LoggingEnabled"}
- if s.TargetBucket == nil {
- invalidParams.Add(request.NewErrParamRequired("TargetBucket"))
- }
- if s.TargetPrefix == nil {
- invalidParams.Add(request.NewErrParamRequired("TargetPrefix"))
- }
- if s.TargetGrants != nil {
- for i, v := range s.TargetGrants {
- if v == nil {
- continue
- }
- if err := v.Validate(); err != nil {
- invalidParams.AddNested(fmt.Sprintf("%s[%v]", "TargetGrants", i), err.(request.ErrInvalidParams))
- }
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetTargetBucket sets the TargetBucket field's value.
- func (s *LoggingEnabled) SetTargetBucket(v string) *LoggingEnabled {
- s.TargetBucket = &v
- return s
- }
- // SetTargetGrants sets the TargetGrants field's value.
- func (s *LoggingEnabled) SetTargetGrants(v []*TargetGrant) *LoggingEnabled {
- s.TargetGrants = v
- return s
- }
- // SetTargetPrefix sets the TargetPrefix field's value.
- func (s *LoggingEnabled) SetTargetPrefix(v string) *LoggingEnabled {
- s.TargetPrefix = &v
- return s
- }
- // A metadata key-value pair to store with an object.
- type MetadataEntry struct {
- _ struct{} `type:"structure"`
- // Name of the Object.
- Name *string `type:"string"`
- // Value of the Object.
- Value *string `type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s MetadataEntry) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s MetadataEntry) GoString() string {
- return s.String()
- }
- // SetName sets the Name field's value.
- func (s *MetadataEntry) SetName(v string) *MetadataEntry {
- s.Name = &v
- return s
- }
- // SetValue sets the Value field's value.
- func (s *MetadataEntry) SetValue(v string) *MetadataEntry {
- s.Value = &v
- return s
- }
- // A container specifying replication metrics-related settings enabling replication
- // metrics and events.
- type Metrics struct {
- _ struct{} `type:"structure"`
- // A container specifying the time threshold for emitting the s3:Replication:OperationMissedThreshold
- // event.
- EventThreshold *ReplicationTimeValue `type:"structure"`
- // Specifies whether the replication metrics are enabled.
- //
- // Status is a required field
- Status *string `type:"string" required:"true" enum:"MetricsStatus"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s Metrics) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s Metrics) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *Metrics) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "Metrics"}
- if s.Status == nil {
- invalidParams.Add(request.NewErrParamRequired("Status"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetEventThreshold sets the EventThreshold field's value.
- func (s *Metrics) SetEventThreshold(v *ReplicationTimeValue) *Metrics {
- s.EventThreshold = v
- return s
- }
- // SetStatus sets the Status field's value.
- func (s *Metrics) SetStatus(v string) *Metrics {
- s.Status = &v
- return s
- }
- // A conjunction (logical AND) of predicates, which is used in evaluating a
- // metrics filter. The operator must have at least two predicates, and an object
- // must match all of the predicates in order for the filter to apply.
- type MetricsAndOperator struct {
- _ struct{} `type:"structure"`
- // The access point ARN used when evaluating an AND predicate.
- AccessPointArn *string `type:"string"`
- // The prefix used when evaluating an AND predicate.
- Prefix *string `type:"string"`
- // The list of tags used when evaluating an AND predicate.
- Tags []*Tag `locationName:"Tag" locationNameList:"Tag" type:"list" flattened:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s MetricsAndOperator) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s MetricsAndOperator) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *MetricsAndOperator) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "MetricsAndOperator"}
- 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
- }
- // SetAccessPointArn sets the AccessPointArn field's value.
- func (s *MetricsAndOperator) SetAccessPointArn(v string) *MetricsAndOperator {
- s.AccessPointArn = &v
- return s
- }
- // SetPrefix sets the Prefix field's value.
- func (s *MetricsAndOperator) SetPrefix(v string) *MetricsAndOperator {
- s.Prefix = &v
- return s
- }
- // SetTags sets the Tags field's value.
- func (s *MetricsAndOperator) SetTags(v []*Tag) *MetricsAndOperator {
- s.Tags = v
- return s
- }
- // Specifies a metrics configuration for the CloudWatch request metrics (specified
- // by the metrics configuration ID) from an Amazon S3 bucket. If you're updating
- // an existing metrics configuration, note that this is a full replacement of
- // the existing metrics configuration. If you don't include the elements you
- // want to keep, they are erased. For more information, see PutBucketMetricsConfiguration
- // (https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTMetricConfiguration.html).
- type MetricsConfiguration struct {
- _ struct{} `type:"structure"`
- // Specifies a metrics configuration filter. The metrics configuration will
- // only include objects that meet the filter's criteria. A filter must be a
- // prefix, an object tag, an access point ARN, or a conjunction (MetricsAndOperator).
- Filter *MetricsFilter `type:"structure"`
- // The ID used to identify the metrics configuration.
- //
- // Id is a required field
- Id *string `type:"string" required:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s MetricsConfiguration) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s MetricsConfiguration) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *MetricsConfiguration) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "MetricsConfiguration"}
- if s.Id == nil {
- invalidParams.Add(request.NewErrParamRequired("Id"))
- }
- if s.Filter != nil {
- if err := s.Filter.Validate(); err != nil {
- invalidParams.AddNested("Filter", err.(request.ErrInvalidParams))
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetFilter sets the Filter field's value.
- func (s *MetricsConfiguration) SetFilter(v *MetricsFilter) *MetricsConfiguration {
- s.Filter = v
- return s
- }
- // SetId sets the Id field's value.
- func (s *MetricsConfiguration) SetId(v string) *MetricsConfiguration {
- s.Id = &v
- return s
- }
- // Specifies a metrics configuration filter. The metrics configuration only
- // includes objects that meet the filter's criteria. A filter must be a prefix,
- // an object tag, an access point ARN, or a conjunction (MetricsAndOperator).
- // For more information, see PutBucketMetricsConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketMetricsConfiguration.html).
- type MetricsFilter struct {
- _ struct{} `type:"structure"`
- // The access point ARN used when evaluating a metrics filter.
- AccessPointArn *string `type:"string"`
- // A conjunction (logical AND) of predicates, which is used in evaluating a
- // metrics filter. The operator must have at least two predicates, and an object
- // must match all of the predicates in order for the filter to apply.
- And *MetricsAndOperator `type:"structure"`
- // The prefix used when evaluating a metrics filter.
- Prefix *string `type:"string"`
- // The tag used when evaluating a metrics filter.
- Tag *Tag `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s MetricsFilter) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s MetricsFilter) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *MetricsFilter) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "MetricsFilter"}
- if s.And != nil {
- if err := s.And.Validate(); err != nil {
- invalidParams.AddNested("And", err.(request.ErrInvalidParams))
- }
- }
- if s.Tag != nil {
- if err := s.Tag.Validate(); err != nil {
- invalidParams.AddNested("Tag", err.(request.ErrInvalidParams))
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetAccessPointArn sets the AccessPointArn field's value.
- func (s *MetricsFilter) SetAccessPointArn(v string) *MetricsFilter {
- s.AccessPointArn = &v
- return s
- }
- // SetAnd sets the And field's value.
- func (s *MetricsFilter) SetAnd(v *MetricsAndOperator) *MetricsFilter {
- s.And = v
- return s
- }
- // SetPrefix sets the Prefix field's value.
- func (s *MetricsFilter) SetPrefix(v string) *MetricsFilter {
- s.Prefix = &v
- return s
- }
- // SetTag sets the Tag field's value.
- func (s *MetricsFilter) SetTag(v *Tag) *MetricsFilter {
- s.Tag = v
- return s
- }
- // Container for the MultipartUpload for the Amazon S3 object.
- type MultipartUpload struct {
- _ struct{} `type:"structure"`
- // The algorithm that was used to create a checksum of the object.
- ChecksumAlgorithm *string `type:"string" enum:"ChecksumAlgorithm"`
- // Date and time at which the multipart upload was initiated.
- Initiated *time.Time `type:"timestamp"`
- // Identifies who initiated the multipart upload.
- Initiator *Initiator `type:"structure"`
- // Key of the object for which the multipart upload was initiated.
- Key *string `min:"1" type:"string"`
- // Specifies the owner of the object that is part of the multipart upload.
- Owner *Owner `type:"structure"`
- // The class of storage used to store the object.
- StorageClass *string `type:"string" enum:"StorageClass"`
- // Upload ID that identifies the multipart upload.
- UploadId *string `type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s MultipartUpload) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s MultipartUpload) GoString() string {
- return s.String()
- }
- // SetChecksumAlgorithm sets the ChecksumAlgorithm field's value.
- func (s *MultipartUpload) SetChecksumAlgorithm(v string) *MultipartUpload {
- s.ChecksumAlgorithm = &v
- return s
- }
- // SetInitiated sets the Initiated field's value.
- func (s *MultipartUpload) SetInitiated(v time.Time) *MultipartUpload {
- s.Initiated = &v
- return s
- }
- // SetInitiator sets the Initiator field's value.
- func (s *MultipartUpload) SetInitiator(v *Initiator) *MultipartUpload {
- s.Initiator = v
- return s
- }
- // SetKey sets the Key field's value.
- func (s *MultipartUpload) SetKey(v string) *MultipartUpload {
- s.Key = &v
- return s
- }
- // SetOwner sets the Owner field's value.
- func (s *MultipartUpload) SetOwner(v *Owner) *MultipartUpload {
- s.Owner = v
- return s
- }
- // SetStorageClass sets the StorageClass field's value.
- func (s *MultipartUpload) SetStorageClass(v string) *MultipartUpload {
- s.StorageClass = &v
- return s
- }
- // SetUploadId sets the UploadId field's value.
- func (s *MultipartUpload) SetUploadId(v string) *MultipartUpload {
- s.UploadId = &v
- return s
- }
- // Specifies when noncurrent object versions expire. Upon expiration, Amazon
- // S3 permanently deletes the noncurrent object versions. You set this lifecycle
- // configuration action on a bucket that has versioning enabled (or suspended)
- // to request that Amazon S3 delete noncurrent object versions at a specific
- // period in the object's lifetime.
- type NoncurrentVersionExpiration struct {
- _ struct{} `type:"structure"`
- // Specifies how many noncurrent versions Amazon S3 will retain. If there are
- // this many more recent noncurrent versions, Amazon S3 will take the associated
- // action. For more information about noncurrent versions, see Lifecycle configuration
- // elements (https://docs.aws.amazon.com/AmazonS3/latest/userguide/intro-lifecycle-rules.html)
- // in the Amazon S3 User Guide.
- NewerNoncurrentVersions *int64 `type:"integer"`
- // Specifies the number of days an object is noncurrent before Amazon S3 can
- // perform the associated action. The value must be a non-zero positive integer.
- // For information about the noncurrent days calculations, see How Amazon S3
- // Calculates When an Object Became Noncurrent (https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html#non-current-days-calculations)
- // in the Amazon S3 User Guide.
- NoncurrentDays *int64 `type:"integer"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s NoncurrentVersionExpiration) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s NoncurrentVersionExpiration) GoString() string {
- return s.String()
- }
- // SetNewerNoncurrentVersions sets the NewerNoncurrentVersions field's value.
- func (s *NoncurrentVersionExpiration) SetNewerNoncurrentVersions(v int64) *NoncurrentVersionExpiration {
- s.NewerNoncurrentVersions = &v
- return s
- }
- // SetNoncurrentDays sets the NoncurrentDays field's value.
- func (s *NoncurrentVersionExpiration) SetNoncurrentDays(v int64) *NoncurrentVersionExpiration {
- s.NoncurrentDays = &v
- return s
- }
- // Container for the transition rule that describes when noncurrent objects
- // transition to the STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER_IR,
- // GLACIER, or DEEP_ARCHIVE storage class. If your bucket is versioning-enabled
- // (or versioning is suspended), you can set this action to request that Amazon
- // S3 transition noncurrent object versions to the STANDARD_IA, ONEZONE_IA,
- // INTELLIGENT_TIERING, GLACIER_IR, GLACIER, or DEEP_ARCHIVE storage class at
- // a specific period in the object's lifetime.
- type NoncurrentVersionTransition struct {
- _ struct{} `type:"structure"`
- // Specifies how many noncurrent versions Amazon S3 will retain. If there are
- // this many more recent noncurrent versions, Amazon S3 will take the associated
- // action. For more information about noncurrent versions, see Lifecycle configuration
- // elements (https://docs.aws.amazon.com/AmazonS3/latest/userguide/intro-lifecycle-rules.html)
- // in the Amazon S3 User Guide.
- NewerNoncurrentVersions *int64 `type:"integer"`
- // Specifies the number of days an object is noncurrent before Amazon S3 can
- // perform the associated action. For information about the noncurrent days
- // calculations, see How Amazon S3 Calculates How Long an Object Has Been Noncurrent
- // (https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html#non-current-days-calculations)
- // in the Amazon S3 User Guide.
- NoncurrentDays *int64 `type:"integer"`
- // The class of storage used to store the object.
- StorageClass *string `type:"string" enum:"TransitionStorageClass"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s NoncurrentVersionTransition) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s NoncurrentVersionTransition) GoString() string {
- return s.String()
- }
- // SetNewerNoncurrentVersions sets the NewerNoncurrentVersions field's value.
- func (s *NoncurrentVersionTransition) SetNewerNoncurrentVersions(v int64) *NoncurrentVersionTransition {
- s.NewerNoncurrentVersions = &v
- return s
- }
- // SetNoncurrentDays sets the NoncurrentDays field's value.
- func (s *NoncurrentVersionTransition) SetNoncurrentDays(v int64) *NoncurrentVersionTransition {
- s.NoncurrentDays = &v
- return s
- }
- // SetStorageClass sets the StorageClass field's value.
- func (s *NoncurrentVersionTransition) SetStorageClass(v string) *NoncurrentVersionTransition {
- s.StorageClass = &v
- return s
- }
- // A container for specifying the notification configuration of the bucket.
- // If this element is empty, notifications are turned off for the bucket.
- type NotificationConfiguration struct {
- _ struct{} `type:"structure"`
- // Enables delivery of events to Amazon EventBridge.
- EventBridgeConfiguration *EventBridgeConfiguration `type:"structure"`
- // Describes the Lambda functions to invoke and the events for which to invoke
- // them.
- LambdaFunctionConfigurations []*LambdaFunctionConfiguration `locationName:"CloudFunctionConfiguration" type:"list" flattened:"true"`
- // The Amazon Simple Queue Service queues to publish messages to and the events
- // for which to publish messages.
- QueueConfigurations []*QueueConfiguration `locationName:"QueueConfiguration" type:"list" flattened:"true"`
- // The topic to which notifications are sent and the events for which notifications
- // are generated.
- TopicConfigurations []*TopicConfiguration `locationName:"TopicConfiguration" type:"list" flattened:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s NotificationConfiguration) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s NotificationConfiguration) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *NotificationConfiguration) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "NotificationConfiguration"}
- if s.LambdaFunctionConfigurations != nil {
- for i, v := range s.LambdaFunctionConfigurations {
- if v == nil {
- continue
- }
- if err := v.Validate(); err != nil {
- invalidParams.AddNested(fmt.Sprintf("%s[%v]", "LambdaFunctionConfigurations", i), err.(request.ErrInvalidParams))
- }
- }
- }
- if s.QueueConfigurations != nil {
- for i, v := range s.QueueConfigurations {
- if v == nil {
- continue
- }
- if err := v.Validate(); err != nil {
- invalidParams.AddNested(fmt.Sprintf("%s[%v]", "QueueConfigurations", i), err.(request.ErrInvalidParams))
- }
- }
- }
- if s.TopicConfigurations != nil {
- for i, v := range s.TopicConfigurations {
- if v == nil {
- continue
- }
- if err := v.Validate(); err != nil {
- invalidParams.AddNested(fmt.Sprintf("%s[%v]", "TopicConfigurations", i), err.(request.ErrInvalidParams))
- }
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetEventBridgeConfiguration sets the EventBridgeConfiguration field's value.
- func (s *NotificationConfiguration) SetEventBridgeConfiguration(v *EventBridgeConfiguration) *NotificationConfiguration {
- s.EventBridgeConfiguration = v
- return s
- }
- // SetLambdaFunctionConfigurations sets the LambdaFunctionConfigurations field's value.
- func (s *NotificationConfiguration) SetLambdaFunctionConfigurations(v []*LambdaFunctionConfiguration) *NotificationConfiguration {
- s.LambdaFunctionConfigurations = v
- return s
- }
- // SetQueueConfigurations sets the QueueConfigurations field's value.
- func (s *NotificationConfiguration) SetQueueConfigurations(v []*QueueConfiguration) *NotificationConfiguration {
- s.QueueConfigurations = v
- return s
- }
- // SetTopicConfigurations sets the TopicConfigurations field's value.
- func (s *NotificationConfiguration) SetTopicConfigurations(v []*TopicConfiguration) *NotificationConfiguration {
- s.TopicConfigurations = v
- return s
- }
- type NotificationConfigurationDeprecated struct {
- _ struct{} `type:"structure"`
- // Container for specifying the Lambda notification configuration.
- CloudFunctionConfiguration *CloudFunctionConfiguration `type:"structure"`
- // This data type is deprecated. This data type specifies the configuration
- // for publishing messages to an Amazon Simple Queue Service (Amazon SQS) queue
- // when Amazon S3 detects specified events.
- QueueConfiguration *QueueConfigurationDeprecated `type:"structure"`
- // This data type is deprecated. A container for specifying the configuration
- // for publication of messages to an Amazon Simple Notification Service (Amazon
- // SNS) topic when Amazon S3 detects specified events.
- TopicConfiguration *TopicConfigurationDeprecated `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s NotificationConfigurationDeprecated) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s NotificationConfigurationDeprecated) GoString() string {
- return s.String()
- }
- // SetCloudFunctionConfiguration sets the CloudFunctionConfiguration field's value.
- func (s *NotificationConfigurationDeprecated) SetCloudFunctionConfiguration(v *CloudFunctionConfiguration) *NotificationConfigurationDeprecated {
- s.CloudFunctionConfiguration = v
- return s
- }
- // SetQueueConfiguration sets the QueueConfiguration field's value.
- func (s *NotificationConfigurationDeprecated) SetQueueConfiguration(v *QueueConfigurationDeprecated) *NotificationConfigurationDeprecated {
- s.QueueConfiguration = v
- return s
- }
- // SetTopicConfiguration sets the TopicConfiguration field's value.
- func (s *NotificationConfigurationDeprecated) SetTopicConfiguration(v *TopicConfigurationDeprecated) *NotificationConfigurationDeprecated {
- s.TopicConfiguration = v
- return s
- }
- // Specifies object key name filtering rules. For information about key name
- // filtering, see Configuring Event Notifications (https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html)
- // in the Amazon S3 User Guide.
- type NotificationConfigurationFilter struct {
- _ struct{} `type:"structure"`
- // A container for object key name prefix and suffix filtering rules.
- Key *KeyFilter `locationName:"S3Key" type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s NotificationConfigurationFilter) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s NotificationConfigurationFilter) GoString() string {
- return s.String()
- }
- // SetKey sets the Key field's value.
- func (s *NotificationConfigurationFilter) SetKey(v *KeyFilter) *NotificationConfigurationFilter {
- s.Key = v
- return s
- }
- // An object consists of data and its descriptive metadata.
- type Object struct {
- _ struct{} `type:"structure"`
- // The algorithm that was used to create a checksum of the object.
- ChecksumAlgorithm []*string `type:"list" flattened:"true" enum:"ChecksumAlgorithm"`
- // The entity tag is a hash of the object. The ETag reflects changes only to
- // the contents of an object, not its metadata. The ETag may or may not be an
- // MD5 digest of the object data. Whether or not it is depends on how the object
- // was created and how it is encrypted as described below:
- //
- // * Objects created by the PUT Object, POST Object, or Copy operation, or
- // through the Amazon Web Services Management Console, and are encrypted
- // by SSE-S3 or plaintext, have ETags that are an MD5 digest of their object
- // data.
- //
- // * Objects created by the PUT Object, POST Object, or Copy operation, or
- // through the Amazon Web Services Management Console, and are encrypted
- // by SSE-C or SSE-KMS, have ETags that are not an MD5 digest of their object
- // data.
- //
- // * If an object is created by either the Multipart Upload or Part Copy
- // operation, the ETag is not an MD5 digest, regardless of the method of
- // encryption. If an object is larger than 16 MB, the Amazon Web Services
- // Management Console will upload or copy that object as a Multipart Upload,
- // and therefore the ETag will not be an MD5 digest.
- ETag *string `type:"string"`
- // The name that you assign to an object. You use the object key to retrieve
- // the object.
- Key *string `min:"1" type:"string"`
- // Creation date of the object.
- LastModified *time.Time `type:"timestamp"`
- // The owner of the object
- Owner *Owner `type:"structure"`
- // Size in bytes of the object
- Size *int64 `type:"integer"`
- // The class of storage used to store the object.
- StorageClass *string `type:"string" enum:"ObjectStorageClass"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s Object) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s Object) GoString() string {
- return s.String()
- }
- // SetChecksumAlgorithm sets the ChecksumAlgorithm field's value.
- func (s *Object) SetChecksumAlgorithm(v []*string) *Object {
- s.ChecksumAlgorithm = v
- return s
- }
- // SetETag sets the ETag field's value.
- func (s *Object) SetETag(v string) *Object {
- s.ETag = &v
- return s
- }
- // SetKey sets the Key field's value.
- func (s *Object) SetKey(v string) *Object {
- s.Key = &v
- return s
- }
- // SetLastModified sets the LastModified field's value.
- func (s *Object) SetLastModified(v time.Time) *Object {
- s.LastModified = &v
- return s
- }
- // SetOwner sets the Owner field's value.
- func (s *Object) SetOwner(v *Owner) *Object {
- s.Owner = v
- return s
- }
- // SetSize sets the Size field's value.
- func (s *Object) SetSize(v int64) *Object {
- s.Size = &v
- return s
- }
- // SetStorageClass sets the StorageClass field's value.
- func (s *Object) SetStorageClass(v string) *Object {
- s.StorageClass = &v
- return s
- }
- // Object Identifier is unique value to identify objects.
- type ObjectIdentifier struct {
- _ struct{} `type:"structure"`
- // Key name of the object.
- //
- // Replacement must be made for object keys containing special characters (such
- // as carriage returns) when using XML requests. For more information, see XML
- // related object key constraints (https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html#object-key-xml-related-constraints).
- //
- // Key is a required field
- Key *string `min:"1" type:"string" required:"true"`
- // VersionId for the specific version of the object to delete.
- VersionId *string `type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ObjectIdentifier) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ObjectIdentifier) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *ObjectIdentifier) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "ObjectIdentifier"}
- if s.Key == nil {
- invalidParams.Add(request.NewErrParamRequired("Key"))
- }
- if s.Key != nil && len(*s.Key) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Key", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetKey sets the Key field's value.
- func (s *ObjectIdentifier) SetKey(v string) *ObjectIdentifier {
- s.Key = &v
- return s
- }
- // SetVersionId sets the VersionId field's value.
- func (s *ObjectIdentifier) SetVersionId(v string) *ObjectIdentifier {
- s.VersionId = &v
- return s
- }
- // The container element for Object Lock configuration parameters.
- type ObjectLockConfiguration struct {
- _ struct{} `type:"structure"`
- // Indicates whether this bucket has an Object Lock configuration enabled. Enable
- // ObjectLockEnabled when you apply ObjectLockConfiguration to a bucket.
- ObjectLockEnabled *string `type:"string" enum:"ObjectLockEnabled"`
- // Specifies the Object Lock rule for the specified object. Enable the this
- // rule when you apply ObjectLockConfiguration to a bucket. Bucket settings
- // require both a mode and a period. The period can be either Days or Years
- // but you must select one. You cannot specify Days and Years at the same time.
- Rule *ObjectLockRule `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ObjectLockConfiguration) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ObjectLockConfiguration) GoString() string {
- return s.String()
- }
- // SetObjectLockEnabled sets the ObjectLockEnabled field's value.
- func (s *ObjectLockConfiguration) SetObjectLockEnabled(v string) *ObjectLockConfiguration {
- s.ObjectLockEnabled = &v
- return s
- }
- // SetRule sets the Rule field's value.
- func (s *ObjectLockConfiguration) SetRule(v *ObjectLockRule) *ObjectLockConfiguration {
- s.Rule = v
- return s
- }
- // A legal hold configuration for an object.
- type ObjectLockLegalHold struct {
- _ struct{} `type:"structure"`
- // Indicates whether the specified object has a legal hold in place.
- Status *string `type:"string" enum:"ObjectLockLegalHoldStatus"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ObjectLockLegalHold) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ObjectLockLegalHold) GoString() string {
- return s.String()
- }
- // SetStatus sets the Status field's value.
- func (s *ObjectLockLegalHold) SetStatus(v string) *ObjectLockLegalHold {
- s.Status = &v
- return s
- }
- // A Retention configuration for an object.
- type ObjectLockRetention struct {
- _ struct{} `type:"structure"`
- // Indicates the Retention mode for the specified object.
- Mode *string `type:"string" enum:"ObjectLockRetentionMode"`
- // The date on which this Object Lock Retention will expire.
- RetainUntilDate *time.Time `type:"timestamp" timestampFormat:"iso8601"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ObjectLockRetention) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ObjectLockRetention) GoString() string {
- return s.String()
- }
- // SetMode sets the Mode field's value.
- func (s *ObjectLockRetention) SetMode(v string) *ObjectLockRetention {
- s.Mode = &v
- return s
- }
- // SetRetainUntilDate sets the RetainUntilDate field's value.
- func (s *ObjectLockRetention) SetRetainUntilDate(v time.Time) *ObjectLockRetention {
- s.RetainUntilDate = &v
- return s
- }
- // The container element for an Object Lock rule.
- type ObjectLockRule struct {
- _ struct{} `type:"structure"`
- // The default Object Lock retention mode and period that you want to apply
- // to new objects placed in the specified bucket. Bucket settings require both
- // a mode and a period. The period can be either Days or Years but you must
- // select one. You cannot specify Days and Years at the same time.
- DefaultRetention *DefaultRetention `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ObjectLockRule) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ObjectLockRule) GoString() string {
- return s.String()
- }
- // SetDefaultRetention sets the DefaultRetention field's value.
- func (s *ObjectLockRule) SetDefaultRetention(v *DefaultRetention) *ObjectLockRule {
- s.DefaultRetention = v
- return s
- }
- // A container for elements related to an individual part.
- type ObjectPart struct {
- _ struct{} `type:"structure"`
- // This header can be used as a data integrity check to verify that the data
- // received is the same data that was originally sent. This header specifies
- // the base64-encoded, 32-bit CRC32 checksum of the object. For more information,
- // see Checking object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
- // in the Amazon S3 User Guide.
- ChecksumCRC32 *string `type:"string"`
- // The base64-encoded, 32-bit CRC32C checksum of the object. This will only
- // be present if it was uploaded with the object. With multipart uploads, this
- // may not be a checksum value of the object. For more information about how
- // checksums are calculated with multipart uploads, see Checking object integrity
- // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
- // in the Amazon S3 User Guide.
- ChecksumCRC32C *string `type:"string"`
- // The base64-encoded, 160-bit SHA-1 digest of the object. This will only be
- // present if it was uploaded with the object. With multipart uploads, this
- // may not be a checksum value of the object. For more information about how
- // checksums are calculated with multipart uploads, see Checking object integrity
- // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
- // in the Amazon S3 User Guide.
- ChecksumSHA1 *string `type:"string"`
- // The base64-encoded, 256-bit SHA-256 digest of the object. This will only
- // be present if it was uploaded with the object. With multipart uploads, this
- // may not be a checksum value of the object. For more information about how
- // checksums are calculated with multipart uploads, see Checking object integrity
- // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
- // in the Amazon S3 User Guide.
- ChecksumSHA256 *string `type:"string"`
- // The part number identifying the part. This value is a positive integer between
- // 1 and 10,000.
- PartNumber *int64 `type:"integer"`
- // The size of the uploaded part in bytes.
- Size *int64 `type:"integer"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ObjectPart) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ObjectPart) GoString() string {
- return s.String()
- }
- // SetChecksumCRC32 sets the ChecksumCRC32 field's value.
- func (s *ObjectPart) SetChecksumCRC32(v string) *ObjectPart {
- s.ChecksumCRC32 = &v
- return s
- }
- // SetChecksumCRC32C sets the ChecksumCRC32C field's value.
- func (s *ObjectPart) SetChecksumCRC32C(v string) *ObjectPart {
- s.ChecksumCRC32C = &v
- return s
- }
- // SetChecksumSHA1 sets the ChecksumSHA1 field's value.
- func (s *ObjectPart) SetChecksumSHA1(v string) *ObjectPart {
- s.ChecksumSHA1 = &v
- return s
- }
- // SetChecksumSHA256 sets the ChecksumSHA256 field's value.
- func (s *ObjectPart) SetChecksumSHA256(v string) *ObjectPart {
- s.ChecksumSHA256 = &v
- return s
- }
- // SetPartNumber sets the PartNumber field's value.
- func (s *ObjectPart) SetPartNumber(v int64) *ObjectPart {
- s.PartNumber = &v
- return s
- }
- // SetSize sets the Size field's value.
- func (s *ObjectPart) SetSize(v int64) *ObjectPart {
- s.Size = &v
- return s
- }
- // The version of an object.
- type ObjectVersion struct {
- _ struct{} `type:"structure"`
- // The algorithm that was used to create a checksum of the object.
- ChecksumAlgorithm []*string `type:"list" flattened:"true" enum:"ChecksumAlgorithm"`
- // The entity tag is an MD5 hash of that version of the object.
- ETag *string `type:"string"`
- // Specifies whether the object is (true) or is not (false) the latest version
- // of an object.
- IsLatest *bool `type:"boolean"`
- // The object key.
- Key *string `min:"1" type:"string"`
- // Date and time the object was last modified.
- LastModified *time.Time `type:"timestamp"`
- // Specifies the owner of the object.
- Owner *Owner `type:"structure"`
- // Size in bytes of the object.
- Size *int64 `type:"integer"`
- // The class of storage used to store the object.
- StorageClass *string `type:"string" enum:"ObjectVersionStorageClass"`
- // Version ID of an object.
- VersionId *string `type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ObjectVersion) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ObjectVersion) GoString() string {
- return s.String()
- }
- // SetChecksumAlgorithm sets the ChecksumAlgorithm field's value.
- func (s *ObjectVersion) SetChecksumAlgorithm(v []*string) *ObjectVersion {
- s.ChecksumAlgorithm = v
- return s
- }
- // SetETag sets the ETag field's value.
- func (s *ObjectVersion) SetETag(v string) *ObjectVersion {
- s.ETag = &v
- return s
- }
- // SetIsLatest sets the IsLatest field's value.
- func (s *ObjectVersion) SetIsLatest(v bool) *ObjectVersion {
- s.IsLatest = &v
- return s
- }
- // SetKey sets the Key field's value.
- func (s *ObjectVersion) SetKey(v string) *ObjectVersion {
- s.Key = &v
- return s
- }
- // SetLastModified sets the LastModified field's value.
- func (s *ObjectVersion) SetLastModified(v time.Time) *ObjectVersion {
- s.LastModified = &v
- return s
- }
- // SetOwner sets the Owner field's value.
- func (s *ObjectVersion) SetOwner(v *Owner) *ObjectVersion {
- s.Owner = v
- return s
- }
- // SetSize sets the Size field's value.
- func (s *ObjectVersion) SetSize(v int64) *ObjectVersion {
- s.Size = &v
- return s
- }
- // SetStorageClass sets the StorageClass field's value.
- func (s *ObjectVersion) SetStorageClass(v string) *ObjectVersion {
- s.StorageClass = &v
- return s
- }
- // SetVersionId sets the VersionId field's value.
- func (s *ObjectVersion) SetVersionId(v string) *ObjectVersion {
- s.VersionId = &v
- return s
- }
- // Describes the location where the restore job's output is stored.
- type OutputLocation struct {
- _ struct{} `type:"structure"`
- // Describes an S3 location that will receive the results of the restore request.
- S3 *Location `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s OutputLocation) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s OutputLocation) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *OutputLocation) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "OutputLocation"}
- if s.S3 != nil {
- if err := s.S3.Validate(); err != nil {
- invalidParams.AddNested("S3", err.(request.ErrInvalidParams))
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetS3 sets the S3 field's value.
- func (s *OutputLocation) SetS3(v *Location) *OutputLocation {
- s.S3 = v
- return s
- }
- // Describes how results of the Select job are serialized.
- type OutputSerialization struct {
- _ struct{} `type:"structure"`
- // Describes the serialization of CSV-encoded Select results.
- CSV *CSVOutput `type:"structure"`
- // Specifies JSON as request's output serialization format.
- JSON *JSONOutput `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s OutputSerialization) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s OutputSerialization) GoString() string {
- return s.String()
- }
- // SetCSV sets the CSV field's value.
- func (s *OutputSerialization) SetCSV(v *CSVOutput) *OutputSerialization {
- s.CSV = v
- return s
- }
- // SetJSON sets the JSON field's value.
- func (s *OutputSerialization) SetJSON(v *JSONOutput) *OutputSerialization {
- s.JSON = v
- return s
- }
- // Container for the owner's display name and ID.
- type Owner struct {
- _ struct{} `type:"structure"`
- // Container for the display name of the owner.
- DisplayName *string `type:"string"`
- // Container for the ID of the owner.
- ID *string `type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s Owner) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s Owner) GoString() string {
- return s.String()
- }
- // SetDisplayName sets the DisplayName field's value.
- func (s *Owner) SetDisplayName(v string) *Owner {
- s.DisplayName = &v
- return s
- }
- // SetID sets the ID field's value.
- func (s *Owner) SetID(v string) *Owner {
- s.ID = &v
- return s
- }
- // The container element for a bucket's ownership controls.
- type OwnershipControls struct {
- _ struct{} `type:"structure"`
- // The container element for an ownership control rule.
- //
- // Rules is a required field
- Rules []*OwnershipControlsRule `locationName:"Rule" type:"list" flattened:"true" required:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s OwnershipControls) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s OwnershipControls) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *OwnershipControls) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "OwnershipControls"}
- if s.Rules == nil {
- invalidParams.Add(request.NewErrParamRequired("Rules"))
- }
- if s.Rules != nil {
- for i, v := range s.Rules {
- if v == nil {
- continue
- }
- if err := v.Validate(); err != nil {
- invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Rules", i), err.(request.ErrInvalidParams))
- }
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetRules sets the Rules field's value.
- func (s *OwnershipControls) SetRules(v []*OwnershipControlsRule) *OwnershipControls {
- s.Rules = v
- return s
- }
- // The container element for an ownership control rule.
- type OwnershipControlsRule struct {
- _ struct{} `type:"structure"`
- // The container element for object ownership for a bucket's ownership controls.
- //
- // BucketOwnerPreferred - Objects uploaded to the bucket change ownership to
- // the bucket owner if the objects are uploaded with the bucket-owner-full-control
- // canned ACL.
- //
- // ObjectWriter - The uploading account will own the object if the object is
- // uploaded with the bucket-owner-full-control canned ACL.
- //
- // BucketOwnerEnforced - Access control lists (ACLs) are disabled and no longer
- // affect permissions. The bucket owner automatically owns and has full control
- // over every object in the bucket. The bucket only accepts PUT requests that
- // don't specify an ACL or bucket owner full control ACLs, such as the bucket-owner-full-control
- // canned ACL or an equivalent form of this ACL expressed in the XML format.
- //
- // ObjectOwnership is a required field
- ObjectOwnership *string `type:"string" required:"true" enum:"ObjectOwnership"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s OwnershipControlsRule) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s OwnershipControlsRule) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *OwnershipControlsRule) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "OwnershipControlsRule"}
- if s.ObjectOwnership == nil {
- invalidParams.Add(request.NewErrParamRequired("ObjectOwnership"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetObjectOwnership sets the ObjectOwnership field's value.
- func (s *OwnershipControlsRule) SetObjectOwnership(v string) *OwnershipControlsRule {
- s.ObjectOwnership = &v
- return s
- }
- // Container for Parquet.
- type ParquetInput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ParquetInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ParquetInput) GoString() string {
- return s.String()
- }
- // Container for elements related to a part.
- type Part struct {
- _ struct{} `type:"structure"`
- // This header can be used as a data integrity check to verify that the data
- // received is the same data that was originally sent. This header specifies
- // the base64-encoded, 32-bit CRC32 checksum of the object. For more information,
- // see Checking object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
- // in the Amazon S3 User Guide.
- ChecksumCRC32 *string `type:"string"`
- // The base64-encoded, 32-bit CRC32C checksum of the object. This will only
- // be present if it was uploaded with the object. With multipart uploads, this
- // may not be a checksum value of the object. For more information about how
- // checksums are calculated with multipart uploads, see Checking object integrity
- // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
- // in the Amazon S3 User Guide.
- ChecksumCRC32C *string `type:"string"`
- // The base64-encoded, 160-bit SHA-1 digest of the object. This will only be
- // present if it was uploaded with the object. With multipart uploads, this
- // may not be a checksum value of the object. For more information about how
- // checksums are calculated with multipart uploads, see Checking object integrity
- // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
- // in the Amazon S3 User Guide.
- ChecksumSHA1 *string `type:"string"`
- // This header can be used as a data integrity check to verify that the data
- // received is the same data that was originally sent. This header specifies
- // the base64-encoded, 256-bit SHA-256 digest of the object. For more information,
- // see Checking object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
- // in the Amazon S3 User Guide.
- ChecksumSHA256 *string `type:"string"`
- // Entity tag returned when the part was uploaded.
- ETag *string `type:"string"`
- // Date and time at which the part was uploaded.
- LastModified *time.Time `type:"timestamp"`
- // Part number identifying the part. This is a positive integer between 1 and
- // 10,000.
- PartNumber *int64 `type:"integer"`
- // Size in bytes of the uploaded part data.
- Size *int64 `type:"integer"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s Part) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s Part) GoString() string {
- return s.String()
- }
- // SetChecksumCRC32 sets the ChecksumCRC32 field's value.
- func (s *Part) SetChecksumCRC32(v string) *Part {
- s.ChecksumCRC32 = &v
- return s
- }
- // SetChecksumCRC32C sets the ChecksumCRC32C field's value.
- func (s *Part) SetChecksumCRC32C(v string) *Part {
- s.ChecksumCRC32C = &v
- return s
- }
- // SetChecksumSHA1 sets the ChecksumSHA1 field's value.
- func (s *Part) SetChecksumSHA1(v string) *Part {
- s.ChecksumSHA1 = &v
- return s
- }
- // SetChecksumSHA256 sets the ChecksumSHA256 field's value.
- func (s *Part) SetChecksumSHA256(v string) *Part {
- s.ChecksumSHA256 = &v
- return s
- }
- // SetETag sets the ETag field's value.
- func (s *Part) SetETag(v string) *Part {
- s.ETag = &v
- return s
- }
- // SetLastModified sets the LastModified field's value.
- func (s *Part) SetLastModified(v time.Time) *Part {
- s.LastModified = &v
- return s
- }
- // SetPartNumber sets the PartNumber field's value.
- func (s *Part) SetPartNumber(v int64) *Part {
- s.PartNumber = &v
- return s
- }
- // SetSize sets the Size field's value.
- func (s *Part) SetSize(v int64) *Part {
- s.Size = &v
- return s
- }
- // The container element for a bucket's policy status.
- type PolicyStatus struct {
- _ struct{} `type:"structure"`
- // The policy status for this bucket. TRUE indicates that this bucket is public.
- // FALSE indicates that the bucket is not public.
- IsPublic *bool `locationName:"IsPublic" type:"boolean"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PolicyStatus) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PolicyStatus) GoString() string {
- return s.String()
- }
- // SetIsPublic sets the IsPublic field's value.
- func (s *PolicyStatus) SetIsPublic(v bool) *PolicyStatus {
- s.IsPublic = &v
- return s
- }
- // This data type contains information about progress of an operation.
- type Progress struct {
- _ struct{} `type:"structure"`
- // The current number of uncompressed object bytes processed.
- BytesProcessed *int64 `type:"long"`
- // The current number of bytes of records payload data returned.
- BytesReturned *int64 `type:"long"`
- // The current number of object bytes scanned.
- BytesScanned *int64 `type:"long"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s Progress) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s Progress) GoString() string {
- return s.String()
- }
- // SetBytesProcessed sets the BytesProcessed field's value.
- func (s *Progress) SetBytesProcessed(v int64) *Progress {
- s.BytesProcessed = &v
- return s
- }
- // SetBytesReturned sets the BytesReturned field's value.
- func (s *Progress) SetBytesReturned(v int64) *Progress {
- s.BytesReturned = &v
- return s
- }
- // SetBytesScanned sets the BytesScanned field's value.
- func (s *Progress) SetBytesScanned(v int64) *Progress {
- s.BytesScanned = &v
- return s
- }
- // This data type contains information about the progress event of an operation.
- type ProgressEvent struct {
- _ struct{} `locationName:"ProgressEvent" type:"structure" payload:"Details"`
- // The Progress event details.
- Details *Progress `locationName:"Details" type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ProgressEvent) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ProgressEvent) GoString() string {
- return s.String()
- }
- // SetDetails sets the Details field's value.
- func (s *ProgressEvent) SetDetails(v *Progress) *ProgressEvent {
- s.Details = v
- return s
- }
- // The ProgressEvent is and event in the SelectObjectContentEventStream group of events.
- func (s *ProgressEvent) eventSelectObjectContentEventStream() {}
- // UnmarshalEvent unmarshals the EventStream Message into the ProgressEvent value.
- // This method is only used internally within the SDK's EventStream handling.
- func (s *ProgressEvent) UnmarshalEvent(
- payloadUnmarshaler protocol.PayloadUnmarshaler,
- msg eventstream.Message,
- ) error {
- if err := payloadUnmarshaler.UnmarshalPayload(
- bytes.NewReader(msg.Payload), s,
- ); err != nil {
- return err
- }
- return nil
- }
- // MarshalEvent marshals the type into an stream event value. This method
- // should only used internally within the SDK's EventStream handling.
- func (s *ProgressEvent) MarshalEvent(pm protocol.PayloadMarshaler) (msg eventstream.Message, err error) {
- msg.Headers.Set(eventstreamapi.MessageTypeHeader, eventstream.StringValue(eventstreamapi.EventMessageType))
- var buf bytes.Buffer
- if err = pm.MarshalPayload(&buf, s); err != nil {
- return eventstream.Message{}, err
- }
- msg.Payload = buf.Bytes()
- return msg, err
- }
- // The PublicAccessBlock configuration that you want to apply to this Amazon
- // S3 bucket. You can enable the configuration options in any combination. For
- // more information about when Amazon S3 considers a bucket or object public,
- // see The Meaning of "Public" (https://docs.aws.amazon.com/AmazonS3/latest/dev/access-control-block-public-access.html#access-control-block-public-access-policy-status)
- // in the Amazon S3 User Guide.
- type PublicAccessBlockConfiguration struct {
- _ struct{} `type:"structure"`
- // Specifies whether Amazon S3 should block public access control lists (ACLs)
- // for this bucket and objects in this bucket. Setting this element to TRUE
- // causes the following behavior:
- //
- // * PUT Bucket ACL and PUT Object ACL calls fail if the specified ACL is
- // public.
- //
- // * PUT Object calls fail if the request includes a public ACL.
- //
- // * PUT Bucket calls fail if the request includes a public ACL.
- //
- // Enabling this setting doesn't affect existing policies or ACLs.
- BlockPublicAcls *bool `locationName:"BlockPublicAcls" type:"boolean"`
- // Specifies whether Amazon S3 should block public bucket policies for this
- // bucket. Setting this element to TRUE causes Amazon S3 to reject calls to
- // PUT Bucket policy if the specified bucket policy allows public access.
- //
- // Enabling this setting doesn't affect existing bucket policies.
- BlockPublicPolicy *bool `locationName:"BlockPublicPolicy" type:"boolean"`
- // Specifies whether Amazon S3 should ignore public ACLs for this bucket and
- // objects in this bucket. Setting this element to TRUE causes Amazon S3 to
- // ignore all public ACLs on this bucket and objects in this bucket.
- //
- // Enabling this setting doesn't affect the persistence of any existing ACLs
- // and doesn't prevent new public ACLs from being set.
- IgnorePublicAcls *bool `locationName:"IgnorePublicAcls" type:"boolean"`
- // Specifies whether Amazon S3 should restrict public bucket policies for this
- // bucket. Setting this element to TRUE restricts access to this bucket to only
- // Amazon Web Service principals and authorized users within this account if
- // the bucket has a public policy.
- //
- // Enabling this setting doesn't affect previously stored bucket policies, except
- // that public and cross-account access within any public bucket policy, including
- // non-public delegation to specific accounts, is blocked.
- RestrictPublicBuckets *bool `locationName:"RestrictPublicBuckets" type:"boolean"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PublicAccessBlockConfiguration) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PublicAccessBlockConfiguration) GoString() string {
- return s.String()
- }
- // SetBlockPublicAcls sets the BlockPublicAcls field's value.
- func (s *PublicAccessBlockConfiguration) SetBlockPublicAcls(v bool) *PublicAccessBlockConfiguration {
- s.BlockPublicAcls = &v
- return s
- }
- // SetBlockPublicPolicy sets the BlockPublicPolicy field's value.
- func (s *PublicAccessBlockConfiguration) SetBlockPublicPolicy(v bool) *PublicAccessBlockConfiguration {
- s.BlockPublicPolicy = &v
- return s
- }
- // SetIgnorePublicAcls sets the IgnorePublicAcls field's value.
- func (s *PublicAccessBlockConfiguration) SetIgnorePublicAcls(v bool) *PublicAccessBlockConfiguration {
- s.IgnorePublicAcls = &v
- return s
- }
- // SetRestrictPublicBuckets sets the RestrictPublicBuckets field's value.
- func (s *PublicAccessBlockConfiguration) SetRestrictPublicBuckets(v bool) *PublicAccessBlockConfiguration {
- s.RestrictPublicBuckets = &v
- return s
- }
- type PutBucketAccelerateConfigurationInput struct {
- _ struct{} `locationName:"PutBucketAccelerateConfigurationRequest" type:"structure" payload:"AccelerateConfiguration"`
- // Container for setting the transfer acceleration state.
- //
- // AccelerateConfiguration is a required field
- AccelerateConfiguration *AccelerateConfiguration `locationName:"AccelerateConfiguration" type:"structure" required:"true" xmlURI:"http://s3.amazonaws.com/doc/2006-03-01/"`
- // The name of the bucket for which the accelerate configuration is set.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // Indicates the algorithm used to create the checksum for the object when using
- // the SDK. This header will not provide any additional functionality if not
- // using the SDK. When sending this header, there must be a corresponding x-amz-checksum
- // or x-amz-trailer header sent. Otherwise, Amazon S3 fails the request with
- // the HTTP status code 400 Bad Request. For more information, see Checking
- // object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
- // in the Amazon S3 User Guide.
- //
- // If you provide an individual checksum, Amazon S3 ignores any provided ChecksumAlgorithm
- // parameter.
- //
- // The AWS SDK for Go v1 does not support automatic computing request payload
- // checksum. This feature is available in the AWS SDK for Go v2. If a value
- // is specified for this parameter, the matching algorithm's checksum member
- // must be populated with the algorithm's checksum of the request payload.
- ChecksumAlgorithm *string `location:"header" locationName:"x-amz-sdk-checksum-algorithm" type:"string" enum:"ChecksumAlgorithm"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketAccelerateConfigurationInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketAccelerateConfigurationInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *PutBucketAccelerateConfigurationInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "PutBucketAccelerateConfigurationInput"}
- if s.AccelerateConfiguration == nil {
- invalidParams.Add(request.NewErrParamRequired("AccelerateConfiguration"))
- }
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetAccelerateConfiguration sets the AccelerateConfiguration field's value.
- func (s *PutBucketAccelerateConfigurationInput) SetAccelerateConfiguration(v *AccelerateConfiguration) *PutBucketAccelerateConfigurationInput {
- s.AccelerateConfiguration = v
- return s
- }
- // SetBucket sets the Bucket field's value.
- func (s *PutBucketAccelerateConfigurationInput) SetBucket(v string) *PutBucketAccelerateConfigurationInput {
- s.Bucket = &v
- return s
- }
- func (s *PutBucketAccelerateConfigurationInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetChecksumAlgorithm sets the ChecksumAlgorithm field's value.
- func (s *PutBucketAccelerateConfigurationInput) SetChecksumAlgorithm(v string) *PutBucketAccelerateConfigurationInput {
- s.ChecksumAlgorithm = &v
- return s
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *PutBucketAccelerateConfigurationInput) SetExpectedBucketOwner(v string) *PutBucketAccelerateConfigurationInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- func (s *PutBucketAccelerateConfigurationInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *PutBucketAccelerateConfigurationInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s PutBucketAccelerateConfigurationInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type PutBucketAccelerateConfigurationOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketAccelerateConfigurationOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketAccelerateConfigurationOutput) GoString() string {
- return s.String()
- }
- type PutBucketAclInput struct {
- _ struct{} `locationName:"PutBucketAclRequest" type:"structure" payload:"AccessControlPolicy"`
- // The canned ACL to apply to the bucket.
- ACL *string `location:"header" locationName:"x-amz-acl" type:"string" enum:"BucketCannedACL"`
- // Contains the elements that set the ACL permissions for an object per grantee.
- AccessControlPolicy *AccessControlPolicy `locationName:"AccessControlPolicy" type:"structure" xmlURI:"http://s3.amazonaws.com/doc/2006-03-01/"`
- // The bucket to which to apply the ACL.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // Indicates the algorithm used to create the checksum for the object when using
- // the SDK. This header will not provide any additional functionality if not
- // using the SDK. When sending this header, there must be a corresponding x-amz-checksum
- // or x-amz-trailer header sent. Otherwise, Amazon S3 fails the request with
- // the HTTP status code 400 Bad Request. For more information, see Checking
- // object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
- // in the Amazon S3 User Guide.
- //
- // If you provide an individual checksum, Amazon S3 ignores any provided ChecksumAlgorithm
- // parameter.
- //
- // The AWS SDK for Go v1 does not support automatic computing request payload
- // checksum. This feature is available in the AWS SDK for Go v2. If a value
- // is specified for this parameter, the matching algorithm's checksum member
- // must be populated with the algorithm's checksum of the request payload.
- //
- // The SDK will automatically compute the Content-MD5 checksum for this operation.
- // The AWS SDK for Go v2 allows you to configure alternative checksum algorithm
- // to be used.
- ChecksumAlgorithm *string `location:"header" locationName:"x-amz-sdk-checksum-algorithm" type:"string" enum:"ChecksumAlgorithm"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // Allows grantee the read, write, read ACP, and write ACP permissions on the
- // bucket.
- GrantFullControl *string `location:"header" locationName:"x-amz-grant-full-control" type:"string"`
- // Allows grantee to list the objects in the bucket.
- GrantRead *string `location:"header" locationName:"x-amz-grant-read" type:"string"`
- // Allows grantee to read the bucket ACL.
- GrantReadACP *string `location:"header" locationName:"x-amz-grant-read-acp" type:"string"`
- // Allows grantee to create new objects in the bucket.
- //
- // For the bucket and object owners of existing objects, also allows deletions
- // and overwrites of those objects.
- GrantWrite *string `location:"header" locationName:"x-amz-grant-write" type:"string"`
- // Allows grantee to write the ACL for the applicable bucket.
- GrantWriteACP *string `location:"header" locationName:"x-amz-grant-write-acp" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketAclInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketAclInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *PutBucketAclInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "PutBucketAclInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.AccessControlPolicy != nil {
- if err := s.AccessControlPolicy.Validate(); err != nil {
- invalidParams.AddNested("AccessControlPolicy", err.(request.ErrInvalidParams))
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetACL sets the ACL field's value.
- func (s *PutBucketAclInput) SetACL(v string) *PutBucketAclInput {
- s.ACL = &v
- return s
- }
- // SetAccessControlPolicy sets the AccessControlPolicy field's value.
- func (s *PutBucketAclInput) SetAccessControlPolicy(v *AccessControlPolicy) *PutBucketAclInput {
- s.AccessControlPolicy = v
- return s
- }
- // SetBucket sets the Bucket field's value.
- func (s *PutBucketAclInput) SetBucket(v string) *PutBucketAclInput {
- s.Bucket = &v
- return s
- }
- func (s *PutBucketAclInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetChecksumAlgorithm sets the ChecksumAlgorithm field's value.
- func (s *PutBucketAclInput) SetChecksumAlgorithm(v string) *PutBucketAclInput {
- s.ChecksumAlgorithm = &v
- return s
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *PutBucketAclInput) SetExpectedBucketOwner(v string) *PutBucketAclInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetGrantFullControl sets the GrantFullControl field's value.
- func (s *PutBucketAclInput) SetGrantFullControl(v string) *PutBucketAclInput {
- s.GrantFullControl = &v
- return s
- }
- // SetGrantRead sets the GrantRead field's value.
- func (s *PutBucketAclInput) SetGrantRead(v string) *PutBucketAclInput {
- s.GrantRead = &v
- return s
- }
- // SetGrantReadACP sets the GrantReadACP field's value.
- func (s *PutBucketAclInput) SetGrantReadACP(v string) *PutBucketAclInput {
- s.GrantReadACP = &v
- return s
- }
- // SetGrantWrite sets the GrantWrite field's value.
- func (s *PutBucketAclInput) SetGrantWrite(v string) *PutBucketAclInput {
- s.GrantWrite = &v
- return s
- }
- // SetGrantWriteACP sets the GrantWriteACP field's value.
- func (s *PutBucketAclInput) SetGrantWriteACP(v string) *PutBucketAclInput {
- s.GrantWriteACP = &v
- return s
- }
- func (s *PutBucketAclInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *PutBucketAclInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s PutBucketAclInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type PutBucketAclOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketAclOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketAclOutput) GoString() string {
- return s.String()
- }
- type PutBucketAnalyticsConfigurationInput struct {
- _ struct{} `locationName:"PutBucketAnalyticsConfigurationRequest" type:"structure" payload:"AnalyticsConfiguration"`
- // The configuration and any analyses for the analytics filter.
- //
- // AnalyticsConfiguration is a required field
- AnalyticsConfiguration *AnalyticsConfiguration `locationName:"AnalyticsConfiguration" type:"structure" required:"true" xmlURI:"http://s3.amazonaws.com/doc/2006-03-01/"`
- // The name of the bucket to which an analytics configuration is stored.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // The ID that identifies the analytics configuration.
- //
- // Id is a required field
- Id *string `location:"querystring" locationName:"id" type:"string" required:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketAnalyticsConfigurationInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketAnalyticsConfigurationInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *PutBucketAnalyticsConfigurationInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "PutBucketAnalyticsConfigurationInput"}
- if s.AnalyticsConfiguration == nil {
- invalidParams.Add(request.NewErrParamRequired("AnalyticsConfiguration"))
- }
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.Id == nil {
- invalidParams.Add(request.NewErrParamRequired("Id"))
- }
- if s.AnalyticsConfiguration != nil {
- if err := s.AnalyticsConfiguration.Validate(); err != nil {
- invalidParams.AddNested("AnalyticsConfiguration", err.(request.ErrInvalidParams))
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetAnalyticsConfiguration sets the AnalyticsConfiguration field's value.
- func (s *PutBucketAnalyticsConfigurationInput) SetAnalyticsConfiguration(v *AnalyticsConfiguration) *PutBucketAnalyticsConfigurationInput {
- s.AnalyticsConfiguration = v
- return s
- }
- // SetBucket sets the Bucket field's value.
- func (s *PutBucketAnalyticsConfigurationInput) SetBucket(v string) *PutBucketAnalyticsConfigurationInput {
- s.Bucket = &v
- return s
- }
- func (s *PutBucketAnalyticsConfigurationInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *PutBucketAnalyticsConfigurationInput) SetExpectedBucketOwner(v string) *PutBucketAnalyticsConfigurationInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetId sets the Id field's value.
- func (s *PutBucketAnalyticsConfigurationInput) SetId(v string) *PutBucketAnalyticsConfigurationInput {
- s.Id = &v
- return s
- }
- func (s *PutBucketAnalyticsConfigurationInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *PutBucketAnalyticsConfigurationInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s PutBucketAnalyticsConfigurationInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type PutBucketAnalyticsConfigurationOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketAnalyticsConfigurationOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketAnalyticsConfigurationOutput) GoString() string {
- return s.String()
- }
- type PutBucketCorsInput struct {
- _ struct{} `locationName:"PutBucketCorsRequest" type:"structure" payload:"CORSConfiguration"`
- // Specifies the bucket impacted by the corsconfiguration.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // Describes the cross-origin access configuration for objects in an Amazon
- // S3 bucket. For more information, see Enabling Cross-Origin Resource Sharing
- // (https://docs.aws.amazon.com/AmazonS3/latest/dev/cors.html) in the Amazon
- // S3 User Guide.
- //
- // CORSConfiguration is a required field
- CORSConfiguration *CORSConfiguration `locationName:"CORSConfiguration" type:"structure" required:"true" xmlURI:"http://s3.amazonaws.com/doc/2006-03-01/"`
- // Indicates the algorithm used to create the checksum for the object when using
- // the SDK. This header will not provide any additional functionality if not
- // using the SDK. When sending this header, there must be a corresponding x-amz-checksum
- // or x-amz-trailer header sent. Otherwise, Amazon S3 fails the request with
- // the HTTP status code 400 Bad Request. For more information, see Checking
- // object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
- // in the Amazon S3 User Guide.
- //
- // If you provide an individual checksum, Amazon S3 ignores any provided ChecksumAlgorithm
- // parameter.
- //
- // The AWS SDK for Go v1 does not support automatic computing request payload
- // checksum. This feature is available in the AWS SDK for Go v2. If a value
- // is specified for this parameter, the matching algorithm's checksum member
- // must be populated with the algorithm's checksum of the request payload.
- //
- // The SDK will automatically compute the Content-MD5 checksum for this operation.
- // The AWS SDK for Go v2 allows you to configure alternative checksum algorithm
- // to be used.
- ChecksumAlgorithm *string `location:"header" locationName:"x-amz-sdk-checksum-algorithm" type:"string" enum:"ChecksumAlgorithm"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketCorsInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketCorsInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *PutBucketCorsInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "PutBucketCorsInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.CORSConfiguration == nil {
- invalidParams.Add(request.NewErrParamRequired("CORSConfiguration"))
- }
- if s.CORSConfiguration != nil {
- if err := s.CORSConfiguration.Validate(); err != nil {
- invalidParams.AddNested("CORSConfiguration", err.(request.ErrInvalidParams))
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *PutBucketCorsInput) SetBucket(v string) *PutBucketCorsInput {
- s.Bucket = &v
- return s
- }
- func (s *PutBucketCorsInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetCORSConfiguration sets the CORSConfiguration field's value.
- func (s *PutBucketCorsInput) SetCORSConfiguration(v *CORSConfiguration) *PutBucketCorsInput {
- s.CORSConfiguration = v
- return s
- }
- // SetChecksumAlgorithm sets the ChecksumAlgorithm field's value.
- func (s *PutBucketCorsInput) SetChecksumAlgorithm(v string) *PutBucketCorsInput {
- s.ChecksumAlgorithm = &v
- return s
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *PutBucketCorsInput) SetExpectedBucketOwner(v string) *PutBucketCorsInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- func (s *PutBucketCorsInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *PutBucketCorsInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s PutBucketCorsInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type PutBucketCorsOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketCorsOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketCorsOutput) GoString() string {
- return s.String()
- }
- type PutBucketEncryptionInput struct {
- _ struct{} `locationName:"PutBucketEncryptionRequest" type:"structure" payload:"ServerSideEncryptionConfiguration"`
- // Specifies default encryption for a bucket using server-side encryption with
- // Amazon S3-managed keys (SSE-S3) or customer managed keys (SSE-KMS). For information
- // about the Amazon S3 default encryption feature, see Amazon S3 Default Bucket
- // Encryption (https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html)
- // in the Amazon S3 User Guide.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // Indicates the algorithm used to create the checksum for the object when using
- // the SDK. This header will not provide any additional functionality if not
- // using the SDK. When sending this header, there must be a corresponding x-amz-checksum
- // or x-amz-trailer header sent. Otherwise, Amazon S3 fails the request with
- // the HTTP status code 400 Bad Request. For more information, see Checking
- // object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
- // in the Amazon S3 User Guide.
- //
- // If you provide an individual checksum, Amazon S3 ignores any provided ChecksumAlgorithm
- // parameter.
- //
- // The AWS SDK for Go v1 does not support automatic computing request payload
- // checksum. This feature is available in the AWS SDK for Go v2. If a value
- // is specified for this parameter, the matching algorithm's checksum member
- // must be populated with the algorithm's checksum of the request payload.
- //
- // The SDK will automatically compute the Content-MD5 checksum for this operation.
- // The AWS SDK for Go v2 allows you to configure alternative checksum algorithm
- // to be used.
- ChecksumAlgorithm *string `location:"header" locationName:"x-amz-sdk-checksum-algorithm" type:"string" enum:"ChecksumAlgorithm"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // Specifies the default server-side-encryption configuration.
- //
- // ServerSideEncryptionConfiguration is a required field
- ServerSideEncryptionConfiguration *ServerSideEncryptionConfiguration `locationName:"ServerSideEncryptionConfiguration" type:"structure" required:"true" xmlURI:"http://s3.amazonaws.com/doc/2006-03-01/"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketEncryptionInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketEncryptionInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *PutBucketEncryptionInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "PutBucketEncryptionInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.ServerSideEncryptionConfiguration == nil {
- invalidParams.Add(request.NewErrParamRequired("ServerSideEncryptionConfiguration"))
- }
- if s.ServerSideEncryptionConfiguration != nil {
- if err := s.ServerSideEncryptionConfiguration.Validate(); err != nil {
- invalidParams.AddNested("ServerSideEncryptionConfiguration", err.(request.ErrInvalidParams))
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *PutBucketEncryptionInput) SetBucket(v string) *PutBucketEncryptionInput {
- s.Bucket = &v
- return s
- }
- func (s *PutBucketEncryptionInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetChecksumAlgorithm sets the ChecksumAlgorithm field's value.
- func (s *PutBucketEncryptionInput) SetChecksumAlgorithm(v string) *PutBucketEncryptionInput {
- s.ChecksumAlgorithm = &v
- return s
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *PutBucketEncryptionInput) SetExpectedBucketOwner(v string) *PutBucketEncryptionInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetServerSideEncryptionConfiguration sets the ServerSideEncryptionConfiguration field's value.
- func (s *PutBucketEncryptionInput) SetServerSideEncryptionConfiguration(v *ServerSideEncryptionConfiguration) *PutBucketEncryptionInput {
- s.ServerSideEncryptionConfiguration = v
- return s
- }
- func (s *PutBucketEncryptionInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *PutBucketEncryptionInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s PutBucketEncryptionInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type PutBucketEncryptionOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketEncryptionOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketEncryptionOutput) GoString() string {
- return s.String()
- }
- type PutBucketIntelligentTieringConfigurationInput struct {
- _ struct{} `locationName:"PutBucketIntelligentTieringConfigurationRequest" type:"structure" payload:"IntelligentTieringConfiguration"`
- // The name of the Amazon S3 bucket whose configuration you want to modify or
- // retrieve.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The ID used to identify the S3 Intelligent-Tiering configuration.
- //
- // Id is a required field
- Id *string `location:"querystring" locationName:"id" type:"string" required:"true"`
- // Container for S3 Intelligent-Tiering configuration.
- //
- // IntelligentTieringConfiguration is a required field
- IntelligentTieringConfiguration *IntelligentTieringConfiguration `locationName:"IntelligentTieringConfiguration" type:"structure" required:"true" xmlURI:"http://s3.amazonaws.com/doc/2006-03-01/"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketIntelligentTieringConfigurationInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketIntelligentTieringConfigurationInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *PutBucketIntelligentTieringConfigurationInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "PutBucketIntelligentTieringConfigurationInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.Id == nil {
- invalidParams.Add(request.NewErrParamRequired("Id"))
- }
- if s.IntelligentTieringConfiguration == nil {
- invalidParams.Add(request.NewErrParamRequired("IntelligentTieringConfiguration"))
- }
- if s.IntelligentTieringConfiguration != nil {
- if err := s.IntelligentTieringConfiguration.Validate(); err != nil {
- invalidParams.AddNested("IntelligentTieringConfiguration", err.(request.ErrInvalidParams))
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *PutBucketIntelligentTieringConfigurationInput) SetBucket(v string) *PutBucketIntelligentTieringConfigurationInput {
- s.Bucket = &v
- return s
- }
- func (s *PutBucketIntelligentTieringConfigurationInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetId sets the Id field's value.
- func (s *PutBucketIntelligentTieringConfigurationInput) SetId(v string) *PutBucketIntelligentTieringConfigurationInput {
- s.Id = &v
- return s
- }
- // SetIntelligentTieringConfiguration sets the IntelligentTieringConfiguration field's value.
- func (s *PutBucketIntelligentTieringConfigurationInput) SetIntelligentTieringConfiguration(v *IntelligentTieringConfiguration) *PutBucketIntelligentTieringConfigurationInput {
- s.IntelligentTieringConfiguration = v
- return s
- }
- func (s *PutBucketIntelligentTieringConfigurationInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *PutBucketIntelligentTieringConfigurationInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s PutBucketIntelligentTieringConfigurationInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type PutBucketIntelligentTieringConfigurationOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketIntelligentTieringConfigurationOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketIntelligentTieringConfigurationOutput) GoString() string {
- return s.String()
- }
- type PutBucketInventoryConfigurationInput struct {
- _ struct{} `locationName:"PutBucketInventoryConfigurationRequest" type:"structure" payload:"InventoryConfiguration"`
- // The name of the bucket where the inventory configuration will be stored.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // The ID used to identify the inventory configuration.
- //
- // Id is a required field
- Id *string `location:"querystring" locationName:"id" type:"string" required:"true"`
- // Specifies the inventory configuration.
- //
- // InventoryConfiguration is a required field
- InventoryConfiguration *InventoryConfiguration `locationName:"InventoryConfiguration" type:"structure" required:"true" xmlURI:"http://s3.amazonaws.com/doc/2006-03-01/"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketInventoryConfigurationInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketInventoryConfigurationInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *PutBucketInventoryConfigurationInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "PutBucketInventoryConfigurationInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.Id == nil {
- invalidParams.Add(request.NewErrParamRequired("Id"))
- }
- if s.InventoryConfiguration == nil {
- invalidParams.Add(request.NewErrParamRequired("InventoryConfiguration"))
- }
- if s.InventoryConfiguration != nil {
- if err := s.InventoryConfiguration.Validate(); err != nil {
- invalidParams.AddNested("InventoryConfiguration", err.(request.ErrInvalidParams))
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *PutBucketInventoryConfigurationInput) SetBucket(v string) *PutBucketInventoryConfigurationInput {
- s.Bucket = &v
- return s
- }
- func (s *PutBucketInventoryConfigurationInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *PutBucketInventoryConfigurationInput) SetExpectedBucketOwner(v string) *PutBucketInventoryConfigurationInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetId sets the Id field's value.
- func (s *PutBucketInventoryConfigurationInput) SetId(v string) *PutBucketInventoryConfigurationInput {
- s.Id = &v
- return s
- }
- // SetInventoryConfiguration sets the InventoryConfiguration field's value.
- func (s *PutBucketInventoryConfigurationInput) SetInventoryConfiguration(v *InventoryConfiguration) *PutBucketInventoryConfigurationInput {
- s.InventoryConfiguration = v
- return s
- }
- func (s *PutBucketInventoryConfigurationInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *PutBucketInventoryConfigurationInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s PutBucketInventoryConfigurationInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type PutBucketInventoryConfigurationOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketInventoryConfigurationOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketInventoryConfigurationOutput) GoString() string {
- return s.String()
- }
- type PutBucketLifecycleConfigurationInput struct {
- _ struct{} `locationName:"PutBucketLifecycleConfigurationRequest" type:"structure" payload:"LifecycleConfiguration"`
- // The name of the bucket for which to set the configuration.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // Indicates the algorithm used to create the checksum for the object when using
- // the SDK. This header will not provide any additional functionality if not
- // using the SDK. When sending this header, there must be a corresponding x-amz-checksum
- // or x-amz-trailer header sent. Otherwise, Amazon S3 fails the request with
- // the HTTP status code 400 Bad Request. For more information, see Checking
- // object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
- // in the Amazon S3 User Guide.
- //
- // If you provide an individual checksum, Amazon S3 ignores any provided ChecksumAlgorithm
- // parameter.
- //
- // The AWS SDK for Go v1 does not support automatic computing request payload
- // checksum. This feature is available in the AWS SDK for Go v2. If a value
- // is specified for this parameter, the matching algorithm's checksum member
- // must be populated with the algorithm's checksum of the request payload.
- //
- // The SDK will automatically compute the Content-MD5 checksum for this operation.
- // The AWS SDK for Go v2 allows you to configure alternative checksum algorithm
- // to be used.
- ChecksumAlgorithm *string `location:"header" locationName:"x-amz-sdk-checksum-algorithm" type:"string" enum:"ChecksumAlgorithm"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // Container for lifecycle rules. You can add as many as 1,000 rules.
- LifecycleConfiguration *BucketLifecycleConfiguration `locationName:"LifecycleConfiguration" type:"structure" xmlURI:"http://s3.amazonaws.com/doc/2006-03-01/"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketLifecycleConfigurationInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketLifecycleConfigurationInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *PutBucketLifecycleConfigurationInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "PutBucketLifecycleConfigurationInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.LifecycleConfiguration != nil {
- if err := s.LifecycleConfiguration.Validate(); err != nil {
- invalidParams.AddNested("LifecycleConfiguration", err.(request.ErrInvalidParams))
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *PutBucketLifecycleConfigurationInput) SetBucket(v string) *PutBucketLifecycleConfigurationInput {
- s.Bucket = &v
- return s
- }
- func (s *PutBucketLifecycleConfigurationInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetChecksumAlgorithm sets the ChecksumAlgorithm field's value.
- func (s *PutBucketLifecycleConfigurationInput) SetChecksumAlgorithm(v string) *PutBucketLifecycleConfigurationInput {
- s.ChecksumAlgorithm = &v
- return s
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *PutBucketLifecycleConfigurationInput) SetExpectedBucketOwner(v string) *PutBucketLifecycleConfigurationInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetLifecycleConfiguration sets the LifecycleConfiguration field's value.
- func (s *PutBucketLifecycleConfigurationInput) SetLifecycleConfiguration(v *BucketLifecycleConfiguration) *PutBucketLifecycleConfigurationInput {
- s.LifecycleConfiguration = v
- return s
- }
- func (s *PutBucketLifecycleConfigurationInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *PutBucketLifecycleConfigurationInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s PutBucketLifecycleConfigurationInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type PutBucketLifecycleConfigurationOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketLifecycleConfigurationOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketLifecycleConfigurationOutput) GoString() string {
- return s.String()
- }
- type PutBucketLifecycleInput struct {
- _ struct{} `locationName:"PutBucketLifecycleRequest" type:"structure" payload:"LifecycleConfiguration"`
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // Indicates the algorithm used to create the checksum for the object when using
- // the SDK. This header will not provide any additional functionality if not
- // using the SDK. When sending this header, there must be a corresponding x-amz-checksum
- // or x-amz-trailer header sent. Otherwise, Amazon S3 fails the request with
- // the HTTP status code 400 Bad Request. For more information, see Checking
- // object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
- // in the Amazon S3 User Guide.
- //
- // If you provide an individual checksum, Amazon S3 ignores any provided ChecksumAlgorithm
- // parameter.
- //
- // The AWS SDK for Go v1 does not support automatic computing request payload
- // checksum. This feature is available in the AWS SDK for Go v2. If a value
- // is specified for this parameter, the matching algorithm's checksum member
- // must be populated with the algorithm's checksum of the request payload.
- //
- // The SDK will automatically compute the Content-MD5 checksum for this operation.
- // The AWS SDK for Go v2 allows you to configure alternative checksum algorithm
- // to be used.
- ChecksumAlgorithm *string `location:"header" locationName:"x-amz-sdk-checksum-algorithm" type:"string" enum:"ChecksumAlgorithm"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // Container for lifecycle rules. You can add as many as 1000 rules.
- LifecycleConfiguration *LifecycleConfiguration `locationName:"LifecycleConfiguration" type:"structure" xmlURI:"http://s3.amazonaws.com/doc/2006-03-01/"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketLifecycleInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketLifecycleInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *PutBucketLifecycleInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "PutBucketLifecycleInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.LifecycleConfiguration != nil {
- if err := s.LifecycleConfiguration.Validate(); err != nil {
- invalidParams.AddNested("LifecycleConfiguration", err.(request.ErrInvalidParams))
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *PutBucketLifecycleInput) SetBucket(v string) *PutBucketLifecycleInput {
- s.Bucket = &v
- return s
- }
- func (s *PutBucketLifecycleInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetChecksumAlgorithm sets the ChecksumAlgorithm field's value.
- func (s *PutBucketLifecycleInput) SetChecksumAlgorithm(v string) *PutBucketLifecycleInput {
- s.ChecksumAlgorithm = &v
- return s
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *PutBucketLifecycleInput) SetExpectedBucketOwner(v string) *PutBucketLifecycleInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetLifecycleConfiguration sets the LifecycleConfiguration field's value.
- func (s *PutBucketLifecycleInput) SetLifecycleConfiguration(v *LifecycleConfiguration) *PutBucketLifecycleInput {
- s.LifecycleConfiguration = v
- return s
- }
- func (s *PutBucketLifecycleInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *PutBucketLifecycleInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s PutBucketLifecycleInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type PutBucketLifecycleOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketLifecycleOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketLifecycleOutput) GoString() string {
- return s.String()
- }
- type PutBucketLoggingInput struct {
- _ struct{} `locationName:"PutBucketLoggingRequest" type:"structure" payload:"BucketLoggingStatus"`
- // The name of the bucket for which to set the logging parameters.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // Container for logging status information.
- //
- // BucketLoggingStatus is a required field
- BucketLoggingStatus *BucketLoggingStatus `locationName:"BucketLoggingStatus" type:"structure" required:"true" xmlURI:"http://s3.amazonaws.com/doc/2006-03-01/"`
- // Indicates the algorithm used to create the checksum for the object when using
- // the SDK. This header will not provide any additional functionality if not
- // using the SDK. When sending this header, there must be a corresponding x-amz-checksum
- // or x-amz-trailer header sent. Otherwise, Amazon S3 fails the request with
- // the HTTP status code 400 Bad Request. For more information, see Checking
- // object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
- // in the Amazon S3 User Guide.
- //
- // If you provide an individual checksum, Amazon S3 ignores any provided ChecksumAlgorithm
- // parameter.
- //
- // The AWS SDK for Go v1 does not support automatic computing request payload
- // checksum. This feature is available in the AWS SDK for Go v2. If a value
- // is specified for this parameter, the matching algorithm's checksum member
- // must be populated with the algorithm's checksum of the request payload.
- //
- // The SDK will automatically compute the Content-MD5 checksum for this operation.
- // The AWS SDK for Go v2 allows you to configure alternative checksum algorithm
- // to be used.
- ChecksumAlgorithm *string `location:"header" locationName:"x-amz-sdk-checksum-algorithm" type:"string" enum:"ChecksumAlgorithm"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketLoggingInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketLoggingInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *PutBucketLoggingInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "PutBucketLoggingInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.BucketLoggingStatus == nil {
- invalidParams.Add(request.NewErrParamRequired("BucketLoggingStatus"))
- }
- if s.BucketLoggingStatus != nil {
- if err := s.BucketLoggingStatus.Validate(); err != nil {
- invalidParams.AddNested("BucketLoggingStatus", err.(request.ErrInvalidParams))
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *PutBucketLoggingInput) SetBucket(v string) *PutBucketLoggingInput {
- s.Bucket = &v
- return s
- }
- func (s *PutBucketLoggingInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetBucketLoggingStatus sets the BucketLoggingStatus field's value.
- func (s *PutBucketLoggingInput) SetBucketLoggingStatus(v *BucketLoggingStatus) *PutBucketLoggingInput {
- s.BucketLoggingStatus = v
- return s
- }
- // SetChecksumAlgorithm sets the ChecksumAlgorithm field's value.
- func (s *PutBucketLoggingInput) SetChecksumAlgorithm(v string) *PutBucketLoggingInput {
- s.ChecksumAlgorithm = &v
- return s
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *PutBucketLoggingInput) SetExpectedBucketOwner(v string) *PutBucketLoggingInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- func (s *PutBucketLoggingInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *PutBucketLoggingInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s PutBucketLoggingInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type PutBucketLoggingOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketLoggingOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketLoggingOutput) GoString() string {
- return s.String()
- }
- type PutBucketMetricsConfigurationInput struct {
- _ struct{} `locationName:"PutBucketMetricsConfigurationRequest" type:"structure" payload:"MetricsConfiguration"`
- // The name of the bucket for which the metrics configuration is set.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // The ID used to identify the metrics configuration.
- //
- // Id is a required field
- Id *string `location:"querystring" locationName:"id" type:"string" required:"true"`
- // Specifies the metrics configuration.
- //
- // MetricsConfiguration is a required field
- MetricsConfiguration *MetricsConfiguration `locationName:"MetricsConfiguration" type:"structure" required:"true" xmlURI:"http://s3.amazonaws.com/doc/2006-03-01/"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketMetricsConfigurationInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketMetricsConfigurationInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *PutBucketMetricsConfigurationInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "PutBucketMetricsConfigurationInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.Id == nil {
- invalidParams.Add(request.NewErrParamRequired("Id"))
- }
- if s.MetricsConfiguration == nil {
- invalidParams.Add(request.NewErrParamRequired("MetricsConfiguration"))
- }
- if s.MetricsConfiguration != nil {
- if err := s.MetricsConfiguration.Validate(); err != nil {
- invalidParams.AddNested("MetricsConfiguration", err.(request.ErrInvalidParams))
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *PutBucketMetricsConfigurationInput) SetBucket(v string) *PutBucketMetricsConfigurationInput {
- s.Bucket = &v
- return s
- }
- func (s *PutBucketMetricsConfigurationInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *PutBucketMetricsConfigurationInput) SetExpectedBucketOwner(v string) *PutBucketMetricsConfigurationInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetId sets the Id field's value.
- func (s *PutBucketMetricsConfigurationInput) SetId(v string) *PutBucketMetricsConfigurationInput {
- s.Id = &v
- return s
- }
- // SetMetricsConfiguration sets the MetricsConfiguration field's value.
- func (s *PutBucketMetricsConfigurationInput) SetMetricsConfiguration(v *MetricsConfiguration) *PutBucketMetricsConfigurationInput {
- s.MetricsConfiguration = v
- return s
- }
- func (s *PutBucketMetricsConfigurationInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *PutBucketMetricsConfigurationInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s PutBucketMetricsConfigurationInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type PutBucketMetricsConfigurationOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketMetricsConfigurationOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketMetricsConfigurationOutput) GoString() string {
- return s.String()
- }
- type PutBucketNotificationConfigurationInput struct {
- _ struct{} `locationName:"PutBucketNotificationConfigurationRequest" type:"structure" payload:"NotificationConfiguration"`
- // The name of the bucket.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // A container for specifying the notification configuration of the bucket.
- // If this element is empty, notifications are turned off for the bucket.
- //
- // NotificationConfiguration is a required field
- NotificationConfiguration *NotificationConfiguration `locationName:"NotificationConfiguration" type:"structure" required:"true" xmlURI:"http://s3.amazonaws.com/doc/2006-03-01/"`
- // Skips validation of Amazon SQS, Amazon SNS, and Lambda destinations. True
- // or false value.
- SkipDestinationValidation *bool `location:"header" locationName:"x-amz-skip-destination-validation" type:"boolean"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketNotificationConfigurationInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketNotificationConfigurationInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *PutBucketNotificationConfigurationInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "PutBucketNotificationConfigurationInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.NotificationConfiguration == nil {
- invalidParams.Add(request.NewErrParamRequired("NotificationConfiguration"))
- }
- if s.NotificationConfiguration != nil {
- if err := s.NotificationConfiguration.Validate(); err != nil {
- invalidParams.AddNested("NotificationConfiguration", err.(request.ErrInvalidParams))
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *PutBucketNotificationConfigurationInput) SetBucket(v string) *PutBucketNotificationConfigurationInput {
- s.Bucket = &v
- return s
- }
- func (s *PutBucketNotificationConfigurationInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *PutBucketNotificationConfigurationInput) SetExpectedBucketOwner(v string) *PutBucketNotificationConfigurationInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetNotificationConfiguration sets the NotificationConfiguration field's value.
- func (s *PutBucketNotificationConfigurationInput) SetNotificationConfiguration(v *NotificationConfiguration) *PutBucketNotificationConfigurationInput {
- s.NotificationConfiguration = v
- return s
- }
- // SetSkipDestinationValidation sets the SkipDestinationValidation field's value.
- func (s *PutBucketNotificationConfigurationInput) SetSkipDestinationValidation(v bool) *PutBucketNotificationConfigurationInput {
- s.SkipDestinationValidation = &v
- return s
- }
- func (s *PutBucketNotificationConfigurationInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *PutBucketNotificationConfigurationInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s PutBucketNotificationConfigurationInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type PutBucketNotificationConfigurationOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketNotificationConfigurationOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketNotificationConfigurationOutput) GoString() string {
- return s.String()
- }
- type PutBucketNotificationInput struct {
- _ struct{} `locationName:"PutBucketNotificationRequest" type:"structure" payload:"NotificationConfiguration"`
- // The name of the bucket.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // Indicates the algorithm used to create the checksum for the object when using
- // the SDK. This header will not provide any additional functionality if not
- // using the SDK. When sending this header, there must be a corresponding x-amz-checksum
- // or x-amz-trailer header sent. Otherwise, Amazon S3 fails the request with
- // the HTTP status code 400 Bad Request. For more information, see Checking
- // object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
- // in the Amazon S3 User Guide.
- //
- // If you provide an individual checksum, Amazon S3 ignores any provided ChecksumAlgorithm
- // parameter.
- //
- // The AWS SDK for Go v1 does not support automatic computing request payload
- // checksum. This feature is available in the AWS SDK for Go v2. If a value
- // is specified for this parameter, the matching algorithm's checksum member
- // must be populated with the algorithm's checksum of the request payload.
- //
- // The SDK will automatically compute the Content-MD5 checksum for this operation.
- // The AWS SDK for Go v2 allows you to configure alternative checksum algorithm
- // to be used.
- ChecksumAlgorithm *string `location:"header" locationName:"x-amz-sdk-checksum-algorithm" type:"string" enum:"ChecksumAlgorithm"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // The container for the configuration.
- //
- // NotificationConfiguration is a required field
- NotificationConfiguration *NotificationConfigurationDeprecated `locationName:"NotificationConfiguration" type:"structure" required:"true" xmlURI:"http://s3.amazonaws.com/doc/2006-03-01/"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketNotificationInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketNotificationInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *PutBucketNotificationInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "PutBucketNotificationInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.NotificationConfiguration == nil {
- invalidParams.Add(request.NewErrParamRequired("NotificationConfiguration"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *PutBucketNotificationInput) SetBucket(v string) *PutBucketNotificationInput {
- s.Bucket = &v
- return s
- }
- func (s *PutBucketNotificationInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetChecksumAlgorithm sets the ChecksumAlgorithm field's value.
- func (s *PutBucketNotificationInput) SetChecksumAlgorithm(v string) *PutBucketNotificationInput {
- s.ChecksumAlgorithm = &v
- return s
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *PutBucketNotificationInput) SetExpectedBucketOwner(v string) *PutBucketNotificationInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetNotificationConfiguration sets the NotificationConfiguration field's value.
- func (s *PutBucketNotificationInput) SetNotificationConfiguration(v *NotificationConfigurationDeprecated) *PutBucketNotificationInput {
- s.NotificationConfiguration = v
- return s
- }
- func (s *PutBucketNotificationInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *PutBucketNotificationInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s PutBucketNotificationInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type PutBucketNotificationOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketNotificationOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketNotificationOutput) GoString() string {
- return s.String()
- }
- type PutBucketOwnershipControlsInput struct {
- _ struct{} `locationName:"PutBucketOwnershipControlsRequest" type:"structure" payload:"OwnershipControls"`
- // The name of the Amazon S3 bucket whose OwnershipControls you want to set.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // The OwnershipControls (BucketOwnerEnforced, BucketOwnerPreferred, or ObjectWriter)
- // that you want to apply to this Amazon S3 bucket.
- //
- // OwnershipControls is a required field
- OwnershipControls *OwnershipControls `locationName:"OwnershipControls" type:"structure" required:"true" xmlURI:"http://s3.amazonaws.com/doc/2006-03-01/"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketOwnershipControlsInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketOwnershipControlsInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *PutBucketOwnershipControlsInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "PutBucketOwnershipControlsInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.OwnershipControls == nil {
- invalidParams.Add(request.NewErrParamRequired("OwnershipControls"))
- }
- if s.OwnershipControls != nil {
- if err := s.OwnershipControls.Validate(); err != nil {
- invalidParams.AddNested("OwnershipControls", err.(request.ErrInvalidParams))
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *PutBucketOwnershipControlsInput) SetBucket(v string) *PutBucketOwnershipControlsInput {
- s.Bucket = &v
- return s
- }
- func (s *PutBucketOwnershipControlsInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *PutBucketOwnershipControlsInput) SetExpectedBucketOwner(v string) *PutBucketOwnershipControlsInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetOwnershipControls sets the OwnershipControls field's value.
- func (s *PutBucketOwnershipControlsInput) SetOwnershipControls(v *OwnershipControls) *PutBucketOwnershipControlsInput {
- s.OwnershipControls = v
- return s
- }
- func (s *PutBucketOwnershipControlsInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *PutBucketOwnershipControlsInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s PutBucketOwnershipControlsInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type PutBucketOwnershipControlsOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketOwnershipControlsOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketOwnershipControlsOutput) GoString() string {
- return s.String()
- }
- type PutBucketPolicyInput struct {
- _ struct{} `locationName:"PutBucketPolicyRequest" type:"structure" payload:"Policy"`
- // The name of the bucket.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // Indicates the algorithm used to create the checksum for the object when using
- // the SDK. This header will not provide any additional functionality if not
- // using the SDK. When sending this header, there must be a corresponding x-amz-checksum
- // or x-amz-trailer header sent. Otherwise, Amazon S3 fails the request with
- // the HTTP status code 400 Bad Request. For more information, see Checking
- // object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
- // in the Amazon S3 User Guide.
- //
- // If you provide an individual checksum, Amazon S3 ignores any provided ChecksumAlgorithm
- // parameter.
- //
- // The AWS SDK for Go v1 does not support automatic computing request payload
- // checksum. This feature is available in the AWS SDK for Go v2. If a value
- // is specified for this parameter, the matching algorithm's checksum member
- // must be populated with the algorithm's checksum of the request payload.
- //
- // The SDK will automatically compute the Content-MD5 checksum for this operation.
- // The AWS SDK for Go v2 allows you to configure alternative checksum algorithm
- // to be used.
- ChecksumAlgorithm *string `location:"header" locationName:"x-amz-sdk-checksum-algorithm" type:"string" enum:"ChecksumAlgorithm"`
- // Set this parameter to true to confirm that you want to remove your permissions
- // to change this bucket policy in the future.
- ConfirmRemoveSelfBucketAccess *bool `location:"header" locationName:"x-amz-confirm-remove-self-bucket-access" type:"boolean"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // The bucket policy as a JSON document.
- //
- // Policy is a required field
- Policy *string `type:"string" required:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketPolicyInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketPolicyInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *PutBucketPolicyInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "PutBucketPolicyInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.Policy == nil {
- invalidParams.Add(request.NewErrParamRequired("Policy"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *PutBucketPolicyInput) SetBucket(v string) *PutBucketPolicyInput {
- s.Bucket = &v
- return s
- }
- func (s *PutBucketPolicyInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetChecksumAlgorithm sets the ChecksumAlgorithm field's value.
- func (s *PutBucketPolicyInput) SetChecksumAlgorithm(v string) *PutBucketPolicyInput {
- s.ChecksumAlgorithm = &v
- return s
- }
- // SetConfirmRemoveSelfBucketAccess sets the ConfirmRemoveSelfBucketAccess field's value.
- func (s *PutBucketPolicyInput) SetConfirmRemoveSelfBucketAccess(v bool) *PutBucketPolicyInput {
- s.ConfirmRemoveSelfBucketAccess = &v
- return s
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *PutBucketPolicyInput) SetExpectedBucketOwner(v string) *PutBucketPolicyInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetPolicy sets the Policy field's value.
- func (s *PutBucketPolicyInput) SetPolicy(v string) *PutBucketPolicyInput {
- s.Policy = &v
- return s
- }
- func (s *PutBucketPolicyInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *PutBucketPolicyInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s PutBucketPolicyInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type PutBucketPolicyOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketPolicyOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketPolicyOutput) GoString() string {
- return s.String()
- }
- type PutBucketReplicationInput struct {
- _ struct{} `locationName:"PutBucketReplicationRequest" type:"structure" payload:"ReplicationConfiguration"`
- // The name of the bucket
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // Indicates the algorithm used to create the checksum for the object when using
- // the SDK. This header will not provide any additional functionality if not
- // using the SDK. When sending this header, there must be a corresponding x-amz-checksum
- // or x-amz-trailer header sent. Otherwise, Amazon S3 fails the request with
- // the HTTP status code 400 Bad Request. For more information, see Checking
- // object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
- // in the Amazon S3 User Guide.
- //
- // If you provide an individual checksum, Amazon S3 ignores any provided ChecksumAlgorithm
- // parameter.
- //
- // The AWS SDK for Go v1 does not support automatic computing request payload
- // checksum. This feature is available in the AWS SDK for Go v2. If a value
- // is specified for this parameter, the matching algorithm's checksum member
- // must be populated with the algorithm's checksum of the request payload.
- //
- // The SDK will automatically compute the Content-MD5 checksum for this operation.
- // The AWS SDK for Go v2 allows you to configure alternative checksum algorithm
- // to be used.
- ChecksumAlgorithm *string `location:"header" locationName:"x-amz-sdk-checksum-algorithm" type:"string" enum:"ChecksumAlgorithm"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // A container for replication rules. You can add up to 1,000 rules. The maximum
- // size of a replication configuration is 2 MB.
- //
- // ReplicationConfiguration is a required field
- ReplicationConfiguration *ReplicationConfiguration `locationName:"ReplicationConfiguration" type:"structure" required:"true" xmlURI:"http://s3.amazonaws.com/doc/2006-03-01/"`
- // A token to allow Object Lock to be enabled for an existing bucket.
- Token *string `location:"header" locationName:"x-amz-bucket-object-lock-token" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketReplicationInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketReplicationInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *PutBucketReplicationInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "PutBucketReplicationInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.ReplicationConfiguration == nil {
- invalidParams.Add(request.NewErrParamRequired("ReplicationConfiguration"))
- }
- if s.ReplicationConfiguration != nil {
- if err := s.ReplicationConfiguration.Validate(); err != nil {
- invalidParams.AddNested("ReplicationConfiguration", err.(request.ErrInvalidParams))
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *PutBucketReplicationInput) SetBucket(v string) *PutBucketReplicationInput {
- s.Bucket = &v
- return s
- }
- func (s *PutBucketReplicationInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetChecksumAlgorithm sets the ChecksumAlgorithm field's value.
- func (s *PutBucketReplicationInput) SetChecksumAlgorithm(v string) *PutBucketReplicationInput {
- s.ChecksumAlgorithm = &v
- return s
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *PutBucketReplicationInput) SetExpectedBucketOwner(v string) *PutBucketReplicationInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetReplicationConfiguration sets the ReplicationConfiguration field's value.
- func (s *PutBucketReplicationInput) SetReplicationConfiguration(v *ReplicationConfiguration) *PutBucketReplicationInput {
- s.ReplicationConfiguration = v
- return s
- }
- // SetToken sets the Token field's value.
- func (s *PutBucketReplicationInput) SetToken(v string) *PutBucketReplicationInput {
- s.Token = &v
- return s
- }
- func (s *PutBucketReplicationInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *PutBucketReplicationInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s PutBucketReplicationInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type PutBucketReplicationOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketReplicationOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketReplicationOutput) GoString() string {
- return s.String()
- }
- type PutBucketRequestPaymentInput struct {
- _ struct{} `locationName:"PutBucketRequestPaymentRequest" type:"structure" payload:"RequestPaymentConfiguration"`
- // The bucket name.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // Indicates the algorithm used to create the checksum for the object when using
- // the SDK. This header will not provide any additional functionality if not
- // using the SDK. When sending this header, there must be a corresponding x-amz-checksum
- // or x-amz-trailer header sent. Otherwise, Amazon S3 fails the request with
- // the HTTP status code 400 Bad Request. For more information, see Checking
- // object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
- // in the Amazon S3 User Guide.
- //
- // If you provide an individual checksum, Amazon S3 ignores any provided ChecksumAlgorithm
- // parameter.
- //
- // The AWS SDK for Go v1 does not support automatic computing request payload
- // checksum. This feature is available in the AWS SDK for Go v2. If a value
- // is specified for this parameter, the matching algorithm's checksum member
- // must be populated with the algorithm's checksum of the request payload.
- //
- // The SDK will automatically compute the Content-MD5 checksum for this operation.
- // The AWS SDK for Go v2 allows you to configure alternative checksum algorithm
- // to be used.
- ChecksumAlgorithm *string `location:"header" locationName:"x-amz-sdk-checksum-algorithm" type:"string" enum:"ChecksumAlgorithm"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // Container for Payer.
- //
- // RequestPaymentConfiguration is a required field
- RequestPaymentConfiguration *RequestPaymentConfiguration `locationName:"RequestPaymentConfiguration" type:"structure" required:"true" xmlURI:"http://s3.amazonaws.com/doc/2006-03-01/"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketRequestPaymentInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketRequestPaymentInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *PutBucketRequestPaymentInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "PutBucketRequestPaymentInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.RequestPaymentConfiguration == nil {
- invalidParams.Add(request.NewErrParamRequired("RequestPaymentConfiguration"))
- }
- if s.RequestPaymentConfiguration != nil {
- if err := s.RequestPaymentConfiguration.Validate(); err != nil {
- invalidParams.AddNested("RequestPaymentConfiguration", err.(request.ErrInvalidParams))
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *PutBucketRequestPaymentInput) SetBucket(v string) *PutBucketRequestPaymentInput {
- s.Bucket = &v
- return s
- }
- func (s *PutBucketRequestPaymentInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetChecksumAlgorithm sets the ChecksumAlgorithm field's value.
- func (s *PutBucketRequestPaymentInput) SetChecksumAlgorithm(v string) *PutBucketRequestPaymentInput {
- s.ChecksumAlgorithm = &v
- return s
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *PutBucketRequestPaymentInput) SetExpectedBucketOwner(v string) *PutBucketRequestPaymentInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetRequestPaymentConfiguration sets the RequestPaymentConfiguration field's value.
- func (s *PutBucketRequestPaymentInput) SetRequestPaymentConfiguration(v *RequestPaymentConfiguration) *PutBucketRequestPaymentInput {
- s.RequestPaymentConfiguration = v
- return s
- }
- func (s *PutBucketRequestPaymentInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *PutBucketRequestPaymentInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s PutBucketRequestPaymentInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type PutBucketRequestPaymentOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketRequestPaymentOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketRequestPaymentOutput) GoString() string {
- return s.String()
- }
- type PutBucketTaggingInput struct {
- _ struct{} `locationName:"PutBucketTaggingRequest" type:"structure" payload:"Tagging"`
- // The bucket name.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // Indicates the algorithm used to create the checksum for the object when using
- // the SDK. This header will not provide any additional functionality if not
- // using the SDK. When sending this header, there must be a corresponding x-amz-checksum
- // or x-amz-trailer header sent. Otherwise, Amazon S3 fails the request with
- // the HTTP status code 400 Bad Request. For more information, see Checking
- // object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
- // in the Amazon S3 User Guide.
- //
- // If you provide an individual checksum, Amazon S3 ignores any provided ChecksumAlgorithm
- // parameter.
- //
- // The AWS SDK for Go v1 does not support automatic computing request payload
- // checksum. This feature is available in the AWS SDK for Go v2. If a value
- // is specified for this parameter, the matching algorithm's checksum member
- // must be populated with the algorithm's checksum of the request payload.
- //
- // The SDK will automatically compute the Content-MD5 checksum for this operation.
- // The AWS SDK for Go v2 allows you to configure alternative checksum algorithm
- // to be used.
- ChecksumAlgorithm *string `location:"header" locationName:"x-amz-sdk-checksum-algorithm" type:"string" enum:"ChecksumAlgorithm"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // Container for the TagSet and Tag elements.
- //
- // Tagging is a required field
- Tagging *Tagging `locationName:"Tagging" type:"structure" required:"true" xmlURI:"http://s3.amazonaws.com/doc/2006-03-01/"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketTaggingInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketTaggingInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *PutBucketTaggingInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "PutBucketTaggingInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.Tagging == nil {
- invalidParams.Add(request.NewErrParamRequired("Tagging"))
- }
- if s.Tagging != nil {
- if err := s.Tagging.Validate(); err != nil {
- invalidParams.AddNested("Tagging", err.(request.ErrInvalidParams))
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *PutBucketTaggingInput) SetBucket(v string) *PutBucketTaggingInput {
- s.Bucket = &v
- return s
- }
- func (s *PutBucketTaggingInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetChecksumAlgorithm sets the ChecksumAlgorithm field's value.
- func (s *PutBucketTaggingInput) SetChecksumAlgorithm(v string) *PutBucketTaggingInput {
- s.ChecksumAlgorithm = &v
- return s
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *PutBucketTaggingInput) SetExpectedBucketOwner(v string) *PutBucketTaggingInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetTagging sets the Tagging field's value.
- func (s *PutBucketTaggingInput) SetTagging(v *Tagging) *PutBucketTaggingInput {
- s.Tagging = v
- return s
- }
- func (s *PutBucketTaggingInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *PutBucketTaggingInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s PutBucketTaggingInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type PutBucketTaggingOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketTaggingOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketTaggingOutput) GoString() string {
- return s.String()
- }
- type PutBucketVersioningInput struct {
- _ struct{} `locationName:"PutBucketVersioningRequest" type:"structure" payload:"VersioningConfiguration"`
- // The bucket name.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // Indicates the algorithm used to create the checksum for the object when using
- // the SDK. This header will not provide any additional functionality if not
- // using the SDK. When sending this header, there must be a corresponding x-amz-checksum
- // or x-amz-trailer header sent. Otherwise, Amazon S3 fails the request with
- // the HTTP status code 400 Bad Request. For more information, see Checking
- // object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
- // in the Amazon S3 User Guide.
- //
- // If you provide an individual checksum, Amazon S3 ignores any provided ChecksumAlgorithm
- // parameter.
- //
- // The AWS SDK for Go v1 does not support automatic computing request payload
- // checksum. This feature is available in the AWS SDK for Go v2. If a value
- // is specified for this parameter, the matching algorithm's checksum member
- // must be populated with the algorithm's checksum of the request payload.
- //
- // The SDK will automatically compute the Content-MD5 checksum for this operation.
- // The AWS SDK for Go v2 allows you to configure alternative checksum algorithm
- // to be used.
- ChecksumAlgorithm *string `location:"header" locationName:"x-amz-sdk-checksum-algorithm" type:"string" enum:"ChecksumAlgorithm"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // The concatenation of the authentication device's serial number, a space,
- // and the value that is displayed on your authentication device.
- MFA *string `location:"header" locationName:"x-amz-mfa" type:"string"`
- // Container for setting the versioning state.
- //
- // VersioningConfiguration is a required field
- VersioningConfiguration *VersioningConfiguration `locationName:"VersioningConfiguration" type:"structure" required:"true" xmlURI:"http://s3.amazonaws.com/doc/2006-03-01/"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketVersioningInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketVersioningInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *PutBucketVersioningInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "PutBucketVersioningInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.VersioningConfiguration == nil {
- invalidParams.Add(request.NewErrParamRequired("VersioningConfiguration"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *PutBucketVersioningInput) SetBucket(v string) *PutBucketVersioningInput {
- s.Bucket = &v
- return s
- }
- func (s *PutBucketVersioningInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetChecksumAlgorithm sets the ChecksumAlgorithm field's value.
- func (s *PutBucketVersioningInput) SetChecksumAlgorithm(v string) *PutBucketVersioningInput {
- s.ChecksumAlgorithm = &v
- return s
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *PutBucketVersioningInput) SetExpectedBucketOwner(v string) *PutBucketVersioningInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetMFA sets the MFA field's value.
- func (s *PutBucketVersioningInput) SetMFA(v string) *PutBucketVersioningInput {
- s.MFA = &v
- return s
- }
- // SetVersioningConfiguration sets the VersioningConfiguration field's value.
- func (s *PutBucketVersioningInput) SetVersioningConfiguration(v *VersioningConfiguration) *PutBucketVersioningInput {
- s.VersioningConfiguration = v
- return s
- }
- func (s *PutBucketVersioningInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *PutBucketVersioningInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s PutBucketVersioningInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type PutBucketVersioningOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketVersioningOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketVersioningOutput) GoString() string {
- return s.String()
- }
- type PutBucketWebsiteInput struct {
- _ struct{} `locationName:"PutBucketWebsiteRequest" type:"structure" payload:"WebsiteConfiguration"`
- // The bucket name.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // Indicates the algorithm used to create the checksum for the object when using
- // the SDK. This header will not provide any additional functionality if not
- // using the SDK. When sending this header, there must be a corresponding x-amz-checksum
- // or x-amz-trailer header sent. Otherwise, Amazon S3 fails the request with
- // the HTTP status code 400 Bad Request. For more information, see Checking
- // object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
- // in the Amazon S3 User Guide.
- //
- // If you provide an individual checksum, Amazon S3 ignores any provided ChecksumAlgorithm
- // parameter.
- //
- // The AWS SDK for Go v1 does not support automatic computing request payload
- // checksum. This feature is available in the AWS SDK for Go v2. If a value
- // is specified for this parameter, the matching algorithm's checksum member
- // must be populated with the algorithm's checksum of the request payload.
- //
- // The SDK will automatically compute the Content-MD5 checksum for this operation.
- // The AWS SDK for Go v2 allows you to configure alternative checksum algorithm
- // to be used.
- ChecksumAlgorithm *string `location:"header" locationName:"x-amz-sdk-checksum-algorithm" type:"string" enum:"ChecksumAlgorithm"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // Container for the request.
- //
- // WebsiteConfiguration is a required field
- WebsiteConfiguration *WebsiteConfiguration `locationName:"WebsiteConfiguration" type:"structure" required:"true" xmlURI:"http://s3.amazonaws.com/doc/2006-03-01/"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketWebsiteInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketWebsiteInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *PutBucketWebsiteInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "PutBucketWebsiteInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.WebsiteConfiguration == nil {
- invalidParams.Add(request.NewErrParamRequired("WebsiteConfiguration"))
- }
- if s.WebsiteConfiguration != nil {
- if err := s.WebsiteConfiguration.Validate(); err != nil {
- invalidParams.AddNested("WebsiteConfiguration", err.(request.ErrInvalidParams))
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *PutBucketWebsiteInput) SetBucket(v string) *PutBucketWebsiteInput {
- s.Bucket = &v
- return s
- }
- func (s *PutBucketWebsiteInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetChecksumAlgorithm sets the ChecksumAlgorithm field's value.
- func (s *PutBucketWebsiteInput) SetChecksumAlgorithm(v string) *PutBucketWebsiteInput {
- s.ChecksumAlgorithm = &v
- return s
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *PutBucketWebsiteInput) SetExpectedBucketOwner(v string) *PutBucketWebsiteInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetWebsiteConfiguration sets the WebsiteConfiguration field's value.
- func (s *PutBucketWebsiteInput) SetWebsiteConfiguration(v *WebsiteConfiguration) *PutBucketWebsiteInput {
- s.WebsiteConfiguration = v
- return s
- }
- func (s *PutBucketWebsiteInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *PutBucketWebsiteInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s PutBucketWebsiteInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type PutBucketWebsiteOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketWebsiteOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutBucketWebsiteOutput) GoString() string {
- return s.String()
- }
- type PutObjectAclInput struct {
- _ struct{} `locationName:"PutObjectAclRequest" type:"structure" payload:"AccessControlPolicy"`
- // The canned ACL to apply to the object. For more information, see Canned ACL
- // (https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL).
- ACL *string `location:"header" locationName:"x-amz-acl" type:"string" enum:"ObjectCannedACL"`
- // Contains the elements that set the ACL permissions for an object per grantee.
- AccessControlPolicy *AccessControlPolicy `locationName:"AccessControlPolicy" type:"structure" xmlURI:"http://s3.amazonaws.com/doc/2006-03-01/"`
- // The bucket name that contains the object to which you want to attach the
- // ACL.
- //
- // When using this action with an access point, you must direct requests to
- // the access point hostname. The access point hostname takes the form AccessPointName-AccountId.s3-accesspoint.Region.amazonaws.com.
- // When using this action with an access point through the Amazon Web Services
- // SDKs, you provide the access point ARN in place of the bucket name. For more
- // information about access point ARNs, see Using access points (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html)
- // in the Amazon S3 User Guide.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // Indicates the algorithm used to create the checksum for the object when using
- // the SDK. This header will not provide any additional functionality if not
- // using the SDK. When sending this header, there must be a corresponding x-amz-checksum
- // or x-amz-trailer header sent. Otherwise, Amazon S3 fails the request with
- // the HTTP status code 400 Bad Request. For more information, see Checking
- // object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
- // in the Amazon S3 User Guide.
- //
- // If you provide an individual checksum, Amazon S3 ignores any provided ChecksumAlgorithm
- // parameter.
- //
- // The AWS SDK for Go v1 does not support automatic computing request payload
- // checksum. This feature is available in the AWS SDK for Go v2. If a value
- // is specified for this parameter, the matching algorithm's checksum member
- // must be populated with the algorithm's checksum of the request payload.
- //
- // The SDK will automatically compute the Content-MD5 checksum for this operation.
- // The AWS SDK for Go v2 allows you to configure alternative checksum algorithm
- // to be used.
- ChecksumAlgorithm *string `location:"header" locationName:"x-amz-sdk-checksum-algorithm" type:"string" enum:"ChecksumAlgorithm"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // Allows grantee the read, write, read ACP, and write ACP permissions on the
- // bucket.
- //
- // This action is not supported by Amazon S3 on Outposts.
- GrantFullControl *string `location:"header" locationName:"x-amz-grant-full-control" type:"string"`
- // Allows grantee to list the objects in the bucket.
- //
- // This action is not supported by Amazon S3 on Outposts.
- GrantRead *string `location:"header" locationName:"x-amz-grant-read" type:"string"`
- // Allows grantee to read the bucket ACL.
- //
- // This action is not supported by Amazon S3 on Outposts.
- GrantReadACP *string `location:"header" locationName:"x-amz-grant-read-acp" type:"string"`
- // Allows grantee to create new objects in the bucket.
- //
- // For the bucket and object owners of existing objects, also allows deletions
- // and overwrites of those objects.
- GrantWrite *string `location:"header" locationName:"x-amz-grant-write" type:"string"`
- // Allows grantee to write the ACL for the applicable bucket.
- //
- // This action is not supported by Amazon S3 on Outposts.
- GrantWriteACP *string `location:"header" locationName:"x-amz-grant-write-acp" type:"string"`
- // Key for which the PUT action was initiated.
- //
- // When using this action with an access point, you must direct requests to
- // the access point hostname. The access point hostname takes the form AccessPointName-AccountId.s3-accesspoint.Region.amazonaws.com.
- // When using this action with an access point through the Amazon Web Services
- // SDKs, you provide the access point ARN in place of the bucket name. For more
- // information about access point ARNs, see Using access points (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html)
- // in the Amazon S3 User Guide.
- //
- // When using this action with Amazon S3 on Outposts, you must direct requests
- // to the S3 on Outposts hostname. The S3 on Outposts hostname takes the form
- // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When
- // using this action with S3 on Outposts through the Amazon Web Services SDKs,
- // you provide the Outposts bucket ARN in place of the bucket name. For more
- // information about S3 on Outposts ARNs, see Using Amazon S3 on Outposts (https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html)
- // in the Amazon S3 User Guide.
- //
- // Key is a required field
- Key *string `location:"uri" locationName:"Key" min:"1" type:"string" required:"true"`
- // Confirms that the requester knows that they will be charged for the request.
- // Bucket owners need not specify this parameter in their requests. For information
- // about downloading objects from Requester Pays buckets, see Downloading Objects
- // in Requester Pays Buckets (https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html)
- // in the Amazon S3 User Guide.
- RequestPayer *string `location:"header" locationName:"x-amz-request-payer" type:"string" enum:"RequestPayer"`
- // VersionId used to reference a specific version of the object.
- VersionId *string `location:"querystring" locationName:"versionId" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutObjectAclInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutObjectAclInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *PutObjectAclInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "PutObjectAclInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.Key == nil {
- invalidParams.Add(request.NewErrParamRequired("Key"))
- }
- if s.Key != nil && len(*s.Key) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Key", 1))
- }
- if s.AccessControlPolicy != nil {
- if err := s.AccessControlPolicy.Validate(); err != nil {
- invalidParams.AddNested("AccessControlPolicy", err.(request.ErrInvalidParams))
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetACL sets the ACL field's value.
- func (s *PutObjectAclInput) SetACL(v string) *PutObjectAclInput {
- s.ACL = &v
- return s
- }
- // SetAccessControlPolicy sets the AccessControlPolicy field's value.
- func (s *PutObjectAclInput) SetAccessControlPolicy(v *AccessControlPolicy) *PutObjectAclInput {
- s.AccessControlPolicy = v
- return s
- }
- // SetBucket sets the Bucket field's value.
- func (s *PutObjectAclInput) SetBucket(v string) *PutObjectAclInput {
- s.Bucket = &v
- return s
- }
- func (s *PutObjectAclInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetChecksumAlgorithm sets the ChecksumAlgorithm field's value.
- func (s *PutObjectAclInput) SetChecksumAlgorithm(v string) *PutObjectAclInput {
- s.ChecksumAlgorithm = &v
- return s
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *PutObjectAclInput) SetExpectedBucketOwner(v string) *PutObjectAclInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetGrantFullControl sets the GrantFullControl field's value.
- func (s *PutObjectAclInput) SetGrantFullControl(v string) *PutObjectAclInput {
- s.GrantFullControl = &v
- return s
- }
- // SetGrantRead sets the GrantRead field's value.
- func (s *PutObjectAclInput) SetGrantRead(v string) *PutObjectAclInput {
- s.GrantRead = &v
- return s
- }
- // SetGrantReadACP sets the GrantReadACP field's value.
- func (s *PutObjectAclInput) SetGrantReadACP(v string) *PutObjectAclInput {
- s.GrantReadACP = &v
- return s
- }
- // SetGrantWrite sets the GrantWrite field's value.
- func (s *PutObjectAclInput) SetGrantWrite(v string) *PutObjectAclInput {
- s.GrantWrite = &v
- return s
- }
- // SetGrantWriteACP sets the GrantWriteACP field's value.
- func (s *PutObjectAclInput) SetGrantWriteACP(v string) *PutObjectAclInput {
- s.GrantWriteACP = &v
- return s
- }
- // SetKey sets the Key field's value.
- func (s *PutObjectAclInput) SetKey(v string) *PutObjectAclInput {
- s.Key = &v
- return s
- }
- // SetRequestPayer sets the RequestPayer field's value.
- func (s *PutObjectAclInput) SetRequestPayer(v string) *PutObjectAclInput {
- s.RequestPayer = &v
- return s
- }
- // SetVersionId sets the VersionId field's value.
- func (s *PutObjectAclInput) SetVersionId(v string) *PutObjectAclInput {
- s.VersionId = &v
- return s
- }
- func (s *PutObjectAclInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *PutObjectAclInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s PutObjectAclInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type PutObjectAclOutput struct {
- _ struct{} `type:"structure"`
- // If present, indicates that the requester was successfully charged for the
- // request.
- RequestCharged *string `location:"header" locationName:"x-amz-request-charged" type:"string" enum:"RequestCharged"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutObjectAclOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutObjectAclOutput) GoString() string {
- return s.String()
- }
- // SetRequestCharged sets the RequestCharged field's value.
- func (s *PutObjectAclOutput) SetRequestCharged(v string) *PutObjectAclOutput {
- s.RequestCharged = &v
- return s
- }
- type PutObjectInput struct {
- _ struct{} `locationName:"PutObjectRequest" type:"structure" payload:"Body"`
- // The canned ACL to apply to the object. For more information, see Canned ACL
- // (https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL).
- //
- // This action is not supported by Amazon S3 on Outposts.
- ACL *string `location:"header" locationName:"x-amz-acl" type:"string" enum:"ObjectCannedACL"`
- // Object data.
- Body io.ReadSeeker `type:"blob"`
- // The bucket name to which the PUT action was initiated.
- //
- // When using this action with an access point, you must direct requests to
- // the access point hostname. The access point hostname takes the form AccessPointName-AccountId.s3-accesspoint.Region.amazonaws.com.
- // When using this action with an access point through the Amazon Web Services
- // SDKs, you provide the access point ARN in place of the bucket name. For more
- // information about access point ARNs, see Using access points (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html)
- // in the Amazon S3 User Guide.
- //
- // When using this action with Amazon S3 on Outposts, you must direct requests
- // to the S3 on Outposts hostname. The S3 on Outposts hostname takes the form
- // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When
- // using this action with S3 on Outposts through the Amazon Web Services SDKs,
- // you provide the Outposts bucket ARN in place of the bucket name. For more
- // information about S3 on Outposts ARNs, see Using Amazon S3 on Outposts (https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html)
- // in the Amazon S3 User Guide.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // Specifies whether Amazon S3 should use an S3 Bucket Key for object encryption
- // with server-side encryption using AWS KMS (SSE-KMS). Setting this header
- // to true causes Amazon S3 to use an S3 Bucket Key for object encryption with
- // SSE-KMS.
- //
- // Specifying this header with a PUT action doesn’t affect bucket-level settings
- // for S3 Bucket Key.
- BucketKeyEnabled *bool `location:"header" locationName:"x-amz-server-side-encryption-bucket-key-enabled" type:"boolean"`
- // Can be used to specify caching behavior along the request/reply chain. For
- // more information, see http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.9
- // (http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.9).
- CacheControl *string `location:"header" locationName:"Cache-Control" type:"string"`
- // Indicates the algorithm used to create the checksum for the object when using
- // the SDK. This header will not provide any additional functionality if not
- // using the SDK. When sending this header, there must be a corresponding x-amz-checksum
- // or x-amz-trailer header sent. Otherwise, Amazon S3 fails the request with
- // the HTTP status code 400 Bad Request. For more information, see Checking
- // object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
- // in the Amazon S3 User Guide.
- //
- // If you provide an individual checksum, Amazon S3 ignores any provided ChecksumAlgorithm
- // parameter.
- //
- // The AWS SDK for Go v1 does not support automatic computing request payload
- // checksum. This feature is available in the AWS SDK for Go v2. If a value
- // is specified for this parameter, the matching algorithm's checksum member
- // must be populated with the algorithm's checksum of the request payload.
- ChecksumAlgorithm *string `location:"header" locationName:"x-amz-sdk-checksum-algorithm" type:"string" enum:"ChecksumAlgorithm"`
- // This header can be used as a data integrity check to verify that the data
- // received is the same data that was originally sent. This header specifies
- // the base64-encoded, 32-bit CRC32 checksum of the object. For more information,
- // see Checking object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
- // in the Amazon S3 User Guide.
- ChecksumCRC32 *string `location:"header" locationName:"x-amz-checksum-crc32" type:"string"`
- // This header can be used as a data integrity check to verify that the data
- // received is the same data that was originally sent. This header specifies
- // the base64-encoded, 32-bit CRC32C checksum of the object. For more information,
- // see Checking object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
- // in the Amazon S3 User Guide.
- ChecksumCRC32C *string `location:"header" locationName:"x-amz-checksum-crc32c" type:"string"`
- // This header can be used as a data integrity check to verify that the data
- // received is the same data that was originally sent. This header specifies
- // the base64-encoded, 160-bit SHA-1 digest of the object. For more information,
- // see Checking object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
- // in the Amazon S3 User Guide.
- ChecksumSHA1 *string `location:"header" locationName:"x-amz-checksum-sha1" type:"string"`
- // This header can be used as a data integrity check to verify that the data
- // received is the same data that was originally sent. This header specifies
- // the base64-encoded, 256-bit SHA-256 digest of the object. For more information,
- // see Checking object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
- // in the Amazon S3 User Guide.
- ChecksumSHA256 *string `location:"header" locationName:"x-amz-checksum-sha256" type:"string"`
- // Specifies presentational information for the object. For more information,
- // see http://www.w3.org/Protocols/rfc2616/rfc2616-sec19.html#sec19.5.1 (http://www.w3.org/Protocols/rfc2616/rfc2616-sec19.html#sec19.5.1).
- ContentDisposition *string `location:"header" locationName:"Content-Disposition" type:"string"`
- // Specifies what content encodings have been applied to the object and thus
- // what decoding mechanisms must be applied to obtain the media-type referenced
- // by the Content-Type header field. For more information, see http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.11
- // (http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.11).
- ContentEncoding *string `location:"header" locationName:"Content-Encoding" type:"string"`
- // The language the content is in.
- ContentLanguage *string `location:"header" locationName:"Content-Language" type:"string"`
- // Size of the body in bytes. This parameter is useful when the size of the
- // body cannot be determined automatically. For more information, see http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.13
- // (http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.13).
- ContentLength *int64 `location:"header" locationName:"Content-Length" type:"long"`
- // The base64-encoded 128-bit MD5 digest of the message (without the headers)
- // according to RFC 1864. This header can be used as a message integrity check
- // to verify that the data is the same data that was originally sent. Although
- // it is optional, we recommend using the Content-MD5 mechanism as an end-to-end
- // integrity check. For more information about REST request authentication,
- // see REST Authentication (https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html).
- ContentMD5 *string `location:"header" locationName:"Content-MD5" type:"string"`
- // A standard MIME type describing the format of the contents. For more information,
- // see http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.17 (http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.17).
- ContentType *string `location:"header" locationName:"Content-Type" type:"string"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // The date and time at which the object is no longer cacheable. For more information,
- // see http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.21 (http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.21).
- Expires *time.Time `location:"header" locationName:"Expires" type:"timestamp"`
- // Gives the grantee READ, READ_ACP, and WRITE_ACP permissions on the object.
- //
- // This action is not supported by Amazon S3 on Outposts.
- GrantFullControl *string `location:"header" locationName:"x-amz-grant-full-control" type:"string"`
- // Allows grantee to read the object data and its metadata.
- //
- // This action is not supported by Amazon S3 on Outposts.
- GrantRead *string `location:"header" locationName:"x-amz-grant-read" type:"string"`
- // Allows grantee to read the object ACL.
- //
- // This action is not supported by Amazon S3 on Outposts.
- GrantReadACP *string `location:"header" locationName:"x-amz-grant-read-acp" type:"string"`
- // Allows grantee to write the ACL for the applicable object.
- //
- // This action is not supported by Amazon S3 on Outposts.
- GrantWriteACP *string `location:"header" locationName:"x-amz-grant-write-acp" type:"string"`
- // Object key for which the PUT action was initiated.
- //
- // Key is a required field
- Key *string `location:"uri" locationName:"Key" min:"1" type:"string" required:"true"`
- // A map of metadata to store with the object in S3.
- Metadata map[string]*string `location:"headers" locationName:"x-amz-meta-" type:"map"`
- // Specifies whether a legal hold will be applied to this object. For more information
- // about S3 Object Lock, see Object Lock (https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html).
- ObjectLockLegalHoldStatus *string `location:"header" locationName:"x-amz-object-lock-legal-hold" type:"string" enum:"ObjectLockLegalHoldStatus"`
- // The Object Lock mode that you want to apply to this object.
- ObjectLockMode *string `location:"header" locationName:"x-amz-object-lock-mode" type:"string" enum:"ObjectLockMode"`
- // The date and time when you want this object's Object Lock to expire. Must
- // be formatted as a timestamp parameter.
- ObjectLockRetainUntilDate *time.Time `location:"header" locationName:"x-amz-object-lock-retain-until-date" type:"timestamp" timestampFormat:"iso8601"`
- // Confirms that the requester knows that they will be charged for the request.
- // Bucket owners need not specify this parameter in their requests. For information
- // about downloading objects from Requester Pays buckets, see Downloading Objects
- // in Requester Pays Buckets (https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html)
- // in the Amazon S3 User Guide.
- RequestPayer *string `location:"header" locationName:"x-amz-request-payer" type:"string" enum:"RequestPayer"`
- // Specifies the algorithm to use to when encrypting the object (for example,
- // AES256).
- SSECustomerAlgorithm *string `location:"header" locationName:"x-amz-server-side-encryption-customer-algorithm" type:"string"`
- // Specifies the customer-provided encryption key for Amazon S3 to use in encrypting
- // data. This value is used to store the object and then it is discarded; Amazon
- // S3 does not store the encryption key. The key must be appropriate for use
- // with the algorithm specified in the x-amz-server-side-encryption-customer-algorithm
- // header.
- //
- // SSECustomerKey is a sensitive parameter and its value will be
- // replaced with "sensitive" in string returned by PutObjectInput's
- // String and GoString methods.
- SSECustomerKey *string `marshal-as:"blob" location:"header" locationName:"x-amz-server-side-encryption-customer-key" type:"string" sensitive:"true"`
- // Specifies the 128-bit MD5 digest of the encryption key according to RFC 1321.
- // Amazon S3 uses this header for a message integrity check to ensure that the
- // encryption key was transmitted without error.
- SSECustomerKeyMD5 *string `location:"header" locationName:"x-amz-server-side-encryption-customer-key-MD5" type:"string"`
- // Specifies the Amazon Web Services KMS Encryption Context to use for object
- // encryption. The value of this header is a base64-encoded UTF-8 string holding
- // JSON with the encryption context key-value pairs.
- //
- // SSEKMSEncryptionContext is a sensitive parameter and its value will be
- // replaced with "sensitive" in string returned by PutObjectInput's
- // String and GoString methods.
- SSEKMSEncryptionContext *string `location:"header" locationName:"x-amz-server-side-encryption-context" type:"string" sensitive:"true"`
- // If x-amz-server-side-encryption is present and has the value of aws:kms,
- // this header specifies the ID of the Amazon Web Services Key Management Service
- // (Amazon Web Services KMS) symmetrical customer managed key that was used
- // for the object. If you specify x-amz-server-side-encryption:aws:kms, but
- // do not providex-amz-server-side-encryption-aws-kms-key-id, Amazon S3 uses
- // the Amazon Web Services managed key to protect the data. If the KMS key does
- // not exist in the same account issuing the command, you must use the full
- // ARN and not just the ID.
- //
- // SSEKMSKeyId is a sensitive parameter and its value will be
- // replaced with "sensitive" in string returned by PutObjectInput's
- // String and GoString methods.
- SSEKMSKeyId *string `location:"header" locationName:"x-amz-server-side-encryption-aws-kms-key-id" type:"string" sensitive:"true"`
- // The server-side encryption algorithm used when storing this object in Amazon
- // S3 (for example, AES256, aws:kms).
- ServerSideEncryption *string `location:"header" locationName:"x-amz-server-side-encryption" type:"string" enum:"ServerSideEncryption"`
- // By default, Amazon S3 uses the STANDARD Storage Class to store newly created
- // objects. The STANDARD storage class provides high durability and high availability.
- // Depending on performance needs, you can specify a different Storage Class.
- // Amazon S3 on Outposts only uses the OUTPOSTS Storage Class. For more information,
- // see Storage Classes (https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html)
- // in the Amazon S3 User Guide.
- StorageClass *string `location:"header" locationName:"x-amz-storage-class" type:"string" enum:"StorageClass"`
- // The tag-set for the object. The tag-set must be encoded as URL Query parameters.
- // (For example, "Key1=Value1")
- Tagging *string `location:"header" locationName:"x-amz-tagging" type:"string"`
- // If the bucket is configured as a website, redirects requests for this object
- // to another object in the same bucket or to an external URL. Amazon S3 stores
- // the value of this header in the object metadata. For information about object
- // metadata, see Object Key and Metadata (https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMetadata.html).
- //
- // In the following example, the request header sets the redirect to an object
- // (anotherPage.html) in the same bucket:
- //
- // x-amz-website-redirect-location: /anotherPage.html
- //
- // In the following example, the request header sets the object redirect to
- // another website:
- //
- // x-amz-website-redirect-location: http://www.example.com/
- //
- // For more information about website hosting in Amazon S3, see Hosting Websites
- // on Amazon S3 (https://docs.aws.amazon.com/AmazonS3/latest/dev/WebsiteHosting.html)
- // and How to Configure Website Page Redirects (https://docs.aws.amazon.com/AmazonS3/latest/dev/how-to-page-redirect.html).
- WebsiteRedirectLocation *string `location:"header" locationName:"x-amz-website-redirect-location" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutObjectInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutObjectInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *PutObjectInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "PutObjectInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.Key == nil {
- invalidParams.Add(request.NewErrParamRequired("Key"))
- }
- if s.Key != nil && len(*s.Key) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Key", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetACL sets the ACL field's value.
- func (s *PutObjectInput) SetACL(v string) *PutObjectInput {
- s.ACL = &v
- return s
- }
- // SetBody sets the Body field's value.
- func (s *PutObjectInput) SetBody(v io.ReadSeeker) *PutObjectInput {
- s.Body = v
- return s
- }
- // SetBucket sets the Bucket field's value.
- func (s *PutObjectInput) SetBucket(v string) *PutObjectInput {
- s.Bucket = &v
- return s
- }
- func (s *PutObjectInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetBucketKeyEnabled sets the BucketKeyEnabled field's value.
- func (s *PutObjectInput) SetBucketKeyEnabled(v bool) *PutObjectInput {
- s.BucketKeyEnabled = &v
- return s
- }
- // SetCacheControl sets the CacheControl field's value.
- func (s *PutObjectInput) SetCacheControl(v string) *PutObjectInput {
- s.CacheControl = &v
- return s
- }
- // SetChecksumAlgorithm sets the ChecksumAlgorithm field's value.
- func (s *PutObjectInput) SetChecksumAlgorithm(v string) *PutObjectInput {
- s.ChecksumAlgorithm = &v
- return s
- }
- // SetChecksumCRC32 sets the ChecksumCRC32 field's value.
- func (s *PutObjectInput) SetChecksumCRC32(v string) *PutObjectInput {
- s.ChecksumCRC32 = &v
- return s
- }
- // SetChecksumCRC32C sets the ChecksumCRC32C field's value.
- func (s *PutObjectInput) SetChecksumCRC32C(v string) *PutObjectInput {
- s.ChecksumCRC32C = &v
- return s
- }
- // SetChecksumSHA1 sets the ChecksumSHA1 field's value.
- func (s *PutObjectInput) SetChecksumSHA1(v string) *PutObjectInput {
- s.ChecksumSHA1 = &v
- return s
- }
- // SetChecksumSHA256 sets the ChecksumSHA256 field's value.
- func (s *PutObjectInput) SetChecksumSHA256(v string) *PutObjectInput {
- s.ChecksumSHA256 = &v
- return s
- }
- // SetContentDisposition sets the ContentDisposition field's value.
- func (s *PutObjectInput) SetContentDisposition(v string) *PutObjectInput {
- s.ContentDisposition = &v
- return s
- }
- // SetContentEncoding sets the ContentEncoding field's value.
- func (s *PutObjectInput) SetContentEncoding(v string) *PutObjectInput {
- s.ContentEncoding = &v
- return s
- }
- // SetContentLanguage sets the ContentLanguage field's value.
- func (s *PutObjectInput) SetContentLanguage(v string) *PutObjectInput {
- s.ContentLanguage = &v
- return s
- }
- // SetContentLength sets the ContentLength field's value.
- func (s *PutObjectInput) SetContentLength(v int64) *PutObjectInput {
- s.ContentLength = &v
- return s
- }
- // SetContentMD5 sets the ContentMD5 field's value.
- func (s *PutObjectInput) SetContentMD5(v string) *PutObjectInput {
- s.ContentMD5 = &v
- return s
- }
- // SetContentType sets the ContentType field's value.
- func (s *PutObjectInput) SetContentType(v string) *PutObjectInput {
- s.ContentType = &v
- return s
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *PutObjectInput) SetExpectedBucketOwner(v string) *PutObjectInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetExpires sets the Expires field's value.
- func (s *PutObjectInput) SetExpires(v time.Time) *PutObjectInput {
- s.Expires = &v
- return s
- }
- // SetGrantFullControl sets the GrantFullControl field's value.
- func (s *PutObjectInput) SetGrantFullControl(v string) *PutObjectInput {
- s.GrantFullControl = &v
- return s
- }
- // SetGrantRead sets the GrantRead field's value.
- func (s *PutObjectInput) SetGrantRead(v string) *PutObjectInput {
- s.GrantRead = &v
- return s
- }
- // SetGrantReadACP sets the GrantReadACP field's value.
- func (s *PutObjectInput) SetGrantReadACP(v string) *PutObjectInput {
- s.GrantReadACP = &v
- return s
- }
- // SetGrantWriteACP sets the GrantWriteACP field's value.
- func (s *PutObjectInput) SetGrantWriteACP(v string) *PutObjectInput {
- s.GrantWriteACP = &v
- return s
- }
- // SetKey sets the Key field's value.
- func (s *PutObjectInput) SetKey(v string) *PutObjectInput {
- s.Key = &v
- return s
- }
- // SetMetadata sets the Metadata field's value.
- func (s *PutObjectInput) SetMetadata(v map[string]*string) *PutObjectInput {
- s.Metadata = v
- return s
- }
- // SetObjectLockLegalHoldStatus sets the ObjectLockLegalHoldStatus field's value.
- func (s *PutObjectInput) SetObjectLockLegalHoldStatus(v string) *PutObjectInput {
- s.ObjectLockLegalHoldStatus = &v
- return s
- }
- // SetObjectLockMode sets the ObjectLockMode field's value.
- func (s *PutObjectInput) SetObjectLockMode(v string) *PutObjectInput {
- s.ObjectLockMode = &v
- return s
- }
- // SetObjectLockRetainUntilDate sets the ObjectLockRetainUntilDate field's value.
- func (s *PutObjectInput) SetObjectLockRetainUntilDate(v time.Time) *PutObjectInput {
- s.ObjectLockRetainUntilDate = &v
- return s
- }
- // SetRequestPayer sets the RequestPayer field's value.
- func (s *PutObjectInput) SetRequestPayer(v string) *PutObjectInput {
- s.RequestPayer = &v
- return s
- }
- // SetSSECustomerAlgorithm sets the SSECustomerAlgorithm field's value.
- func (s *PutObjectInput) SetSSECustomerAlgorithm(v string) *PutObjectInput {
- s.SSECustomerAlgorithm = &v
- return s
- }
- // SetSSECustomerKey sets the SSECustomerKey field's value.
- func (s *PutObjectInput) SetSSECustomerKey(v string) *PutObjectInput {
- s.SSECustomerKey = &v
- return s
- }
- func (s *PutObjectInput) getSSECustomerKey() (v string) {
- if s.SSECustomerKey == nil {
- return v
- }
- return *s.SSECustomerKey
- }
- // SetSSECustomerKeyMD5 sets the SSECustomerKeyMD5 field's value.
- func (s *PutObjectInput) SetSSECustomerKeyMD5(v string) *PutObjectInput {
- s.SSECustomerKeyMD5 = &v
- return s
- }
- // SetSSEKMSEncryptionContext sets the SSEKMSEncryptionContext field's value.
- func (s *PutObjectInput) SetSSEKMSEncryptionContext(v string) *PutObjectInput {
- s.SSEKMSEncryptionContext = &v
- return s
- }
- // SetSSEKMSKeyId sets the SSEKMSKeyId field's value.
- func (s *PutObjectInput) SetSSEKMSKeyId(v string) *PutObjectInput {
- s.SSEKMSKeyId = &v
- return s
- }
- // SetServerSideEncryption sets the ServerSideEncryption field's value.
- func (s *PutObjectInput) SetServerSideEncryption(v string) *PutObjectInput {
- s.ServerSideEncryption = &v
- return s
- }
- // SetStorageClass sets the StorageClass field's value.
- func (s *PutObjectInput) SetStorageClass(v string) *PutObjectInput {
- s.StorageClass = &v
- return s
- }
- // SetTagging sets the Tagging field's value.
- func (s *PutObjectInput) SetTagging(v string) *PutObjectInput {
- s.Tagging = &v
- return s
- }
- // SetWebsiteRedirectLocation sets the WebsiteRedirectLocation field's value.
- func (s *PutObjectInput) SetWebsiteRedirectLocation(v string) *PutObjectInput {
- s.WebsiteRedirectLocation = &v
- return s
- }
- func (s *PutObjectInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *PutObjectInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s PutObjectInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type PutObjectLegalHoldInput struct {
- _ struct{} `locationName:"PutObjectLegalHoldRequest" type:"structure" payload:"LegalHold"`
- // The bucket name containing the object that you want to place a legal hold
- // on.
- //
- // When using this action with an access point, you must direct requests to
- // the access point hostname. The access point hostname takes the form AccessPointName-AccountId.s3-accesspoint.Region.amazonaws.com.
- // When using this action with an access point through the Amazon Web Services
- // SDKs, you provide the access point ARN in place of the bucket name. For more
- // information about access point ARNs, see Using access points (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html)
- // in the Amazon S3 User Guide.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // Indicates the algorithm used to create the checksum for the object when using
- // the SDK. This header will not provide any additional functionality if not
- // using the SDK. When sending this header, there must be a corresponding x-amz-checksum
- // or x-amz-trailer header sent. Otherwise, Amazon S3 fails the request with
- // the HTTP status code 400 Bad Request. For more information, see Checking
- // object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
- // in the Amazon S3 User Guide.
- //
- // If you provide an individual checksum, Amazon S3 ignores any provided ChecksumAlgorithm
- // parameter.
- //
- // The AWS SDK for Go v1 does not support automatic computing request payload
- // checksum. This feature is available in the AWS SDK for Go v2. If a value
- // is specified for this parameter, the matching algorithm's checksum member
- // must be populated with the algorithm's checksum of the request payload.
- //
- // The SDK will automatically compute the Content-MD5 checksum for this operation.
- // The AWS SDK for Go v2 allows you to configure alternative checksum algorithm
- // to be used.
- ChecksumAlgorithm *string `location:"header" locationName:"x-amz-sdk-checksum-algorithm" type:"string" enum:"ChecksumAlgorithm"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // The key name for the object that you want to place a legal hold on.
- //
- // Key is a required field
- Key *string `location:"uri" locationName:"Key" min:"1" type:"string" required:"true"`
- // Container element for the legal hold configuration you want to apply to the
- // specified object.
- LegalHold *ObjectLockLegalHold `locationName:"LegalHold" type:"structure" xmlURI:"http://s3.amazonaws.com/doc/2006-03-01/"`
- // Confirms that the requester knows that they will be charged for the request.
- // Bucket owners need not specify this parameter in their requests. For information
- // about downloading objects from Requester Pays buckets, see Downloading Objects
- // in Requester Pays Buckets (https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html)
- // in the Amazon S3 User Guide.
- RequestPayer *string `location:"header" locationName:"x-amz-request-payer" type:"string" enum:"RequestPayer"`
- // The version ID of the object that you want to place a legal hold on.
- VersionId *string `location:"querystring" locationName:"versionId" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutObjectLegalHoldInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutObjectLegalHoldInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *PutObjectLegalHoldInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "PutObjectLegalHoldInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.Key == nil {
- invalidParams.Add(request.NewErrParamRequired("Key"))
- }
- if s.Key != nil && len(*s.Key) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Key", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *PutObjectLegalHoldInput) SetBucket(v string) *PutObjectLegalHoldInput {
- s.Bucket = &v
- return s
- }
- func (s *PutObjectLegalHoldInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetChecksumAlgorithm sets the ChecksumAlgorithm field's value.
- func (s *PutObjectLegalHoldInput) SetChecksumAlgorithm(v string) *PutObjectLegalHoldInput {
- s.ChecksumAlgorithm = &v
- return s
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *PutObjectLegalHoldInput) SetExpectedBucketOwner(v string) *PutObjectLegalHoldInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetKey sets the Key field's value.
- func (s *PutObjectLegalHoldInput) SetKey(v string) *PutObjectLegalHoldInput {
- s.Key = &v
- return s
- }
- // SetLegalHold sets the LegalHold field's value.
- func (s *PutObjectLegalHoldInput) SetLegalHold(v *ObjectLockLegalHold) *PutObjectLegalHoldInput {
- s.LegalHold = v
- return s
- }
- // SetRequestPayer sets the RequestPayer field's value.
- func (s *PutObjectLegalHoldInput) SetRequestPayer(v string) *PutObjectLegalHoldInput {
- s.RequestPayer = &v
- return s
- }
- // SetVersionId sets the VersionId field's value.
- func (s *PutObjectLegalHoldInput) SetVersionId(v string) *PutObjectLegalHoldInput {
- s.VersionId = &v
- return s
- }
- func (s *PutObjectLegalHoldInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *PutObjectLegalHoldInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s PutObjectLegalHoldInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type PutObjectLegalHoldOutput struct {
- _ struct{} `type:"structure"`
- // If present, indicates that the requester was successfully charged for the
- // request.
- RequestCharged *string `location:"header" locationName:"x-amz-request-charged" type:"string" enum:"RequestCharged"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutObjectLegalHoldOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutObjectLegalHoldOutput) GoString() string {
- return s.String()
- }
- // SetRequestCharged sets the RequestCharged field's value.
- func (s *PutObjectLegalHoldOutput) SetRequestCharged(v string) *PutObjectLegalHoldOutput {
- s.RequestCharged = &v
- return s
- }
- type PutObjectLockConfigurationInput struct {
- _ struct{} `locationName:"PutObjectLockConfigurationRequest" type:"structure" payload:"ObjectLockConfiguration"`
- // The bucket whose Object Lock configuration you want to create or replace.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // Indicates the algorithm used to create the checksum for the object when using
- // the SDK. This header will not provide any additional functionality if not
- // using the SDK. When sending this header, there must be a corresponding x-amz-checksum
- // or x-amz-trailer header sent. Otherwise, Amazon S3 fails the request with
- // the HTTP status code 400 Bad Request. For more information, see Checking
- // object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
- // in the Amazon S3 User Guide.
- //
- // If you provide an individual checksum, Amazon S3 ignores any provided ChecksumAlgorithm
- // parameter.
- //
- // The AWS SDK for Go v1 does not support automatic computing request payload
- // checksum. This feature is available in the AWS SDK for Go v2. If a value
- // is specified for this parameter, the matching algorithm's checksum member
- // must be populated with the algorithm's checksum of the request payload.
- //
- // The SDK will automatically compute the Content-MD5 checksum for this operation.
- // The AWS SDK for Go v2 allows you to configure alternative checksum algorithm
- // to be used.
- ChecksumAlgorithm *string `location:"header" locationName:"x-amz-sdk-checksum-algorithm" type:"string" enum:"ChecksumAlgorithm"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // The Object Lock configuration that you want to apply to the specified bucket.
- ObjectLockConfiguration *ObjectLockConfiguration `locationName:"ObjectLockConfiguration" type:"structure" xmlURI:"http://s3.amazonaws.com/doc/2006-03-01/"`
- // Confirms that the requester knows that they will be charged for the request.
- // Bucket owners need not specify this parameter in their requests. For information
- // about downloading objects from Requester Pays buckets, see Downloading Objects
- // in Requester Pays Buckets (https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html)
- // in the Amazon S3 User Guide.
- RequestPayer *string `location:"header" locationName:"x-amz-request-payer" type:"string" enum:"RequestPayer"`
- // A token to allow Object Lock to be enabled for an existing bucket.
- Token *string `location:"header" locationName:"x-amz-bucket-object-lock-token" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutObjectLockConfigurationInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutObjectLockConfigurationInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *PutObjectLockConfigurationInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "PutObjectLockConfigurationInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *PutObjectLockConfigurationInput) SetBucket(v string) *PutObjectLockConfigurationInput {
- s.Bucket = &v
- return s
- }
- func (s *PutObjectLockConfigurationInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetChecksumAlgorithm sets the ChecksumAlgorithm field's value.
- func (s *PutObjectLockConfigurationInput) SetChecksumAlgorithm(v string) *PutObjectLockConfigurationInput {
- s.ChecksumAlgorithm = &v
- return s
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *PutObjectLockConfigurationInput) SetExpectedBucketOwner(v string) *PutObjectLockConfigurationInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetObjectLockConfiguration sets the ObjectLockConfiguration field's value.
- func (s *PutObjectLockConfigurationInput) SetObjectLockConfiguration(v *ObjectLockConfiguration) *PutObjectLockConfigurationInput {
- s.ObjectLockConfiguration = v
- return s
- }
- // SetRequestPayer sets the RequestPayer field's value.
- func (s *PutObjectLockConfigurationInput) SetRequestPayer(v string) *PutObjectLockConfigurationInput {
- s.RequestPayer = &v
- return s
- }
- // SetToken sets the Token field's value.
- func (s *PutObjectLockConfigurationInput) SetToken(v string) *PutObjectLockConfigurationInput {
- s.Token = &v
- return s
- }
- func (s *PutObjectLockConfigurationInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *PutObjectLockConfigurationInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s PutObjectLockConfigurationInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type PutObjectLockConfigurationOutput struct {
- _ struct{} `type:"structure"`
- // If present, indicates that the requester was successfully charged for the
- // request.
- RequestCharged *string `location:"header" locationName:"x-amz-request-charged" type:"string" enum:"RequestCharged"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutObjectLockConfigurationOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutObjectLockConfigurationOutput) GoString() string {
- return s.String()
- }
- // SetRequestCharged sets the RequestCharged field's value.
- func (s *PutObjectLockConfigurationOutput) SetRequestCharged(v string) *PutObjectLockConfigurationOutput {
- s.RequestCharged = &v
- return s
- }
- type PutObjectOutput struct {
- _ struct{} `type:"structure"`
- // Indicates whether the uploaded object uses an S3 Bucket Key for server-side
- // encryption with Amazon Web Services KMS (SSE-KMS).
- BucketKeyEnabled *bool `location:"header" locationName:"x-amz-server-side-encryption-bucket-key-enabled" type:"boolean"`
- // The base64-encoded, 32-bit CRC32 checksum of the object. This will only be
- // present if it was uploaded with the object. With multipart uploads, this
- // may not be a checksum value of the object. For more information about how
- // checksums are calculated with multipart uploads, see Checking object integrity
- // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
- // in the Amazon S3 User Guide.
- ChecksumCRC32 *string `location:"header" locationName:"x-amz-checksum-crc32" type:"string"`
- // The base64-encoded, 32-bit CRC32C checksum of the object. This will only
- // be present if it was uploaded with the object. With multipart uploads, this
- // may not be a checksum value of the object. For more information about how
- // checksums are calculated with multipart uploads, see Checking object integrity
- // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
- // in the Amazon S3 User Guide.
- ChecksumCRC32C *string `location:"header" locationName:"x-amz-checksum-crc32c" type:"string"`
- // The base64-encoded, 160-bit SHA-1 digest of the object. This will only be
- // present if it was uploaded with the object. With multipart uploads, this
- // may not be a checksum value of the object. For more information about how
- // checksums are calculated with multipart uploads, see Checking object integrity
- // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
- // in the Amazon S3 User Guide.
- ChecksumSHA1 *string `location:"header" locationName:"x-amz-checksum-sha1" type:"string"`
- // The base64-encoded, 256-bit SHA-256 digest of the object. This will only
- // be present if it was uploaded with the object. With multipart uploads, this
- // may not be a checksum value of the object. For more information about how
- // checksums are calculated with multipart uploads, see Checking object integrity
- // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
- // in the Amazon S3 User Guide.
- ChecksumSHA256 *string `location:"header" locationName:"x-amz-checksum-sha256" type:"string"`
- // Entity tag for the uploaded object.
- ETag *string `location:"header" locationName:"ETag" type:"string"`
- // If the expiration is configured for the object (see PutBucketLifecycleConfiguration
- // (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html)),
- // the response includes this header. It includes the expiry-date and rule-id
- // key-value pairs that provide information about object expiration. The value
- // of the rule-id is URL-encoded.
- Expiration *string `location:"header" locationName:"x-amz-expiration" type:"string"`
- // If present, indicates that the requester was successfully charged for the
- // request.
- RequestCharged *string `location:"header" locationName:"x-amz-request-charged" type:"string" enum:"RequestCharged"`
- // If server-side encryption with a customer-provided encryption key was requested,
- // the response will include this header confirming the encryption algorithm
- // used.
- SSECustomerAlgorithm *string `location:"header" locationName:"x-amz-server-side-encryption-customer-algorithm" type:"string"`
- // If server-side encryption with a customer-provided encryption key was requested,
- // the response will include this header to provide round-trip message integrity
- // verification of the customer-provided encryption key.
- SSECustomerKeyMD5 *string `location:"header" locationName:"x-amz-server-side-encryption-customer-key-MD5" type:"string"`
- // If present, specifies the Amazon Web Services KMS Encryption Context to use
- // for object encryption. The value of this header is a base64-encoded UTF-8
- // string holding JSON with the encryption context key-value pairs.
- //
- // SSEKMSEncryptionContext is a sensitive parameter and its value will be
- // replaced with "sensitive" in string returned by PutObjectOutput's
- // String and GoString methods.
- SSEKMSEncryptionContext *string `location:"header" locationName:"x-amz-server-side-encryption-context" type:"string" sensitive:"true"`
- // If x-amz-server-side-encryption is present and has the value of aws:kms,
- // this header specifies the ID of the Amazon Web Services Key Management Service
- // (Amazon Web Services KMS) symmetric customer managed key that was used for
- // the object.
- //
- // SSEKMSKeyId is a sensitive parameter and its value will be
- // replaced with "sensitive" in string returned by PutObjectOutput's
- // String and GoString methods.
- SSEKMSKeyId *string `location:"header" locationName:"x-amz-server-side-encryption-aws-kms-key-id" type:"string" sensitive:"true"`
- // If you specified server-side encryption either with an Amazon Web Services
- // KMS key or Amazon S3-managed encryption key in your PUT request, the response
- // includes this header. It confirms the encryption algorithm that Amazon S3
- // used to encrypt the object.
- ServerSideEncryption *string `location:"header" locationName:"x-amz-server-side-encryption" type:"string" enum:"ServerSideEncryption"`
- // Version of the object.
- VersionId *string `location:"header" locationName:"x-amz-version-id" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutObjectOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutObjectOutput) GoString() string {
- return s.String()
- }
- // SetBucketKeyEnabled sets the BucketKeyEnabled field's value.
- func (s *PutObjectOutput) SetBucketKeyEnabled(v bool) *PutObjectOutput {
- s.BucketKeyEnabled = &v
- return s
- }
- // SetChecksumCRC32 sets the ChecksumCRC32 field's value.
- func (s *PutObjectOutput) SetChecksumCRC32(v string) *PutObjectOutput {
- s.ChecksumCRC32 = &v
- return s
- }
- // SetChecksumCRC32C sets the ChecksumCRC32C field's value.
- func (s *PutObjectOutput) SetChecksumCRC32C(v string) *PutObjectOutput {
- s.ChecksumCRC32C = &v
- return s
- }
- // SetChecksumSHA1 sets the ChecksumSHA1 field's value.
- func (s *PutObjectOutput) SetChecksumSHA1(v string) *PutObjectOutput {
- s.ChecksumSHA1 = &v
- return s
- }
- // SetChecksumSHA256 sets the ChecksumSHA256 field's value.
- func (s *PutObjectOutput) SetChecksumSHA256(v string) *PutObjectOutput {
- s.ChecksumSHA256 = &v
- return s
- }
- // SetETag sets the ETag field's value.
- func (s *PutObjectOutput) SetETag(v string) *PutObjectOutput {
- s.ETag = &v
- return s
- }
- // SetExpiration sets the Expiration field's value.
- func (s *PutObjectOutput) SetExpiration(v string) *PutObjectOutput {
- s.Expiration = &v
- return s
- }
- // SetRequestCharged sets the RequestCharged field's value.
- func (s *PutObjectOutput) SetRequestCharged(v string) *PutObjectOutput {
- s.RequestCharged = &v
- return s
- }
- // SetSSECustomerAlgorithm sets the SSECustomerAlgorithm field's value.
- func (s *PutObjectOutput) SetSSECustomerAlgorithm(v string) *PutObjectOutput {
- s.SSECustomerAlgorithm = &v
- return s
- }
- // SetSSECustomerKeyMD5 sets the SSECustomerKeyMD5 field's value.
- func (s *PutObjectOutput) SetSSECustomerKeyMD5(v string) *PutObjectOutput {
- s.SSECustomerKeyMD5 = &v
- return s
- }
- // SetSSEKMSEncryptionContext sets the SSEKMSEncryptionContext field's value.
- func (s *PutObjectOutput) SetSSEKMSEncryptionContext(v string) *PutObjectOutput {
- s.SSEKMSEncryptionContext = &v
- return s
- }
- // SetSSEKMSKeyId sets the SSEKMSKeyId field's value.
- func (s *PutObjectOutput) SetSSEKMSKeyId(v string) *PutObjectOutput {
- s.SSEKMSKeyId = &v
- return s
- }
- // SetServerSideEncryption sets the ServerSideEncryption field's value.
- func (s *PutObjectOutput) SetServerSideEncryption(v string) *PutObjectOutput {
- s.ServerSideEncryption = &v
- return s
- }
- // SetVersionId sets the VersionId field's value.
- func (s *PutObjectOutput) SetVersionId(v string) *PutObjectOutput {
- s.VersionId = &v
- return s
- }
- type PutObjectRetentionInput struct {
- _ struct{} `locationName:"PutObjectRetentionRequest" type:"structure" payload:"Retention"`
- // The bucket name that contains the object you want to apply this Object Retention
- // configuration to.
- //
- // When using this action with an access point, you must direct requests to
- // the access point hostname. The access point hostname takes the form AccessPointName-AccountId.s3-accesspoint.Region.amazonaws.com.
- // When using this action with an access point through the Amazon Web Services
- // SDKs, you provide the access point ARN in place of the bucket name. For more
- // information about access point ARNs, see Using access points (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html)
- // in the Amazon S3 User Guide.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // Indicates whether this action should bypass Governance-mode restrictions.
- BypassGovernanceRetention *bool `location:"header" locationName:"x-amz-bypass-governance-retention" type:"boolean"`
- // Indicates the algorithm used to create the checksum for the object when using
- // the SDK. This header will not provide any additional functionality if not
- // using the SDK. When sending this header, there must be a corresponding x-amz-checksum
- // or x-amz-trailer header sent. Otherwise, Amazon S3 fails the request with
- // the HTTP status code 400 Bad Request. For more information, see Checking
- // object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
- // in the Amazon S3 User Guide.
- //
- // If you provide an individual checksum, Amazon S3 ignores any provided ChecksumAlgorithm
- // parameter.
- //
- // The AWS SDK for Go v1 does not support automatic computing request payload
- // checksum. This feature is available in the AWS SDK for Go v2. If a value
- // is specified for this parameter, the matching algorithm's checksum member
- // must be populated with the algorithm's checksum of the request payload.
- //
- // The SDK will automatically compute the Content-MD5 checksum for this operation.
- // The AWS SDK for Go v2 allows you to configure alternative checksum algorithm
- // to be used.
- ChecksumAlgorithm *string `location:"header" locationName:"x-amz-sdk-checksum-algorithm" type:"string" enum:"ChecksumAlgorithm"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // The key name for the object that you want to apply this Object Retention
- // configuration to.
- //
- // Key is a required field
- Key *string `location:"uri" locationName:"Key" min:"1" type:"string" required:"true"`
- // Confirms that the requester knows that they will be charged for the request.
- // Bucket owners need not specify this parameter in their requests. For information
- // about downloading objects from Requester Pays buckets, see Downloading Objects
- // in Requester Pays Buckets (https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html)
- // in the Amazon S3 User Guide.
- RequestPayer *string `location:"header" locationName:"x-amz-request-payer" type:"string" enum:"RequestPayer"`
- // The container element for the Object Retention configuration.
- Retention *ObjectLockRetention `locationName:"Retention" type:"structure" xmlURI:"http://s3.amazonaws.com/doc/2006-03-01/"`
- // The version ID for the object that you want to apply this Object Retention
- // configuration to.
- VersionId *string `location:"querystring" locationName:"versionId" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutObjectRetentionInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutObjectRetentionInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *PutObjectRetentionInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "PutObjectRetentionInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.Key == nil {
- invalidParams.Add(request.NewErrParamRequired("Key"))
- }
- if s.Key != nil && len(*s.Key) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Key", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *PutObjectRetentionInput) SetBucket(v string) *PutObjectRetentionInput {
- s.Bucket = &v
- return s
- }
- func (s *PutObjectRetentionInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetBypassGovernanceRetention sets the BypassGovernanceRetention field's value.
- func (s *PutObjectRetentionInput) SetBypassGovernanceRetention(v bool) *PutObjectRetentionInput {
- s.BypassGovernanceRetention = &v
- return s
- }
- // SetChecksumAlgorithm sets the ChecksumAlgorithm field's value.
- func (s *PutObjectRetentionInput) SetChecksumAlgorithm(v string) *PutObjectRetentionInput {
- s.ChecksumAlgorithm = &v
- return s
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *PutObjectRetentionInput) SetExpectedBucketOwner(v string) *PutObjectRetentionInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetKey sets the Key field's value.
- func (s *PutObjectRetentionInput) SetKey(v string) *PutObjectRetentionInput {
- s.Key = &v
- return s
- }
- // SetRequestPayer sets the RequestPayer field's value.
- func (s *PutObjectRetentionInput) SetRequestPayer(v string) *PutObjectRetentionInput {
- s.RequestPayer = &v
- return s
- }
- // SetRetention sets the Retention field's value.
- func (s *PutObjectRetentionInput) SetRetention(v *ObjectLockRetention) *PutObjectRetentionInput {
- s.Retention = v
- return s
- }
- // SetVersionId sets the VersionId field's value.
- func (s *PutObjectRetentionInput) SetVersionId(v string) *PutObjectRetentionInput {
- s.VersionId = &v
- return s
- }
- func (s *PutObjectRetentionInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *PutObjectRetentionInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s PutObjectRetentionInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type PutObjectRetentionOutput struct {
- _ struct{} `type:"structure"`
- // If present, indicates that the requester was successfully charged for the
- // request.
- RequestCharged *string `location:"header" locationName:"x-amz-request-charged" type:"string" enum:"RequestCharged"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutObjectRetentionOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutObjectRetentionOutput) GoString() string {
- return s.String()
- }
- // SetRequestCharged sets the RequestCharged field's value.
- func (s *PutObjectRetentionOutput) SetRequestCharged(v string) *PutObjectRetentionOutput {
- s.RequestCharged = &v
- return s
- }
- type PutObjectTaggingInput struct {
- _ struct{} `locationName:"PutObjectTaggingRequest" type:"structure" payload:"Tagging"`
- // The bucket name containing the object.
- //
- // When using this action with an access point, you must direct requests to
- // the access point hostname. The access point hostname takes the form AccessPointName-AccountId.s3-accesspoint.Region.amazonaws.com.
- // When using this action with an access point through the Amazon Web Services
- // SDKs, you provide the access point ARN in place of the bucket name. For more
- // information about access point ARNs, see Using access points (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html)
- // in the Amazon S3 User Guide.
- //
- // When using this action with Amazon S3 on Outposts, you must direct requests
- // to the S3 on Outposts hostname. The S3 on Outposts hostname takes the form
- // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When
- // using this action with S3 on Outposts through the Amazon Web Services SDKs,
- // you provide the Outposts bucket ARN in place of the bucket name. For more
- // information about S3 on Outposts ARNs, see Using Amazon S3 on Outposts (https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html)
- // in the Amazon S3 User Guide.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // Indicates the algorithm used to create the checksum for the object when using
- // the SDK. This header will not provide any additional functionality if not
- // using the SDK. When sending this header, there must be a corresponding x-amz-checksum
- // or x-amz-trailer header sent. Otherwise, Amazon S3 fails the request with
- // the HTTP status code 400 Bad Request. For more information, see Checking
- // object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
- // in the Amazon S3 User Guide.
- //
- // If you provide an individual checksum, Amazon S3 ignores any provided ChecksumAlgorithm
- // parameter.
- //
- // The AWS SDK for Go v1 does not support automatic computing request payload
- // checksum. This feature is available in the AWS SDK for Go v2. If a value
- // is specified for this parameter, the matching algorithm's checksum member
- // must be populated with the algorithm's checksum of the request payload.
- //
- // The SDK will automatically compute the Content-MD5 checksum for this operation.
- // The AWS SDK for Go v2 allows you to configure alternative checksum algorithm
- // to be used.
- ChecksumAlgorithm *string `location:"header" locationName:"x-amz-sdk-checksum-algorithm" type:"string" enum:"ChecksumAlgorithm"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // Name of the object key.
- //
- // Key is a required field
- Key *string `location:"uri" locationName:"Key" min:"1" type:"string" required:"true"`
- // Confirms that the requester knows that they will be charged for the request.
- // Bucket owners need not specify this parameter in their requests. For information
- // about downloading objects from Requester Pays buckets, see Downloading Objects
- // in Requester Pays Buckets (https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html)
- // in the Amazon S3 User Guide.
- RequestPayer *string `location:"header" locationName:"x-amz-request-payer" type:"string" enum:"RequestPayer"`
- // Container for the TagSet and Tag elements
- //
- // Tagging is a required field
- Tagging *Tagging `locationName:"Tagging" type:"structure" required:"true" xmlURI:"http://s3.amazonaws.com/doc/2006-03-01/"`
- // The versionId of the object that the tag-set will be added to.
- VersionId *string `location:"querystring" locationName:"versionId" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutObjectTaggingInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutObjectTaggingInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *PutObjectTaggingInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "PutObjectTaggingInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.Key == nil {
- invalidParams.Add(request.NewErrParamRequired("Key"))
- }
- if s.Key != nil && len(*s.Key) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Key", 1))
- }
- if s.Tagging == nil {
- invalidParams.Add(request.NewErrParamRequired("Tagging"))
- }
- if s.Tagging != nil {
- if err := s.Tagging.Validate(); err != nil {
- invalidParams.AddNested("Tagging", err.(request.ErrInvalidParams))
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *PutObjectTaggingInput) SetBucket(v string) *PutObjectTaggingInput {
- s.Bucket = &v
- return s
- }
- func (s *PutObjectTaggingInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetChecksumAlgorithm sets the ChecksumAlgorithm field's value.
- func (s *PutObjectTaggingInput) SetChecksumAlgorithm(v string) *PutObjectTaggingInput {
- s.ChecksumAlgorithm = &v
- return s
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *PutObjectTaggingInput) SetExpectedBucketOwner(v string) *PutObjectTaggingInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetKey sets the Key field's value.
- func (s *PutObjectTaggingInput) SetKey(v string) *PutObjectTaggingInput {
- s.Key = &v
- return s
- }
- // SetRequestPayer sets the RequestPayer field's value.
- func (s *PutObjectTaggingInput) SetRequestPayer(v string) *PutObjectTaggingInput {
- s.RequestPayer = &v
- return s
- }
- // SetTagging sets the Tagging field's value.
- func (s *PutObjectTaggingInput) SetTagging(v *Tagging) *PutObjectTaggingInput {
- s.Tagging = v
- return s
- }
- // SetVersionId sets the VersionId field's value.
- func (s *PutObjectTaggingInput) SetVersionId(v string) *PutObjectTaggingInput {
- s.VersionId = &v
- return s
- }
- func (s *PutObjectTaggingInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *PutObjectTaggingInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s PutObjectTaggingInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type PutObjectTaggingOutput struct {
- _ struct{} `type:"structure"`
- // The versionId of the object the tag-set was added to.
- VersionId *string `location:"header" locationName:"x-amz-version-id" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutObjectTaggingOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutObjectTaggingOutput) GoString() string {
- return s.String()
- }
- // SetVersionId sets the VersionId field's value.
- func (s *PutObjectTaggingOutput) SetVersionId(v string) *PutObjectTaggingOutput {
- s.VersionId = &v
- return s
- }
- type PutPublicAccessBlockInput struct {
- _ struct{} `locationName:"PutPublicAccessBlockRequest" type:"structure" payload:"PublicAccessBlockConfiguration"`
- // The name of the Amazon S3 bucket whose PublicAccessBlock configuration you
- // want to set.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // Indicates the algorithm used to create the checksum for the object when using
- // the SDK. This header will not provide any additional functionality if not
- // using the SDK. When sending this header, there must be a corresponding x-amz-checksum
- // or x-amz-trailer header sent. Otherwise, Amazon S3 fails the request with
- // the HTTP status code 400 Bad Request. For more information, see Checking
- // object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
- // in the Amazon S3 User Guide.
- //
- // If you provide an individual checksum, Amazon S3 ignores any provided ChecksumAlgorithm
- // parameter.
- //
- // The AWS SDK for Go v1 does not support automatic computing request payload
- // checksum. This feature is available in the AWS SDK for Go v2. If a value
- // is specified for this parameter, the matching algorithm's checksum member
- // must be populated with the algorithm's checksum of the request payload.
- //
- // The SDK will automatically compute the Content-MD5 checksum for this operation.
- // The AWS SDK for Go v2 allows you to configure alternative checksum algorithm
- // to be used.
- ChecksumAlgorithm *string `location:"header" locationName:"x-amz-sdk-checksum-algorithm" type:"string" enum:"ChecksumAlgorithm"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // The PublicAccessBlock configuration that you want to apply to this Amazon
- // S3 bucket. You can enable the configuration options in any combination. For
- // more information about when Amazon S3 considers a bucket or object public,
- // see The Meaning of "Public" (https://docs.aws.amazon.com/AmazonS3/latest/dev/access-control-block-public-access.html#access-control-block-public-access-policy-status)
- // in the Amazon S3 User Guide.
- //
- // PublicAccessBlockConfiguration is a required field
- PublicAccessBlockConfiguration *PublicAccessBlockConfiguration `locationName:"PublicAccessBlockConfiguration" type:"structure" required:"true" xmlURI:"http://s3.amazonaws.com/doc/2006-03-01/"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutPublicAccessBlockInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutPublicAccessBlockInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *PutPublicAccessBlockInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "PutPublicAccessBlockInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.PublicAccessBlockConfiguration == nil {
- invalidParams.Add(request.NewErrParamRequired("PublicAccessBlockConfiguration"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *PutPublicAccessBlockInput) SetBucket(v string) *PutPublicAccessBlockInput {
- s.Bucket = &v
- return s
- }
- func (s *PutPublicAccessBlockInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetChecksumAlgorithm sets the ChecksumAlgorithm field's value.
- func (s *PutPublicAccessBlockInput) SetChecksumAlgorithm(v string) *PutPublicAccessBlockInput {
- s.ChecksumAlgorithm = &v
- return s
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *PutPublicAccessBlockInput) SetExpectedBucketOwner(v string) *PutPublicAccessBlockInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetPublicAccessBlockConfiguration sets the PublicAccessBlockConfiguration field's value.
- func (s *PutPublicAccessBlockInput) SetPublicAccessBlockConfiguration(v *PublicAccessBlockConfiguration) *PutPublicAccessBlockInput {
- s.PublicAccessBlockConfiguration = v
- return s
- }
- func (s *PutPublicAccessBlockInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *PutPublicAccessBlockInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s PutPublicAccessBlockInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type PutPublicAccessBlockOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutPublicAccessBlockOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s PutPublicAccessBlockOutput) GoString() string {
- return s.String()
- }
- // Specifies the configuration for publishing messages to an Amazon Simple Queue
- // Service (Amazon SQS) queue when Amazon S3 detects specified events.
- type QueueConfiguration struct {
- _ struct{} `type:"structure"`
- // A collection of bucket events for which to send notifications
- //
- // Events is a required field
- Events []*string `locationName:"Event" type:"list" flattened:"true" required:"true" enum:"Event"`
- // Specifies object key name filtering rules. For information about key name
- // filtering, see Configuring Event Notifications (https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html)
- // in the Amazon S3 User Guide.
- Filter *NotificationConfigurationFilter `type:"structure"`
- // An optional unique identifier for configurations in a notification configuration.
- // If you don't provide one, Amazon S3 will assign an ID.
- Id *string `type:"string"`
- // The Amazon Resource Name (ARN) of the Amazon SQS queue to which Amazon S3
- // publishes a message when it detects events of the specified type.
- //
- // QueueArn is a required field
- QueueArn *string `locationName:"Queue" type:"string" required:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s QueueConfiguration) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s QueueConfiguration) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *QueueConfiguration) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "QueueConfiguration"}
- if s.Events == nil {
- invalidParams.Add(request.NewErrParamRequired("Events"))
- }
- if s.QueueArn == nil {
- invalidParams.Add(request.NewErrParamRequired("QueueArn"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetEvents sets the Events field's value.
- func (s *QueueConfiguration) SetEvents(v []*string) *QueueConfiguration {
- s.Events = v
- return s
- }
- // SetFilter sets the Filter field's value.
- func (s *QueueConfiguration) SetFilter(v *NotificationConfigurationFilter) *QueueConfiguration {
- s.Filter = v
- return s
- }
- // SetId sets the Id field's value.
- func (s *QueueConfiguration) SetId(v string) *QueueConfiguration {
- s.Id = &v
- return s
- }
- // SetQueueArn sets the QueueArn field's value.
- func (s *QueueConfiguration) SetQueueArn(v string) *QueueConfiguration {
- s.QueueArn = &v
- return s
- }
- // This data type is deprecated. Use QueueConfiguration (https://docs.aws.amazon.com/AmazonS3/latest/API/API_QueueConfiguration.html)
- // for the same purposes. This data type specifies the configuration for publishing
- // messages to an Amazon Simple Queue Service (Amazon SQS) queue when Amazon
- // S3 detects specified events.
- type QueueConfigurationDeprecated struct {
- _ struct{} `type:"structure"`
- // The bucket event for which to send notifications.
- //
- // Deprecated: Event has been deprecated
- Event *string `deprecated:"true" type:"string" enum:"Event"`
- // A collection of bucket events for which to send notifications.
- Events []*string `locationName:"Event" type:"list" flattened:"true" enum:"Event"`
- // An optional unique identifier for configurations in a notification configuration.
- // If you don't provide one, Amazon S3 will assign an ID.
- Id *string `type:"string"`
- // The Amazon Resource Name (ARN) of the Amazon SQS queue to which Amazon S3
- // publishes a message when it detects events of the specified type.
- Queue *string `type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s QueueConfigurationDeprecated) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s QueueConfigurationDeprecated) GoString() string {
- return s.String()
- }
- // SetEvent sets the Event field's value.
- func (s *QueueConfigurationDeprecated) SetEvent(v string) *QueueConfigurationDeprecated {
- s.Event = &v
- return s
- }
- // SetEvents sets the Events field's value.
- func (s *QueueConfigurationDeprecated) SetEvents(v []*string) *QueueConfigurationDeprecated {
- s.Events = v
- return s
- }
- // SetId sets the Id field's value.
- func (s *QueueConfigurationDeprecated) SetId(v string) *QueueConfigurationDeprecated {
- s.Id = &v
- return s
- }
- // SetQueue sets the Queue field's value.
- func (s *QueueConfigurationDeprecated) SetQueue(v string) *QueueConfigurationDeprecated {
- s.Queue = &v
- return s
- }
- // The container for the records event.
- type RecordsEvent struct {
- _ struct{} `locationName:"RecordsEvent" type:"structure" payload:"Payload"`
- // The byte array of partial, one or more result records.
- // Payload is automatically base64 encoded/decoded by the SDK.
- Payload []byte `type:"blob"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s RecordsEvent) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s RecordsEvent) GoString() string {
- return s.String()
- }
- // SetPayload sets the Payload field's value.
- func (s *RecordsEvent) SetPayload(v []byte) *RecordsEvent {
- s.Payload = v
- return s
- }
- // The RecordsEvent is and event in the SelectObjectContentEventStream group of events.
- func (s *RecordsEvent) eventSelectObjectContentEventStream() {}
- // UnmarshalEvent unmarshals the EventStream Message into the RecordsEvent value.
- // This method is only used internally within the SDK's EventStream handling.
- func (s *RecordsEvent) UnmarshalEvent(
- payloadUnmarshaler protocol.PayloadUnmarshaler,
- msg eventstream.Message,
- ) error {
- s.Payload = make([]byte, len(msg.Payload))
- copy(s.Payload, msg.Payload)
- return nil
- }
- // MarshalEvent marshals the type into an stream event value. This method
- // should only used internally within the SDK's EventStream handling.
- func (s *RecordsEvent) MarshalEvent(pm protocol.PayloadMarshaler) (msg eventstream.Message, err error) {
- msg.Headers.Set(eventstreamapi.MessageTypeHeader, eventstream.StringValue(eventstreamapi.EventMessageType))
- msg.Headers.Set(":content-type", eventstream.StringValue("application/octet-stream"))
- msg.Payload = s.Payload
- return msg, err
- }
- // Specifies how requests are redirected. In the event of an error, you can
- // specify a different error code to return.
- type Redirect struct {
- _ struct{} `type:"structure"`
- // The host name to use in the redirect request.
- HostName *string `type:"string"`
- // The HTTP redirect code to use on the response. Not required if one of the
- // siblings is present.
- HttpRedirectCode *string `type:"string"`
- // Protocol to use when redirecting requests. The default is the protocol that
- // is used in the original request.
- Protocol *string `type:"string" enum:"Protocol"`
- // The object key prefix to use in the redirect request. For example, to redirect
- // requests for all pages with prefix docs/ (objects in the docs/ folder) to
- // documents/, you can set a condition block with KeyPrefixEquals set to docs/
- // and in the Redirect set ReplaceKeyPrefixWith to /documents. Not required
- // if one of the siblings is present. Can be present only if ReplaceKeyWith
- // is not provided.
- //
- // Replacement must be made for object keys containing special characters (such
- // as carriage returns) when using XML requests. For more information, see XML
- // related object key constraints (https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html#object-key-xml-related-constraints).
- ReplaceKeyPrefixWith *string `type:"string"`
- // The specific object key to use in the redirect request. For example, redirect
- // request to error.html. Not required if one of the siblings is present. Can
- // be present only if ReplaceKeyPrefixWith is not provided.
- //
- // Replacement must be made for object keys containing special characters (such
- // as carriage returns) when using XML requests. For more information, see XML
- // related object key constraints (https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html#object-key-xml-related-constraints).
- ReplaceKeyWith *string `type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s Redirect) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s Redirect) GoString() string {
- return s.String()
- }
- // SetHostName sets the HostName field's value.
- func (s *Redirect) SetHostName(v string) *Redirect {
- s.HostName = &v
- return s
- }
- // SetHttpRedirectCode sets the HttpRedirectCode field's value.
- func (s *Redirect) SetHttpRedirectCode(v string) *Redirect {
- s.HttpRedirectCode = &v
- return s
- }
- // SetProtocol sets the Protocol field's value.
- func (s *Redirect) SetProtocol(v string) *Redirect {
- s.Protocol = &v
- return s
- }
- // SetReplaceKeyPrefixWith sets the ReplaceKeyPrefixWith field's value.
- func (s *Redirect) SetReplaceKeyPrefixWith(v string) *Redirect {
- s.ReplaceKeyPrefixWith = &v
- return s
- }
- // SetReplaceKeyWith sets the ReplaceKeyWith field's value.
- func (s *Redirect) SetReplaceKeyWith(v string) *Redirect {
- s.ReplaceKeyWith = &v
- return s
- }
- // Specifies the redirect behavior of all requests to a website endpoint of
- // an Amazon S3 bucket.
- type RedirectAllRequestsTo struct {
- _ struct{} `type:"structure"`
- // Name of the host where requests are redirected.
- //
- // HostName is a required field
- HostName *string `type:"string" required:"true"`
- // Protocol to use when redirecting requests. The default is the protocol that
- // is used in the original request.
- Protocol *string `type:"string" enum:"Protocol"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s RedirectAllRequestsTo) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s RedirectAllRequestsTo) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *RedirectAllRequestsTo) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "RedirectAllRequestsTo"}
- if s.HostName == nil {
- invalidParams.Add(request.NewErrParamRequired("HostName"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetHostName sets the HostName field's value.
- func (s *RedirectAllRequestsTo) SetHostName(v string) *RedirectAllRequestsTo {
- s.HostName = &v
- return s
- }
- // SetProtocol sets the Protocol field's value.
- func (s *RedirectAllRequestsTo) SetProtocol(v string) *RedirectAllRequestsTo {
- s.Protocol = &v
- return s
- }
- // A filter that you can specify for selection for modifications on replicas.
- // Amazon S3 doesn't replicate replica modifications by default. In the latest
- // version of replication configuration (when Filter is specified), you can
- // specify this element and set the status to Enabled to replicate modifications
- // on replicas.
- //
- // If you don't specify the Filter element, Amazon S3 assumes that the replication
- // configuration is the earlier version, V1. In the earlier version, this element
- // is not allowed.
- type ReplicaModifications struct {
- _ struct{} `type:"structure"`
- // Specifies whether Amazon S3 replicates modifications on replicas.
- //
- // Status is a required field
- Status *string `type:"string" required:"true" enum:"ReplicaModificationsStatus"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ReplicaModifications) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ReplicaModifications) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *ReplicaModifications) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "ReplicaModifications"}
- if s.Status == nil {
- invalidParams.Add(request.NewErrParamRequired("Status"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetStatus sets the Status field's value.
- func (s *ReplicaModifications) SetStatus(v string) *ReplicaModifications {
- s.Status = &v
- return s
- }
- // A container for replication rules. You can add up to 1,000 rules. The maximum
- // size of a replication configuration is 2 MB.
- type ReplicationConfiguration struct {
- _ struct{} `type:"structure"`
- // The Amazon Resource Name (ARN) of the Identity and Access Management (IAM)
- // role that Amazon S3 assumes when replicating objects. For more information,
- // see How to Set Up Replication (https://docs.aws.amazon.com/AmazonS3/latest/dev/replication-how-setup.html)
- // in the Amazon S3 User Guide.
- //
- // Role is a required field
- Role *string `type:"string" required:"true"`
- // A container for one or more replication rules. A replication configuration
- // must have at least one rule and can contain a maximum of 1,000 rules.
- //
- // Rules is a required field
- Rules []*ReplicationRule `locationName:"Rule" type:"list" flattened:"true" required:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ReplicationConfiguration) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ReplicationConfiguration) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *ReplicationConfiguration) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "ReplicationConfiguration"}
- if s.Role == nil {
- invalidParams.Add(request.NewErrParamRequired("Role"))
- }
- if s.Rules == nil {
- invalidParams.Add(request.NewErrParamRequired("Rules"))
- }
- if s.Rules != nil {
- for i, v := range s.Rules {
- if v == nil {
- continue
- }
- if err := v.Validate(); err != nil {
- invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Rules", i), err.(request.ErrInvalidParams))
- }
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetRole sets the Role field's value.
- func (s *ReplicationConfiguration) SetRole(v string) *ReplicationConfiguration {
- s.Role = &v
- return s
- }
- // SetRules sets the Rules field's value.
- func (s *ReplicationConfiguration) SetRules(v []*ReplicationRule) *ReplicationConfiguration {
- s.Rules = v
- return s
- }
- // Specifies which Amazon S3 objects to replicate and where to store the replicas.
- type ReplicationRule struct {
- _ struct{} `type:"structure"`
- // Specifies whether Amazon S3 replicates delete markers. If you specify a Filter
- // in your replication configuration, you must also include a DeleteMarkerReplication
- // element. If your Filter includes a Tag element, the DeleteMarkerReplication
- // Status must be set to Disabled, because Amazon S3 does not support replicating
- // delete markers for tag-based rules. For an example configuration, see Basic
- // Rule Configuration (https://docs.aws.amazon.com/AmazonS3/latest/dev/replication-add-config.html#replication-config-min-rule-config).
- //
- // For more information about delete marker replication, see Basic Rule Configuration
- // (https://docs.aws.amazon.com/AmazonS3/latest/dev/delete-marker-replication.html).
- //
- // If you are using an earlier version of the replication configuration, Amazon
- // S3 handles replication of delete markers differently. For more information,
- // see Backward Compatibility (https://docs.aws.amazon.com/AmazonS3/latest/dev/replication-add-config.html#replication-backward-compat-considerations).
- DeleteMarkerReplication *DeleteMarkerReplication `type:"structure"`
- // A container for information about the replication destination and its configurations
- // including enabling the S3 Replication Time Control (S3 RTC).
- //
- // Destination is a required field
- Destination *Destination `type:"structure" required:"true"`
- // Optional configuration to replicate existing source bucket objects. For more
- // information, see Replicating Existing Objects (https://docs.aws.amazon.com/AmazonS3/latest/dev/replication-what-is-isnot-replicated.html#existing-object-replication)
- // in the Amazon S3 User Guide.
- ExistingObjectReplication *ExistingObjectReplication `type:"structure"`
- // A filter that identifies the subset of objects to which the replication rule
- // applies. A Filter must specify exactly one Prefix, Tag, or an And child element.
- Filter *ReplicationRuleFilter `type:"structure"`
- // A unique identifier for the rule. The maximum value is 255 characters.
- ID *string `type:"string"`
- // An object key name prefix that identifies the object or objects to which
- // the rule applies. The maximum prefix length is 1,024 characters. To include
- // all objects in a bucket, specify an empty string.
- //
- // Replacement must be made for object keys containing special characters (such
- // as carriage returns) when using XML requests. For more information, see XML
- // related object key constraints (https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html#object-key-xml-related-constraints).
- //
- // Deprecated: Prefix has been deprecated
- Prefix *string `deprecated:"true" type:"string"`
- // The priority indicates which rule has precedence whenever two or more replication
- // rules conflict. Amazon S3 will attempt to replicate objects according to
- // all replication rules. However, if there are two or more rules with the same
- // destination bucket, then objects will be replicated according to the rule
- // with the highest priority. The higher the number, the higher the priority.
- //
- // For more information, see Replication (https://docs.aws.amazon.com/AmazonS3/latest/dev/replication.html)
- // in the Amazon S3 User Guide.
- Priority *int64 `type:"integer"`
- // A container that describes additional filters for identifying the source
- // objects that you want to replicate. You can choose to enable or disable the
- // replication of these objects. Currently, Amazon S3 supports only the filter
- // that you can specify for objects created with server-side encryption using
- // a customer managed key stored in Amazon Web Services Key Management Service
- // (SSE-KMS).
- SourceSelectionCriteria *SourceSelectionCriteria `type:"structure"`
- // Specifies whether the rule is enabled.
- //
- // Status is a required field
- Status *string `type:"string" required:"true" enum:"ReplicationRuleStatus"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ReplicationRule) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ReplicationRule) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *ReplicationRule) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "ReplicationRule"}
- if s.Destination == nil {
- invalidParams.Add(request.NewErrParamRequired("Destination"))
- }
- if s.Status == nil {
- invalidParams.Add(request.NewErrParamRequired("Status"))
- }
- if s.Destination != nil {
- if err := s.Destination.Validate(); err != nil {
- invalidParams.AddNested("Destination", err.(request.ErrInvalidParams))
- }
- }
- if s.ExistingObjectReplication != nil {
- if err := s.ExistingObjectReplication.Validate(); err != nil {
- invalidParams.AddNested("ExistingObjectReplication", err.(request.ErrInvalidParams))
- }
- }
- if s.Filter != nil {
- if err := s.Filter.Validate(); err != nil {
- invalidParams.AddNested("Filter", err.(request.ErrInvalidParams))
- }
- }
- if s.SourceSelectionCriteria != nil {
- if err := s.SourceSelectionCriteria.Validate(); err != nil {
- invalidParams.AddNested("SourceSelectionCriteria", err.(request.ErrInvalidParams))
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetDeleteMarkerReplication sets the DeleteMarkerReplication field's value.
- func (s *ReplicationRule) SetDeleteMarkerReplication(v *DeleteMarkerReplication) *ReplicationRule {
- s.DeleteMarkerReplication = v
- return s
- }
- // SetDestination sets the Destination field's value.
- func (s *ReplicationRule) SetDestination(v *Destination) *ReplicationRule {
- s.Destination = v
- return s
- }
- // SetExistingObjectReplication sets the ExistingObjectReplication field's value.
- func (s *ReplicationRule) SetExistingObjectReplication(v *ExistingObjectReplication) *ReplicationRule {
- s.ExistingObjectReplication = v
- return s
- }
- // SetFilter sets the Filter field's value.
- func (s *ReplicationRule) SetFilter(v *ReplicationRuleFilter) *ReplicationRule {
- s.Filter = v
- return s
- }
- // SetID sets the ID field's value.
- func (s *ReplicationRule) SetID(v string) *ReplicationRule {
- s.ID = &v
- return s
- }
- // SetPrefix sets the Prefix field's value.
- func (s *ReplicationRule) SetPrefix(v string) *ReplicationRule {
- s.Prefix = &v
- return s
- }
- // SetPriority sets the Priority field's value.
- func (s *ReplicationRule) SetPriority(v int64) *ReplicationRule {
- s.Priority = &v
- return s
- }
- // SetSourceSelectionCriteria sets the SourceSelectionCriteria field's value.
- func (s *ReplicationRule) SetSourceSelectionCriteria(v *SourceSelectionCriteria) *ReplicationRule {
- s.SourceSelectionCriteria = v
- return s
- }
- // SetStatus sets the Status field's value.
- func (s *ReplicationRule) SetStatus(v string) *ReplicationRule {
- s.Status = &v
- return s
- }
- // A container for specifying rule filters. The filters determine the subset
- // of objects to which the rule applies. This element is required only if you
- // specify more than one filter.
- //
- // For example:
- //
- // - If you specify both a Prefix and a Tag filter, wrap these filters in
- // an And tag.
- //
- // - If you specify a filter based on multiple tags, wrap the Tag elements
- // in an And tag.
- type ReplicationRuleAndOperator struct {
- _ struct{} `type:"structure"`
- // An object key name prefix that identifies the subset of objects to which
- // the rule applies.
- Prefix *string `type:"string"`
- // An array of tags containing key and value pairs.
- Tags []*Tag `locationName:"Tag" locationNameList:"Tag" type:"list" flattened:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ReplicationRuleAndOperator) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ReplicationRuleAndOperator) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *ReplicationRuleAndOperator) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "ReplicationRuleAndOperator"}
- 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
- }
- // SetPrefix sets the Prefix field's value.
- func (s *ReplicationRuleAndOperator) SetPrefix(v string) *ReplicationRuleAndOperator {
- s.Prefix = &v
- return s
- }
- // SetTags sets the Tags field's value.
- func (s *ReplicationRuleAndOperator) SetTags(v []*Tag) *ReplicationRuleAndOperator {
- s.Tags = v
- return s
- }
- // A filter that identifies the subset of objects to which the replication rule
- // applies. A Filter must specify exactly one Prefix, Tag, or an And child element.
- type ReplicationRuleFilter struct {
- _ struct{} `type:"structure"`
- // A container for specifying rule filters. The filters determine the subset
- // of objects to which the rule applies. This element is required only if you
- // specify more than one filter. For example:
- //
- // * If you specify both a Prefix and a Tag filter, wrap these filters in
- // an And tag.
- //
- // * If you specify a filter based on multiple tags, wrap the Tag elements
- // in an And tag.
- And *ReplicationRuleAndOperator `type:"structure"`
- // An object key name prefix that identifies the subset of objects to which
- // the rule applies.
- //
- // Replacement must be made for object keys containing special characters (such
- // as carriage returns) when using XML requests. For more information, see XML
- // related object key constraints (https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html#object-key-xml-related-constraints).
- Prefix *string `type:"string"`
- // A container for specifying a tag key and value.
- //
- // The rule applies only to objects that have the tag in their tag set.
- Tag *Tag `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ReplicationRuleFilter) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ReplicationRuleFilter) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *ReplicationRuleFilter) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "ReplicationRuleFilter"}
- if s.And != nil {
- if err := s.And.Validate(); err != nil {
- invalidParams.AddNested("And", err.(request.ErrInvalidParams))
- }
- }
- if s.Tag != nil {
- if err := s.Tag.Validate(); err != nil {
- invalidParams.AddNested("Tag", err.(request.ErrInvalidParams))
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetAnd sets the And field's value.
- func (s *ReplicationRuleFilter) SetAnd(v *ReplicationRuleAndOperator) *ReplicationRuleFilter {
- s.And = v
- return s
- }
- // SetPrefix sets the Prefix field's value.
- func (s *ReplicationRuleFilter) SetPrefix(v string) *ReplicationRuleFilter {
- s.Prefix = &v
- return s
- }
- // SetTag sets the Tag field's value.
- func (s *ReplicationRuleFilter) SetTag(v *Tag) *ReplicationRuleFilter {
- s.Tag = v
- return s
- }
- // A container specifying S3 Replication Time Control (S3 RTC) related information,
- // including whether S3 RTC is enabled and the time when all objects and operations
- // on objects must be replicated. Must be specified together with a Metrics
- // block.
- type ReplicationTime struct {
- _ struct{} `type:"structure"`
- // Specifies whether the replication time is enabled.
- //
- // Status is a required field
- Status *string `type:"string" required:"true" enum:"ReplicationTimeStatus"`
- // A container specifying the time by which replication should be complete for
- // all objects and operations on objects.
- //
- // Time is a required field
- Time *ReplicationTimeValue `type:"structure" required:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ReplicationTime) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ReplicationTime) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *ReplicationTime) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "ReplicationTime"}
- if s.Status == nil {
- invalidParams.Add(request.NewErrParamRequired("Status"))
- }
- if s.Time == nil {
- invalidParams.Add(request.NewErrParamRequired("Time"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetStatus sets the Status field's value.
- func (s *ReplicationTime) SetStatus(v string) *ReplicationTime {
- s.Status = &v
- return s
- }
- // SetTime sets the Time field's value.
- func (s *ReplicationTime) SetTime(v *ReplicationTimeValue) *ReplicationTime {
- s.Time = v
- return s
- }
- // A container specifying the time value for S3 Replication Time Control (S3
- // RTC) and replication metrics EventThreshold.
- type ReplicationTimeValue struct {
- _ struct{} `type:"structure"`
- // Contains an integer specifying time in minutes.
- //
- // Valid value: 15
- Minutes *int64 `type:"integer"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ReplicationTimeValue) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ReplicationTimeValue) GoString() string {
- return s.String()
- }
- // SetMinutes sets the Minutes field's value.
- func (s *ReplicationTimeValue) SetMinutes(v int64) *ReplicationTimeValue {
- s.Minutes = &v
- return s
- }
- // Container for Payer.
- type RequestPaymentConfiguration struct {
- _ struct{} `type:"structure"`
- // Specifies who pays for the download and request fees.
- //
- // Payer is a required field
- Payer *string `type:"string" required:"true" enum:"Payer"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s RequestPaymentConfiguration) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s RequestPaymentConfiguration) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *RequestPaymentConfiguration) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "RequestPaymentConfiguration"}
- if s.Payer == nil {
- invalidParams.Add(request.NewErrParamRequired("Payer"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetPayer sets the Payer field's value.
- func (s *RequestPaymentConfiguration) SetPayer(v string) *RequestPaymentConfiguration {
- s.Payer = &v
- return s
- }
- // Container for specifying if periodic QueryProgress messages should be sent.
- type RequestProgress struct {
- _ struct{} `type:"structure"`
- // Specifies whether periodic QueryProgress frames should be sent. Valid values:
- // TRUE, FALSE. Default value: FALSE.
- Enabled *bool `type:"boolean"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s RequestProgress) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s RequestProgress) GoString() string {
- return s.String()
- }
- // SetEnabled sets the Enabled field's value.
- func (s *RequestProgress) SetEnabled(v bool) *RequestProgress {
- s.Enabled = &v
- return s
- }
- type RestoreObjectInput struct {
- _ struct{} `locationName:"RestoreObjectRequest" type:"structure" payload:"RestoreRequest"`
- // The bucket name containing the object to restore.
- //
- // When using this action with an access point, you must direct requests to
- // the access point hostname. The access point hostname takes the form AccessPointName-AccountId.s3-accesspoint.Region.amazonaws.com.
- // When using this action with an access point through the Amazon Web Services
- // SDKs, you provide the access point ARN in place of the bucket name. For more
- // information about access point ARNs, see Using access points (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html)
- // in the Amazon S3 User Guide.
- //
- // When using this action with Amazon S3 on Outposts, you must direct requests
- // to the S3 on Outposts hostname. The S3 on Outposts hostname takes the form
- // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When
- // using this action with S3 on Outposts through the Amazon Web Services SDKs,
- // you provide the Outposts bucket ARN in place of the bucket name. For more
- // information about S3 on Outposts ARNs, see Using Amazon S3 on Outposts (https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html)
- // in the Amazon S3 User Guide.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // Indicates the algorithm used to create the checksum for the object when using
- // the SDK. This header will not provide any additional functionality if not
- // using the SDK. When sending this header, there must be a corresponding x-amz-checksum
- // or x-amz-trailer header sent. Otherwise, Amazon S3 fails the request with
- // the HTTP status code 400 Bad Request. For more information, see Checking
- // object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
- // in the Amazon S3 User Guide.
- //
- // If you provide an individual checksum, Amazon S3 ignores any provided ChecksumAlgorithm
- // parameter.
- //
- // The AWS SDK for Go v1 does not support automatic computing request payload
- // checksum. This feature is available in the AWS SDK for Go v2. If a value
- // is specified for this parameter, the matching algorithm's checksum member
- // must be populated with the algorithm's checksum of the request payload.
- ChecksumAlgorithm *string `location:"header" locationName:"x-amz-sdk-checksum-algorithm" type:"string" enum:"ChecksumAlgorithm"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // Object key for which the action was initiated.
- //
- // Key is a required field
- Key *string `location:"uri" locationName:"Key" min:"1" type:"string" required:"true"`
- // Confirms that the requester knows that they will be charged for the request.
- // Bucket owners need not specify this parameter in their requests. For information
- // about downloading objects from Requester Pays buckets, see Downloading Objects
- // in Requester Pays Buckets (https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html)
- // in the Amazon S3 User Guide.
- RequestPayer *string `location:"header" locationName:"x-amz-request-payer" type:"string" enum:"RequestPayer"`
- // Container for restore job parameters.
- RestoreRequest *RestoreRequest `locationName:"RestoreRequest" type:"structure" xmlURI:"http://s3.amazonaws.com/doc/2006-03-01/"`
- // VersionId used to reference a specific version of the object.
- VersionId *string `location:"querystring" locationName:"versionId" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s RestoreObjectInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s RestoreObjectInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *RestoreObjectInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "RestoreObjectInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.Key == nil {
- invalidParams.Add(request.NewErrParamRequired("Key"))
- }
- if s.Key != nil && len(*s.Key) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Key", 1))
- }
- if s.RestoreRequest != nil {
- if err := s.RestoreRequest.Validate(); err != nil {
- invalidParams.AddNested("RestoreRequest", err.(request.ErrInvalidParams))
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *RestoreObjectInput) SetBucket(v string) *RestoreObjectInput {
- s.Bucket = &v
- return s
- }
- func (s *RestoreObjectInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetChecksumAlgorithm sets the ChecksumAlgorithm field's value.
- func (s *RestoreObjectInput) SetChecksumAlgorithm(v string) *RestoreObjectInput {
- s.ChecksumAlgorithm = &v
- return s
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *RestoreObjectInput) SetExpectedBucketOwner(v string) *RestoreObjectInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetKey sets the Key field's value.
- func (s *RestoreObjectInput) SetKey(v string) *RestoreObjectInput {
- s.Key = &v
- return s
- }
- // SetRequestPayer sets the RequestPayer field's value.
- func (s *RestoreObjectInput) SetRequestPayer(v string) *RestoreObjectInput {
- s.RequestPayer = &v
- return s
- }
- // SetRestoreRequest sets the RestoreRequest field's value.
- func (s *RestoreObjectInput) SetRestoreRequest(v *RestoreRequest) *RestoreObjectInput {
- s.RestoreRequest = v
- return s
- }
- // SetVersionId sets the VersionId field's value.
- func (s *RestoreObjectInput) SetVersionId(v string) *RestoreObjectInput {
- s.VersionId = &v
- return s
- }
- func (s *RestoreObjectInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *RestoreObjectInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s RestoreObjectInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type RestoreObjectOutput struct {
- _ struct{} `type:"structure"`
- // If present, indicates that the requester was successfully charged for the
- // request.
- RequestCharged *string `location:"header" locationName:"x-amz-request-charged" type:"string" enum:"RequestCharged"`
- // Indicates the path in the provided S3 output location where Select results
- // will be restored to.
- RestoreOutputPath *string `location:"header" locationName:"x-amz-restore-output-path" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s RestoreObjectOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s RestoreObjectOutput) GoString() string {
- return s.String()
- }
- // SetRequestCharged sets the RequestCharged field's value.
- func (s *RestoreObjectOutput) SetRequestCharged(v string) *RestoreObjectOutput {
- s.RequestCharged = &v
- return s
- }
- // SetRestoreOutputPath sets the RestoreOutputPath field's value.
- func (s *RestoreObjectOutput) SetRestoreOutputPath(v string) *RestoreObjectOutput {
- s.RestoreOutputPath = &v
- return s
- }
- // Container for restore job parameters.
- type RestoreRequest struct {
- _ struct{} `type:"structure"`
- // Lifetime of the active copy in days. Do not use with restores that specify
- // OutputLocation.
- //
- // The Days element is required for regular restores, and must not be provided
- // for select requests.
- Days *int64 `type:"integer"`
- // The optional description for the job.
- Description *string `type:"string"`
- // S3 Glacier related parameters pertaining to this job. Do not use with restores
- // that specify OutputLocation.
- GlacierJobParameters *GlacierJobParameters `type:"structure"`
- // Describes the location where the restore job's output is stored.
- OutputLocation *OutputLocation `type:"structure"`
- // Describes the parameters for Select job types.
- SelectParameters *SelectParameters `type:"structure"`
- // Retrieval tier at which the restore will be processed.
- Tier *string `type:"string" enum:"Tier"`
- // Type of restore request.
- Type *string `type:"string" enum:"RestoreRequestType"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s RestoreRequest) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s RestoreRequest) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *RestoreRequest) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "RestoreRequest"}
- if s.GlacierJobParameters != nil {
- if err := s.GlacierJobParameters.Validate(); err != nil {
- invalidParams.AddNested("GlacierJobParameters", err.(request.ErrInvalidParams))
- }
- }
- if s.OutputLocation != nil {
- if err := s.OutputLocation.Validate(); err != nil {
- invalidParams.AddNested("OutputLocation", err.(request.ErrInvalidParams))
- }
- }
- if s.SelectParameters != nil {
- if err := s.SelectParameters.Validate(); err != nil {
- invalidParams.AddNested("SelectParameters", err.(request.ErrInvalidParams))
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetDays sets the Days field's value.
- func (s *RestoreRequest) SetDays(v int64) *RestoreRequest {
- s.Days = &v
- return s
- }
- // SetDescription sets the Description field's value.
- func (s *RestoreRequest) SetDescription(v string) *RestoreRequest {
- s.Description = &v
- return s
- }
- // SetGlacierJobParameters sets the GlacierJobParameters field's value.
- func (s *RestoreRequest) SetGlacierJobParameters(v *GlacierJobParameters) *RestoreRequest {
- s.GlacierJobParameters = v
- return s
- }
- // SetOutputLocation sets the OutputLocation field's value.
- func (s *RestoreRequest) SetOutputLocation(v *OutputLocation) *RestoreRequest {
- s.OutputLocation = v
- return s
- }
- // SetSelectParameters sets the SelectParameters field's value.
- func (s *RestoreRequest) SetSelectParameters(v *SelectParameters) *RestoreRequest {
- s.SelectParameters = v
- return s
- }
- // SetTier sets the Tier field's value.
- func (s *RestoreRequest) SetTier(v string) *RestoreRequest {
- s.Tier = &v
- return s
- }
- // SetType sets the Type field's value.
- func (s *RestoreRequest) SetType(v string) *RestoreRequest {
- s.Type = &v
- return s
- }
- // Specifies the redirect behavior and when a redirect is applied. For more
- // information about routing rules, see Configuring advanced conditional redirects
- // (https://docs.aws.amazon.com/AmazonS3/latest/dev/how-to-page-redirect.html#advanced-conditional-redirects)
- // in the Amazon S3 User Guide.
- type RoutingRule struct {
- _ struct{} `type:"structure"`
- // A container for describing a condition that must be met for the specified
- // redirect to apply. For example, 1. If request is for pages in the /docs folder,
- // redirect to the /documents folder. 2. If request results in HTTP error 4xx,
- // redirect request to another host where you might process the error.
- Condition *Condition `type:"structure"`
- // Container for redirect information. You can redirect requests to another
- // host, to another page, or with another protocol. In the event of an error,
- // you can specify a different error code to return.
- //
- // Redirect is a required field
- Redirect *Redirect `type:"structure" required:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s RoutingRule) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s RoutingRule) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *RoutingRule) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "RoutingRule"}
- if s.Redirect == nil {
- invalidParams.Add(request.NewErrParamRequired("Redirect"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetCondition sets the Condition field's value.
- func (s *RoutingRule) SetCondition(v *Condition) *RoutingRule {
- s.Condition = v
- return s
- }
- // SetRedirect sets the Redirect field's value.
- func (s *RoutingRule) SetRedirect(v *Redirect) *RoutingRule {
- s.Redirect = v
- return s
- }
- // Specifies lifecycle rules for an Amazon S3 bucket. For more information,
- // see Put Bucket Lifecycle Configuration (https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTlifecycle.html)
- // in the Amazon S3 API Reference. For examples, see Put Bucket Lifecycle Configuration
- // Examples (https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html#API_PutBucketLifecycleConfiguration_Examples).
- type Rule struct {
- _ struct{} `type:"structure"`
- // Specifies the days since the initiation of an incomplete multipart upload
- // that Amazon S3 will wait before permanently removing all parts of the upload.
- // For more information, see Aborting Incomplete Multipart Uploads Using a Bucket
- // Lifecycle Policy (https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html#mpu-abort-incomplete-mpu-lifecycle-config)
- // in the Amazon S3 User Guide.
- AbortIncompleteMultipartUpload *AbortIncompleteMultipartUpload `type:"structure"`
- // Specifies the expiration for the lifecycle of the object.
- Expiration *LifecycleExpiration `type:"structure"`
- // Unique identifier for the rule. The value can't be longer than 255 characters.
- ID *string `type:"string"`
- // Specifies when noncurrent object versions expire. Upon expiration, Amazon
- // S3 permanently deletes the noncurrent object versions. You set this lifecycle
- // configuration action on a bucket that has versioning enabled (or suspended)
- // to request that Amazon S3 delete noncurrent object versions at a specific
- // period in the object's lifetime.
- NoncurrentVersionExpiration *NoncurrentVersionExpiration `type:"structure"`
- // Container for the transition rule that describes when noncurrent objects
- // transition to the STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER_IR,
- // GLACIER, or DEEP_ARCHIVE storage class. If your bucket is versioning-enabled
- // (or versioning is suspended), you can set this action to request that Amazon
- // S3 transition noncurrent object versions to the STANDARD_IA, ONEZONE_IA,
- // INTELLIGENT_TIERING, GLACIER_IR, GLACIER, or DEEP_ARCHIVE storage class at
- // a specific period in the object's lifetime.
- NoncurrentVersionTransition *NoncurrentVersionTransition `type:"structure"`
- // Object key prefix that identifies one or more objects to which this rule
- // applies.
- //
- // Replacement must be made for object keys containing special characters (such
- // as carriage returns) when using XML requests. For more information, see XML
- // related object key constraints (https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html#object-key-xml-related-constraints).
- //
- // Prefix is a required field
- Prefix *string `type:"string" required:"true"`
- // If Enabled, the rule is currently being applied. If Disabled, the rule is
- // not currently being applied.
- //
- // Status is a required field
- Status *string `type:"string" required:"true" enum:"ExpirationStatus"`
- // Specifies when an object transitions to a specified storage class. For more
- // information about Amazon S3 lifecycle configuration rules, see Transitioning
- // Objects Using Amazon S3 Lifecycle (https://docs.aws.amazon.com/AmazonS3/latest/dev/lifecycle-transition-general-considerations.html)
- // in the Amazon S3 User Guide.
- Transition *Transition `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s Rule) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s Rule) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *Rule) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "Rule"}
- if s.Prefix == nil {
- invalidParams.Add(request.NewErrParamRequired("Prefix"))
- }
- if s.Status == nil {
- invalidParams.Add(request.NewErrParamRequired("Status"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetAbortIncompleteMultipartUpload sets the AbortIncompleteMultipartUpload field's value.
- func (s *Rule) SetAbortIncompleteMultipartUpload(v *AbortIncompleteMultipartUpload) *Rule {
- s.AbortIncompleteMultipartUpload = v
- return s
- }
- // SetExpiration sets the Expiration field's value.
- func (s *Rule) SetExpiration(v *LifecycleExpiration) *Rule {
- s.Expiration = v
- return s
- }
- // SetID sets the ID field's value.
- func (s *Rule) SetID(v string) *Rule {
- s.ID = &v
- return s
- }
- // SetNoncurrentVersionExpiration sets the NoncurrentVersionExpiration field's value.
- func (s *Rule) SetNoncurrentVersionExpiration(v *NoncurrentVersionExpiration) *Rule {
- s.NoncurrentVersionExpiration = v
- return s
- }
- // SetNoncurrentVersionTransition sets the NoncurrentVersionTransition field's value.
- func (s *Rule) SetNoncurrentVersionTransition(v *NoncurrentVersionTransition) *Rule {
- s.NoncurrentVersionTransition = v
- return s
- }
- // SetPrefix sets the Prefix field's value.
- func (s *Rule) SetPrefix(v string) *Rule {
- s.Prefix = &v
- return s
- }
- // SetStatus sets the Status field's value.
- func (s *Rule) SetStatus(v string) *Rule {
- s.Status = &v
- return s
- }
- // SetTransition sets the Transition field's value.
- func (s *Rule) SetTransition(v *Transition) *Rule {
- s.Transition = v
- return s
- }
- // Specifies the use of SSE-KMS to encrypt delivered inventory reports.
- type SSEKMS struct {
- _ struct{} `locationName:"SSE-KMS" type:"structure"`
- // Specifies the ID of the Amazon Web Services Key Management Service (Amazon
- // Web Services KMS) symmetric customer managed key to use for encrypting inventory
- // reports.
- //
- // KeyId is a sensitive parameter and its value will be
- // replaced with "sensitive" in string returned by SSEKMS's
- // String and GoString methods.
- //
- // KeyId is a required field
- KeyId *string `type:"string" required:"true" sensitive:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s SSEKMS) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s SSEKMS) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *SSEKMS) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "SSEKMS"}
- if s.KeyId == nil {
- invalidParams.Add(request.NewErrParamRequired("KeyId"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetKeyId sets the KeyId field's value.
- func (s *SSEKMS) SetKeyId(v string) *SSEKMS {
- s.KeyId = &v
- return s
- }
- // Specifies the use of SSE-S3 to encrypt delivered inventory reports.
- type SSES3 struct {
- _ struct{} `locationName:"SSE-S3" type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s SSES3) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s SSES3) GoString() string {
- return s.String()
- }
- // Specifies the byte range of the object to get the records from. A record
- // is processed when its first byte is contained by the range. This parameter
- // is optional, but when specified, it must not be empty. See RFC 2616, Section
- // 14.35.1 about how to specify the start and end of the range.
- type ScanRange struct {
- _ struct{} `type:"structure"`
- // Specifies the end of the byte range. This parameter is optional. Valid values:
- // non-negative integers. The default value is one less than the size of the
- // object being queried. If only the End parameter is supplied, it is interpreted
- // to mean scan the last N bytes of the file. For example, <scanrange><end>50</end></scanrange>
- // means scan the last 50 bytes.
- End *int64 `type:"long"`
- // Specifies the start of the byte range. This parameter is optional. Valid
- // values: non-negative integers. The default value is 0. If only start is supplied,
- // it means scan from that point to the end of the file. For example, <scanrange><start>50</start></scanrange>
- // means scan from byte 50 until the end of the file.
- Start *int64 `type:"long"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ScanRange) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ScanRange) GoString() string {
- return s.String()
- }
- // SetEnd sets the End field's value.
- func (s *ScanRange) SetEnd(v int64) *ScanRange {
- s.End = &v
- return s
- }
- // SetStart sets the Start field's value.
- func (s *ScanRange) SetStart(v int64) *ScanRange {
- s.Start = &v
- return s
- }
- // SelectObjectContentEventStreamEvent groups together all EventStream
- // events writes for SelectObjectContentEventStream.
- //
- // These events are:
- //
- // - ContinuationEvent
- // - EndEvent
- // - ProgressEvent
- // - RecordsEvent
- // - StatsEvent
- type SelectObjectContentEventStreamEvent interface {
- eventSelectObjectContentEventStream()
- eventstreamapi.Marshaler
- eventstreamapi.Unmarshaler
- }
- // SelectObjectContentEventStreamReader provides the interface for reading to the stream. The
- // default implementation for this interface will be SelectObjectContentEventStreamData.
- //
- // The reader's Close method must allow multiple concurrent calls.
- //
- // These events are:
- //
- // - ContinuationEvent
- // - EndEvent
- // - ProgressEvent
- // - RecordsEvent
- // - StatsEvent
- // - SelectObjectContentEventStreamUnknownEvent
- type SelectObjectContentEventStreamReader interface {
- // Returns a channel of events as they are read from the event stream.
- Events() <-chan SelectObjectContentEventStreamEvent
- // Close will stop the reader reading events from the stream.
- Close() error
- // Returns any error that has occurred while reading from the event stream.
- Err() error
- }
- type readSelectObjectContentEventStream struct {
- eventReader *eventstreamapi.EventReader
- stream chan SelectObjectContentEventStreamEvent
- err *eventstreamapi.OnceError
- done chan struct{}
- closeOnce sync.Once
- }
- func newReadSelectObjectContentEventStream(eventReader *eventstreamapi.EventReader) *readSelectObjectContentEventStream {
- r := &readSelectObjectContentEventStream{
- eventReader: eventReader,
- stream: make(chan SelectObjectContentEventStreamEvent),
- done: make(chan struct{}),
- err: eventstreamapi.NewOnceError(),
- }
- go r.readEventStream()
- return r
- }
- // Close will close the underlying event stream reader.
- func (r *readSelectObjectContentEventStream) Close() error {
- r.closeOnce.Do(r.safeClose)
- return r.Err()
- }
- func (r *readSelectObjectContentEventStream) ErrorSet() <-chan struct{} {
- return r.err.ErrorSet()
- }
- func (r *readSelectObjectContentEventStream) Closed() <-chan struct{} {
- return r.done
- }
- func (r *readSelectObjectContentEventStream) safeClose() {
- close(r.done)
- }
- func (r *readSelectObjectContentEventStream) Err() error {
- return r.err.Err()
- }
- func (r *readSelectObjectContentEventStream) Events() <-chan SelectObjectContentEventStreamEvent {
- return r.stream
- }
- func (r *readSelectObjectContentEventStream) readEventStream() {
- defer r.Close()
- defer close(r.stream)
- for {
- event, err := r.eventReader.ReadEvent()
- if err != nil {
- if err == io.EOF {
- return
- }
- select {
- case <-r.done:
- // If closed already ignore the error
- return
- default:
- }
- if _, ok := err.(*eventstreamapi.UnknownMessageTypeError); ok {
- continue
- }
- r.err.SetError(err)
- return
- }
- select {
- case r.stream <- event.(SelectObjectContentEventStreamEvent):
- case <-r.done:
- return
- }
- }
- }
- type unmarshalerForSelectObjectContentEventStreamEvent struct {
- metadata protocol.ResponseMetadata
- }
- func (u unmarshalerForSelectObjectContentEventStreamEvent) UnmarshalerForEventName(eventType string) (eventstreamapi.Unmarshaler, error) {
- switch eventType {
- case "Cont":
- return &ContinuationEvent{}, nil
- case "End":
- return &EndEvent{}, nil
- case "Progress":
- return &ProgressEvent{}, nil
- case "Records":
- return &RecordsEvent{}, nil
- case "Stats":
- return &StatsEvent{}, nil
- default:
- return &SelectObjectContentEventStreamUnknownEvent{Type: eventType}, nil
- }
- }
- // SelectObjectContentEventStreamUnknownEvent provides a failsafe event for the
- // SelectObjectContentEventStream group of events when an unknown event is received.
- type SelectObjectContentEventStreamUnknownEvent struct {
- Type string
- Message eventstream.Message
- }
- // The SelectObjectContentEventStreamUnknownEvent is and event in the SelectObjectContentEventStream
- // group of events.
- func (s *SelectObjectContentEventStreamUnknownEvent) eventSelectObjectContentEventStream() {}
- // MarshalEvent marshals the type into an stream event value. This method
- // should only used internally within the SDK's EventStream handling.
- func (e *SelectObjectContentEventStreamUnknownEvent) MarshalEvent(pm protocol.PayloadMarshaler) (
- msg eventstream.Message, err error,
- ) {
- return e.Message.Clone(), nil
- }
- // UnmarshalEvent unmarshals the EventStream Message into the SelectObjectContentEventStreamData value.
- // This method is only used internally within the SDK's EventStream handling.
- func (e *SelectObjectContentEventStreamUnknownEvent) UnmarshalEvent(
- payloadUnmarshaler protocol.PayloadUnmarshaler,
- msg eventstream.Message,
- ) error {
- e.Message = msg.Clone()
- return nil
- }
- // Request to filter the contents of an Amazon S3 object based on a simple Structured
- // Query Language (SQL) statement. In the request, along with the SQL expression,
- // you must specify a data serialization format (JSON or CSV) of the object.
- // Amazon S3 uses this to parse object data into records. It returns only records
- // that match the specified SQL expression. You must also specify the data serialization
- // format for the response. For more information, see S3Select API Documentation
- // (https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectSELECTContent.html).
- type SelectObjectContentInput struct {
- _ struct{} `locationName:"SelectObjectContentRequest" type:"structure" xmlURI:"http://s3.amazonaws.com/doc/2006-03-01/"`
- // The S3 bucket.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // The expression that is used to query the object.
- //
- // Expression is a required field
- Expression *string `type:"string" required:"true"`
- // The type of the provided expression (for example, SQL).
- //
- // ExpressionType is a required field
- ExpressionType *string `type:"string" required:"true" enum:"ExpressionType"`
- // Describes the format of the data in the object that is being queried.
- //
- // InputSerialization is a required field
- InputSerialization *InputSerialization `type:"structure" required:"true"`
- // The object key.
- //
- // Key is a required field
- Key *string `location:"uri" locationName:"Key" min:"1" type:"string" required:"true"`
- // Describes the format of the data that you want Amazon S3 to return in response.
- //
- // OutputSerialization is a required field
- OutputSerialization *OutputSerialization `type:"structure" required:"true"`
- // Specifies if periodic request progress information should be enabled.
- RequestProgress *RequestProgress `type:"structure"`
- // The server-side encryption (SSE) algorithm used to encrypt the object. This
- // parameter is needed only when the object was created using a checksum algorithm.
- // For more information, see Protecting data using SSE-C keys (https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html)
- // in the Amazon S3 User Guide.
- SSECustomerAlgorithm *string `location:"header" locationName:"x-amz-server-side-encryption-customer-algorithm" type:"string"`
- // The server-side encryption (SSE) customer managed key. This parameter is
- // needed only when the object was created using a checksum algorithm. For more
- // information, see Protecting data using SSE-C keys (https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html)
- // in the Amazon S3 User Guide.
- //
- // SSECustomerKey is a sensitive parameter and its value will be
- // replaced with "sensitive" in string returned by SelectObjectContentInput's
- // String and GoString methods.
- SSECustomerKey *string `marshal-as:"blob" location:"header" locationName:"x-amz-server-side-encryption-customer-key" type:"string" sensitive:"true"`
- // The MD5 server-side encryption (SSE) customer managed key. This parameter
- // is needed only when the object was created using a checksum algorithm. For
- // more information, see Protecting data using SSE-C keys (https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html)
- // in the Amazon S3 User Guide.
- SSECustomerKeyMD5 *string `location:"header" locationName:"x-amz-server-side-encryption-customer-key-MD5" type:"string"`
- // Specifies the byte range of the object to get the records from. A record
- // is processed when its first byte is contained by the range. This parameter
- // is optional, but when specified, it must not be empty. See RFC 2616, Section
- // 14.35.1 about how to specify the start and end of the range.
- //
- // ScanRangemay be used in the following ways:
- //
- // * <scanrange><start>50</start><end>100</end></scanrange> - process only
- // the records starting between the bytes 50 and 100 (inclusive, counting
- // from zero)
- //
- // * <scanrange><start>50</start></scanrange> - process only the records
- // starting after the byte 50
- //
- // * <scanrange><end>50</end></scanrange> - process only the records within
- // the last 50 bytes of the file.
- ScanRange *ScanRange `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s SelectObjectContentInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s SelectObjectContentInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *SelectObjectContentInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "SelectObjectContentInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.Expression == nil {
- invalidParams.Add(request.NewErrParamRequired("Expression"))
- }
- if s.ExpressionType == nil {
- invalidParams.Add(request.NewErrParamRequired("ExpressionType"))
- }
- if s.InputSerialization == nil {
- invalidParams.Add(request.NewErrParamRequired("InputSerialization"))
- }
- if s.Key == nil {
- invalidParams.Add(request.NewErrParamRequired("Key"))
- }
- if s.Key != nil && len(*s.Key) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Key", 1))
- }
- if s.OutputSerialization == nil {
- invalidParams.Add(request.NewErrParamRequired("OutputSerialization"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *SelectObjectContentInput) SetBucket(v string) *SelectObjectContentInput {
- s.Bucket = &v
- return s
- }
- func (s *SelectObjectContentInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *SelectObjectContentInput) SetExpectedBucketOwner(v string) *SelectObjectContentInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetExpression sets the Expression field's value.
- func (s *SelectObjectContentInput) SetExpression(v string) *SelectObjectContentInput {
- s.Expression = &v
- return s
- }
- // SetExpressionType sets the ExpressionType field's value.
- func (s *SelectObjectContentInput) SetExpressionType(v string) *SelectObjectContentInput {
- s.ExpressionType = &v
- return s
- }
- // SetInputSerialization sets the InputSerialization field's value.
- func (s *SelectObjectContentInput) SetInputSerialization(v *InputSerialization) *SelectObjectContentInput {
- s.InputSerialization = v
- return s
- }
- // SetKey sets the Key field's value.
- func (s *SelectObjectContentInput) SetKey(v string) *SelectObjectContentInput {
- s.Key = &v
- return s
- }
- // SetOutputSerialization sets the OutputSerialization field's value.
- func (s *SelectObjectContentInput) SetOutputSerialization(v *OutputSerialization) *SelectObjectContentInput {
- s.OutputSerialization = v
- return s
- }
- // SetRequestProgress sets the RequestProgress field's value.
- func (s *SelectObjectContentInput) SetRequestProgress(v *RequestProgress) *SelectObjectContentInput {
- s.RequestProgress = v
- return s
- }
- // SetSSECustomerAlgorithm sets the SSECustomerAlgorithm field's value.
- func (s *SelectObjectContentInput) SetSSECustomerAlgorithm(v string) *SelectObjectContentInput {
- s.SSECustomerAlgorithm = &v
- return s
- }
- // SetSSECustomerKey sets the SSECustomerKey field's value.
- func (s *SelectObjectContentInput) SetSSECustomerKey(v string) *SelectObjectContentInput {
- s.SSECustomerKey = &v
- return s
- }
- func (s *SelectObjectContentInput) getSSECustomerKey() (v string) {
- if s.SSECustomerKey == nil {
- return v
- }
- return *s.SSECustomerKey
- }
- // SetSSECustomerKeyMD5 sets the SSECustomerKeyMD5 field's value.
- func (s *SelectObjectContentInput) SetSSECustomerKeyMD5(v string) *SelectObjectContentInput {
- s.SSECustomerKeyMD5 = &v
- return s
- }
- // SetScanRange sets the ScanRange field's value.
- func (s *SelectObjectContentInput) SetScanRange(v *ScanRange) *SelectObjectContentInput {
- s.ScanRange = v
- return s
- }
- func (s *SelectObjectContentInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *SelectObjectContentInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s SelectObjectContentInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type SelectObjectContentOutput struct {
- _ struct{} `type:"structure" payload:"Payload"`
- EventStream *SelectObjectContentEventStream
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s SelectObjectContentOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s SelectObjectContentOutput) GoString() string {
- return s.String()
- }
- func (s *SelectObjectContentOutput) SetEventStream(v *SelectObjectContentEventStream) *SelectObjectContentOutput {
- s.EventStream = v
- return s
- }
- func (s *SelectObjectContentOutput) GetEventStream() *SelectObjectContentEventStream {
- return s.EventStream
- }
- // GetStream returns the type to interact with the event stream.
- func (s *SelectObjectContentOutput) GetStream() *SelectObjectContentEventStream {
- return s.EventStream
- }
- // Describes the parameters for Select job types.
- type SelectParameters struct {
- _ struct{} `type:"structure"`
- // The expression that is used to query the object.
- //
- // Expression is a required field
- Expression *string `type:"string" required:"true"`
- // The type of the provided expression (for example, SQL).
- //
- // ExpressionType is a required field
- ExpressionType *string `type:"string" required:"true" enum:"ExpressionType"`
- // Describes the serialization format of the object.
- //
- // InputSerialization is a required field
- InputSerialization *InputSerialization `type:"structure" required:"true"`
- // Describes how the results of the Select job are serialized.
- //
- // OutputSerialization is a required field
- OutputSerialization *OutputSerialization `type:"structure" required:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s SelectParameters) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s SelectParameters) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *SelectParameters) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "SelectParameters"}
- if s.Expression == nil {
- invalidParams.Add(request.NewErrParamRequired("Expression"))
- }
- if s.ExpressionType == nil {
- invalidParams.Add(request.NewErrParamRequired("ExpressionType"))
- }
- if s.InputSerialization == nil {
- invalidParams.Add(request.NewErrParamRequired("InputSerialization"))
- }
- if s.OutputSerialization == nil {
- invalidParams.Add(request.NewErrParamRequired("OutputSerialization"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetExpression sets the Expression field's value.
- func (s *SelectParameters) SetExpression(v string) *SelectParameters {
- s.Expression = &v
- return s
- }
- // SetExpressionType sets the ExpressionType field's value.
- func (s *SelectParameters) SetExpressionType(v string) *SelectParameters {
- s.ExpressionType = &v
- return s
- }
- // SetInputSerialization sets the InputSerialization field's value.
- func (s *SelectParameters) SetInputSerialization(v *InputSerialization) *SelectParameters {
- s.InputSerialization = v
- return s
- }
- // SetOutputSerialization sets the OutputSerialization field's value.
- func (s *SelectParameters) SetOutputSerialization(v *OutputSerialization) *SelectParameters {
- s.OutputSerialization = v
- return s
- }
- // Describes the default server-side encryption to apply to new objects in the
- // bucket. If a PUT Object request doesn't specify any server-side encryption,
- // this default encryption will be applied. If you don't specify a customer
- // managed key at configuration, Amazon S3 automatically creates an Amazon Web
- // Services KMS key in your Amazon Web Services account the first time that
- // you add an object encrypted with SSE-KMS to a bucket. By default, Amazon
- // S3 uses this KMS key for SSE-KMS. For more information, see PUT Bucket encryption
- // (https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTencryption.html)
- // in the Amazon S3 API Reference.
- type ServerSideEncryptionByDefault struct {
- _ struct{} `type:"structure"`
- // Amazon Web Services Key Management Service (KMS) customer Amazon Web Services
- // KMS key ID to use for the default encryption. This parameter is allowed if
- // and only if SSEAlgorithm is set to aws:kms.
- //
- // You can specify the key ID or the Amazon Resource Name (ARN) of the KMS key.
- // However, if you are using encryption with cross-account or Amazon Web Services
- // service operations you must use a fully qualified KMS key ARN. For more information,
- // see Using encryption for cross-account operations (https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html#bucket-encryption-update-bucket-policy).
- //
- // For example:
- //
- // * Key ID: 1234abcd-12ab-34cd-56ef-1234567890ab
- //
- // * Key ARN: arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab
- //
- // Amazon S3 only supports symmetric KMS keys and not asymmetric KMS keys. For
- // more information, see Using symmetric and asymmetric keys (https://docs.aws.amazon.com/kms/latest/developerguide/symmetric-asymmetric.html)
- // in the Amazon Web Services Key Management Service Developer Guide.
- //
- // KMSMasterKeyID is a sensitive parameter and its value will be
- // replaced with "sensitive" in string returned by ServerSideEncryptionByDefault's
- // String and GoString methods.
- KMSMasterKeyID *string `type:"string" sensitive:"true"`
- // Server-side encryption algorithm to use for the default encryption.
- //
- // SSEAlgorithm is a required field
- SSEAlgorithm *string `type:"string" required:"true" enum:"ServerSideEncryption"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ServerSideEncryptionByDefault) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ServerSideEncryptionByDefault) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *ServerSideEncryptionByDefault) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "ServerSideEncryptionByDefault"}
- if s.SSEAlgorithm == nil {
- invalidParams.Add(request.NewErrParamRequired("SSEAlgorithm"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetKMSMasterKeyID sets the KMSMasterKeyID field's value.
- func (s *ServerSideEncryptionByDefault) SetKMSMasterKeyID(v string) *ServerSideEncryptionByDefault {
- s.KMSMasterKeyID = &v
- return s
- }
- // SetSSEAlgorithm sets the SSEAlgorithm field's value.
- func (s *ServerSideEncryptionByDefault) SetSSEAlgorithm(v string) *ServerSideEncryptionByDefault {
- s.SSEAlgorithm = &v
- return s
- }
- // Specifies the default server-side-encryption configuration.
- type ServerSideEncryptionConfiguration struct {
- _ struct{} `type:"structure"`
- // Container for information about a particular server-side encryption configuration
- // rule.
- //
- // Rules is a required field
- Rules []*ServerSideEncryptionRule `locationName:"Rule" type:"list" flattened:"true" required:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ServerSideEncryptionConfiguration) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ServerSideEncryptionConfiguration) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *ServerSideEncryptionConfiguration) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "ServerSideEncryptionConfiguration"}
- if s.Rules == nil {
- invalidParams.Add(request.NewErrParamRequired("Rules"))
- }
- if s.Rules != nil {
- for i, v := range s.Rules {
- if v == nil {
- continue
- }
- if err := v.Validate(); err != nil {
- invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Rules", i), err.(request.ErrInvalidParams))
- }
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetRules sets the Rules field's value.
- func (s *ServerSideEncryptionConfiguration) SetRules(v []*ServerSideEncryptionRule) *ServerSideEncryptionConfiguration {
- s.Rules = v
- return s
- }
- // Specifies the default server-side encryption configuration.
- type ServerSideEncryptionRule struct {
- _ struct{} `type:"structure"`
- // Specifies the default server-side encryption to apply to new objects in the
- // bucket. If a PUT Object request doesn't specify any server-side encryption,
- // this default encryption will be applied.
- ApplyServerSideEncryptionByDefault *ServerSideEncryptionByDefault `type:"structure"`
- // Specifies whether Amazon S3 should use an S3 Bucket Key with server-side
- // encryption using KMS (SSE-KMS) for new objects in the bucket. Existing objects
- // are not affected. Setting the BucketKeyEnabled element to true causes Amazon
- // S3 to use an S3 Bucket Key. By default, S3 Bucket Key is not enabled.
- //
- // For more information, see Amazon S3 Bucket Keys (https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-key.html)
- // in the Amazon S3 User Guide.
- BucketKeyEnabled *bool `type:"boolean"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ServerSideEncryptionRule) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s ServerSideEncryptionRule) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *ServerSideEncryptionRule) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "ServerSideEncryptionRule"}
- if s.ApplyServerSideEncryptionByDefault != nil {
- if err := s.ApplyServerSideEncryptionByDefault.Validate(); err != nil {
- invalidParams.AddNested("ApplyServerSideEncryptionByDefault", err.(request.ErrInvalidParams))
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetApplyServerSideEncryptionByDefault sets the ApplyServerSideEncryptionByDefault field's value.
- func (s *ServerSideEncryptionRule) SetApplyServerSideEncryptionByDefault(v *ServerSideEncryptionByDefault) *ServerSideEncryptionRule {
- s.ApplyServerSideEncryptionByDefault = v
- return s
- }
- // SetBucketKeyEnabled sets the BucketKeyEnabled field's value.
- func (s *ServerSideEncryptionRule) SetBucketKeyEnabled(v bool) *ServerSideEncryptionRule {
- s.BucketKeyEnabled = &v
- return s
- }
- // A container that describes additional filters for identifying the source
- // objects that you want to replicate. You can choose to enable or disable the
- // replication of these objects. Currently, Amazon S3 supports only the filter
- // that you can specify for objects created with server-side encryption using
- // a customer managed key stored in Amazon Web Services Key Management Service
- // (SSE-KMS).
- type SourceSelectionCriteria struct {
- _ struct{} `type:"structure"`
- // A filter that you can specify for selections for modifications on replicas.
- // Amazon S3 doesn't replicate replica modifications by default. In the latest
- // version of replication configuration (when Filter is specified), you can
- // specify this element and set the status to Enabled to replicate modifications
- // on replicas.
- //
- // If you don't specify the Filter element, Amazon S3 assumes that the replication
- // configuration is the earlier version, V1. In the earlier version, this element
- // is not allowed
- ReplicaModifications *ReplicaModifications `type:"structure"`
- // A container for filter information for the selection of Amazon S3 objects
- // encrypted with Amazon Web Services KMS. If you include SourceSelectionCriteria
- // in the replication configuration, this element is required.
- SseKmsEncryptedObjects *SseKmsEncryptedObjects `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s SourceSelectionCriteria) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s SourceSelectionCriteria) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *SourceSelectionCriteria) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "SourceSelectionCriteria"}
- if s.ReplicaModifications != nil {
- if err := s.ReplicaModifications.Validate(); err != nil {
- invalidParams.AddNested("ReplicaModifications", err.(request.ErrInvalidParams))
- }
- }
- if s.SseKmsEncryptedObjects != nil {
- if err := s.SseKmsEncryptedObjects.Validate(); err != nil {
- invalidParams.AddNested("SseKmsEncryptedObjects", err.(request.ErrInvalidParams))
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetReplicaModifications sets the ReplicaModifications field's value.
- func (s *SourceSelectionCriteria) SetReplicaModifications(v *ReplicaModifications) *SourceSelectionCriteria {
- s.ReplicaModifications = v
- return s
- }
- // SetSseKmsEncryptedObjects sets the SseKmsEncryptedObjects field's value.
- func (s *SourceSelectionCriteria) SetSseKmsEncryptedObjects(v *SseKmsEncryptedObjects) *SourceSelectionCriteria {
- s.SseKmsEncryptedObjects = v
- return s
- }
- // A container for filter information for the selection of S3 objects encrypted
- // with Amazon Web Services KMS.
- type SseKmsEncryptedObjects struct {
- _ struct{} `type:"structure"`
- // Specifies whether Amazon S3 replicates objects created with server-side encryption
- // using an Amazon Web Services KMS key stored in Amazon Web Services Key Management
- // Service.
- //
- // Status is a required field
- Status *string `type:"string" required:"true" enum:"SseKmsEncryptedObjectsStatus"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s SseKmsEncryptedObjects) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s SseKmsEncryptedObjects) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *SseKmsEncryptedObjects) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "SseKmsEncryptedObjects"}
- if s.Status == nil {
- invalidParams.Add(request.NewErrParamRequired("Status"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetStatus sets the Status field's value.
- func (s *SseKmsEncryptedObjects) SetStatus(v string) *SseKmsEncryptedObjects {
- s.Status = &v
- return s
- }
- // Container for the stats details.
- type Stats struct {
- _ struct{} `type:"structure"`
- // The total number of uncompressed object bytes processed.
- BytesProcessed *int64 `type:"long"`
- // The total number of bytes of records payload data returned.
- BytesReturned *int64 `type:"long"`
- // The total number of object bytes scanned.
- BytesScanned *int64 `type:"long"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s Stats) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s Stats) GoString() string {
- return s.String()
- }
- // SetBytesProcessed sets the BytesProcessed field's value.
- func (s *Stats) SetBytesProcessed(v int64) *Stats {
- s.BytesProcessed = &v
- return s
- }
- // SetBytesReturned sets the BytesReturned field's value.
- func (s *Stats) SetBytesReturned(v int64) *Stats {
- s.BytesReturned = &v
- return s
- }
- // SetBytesScanned sets the BytesScanned field's value.
- func (s *Stats) SetBytesScanned(v int64) *Stats {
- s.BytesScanned = &v
- return s
- }
- // Container for the Stats Event.
- type StatsEvent struct {
- _ struct{} `locationName:"StatsEvent" type:"structure" payload:"Details"`
- // The Stats event details.
- Details *Stats `locationName:"Details" type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s StatsEvent) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s StatsEvent) GoString() string {
- return s.String()
- }
- // SetDetails sets the Details field's value.
- func (s *StatsEvent) SetDetails(v *Stats) *StatsEvent {
- s.Details = v
- return s
- }
- // The StatsEvent is and event in the SelectObjectContentEventStream group of events.
- func (s *StatsEvent) eventSelectObjectContentEventStream() {}
- // UnmarshalEvent unmarshals the EventStream Message into the StatsEvent value.
- // This method is only used internally within the SDK's EventStream handling.
- func (s *StatsEvent) UnmarshalEvent(
- payloadUnmarshaler protocol.PayloadUnmarshaler,
- msg eventstream.Message,
- ) error {
- if err := payloadUnmarshaler.UnmarshalPayload(
- bytes.NewReader(msg.Payload), s,
- ); err != nil {
- return err
- }
- return nil
- }
- // MarshalEvent marshals the type into an stream event value. This method
- // should only used internally within the SDK's EventStream handling.
- func (s *StatsEvent) MarshalEvent(pm protocol.PayloadMarshaler) (msg eventstream.Message, err error) {
- msg.Headers.Set(eventstreamapi.MessageTypeHeader, eventstream.StringValue(eventstreamapi.EventMessageType))
- var buf bytes.Buffer
- if err = pm.MarshalPayload(&buf, s); err != nil {
- return eventstream.Message{}, err
- }
- msg.Payload = buf.Bytes()
- return msg, err
- }
- // Specifies data related to access patterns to be collected and made available
- // to analyze the tradeoffs between different storage classes for an Amazon
- // S3 bucket.
- type StorageClassAnalysis struct {
- _ struct{} `type:"structure"`
- // Specifies how data related to the storage class analysis for an Amazon S3
- // bucket should be exported.
- DataExport *StorageClassAnalysisDataExport `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s StorageClassAnalysis) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s StorageClassAnalysis) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *StorageClassAnalysis) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "StorageClassAnalysis"}
- if s.DataExport != nil {
- if err := s.DataExport.Validate(); err != nil {
- invalidParams.AddNested("DataExport", err.(request.ErrInvalidParams))
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetDataExport sets the DataExport field's value.
- func (s *StorageClassAnalysis) SetDataExport(v *StorageClassAnalysisDataExport) *StorageClassAnalysis {
- s.DataExport = v
- return s
- }
- // Container for data related to the storage class analysis for an Amazon S3
- // bucket for export.
- type StorageClassAnalysisDataExport struct {
- _ struct{} `type:"structure"`
- // The place to store the data for an analysis.
- //
- // Destination is a required field
- Destination *AnalyticsExportDestination `type:"structure" required:"true"`
- // The version of the output schema to use when exporting data. Must be V_1.
- //
- // OutputSchemaVersion is a required field
- OutputSchemaVersion *string `type:"string" required:"true" enum:"StorageClassAnalysisSchemaVersion"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s StorageClassAnalysisDataExport) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s StorageClassAnalysisDataExport) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *StorageClassAnalysisDataExport) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "StorageClassAnalysisDataExport"}
- if s.Destination == nil {
- invalidParams.Add(request.NewErrParamRequired("Destination"))
- }
- if s.OutputSchemaVersion == nil {
- invalidParams.Add(request.NewErrParamRequired("OutputSchemaVersion"))
- }
- if s.Destination != nil {
- if err := s.Destination.Validate(); err != nil {
- invalidParams.AddNested("Destination", err.(request.ErrInvalidParams))
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetDestination sets the Destination field's value.
- func (s *StorageClassAnalysisDataExport) SetDestination(v *AnalyticsExportDestination) *StorageClassAnalysisDataExport {
- s.Destination = v
- return s
- }
- // SetOutputSchemaVersion sets the OutputSchemaVersion field's value.
- func (s *StorageClassAnalysisDataExport) SetOutputSchemaVersion(v string) *StorageClassAnalysisDataExport {
- s.OutputSchemaVersion = &v
- return s
- }
- // A container of a key value name pair.
- type Tag struct {
- _ struct{} `type:"structure"`
- // Name of the object key.
- //
- // Key is a required field
- Key *string `min:"1" type:"string" required:"true"`
- // Value of the tag.
- //
- // Value is a required field
- Value *string `type:"string" required:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s Tag) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s Tag) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *Tag) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "Tag"}
- if s.Key == nil {
- invalidParams.Add(request.NewErrParamRequired("Key"))
- }
- if s.Key != nil && len(*s.Key) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Key", 1))
- }
- if s.Value == nil {
- invalidParams.Add(request.NewErrParamRequired("Value"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetKey sets the Key field's value.
- func (s *Tag) SetKey(v string) *Tag {
- s.Key = &v
- return s
- }
- // SetValue sets the Value field's value.
- func (s *Tag) SetValue(v string) *Tag {
- s.Value = &v
- return s
- }
- // Container for TagSet elements.
- type Tagging struct {
- _ struct{} `type:"structure"`
- // A collection for a set of tags
- //
- // TagSet is a required field
- TagSet []*Tag `locationNameList:"Tag" type:"list" required:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s Tagging) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s Tagging) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *Tagging) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "Tagging"}
- if s.TagSet == nil {
- invalidParams.Add(request.NewErrParamRequired("TagSet"))
- }
- if s.TagSet != nil {
- for i, v := range s.TagSet {
- if v == nil {
- continue
- }
- if err := v.Validate(); err != nil {
- invalidParams.AddNested(fmt.Sprintf("%s[%v]", "TagSet", i), err.(request.ErrInvalidParams))
- }
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetTagSet sets the TagSet field's value.
- func (s *Tagging) SetTagSet(v []*Tag) *Tagging {
- s.TagSet = v
- return s
- }
- // Container for granting information.
- //
- // Buckets that use the bucket owner enforced setting for Object Ownership don't
- // support target grants. For more information, see Permissions server access
- // log delivery (https://docs.aws.amazon.com/AmazonS3/latest/userguide/enable-server-access-logging.html#grant-log-delivery-permissions-general)
- // in the Amazon S3 User Guide.
- type TargetGrant struct {
- _ struct{} `type:"structure"`
- // Container for the person being granted permissions.
- Grantee *Grantee `type:"structure" xmlPrefix:"xsi" xmlURI:"http://www.w3.org/2001/XMLSchema-instance"`
- // Logging permissions assigned to the grantee for the bucket.
- Permission *string `type:"string" enum:"BucketLogsPermission"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s TargetGrant) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s TargetGrant) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *TargetGrant) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "TargetGrant"}
- if s.Grantee != nil {
- if err := s.Grantee.Validate(); err != nil {
- invalidParams.AddNested("Grantee", err.(request.ErrInvalidParams))
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetGrantee sets the Grantee field's value.
- func (s *TargetGrant) SetGrantee(v *Grantee) *TargetGrant {
- s.Grantee = v
- return s
- }
- // SetPermission sets the Permission field's value.
- func (s *TargetGrant) SetPermission(v string) *TargetGrant {
- s.Permission = &v
- return s
- }
- // The S3 Intelligent-Tiering storage class is designed to optimize storage
- // costs by automatically moving data to the most cost-effective storage access
- // tier, without additional operational overhead.
- type Tiering struct {
- _ struct{} `type:"structure"`
- // S3 Intelligent-Tiering access tier. See Storage class for automatically optimizing
- // frequently and infrequently accessed objects (https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html#sc-dynamic-data-access)
- // for a list of access tiers in the S3 Intelligent-Tiering storage class.
- //
- // AccessTier is a required field
- AccessTier *string `type:"string" required:"true" enum:"IntelligentTieringAccessTier"`
- // The number of consecutive days of no access after which an object will be
- // eligible to be transitioned to the corresponding tier. The minimum number
- // of days specified for Archive Access tier must be at least 90 days and Deep
- // Archive Access tier must be at least 180 days. The maximum can be up to 2
- // years (730 days).
- //
- // Days is a required field
- Days *int64 `type:"integer" required:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s Tiering) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s Tiering) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *Tiering) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "Tiering"}
- if s.AccessTier == nil {
- invalidParams.Add(request.NewErrParamRequired("AccessTier"))
- }
- if s.Days == nil {
- invalidParams.Add(request.NewErrParamRequired("Days"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetAccessTier sets the AccessTier field's value.
- func (s *Tiering) SetAccessTier(v string) *Tiering {
- s.AccessTier = &v
- return s
- }
- // SetDays sets the Days field's value.
- func (s *Tiering) SetDays(v int64) *Tiering {
- s.Days = &v
- return s
- }
- // A container for specifying the configuration for publication of messages
- // to an Amazon Simple Notification Service (Amazon SNS) topic when Amazon S3
- // detects specified events.
- type TopicConfiguration struct {
- _ struct{} `type:"structure"`
- // The Amazon S3 bucket event about which to send notifications. For more information,
- // see Supported Event Types (https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html)
- // in the Amazon S3 User Guide.
- //
- // Events is a required field
- Events []*string `locationName:"Event" type:"list" flattened:"true" required:"true" enum:"Event"`
- // Specifies object key name filtering rules. For information about key name
- // filtering, see Configuring Event Notifications (https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html)
- // in the Amazon S3 User Guide.
- Filter *NotificationConfigurationFilter `type:"structure"`
- // An optional unique identifier for configurations in a notification configuration.
- // If you don't provide one, Amazon S3 will assign an ID.
- Id *string `type:"string"`
- // The Amazon Resource Name (ARN) of the Amazon SNS topic to which Amazon S3
- // publishes a message when it detects events of the specified type.
- //
- // TopicArn is a required field
- TopicArn *string `locationName:"Topic" type:"string" required:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s TopicConfiguration) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s TopicConfiguration) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *TopicConfiguration) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "TopicConfiguration"}
- if s.Events == nil {
- invalidParams.Add(request.NewErrParamRequired("Events"))
- }
- if s.TopicArn == nil {
- invalidParams.Add(request.NewErrParamRequired("TopicArn"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetEvents sets the Events field's value.
- func (s *TopicConfiguration) SetEvents(v []*string) *TopicConfiguration {
- s.Events = v
- return s
- }
- // SetFilter sets the Filter field's value.
- func (s *TopicConfiguration) SetFilter(v *NotificationConfigurationFilter) *TopicConfiguration {
- s.Filter = v
- return s
- }
- // SetId sets the Id field's value.
- func (s *TopicConfiguration) SetId(v string) *TopicConfiguration {
- s.Id = &v
- return s
- }
- // SetTopicArn sets the TopicArn field's value.
- func (s *TopicConfiguration) SetTopicArn(v string) *TopicConfiguration {
- s.TopicArn = &v
- return s
- }
- // A container for specifying the configuration for publication of messages
- // to an Amazon Simple Notification Service (Amazon SNS) topic when Amazon S3
- // detects specified events. This data type is deprecated. Use TopicConfiguration
- // (https://docs.aws.amazon.com/AmazonS3/latest/API/API_TopicConfiguration.html)
- // instead.
- type TopicConfigurationDeprecated struct {
- _ struct{} `type:"structure"`
- // Bucket event for which to send notifications.
- //
- // Deprecated: Event has been deprecated
- Event *string `deprecated:"true" type:"string" enum:"Event"`
- // A collection of events related to objects
- Events []*string `locationName:"Event" type:"list" flattened:"true" enum:"Event"`
- // An optional unique identifier for configurations in a notification configuration.
- // If you don't provide one, Amazon S3 will assign an ID.
- Id *string `type:"string"`
- // Amazon SNS topic to which Amazon S3 will publish a message to report the
- // specified events for the bucket.
- Topic *string `type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s TopicConfigurationDeprecated) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s TopicConfigurationDeprecated) GoString() string {
- return s.String()
- }
- // SetEvent sets the Event field's value.
- func (s *TopicConfigurationDeprecated) SetEvent(v string) *TopicConfigurationDeprecated {
- s.Event = &v
- return s
- }
- // SetEvents sets the Events field's value.
- func (s *TopicConfigurationDeprecated) SetEvents(v []*string) *TopicConfigurationDeprecated {
- s.Events = v
- return s
- }
- // SetId sets the Id field's value.
- func (s *TopicConfigurationDeprecated) SetId(v string) *TopicConfigurationDeprecated {
- s.Id = &v
- return s
- }
- // SetTopic sets the Topic field's value.
- func (s *TopicConfigurationDeprecated) SetTopic(v string) *TopicConfigurationDeprecated {
- s.Topic = &v
- return s
- }
- // Specifies when an object transitions to a specified storage class. For more
- // information about Amazon S3 lifecycle configuration rules, see Transitioning
- // Objects Using Amazon S3 Lifecycle (https://docs.aws.amazon.com/AmazonS3/latest/dev/lifecycle-transition-general-considerations.html)
- // in the Amazon S3 User Guide.
- type Transition struct {
- _ struct{} `type:"structure"`
- // Indicates when objects are transitioned to the specified storage class. The
- // date value must be in ISO 8601 format. The time is always midnight UTC.
- Date *time.Time `type:"timestamp" timestampFormat:"iso8601"`
- // Indicates the number of days after creation when objects are transitioned
- // to the specified storage class. The value must be a positive integer.
- Days *int64 `type:"integer"`
- // The storage class to which you want the object to transition.
- StorageClass *string `type:"string" enum:"TransitionStorageClass"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s Transition) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s Transition) GoString() string {
- return s.String()
- }
- // SetDate sets the Date field's value.
- func (s *Transition) SetDate(v time.Time) *Transition {
- s.Date = &v
- return s
- }
- // SetDays sets the Days field's value.
- func (s *Transition) SetDays(v int64) *Transition {
- s.Days = &v
- return s
- }
- // SetStorageClass sets the StorageClass field's value.
- func (s *Transition) SetStorageClass(v string) *Transition {
- s.StorageClass = &v
- return s
- }
- type UploadPartCopyInput struct {
- _ struct{} `locationName:"UploadPartCopyRequest" type:"structure"`
- // The bucket name.
- //
- // When using this action with an access point, you must direct requests to
- // the access point hostname. The access point hostname takes the form AccessPointName-AccountId.s3-accesspoint.Region.amazonaws.com.
- // When using this action with an access point through the Amazon Web Services
- // SDKs, you provide the access point ARN in place of the bucket name. For more
- // information about access point ARNs, see Using access points (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html)
- // in the Amazon S3 User Guide.
- //
- // When using this action with Amazon S3 on Outposts, you must direct requests
- // to the S3 on Outposts hostname. The S3 on Outposts hostname takes the form
- // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When
- // using this action with S3 on Outposts through the Amazon Web Services SDKs,
- // you provide the Outposts bucket ARN in place of the bucket name. For more
- // information about S3 on Outposts ARNs, see Using Amazon S3 on Outposts (https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html)
- // in the Amazon S3 User Guide.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // Specifies the source object for the copy operation. You specify the value
- // in one of two formats, depending on whether you want to access the source
- // object through an access point (https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-points.html):
- //
- // * For objects not accessed through an access point, specify the name of
- // the source bucket and key of the source object, separated by a slash (/).
- // For example, to copy the object reports/january.pdf from the bucket awsexamplebucket,
- // use awsexamplebucket/reports/january.pdf. The value must be URL-encoded.
- //
- // * For objects accessed through access points, specify the Amazon Resource
- // Name (ARN) of the object as accessed through the access point, in the
- // format arn:aws:s3:<Region>:<account-id>:accesspoint/<access-point-name>/object/<key>.
- // For example, to copy the object reports/january.pdf through access point
- // my-access-point owned by account 123456789012 in Region us-west-2, use
- // the URL encoding of arn:aws:s3:us-west-2:123456789012:accesspoint/my-access-point/object/reports/january.pdf.
- // The value must be URL encoded. Amazon S3 supports copy operations using
- // access points only when the source and destination buckets are in the
- // same Amazon Web Services Region. Alternatively, for objects accessed through
- // Amazon S3 on Outposts, specify the ARN of the object as accessed in the
- // format arn:aws:s3-outposts:<Region>:<account-id>:outpost/<outpost-id>/object/<key>.
- // For example, to copy the object reports/january.pdf through outpost my-outpost
- // owned by account 123456789012 in Region us-west-2, use the URL encoding
- // of arn:aws:s3-outposts:us-west-2:123456789012:outpost/my-outpost/object/reports/january.pdf.
- // The value must be URL-encoded.
- //
- // To copy a specific version of an object, append ?versionId=<version-id> to
- // the value (for example, awsexamplebucket/reports/january.pdf?versionId=QUpfdndhfd8438MNFDN93jdnJFkdmqnh893).
- // If you don't specify a version ID, Amazon S3 copies the latest version of
- // the source object.
- //
- // CopySource is a required field
- CopySource *string `location:"header" locationName:"x-amz-copy-source" type:"string" required:"true"`
- // Copies the object if its entity tag (ETag) matches the specified tag.
- CopySourceIfMatch *string `location:"header" locationName:"x-amz-copy-source-if-match" type:"string"`
- // Copies the object if it has been modified since the specified time.
- CopySourceIfModifiedSince *time.Time `location:"header" locationName:"x-amz-copy-source-if-modified-since" type:"timestamp"`
- // Copies the object if its entity tag (ETag) is different than the specified
- // ETag.
- CopySourceIfNoneMatch *string `location:"header" locationName:"x-amz-copy-source-if-none-match" type:"string"`
- // Copies the object if it hasn't been modified since the specified time.
- CopySourceIfUnmodifiedSince *time.Time `location:"header" locationName:"x-amz-copy-source-if-unmodified-since" type:"timestamp"`
- // The range of bytes to copy from the source object. The range value must use
- // the form bytes=first-last, where the first and last are the zero-based byte
- // offsets to copy. For example, bytes=0-9 indicates that you want to copy the
- // first 10 bytes of the source. You can copy a range only if the source object
- // is greater than 5 MB.
- CopySourceRange *string `location:"header" locationName:"x-amz-copy-source-range" type:"string"`
- // Specifies the algorithm to use when decrypting the source object (for example,
- // AES256).
- CopySourceSSECustomerAlgorithm *string `location:"header" locationName:"x-amz-copy-source-server-side-encryption-customer-algorithm" type:"string"`
- // Specifies the customer-provided encryption key for Amazon S3 to use to decrypt
- // the source object. The encryption key provided in this header must be one
- // that was used when the source object was created.
- //
- // CopySourceSSECustomerKey is a sensitive parameter and its value will be
- // replaced with "sensitive" in string returned by UploadPartCopyInput's
- // String and GoString methods.
- CopySourceSSECustomerKey *string `marshal-as:"blob" location:"header" locationName:"x-amz-copy-source-server-side-encryption-customer-key" type:"string" sensitive:"true"`
- // Specifies the 128-bit MD5 digest of the encryption key according to RFC 1321.
- // Amazon S3 uses this header for a message integrity check to ensure that the
- // encryption key was transmitted without error.
- CopySourceSSECustomerKeyMD5 *string `location:"header" locationName:"x-amz-copy-source-server-side-encryption-customer-key-MD5" type:"string"`
- // The account ID of the expected destination bucket owner. If the destination
- // bucket is owned by a different account, the request fails with the HTTP status
- // code 403 Forbidden (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // The account ID of the expected source bucket owner. If the source bucket
- // is owned by a different account, the request fails with the HTTP status code
- // 403 Forbidden (access denied).
- ExpectedSourceBucketOwner *string `location:"header" locationName:"x-amz-source-expected-bucket-owner" type:"string"`
- // Object key for which the multipart upload was initiated.
- //
- // Key is a required field
- Key *string `location:"uri" locationName:"Key" min:"1" type:"string" required:"true"`
- // Part number of part being copied. This is a positive integer between 1 and
- // 10,000.
- //
- // PartNumber is a required field
- PartNumber *int64 `location:"querystring" locationName:"partNumber" type:"integer" required:"true"`
- // Confirms that the requester knows that they will be charged for the request.
- // Bucket owners need not specify this parameter in their requests. For information
- // about downloading objects from Requester Pays buckets, see Downloading Objects
- // in Requester Pays Buckets (https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html)
- // in the Amazon S3 User Guide.
- RequestPayer *string `location:"header" locationName:"x-amz-request-payer" type:"string" enum:"RequestPayer"`
- // Specifies the algorithm to use to when encrypting the object (for example,
- // AES256).
- SSECustomerAlgorithm *string `location:"header" locationName:"x-amz-server-side-encryption-customer-algorithm" type:"string"`
- // Specifies the customer-provided encryption key for Amazon S3 to use in encrypting
- // data. This value is used to store the object and then it is discarded; Amazon
- // S3 does not store the encryption key. The key must be appropriate for use
- // with the algorithm specified in the x-amz-server-side-encryption-customer-algorithm
- // header. This must be the same encryption key specified in the initiate multipart
- // upload request.
- //
- // SSECustomerKey is a sensitive parameter and its value will be
- // replaced with "sensitive" in string returned by UploadPartCopyInput's
- // String and GoString methods.
- SSECustomerKey *string `marshal-as:"blob" location:"header" locationName:"x-amz-server-side-encryption-customer-key" type:"string" sensitive:"true"`
- // Specifies the 128-bit MD5 digest of the encryption key according to RFC 1321.
- // Amazon S3 uses this header for a message integrity check to ensure that the
- // encryption key was transmitted without error.
- SSECustomerKeyMD5 *string `location:"header" locationName:"x-amz-server-side-encryption-customer-key-MD5" type:"string"`
- // Upload ID identifying the multipart upload whose part is being copied.
- //
- // UploadId is a required field
- UploadId *string `location:"querystring" locationName:"uploadId" type:"string" required:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s UploadPartCopyInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s UploadPartCopyInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *UploadPartCopyInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "UploadPartCopyInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.CopySource == nil {
- invalidParams.Add(request.NewErrParamRequired("CopySource"))
- }
- if s.Key == nil {
- invalidParams.Add(request.NewErrParamRequired("Key"))
- }
- if s.Key != nil && len(*s.Key) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Key", 1))
- }
- if s.PartNumber == nil {
- invalidParams.Add(request.NewErrParamRequired("PartNumber"))
- }
- if s.UploadId == nil {
- invalidParams.Add(request.NewErrParamRequired("UploadId"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBucket sets the Bucket field's value.
- func (s *UploadPartCopyInput) SetBucket(v string) *UploadPartCopyInput {
- s.Bucket = &v
- return s
- }
- func (s *UploadPartCopyInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetCopySource sets the CopySource field's value.
- func (s *UploadPartCopyInput) SetCopySource(v string) *UploadPartCopyInput {
- s.CopySource = &v
- return s
- }
- // SetCopySourceIfMatch sets the CopySourceIfMatch field's value.
- func (s *UploadPartCopyInput) SetCopySourceIfMatch(v string) *UploadPartCopyInput {
- s.CopySourceIfMatch = &v
- return s
- }
- // SetCopySourceIfModifiedSince sets the CopySourceIfModifiedSince field's value.
- func (s *UploadPartCopyInput) SetCopySourceIfModifiedSince(v time.Time) *UploadPartCopyInput {
- s.CopySourceIfModifiedSince = &v
- return s
- }
- // SetCopySourceIfNoneMatch sets the CopySourceIfNoneMatch field's value.
- func (s *UploadPartCopyInput) SetCopySourceIfNoneMatch(v string) *UploadPartCopyInput {
- s.CopySourceIfNoneMatch = &v
- return s
- }
- // SetCopySourceIfUnmodifiedSince sets the CopySourceIfUnmodifiedSince field's value.
- func (s *UploadPartCopyInput) SetCopySourceIfUnmodifiedSince(v time.Time) *UploadPartCopyInput {
- s.CopySourceIfUnmodifiedSince = &v
- return s
- }
- // SetCopySourceRange sets the CopySourceRange field's value.
- func (s *UploadPartCopyInput) SetCopySourceRange(v string) *UploadPartCopyInput {
- s.CopySourceRange = &v
- return s
- }
- // SetCopySourceSSECustomerAlgorithm sets the CopySourceSSECustomerAlgorithm field's value.
- func (s *UploadPartCopyInput) SetCopySourceSSECustomerAlgorithm(v string) *UploadPartCopyInput {
- s.CopySourceSSECustomerAlgorithm = &v
- return s
- }
- // SetCopySourceSSECustomerKey sets the CopySourceSSECustomerKey field's value.
- func (s *UploadPartCopyInput) SetCopySourceSSECustomerKey(v string) *UploadPartCopyInput {
- s.CopySourceSSECustomerKey = &v
- return s
- }
- func (s *UploadPartCopyInput) getCopySourceSSECustomerKey() (v string) {
- if s.CopySourceSSECustomerKey == nil {
- return v
- }
- return *s.CopySourceSSECustomerKey
- }
- // SetCopySourceSSECustomerKeyMD5 sets the CopySourceSSECustomerKeyMD5 field's value.
- func (s *UploadPartCopyInput) SetCopySourceSSECustomerKeyMD5(v string) *UploadPartCopyInput {
- s.CopySourceSSECustomerKeyMD5 = &v
- return s
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *UploadPartCopyInput) SetExpectedBucketOwner(v string) *UploadPartCopyInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetExpectedSourceBucketOwner sets the ExpectedSourceBucketOwner field's value.
- func (s *UploadPartCopyInput) SetExpectedSourceBucketOwner(v string) *UploadPartCopyInput {
- s.ExpectedSourceBucketOwner = &v
- return s
- }
- // SetKey sets the Key field's value.
- func (s *UploadPartCopyInput) SetKey(v string) *UploadPartCopyInput {
- s.Key = &v
- return s
- }
- // SetPartNumber sets the PartNumber field's value.
- func (s *UploadPartCopyInput) SetPartNumber(v int64) *UploadPartCopyInput {
- s.PartNumber = &v
- return s
- }
- // SetRequestPayer sets the RequestPayer field's value.
- func (s *UploadPartCopyInput) SetRequestPayer(v string) *UploadPartCopyInput {
- s.RequestPayer = &v
- return s
- }
- // SetSSECustomerAlgorithm sets the SSECustomerAlgorithm field's value.
- func (s *UploadPartCopyInput) SetSSECustomerAlgorithm(v string) *UploadPartCopyInput {
- s.SSECustomerAlgorithm = &v
- return s
- }
- // SetSSECustomerKey sets the SSECustomerKey field's value.
- func (s *UploadPartCopyInput) SetSSECustomerKey(v string) *UploadPartCopyInput {
- s.SSECustomerKey = &v
- return s
- }
- func (s *UploadPartCopyInput) getSSECustomerKey() (v string) {
- if s.SSECustomerKey == nil {
- return v
- }
- return *s.SSECustomerKey
- }
- // SetSSECustomerKeyMD5 sets the SSECustomerKeyMD5 field's value.
- func (s *UploadPartCopyInput) SetSSECustomerKeyMD5(v string) *UploadPartCopyInput {
- s.SSECustomerKeyMD5 = &v
- return s
- }
- // SetUploadId sets the UploadId field's value.
- func (s *UploadPartCopyInput) SetUploadId(v string) *UploadPartCopyInput {
- s.UploadId = &v
- return s
- }
- func (s *UploadPartCopyInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *UploadPartCopyInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s UploadPartCopyInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type UploadPartCopyOutput struct {
- _ struct{} `type:"structure" payload:"CopyPartResult"`
- // Indicates whether the multipart upload uses an S3 Bucket Key for server-side
- // encryption with Amazon Web Services KMS (SSE-KMS).
- BucketKeyEnabled *bool `location:"header" locationName:"x-amz-server-side-encryption-bucket-key-enabled" type:"boolean"`
- // Container for all response elements.
- CopyPartResult *CopyPartResult `type:"structure"`
- // The version of the source object that was copied, if you have enabled versioning
- // on the source bucket.
- CopySourceVersionId *string `location:"header" locationName:"x-amz-copy-source-version-id" type:"string"`
- // If present, indicates that the requester was successfully charged for the
- // request.
- RequestCharged *string `location:"header" locationName:"x-amz-request-charged" type:"string" enum:"RequestCharged"`
- // If server-side encryption with a customer-provided encryption key was requested,
- // the response will include this header confirming the encryption algorithm
- // used.
- SSECustomerAlgorithm *string `location:"header" locationName:"x-amz-server-side-encryption-customer-algorithm" type:"string"`
- // If server-side encryption with a customer-provided encryption key was requested,
- // the response will include this header to provide round-trip message integrity
- // verification of the customer-provided encryption key.
- SSECustomerKeyMD5 *string `location:"header" locationName:"x-amz-server-side-encryption-customer-key-MD5" type:"string"`
- // If present, specifies the ID of the Amazon Web Services Key Management Service
- // (Amazon Web Services KMS) symmetric customer managed key that was used for
- // the object.
- //
- // SSEKMSKeyId is a sensitive parameter and its value will be
- // replaced with "sensitive" in string returned by UploadPartCopyOutput's
- // String and GoString methods.
- SSEKMSKeyId *string `location:"header" locationName:"x-amz-server-side-encryption-aws-kms-key-id" type:"string" sensitive:"true"`
- // The server-side encryption algorithm used when storing this object in Amazon
- // S3 (for example, AES256, aws:kms).
- ServerSideEncryption *string `location:"header" locationName:"x-amz-server-side-encryption" type:"string" enum:"ServerSideEncryption"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s UploadPartCopyOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s UploadPartCopyOutput) GoString() string {
- return s.String()
- }
- // SetBucketKeyEnabled sets the BucketKeyEnabled field's value.
- func (s *UploadPartCopyOutput) SetBucketKeyEnabled(v bool) *UploadPartCopyOutput {
- s.BucketKeyEnabled = &v
- return s
- }
- // SetCopyPartResult sets the CopyPartResult field's value.
- func (s *UploadPartCopyOutput) SetCopyPartResult(v *CopyPartResult) *UploadPartCopyOutput {
- s.CopyPartResult = v
- return s
- }
- // SetCopySourceVersionId sets the CopySourceVersionId field's value.
- func (s *UploadPartCopyOutput) SetCopySourceVersionId(v string) *UploadPartCopyOutput {
- s.CopySourceVersionId = &v
- return s
- }
- // SetRequestCharged sets the RequestCharged field's value.
- func (s *UploadPartCopyOutput) SetRequestCharged(v string) *UploadPartCopyOutput {
- s.RequestCharged = &v
- return s
- }
- // SetSSECustomerAlgorithm sets the SSECustomerAlgorithm field's value.
- func (s *UploadPartCopyOutput) SetSSECustomerAlgorithm(v string) *UploadPartCopyOutput {
- s.SSECustomerAlgorithm = &v
- return s
- }
- // SetSSECustomerKeyMD5 sets the SSECustomerKeyMD5 field's value.
- func (s *UploadPartCopyOutput) SetSSECustomerKeyMD5(v string) *UploadPartCopyOutput {
- s.SSECustomerKeyMD5 = &v
- return s
- }
- // SetSSEKMSKeyId sets the SSEKMSKeyId field's value.
- func (s *UploadPartCopyOutput) SetSSEKMSKeyId(v string) *UploadPartCopyOutput {
- s.SSEKMSKeyId = &v
- return s
- }
- // SetServerSideEncryption sets the ServerSideEncryption field's value.
- func (s *UploadPartCopyOutput) SetServerSideEncryption(v string) *UploadPartCopyOutput {
- s.ServerSideEncryption = &v
- return s
- }
- type UploadPartInput struct {
- _ struct{} `locationName:"UploadPartRequest" type:"structure" payload:"Body"`
- // Object data.
- Body io.ReadSeeker `type:"blob"`
- // The name of the bucket to which the multipart upload was initiated.
- //
- // When using this action with an access point, you must direct requests to
- // the access point hostname. The access point hostname takes the form AccessPointName-AccountId.s3-accesspoint.Region.amazonaws.com.
- // When using this action with an access point through the Amazon Web Services
- // SDKs, you provide the access point ARN in place of the bucket name. For more
- // information about access point ARNs, see Using access points (https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html)
- // in the Amazon S3 User Guide.
- //
- // When using this action with Amazon S3 on Outposts, you must direct requests
- // to the S3 on Outposts hostname. The S3 on Outposts hostname takes the form
- // AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com. When
- // using this action with S3 on Outposts through the Amazon Web Services SDKs,
- // you provide the Outposts bucket ARN in place of the bucket name. For more
- // information about S3 on Outposts ARNs, see Using Amazon S3 on Outposts (https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html)
- // in the Amazon S3 User Guide.
- //
- // Bucket is a required field
- Bucket *string `location:"uri" locationName:"Bucket" type:"string" required:"true"`
- // Indicates the algorithm used to create the checksum for the object when using
- // the SDK. This header will not provide any additional functionality if not
- // using the SDK. When sending this header, there must be a corresponding x-amz-checksum
- // or x-amz-trailer header sent. Otherwise, Amazon S3 fails the request with
- // the HTTP status code 400 Bad Request. For more information, see Checking
- // object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
- // in the Amazon S3 User Guide.
- //
- // If you provide an individual checksum, Amazon S3 ignores any provided ChecksumAlgorithm
- // parameter.
- //
- // This checksum algorithm must be the same for all parts and it match the checksum
- // value supplied in the CreateMultipartUpload request.
- //
- // The AWS SDK for Go v1 does not support automatic computing request payload
- // checksum. This feature is available in the AWS SDK for Go v2. If a value
- // is specified for this parameter, the matching algorithm's checksum member
- // must be populated with the algorithm's checksum of the request payload.
- ChecksumAlgorithm *string `location:"header" locationName:"x-amz-sdk-checksum-algorithm" type:"string" enum:"ChecksumAlgorithm"`
- // This header can be used as a data integrity check to verify that the data
- // received is the same data that was originally sent. This header specifies
- // the base64-encoded, 32-bit CRC32 checksum of the object. For more information,
- // see Checking object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
- // in the Amazon S3 User Guide.
- ChecksumCRC32 *string `location:"header" locationName:"x-amz-checksum-crc32" type:"string"`
- // This header can be used as a data integrity check to verify that the data
- // received is the same data that was originally sent. This header specifies
- // the base64-encoded, 32-bit CRC32C checksum of the object. For more information,
- // see Checking object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
- // in the Amazon S3 User Guide.
- ChecksumCRC32C *string `location:"header" locationName:"x-amz-checksum-crc32c" type:"string"`
- // This header can be used as a data integrity check to verify that the data
- // received is the same data that was originally sent. This header specifies
- // the base64-encoded, 160-bit SHA-1 digest of the object. For more information,
- // see Checking object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
- // in the Amazon S3 User Guide.
- ChecksumSHA1 *string `location:"header" locationName:"x-amz-checksum-sha1" type:"string"`
- // This header can be used as a data integrity check to verify that the data
- // received is the same data that was originally sent. This header specifies
- // the base64-encoded, 256-bit SHA-256 digest of the object. For more information,
- // see Checking object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
- // in the Amazon S3 User Guide.
- ChecksumSHA256 *string `location:"header" locationName:"x-amz-checksum-sha256" type:"string"`
- // Size of the body in bytes. This parameter is useful when the size of the
- // body cannot be determined automatically.
- ContentLength *int64 `location:"header" locationName:"Content-Length" type:"long"`
- // The base64-encoded 128-bit MD5 digest of the part data. This parameter is
- // auto-populated when using the command from the CLI. This parameter is required
- // if object lock parameters are specified.
- ContentMD5 *string `location:"header" locationName:"Content-MD5" type:"string"`
- // The account ID of the expected bucket owner. If the bucket is owned by a
- // different account, the request fails with the HTTP status code 403 Forbidden
- // (access denied).
- ExpectedBucketOwner *string `location:"header" locationName:"x-amz-expected-bucket-owner" type:"string"`
- // Object key for which the multipart upload was initiated.
- //
- // Key is a required field
- Key *string `location:"uri" locationName:"Key" min:"1" type:"string" required:"true"`
- // Part number of part being uploaded. This is a positive integer between 1
- // and 10,000.
- //
- // PartNumber is a required field
- PartNumber *int64 `location:"querystring" locationName:"partNumber" type:"integer" required:"true"`
- // Confirms that the requester knows that they will be charged for the request.
- // Bucket owners need not specify this parameter in their requests. For information
- // about downloading objects from Requester Pays buckets, see Downloading Objects
- // in Requester Pays Buckets (https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html)
- // in the Amazon S3 User Guide.
- RequestPayer *string `location:"header" locationName:"x-amz-request-payer" type:"string" enum:"RequestPayer"`
- // Specifies the algorithm to use to when encrypting the object (for example,
- // AES256).
- SSECustomerAlgorithm *string `location:"header" locationName:"x-amz-server-side-encryption-customer-algorithm" type:"string"`
- // Specifies the customer-provided encryption key for Amazon S3 to use in encrypting
- // data. This value is used to store the object and then it is discarded; Amazon
- // S3 does not store the encryption key. The key must be appropriate for use
- // with the algorithm specified in the x-amz-server-side-encryption-customer-algorithm
- // header. This must be the same encryption key specified in the initiate multipart
- // upload request.
- //
- // SSECustomerKey is a sensitive parameter and its value will be
- // replaced with "sensitive" in string returned by UploadPartInput's
- // String and GoString methods.
- SSECustomerKey *string `marshal-as:"blob" location:"header" locationName:"x-amz-server-side-encryption-customer-key" type:"string" sensitive:"true"`
- // Specifies the 128-bit MD5 digest of the encryption key according to RFC 1321.
- // Amazon S3 uses this header for a message integrity check to ensure that the
- // encryption key was transmitted without error.
- SSECustomerKeyMD5 *string `location:"header" locationName:"x-amz-server-side-encryption-customer-key-MD5" type:"string"`
- // Upload ID identifying the multipart upload whose part is being uploaded.
- //
- // UploadId is a required field
- UploadId *string `location:"querystring" locationName:"uploadId" type:"string" required:"true"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s UploadPartInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s UploadPartInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *UploadPartInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "UploadPartInput"}
- if s.Bucket == nil {
- invalidParams.Add(request.NewErrParamRequired("Bucket"))
- }
- if s.Bucket != nil && len(*s.Bucket) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Bucket", 1))
- }
- if s.Key == nil {
- invalidParams.Add(request.NewErrParamRequired("Key"))
- }
- if s.Key != nil && len(*s.Key) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Key", 1))
- }
- if s.PartNumber == nil {
- invalidParams.Add(request.NewErrParamRequired("PartNumber"))
- }
- if s.UploadId == nil {
- invalidParams.Add(request.NewErrParamRequired("UploadId"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetBody sets the Body field's value.
- func (s *UploadPartInput) SetBody(v io.ReadSeeker) *UploadPartInput {
- s.Body = v
- return s
- }
- // SetBucket sets the Bucket field's value.
- func (s *UploadPartInput) SetBucket(v string) *UploadPartInput {
- s.Bucket = &v
- return s
- }
- func (s *UploadPartInput) getBucket() (v string) {
- if s.Bucket == nil {
- return v
- }
- return *s.Bucket
- }
- // SetChecksumAlgorithm sets the ChecksumAlgorithm field's value.
- func (s *UploadPartInput) SetChecksumAlgorithm(v string) *UploadPartInput {
- s.ChecksumAlgorithm = &v
- return s
- }
- // SetChecksumCRC32 sets the ChecksumCRC32 field's value.
- func (s *UploadPartInput) SetChecksumCRC32(v string) *UploadPartInput {
- s.ChecksumCRC32 = &v
- return s
- }
- // SetChecksumCRC32C sets the ChecksumCRC32C field's value.
- func (s *UploadPartInput) SetChecksumCRC32C(v string) *UploadPartInput {
- s.ChecksumCRC32C = &v
- return s
- }
- // SetChecksumSHA1 sets the ChecksumSHA1 field's value.
- func (s *UploadPartInput) SetChecksumSHA1(v string) *UploadPartInput {
- s.ChecksumSHA1 = &v
- return s
- }
- // SetChecksumSHA256 sets the ChecksumSHA256 field's value.
- func (s *UploadPartInput) SetChecksumSHA256(v string) *UploadPartInput {
- s.ChecksumSHA256 = &v
- return s
- }
- // SetContentLength sets the ContentLength field's value.
- func (s *UploadPartInput) SetContentLength(v int64) *UploadPartInput {
- s.ContentLength = &v
- return s
- }
- // SetContentMD5 sets the ContentMD5 field's value.
- func (s *UploadPartInput) SetContentMD5(v string) *UploadPartInput {
- s.ContentMD5 = &v
- return s
- }
- // SetExpectedBucketOwner sets the ExpectedBucketOwner field's value.
- func (s *UploadPartInput) SetExpectedBucketOwner(v string) *UploadPartInput {
- s.ExpectedBucketOwner = &v
- return s
- }
- // SetKey sets the Key field's value.
- func (s *UploadPartInput) SetKey(v string) *UploadPartInput {
- s.Key = &v
- return s
- }
- // SetPartNumber sets the PartNumber field's value.
- func (s *UploadPartInput) SetPartNumber(v int64) *UploadPartInput {
- s.PartNumber = &v
- return s
- }
- // SetRequestPayer sets the RequestPayer field's value.
- func (s *UploadPartInput) SetRequestPayer(v string) *UploadPartInput {
- s.RequestPayer = &v
- return s
- }
- // SetSSECustomerAlgorithm sets the SSECustomerAlgorithm field's value.
- func (s *UploadPartInput) SetSSECustomerAlgorithm(v string) *UploadPartInput {
- s.SSECustomerAlgorithm = &v
- return s
- }
- // SetSSECustomerKey sets the SSECustomerKey field's value.
- func (s *UploadPartInput) SetSSECustomerKey(v string) *UploadPartInput {
- s.SSECustomerKey = &v
- return s
- }
- func (s *UploadPartInput) getSSECustomerKey() (v string) {
- if s.SSECustomerKey == nil {
- return v
- }
- return *s.SSECustomerKey
- }
- // SetSSECustomerKeyMD5 sets the SSECustomerKeyMD5 field's value.
- func (s *UploadPartInput) SetSSECustomerKeyMD5(v string) *UploadPartInput {
- s.SSECustomerKeyMD5 = &v
- return s
- }
- // SetUploadId sets the UploadId field's value.
- func (s *UploadPartInput) SetUploadId(v string) *UploadPartInput {
- s.UploadId = &v
- return s
- }
- func (s *UploadPartInput) getEndpointARN() (arn.Resource, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- return parseEndpointARN(*s.Bucket)
- }
- func (s *UploadPartInput) hasEndpointARN() bool {
- if s.Bucket == nil {
- return false
- }
- return arn.IsARN(*s.Bucket)
- }
- // updateArnableField updates the value of the input field that
- // takes an ARN as an input. This method is useful to backfill
- // the parsed resource name from ARN into the input member.
- // It returns a pointer to a modified copy of input and an error.
- // Note that original input is not modified.
- func (s UploadPartInput) updateArnableField(v string) (interface{}, error) {
- if s.Bucket == nil {
- return nil, fmt.Errorf("member Bucket is nil")
- }
- s.Bucket = aws.String(v)
- return &s, nil
- }
- type UploadPartOutput struct {
- _ struct{} `type:"structure"`
- // Indicates whether the multipart upload uses an S3 Bucket Key for server-side
- // encryption with Amazon Web Services KMS (SSE-KMS).
- BucketKeyEnabled *bool `location:"header" locationName:"x-amz-server-side-encryption-bucket-key-enabled" type:"boolean"`
- // The base64-encoded, 32-bit CRC32 checksum of the object. This will only be
- // present if it was uploaded with the object. With multipart uploads, this
- // may not be a checksum value of the object. For more information about how
- // checksums are calculated with multipart uploads, see Checking object integrity
- // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
- // in the Amazon S3 User Guide.
- ChecksumCRC32 *string `location:"header" locationName:"x-amz-checksum-crc32" type:"string"`
- // The base64-encoded, 32-bit CRC32C checksum of the object. This will only
- // be present if it was uploaded with the object. With multipart uploads, this
- // may not be a checksum value of the object. For more information about how
- // checksums are calculated with multipart uploads, see Checking object integrity
- // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
- // in the Amazon S3 User Guide.
- ChecksumCRC32C *string `location:"header" locationName:"x-amz-checksum-crc32c" type:"string"`
- // The base64-encoded, 160-bit SHA-1 digest of the object. This will only be
- // present if it was uploaded with the object. With multipart uploads, this
- // may not be a checksum value of the object. For more information about how
- // checksums are calculated with multipart uploads, see Checking object integrity
- // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
- // in the Amazon S3 User Guide.
- ChecksumSHA1 *string `location:"header" locationName:"x-amz-checksum-sha1" type:"string"`
- // The base64-encoded, 256-bit SHA-256 digest of the object. This will only
- // be present if it was uploaded with the object. With multipart uploads, this
- // may not be a checksum value of the object. For more information about how
- // checksums are calculated with multipart uploads, see Checking object integrity
- // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
- // in the Amazon S3 User Guide.
- ChecksumSHA256 *string `location:"header" locationName:"x-amz-checksum-sha256" type:"string"`
- // Entity tag for the uploaded object.
- ETag *string `location:"header" locationName:"ETag" type:"string"`
- // If present, indicates that the requester was successfully charged for the
- // request.
- RequestCharged *string `location:"header" locationName:"x-amz-request-charged" type:"string" enum:"RequestCharged"`
- // If server-side encryption with a customer-provided encryption key was requested,
- // the response will include this header confirming the encryption algorithm
- // used.
- SSECustomerAlgorithm *string `location:"header" locationName:"x-amz-server-side-encryption-customer-algorithm" type:"string"`
- // If server-side encryption with a customer-provided encryption key was requested,
- // the response will include this header to provide round-trip message integrity
- // verification of the customer-provided encryption key.
- SSECustomerKeyMD5 *string `location:"header" locationName:"x-amz-server-side-encryption-customer-key-MD5" type:"string"`
- // If present, specifies the ID of the Amazon Web Services Key Management Service
- // (Amazon Web Services KMS) symmetric customer managed key was used for the
- // object.
- //
- // SSEKMSKeyId is a sensitive parameter and its value will be
- // replaced with "sensitive" in string returned by UploadPartOutput's
- // String and GoString methods.
- SSEKMSKeyId *string `location:"header" locationName:"x-amz-server-side-encryption-aws-kms-key-id" type:"string" sensitive:"true"`
- // The server-side encryption algorithm used when storing this object in Amazon
- // S3 (for example, AES256, aws:kms).
- ServerSideEncryption *string `location:"header" locationName:"x-amz-server-side-encryption" type:"string" enum:"ServerSideEncryption"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s UploadPartOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s UploadPartOutput) GoString() string {
- return s.String()
- }
- // SetBucketKeyEnabled sets the BucketKeyEnabled field's value.
- func (s *UploadPartOutput) SetBucketKeyEnabled(v bool) *UploadPartOutput {
- s.BucketKeyEnabled = &v
- return s
- }
- // SetChecksumCRC32 sets the ChecksumCRC32 field's value.
- func (s *UploadPartOutput) SetChecksumCRC32(v string) *UploadPartOutput {
- s.ChecksumCRC32 = &v
- return s
- }
- // SetChecksumCRC32C sets the ChecksumCRC32C field's value.
- func (s *UploadPartOutput) SetChecksumCRC32C(v string) *UploadPartOutput {
- s.ChecksumCRC32C = &v
- return s
- }
- // SetChecksumSHA1 sets the ChecksumSHA1 field's value.
- func (s *UploadPartOutput) SetChecksumSHA1(v string) *UploadPartOutput {
- s.ChecksumSHA1 = &v
- return s
- }
- // SetChecksumSHA256 sets the ChecksumSHA256 field's value.
- func (s *UploadPartOutput) SetChecksumSHA256(v string) *UploadPartOutput {
- s.ChecksumSHA256 = &v
- return s
- }
- // SetETag sets the ETag field's value.
- func (s *UploadPartOutput) SetETag(v string) *UploadPartOutput {
- s.ETag = &v
- return s
- }
- // SetRequestCharged sets the RequestCharged field's value.
- func (s *UploadPartOutput) SetRequestCharged(v string) *UploadPartOutput {
- s.RequestCharged = &v
- return s
- }
- // SetSSECustomerAlgorithm sets the SSECustomerAlgorithm field's value.
- func (s *UploadPartOutput) SetSSECustomerAlgorithm(v string) *UploadPartOutput {
- s.SSECustomerAlgorithm = &v
- return s
- }
- // SetSSECustomerKeyMD5 sets the SSECustomerKeyMD5 field's value.
- func (s *UploadPartOutput) SetSSECustomerKeyMD5(v string) *UploadPartOutput {
- s.SSECustomerKeyMD5 = &v
- return s
- }
- // SetSSEKMSKeyId sets the SSEKMSKeyId field's value.
- func (s *UploadPartOutput) SetSSEKMSKeyId(v string) *UploadPartOutput {
- s.SSEKMSKeyId = &v
- return s
- }
- // SetServerSideEncryption sets the ServerSideEncryption field's value.
- func (s *UploadPartOutput) SetServerSideEncryption(v string) *UploadPartOutput {
- s.ServerSideEncryption = &v
- return s
- }
- // Describes the versioning state of an Amazon S3 bucket. For more information,
- // see PUT Bucket versioning (https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTVersioningStatus.html)
- // in the Amazon S3 API Reference.
- type VersioningConfiguration struct {
- _ struct{} `type:"structure"`
- // Specifies whether MFA delete is enabled in the bucket versioning configuration.
- // This element is only returned if the bucket has been configured with MFA
- // delete. If the bucket has never been so configured, this element is not returned.
- MFADelete *string `locationName:"MfaDelete" type:"string" enum:"MFADelete"`
- // The versioning state of the bucket.
- Status *string `type:"string" enum:"BucketVersioningStatus"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s VersioningConfiguration) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s VersioningConfiguration) GoString() string {
- return s.String()
- }
- // SetMFADelete sets the MFADelete field's value.
- func (s *VersioningConfiguration) SetMFADelete(v string) *VersioningConfiguration {
- s.MFADelete = &v
- return s
- }
- // SetStatus sets the Status field's value.
- func (s *VersioningConfiguration) SetStatus(v string) *VersioningConfiguration {
- s.Status = &v
- return s
- }
- // Specifies website configuration parameters for an Amazon S3 bucket.
- type WebsiteConfiguration struct {
- _ struct{} `type:"structure"`
- // The name of the error document for the website.
- ErrorDocument *ErrorDocument `type:"structure"`
- // The name of the index document for the website.
- IndexDocument *IndexDocument `type:"structure"`
- // The redirect behavior for every request to this bucket's website endpoint.
- //
- // If you specify this property, you can't specify any other property.
- RedirectAllRequestsTo *RedirectAllRequestsTo `type:"structure"`
- // Rules that define when a redirect is applied and the redirect behavior.
- RoutingRules []*RoutingRule `locationNameList:"RoutingRule" type:"list"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s WebsiteConfiguration) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s WebsiteConfiguration) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *WebsiteConfiguration) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "WebsiteConfiguration"}
- if s.ErrorDocument != nil {
- if err := s.ErrorDocument.Validate(); err != nil {
- invalidParams.AddNested("ErrorDocument", err.(request.ErrInvalidParams))
- }
- }
- if s.IndexDocument != nil {
- if err := s.IndexDocument.Validate(); err != nil {
- invalidParams.AddNested("IndexDocument", err.(request.ErrInvalidParams))
- }
- }
- if s.RedirectAllRequestsTo != nil {
- if err := s.RedirectAllRequestsTo.Validate(); err != nil {
- invalidParams.AddNested("RedirectAllRequestsTo", err.(request.ErrInvalidParams))
- }
- }
- if s.RoutingRules != nil {
- for i, v := range s.RoutingRules {
- if v == nil {
- continue
- }
- if err := v.Validate(); err != nil {
- invalidParams.AddNested(fmt.Sprintf("%s[%v]", "RoutingRules", i), err.(request.ErrInvalidParams))
- }
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetErrorDocument sets the ErrorDocument field's value.
- func (s *WebsiteConfiguration) SetErrorDocument(v *ErrorDocument) *WebsiteConfiguration {
- s.ErrorDocument = v
- return s
- }
- // SetIndexDocument sets the IndexDocument field's value.
- func (s *WebsiteConfiguration) SetIndexDocument(v *IndexDocument) *WebsiteConfiguration {
- s.IndexDocument = v
- return s
- }
- // SetRedirectAllRequestsTo sets the RedirectAllRequestsTo field's value.
- func (s *WebsiteConfiguration) SetRedirectAllRequestsTo(v *RedirectAllRequestsTo) *WebsiteConfiguration {
- s.RedirectAllRequestsTo = v
- return s
- }
- // SetRoutingRules sets the RoutingRules field's value.
- func (s *WebsiteConfiguration) SetRoutingRules(v []*RoutingRule) *WebsiteConfiguration {
- s.RoutingRules = v
- return s
- }
- type WriteGetObjectResponseInput struct {
- _ struct{} `locationName:"WriteGetObjectResponseRequest" type:"structure" payload:"Body"`
- // Indicates that a range of bytes was specified.
- AcceptRanges *string `location:"header" locationName:"x-amz-fwd-header-accept-ranges" type:"string"`
- // The object data.
- //
- // To use an non-seekable io.Reader for this request wrap the io.Reader with
- // "aws.ReadSeekCloser". The SDK will not retry request errors for non-seekable
- // readers. This will allow the SDK to send the reader's payload as chunked
- // transfer encoding.
- Body io.ReadSeeker `type:"blob"`
- // Indicates whether the object stored in Amazon S3 uses an S3 bucket key for
- // server-side encryption with Amazon Web Services KMS (SSE-KMS).
- BucketKeyEnabled *bool `location:"header" locationName:"x-amz-fwd-header-x-amz-server-side-encryption-bucket-key-enabled" type:"boolean"`
- // Specifies caching behavior along the request/reply chain.
- CacheControl *string `location:"header" locationName:"x-amz-fwd-header-Cache-Control" type:"string"`
- // This header can be used as a data integrity check to verify that the data
- // received is the same data that was originally sent. This specifies the base64-encoded,
- // 32-bit CRC32 checksum of the object returned by the Object Lambda function.
- // This may not match the checksum for the object stored in Amazon S3. Amazon
- // S3 will perform validation of the checksum values only when the original
- // GetObject request required checksum validation. For more information about
- // checksums, see Checking object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
- // in the Amazon S3 User Guide.
- //
- // Only one checksum header can be specified at a time. If you supply multiple
- // checksum headers, this request will fail.
- ChecksumCRC32 *string `location:"header" locationName:"x-amz-fwd-header-x-amz-checksum-crc32" type:"string"`
- // This header can be used as a data integrity check to verify that the data
- // received is the same data that was originally sent. This specifies the base64-encoded,
- // 32-bit CRC32C checksum of the object returned by the Object Lambda function.
- // This may not match the checksum for the object stored in Amazon S3. Amazon
- // S3 will perform validation of the checksum values only when the original
- // GetObject request required checksum validation. For more information about
- // checksums, see Checking object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
- // in the Amazon S3 User Guide.
- //
- // Only one checksum header can be specified at a time. If you supply multiple
- // checksum headers, this request will fail.
- ChecksumCRC32C *string `location:"header" locationName:"x-amz-fwd-header-x-amz-checksum-crc32c" type:"string"`
- // This header can be used as a data integrity check to verify that the data
- // received is the same data that was originally sent. This specifies the base64-encoded,
- // 160-bit SHA-1 digest of the object returned by the Object Lambda function.
- // This may not match the checksum for the object stored in Amazon S3. Amazon
- // S3 will perform validation of the checksum values only when the original
- // GetObject request required checksum validation. For more information about
- // checksums, see Checking object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
- // in the Amazon S3 User Guide.
- //
- // Only one checksum header can be specified at a time. If you supply multiple
- // checksum headers, this request will fail.
- ChecksumSHA1 *string `location:"header" locationName:"x-amz-fwd-header-x-amz-checksum-sha1" type:"string"`
- // This header can be used as a data integrity check to verify that the data
- // received is the same data that was originally sent. This specifies the base64-encoded,
- // 256-bit SHA-256 digest of the object returned by the Object Lambda function.
- // This may not match the checksum for the object stored in Amazon S3. Amazon
- // S3 will perform validation of the checksum values only when the original
- // GetObject request required checksum validation. For more information about
- // checksums, see Checking object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
- // in the Amazon S3 User Guide.
- //
- // Only one checksum header can be specified at a time. If you supply multiple
- // checksum headers, this request will fail.
- ChecksumSHA256 *string `location:"header" locationName:"x-amz-fwd-header-x-amz-checksum-sha256" type:"string"`
- // Specifies presentational information for the object.
- ContentDisposition *string `location:"header" locationName:"x-amz-fwd-header-Content-Disposition" type:"string"`
- // Specifies what content encodings have been applied to the object and thus
- // what decoding mechanisms must be applied to obtain the media-type referenced
- // by the Content-Type header field.
- ContentEncoding *string `location:"header" locationName:"x-amz-fwd-header-Content-Encoding" type:"string"`
- // The language the content is in.
- ContentLanguage *string `location:"header" locationName:"x-amz-fwd-header-Content-Language" type:"string"`
- // The size of the content body in bytes.
- ContentLength *int64 `location:"header" locationName:"Content-Length" type:"long"`
- // The portion of the object returned in the response.
- ContentRange *string `location:"header" locationName:"x-amz-fwd-header-Content-Range" type:"string"`
- // A standard MIME type describing the format of the object data.
- ContentType *string `location:"header" locationName:"x-amz-fwd-header-Content-Type" type:"string"`
- // Specifies whether an object stored in Amazon S3 is (true) or is not (false)
- // a delete marker.
- DeleteMarker *bool `location:"header" locationName:"x-amz-fwd-header-x-amz-delete-marker" type:"boolean"`
- // An opaque identifier assigned by a web server to a specific version of a
- // resource found at a URL.
- ETag *string `location:"header" locationName:"x-amz-fwd-header-ETag" type:"string"`
- // A string that uniquely identifies an error condition. Returned in the <Code>
- // tag of the error XML response for a corresponding GetObject call. Cannot
- // be used with a successful StatusCode header or when the transformed object
- // is provided in the body. All error codes from S3 are sentence-cased. The
- // regular expression (regex) value is "^[A-Z][a-zA-Z]+$".
- ErrorCode *string `location:"header" locationName:"x-amz-fwd-error-code" type:"string"`
- // Contains a generic description of the error condition. Returned in the <Message>
- // tag of the error XML response for a corresponding GetObject call. Cannot
- // be used with a successful StatusCode header or when the transformed object
- // is provided in body.
- ErrorMessage *string `location:"header" locationName:"x-amz-fwd-error-message" type:"string"`
- // If the object expiration is configured (see PUT Bucket lifecycle), the response
- // includes this header. It includes the expiry-date and rule-id key-value pairs
- // that provide the object expiration information. The value of the rule-id
- // is URL-encoded.
- Expiration *string `location:"header" locationName:"x-amz-fwd-header-x-amz-expiration" type:"string"`
- // The date and time at which the object is no longer cacheable.
- Expires *time.Time `location:"header" locationName:"x-amz-fwd-header-Expires" type:"timestamp"`
- // The date and time that the object was last modified.
- LastModified *time.Time `location:"header" locationName:"x-amz-fwd-header-Last-Modified" type:"timestamp"`
- // A map of metadata to store with the object in S3.
- Metadata map[string]*string `location:"headers" locationName:"x-amz-meta-" type:"map"`
- // Set to the number of metadata entries not returned in x-amz-meta headers.
- // This can happen if you create metadata using an API like SOAP that supports
- // more flexible metadata than the REST API. For example, using SOAP, you can
- // create metadata whose values are not legal HTTP headers.
- MissingMeta *int64 `location:"header" locationName:"x-amz-fwd-header-x-amz-missing-meta" type:"integer"`
- // Indicates whether an object stored in Amazon S3 has an active legal hold.
- ObjectLockLegalHoldStatus *string `location:"header" locationName:"x-amz-fwd-header-x-amz-object-lock-legal-hold" type:"string" enum:"ObjectLockLegalHoldStatus"`
- // Indicates whether an object stored in Amazon S3 has Object Lock enabled.
- // For more information about S3 Object Lock, see Object Lock (https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lock.html).
- ObjectLockMode *string `location:"header" locationName:"x-amz-fwd-header-x-amz-object-lock-mode" type:"string" enum:"ObjectLockMode"`
- // The date and time when Object Lock is configured to expire.
- ObjectLockRetainUntilDate *time.Time `location:"header" locationName:"x-amz-fwd-header-x-amz-object-lock-retain-until-date" type:"timestamp" timestampFormat:"iso8601"`
- // The count of parts this object has.
- PartsCount *int64 `location:"header" locationName:"x-amz-fwd-header-x-amz-mp-parts-count" type:"integer"`
- // Indicates if request involves bucket that is either a source or destination
- // in a Replication rule. For more information about S3 Replication, see Replication
- // (https://docs.aws.amazon.com/AmazonS3/latest/userguide/replication.html).
- ReplicationStatus *string `location:"header" locationName:"x-amz-fwd-header-x-amz-replication-status" type:"string" enum:"ReplicationStatus"`
- // If present, indicates that the requester was successfully charged for the
- // request.
- RequestCharged *string `location:"header" locationName:"x-amz-fwd-header-x-amz-request-charged" type:"string" enum:"RequestCharged"`
- // Route prefix to the HTTP URL generated.
- //
- // RequestRoute is a required field
- RequestRoute *string `location:"header" locationName:"x-amz-request-route" type:"string" required:"true"`
- // A single use encrypted token that maps WriteGetObjectResponse to the end
- // user GetObject request.
- //
- // RequestToken is a required field
- RequestToken *string `location:"header" locationName:"x-amz-request-token" type:"string" required:"true"`
- // Provides information about object restoration operation and expiration time
- // of the restored object copy.
- Restore *string `location:"header" locationName:"x-amz-fwd-header-x-amz-restore" type:"string"`
- // Encryption algorithm used if server-side encryption with a customer-provided
- // encryption key was specified for object stored in Amazon S3.
- SSECustomerAlgorithm *string `location:"header" locationName:"x-amz-fwd-header-x-amz-server-side-encryption-customer-algorithm" type:"string"`
- // 128-bit MD5 digest of customer-provided encryption key used in Amazon S3
- // to encrypt data stored in S3. For more information, see Protecting data using
- // server-side encryption with customer-provided encryption keys (SSE-C) (https://docs.aws.amazon.com/AmazonS3/latest/userguide/ServerSideEncryptionCustomerKeys.html).
- SSECustomerKeyMD5 *string `location:"header" locationName:"x-amz-fwd-header-x-amz-server-side-encryption-customer-key-MD5" type:"string"`
- // If present, specifies the ID of the Amazon Web Services Key Management Service
- // (Amazon Web Services KMS) symmetric customer managed key that was used for
- // stored in Amazon S3 object.
- //
- // SSEKMSKeyId is a sensitive parameter and its value will be
- // replaced with "sensitive" in string returned by WriteGetObjectResponseInput's
- // String and GoString methods.
- SSEKMSKeyId *string `location:"header" locationName:"x-amz-fwd-header-x-amz-server-side-encryption-aws-kms-key-id" type:"string" sensitive:"true"`
- // The server-side encryption algorithm used when storing requested object in
- // Amazon S3 (for example, AES256, aws:kms).
- ServerSideEncryption *string `location:"header" locationName:"x-amz-fwd-header-x-amz-server-side-encryption" type:"string" enum:"ServerSideEncryption"`
- // The integer status code for an HTTP response of a corresponding GetObject
- // request.
- //
- // Status Codes
- //
- // * 200 - OK
- //
- // * 206 - Partial Content
- //
- // * 304 - Not Modified
- //
- // * 400 - Bad Request
- //
- // * 401 - Unauthorized
- //
- // * 403 - Forbidden
- //
- // * 404 - Not Found
- //
- // * 405 - Method Not Allowed
- //
- // * 409 - Conflict
- //
- // * 411 - Length Required
- //
- // * 412 - Precondition Failed
- //
- // * 416 - Range Not Satisfiable
- //
- // * 500 - Internal Server Error
- //
- // * 503 - Service Unavailable
- StatusCode *int64 `location:"header" locationName:"x-amz-fwd-status" type:"integer"`
- // Provides storage class information of the object. Amazon S3 returns this
- // header for all objects except for S3 Standard storage class objects.
- //
- // For more information, see Storage Classes (https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html).
- StorageClass *string `location:"header" locationName:"x-amz-fwd-header-x-amz-storage-class" type:"string" enum:"StorageClass"`
- // The number of tags, if any, on the object.
- TagCount *int64 `location:"header" locationName:"x-amz-fwd-header-x-amz-tagging-count" type:"integer"`
- // An ID used to reference a specific version of the object.
- VersionId *string `location:"header" locationName:"x-amz-fwd-header-x-amz-version-id" type:"string"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s WriteGetObjectResponseInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s WriteGetObjectResponseInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *WriteGetObjectResponseInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "WriteGetObjectResponseInput"}
- if s.RequestRoute == nil {
- invalidParams.Add(request.NewErrParamRequired("RequestRoute"))
- }
- if s.RequestRoute != nil && len(*s.RequestRoute) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("RequestRoute", 1))
- }
- if s.RequestToken == nil {
- invalidParams.Add(request.NewErrParamRequired("RequestToken"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetAcceptRanges sets the AcceptRanges field's value.
- func (s *WriteGetObjectResponseInput) SetAcceptRanges(v string) *WriteGetObjectResponseInput {
- s.AcceptRanges = &v
- return s
- }
- // SetBody sets the Body field's value.
- func (s *WriteGetObjectResponseInput) SetBody(v io.ReadSeeker) *WriteGetObjectResponseInput {
- s.Body = v
- return s
- }
- // SetBucketKeyEnabled sets the BucketKeyEnabled field's value.
- func (s *WriteGetObjectResponseInput) SetBucketKeyEnabled(v bool) *WriteGetObjectResponseInput {
- s.BucketKeyEnabled = &v
- return s
- }
- // SetCacheControl sets the CacheControl field's value.
- func (s *WriteGetObjectResponseInput) SetCacheControl(v string) *WriteGetObjectResponseInput {
- s.CacheControl = &v
- return s
- }
- // SetChecksumCRC32 sets the ChecksumCRC32 field's value.
- func (s *WriteGetObjectResponseInput) SetChecksumCRC32(v string) *WriteGetObjectResponseInput {
- s.ChecksumCRC32 = &v
- return s
- }
- // SetChecksumCRC32C sets the ChecksumCRC32C field's value.
- func (s *WriteGetObjectResponseInput) SetChecksumCRC32C(v string) *WriteGetObjectResponseInput {
- s.ChecksumCRC32C = &v
- return s
- }
- // SetChecksumSHA1 sets the ChecksumSHA1 field's value.
- func (s *WriteGetObjectResponseInput) SetChecksumSHA1(v string) *WriteGetObjectResponseInput {
- s.ChecksumSHA1 = &v
- return s
- }
- // SetChecksumSHA256 sets the ChecksumSHA256 field's value.
- func (s *WriteGetObjectResponseInput) SetChecksumSHA256(v string) *WriteGetObjectResponseInput {
- s.ChecksumSHA256 = &v
- return s
- }
- // SetContentDisposition sets the ContentDisposition field's value.
- func (s *WriteGetObjectResponseInput) SetContentDisposition(v string) *WriteGetObjectResponseInput {
- s.ContentDisposition = &v
- return s
- }
- // SetContentEncoding sets the ContentEncoding field's value.
- func (s *WriteGetObjectResponseInput) SetContentEncoding(v string) *WriteGetObjectResponseInput {
- s.ContentEncoding = &v
- return s
- }
- // SetContentLanguage sets the ContentLanguage field's value.
- func (s *WriteGetObjectResponseInput) SetContentLanguage(v string) *WriteGetObjectResponseInput {
- s.ContentLanguage = &v
- return s
- }
- // SetContentLength sets the ContentLength field's value.
- func (s *WriteGetObjectResponseInput) SetContentLength(v int64) *WriteGetObjectResponseInput {
- s.ContentLength = &v
- return s
- }
- // SetContentRange sets the ContentRange field's value.
- func (s *WriteGetObjectResponseInput) SetContentRange(v string) *WriteGetObjectResponseInput {
- s.ContentRange = &v
- return s
- }
- // SetContentType sets the ContentType field's value.
- func (s *WriteGetObjectResponseInput) SetContentType(v string) *WriteGetObjectResponseInput {
- s.ContentType = &v
- return s
- }
- // SetDeleteMarker sets the DeleteMarker field's value.
- func (s *WriteGetObjectResponseInput) SetDeleteMarker(v bool) *WriteGetObjectResponseInput {
- s.DeleteMarker = &v
- return s
- }
- // SetETag sets the ETag field's value.
- func (s *WriteGetObjectResponseInput) SetETag(v string) *WriteGetObjectResponseInput {
- s.ETag = &v
- return s
- }
- // SetErrorCode sets the ErrorCode field's value.
- func (s *WriteGetObjectResponseInput) SetErrorCode(v string) *WriteGetObjectResponseInput {
- s.ErrorCode = &v
- return s
- }
- // SetErrorMessage sets the ErrorMessage field's value.
- func (s *WriteGetObjectResponseInput) SetErrorMessage(v string) *WriteGetObjectResponseInput {
- s.ErrorMessage = &v
- return s
- }
- // SetExpiration sets the Expiration field's value.
- func (s *WriteGetObjectResponseInput) SetExpiration(v string) *WriteGetObjectResponseInput {
- s.Expiration = &v
- return s
- }
- // SetExpires sets the Expires field's value.
- func (s *WriteGetObjectResponseInput) SetExpires(v time.Time) *WriteGetObjectResponseInput {
- s.Expires = &v
- return s
- }
- // SetLastModified sets the LastModified field's value.
- func (s *WriteGetObjectResponseInput) SetLastModified(v time.Time) *WriteGetObjectResponseInput {
- s.LastModified = &v
- return s
- }
- // SetMetadata sets the Metadata field's value.
- func (s *WriteGetObjectResponseInput) SetMetadata(v map[string]*string) *WriteGetObjectResponseInput {
- s.Metadata = v
- return s
- }
- // SetMissingMeta sets the MissingMeta field's value.
- func (s *WriteGetObjectResponseInput) SetMissingMeta(v int64) *WriteGetObjectResponseInput {
- s.MissingMeta = &v
- return s
- }
- // SetObjectLockLegalHoldStatus sets the ObjectLockLegalHoldStatus field's value.
- func (s *WriteGetObjectResponseInput) SetObjectLockLegalHoldStatus(v string) *WriteGetObjectResponseInput {
- s.ObjectLockLegalHoldStatus = &v
- return s
- }
- // SetObjectLockMode sets the ObjectLockMode field's value.
- func (s *WriteGetObjectResponseInput) SetObjectLockMode(v string) *WriteGetObjectResponseInput {
- s.ObjectLockMode = &v
- return s
- }
- // SetObjectLockRetainUntilDate sets the ObjectLockRetainUntilDate field's value.
- func (s *WriteGetObjectResponseInput) SetObjectLockRetainUntilDate(v time.Time) *WriteGetObjectResponseInput {
- s.ObjectLockRetainUntilDate = &v
- return s
- }
- // SetPartsCount sets the PartsCount field's value.
- func (s *WriteGetObjectResponseInput) SetPartsCount(v int64) *WriteGetObjectResponseInput {
- s.PartsCount = &v
- return s
- }
- // SetReplicationStatus sets the ReplicationStatus field's value.
- func (s *WriteGetObjectResponseInput) SetReplicationStatus(v string) *WriteGetObjectResponseInput {
- s.ReplicationStatus = &v
- return s
- }
- // SetRequestCharged sets the RequestCharged field's value.
- func (s *WriteGetObjectResponseInput) SetRequestCharged(v string) *WriteGetObjectResponseInput {
- s.RequestCharged = &v
- return s
- }
- // SetRequestRoute sets the RequestRoute field's value.
- func (s *WriteGetObjectResponseInput) SetRequestRoute(v string) *WriteGetObjectResponseInput {
- s.RequestRoute = &v
- return s
- }
- // SetRequestToken sets the RequestToken field's value.
- func (s *WriteGetObjectResponseInput) SetRequestToken(v string) *WriteGetObjectResponseInput {
- s.RequestToken = &v
- return s
- }
- // SetRestore sets the Restore field's value.
- func (s *WriteGetObjectResponseInput) SetRestore(v string) *WriteGetObjectResponseInput {
- s.Restore = &v
- return s
- }
- // SetSSECustomerAlgorithm sets the SSECustomerAlgorithm field's value.
- func (s *WriteGetObjectResponseInput) SetSSECustomerAlgorithm(v string) *WriteGetObjectResponseInput {
- s.SSECustomerAlgorithm = &v
- return s
- }
- // SetSSECustomerKeyMD5 sets the SSECustomerKeyMD5 field's value.
- func (s *WriteGetObjectResponseInput) SetSSECustomerKeyMD5(v string) *WriteGetObjectResponseInput {
- s.SSECustomerKeyMD5 = &v
- return s
- }
- // SetSSEKMSKeyId sets the SSEKMSKeyId field's value.
- func (s *WriteGetObjectResponseInput) SetSSEKMSKeyId(v string) *WriteGetObjectResponseInput {
- s.SSEKMSKeyId = &v
- return s
- }
- // SetServerSideEncryption sets the ServerSideEncryption field's value.
- func (s *WriteGetObjectResponseInput) SetServerSideEncryption(v string) *WriteGetObjectResponseInput {
- s.ServerSideEncryption = &v
- return s
- }
- // SetStatusCode sets the StatusCode field's value.
- func (s *WriteGetObjectResponseInput) SetStatusCode(v int64) *WriteGetObjectResponseInput {
- s.StatusCode = &v
- return s
- }
- // SetStorageClass sets the StorageClass field's value.
- func (s *WriteGetObjectResponseInput) SetStorageClass(v string) *WriteGetObjectResponseInput {
- s.StorageClass = &v
- return s
- }
- // SetTagCount sets the TagCount field's value.
- func (s *WriteGetObjectResponseInput) SetTagCount(v int64) *WriteGetObjectResponseInput {
- s.TagCount = &v
- return s
- }
- // SetVersionId sets the VersionId field's value.
- func (s *WriteGetObjectResponseInput) SetVersionId(v string) *WriteGetObjectResponseInput {
- s.VersionId = &v
- return s
- }
- func (s *WriteGetObjectResponseInput) hostLabels() map[string]string {
- return map[string]string{
- "RequestRoute": aws.StringValue(s.RequestRoute),
- }
- }
- type WriteGetObjectResponseOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s WriteGetObjectResponseOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation.
- //
- // API parameter values that are decorated as "sensitive" in the API will not
- // be included in the string output. The member name will be present, but the
- // value will be replaced with "sensitive".
- func (s WriteGetObjectResponseOutput) GoString() string {
- return s.String()
- }
- const (
- // AnalyticsS3ExportFileFormatCsv is a AnalyticsS3ExportFileFormat enum value
- AnalyticsS3ExportFileFormatCsv = "CSV"
- )
- // AnalyticsS3ExportFileFormat_Values returns all elements of the AnalyticsS3ExportFileFormat enum
- func AnalyticsS3ExportFileFormat_Values() []string {
- return []string{
- AnalyticsS3ExportFileFormatCsv,
- }
- }
- const (
- // ArchiveStatusArchiveAccess is a ArchiveStatus enum value
- ArchiveStatusArchiveAccess = "ARCHIVE_ACCESS"
- // ArchiveStatusDeepArchiveAccess is a ArchiveStatus enum value
- ArchiveStatusDeepArchiveAccess = "DEEP_ARCHIVE_ACCESS"
- )
- // ArchiveStatus_Values returns all elements of the ArchiveStatus enum
- func ArchiveStatus_Values() []string {
- return []string{
- ArchiveStatusArchiveAccess,
- ArchiveStatusDeepArchiveAccess,
- }
- }
- const (
- // BucketAccelerateStatusEnabled is a BucketAccelerateStatus enum value
- BucketAccelerateStatusEnabled = "Enabled"
- // BucketAccelerateStatusSuspended is a BucketAccelerateStatus enum value
- BucketAccelerateStatusSuspended = "Suspended"
- )
- // BucketAccelerateStatus_Values returns all elements of the BucketAccelerateStatus enum
- func BucketAccelerateStatus_Values() []string {
- return []string{
- BucketAccelerateStatusEnabled,
- BucketAccelerateStatusSuspended,
- }
- }
- const (
- // BucketCannedACLPrivate is a BucketCannedACL enum value
- BucketCannedACLPrivate = "private"
- // BucketCannedACLPublicRead is a BucketCannedACL enum value
- BucketCannedACLPublicRead = "public-read"
- // BucketCannedACLPublicReadWrite is a BucketCannedACL enum value
- BucketCannedACLPublicReadWrite = "public-read-write"
- // BucketCannedACLAuthenticatedRead is a BucketCannedACL enum value
- BucketCannedACLAuthenticatedRead = "authenticated-read"
- )
- // BucketCannedACL_Values returns all elements of the BucketCannedACL enum
- func BucketCannedACL_Values() []string {
- return []string{
- BucketCannedACLPrivate,
- BucketCannedACLPublicRead,
- BucketCannedACLPublicReadWrite,
- BucketCannedACLAuthenticatedRead,
- }
- }
- const (
- // BucketLocationConstraintAfSouth1 is a BucketLocationConstraint enum value
- BucketLocationConstraintAfSouth1 = "af-south-1"
- // BucketLocationConstraintApEast1 is a BucketLocationConstraint enum value
- BucketLocationConstraintApEast1 = "ap-east-1"
- // BucketLocationConstraintApNortheast1 is a BucketLocationConstraint enum value
- BucketLocationConstraintApNortheast1 = "ap-northeast-1"
- // BucketLocationConstraintApNortheast2 is a BucketLocationConstraint enum value
- BucketLocationConstraintApNortheast2 = "ap-northeast-2"
- // BucketLocationConstraintApNortheast3 is a BucketLocationConstraint enum value
- BucketLocationConstraintApNortheast3 = "ap-northeast-3"
- // BucketLocationConstraintApSouth1 is a BucketLocationConstraint enum value
- BucketLocationConstraintApSouth1 = "ap-south-1"
- // BucketLocationConstraintApSoutheast1 is a BucketLocationConstraint enum value
- BucketLocationConstraintApSoutheast1 = "ap-southeast-1"
- // BucketLocationConstraintApSoutheast2 is a BucketLocationConstraint enum value
- BucketLocationConstraintApSoutheast2 = "ap-southeast-2"
- // BucketLocationConstraintApSoutheast3 is a BucketLocationConstraint enum value
- BucketLocationConstraintApSoutheast3 = "ap-southeast-3"
- // BucketLocationConstraintCaCentral1 is a BucketLocationConstraint enum value
- BucketLocationConstraintCaCentral1 = "ca-central-1"
- // BucketLocationConstraintCnNorth1 is a BucketLocationConstraint enum value
- BucketLocationConstraintCnNorth1 = "cn-north-1"
- // BucketLocationConstraintCnNorthwest1 is a BucketLocationConstraint enum value
- BucketLocationConstraintCnNorthwest1 = "cn-northwest-1"
- // BucketLocationConstraintEu is a BucketLocationConstraint enum value
- BucketLocationConstraintEu = "EU"
- // BucketLocationConstraintEuCentral1 is a BucketLocationConstraint enum value
- BucketLocationConstraintEuCentral1 = "eu-central-1"
- // BucketLocationConstraintEuNorth1 is a BucketLocationConstraint enum value
- BucketLocationConstraintEuNorth1 = "eu-north-1"
- // BucketLocationConstraintEuSouth1 is a BucketLocationConstraint enum value
- BucketLocationConstraintEuSouth1 = "eu-south-1"
- // BucketLocationConstraintEuWest1 is a BucketLocationConstraint enum value
- BucketLocationConstraintEuWest1 = "eu-west-1"
- // BucketLocationConstraintEuWest2 is a BucketLocationConstraint enum value
- BucketLocationConstraintEuWest2 = "eu-west-2"
- // BucketLocationConstraintEuWest3 is a BucketLocationConstraint enum value
- BucketLocationConstraintEuWest3 = "eu-west-3"
- // BucketLocationConstraintMeSouth1 is a BucketLocationConstraint enum value
- BucketLocationConstraintMeSouth1 = "me-south-1"
- // BucketLocationConstraintSaEast1 is a BucketLocationConstraint enum value
- BucketLocationConstraintSaEast1 = "sa-east-1"
- // BucketLocationConstraintUsEast2 is a BucketLocationConstraint enum value
- BucketLocationConstraintUsEast2 = "us-east-2"
- // BucketLocationConstraintUsGovEast1 is a BucketLocationConstraint enum value
- BucketLocationConstraintUsGovEast1 = "us-gov-east-1"
- // BucketLocationConstraintUsGovWest1 is a BucketLocationConstraint enum value
- BucketLocationConstraintUsGovWest1 = "us-gov-west-1"
- // BucketLocationConstraintUsWest1 is a BucketLocationConstraint enum value
- BucketLocationConstraintUsWest1 = "us-west-1"
- // BucketLocationConstraintUsWest2 is a BucketLocationConstraint enum value
- BucketLocationConstraintUsWest2 = "us-west-2"
- )
- // BucketLocationConstraint_Values returns all elements of the BucketLocationConstraint enum
- func BucketLocationConstraint_Values() []string {
- return []string{
- BucketLocationConstraintAfSouth1,
- BucketLocationConstraintApEast1,
- BucketLocationConstraintApNortheast1,
- BucketLocationConstraintApNortheast2,
- BucketLocationConstraintApNortheast3,
- BucketLocationConstraintApSouth1,
- BucketLocationConstraintApSoutheast1,
- BucketLocationConstraintApSoutheast2,
- BucketLocationConstraintApSoutheast3,
- BucketLocationConstraintCaCentral1,
- BucketLocationConstraintCnNorth1,
- BucketLocationConstraintCnNorthwest1,
- BucketLocationConstraintEu,
- BucketLocationConstraintEuCentral1,
- BucketLocationConstraintEuNorth1,
- BucketLocationConstraintEuSouth1,
- BucketLocationConstraintEuWest1,
- BucketLocationConstraintEuWest2,
- BucketLocationConstraintEuWest3,
- BucketLocationConstraintMeSouth1,
- BucketLocationConstraintSaEast1,
- BucketLocationConstraintUsEast2,
- BucketLocationConstraintUsGovEast1,
- BucketLocationConstraintUsGovWest1,
- BucketLocationConstraintUsWest1,
- BucketLocationConstraintUsWest2,
- }
- }
- const (
- // BucketLogsPermissionFullControl is a BucketLogsPermission enum value
- BucketLogsPermissionFullControl = "FULL_CONTROL"
- // BucketLogsPermissionRead is a BucketLogsPermission enum value
- BucketLogsPermissionRead = "READ"
- // BucketLogsPermissionWrite is a BucketLogsPermission enum value
- BucketLogsPermissionWrite = "WRITE"
- )
- // BucketLogsPermission_Values returns all elements of the BucketLogsPermission enum
- func BucketLogsPermission_Values() []string {
- return []string{
- BucketLogsPermissionFullControl,
- BucketLogsPermissionRead,
- BucketLogsPermissionWrite,
- }
- }
- const (
- // BucketVersioningStatusEnabled is a BucketVersioningStatus enum value
- BucketVersioningStatusEnabled = "Enabled"
- // BucketVersioningStatusSuspended is a BucketVersioningStatus enum value
- BucketVersioningStatusSuspended = "Suspended"
- )
- // BucketVersioningStatus_Values returns all elements of the BucketVersioningStatus enum
- func BucketVersioningStatus_Values() []string {
- return []string{
- BucketVersioningStatusEnabled,
- BucketVersioningStatusSuspended,
- }
- }
- const (
- // ChecksumAlgorithmCrc32 is a ChecksumAlgorithm enum value
- ChecksumAlgorithmCrc32 = "CRC32"
- // ChecksumAlgorithmCrc32c is a ChecksumAlgorithm enum value
- ChecksumAlgorithmCrc32c = "CRC32C"
- // ChecksumAlgorithmSha1 is a ChecksumAlgorithm enum value
- ChecksumAlgorithmSha1 = "SHA1"
- // ChecksumAlgorithmSha256 is a ChecksumAlgorithm enum value
- ChecksumAlgorithmSha256 = "SHA256"
- )
- // ChecksumAlgorithm_Values returns all elements of the ChecksumAlgorithm enum
- func ChecksumAlgorithm_Values() []string {
- return []string{
- ChecksumAlgorithmCrc32,
- ChecksumAlgorithmCrc32c,
- ChecksumAlgorithmSha1,
- ChecksumAlgorithmSha256,
- }
- }
- const (
- // ChecksumModeEnabled is a ChecksumMode enum value
- ChecksumModeEnabled = "ENABLED"
- )
- // ChecksumMode_Values returns all elements of the ChecksumMode enum
- func ChecksumMode_Values() []string {
- return []string{
- ChecksumModeEnabled,
- }
- }
- const (
- // CompressionTypeNone is a CompressionType enum value
- CompressionTypeNone = "NONE"
- // CompressionTypeGzip is a CompressionType enum value
- CompressionTypeGzip = "GZIP"
- // CompressionTypeBzip2 is a CompressionType enum value
- CompressionTypeBzip2 = "BZIP2"
- )
- // CompressionType_Values returns all elements of the CompressionType enum
- func CompressionType_Values() []string {
- return []string{
- CompressionTypeNone,
- CompressionTypeGzip,
- CompressionTypeBzip2,
- }
- }
- const (
- // DeleteMarkerReplicationStatusEnabled is a DeleteMarkerReplicationStatus enum value
- DeleteMarkerReplicationStatusEnabled = "Enabled"
- // DeleteMarkerReplicationStatusDisabled is a DeleteMarkerReplicationStatus enum value
- DeleteMarkerReplicationStatusDisabled = "Disabled"
- )
- // DeleteMarkerReplicationStatus_Values returns all elements of the DeleteMarkerReplicationStatus enum
- func DeleteMarkerReplicationStatus_Values() []string {
- return []string{
- DeleteMarkerReplicationStatusEnabled,
- DeleteMarkerReplicationStatusDisabled,
- }
- }
- // Requests Amazon S3 to encode the object keys in the response and specifies
- // the encoding method to use. An object key may contain any Unicode character;
- // however, XML 1.0 parser cannot parse some characters, such as characters
- // with an ASCII value from 0 to 10. For characters that are not supported in
- // XML 1.0, you can add this parameter to request that Amazon S3 encode the
- // keys in the response.
- const (
- // EncodingTypeUrl is a EncodingType enum value
- EncodingTypeUrl = "url"
- )
- // EncodingType_Values returns all elements of the EncodingType enum
- func EncodingType_Values() []string {
- return []string{
- EncodingTypeUrl,
- }
- }
- // The bucket event for which to send notifications.
- const (
- // EventS3ReducedRedundancyLostObject is a Event enum value
- EventS3ReducedRedundancyLostObject = "s3:ReducedRedundancyLostObject"
- // EventS3ObjectCreated is a Event enum value
- EventS3ObjectCreated = "s3:ObjectCreated:*"
- // EventS3ObjectCreatedPut is a Event enum value
- EventS3ObjectCreatedPut = "s3:ObjectCreated:Put"
- // EventS3ObjectCreatedPost is a Event enum value
- EventS3ObjectCreatedPost = "s3:ObjectCreated:Post"
- // EventS3ObjectCreatedCopy is a Event enum value
- EventS3ObjectCreatedCopy = "s3:ObjectCreated:Copy"
- // EventS3ObjectCreatedCompleteMultipartUpload is a Event enum value
- EventS3ObjectCreatedCompleteMultipartUpload = "s3:ObjectCreated:CompleteMultipartUpload"
- // EventS3ObjectRemoved is a Event enum value
- EventS3ObjectRemoved = "s3:ObjectRemoved:*"
- // EventS3ObjectRemovedDelete is a Event enum value
- EventS3ObjectRemovedDelete = "s3:ObjectRemoved:Delete"
- // EventS3ObjectRemovedDeleteMarkerCreated is a Event enum value
- EventS3ObjectRemovedDeleteMarkerCreated = "s3:ObjectRemoved:DeleteMarkerCreated"
- // EventS3ObjectRestore is a Event enum value
- EventS3ObjectRestore = "s3:ObjectRestore:*"
- // EventS3ObjectRestorePost is a Event enum value
- EventS3ObjectRestorePost = "s3:ObjectRestore:Post"
- // EventS3ObjectRestoreCompleted is a Event enum value
- EventS3ObjectRestoreCompleted = "s3:ObjectRestore:Completed"
- // EventS3Replication is a Event enum value
- EventS3Replication = "s3:Replication:*"
- // EventS3ReplicationOperationFailedReplication is a Event enum value
- EventS3ReplicationOperationFailedReplication = "s3:Replication:OperationFailedReplication"
- // EventS3ReplicationOperationNotTracked is a Event enum value
- EventS3ReplicationOperationNotTracked = "s3:Replication:OperationNotTracked"
- // EventS3ReplicationOperationMissedThreshold is a Event enum value
- EventS3ReplicationOperationMissedThreshold = "s3:Replication:OperationMissedThreshold"
- // EventS3ReplicationOperationReplicatedAfterThreshold is a Event enum value
- EventS3ReplicationOperationReplicatedAfterThreshold = "s3:Replication:OperationReplicatedAfterThreshold"
- // EventS3ObjectRestoreDelete is a Event enum value
- EventS3ObjectRestoreDelete = "s3:ObjectRestore:Delete"
- // EventS3LifecycleTransition is a Event enum value
- EventS3LifecycleTransition = "s3:LifecycleTransition"
- // EventS3IntelligentTiering is a Event enum value
- EventS3IntelligentTiering = "s3:IntelligentTiering"
- // EventS3ObjectAclPut is a Event enum value
- EventS3ObjectAclPut = "s3:ObjectAcl:Put"
- // EventS3LifecycleExpiration is a Event enum value
- EventS3LifecycleExpiration = "s3:LifecycleExpiration:*"
- // EventS3LifecycleExpirationDelete is a Event enum value
- EventS3LifecycleExpirationDelete = "s3:LifecycleExpiration:Delete"
- // EventS3LifecycleExpirationDeleteMarkerCreated is a Event enum value
- EventS3LifecycleExpirationDeleteMarkerCreated = "s3:LifecycleExpiration:DeleteMarkerCreated"
- // EventS3ObjectTagging is a Event enum value
- EventS3ObjectTagging = "s3:ObjectTagging:*"
- // EventS3ObjectTaggingPut is a Event enum value
- EventS3ObjectTaggingPut = "s3:ObjectTagging:Put"
- // EventS3ObjectTaggingDelete is a Event enum value
- EventS3ObjectTaggingDelete = "s3:ObjectTagging:Delete"
- )
- // Event_Values returns all elements of the Event enum
- func Event_Values() []string {
- return []string{
- EventS3ReducedRedundancyLostObject,
- EventS3ObjectCreated,
- EventS3ObjectCreatedPut,
- EventS3ObjectCreatedPost,
- EventS3ObjectCreatedCopy,
- EventS3ObjectCreatedCompleteMultipartUpload,
- EventS3ObjectRemoved,
- EventS3ObjectRemovedDelete,
- EventS3ObjectRemovedDeleteMarkerCreated,
- EventS3ObjectRestore,
- EventS3ObjectRestorePost,
- EventS3ObjectRestoreCompleted,
- EventS3Replication,
- EventS3ReplicationOperationFailedReplication,
- EventS3ReplicationOperationNotTracked,
- EventS3ReplicationOperationMissedThreshold,
- EventS3ReplicationOperationReplicatedAfterThreshold,
- EventS3ObjectRestoreDelete,
- EventS3LifecycleTransition,
- EventS3IntelligentTiering,
- EventS3ObjectAclPut,
- EventS3LifecycleExpiration,
- EventS3LifecycleExpirationDelete,
- EventS3LifecycleExpirationDeleteMarkerCreated,
- EventS3ObjectTagging,
- EventS3ObjectTaggingPut,
- EventS3ObjectTaggingDelete,
- }
- }
- const (
- // ExistingObjectReplicationStatusEnabled is a ExistingObjectReplicationStatus enum value
- ExistingObjectReplicationStatusEnabled = "Enabled"
- // ExistingObjectReplicationStatusDisabled is a ExistingObjectReplicationStatus enum value
- ExistingObjectReplicationStatusDisabled = "Disabled"
- )
- // ExistingObjectReplicationStatus_Values returns all elements of the ExistingObjectReplicationStatus enum
- func ExistingObjectReplicationStatus_Values() []string {
- return []string{
- ExistingObjectReplicationStatusEnabled,
- ExistingObjectReplicationStatusDisabled,
- }
- }
- const (
- // ExpirationStatusEnabled is a ExpirationStatus enum value
- ExpirationStatusEnabled = "Enabled"
- // ExpirationStatusDisabled is a ExpirationStatus enum value
- ExpirationStatusDisabled = "Disabled"
- )
- // ExpirationStatus_Values returns all elements of the ExpirationStatus enum
- func ExpirationStatus_Values() []string {
- return []string{
- ExpirationStatusEnabled,
- ExpirationStatusDisabled,
- }
- }
- const (
- // ExpressionTypeSql is a ExpressionType enum value
- ExpressionTypeSql = "SQL"
- )
- // ExpressionType_Values returns all elements of the ExpressionType enum
- func ExpressionType_Values() []string {
- return []string{
- ExpressionTypeSql,
- }
- }
- const (
- // FileHeaderInfoUse is a FileHeaderInfo enum value
- FileHeaderInfoUse = "USE"
- // FileHeaderInfoIgnore is a FileHeaderInfo enum value
- FileHeaderInfoIgnore = "IGNORE"
- // FileHeaderInfoNone is a FileHeaderInfo enum value
- FileHeaderInfoNone = "NONE"
- )
- // FileHeaderInfo_Values returns all elements of the FileHeaderInfo enum
- func FileHeaderInfo_Values() []string {
- return []string{
- FileHeaderInfoUse,
- FileHeaderInfoIgnore,
- FileHeaderInfoNone,
- }
- }
- const (
- // FilterRuleNamePrefix is a FilterRuleName enum value
- FilterRuleNamePrefix = "prefix"
- // FilterRuleNameSuffix is a FilterRuleName enum value
- FilterRuleNameSuffix = "suffix"
- )
- // FilterRuleName_Values returns all elements of the FilterRuleName enum
- func FilterRuleName_Values() []string {
- return []string{
- FilterRuleNamePrefix,
- FilterRuleNameSuffix,
- }
- }
- const (
- // IntelligentTieringAccessTierArchiveAccess is a IntelligentTieringAccessTier enum value
- IntelligentTieringAccessTierArchiveAccess = "ARCHIVE_ACCESS"
- // IntelligentTieringAccessTierDeepArchiveAccess is a IntelligentTieringAccessTier enum value
- IntelligentTieringAccessTierDeepArchiveAccess = "DEEP_ARCHIVE_ACCESS"
- )
- // IntelligentTieringAccessTier_Values returns all elements of the IntelligentTieringAccessTier enum
- func IntelligentTieringAccessTier_Values() []string {
- return []string{
- IntelligentTieringAccessTierArchiveAccess,
- IntelligentTieringAccessTierDeepArchiveAccess,
- }
- }
- const (
- // IntelligentTieringStatusEnabled is a IntelligentTieringStatus enum value
- IntelligentTieringStatusEnabled = "Enabled"
- // IntelligentTieringStatusDisabled is a IntelligentTieringStatus enum value
- IntelligentTieringStatusDisabled = "Disabled"
- )
- // IntelligentTieringStatus_Values returns all elements of the IntelligentTieringStatus enum
- func IntelligentTieringStatus_Values() []string {
- return []string{
- IntelligentTieringStatusEnabled,
- IntelligentTieringStatusDisabled,
- }
- }
- const (
- // InventoryFormatCsv is a InventoryFormat enum value
- InventoryFormatCsv = "CSV"
- // InventoryFormatOrc is a InventoryFormat enum value
- InventoryFormatOrc = "ORC"
- // InventoryFormatParquet is a InventoryFormat enum value
- InventoryFormatParquet = "Parquet"
- )
- // InventoryFormat_Values returns all elements of the InventoryFormat enum
- func InventoryFormat_Values() []string {
- return []string{
- InventoryFormatCsv,
- InventoryFormatOrc,
- InventoryFormatParquet,
- }
- }
- const (
- // InventoryFrequencyDaily is a InventoryFrequency enum value
- InventoryFrequencyDaily = "Daily"
- // InventoryFrequencyWeekly is a InventoryFrequency enum value
- InventoryFrequencyWeekly = "Weekly"
- )
- // InventoryFrequency_Values returns all elements of the InventoryFrequency enum
- func InventoryFrequency_Values() []string {
- return []string{
- InventoryFrequencyDaily,
- InventoryFrequencyWeekly,
- }
- }
- const (
- // InventoryIncludedObjectVersionsAll is a InventoryIncludedObjectVersions enum value
- InventoryIncludedObjectVersionsAll = "All"
- // InventoryIncludedObjectVersionsCurrent is a InventoryIncludedObjectVersions enum value
- InventoryIncludedObjectVersionsCurrent = "Current"
- )
- // InventoryIncludedObjectVersions_Values returns all elements of the InventoryIncludedObjectVersions enum
- func InventoryIncludedObjectVersions_Values() []string {
- return []string{
- InventoryIncludedObjectVersionsAll,
- InventoryIncludedObjectVersionsCurrent,
- }
- }
- const (
- // InventoryOptionalFieldSize is a InventoryOptionalField enum value
- InventoryOptionalFieldSize = "Size"
- // InventoryOptionalFieldLastModifiedDate is a InventoryOptionalField enum value
- InventoryOptionalFieldLastModifiedDate = "LastModifiedDate"
- // InventoryOptionalFieldStorageClass is a InventoryOptionalField enum value
- InventoryOptionalFieldStorageClass = "StorageClass"
- // InventoryOptionalFieldEtag is a InventoryOptionalField enum value
- InventoryOptionalFieldEtag = "ETag"
- // InventoryOptionalFieldIsMultipartUploaded is a InventoryOptionalField enum value
- InventoryOptionalFieldIsMultipartUploaded = "IsMultipartUploaded"
- // InventoryOptionalFieldReplicationStatus is a InventoryOptionalField enum value
- InventoryOptionalFieldReplicationStatus = "ReplicationStatus"
- // InventoryOptionalFieldEncryptionStatus is a InventoryOptionalField enum value
- InventoryOptionalFieldEncryptionStatus = "EncryptionStatus"
- // InventoryOptionalFieldObjectLockRetainUntilDate is a InventoryOptionalField enum value
- InventoryOptionalFieldObjectLockRetainUntilDate = "ObjectLockRetainUntilDate"
- // InventoryOptionalFieldObjectLockMode is a InventoryOptionalField enum value
- InventoryOptionalFieldObjectLockMode = "ObjectLockMode"
- // InventoryOptionalFieldObjectLockLegalHoldStatus is a InventoryOptionalField enum value
- InventoryOptionalFieldObjectLockLegalHoldStatus = "ObjectLockLegalHoldStatus"
- // InventoryOptionalFieldIntelligentTieringAccessTier is a InventoryOptionalField enum value
- InventoryOptionalFieldIntelligentTieringAccessTier = "IntelligentTieringAccessTier"
- // InventoryOptionalFieldBucketKeyStatus is a InventoryOptionalField enum value
- InventoryOptionalFieldBucketKeyStatus = "BucketKeyStatus"
- // InventoryOptionalFieldChecksumAlgorithm is a InventoryOptionalField enum value
- InventoryOptionalFieldChecksumAlgorithm = "ChecksumAlgorithm"
- )
- // InventoryOptionalField_Values returns all elements of the InventoryOptionalField enum
- func InventoryOptionalField_Values() []string {
- return []string{
- InventoryOptionalFieldSize,
- InventoryOptionalFieldLastModifiedDate,
- InventoryOptionalFieldStorageClass,
- InventoryOptionalFieldEtag,
- InventoryOptionalFieldIsMultipartUploaded,
- InventoryOptionalFieldReplicationStatus,
- InventoryOptionalFieldEncryptionStatus,
- InventoryOptionalFieldObjectLockRetainUntilDate,
- InventoryOptionalFieldObjectLockMode,
- InventoryOptionalFieldObjectLockLegalHoldStatus,
- InventoryOptionalFieldIntelligentTieringAccessTier,
- InventoryOptionalFieldBucketKeyStatus,
- InventoryOptionalFieldChecksumAlgorithm,
- }
- }
- const (
- // JSONTypeDocument is a JSONType enum value
- JSONTypeDocument = "DOCUMENT"
- // JSONTypeLines is a JSONType enum value
- JSONTypeLines = "LINES"
- )
- // JSONType_Values returns all elements of the JSONType enum
- func JSONType_Values() []string {
- return []string{
- JSONTypeDocument,
- JSONTypeLines,
- }
- }
- const (
- // MFADeleteEnabled is a MFADelete enum value
- MFADeleteEnabled = "Enabled"
- // MFADeleteDisabled is a MFADelete enum value
- MFADeleteDisabled = "Disabled"
- )
- // MFADelete_Values returns all elements of the MFADelete enum
- func MFADelete_Values() []string {
- return []string{
- MFADeleteEnabled,
- MFADeleteDisabled,
- }
- }
- const (
- // MFADeleteStatusEnabled is a MFADeleteStatus enum value
- MFADeleteStatusEnabled = "Enabled"
- // MFADeleteStatusDisabled is a MFADeleteStatus enum value
- MFADeleteStatusDisabled = "Disabled"
- )
- // MFADeleteStatus_Values returns all elements of the MFADeleteStatus enum
- func MFADeleteStatus_Values() []string {
- return []string{
- MFADeleteStatusEnabled,
- MFADeleteStatusDisabled,
- }
- }
- const (
- // MetadataDirectiveCopy is a MetadataDirective enum value
- MetadataDirectiveCopy = "COPY"
- // MetadataDirectiveReplace is a MetadataDirective enum value
- MetadataDirectiveReplace = "REPLACE"
- )
- // MetadataDirective_Values returns all elements of the MetadataDirective enum
- func MetadataDirective_Values() []string {
- return []string{
- MetadataDirectiveCopy,
- MetadataDirectiveReplace,
- }
- }
- const (
- // MetricsStatusEnabled is a MetricsStatus enum value
- MetricsStatusEnabled = "Enabled"
- // MetricsStatusDisabled is a MetricsStatus enum value
- MetricsStatusDisabled = "Disabled"
- )
- // MetricsStatus_Values returns all elements of the MetricsStatus enum
- func MetricsStatus_Values() []string {
- return []string{
- MetricsStatusEnabled,
- MetricsStatusDisabled,
- }
- }
- const (
- // ObjectAttributesEtag is a ObjectAttributes enum value
- ObjectAttributesEtag = "ETag"
- // ObjectAttributesChecksum is a ObjectAttributes enum value
- ObjectAttributesChecksum = "Checksum"
- // ObjectAttributesObjectParts is a ObjectAttributes enum value
- ObjectAttributesObjectParts = "ObjectParts"
- // ObjectAttributesStorageClass is a ObjectAttributes enum value
- ObjectAttributesStorageClass = "StorageClass"
- // ObjectAttributesObjectSize is a ObjectAttributes enum value
- ObjectAttributesObjectSize = "ObjectSize"
- )
- // ObjectAttributes_Values returns all elements of the ObjectAttributes enum
- func ObjectAttributes_Values() []string {
- return []string{
- ObjectAttributesEtag,
- ObjectAttributesChecksum,
- ObjectAttributesObjectParts,
- ObjectAttributesStorageClass,
- ObjectAttributesObjectSize,
- }
- }
- const (
- // ObjectCannedACLPrivate is a ObjectCannedACL enum value
- ObjectCannedACLPrivate = "private"
- // ObjectCannedACLPublicRead is a ObjectCannedACL enum value
- ObjectCannedACLPublicRead = "public-read"
- // ObjectCannedACLPublicReadWrite is a ObjectCannedACL enum value
- ObjectCannedACLPublicReadWrite = "public-read-write"
- // ObjectCannedACLAuthenticatedRead is a ObjectCannedACL enum value
- ObjectCannedACLAuthenticatedRead = "authenticated-read"
- // ObjectCannedACLAwsExecRead is a ObjectCannedACL enum value
- ObjectCannedACLAwsExecRead = "aws-exec-read"
- // ObjectCannedACLBucketOwnerRead is a ObjectCannedACL enum value
- ObjectCannedACLBucketOwnerRead = "bucket-owner-read"
- // ObjectCannedACLBucketOwnerFullControl is a ObjectCannedACL enum value
- ObjectCannedACLBucketOwnerFullControl = "bucket-owner-full-control"
- )
- // ObjectCannedACL_Values returns all elements of the ObjectCannedACL enum
- func ObjectCannedACL_Values() []string {
- return []string{
- ObjectCannedACLPrivate,
- ObjectCannedACLPublicRead,
- ObjectCannedACLPublicReadWrite,
- ObjectCannedACLAuthenticatedRead,
- ObjectCannedACLAwsExecRead,
- ObjectCannedACLBucketOwnerRead,
- ObjectCannedACLBucketOwnerFullControl,
- }
- }
- const (
- // ObjectLockEnabledEnabled is a ObjectLockEnabled enum value
- ObjectLockEnabledEnabled = "Enabled"
- )
- // ObjectLockEnabled_Values returns all elements of the ObjectLockEnabled enum
- func ObjectLockEnabled_Values() []string {
- return []string{
- ObjectLockEnabledEnabled,
- }
- }
- const (
- // ObjectLockLegalHoldStatusOn is a ObjectLockLegalHoldStatus enum value
- ObjectLockLegalHoldStatusOn = "ON"
- // ObjectLockLegalHoldStatusOff is a ObjectLockLegalHoldStatus enum value
- ObjectLockLegalHoldStatusOff = "OFF"
- )
- // ObjectLockLegalHoldStatus_Values returns all elements of the ObjectLockLegalHoldStatus enum
- func ObjectLockLegalHoldStatus_Values() []string {
- return []string{
- ObjectLockLegalHoldStatusOn,
- ObjectLockLegalHoldStatusOff,
- }
- }
- const (
- // ObjectLockModeGovernance is a ObjectLockMode enum value
- ObjectLockModeGovernance = "GOVERNANCE"
- // ObjectLockModeCompliance is a ObjectLockMode enum value
- ObjectLockModeCompliance = "COMPLIANCE"
- )
- // ObjectLockMode_Values returns all elements of the ObjectLockMode enum
- func ObjectLockMode_Values() []string {
- return []string{
- ObjectLockModeGovernance,
- ObjectLockModeCompliance,
- }
- }
- const (
- // ObjectLockRetentionModeGovernance is a ObjectLockRetentionMode enum value
- ObjectLockRetentionModeGovernance = "GOVERNANCE"
- // ObjectLockRetentionModeCompliance is a ObjectLockRetentionMode enum value
- ObjectLockRetentionModeCompliance = "COMPLIANCE"
- )
- // ObjectLockRetentionMode_Values returns all elements of the ObjectLockRetentionMode enum
- func ObjectLockRetentionMode_Values() []string {
- return []string{
- ObjectLockRetentionModeGovernance,
- ObjectLockRetentionModeCompliance,
- }
- }
- // The container element for object ownership for a bucket's ownership controls.
- //
- // BucketOwnerPreferred - Objects uploaded to the bucket change ownership to
- // the bucket owner if the objects are uploaded with the bucket-owner-full-control
- // canned ACL.
- //
- // ObjectWriter - The uploading account will own the object if the object is
- // uploaded with the bucket-owner-full-control canned ACL.
- //
- // BucketOwnerEnforced - Access control lists (ACLs) are disabled and no longer
- // affect permissions. The bucket owner automatically owns and has full control
- // over every object in the bucket. The bucket only accepts PUT requests that
- // don't specify an ACL or bucket owner full control ACLs, such as the bucket-owner-full-control
- // canned ACL or an equivalent form of this ACL expressed in the XML format.
- const (
- // ObjectOwnershipBucketOwnerPreferred is a ObjectOwnership enum value
- ObjectOwnershipBucketOwnerPreferred = "BucketOwnerPreferred"
- // ObjectOwnershipObjectWriter is a ObjectOwnership enum value
- ObjectOwnershipObjectWriter = "ObjectWriter"
- // ObjectOwnershipBucketOwnerEnforced is a ObjectOwnership enum value
- ObjectOwnershipBucketOwnerEnforced = "BucketOwnerEnforced"
- )
- // ObjectOwnership_Values returns all elements of the ObjectOwnership enum
- func ObjectOwnership_Values() []string {
- return []string{
- ObjectOwnershipBucketOwnerPreferred,
- ObjectOwnershipObjectWriter,
- ObjectOwnershipBucketOwnerEnforced,
- }
- }
- const (
- // ObjectStorageClassStandard is a ObjectStorageClass enum value
- ObjectStorageClassStandard = "STANDARD"
- // ObjectStorageClassReducedRedundancy is a ObjectStorageClass enum value
- ObjectStorageClassReducedRedundancy = "REDUCED_REDUNDANCY"
- // ObjectStorageClassGlacier is a ObjectStorageClass enum value
- ObjectStorageClassGlacier = "GLACIER"
- // ObjectStorageClassStandardIa is a ObjectStorageClass enum value
- ObjectStorageClassStandardIa = "STANDARD_IA"
- // ObjectStorageClassOnezoneIa is a ObjectStorageClass enum value
- ObjectStorageClassOnezoneIa = "ONEZONE_IA"
- // ObjectStorageClassIntelligentTiering is a ObjectStorageClass enum value
- ObjectStorageClassIntelligentTiering = "INTELLIGENT_TIERING"
- // ObjectStorageClassDeepArchive is a ObjectStorageClass enum value
- ObjectStorageClassDeepArchive = "DEEP_ARCHIVE"
- // ObjectStorageClassOutposts is a ObjectStorageClass enum value
- ObjectStorageClassOutposts = "OUTPOSTS"
- // ObjectStorageClassGlacierIr is a ObjectStorageClass enum value
- ObjectStorageClassGlacierIr = "GLACIER_IR"
- )
- // ObjectStorageClass_Values returns all elements of the ObjectStorageClass enum
- func ObjectStorageClass_Values() []string {
- return []string{
- ObjectStorageClassStandard,
- ObjectStorageClassReducedRedundancy,
- ObjectStorageClassGlacier,
- ObjectStorageClassStandardIa,
- ObjectStorageClassOnezoneIa,
- ObjectStorageClassIntelligentTiering,
- ObjectStorageClassDeepArchive,
- ObjectStorageClassOutposts,
- ObjectStorageClassGlacierIr,
- }
- }
- const (
- // ObjectVersionStorageClassStandard is a ObjectVersionStorageClass enum value
- ObjectVersionStorageClassStandard = "STANDARD"
- )
- // ObjectVersionStorageClass_Values returns all elements of the ObjectVersionStorageClass enum
- func ObjectVersionStorageClass_Values() []string {
- return []string{
- ObjectVersionStorageClassStandard,
- }
- }
- const (
- // OwnerOverrideDestination is a OwnerOverride enum value
- OwnerOverrideDestination = "Destination"
- )
- // OwnerOverride_Values returns all elements of the OwnerOverride enum
- func OwnerOverride_Values() []string {
- return []string{
- OwnerOverrideDestination,
- }
- }
- const (
- // PayerRequester is a Payer enum value
- PayerRequester = "Requester"
- // PayerBucketOwner is a Payer enum value
- PayerBucketOwner = "BucketOwner"
- )
- // Payer_Values returns all elements of the Payer enum
- func Payer_Values() []string {
- return []string{
- PayerRequester,
- PayerBucketOwner,
- }
- }
- const (
- // PermissionFullControl is a Permission enum value
- PermissionFullControl = "FULL_CONTROL"
- // PermissionWrite is a Permission enum value
- PermissionWrite = "WRITE"
- // PermissionWriteAcp is a Permission enum value
- PermissionWriteAcp = "WRITE_ACP"
- // PermissionRead is a Permission enum value
- PermissionRead = "READ"
- // PermissionReadAcp is a Permission enum value
- PermissionReadAcp = "READ_ACP"
- )
- // Permission_Values returns all elements of the Permission enum
- func Permission_Values() []string {
- return []string{
- PermissionFullControl,
- PermissionWrite,
- PermissionWriteAcp,
- PermissionRead,
- PermissionReadAcp,
- }
- }
- const (
- // ProtocolHttp is a Protocol enum value
- ProtocolHttp = "http"
- // ProtocolHttps is a Protocol enum value
- ProtocolHttps = "https"
- )
- // Protocol_Values returns all elements of the Protocol enum
- func Protocol_Values() []string {
- return []string{
- ProtocolHttp,
- ProtocolHttps,
- }
- }
- const (
- // QuoteFieldsAlways is a QuoteFields enum value
- QuoteFieldsAlways = "ALWAYS"
- // QuoteFieldsAsneeded is a QuoteFields enum value
- QuoteFieldsAsneeded = "ASNEEDED"
- )
- // QuoteFields_Values returns all elements of the QuoteFields enum
- func QuoteFields_Values() []string {
- return []string{
- QuoteFieldsAlways,
- QuoteFieldsAsneeded,
- }
- }
- const (
- // ReplicaModificationsStatusEnabled is a ReplicaModificationsStatus enum value
- ReplicaModificationsStatusEnabled = "Enabled"
- // ReplicaModificationsStatusDisabled is a ReplicaModificationsStatus enum value
- ReplicaModificationsStatusDisabled = "Disabled"
- )
- // ReplicaModificationsStatus_Values returns all elements of the ReplicaModificationsStatus enum
- func ReplicaModificationsStatus_Values() []string {
- return []string{
- ReplicaModificationsStatusEnabled,
- ReplicaModificationsStatusDisabled,
- }
- }
- const (
- // ReplicationRuleStatusEnabled is a ReplicationRuleStatus enum value
- ReplicationRuleStatusEnabled = "Enabled"
- // ReplicationRuleStatusDisabled is a ReplicationRuleStatus enum value
- ReplicationRuleStatusDisabled = "Disabled"
- )
- // ReplicationRuleStatus_Values returns all elements of the ReplicationRuleStatus enum
- func ReplicationRuleStatus_Values() []string {
- return []string{
- ReplicationRuleStatusEnabled,
- ReplicationRuleStatusDisabled,
- }
- }
- const (
- // ReplicationStatusComplete is a ReplicationStatus enum value
- ReplicationStatusComplete = "COMPLETE"
- // ReplicationStatusPending is a ReplicationStatus enum value
- ReplicationStatusPending = "PENDING"
- // ReplicationStatusFailed is a ReplicationStatus enum value
- ReplicationStatusFailed = "FAILED"
- // ReplicationStatusReplica is a ReplicationStatus enum value
- ReplicationStatusReplica = "REPLICA"
- )
- // ReplicationStatus_Values returns all elements of the ReplicationStatus enum
- func ReplicationStatus_Values() []string {
- return []string{
- ReplicationStatusComplete,
- ReplicationStatusPending,
- ReplicationStatusFailed,
- ReplicationStatusReplica,
- }
- }
- const (
- // ReplicationTimeStatusEnabled is a ReplicationTimeStatus enum value
- ReplicationTimeStatusEnabled = "Enabled"
- // ReplicationTimeStatusDisabled is a ReplicationTimeStatus enum value
- ReplicationTimeStatusDisabled = "Disabled"
- )
- // ReplicationTimeStatus_Values returns all elements of the ReplicationTimeStatus enum
- func ReplicationTimeStatus_Values() []string {
- return []string{
- ReplicationTimeStatusEnabled,
- ReplicationTimeStatusDisabled,
- }
- }
- // If present, indicates that the requester was successfully charged for the
- // request.
- const (
- // RequestChargedRequester is a RequestCharged enum value
- RequestChargedRequester = "requester"
- )
- // RequestCharged_Values returns all elements of the RequestCharged enum
- func RequestCharged_Values() []string {
- return []string{
- RequestChargedRequester,
- }
- }
- // Confirms that the requester knows that they will be charged for the request.
- // Bucket owners need not specify this parameter in their requests. For information
- // about downloading objects from Requester Pays buckets, see Downloading Objects
- // in Requester Pays Buckets (https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html)
- // in the Amazon S3 User Guide.
- const (
- // RequestPayerRequester is a RequestPayer enum value
- RequestPayerRequester = "requester"
- )
- // RequestPayer_Values returns all elements of the RequestPayer enum
- func RequestPayer_Values() []string {
- return []string{
- RequestPayerRequester,
- }
- }
- const (
- // RestoreRequestTypeSelect is a RestoreRequestType enum value
- RestoreRequestTypeSelect = "SELECT"
- )
- // RestoreRequestType_Values returns all elements of the RestoreRequestType enum
- func RestoreRequestType_Values() []string {
- return []string{
- RestoreRequestTypeSelect,
- }
- }
- const (
- // ServerSideEncryptionAes256 is a ServerSideEncryption enum value
- ServerSideEncryptionAes256 = "AES256"
- // ServerSideEncryptionAwsKms is a ServerSideEncryption enum value
- ServerSideEncryptionAwsKms = "aws:kms"
- )
- // ServerSideEncryption_Values returns all elements of the ServerSideEncryption enum
- func ServerSideEncryption_Values() []string {
- return []string{
- ServerSideEncryptionAes256,
- ServerSideEncryptionAwsKms,
- }
- }
- const (
- // SseKmsEncryptedObjectsStatusEnabled is a SseKmsEncryptedObjectsStatus enum value
- SseKmsEncryptedObjectsStatusEnabled = "Enabled"
- // SseKmsEncryptedObjectsStatusDisabled is a SseKmsEncryptedObjectsStatus enum value
- SseKmsEncryptedObjectsStatusDisabled = "Disabled"
- )
- // SseKmsEncryptedObjectsStatus_Values returns all elements of the SseKmsEncryptedObjectsStatus enum
- func SseKmsEncryptedObjectsStatus_Values() []string {
- return []string{
- SseKmsEncryptedObjectsStatusEnabled,
- SseKmsEncryptedObjectsStatusDisabled,
- }
- }
- const (
- // StorageClassStandard is a StorageClass enum value
- StorageClassStandard = "STANDARD"
- // StorageClassReducedRedundancy is a StorageClass enum value
- StorageClassReducedRedundancy = "REDUCED_REDUNDANCY"
- // StorageClassStandardIa is a StorageClass enum value
- StorageClassStandardIa = "STANDARD_IA"
- // StorageClassOnezoneIa is a StorageClass enum value
- StorageClassOnezoneIa = "ONEZONE_IA"
- // StorageClassIntelligentTiering is a StorageClass enum value
- StorageClassIntelligentTiering = "INTELLIGENT_TIERING"
- // StorageClassGlacier is a StorageClass enum value
- StorageClassGlacier = "GLACIER"
- // StorageClassDeepArchive is a StorageClass enum value
- StorageClassDeepArchive = "DEEP_ARCHIVE"
- // StorageClassOutposts is a StorageClass enum value
- StorageClassOutposts = "OUTPOSTS"
- // StorageClassGlacierIr is a StorageClass enum value
- StorageClassGlacierIr = "GLACIER_IR"
- )
- // StorageClass_Values returns all elements of the StorageClass enum
- func StorageClass_Values() []string {
- return []string{
- StorageClassStandard,
- StorageClassReducedRedundancy,
- StorageClassStandardIa,
- StorageClassOnezoneIa,
- StorageClassIntelligentTiering,
- StorageClassGlacier,
- StorageClassDeepArchive,
- StorageClassOutposts,
- StorageClassGlacierIr,
- }
- }
- const (
- // StorageClassAnalysisSchemaVersionV1 is a StorageClassAnalysisSchemaVersion enum value
- StorageClassAnalysisSchemaVersionV1 = "V_1"
- )
- // StorageClassAnalysisSchemaVersion_Values returns all elements of the StorageClassAnalysisSchemaVersion enum
- func StorageClassAnalysisSchemaVersion_Values() []string {
- return []string{
- StorageClassAnalysisSchemaVersionV1,
- }
- }
- const (
- // TaggingDirectiveCopy is a TaggingDirective enum value
- TaggingDirectiveCopy = "COPY"
- // TaggingDirectiveReplace is a TaggingDirective enum value
- TaggingDirectiveReplace = "REPLACE"
- )
- // TaggingDirective_Values returns all elements of the TaggingDirective enum
- func TaggingDirective_Values() []string {
- return []string{
- TaggingDirectiveCopy,
- TaggingDirectiveReplace,
- }
- }
- const (
- // TierStandard is a Tier enum value
- TierStandard = "Standard"
- // TierBulk is a Tier enum value
- TierBulk = "Bulk"
- // TierExpedited is a Tier enum value
- TierExpedited = "Expedited"
- )
- // Tier_Values returns all elements of the Tier enum
- func Tier_Values() []string {
- return []string{
- TierStandard,
- TierBulk,
- TierExpedited,
- }
- }
- const (
- // TransitionStorageClassGlacier is a TransitionStorageClass enum value
- TransitionStorageClassGlacier = "GLACIER"
- // TransitionStorageClassStandardIa is a TransitionStorageClass enum value
- TransitionStorageClassStandardIa = "STANDARD_IA"
- // TransitionStorageClassOnezoneIa is a TransitionStorageClass enum value
- TransitionStorageClassOnezoneIa = "ONEZONE_IA"
- // TransitionStorageClassIntelligentTiering is a TransitionStorageClass enum value
- TransitionStorageClassIntelligentTiering = "INTELLIGENT_TIERING"
- // TransitionStorageClassDeepArchive is a TransitionStorageClass enum value
- TransitionStorageClassDeepArchive = "DEEP_ARCHIVE"
- // TransitionStorageClassGlacierIr is a TransitionStorageClass enum value
- TransitionStorageClassGlacierIr = "GLACIER_IR"
- )
- // TransitionStorageClass_Values returns all elements of the TransitionStorageClass enum
- func TransitionStorageClass_Values() []string {
- return []string{
- TransitionStorageClassGlacier,
- TransitionStorageClassStandardIa,
- TransitionStorageClassOnezoneIa,
- TransitionStorageClassIntelligentTiering,
- TransitionStorageClassDeepArchive,
- TransitionStorageClassGlacierIr,
- }
- }
- const (
- // TypeCanonicalUser is a Type enum value
- TypeCanonicalUser = "CanonicalUser"
- // TypeAmazonCustomerByEmail is a Type enum value
- TypeAmazonCustomerByEmail = "AmazonCustomerByEmail"
- // TypeGroup is a Type enum value
- TypeGroup = "Group"
- )
- // Type_Values returns all elements of the Type enum
- func Type_Values() []string {
- return []string{
- TypeCanonicalUser,
- TypeAmazonCustomerByEmail,
- TypeGroup,
- }
- }
|