published on Tuesday, Aug 25, 2026 by Pulumi
published on Tuesday, Aug 25, 2026 by Pulumi
Import
This resource does not currently support
pulumi import.
Create AiSearchNamespace Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new AiSearchNamespace(name: string, args: AiSearchNamespaceArgs, opts?: CustomResourceOptions);@overload
def AiSearchNamespace(resource_name: str,
args: AiSearchNamespaceArgs,
opts: Optional[ResourceOptions] = None)
@overload
def AiSearchNamespace(resource_name: str,
opts: Optional[ResourceOptions] = None,
account_id: Optional[str] = None,
name: Optional[str] = None,
description: Optional[str] = None,
public_endpoint_params: Optional[AiSearchNamespacePublicEndpointParamsArgs] = None)func NewAiSearchNamespace(ctx *Context, name string, args AiSearchNamespaceArgs, opts ...ResourceOption) (*AiSearchNamespace, error)public AiSearchNamespace(string name, AiSearchNamespaceArgs args, CustomResourceOptions? opts = null)
public AiSearchNamespace(String name, AiSearchNamespaceArgs args)
public AiSearchNamespace(String name, AiSearchNamespaceArgs args, CustomResourceOptions options)
type: cloudflare:AiSearchNamespace
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
resource "cloudflare_ai_search_namespace" "name" {
# resource properties
}Parameters
- name string
- The unique name of the resource.
- args AiSearchNamespaceArgs
- 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 AiSearchNamespaceArgs
- 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 AiSearchNamespaceArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args AiSearchNamespaceArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args AiSearchNamespaceArgs
- 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 aiSearchNamespaceResource = new Cloudflare.AiSearchNamespace("aiSearchNamespaceResource", new()
{
AccountId = "string",
Name = "string",
Description = "string",
PublicEndpointParams = new Cloudflare.Inputs.AiSearchNamespacePublicEndpointParamsArgs
{
AuthorizedHosts = new[]
{
"string",
},
ChatCompletionsEndpoint = new Cloudflare.Inputs.AiSearchNamespacePublicEndpointParamsChatCompletionsEndpointArgs
{
Disabled = false,
},
CustomDomains = new[]
{
"string",
},
DefaultDomainEnabled = false,
Enabled = false,
InstancesAlloweds = new[]
{
"string",
},
Mcp = new Cloudflare.Inputs.AiSearchNamespacePublicEndpointParamsMcpArgs
{
Description = "string",
Disabled = false,
},
RateLimit = new Cloudflare.Inputs.AiSearchNamespacePublicEndpointParamsRateLimitArgs
{
PeriodMs = 0,
Requests = 0,
Technique = "string",
},
SearchEndpoint = new Cloudflare.Inputs.AiSearchNamespacePublicEndpointParamsSearchEndpointArgs
{
Disabled = false,
},
},
});
example, err := cloudflare.NewAiSearchNamespace(ctx, "aiSearchNamespaceResource", &cloudflare.AiSearchNamespaceArgs{
AccountId: pulumi.String("string"),
Name: pulumi.String("string"),
Description: pulumi.String("string"),
PublicEndpointParams: &cloudflare.AiSearchNamespacePublicEndpointParamsArgs{
AuthorizedHosts: pulumi.StringArray{
pulumi.String("string"),
},
ChatCompletionsEndpoint: &cloudflare.AiSearchNamespacePublicEndpointParamsChatCompletionsEndpointArgs{
Disabled: pulumi.Bool(false),
},
CustomDomains: pulumi.StringArray{
pulumi.String("string"),
},
DefaultDomainEnabled: pulumi.Bool(false),
Enabled: pulumi.Bool(false),
InstancesAlloweds: pulumi.StringArray{
pulumi.String("string"),
},
Mcp: &cloudflare.AiSearchNamespacePublicEndpointParamsMcpArgs{
Description: pulumi.String("string"),
Disabled: pulumi.Bool(false),
},
RateLimit: &cloudflare.AiSearchNamespacePublicEndpointParamsRateLimitArgs{
PeriodMs: pulumi.Int(0),
Requests: pulumi.Int(0),
Technique: pulumi.String("string"),
},
SearchEndpoint: &cloudflare.AiSearchNamespacePublicEndpointParamsSearchEndpointArgs{
Disabled: pulumi.Bool(false),
},
},
})
resource "cloudflare_ai_search_namespace" "aiSearchNamespaceResource" {
lifecycle {
create_before_destroy = true
}
account_id = "string"
name = "string"
description = "string"
public_endpoint_params = {
authorized_hosts = ["string"]
chat_completions_endpoint = {
disabled = false
}
custom_domains = ["string"]
default_domain_enabled = false
enabled = false
instances_alloweds = ["string"]
mcp = {
description = "string"
disabled = false
}
rate_limit = {
period_ms = 0
requests = 0
technique = "string"
}
search_endpoint = {
disabled = false
}
}
}
var aiSearchNamespaceResource = new AiSearchNamespace("aiSearchNamespaceResource", AiSearchNamespaceArgs.builder()
.accountId("string")
.name("string")
.description("string")
.publicEndpointParams(AiSearchNamespacePublicEndpointParamsArgs.builder()
.authorizedHosts("string")
.chatCompletionsEndpoint(AiSearchNamespacePublicEndpointParamsChatCompletionsEndpointArgs.builder()
.disabled(false)
.build())
.customDomains("string")
.defaultDomainEnabled(false)
.enabled(false)
.instancesAlloweds("string")
.mcp(AiSearchNamespacePublicEndpointParamsMcpArgs.builder()
.description("string")
.disabled(false)
.build())
.rateLimit(AiSearchNamespacePublicEndpointParamsRateLimitArgs.builder()
.periodMs(0)
.requests(0)
.technique("string")
.build())
.searchEndpoint(AiSearchNamespacePublicEndpointParamsSearchEndpointArgs.builder()
.disabled(false)
.build())
.build())
.build());
ai_search_namespace_resource = cloudflare.AiSearchNamespace("aiSearchNamespaceResource",
account_id="string",
name="string",
description="string",
public_endpoint_params={
"authorized_hosts": ["string"],
"chat_completions_endpoint": {
"disabled": False,
},
"custom_domains": ["string"],
"default_domain_enabled": False,
"enabled": False,
"instances_alloweds": ["string"],
"mcp": {
"description": "string",
"disabled": False,
},
"rate_limit": {
"period_ms": 0,
"requests": 0,
"technique": "string",
},
"search_endpoint": {
"disabled": False,
},
})
const aiSearchNamespaceResource = new cloudflare.AiSearchNamespace("aiSearchNamespaceResource", {
accountId: "string",
name: "string",
description: "string",
publicEndpointParams: {
authorizedHosts: ["string"],
chatCompletionsEndpoint: {
disabled: false,
},
customDomains: ["string"],
defaultDomainEnabled: false,
enabled: false,
instancesAlloweds: ["string"],
mcp: {
description: "string",
disabled: false,
},
rateLimit: {
periodMs: 0,
requests: 0,
technique: "string",
},
searchEndpoint: {
disabled: false,
},
},
});
type: cloudflare:AiSearchNamespace
properties:
accountId: string
description: string
name: string
publicEndpointParams:
authorizedHosts:
- string
chatCompletionsEndpoint:
disabled: false
customDomains:
- string
defaultDomainEnabled: false
enabled: false
instancesAlloweds:
- string
mcp:
description: string
disabled: false
rateLimit:
periodMs: 0
requests: 0
technique: string
searchEndpoint:
disabled: false
AiSearchNamespace 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 AiSearchNamespace resource accepts the following input properties:
- Account
Id string - Name string
- Description string
- Optional description for the namespace. Max 256 characters.
- Public
Endpoint AiParams Search Namespace Public Endpoint Params
- Account
Id string - Name string
- Description string
- Optional description for the namespace. Max 256 characters.
- Public
Endpoint AiParams Search Namespace Public Endpoint Params Args
- account_
id string - name string
- description string
- Optional description for the namespace. Max 256 characters.
- public_
endpoint_ objectparams
- account
Id String - name String
- description String
- Optional description for the namespace. Max 256 characters.
- public
Endpoint AiParams Search Namespace Public Endpoint Params
- account
Id string - name string
- description string
- Optional description for the namespace. Max 256 characters.
- public
Endpoint AiParams Search Namespace Public Endpoint Params
- account_
id str - name str
- description str
- Optional description for the namespace. Max 256 characters.
- public_
endpoint_ Aiparams Search Namespace Public Endpoint Params Args
- account
Id String - name String
- description String
- Optional description for the namespace. Max 256 characters.
- public
Endpoint Property MapParams
Outputs
All input properties are implicitly available as output properties. Additionally, the AiSearchNamespace resource produces the following output properties:
- Created
At string - Id string
- The provider-assigned unique ID for this managed resource.
- Public
Endpoint stringId
- Created
At string - Id string
- The provider-assigned unique ID for this managed resource.
- Public
Endpoint stringId
- created_
at string - id string
- The provider-assigned unique ID for this managed resource.
- public_
endpoint_ stringid
- created
At String - id String
- The provider-assigned unique ID for this managed resource.
- public
Endpoint StringId
- created
At string - id string
- The provider-assigned unique ID for this managed resource.
- public
Endpoint stringId
- created_
at str - id str
- The provider-assigned unique ID for this managed resource.
- public_
endpoint_ strid
- created
At String - id String
- The provider-assigned unique ID for this managed resource.
- public
Endpoint StringId
Look up Existing AiSearchNamespace Resource
Get an existing AiSearchNamespace 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?: AiSearchNamespaceState, opts?: CustomResourceOptions): AiSearchNamespace@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
account_id: Optional[str] = None,
created_at: Optional[str] = None,
description: Optional[str] = None,
name: Optional[str] = None,
public_endpoint_id: Optional[str] = None,
public_endpoint_params: Optional[AiSearchNamespacePublicEndpointParamsArgs] = None) -> AiSearchNamespacefunc GetAiSearchNamespace(ctx *Context, name string, id IDInput, state *AiSearchNamespaceState, opts ...ResourceOption) (*AiSearchNamespace, error)public static AiSearchNamespace Get(string name, Input<string> id, AiSearchNamespaceState? state, CustomResourceOptions? opts = null)public static AiSearchNamespace get(String name, Output<String> id, AiSearchNamespaceState state, CustomResourceOptions options)resources: _: type: cloudflare:AiSearchNamespace get: id: ${id}import {
to = cloudflare_ai_search_namespace.example
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.
- Account
Id string - Created
At string - Description string
- Optional description for the namespace. Max 256 characters.
- Name string
- Public
Endpoint stringId - Public
Endpoint AiParams Search Namespace Public Endpoint Params
- Account
Id string - Created
At string - Description string
- Optional description for the namespace. Max 256 characters.
- Name string
- Public
Endpoint stringId - Public
Endpoint AiParams Search Namespace Public Endpoint Params Args
- account_
id string - created_
at string - description string
- Optional description for the namespace. Max 256 characters.
- name string
- public_
endpoint_ stringid - public_
endpoint_ objectparams
- account
Id String - created
At String - description String
- Optional description for the namespace. Max 256 characters.
- name String
- public
Endpoint StringId - public
Endpoint AiParams Search Namespace Public Endpoint Params
- account
Id string - created
At string - description string
- Optional description for the namespace. Max 256 characters.
- name string
- public
Endpoint stringId - public
Endpoint AiParams Search Namespace Public Endpoint Params
- account_
id str - created_
at str - description str
- Optional description for the namespace. Max 256 characters.
- name str
- public_
endpoint_ strid - public_
endpoint_ Aiparams Search Namespace Public Endpoint Params Args
- account
Id String - created
At String - description String
- Optional description for the namespace. Max 256 characters.
- name String
- public
Endpoint StringId - public
Endpoint Property MapParams
Supporting Types
AiSearchNamespacePublicEndpointParams, AiSearchNamespacePublicEndpointParamsArgs
- List<string>
- Chat
Completions AiEndpoint Search Namespace Public Endpoint Params Chat Completions Endpoint - Custom
Domains List<string> - Custom domain hostnames that alias this public endpoint. GET and create responses return the current set; on update (PUT) this field is only echoed back when supplied in the request body, otherwise it is null (omit it to leave domains unchanged).
- Default
Domain boolEnabled - When false, the instance is reachable only via a registered custom domain and the default \n\n.search.ai.cloudflare.com host returns 404. Requires at least one custom domain. Defaults to true. publicendpointparams is replaced wholesale on update, so resend defaultdomainenabled on every update to keep the default host off — omitting it resets to true.
- Enabled bool
- Instances
Alloweds List<string> - Instance IDs exposed through the namespace public endpoint. Empty means nothing is searchable. Every ID must be an existing instance in this namespace, and the list cannot exceed the account's multi-instance search limit.
- Mcp
Ai
Search Namespace Public Endpoint Params Mcp - Rate
Limit AiSearch Namespace Public Endpoint Params Rate Limit - Search
Endpoint AiSearch Namespace Public Endpoint Params Search Endpoint
- []string
- Chat
Completions AiEndpoint Search Namespace Public Endpoint Params Chat Completions Endpoint - Custom
Domains []string - Custom domain hostnames that alias this public endpoint. GET and create responses return the current set; on update (PUT) this field is only echoed back when supplied in the request body, otherwise it is null (omit it to leave domains unchanged).
- Default
Domain boolEnabled - When false, the instance is reachable only via a registered custom domain and the default \n\n.search.ai.cloudflare.com host returns 404. Requires at least one custom domain. Defaults to true. publicendpointparams is replaced wholesale on update, so resend defaultdomainenabled on every update to keep the default host off — omitting it resets to true.
- Enabled bool
- Instances
Alloweds []string - Instance IDs exposed through the namespace public endpoint. Empty means nothing is searchable. Every ID must be an existing instance in this namespace, and the list cannot exceed the account's multi-instance search limit.
- Mcp
Ai
Search Namespace Public Endpoint Params Mcp - Rate
Limit AiSearch Namespace Public Endpoint Params Rate Limit - Search
Endpoint AiSearch Namespace Public Endpoint Params Search Endpoint
- list(string)
- chat_
completions_ objectendpoint - custom_
domains list(string) - Custom domain hostnames that alias this public endpoint. GET and create responses return the current set; on update (PUT) this field is only echoed back when supplied in the request body, otherwise it is null (omit it to leave domains unchanged).
- default_
domain_ boolenabled - When false, the instance is reachable only via a registered custom domain and the default \n\n.search.ai.cloudflare.com host returns 404. Requires at least one custom domain. Defaults to true. publicendpointparams is replaced wholesale on update, so resend defaultdomainenabled on every update to keep the default host off — omitting it resets to true.
- enabled bool
- instances_
alloweds list(string) - Instance IDs exposed through the namespace public endpoint. Empty means nothing is searchable. Every ID must be an existing instance in this namespace, and the list cannot exceed the account's multi-instance search limit.
- mcp object
- rate_
limit object - search_
endpoint object
- List<String>
- chat
Completions AiEndpoint Search Namespace Public Endpoint Params Chat Completions Endpoint - custom
Domains List<String> - Custom domain hostnames that alias this public endpoint. GET and create responses return the current set; on update (PUT) this field is only echoed back when supplied in the request body, otherwise it is null (omit it to leave domains unchanged).
- default
Domain BooleanEnabled - When false, the instance is reachable only via a registered custom domain and the default \n\n.search.ai.cloudflare.com host returns 404. Requires at least one custom domain. Defaults to true. publicendpointparams is replaced wholesale on update, so resend defaultdomainenabled on every update to keep the default host off — omitting it resets to true.
- enabled Boolean
- instances
Alloweds List<String> - Instance IDs exposed through the namespace public endpoint. Empty means nothing is searchable. Every ID must be an existing instance in this namespace, and the list cannot exceed the account's multi-instance search limit.
- mcp
Ai
Search Namespace Public Endpoint Params Mcp - rate
Limit AiSearch Namespace Public Endpoint Params Rate Limit - search
Endpoint AiSearch Namespace Public Endpoint Params Search Endpoint
- string[]
- chat
Completions AiEndpoint Search Namespace Public Endpoint Params Chat Completions Endpoint - custom
Domains string[] - Custom domain hostnames that alias this public endpoint. GET and create responses return the current set; on update (PUT) this field is only echoed back when supplied in the request body, otherwise it is null (omit it to leave domains unchanged).
- default
Domain booleanEnabled - When false, the instance is reachable only via a registered custom domain and the default \n\n.search.ai.cloudflare.com host returns 404. Requires at least one custom domain. Defaults to true. publicendpointparams is replaced wholesale on update, so resend defaultdomainenabled on every update to keep the default host off — omitting it resets to true.
- enabled boolean
- instances
Alloweds string[] - Instance IDs exposed through the namespace public endpoint. Empty means nothing is searchable. Every ID must be an existing instance in this namespace, and the list cannot exceed the account's multi-instance search limit.
- mcp
Ai
Search Namespace Public Endpoint Params Mcp - rate
Limit AiSearch Namespace Public Endpoint Params Rate Limit - search
Endpoint AiSearch Namespace Public Endpoint Params Search Endpoint
- Sequence[str]
- chat_
completions_ Aiendpoint Search Namespace Public Endpoint Params Chat Completions Endpoint - custom_
domains Sequence[str] - Custom domain hostnames that alias this public endpoint. GET and create responses return the current set; on update (PUT) this field is only echoed back when supplied in the request body, otherwise it is null (omit it to leave domains unchanged).
- default_
domain_ boolenabled - When false, the instance is reachable only via a registered custom domain and the default \n\n.search.ai.cloudflare.com host returns 404. Requires at least one custom domain. Defaults to true. publicendpointparams is replaced wholesale on update, so resend defaultdomainenabled on every update to keep the default host off — omitting it resets to true.
- enabled bool
- instances_
alloweds Sequence[str] - Instance IDs exposed through the namespace public endpoint. Empty means nothing is searchable. Every ID must be an existing instance in this namespace, and the list cannot exceed the account's multi-instance search limit.
- mcp
Ai
Search Namespace Public Endpoint Params Mcp - rate_
limit AiSearch Namespace Public Endpoint Params Rate Limit - search_
endpoint AiSearch Namespace Public Endpoint Params Search Endpoint
- List<String>
- chat
Completions Property MapEndpoint - custom
Domains List<String> - Custom domain hostnames that alias this public endpoint. GET and create responses return the current set; on update (PUT) this field is only echoed back when supplied in the request body, otherwise it is null (omit it to leave domains unchanged).
- default
Domain BooleanEnabled - When false, the instance is reachable only via a registered custom domain and the default \n\n.search.ai.cloudflare.com host returns 404. Requires at least one custom domain. Defaults to true. publicendpointparams is replaced wholesale on update, so resend defaultdomainenabled on every update to keep the default host off — omitting it resets to true.
- enabled Boolean
- instances
Alloweds List<String> - Instance IDs exposed through the namespace public endpoint. Empty means nothing is searchable. Every ID must be an existing instance in this namespace, and the list cannot exceed the account's multi-instance search limit.
- mcp Property Map
- rate
Limit Property Map - search
Endpoint Property Map
AiSearchNamespacePublicEndpointParamsChatCompletionsEndpoint, AiSearchNamespacePublicEndpointParamsChatCompletionsEndpointArgs
- Disabled bool
- Disable chat completions endpoint for this public endpoint
- Disabled bool
- Disable chat completions endpoint for this public endpoint
- disabled bool
- Disable chat completions endpoint for this public endpoint
- disabled Boolean
- Disable chat completions endpoint for this public endpoint
- disabled boolean
- Disable chat completions endpoint for this public endpoint
- disabled bool
- Disable chat completions endpoint for this public endpoint
- disabled Boolean
- Disable chat completions endpoint for this public endpoint
AiSearchNamespacePublicEndpointParamsMcp, AiSearchNamespacePublicEndpointParamsMcpArgs
- Description string
- Disabled bool
- Disable MCP endpoint for this public endpoint
- Description string
- Disabled bool
- Disable MCP endpoint for this public endpoint
- description string
- disabled bool
- Disable MCP endpoint for this public endpoint
- description String
- disabled Boolean
- Disable MCP endpoint for this public endpoint
- description string
- disabled boolean
- Disable MCP endpoint for this public endpoint
- description str
- disabled bool
- Disable MCP endpoint for this public endpoint
- description String
- disabled Boolean
- Disable MCP endpoint for this public endpoint
AiSearchNamespacePublicEndpointParamsRateLimit, AiSearchNamespacePublicEndpointParamsRateLimitArgs
AiSearchNamespacePublicEndpointParamsSearchEndpoint, AiSearchNamespacePublicEndpointParamsSearchEndpointArgs
- Disabled bool
- Disable search endpoint for this public endpoint
- Disabled bool
- Disable search endpoint for this public endpoint
- disabled bool
- Disable search endpoint for this public endpoint
- disabled Boolean
- Disable search endpoint for this public endpoint
- disabled boolean
- Disable search endpoint for this public endpoint
- disabled bool
- Disable search endpoint for this public endpoint
- disabled Boolean
- Disable search endpoint for this public endpoint
Package Details
- Repository
- Cloudflare pulumi/pulumi-cloudflare
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
cloudflareTerraform Provider.
published on Tuesday, Aug 25, 2026 by Pulumi