Event Photo Upload Policy

Description

An event photo upload policy.

Properties

Property Description
expiration read-only

The generated policy is valid until this time.

maxFileSize read-only

The maximum file size in bytes allowed for upload.

postParams required read-only

Parameters that must be included as parameters in the upload request.

In general, these parameter should be sent, unmodified, with the request. The exception is when any of the values contain a template variables, as noted.

Property Description
AWSAccessKeyId

The AWS Access Key ID for the .uploadUrl.

Content-Type

The media type of the file to be uploaded.

acl

The AWS access control level to be used for the upload.

key

The storage key for the file, to be used by the .uploadUrl for storing the uploaded image.

This value contains the template variable ${random_folder} which must be a random 32-character hexadecimal value generated by the client and replaced before sending the request to the .uploadUrl.

This value also contains the template variable ${filename}, which MUST NOT be replaced and should remain intact when sending the request to the .uploadUrl.

policy

The encoded policy document generated for the upload request.

signature

The encoded signature to send with the request to .uploadUrl.

success_action_status

The HTTP status code expected in a successful response from the request to `.uploadUrl'.

type read-only

The type of object represented.

uploadUrl read-only

The URL to which a POST request may be made to upload an image for the event.

OpenAPI Schema

The following schema is based on OpenAPI 3.0 and is provided in our downloadable OpenAPI document.

{
  "description": "An event photo upload policy.",
  "properties": {
    "expiration": {
      "description": "The generated policy is valid until this time.",
      "format": "date-time",
      "readOnly": true,
      "type": "string"
    },
    "maxFileSize": {
      "description": "The maximum file size in bytes allowed for upload.",
      "readOnly": true,
      "type": "integer"
    },
    "postParams": {
      "description": "Parameters that must be included as parameters in the upload\nrequest.\n\nIn general, these parameter should be sent, unmodified, with the\nrequest. The exception is when any of the values contain a template\nvariables, as noted.",
      "properties": {
        "AWSAccessKeyId": {
          "description": "The AWS Access Key ID for the `.uploadUrl`.",
          "type": "string"
        },
        "Content-Type": {
          "description": "The media type of the file to be uploaded.",
          "enum": [
            "image/jpeg"
          ],
          "type": "string"
        },
        "acl": {
          "description": "The AWS access control level to be used for the upload.",
          "enum": [
            "private"
          ],
          "type": "string"
        },
        "key": {
          "description": "The storage key for the file, to be used by the `.uploadUrl` for\nstoring the uploaded image.\n\nThis value contains the template variable `${random_folder}`\nwhich must be a random 32-character hexadecimal value generated\nby the client and replaced before sending the request to the\n`.uploadUrl`.\n\nThis value also contains the template variable `${filename}`,\nwhich MUST NOT be replaced and should remain intact when sending\nthe request to the `.uploadUrl`.",
          "type": "string"
        },
        "policy": {
          "description": "The encoded policy document generated for the upload request.",
          "type": "string"
        },
        "signature": {
          "description": "The encoded signature to send with the request to `.uploadUrl`.",
          "type": "string"
        },
        "success_action_status": {
          "description": "The HTTP status code expected in a successful response from the\nrequest to `.uploadUrl'.",
          "enum": [
            201
          ],
          "type": "integer"
        }
      },
      "readOnly": true,
      "required": [
        "AWSAccessKeyId",
        "key",
        "acl",
        "Content-Type",
        "policy",
        "success_action_status",
        "signature"
      ],
      "type": "object"
    },
    "type": {
      "description": "The type of object represented.",
      "enum": [
        "event-photo-upload-policy"
      ],
      "readOnly": true,
      "type": "string"
    },
    "uploadUrl": {
      "description": "The URL to which a POST request may be made to upload an image for\nthe event.",
      "format": "uri",
      "readOnly": true,
      "type": "string"
    }
  },
  "required": [
    "type",
    "maxFileSize",
    "uploadUrl",
    "postParams"
  ],
  "title": "Event Photo Upload Policy",
  "type": "object"
}