3f:null 40:["$","title",null,{"children":"AWS S3 API Starter | Tomás Gómez | Observable"}] 46:T70b,# AWS S3 API Starter

[Docs](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-s3/index.html) | Related: [AWS HTTP Status Dashboard](https://observablehq.com/@observablehq/aws-http-status-dashboard)

Get started using the Amazon Web Services SDK for S3 securely in the browser. 1. Create an IAM user and get [access keys](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html) 2. Save access key ID as a [Secret](https://observablehq.com/settings/secrets) `AWS_ACCESS_KEY_ID` ${hasAccessKeyID ? "✅ Secret found" : "⚠️ Secret not found"} 3. Save secret access key as a [Secret](https://observablehq.com/settings/secrets) `AWS_SECRET_ACCESS_KEY` ${hasSecretAccessKey ? "✅ Secret found" : "⚠️ Secret not found"} 4. Set [your bucket’s CORS permissions](https://s3.console.aws.amazon.com/s3/buckets/${bucket}?region=${region}&tab=permissions) to ${htl.html`

[
  {
    "AllowedHeaders": [
      "Authorization",
      "amz-sdk-invocation-id",
      "amz-sdk-request",
      "x-amz-content-sha256",
      "x-amz-date",
      "x-amz-user-agent"
    ],
    "AllowedMethods": [
      "GET"
    ],
    "AllowedOrigins": [
      "${window.location.origin}"
    ],
    "ExposeHeaders": [],
    "MaxAgeSeconds": 3000
  }
]

`} 5. Set your region and bucket47:[{"id":"3a8c57a0bf6cfec5f655686732820663c00ffcac2bb54dace4b8440b4855fb8b373f4d75e8389b9499d18c07746b4b2739f7d03cedcffd5615e5ffcefed58cd8","href":"https://static.observableusercontent.com/files/3a8c57a0bf6cfec5f655686732820663c00ffcac2bb54dace4b8440b4855fb8b373f4d75e8389b9499d18c07746b4b2739f7d03cedcffd5615e5ffcefed58cd8","name":"contents.json","type":"application/json","lastModified":1662987534853.207,"size":25796}] 44:{"id":"248e2447e5be0dd5","slug":"aws-s3-api-starter","title":"AWS S3 API Starter","thumbnail":"2637fcf2af6034b1d7274f1fba1b5ea9c9e61e6cfd4c94ba7b36f9bcc668ed91","access_level":"public","create_time":"$D2022-09-12T12:58:54.853Z","update_time":"$D2022-10-04T15:21:51.440Z","view_time":null,"first_public_time":"$D2022-09-13T13:09:21.576Z","has_unpublished_edits":null,"fork":{"id":"dd8853f2ce55b8c4","slug":"aws-s3-api-starter","title":"AWS S3 API Starter","owner":{"id":"f35c755083683fe5","login":"observablehq","name":"Observable"}},"stars":0,"starred":false,"owner":{"type":"team","id":"e6269dadf239c382","login":"tomas-gomez","name":"Tomás Gómez","avatar_url":"https://avatars-next.observableusercontent.com/3a9b789447e9a85a750a2608243f4417f0fbaf547b07b912a028646355e75189","tier":"starter_2024","bio":"","following":false},"version":546,"publish_version":546,"role":null,"authored":false,"authors":[{"type":"individual","id":"23229e463f3f537e","login":"tomas-gomez","name":"Tomás Gómez","avatar_url":"https://avatars-next.observableusercontent.com/3a9b789447e9a85a750a2608243f4417f0fbaf547b07b912a028646355e75189","tier":null,"bio":"","following":false}],"members":[{"type":"individual","id":"23229e463f3f537e","login":"tomas-gomez","name":"Tomás Gómez","avatar_url":"https://avatars-next.observableusercontent.com/3a9b789447e9a85a750a2608243f4417f0fbaf547b07b912a028646355e75189","tier":null,"role":"editor"}],"comments":[],"custom_thumbnail":false,"trashed":false,"lapsed":null,"subscribed":null,"forks":1,"collection":null,"type":"notebook","body":{"titling":"auto","title":"AWS S3 API Starter","cells":[{"id":0,"value":"$46","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":26,"value":"region = \"us-east-1\"","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":45,"value":"bucket = \"scanner-congreso-contenidos\"","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":442,"value":"Browse the bucket:","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":330,"value":"Inputs.table(contents, {\n columns: [\"Key\", \"LastModified\", \"Owner\", \"Size\"],\n format: {\n Owner: (d) => d.DisplayName,\n Key: (d) => html`${d}`\n }\n})","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":312,"value":"contents = client\n ? (await client.send(\n new AWS.ListObjectsCommand({ Bucket: bucket })\n )).Contents\n : FileAttachment(\"contents.json\").json()","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":427,"value":"---","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":165,"value":"AWS = import(\"https://cdn.skypack.dev/@aws-sdk/client-s3@3.39.0\")","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":214,"value":"client = {\n try {\n return new AWS.S3Client({\n region,\n credentials: {\n accessKeyId: Secret(\"AWS_ACCESS_KEY_ID\"),\n secretAccessKey: Secret(\"AWS_SECRET_ACCESS_KEY\")\n }\n })\n } catch {\n return false;\n }\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":340,"value":"hasAccessKeyID = {\n try {\n Secret(\"AWS_ACCESS_KEY_ID\");\n return true;\n } catch {\n return false;\n }\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":354,"value":"hasSecretAccessKey = {\n try {\n Secret(\"AWS_SECRET_ACCESS_KEY\");\n return true;\n } catch {\n return false;\n }\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"}],"files":"$W47","stdlib":"1"}} 45:"$44:body"