> Markdown versions of all pages of this connector library are available by appending `.md` to the page URL. For the full index of connectors, see [llms.txt](https://connectors.appmixer.com/llms.txt).

# appmixer.aws.s3.GetSignedUrl

- Component: `appmixer.aws.s3.GetSignedUrl`
- Kind: Action
- Version: 1.0.0
- Visibility: Public
- Connector: [appmixer.aws.s3 2.2.2](https://connectors.appmixer.com/connector/appmixer.aws.s3/2.2.2.md)
- Component page: <https://connectors.appmixer.com/connector/appmixer.aws.s3/2.2.2/component/appmixer.aws.s3.GetSignedUrl>

Get a signed URL for an S3 object.

## Properties

| Field | Type | Description |
| --- | --- | --- |
| Region (`region`) | text | Your AWS instance region. If not select, us-east-1 will be used as default. |

## Input ports

### Port `in`

| Field | Type | Description |
| --- | --- | --- |
| Bucket (`bucket`) | text | Your AWS S3 Bucket. |
| Object Key (`key`) | text | They key of the object to get. |
| Expires (s) (`expires`) | number | The URL expiration period in seconds. Default is 1 day. Maximum is 1 week (604800s). |
| Operation (`operation`) | select | The name of the operation to call. Defaults to getObject. |

## Output ports

### Port `url`

| Field | Type | Description |
| --- | --- | --- |
| Bucket Name (`Bucket`) | string | - |
| Object Key (`Key`) | string | - |
| `Expires` | number | - |
| Signed URL (`Url`) | string | - |

## Full metadata (component.json)

```json
{
  "name": "appmixer.aws.s3.GetSignedUrl",
  "author": "David Durman <david@client.io>",
  "description": "Get a signed URL for an S3 object.",
  "private": false,
  "auth": {
    "service": "appmixer:aws:s3"
  },
  "inPorts": [
    {
      "name": "in",
      "schema": {
        "type": "object",
        "properties": {
          "bucket": {
            "type": "string"
          },
          "key": {
            "type": "string"
          },
          "expires": {
            "type": "integer"
          },
          "operation": {
            "type": "string"
          }
        },
        "required": [
          "bucket",
          "key"
        ]
      },
      "inspector": {
        "inputs": {
          "bucket": {
            "type": "text",
            "label": "Bucket",
            "index": 1,
            "tooltip": "Your AWS S3 Bucket.",
            "source": {
              "url": "/component/appmixer/aws/s3/ListBuckets?outPort=bucket",
              "data": {
                "properties": {
                  "sendWholeArray": true
                },
                "transform": "./ListBuckets#bucketsToSelectArray"
              }
            }
          },
          "key": {
            "type": "text",
            "label": "Object Key",
            "index": 2,
            "tooltip": "They key of the object to get."
          },
          "expires": {
            "type": "number",
            "label": "Expires (s)",
            "defaultValue": 86400,
            "index": 3,
            "tooltip": "The URL expiration period in seconds. Default is 1 day. Maximum is 1 week (604800s)."
          },
          "operation": {
            "type": "select",
            "label": "Operation",
            "options": [
              {
                "content": "getObject",
                "value": "getObject"
              },
              {
                "content": "putObject",
                "value": "putObject"
              }
            ],
            "defaultValue": "getObject",
            "index": 4,
            "tooltip": "The name of the operation to call. Defaults to getObject."
          }
        }
      }
    }
  ],
  "properties": {
    "schema": {
      "properties": {
        "region": {
          "type": "string"
        }
      }
    },
    "inspector": {
      "inputs": {
        "region": {
          "type": "text",
          "label": "Region",
          "index": 1,
          "tooltip": "Your AWS instance region. If not select, us-east-1 will be used as default.",
          "source": {
            "url": "/component/appmixer/aws/s3/ListRegions?outPort=out"
          }
        }
      }
    }
  },
  "outPorts": [
    {
      "name": "url",
      "options": [
        {
          "label": "Bucket Name",
          "value": "Bucket",
          "schema": {
            "type": "string",
            "example": "my-app-data-bucket"
          }
        },
        {
          "label": "Object Key",
          "value": "Key",
          "schema": {
            "type": "string",
            "example": "uploads/documents/report.pdf"
          }
        },
        {
          "label": "Expires",
          "value": "Expires",
          "schema": {
            "type": "number",
            "example": 86400
          }
        },
        {
          "label": "Signed URL",
          "value": "Url",
          "schema": {
            "type": "string",
            "example": "https://my-app-data-bucket.s3.amazonaws.com/uploads/documents/report.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=86400"
          }
        }
      ]
    }
  ],
  "icon": "(data URI omitted)"
}
```
