共用 SSM 文件

若要封鎖 SSM 文件的公有共用

1. 在 https：//https://console.aws.amazon.com/systems-manager/ 開啟 AWS Systems Manager 主控台。

2. 在導覽窗格中，選擇 Documents (文件)。

3. 選擇 Preferences (偏好設定)，然後在 Block public sharing (封鎖公有共用) 區段中選擇 Edit (編輯)。

4. 選取 Block public sharing (封鎖公有共用) 核取方塊，再選擇 Save (儲存)。

使用 RAM AWS 共用文件

1. 在 https：//https://console.aws.amazon.com/ram/ 開啟 AWS RAM 主控台。

2. 在導覽窗格中，選擇資源共用，然後選擇建立資源共用。

3. 在名稱中，輸入資源共用的名稱。

4. 在資源下，選擇資源類型 SSM 文件，然後選擇您要共用的文件。

5. （選用） 在受管許可下，檢閱 RAM AWS 套用至共用文件的受管許可。

6. 選擇下一步。在主體下，新增您要共用的組織、OUs 或 AWS 帳戶 。若要與組織或 OU 共用，您必須在 Organizations 中 AWS 啟用共用。

7. 選擇下一步，檢閱您的選擇，然後選擇建立資源共享。

從其許可檢視遷移文件 （主控台）

1. 開啟 AWS Systems Manager 主控台，然後在導覽窗格中選擇文件。

2. 選擇您要遷移的文件。

3. 選擇詳細資訊索引標籤。

4. 在許可區段中，選擇遷移至 RAM。Systems Manager 會開啟遷移至 RAM 頁面，這可協助您開始遷移。

5. 針對要遷移的文件，選取要遷移的文件。選取個別文件，或選擇所有文件，以遷移帳戶中使用帳戶許可共用的每個文件。

6. 針對 AutomationAssumeRole，選擇 Systems Manager Automation 執行遷移所擔任的 IAM 角色。

7. （選用） 對於組織單位，新增要與其共用文件的組織 ID 或組織單位 (OU) ID。

8. 選擇開始遷移。

1. 在 https：//https://console.aws.amazon.com/systems-manager/ 開啟 AWS Systems Manager 主控台。

2. 在導覽窗格中，選擇 Documents (文件)。

3. 在文件清單中，選擇要共享的文件，然後選擇 View details (查看詳細資訊)。在 Permissions (許可) 索引標籤中，驗證您是文件的擁有者。只有文件擁有者可以分享文件。

4. 選擇編輯。

5. 若要公開共享命令，選擇 Public (公有)，然後選擇 Save (儲存)。若要私下共用命令，選擇 Private (私有)，輸入 AWS 帳戶 ID，選擇 Add permission (新增許可)，然後選擇 Save (儲存)。

1. 在本機 AWS Tools for Windows PowerShell 電腦上開啟 AWS CLI 或 ，並執行下列命令來指定您的登入資料。

   在下列命令中，用您自己的資訊取代區域。如需支援的 region 值的清單，請參閱《Amazon Web Services 一般參考》中 Systems Manager 服務端點一節的區域資料欄。

   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. 在 https：//https://console.aws.amazon.com/systems-manager/ 開啟 AWS Systems Manager 主控台。

2. 在導覽窗格中，選擇 Documents (文件)。

3. 在文件清單中，選擇要停止共用的文件，然後選擇詳細資訊。在許可區段中，確認您是文件擁有者。只有文件擁有者可以停止共享文件。

4. 選擇編輯。

5. 選擇 X 以刪除不應再存取命令的 AWS 帳戶 ID，然後選擇儲存。