DescribeContact - AWS Ground Station
Request SyntaxURI Request ParametersRequest BodyResponse SyntaxResponse ElementsErrorsSee Also

DescribeContact

Describes an existing contact.

Request Syntax

GET /contact/contactId HTTP/1.1

URI Request Parameters

The request requires the following URI parameters.

contactId

UUID of a contact.

Request Body

The request does not have a request body.

Response Syntax

HTTP/1.1 200
Content-type: application/json

{
   "contactId": "string",
   "contactStatus": "string",
   "endTime": number,
   "errorMessage": "string",
   "groundStation": "string",
   "maximumElevation": { 
      "unit": "string",
      "value": number
   },
   "missionProfileArn": "string",
   "postPassEndTime": number,
   "prePassStartTime": number,
   "region": "string",
   "satelliteArn": "string",
   "startTime": number,
   "tags": { 
      "string" : "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.

contactId

UUID of a contact.

Type: String

contactStatus

Status of a contact.

Type: String

Valid Values: AVAILABLE | AWS_CANCELLED | CANCELLED | CANCELLING | COMPLETED | FAILED | FAILED_TO_SCHEDULE | PASS | POSTPASS | PREPASS | SCHEDULED | SCHEDULING

endTime

End time of a contact.

Type: Timestamp

errorMessage

Error message for a contact.

Type: String

groundStation

Ground station for a contact.

Type: String

maximumElevation

Maximum elevation angle of a contact.

Type: Elevation object

missionProfileArn

ARN of a mission profile.

Type: String

postPassEndTime

Amount of time after a contact ends that you’d like to receive a CloudWatch event indicating the pass has finished.

Type: Timestamp

prePassStartTime

Amount of time prior to contact start you’d like to receive a CloudWatch event indicating an upcoming pass.

Type: Timestamp

region

Region of a contact.

Type: String

satelliteArn

ARN of a satellite.

Type: String

startTime

Start time of a contact.

Type: Timestamp

tags

Tags assigned to a contact.

Type: String to string map

Errors

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

DependencyException

Dependency encountered an error.

HTTP Status Code: 531

InvalidParameterException

One or more parameters are not valid.

HTTP Status Code: 431

ResourceNotFoundException

Resource was not found.

HTTP Status Code: 434

See Also

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