1. Packages
  2. Packages
  3. Volcenginecc Provider
  4. API Docs
  5. id
  6. Service
Viewing docs for volcenginecc v0.0.42
published on Thursday, Jun 11, 2026 by Volcengine
volcenginecc logo
Viewing docs for volcenginecc v0.0.42
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.ServiceBackend
    Backend service configuration
    PermissionSpaceId string
    Permission space ID, for example ps_123456
    ServiceName string
    Service name, 1–64 characters, unique within the account
    Description string
    Service description, up to 256 characters
    PermissionSpaceName string
    Permission space name
    ProjectName string
    Project name. Optional at creation, default value is "default"
    Routes List<Volcengine.ServiceRoute>
    Status string
    Service status. inactive: not enabled. active: enabled (configuration synced to APIGateway). draft: draft status (changes not synced to APIGateway)
    Tags List<Volcengine.ServiceTag>
    Backend ServiceBackendArgs
    Backend service configuration
    PermissionSpaceId string
    Permission space ID, for example ps_123456
    ServiceName string
    Service name, 1–64 characters, unique within the account
    Description string
    Service description, up to 256 characters
    PermissionSpaceName string
    Permission space name
    ProjectName string
    Project name. Optional at creation, default value is "default"
    Routes []ServiceRouteArgs
    Status string
    Service status. inactive: not enabled. active: enabled (configuration synced to APIGateway). draft: draft status (changes not synced to APIGateway)
    Tags []ServiceTagArgs
    backend object
    Backend service configuration
    permission_space_id string
    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_name string
    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)
    tags list(object)
    backend ServiceBackend
    Backend service configuration
    permissionSpaceId String
    Permission space ID, for example ps_123456
    serviceName String
    Service name, 1–64 characters, unique within the account
    description String
    Service description, up to 256 characters
    permissionSpaceName String
    Permission space name
    projectName String
    Project name. Optional at creation, default value is "default"
    routes List<ServiceRoute>
    status String
    Service status. inactive: not enabled. active: enabled (configuration synced to APIGateway). draft: draft status (changes not synced to APIGateway)
    tags List<ServiceTag>
    backend ServiceBackend
    Backend service configuration
    permissionSpaceId string
    Permission space ID, for example ps_123456
    serviceName string
    Service name, 1–64 characters, unique within the account
    description string
    Service description, up to 256 characters
    permissionSpaceName string
    Permission space name
    projectName string
    Project name. Optional at creation, default value is "default"
    routes ServiceRoute[]
    status string
    Service status. inactive: not enabled. active: enabled (configuration synced to APIGateway). draft: draft status (changes not synced to APIGateway)
    tags ServiceTag[]
    backend ServiceBackendArgs
    Backend service configuration
    permission_space_id str
    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_name str
    Permission space name
    project_name str
    Project name. Optional at creation, default value is "default"
    routes Sequence[ServiceRouteArgs]
    status str
    Service status. inactive: not enabled. active: enabled (configuration synced to APIGateway). draft: draft status (changes not synced to APIGateway)
    tags Sequence[ServiceTagArgs]
    backend Property Map
    Backend service configuration
    permissionSpaceId String
    Permission space ID, for example ps_123456
    serviceName String
    Service name, 1–64 characters, unique within the account
    description String
    Service description, up to 256 characters
    permissionSpaceName String
    Permission space name
    projectName 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)
    tags List<Property Map>

    Outputs

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

    BackendType string
    Backend service type, for example custom, viking, agentkit-mcp
    CreatedAt int
    Creation time, Unix timestamp in milliseconds
    HijackDomainPrivate string
    Private domain name
    HijackDomainPublic string
    Public domain name
    Id string
    The provider-assigned unique ID for this managed resource.
    RouteCount int
    Number of routes
    ServiceId string
    Service ID. Generated after system creation, for example svc-1234567890
    TemplateId string
    Template ID associated with built-in service
    Trn string
    Resource TRN
    UpdatedAt int
    Update time, Unix timestamp in milliseconds
    BackendType string
    Backend service type, for example custom, viking, agentkit-mcp
    CreatedAt int
    Creation time, Unix timestamp in milliseconds
    HijackDomainPrivate string
    Private domain name
    HijackDomainPublic string
    Public domain name
    Id string
    The provider-assigned unique ID for this managed resource.
    RouteCount int
    Number of routes
    ServiceId string
    Service ID. Generated after system creation, for example svc-1234567890
    TemplateId string
    Template ID associated with built-in service
    Trn string
    Resource TRN
    UpdatedAt 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_private string
    Private domain name
    hijack_domain_public string
    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
    backendType String
    Backend service type, for example custom, viking, agentkit-mcp
    createdAt Integer
    Creation time, Unix timestamp in milliseconds
    hijackDomainPrivate String
    Private domain name
    hijackDomainPublic String
    Public domain name
    id String
    The provider-assigned unique ID for this managed resource.
    routeCount Integer
    Number of routes
    serviceId String
    Service ID. Generated after system creation, for example svc-1234567890
    templateId String
    Template ID associated with built-in service
    trn String
    Resource TRN
    updatedAt Integer
    Update time, Unix timestamp in milliseconds
    backendType string
    Backend service type, for example custom, viking, agentkit-mcp
    createdAt number
    Creation time, Unix timestamp in milliseconds
    hijackDomainPrivate string
    Private domain name
    hijackDomainPublic string
    Public domain name
    id string
    The provider-assigned unique ID for this managed resource.
    routeCount number
    Number of routes
    serviceId string
    Service ID. Generated after system creation, for example svc-1234567890
    templateId string
    Template ID associated with built-in service
    trn string
    Resource TRN
    updatedAt 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_private str
    Private domain name
    hijack_domain_public str
    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
    backendType String
    Backend service type, for example custom, viking, agentkit-mcp
    createdAt Number
    Creation time, Unix timestamp in milliseconds
    hijackDomainPrivate String
    Private domain name
    hijackDomainPublic String
    Public domain name
    id String
    The provider-assigned unique ID for this managed resource.
    routeCount Number
    Number of routes
    serviceId String
    Service ID. Generated after system creation, for example svc-1234567890
    templateId String
    Template ID associated with built-in service
    trn String
    Resource TRN
    updatedAt 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) -> Service
    func 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.
    The following state arguments are supported:
    Backend Volcengine.ServiceBackend
    Backend service configuration
    BackendType string
    Backend service type, for example custom, viking, agentkit-mcp
    CreatedAt int
    Creation time, Unix timestamp in milliseconds
    Description string
    Service description, up to 256 characters
    HijackDomainPrivate string
    Private domain name
    HijackDomainPublic string
    Public domain name
    PermissionSpaceId string
    Permission space ID, for example ps_123456
    PermissionSpaceName string
    Permission space name
    ProjectName string
    Project name. Optional at creation, default value is "default"
    RouteCount int
    Number of routes
    Routes List<Volcengine.ServiceRoute>
    ServiceId string
    Service ID. Generated after system creation, for example svc-1234567890
    ServiceName 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)
    Tags List<Volcengine.ServiceTag>
    TemplateId string
    Template ID associated with built-in service
    Trn string
    Resource TRN
    UpdatedAt int
    Update time, Unix timestamp in milliseconds
    Backend ServiceBackendArgs
    Backend service configuration
    BackendType string
    Backend service type, for example custom, viking, agentkit-mcp
    CreatedAt int
    Creation time, Unix timestamp in milliseconds
    Description string
    Service description, up to 256 characters
    HijackDomainPrivate string
    Private domain name
    HijackDomainPublic string
    Public domain name
    PermissionSpaceId string
    Permission space ID, for example ps_123456
    PermissionSpaceName string
    Permission space name
    ProjectName string
    Project name. Optional at creation, default value is "default"
    RouteCount int
    Number of routes
    Routes []ServiceRouteArgs
    ServiceId string
    Service ID. Generated after system creation, for example svc-1234567890
    ServiceName 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)
    Tags []ServiceTagArgs
    TemplateId string
    Template ID associated with built-in service
    Trn string
    Resource TRN
    UpdatedAt 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_private string
    Private domain name
    hijack_domain_public string
    Public domain name
    permission_space_id string
    Permission space ID, for example ps_123456
    permission_space_name string
    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)
    tags 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 ServiceBackend
    Backend service configuration
    backendType String
    Backend service type, for example custom, viking, agentkit-mcp
    createdAt Integer
    Creation time, Unix timestamp in milliseconds
    description String
    Service description, up to 256 characters
    hijackDomainPrivate String
    Private domain name
    hijackDomainPublic String
    Public domain name
    permissionSpaceId String
    Permission space ID, for example ps_123456
    permissionSpaceName String
    Permission space name
    projectName String
    Project name. Optional at creation, default value is "default"
    routeCount Integer
    Number of routes
    routes List<ServiceRoute>
    serviceId String
    Service ID. Generated after system creation, for example svc-1234567890
    serviceName 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)
    tags List<ServiceTag>
    templateId String
    Template ID associated with built-in service
    trn String
    Resource TRN
    updatedAt Integer
    Update time, Unix timestamp in milliseconds
    backend ServiceBackend
    Backend service configuration
    backendType string
    Backend service type, for example custom, viking, agentkit-mcp
    createdAt number
    Creation time, Unix timestamp in milliseconds
    description string
    Service description, up to 256 characters
    hijackDomainPrivate string
    Private domain name
    hijackDomainPublic string
    Public domain name
    permissionSpaceId string
    Permission space ID, for example ps_123456
    permissionSpaceName string
    Permission space name
    projectName string
    Project name. Optional at creation, default value is "default"
    routeCount number
    Number of routes
    routes ServiceRoute[]
    serviceId string
    Service ID. Generated after system creation, for example svc-1234567890
    serviceName 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)
    tags ServiceTag[]
    templateId string
    Template ID associated with built-in service
    trn string
    Resource TRN
    updatedAt number
    Update time, Unix timestamp in milliseconds
    backend ServiceBackendArgs
    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_private str
    Private domain name
    hijack_domain_public str
    Public domain name
    permission_space_id str
    Permission space ID, for example ps_123456
    permission_space_name str
    Permission space name
    project_name str
    Project name. Optional at creation, default value is "default"
    route_count int
    Number of routes
    routes Sequence[ServiceRouteArgs]
    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)
    tags Sequence[ServiceTagArgs]
    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
    backendType String
    Backend service type, for example custom, viking, agentkit-mcp
    createdAt Number
    Creation time, Unix timestamp in milliseconds
    description String
    Service description, up to 256 characters
    hijackDomainPrivate String
    Private domain name
    hijackDomainPublic String
    Public domain name
    permissionSpaceId String
    Permission space ID, for example ps_123456
    permissionSpaceName String
    Permission space name
    projectName String
    Project name. Optional at creation, default value is "default"
    routeCount Number
    Number of routes
    routes List<Property Map>
    serviceId String
    Service ID. Generated after system creation, for example svc-1234567890
    serviceName 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)
    tags List<Property Map>
    templateId String
    Template ID associated with built-in service
    trn String
    Resource TRN
    updatedAt Number
    Update time, Unix timestamp in milliseconds

    Supporting Types

    ServiceBackend, ServiceBackendArgs

    BackendDomain string
    Backend service domain name, for example api.example.com
    EnableTls bool
    Whether to enable TLS
    BackendPort int
    Backend service port, default is 443
    Protocol string
    Communication protocol, for example HTTP or HTTPS
    TimeoutSeconds int
    Request timeout in seconds, default is 30 seconds
    BackendDomain string
    Backend service domain name, for example api.example.com
    EnableTls bool
    Whether to enable TLS
    BackendPort int
    Backend service port, default is 443
    Protocol string
    Communication protocol, for example HTTP or HTTPS
    TimeoutSeconds 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
    backendDomain String
    Backend service domain name, for example api.example.com
    enableTls Boolean
    Whether to enable TLS
    backendPort Integer
    Backend service port, default is 443
    protocol String
    Communication protocol, for example HTTP or HTTPS
    timeoutSeconds Integer
    Request timeout in seconds, default is 30 seconds
    backendDomain string
    Backend service domain name, for example api.example.com
    enableTls boolean
    Whether to enable TLS
    backendPort number
    Backend service port, default is 443
    protocol string
    Communication protocol, for example HTTP or HTTPS
    timeoutSeconds 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
    backendDomain String
    Backend service domain name, for example api.example.com
    enableTls Boolean
    Whether to enable TLS
    backendPort Number
    Backend service port, default is 443
    protocol String
    Communication protocol, for example HTTP or HTTPS
    timeoutSeconds Number
    Request timeout in seconds, default is 30 seconds

    ServiceRoute, ServiceRouteArgs

    ApiSpec Volcengine.ServiceRouteApiSpec
    API specification configuration
    AuthResourceType string
    Authentication resource type
    Description string
    Route description
    Method string
    HTTP methods, separated by commas
    Path string
    Request path, 1–256 characters
    PathMatchType string
    Path match type, for example Exact, Prefix
    PermissionPool string
    Permission pool name
    Priority int
    Route priority, lower values indicate higher priority
    ResourceType string
    Resource type, for example Collection
    RouteName string
    Route name, 1–64 characters
    ApiSpec ServiceRouteApiSpec
    API specification configuration
    AuthResourceType string
    Authentication resource type
    Description string
    Route description
    Method string
    HTTP methods, separated by commas
    Path string
    Request path, 1–256 characters
    PathMatchType string
    Path match type, for example Exact, Prefix
    PermissionPool string
    Permission pool name
    Priority int
    Route priority, lower values indicate higher priority
    ResourceType string
    Resource type, for example Collection
    RouteName string
    Route name, 1–64 characters
    api_spec object
    API specification configuration
    auth_resource_type string
    Authentication resource type
    description string
    Route description
    method string
    HTTP methods, separated by commas
    path string
    Request path, 1–256 characters
    path_match_type string
    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
    apiSpec ServiceRouteApiSpec
    API specification configuration
    authResourceType String
    Authentication resource type
    description String
    Route description
    method String
    HTTP methods, separated by commas
    path String
    Request path, 1–256 characters
    pathMatchType String
    Path match type, for example Exact, Prefix
    permissionPool String
    Permission pool name
    priority Integer
    Route priority, lower values indicate higher priority
    resourceType String
    Resource type, for example Collection
    routeName String
    Route name, 1–64 characters
    apiSpec ServiceRouteApiSpec
    API specification configuration
    authResourceType string
    Authentication resource type
    description string
    Route description
    method string
    HTTP methods, separated by commas
    path string
    Request path, 1–256 characters
    pathMatchType string
    Path match type, for example Exact, Prefix
    permissionPool string
    Permission pool name
    priority number
    Route priority, lower values indicate higher priority
    resourceType string
    Resource type, for example Collection
    routeName string
    Route name, 1–64 characters
    api_spec ServiceRouteApiSpec
    API specification configuration
    auth_resource_type str
    Authentication resource type
    description str
    Route description
    method str
    HTTP methods, separated by commas
    path str
    Request path, 1–256 characters
    path_match_type str
    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
    apiSpec Property Map
    API specification configuration
    authResourceType String
    Authentication resource type
    description String
    Route description
    method String
    HTTP methods, separated by commas
    path String
    Request path, 1–256 characters
    pathMatchType String
    Path match type, for example Exact, Prefix
    permissionPool String
    Permission pool name
    priority Number
    Route priority, lower values indicate higher priority
    resourceType String
    Resource type, for example Collection
    routeName String
    Route name, 1–64 characters

    ServiceRouteApiSpec, ServiceRouteApiSpecArgs

    ActionType string
    Operation type, for example READ
    ActionValue string
    Operation value, for example search
    Extractors List<Volcengine.ServiceRouteApiSpecExtractor>
    IdentifierType int
    Resource identifier type
    IdentifierValue string
    Resource identifier value, for example JSON Pointer
    ResponseFilters List<Volcengine.ServiceRouteApiSpecResponseFilter>
    ActionType string
    Operation type, for example READ
    ActionValue string
    Operation value, for example search
    Extractors []ServiceRouteApiSpecExtractor
    IdentifierType int
    Resource identifier type
    IdentifierValue string
    Resource identifier value, for example JSON Pointer
    ResponseFilters []ServiceRouteApiSpecResponseFilter
    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)
    actionType String
    Operation type, for example READ
    actionValue String
    Operation value, for example search
    extractors List<ServiceRouteApiSpecExtractor>
    identifierType Integer
    Resource identifier type
    identifierValue String
    Resource identifier value, for example JSON Pointer
    responseFilters List<ServiceRouteApiSpecResponseFilter>
    actionType string
    Operation type, for example READ
    actionValue string
    Operation value, for example search
    extractors ServiceRouteApiSpecExtractor[]
    identifierType number
    Resource identifier type
    identifierValue string
    Resource identifier value, for example JSON Pointer
    responseFilters ServiceRouteApiSpecResponseFilter[]
    action_type str
    Operation type, for example READ
    action_value str
    Operation value, for example search
    extractors Sequence[ServiceRouteApiSpecExtractor]
    identifier_type int
    Resource identifier type
    identifier_value str
    Resource identifier value, for example JSON Pointer
    response_filters Sequence[ServiceRouteApiSpecResponseFilter]
    actionType String
    Operation type, for example READ
    actionValue String
    Operation value, for example search
    extractors List<Property Map>
    identifierType Number
    Resource identifier type
    identifierValue String
    Resource identifier value, for example JSON Pointer
    responseFilters List<Property Map>

    ServiceRouteApiSpecExtractor, ServiceRouteApiSpecExtractorArgs

    IsAuth bool
    Whether used for authentication
    Path string
    JSON Pointer expression
    ResourceType string
    Extracted resource type
    Source int
    Extraction source enumeration value
    IsAuth bool
    Whether used for authentication
    Path string
    JSON Pointer expression
    ResourceType 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
    isAuth Boolean
    Whether used for authentication
    path String
    JSON Pointer expression
    resourceType String
    Extracted resource type
    source Integer
    Extraction source enumeration value
    isAuth boolean
    Whether used for authentication
    path string
    JSON Pointer expression
    resourceType 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
    isAuth Boolean
    Whether used for authentication
    path String
    JSON Pointer expression
    resourceType String
    Extracted resource type
    source Number
    Extraction source enumeration value

    ServiceRouteApiSpecResponseFilter, ServiceRouteApiSpecResponseFilterArgs

    Attributes List<Volcengine.ServiceRouteApiSpecResponseFilterAttribute>
    FilterPath string
    Array path JSON Pointer
    IdField string
    ID field name
    IsAuth bool
    Whether used for authentication
    Mode int
    Filter mode enumeration value
    ResourcePath string
    Resource path JSON Pointer
    ResourceType string
    Filtered resource type
    Attributes []ServiceRouteApiSpecResponseFilterAttribute
    FilterPath string
    Array path JSON Pointer
    IdField string
    ID field name
    IsAuth bool
    Whether used for authentication
    Mode int
    Filter mode enumeration value
    ResourcePath string
    Resource path JSON Pointer
    ResourceType 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<ServiceRouteApiSpecResponseFilterAttribute>
    filterPath String
    Array path JSON Pointer
    idField String
    ID field name
    isAuth Boolean
    Whether used for authentication
    mode Integer
    Filter mode enumeration value
    resourcePath String
    Resource path JSON Pointer
    resourceType String
    Filtered resource type
    attributes ServiceRouteApiSpecResponseFilterAttribute[]
    filterPath string
    Array path JSON Pointer
    idField string
    ID field name
    isAuth boolean
    Whether used for authentication
    mode number
    Filter mode enumeration value
    resourcePath string
    Resource path JSON Pointer
    resourceType string
    Filtered resource type
    attributes Sequence[ServiceRouteApiSpecResponseFilterAttribute]
    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>
    filterPath String
    Array path JSON Pointer
    idField String
    ID field name
    isAuth Boolean
    Whether used for authentication
    mode Number
    Filter mode enumeration value
    resourcePath String
    Resource path JSON Pointer
    resourceType String
    Filtered resource type

    ServiceRouteApiSpecResponseFilterAttribute, ServiceRouteApiSpecResponseFilterAttributeArgs

    Field string
    Source field path JSON Pointer
    Target string
    Target attribute name
    Field string
    Source field path JSON Pointer
    Target string
    Target attribute name
    field string
    Source field path JSON Pointer
    target string
    Target attribute name
    field String
    Source field path JSON Pointer
    target String
    Target attribute name
    field string
    Source field path JSON Pointer
    target string
    Target attribute name
    field str
    Source field path JSON Pointer
    target str
    Target attribute name
    field String
    Source field path JSON Pointer
    target String
    Target attribute name

    ServiceTag, ServiceTagArgs

    Key string
    Tag key
    Value string
    Tag value
    Key string
    Tag key
    Value string
    Tag value
    key string
    Tag key
    value string
    Tag value
    key String
    Tag key
    value String
    Tag value
    key string
    Tag key
    value string
    Tag value
    key str
    Tag key
    value str
    Tag value
    key String
    Tag key
    value String
    Tag value

    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 volcenginecc Terraform Provider.
    volcenginecc logo
    Viewing docs for volcenginecc v0.0.42
    published on Thursday, Jun 11, 2026 by Volcengine

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial