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 |
---|---|---|---|---|
contact
|
path | True |
string |
Nombre del perfil de contacto. |
resource
|
path | True |
string |
Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas. |
subscription
|
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 |
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 |
Configuración de red de la red virtual del cliente. |
|
properties.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 |
Estado actual de la creación, eliminación o modificación del recurso. |
||
properties.thirdPartyConfigurations |
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 |
Actualización correcta. La operación devuelve el recurso ContactProfile resultante. |
|
201 Created |
Cree correctamente. La operación devuelve el recurso ContactProfile resultante. Encabezados Azure-AsyncOperation: string |
|
Other Status Codes |
Respuesta de error que describe el motivo del error de la operación. |
Ejemplos
Create a contact profile
Solicitud de ejemplo
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"
}
}
]
}
]
}
}
Respuesta de muestra
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 |
---|---|
Auto |
Configuración de seguimiento automático. |
Contact |
El cliente crea un recurso de perfil de contacto, que contendrá todas las configuraciones necesarias para programar un contacto. |
Contact |
Vínculo de perfil de contacto. |
Contact |
Canal de vínculo de perfil de contacto. |
Contact |
Configuración del asociado de terceros del perfil de contacto. |
created |
Tipo de identidad que creó el recurso. |
direction |
Dirección (vínculo superior o vínculo descendente). |
End |
Punto final del cliente para almacenar y recuperar datos durante un contacto con la nave espacial. |
Error |
Información adicional sobre el error de administración de recursos. |
Error |
Detalle del error. |
Error |
Respuesta de error |
Network |
Configuración de red de la red virtual del cliente. |
polarization |
Polarización. Por ejemplo, (RHCP, LHCP). |
protocol |
Protocolo UDP o TCP. |
Provisioning |
Estado actual de la creación, eliminación o modificación del recurso. |
system |
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 |
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 |
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 |
Configuración de red de la red virtual del cliente. |
|
properties.provisioningState |
Estado actual de la creación, eliminación o modificación del recurso. |
|
properties.thirdPartyConfigurations |
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 |
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" |
ContactProfileLink
Vínculo de perfil de contacto.
Nombre | Tipo | Description |
---|---|---|
channels |
Canal de vínculo de perfil de contacto. |
|
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 |
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 |
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 |
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 |
Información adicional del error. |
|
code |
string |
Código de error. |
details |
Los detalles del error. |
|
message |
string |
El mensaje de error. |
target |
string |
Destino del error. |
ErrorResponse
Respuesta de error
Nombre | Tipo | Description |
---|---|---|
error |
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 |
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 |
Tipo de identidad que modificó por última vez el recurso. |