---
id: "aws-ebs"
type: "component"
kind: "block-storage"
provider: "aws"
category: "data"
aliases: "EBS"
docs: "https://docs.aws.amazon.com/ebs/latest/userguide/what-is-ebs.html"
url: "https://localhost:3000/catalogue/components/aws-ebs"
---

# Amazon EBS

Network block volume attached to one EC2 instance, replicated within a single Availability Zone.

| | |
|---|---|
| Provider | [aws](https://localhost:3000/catalogue?provider=aws) |
| Kind | [Block storage volume](https://localhost:3000/catalogue/kinds/block-storage) |
| Category | Data |
| Official docs | [https://docs.aws.amazon.com/ebs/latest/userguide/what-is-ebs.html](https://docs.aws.amazon.com/ebs/latest/userguide/what-is-ebs.html) |

## Properties

| property | type | values | required | kind default | this component |
|---|---|---|---|---|---|
| `annualFailureRatePercent` | string | — | no | "0.1" | inherited |
| `encryptionAtRest` | boolean | — | no | — | **false** |
| `iops` | integer | — | no | — | inherited |
| `managed` | boolean | — | no | false | **true** |
| `maxSizeGib` | integer | — | no | 65536 | inherited |
| `mediaType` | enum | `ssd`, `hdd` | no | — | **"ssd"** |
| `multiAttach` | boolean | — | no | false | inherited |
| `redundancy` | enum | `local`, `zonal`, `regional` | no | — | **"zonal"** |
| `sizeGib` | integer | — | no | — | inherited |
| `snapshots` | boolean | — | no | false | **false** |
| `volumeType` | enum | `gp2`, `gp3`, `io1`, `io2`, `st1`, `sc1`, `standard` | no | "gp2" | inherited |

Bold values are the ones this component pins.

## Rules that apply · 0

No rule selects this kind or its category.

## Other products of the same kind · 28

- [Elastic Block Storage](https://localhost:3000/catalogue/components/alibaba-ebs.md) `alibaba-ebs` — alibabacloud
- [EC2 instance store](https://localhost:3000/catalogue/components/aws-instance-store.md) `aws-instance-store` — aws
- [Azure Container Storage](https://localhost:3000/catalogue/components/azure-container-storage.md) `azure-container-storage` — azure
- [Azure Elastic SAN](https://localhost:3000/catalogue/components/azure-elastic-san.md) `azure-elastic-san` — azure
- [Azure Disk Storage](https://localhost:3000/catalogue/components/azure-managed-disk.md) `azure-managed-disk` — azure
- [Generic block storage volume](https://localhost:3000/catalogue/components/block-storage.md) `block-storage` — default
- [Block volume](https://localhost:3000/catalogue/components/block-volume.md) `block-volume` — default
- [Ceph RBD](https://localhost:3000/catalogue/components/ceph-rbd.md) `ceph-rbd` — default
- [Longhorn](https://localhost:3000/catalogue/components/longhorn.md) `longhorn` — default
- [OpenEBS](https://localhost:3000/catalogue/components/openebs.md) `openebs` — default
- [OpenZFS](https://localhost:3000/catalogue/components/openzfs.md) `openzfs` — default
- [Portworx](https://localhost:3000/catalogue/components/portworx.md) `portworx` — default
- [Volumes Block Storage](https://localhost:3000/catalogue/components/digitalocean-volumes.md) `digitalocean-volumes` — digitalocean
- [Hyperdisk](https://localhost:3000/catalogue/components/google-hyperdisk.md) `google-hyperdisk` — gcp
- [Local SSD](https://localhost:3000/catalogue/components/google-local-ssd.md) `google-local-ssd` — gcp
- [Persistent Disk](https://localhost:3000/catalogue/components/google-persistent-disk.md) `google-persistent-disk` — gcp
- [IBM Cloud Block Storage for VPC](https://localhost:3000/catalogue/components/ibm-block-storage.md) `ibm-block-storage` — ibm
- [Block Storage for Classic](https://localhost:3000/catalogue/components/ibm-block-storage-classic.md) `ibm-block-storage-classic` — ibm
- [IBM Storage Ceph as a Service](https://localhost:3000/catalogue/components/ibm-storage-ceph.md) `ibm-storage-ceph` — ibm
- [PersistentVolume](https://localhost:3000/catalogue/components/k8s-persistent-volume.md) `k8s-persistent-volume` — k8s
- [PersistentVolumeClaim](https://localhost:3000/catalogue/components/k8s-persistent-volume-claim.md) `k8s-persistent-volume-claim` — k8s
- [StorageClass](https://localhost:3000/catalogue/components/k8s-storage-class.md) `k8s-storage-class` — k8s
- [Volume](https://localhost:3000/catalogue/components/k8s-volume.md) `k8s-volume` — k8s
- [OCI Block Volume](https://localhost:3000/catalogue/components/oci-block-volume.md) `oci-block-volume` — oci
- [OCI Boot Volume](https://localhost:3000/catalogue/components/oci-boot-volume.md) `oci-boot-volume` — oci
- [OCI Local NVMe Storage](https://localhost:3000/catalogue/components/oci-local-nvme.md) `oci-local-nvme` — oci
- [OpenStack Cinder](https://localhost:3000/catalogue/components/openstack-cinder.md) `openstack-cinder` — openstack
- [Block Storage Unit (BSU)](https://localhost:3000/catalogue/components/outscale-bsu.md) `outscale-bsu` — outscale

## Use it in a design

```yaml
nodes:
  - { id: "aws-ebs", component: "aws-ebs" }
```

## Source (`component` YAML, verbatim)

```yaml
# yaml-language-server: $schema=../../schema/component.schema.json
# Amazon EBS volume: network block device attached to one EC2 instance in a single Availability Zone.
# "What is Amazon Elastic Block Store?": volume data is automatically replicated across multiple servers
# in an Availability Zone; gp2/gp3/io1/st1/sc1 give 99.8%-99.9% durability, io2 Block Express 99.999%.
# "CreateVolume" defaults VolumeType to gp2; encryption by default is a Region setting that must be enabled.
schemaVersion: "1"
type: "component"
id: "aws-ebs"
kind: "block-storage"
provider: "aws"
docs: "https://docs.aws.amazon.com/ebs/latest/userguide/what-is-ebs.html"
aliases: ["EBS"]
defaults:
  mediaType: "ssd"
  redundancy: "zonal"
  encryptionAtRest: false
  snapshots: false
  managed: true
properties:
  volumeType:
    type: "enum"
    values: ["gp2", "gp3", "io1", "io2", "st1", "sc1", "standard"]
    default: "gp2"
  multiAttach:
    type: "boolean"
    default: false
  maxSizeGib:
    type: "integer"
    default: 65536
  annualFailureRatePercent:
    type: "string"
    default: "0.1"
```

Human page: https://localhost:3000/catalogue/components/aws-ebs