Differences
This shows you the differences between the selected revisions of the page.
guide_amazon_s3 2018-02-20 | guide_amazon_s3 2024-03-24 (current) | ||
Line 1: | Line 1: | ||
- | ====== Connecting to Amazon S3 Service ====== | + | ====== Connecting to Amazon S3 service ====== |
- | With WinSCP as your S3 client you can easily upload, manage or backup files on your Amazon AWS S3 cloud storage. | + | With WinSCP as your [[free_s3_client_for_windows|S3 client]] you can easily upload, manage or backup files on your Amazon AWS [[s3|S3]] cloud storage. |
Before starting you should [[guide_install|have the latest version of WinSCP installed]]. | Before starting you should [[guide_install|have the latest version of WinSCP installed]]. | ||
Line 6: | Line 6: | ||
===== [[connecting]] Connecting ===== | ===== [[connecting]] Connecting ===== | ||
- | First, make sure your %%AWS%% user with %%S3%% access permissions has an "Access key ID" created. You also have to know the "Secret access key". Access keys are created and managed on [[https://console.aws.amazon.com/iam/home#/users|Users page of IAM Management Console]]. | + | First, make sure your %%AWS%% user with %%S3%% access permissions has an "Access key ID" created. You also have to know the "Secret access key". Access keys are created and managed on [[https://console.aws.amazon.com/iamv2/home#/users|Users page of IAM Management Console]]. |
Start WinSCP. [[ui_login|Login dialog]] will appear. On the dialog: | Start WinSCP. [[ui_login|Login dialog]] will appear. On the dialog: | ||
* Make sure //New site// node is selected. | * Make sure //New site// node is selected. | ||
* On the //New site node//, select //Amazon %%S3%%// protocol. | * On the //New site node//, select //Amazon %%S3%%// protocol. | ||
- | * Enter your AWS user //Access key ID// and //Secret access key// | + | * Enter your AWS user //Access key ID// and //Secret access key//. |
* Save your site settings using the //Save// button. | * Save your site settings using the //Save// button. | ||
* Login using the //Login// button. | * Login using the //Login// button. | ||
- | ===== Working with Buckets===== | + | Alternatively, you can also use [[ui_login#read_credentials|your AWS environment configuration]]. |
+ | |||
+ | ===== [[buckets]] Working with Buckets===== | ||
Once you are connected, you will see a list of your %%S3%% buckets as "folders" in the root folder. | Once you are connected, you will see a list of your %%S3%% buckets as "folders" in the root folder. | ||
Line 21: | Line 23: | ||
The //[[task_create_directory|Create directory]]// command in the root folder in fact creates a new bucket. | The //[[task_create_directory|Create directory]]// command in the root folder in fact creates a new bucket. | ||
- | You will not see buckets that were shared with you by another AWS user, in the root listing. To access such buckets, you have to specify ''/bucketname'' as an initial //[[ui_login_directories|Remote directory]]//, when setting up your %%S3%% session. | + | You will not see buckets that were shared with you by another AWS user, in the root listing. To access such buckets, you have to specify ''/bucketname'' as an initial //[[ui_login_directories|Remote directory]]//, when setting up your %%S3%% session. Similarly, when your access key does not have permissions to list buckets, you will need to specify the path to the desired bucket the same way. In [[scripting]], you do that by appending the path to the bucket to a [[session_url|session URL]]: ''s3://accesskey:secretkey@s3.amazonaws.com/bucket/''. |
===== Further reading ===== | ===== Further reading ===== | ||
* Guide to [[guide_upload|uploading files to server]]; | * Guide to [[guide_upload|uploading files to server]]; | ||
* Guide to [[guide_automation|automating operations]] (including upload). | * Guide to [[guide_automation|automating operations]] (including upload). |