SSM ドキュメントの共有

SSM ドキュメントのパブリック共有をブロックするには

1. AWS Systems Manager コンソール (https://console.aws.amazon.com/systems-manager/) を開きます。

2. ナビゲーションペインで、[ドキュメント] を選択します。

3. [Preferences (設定)] を選択してから、パブリック共有のブロックセクションにある [編集] を選択します。

4. [パブリック共有のブロック] のチェックボックスを選択してから、[保存]を選択します。

AWS RAM を使用してドキュメントを共有するには

1. AWS RAM コンソール (https://console.aws.amazon.com/ram/) を開きます。

2. ナビゲーションペインで [リソース共有] を選択し、[リソース共有の作成] を選択します。

3. [名前] に、リソース共有の名前を入力します。

4. [リソース] で、リソースタイプ [SSM ドキュメント] を選択し、共有するドキュメントを選択します。

5. (オプション) [管理アクセス許可] で、AWS RAM が共有ドキュメントに適用する管理アクセス許可を確認します。

6. [次へ] を選択します。プリンシパル で、共有する組織、OU、または AWS アカウント を追加します。組織または OU と共有するには、AWS Organizations 内での共有を有効にする必要があります。

7. [次へ] を選択し、選択内容を確認してから、[リソース共有を作成] を選択します。

アクセス許可ビューからドキュメントを移行するには (コンソール)

1. AWS Systems Manager コンソールを開き、ナビゲーションペインで [ドキュメント] を選択します。

2. 移行するドキュメントを選択します。

3. [詳細] タブを選択します。

4. [アクセス許可] セクションで、[RAM へ移行] を選択します。Systems Manager は RAM へ移行ページを開きます。このページから移行を開始できます。

5. [移行するドキュメント] で、移行するドキュメントを選択します。個々のドキュメントを選択するか、[すべてのドキュメント] を選択して、アカウントのアクセス許可共有を使用するアカウント内のすべてのドキュメントを移行します。

6. [AutomationAssumeRole] で、Systems Manager Automation が移行の実行時に引き受ける IAM ロールを選択します。

7. (オプション) [組織単位] で、ドキュメントの共有先となる組織 ID または組織単位 (OU) ID を追加します。

8. [Start migration] を選択します。

1. AWS Systems Manager コンソール (https://console.aws.amazon.com/systems-manager/) を開きます。

2. ナビゲーションペインで、[ドキュメント] を選択します。

3. ドキュメントリストで共有するドキュメントを選択し、[詳細を表示] を選択します。[Permissions] タブで自分がドキュメントの所有者であることを確認します。ドキュメントの所有者のみがドキュメントを共有できます。

4. [Edit] を選択します。

5. コマンドをパブリックに共有するには、[Public] を選択し、[Save] を選択します。コマンドをプライベートに共有するには、[Private (プライベート)] を選択し、AWS アカウント ID を入力します。次に、[Add permission (アクセス権限の追加)] を選択し、[Save (保存)] を選択します。

1. ローカルコンピュータで AWS CLI または AWS Tools for Windows PowerShell を開き、以下のコマンドを実行して認証情報を指定します。

   次のコマンドで、[Region] (リージョン) をユーザー自身の情報に置き換えます。サポートされている region 値の一覧については、「Amazon Web Services 全般のリファレンス」の「Systems Manager サービスエンドポイント」にある Region 列を参照してください。

   Linux & macOS

   aws config
   
   AWS Access Key ID: [your key]
   AWS Secret Access Key: [your key]
   Default region name: region
   Default output format [None]:

   Windows

   aws config
   
   AWS Access Key ID: [your key]
   AWS Secret Access Key: [your key]
   Default region name: region
   Default output format [None]:

   PowerShell

   Set-AWSCredentials –AccessKey your key –SecretKey your key
   Set-DefaultAWSRegion -Region region

2. ドキュメントのアクセス権限を表示するには、次のコマンドを使用します。

   Linux & macOS

   aws ssm describe-document-permission \
       --name document name \
       --permission-type Share

   Windows

   aws ssm describe-document-permission ^
       --name document name ^
       --permission-type Share

   PowerShell

   Get-SSMDocumentPermission `
       –Name document name `
       -PermissionType Share

3. ドキュメントのアクセス権限を変更して共有するには、次のコマンドを使用します。アクセス権限を編集するには、ドキュメントの所有者である必要があります。オプションで、特定の AWS アカウント ID と共有するドキュメントの場合は、--shared-document-version パラメータを使用して共有するドキュメントのバージョンを指定できます。バージョンを指定しない場合、ドキュメント の Default バージョンが共有されます。ドキュメントをパブリックに (all と) 共有する場合は、指定したドキュメントのすべてのバージョンがデフォルトで共有されます。次のコマンド例は、特定の個人の AWS アカウント ID に基づいて、その個人とドキュメントをプライベートに共有します。

   Linux & macOS

   aws ssm modify-document-permission \
       --name document name \
       --permission-type Share \
       --account-ids-to-add AWS アカウント ID

   Windows

   aws ssm modify-document-permission ^
       --name document name ^
       --permission-type Share ^
       --account-ids-to-add AWS アカウント ID

   PowerShell

   Edit-SSMDocumentPermission `
       –Name document name `
       -PermissionType Share `
       -AccountIdsToAdd AWS アカウント ID

4. 次のコマンドを使用してドキュメントをパブリックに共有します。

   注記

   ドキュメントをパブリックに (all と) 共有する場合は、指定したドキュメントのすべてのバージョンがデフォルトで共有されます。

   Linux & macOS

   aws ssm modify-document-permission \
       --name document name \
       --permission-type Share \
       --account-ids-to-add 'all'

   Windows

   aws ssm modify-document-permission ^
       --name document name ^
       --permission-type Share ^
       --account-ids-to-add "all"

   PowerShell

   Edit-SSMDocumentPermission `
       -Name document name `
       -PermissionType Share `
       -AccountIdsToAdd ('all')

ドキュメント共有の停止

1. AWS Systems Manager コンソール (https://console.aws.amazon.com/systems-manager/) を開きます。

2. ナビゲーションペインで、[ドキュメント] を選択します。

3. ドキュメントリストで共有を停止するドキュメントを選択し、[詳細] を選択します。[アクセス許可] セクションで自分がドキュメントの所有者であることを確認します。ドキュメントの所有者のみが、ドキュメントの共有を停止できます。

4. [Edit] を選択します。

5. [X] を選択してコマンドへのアクセス権を取り消す AWS アカウント ID を削除し、[Save] を選択します。