You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/orbital/concepts-contact.md
+13-29Lines changed: 13 additions & 29 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -12,9 +12,9 @@ ms.author: hrshelar
12
12
13
13
# Ground station contact resource
14
14
15
-
A contact occurs when the spacecraft passes over a specified ground station. You can find available passes and schedule contacts for your spacecraft through the Azure Orbital Ground Station platform. A contact and ground station pass mean the same thing.
15
+
To establish connectivity with your spacecraft, schedule and execute a contact on a ground station. A contact, sometimes called a ground station 'pass,' can only occur when the spacecraft passes over a specified ground station while orbiting. You can find available contact opportunities and schedule contacts for your spacecraft through the Azure Orbital Ground Station [API](/rest/api/orbital/) or [Azure portal](https://aka.ms/orbital/portal).
16
16
17
-
When you schedule a contact for a spacecraft, a contact resource is created under your spacecraft resource in your resource group. The contact is only associated with that particular spacecraft and can't be transferred to another spacecraft, resource group, or region.
17
+
Contacts are scheduled for a particular combination of a [spacecraft](spacecraft-object.md) and [contact profile](concepts-contact-profile.md). When you schedule a contact for a spacecraft, a contact resource is created under your spacecraft resource in your Azure resource group. The contact is only associated with that particular spacecraft and can't be transferred to another spacecraft, resource group, or region.
18
18
19
19
## Contact parameters
20
20
@@ -36,47 +36,31 @@ The contact resource contains the start time and end time of the pass and other
36
36
37
37
The RX and TX start/end times might differ depending on the individual station masks. Billing meters are engaged between the Reservation Start Time and Reservation End Time.
38
38
39
-
## Create a contact
39
+
## Schedule a contact
40
40
41
-
In order to create a contact, you must have the following prerequisites:
42
-
- An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
43
-
- An [authorized](register-spacecraft.md) spacecraft resource.
44
-
- A [contact profile](contact-profile.md) with links in accordance with the spacecraft resource above.
45
-
46
-
Contacts are created on a per-pass and per-site basis. If you already know the pass timings for your spacecraft and desired ground station, you can directly proceed to schedule the pass with these times. The service will succeed in creating the contact resource if the window is available and fail if the window is unavailable.
47
-
48
-
If you don't know your spacecraft's pass timings or which ground station sites are available, you can use the [Azure portal](https://aka.ms/orbital/portal) or [Azure Orbital Ground Station API](/rest/api/orbital/) to determine those details. Query the available passes and use the results to schedule your passes accordingly.
49
-
50
-
| Method | List available contacts | Schedule contacts | Notes |
51
-
|-|-|-|-|
52
-
|Portal| Yes | Yes | Custom pass timings aren't supported. You must use the results from the query. |
See [how-to schedule a contact](schedule-contact.md) for instructions to use the Azure portal. See [API documentation](/rest/api/orbital/) for instructions to use the Azure Orbital Ground Station API.
41
+
Use the [Azure portal](https://aka.ms/orbital/portal) or [Azure Orbital Ground Station API](/rest/api/orbital/) to [create a contact resource](schedule-contact.md) for your spacecraft resource.
56
42
57
43
## Cancel a scheduled contact
58
44
59
-
In order to cancel a scheduled contact, you must delete the contact resource. You must have the following prerequisites:
60
-
61
-
- An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
62
-
- An [authorized](register-spacecraft.md) spacecraft resource.
63
-
- A [contact profile](contact-profile.md) with links in accordance with the spacecraft resource above.
64
-
- A [scheduled contact](schedule-contact.md).
45
+
In order to cancel a scheduled contact, you must delete the contact resource.
65
46
47
+
To delete a contact resource via the [Azure portal](https://aka.ms/orbital/portal):
66
48
1. In the Azure portal search box, enter **Spacecraft**. Select **Spacecraft** in the search results.
67
-
2. In the **Spacecraft** page, select the name of the spacecraft for the scheduled contact.
68
-
3.Select**Contacts** from the left menu bar in the spacecraft’s overview page.
49
+
2. In the **Spacecraft** page, click the spacecraft associated with the scheduled contact.
50
+
3.Click**Contacts** from the left menu bar in the spacecraft’s overview page.
69
51
70
52
:::image type="content" source="media/orbital-eos-delete-contact.png" alt-text="Select a scheduled contact" lightbox="media/orbital-eos-delete-contact.png":::
71
53
72
-
4.Select the name of the contact to be deleted
73
-
5.Select**Delete** from the top bar of the contact's configuration view
54
+
4.Click the contact to be deleted.
55
+
5.Click**Delete** from the top bar of the contact's configuration view.
74
56
75
57
:::image type="content" source="media/orbital-eos-contact-config-view.png" alt-text="Delete a scheduled contact" lightbox="media/orbital-eos-contact-config-view.png":::
76
58
77
59
6. The scheduled contact will be canceled once the contact entry is deleted.
78
60
61
+
Alternatively, use the Contacts REST Operation Group to [delete a contact](/rest/api/orbital/azureorbitalgroundstation/contacts/delete/) with the Azure Orbital Ground Station API.
0 commit comments