Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# S3 Storage \| Actualización
Modifique las propiedades de un bucket de S3 creado con el ID de tipo de cambio ct-1a68ck03fn98r.
**Clasificación completa:** Administración \| Componentes de pila avanzados \| Almacenamiento en S3 \| Actualización
## Detalles del tipo de cambio
****
| | |
| --- |--- |
| ID de tipo de cambio | ct-1gi93jhvj28eg |
| Versión actual | 5.0 |
| Duración de ejecución prevista | 60 minutos |
| Aprobación de AWS | Obligatorio |
| Aprobación del cliente | No obligatorio |
| Modo de ejecución | Automatizado |
## Información adicional
### Actualice el almacenamiento de S3
#### Actualización de un S3 con la consola
Captura de pantalla de este tipo de cambio en la consola AMS:
Funcionamiento:
1. Vaya a la página **Crear RFC**: en el panel de navegación izquierdo de la consola AMS, haga clic **RFCs**para abrir la página de RFCs lista y, a continuación, haga clic en **Crear RFC**.
1. Elija un tipo de cambio (CT) popular en la vista predeterminada **de búsqueda de tipos de cambios** o seleccione un CT en la vista **Elegir por categoría**.
+ **Busque por tipo de cambio**: puede hacer clic en un CT popular en el área de **creación rápida** para abrir inmediatamente la página **Ejecutar RFC**. Tenga en cuenta que no puede elegir una versión antigua de CT con Quick Create.
Para ordenar CTs, utilice el área **Todos los tipos de cambios** en la vista **de tarjeta** o de **tabla**. En cualquiera de las vistas, seleccione una CT y, a continuación, haga clic en **Crear RFC** para abrir la página **Ejecutar RFC**. Si corresponde, aparece la opción **Crear con una versión anterior** junto al botón **Crear RFC**.
+ **Elegir por categoría**: seleccione una categoría, una subcategoría, un elemento y una operación, y se abrirá el cuadro de detalles del CT con la opción **Crear con una versión anterior, si corresponde**. Haga clic en **Crear RFC** para abrir la página **Ejecutar RFC**.
1. En la página **Ejecutar RFC**, abra el área del nombre del CT para ver el cuadro de detalles del CT. Se requiere un **asunto** (lo rellena automáticamente si elige su CT en la vista **Buscar tipos de cambios**). Abra el área **de configuración adicional** para añadir información sobre la RFC.
En el área de **configuración de ejecución**, utilice las listas desplegables disponibles o introduzca valores para los parámetros necesarios. Para configurar los parámetros de ejecución opcionales, abra el área **de configuración adicional**.
1. Cuando haya terminado, haga clic en **Ejecutar**. Si no hay errores, aparecerá la página de la **RFC creada correctamente** con los detalles de la RFC enviada y el resultado inicial de la **ejecución**.
1. Abra el área de **parámetros de ejecución** para ver las configuraciones que envió. Actualice la página para actualizar el estado de ejecución de la RFC. Si lo desea, cancele la RFC o cree una copia de la misma con las opciones de la parte superior de la página.
#### Actualización de un S3 con la CLI
Funcionamiento:
1. Utilice la función de creación en línea (se emite un `create-rfc` comando con todos los parámetros de ejecución y RFC incluidos) o la de plantilla (se crean dos archivos JSON, uno para los parámetros de RFC y otro para los parámetros de ejecución) y ejecute el `create-rfc` comando con los dos archivos como entrada. Ambos métodos se describen aquí.
1. Envíe el `aws amscm submit-rfc --rfc-id {{ID}}` comando RFC: con el ID de RFC devuelto.
Supervise el comando RFC:. `aws amscm get-rfc --rfc-id {{ID}}`
Para comprobar la versión del tipo de cambio, utilice este comando:
```
aws amscm list-change-type-version-summaries --filter Attribute=ChangeTypeId,Value={{CT_ID}}
```
**nota**
Puede utilizar cualquier `CreateRfc` parámetro con cualquier RFC, forme o no parte del esquema del tipo de cambio. Por ejemplo, para recibir notificaciones cuando cambie el estado de la RFC, añada esta línea `--notification "{\"Email\": {\"EmailRecipients\" : [\"email@example.com\"]}}"` a la parte de los parámetros de la RFC de la solicitud (no a los parámetros de ejecución). Para ver una lista de todos los CreateRfc parámetros, consulta la referencia de la [API de administración de cambios de AMS](https://docs.aws.amazon.com/managedservices/latest/ApiReference-cm/API_CreateRfc.html).
*CREACIÓN EN LÍNEA*:
Ejecute el comando create RFC con los parámetros de ejecución incluidos en línea (comillas de escape al proporcionar los parámetros de ejecución en línea) y, a continuación, envíe el ID de RFC devuelto. Por ejemplo, puedes reemplazar el contenido por algo como esto:
**Ejemplo con solo los parámetros necesarios:**
```
aws amscm create-rfc --title s3-bucket-update --change-type-id ct-1gi93jhvj28eg --change-type-version 5.0 --execution-parameters "{\"DocumentName\":\"AWSManagedServices-UpdateBucket\",\"Region\":\"{{us-east-1}}\",\"Parameters\":{\"BucketName\":\"{{mybucket}}\"}}"
```
**Ejemplo con todos los parámetros:**
```
aws amscm create-rfc --title s3-bucket-update --change-type-id ct-1gi93jhvj28eg --change-type-version 5.0 --execution-parameters "{\"DocumentName\":\"AWSManagedServices-UpdateBucket\",\"Region\":\"{{us-east-1}}\",\"Parameters\":{\"BucketName\":\"{{mybucket}}\",\"ServerSideEncryption\":\"KmsManagedKeys\",\"KMSKeyId\":\"{{arn:aws:kms:ap-southeast-2:123456789012:key/9d5948f1-2082-4c07-a183-eb829b8d81c4}}\",\"Versioning\":\"{{Enabled}}\",\"IAMPrincipalsRequiringReadObjectAccess\":[\"{{arn:aws:iam::123456789012:user/myuser}}\",\"{{arn:aws:iam::123456789012:role/myrole}}\"],\"IAMPrincipalsRequiringWriteObjectAccess\":[\"{{arn:aws:iam::123456789012:user/myuser}}\",\"{{arn:aws:iam::123456789012:role/myrole}}\"],\"ServicesRequiringReadObjectAccess\":[\"{{rds.amazonaws.com}}\",\"{{ec2.amazonaws.com}}\",\"{{logs.ap-southeast-2.amazonaws.com}}\"],\"ServicesRequiringWriteObjectAccess\":[\"{{rds.amazonaws.com}}\",\"{{ec2.amazonaws.com}}\",\"{{logs.ap-southeast-2.amazonaws.com}}\"],\"EnforceSecureTransport\":\"{{True}}\",\"AccessAllowedIpRanges\":[\"{{1.0.0.0/24}}\",\"{{2.0.0.0/24}}\"]}}"
```
*CREACIÓN DE PLANTILLA*:
1. Envía los parámetros de ejecución del esquema JSON para este tipo de cambio a un archivo; este ejemplo lo nombra UpdateBucketParams .json.
```
aws amscm get-change-type-version --change-type-id "ct-1gi93jhvj28eg" --query "ChangeTypeVersion.ExecutionInputSchema" --output text > UpdateBucketParams.json
```
1. Modifique y guarde el UpdateBucketParams archivo.
**Ejemplo con todos los parámetros (se debe especificar al menos un parámetro):**
```
{
"DocumentName" : "AWSManagedServices-UpdateBucket",
"Region": "us-east-1",
"Parameters": {
"BucketName": "mybucket",
"ServerSideEncryption": "KmsManagedKeys",
"KMSKeyId": "arn:aws:kms:ap-southeast-2:123456789012:key/9d5948f1-2082-4c07-a183-eb829b8d81c4",
"Versioning": "Enabled",
"IAMPrincipalsRequiringReadObjectAccess": [
"arn:aws:iam::123456789012:user/myuser",
"arn:aws:iam::123456789012:role/myrole"
],
"IAMPrincipalsRequiringWriteObjectAccess": [
"arn:aws:iam::123456789012:user/myuser",
"arn:aws:iam::123456789012:role/myrole"
],
"ServicesRequiringReadObjectAccess": [
"rds.amazonaws.com",
"ec2.amazonaws.com",
"logs.ap-southeast-2.amazonaws.com"
],
"ServicesRequiringWriteObjectAccess": [
"rds.amazonaws.com",
"ec2.amazonaws.com",
"logs.ap-southeast-2.amazonaws.com"
],
"EnforceSecureTransport": "True",
"AccessAllowedIpRanges": [
"1.0.0.0/24",
"2.0.0.0/24"
]
}
}
```
**Ejemplo con los parámetros obligatorios (debe especificarse al menos un parámetro):**
```
{
"DocumentName" : "AWSManagedServices-UpdateBucket",
"Region": "us-east-1",
"Parameters": {
"BucketName": "mybucket",
"IAMPrincipalsRequiringWriteObjectAccess": [
"arn:aws:iam::123456789012:role/roleA"
]
}
}
```
Para ver ejemplos de las políticas resultantes, consulte[Ejemplo de políticas resultantes de S3 Storage Bucket Create](deployment-advanced-s3-storage-create.md#ex-s3-create-policies).
1. Envía el archivo JSON de la plantilla RFC a un archivo denominado UpdateBucketRfc .json:
```
aws amscm create-rfc --generate-cli-skeleton > UpdateBucketRfc.json
```
1. Modifique y guarde el UpdateBucketRfc archivo.json. Por ejemplo, puedes reemplazar el contenido por algo como esto:
```
{
"ChangeTypeVersion": "{{5.0}}",
"ChangeTypeId": "ct-1gi93jhvj28eg",
"Title": "{{S3-Bucket-Update-RFC}}"
}
```
1. Cree el RFC, especificando el UpdateBucketRfc archivo y el UpdateBucketParams archivo:
```
aws amscm create-rfc --cli-input-json file://UpdateBucketRfc.json --execution-parameters file://UpdateBucketParams.json
```
Recibirá el ID de la nueva RFC en la respuesta y podrá utilizarla para enviar y supervisar la RFC. Hasta que la envíe, la RFC permanece en estado de edición y no se inicia.
1. Para ver el depósito de S3 o cargar objetos en él, consulte el resultado de la ejecución: utilice `stack_id` para ver el depósito en la CloudFormation consola y utilice el **S3 BucketName** para ver el depósito en la consola de Amazon S3.
#### Consejos
**nota**
Este tutorial describe y proporciona ejemplos de comandos para actualizar un depósito de almacenamiento de Amazon S3 que se creó con la versión 5.0 del tipo de cambio Create Storage de S3 (ct-1a68ck03fn98r). En esa versión de ese tipo de cambio, el **AccessControl**parámetro se eliminó y se sustituyó por parámetros específicos para permitir el acceso de lectura o escritura a determinados servicios o funciones de IAM.
Para obtener más información sobre Amazon S3, consulte la [Guía del usuario de Amazon Simple Storage Service](https://aws.amazon.com/documentation/s3/).
## Parámetros de entrada de ejecución
Para obtener información detallada sobre los parámetros de entrada de la ejecución, consulte[Esquema para el tipo de cambio ct-1gi93jhvj28eg](schemas.md#ct-1gi93jhvj28eg-schema-section).
## Ejemplo: Parámetros necesarios
```
{
"DocumentName" : "AWSManagedServices-UpdateBucket",
"Region": "us-east-1",
"Parameters": {
"BucketName": "mybucket"
}
}
```
## Ejemplo: todos los parámetros
```
{
"DocumentName" : "AWSManagedServices-UpdateBucket",
"Region": "us-east-1",
"Parameters": {
"BucketName": "mybucket",
"ServerSideEncryption": "KmsManagedKeys",
"KMSKeyId": "arn:aws:kms:ap-southeast-2:123456789012:key/9d5948f1-2082-4c07-a183-eb829b8d81c4",
"Versioning": "Enabled",
"IAMPrincipalsRequiringReadObjectAccess": [
"arn:aws:iam::123456789012:user/myuser",
"arn:aws:iam::123456789012:role/myrole"
],
"IAMPrincipalsRequiringWriteObjectAccess": [
"arn:aws:iam::123456789012:user/myuser",
"arn:aws:iam::123456789012:role/myrole"
],
"ServicesRequiringReadObjectAccess": [
"rds.amazonaws.com",
"ec2.amazonaws.com",
"logs.ap-southeast-2.amazonaws.com"
],
"ServicesRequiringWriteObjectAccess": [
"rds.amazonaws.com",
"ec2.amazonaws.com",
"logs.ap-southeast-2.amazonaws.com"
],
"EnforceSecureTransport": "True",
"AccessAllowedIpRanges": [
"1.0.0.0/24",
"2.0.0.0/24"
],
"Tags": [
"{\"Key\": \"foo\", \"Value\": \"bar\"}",
"{ \"Key\": \"testkey\",\"Value\": \"testvalue\" }"
]
}
}
```