Skip to content

DescribeNotebookInstanceOutput

Source code in docs_src/capo_sagemaker/types/describe_notebook_instance_output.py
class DescribeNotebookInstanceOutput(TypedDict, closed=True):
    notebook_instance_arn: NotRequired[
        "capo_sagemaker.types.notebook_instance_arn.NotebookInstanceArn"
    ]
    """<p>The Amazon Resource Name (ARN) of the notebook instance.</p>"""
    notebook_instance_name: NotRequired[
        "capo_sagemaker.types.notebook_instance_name.NotebookInstanceName"
    ]
    """<p>The name of the SageMaker AI notebook instance. </p>"""
    notebook_instance_status: NotRequired[
        "capo_sagemaker.types.notebook_instance_status.NotebookInstanceStatus"
    ]
    """<p>The status of the notebook instance.</p>"""
    failure_reason: NotRequired["capo_sagemaker.types.failure_reason.FailureReason"]
    """<p>If status is <code>Failed</code>, the reason it failed.</p>"""
    url: NotRequired["capo_sagemaker.types.notebook_instance_url.NotebookInstanceUrl"]
    """<p>The URL that you use to connect to the Jupyter notebook that is running in your notebook instance. </p>"""
    instance_type: NotRequired["capo_sagemaker.types.instance_type.InstanceType"]
    """<p>The type of ML compute instance running on the notebook instance.</p>"""
    ip_address_type: NotRequired["capo_sagemaker.types.ip_address_type.IPAddressType"]
    """<p>The IP address type configured for the notebook instance. Returns <code>ipv4</code> for IPv4-only connectivity or <code>dualstack</code> for both IPv4 and IPv6 connectivity.</p>"""
    subnet_id: NotRequired["capo_sagemaker.types.subnet_id.SubnetId"]
    """<p>The ID of the VPC subnet.</p>"""
    security_groups: NotRequired[
        "capo_sagemaker.types.security_group_ids.SecurityGroupIds"
    ]
    """<p>The IDs of the VPC security groups.</p>"""
    role_arn: NotRequired["capo_sagemaker.types.role_arn.RoleArn"]
    """<p>The Amazon Resource Name (ARN) of the IAM role associated with the instance. </p>"""
    kms_key_id: NotRequired["capo_sagemaker.types.kms_key_id.KmsKeyId"]
    """<p>The Amazon Web Services KMS key ID SageMaker AI uses to encrypt data when storing it on the ML storage volume attached to the instance. </p>"""
    network_interface_id: NotRequired[
        "capo_sagemaker.types.network_interface_id.NetworkInterfaceId"
    ]
    """<p>The network interface IDs that SageMaker AI created at the time of creating the instance. </p>"""
    last_modified_time: NotRequired[
        "capo_sagemaker.types.last_modified_time.LastModifiedTime"
    ]
    """<p>A timestamp. Use this parameter to retrieve the time when the notebook instance was last modified. </p>"""
    creation_time: NotRequired["capo_sagemaker.types.creation_time.CreationTime"]
    """<p>A timestamp. Use this parameter to return the time when the notebook instance was created</p>"""
    notebook_instance_lifecycle_config_name: NotRequired[
        "capo_sagemaker.types.notebook_instance_lifecycle_config_name.NotebookInstanceLifecycleConfigName"
    ]
    """<p>Returns the name of a notebook instance lifecycle configuration.</p> <p>For information about notebook instance lifestyle configurations, see <a href="https://docs.aws.amazon.com/sagemaker/latest/dg/notebook-lifecycle-config.html">Step 2.1: (Optional) Customize a Notebook Instance</a> </p>"""
    direct_internet_access: NotRequired[
        "capo_sagemaker.types.direct_internet_access.DirectInternetAccess"
    ]
    """<p>Describes whether SageMaker AI provides internet access to the notebook instance. If this value is set to <i>Disabled</i>, the notebook instance does not have internet access, and cannot connect to SageMaker AI training and endpoint services.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/sagemaker/latest/dg/appendix-additional-considerations.html#appendix-notebook-and-internet-access">Notebook Instances Are Internet-Enabled by Default</a>.</p>"""
    volume_size_in_gb: NotRequired[
        "capo_sagemaker.types.notebook_instance_volume_size_in_gb.NotebookInstanceVolumeSizeInGB"
    ]
    """<p>The size, in GB, of the ML storage volume attached to the notebook instance.</p>"""
    accelerator_types: NotRequired[
        "capo_sagemaker.types.notebook_instance_accelerator_types.NotebookInstanceAcceleratorTypes"
    ]
    """<p>This parameter is no longer supported. Elastic Inference (EI) is no longer available.</p> <p>This parameter was used to specify a list of the EI instance types associated with this notebook instance.</p>"""
    default_code_repository: NotRequired[
        "capo_sagemaker.types.code_repository_name_or_url.CodeRepositoryNameOrUrl"
    ]
    """<p>The Git repository associated with the notebook instance as its default code repository. This can be either the name of a Git repository stored as a resource in your account, or the URL of a Git repository in <a href="https://docs.aws.amazon.com/codecommit/latest/userguide/welcome.html">Amazon Web Services CodeCommit</a> or in any other Git repository. When you open a notebook instance, it opens in the directory that contains this repository. For more information, see <a href="https://docs.aws.amazon.com/sagemaker/latest/dg/nbi-git-repo.html">Associating Git Repositories with SageMaker AI Notebook Instances</a>.</p>"""
    additional_code_repositories: NotRequired[
        "capo_sagemaker.types.additional_code_repository_names_or_urls.AdditionalCodeRepositoryNamesOrUrls"
    ]
    """<p>An array of up to three Git repositories associated with the notebook instance. These can be either the names of Git repositories stored as resources in your account, or the URL of Git repositories in <a href="https://docs.aws.amazon.com/codecommit/latest/userguide/welcome.html">Amazon Web Services CodeCommit</a> or in any other Git repository. These repositories are cloned at the same level as the default repository of your notebook instance. For more information, see <a href="https://docs.aws.amazon.com/sagemaker/latest/dg/nbi-git-repo.html">Associating Git Repositories with SageMaker AI Notebook Instances</a>.</p>"""
    root_access: NotRequired["capo_sagemaker.types.root_access.RootAccess"]
    """<p>Whether root access is enabled or disabled for users of the notebook instance.</p> <note> <p>Lifecycle configurations need root access to be able to set up a notebook instance. Because of this, lifecycle configurations associated with a notebook instance always run with root access even if you disable root access for users.</p> </note>"""
    platform_identifier: NotRequired[
        "capo_sagemaker.types.platform_identifier.PlatformIdentifier"
    ]
    """<p>The platform identifier of the notebook instance runtime environment.</p>"""
    instance_metadata_service_configuration: NotRequired[
        "capo_sagemaker.types.instance_metadata_service_configuration.InstanceMetadataServiceConfiguration"
    ]
    """<p>Information on the IMDS configuration of the notebook instance</p>"""

accelerator_types instance-attribute

accelerator_types: NotRequired[NotebookInstanceAcceleratorTypes]

This parameter is no longer supported. Elastic Inference (EI) is no longer available.

This parameter was used to specify a list of the EI instance types associated with this notebook instance.

additional_code_repositories instance-attribute

additional_code_repositories: NotRequired[AdditionalCodeRepositoryNamesOrUrls]

An array of up to three Git repositories associated with the notebook instance. These can be either the names of Git repositories stored as resources in your account, or the URL of Git repositories in Amazon Web Services CodeCommit or in any other Git repository. These repositories are cloned at the same level as the default repository of your notebook instance. For more information, see Associating Git Repositories with SageMaker AI Notebook Instances.

creation_time instance-attribute

creation_time: NotRequired[CreationTime]

A timestamp. Use this parameter to return the time when the notebook instance was created

default_code_repository instance-attribute

default_code_repository: NotRequired[CodeRepositoryNameOrUrl]

The Git repository associated with the notebook instance as its default code repository. This can be either the name of a Git repository stored as a resource in your account, or the URL of a Git repository in Amazon Web Services CodeCommit or in any other Git repository. When you open a notebook instance, it opens in the directory that contains this repository. For more information, see Associating Git Repositories with SageMaker AI Notebook Instances.

direct_internet_access instance-attribute

direct_internet_access: NotRequired[DirectInternetAccess]

Describes whether SageMaker AI provides internet access to the notebook instance. If this value is set to Disabled, the notebook instance does not have internet access, and cannot connect to SageMaker AI training and endpoint services.

For more information, see Notebook Instances Are Internet-Enabled by Default.

failure_reason instance-attribute

failure_reason: NotRequired[FailureReason]

If status is Failed, the reason it failed.

instance_metadata_service_configuration instance-attribute

instance_metadata_service_configuration: NotRequired[
    InstanceMetadataServiceConfiguration
]

Information on the IMDS configuration of the notebook instance

instance_type instance-attribute

instance_type: NotRequired[InstanceType]

The type of ML compute instance running on the notebook instance.

ip_address_type instance-attribute

ip_address_type: NotRequired[IPAddressType]

The IP address type configured for the notebook instance. Returns ipv4 for IPv4-only connectivity or dualstack for both IPv4 and IPv6 connectivity.

kms_key_id instance-attribute

kms_key_id: NotRequired[KmsKeyId]

The Amazon Web Services KMS key ID SageMaker AI uses to encrypt data when storing it on the ML storage volume attached to the instance.

last_modified_time instance-attribute

last_modified_time: NotRequired[LastModifiedTime]

A timestamp. Use this parameter to retrieve the time when the notebook instance was last modified.

network_interface_id instance-attribute

network_interface_id: NotRequired[NetworkInterfaceId]

The network interface IDs that SageMaker AI created at the time of creating the instance.

notebook_instance_arn instance-attribute

notebook_instance_arn: NotRequired[NotebookInstanceArn]

The Amazon Resource Name (ARN) of the notebook instance.

notebook_instance_lifecycle_config_name instance-attribute

notebook_instance_lifecycle_config_name: NotRequired[
    NotebookInstanceLifecycleConfigName
]

Returns the name of a notebook instance lifecycle configuration.

For information about notebook instance lifestyle configurations, see Step 2.1: (Optional) Customize a Notebook Instance

notebook_instance_name instance-attribute

notebook_instance_name: NotRequired[NotebookInstanceName]

The name of the SageMaker AI notebook instance.

notebook_instance_status instance-attribute

notebook_instance_status: NotRequired[NotebookInstanceStatus]

The status of the notebook instance.

platform_identifier instance-attribute

platform_identifier: NotRequired[PlatformIdentifier]

The platform identifier of the notebook instance runtime environment.

role_arn instance-attribute

role_arn: NotRequired[RoleArn]

The Amazon Resource Name (ARN) of the IAM role associated with the instance.

root_access instance-attribute

root_access: NotRequired[RootAccess]

Whether root access is enabled or disabled for users of the notebook instance.

Lifecycle configurations need root access to be able to set up a notebook instance. Because of this, lifecycle configurations associated with a notebook instance always run with root access even if you disable root access for users.

security_groups instance-attribute

security_groups: NotRequired[SecurityGroupIds]

The IDs of the VPC security groups.

subnet_id instance-attribute

subnet_id: NotRequired[SubnetId]

The ID of the VPC subnet.

url instance-attribute

url: NotRequired[NotebookInstanceUrl]

The URL that you use to connect to the Jupyter notebook that is running in your notebook instance.

volume_size_in_gb instance-attribute

volume_size_in_gb: NotRequired[NotebookInstanceVolumeSizeInGB]

The size, in GB, of the ML storage volume attached to the notebook instance.