123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154215521562157215821592160216121622163216421652166216721682169217021712172217321742175217621772178217921802181218221832184218521862187218821892190219121922193219421952196219721982199220022012202220322042205220622072208220922102211221222132214221522162217221822192220222122222223222422252226222722282229223022312232223322342235223622372238223922402241224222432244224522462247224822492250225122522253225422552256225722582259226022612262226322642265226622672268226922702271227222732274227522762277227822792280228122822283228422852286228722882289229022912292229322942295229622972298229923002301230223032304230523062307230823092310231123122313231423152316231723182319232023212322232323242325232623272328232923302331233223332334233523362337233823392340234123422343234423452346234723482349235023512352235323542355235623572358235923602361236223632364236523662367236823692370237123722373237423752376237723782379238023812382238323842385238623872388238923902391239223932394239523962397239823992400240124022403240424052406240724082409241024112412241324142415241624172418241924202421242224232424242524262427242824292430243124322433243424352436243724382439244024412442244324442445244624472448244924502451245224532454245524562457245824592460246124622463246424652466246724682469247024712472247324742475247624772478247924802481248224832484248524862487248824892490249124922493249424952496249724982499250025012502250325042505250625072508250925102511251225132514251525162517251825192520252125222523252425252526252725282529253025312532253325342535253625372538253925402541254225432544254525462547254825492550255125522553255425552556255725582559256025612562256325642565256625672568256925702571257225732574257525762577257825792580258125822583258425852586258725882589259025912592259325942595259625972598259926002601260226032604260526062607260826092610261126122613261426152616261726182619262026212622262326242625262626272628262926302631263226332634263526362637263826392640264126422643264426452646264726482649265026512652265326542655265626572658265926602661266226632664266526662667266826692670267126722673267426752676267726782679268026812682268326842685268626872688268926902691269226932694269526962697269826992700270127022703270427052706270727082709271027112712271327142715271627172718271927202721272227232724272527262727272827292730273127322733273427352736273727382739274027412742274327442745274627472748274927502751275227532754275527562757275827592760276127622763276427652766276727682769277027712772277327742775277627772778277927802781278227832784278527862787278827892790279127922793279427952796279727982799280028012802280328042805280628072808280928102811281228132814281528162817281828192820282128222823282428252826282728282829283028312832283328342835283628372838283928402841284228432844284528462847284828492850285128522853285428552856285728582859286028612862286328642865286628672868286928702871287228732874287528762877287828792880288128822883288428852886288728882889289028912892289328942895289628972898289929002901290229032904290529062907290829092910291129122913291429152916291729182919292029212922292329242925292629272928292929302931293229332934293529362937293829392940294129422943294429452946294729482949295029512952295329542955295629572958295929602961296229632964296529662967296829692970297129722973297429752976297729782979298029812982298329842985298629872988298929902991299229932994299529962997299829993000300130023003300430053006300730083009301030113012301330143015301630173018301930203021302230233024302530263027302830293030303130323033303430353036303730383039304030413042304330443045304630473048304930503051305230533054 |
- // THIS FILE IS AUTOMATICALLY GENERATED. DO NOT EDIT.
- // Package sqs provides a client for Amazon Simple Queue Service.
- package sqs
- import (
- "fmt"
- "github.com/aws/aws-sdk-go/aws/awsutil"
- "github.com/aws/aws-sdk-go/aws/request"
- "github.com/aws/aws-sdk-go/private/protocol"
- "github.com/aws/aws-sdk-go/private/protocol/query"
- )
- const opAddPermission = "AddPermission"
- // AddPermissionRequest generates a "aws/request.Request" representing the
- // client's request for the AddPermission operation. The "output" return
- // value can be used to capture response data after the request's "Send" method
- // is called.
- //
- // See AddPermission for usage and error information.
- //
- // Creating a request object using this method should be used when you want to inject
- // custom logic into the request's lifecycle using a custom handler, or if you want to
- // access properties on the request object before or after sending the request. If
- // you just want the service response, call the AddPermission method directly
- // instead.
- //
- // Note: You must call the "Send" method on the returned request object in order
- // to execute the request.
- //
- // // Example sending a request using the AddPermissionRequest method.
- // req, resp := client.AddPermissionRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- func (c *SQS) AddPermissionRequest(input *AddPermissionInput) (req *request.Request, output *AddPermissionOutput) {
- op := &request.Operation{
- Name: opAddPermission,
- HTTPMethod: "POST",
- HTTPPath: "/",
- }
- if input == nil {
- input = &AddPermissionInput{}
- }
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Remove(query.UnmarshalHandler)
- req.Handlers.Unmarshal.PushBackNamed(protocol.UnmarshalDiscardBodyHandler)
- output = &AddPermissionOutput{}
- req.Data = output
- return
- }
- // AddPermission API operation for Amazon Simple Queue Service.
- //
- // Adds a permission to a queue for a specific principal (http://docs.aws.amazon.com/general/latest/gr/glos-chap.html#P).
- // This allows for sharing access to the queue.
- //
- // When you create a queue, you have full control access rights for the queue.
- // Only you (as owner of the queue) can grant or deny permissions to the queue.
- // For more information about these permissions, see Shared Queues (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/acp-overview.html)
- // in the Amazon SQS Developer Guide.
- //
- // AddPermission writes an Amazon SQS-generated policy. If you want to write
- // your own policy, use SetQueueAttributes to upload your policy. For more information
- // about writing your own policy, see Using The Access Policy Language (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/AccessPolicyLanguage.html)
- // in the Amazon SQS Developer Guide.
- //
- // Some API actions take lists of parameters. These lists are specified using
- // the param.n notation. Values of n are integers starting from 1. For example,
- // a parameter list with two elements looks like this:
- //
- // 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 Queue Service's
- // API operation AddPermission for usage and error information.
- //
- // Returned Error Codes:
- // * OverLimit
- // The action that you requested would violate a limit. For example, ReceiveMessage
- // returns this error if the maximum number of messages inflight has already
- // been reached. AddPermission returns this error if the maximum number of permissions
- // for the queue has already been reached.
- //
- func (c *SQS) AddPermission(input *AddPermissionInput) (*AddPermissionOutput, error) {
- req, out := c.AddPermissionRequest(input)
- err := req.Send()
- return out, err
- }
- const opChangeMessageVisibility = "ChangeMessageVisibility"
- // ChangeMessageVisibilityRequest generates a "aws/request.Request" representing the
- // client's request for the ChangeMessageVisibility operation. The "output" return
- // value can be used to capture response data after the request's "Send" method
- // is called.
- //
- // See ChangeMessageVisibility for usage and error information.
- //
- // Creating a request object using this method should be used when you want to inject
- // custom logic into the request's lifecycle using a custom handler, or if you want to
- // access properties on the request object before or after sending the request. If
- // you just want the service response, call the ChangeMessageVisibility method directly
- // instead.
- //
- // Note: You must call the "Send" method on the returned request object in order
- // to execute the request.
- //
- // // Example sending a request using the ChangeMessageVisibilityRequest method.
- // req, resp := client.ChangeMessageVisibilityRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- func (c *SQS) ChangeMessageVisibilityRequest(input *ChangeMessageVisibilityInput) (req *request.Request, output *ChangeMessageVisibilityOutput) {
- op := &request.Operation{
- Name: opChangeMessageVisibility,
- HTTPMethod: "POST",
- HTTPPath: "/",
- }
- if input == nil {
- input = &ChangeMessageVisibilityInput{}
- }
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Remove(query.UnmarshalHandler)
- req.Handlers.Unmarshal.PushBackNamed(protocol.UnmarshalDiscardBodyHandler)
- output = &ChangeMessageVisibilityOutput{}
- req.Data = output
- return
- }
- // ChangeMessageVisibility API operation for Amazon Simple Queue Service.
- //
- // Changes the visibility timeout of a specified message in a queue to a new
- // value. The maximum allowed timeout value you can set the value to is 12 hours.
- // This means you can't extend the timeout of a message in an existing queue
- // to more than a total visibility timeout of 12 hours. (For more information
- // visibility timeout, see Visibility Timeout (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/AboutVT.html)
- // in the Amazon SQS Developer Guide.)
- //
- // For example, let's say you have a message and its default message visibility
- // timeout is 5 minutes. After 3 minutes, you call ChangeMessageVisiblity with
- // a timeout of 10 minutes. At that time, the timeout for the message would
- // be extended by 10 minutes beyond the time of the ChangeMessageVisibility
- // call. This results in a total visibility timeout of 13 minutes. You can continue
- // to call ChangeMessageVisibility to extend the visibility timeout to a maximum
- // of 12 hours. If you try to extend beyond 12 hours, the request will be rejected.
- //
- // There is a 120,000 limit for the number of inflight messages per queue. Messages
- // are inflight after they have been received from the queue by a consuming
- // component, but have not yet been deleted from the queue. If you reach the
- // 120,000 limit, you will receive an OverLimit error message from Amazon SQS.
- // To help avoid reaching the limit, you should delete the messages from the
- // queue after they have been processed. You can also increase the number of
- // queues you use to process the messages.
- //
- // If you attempt to set the VisibilityTimeout to an amount more than the maximum
- // time left, Amazon SQS returns an error. It will not automatically recalculate
- // and increase the timeout to the maximum time remaining.
- //
- // Unlike with a queue, when you change the visibility timeout for a specific
- // message, that timeout value is applied immediately but is not saved in memory
- // for that message. If you don't delete a message after it is received, the
- // visibility timeout for the message the next time it is received reverts to
- // the original timeout value, not the value you set with the ChangeMessageVisibility
- // action.
- //
- // 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 Queue Service's
- // API operation ChangeMessageVisibility for usage and error information.
- //
- // Returned Error Codes:
- // * AWS.SimpleQueueService.MessageNotInflight
- // The message referred to is not in flight.
- //
- // * ReceiptHandleIsInvalid
- // The receipt handle provided is not valid.
- //
- func (c *SQS) ChangeMessageVisibility(input *ChangeMessageVisibilityInput) (*ChangeMessageVisibilityOutput, error) {
- req, out := c.ChangeMessageVisibilityRequest(input)
- err := req.Send()
- return out, err
- }
- const opChangeMessageVisibilityBatch = "ChangeMessageVisibilityBatch"
- // ChangeMessageVisibilityBatchRequest generates a "aws/request.Request" representing the
- // client's request for the ChangeMessageVisibilityBatch operation. The "output" return
- // value can be used to capture response data after the request's "Send" method
- // is called.
- //
- // See ChangeMessageVisibilityBatch for usage and error information.
- //
- // Creating a request object using this method should be used when you want to inject
- // custom logic into the request's lifecycle using a custom handler, or if you want to
- // access properties on the request object before or after sending the request. If
- // you just want the service response, call the ChangeMessageVisibilityBatch method directly
- // instead.
- //
- // Note: You must call the "Send" method on the returned request object in order
- // to execute the request.
- //
- // // Example sending a request using the ChangeMessageVisibilityBatchRequest method.
- // req, resp := client.ChangeMessageVisibilityBatchRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- func (c *SQS) ChangeMessageVisibilityBatchRequest(input *ChangeMessageVisibilityBatchInput) (req *request.Request, output *ChangeMessageVisibilityBatchOutput) {
- op := &request.Operation{
- Name: opChangeMessageVisibilityBatch,
- HTTPMethod: "POST",
- HTTPPath: "/",
- }
- if input == nil {
- input = &ChangeMessageVisibilityBatchInput{}
- }
- req = c.newRequest(op, input, output)
- output = &ChangeMessageVisibilityBatchOutput{}
- req.Data = output
- return
- }
- // ChangeMessageVisibilityBatch API operation for Amazon Simple Queue Service.
- //
- // Changes the visibility timeout of multiple messages. This is a batch version
- // of ChangeMessageVisibility. The result of the action on each message is reported
- // individually in the response. You can send up to 10 ChangeMessageVisibility
- // requests with each ChangeMessageVisibilityBatch action.
- //
- // Because the batch request can result in a combination of successful and unsuccessful
- // actions, you should check for batch errors even when the call returns an
- // HTTP status code of 200.
- //
- // Some API actions take lists of parameters. These lists are specified using
- // the param.n notation. Values of n are integers starting from 1. For example,
- // a parameter list with two elements looks like this:
- //
- // 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 Queue Service's
- // API operation ChangeMessageVisibilityBatch for usage and error information.
- //
- // Returned Error Codes:
- // * AWS.SimpleQueueService.TooManyEntriesInBatchRequest
- // Batch request contains more number of entries than permissible.
- //
- // * AWS.SimpleQueueService.EmptyBatchRequest
- // Batch request does not contain an entry.
- //
- // * AWS.SimpleQueueService.BatchEntryIdsNotDistinct
- // Two or more batch entries have the same Id in the request.
- //
- // * AWS.SimpleQueueService.InvalidBatchEntryId
- // The Id of a batch entry in a batch request does not abide by the specification.
- //
- func (c *SQS) ChangeMessageVisibilityBatch(input *ChangeMessageVisibilityBatchInput) (*ChangeMessageVisibilityBatchOutput, error) {
- req, out := c.ChangeMessageVisibilityBatchRequest(input)
- err := req.Send()
- return out, err
- }
- const opCreateQueue = "CreateQueue"
- // CreateQueueRequest generates a "aws/request.Request" representing the
- // client's request for the CreateQueue operation. The "output" return
- // value can be used to capture response data after the request's "Send" method
- // is called.
- //
- // See CreateQueue for usage and error information.
- //
- // Creating a request object using this method should be used when you want to inject
- // custom logic into the request's lifecycle using a custom handler, or if you want to
- // access properties on the request object before or after sending the request. If
- // you just want the service response, call the CreateQueue method directly
- // instead.
- //
- // Note: You must call the "Send" method on the returned request object in order
- // to execute the request.
- //
- // // Example sending a request using the CreateQueueRequest method.
- // req, resp := client.CreateQueueRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- func (c *SQS) CreateQueueRequest(input *CreateQueueInput) (req *request.Request, output *CreateQueueOutput) {
- op := &request.Operation{
- Name: opCreateQueue,
- HTTPMethod: "POST",
- HTTPPath: "/",
- }
- if input == nil {
- input = &CreateQueueInput{}
- }
- req = c.newRequest(op, input, output)
- output = &CreateQueueOutput{}
- req.Data = output
- return
- }
- // CreateQueue API operation for Amazon Simple Queue Service.
- //
- // Creates a new queue, or returns the URL of an existing one. When you request
- // CreateQueue, you provide a name for the queue. To successfully create a new
- // queue, you must provide a name that is unique within the scope of your own
- // queues.
- //
- // If you delete a queue, you must wait at least 60 seconds before creating
- // a queue with the same name.
- //
- // You may pass one or more attributes in the request. If you do not provide
- // a value for any attribute, the queue will have the default value for that
- // attribute.
- //
- // Use GetQueueUrl to get a queue's URL. GetQueueUrl requires only the QueueName
- // parameter.
- //
- // If you provide the name of an existing queue, along with the exact names
- // and values of all the queue's attributes, CreateQueue returns the queue URL
- // for the existing queue. If the queue name, attribute names, or attribute
- // values do not match an existing queue, CreateQueue returns an error.
- //
- // Some API actions take lists of parameters. These lists are specified using
- // the param.n notation. Values of n are integers starting from 1. For example,
- // a parameter list with two elements looks like this:
- //
- // 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 Queue Service's
- // API operation CreateQueue for usage and error information.
- //
- // Returned Error Codes:
- // * AWS.SimpleQueueService.QueueDeletedRecently
- // You must wait 60 seconds after deleting a queue before you can create another
- // with the same name.
- //
- // * QueueAlreadyExists
- // A queue already exists with this name. Amazon SQS returns this error only
- // if the request includes attributes whose values differ from those of the
- // existing queue.
- //
- func (c *SQS) CreateQueue(input *CreateQueueInput) (*CreateQueueOutput, error) {
- req, out := c.CreateQueueRequest(input)
- err := req.Send()
- return out, err
- }
- const opDeleteMessage = "DeleteMessage"
- // DeleteMessageRequest generates a "aws/request.Request" representing the
- // client's request for the DeleteMessage operation. The "output" return
- // value can be used to capture response data after the request's "Send" method
- // is called.
- //
- // See DeleteMessage for usage and error information.
- //
- // Creating a request object using this method should be used when you want to inject
- // custom logic into the request's lifecycle using a custom handler, or if you want to
- // access properties on the request object before or after sending the request. If
- // you just want the service response, call the DeleteMessage method directly
- // instead.
- //
- // Note: You must call the "Send" method on the returned request object in order
- // to execute the request.
- //
- // // Example sending a request using the DeleteMessageRequest method.
- // req, resp := client.DeleteMessageRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- func (c *SQS) DeleteMessageRequest(input *DeleteMessageInput) (req *request.Request, output *DeleteMessageOutput) {
- op := &request.Operation{
- Name: opDeleteMessage,
- HTTPMethod: "POST",
- HTTPPath: "/",
- }
- if input == nil {
- input = &DeleteMessageInput{}
- }
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Remove(query.UnmarshalHandler)
- req.Handlers.Unmarshal.PushBackNamed(protocol.UnmarshalDiscardBodyHandler)
- output = &DeleteMessageOutput{}
- req.Data = output
- return
- }
- // DeleteMessage API operation for Amazon Simple Queue Service.
- //
- // Deletes the specified message from the specified queue. You specify the message
- // by using the message's receipt handle and not the message ID you received
- // when you sent the message. Even if the message is locked by another reader
- // due to the visibility timeout setting, it is still deleted from the queue.
- // If you leave a message in the queue for longer than the queue's configured
- // retention period, Amazon SQS automatically deletes it.
- //
- // The receipt handle is associated with a specific instance of receiving the
- // message. If you receive a message more than once, the receipt handle you
- // get each time you receive the message is different. When you request DeleteMessage,
- // if you don't provide the most recently received receipt handle for the message,
- // the request will still succeed, but the message might not be deleted.
- //
- // It is possible you will receive a message even after you have deleted it.
- // This might happen on rare occasions if one of the servers storing a copy
- // of the message is unavailable when you request to delete the message. The
- // copy remains on the server and might be returned to you again on a subsequent
- // receive request. You should create your system to be idempotent so that receiving
- // a particular message more than once is not a problem.
- //
- // 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 Queue Service's
- // API operation DeleteMessage for usage and error information.
- //
- // Returned Error Codes:
- // * InvalidIdFormat
- // The receipt handle is not valid for the current version.
- //
- // * ReceiptHandleIsInvalid
- // The receipt handle provided is not valid.
- //
- func (c *SQS) DeleteMessage(input *DeleteMessageInput) (*DeleteMessageOutput, error) {
- req, out := c.DeleteMessageRequest(input)
- err := req.Send()
- return out, err
- }
- const opDeleteMessageBatch = "DeleteMessageBatch"
- // DeleteMessageBatchRequest generates a "aws/request.Request" representing the
- // client's request for the DeleteMessageBatch operation. The "output" return
- // value can be used to capture response data after the request's "Send" method
- // is called.
- //
- // See DeleteMessageBatch for usage and error information.
- //
- // Creating a request object using this method should be used when you want to inject
- // custom logic into the request's lifecycle using a custom handler, or if you want to
- // access properties on the request object before or after sending the request. If
- // you just want the service response, call the DeleteMessageBatch method directly
- // instead.
- //
- // Note: You must call the "Send" method on the returned request object in order
- // to execute the request.
- //
- // // Example sending a request using the DeleteMessageBatchRequest method.
- // req, resp := client.DeleteMessageBatchRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- func (c *SQS) DeleteMessageBatchRequest(input *DeleteMessageBatchInput) (req *request.Request, output *DeleteMessageBatchOutput) {
- op := &request.Operation{
- Name: opDeleteMessageBatch,
- HTTPMethod: "POST",
- HTTPPath: "/",
- }
- if input == nil {
- input = &DeleteMessageBatchInput{}
- }
- req = c.newRequest(op, input, output)
- output = &DeleteMessageBatchOutput{}
- req.Data = output
- return
- }
- // DeleteMessageBatch API operation for Amazon Simple Queue Service.
- //
- // Deletes up to ten messages from the specified queue. This is a batch version
- // of DeleteMessage. The result of the delete action on each message is reported
- // individually in the response.
- //
- // Because the batch request can result in a combination of successful and unsuccessful
- // actions, you should check for batch errors even when the call returns an
- // HTTP status code of 200.
- //
- // Some API actions take lists of parameters. These lists are specified using
- // the param.n notation. Values of n are integers starting from 1. For example,
- // a parameter list with two elements looks like this:
- //
- // 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 Queue Service's
- // API operation DeleteMessageBatch for usage and error information.
- //
- // Returned Error Codes:
- // * AWS.SimpleQueueService.TooManyEntriesInBatchRequest
- // Batch request contains more number of entries than permissible.
- //
- // * AWS.SimpleQueueService.EmptyBatchRequest
- // Batch request does not contain an entry.
- //
- // * AWS.SimpleQueueService.BatchEntryIdsNotDistinct
- // Two or more batch entries have the same Id in the request.
- //
- // * AWS.SimpleQueueService.InvalidBatchEntryId
- // The Id of a batch entry in a batch request does not abide by the specification.
- //
- func (c *SQS) DeleteMessageBatch(input *DeleteMessageBatchInput) (*DeleteMessageBatchOutput, error) {
- req, out := c.DeleteMessageBatchRequest(input)
- err := req.Send()
- return out, err
- }
- const opDeleteQueue = "DeleteQueue"
- // DeleteQueueRequest generates a "aws/request.Request" representing the
- // client's request for the DeleteQueue operation. The "output" return
- // value can be used to capture response data after the request's "Send" method
- // is called.
- //
- // See DeleteQueue for usage and error information.
- //
- // Creating a request object using this method should be used when you want to inject
- // custom logic into the request's lifecycle using a custom handler, or if you want to
- // access properties on the request object before or after sending the request. If
- // you just want the service response, call the DeleteQueue method directly
- // instead.
- //
- // Note: You must call the "Send" method on the returned request object in order
- // to execute the request.
- //
- // // Example sending a request using the DeleteQueueRequest method.
- // req, resp := client.DeleteQueueRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- func (c *SQS) DeleteQueueRequest(input *DeleteQueueInput) (req *request.Request, output *DeleteQueueOutput) {
- op := &request.Operation{
- Name: opDeleteQueue,
- HTTPMethod: "POST",
- HTTPPath: "/",
- }
- if input == nil {
- input = &DeleteQueueInput{}
- }
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Remove(query.UnmarshalHandler)
- req.Handlers.Unmarshal.PushBackNamed(protocol.UnmarshalDiscardBodyHandler)
- output = &DeleteQueueOutput{}
- req.Data = output
- return
- }
- // DeleteQueue API operation for Amazon Simple Queue Service.
- //
- // Deletes the queue specified by the queue URL, regardless of whether the queue
- // is empty. If the specified queue does not exist, Amazon SQS returns a successful
- // response.
- //
- // Use DeleteQueue with care; once you delete your queue, any messages in the
- // queue are no longer available.
- //
- // When you delete a queue, the deletion process takes up to 60 seconds. Requests
- // you send involving that queue during the 60 seconds might succeed. For example,
- // a SendMessage request might succeed, but after the 60 seconds, the queue
- // and that message you sent no longer exist. Also, when you delete a queue,
- // you must wait at least 60 seconds before creating a queue with the same name.
- //
- // We reserve the right to delete queues that have had no activity for more
- // than 30 days. For more information, see How Amazon SQS Queues Work (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/SQSConcepts.html)
- // in the Amazon SQS Developer 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 Queue Service's
- // API operation DeleteQueue for usage and error information.
- func (c *SQS) DeleteQueue(input *DeleteQueueInput) (*DeleteQueueOutput, error) {
- req, out := c.DeleteQueueRequest(input)
- err := req.Send()
- return out, err
- }
- const opGetQueueAttributes = "GetQueueAttributes"
- // GetQueueAttributesRequest generates a "aws/request.Request" representing the
- // client's request for the GetQueueAttributes operation. The "output" return
- // value can be used to capture response data after the request's "Send" method
- // is called.
- //
- // See GetQueueAttributes for usage and error information.
- //
- // Creating a request object using this method should be used when you want to inject
- // custom logic into the request's lifecycle using a custom handler, or if you want to
- // access properties on the request object before or after sending the request. If
- // you just want the service response, call the GetQueueAttributes method directly
- // instead.
- //
- // Note: You must call the "Send" method on the returned request object in order
- // to execute the request.
- //
- // // Example sending a request using the GetQueueAttributesRequest method.
- // req, resp := client.GetQueueAttributesRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- func (c *SQS) GetQueueAttributesRequest(input *GetQueueAttributesInput) (req *request.Request, output *GetQueueAttributesOutput) {
- op := &request.Operation{
- Name: opGetQueueAttributes,
- HTTPMethod: "POST",
- HTTPPath: "/",
- }
- if input == nil {
- input = &GetQueueAttributesInput{}
- }
- req = c.newRequest(op, input, output)
- output = &GetQueueAttributesOutput{}
- req.Data = output
- return
- }
- // GetQueueAttributes API operation for Amazon Simple Queue Service.
- //
- // Gets attributes for the specified queue.
- //
- // Some API actions take lists of parameters. These lists are specified using
- // the param.n notation. Values of n are integers starting from 1. For example,
- // a parameter list with two elements looks like this:
- //
- // 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 Queue Service's
- // API operation GetQueueAttributes for usage and error information.
- //
- // Returned Error Codes:
- // * InvalidAttributeName
- // The attribute referred to does not exist.
- //
- func (c *SQS) GetQueueAttributes(input *GetQueueAttributesInput) (*GetQueueAttributesOutput, error) {
- req, out := c.GetQueueAttributesRequest(input)
- err := req.Send()
- return out, err
- }
- const opGetQueueUrl = "GetQueueUrl"
- // GetQueueUrlRequest generates a "aws/request.Request" representing the
- // client's request for the GetQueueUrl operation. The "output" return
- // value can be used to capture response data after the request's "Send" method
- // is called.
- //
- // See GetQueueUrl for usage and error information.
- //
- // Creating a request object using this method should be used when you want to inject
- // custom logic into the request's lifecycle using a custom handler, or if you want to
- // access properties on the request object before or after sending the request. If
- // you just want the service response, call the GetQueueUrl method directly
- // instead.
- //
- // Note: You must call the "Send" method on the returned request object in order
- // to execute the request.
- //
- // // Example sending a request using the GetQueueUrlRequest method.
- // req, resp := client.GetQueueUrlRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- func (c *SQS) GetQueueUrlRequest(input *GetQueueUrlInput) (req *request.Request, output *GetQueueUrlOutput) {
- op := &request.Operation{
- Name: opGetQueueUrl,
- HTTPMethod: "POST",
- HTTPPath: "/",
- }
- if input == nil {
- input = &GetQueueUrlInput{}
- }
- req = c.newRequest(op, input, output)
- output = &GetQueueUrlOutput{}
- req.Data = output
- return
- }
- // GetQueueUrl API operation for Amazon Simple Queue Service.
- //
- // Returns the URL of an existing queue. This action provides a simple way to
- // retrieve the URL of an Amazon SQS queue.
- //
- // To access a queue that belongs to another AWS account, use the QueueOwnerAWSAccountId
- // parameter to specify the account ID of the queue's owner. The queue's owner
- // must grant you permission to access the queue. For more information about
- // shared queue access, see AddPermission or go to Shared Queues (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/acp-overview.html)
- // in the Amazon SQS Developer 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 Queue Service's
- // API operation GetQueueUrl for usage and error information.
- //
- // Returned Error Codes:
- // * AWS.SimpleQueueService.NonExistentQueue
- // The queue referred to does not exist.
- //
- func (c *SQS) GetQueueUrl(input *GetQueueUrlInput) (*GetQueueUrlOutput, error) {
- req, out := c.GetQueueUrlRequest(input)
- err := req.Send()
- return out, err
- }
- const opListDeadLetterSourceQueues = "ListDeadLetterSourceQueues"
- // ListDeadLetterSourceQueuesRequest generates a "aws/request.Request" representing the
- // client's request for the ListDeadLetterSourceQueues operation. The "output" return
- // value can be used to capture response data after the request's "Send" method
- // is called.
- //
- // See ListDeadLetterSourceQueues for usage and error information.
- //
- // Creating a request object using this method should be used when you want to inject
- // custom logic into the request's lifecycle using a custom handler, or if you want to
- // access properties on the request object before or after sending the request. If
- // you just want the service response, call the ListDeadLetterSourceQueues method directly
- // instead.
- //
- // Note: You must call the "Send" method on the returned request object in order
- // to execute the request.
- //
- // // Example sending a request using the ListDeadLetterSourceQueuesRequest method.
- // req, resp := client.ListDeadLetterSourceQueuesRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- func (c *SQS) ListDeadLetterSourceQueuesRequest(input *ListDeadLetterSourceQueuesInput) (req *request.Request, output *ListDeadLetterSourceQueuesOutput) {
- op := &request.Operation{
- Name: opListDeadLetterSourceQueues,
- HTTPMethod: "POST",
- HTTPPath: "/",
- }
- if input == nil {
- input = &ListDeadLetterSourceQueuesInput{}
- }
- req = c.newRequest(op, input, output)
- output = &ListDeadLetterSourceQueuesOutput{}
- req.Data = output
- return
- }
- // ListDeadLetterSourceQueues API operation for Amazon Simple Queue Service.
- //
- // Returns a list of your queues that have the RedrivePolicy queue attribute
- // configured with a dead letter queue.
- //
- // For more information about using dead letter queues, see Using Amazon SQS
- // Dead Letter Queues (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/SQSDeadLetterQueue.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 Queue Service's
- // API operation ListDeadLetterSourceQueues for usage and error information.
- //
- // Returned Error Codes:
- // * AWS.SimpleQueueService.NonExistentQueue
- // The queue referred to does not exist.
- //
- func (c *SQS) ListDeadLetterSourceQueues(input *ListDeadLetterSourceQueuesInput) (*ListDeadLetterSourceQueuesOutput, error) {
- req, out := c.ListDeadLetterSourceQueuesRequest(input)
- err := req.Send()
- return out, err
- }
- const opListQueues = "ListQueues"
- // ListQueuesRequest generates a "aws/request.Request" representing the
- // client's request for the ListQueues operation. The "output" return
- // value can be used to capture response data after the request's "Send" method
- // is called.
- //
- // See ListQueues for usage and error information.
- //
- // Creating a request object using this method should be used when you want to inject
- // custom logic into the request's lifecycle using a custom handler, or if you want to
- // access properties on the request object before or after sending the request. If
- // you just want the service response, call the ListQueues method directly
- // instead.
- //
- // Note: You must call the "Send" method on the returned request object in order
- // to execute the request.
- //
- // // Example sending a request using the ListQueuesRequest method.
- // req, resp := client.ListQueuesRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- func (c *SQS) ListQueuesRequest(input *ListQueuesInput) (req *request.Request, output *ListQueuesOutput) {
- op := &request.Operation{
- Name: opListQueues,
- HTTPMethod: "POST",
- HTTPPath: "/",
- }
- if input == nil {
- input = &ListQueuesInput{}
- }
- req = c.newRequest(op, input, output)
- output = &ListQueuesOutput{}
- req.Data = output
- return
- }
- // ListQueues API operation for Amazon Simple Queue Service.
- //
- // Returns a list of your queues. The maximum number of queues that can be returned
- // is 1000. If you specify a value for the optional QueueNamePrefix parameter,
- // only queues with a name beginning with the specified value are returned.
- //
- // 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 Queue Service's
- // API operation ListQueues for usage and error information.
- func (c *SQS) ListQueues(input *ListQueuesInput) (*ListQueuesOutput, error) {
- req, out := c.ListQueuesRequest(input)
- err := req.Send()
- return out, err
- }
- const opPurgeQueue = "PurgeQueue"
- // PurgeQueueRequest generates a "aws/request.Request" representing the
- // client's request for the PurgeQueue operation. The "output" return
- // value can be used to capture response data after the request's "Send" method
- // is called.
- //
- // See PurgeQueue for usage and error information.
- //
- // Creating a request object using this method should be used when you want to inject
- // custom logic into the request's lifecycle using a custom handler, or if you want to
- // access properties on the request object before or after sending the request. If
- // you just want the service response, call the PurgeQueue method directly
- // instead.
- //
- // Note: You must call the "Send" method on the returned request object in order
- // to execute the request.
- //
- // // Example sending a request using the PurgeQueueRequest method.
- // req, resp := client.PurgeQueueRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- func (c *SQS) PurgeQueueRequest(input *PurgeQueueInput) (req *request.Request, output *PurgeQueueOutput) {
- op := &request.Operation{
- Name: opPurgeQueue,
- HTTPMethod: "POST",
- HTTPPath: "/",
- }
- if input == nil {
- input = &PurgeQueueInput{}
- }
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Remove(query.UnmarshalHandler)
- req.Handlers.Unmarshal.PushBackNamed(protocol.UnmarshalDiscardBodyHandler)
- output = &PurgeQueueOutput{}
- req.Data = output
- return
- }
- // PurgeQueue API operation for Amazon Simple Queue Service.
- //
- // Deletes the messages in a queue specified by the queue URL.
- //
- // When you use the PurgeQueue API, the deleted messages in the queue cannot
- // be retrieved.
- //
- // When you purge a queue, the message deletion process takes up to 60 seconds.
- // All messages sent to the queue before calling PurgeQueue will be deleted;
- // messages sent to the queue while it is being purged may be deleted. While
- // the queue is being purged, messages sent to the queue before PurgeQueue was
- // called may be received, but will be deleted within the next minute.
- //
- // 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 Queue Service's
- // API operation PurgeQueue for usage and error information.
- //
- // Returned Error Codes:
- // * AWS.SimpleQueueService.NonExistentQueue
- // The queue referred to does not exist.
- //
- // * AWS.SimpleQueueService.PurgeQueueInProgress
- // Indicates that the specified queue previously received a PurgeQueue request
- // within the last 60 seconds, the time it can take to delete the messages in
- // the queue.
- //
- func (c *SQS) PurgeQueue(input *PurgeQueueInput) (*PurgeQueueOutput, error) {
- req, out := c.PurgeQueueRequest(input)
- err := req.Send()
- return out, err
- }
- const opReceiveMessage = "ReceiveMessage"
- // ReceiveMessageRequest generates a "aws/request.Request" representing the
- // client's request for the ReceiveMessage operation. The "output" return
- // value can be used to capture response data after the request's "Send" method
- // is called.
- //
- // See ReceiveMessage for usage and error information.
- //
- // Creating a request object using this method should be used when you want to inject
- // custom logic into the request's lifecycle using a custom handler, or if you want to
- // access properties on the request object before or after sending the request. If
- // you just want the service response, call the ReceiveMessage method directly
- // instead.
- //
- // Note: You must call the "Send" method on the returned request object in order
- // to execute the request.
- //
- // // Example sending a request using the ReceiveMessageRequest method.
- // req, resp := client.ReceiveMessageRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- func (c *SQS) ReceiveMessageRequest(input *ReceiveMessageInput) (req *request.Request, output *ReceiveMessageOutput) {
- op := &request.Operation{
- Name: opReceiveMessage,
- HTTPMethod: "POST",
- HTTPPath: "/",
- }
- if input == nil {
- input = &ReceiveMessageInput{}
- }
- req = c.newRequest(op, input, output)
- output = &ReceiveMessageOutput{}
- req.Data = output
- return
- }
- // ReceiveMessage API operation for Amazon Simple Queue Service.
- //
- // Retrieves one or more messages, with a maximum limit of 10 messages, from
- // the specified queue. Long poll support is enabled by using the WaitTimeSeconds
- // parameter. For more information, see Amazon SQS Long Poll (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-long-polling.html)
- // in the Amazon SQS Developer Guide.
- //
- // Short poll is the default behavior where a weighted random set of machines
- // is sampled on a ReceiveMessage call. This means only the messages on the
- // sampled machines are returned. If the number of messages in the queue is
- // small (less than 1000), it is likely you will get fewer messages than you
- // requested per ReceiveMessage call. If the number of messages in the queue
- // is extremely small, you might not receive any messages in a particular ReceiveMessage
- // response; in which case you should repeat the request.
- //
- // For each message returned, the response includes the following:
- //
- // * Message body
- //
- // * MD5 digest of the message body. For information about MD5, go to http://www.faqs.org/rfcs/rfc1321.html
- // (http://www.faqs.org/rfcs/rfc1321.html).
- //
- // * Message ID you received when you sent the message to the queue.
- //
- // * Receipt handle.
- //
- // * Message attributes.
- //
- // * MD5 digest of the message attributes.
- //
- // The receipt handle is the identifier you must provide when deleting the message.
- // For more information, see Queue and Message Identifiers (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/ImportantIdentifiers.html)
- // in the Amazon SQS Developer Guide.
- //
- // You can provide the VisibilityTimeout parameter in your request, which will
- // be applied to the messages that Amazon SQS returns in the response. If you
- // do not include the parameter, the overall visibility timeout for the queue
- // is used for the returned messages. For more information, see Visibility Timeout
- // (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/AboutVT.html)
- // in the Amazon SQS Developer Guide.
- //
- // Going forward, new attributes might be added. If you are writing code that
- // calls this action, we recommend that you structure your code so that it can
- // handle new attributes gracefully.
- //
- // 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 Queue Service's
- // API operation ReceiveMessage for usage and error information.
- //
- // Returned Error Codes:
- // * OverLimit
- // The action that you requested would violate a limit. For example, ReceiveMessage
- // returns this error if the maximum number of messages inflight has already
- // been reached. AddPermission returns this error if the maximum number of permissions
- // for the queue has already been reached.
- //
- func (c *SQS) ReceiveMessage(input *ReceiveMessageInput) (*ReceiveMessageOutput, error) {
- req, out := c.ReceiveMessageRequest(input)
- err := req.Send()
- return out, err
- }
- const opRemovePermission = "RemovePermission"
- // RemovePermissionRequest generates a "aws/request.Request" representing the
- // client's request for the RemovePermission operation. The "output" return
- // value can be used to capture response data after the request's "Send" method
- // is called.
- //
- // See RemovePermission for usage and error information.
- //
- // Creating a request object using this method should be used when you want to inject
- // custom logic into the request's lifecycle using a custom handler, or if you want to
- // access properties on the request object before or after sending the request. If
- // you just want the service response, call the RemovePermission method directly
- // instead.
- //
- // Note: You must call the "Send" method on the returned request object in order
- // to execute the request.
- //
- // // Example sending a request using the RemovePermissionRequest method.
- // req, resp := client.RemovePermissionRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- func (c *SQS) RemovePermissionRequest(input *RemovePermissionInput) (req *request.Request, output *RemovePermissionOutput) {
- op := &request.Operation{
- Name: opRemovePermission,
- HTTPMethod: "POST",
- HTTPPath: "/",
- }
- if input == nil {
- input = &RemovePermissionInput{}
- }
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Remove(query.UnmarshalHandler)
- req.Handlers.Unmarshal.PushBackNamed(protocol.UnmarshalDiscardBodyHandler)
- output = &RemovePermissionOutput{}
- req.Data = output
- return
- }
- // RemovePermission API operation for Amazon Simple Queue Service.
- //
- // Revokes any permissions in the queue policy that matches the specified Label
- // parameter. Only the owner of the queue can remove permissions.
- //
- // 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 Queue Service's
- // API operation RemovePermission for usage and error information.
- func (c *SQS) RemovePermission(input *RemovePermissionInput) (*RemovePermissionOutput, error) {
- req, out := c.RemovePermissionRequest(input)
- err := req.Send()
- return out, err
- }
- const opSendMessage = "SendMessage"
- // SendMessageRequest generates a "aws/request.Request" representing the
- // client's request for the SendMessage operation. The "output" return
- // value can be used to capture response data after the request's "Send" method
- // is called.
- //
- // See SendMessage for usage and error information.
- //
- // Creating a request object using this method should be used when you want to inject
- // custom logic into the request's lifecycle using a custom handler, or if you want to
- // access properties on the request object before or after sending the request. If
- // you just want the service response, call the SendMessage method directly
- // instead.
- //
- // Note: You must call the "Send" method on the returned request object in order
- // to execute the request.
- //
- // // Example sending a request using the SendMessageRequest method.
- // req, resp := client.SendMessageRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- func (c *SQS) SendMessageRequest(input *SendMessageInput) (req *request.Request, output *SendMessageOutput) {
- op := &request.Operation{
- Name: opSendMessage,
- HTTPMethod: "POST",
- HTTPPath: "/",
- }
- if input == nil {
- input = &SendMessageInput{}
- }
- req = c.newRequest(op, input, output)
- output = &SendMessageOutput{}
- req.Data = output
- return
- }
- // SendMessage API operation for Amazon Simple Queue Service.
- //
- // Delivers a message to the specified queue. With Amazon SQS, you now have
- // the ability to send large payload messages that are up to 256KB (262,144
- // bytes) in size. To send large payloads, you must use an AWS SDK that supports
- // SigV4 signing. To verify whether SigV4 is supported for an AWS SDK, check
- // the SDK release notes.
- //
- // The following list shows the characters (in Unicode) allowed in your message,
- // according to the W3C XML specification. For more information, go to http://www.w3.org/TR/REC-xml/#charsets
- // (http://www.w3.org/TR/REC-xml/#charsets) If you send any characters not included
- // in the list, your request will be rejected.
- //
- // #x9 | #xA | #xD | [#x20 to #xD7FF] | [#xE000 to #xFFFD] | [#x10000 to #x10FFFF]
- //
- // 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 Queue Service's
- // API operation SendMessage for usage and error information.
- //
- // Returned Error Codes:
- // * InvalidMessageContents
- // The message contains characters outside the allowed set.
- //
- // * AWS.SimpleQueueService.UnsupportedOperation
- // Error code 400. Unsupported operation.
- //
- func (c *SQS) SendMessage(input *SendMessageInput) (*SendMessageOutput, error) {
- req, out := c.SendMessageRequest(input)
- err := req.Send()
- return out, err
- }
- const opSendMessageBatch = "SendMessageBatch"
- // SendMessageBatchRequest generates a "aws/request.Request" representing the
- // client's request for the SendMessageBatch operation. The "output" return
- // value can be used to capture response data after the request's "Send" method
- // is called.
- //
- // See SendMessageBatch for usage and error information.
- //
- // Creating a request object using this method should be used when you want to inject
- // custom logic into the request's lifecycle using a custom handler, or if you want to
- // access properties on the request object before or after sending the request. If
- // you just want the service response, call the SendMessageBatch method directly
- // instead.
- //
- // Note: You must call the "Send" method on the returned request object in order
- // to execute the request.
- //
- // // Example sending a request using the SendMessageBatchRequest method.
- // req, resp := client.SendMessageBatchRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- func (c *SQS) SendMessageBatchRequest(input *SendMessageBatchInput) (req *request.Request, output *SendMessageBatchOutput) {
- op := &request.Operation{
- Name: opSendMessageBatch,
- HTTPMethod: "POST",
- HTTPPath: "/",
- }
- if input == nil {
- input = &SendMessageBatchInput{}
- }
- req = c.newRequest(op, input, output)
- output = &SendMessageBatchOutput{}
- req.Data = output
- return
- }
- // SendMessageBatch API operation for Amazon Simple Queue Service.
- //
- // Delivers up to ten messages to the specified queue. This is a batch version
- // of SendMessage. The result of the send action on each message is reported
- // individually in the response. The maximum allowed individual message size
- // is 256 KB (262,144 bytes).
- //
- // The maximum total payload size (i.e., the sum of all a batch's individual
- // message lengths) is also 256 KB (262,144 bytes).
- //
- // If the DelaySeconds parameter is not specified for an entry, the default
- // for the queue is used.
- //
- // The following list shows the characters (in Unicode) that are allowed in
- // your message, according to the W3C XML specification. For more information,
- // go to http://www.faqs.org/rfcs/rfc1321.html (http://www.faqs.org/rfcs/rfc1321.html).
- // If you send any characters that are not included in the list, your request
- // will be rejected.
- //
- // #x9 | #xA | #xD | [#x20 to #xD7FF] | [#xE000 to #xFFFD] | [#x10000 to #x10FFFF]
- //
- // Because the batch request can result in a combination of successful and unsuccessful
- // actions, you should check for batch errors even when the call returns an
- // HTTP status code of 200.
- //
- // Some API actions take lists of parameters. These lists are specified using
- // the param.n notation. Values of n are integers starting from 1. For example,
- // a parameter list with two elements looks like this:
- //
- // 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 Queue Service's
- // API operation SendMessageBatch for usage and error information.
- //
- // Returned Error Codes:
- // * AWS.SimpleQueueService.TooManyEntriesInBatchRequest
- // Batch request contains more number of entries than permissible.
- //
- // * AWS.SimpleQueueService.EmptyBatchRequest
- // Batch request does not contain an entry.
- //
- // * AWS.SimpleQueueService.BatchEntryIdsNotDistinct
- // Two or more batch entries have the same Id in the request.
- //
- // * AWS.SimpleQueueService.BatchRequestTooLong
- // The length of all the messages put together is more than the limit.
- //
- // * AWS.SimpleQueueService.InvalidBatchEntryId
- // The Id of a batch entry in a batch request does not abide by the specification.
- //
- // * AWS.SimpleQueueService.UnsupportedOperation
- // Error code 400. Unsupported operation.
- //
- func (c *SQS) SendMessageBatch(input *SendMessageBatchInput) (*SendMessageBatchOutput, error) {
- req, out := c.SendMessageBatchRequest(input)
- err := req.Send()
- return out, err
- }
- const opSetQueueAttributes = "SetQueueAttributes"
- // SetQueueAttributesRequest generates a "aws/request.Request" representing the
- // client's request for the SetQueueAttributes operation. The "output" return
- // value can be used to capture response data after the request's "Send" method
- // is called.
- //
- // See SetQueueAttributes for usage and error information.
- //
- // Creating a request object using this method should be used when you want to inject
- // custom logic into the request's lifecycle using a custom handler, or if you want to
- // access properties on the request object before or after sending the request. If
- // you just want the service response, call the SetQueueAttributes method directly
- // instead.
- //
- // Note: You must call the "Send" method on the returned request object in order
- // to execute the request.
- //
- // // Example sending a request using the SetQueueAttributesRequest method.
- // req, resp := client.SetQueueAttributesRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- func (c *SQS) SetQueueAttributesRequest(input *SetQueueAttributesInput) (req *request.Request, output *SetQueueAttributesOutput) {
- op := &request.Operation{
- Name: opSetQueueAttributes,
- HTTPMethod: "POST",
- HTTPPath: "/",
- }
- if input == nil {
- input = &SetQueueAttributesInput{}
- }
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Remove(query.UnmarshalHandler)
- req.Handlers.Unmarshal.PushBackNamed(protocol.UnmarshalDiscardBodyHandler)
- output = &SetQueueAttributesOutput{}
- req.Data = output
- return
- }
- // SetQueueAttributes API operation for Amazon Simple Queue Service.
- //
- // Sets the value of one or more queue attributes. When you change a queue's
- // attributes, the change can take up to 60 seconds for most of the attributes
- // to propagate throughout the SQS system. Changes made to the MessageRetentionPeriod
- // attribute can take up to 15 minutes.
- //
- // Going forward, new attributes might be added. If you are writing code that
- // calls this action, we recommend that you structure your code so that it can
- // handle new attributes gracefully.
- //
- // 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 Queue Service's
- // API operation SetQueueAttributes for usage and error information.
- //
- // Returned Error Codes:
- // * InvalidAttributeName
- // The attribute referred to does not exist.
- //
- func (c *SQS) SetQueueAttributes(input *SetQueueAttributesInput) (*SetQueueAttributesOutput, error) {
- req, out := c.SetQueueAttributesRequest(input)
- err := req.Send()
- return out, err
- }
- type AddPermissionInput struct {
- _ struct{} `type:"structure"`
- // The AWS account number of the principal (http://docs.aws.amazon.com/general/latest/gr/glos-chap.html#P)
- // who will be given permission. The principal must have an AWS account, but
- // does not need to be signed up for Amazon SQS. For information about locating
- // the AWS account identification, see Your AWS Identifiers (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/AWSCredentials.html)
- // in the Amazon SQS Developer Guide.
- //
- // AWSAccountIds is a required field
- AWSAccountIds []*string `locationNameList:"AWSAccountId" type:"list" flattened:"true" required:"true"`
- // The action the client wants to allow for the specified principal. The following
- // are valid values: * | SendMessage | ReceiveMessage | DeleteMessage | ChangeMessageVisibility
- // | GetQueueAttributes | GetQueueUrl. For more information about these actions,
- // see Understanding Permissions (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/acp-overview.html#PermissionTypes)
- // in the Amazon SQS Developer Guide.
- //
- // Specifying SendMessage, DeleteMessage, or ChangeMessageVisibility for the
- // ActionName.n also grants permissions for the corresponding batch versions
- // of those actions: SendMessageBatch, DeleteMessageBatch, and ChangeMessageVisibilityBatch.
- //
- // Actions is a required field
- Actions []*string `locationNameList:"ActionName" type:"list" flattened:"true" required:"true"`
- // The unique identification of the permission you're setting (e.g., AliceSendMessage).
- // Constraints: Maximum 80 characters; alphanumeric characters, hyphens (-),
- // and underscores (_) are allowed.
- //
- // Label is a required field
- Label *string `type:"string" required:"true"`
- // The URL of the Amazon SQS queue to take action on.
- //
- // Queue URLs are case-sensitive.
- //
- // QueueUrl is a required field
- QueueUrl *string `type:"string" required:"true"`
- }
- // String returns the string representation
- func (s AddPermissionInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s AddPermissionInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *AddPermissionInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "AddPermissionInput"}
- if s.AWSAccountIds == nil {
- invalidParams.Add(request.NewErrParamRequired("AWSAccountIds"))
- }
- if s.Actions == nil {
- invalidParams.Add(request.NewErrParamRequired("Actions"))
- }
- if s.Label == nil {
- invalidParams.Add(request.NewErrParamRequired("Label"))
- }
- if s.QueueUrl == nil {
- invalidParams.Add(request.NewErrParamRequired("QueueUrl"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- type AddPermissionOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation
- func (s AddPermissionOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s AddPermissionOutput) GoString() string {
- return s.String()
- }
- // This is used in the responses of batch API to give a detailed description
- // of the result of an action on each entry in the request.
- type BatchResultErrorEntry struct {
- _ struct{} `type:"structure"`
- // An error code representing why the action failed on this entry.
- //
- // Code is a required field
- Code *string `type:"string" required:"true"`
- // The id of an entry in a batch request.
- //
- // Id is a required field
- Id *string `type:"string" required:"true"`
- // A message explaining why the action failed on this entry.
- Message *string `type:"string"`
- // Whether the error happened due to the sender's fault.
- //
- // SenderFault is a required field
- SenderFault *bool `type:"boolean" required:"true"`
- }
- // String returns the string representation
- func (s BatchResultErrorEntry) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s BatchResultErrorEntry) GoString() string {
- return s.String()
- }
- type ChangeMessageVisibilityBatchInput struct {
- _ struct{} `type:"structure"`
- // A list of receipt handles of the messages for which the visibility timeout
- // must be changed.
- //
- // Entries is a required field
- Entries []*ChangeMessageVisibilityBatchRequestEntry `locationNameList:"ChangeMessageVisibilityBatchRequestEntry" type:"list" flattened:"true" required:"true"`
- // The URL of the Amazon SQS queue to take action on.
- //
- // Queue URLs are case-sensitive.
- //
- // QueueUrl is a required field
- QueueUrl *string `type:"string" required:"true"`
- }
- // String returns the string representation
- func (s ChangeMessageVisibilityBatchInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s ChangeMessageVisibilityBatchInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *ChangeMessageVisibilityBatchInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "ChangeMessageVisibilityBatchInput"}
- if s.Entries == nil {
- invalidParams.Add(request.NewErrParamRequired("Entries"))
- }
- if s.QueueUrl == nil {
- invalidParams.Add(request.NewErrParamRequired("QueueUrl"))
- }
- if s.Entries != nil {
- for i, v := range s.Entries {
- if v == nil {
- continue
- }
- if err := v.Validate(); err != nil {
- invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Entries", i), err.(request.ErrInvalidParams))
- }
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // For each message in the batch, the response contains a ChangeMessageVisibilityBatchResultEntry
- // tag if the message succeeds or a BatchResultErrorEntry tag if the message
- // fails.
- type ChangeMessageVisibilityBatchOutput struct {
- _ struct{} `type:"structure"`
- // A list of BatchResultErrorEntry items.
- //
- // Failed is a required field
- Failed []*BatchResultErrorEntry `locationNameList:"BatchResultErrorEntry" type:"list" flattened:"true" required:"true"`
- // A list of ChangeMessageVisibilityBatchResultEntry items.
- //
- // Successful is a required field
- Successful []*ChangeMessageVisibilityBatchResultEntry `locationNameList:"ChangeMessageVisibilityBatchResultEntry" type:"list" flattened:"true" required:"true"`
- }
- // String returns the string representation
- func (s ChangeMessageVisibilityBatchOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s ChangeMessageVisibilityBatchOutput) GoString() string {
- return s.String()
- }
- // Encloses a receipt handle and an entry id for each message in ChangeMessageVisibilityBatch.
- //
- // All of the following parameters are list parameters that must be prefixed
- // with ChangeMessageVisibilityBatchRequestEntry.n, where n is an integer value
- // starting with 1. For example, a parameter list for this action might look
- // like this:
- //
- // Your_Receipt_Handle]]>
- type ChangeMessageVisibilityBatchRequestEntry struct {
- _ struct{} `type:"structure"`
- // An identifier for this particular receipt handle. This is used to communicate
- // the result. Note that the Ids of a batch request need to be unique within
- // the request.
- //
- // Id is a required field
- Id *string `type:"string" required:"true"`
- // A receipt handle.
- //
- // ReceiptHandle is a required field
- ReceiptHandle *string `type:"string" required:"true"`
- // The new value (in seconds) for the message's visibility timeout.
- VisibilityTimeout *int64 `type:"integer"`
- }
- // String returns the string representation
- func (s ChangeMessageVisibilityBatchRequestEntry) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s ChangeMessageVisibilityBatchRequestEntry) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *ChangeMessageVisibilityBatchRequestEntry) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "ChangeMessageVisibilityBatchRequestEntry"}
- if s.Id == nil {
- invalidParams.Add(request.NewErrParamRequired("Id"))
- }
- if s.ReceiptHandle == nil {
- invalidParams.Add(request.NewErrParamRequired("ReceiptHandle"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // Encloses the id of an entry in ChangeMessageVisibilityBatch.
- type ChangeMessageVisibilityBatchResultEntry struct {
- _ struct{} `type:"structure"`
- // Represents a message whose visibility timeout has been changed successfully.
- //
- // Id is a required field
- Id *string `type:"string" required:"true"`
- }
- // String returns the string representation
- func (s ChangeMessageVisibilityBatchResultEntry) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s ChangeMessageVisibilityBatchResultEntry) GoString() string {
- return s.String()
- }
- type ChangeMessageVisibilityInput struct {
- _ struct{} `type:"structure"`
- // The URL of the Amazon SQS queue to take action on.
- //
- // Queue URLs are case-sensitive.
- //
- // QueueUrl is a required field
- QueueUrl *string `type:"string" required:"true"`
- // The receipt handle associated with the message whose visibility timeout should
- // be changed. This parameter is returned by the ReceiveMessage action.
- //
- // ReceiptHandle is a required field
- ReceiptHandle *string `type:"string" required:"true"`
- // The new value (in seconds - from 0 to 43200 - maximum 12 hours) for the message's
- // visibility timeout.
- //
- // VisibilityTimeout is a required field
- VisibilityTimeout *int64 `type:"integer" required:"true"`
- }
- // String returns the string representation
- func (s ChangeMessageVisibilityInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s ChangeMessageVisibilityInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *ChangeMessageVisibilityInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "ChangeMessageVisibilityInput"}
- if s.QueueUrl == nil {
- invalidParams.Add(request.NewErrParamRequired("QueueUrl"))
- }
- if s.ReceiptHandle == nil {
- invalidParams.Add(request.NewErrParamRequired("ReceiptHandle"))
- }
- if s.VisibilityTimeout == nil {
- invalidParams.Add(request.NewErrParamRequired("VisibilityTimeout"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- type ChangeMessageVisibilityOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation
- func (s ChangeMessageVisibilityOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s ChangeMessageVisibilityOutput) GoString() string {
- return s.String()
- }
- type CreateQueueInput struct {
- _ struct{} `type:"structure"`
- // A map of attributes with their corresponding values.
- //
- // The following lists the names, descriptions, and values of the special request
- // parameters the CreateQueue action uses:
- //
- // * DelaySeconds - The time in seconds that the delivery of all messages
- // in the queue will be delayed. An integer from 0 to 900 (15 minutes). The
- // default for this attribute is 0 (zero).
- //
- // * MaximumMessageSize - The limit of how many bytes a message can contain
- // before Amazon SQS rejects it. An integer from 1024 bytes (1 KiB) up to
- // 262144 bytes (256 KiB). The default for this attribute is 262144 (256
- // KiB).
- //
- // * MessageRetentionPeriod - The number of seconds Amazon SQS retains a
- // message. Integer representing seconds, from 60 (1 minute) to 1209600 (14
- // days). The default for this attribute is 345600 (4 days).
- //
- // * Policy - The queue's policy. A valid AWS policy. For more information
- // about policy structure, see Overview of AWS IAM Policies (http://docs.aws.amazon.com/IAM/latest/UserGuide/PoliciesOverview.html)
- // in the Amazon IAM User Guide.
- //
- // * ReceiveMessageWaitTimeSeconds - The time for which a ReceiveMessage
- // call will wait for a message to arrive. An integer from 0 to 20 (seconds).
- // The default for this attribute is 0.
- //
- // * RedrivePolicy - The parameters for dead letter queue functionality of
- // the source queue. For more information about RedrivePolicy and dead letter
- // queues, see Using Amazon SQS Dead Letter Queues (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/SQSDeadLetterQueue.html)
- // in the Amazon SQS Developer Guide.
- //
- // * VisibilityTimeout - The visibility timeout for the queue. An integer
- // from 0 to 43200 (12 hours). The default for this attribute is 30. For
- // more information about visibility timeout, see Visibility Timeout (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/AboutVT.html)
- // in the Amazon SQS Developer Guide.
- //
- // Any other valid special request parameters that are specified (such as ApproximateNumberOfMessages,
- // ApproximateNumberOfMessagesDelayed, ApproximateNumberOfMessagesNotVisible,
- // CreatedTimestamp, LastModifiedTimestamp, and QueueArn) will be ignored.
- Attributes map[string]*string `locationName:"Attribute" locationNameKey:"Name" locationNameValue:"Value" type:"map" flattened:"true"`
- // The name for the queue to be created.
- //
- // Queue names are case-sensitive.
- //
- // QueueName is a required field
- QueueName *string `type:"string" required:"true"`
- }
- // String returns the string representation
- func (s CreateQueueInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s CreateQueueInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *CreateQueueInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "CreateQueueInput"}
- if s.QueueName == nil {
- invalidParams.Add(request.NewErrParamRequired("QueueName"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // Returns the QueueUrl element of the created queue.
- type CreateQueueOutput struct {
- _ struct{} `type:"structure"`
- // The URL for the created Amazon SQS queue.
- QueueUrl *string `type:"string"`
- }
- // String returns the string representation
- func (s CreateQueueOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s CreateQueueOutput) GoString() string {
- return s.String()
- }
- type DeleteMessageBatchInput struct {
- _ struct{} `type:"structure"`
- // A list of receipt handles for the messages to be deleted.
- //
- // Entries is a required field
- Entries []*DeleteMessageBatchRequestEntry `locationNameList:"DeleteMessageBatchRequestEntry" type:"list" flattened:"true" required:"true"`
- // The URL of the Amazon SQS queue to take action on.
- //
- // Queue URLs are case-sensitive.
- //
- // QueueUrl is a required field
- QueueUrl *string `type:"string" required:"true"`
- }
- // String returns the string representation
- func (s DeleteMessageBatchInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s DeleteMessageBatchInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *DeleteMessageBatchInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "DeleteMessageBatchInput"}
- if s.Entries == nil {
- invalidParams.Add(request.NewErrParamRequired("Entries"))
- }
- if s.QueueUrl == nil {
- invalidParams.Add(request.NewErrParamRequired("QueueUrl"))
- }
- if s.Entries != nil {
- for i, v := range s.Entries {
- if v == nil {
- continue
- }
- if err := v.Validate(); err != nil {
- invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Entries", i), err.(request.ErrInvalidParams))
- }
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // For each message in the batch, the response contains a DeleteMessageBatchResultEntry
- // tag if the message is deleted or a BatchResultErrorEntry tag if the message
- // cannot be deleted.
- type DeleteMessageBatchOutput struct {
- _ struct{} `type:"structure"`
- // A list of BatchResultErrorEntry items.
- //
- // Failed is a required field
- Failed []*BatchResultErrorEntry `locationNameList:"BatchResultErrorEntry" type:"list" flattened:"true" required:"true"`
- // A list of DeleteMessageBatchResultEntry items.
- //
- // Successful is a required field
- Successful []*DeleteMessageBatchResultEntry `locationNameList:"DeleteMessageBatchResultEntry" type:"list" flattened:"true" required:"true"`
- }
- // String returns the string representation
- func (s DeleteMessageBatchOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s DeleteMessageBatchOutput) GoString() string {
- return s.String()
- }
- // Encloses a receipt handle and an identifier for it.
- type DeleteMessageBatchRequestEntry struct {
- _ struct{} `type:"structure"`
- // An identifier for this particular receipt handle. This is used to communicate
- // the result. Note that the Ids of a batch request need to be unique within
- // the request.
- //
- // Id is a required field
- Id *string `type:"string" required:"true"`
- // A receipt handle.
- //
- // ReceiptHandle is a required field
- ReceiptHandle *string `type:"string" required:"true"`
- }
- // String returns the string representation
- func (s DeleteMessageBatchRequestEntry) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s DeleteMessageBatchRequestEntry) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *DeleteMessageBatchRequestEntry) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "DeleteMessageBatchRequestEntry"}
- if s.Id == nil {
- invalidParams.Add(request.NewErrParamRequired("Id"))
- }
- if s.ReceiptHandle == nil {
- invalidParams.Add(request.NewErrParamRequired("ReceiptHandle"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // Encloses the id an entry in DeleteMessageBatch.
- type DeleteMessageBatchResultEntry struct {
- _ struct{} `type:"structure"`
- // Represents a successfully deleted message.
- //
- // Id is a required field
- Id *string `type:"string" required:"true"`
- }
- // String returns the string representation
- func (s DeleteMessageBatchResultEntry) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s DeleteMessageBatchResultEntry) GoString() string {
- return s.String()
- }
- type DeleteMessageInput struct {
- _ struct{} `type:"structure"`
- // The URL of the Amazon SQS queue to take action on.
- //
- // Queue URLs are case-sensitive.
- //
- // QueueUrl is a required field
- QueueUrl *string `type:"string" required:"true"`
- // The receipt handle associated with the message to delete.
- //
- // ReceiptHandle is a required field
- ReceiptHandle *string `type:"string" required:"true"`
- }
- // String returns the string representation
- func (s DeleteMessageInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s DeleteMessageInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *DeleteMessageInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "DeleteMessageInput"}
- if s.QueueUrl == nil {
- invalidParams.Add(request.NewErrParamRequired("QueueUrl"))
- }
- if s.ReceiptHandle == nil {
- invalidParams.Add(request.NewErrParamRequired("ReceiptHandle"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- type DeleteMessageOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation
- func (s DeleteMessageOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s DeleteMessageOutput) GoString() string {
- return s.String()
- }
- type DeleteQueueInput struct {
- _ struct{} `type:"structure"`
- // The URL of the Amazon SQS queue to take action on.
- //
- // Queue URLs are case-sensitive.
- //
- // QueueUrl is a required field
- QueueUrl *string `type:"string" required:"true"`
- }
- // String returns the string representation
- func (s DeleteQueueInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s DeleteQueueInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *DeleteQueueInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "DeleteQueueInput"}
- if s.QueueUrl == nil {
- invalidParams.Add(request.NewErrParamRequired("QueueUrl"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- type DeleteQueueOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation
- func (s DeleteQueueOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s DeleteQueueOutput) GoString() string {
- return s.String()
- }
- type GetQueueAttributesInput struct {
- _ struct{} `type:"structure"`
- // A list of attributes to retrieve information for. The following attributes
- // are supported:
- //
- // * All - returns all values.
- //
- // * ApproximateNumberOfMessages - returns the approximate number of visible
- // messages in a queue. For more information, see Resources Required to Process
- // Messages (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/ApproximateNumber.html)
- // in the Amazon SQS Developer Guide.
- //
- // * ApproximateNumberOfMessagesNotVisible - returns the approximate number
- // of messages that are not timed-out and not deleted. For more information,
- // see Resources Required to Process Messages (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/ApproximateNumber.html)
- // in the Amazon SQS Developer Guide.
- //
- // * VisibilityTimeout - returns the visibility timeout for the queue. For
- // more information about visibility timeout, see Visibility Timeout (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/AboutVT.html)
- // in the Amazon SQS Developer Guide.
- //
- // * CreatedTimestamp - returns the time when the queue was created (epoch
- // time in seconds).
- //
- // * LastModifiedTimestamp - returns the time when the queue was last changed
- // (epoch time in seconds).
- //
- // * Policy - returns the queue's policy.
- //
- // * MaximumMessageSize - returns the limit of how many bytes a message can
- // contain before Amazon SQS rejects it.
- //
- // * MessageRetentionPeriod - returns the number of seconds Amazon SQS retains
- // a message.
- //
- // * QueueArn - returns the queue's Amazon resource name (ARN).
- //
- // * ApproximateNumberOfMessagesDelayed - returns the approximate number
- // of messages that are pending to be added to the queue.
- //
- // * DelaySeconds - returns the default delay on the queue in seconds.
- //
- // * ReceiveMessageWaitTimeSeconds - returns the time for which a ReceiveMessage
- // call will wait for a message to arrive.
- //
- // * RedrivePolicy - returns the parameters for dead letter queue functionality
- // of the source queue. For more information about RedrivePolicy and dead
- // letter queues, see Using Amazon SQS Dead Letter Queues (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/SQSDeadLetterQueue.html)
- // in the Amazon SQS Developer Guide.
- //
- // Going forward, new attributes might be added. If you are writing code that
- // calls this action, we recommend that you structure your code so that it can
- // handle new attributes gracefully.
- AttributeNames []*string `locationNameList:"AttributeName" type:"list" flattened:"true"`
- // The URL of the Amazon SQS queue to take action on.
- //
- // Queue URLs are case-sensitive.
- //
- // QueueUrl is a required field
- QueueUrl *string `type:"string" required:"true"`
- }
- // String returns the string representation
- func (s GetQueueAttributesInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s GetQueueAttributesInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *GetQueueAttributesInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "GetQueueAttributesInput"}
- if s.QueueUrl == nil {
- invalidParams.Add(request.NewErrParamRequired("QueueUrl"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // A list of returned queue attributes.
- type GetQueueAttributesOutput struct {
- _ struct{} `type:"structure"`
- // A map of attributes to the respective values.
- Attributes map[string]*string `locationName:"Attribute" locationNameKey:"Name" locationNameValue:"Value" type:"map" flattened:"true"`
- }
- // String returns the string representation
- func (s GetQueueAttributesOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s GetQueueAttributesOutput) GoString() string {
- return s.String()
- }
- type GetQueueUrlInput struct {
- _ struct{} `type:"structure"`
- // The name of the queue whose URL must be fetched. Maximum 80 characters; alphanumeric
- // characters, hyphens (-), and underscores (_) are allowed.
- //
- // Queue names are case-sensitive.
- //
- // QueueName is a required field
- QueueName *string `type:"string" required:"true"`
- // The AWS account ID of the account that created the queue.
- QueueOwnerAWSAccountId *string `type:"string"`
- }
- // String returns the string representation
- func (s GetQueueUrlInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s GetQueueUrlInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *GetQueueUrlInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "GetQueueUrlInput"}
- if s.QueueName == nil {
- invalidParams.Add(request.NewErrParamRequired("QueueName"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // For more information, see Responses (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/UnderstandingResponses.html)
- // in the Amazon SQS Developer Guide.
- type GetQueueUrlOutput struct {
- _ struct{} `type:"structure"`
- // The URL for the queue.
- QueueUrl *string `type:"string"`
- }
- // String returns the string representation
- func (s GetQueueUrlOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s GetQueueUrlOutput) GoString() string {
- return s.String()
- }
- type ListDeadLetterSourceQueuesInput struct {
- _ struct{} `type:"structure"`
- // The queue URL of a dead letter queue.
- //
- // Queue URLs are case-sensitive.
- //
- // QueueUrl is a required field
- QueueUrl *string `type:"string" required:"true"`
- }
- // String returns the string representation
- func (s ListDeadLetterSourceQueuesInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s ListDeadLetterSourceQueuesInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *ListDeadLetterSourceQueuesInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "ListDeadLetterSourceQueuesInput"}
- if s.QueueUrl == nil {
- invalidParams.Add(request.NewErrParamRequired("QueueUrl"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // A list of your dead letter source queues.
- type ListDeadLetterSourceQueuesOutput struct {
- _ struct{} `type:"structure"`
- // A list of source queue URLs that have the RedrivePolicy queue attribute configured
- // with a dead letter queue.
- //
- // QueueUrls is a required field
- QueueUrls []*string `locationName:"queueUrls" locationNameList:"QueueUrl" type:"list" flattened:"true" required:"true"`
- }
- // String returns the string representation
- func (s ListDeadLetterSourceQueuesOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s ListDeadLetterSourceQueuesOutput) GoString() string {
- return s.String()
- }
- type ListQueuesInput struct {
- _ struct{} `type:"structure"`
- // A string to use for filtering the list results. Only those queues whose name
- // begins with the specified string are returned.
- //
- // Queue names are case-sensitive.
- QueueNamePrefix *string `type:"string"`
- }
- // String returns the string representation
- func (s ListQueuesInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s ListQueuesInput) GoString() string {
- return s.String()
- }
- // A list of your queues.
- type ListQueuesOutput struct {
- _ struct{} `type:"structure"`
- // A list of queue URLs, up to 1000 entries.
- QueueUrls []*string `locationNameList:"QueueUrl" type:"list" flattened:"true"`
- }
- // String returns the string representation
- func (s ListQueuesOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s ListQueuesOutput) GoString() string {
- return s.String()
- }
- // An Amazon SQS message.
- type Message struct {
- _ struct{} `type:"structure"`
- // SenderId, SentTimestamp, ApproximateReceiveCount, and/or ApproximateFirstReceiveTimestamp.
- // SentTimestamp and ApproximateFirstReceiveTimestamp are each returned as an
- // integer representing the epoch time (http://en.wikipedia.org/wiki/Unix_time)
- // in milliseconds.
- Attributes map[string]*string `locationName:"Attribute" locationNameKey:"Name" locationNameValue:"Value" type:"map" flattened:"true"`
- // The message's contents (not URL-encoded).
- Body *string `type:"string"`
- // An MD5 digest of the non-URL-encoded message body string.
- MD5OfBody *string `type:"string"`
- // An MD5 digest of the non-URL-encoded message attribute string. This can be
- // used to verify that Amazon SQS received the message correctly. Amazon SQS
- // first URL decodes the message before creating the MD5 digest. For information
- // about MD5, go to http://www.faqs.org/rfcs/rfc1321.html (http://www.faqs.org/rfcs/rfc1321.html).
- MD5OfMessageAttributes *string `type:"string"`
- // Each message attribute consists of a Name, Type, and Value. For more information,
- // see Message Attribute Items (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/SQSMessageAttributes.html#SQSMessageAttributesNTV).
- MessageAttributes map[string]*MessageAttributeValue `locationName:"MessageAttribute" locationNameKey:"Name" locationNameValue:"Value" type:"map" flattened:"true"`
- // A unique identifier for the message. Message IDs are considered unique across
- // all AWS accounts for an extended period of time.
- MessageId *string `type:"string"`
- // An identifier associated with the act of receiving the message. A new receipt
- // handle is returned every time you receive a message. When deleting a message,
- // you provide the last received receipt handle to delete the message.
- ReceiptHandle *string `type:"string"`
- }
- // String returns the string representation
- func (s Message) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s Message) GoString() string {
- return s.String()
- }
- // The user-specified message attribute value. For string data types, the value
- // attribute has the same restrictions on the content as the message body. For
- // more information, see SendMessage (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_SendMessage.html).
- //
- // Name, type, and value must not be empty or null. In addition, the message
- // body should not be empty or null. All parts of the message attribute, including
- // name, type, and value, are included in the message size restriction, which
- // is currently 256 KB (262,144 bytes).
- type MessageAttributeValue struct {
- _ struct{} `type:"structure"`
- // Not implemented. Reserved for future use.
- BinaryListValues [][]byte `locationName:"BinaryListValue" locationNameList:"BinaryListValue" type:"list" flattened:"true"`
- // Binary type attributes can store any binary data, for example, compressed
- // data, encrypted data, or images.
- //
- // BinaryValue is automatically base64 encoded/decoded by the SDK.
- BinaryValue []byte `type:"blob"`
- // Amazon SQS supports the following logical data types: String, Number, and
- // Binary. For the Number data type, you must use StringValue.
- //
- // You can also append custom labels. For more information, see Message Attribute
- // Data Types (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/SQSMessageAttributes.html#SQSMessageAttributes.DataTypes).
- //
- // DataType is a required field
- DataType *string `type:"string" required:"true"`
- // Not implemented. Reserved for future use.
- StringListValues []*string `locationName:"StringListValue" locationNameList:"StringListValue" type:"list" flattened:"true"`
- // Strings are Unicode with UTF8 binary encoding. For a list of code values,
- // see http://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters (http://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters).
- StringValue *string `type:"string"`
- }
- // String returns the string representation
- func (s MessageAttributeValue) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s MessageAttributeValue) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *MessageAttributeValue) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "MessageAttributeValue"}
- if s.DataType == nil {
- invalidParams.Add(request.NewErrParamRequired("DataType"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- type PurgeQueueInput struct {
- _ struct{} `type:"structure"`
- // The queue URL of the queue to delete the messages from when using the PurgeQueue
- // API.
- //
- // Queue URLs are case-sensitive.
- //
- // QueueUrl is a required field
- QueueUrl *string `type:"string" required:"true"`
- }
- // String returns the string representation
- func (s PurgeQueueInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s PurgeQueueInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *PurgeQueueInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "PurgeQueueInput"}
- if s.QueueUrl == nil {
- invalidParams.Add(request.NewErrParamRequired("QueueUrl"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- type PurgeQueueOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation
- func (s PurgeQueueOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s PurgeQueueOutput) GoString() string {
- return s.String()
- }
- type ReceiveMessageInput struct {
- _ struct{} `type:"structure"`
- // A list of attributes that need to be returned along with each message. These
- // attributes include:
- //
- // * All - returns all values.
- //
- // * ApproximateFirstReceiveTimestamp - returns the time when the message
- // was first received from the queue (epoch time in milliseconds).
- //
- // * ApproximateReceiveCount - returns the number of times a message has
- // been received from the queue but not deleted.
- //
- // * SenderId - returns the AWS account number (or the IP address, if anonymous
- // access is allowed) of the sender.
- //
- // * SentTimestamp - returns the time when the message was sent to the queue
- // (epoch time in milliseconds).
- //
- // Any other valid special request parameters that are specified (such as ApproximateNumberOfMessages,
- // ApproximateNumberOfMessagesDelayed, ApproximateNumberOfMessagesNotVisible,
- // CreatedTimestamp, DelaySeconds, LastModifiedTimestamp, MaximumMessageSize,
- // MessageRetentionPeriod, Policy, QueueArn, ReceiveMessageWaitTimeSeconds,
- // RedrivePolicy, and VisibilityTimeout) will be ignored.
- AttributeNames []*string `locationNameList:"AttributeName" type:"list" flattened:"true"`
- // The maximum number of messages to return. Amazon SQS never returns more messages
- // than this value but may return fewer. Values can be from 1 to 10. Default
- // is 1.
- //
- // All of the messages are not necessarily returned.
- MaxNumberOfMessages *int64 `type:"integer"`
- // The name of the message attribute, where N is the index. The message attribute
- // name can contain the following characters: A-Z, a-z, 0-9, underscore (_),
- // hyphen (-), and period (.). The name must not start or end with a period,
- // and it should not have successive periods. The name is case sensitive and
- // must be unique among all attribute names for the message. The name can be
- // up to 256 characters long. The name cannot start with "AWS." or "Amazon."
- // (or any variations in casing), because these prefixes are reserved for use
- // by Amazon Web Services.
- //
- // When using ReceiveMessage, you can send a list of attribute names to receive,
- // or you can return all of the attributes by specifying "All" or ".*" in your
- // request. You can also use "bar.*" to return all message attributes starting
- // with the "bar" prefix.
- MessageAttributeNames []*string `locationNameList:"MessageAttributeName" type:"list" flattened:"true"`
- // The URL of the Amazon SQS queue to take action on.
- //
- // Queue URLs are case-sensitive.
- //
- // QueueUrl is a required field
- QueueUrl *string `type:"string" required:"true"`
- // The duration (in seconds) that the received messages are hidden from subsequent
- // retrieve requests after being retrieved by a ReceiveMessage request.
- VisibilityTimeout *int64 `type:"integer"`
- // The duration (in seconds) for which the call will wait for a message to arrive
- // in the queue before returning. If a message is available, the call will return
- // sooner than WaitTimeSeconds.
- WaitTimeSeconds *int64 `type:"integer"`
- }
- // String returns the string representation
- func (s ReceiveMessageInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s ReceiveMessageInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *ReceiveMessageInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "ReceiveMessageInput"}
- if s.QueueUrl == nil {
- invalidParams.Add(request.NewErrParamRequired("QueueUrl"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // A list of received messages.
- type ReceiveMessageOutput struct {
- _ struct{} `type:"structure"`
- // A list of messages.
- Messages []*Message `locationNameList:"Message" type:"list" flattened:"true"`
- }
- // String returns the string representation
- func (s ReceiveMessageOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s ReceiveMessageOutput) GoString() string {
- return s.String()
- }
- type RemovePermissionInput struct {
- _ struct{} `type:"structure"`
- // The identification of the permission to remove. This is the label added with
- // the AddPermission action.
- //
- // Label is a required field
- Label *string `type:"string" required:"true"`
- // The URL of the Amazon SQS queue to take action on.
- //
- // Queue URLs are case-sensitive.
- //
- // QueueUrl is a required field
- QueueUrl *string `type:"string" required:"true"`
- }
- // String returns the string representation
- func (s RemovePermissionInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s RemovePermissionInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *RemovePermissionInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "RemovePermissionInput"}
- if s.Label == nil {
- invalidParams.Add(request.NewErrParamRequired("Label"))
- }
- if s.QueueUrl == nil {
- invalidParams.Add(request.NewErrParamRequired("QueueUrl"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- type RemovePermissionOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation
- func (s RemovePermissionOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s RemovePermissionOutput) GoString() string {
- return s.String()
- }
- type SendMessageBatchInput struct {
- _ struct{} `type:"structure"`
- // A list of SendMessageBatchRequestEntry items.
- //
- // Entries is a required field
- Entries []*SendMessageBatchRequestEntry `locationNameList:"SendMessageBatchRequestEntry" type:"list" flattened:"true" required:"true"`
- // The URL of the Amazon SQS queue to take action on.
- //
- // Queue URLs are case-sensitive.
- //
- // QueueUrl is a required field
- QueueUrl *string `type:"string" required:"true"`
- }
- // String returns the string representation
- func (s SendMessageBatchInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s SendMessageBatchInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *SendMessageBatchInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "SendMessageBatchInput"}
- if s.Entries == nil {
- invalidParams.Add(request.NewErrParamRequired("Entries"))
- }
- if s.QueueUrl == nil {
- invalidParams.Add(request.NewErrParamRequired("QueueUrl"))
- }
- if s.Entries != nil {
- for i, v := range s.Entries {
- if v == nil {
- continue
- }
- if err := v.Validate(); err != nil {
- invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Entries", i), err.(request.ErrInvalidParams))
- }
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // For each message in the batch, the response contains a SendMessageBatchResultEntry
- // tag if the message succeeds or a BatchResultErrorEntry tag if the message
- // fails.
- type SendMessageBatchOutput struct {
- _ struct{} `type:"structure"`
- // A list of BatchResultErrorEntry items with the error detail about each message
- // that could not be enqueued.
- //
- // Failed is a required field
- Failed []*BatchResultErrorEntry `locationNameList:"BatchResultErrorEntry" type:"list" flattened:"true" required:"true"`
- // A list of SendMessageBatchResultEntry items.
- //
- // Successful is a required field
- Successful []*SendMessageBatchResultEntry `locationNameList:"SendMessageBatchResultEntry" type:"list" flattened:"true" required:"true"`
- }
- // String returns the string representation
- func (s SendMessageBatchOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s SendMessageBatchOutput) GoString() string {
- return s.String()
- }
- // Contains the details of a single Amazon SQS message along with a Id.
- type SendMessageBatchRequestEntry struct {
- _ struct{} `type:"structure"`
- // The number of seconds for which the message has to be delayed.
- DelaySeconds *int64 `type:"integer"`
- // An identifier for the message in this batch. This is used to communicate
- // the result. Note that the Ids of a batch request need to be unique within
- // the request.
- //
- // Id is a required field
- Id *string `type:"string" required:"true"`
- // Each message attribute consists of a Name, Type, and Value. For more information,
- // see Message Attribute Items (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/SQSMessageAttributes.html#SQSMessageAttributesNTV).
- MessageAttributes map[string]*MessageAttributeValue `locationName:"MessageAttribute" locationNameKey:"Name" locationNameValue:"Value" type:"map" flattened:"true"`
- // Body of the message.
- //
- // MessageBody is a required field
- MessageBody *string `type:"string" required:"true"`
- }
- // String returns the string representation
- func (s SendMessageBatchRequestEntry) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s SendMessageBatchRequestEntry) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *SendMessageBatchRequestEntry) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "SendMessageBatchRequestEntry"}
- if s.Id == nil {
- invalidParams.Add(request.NewErrParamRequired("Id"))
- }
- if s.MessageBody == nil {
- invalidParams.Add(request.NewErrParamRequired("MessageBody"))
- }
- if s.MessageAttributes != nil {
- for i, v := range s.MessageAttributes {
- if v == nil {
- continue
- }
- if err := v.Validate(); err != nil {
- invalidParams.AddNested(fmt.Sprintf("%s[%v]", "MessageAttributes", i), err.(request.ErrInvalidParams))
- }
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // Encloses a message ID for successfully enqueued message of a SendMessageBatch.
- type SendMessageBatchResultEntry struct {
- _ struct{} `type:"structure"`
- // An identifier for the message in this batch.
- //
- // Id is a required field
- Id *string `type:"string" required:"true"`
- // An MD5 digest of the non-URL-encoded message attribute string. This can be
- // used to verify that Amazon SQS received the message batch correctly. Amazon
- // SQS first URL decodes the message before creating the MD5 digest. For information
- // about MD5, go to http://www.faqs.org/rfcs/rfc1321.html (http://www.faqs.org/rfcs/rfc1321.html).
- MD5OfMessageAttributes *string `type:"string"`
- // An MD5 digest of the non-URL-encoded message body string. This can be used
- // to verify that Amazon SQS received the message correctly. Amazon SQS first
- // URL decodes the message before creating the MD5 digest. For information about
- // MD5, go to http://www.faqs.org/rfcs/rfc1321.html (http://www.faqs.org/rfcs/rfc1321.html).
- //
- // MD5OfMessageBody is a required field
- MD5OfMessageBody *string `type:"string" required:"true"`
- // An identifier for the message.
- //
- // MessageId is a required field
- MessageId *string `type:"string" required:"true"`
- }
- // String returns the string representation
- func (s SendMessageBatchResultEntry) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s SendMessageBatchResultEntry) GoString() string {
- return s.String()
- }
- type SendMessageInput struct {
- _ struct{} `type:"structure"`
- // The number of seconds (0 to 900 - 15 minutes) to delay a specific message.
- // Messages with a positive DelaySeconds value become available for processing
- // after the delay time is finished. If you don't specify a value, the default
- // value for the queue applies.
- DelaySeconds *int64 `type:"integer"`
- // Each message attribute consists of a Name, Type, and Value. For more information,
- // see Message Attribute Items (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/SQSMessageAttributes.html#SQSMessageAttributesNTV).
- MessageAttributes map[string]*MessageAttributeValue `locationName:"MessageAttribute" locationNameKey:"Name" locationNameValue:"Value" type:"map" flattened:"true"`
- // The message to send. String maximum 256 KB in size. For a list of allowed
- // characters, see the preceding important note.
- //
- // MessageBody is a required field
- MessageBody *string `type:"string" required:"true"`
- // The URL of the Amazon SQS queue to take action on.
- //
- // Queue URLs are case-sensitive.
- //
- // QueueUrl is a required field
- QueueUrl *string `type:"string" required:"true"`
- }
- // String returns the string representation
- func (s SendMessageInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s SendMessageInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *SendMessageInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "SendMessageInput"}
- if s.MessageBody == nil {
- invalidParams.Add(request.NewErrParamRequired("MessageBody"))
- }
- if s.QueueUrl == nil {
- invalidParams.Add(request.NewErrParamRequired("QueueUrl"))
- }
- if s.MessageAttributes != nil {
- for i, v := range s.MessageAttributes {
- if v == nil {
- continue
- }
- if err := v.Validate(); err != nil {
- invalidParams.AddNested(fmt.Sprintf("%s[%v]", "MessageAttributes", i), err.(request.ErrInvalidParams))
- }
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // The MD5OfMessageBody and MessageId elements.
- type SendMessageOutput struct {
- _ struct{} `type:"structure"`
- // An MD5 digest of the non-URL-encoded message attribute string. This can be
- // used to verify that Amazon SQS received the message correctly. Amazon SQS
- // first URL decodes the message before creating the MD5 digest. For information
- // about MD5, go to http://www.faqs.org/rfcs/rfc1321.html (http://www.faqs.org/rfcs/rfc1321.html).
- MD5OfMessageAttributes *string `type:"string"`
- // An MD5 digest of the non-URL-encoded message body string. This can be used
- // to verify that Amazon SQS received the message correctly. Amazon SQS first
- // URL decodes the message before creating the MD5 digest. For information about
- // MD5, go to http://www.faqs.org/rfcs/rfc1321.html (http://www.faqs.org/rfcs/rfc1321.html).
- MD5OfMessageBody *string `type:"string"`
- // An element containing the message ID of the message sent to the queue. For
- // more information, see Queue and Message Identifiers (http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/ImportantIdentifiers.html)
- // in the Amazon SQS Developer Guide.
- MessageId *string `type:"string"`
- }
- // String returns the string representation
- func (s SendMessageOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s SendMessageOutput) GoString() string {
- return s.String()
- }
- type SetQueueAttributesInput struct {
- _ struct{} `type:"structure"`
- // A map of attributes to set.
- //
- // The following lists the names, descriptions, and values of the special request
- // parameters the SetQueueAttributes action uses:
- //
- // * DelaySeconds - The time in seconds that the delivery of all messages
- // in the queue will be delayed. An integer from 0 to 900 (15 minutes). The
- // default for this attribute is 0 (zero).
- //
- // * MaximumMessageSize - The limit of how many bytes a message can contain
- // before Amazon SQS rejects it. An integer from 1024 bytes (1 KiB) up to
- // 262144 bytes (256 KiB). The default for this attribute is 262144 (256
- // KiB).
- //
- // * MessageRetentionPeriod - The number of seconds Amazon SQS retains a
- // message. Integer representing seconds, from 60 (1 minute) to 1209600 (14
- // days). The default for this attribute is 345600 (4 days).
- //
- // * Policy - The queue's policy. A valid AWS policy. For more information
- // about policy structure, see Overview of AWS IAM Policies (http://docs.aws.amazon.com/IAM/latest/UserGuide/PoliciesOverview.html)
- // in the Amazon IAM User Guide.
- //
- // * ReceiveMessageWaitTimeSeconds - The time for which a ReceiveMessage
- // call will wait for a message to arrive. An integer from 0 to 20 (seconds).
- // The default for this attribute is 0.
- //
- // * VisibilityTimeout - The visibility timeout for the queue. An integer
- // from 0 to 43200 (12 hours). The default for this attribute is 30. For
- // more information about visibility timeout, see Visibility Timeout in the
- // Amazon SQS Developer Guide.
- //
- // * RedrivePolicy - The parameters for dead letter queue functionality of
- // the source queue. For more information about RedrivePolicy and dead letter
- // queues, see Using Amazon SQS Dead Letter Queues in the Amazon SQS Developer
- // Guide.
- //
- // Any other valid special request parameters that are specified (such as ApproximateNumberOfMessages,
- // ApproximateNumberOfMessagesDelayed, ApproximateNumberOfMessagesNotVisible,
- // CreatedTimestamp, LastModifiedTimestamp, and QueueArn) will be ignored.
- //
- // Attributes is a required field
- Attributes map[string]*string `locationName:"Attribute" locationNameKey:"Name" locationNameValue:"Value" type:"map" flattened:"true" required:"true"`
- // The URL of the Amazon SQS queue to take action on.
- //
- // Queue URLs are case-sensitive.
- //
- // QueueUrl is a required field
- QueueUrl *string `type:"string" required:"true"`
- }
- // String returns the string representation
- func (s SetQueueAttributesInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s SetQueueAttributesInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *SetQueueAttributesInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "SetQueueAttributesInput"}
- if s.Attributes == nil {
- invalidParams.Add(request.NewErrParamRequired("Attributes"))
- }
- if s.QueueUrl == nil {
- invalidParams.Add(request.NewErrParamRequired("QueueUrl"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- type SetQueueAttributesOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation
- func (s SetQueueAttributesOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s SetQueueAttributesOutput) GoString() string {
- return s.String()
- }
- const (
- // QueueAttributeNamePolicy is a QueueAttributeName enum value
- QueueAttributeNamePolicy = "Policy"
- // QueueAttributeNameVisibilityTimeout is a QueueAttributeName enum value
- QueueAttributeNameVisibilityTimeout = "VisibilityTimeout"
- // QueueAttributeNameMaximumMessageSize is a QueueAttributeName enum value
- QueueAttributeNameMaximumMessageSize = "MaximumMessageSize"
- // QueueAttributeNameMessageRetentionPeriod is a QueueAttributeName enum value
- QueueAttributeNameMessageRetentionPeriod = "MessageRetentionPeriod"
- // QueueAttributeNameApproximateNumberOfMessages is a QueueAttributeName enum value
- QueueAttributeNameApproximateNumberOfMessages = "ApproximateNumberOfMessages"
- // QueueAttributeNameApproximateNumberOfMessagesNotVisible is a QueueAttributeName enum value
- QueueAttributeNameApproximateNumberOfMessagesNotVisible = "ApproximateNumberOfMessagesNotVisible"
- // QueueAttributeNameCreatedTimestamp is a QueueAttributeName enum value
- QueueAttributeNameCreatedTimestamp = "CreatedTimestamp"
- // QueueAttributeNameLastModifiedTimestamp is a QueueAttributeName enum value
- QueueAttributeNameLastModifiedTimestamp = "LastModifiedTimestamp"
- // QueueAttributeNameQueueArn is a QueueAttributeName enum value
- QueueAttributeNameQueueArn = "QueueArn"
- // QueueAttributeNameApproximateNumberOfMessagesDelayed is a QueueAttributeName enum value
- QueueAttributeNameApproximateNumberOfMessagesDelayed = "ApproximateNumberOfMessagesDelayed"
- // QueueAttributeNameDelaySeconds is a QueueAttributeName enum value
- QueueAttributeNameDelaySeconds = "DelaySeconds"
- // QueueAttributeNameReceiveMessageWaitTimeSeconds is a QueueAttributeName enum value
- QueueAttributeNameReceiveMessageWaitTimeSeconds = "ReceiveMessageWaitTimeSeconds"
- // QueueAttributeNameRedrivePolicy is a QueueAttributeName enum value
- QueueAttributeNameRedrivePolicy = "RedrivePolicy"
- )
|