{"id":26129507,"url":"https://github.com/mathworks-ref-arch/matlab-aws-s3","last_synced_at":"2025-04-13T18:42:39.689Z","repository":{"id":55643641,"uuid":"160401639","full_name":"mathworks-ref-arch/matlab-aws-s3","owner":"mathworks-ref-arch","description":"MATLAB interface for AWS S3.","archived":false,"fork":false,"pushed_at":"2024-01-10T11:27:57.000Z","size":264,"stargazers_count":4,"open_issues_count":3,"forks_count":1,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-03-10T19:55:15.542Z","etag":null,"topics":["matlab-aws"],"latest_commit_sha":null,"homepage":"","language":"MATLAB","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mathworks-ref-arch.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-12-04T18:30:00.000Z","updated_at":"2023-12-12T13:04:28.000Z","dependencies_parsed_at":"2024-01-10T12:49:34.478Z","dependency_job_id":null,"html_url":"https://github.com/mathworks-ref-arch/matlab-aws-s3","commit_stats":null,"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mathworks-ref-arch%2Fmatlab-aws-s3","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mathworks-ref-arch%2Fmatlab-aws-s3/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mathworks-ref-arch%2Fmatlab-aws-s3/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mathworks-ref-arch%2Fmatlab-aws-s3/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mathworks-ref-arch","download_url":"https://codeload.github.com/mathworks-ref-arch/matlab-aws-s3/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248764957,"owners_count":21158193,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["matlab-aws"],"created_at":"2025-03-10T19:49:13.486Z","updated_at":"2025-04-13T18:42:39.657Z","avatar_url":"https://github.com/mathworks-ref-arch.png","language":"MATLAB","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MATLAB® Interface *for Amazon S3™*\n\nThis is a MATLAB® interface for the Amazon S3™ service. This is a low-level interface. MATLAB IO operations increasingly support access to S3 via a higher-level interface, e.g. the ```dir``` command supports accessing remote data; [https://www.mathworks.com/help/matlab/ref/dir.html](https://www.mathworks.com/help/matlab/ref/dir.html), [https://www.mathworks.com/help/matlab/import_export/work-with-remote-data.html](https://www.mathworks.com/help/matlab/import_export/work-with-remote-data.html). Where MATLAB's higher-level interface supports the required operations it is recommended to use that.\n\n## Requirements\n\n### MathWorks products\n\n* Requires MATLAB release R2017a or later.\n* AWS Common utilities found at https://github.com/mathworks-ref-arch/matlab-aws-common\n\n### 3rd party products\n\n* Amazon Web Services account\n\nTo build a required JAR file:\n\n* [Maven](https://maven.apache.org/)\n* JDK 7 or later\n* [AWS SDK for Java](https://aws.amazon.com/sdk-for-java/) (version 1.12.501 or later)\n\n## Getting Started\n\nPlease refer to the [Documentation](Documentation/README.md) to get started.\nThe [Installation Instructions](Documentation/Installation.md) and [Getting Started](Documentation/GettingStarted.md) documents provide detailed instructions on setting up and using the interface. The easiest way to\nfetch this repo and all required dependencies is to clone the top-level repository using:\n\n```bash\ngit clone --recursive https://github.com/mathworks-ref-arch/mathworks-aws-support.git\n```\n\n### Build the AWS SDK for Java components\n\nThe MATLAB code uses the AWS SDK for Java and can be built using:\n\n```bash\ncd Software/Java\nmvn clean package\n```\n\nBy default the pom.xml file targets Java 1.7 as supported by MATLAB R2017a and later.\nThis can be updated to 1.8 as supported by MATLAB R2017b and later by updating:\n\n```xml\n    \u003csource\u003e1.8\u003c/source\u003e\n    \u003ctarget\u003e1.8\u003c/target\u003e\n```\n\nprior to running the `mvn clean package` command, see: [Rebuild](Documentation/Rebuild.md).\n\nOnce built, use the ```/Software/MATLAB/startup.m``` function to initialize the interface which will use the\nAWS Credentials Provider Chain to authenticate. Please see the [relevant documentation](Documentation/Authentication.md)\non how to specify the credentials.\n\n### Create a bucket, list existing buckets, upload and download objects\n\n```matlab\n%% Create and initialize a client\ns3 = aws.s3.Client();\ns3.initialize();\n\n%% Create a test bucket\nbucketName = 'com-myorg-my-test-bucket';\ns3.createBucket(bucketName);\n\n%% List existing buckets\nbucketList = s3.listBuckets()\n\n%% Upload a file\n% Create some random data\nx = rand(100,100);\n\n% Save the data to a file\nuploadfile = [tempname,'.mat'];\nsave(uploadfile, 'x');\n\n% Put the .MAT file into an S3 object called 'myobjectkey' in the bucket\ns3.putObject(bucketName, uploadfile, 'myobjectkey');\n\n% Download a file\ns3.getObject(bucketName,'myobjectkey','download.mat');\n\n% Delete a object and then the bucket\ns3.deleteObject(bucketName,'myobjectkey');\ns3.deleteBucket(bucketName);\n\n% Delete the client\ns3.shutdown;\n```\n\nThe interface supports a number of Amazon S3 features including credential-free authentication using IAM when running on EC2™. Please consult the documentation for more details.\n\n## Supported Products:\n\n1. [MATLAB](https://www.mathworks.com/products/matlab.html) (R2017a or later)\n2. [MATLAB Compiler™](https://www.mathworks.com/products/compiler.html) and [MATLAB Compiler SDK™](https://www.mathworks.com/products/matlab-compiler-sdk.html) (R2017a or later)\n3. [MATLAB Production Server™](https://www.mathworks.com/products/matlab-production-server.html) (R2017a or later)\n4. [MATLAB Distributed Computing Server™](https://www.mathworks.com/products/distriben.html) (R2017a or later)\n\n## License\n\nThe license for the MATLAB Interface *for Amazon S3* is available in the [LICENSE.md](LICENSE.md) file in this GitHub repository. This package uses certain third-party content which is licensed under separate license agreements. See the [pom.xml](Software/Java/pom.xml) file for third-party software downloaded at build time.\n\n## Enhancement Request\n\nProvide suggestions for additional features or capabilities using the following link:\nhttps://www.mathworks.com/products/reference-architectures/request-new-reference-architectures.html\n\n## Support\n\nEmail: `mwlab@mathworks.com` or please log an issue.\n\n[//]: #  (Copyright 2018-2023 The MathWorks, Inc.)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmathworks-ref-arch%2Fmatlab-aws-s3","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmathworks-ref-arch%2Fmatlab-aws-s3","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmathworks-ref-arch%2Fmatlab-aws-s3/lists"}