Compartir a través de


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
resourceGroupName
path True

string

Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.

spacecraftName
path True

string

Id. de nave espacial.

subscriptionId
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

ContactProfile

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

AvailableContactsListResult

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

ErrorResponse

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
AuthorizedGroundstation

Estación terrestre autorizada.

AutoTrackingConfiguration

Configuración de seguimiento automático.

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.

AvailableContactsListResult

Respuesta para la llamada al servicio api ListAvailableContacts.

ContactParameters

Parámetros que definen el recurso de contacto.

ContactParameters.ContactProfile

Referencia al recurso de perfil de contacto.

ContactProfile

El cliente crea un recurso de perfil de contacto, que contendrá todas las configuraciones necesarias para programar un contacto.

ContactProfileLink

Vínculo de perfil de contacto.

ContactProfileLinkChannel

Canal de vínculo de perfil de contacto.

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.

createdByType

Tipo de identidad que creó el recurso.

direction

Dirección (vínculo superior o vínculo descendente).

EndPoint

Punto final del cliente para almacenar y recuperar datos durante un contacto con la nave espacial.

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

ErrorDetail

Detalle del error.

ErrorResponse

Respuesta de error

NetworkConfiguration

Configuración de red de la red virtual del cliente.

polarization

Polarización. Por ejemplo, (RHCP, LHCP).

protocol

Protocolo UDP o TCP.

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.

SpacecraftLink

Lista de enlaces de naves espaciales autorizadas por estación terrestre y la fecha de expiración de la autorización.

systemData

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

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

AvailableContacts[]

Una lista de contactos disponibles.

ContactParameters

Parámetros que definen el recurso de contacto.

Nombre Tipo Description
contactProfile

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

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

ContactProfileLink[]

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

NetworkConfiguration

Configuración de red de la red virtual del cliente.

properties.provisioningState

ContactProfilesProperties.ProvisioningState

Estado actual de la creación, eliminación o modificación del recurso.

properties.thirdPartyConfigurations

ContactProfileThirdPartyConfiguration[]

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

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"

Vínculo de perfil de contacto.

Nombre Tipo Description
channels

ContactProfileLinkChannel[]

Canal de vínculo de perfil de contacto.

direction

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

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

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

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

ErrorAdditionalInfo[]

Información adicional del error.

code

string

Código de error.

details

ErrorDetail[]

Los detalles del error.

message

string

El mensaje de error.

target

string

Destino del error.

ErrorResponse

Respuesta de error

Nombre Tipo Description
error

ErrorDetail

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

SpacecraftLink[]

Lista inmutable de enlaces de nave espacial.

properties.noradId

string

NORAD ID de la nave espacial.

properties.provisioningState

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

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"

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

AuthorizedGroundstation[]

Estaciones terrestres autorizadas

bandwidthMHz

number

Ancho de banda en MHz.

centerFrequencyMHz

number

Frecuencia central en MHz.

direction

direction

Dirección (vínculo superior o vínculo descendente).

name

string

Nombre del vínculo.

polarization

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

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

createdByType

Tipo de identidad que modificó por última vez el recurso.