Réservation et gestion des contacts avec AWS CLI

Vous pouvez l'utiliser AWS CLI pour réserver et gérer vos contacts dans AWS Ground Station. Avant AWS CLI de l'utiliser pour réserver et gérer des contacts, les AWS CLI conditions préalables suivantes doivent être remplies :

• Assurez-vous qu'il AWS CLI est installé. Pour plus d'informations sur l'installation AWS CLI, consultez Installation de la version 2 de l'interface de ligne de commande AWS.

• Assurez-vous qu'il AWS CLI est configuré. Pour plus d'informations sur la configuration AWS CLI, consultez Configuration de l'interface de ligne de commande AWS version 2.

• Enregistrez vos paramètres de configuration utilisés fréquemment et vos informations d'identification dans les fichiers qui sont gérés par l' AWS CLI. Vous avez besoin de ces paramètres et informations d'identification pour réserver et gérer vos AWS Ground Station contacts avec AWS CLI. Pour plus d'informations sur l'enregistrement de vos paramètres de configuration et d'informations d'identification, consultez Paramètres des fichiers de configuration et d'informations d'identification .

Une fois AWS CLI configuré et prêt à être utilisé, consultez la page de référence des commandes de l'AWS Ground Station CLI pour vous familiariser avec les commandes disponibles. Suivez la structure de AWS CLI commande lorsque vous utilisez ce service et préfixez vos commandes avec groundstation pour indiquer le service AWS Ground Station que vous souhaitez utiliser. Pour plus d'informations sur la structure de AWS CLI commande, consultez Structure de commande sur la page de l'AWS CLI. Un exemple de structure de commande est fourni ci-dessous.

aws groundstation <command> <subcommand> [options and parameters]

Utilisez les rubriques suivantes pour réserver, consulter et annuler des contacts avec AWS CLI.

Afficher et répertorier les contacts avec AWS CLI

Pour répertorier et afficher CANCELLEDCOMPLETED, ou SCHEDULED des contacts avec AWS CLI, exécutez aws groundstation list-contacts les paramètres suivants.

• Heure de début - Spécifiez l'heure de début de votre contact avec --start-time <value>. Voici un format de valeur temporelle acceptable : YYYY-MM-DDTHH:MM:SSZ

• Heure de fin - Spécifiez l'heure de fin de votre contact avec --end-time <value>. Voici un format de valeur temporelle acceptable : YYYY-MM-DDTHH:MM:SSZ

• Liste d'état - Spécifiez l’état de votre contact avec --status-list <value>. Les valeurs acceptables sont notamment les suivantes : AVAILABLE, CANCELLED, COMPLETED ou SCHEDULED. Pour afficher la liste complète des valeurs acceptables, consultez list-contacts.

Pour répertorier et afficher AWS CLI les AVAILABLE contacts, les paramètres suivants sont requis en plus de ceux listés ci-dessus.

• ID Ground Station - Spécifiez l'ID de votre station terrestre avec --ground-station <value>.

• ARN du profil de mission - Spécifiez l'ARN de votre profil de mission avec --mission-profile-arn <value>.

• ARN de satellite - Spécifiez l’ARN de votre satellite avec --satellite-arn <value>.

Vous pouvez utiliser des commandes list pour rechercher vos ressources. Pour plus d'informations sur la définition de vos paramètres, consultez list-contacts

Vous trouverez ci-dessous un exemple de commande pour répertorier les contacts disponibles.

aws groundstation --region us-east-2 list-contacts --ground-station 'Ohio 1' --mission-profile-arn 'arn:aws:groundstation:us-east-2:123456789012:mission-profile/11111111-2222-3333-4444-555555555555' --satellite-arn 'arn:aws:groundstation::123456789012:satellite/11111111-2222-3333-4444-555555555555' --start-time '2020-04-10T00:09:22Z' --end-time '2020-04-10T00:11:22' --status-list 'AVAILABLE'

Vous trouverez ci-dessous un exemple de liste des contacts disponibles.

{
  "contactList": [
    {
      "contactStatus": "AVAILABLE",
      "endTime": "2020-04-15T03:16:35-06:00",
      "groundStation": "Oregon 1",
      "maximumElevation": {
        "unit": "DEGREE_ANGLE",
        "value": 11.22
      },
      "missionProfileArn": "arn:aws:groundstation:us-west-2:111111111111:mission-profile/11111111-2222-3333-4444-555555555555",
      "region": "us-west-2",
      "satelliteArn": "arn:aws:groundstation::111111111111:satellite/11111111-2222-3333-4444-555555555555",
      "startTime": "2020-04-15T03:06:08-06:00"
    }
  ]
}

Réservez un contact avec AWS CLI

AWS CLI vous donne la possibilité de réserver des contacts à la minute près. Cette fonctionnalité est propre à la console AWS CLI et ne peut pas être utilisée dans la AWS Ground Station console.

Pour réserver des contacts avec AWS CLI, exécutez aws groundstation reserve-contact avec les paramètres suivants.

• ID Ground Station - Spécifiez l'ID de votre station terrestre avec --ground-station <value>.

• ARN du profil de mission - Spécifiez l'ARN de votre profil de mission avec --mission-profile-arn <value>.

• ARN de satellite - Spécifiez l’ARN de votre satellite avec --satellite-arn <value>.

• Heure de début - Spécifiez l'heure de début de votre contact avec --start-time <value>. Voici un format de valeur temporelle acceptable : YYYY-MM-DDTHH:MM:SSZ

• Heure de fin - Spécifiez l'heure de fin de votre contact avec --end-time <value>. Voici un format de valeur temporelle acceptable : YYYY-MM-DDTHH:MM:SSZ

La réservation de contacts est un processus asynchrone. La réponse à la reserve-contact commande fournit l'identifiant du contact. Afin de déterminer le résultat du processus de réservation asynchrone, utilisez. describe-contact Pour plus d'informations à ce sujet, consultez la section ci-dessous intituléeDécrivez un contact avec AWS CLI.

Vous pouvez utiliser des commandes list pour rechercher vos ressources. Pour plus d'informations sur la définition de vos paramètres, consultez reserve-contact.

Vous trouverez ci-dessous un exemple de commande de réservation d'un contact.

aws groundstation reserve-contact --ground-station 'Ohio 1' --mission-profile-arn 'arn:aws:groundstation:us-east-2:123456789012:mission-profile/11111111-2222-3333-4444-555555555555' --satellite-arn 'arn:aws:groundstation::123456789012:satellite/11111111-2222-3333-4444-555555555555' --start-time '2020-04-10T00:09:22Z' --end-time '2020-04-10T00:11:22'

Vous trouverez ci-dessous un exemple de contact réservé avec succès.

{
  "contactId": "11111111-2222-3333-4444-555555555555"
}

Décrivez un contact avec AWS CLI

Pour voir le statut d'un contact/d'une réservation auprès de AWS CLI, utilisez la commande describe-contact CLI. Cela est utile pour vérifier le résultat du processus de réservation de contacts asynchrone, surveiller le statut d'un contact en cours et déterminer le statut d'un contact terminé.

Pour décrire les contacts avec AWS CLI, exécutez la aws groundstation describe-contact commande avec les paramètres suivants.

• Numéro de contact - Spécifiez votre identifiant de contact avec--contact-id <value>.

Vous pouvez utiliser des commandes list pour rechercher vos ressources. Pour plus d'informations sur la définition de vos paramètres, consultez describe-contact.

Un exemple de commande permettant de décrire un contact est fourni ci-dessous.

aws groundstation describe-contact --contact-id 11111111-2222-3333-4444-555555555555

Vous trouverez ci-dessous un exemple de contact planifié avec succès.

{
  "groundStation": "Ireland 1",
  "tags": {},
  "missionProfileArn": "arn:aws:groundstation:us-west-2:111111111111:mission-profile/11111111-2222-3333-4444-555555555555",
  "region": "us-west-2",
  "contactId": "11111111-2222-3333-4444-555555555555",
  "prePassStartTime": 1645850471.0,
  "postPassEndTime": 1645851172.0,
  "startTime": 1645850591.0,
  "maximumElevation": {
      "value": 12.66,
      "unit": "DEGREE_ANGLE"
  },
  "satelliteArn": "arn:aws:groundstation::111111111111:satellite/11111111-2222-3333-4444-555555555555",
  "endTime": 1645851052.0,
  "contactStatus": "SCHEDULED"
}

Annuler un contact avec AWS CLI

Pour annuler un contact avec AWS CLI, exécutez aws groundstation cancel-contact avec les paramètres suivants.

• Région - Spécifiez la région de votre station terrestre avec --region <value>.

• ID de contact - Spécifiez l'ID de contact avec --contact-id <value>.

Vous pouvez utiliser des commandes list pour rechercher vos ressources. Pour plus d'informations sur la définition de vos paramètres, voir cancel-contacts

Vous trouverez ci-dessous un exemple de commande de réservation d'un contact.

aws groundstation --region us-east-2 cancel-contact --contact-id '11111111-2222-3333-4444-555555555555'

Vous trouverez ci-dessous un exemple d'un contact annulé avec succès.

{
  "contactId": "11111111-2222-3333-4444-555555555555"
}