1. Packages
  2. Azure Native
  3. API Docs
  4. containerservice
  5. getNodeCustomization
This is the latest version of Azure Native. Use the Azure Native v2 docs if using the v2 version of this package.
Azure Native v3.10.1 published on Friday, Nov 7, 2025 by Pulumi
Schema (JSON)
pulumi/pulumi-azure-native

azure-native.containerservice.getNodeCustomization

azure-native logo
This is the latest version of Azure Native. Use the Azure Native v2 docs if using the v2 version of this package.
Azure Native v3.10.1 published on Friday, Nov 7, 2025 by Pulumi
Schema (JSON)
pulumi/pulumi-azure-native

    Get a node customization at the latest version.

    Uses Azure REST API version 2025-08-02-preview.

    Other available API versions: 2025-09-02-preview. These can be accessed by generating a local SDK package using the CLI command pulumi package add azure-native containerservice [ApiVersion]. See the version guide for details.

    Using getNodeCustomization

    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 getNodeCustomization(args: GetNodeCustomizationArgs, opts?: InvokeOptions): Promise<GetNodeCustomizationResult>
function getNodeCustomizationOutput(args: GetNodeCustomizationOutputArgs, opts?: InvokeOptions): Output<GetNodeCustomizationResult>
    def get_node_customization(node_customization_name: Optional[str] = None,
                           resource_group_name: Optional[str] = None,
                           opts: Optional[InvokeOptions] = None) -> GetNodeCustomizationResult
def get_node_customization_output(node_customization_name: Optional[pulumi.Input[str]] = None,
                           resource_group_name: Optional[pulumi.Input[str]] = None,
                           opts: Optional[InvokeOptions] = None) -> Output[GetNodeCustomizationResult]
    func LookupNodeCustomization(ctx *Context, args *LookupNodeCustomizationArgs, opts ...InvokeOption) (*LookupNodeCustomizationResult, error)
func LookupNodeCustomizationOutput(ctx *Context, args *LookupNodeCustomizationOutputArgs, opts ...InvokeOption) LookupNodeCustomizationResultOutput

    > Note: This function is named LookupNodeCustomization in the Go SDK.

    public static class GetNodeCustomization 
{
    public static Task<GetNodeCustomizationResult> InvokeAsync(GetNodeCustomizationArgs args, InvokeOptions? opts = null)
    public static Output<GetNodeCustomizationResult> Invoke(GetNodeCustomizationInvokeArgs args, InvokeOptions? opts = null)
}
    public static CompletableFuture<GetNodeCustomizationResult> getNodeCustomization(GetNodeCustomizationArgs args, InvokeOptions options)
public static Output<GetNodeCustomizationResult> getNodeCustomization(GetNodeCustomizationArgs args, InvokeOptions options)

    fn::invoke:
  function: azure-native:containerservice:getNodeCustomization
  arguments:
    # arguments dictionary

    The following arguments are supported:

    NodeCustomizationName string
    The name of the Node Customization resource.
    ResourceGroupName string
    The name of the resource group. The name is case insensitive.
    NodeCustomizationName string
    The name of the Node Customization resource.
    ResourceGroupName string
    The name of the resource group. The name is case insensitive.
    nodeCustomizationName String
    The name of the Node Customization resource.
    resourceGroupName String
    The name of the resource group. The name is case insensitive.
    nodeCustomizationName string
    The name of the Node Customization resource.
    resourceGroupName string
    The name of the resource group. The name is case insensitive.
    node_customization_name str
    The name of the Node Customization resource.
    resource_group_name str
    The name of the resource group. The name is case insensitive.
    nodeCustomizationName String
    The name of the Node Customization resource.
    resourceGroupName String
    The name of the resource group. The name is case insensitive.

    getNodeCustomization Result

    The following output properties are available:

    AzureApiVersion string
    The Azure API version of the resource.
    ETag string
    If eTag is provided in the response body, it may also be provided as a header per the normal etag convention. Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields.
    Id string
    Fully qualified resource ID for the resource. E.g. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
    Location string
    The geo-location where the resource lives
    Name string
    The name of the resource
    Properties Pulumi.AzureNative.ContainerService.Outputs.NodeCustomizationPropertiesResponse
    The resource-specific properties for this resource.
    SystemData Pulumi.AzureNative.ContainerService.Outputs.SystemDataResponse
    Azure Resource Manager metadata containing createdBy and modifiedBy information.
    Type string
    The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
    Tags Dictionary<string, string>
    Resource tags.
    AzureApiVersion string
    The Azure API version of the resource.
    ETag string
    If eTag is provided in the response body, it may also be provided as a header per the normal etag convention. Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields.
    Id string
    Fully qualified resource ID for the resource. E.g. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
    Location string
    The geo-location where the resource lives
    Name string
    The name of the resource
    Properties NodeCustomizationPropertiesResponse
    The resource-specific properties for this resource.
    SystemData SystemDataResponse
    Azure Resource Manager metadata containing createdBy and modifiedBy information.
    Type string
    The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
    Tags map[string]string
    Resource tags.
    azureApiVersion String
    The Azure API version of the resource.
    eTag String
    If eTag is provided in the response body, it may also be provided as a header per the normal etag convention. Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields.
    id String
    Fully qualified resource ID for the resource. E.g. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
    location String
    The geo-location where the resource lives
    name String
    The name of the resource
    properties NodeCustomizationPropertiesResponse
    The resource-specific properties for this resource.
    systemData SystemDataResponse
    Azure Resource Manager metadata containing createdBy and modifiedBy information.
    type String
    The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
    tags Map<String,String>
    Resource tags.
    azureApiVersion string
    The Azure API version of the resource.
    eTag string
    If eTag is provided in the response body, it may also be provided as a header per the normal etag convention. Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields.
    id string
    Fully qualified resource ID for the resource. E.g. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
    location string
    The geo-location where the resource lives
    name string
    The name of the resource
    properties NodeCustomizationPropertiesResponse
    The resource-specific properties for this resource.
    systemData SystemDataResponse
    Azure Resource Manager metadata containing createdBy and modifiedBy information.
    type string
    The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
    tags {[key: string]: string}
    Resource tags.
    azure_api_version str
    The Azure API version of the resource.
    e_tag str
    If eTag is provided in the response body, it may also be provided as a header per the normal etag convention. Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields.
    id str
    Fully qualified resource ID for the resource. E.g. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
    location str
    The geo-location where the resource lives
    name str
    The name of the resource
    properties NodeCustomizationPropertiesResponse
    The resource-specific properties for this resource.
    system_data SystemDataResponse
    Azure Resource Manager metadata containing createdBy and modifiedBy information.
    type str
    The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
    tags Mapping[str, str]
    Resource tags.
    azureApiVersion String
    The Azure API version of the resource.
    eTag String
    If eTag is provided in the response body, it may also be provided as a header per the normal etag convention. Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields.
    id String
    Fully qualified resource ID for the resource. E.g. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
    location String
    The geo-location where the resource lives
    name String
    The name of the resource
    properties Property Map
    The resource-specific properties for this resource.
    systemData Property Map
    Azure Resource Manager metadata containing createdBy and modifiedBy information.
    type String
    The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
    tags Map<String>
    Resource tags.

    Supporting Types

    NodeCustomizationPropertiesResponse

    ProvisioningState string
    The provisioning state of the node customization.
    Version string
    An auto-generated value that changes when the other fields of the image customization are changed.
    ContainerImages List<string>
    The list of container images to cache on nodes. See https://kubernetes.io/docs/concepts/containers/images/#image-names
    CustomizationScripts List<Pulumi.AzureNative.ContainerService.Inputs.NodeCustomizationScriptResponse>
    The scripts to customize the node before or after image capture.
    IdentityProfile Pulumi.AzureNative.ContainerService.Inputs.UserAssignedIdentityResponse
    The identity used to execute node customization tasks during image build time and provisioning time. If not specified the default agentpool identity will be used. This does not affect provisioned nodes.
    ProvisioningState string
    The provisioning state of the node customization.
    Version string
    An auto-generated value that changes when the other fields of the image customization are changed.
    ContainerImages []string
    The list of container images to cache on nodes. See https://kubernetes.io/docs/concepts/containers/images/#image-names
    CustomizationScripts []NodeCustomizationScriptResponse
    The scripts to customize the node before or after image capture.
    IdentityProfile UserAssignedIdentityResponse
    The identity used to execute node customization tasks during image build time and provisioning time. If not specified the default agentpool identity will be used. This does not affect provisioned nodes.
    provisioningState String
    The provisioning state of the node customization.
    version String
    An auto-generated value that changes when the other fields of the image customization are changed.
    containerImages List<String>
    The list of container images to cache on nodes. See https://kubernetes.io/docs/concepts/containers/images/#image-names
    customizationScripts List<NodeCustomizationScriptResponse>
    The scripts to customize the node before or after image capture.
    identityProfile UserAssignedIdentityResponse
    The identity used to execute node customization tasks during image build time and provisioning time. If not specified the default agentpool identity will be used. This does not affect provisioned nodes.
    provisioningState string
    The provisioning state of the node customization.
    version string
    An auto-generated value that changes when the other fields of the image customization are changed.
    containerImages string[]
    The list of container images to cache on nodes. See https://kubernetes.io/docs/concepts/containers/images/#image-names
    customizationScripts NodeCustomizationScriptResponse[]
    The scripts to customize the node before or after image capture.
    identityProfile UserAssignedIdentityResponse
    The identity used to execute node customization tasks during image build time and provisioning time. If not specified the default agentpool identity will be used. This does not affect provisioned nodes.
    provisioning_state str
    The provisioning state of the node customization.
    version str
    An auto-generated value that changes when the other fields of the image customization are changed.
    container_images Sequence[str]
    The list of container images to cache on nodes. See https://kubernetes.io/docs/concepts/containers/images/#image-names
    customization_scripts Sequence[NodeCustomizationScriptResponse]
    The scripts to customize the node before or after image capture.
    identity_profile UserAssignedIdentityResponse
    The identity used to execute node customization tasks during image build time and provisioning time. If not specified the default agentpool identity will be used. This does not affect provisioned nodes.
    provisioningState String
    The provisioning state of the node customization.
    version String
    An auto-generated value that changes when the other fields of the image customization are changed.
    containerImages List<String>
    The list of container images to cache on nodes. See https://kubernetes.io/docs/concepts/containers/images/#image-names
    customizationScripts List<Property Map>
    The scripts to customize the node before or after image capture.
    identityProfile Property Map
    The identity used to execute node customization tasks during image build time and provisioning time. If not specified the default agentpool identity will be used. This does not affect provisioned nodes.

    NodeCustomizationScriptResponse

    ExecutionPoint string
    The stage at which the script is executed. Specifying NodeImageBuildTime will ensure changes are persisted into the node image.
    Name string
    The name for the customization script. Must be unique within the node customization resource. Can only contain lowercase alphanumeric,'-' or '.' characters.
    ScriptType string
    The runtime environment for the script (e.g. Bash).
    RebootAfter bool
    Whether the node should reboot after successful script execution.
    Script string
    The script content to be executed in plain text. Do not include secrets.
    ExecutionPoint string
    The stage at which the script is executed. Specifying NodeImageBuildTime will ensure changes are persisted into the node image.
    Name string
    The name for the customization script. Must be unique within the node customization resource. Can only contain lowercase alphanumeric,'-' or '.' characters.
    ScriptType string
    The runtime environment for the script (e.g. Bash).
    RebootAfter bool
    Whether the node should reboot after successful script execution.
    Script string
    The script content to be executed in plain text. Do not include secrets.
    executionPoint String
    The stage at which the script is executed. Specifying NodeImageBuildTime will ensure changes are persisted into the node image.
    name String
    The name for the customization script. Must be unique within the node customization resource. Can only contain lowercase alphanumeric,'-' or '.' characters.
    scriptType String
    The runtime environment for the script (e.g. Bash).
    rebootAfter Boolean
    Whether the node should reboot after successful script execution.
    script String
    The script content to be executed in plain text. Do not include secrets.
    executionPoint string
    The stage at which the script is executed. Specifying NodeImageBuildTime will ensure changes are persisted into the node image.
    name string
    The name for the customization script. Must be unique within the node customization resource. Can only contain lowercase alphanumeric,'-' or '.' characters.
    scriptType string
    The runtime environment for the script (e.g. Bash).
    rebootAfter boolean
    Whether the node should reboot after successful script execution.
    script string
    The script content to be executed in plain text. Do not include secrets.
    execution_point str
    The stage at which the script is executed. Specifying NodeImageBuildTime will ensure changes are persisted into the node image.
    name str
    The name for the customization script. Must be unique within the node customization resource. Can only contain lowercase alphanumeric,'-' or '.' characters.
    script_type str
    The runtime environment for the script (e.g. Bash).
    reboot_after bool
    Whether the node should reboot after successful script execution.
    script str
    The script content to be executed in plain text. Do not include secrets.
    executionPoint String
    The stage at which the script is executed. Specifying NodeImageBuildTime will ensure changes are persisted into the node image.
    name String
    The name for the customization script. Must be unique within the node customization resource. Can only contain lowercase alphanumeric,'-' or '.' characters.
    scriptType String
    The runtime environment for the script (e.g. Bash).
    rebootAfter Boolean
    Whether the node should reboot after successful script execution.
    script String
    The script content to be executed in plain text. Do not include secrets.

    SystemDataResponse

    CreatedAt string
    The timestamp of resource creation (UTC).
    CreatedBy string
    The identity that created the resource.
    CreatedByType string
    The type of identity that created the resource.
    LastModifiedAt string
    The timestamp of resource last modification (UTC)
    LastModifiedBy string
    The identity that last modified the resource.
    LastModifiedByType string
    The type of identity that last modified the resource.
    CreatedAt string
    The timestamp of resource creation (UTC).
    CreatedBy string
    The identity that created the resource.
    CreatedByType string
    The type of identity that created the resource.
    LastModifiedAt string
    The timestamp of resource last modification (UTC)
    LastModifiedBy string
    The identity that last modified the resource.
    LastModifiedByType string
    The type of identity that last modified the resource.
    createdAt String
    The timestamp of resource creation (UTC).
    createdBy String
    The identity that created the resource.
    createdByType String
    The type of identity that created the resource.
    lastModifiedAt String
    The timestamp of resource last modification (UTC)
    lastModifiedBy String
    The identity that last modified the resource.
    lastModifiedByType String
    The type of identity that last modified the resource.
    createdAt string
    The timestamp of resource creation (UTC).
    createdBy string
    The identity that created the resource.
    createdByType string
    The type of identity that created the resource.
    lastModifiedAt string
    The timestamp of resource last modification (UTC)
    lastModifiedBy string
    The identity that last modified the resource.
    lastModifiedByType string
    The type of identity that last modified the resource.
    created_at str
    The timestamp of resource creation (UTC).
    created_by str
    The identity that created the resource.
    created_by_type str
    The type of identity that created the resource.
    last_modified_at str
    The timestamp of resource last modification (UTC)
    last_modified_by str
    The identity that last modified the resource.
    last_modified_by_type str
    The type of identity that last modified the resource.
    createdAt String
    The timestamp of resource creation (UTC).
    createdBy String
    The identity that created the resource.
    createdByType String
    The type of identity that created the resource.
    lastModifiedAt String
    The timestamp of resource last modification (UTC)
    lastModifiedBy String
    The identity that last modified the resource.
    lastModifiedByType String
    The type of identity that last modified the resource.

    UserAssignedIdentityResponse

    ClientId string
    The client ID of the assigned identity.
    PrincipalId string
    The principal ID of the assigned identity.
    ObjectId string
    The object ID of the user assigned identity.
    ResourceId string
    The resource ID of the user assigned identity.
    ClientId string
    The client ID of the assigned identity.
    PrincipalId string
    The principal ID of the assigned identity.
    ObjectId string
    The object ID of the user assigned identity.
    ResourceId string
    The resource ID of the user assigned identity.
    clientId String
    The client ID of the assigned identity.
    principalId String
    The principal ID of the assigned identity.
    objectId String
    The object ID of the user assigned identity.
    resourceId String
    The resource ID of the user assigned identity.
    clientId string
    The client ID of the assigned identity.
    principalId string
    The principal ID of the assigned identity.
    objectId string
    The object ID of the user assigned identity.
    resourceId string
    The resource ID of the user assigned identity.
    client_id str
    The client ID of the assigned identity.
    principal_id str
    The principal ID of the assigned identity.
    object_id str
    The object ID of the user assigned identity.
    resource_id str
    The resource ID of the user assigned identity.
    clientId String
    The client ID of the assigned identity.
    principalId String
    The principal ID of the assigned identity.
    objectId String
    The object ID of the user assigned identity.
    resourceId String
    The resource ID of the user assigned identity.

    Package Details

    Repository
    Azure Native pulumi/pulumi-azure-native
    License
    Apache-2.0
    azure-native logo
    This is the latest version of Azure Native. Use the Azure Native v2 docs if using the v2 version of this package.
    Azure Native v3.10.1 published on Friday, Nov 7, 2025 by Pulumi
    Schema (JSON)
    pulumi/pulumi-azure-native
      Meet Neo: Your AI Platform Teammate