翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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

条件を作成するときに、`VariableCheck` ルールを追加できます。このセクションでは、ルールパラメータのリファレンスを提供します。ルールと条件の詳細については、「[ステージ条件はどのように機能しますか?](concepts-how-it-works-conditions.md)」を参照してください。

`VariableCheck` ルールを使用して、出力変数を、指定した式と照合する条件を作成できます。変数値がルール基準を満たすと (変数値が指定した出力変数以上であるなど)、ルールはチェックに合格します。

**Topics**
+ [ルールタイプ](#rule-reference-VariableCheck-type)
+ [設定パラメータ](#rule-reference-VariableCheck-config)
+ [ルール設定の例](#rule-reference-VariableCheck-example)
+ [関連情報](#rule-reference-VariableCheck-links)

## ルールタイプ
<a name="rule-reference-VariableCheck-type"></a>
+ カテゴリ: `Rule`
+ 所有者: `AWS`
+ プロバイダー: `VariableCheck`
+ バージョン: `1`

## 設定パラメータ
<a name="rule-reference-VariableCheck-config"></a>

**オペレーター**  
必須: はい  
変数チェックでどのオペレーションを実行するかを示す演算子。  
次の例では、リポジトリ名の出力変数が `MyDemoRepo` と等しいかどうかをチェックします。  

```
        "configuration": {
            "Variable": "#{SourceVariables.RepositoryName}",
            "Value": "MyDemoRepo",
            "Operator": "EQ"
        },
```
次の演算子は、以下に示すように式を作成するために使用できます。  
+ **等しい** - 変数が文字列値と等しいかどうかをチェックするには、この演算子を選択します。

  **CLI パラメータ:** `EQ`
+ **含む** - 変数に文字列値が部分文字列として含まれているかどうかを確認するには、この演算子を選択します。

  **CLI パラメータ:** `CONTAINS`
+ **一致** - 変数が特定の正規表現式と (文字列値として) 一致するかどうかをチェックするには、この演算子を選択します。

  CloudFormation のすべての正規表現は、Java の正規表現構文に準拠しています。Java の正規表現構文とそのコンストラクトの包括的な説明については、「[java.util.regex.Pattern](https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/util/regex/Pattern.html)」を参照してください。

  **CLI パラメータ:** `MATCHES`
+ **等しくない** - 変数が文字列値と等しくないかどうかを確認するには、この演算子を選択します。

  **CLI パラメータ:** `NE`

**変数**  
必須: はい  
チェックするパイプライン変数。

**値**  
必須: はい  
チェックする式の値。  
次の例では、リポジトリ名の出力変数が `MyDemoRepo` と等しいかどうかをチェックします。  

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

次の JSON の例では、2 つの個別のルールを定義しています。1 つは \$1\$1SourceVariables.RepositoryName\$1 としてフォーマットされたリポジトリ名とブランチ名をチェックする `EQ` (等しい) ステートメント用で、もう 1 つは \$1\$1SourceVariables.CommitMessage\$1 としてフォーマットされたコミットメッセージ出力変数を、指定した値「update」と照合する `CONTAINS` 用です。

```
  "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"
                                }
                            ]
                        }
                    ]
                }
            }
        ],
```

## ルール設定の例
<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"
    }
]
```

------

## 関連情報
<a name="rule-reference-VariableCheck-links"></a>

このルールを利用する際に以下の関連リソースが役立ちます。
+ [チュートリアル: パイプラインの変数チェックルールを入力条件として作成する](tutorials-varcheckrule.md) – このセクションでは、変数チェックルールを使用してエントリ時の条件を作成する手順を示すチュートリアルを提供します。
+ [変数リファレンス](reference-variables.md) – このセクションでは、パイプライン変数のリファレンス情報と例を示します。
+ ルールと条件の詳細については、「*CodePipeline API ガイド*」の「[条件](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_Condition.html)」、「[RuleTypeId](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_RuleTypeId.html)」、「[RuleExecution](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_RuleExecution.html)」を参照してください。