

# bloques de capacidad para ML
<a name="ec2-capacity-blocks"></a>

Los bloques de capacidad para ML permiten reservar instancias de computación acelerada en una fecha futura para respaldar cargas de trabajo de machine learning (ML) de corta duración. Las instancias que se ejecutan en un bloque de capacidad se colocan automáticamente cerca dentro de [Amazon EC2 UltraClusters](https://aws.amazon.com/ec2/ultraclusters/) para conseguir redes que no generen bloqueos, de escala de petabits y de baja latencia.

También puede usar bloques de capacidad para reservar capacidad para UltraServers de Amazon EC2. Los UltraServers conectan varias instancias de Amazon EC2 dentro de una interconexión aceleradora de baja latencia y un elevado ancho de banda. Puede utilizar UltraServers para gestionar las cargas de trabajo de IA y ML que consumen más recursos de computación y memoria en entrenamiento, afinación e inferencia. Para obtener más información, consulte [UltraServers de Amazon EC2](https://aws.amazon.com/ec2/ultraservers/).

Con bloques de capacidad, puede ver cuándo estará disponible la capacidad de las instancias de GPU en fechas futuras y programar un bloque de capacidad para que comience a la hora que mejor le convenga. Cuando reserva un bloque de capacidad, obtiene una garantía de capacidad predecible para las instancias de GPU y paga solo por el tiempo que necesite. Recomendamos bloques de capacidad si necesita GPU para respaldar sus cargas de trabajo de ML durante días o semanas y no quiere pagar una reserva mientras las instancias de GPU no estén en uso.

A continuación, se indican algunos casos de uso frecuentes de bloques de capacidad.
+ **Entrenamiento y ajuste de modelos de ML**: obtenga acceso ininterrumpido a las instancias de GPU que reservó para completar el entrenamiento y el ajuste de los modelos de ML.
+ **Experimentos y prototipos de ML**: ejecute experimentos y cree prototipos que requieran instancias de GPU durante periodos cortos.

Los bloques de capacidad están disponibles para determinados tipos de instancias en algunas regiones de AWS. Para obtener más información, consulte [Tipos de instancias y regiones admitidos.](#capacity-blocks-prerequisites).

Puede reservar un bloque de capacidad con una hora de inicio de reserva de hasta ocho semanas en el futuro. Cada bloque de capacidad puede tener hasta 64 instancias, y se pueden tener hasta 256 instancias en todos los bloques de capacidad.

**Topics**
+ [Tipos de instancias y regiones admitidos.](#capacity-blocks-prerequisites)
+ [Plataformas admitidas](#capacity-blocks-platforms)
+ [Consideraciones](#capacity-blocks-considerations)
+ [Recursos relacionados](#capacity-blocks-related-resources)
+ [Cómo funcionan los bloques de capacidad de Amazon EC2](capacity-blocks-how.md)
+ [Precios y facturación de bloques de capacidad](capacity-blocks-pricing-billing.md)
+ [Búsqueda y compra de bloques de capacidad](capacity-blocks-purchase.md)
+ [Lanzar instancias mediante bloques de capacidad](capacity-blocks-launch.md)
+ [Visualización de bloques de capacidad](capacity-blocks-view.md)
+ [Ampliación de los bloques de capacidad](capacity-blocks-extend.md)
+ [Compartir bloques de capacidad](capacity-blocks-share.md)
+ [Creación de un grupo de recursos para los bloques de capacidad de UltraServer](cb-group.md)
+ [Supervisar los bloques de capacidad mediante EventBridge](capacity-blocks-monitor.md)
+ [Registro de llamadas a la API de bloques de capacidad con AWS CloudTrail](capacity-blocks-logging-using-cloudtrail.md)

## Tipos de instancias y regiones admitidos.
<a name="capacity-blocks-prerequisites"></a>

Los bloques de capacidad de instancia UltraServer se pueden usar con los siguientes tipos de instancias y regiones de AWS.

**nota**  
No todos los tipos de instancias de todas las Regiones de AWS admiten tamaños de bloques de capacidad de 64 instancias. 

### Bloques de capacidad de instancia
<a name="capacity-blocks-instance-prerequisites"></a>
+ **`p6-b300.48xlarge`**
  + Oeste de EE. UU. (Oregón) — `us-west-2`
+ **`p6-b200.48xlarge`**
  + Este de EE. UU. (Norte de Virginia) — `us-east-1`
  + Este de EE. UU. (Ohio): `us-east-2`
  + Oeste de EE. UU. (Oregón) — `us-west-2`
+ **`p5.4xlarge`**
  + Este de EE. UU. (Norte de Virginia) — `us-east-1`
  + Este de EE. UU. (Ohio): `us-east-2`
  + Oeste de EE. UU. (Oregón) — `us-west-2`
  + Europa (Londres): `eu-west-2`
  + Asia-Pacífico (Mumbai): `ap-south-1`
  + Asia-Pacífico (Tokio): `ap-northeast-1`
  + Asia-Pacífico (Sídney): `ap-southeast-2`
  + América del Sur (São Paulo): `sa-east-1`
+ **`p5.48xlarge`**
  + Este de EE. UU. (Norte de Virginia) — `us-east-1`
  + Este de EE. UU. (Ohio): `us-east-2`
  + Oeste de EE. UU. (Norte de California): `us-west-1`
  + Oeste de EE. UU. (Oregón) — `us-west-2`
  + Europa (Estocolmo): `eu-north-1`
  + Europa (Londres): `eu-west-2`
  + América del Sur (São Paulo): `sa-east-1`
  + Asia-Pacífico (Tokio): `ap-northeast-1`
  + Asia-Pacífico (Mumbai): `ap-south-1`
  + Asia-Pacífico (Sídney): `ap-southeast-2`
  + Asia-Pacífico (Yakarta): `ap-southeast-3`
  + Zona local del Este de EE. UU. (Atlanta): `us-east-1-atl-2a`
+ **`p5e.48xlarge`**
  + Este de EE. UU. (Norte de Virginia) — `us-east-1`
  + Este de EE. UU. (Ohio): `us-east-2`
  + Oeste de EE. UU. (Norte de California): `us-west-1`
  + Oeste de EE. UU. (Oregón) — `us-west-2`
  + Europa (Estocolmo): `eu-north-1`
  + Europa (Londres): `eu-west-2`
  + Europa (España): `eu-south-2`
  + América del Sur (São Paulo): `sa-east-1`
  + Asia-Pacífico (Tokio): `ap-northeast-1`
  + Asia-Pacífico (Seúl): `ap-northeast-2`
  + Asia-Pacífico (Mumbai): `ap-south-1`
  + Asia-Pacífico (Yakarta): `ap-southeast-3`
  + Zona local del Oeste de EE. UU. (Phoenix): `us-west-2-phx-2a`
+ **`p4d.24xlarge`**
  + Este de EE. UU. (Norte de Virginia) — `us-east-1`
  + Este de EE. UU. (Ohio): `us-east-2`
  + Oeste de EE. UU. (Oregón) — `us-west-2`
+ **`p4de.24xlarge`**
  + Este de EE. UU. (Norte de Virginia) — `us-east-1`
  + Oeste de EE. UU. (Oregón) — `us-west-2`
+ **`trn1.32xlarge`**
  + Este de EE. UU. (Norte de Virginia) — `us-east-1`
  + Este de EE. UU. (Ohio): `us-east-2`
  + Oeste de EE. UU. (Norte de California): `us-west-1`
  + Oeste de EE. UU. (Oregón) — `us-west-2`
  + Europa (Estocolmo): `eu-north-1`
  + Asia-Pacífico (Mumbai): `ap-south-1`
  + Asia-Pacífico (Sídney): `ap-southeast-2`
  + Asia-Pacífico (Melbourne): `ap-southeast-4`
+ **`trn2.3xlarge `**
  + Asia-Pacífico (Melbourne): `ap-southeast-4`
  + América del Sur (São Paulo): `sa-east-1`
+ **`trn2.48xlarge`**
  + Este de EE. UU. (Ohio): `us-east-2`

### Bloques de capacidad de UltraServer
<a name="capacity-blocks-ultraserver-prerequisites"></a>
+ **`Trn2`**
  + Este de EE. UU. (Ohio): `us-east-2`
+ **`P6e-GB200`**
  + Zona local del Este de EE. UU. (Dallas): `us-east-1-dfw-2a`

## Plataformas admitidas
<a name="capacity-blocks-platforms"></a>

Los bloques de capacidad para ML admiten actualmente instancias y UltraServers con solo una tenencia predeterminada. Cuando se utiliza Consola de administración de AWS para comprar un bloque de capacidad, la opción de plataforma predeterminada es Linux/UNIX. Al usar la AWS Command Line Interface (AWS CLI) o el SDK de AWS al comprar un bloque de capacidad, están disponibles las siguientes opciones de plataforma:
+ Linux/Unix
+ Red Hat Enterprise Linux
+ RHEL con HA
+ SUSE Linux
+ Ubuntu Pro

## Consideraciones
<a name="capacity-blocks-considerations"></a>

Antes de usar los bloques de capacidad, tenga en cuenta los siguientes detalles y limitaciones.
+ Si detectamos un deterioro que afecta a un bloque de capacidad de UltraServer, se lo notificaremos; sin embargo, por lo general, no tomaremos medidas para terminar las instancias ubicadas en el bloque de capacidad. Esto tiene como objetivo minimizar interrupciones no intencionadas en las cargas de trabajo. Puede seguir con el uso del bloque de capacidad de UltraServer tal como está después de recibir esta notificación, o solicitar una solución mediante la terminación de todas las instancias del bloque de capacidad y el envío de un caso al soporte de AWS. Una vez que recibamos su solicitud de soporte, le notificaremos al completar la reparación y podrá lanzar nuevamente las instancias en el bloque de capacidad de UltraServer.
+ En el caso de los bloques de capacidad de UltraServer `P6e-GB200`, debe terminar sus instancias al menos 60 minutos antes de la hora de finalización del bloque de capacidad.
+  Para comprar y usar bloques de capacidad en las zonas locales, debe activar la zona local. 
+ Cada bloque de capacidad puede tener hasta 64 instancias, y se pueden tener hasta 256 instancias en todos los bloques de capacidad.
+ Puede describir ofertas de bloques de capacidad que se inicien en tan solo 30 minutos.
+ Los bloques de capacidad finalizan a las 11:30 h UTC (horario universal coordinado).
+ El proceso de terminación de las instancias que se ejecutan en un bloque de capacidad comienza a las 11:00 h UTC (horario universal coordinado) el último día de la reserva.
+ Los bloques de capacidad se pueden reservar con una hora de inicio con hasta 8 semanas de antelación.
+ No se admiten cancelaciones de los bloques de capacidad.
+ Los bloques de capacidad de UltraServer no se pueden compartir entre cuentas de AWS ni dentro de su organización de AWS.
+ El bloque de capacidad no se puede [trasladar](capacity-reservations-move.md) ni [dividir](capacity-reservations-split.md).
+ Solo los bloques de capacidad de UltraServer pueden utilizarse con grupos de recursos. Los bloques de capacidad de instancia no se pueden utilizar con grupos de recursos. Para obtener más información, consulte [Creación de un grupo de recursos para los bloques de capacidad de UltraServer](cb-group.md).
+ El número total de instancias que se pueden reservar en bloques de capacidad en todas las cuentas de su organización de AWS no puede superar las 256 instancias en una fecha determinada.
+ Para usar un bloque de capacidad, las instancias deben dirigirse específicamente al ID de reserva.
+ Las instancias de un bloque de capacidad no se tienen en cuenta para los límites de instancias bajo demanda.
+ En el caso de las instancias P5 que utilizan una AMI personalizada, asegúrese de tener el [software y la configuración necesarios para la EFA](gpu-instances-started.md).
+ Para los grupos de nodo gestionados por Amazon EKS, consulte [Crear un grupo de nodos gestionado con Bloques de capacidad para machine learning de Amazon EC2](https://docs.aws.amazon.com/eks/latest/userguide/capacity-blocks-mng.html). Para los grupos de nodo autogestionados de Amazon EKS, consulte [Uso de bloques de capacidad para ML con nodos autogestionados](https://docs.aws.amazon.com/eks/latest/userguide/capacity-blocks.html).

## Recursos relacionados
<a name="capacity-blocks-related-resources"></a>

Después de crear un bloque de capacidad, podrá hacer lo siguiente con el bloque de capacidad:
+ inicialización de instancias en el bloque de capacidad Para obtener más información, consulte [Lanzar instancias mediante bloques de capacidad](capacity-blocks-launch.md).
+ Crear un grupo de Amazon EC2 Auto Scaling. Para obtener más información, consulte [Use Capacity Blocks for machine learning workloads](https://docs.aws.amazon.com/autoscaling/ec2/userguide/launch-template-capacity-blocks.html) en la *Guía del usuario de Amazon EC2 Auto Scaling*. 
**nota**  
Si utiliza Amazon EC2 Auto Scaling o Amazon EKS, puede programar el escalado para que se ejecute al inicio de la reserva del bloque de capacidad. Con el escalado programado, AWS administra automáticamente los reintentos, por lo que no tiene que preocuparse por implementar una lógica de reintentos para administrar los errores transitorios.
+  Mejore los flujos de trabajo de ML con AWS Parallel Computing Service. Para obtener más información, consulte [Soporte de bloques de capacidad para AWS Parallel Computing Service](https://aws.amazon.com/blogs/hpc/announcing-capacity-blocks-support-for-aws-parallel-computing-service/). 
+ Mejore los flujos de trabajo de ML con AWS ParallelCluster. Para obtener más información, consulte [Mejora de los flujos de trabajo de ML con AWS ParallelCluster y los Bloques de capacidad para machine learning de Amazon EC2](https://aws.amazon.com/blogs/hpc/enhancing-ml-workflows-with-aws-parallelcluster-and-amazon-ec2-capacity-blocks-for-ml/). 

 Para obtener más información sobre AWS Parallel Computing Service, consulte [Qué es AWS Parallel Computing Service](https://docs.aws.amazon.com/pcs/latest/userguide/what-is-service.html). 

 Para obtener más información acerca de AWS ParallelCluster, consulte [¿Qué es AWS ParallelCluster?](https://docs.aws.amazon.com/parallelcluster/latest/ug/what-is-aws-parallelcluster.html). 

# Cómo funcionan los bloques de capacidad de Amazon EC2
<a name="capacity-blocks-how"></a>

Puede reservar un bloque de capacidad con las siguientes especificaciones: 
+ Reserve una hora de inicio con hasta 8 semanas de antelación.
+ Establezca una duración de reserva de 1 a 14 días o un múltiplo de 7 días, hasta 182 días (ejemplos: 21 días, 28 días).
+ Configure hasta 64 instancias por bloque de capacidad.
+ Configure hasta 256 instancias entre varios bloques de capacidad.

En el caso de los UltraServers de Amazon EC2, cada UltraServer corresponde a un bloque de capacidad. Puede solicitar varios UltraServers mediante una sola solicitud.

 Puede usar los bloques de capacidad para reservar las instancias `p6-b200`, `p5`, `p5e`, `p5en`, `p4d`, `p4de`, `trn1` y `trn2`. Puede comprar los siguientes tipos de UltraServer a través de los bloques de capacidad: `P6e-GB200` y `Trn2` (en versión preliminar). 

Para reservar un bloque de capacidad, comience por especificar sus necesidades de capacidad, lo que incluye el tipo de instancias o el tipo de UltraServers, la cantidad de instancias o UltraServers, la cantidad de tiempo, la fecha de inicio más temprana y la fecha de finalización más tardía que necesita. A continuación, podrá ver una oferta de bloques de capacidad disponible que cumpla con sus especificaciones. La oferta de bloques de capacidad incluye detalles como la hora de inicio, la zona de disponibilidad y el precio de la reserva. El precio de una oferta de bloques de capacidad depende de la oferta y la demanda disponibles en el momento en que se hizo la oferta. Después de reservar un bloque de capacidad, el precio no cambia. Para obtener más información, consulte [Precios y facturación de bloques de capacidad](capacity-blocks-pricing-billing.md).

Al comprar una oferta de bloques de capacidad, la reserva se crea para la fecha y el número de instancias que haya seleccionado. Cuando comience su reserva de bloques de capacidad, podrá especificar el ID de reserva en sus solicitudes de inicializaciones para segmentar los inicializacións de instancias. 

Puede usar todas las instancias que reservó hasta 30 minutos (para los tipos de instancias) o 60 minutos (para los tipos de UltraServers) antes de la hora de finalización del bloque de capacidad. Cuando queden 30 minutos (para los tipos de instancias) o 60 minutos (para los tipos de UltraServers) de su reserva de bloques de capacidad, comenzaremos a terminar todas las instancias que se estén ejecutando en el bloque de capacidad. Aprovechamos este tiempo para limpiar sus instancias antes de entregar el bloque de capacidad al siguiente cliente. Emitimos un evento a través de EventBridge 10 minutos antes de que comience el proceso de terminación. Para obtener más información, consulte [Supervisar los bloques de capacidad mediante EventBridge](capacity-blocks-monitor.md).

# Precios y facturación de bloques de capacidad
<a name="capacity-blocks-pricing-billing"></a>

Con Bloques de capacidad para machine learning de Amazon EC2, paga únicamente por lo que reserva. El precio de un bloque de capacidad depende de la oferta y la demanda de bloques de capacidad disponibles en el momento de la compra. Puede consultar el precio de una oferta de bloques de capacidad antes de reservarla. El precio del bloque de capacidad se cobra por adelantado en el momento de realizar la reserva. Si busca un bloque de capacidad en un rango de fechas, le mostramos la oferta de bloques de capacidad con el precio más bajo disponible. Después de haber reservado un bloque de capacidad, el precio no cambia.

Cuando utiliza un bloque de capacidad, paga por el sistema operativo que utiliza cuando las instancias están en ejecución. Para obtener más información acerca de los precios, consulte [Precios de los Bloques de capacidad para machine learning de Amazon EC2](https://aws.amazon.com/ec2/capacityblocks/pricing/).

## Facturación
<a name="capacity-blocks-billing"></a>

El precio de una oferta de bloques de capacidad se cobra por adelantado. El pago se facturará a la cuenta de AWS en un plazo de entre 5 y 12 horas después de la compra de un bloque de capacidad. Mientras se procesa el pago, su recurso de reserva de bloques de capacidad permanece en el estado `payment-pending`. Si el pago no se puede procesar al menos 5 minutos antes de la hora de inicio del bloque o en un plazo de 12 horas (lo que ocurra primero), se liberará el bloque de capacidad y el estado de la reserva cambiará a `payment-failed`.

Una vez que el pago se haya procesado correctamente, el estado del recurso de bloques de capacidad cambiará de `payment-pending` a `scheduled`. Recibirá una factura en la que se reflejará el pago inicial único. En la factura, puede asociar el importe pagado al ID de reserva de bloques de capacidad.

Cuando comience su reserva de bloques de capacidad, se le facturará únicamente en función del sistema operativo que utilice mientras las instancias estén activas en la reserva. Puede ver su uso y los cargos asociados en su factura de aniversario correspondiente al mes de uso en su AWS Cost and Usage Report.

**nota**  
Los descuentos de Savings Plans e instancias reservadas no se aplican a bloques de capacidad.

**Visualización de su factura**  
Puede ver su factura en la consola de Administración de facturación y costos de AWS. El pago inicial de su bloque de capacidad aparece en el mes en que compró la reserva.

Una vez iniciada la reserva, en la factura se muestran líneas separadas para el tiempo que se ha utilizado y que no se ha utilizado la reserva de bloques. Puede usar estas líneas para ver cuánto tiempo se utilizó en su reserva. Si utiliza un sistema operativo premium, solo verá un cargo por uso en la línea del tiempo utilizado. Para obtener más información, consulte [Precios y facturación de bloques de capacidad](#capacity-blocks-pricing-billing). No hay cargos adicionales por el tiempo no utilizado.

Para obtener más información, consulte [Ver su factura](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/getting-viewing-bill.html) en la *Guía del usuario de Administración de facturación y costos de AWS*.

Si el bloque de capacidad comienza en un mes diferente al mes en que compró la reserva, el precio inicial y el uso de la reserva se muestran en meses de facturación distintos. En AWS Cost and Usage Report, el ID de reserva de bloques de capacidad aparece en la partida **reservation/ReservationARN** de la tarifa inicial y en **lineitem/ResourceID** de la factura de aniversario de modo que pueda asociar el uso al precio inicial correspondiente.

# Búsqueda y compra de bloques de capacidad
<a name="capacity-blocks-purchase"></a>

Para reservar un bloque de capacidad, primero tiene que encontrar un bloque de tiempo en el que haya capacidad disponible que se adapte a sus necesidades. Para encontrar un bloque de capacidad que se pueda reservar, debe especificar lo siguiente.
+ El número de instancias que necesita
+ El tiempo durante el que necesita las instancias
+ El intervalo de fechas en el que necesita su reserva

Para buscar una oferta de bloques de capacidad disponible, especifique la duración de la reserva y el número de instancias. Tiene que especificar las duraciones de la reserva en **incrementos de 1 día hasta un total de 14 días, y en incrementos de 7 días hasta un total de 182 días**. Cada bloque de capacidad puede tener hasta 64 instancias, y se pueden tener hasta 256 instancias en todos los bloques de capacidad.

Cuando solicite un bloque de capacidad que se ajuste a sus especificaciones, proporcionaremos los detalles de hasta 6 bloques disponibles. Todos los bloques de capacidad finalizan a las 11:30 h (hora universal coordinada), por lo que los bloques que se inicien el mismo día tendrán las duraciones que más se aproximen a la duración deseada. Un bloque tendrá una duración ligeramente inferior a la duración deseada, mientras que la del otro será ligeramente superior.

Los detalles de la oferta incluyen la hora de inicio de la reserva, la zona de disponibilidad de la reserva y el precio de la reserva. Para obtener más información, consulte [Precios y facturación de bloques de capacidad](capacity-blocks-pricing-billing.md).

Puede comprar la oferta de bloques de capacidad que se muestra o puede modificar sus criterios de búsqueda para ver las demás opciones disponibles. No hay una fecha de caducidad predefinida para la oferta, pero las ofertas solo están disponibles por orden de llegada.

Cuando compra una oferta de bloques de capacidad, recibe una respuesta inmediata que confirma que su bloque de capacidad está reservado. Tras la confirmación, verá una nueva reserva de capacidad en su cuenta con el tipo de reserva `capacity-block` y el valor de `start-date` establecido en la hora de inicio de la oferta que ha adquirido. Su reserva de bloques de capacidad se crea con un estado de `payment-pending`. Una vez que el pago inicial se haya procesado correctamente, el estado de la reserva cambiará a `scheduled`. Para obtener más información, consulte [Facturación](capacity-blocks-pricing-billing.md#capacity-blocks-billing).

**nota**  
 Para comprar y usar bloques de capacidad en las zonas locales, debe activar la zona local. 

------
#### [ Console ]

**Búsqueda y compra de un bloque de capacidad**

1. Abra la consola de Amazon EC2 en [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. En la barra de navegación de la parte superior de la pantalla, debe seleccionar una Región de AWS. Esta elección es importante porque no todos los tipos de instancias de todas las regiones admiten tamaños de bloques de capacidad de 64 instancias.

1. En el panel de navegación, elija **Reservas de capacidad** y **Crear bloque de capacidad**.

1. En **Tipos de bloques de capacidad**, elija **Instancias** o **UltraServers**.

1. En **Atributos de capacidad**, puede definir los parámetros de búsqueda del bloque de capacidad. De forma predeterminada, la plataforma es Linux. Si quiere seleccionar un sistema operativo diferente, use AWS CLI. Para obtener más información, consulte [Plataformas admitidas](ec2-capacity-blocks.md#capacity-blocks-platforms).

1. En **Capacidad total** (para instancias) o **Recuento de UltraServer** (para UltraServers), especifique el número de instancias o UltraServers que desea reservar.

1. En **Duración**, ingrese la cantidad de días durante los que necesita la reserva.

1. En **Intervalo de fechas para buscar bloques de capacidad**, ingrese la fecha más temprana en la que desea que comience su reserva.

1. Elija **Buscar bloques de capacidad**.

1. Si hay un bloque de capacidad disponible que cumpla sus especificaciones, verá una oferta en **bloques de capacidad recomendados**. Si hay varias ofertas que cumplen sus especificaciones, se muestra la oferta de bloques de capacidad disponible más temprana. Para ver otras ofertas de bloques de capacidad, ajuste las entradas de búsqueda y vuelva a seleccionar **Buscar bloques de capacidad**.

1. Cuando encuentre una oferta de bloques de capacidad que desee comprar, seleccione **Siguiente**.

1. (Opcional) En la página **Agregar etiquetas**, elija **Agregar nueva etiqueta**.

1. En la página **Revisar y comprar** se muestran la fecha de inicio y finalización, la duración, el número total de instancias y el precio. 
**nota**  
Los bloques de capacidad no se pueden cancelar una vez que los haya reservado.

1. En la ventana emergente **Comprar un bloque de capacidad**, escriba confirmar y, a continuación, seleccione **Comprar**.

------
#### [ AWS CLI ]

**Para encontrar un bloque de capacidad de instancia**  
Use el comando [describe-capacity-block-offerings](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-capacity-block-offerings.html).

El siguiente ejemplo muestra cómo localizar bloques de capacidad de instancia.

```
aws ec2 describe-capacity-block-offerings \
--instance-type p5.48xlarge \
--instance-count 16 \
--start-date-range 2023-08-14T00:00:00Z \
--end-date-range 2023-10-22-T00:00:00Z \
--capacity-duration-hours 48 \
--all-availability-zones
```

El siguiente ejemplo muestra cómo encontrar bloques de capacidad de UltraServer.

```
aws ec2 describe-capacity-block-offerings \
--ultraserver-type u-p6e-gb200x72 \
--ultraserver-count 1 \
--start-date-range 2023-08-14T00:00:00Z \
--end-date-range 2023-10-22-T00:00:00Z \
--capacity-duration-hours 48
```

**Para comprar un bloque de capacidad**  
Use el comando [purchase-capacity-block](https://docs.aws.amazon.com/cli/latest/reference/ec2/purchase-capacity-block.html) con el ID de la oferta del bloque de capacidad obtenido en la salida del ejemplo anterior.

```
aws ec2 purchase-capacity-block \
--capacity-block-offering-id cb-0123456789abcdefg \
--instance-platform Linux/UNIX
```

------
#### [ PowerShell ]

**Para encontrar bloques de capacidad**  
Utilice el cmdlet [Get-EC2CapacityBlockOffering](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2CapacityBlockOffering.html).

El siguiente ejemplo muestra cómo localizar bloques de capacidad de instancia.

```
Get-EC2CapacityBlockOffering `
-InstanceType p5.48xlarge `
-InstanceCount 16 `
-CapacityDurationHour 48 `
-StartDateRange 2023-08-14T00:00:00Z `
-EndDateRange 2023-10-22-T00:00:00Z `
-AllAvailabilityZones $true
```

El siguiente ejemplo muestra cómo encontrar bloques de capacidad de UltraServer.

```
Get-EC2CapacityBlockOffering `
-UltraserverType u-p6e-gb200x72 `
-UltraserverCount  1 `
-CapacityDurationHour 48 `   
-StartDateRange 2023-08-14T00:00:00Z `
-EndDateRange 2023-10-22-T00:00:00Z
```

**Para comprar un bloque de capacidad**  
Utilice el cmdlet [New-EC2EC2CapacityBlock](https://docs.aws.amazon.com/powershell/latest/reference/items/New-EC2EC2CapacityBlock.html) con el ID de oferta del bloque de capacidad del resultado del ejemplo anterior.

```
New-EC2EC2CapacityBlock `
-CapacityBlockOfferingId cb-0123456789abcdefg `
-InstancePlatform Linux/UNIX
```

------

# Lanzar instancias mediante bloques de capacidad
<a name="capacity-blocks-launch"></a>

Para usar su bloque de capacidad, debe especificar el ID de reserva del bloque de capacidad al iniciar las instancias. la inicialización de una instancia en un bloque de capacidad reduce la capacidad disponible por número de instancias iniciadas. Por ejemplo, si la capacidad de instancias comprada es de ocho instancias y inicia cuatro instancias, la capacidad disponible se reduce en cuatro.

Si termina una instancia que se está ejecutando en el bloque de capacidad antes de que finalice la reserva, puede iniciar una nueva instancia en su lugar. Cuando detiene o termina una instancia en un bloque de capacidad, se necesitan varios minutos para limpiar la instancia antes de poder iniciar otra instancia para reemplazarla. Durante este tiempo, la instancia estará en estado de detención o `shutting-down`. Una vez finalizado este proceso, el estado de la instancia cambiará a `stopped` o `terminated`. A continuación, la capacidad disponible en su bloque de capacidad se actualizará para mostrar otra instancia disponible para usarse.

**Requisitos**
+ La instancia no se puede iniciar en una subred de una zona de disponibilidad diferente a la zona de disponibilidad en la que se encuentra el bloque de capacidad.
+ La instancia no se puede lanzar con una AMI que tenga una plataforma distinta a la del bloque de capacidad.
+  Para usar los bloques de capacidad en las zonas locales, debe optar por la zona local. 

------
#### [ Console ]

**Lanzamiento de instancias en un bloque de capacidad**

1. Abra la consola de Amazon EC2 en [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. En la barra de navegación de la parte superior de la pantalla, seleccione la región para la reserva de bloques de capacidad.

1. En el panel de la consola de Amazon EC2, elija **iniciar instancia**.

1. Siga el procedimiento para [Iniciar una instancia](ec2-launch-instance-wizard.md).

1. Expanda **Detalles avanzados** y, en **Opción de compra**, elija **Bloques de capacidad**. A continuación, realice alguna de las operaciones siguientes:
   + Para lanzar las instancias en un bloque de capacidad específico, en **Reserva de capacidad**, elija **Especificar reserva de capacidad** y, a continuación, seleccione el bloque de capacidad.
   + (*Solo UltraServers*) Para lanzar las instancias en un grupo de recursos del bloque de capacidad de UltraServer, en **Reserva de capacidad**, elija **Especificar grupo de recursos de reserva de capacidad** y, a continuación, seleccione el grupo de recursos.

1. Seleccione **Iniciar instancia**.

------
#### [ AWS CLI ]

**Lanzamiento de instancias en un bloque de capacidad**  
Utilice el comando [run-instances](https://docs.aws.amazon.com/cli/latest/reference/ec2/run-instances.html) con la opción `instance-market-options MarketType`.

En el siguiente ejemplo, se lanza una instancia en un bloque de capacidad específico.

```
aws ec2 run-instances \
--image-id ami-0abcdef1234567890 \
--count 1 \
--instance-type p5.48xlarge \
--key-name my-key-pair \
--subnet-id subnet-0abcdef1234567890 \
--instance-market-options MarketType='capacity-block' \
--capacity-reservation-specification CapacityReservationTarget={CapacityReservationId=capacity_block_id}
```

En el siguiente ejemplo se lanza una instancia en un grupo de recursos del bloque de capacidad de UltraServer.

```
aws ec2 run-instances \
--image-id ami-0abcdef1234567890 \
--count 1 \
--instance-type p6e-gb200.36xlarge \
--key-name my-key-pair \
--subnet-id subnet-0abcdef1234567890 \
--instance-market-options MarketType='capacity-block' \
--capacity-reservation-specification CapacityReservationTarget={CapacityReservationResourceGroupArn=resource_group_arn}
```

------
#### [ PowerShell ]

**Lanzamiento de instancias en un bloque de capacidad**  
Utilice el cmdlet [New-EC2Instance](https://docs.aws.amazon.com/powershell/latest/reference/items/New-EC2Instance.html) con la opción `-InstanceMarketOption` definida de la siguiente forma.

```
$marketoption = New-Object Amazon.EC2.Model.InstanceMarketOptionsRequest
$marketoption.MarketType = "capacity-block"
```

En el siguiente ejemplo, se lanza una instancia en un bloque de capacidad específico.

```
New-EC2Instance `
-ImageId ami-0abcdef1234567890 `
-InstanceType p5.48xlarge `
-KeyName "my-key-pair" `
-SubnetId subnet-0abcdef1234567890 `
-InstanceMarketOptions $marketoption `
-CapacityReservationTarget_CapacityReservationId capacity_block_id
```

En el siguiente ejemplo se lanza una instancia en un grupo de recursos del bloque de capacidad de UltraServer.

```
New-EC2Instance `
-ImageId ami-0abcdef1234567890 `
-InstanceType p6e-gb200.36xlarge `
-KeyName "my-key-pair" `
-SubnetId subnet-0abcdef1234567890 `
-InstanceMarketOptions $marketoption `
-CapacityReservationTarget_CapacityReservationResourceGroupArn "resource_group_arn"
```

------

**Recursos relacionados**
+ Para crear una plantilla de lanzamiento destinada a un bloque de capacidad, consulte [Almacenamiento de parámetros de inicialización de instancias en plantillas de inicialización de Amazon EC2](ec2-launch-templates.md).
+ Para lanzar instancias en un bloque de capacidad mediante la flota de EC2, consulte [Tutorial: Configuración de la flota de EC2 para lanzar instancias en bloques de capacidad](ec2-fleet-launch-instances-capacity-blocks-walkthrough.md).
+ Para configurar un grupo de nodo de EKS gestionado con un bloque de capacidad, consulte [Crear un grupo de nodo gestionado con bloques de capacidad para ML](https://docs.aws.amazon.com/eks/latest/userguide/capacity-blocks-mng.html) en la **Guía del usuario de Amazon EKS**.
+ Para configurar AWS ParallelCluster mediante un bloque de capacidad, consulte [ML en AWS ParallelCluster](https://catalog.workshops.aws/ml-on-aws-parallelcluster/en-US).

# Visualización de bloques de capacidad
<a name="capacity-blocks-view"></a>

Después de reservar un bloque de capacidad, podrá ver la reserva de bloques de capacidad en su cuenta de AWS. Puede consultar los valores `start-date` y `end-date` para ver cuándo comenzará y finalizará su reserva. Antes de que comience una reserva de bloques de capacidad, la capacidad disponible aparece como cero. Puede ver cuántas instancias estarán disponibles en su bloque de capacidad mediante el valor de etiqueta de la clave de etiqueta `aws:ec2capacityreservation:incrementalRequestedQuantity`.

Cuando comienza una reserva de bloque de capacidad, el estado de la reserva cambia de `scheduled` a `active`. Emitimos un evento a través de Amazon EventBridge para notificarle que el bloque de capacidad está disponible para usarse. Para obtener más información, consulte [Supervisar los bloques de capacidad mediante EventBridge](capacity-blocks-monitor.md).

Los bloques de capacidad tienen los siguientes estados:
+ `payment-pending`: el pago inicial aún no se ha procesado.
+ `payment-failed`: el pago no se pudo procesar en el plazo de 12 horas. Se ha liberado su bloque de capacidad.
+ `scheduled`: el pago se procesó y la reserva de bloques de capacidad aún no ha comenzado.
+ `active`: la capacidad reservada está disponible para su uso.
+ `expired`: la reserva de bloques de capacidad caducó automáticamente en la hora y fecha especificadas en su solicitud de reserva. La capacidad reservada ya no está disponible para su uso.

------
#### [ Console ]

**Para ver bloques de capacidad**

1. Abra la consola de Amazon EC2 en [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. En el panel de navegación, seleccione **Reservas de capacidad**.

1. En la página **Información general sobre las reservas de capacidad**, verá una tabla de recursos con detalles sobre todos sus recursos de reservas de capacidad. Para encontrar sus reservas de bloques de capacidad, seleccione **bloques de capacidad** en la lista desplegable situada encima de **ID de reserva de capacidad**. En la tabla, puede ver información sobre sus bloques de capacidad, como las fechas de inicio y finalización, la duración y el estado.

1. Para obtener más información sobre un bloque de capacidad, seleccione el ID de reserva del bloque de capacidad que desee ver. En la página **Detalles de la reserva de capacidad** se muestran todas las propiedades de la reserva y el número de instancias en uso y disponibles en el bloque de capacidad.
**nota**  
Antes de que comience una reserva de bloques de capacidad, la capacidad disponible aparece como cero. Puede ver cuántas instancias estarán disponibles cuando la reserva del bloque de capacidad comience con el siguiente valor de etiqueta para la clave de etiqueta: `aws:ec2capacityreservation:incrementalRequestedQuantity`.

------
#### [ AWS CLI ]

**Para ver bloques de capacidad**  
De forma predeterminada, cuando se utiliza el comando [describe-capacity reservations](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-capacity-reservations.html), aparecen tanto las reserva de capacidad bajo demanda como las reservas de bloques de capacidad. Para ver solo sus reservas de bloques de capacidad, filtre las reservas de tipo `capacity-block`.

```
aws ec2 describe-capacity-reservations \
    --filters Name=reservation-type,Values=capacity-block
```

------
#### [ PowerShell ]

**Para ver bloques de capacidad**  
Utilice el cmdlet [Get-EC2CapacityReservation](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2CapacityReservation.html). De forma predeterminada, se muestran tanto las reservas de capacidad bajo demanda como las reservas de bloques de capacidad. Para ver solo sus reservas de bloques de capacidad, filtre las reservas de tipo `capacity-block`.

```
Get-EC2CapacityReservation `
    -Filter @{Name="reservation-type"; Values="capacity-block"}
```

------

# Ampliación de los bloques de capacidad
<a name="capacity-blocks-extend"></a>

Con los bloques de capacidad, se reserva capacidad de computación para las cargas de trabajo a fin de garantizar su disponibilidad y continuidad. Puede ampliar la duración de los bloques de capacidad creados para ajustarlos a sus necesidades según vayan cambiando.

Para ampliar un bloque de capacidad, este se debe encontrar en estado `active` o `scheduled`, y no puede tener ampliaciones en estado `payment-pending`. Puede solicitar una ampliación de la duración del bloque de capacidad hasta un mínimo de 1 hora o un máximo de 56 días antes de que caduque. Puede ampliar el bloque de capacidad en incrementos de 1 día hasta un total de hasta 14 días, y en incrementos de 7 días hasta un total de 182 días (26 semanas). Al ampliar el bloque de capacidad, su fecha de finalización se actualizará de modo que las instancias puedan continuar en funcionamiento sin interrupciones.
+ No hay límite en la cantidad de ampliaciones que se pueden aplicar a un bloque de capacidad
+ El ID de reserva de capacidad no cambiará después de ampliar el bloque
+ Los bloques de capacidad solo se pueden ampliar si hay suficiente capacidad disponible para admitirlos, lo que no está garantizado.

## Facturación
<a name="capacity-blocks-extend-billing"></a>

El precio de una oferta de bloques de capacidad se cobra por adelantado. La ampliación se mantendrá en estado `payment-pending` hasta que se pague la factura. Si el pago no se procesa en un plazo de 12 horas o hasta 35 minutos antes de la fecha programada de finalización del bloque de capacidad (lo que ocurra primero), la ampliación no se hará efectiva y el estado cambiará a `payment-failed`. La reserva del bloque de capacidad se mantendrá en estado `active` y finalizará en la fecha de finalización original. 

Una vez que el pago se haya procesado correctamente, el estado de la ampliación del bloque de capacidad cambiará a `payment-succeeded` y la fecha de finalización de la reserva del bloque de capacidad se actualizará a la nueva fecha de finalización. Los detalles de la ampliación se pueden consultar en la sección **Detalles de la ampliación del bloque de capacidad** de la consola o mediante el comando [describe-capacity-block-extension-history](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-capacity-block-extension-history.html).

## Ampliación del bloque de capacidad
<a name="capacity-blocks-extend-procedure"></a>

------
#### [ Console ]

**Para extender un bloque de capacidad**

1. Abra la consola de Amazon EC2 en [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. En el panel de navegación, seleccione **Reservas de capacidad**.

1. En la página **Información general sobre las reservas de capacidad**, verá una tabla de recursos con detalles sobre todos los recursos de reservas de capacidad. Seleccione el ID de reserva del bloque de capacidad que desee ampliar.

1. En el menú desplegable **Acciones**, elija **Ampliar bloque de capacidad**.

1. En **Duración**, ingrese la cantidad de días durante los que necesita prolongar la reserva.

1. Elija **Buscar bloque de capacidad**.

1. Si hay un bloque de capacidad disponible que cumpla sus especificaciones, aparecerá una oferta en **Bloques de capacidad recomendados**. Para ver otras ofertas de bloques de capacidad, ajuste las entradas de búsqueda y vuelva a seleccionar **Buscar bloques de capacidad**.

1. Cuando encuentre una oferta de bloque de capacidad que desee comprar, elija **Ampliar**.

1. En la ventana emergente **Ampliar bloque de capacidad**, introduzca *confirmar* y, a continuación, elija **Ampliar**.

------
#### [ AWS CLI ]

**Para buscar una extensión de bloque de capacidad**  
Utilice el comando [describe-capacity-block-extension-offerings](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-capacity-block-extension-offerings.html). En el siguiente ejemplo, se busca una extensión de bloque de capacidad de 48 horas para la reserva especificada.

```
aws ec2 describe-capacity-block-extension-offerings \
    --capacity-reservation-id cr-1234567890abcdefg \
    --capacity-block-extension-duration-hours 48
```

**Para extender un bloque de capacidad**  
Utilice el comando [purchase-capacity-block-extension](https://docs.aws.amazon.com/cli/latest/reference/ec2/purchase-capacity-block-extension.html). Especifique el ID de oferta de extensión del resultado del ejemplo anterior.

```
aws ec2 purchase-capacity-block-extension \
    --capacity-block-extension-offering-id cbe-0123456789abcdefg \
    --capacity-reservation-id cr-1234567890abcdefg
```

------
#### [ PowerShell ]

**Para buscar una extensión de bloque de capacidad**  
Utilice el cmdlet [Get-EC2CapacityBlockExtensionOffering](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2CapacityBlockExtensionOffering.html). En el siguiente ejemplo, se busca una extensión de bloque de capacidad de 48 horas para la reserva especificada.

```
Get-EC2CapacityBlockExtensionOffering `
    -CapacityReservationId cr-1234567890abcdefg `
    -CapacityBlockExtensionDurationHour 48
```

**Para extender un bloque de capacidad**  
Utilice el cmdlet [Invoke-EC2CapacityBlockExtension](https://docs.aws.amazon.com/powershell/latest/reference/items/Invoke-EC2CapacityBlockExtension.html). Especifique el ID de oferta de extensión del resultado del ejemplo anterior.

```
Invoke-EC2CapacityBlockExtension `
    -CapacityBlockExtensionOfferingId cbe-0123456789abcdefg `
    -CapacityReservationId cr-1234567890abcdefg
```

------

# Compartir bloques de capacidad
<a name="capacity-blocks-share"></a>

 El uso compartido de bloques de capacidad permite a sus propietarios compartir bloques de capacidad de Amazon EC2 con otras cuentas de AWS de una organización de AWS. Esto le permite maximizar el uso de la capacidad reservada de la GPU en diferentes equipos y proyectos para utilizar los bloques de capacidad de manera eficiente. 

 La cuenta de AWS que posee la reserva de capacidad (propietario) la comparte con otras dos cuentas de AWS (consumidores). Un propietario puede compartir un bloque de capacidad con cuentas de AWS específicas de su organización de AWS, con una unidad organizativa de su organización de AWS o con toda la organización de AWS. Los consumidores pueden lanzar instancias en bloques de capacidad que comparten con ellos de la misma forma que harían con los bloques de capacidad que poseen en su propia cuenta. 

## Requisitos previos para compartir bloques de capacidad
<a name="capacity-blocks-share-prereq"></a>

Antes de poder compartir un bloque de capacidad, deben cumplirse las siguientes condiciones:
+ **Debe ser propietario del bloque de capacidad**: no puede compartir un bloque de capacidad que se haya compartido con usted.
+  **El estado del bloque de capacidad debe estar activo o programado**: los bloques de capacidad que estén en otros [estados](https://docs.aws.amazon.com/cli/latest/reference/ec2/purchase-capacity-block.html), como `expired` o `payment-pending`, no se puedan compartir. 
+ **Uso compartido únicamente dentro de su organización de AWS**: un propietario puede compartir un bloque de capacidad con cuentas de AWS específicas de su organización de AWS, con una unidad organizativa de su organización de AWS o con toda la organización de AWS.
+  **No se admiten bloques de capacidad de UltraServer**: no puede compartir bloques de capacidad para los Amazon EC2 UltraServers. 
+ **Elegibilidad de cuentas**: el uso compartido no está disponible para nuevas cuentas de AWS o cuentas de AWS que tengan un historial de facturación limitado.

## Servicios relacionados
<a name="capacity-blocks-share-related"></a>

El uso compartido de bloques de capacidad se integra con AWS Resource Access Manager (AWS RAM). AWS RAM es un servicio que le permite compartir sus recursos de AWS con cualquier cuenta de AWS o a través de AWS Organizations. Con AWS RAM, puede compartir recursos de su propiedad creando un *uso compartido de recursos*. Un uso compartido de recursos especifica los recursos que compartir y los consumidores con quienes compartirlos. Los consumidores pueden ser cuentas de AWS individuales, unidades organizativas o toda una organización de AWS Organizations.

Para obtener más información sobre AWS RAM, consulte la *[Guía del usuario de AWS RAM](https://docs.aws.amazon.com/ram/latest/userguide/)*.

## Permisos de bloques de capacidad compartidos
<a name="capacity-blocks-share-permissions"></a>

### Permisos de los propietarios
<a name="capacity-blocks-share-permissions-owner"></a>

 El propietario del bloque de capacidad sigue siendo responsable de administrar el bloque de capacidad (por ejemplo, ampliarlo o compartirlo) y las instancias que lanzan en este. Los propietarios no pueden modificar instancias que los consumidores inician en Bloques de capacidad que han compartido. 

### Permisos de los consumidores
<a name="capacity-blocks-share-permissions-consumer"></a>

 Los consumidores pueden lanzar instancias en la capacidad compartida y son responsables de administrarlas. Los consumidores no pueden ver o modificar instancias propiedad de otros consumidores o del propietario del bloque de capacidad. Los consumidores solo pueden ver la capacidad total y disponible en el bloque de capacidad compartido. 

## Compartir un bloque de capacidad
<a name="capacity-blocks-sharing"></a>

Para compartir un bloque de capacidad, debe agregarlo a un uso compartido de recursos. Un recurso compartido es un recurso de AWS RAM que le permite compartir los recursos a través de Cuentas de AWS.

Si agregó su bloque de capacidad a un recurso compartido con toda la organización de AWS, los consumidores de su organización obtienen acceso al bloque de capacidad compartido.

------
#### [ Console ]

**Cómo compartir un bloque de capacidad que posea mediante la consola de Amazon EC2**

1. Abra la consola de Amazon EC2 en [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. En el panel de navegación, seleccione **Reservas de capacidad**.

1. Elija el bloque de capacidad que desea compartir y seleccione **Acciones, Compartir reserva**.

1. Seleccione el recurso compartido al que desea añadir el bloque de capacidad y elija **Compartir Reserva de capacidad**.

   Los consumidores pueden tardar algunos minutos en obtener acceso al bloque de capacidad compartido.

**Cómo agregar un bloque de capacidad a un nuevo recurso compartido**  
Primero debe crear el uso compartido mediante la consola de AWS RAM. Para obtener más información, consulte [Crear un recurso compartido](https://docs.aws.amazon.com/ram/latest/userguide/working-with-sharing.html#working-with-sharing-create) en la *Guía del usuario de AWS RAM*.

------
#### [ AWS CLI ]

**Uso compartido de un bloque de capacidad que posea**  
 Utilice los comandos [create-resource-share](https://docs.aws.amazon.com/cli/latest/reference/ram/create-resource-share.html) y [associate-resource-share](https://docs.aws.amazon.com/cli/latest/reference/ram/associate-resource-share.html). 

```
aws ram create-resource-share \
    --name my-resource-share \
    --resource-arns arn:aws:ec2:us-east-2:123456789012:capacity-reservation/cr-1234abcd56EXAMPLE
```

```
aws ram associate-resource-share \
    --resource-share-arn arn:aws:ram:us-east-2:123456789012:resource-share/7ab63972-b505-7e2a-420d-6f5d3EXAMPLE \
    --resource-arns arn:aws:ec2:us-east-2:123456789012:capacity-reservation/cr-1234abcd56EXAMPLE
```

------
#### [ PowerShell ]

**Uso compartido de un bloque de capacidad que posea**  
 Utilice los cmdlets [New-RAMResourceShare](https://docs.aws.amazon.com/powershell/latest/reference/items/New-RAMResourceShare.html) y [Connect-RAMResourceShare](https://docs.aws.amazon.com/powershell/latest/reference/items/Connect-RAMResourceShare.html). 

```
New-RAMResourceShare `
    -Name my-resource-share `
    -ResourceArn "arn:aws:ec2:us-east-2:123456789012:capacity-reservation/cr-1234abcd56EXAMPLE"
```

```
Connect-RAMResourceShare `
    -ResourceShareArn "arn:aws:ram:us-east-2:123456789012:resource-share/7ab63972-b505-7e2a-420d-6f5d3EXAMPLE" `
    -ResourceArn "arn:aws:ec2:us-east-2:123456789012:capacity-reservation/cr-1234abcd56EXAMPLE"
```

------

 Los bloques de capacidad funcionan **por orden de llegada** en todas las cuentas, independientemente del estado de propiedad. Al compartir un bloque de capacidad, si un consumidor lanza las instancias antes que el propietario, esas instancias ocupan la capacidad hasta que el consumidor las cancele o hasta 30 minutos antes de que caduque el bloque de capacidad. 

## Dejar de compartir un bloque de capacidad
<a name="capacity-blocks-unsharing"></a>

 Puede dejar de compartir un bloque de capacidad en cualquier momento hasta 30 minutos antes de la fecha de caducidad del bloque. 

**Qué ocurre cuando se deja de compartir:**
+ Los consumidores ya no lanzan nuevas instancias en el bloque de capacidad que no se compartió.
+ Todas las instancias en ejecución seguirán ejecutándose hasta 30 minutos antes de la fecha de caducidad del bloque de capacidad, a menos que el consumidor las cancele.

------
#### [ Console ]

**Para dejar de compartir un bloque de capacidad de su propiedad mediante la consola de Amazon EC2**

1. Abra la consola de Amazon EC2 en [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. En el panel de navegación, seleccione **Reservas de capacidad**.

1. Seleccione el bloque de capacidad y elija la pestaña **Uso compartido**.

1.  La pestaña **Uso compartido** muestra los recursos compartidos a los que se ha añadido el bloque de capacidad. Seleccione el uso compartido de recurso del que desea quitar el bloque de capacidad. 

1. Elija **Eliminar del recurso compartido**.

------
#### [ AWS CLI ]

**Dejar de compartir un bloque de capacidad que posea**  
Utilice el comando [disassociate-resource-share](https://docs.aws.amazon.com/cli/latest/reference/ram/disassociate-resource-share.html).

```
aws ram disassociate-resource-share \
    --resource-share-arn arn:aws:ram:us-east-2:123456789012:resource-share/7ab63972-b505-7e2a-420d-6f5d3EXAMPLE \
    --resource-arns arn:aws:ec2:us-east-2:123456789012:capacity-reservation/cr-1234abcd56EXAMPLE
```

------
#### [ PowerShell ]

**Dejar de compartir un bloque de capacidad que posea**  
Utilice el cmdlet [Disconnect-RAMResourceShare](https://docs.aws.amazon.com/powershell/latest/reference/items/Disconnect-RAMResourceShare.html).

```
Disconnect-RAMResourceShare `
    -ResourceShareArn "arn:aws:ram:us-east-2:123456789012:resource-share/7ab63972-b505-7e2a-420d-6f5d3EXAMPLE" `
    -ResourceArn "arn:aws:ec2:us-east-2:123456789012:capacity-reservation/cr-1234abcd56EXAMPLE"
```

------

## Supervise el uso compartido del bloque de capacidad
<a name="capacity-blocks-shared-monitor-usage"></a>

Los propietarios de los bloques de capacidad pueden supervisar qué cuentas utilizan sus bloques de capacidad compartidos y realizar un seguimiento del uso de las instancias por cuenta.

------
#### [ AWS CLI ]

**Supervisar el uso de un bloque de capacidad**  
Utilice el comando [get-capacity-reservation-usage](https://docs.aws.amazon.com/cli/latest/reference/ec2/get-capacity-reservation-usage.html).

```
aws ec2 get-capacity-reservation-usage \
    --capacity-reservation-id cr-1234abcd56EXAMPLE
```

**Esta API permite a los propietarios:**
+ Ver qué cuentas utilizan actualmente el bloque de capacidad.
+ Consultar el número de instancias que ejecuta cada cuenta.

------

## Avisos de finalización de instancias
<a name="capacity-blocks-shared-instance-termination-notices"></a>

 Las cuentas de propietarios y consumidores que tengan instancias que se estén ejecutando en el bloque de capacidad recibirán un evento de EventBridge 40 minutos antes de que finalice la reserva del bloque de capacidad, lo que indicará que cualquier instancia que se esté ejecutando en la reserva empezará a finalizar en 10 minutos. Para obtener más información, consulte [Supervisar los bloques de capacidad mediante EventBridge](capacity-blocks-monitor.md). 

## Ampliaciones de bloques de capacidad
<a name="capacity-blocks-shared-extend"></a>

Los bloques de capacidad se pueden ampliar mientras se comparten. Solo la cuenta del propietario puede extender un bloque de capacidad compartido.

 Cuando se amplía un bloque de capacidad, las instancias en ejecución lanzadas por el propietario o los consumidores heredan de manera automática la nueva fecha de caducidad, y los consumidores pueden seguir utilizando la capacidad compartida hasta la nueva fecha de caducidad sin ninguna interrupción de la instancia. 

## Precios y facturación
<a name="capacity-blocks-shared-pricing-billing"></a>

 A los propietarios se les facturan los bloques de capacidad que comparten y pagan por adelantado el bloque de capacidad cuando lo compran. Los propietarios también pagan los cargos del sistema operativo de las instancias que ejecutan en el bloque de capacidad. 

 A los consumidores solo se les facturan los cargos del sistema operativo de las instancias que ejecutan en el bloque de capacidad compartido. A los consumidores no se les cobra por la reserva del bloque de capacidad en sí. 

# Creación de un grupo de recursos para los bloques de capacidad de UltraServer
<a name="cb-group"></a>

Puede utilizar Grupos de recursos de AWS para crear colecciones lógicas de bloques de capacidad de UltraServer. Tras crear el grupo de recursos, puede agregar los bloques de capacidad de UltraServer que le pertenezcan a su cuenta. Tras agregar los bloques de capacidad de UltraServer, puede dirigir los lanzamientos de instancias al grupo de recursos en lugar de a los bloques de capacidad individuales. Las instancias que se dirijan a un grupo de recursos coinciden con cualquier bloque de capacidad de UltraServer del grupo que tenga atributos coincidentes y capacidad disponible. Si el grupo de recursos no tiene ningún bloque de capacidad de UltraServer con atributos coincidentes y capacidad disponible, la instancia no se lanza.

Si se elimina un bloque de capacidad de UltraServer de un grupo de recursos mientras tiene instancias en ejecución, esas instancias seguirán ejecutándose en el bloque de capacidad. Si un bloque de capacidad de UltraServer de un grupo finaliza mientras tiene instancias en ejecución, las instancias se terminan.

No puede agregar bloques de capacidad de instancias a un grupo de recursos.

Siga uno de los métodos siguientes para crear un grupo de recursos para los bloques de capacidad de UltraServer.

------
#### [ AWS CLI ]

**Creación de un grupo de recursos para los bloques de capacidad de UltraServer**  
Utilice el comando [create-group](https://docs.aws.amazon.com/cli/latest/reference/resource-groups/create-group.html) de la AWS CLI y, en `--configuration`, especifique lo siguiente:

```
{
  "Configuration": [
    {
      "Type": "AWS::EC2::CapacityReservationPool",
      "Parameters": [
        {
          "Name": "instance-type",
          "Values": [
            "instance_type"
          ]
        },
        {
          "Name": "reservation-type",
          "Values": [
            "capacity-block"
          ]
        }
      ]
    },
    {
      "Type": "AWS::ResourceGroups::Generic",
      "Parameters": [
        {
          "Name": "allowed-resource-types",
          "Values": [
            "AWS::EC2::CapacityReservation"
          ]
        }
      ]
    }
  ]
}
```

------
#### [ PowerShell ]

**Creación de un grupo de recursos para los bloques de capacidad de UltraServer**  
Utilice el cmdlet [New-RGGroup](https://docs.aws.amazon.com/powershell/latest/reference/items/New-RGGroup.html). En `-Configuration`, especifique lo siguiente:

```
{
  "Configuration": [
    {
      "Type": "AWS::EC2::CapacityReservationPool",
      "Parameters": [
        {
          "Name": "instance-type",
          "Values": [
            "instance_type"
          ]
        },
        {
          "Name": "reservation-type",
          "Values": [
            "capacity-block"
          ]
        }
      ]
    },
    {
      "Type": "AWS::ResourceGroups::Generic",
      "Parameters": [
        {
          "Name": "allowed-resource-types",
          "Values": [
            "AWS::EC2::CapacityReservation"
          ]
        }
      ]
    }
  ]
}
```

------

Tras crear un grupo de recursos para el bloque de capacidad de UltraServer, utilice uno de los siguientes métodos para agregar los bloques de capacidad de UltraServer existentes.

------
#### [ AWS CLI ]

**Cómo agregar un bloque de capacidad de UltraServer a un grupo de recursos**  
Utilice el comando [group-resources](https://docs.aws.amazon.com/cli/latest/reference/resource-groups/group-resources.html). En `--group`, especifique el nombre del grupo de recursos que creó. En `--resource-arns`, especifique los ARN de los bloques de capacidad de UltraServer que desee agregar.

```
aws resource-groups group-resources \
--group MyCRGroup \
--resource-arns CapacityReservationArn
```

------
#### [ PowerShell ]

**Cómo agregar un bloque de capacidad de UltraServer a un grupo de recursos**  
Utilice el cmdlet [Add-RGResource](https://docs.aws.amazon.com/powershell/latest/reference/items/Add-RGResource.html). En `-Group`, especifique el nombre del grupo de recursos que creó. En `-ResourceArn `, especifique los ARN de los bloques de capacidad de UltraServer que desee agregar.

En el siguiente ejemplo se agregan dos reservas de capacidad al grupo especificado.

```
Add-RGResource `
-Group MyCRGroup `
-ResourceArn CapacityReservationArn
```

------

# Supervisar los bloques de capacidad mediante EventBridge
<a name="capacity-blocks-monitor"></a>

Cuando comience su reserva de bloques de capacidad, Amazon EC2 emitirá un evento a través de EventBridge que indicará que su capacidad está lista para usarse. Cuarenta minutos antes de que finalice la reserva de bloques de capacidad, recibirá otro evento de EventBridge en el que se le indicará que cualquier instancia que se esté ejecutando en la reserva empezará a terminarse en 10 minutos. Para más información acerca de los eventos de EventBridge, consulte [Eventos de Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html).

Las siguientes estructuras de eventos para los eventos emitidos para bloques de capacidad:

**bloque de capacidad entregado**  
En el ejemplo siguiente se muestra un evento de un bloque de capacidad entregado.

```
{
  "customer_event_id": "[Capacity Reservation Id]-delivered",
  "detail_type": "Capacity Block Reservation Delivered",
  "source": "aws.ec2",
  "account": "[Customer Account ID]",
  "time": "[Current time]",
  "resources": [
    "[ODCR ARN]"
  ],
  "detail": {
    "capacity-reservation-id": "[ODCR ID]",
    "end-date": "[ODCR End Date]"
  }
}
```

**Advertencia de caducidad del bloque de capacidad**  
En el ejemplo siguiente se muestra un evento de advertencia de caducidad del bloque de capacidad.

```
{
  "customer_event_id": "[Capacity Reservation Id]-approaching-expiry",
  "detail_type": "Capacity Block Reservation Expiration Warning",
  "source": "aws.ec2",
  "account": "[Customer Account ID]",
  "time": "[Current time]",
  "resources": [
    "[ODCR ARN]"
  ],
  "detail": {
    "capacity-reservation-id": "[ODCR ID]",
    "end-date": "[ODCR End Date]"
  }
}
```

**Advertencia de interrupción de instancias de reserva de capacidad**  
En el ejemplo siguiente se muestra un evento de advertencia de interrupción de una instancia de reserva de capacidad de EC2.

```
{
    "version": "0",
    "id": "12345678-1234-1234-1234-123456789012",
    "detail_type": "EC2 Capacity Reservation Instance Interruption Warning",
    "source": "aws.ec2",
    "account": "[Customer Account ID]",
    "time": "[Current time]",
    "region": "[Region]",
    "resources": [
        "[Instance ARN]"
    ],
    "detail": {
        "instance-id": "[Instance ID]",
        "instance-action": "terminate",
        "instance-termination-time": "[Current time]",
        "availability-zone-id": "[Availability Zone ID]",
        "instance-lifecycle": "capacity-block"
    }
}
```

# Registro de llamadas a la API de bloques de capacidad con AWS CloudTrail
<a name="capacity-blocks-logging-using-cloudtrail"></a>

bloques de capacidad se integra a AWS CloudTrail, un servicio que proporciona un registro de las acciones realizadas por un usuario, un rol o un servicio de AWS en bloques de capacidad. CloudTrail captura las llamadas a la API de bloques de capacidad como eventos. Las llamadas capturadas incluyen las llamadas desde la consola de bloques de capacidad y las llamadas desde el código a las operaciones de la API de bloques de capacidad. Si crea un registro de seguimiento, puede habilitar la entrega continua de eventos de CloudTrail a un bucket de Amazon S3, incluidos los eventos de bloques de capacidad. Si no configura un registro de seguimiento, puede ver los eventos más recientes en la consola de CloudTrail en el **Historial de eventos**. Mediante la información que recopila CloudTrail, puede determinar la solicitud que se hizo a bloques de capacidad, la dirección IP desde la que se hizo dicha solicitud, quién la hizo y cuándo, además de información adicional. 

Para obtener más información sobre CloudTrail, consulte la [Guía del usuario de AWS CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-user-guide.html).

## Información de bloques de capacidad en CloudTrail
<a name="capacity-blocks-info-in-cloudtrail"></a>

CloudTrail se habilita en su Cuenta de AWS cuando se crea la cuenta. Cuando se produce una actividad en bloques de capacidad, esa actividad se registra en un evento de CloudTrail junto con otros eventos de servicios de AWS en **Historial de eventos**. Puede ver, buscar y descargar eventos recientes en su Cuenta de AWS. Para más información, consulte [Visualización de eventos con el historial de eventos de CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html).

Para mantener un registro continuo de los eventos en la Cuenta de AWS, incluidos los eventos de bloques de capacidad, cree un registro de seguimiento. Un *registro de seguimiento* permite a CloudTrail enviar archivos de registro a un bucket de Amazon S3. De forma predeterminada, cuando se crea un registro de seguimiento en la consola, el registro de seguimiento se aplica a todas las Regiones de AWS. El registro de seguimiento registra los eventos de todas las regiones de la partición de AWS y envía los archivos de registro al bucket de Amazon S3 especificado. También es posible configurar otros servicios de AWS para analizar en profundidad y actuar en función de los datos de eventos recopilados en los registros de CloudTrail. Para más información, consulte los siguientes temas: 
+ [Introducción a la creación de registros de seguimiento](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)
+ [Servicios e integraciones compatibles con CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html)
+ [Configuración de notificaciones de Amazon SNS para CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/configure-sns-notifications-for-cloudtrail.html)
+ [Recibir archivos de registro de CloudTrail de varias regiones](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html) y [Recibir archivos de registro de CloudTrail de varias cuentas](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html)

Todas las acciones de bloques de capacidad las registra CloudTrail y se documentan en la Referencia de la API de Amazon EC2. Por ejemplo, las llamadas a las acciones `CapacityBlockScheduled` y `CapacityBlockActive` generan entradas en los archivos de registros de CloudTrail.

Cada entrada de registro o evento contiene información sobre quién generó la solicitud. La información de identidad del usuario lo ayuda a determinar lo siguiente: 
+ Si la solicitud se realizó con credenciales de usuario de AWS Identity and Access Management (IAM) o credenciales de usuario raíz.
+ Si la solicitud se realizó con credenciales de seguridad temporales de un rol o fue un usuario federado.
+ Si la solicitud la realizó otro servicio de AWS.

Para obtener más información, consulte [Elemento userIdentity de CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html).

## Descripción de las entradas de archivos de registro de bloques de capacidad
<a name="understanding-service-name-entries"></a>

Un registro de seguimiento es una configuración que permite la entrega de eventos como archivos de registros en un bucket de Amazon S3 que especifique. Los archivos de registro de CloudTrail pueden contener una o varias entradas de registro. Un evento representa una solicitud específica realizada desde un origen cualquiera y contiene información sobre la acción solicitada, la fecha y la hora de la acción, los parámetros de la solicitud, etc. Los archivos de registro de CloudTrail no rastrean el orden en la pila de las llamadas públicas a la API, por lo que estas no aparecen en ningún orden específico. 

En los siguientes ejemplos se muestran entradas de registros de CloudTrail para:
+ [TerminateCapacityBlocksInstances](#understanding-capacity-blocks-entries-terminatecapacityblockinstances)
+ [CapacityBlockPaymentFailed](#understanding-capacity-blocks-entries-capacityblockpaymentfailed)
+ [CapacityBlockScheduled](#understanding-capacity-blocks-entries-capacityblockscheduled)
+ [CapacityBlockActive](#understanding-capacity-blocks-entries-capacityblockactive)
+ [CapacityBlockFailed](#understanding-capacity-blocks-entries-capacityblockfailed)
+ [CapacityBlockExpired](#understanding-capacity-blocks-entries-capacityblockexpired)

**nota**  
Algunos campos se han eliminado de los ejemplos por motivos de privacidad de datos.

### TerminateCapacityBlocksInstances
<a name="understanding-capacity-blocks-entries-terminatecapacityblockinstances"></a>

```
{
  "eventVersion": "1.05",
  "userIdentity": {
    "accountId": "123456789012",
    "invokedBy": "AWS Internal;"
  },
  "eventTime": "2023-10-02T00:06:08Z",
  "eventSource": "ec2.amazonaws.com",
  "eventName": "TerminateCapacityBlockInstances",
  "awsRegion": "us-east-1",
  "sourceIPAddress": "203.0.113.25",
  "userAgent": "aws-cli/1.15.61 Python/2.7.10 Darwin/16.7.0 botocore/1.10.60",
  "requestParameters": null,
  "responseElements": null,
  "eventID": "a1b2c3d4-EXAMPLE",
  "readOnly": false,
  "resources": [
    {
      "accountId": "123456789012",
      "type": "AWS::EC2::Instance",
      "ARN": "arn:aws:ec2:us-east-1:123456789012:instance/i-1234567890abcdef0"
    }
    {
      "accountId": "123456789012",
      "type": "AWS::EC2::Instance",
      "ARN": "arn:aws:ec2:us-east-1:123456789012:instance/i-0598c7d356eba48d7"
    }
  ],
  "eventType": "AwsServiceEvent",
  "recipientAccountId": "123456789012",
  "serviceEventDetails": {
      "capacityReservationId": "cr-12345678",
      }
}
```

### CapacityBlockPaymentFailed
<a name="understanding-capacity-blocks-entries-capacityblockpaymentfailed"></a>

```
{
  "eventVersion": "1.05",
  "userIdentity": {
    "accountId": "123456789012",
    "invokedBy": "AWS Internal;"
  },
  "eventTime": "2023-10-02T00:06:08Z",
  "eventSource": "ec2.amazonaws.com",
  "eventName": "CapacityBlockPaymentFailed",
  "awsRegion": "us-east-1",
  "sourceIPAddress": "203.0.113.25",
  "userAgent": "aws-cli/1.15.61 Python/2.7.10 Darwin/16.7.0 botocore/1.10.60",
  "requestParameters": null,
  "responseElements": null,
  "eventID": "a1b2c3d4-EXAMPLE",
  "readOnly": false,
  "resources": [
    {
      "ARN": "arn:aws:ec2:us-east-1:123456789012:capacity-reservation/cr-12345678",
      "accountId": "123456789012",
      "type": "AWS::EC2::CapacityReservation"
    }
  ],
  "eventType": "AwsServiceEvent",
  "recipientAccountId": "123456789012",
  "serviceEventDetails": {
      "capacityReservationId": "cr-12345678",
      "capacityReservationState": "payment-failed"
      }
}
```

### CapacityBlockScheduled
<a name="understanding-capacity-blocks-entries-capacityblockscheduled"></a>

```
{
  "eventVersion": "1.05",
  "userIdentity": {
    "accountId": "123456789012",
    "invokedBy": "AWS Internal;"
  },
  "eventTime": "2023-10-02T00:06:08Z",
  "eventSource": "ec2.amazonaws.com",
  "eventName": "CapacityBlockScheduled",
  "awsRegion": "us-east-1",
  "sourceIPAddress": "203.0.113.25",
  "userAgent": "aws-cli/1.15.61 Python/2.7.10 Darwin/16.7.0 botocore/1.10.60",
  "requestParameters": null,
  "responseElements": null,
  "eventID": "a1b2c3d4-EXAMPLE",
  "readOnly": false,
  "resources": [
    {
      "ARN": "arn:aws:ec2:us-east-1:123456789012:capacity-reservation/cr-12345678",
      "accountId": "123456789012",
      "type": "AWS::EC2::CapacityReservation"
    }
  ],
  "eventType": "AwsServiceEvent",
  "recipientAccountId": "123456789012",
  "serviceEventDetails": {
      "capacityReservationId": "cr-12345678",
      "capacityReservationState": "scheduled"
      }
}
```

### CapacityBlockActive
<a name="understanding-capacity-blocks-entries-capacityblockactive"></a>

```
{
  "eventVersion": "1.05",
  "userIdentity": {
    "accountId": "123456789012",
    "invokedBy": "AWS Internal;"
  },
  "eventTime": "2023-10-02T00:06:08Z",
  "eventSource": "ec2.amazonaws.com",
  "eventName": "CapacityBlockActive",
  "awsRegion": "us-east-1",
  "sourceIPAddress": "203.0.113.25",
  "userAgent": "aws-cli/1.15.61 Python/2.7.10 Darwin/16.7.0 botocore/1.10.60",
  "requestParameters": null,
  "responseElements": null,
  "eventID": "a1b2c3d4-EXAMPLE",
  "readOnly": false,
  "resources": [
    {
      "ARN": "arn:aws:ec2:us-east-1:123456789012:capacity-reservation/cr-12345678",
      "accountId": "123456789012",
      "type": "AWS::EC2::CapacityReservation"
    }
  ],
  "eventType": "AwsServiceEvent",
  "recipientAccountId": "123456789012",
  "serviceEventDetails": {
      "capacityReservationId": "cr-12345678",
      "capacityReservationState": "active"
      }
 }
```

### CapacityBlockFailed
<a name="understanding-capacity-blocks-entries-capacityblockfailed"></a>

```
{
  "eventVersion": "1.05",
  "userIdentity": {
    "accountId": "123456789012",
    "invokedBy": "AWS Internal;"
  },
  "eventTime": "2023-10-02T00:06:08Z",
  "eventSource": "ec2.amazonaws.com",
  "eventName": "CapacityBlockFailed",
  "awsRegion": "us-east-1",
  "sourceIPAddress": "203.0.113.25",
  "userAgent": "aws-cli/1.15.61 Python/2.7.10 Darwin/16.7.0 botocore/1.10.60",
  "requestParameters": null,
  "responseElements": null,
  "eventID": "a1b2c3d4-EXAMPLE",
  "readOnly": false,
  "resources": [
    {
      "ARN": "arn:aws:ec2:us-east-1:123456789012:capacity-reservation/cr-12345678",
      "accountId": "123456789012",
      "type": "AWS::EC2::CapacityReservation"
    }
  ],
  "eventType": "AwsServiceEvent",
  "recipientAccountId": "123456789012",
  "serviceEventDetails": {
      "capacityReservationId": "cr-12345678",
      "capacityReservationState": "failed"
      }
 }
```

### CapacityBlockExpired
<a name="understanding-capacity-blocks-entries-capacityblockexpired"></a>

```
{
  "eventVersion": "1.05",
  "userIdentity": {
    "accountId": "123456789012",
    "invokedBy": "AWS Internal;"
  },
  "eventTime": "2023-10-02T00:06:08Z",
  "eventSource": "ec2.amazonaws.com",
  "eventName": "CapacityBlockExpired",
  "awsRegion": "us-east-1",
  "sourceIPAddress": "203.0.113.25",
  "userAgent": "aws-cli/1.15.61 Python/2.7.10 Darwin/16.7.0 botocore/1.10.60",
  "requestParameters": null,
  "responseElements": null,
  "eventID": "a1b2c3d4-EXAMPLE",
  "readOnly": false,
  "resources": [
    {
      "ARN": "arn:aws:ec2:us-east-1:123456789012:capacity-reservation/cr-12345678",
      "accountId": "123456789012",
      "type": "AWS::EC2::CapacityReservation"
    }
  ],
  "eventType": "AwsServiceEvent",
  "recipientAccountId": "123456789012",
  "serviceEventDetails": {
      "capacityReservationId": "cr-12345678",
      "capacityReservationState": "expired"
      }
 }
```