Skip to content

mathworks-ref-arch/matlab-aws-support-v2

Repository files navigation

Latest release License Docs

MATLAB Interface for Amazon Web Services

Introduction

matlab-aws-support-v2 packages MATLAB® class wrappers around the AWS SDK for Java v2 so you can script AWS workflows directly from MATLAB. Clients are available for the most commonly used services, including:

  • Amazon Simple Storage Service (S3)
  • Amazon Simple Queue Service (SQS)
  • Amazon Simple Notification Service (SNS)
  • AWS Secrets Manager
  • Amazon DynamoDB, ECS, Lambda, Redshift Data, STS, and more
  • Amazon Bedrock Runtime for generative AI workloads

The documentation portal lists every supported service and data model.

Tip: MATLAB already includes built-in remote data helpers (for example, dir and the remote data workflow guide). Use those higher-level features whenever they cover your scenario before dropping to the low-level SDK wrappers in this project.

Requirements

Dependency Version / Notes
MATLAB R2023b or later
Java JDK 8 through 17. Starting with R2025b, Bring Your Own Java (BYOJ) is required.
Maven 3.8.8 or later
OS (tested) Windows® 11, Ubuntu® 22.04

Installation Overview

  1. Clone or download the repository.
  2. Build the Java components:
    cd Software/Java
    mvn clean package
  3. Ensure the AWS credentials are valid before running the startup. Check Authentication for different ways.
  4. Open MATLAB, run startup.m from Software/MATLAB to add the interface to your path.
  5. Check the detailed Installation guide for advanced scenarios (proxy settings, custom SDK bundles, etc.).

Note: If MATLAB does not recognize the MATLAB AWS classes and the startup script prints "False" for any of the AWS Service, or if the credentials are not reflected in MATLAB (Errors: The provided token has expired.), MATLAB has to be restarted and the startup scripts have to be run again.

Documentation

Full usage instructions, service-specific walkthroughs, and the MATLAB AWS API reference are published at the MATLAB AWS documentation site.

Authentication

You must supply AWS credentials before calling any service. The package supports a different ways of credential provider. See Documentation/Authentication.md for different approaches to obtain the credentials from provider.

Getting Started

% Configure MATLAB with AWS clients and dependencies
% Example: List buckets and read a secret
s3 = aws.s3.Client();
resp = s3.listBuckets();
disp({resp.buckets.name}');

sm = aws.secretsmanager.Client();
secret = sm.getSecretValue(secretId="prod/app/api");
disp(secret.secretString);

License

The license for this project is provided in LICENSE.md. Third-party software downloaded at build time is listed in Software/Java/pom.xml and is governed by its corresponding licenses.

Enhancement Requests

Suggest new capabilities or managed services using the Reference Architecture request form: https://www.mathworks.com/products/reference-architectures/request-new-reference-architectures.html

Support

  • Email: mwlab@mathworks.com
  • Or open an issue in this repository with reproducible steps and logs.

About

MATLAB® interface for Amazon Web Services to script AWS workflows directly from MATLAB. These are MATLAB® class wrappers around the AWS SDK for Java v2.

Topics

Resources

License

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors

Languages