翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 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 の製品バージョンの説明。

## 入力アーティファクト
<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"
}
```

次の例は、個別の `sample_config.json` 設定ファイルを使用してパイプラインをコンソールで作成する場合に、Service Catalog を使用するデプロイアクションの有効な設定を示しています。

```
"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 にデプロイするパイプラインを作成して設定し、ソースリポジトリで行った変更を反映する方法について説明します。