1. Packages
  2. Okta Provider
  3. API Docs
  4. RequestSettingResource
Okta v6.0.0 published on Friday, Oct 10, 2025 by Pulumi

okta.RequestSettingResource

Deploy with Pulumi
okta logo
Okta v6.0.0 published on Friday, Oct 10, 2025 by Pulumi

    Manages request settings. This resource allows you to read and configure an Okta request-setting.

    Example Usage

    Example coming soon!
    
    Example coming soon!
    
    Example coming soon!
    
    Example coming soon!
    
    Example coming soon!
    
    resources:
      test:
        type: okta:RequestSettingResource
        properties:
          resourceId: <resource_id>
          riskSettings:
            - defaultSetting:
                - requestSubmissionType: ALLOWED_WITH_OVERRIDES
                  approvalSequenceId: <approval_sequence_id>
          requestOnBehalfOfSettings:
            - allowed: true
    

    Create RequestSettingResource Resource

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

    Constructor syntax

    new RequestSettingResource(name: string, args: RequestSettingResourceArgs, opts?: CustomResourceOptions);
    @overload
    def RequestSettingResource(resource_name: str,
                               args: RequestSettingResourceArgs,
                               opts: Optional[ResourceOptions] = None)
    
    @overload
    def RequestSettingResource(resource_name: str,
                               opts: Optional[ResourceOptions] = None,
                               id_property: Optional[str] = None,
                               request_on_behalf_of_settings: Optional[RequestSettingResourceRequestOnBehalfOfSettingsArgs] = None,
                               risk_settings: Optional[RequestSettingResourceRiskSettingsArgs] = None)
    func NewRequestSettingResource(ctx *Context, name string, args RequestSettingResourceArgs, opts ...ResourceOption) (*RequestSettingResource, error)
    public RequestSettingResource(string name, RequestSettingResourceArgs args, CustomResourceOptions? opts = null)
    public RequestSettingResource(String name, RequestSettingResourceArgs args)
    public RequestSettingResource(String name, RequestSettingResourceArgs args, CustomResourceOptions options)
    
    type: okta:RequestSettingResource
    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 RequestSettingResourceArgs
    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 RequestSettingResourceArgs
    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 RequestSettingResourceArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args RequestSettingResourceArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args RequestSettingResourceArgs
    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 requestSettingResourceResource = new Okta.RequestSettingResource("requestSettingResourceResource", new()
    {
        IdProperty = "string",
        RequestOnBehalfOfSettings = new Okta.Inputs.RequestSettingResourceRequestOnBehalfOfSettingsArgs
        {
            Allowed = false,
            OnlyFors = new[]
            {
                new Okta.Inputs.RequestSettingResourceRequestOnBehalfOfSettingsOnlyForArgs
                {
                    Type = "string",
                },
            },
        },
        RiskSettings = new Okta.Inputs.RequestSettingResourceRiskSettingsArgs
        {
            DefaultSetting = new Okta.Inputs.RequestSettingResourceRiskSettingsDefaultSettingArgs
            {
                AccessDurationSettings = new Okta.Inputs.RequestSettingResourceRiskSettingsDefaultSettingAccessDurationSettingsArgs
                {
                    Duration = "string",
                    Type = "string",
                },
                ApprovalSequenceId = "string",
                Errors = new[]
                {
                    "string",
                },
                RequestSubmissionType = "string",
            },
        },
    });
    
    example, err := okta.NewRequestSettingResource(ctx, "requestSettingResourceResource", &okta.RequestSettingResourceArgs{
    	IdProperty: pulumi.String("string"),
    	RequestOnBehalfOfSettings: &okta.RequestSettingResourceRequestOnBehalfOfSettingsArgs{
    		Allowed: pulumi.Bool(false),
    		OnlyFors: okta.RequestSettingResourceRequestOnBehalfOfSettingsOnlyForArray{
    			&okta.RequestSettingResourceRequestOnBehalfOfSettingsOnlyForArgs{
    				Type: pulumi.String("string"),
    			},
    		},
    	},
    	RiskSettings: &okta.RequestSettingResourceRiskSettingsArgs{
    		DefaultSetting: &okta.RequestSettingResourceRiskSettingsDefaultSettingArgs{
    			AccessDurationSettings: &okta.RequestSettingResourceRiskSettingsDefaultSettingAccessDurationSettingsArgs{
    				Duration: pulumi.String("string"),
    				Type:     pulumi.String("string"),
    			},
    			ApprovalSequenceId: pulumi.String("string"),
    			Errors: pulumi.StringArray{
    				pulumi.String("string"),
    			},
    			RequestSubmissionType: pulumi.String("string"),
    		},
    	},
    })
    
    var requestSettingResourceResource = new RequestSettingResource("requestSettingResourceResource", RequestSettingResourceArgs.builder()
        .idProperty("string")
        .requestOnBehalfOfSettings(RequestSettingResourceRequestOnBehalfOfSettingsArgs.builder()
            .allowed(false)
            .onlyFors(RequestSettingResourceRequestOnBehalfOfSettingsOnlyForArgs.builder()
                .type("string")
                .build())
            .build())
        .riskSettings(RequestSettingResourceRiskSettingsArgs.builder()
            .defaultSetting(RequestSettingResourceRiskSettingsDefaultSettingArgs.builder()
                .accessDurationSettings(RequestSettingResourceRiskSettingsDefaultSettingAccessDurationSettingsArgs.builder()
                    .duration("string")
                    .type("string")
                    .build())
                .approvalSequenceId("string")
                .errors("string")
                .requestSubmissionType("string")
                .build())
            .build())
        .build());
    
    request_setting_resource_resource = okta.RequestSettingResource("requestSettingResourceResource",
        id_property="string",
        request_on_behalf_of_settings={
            "allowed": False,
            "only_fors": [{
                "type": "string",
            }],
        },
        risk_settings={
            "default_setting": {
                "access_duration_settings": {
                    "duration": "string",
                    "type": "string",
                },
                "approval_sequence_id": "string",
                "errors": ["string"],
                "request_submission_type": "string",
            },
        })
    
    const requestSettingResourceResource = new okta.RequestSettingResource("requestSettingResourceResource", {
        idProperty: "string",
        requestOnBehalfOfSettings: {
            allowed: false,
            onlyFors: [{
                type: "string",
            }],
        },
        riskSettings: {
            defaultSetting: {
                accessDurationSettings: {
                    duration: "string",
                    type: "string",
                },
                approvalSequenceId: "string",
                errors: ["string"],
                requestSubmissionType: "string",
            },
        },
    });
    
    type: okta:RequestSettingResource
    properties:
        idProperty: string
        requestOnBehalfOfSettings:
            allowed: false
            onlyFors:
                - type: string
        riskSettings:
            defaultSetting:
                accessDurationSettings:
                    duration: string
                    type: string
                approvalSequenceId: string
                errors:
                    - string
                requestSubmissionType: string
    

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

    IdProperty string
    The id of the resource in Okta ID format.
    RequestOnBehalfOfSettings RequestSettingResourceRequestOnBehalfOfSettings
    Specifies if and for whom a requester may request the resource for.
    RiskSettings RequestSettingResourceRiskSettings
    Risk settings for the resource.
    IdProperty string
    The id of the resource in Okta ID format.
    RequestOnBehalfOfSettings RequestSettingResourceRequestOnBehalfOfSettingsArgs
    Specifies if and for whom a requester may request the resource for.
    RiskSettings RequestSettingResourceRiskSettingsArgs
    Risk settings for the resource.
    idProperty String
    The id of the resource in Okta ID format.
    requestOnBehalfOfSettings RequestSettingResourceRequestOnBehalfOfSettings
    Specifies if and for whom a requester may request the resource for.
    riskSettings RequestSettingResourceRiskSettings
    Risk settings for the resource.
    idProperty string
    The id of the resource in Okta ID format.
    requestOnBehalfOfSettings RequestSettingResourceRequestOnBehalfOfSettings
    Specifies if and for whom a requester may request the resource for.
    riskSettings RequestSettingResourceRiskSettings
    Risk settings for the resource.
    id_property str
    The id of the resource in Okta ID format.
    request_on_behalf_of_settings RequestSettingResourceRequestOnBehalfOfSettingsArgs
    Specifies if and for whom a requester may request the resource for.
    risk_settings RequestSettingResourceRiskSettingsArgs
    Risk settings for the resource.
    idProperty String
    The id of the resource in Okta ID format.
    requestOnBehalfOfSettings Property Map
    Specifies if and for whom a requester may request the resource for.
    riskSettings Property Map
    Risk settings for the resource.

    Outputs

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

    Id string
    The provider-assigned unique ID for this managed resource.
    Id string
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.
    id string
    The provider-assigned unique ID for this managed resource.
    id str
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.

    Look up Existing RequestSettingResource Resource

    Get an existing RequestSettingResource 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?: RequestSettingResourceState, opts?: CustomResourceOptions): RequestSettingResource
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            id_property: Optional[str] = None,
            request_on_behalf_of_settings: Optional[RequestSettingResourceRequestOnBehalfOfSettingsArgs] = None,
            risk_settings: Optional[RequestSettingResourceRiskSettingsArgs] = None) -> RequestSettingResource
    func GetRequestSettingResource(ctx *Context, name string, id IDInput, state *RequestSettingResourceState, opts ...ResourceOption) (*RequestSettingResource, error)
    public static RequestSettingResource Get(string name, Input<string> id, RequestSettingResourceState? state, CustomResourceOptions? opts = null)
    public static RequestSettingResource get(String name, Output<String> id, RequestSettingResourceState state, CustomResourceOptions options)
    resources:  _:    type: okta:RequestSettingResource    get:      id: ${id}
    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:
    IdProperty string
    The id of the resource in Okta ID format.
    RequestOnBehalfOfSettings RequestSettingResourceRequestOnBehalfOfSettings
    Specifies if and for whom a requester may request the resource for.
    RiskSettings RequestSettingResourceRiskSettings
    Risk settings for the resource.
    IdProperty string
    The id of the resource in Okta ID format.
    RequestOnBehalfOfSettings RequestSettingResourceRequestOnBehalfOfSettingsArgs
    Specifies if and for whom a requester may request the resource for.
    RiskSettings RequestSettingResourceRiskSettingsArgs
    Risk settings for the resource.
    idProperty String
    The id of the resource in Okta ID format.
    requestOnBehalfOfSettings RequestSettingResourceRequestOnBehalfOfSettings
    Specifies if and for whom a requester may request the resource for.
    riskSettings RequestSettingResourceRiskSettings
    Risk settings for the resource.
    idProperty string
    The id of the resource in Okta ID format.
    requestOnBehalfOfSettings RequestSettingResourceRequestOnBehalfOfSettings
    Specifies if and for whom a requester may request the resource for.
    riskSettings RequestSettingResourceRiskSettings
    Risk settings for the resource.
    id_property str
    The id of the resource in Okta ID format.
    request_on_behalf_of_settings RequestSettingResourceRequestOnBehalfOfSettingsArgs
    Specifies if and for whom a requester may request the resource for.
    risk_settings RequestSettingResourceRiskSettingsArgs
    Risk settings for the resource.
    idProperty String
    The id of the resource in Okta ID format.
    requestOnBehalfOfSettings Property Map
    Specifies if and for whom a requester may request the resource for.
    riskSettings Property Map
    Risk settings for the resource.

    Supporting Types

    RequestSettingResourceRequestOnBehalfOfSettings, RequestSettingResourceRequestOnBehalfOfSettingsArgs

    Allowed bool
    Indicates that users who can request this resource could also request for another requester of the same resource. This property can only be true.
    OnlyFors List<RequestSettingResourceRequestOnBehalfOfSettingsOnlyFor>
    Which requesters the resource requester can request on behalf of. Enum: DIRECT_REPORT.
    Allowed bool
    Indicates that users who can request this resource could also request for another requester of the same resource. This property can only be true.
    OnlyFors []RequestSettingResourceRequestOnBehalfOfSettingsOnlyFor
    Which requesters the resource requester can request on behalf of. Enum: DIRECT_REPORT.
    allowed Boolean
    Indicates that users who can request this resource could also request for another requester of the same resource. This property can only be true.
    onlyFors List<RequestSettingResourceRequestOnBehalfOfSettingsOnlyFor>
    Which requesters the resource requester can request on behalf of. Enum: DIRECT_REPORT.
    allowed boolean
    Indicates that users who can request this resource could also request for another requester of the same resource. This property can only be true.
    onlyFors RequestSettingResourceRequestOnBehalfOfSettingsOnlyFor[]
    Which requesters the resource requester can request on behalf of. Enum: DIRECT_REPORT.
    allowed bool
    Indicates that users who can request this resource could also request for another requester of the same resource. This property can only be true.
    only_fors Sequence[RequestSettingResourceRequestOnBehalfOfSettingsOnlyFor]
    Which requesters the resource requester can request on behalf of. Enum: DIRECT_REPORT.
    allowed Boolean
    Indicates that users who can request this resource could also request for another requester of the same resource. This property can only be true.
    onlyFors List<Property Map>
    Which requesters the resource requester can request on behalf of. Enum: DIRECT_REPORT.

    RequestSettingResourceRequestOnBehalfOfSettingsOnlyFor, RequestSettingResourceRequestOnBehalfOfSettingsOnlyForArgs

    Type string
    Which requesters the resource requester can request on behalf of. If onlyFor is not specified then any requester may request a resource on the behalf of any other user
    Type string
    Which requesters the resource requester can request on behalf of. If onlyFor is not specified then any requester may request a resource on the behalf of any other user
    type String
    Which requesters the resource requester can request on behalf of. If onlyFor is not specified then any requester may request a resource on the behalf of any other user
    type string
    Which requesters the resource requester can request on behalf of. If onlyFor is not specified then any requester may request a resource on the behalf of any other user
    type str
    Which requesters the resource requester can request on behalf of. If onlyFor is not specified then any requester may request a resource on the behalf of any other user
    type String
    Which requesters the resource requester can request on behalf of. If onlyFor is not specified then any requester may request a resource on the behalf of any other user

    RequestSettingResourceRiskSettings, RequestSettingResourceRiskSettingsArgs

    DefaultSetting RequestSettingResourceRiskSettingsDefaultSetting
    Default risk settings that are valid for an access request when a risk has been detected for the resource and requesting user.
    DefaultSetting RequestSettingResourceRiskSettingsDefaultSetting
    Default risk settings that are valid for an access request when a risk has been detected for the resource and requesting user.
    defaultSetting RequestSettingResourceRiskSettingsDefaultSetting
    Default risk settings that are valid for an access request when a risk has been detected for the resource and requesting user.
    defaultSetting RequestSettingResourceRiskSettingsDefaultSetting
    Default risk settings that are valid for an access request when a risk has been detected for the resource and requesting user.
    default_setting RequestSettingResourceRiskSettingsDefaultSetting
    Default risk settings that are valid for an access request when a risk has been detected for the resource and requesting user.
    defaultSetting Property Map
    Default risk settings that are valid for an access request when a risk has been detected for the resource and requesting user.

    RequestSettingResourceRiskSettingsDefaultSetting, RequestSettingResourceRiskSettingsDefaultSettingArgs

    AccessDurationSettings RequestSettingResourceRiskSettingsDefaultSettingAccessDurationSettings
    Settings that control who may specify the access duration allowed by this request condition or risk settings, as well as what duration may be requested.
    ApprovalSequenceId string
    The ID of the approval sequence.
    Errors List<string>
    RequestSubmissionType string
    AccessDurationSettings RequestSettingResourceRiskSettingsDefaultSettingAccessDurationSettings
    Settings that control who may specify the access duration allowed by this request condition or risk settings, as well as what duration may be requested.
    ApprovalSequenceId string
    The ID of the approval sequence.
    Errors []string
    RequestSubmissionType string
    accessDurationSettings RequestSettingResourceRiskSettingsDefaultSettingAccessDurationSettings
    Settings that control who may specify the access duration allowed by this request condition or risk settings, as well as what duration may be requested.
    approvalSequenceId String
    The ID of the approval sequence.
    errors List<String>
    requestSubmissionType String
    accessDurationSettings RequestSettingResourceRiskSettingsDefaultSettingAccessDurationSettings
    Settings that control who may specify the access duration allowed by this request condition or risk settings, as well as what duration may be requested.
    approvalSequenceId string
    The ID of the approval sequence.
    errors string[]
    requestSubmissionType string
    access_duration_settings RequestSettingResourceRiskSettingsDefaultSettingAccessDurationSettings
    Settings that control who may specify the access duration allowed by this request condition or risk settings, as well as what duration may be requested.
    approval_sequence_id str
    The ID of the approval sequence.
    errors Sequence[str]
    request_submission_type str
    accessDurationSettings Property Map
    Settings that control who may specify the access duration allowed by this request condition or risk settings, as well as what duration may be requested.
    approvalSequenceId String
    The ID of the approval sequence.
    errors List<String>
    requestSubmissionType String

    RequestSettingResourceRiskSettingsDefaultSettingAccessDurationSettings, RequestSettingResourceRiskSettingsDefaultSettingAccessDurationSettingsArgs

    Duration string
    The duration set by the admin for access durations. Use ISO8061 notation for duration values.
    Type string
    Enum: ADMIN_FIXED_DURATION, REQUESTER_SPECIFIED_DURATION.
    Duration string
    The duration set by the admin for access durations. Use ISO8061 notation for duration values.
    Type string
    Enum: ADMIN_FIXED_DURATION, REQUESTER_SPECIFIED_DURATION.
    duration String
    The duration set by the admin for access durations. Use ISO8061 notation for duration values.
    type String
    Enum: ADMIN_FIXED_DURATION, REQUESTER_SPECIFIED_DURATION.
    duration string
    The duration set by the admin for access durations. Use ISO8061 notation for duration values.
    type string
    Enum: ADMIN_FIXED_DURATION, REQUESTER_SPECIFIED_DURATION.
    duration str
    The duration set by the admin for access durations. Use ISO8061 notation for duration values.
    type str
    Enum: ADMIN_FIXED_DURATION, REQUESTER_SPECIFIED_DURATION.
    duration String
    The duration set by the admin for access durations. Use ISO8061 notation for duration values.
    type String
    Enum: ADMIN_FIXED_DURATION, REQUESTER_SPECIFIED_DURATION.

    Import

    $ pulumi import okta:index/requestSettingResource:RequestSettingResource example "<resource_id>"
    

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

    Package Details

    Repository
    Okta pulumi/pulumi-okta
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the okta Terraform Provider.
    okta logo
    Okta v6.0.0 published on Friday, Oct 10, 2025 by Pulumi
      Meet Neo: Your AI Platform Teammate