Skip to content

Commit 68065a5

Browse files
committed
DOC-469 Updating admonitions so they match the manual migration section
1 parent e8261d1 commit 68065a5

File tree

1 file changed

+7
-6
lines changed
  • src/connections/storage/catalog/aws-s3

1 file changed

+7
-6
lines changed

src/connections/storage/catalog/aws-s3/index.md

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -26,8 +26,6 @@ The Segment Tracking API processes data from your sources, and collects the Even
2626

2727
![](images/s3processdiagram.png)
2828

29-
30-
3129
## Create a new destination
3230

3331
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
248246
## Migrate an existing destination using public-api
249247
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.
250248

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+
251252
To migrate to the AWS S3 destination using the public-api:
252253

253254
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
299300
--data-raw '
300301
```
301302

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):
303304

304305
```shell
305306
curl -vvv --location --request PATCH https://api.segmentapis.com/destinations/$DESTINATION_ID \
@@ -313,11 +314,11 @@ curl -vvv --location --request PATCH https://api.segmentapis.com/destinations/$D
313314
' | jq
314315
```
315316

316-
> warning "Avoid overwriting data"
317-
> 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.
318319
319320
## 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.
321322

322323
> success "Source editing permissions required"
323324
> 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

Comments
 (0)