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á.
# Gerenciar produtos provisionados
AWS Service Catalog fornece uma interface para gerenciar produtos provisionados. Você pode visualizar, atualizar e encerrar todos os produtos provisionados de seu catálogo com base no nível de acesso. Consulte as seções a seguir para obter procedimentos de exemplo.
**Topics**
+ [Gerenciar todos os produtos provisionados como administrador](provisioned-products-admin.md)
+ [Alterar o proprietário do produto provisionado](change-pp-owner.md)
+ [Atualizar modelos para produtos provisionados](pp-templates.md)
+ [Tutorial: Identificar alocação de recursos do usuário](provisioned-products-tutorial.md)
+ [Gerenciar erros de status do produto Terraform Open Source](provisioned-products-lifecycle.md)
+ [Gerenciar o arquivo do estado do produto Terraform Open Source](getstarted-terraform-engine-state.md)
# Gerenciar todos os produtos provisionados como administrador
Para gerenciar todos os produtos provisionados da conta, você precisa do `AWSServiceCatalogAdminFullAccess` ou uma permissão de IAM equivalente para acessar operações de gravação do produto provisionado. Para obter mais informações, consulte [Identity and Access Management em AWS Service Catalog](controlling_access.md).
**dica**
Para o encadeamento estático de produtos provisionados, você deve referenciar as saídas de produtos provisionados em um modelo de produto-artefato antes que o produto provisionado seja provisionado. Para obter mais informações, incluindo um exemplo, consulte o seguinte:
[AWS::ServiceCatalog::CloudFormationProvisionedProduct](https://amazonaws.com/AWSCloudFormation/latest/UserGuide/aws-resource-servicecatalog-cloudformationprovisionedproduct.html#aws-resource-servicecatalog-cloudformationprovisionedproduct--examples) no *AWS CloudFormation Guia do usuário*.
[DescribeProvisioningParameters (ProvisioningArtifactOutputKeys)](https://amazonaws.com/servicecatalog/latest/dg/API_DescribeProvisioningParameters.html#API_DescribeProvisioningParameters_ResponseElements) no *Guia do AWS Service Catalog desenvolvedor*.
**Para visualizar e gerenciar todos os produtos provisionados**
1. Abra o AWS Service Catalog console em [https://console.aws.amazon.com/servicecatalog/](https://console.aws.amazon.com/servicecatalog/).
Se você já estiver conectado ao AWS Service Catalog console, escolha **Service Catalog** e, em seguida, **End user**.
1. Se necessário, role para baixo até a seção **Produtos provisionados**.
1. Na seção **Produtos provisionados**, escolha a lista **Exibir:** e selecione o nível de acesso que você deseja ver: **Usuário**, **Perfil** ou **Conta**. Essa ação exibe todos os produtos provisionados no catálogo.
1. Escolha um produto provisionado para visualizar, atualizar ou encerrar. Para obter mais detalhes sobre as informações fornecidas nessa visualização, consulte [Visualizar informações sobre produtos provisionados](https://docs.aws.amazon.com/servicecatalog/latest/userguide/enduser-viewstack.html).
# Alterar o proprietário do produto provisionado
Você pode alterar o proprietário de um produto provisionado a qualquer momento. É necessário saber o ARN do usuário ou da função que deseja definir como o novo proprietário.
Por padrão, esse recurso está disponível para administradores que usam a política gerenciada `AWSServiceCatalogAdminFullAccess`. Você pode habilitá-lo para usuários finais concedendo a eles a `servicecatalog:UpdateProvisionedProductProperties` permissão no AWS Identity and Access Management (IAM).
**Como alterar o proprietário de um produto provisionado**
1. No AWS Service Catalog console, escolha Lista de **produtos provisionados**.
1. Localize o produto provisionado que deseja atualizar, escolha os três pontos ao lado dele e selecione **Alterar proprietário do produto provisionado)**.Você também pode encontrar a opção **Change owner (Alterar proprietário)** na página de detalhes do produto provisionado, no menu **Actions (Ações)**.
1. Na caixa de diálogo, insira o ARN do usuário ou da função que deseja definir como o novo proprietário. Um ARN começa com `arn:` e inclui outras informações separadas por dois pontos ou barras, por exemplo, `arn:aws:iam::123456789012:user/NewOwner`.
1. Selecione **Enviar**. Será exibida uma mensagem de êxito quando o proprietário for atualizado.
## Consulte também
+ [UpdateProvisionedProductProperties](https://docs.aws.amazon.com/servicecatalog/latest/dg/API_UpdateProvisionedProductProperties.html)
# Atualizar modelos para produtos provisionados
Você pode alterar o modelo atual de um produto provisionado para um modelo diferente. Por exemplo, se você tiver um produto EC2 no Service Catalog, poderá atualizar esse produto EC2 para reter a mesma ID do produto provisionado, mas alterar o modelo para um bucket do S3.
**nota**
A atualização de modelos não é suportada para produtos provisionados do Terraform Open Source ou do Terraform Cloud. Se quiser usar um modelo diferente para um produto Terraform existente, você deve excluir o produto e, em seguida, criar um novo produto usando o modelo desejado.
**Para atualizar modelos para produtos provisionados**
1. No menu de navegação à esquerda, escolha **Produtos provisionados**.
1. Em **Produtos provisionados**, escolha um produto provisionado e selecione **Ações**, **Atualizar**.
Observe que você também pode selecionar **Ações**, **Atualizar** na página de **Detalhes do produto provisionado**.
1. (Opcional) Em **Detalhes do produto**, escolha **Alterar produto**.
Em **Alterar produto**, observe este aviso:
*A alteração do produto atualizará esse produto provisionado para um modelo de produto diferente. Isso pode encerrar recursos e criar novos recursos.*
Você pode atualizar um produto provisionado para uma versão diferente dentro do mesmo produto.
1. (Opcional) Em **Produtos**, escolha o produto que você deseja atualizar com um modelo diferente. Em seguida, escolha **Alterar**.
Em **Detalhes do produto**, observe este aviso:
*[Nome do produto] será atualizado de [nome do modelo atual] para [nome do novo modelo]. No entanto, o nome do seu produto provisionado, [Nome do produto provisionado], não mudará.*
Você pode atualizar um produto provisionado para uma versão diferente dentro do mesmo produto.
1. Em **Versões do produto**, escolha a versão do produto que você deseja.
1. Em **Parâmetros**, escolha os parâmetros apropriados.
1. Selecione **Atualizar**.
Em **Detalhes do produto provisionado**, você pode ver os detalhes da atualização. O nome do produto provisionado não muda, mas o produto provisionado agora tem um modelo diferente.
# Tutorial: Identificar alocação de recursos do usuário
Você pode identificar o usuário que provisionou um produto e os recursos associados ao produto usando o AWS Service Catalog console. Este tutorial ajuda a converter este exemplo para seus próprios produtos provisionados específicos.
Para gerenciar todos os produtos provisionados da conta, você precisa do `AWSServiceCatalogAdminFullAccess` ou de acesso equivalente para as operações de gravação do produto provisionado. Para obter mais informações, consulte [Gerenciamento de identidade e acesso](https://docs.aws.amazon.com/servicecatalog/latest/adminguide/controlling_access.html) no *Guia do Administrador do AWS Service Catalog *.
**Para identificar o usuário que provisionou um produto e os recursos associados**
1. Abra [https://console.aws.amazon.com/servicecatalog](https://console.aws.amazon.com/servicecatalog).
1. No menu de navegação à esquerda, escolha **Produtos provisionados**.
1. No menu suspenso **Filtro de acesso**, escolha **Conta**.
![\[Provisioned products interface with search bar, access filter dropdown, and table columns.\]](http://docs.aws.amazon.com/pt_br/servicecatalog/latest/adminguide/images/access-filter-dropdown.png)
1. Na visualização **Conta**, escolha e abra um produto provisionado para exibir seus detalhes.
![\[Provisioned products table showing one S3 bucket product with its creation date and status.\]](http://docs.aws.amazon.com/pt_br/servicecatalog/latest/adminguide/images/account-view.png)
Você pode ver os detalhes do produto provisionado.
![\[Provisioned product details page showing status, ID, name, creation date, and other information.\]](http://docs.aws.amazon.com/pt_br/servicecatalog/latest/adminguide/images/details-pp.png)
1. Role para baixo até a seção **Eventos**. Observe os valores para `Provisioned product ID` e `CloudformationStackARN`.
![\[Events section showing UPDATE_PROVISIONED_PRODUCT with CloudFormationStackARN details.\]](http://docs.aws.amazon.com/pt_br/servicecatalog/latest/adminguide/images/events-container.png)
1. Use o ID do produto provisionado para identificar o AWS CloudTrail registro que corresponde a esse lançamento e identificar o usuário solicitante (normalmente, você insere um endereço de e-mail durante a federação). Neste exemplo, é "steve".
```
{
"eventVersion":"1.03","userIdentity":
{
"type":"AssumedRole",
"principalId":"[id]:steve",
"arn":"arn:aws:sts::[account number]:assumed-role/SC-usertest/steve",
"accountId":[account number],
"accessKeyId":[access key],
"sessionContext":
{
"attributes":
{
"mfaAuthenticated":[boolean],
"creationDate":[timestamp]
},
"sessionIssuer":
{
"type":"Role",
"principalId":"AROAJEXAMPLELH3QXY",
"arn":"arn:aws:iam::[account number]:role/[name]",
"accountId":[account number],
"userName":[username]
}
}
},
"eventTime":"2016-08-17T19:20:58Z","eventSource":"servicecatalog.amazonaws.com",
"eventName":"ProvisionProduct",
"awsRegion":"us-west-2",
"sourceIPAddress":[ip address],
"userAgent":"Coral/Netty",
"requestParameters":
{
"provisioningArtifactId":[id],
"productId":[id],
"provisioningParameters":[Shows all the parameters that the end user entered],
"provisionToken":[token],
"pathId":[id],
"provisionedProductName":[name],
"tags":[],
"notificationArns":[]
},
"responseElements":
{
"recordDetail":
{
"provisioningArtifactId":[id],
"status":"IN_PROGRESS",
"recordId":[id],
"createdTime":"Aug 17, 2016 7:20:58 PM",
"recordTags":[],
"recordType":"PROVISION_PRODUCT",
"provisionedProductType":"CFN_STACK",
"pathId":[id],
"productId":[id],
"provisionedProductName":"testSCproduct",
"recordErrors":[],
"provisionedProductId":[id]
}
},
"requestID":[id],
"eventID":[id],
"eventType":"AwsApiCall",
"recipientAccountId":[account number]
}
```
1. Use o `CloudformationStackARN` valor para identificar CloudFormation eventos e encontrar informações sobre os recursos criados. Você também pode usar a CloudFormation API para obter essas informações. Para saber mais, consulte [Referência de API do AWS CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/).
Você pode executar as etapas de 1 a 4 usando a AWS Service Catalog API ou AWS CLI o. Para obter mais informações, consulte o [Guia do Desenvolvedor do AWS Service Catalog](https://docs.aws.amazon.com/servicecatalog/latest/dg/what-is-service-catalog.html) e [AWS Service Catalog Referência de Linha de Comando. ](https://docs.aws.amazon.com/cli/latest/reference/servicecatalog/)
# Gerenciar erros de status do produto Terraform Open Source
As falhas de `ProvisionProduct` do Terraform Open Source são roteadas para o estado `TAINTED`, permitindo que cada produto provisionado continue para `UpdateProvisionedProduct`. Quando isso ocorre:
+ `UpdateProvisionedProduct` **não** faz uma tentativa de atualizar ou corrigir tags, nem de criar ou modificar um grupo de recursos.
+ `UpdateProvisionedProduct` **não** considera falhas de operações de provisionamento anteriores ao decidir se o produto provisionado deve ser definido como `AVAILABLE` ou `TAINTED`.
AWS Service Catalog só aplica tags durante`ProvisionProduct`. Qualquer falha na marcação resultante de uma falha na operação do `ProvisionProduct` **não** é resolvida automaticamente.
## Exemplos de erros de status
**Exemplo 1: AWS Service Catalog não cria um grupo de recursos durante** `ProvisionProduct`
No cenário abaixo, você tem um produto provisionado no estado `AVAILABLE`, mesmo que não haja um grupo de recursos de suporte e sem nenhuma tag aplicada aos recursos.
1. Sua ação inicia `ProvisionProduct`.
1. O mecanismo de provisionamento do Terraform responde ao `ProvisionProduct` com uma falha no fluxo de trabalho e não fornece um `ResourceIdentifier`.
1. O fluxo de trabalho `ProvisionProduct` não cria um grupo de recursos e, em seguida, define o estado do produto provisionado como `ERROR`.
1. Em seguida, você inicia a operação `UpdateProvisionedproduct`.
1. O mecanismo de provisionamento do Terraform responde indicando “sucesso”.
1. Como resultado, o fluxo de trabalho do `UpdateprovisionedProduct` define o estado do produto provisionado como `AVAILABLE`, mas **não** cria um grupo de recursos nem tenta aplicar tags.
**Exemplo 2: AWS Service Catalog cria novos recursos durante** `UpdateProvisionedProduct`
No cenário abaixo, você tem um produto provisionado no estado `AVAILABLE`, mesmo que os novos recursos **não** tenham nenhuma tag aplicada.
1. Sua ação inicia `ProvisionProduct`.
1. O mecanismo de provisionamento do Terraform responde indicando “sucesso” e fornece uma `ResourceIdentifier`.
1. O fluxo de trabalho do `ProvisionProduct` cria um grupo de recursos e aplica tags a todos os recursos identificados.
1. Você inicia `UpdateProvisionedProduct` em um novo artefato que cria novos recursos.
1. O mecanismo de provisionamento do Terraform responde indicando “sucesso”.
1. O fluxo de trabalho do `UpdateProvisionedProduct` define o estado do produto provisionado como `AVAILABLE`, mas **não** tenta aplicar nenhuma tag adicional aos novos recursos.
### Solução de erro de status
AWS Service Catalog garante que um grupo de recursos seja criado para todos os produtos provisionados definidos como from. `TAINTED` `ProvisionProduct` Se o mecanismo de provisionamento do Terraform não retornar um`ResourceIdentifier`, ou se não AWS Service Catalog conseguir criar um grupo de recursos, o produto provisionado será configurado para o `ERROR` estado, forçando você a encerrar.
# Gerenciar o arquivo do estado do produto Terraform Open Source
Cada produto provisionado do Terraform Open Source tem um **arquivo de estado único**. Há uma relação equivalente entre o produto provisionado e seu arquivo de estado. Os arquivos são armazenados em um bucket do Amazon S3 chamado `sc-terraform-engine-state-${AWS::AccountId}-${AWS::Region}`. O arquivo de estado é salvo sob `AccountID` ou a chave de objeto do `ProvisionedProductID`.
O acesso aos arquivos estaduais é limitado aos modelos de lançamento do Amazon EC2 `GetStateFile` AWS Lambda e aos modelos de lançamento. AWS Service Catalog os administradores **não** têm acesso direto aos arquivos de estado no Amazon S3. Os administradores devem acessar os arquivos usando o Amazon EC2. Por padrão, AWS Service Catalog os administradores podem ver a lista de arquivos de estado, mas não podem ler ou gravar o conteúdo do arquivo. Somente o mecanismo de provisionamento do Terraform pode ler ou escrever no conteúdo do arquivo.