published on Thursday, Jun 11, 2026 by Volcengine
published on Thursday, Jun 11, 2026 by Volcengine
ID Permission Gateway Service is used to define backend service access configuration, permission space binding, and optional route rules for unified management of service access by the agent identity and permission management platform
Example Usage
Example coming soon!
Example coming soon!
Example coming soon!
Example coming soon!
Example coming soon!
resources:
iDServiceDemo:
type: volcenginecc:id:Service
name: IDServiceDemo
properties:
permissionSpaceId: fd46c764-e94e-4c94-ba69-6bfxxxxxxxx
backend:
timeout_seconds: 60
enable_tls: false
backend_port: 80
backend_domain: api.internal.com
protocol: HTTP
description: 测试枚举分支覆盖
serviceName: test-other-service
routes:
- path: /api/v1/orders
priority: 20
api_spec:
extractors:
- path: /orderId
isAuth: false
resourceType: Order
source: 2
actionType: write
actionValue: query
responseFilters:
- mode: 2
isAuth: false
resourceType: Order
identifierValue: /order/id
identifierType: 2
route_name: order-query
resource_type: Collection
method: GET
auth_resource_type: Order
path_match_type: Prefix
tags:
- value: env
key: test
Example coming soon!
Create Service Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new Service(name: string, args: ServiceArgs, opts?: CustomResourceOptions);@overload
def Service(resource_name: str,
args: ServiceArgs,
opts: Optional[ResourceOptions] = None)
@overload
def Service(resource_name: str,
opts: Optional[ResourceOptions] = None,
backend: Optional[ServiceBackendArgs] = None,
permission_space_id: Optional[str] = None,
service_name: Optional[str] = None,
description: Optional[str] = None,
permission_space_name: Optional[str] = None,
project_name: Optional[str] = None,
routes: Optional[Sequence[ServiceRouteArgs]] = None,
status: Optional[str] = None,
tags: Optional[Sequence[ServiceTagArgs]] = None)func NewService(ctx *Context, name string, args ServiceArgs, opts ...ResourceOption) (*Service, error)public Service(string name, ServiceArgs args, CustomResourceOptions? opts = null)
public Service(String name, ServiceArgs args)
public Service(String name, ServiceArgs args, CustomResourceOptions options)
type: volcenginecc:id:Service
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
resource "volcenginecc_id_service" "name" {
# resource properties
}Parameters
- name string
- The unique name of the resource.
- args ServiceArgs
- 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 ServiceArgs
- 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 ServiceArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args ServiceArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args ServiceArgs
- 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 serviceResource = new Volcenginecc.Id.Service("serviceResource", new()
{
Backend = new Volcenginecc.Id.Inputs.ServiceBackendArgs
{
BackendDomain = "string",
EnableTls = false,
BackendPort = 0,
Protocol = "string",
TimeoutSeconds = 0,
},
PermissionSpaceId = "string",
ServiceName = "string",
Description = "string",
PermissionSpaceName = "string",
ProjectName = "string",
Routes = new[]
{
new Volcenginecc.Id.Inputs.ServiceRouteArgs
{
ApiSpec = new Volcenginecc.Id.Inputs.ServiceRouteApiSpecArgs
{
ActionType = "string",
ActionValue = "string",
Extractors = new[]
{
new Volcenginecc.Id.Inputs.ServiceRouteApiSpecExtractorArgs
{
IsAuth = false,
Path = "string",
ResourceType = "string",
Source = 0,
},
},
IdentifierType = 0,
IdentifierValue = "string",
ResponseFilters = new[]
{
new Volcenginecc.Id.Inputs.ServiceRouteApiSpecResponseFilterArgs
{
Attributes = new[]
{
new Volcenginecc.Id.Inputs.ServiceRouteApiSpecResponseFilterAttributeArgs
{
Field = "string",
Target = "string",
},
},
FilterPath = "string",
IdField = "string",
IsAuth = false,
Mode = 0,
ResourcePath = "string",
ResourceType = "string",
},
},
},
AuthResourceType = "string",
Description = "string",
Method = "string",
Path = "string",
PathMatchType = "string",
PermissionPool = "string",
Priority = 0,
ResourceType = "string",
RouteName = "string",
},
},
Status = "string",
Tags = new[]
{
new Volcenginecc.Id.Inputs.ServiceTagArgs
{
Key = "string",
Value = "string",
},
},
});
example, err := id.NewService(ctx, "serviceResource", &id.ServiceArgs{
Backend: &id.ServiceBackendArgs{
BackendDomain: pulumi.String("string"),
EnableTls: pulumi.Bool(false),
BackendPort: pulumi.Int(0),
Protocol: pulumi.String("string"),
TimeoutSeconds: pulumi.Int(0),
},
PermissionSpaceId: pulumi.String("string"),
ServiceName: pulumi.String("string"),
Description: pulumi.String("string"),
PermissionSpaceName: pulumi.String("string"),
ProjectName: pulumi.String("string"),
Routes: id.ServiceRouteArray{
&id.ServiceRouteArgs{
ApiSpec: &id.ServiceRouteApiSpecArgs{
ActionType: pulumi.String("string"),
ActionValue: pulumi.String("string"),
Extractors: id.ServiceRouteApiSpecExtractorArray{
&id.ServiceRouteApiSpecExtractorArgs{
IsAuth: pulumi.Bool(false),
Path: pulumi.String("string"),
ResourceType: pulumi.String("string"),
Source: pulumi.Int(0),
},
},
IdentifierType: pulumi.Int(0),
IdentifierValue: pulumi.String("string"),
ResponseFilters: id.ServiceRouteApiSpecResponseFilterArray{
&id.ServiceRouteApiSpecResponseFilterArgs{
Attributes: id.ServiceRouteApiSpecResponseFilterAttributeArray{
&id.ServiceRouteApiSpecResponseFilterAttributeArgs{
Field: pulumi.String("string"),
Target: pulumi.String("string"),
},
},
FilterPath: pulumi.String("string"),
IdField: pulumi.String("string"),
IsAuth: pulumi.Bool(false),
Mode: pulumi.Int(0),
ResourcePath: pulumi.String("string"),
ResourceType: pulumi.String("string"),
},
},
},
AuthResourceType: pulumi.String("string"),
Description: pulumi.String("string"),
Method: pulumi.String("string"),
Path: pulumi.String("string"),
PathMatchType: pulumi.String("string"),
PermissionPool: pulumi.String("string"),
Priority: pulumi.Int(0),
ResourceType: pulumi.String("string"),
RouteName: pulumi.String("string"),
},
},
Status: pulumi.String("string"),
Tags: id.ServiceTagArray{
&id.ServiceTagArgs{
Key: pulumi.String("string"),
Value: pulumi.String("string"),
},
},
})
resource "volcenginecc_id_service" "serviceResource" {
backend = {
backend_domain = "string"
enable_tls = false
backend_port = 0
protocol = "string"
timeout_seconds = 0
}
permission_space_id = "string"
service_name = "string"
description = "string"
permission_space_name = "string"
project_name = "string"
routes {
api_spec = {
action_type = "string"
action_value = "string"
extractors = [{
"isAuth" = false
"path" = "string"
"resourceType" = "string"
"source" = 0
}]
identifier_type = 0
identifier_value = "string"
response_filters = [{
"attributes" = [{
"field" = "string"
"target" = "string"
}]
"filterPath" = "string"
"idField" = "string"
"isAuth" = false
"mode" = 0
"resourcePath" = "string"
"resourceType" = "string"
}]
}
auth_resource_type = "string"
description = "string"
method = "string"
path = "string"
path_match_type = "string"
permission_pool = "string"
priority = 0
resource_type = "string"
route_name = "string"
}
status = "string"
tags {
key = "string"
value = "string"
}
}
var serviceResource = new Service("serviceResource", ServiceArgs.builder()
.backend(ServiceBackendArgs.builder()
.backendDomain("string")
.enableTls(false)
.backendPort(0)
.protocol("string")
.timeoutSeconds(0)
.build())
.permissionSpaceId("string")
.serviceName("string")
.description("string")
.permissionSpaceName("string")
.projectName("string")
.routes(ServiceRouteArgs.builder()
.apiSpec(ServiceRouteApiSpecArgs.builder()
.actionType("string")
.actionValue("string")
.extractors(ServiceRouteApiSpecExtractorArgs.builder()
.isAuth(false)
.path("string")
.resourceType("string")
.source(0)
.build())
.identifierType(0)
.identifierValue("string")
.responseFilters(ServiceRouteApiSpecResponseFilterArgs.builder()
.attributes(ServiceRouteApiSpecResponseFilterAttributeArgs.builder()
.field("string")
.target("string")
.build())
.filterPath("string")
.idField("string")
.isAuth(false)
.mode(0)
.resourcePath("string")
.resourceType("string")
.build())
.build())
.authResourceType("string")
.description("string")
.method("string")
.path("string")
.pathMatchType("string")
.permissionPool("string")
.priority(0)
.resourceType("string")
.routeName("string")
.build())
.status("string")
.tags(ServiceTagArgs.builder()
.key("string")
.value("string")
.build())
.build());
service_resource = volcenginecc.id.Service("serviceResource",
backend={
"backend_domain": "string",
"enable_tls": False,
"backend_port": 0,
"protocol": "string",
"timeout_seconds": 0,
},
permission_space_id="string",
service_name="string",
description="string",
permission_space_name="string",
project_name="string",
routes=[{
"api_spec": {
"action_type": "string",
"action_value": "string",
"extractors": [{
"is_auth": False,
"path": "string",
"resource_type": "string",
"source": 0,
}],
"identifier_type": 0,
"identifier_value": "string",
"response_filters": [{
"attributes": [{
"field": "string",
"target": "string",
}],
"filter_path": "string",
"id_field": "string",
"is_auth": False,
"mode": 0,
"resource_path": "string",
"resource_type": "string",
}],
},
"auth_resource_type": "string",
"description": "string",
"method": "string",
"path": "string",
"path_match_type": "string",
"permission_pool": "string",
"priority": 0,
"resource_type": "string",
"route_name": "string",
}],
status="string",
tags=[{
"key": "string",
"value": "string",
}])
const serviceResource = new volcenginecc.id.Service("serviceResource", {
backend: {
backendDomain: "string",
enableTls: false,
backendPort: 0,
protocol: "string",
timeoutSeconds: 0,
},
permissionSpaceId: "string",
serviceName: "string",
description: "string",
permissionSpaceName: "string",
projectName: "string",
routes: [{
apiSpec: {
actionType: "string",
actionValue: "string",
extractors: [{
isAuth: false,
path: "string",
resourceType: "string",
source: 0,
}],
identifierType: 0,
identifierValue: "string",
responseFilters: [{
attributes: [{
field: "string",
target: "string",
}],
filterPath: "string",
idField: "string",
isAuth: false,
mode: 0,
resourcePath: "string",
resourceType: "string",
}],
},
authResourceType: "string",
description: "string",
method: "string",
path: "string",
pathMatchType: "string",
permissionPool: "string",
priority: 0,
resourceType: "string",
routeName: "string",
}],
status: "string",
tags: [{
key: "string",
value: "string",
}],
});
type: volcenginecc:id:Service
properties:
backend:
backendDomain: string
backendPort: 0
enableTls: false
protocol: string
timeoutSeconds: 0
description: string
permissionSpaceId: string
permissionSpaceName: string
projectName: string
routes:
- apiSpec:
actionType: string
actionValue: string
extractors:
- isAuth: false
path: string
resourceType: string
source: 0
identifierType: 0
identifierValue: string
responseFilters:
- attributes:
- field: string
target: string
filterPath: string
idField: string
isAuth: false
mode: 0
resourcePath: string
resourceType: string
authResourceType: string
description: string
method: string
path: string
pathMatchType: string
permissionPool: string
priority: 0
resourceType: string
routeName: string
serviceName: string
status: string
tags:
- key: string
value: string
Service 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 Service resource accepts the following input properties:
- Backend
Volcengine.
Service Backend - Backend service configuration
- Permission
Space stringId - Permission space ID, for example ps_123456
- Service
Name string - Service name, 1–64 characters, unique within the account
- Description string
- Service description, up to 256 characters
- Permission
Space stringName - Permission space name
- Project
Name string - Project name. Optional at creation, default value is "default"
- Routes
List<Volcengine.
Service Route> - Status string
- Service status. inactive: not enabled. active: enabled (configuration synced to APIGateway). draft: draft status (changes not synced to APIGateway)
-
List<Volcengine.
Service Tag>
- Backend
Service
Backend Args - Backend service configuration
- Permission
Space stringId - Permission space ID, for example ps_123456
- Service
Name string - Service name, 1–64 characters, unique within the account
- Description string
- Service description, up to 256 characters
- Permission
Space stringName - Permission space name
- Project
Name string - Project name. Optional at creation, default value is "default"
- Routes
[]Service
Route Args - Status string
- Service status. inactive: not enabled. active: enabled (configuration synced to APIGateway). draft: draft status (changes not synced to APIGateway)
-
[]Service
Tag Args
- backend object
- Backend service configuration
- permission_
space_ stringid - Permission space ID, for example ps_123456
- service_
name string - Service name, 1–64 characters, unique within the account
- description string
- Service description, up to 256 characters
- permission_
space_ stringname - Permission space name
- project_
name string - Project name. Optional at creation, default value is "default"
- routes list(object)
- status string
- Service status. inactive: not enabled. active: enabled (configuration synced to APIGateway). draft: draft status (changes not synced to APIGateway)
- list(object)
- backend
Service
Backend - Backend service configuration
- permission
Space StringId - Permission space ID, for example ps_123456
- service
Name String - Service name, 1–64 characters, unique within the account
- description String
- Service description, up to 256 characters
- permission
Space StringName - Permission space name
- project
Name String - Project name. Optional at creation, default value is "default"
- routes
List<Service
Route> - status String
- Service status. inactive: not enabled. active: enabled (configuration synced to APIGateway). draft: draft status (changes not synced to APIGateway)
-
List<Service
Tag>
- backend
Service
Backend - Backend service configuration
- permission
Space stringId - Permission space ID, for example ps_123456
- service
Name string - Service name, 1–64 characters, unique within the account
- description string
- Service description, up to 256 characters
- permission
Space stringName - Permission space name
- project
Name string - Project name. Optional at creation, default value is "default"
- routes
Service
Route[] - status string
- Service status. inactive: not enabled. active: enabled (configuration synced to APIGateway). draft: draft status (changes not synced to APIGateway)
-
Service
Tag[]
- backend
Service
Backend Args - Backend service configuration
- permission_
space_ strid - Permission space ID, for example ps_123456
- service_
name str - Service name, 1–64 characters, unique within the account
- description str
- Service description, up to 256 characters
- permission_
space_ strname - Permission space name
- project_
name str - Project name. Optional at creation, default value is "default"
- routes
Sequence[Service
Route Args] - status str
- Service status. inactive: not enabled. active: enabled (configuration synced to APIGateway). draft: draft status (changes not synced to APIGateway)
-
Sequence[Service
Tag Args]
- backend Property Map
- Backend service configuration
- permission
Space StringId - Permission space ID, for example ps_123456
- service
Name String - Service name, 1–64 characters, unique within the account
- description String
- Service description, up to 256 characters
- permission
Space StringName - Permission space name
- project
Name String - Project name. Optional at creation, default value is "default"
- routes List<Property Map>
- status String
- Service status. inactive: not enabled. active: enabled (configuration synced to APIGateway). draft: draft status (changes not synced to APIGateway)
- List<Property Map>
Outputs
All input properties are implicitly available as output properties. Additionally, the Service resource produces the following output properties:
- Backend
Type string - Backend service type, for example custom, viking, agentkit-mcp
- Created
At int - Creation time, Unix timestamp in milliseconds
- Hijack
Domain stringPrivate - Private domain name
- Hijack
Domain stringPublic - Public domain name
- Id string
- The provider-assigned unique ID for this managed resource.
- Route
Count int - Number of routes
- Service
Id string - Service ID. Generated after system creation, for example svc-1234567890
- Template
Id string - Template ID associated with built-in service
- Trn string
- Resource TRN
- Updated
At int - Update time, Unix timestamp in milliseconds
- Backend
Type string - Backend service type, for example custom, viking, agentkit-mcp
- Created
At int - Creation time, Unix timestamp in milliseconds
- Hijack
Domain stringPrivate - Private domain name
- Hijack
Domain stringPublic - Public domain name
- Id string
- The provider-assigned unique ID for this managed resource.
- Route
Count int - Number of routes
- Service
Id string - Service ID. Generated after system creation, for example svc-1234567890
- Template
Id string - Template ID associated with built-in service
- Trn string
- Resource TRN
- Updated
At int - Update time, Unix timestamp in milliseconds
- backend_
type string - Backend service type, for example custom, viking, agentkit-mcp
- created_
at number - Creation time, Unix timestamp in milliseconds
- hijack_
domain_ stringprivate - Private domain name
- hijack_
domain_ stringpublic - Public domain name
- id string
- The provider-assigned unique ID for this managed resource.
- route_
count number - Number of routes
- service_
id string - Service ID. Generated after system creation, for example svc-1234567890
- template_
id string - Template ID associated with built-in service
- trn string
- Resource TRN
- updated_
at number - Update time, Unix timestamp in milliseconds
- backend
Type String - Backend service type, for example custom, viking, agentkit-mcp
- created
At Integer - Creation time, Unix timestamp in milliseconds
- hijack
Domain StringPrivate - Private domain name
- hijack
Domain StringPublic - Public domain name
- id String
- The provider-assigned unique ID for this managed resource.
- route
Count Integer - Number of routes
- service
Id String - Service ID. Generated after system creation, for example svc-1234567890
- template
Id String - Template ID associated with built-in service
- trn String
- Resource TRN
- updated
At Integer - Update time, Unix timestamp in milliseconds
- backend
Type string - Backend service type, for example custom, viking, agentkit-mcp
- created
At number - Creation time, Unix timestamp in milliseconds
- hijack
Domain stringPrivate - Private domain name
- hijack
Domain stringPublic - Public domain name
- id string
- The provider-assigned unique ID for this managed resource.
- route
Count number - Number of routes
- service
Id string - Service ID. Generated after system creation, for example svc-1234567890
- template
Id string - Template ID associated with built-in service
- trn string
- Resource TRN
- updated
At number - Update time, Unix timestamp in milliseconds
- backend_
type str - Backend service type, for example custom, viking, agentkit-mcp
- created_
at int - Creation time, Unix timestamp in milliseconds
- hijack_
domain_ strprivate - Private domain name
- hijack_
domain_ strpublic - Public domain name
- id str
- The provider-assigned unique ID for this managed resource.
- route_
count int - Number of routes
- service_
id str - Service ID. Generated after system creation, for example svc-1234567890
- template_
id str - Template ID associated with built-in service
- trn str
- Resource TRN
- updated_
at int - Update time, Unix timestamp in milliseconds
- backend
Type String - Backend service type, for example custom, viking, agentkit-mcp
- created
At Number - Creation time, Unix timestamp in milliseconds
- hijack
Domain StringPrivate - Private domain name
- hijack
Domain StringPublic - Public domain name
- id String
- The provider-assigned unique ID for this managed resource.
- route
Count Number - Number of routes
- service
Id String - Service ID. Generated after system creation, for example svc-1234567890
- template
Id String - Template ID associated with built-in service
- trn String
- Resource TRN
- updated
At Number - Update time, Unix timestamp in milliseconds
Look up Existing Service Resource
Get an existing Service 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?: ServiceState, opts?: CustomResourceOptions): Service@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
backend: Optional[ServiceBackendArgs] = None,
backend_type: Optional[str] = None,
created_at: Optional[int] = None,
description: Optional[str] = None,
hijack_domain_private: Optional[str] = None,
hijack_domain_public: Optional[str] = None,
permission_space_id: Optional[str] = None,
permission_space_name: Optional[str] = None,
project_name: Optional[str] = None,
route_count: Optional[int] = None,
routes: Optional[Sequence[ServiceRouteArgs]] = None,
service_id: Optional[str] = None,
service_name: Optional[str] = None,
status: Optional[str] = None,
tags: Optional[Sequence[ServiceTagArgs]] = None,
template_id: Optional[str] = None,
trn: Optional[str] = None,
updated_at: Optional[int] = None) -> Servicefunc GetService(ctx *Context, name string, id IDInput, state *ServiceState, opts ...ResourceOption) (*Service, error)public static Service Get(string name, Input<string> id, ServiceState? state, CustomResourceOptions? opts = null)public static Service get(String name, Output<String> id, ServiceState state, CustomResourceOptions options)resources: _: type: volcenginecc:id:Service get: id: ${id}import {
to = volcenginecc_id_service.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.
- Backend
Volcengine.
Service Backend - Backend service configuration
- Backend
Type string - Backend service type, for example custom, viking, agentkit-mcp
- Created
At int - Creation time, Unix timestamp in milliseconds
- Description string
- Service description, up to 256 characters
- Hijack
Domain stringPrivate - Private domain name
- Hijack
Domain stringPublic - Public domain name
- Permission
Space stringId - Permission space ID, for example ps_123456
- Permission
Space stringName - Permission space name
- Project
Name string - Project name. Optional at creation, default value is "default"
- Route
Count int - Number of routes
- Routes
List<Volcengine.
Service Route> - Service
Id string - Service ID. Generated after system creation, for example svc-1234567890
- Service
Name string - Service name, 1–64 characters, unique within the account
- Status string
- Service status. inactive: not enabled. active: enabled (configuration synced to APIGateway). draft: draft status (changes not synced to APIGateway)
-
List<Volcengine.
Service Tag> - Template
Id string - Template ID associated with built-in service
- Trn string
- Resource TRN
- Updated
At int - Update time, Unix timestamp in milliseconds
- Backend
Service
Backend Args - Backend service configuration
- Backend
Type string - Backend service type, for example custom, viking, agentkit-mcp
- Created
At int - Creation time, Unix timestamp in milliseconds
- Description string
- Service description, up to 256 characters
- Hijack
Domain stringPrivate - Private domain name
- Hijack
Domain stringPublic - Public domain name
- Permission
Space stringId - Permission space ID, for example ps_123456
- Permission
Space stringName - Permission space name
- Project
Name string - Project name. Optional at creation, default value is "default"
- Route
Count int - Number of routes
- Routes
[]Service
Route Args - Service
Id string - Service ID. Generated after system creation, for example svc-1234567890
- Service
Name string - Service name, 1–64 characters, unique within the account
- Status string
- Service status. inactive: not enabled. active: enabled (configuration synced to APIGateway). draft: draft status (changes not synced to APIGateway)
-
[]Service
Tag Args - Template
Id string - Template ID associated with built-in service
- Trn string
- Resource TRN
- Updated
At int - Update time, Unix timestamp in milliseconds
- backend object
- Backend service configuration
- backend_
type string - Backend service type, for example custom, viking, agentkit-mcp
- created_
at number - Creation time, Unix timestamp in milliseconds
- description string
- Service description, up to 256 characters
- hijack_
domain_ stringprivate - Private domain name
- hijack_
domain_ stringpublic - Public domain name
- permission_
space_ stringid - Permission space ID, for example ps_123456
- permission_
space_ stringname - Permission space name
- project_
name string - Project name. Optional at creation, default value is "default"
- route_
count number - Number of routes
- routes list(object)
- service_
id string - Service ID. Generated after system creation, for example svc-1234567890
- service_
name string - Service name, 1–64 characters, unique within the account
- status string
- Service status. inactive: not enabled. active: enabled (configuration synced to APIGateway). draft: draft status (changes not synced to APIGateway)
- list(object)
- template_
id string - Template ID associated with built-in service
- trn string
- Resource TRN
- updated_
at number - Update time, Unix timestamp in milliseconds
- backend
Service
Backend - Backend service configuration
- backend
Type String - Backend service type, for example custom, viking, agentkit-mcp
- created
At Integer - Creation time, Unix timestamp in milliseconds
- description String
- Service description, up to 256 characters
- hijack
Domain StringPrivate - Private domain name
- hijack
Domain StringPublic - Public domain name
- permission
Space StringId - Permission space ID, for example ps_123456
- permission
Space StringName - Permission space name
- project
Name String - Project name. Optional at creation, default value is "default"
- route
Count Integer - Number of routes
- routes
List<Service
Route> - service
Id String - Service ID. Generated after system creation, for example svc-1234567890
- service
Name String - Service name, 1–64 characters, unique within the account
- status String
- Service status. inactive: not enabled. active: enabled (configuration synced to APIGateway). draft: draft status (changes not synced to APIGateway)
-
List<Service
Tag> - template
Id String - Template ID associated with built-in service
- trn String
- Resource TRN
- updated
At Integer - Update time, Unix timestamp in milliseconds
- backend
Service
Backend - Backend service configuration
- backend
Type string - Backend service type, for example custom, viking, agentkit-mcp
- created
At number - Creation time, Unix timestamp in milliseconds
- description string
- Service description, up to 256 characters
- hijack
Domain stringPrivate - Private domain name
- hijack
Domain stringPublic - Public domain name
- permission
Space stringId - Permission space ID, for example ps_123456
- permission
Space stringName - Permission space name
- project
Name string - Project name. Optional at creation, default value is "default"
- route
Count number - Number of routes
- routes
Service
Route[] - service
Id string - Service ID. Generated after system creation, for example svc-1234567890
- service
Name string - Service name, 1–64 characters, unique within the account
- status string
- Service status. inactive: not enabled. active: enabled (configuration synced to APIGateway). draft: draft status (changes not synced to APIGateway)
-
Service
Tag[] - template
Id string - Template ID associated with built-in service
- trn string
- Resource TRN
- updated
At number - Update time, Unix timestamp in milliseconds
- backend
Service
Backend Args - Backend service configuration
- backend_
type str - Backend service type, for example custom, viking, agentkit-mcp
- created_
at int - Creation time, Unix timestamp in milliseconds
- description str
- Service description, up to 256 characters
- hijack_
domain_ strprivate - Private domain name
- hijack_
domain_ strpublic - Public domain name
- permission_
space_ strid - Permission space ID, for example ps_123456
- permission_
space_ strname - Permission space name
- project_
name str - Project name. Optional at creation, default value is "default"
- route_
count int - Number of routes
- routes
Sequence[Service
Route Args] - service_
id str - Service ID. Generated after system creation, for example svc-1234567890
- service_
name str - Service name, 1–64 characters, unique within the account
- status str
- Service status. inactive: not enabled. active: enabled (configuration synced to APIGateway). draft: draft status (changes not synced to APIGateway)
-
Sequence[Service
Tag Args] - template_
id str - Template ID associated with built-in service
- trn str
- Resource TRN
- updated_
at int - Update time, Unix timestamp in milliseconds
- backend Property Map
- Backend service configuration
- backend
Type String - Backend service type, for example custom, viking, agentkit-mcp
- created
At Number - Creation time, Unix timestamp in milliseconds
- description String
- Service description, up to 256 characters
- hijack
Domain StringPrivate - Private domain name
- hijack
Domain StringPublic - Public domain name
- permission
Space StringId - Permission space ID, for example ps_123456
- permission
Space StringName - Permission space name
- project
Name String - Project name. Optional at creation, default value is "default"
- route
Count Number - Number of routes
- routes List<Property Map>
- service
Id String - Service ID. Generated after system creation, for example svc-1234567890
- service
Name String - Service name, 1–64 characters, unique within the account
- status String
- Service status. inactive: not enabled. active: enabled (configuration synced to APIGateway). draft: draft status (changes not synced to APIGateway)
- List<Property Map>
- template
Id String - Template ID associated with built-in service
- trn String
- Resource TRN
- updated
At Number - Update time, Unix timestamp in milliseconds
Supporting Types
ServiceBackend, ServiceBackendArgs
- Backend
Domain string - Backend service domain name, for example api.example.com
- Enable
Tls bool - Whether to enable TLS
- Backend
Port int - Backend service port, default is 443
- Protocol string
- Communication protocol, for example HTTP or HTTPS
- Timeout
Seconds int - Request timeout in seconds, default is 30 seconds
- Backend
Domain string - Backend service domain name, for example api.example.com
- Enable
Tls bool - Whether to enable TLS
- Backend
Port int - Backend service port, default is 443
- Protocol string
- Communication protocol, for example HTTP or HTTPS
- Timeout
Seconds int - Request timeout in seconds, default is 30 seconds
- backend_
domain string - Backend service domain name, for example api.example.com
- enable_
tls bool - Whether to enable TLS
- backend_
port number - Backend service port, default is 443
- protocol string
- Communication protocol, for example HTTP or HTTPS
- timeout_
seconds number - Request timeout in seconds, default is 30 seconds
- backend
Domain String - Backend service domain name, for example api.example.com
- enable
Tls Boolean - Whether to enable TLS
- backend
Port Integer - Backend service port, default is 443
- protocol String
- Communication protocol, for example HTTP or HTTPS
- timeout
Seconds Integer - Request timeout in seconds, default is 30 seconds
- backend
Domain string - Backend service domain name, for example api.example.com
- enable
Tls boolean - Whether to enable TLS
- backend
Port number - Backend service port, default is 443
- protocol string
- Communication protocol, for example HTTP or HTTPS
- timeout
Seconds number - Request timeout in seconds, default is 30 seconds
- backend_
domain str - Backend service domain name, for example api.example.com
- enable_
tls bool - Whether to enable TLS
- backend_
port int - Backend service port, default is 443
- protocol str
- Communication protocol, for example HTTP or HTTPS
- timeout_
seconds int - Request timeout in seconds, default is 30 seconds
- backend
Domain String - Backend service domain name, for example api.example.com
- enable
Tls Boolean - Whether to enable TLS
- backend
Port Number - Backend service port, default is 443
- protocol String
- Communication protocol, for example HTTP or HTTPS
- timeout
Seconds Number - Request timeout in seconds, default is 30 seconds
ServiceRoute, ServiceRouteArgs
- Api
Spec Volcengine.Service Route Api Spec - API specification configuration
- Auth
Resource stringType - Authentication resource type
- Description string
- Route description
- Method string
- HTTP methods, separated by commas
- Path string
- Request path, 1–256 characters
- Path
Match stringType - Path match type, for example Exact, Prefix
- Permission
Pool string - Permission pool name
- Priority int
- Route priority, lower values indicate higher priority
- Resource
Type string - Resource type, for example Collection
- Route
Name string - Route name, 1–64 characters
- Api
Spec ServiceRoute Api Spec - API specification configuration
- Auth
Resource stringType - Authentication resource type
- Description string
- Route description
- Method string
- HTTP methods, separated by commas
- Path string
- Request path, 1–256 characters
- Path
Match stringType - Path match type, for example Exact, Prefix
- Permission
Pool string - Permission pool name
- Priority int
- Route priority, lower values indicate higher priority
- Resource
Type string - Resource type, for example Collection
- Route
Name string - Route name, 1–64 characters
- api_
spec object - API specification configuration
- auth_
resource_ stringtype - Authentication resource type
- description string
- Route description
- method string
- HTTP methods, separated by commas
- path string
- Request path, 1–256 characters
- path_
match_ stringtype - Path match type, for example Exact, Prefix
- permission_
pool string - Permission pool name
- priority number
- Route priority, lower values indicate higher priority
- resource_
type string - Resource type, for example Collection
- route_
name string - Route name, 1–64 characters
- api
Spec ServiceRoute Api Spec - API specification configuration
- auth
Resource StringType - Authentication resource type
- description String
- Route description
- method String
- HTTP methods, separated by commas
- path String
- Request path, 1–256 characters
- path
Match StringType - Path match type, for example Exact, Prefix
- permission
Pool String - Permission pool name
- priority Integer
- Route priority, lower values indicate higher priority
- resource
Type String - Resource type, for example Collection
- route
Name String - Route name, 1–64 characters
- api
Spec ServiceRoute Api Spec - API specification configuration
- auth
Resource stringType - Authentication resource type
- description string
- Route description
- method string
- HTTP methods, separated by commas
- path string
- Request path, 1–256 characters
- path
Match stringType - Path match type, for example Exact, Prefix
- permission
Pool string - Permission pool name
- priority number
- Route priority, lower values indicate higher priority
- resource
Type string - Resource type, for example Collection
- route
Name string - Route name, 1–64 characters
- api_
spec ServiceRoute Api Spec - API specification configuration
- auth_
resource_ strtype - Authentication resource type
- description str
- Route description
- method str
- HTTP methods, separated by commas
- path str
- Request path, 1–256 characters
- path_
match_ strtype - Path match type, for example Exact, Prefix
- permission_
pool str - Permission pool name
- priority int
- Route priority, lower values indicate higher priority
- resource_
type str - Resource type, for example Collection
- route_
name str - Route name, 1–64 characters
- api
Spec Property Map - API specification configuration
- auth
Resource StringType - Authentication resource type
- description String
- Route description
- method String
- HTTP methods, separated by commas
- path String
- Request path, 1–256 characters
- path
Match StringType - Path match type, for example Exact, Prefix
- permission
Pool String - Permission pool name
- priority Number
- Route priority, lower values indicate higher priority
- resource
Type String - Resource type, for example Collection
- route
Name String - Route name, 1–64 characters
ServiceRouteApiSpec, ServiceRouteApiSpecArgs
- Action
Type string - Operation type, for example READ
- Action
Value string - Operation value, for example search
- Extractors
List<Volcengine.
Service Route Api Spec Extractor> - Identifier
Type int - Resource identifier type
- Identifier
Value string - Resource identifier value, for example JSON Pointer
- Response
Filters List<Volcengine.Service Route Api Spec Response Filter>
- Action
Type string - Operation type, for example READ
- Action
Value string - Operation value, for example search
- Extractors
[]Service
Route Api Spec Extractor - Identifier
Type int - Resource identifier type
- Identifier
Value string - Resource identifier value, for example JSON Pointer
- Response
Filters []ServiceRoute Api Spec Response Filter
- action_
type string - Operation type, for example READ
- action_
value string - Operation value, for example search
- extractors list(object)
- identifier_
type number - Resource identifier type
- identifier_
value string - Resource identifier value, for example JSON Pointer
- response_
filters list(object)
- action
Type String - Operation type, for example READ
- action
Value String - Operation value, for example search
- extractors
List<Service
Route Api Spec Extractor> - identifier
Type Integer - Resource identifier type
- identifier
Value String - Resource identifier value, for example JSON Pointer
- response
Filters List<ServiceRoute Api Spec Response Filter>
- action
Type string - Operation type, for example READ
- action
Value string - Operation value, for example search
- extractors
Service
Route Api Spec Extractor[] - identifier
Type number - Resource identifier type
- identifier
Value string - Resource identifier value, for example JSON Pointer
- response
Filters ServiceRoute Api Spec Response Filter[]
- action_
type str - Operation type, for example READ
- action_
value str - Operation value, for example search
- extractors
Sequence[Service
Route Api Spec Extractor] - identifier_
type int - Resource identifier type
- identifier_
value str - Resource identifier value, for example JSON Pointer
- response_
filters Sequence[ServiceRoute Api Spec Response Filter]
- action
Type String - Operation type, for example READ
- action
Value String - Operation value, for example search
- extractors List<Property Map>
- identifier
Type Number - Resource identifier type
- identifier
Value String - Resource identifier value, for example JSON Pointer
- response
Filters List<Property Map>
ServiceRouteApiSpecExtractor, ServiceRouteApiSpecExtractorArgs
- Is
Auth bool - Whether used for authentication
- Path string
- JSON Pointer expression
- Resource
Type string - Extracted resource type
- Source int
- Extraction source enumeration value
- Is
Auth bool - Whether used for authentication
- Path string
- JSON Pointer expression
- Resource
Type string - Extracted resource type
- Source int
- Extraction source enumeration value
- is_
auth bool - Whether used for authentication
- path string
- JSON Pointer expression
- resource_
type string - Extracted resource type
- source number
- Extraction source enumeration value
- is
Auth Boolean - Whether used for authentication
- path String
- JSON Pointer expression
- resource
Type String - Extracted resource type
- source Integer
- Extraction source enumeration value
- is
Auth boolean - Whether used for authentication
- path string
- JSON Pointer expression
- resource
Type string - Extracted resource type
- source number
- Extraction source enumeration value
- is_
auth bool - Whether used for authentication
- path str
- JSON Pointer expression
- resource_
type str - Extracted resource type
- source int
- Extraction source enumeration value
- is
Auth Boolean - Whether used for authentication
- path String
- JSON Pointer expression
- resource
Type String - Extracted resource type
- source Number
- Extraction source enumeration value
ServiceRouteApiSpecResponseFilter, ServiceRouteApiSpecResponseFilterArgs
- Attributes
List<Volcengine.
Service Route Api Spec Response Filter Attribute> - Filter
Path string - Array path JSON Pointer
- Id
Field string - ID field name
- Is
Auth bool - Whether used for authentication
- Mode int
- Filter mode enumeration value
- Resource
Path string - Resource path JSON Pointer
- Resource
Type string - Filtered resource type
- Attributes
[]Service
Route Api Spec Response Filter Attribute - Filter
Path string - Array path JSON Pointer
- Id
Field string - ID field name
- Is
Auth bool - Whether used for authentication
- Mode int
- Filter mode enumeration value
- Resource
Path string - Resource path JSON Pointer
- Resource
Type string - Filtered resource type
- attributes list(object)
- filter_
path string - Array path JSON Pointer
- id_
field string - ID field name
- is_
auth bool - Whether used for authentication
- mode number
- Filter mode enumeration value
- resource_
path string - Resource path JSON Pointer
- resource_
type string - Filtered resource type
- attributes
List<Service
Route Api Spec Response Filter Attribute> - filter
Path String - Array path JSON Pointer
- id
Field String - ID field name
- is
Auth Boolean - Whether used for authentication
- mode Integer
- Filter mode enumeration value
- resource
Path String - Resource path JSON Pointer
- resource
Type String - Filtered resource type
- attributes
Service
Route Api Spec Response Filter Attribute[] - filter
Path string - Array path JSON Pointer
- id
Field string - ID field name
- is
Auth boolean - Whether used for authentication
- mode number
- Filter mode enumeration value
- resource
Path string - Resource path JSON Pointer
- resource
Type string - Filtered resource type
- attributes
Sequence[Service
Route Api Spec Response Filter Attribute] - filter_
path str - Array path JSON Pointer
- id_
field str - ID field name
- is_
auth bool - Whether used for authentication
- mode int
- Filter mode enumeration value
- resource_
path str - Resource path JSON Pointer
- resource_
type str - Filtered resource type
- attributes List<Property Map>
- filter
Path String - Array path JSON Pointer
- id
Field String - ID field name
- is
Auth Boolean - Whether used for authentication
- mode Number
- Filter mode enumeration value
- resource
Path String - Resource path JSON Pointer
- resource
Type String - Filtered resource type
ServiceRouteApiSpecResponseFilterAttribute, ServiceRouteApiSpecResponseFilterAttributeArgs
ServiceTag, ServiceTagArgs
Import
$ pulumi import volcenginecc:id/service:Service example "service_id"
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- volcenginecc volcengine/pulumi-volcenginecc
- License
- MPL-2.0
- Notes
- This Pulumi package is based on the
volcengineccTerraform Provider.
published on Thursday, Jun 11, 2026 by Volcengine