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.

# Referencia de la acción de implementación de AWS Service Catalog
<a name="action-reference-ServiceCatalog"></a>

Usas una AWS Service Catalog acción para implementar plantillas mediante tu canalización. Se trata de plantillas de recursos que ha creado en Service Catalog.

## Tipo de acción
<a name="action-reference-ServiceCatalog-type"></a>
+ Categoría: `Deploy`
+ Propietario: `AWS`
+ Proveedor: `ServiceCatalog`
+ Versión: `1` 

## Parámetros de configuración
<a name="action-reference-ServiceCatalog-config"></a>

**TemplateFilePath**  
Obligatorio: sí  
La ruta del archivo de la plantilla de recursos en la ubicación de origen.

**ProductVersionName**  
Obligatorio: sí  
La versión del producto en Service Catalog.

**ProductType**  
Obligatorio: sí  
El tipo de producto en Service Catalog.

**ProductId**  
Obligatorio: sí  
El ID de producto en Service Catalog.

**ProductVersionDescription**  
Obligatorio: no  
La descripción de la versión del producto en Service Catalog.

## Artefactos de entrada
<a name="action-reference-ServiceCatalog-input"></a>
+ **Número de artefactos:** `1`
+ **Descripción:** es el artefacto de entrada para la acción.

## Artefactos de salida
<a name="action-reference-ServiceCatalog-output"></a>
+ **Número de artefactos:** `0` 
+ **Descripción:** los artefactos de salida no se aplican a este tipo de acción.

## Permisos del rol de servicio: acción de Service Catalog
<a name="edit-role-servicecatalog"></a>

Para admitir Service Catalog, añada lo siguiente a su instrucción de política:

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

## Ejemplos de configuraciones de la acción por tipo de archivo de configuración
<a name="action-reference-ServiceCatalog-example"></a>

En el ejemplo siguiente se muestra una configuración válida para una acción de implementación que utiliza Service Catalog, para una canalización creada en la consola sin un archivo de configuración distinto:

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

En el ejemplo siguiente se muestra una configuración válida para una acción de implementación que utiliza Service Catalog, para una canalización creada en la consola con un archivo de configuración de `sample_config.json`distinto:

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

### Ejemplo de configuración de una acción
<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"
    }
}
```

------

## Véase también
<a name="action-reference-ServiceCatalog-links"></a>

Los recursos relacionados siguientes pueden serle de ayuda cuando trabaje con esta acción.
+ [Guía del usuario de Service Catalog](https://docs.aws.amazon.com/servicecatalog/latest/userguide/): para obtener información sobre los recursos y las plantillas de Service Catalog, consulte la *Guía del usuario de Service Catalog*.
+ [Tutorial: Crear una canalización que se implemente en Service Catalog](tutorials-S3-servicecatalog.md). En este tutorial, se muestra cómo crear y configurar una canalización para implementar su plantilla de producto en Service Catalog y enviar los cambios que haya realizado a su repositorio de origen.