共享 SSM 文档 - Amazon Web Services Systems Manager
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

共享 SSM 文档

您可以共享Amazon Web Services Systems Manager(SSM) 文档通过使用 Systems Manager 控制台。您还可以通过调用ModifyDocumentPermissionAPI 操作,使用Amazon命令行界面 (AmazonCLI)Amazon适用于 Windows PowerShell 的工具,或Amazon开发工具包。在共享文档之前,请获取Amazon Web Services 账户要与之共享的人的 ID。您将在共享文档时指定这些账户 ID。

共享文档(控制台)

共享文档

  1. 打开Amazon Web Services Systems Manager控制台https://console.aws.amazon.com/systems-manager/

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

    -或者-

    如果Amazon Web Services Systems Manager首先打开主页,选择菜单图标( ) 打开导航窗格中的,然后选择选择文档在导航窗格中,选择。

  3. 在文档列表中,选择要共享的文档,然后选择查看详细信息。在权限选项卡中,确保您是文档所有者。只有文档所有者才可共享文档。

  4. 选择 Edit

  5. 要公开共享命令,请选择 Public,然后选择 Save。要私下共享命令,请选择私密中,输入Amazon Web Services 账户ID,选择添加权限,然后选择Save

共享文档(命令行)

以下步骤需要您指定Amazon Web Services 区域为您的命令行会话。

  1. 打开AmazonCLI 或Amazon本地计算机上的 Windows PowerShell Chell 工具,然后运行以下命令来指定凭证。

    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

    区域表示Amazon Web Services 区域支持Amazon Web Services Systems Manager之外的压缩算法(例如us-east-2查看美国东部(俄亥俄)区域。有关受支持的区域值,请参阅区域中的列Systems Manager 服务终端节点中的Amazon Web Services 一般参考

  2. 使用以下命令列出可供您使用的所有 SSM 文档。此列表包括您已创建的文档和与您共享的文档。

    Linux & macOS
    aws ssm list-documents
    Windows
    aws ssm list-documents
    PowerShell
    Get-SSMDocumentList
  3. 使用以下命令获取特定文档。

    Linux & macOS
    aws ssm get-document \ --name document name
    Windows
    aws ssm get-document ^ --name document name
    PowerShell
    Get-SSMDocument ` –Name document name
  4. 使用以下命令获取文档的描述。

    Linux & macOS
    aws ssm describe-document \ --name document name
    Windows
    aws ssm describe-document ^ --name document name
    PowerShell
    Get-SSMDocumentDescription ` –Name document name
  5. 使用以下命令查看文档的权限。

    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
  6. 使用以下命令修改文档的权限并共享文档。您必须是文档的所有者才能编辑权限。此命令与特定个体基于其Amazon Web Services 账户ID。

    Linux & macOS
    aws ssm modify-document-permission \ --name document name \ --permission-type Share \ --account-ids-to-add Amazon Web Services 账户 ID
    Windows
    aws ssm modify-document-permission ^ --name document name ^ --permission-type Share ^ --account-ids-to-add Amazon Web Services 账户 ID
    PowerShell
    Edit-SSMDocumentPermission ` –Name document name ` -PermissionType Share ` -AccountIdsToAdd Amazon Web Services 账户 ID
  7. 使用以下命令公开共享文档。

    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')