DescribeContact
Describes an existing contact.
Request Syntax
GET /contact/contactId HTTP/1.1
URI Request Parameters
The request uses the following URI parameters.
- contactId
-
UUID of a contact.
Required: Yes
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:
