SageMaker / Client / list_spaces

list_spaces#

SageMaker.Client.list_spaces(**kwargs)#

Lists spaces.

See also: AWS API Documentation

Request Syntax

response = client.list_spaces(
    NextToken='string',
    MaxResults=123,
    SortOrder='Ascending'|'Descending',
    SortBy='CreationTime'|'LastModifiedTime',
    DomainIdEquals='string',
    SpaceNameContains='string'
)
Parameters:
  • NextToken (string) – If the previous response was truncated, you will receive this token. Use it in your next request to receive the next set of results.

  • MaxResults (integer) – This parameter defines the maximum number of results that can be returned in a single response. The MaxResults parameter is an upper bound, not a target. If there are more results available than the value specified, a NextToken is provided in the response. The NextToken indicates that the user should get the next set of results by providing this token as a part of a subsequent call. The default value for MaxResults is 10.

  • SortOrder (string) – The sort order for the results. The default is Ascending.

  • SortBy (string) – The parameter by which to sort the results. The default is CreationTime.

  • DomainIdEquals (string) – A parameter to search for the domain ID.

  • SpaceNameContains (string) – A parameter by which to filter the results.

Return type:

dict

Returns:

Response Syntax

{
    'Spaces': [
        {
            'DomainId': 'string',
            'SpaceName': 'string',
            'Status': 'Deleting'|'Failed'|'InService'|'Pending'|'Updating'|'Update_Failed'|'Delete_Failed',
            'CreationTime': datetime(2015, 1, 1),
            'LastModifiedTime': datetime(2015, 1, 1),
            'SpaceSettingsSummary': {
                'AppType': 'JupyterServer'|'KernelGateway'|'DetailedProfiler'|'TensorBoard'|'CodeEditor'|'JupyterLab'|'RStudioServerPro'|'RSessionGateway'|'Canvas',
                'SpaceStorageSettings': {
                    'EbsStorageSettings': {
                        'EbsVolumeSizeInGb': 123
                    }
                }
            },
            'SpaceSharingSettingsSummary': {
                'SharingType': 'Private'|'Shared'
            },
            'OwnershipSettingsSummary': {
                'OwnerUserProfileName': 'string'
            },
            'SpaceDisplayName': 'string'
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) –

    • Spaces (list) –

      The list of spaces.

      • (dict) –

        The space’s details.

        • DomainId (string) –

          The ID of the associated domain.

        • SpaceName (string) –

          The name of the space.

        • Status (string) –

          The status.

        • CreationTime (datetime) –

          The creation time.

        • LastModifiedTime (datetime) –

          The last modified time.

        • SpaceSettingsSummary (dict) –

          Specifies summary information about the space settings.

          • AppType (string) –

            The type of app created within the space.

          • SpaceStorageSettings (dict) –

            The storage settings for a space.

            • EbsStorageSettings (dict) –

              A collection of EBS storage settings for a space.

              • EbsVolumeSizeInGb (integer) –

                The size of an EBS storage volume for a space.

        • SpaceSharingSettingsSummary (dict) –

          Specifies summary information about the space sharing settings.

          • SharingType (string) –

            Specifies the sharing type of the space.

        • OwnershipSettingsSummary (dict) –

          Specifies summary information about the ownership settings.

          • OwnerUserProfileName (string) –

            The user profile who is the owner of the space.

        • SpaceDisplayName (string) –

          The name of the space that appears in the Studio UI.

    • NextToken (string) –

      If the previous response was truncated, you will receive this token. Use it in your next request to receive the next set of results.