2b:null 2c:["$","title",null,{"children":"AWS S3 API Starter test | Aaron Kyle Dennis | Observable"}] 31:T710,# AWS S3 API Starter test

[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 bucket32:[{"id":"3a8c57a0bf6cfec5f655686732820663c00ffcac2bb54dace4b8440b4855fb8b373f4d75e8389b9499d18c07746b4b2739f7d03cedcffd5615e5ffcefed58cd8","href":"https://static.observableusercontent.com/files/3a8c57a0bf6cfec5f655686732820663c00ffcac2bb54dace4b8440b4855fb8b373f4d75e8389b9499d18c07746b4b2739f7d03cedcffd5615e5ffcefed58cd8","name":"contents.json","type":"application/json","lastModified":1634588215123.864,"size":25796}] 2f:{"id":"f6eb7116e8e7be30","slug":null,"title":"AWS S3 API Starter test","thumbnail":"b9e871efb661dfd264679447958569801afa73c6be560fe29a55a5e52a72f702","access_level":"unlisted","create_time":"$D2021-10-18T20:16:55.123Z","update_time":"$D2021-10-18T20:26:43.683Z","view_time":null,"first_public_time":null,"has_unpublished_edits":null,"fork":true,"stars":0,"starred":false,"owner":{"type":"team","id":"8d652a601386fcf4","login":"aaronkyle","name":"Aaron Kyle Dennis","avatar_url":"https://avatars-next.observableusercontent.com/eb6d0b32ccc6c8febbf105ce4d2a938819bcbd1c6a2c108d3a9c01745d3590f2","tier":"starter_2024"},"version":599,"publish_version":599,"role":null,"authored":false,"authors":[{"type":"individual","id":"a7fa3027921865cf","login":"aaronkyle","name":"Aaron Kyle Dennis","avatar_url":"https://avatars-next.observableusercontent.com/eb6d0b32ccc6c8febbf105ce4d2a938819bcbd1c6a2c108d3a9c01745d3590f2","tier":null}],"members":[{"type":"individual","id":"a7fa3027921865cf","login":"aaronkyle","name":"Aaron Kyle Dennis","avatar_url":"https://avatars-next.observableusercontent.com/eb6d0b32ccc6c8febbf105ce4d2a938819bcbd1c6a2c108d3a9c01745d3590f2","tier":null,"role":"editor"}],"comments":[],"custom_thumbnail":false,"trashed":false,"lapsed":null,"subscribed":null,"forks":0,"collection":null,"type":"notebook","body":{"title":"AWS S3 API Starter test","cells":[{"id":0,"value":"$31","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":26,"value":"region = \"us-east-1\"","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":45,"value":"bucket = \"pinyin\"","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":442,"value":"Browse the bucket:","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$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","output":"$undefined","database":"$undefined"},{"id":312,"value":"// Either load the bucket contents or load the sample cached data\ncontents = client\n ? (await client.send(\n new AWS.ListObjectsCommand({ Bucket: bucket, Prefix: \"lists\", MaxKeys: 100 })\n )).Contents\n : FileAttachment(\"contents.json\").json()","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":502,"value":"object = client.send(new AWS.GetObjectCommand({ Bucket: bucket, Key: \"lists/cedict-singles.csv\" })).then(getTextObject)","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":533,"value":"function getTextObject(response) {\n let reader = response.Body.getReader()\n let stream = new ReadableStream({\n start(controller) {\n return pump();\n function pump() {\n return reader.read().then(({ done, value }) => {\n // When no more data needs to be consumed, close the stream\n if (done) {\n controller.close();\n return;\n }\n // Enqueue the next data chunk into our target stream\n controller.enqueue(value);\n return pump();\n });\n }\n }\n })\n let r = new Response(stream)\n return r.blob().then(b => b.text())\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$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":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":340,"value":"hasAccessKeyID = {\n try {\n Secret(\"aws_access_iantest\");\n return true;\n } catch {\n return false;\n }\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":354,"value":"hasSecretAccessKey = {\n try {\n Secret(\"aws_secret_iantest\");\n return true;\n } catch {\n return false;\n }\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":427,"value":"---","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":596,"value":"md`\n## Different Approach to Passing Credentials and Invoking S3 Client\n`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":165,"value":"AWS = require('aws-sdk@2.794.0/dist/aws-sdk-react-native.js')","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":559,"value":"AWS.config.credentials = new AWS.Credentials(Secret(\"AWS_ACCESS_KEY_ID\"), Secret(\"AWS_SECRET_ACCESS_KEY\"))","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":569,"value":"AWS.config.region = \"us-east-1\"","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":555,"value":"auth_AWS = {\n AWS.config.credentials;\n AWS.config.region;\n return AWS;\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":575,"value":"s3 = new auth_AWS.S3({apiVersion: '2006-03-01'});","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":577,"value":"bucketParams = ({\n Bucket : bucketName,\n Delimiter : '/', \n Prefix : folderName\n });","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":578,"value":"bucketName = \"exempel\"","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":580,"value":"folderName = \"\"","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":582,"value":"objectParams = ({\n Bucket : bucketName,\n Key : objectName\n });","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":584,"value":"objectName = \"exempel.objekt\"","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":586,"value":"available_objects = s3.listObjects(bucketParams).promise().then((object) => object.Contents);","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":589,"value":"loaded_S3_object = s3.getObject(objectParams).promise()","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":591,"value":"formatted_S3_object = JSON.parse(loaded_S3_object.Body.toString('utf-8'))","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":571,"value":"md`\n---\n`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"}],"files":"$W32","stdlib":"1","titling":"auto"}} 30:"$2f:body"