Menu
AWS Service Catalog
Developer Guide

CreateProvisioningArtifact

Creates a provisioning artifact (also known as a version) for the specified product.

You cannot create a provisioning artifact for a product that was shared with you.

Request Syntax

{
   "AcceptLanguage": "string",
   "IdempotencyToken": "string",
   "Parameters": { 
      "Description": "string",
      "Info": { 
         "string" : "string" 
      },
      "Name": "string",
      "Type": "string"
   },
   "ProductId": "string"
}

Request Parameters

The request accepts the following data in JSON format.

AcceptLanguage

The language code.

  • en - English (default)

  • jp - Japanese

  • zh - Chinese

Type: String

Required: No

IdempotencyToken

A unique identifier that you provide to ensure idempotency. If multiple requests differ only by the idempotency token, the same response is returned for each repeated request.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 128.

Pattern: [a-zA-Z0-9][a-zA-Z0-9_-]*

Required: Yes

Parameters

The configuration for the provisioning artifact.

Type: ProvisioningArtifactProperties object

Required: Yes

ProductId

The product identifier.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 100.

Required: Yes

Response Syntax

{
   "Info": { 
      "string" : "string" 
   },
   "ProvisioningArtifactDetail": { 
      "CreatedTime": number,
      "Description": "string",
      "Id": "string",
      "Name": "string",
      "Type": "string"
   },
   "Status": "string"
}

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

Info

The URL of the CloudFormation template in Amazon S3, in JSON format.

Type: String to string map

ProvisioningArtifactDetail

Information about the provisioning artifact.

Type: ProvisioningArtifactDetail object

Status

The status of the current request.

Type: String

Valid Values: AVAILABLE | CREATING | FAILED

Errors

InvalidParametersException

One or more parameters provided to the operation are not valid.

HTTP Status Code: 400

LimitExceededException

The current limits of the service would have been exceeded by this operation. Decrease your resource use or increase your service limits and retry the operation.

HTTP Status Code: 400

ResourceNotFoundException

The specified resource was not found.

HTTP Status Code: 400

Example

To create a provisioning artifact

The following shows an example JSON request.

Sample Request

{
   "AcceptLanguage": "en",
   "ProductId": "prod-mjpjbit3pzuqi",
   "Parameters":
   {
      "Name": "Version-2",
      "Description": "my-test-2",
      "Info":
      {
         "LoadTemplateFromURL": "https://s3.amazonaws.com/cf-templates-ozkq9d3hgiq2-us-east-1/..." ,
      },
      "Type": "CLOUD_FORMATION_TEMPLATE"
      "IdempotencyToken": "my-test-token-2"
   }
}

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: