Freigeben über


Contacts - Create

Erstellt einen Kontakt.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
contactName
path True

string

Name des Kontakts.

resourceGroupName
path True

string

Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet.

spacecraftName
path True

string

Raumfahrzeug-ID.

subscriptionId
path True

string

Hierbei handelt es sich um die ID des Zielabonnements.

api-version
query True

string

Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Anforderungstext

Name Erforderlich Typ Beschreibung
properties.contactProfile True

ContactProfile

Der Verweis auf die Kontaktprofilressource.

properties.groundStationName True

string

Name der Azure Ground Station.

properties.reservationEndTime True

string

Reservierungsendzeit eines Kontakts (ISO 8601 UTC-Standard).

properties.reservationStartTime True

string

Reservierungsstartzeit eines Kontakts (ISO 8601 UTC-Standard).

properties.provisioningState

ProvisioningState

Der aktuelle Status der Erstellung, Löschung oder Änderung der Ressource.

Antworten

Name Typ Beschreibung
200 OK

Contact

OK.

201 Created

Contact

Erfolgreich erstellen. Der Vorgang gibt die resultierende Kontaktressource zurück.

Header

Azure-AsyncOperation: string

Other Status Codes

ErrorResponse

Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Beispiele

Create a contact

Beispielanforderung

PUT https://management.azure.com/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.Orbital/spacecrafts/CONTOSO_SAT/contacts/contact1?api-version=2022-11-01

{
  "properties": {
    "reservationStartTime": "2023-02-22T10:58:30Z",
    "reservationEndTime": "2023-02-22T11:10:45Z",
    "groundStationName": "EASTUS2_0",
    "contactProfile": {
      "id": "/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.Orbital/contactProfiles/CONTOSO-CP"
    }
  }
}

Beispiel für eine Antwort

Azure-AsyncOperation: https://management.azure.com/Microsoft.Orbital/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2022-11-01
{
  "id": "/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.Orbital/spacecrafts/CONTOSO_SAT/contacts/contact1",
  "name": "contact1",
  "type": "Microsoft.Orbital/spacecrafts/contacts",
  "properties": {
    "status": "scheduled",
    "reservationStartTime": "2023-02-22T10:58:30Z",
    "reservationEndTime": "2023-02-22T11:10:45Z",
    "errorMessage": null,
    "groundStationName": "EASTUS2_0",
    "contactProfile": {
      "id": "/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.Orbital/contactProfiles/CONTOSO-CP"
    },
    "antennaConfiguration": null,
    "maximumElevationDegrees": 85.9796,
    "txStartTime": "2023-02-22T10:58:30Z",
    "txEndTime": "2023-02-22T11:10:45Z",
    "rxStartTime": "2023-02-22T10:58:30Z",
    "rxEndTime": "2023-02-22T11:10:45Z",
    "startAzimuthDegrees": 165.758896,
    "endAzimuthDegrees": 345.848482,
    "startElevationDegrees": 5,
    "endElevationDegrees": 5.048656
  }
}
Azure-AsyncOperation: https://management.azure.com/Microsoft.Orbital/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2022-11-01
{
  "id": "/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.Orbital/spacecrafts/CONTOSO_SAT/contacts/contact1",
  "name": "contact1",
  "type": "Microsoft.Orbital/spacecrafts/contacts",
  "properties": {
    "status": "scheduled",
    "reservationStartTime": "2023-02-22T10:58:30Z",
    "reservationEndTime": "2023-02-22T11:10:45Z",
    "errorMessage": null,
    "groundStationName": "EASTUS2_0",
    "contactProfile": {
      "id": "/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.Orbital/contactProfiles/CONTOSO-CP"
    },
    "antennaConfiguration": null,
    "maximumElevationDegrees": 0,
    "txStartTime": null,
    "txEndTime": null,
    "rxStartTime": null,
    "rxEndTime": null,
    "startAzimuthDegrees": 0,
    "endAzimuthDegrees": 0,
    "startElevationDegrees": 0,
    "endElevationDegrees": 0
  }
}

Definitionen

Name Beschreibung
AntennaConfiguration

Die Konfiguration, die der zugeordneten Antenne zugeordnet ist.

Contact

Der Kunde erstellt eine Kontaktressource für eine Raumfahrzeugressource.

ContactProfile

Der Verweis auf die Kontaktprofilressource.

ContactsStatus

Status eines Kontakts.

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

ErrorDetail

Die Fehlerdetails.

ErrorResponse

Fehlerantwort

ProvisioningState

Der aktuelle Status der Erstellung, Löschung oder Änderung der Ressource.

systemData

Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.

AntennaConfiguration

Die Konfiguration, die der zugeordneten Antenne zugeordnet ist.

Name Typ Beschreibung
destinationIp

string

Die Ziel-IP-Adresse, an die ein Paket gesendet werden kann. Dies wäre beispielsweise der TCP-Endpunkt, an den Sie Daten senden würden.

sourceIps

string[]

Liste der Quell-IP-Adressen

Contact

Der Kunde erstellt eine Kontaktressource für eine Raumfahrzeugressource.

Name Typ Beschreibung
id

string

Vollqualifizierte Ressourcen-ID für die Ressource. Beispiel: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

Der Name der Ressource

properties.antennaConfiguration

AntennaConfiguration

Die Konfiguration, die der zugeordneten Antenne zugeordnet ist.

properties.contactProfile

ContactProfile

Der Verweis auf die Kontaktprofilressource.

properties.endAzimuthDegrees

number

Azimut der Antenne am Ende des Kontakts in Dezimalgrad.

properties.endElevationDegrees

number

Raumfahrzeughöhe über dem Horizont am Kontaktende.

properties.errorMessage

string

Jede Fehlermeldung beim Planen eines Kontakts.

properties.groundStationName

string

Name der Azure Ground Station.

properties.maximumElevationDegrees

number

Maximale Höhe der Antenne während des Kontakts in Dezimalgraden.

properties.provisioningState

ProvisioningState

Der aktuelle Status der Erstellung, Löschung oder Änderung der Ressource.

properties.reservationEndTime

string

Reservierungsendzeit eines Kontakts (ISO 8601 UTC-Standard).

properties.reservationStartTime

string

Reservierungsstartzeit eines Kontakts (ISO 8601 UTC-Standard).

properties.rxEndTime

string

Empfangen der Endzeit eines Kontakts (ISO 8601 UTC-Standard).

properties.rxStartTime

string

Empfangen der Startzeit eines Kontakts (ISO 8601 UTC-Standard).

properties.startAzimuthDegrees

number

Azimut der Antenne am Anfang des Kontakts in Dezimalgrad.

properties.startElevationDegrees

number

Raumfahrzeughöhe über dem Horizont beim Kontaktstart.

properties.status

ContactsStatus

Status eines Kontakts.

properties.txEndTime

string

Senden der Endzeit eines Kontakts (ISO 8601 UTC-Standard).

properties.txStartTime

string

Sendestartzeit eines Kontakts (ISO 8601 UTC-Standard).

systemData

systemData

Azure Resource Manager-Metadaten mit createdBy- und modifiedBy-Informationen.

type

string

Der Typ der Ressource. Z.B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

ContactProfile

Der Verweis auf die Kontaktprofilressource.

Name Typ Beschreibung
id

string

Ressourcen-ID

ContactsStatus

Status eines Kontakts.

Name Typ Beschreibung
cancelled

string

failed

string

providerCancelled

string

scheduled

string

succeeded

string

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

Name Typ Beschreibung
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

Name Typ Beschreibung
info

object

Zusätzliche Informationen.

type

string

Typ der zusätzlichen Informationen.

ErrorDetail

Die Fehlerdetails.

Name Typ Beschreibung
additionalInfo

ErrorAdditionalInfo[]

Die zusätzlichen Fehlerinformationen.

code

string

Der Fehlercode.

details

ErrorDetail[]

Die Fehlerdetails.

message

string

Die Fehlermeldung.

target

string

Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name Typ Beschreibung
error

ErrorDetail

Das Fehlerobjekt.

ProvisioningState

Der aktuelle Status der Erstellung, Löschung oder Änderung der Ressource.

systemData

Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.

Name Typ Beschreibung
createdAt

string

Der Zeitstempel der Ressourcenerstellung (UTC).

createdBy

string

Die Identität, die die Ressource erstellt hat.

createdByType

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

lastModifiedAt

string

Der Zeitstempel der letzten Änderung der Ressource (UTC)

lastModifiedBy

string

Die Identität, die die Ressource zuletzt geändert hat.

lastModifiedByType

createdByType

Der Identitätstyp, der die Ressource zuletzt geändert hat.