Amazon Simple Systems Manager (SSM)

2021/01/12 - Amazon Simple Systems Manager (SSM) - 1 updated api methods

Changes  AWS Systems Manager adds pagination support for DescribeDocumentPermission API

DescribeDocumentPermission (updated) Link ΒΆ
Changes (request, response)
Request
{'MaxResults': 'integer', 'NextToken': 'string'}
Response
{'NextToken': 'string'}

Describes the permissions for a Systems Manager document. If you created the document, you are the owner. If a document is shared, it can either be shared privately (by specifying a user's AWS account ID) or publicly (All ).

See also: AWS API Documentation

Request Syntax

client.describe_document_permission(
    Name='string',
    PermissionType='Share',
    MaxResults=123,
    NextToken='string'
)
type Name

string

param Name

[REQUIRED]

The name of the document for which you are the owner.

type PermissionType

string

param PermissionType

[REQUIRED]

The permission type for the document. The permission type can be Share .

type MaxResults

integer

param MaxResults

The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results.

type NextToken

string

param NextToken

The token for the next set of items to return. (You received this token from a previous call.)

rtype

dict

returns

Response Syntax

{
    'AccountIds': [
        'string',
    ],
    'AccountSharingInfoList': [
        {
            'AccountId': 'string',
            'SharedDocumentVersion': 'string'
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • AccountIds (list) --

      The account IDs that have permission to use this document. The ID can be either an AWS account or All .

      • (string) --

    • AccountSharingInfoList (list) --

      A list of AWS accounts where the current document is shared and the version shared with each account.

      • (dict) --

        Information includes the AWS account ID where the current document is shared and the version shared with that account.

        • AccountId (string) --

          The AWS account ID where the current document is shared.

        • SharedDocumentVersion (string) --

          The version of the current document shared with the account.

    • NextToken (string) --

      The token for the next set of items to return. Use this token to get the next set of results.