Compartir a través de


Contact Profiles - Create Or Update

Crea o actualiza un perfil de contacto.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Orbital/contactProfiles/{contactProfileName}?api-version=2022-11-01

Parámetros de identificador URI

Nombre En Requerido Tipo Description
contactProfileName
path True

string

Nombre del perfil de contacto.

resourceGroupName
path True

string

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

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
location True

string

Ubicación geográfica donde reside el recurso

properties.links True

ContactProfileLink[]

Vínculos del perfil de contacto. Describe los vínculos rf, el procesamiento de módems y los puntos de conexión IP.

properties.networkConfiguration True

NetworkConfiguration

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

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 Orbital los derechos para enviar telemetría al centro.

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.provisioningState

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 rf, el procesamiento de módems y los puntos de conexión IP.

tags

object

Etiquetas del recurso.

Respuestas

Nombre Tipo Description
200 OK

ContactProfile

Actualización correcta. La operación devuelve el recurso ContactProfile resultante.

201 Created

ContactProfile

Cree correctamente. La operación devuelve el recurso ContactProfile resultante.

Headers

Azure-AsyncOperation: string

Other Status Codes

ErrorResponse

Respuesta de error que describe el motivo del error de la operación.

Ejemplos

Create a contact profile

Sample Request

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"
            }
          }
        ]
      }
    ]
  }
}

Sample Response

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
          }
        ]
      }
    ]
  }
}

Definiciones

Nombre Description
AutoTrackingConfiguration

Configuración de seguimiento automático.

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.

ContactProfileThirdPartyConfiguration

Configuración del asociado de terceros del 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.

systemData

Metadatos relacionados con la creación y la última modificación del recurso.

AutoTrackingConfiguration

Configuración de seguimiento automático.

Nombre Tipo Description
disabled

string

sBand

string

xBand

string

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 Orbital los derechos para enviar telemetría al centro.

properties.links

ContactProfileLink[]

Vínculos del perfil de contacto. Describe los vínculos 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

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 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 eficaz (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 instrucciones de vínculo descendente. Si se proporciona, el módem se conecta al punto de conexión del cliente y envía datos degradados 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 direcciones 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.

ContactProfileThirdPartyConfiguration

Configuración del asociado de terceros del 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.

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.