Request Syntax URI Request Parameters Request Body Response Syntax Response Elements Errors See Also

UpdateContact

Updates a specific contact.

Request Syntax


POST /contact/contactId/versions HTTP/1.1
Content-type: application/json

{
   "clientToken": "string",
   "satelliteArn": "string",
   "trackingOverrides": { 
      "programTrackSettings": { ... }
   }
}

URI Request Parameters

The request uses the following URI parameters.

contactId

UUID of a contact.

Length Constraints: Fixed length of 36.

Pattern: [a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}

Required: Yes

Request Body

The request accepts the following data in JSON format.

clientToken

A client token is a unique, case-sensitive string of up to 64 ASCII characters. It is generated by the client to ensure idempotent operations, allowing safe retries without unintended side effects.

Type: String

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

Pattern: [!-~]{1,64}

Required: No

satelliteArn

ARN of a satellite.

Type: String

Length Constraints: Minimum length of 82. Maximum length of 132.

Pattern: arn:aws:groundstation:([-a-z0-9]{1,50})?:[0-9]{12}:satellite/[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}

Required: No

trackingOverrides

Overrides the default tracking configuration on an antenna during a contact.

Type: TrackingOverrides object

Required: No

Response Syntax


HTTP/1.1 200
Content-type: application/json

{
   "contactId": "string",
   "versionId": 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.

contactId

UUID of a contact.

Type: String

Length Constraints: Fixed length of 36.

Pattern: [a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}

versionId

Version ID of a contact.

Type: Integer

Valid Range: Minimum value of 1. Maximum value of 128.

Errors

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

DependencyException

Dependency encountered an error.

parameterName: Name of the parameter that caused the exception.

HTTP Status Code: 531

InvalidParameterException

One or more parameters are not valid.

parameterName: Name of the invalid parameter.

HTTP Status Code: 431

ResourceLimitExceededException

Account limits for this resource have been exceeded.

parameterName: Name of the parameter that exceeded the resource limit.

HTTP Status Code: 429

ResourceNotFoundException

Resource was not found.

HTTP Status Code: 434