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
+7-6Lines changed: 7 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -26,8 +26,6 @@ The Segment Tracking API processes data from your sources, and collects the Even
26
26
27
27

28
28
29
-
30
-
31
29
## Create a new destination
32
30
33
31
Complete either [Create an IAM role in the AWS console](#create-an-iam-role-in-the-aws-console) or [Create an IAM role using the AWS CLI](#create-an-iam-role-using-the-aws-cli) to configure the AWS S3 Destination with IAM Role Support.
@@ -248,6 +246,9 @@ For each source in the scenario, complete the steps described in [Migrate an exi
248
246
## Migrate an existing destination using public-api
249
247
This procedure uses Segment's public-api to migrate your destinations to the AWS S3 destination. For more information about the public-api, please see the [public-api Getting Started](https://api.segmentapis.com/docs/guides/#getting-started) guide.
250
248
249
+
> warning "Avoid overwriting data"
250
+
> Sending data to the same S3 location from both the existing Amazon S3 destination and the AWS S3 destinations will overwrite data in your instance of S3. To avoid this, disable your Amazon S3 destination after you create your AWS S3 destination.
251
+
251
252
To migrate to the AWS S3 destination using the public-api:
252
253
253
254
1. Create a new S3 bucket and IAM role using either the [AWS console](#create-an-iam-role-in-the-aws-console) or the [AWS CLI](#create-an-iam-role-using-the-aws-cli).
@@ -299,7 +300,7 @@ curl -vvv --location --request GET https://api.segmentapis.com/destinations/$DES
299
300
--data-raw '
300
301
```
301
302
302
-
9. Disable the Amazon S3 destinations using the following command (replacing `$DESTINATION_ID` with the ID of your Amazon S3 destination you found in step ):
303
+
9. Disable the Amazon S3 destinations using the following command (replacing `$DESTINATION_ID` with the ID of your Amazon S3 destination you found in step 8):
> Sending data to the same S3 location from both the existing Amazon S3 destination and the AWS S3 destinations will overwrite data in your instance of S3. To avoid this, disable your Amazon S3 destination after you create your AWS S3 destination.
317
+
> error " "
318
+
> You must migrate to the new S3 destination before you disable your legacy destination to ensure Segment continues to deliver data to your S3 bucket.
318
319
319
320
## Test your migrated source
320
-
You can validate that your configured your migrated source correctly in the Settings section of the AWS S3 destination.
321
+
You can validate that your configured your migrated source correctly in the Settings section of the AWS S3 destination page in the Segment app.
321
322
322
323
> success "Source editing permissions required"
323
324
> In-app source validation is restricted to users with source editing permissions (for example, users with Workspace Owner, Source Admin, or Workspace Admin roles). For more information about roles in the Segment app, please see the [Roles documentation](/docs/segment-app/iam/roles/).
0 commit comments