メニュー
Amazon EC2 Systems Manager
ユーザーガイド

共有された Systems Manager ドキュメントを使用する方法

Systems Manager ドキュメントを共有すると、システムは Amazon リソースネーム (ARN) を生成して、コマンドに割り当てます。Amazon EC2 コンソールから共有ドキュメントを選択して実行する場合、ARN は表示されません。ただし、共有された Systems Manager ドキュメントをコマンドラインアプリケーションから実行する場合は、完全な ARN を指定する必要があります。コマンドを実行してドキュメントをリストすると、Systems Manager ドキュメントの完全な ARN が表示されます。

注記

自分が所有している AWS パブリックドキュメント (AWS-* で始まるドキュメント) またはコマンドには ARN を指定する必要はありません。

このセクションには、AWS CLI および Windows PowerShell 用 AWS ツールから、共有された Systems Manager ドキュメントを表示および実行する方法の例が含まれています。

AWS CLI からの共有 Systems Manager ドキュメントの使用

すべてのパブリック Systems Manager ドキュメントをリスト表示するには

Copy
aws ssm list-documents --document-filter-list key=Owner,value=Public

自分と共有されているプライベート Systems Manager ドキュメントをリスト表示するには

Copy
aws ssm list-documents --document-filter-list key=Owner,value=Private

使用できるすべての Systems Manager ドキュメントをリスト表示するには

Copy
aws ssm list-documents --document-filter-list key=Owner,value=All

完全な ARN を使用して、共有 Systems Manager ドキュメントからコマンドを実行します

Copy
aws ssm send-command --document-name FullARN/name

(例:

Copy
aws ssm send-command --document-name arn:aws:ssm:us-east-1:12345678912:document/highAvailabilityServerSetup --instance-ids i-12121212

Windows PowerShell 用 AWS ツールから共有 Systems Manager ドキュメントを使用する

すべてのパブリック Systems Manager ドキュメントをリスト表示するには

Copy
Get-SSMDocumentList -DocumentFilterList @(New-Object Amazon.SimpleSystemsManagement.Model.DocumentFilter("Owner", "Public"))

自分と共有されているプライベート Systems Manager ドキュメントをリスト表示するには

Copy
Get-SSMDocumentList -DocumentFilterList @(New-Object Amazon.SimpleSystemsManagement.Model.DocumentFilter("Owner", "Shared"))

自分と共有されている Systems Manager ドキュメントについての情報を入手するには

Copy
Get-SSMDocument –Name FullARN/name

(例:

Copy
Get-SSMDocument –Name arn:aws:ssm:us-east-1:12345678912:document/highAvailabilityServerSetup

自分と共有されている Systems Manager ドキュメントの説明を取得するには

Copy
Get-SSMDocumentDescription –Name FullARN/name

(例:

Copy
Get-SSMDocumentDescription –Name arn:aws:ssm:us-east-1:12345678912:document/highAvailabilityServerSetup

完全な ARN を使用して、共有 Systems Manager ドキュメントからコマンドを実行するには

Copy
Send-SSMCommand –DocumentName FullARN/name –InstanceId IDs

(例:

Copy
Send-SSMCommand –DocumentName arn:aws:ssm:us-east-1:555450671542:document/highAvailabilityServerSetup –InstanceId @{"i-273d4e9e"}