Differences
This shows you the differences between the selected revisions of the page.
| guide_amazon_s3 2017-12-21 | guide_amazon_s3 2024-03-24 (current) | ||
| Line 1: | Line 1: | ||
| - | ====== Connecting to Amazon S3 Service ====== | + | ====== Connecting to Amazon S3 service ====== |
| - | With WinSCP 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]]. | ||
| - | ===== 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]]. |
| - | Once you are connected, you will see a list of your S3 buckets as "folders" in the root folder. | + | ===== [[buckets]] Working with Buckets===== |
| + | |||
| + | Once you are connected, you will see a list of your %%S3%% buckets as "folders" in the root folder. | ||
| 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. 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). | ||