| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154215521562157215821592160216121622163216421652166216721682169217021712172217321742175217621772178217921802181218221832184218521862187218821892190219121922193219421952196219721982199220022012202220322042205220622072208220922102211221222132214221522162217221822192220222122222223222422252226222722282229223022312232223322342235223622372238223922402241224222432244224522462247224822492250225122522253225422552256225722582259226022612262226322642265226622672268226922702271227222732274227522762277227822792280228122822283228422852286228722882289229022912292229322942295229622972298229923002301230223032304230523062307230823092310231123122313231423152316231723182319232023212322232323242325232623272328232923302331233223332334233523362337233823392340234123422343234423452346234723482349235023512352235323542355235623572358235923602361236223632364236523662367236823692370237123722373237423752376237723782379238023812382238323842385238623872388238923902391239223932394239523962397239823992400240124022403240424052406240724082409241024112412241324142415241624172418241924202421242224232424242524262427242824292430243124322433243424352436243724382439244024412442244324442445244624472448244924502451245224532454245524562457245824592460246124622463246424652466246724682469247024712472247324742475247624772478247924802481248224832484248524862487248824892490249124922493249424952496249724982499250025012502250325042505250625072508250925102511251225132514251525162517251825192520252125222523252425252526252725282529253025312532253325342535253625372538253925402541254225432544254525462547254825492550255125522553255425552556255725582559256025612562256325642565256625672568256925702571257225732574257525762577257825792580258125822583258425852586258725882589259025912592259325942595259625972598259926002601260226032604260526062607260826092610261126122613261426152616261726182619262026212622262326242625262626272628262926302631263226332634263526362637263826392640264126422643264426452646264726482649265026512652265326542655265626572658265926602661266226632664266526662667266826692670267126722673267426752676267726782679268026812682268326842685268626872688268926902691269226932694269526962697269826992700270127022703270427052706270727082709271027112712271327142715271627172718271927202721272227232724272527262727272827292730273127322733273427352736273727382739274027412742274327442745274627472748274927502751275227532754275527562757275827592760276127622763276427652766276727682769277027712772277327742775277627772778277927802781278227832784278527862787278827892790279127922793279427952796279727982799280028012802280328042805280628072808280928102811281228132814281528162817281828192820282128222823282428252826282728282829283028312832283328342835283628372838283928402841284228432844284528462847284828492850285128522853285428552856285728582859286028612862286328642865286628672868286928702871287228732874287528762877287828792880288128822883288428852886288728882889289028912892289328942895289628972898289929002901290229032904290529062907290829092910291129122913291429152916291729182919292029212922292329242925292629272928292929302931293229332934293529362937293829392940294129422943294429452946294729482949295029512952 |
- // Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
- package efs
- import (
- "fmt"
- "time"
- "github.com/aws/aws-sdk-go/aws"
- "github.com/aws/aws-sdk-go/aws/awsutil"
- "github.com/aws/aws-sdk-go/aws/request"
- "github.com/aws/aws-sdk-go/private/protocol"
- "github.com/aws/aws-sdk-go/private/protocol/restjson"
- )
- const opCreateFileSystem = "CreateFileSystem"
- // CreateFileSystemRequest generates a "aws/request.Request" representing the
- // client's request for the CreateFileSystem operation. The "output" return
- // value will be populated with the request's response once the request completes
- // successfully.
- //
- // Use "Send" method on the returned Request to send the API call to the service.
- // the "output" return value is not valid until after Send returns without error.
- //
- // See CreateFileSystem for more information on using the CreateFileSystem
- // API call, and error handling.
- //
- // This method is useful when you want to inject custom logic or configuration
- // into the SDK's request lifecycle. Such as custom headers, or retry logic.
- //
- //
- // // Example sending a request using the CreateFileSystemRequest method.
- // req, resp := client.CreateFileSystemRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/CreateFileSystem
- func (c *EFS) CreateFileSystemRequest(input *CreateFileSystemInput) (req *request.Request, output *FileSystemDescription) {
- op := &request.Operation{
- Name: opCreateFileSystem,
- HTTPMethod: "POST",
- HTTPPath: "/2015-02-01/file-systems",
- }
- if input == nil {
- input = &CreateFileSystemInput{}
- }
- output = &FileSystemDescription{}
- req = c.newRequest(op, input, output)
- return
- }
- // CreateFileSystem API operation for Amazon Elastic File System.
- //
- // Creates a new, empty file system. The operation requires a creation token
- // in the request that Amazon EFS uses to ensure idempotent creation (calling
- // the operation with same creation token has no effect). If a file system does
- // not currently exist that is owned by the caller's AWS account with the specified
- // creation token, this operation does the following:
- //
- // * Creates a new, empty file system. The file system will have an Amazon
- // EFS assigned ID, and an initial lifecycle state creating.
- //
- // * Returns with the description of the created file system.
- //
- // Otherwise, this operation returns a FileSystemAlreadyExists error with the
- // ID of the existing file system.
- //
- // For basic use cases, you can use a randomly generated UUID for the creation
- // token.
- //
- // The idempotent operation allows you to retry a CreateFileSystem call without
- // risk of creating an extra file system. This can happen when an initial call
- // fails in a way that leaves it uncertain whether or not a file system was
- // actually created. An example might be that a transport level timeout occurred
- // or your connection was reset. As long as you use the same creation token,
- // if the initial call had succeeded in creating a file system, the client can
- // learn of its existence from the FileSystemAlreadyExists error.
- //
- // The CreateFileSystem call returns while the file system's lifecycle state
- // is still creating. You can check the file system creation status by calling
- // the DescribeFileSystems operation, which among other things returns the file
- // system state.
- //
- // This operation also takes an optional PerformanceMode parameter that you
- // choose for your file system. We recommend generalPurpose performance mode
- // for most file systems. File systems using the maxIO performance mode can
- // scale to higher levels of aggregate throughput and operations per second
- // with a tradeoff of slightly higher latencies for most file operations. The
- // performance mode can't be changed after the file system has been created.
- // For more information, see Amazon EFS: Performance Modes (http://docs.aws.amazon.com/efs/latest/ug/performance.html#performancemodes.html).
- //
- // After the file system is fully created, Amazon EFS sets its lifecycle state
- // to available, at which point you can create one or more mount targets for
- // the file system in your VPC. For more information, see CreateMountTarget.
- // You mount your Amazon EFS file system on an EC2 instances in your VPC via
- // the mount target. For more information, see Amazon EFS: How it Works (http://docs.aws.amazon.com/efs/latest/ug/how-it-works.html).
- //
- // This operation requires permissions for the elasticfilesystem:CreateFileSystem
- // 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 Elastic File System's
- // API operation CreateFileSystem for usage and error information.
- //
- // Returned Error Codes:
- // * ErrCodeBadRequest "BadRequest"
- // Returned if the request is malformed or contains an error such as an invalid
- // parameter value or a missing required parameter.
- //
- // * ErrCodeInternalServerError "InternalServerError"
- // Returned if an error occurred on the server side.
- //
- // * ErrCodeFileSystemAlreadyExists "FileSystemAlreadyExists"
- // Returned if the file system you are trying to create already exists, with
- // the creation token you provided.
- //
- // * ErrCodeFileSystemLimitExceeded "FileSystemLimitExceeded"
- // Returned if the AWS account has already created the maximum number of file
- // systems allowed per account.
- //
- // * ErrCodeInsufficientThroughputCapacity "InsufficientThroughputCapacity"
- // Returned if there's not enough capacity to provision additional throughput.
- // This value might be returned when you try to create a file system in provisioned
- // throughput mode, when you attempt to increase the provisioned throughput
- // of an existing file system, or when you attempt to change an existing file
- // system from bursting to provisioned throughput mode.
- //
- // * ErrCodeThroughputLimitExceeded "ThroughputLimitExceeded"
- // Returned if the throughput mode or amount of provisioned throughput can't
- // be changed because the throughput limit of 1024 MiB/s has been reached.
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/CreateFileSystem
- func (c *EFS) CreateFileSystem(input *CreateFileSystemInput) (*FileSystemDescription, error) {
- req, out := c.CreateFileSystemRequest(input)
- return out, req.Send()
- }
- // CreateFileSystemWithContext is the same as CreateFileSystem with the addition of
- // the ability to pass a context and additional request options.
- //
- // See CreateFileSystem for details on how to use this API operation.
- //
- // The context must be non-nil and will be used for request cancellation. If
- // the context is nil a panic will occur. In the future the SDK may create
- // sub-contexts for http.Requests. See https://golang.org/pkg/context/
- // for more information on using Contexts.
- func (c *EFS) CreateFileSystemWithContext(ctx aws.Context, input *CreateFileSystemInput, opts ...request.Option) (*FileSystemDescription, error) {
- req, out := c.CreateFileSystemRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opCreateMountTarget = "CreateMountTarget"
- // CreateMountTargetRequest generates a "aws/request.Request" representing the
- // client's request for the CreateMountTarget operation. The "output" return
- // value will be populated with the request's response once the request completes
- // successfully.
- //
- // Use "Send" method on the returned Request to send the API call to the service.
- // the "output" return value is not valid until after Send returns without error.
- //
- // See CreateMountTarget for more information on using the CreateMountTarget
- // API call, and error handling.
- //
- // This method is useful when you want to inject custom logic or configuration
- // into the SDK's request lifecycle. Such as custom headers, or retry logic.
- //
- //
- // // Example sending a request using the CreateMountTargetRequest method.
- // req, resp := client.CreateMountTargetRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/CreateMountTarget
- func (c *EFS) CreateMountTargetRequest(input *CreateMountTargetInput) (req *request.Request, output *MountTargetDescription) {
- op := &request.Operation{
- Name: opCreateMountTarget,
- HTTPMethod: "POST",
- HTTPPath: "/2015-02-01/mount-targets",
- }
- if input == nil {
- input = &CreateMountTargetInput{}
- }
- output = &MountTargetDescription{}
- req = c.newRequest(op, input, output)
- return
- }
- // CreateMountTarget API operation for Amazon Elastic File System.
- //
- // Creates a mount target for a file system. You can then mount the file system
- // on EC2 instances via the mount target.
- //
- // You can create one mount target in each Availability Zone in your VPC. All
- // EC2 instances in a VPC within a given Availability Zone share a single mount
- // target for a given file system. If you have multiple subnets in an Availability
- // Zone, you create a mount target in one of the subnets. EC2 instances do not
- // need to be in the same subnet as the mount target in order to access their
- // file system. For more information, see Amazon EFS: How it Works (http://docs.aws.amazon.com/efs/latest/ug/how-it-works.html).
- //
- // In the request, you also specify a file system ID for which you are creating
- // the mount target and the file system's lifecycle state must be available.
- // For more information, see DescribeFileSystems.
- //
- // In the request, you also provide a subnet ID, which determines the following:
- //
- // * VPC in which Amazon EFS creates the mount target
- //
- // * Availability Zone in which Amazon EFS creates the mount target
- //
- // * IP address range from which Amazon EFS selects the IP address of the
- // mount target (if you don't specify an IP address in the request)
- //
- // After creating the mount target, Amazon EFS returns a response that includes,
- // a MountTargetId and an IpAddress. You use this IP address when mounting the
- // file system in an EC2 instance. You can also use the mount target's DNS name
- // when mounting the file system. The EC2 instance on which you mount the file
- // system via the mount target can resolve the mount target's DNS name to its
- // IP address. For more information, see How it Works: Implementation Overview
- // (http://docs.aws.amazon.com/efs/latest/ug/how-it-works.html#how-it-works-implementation).
- //
- // Note that you can create mount targets for a file system in only one VPC,
- // and there can be only one mount target per Availability Zone. That is, if
- // the file system already has one or more mount targets created for it, the
- // subnet specified in the request to add another mount target must meet the
- // following requirements:
- //
- // * Must belong to the same VPC as the subnets of the existing mount targets
- //
- // * Must not be in the same Availability Zone as any of the subnets of the
- // existing mount targets
- //
- // If the request satisfies the requirements, Amazon EFS does the following:
- //
- // * Creates a new mount target in the specified subnet.
- //
- // * Also creates a new network interface in the subnet as follows:
- //
- // If the request provides an IpAddress, Amazon EFS assigns that IP address
- // to the network interface. Otherwise, Amazon EFS assigns a free address
- // in the subnet (in the same way that the Amazon EC2 CreateNetworkInterface
- // call does when a request does not specify a primary private IP address).
- //
- // If the request provides SecurityGroups, this network interface is associated
- // with those security groups. Otherwise, it belongs to the default security
- // group for the subnet's VPC.
- //
- // Assigns the description Mount target fsmt-id for file system fs-id where
- // fsmt-id is the mount target ID, and fs-id is the FileSystemId.
- //
- // Sets the requesterManaged property of the network interface to true, and
- // the requesterId value to EFS.
- //
- // Each Amazon EFS mount target has one corresponding requester-managed EC2
- // network interface. After the network interface is created, Amazon EFS
- // sets the NetworkInterfaceId field in the mount target's description to
- // the network interface ID, and the IpAddress field to its address. If network
- // interface creation fails, the entire CreateMountTarget operation fails.
- //
- // The CreateMountTarget call returns only after creating the network interface,
- // but while the mount target state is still creating, you can check the mount
- // target creation status by calling the DescribeMountTargets operation, which
- // among other things returns the mount target state.
- //
- // We recommend you create a mount target in each of the Availability Zones.
- // There are cost considerations for using a file system in an Availability
- // Zone through a mount target created in another Availability Zone. For more
- // information, see Amazon EFS (http://aws.amazon.com/efs/). In addition, by
- // always using a mount target local to the instance's Availability Zone, you
- // eliminate a partial failure scenario. If the Availability Zone in which your
- // mount target is created goes down, then you won't be able to access your
- // file system through that mount target.
- //
- // This operation requires permissions for the following action on the file
- // system:
- //
- // * elasticfilesystem:CreateMountTarget
- //
- // This operation also requires permissions for the following Amazon EC2 actions:
- //
- // * ec2:DescribeSubnets
- //
- // * ec2:DescribeNetworkInterfaces
- //
- // * ec2:CreateNetworkInterface
- //
- // 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 Elastic File System's
- // API operation CreateMountTarget for usage and error information.
- //
- // Returned Error Codes:
- // * ErrCodeBadRequest "BadRequest"
- // Returned if the request is malformed or contains an error such as an invalid
- // parameter value or a missing required parameter.
- //
- // * ErrCodeInternalServerError "InternalServerError"
- // Returned if an error occurred on the server side.
- //
- // * ErrCodeFileSystemNotFound "FileSystemNotFound"
- // Returned if the specified FileSystemId value doesn't exist in the requester's
- // AWS account.
- //
- // * ErrCodeIncorrectFileSystemLifeCycleState "IncorrectFileSystemLifeCycleState"
- // Returned if the file system's lifecycle state is not "available".
- //
- // * ErrCodeMountTargetConflict "MountTargetConflict"
- // Returned if the mount target would violate one of the specified restrictions
- // based on the file system's existing mount targets.
- //
- // * ErrCodeSubnetNotFound "SubnetNotFound"
- // Returned if there is no subnet with ID SubnetId provided in the request.
- //
- // * ErrCodeNoFreeAddressesInSubnet "NoFreeAddressesInSubnet"
- // Returned if IpAddress was not specified in the request and there are no free
- // IP addresses in the subnet.
- //
- // * ErrCodeIpAddressInUse "IpAddressInUse"
- // Returned if the request specified an IpAddress that is already in use in
- // the subnet.
- //
- // * ErrCodeNetworkInterfaceLimitExceeded "NetworkInterfaceLimitExceeded"
- // The calling account has reached the limit for elastic network interfaces
- // for the specific AWS Region. The client should try to delete some elastic
- // network interfaces or get the account limit raised. For more information,
- // see Amazon VPC Limits (http://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/VPC_Appendix_Limits.html)
- // in the Amazon VPC User Guide (see the Network interfaces per VPC entry in
- // the table).
- //
- // * ErrCodeSecurityGroupLimitExceeded "SecurityGroupLimitExceeded"
- // Returned if the size of SecurityGroups specified in the request is greater
- // than five.
- //
- // * ErrCodeSecurityGroupNotFound "SecurityGroupNotFound"
- // Returned if one of the specified security groups doesn't exist in the subnet's
- // VPC.
- //
- // * ErrCodeUnsupportedAvailabilityZone "UnsupportedAvailabilityZone"
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/CreateMountTarget
- func (c *EFS) CreateMountTarget(input *CreateMountTargetInput) (*MountTargetDescription, error) {
- req, out := c.CreateMountTargetRequest(input)
- return out, req.Send()
- }
- // CreateMountTargetWithContext is the same as CreateMountTarget with the addition of
- // the ability to pass a context and additional request options.
- //
- // See CreateMountTarget for details on how to use this API operation.
- //
- // The context must be non-nil and will be used for request cancellation. If
- // the context is nil a panic will occur. In the future the SDK may create
- // sub-contexts for http.Requests. See https://golang.org/pkg/context/
- // for more information on using Contexts.
- func (c *EFS) CreateMountTargetWithContext(ctx aws.Context, input *CreateMountTargetInput, opts ...request.Option) (*MountTargetDescription, error) {
- req, out := c.CreateMountTargetRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opCreateTags = "CreateTags"
- // CreateTagsRequest generates a "aws/request.Request" representing the
- // client's request for the CreateTags operation. The "output" return
- // value will be populated with the request's response once the request completes
- // successfully.
- //
- // Use "Send" method on the returned Request to send the API call to the service.
- // the "output" return value is not valid until after Send returns without error.
- //
- // See CreateTags for more information on using the CreateTags
- // API call, and error handling.
- //
- // This method is useful when you want to inject custom logic or configuration
- // into the SDK's request lifecycle. Such as custom headers, or retry logic.
- //
- //
- // // Example sending a request using the CreateTagsRequest method.
- // req, resp := client.CreateTagsRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/CreateTags
- func (c *EFS) CreateTagsRequest(input *CreateTagsInput) (req *request.Request, output *CreateTagsOutput) {
- op := &request.Operation{
- Name: opCreateTags,
- HTTPMethod: "POST",
- HTTPPath: "/2015-02-01/create-tags/{FileSystemId}",
- }
- if input == nil {
- input = &CreateTagsInput{}
- }
- output = &CreateTagsOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Swap(restjson.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler)
- return
- }
- // CreateTags API operation for Amazon Elastic File System.
- //
- // Creates or overwrites tags associated with a file system. Each tag is a key-value
- // pair. If a tag key specified in the request already exists on the file system,
- // this operation overwrites its value with the value provided in the request.
- // If you add the Name tag to your file system, Amazon EFS returns it in the
- // response to the DescribeFileSystems operation.
- //
- // This operation requires permission for the elasticfilesystem:CreateTags 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 Elastic File System's
- // API operation CreateTags for usage and error information.
- //
- // Returned Error Codes:
- // * ErrCodeBadRequest "BadRequest"
- // Returned if the request is malformed or contains an error such as an invalid
- // parameter value or a missing required parameter.
- //
- // * ErrCodeInternalServerError "InternalServerError"
- // Returned if an error occurred on the server side.
- //
- // * ErrCodeFileSystemNotFound "FileSystemNotFound"
- // Returned if the specified FileSystemId value doesn't exist in the requester's
- // AWS account.
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/CreateTags
- func (c *EFS) CreateTags(input *CreateTagsInput) (*CreateTagsOutput, error) {
- req, out := c.CreateTagsRequest(input)
- return out, req.Send()
- }
- // CreateTagsWithContext is the same as CreateTags with the addition of
- // the ability to pass a context and additional request options.
- //
- // See CreateTags for details on how to use this API operation.
- //
- // The context must be non-nil and will be used for request cancellation. If
- // the context is nil a panic will occur. In the future the SDK may create
- // sub-contexts for http.Requests. See https://golang.org/pkg/context/
- // for more information on using Contexts.
- func (c *EFS) CreateTagsWithContext(ctx aws.Context, input *CreateTagsInput, opts ...request.Option) (*CreateTagsOutput, error) {
- req, out := c.CreateTagsRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opDeleteFileSystem = "DeleteFileSystem"
- // DeleteFileSystemRequest generates a "aws/request.Request" representing the
- // client's request for the DeleteFileSystem operation. The "output" return
- // value will be populated with the request's response once the request completes
- // successfully.
- //
- // Use "Send" method on the returned Request to send the API call to the service.
- // the "output" return value is not valid until after Send returns without error.
- //
- // See DeleteFileSystem for more information on using the DeleteFileSystem
- // API call, and error handling.
- //
- // This method is useful when you want to inject custom logic or configuration
- // into the SDK's request lifecycle. Such as custom headers, or retry logic.
- //
- //
- // // Example sending a request using the DeleteFileSystemRequest method.
- // req, resp := client.DeleteFileSystemRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/DeleteFileSystem
- func (c *EFS) DeleteFileSystemRequest(input *DeleteFileSystemInput) (req *request.Request, output *DeleteFileSystemOutput) {
- op := &request.Operation{
- Name: opDeleteFileSystem,
- HTTPMethod: "DELETE",
- HTTPPath: "/2015-02-01/file-systems/{FileSystemId}",
- }
- if input == nil {
- input = &DeleteFileSystemInput{}
- }
- output = &DeleteFileSystemOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Swap(restjson.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler)
- return
- }
- // DeleteFileSystem API operation for Amazon Elastic File System.
- //
- // Deletes a file system, permanently severing access to its contents. Upon
- // return, the file system no longer exists and you can't access any contents
- // of the deleted file system.
- //
- // You can't delete a file system that is in use. That is, if the file system
- // has any mount targets, you must first delete them. For more information,
- // see DescribeMountTargets and DeleteMountTarget.
- //
- // The DeleteFileSystem call returns while the file system state is still deleting.
- // You can check the file system deletion status by calling the DescribeFileSystems
- // operation, which returns a list of file systems in your account. If you pass
- // file system ID or creation token for the deleted file system, the DescribeFileSystems
- // returns a 404 FileSystemNotFound error.
- //
- // This operation requires permissions for the elasticfilesystem:DeleteFileSystem
- // 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 Elastic File System's
- // API operation DeleteFileSystem for usage and error information.
- //
- // Returned Error Codes:
- // * ErrCodeBadRequest "BadRequest"
- // Returned if the request is malformed or contains an error such as an invalid
- // parameter value or a missing required parameter.
- //
- // * ErrCodeInternalServerError "InternalServerError"
- // Returned if an error occurred on the server side.
- //
- // * ErrCodeFileSystemNotFound "FileSystemNotFound"
- // Returned if the specified FileSystemId value doesn't exist in the requester's
- // AWS account.
- //
- // * ErrCodeFileSystemInUse "FileSystemInUse"
- // Returned if a file system has mount targets.
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/DeleteFileSystem
- func (c *EFS) DeleteFileSystem(input *DeleteFileSystemInput) (*DeleteFileSystemOutput, error) {
- req, out := c.DeleteFileSystemRequest(input)
- return out, req.Send()
- }
- // DeleteFileSystemWithContext is the same as DeleteFileSystem with the addition of
- // the ability to pass a context and additional request options.
- //
- // See DeleteFileSystem for details on how to use this API operation.
- //
- // The context must be non-nil and will be used for request cancellation. If
- // the context is nil a panic will occur. In the future the SDK may create
- // sub-contexts for http.Requests. See https://golang.org/pkg/context/
- // for more information on using Contexts.
- func (c *EFS) DeleteFileSystemWithContext(ctx aws.Context, input *DeleteFileSystemInput, opts ...request.Option) (*DeleteFileSystemOutput, error) {
- req, out := c.DeleteFileSystemRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opDeleteMountTarget = "DeleteMountTarget"
- // DeleteMountTargetRequest generates a "aws/request.Request" representing the
- // client's request for the DeleteMountTarget operation. The "output" return
- // value will be populated with the request's response once the request completes
- // successfully.
- //
- // Use "Send" method on the returned Request to send the API call to the service.
- // the "output" return value is not valid until after Send returns without error.
- //
- // See DeleteMountTarget for more information on using the DeleteMountTarget
- // API call, and error handling.
- //
- // This method is useful when you want to inject custom logic or configuration
- // into the SDK's request lifecycle. Such as custom headers, or retry logic.
- //
- //
- // // Example sending a request using the DeleteMountTargetRequest method.
- // req, resp := client.DeleteMountTargetRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/DeleteMountTarget
- func (c *EFS) DeleteMountTargetRequest(input *DeleteMountTargetInput) (req *request.Request, output *DeleteMountTargetOutput) {
- op := &request.Operation{
- Name: opDeleteMountTarget,
- HTTPMethod: "DELETE",
- HTTPPath: "/2015-02-01/mount-targets/{MountTargetId}",
- }
- if input == nil {
- input = &DeleteMountTargetInput{}
- }
- output = &DeleteMountTargetOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Swap(restjson.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler)
- return
- }
- // DeleteMountTarget API operation for Amazon Elastic File System.
- //
- // Deletes the specified mount target.
- //
- // This operation forcibly breaks any mounts of the file system via the mount
- // target that is being deleted, which might disrupt instances or applications
- // using those mounts. To avoid applications getting cut off abruptly, you might
- // consider unmounting any mounts of the mount target, if feasible. The operation
- // also deletes the associated network interface. Uncommitted writes may be
- // lost, but breaking a mount target using this operation does not corrupt the
- // file system itself. The file system you created remains. You can mount an
- // EC2 instance in your VPC via another mount target.
- //
- // This operation requires permissions for the following action on the file
- // system:
- //
- // * elasticfilesystem:DeleteMountTarget
- //
- // The DeleteMountTarget call returns while the mount target state is still
- // deleting. You can check the mount target deletion by calling the DescribeMountTargets
- // operation, which returns a list of mount target descriptions for the given
- // file system.
- //
- // The operation also requires permissions for the following Amazon EC2 action
- // on the mount target's network interface:
- //
- // * ec2:DeleteNetworkInterface
- //
- // 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 Elastic File System's
- // API operation DeleteMountTarget for usage and error information.
- //
- // Returned Error Codes:
- // * ErrCodeBadRequest "BadRequest"
- // Returned if the request is malformed or contains an error such as an invalid
- // parameter value or a missing required parameter.
- //
- // * ErrCodeInternalServerError "InternalServerError"
- // Returned if an error occurred on the server side.
- //
- // * ErrCodeDependencyTimeout "DependencyTimeout"
- // The service timed out trying to fulfill the request, and the client should
- // try the call again.
- //
- // * ErrCodeMountTargetNotFound "MountTargetNotFound"
- // Returned if there is no mount target with the specified ID found in the caller's
- // account.
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/DeleteMountTarget
- func (c *EFS) DeleteMountTarget(input *DeleteMountTargetInput) (*DeleteMountTargetOutput, error) {
- req, out := c.DeleteMountTargetRequest(input)
- return out, req.Send()
- }
- // DeleteMountTargetWithContext is the same as DeleteMountTarget with the addition of
- // the ability to pass a context and additional request options.
- //
- // See DeleteMountTarget for details on how to use this API operation.
- //
- // The context must be non-nil and will be used for request cancellation. If
- // the context is nil a panic will occur. In the future the SDK may create
- // sub-contexts for http.Requests. See https://golang.org/pkg/context/
- // for more information on using Contexts.
- func (c *EFS) DeleteMountTargetWithContext(ctx aws.Context, input *DeleteMountTargetInput, opts ...request.Option) (*DeleteMountTargetOutput, error) {
- req, out := c.DeleteMountTargetRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opDeleteTags = "DeleteTags"
- // DeleteTagsRequest generates a "aws/request.Request" representing the
- // client's request for the DeleteTags operation. The "output" return
- // value will be populated with the request's response once the request completes
- // successfully.
- //
- // Use "Send" method on the returned Request to send the API call to the service.
- // the "output" return value is not valid until after Send returns without error.
- //
- // See DeleteTags for more information on using the DeleteTags
- // API call, and error handling.
- //
- // This method is useful when you want to inject custom logic or configuration
- // into the SDK's request lifecycle. Such as custom headers, or retry logic.
- //
- //
- // // Example sending a request using the DeleteTagsRequest method.
- // req, resp := client.DeleteTagsRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/DeleteTags
- func (c *EFS) DeleteTagsRequest(input *DeleteTagsInput) (req *request.Request, output *DeleteTagsOutput) {
- op := &request.Operation{
- Name: opDeleteTags,
- HTTPMethod: "POST",
- HTTPPath: "/2015-02-01/delete-tags/{FileSystemId}",
- }
- if input == nil {
- input = &DeleteTagsInput{}
- }
- output = &DeleteTagsOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Swap(restjson.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler)
- return
- }
- // DeleteTags API operation for Amazon Elastic File System.
- //
- // Deletes the specified tags from a file system. If the DeleteTags request
- // includes a tag key that does not exist, Amazon EFS ignores it and doesn't
- // cause an error. For more information about tags and related restrictions,
- // see Tag Restrictions (http://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html)
- // in the AWS Billing and Cost Management User Guide.
- //
- // This operation requires permissions for the elasticfilesystem:DeleteTags
- // 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 Elastic File System's
- // API operation DeleteTags for usage and error information.
- //
- // Returned Error Codes:
- // * ErrCodeBadRequest "BadRequest"
- // Returned if the request is malformed or contains an error such as an invalid
- // parameter value or a missing required parameter.
- //
- // * ErrCodeInternalServerError "InternalServerError"
- // Returned if an error occurred on the server side.
- //
- // * ErrCodeFileSystemNotFound "FileSystemNotFound"
- // Returned if the specified FileSystemId value doesn't exist in the requester's
- // AWS account.
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/DeleteTags
- func (c *EFS) DeleteTags(input *DeleteTagsInput) (*DeleteTagsOutput, error) {
- req, out := c.DeleteTagsRequest(input)
- return out, req.Send()
- }
- // DeleteTagsWithContext is the same as DeleteTags with the addition of
- // the ability to pass a context and additional request options.
- //
- // See DeleteTags for details on how to use this API operation.
- //
- // The context must be non-nil and will be used for request cancellation. If
- // the context is nil a panic will occur. In the future the SDK may create
- // sub-contexts for http.Requests. See https://golang.org/pkg/context/
- // for more information on using Contexts.
- func (c *EFS) DeleteTagsWithContext(ctx aws.Context, input *DeleteTagsInput, opts ...request.Option) (*DeleteTagsOutput, error) {
- req, out := c.DeleteTagsRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opDescribeFileSystems = "DescribeFileSystems"
- // DescribeFileSystemsRequest generates a "aws/request.Request" representing the
- // client's request for the DescribeFileSystems operation. The "output" return
- // value will be populated with the request's response once the request completes
- // successfully.
- //
- // Use "Send" method on the returned Request to send the API call to the service.
- // the "output" return value is not valid until after Send returns without error.
- //
- // See DescribeFileSystems for more information on using the DescribeFileSystems
- // API call, and error handling.
- //
- // This method is useful when you want to inject custom logic or configuration
- // into the SDK's request lifecycle. Such as custom headers, or retry logic.
- //
- //
- // // Example sending a request using the DescribeFileSystemsRequest method.
- // req, resp := client.DescribeFileSystemsRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/DescribeFileSystems
- func (c *EFS) DescribeFileSystemsRequest(input *DescribeFileSystemsInput) (req *request.Request, output *DescribeFileSystemsOutput) {
- op := &request.Operation{
- Name: opDescribeFileSystems,
- HTTPMethod: "GET",
- HTTPPath: "/2015-02-01/file-systems",
- }
- if input == nil {
- input = &DescribeFileSystemsInput{}
- }
- output = &DescribeFileSystemsOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // DescribeFileSystems API operation for Amazon Elastic File System.
- //
- // Returns the description of a specific Amazon EFS file system if either the
- // file system CreationToken or the FileSystemId is provided. Otherwise, it
- // returns descriptions of all file systems owned by the caller's AWS account
- // in the AWS Region of the endpoint that you're calling.
- //
- // When retrieving all file system descriptions, you can optionally specify
- // the MaxItems parameter to limit the number of descriptions in a response.
- // If more file system descriptions remain, Amazon EFS returns a NextMarker,
- // an opaque token, in the response. In this case, you should send a subsequent
- // request with the Marker request parameter set to the value of NextMarker.
- //
- // To retrieve a list of your file system descriptions, this operation is used
- // in an iterative process, where DescribeFileSystems is called first without
- // the Marker and then the operation continues to call it with the Marker parameter
- // set to the value of the NextMarker from the previous response until the response
- // has no NextMarker.
- //
- // The implementation may return fewer than MaxItems file system descriptions
- // while still including a NextMarker value.
- //
- // The order of file systems returned in the response of one DescribeFileSystems
- // call and the order of file systems returned across the responses of a multi-call
- // iteration is unspecified.
- //
- // This operation requires permissions for the elasticfilesystem:DescribeFileSystems
- // 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 Elastic File System's
- // API operation DescribeFileSystems for usage and error information.
- //
- // Returned Error Codes:
- // * ErrCodeBadRequest "BadRequest"
- // Returned if the request is malformed or contains an error such as an invalid
- // parameter value or a missing required parameter.
- //
- // * ErrCodeInternalServerError "InternalServerError"
- // Returned if an error occurred on the server side.
- //
- // * ErrCodeFileSystemNotFound "FileSystemNotFound"
- // Returned if the specified FileSystemId value doesn't exist in the requester's
- // AWS account.
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/DescribeFileSystems
- func (c *EFS) DescribeFileSystems(input *DescribeFileSystemsInput) (*DescribeFileSystemsOutput, error) {
- req, out := c.DescribeFileSystemsRequest(input)
- return out, req.Send()
- }
- // DescribeFileSystemsWithContext is the same as DescribeFileSystems with the addition of
- // the ability to pass a context and additional request options.
- //
- // See DescribeFileSystems for details on how to use this API operation.
- //
- // The context must be non-nil and will be used for request cancellation. If
- // the context is nil a panic will occur. In the future the SDK may create
- // sub-contexts for http.Requests. See https://golang.org/pkg/context/
- // for more information on using Contexts.
- func (c *EFS) DescribeFileSystemsWithContext(ctx aws.Context, input *DescribeFileSystemsInput, opts ...request.Option) (*DescribeFileSystemsOutput, error) {
- req, out := c.DescribeFileSystemsRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opDescribeMountTargetSecurityGroups = "DescribeMountTargetSecurityGroups"
- // DescribeMountTargetSecurityGroupsRequest generates a "aws/request.Request" representing the
- // client's request for the DescribeMountTargetSecurityGroups operation. The "output" return
- // value will be populated with the request's response once the request completes
- // successfully.
- //
- // Use "Send" method on the returned Request to send the API call to the service.
- // the "output" return value is not valid until after Send returns without error.
- //
- // See DescribeMountTargetSecurityGroups for more information on using the DescribeMountTargetSecurityGroups
- // API call, and error handling.
- //
- // This method is useful when you want to inject custom logic or configuration
- // into the SDK's request lifecycle. Such as custom headers, or retry logic.
- //
- //
- // // Example sending a request using the DescribeMountTargetSecurityGroupsRequest method.
- // req, resp := client.DescribeMountTargetSecurityGroupsRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups
- func (c *EFS) DescribeMountTargetSecurityGroupsRequest(input *DescribeMountTargetSecurityGroupsInput) (req *request.Request, output *DescribeMountTargetSecurityGroupsOutput) {
- op := &request.Operation{
- Name: opDescribeMountTargetSecurityGroups,
- HTTPMethod: "GET",
- HTTPPath: "/2015-02-01/mount-targets/{MountTargetId}/security-groups",
- }
- if input == nil {
- input = &DescribeMountTargetSecurityGroupsInput{}
- }
- output = &DescribeMountTargetSecurityGroupsOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // DescribeMountTargetSecurityGroups API operation for Amazon Elastic File System.
- //
- // Returns the security groups currently in effect for a mount target. This
- // operation requires that the network interface of the mount target has been
- // created and the lifecycle state of the mount target is not deleted.
- //
- // This operation requires permissions for the following actions:
- //
- // * elasticfilesystem:DescribeMountTargetSecurityGroups action on the mount
- // target's file system.
- //
- // * ec2:DescribeNetworkInterfaceAttribute action on the mount target's network
- // interface.
- //
- // 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 Elastic File System's
- // API operation DescribeMountTargetSecurityGroups for usage and error information.
- //
- // Returned Error Codes:
- // * ErrCodeBadRequest "BadRequest"
- // Returned if the request is malformed or contains an error such as an invalid
- // parameter value or a missing required parameter.
- //
- // * ErrCodeInternalServerError "InternalServerError"
- // Returned if an error occurred on the server side.
- //
- // * ErrCodeMountTargetNotFound "MountTargetNotFound"
- // Returned if there is no mount target with the specified ID found in the caller's
- // account.
- //
- // * ErrCodeIncorrectMountTargetState "IncorrectMountTargetState"
- // Returned if the mount target is not in the correct state for the operation.
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups
- func (c *EFS) DescribeMountTargetSecurityGroups(input *DescribeMountTargetSecurityGroupsInput) (*DescribeMountTargetSecurityGroupsOutput, error) {
- req, out := c.DescribeMountTargetSecurityGroupsRequest(input)
- return out, req.Send()
- }
- // DescribeMountTargetSecurityGroupsWithContext is the same as DescribeMountTargetSecurityGroups with the addition of
- // the ability to pass a context and additional request options.
- //
- // See DescribeMountTargetSecurityGroups for details on how to use this API operation.
- //
- // The context must be non-nil and will be used for request cancellation. If
- // the context is nil a panic will occur. In the future the SDK may create
- // sub-contexts for http.Requests. See https://golang.org/pkg/context/
- // for more information on using Contexts.
- func (c *EFS) DescribeMountTargetSecurityGroupsWithContext(ctx aws.Context, input *DescribeMountTargetSecurityGroupsInput, opts ...request.Option) (*DescribeMountTargetSecurityGroupsOutput, error) {
- req, out := c.DescribeMountTargetSecurityGroupsRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opDescribeMountTargets = "DescribeMountTargets"
- // DescribeMountTargetsRequest generates a "aws/request.Request" representing the
- // client's request for the DescribeMountTargets operation. The "output" return
- // value will be populated with the request's response once the request completes
- // successfully.
- //
- // Use "Send" method on the returned Request to send the API call to the service.
- // the "output" return value is not valid until after Send returns without error.
- //
- // See DescribeMountTargets for more information on using the DescribeMountTargets
- // API call, and error handling.
- //
- // This method is useful when you want to inject custom logic or configuration
- // into the SDK's request lifecycle. Such as custom headers, or retry logic.
- //
- //
- // // Example sending a request using the DescribeMountTargetsRequest method.
- // req, resp := client.DescribeMountTargetsRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/DescribeMountTargets
- func (c *EFS) DescribeMountTargetsRequest(input *DescribeMountTargetsInput) (req *request.Request, output *DescribeMountTargetsOutput) {
- op := &request.Operation{
- Name: opDescribeMountTargets,
- HTTPMethod: "GET",
- HTTPPath: "/2015-02-01/mount-targets",
- }
- if input == nil {
- input = &DescribeMountTargetsInput{}
- }
- output = &DescribeMountTargetsOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // DescribeMountTargets API operation for Amazon Elastic File System.
- //
- // Returns the descriptions of all the current mount targets, or a specific
- // mount target, for a file system. When requesting all of the current mount
- // targets, the order of mount targets returned in the response is unspecified.
- //
- // This operation requires permissions for the elasticfilesystem:DescribeMountTargets
- // action, on either the file system ID that you specify in FileSystemId, or
- // on the file system of the mount target that you specify in MountTargetId.
- //
- // 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 Elastic File System's
- // API operation DescribeMountTargets for usage and error information.
- //
- // Returned Error Codes:
- // * ErrCodeBadRequest "BadRequest"
- // Returned if the request is malformed or contains an error such as an invalid
- // parameter value or a missing required parameter.
- //
- // * ErrCodeInternalServerError "InternalServerError"
- // Returned if an error occurred on the server side.
- //
- // * ErrCodeFileSystemNotFound "FileSystemNotFound"
- // Returned if the specified FileSystemId value doesn't exist in the requester's
- // AWS account.
- //
- // * ErrCodeMountTargetNotFound "MountTargetNotFound"
- // Returned if there is no mount target with the specified ID found in the caller's
- // account.
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/DescribeMountTargets
- func (c *EFS) DescribeMountTargets(input *DescribeMountTargetsInput) (*DescribeMountTargetsOutput, error) {
- req, out := c.DescribeMountTargetsRequest(input)
- return out, req.Send()
- }
- // DescribeMountTargetsWithContext is the same as DescribeMountTargets with the addition of
- // the ability to pass a context and additional request options.
- //
- // See DescribeMountTargets for details on how to use this API operation.
- //
- // The context must be non-nil and will be used for request cancellation. If
- // the context is nil a panic will occur. In the future the SDK may create
- // sub-contexts for http.Requests. See https://golang.org/pkg/context/
- // for more information on using Contexts.
- func (c *EFS) DescribeMountTargetsWithContext(ctx aws.Context, input *DescribeMountTargetsInput, opts ...request.Option) (*DescribeMountTargetsOutput, error) {
- req, out := c.DescribeMountTargetsRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opDescribeTags = "DescribeTags"
- // DescribeTagsRequest generates a "aws/request.Request" representing the
- // client's request for the DescribeTags operation. The "output" return
- // value will be populated with the request's response once the request completes
- // successfully.
- //
- // Use "Send" method on the returned Request to send the API call to the service.
- // the "output" return value is not valid until after Send returns without error.
- //
- // See DescribeTags for more information on using the DescribeTags
- // API call, and error handling.
- //
- // This method is useful when you want to inject custom logic or configuration
- // into the SDK's request lifecycle. Such as custom headers, or retry logic.
- //
- //
- // // Example sending a request using the DescribeTagsRequest method.
- // req, resp := client.DescribeTagsRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/DescribeTags
- func (c *EFS) DescribeTagsRequest(input *DescribeTagsInput) (req *request.Request, output *DescribeTagsOutput) {
- op := &request.Operation{
- Name: opDescribeTags,
- HTTPMethod: "GET",
- HTTPPath: "/2015-02-01/tags/{FileSystemId}/",
- }
- if input == nil {
- input = &DescribeTagsInput{}
- }
- output = &DescribeTagsOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // DescribeTags API operation for Amazon Elastic File System.
- //
- // Returns the tags associated with a file system. The order of tags returned
- // in the response of one DescribeTags call and the order of tags returned across
- // the responses of a multi-call iteration (when using pagination) is unspecified.
- //
- // This operation requires permissions for the elasticfilesystem:DescribeTags
- // 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 Elastic File System's
- // API operation DescribeTags for usage and error information.
- //
- // Returned Error Codes:
- // * ErrCodeBadRequest "BadRequest"
- // Returned if the request is malformed or contains an error such as an invalid
- // parameter value or a missing required parameter.
- //
- // * ErrCodeInternalServerError "InternalServerError"
- // Returned if an error occurred on the server side.
- //
- // * ErrCodeFileSystemNotFound "FileSystemNotFound"
- // Returned if the specified FileSystemId value doesn't exist in the requester's
- // AWS account.
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/DescribeTags
- func (c *EFS) DescribeTags(input *DescribeTagsInput) (*DescribeTagsOutput, error) {
- req, out := c.DescribeTagsRequest(input)
- return out, req.Send()
- }
- // DescribeTagsWithContext is the same as DescribeTags with the addition of
- // the ability to pass a context and additional request options.
- //
- // See DescribeTags for details on how to use this API operation.
- //
- // The context must be non-nil and will be used for request cancellation. If
- // the context is nil a panic will occur. In the future the SDK may create
- // sub-contexts for http.Requests. See https://golang.org/pkg/context/
- // for more information on using Contexts.
- func (c *EFS) DescribeTagsWithContext(ctx aws.Context, input *DescribeTagsInput, opts ...request.Option) (*DescribeTagsOutput, error) {
- req, out := c.DescribeTagsRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opModifyMountTargetSecurityGroups = "ModifyMountTargetSecurityGroups"
- // ModifyMountTargetSecurityGroupsRequest generates a "aws/request.Request" representing the
- // client's request for the ModifyMountTargetSecurityGroups operation. The "output" return
- // value will be populated with the request's response once the request completes
- // successfully.
- //
- // Use "Send" method on the returned Request to send the API call to the service.
- // the "output" return value is not valid until after Send returns without error.
- //
- // See ModifyMountTargetSecurityGroups for more information on using the ModifyMountTargetSecurityGroups
- // API call, and error handling.
- //
- // This method is useful when you want to inject custom logic or configuration
- // into the SDK's request lifecycle. Such as custom headers, or retry logic.
- //
- //
- // // Example sending a request using the ModifyMountTargetSecurityGroupsRequest method.
- // req, resp := client.ModifyMountTargetSecurityGroupsRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups
- func (c *EFS) ModifyMountTargetSecurityGroupsRequest(input *ModifyMountTargetSecurityGroupsInput) (req *request.Request, output *ModifyMountTargetSecurityGroupsOutput) {
- op := &request.Operation{
- Name: opModifyMountTargetSecurityGroups,
- HTTPMethod: "PUT",
- HTTPPath: "/2015-02-01/mount-targets/{MountTargetId}/security-groups",
- }
- if input == nil {
- input = &ModifyMountTargetSecurityGroupsInput{}
- }
- output = &ModifyMountTargetSecurityGroupsOutput{}
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Swap(restjson.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler)
- return
- }
- // ModifyMountTargetSecurityGroups API operation for Amazon Elastic File System.
- //
- // Modifies the set of security groups in effect for a mount target.
- //
- // When you create a mount target, Amazon EFS also creates a new network interface.
- // For more information, see CreateMountTarget. This operation replaces the
- // security groups in effect for the network interface associated with a mount
- // target, with the SecurityGroups provided in the request. This operation requires
- // that the network interface of the mount target has been created and the lifecycle
- // state of the mount target is not deleted.
- //
- // The operation requires permissions for the following actions:
- //
- // * elasticfilesystem:ModifyMountTargetSecurityGroups action on the mount
- // target's file system.
- //
- // * ec2:ModifyNetworkInterfaceAttribute action on the mount target's network
- // interface.
- //
- // 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 Elastic File System's
- // API operation ModifyMountTargetSecurityGroups for usage and error information.
- //
- // Returned Error Codes:
- // * ErrCodeBadRequest "BadRequest"
- // Returned if the request is malformed or contains an error such as an invalid
- // parameter value or a missing required parameter.
- //
- // * ErrCodeInternalServerError "InternalServerError"
- // Returned if an error occurred on the server side.
- //
- // * ErrCodeMountTargetNotFound "MountTargetNotFound"
- // Returned if there is no mount target with the specified ID found in the caller's
- // account.
- //
- // * ErrCodeIncorrectMountTargetState "IncorrectMountTargetState"
- // Returned if the mount target is not in the correct state for the operation.
- //
- // * ErrCodeSecurityGroupLimitExceeded "SecurityGroupLimitExceeded"
- // Returned if the size of SecurityGroups specified in the request is greater
- // than five.
- //
- // * ErrCodeSecurityGroupNotFound "SecurityGroupNotFound"
- // Returned if one of the specified security groups doesn't exist in the subnet's
- // VPC.
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups
- func (c *EFS) ModifyMountTargetSecurityGroups(input *ModifyMountTargetSecurityGroupsInput) (*ModifyMountTargetSecurityGroupsOutput, error) {
- req, out := c.ModifyMountTargetSecurityGroupsRequest(input)
- return out, req.Send()
- }
- // ModifyMountTargetSecurityGroupsWithContext is the same as ModifyMountTargetSecurityGroups with the addition of
- // the ability to pass a context and additional request options.
- //
- // See ModifyMountTargetSecurityGroups for details on how to use this API operation.
- //
- // The context must be non-nil and will be used for request cancellation. If
- // the context is nil a panic will occur. In the future the SDK may create
- // sub-contexts for http.Requests. See https://golang.org/pkg/context/
- // for more information on using Contexts.
- func (c *EFS) ModifyMountTargetSecurityGroupsWithContext(ctx aws.Context, input *ModifyMountTargetSecurityGroupsInput, opts ...request.Option) (*ModifyMountTargetSecurityGroupsOutput, error) {
- req, out := c.ModifyMountTargetSecurityGroupsRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- const opUpdateFileSystem = "UpdateFileSystem"
- // UpdateFileSystemRequest generates a "aws/request.Request" representing the
- // client's request for the UpdateFileSystem operation. The "output" return
- // value will be populated with the request's response once the request completes
- // successfully.
- //
- // Use "Send" method on the returned Request to send the API call to the service.
- // the "output" return value is not valid until after Send returns without error.
- //
- // See UpdateFileSystem for more information on using the UpdateFileSystem
- // API call, and error handling.
- //
- // This method is useful when you want to inject custom logic or configuration
- // into the SDK's request lifecycle. Such as custom headers, or retry logic.
- //
- //
- // // Example sending a request using the UpdateFileSystemRequest method.
- // req, resp := client.UpdateFileSystemRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/UpdateFileSystem
- func (c *EFS) UpdateFileSystemRequest(input *UpdateFileSystemInput) (req *request.Request, output *UpdateFileSystemOutput) {
- op := &request.Operation{
- Name: opUpdateFileSystem,
- HTTPMethod: "PUT",
- HTTPPath: "/2015-02-01/file-systems/{FileSystemId}",
- }
- if input == nil {
- input = &UpdateFileSystemInput{}
- }
- output = &UpdateFileSystemOutput{}
- req = c.newRequest(op, input, output)
- return
- }
- // UpdateFileSystem API operation for Amazon Elastic File System.
- //
- // Updates the throughput mode or the amount of provisioned throughput of an
- // existing file system.
- //
- // Returns awserr.Error for service API and SDK errors. Use runtime type assertions
- // with awserr.Error's Code and Message methods to get detailed information about
- // the error.
- //
- // See the AWS API reference guide for Amazon Elastic File System's
- // API operation UpdateFileSystem for usage and error information.
- //
- // Returned Error Codes:
- // * ErrCodeBadRequest "BadRequest"
- // Returned if the request is malformed or contains an error such as an invalid
- // parameter value or a missing required parameter.
- //
- // * ErrCodeFileSystemNotFound "FileSystemNotFound"
- // Returned if the specified FileSystemId value doesn't exist in the requester's
- // AWS account.
- //
- // * ErrCodeIncorrectFileSystemLifeCycleState "IncorrectFileSystemLifeCycleState"
- // Returned if the file system's lifecycle state is not "available".
- //
- // * ErrCodeInsufficientThroughputCapacity "InsufficientThroughputCapacity"
- // Returned if there's not enough capacity to provision additional throughput.
- // This value might be returned when you try to create a file system in provisioned
- // throughput mode, when you attempt to increase the provisioned throughput
- // of an existing file system, or when you attempt to change an existing file
- // system from bursting to provisioned throughput mode.
- //
- // * ErrCodeInternalServerError "InternalServerError"
- // Returned if an error occurred on the server side.
- //
- // * ErrCodeThroughputLimitExceeded "ThroughputLimitExceeded"
- // Returned if the throughput mode or amount of provisioned throughput can't
- // be changed because the throughput limit of 1024 MiB/s has been reached.
- //
- // * ErrCodeTooManyRequests "TooManyRequests"
- // Returned if you don’t wait at least 24 hours before changing the throughput
- // mode, or decreasing the Provisioned Throughput value.
- //
- // See also, https://docs.aws.amazon.com/goto/WebAPI/elasticfilesystem-2015-02-01/UpdateFileSystem
- func (c *EFS) UpdateFileSystem(input *UpdateFileSystemInput) (*UpdateFileSystemOutput, error) {
- req, out := c.UpdateFileSystemRequest(input)
- return out, req.Send()
- }
- // UpdateFileSystemWithContext is the same as UpdateFileSystem with the addition of
- // the ability to pass a context and additional request options.
- //
- // See UpdateFileSystem for details on how to use this API operation.
- //
- // The context must be non-nil and will be used for request cancellation. If
- // the context is nil a panic will occur. In the future the SDK may create
- // sub-contexts for http.Requests. See https://golang.org/pkg/context/
- // for more information on using Contexts.
- func (c *EFS) UpdateFileSystemWithContext(ctx aws.Context, input *UpdateFileSystemInput, opts ...request.Option) (*UpdateFileSystemOutput, error) {
- req, out := c.UpdateFileSystemRequest(input)
- req.SetContext(ctx)
- req.ApplyOptions(opts...)
- return out, req.Send()
- }
- type CreateFileSystemInput struct {
- _ struct{} `type:"structure"`
- // String of up to 64 ASCII characters. Amazon EFS uses this to ensure idempotent
- // creation.
- //
- // CreationToken is a required field
- CreationToken *string `min:"1" type:"string" required:"true"`
- // A Boolean value that, if true, creates an encrypted file system. When creating
- // an encrypted file system, you have the option of specifying a CreateFileSystemRequest$KmsKeyId
- // for an existing AWS Key Management Service (AWS KMS) customer master key
- // (CMK). If you don't specify a CMK, then the default CMK for Amazon EFS, /aws/elasticfilesystem,
- // is used to protect the encrypted file system.
- Encrypted *bool `type:"boolean"`
- // The ID of the AWS KMS CMK to be used to protect the encrypted file system.
- // This parameter is only required if you want to use a non-default CMK. If
- // this parameter is not specified, the default CMK for Amazon EFS is used.
- // This ID can be in one of the following formats:
- //
- // * Key ID - A unique identifier of the key, for example, 1234abcd-12ab-34cd-56ef-1234567890ab.
- //
- // * ARN - An Amazon Resource Name (ARN) for the key, for example, arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab.
- //
- // * Key alias - A previously created display name for a key. For example,
- // alias/projectKey1.
- //
- // * Key alias ARN - An ARN for a key alias, for example, arn:aws:kms:us-west-2:444455556666:alias/projectKey1.
- //
- // If KmsKeyId is specified, the CreateFileSystemRequest$Encrypted parameter
- // must be set to true.
- KmsKeyId *string `min:"1" type:"string"`
- // The PerformanceMode of the file system. We recommend generalPurpose performance
- // mode for most file systems. File systems using the maxIO performance mode
- // can scale to higher levels of aggregate throughput and operations per second
- // with a tradeoff of slightly higher latencies for most file operations. This
- // can't be changed after the file system has been created.
- PerformanceMode *string `type:"string" enum:"PerformanceMode"`
- // The throughput, measured in MiB/s, that you want to provision for a file
- // system that you're creating. The limit on throughput is 1024 MiB/s. You can
- // get these limits increased by contacting AWS Support. For more information,
- // see Amazon EFS Limits That You Can Increase (http://docs.aws.amazon.com/efs/latest/ug/limits.html#soft-limits)
- // in the Amazon EFS User Guide.
- ProvisionedThroughputInMibps *float64 `type:"double"`
- // The throughput mode for the file system to be created. There are two throughput
- // modes to choose from for your file system: bursting and provisioned. You
- // can decrease your file system's throughput in Provisioned Throughput mode
- // or change between the throughput modes as long as it’s been more than 24
- // hours since the last decrease or throughput mode change.
- ThroughputMode *string `type:"string" enum:"ThroughputMode"`
- }
- // String returns the string representation
- func (s CreateFileSystemInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s CreateFileSystemInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *CreateFileSystemInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "CreateFileSystemInput"}
- if s.CreationToken == nil {
- invalidParams.Add(request.NewErrParamRequired("CreationToken"))
- }
- if s.CreationToken != nil && len(*s.CreationToken) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("CreationToken", 1))
- }
- if s.KmsKeyId != nil && len(*s.KmsKeyId) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("KmsKeyId", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetCreationToken sets the CreationToken field's value.
- func (s *CreateFileSystemInput) SetCreationToken(v string) *CreateFileSystemInput {
- s.CreationToken = &v
- return s
- }
- // SetEncrypted sets the Encrypted field's value.
- func (s *CreateFileSystemInput) SetEncrypted(v bool) *CreateFileSystemInput {
- s.Encrypted = &v
- return s
- }
- // SetKmsKeyId sets the KmsKeyId field's value.
- func (s *CreateFileSystemInput) SetKmsKeyId(v string) *CreateFileSystemInput {
- s.KmsKeyId = &v
- return s
- }
- // SetPerformanceMode sets the PerformanceMode field's value.
- func (s *CreateFileSystemInput) SetPerformanceMode(v string) *CreateFileSystemInput {
- s.PerformanceMode = &v
- return s
- }
- // SetProvisionedThroughputInMibps sets the ProvisionedThroughputInMibps field's value.
- func (s *CreateFileSystemInput) SetProvisionedThroughputInMibps(v float64) *CreateFileSystemInput {
- s.ProvisionedThroughputInMibps = &v
- return s
- }
- // SetThroughputMode sets the ThroughputMode field's value.
- func (s *CreateFileSystemInput) SetThroughputMode(v string) *CreateFileSystemInput {
- s.ThroughputMode = &v
- return s
- }
- type CreateMountTargetInput struct {
- _ struct{} `type:"structure"`
- // ID of the file system for which to create the mount target.
- //
- // FileSystemId is a required field
- FileSystemId *string `type:"string" required:"true"`
- // Valid IPv4 address within the address range of the specified subnet.
- IpAddress *string `type:"string"`
- // Up to five VPC security group IDs, of the form sg-xxxxxxxx. These must be
- // for the same VPC as subnet specified.
- SecurityGroups []*string `type:"list"`
- // ID of the subnet to add the mount target in.
- //
- // SubnetId is a required field
- SubnetId *string `type:"string" required:"true"`
- }
- // String returns the string representation
- func (s CreateMountTargetInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s CreateMountTargetInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *CreateMountTargetInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "CreateMountTargetInput"}
- if s.FileSystemId == nil {
- invalidParams.Add(request.NewErrParamRequired("FileSystemId"))
- }
- if s.SubnetId == nil {
- invalidParams.Add(request.NewErrParamRequired("SubnetId"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetFileSystemId sets the FileSystemId field's value.
- func (s *CreateMountTargetInput) SetFileSystemId(v string) *CreateMountTargetInput {
- s.FileSystemId = &v
- return s
- }
- // SetIpAddress sets the IpAddress field's value.
- func (s *CreateMountTargetInput) SetIpAddress(v string) *CreateMountTargetInput {
- s.IpAddress = &v
- return s
- }
- // SetSecurityGroups sets the SecurityGroups field's value.
- func (s *CreateMountTargetInput) SetSecurityGroups(v []*string) *CreateMountTargetInput {
- s.SecurityGroups = v
- return s
- }
- // SetSubnetId sets the SubnetId field's value.
- func (s *CreateMountTargetInput) SetSubnetId(v string) *CreateMountTargetInput {
- s.SubnetId = &v
- return s
- }
- type CreateTagsInput struct {
- _ struct{} `type:"structure"`
- // ID of the file system whose tags you want to modify (String). This operation
- // modifies the tags only, not the file system.
- //
- // FileSystemId is a required field
- FileSystemId *string `location:"uri" locationName:"FileSystemId" type:"string" required:"true"`
- // Array of Tag objects to add. Each Tag object is a key-value pair.
- //
- // Tags is a required field
- Tags []*Tag `type:"list" required:"true"`
- }
- // String returns the string representation
- func (s CreateTagsInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s CreateTagsInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *CreateTagsInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "CreateTagsInput"}
- if s.FileSystemId == nil {
- invalidParams.Add(request.NewErrParamRequired("FileSystemId"))
- }
- if s.FileSystemId != nil && len(*s.FileSystemId) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("FileSystemId", 1))
- }
- if s.Tags == nil {
- invalidParams.Add(request.NewErrParamRequired("Tags"))
- }
- if s.Tags != nil {
- for i, v := range s.Tags {
- if v == nil {
- continue
- }
- if err := v.Validate(); err != nil {
- invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Tags", i), err.(request.ErrInvalidParams))
- }
- }
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetFileSystemId sets the FileSystemId field's value.
- func (s *CreateTagsInput) SetFileSystemId(v string) *CreateTagsInput {
- s.FileSystemId = &v
- return s
- }
- // SetTags sets the Tags field's value.
- func (s *CreateTagsInput) SetTags(v []*Tag) *CreateTagsInput {
- s.Tags = v
- return s
- }
- type CreateTagsOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation
- func (s CreateTagsOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s CreateTagsOutput) GoString() string {
- return s.String()
- }
- type DeleteFileSystemInput struct {
- _ struct{} `type:"structure"`
- // ID of the file system you want to delete.
- //
- // FileSystemId is a required field
- FileSystemId *string `location:"uri" locationName:"FileSystemId" type:"string" required:"true"`
- }
- // String returns the string representation
- func (s DeleteFileSystemInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s DeleteFileSystemInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *DeleteFileSystemInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "DeleteFileSystemInput"}
- if s.FileSystemId == nil {
- invalidParams.Add(request.NewErrParamRequired("FileSystemId"))
- }
- if s.FileSystemId != nil && len(*s.FileSystemId) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("FileSystemId", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetFileSystemId sets the FileSystemId field's value.
- func (s *DeleteFileSystemInput) SetFileSystemId(v string) *DeleteFileSystemInput {
- s.FileSystemId = &v
- return s
- }
- type DeleteFileSystemOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation
- func (s DeleteFileSystemOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s DeleteFileSystemOutput) GoString() string {
- return s.String()
- }
- type DeleteMountTargetInput struct {
- _ struct{} `type:"structure"`
- // ID of the mount target to delete (String).
- //
- // MountTargetId is a required field
- MountTargetId *string `location:"uri" locationName:"MountTargetId" type:"string" required:"true"`
- }
- // String returns the string representation
- func (s DeleteMountTargetInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s DeleteMountTargetInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *DeleteMountTargetInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "DeleteMountTargetInput"}
- if s.MountTargetId == nil {
- invalidParams.Add(request.NewErrParamRequired("MountTargetId"))
- }
- if s.MountTargetId != nil && len(*s.MountTargetId) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("MountTargetId", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetMountTargetId sets the MountTargetId field's value.
- func (s *DeleteMountTargetInput) SetMountTargetId(v string) *DeleteMountTargetInput {
- s.MountTargetId = &v
- return s
- }
- type DeleteMountTargetOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation
- func (s DeleteMountTargetOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s DeleteMountTargetOutput) GoString() string {
- return s.String()
- }
- type DeleteTagsInput struct {
- _ struct{} `type:"structure"`
- // ID of the file system whose tags you want to delete (String).
- //
- // FileSystemId is a required field
- FileSystemId *string `location:"uri" locationName:"FileSystemId" type:"string" required:"true"`
- // List of tag keys to delete.
- //
- // TagKeys is a required field
- TagKeys []*string `type:"list" required:"true"`
- }
- // String returns the string representation
- func (s DeleteTagsInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s DeleteTagsInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *DeleteTagsInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "DeleteTagsInput"}
- if s.FileSystemId == nil {
- invalidParams.Add(request.NewErrParamRequired("FileSystemId"))
- }
- if s.FileSystemId != nil && len(*s.FileSystemId) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("FileSystemId", 1))
- }
- if s.TagKeys == nil {
- invalidParams.Add(request.NewErrParamRequired("TagKeys"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetFileSystemId sets the FileSystemId field's value.
- func (s *DeleteTagsInput) SetFileSystemId(v string) *DeleteTagsInput {
- s.FileSystemId = &v
- return s
- }
- // SetTagKeys sets the TagKeys field's value.
- func (s *DeleteTagsInput) SetTagKeys(v []*string) *DeleteTagsInput {
- s.TagKeys = v
- return s
- }
- type DeleteTagsOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation
- func (s DeleteTagsOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s DeleteTagsOutput) GoString() string {
- return s.String()
- }
- type DescribeFileSystemsInput struct {
- _ struct{} `type:"structure"`
- // (Optional) Restricts the list to the file system with this creation token
- // (String). You specify a creation token when you create an Amazon EFS file
- // system.
- CreationToken *string `location:"querystring" locationName:"CreationToken" min:"1" type:"string"`
- // (Optional) ID of the file system whose description you want to retrieve (String).
- FileSystemId *string `location:"querystring" locationName:"FileSystemId" type:"string"`
- // (Optional) Opaque pagination token returned from a previous DescribeFileSystems
- // operation (String). If present, specifies to continue the list from where
- // the returning call had left off.
- Marker *string `location:"querystring" locationName:"Marker" type:"string"`
- // (Optional) Specifies the maximum number of file systems to return in the
- // response (integer). This parameter value must be greater than 0. The number
- // of items that Amazon EFS returns is the minimum of the MaxItems parameter
- // specified in the request and the service's internal maximum number of items
- // per page.
- MaxItems *int64 `location:"querystring" locationName:"MaxItems" min:"1" type:"integer"`
- }
- // String returns the string representation
- func (s DescribeFileSystemsInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s DescribeFileSystemsInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *DescribeFileSystemsInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "DescribeFileSystemsInput"}
- if s.CreationToken != nil && len(*s.CreationToken) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("CreationToken", 1))
- }
- if s.MaxItems != nil && *s.MaxItems < 1 {
- invalidParams.Add(request.NewErrParamMinValue("MaxItems", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetCreationToken sets the CreationToken field's value.
- func (s *DescribeFileSystemsInput) SetCreationToken(v string) *DescribeFileSystemsInput {
- s.CreationToken = &v
- return s
- }
- // SetFileSystemId sets the FileSystemId field's value.
- func (s *DescribeFileSystemsInput) SetFileSystemId(v string) *DescribeFileSystemsInput {
- s.FileSystemId = &v
- return s
- }
- // SetMarker sets the Marker field's value.
- func (s *DescribeFileSystemsInput) SetMarker(v string) *DescribeFileSystemsInput {
- s.Marker = &v
- return s
- }
- // SetMaxItems sets the MaxItems field's value.
- func (s *DescribeFileSystemsInput) SetMaxItems(v int64) *DescribeFileSystemsInput {
- s.MaxItems = &v
- return s
- }
- type DescribeFileSystemsOutput struct {
- _ struct{} `type:"structure"`
- // Array of file system descriptions.
- FileSystems []*FileSystemDescription `type:"list"`
- // Present if provided by caller in the request (String).
- Marker *string `type:"string"`
- // Present if there are more file systems than returned in the response (String).
- // You can use the NextMarker in the subsequent request to fetch the descriptions.
- NextMarker *string `type:"string"`
- }
- // String returns the string representation
- func (s DescribeFileSystemsOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s DescribeFileSystemsOutput) GoString() string {
- return s.String()
- }
- // SetFileSystems sets the FileSystems field's value.
- func (s *DescribeFileSystemsOutput) SetFileSystems(v []*FileSystemDescription) *DescribeFileSystemsOutput {
- s.FileSystems = v
- return s
- }
- // SetMarker sets the Marker field's value.
- func (s *DescribeFileSystemsOutput) SetMarker(v string) *DescribeFileSystemsOutput {
- s.Marker = &v
- return s
- }
- // SetNextMarker sets the NextMarker field's value.
- func (s *DescribeFileSystemsOutput) SetNextMarker(v string) *DescribeFileSystemsOutput {
- s.NextMarker = &v
- return s
- }
- type DescribeMountTargetSecurityGroupsInput struct {
- _ struct{} `type:"structure"`
- // ID of the mount target whose security groups you want to retrieve.
- //
- // MountTargetId is a required field
- MountTargetId *string `location:"uri" locationName:"MountTargetId" type:"string" required:"true"`
- }
- // String returns the string representation
- func (s DescribeMountTargetSecurityGroupsInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s DescribeMountTargetSecurityGroupsInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *DescribeMountTargetSecurityGroupsInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "DescribeMountTargetSecurityGroupsInput"}
- if s.MountTargetId == nil {
- invalidParams.Add(request.NewErrParamRequired("MountTargetId"))
- }
- if s.MountTargetId != nil && len(*s.MountTargetId) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("MountTargetId", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetMountTargetId sets the MountTargetId field's value.
- func (s *DescribeMountTargetSecurityGroupsInput) SetMountTargetId(v string) *DescribeMountTargetSecurityGroupsInput {
- s.MountTargetId = &v
- return s
- }
- type DescribeMountTargetSecurityGroupsOutput struct {
- _ struct{} `type:"structure"`
- // Array of security groups.
- //
- // SecurityGroups is a required field
- SecurityGroups []*string `type:"list" required:"true"`
- }
- // String returns the string representation
- func (s DescribeMountTargetSecurityGroupsOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s DescribeMountTargetSecurityGroupsOutput) GoString() string {
- return s.String()
- }
- // SetSecurityGroups sets the SecurityGroups field's value.
- func (s *DescribeMountTargetSecurityGroupsOutput) SetSecurityGroups(v []*string) *DescribeMountTargetSecurityGroupsOutput {
- s.SecurityGroups = v
- return s
- }
- type DescribeMountTargetsInput struct {
- _ struct{} `type:"structure"`
- // (Optional) ID of the file system whose mount targets you want to list (String).
- // It must be included in your request if MountTargetId is not included.
- FileSystemId *string `location:"querystring" locationName:"FileSystemId" type:"string"`
- // (Optional) Opaque pagination token returned from a previous DescribeMountTargets
- // operation (String). If present, it specifies to continue the list from where
- // the previous returning call left off.
- Marker *string `location:"querystring" locationName:"Marker" type:"string"`
- // (Optional) Maximum number of mount targets to return in the response. It
- // must be an integer with a value greater than zero.
- MaxItems *int64 `location:"querystring" locationName:"MaxItems" min:"1" type:"integer"`
- // (Optional) ID of the mount target that you want to have described (String).
- // It must be included in your request if FileSystemId is not included.
- MountTargetId *string `location:"querystring" locationName:"MountTargetId" type:"string"`
- }
- // String returns the string representation
- func (s DescribeMountTargetsInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s DescribeMountTargetsInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *DescribeMountTargetsInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "DescribeMountTargetsInput"}
- if s.MaxItems != nil && *s.MaxItems < 1 {
- invalidParams.Add(request.NewErrParamMinValue("MaxItems", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetFileSystemId sets the FileSystemId field's value.
- func (s *DescribeMountTargetsInput) SetFileSystemId(v string) *DescribeMountTargetsInput {
- s.FileSystemId = &v
- return s
- }
- // SetMarker sets the Marker field's value.
- func (s *DescribeMountTargetsInput) SetMarker(v string) *DescribeMountTargetsInput {
- s.Marker = &v
- return s
- }
- // SetMaxItems sets the MaxItems field's value.
- func (s *DescribeMountTargetsInput) SetMaxItems(v int64) *DescribeMountTargetsInput {
- s.MaxItems = &v
- return s
- }
- // SetMountTargetId sets the MountTargetId field's value.
- func (s *DescribeMountTargetsInput) SetMountTargetId(v string) *DescribeMountTargetsInput {
- s.MountTargetId = &v
- return s
- }
- type DescribeMountTargetsOutput struct {
- _ struct{} `type:"structure"`
- // If the request included the Marker, the response returns that value in this
- // field.
- Marker *string `type:"string"`
- // Returns the file system's mount targets as an array of MountTargetDescription
- // objects.
- MountTargets []*MountTargetDescription `type:"list"`
- // If a value is present, there are more mount targets to return. In a subsequent
- // request, you can provide Marker in your request with this value to retrieve
- // the next set of mount targets.
- NextMarker *string `type:"string"`
- }
- // String returns the string representation
- func (s DescribeMountTargetsOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s DescribeMountTargetsOutput) GoString() string {
- return s.String()
- }
- // SetMarker sets the Marker field's value.
- func (s *DescribeMountTargetsOutput) SetMarker(v string) *DescribeMountTargetsOutput {
- s.Marker = &v
- return s
- }
- // SetMountTargets sets the MountTargets field's value.
- func (s *DescribeMountTargetsOutput) SetMountTargets(v []*MountTargetDescription) *DescribeMountTargetsOutput {
- s.MountTargets = v
- return s
- }
- // SetNextMarker sets the NextMarker field's value.
- func (s *DescribeMountTargetsOutput) SetNextMarker(v string) *DescribeMountTargetsOutput {
- s.NextMarker = &v
- return s
- }
- type DescribeTagsInput struct {
- _ struct{} `type:"structure"`
- // ID of the file system whose tag set you want to retrieve.
- //
- // FileSystemId is a required field
- FileSystemId *string `location:"uri" locationName:"FileSystemId" type:"string" required:"true"`
- // (Optional) Opaque pagination token returned from a previous DescribeTags
- // operation (String). If present, it specifies to continue the list from where
- // the previous call left off.
- Marker *string `location:"querystring" locationName:"Marker" type:"string"`
- // (Optional) Maximum number of file system tags to return in the response.
- // It must be an integer with a value greater than zero.
- MaxItems *int64 `location:"querystring" locationName:"MaxItems" min:"1" type:"integer"`
- }
- // String returns the string representation
- func (s DescribeTagsInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s DescribeTagsInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *DescribeTagsInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "DescribeTagsInput"}
- if s.FileSystemId == nil {
- invalidParams.Add(request.NewErrParamRequired("FileSystemId"))
- }
- if s.FileSystemId != nil && len(*s.FileSystemId) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("FileSystemId", 1))
- }
- if s.MaxItems != nil && *s.MaxItems < 1 {
- invalidParams.Add(request.NewErrParamMinValue("MaxItems", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetFileSystemId sets the FileSystemId field's value.
- func (s *DescribeTagsInput) SetFileSystemId(v string) *DescribeTagsInput {
- s.FileSystemId = &v
- return s
- }
- // SetMarker sets the Marker field's value.
- func (s *DescribeTagsInput) SetMarker(v string) *DescribeTagsInput {
- s.Marker = &v
- return s
- }
- // SetMaxItems sets the MaxItems field's value.
- func (s *DescribeTagsInput) SetMaxItems(v int64) *DescribeTagsInput {
- s.MaxItems = &v
- return s
- }
- type DescribeTagsOutput struct {
- _ struct{} `type:"structure"`
- // If the request included a Marker, the response returns that value in this
- // field.
- Marker *string `type:"string"`
- // If a value is present, there are more tags to return. In a subsequent request,
- // you can provide the value of NextMarker as the value of the Marker parameter
- // in your next request to retrieve the next set of tags.
- NextMarker *string `type:"string"`
- // Returns tags associated with the file system as an array of Tag objects.
- //
- // Tags is a required field
- Tags []*Tag `type:"list" required:"true"`
- }
- // String returns the string representation
- func (s DescribeTagsOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s DescribeTagsOutput) GoString() string {
- return s.String()
- }
- // SetMarker sets the Marker field's value.
- func (s *DescribeTagsOutput) SetMarker(v string) *DescribeTagsOutput {
- s.Marker = &v
- return s
- }
- // SetNextMarker sets the NextMarker field's value.
- func (s *DescribeTagsOutput) SetNextMarker(v string) *DescribeTagsOutput {
- s.NextMarker = &v
- return s
- }
- // SetTags sets the Tags field's value.
- func (s *DescribeTagsOutput) SetTags(v []*Tag) *DescribeTagsOutput {
- s.Tags = v
- return s
- }
- // Description of the file system.
- type FileSystemDescription struct {
- _ struct{} `type:"structure"`
- // Time that the file system was created, in seconds (since 1970-01-01T00:00:00Z).
- //
- // CreationTime is a required field
- CreationTime *time.Time `type:"timestamp" required:"true"`
- // Opaque string specified in the request.
- //
- // CreationToken is a required field
- CreationToken *string `min:"1" type:"string" required:"true"`
- // A Boolean value that, if true, indicates that the file system is encrypted.
- Encrypted *bool `type:"boolean"`
- // ID of the file system, assigned by Amazon EFS.
- //
- // FileSystemId is a required field
- FileSystemId *string `type:"string" required:"true"`
- // The ID of an AWS Key Management Service (AWS KMS) customer master key (CMK)
- // that was used to protect the encrypted file system.
- KmsKeyId *string `min:"1" type:"string"`
- // Lifecycle phase of the file system.
- //
- // LifeCycleState is a required field
- LifeCycleState *string `type:"string" required:"true" enum:"LifeCycleState"`
- // You can add tags to a file system, including a Name tag. For more information,
- // see CreateTags. If the file system has a Name tag, Amazon EFS returns the
- // value in this field.
- Name *string `type:"string"`
- // Current number of mount targets that the file system has. For more information,
- // see CreateMountTarget.
- //
- // NumberOfMountTargets is a required field
- NumberOfMountTargets *int64 `type:"integer" required:"true"`
- // AWS account that created the file system. If the file system was created
- // by an IAM user, the parent account to which the user belongs is the owner.
- //
- // OwnerId is a required field
- OwnerId *string `type:"string" required:"true"`
- // The PerformanceMode of the file system.
- //
- // PerformanceMode is a required field
- PerformanceMode *string `type:"string" required:"true" enum:"PerformanceMode"`
- // The throughput, measured in MiB/s, that you want to provision for a file
- // system. The limit on throughput is 1024 MiB/s. You can get these limits increased
- // by contacting AWS Support. For more information, see Amazon EFS Limits That
- // You Can Increase (http://docs.aws.amazon.com/efs/latest/ug/limits.html#soft-limits)
- // in the Amazon EFS User Guide.
- ProvisionedThroughputInMibps *float64 `type:"double"`
- // Latest known metered size (in bytes) of data stored in the file system, in
- // its Value field, and the time at which that size was determined in its Timestamp
- // field. The Timestamp value is the integer number of seconds since 1970-01-01T00:00:00Z.
- // The SizeInBytes value doesn't represent the size of a consistent snapshot
- // of the file system, but it is eventually consistent when there are no writes
- // to the file system. That is, SizeInBytes represents actual size only if the
- // file system is not modified for a period longer than a couple of hours. Otherwise,
- // the value is not the exact size that the file system was at any point in
- // time.
- //
- // SizeInBytes is a required field
- SizeInBytes *FileSystemSize `type:"structure" required:"true"`
- // The throughput mode for a file system. There are two throughput modes to
- // choose from for your file system: bursting and provisioned. You can decrease
- // your file system's throughput in Provisioned Throughput mode or change between
- // the throughput modes as long as it’s been more than 24 hours since the last
- // decrease or throughput mode change.
- ThroughputMode *string `type:"string" enum:"ThroughputMode"`
- }
- // String returns the string representation
- func (s FileSystemDescription) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s FileSystemDescription) GoString() string {
- return s.String()
- }
- // SetCreationTime sets the CreationTime field's value.
- func (s *FileSystemDescription) SetCreationTime(v time.Time) *FileSystemDescription {
- s.CreationTime = &v
- return s
- }
- // SetCreationToken sets the CreationToken field's value.
- func (s *FileSystemDescription) SetCreationToken(v string) *FileSystemDescription {
- s.CreationToken = &v
- return s
- }
- // SetEncrypted sets the Encrypted field's value.
- func (s *FileSystemDescription) SetEncrypted(v bool) *FileSystemDescription {
- s.Encrypted = &v
- return s
- }
- // SetFileSystemId sets the FileSystemId field's value.
- func (s *FileSystemDescription) SetFileSystemId(v string) *FileSystemDescription {
- s.FileSystemId = &v
- return s
- }
- // SetKmsKeyId sets the KmsKeyId field's value.
- func (s *FileSystemDescription) SetKmsKeyId(v string) *FileSystemDescription {
- s.KmsKeyId = &v
- return s
- }
- // SetLifeCycleState sets the LifeCycleState field's value.
- func (s *FileSystemDescription) SetLifeCycleState(v string) *FileSystemDescription {
- s.LifeCycleState = &v
- return s
- }
- // SetName sets the Name field's value.
- func (s *FileSystemDescription) SetName(v string) *FileSystemDescription {
- s.Name = &v
- return s
- }
- // SetNumberOfMountTargets sets the NumberOfMountTargets field's value.
- func (s *FileSystemDescription) SetNumberOfMountTargets(v int64) *FileSystemDescription {
- s.NumberOfMountTargets = &v
- return s
- }
- // SetOwnerId sets the OwnerId field's value.
- func (s *FileSystemDescription) SetOwnerId(v string) *FileSystemDescription {
- s.OwnerId = &v
- return s
- }
- // SetPerformanceMode sets the PerformanceMode field's value.
- func (s *FileSystemDescription) SetPerformanceMode(v string) *FileSystemDescription {
- s.PerformanceMode = &v
- return s
- }
- // SetProvisionedThroughputInMibps sets the ProvisionedThroughputInMibps field's value.
- func (s *FileSystemDescription) SetProvisionedThroughputInMibps(v float64) *FileSystemDescription {
- s.ProvisionedThroughputInMibps = &v
- return s
- }
- // SetSizeInBytes sets the SizeInBytes field's value.
- func (s *FileSystemDescription) SetSizeInBytes(v *FileSystemSize) *FileSystemDescription {
- s.SizeInBytes = v
- return s
- }
- // SetThroughputMode sets the ThroughputMode field's value.
- func (s *FileSystemDescription) SetThroughputMode(v string) *FileSystemDescription {
- s.ThroughputMode = &v
- return s
- }
- // Latest known metered size (in bytes) of data stored in the file system, in
- // its Value field, and the time at which that size was determined in its Timestamp
- // field. Note that the value does not represent the size of a consistent snapshot
- // of the file system, but it is eventually consistent when there are no writes
- // to the file system. That is, the value will represent the actual size only
- // if the file system is not modified for a period longer than a couple of hours.
- // Otherwise, the value is not necessarily the exact size the file system was
- // at any instant in time.
- type FileSystemSize struct {
- _ struct{} `type:"structure"`
- // Time at which the size of data, returned in the Value field, was determined.
- // The value is the integer number of seconds since 1970-01-01T00:00:00Z.
- Timestamp *time.Time `type:"timestamp"`
- // Latest known metered size (in bytes) of data stored in the file system.
- //
- // Value is a required field
- Value *int64 `type:"long" required:"true"`
- }
- // String returns the string representation
- func (s FileSystemSize) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s FileSystemSize) GoString() string {
- return s.String()
- }
- // SetTimestamp sets the Timestamp field's value.
- func (s *FileSystemSize) SetTimestamp(v time.Time) *FileSystemSize {
- s.Timestamp = &v
- return s
- }
- // SetValue sets the Value field's value.
- func (s *FileSystemSize) SetValue(v int64) *FileSystemSize {
- s.Value = &v
- return s
- }
- type ModifyMountTargetSecurityGroupsInput struct {
- _ struct{} `type:"structure"`
- // ID of the mount target whose security groups you want to modify.
- //
- // MountTargetId is a required field
- MountTargetId *string `location:"uri" locationName:"MountTargetId" type:"string" required:"true"`
- // Array of up to five VPC security group IDs.
- SecurityGroups []*string `type:"list"`
- }
- // String returns the string representation
- func (s ModifyMountTargetSecurityGroupsInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s ModifyMountTargetSecurityGroupsInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *ModifyMountTargetSecurityGroupsInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "ModifyMountTargetSecurityGroupsInput"}
- if s.MountTargetId == nil {
- invalidParams.Add(request.NewErrParamRequired("MountTargetId"))
- }
- if s.MountTargetId != nil && len(*s.MountTargetId) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("MountTargetId", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetMountTargetId sets the MountTargetId field's value.
- func (s *ModifyMountTargetSecurityGroupsInput) SetMountTargetId(v string) *ModifyMountTargetSecurityGroupsInput {
- s.MountTargetId = &v
- return s
- }
- // SetSecurityGroups sets the SecurityGroups field's value.
- func (s *ModifyMountTargetSecurityGroupsInput) SetSecurityGroups(v []*string) *ModifyMountTargetSecurityGroupsInput {
- s.SecurityGroups = v
- return s
- }
- type ModifyMountTargetSecurityGroupsOutput struct {
- _ struct{} `type:"structure"`
- }
- // String returns the string representation
- func (s ModifyMountTargetSecurityGroupsOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s ModifyMountTargetSecurityGroupsOutput) GoString() string {
- return s.String()
- }
- // Provides a description of a mount target.
- type MountTargetDescription struct {
- _ struct{} `type:"structure"`
- // ID of the file system for which the mount target is intended.
- //
- // FileSystemId is a required field
- FileSystemId *string `type:"string" required:"true"`
- // Address at which the file system may be mounted via the mount target.
- IpAddress *string `type:"string"`
- // Lifecycle state of the mount target.
- //
- // LifeCycleState is a required field
- LifeCycleState *string `type:"string" required:"true" enum:"LifeCycleState"`
- // System-assigned mount target ID.
- //
- // MountTargetId is a required field
- MountTargetId *string `type:"string" required:"true"`
- // ID of the network interface that Amazon EFS created when it created the mount
- // target.
- NetworkInterfaceId *string `type:"string"`
- // AWS account ID that owns the resource.
- OwnerId *string `type:"string"`
- // ID of the mount target's subnet.
- //
- // SubnetId is a required field
- SubnetId *string `type:"string" required:"true"`
- }
- // String returns the string representation
- func (s MountTargetDescription) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s MountTargetDescription) GoString() string {
- return s.String()
- }
- // SetFileSystemId sets the FileSystemId field's value.
- func (s *MountTargetDescription) SetFileSystemId(v string) *MountTargetDescription {
- s.FileSystemId = &v
- return s
- }
- // SetIpAddress sets the IpAddress field's value.
- func (s *MountTargetDescription) SetIpAddress(v string) *MountTargetDescription {
- s.IpAddress = &v
- return s
- }
- // SetLifeCycleState sets the LifeCycleState field's value.
- func (s *MountTargetDescription) SetLifeCycleState(v string) *MountTargetDescription {
- s.LifeCycleState = &v
- return s
- }
- // SetMountTargetId sets the MountTargetId field's value.
- func (s *MountTargetDescription) SetMountTargetId(v string) *MountTargetDescription {
- s.MountTargetId = &v
- return s
- }
- // SetNetworkInterfaceId sets the NetworkInterfaceId field's value.
- func (s *MountTargetDescription) SetNetworkInterfaceId(v string) *MountTargetDescription {
- s.NetworkInterfaceId = &v
- return s
- }
- // SetOwnerId sets the OwnerId field's value.
- func (s *MountTargetDescription) SetOwnerId(v string) *MountTargetDescription {
- s.OwnerId = &v
- return s
- }
- // SetSubnetId sets the SubnetId field's value.
- func (s *MountTargetDescription) SetSubnetId(v string) *MountTargetDescription {
- s.SubnetId = &v
- return s
- }
- // A tag is a key-value pair. Allowed characters: letters, whitespace, and numbers,
- // representable in UTF-8, and the following characters: + - = . _ : /
- type Tag struct {
- _ struct{} `type:"structure"`
- // Tag key (String). The key can't start with aws:.
- //
- // Key is a required field
- Key *string `min:"1" type:"string" required:"true"`
- // Value of the tag key.
- //
- // Value is a required field
- Value *string `type:"string" required:"true"`
- }
- // String returns the string representation
- func (s Tag) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s Tag) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *Tag) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "Tag"}
- if s.Key == nil {
- invalidParams.Add(request.NewErrParamRequired("Key"))
- }
- if s.Key != nil && len(*s.Key) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("Key", 1))
- }
- if s.Value == nil {
- invalidParams.Add(request.NewErrParamRequired("Value"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetKey sets the Key field's value.
- func (s *Tag) SetKey(v string) *Tag {
- s.Key = &v
- return s
- }
- // SetValue sets the Value field's value.
- func (s *Tag) SetValue(v string) *Tag {
- s.Value = &v
- return s
- }
- type UpdateFileSystemInput struct {
- _ struct{} `type:"structure"`
- // The ID of the file system that you want to update.
- //
- // FileSystemId is a required field
- FileSystemId *string `location:"uri" locationName:"FileSystemId" type:"string" required:"true"`
- // (Optional) The amount of throughput, in MiB/s, that you want to provision
- // for your file system. If you're not updating the amount of provisioned throughput
- // for your file system, you don't need to provide this value in your request.
- ProvisionedThroughputInMibps *float64 `type:"double"`
- // (Optional) The throughput mode that you want your file system to use. If
- // you're not updating your throughput mode, you don't need to provide this
- // value in your request.
- ThroughputMode *string `type:"string" enum:"ThroughputMode"`
- }
- // String returns the string representation
- func (s UpdateFileSystemInput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s UpdateFileSystemInput) GoString() string {
- return s.String()
- }
- // Validate inspects the fields of the type to determine if they are valid.
- func (s *UpdateFileSystemInput) Validate() error {
- invalidParams := request.ErrInvalidParams{Context: "UpdateFileSystemInput"}
- if s.FileSystemId == nil {
- invalidParams.Add(request.NewErrParamRequired("FileSystemId"))
- }
- if s.FileSystemId != nil && len(*s.FileSystemId) < 1 {
- invalidParams.Add(request.NewErrParamMinLen("FileSystemId", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- // SetFileSystemId sets the FileSystemId field's value.
- func (s *UpdateFileSystemInput) SetFileSystemId(v string) *UpdateFileSystemInput {
- s.FileSystemId = &v
- return s
- }
- // SetProvisionedThroughputInMibps sets the ProvisionedThroughputInMibps field's value.
- func (s *UpdateFileSystemInput) SetProvisionedThroughputInMibps(v float64) *UpdateFileSystemInput {
- s.ProvisionedThroughputInMibps = &v
- return s
- }
- // SetThroughputMode sets the ThroughputMode field's value.
- func (s *UpdateFileSystemInput) SetThroughputMode(v string) *UpdateFileSystemInput {
- s.ThroughputMode = &v
- return s
- }
- // Description of the file system.
- type UpdateFileSystemOutput struct {
- _ struct{} `type:"structure"`
- // Time that the file system was created, in seconds (since 1970-01-01T00:00:00Z).
- //
- // CreationTime is a required field
- CreationTime *time.Time `type:"timestamp" required:"true"`
- // Opaque string specified in the request.
- //
- // CreationToken is a required field
- CreationToken *string `min:"1" type:"string" required:"true"`
- // A Boolean value that, if true, indicates that the file system is encrypted.
- Encrypted *bool `type:"boolean"`
- // ID of the file system, assigned by Amazon EFS.
- //
- // FileSystemId is a required field
- FileSystemId *string `type:"string" required:"true"`
- // The ID of an AWS Key Management Service (AWS KMS) customer master key (CMK)
- // that was used to protect the encrypted file system.
- KmsKeyId *string `min:"1" type:"string"`
- // Lifecycle phase of the file system.
- //
- // LifeCycleState is a required field
- LifeCycleState *string `type:"string" required:"true" enum:"LifeCycleState"`
- // You can add tags to a file system, including a Name tag. For more information,
- // see CreateTags. If the file system has a Name tag, Amazon EFS returns the
- // value in this field.
- Name *string `type:"string"`
- // Current number of mount targets that the file system has. For more information,
- // see CreateMountTarget.
- //
- // NumberOfMountTargets is a required field
- NumberOfMountTargets *int64 `type:"integer" required:"true"`
- // AWS account that created the file system. If the file system was created
- // by an IAM user, the parent account to which the user belongs is the owner.
- //
- // OwnerId is a required field
- OwnerId *string `type:"string" required:"true"`
- // The PerformanceMode of the file system.
- //
- // PerformanceMode is a required field
- PerformanceMode *string `type:"string" required:"true" enum:"PerformanceMode"`
- // The throughput, measured in MiB/s, that you want to provision for a file
- // system. The limit on throughput is 1024 MiB/s. You can get these limits increased
- // by contacting AWS Support. For more information, see Amazon EFS Limits That
- // You Can Increase (http://docs.aws.amazon.com/efs/latest/ug/limits.html#soft-limits)
- // in the Amazon EFS User Guide.
- ProvisionedThroughputInMibps *float64 `type:"double"`
- // Latest known metered size (in bytes) of data stored in the file system, in
- // its Value field, and the time at which that size was determined in its Timestamp
- // field. The Timestamp value is the integer number of seconds since 1970-01-01T00:00:00Z.
- // The SizeInBytes value doesn't represent the size of a consistent snapshot
- // of the file system, but it is eventually consistent when there are no writes
- // to the file system. That is, SizeInBytes represents actual size only if the
- // file system is not modified for a period longer than a couple of hours. Otherwise,
- // the value is not the exact size that the file system was at any point in
- // time.
- //
- // SizeInBytes is a required field
- SizeInBytes *FileSystemSize `type:"structure" required:"true"`
- // The throughput mode for a file system. There are two throughput modes to
- // choose from for your file system: bursting and provisioned. You can decrease
- // your file system's throughput in Provisioned Throughput mode or change between
- // the throughput modes as long as it’s been more than 24 hours since the last
- // decrease or throughput mode change.
- ThroughputMode *string `type:"string" enum:"ThroughputMode"`
- }
- // String returns the string representation
- func (s UpdateFileSystemOutput) String() string {
- return awsutil.Prettify(s)
- }
- // GoString returns the string representation
- func (s UpdateFileSystemOutput) GoString() string {
- return s.String()
- }
- // SetCreationTime sets the CreationTime field's value.
- func (s *UpdateFileSystemOutput) SetCreationTime(v time.Time) *UpdateFileSystemOutput {
- s.CreationTime = &v
- return s
- }
- // SetCreationToken sets the CreationToken field's value.
- func (s *UpdateFileSystemOutput) SetCreationToken(v string) *UpdateFileSystemOutput {
- s.CreationToken = &v
- return s
- }
- // SetEncrypted sets the Encrypted field's value.
- func (s *UpdateFileSystemOutput) SetEncrypted(v bool) *UpdateFileSystemOutput {
- s.Encrypted = &v
- return s
- }
- // SetFileSystemId sets the FileSystemId field's value.
- func (s *UpdateFileSystemOutput) SetFileSystemId(v string) *UpdateFileSystemOutput {
- s.FileSystemId = &v
- return s
- }
- // SetKmsKeyId sets the KmsKeyId field's value.
- func (s *UpdateFileSystemOutput) SetKmsKeyId(v string) *UpdateFileSystemOutput {
- s.KmsKeyId = &v
- return s
- }
- // SetLifeCycleState sets the LifeCycleState field's value.
- func (s *UpdateFileSystemOutput) SetLifeCycleState(v string) *UpdateFileSystemOutput {
- s.LifeCycleState = &v
- return s
- }
- // SetName sets the Name field's value.
- func (s *UpdateFileSystemOutput) SetName(v string) *UpdateFileSystemOutput {
- s.Name = &v
- return s
- }
- // SetNumberOfMountTargets sets the NumberOfMountTargets field's value.
- func (s *UpdateFileSystemOutput) SetNumberOfMountTargets(v int64) *UpdateFileSystemOutput {
- s.NumberOfMountTargets = &v
- return s
- }
- // SetOwnerId sets the OwnerId field's value.
- func (s *UpdateFileSystemOutput) SetOwnerId(v string) *UpdateFileSystemOutput {
- s.OwnerId = &v
- return s
- }
- // SetPerformanceMode sets the PerformanceMode field's value.
- func (s *UpdateFileSystemOutput) SetPerformanceMode(v string) *UpdateFileSystemOutput {
- s.PerformanceMode = &v
- return s
- }
- // SetProvisionedThroughputInMibps sets the ProvisionedThroughputInMibps field's value.
- func (s *UpdateFileSystemOutput) SetProvisionedThroughputInMibps(v float64) *UpdateFileSystemOutput {
- s.ProvisionedThroughputInMibps = &v
- return s
- }
- // SetSizeInBytes sets the SizeInBytes field's value.
- func (s *UpdateFileSystemOutput) SetSizeInBytes(v *FileSystemSize) *UpdateFileSystemOutput {
- s.SizeInBytes = v
- return s
- }
- // SetThroughputMode sets the ThroughputMode field's value.
- func (s *UpdateFileSystemOutput) SetThroughputMode(v string) *UpdateFileSystemOutput {
- s.ThroughputMode = &v
- return s
- }
- const (
- // LifeCycleStateCreating is a LifeCycleState enum value
- LifeCycleStateCreating = "creating"
- // LifeCycleStateAvailable is a LifeCycleState enum value
- LifeCycleStateAvailable = "available"
- // LifeCycleStateUpdating is a LifeCycleState enum value
- LifeCycleStateUpdating = "updating"
- // LifeCycleStateDeleting is a LifeCycleState enum value
- LifeCycleStateDeleting = "deleting"
- // LifeCycleStateDeleted is a LifeCycleState enum value
- LifeCycleStateDeleted = "deleted"
- )
- const (
- // PerformanceModeGeneralPurpose is a PerformanceMode enum value
- PerformanceModeGeneralPurpose = "generalPurpose"
- // PerformanceModeMaxIo is a PerformanceMode enum value
- PerformanceModeMaxIo = "maxIO"
- )
- const (
- // ThroughputModeBursting is a ThroughputMode enum value
- ThroughputModeBursting = "bursting"
- // ThroughputModeProvisioned is a ThroughputMode enum value
- ThroughputModeProvisioned = "provisioned"
- )
|