PutSourceServerAction - ApplicationMigrationService
Request SyntaxURI Request ParametersRequest BodyResponse SyntaxResponse ElementsErrorsSee Also

PutSourceServerAction

Put source server post migration custom action.

Request Syntax

POST /PutSourceServerAction HTTP/1.1
Content-type: application/json

{
   "accountID": "string",
   "actionID": "string",
   "actionName": "string",
   "active": boolean,
   "category": "string",
   "description": "string",
   "documentIdentifier": "string",
   "documentVersion": "string",
   "externalParameters": { 
      "string" : { ... }
   },
   "mustSucceedForCutover": boolean,
   "order": number,
   "parameters": { 
      "string" : [ 
         { 
            "parameterName": "string",
            "parameterType": "string"
         }
      ]
   },
   "sourceServerID": "string",
   "timeoutSeconds": number
}

URI Request Parameters

The request does not use any URI parameters.

Request Body

The request accepts the following data in JSON format.

accountID

Source server post migration custom account ID.

Type: String

Length Constraints: Fixed length of 12.

Pattern: .*[0-9]{12,}.*

Required: No

actionID

Source server post migration custom action ID.

Type: String

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

Pattern: .*[0-9a-zA-Z]

Required: Yes

actionName

Source server post migration custom action name.

Type: String

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

Pattern: [^\s\x00]( *[^\s\x00])*

Required: Yes

active

Source server post migration custom action active status.

Type: Boolean

Required: No

category

Source server post migration custom action category.

Type: String

Valid Values: DISASTER_RECOVERY | OPERATING_SYSTEM | LICENSE_AND_SUBSCRIPTION | VALIDATION | OBSERVABILITY | REFACTORING | SECURITY | NETWORKING | CONFIGURATION | BACKUP | OTHER

Required: No

description

Source server post migration custom action description.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 256.

Pattern: [0-9a-zA-Z ():/.,'-_#*; ]*

Required: No

documentIdentifier

Source server post migration custom action document identifier.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 256.

Required: Yes

documentVersion

Source server post migration custom action document version.

Type: String

Pattern: (\$DEFAULT|\$LATEST|[0-9]+)

Required: No

externalParameters

Source server post migration custom action external parameters.

Type: String to SsmExternalParameter object map

Map Entries: Minimum number of 0 items. Maximum number of 20 items.

Key Length Constraints: Minimum length of 1. Maximum length of 1011.

Key Pattern: ([A-Za-z0-9])+

Required: No

mustSucceedForCutover

Source server post migration custom action must succeed for cutover.

Type: Boolean

Required: No

order

Source server post migration custom action order.

Type: Integer

Valid Range: Minimum value of 1001. Maximum value of 10000.

Required: Yes

parameters

Source server post migration custom action parameters.

Type: String to array of SsmParameterStoreParameter objects map

Map Entries: Minimum number of 0 items. Maximum number of 20 items.

Key Length Constraints: Minimum length of 1. Maximum length of 1011.

Key Pattern: ([A-Za-z0-9])+

Array Members: Minimum number of 0 items. Maximum number of 10 items.

Required: No

sourceServerID

Source server ID.

Type: String

Length Constraints: Fixed length of 19.

Pattern: s-[0-9a-zA-Z]{17}

Required: Yes

timeoutSeconds

Source server post migration custom action timeout in seconds.

Type: Integer

Valid Range: Minimum value of 1.

Required: No

Response Syntax

HTTP/1.1 200
Content-type: application/json

{
   "actionID": "string",
   "actionName": "string",
   "active": boolean,
   "category": "string",
   "description": "string",
   "documentIdentifier": "string",
   "documentVersion": "string",
   "externalParameters": { 
      "string" : { ... }
   },
   "mustSucceedForCutover": boolean,
   "order": number,
   "parameters": { 
      "string" : [ 
         { 
            "parameterName": "string",
            "parameterType": "string"
         }
      ]
   },
   "timeoutSeconds": number
}

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.

actionID

Source server post migration custom action ID.

Type: String

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

Pattern: .*[0-9a-zA-Z]

actionName

Source server post migration custom action name.

Type: String

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

Pattern: [^\s\x00]( *[^\s\x00])*

active

Source server post migration custom action active status.

Type: Boolean

category

Source server post migration custom action category.

Type: String

Valid Values: DISASTER_RECOVERY | OPERATING_SYSTEM | LICENSE_AND_SUBSCRIPTION | VALIDATION | OBSERVABILITY | REFACTORING | SECURITY | NETWORKING | CONFIGURATION | BACKUP | OTHER

description

Source server post migration custom action description.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 256.

Pattern: [0-9a-zA-Z ():/.,'-_#*; ]*

documentIdentifier

Source server post migration custom action document identifier.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 256.

documentVersion

Source server post migration custom action document version.

Type: String

Pattern: (\$DEFAULT|\$LATEST|[0-9]+)

externalParameters

Source server post migration custom action external parameters.

Type: String to SsmExternalParameter object map

Map Entries: Minimum number of 0 items. Maximum number of 20 items.

Key Length Constraints: Minimum length of 1. Maximum length of 1011.

Key Pattern: ([A-Za-z0-9])+

mustSucceedForCutover

Source server post migration custom action must succeed for cutover.

Type: Boolean

order

Source server post migration custom action order.

Type: Integer

Valid Range: Minimum value of 1001. Maximum value of 10000.

parameters

Source server post migration custom action parameters.

Type: String to array of SsmParameterStoreParameter objects map

Map Entries: Minimum number of 0 items. Maximum number of 20 items.

Key Length Constraints: Minimum length of 1. Maximum length of 1011.

Key Pattern: ([A-Za-z0-9])+

Array Members: Minimum number of 0 items. Maximum number of 10 items.

timeoutSeconds

Source server post migration custom action timeout in seconds.

Type: Integer

Valid Range: Minimum value of 1.

Errors

For information about the errors that are common to all actions, see Common Errors.

ConflictException

The request could not be completed due to a conflict with the current state of the target resource.

errors

Conflict Exception specific errors.

resourceId

A conflict occurred when prompting for the Resource ID.

resourceType

A conflict occurred when prompting for resource type.

HTTP Status Code: 409

ResourceNotFoundException

Resource not found exception.

resourceId

Resource ID not found error.

resourceType

Resource type not found error.

HTTP Status Code: 404

UninitializedAccountException

Uninitialized account exception.

HTTP Status Code: 400

ValidationException

Validate exception.

fieldList

Validate exception field list.

reason

Validate exception reason.

HTTP Status Code: 400

See Also

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