Spacecrafts - List Available Contacts
Retorna a lista de contatos disponíveis. Um contato estará disponível se a nave estiver visível da estação terrestre por mais do que a duração mínima de contato viável fornecida no perfil de contato.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Orbital/spacecrafts/{spacecraftName}/listAvailableContacts?api-version=2022-11-01
Parâmetros de URI
Nome | Em | Obrigatório | Tipo | Description |
---|---|---|---|---|
resource
|
path | True |
string |
O nome do grupo de recursos. O nome diferencia maiúsculas de minúsculas. |
spacecraft
|
path | True |
string |
ID da nave espacial. |
subscription
|
path | True |
string |
A ID da assinatura de destino. |
api-version
|
query | True |
string |
A versão da API a ser usada para esta operação. |
Corpo da solicitação
Nome | Obrigatório | Tipo | Description |
---|---|---|---|
contactProfile | True |
A referência ao recurso de perfil de contato. |
|
endTime | True |
string |
Hora de término de um contato (padrão UTC ISO 8601). |
groundStationName | True |
string |
Nome da Estação Terrestre do Azure. |
startTime | True |
string |
Hora de início de um contato (padrão UTC ISO 8601). |
Respostas
Nome | Tipo | Description |
---|---|---|
200 OK |
Solicitação bem-sucedida. A operação retorna uma lista de recursos de contatos disponíveis. |
|
202 Accepted |
Aceito e a operação será concluída de forma assíncrona. Cabeçalhos Location: string |
|
Other Status Codes |
Resposta de erro que descreve por que a operação falhou. Se o grupo de recursos não existir, 404 (NotFound) serão retornados. |
Exemplos
List of Contact
Solicitação de exemplo
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"
}
Resposta de exemplo
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"
}
Definições
Nome | Description |
---|---|
Authorized |
Estação terrestre autorizada. |
Auto |
Configuração de acompanhamento automático. |
Available |
O cliente recupera a lista de Contatos Disponíveis para um recurso de nave espacial. Posteriormente, um dos contatos disponíveis pode ser selecionado para criar um contato. |
Available |
Resposta para a chamada ao serviço de API ListAvailableContacts. |
Contact |
Parâmetros que definem o recurso de contato. |
Contact |
A referência ao recurso de perfil de contato. |
Contact |
O cliente cria um Recurso de Perfil de Contato, que conterá todas as configurações necessárias para agendar um contato. |
Contact |
Link do Perfil de Contato. |
Contact |
Entrar em contato com o Canal de Link do Perfil. |
Contact |
O estado atual da criação, exclusão ou modificação do recurso. |
Contact |
Contate a configuração de parceiro de terceiros do Perfil. |
created |
O tipo de identidade que criou o recurso. |
direction |
Direção (Uplink ou Downlink). |
End |
Ponto de extremidade do cliente para armazenar e recuperar dados durante um contato com a nave espacial. |
Error |
As informações adicionais do erro de gerenciamento de recursos. |
Error |
Os detalhes do erro. |
Error |
Resposta de erro |
Network |
Configuração de rede da rede virtual do cliente. |
polarization |
Polarização. por exemplo, (RHCP, LHCP). |
protocol |
Protocolo UDP ou TCP. |
Provisioning |
O estado atual da criação, exclusão ou modificação do recurso. |
Spacecraft |
O cliente cria um recurso de nave espacial para agendar um contato. |
Spacecraft |
Lista de ligações de naves espaciais autorizadas por estação terrestre e a data de validade da autorização. |
system |
Metadados relativos à criação e à última modificação do recurso. |
AuthorizedGroundstation
Estação terrestre autorizada.
Nome | Tipo | Description |
---|---|---|
expirationDate |
string |
Data de validade da autorização. |
groundStation |
string |
Nome da estação de terra. |
AutoTrackingConfiguration
Configuração de acompanhamento automático.
Nome | Tipo | Description |
---|---|---|
disabled |
string |
|
sBand |
string |
|
xBand |
string |
AvailableContacts
O cliente recupera a lista de Contatos Disponíveis para um recurso de nave espacial. Posteriormente, um dos contatos disponíveis pode ser selecionado para criar um contato.
Nome | Tipo | Description |
---|---|---|
groundStationName |
string |
Nome da Estação Terrestre do Azure. |
properties.endAzimuthDegrees |
number |
Azimute da antena no final do contato em graus decimais. |
properties.endElevationDegrees |
number |
Elevação de nave espacial acima do horizonte no fim do contato. |
properties.maximumElevationDegrees |
number |
Elevação máxima da antena durante o contato em graus decimais. |
properties.rxEndTime |
string |
Tempo de perda ao receber um sinal (padrão ISO 8601 UTC). |
properties.rxStartTime |
string |
Hora mais antiga para receber um sinal (padrão ISO 8601 UTC). |
properties.startAzimuthDegrees |
number |
Azimute da antena no início do contato em graus decimais. |
properties.startElevationDegrees |
number |
Elevação de nave espacial acima do horizonte no início do contato. |
properties.txEndTime |
string |
Hora em que a transmissão da antena será desabilitada (padrão ISO 8601 UTC). |
properties.txStartTime |
string |
Hora em que a transmissão de antena será habilitada (padrão ISO 8601 UTC). |
spacecraft |
A referência ao recurso de nave espacial. |
AvailableContactsListResult
Resposta para a chamada ao serviço de API ListAvailableContacts.
Nome | Tipo | Description |
---|---|---|
nextLink |
string |
A URL para obter o próximo conjunto de resultados. |
value |
Uma lista de contatos disponíveis. |
ContactParameters
Parâmetros que definem o recurso de contato.
Nome | Tipo | Description |
---|---|---|
contactProfile |
A referência ao recurso de perfil de contato. |
|
endTime |
string |
Hora de término de um contato (padrão ISO 8601 UTC). |
groundStationName |
string |
Nome da Estação Terrestre do Azure. |
startTime |
string |
Hora de início de um contato (padrão ISO 8601 UTC). |
ContactParameters.ContactProfile
A referência ao recurso de perfil de contato.
Nome | Tipo | Description |
---|---|---|
id |
string |
ID do recurso. |
ContactProfile
O cliente cria um Recurso de Perfil de Contato, que conterá todas as configurações necessárias para agendar um contato.
Nome | Tipo | Description |
---|---|---|
id |
string |
ID de recurso totalmente qualificada para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
location |
string |
A localização geográfica em que o recurso reside |
name |
string |
O nome do recurso |
properties.autoTrackingConfiguration |
Configuração de acompanhamento automático. |
|
properties.eventHubUri |
string |
Identificador de recurso arm do Hub de Eventos usado para telemetria. Requer a concessão do Provedor de Recursos orbital os direitos para enviar telemetria para o hub. |
properties.links |
Links do Perfil de Contato. Descreve links RF, processamento de modem e pontos de extremidade IP. |
|
properties.minimumElevationDegrees |
number |
Elevação viável mínima para o contato em graus decimais. Usado para listar os contatos disponíveis com uma nave espacial em uma determinada estação terrestre. |
properties.minimumViableContactDuration |
string |
Duração mínima do contato viável no formato ISO 8601. Usado para listar os contatos disponíveis com uma nave espacial em uma determinada estação terrestre. |
properties.networkConfiguration |
Configuração de rede da rede virtual do cliente. |
|
properties.provisioningState |
O estado atual da criação, exclusão ou modificação do recurso. |
|
properties.thirdPartyConfigurations |
Configuração de missão de terceiros do Perfil de Contato. Descreve links RF, processamento de modem e pontos de extremidade IP. |
|
systemData |
Os metadados do Azure Resource Manager que contêm as informações createdBy e modifiedBy. |
|
tags |
object |
Marcas de recurso. |
type |
string |
Tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts" |
ContactProfileLink
Link do Perfil de Contato.
Nome | Tipo | Description |
---|---|---|
channels |
Entrar em contato com o Canal de Link do Perfil. |
|
direction |
Direção (Uplink ou Downlink). |
|
eirpdBW |
number |
EiRP (Energia Radiada Isotrópica) eficaz no dBW. É o EIRP exigido pelo cliente. Ainda não foi usado. |
gainOverTemperature |
number |
Ganho à temperatura do ruído no banco de dados/K. É o G/T necessário para o cliente. Ainda não foi usado. |
name |
string |
Nome do link. |
polarization |
Polarização. por exemplo, (RHCP, LHCP). |
ContactProfileLinkChannel
Entrar em contato com o Canal de Link do Perfil.
Nome | Tipo | Description |
---|---|---|
bandwidthMHz |
number |
Largura de banda no MHz. |
centerFrequencyMHz |
number |
Frequência central no MHz. |
decodingConfiguration |
string |
Atualmente não utilizado. |
demodulationConfiguration |
string |
Cópia do arquivo de configuração de modem, como Kratos QRadio ou Kratos QuantumRx. Válido apenas para direções de downlink. Se fornecido, o modem se conecta ao ponto de extremidade do cliente e envia dados rebaixados em vez de um fluxo VITA.49. |
encodingConfiguration |
string |
Atualmente não utilizado. |
endPoint |
Ponto de extremidade do cliente para armazenar e recuperar dados durante um contato com a nave espacial. |
|
modulationConfiguration |
string |
Cópia do arquivo de configuração de modem, como Kratos QRadio. Válido apenas para trajetos de uplink. Se fornecido, o modem se conecta ao ponto de extremidade do cliente e aceita comandos do cliente em vez de um fluxo VITA.49. |
name |
string |
Nome do canal. |
ContactProfilesProperties.ProvisioningState
O estado atual da criação, exclusão ou modificação do recurso.
ContactProfileThirdPartyConfiguration
Contate a configuração de parceiro de terceiros do Perfil.
Nome | Tipo | Description |
---|---|---|
missionConfiguration |
string |
Nome da cadeia de caracteres que faz referência à configuração que descreve a configuração de contato para uma missão específica. Os valores esperados são aqueles que foram criados em colaboração com a rede de parceiros. |
providerName |
string |
Nome do provedor de terceiros. |
createdByType
O tipo de identidade que criou o recurso.
Nome | Tipo | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
direction
Direção (Uplink ou Downlink).
Nome | Tipo | Description |
---|---|---|
Downlink |
string |
|
Uplink |
string |
EndPoint
Ponto de extremidade do cliente para armazenar e recuperar dados durante um contato com a nave espacial.
Nome | Tipo | Description |
---|---|---|
endPointName |
string |
Nome de um ponto de extremidade. |
ipAddress |
string |
Endereço IP (IPv4). |
port |
string |
Porta TCP para escutar para receber dados. |
protocol |
Protocolo UDP ou TCP. |
ErrorAdditionalInfo
As informações adicionais do erro de gerenciamento de recursos.
Nome | Tipo | Description |
---|---|---|
info |
object |
As informações adicionais. |
type |
string |
O tipo de informação adicional. |
ErrorDetail
Os detalhes do erro.
Nome | Tipo | Description |
---|---|---|
additionalInfo |
As informações adicionais do erro. |
|
code |
string |
O código de erro. |
details |
Os detalhes do erro. |
|
message |
string |
A mensagem de erro. |
target |
string |
O destino do erro. |
ErrorResponse
Resposta de erro
Nome | Tipo | Description |
---|---|---|
error |
O objeto de erro. |
NetworkConfiguration
Configuração de rede da rede virtual do cliente.
Nome | Tipo | Description |
---|---|---|
subnetId |
string |
Identificador de recurso arm da sub-rede delegada para Microsoft.Orbital/orbitalGateways. Precisa ser pelo menos uma sub-rede C de classe e não deve ter nenhum IP criado nela. |
polarization
Polarização. por exemplo, (RHCP, LHCP).
Nome | Tipo | Description |
---|---|---|
LHCP |
string |
|
RHCP |
string |
|
linearHorizontal |
string |
|
linearVertical |
string |
protocol
Protocolo UDP ou TCP.
Nome | Tipo | Description |
---|---|---|
TCP |
string |
|
UDP |
string |
ProvisioningState
O estado atual da criação, exclusão ou modificação do recurso.
Spacecraft
O cliente cria um recurso de nave espacial para agendar um contato.
Nome | Tipo | Description |
---|---|---|
id |
string |
ID de recurso totalmente qualificada para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
location |
string |
A localização geográfica em que o recurso reside |
name |
string |
O nome do recurso |
properties.links |
Lista imutável de links de naves espaciais. |
|
properties.noradId |
string |
ID de NORAD da nave espacial. |
properties.provisioningState |
O estado atual da criação, exclusão ou modificação do recurso. |
|
properties.titleLine |
string |
Linha de título do conjunto de elementos de duas linhas (TLE). |
properties.tleLine1 |
string |
Linha 1 do conjunto de elementos de duas linhas (TLE). |
properties.tleLine2 |
string |
Linha 2 do conjunto de elementos de duas linhas (TLE). |
systemData |
Os metadados do Azure Resource Manager que contêm as informações createdBy e modifiedBy. |
|
tags |
object |
Marcas de recurso. |
type |
string |
Tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts" |
SpacecraftLink
Lista de ligações de naves espaciais autorizadas por estação terrestre e a data de validade da autorização.
Nome | Tipo | Description |
---|---|---|
authorizations |
Estações terrestres autorizadas |
|
bandwidthMHz |
number |
Largura de banda no MHz. |
centerFrequencyMHz |
number |
Frequência central no MHz. |
direction |
Direção (Uplink ou Downlink). |
|
name |
string |
Nome do link. |
polarization |
Polarização. por exemplo, (RHCP, LHCP). |
systemData
Metadados relativos à criação e à última modificação do recurso.
Nome | Tipo | Description |
---|---|---|
createdAt |
string |
O carimbo de data/hora da criação de recursos (UTC). |
createdBy |
string |
A identidade que criou o recurso. |
createdByType |
O tipo de identidade que criou o recurso. |
|
lastModifiedAt |
string |
O carimbo de data/hora da última modificação do recurso (UTC) |
lastModifiedBy |
string |
A identidade que modificou o recurso pela última vez. |
lastModifiedByType |
O tipo de identidade que modificou o recurso pela última vez. |