aws:assertAwsResourceProperty - Affirmer un statut de ressource AWS ou un statut d'événement - AWS Systems Manager

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

aws:assertAwsResourceProperty - Affirmer un statut de ressource AWS ou un statut d'événement

L'action aws:assertAwsResourceProperty vous permet d'imposer un état de ressource ou d'événement spécifique pour une étape d'automatisation. Par exemple, vous pouvez spécifier qu'une étape d'automatisation attende qu'une instance Amazon Elastic Compute Cloud (Amazon EC2) démarre. Ensuite, l'opération d'API DescribeInstanceStatus d'Amazon EC2 sera appelée, avec la propriété DesiredValue de running. Cela garantit que l'automatisation attend qu'une instance soit exécutée, puis qu'elle continue lorsque l'instance est en cours d'exécution.

Pour plus d'exemples sur l'utilisation de cette action, veuillez consulter la rubrique Exemples supplémentaires de runbook.

Entrée

Les entrées sont définies par l'opération d'API que vous sélectionnez.

YAML
action: aws:assertAwsResourceProperty
inputs:
  Service: The official namespace of the service
  Api: The API operation or method name
  API operation inputs or parameters: A value
  PropertySelector: Response object
  DesiredValues:
  - Desired property values
JSON
{
  "action": "aws:assertAwsResourceProperty",
  "inputs": {
    "Service":"The official namespace of the service",
    "Api":"The API operation or method name",
    "API operation inputs or parameters":"A value",
    "PropertySelector": "Response object",
    "DesiredValues": [
      "Desired property values"
    ]
  }
}
Service

L'espace de noms AWS service qui contient l'opération d'API que vous souhaitez exécuter. Par exemple, l'espace de noms pour Systems Manager est ssm. L'espace de noms pour Amazon EC2 est ec2. Vous pouvez voir la liste des espaces de noms AWS service pris en charge dans la section Available Services (Services disponibles) de la Référence AWS CLI Command.

Type : chaîne

Obligatoire : oui

Api

Le nom de l'opération d'API que vous voulez exécuter. Vous pouvez afficher les opérations d'API (également appelées méthodes) en choisissant un service dans le panneau de navigation de gauche sur la page Services Reference (Référence des services) suivante. Sélectionnez une méthode dans la section Client pour le service que vous voulez appeler. Par exemple, toutes les opérations d'API (méthodes) pour Amazon Relational Database Service (Amazon RDS) sont répertoriées à la page suivante : Méthodes pour Amazon RDS.

Type : chaîne

Obligatoire : oui

Entrées d'opérations d'API

Une ou plusieurs entrées d'opérations d'API. Vous pouvez afficher les entrées disponibles (également appelées paramètres) en choisissant un service dans le panneau de navigation de gauche sur la page Services Reference (Référence des services) suivante. Sélectionnez une méthode dans la section Client pour le service que vous voulez appeler. Par exemple, toutes les méthodes pour Amazon RDS sont répertoriées sur la page suivante : Méthodes Amazon RDS. Sélectionnez la méthode describe_db_instances et faites défiler la page vers le bas pour voir les paramètres disponibles, tels que DBInstanceIdentifier, Name et Values. Utilisez le format suivant pour spécifier plusieurs entrées.

YAML
inputs:
  Service: The official namespace of the service
  Api: The API operation name
  API input 1: A value
  API Input 2: A value
  API Input 3: A value
JSON
"inputs":{
      "Service":"The official namespace of the service",
      "Api":"The API operation name",
      "API input 1":"A value",
      "API Input 2":"A value",
      "API Input 3":"A value"
}

Type : déterminé par l'opération d'API choisie

Obligatoire : oui

PropertySelector

Chemin JSONPath vers un attribut dans l'objet de réponse. Vous pouvez afficher les objets de réponse en choisissant un service dans le panneau de navigation de gauche sur la page Services Reference (Référence des services) suivante. Sélectionnez une méthode dans la section Client pour le service que vous voulez appeler. Par exemple, toutes les méthodes pour Amazon RDS sont répertoriées sur la page suivante : Méthodes Amazon RDS. Sélectionnez la méthode describe_db_instances et faites défiler la page jusqu'à la section Response Structure (Structure d'une réponse). DBInstances est répertorié comme objet de réponse.

Type : chaîne

Obligatoire : oui

DesiredValues

État attendu ou état à partir duquel l'automatisation se poursuit. Si vous spécifiez une valeur booléenne, vous devez utiliser une majuscule, comme True ou False.

Type : StringList

Obligatoire : oui