AWS S3 binding spec

Detailed documentation on the AWS S3 binding component

配置

To setup AWS S3 binding create a component of type bindings.aws.s3. 请参阅本指南,了解如何创建和应用绑定配置。

关于身份验证相关属性的信息,请参阅 认证到 AWS

  1. apiVersion: dapr.io/v1alpha1
  2. kind: Component
  3. metadata:
  4. name: <NAME>
  5. namespace: <NAMESPACE>
  6. spec:
  7. type: bindings.aws.s3
  8. version: v1
  9. metadata:
  10. - name: bucket
  11. value: mybucket
  12. - name: region
  13. value: us-west-2
  14. - name: accessKey
  15. value: *****************
  16. - name: secretKey
  17. value: *****************
  18. - name: sessionToken
  19. value: mysession

Warning

以上示例将 Secret 明文存储。 更推荐的方式是使用 Secret 组件, 这里

元数据字段规范

字段必填绑定支持详情示例
bucketYOutputThe name of the S3 bucket to write to“bucket”
regionYOutputThe specific AWS region“us-east-1”
accessKeyYOutput要访问此资源的 AWS 访问密钥“key”
secretKeyYOutput要访问此资源的 AWS 密钥访问 Key“secretAccessKey”
sessionTokenNOutput要使用的 AWS 会话令牌“sessionToken”

绑定支持

该组件支持输出绑定,其操作如下:

  • create

Create file

To perform a create operation, invoke the AWS S3 binding with a POST method and the following JSON body:

注意:默认情况下,会随机生成一个UUID。 参见下面所示的支持的元数据设置名称

  1. {
  2. "operation": "create",
  3. "data": "YOUR_CONTENT"
  4. }

示例

Save text to a random generated UUID file

在Windows上,使用cmd提示符(PowerShell有不同的转义机制)。

  1. curl -d "{ \"operation\": \"create\", \"data\": \"Hello World\" }" http://localhost:<dapr-port>/v1.0/bindings/<binding-name>
  1. curl -d '{ "operation": "create", "data": "Hello World" }' \
  2. http://localhost:<dapr-port>/v1.0/bindings/<binding-name>
Save text to a specific file
  1. curl -d "{ \"operation\": \"create\", \"data\": \"Hello World\", \"metadata\": { \"key\": \"my-test-file.txt\" } }" \
  2. http://localhost:<dapr-port>/v1.0/bindings/<binding-name>
  1. curl -d '{ "operation": "create", "data": "Hello World", "metadata": { "key": "my-test-file.txt" } }' \
  2. http://localhost:<dapr-port>/v1.0/bindings/<binding-name>
Upload a file

To upload a file, pass the file contents as the data payload; you may want to encode this in e.g. Base64 for binary content.

然后你就可以像平常一样上传了:

  1. curl -d "{ \"operation\": \"create\", \"data\": \"(YOUR_FILE_CONTENTS)\", \"metadata\": { \"key\": \"my-test-file.jpg\" } }" http://localhost:<dapr-port>/v1.0/bindings/<binding-name>
  1. curl -d '{ "operation": "create", "data": "$(cat my-test-file.jpg)", "metadata": { "key": "my-test-file.jpg" } }' \
  2. http://localhost:<dapr-port>/v1.0/bindings/<binding-name>

相关链接