You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/connections/storage/catalog/aws-s3/index.md
+25-1Lines changed: 25 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,7 +5,6 @@ redirect_from:
5
5
hide-personas-partial: true
6
6
---
7
7
8
-
9
8
## Differences between the Amazon S3 destination and the AWS S3 destination
10
9
11
10
The AWS S3 destination provides a more secure method of connecting to your S3 buckets. It uses AWS's own IAM Roles to define access to the specified buckets. For more information about IAM Roles, see Amazon's [IAM role](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html){:target="_blank"} documentation.
@@ -245,6 +244,31 @@ For example:
245
244
246
245
For each source in the scenario, complete the steps described in [Migrate an existing destination](#migrate-an-existing-destination), and ensure that you have separate IAM Roles and Permissions set for staging and production use.
247
246
247
+
### Test your migrated source
248
+
You can validate that your configured your migrated source correctly using a button in the Settings section of the AWS S3 destination.
249
+
250
+
To verify that you migrated your source correctly:
251
+
1. Open the Segment app and select the AWS S3 destination.
252
+
2. On the Settings page, verify that your Region, Bucket Name, and IAM Role ARN are all correct.
253
+
3. Click **Validate.**
254
+
4. A success/failure code appears.
255
+
256
+
> note "`dummy-object.txt`"
257
+
> In order to test your bucket, Segment will upload a text file, `dummy-object.txt`, to your `segment-logs` folder. After you've completed the validation process, feel free to delete this file.
258
+
259
+
#### Troubleshooting
260
+
261
+
The following table outlines some of the error codes the validation tool may display, as well as possible reasons for the error.
262
+
263
+
| Frontend error message | Backend error message | Likely cause of the error |
| Unknown Error. Please try again. If the problem persists, please contact [Segment support](mailto:[email protected]) | failed to assume intermediate role | Fail to assume intermediate role |
266
+
| Access Denied. Please configure External ID in the AWS IAM Console. [Learn more](#create-an-iam-role-in-the-aws-console). | role not configured with external id | Successfully assumed customer's role, role doesn't have external ID |
267
+
| Unknown Error. Please follow [instructions](#create-an-iam-role-in-the-aws-console) to set up the AWS S3 destination. If the problem persists, please contact [Segment support](mailto:[email protected]). | failed to assume role | Fail to assume customer’s role without external ID & returned an error code that is not error 403 |
268
+
| Access Denied. Please configure External ID in the AWS IAM Console. [Learn more](#create-an-iam-role-in-the-aws-console). | assume role failed with Access Denied | Fail to assume customer’s role without external ID & returned error 403 |
269
+
| Access Denied. Please add PutObject permissions to the IAM role in the AWS IAM Console. [Learn more](). | upload dummy object failed with Access Denied | Fail to upload the dummy object to customer's S3 bucket & an error code that is not error 403. |
270
+
| Unknown Error. Please follow [instructions](#create-an-iam-role-in-the-aws-console) to set up the AWS s3 destination. If the problem persists, please contact [Segment support](mailto:[email protected]). | failed to upload dummy object | Fail to upload the dummy object to customer's S3 bucket & an error code that is not error 403. |
0 commit comments