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.

# AWS Service Catalog référence d'action de déploiement
<a name="action-reference-ServiceCatalog"></a>

Vous utilisez une AWS Service Catalog action pour déployer des modèles à l'aide de votre pipeline. Il s'agit de modèles de ressources que vous avez créés dans Service Catalog.

## Type d'action
<a name="action-reference-ServiceCatalog-type"></a>
+ Catégorie : `Deploy`
+ Propriétaire : `AWS`
+ Fournisseur : `ServiceCatalog`
+ Version : `1`

## Paramètres de configuration
<a name="action-reference-ServiceCatalog-config"></a>

**TemplateFilePath**  
Obligatoire : oui  
Le chemin de fichier de votre modèle de ressource dans votre emplacement source.

**ProductVersionName**  
Obligatoire : oui  
La version du produit dans Service Catalog.

**ProductType**  
Obligatoire : oui  
Type de produit dans Service Catalog.

**ProductId**  
Obligatoire : oui  
L'ID du produit dans Service Catalog.

**ProductVersionDescription**  
Obligatoire : non  
Description de la version du produit dans Service Catalog.

## Artefacts d'entrée
<a name="action-reference-ServiceCatalog-input"></a>
+ **Nombre d'objets :** `1`
+ **Description :** il s'agit de l'artefact d'entrée pour votre action.

## Artefacts de sortie
<a name="action-reference-ServiceCatalog-output"></a>
+ **Nombre d'objets :** `0` 
+ **Description :** les artefacts de sortie ne s'appliquent pas à ce type d'action.

## Autorisations relatives aux rôles de service : action Service Catalog
<a name="edit-role-servicecatalog"></a>

Pour l'assistance de Service Catalog, ajoutez ce qui suit à votre déclaration de politique :

```
{
    "Effect": "Allow",
    "Action": [
        "servicecatalog:ListProvisioningArtifacts",
        "servicecatalog:CreateProvisioningArtifact",
        "servicecatalog:DescribeProvisioningArtifact",
        "servicecatalog:DeleteProvisioningArtifact",
        "servicecatalog:UpdateProduct"
    ],
    "Resource": "resource_ARN"
},
{
    "Effect": "Allow",
    "Action": [
        "cloudformation:ValidateTemplate"
    ],
    "Resource": "resource_ARN"
}
```

## Exemples de configurations d'actions par type de fichier de configuration
<a name="action-reference-ServiceCatalog-example"></a>

L'exemple suivant montre une configuration valide pour une action de déploiement utilisant Service Catalog, pour un pipeline créé dans la console sans fichier de configuration distinct :

```
"configuration": {
  "TemplateFilePath": "S3_template.json",
  "ProductVersionName": "devops S3 v2",
  "ProductType": "CLOUD_FORMATION_TEMPLATE",
  "ProductVersionDescription": "Product version description",
  "ProductId": "prod-example123456"
}
```

L'exemple suivant montre une configuration valide pour une action de déploiement utilisant Service Catalog, pour un pipeline créé dans la console avec un fichier de `sample_config.json` configuration distinct :

```
"configuration": {
  "ConfigurationFilePath": "sample_config.json",
  "ProductId": "prod-example123456"
}
```

### Exemple de configuration d'action
<a name="action-reference-ServiceCatalog-example-default"></a>

------
#### [ YAML ]

```
Name: ActionName
ActionTypeId:
  Category: Deploy
  Owner: AWS
  Version: 1
  Provider: ServiceCatalog
OutputArtifacts:
- Name: myOutputArtifact
Configuration:
  TemplateFilePath: S3_template.json
  ProductVersionName: devops S3 v2
  ProductType: CLOUD_FORMATION_TEMPLATE
  ProductVersionDescription: Product version description
  ProductId: prod-example123456
```

------
#### [ JSON ]

```
{
    "Name": "ActionName",
    "ActionTypeId": {
        "Category": "Deploy",
        "Owner": "AWS",
        "Version": 1,
        "Provider": "ServiceCatalog"
    },
    "OutputArtifacts": [
        {
            "Name": "myOutputArtifact"
        }
    ],
    "Configuration": {
        "TemplateFilePath": "S3_template.json",
        "ProductVersionName": "devops S3 v2",
        "ProductType": "CLOUD_FORMATION_TEMPLATE",
        "ProductVersionDescription": "Product version description",
        "ProductId": "prod-example123456"
    }
}
```

------

## Consultez aussi
<a name="action-reference-ServiceCatalog-links"></a>

Les ressources connexes suivantes peuvent s'avérer utiles dans le cadre de l'utilisation de cette action.
+ [Guide de l'utilisateur du Service Catalog](https://docs.aws.amazon.com/servicecatalog/latest/userguide/) : pour plus d'informations sur les ressources et les modèles de Service Catalog, consultez le *Guide de l'utilisateur du Service Catalog*.
+ [Tutoriel : Création d'un pipeline à déployer sur Service Catalog](tutorials-S3-servicecatalog.md)— Ce didacticiel explique comment créer et configurer un pipeline pour déployer votre modèle de produit sur Service Catalog et apporter les modifications que vous avez apportées à votre référentiel source.