Copy cloud recording
Copies a recording file of a live event to your AWS S3 storage. When you call this API, the file you would like to transfer will be copied to an AWS S3 storage you provide which must be in the same AWS region as your Sendbird application.
Only the files that are in
Completed status can be copied to your storage. You can check the file status on Live events on Sendbird Dashboard. To learn more about file status, refer to Record a live event.
Note: When a recording file is uploaded to the storage you specified, the total size of the file will be automatically split into 5MB per request for optimal data transfer. Charges incur per number of requests against the specified storage as listed on the Requests & data retrievals section.
Using AWS Storage
Before calling the following API to copy a live event recording to your AWS storage, you need to create IAM policies in your AWS account to access the storage by setting
s3:ListBucket as shown below. If you specify a storage without attaching the two permissions, an error will return.
To securely copy the file to the S3 storage, it is recommended that the AWS account only allows these two permissions. For a detailed guide, visit the Creating IAM policies (console) page.
The following table lists the parameters that this action supports.
Specifies the access key of the AWS account to which you would like to copy the cloud recording file.
Specifies the secret key of the AWS account to which you would like to copy the cloud recording file.
Specifies the name of the bucket to which you would like to copy the cloud recording file.
Specifies the AWS region that the bucket is located. The value must match the region of the Sendbird application the recording file is in. Acceptable values are:
Specifies the directory of the bucket.
If successful, this action returns information of a recording file that has been copied to your AWS storage in the response body.
List of response properties
The unique ID of the cloud recording file.
The name of the bucket to which the cloud recording file has been copied.
The file directory, timestamp in