# CfnEndpointProps

Properties for defining a `CfnEndpoint`.

Extends: CfnEndpointProps
Used as props by: CfnEndpoint

- Source: Generated code

## Example

```ts
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_sagemaker as sagemaker } from 'aws-cdk-lib';
const cfnEndpointProps: sagemaker.CfnEndpointProps = {
  endpointConfigName: 'endpointConfigName',

  // the properties below are optional
  deploymentConfig: {
    autoRollbackConfiguration: {
      alarms: [{
        alarmName: 'alarmName',
      }],
    },
    blueGreenUpdatePolicy: {
      trafficRoutingConfiguration: {
        type: 'type',

        // the properties below are optional
        canarySize: {
          type: 'type',
          value: 123,
        },
        linearStepSize: {
          type: 'type',
          value: 123,
        },
        waitIntervalInSeconds: 123,
      },

      // the properties below are optional
      maximumExecutionTimeoutInSeconds: 123,
      terminationWaitInSeconds: 123,
    },
    rollingUpdatePolicy: {
      maximumBatchSize: {
        type: 'type',
        value: 123,
      },
      waitIntervalInSeconds: 123,

      // the properties below are optional
      maximumExecutionTimeoutInSeconds: 123,
      rollbackMaximumBatchSize: {
        type: 'type',
        value: 123,
      },
    },
  },
  endpointName: 'endpointName',
  excludeRetainedVariantProperties: [{
    variantPropertyType: 'variantPropertyType',
  }],
  retainAllVariantProperties: false,
  retainDeploymentConfig: false,
  tags: [{
    key: 'key',
    value: 'value',
  }],
};
```

## Properties

- `deploymentConfig`: [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [CfnEndpoint.DeploymentConfigProperty](/cdk/api/v2/docs/aws-cdk-lib.aws_sagemaker.CfnEndpoint.DeploymentConfigProperty.html) — The deployment configuration for an endpoint, which contains the desired deployment strategy and rollback configurations.

- `endpointConfigName`: string (required) — The name of the [AWS::SageMaker::EndpointConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sagemaker-endpointconfig.html) resource that specifies the configuration for the endpoint. For more information, see [CreateEndpointConfig](https://docs.aws.amazon.com/sagemaker/latest/dg/API_CreateEndpointConfig.html) .

- `endpointName`: string — The name of the endpoint.

  The name must be unique within an AWS Region in your AWS account. The name is case-insensitive in `CreateEndpoint` , but the case is preserved and must be matched in [](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_runtime_InvokeEndpoint.html) .

- `excludeRetainedVariantProperties`: [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [CfnEndpoint.VariantPropertyProperty](/cdk/api/v2/docs/aws-cdk-lib.aws_sagemaker.CfnEndpoint.VariantPropertyProperty.html)[] — When you are updating endpoint resources with [RetainAllVariantProperties](https://docs.aws.amazon.com/sagemaker/latest/dg/API_UpdateEndpoint.html#SageMaker-UpdateEndpoint-request-RetainAllVariantProperties) whose value is set to `true` , `ExcludeRetainedVariantProperties` specifies the list of type [VariantProperty](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sagemaker-endpoint-variantproperty.html) to override with the values provided by `EndpointConfig` . If you don't specify a value for `ExcludeAllVariantProperties` , no variant properties are overridden. Don't use this property when creating new endpoint resources or when `RetainAllVariantProperties` is set to `false` .

- `retainAllVariantProperties`: boolean | [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) — When updating endpoint resources, enables or disables the retention of variant properties, such as the instance count or the variant weight.

  To retain the variant properties of an endpoint when updating it, set `RetainAllVariantProperties` to `true` . To use the variant properties specified in a new `EndpointConfig` call when updating an endpoint, set `RetainAllVariantProperties` to `false` . Use this property only when updating endpoint resources, not when creating new endpoint resources.

- `retainDeploymentConfig`: boolean | [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) — Specifies whether to reuse the last deployment configuration.

  The default value is false (the configuration is not reused).

- `tags`: [CfnTag](/cdk/api/v2/docs/aws-cdk-lib.CfnTag.html)[] — A list of key-value pairs to apply to this resource.

  For more information, see [Resource Tag](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-resource-tags.html) and [Using Cost Allocation Tags](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html#allocation-what) in the *AWS Billing and Cost Management User Guide* .