

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Gestion des produits provisionnés
<a name="provisioned-products"></a>

AWS Service Catalog fournit une interface pour gérer les produits approvisionnés. Vous pouvez afficher, mettre à jour et mettre fin à tous les produits provisionnés pour votre catalogue selon le niveau d'accès. Vous trouverez dans les sections suivantes des exemples de procédures.

**Topics**
+ [Gérer les produits provisionnés en tant qu'administrateur](provisioned-products-admin.md)
+ [Modification du propriétaire du produit provisionné](change-pp-owner.md)
+ [Mise à jour des modèles pour les produits approvisionnés](pp-templates.md)
+ [Didacticiel : Identification de l'utilisateur pour l'allocation des ressources](provisioned-products-tutorial.md)
+ [Gestion des erreurs d'état des produits Terraform Open Source](provisioned-products-lifecycle.md)
+ [Gestion du fichier d'état du produit Terraform Open Source](getstarted-terraform-engine-state.md)

# Gérer les produits provisionnés en tant qu'administrateur
<a name="provisioned-products-admin"></a>

 Pour gérer tous les produits fournis pour un compte, vous devez disposer d'une autorisation IAM `AWSServiceCatalogAdminFullAccess` ou d'une autorisation IAM équivalente pour accéder aux opérations d'écriture des produits fournis. Pour de plus amples informations, veuillez consulter [Identity and Access Management dans AWS Service Catalog](controlling_access.md). 

**Astuce**  
 Pour le chaînage statique des produits approvisionnés, vous devez référencer les sorties des produits fournis dans un modèle d'artefact de produit avant que le produit fourni ne soit approvisionné. Pour plus d'informations, y compris un exemple, consultez ce qui suit :   
 [AWS::ServiceCatalog::CloudFormationProvisionedProduct](https://amazonaws.com/AWSCloudFormation/latest/UserGuide/aws-resource-servicecatalog-cloudformationprovisionedproduct.html#aws-resource-servicecatalog-cloudformationprovisionedproduct--examples) dans le *guide de l'utilisateur AWS CloudFormation *. 
 [DescribeProvisioningParameters (ProvisioningArtifactOutputKeys)](https://amazonaws.com/servicecatalog/latest/dg/API_DescribeProvisioningParameters.html#API_DescribeProvisioningParameters_ResponseElements) dans le *Guide du AWS Service Catalog développeur*. 

**Pour afficher et gérer tous les produits provisionnés**

1. Ouvrez la AWS Service Catalog console à l'adresse [https://console.aws.amazon.com/servicecatalog/](https://console.aws.amazon.com/servicecatalog/).

   Si vous êtes déjà connecté à la AWS Service Catalog console, choisissez **Service Catalog**, puis **Utilisateur final**.

1. Si nécessaire, faites défiler la page vers le bas jusqu'à la section **Produits approvisionnés**. 

1. Dans la **section Produits fournis**, choisissez la liste **Afficher :** et sélectionnez le niveau d'accès que vous souhaitez voir : **utilisateur**, **rôle** ou **compte**. Cette action affiche tous les produits approvisionnés dans le catalogue.

1. Choisissez un produit provisionné à afficher, mettre à jour ou résilier. Pour plus d'informations sur les détails fournis dans cette vue, consultez [Affichage d'informations sur les produits provisionnés](https://docs.aws.amazon.com/servicecatalog/latest/userguide/enduser-viewstack.html).

# Modification du propriétaire du produit provisionné
<a name="change-pp-owner"></a>

 Vous pouvez changer le propriétaire d'un produit provisionné à tout moment. Vous devez connaître l'ARN de l'utilisateur ou du rôle que vous souhaitez définir en tant que nouveau propriétaire. 

 Par défaut, cette fonctionnalité est disponible pour les administrateurs utilisant la politique `AWSServiceCatalogAdminFullAccess` gérée. Vous pouvez l'activer pour les utilisateurs finaux en leur accordant l'`servicecatalog:UpdateProvisionedProductProperties`autorisation dans Gestion des identités et des accès AWS (IAM). 

**Modifier le propriétaire d'un produit provisionné**

1.  Dans la AWS Service Catalog console, choisissez **Provisioned products list**. 

1. Localisez le produit approvisionné que vous souhaitez mettre à jour, puis choisissez les trois points situés à côté de celui-ci et choisissez **Modifier le propriétaire du produit provisionné**.Vous pouvez également accéder à l'option **Change owner (Modifier le propriétaire)** sur la page détaillée du produit provisionné, dans le menu **Actions**. 

1.  Dans la boîte de dialogue, saisissez l'ARN de l'utilisateur ou du rôle que vous souhaitez définir en tant que nouveau propriétaire. Un ARN commence par `arn:` et inclut d'autres informations séparées par des deux-points ou des barres obliques, par exemple `arn:aws:iam::123456789012:user/NewOwner`. 

1.  Sélectionnez **Soumettre**. Un message de succès de l’opération s'affiche lorsque le propriétaire a été mis à jour. 

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

# Mise à jour des modèles pour les produits approvisionnés
<a name="pp-templates"></a>

Vous pouvez remplacer le modèle actuel d'un produit approvisionné par un autre modèle. Par exemple, si vous avez un produit EC2 dans Service Catalog, vous pouvez mettre à jour ce produit EC2 pour conserver le même identifiant de produit fourni, mais remplacer le modèle par un compartiment S3.

**Note**  
La mise à jour des modèles n'est pas prise en charge pour les produits Terraform Open Source ou Terraform Cloud provisionnés. Si vous souhaitez utiliser un modèle différent pour un produit Terraform existant, vous devez supprimer le produit, puis créer un nouveau produit à l'aide du modèle souhaité. 

**Pour mettre à jour un modèle pour un produit approvisionné**

1. Dans le menu de navigation de gauche, choisissez **Provisioned products**.

1. **Dans **Produits provisionnés**, choisissez un produit provisionné et sélectionnez **Actions**, Mettre à jour.**

   Notez que vous pouvez également sélectionner **Actions**, **Mettre à jour** sur la page de **détails du produit provisionné**.

1. (Facultatif) Dans **Détails du produit**, sélectionnez **Modifier le produit**.

   Dans **Changer de produit**, notez cet avertissement :

   *La modification du produit mettra à jour ce produit approvisionné vers un autre modèle de produit. Cela peut mettre fin à des ressources et en créer de nouvelles.*

   Vous pouvez mettre à jour un produit approvisionné vers une version différente au sein du même produit.

1. (Facultatif) Dans **Produits**, choisissez le produit que vous souhaitez mettre à jour avec un autre modèle. Choisissez ensuite **Modifier**.

   Dans **Détails du produit**, notez cet avertissement :

   *[Nom du produit] sera mis à jour de [nom du modèle actuel] à [nouveau nom du modèle]. Toutefois, le nom de votre produit approvisionné, [Nom du produit approvisionné], ne changera pas.*

   Vous pouvez mettre à jour un produit approvisionné vers une version différente au sein du même produit.

1. Dans **Versions du produit**, choisissez la version du produit que vous souhaitez.

1. Dans **Paramètres**, sélectionnez les paramètres appropriés.

1. Choisissez **Mettre à jour**.

   Dans **Détails du produit provisionné**, vous pouvez consulter les détails de la mise à jour. Le nom du produit provisionné ne change pas, mais le produit provisionné possède désormais un modèle différent.

# Didacticiel : Identification de l'utilisateur pour l'allocation des ressources
<a name="provisioned-products-tutorial"></a>

Vous pouvez identifier l'utilisateur qui a approvisionné un produit et les ressources associées à ce produit à l'aide de la AWS Service Catalog console. Ce didacticiel vous aide à adapter cet exemple à vos propres produits provisionnés spécifiques. 

Pour gérer tous les produits provisionnés pour le compte, vous avez besoin de l'accès `AWSServiceCatalogAdminFullAccess` ou d'un accès équivalent aux opérations d'écriture sur les produits provisionnés. Pour plus d'informations, consultez [Identity and Access Management](https://docs.aws.amazon.com/servicecatalog/latest/adminguide/controlling_access.html) dans le *Guide de AWS Service Catalog l'administrateur.*

**Pour identifier l'utilisateur qui a provisionné un produit et les ressources associées**

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

1. Dans le menu de navigation de gauche, choisissez **Provisioned product**.

1. Dans le menu déroulant du **filtre d'accès**, sélectionnez **Compte**.  
![\[Provisioned products interface with search bar, access filter dropdown, and table columns.\]](http://docs.aws.amazon.com/fr_fr/servicecatalog/latest/adminguide/images/access-filter-dropdown.png)

1. Dans la vue **Compte**, choisissez et ouvrez un produit approvisionné pour en afficher les détails.  
![\[Provisioned products table showing one S3 bucket product with its creation date and status.\]](http://docs.aws.amazon.com/fr_fr/servicecatalog/latest/adminguide/images/account-view.png)

   Vous pouvez consulter les détails du produit approvisionné.

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

1. Faites défiler la page vers le bas pour développer la section **Événements**. Notez les `CloudformationStackARN` valeurs `Provisioned product ID` et.  
![\[Events section showing UPDATE_PROVISIONED_PRODUCT with CloudFormationStackARN details.\]](http://docs.aws.amazon.com/fr_fr/servicecatalog/latest/adminguide/images/events-container.png)

1. Utilisez l'ID de produit fourni pour identifier l' AWS CloudTrail enregistrement correspondant à ce lancement et identifier l'utilisateur demandeur (généralement, vous entrez une adresse e-mail lors de la fédération). Dans cet exemple, il s'agit de « 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. Utilisez la `CloudformationStackARN` valeur pour identifier les CloudFormation événements afin de trouver des informations sur les ressources créées. Vous pouvez également utiliser l' CloudFormation API pour obtenir ces informations. Pour plus d’informations, veuillez consulter [AWS CloudFormation Référence d'API ](https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/).

Vous pouvez effectuer les étapes 1 à 4 à l'aide de l' AWS Service Catalog API ou du AWS CLI. Pour plus d'informations, consultez le [guide AWS Service Catalog du développeur.](https://docs.aws.amazon.com/servicecatalog/latest/dg/what-is-service-catalog.html) et [référence AWS Service Catalog de ligne de commande.](https://docs.aws.amazon.com/cli/latest/reference/servicecatalog/)

# Gestion des erreurs d'état des produits Terraform Open Source
<a name="provisioned-products-lifecycle"></a>

Les `ProvisionProduct` défaillances de Terraform Open Source sont renvoyées vers l'`TAINTED`État, ce qui permet à chaque produit provisionné de passer à autre chose. `UpdateProvisionedProduct` Lorsque cela se produit :
+ `UpdateProvisionedProduct`ne tente **pas** de mettre à jour ou de corriger les balises, ni de créer ou de modifier un groupe de ressources.
+ `UpdateProvisionedProduct`ne prend **pas** en compte les échecs liés aux opérations de provisionnement précédentes lorsqu'il décide si le produit provisionné doit être configuré sur ou. `AVAILABLE` `TAINTED` 

AWS Service Catalog n'applique les tags que pendant`ProvisionProduct`. Tout échec de balisage résultant d'un échec de l'`ProvisionProduct`opération n'est **pas** automatiquement résolu. 

## Exemples d'erreurs de statut
<a name="provisioned-products-lifecycle-errors"></a>

**Exemple 1 : AWS Service Catalog ne crée pas de groupe de ressources pendant** `ProvisionProduct`

Dans le scénario ci-dessous, vous disposez d'un produit provisionné dans l'`AVAILABLE`état même s'il n'existe pas de groupe de ressources de support, et aucune balise n'est appliquée aux ressources. 

1. Votre action démarre. `ProvisionProduct` 

1. Le moteur de provisionnement Terraform répond à une défaillance du flux `ProvisionProduct` de travail et ne fournit pas de. `ResourceIdentifier` 

1. Le `ProvisionProduct` flux de travail ne crée pas de groupe de ressources, puis définit l'état du produit provisionné sur`ERROR`. 

1. Vous lancez ensuite l'`UpdateProvisionedproduct`opération. 

1. Le moteur de provisionnement Terraform répond en indiquant « succès ». 

1. Par conséquent, le `UpdateprovisionedProduct` flux de travail définit l'état du produit provisionné sur`AVAILABLE`, mais ne crée **pas** de groupe de ressources et ne tente pas d'appliquer de balises. 

**Exemple 2 : AWS Service Catalog crée de nouvelles ressources pendant** `UpdateProvisionedProduct`

Dans le scénario ci-dessous, vous avez un produit provisionné dans l'`AVAILABLE`état même si aucune balise **n'est** appliquée aux nouvelles ressources.

1. Votre action démarre. `ProvisionProduct` 

1. Le moteur de provisionnement Terraform répond en indiquant le « succès » et fournit un. `ResourceIdentifier` 

1. Le `ProvisionProduct` flux de travail crée un groupe de ressources et applique des balises à toutes les ressources identifiées. 

1. Vous lancez `UpdateProvisionedProduct` un nouvel artefact qui crée de nouvelles ressources. 

1. Le moteur de provisionnement Terraform répond en indiquant « succès ». 

1. Le `UpdateProvisionedProduct` flux de travail définit l'état du produit provisionné sur `AVAILABLE` mais **ne tente pas** d'appliquer de balises supplémentaires aux nouvelles ressources. 

### Solution d'erreur d'état
<a name="provisioned-products-lifecycle-solutions"></a>

AWS Service Catalog garantit qu'un groupe de ressources est créé pour tous les produits provisionnés définis à `TAINTED` partir de`ProvisionProduct`. Si le moteur de provisionnement Terraform ne renvoie pas de groupe de ressources`ResourceIdentifier`, ou s'il AWS Service Catalog ne parvient pas à créer de groupe de ressources, le produit provisionné est défini sur l'`ERROR`état, ce qui vous oblige à le résilier.

# Gestion du fichier d'état du produit Terraform Open Source
<a name="getstarted-terraform-engine-state"></a>

**Chaque produit Terraform Open Source provisionné possède un fichier à état unique.** Il existe une relation 1:1 entre le produit provisionné et son fichier d'état. Les fichiers sont stockés dans un compartiment Amazon S3 nommé`sc-terraform-engine-state-${AWS::AccountId}-${AWS::Region}`. Le fichier d'état est enregistré sous la clé `ProvisionedProductID` d'objet `AccountID` ou. 

L'accès aux fichiers d'état est limité aux modèles de lancement Amazon EC2 `GetStateFile` AWS Lambda et à ceux d'Amazon EC2. AWS Service Catalog les administrateurs n'ont **pas** d'accès direct aux fichiers d'état dans Amazon S3. Les administrateurs doivent accéder aux fichiers à l'aide d'Amazon EC2. Par défaut, AWS Service Catalog les administrateurs peuvent voir la liste des fichiers d'état, mais ne peuvent ni lire ni écrire le contenu des fichiers. Seul le moteur de provisionnement Terraform peut lire ou écrire le contenu du fichier. 