create_image_version async ¶

async def create_image_version(
    self,
    *,
    config_overrides: Optional[AsyncSageMakerClientConfig] = None,
    base_image: Optional[
        "capo_sagemaker.types.image_base_image.ImageBaseImage"
    ] = None,
    client_token: Optional["capo_sagemaker.types.client_token.ClientToken"] = None,
    image_name: Optional["capo_sagemaker.types.image_name.ImageName"] = None,
    aliases: Optional[
        "capo_sagemaker.types.sage_maker_image_version_aliases.SageMakerImageVersionAliases"
    ] = None,
    vendor_guidance: Optional[
        "capo_sagemaker.types.vendor_guidance.VendorGuidance"
    ] = None,
    job_type: Optional["capo_sagemaker.types.job_type.JobType"] = None,
    ml_framework: Optional["capo_sagemaker.types.ml_framework.MLFramework"] = None,
    programming_lang: Optional[
        "capo_sagemaker.types.programming_lang.ProgrammingLang"
    ] = None,
    processor: Optional["capo_sagemaker.types.processor.Processor"] = None,
    horovod: Optional["capo_sagemaker.types.horovod.Horovod"] = None,
    release_notes: Optional[
        "capo_sagemaker.types.release_notes.ReleaseNotes"
    ] = None,
) -> (
    "capo_sagemaker.types.create_image_version_response.CreateImageVersionResponse"
):
    """<p>Creates a version of the SageMaker AI image specified by <code>ImageName</code>. The version represents the Amazon ECR container image specified by <code>BaseImage</code>.</p>

    Args:
        base_image: <p>The registry path of the container image to use as the starting point for this version. The path is an Amazon ECR URI in the following format:</p> <p> <code>&lt;acct-id&gt;.dkr.ecr.&lt;region&gt;.amazonaws.com/&lt;repo-name[:tag] or [@digest]&gt;</code> </p>
        client_token: <p>A unique ID. If not specified, the Amazon Web Services CLI and Amazon Web Services SDKs, such as the SDK for Python (Boto3), add a unique value to the call.</p>
        image_name: <p>The <code>ImageName</code> of the <code>Image</code> to create a version of.</p>
        aliases: <p>A list of aliases created with the image version.</p>
        vendor_guidance: <p>The stability of the image version, specified by the maintainer.</p> <ul> <li> <p> <code>NOT_PROVIDED</code>: The maintainers did not provide a status for image version stability.</p> </li> <li> <p> <code>STABLE</code>: The image version is stable.</p> </li> <li> <p> <code>TO_BE_ARCHIVED</code>: The image version is set to be archived. Custom image versions that are set to be archived are automatically archived after three months.</p> </li> <li> <p> <code>ARCHIVED</code>: The image version is archived. Archived image versions are not searchable and are no longer actively supported. </p> </li> </ul>
        job_type: <p>Indicates SageMaker AI job type compatibility.</p> <ul> <li> <p> <code>TRAINING</code>: The image version is compatible with SageMaker AI training jobs.</p> </li> <li> <p> <code>INFERENCE</code>: The image version is compatible with SageMaker AI inference jobs.</p> </li> <li> <p> <code>NOTEBOOK_KERNEL</code>: The image version is compatible with SageMaker AI notebook kernels.</p> </li> </ul>
        ml_framework: <p>The machine learning framework vended in the image version.</p>
        programming_lang: <p>The supported programming language and its version.</p>
        processor: <p>Indicates CPU or GPU compatibility.</p> <ul> <li> <p> <code>CPU</code>: The image version is compatible with CPU.</p> </li> <li> <p> <code>GPU</code>: The image version is compatible with GPU.</p> </li> </ul>
        horovod: <p>Indicates Horovod compatibility.</p>
        release_notes: <p>The maintainer description of the image version.</p>

    Raises:
        capo_sagemaker.errors.resource_in_use.ResourceInUse: <p>Resource being accessed is in use.</p>
        capo_sagemaker.errors.resource_limit_exceeded.ResourceLimitExceeded: <p> You have exceeded an SageMaker resource limit. For example, you might have too many training jobs created. </p>
        capo_sagemaker.errors.resource_not_found.ResourceNotFound: <p>Resource being access is not found.</p>
        capo_sagemaker.errors.UnknownServiceError: The service returned an error code this client does not model.
    """

    async def _handler(
        req: "AsyncOperationRequest[capo_sagemaker.types.create_image_version_request.CreateImageVersionRequest]",
    ) -> AsyncOperationResponse[
        "capo_sagemaker.types.create_image_version_response.CreateImageVersionResponse"
    ]:
        import capo_sagemaker._operations.sage_maker.create_image_version

        (
            output,
            http_response,
        ) = await capo_sagemaker._operations.sage_maker.create_image_version.async_create_image_version(
            req.options, req.input
        )
        return AsyncOperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("CreateImageVersion")
    )
    input_: capo_sagemaker.types.create_image_version_request.CreateImageVersionRequest = {}
    if base_image is not None:
        input_["base_image"] = base_image
    if client_token is None:
        client_token = str(uuid.uuid4())
    input_["client_token"] = client_token
    if image_name is not None:
        input_["image_name"] = image_name
    if aliases is not None:
        input_["aliases"] = aliases
    if vendor_guidance is not None:
        input_["vendor_guidance"] = vendor_guidance
    if job_type is not None:
        input_["job_type"] = job_type
    if ml_framework is not None:
        input_["ml_framework"] = ml_framework
    if programming_lang is not None:
        input_["programming_lang"] = programming_lang
    if processor is not None:
        input_["processor"] = processor
    if horovod is not None:
        input_["horovod"] = horovod
    if release_notes is not None:
        input_["release_notes"] = release_notes

    response = await aexecute_pipeline(
        AsyncOperationRequest(input=input_, options=options_),
        handler=_handler,
        interceptors=list(interceptors_),
    )
    await response.response.aclose()
    return response.output