Viewing docs for AWS v5.43.0 (Older version)
published on Tuesday, Mar 10, 2026 by Pulumi
published on Tuesday, Mar 10, 2026 by Pulumi
Viewing docs for AWS v5.43.0 (Older version)
published on Tuesday, Mar 10, 2026 by Pulumi
published on Tuesday, Mar 10, 2026 by Pulumi
Returns a unique endpoint specific to the AWS account making the call.
Example Usage
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
using Kubernetes = Pulumi.Kubernetes;
return await Deployment.RunAsync(() =>
{
var example = Aws.Iot.GetEndpoint.Invoke();
var agent = new Kubernetes.Index.Kubernetes_pod("agent", new()
{
Metadata = new[]
{
{
{ "name", "my-device" },
},
},
Spec = new[]
{
{
{ "container", new[]
{
{
{ "image", "gcr.io/my-project/image-name" },
{ "name", "image-name" },
{ "env", new[]
{
{
{ "name", "IOT_ENDPOINT" },
{ "value", example.Apply(getEndpointResult => getEndpointResult.EndpointAddress) },
},
} },
},
} },
},
},
});
});
package main
import (
"github.com/pulumi/pulumi-aws/sdk/v5/go/aws/iot"
"github.com/pulumi/pulumi-kubernetes/sdk/v3/go/kubernetes"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
example, err := iot.GetEndpoint(ctx, nil, nil)
if err != nil {
return err
}
_, err = kubernetes.NewKubernetes_pod(ctx, "agent", &kubernetes.Kubernetes_podArgs{
Metadata: []map[string]interface{}{
map[string]interface{}{
"name": "my-device",
},
},
Spec: []map[string]interface{}{
map[string]interface{}{
"container": []map[string]interface{}{
map[string]interface{}{
"image": "gcr.io/my-project/image-name",
"name": "image-name",
"env": []map[string]interface{}{
map[string]interface{}{
"name": "IOT_ENDPOINT",
"value": example.EndpointAddress,
},
},
},
},
},
},
})
if err != nil {
return err
}
return nil
})
}
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.iot.IotFunctions;
import com.pulumi.aws.iot.inputs.GetEndpointArgs;
import com.pulumi.kubernetes.kubernetes_pod;
import com.pulumi.kubernetes.Kubernetes_podArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
final var example = IotFunctions.getEndpoint();
var agent = new Kubernetes_pod("agent", Kubernetes_podArgs.builder()
.metadata(%!v(PANIC=Format method: runtime error: invalid memory address or nil pointer dereference))
.spec(%!v(PANIC=Format method: runtime error: invalid memory address or nil pointer dereference))
.build());
}
}
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
import * as kubernetes from "@pulumi/kubernetes";
const example = aws.iot.getEndpoint({});
const agent = new kubernetes.index.Kubernetes_pod("agent", {
metadata: [{
name: "my-device",
}],
spec: [{
container: [{
image: "gcr.io/my-project/image-name",
name: "image-name",
env: [{
name: "IOT_ENDPOINT",
value: example.endpointAddress,
}],
}],
}],
});
import pulumi
import pulumi_aws as aws
import pulumi_kubernetes as kubernetes
example = aws.iot.get_endpoint()
agent = kubernetes.index.Kubernetes_pod("agent",
metadata=[{
name: my-device,
}],
spec=[{
container: [{
image: gcr.io/my-project/image-name,
name: image-name,
env: [{
name: IOT_ENDPOINT,
value: example.endpoint_address,
}],
}],
}])
resources:
agent:
type: kubernetes:kubernetes_pod
properties:
metadata:
- name: my-device
spec:
- container:
- image: gcr.io/my-project/image-name
name: image-name
env:
- name: IOT_ENDPOINT
value: ${example.endpointAddress}
variables:
example:
fn::invoke:
Function: aws:iot:getEndpoint
Arguments: {}
Using getEndpoint
Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.
function getEndpoint(args: GetEndpointArgs, opts?: InvokeOptions): Promise<GetEndpointResult>
function getEndpointOutput(args: GetEndpointOutputArgs, opts?: InvokeOptions): Output<GetEndpointResult>def get_endpoint(endpoint_type: Optional[str] = None,
opts: Optional[InvokeOptions] = None) -> GetEndpointResult
def get_endpoint_output(endpoint_type: Optional[pulumi.Input[str]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetEndpointResult]func GetEndpoint(ctx *Context, args *GetEndpointArgs, opts ...InvokeOption) (*GetEndpointResult, error)
func GetEndpointOutput(ctx *Context, args *GetEndpointOutputArgs, opts ...InvokeOption) GetEndpointResultOutput> Note: This function is named GetEndpoint in the Go SDK.
public static class GetEndpoint
{
public static Task<GetEndpointResult> InvokeAsync(GetEndpointArgs args, InvokeOptions? opts = null)
public static Output<GetEndpointResult> Invoke(GetEndpointInvokeArgs args, InvokeOptions? opts = null)
}public static CompletableFuture<GetEndpointResult> getEndpoint(GetEndpointArgs args, InvokeOptions options)
public static Output<GetEndpointResult> getEndpoint(GetEndpointArgs args, InvokeOptions options)
fn::invoke:
function: aws:iot/getEndpoint:getEndpoint
arguments:
# arguments dictionaryThe following arguments are supported:
- Endpoint
Type string - Endpoint type. Valid values:
iot:CredentialProvider,iot:Data,iot:Data-ATS,iot:Jobs.
- Endpoint
Type string - Endpoint type. Valid values:
iot:CredentialProvider,iot:Data,iot:Data-ATS,iot:Jobs.
- endpoint
Type String - Endpoint type. Valid values:
iot:CredentialProvider,iot:Data,iot:Data-ATS,iot:Jobs.
- endpoint
Type string - Endpoint type. Valid values:
iot:CredentialProvider,iot:Data,iot:Data-ATS,iot:Jobs.
- endpoint_
type str - Endpoint type. Valid values:
iot:CredentialProvider,iot:Data,iot:Data-ATS,iot:Jobs.
- endpoint
Type String - Endpoint type. Valid values:
iot:CredentialProvider,iot:Data,iot:Data-ATS,iot:Jobs.
getEndpoint Result
The following output properties are available:
- Endpoint
Address string - Endpoint based on
endpoint_type:- No
endpoint_type: Eitheriot:Dataoriot:Data-ATSdepending on region iot:CredentialsProvider:IDENTIFIER.credentials.iot.REGION.amazonaws.comiot:Data:IDENTIFIER.iot.REGION.amazonaws.comiot:Data-ATS:IDENTIFIER-ats.iot.REGION.amazonaws.comiot:Jobs:IDENTIFIER.jobs.iot.REGION.amazonaws.com
- No
- Id string
- The provider-assigned unique ID for this managed resource.
- Endpoint
Type string
- Endpoint
Address string - Endpoint based on
endpoint_type:- No
endpoint_type: Eitheriot:Dataoriot:Data-ATSdepending on region iot:CredentialsProvider:IDENTIFIER.credentials.iot.REGION.amazonaws.comiot:Data:IDENTIFIER.iot.REGION.amazonaws.comiot:Data-ATS:IDENTIFIER-ats.iot.REGION.amazonaws.comiot:Jobs:IDENTIFIER.jobs.iot.REGION.amazonaws.com
- No
- Id string
- The provider-assigned unique ID for this managed resource.
- Endpoint
Type string
- endpoint
Address String - Endpoint based on
endpoint_type:- No
endpoint_type: Eitheriot:Dataoriot:Data-ATSdepending on region iot:CredentialsProvider:IDENTIFIER.credentials.iot.REGION.amazonaws.comiot:Data:IDENTIFIER.iot.REGION.amazonaws.comiot:Data-ATS:IDENTIFIER-ats.iot.REGION.amazonaws.comiot:Jobs:IDENTIFIER.jobs.iot.REGION.amazonaws.com
- No
- id String
- The provider-assigned unique ID for this managed resource.
- endpoint
Type String
- endpoint
Address string - Endpoint based on
endpoint_type:- No
endpoint_type: Eitheriot:Dataoriot:Data-ATSdepending on region iot:CredentialsProvider:IDENTIFIER.credentials.iot.REGION.amazonaws.comiot:Data:IDENTIFIER.iot.REGION.amazonaws.comiot:Data-ATS:IDENTIFIER-ats.iot.REGION.amazonaws.comiot:Jobs:IDENTIFIER.jobs.iot.REGION.amazonaws.com
- No
- id string
- The provider-assigned unique ID for this managed resource.
- endpoint
Type string
- endpoint_
address str - Endpoint based on
endpoint_type:- No
endpoint_type: Eitheriot:Dataoriot:Data-ATSdepending on region iot:CredentialsProvider:IDENTIFIER.credentials.iot.REGION.amazonaws.comiot:Data:IDENTIFIER.iot.REGION.amazonaws.comiot:Data-ATS:IDENTIFIER-ats.iot.REGION.amazonaws.comiot:Jobs:IDENTIFIER.jobs.iot.REGION.amazonaws.com
- No
- id str
- The provider-assigned unique ID for this managed resource.
- endpoint_
type str
- endpoint
Address String - Endpoint based on
endpoint_type:- No
endpoint_type: Eitheriot:Dataoriot:Data-ATSdepending on region iot:CredentialsProvider:IDENTIFIER.credentials.iot.REGION.amazonaws.comiot:Data:IDENTIFIER.iot.REGION.amazonaws.comiot:Data-ATS:IDENTIFIER-ats.iot.REGION.amazonaws.comiot:Jobs:IDENTIFIER.jobs.iot.REGION.amazonaws.com
- No
- id String
- The provider-assigned unique ID for this managed resource.
- endpoint
Type String
Package Details
- Repository
- AWS Classic pulumi/pulumi-aws
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
awsTerraform Provider.
Viewing docs for AWS v5.43.0 (Older version)
published on Tuesday, Mar 10, 2026 by Pulumi
published on Tuesday, Mar 10, 2026 by Pulumi
