Contact Profiles - Create Or Update
Cria ou atualiza um perfil de contato.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Orbital/contactProfiles/{contactProfileName}?api-version=2022-11-01
Parâmetros de URI
Nome | Em | Obrigatório | Tipo | Description |
---|---|---|---|---|
contact
|
path | True |
string |
Nome do perfil de contato. |
resource
|
path | True |
string |
O nome do grupo de recursos. O nome diferencia maiúsculas de minúsculas. |
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 |
---|---|---|---|
location | True |
string |
A localização geográfica em que o recurso reside |
properties.links | True |
Links do Perfil de Contato. Descreve links RF, processamento de modem e pontos de extremidade IP. |
|
properties.networkConfiguration | True |
Configuração de rede da rede virtual do cliente. |
|
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 de enviar telemetria para o hub. |
|
properties.minimumElevationDegrees |
number |
Elevação mínima viável 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.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. |
||
tags |
object |
Marcas de recurso. |
Respostas
Nome | Tipo | Description |
---|---|---|
200 OK |
Atualização bem-sucedida. A operação retorna o recurso ContactProfile resultante. |
|
201 Created |
Crie com êxito. A operação retorna o recurso ContactProfile resultante. Cabeçalhos Azure-AsyncOperation: string |
|
Other Status Codes |
Resposta de erro que descreve por que a operação falhou. |
Exemplos
Create a contact profile
Solicitação de exemplo
PUT https://management.azure.com/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.Orbital/contactProfiles/CONTOSO-CP?api-version=2022-11-01
{
"location": "eastus2",
"properties": {
"minimumViableContactDuration": "PT1M",
"minimumElevationDegrees": 5,
"autoTrackingConfiguration": "disabled",
"eventHubUri": "/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.EventHub/namespaces/contosoHub/eventhubs/contosoHub",
"networkConfiguration": {
"subnetId": "/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.Network/virtualNetworks/contoso-vnet/subnets/orbital-delegated-subnet"
},
"thirdPartyConfigurations": [
{
"providerName": "KSAT",
"missionConfiguration": "Ksat_MissionConfiguration"
},
{
"providerName": "VIASAT",
"missionConfiguration": "Viasat_Configuration"
}
],
"links": [
{
"name": "contoso-uplink",
"polarization": "LHCP",
"direction": "Uplink",
"gainOverTemperature": 0,
"eirpdBW": 45,
"channels": [
{
"name": "contoso-uplink-channel",
"centerFrequencyMHz": 2250,
"bandwidthMHz": 2,
"endPoint": {
"ipAddress": "10.1.0.4",
"endPointName": "ContosoTest_Uplink",
"port": "50000",
"protocol": "TCP"
}
}
]
},
{
"name": "contoso-downlink",
"polarization": "RHCP",
"direction": "Downlink",
"gainOverTemperature": 25,
"eirpdBW": 0,
"channels": [
{
"name": "contoso-downlink-channel",
"centerFrequencyMHz": 8160,
"bandwidthMHz": 15,
"endPoint": {
"ipAddress": "10.1.0.5",
"endPointName": "ContosoTest_Downlink",
"port": "50001",
"protocol": "UDP"
}
}
]
}
]
}
}
Resposta de exemplo
Azure-AsyncOperation: https://management.azure.com/Microsoft.Orbital/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2022-11-01
{
"location": "eastus2",
"tags": null,
"id": "/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.Orbital/contactProfiles/CONTOSO-CP",
"name": "CONTOSO-CP",
"type": "Microsoft.Orbital/contactProfiles",
"properties": {
"provisioningState": "updating",
"minimumViableContactDuration": "PT1M",
"minimumElevationDegrees": 5,
"autoTrackingConfiguration": "disabled",
"eventHubUri": "/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.EventHub/namespaces/contosoHub/eventhubs/contosoHub",
"networkConfiguration": {
"subnetId": "/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.Network/virtualNetworks/contoso-vnet/subnets/orbital-delegated-subnet"
},
"thirdPartyConfigurations": [
{
"providerName": "KSAT",
"missionConfiguration": "Ksat_MissionConfiguration"
},
{
"providerName": "VIASAT",
"missionConfiguration": "Viasat_Configuration"
}
],
"links": [
{
"name": "contoso-uplink",
"polarization": "LHCP",
"direction": "Uplink",
"gainOverTemperature": 0,
"eirpdBW": 45,
"channels": [
{
"name": "contoso-uplink-channel",
"centerFrequencyMHz": 2250,
"bandwidthMHz": 2,
"endPoint": {
"ipAddress": "10.1.0.4",
"endPointName": "ContosoTest_Uplink",
"port": "50000",
"protocol": "TCP"
},
"modulationConfiguration": null,
"demodulationConfiguration": null,
"encodingConfiguration": null,
"decodingConfiguration": null
}
]
},
{
"name": "contoso-downlink",
"polarization": "RHCP",
"direction": "Downlink",
"gainOverTemperature": 25,
"eirpdBW": 0,
"channels": [
{
"name": "contoso-downlink-channel",
"centerFrequencyMHz": 8160,
"bandwidthMHz": 15,
"endPoint": {
"ipAddress": "10.1.0.5",
"endPointName": "ContosoTest_Downlink",
"port": "50001",
"protocol": "UDP"
},
"modulationConfiguration": null,
"demodulationConfiguration": null,
"encodingConfiguration": null,
"decodingConfiguration": null
}
]
}
]
}
}
Azure-AsyncOperation: https://management.azure.com/Microsoft.Orbital/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2022-11-01
{
"location": "eastus2",
"tags": null,
"id": "/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.Orbital/contactProfiles/CONTOSO-CP",
"name": "CONTOSO-CP",
"type": "Microsoft.Orbital/contactProfiles",
"properties": {
"provisioningState": "succeeded",
"minimumViableContactDuration": "PT1M",
"minimumElevationDegrees": 5,
"autoTrackingConfiguration": "disabled",
"eventHubUri": "/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.EventHub/namespaces/contosoHub/eventhubs/contosoHub",
"networkConfiguration": {
"subnetId": "/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.Network/virtualNetworks/contoso-vnet/subnets/orbital-delegated-subnet"
},
"thirdPartyConfigurations": [
{
"providerName": "KSAT",
"missionConfiguration": "Ksat_MissionConfiguration"
},
{
"providerName": "VIASAT",
"missionConfiguration": "Viasat_Configuration"
}
],
"links": [
{
"name": "contoso-uplink",
"polarization": "LHCP",
"direction": "Uplink",
"gainOverTemperature": 0,
"eirpdBW": 45,
"channels": [
{
"name": "contoso-uplink-channel",
"centerFrequencyMHz": 2250,
"bandwidthMHz": 2,
"endPoint": {
"ipAddress": "10.1.0.4",
"endPointName": "ContosoTest_Uplink",
"port": "50000",
"protocol": "TCP"
},
"modulationConfiguration": null,
"demodulationConfiguration": null,
"encodingConfiguration": null,
"decodingConfiguration": null
}
]
},
{
"name": "contoso-downlink",
"polarization": "RHCP",
"direction": "Downlink",
"gainOverTemperature": 25,
"eirpdBW": 0,
"channels": [
{
"name": "contoso-downlink-channel",
"centerFrequencyMHz": 8160,
"bandwidthMHz": 15,
"endPoint": {
"ipAddress": "10.1.0.5",
"endPointName": "ContosoTest_Downlink",
"port": "50001",
"protocol": "UDP"
},
"modulationConfiguration": null,
"demodulationConfiguration": null,
"encodingConfiguration": null,
"decodingConfiguration": null
}
]
}
]
}
}
Definições
Nome | Description |
---|---|
Auto |
Configuração de acompanhamento automático. |
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 |
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 |
O detalhe 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. |
system |
Metadados relativos à criação e à última modificação do recurso. |
AutoTrackingConfiguration
Configuração de acompanhamento automático.
Nome | Tipo | Description |
---|---|---|
disabled |
string |
|
sBand |
string |
|
xBand |
string |
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 de 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 mínima viável 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 de ruído em db/K. É o G/T necessário pelo 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. |
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
O detalhe 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 ao Microsoft.Orbital/orbitalGateways. Precisa ser pelo menos uma sub-rede da classe C 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.
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. |