Compartilhar via


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

string

Nome do perfil de contato.

resourceGroupName
path True

string

O nome do grupo de recursos. O nome diferencia maiúsculas de minúsculas.

subscriptionId
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

ContactProfileLink[]

Links do Perfil de Contato. Descreve links RF, processamento de modem e pontos de extremidade IP.

properties.networkConfiguration True

NetworkConfiguration

Configuração de rede da rede virtual do cliente.

properties.autoTrackingConfiguration

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

ProvisioningState

O estado atual da criação, exclusão ou modificação do recurso.

properties.thirdPartyConfigurations

ContactProfileThirdPartyConfiguration[]

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

ContactProfile

Atualização bem-sucedida. A operação retorna o recurso ContactProfile resultante.

201 Created

ContactProfile

Crie com êxito. A operação retorna o recurso ContactProfile resultante.

Cabeçalhos

Azure-AsyncOperation: string

Other Status Codes

ErrorResponse

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
AutoTrackingConfiguration

Configuração de acompanhamento automático.

ContactProfile

O cliente cria um Recurso de Perfil de Contato, que conterá todas as configurações necessárias para agendar um contato.

ContactProfileLink

Link do Perfil de Contato.

ContactProfileLinkChannel

Entrar em contato com o Canal de Link do Perfil.

ContactProfileThirdPartyConfiguration

Contate a configuração de parceiro de terceiros do Perfil.

createdByType

O tipo de identidade que criou o recurso.

direction

Direção (Uplink ou Downlink).

EndPoint

Ponto de extremidade do cliente para armazenar e recuperar dados durante um contato com a nave espacial.

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta de erro

NetworkConfiguration

Configuração de rede da rede virtual do cliente.

polarization

Polarização. por exemplo, (RHCP, LHCP).

protocol

Protocolo UDP ou TCP.

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.

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

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

ContactProfileLink[]

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

NetworkConfiguration

Configuração de rede da rede virtual do cliente.

properties.provisioningState

ProvisioningState

O estado atual da criação, exclusão ou modificação do recurso.

properties.thirdPartyConfigurations

ContactProfileThirdPartyConfiguration[]

Configuração de missão de terceiros do Perfil de Contato. Descreve links RF, processamento de modem e pontos de extremidade IP.

systemData

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"

Link do Perfil de Contato.

Nome Tipo Description
channels

ContactProfileLinkChannel[]

Entrar em contato com o Canal de Link do Perfil.

direction

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

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

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

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

ErrorAdditionalInfo[]

As informações adicionais do erro.

code

string

O código de erro.

details

ErrorDetail[]

Os detalhes do erro.

message

string

A mensagem de erro.

target

string

O destino do erro.

ErrorResponse

Resposta de erro

Nome Tipo Description
error

ErrorDetail

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

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

createdByType

O tipo de identidade que modificou o recurso pela última vez.