As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# VariableCheck
<a name="rule-reference-VariableCheck"></a>

Ao criar uma condição, você pode adicionar a regra `VariableCheck`. Esta seção fornece uma referência para os parâmetros da regra. Para ter mais informações sobre regras e condições, consulte [Como funcionam as condições do estágio?](concepts-how-it-works-conditions.md).

A regra `VariableCheck` pode ser utilizada para definir uma condição que verifica a variável de saída em relação a uma expressão especificada. A regra passa na verificação quando o valor da variável atende aos critérios da regra, como o valor ser igual ou maior que uma variável de saída especificada.

**Topics**
+ [Tipo de regra](#rule-reference-VariableCheck-type)
+ [Parâmetros de configuração](#rule-reference-VariableCheck-config)
+ [Exemplo de configuração de regra](#rule-reference-VariableCheck-example)
+ [Consulte também](#rule-reference-VariableCheck-links)

## Tipo de regra
<a name="rule-reference-VariableCheck-type"></a>
+ Categoria: `Rule`
+ Proprietário: `AWS`
+ Fornecedor: `VariableCheck`
+ Versão: `1`

## Parâmetros de configuração
<a name="rule-reference-VariableCheck-config"></a>

**Operador**  
Obrigatório: Sim  
O operador que indica qual operação executar para a verificação da variável.  
No exemplo a seguir, a variável de saída do nome do repositório será verificada para verificar se é igual a `MyDemoRepo`.  

```
        "configuration": {
            "Variable": "#{SourceVariables.RepositoryName}",
            "Value": "MyDemoRepo",
            "Operator": "EQ"
        },
```
Os operadores estão disponíveis para criar uma expressão da seguinte maneira.  
+ **Equals**: escolha esse operador para verificar se a variável é igual ao valor da string.

  **Parâmetro da CLI:** `EQ`
+ **Contains**: escolha esse operador para verificar se a variável contém o valor da string como uma substring.

  **Parâmetro da CLI:** `CONTAINS`
+ **Matches**: escolha esse operador para verificar se a variável corresponde a uma determinada expressão regex como o valor da string. 

  Todas as expressões regulares estão em CodePipeline conformidade com a sintaxe regex Java. Consulte uma descrição abrangente da sintaxe regex do Java e de seus constructos em [java.util.regex.Pattern](https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/util/regex/Pattern.html).

  **Parâmetro da CLI:** `MATCHES`
+ **Not equals**: escolha esse operador para verificar se a variável não é igual ao valor da string.

  **Parâmetro da CLI:** `NE`

**Variável**  
Obrigatório: Sim  
As variáveis do pipeline a serem verificadas.

**Valor**  
Obrigatório: Sim  
O valor da expressão a ser verificada.  
No exemplo a seguir, a variável de saída do nome do repositório será verificada para verificar se é igual a `MyDemoRepo`.  

```
        "configuration": {
            "Variable": "#{SourceVariables.RepositoryName}",
            "Value": "MyDemoRepo",
            "Operator": "EQ"
        },
```

No exemplo de JSON a seguir, duas regras separadas são definidas, uma para uma instrução `EQ` (equals) que verifica o nome do repositório e da ramificação formatado como \$1 \$1. SourceVariables RepositoryName\$1 e um para `CONTAINS` isso verifica a variável de saída da mensagem de confirmação formatada como \$1 \$1SourceVariables. CommitMessage\$1 em relação ao valor fornecido “atualizar”.

```
  "beforeEntry": {
                    "conditions": [
                        {
                            "result": "FAIL",
                            "rules": [
                                {
                                    "name": "MyVarCheckRule",
                                    "ruleTypeId": {
                                        "category": "Rule",
                                        "owner": "AWS",
                                        "provider": "VariableCheck",
                                        "version": "1"
                                    },
                                    "configuration": {
                                        "Operator": "EQ",
                                        "Value": "MyDemoRepo",
                                        "Variable": "#{SourceVariables.RepositoryName}"
                                    },
                                    "inputArtifacts": [],
                                    "region": "us-east-1"
                                },
                                {
                                    "name": "MyVarCheckRuleContains",
                                    "ruleTypeId": {
                                        "category": "Rule",
                                        "owner": "AWS",
                                        "provider": "VariableCheck",
                                        "version": "1"
                                    },
                                    "configuration": {
                                        "Operator": "CONTAINS",
                                        "Value": "update",
                                        "Variable": "#{SourceVariables.CommitMessage}"
                                    },
                                    "inputArtifacts": [],
                                    "region": "us-east-1"
                                }
                            ]
                        }
                    ]
                }
            }
        ],
```

## Exemplo de configuração de regra
<a name="rule-reference-VariableCheck-example"></a>

------
#### [ YAML ]

```
- name: MyVariableCheck
  ruleTypeId:
    category: Rule
    owner: AWS
    provider: VariableCheck
    version: '1'
  configuration:
    Variable: "#{SourceVariables.RepositoryName}"
    Value: MyDemoRepo
    Operator: EQ
  inputArtifacts: []
  region: us-west-2
```

------
#### [ JSON ]

```
"rules": [
    {
        "name": "MyVariableCheck",
        "ruleTypeId": {
            "category": "Rule",
            "owner": "AWS",
            "provider": "VariableCheck",
            "version": "1"
        },
        "configuration": {
            "Variable": "#{SourceVariables.RepositoryName}",
            "Value": "MyDemoRepo",
            "Operator": "EQ"
        },
        "inputArtifacts": [],
        "region": "us-west-2"
    }
]
```

------

## Consulte também
<a name="rule-reference-VariableCheck-links"></a>

Os recursos relacionados a seguir podem ajudar você a trabalhar com essa regra.
+ [Tutorial: criar uma regra de verificação de variável para um pipeline como uma condição de entrada](tutorials-varcheckrule.md): esta seção fornece um tutorial com etapas para criar uma condição Na entrada com uma regra de verificação de variáveis.
+ [Referência de variáveis](reference-variables.md): esta seção fornece informações de referência e exemplos para variáveis de pipeline.
+ Para obter mais informações sobre regras e condições, consulte [Condição](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_Condition.html) e [RuleExecution](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_RuleExecution.html)no *Guia da CodePipeline API*. [RuleTypeId](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_RuleTypeId.html)