📚 9. MATLAB AWS - API Reference
Classes, methods and functions that include the terms private or internal in their namespace should not be used directly.
They are subject to change or removal without notice.
The subpackages in the Modules directory contain their own Documentation directories including API references.
🗂️ 9.1 Index
❓ 9.2 Help
aws
aws.athena
aws.athena.model
aws.athena.model.GetQueryExecutionResponse
Metadata returned by athena.getQueryExecution.
Property |
Type |
Description |
|---|---|---|
|
string |
Unique identifier assigned to the query. |
|
Java object |
Raw Athena status object; inspect for advanced troubleshooting. |
|
string |
Query execution state such as |
|
string |
Failure text reported by Athena when available. |
|
datetime |
UTC timestamp when the query was submitted. |
|
datetime |
UTC timestamp when the query finished. |
resp = athena.getQueryExecution(queryExecutionId="1234-abcd");
fprintf("State: %s (id %s)\n", resp.state, resp.queryExecutionId);
aws.athena.model.GetQueryResultsResponse
Wrapper for athena.getQueryResults.
Property |
Type |
Description |
|---|---|---|
|
|
Raw Athena result payload. |
|
string |
Pagination token used to fetch the next page. |
|
double |
Number of rows updated (DDL/CTAS responses only). |
resp = athena.getQueryResults(queryExecutionId="1234-abcd", maxResults=int32(1000));
rows = resp.resultSet.rows();
aws.athena.model.QueryExecutionContext
Define the database and catalog for a query.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Optional. Database to run the query against. |
|
string |
Optional. Catalog such as |
|
Java object |
Optional. Provide an existing SDK object instead of building one. |
ctx = aws.athena.model.QueryExecutionContext(database="sampledb", catalog="AwsDataCatalog");
aws.athena.model.ResultConfiguration
Configure the S3 destination and encryption for query results.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. |
|
|
Optional. SSE-S3 or SSE-KMS settings. |
|
Java object |
Optional. Use an existing SDK configuration. |
rc = aws.athena.model.ResultConfiguration(outputLocation="s3://bucket/results/");
aws.athena.model.StartQueryExecutionResponse
Return type for athena.startQueryExecution.
Property |
Type |
Description |
|---|---|---|
|
string |
Identifier assigned to the submitted query. |
aws.athena.model.StopQueryExecutionResponse
Response metadata for athena.stopQueryExecution.
Property |
Type |
Description |
|---|---|---|
|
double |
HTTP status code reported by the SDK. |
|
string |
AWS request identifier for support cases. |
aws.athena.Client
Superclass: aws.core.BaseClient
MATLAB client wrapper for the Amazon Athena service. Use this class to submit SQL statements, poll execution status, and download results.
aws.athena.Client.Client
Creates an Amazon Athena client instance.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string | software.amazon.awssdk.regions.Region |
Optional. Target AWS Region. |
|
aws.auth.CredentialProvider |
Optional. Credential provider returned by |
|
logical |
Optional. Enable the AWS Common Runtime HTTP client when true. |
Returns |
Type |
Description |
|---|---|---|
|
|
Configured MATLAB Athena client. |
cred = aws.auth.CredentialProvider.getDefaultCredentialProvider();
athena = aws.athena.Client('region',"us-east-1", 'credentialsprovider', cred);
aws.athena.Client.getQueryExecution
Retrieve metadata and status for an existing Athena query execution.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Athena query execution identifier. |
Returns |
Type |
Description |
|---|---|---|
|
|
Contains state, timestamps, and status detail. |
athena = aws.athena.Client();
resp = athena.getQueryExecution(queryExecutionId="1234abcd-5678-efgh");
disp(resp.state)
aws.athena.Client.getQueryResults
Fetch result rows for a query execution, with optional pagination controls.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Athena query execution identifier. |
|
int32 |
Optional. Maximum number of rows per page. |
|
string |
Optional. Pagination token from a prior call. |
Returns |
Type |
Description |
|---|---|---|
|
|
Contains the result set and pagination metadata. |
resp = athena.getQueryResults(queryExecutionId="1234-abcd", maxResults=int32(1000));
rows = resp.resultSet.rows();
aws.athena.Client.initialize
aws.athena.Client/initialize is a function.
initStat = initialize(obj, regionObj, credentialsProvider)
aws.athena.Client.startQueryExecution
Submit a SQL statement for execution in Amazon Athena.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. SQL statement to execute. |
|
|
Required. Output location and encryption settings. |
|
|
Optional. Database/catalog selection. |
|
string |
Optional. Idempotency token. |
|
string |
Optional. Workgroup name. |
Returns |
Type |
Description |
|---|---|---|
|
|
Contains the new |
rc = aws.athena.model.ResultConfiguration(outputLocation="s3://bucket/results/");
resp = athena.startQueryExecution(queryString="SELECT 1", resultConfiguration=rc);
disp(resp.queryExecutionId)
aws.athena.Client.stopQueryExecution
Stop a running query execution in Amazon Athena.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Identifier of the query to cancel. |
Returns |
Type |
Description |
|---|---|---|
|
|
HTTP metadata confirming the stop request. |
resp = athena.stopQueryExecution(queryExecutionId="your-query-id");
disp(resp.statusCode);
aws.auth
aws.auth.CredentialProvider
Superclass: handle
Factory methods for constructing AWS SDK for Java v2 credential providers
that can be passed to MATLAB AWS clients via the credentialsprovider
Name-Value argument.
aws.auth.CredentialProvider.CredentialProvider
aws.auth.CredentialProvider exposes static helper methods; there is no
need to instantiate this class directly.
aws.auth.CredentialProvider.getDefaultCredentialProvider
Discover credentials and region using the AWS SDK default chain.
Returns |
Type |
Description |
|---|---|---|
|
|
Provider that searches env vars, shared config, process credentials, and metadata services. |
|
string |
Region resolved by |
[cp, region] = aws.auth.CredentialProvider.getDefaultCredentialProvider();
s3 = aws.s3.Client('region', region, 'credentialsprovider', cp);
aws.auth.CredentialProvider.getProfileCredentialProvider
Load credentials from a named profile in ~/.aws/credentials or
~/.aws/config. Supports IAM Identity Center (SSO) profiles after you run
aws sso login.
Positional Argument |
Type |
Description |
|---|---|---|
|
string |
Optional. Profile name. Defaults to |
Returns |
Type |
Description |
|---|---|---|
|
|
Provider backed by the requested shared-config profile. |
cp = aws.auth.CredentialProvider.getProfileCredentialProvider("analytics");
sqs = aws.sqs.Client('credentialsprovider', cp);
aws.auth.CredentialProvider.getInstanceProfileCredentialProvider
Use credentials supplied by the EC2 instance profile or ECS task role.
Returns |
Type |
Description |
|---|---|---|
|
|
Retrieves temporary credentials from IMDS/ECS metadata. |
aws.auth.CredentialProvider.getBasicCredentialProvider
Wrap a long-lived Access Key ID and Secret Access Key.
Positional Argument |
Type |
Description |
|---|---|---|
|
string |
Required. IAM Access Key ID. |
|
string |
Required. IAM Secret Access Key. |
Returns |
Type |
Description |
|---|---|---|
|
|
Static credentials; avoid for production workloads when roles are available. |
cp = aws.auth.CredentialProvider.getBasicCredentialProvider("AKIA...", "SECRET...");
aws.auth.CredentialProvider.getSessionCredentialProvider
Package temporary credentials (STS, federation, or custom SSO) into a StaticCredentialsProvider.
Positional Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Access Key ID. |
|
string |
Required. Secret Access Key. |
|
string |
Required. Session token. |
Returns |
Type |
Description |
|---|---|---|
|
|
Provider containing the supplied session credentials. |
aws.auth.CredentialProvider.getWebIdentityCredentialProvider
Assume a role using AWS_ROLE_ARN, AWS_WEB_IDENTITY_TOKEN_FILE, and
optional AWS_ROLE_SESSION_NAME.
Returns |
Type |
Description |
|---|---|---|
|
|
Exchanges a web identity token (e.g., EKS IRSA) for temporary credentials. |
aws.auth.CredentialProvider.getJsonFileCredentialProvider
Read credentials (and optional region) from a simple JSON file.
Positional Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Path to a JSON file containing the credential fields. |
Returns |
Type |
Description |
|---|---|---|
|
|
Static or session provider depending on whether |
|
string |
Region from the JSON if provided; otherwise empty string. |
Example JSON:
{
"aws_access_key_id": "AKIA...",
"aws_secret_access_key": "SECRET...",
"aws_session_token": "TOKEN...",
"region": "us-west-2"
}
[cp, region] = aws.auth.CredentialProvider.getJsonFileCredentialProvider("creds.json");
polly = aws.polly.Client('region', region, 'credentialsprovider', cp);
aws.bedrock
aws.bedrock.runtime
aws.bedrock.runtime.model
aws.bedrock.runtime.model.ConverseResponse
Superclass: aws.Object
CONVERSERESPONSE is the response sent from Bedrock Converse
Service.
aws.bedrock.runtime.model.ConverseResponse.ConverseResponse
CONVERSERESPONSE is the response sent from Bedrock Converse
Service.
aws.bedrock.runtime.model.InvokeModelResponse
Superclass: aws.Object
INVOKEMODELREQUEST is the request class to invoke a bedrock runtime
model.
aws.bedrock.runtime.model.InvokeModelResponse.InvokeModelResponse
INVOKEMODELREQUEST is the request class to invoke a bedrock runtime
model.
aws.bedrock.runtime.model.Message
Superclass: aws.Object
CONVERSEMESSAGE Represents the Message sent in Bedrock Converse
Service. The Conversation history (state) of the message should be
maintained at the client side.
This is applicable only for Bedrock Runtime converse API
aws.bedrock.runtime.model.Message.Message
CONVERSEMESSAGE Represents the Message sent in Bedrock Converse
Service. The Conversation history (state) of the message should be
maintained at the client side.
This is applicable only for Bedrock Runtime converse API
aws.bedrock.runtime.utils
aws.bedrock.runtime.utils.buildModelPayload
Construct a JSON payload for invokeModel.
Input |
Type |
Description |
|---|---|---|
|
string |
Required. Bedrock model identifier. |
|
string | struct | dictionary |
Required. Prompt text, raw JSON, or structured payload. |
Returns |
Type |
Description |
|---|---|---|
|
char |
JSON payload suitable for |
json = aws.bedrock.runtime.utils.buildModelPayload("amazon.titan-text-lite-v1", "Hello?");
spec = struct(text="Describe a sunset", seed=42, style="photorealistic");
jsonImg = aws.bedrock.runtime.utils.buildModelPayload("amazon.titan-image-generator-v1", spec);
aws.bedrock.runtime.utils.parseModelResponse
PARSEMODELRESPONSE Parses the model-specific response into a standard format.
modelId: Identifier for the model.
responseBody: The raw response body from the model.
aws.bedrock.runtime.Client
Superclass: aws.core.BaseClient
MATLAB client for the Amazon Bedrock Runtime service.
aws.bedrock.runtime.Client.Client
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string | software.amazon.awssdk.regions.Region |
Optional. Target Region (defaults to shared config). |
|
aws.auth.CredentialProvider |
Optional. Custom credential source. |
|
logical |
Optional. Use the AWS Common Runtime HTTP client when true. |
bedrock = aws.bedrock.runtime.Client('region',"us-east-1");
aws.bedrock.runtime.Client.converse
Send a sequence of messages to a chat-capable foundation model.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Model identifier. |
|
aws.bedrock.runtime.model.Message vector |
Required. Conversation turns (user/assistant). |
|
int32 |
Optional. Max tokens in the response (default 512). |
|
single |
Optional. Sampling temperature in [0,1]. |
|
single |
Optional. Nucleus sampling parameter in [0,1]. |
Returns |
Type |
Description |
|---|---|---|
|
|
Assistant message, stop reason, and usage info. |
msgs = aws.bedrock.runtime.model.Message.empty;
msgs(end+1) = aws.bedrock.runtime.model.Message(text="Hello?", role="user");
resp = bedrock.converse(modelId="amazon.titan-text-lite-v1", messages=msgs);
aws.bedrock.runtime.Client.initialize
aws.bedrock.runtime.Client/initialize is a function.
initStat = initialize(obj, regionObj, credentialsProvider)
aws.bedrock.runtime.Client.invokeModel
Invoke a Bedrock model with either a text prompt or structured payload.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Model identifier. |
|
string | struct | dictionary |
Required. Text prompt, raw JSON, or payload fields. |
|
string |
Optional. Desired response MIME type (default |
|
string |
Optional. Request content type (default |
|
string |
Optional. Guardrail ID. |
|
string |
Optional. Guardrail version. |
|
string |
Optional. Trace configuration. |
Returns |
Type |
Description |
|---|---|---|
|
|
Model output along with token usage. |
resp = bedrock.invokeModel(modelId="amazon.titan-text-express-v1", body="Summarize this paragraph.");
aws.core
aws.core.model
aws.core.model.RequestBody
aws.core.model.RequestBody.RequestBody
Wrap strings, file paths, byte arrays, or existing SDK objects into an AWS RequestBody.
Positional Argument |
Type |
Description |
|---|---|---|
|
string |
Provide literal text to send. If the string resolves to a file path the file contents are streamed. |
|
|
Send binary data directly. |
|
|
Wrap an existing Java RequestBody instance. |
body = aws.core.model.RequestBody("Hello from MATLAB");
fileBody = aws.core.model.RequestBody("/tmp/data.bin");
aws.core.model.RequestBody.isValidFile
Determine whether a string input refers to a readable file on disk.
Positional Argument |
Type |
Description |
|---|---|---|
|
string |
Path to test. |
Returns |
Type |
Description |
|---|---|---|
|
logical |
|
aws.core.model.SdkBytes
Superclass: aws.Object
SDKBYTES model class of AWS SDKBytes class
aws.core.model.SdkBytes.SdkBytes
SDKBYTES model class of AWS SDKBytes class
aws.core.model.SdkBytes.isValidZipFile
ISVALIDZIPFILE Checks if the given input is a valid path to a ZIP file.
aws.core.BaseClient
Superclass: aws.Object
BASECLIENT Abstract base class for AWS service clients.
Provides shared functionality for initializing AWS clients.
aws.core.BaseClient.BaseClient
Initialize logger
aws.core.BaseClient.applyHttpClientBuilder
aws.core.BaseClient/applyHttpClientBuilder is a function.
builder = applyHttpClientBuilder(obj, builder, options)
aws.core.BaseClient.delete
DELETE Delete a handle object.
DELETE(H) deletes all handle objects in array H. After the delete
function call, H is an array of invalid objects.
See also AWS.CORE.BASECLIENT, AWS.CORE.BASECLIENT/ISVALID, CLEAR
Help for aws.core.BaseClient/delete is inherited from superclass handle
aws.core.BaseClient.initialize
aws.core.BaseClient/initialize is a function.
obj = aws.core.BaseClient
aws.core.BaseClient.validateRegion
aws.core.BaseClient/validateRegion is a function.
regionObj = validateRegion(~, region, serviceId)
aws.dynamodb
aws.dynamodb.model
aws.dynamodb.model.AttributeDefinition
Define an attribute that participates in a table or index schema.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Attribute name. |
|
string |
Required. One of |
attrDef = aws.dynamodb.model.AttributeDefinition(attributeName="pk", attributeType="S");
aws.dynamodb.model.AttributeValue
Represents a DynamoDB attribute payload in any of the supported shapes.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
String value. |
|
string |
Numeric value expressed as text. |
|
uint8 vector | aws.core.model.SdkBytes |
Binary value. |
|
string array |
String set. |
|
string array |
Number set (stored as strings). |
|
cell |
Binary set. |
|
dictionary |
Map of |
|
logical |
Boolean value. |
|
logical |
Set |
|
Java object |
Wrap an existing SDK AttributeValue handle. |
Exactly one of the shape arguments must be supplied (unless attributeValue is provided).
val = aws.dynamodb.model.AttributeValue(s="user#123");
Method AttributeValue.getValue — returns the MATLAB representation based on the stored shape.
aws.dynamodb.model.BatchWriteItemResponse
Response wrapper returned by batchWriteItem.
Property |
Type |
Description |
|---|---|---|
|
dictionary |
Map of table name -> cell array of |
|
cell |
Cell array of |
resp = ddb.batchWriteItem(requestItems=reqs);
cellfun(@numel, values(resp.unprocessedItems));
aws.dynamodb.model.ConsumedCapacity
Describes capacity units consumed by an operation (when returnConsumedCapacity is requested).
Property |
Type |
Description |
|---|---|---|
|
double |
Total units consumed. |
|
double |
Read units consumed. |
|
double |
Write units consumed. |
|
string |
Table name associated with the measurement. |
|
double |
Capacity attributable to the table (excludes indexes). |
|
double |
Read units consumed by the table. |
|
double |
Write units consumed by the table. |
aws.dynamodb.model.CreateTableResponse
Property |
Type |
Description |
|---|---|---|
|
|
Description of the newly created table. |
aws.dynamodb.model.DeleteItemResponse
Property |
Type |
Description |
|---|---|---|
|
dictionary |
Attribute map returned when |
|
|
Capacity metrics (when requested). |
aws.dynamodb.model.DeleteRequest
Constructs a delete request payload for batchWriteItem.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
dictionary |
Required. Primary key map of |
aws.dynamodb.model.DeleteTableResponse
Property |
Type |
Description |
|---|---|---|
|
|
Metadata for the deleted table. |
aws.dynamodb.model.DescribeTableResponse
Property |
Type |
Description |
|---|---|---|
|
|
Full table description. |
aws.dynamodb.model.GetItemResponse
Property |
Type |
Description |
|---|---|---|
|
dictionary |
Retrieved item attributes (string -> AttributeValue). |
|
|
Capacity metrics when requested. |
aws.dynamodb.model.ItemCollectionMetrics
Property |
Type |
Description |
|---|---|---|
|
dictionary |
Partition key of the affected item collection. |
|
double array |
Lower/upper estimate of collection size (GB). |
aws.dynamodb.model.KeySchemaElement
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Attribute participating in the key. |
|
string |
Key role ( |
aws.dynamodb.model.ListTablesResponse
Property |
Type |
Description |
|---|---|---|
|
string array |
Table names returned in the page. |
|
string |
Continuation token (empty when finished). |
aws.dynamodb.model.ProvisionedThroughput
Name-Value Argument |
Type |
Description |
|---|---|---|
|
int64 |
Required. Provisioned read capacity. |
|
int64 |
Required. Provisioned write capacity. |
aws.dynamodb.model.PutItemResponse
Property |
Type |
Description |
|---|---|---|
|
dictionary |
Attribute map returned when |
|
|
Capacity metrics when requested. |
aws.dynamodb.model.PutRequest
Name-Value Argument |
Type |
Description |
|---|---|---|
|
dictionary |
Required. Attribute map used for batch puts. |
aws.dynamodb.model.QueryResponse
Property |
Type |
Description |
|---|---|---|
|
cell |
Each cell is a dictionary describing one result item. |
|
|
Capacity metrics when requested. |
|
int32 |
Number of matching items returned. |
|
int32 |
Number of items evaluated before filters. |
aws.dynamodb.model.ScanResponse
Property |
Type |
Description |
|---|---|---|
|
cell |
Dictionary-per-item describing the scan results. |
|
int32 |
Number of items returned after filters. |
|
int32 |
Total items evaluated. |
|
dictionary |
Pagination token for continued scans. |
|
|
Capacity metrics when requested. |
aws.dynamodb.model.TableDescription
Property |
Type |
Description |
|---|---|---|
|
string |
Table name. |
|
string |
Unique identifier assigned by DynamoDB. |
|
string |
Amazon Resource Name. |
|
int64 |
Approximate item count. |
|
string |
|
|
datetime |
Table creation time. |
|
|
Current provisioned throughput snapshot. |
aws.dynamodb.model.UpdateItemResponse
Property |
Type |
Description |
|---|---|---|
|
dictionary |
Attribute map returned via |
|
|
Capacity metrics when requested. |
|
|
Size metrics for the affected collection. |
aws.dynamodb.model.UpdateTableResponse
Property |
Type |
Description |
|---|---|---|
|
|
Updated table metadata. |
aws.dynamodb.model.WriteRequest
Represents a single put or delete entry within batchWriteItem. Exactly one of putRequest or deleteRequest may be supplied.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
|
Optional. Item to put. |
|
|
Optional. Item to delete. |
aws.dynamodb.Client
Superclass: aws.core.BaseClient
Interact with Amazon DynamoDB tables using the MATLAB wrappers over the AWS SDK v2 client.
ddb = aws.dynamodb.Client();
desc = ddb.describeTable(tableName="MyTable");
aws.dynamodb.Client.Client
Construct a DynamoDB client instance.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Optional region override (defaults to the shared credential provider region). |
|
aws.auth.CredentialProvider |
Optional credential source. |
|
logical |
Optional. |
Returns |
Type |
Description |
|---|---|---|
|
|
Client configured for the specified region. |
ddb = aws.dynamodb.Client('region',"us-east-1");
aws.dynamodb.Client.batchWriteItem
Write multiple items across one or more tables.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
dictionary |
Required. Map of table name (string) to a vector/cell array of |
Returns |
Type |
Description |
|---|---|---|
|
|
Provides the per-table |
ddb = aws.dynamodb.Client();
body = dictionary("pk", aws.dynamodb.model.AttributeValue(s="order#1"));
putReq = aws.dynamodb.model.PutRequest(item=body);
writeReq = aws.dynamodb.model.WriteRequest(putRequest=putReq);
reqs = dictionary("Orders", [writeReq]);
resp = ddb.batchWriteItem(requestItems=reqs);
aws.dynamodb.Client.createTable
Create a DynamoDB table.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Table name. |
|
array |
Required. Array of |
|
array |
Required. Array of |
|
|
Required. Read/write capacity settings. |
Returns |
Type |
Description |
|---|---|---|
|
|
Table description and status. |
ddb = aws.dynamodb.Client();
ks = aws.dynamodb.model.KeySchemaElement(attributeName="pk", keyType="HASH");
ad = aws.dynamodb.model.AttributeDefinition(attributeName="pk", attributeType="S");
pt = aws.dynamodb.model.ProvisionedThroughput(readCapacityUnits=int64(5), writeCapacityUnits=int64(5));
resp = ddb.createTable(tableName="MyTable", keySchema=ks, attributeDefinitions=ad, provisionedThroughput=pt);
aws.dynamodb.Client.deleteItem
Delete an item from a DynamoDB table.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. DynamoDB table name. |
|
dictionary | struct |
Required. Primary key map of |
Returns |
Type |
Description |
|---|---|---|
|
|
Contains consumed capacity and optional return values. |
ddb = aws.dynamodb.Client();
key = dictionary("pk", aws.dynamodb.model.AttributeValue(s="user#123"));
resp = ddb.deleteItem(tableName="users", key=key);
aws.dynamodb.Client.deleteTable
Delete a DynamoDB table.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Table to delete. |
Returns |
Type |
Description |
|---|---|---|
|
|
Contains table status and metadata. |
ddb = aws.dynamodb.Client();
resp = ddb.deleteTable(tableName="users");
aws.dynamodb.Client.describeTable
Retrieve metadata for a DynamoDB table.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Table name to describe. |
Returns |
Type |
Description |
|---|---|---|
|
|
Contains status, key schema, throughput, etc. |
ddb = aws.dynamodb.Client();
resp = ddb.describeTable(tableName="users");
disp(resp.table.tableStatus);
aws.dynamodb.Client.getItem
Retrieve a single item from a DynamoDB table.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. DynamoDB table name. |
|
dictionary | struct |
Required. Primary key map of |
Returns |
Type |
Description |
|---|---|---|
|
|
Contains the item attributes plus consumed capacity metadata. |
ddb = aws.dynamodb.Client();
key = dictionary("pk", aws.dynamodb.model.AttributeValue(s="user#123"));
resp = ddb.getItem(tableName="users", key=key);
aws.dynamodb.Client.initialize
aws.dynamodb.Client/initialize is a function.
initStat = initialize(obj, regionObj, credentialsProvider)
aws.dynamodb.Client.listTables
List table names in the current AWS account/Region.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
double |
Optional. Maximum number of table names to return. |
Returns |
Type |
Description |
|---|---|---|
|
|
Table names and continuation token. |
ddb = aws.dynamodb.Client();
resp = ddb.listTables(limit=10);
disp(resp.tableNames);
aws.dynamodb.Client.putItem
Insert or replace an item in a DynamoDB table.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. DynamoDB table name. |
|
dictionary | struct |
Required. Attribute map built with |
Returns |
Type |
Description |
|---|---|---|
|
|
Response metadata such as consumed capacity. |
ddb = aws.dynamodb.Client();
item = dictionary( ...
["pk","sk","name"], ...
[aws.dynamodb.model.AttributeValue(s="user#123"), ...
aws.dynamodb.model.AttributeValue(s="profile"), ...
aws.dynamodb.model.AttributeValue(s="Ada Lovelace")]);
resp = ddb.putItem(tableName="users", item=item);
aws.dynamodb.Client.query
Run a key-condition query against a DynamoDB table.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. DynamoDB table name. |
|
string |
Required. Expression using the partition key (and optional sort key). |
|
dictionary | struct |
Optional. AttributeValue map referenced by the expression. |
Returns |
Type |
Description |
|---|---|---|
|
|
Matching items, consumed capacity, and pagination tokens. |
ddb = aws.dynamodb.Client();
vals = dictionary(":pk", aws.dynamodb.model.AttributeValue(s="user#123"));
resp = ddb.query(tableName="users", keyConditionExpression="pk = :pk", expressionAttributeValues=vals);
disp(resp.count);
aws.dynamodb.Client.scan
Scan a table with optional filter and projection expressions.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Table to scan. |
|
string |
Optional. Filter applied after the scan. |
|
dictionary |
Optional. Map of tokens (e.g., |
|
dictionary |
Optional. Map of tokens (e.g., |
|
string |
Optional. Expression that narrows the attributes returned. |
|
double |
Optional. Positive integer cap on the number of items returned. |
|
logical |
Optional. true requests strongly consistent reads. |
|
dictionary |
Optional. Pagination token ( |
Returns |
Type |
Description |
|---|---|---|
|
|
Items returned, consumed capacity, and |
ddb = aws.dynamodb.Client();
vals = dictionary(":prefix", aws.dynamodb.model.AttributeValue(s="user#"));
resp = ddb.scan(tableName="users", filterExpression="begins_with(pk, :prefix)", ...
expressionAttributeValues=vals, limit=25);
while ~isempty(resp.lastEvaluatedKey)
resp = ddb.scan(tableName="users", exclusiveStartKey=resp.lastEvaluatedKey);
end
aws.dynamodb.Client.updateItem
Update attributes for an existing DynamoDB item.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. DynamoDB table name. |
|
dictionary | struct |
Required. Primary key map of AttributeValue objects. |
|
string |
Required. DynamoDB update expression. |
|
dictionary |
Optional. Values referenced in the update expression. |
|
string |
Optional. Specify response content (e.g., |
Returns |
Type |
Description |
|---|---|---|
|
|
Contains updated attributes and consumed capacity info. |
ddb = aws.dynamodb.Client();
key = dictionary("pk", aws.dynamodb.model.AttributeValue(s="user#123"));
exprVals = dictionary(":name", aws.dynamodb.model.AttributeValue(s="Ada"));
resp = ddb.updateItem( ...
tableName="users", ...
key=key, ...
updateExpression="SET #n = :name", ...
expressionAttributeValues=exprVals, ...
returnValues="ALL_NEW");
aws.dynamodb.Client.updateTable
Update provisioned throughput for an existing table.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Table to modify. |
|
|
Required. New read/write capacity settings. |
Returns |
Type |
Description |
|---|---|---|
|
|
Includes the latest table description and status. |
ddb = aws.dynamodb.Client();
pt = aws.dynamodb.model.ProvisionedThroughput( ...
readCapacityUnits=int64(10), writeCapacityUnits=int64(5));
resp = ddb.updateTable(tableName="Orders", provisionedThroughput=pt);
disp(resp.tableDescription.tableStatus);
aws.ec2
aws.ec2.model
aws.ec2.Client
Superclass: aws.core.BaseClient
CLIENT Amazon Elastic Compute Cloud (EC2) Client
This client is used to interact with the Amazon EC2 service, allowing
you to manage instances, security groups, key pairs, and more.
Example:
ec2 = aws.ec2.Client();
% Perform operations with EC2
Authentication Credentials - Please see the authentication section
of the documentation for more details.
aws.ec2.Client.Client
CLIENT Amazon Elastic Compute Cloud (EC2) Client
This client is used to interact with the Amazon EC2 service, allowing
you to manage instances, security groups, key pairs, and more.
Example:
ec2 = aws.ec2.Client();
% Perform operations with EC2
Authentication Credentials - Please see the authentication section
of the documentation for more details.
aws.ec2.Client.initialize
aws.ec2.Client/initialize is a function.
initStat = initialize(obj, regionObj, credentialsProvider)
aws.ec2.Client.startInstance
Start one or more EC2 instances.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string | string array |
Required. IDs of the instances to start. |
|
string |
Optional. Reserved field passed through to the API. |
Returns |
Type |
Description |
|---|---|---|
|
|
List of instance state transitions. |
resp = ec2.startInstance(instanceIds=["i-0123456789abcdef0","i-0fedcba9876543210"]);
disp(resp.startingInstances);
aws.ec2.Client.stopInstance
Stop one or more running EC2 instances.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string | string array |
Required. IDs of the instances to stop. |
|
logical |
Optional. Set |
Returns |
Type |
Description |
|---|---|---|
|
|
Instance state transitions plus HTTP metadata. |
resp = ec2.stopInstance(instanceIds="i-0123456789abcdef0", force=false);
disp(resp.stoppingInstances);
aws.ecs
aws.ecs.model
aws.ecs.model.AwsVpcConfiguration
Field |
Type |
Description |
|---|---|---|
|
string array |
Subnet IDs for awsvpc ENIs. |
|
string array |
Security group IDs attached to the ENIs. |
|
string |
|
aws.ecs.model.ClusterResponse
Property |
Type |
Description |
|---|---|---|
|
string |
ARN of the created/deleted cluster. |
aws.ecs.model.ContainerDefinition
Field |
Type |
Description |
|---|---|---|
|
string |
Container name. |
|
string |
Container image reference. |
|
int32 |
CPU units reserved for the container. |
|
int32 |
Memory (MiB) reserved for the container. |
|
logical |
When true, task stops if this container exits. |
|
aws.ecs.model.PortMapping array |
Exposed ports. |
|
aws.ecs.model.LogConfiguration |
Log driver definition. |
|
dictionary |
Environment variables. |
aws.ecs.model.LoadBalancers
Field |
Type |
Description |
|---|---|---|
|
string |
Classic/ALB name. |
|
string |
Target group ARN (ALB/NLB). |
|
string |
Container receiving traffic. |
|
double |
Port exposed on the container. |
aws.ecs.model.LogConfiguration
Field |
Type |
Description |
|---|---|---|
|
string |
Log driver ( |
|
dictionary |
Driver-specific options (keys converted to dashed form). |
aws.ecs.model.NetworkConfiguration
Field |
Type |
Description |
|---|---|---|
|
aws.ecs.model.AwsVpcConfiguration |
VPC networking details applied to the service/task. |
aws.ecs.model.PortMapping
Field |
Type |
Description |
|---|---|---|
|
double |
Container port (1–65535). |
|
double |
Host port (1–65535). |
|
string |
|
aws.ecs.model.RegisterTaskDefinitionRequest
Usage |
Type |
Description |
|---|---|---|
|
AWS SDK request object |
Wrap an existing Java request. |
|
struct/dictionary |
Build a new request via |
aws.ecs.model.ServiceResponse
Property |
Type |
Description |
|---|---|---|
|
string |
ARN of the service affected by the API call. |
aws.ecs.model.TaskDefinitionResponse
Property |
Type |
Description |
|---|---|---|
|
string or cell array |
ARN(s) returned by register/deregister/delete operations. |
aws.ecs.Client
Interact with Amazon Elastic Container Service clusters, services, and task definitions.
aws.ecs.Client.Client
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Optional region override; defaults to the credential region. |
|
aws.auth.CredentialProvider |
Optional credential source to override defaults. |
|
logical |
When true, use the AWS Common Runtime HTTP client. |
Returns |
Type |
Description |
|---|---|---|
|
|
Configured ECS client instance. |
ecs = aws.ecs.Client('region',"us-east-1");
aws.ecs.Client.createCluster
Create a new ECS cluster.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Friendly name for the cluster. |
|
string array |
Optional. Capacity providers to associate with the cluster. |
|
string |
Optional. KMS key ARN for ECS Exec encryption. |
|
struct |
Optional. Struct passed directly to the AWS SDK log configuration builder. |
|
string |
Optional. “NONE”, “DEFAULT”, or “OVERRIDE”. |
|
string |
Optional. KMS key ARN for managed storage. |
|
string |
Optional. KMS key ARN for Fargate ephemeral storage. |
|
dictionary |
Optional. Key/value tags applied to the cluster. |
|
dictionary |
Optional. Cluster setting name/value pairs. |
Returns |
Type |
Description |
|---|---|---|
|
|
Metadata describing the created cluster. |
ecs = aws.ecs.Client('region',"us-east-1");
resp = ecs.createCluster(clusterName="demoCluster", capacityProviders=["FARGATE"]);
aws.ecs.Client.createService
Create or scale an ECS service.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Cluster name/ARN hosting the service. |
|
string |
Required. Service name to create. |
|
string |
Required. Task definition family:revision or ARN. |
|
string |
Optional. Launch type (“FARGATE”, “EC2”, “EXTERNAL”). |
|
double |
Optional. Desired number of running tasks. |
|
string array |
Optional. Subnet IDs for awsvpc networking. |
|
string array |
Optional. Security group IDs for awsvpc networking. |
|
string |
Optional. “ENABLED” or “DISABLED” for awsvpc tasks. |
|
aws.ecs.model.LoadBalancers array |
Optional. Target load balancers for the service. |
Returns |
Type |
Description |
|---|---|---|
|
|
Created service metadata. |
ecs = aws.ecs.Client();
resp = ecs.createService(cluster="default", serviceName="web", taskDefinition="myTaskDef", subnets=["subnet-1"], securityGroups=["sg-123"]);
aws.ecs.Client.deleteCluster
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Cluster name or ARN to delete (must be inactive). |
Returns |
Type |
Description |
|---|---|---|
|
|
Metadata for the removed cluster. |
aws.ecs.Client.deleteService
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Cluster hosting the service. |
|
string |
Required. Service name/ARN to delete. |
|
logical |
Optional. Force deletion even if tasks remain. |
Returns |
Type |
Description |
|---|---|---|
|
|
Deleted service metadata. |
aws.ecs.Client.deleteTaskDefinitions
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string array |
Required. One or more task definition ARNs to delete. |
Returns |
Type |
Description |
|---|---|---|
|
|
Information about the deleted revisions. |
aws.ecs.Client.deregisterTaskDefinition
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Task definition ARN or family:revision to deregister. |
Returns |
Type |
Description |
|---|---|---|
|
|
Metadata for the inactive revision. |
aws.ecs.Client.initialize
aws.ecs.Client/initialize is a function.
initStat = initialize(obj, regionObj, credentialsProvider)
aws.ecs.Client.registerTaskDefinition
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Task definition family name. |
|
string |
Required. IAM role assumed by the task. |
|
string |
Required. IAM role assumed by the ECS agent. |
|
string |
Required. “AWSVPC”, “BRIDGE”, “HOST”, or “NONE”. |
|
aws.ecs.model.ContainerDefinition array |
Required. Container definition objects. |
|
string array |
Optional. Supported launch types (“FARGATE”, “EC2”, “EXTERNAL”). |
|
string |
Required. CPU units reserved for the task. |
|
string |
Required. Memory (MiB) reserved for the task. |
Returns |
Type |
Description |
|---|---|---|
|
|
Metadata for the registered revision. |
resp = ecs.registerTaskDefinition(family="web", taskRoleArn=taskRole, ...
executionRoleArn=execRole, networkMode="AWSVPC", ...
containerDefinitions=[containerDef], requiresCompatibilities="FARGATE", ...
cpu="1024", memory="2048");
aws.ecs.Client.updateService
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Cluster that hosts the service. |
|
string |
Required. Service name/ARN to update. |
|
string |
Optional. New task definition revision. |
|
double |
Optional. Desired number of tasks. |
|
aws.ecs.model.LoadBalancers array |
Optional. Updated load balancer mappings. |
Returns |
Type |
Description |
|---|---|---|
|
|
Updated service metadata. |
resp = ecs.updateService(cluster="default", serviceName="web", desiredCount=3);
aws.internal
aws.internal.builder
Internal utilities that translate MATLAB arguments into AWS SDK builder calls.
aws.internal.builder.build
Populate a Java builder using the fields of a MATLAB scalar struct (the output of an arguments block).
Input |
Type |
Description |
|---|---|---|
|
Java builder |
AWS SDK builder returned by a |
|
struct |
Scalar struct whose field names map to builder setters. |
Returns |
Type |
Description |
|---|---|---|
|
java.lang.Object |
Result of invoking |
request = aws.internal.builder.build(builder, optionsStruct);
aws.internal.builder.buildSdkObjectsFromDictionary
Convert a MATLAB dictionary into an array of SDK model objects by
calling the target class’ builder.
Input |
Type |
Description |
|---|---|---|
|
dictionary |
Keys become |
|
string |
Fully qualified Java class that exposes a |
Returns |
Type |
Description |
|---|---|---|
|
java Array |
Java array of the requested SDK objects. |
aws.internal.util
aws.internal.util.javaMapToDictionary
javaMapToDictionary Converts a java.util.Map to a MATLAB dictionary
dict = javaMapToDictionary(javaMap) returns a MATLAB dictionary
with the same keys and values as the Java map.
Example:
jmap = java.util.HashMap();
jmap.put('a', 1);
jmap.put('b', 2);
dict = javaMapToDictionary(jmap);
aws.lambda
aws.lambda.model
aws.lambda.model.CreateFunctionResponse
Superclass: aws.Object
CREATEFUNCTIONRESPONSE Response object for creating an AWS Lambda function.
This class constructs a response to create a new AWS Lambda function
using the provided parameters.
aws.lambda.model.CreateFunctionResponse.CreateFunctionResponse
CREATEFUNCTIONRESPONSE Construct an instance of this class
aws.lambda.model.DeleteFunctionResponse
Superclass: aws.Object
DELETEFUNCTIONRESPONSE Response object for deleting an AWS Lambda function.
This class constructs a response for deleting an AWS Lambda function.
aws.lambda.model.DeleteFunctionResponse.DeleteFunctionResponse
DELETEFUNCTIONRESPONSE Construct an instance of this class
aws.lambda.model.FunctionCode
Superclass: aws.Object
FUNCTIONCODE Summary of this class goes here
aws.lambda.model.FunctionCode.FunctionCode
FUNCTIONCODE Summary of this class goes here
aws.lambda.model.InvokeFunctionResponse
Superclass: aws.Object
INVOKEFUNCTIONRESPONSE Response object for invoking an AWS Lambda function.
This class constructs a response to an AWS Lambda function invocation.
aws.lambda.model.InvokeFunctionResponse.InvokeFunctionResponse
INVOKEFUNCTIONRESPONSE Construct an instance of this class
aws.lambda.model.InvokeFunctionResponse.getPayload
GETPAYLOAD Get the payload from the response
aws.lambda.task
aws.lambda.task.CompileTask
Superclass: matlab.buildtool.Task
COMPILETASK MATLAB Build Tool Task for compiling MATLAB Compiler
Standalone Applications. Saves the build results as MAT-file in the
output directory. This is specifically meant to be used in
combination with aws.lambda.task.DockerTask which requires these
build results as input.
CompileTask Properties:
AppFile - Main entry point for the standalone application. See also
AppFile input to compiler.build.standaloneApplication.
AdditionalFiles - Additional Files to include in the application.
See also AdditionalFiles input to compiler.build.standaloneApplication.
OutputDir - Path to folder where the build files are saved. See
also OutputDir input to compiler.build.standaloneApplication.
Description - Description of task.
Dependencies - Names of tasks on which the task depends.
CompileTask Methods:
CompileTask - constructor.
See Also DockerTask, matlab.buildtool.Task, compiler.build.standaloneApplication
aws.lambda.task.CompileTask.CompileTask
COMPILETASK constructor
Can be called with Name-Value pairs as input where Name can
match any class property name which will be then set this
property to the specified Value.
aws.lambda.task.CompileTask.compileStandalone
COMPILESTANDALONE builds the standalone application
aws.lambda.task.DockerTask
Superclass: matlab.buildtool.Task
DOCKERTASK MATLAB Build Tool Task for packaging MATLAB Compiler
standalone applications into an AWS Lambda Compatible Docker image.
The Docker packaging process differs from a standard Docker package
process in the sense that this task can:
- Patch libiomp5.so inside the image to work around an
incompatibility with AWS Lambda runtime instances.
- Include the AWS Lambda Runtime Interface Emulator in the image
and generate an entrypoint to run this emulator for local testing.
This Task is meant to be used in combination with
aws.lambda.task.CompileTask which produces the build results which
this Task needs as input.
DockerTask Properties:
CompileOutputDir - OutputDir of the CompileTask which was used to
compile the standalone application.
ImageName - Name of the Docker image. See also ImageName input to
compiler.package.docker.
PatchLibiomp5 - Whether or not to apply the libiomp5.so patch.
Default: true.
Libiomp5Location - Location of patched libiomp5.so.
IncludeEmulator - Whether or not to include the AWS Lambda Runtime
Interface Emulator in the image. Default: true.
DockerContext - Path to folder where the build files are saved. See
also DockerContext input to compiler.package.docker.
Description - Description of task.
Dependencies - Names of tasks on which the task depends.
DockerTask Methods:
DockerTask - constructor.
See Also CompileTask, matlab.buildtool.Task, compiler.package.docker
aws.lambda.task.DockerTask.DockerTask
DOCKERTASK constructor
Can be called with Name-Value pairs as input where Name can
match any class property name which will be then set this
property to the specified Value.
aws.lambda.task.DockerTask.dockerBuild
DOCKERBUILD builds the Docker container around the standalone
application
aws.lambda.testutil
aws.lambda.testutil.DockerBase
Superclass: matlab.unittest.TestCase
DOCKERBASE base class for Docker based tests.
In TestClassSetup starts the Docker container specified by the
imageName property.
The container is configured to publish port
8080 to a random free port. The actual port is reported back in the
port property.
Also sets the host property based on environment
variable DOCKERHOST; if set host is set to its value, if unset host
is set to "localhost".
The container is stopped in TestClassTeardown.
aws.lambda.testutil.DockerBase.DockerBase
DOCKERBASE base class for Docker based tests.
In TestClassSetup starts the Docker container specified by the
imageName property.
The container is configured to publish port
8080 to a random free port. The actual port is reported back in the
port property.
Also sets the host property based on environment
variable DOCKERHOST; if set host is set to its value, if unset host
is set to "localhost".
The container is stopped in TestClassTeardown.
aws.lambda.testutil.DockerBase.forInteractiveUse
forInteractiveUse - Default provided forInteractiveUse method
aws.lambda.testutil.DockerBase.startContainer
Start the container
aws.lambda.testutil.DockerBase.stopContainer
aws.lambda.testutil.DockerBase/stopContainer is a function.
stopContainer(testCase)
aws.lambda.Client
Superclass: aws.core.BaseClient
aws.lambda.Client.Client
Construct an AWS Lambda service client.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Optional region override; defaults to the shared credential provider region. |
|
aws.auth.CredentialProvider |
Optional credentials source; defaults to |
|
logical |
When |
Returns |
Type |
Description |
|---|---|---|
|
|
Client configured for the requested region. |
lambda = aws.lambda.Client('region',"us-east-1");
aws.lambda.Client.createFunction
Create a new AWS Lambda function.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Logical name for the Lambda function. |
|
string |
Required. Runtime identifier such as |
|
string |
Required. IAM role ARN used during execution. |
|
string |
Required. Entry point in the package ( |
|
|
Required. Deployment package reference. |
|
string |
Optional. Free-form description. |
|
int32 |
Optional. Execution timeout (seconds, default 3). |
|
int32 |
Optional. Memory allocation in MB (default 128). |
|
dictionary |
Optional. Metadata applied to the function. |
Returns |
Type |
Description |
|---|---|---|
|
|
Metadata describing the new function. |
code = aws.lambda.model.FunctionCode(zipFile=aws.core.model.SdkBytes('function.zip'));
resp = lambda.createFunction(functionName="demoFunction", runtime="nodejs20.x", ...
role=roleArn, handler="index.handler", code=code, description="Demo function");
aws.lambda.Client.deleteFunction
Delete a Lambda function, version, or alias.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Name, ARN, version, or alias to delete. |
Returns |
Type |
Description |
|---|---|---|
|
|
Request metadata. |
resp = lambda.deleteFunction(functionName="demoFunction:1");
aws.lambda.Client.initialize
aws.lambda.Client/initialize is a function.
initStat = initialize(obj, regionObj, credentialsProvider)
aws.lambda.Client.invokeFunction
Invoke a Lambda function.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Name or ARN of the function, alias, or version. |
|
string |
Optional. Base64 client context passed through to the handler. |
|
string |
Optional. |
|
string |
Optional. |
|
|
Required. Payload provided to the function. |
|
string |
Optional. Version number or alias. |
Returns |
Type |
Description |
|---|---|---|
|
|
Status code, logs, and payload returned by Lambda. |
payload = aws.core.model.SdkBytes('{"message":"hello"}', 'utf-8');
resp = lambda.invokeFunction(functionName="demoFunction", payload=payload, logType="Tail");
disp(resp.statusCode);
aws.polly
Interfaces for Amazon Polly (voices, lexicons, and speech synthesis).
aws.polly.Client
Superclass: aws.core.BaseClient
MATLAB client for Amazon Polly.
aws.polly.Client.Client
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string | software.amazon.awssdk.regions.Region |
Optional. Target region. |
|
aws.auth.CredentialProvider |
Optional. Credential chain override. |
|
logical |
Optional. Use the AWS Common Runtime HTTP client when true. |
polly = aws.polly.Client('region',"us-east-1");
aws.polly.Client.deleteLexicon
Remove a lexicon from Polly.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Lexicon identifier. |
Returns |
Type |
Description |
|---|---|---|
|
|
Request metadata. |
resp = polly.deleteLexicon(name="medicalTerms");
aws.polly.Client.describeVoices
List available voices.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Optional. Locale filter (e.g., |
|
string |
Optional. |
|
string |
Optional. Pagination token. |
|
logical |
Optional. Include voices supporting additional languages. |
Returns |
Type |
Description |
|---|---|---|
|
|
Voice metadata plus pagination token. |
resp = polly.describeVoices(languageCode="en-US", engine="neural");
aws.polly.Client.getLexicon
Retrieve a lexicon definition.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Lexicon identifier. |
Returns |
Type |
Description |
|---|---|---|
|
|
Lexicon name and XML content. |
resp = polly.getLexicon(name="medicalTerms");
aws.polly.Client.initialize
aws.polly.Client/initialize is a function.
initStat = initialize(obj, regionObj, credentialsProvider)
aws.polly.Client.putLexicon
Upload or overwrite a lexicon.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Lexicon identifier. |
|
string |
Required. Lexicon XML payload. |
Returns |
Type |
Description |
|---|---|---|
|
|
Request metadata. |
xml = fileread("medicalTerms.pls");
resp = polly.putLexicon(name="medicalTerms", content=xml);
aws.polly.Client.synthesizeSpeech
Convert text/SSML into audio or speech marks.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Text/SSML payload. |
|
string |
Required. Voice identifier (e.g., |
|
string |
Optional. |
|
string |
Optional. |
|
string |
Optional. Override locale. |
|
string |
Optional. Sample rate for PCM/MP3 output. |
|
string |
Optional. |
|
string array |
Optional. Speech mark types when |
|
string array |
Optional. Lexicons to apply. |
Returns |
Type |
Description |
|---|---|---|
|
|
Audio bytes, content type, and character usage. |
resp = polly.synthesizeSpeech(text="Hello from MATLAB", voiceId="Joanna");
fwrite(fopen("hello.mp3",'w'), resp.audioStream, 'uint8');
aws.polly.model
aws.polly.model.DeleteLexiconResponse
Superclass: aws.Object
Property |
Type |
Description |
|---|---|---|
|
string |
|
aws.polly.model.DescribeVoicesResponse
Superclass: aws.Object
Property |
Type |
Description |
|---|---|---|
|
aws.polly.model.Voice array |
Voice metadata returned by the API. |
|
string |
Pagination token when more voices remain. |
aws.polly.model.GetLexiconResponse
Superclass: aws.Object
Property |
Type |
Description |
|---|---|---|
|
string |
Name of the lexicon. |
|
string |
Lexicon XML payload. |
aws.polly.model.PutLexiconResponse
Superclass: aws.Object
Property |
Type |
Description |
|---|---|---|
|
string |
|
aws.polly.model.SynthesizeSpeechResponse
Superclass: aws.Object
Property |
Type |
Description |
|---|---|---|
|
uint8 vector |
Raw audio bytes from the response. |
|
string |
MIME type (e.g., |
|
int32 |
Number of billed characters. |
aws.polly.model.Voice
Superclass: aws.Object
Property |
Type |
Description |
|---|---|---|
|
string |
Voice identifier. |
|
string |
Human-readable name. |
|
string |
Locale code (e.g., |
|
string |
Locale name. |
|
string |
Reported gender. |
|
string array |
Engines supported by this voice. |
aws.redshift
aws.redshift.Client
Superclass: aws.core.BaseClient
MATLAB client for Amazon Redshift.
aws.redshift.Client.Client
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string | software.amazon.awssdk.regions.Region |
Optional. Target region. |
|
aws.auth.CredentialProvider |
Optional. Credential source. |
|
logical |
Optional. Use the AWS Common Runtime HTTP client when true. |
redshift = aws.redshift.Client('region',"us-east-1");
aws.redshift.Client.initialize
aws.redshift.Client/initialize is a function.
initStat = initialize(obj, regionObj, credentialsProvider)
aws.redshiftdata
Client and model wrappers for the Amazon Redshift Data API.
aws.redshiftdata.Client
Superclass: aws.core.BaseClient
MATLAB client for submitting SQL statements to Redshift provisioned clusters or serverless workgroups.
aws.redshiftdata.Client.Client
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string | software.amazon.awssdk.regions.Region |
Optional. Target AWS Region. |
|
aws.auth.CredentialProvider |
Optional. Override the credential source. |
|
logical |
Optional. Use the AWS Common Runtime HTTP client when true. |
rs = aws.redshiftdata.Client('region',"us-east-1");
aws.redshiftdata.Client.executeStatement
Run a SQL statement against a provisioned cluster or serverless workgroup.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. SQL statement text. |
|
string |
Required. Database to run the statement in. |
|
string |
Required when targeting a provisioned cluster. Mutually exclusive with |
|
string |
Required when targeting a serverless workgroup. Mutually exclusive with |
|
string |
Optional. Idempotency token. |
|
string |
Optional. Database user to impersonate. |
|
dictionary |
Optional. SQL parameters (name -> scalar value). |
|
string |
Optional. |
|
string |
Optional. Secrets Manager ARN for credentials. |
|
string |
Optional. Existing session identifier. |
|
double |
Optional. Seconds to keep session alive (provisioned only). |
|
string |
Optional. Friendly name for the statement. |
|
logical |
Optional. Publish statement status events to EventBridge. |
Returns |
Type |
Description |
|---|---|---|
|
|
Statement identifier, row counts, timestamps. |
resp = rs.executeStatement( ...
sql="SELECT :x AS value", ...
workgroupName="demo-serverless", ...
database="dev", ...
parameters=dictionary("x", 42));
aws.redshiftdata.Client.getStatementResult
Fetch rows for a previously executed statement.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Identifier returned by |
|
string |
Optional. Pagination token from a prior call. |
Returns |
Type |
Description |
|---|---|---|
|
|
Records, metadata, pagination token. |
page1 = rs.getStatementResult(id=resp.id);
if page1.hasNextToken
page2 = rs.getStatementResult(id=resp.id, nextToken=page1.nextToken);
end
aws.redshiftdata.Client.initialize
aws.redshiftdata.Client/initialize is a function.
initStat = initialize(obj, regionObj, credentialsProvider)
aws.redshiftdata.model.ExecuteStatementResponse
Superclass: aws.Object
Property |
Type |
Description |
|---|---|---|
|
string |
Statement identifier. |
|
string |
Provisioned cluster targeted by the statement. |
|
string |
Serverless workgroup targeted by the statement. |
|
string |
Database name. |
|
logical |
True when the statement produces rows. |
|
double |
Row count for DML statements (if returned). |
|
datetime |
Timestamp when the statement was created (UTC). |
|
datetime |
Timestamp when the statement was last updated (UTC). |
aws.redshiftdata.model.Field
Superclass: aws.Object
Property |
Type |
Description |
|---|---|---|
|
any |
Best-effort MATLAB value (string, double, int64, logical, uint8, or |
|
string |
Raw string representation, when available. |
|
int64 |
Integer representation, when available. |
|
double |
Floating-point representation, when available. |
|
logical |
Boolean representation, when available. |
|
uint8 vector |
Binary payload for VARBYTE columns. |
|
logical |
True when the column is NULL. |
aws.redshiftdata.model.GetStatementResultResponse
Superclass: aws.Object
Property |
Type |
Description |
|---|---|---|
|
struct array |
Column definitions (name, type, length, nullable). |
|
cell array |
Rows of |
|
string |
Pagination token for fetching the next page. |
|
logical |
True when |
|
double |
Reported total row count (if returned by the service). |
aws.redshiftdata.model.GetStatementResultResponse.records
Return the result rows as Field objects.
Returns |
Type |
Description |
|---|---|---|
|
cell array |
Each cell represents a row; each row contains a cell array of |
rows = resp.records();
firstRowValues = cellfun(@(f) f.getValue(), rows{1});
aws.redshiftdata.model.GetStatementResultResponse.getResultSet
Convert the records into a MATLAB table.
Returns |
Type |
Description |
|---|---|---|
|
table |
Table whose variables align with the column metadata. |
tbl = resp.getResultSet();
disp(tbl(1:5,:));
aws.s3
aws.s3.model
aws.s3.model.AccessControlPolicy
Build a custom ACL for buckets or objects.
Name-Value Argument |
Type |
Description |
|---|---|---|
owner |
ws.s3.model.Owner |
Required. Owner metadata. |
grants |
cell array |
Optional. Each cell contains an ws.s3.model.Grant. |
matlab grant = aws.s3.model.Grant(struct(grantee=myGrantee, permission=\"FULL_CONTROL\")); acp = aws.s3.model.AccessControlPolicy(owner=myOwner, grants={grant});
aws.s3.model.CopyObjectResponse
Metadata returned by s3.copyObject.
Property |
Type |
Description |
|---|---|---|
eTag |
string |
Entity tag of the copied object. |
lastModified |
datetime |
Timestamp when the copy finished. |
ersionId |
string |
Version assigned to the new object (if enabled). |
copySourceVersionId |
string |
Version ID of the source object that was copied. |
equestCharged |
string |
Indicates requester-pays usage. |
serverSideEncryption |
string |
SSE algorithm used on the destination object. |
sseCustomerAlgorithm |
string |
SSE-C algorithm, when applicable. |
sseCustomerKeyMD5 |
string |
MD5 checksum of the SSE-C key. |
ssekmsKeyId |
string |
AWS KMS key ARN. |
ssekmsEncryptionContext |
string |
Encryption context for SSE-KMS. |
ucketKeyEnabled |
logical |
rue when S3 Bucket Keys were used. |
aws.s3.model.CreateBucketResponse
Property |
Type |
Description |
|---|---|---|
location |
string |
Region/location constraint reported by S3. |
aws.s3.model.DeleteBucketResponse
Property |
Type |
Description |
|---|---|---|
status |
string |
“Success” after the bucket is removed. |
aws.s3.model.DeleteObjectResponse
Property |
Type |
Description |
|---|---|---|
deleteMarker |
logical |
rue when a delete marker was created. |
ersionId |
string |
Version that was deleted. |
equestCharged |
string |
Indicates requester-pays usage. |
aws.s3.model.GetBucketAclResponse
Property |
Type |
Description |
|---|---|---|
owner |
ws.s3.model.Owner |
Bucket owner metadata. |
grants |
ws.s3.model.Grant array |
ACL entries returned by the service. |
aws.s3.model.GetObjectAclResponse
Property |
Type |
Description |
|---|---|---|
owner |
ws.s3.model.Owner |
Object owner metadata. |
grants |
ws.s3.model.Grant array |
ACL entries describing permissions on the object. |
aws.s3.model.GetObjectResponse
Property |
Type |
Description |
|---|---|---|
contentLength |
int64 |
Object size in bytes. |
contentType |
string |
MIME type reported by S3. |
eTag |
string |
Entity tag assigned by S3. |
lastModified |
Java Instant |
Last-modified timestamp. |
ersionId |
string |
Version identifier when versioning is enabled. |
storageClass |
string |
Storage class enumeration (e.g., STANDARD). |
aws.s3.model.Grant
Construct an ACL grant entry.
Name-Value Argument |
Type |
Description |
|---|---|---|
grantee |
ws.s3.model.Grantee | struct |
Required. Target of the permission. |
permission |
string |
Required. Permission string such as READ, WRITE, or FULL_CONTROL. |
aws.s3.model.Grantee
Represent the subject of an S3 grant.
Name-Value Argument |
Type |
Description |
|---|---|---|
ype |
string |
Required when building from a struct. Use CanonicalUser, AmazonCustomerByEmail, or Group. |
id |
string |
Optional. Canonical user ID. |
displayName |
string |
Optional. Display name associated with the canonical user. |
uri |
string |
Optional. Group URI (for group grants). |
emailAddress |
string |
Optional. Email address when using the email grantee type. |
aws.s3.model.HeadObjectResponse
Property |
Type |
Description |
|---|---|---|
contentLength |
double |
Object size in bytes. |
contentType |
string |
MIME type reported by S3. |
eTag |
string |
Entity tag assigned to the object. |
lastModified |
Java Instant |
Timestamp returned by S3. |
aws.s3.model.ListBucketsResponse
Property |
Type |
Description |
|---|---|---|
uckets |
ws.s3.model.Bucket array |
Metadata for each bucket in the account. |
aws.s3.model.ListObjectsResponse
Property |
Type |
Description |
|---|---|---|
|
|
Objects returned by the listing. |
|
string |
Bucket name echoed by S3. |
aws.s3.model.S3Object
Property |
Type |
Description |
|---|---|---|
|
string |
Object key. |
|
double |
Object size in bytes. |
|
datetime |
UTC timestamp for the object. |
|
string |
Entity tag reported by S3. |
|
string |
Checksum algorithm string. |
|
string |
Storage class such as |
|
|
Owner metadata (when requested). |
aws.s3.model.Owner
Property |
Type |
Description |
|---|---|---|
|
string |
Canonical user ID representing the owner. |
aws.s3.model.Bucket
Property |
Type |
Description |
|---|---|---|
|
string |
Bucket name. |
|
string |
ARN when returned by the API. |
|
string |
Region hint reported by S3. |
|
datetime |
Creation timestamp (UTC). |
aws.s3.model.GetBucketLocationResponse
Property |
Type |
Description |
|---|---|---|
|
string |
Regional constraint such as |
aws.s3.model.PutBucketAclResponse
Property |
Type |
Description |
|---|---|---|
statusCode |
double |
HTTP status returned by the SDK. |
aws.s3.model.PutBucketOwnershipControlsResponse
Property |
Type |
Description |
|---|---|---|
|
double |
HTTP status code returned by S3. |
|
string |
“Success” when the request completed successfully. |
aws.s3.model.PutBucketPolicyResponse
Property |
Type |
Description |
|---|---|---|
statusCode |
double |
HTTP status returned by the SDK. |
aws.s3.model.DeleteBucketPolicyResponse
Property |
Type |
Description |
|---|---|---|
|
double |
HTTP status returned by the SDK. |
|
string |
“Success” when S3 confirms the delete. |
aws.s3.model.DeleteObjectsResponse
Property |
Type |
Description |
|---|---|---|
|
logical |
Indicates whether the response contains deleted keys. |
|
logical |
|
aws.s3.model.PutObjectAclResponse
Property |
Type |
Description |
|---|---|---|
statusCode |
double |
HTTP status returned by the SDK. |
aws.s3.model.PutObjectResponse
Metadata returned by s3.putObject.
Property |
Type |
Description |
|---|---|---|
eTag |
string |
Entity tag assigned to the object. |
ersionId |
string |
Version identifier when versioning is enabled. |
expiration |
string |
Expiration/retention metadata header. |
serverSideEncryption |
string |
SSE algorithm (e.g., AES256, ws:kms). |
sseCustomerAlgorithm |
string |
Algorithm when SSE-C is used. |
sseCustomerKeyMD5 |
string |
MD5 hash of the SSE-C key. |
ssekmsKeyId |
string |
AWS KMS key ARN. |
ssekmsEncryptionContext |
string |
Optional KMS encryption context. |
ucketKeyEnabled |
logical |
Indicates whether S3 Bucket Keys were used. |
equestCharged |
string |
Requester-pays flag. |
size |
double |
Size of the uploaded payload when provided by the SDK. |
aws.s3.model.FileDownload
Property |
Type |
Description |
|---|---|---|
|
logical |
|
aws.s3.model.FileUpload
Property |
Type |
Description |
|---|---|---|
|
logical |
|
aws.s3.transfer
aws.s3.transfer.model
aws.s3.transfer.TransferManager
High-level Amazon S3 transfer client that wraps the AWS SDK v2 TransferManager.
aws.s3.transfer.TransferManager.TransferManager
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string | software.amazon.awssdk.regions.Region |
Optional region override; defaults to the credential provider region. |
|
aws.auth.CredentialProvider |
Optional credential source used for the S3 async client. |
|
struct |
Optional proxy configuration consumed by |
Returns |
Type |
Description |
|---|---|---|
|
|
Configured transfer client for uploads/downloads. |
tm = aws.s3.transfer.TransferManager('region',"us-east-1");
aws.s3.transfer.TransferManager.copy
Copy an object between S3 locations using the high-level TransferManager.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Bucket containing the source object. |
|
string |
Required. Key of the source object. |
|
string |
Required. Target bucket for the copy. |
|
string |
Required. Target key for the new object. |
|
string |
Optional. Canned ACL applied to the destination object. |
|
dictionary |
Optional. Metadata key/value pairs for the copied object. |
Returns |
Type |
Description |
|---|---|---|
|
|
Completed copy job metadata and status. |
tm = aws.s3.transfer.TransferManager();
resp = tm.copy(sourceBucket="src", sourceKey="file.txt", ...
destinationBucket="dest", destinationKey="archive/file.txt");
aws.s3.transfer.TransferManager.delete
DELETE Delete a handle object.
DELETE(H) deletes all handle objects in array H. After the delete
function call, H is an array of invalid objects.
See also AWS.S3.TRANSFER.TRANSFERMANAGER, AWS.S3.TRANSFER.TRANSFERMANAGER/ISVALID, CLEAR
Help for aws.s3.transfer.TransferManager/delete is inherited from superclass handle
aws.s3.transfer.TransferManager.downloadDirectory
Download all objects in a bucket to a local folder.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Bucket to read from. |
|
string |
Required. Destination directory on disk. |
Returns |
Type |
Description |
|---|---|---|
|
|
Completed directory-download job metadata. |
tm = aws.s3.transfer.TransferManager();
resp = tm.downloadDirectory(bucket="datasets", targetDir="local-data");
aws.s3.transfer.TransferManager.downloadFile
Download a single object to the local file system.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Bucket that stores the object. |
|
string |
Required. Key (path) of the object to download. |
|
string |
Required. Destination file path. |
Returns |
Type |
Description |
|---|---|---|
|
|
Transfer job metadata including completion status. |
tm = aws.s3.transfer.TransferManager();
resp = tm.downloadFile(bucket="logs", key="2024.txt", file="local.txt");
aws.s3.transfer.TransferManager.initialize
INITIALIZE Configure the MATLAB session to connect to S3 TransferManager
aws.s3.transfer.TransferManager.uploadDirectory
Upload every file within a local directory to Amazon S3.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Destination bucket. |
|
string |
Required. Directory to upload recursively. |
|
string |
Optional. Key prefix applied to uploaded files. |
Returns |
Type |
Description |
|---|---|---|
|
|
Directory-upload job metadata. |
tm = aws.s3.transfer.TransferManager();
resp = tm.uploadDirectory(bucket="datasets", sourceDir="processed");
aws.s3.transfer.TransferManager.uploadFile
Upload a single file to Amazon S3.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Destination bucket. |
|
string |
Required. Destination object key. |
|
string |
Required. Source file path. |
|
string |
Optional. Canned ACL applied to the upload. |
|
dictionary |
Optional. Metadata key/value pairs. |
|
string |
Optional. MIME type string (e.g., |
Returns |
Type |
Description |
|---|---|---|
|
|
Upload job metadata including completion status. |
tm = aws.s3.transfer.TransferManager();
resp = tm.uploadFile(bucket="logs", key="2024.txt", file="local.txt");
aws.s3.Client
Superclass: aws.core.BaseClient
MATLAB client wrapper for Amazon Simple Storage Service (S3). Use this class to create and manage buckets, upload/download objects, and configure ACL or policy settings.
aws.s3.Client.Client
Creates an Amazon S3 client instance.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string | software.amazon.awssdk.regions.Region |
Optional. Target AWS Region. |
|
aws.auth.CredentialProvider |
Optional. Credential provider returned by |
|
logical |
Optional. Enable the AWS Common Runtime HTTP client when true. |
Returns |
Type |
Description |
|---|---|---|
|
|
Configured MATLAB S3 client. |
cred = aws.auth.CredentialProvider.getDefaultCredentialProvider();
s3 = aws.s3.Client('region',"us-east-1", 'credentialsprovider', cred);
aws.s3.Client.copyObject
Copy an object between S3 locations.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Bucket that owns the source object. |
|
string |
Required. Key of the source object. |
|
string |
Required. Bucket that will contain the copy. |
|
string |
Required. Key for the new object. |
|
string |
Optional. Canned ACL applied to the destination object. |
Returns |
Type |
Description |
|---|---|---|
|
|
Contains ETag, version info, and encryption metadata. |
s3 = aws.s3.Client();
resp = s3.copyObject( ...
sourceBucket="my-source-bucket", sourceKey="src.txt", ...
destinationBucket="my-dest-bucket", destinationKey="dst.txt");
aws.s3.Client.createBucket
Create a new Amazon S3 bucket.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Bucket name. |
|
string |
Optional. Canned ACL such as |
|
aws.s3.model.CreateBucketConfiguration | struct | dictionary |
Optional. Region configuration passed to the AWS SDK builder. |
Returns |
Type |
Description |
|---|---|---|
|
|
Metadata about the create operation. |
s3 = aws.s3.Client();
resp = s3.createBucket(bucket="matlab-demo-bucket");
cfg = aws.s3.model.CreateBucketConfiguration(locationConstraint="us-west-2");
resp = s3.createBucket(bucket="matlab-demo-west", createBucketConfiguration=cfg);
aws.s3.Client.deleteBucket
Delete an empty Amazon S3 bucket.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Bucket name to delete. |
Returns |
Type |
Description |
|---|---|---|
|
|
Request metadata returned by S3. |
s3 = aws.s3.Client();
resp = s3.deleteBucket(bucket="matlab-demo-bucket");
aws.s3.Client.deleteObject
Remove an object (or version) from Amazon S3.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Bucket containing the object. |
|
string |
Required. Object key to delete. |
|
string |
Optional. Version identifier to delete. |
|
string |
Optional. MFA token for protected deletes. |
|
logical |
Optional. Bypass governance retention when true. |
|
string |
Optional. Specify |
|
string |
Optional. AWS Account ID expected to own the bucket. |
Returns |
Type |
Description |
|---|---|---|
|
|
Indicates delete-marker state, version ID, and request charges. |
s3 = aws.s3.Client();
resp = s3.deleteObject(bucket="matlab-demo-bucket", key="logs/output.json");
aws.s3.Client.getBucketAcl
Retrieve the ACL for an S3 bucket.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Target bucket. |
|
string |
Optional. AWS account ID expected to own the bucket. |
Returns |
Type |
Description |
|---|---|---|
|
|
Owner metadata plus grant list. |
s3 = aws.s3.Client();
resp = s3.getBucketAcl(bucket="my-bucket");
disp(resp.owner.displayName);
aws.s3.Client.getBucketLocation
Get the Regional constraint for an S3 bucket.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Bucket whose Region should be returned. |
|
string |
Optional. AWS account ID expected to own the bucket. |
Returns |
Type |
Description |
|---|---|---|
|
|
Regional constraint (for example, |
s3 = aws.s3.Client();
resp = s3.getBucketLocation(bucket="my-bucket");
disp(resp.locationConstraint);
aws.s3.Client.getObject
Download an object from Amazon S3 and obtain a streaming handle.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Bucket name. |
|
string |
Required. Object key inside the bucket. |
Returns |
Type |
Description |
|---|---|---|
|
|
Object metadata (ETag, timestamps, etc.). |
|
|
Stream representing the object payload. |
s3 = aws.s3.Client();
[resp, stream] = s3.getObject(bucket="matlab-demo-bucket", key="docs/readme.txt");
copier = com.mathworks.mlwidgets.io.InterruptibleStreamCopier.getInterruptibleStreamCopier();
bao = java.io.ByteArrayOutputStream();
copier.copyStream(stream, bao);
disp(char(bao.toByteArray()));
aws.s3.Client.getObjectAcl
Retrieve the ACL applied to a stored object.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Bucket containing the object. |
|
string |
Required. Object key. |
|
string |
Optional. Specific version to inspect. |
|
string |
Optional. Specify |
|
string |
Optional. AWS account ID expected to own the bucket. |
Returns |
Type |
Description |
|---|---|---|
|
|
Owner metadata and grant entries. |
s3 = aws.s3.Client();
resp = s3.getObjectAcl(bucket="my-bucket", key="my-object.txt");
disp(resp.owner.displayName);
aws.s3.Client.headObject
Retrieve metadata for an object without downloading it.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Bucket name. |
|
string |
Required. Object key. |
|
string |
Optional. Return metadata only if the ETag matches. |
|
datetime | java.time.Instant |
Optional. Conditional header. |
|
string |
Optional. Return metadata only if the ETag differs. |
|
datetime | java.time.Instant |
Optional. Conditional header. |
|
double |
Optional. Head a particular part of a multipart object. |
|
string |
Optional. Byte range to probe. |
|
string |
Optional. Specify |
|
string |
Optional. SSE-C algorithm used to encrypt the object. |
|
string |
Optional. Base64-encoded SSE-C key. |
|
string |
Optional. Base64 MD5 of the SSE-C key. |
|
string |
Optional. Specific version to inspect. |
|
string |
Optional. AWS account ID expected to own the bucket. |
|
string |
Optional. Enable extended checksum validation when supported. |
Returns |
Type |
Description |
|---|---|---|
|
|
Object metadata (content type, length, ETag, etc.). |
|
logical |
Indicates whether the object exists (true when the call succeeds). |
s3 = aws.s3.Client();
[resp, exists] = s3.headObject(bucket="matlab-demo-bucket", key="logs/output.json");
assert(exists, "Object missing");
disp(resp.contentType);
aws.s3.Client.initialize
aws.s3.Client/initialize is a function.
initStat = initialize(obj, regionObj, credentialsProvider)
aws.s3.Client.listBuckets
List every S3 bucket available to the current account.
Returns |
Type |
Description |
|---|---|---|
|
|
Bucket collection plus owner metadata. |
s3 = aws.s3.Client();
resp = s3.listBuckets();
disp(resp.buckets);
aws.s3.Client.listObjects
List keys within an S3 bucket.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Bucket to enumerate. |
|
string |
Optional. Restrict results to keys with this prefix. |
|
string |
Optional. Character that groups keys hierarchically. |
|
double |
Optional. Maximum number of keys to return (≤ 1000). |
|
string |
Optional. Pagination token from a previous response. |
Returns |
Type |
Description |
|---|---|---|
|
|
Contains object metadata list and pagination hints. |
s3 = aws.s3.Client();
resp = s3.listObjects(bucket="my-bucket", prefix="photos/");
keys = arrayfun(@(obj) obj.key, resp.s3Objects);
aws.s3.Client.deleteBucketPolicy
Remove the bucket policy attached to an S3 bucket.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Bucket name. |
|
string |
Optional. AWS account ID expected to own the bucket. |
Returns |
Type |
Description |
|---|---|---|
|
|
HTTP status information from S3. |
s3 = aws.s3.Client();
resp = s3.deleteBucketPolicy(bucket="my-bucket");
assert(resp.statusCode == 204);
aws.s3.Client.putBucketOwnershipControls
Configure Object Ownership settings for a bucket.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Bucket name. |
|
string |
Required. |
|
string |
Optional. AWS account ID expected to own the bucket. |
Returns |
Type |
Description |
|---|---|---|
|
|
HTTP status information from S3. |
s3 = aws.s3.Client();
resp = s3.putBucketOwnershipControls( ...
bucket="my-bucket", objectOwnership="BucketOwnerPreferred");
aws.s3.Client.putBucketAcl
Set the ACL for an S3 bucket using canned ACLs or explicit grants.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Bucket name. |
|
string |
Optional. Canned ACL such as |
|
aws.s3.model.AccessControlPolicy |
Optional. Explicit owner + grants. |
|
string |
Optional. Header-form grant string. |
|
string |
Optional. Header-form grant string. |
|
string |
Optional. Header-form grant string. |
|
string |
Optional. Header-form grant string. |
|
string |
Optional. Header-form grant string. |
|
string |
Optional. Base64-encoded MD5 of the ACL payload. |
|
string |
Optional. AWS account ID expected to own the bucket. |
Returns |
Type |
Description |
|---|---|---|
|
|
HTTP status information from S3. |
s3 = aws.s3.Client();
resp = s3.putBucketAcl(bucket="my-bucket", acl="public-read");
aws.s3.Client.putBucketPolicy
Set or replace the bucket policy for an S3 bucket.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Bucket name. |
|
string |
Required. Policy JSON text. |
|
logical |
Optional. Confirm removal of the caller’s access. |
|
string |
Optional. AWS account ID expected to own the bucket. |
|
string |
Optional. Base64-encoded MD5 checksum of the policy. |
Returns |
Type |
Description |
|---|---|---|
|
|
HTTP status information from S3. |
s3 = aws.s3.Client();
policyStruct = struct(\"Version\",\"2012-10-17\",\"Statement\", struct( ...
\"Effect\",\"Allow\",\"Principal\",\"*\",\"Action\",\"s3:GetObject\", ...
\"Resource\",\"arn:aws:s3:::my-bucket/*\"));
resp = s3.putBucketPolicy(bucket=\"my-bucket\", policy=jsonencode(policyStruct));
aws.s3.Client.putObject
Upload an object to Amazon S3.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Bucket name. |
|
string |
Required. Destination object key. |
|
aws.core.model.RequestBody |
Required. Payload created via |
|
string |
Optional. Canned ACL such as |
|
string |
Optional. MIME type stored with the object. |
Returns |
Type |
Description |
|---|---|---|
|
|
Upload metadata (ETag, version ID, etc.). |
s3 = aws.s3.Client();
payload = aws.core.model.RequestBody("hello from MATLAB");
resp = s3.putObject(bucket="matlab-demo-bucket", key="greetings.txt", body=payload);
resp = s3.putObject(bucket="matlab-demo-bucket", key="public.txt", body=payload, acl="public-read");
aws.s3.Client.putObjectAcl
Set the ACL for a specific object.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Bucket containing the object. |
|
string |
Required. Object key. |
|
string |
Optional. Canned ACL such as |
|
aws.s3.model.AccessControlPolicy | Java object |
Optional. Custom ACL definition. |
|
string |
Optional. Header-form grant string. |
|
string |
Optional. Header-form grant string. |
|
string |
Optional. Header-form grant string. |
|
string |
Optional. Header-form grant string. |
|
string |
Optional. Header-form grant string. |
|
string |
Optional. Set to |
|
string |
Optional. Target a specific object version. |
|
string |
Optional. AWS account ID expected to own the bucket. |
Returns |
Type |
Description |
|---|---|---|
|
|
HTTP status information from S3. |
s3 = aws.s3.Client();
resp = s3.putObjectAcl(bucket="my-bucket", key="docs/report.pdf", acl="public-read");
aws.s3.Client.saveS3ResponseInputStreamToFile
Persist the ResponseInputStream from getObject to a local file.
Input |
Type |
Description |
|---|---|---|
|
software.amazon.awssdk.core.ResponseInputStream |
Stream returned from |
|
string |
Destination path for the downloaded bytes. |
[resp, inStream] = s3.getObject(bucket="my-bucket", key="logs/output.gz");
s3.saveS3ResponseInputStreamToFile(inStream, "output.gz");
aws.secretsmanager
aws.secretsmanager.model
aws.secretsmanager.model.CreateSecretResponse
Property |
Type |
Description |
|---|---|---|
|
string |
ARN of the secret that was created. |
aws.secretsmanager.model.DeleteSecretResponse
Property |
Type |
Description |
|---|---|---|
|
string |
ARN of the secret that was scheduled for deletion. |
aws.secretsmanager.model.GetSecretValueResponse
Property |
Type |
Description |
|---|---|---|
|
string |
ARN of the secret whose value was fetched. |
|
string |
UTF-8 payload returned by AWS Secrets Manager. |
|
uint8 array |
Binary payload converted from the SDK |
aws.secretsmanager.model.ListSecretsResponse
Property |
Type |
Description |
|---|---|---|
|
aws.secretsmanager.model.SecretListEntry array |
Metadata for each secret returned in the page. |
|
string |
Pagination token for additional results (empty when finished). |
aws.secretsmanager.model.RestoreSecretResponse
Property |
Type |
Description |
|---|---|---|
|
string |
ARN of the restored secret. |
|
string |
Friendly name of the restored secret. |
aws.secretsmanager.model.SecretListEntry
Property |
Type |
Description |
|---|---|---|
|
string |
ARN that uniquely identifies the secret. |
|
string |
Description assigned to the secret. |
|
string |
KMS key ID used to encrypt the secret (if customer managed). |
|
string |
Name of the secret. |
|
datetime |
MATLAB |
aws.secretsmanager.model.UpdateSecretResponse
Property |
Type |
Description |
|---|---|---|
|
string |
ARN of the updated secret. |
|
string |
Name of the updated secret. |
|
string |
Identifier of the newly created secret version. |
aws.secretsmanager.Client
Interact with AWS Secrets Manager to create, rotate, restore, and retrieve application secrets.
aws.secretsmanager.Client.Client
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Optional. Region override for the client. |
|
aws.auth.CredentialProvider |
Optional. Custom credentials provider instance. |
aws.secretsmanager.Client.createSecret
Create a new secret containing text or binary data.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Unique name for the secret (can include path-style segments). |
|
string |
Required when not sending |
|
aws.core.model.SdkBytes |
Optional. Binary secret payload (use |
|
string |
Optional. Description for operators. |
|
dictionary |
Optional. Map of tag key -> value strings applied to the secret. |
Returns |
Type |
Description |
|---|---|---|
|
|
ARN/metadata for the new secret. |
aws.secretsmanager.Client.deleteSecret
Schedule a secret for deletion.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Secret ARN or friendly name. |
|
int64 |
Optional. Number of days (7-30) before permanent removal. |
|
logical |
Optional. Set |
Returns |
Type |
Description |
|---|---|---|
|
|
ARN of the deleted/queued secret. |
aws.secretsmanager.Client.getSecretValue
Retrieve the latest or a specific version of a secret.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Secret ARN or name. |
|
string |
Optional. Specific version identifier to fetch. |
Returns |
Type |
Description |
|---|---|---|
|
|
Contains text or binary secret payload. |
aws.secretsmanager.Client.initialize
aws.secretsmanager.Client/initialize is a function.
aws.secretsmanager.Client.listSecrets
List secrets in the account with optional pagination.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Optional. Continue listing from a prior response. |
|
int32 |
Optional. Limit the number of entries returned. |
|
string |
Optional. |
Returns |
Type |
Description |
|---|---|---|
|
|
Page of secret metadata plus |
aws.secretsmanager.Client.restoreSecret
Restore a secret that is pending deletion within its recovery window.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Secret ARN or name scheduled for deletion. |
Returns |
Type |
Description |
|---|---|---|
|
|
Metadata for the restored secret. |
aws.secretsmanager.Client.updateSecret
Create a new version of an existing secret with updated metadata or payload.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Secret ARN or name to update. |
|
string |
Optional. New plaintext secret to store. |
|
aws.core.model.SdkBytes |
Optional. New binary payload. |
|
string |
Optional. Updated description text. |
|
string |
Optional. Customer managed CMK ARN/ID for encryption. |
|
string |
Optional. Idempotency token you control. |
Returns |
Type |
Description |
|---|---|---|
|
|
ARN, name, and new version ID. |
aws.sns
aws.sns.model
aws.sns.model.ConfirmSubscriptionResponse
Property |
Type |
Description |
|---|---|---|
|
string |
ARN assigned when the token is confirmed. |
aws.sns.model.CreateTopicResponse
Property |
Type |
Description |
|---|---|---|
|
string |
ARN of the created (or existing) topic. |
aws.sns.model.DeleteTopicResponse
Property |
Type |
Description |
|---|---|---|
|
int32 |
HTTP status returned by the SDK for diagnostics. |
aws.sns.model.GetSubscriptionAttributesResponse
Property |
Type |
Description |
|---|---|---|
|
dictionary |
Map of subscription attributes (string -> string). |
aws.sns.model.GetTopicAttributesResponse
Property |
Type |
Description |
|---|---|---|
|
dictionary |
Topic attributes represented as string pairs. |
aws.sns.model.ListSubscriptionsResponse
Property |
Type |
Description |
|---|---|---|
|
struct array |
Each entry exposes |
|
string |
Pagination token for additional pages. |
aws.sns.model.ListTopicsResponse
Property |
Type |
Description |
|---|---|---|
|
string array |
Topic ARNs returned in this page. |
|
string |
Pagination token when more results remain. |
aws.sns.model.MessageAttributeValue
Represents per-message attributes for the publish API.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. SNS data type such as “String”, “Number”, or “Binary”. |
|
string |
Optional. Text payload for the attribute. |
|
aws.core.model.SdkBytes |
Optional. Binary payload when |
aws.sns.model.PublishResponse
Property |
Type |
Description |
|---|---|---|
|
string |
Identifier assigned to the published message. |
aws.sns.model.SubscribeResponse
Property |
Type |
Description |
|---|---|---|
|
string |
Subscription ARN or “pending confirmation”. |
aws.sns.model.UnsubscribeResponse
Property |
Type |
Description |
|---|---|---|
|
int32 |
HTTP status returned by the SDK. |
aws.sns.Client
Interact with Amazon Simple Notification Service topics and subscriptions.
aws.sns.Client.Client
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Optional region override; defaults to the credential provider region. |
|
aws.auth.CredentialProvider |
Optional credentials source. |
|
logical |
When |
Returns |
Type |
Description |
|---|---|---|
|
|
Client configured for the requested region. |
sns = aws.sns.Client('region',"us-east-1");
aws.sns.Client.confirmSubscription
Confirm a pending subscription token.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Topic ARN being confirmed. |
|
string |
Required. Token from the Subscribe confirmation message. |
|
string |
Optional. Set to “true” to enforce authenticated unsubscribe requests. |
Returns |
Type |
Description |
|---|---|---|
|
|
Contains the confirmed subscription ARN. |
aws.sns.Client.createTopic
Create (or retrieve) an SNS topic.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Topic name (FIFO topics must end with |
|
dictionary |
Optional. Topic attributes (e.g., |
|
dictionary |
Optional. Cost allocation tags (string -> string). |
Returns |
Type |
Description |
|---|---|---|
|
|
Provides the topic ARN. |
aws.sns.Client.deleteTopic
Delete an SNS topic.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. ARN of the topic to delete. |
Returns |
Type |
Description |
|---|---|---|
|
|
HTTP status metadata. |
aws.sns.Client.getSubscriptionAttributes
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Subscription ARN to inspect. |
Returns |
Type |
Description |
|---|---|---|
|
|
Attribute map with key/value strings. |
aws.sns.Client.getTopicAttributes
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Topic ARN to inspect. |
Returns |
Type |
Description |
|---|---|---|
|
|
Attribute map with key/value strings. |
aws.sns.Client.listSubscriptions
List subscriptions with optional pagination.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Optional. Continue from a previous response. |
Returns |
Type |
Description |
|---|---|---|
|
|
Subscription structs plus |
aws.sns.Client.listTopics
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Optional. Continue from a previous |
Returns |
Type |
Description |
|---|---|---|
|
|
Topic ARNs plus pagination token. |
aws.sns.Client.publish
Publish a payload to a topic or endpoint.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required when publishing to a topic. |
|
string |
Required. UTF-8 payload. |
|
string |
Optional. Subject line (<= 100 chars). |
|
dictionary |
Optional. Map of attribute name -> |
Returns |
Type |
Description |
|---|---|---|
|
|
Contains the published message ID. |
aws.sns.Client.subscribe
Register an endpoint with a topic.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Topic to subscribe to. |
|
string |
Required. Delivery protocol ( |
|
string |
Required. Endpoint ARN, email address, or URL. |
Returns |
Type |
Description |
|---|---|---|
|
|
Contains the subscription ARN or |
aws.sns.Client.unsubscribe
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Subscription to remove. |
Returns |
Type |
Description |
|---|---|---|
|
|
HTTP status metadata. |
aws.sqs
aws.sqs.model
aws.sqs.model.CreateQueueResponse
Property |
Type |
Description |
|---|---|---|
queueUrl |
string |
URL of the created queue. |
aws.sqs.model.DeleteMessageResponse
Property |
Type |
Description |
|---|---|---|
statusCode |
int32 |
HTTP status returned by the SDK. |
aws.sqs.model.DeleteQueueResponse
Superclass: aws.Object
DELETEQUEUERESPONSE Object to represent the Response of a deleteQueue
call. This class encapsulates the response from the DeleteQueue operation
in Amazon SQS. Typically, the operation is confirmed by the absence
of exceptions.
aws.sqs.model.DeleteQueueResponse.DeleteQueueResponse
DELETEQUEUERESPONSE Object to represent the Response of a deleteQueue
call. This class encapsulates the response from the DeleteQueue operation
in Amazon SQS. Typically, the operation is confirmed by the absence
of exceptions.
aws.sqs.model.GetQueueAttributesResponse
Superclass: aws.Object
GETQUEUEATTRIBUTESRESPONSE Object to represent the result of a getQueueAttributes call.
This class encapsulates the response from the GetQueueAttributes operation
in Amazon SQS, providing access to the queue attributes as a dictionary.
Example:
getQueueAttributesResult = sqs.getQueueAttributes(queueUrl, attributeNames);
attributes = getQueueAttributesResult.attributes;
maximumMessageSize = attributes("MaximumMessageSize");
aws.sqs.model.GetQueueAttributesResponse.GetQueueAttributesResponse
GETQUEUEATTRIBUTESRESPONSE Object to represent the result of a getQueueAttributes call.
This class encapsulates the response from the GetQueueAttributes operation
in Amazon SQS, providing access to the queue attributes as a dictionary.
Example:
getQueueAttributesResult = sqs.getQueueAttributes(queueUrl, attributeNames);
attributes = getQueueAttributesResult.attributes;
maximumMessageSize = attributes("MaximumMessageSize");
aws.sqs.model.ListQueuesResponse
Superclass: aws.Object
LISTQUEUESRESPONSE Response object for listing SQS queues.
This class encapsulates the response from the ListQueues operation
in Amazon SQS, providing access to the list of queue URLs.
Example:
listQueuesResponse = sqs.listQueues();
queueUrls = listQueuesResponse.queueUrls;
aws.sqs.model.ListQueuesResponse.ListQueuesResponse
LISTQUEUESRESPONSE Response object for listing SQS queues.
This class encapsulates the response from the ListQueues operation
in Amazon SQS, providing access to the list of queue URLs.
Example:
listQueuesResponse = sqs.listQueues();
queueUrls = listQueuesResponse.queueUrls;
aws.sqs.model.Message
Superclass: aws.Object
MESSAGE Object to represent an SQS message
Example:
receiveMessageResult = sqs.receiveMessage(queueUrl);
messages = receiveMessageResult.getMessages();
for n = 1:numel(messages)
id = messages{n}.getMessageId();
receiptHandle = messages{n}.getReceiptHandle();
body = messages{n}.getBody();
end
aws.sqs.model.Message.Message
MESSAGE Object to represent an SQS message
Example:
receiveMessageResult = sqs.receiveMessage(queueUrl);
messages = receiveMessageResult.getMessages();
for n = 1:numel(messages)
id = messages{n}.getMessageId();
receiptHandle = messages{n}.getReceiptHandle();
body = messages{n}.getBody();
end
aws.sqs.model.ReceiveMessageResponse
Superclass: aws.Object
RECEIVEMESSAGERESPONSE Response object for receiving messages from an SQS queue.
This class encapsulates the response from the ReceiveMessage operation
in Amazon SQS, providing access to the messages received.
Example:
receiveMessageResponse = sqs.receiveMessage(receiveMessageRequest);
messagesReceived = receiveMessageResponse.messages
aws.sqs.model.ReceiveMessageResponse.ReceiveMessageResponse
RECEIVEMESSAGERESPONSE Response object for receiving messages from an SQS queue.
This class encapsulates the response from the ReceiveMessage operation
in Amazon SQS, providing access to the messages received.
Example:
receiveMessageResponse = sqs.receiveMessage(receiveMessageRequest);
messagesReceived = receiveMessageResponse.messages
aws.sqs.model.SendMessageResponse
Superclass: aws.Object
SENDMESSAGERESPONSE Response object for sending a message to an SQS queue.
This class encapsulates the response from the SendMessage operation
in Amazon SQS, providing access to message ID and other relevant
response properties.
aws.sqs.model.SendMessageResponse.SendMessageResponse
SENDMESSAGERESPONSE Response object for sending a message to an SQS queue.
This class encapsulates the response from the SendMessage operation
in Amazon SQS, providing access to message ID and other relevant
response properties.
aws.sqs.model.SetQueueAttributesResponse
Superclass: aws.Object
SETQUEUEATTRIBUTESRESPONSE Object to represent the result of a setQueueAttributes call.
This class encapsulates the response from the SetQueueAttributes operation
in Amazon SQS. Since setting attributes typically does not return data,
this class is primarily used for consistency and potential future extensions.
aws.sqs.model.SetQueueAttributesResponse.SetQueueAttributesResponse
SETQUEUEATTRIBUTESRESPONSE Object to represent the result of a setQueueAttributes call.
This class encapsulates the response from the SetQueueAttributes operation
in Amazon SQS. Since setting attributes typically does not return data,
this class is primarily used for consistency and potential future extensions.
aws.sqs.model.ChangeMessageVisibilityResponse
Superclass: aws.Object
CHANGEMESSAGEVISIBILITYRESPONSE Object to represent the result of a ChangeMessageVisibility call.
This class encapsulates the response metadata returned after updating the visibility
timeout for a single message. The HTTP status code is exposed for diagnostics.
Example:
resp = sqs.changeMessageVisibility(queueUrl='url', receiptHandle='handle', visibilityTimeout=120);
status = resp.statusCode;
aws.sqs.model.ChangeMessageVisibilityResponse.ChangeMessageVisibilityResponse
CHANGEMESSAGEVISIBILITYRESPONSE Object to represent the result of a ChangeMessageVisibility call.
This class encapsulates the response metadata returned after updating the visibility
timeout for a single message. The HTTP status code is exposed for diagnostics.
aws.sqs.model.ChangeMessageVisibilityBatchResponse
Superclass: aws.Object
CHANGEMESSAGEVISIBILITYBATCHRESPONSE Object to represent the result of a ChangeMessageVisibilityBatch call.
The response exposes two collections, one for successful entries and another for failures,
matching the AWS SDK response structure.
Example:
resp = sqs.changeMessageVisibilityBatch(queueUrl='url', entries=entriesStruct);
successes = resp.successful;
failures = resp.failed;
aws.sqs.model.ChangeMessageVisibilityBatchResponse.ChangeMessageVisibilityBatchResponse
CHANGEMESSAGEVISIBILITYBATCHRESPONSE Object to represent the result of a ChangeMessageVisibilityBatch call.
The response exposes two collections, one for successful entries and another for failures,
matching the AWS SDK response structure.
aws.sqs.model.ChangeMessageVisibilityBatchResultEntry
Superclass: aws.Object
CHANGEMESSAGEVISIBILITYBATCHRESULTENTRY Represents one successful entry from ChangeMessageVisibilityBatch.
Only the identifier supplied in the request is returned when the update succeeds.
aws.sqs.model.ChangeMessageVisibilityBatchResultEntry.ChangeMessageVisibilityBatchResultEntry
CHANGEMESSAGEVISIBILITYBATCHRESULTENTRY Represents one successful entry from ChangeMessageVisibilityBatch.
Only the identifier supplied in the request is returned when the update succeeds.
aws.sqs.model.BatchResultErrorEntry
Superclass: aws.Object
BATCHRESULTERRORENTRY Represents an error for one entry in a batch queue operation.
Contains the entry ID, error code, message, and whether the failure was caused
by the caller (senderFault = true).
aws.sqs.model.BatchResultErrorEntry.BatchResultErrorEntry
BATCHRESULTERRORENTRY Represents an error for one entry in a batch queue operation.
Contains the entry ID, error code, message, and whether the failure was caused
by the caller (senderFault = true).
aws.sqs.Client
Superclass: aws.core.BaseClient
CLIENT Amazon Simple Queue Service (SQS) Client
This client is used to interact with the Amazon SQS service, allowing
you to send, receive, and manage messages in your queues.
Example:
sqs = aws.sqs.Client();
% Perform operations with SQS
sqs.createQueue('myQueueName');
Authentication Credentials - Please see the authentication section
of the documentation for more details.
aws.sqs.Client.Client
CLIENT Amazon Simple Queue Service (SQS) Client
This client is used to interact with the Amazon SQS service, allowing
you to send, receive, and manage messages in your queues.
Example:
sqs = aws.sqs.Client();
% Perform operations with SQS
sqs.createQueue('myQueueName');
Authentication Credentials - Please see the authentication section
of the documentation for more details.
aws.sqs.Client.createQueue
CREATEQUEUE Creates a new Amazon SQS queue and returns a CreateQueueResponse object.
This function facilitates the creation of a queue in Amazon SQS. It supports
various options for configuration. For more detailed queue creation, consider
using the underlying AWS SDK classes and methods directly.
Arguments:
queueName : The name of the new queue.
Optional Arguments:
attributesWithStrings : A map of attributes with their corresponding values.
tags : Cost allocation tags for the queue.
Example:
sqs = aws.sqs.Client()
createQueueResponse = sqs.createQueue(queueName='queue_name')
OR
attr = dictionary({'MaximumMessageSize', 'DelaySeconds'}, {'262144', '5'});
createQueueResponse = sqs.createQueue(queueName='queue_name', attributesWithStrings = attr);
aws.sqs.Client.deleteMessage
Remove a message from an SQS queue using its receipt handle.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Queue URL containing the message. |
|
string |
Required. Handle returned by |
Returns |
Type |
Description |
|---|---|---|
|
|
HTTP metadata confirming the delete call. |
resp = sqs.deleteMessage(queueUrl=myQueueUrl, receiptHandle=handle);
aws.sqs.Client.deleteQueue
Delete an SQS queue.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Queue URL to remove. |
Returns |
Type |
Description |
|---|---|---|
|
|
HTTP metadata returned by the SDK. |
resp = sqs.deleteQueue(queueUrl=myQueueUrl);
aws.sqs.Client.getQueueAttributes
GETQUEUEATTRIBUTES Retrieves attributes for the specified Amazon SQS queue.
This function retrieves attributes from a specified SQS queue. It supports
optional configurations to specify which attributes to retrieve.
Arguments:
queueUrl : The URL of the Amazon SQS queue from which attributes are retrieved.
Optional Arguments:
attributeNamesWithStrings : Names of the attributes to retrieve.
Example:
sqs = aws.sqs.Client();
getQueueAttributesResponse = sqs.getQueueAttributes(queueUrl='queueUrl');
OR
getQueueAttributesResponse = sqs.getQueueAttributes(queueUrl='queueUrl', attributeNamesWithStrings = ["All"]);
aws.sqs.Client.initialize
aws.sqs.Client/initialize is a function.
initStat = initialize(obj, regionObj, credentialsProvider)
aws.sqs.Client.listQueues
LISTQUEUES Lists the Amazon SQS queues.
This function retrieves a list of SQS queues. It supports optional configurations
to filter the queues based on specific criteria.
Optional Arguments:
queueNamePrefix : A string to use for filtering the list results.
maxResults : The maximum number of results to return.
nextToken : Token to specify where to start paginating.
Example:
sqs = aws.sqs.Client();
listQueuesResponse = sqs.listQueues();
OR
listQueuesResponse = sqs.listQueues(queueNamePrefix = 'myQueue', maxResults = 10);
aws.sqs.Client.receiveMessage
RECEIVEMESSAGE Receives messages from the specified Amazon SQS queue.
This function retrieves messages from a specified SQS queue. It supports
various optional configurations to customize the message retrieval process.
Arguments:
queueUrl : The URL of the Amazon SQS queue from which messages are received.
Optional Arguments:
maxNumberOfMessages : The maximum number of messages to return.
messageAttributeNames : Names of the message attributes to retrieve.
messageSystemAttributeNamesWithStrings : System attributes to retrieve with each message.
visibilityTimeout : Duration (in seconds) messages are hidden after retrieval.
waitTimeSeconds : Duration (in seconds) to wait for a message to arrive.
receiveRequestAttemptId : Applies only to FIFO queues.
Example:
sqs = aws.sqs.Client();
receiveMessageResponse = sqs.receiveMessage(queueUrl='queueUrl');
OR
receiveMessageResponse = sqs.receiveMessage(queueUrl='queueUrl', maxNumberOfMessages = 5, waitTimeSeconds = 10);
aws.sqs.Client.sendMessage
SENDMESSAGE Sends a message to the specified Amazon SQS queue.
A message can include only XML, JSON, and unformatted text. The following
Unicode characters are allowed:
#x9 | #xA | #xD | #x20 to #xD7FF | #xE000 to #xFFFD | #x10000 to #x10FFFF
Any characters not included in this list will be rejected.
Duplicate messages are allowed. A SendMessageResponse object is returned.
The upper limit and default maximum message size is 262144 bytes.
Arguments:
queueUrl : The URL of the Amazon SQS queue to which the message is sent.
messageBody : The body of the message to be sent.
Optional Arguments:
delaySeconds : The duration (in seconds) to delay the message.
messageAttributes : Custom attributes to be associated with the message.
messageDeduplicationId : A token used for deduplication of sent messages.
messageGroupId : Tag that specifies that a message belongs to a specific message group.
Example:
sqs = aws.sqs.Client();
sendMessageResponse = sqs.sendMessage(queueUrl='queue_Url', messageBody='Hello, World!');
OR
sendMessageResponse = sqs.sendMessage(queueUrl='queue_Url', messageBody='Hello, World!', delaySeconds = 5);
aws.sqs.Client.setQueueAttributes
SETQUEUEATTRIBUTES Sets attributes for the specified Amazon SQS queue.
This function sets attributes for a specified SQS queue. The attributes
should be provided as a dictionary. When you change a queue's attributes
the change can take up to 60 seconds for the attributes to propagate
throughout the SQS system. However, changes made to the MessageRetentionPeriod
attribute can take up to 15 minutes. A list of parameters can be found
in the parameters section
Arguments:
queueUrl : The URL of the Amazon SQS queue to which attributes are set.
attributesWithStrings : A dictionary or structure containing attribute names and values.
Example:
sqs = aws.sqs.Client();
attributes = dictionary(["VisibilityTimeout", "MaximumMessageSize"], ["60", "262144"]);
setQueueAttributesResponse = sqs.setQueueAttributes(queueUrl='queueUrl', attributesWithStrings = attributes);
aws.sqs.Client.changeMessageVisibility
CHANGEMESSAGEVISIBILITY Changes the visibility timeout for a single message.
Arguments:
queueUrl : The URL of the queue that contains the message.
receiptHandle : The receipt handle returned by receiveMessage.
visibilityTimeout : The new timeout value (0 to 43200 seconds).
Example:
resp = sqs.changeMessageVisibility(queueUrl='queueUrl', ...
receiptHandle='handle', visibilityTimeout=120);
aws.sqs.Client.changeMessageVisibilityBatch
CHANGEMESSAGEVISIBILITYBATCH Changes visibility timeouts for up to 10 messages.
Arguments:
queueUrl : The URL of the queue that contains the messages.
entries : Struct array with fields id, receiptHandle, visibilityTimeout.
Each struct element represents one batch entry.
Example:
entries = struct( ...
'id', ["msg1","msg2"], ...
'receiptHandle', ["handle1","handle2"], ...
'visibilityTimeout', [60 180]);
resp = sqs.changeMessageVisibilityBatch(queueUrl='queueUrl', entries=entries);
aws.ssm
Manage AWS Systems Manager documents and Parameter Store values from MATLAB.
aws.ssm.model
aws.ssm.model.CreateDocumentResponse
Property |
Type |
Description |
|---|---|---|
|
aws.ssm.model.DocumentDescription |
Metadata for the newly created document. |
aws.ssm.model.DeleteDocumentResponse
Property |
Type |
Description |
|---|---|---|
|
string |
Returns “Success” when the document delete request completed. |
aws.ssm.model.DeleteParameterResponse
Property |
Type |
Description |
|---|---|---|
|
string |
Returns “Success” when the parameter delete request completed. |
aws.ssm.model.DocumentDescription
Property |
Type |
Description |
|---|---|---|
|
string |
Document name. |
|
string |
Classification such as “Command” or “Automation”. |
|
string |
“JSON” or “YAML”. |
|
string |
Current publication status. |
|
string |
Friendly alias for the version, when supplied. |
|
string |
Version number assigned by Systems Manager. |
aws.ssm.model.GetParameterResponse
Property |
Type |
Description |
|---|---|---|
|
string |
Parameter name. |
|
string |
Amazon Resource Name identifying the parameter. |
|
string |
“String”, “StringList”, or “SecureString”. |
|
string |
Parameter value (decrypted when |
|
double |
Parameter version number. |
aws.ssm.model.PutParameterResponse
Property |
Type |
Description |
|---|---|---|
|
double |
Version assigned after the put/update call. |
aws.ssm.Client
Interact with Systems Manager documents and Parameter Store from MATLAB.
aws.ssm.Client.Client
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Optional region override; defaults to the shared credential region. |
|
aws.auth.CredentialProvider |
Optional custom credential chain. |
|
logical |
Use the AWS Common Runtime HTTP stack when |
Returns |
Type |
Description |
|---|---|---|
|
|
Client configured for Systems Manager API calls. |
ssm = aws.ssm.Client('region',"us-east-1");
aws.ssm.Client.createDocument
Create or update a Systems Manager document.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. JSON or YAML definition of the document body. |
|
string |
Required. Friendly name for the document. |
|
string |
Required. “Command”, “Policy”, “Automation”, “Session”, “Package”, “ApplicationConfiguration”, “ApplicationConfigurationSchema”, “DeploymentStrategy”, or “ChangeCalendar”. |
|
string |
Optional. “JSON” (default) or “YAML”. |
Returns |
Type |
Description |
|---|---|---|
|
|
Contains the resulting document metadata. |
aws.ssm.Client.deleteDocument
Remove a Systems Manager document.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Name of the document to delete. |
Returns |
Type |
Description |
|---|---|---|
|
|
Delete status metadata. |
aws.ssm.Client.deleteParameter
Remove a parameter from the Parameter Store.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Fully-qualified parameter name. |
Returns |
Type |
Description |
|---|---|---|
|
|
Delete status metadata. |
aws.ssm.Client.getParameter
Read a Parameter Store value.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Parameter path or friendly name. |
|
logical |
Optional. Set |
Returns |
Type |
Description |
|---|---|---|
|
|
Contains the parameter metadata and value. |
aws.ssm.Client.initialize
aws.ssm.Client/initialize is a function.
initStat = initialize(obj, regionObj, credentialsProvider)
aws.ssm.Client.putParameter
Create or update a Parameter Store value.
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string |
Required. Parameter path or name. |
|
string |
Required. Value to store. |
|
string |
Optional. “String” (default), “StringList”, or “SecureString”. |
|
logical |
Optional. Set |
Returns |
Type |
Description |
|---|---|---|
|
|
Provides the resulting version number. |
aws.sts
aws.sts.model
aws.sts.model.GetCallerIdentityResponse
Superclass: aws.Object
Represents the metadata returned by getCallerIdentity.
Property |
Type |
Description |
|---|---|---|
|
string |
AWS account ID of the caller. |
|
string |
Full ARN (user or role) of the caller. |
|
string |
IAM user or role unique identifier. |
resp = sts.getCallerIdentity();
disp(resp.arn);
aws.sts.model.GetCallerIdentityResponse.GetCallerIdentityResponse
Wrap an existing AWS SDK response.
javaResp = software.amazon.awssdk.services.sts.model.GetCallerIdentityResponse.builder() ...
.account("123456789012").arn("arn:aws:iam::123456789012:user/demo").userId("demo").build();
resp = aws.sts.model.GetCallerIdentityResponse(javaResp);
aws.sts.Client
Superclass: aws.core.BaseClient
aws.sts.Client.Client
Name-Value Argument |
Type |
Description |
|---|---|---|
|
string | software.amazon.awssdk.regions.Region |
Optional. Region override. |
|
aws.auth.CredentialProvider |
Optional. Credential provider override. |
|
logical |
Optional. Use the AWS Common Runtime HTTP client when true. |
sts = aws.sts.Client('region',"us-east-1");
aws.sts.Client.getCallerIdentity
Retrieve the AWS Account, ARN, and user ID for the current credentials.
Returns |
Type |
Description |
|---|---|---|
|
|
Caller identity metadata. |
resp = sts.getCallerIdentity();
fprintf("Caller ARN: %s\n", resp.arn);
aws.sts.Client.initialize
aws.sts.Client/initialize is a function.
initStat = initialize(obj, regionObj, credentialsProvider)
aws.Object
Superclass: handle
Shared base class for every MATLAB AWS wrapper. Provides logging, proxy-configuration helpers, and a placeholder for the underlying Java handle.
aws.Object.Object
Construct the base helper. Subclasses call this automatically when they
inherit from aws.Object.
aws.Object.configProxyHttpClient
Build an Apache HTTP client builder that honors obj.ProxyConfiguration.
Returns |
Type |
Description |
|---|---|---|
|
|
Configured builder or empty when no proxy settings are defined. |
aws.Object.initializeLogger
Configure the shared logger prefix used by MATLAB AWS objects.
Positional Argument |
Type |
Description |
|---|---|---|
|
string |
Optional. Prefix added to every log message. |
aws.Object.useMATLABProxyPrefs
Populate ProxyConfiguration using MATLAB’s proxy preferences (and the
system proxy on Windows) when no proxy host is currently set.
Positional Argument |
Type |
Description |
|---|---|---|
|
string |
Optional. URL used when querying the host OS for proxy settings. |
Logger
LOGGER Robust, extensible logger for MATLAB scripts and applications.
Provides log levels, colored output, file logging with rotation,
and JSON/plain text formats.
================
Syntax
================
log = Logger.getLogger();
log.write(level, message, ...);
================
Examples
================
% Get the singleton logger
log = Logger.getLogger();
% Set options
log.MsgPrefix = 'MYAPP';
log.LogFile = 'myapp.log';
log.LogFormat = 'json'; % or 'plain'
log.MaxLogFileSize = 1e6; % 1 MB for testing
log.MaxLogFiles = 3;
% Log various messages
log.write('info', 'Starting process at %s', datestr(now));
log.write('debug', 'Debug value: %.3f', pi);
log.write('warning', 'This is a warning');
log.write('error', 'This is an error: %s', 'something failed');
log.write('verbose', 'Extra details: %d', 42);
% Get logged messages (in memory)
msgs = log.getMessages('info');
disp(msgs);
% Clear in-memory and file logs
log.clearMessages();
log.clearLogFile();
================
Supported Levels
================
'verbose', 'debug', 'info', 'warning', 'error'
================
Properties
================
LogFile - Log file path (empty = no file logging)
LogFormat - 'plain' or 'json'
MsgPrefix - Custom prefix for all messages
FileLogLevel - Minimum level for file logging
DisplayLogLevel - Minimum level for command window
MaxLogFileSize - Max log file size in bytes before rotation
MaxLogFiles - Number of rotated log files to keep
See also: Logger.getLogger, Logger.write, Logger.getMessages
aws
AWS, a wrapper to the AWS CLI utility
The function assumes AWS CLI is installed and configured with authentication
details. This wrapper allows use of the AWS CLI within the
MATLAB environment.
Examples:
aws('s3api list-buckets')
Alternatively:
aws s3api list-buckets
If no output is specified, the command will echo this to the MATLAB
command window. If the output variable is provided it will convert the
output to a MATLAB object.
[status, output] = aws('s3api','list-buckets');
output =
struct with fields:
Owner: [1x1 struct]
Buckets: [15x1 struct]
By default a struct is produced from the JSON format output.
If the --output [text|table] flag is set a char vector is produced.
awsCommonRoot
AWSCOMMONROOT Helper function to locate the AWS Common location
Locate the installation of the AWS interface package to allow easier construction
of absolute paths to the required dependencies.
awsRoot
AWSROOT Function to locate the installation folder for the tooling
awsRoot alone will return the root for the MATLAB code in the project.
awsRoot with additional arguments will add these to the path
funDir = awsRoot('app', 'functions')
The special argument of a negative number will move up folders, e.g.
the following call will move up two folders, and then into
Documentation.
docDir = awsRoot(-2, 'Documentation')
homedir
HOMEDIR Function to return the home directory
This function will return the users home directory.
isEC2
ISEC2 returns true if running on AWS EC2 otherwise returns false
loadConfigurationSettings
LOADCONFIGURATIONSETTINGS Method to read a JSON configuration settings from a file
The file name must be as a specified argument.
JSON values must be compatible with MATLAB JSON conversion rules.
See jsondecode() help for details. A MATLAB struct is returned.
Field names are case sensitive.
loadKeyPair
LOADKEYPAIR2CERT Reads public and private key files and returns a key pair
The key pair returned is of type java.security.KeyPair
Algorithms supported by the underlying java.security.KeyFactory library
are: DiffieHellman, DSA & RSA.
However S3 only supports RSA at this point.
If only the public key is a available e.g. the private key belongs to
somebody else then we can still create a keypair to encrypt data only
they can decrypt. To do this we replace the private key file argument
with 'null'.
Example:
myKeyPair = loadKeyPair('c:\Temp\mypublickey.key', 'c:\Temp\myprivatekey.key')
encryptOnlyPair = loadKeyPair('c:\Temp\mypublickey.key')
saveKeyPair
SAVEKEYPAIR Writes a key pair to two files for the public and private keys
The key pair should be of type java.security.KeyPair
Example:
saveKeyPair(myKeyPair, 'c:\Temp\mypublickey.key', 'c:\Temp\myprivatekey.key')
unlimitedCryptography
UNLIMITEDCRYPTOGRAPHY Returns true if unlimited cryptography is installed
Otherwise false is returned.
Tests using the AES algorithm for greater than 128 bits if true then this
indicates that the policy files have been changed to enabled unlimited
strength cryptography.
writeSTSCredentialsFile
Request a temporary session token via the AWS CLI and write the credentials to credentials_sts.json.
Positional Argument |
Type |
Description |
|---|---|---|
|
char vector |
6-digit MFA token from your authenticator. |
|
char vector |
ARN of the MFA device (for example, |
|
char vector |
Region to store alongside the credentials (e.g., |
Returns |
Type |
Description |
|---|---|---|
|
logical |
|
The helper shells out to aws sts get-session-token and rewrites the JSON output into the format expected by MATLAB tooling.