

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

# Usando funções vinculadas a serviços para AWS Service Catalog
<a name="using-service-linked-roles"></a>

AWS Service Catalog usa funções [vinculadas ao serviço AWS Identity and Access Management](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-linked-role) (IAM). Uma função vinculada ao serviço é um tipo exclusivo de função do IAM vinculada diretamente a. AWS Service Catalog Service-linked as funções são predefinidas AWS Service Catalog e incluem todas as permissões que o serviço exige para chamar outros AWS serviços em seu nome. 

Uma função vinculada ao serviço facilita a configuração AWS Service Catalog porque você não precisa adicionar manualmente as permissões necessárias. AWS Service Catalog define as permissões de suas funções vinculadas ao serviço e, a menos que seja definido de outra forma, só AWS Service Catalog pode assumir suas funções. As permissões definidas incluem a política de confiança e a política de permissões, que não pode ser anexada a nenhuma outra entidade do IAM.

Um perfil vinculado ao serviço poderá ser excluído somente após excluir seus atributos relacionados. Isso protege seus AWS Service Catalog recursos porque você não pode remover inadvertidamente a permissão para acessar os recursos.

Para obter informações sobre outros serviços que oferecem suporte a funções vinculadas a [AWS serviços, consulte Serviços que funcionam com IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) e procure os serviços que têm **Sim na coluna** de **Service-linked funções**. Escolha um **Sim** com um link para visualizar a documentação do perfil vinculado para esse serviço.

## Service-linked permissões de função para `AWSServiceRoleForServiceCatalogSync`
<a name="slr-permissions"></a>

AWS Service Catalog pode usar a função vinculada ao serviço chamada **`AWSServiceRoleForServiceCatalogSync`**— Essa função vinculada ao serviço é necessária AWS Service Catalog para usar CodeConnections e criar, atualizar e descrever artefatos de AWS Service Catalog provisionamento de um produto.

O perfil vinculado ao serviço `AWSServiceRoleForServiceCatalogSync` confia nos seguintes serviços para aceitar o perfil:
+ `sync.servicecatalog.amazonaws.com`

A política de permissões de função nomeada **AWSServiceCatalogSyncServiceRolePolicy** AWS Service Catalog permite concluir as seguintes ações nos recursos especificados:
+ Ação: `Connection` em `CodeConnections`
+ Ação: `Create, Update, and Describe` ativada `ProvisioningArtifact` para um AWS Service Catalog produto

É necessário configurar as permissões para permitir que uma entidade do IAM (como um usuário, grupo ou perfil) crie, edite ou exclua uma função vinculada ao serviço. Para obter mais informações, consulte [as permissões de Service-linked função](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#service-linked-role-permissions) no *Guia do usuário do IAM*.

### Criando uma função vinculada ao serviço `AWSServiceRoleForServiceCatalogSync`
<a name="create-slr1"></a>

Você não precisa criar manualmente a função `AWSServiceRoleForServiceCatalogSync` vinculada ao serviço. AWS Service Catalog cria a função vinculada ao serviço para você automaticamente quando você estabelece CodeConnections na Console de gerenciamento da AWS AWS CLI, na ou na AWS API. 

**Importante**  
Esse perfil vinculado ao serviço pode aparecer em sua conta se você concluiu uma ação em outro serviço que usa os atributos compatíveis com esse perfil. Além disso, se você estava usando o AWS Service Catalog serviço antes de 18 de novembro de 2022, quando ele começou a oferecer suporte a funções vinculadas ao serviço, AWS Service Catalog criou a `AWSServiceRoleForServiceCatalogSync` função em sua conta. Para saber mais, consulte [Uma nova função apareceu na minha conta do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/troubleshoot_roles.html#troubleshoot_roles_new-role-appeared).

Se excluir essa função vinculada ao serviço e precisar criá-la novamente, você pode usar esse mesmo processo para recriar a função na sua conta. Quando você estabelece CodeConnections, AWS Service Catalog cria a função vinculada ao serviço para você novamente. 

Você também pode usar o console do IAM para criar uma função vinculada ao serviço com o caso de uso de ** AWS Service Catalog produtos sincronizados**. Na AWS CLI ou na AWS API, crie uma função vinculada ao serviço com o nome do `sync.servicecatalog.amazonaws.com` serviço. Para saber mais, consulte [Criar um perfil vinculado a serviço](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#create-service-linked-role) no *Guia do usuário do IAM*. Se você excluir essa função vinculada ao serviço, será possível usar esse mesmo processo para criar a função novamente.

## Service-linked permissões de função para `AWSServiceRoleForServiceCatalogOrgsDataSync`
<a name="slr-permissions2"></a>

AWS Service Catalog pode usar a função vinculada ao serviço chamada **`AWSServiceRoleForServiceCatalogOrgsDataSync`**— Essa função vinculada ao serviço é necessária para que AWS Service Catalog as organizações permaneçam sincronizadas. AWS Organizations

O perfil vinculado ao serviço `AWSServiceRoleForServiceCatalogOrgsDataSync` confia nos seguintes serviços para aceitar o perfil:
+ `orgsdatasync.servicecatalog.amazonaws.com`

O perfil `AWSServiceRoleForServiceCatalogOrgsDataSync` vinculado ao serviço exige que você use a seguinte política de confiança, além da [política `AWSServiceCatalogOrgsDataSyncServiceRolePolicy` gerenciada](security-iam-awsmanpol.md#security-iam-awsmanpol-AWSServiceCatalogOrgsDataSyncServiceRolePolicy):

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

****  

```
{ 
  "Version":"2012-10-17",		 	 	  
  "Statement": [ 
    { 
      "Effect": "Allow", 
      "Principal": { 
        "Service": "orgsdatasync.servicecatalog.amazonaws.com" 
      }, 
      "Action": "sts:AssumeRole" 
    } 
  ] 
}
```

------

A política de permissões de função nomeada **AWSServiceCatalogOrgsDataSyncServiceRolePolicy** AWS Service Catalog permite concluir as seguintes ações nos recursos especificados:
+ Ação: `DescribeAccount`, `DescribeOrganization`, e `ListAWSServiceAccessForOrganization` em `Organizations accounts`
+ Ação: `ListAccounts`, `ListChildren`, e `ListParent` em `Organizations accounts`

É necessário configurar as permissões para permitir que uma entidade do IAM (como um usuário, grupo ou perfil) crie, edite ou exclua uma função vinculada ao serviço. Para obter mais informações, consulte [as permissões de Service-linked função](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#service-linked-role-permissions) no *Guia do usuário do IAM*.

### Criando uma função vinculada ao serviço `AWSServiceRoleForServiceCatalogOrgsDataSync`
<a name="create-slr2"></a>

Você não precisa criar manualmente a função `AWSServiceRoleForServiceCatalogOrgsDataSync` vinculada ao serviço. AWS Service Catalog considera sua ação de habilitar [Compartilhando com AWS Organizations](catalogs_portfolios_sharing_how-to-share.md#portfolio-sharing-organizations) ou [Compartilhar um portfólio](catalogs_portfolios_sharing_how-to-share.md) como permissão AWS Service Catalog para criar uma SLR em segundo plano em seu nome. 

AWS Service Catalog cria a função vinculada ao serviço para você automaticamente quando você solicita `EnableAWSOrganizationsAccess` ou `CreatePortfolioShare` na Console de gerenciamento da AWS AWS CLI, na ou na AWS API. 

**Importante**  
Esse perfil vinculado ao serviço pode aparecer em sua conta se você concluiu uma ação em outro serviço que usa os atributos compatíveis com esse perfil. Para saber mais, consulte [Uma nova função apareceu na minha conta do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/troubleshoot_roles.html#troubleshoot_roles_new-role-appeared).

Se excluir essa função vinculada ao serviço e precisar criá-la novamente, você pode usar esse mesmo processo para recriar a função na sua conta. Quando você solicita `EnableAWSOrganizationsAccess` o `CreatePortfolioShare`, AWS Service Catalog cria um perfil vinculado ao serviço para você novamente. 

## Editar uma função vinculada ao serviço para AWS Service Catalog
<a name="edit-slr"></a>

AWS Service Catalog não permite que você edite as funções `AWSServiceRoleForServiceCatalogSync` ou funções `AWSServiceRoleForServiceCatalogOrgsDataSync` vinculadas ao serviço. Depois que criar um perfil vinculado ao serviço, você não poderá alterar o nome do perfil, pois várias entidades podem fazer referência a ele. No entanto, será possível editar a descrição do perfil usando o IAM. Para saber mais, consulte [Editar um perfil vinculado ao serviço](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#edit-service-linked-role) no *Guia do usuário do IAM*.

## Excluir uma função vinculada ao serviço para o AWS Service Catalog
<a name="delete-slr"></a>

Você pode usar o console do IAM, a AWS CLI ou a AWS API para excluir manualmente a `AWSServiceRoleForServiceCatalogSync` ou `AWSServiceRoleForServiceCatalogOrgsDataSync` a SLR. Para fazer isso, primeiro você deve remover manualmente todos os recursos que estão usando a função vinculada ao serviço (por exemplo, qualquer AWS Service Catalog produto sincronizado com um repositório externo) e, em seguida, a função vinculada ao serviço pode ser excluída manualmente. 

## Regiões suportadas para AWS Service Catalog funções vinculadas ao serviço
<a name="slr-regions"></a>

AWS Service Catalog suporta o uso de funções vinculadas ao serviço em todas as regiões em que o serviço está disponível. Para obter mais informações, consulte [Regiões e endpoints da AWS](https://docs.aws.amazon.com/general/latest/gr/rande.html).


****  

| Nome da região | Identidade da região | Support em AWS Service Catalog | 
| --- | --- | --- | 
| Leste dos EUA (Norte da Virgínia) | us-east-1 | Sim | 
| Leste dos EUA (Ohio) | us-east-2 | Sim | 
| Oeste dos EUA (N. da Califórnia) | us-west-1 | Sim | 
| Oeste dos EUA (Oregon) | us-west-2 | Sim | 
| África (Cidade do Cabo) | af-south-1 | Sim | 
| Ásia-Pacífico (Hong Kong) | ap-east-1 | Sim | 
| Ásia-Pacífico (Jacarta) | ap-southeast-3 | Sim | 
| Ásia-Pacífico (Mumbai) | ap-south-1 | Sim | 
| Ásia Pacifico (Osaka) | ap-northeast-3 | Sim | 
| Ásia-Pacífico (Seul) | ap-northeast-2 | Sim | 
| Ásia-Pacífico (Singapura) | ap-southeast-1 | Sim | 
| Ásia-Pacífico (Sydney) | ap-southeast-2 | Sim | 
| Ásia-Pacífico (Tóquio) | ap-northeast-1 | Sim | 
| Canadá (Central) | ca-central-1 | Sim | 
| Europa (Frankfurt) | eu-central-1 | Sim | 
| Europa (Irlanda) | eu-west-1 | Sim | 
| Europa (Londres) | eu-west-2 | Sim | 
| Europa (Milão) | eu-south-1 | Sim | 
| Europa (Paris) | eu-west-3 | Sim | 
| Europa (Estocolmo) | eu-north-1 | Sim | 
| Oriente Médio (Bahrein) | me-south-1 | Sim | 
| América do Sul (São Paulo) | sa-east-1 | Sim | 
| AWS GovCloud (US-East) | us-gov-east-1 | Não | 
| AWS GovCloud (US-West) | us-gov-west-1 | Não | 