> 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.GetFileObject

- Component: `appmixer.aws.s3.GetFileObject`
- 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.GetFileObject>

Get specific object from S3 bucket as a file. With this component the object size is not limited.

## 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. |

## Output ports

### Port `object`

| Field | Type | Description |
| --- | --- | --- |
| Bucket Name (`Bucket`) | string | - |
| Object Key (`Key`) | string | - |
| `ETag` | string | - |
| Object Size (`ContentLength`) | number | - |
| Content Type (`ContentType`) | string | - |
| Object Metadata (`Metadata`) | object | - |
| File ID (`FileID`) | string | - |

## Full metadata (component.json)

```json
{
  "name": "appmixer.aws.s3.GetFileObject",
  "author": "Camilo Manrique <camilo@client.io>",
  "description": "Get specific object from S3 bucket as a file. With this component the object size is not limited.",
  "private": false,
  "auth": {
    "service": "appmixer:aws:s3"
  },
  "inPorts": [
    {
      "name": "in",
      "schema": {
        "type": "object",
        "properties": {
          "bucket": {
            "type": "string"
          },
          "key": {
            "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."
          }
        }
      }
    }
  ],
  "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": "object",
      "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": "ETag",
          "value": "ETag",
          "schema": {
            "type": "string",
            "example": "\"d41d8cd98f00b204e9800998ecf8427e\""
          }
        },
        {
          "label": "Object Size",
          "value": "ContentLength",
          "schema": {
            "type": "number",
            "example": 1048576
          }
        },
        {
          "label": "Content Type",
          "value": "ContentType",
          "schema": {
            "type": "string",
            "example": "application/pdf"
          }
        },
        {
          "label": "Object Metadata",
          "value": "Metadata",
          "schema": {
            "type": "object",
            "example": {
              "author": "admin",
              "version": "1.0"
            }
          }
        },
        {
          "label": "File ID",
          "value": "FileID",
          "schema": {
            "type": "string",
            "example": "5f3a8b2c1d4e6f7890abcdef"
          }
        }
      ]
    }
  ],
  "icon": "(data URI omitted)"
}
```
