Contact Profiles - Create Or Update

Service:

Orbital

API Version:

2022-11-01

Crea o aggiorna un profilo di contatto.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
contactProfileName	path	True	string	Nome del profilo di contatto.
resourceGroupName	path	True	string	Nome del gruppo di risorse. Per il nome non viene fatta distinzione tra maiuscole e minuscole.
subscriptionId	path	True	string	ID della sottoscrizione di destinazione.
api-version	query	True	string	Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
location	True	string	Posizione geografica in cui risiede la risorsa
properties.links	True	ContactProfileLink[]	Collegamenti del profilo di contatto. Vengono descritti i collegamenti RF, l'elaborazione del modem e gli endpoint IP.
properties.networkConfiguration	True	NetworkConfiguration	Configurazione di rete della rete virtuale del cliente.
properties.autoTrackingConfiguration		AutoTrackingConfiguration	Configurazione del rilevamento automatico.
properties.eventHubUri		string	Identificatore di risorsa ARM dell'hub eventi usato per la telemetria. È necessario concedere al provider di risorse Orbital i diritti per inviare i dati di telemetria nell'hub.
properties.minimumElevationDegrees		number	Elevazione minima praticabile per il contatto in gradi decimali. Utilizzato per elencare i contatti disponibili con un veicolo spaziale in una determinata stazione di terra.
properties.minimumViableContactDuration		string	Durata minima del contatto valido in formato ISO 8601. Utilizzato per elencare i contatti disponibili con un veicolo spaziale in una determinata stazione di terra.
properties.provisioningState		ProvisioningState	Stato corrente della creazione, eliminazione o modifica della risorsa.
properties.thirdPartyConfigurations		ContactProfileThirdPartyConfiguration[]	Configurazione della missione di terze parti del profilo di contatto. Vengono descritti i collegamenti RF, l'elaborazione del modem e gli endpoint IP.
tags		object	Tag delle risorse.

Risposte

Nome	Tipo	Descrizione
200 OK	ContactProfile	Aggiornamento riuscito. L'operazione restituisce la risorsa ContactProfile risultante.
201 Created	ContactProfile	Creazione riuscita. L'operazione restituisce la risorsa ContactProfile risultante. Headers Azure-AsyncOperation: string
Other Status Codes	ErrorResponse	Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Esempio

Create a contact profile

Sample Request

HTTP

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

Java

import com.azure.resourcemanager.orbital.models.AutoTrackingConfiguration;
import com.azure.resourcemanager.orbital.models.ContactProfileLink;
import com.azure.resourcemanager.orbital.models.ContactProfileLinkChannel;
import com.azure.resourcemanager.orbital.models.ContactProfileThirdPartyConfiguration;
import com.azure.resourcemanager.orbital.models.ContactProfilesPropertiesNetworkConfiguration;
import com.azure.resourcemanager.orbital.models.Direction;
import com.azure.resourcemanager.orbital.models.EndPoint;
import com.azure.resourcemanager.orbital.models.Polarization;
import com.azure.resourcemanager.orbital.models.Protocol;
import java.util.Arrays;

/** Samples for ContactProfiles CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file: specification/orbital/resource-manager/Microsoft.Orbital/stable/2022-11-01/examples/ContactProfileCreate.json
     */
    /**
     * Sample code: Create a contact profile.
     *
     * @param manager Entry point to OrbitalManager.
     */
    public static void createAContactProfile(com.azure.resourcemanager.orbital.OrbitalManager manager) {
        manager
            .contactProfiles()
            .define("CONTOSO-CP")
            .withRegion("eastus2")
            .withExistingResourceGroup("contoso-Rgp")
            .withNetworkConfiguration(
                new ContactProfilesPropertiesNetworkConfiguration()
                    .withSubnetId(
                        "/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.Network/virtualNetworks/contoso-vnet/subnets/orbital-delegated-subnet"))
            .withLinks(
                Arrays
                    .asList(
                        new ContactProfileLink()
                            .withName("contoso-uplink")
                            .withPolarization(Polarization.LHCP)
                            .withDirection(Direction.UPLINK)
                            .withGainOverTemperature(0.0F)
                            .withEirpdBW(45.0F)
                            .withChannels(
                                Arrays
                                    .asList(
                                        new ContactProfileLinkChannel()
                                            .withName("contoso-uplink-channel")
                                            .withCenterFrequencyMHz(2250f)
                                            .withBandwidthMHz(2f)
                                            .withEndPoint(
                                                new EndPoint()
                                                    .withIpAddress("10.1.0.4")
                                                    .withEndPointName("ContosoTest_Uplink")
                                                    .withPort("50000")
                                                    .withProtocol(Protocol.TCP)))),
                        new ContactProfileLink()
                            .withName("contoso-downlink")
                            .withPolarization(Polarization.RHCP)
                            .withDirection(Direction.DOWNLINK)
                            .withGainOverTemperature(25.0F)
                            .withEirpdBW(0.0F)
                            .withChannels(
                                Arrays
                                    .asList(
                                        new ContactProfileLinkChannel()
                                            .withName("contoso-downlink-channel")
                                            .withCenterFrequencyMHz(8160f)
                                            .withBandwidthMHz(15f)
                                            .withEndPoint(
                                                new EndPoint()
                                                    .withIpAddress("10.1.0.5")
                                                    .withEndPointName("ContosoTest_Downlink")
                                                    .withPort("50001")
                                                    .withProtocol(Protocol.UDP))))))
            .withMinimumViableContactDuration("PT1M")
            .withMinimumElevationDegrees(5.0F)
            .withAutoTrackingConfiguration(AutoTrackingConfiguration.DISABLED)
            .withEventHubUri(
                "/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.EventHub/namespaces/contosoHub/eventhubs/contosoHub")
            .withThirdPartyConfigurations(
                Arrays
                    .asList(
                        new ContactProfileThirdPartyConfiguration()
                            .withProviderName("KSAT")
                            .withMissionConfiguration("Ksat_MissionConfiguration"),
                        new ContactProfileThirdPartyConfiguration()
                            .withProviderName("VIASAT")
                            .withMissionConfiguration("Viasat_Configuration")))
            .create();
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Go

package armorbital_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/orbital/armorbital/v2"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/1e7b408f3323e7f5424745718fe62c7a043a2337/specification/orbital/resource-manager/Microsoft.Orbital/stable/2022-11-01/examples/ContactProfileCreate.json
func ExampleContactProfilesClient_BeginCreateOrUpdate() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armorbital.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewContactProfilesClient().BeginCreateOrUpdate(ctx, "contoso-Rgp", "CONTOSO-CP", armorbital.ContactProfile{
		Location: to.Ptr("eastus2"),
		Properties: &armorbital.ContactProfileProperties{
			AutoTrackingConfiguration: to.Ptr(armorbital.AutoTrackingConfigurationDisabled),
			EventHubURI:               to.Ptr("/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.EventHub/namespaces/contosoHub/eventhubs/contosoHub"),
			Links: []*armorbital.ContactProfileLink{
				{
					Name: to.Ptr("contoso-uplink"),
					Channels: []*armorbital.ContactProfileLinkChannel{
						{
							Name:               to.Ptr("contoso-uplink-channel"),
							BandwidthMHz:       to.Ptr[float32](2),
							CenterFrequencyMHz: to.Ptr[float32](2250),
							EndPoint: &armorbital.EndPoint{
								EndPointName: to.Ptr("ContosoTest_Uplink"),
								IPAddress:    to.Ptr("10.1.0.4"),
								Port:         to.Ptr("50000"),
								Protocol:     to.Ptr(armorbital.ProtocolTCP),
							},
						}},
					Direction:           to.Ptr(armorbital.DirectionUplink),
					EirpdBW:             to.Ptr[float32](45),
					GainOverTemperature: to.Ptr[float32](0),
					Polarization:        to.Ptr(armorbital.PolarizationLHCP),
				},
				{
					Name: to.Ptr("contoso-downlink"),
					Channels: []*armorbital.ContactProfileLinkChannel{
						{
							Name:               to.Ptr("contoso-downlink-channel"),
							BandwidthMHz:       to.Ptr[float32](15),
							CenterFrequencyMHz: to.Ptr[float32](8160),
							EndPoint: &armorbital.EndPoint{
								EndPointName: to.Ptr("ContosoTest_Downlink"),
								IPAddress:    to.Ptr("10.1.0.5"),
								Port:         to.Ptr("50001"),
								Protocol:     to.Ptr(armorbital.ProtocolUDP),
							},
						}},
					Direction:           to.Ptr(armorbital.DirectionDownlink),
					EirpdBW:             to.Ptr[float32](0),
					GainOverTemperature: to.Ptr[float32](25),
					Polarization:        to.Ptr(armorbital.PolarizationRHCP),
				}},
			MinimumElevationDegrees:      to.Ptr[float32](5),
			MinimumViableContactDuration: to.Ptr("PT1M"),
			NetworkConfiguration: &armorbital.ContactProfilesPropertiesNetworkConfiguration{
				SubnetID: to.Ptr("/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.Network/virtualNetworks/contoso-vnet/subnets/orbital-delegated-subnet"),
			},
			ThirdPartyConfigurations: []*armorbital.ContactProfileThirdPartyConfiguration{
				{
					MissionConfiguration: to.Ptr("Ksat_MissionConfiguration"),
					ProviderName:         to.Ptr("KSAT"),
				},
				{
					MissionConfiguration: to.Ptr("Viasat_Configuration"),
					ProviderName:         to.Ptr("VIASAT"),
				}},
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.ContactProfile = armorbital.ContactProfile{
	// 	Name: to.Ptr("CONTOSO-CP"),
	// 	Type: to.Ptr("Microsoft.Orbital/contactProfiles"),
	// 	ID: to.Ptr("/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.Orbital/contactProfiles/CONTOSO-CP"),
	// 	Location: to.Ptr("eastus2"),
	// 	Properties: &armorbital.ContactProfileProperties{
	// 		AutoTrackingConfiguration: to.Ptr(armorbital.AutoTrackingConfigurationDisabled),
	// 		EventHubURI: to.Ptr("/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.EventHub/namespaces/contosoHub/eventhubs/contosoHub"),
	// 		Links: []*armorbital.ContactProfileLink{
	// 			{
	// 				Name: to.Ptr("contoso-uplink"),
	// 				Channels: []*armorbital.ContactProfileLinkChannel{
	// 					{
	// 						Name: to.Ptr("contoso-uplink-channel"),
	// 						BandwidthMHz: to.Ptr[float32](2),
	// 						CenterFrequencyMHz: to.Ptr[float32](2250),
	// 						EndPoint: &armorbital.EndPoint{
	// 							EndPointName: to.Ptr("ContosoTest_Uplink"),
	// 							IPAddress: to.Ptr("10.1.0.4"),
	// 							Port: to.Ptr("50000"),
	// 							Protocol: to.Ptr(armorbital.ProtocolTCP),
	// 						},
	// 				}},
	// 				Direction: to.Ptr(armorbital.DirectionUplink),
	// 				EirpdBW: to.Ptr[float32](45),
	// 				GainOverTemperature: to.Ptr[float32](0),
	// 				Polarization: to.Ptr(armorbital.PolarizationLHCP),
	// 			},
	// 			{
	// 				Name: to.Ptr("contoso-downlink"),
	// 				Channels: []*armorbital.ContactProfileLinkChannel{
	// 					{
	// 						Name: to.Ptr("contoso-downlink-channel"),
	// 						BandwidthMHz: to.Ptr[float32](15),
	// 						CenterFrequencyMHz: to.Ptr[float32](8160),
	// 						EndPoint: &armorbital.EndPoint{
	// 							EndPointName: to.Ptr("ContosoTest_Downlink"),
	// 							IPAddress: to.Ptr("10.1.0.5"),
	// 							Port: to.Ptr("50001"),
	// 							Protocol: to.Ptr(armorbital.ProtocolUDP),
	// 						},
	// 				}},
	// 				Direction: to.Ptr(armorbital.DirectionDownlink),
	// 				EirpdBW: to.Ptr[float32](0),
	// 				GainOverTemperature: to.Ptr[float32](25),
	// 				Polarization: to.Ptr(armorbital.PolarizationRHCP),
	// 		}},
	// 		MinimumElevationDegrees: to.Ptr[float32](5),
	// 		MinimumViableContactDuration: to.Ptr("PT1M"),
	// 		NetworkConfiguration: &armorbital.ContactProfilesPropertiesNetworkConfiguration{
	// 			SubnetID: to.Ptr("/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.Network/virtualNetworks/contoso-vnet/subnets/orbital-delegated-subnet"),
	// 		},
	// 		ProvisioningState: to.Ptr(armorbital.ContactProfilesPropertiesProvisioningState("Succeeded")),
	// 		ThirdPartyConfigurations: []*armorbital.ContactProfileThirdPartyConfiguration{
	// 			{
	// 				MissionConfiguration: to.Ptr("Ksat_MissionConfiguration"),
	// 				ProviderName: to.Ptr("KSAT"),
	// 			},
	// 			{
	// 				MissionConfiguration: to.Ptr("Viasat_Configuration"),
	// 				ProviderName: to.Ptr("VIASAT"),
	// 		}},
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

JavaScript

const { AzureOrbital } = require("@azure/arm-orbital");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Creates or updates a contact profile.
 *
 * @summary Creates or updates a contact profile.
 * x-ms-original-file: specification/orbital/resource-manager/Microsoft.Orbital/stable/2022-11-01/examples/ContactProfileCreate.json
 */
async function createAContactProfile() {
  const subscriptionId =
    process.env["ORBITAL_SUBSCRIPTION_ID"] || "c1be1141-a7c9-4aac-9608-3c2e2f1152c3";
  const resourceGroupName = process.env["ORBITAL_RESOURCE_GROUP"] || "contoso-Rgp";
  const contactProfileName = "CONTOSO-CP";
  const location = "eastus2";
  const networkConfiguration = {
    subnetId:
      "/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.Network/virtualNetworks/contoso-vnet/subnets/orbital-delegated-subnet",
  };
  const links = [
    {
      name: "contoso-uplink",
      polarization: "LHCP",
      direction: "Uplink",
      gainOverTemperature: 0,
      eirpdBW: 45,
      channels: [
        {
          name: "contoso-uplink-channel",
          centerFrequencyMHz: 2250.0,
          bandwidthMHz: 2.0,
          endPoint: {
            ipAddress: "10.1.0.4",
            endPointName: "ContosoTest_Uplink",
            port: "50000",
            protocol: "TCP",
          },
        },
      ],
    },
    {
      name: "contoso-downlink",
      polarization: "RHCP",
      direction: "Downlink",
      gainOverTemperature: 25.0,
      eirpdBW: 0.0,
      channels: [
        {
          name: "contoso-downlink-channel",
          centerFrequencyMHz: 8160.0,
          bandwidthMHz: 15.0,
          endPoint: {
            ipAddress: "10.1.0.5",
            endPointName: "ContosoTest_Downlink",
            port: "50001",
            protocol: "UDP",
          },
        },
      ],
    },
  ];

  const credential = new DefaultAzureCredential();
  const client = new AzureOrbital(credential, subscriptionId);
  const result = await client.contactProfiles.beginCreateOrUpdateAndWait(
    resourceGroupName,
    contactProfileName,
    location,
    networkConfiguration,
    links
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:

200

Azure-AsyncOperation: https://management.azure.com/Microsoft.Orbital/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2022-11-01

Response Body

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

Status code:

201

Azure-AsyncOperation: https://management.azure.com/Microsoft.Orbital/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2022-11-01

Response Body

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

Definizioni

Nome	Descrizione
AutoTrackingConfiguration	Configurazione del rilevamento automatico.
ContactProfile	Il cliente crea una risorsa del profilo di contatto, che conterrà tutte le configurazioni necessarie per la pianificazione di un contatto.
ContactProfileLink	Collegamento al profilo di contatto.
ContactProfileLinkChannel	Canale di collegamento del profilo di contatto.
ContactProfileThirdPartyConfiguration	Configurazione del partner di terze parti del profilo di contatto.
createdByType	Tipo di identità che ha creato la risorsa.
direction	Direzione (Uplink o Downlink).
EndPoint	Punto finale del cliente per archiviare e recuperare i dati durante un contatto con il veicolo spaziale.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
NetworkConfiguration	Configurazione di rete della rete virtuale del cliente.
polarization	Polarizzazione. ad esempio (RHCP, LHCP).
protocol	Protocollo UDP o TCP.
ProvisioningState	Stato corrente della creazione, eliminazione o modifica della risorsa.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.

AutoTrackingConfiguration

Configurazione del rilevamento automatico.

Nome	Tipo	Descrizione
disabled	string
sBand	string
xBand	string

ContactProfile

Il cliente crea una risorsa del profilo di contatto, che conterrà tutte le configurazioni necessarie per la pianificazione di un contatto.

Nome	Tipo	Descrizione
id	string	ID di risorsa completo per la risorsa. Ad esempio - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	Posizione geografica in cui risiede la risorsa
name	string	nome della risorsa.
properties.autoTrackingConfiguration	AutoTrackingConfiguration	Configurazione del rilevamento automatico.
properties.eventHubUri	string	Identificatore di risorsa ARM dell'hub eventi usato per la telemetria. È necessario concedere al provider di risorse Orbital i diritti per inviare i dati di telemetria nell'hub.
properties.links	ContactProfileLink[]	Collegamenti del profilo di contatto. Vengono descritti i collegamenti RF, l'elaborazione del modem e gli endpoint IP.
properties.minimumElevationDegrees	number	Elevazione minima praticabile per il contatto in gradi decimali. Utilizzato per elencare i contatti disponibili con un veicolo spaziale in una determinata stazione di terra.
properties.minimumViableContactDuration	string	Durata minima del contatto valido in formato ISO 8601. Utilizzato per elencare i contatti disponibili con un veicolo spaziale in una determinata stazione di terra.
properties.networkConfiguration	NetworkConfiguration	Configurazione di rete della rete virtuale del cliente.
properties.provisioningState	ProvisioningState	Stato corrente della creazione, eliminazione o modifica della risorsa.
properties.thirdPartyConfigurations	ContactProfileThirdPartyConfiguration[]	Configurazione della missione di terze parti del profilo di contatto. Vengono descritti i collegamenti RF, l'elaborazione del modem e gli endpoint IP.
systemData	systemData	Azure Resource Manager metadati contenenti le informazioni createdBy e modifiedBy.
tags	object	Tag delle risorse.
type	string	Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

ContactProfileLink

Collegamento al profilo di contatto.

Nome	Tipo	Descrizione
channels	ContactProfileLinkChannel[]	Canale di collegamento del profilo di contatto.
direction	direction	Direzione (Uplink o Downlink).
eirpdBW	number	Potenza EIRP (Effective Isotropic Radiated Power) in dBW. È l'EIRP richiesto dal cliente. Non ancora usato.
gainOverTemperature	number	Ottenere la temperatura del rumore in db/K. È il G/T richiesto dal cliente. Non ancora usato.
name	string	Nome del collegamento.
polarization	polarization	Polarizzazione. ad esempio (RHCP, LHCP).

ContactProfileLinkChannel

Canale di collegamento del profilo di contatto.

Nome	Tipo	Descrizione
bandwidthMHz	number	Larghezza di banda in MHz.
centerFrequencyMHz	number	Frequenza centrale in MHz.
decodingConfiguration	string	Attualmente inutilizzato.
demodulationConfiguration	string	Copia del file di configurazione del modem, ad esempio Kratos QRadio o Kratos QuantumRx. Valido solo per le direzioni downlink. Se specificato, il modem si connette all'endpoint del cliente e invia dati demodulati anziché un flusso VITA.49.
encodingConfiguration	string	Attualmente inutilizzato.
endPoint	EndPoint	Punto finale del cliente per archiviare e recuperare i dati durante un contatto con il veicolo spaziale.
modulationConfiguration	string	Copia del file di configurazione del modem, ad esempio Kratos QRadio. Valido solo per le direzioni uplink. Se specificato, il modem si connette all'endpoint del cliente e accetta i comandi del cliente anziché un flusso VITA.49.
name	string	Nome del canale.

ContactProfileThirdPartyConfiguration

Configurazione del partner di terze parti del profilo di contatto.

Nome	Tipo	Descrizione
missionConfiguration	string	Nome della stringa che fa riferimento alla configurazione che descrive la configurazione del contatto per una determinata missione. I valori previsti sono quelli creati in collaborazione con la rete partner.
providerName	string	Nome del provider di terze parti.

createdByType

Tipo di identità che ha creato la risorsa.

Nome	Tipo	Descrizione
Application	string
Key	string
ManagedIdentity	string
User	string

direction

Direzione (Uplink o Downlink).

Nome	Tipo	Descrizione
Downlink	string
Uplink	string

EndPoint

Punto finale del cliente per archiviare e recuperare i dati durante un contatto con il veicolo spaziale.

Nome	Tipo	Descrizione
endPointName	string	Nome di un punto finale.
ipAddress	string	Indirizzo IP (IPv4).
port	string	Porta TCP su cui rimanere in ascolto per ricevere i dati.
protocol	protocol	Protocollo UDP o TCP.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

NetworkConfiguration

Configurazione di rete della rete virtuale del cliente.

Nome	Tipo	Descrizione
subnetId	string	Identificatore di risorsa ARM della subnet delegata a Microsoft.Orbital/orbitalGateways. Deve essere almeno una subnet C di classe e non deve essere creato alcun indirizzo IP.

polarization

Polarizzazione. ad esempio (RHCP, LHCP).

Nome	Tipo	Descrizione
LHCP	string
RHCP	string
linearHorizontal	string
linearVertical	string

protocol

Protocollo UDP o TCP.

Nome	Tipo	Descrizione
TCP	string
UDP	string

ProvisioningState

Stato corrente della creazione, eliminazione o modifica della risorsa.

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string	Timestamp della creazione di risorse (UTC).
createdBy	string	Identità che ha creato la risorsa.
createdByType	createdByType	Tipo di identità che ha creato la risorsa.
lastModifiedAt	string	Timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy	string	Identità che ha modificato l'ultima volta la risorsa.
lastModifiedByType	createdByType	Tipo di identità che ha modificato l'ultima volta la risorsa.