本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# AWS Service Catalog 部署動作參考
<a name="action-reference-ServiceCatalog"></a>

您可以使用 AWS Service Catalog 動作來使用管道部署範本。這些是您已在 Service Catalog 中建立的資源範本。

## 動作類型
<a name="action-reference-ServiceCatalog-type"></a>
+ 類別：`Deploy`
+ 擁有者：`AWS`
+ 提供者：`ServiceCatalog`
+ 版本：`1`

## 組態參數
<a name="action-reference-ServiceCatalog-config"></a>

**TemplateFilePath**  
必要：是  
來源位置中資源範本的檔案路徑。

**ProductVersionName**  
必要：是  
Service Catalog 中的產品版本。

**ProductType**  
必要：是  
Service Catalog 中的產品類型。

**ProductId**  
必要：是  
Service Catalog 中的產品 ID。

**ProductVersionDescription**  
必要：否  
Service Catalog 中的產品版本描述。

## Input artifacts (輸入成品)
<a name="action-reference-ServiceCatalog-input"></a>
+ **成品數量：** `1`
+ **描述：**這是動作的輸入成品。

## 輸出成品
<a name="action-reference-ServiceCatalog-output"></a>
+ **成品數量：** `0`
+ **描述：**輸出成品不適用於此動作類型。

## 服務角色許可：Service Catalog 動作
<a name="edit-role-servicecatalog"></a>

對於 Service Catalog 支援，請將下列項目新增至您的政策陳述式：

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

## 依組態檔案類型列出的動作組態範例
<a name="action-reference-ServiceCatalog-example"></a>

下列範例顯示使用 Service Catalog 之部署動作的有效組態，適用於在主控台中建立且沒有個別組態檔案的管道：

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

下列範例顯示使用 Service Catalog 之部署動作的有效組態，適用於在具有個別`sample_config.json`組態檔案的主控台中建立的管道：

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

### 動作組態範例
<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"
    }
}
```

------

## 另請參閱
<a name="action-reference-ServiceCatalog-links"></a>

以下相關資源可協助您使用此動作。
+ [Service Catalog 使用者指南](https://docs.aws.amazon.com/servicecatalog/latest/userguide/) – 如需 Service Catalog 中資源和範本的相關資訊，請參閱 *Service Catalog 使用者指南*。
+ [教學課程：建立部署至 Service Catalog 的管道](tutorials-S3-servicecatalog.md) – 本教學課程說明如何建立和設定管道，將產品範本部署至 Service Catalog，並交付您在來源儲存庫中所做的變更。