aws:assertAwsResourceProperty: asserzione di uno stato della risorsa di AWS o stato evento - AWS Systems Manager

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

aws:assertAwsResourceProperty: asserzione di uno stato della risorsa di AWS o stato evento

L'operazione aws:assertAwsResourceProperty consente di verificare lo stato di una risorsa o un evento specifico per una fase di automazione particolare. Ad esempio, puoi specificare che una fase di automazione debba attendere l'avvio di un'istanza di Amazon Elastic Compute Cloud (Amazon EC2). Verrà quindi eseguita una chiamata all'operazione API DescribeInstanceStatus di Amazon EC2 con la proprietà DesiredValue di running. In questo modo l'automazione rimane in attesa di un'istanza in esecuzione e quindi continua l'elaborazione quando l'istanza è effettivamente in esecuzione.

Per ulteriori esempi di utilizzo di questa operazione, consulta Ulteriori esempi di runbook.

Input

Gli input vengono definiti dall'operazione API selezionata.

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

Spazio dei nomi di AWS servizio contenente l'operazione API che si desidera eseguire. Ad esempio, lo spazio dei nomi per Systems Manager è ssm. Lo spazio dei nomi per Amazon EC2 è ec2. Puoi visualizzare un elenco di spazi dei nomi AWS servizio supportati nella sezione Available Services (Servizi disponibili) di AWS CLI Command Reference.

Tipo: string

Campo obbligatorio: sì

Api

Nome dell'operazione API da eseguire. Puoi visualizzare le operazioni API (definite anche metodi) scegliendo un servizio nel pannello di navigazione a sinistra nella pagina Services Reference (Informazioni di riferimento relative ai servizi). Scegliere un metodo nella sezione Client del servizio che si desidera chiamare. Ad esempio, tutte le operazioni API (metodi) per Amazon Relational Database Service (Amazon RDS) sono elencate nella seguente pagina: Amazon RDS methods (Metodi Amazon RDS).

Tipo: string

Campo obbligatorio: sì

Input dell'operazione API

Uno o più input dell'operazione API. Puoi visualizzare gli input disponibili (definiti anche parametri) scegliendo un servizio nel pannello di navigazione a sinistra nella pagina Services Reference (Informazioni di riferimento relative ai servizi). Scegliere un metodo nella sezione Client del servizio che si desidera chiamare. Ad esempio, tutti i metodi per Amazon RDS sono elencati nella pagina: Amazon RDS methods (metodi di Amazon RDS). Scegliere il metodo describe_db_instances e scorrere verso il basso fino a visualizzare i parametri disponibili, ad esempio DBInstanceIdentifier, Name e Values. Usare il seguente formato per specificare più di un input.

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

Tipo: determinato dall'operazione API selezionata

Campo obbligatorio: sì

PropertySelector

Elemento JSONPath di un attributo specifico nell'oggetto di risposta. Puoi visualizzare gli oggetti di risposta scegliendo un servizio nel pannello di navigazione a sinistra nella pagina Services Reference (Informazioni di riferimento relative ai servizi). Scegliere un metodo nella sezione Client del servizio che si desidera chiamare. Ad esempio, tutti i metodi per Amazon RDS sono elencati nella pagina: Amazon RDS methods (metodi di Amazon RDS). Scegliere il metodo describe_db_instances e scorrere fino alla sezione Response Structure (Struttura risposta). DBInstances è presente nell'elenco come oggetto di risposta.

Tipo: string

Campo obbligatorio: sì

DesiredValues

Stato previsto o stato con il quale continuare l'automazione. Se specifichi un valore booleano, devi utilizzare una lettera maiuscola, ad esempio True o False.

Tipo: StringList

Campo obbligatorio: sì