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 Proton recursos e marcação

AWS Proton os recursos atribuídos a um Amazon Resource Name (ARN) incluem modelos de ambiente e suas versões principais e secundárias, modelos de serviço e suas versões principais e secundárias, ambientes, serviços, instâncias de serviço, componentes e repositórios. Você pode colocar tags nesses recursos para ajudar a organizá-los e identificá-los. Você pode usar tags para categorizar recursos por finalidade, proprietário, ambiente ou outros critérios. Para obter mais informações, consulte Estratégias de marcação da . Para rastrear e gerenciar seus atributos do AWS Proton , você pode usar os atributos de marcação descritos nas seções a seguir.

AWS etiquetando

Você pode atribuir metadados aos seus AWS recursos na forma de tags. Cada tag consiste em uma chave definida pelo cliente e um valor opcional. As tags podem ajudar você a gerenciar, identificar, organizar, pesquisar e filtrar recursos.

AWS Proton etiquetando

Com AWS Proton, você pode usar tanto as tags que você cria quanto as tags que AWS Proton são geradas automaticamente para você.

AWS ProtonAWS tags gerenciadas

Quando você cria um AWS Proton recurso, gera AWS Proton automaticamente tags AWS gerenciadas para seu novo recurso, conforme mostrado no diagrama a seguir. AWS posteriormente, as tags gerenciadas se propagam para outros AWS Proton recursos baseados em seu novo recurso. Por exemplo, as tags gerenciadas de um modelo de ambiente se propagam para suas versões e as tags gerenciadas de um serviço se propagam para suas instâncias de serviço.

Propagação de tags para recursos provisionados

Se os recursos provisionados, como aqueles definidos nos modelos de serviço e ambiente, oferecerem suporte à AWS marcação, as tags gerenciadas se propagarão como tags AWS gerenciadas pelo cliente para os recursos provisionados. Essas tags não se propagarão para um recurso provisionado que não ofereça suporte à marcação. AWS

AWS Proton aplica tags aos seus recursos por AWS Proton contas, modelos registrados e ambientes implantados, bem como serviços e instâncias de serviço, conforme descrito na tabela a seguir. Você pode usar tags AWS gerenciadas para visualizar e gerenciar seus AWS Proton recursos, mas não pode modificá-las.

Veja a seguir um exemplo de uma tag AWS gerenciada para um AWS Proton recurso.

"aws:proton:template" = "arn:aws:proton:region-id:account-id:environment-template/env-template"

Veja a seguir um exemplo de uma tag gerenciada pelo cliente aplicada a um recurso provisionado que foi propagada a partir de uma AWS tag gerenciada.

"proton:environment:database" = "arn:aws:proton:region-id:account-id:rds/env-db"

Com o provisionamento AWS gerenciado, AWS Proton aplica tags propagadas diretamente aos recursos provisionados.

Com o provisionamento autogerenciado, AWS Proton disponibiliza tags propagadas junto com os arquivos IaC renderizados que ele envia no pull request (PR) de provisionamento. As tags são fornecidas na variável proton_tags do mapa de cadeias de caracteres. Recomendamos que você faça uma referência a essa variável em sua configuração do Terraform para incluir AWS Proton tags. default_tags Isso propaga tags do AWS Proton para todos os recursos provisionados.

O exemplo a seguir mostra esse método de propagação de tags em um modelo de ambiente do Terraform.

Aqui está a definição da variável proton_tags:

proton.environment.variables.tf:

variable "environment" {
  type = object({
    inputs = map(string)
    name = string
  })
}

variable "proton_tags" {
  type = map(string)
  default = null
}

Veja como os valores das tags são atribuídos a essa variável:

proton.auto.tfvars.json:

{
  "environment": {
    "name": "dev",
    "inputs": {
      "ssm_parameter_value": "MyNewParamValue"
    }
  }

  "proton_tags" : {
    "proton:account" : "123456789012",
    "proton:template" : "arn:aws:proton:us-east-1:123456789012:environment-template/fargate-env",
    "proton:environment" : "arn:aws:proton:us-east-1:123456789012:environment/dev"
  }
}

E veja como você pode adicionar AWS Proton tags à sua configuração do Terraform para que elas sejam adicionadas aos recursos provisionados:

# Configure the AWS Provider
provider "aws" {
  region = var.aws_region
  default_tags {
    tags = var.proton_tags
  }
}

Tags gerenciadas pelo cliente

Cada AWS Proton recurso tem uma cota máxima de 50 tags gerenciadas pelo cliente. As tags gerenciadas pelo cliente se propagam para AWS Proton os recursos secundários da mesma forma que as tags AWS gerenciadas, exceto que elas não se propagam para AWS Proton os recursos existentes ou provisionados. Se você aplicar uma nova tag a um AWS Proton recurso com recursos secundários existentes e quiser que os recursos secundários existentes sejam marcados com a nova tag, você precisará marcar cada recurso secundário existente manualmente, usando o console ou AWS CLI.

Crie tags usando o console e a CLI

Ao criar um AWS Proton recurso usando o console, você tem a oportunidade de criar tags gerenciadas pelo cliente na primeira ou na segunda página do procedimento de criação, conforme mostrado no instantâneo do console a seguir. Escolha Adicionar nova tag, insira a chave e o valor e prossiga.

Depois de criar um novo recurso usando o AWS Proton console, você pode ver sua lista de tags AWS gerenciadas e gerenciadas pelo cliente na página de detalhes.

Crie tags usando o AWS ProtonAWS CLI

Você pode visualizar, criar, remover e editar tags usando AWS Proton AWS CLI o.

É possível criar ou editar uma tag para um recurso, conforme mostrado no exemplo a seguir.

$ aws proton tag-resource \
    --resource-arn "arn:aws:proton:region-id:account-id:service-template/webservice" \
    --tags '[{"key":"mykey1","value":"myval1"},{"key":"mykey2","value":"myval2"}]'

Você pode remover uma tag de um recurso, conforme mostrado no próximo exemplo.

$ aws proton untag-resource \
    --resource-arn "arn:aws:proton:region-id:account-id:service-template/webservice" \
    --tag-keys '["mykey1","mykey2"]'

Você pode listar as tags de um recurso, conforme mostrado no exemplo final.

$ aws proton list-tags-for-resource \
    --resource-arn "arn:aws:proton:region-id:account-id:service-template/webservice"