| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575 |
- // THIS FILE IS AUTOMATICALLY GENERATED. DO NOT EDIT.
- // Package efs provides a client for Amazon Elastic File System.
- package efs
- import (
- "fmt"
- "time"
- "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 can be used to capture response data after the request's "Send" method
- // is called.
- //
- // Creating a request object using this method should be used when you want to inject
- // custom logic into the request's lifecycle using a custom handler, or if you want to
- // access properties on the request object before or after sending the request. If
- // you just want the service response, call the CreateFileSystem method directly
- // instead.
- //
- // Note: You must call the "Send" method on the returned request object in order
- // to execute the request.
- //
- // // Example sending a request using the CreateFileSystemRequest method.
- // req, resp := client.CreateFileSystemRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- 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{}
- }
- req = c.newRequest(op, input, output)
- output = &FileSystemDescription{}
- req.Data = output
- return
- }
- // 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.
- func (c *EFS) CreateFileSystem(input *CreateFileSystemInput) (*FileSystemDescription, error) {
- req, out := c.CreateFileSystemRequest(input)
- err := req.Send()
- return out, err
- }
- const opCreateMountTarget = "CreateMountTarget"
- // CreateMountTargetRequest generates a "aws/request.Request" representing the
- // client's request for the CreateMountTarget operation. The "output" return
- // value can be used to capture response data after the request's "Send" method
- // is called.
- //
- // Creating a request object using this method should be used when you want to inject
- // custom logic into the request's lifecycle using a custom handler, or if you want to
- // access properties on the request object before or after sending the request. If
- // you just want the service response, call the CreateMountTarget method directly
- // instead.
- //
- // Note: You must call the "Send" method on the returned request object in order
- // to execute the request.
- //
- // // Example sending a request using the CreateMountTargetRequest method.
- // req, resp := client.CreateMountTargetRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- 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{}
- }
- req = c.newRequest(op, input, output)
- output = &MountTargetDescription{}
- req.Data = output
- return
- }
- // 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 requestor-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 DescribeFileSystems 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
- func (c *EFS) CreateMountTarget(input *CreateMountTargetInput) (*MountTargetDescription, error) {
- req, out := c.CreateMountTargetRequest(input)
- err := req.Send()
- return out, err
- }
- const opCreateTags = "CreateTags"
- // CreateTagsRequest generates a "aws/request.Request" representing the
- // client's request for the CreateTags operation. The "output" return
- // value can be used to capture response data after the request's "Send" method
- // is called.
- //
- // Creating a request object using this method should be used when you want to inject
- // custom logic into the request's lifecycle using a custom handler, or if you want to
- // access properties on the request object before or after sending the request. If
- // you just want the service response, call the CreateTags method directly
- // instead.
- //
- // Note: You must call the "Send" method on the returned request object in order
- // to execute the request.
- //
- // // Example sending a request using the CreateTagsRequest method.
- // req, resp := client.CreateTagsRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- 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{}
- }
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Remove(restjson.UnmarshalHandler)
- req.Handlers.Unmarshal.PushBackNamed(protocol.UnmarshalDiscardBodyHandler)
- output = &CreateTagsOutput{}
- req.Data = output
- return
- }
- // 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.
- func (c *EFS) CreateTags(input *CreateTagsInput) (*CreateTagsOutput, error) {
- req, out := c.CreateTagsRequest(input)
- err := req.Send()
- return out, err
- }
- const opDeleteFileSystem = "DeleteFileSystem"
- // DeleteFileSystemRequest generates a "aws/request.Request" representing the
- // client's request for the DeleteFileSystem operation. The "output" return
- // value can be used to capture response data after the request's "Send" method
- // is called.
- //
- // Creating a request object using this method should be used when you want to inject
- // custom logic into the request's lifecycle using a custom handler, or if you want to
- // access properties on the request object before or after sending the request. If
- // you just want the service response, call the DeleteFileSystem method directly
- // instead.
- //
- // Note: You must call the "Send" method on the returned request object in order
- // to execute the request.
- //
- // // Example sending a request using the DeleteFileSystemRequest method.
- // req, resp := client.DeleteFileSystemRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- 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{}
- }
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Remove(restjson.UnmarshalHandler)
- req.Handlers.Unmarshal.PushBackNamed(protocol.UnmarshalDiscardBodyHandler)
- output = &DeleteFileSystemOutput{}
- req.Data = output
- return
- }
- // 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.
- func (c *EFS) DeleteFileSystem(input *DeleteFileSystemInput) (*DeleteFileSystemOutput, error) {
- req, out := c.DeleteFileSystemRequest(input)
- err := req.Send()
- return out, err
- }
- const opDeleteMountTarget = "DeleteMountTarget"
- // DeleteMountTargetRequest generates a "aws/request.Request" representing the
- // client's request for the DeleteMountTarget operation. The "output" return
- // value can be used to capture response data after the request's "Send" method
- // is called.
- //
- // Creating a request object using this method should be used when you want to inject
- // custom logic into the request's lifecycle using a custom handler, or if you want to
- // access properties on the request object before or after sending the request. If
- // you just want the service response, call the DeleteMountTarget method directly
- // instead.
- //
- // Note: You must call the "Send" method on the returned request object in order
- // to execute the request.
- //
- // // Example sending a request using the DeleteMountTargetRequest method.
- // req, resp := client.DeleteMountTargetRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- 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{}
- }
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Remove(restjson.UnmarshalHandler)
- req.Handlers.Unmarshal.PushBackNamed(protocol.UnmarshalDiscardBodyHandler)
- output = &DeleteMountTargetOutput{}
- req.Data = output
- return
- }
- // 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
- func (c *EFS) DeleteMountTarget(input *DeleteMountTargetInput) (*DeleteMountTargetOutput, error) {
- req, out := c.DeleteMountTargetRequest(input)
- err := req.Send()
- return out, err
- }
- const opDeleteTags = "DeleteTags"
- // DeleteTagsRequest generates a "aws/request.Request" representing the
- // client's request for the DeleteTags operation. The "output" return
- // value can be used to capture response data after the request's "Send" method
- // is called.
- //
- // Creating a request object using this method should be used when you want to inject
- // custom logic into the request's lifecycle using a custom handler, or if you want to
- // access properties on the request object before or after sending the request. If
- // you just want the service response, call the DeleteTags method directly
- // instead.
- //
- // Note: You must call the "Send" method on the returned request object in order
- // to execute the request.
- //
- // // Example sending a request using the DeleteTagsRequest method.
- // req, resp := client.DeleteTagsRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- 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{}
- }
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Remove(restjson.UnmarshalHandler)
- req.Handlers.Unmarshal.PushBackNamed(protocol.UnmarshalDiscardBodyHandler)
- output = &DeleteTagsOutput{}
- req.Data = output
- return
- }
- // 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.
- func (c *EFS) DeleteTags(input *DeleteTagsInput) (*DeleteTagsOutput, error) {
- req, out := c.DeleteTagsRequest(input)
- err := req.Send()
- return out, err
- }
- const opDescribeFileSystems = "DescribeFileSystems"
- // DescribeFileSystemsRequest generates a "aws/request.Request" representing the
- // client's request for the DescribeFileSystems operation. The "output" return
- // value can be used to capture response data after the request's "Send" method
- // is called.
- //
- // Creating a request object using this method should be used when you want to inject
- // custom logic into the request's lifecycle using a custom handler, or if you want to
- // access properties on the request object before or after sending the request. If
- // you just want the service response, call the DescribeFileSystems method directly
- // instead.
- //
- // Note: You must call the "Send" method on the returned request object in order
- // to execute the request.
- //
- // // Example sending a request using the DescribeFileSystemsRequest method.
- // req, resp := client.DescribeFileSystemsRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- 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{}
- }
- req = c.newRequest(op, input, output)
- output = &DescribeFileSystemsOutput{}
- req.Data = output
- return
- }
- // 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.
- func (c *EFS) DescribeFileSystems(input *DescribeFileSystemsInput) (*DescribeFileSystemsOutput, error) {
- req, out := c.DescribeFileSystemsRequest(input)
- err := req.Send()
- return out, err
- }
- const opDescribeMountTargetSecurityGroups = "DescribeMountTargetSecurityGroups"
- // DescribeMountTargetSecurityGroupsRequest generates a "aws/request.Request" representing the
- // client's request for the DescribeMountTargetSecurityGroups operation. The "output" return
- // value can be used to capture response data after the request's "Send" method
- // is called.
- //
- // Creating a request object using this method should be used when you want to inject
- // custom logic into the request's lifecycle using a custom handler, or if you want to
- // access properties on the request object before or after sending the request. If
- // you just want the service response, call the DescribeMountTargetSecurityGroups method directly
- // instead.
- //
- // Note: You must call the "Send" method on the returned request object in order
- // to execute the request.
- //
- // // Example sending a request using the DescribeMountTargetSecurityGroupsRequest method.
- // req, resp := client.DescribeMountTargetSecurityGroupsRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- 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{}
- }
- req = c.newRequest(op, input, output)
- output = &DescribeMountTargetSecurityGroupsOutput{}
- req.Data = output
- return
- }
- // 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.
- func (c *EFS) DescribeMountTargetSecurityGroups(input *DescribeMountTargetSecurityGroupsInput) (*DescribeMountTargetSecurityGroupsOutput, error) {
- req, out := c.DescribeMountTargetSecurityGroupsRequest(input)
- err := req.Send()
- return out, err
- }
- const opDescribeMountTargets = "DescribeMountTargets"
- // DescribeMountTargetsRequest generates a "aws/request.Request" representing the
- // client's request for the DescribeMountTargets operation. The "output" return
- // value can be used to capture response data after the request's "Send" method
- // is called.
- //
- // Creating a request object using this method should be used when you want to inject
- // custom logic into the request's lifecycle using a custom handler, or if you want to
- // access properties on the request object before or after sending the request. If
- // you just want the service response, call the DescribeMountTargets method directly
- // instead.
- //
- // Note: You must call the "Send" method on the returned request object in order
- // to execute the request.
- //
- // // Example sending a request using the DescribeMountTargetsRequest method.
- // req, resp := client.DescribeMountTargetsRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- 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{}
- }
- req = c.newRequest(op, input, output)
- output = &DescribeMountTargetsOutput{}
- req.Data = output
- return
- }
- // 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.
- func (c *EFS) DescribeMountTargets(input *DescribeMountTargetsInput) (*DescribeMountTargetsOutput, error) {
- req, out := c.DescribeMountTargetsRequest(input)
- err := req.Send()
- return out, err
- }
- const opDescribeTags = "DescribeTags"
- // DescribeTagsRequest generates a "aws/request.Request" representing the
- // client's request for the DescribeTags operation. The "output" return
- // value can be used to capture response data after the request's "Send" method
- // is called.
- //
- // Creating a request object using this method should be used when you want to inject
- // custom logic into the request's lifecycle using a custom handler, or if you want to
- // access properties on the request object before or after sending the request. If
- // you just want the service response, call the DescribeTags method directly
- // instead.
- //
- // Note: You must call the "Send" method on the returned request object in order
- // to execute the request.
- //
- // // Example sending a request using the DescribeTagsRequest method.
- // req, resp := client.DescribeTagsRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- 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{}
- }
- req = c.newRequest(op, input, output)
- output = &DescribeTagsOutput{}
- req.Data = output
- return
- }
- // 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.
- func (c *EFS) DescribeTags(input *DescribeTagsInput) (*DescribeTagsOutput, error) {
- req, out := c.DescribeTagsRequest(input)
- err := req.Send()
- return out, err
- }
- const opModifyMountTargetSecurityGroups = "ModifyMountTargetSecurityGroups"
- // ModifyMountTargetSecurityGroupsRequest generates a "aws/request.Request" representing the
- // client's request for the ModifyMountTargetSecurityGroups operation. The "output" return
- // value can be used to capture response data after the request's "Send" method
- // is called.
- //
- // Creating a request object using this method should be used when you want to inject
- // custom logic into the request's lifecycle using a custom handler, or if you want to
- // access properties on the request object before or after sending the request. If
- // you just want the service response, call the ModifyMountTargetSecurityGroups method directly
- // instead.
- //
- // Note: You must call the "Send" method on the returned request object in order
- // to execute the request.
- //
- // // Example sending a request using the ModifyMountTargetSecurityGroupsRequest method.
- // req, resp := client.ModifyMountTargetSecurityGroupsRequest(params)
- //
- // err := req.Send()
- // if err == nil { // resp is now filled
- // fmt.Println(resp)
- // }
- //
- 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{}
- }
- req = c.newRequest(op, input, output)
- req.Handlers.Unmarshal.Remove(restjson.UnmarshalHandler)
- req.Handlers.Unmarshal.PushBackNamed(protocol.UnmarshalDiscardBodyHandler)
- output = &ModifyMountTargetSecurityGroupsOutput{}
- req.Data = output
- return
- }
- // 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.
- func (c *EFS) ModifyMountTargetSecurityGroups(input *ModifyMountTargetSecurityGroupsInput) (*ModifyMountTargetSecurityGroupsOutput, error) {
- req, out := c.ModifyMountTargetSecurityGroupsRequest(input)
- err := req.Send()
- return out, err
- }
- type CreateFileSystemInput struct {
- _ struct{} `type:"structure"`
- // String of up to 64 ASCII characters. Amazon EFS uses this to ensure idempotent
- // creation.
- CreationToken *string `min:"1" type:"string" required:"true"`
- // 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"`
- }
- // 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 invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- type CreateMountTargetInput struct {
- _ struct{} `type:"structure"`
- // ID of the file system for which to create the mount target.
- 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 *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
- }
- 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 *string `location:"uri" locationName:"FileSystemId" type:"string" required:"true"`
- // Array of Tag objects to add. Each Tag object is a key-value pair.
- 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.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
- }
- 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 *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 invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- 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 *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 invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- 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 *string `location:"uri" locationName:"FileSystemId" type:"string" required:"true"`
- // List of tag keys to delete.
- 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.TagKeys == nil {
- invalidParams.Add(request.NewErrParamRequired("TagKeys"))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- 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
- }
- 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()
- }
- type DescribeMountTargetSecurityGroupsInput struct {
- _ struct{} `type:"structure"`
- // ID of the mount target whose security groups you want to retrieve.
- 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 invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- type DescribeMountTargetSecurityGroupsOutput struct {
- _ struct{} `type:"structure"`
- // Array of security groups.
- 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()
- }
- 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
- }
- 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()
- }
- type DescribeTagsInput struct {
- _ struct{} `type:"structure"`
- // ID of the file system whose tag set you want to retrieve.
- 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.MaxItems != nil && *s.MaxItems < 1 {
- invalidParams.Add(request.NewErrParamMinValue("MaxItems", 1))
- }
- if invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- 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 []*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()
- }
- // 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 *time.Time `type:"timestamp" timestampFormat:"unix" required:"true"`
- // Opaque string specified in the request.
- CreationToken *string `min:"1" type:"string" required:"true"`
- // ID of the file system, assigned by Amazon EFS.
- FileSystemId *string `type:"string" required:"true"`
- // Lifecycle phase of the file system.
- 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 *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 *string `type:"string" required:"true"`
- // The PerformanceMode of the file system.
- PerformanceMode *string `type:"string" required:"true" enum:"PerformanceMode"`
- // Latest known metered size (in bytes) of data stored in the file system, in
- // bytes, 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. 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
- // 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 the file system
- // was at any instant in time.
- SizeInBytes *FileSystemSize `type:"structure" required:"true"`
- }
- // 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()
- }
- // 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" timestampFormat:"unix"`
- // Latest known metered size (in bytes) of data stored in the file system.
- 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()
- }
- type ModifyMountTargetSecurityGroupsInput struct {
- _ struct{} `type:"structure"`
- // ID of the mount target whose security groups you want to modify.
- 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 invalidParams.Len() > 0 {
- return invalidParams
- }
- return nil
- }
- 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 *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 *string `type:"string" required:"true" enum:"LifeCycleState"`
- // System-assigned mount target ID.
- 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 *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()
- }
- // 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 *string `min:"1" type:"string" required:"true"`
- // Value of the tag key.
- 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
- }
- const (
- // @enum LifeCycleState
- LifeCycleStateCreating = "creating"
- // @enum LifeCycleState
- LifeCycleStateAvailable = "available"
- // @enum LifeCycleState
- LifeCycleStateDeleting = "deleting"
- // @enum LifeCycleState
- LifeCycleStateDeleted = "deleted"
- )
- const (
- // @enum PerformanceMode
- PerformanceModeGeneralPurpose = "generalPurpose"
- // @enum PerformanceMode
- PerformanceModeMaxIo = "maxIO"
- )
|