Amazon EC2 Systems Manager
用户指南
AWS 服务或AWS文档中描述的功能,可能因地区/位置而异。点 击 Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

如何共享 Systems Manager 文档

您可使用 Amazon EC2 控制台共享 Systems Manager 文档;或通过使用 AWS CLI、适用于 Windows PowerShell 的 AWS 工具或 AWS SDK,以编程方式调用 ModifyDocumentPermission API 操作来共享该文档。在共享文档之前,获取要与之共享文档的人的 AWS 账户 ID。您将在共享文档时指定这些账户 ID。

使用 Amazon EC2 控制台共享文档

  1. Open the Amazon EC2 console at https://console.amazonaws.cn/ec2/.

  2. 在导航窗格中,选择 Documents

  3. 在文档列表中,选择要共享的文档。选择 Permissions 选项卡并确保您是文档所有者。只有文档所有者才可共享文档。

  4. 选择 Edit

  5. 要公开共享命令,请选择 Public,然后选择 Save。要私下共享命令,请选择 Private,输入 AWS 账户 ID,选择 Add Permission,然后选择 Save

使用 AWS CLI 共享文档

以下步骤需要您为您的 CLI 会话指定区域。目前,Run Command 在以下 Systems Manager 区域提供。

  1. 在本地计算机上打开 AWS CLI 并执行以下命令来指定凭证。

    Copy
    aws config AWS Access Key ID: [your key] AWS Secret Access Key: [your key] Default region name: [us-east-1] Default output format [None]:
  2. 使用以下命令列出可供您使用的所有 Systems Manager 文档。此列表包括您已创建的文档和与您共享的文档。

    Copy
    aws ssm list-documents --document-filter-list key=Owner,value=all
  3. 使用以下命令获取特定文档。

    Copy
    aws ssm get-document --name document name
  4. 使用以下命令获取文档的描述。

    Copy
    aws ssm describe-document --name document name
  5. 使用以下命令查看文档的权限。

    Copy
    aws ssm describe-document-permission --name document name --permission-type Share
  6. 使用以下命令修改文档的权限并共享文档。您必须是文档的所有者才能编辑权限。此命令与特定个体基于其 AWS 账户 ID 私下共享文档。

    Copy
    aws ssm modify-document-permission --name document name --permission-type Share --account-ids-to-add AWS account ID

    使用以下命令公开共享文档。

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

使用适用于 Windows PowerShell 的 AWS 工具共享文档

以下步骤需要您为您的 PowerShell 会话指定区域。目前,Run Command 在以下 Systems Manager 区域提供。

  1. 在您的本地计算机上打开适用于 Windows PowerShell 的 AWS 工具并执行以下命令来指定凭证。

    Copy
    Set-AWSCredentials –AccessKey your key –SecretKey your key
  2. 使用以下命令为 PowerShell 会话设置区域。此示例使用 us-west-2 区域。

    Copy
    Set-DefaultAWSRegion -Region us-west-2
  3. 使用以下命令列出可供您使用的所有 Systems Manager 文档。此列表包括您已创建的文档和与您共享的文档。

    Copy
    Get-SSMDocumentList -DocumentFilterList (@{"key"="Owner";"value"="All"})
  4. 使用以下命令获取特定文档。

    Copy
    Get-SSMDocument –Name document name
  5. 使用以下命令获取文档的描述。

    Copy
    Get-SSMDocumentDescription –Name document name
  6. 使用以下命令查看文档的权限。

    Copy
    Get- SSMDocumentPermission –Name document name -PermissionType Share
  7. 使用以下命令修改文档的权限并共享文档。您必须是文档的所有者才能编辑权限。此命令与特定个体基于其 AWS 账户 ID 私下共享文档。

    Copy
    Edit-SSMDocumentPermission –Name document name -PermissionType Share -AccountIdsToAdd AWS account ID

    使用以下命令公开共享文档。

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