SageMaker / Client / describe_model_card

describe_model_card#

SageMaker.Client.describe_model_card(**kwargs)#

Describes the content, creation time, and security configuration of an Amazon SageMaker Model Card.

See also: AWS API Documentation

Request Syntax

response = client.describe_model_card(
    ModelCardName='string',
    ModelCardVersion=123
)
Parameters:
  • ModelCardName (string) –

    [REQUIRED]

    The name or Amazon Resource Name (ARN) of the model card to describe.

  • ModelCardVersion (integer) – The version of the model card to describe. If a version is not provided, then the latest version of the model card is described.

Return type:

dict

Returns:

Response Syntax

{
    'ModelCardArn': 'string',
    'ModelCardName': 'string',
    'ModelCardVersion': 123,
    'Content': 'string',
    'ModelCardStatus': 'Draft'|'PendingReview'|'Approved'|'Archived',
    'SecurityConfig': {
        'KmsKeyId': 'string'
    },
    'CreationTime': datetime(2015, 1, 1),
    'CreatedBy': {
        'UserProfileArn': 'string',
        'UserProfileName': 'string',
        'DomainId': 'string',
        'IamIdentity': {
            'Arn': 'string',
            'PrincipalId': 'string',
            'SourceIdentity': 'string'
        }
    },
    'LastModifiedTime': datetime(2015, 1, 1),
    'LastModifiedBy': {
        'UserProfileArn': 'string',
        'UserProfileName': 'string',
        'DomainId': 'string',
        'IamIdentity': {
            'Arn': 'string',
            'PrincipalId': 'string',
            'SourceIdentity': 'string'
        }
    },
    'ModelCardProcessingStatus': 'DeleteInProgress'|'DeletePending'|'ContentDeleted'|'ExportJobsDeleted'|'DeleteCompleted'|'DeleteFailed'
}

Response Structure

  • (dict) –

    • ModelCardArn (string) –

      The Amazon Resource Name (ARN) of the model card.

    • ModelCardName (string) –

      The name of the model card.

    • ModelCardVersion (integer) –

      The version of the model card.

    • Content (string) –

      The content of the model card.

    • ModelCardStatus (string) –

      The approval status of the model card within your organization. Different organizations might have different criteria for model card review and approval.

      • Draft: The model card is a work in progress.

      • PendingReview: The model card is pending review.

      • Approved: The model card is approved.

      • Archived: The model card is archived. No more updates should be made to the model card, but it can still be exported.

    • SecurityConfig (dict) –

      The security configuration used to protect model card content.

      • KmsKeyId (string) –

        A Key Management Service key ID to use for encrypting a model card.

    • CreationTime (datetime) –

      The date and time the model card was created.

    • CreatedBy (dict) –

      Information about the user who created or modified an experiment, trial, trial component, lineage group, project, or model card.

      • UserProfileArn (string) –

        The Amazon Resource Name (ARN) of the user’s profile.

      • UserProfileName (string) –

        The name of the user’s profile.

      • DomainId (string) –

        The domain associated with the user.

      • IamIdentity (dict) –

        The IAM Identity details associated with the user. These details are associated with model package groups, model packages, and project entities only.

        • Arn (string) –

          The Amazon Resource Name (ARN) of the IAM identity.

        • PrincipalId (string) –

          The ID of the principal that assumes the IAM identity.

        • SourceIdentity (string) –

          The person or application which assumes the IAM identity.

    • LastModifiedTime (datetime) –

      The date and time the model card was last modified.

    • LastModifiedBy (dict) –

      Information about the user who created or modified an experiment, trial, trial component, lineage group, project, or model card.

      • UserProfileArn (string) –

        The Amazon Resource Name (ARN) of the user’s profile.

      • UserProfileName (string) –

        The name of the user’s profile.

      • DomainId (string) –

        The domain associated with the user.

      • IamIdentity (dict) –

        The IAM Identity details associated with the user. These details are associated with model package groups, model packages, and project entities only.

        • Arn (string) –

          The Amazon Resource Name (ARN) of the IAM identity.

        • PrincipalId (string) –

          The ID of the principal that assumes the IAM identity.

        • SourceIdentity (string) –

          The person or application which assumes the IAM identity.

    • ModelCardProcessingStatus (string) –

      The processing status of model card deletion. The ModelCardProcessingStatus updates throughout the different deletion steps.

      • DeletePending: Model card deletion request received.

      • DeleteInProgress: Model card deletion is in progress.

      • ContentDeleted: Deleted model card content.

      • ExportJobsDeleted: Deleted all export jobs associated with the model card.

      • DeleteCompleted: Successfully deleted the model card.

      • DeleteFailed: The model card failed to delete.

Exceptions

  • SageMaker.Client.exceptions.ResourceNotFound