# Using Roles to Connect Migration Hub to AWS SMS
<a name="using-service-linked-roles-sms-service-role"></a>

Migration Hub は [**AWSServiceRoleForMigrationHubSMSAccess**] という名前のサービスにリンクされたロールを使用します – AWS Server Migration Service (AWS SMS) がサポートされている AWS リージョンから 米国西部 (オレゴン) の Migration Hub に移行追跡情報を送信できるようにします。

## Migration Hub のサービスにリンクされたロールのアクセス許可
<a name="service-linked-role-permissions-sms-service-role"></a>

AWSServiceRoleForMigrationHubSMSAccess サービスにリンクされたロールは、ロールを引き受ける上で次のサービスを信頼します。
+ `sms.amazonaws.com`

ロールのアクセス許可ポリシーは次のとおりです。

```
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "mgh:CreateProgressUpdateStream",
            "Resource": "arn:aws:mgh:*:*:progressUpdateStream/SMS"
        },
        {
            "Effect": "Allow",
            "Action": [
                "mgh:DescribeMigrationTask",
                "mgh:AssociateDiscoveredResource",
                "mgh:ListDiscoveredResources",
                "mgh:ImportMigrationTask",
                "mgh:ListCreatedArtifacts",
                "mgh:DisassociateDiscoveredResource",
                "mgh:AssociateCreatedArtifact",
                "mgh:NotifyMigrationTaskState",
                "mgh:DisassociateCreatedArtifact",
                "mgh:PutResourceAttributes"
            ],
            "Resource": "arn:aws:mgh:*:*:progressUpdateStream/SMS/migrationTask/*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "mgh:ListMigrationTasks",
                "mgh:NotifyApplicationState",
                "mgh:DescribeApplicationState"
            ],
            "Resource": "*"
        }
    ]
}
```

IAM エンティティ（ユーザー、グループ、ロールなど）がサービスにリンクされたロールを作成、編集、削除できるようにするには、アクセス許可を設定する必要があります。詳細については、*IAM ユーザーガイド*の「[サービスにリンクされたロールのアクセス許可](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#service-linked-role-permissions)」を参照してください。

## Migration Hub のサービスにリンクされたロールの作成
<a name="create-service-linked-role-sms-service-role"></a>

サービスにリンクされたロールを手動で作成する必要はありません。サービスにリンクされたロールは、connect to AWS SMS in the Migration Hub console すると Migration Hub で自動的に作成されます。

**重要**  
 このサービスにリンクされたロールがアカウントに表示されるのは、このロールでサポートされている機能を使用する別のサービスでアクションが完了した場合です。詳細については、「[IAM アカウントに新しいロールが表示される](https://docs.aws.amazon.com/IAM/latest/UserGuide/troubleshoot_roles.html#troubleshoot_roles_new-role-appeared)」を参照してください。

### Migration Hub でのサービスにリンクされたロールの削除（コンソール）
<a name="create-service-linked-role-service-console-sms-service-role"></a>

Migration Hub コンソールを使用して、サービスにリンクされたロールを作成できます。

1. ウェブブラウザを開き、[console.aws.amazon.com/migrationhub](https://console.aws.amazon.com/migrationhub) の Migration Hub コンソールに移動します。

1. 左側のナビゲーションの [**Migrate (移行)**] で、[**Tools (ツール)******] を選択します。

1. [**Server Migration Service (サーバー移行サービス)**] ボックスで、[**Connect (接続)**] を選択します。

IAM コンソールを使用して、AWS CLI または AWS API でサービスにリンクされたロールを作成することもできます。詳細については、『*IAM ユーザーガイド*』の「[サービスにリンクされたロールの作成](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#create-service-linked-role)」を参照してください。

このサービスにリンクされた役割を削除し、再度作成する場合は、同じプロセスを使用します。サービスにリンクされたロールは、connect to AWS SMS in the Migration Hub console すると Migration Hub で再度自動的に作成されます。

## Migration Hub のサービスにリンクされたロールの編集
<a name="edit-service-linked-role-sms-service-role"></a>

Migration Hub では、AWSServiceRoleForMigrationHubSMSAccess サービスにリンクされたロールを編集することはできません。サービスにリンクされたロールを作成すると、多くのエンティティによってロールが参照される可能性があるため、ロール名を変更することはできません。ただし、IAM を使用したロールの説明の編集はできます。詳細については、*IAM ユーザーガイド* の「[サービスにリンクされたロールの編集](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#edit-service-linked-role)」を参照してください。

## Migration Hub のサービスにリンクされたロールの削除
<a name="delete-service-linked-role-sms-service-role"></a>

### サービスにリンクされたロールを手動で削除する
<a name="slr-manual-delete-sms-service-role"></a>

IAM コンソール、AWS CLI、AWS API を使用して、AWSServiceRoleForMigrationHubSMSAccess サービスにリンクされたロールを削除します。詳細については、*IAM ユーザーガイド*の「[サービスにリンクされたロールの削除](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#delete-service-linked-role)」を参照してください。

## Migration Hub サービスにリンクされたロールがサポートされるリージョン
<a name="slr-regions-sms-service-role"></a>

Migration Hub は、サービスを利用できる 米国西部 (オレゴン) AWS リージョンで、サービスにリンクされたロールの使用をサポートします。