Spacecrafts - List Available Contacts
Devuelve la lista de contactos disponibles. Hay disponible un contacto si la nave espacial es visible desde la estación terrestre durante más de la duración mínima viable de contacto proporcionada en el perfil de contacto.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Orbital/spacecrafts/{spacecraftName}/listAvailableContacts?api-version=2022-11-01
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
resource
|
path | True |
string |
Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas. |
spacecraft
|
path | True |
string |
Id. de nave espacial. |
subscription
|
path | True |
string |
Identificador de la suscripción de destino. |
api-version
|
query | True |
string |
Versión de API que se usará para la operación. |
Cuerpo de la solicitud
Nombre | Requerido | Tipo | Description |
---|---|---|---|
contactProfile | True |
Referencia al recurso de perfil de contacto. |
|
endTime | True |
string |
Hora de finalización de un contacto (estándar UTC ISO 8601). |
groundStationName | True |
string |
Nombre de la estación terrestre de Azure. |
startTime | True |
string |
Hora de inicio de un contacto (estándar ISO 8601 UTC). |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
Solicitud correcta. La operación devuelve una lista de recursos de contactos disponibles. |
|
202 Accepted |
Aceptado y la operación se completará de forma asincrónica. Encabezados Location: string |
|
Other Status Codes |
Respuesta de error que describe el motivo del error de la operación. Si el grupo de recursos no existe, se devolverá 404 (NotFound). |
Ejemplos
List of Contact
Solicitud de ejemplo
POST https://management.azure.com/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.Orbital/spacecrafts/CONTOSO_SAT/listAvailableContacts?api-version=2022-11-01
{
"contactProfile": {
"id": "/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.Orbital/contactProfiles/CONTOSO-CP"
},
"groundStationName": "EASTUS2_0",
"startTime": "2022-11-01T11:30:00Z",
"endTime": "2022-11-02T11:30:00Z"
}
Respuesta de muestra
Location: https://management.azure.com/Microsoft.Orbital/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2022-11-01
{
"value": [
{
"spacecraft": {
"id": "/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.Orbital/spacecrafts/CONTOSO_SAT"
},
"groundStationName": "EASTUS2_0",
"properties": {
"maximumElevationDegrees": 26.617297,
"txStartTime": "2022-11-01T11:55:01Z",
"txEndTime": "2022-11-01T12:05:25Z",
"rxStartTime": "2022-11-01T11:55:01Z",
"rxEndTime": "2022-11-01T12:05:25Z",
"startAzimuthDegrees": 201.340472,
"endAzimuthDegrees": 330.489627,
"startElevationDegrees": 5,
"endElevationDegrees": 5.040625
}
},
{
"spacecraft": {
"id": "/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.Orbital/spacecrafts/CONTOSO_SAT"
},
"groundStationName": "EASTUS2_0",
"properties": {
"maximumElevationDegrees": 85.9796,
"txStartTime": "2022-11-02T10:58:30Z",
"txEndTime": "2022-11-02T11:10:45Z",
"rxStartTime": "2022-11-02T10:58:30Z",
"rxEndTime": "2022-11-02T11:10:45Z",
"startAzimuthDegrees": 165.758896,
"endAzimuthDegrees": 345.848482,
"startElevationDegrees": 5,
"endElevationDegrees": 5.048656
}
}
],
"nextLink": "https://management.azure.com/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.Orbital/spacecrafts/CONTOSO_SAT/listAvailableContacts?api-version=2022-11-01&$skiptoken=opaqueString"
}
Definiciones
Nombre | Description |
---|---|
Authorized |
Estación terrestre autorizada. |
Auto |
Configuración de seguimiento automático. |
Available |
El cliente recupera la lista de contactos disponibles para un recurso de nave espacial. Más adelante, se puede seleccionar uno de los contactos disponibles para crear un contacto. |
Available |
Respuesta para la llamada al servicio api ListAvailableContacts. |
Contact |
Parámetros que definen el recurso de contacto. |
Contact |
Referencia al recurso de perfil de contacto. |
Contact |
El cliente crea un recurso de perfil de contacto, que contendrá todas las configuraciones necesarias para programar un contacto. |
Contact |
Vínculo de perfil de contacto. |
Contact |
Canal de vínculo de perfil de contacto. |
Contact |
Estado actual de la creación, eliminación o modificación del recurso. |
Contact |
Configuración de asociados de terceros de perfil de contacto. |
created |
Tipo de identidad que creó el recurso. |
direction |
Dirección (vínculo superior o vínculo descendente). |
End |
Punto final del cliente para almacenar y recuperar datos durante un contacto con la nave espacial. |
Error |
Información adicional sobre el error de administración de recursos. |
Error |
Detalle del error. |
Error |
Respuesta de error |
Network |
Configuración de red de la red virtual del cliente. |
polarization |
Polarización. Por ejemplo, (RHCP, LHCP). |
protocol |
Protocolo UDP o TCP. |
Provisioning |
Estado actual de la creación, eliminación o modificación del recurso. |
Spacecraft |
El cliente crea un recurso de nave espacial para programar un contacto. |
Spacecraft |
Lista de enlaces de naves espaciales autorizadas por estación terrestre y la fecha de expiración de la autorización. |
system |
Metadatos relacionados con la creación y la última modificación del recurso. |
AuthorizedGroundstation
Estación terrestre autorizada.
Nombre | Tipo | Description |
---|---|---|
expirationDate |
string |
Fecha de expiración de la autorización. |
groundStation |
string |
Nombre de la estación de tierra. |
AutoTrackingConfiguration
Configuración de seguimiento automático.
Nombre | Tipo | Description |
---|---|---|
disabled |
string |
|
sBand |
string |
|
xBand |
string |
AvailableContacts
El cliente recupera la lista de contactos disponibles para un recurso de nave espacial. Más adelante, se puede seleccionar uno de los contactos disponibles para crear un contacto.
Nombre | Tipo | Description |
---|---|---|
groundStationName |
string |
Nombre de la estación terrestre de Azure. |
properties.endAzimuthDegrees |
number |
Azimuth de la antena al final del contacto en grados decimales. |
properties.endElevationDegrees |
number |
Elevación de la nave espacial por encima del horizonte al final del contacto. |
properties.maximumElevationDegrees |
number |
Elevación máxima de la antena durante el contacto en grados decimales. |
properties.rxEndTime |
string |
Tiempo para perder la recepción de una señal (estándar UTC ISO 8601). |
properties.rxStartTime |
string |
La primera vez que reciba una señal (estándar ISO 8601 UTC). |
properties.startAzimuthDegrees |
number |
Azimuth de la antena al principio del contacto en grados decimales. |
properties.startElevationDegrees |
number |
Elevación de la nave espacial por encima del horizonte en el inicio del contacto. |
properties.txEndTime |
string |
Hora a la que se deshabilitará la transmisión de antena (estándar ISO 8601 UTC). |
properties.txStartTime |
string |
Hora a la que se habilitará la transmisión de antena (estándar ISO 8601 UTC). |
spacecraft |
Referencia al recurso de la nave espacial. |
AvailableContactsListResult
Respuesta para la llamada al servicio api ListAvailableContacts.
Nombre | Tipo | Description |
---|---|---|
nextLink |
string |
Dirección URL para obtener el siguiente conjunto de resultados. |
value |
Una lista de contactos disponibles. |
ContactParameters
Parámetros que definen el recurso de contacto.
Nombre | Tipo | Description |
---|---|---|
contactProfile |
Referencia al recurso de perfil de contacto. |
|
endTime |
string |
Hora de finalización de un contacto (estándar UTC ISO 8601). |
groundStationName |
string |
Nombre de la estación terrestre de Azure. |
startTime |
string |
Hora de inicio de un contacto (estándar ISO 8601 UTC). |
ContactParameters.ContactProfile
Referencia al recurso de perfil de contacto.
Nombre | Tipo | Description |
---|---|---|
id |
string |
Identificador del recurso. |
ContactProfile
El cliente crea un recurso de perfil de contacto, que contendrá todas las configuraciones necesarias para programar un contacto.
Nombre | Tipo | Description |
---|---|---|
id |
string |
Identificador de recurso completo del recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
location |
string |
Ubicación geográfica donde reside el recurso |
name |
string |
Nombre del recurso. |
properties.autoTrackingConfiguration |
Configuración de seguimiento automático. |
|
properties.eventHubUri |
string |
Identificador de recursos de ARM del centro de eventos usado para la telemetría. Requiere conceder al proveedor de recursos orbitales los derechos para enviar telemetría al centro. |
properties.links |
Vínculos del perfil de contacto. Describe los vínculos de RF, el procesamiento de módems y los puntos de conexión IP. |
|
properties.minimumElevationDegrees |
number |
Elevación mínima viable para el contacto en grados decimales. Se utiliza para enumerar los contactos disponibles con una nave espacial en una estación terrestre determinada. |
properties.minimumViableContactDuration |
string |
Duración mínima viable del contacto en formato ISO 8601. Se utiliza para enumerar los contactos disponibles con una nave espacial en una estación terrestre determinada. |
properties.networkConfiguration |
Configuración de red de la red virtual del cliente. |
|
properties.provisioningState |
Estado actual de la creación, eliminación o modificación del recurso. |
|
properties.thirdPartyConfigurations |
Configuración de misión de terceros del perfil de contacto. Describe los vínculos de RF, el procesamiento de módems y los puntos de conexión IP. |
|
systemData |
Metadatos de Azure Resource Manager que contienen información sobre los valores de createdBy y modifiedBy. |
|
tags |
object |
Etiquetas del recurso. |
type |
string |
Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts" |
ContactProfileLink
Vínculo de perfil de contacto.
Nombre | Tipo | Description |
---|---|---|
channels |
Canal de vínculo de perfil de contacto. |
|
direction |
Dirección (vínculo superior o vínculo descendente). |
|
eirpdBW |
number |
Potencia radiada isotrópica efectiva (EIRP) en dBW. Es el EIRP requerido por el cliente. Todavía no se ha usado. |
gainOverTemperature |
number |
Aumento de la temperatura de ruido en db/K. Es el G/T requerido por el cliente. Todavía no se ha usado. |
name |
string |
Nombre del vínculo. |
polarization |
Polarización. Por ejemplo, (RHCP, LHCP). |
ContactProfileLinkChannel
Canal de vínculo de perfil de contacto.
Nombre | Tipo | Description |
---|---|---|
bandwidthMHz |
number |
Ancho de banda en MHz. |
centerFrequencyMHz |
number |
Frecuencia central en MHz. |
decodingConfiguration |
string |
Actualmente no se usa. |
demodulationConfiguration |
string |
Copia del archivo de configuración del módem, como Kratos QRadio o Kratos QuantumRx. Solo es válido para las direcciones de vínculo descendente. Si se proporciona, el módem se conecta al punto de conexión del cliente y envía datos demodulados en lugar de una secuencia VITA.49. |
encodingConfiguration |
string |
Actualmente no se usa. |
endPoint |
Punto final del cliente para almacenar y recuperar datos durante un contacto con la nave espacial. |
|
modulationConfiguration |
string |
Copia del archivo de configuración del módem, como Kratos QRadio. Solo es válido para las instrucciones de vínculo superior. Si se proporciona, el módem se conecta al punto de conexión del cliente y acepta comandos del cliente en lugar de una secuencia VITA.49. |
name |
string |
Nombre del canal. |
ContactProfilesProperties.ProvisioningState
Estado actual de la creación, eliminación o modificación del recurso.
ContactProfileThirdPartyConfiguration
Configuración de asociados de terceros de perfil de contacto.
Nombre | Tipo | Description |
---|---|---|
missionConfiguration |
string |
Nombre de cadena que hace referencia a la configuración que describe la configuración de contacto para una misión determinada. Los valores esperados son aquellos que se han creado en colaboración con la red de asociados. |
providerName |
string |
Nombre del proveedor de terceros. |
createdByType
Tipo de identidad que creó el recurso.
Nombre | Tipo | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
direction
Dirección (vínculo superior o vínculo descendente).
Nombre | Tipo | Description |
---|---|---|
Downlink |
string |
|
Uplink |
string |
EndPoint
Punto final del cliente para almacenar y recuperar datos durante un contacto con la nave espacial.
Nombre | Tipo | Description |
---|---|---|
endPointName |
string |
Nombre de un punto final. |
ipAddress |
string |
Dirección IP (IPv4). |
port |
string |
Puerto TCP en el que escuchar para recibir datos. |
protocol |
Protocolo UDP o TCP. |
ErrorAdditionalInfo
Información adicional sobre el error de administración de recursos.
Nombre | Tipo | Description |
---|---|---|
info |
object |
Información adicional. |
type |
string |
Tipo de información adicional. |
ErrorDetail
Detalle del error.
Nombre | Tipo | Description |
---|---|---|
additionalInfo |
Información adicional del error. |
|
code |
string |
Código de error. |
details |
Los detalles del error. |
|
message |
string |
El mensaje de error. |
target |
string |
Destino del error. |
ErrorResponse
Respuesta de error
Nombre | Tipo | Description |
---|---|---|
error |
Objeto de error. |
NetworkConfiguration
Configuración de red de la red virtual del cliente.
Nombre | Tipo | Description |
---|---|---|
subnetId |
string |
Identificador de recursos arm de la subred delegada en Microsoft.Orbital/orbitalGateways. Debe ser al menos una subred de clase C y no debe tener ninguna dirección IP creada en ella. |
polarization
Polarización. Por ejemplo, (RHCP, LHCP).
Nombre | Tipo | Description |
---|---|---|
LHCP |
string |
|
RHCP |
string |
|
linearHorizontal |
string |
|
linearVertical |
string |
protocol
Protocolo UDP o TCP.
Nombre | Tipo | Description |
---|---|---|
TCP |
string |
|
UDP |
string |
ProvisioningState
Estado actual de la creación, eliminación o modificación del recurso.
Spacecraft
El cliente crea un recurso de nave espacial para programar un contacto.
Nombre | Tipo | Description |
---|---|---|
id |
string |
Identificador de recurso completo del recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
location |
string |
Ubicación geográfica donde reside el recurso |
name |
string |
Nombre del recurso. |
properties.links |
Lista inmutable de enlaces de nave espacial. |
|
properties.noradId |
string |
NORAD ID de la nave espacial. |
properties.provisioningState |
Estado actual de la creación, eliminación o modificación del recurso. |
|
properties.titleLine |
string |
Línea de título del conjunto de elementos de dos líneas (TLE). |
properties.tleLine1 |
string |
Línea 1 del conjunto de elementos de dos líneas (TLE). |
properties.tleLine2 |
string |
Línea 2 del conjunto de elementos de dos líneas (TLE). |
systemData |
Metadatos de Azure Resource Manager que contienen información sobre los valores de createdBy y modifiedBy. |
|
tags |
object |
Etiquetas del recurso. |
type |
string |
Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts" |
SpacecraftLink
Lista de enlaces de naves espaciales autorizadas por estación terrestre y la fecha de expiración de la autorización.
Nombre | Tipo | Description |
---|---|---|
authorizations |
Estaciones terrestres autorizadas |
|
bandwidthMHz |
number |
Ancho de banda en MHz. |
centerFrequencyMHz |
number |
Frecuencia central en MHz. |
direction |
Dirección (vínculo superior o vínculo descendente). |
|
name |
string |
Nombre del vínculo. |
polarization |
Polarización. Por ejemplo, (RHCP, LHCP). |
systemData
Metadatos relacionados con la creación y la última modificación del recurso.
Nombre | Tipo | Description |
---|---|---|
createdAt |
string |
Marca de tiempo de creación de recursos (UTC). |
createdBy |
string |
Identidad que creó el recurso. |
createdByType |
Tipo de identidad que creó el recurso. |
|
lastModifiedAt |
string |
Marca de tiempo de la última modificación del recurso (UTC) |
lastModifiedBy |
string |
Identidad que modificó por última vez el recurso. |
lastModifiedByType |
Tipo de identidad que modificó por última vez el recurso. |