As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Referência da ação de implantação do AWS Service Catalog
<a name="action-reference-ServiceCatalog"></a>

Você usa uma AWS Service Catalog ação para implantar modelos usando seu pipeline. Esses são modelos de recursos criados por você no Service Catalog.

## Tipo de ação
<a name="action-reference-ServiceCatalog-type"></a>
+ Categoria: `Deploy`
+ Proprietário: `AWS`
+ Fornecedor: `ServiceCatalog`
+ Versão: `1`

## Parâmetros de configuração
<a name="action-reference-ServiceCatalog-config"></a>

**TemplateFilePath**  
Obrigatório: Sim  
O caminho do arquivo do modelo de recurso no local de origem.

**ProductVersionName**  
Obrigatório: Sim  
A versão do produto no Service Catalog.

**ProductType**  
Obrigatório: Sim  
O tipo de produto no Service Catalog.

**ProductId**  
Obrigatório: Sim  
O ID do produto no Service Catalog.

**ProductVersionDescription**  
Obrigatório: não  
A descrição da versão do produto no Service Catalog.

## Input artifacts (Artefatos de entrada)
<a name="action-reference-ServiceCatalog-input"></a>
+ **Número de artefatos:** `1`
+ **Descrição:** este é o artefato de entrada da ação.

## Artefatos de saída
<a name="action-reference-ServiceCatalog-output"></a>
+ **Número de artefatos:** `0` 
+ **Descrição:** os artefatos de saída não se aplicam a esse tipo de ação.

## Permissões do perfil de serviço: ação do Service Catalog
<a name="edit-role-servicecatalog"></a>

Para compatibilidade com o Service Catalog, adicione o seguinte à declaração da 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"
}
```

## Configurações de ação de exemplo por tipo do arquivo de configuração
<a name="action-reference-ServiceCatalog-example"></a>

O exemplo a seguir mostra uma configuração válida para uma ação de implantação que usa o Service Catalog, para um pipeline criado no console sem um arquivo de configuração separado:

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

O exemplo a seguir mostra uma configuração válida para uma ação de implantação que usa o Service Catalog, para um pipeline criado no console com um arquivo de configuração `sample_config.json` separado:

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

### Exemplo de configuração da ação
<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"
    }
}
```

------

## Consulte também
<a name="action-reference-ServiceCatalog-links"></a>

Os recursos relacionados a seguir podem ajudar você à medida que trabalha com esta ação.
+ [Guia do usuário do Service Catalog](https://docs.aws.amazon.com/servicecatalog/latest/userguide/): para saber mais sobre recursos e modelos no Service Catalog, consulte o *Guia do usuário do Service Catalog*.
+ [Tutorial: Criar um pipeline que realiza a implantação no Service Catalog](tutorials-S3-servicecatalog.md): este tutorial mostra como criar e configurar um pipeline para implantar o modelo do produto no Service Catalog e oferecer as alterações feitas por você no repositório de origem.