Segment Functions AWS SDK v3 Upgrade

If your function uses AWS:

1. Update your code to use AWSv3 instead of AWS.
2. Test and redeploy your function.

Unlike the Node.js runtime upgrade, this upgrade requires code changes. Redeploying your function alone doesn't migrate it to AWS SDK v3.

Your deployed functions continue to run on AWS SDK v2.

• If you create a function that uses AWS, use AWSv3.
• Until Twilio removes AWS SDK v2 from the Functions runtime, existing functions that use AWS continue to work.
• After Twilio removes AWS, functions that use it fail. Twilio will provide advance notice.

Access AWS services through AWSv3.<Service>.

1
const s3 = new AWS.S3()
2
const data = await s3.getObject({ Bucket, Key }).promise()

1
const { S3Client, GetObjectCommand } = AWSv3.S3
2
const s3 = new S3Client({ region: 'us-west-2' })
3
const data = await s3.send(new GetObjectCommand({ Bucket, Key }))

1
const { Credentials } = await new AWS.STS().assumeRole(params).promise()
2
AWS.config.update({ credentials: new AWS.Credentials(
3
  Credentials.AccessKeyId, Credentials.SecretAccessKey, Credentials.SessionToken) })
4
const s3 = new AWS.S3()

1
const { STSClient, AssumeRoleCommand } = AWSv3.STS
2
const { Credentials } = await new STSClient({ region: 'us-west-2' })
3
  .send(new AssumeRoleCommand(params))
4

5
const s3 = new AWSv3.S3.S3Client({
6
  region: 'us-west-2',
7
  credentials: {
8
    accessKeyId: Credentials.AccessKeyId,
9
    secretAccessKey: Credentials.SecretAccessKey,
10
    sessionToken: Credentials.SessionToken
11
  }
12
})

In the Segment app, update your code in the Functions editor, then send a sample event.

1. Open your function.
2. Update your code for AWSv3.
3. To send a sample event, use the Test tab. Confirm the function behaves as expected.
4. Click Save & Deploy. This deploys the updated function.

With the Public API, update your function's code then deploy an updated version. To find the endpoints that apply to your function type, see the Public API reference.

Are you using an AWS feature not covered here? [Contact Segment Support][].

Contact Segment Support