1. Packages
  2. Auth0 Provider
  3. API Docs
  4. Action
Auth0 v3.8.3 published on Wednesday, Nov 6, 2024 by Pulumi

auth0.Action

Explore with Pulumi AI

auth0 logo
Auth0 v3.8.3 published on Wednesday, Nov 6, 2024 by Pulumi

    Actions are secure, tenant-specific, versioned functions written in Node.js that execute at certain points during the Auth0 runtime. Actions are used to customize and extend Auth0’s capabilities with custom logic.

    Create Action Resource

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

    Constructor syntax

    new Action(name: string, args: ActionArgs, opts?: CustomResourceOptions);
    @overload
    def Action(resource_name: str,
               args: ActionArgs,
               opts: Optional[ResourceOptions] = None)
    
    @overload
    def Action(resource_name: str,
               opts: Optional[ResourceOptions] = None,
               code: Optional[str] = None,
               supported_triggers: Optional[ActionSupportedTriggersArgs] = None,
               dependencies: Optional[Sequence[ActionDependencyArgs]] = None,
               deploy: Optional[bool] = None,
               name: Optional[str] = None,
               runtime: Optional[str] = None,
               secrets: Optional[Sequence[ActionSecretArgs]] = None)
    func NewAction(ctx *Context, name string, args ActionArgs, opts ...ResourceOption) (*Action, error)
    public Action(string name, ActionArgs args, CustomResourceOptions? opts = null)
    public Action(String name, ActionArgs args)
    public Action(String name, ActionArgs args, CustomResourceOptions options)
    
    type: auth0:Action
    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 ActionArgs
    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 ActionArgs
    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 ActionArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args ActionArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args ActionArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var actionResource = new Auth0.Action("actionResource", new()
    {
        Code = "string",
        SupportedTriggers = new Auth0.Inputs.ActionSupportedTriggersArgs
        {
            Id = "string",
            Version = "string",
        },
        Dependencies = new[]
        {
            new Auth0.Inputs.ActionDependencyArgs
            {
                Name = "string",
                Version = "string",
            },
        },
        Deploy = false,
        Name = "string",
        Runtime = "string",
        Secrets = new[]
        {
            new Auth0.Inputs.ActionSecretArgs
            {
                Name = "string",
                Value = "string",
            },
        },
    });
    
    example, err := auth0.NewAction(ctx, "actionResource", &auth0.ActionArgs{
    	Code: pulumi.String("string"),
    	SupportedTriggers: &auth0.ActionSupportedTriggersArgs{
    		Id:      pulumi.String("string"),
    		Version: pulumi.String("string"),
    	},
    	Dependencies: auth0.ActionDependencyArray{
    		&auth0.ActionDependencyArgs{
    			Name:    pulumi.String("string"),
    			Version: pulumi.String("string"),
    		},
    	},
    	Deploy:  pulumi.Bool(false),
    	Name:    pulumi.String("string"),
    	Runtime: pulumi.String("string"),
    	Secrets: auth0.ActionSecretArray{
    		&auth0.ActionSecretArgs{
    			Name:  pulumi.String("string"),
    			Value: pulumi.String("string"),
    		},
    	},
    })
    
    var actionResource = new Action("actionResource", ActionArgs.builder()
        .code("string")
        .supportedTriggers(ActionSupportedTriggersArgs.builder()
            .id("string")
            .version("string")
            .build())
        .dependencies(ActionDependencyArgs.builder()
            .name("string")
            .version("string")
            .build())
        .deploy(false)
        .name("string")
        .runtime("string")
        .secrets(ActionSecretArgs.builder()
            .name("string")
            .value("string")
            .build())
        .build());
    
    action_resource = auth0.Action("actionResource",
        code="string",
        supported_triggers={
            "id": "string",
            "version": "string",
        },
        dependencies=[{
            "name": "string",
            "version": "string",
        }],
        deploy=False,
        name="string",
        runtime="string",
        secrets=[{
            "name": "string",
            "value": "string",
        }])
    
    const actionResource = new auth0.Action("actionResource", {
        code: "string",
        supportedTriggers: {
            id: "string",
            version: "string",
        },
        dependencies: [{
            name: "string",
            version: "string",
        }],
        deploy: false,
        name: "string",
        runtime: "string",
        secrets: [{
            name: "string",
            value: "string",
        }],
    });
    
    type: auth0:Action
    properties:
        code: string
        dependencies:
            - name: string
              version: string
        deploy: false
        name: string
        runtime: string
        secrets:
            - name: string
              value: string
        supportedTriggers:
            id: string
            version: string
    

    Action 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 Action resource accepts the following input properties:

    Code string
    The source code of the action.
    SupportedTriggers ActionSupportedTriggers
    List of triggers that this action supports. At this time, an action can only target a single trigger at a time. Read Retrieving the set of triggers available within actions to retrieve the latest trigger versions supported.
    Dependencies List<ActionDependency>
    List of third party npm modules, and their versions, that this action depends on.
    Deploy bool
    Deploying an action will create a new immutable version of the action. If the action is currently bound to a trigger, then the system will begin executing the newly deployed version of the action immediately.
    Name string
    The name of the action.
    Runtime string
    The Node runtime. Defaults to node18. Possible values are: node16 (not recommended), or node18 (recommended).
    Secrets List<ActionSecret>
    List of secrets that are included in an action or a version of an action. Partial management of secrets is not supported.
    Code string
    The source code of the action.
    SupportedTriggers ActionSupportedTriggersArgs
    List of triggers that this action supports. At this time, an action can only target a single trigger at a time. Read Retrieving the set of triggers available within actions to retrieve the latest trigger versions supported.
    Dependencies []ActionDependencyArgs
    List of third party npm modules, and their versions, that this action depends on.
    Deploy bool
    Deploying an action will create a new immutable version of the action. If the action is currently bound to a trigger, then the system will begin executing the newly deployed version of the action immediately.
    Name string
    The name of the action.
    Runtime string
    The Node runtime. Defaults to node18. Possible values are: node16 (not recommended), or node18 (recommended).
    Secrets []ActionSecretArgs
    List of secrets that are included in an action or a version of an action. Partial management of secrets is not supported.
    code String
    The source code of the action.
    supportedTriggers ActionSupportedTriggers
    List of triggers that this action supports. At this time, an action can only target a single trigger at a time. Read Retrieving the set of triggers available within actions to retrieve the latest trigger versions supported.
    dependencies List<ActionDependency>
    List of third party npm modules, and their versions, that this action depends on.
    deploy Boolean
    Deploying an action will create a new immutable version of the action. If the action is currently bound to a trigger, then the system will begin executing the newly deployed version of the action immediately.
    name String
    The name of the action.
    runtime String
    The Node runtime. Defaults to node18. Possible values are: node16 (not recommended), or node18 (recommended).
    secrets List<ActionSecret>
    List of secrets that are included in an action or a version of an action. Partial management of secrets is not supported.
    code string
    The source code of the action.
    supportedTriggers ActionSupportedTriggers
    List of triggers that this action supports. At this time, an action can only target a single trigger at a time. Read Retrieving the set of triggers available within actions to retrieve the latest trigger versions supported.
    dependencies ActionDependency[]
    List of third party npm modules, and their versions, that this action depends on.
    deploy boolean
    Deploying an action will create a new immutable version of the action. If the action is currently bound to a trigger, then the system will begin executing the newly deployed version of the action immediately.
    name string
    The name of the action.
    runtime string
    The Node runtime. Defaults to node18. Possible values are: node16 (not recommended), or node18 (recommended).
    secrets ActionSecret[]
    List of secrets that are included in an action or a version of an action. Partial management of secrets is not supported.
    code str
    The source code of the action.
    supported_triggers ActionSupportedTriggersArgs
    List of triggers that this action supports. At this time, an action can only target a single trigger at a time. Read Retrieving the set of triggers available within actions to retrieve the latest trigger versions supported.
    dependencies Sequence[ActionDependencyArgs]
    List of third party npm modules, and their versions, that this action depends on.
    deploy bool
    Deploying an action will create a new immutable version of the action. If the action is currently bound to a trigger, then the system will begin executing the newly deployed version of the action immediately.
    name str
    The name of the action.
    runtime str
    The Node runtime. Defaults to node18. Possible values are: node16 (not recommended), or node18 (recommended).
    secrets Sequence[ActionSecretArgs]
    List of secrets that are included in an action or a version of an action. Partial management of secrets is not supported.
    code String
    The source code of the action.
    supportedTriggers Property Map
    List of triggers that this action supports. At this time, an action can only target a single trigger at a time. Read Retrieving the set of triggers available within actions to retrieve the latest trigger versions supported.
    dependencies List<Property Map>
    List of third party npm modules, and their versions, that this action depends on.
    deploy Boolean
    Deploying an action will create a new immutable version of the action. If the action is currently bound to a trigger, then the system will begin executing the newly deployed version of the action immediately.
    name String
    The name of the action.
    runtime String
    The Node runtime. Defaults to node18. Possible values are: node16 (not recommended), or node18 (recommended).
    secrets List<Property Map>
    List of secrets that are included in an action or a version of an action. Partial management of secrets is not supported.

    Outputs

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

    Id string
    The provider-assigned unique ID for this managed resource.
    VersionId string
    Version ID of the action. This value is available if deploy is set to true.
    Id string
    The provider-assigned unique ID for this managed resource.
    VersionId string
    Version ID of the action. This value is available if deploy is set to true.
    id String
    The provider-assigned unique ID for this managed resource.
    versionId String
    Version ID of the action. This value is available if deploy is set to true.
    id string
    The provider-assigned unique ID for this managed resource.
    versionId string
    Version ID of the action. This value is available if deploy is set to true.
    id str
    The provider-assigned unique ID for this managed resource.
    version_id str
    Version ID of the action. This value is available if deploy is set to true.
    id String
    The provider-assigned unique ID for this managed resource.
    versionId String
    Version ID of the action. This value is available if deploy is set to true.

    Look up Existing Action Resource

    Get an existing Action resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: ActionState, opts?: CustomResourceOptions): Action
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            code: Optional[str] = None,
            dependencies: Optional[Sequence[ActionDependencyArgs]] = None,
            deploy: Optional[bool] = None,
            name: Optional[str] = None,
            runtime: Optional[str] = None,
            secrets: Optional[Sequence[ActionSecretArgs]] = None,
            supported_triggers: Optional[ActionSupportedTriggersArgs] = None,
            version_id: Optional[str] = None) -> Action
    func GetAction(ctx *Context, name string, id IDInput, state *ActionState, opts ...ResourceOption) (*Action, error)
    public static Action Get(string name, Input<string> id, ActionState? state, CustomResourceOptions? opts = null)
    public static Action get(String name, Output<String> id, ActionState state, CustomResourceOptions options)
    Resource lookup is not supported in YAML
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    Code string
    The source code of the action.
    Dependencies List<ActionDependency>
    List of third party npm modules, and their versions, that this action depends on.
    Deploy bool
    Deploying an action will create a new immutable version of the action. If the action is currently bound to a trigger, then the system will begin executing the newly deployed version of the action immediately.
    Name string
    The name of the action.
    Runtime string
    The Node runtime. Defaults to node18. Possible values are: node16 (not recommended), or node18 (recommended).
    Secrets List<ActionSecret>
    List of secrets that are included in an action or a version of an action. Partial management of secrets is not supported.
    SupportedTriggers ActionSupportedTriggers
    List of triggers that this action supports. At this time, an action can only target a single trigger at a time. Read Retrieving the set of triggers available within actions to retrieve the latest trigger versions supported.
    VersionId string
    Version ID of the action. This value is available if deploy is set to true.
    Code string
    The source code of the action.
    Dependencies []ActionDependencyArgs
    List of third party npm modules, and their versions, that this action depends on.
    Deploy bool
    Deploying an action will create a new immutable version of the action. If the action is currently bound to a trigger, then the system will begin executing the newly deployed version of the action immediately.
    Name string
    The name of the action.
    Runtime string
    The Node runtime. Defaults to node18. Possible values are: node16 (not recommended), or node18 (recommended).
    Secrets []ActionSecretArgs
    List of secrets that are included in an action or a version of an action. Partial management of secrets is not supported.
    SupportedTriggers ActionSupportedTriggersArgs
    List of triggers that this action supports. At this time, an action can only target a single trigger at a time. Read Retrieving the set of triggers available within actions to retrieve the latest trigger versions supported.
    VersionId string
    Version ID of the action. This value is available if deploy is set to true.
    code String
    The source code of the action.
    dependencies List<ActionDependency>
    List of third party npm modules, and their versions, that this action depends on.
    deploy Boolean
    Deploying an action will create a new immutable version of the action. If the action is currently bound to a trigger, then the system will begin executing the newly deployed version of the action immediately.
    name String
    The name of the action.
    runtime String
    The Node runtime. Defaults to node18. Possible values are: node16 (not recommended), or node18 (recommended).
    secrets List<ActionSecret>
    List of secrets that are included in an action or a version of an action. Partial management of secrets is not supported.
    supportedTriggers ActionSupportedTriggers
    List of triggers that this action supports. At this time, an action can only target a single trigger at a time. Read Retrieving the set of triggers available within actions to retrieve the latest trigger versions supported.
    versionId String
    Version ID of the action. This value is available if deploy is set to true.
    code string
    The source code of the action.
    dependencies ActionDependency[]
    List of third party npm modules, and their versions, that this action depends on.
    deploy boolean
    Deploying an action will create a new immutable version of the action. If the action is currently bound to a trigger, then the system will begin executing the newly deployed version of the action immediately.
    name string
    The name of the action.
    runtime string
    The Node runtime. Defaults to node18. Possible values are: node16 (not recommended), or node18 (recommended).
    secrets ActionSecret[]
    List of secrets that are included in an action or a version of an action. Partial management of secrets is not supported.
    supportedTriggers ActionSupportedTriggers
    List of triggers that this action supports. At this time, an action can only target a single trigger at a time. Read Retrieving the set of triggers available within actions to retrieve the latest trigger versions supported.
    versionId string
    Version ID of the action. This value is available if deploy is set to true.
    code str
    The source code of the action.
    dependencies Sequence[ActionDependencyArgs]
    List of third party npm modules, and their versions, that this action depends on.
    deploy bool
    Deploying an action will create a new immutable version of the action. If the action is currently bound to a trigger, then the system will begin executing the newly deployed version of the action immediately.
    name str
    The name of the action.
    runtime str
    The Node runtime. Defaults to node18. Possible values are: node16 (not recommended), or node18 (recommended).
    secrets Sequence[ActionSecretArgs]
    List of secrets that are included in an action or a version of an action. Partial management of secrets is not supported.
    supported_triggers ActionSupportedTriggersArgs
    List of triggers that this action supports. At this time, an action can only target a single trigger at a time. Read Retrieving the set of triggers available within actions to retrieve the latest trigger versions supported.
    version_id str
    Version ID of the action. This value is available if deploy is set to true.
    code String
    The source code of the action.
    dependencies List<Property Map>
    List of third party npm modules, and their versions, that this action depends on.
    deploy Boolean
    Deploying an action will create a new immutable version of the action. If the action is currently bound to a trigger, then the system will begin executing the newly deployed version of the action immediately.
    name String
    The name of the action.
    runtime String
    The Node runtime. Defaults to node18. Possible values are: node16 (not recommended), or node18 (recommended).
    secrets List<Property Map>
    List of secrets that are included in an action or a version of an action. Partial management of secrets is not supported.
    supportedTriggers Property Map
    List of triggers that this action supports. At this time, an action can only target a single trigger at a time. Read Retrieving the set of triggers available within actions to retrieve the latest trigger versions supported.
    versionId String
    Version ID of the action. This value is available if deploy is set to true.

    Supporting Types

    ActionDependency, ActionDependencyArgs

    Name string
    Dependency name, e.g. lodash.
    Version string
    Dependency version, e.g. latest or 4.17.21.
    Name string
    Dependency name, e.g. lodash.
    Version string
    Dependency version, e.g. latest or 4.17.21.
    name String
    Dependency name, e.g. lodash.
    version String
    Dependency version, e.g. latest or 4.17.21.
    name string
    Dependency name, e.g. lodash.
    version string
    Dependency version, e.g. latest or 4.17.21.
    name str
    Dependency name, e.g. lodash.
    version str
    Dependency version, e.g. latest or 4.17.21.
    name String
    Dependency name, e.g. lodash.
    version String
    Dependency version, e.g. latest or 4.17.21.

    ActionSecret, ActionSecretArgs

    Name string
    Secret name.
    Value string
    Secret value.
    Name string
    Secret name.
    Value string
    Secret value.
    name String
    Secret name.
    value String
    Secret value.
    name string
    Secret name.
    value string
    Secret value.
    name str
    Secret name.
    value str
    Secret value.
    name String
    Secret name.
    value String
    Secret value.

    ActionSupportedTriggers, ActionSupportedTriggersArgs

    Id string
    The trigger ID.
    Version string
    The trigger version. This regulates which runtime versions are supported.
    Id string
    The trigger ID.
    Version string
    The trigger version. This regulates which runtime versions are supported.
    id String
    The trigger ID.
    version String
    The trigger version. This regulates which runtime versions are supported.
    id string
    The trigger ID.
    version string
    The trigger version. This regulates which runtime versions are supported.
    id str
    The trigger ID.
    version str
    The trigger version. This regulates which runtime versions are supported.
    id String
    The trigger ID.
    version String
    The trigger version. This regulates which runtime versions are supported.

    Import

    This resource can be imported by specifying the action ID.

    Example:

    $ pulumi import auth0:index/action:Action my_action "12f4f21b-017a-319d-92e7-2291c1ca36c4"
    

    ~> For security reasons importing secrets is not allowed. Therefore, it is advised to import

    the action without secrets and adding them back after the action has been imported.

    To learn more about importing existing cloud resources, see Importing resources.

    Package Details

    Repository
    Auth0 pulumi/pulumi-auth0
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the auth0 Terraform Provider.
    auth0 logo
    Auth0 v3.8.3 published on Wednesday, Nov 6, 2024 by Pulumi