SDK for PHP V3

AWS Launch Wizard 2018-05-10

Client: Aws\LaunchWizard\LaunchWizardClient
Service ID: launch-wizard
Version: 2018-05-10

This page describes the parameters and results for the operations of the AWS Launch Wizard (2018-05-10), and shows how to use the Aws\LaunchWizard\LaunchWizardClient object to call the described operations. This documentation is specific to the 2018-05-10 API version of the service.

Operation Summary

Each of the following operations can be created from a client using $client->getCommand('CommandName'), where "CommandName" is the name of one of the following operations. Note: a command is a value that encapsulates an operation and the parameters used to create an HTTP request.

You can also create and send a command immediately using the magic methods available on a client object: $client->commandName(/* parameters */). You can send the command asynchronously (returning a promise) by appending the word "Async" to the operation name: $client->commandNameAsync(/* parameters */).

CreateDeployment ( array $params = [] )
Creates a deployment for the given workload.
DeleteDeployment ( array $params = [] )
Deletes a deployment.
GetDeployment ( array $params = [] )
Returns information about the deployment.
GetDeploymentPatternVersion ( array $params = [] )
Returns information about a deployment pattern version.
GetWorkload ( array $params = [] )
Returns information about a workload.
GetWorkloadDeploymentPattern ( array $params = [] )
Returns details for a given workload and deployment pattern, including the available specifications.
ListDeploymentEvents ( array $params = [] )
Lists the events of a deployment.
ListDeploymentPatternVersions ( array $params = [] )
Lists the deployment pattern versions.
ListDeployments ( array $params = [] )
Lists the deployments that have been created.
ListTagsForResource ( array $params = [] )
Lists the tags associated with a specified resource.
ListWorkloadDeploymentPatterns ( array $params = [] )
Lists the workload deployment patterns for a given workload name.
ListWorkloads ( array $params = [] )
Lists the available workload names.
TagResource ( array $params = [] )
Adds the specified tags to the given resource.
UntagResource ( array $params = [] )
Removes the specified tags from the given resource.
UpdateDeployment ( array $params = [] )
Updates a deployment.

Paginators

Paginators handle automatically iterating over paginated API results. Paginators are associated with specific API operations, and they accept the parameters that the corresponding API operation accepts. You can get a paginator from a client class using getPaginator($paginatorName, $operationParameters). This client supports the following paginators:

ListDeploymentEvents
ListDeploymentPatternVersions
ListDeployments
ListWorkloadDeploymentPatterns
ListWorkloads

Operations

CreateDeployment 

$result = $client->createDeployment([/* ... */]);
$promise = $client->createDeploymentAsync([/* ... */]);

Creates a deployment for the given workload. Deployments created by this operation are not available in the Launch Wizard console to use the Clone deployment action on.

Parameter Syntax

$result = $client->createDeployment([
    'deploymentPatternName' => '<string>', // REQUIRED
    'dryRun' => true || false,
    'name' => '<string>', // REQUIRED
    'specifications' => ['<string>', ...], // REQUIRED
    'tags' => ['<string>', ...],
    'workloadName' => '<string>', // REQUIRED
]);

Parameter Details

Members
deploymentPatternName
Required: Yes
Type: string

The name of the deployment pattern supported by a given workload. You can use the ListWorkloadDeploymentPatterns operation to discover supported values for this parameter.

dryRun
Type: boolean

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

name
Required: Yes
Type: string

The name of the deployment.

specifications
Required: Yes
Type: Associative array of custom strings keys (KeyString) to strings

The settings specified for the deployment. These settings define how to deploy and configure your resources created by the deployment. For more information about the specifications required for creating a deployment for a SAP workload, see SAP deployment specifications. To retrieve the specifications required to create a deployment for other workloads, use the GetWorkloadDeploymentPattern operation.

tags
Type: Associative array of custom strings keys (TagKey) to strings

The tags to add to the deployment.

workloadName
Required: Yes
Type: string

The name of the workload. You can use the ListWorkloads operation to discover supported values for this parameter.

Result Syntax

[
    'deploymentId' => '<string>',
]

Result Details

Members
deploymentId
Type: string

The ID of the deployment.

Errors

ResourceLimitException:

You have exceeded an Launch Wizard resource limit. For example, you might have too many deployments in progress.

InternalServerException:

An internal error has occurred. Retry your request, but if the problem persists, contact us with details by posting a question on re:Post.

ValidationException:

The input fails to satisfy the constraints specified by an Amazon Web Services service.

ResourceNotFoundException:

The specified workload or deployment resource can't be found.

Examples

Example 1: Deploy a given workload with given settings. 
$result = $client->createDeployment([
    'name' => 'TestDeployment1',
    'deploymentPatternName' => 'SapHanaSingle',
    'dryRun' => ,
    'specifications' => [
        'CreateSecurityGroup' => 'No',
        'DisableDeploymentRollback' => 'Yes',
        'EnableEbsVolumeEncryption' => 'Yes',
        'KeyPairName' => 'keyName',
        'ProxyServerAddress' => 'http://xyz.abc.com:8080',
        'SapSysGroupId' => '5003',
        'SapVirtualIPOptIn' => 'No',
        'SaveDeploymentArtifacts' => 'No',
        'SnsTopicArn' => 'arn:aws:sns:us-east-1:111111222222:snsNameUsEast1.fifo',
        'Timezone' => 'Pacific/Wake',
        'VpcId' => 'vpc-1234566',
    ],
    'workloadName' => 'SAP',
]);

Result syntax:

[
    'deploymentId' => '4c1b59c1-659c-467f-b6e9-6ef6f9d28e1d',
]
Example 2: Deploy a given workload with given settings and passing tags for Launch Wizard deployment resource. 
$result = $client->createDeployment([
    'name' => 'TestDeployment2',
    'deploymentPatternName' => 'SapHanaSingle',
    'dryRun' => ,
    'specifications' => [
        'CreateSecurityGroup' => 'No',
        'DisableDeploymentRollback' => 'Yes',
        'EnableEbsVolumeEncryption' => 'Yes',
        'KeyPairName' => 'keyName',
        'ProxyServerAddress' => 'http://xyz.abc.com:8080',
        'SapSysGroupId' => '5003',
        'SapVirtualIPOptIn' => 'No',
        'SaveDeploymentArtifacts' => 'No',
        'SnsTopicArn' => 'arn:aws:sns:us-east-1:111111222222:snsNameUsEast1.fifo',
        'Timezone' => 'Pacific/Wake',
        'VpcId' => 'vpc-1234566',
    ],
    'tags' => [
        'key1' => 'val1',
        'key2' => 'val2',
    ],
    'workloadName' => 'SAP',
]);

Result syntax:

[
    'deploymentId' => '1111111-1111-1111-1111-111111111111',
]

DeleteDeployment 

$result = $client->deleteDeployment([/* ... */]);
$promise = $client->deleteDeploymentAsync([/* ... */]);

Deletes a deployment.

Parameter Syntax

$result = $client->deleteDeployment([
    'deploymentId' => '<string>', // REQUIRED
]);

Parameter Details

Members
deploymentId
Required: Yes
Type: string

The ID of the deployment.

Result Syntax

[
    'status' => 'COMPLETED|CREATING|DELETE_IN_PROGRESS|DELETE_INITIATING|DELETE_FAILED|DELETED|FAILED|IN_PROGRESS|VALIDATING|UPDATE_IN_PROGRESS|UPDATE_COMPLETED|UPDATE_FAILED|UPDATE_ROLLBACK_COMPLETED|UPDATE_ROLLBACK_FAILED',
    'statusReason' => '<string>',
]

Result Details

Members
status
Type: string

The status of the deployment.

statusReason
Type: string

The reason for the deployment status.

Errors

ResourceLimitException:

You have exceeded an Launch Wizard resource limit. For example, you might have too many deployments in progress.

InternalServerException:

An internal error has occurred. Retry your request, but if the problem persists, contact us with details by posting a question on re:Post.

ValidationException:

The input fails to satisfy the constraints specified by an Amazon Web Services service.

ResourceNotFoundException:

The specified workload or deployment resource can't be found.

Examples

Example 1: Delete a deployment. 
$result = $client->deleteDeployment([
    'deploymentId' => '4c1b59c1-659c-467f-b6e9-6ef6f9d28e1d',
]);

Result syntax:

[
    'status' => 'DELETED',
    'statusReason' => 'Finished processing DeleteApp request',
]

GetDeployment 

$result = $client->getDeployment([/* ... */]);
$promise = $client->getDeploymentAsync([/* ... */]);

Returns information about the deployment.

Parameter Syntax

$result = $client->getDeployment([
    'deploymentId' => '<string>', // REQUIRED
]);

Parameter Details

Members
deploymentId
Required: Yes
Type: string

The ID of the deployment.

Result Syntax

[
    'deployment' => [
        'createdAt' => <DateTime>,
        'deletedAt' => <DateTime>,
        'deploymentArn' => '<string>',
        'id' => '<string>',
        'modifiedAt' => <DateTime>,
        'name' => '<string>',
        'patternName' => '<string>',
        'resourceGroup' => '<string>',
        'specifications' => ['<string>', ...],
        'status' => 'COMPLETED|CREATING|DELETE_IN_PROGRESS|DELETE_INITIATING|DELETE_FAILED|DELETED|FAILED|IN_PROGRESS|VALIDATING|UPDATE_IN_PROGRESS|UPDATE_COMPLETED|UPDATE_FAILED|UPDATE_ROLLBACK_COMPLETED|UPDATE_ROLLBACK_FAILED',
        'tags' => ['<string>', ...],
        'workloadName' => '<string>',
    ],
]

Result Details

Members
deployment
Type: DeploymentData structure

An object that details the deployment.

Errors

InternalServerException:

An internal error has occurred. Retry your request, but if the problem persists, contact us with details by posting a question on re:Post.

ValidationException:

The input fails to satisfy the constraints specified by an Amazon Web Services service.

ResourceNotFoundException:

The specified workload or deployment resource can't be found.

Examples

Example 1: Get details about a given deployment. 
$result = $client->getDeployment([
    'deploymentId' => '1111111-1111-1111-1111-111111111111',
]);

Result syntax:

[
    'deployment' => [
        'name' => 'SapHanaSingleForTest',
        'createdAt' => ,
        'deploymentArn' => 'arn:aws:launchwizard:us-east-1:123456789012:deployment/1111111-1111-1111-1111-111111111111',
        'id' => '1111111-1111-1111-1111-111111111111',
        'specifications' => [
            'DisableDeploymentRollback' => 'true',
            'Encryption' => 'Yes',
            'KeyName' => 'testLinuxInstance',
            'SAPTZ' => 'America/Vancouver',
            'VPCID' => 'vpc-1234567',
            'applicationName' => 'SapHanaSingleForTest',
            'deploymentScenario' => 'SapHanaSingle',
            'environmentType' => 'production',
            'saveArtifactsS3Uri' => 's3://testbucket',
            'saveDeploymentArtifacts' => 'Yes',
        ],
        'status' => 'FAILED',
        'tags' => [
            'key1' => 'val1',
            'key2' => 'val2',
        ],
        'workloadName' => 'SapHanaSingle',
    ],
]

GetDeploymentPatternVersion 

$result = $client->getDeploymentPatternVersion([/* ... */]);
$promise = $client->getDeploymentPatternVersionAsync([/* ... */]);

Returns information about a deployment pattern version.

Parameter Syntax

$result = $client->getDeploymentPatternVersion([
    'deploymentPatternName' => '<string>', // REQUIRED
    'deploymentPatternVersionName' => '<string>', // REQUIRED
    'workloadName' => '<string>', // REQUIRED
]);

Parameter Details

Members
deploymentPatternName
Required: Yes
Type: string

The name of the deployment pattern. You can use the ListWorkloadDeploymentPatterns operation to discover supported values for this parameter.

deploymentPatternVersionName
Required: Yes
Type: string

The name of the deployment pattern version.

workloadName
Required: Yes
Type: string

The name of the workload. You can use the ListWorkloads operation to discover supported values for this parameter.

Result Syntax

[
    'deploymentPatternVersion' => [
        'deploymentPatternName' => '<string>',
        'deploymentPatternVersionName' => '<string>',
        'description' => '<string>',
        'documentationUrl' => '<string>',
        'workloadName' => '<string>',
    ],
]

Result Details

Members
deploymentPatternVersion
Type: DeploymentPatternVersionDataSummary structure

The deployment pattern version.

Errors

InternalServerException:

An internal error has occurred. Retry your request, but if the problem persists, contact us with details by posting a question on re:Post.

ResourceNotFoundException:

The specified workload or deployment resource can't be found.

GetWorkload 

$result = $client->getWorkload([/* ... */]);
$promise = $client->getWorkloadAsync([/* ... */]);

Returns information about a workload.

Parameter Syntax

$result = $client->getWorkload([
    'workloadName' => '<string>', // REQUIRED
]);

Parameter Details

Members
workloadName
Required: Yes
Type: string

The name of the workload.

Result Syntax

[
    'workload' => [
        'description' => '<string>',
        'displayName' => '<string>',
        'documentationUrl' => '<string>',
        'iconUrl' => '<string>',
        'status' => 'ACTIVE|INACTIVE|DISABLED|DELETED',
        'statusMessage' => '<string>',
        'workloadName' => '<string>',
    ],
]

Result Details

Members
workload
Type: WorkloadData structure

Information about the workload.

Errors

InternalServerException:

An internal error has occurred. Retry your request, but if the problem persists, contact us with details by posting a question on re:Post.

ValidationException:

The input fails to satisfy the constraints specified by an Amazon Web Services service.

ResourceNotFoundException:

The specified workload or deployment resource can't be found.

Examples

Example 1: Get details about a specific workload. 
$result = $client->getWorkload([
    'workloadName' => 'SAP',
]);

Result syntax:

[
    'workload' => [
        'documentationUrl' => 'https://docs.aws.amazon.com/launchwizard/latest/userguide/launch-wizard-sap.html',
        'description' => 'Workload Description',
        'displayName' => 'SAP',
        'iconUrl' => 'https://aws-lw-workload-assets-test-us-east-1.s3.amazonaws.com/amazon/SAP/icon.png?X-Amz-Security-Token=IQoJb3JpZ2luX2VjEAUaCXVzLWVhc3QtMSJHMEUCIC4l3GCH4o%2Bgq3pJzcD1YJmtrmyNCoEgG2RIayjDWf9kAiEAnMK5nYixaZLuF1s1UVoNd7xIbDrOQ8EAbhcZWexMp9cq7wIIrf%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FARAEGgw1ODI1NTgxMjEyMDYiDHxMN%2BZ8CoPORzvo4yrDAtkVZlBVxLwnFmwHw005vo13LOUUbyajEpp3HNh%2BaBL8K2DLx7Kzi0UPPD6z8pL1eiFLHAQ9zZgVc7pLVQjBKOdcw1GmIADDepqYEb%2B8zLi7zwWP1JT72YbT6ZXSoWpb5NCqcyAvdK47b0Ae586s6VkWzoeJ65jR%2FgbJMhRpFpqVSP2XI6Rf6yA3%2BkQyUCk3RdyF4ljIL8Nf5nIFb%2BOMK2PZ8aJX85l1j7UpJE1rfNb1PitVcQz3KlW5xkiXfcWRKeVhgHRyuCEL3FY0DyPFdqe3NxcA0%2FzPgBq6Y9B41kM6af5u2kQRfQOjWejDpzpG7w40eaIKAYnhBkjIA9550geSLB7O%2FuAPQLI9fI2lVowIBUKsKVOr0%2FFGIzW3WM7%2BbEx%2FZ0mDkP1IhcpZdP7owC77K8O%2BXDgBCabAy48K3ndi%2BQKQMPXjz6YGOp4Bbgv9mVc3sE4KvXZv1skhnOYcOKGdCncIKLne0W%2BgO3URxyDQiyO2FhM3OekXDH83CNCyDVIpkgpWkvgXDSaZiD5mj0T9iqEeJzfh6uQvX1dRN%2BxI1eV0M7HKY2e7F%2BKNjeLhzKgKpSpDqFIUSjLeBlLLyQCNKuUiO3DMiy3rB89aX4b9wyC8au0SfGb72YyNLXjh6M1whcj1VNGePyw%3D&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20230809T202649Z&X-Amz-SignedHeaders=host&X-Amz-Expires=3600&X-Amz-Credential=ASIAYPIZLPT3GGDNTHTI%2F20230809%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Signature=6a37e41e47208b426a5e7d32392d0815388cd0231187652204836943c37ad86a',
        'status' => 'ACTIVE',
        'workloadName' => 'SAP',
    ],
]

GetWorkloadDeploymentPattern 

$result = $client->getWorkloadDeploymentPattern([/* ... */]);
$promise = $client->getWorkloadDeploymentPatternAsync([/* ... */]);

Returns details for a given workload and deployment pattern, including the available specifications. You can use the ListWorkloads operation to discover the available workload names and the ListWorkloadDeploymentPatterns operation to discover the available deployment pattern names of a given workload.

Parameter Syntax

$result = $client->getWorkloadDeploymentPattern([
    'deploymentPatternName' => '<string>', // REQUIRED
    'workloadName' => '<string>', // REQUIRED
]);

Parameter Details

Members
deploymentPatternName
Required: Yes
Type: string

The name of the deployment pattern.

workloadName
Required: Yes
Type: string

The name of the workload.

Result Syntax

[
    'workloadDeploymentPattern' => [
        'deploymentPatternName' => '<string>',
        'deploymentPatternVersionName' => '<string>',
        'description' => '<string>',
        'displayName' => '<string>',
        'specifications' => [
            [
                'allowedValues' => ['<string>', ...],
                'conditionals' => [
                    [
                        'comparator' => '<string>',
                        'name' => '<string>',
                        'value' => '<string>',
                    ],
                    // ...
                ],
                'description' => '<string>',
                'name' => '<string>',
                'required' => '<string>',
            ],
            // ...
        ],
        'status' => 'ACTIVE|INACTIVE|DISABLED|DELETED',
        'statusMessage' => '<string>',
        'workloadName' => '<string>',
        'workloadVersionName' => '<string>',
    ],
]

Result Details

Members
workloadDeploymentPattern
Type: WorkloadDeploymentPatternData structure

Details about the workload deployment pattern.

Errors

InternalServerException:

An internal error has occurred. Retry your request, but if the problem persists, contact us with details by posting a question on re:Post.

ValidationException:

The input fails to satisfy the constraints specified by an Amazon Web Services service.

ResourceNotFoundException:

The specified workload or deployment resource can't be found.

Examples

Example 1: Get details about a specific Workload deployment pattern 
$result = $client->getWorkloadDeploymentPattern([
    'deploymentPatternName' => 'adSelfManagedNewVpc',
    'workloadName' => 'MicrosoftActiveDirectory',
]);

Result syntax:

[
    'workloadDeploymentPattern' => [
        'deploymentPatternName' => 'adSelfManagedNewVpc',
        'deploymentPatternVersionName' => '2024-03-19-14-00-09',
        'description' => 'Builds a new AWS environment (VPC and other components), and deploys AD DS into this new VPC.',
        'displayName' => 'Self-managed AD - new VPC',
        'specifications' => [
            [
                'name' => 'NumberOfAZs',
                'required' => 'Yes',
                'description' => 'Number of Availability Zones to use in the VPC.',
            ],
            [
                'name' => 'AvailabilityZones',
                'required' => 'Yes',
                'description' => 'List of Availability Zones (AZs) to use for the subnets in the VPC.',
            ],
            [
                'name' => 'VPCCIDR',
                'required' => 'Yes',
                'description' => 'CIDR block for the VPC.',
            ],
        ],
        'status' => 'ACTIVE',
        'workloadName' => 'MicrosoftActiveDirectory',
    ],
]

ListDeploymentEvents 

$result = $client->listDeploymentEvents([/* ... */]);
$promise = $client->listDeploymentEventsAsync([/* ... */]);

Lists the events of a deployment.

Parameter Syntax

$result = $client->listDeploymentEvents([
    'deploymentId' => '<string>', // REQUIRED
    'maxResults' => <integer>,
    'nextToken' => '<string>',
]);

Parameter Details

Members
deploymentId
Required: Yes
Type: string

The ID of the deployment.

maxResults
Type: int

The maximum number of items to return for this request. To get the next page of items, make another request with the token returned in the output.

nextToken
Type: string

The token returned from a previous paginated request. Pagination continues from the end of the items returned by the previous request.

Result Syntax

[
    'deploymentEvents' => [
        [
            'description' => '<string>',
            'name' => '<string>',
            'status' => 'CANCELED|CANCELING|COMPLETED|CREATED|FAILED|IN_PROGRESS|PENDING|TIMED_OUT',
            'statusReason' => '<string>',
            'timestamp' => <DateTime>,
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
deploymentEvents
Type: Array of DeploymentEventDataSummary structures

Lists the deployment events.

nextToken
Type: string

The token to include in another request to get the next page of items. This value is null when there are no more items to return.

Errors

InternalServerException:

An internal error has occurred. Retry your request, but if the problem persists, contact us with details by posting a question on re:Post.

ValidationException:

The input fails to satisfy the constraints specified by an Amazon Web Services service.

ResourceNotFoundException:

The specified workload or deployment resource can't be found.

Examples

Example 1: List all actions taken during a deployment. 
$result = $client->listDeploymentEvents([
    'deploymentId' => '4c1b59c1-659c-467f-b6e9-6ef6f9d28e1d',
]);

Result syntax:

[
    'deploymentEvents' => [
        [
            'name' => 'Create secure parameter',
            'description' => 'Creates a new secure parameter',
            'status' => 'COMPLETED',
            'statusReason' => '',
            'timestamp' => ,
        ],
        [
            'name' => 'Create resource group',
            'description' => 'Creates a resource group with all the application resources',
            'status' => 'COMPLETED',
            'statusReason' => '',
            'timestamp' => ,
        ],
    ],
]

ListDeploymentPatternVersions 

$result = $client->listDeploymentPatternVersions([/* ... */]);
$promise = $client->listDeploymentPatternVersionsAsync([/* ... */]);

Lists the deployment pattern versions.

Parameter Syntax

$result = $client->listDeploymentPatternVersions([
    'deploymentPatternName' => '<string>', // REQUIRED
    'filters' => [
        [
            'name' => 'updateFromVersion', // REQUIRED
            'values' => ['<string>', ...], // REQUIRED
        ],
        // ...
    ],
    'maxResults' => <integer>,
    'nextToken' => '<string>',
    'workloadName' => '<string>', // REQUIRED
]);

Parameter Details

Members
deploymentPatternName
Required: Yes
Type: string

The name of the deployment pattern. You can use the ListWorkloadDeploymentPatterns operation to discover supported values for this parameter.

filters
Type: Array of DeploymentPatternVersionFilter structures

Filters to apply when listing deployment pattern versions.

maxResults
Type: int

The maximum number of deployment pattern versions to list.

nextToken
Type: string

The token for the next set of results.

workloadName
Required: Yes
Type: string

The name of the workload. You can use the ListWorkloads operation to discover supported values for this parameter.

Result Syntax

[
    'deploymentPatternVersions' => [
        [
            'deploymentPatternName' => '<string>',
            'deploymentPatternVersionName' => '<string>',
            'description' => '<string>',
            'documentationUrl' => '<string>',
            'workloadName' => '<string>',
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
deploymentPatternVersions
Type: Array of DeploymentPatternVersionDataSummary structures

The deployment pattern versions.

nextToken
Type: string

The token for the next set of results.

Errors

InternalServerException:

An internal error has occurred. Retry your request, but if the problem persists, contact us with details by posting a question on re:Post.

ValidationException:

The input fails to satisfy the constraints specified by an Amazon Web Services service.

ResourceNotFoundException:

The specified workload or deployment resource can't be found.

Examples

Example 1: List all visible versions for the given workload and deployment pattern. 
$result = $client->listDeploymentPatternVersions([
    'deploymentPatternName' => 'default',
    'workloadName' => 'security-automations-for-aws-waf',
]);

Result syntax:

[
    'deploymentPatternVersions' => [
        [
            'deploymentPatternName' => 'default',
            'deploymentPatternVersionName' => '4.0.6',
            'workloadName' => 'security-automations-for-aws-waf',
        ],
        [
            'deploymentPatternName' => 'default',
            'deploymentPatternVersionName' => '3.2.5',
            'workloadName' => 'security-automations-for-aws-waf',
        ],
        [
            'deploymentPatternName' => 'default',
            'deploymentPatternVersionName' => '3.1.0',
            'workloadName' => 'security-automations-for-aws-waf',
        ],
    ],
]
Example 2: List filtered versions for the given workload and deployment pattern. 
$result = $client->listDeploymentPatternVersions([
    'deploymentPatternName' => 'default',
    'filters' => [
        [
            'name' => 'updateFromVersion',
            'values' => [
                '4.0.2',
            ],
        ],
    ],
    'workloadName' => 'security-automations-for-aws-waf',
]);

Result syntax:

[
    'deploymentPatternVersions' => [
        [
            'deploymentPatternName' => 'default',
            'deploymentPatternVersionName' => '4.0.6',
            'workloadName' => 'security-automations-for-aws-waf',
        ],
    ],
]

ListDeployments 

$result = $client->listDeployments([/* ... */]);
$promise = $client->listDeploymentsAsync([/* ... */]);

Lists the deployments that have been created.

Parameter Syntax

$result = $client->listDeployments([
    'filters' => [
        [
            'name' => 'WORKLOAD_NAME|DEPLOYMENT_STATUS',
            'values' => ['<string>', ...],
        ],
        // ...
    ],
    'maxResults' => <integer>,
    'nextToken' => '<string>',
]);

Parameter Details

Members
filters
Type: Array of DeploymentFilter structures

Filters to scope the results. The following filters are supported:

  • WORKLOAD_NAME - The name used in deployments.

  • DEPLOYMENT_STATUS - COMPLETED | CREATING | DELETE_IN_PROGRESS | DELETE_INITIATING | DELETE_FAILED | DELETED | FAILED | IN_PROGRESS | VALIDATING

maxResults
Type: int

The maximum number of items to return for this request. To get the next page of items, make another request with the token returned in the output.

nextToken
Type: string

The token returned from a previous paginated request. Pagination continues from the end of the items returned by the previous request.

Result Syntax

[
    'deployments' => [
        [
            'createdAt' => <DateTime>,
            'id' => '<string>',
            'modifiedAt' => <DateTime>,
            'name' => '<string>',
            'patternName' => '<string>',
            'status' => 'COMPLETED|CREATING|DELETE_IN_PROGRESS|DELETE_INITIATING|DELETE_FAILED|DELETED|FAILED|IN_PROGRESS|VALIDATING|UPDATE_IN_PROGRESS|UPDATE_COMPLETED|UPDATE_FAILED|UPDATE_ROLLBACK_COMPLETED|UPDATE_ROLLBACK_FAILED',
            'workloadName' => '<string>',
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
deployments
Type: Array of DeploymentDataSummary structures

Lists the deployments.

nextToken
Type: string

The token to include in another request to get the next page of items. This value is null when there are no more items to return.

Errors

InternalServerException:

An internal error has occurred. Retry your request, but if the problem persists, contact us with details by posting a question on re:Post.

ValidationException:

The input fails to satisfy the constraints specified by an Amazon Web Services service.

Examples

Example 1: List deployments in the account with filters. 
$result = $client->listDeployments([
    'filters' => [
        [
            'name' => 'DEPLOYMENT_STATUS',
            'values' => [
                'IN_PROGRESS',
            ],
        ],
    ],
]);

Result syntax:

[
    'deployments' => [
        [
            'name' => 'SapHanaSingleForTest',
            'createdAt' => ,
            'id' => '4c1b59c1-659c-467f-b6e9-6ef6f9d28e1d',
            'patternName' => 'SapHanaSingle',
            'status' => 'IN_PROGRESS',
            'workloadName' => 'SAP',
        ],
    ],
]

ListTagsForResource 

$result = $client->listTagsForResource([/* ... */]);
$promise = $client->listTagsForResourceAsync([/* ... */]);

Lists the tags associated with a specified resource.

Parameter Syntax

$result = $client->listTagsForResource([
    'resourceArn' => '<string>', // REQUIRED
]);

Parameter Details

Members
resourceArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the resource.

Result Syntax

[
    'tags' => ['<string>', ...],
]

Result Details

Members
tags
Type: Associative array of custom strings keys (TagKey) to strings

Information about the tags.

Errors

InternalServerException:

An internal error has occurred. Retry your request, but if the problem persists, contact us with details by posting a question on re:Post.

ValidationException:

The input fails to satisfy the constraints specified by an Amazon Web Services service.

ResourceNotFoundException:

The specified workload or deployment resource can't be found.

Examples

Example 1: Listing tags on a Launch Wizard deployment resource. 
$result = $client->listTagsForResource([
    'resourceArn' => 'arn:aws:launchwizard:us-east-1:123456789012:deployment/11111111-1111-1111-1111-111111111111',
]);

Result syntax:

[
    'tags' => [
        'key1' => 'value1',
        'key2' => 'value2',
    ],
]

ListWorkloadDeploymentPatterns 

$result = $client->listWorkloadDeploymentPatterns([/* ... */]);
$promise = $client->listWorkloadDeploymentPatternsAsync([/* ... */]);

Lists the workload deployment patterns for a given workload name. You can use the ListWorkloads operation to discover the available workload names.

Parameter Syntax

$result = $client->listWorkloadDeploymentPatterns([
    'maxResults' => <integer>,
    'nextToken' => '<string>',
    'workloadName' => '<string>', // REQUIRED
]);

Parameter Details

Members
maxResults
Type: int

The maximum number of items to return for this request. To get the next page of items, make another request with the token returned in the output.

nextToken
Type: string

The token returned from a previous paginated request. Pagination continues from the end of the items returned by the previous request.

workloadName
Required: Yes
Type: string

The name of the workload.

Result Syntax

[
    'nextToken' => '<string>',
    'workloadDeploymentPatterns' => [
        [
            'deploymentPatternName' => '<string>',
            'deploymentPatternVersionName' => '<string>',
            'description' => '<string>',
            'displayName' => '<string>',
            'status' => 'ACTIVE|INACTIVE|DISABLED|DELETED',
            'statusMessage' => '<string>',
            'workloadName' => '<string>',
            'workloadVersionName' => '<string>',
        ],
        // ...
    ],
]

Result Details

Members
nextToken
Type: string

The token to include in another request to get the next page of items. This value is null when there are no more items to return.

workloadDeploymentPatterns
Type: Array of WorkloadDeploymentPatternDataSummary structures

Describes the workload deployment patterns.

Errors

InternalServerException:

An internal error has occurred. Retry your request, but if the problem persists, contact us with details by posting a question on re:Post.

ValidationException:

The input fails to satisfy the constraints specified by an Amazon Web Services service.

ResourceNotFoundException:

The specified workload or deployment resource can't be found.

Examples

Example 1: List all available workloads supported by AWS Launch Wizard. 
$result = $client->listWorkloadDeploymentPatterns([
    'workloadName' => 'SAP',
]);

Result syntax:

[
    'workloadDeploymentPatterns' => [
        [
            'deploymentPatternName' => 'SapHanaHA',
            'deploymentPatternVersionName' => '2023-08-02-01-00-00',
            'description' => 'Deployment Option Description',
            'displayName' => 'Deployment Option Display Name',
            'status' => 'ACTIVE',
            'workloadName' => 'SAP',
        ],
        [
            'deploymentPatternName' => 'SapHanaMulti',
            'deploymentPatternVersionName' => '2023-08-02-01-00-00',
            'description' => 'Deployment Option Description',
            'displayName' => 'Deployment Option Display Name',
            'status' => 'ACTIVE',
            'workloadName' => 'SAP',
        ],
    ],
]

ListWorkloads 

$result = $client->listWorkloads([/* ... */]);
$promise = $client->listWorkloadsAsync([/* ... */]);

Lists the available workload names. You can use the ListWorkloadDeploymentPatterns operation to discover the available deployment patterns for a given workload.

Parameter Syntax

$result = $client->listWorkloads([
    'maxResults' => <integer>,
    'nextToken' => '<string>',
]);

Parameter Details

Members
maxResults
Type: int

The maximum number of items to return for this request. To get the next page of items, make another request with the token returned in the output.

nextToken
Type: string

The token returned from a previous paginated request. Pagination continues from the end of the items returned by the previous request.

Result Syntax

[
    'nextToken' => '<string>',
    'workloads' => [
        [
            'displayName' => '<string>',
            'status' => 'ACTIVE|INACTIVE|DISABLED|DELETED',
            'workloadName' => '<string>',
        ],
        // ...
    ],
]

Result Details

Members
nextToken
Type: string

The token to include in another request to get the next page of items. This value is null when there are no more items to return.

workloads
Type: Array of WorkloadDataSummary structures

Information about the workloads.

Errors

InternalServerException:

An internal error has occurred. Retry your request, but if the problem persists, contact us with details by posting a question on re:Post.

ValidationException:

The input fails to satisfy the constraints specified by an Amazon Web Services service.

Examples

Example 1: List all available workloads supported by AWS Launch Wizard. 
$result = $client->listWorkloads([
]);

Result syntax:

[
    'workloads' => [
        [
            'displayName' => 'SAP',
            'status' => 'ACTIVE',
            'workloadName' => 'SAP',
        ],
        [
            'displayName' => 'MS SQL Server',
            'status' => 'ACTIVE',
            'workloadName' => 'SQL',
        ],
    ],
]

TagResource 

$result = $client->tagResource([/* ... */]);
$promise = $client->tagResourceAsync([/* ... */]);

Adds the specified tags to the given resource.

Parameter Syntax

$result = $client->tagResource([
    'resourceArn' => '<string>', // REQUIRED
    'tags' => ['<string>', ...], // REQUIRED
]);

Parameter Details

Members
resourceArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the resource.

tags
Required: Yes
Type: Associative array of custom strings keys (TagKey) to strings

One or more tags to attach to the resource.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

InternalServerException:

An internal error has occurred. Retry your request, but if the problem persists, contact us with details by posting a question on re:Post.

ValidationException:

The input fails to satisfy the constraints specified by an Amazon Web Services service.

ResourceNotFoundException:

The specified workload or deployment resource can't be found.

Examples

Example 1: Adding tags to a Launch Wizard deployment resource. 
$result = $client->tagResource([
    'resourceArn' => 'arn:aws:launchwizard:us-east-1:123456789012:deployment/11111111-1111-1111-1111-111111111111',
    'tags' => [
        'key1' => 'value1',
        'key2' => 'value2',
    ],
]);

Result syntax:

[
]

UntagResource 

$result = $client->untagResource([/* ... */]);
$promise = $client->untagResourceAsync([/* ... */]);

Removes the specified tags from the given resource.

Parameter Syntax

$result = $client->untagResource([
    'resourceArn' => '<string>', // REQUIRED
    'tagKeys' => ['<string>', ...], // REQUIRED
]);

Parameter Details

Members
resourceArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the resource.

tagKeys
Required: Yes
Type: Array of strings

Keys identifying the tags to remove.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

InternalServerException:

An internal error has occurred. Retry your request, but if the problem persists, contact us with details by posting a question on re:Post.

ValidationException:

The input fails to satisfy the constraints specified by an Amazon Web Services service.

ResourceNotFoundException:

The specified workload or deployment resource can't be found.

Examples

Example 1: Removing tags on a Launch Wizard deployment resource. 
$result = $client->untagResource([
    'resourceArn' => 'arn:aws:launchwizard:us-east-1:123456789012:deployment/11111111-1111-1111-1111-111111111111',
    'tagKeys' => [
        'key1',
        'key2',
    ],
]);

Result syntax:

[
]

UpdateDeployment 

$result = $client->updateDeployment([/* ... */]);
$promise = $client->updateDeploymentAsync([/* ... */]);

Updates a deployment.

Parameter Syntax

$result = $client->updateDeployment([
    'deploymentId' => '<string>', // REQUIRED
    'deploymentPatternVersionName' => '<string>',
    'dryRun' => true || false,
    'force' => true || false,
    'specifications' => ['<string>', ...], // REQUIRED
    'workloadVersionName' => '<string>',
]);

Parameter Details

Members
deploymentId
Required: Yes
Type: string

The ID of the deployment.

deploymentPatternVersionName
Type: string

The name of the deployment pattern version.

dryRun
Type: boolean

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

force
Type: boolean

Forces the update even if validation warnings are present.

specifications
Required: Yes
Type: Associative array of custom strings keys (KeyString) to strings

The settings specified for the deployment. These settings define how to deploy and configure your resources created by the deployment. For more information about the specifications required for creating a deployment for a SAP workload, see SAP deployment specifications. To retrieve the specifications required to create a deployment for other workloads, use the GetWorkloadDeploymentPattern operation.

workloadVersionName
Type: string

The name of the workload version.

Result Syntax

[
    'deployment' => [
        'createdAt' => <DateTime>,
        'id' => '<string>',
        'modifiedAt' => <DateTime>,
        'name' => '<string>',
        'patternName' => '<string>',
        'status' => 'COMPLETED|CREATING|DELETE_IN_PROGRESS|DELETE_INITIATING|DELETE_FAILED|DELETED|FAILED|IN_PROGRESS|VALIDATING|UPDATE_IN_PROGRESS|UPDATE_COMPLETED|UPDATE_FAILED|UPDATE_ROLLBACK_COMPLETED|UPDATE_ROLLBACK_FAILED',
        'workloadName' => '<string>',
    ],
]

Result Details

Members
deployment
Type: DeploymentDataSummary structure

The deployment.

Errors

ResourceLimitException:

You have exceeded an Launch Wizard resource limit. For example, you might have too many deployments in progress.

InternalServerException:

An internal error has occurred. Retry your request, but if the problem persists, contact us with details by posting a question on re:Post.

ValidationException:

The input fails to satisfy the constraints specified by an Amazon Web Services service.

ResourceNotFoundException:

The specified workload or deployment resource can't be found.

Examples

Example 1: Edit deployment specifications. 
$result = $client->updateDeployment([
    'deploymentId' => '4c1b59c1-659c-467f-b6e9-6ef6f9d28e1d',
    'dryRun' => ,
    'specifications' => [
        'CreateSecurityGroup' => 'No',
        'DeploymentArtifactsS3Uri' => 'aws-bucket-name',
        'DisableDeploymentRollback' => 'No',
        'EnableEbsVolumeEncryption' => 'No',
        'KeyPairName' => 'keyName',
        'ProxyServerAddress' => 'http://mno.abc.com:8080',
        'SapSysGroupId' => '5003',
        'SapVirtualIPOptIn' => 'No',
        'SaveDeploymentArtifacts' => 'Yes',
        'SnsTopicArn' => 'arn:aws:sns:us-east-1:111111222222:snsNameUsEast1.fifo',
        'Timezone' => 'Pacific/Wake',
        'VpcId' => 'vpc-1234567',
    ],
]);

Result syntax:

[
    'deployment' => [
        'name' => 'TestDeployment1',
        'createdAt' => ,
        'id' => '4c1b59c1-659c-467f-b6e9-6ef6f9d28e1d',
        'patternName' => 'SapHanaSingle',
        'status' => 'UPDATE_IN_PROGRESS',
        'workloadName' => 'SAP',
    ],
]
Example 2: Update deployment version. 
$result = $client->updateDeployment([
    'deploymentId' => '4c1b59c1-659c-467f-b6e9-6ef6f9d28e1d',
    'deploymentPatternVersionName' => '2.0.0',
    'dryRun' => ,
    'specifications' => [
        'CreateSecurityGroup' => 'No',
        'DeploymentArtifactsS3Uri' => 'aws-bucket-name',
        'DisableDeploymentRollback' => 'No',
        'EnableEbsVolumeEncryption' => 'No',
        'KeyPairName' => 'keyName',
        'NewParameter' => 'Allow',
        'ProxyServerAddress' => 'http://mno.abc.com:8080',
        'SapSysGroupId' => '5003',
        'SapVirtualIPOptIn' => 'No',
        'SaveDeploymentArtifacts' => 'Yes',
        'SnsTopicArn' => 'arn:aws:sns:us-east-1:111111222222:snsNameUsEast1.fifo',
        'Timezone' => 'Pacific/Wake',
        'VpcId' => 'vpc-1234567',
    ],
]);

Result syntax:

[
    'deployment' => [
        'name' => 'TestDeployment1',
        'createdAt' => ,
        'id' => '4c1b59c1-659c-467f-b6e9-6ef6f9d28e1d',
        'patternName' => 'SapHanaSingle',
        'status' => 'UPDATE_IN_PROGRESS',
        'workloadName' => 'SAP',
    ],
]

Shapes

DeploymentConditionalField

Description

A field that details a condition of the specifications for a deployment.

Members
comparator
Type: string

The comparator of the condition.

Valid values: Equal | NotEqual

name
Type: string

The name of the deployment condition.

value
Type: string

The value of the condition.

DeploymentData

Description

The data associated with a deployment.

Members
createdAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The time the deployment was created.

deletedAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The time the deployment was deleted.

deploymentArn
Type: string

The Amazon Resource Name (ARN) of the deployment.

id
Type: string

The ID of the deployment.

modifiedAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The time the deployment was last modified.

name
Type: string

The name of the deployment.

patternName
Type: string

The pattern name of the deployment.

resourceGroup
Type: string

The resource group of the deployment.

specifications
Type: Associative array of custom strings keys (KeyString) to strings

The settings specified for the deployment. These settings define how to deploy and configure your resources created by the deployment. For more information about the specifications required for creating a deployment for a SAP workload, see SAP deployment specifications. To retrieve the specifications required to create a deployment for other workloads, use the GetWorkloadDeploymentPattern operation.

status
Type: string

The status of the deployment.

tags
Type: Associative array of custom strings keys (TagKey) to strings

Information about the tags attached to a deployment.

workloadName
Type: string

The name of the workload.

DeploymentDataSummary

Description

A summary of the deployment data.

Members
createdAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The time the deployment was created.

id
Type: string

The ID of the deployment.

modifiedAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The time the deployment was last modified.

name
Type: string

The name of the deployment

patternName
Type: string

The name of the workload deployment pattern.

status
Type: string

The status of the deployment.

workloadName
Type: string

The name of the workload.

DeploymentEventDataSummary

Description

A summary of the deployment event data.

Members
description
Type: string

The description of the deployment event.

name
Type: string

The name of the deployment event.

status
Type: string

The status of the deployment event.

statusReason
Type: string

The reason of the deployment event status.

timestamp
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp of the deployment event.

DeploymentFilter

Description

A filter name and value pair that is used to return more specific results from a describe operation. Filters can be used to match a set of resources by specific criteria.

Members
name
Type: string

The name of the filter. Filter names are case-sensitive.

values
Type: Array of strings

The filter values. Filter values are case-sensitive. If you specify multiple values for a filter, the values are joined with an OR, and the request returns all results that match any of the specified values.

DeploymentPatternVersionDataSummary

Description

Describes a deployment pattern version summary.

Members
deploymentPatternName
Type: string

The name of the deployment pattern.

deploymentPatternVersionName
Type: string

The name of the deployment pattern version.

description
Type: string

The description of the deployment pattern version.

documentationUrl
Type: string

The URL of the documentation for the deployment pattern version.

workloadName
Type: string

The name of the workload.

DeploymentPatternVersionFilter

Description

A filter for deployment pattern versions. Use this filter to specify criteria for querying deployment pattern versions in Launch Wizard.

Members
name
Required: Yes
Type: string

The name of the filter attribute. Specifies which attribute to filter on when querying deployment pattern versions.

values
Required: Yes
Type: Array of strings

The values to filter by. Contains the specific values to match against when filtering deployment pattern versions.

DeploymentSpecificationsField

Description

A field that details a specification of a deployment pattern.

Members
allowedValues
Type: Array of strings

The allowed values of the deployment specification.

conditionals
Type: Array of DeploymentConditionalField structures

The conditionals used for the deployment specification.

description
Type: string

The description of the deployment specification.

name
Type: string

The name of the deployment specification.

required
Type: string

Indicates if the deployment specification is required.

InternalServerException

Description

An internal error has occurred. Retry your request, but if the problem persists, contact us with details by posting a question on re:Post.

Members
message
Type: string

ResourceLimitException

Description

You have exceeded an Launch Wizard resource limit. For example, you might have too many deployments in progress.

Members
message
Type: string

ResourceNotFoundException

Description

The specified workload or deployment resource can't be found.

Members
message
Type: string

ValidationException

Description

The input fails to satisfy the constraints specified by an Amazon Web Services service.

Members
message
Type: string

WorkloadData

Description

Describes a workload.

Members
description
Type: string

The description of a workload.

displayName
Type: string

The display name of a workload.

documentationUrl
Type: string

The URL of a workload document.

iconUrl
Type: string

The URL of a workload icon.

status
Type: string

The status of a workload.

You can list deployments in the DISABLED status.

statusMessage
Type: string

The message about a workload's status.

workloadName
Type: string

The name of the workload.

WorkloadDataSummary

Description

Describes workload data.

Members
displayName
Type: string

The display name of the workload data.

status
Type: string

The status of the workload.

workloadName
Type: string

The name of the workload.

WorkloadDeploymentPatternData

Description

The data that details a workload deployment pattern.

Members
deploymentPatternName
Type: string

The name of the deployment pattern.

deploymentPatternVersionName
Type: string

The version name of the deployment pattern.

description
Type: string

The description of the deployment pattern.

displayName
Type: string

The display name of the deployment pattern.

specifications
Type: Array of DeploymentSpecificationsField structures

The settings specified for the deployment. These settings define how to deploy and configure your resources created by the deployment. For more information about the specifications required for creating a deployment for a SAP workload, see SAP deployment specifications. To retrieve the specifications required to create a deployment for other workloads, use the GetWorkloadDeploymentPattern operation.

status
Type: string

The status of the deployment pattern.

statusMessage
Type: string

The status message of the deployment pattern.

workloadName
Type: string

The workload name of the deployment pattern.

workloadVersionName
Type: string

The workload version name of the deployment pattern.

WorkloadDeploymentPatternDataSummary

Description

Describes a workload deployment pattern.

Members
deploymentPatternName
Type: string

The name of a workload deployment pattern.

deploymentPatternVersionName
Type: string

The version name of a workload deployment pattern.

description
Type: string

The description of a workload deployment pattern.

displayName
Type: string

The display name of a workload deployment pattern.

status
Type: string

The status of a workload deployment pattern.

statusMessage
Type: string

A message about a workload deployment pattern's status.

workloadName
Type: string

The name of the workload.

workloadVersionName
Type: string

The name of the workload deployment pattern version.