

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.

# Administración de productos aprovisionados
<a name="provisioned-products"></a>

AWS Service Catalog proporciona una interfaz para gestionar los productos aprovisionados. Puede consultar, actualizar y terminar todos los productos aprovisionados del catálogo en función del nivel de acceso. Consulte las secciones siguientes para obtener ejemplos de procedimientos.

**Topics**
+ [Administración de los productos aprovisionados como administrador](provisioned-products-admin.md)
+ [Cambio del propietario del producto aprovisionado](change-pp-owner.md)
+ [Actualizar plantillas para productos aprovisionados](pp-templates.md)
+ [Tutorial: Identificación de la asignación de recursos del usuario](provisioned-products-tutorial.md)
+ [Gestión de los errores de estado del producto de Terraform Open Source](provisioned-products-lifecycle.md)
+ [Administrar el archivo de estado del producto de Terraform Open Source](getstarted-terraform-engine-state.md)

# Administración de los productos aprovisionados como administrador
<a name="provisioned-products-admin"></a>

 Para administrar todos los productos aprovisionados de la cuenta, se requieren permisos de acceso `AWSServiceCatalogAdminFullAccess` o de nivel equivalente de IAM para las operaciones de escritura del producto aprovisionado. Para obtener más información, consulte [Identity and Access Management en AWS Service Catalog](controlling_access.md). 

**sugerencia**  
 Para el encadenamiento estático de productos aprovisionados, debe hacer referencia a los resultados de los productos aprovisionados en una plantilla de producto-artefacto antes de aprovisionar el producto aprovisionado. Para obtener más información, incluyendo ejemplos, consulte lo siguiente:   
 [AWS::ServiceCatalog::CloudFormationProvisionedProduct](https://amazonaws.com/AWSCloudFormation/latest/UserGuide/aws-resource-servicecatalog-cloudformationprovisionedproduct.html#aws-resource-servicecatalog-cloudformationprovisionedproduct--examples) en la *Guía del usuario de AWS CloudFormation *. 
 [DescribeProvisioningParameters (ProvisioningArtifactOutputKeys)](https://amazonaws.com/servicecatalog/latest/dg/API_DescribeProvisioningParameters.html#API_DescribeProvisioningParameters_ResponseElements) en la *Guía AWS Service Catalog para desarrolladores*. 

**Cómo consultar y administrar todos los productos aprovisionados**

1. Abra la AWS Service Catalog consola en [https://console.aws.amazon.com/servicecatalog/](https://console.aws.amazon.com/servicecatalog/).

   Si ya ha iniciado sesión en la AWS Service Catalog consola, seleccione **Service Catalog** y, a continuación, **Usuario final**.

1. Si es preciso, vaya a la sección **Productos aprovisionados**. 

1. En la sección **Productos aprovisionados**, seleccione la lista **Ver:** y seleccione el nivel de acceso que desee ver: **Usuario**, **Rol** o **Cuenta**. Se mostrarán todos los productos aprovisionados del catálogo.

1. Elija un producto aprovisionado que desee consultar, actualizar o terminar. Para obtener más información acerca de la información facilitada en esta vista, consulte [Visualización de información sobre productos aprovisionados](https://docs.aws.amazon.com/servicecatalog/latest/userguide/enduser-viewstack.html).

# Cambio del propietario del producto aprovisionado
<a name="change-pp-owner"></a>

 Puede cambiar el propietario de un producto aprovisionado en cualquier momento. Debe conocer el ARN del usuario o rol que desea establecer como nuevo propietario. 

 De forma predeterminada, esta característica está disponible para los administradores que utilizan la política administrada `AWSServiceCatalogAdminFullAccess`. Puede habilitarlo para los usuarios finales concediéndoles el `servicecatalog:UpdateProvisionedProductProperties` permiso de acceso AWS Identity and Access Management (IAM). 

**Cómo cambiar el propietario de un producto aprovisionado**

1.  En la AWS Service Catalog consola, selecciona la lista de **productos aprovisionados**. 

1. Localice el producto aprovisionado que desea actualizar, elija los tres puntos que hay junto a él y seleccione **Cambiar el propietario del producto aprovisionado**.También puede encontrar la opción **Change owner (Cambiar propietario)** en la página de detalles del producto aprovisionado, en el menú **Actions (Acciones)**. 

1.  En el cuadro de diálogo, escriba el ARN del usuario o rol que desea establecer como nuevo propietario. Un ARN comienza por `arn:` e incluye otra información separada por dos puntos o barras diagonales, por ejemplo, `arn:aws:iam::123456789012:user/NewOwner`. 

1.  Seleccione **Enviar**. Verá un mensaje de realización correcta cuando se haya actualizado el propietario. 

## Véase también
<a name="change-pp-owner-see-also"></a>
+  [UpdateProvisionedProductProperties](https://docs.aws.amazon.com/servicecatalog/latest/dg/API_UpdateProvisionedProductProperties.html) 

# Actualizar plantillas para productos aprovisionados
<a name="pp-templates"></a>

Puede cambiar la plantilla actual de un producto aprovisionado a una plantilla diferente. Por ejemplo, si tiene un producto de EC2 en Service Catalog, puede actualizar ese producto de EC2 para retener el mismo ID de producto aprovisionado, pero cambiar la plantilla por un bucket de S3.

**nota**  
La actualización de plantillas no es compatible con los productos Terraform Open Source o Terraform Cloud aprovisionados. Si desea utilizar una plantilla diferente para un producto de Terraform existente, debe eliminar el producto y, a continuación, crear un nuevo producto con la plantilla deseada. 

**Cómo actualizar un producto aprovisionado**

1. Elija **Productos aprovisionados** en el menú de navegación de la izquierda.

1. En **Productos aprovisionados**, seleccione un producto aprovisionado y seleccione **Acciones**, **Actualizar**.

   Tenga en cuenta que también puede seleccionar **Acciones** y **Actualizar** en la página **Detalles del producto aprovisionado**.

1. (Opcional) En **Detalles del producto**, seleccione **Cambiar producto**.

   En **Cambiar producto**, tenga en cuenta esta advertencia:

   *Al cambiar el producto se actualizará el producto aprovisionado a una plantilla de producto diferente. Esto puede finalizar con los recursos y crear nuevos recursos.*

   Puede actualizar un producto aprovisionado a una versión diferente dentro del mismo producto.

1. (Opcional) En **Productos**, seleccione el producto que desea actualizar con una plantilla diferente. A continuación, seleccione **Cambiar**.

   En **Detalles del producto**, tenga en cuenta esta advertencia:

   *[Nombre del producto] se actualizará de [nombre de la plantilla actual] a [nombre de la nueva plantilla]. Sin embargo, el nombre del producto aprovisionado, [nombre del producto aprovisionado], no cambiará.*

   Puede actualizar un producto aprovisionado a una versión diferente dentro del mismo producto.

1. En **Versiones del producto**, seleccione la versión del producto que desee.

1. En **Parámetros**, seleccione los parámetros adecuados.

1. Elija **Actualizar**.

   En **Detalles del producto aprovisionado**, puede ver los detalles de la actualización. El nombre del producto aprovisionado no cambia, pero el producto aprovisionado ahora tiene una plantilla diferente.

# Tutorial: Identificación de la asignación de recursos del usuario
<a name="provisioned-products-tutorial"></a>

Puede identificar al usuario que aprovisionó un producto y los recursos asociados al producto mediante la AWS Service Catalog consola. Este tutorial le ayuda a adaptar este ejemplo a sus propios productos aprovisionados. 

Para administrar todos los productos aprovisionados de la cuenta, se requiere acceso `AWSServiceCatalogAdminFullAccess` o de nivel equivalente a las operaciones de escritura del producto aprovisionado. Para obtener más información, consulte [Administración de identidades y accesos](https://docs.aws.amazon.com/servicecatalog/latest/adminguide/controlling_access.html) en la *Guía del administrador de AWS Service Catalog *.

**Cómo identificar al usuario que ha aprovisionado un producto y los recursos asociados**

1. Abra [https://console.aws.amazon.com/servicecatalog](https://console.aws.amazon.com/servicecatalog).

1. Elija **Productos aprovisionados** en el menú de navegación de la izquierda.

1. En el menú desplegable del **Filtro de acceso**, seleccione **Cuenta**.  
![\[Provisioned products interface with search bar, access filter dropdown, and table columns.\]](http://docs.aws.amazon.com/es_es/servicecatalog/latest/adminguide/images/access-filter-dropdown.png)

1. En la vista de la **Cuenta**, seleccione y abra un producto aprovisionado para ver sus detalles.  
![\[Provisioned products table showing one S3 bucket product with its creation date and status.\]](http://docs.aws.amazon.com/es_es/servicecatalog/latest/adminguide/images/account-view.png)

   Puede ver los detalles del producto aprovisionado.

     
![\[Provisioned product details page showing status, ID, name, creation date, and other information.\]](http://docs.aws.amazon.com/es_es/servicecatalog/latest/adminguide/images/details-pp.png)

1. Desplácese hacia abajo en la sección **Eventos**. Tenga en cuenta los valores de `Provisioned product ID` y `CloudformationStackARN`.  
![\[Events section showing UPDATE_PROVISIONED_PRODUCT with CloudFormationStackARN details.\]](http://docs.aws.amazon.com/es_es/servicecatalog/latest/adminguide/images/events-container.png)

1. Utilice el ID de producto aprovisionado para identificar el AWS CloudTrail registro que corresponde a este lanzamiento e identificar al usuario solicitante (normalmente, se introduce una dirección de correo electrónico durante la federación). En este ejemplo, es "steve".

   ```
   {
     "eventVersion":"1.03","userIdentity":
     {
       "type":"AssumedRole",
       "principalId":"[id]:steve",
       "arn":"arn:aws:sts::[account number]:assumed-role/SC-usertest/steve",
       "accountId":[account number],
       "accessKeyId":[access key],
       "sessionContext":
       {
         "attributes":
         {
           "mfaAuthenticated":[boolean],
           "creationDate":[timestamp]
         },
         "sessionIssuer":
         {
           "type":"Role",
           "principalId":"AROAJEXAMPLELH3QXY",
           "arn":"arn:aws:iam::[account number]:role/[name]",
           "accountId":[account number],
           "userName":[username]
         }
       }
     },
     "eventTime":"2016-08-17T19:20:58Z","eventSource":"servicecatalog.amazonaws.com",
     "eventName":"ProvisionProduct",
     "awsRegion":"us-west-2",
     "sourceIPAddress":[ip address],
     "userAgent":"Coral/Netty",
     "requestParameters":
     {
       "provisioningArtifactId":[id],
       "productId":[id],
       "provisioningParameters":[Shows all the parameters that the end user entered],
       "provisionToken":[token],
       "pathId":[id],
       "provisionedProductName":[name],
       "tags":[],
       "notificationArns":[]
     },
     "responseElements":
     {
       "recordDetail":
       {
         "provisioningArtifactId":[id],
         "status":"IN_PROGRESS",
         "recordId":[id],
         "createdTime":"Aug 17, 2016 7:20:58 PM",
         "recordTags":[],
         "recordType":"PROVISION_PRODUCT",
         "provisionedProductType":"CFN_STACK",
         "pathId":[id],
         "productId":[id],
         "provisionedProductName":"testSCproduct",
         "recordErrors":[],
         "provisionedProductId":[id]
       }
     },
     "requestID":[id],
     "eventID":[id],
     "eventType":"AwsApiCall",
     "recipientAccountId":[account number]
   }
   ```

1. Utilice el `CloudformationStackARN` valor para identificar CloudFormation los eventos y buscar información sobre los recursos creados. También puede usar la CloudFormation API para obtener esta información. Para obtener más información, consulte [Referencia de la API de AWS CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/).

Puede realizar los pasos 1 a 4 mediante la AWS Service Catalog API o el AWS CLI. Para obtener más información, consulte la [Guía para desarrolladores de AWS Service Catalog](https://docs.aws.amazon.com/servicecatalog/latest/dg/what-is-service-catalog.html) y la [Referencia de la línea de comandos de AWS Service Catalog .](https://docs.aws.amazon.com/cli/latest/reference/servicecatalog/)

# Gestión de los errores de estado del producto de Terraform Open Source
<a name="provisioned-products-lifecycle"></a>

Los errores `ProvisionProduct` de Terraform Open Source se envían al estado `TAINTED`, lo que permite que cada producto aprovisionado siga a `UpdateProvisionedProduct`. Cuando esto ocurre:
+ `UpdateProvisionedProduct` **no** intenta actualizar o corregir las etiquetas, ni crear o modificar un grupo de recursos.
+ `UpdateProvisionedProduct` **no** tiene en cuenta los errores de operaciones de aprovisionamiento anteriores a la hora de decidir si el producto aprovisionado debe configurarse en `AVAILABLE` o `TAINTED`. 

AWS Service Catalog solo aplica etiquetas durante`ProvisionProduct`. Cualquier error de etiquetado que se deba a un error en la operación `ProvisionProduct` **no** se resuelve automáticamente. 

## Ejemplos de errores de estado
<a name="provisioned-products-lifecycle-errors"></a>

**Ejemplo 1: AWS Service Catalog no crea un grupo de recursos durante** `ProvisionProduct`

En el siguiente escenario, tiene un producto aprovisionado en el estado `AVAILABLE` aunque no haya un grupo de recursos de apoyo y sin ninguna etiqueta aplicada a los recursos. 

1. Se inicia la acción `ProvisionProduct`. 

1. El motor de aprovisionamiento de Terraform responde a `ProvisionProduct` con una falla en el flujo de trabajo y no proporciona una `ResourceIdentifier`. 

1. El flujo de trabajo `ProvisionProduct` no crea un grupo de recursos y, a continuación, establece el estado del producto aprovisionado en `ERROR`. 

1. A continuación, inicie la operación `UpdateProvisionedproduct`. 

1. El motor de aprovisionamiento de Terraform responde indicando que se ha realizado correctamente. 

1. Como resultado, el flujo de trabajo `UpdateprovisionedProduct` establece el estado del producto aprovisionado en `AVAILABLE`, pero **no** crea un grupo de recursos ni intenta aplicar ninguna etiqueta. 

**Ejemplo 2: AWS Service Catalog crea nuevos recursos durante** `UpdateProvisionedProduct`

En el siguiente escenario, tiene un producto aprovisionado en el estado `AVAILABLE` aunque a los nuevos recursos **no** se les haya aplicado ninguna etiqueta.

1. Se inicia la acción `ProvisionProduct`. 

1. El motor de aprovisionamiento de Terraform responde indicando que se ha realizado correctamente y proporciona `ResourceIdentifier`. 

1. El flujo de trabajo `ProvisionProduct` crea un grupo de recursos y aplica etiquetas a todos los recursos identificados. 

1. Se inicia `UpdateProvisionedProduct` con un artefacto nuevo que crea nuevos recursos. 

1. El motor de aprovisionamiento de Terraform responde indicando que se ha realizado correctamente. 

1. El flujo de trabajo `UpdateProvisionedProduct` establece el estado del producto aprovisionado en los nuevos recursos en `AVAILABLE` pero **no** intenta aplicarles etiquetas adicionales. 

### Solución de error de estado
<a name="provisioned-products-lifecycle-solutions"></a>

AWS Service Catalog garantiza que se cree un grupo de recursos para todos los productos aprovisionados establecidos a `TAINTED` partir de`ProvisionProduct`. Si el motor de aprovisionamiento de Terraform no devuelve un `ResourceIdentifier` grupo de recursos o AWS Service Catalog no lo crea, el producto aprovisionado se establece en ese `ERROR` estado, lo que le obliga a cancelarlo.

# Administrar el archivo de estado del producto de Terraform Open Source
<a name="getstarted-terraform-engine-state"></a>

Cada producto aprovisionado por Terraform Open Source tiene un **archivo de estado único**. Existe una relación 1:1 entre el producto aprovisionado y su archivo de estado. Los archivos se almacenan en un bucket de Amazon S3 denominado `sc-terraform-engine-state-${AWS::AccountId}-${AWS::Region}`. El archivo de estado se guarda con la clave de objeto `AccountID` o `ProvisionedProductID`. 

El acceso a los archivos estatales está limitado a las `GetStateFile` AWS Lambda plantillas de lanzamiento y a Amazon EC2. AWS Service Catalog los administradores **no** tienen acceso directo a los archivos de estado de Amazon S3. Los administradores deben acceder a los archivos mediante Amazon EC2. De forma predeterminada, AWS Service Catalog los administradores pueden ver la lista de archivos de estado, pero no pueden leer ni escribir el contenido de los archivos. Solo el motor de aprovisionamiento de Terraform puede leer o escribir el contenido del archivo. 