AWS CloudFormation Filtros de destino de ganchos - AWS CloudFormation
Exemplos de filtros de destino

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á.

AWS CloudFormation Filtros de destino de ganchos

Este tópico fornece orientação sobre como configurar filtros de destino para AWS CloudFormation Hooks. Você pode usar filtros de destino para obter um controle mais granular sobre quando e em quais recursos seu Hook é invocado. Você pode configurar filtros que vão desde a simples segmentação por tipo de recurso até combinações mais complexas de tipos de recursos, ações e pontos de invocação.

Para especificar um ou mais nomes de pilha como filtros na configuração do Hooks, adicione uma TargetFilters chave abaixo. HookConfiguration

TargetFilterssuporta as seguintes propriedades.

Actions

Uma matriz de seqüências de caracteres que especifica as ações a serem direcionadas. Para obter um exemplo, consulte Exemplo 1: filtro de destino básico.

Valores válidos: CREATE | UPDATE | DELETE

nota

ParaRESOURCE,STACK, e CLOUD_CONTROL metas, todas as ações-alvo são aplicáveis. Para CHANGE_SET alvos, somente a CREATE ação é aplicável. Para obter mais informações, consulte Alvos de gancho.

InvocationPoints

Uma matriz de strings que especifica os pontos de invocação a serem alvos.

Valores válidos: PRE_PROVISION

TargetNames

Uma matriz de seqüências de caracteres que especifica os nomes dos tipos de recursos a serem segmentados, por exemplo,AWS::S3::Bucket.

Os nomes de destino oferecem suporte a nomes de alvos concretos e à correspondência completa de curingas. Para obter mais informações, consulte Usando curingas com nomes de destino de Hook.

Pattern: ^[a-zA-Z0-9]{2,64}::[a-zA-Z0-9]{2,64}::[a-zA-Z0-9]{2,64}$

Maximum: 50

Targets

Uma matriz de objetos que especifica a lista de destinos a serem usados para filtragem de alvos.

Cada alvo na matriz de alvos tem as seguintes propriedades.

Actions

A ação para o alvo especificado.

Valores válidos: CREATE | UPDATE | DELETE

InvocationPoints

O ponto de invocação para o alvo especificado.

Valores válidos: PRE_PROVISION

TargetNames

O nome do tipo de recurso a ser segmentado.

nota

Você não pode incluir a matriz de Targets objetos e as InvocationPoints matrizes TargetNamesActions, ou ao mesmo tempo. Se você quiser usar esses três itens eTargets, deverá incluí-los na matriz de Targets objetos. Para obter um exemplo, consulte Exemplo 2: Usando a matriz de Targets objetos.

Exemplos de filtros de destino

Esta seção fornece exemplos que você pode seguir para criar filtros de destino para AWS CloudFormation Hooks.

Exemplo 1: filtro de destino básico

Para criar um filtro de destino básico que se concentre em tipos de recursos específicos, use o TargetFilters objeto com a Actions matriz. A configuração do filtro de destino a seguir invocará o Hook em todas as Create Delete ações e para as operações de destino especificadas (nesse caso, ambas RESOURCE as STACK operações). Update

{
  "CloudFormationConfiguration": {
    "HookConfiguration": {
      "HookInvocationStatus": "ENABLED",
      "TargetOperations": [
        "STACK",
        "RESOURCE"
      ],
      "FailureMode": "WARN",
      "Properties": {},
      "TargetFilters": {
        "Actions": [
           "Create",
           "Update",
           "Delete"
        ]
      }
    }
  }
}

Exemplo 2: Usando a matriz de Targets objetos

Para filtros mais avançados, você pode usar a matriz de Targets objetos para listar combinações específicas de destino, ação e ponto de invocação. A configuração do filtro de destino a seguir invocará o Hook before CREATE e as UPDATE ações nos buckets do S3 e nas tabelas do DynamoDB. Isso se aplica tanto às RESOURCE operações STACK quanto às operações.

{
  "CloudFormationConfiguration": {
    "HookConfiguration": {
      "HookInvocationStatus": "ENABLED",
      "TargetOperations": [
        "STACK",
        "RESOURCE"
      ],
      "FailureMode": "WARN",
      "Properties": {},
      "TargetFilters": {
        "Targets": [
          {
             "TargetName": "AWS::S3::Bucket",
             "Action": "CREATE",
             "InvocationPoint": "PRE_PROVISION"
          },
          {
             "TargetName": "AWS::S3::Bucket",
             "Action": "UPDATE",
             "InvocationPoint": "PRE_PROVISION"
          },
          {
             "TargetName": "AWS::DynamoDB::Table",
             "Action": "CREATE",
             "InvocationPoint": "PRE_PROVISION"
          },
          {
             "TargetName": "AWS::DynamoDB::Table",
             "Action": "UPDATE",
             "InvocationPoint": "PRE_PROVISION"
          }
        ]               
      }
    }
  }
}