Docs Home Pulumi IaC Pulumi ESC Pulumi Insights Pulumi IDP Pulumi Cloud Packages Tutorials
  1. Packages
  2. AWS Cloud Control
  3. API Docs
  4. s3outposts
  5. Endpoint

We recommend new projects start with resources from the AWS provider.

AWS Cloud Control v1.28.0 published on Monday, May 19, 2025 by Pulumi
pulumi/pulumi-aws-native

aws-native.s3outposts.Endpoint

Explore with Pulumi AI

aws-native logo

We recommend new projects start with resources from the AWS provider.

AWS Cloud Control v1.28.0 published on Monday, May 19, 2025 by Pulumi
pulumi/pulumi-aws-native

    Resource Type Definition for AWS::S3Outposts::Endpoint

    Create Endpoint Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new Endpoint(name: string, args: EndpointArgs, opts?: CustomResourceOptions);
    @overload
def Endpoint(resource_name: str,
             args: EndpointArgs,
             opts: Optional[ResourceOptions] = None)

@overload
def Endpoint(resource_name: str,
             opts: Optional[ResourceOptions] = None,
             outpost_id: Optional[str] = None,
             security_group_id: Optional[str] = None,
             subnet_id: Optional[str] = None,
             access_type: Optional[EndpointAccessType] = None,
             customer_owned_ipv4_pool: Optional[str] = None,
             failed_reason: Optional[EndpointFailedReasonArgs] = None)
    func NewEndpoint(ctx *Context, name string, args EndpointArgs, opts ...ResourceOption) (*Endpoint, error)
    public Endpoint(string name, EndpointArgs args, CustomResourceOptions? opts = null)
    public Endpoint(String name, EndpointArgs args)
public Endpoint(String name, EndpointArgs args, CustomResourceOptions options)

    type: aws-native:s3outposts:Endpoint
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

    Parameters

    name string
    The unique name of the resource.
    args EndpointArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args EndpointArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args EndpointArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args EndpointArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args EndpointArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Endpoint Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The Endpoint resource accepts the following input properties:

    OutpostId string
    The id of the customer outpost on which the bucket resides.
    SecurityGroupId string
    The ID of the security group to use with the endpoint.
    SubnetId string
    The ID of the subnet in the selected VPC. The subnet must belong to the Outpost.
    AccessType Pulumi.AwsNative.S3Outposts.EndpointAccessType
    The type of access for the on-premise network connectivity for the Outpost endpoint. To access endpoint from an on-premises network, you must specify the access type and provide the customer owned Ipv4 pool.
    CustomerOwnedIpv4Pool string
    The ID of the customer-owned IPv4 pool for the Endpoint. IP addresses will be allocated from this pool for the endpoint.
    FailedReason Pulumi.AwsNative.S3Outposts.Inputs.EndpointFailedReason
    The failure reason, if any, for a create or delete endpoint operation.
    OutpostId string
    The id of the customer outpost on which the bucket resides.
    SecurityGroupId string
    The ID of the security group to use with the endpoint.
    SubnetId string
    The ID of the subnet in the selected VPC. The subnet must belong to the Outpost.
    AccessType EndpointAccessType
    The type of access for the on-premise network connectivity for the Outpost endpoint. To access endpoint from an on-premises network, you must specify the access type and provide the customer owned Ipv4 pool.
    CustomerOwnedIpv4Pool string
    The ID of the customer-owned IPv4 pool for the Endpoint. IP addresses will be allocated from this pool for the endpoint.
    FailedReason EndpointFailedReasonArgs
    The failure reason, if any, for a create or delete endpoint operation.
    outpostId String
    The id of the customer outpost on which the bucket resides.
    securityGroupId String
    The ID of the security group to use with the endpoint.
    subnetId String
    The ID of the subnet in the selected VPC. The subnet must belong to the Outpost.
    accessType EndpointAccessType
    The type of access for the on-premise network connectivity for the Outpost endpoint. To access endpoint from an on-premises network, you must specify the access type and provide the customer owned Ipv4 pool.
    customerOwnedIpv4Pool String
    The ID of the customer-owned IPv4 pool for the Endpoint. IP addresses will be allocated from this pool for the endpoint.
    failedReason EndpointFailedReason
    The failure reason, if any, for a create or delete endpoint operation.
    outpostId string
    The id of the customer outpost on which the bucket resides.
    securityGroupId string
    The ID of the security group to use with the endpoint.
    subnetId string
    The ID of the subnet in the selected VPC. The subnet must belong to the Outpost.
    accessType EndpointAccessType
    The type of access for the on-premise network connectivity for the Outpost endpoint. To access endpoint from an on-premises network, you must specify the access type and provide the customer owned Ipv4 pool.
    customerOwnedIpv4Pool string
    The ID of the customer-owned IPv4 pool for the Endpoint. IP addresses will be allocated from this pool for the endpoint.
    failedReason EndpointFailedReason
    The failure reason, if any, for a create or delete endpoint operation.
    outpost_id str
    The id of the customer outpost on which the bucket resides.
    security_group_id str
    The ID of the security group to use with the endpoint.
    subnet_id str
    The ID of the subnet in the selected VPC. The subnet must belong to the Outpost.
    access_type EndpointAccessType
    The type of access for the on-premise network connectivity for the Outpost endpoint. To access endpoint from an on-premises network, you must specify the access type and provide the customer owned Ipv4 pool.
    customer_owned_ipv4_pool str
    The ID of the customer-owned IPv4 pool for the Endpoint. IP addresses will be allocated from this pool for the endpoint.
    failed_reason EndpointFailedReasonArgs
    The failure reason, if any, for a create or delete endpoint operation.
    outpostId String
    The id of the customer outpost on which the bucket resides.
    securityGroupId String
    The ID of the security group to use with the endpoint.
    subnetId String
    The ID of the subnet in the selected VPC. The subnet must belong to the Outpost.
    accessType "CustomerOwnedIp" | "Private"
    The type of access for the on-premise network connectivity for the Outpost endpoint. To access endpoint from an on-premises network, you must specify the access type and provide the customer owned Ipv4 pool.
    customerOwnedIpv4Pool String
    The ID of the customer-owned IPv4 pool for the Endpoint. IP addresses will be allocated from this pool for the endpoint.
    failedReason Property Map
    The failure reason, if any, for a create or delete endpoint operation.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the Endpoint resource produces the following output properties:

    Arn string
    The Amazon Resource Name (ARN) of the endpoint.
    AwsId string
    The ID of the endpoint.
    CidrBlock string
    The VPC CIDR committed by this endpoint.
    CreationTime string
    The time the endpoint was created.
    Id string
    The provider-assigned unique ID for this managed resource.
    NetworkInterfaces List<Pulumi.AwsNative.S3Outposts.Outputs.EndpointNetworkInterface>
    The network interfaces of the endpoint.
    Status Pulumi.AwsNative.S3Outposts.EndpointStatus
    The status of the endpoint.
    Arn string
    The Amazon Resource Name (ARN) of the endpoint.
    AwsId string
    The ID of the endpoint.
    CidrBlock string
    The VPC CIDR committed by this endpoint.
    CreationTime string
    The time the endpoint was created.
    Id string
    The provider-assigned unique ID for this managed resource.
    NetworkInterfaces []EndpointNetworkInterface
    The network interfaces of the endpoint.
    Status EndpointStatus
    The status of the endpoint.
    arn String
    The Amazon Resource Name (ARN) of the endpoint.
    awsId String
    The ID of the endpoint.
    cidrBlock String
    The VPC CIDR committed by this endpoint.
    creationTime String
    The time the endpoint was created.
    id String
    The provider-assigned unique ID for this managed resource.
    networkInterfaces List<EndpointNetworkInterface>
    The network interfaces of the endpoint.
    status EndpointStatus
    The status of the endpoint.
    arn string
    The Amazon Resource Name (ARN) of the endpoint.
    awsId string
    The ID of the endpoint.
    cidrBlock string
    The VPC CIDR committed by this endpoint.
    creationTime string
    The time the endpoint was created.
    id string
    The provider-assigned unique ID for this managed resource.
    networkInterfaces EndpointNetworkInterface[]
    The network interfaces of the endpoint.
    status EndpointStatus
    The status of the endpoint.
    arn str
    The Amazon Resource Name (ARN) of the endpoint.
    aws_id str
    The ID of the endpoint.
    cidr_block str
    The VPC CIDR committed by this endpoint.
    creation_time str
    The time the endpoint was created.
    id str
    The provider-assigned unique ID for this managed resource.
    network_interfaces Sequence[EndpointNetworkInterface]
    The network interfaces of the endpoint.
    status EndpointStatus
    The status of the endpoint.
    arn String
    The Amazon Resource Name (ARN) of the endpoint.
    awsId String
    The ID of the endpoint.
    cidrBlock String
    The VPC CIDR committed by this endpoint.
    creationTime String
    The time the endpoint was created.
    id String
    The provider-assigned unique ID for this managed resource.
    networkInterfaces List<Property Map>
    The network interfaces of the endpoint.
    status "Available" | "Pending" | "Deleting" | "Create_Failed" | "Delete_Failed"
    The status of the endpoint.

    Supporting Types

    EndpointAccessType, EndpointAccessTypeArgs

    CustomerOwnedIp
    CustomerOwnedIp
    Private
    Private
    EndpointAccessTypeCustomerOwnedIp
    CustomerOwnedIp
    EndpointAccessTypePrivate
    Private
    CustomerOwnedIp
    CustomerOwnedIp
    Private
    Private
    CustomerOwnedIp
    CustomerOwnedIp
    Private
    Private
    CUSTOMER_OWNED_IP
    CustomerOwnedIp
    PRIVATE
    Private
    "CustomerOwnedIp"
    CustomerOwnedIp
    "Private"
    Private

    EndpointFailedReason, EndpointFailedReasonArgs

    ErrorCode string
    The failure code, if any, for a create or delete endpoint operation.
    Message string
    Additional error details describing the endpoint failure and recommended action.
    ErrorCode string
    The failure code, if any, for a create or delete endpoint operation.
    Message string
    Additional error details describing the endpoint failure and recommended action.
    errorCode String
    The failure code, if any, for a create or delete endpoint operation.
    message String
    Additional error details describing the endpoint failure and recommended action.
    errorCode string
    The failure code, if any, for a create or delete endpoint operation.
    message string
    Additional error details describing the endpoint failure and recommended action.
    error_code str
    The failure code, if any, for a create or delete endpoint operation.
    message str
    Additional error details describing the endpoint failure and recommended action.
    errorCode String
    The failure code, if any, for a create or delete endpoint operation.
    message String
    Additional error details describing the endpoint failure and recommended action.

    EndpointNetworkInterface, EndpointNetworkInterfaceArgs

    NetworkInterfaceId string
    The ID for the network interface.
    NetworkInterfaceId string
    The ID for the network interface.
    networkInterfaceId String
    The ID for the network interface.
    networkInterfaceId string
    The ID for the network interface.
    network_interface_id str
    The ID for the network interface.
    networkInterfaceId String
    The ID for the network interface.

    EndpointStatus, EndpointStatusArgs

    Available
    Available
    Pending
    Pending
    Deleting
    Deleting
    CreateFailed
    Create_Failed
    DeleteFailed
    Delete_Failed
    EndpointStatusAvailable
    Available
    EndpointStatusPending
    Pending
    EndpointStatusDeleting
    Deleting
    EndpointStatusCreateFailed
    Create_Failed
    EndpointStatusDeleteFailed
    Delete_Failed
    Available
    Available
    Pending
    Pending
    Deleting
    Deleting
    CreateFailed
    Create_Failed
    DeleteFailed
    Delete_Failed
    Available
    Available
    Pending
    Pending
    Deleting
    Deleting
    CreateFailed
    Create_Failed
    DeleteFailed
    Delete_Failed
    AVAILABLE
    Available
    PENDING
    Pending
    DELETING
    Deleting
    CREATE_FAILED
    Create_Failed
    DELETE_FAILED
    Delete_Failed
    "Available"
    Available
    "Pending"
    Pending
    "Deleting"
    Deleting
    "Create_Failed"
    Create_Failed
    "Delete_Failed"
    Delete_Failed

    Package Details

    Repository
    AWS Native pulumi/pulumi-aws-native
    License
    Apache-2.0
    aws-native logo

    We recommend new projects start with resources from the AWS provider.

    AWS Cloud Control v1.28.0 published on Monday, May 19, 2025 by Pulumi
    pulumi/pulumi-aws-native