Download OpenAPI specification:Download
API7 Enterprise Admin APIs are RESTful APIs that allow you to create and manage API7 resources.
IAM Action: gateway:CreatePublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/*
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
name | string [ 1 .. 65536 ] characters The object name. |
object Key-value pairs of labels. | |
desc | string <= 65536 characters The object description. |
type required | string Default: "http" Enum: "http" "stream" Type of service. |
hosts | Array of strings [ 1 .. 32 ] items unique [ items^\*?[0-9a-zA-Z-._]+$ ] The hosts of the service to accept incoming requests. |
path_prefix | string [ 1 .. 4096 ] characters ^/ The listening path prefix of the service. |
strip_path_prefix | boolean Default: true If true, strip the path prefix when proxying the request to the upstream. |
plugins | object Key-value pairs of plugins and their configurations on the object. |
Use Upstream Nodes (object) or Use Service Registry (object) or Use Service Registry with Args (object) The upstream contains necessary information for the gateway to proxy request to the backend service. | |
status | integer Default: 1 Enum: 0 1 The object status. 1 means the object is active while 0 means it's inactive. |
{- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "type": "http",
- "hosts": [
- "httpbin.org"
], - "path_prefix": "/test",
- "strip_path_prefix": true,
- "plugins": {
- "key-auth": { }
}, - "upstream": {
- "name": "us-west-rsc",
- "scheme": "http",
- "desc": "Object description.",
- "type": "chash",
- "hash_on": "vars",
- "key": "$host",
- "retries": 50,
- "keepalive_pool": {
- "size": 320,
- "idle_timeout": 60,
- "requests": 1000
}, - "timeout": {
- "connect": 60,
- "send": 60,
- "read": 60
}, - "retry_timeout": 0,
- "pass_host": "pass",
- "upstream_host": "httpbin.org",
- "nodes": [
- {
- "host": "httpbin.org",
- "port": 8080,
- "weight": 100,
- "priority": 0
}
], - "service_name": "<ServiceRegistryID>/public/group/httpbin",
- "discovery_type": "nacos",
- "discovery_args": {
- "metadata": {
- "namespace_id": "public",
- "group_name": "DEFAULT_GROUP"
}
}, - "tls": {
- "client_cert": "$secret://aws/john/apisix-secrets/john-key-auth",
- "client_key": "$secret://aws/john/apisix-secrets/john-key-auth"
}, - "client_certificate": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "ca_certificates": [
- "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101"
], - "tls_verify": true,
- "checks": {
- "active": {
- "type": "http",
- "timeout": 1,
- "concurrency": 10,
- "host": "httpbin.org",
- "port": 1,
- "http_path": "/",
- "https_verify_certificate": true,
- "req_headers": [
- "user-agent: go/1.20"
], - "healthy": {
- "interval": 1,
- "http_statuses": [
- 200,
- 302
], - "successes": 2
}, - "unhealthy": {
- "interval": 1,
- "http_statuses": [
- 429,
- 404,
- 500,
- 501,
- 502,
- 503,
- 504,
- 505
], - "http_failures": 5,
- "tcp_failures": 2,
- "timeouts": 3
}
}
}
}, - "status": 0
}
{- "value": {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "type": "http",
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "last_published": 1742288230,
- "published_gateway_groups_count": 0,
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:GetPublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
order_by | string Default: "updated_at" Enum: "created_at" "updated_at" "last_published" "name" Index to order the services by. |
search | string Example: search=version%3Dv2 Condition to search resources by. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
unhealthy_nodes | Array of strings Items Enum: "unhealthy_nodes_exists" "no_unhealthy_nodes" Filter of services based on whether unhealthy nodes exist. |
labels | string non-empty Example: labels=labels%5Bversion%5D=v2 Label(s) to filter resources by. The format is |
hosts | Array of strings[ items^\*?[0-9a-zA-Z-._]+$ ] Example: hosts=httpbin.org |
type | Array of strings Items Enum: "http" "stream" Type of service. |
with_publish_info | boolean Default: false If true, include publish information in the response, such as |
{- "list": [
- {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "type": "http",
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "last_published": 1742288230,
- "published_gateway_groups_count": 0,
- "created_at": 1742288232,
- "updated_at": 1742288235
}
], - "total": 1
}
IAM Action: gateway:GetPublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
service_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the published service. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
with_publish_info | boolean Default: false If true, include publish information in the response, such as |
{- "value": {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "type": "http",
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "last_published": 1742288230,
- "published_gateway_groups_count": 0,
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:UpdatePublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
service_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the published service. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
name | string [ 1 .. 65536 ] characters The object name. |
object Key-value pairs of labels. | |
desc | string <= 65536 characters The object description. |
type required | string Default: "http" Enum: "http" "stream" Type of service. |
hosts | Array of strings [ 1 .. 32 ] items unique [ items^\*?[0-9a-zA-Z-._]+$ ] The hosts of the service to accept incoming requests. |
path_prefix | string [ 1 .. 4096 ] characters ^/ The listening path prefix of the service. |
strip_path_prefix | boolean Default: true If true, strip the path prefix when proxying the request to the upstream. |
plugins | object Key-value pairs of plugins and their configurations on the object. |
Use Upstream Nodes (object) or Use Service Registry (object) or Use Service Registry with Args (object) The upstream contains necessary information for the gateway to proxy request to the backend service. | |
status | integer Default: 1 Enum: 0 1 The object status. 1 means the object is active while 0 means it's inactive. |
{- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "type": "http",
- "hosts": [
- "httpbin.org"
], - "path_prefix": "/test",
- "strip_path_prefix": true,
- "plugins": {
- "key-auth": { }
}, - "upstream": {
- "name": "us-west-rsc",
- "scheme": "http",
- "desc": "Object description.",
- "type": "chash",
- "hash_on": "vars",
- "key": "$host",
- "retries": 50,
- "keepalive_pool": {
- "size": 320,
- "idle_timeout": 60,
- "requests": 1000
}, - "timeout": {
- "connect": 60,
- "send": 60,
- "read": 60
}, - "retry_timeout": 0,
- "pass_host": "pass",
- "upstream_host": "httpbin.org",
- "nodes": [
- {
- "host": "httpbin.org",
- "port": 8080,
- "weight": 100,
- "priority": 0
}
], - "service_name": "<ServiceRegistryID>/public/group/httpbin",
- "discovery_type": "nacos",
- "discovery_args": {
- "metadata": {
- "namespace_id": "public",
- "group_name": "DEFAULT_GROUP"
}
}, - "tls": {
- "client_cert": "$secret://aws/john/apisix-secrets/john-key-auth",
- "client_key": "$secret://aws/john/apisix-secrets/john-key-auth"
}, - "client_certificate": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "ca_certificates": [
- "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101"
], - "tls_verify": true,
- "checks": {
- "active": {
- "type": "http",
- "timeout": 1,
- "concurrency": 10,
- "host": "httpbin.org",
- "port": 1,
- "http_path": "/",
- "https_verify_certificate": true,
- "req_headers": [
- "user-agent: go/1.20"
], - "healthy": {
- "interval": 1,
- "http_statuses": [
- 200,
- 302
], - "successes": 2
}, - "unhealthy": {
- "interval": 1,
- "http_statuses": [
- 429,
- 404,
- 500,
- 501,
- 502,
- 503,
- 504,
- 505
], - "http_failures": 5,
- "tcp_failures": 2,
- "timeouts": 3
}
}
}
}, - "status": 0
}
{- "value": {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "type": "http",
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "last_published": 1742288230,
- "published_gateway_groups_count": 0,
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:UpdatePublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
service_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the published service. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
op required | string Enum: "add" "replace" The operation to be performed. |
path required | string Path to the field to be replaced or added. Path should follow the JSON Pointer format. |
value required | any Value to be added or replaced. |
[- {
- "op": "add",
- "path": "/name",
- "value": "new-name"
}
]
{- "value": {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "type": "http",
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "last_published": 1742288230,
- "published_gateway_groups_count": 0,
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:DeletePublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
service_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the published service. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
""
IAM Action: gateway:UpdatePublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
service_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the published service. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
required | Array of objects <= 64 items The upstream endpoints. |
name | string [ 1 .. 65536 ] characters Default: "default" The upstream name. |
scheme | string Default: "http" Enum: "http" "https" "grpc" "grpcs" The protocol that is used for communicating with the backend service when the service type is |
desc | string <= 65536 characters The object description. |
type | string Default: "roundrobin" Enum: "chash" "roundrobin" "least_conn" "ewma" Load balancing algorithm to distribute traffic. |
hash_on | string Default: "vars" Enum: "vars" "header" "cookie" "consumer" "vars_combinations" Type of value to hash on when |
key | string non-empty The |
retries | integer [ 0 .. 65535 ] The number of retries while passing the request to an upstream. |
object Upstream keepalive connection pool. | |
object Timeout settings for connecting to, sending, and receiving messages from the upstream, in seconds. | |
retry_timeout | number <float> >= 0 Default: 0 Timeout to continue with retries. Setting this to 0 disables the retry timeout. |
pass_host | string Default: "pass" Enum: "pass" "node" "rewrite" The approach to decide the host header before forwarding requests to an upstream.
|
upstream_host | string^\*?[0-9a-zA-Z-._]+$ Value to rewrite the host header to. Only used if |
object or object Deprecated Replace with | |
client_certificate | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ The object ID. |
ca_certificates | Array of strings[ items [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ ] CA certificates. |
tls_verify | boolean If true, verify TLS. |
Active Check (object) or Passive Check (object) Health check configurations. |
{- "name": "us-west-rsc",
- "scheme": "http",
- "desc": "Object description.",
- "type": "chash",
- "hash_on": "vars",
- "key": "$host",
- "retries": 50,
- "keepalive_pool": {
- "size": 320,
- "idle_timeout": 60,
- "requests": 1000
}, - "timeout": {
- "connect": 60,
- "send": 60,
- "read": 60
}, - "retry_timeout": 0,
- "pass_host": "pass",
- "upstream_host": "httpbin.org",
- "nodes": [
- {
- "host": "httpbin.org",
- "port": 8080,
- "weight": 100
}
], - "service_name": "<ServiceRegistryID>/public/group/httpbin",
- "discovery_type": "nacos",
- "discovery_args": {
- "metadata": {
- "namespace_id": "public",
- "group_name": "DEFAULT_GROUP"
}
}, - "tls": {
- "client_cert": "$secret://aws/john/apisix-secrets/john-key-auth",
- "client_key": "$secret://aws/john/apisix-secrets/john-key-auth"
}, - "client_certificate": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "ca_certificates": [
- "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101"
], - "tls_verify": true,
- "checks": {
- "active": {
- "type": "http",
- "timeout": 1,
- "concurrency": 10,
- "host": "httpbin.org",
- "port": 1,
- "http_path": "/",
- "https_verify_certificate": true,
- "req_headers": [
- "user-agent: go/1.20"
], - "healthy": {
- "interval": 1,
- "http_statuses": [
- 200,
- 302
], - "successes": 2
}, - "unhealthy": {
- "interval": 1,
- "http_statuses": [
- 429,
- 404,
- 500,
- 501,
- 502,
- 503,
- 504,
- 505
], - "http_failures": 5,
- "tcp_failures": 2,
- "timeouts": 3
}
}
}
}
{- "value": {
- "name": "us-west-rsc",
- "scheme": "http",
- "desc": "Object description.",
- "type": "chash",
- "hash_on": "vars",
- "key": "$host",
- "retries": 50,
- "keepalive_pool": {
- "size": 320,
- "idle_timeout": 60,
- "requests": 1000
}, - "timeout": {
- "connect": 60,
- "send": 60,
- "read": 60
}, - "retry_timeout": 0,
- "pass_host": "pass",
- "upstream_host": "httpbin.org",
- "nodes": [
- {
- "host": "httpbin.org",
- "port": 8080,
- "weight": 100,
- "priority": 0
}
], - "service_name": "<ServiceRegistryID>/public/group/httpbin",
- "discovery_type": "nacos",
- "discovery_args": {
- "metadata": {
- "namespace_id": "public",
- "group_name": "DEFAULT_GROUP"
}
}, - "tls": {
- "client_cert": "$secret://aws/john/apisix-secrets/john-key-auth",
- "client_key": "$secret://aws/john/apisix-secrets/john-key-auth"
}, - "client_certificate": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "ca_certificates": [
- "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101"
], - "tls_verify": true,
- "checks": {
- "active": {
- "type": "http",
- "timeout": 1,
- "concurrency": 10,
- "host": "httpbin.org",
- "port": 1,
- "http_path": "/",
- "https_verify_certificate": true,
- "req_headers": [
- "user-agent: go/1.20"
], - "healthy": {
- "interval": 1,
- "http_statuses": [
- 200,
- 302
], - "successes": 2
}, - "unhealthy": {
- "interval": 1,
- "http_statuses": [
- 429,
- 404,
- 500,
- 501,
- 502,
- 503,
- 504,
- 505
], - "http_failures": 5,
- "tcp_failures": 2,
- "timeouts": 3
}
}
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "apisix_service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:GetPublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
service_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the published service. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
order_by | string Default: "created_at" Value: "created_at" |
direction | string Default: "asc" Value: "asc" Order to list the routes by. The sorting index follows the configuration of |
with_publish_info | boolean Default: false If true, include publish information in the response, such as |
{- "list": [
- {
- "name": "us-west-rsc",
- "scheme": "http",
- "desc": "Object description.",
- "type": "chash",
- "hash_on": "vars",
- "key": "$host",
- "retries": 50,
- "keepalive_pool": {
- "size": 320,
- "idle_timeout": 60,
- "requests": 1000
}, - "timeout": {
- "connect": 60,
- "send": 60,
- "read": 60
}, - "retry_timeout": 0,
- "pass_host": "pass",
- "upstream_host": "httpbin.org",
- "nodes": [
- {
- "host": "httpbin.org",
- "port": 8080,
- "weight": 100,
- "priority": 0
}
], - "service_name": "<ServiceRegistryID>/public/group/httpbin",
- "discovery_type": "nacos",
- "discovery_args": {
- "metadata": {
- "namespace_id": "public",
- "group_name": "DEFAULT_GROUP"
}
}, - "tls": {
- "client_cert": "$secret://aws/john/apisix-secrets/john-key-auth",
- "client_key": "$secret://aws/john/apisix-secrets/john-key-auth"
}, - "client_certificate": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "ca_certificates": [
- "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101"
], - "tls_verify": true,
- "checks": {
- "active": {
- "type": "http",
- "timeout": 1,
- "concurrency": 10,
- "host": "httpbin.org",
- "port": 1,
- "http_path": "/",
- "https_verify_certificate": true,
- "req_headers": [
- "user-agent: go/1.20"
], - "healthy": {
- "interval": 1,
- "http_statuses": [
- 200,
- 302
], - "successes": 2
}, - "unhealthy": {
- "interval": 1,
- "http_statuses": [
- 429,
- 404,
- 500,
- 501,
- 502,
- 503,
- 504,
- 505
], - "http_failures": 5,
- "tcp_failures": 2,
- "timeouts": 3
}
}
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "apisix_service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
], - "total": 1
}
IAM Action: gateway:GetPublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
service_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the published service. |
upstream_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the upstream. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
with_publish_info | boolean Default: false If true, include publish information in the response, such as |
{- "value": {
- "name": "us-west-rsc",
- "scheme": "http",
- "desc": "Object description.",
- "type": "chash",
- "hash_on": "vars",
- "key": "$host",
- "retries": 50,
- "keepalive_pool": {
- "size": 320,
- "idle_timeout": 60,
- "requests": 1000
}, - "timeout": {
- "connect": 60,
- "send": 60,
- "read": 60
}, - "retry_timeout": 0,
- "pass_host": "pass",
- "upstream_host": "httpbin.org",
- "nodes": [
- {
- "host": "httpbin.org",
- "port": 8080,
- "weight": 100,
- "priority": 0
}
], - "service_name": "<ServiceRegistryID>/public/group/httpbin",
- "discovery_type": "nacos",
- "discovery_args": {
- "metadata": {
- "namespace_id": "public",
- "group_name": "DEFAULT_GROUP"
}
}, - "tls": {
- "client_cert": "$secret://aws/john/apisix-secrets/john-key-auth",
- "client_key": "$secret://aws/john/apisix-secrets/john-key-auth"
}, - "client_certificate": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "ca_certificates": [
- "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101"
], - "tls_verify": true,
- "checks": {
- "active": {
- "type": "http",
- "timeout": 1,
- "concurrency": 10,
- "host": "httpbin.org",
- "port": 1,
- "http_path": "/",
- "https_verify_certificate": true,
- "req_headers": [
- "user-agent: go/1.20"
], - "healthy": {
- "interval": 1,
- "http_statuses": [
- 200,
- 302
], - "successes": 2
}, - "unhealthy": {
- "interval": 1,
- "http_statuses": [
- 429,
- 404,
- 500,
- 501,
- 502,
- 503,
- 504,
- 505
], - "http_failures": 5,
- "tcp_failures": 2,
- "timeouts": 3
}
}
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "apisix_service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:UpdatePublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
service_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the published service. |
upstream_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the upstream. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
required | Array of objects <= 64 items The upstream endpoints. |
name | string [ 1 .. 65536 ] characters Default: "default" The upstream name. |
scheme | string Default: "http" Enum: "http" "https" "grpc" "grpcs" The protocol that is used for communicating with the backend service when the service type is |
desc | string <= 65536 characters The object description. |
type | string Default: "roundrobin" Enum: "chash" "roundrobin" "least_conn" "ewma" Load balancing algorithm to distribute traffic. |
hash_on | string Default: "vars" Enum: "vars" "header" "cookie" "consumer" "vars_combinations" Type of value to hash on when |
key | string non-empty The |
retries | integer [ 0 .. 65535 ] The number of retries while passing the request to an upstream. |
object Upstream keepalive connection pool. | |
object Timeout settings for connecting to, sending, and receiving messages from the upstream, in seconds. | |
retry_timeout | number <float> >= 0 Default: 0 Timeout to continue with retries. Setting this to 0 disables the retry timeout. |
pass_host | string Default: "pass" Enum: "pass" "node" "rewrite" The approach to decide the host header before forwarding requests to an upstream.
|
upstream_host | string^\*?[0-9a-zA-Z-._]+$ Value to rewrite the host header to. Only used if |
object or object Deprecated Replace with | |
client_certificate | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ The object ID. |
ca_certificates | Array of strings[ items [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ ] CA certificates. |
tls_verify | boolean If true, verify TLS. |
Active Check (object) or Passive Check (object) Health check configurations. |
{- "name": "us-west-rsc",
- "scheme": "http",
- "desc": "Object description.",
- "type": "chash",
- "hash_on": "vars",
- "key": "$host",
- "retries": 50,
- "keepalive_pool": {
- "size": 320,
- "idle_timeout": 60,
- "requests": 1000
}, - "timeout": {
- "connect": 60,
- "send": 60,
- "read": 60
}, - "retry_timeout": 0,
- "pass_host": "pass",
- "upstream_host": "httpbin.org",
- "nodes": [
- {
- "host": "httpbin.org",
- "port": 8080,
- "weight": 100
}
], - "service_name": "<ServiceRegistryID>/public/group/httpbin",
- "discovery_type": "nacos",
- "discovery_args": {
- "metadata": {
- "namespace_id": "public",
- "group_name": "DEFAULT_GROUP"
}
}, - "tls": {
- "client_cert": "$secret://aws/john/apisix-secrets/john-key-auth",
- "client_key": "$secret://aws/john/apisix-secrets/john-key-auth"
}, - "client_certificate": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "ca_certificates": [
- "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101"
], - "tls_verify": true,
- "checks": {
- "active": {
- "type": "http",
- "timeout": 1,
- "concurrency": 10,
- "host": "httpbin.org",
- "port": 1,
- "http_path": "/",
- "https_verify_certificate": true,
- "req_headers": [
- "user-agent: go/1.20"
], - "healthy": {
- "interval": 1,
- "http_statuses": [
- 200,
- 302
], - "successes": 2
}, - "unhealthy": {
- "interval": 1,
- "http_statuses": [
- 429,
- 404,
- 500,
- 501,
- 502,
- 503,
- 504,
- 505
], - "http_failures": 5,
- "tcp_failures": 2,
- "timeouts": 3
}
}
}
}
{- "value": {
- "name": "us-west-rsc",
- "scheme": "http",
- "desc": "Object description.",
- "type": "chash",
- "hash_on": "vars",
- "key": "$host",
- "retries": 50,
- "keepalive_pool": {
- "size": 320,
- "idle_timeout": 60,
- "requests": 1000
}, - "timeout": {
- "connect": 60,
- "send": 60,
- "read": 60
}, - "retry_timeout": 0,
- "pass_host": "pass",
- "upstream_host": "httpbin.org",
- "nodes": [
- {
- "host": "httpbin.org",
- "port": 8080,
- "weight": 100,
- "priority": 0
}
], - "service_name": "<ServiceRegistryID>/public/group/httpbin",
- "discovery_type": "nacos",
- "discovery_args": {
- "metadata": {
- "namespace_id": "public",
- "group_name": "DEFAULT_GROUP"
}
}, - "tls": {
- "client_cert": "$secret://aws/john/apisix-secrets/john-key-auth",
- "client_key": "$secret://aws/john/apisix-secrets/john-key-auth"
}, - "client_certificate": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "ca_certificates": [
- "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101"
], - "tls_verify": true,
- "checks": {
- "active": {
- "type": "http",
- "timeout": 1,
- "concurrency": 10,
- "host": "httpbin.org",
- "port": 1,
- "http_path": "/",
- "https_verify_certificate": true,
- "req_headers": [
- "user-agent: go/1.20"
], - "healthy": {
- "interval": 1,
- "http_statuses": [
- 200,
- 302
], - "successes": 2
}, - "unhealthy": {
- "interval": 1,
- "http_statuses": [
- 429,
- 404,
- 500,
- 501,
- 502,
- 503,
- 504,
- 505
], - "http_failures": 5,
- "tcp_failures": 2,
- "timeouts": 3
}
}
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "apisix_service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:UpdatePublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
service_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the published service. |
upstream_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the upstream. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
op required | string Enum: "add" "replace" The operation to be performed. |
path required | string Path to the field to be replaced or added. Path should follow the JSON Pointer format. |
value required | any Value to be added or replaced. |
[- {
- "op": "add",
- "path": "/name",
- "value": "new-name"
}
]
{- "value": {
- "name": "us-west-rsc",
- "scheme": "http",
- "desc": "Object description.",
- "type": "chash",
- "hash_on": "vars",
- "key": "$host",
- "retries": 50,
- "keepalive_pool": {
- "size": 320,
- "idle_timeout": 60,
- "requests": 1000
}, - "timeout": {
- "connect": 60,
- "send": 60,
- "read": 60
}, - "retry_timeout": 0,
- "pass_host": "pass",
- "upstream_host": "httpbin.org",
- "nodes": [
- {
- "host": "httpbin.org",
- "port": 8080,
- "weight": 100,
- "priority": 0
}
], - "service_name": "<ServiceRegistryID>/public/group/httpbin",
- "discovery_type": "nacos",
- "discovery_args": {
- "metadata": {
- "namespace_id": "public",
- "group_name": "DEFAULT_GROUP"
}
}, - "tls": {
- "client_cert": "$secret://aws/john/apisix-secrets/john-key-auth",
- "client_key": "$secret://aws/john/apisix-secrets/john-key-auth"
}, - "client_certificate": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "ca_certificates": [
- "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101"
], - "tls_verify": true,
- "checks": {
- "active": {
- "type": "http",
- "timeout": 1,
- "concurrency": 10,
- "host": "httpbin.org",
- "port": 1,
- "http_path": "/",
- "https_verify_certificate": true,
- "req_headers": [
- "user-agent: go/1.20"
], - "healthy": {
- "interval": 1,
- "http_statuses": [
- 200,
- 302
], - "successes": 2
}, - "unhealthy": {
- "interval": 1,
- "http_statuses": [
- 429,
- 404,
- 500,
- 501,
- 502,
- 503,
- 504,
- 505
], - "http_failures": 5,
- "tcp_failures": 2,
- "timeouts": 3
}
}
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "apisix_service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:UpdatePublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
service_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the published service. |
upstream_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the upstream. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
{- "value": { }
}
IAM Action: gateway:CreatePublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/*
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
name | string [ 1 .. 65536 ] characters The object name. |
object Key-value pairs of labels. | |
desc | string <= 65536 characters The object description. |
type | string Default: "http" Value: "http" Type of service. |
Array of objects non-empty unique Route configurations. |
{- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "type": "http",
- "routes": [
- {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "methods": [
- "GET"
], - "vars": [
- [
- "arg_version",
- "==",
- "v2"
], - [
- "arg_ttl",
- "<",
- 3600
]
], - "paths": [
- "/get"
], - "priority": 0,
- "enable_websocket": true
}
]
}
{- "value": {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "type": "http",
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "apisix_service_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "version": "1.3.2",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "gateway_group_name": "us-west-rsc",
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "unhealthy_nodes_count": 0,
- "status": 0
}
}
Convert a given OpenAPI Specification to service and route resources without creating these resources.
raw_openapi required | string The raw OpenAPI content. |
{- "raw_openapi": "Raw OpenAPI spec"
}
{- "value": {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "type": "http",
- "routes": [
- {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "methods": [
- "GET"
], - "vars": [
- [
- "arg_version",
- "==",
- "v2"
], - [
- "arg_ttl",
- "<",
- 3600
]
], - "paths": [
- "/get"
], - "priority": 0,
- "enable_websocket": true,
- "timeout": {
- "connect": 60,
- "send": 60,
- "read": 60
}, - "plugins": {
- "key-auth": { }
}
}
]
}
}
IAM Action: gateway:UpdatePublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
name required | string [ 1 .. 65536 ] characters The object name. |
object Key-value pairs of labels. | |
desc | string <= 65536 characters The object description. |
methods | Array of strings [ 1 .. 9 ] items unique Items Enum: "GET" "POST" "PUT" "DELETE" "PATCH" "HEAD" "OPTIONS" "TRACE" The allowed HTTP methods to access the route. If empty, all HTTP methods are allowed. |
vars | Array of any Conditions in the format of APISIX expressions to match requests to routes. Case sensitive when matching a cookie name. |
paths required | Array of strings [ 1 .. 64 ] items [ items [ 1 .. 4096 ] characters ] The URL path(s) (after the service's |
priority | integer Default: 0 Priority of the route. A higher value corresponds to a higher priority. If different Routes matches to the same URI, then the Route with the highest priority will be matched. |
enable_websocket | boolean or null If true, enable Websocket proxying for the route. |
object Timeout settings for connecting to, sending, and receiving messages from the upstream, in seconds. | |
plugins | object Key-value pairs of plugins and their configurations on the object. |
service_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ The service ID. |
{- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "methods": [
- "GET"
], - "vars": [
- [
- "arg_version",
- "==",
- "v2"
], - [
- "arg_ttl",
- "<",
- 3600
]
], - "paths": [
- "/get"
], - "priority": 0,
- "enable_websocket": true,
- "timeout": {
- "connect": 60,
- "send": 60,
- "read": 60
}, - "plugins": {
- "key-auth": { }
}, - "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01"
}
{- "value": {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "methods": [
- "GET"
], - "vars": [
- [
- "arg_version",
- "==",
- "v2"
], - [
- "arg_ttl",
- "<",
- 3600
]
], - "paths": [
- "/get"
], - "priority": 0,
- "enable_websocket": true,
- "timeout": {
- "connect": 60,
- "send": 60,
- "read": 60
}, - "plugins": {
- "key-auth": { }
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:GetPublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
service_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: service_id=bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the published service. |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
order_by | string Default: "updated_at" Enum: "created_at" "updated_at" Index to order resources by. |
search | string Example: search=version%3Dv2 Condition to search resources by. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
with_publish_info | boolean Default: false If true, include publish information in the response, such as |
{- "list": [
- {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "methods": [
- "GET"
], - "vars": [
- [
- "arg_version",
- "==",
- "v2"
], - [
- "arg_ttl",
- "<",
- 3600
]
], - "paths": [
- "/get"
], - "priority": 0,
- "enable_websocket": true,
- "timeout": {
- "connect": 60,
- "send": 60,
- "read": 60
}, - "plugins": {
- "key-auth": { }
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
], - "total": 1
}
IAM Action: gateway:GetPublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
route_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the published route. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
with_publish_info | boolean Default: false If true, include publish information in the response, such as |
{- "value": {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "methods": [
- "GET"
], - "vars": [
- [
- "arg_version",
- "==",
- "v2"
], - [
- "arg_ttl",
- "<",
- 3600
]
], - "paths": [
- "/get"
], - "priority": 0,
- "enable_websocket": true,
- "timeout": {
- "connect": 60,
- "send": 60,
- "read": 60
}, - "plugins": {
- "key-auth": { }
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:UpdatePublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
route_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the published route. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
name required | string [ 1 .. 65536 ] characters The object name. |
object Key-value pairs of labels. | |
desc | string <= 65536 characters The object description. |
methods | Array of strings [ 1 .. 9 ] items unique Items Enum: "GET" "POST" "PUT" "DELETE" "PATCH" "HEAD" "OPTIONS" "TRACE" The allowed HTTP methods to access the route. If empty, all HTTP methods are allowed. |
vars | Array of any Conditions in the format of APISIX expressions to match requests to routes. Case sensitive when matching a cookie name. |
paths required | Array of strings [ 1 .. 64 ] items [ items [ 1 .. 4096 ] characters ] The URL path(s) (after the service's |
priority | integer Default: 0 Priority of the route. A higher value corresponds to a higher priority. If different Routes matches to the same URI, then the Route with the highest priority will be matched. |
enable_websocket | boolean or null If true, enable Websocket proxying for the route. |
object Timeout settings for connecting to, sending, and receiving messages from the upstream, in seconds. | |
plugins | object Key-value pairs of plugins and their configurations on the object. |
service_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ The service ID. |
{- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "methods": [
- "GET"
], - "vars": [
- [
- "arg_version",
- "==",
- "v2"
], - [
- "arg_ttl",
- "<",
- 3600
]
], - "paths": [
- "/get"
], - "priority": 0,
- "enable_websocket": true,
- "timeout": {
- "connect": 60,
- "send": 60,
- "read": 60
}, - "plugins": {
- "key-auth": { }
}, - "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01"
}
{- "value": {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "methods": [
- "GET"
], - "vars": [
- [
- "arg_version",
- "==",
- "v2"
], - [
- "arg_ttl",
- "<",
- 3600
]
], - "paths": [
- "/get"
], - "priority": 0,
- "enable_websocket": true,
- "timeout": {
- "connect": 60,
- "send": 60,
- "read": 60
}, - "plugins": {
- "key-auth": { }
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:UpdatePublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
route_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the published route. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
op required | string Enum: "add" "replace" The operation to be performed. |
path required | string Path to the field to be replaced or added. Path should follow the JSON Pointer format. |
value required | any Value to be added or replaced. |
[- {
- "op": "add",
- "path": "/name",
- "value": "new-name"
}
]
{- "value": {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "methods": [
- "GET"
], - "vars": [
- [
- "arg_version",
- "==",
- "v2"
], - [
- "arg_ttl",
- "<",
- 3600
]
], - "paths": [
- "/get"
], - "priority": 0,
- "enable_websocket": true,
- "timeout": {
- "connect": 60,
- "send": 60,
- "read": 60
}, - "plugins": {
- "key-auth": { }
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:UpdatePublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
route_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the published route. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
""
IAM Action: gateway:UpdatePublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
name required | string [ 1 .. 65536 ] characters The object name. |
object Key-value pairs of labels. | |
desc | string <= 65536 characters The object description. |
IPv4 (string) or IPv4/CIDR (string) or IPv6 (string) or IPv6/CIDR (string) Client address filter. If the client request does not originate from | |
(IPAddress (IPv4 (string) or IPv4/CIDR (string) or IPv6 (string) or IPv6/CIDR (string))) or Domain (string) Stream server address. | |
server_port | integer <= 65535 Stream server port. |
plugins | object Key-value pairs of plugins and their configurations on the object. |
service_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ The service ID. |
{- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "remote_addr": "127.0.0.1",
- "server_addr": "mysql",
- "server_port": 3306,
- "plugins": {
- "ip-restriction": {
- "whitelist": [
- "192.168.0.1/24"
], - "message": "Access denied"
}
}, - "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01"
}
{- "value": {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "remote_addr": "127.0.0.1",
- "server_addr": "mysql",
- "server_port": 3306,
- "plugins": {
- "ip-restriction": {
- "whitelist": [
- "192.168.0.1/24"
], - "message": "Access denied"
}
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "gateway_group_name": "us-west-rsc",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:GetPublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
service_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: service_id=bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the published service. |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
order_by | string Default: "updated_at" Enum: "created_at" "updated_at" Index to order resources by. |
search | string Example: search=version%3Dv2 Condition to search resources by. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
with_publish_info | boolean Default: false If true, include publish information in the response, such as |
{- "list": [
- {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "remote_addr": "127.0.0.1",
- "server_addr": "mysql",
- "server_port": 3306,
- "plugins": {
- "ip-restriction": {
- "whitelist": [
- "192.168.0.1/24"
], - "message": "Access denied"
}
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "gateway_group_name": "us-west-rsc",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
], - "total": 1
}
IAM Action: gateway:GetPublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
stream_route_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the published stream route. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
with_publish_info | boolean Default: false If true, include publish information in the response, such as |
{- "value": {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "remote_addr": "127.0.0.1",
- "server_addr": "mysql",
- "server_port": 3306,
- "plugins": {
- "ip-restriction": {
- "whitelist": [
- "192.168.0.1/24"
], - "message": "Access denied"
}
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "gateway_group_name": "us-west-rsc",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:UpdatePublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
stream_route_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the published stream route. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
name required | string [ 1 .. 65536 ] characters The object name. |
object Key-value pairs of labels. | |
desc | string <= 65536 characters The object description. |
IPv4 (string) or IPv4/CIDR (string) or IPv6 (string) or IPv6/CIDR (string) Client address filter. If the client request does not originate from | |
(IPAddress (IPv4 (string) or IPv4/CIDR (string) or IPv6 (string) or IPv6/CIDR (string))) or Domain (string) Stream server address. | |
server_port | integer <= 65535 Stream server port. |
plugins | object Key-value pairs of plugins and their configurations on the object. |
service_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ The service ID. |
{- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "remote_addr": "127.0.0.1",
- "server_addr": "mysql",
- "server_port": 3306,
- "plugins": {
- "ip-restriction": {
- "whitelist": [
- "192.168.0.1/24"
], - "message": "Access denied"
}
}, - "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01"
}
{- "value": {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "remote_addr": "127.0.0.1",
- "server_addr": "mysql",
- "server_port": 3306,
- "plugins": {
- "ip-restriction": {
- "whitelist": [
- "192.168.0.1/24"
], - "message": "Access denied"
}
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "gateway_group_name": "us-west-rsc",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:UpdatePublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
stream_route_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the published stream route. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
""
IAM Action: gateway:GetPublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
Deprecated, you can use GET /apisix/admin/services
for instead.
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
unhealthy_nodes | Array of strings Items Enum: "unhealthy_nodes_exists" "no_unhealthy_nodes" Filter of services based on whether unhealthy nodes exist. |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
order_by | string Default: "updated_at" Enum: "created_at" "updated_at" "publish_time" "name" Index to order published services by. |
search | string Example: search=version%3Dv2 Condition to search resources by. |
labels | string non-empty Example: labels=labels%5Bversion%5D=v2 Label(s) to filter resources by. The format is |
hosts | Array of strings[ items^\*?[0-9a-zA-Z-._]+$ ] Example: hosts=httpbin.org |
type | Array of strings Items Enum: "http" "stream" Type of service. |
{- "list": [
- {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "type": "http",
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "apisix_service_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "version": "1.3.2",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "gateway_group_name": "us-west-rsc",
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "unhealthy_nodes_count": 0,
- "status": 0
}
], - "total": 1
}
IAM Action: gateway:GetPublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
service_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service template. |
{- "value": {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "type": "http",
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "apisix_service_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "version": "1.3.2",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "gateway_group_name": "us-west-rsc",
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "unhealthy_nodes_count": 0,
- "status": 0
}
}
IAM Action: gateway:DeletePublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
service_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service template. |
""
IAM Action: gateway:GetPublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
service_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service template. |
{- "value": {
- "raw_openapi": "Raw OpenAPI spec",
- "api_count": 10,
- "api_desc": "OAS description."
}
}
IAM Action: gateway:UpdatePublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
service_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service template. |
raw_openapi | string The raw OpenAPI spec of the service. |
{- "raw_openapi": "Raw OpenAPI spec"
}
{- "value": {
- "raw_openapi": "Raw OpenAPI spec",
- "api_count": 10,
- "api_desc": "OAS description."
}
}
IAM Action: gateway:GetPublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
service_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service template. |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
order_by | string Default: "updated_at" Enum: "created_at" "updated_at" Index to order resources by. |
{- "list": [
- {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "methods": [
- "GET"
], - "vars": [
- [
- "arg_version",
- "==",
- "v2"
], - [
- "arg_ttl",
- "<",
- 3600
]
], - "paths": [
- "/get"
], - "priority": 0,
- "enable_websocket": true,
- "timeout": {
- "connect": 60,
- "send": 60,
- "read": 60
}, - "plugins": {
- "key-auth": { }
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "route_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_version_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101"
}
], - "total": 1
}
IAM Action: gateway:GetPublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
service_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service template. |
route_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the route in the service template. |
{- "value": {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "methods": [
- "GET"
], - "vars": [
- [
- "arg_version",
- "==",
- "v2"
], - [
- "arg_ttl",
- "<",
- 3600
]
], - "paths": [
- "/get"
], - "priority": 0,
- "enable_websocket": true,
- "timeout": {
- "connect": 60,
- "send": 60,
- "read": 60
}, - "plugins": {
- "key-auth": { }
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "route_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_version_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101"
}
}
IAM Action: gateway:GetPublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
service_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service template. |
route_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the route in the service template. |
{- "value": {
- "timeout": {
- "connect": 60,
- "send": 60,
- "read": 60
}, - "plugins": {
- "key-auth": { }
}
}
}
IAM Action: gateway:UpdatePublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
service_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service template. |
route_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the route in the service template. |
op required | string Enum: "add" "replace" The operation to be performed. |
path required | string Path to the field to be replaced or added. Path should follow the JSON Pointer format. |
value required | any Value to be added or replaced. |
[- {
- "op": "add",
- "path": "/name",
- "value": "new-name"
}
]
{- "value": {
- "timeout": {
- "connect": 60,
- "send": 60,
- "read": 60
}, - "plugins": {
- "key-auth": { }
}
}
}
IAM Action: gateway:GetPublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
service_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service template. |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
order_by | string Default: "updated_at" Enum: "created_at" "updated_at" Index to order resources by. |
{- "list": [
- {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "remote_addr": "127.0.0.1",
- "server_addr": "mysql",
- "server_port": 3306,
- "plugins": {
- "ip-restriction": {
- "whitelist": [
- "192.168.0.1/24"
], - "message": "Access denied"
}
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "stream_route_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_version_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101"
}
], - "total": 1
}
IAM Action: gateway:GetPublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
service_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service template. |
stream_route_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the stream route in the service template. |
{- "value": {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "remote_addr": "127.0.0.1",
- "server_addr": "mysql",
- "server_port": 3306,
- "plugins": {
- "ip-restriction": {
- "whitelist": [
- "192.168.0.1/24"
], - "message": "Access denied"
}
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "stream_route_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_version_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101"
}
}
IAM Action: gateway:GetPublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
service_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service template. |
stream_route_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the stream route in the service template. |
{- "value": {
- "plugins": {
- "key-auth": { }
}
}
}
IAM Action: gateway:UpdatePublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
service_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service template. |
stream_route_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the stream route in the service template. |
op required | string Enum: "add" "replace" The operation to be performed. |
path required | string Path to the field to be replaced or added. Path should follow the JSON Pointer format. |
value required | any Value to be added or replaced. |
[- {
- "op": "add",
- "path": "/name",
- "value": "new-name"
}
]
{- "value": {
- "plugins": {
- "key-auth": { }
}
}
}
IAM Action: gateway:GetPublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
service_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service template. |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
order_by | string Default: "publish_time" Value: "publish_time" Index to order resources by. |
{- "list": [
- {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "type": "http",
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "apisix_service_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "version": "1.3.2",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "publish_time": 1742288232
}
], - "total": 1
}
IAM Action: gateway:GetPublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
service_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service template. |
{- "value": {
- "hosts": [
- "httpbin.org"
], - "path_prefix": "/test",
- "strip_path_prefix": true,
- "upstream": {
- "name": "us-west-rsc",
- "scheme": "http",
- "desc": "Object description.",
- "type": "chash",
- "hash_on": "vars",
- "key": "$host",
- "retries": 50,
- "keepalive_pool": {
- "size": 320,
- "idle_timeout": 60,
- "requests": 1000
}, - "timeout": {
- "connect": 60,
- "send": 60,
- "read": 60
}, - "retry_timeout": 0,
- "pass_host": "pass",
- "upstream_host": "httpbin.org",
- "nodes": [
- {
- "host": "httpbin.org",
- "port": 8080,
- "weight": 100,
- "priority": 0
}
], - "service_name": "<ServiceRegistryID>/public/group/httpbin",
- "discovery_type": "nacos",
- "discovery_args": {
- "metadata": {
- "namespace_id": "public",
- "group_name": "DEFAULT_GROUP"
}
}, - "tls": {
- "client_cert": "$secret://aws/john/apisix-secrets/john-key-auth",
- "client_key": "$secret://aws/john/apisix-secrets/john-key-auth"
}, - "client_certificate": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "ca_certificates": [
- "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101"
], - "tls_verify": true,
- "checks": {
- "active": {
- "type": "http",
- "timeout": 1,
- "concurrency": 10,
- "host": "httpbin.org",
- "port": 1,
- "http_path": "/",
- "https_verify_certificate": true,
- "req_headers": [
- "user-agent: go/1.20"
], - "healthy": {
- "interval": 1,
- "http_statuses": [
- 200,
- 302
], - "successes": 2
}, - "unhealthy": {
- "interval": 1,
- "http_statuses": [
- 429,
- 404,
- 500,
- 501,
- 502,
- 503,
- 504,
- 505
], - "http_failures": 5,
- "tcp_failures": 2,
- "timeouts": 3
}
}
}
}, - "status": 0,
- "plugins": {
- "key-auth": { }
}
}
}
IAM Action: gateway:UpdatePublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
service_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service template. |
dry-run | string Value: "all" When specified, run the operation in dry-run mode. |
op required | string Enum: "add" "replace" The operation to be performed. |
path required | string Path to the field to be replaced or added. Path should follow the JSON Pointer format. |
value required | any Value to be added or replaced. |
[- {
- "op": "add",
- "path": "/name",
- "value": "new-name"
}
]
{- "value": {
- "hosts": [
- "httpbin.org"
], - "path_prefix": "/test",
- "strip_path_prefix": true,
- "upstream": {
- "name": "us-west-rsc",
- "scheme": "http",
- "desc": "Object description.",
- "type": "chash",
- "hash_on": "vars",
- "key": "$host",
- "retries": 50,
- "keepalive_pool": {
- "size": 320,
- "idle_timeout": 60,
- "requests": 1000
}, - "timeout": {
- "connect": 60,
- "send": 60,
- "read": 60
}, - "retry_timeout": 0,
- "pass_host": "pass",
- "upstream_host": "httpbin.org",
- "nodes": [
- {
- "host": "httpbin.org",
- "port": 8080,
- "weight": 100,
- "priority": 0
}
], - "service_name": "<ServiceRegistryID>/public/group/httpbin",
- "discovery_type": "nacos",
- "discovery_args": {
- "metadata": {
- "namespace_id": "public",
- "group_name": "DEFAULT_GROUP"
}
}, - "tls": {
- "client_cert": "$secret://aws/john/apisix-secrets/john-key-auth",
- "client_key": "$secret://aws/john/apisix-secrets/john-key-auth"
}, - "client_certificate": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "ca_certificates": [
- "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101"
], - "tls_verify": true,
- "checks": {
- "active": {
- "type": "http",
- "timeout": 1,
- "concurrency": 10,
- "host": "httpbin.org",
- "port": 1,
- "http_path": "/",
- "https_verify_certificate": true,
- "req_headers": [
- "user-agent: go/1.20"
], - "healthy": {
- "interval": 1,
- "http_statuses": [
- 200,
- 302
], - "successes": 2
}, - "unhealthy": {
- "interval": 1,
- "http_statuses": [
- 429,
- 404,
- 500,
- 501,
- 502,
- 503,
- 504,
- 505
], - "http_failures": 5,
- "tcp_failures": 2,
- "timeouts": 3
}
}
}
}, - "status": 0,
- "plugins": {
- "key-auth": { }
}
}
}
IAM Action: gateway:GetPublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
service_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service template. |
{- "value": {
- "httpbin.com:80": {
- "host": "httpbin.com",
- "port": 80,
- "total": 1,
- "healthy": 1,
- "unhealthy": 0,
- "unknown": 0,
- "updated_at": 1750150319,
- "gateway_instances": [
- {
- "id": "xxx-yyy-zzz",
- "hostname": "api7ee3-apisix-699b68db7f-cxgcw",
- "status": "healthy",
- "created_at": 1750150300,
- "updated_at": 1750150335
}
]
}
}
}
IAM Action: gateway:GetServiceRegistry
, Resource: arn:api7:gateway:gatewaygroup/%s
service_registry_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Service registry ID. |
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
order_by | string Default: "updated_at" Enum: "created_at" "updated_at" "publish_time" "name" Index to order published services by. |
{- "list": [
- {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "type": "http",
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "apisix_service_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "version": "1.3.2",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "gateway_group_name": "us-west-rsc",
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "unhealthy_nodes_count": 0,
- "status": 0
}
], - "total": 1
}
create_new_version | boolean If true, create a new service version. |
gateway_group_id | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ The gateway group ID. |
Array of objects non-empty Services configurations. |
{- "create_new_version": true,
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "services": [
- {
- "name": "us-west-rsc",
- "hosts": [
- "httpbin.org"
], - "path_prefix": "/test",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "version": "string",
- "service_version_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "status": 0,
- "routes": [
- {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "methods": [
- "GET"
], - "vars": [
- [
- "arg_version",
- "==",
- "v2"
], - [
- "arg_ttl",
- "<",
- 3600
]
], - "paths": [
- "/get"
], - "priority": 0,
- "enable_websocket": true,
- "timeout": {
- "connect": 60,
- "send": 60,
- "read": 60
}, - "plugins": {
- "key-auth": { }
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01"
}
]
}
]
}
{- "value": {
- "duplicate": [
- [
- {
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "service_name": "httpbin-svc",
- "route_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "route_name": "httpbin-route",
- "url": "/test"
}
]
], - "overlapping": [
- [
- {
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "service_name": "httpbin-svc",
- "route_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "route_name": "httpbin-route",
- "url": "/test"
}
]
]
}
}
IAM Action: gateway:CreateServiceTemplate
, Resource: arn:api7:gateway:servicetemplate/*
name required | string [ 1 .. 65536 ] characters The object name. |
object Key-value pairs of labels. | |
desc | string <= 65536 characters The object description. |
type | string Default: "http" Enum: "http" "stream" Type of service. |
{- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "type": "http"
}
{- "value": {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "type": "http",
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "last_published": 1742288230,
- "published_gateway_groups_count": 0,
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:GetServiceTemplate
, Resource: arn:api7:gateway:servicetemplate/%s
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
order_by | string Default: "updated_at" Enum: "created_at" "updated_at" "last_published" "name" Index to order the services by. |
search | string Example: search=version%3Dv2 Condition to search resources by. |
labels | string non-empty Example: labels=labels%5Bversion%5D=v2 Label(s) to filter resources by. The format is |
gateway_group_id | string >= 1 Gateway group ID. |
last_publish_start_at | integer >= 0 |
last_publish_end_at | integer >= 0 |
type | string Enum: "http" "stream" Example: type=http Type of service. |
{- "list": [
- {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "type": "http",
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "last_published": 1742288230,
- "published_gateway_groups_count": 0,
- "created_at": 1742288232,
- "updated_at": 1742288235
}
], - "total": 1
}
IAM Action: gateway:GetServiceTemplate
, Resource: arn:api7:gateway:servicetemplate/%s
service_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service template. |
{- "value": {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "type": "http",
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "last_published": 1742288230,
- "published_gateway_groups_count": 0,
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:UpdateServiceTemplate
, Resource: arn:api7:gateway:servicetemplate/%s
service_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service template. |
name required | string [ 1 .. 65536 ] characters The object name. |
object Key-value pairs of labels. | |
desc | string <= 65536 characters The object description. |
type | string Default: "http" Enum: "http" "stream" Type of service. |
{- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "type": "http"
}
{- "value": {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "type": "http",
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "last_published": 1742288230,
- "published_gateway_groups_count": 0,
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:UpdateServiceTemplate
, Resource: arn:api7:gateway:servicetemplate/%s
service_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service template. |
dry-run | string Value: "all" When specified, run the operation in dry-run mode. |
op required | string Enum: "add" "replace" The operation to be performed. |
path required | string Path to the field to be replaced or added. Path should follow the JSON Pointer format. |
value required | any Value to be added or replaced. |
[- {
- "op": "add",
- "path": "/name",
- "value": "new-name"
}
]
{- "value": {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "type": "http",
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "last_published": 1742288230,
- "published_gateway_groups_count": 0,
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:DeleteServiceTemplate
, Resource: arn:api7:gateway:servicetemplate/%s
service_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service template. |
""
IAM Action: gateway:GetServiceTemplate
, Resource: arn:api7:gateway:servicetemplate/%s
service_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service template. |
{- "value": {
- "raw_openapi": "Raw OpenAPI spec",
- "api_count": 10,
- "api_desc": "OAS description."
}
}
IAM Action: gateway:UpdateServiceTemplate
, Resource: arn:api7:gateway:servicetemplate/%s
service_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service template. |
raw_openapi | string The raw OpenAPI spec of the service. |
{- "raw_openapi": "Raw OpenAPI spec"
}
{- "value": {
- "raw_openapi": "Raw OpenAPI spec",
- "api_count": 10,
- "api_desc": "OAS description."
}
}
IAM Action: gateway:GetServiceTemplate
, Resource: arn:api7:gateway:servicetemplate/%s
scope | string Enum: "partial" "all" Scope of the service. |
service_ids | Array of strings[ items [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ ] The service ID list. |
required | object API metadata. |
Array of objects An array of one or more base servers in the exported API definition. |
{- "service_ids": [
- "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101"
], - "info": {
- "title": "Swagger Petstore",
- "version": "3.0.1",
- "description": "API description."
},
}
{- "value": {
- "openapi": "3.0.1",
- "info": {
- "title": "Swagger Petstore",
- "version": "3.0.1",
- "description": "API description."
}, - "paths": {
- "/anything": {
- "delete": {
- "responses": {
- "default": {
- "description": ""
}
}, - "tags": [
- "httpbin"
]
}, - "get": {
- "responses": {
- "default": {
- "description": ""
}
}, - "tags": [
- "httpbin"
]
}, - "patch": {
- "responses": {
- "default": {
- "description": ""
}
}, - "tags": [
- "httpbin"
]
}, - "post": {
- "responses": {
- "default": {
- "description": ""
}
}, - "tags": [
- "httpbin"
]
}, - "put": {
- "responses": {
- "default": {
- "description": ""
}
}, - "tags": [
- "httpbin"
]
}, - "trace": {
- "responses": {
- "default": {
- "description": ""
}
}, - "tags": [
- "httpbin"
]
}
}
}
}
}
IAM Action: gateway:CreateServiceTemplate
, Resource: arn:api7:gateway:servicetemplate/*
name | string [ 1 .. 65536 ] characters The object name. |
object Key-value pairs of labels. | |
desc | string <= 65536 characters The object description. |
type | string Default: "http" Value: "http" Type of service. |
Array of objects non-empty unique Route configurations. |
{- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "type": "http",
- "routes": [
- {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "methods": [
- "GET"
], - "vars": [
- [
- "arg_version",
- "==",
- "v2"
], - [
- "arg_ttl",
- "<",
- 3600
]
], - "paths": [
- "/get"
], - "priority": 0,
- "enable_websocket": true
}
]
}
{- "value": {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "type": "http",
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "last_published": 1742288230,
- "published_gateway_groups_count": 0,
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "routes": [
- {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "methods": [
- "GET"
], - "vars": [
- [
- "arg_version",
- "==",
- "v2"
], - [
- "arg_ttl",
- "<",
- 3600
]
], - "paths": [
- "/get"
], - "priority": 0,
- "enable_websocket": true,
- "timeout": {
- "connect": 60,
- "send": 60,
- "read": 60
}, - "plugins": {
- "key-auth": { }
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
]
}
}
Convert a given OpenAPI Specification to service and route resources without creating these resources.
raw_openapi required | string The raw OpenAPI content. |
{- "raw_openapi": "Raw OpenAPI spec"
}
{- "value": {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "type": "http",
- "routes": [
- {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "methods": [
- "GET"
], - "vars": [
- [
- "arg_version",
- "==",
- "v2"
], - [
- "arg_ttl",
- "<",
- 3600
]
], - "paths": [
- "/get"
], - "priority": 0,
- "enable_websocket": true,
- "timeout": {
- "connect": 60,
- "send": 60,
- "read": 60
}, - "plugins": {
- "key-auth": { }
}
}
]
}
}
IAM Action: gateway:UpdateServiceTemplate
, Resource: arn:api7:gateway:servicetemplate/%s
name required | string [ 1 .. 65536 ] characters The object name. |
object Key-value pairs of labels. | |
desc | string <= 65536 characters The object description. |
methods | Array of strings [ 1 .. 9 ] items unique Items Enum: "GET" "POST" "PUT" "DELETE" "PATCH" "HEAD" "OPTIONS" "TRACE" The allowed HTTP methods to access the route. If empty, all HTTP methods are allowed. |
vars | Array of any Conditions in the format of APISIX expressions to match requests to routes. Case sensitive when matching a cookie name. |
paths required | Array of strings [ 1 .. 64 ] items [ items [ 1 .. 4096 ] characters ] The URL path(s) (after the service's |
priority | integer Default: 0 Priority of the route. A higher value corresponds to a higher priority. If different Routes matches to the same URI, then the Route with the highest priority will be matched. |
enable_websocket | boolean or null If true, enable Websocket proxying for the route. |
service_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ The service ID. |
{- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "methods": [
- "GET"
], - "vars": [
- [
- "arg_version",
- "==",
- "v2"
], - [
- "arg_ttl",
- "<",
- 3600
]
], - "paths": [
- "/get"
], - "priority": 0,
- "enable_websocket": true,
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01"
}
{- "value": {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "methods": [
- "GET"
], - "vars": [
- [
- "arg_version",
- "==",
- "v2"
], - [
- "arg_ttl",
- "<",
- 3600
]
], - "paths": [
- "/get"
], - "priority": 0,
- "enable_websocket": true,
- "timeout": {
- "connect": 60,
- "send": 60,
- "read": 60
}, - "plugins": {
- "key-auth": { }
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:GetServiceTemplate
, Resource: arn:api7:gateway:servicetemplate/%s
service_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: service_id=bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service template. |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
order_by | string Default: "updated_at" Enum: "created_at" "updated_at" Index to order resources by. |
search | string Example: search=version%3Dv2 Condition to search resources by. |
labels | string non-empty Example: labels=labels%5Bversion%5D=v2 Label(s) to filter resources by. The format is |
{- "list": [
- {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "methods": [
- "GET"
], - "vars": [
- [
- "arg_version",
- "==",
- "v2"
], - [
- "arg_ttl",
- "<",
- 3600
]
], - "paths": [
- "/get"
], - "priority": 0,
- "enable_websocket": true,
- "timeout": {
- "connect": 60,
- "send": 60,
- "read": 60
}, - "plugins": {
- "key-auth": { }
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
], - "total": 1
}
IAM Action: gateway:GetServiceTemplate
, Resource: arn:api7:gateway:servicetemplate/%s
route_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the route in the service template. |
{- "value": {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "methods": [
- "GET"
], - "vars": [
- [
- "arg_version",
- "==",
- "v2"
], - [
- "arg_ttl",
- "<",
- 3600
]
], - "paths": [
- "/get"
], - "priority": 0,
- "enable_websocket": true,
- "timeout": {
- "connect": 60,
- "send": 60,
- "read": 60
}, - "plugins": {
- "key-auth": { }
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:UpdateServiceTemplate
, Resource: arn:api7:gateway:servicetemplate/%s
route_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the route in the service template. |
name required | string [ 1 .. 65536 ] characters The object name. |
object Key-value pairs of labels. | |
desc | string <= 65536 characters The object description. |
methods | Array of strings [ 1 .. 9 ] items unique Items Enum: "GET" "POST" "PUT" "DELETE" "PATCH" "HEAD" "OPTIONS" "TRACE" The allowed HTTP methods to access the route. If empty, all HTTP methods are allowed. |
vars | Array of any Conditions in the format of APISIX expressions to match requests to routes. Case sensitive when matching a cookie name. |
paths required | Array of strings [ 1 .. 64 ] items [ items [ 1 .. 4096 ] characters ] The URL path(s) (after the service's |
priority | integer Default: 0 Priority of the route. A higher value corresponds to a higher priority. If different Routes matches to the same URI, then the Route with the highest priority will be matched. |
enable_websocket | boolean or null If true, enable Websocket proxying for the route. |
object Timeout settings for connecting to, sending, and receiving messages from the upstream, in seconds. | |
plugins | object Key-value pairs of plugins and their configurations on the object. |
service_id | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ The service ID. |
{- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "methods": [
- "GET"
], - "vars": [
- [
- "arg_version",
- "==",
- "v2"
], - [
- "arg_ttl",
- "<",
- 3600
]
], - "paths": [
- "/get"
], - "priority": 0,
- "enable_websocket": true,
- "timeout": {
- "connect": 60,
- "send": 60,
- "read": 60
}, - "plugins": {
- "key-auth": { }
}, - "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01"
}
{- "value": {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "methods": [
- "GET"
], - "vars": [
- [
- "arg_version",
- "==",
- "v2"
], - [
- "arg_ttl",
- "<",
- 3600
]
], - "paths": [
- "/get"
], - "priority": 0,
- "enable_websocket": true,
- "timeout": {
- "connect": 60,
- "send": 60,
- "read": 60
}, - "plugins": {
- "key-auth": { }
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:UpdateServiceTemplate
, Resource: arn:api7:gateway:servicetemplate/%s
route_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the route in the service template. |
op required | string Enum: "add" "replace" The operation to be performed. |
path required | string Path to the field to be replaced or added. Path should follow the JSON Pointer format. |
value required | any Value to be added or replaced. |
[- {
- "op": "add",
- "path": "/name",
- "value": "new-name"
}
]
{- "value": {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "methods": [
- "GET"
], - "vars": [
- [
- "arg_version",
- "==",
- "v2"
], - [
- "arg_ttl",
- "<",
- 3600
]
], - "paths": [
- "/get"
], - "priority": 0,
- "enable_websocket": true,
- "timeout": {
- "connect": 60,
- "send": 60,
- "read": 60
}, - "plugins": {
- "key-auth": { }
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:UpdateServiceTemplate
, Resource: arn:api7:gateway:servicetemplate/%s
route_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the route in the service template. |
""
IAM Action: gateway:UpdateServiceTemplate
, Resource: arn:api7:gateway:servicetemplate/%s
name required | string [ 1 .. 65536 ] characters The object name. |
object Key-value pairs of labels. | |
desc | string <= 65536 characters The object description. |
IPv4 (string) or IPv4/CIDR (string) or IPv6 (string) or IPv6/CIDR (string) Client address filter. If the client request does not originate from | |
(IPAddress (IPv4 (string) or IPv4/CIDR (string) or IPv6 (string) or IPv6/CIDR (string))) or Domain (string) Stream server address. | |
server_port | integer <= 65535 Stream server port. |
service_id | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ The service ID. |
{- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "remote_addr": "127.0.0.1",
- "server_addr": "mysql",
- "server_port": 3306,
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01"
}
{- "value": {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "remote_addr": "127.0.0.1",
- "server_addr": "mysql",
- "server_port": 3306,
- "plugins": {
- "ip-restriction": {
- "whitelist": [
- "192.168.0.1/24"
], - "message": "Access denied"
}
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "gateway_group_name": "us-west-rsc",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:GetServiceTemplate
, Resource: arn:api7:gateway:servicetemplate/%s
service_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: service_id=bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service template. |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
order_by | string Default: "updated_at" Enum: "created_at" "updated_at" Index to order resources by. |
search | string Example: search=version%3Dv2 Condition to search resources by. |
labels | string non-empty Example: labels=labels%5Bversion%5D=v2 Label(s) to filter resources by. The format is |
{- "list": [
- {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "remote_addr": "127.0.0.1",
- "server_addr": "mysql",
- "server_port": 3306,
- "plugins": {
- "ip-restriction": {
- "whitelist": [
- "192.168.0.1/24"
], - "message": "Access denied"
}
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "gateway_group_name": "us-west-rsc",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
], - "total": 1
}
IAM Action: gateway:GetServiceTemplate
, Resource: arn:api7:gateway:servicetemplate/%s
stream_route_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the stream route in the service template. |
{- "value": {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "remote_addr": "127.0.0.1",
- "server_addr": "mysql",
- "server_port": 3306,
- "plugins": {
- "ip-restriction": {
- "whitelist": [
- "192.168.0.1/24"
], - "message": "Access denied"
}
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "gateway_group_name": "us-west-rsc",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:UpdateServiceTemplate
, Resource: arn:api7:gateway:servicetemplate/%s
stream_route_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the stream route in the service template. |
name required | string [ 1 .. 65536 ] characters The object name. |
object Key-value pairs of labels. | |
desc | string <= 65536 characters The object description. |
IPv4 (string) or IPv4/CIDR (string) or IPv6 (string) or IPv6/CIDR (string) Client address filter. If the client request does not originate from | |
(IPAddress (IPv4 (string) or IPv4/CIDR (string) or IPv6 (string) or IPv6/CIDR (string))) or Domain (string) Stream server address. | |
server_port | integer <= 65535 Stream server port. |
plugins | object Key-value pairs of plugins and their configurations on the object. |
service_id | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ The service ID. |
{- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "remote_addr": "127.0.0.1",
- "server_addr": "mysql",
- "server_port": 3306,
- "plugins": {
- "ip-restriction": {
- "whitelist": [
- "192.168.0.1/24"
], - "message": "Access denied"
}
}, - "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01"
}
{- "value": {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "remote_addr": "127.0.0.1",
- "server_addr": "mysql",
- "server_port": 3306,
- "plugins": {
- "ip-restriction": {
- "whitelist": [
- "192.168.0.1/24"
], - "message": "Access denied"
}
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "gateway_group_name": "us-west-rsc",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:UpdateServiceTemplate
, Resource: arn:api7:gateway:servicetemplate/%s
stream_route_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the stream route in the service template. |
""
IAM Action: gateway:GetServiceTemplate
, Resource: arn:api7:gateway:servicetemplate/%s
service_version_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service version. |
{- "value": {
- "raw_openapi": "Raw OpenAPI spec",
- "api_count": 10,
- "api_desc": "OAS description."
}
}
The service version can be found by listing all service versions.
IAM Action: gateway:GetServiceTemplate
, Resource: arn:api7:gateway:servicetemplate/%s
service_version_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service version. |
{- "value": {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "type": "http",
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "apisix_service_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "version": "1.3.2",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:GetServiceTemplate
, Resource: arn:api7:gateway:servicetemplate/%s
service_version_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service version. |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
order_by | string Default: "updated_at" Enum: "created_at" "updated_at" Index to order resources by. |
{- "list": [
- {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "methods": [
- "GET"
], - "vars": [
- [
- "arg_version",
- "==",
- "v2"
], - [
- "arg_ttl",
- "<",
- 3600
]
], - "paths": [
- "/get"
], - "priority": 0,
- "enable_websocket": true,
- "timeout": {
- "connect": 60,
- "send": 60,
- "read": 60
}, - "plugins": {
- "key-auth": { }
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "route_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_version_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101"
}
], - "total": 1
}
IAM Action: gateway:GetServiceTemplate
, Resource: arn:api7:gateway:servicetemplate/%s
service_version_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service version. |
route_version_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the route version. |
{- "value": {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "methods": [
- "GET"
], - "vars": [
- [
- "arg_version",
- "==",
- "v2"
], - [
- "arg_ttl",
- "<",
- 3600
]
], - "paths": [
- "/get"
], - "priority": 0,
- "enable_websocket": true,
- "timeout": {
- "connect": 60,
- "send": 60,
- "read": 60
}, - "plugins": {
- "key-auth": { }
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "route_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_version_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101"
}
}
IAM Action: gateway:GetServiceTemplate
, Resource: arn:api7:gateway:servicetemplate/%s
service_version_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service version. |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
order_by | string Default: "updated_at" Enum: "created_at" "updated_at" Index to order resources by. |
{- "list": [
- {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "remote_addr": "127.0.0.1",
- "server_addr": "mysql",
- "server_port": 3306,
- "plugins": {
- "ip-restriction": {
- "whitelist": [
- "192.168.0.1/24"
], - "message": "Access denied"
}
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "stream_route_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_version_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101"
}
], - "total": 1
}
IAM Action: gateway:GetServiceTemplate
, Resource: arn:api7:gateway:servicetemplate/%s
service_version_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service version. |
stream_route_version_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the stream route version. |
{- "value": {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "remote_addr": "127.0.0.1",
- "server_addr": "mysql",
- "server_port": 3306,
- "plugins": {
- "ip-restriction": {
- "whitelist": [
- "192.168.0.1/24"
], - "message": "Access denied"
}
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "stream_route_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_version_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101"
}
}
IAM Action: gateway:PublishServices
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
create_new_version | boolean If true, create a new service version. |
gateway_group_id | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ The gateway group ID. |
Array of objects non-empty Services configurations. |
{- "create_new_version": true,
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "services": [
- {
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "version": "string",
- "service_version_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101"
}
]
}
{- "value": { }
}
IAM Action: gateway:GetPublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
service_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service template. |
{- "list": [
- {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "type": "http",
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "apisix_service_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "version": "1.3.2",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "gateway_group_name": "us-west-rsc",
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "unhealthy_nodes_count": 0,
- "status": 0
}
], - "total": 1
}
IAM Action: gateway:GetServiceTemplate
, Resource: arn:api7:gateway:servicetemplate/%s
service_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service template. |
version required | string Service version. |
{- "value": {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "type": "http",
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "apisix_service_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "version": "1.3.2",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:GetSecretProvider
, Resource: arn:api7:gateway:gatewaygroup/%s/secret_provider/%s
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
order_by | string Default: "updated_at" Enum: "created_at" "updated_at" Index to order resources by. |
search | string Example: search=version%3Dv2 Condition to search resources by. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
{- "list": [
- {
- "prefix": "kv/apisix",
- "token": "apisix-quickstart-vault-token",
- "namespace": "apisix",
- "kv_version": "kv-v1",
- "authentication_method": "token",
- "desc": "Object description.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "secret_provider": "vault",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
], - "total": 1
}
IAM Action: gateway:GetSecretProvider
, Resource: arn:api7:gateway:gatewaygroup/%s/secret_provider/%s
secret_provider required | string Enum: "vault" "aws" "kubernetes" Secret provider. |
secret_provider_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 Secret provider ID. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
{- "value": {
- "prefix": "kv/apisix",
- "token": "apisix-quickstart-vault-token",
- "namespace": "apisix",
- "kv_version": "kv-v1",
- "authentication_method": "token",
- "desc": "Object description.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "secret_provider": "vault",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:DeleteSecretProvider
, Resource: arn:api7:gateway:gatewaygroup/%s/secret_provider/%s
secret_provider required | string Enum: "vault" "aws" "kubernetes" Secret provider. |
secret_provider_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 Secret provider ID. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
""
IAM Action: gateway:PutSecretProvider
, Resource: arn:api7:gateway:gatewaygroup/%s/secret_provider/%s
secret_provider required | string Enum: "vault" "aws" "kubernetes" Secret provider. |
secret_provider_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 Secret provider ID. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
uri required | string^[^/]+://([\da-zA-Z.-]+|\[[\da-fA-F:]+\])(:\d... Vault endpoint. |
prefix required | string Vault prefix to access secrets. |
token required | string Vault token. |
namespace | string Vault namespace. |
kv_version | string Default: "kv-v1" Value: "kv-v1" Vault KV secrets engine version. |
authentication_method | string Default: "token" Value: "token" Authentication method. |
desc | string <= 65536 characters The object description. |
object Key-value pairs of labels. |
{- "prefix": "kv/apisix",
- "token": "apisix-quickstart-vault-token",
- "namespace": "apisix",
- "kv_version": "kv-v1",
- "authentication_method": "token",
- "desc": "Object description.",
- "labels": {
- "version": "v2",
- "env": "prod"
}
}
{- "value": {
- "prefix": "kv/apisix",
- "token": "apisix-quickstart-vault-token",
- "namespace": "apisix",
- "kv_version": "kv-v1",
- "authentication_method": "token",
- "desc": "Object description.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "secret_provider": "vault",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:GetProto
, Resource: arn:api7:gateway:gatewaygroup/%s
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
order_by | string Default: "updated_at" Enum: "created_at" "updated_at" Index to order resources by. |
search | string Example: search=version%3Dv2 Condition to search resources by. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
{- "list": [
- {
- "content": "syntax = \"proto3\";\n\nmessage Person {\n string name = 1;\n int32 id = 2;\n string email = 3;\n}\n",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288230,
- "updated_at": 1742288230
}
], - "total": 1
}
IAM Action: gateway:CreateProto
, Resource: arn:api7:gateway:gatewaygroup/%s
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
content required | string [ 1 .. 1048576 ] characters The protobuf content. |
object Key-value pairs of labels. |
{- "content": "syntax = \"proto3\";\n\nmessage Person {\n string name = 1;\n int32 id = 2;\n string email = 3;\n}\n",
- "labels": {
- "version": "v2",
- "env": "prod"
}
}
{- "value": {
- "content": "syntax = \"proto3\";\n\nmessage Person {\n string name = 1;\n int32 id = 2;\n string email = 3;\n}\n",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288230,
- "updated_at": 1742288230
}
}
IAM Action: gateway:GetProto
, Resource: arn:api7:gateway:gatewaygroup/%s
proto_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the proto. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
{- "value": {
- "content": "syntax = \"proto3\";\n\nmessage Person {\n string name = 1;\n int32 id = 2;\n string email = 3;\n}\n",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288230,
- "updated_at": 1742288230
}
}
IAM Action: gateway:UpdateProto
, Resource: arn:api7:gateway:gatewaygroup/%s
proto_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the proto. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
content required | string [ 1 .. 1048576 ] characters The protobuf content. |
object Key-value pairs of labels. |
{- "content": "syntax = \"proto3\";\n\nmessage Person {\n string name = 1;\n int32 id = 2;\n string email = 3;\n}\n",
- "labels": {
- "version": "v2",
- "env": "prod"
}
}
{- "value": {
- "content": "syntax = \"proto3\";\n\nmessage Person {\n string name = 1;\n int32 id = 2;\n string email = 3;\n}\n",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288230,
- "updated_at": 1742288230
}
}
IAM Action: gateway:DeleteProto
, Resource: arn:api7:gateway:gatewaygroup/%s
proto_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the proto. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
{- "value": { }
}
{- "value": {
- "customer": "API7",
- "effective_at": 1654012800,
- "expired_at": 1717171200,
- "max_dp_cores": 100,
- "feature_list": [
- "API7 Gateway"
], - "deployment_id": "d1e1ea2b-2cff-4c38-b57e-408e1dffec52",
- "free_trial": true,
- "is_test_env": true,
- "issuance_date": 1625769798,
- "runtime": {
- "status": "dp_core_exceeded",
- "dp_core_exceeded_start_at": 1654012700,
- "dp_core_exceeded_end_at": 1654012750,
- "max_dp_cores": 100
}, - "status": "normal"
}
}
IAM Action: iam:UpdateLicense
, Resource: arn:api7:iam:organization/*
dry-run | string Value: "all" When specified, run the operation in dry-run mode. |
data required | string Encoded license data. |
{- "data": "“xxxx1N-tNaTpttX-NjOdXjyg\""
}
{- "value": {
- "customer": "API7",
- "effective_at": 1654012800,
- "expired_at": 1717171200,
- "max_dp_cores": 100,
- "feature_list": [
- "API7 Gateway"
], - "deployment_id": "d1e1ea2b-2cff-4c38-b57e-408e1dffec52",
- "free_trial": true,
- "is_test_env": true,
- "issuance_date": 1625769798
}
}
IAM Action: gateway:UpdatePublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
name required | string [ 1 .. 65536 ] characters The object name. |
object Key-value pairs of labels. | |
desc | string <= 65536 characters The object description. |
methods | Array of strings [ 1 .. 9 ] items unique Items Enum: "GET" "POST" "PUT" "DELETE" "PATCH" "HEAD" "OPTIONS" "TRACE" The allowed HTTP methods to access the route. If empty, all HTTP methods are allowed. |
vars | Array of any Conditions in the format of APISIX expressions to match requests to routes. Case sensitive when matching a cookie name. |
paths required | Array of strings [ 1 .. 64 ] items [ items [ 1 .. 4096 ] characters ] The URL path(s) (after the service's |
priority | integer Default: 0 Priority of the route. A higher value corresponds to a higher priority. If different Routes matches to the same URI, then the Route with the highest priority will be matched. |
enable_websocket | boolean or null If true, enable Websocket proxying for the route. |
object Timeout settings for connecting to, sending, and receiving messages from the upstream, in seconds. | |
plugins | object Key-value pairs of plugins and their configurations on the object. |
service_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ The service ID. |
{- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "methods": [
- "GET"
], - "vars": [
- [
- "arg_version",
- "==",
- "v2"
], - [
- "arg_ttl",
- "<",
- 3600
]
], - "paths": [
- "/get"
], - "priority": 0,
- "enable_websocket": true,
- "timeout": {
- "connect": 60,
- "send": 60,
- "read": 60
}, - "plugins": {
- "key-auth": { }
}, - "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01"
}
{- "value": {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "methods": [
- "GET"
], - "vars": [
- [
- "arg_version",
- "==",
- "v2"
], - [
- "arg_ttl",
- "<",
- 3600
]
], - "paths": [
- "/get"
], - "priority": 0,
- "enable_websocket": true,
- "timeout": {
- "connect": 60,
- "send": 60,
- "read": 60
}, - "plugins": {
- "key-auth": { }
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:GetPublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
service_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: service_id=bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the published service. |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
order_by | string Default: "updated_at" Enum: "created_at" "updated_at" Index to order resources by. |
search | string Example: search=version%3Dv2 Condition to search resources by. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
with_publish_info | boolean Default: false If true, include publish information in the response, such as |
{- "list": [
- {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "methods": [
- "GET"
], - "vars": [
- [
- "arg_version",
- "==",
- "v2"
], - [
- "arg_ttl",
- "<",
- 3600
]
], - "paths": [
- "/get"
], - "priority": 0,
- "enable_websocket": true,
- "timeout": {
- "connect": 60,
- "send": 60,
- "read": 60
}, - "plugins": {
- "key-auth": { }
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
], - "total": 1
}
IAM Action: gateway:GetPublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
route_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the published route. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
with_publish_info | boolean Default: false If true, include publish information in the response, such as |
{- "value": {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "methods": [
- "GET"
], - "vars": [
- [
- "arg_version",
- "==",
- "v2"
], - [
- "arg_ttl",
- "<",
- 3600
]
], - "paths": [
- "/get"
], - "priority": 0,
- "enable_websocket": true,
- "timeout": {
- "connect": 60,
- "send": 60,
- "read": 60
}, - "plugins": {
- "key-auth": { }
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:UpdatePublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
route_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the published route. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
name required | string [ 1 .. 65536 ] characters The object name. |
object Key-value pairs of labels. | |
desc | string <= 65536 characters The object description. |
methods | Array of strings [ 1 .. 9 ] items unique Items Enum: "GET" "POST" "PUT" "DELETE" "PATCH" "HEAD" "OPTIONS" "TRACE" The allowed HTTP methods to access the route. If empty, all HTTP methods are allowed. |
vars | Array of any Conditions in the format of APISIX expressions to match requests to routes. Case sensitive when matching a cookie name. |
paths required | Array of strings [ 1 .. 64 ] items [ items [ 1 .. 4096 ] characters ] The URL path(s) (after the service's |
priority | integer Default: 0 Priority of the route. A higher value corresponds to a higher priority. If different Routes matches to the same URI, then the Route with the highest priority will be matched. |
enable_websocket | boolean or null If true, enable Websocket proxying for the route. |
object Timeout settings for connecting to, sending, and receiving messages from the upstream, in seconds. | |
plugins | object Key-value pairs of plugins and their configurations on the object. |
service_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ The service ID. |
{- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "methods": [
- "GET"
], - "vars": [
- [
- "arg_version",
- "==",
- "v2"
], - [
- "arg_ttl",
- "<",
- 3600
]
], - "paths": [
- "/get"
], - "priority": 0,
- "enable_websocket": true,
- "timeout": {
- "connect": 60,
- "send": 60,
- "read": 60
}, - "plugins": {
- "key-auth": { }
}, - "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01"
}
{- "value": {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "methods": [
- "GET"
], - "vars": [
- [
- "arg_version",
- "==",
- "v2"
], - [
- "arg_ttl",
- "<",
- 3600
]
], - "paths": [
- "/get"
], - "priority": 0,
- "enable_websocket": true,
- "timeout": {
- "connect": 60,
- "send": 60,
- "read": 60
}, - "plugins": {
- "key-auth": { }
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:UpdatePublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
route_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the published route. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
op required | string Enum: "add" "replace" The operation to be performed. |
path required | string Path to the field to be replaced or added. Path should follow the JSON Pointer format. |
value required | any Value to be added or replaced. |
[- {
- "op": "add",
- "path": "/name",
- "value": "new-name"
}
]
{- "value": {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "methods": [
- "GET"
], - "vars": [
- [
- "arg_version",
- "==",
- "v2"
], - [
- "arg_ttl",
- "<",
- 3600
]
], - "paths": [
- "/get"
], - "priority": 0,
- "enable_websocket": true,
- "timeout": {
- "connect": 60,
- "send": 60,
- "read": 60
}, - "plugins": {
- "key-auth": { }
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:UpdatePublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
route_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the published route. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
""
IAM Action: gateway:UpdateServiceTemplate
, Resource: arn:api7:gateway:servicetemplate/%s
name required | string [ 1 .. 65536 ] characters The object name. |
object Key-value pairs of labels. | |
desc | string <= 65536 characters The object description. |
methods | Array of strings [ 1 .. 9 ] items unique Items Enum: "GET" "POST" "PUT" "DELETE" "PATCH" "HEAD" "OPTIONS" "TRACE" The allowed HTTP methods to access the route. If empty, all HTTP methods are allowed. |
vars | Array of any Conditions in the format of APISIX expressions to match requests to routes. Case sensitive when matching a cookie name. |
paths required | Array of strings [ 1 .. 64 ] items [ items [ 1 .. 4096 ] characters ] The URL path(s) (after the service's |
priority | integer Default: 0 Priority of the route. A higher value corresponds to a higher priority. If different Routes matches to the same URI, then the Route with the highest priority will be matched. |
enable_websocket | boolean or null If true, enable Websocket proxying for the route. |
service_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ The service ID. |
{- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "methods": [
- "GET"
], - "vars": [
- [
- "arg_version",
- "==",
- "v2"
], - [
- "arg_ttl",
- "<",
- 3600
]
], - "paths": [
- "/get"
], - "priority": 0,
- "enable_websocket": true,
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01"
}
{- "value": {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "methods": [
- "GET"
], - "vars": [
- [
- "arg_version",
- "==",
- "v2"
], - [
- "arg_ttl",
- "<",
- 3600
]
], - "paths": [
- "/get"
], - "priority": 0,
- "enable_websocket": true,
- "timeout": {
- "connect": 60,
- "send": 60,
- "read": 60
}, - "plugins": {
- "key-auth": { }
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:GetServiceTemplate
, Resource: arn:api7:gateway:servicetemplate/%s
service_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: service_id=bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service template. |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
order_by | string Default: "updated_at" Enum: "created_at" "updated_at" Index to order resources by. |
search | string Example: search=version%3Dv2 Condition to search resources by. |
labels | string non-empty Example: labels=labels%5Bversion%5D=v2 Label(s) to filter resources by. The format is |
{- "list": [
- {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "methods": [
- "GET"
], - "vars": [
- [
- "arg_version",
- "==",
- "v2"
], - [
- "arg_ttl",
- "<",
- 3600
]
], - "paths": [
- "/get"
], - "priority": 0,
- "enable_websocket": true,
- "timeout": {
- "connect": 60,
- "send": 60,
- "read": 60
}, - "plugins": {
- "key-auth": { }
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
], - "total": 1
}
IAM Action: gateway:GetServiceTemplate
, Resource: arn:api7:gateway:servicetemplate/%s
route_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the route in the service template. |
{- "value": {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "methods": [
- "GET"
], - "vars": [
- [
- "arg_version",
- "==",
- "v2"
], - [
- "arg_ttl",
- "<",
- 3600
]
], - "paths": [
- "/get"
], - "priority": 0,
- "enable_websocket": true,
- "timeout": {
- "connect": 60,
- "send": 60,
- "read": 60
}, - "plugins": {
- "key-auth": { }
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:UpdateServiceTemplate
, Resource: arn:api7:gateway:servicetemplate/%s
route_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the route in the service template. |
op required | string Enum: "add" "replace" The operation to be performed. |
path required | string Path to the field to be replaced or added. Path should follow the JSON Pointer format. |
value required | any Value to be added or replaced. |
[- {
- "op": "add",
- "path": "/name",
- "value": "new-name"
}
]
{- "value": {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "methods": [
- "GET"
], - "vars": [
- [
- "arg_version",
- "==",
- "v2"
], - [
- "arg_ttl",
- "<",
- 3600
]
], - "paths": [
- "/get"
], - "priority": 0,
- "enable_websocket": true,
- "timeout": {
- "connect": 60,
- "send": 60,
- "read": 60
}, - "plugins": {
- "key-auth": { }
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:UpdateServiceTemplate
, Resource: arn:api7:gateway:servicetemplate/%s
route_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the route in the service template. |
""
IAM Action: gateway:GetPublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
service_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service template. |
route_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the route in the service template. |
{- "value": {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "methods": [
- "GET"
], - "vars": [
- [
- "arg_version",
- "==",
- "v2"
], - [
- "arg_ttl",
- "<",
- 3600
]
], - "paths": [
- "/get"
], - "priority": 0,
- "enable_websocket": true,
- "timeout": {
- "connect": 60,
- "send": 60,
- "read": 60
}, - "plugins": {
- "key-auth": { }
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "route_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_version_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101"
}
}
IAM Action: gateway:UpdatePublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
name required | string [ 1 .. 65536 ] characters The object name. |
object Key-value pairs of labels. | |
desc | string <= 65536 characters The object description. |
IPv4 (string) or IPv4/CIDR (string) or IPv6 (string) or IPv6/CIDR (string) Client address filter. If the client request does not originate from | |
(IPAddress (IPv4 (string) or IPv4/CIDR (string) or IPv6 (string) or IPv6/CIDR (string))) or Domain (string) Stream server address. | |
server_port | integer <= 65535 Stream server port. |
plugins | object Key-value pairs of plugins and their configurations on the object. |
service_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ The service ID. |
{- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "remote_addr": "127.0.0.1",
- "server_addr": "mysql",
- "server_port": 3306,
- "plugins": {
- "ip-restriction": {
- "whitelist": [
- "192.168.0.1/24"
], - "message": "Access denied"
}
}, - "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01"
}
{- "value": {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "remote_addr": "127.0.0.1",
- "server_addr": "mysql",
- "server_port": 3306,
- "plugins": {
- "ip-restriction": {
- "whitelist": [
- "192.168.0.1/24"
], - "message": "Access denied"
}
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "gateway_group_name": "us-west-rsc",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:GetPublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
service_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: service_id=bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the published service. |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
order_by | string Default: "updated_at" Enum: "created_at" "updated_at" Index to order resources by. |
search | string Example: search=version%3Dv2 Condition to search resources by. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
with_publish_info | boolean Default: false If true, include publish information in the response, such as |
{- "list": [
- {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "remote_addr": "127.0.0.1",
- "server_addr": "mysql",
- "server_port": 3306,
- "plugins": {
- "ip-restriction": {
- "whitelist": [
- "192.168.0.1/24"
], - "message": "Access denied"
}
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "gateway_group_name": "us-west-rsc",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
], - "total": 1
}
IAM Action: gateway:GetPublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
stream_route_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the published stream route. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
with_publish_info | boolean Default: false If true, include publish information in the response, such as |
{- "value": {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "remote_addr": "127.0.0.1",
- "server_addr": "mysql",
- "server_port": 3306,
- "plugins": {
- "ip-restriction": {
- "whitelist": [
- "192.168.0.1/24"
], - "message": "Access denied"
}
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "gateway_group_name": "us-west-rsc",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:UpdatePublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
stream_route_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the published stream route. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
name required | string [ 1 .. 65536 ] characters The object name. |
object Key-value pairs of labels. | |
desc | string <= 65536 characters The object description. |
IPv4 (string) or IPv4/CIDR (string) or IPv6 (string) or IPv6/CIDR (string) Client address filter. If the client request does not originate from | |
(IPAddress (IPv4 (string) or IPv4/CIDR (string) or IPv6 (string) or IPv6/CIDR (string))) or Domain (string) Stream server address. | |
server_port | integer <= 65535 Stream server port. |
plugins | object Key-value pairs of plugins and their configurations on the object. |
service_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ The service ID. |
{- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "remote_addr": "127.0.0.1",
- "server_addr": "mysql",
- "server_port": 3306,
- "plugins": {
- "ip-restriction": {
- "whitelist": [
- "192.168.0.1/24"
], - "message": "Access denied"
}
}, - "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01"
}
{- "value": {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "remote_addr": "127.0.0.1",
- "server_addr": "mysql",
- "server_port": 3306,
- "plugins": {
- "ip-restriction": {
- "whitelist": [
- "192.168.0.1/24"
], - "message": "Access denied"
}
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "gateway_group_name": "us-west-rsc",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:UpdatePublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
stream_route_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the published stream route. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
""
IAM Action: gateway:UpdateServiceTemplate
, Resource: arn:api7:gateway:servicetemplate/%s
name required | string [ 1 .. 65536 ] characters The object name. |
object Key-value pairs of labels. | |
desc | string <= 65536 characters The object description. |
IPv4 (string) or IPv4/CIDR (string) or IPv6 (string) or IPv6/CIDR (string) Client address filter. If the client request does not originate from | |
(IPAddress (IPv4 (string) or IPv4/CIDR (string) or IPv6 (string) or IPv6/CIDR (string))) or Domain (string) Stream server address. | |
server_port | integer <= 65535 Stream server port. |
service_id | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ The service ID. |
{- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "remote_addr": "127.0.0.1",
- "server_addr": "mysql",
- "server_port": 3306,
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01"
}
{- "value": {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "remote_addr": "127.0.0.1",
- "server_addr": "mysql",
- "server_port": 3306,
- "plugins": {
- "ip-restriction": {
- "whitelist": [
- "192.168.0.1/24"
], - "message": "Access denied"
}
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "gateway_group_name": "us-west-rsc",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:GetServiceTemplate
, Resource: arn:api7:gateway:servicetemplate/%s
service_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: service_id=bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service template. |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
order_by | string Default: "updated_at" Enum: "created_at" "updated_at" Index to order resources by. |
search | string Example: search=version%3Dv2 Condition to search resources by. |
labels | string non-empty Example: labels=labels%5Bversion%5D=v2 Label(s) to filter resources by. The format is |
{- "list": [
- {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "remote_addr": "127.0.0.1",
- "server_addr": "mysql",
- "server_port": 3306,
- "plugins": {
- "ip-restriction": {
- "whitelist": [
- "192.168.0.1/24"
], - "message": "Access denied"
}
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "gateway_group_name": "us-west-rsc",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
], - "total": 1
}
IAM Action: gateway:GetServiceTemplate
, Resource: arn:api7:gateway:servicetemplate/%s
stream_route_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the stream route in the service template. |
{- "value": {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "remote_addr": "127.0.0.1",
- "server_addr": "mysql",
- "server_port": 3306,
- "plugins": {
- "ip-restriction": {
- "whitelist": [
- "192.168.0.1/24"
], - "message": "Access denied"
}
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "gateway_group_name": "us-west-rsc",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:UpdateServiceTemplate
, Resource: arn:api7:gateway:servicetemplate/%s
stream_route_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the stream route in the service template. |
name required | string [ 1 .. 65536 ] characters The object name. |
object Key-value pairs of labels. | |
desc | string <= 65536 characters The object description. |
IPv4 (string) or IPv4/CIDR (string) or IPv6 (string) or IPv6/CIDR (string) Client address filter. If the client request does not originate from | |
(IPAddress (IPv4 (string) or IPv4/CIDR (string) or IPv6 (string) or IPv6/CIDR (string))) or Domain (string) Stream server address. | |
server_port | integer <= 65535 Stream server port. |
plugins | object Key-value pairs of plugins and their configurations on the object. |
service_id | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ The service ID. |
{- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "remote_addr": "127.0.0.1",
- "server_addr": "mysql",
- "server_port": 3306,
- "plugins": {
- "ip-restriction": {
- "whitelist": [
- "192.168.0.1/24"
], - "message": "Access denied"
}
}, - "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01"
}
{- "value": {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "remote_addr": "127.0.0.1",
- "server_addr": "mysql",
- "server_port": 3306,
- "plugins": {
- "ip-restriction": {
- "whitelist": [
- "192.168.0.1/24"
], - "message": "Access denied"
}
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "gateway_group_name": "us-west-rsc",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:UpdateServiceTemplate
, Resource: arn:api7:gateway:servicetemplate/%s
stream_route_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the stream route in the service template. |
""
IAM Action: gateway:GetPublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
service_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service template. |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
order_by | string Default: "updated_at" Enum: "created_at" "updated_at" Index to order resources by. |
{- "list": [
- {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "remote_addr": "127.0.0.1",
- "server_addr": "mysql",
- "server_port": 3306,
- "plugins": {
- "ip-restriction": {
- "whitelist": [
- "192.168.0.1/24"
], - "message": "Access denied"
}
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "stream_route_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_version_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101"
}
], - "total": 1
}
IAM Action: gateway:GetPublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
service_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service template. |
stream_route_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the stream route in the service template. |
{- "value": {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "remote_addr": "127.0.0.1",
- "server_addr": "mysql",
- "server_port": 3306,
- "plugins": {
- "ip-restriction": {
- "whitelist": [
- "192.168.0.1/24"
], - "message": "Access denied"
}
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "stream_route_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_version_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101"
}
}
IAM Action: gateway:CreateSSLCertificate
, Resource: arn:api7:gateway:gatewaygroup/%s
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
name | string [ 1 .. 65536 ] characters The object name. |
desc | string <= 65536 characters The object description. |
snis | Array of strings[ items^\*?[0-9a-zA-Z-._]+$ ] The SNI list for matching the SSL certificate. |
object Client certificate. | |
type | string Value: "server" Type of certificate. Only support |
object Key-value pairs of labels. | |
required | Private Key Reference (string) or Private Key Content (string) Private key content or reference to the private key content. |
required | Certificate Reference (string) or Certificate Content (string) Certificate content or reference to the certificate content. |
{- "name": "us-west-rsc",
- "desc": "Object description.",
- "snis": [
- "httpbin.org"
], - "client": {
- "ca": "-----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----",
- "depth": 1
}, - "type": "server",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "key": "$secret://aws/john/apisix-secrets/john-key-auth",
- "cert": "$secret://aws/john/apisix-secrets/john-key-auth"
}
{- "value": {
- "name": "us-west-rsc",
- "desc": "Object description.",
- "snis": [
- "httpbin.org"
], - "client": {
- "ca": "-----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----",
- "depth": 1
}, - "type": "server",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "exptime": 1735680000,
- "validity_start": 1714540800,
- "validity_end": 1730419200
}
}
IAM Action: gateway:GetSSLCertificate
, Resource: arn:api7:gateway:gatewaygroup/%s
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
order_by | string Default: "updated_at" Enum: "created_at" "updated_at" Index to order resources by. |
search | string Example: search=version%3Dv2 Condition to search resources by. |
labels | string non-empty Example: labels=labels%5Bversion%5D=v2 Label(s) to filter resources by. The format is |
type | string Default: "server" Enum: "client" "server" Type of certificate. |
{- "list": [
- {
- "name": "us-west-rsc",
- "desc": "Object description.",
- "snis": [
- "httpbin.org"
], - "client": {
- "ca": "-----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----",
- "depth": 1
}, - "type": "server",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "exptime": 1735680000,
- "validity_start": 1714540800,
- "validity_end": 1730419200
}
], - "total": 1
}
IAM Action: gateway:GetSSLCertificate
, Resource: arn:api7:gateway:gatewaygroup/%s
ssl_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the SSL object. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
{- "value": {
- "name": "us-west-rsc",
- "desc": "Object description.",
- "snis": [
- "httpbin.org"
], - "client": {
- "ca": "-----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----",
- "depth": 1
}, - "type": "server",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "exptime": 1735680000,
- "validity_start": 1714540800,
- "validity_end": 1730419200
}
}
IAM Action: gateway:UpdateSSLCertificate
, Resource: arn:api7:gateway:gatewaygroup/%s
ssl_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the SSL object. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
name | string [ 1 .. 65536 ] characters The object name. |
desc | string <= 65536 characters The object description. |
snis | Array of strings[ items^\*?[0-9a-zA-Z-._]+$ ] The SNI list for matching the SSL certificate. |
object Client certificate. | |
type | string Value: "server" Type of certificate. Only support |
object Key-value pairs of labels. | |
required | Private Key Reference (string) or Private Key Content (string) Private key content or reference to the private key content. |
required | Certificate Reference (string) or Certificate Content (string) Certificate content or reference to the certificate content. |
{- "name": "us-west-rsc",
- "desc": "Object description.",
- "snis": [
- "httpbin.org"
], - "client": {
- "ca": "-----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----",
- "depth": 1
}, - "type": "server",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "key": "$secret://aws/john/apisix-secrets/john-key-auth",
- "cert": "$secret://aws/john/apisix-secrets/john-key-auth"
}
{- "value": {
- "name": "us-west-rsc",
- "desc": "Object description.",
- "snis": [
- "httpbin.org"
], - "client": {
- "ca": "-----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----",
- "depth": 1
}, - "type": "server",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "exptime": 1735680000,
- "validity_start": 1714540800,
- "validity_end": 1730419200
}
}
IAM Action: gateway:DeleteSSLCertificate
, Resource: arn:api7:gateway:gatewaygroup/%s
ssl_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the SSL object. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
""
cert required | string [ 1 .. 65536 ] characters ^[^\$] The certificate in PEM format. |
{- "cert": "-----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----"
}
{- "list": [
- {
- "common_name": "example.com",
- "subject_alt_names": [
- "www.example.com"
], - "snis": [
- "string"
], - "not_before": "2019-08-24T14:15:22Z",
- "not_after": "2019-08-24T14:15:22Z",
- "subject": "string",
- "issuer": "string",
- "serial_number": "string",
- "signature_algorithm": "string",
- "extensions": {
- "property1": "string",
- "property2": "string"
}
}
], - "total": 1
}
cert required | string [ 1 .. 65536 ] characters ^[^\$] The certificate in PEM format. |
key required | string [ 1 .. 65536 ] characters ^[^\$] The private key in PEM format. |
{- "cert": "-----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----",
- "key": "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----"
}
{- "value": true
}
IAM Action: gateway:CreateCertificate
, Resource: arn:api7:gateway:gatewaygroup/%s
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
name | string [ 1 .. 65536 ] characters The object name. |
desc | string <= 65536 characters The object description. |
required | Certificate Reference (string) or Certificate Content (string) Certificate. |
object Key-value pairs of labels. | |
required | Private Key Reference (string) or Private Key Content (string) Private key. |
{- "name": "us-west-rsc",
- "desc": "Object description.",
- "cert": "$secret://aws/john/apisix-secrets/john-key-auth",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "key": "$secret://aws/john/apisix-secrets/john-key-auth"
}
{- "value": {
- "name": "us-west-rsc",
- "desc": "Object description.",
- "cert": "$secret://aws/john/apisix-secrets/john-key-auth",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "common_name": "example.com",
- "subject_alt_names": [
- "www.example.com"
], - "associated_snis": [
- "1cf56bfe-7727-4584-93f2-9d09271bd42a"
], - "exptime": 1735680000,
- "validity_start": 1714540800,
- "validity_end": 1730419200
}
}
IAM Action: gateway:GetCertificate
, Resource: arn:api7:gateway:gatewaygroup/%s
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
order_by | string Default: "exptime" Enum: "name" "exptime" |
search | string Example: search=version%3Dv2 Condition to search resources by. |
labels | string non-empty Example: labels=labels%5Bversion%5D=v2 Label(s) to filter resources by. The format is |
sni_id | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: sni_id=bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The object ID. |
sni_name | string SNI name. |
exptime | integer Filter out results that expired before this time. |
{- "list": [
- {
- "name": "us-west-rsc",
- "desc": "Object description.",
- "cert": "$secret://aws/john/apisix-secrets/john-key-auth",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "common_name": "example.com",
- "subject_alt_names": [
- "www.example.com"
], - "associated_snis": [
- "1cf56bfe-7727-4584-93f2-9d09271bd42a"
], - "exptime": 1735680000,
- "validity_start": 1714540800,
- "validity_end": 1730419200
}
], - "total": 1
}
IAM Action: gateway:GetCertificate
, Resource: arn:api7:gateway:gatewaygroup/%s
certificate_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the Certificate. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
{- "value": {
- "name": "us-west-rsc",
- "desc": "Object description.",
- "cert": "$secret://aws/john/apisix-secrets/john-key-auth",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "common_name": "example.com",
- "subject_alt_names": [
- "www.example.com"
], - "associated_snis": [
- "1cf56bfe-7727-4584-93f2-9d09271bd42a"
], - "exptime": 1735680000,
- "validity_start": 1714540800,
- "validity_end": 1730419200
}
}
IAM Action: gateway:UpdateCertificate
, Resource: arn:api7:gateway:gatewaygroup/%s
certificate_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the Certificate. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
name | string [ 1 .. 65536 ] characters The object name. |
desc | string <= 65536 characters The object description. |
required | Certificate Reference (string) or Certificate Content (string) Certificate. |
object Key-value pairs of labels. | |
required | Private Key Reference (string) or Private Key Content (string) Private key. |
{- "name": "us-west-rsc",
- "desc": "Object description.",
- "cert": "$secret://aws/john/apisix-secrets/john-key-auth",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "key": "$secret://aws/john/apisix-secrets/john-key-auth"
}
{- "value": {
- "name": "us-west-rsc",
- "desc": "Object description.",
- "cert": "$secret://aws/john/apisix-secrets/john-key-auth",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "common_name": "example.com",
- "subject_alt_names": [
- "www.example.com"
], - "associated_snis": [
- "1cf56bfe-7727-4584-93f2-9d09271bd42a"
], - "exptime": 1735680000,
- "validity_start": 1714540800,
- "validity_end": 1730419200
}
}
IAM Action: gateway:UpdateCertificate
, Resource: arn:api7:gateway:gatewaygroup/%s
certificate_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the Certificate. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
op required | string Enum: "add" "replace" The operation to be performed. |
path required | string Path to the field to be replaced or added. Path should follow the JSON Pointer format. |
value required | any Value to be added or replaced. |
[- {
- "op": "add",
- "path": "/name",
- "value": "new-name"
}
]
{- "value": {
- "name": "us-west-rsc",
- "desc": "Object description.",
- "cert": "$secret://aws/john/apisix-secrets/john-key-auth",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "common_name": "example.com",
- "subject_alt_names": [
- "www.example.com"
], - "associated_snis": [
- "1cf56bfe-7727-4584-93f2-9d09271bd42a"
], - "exptime": 1735680000,
- "validity_start": 1714540800,
- "validity_end": 1730419200
}
}
IAM Action: gateway:DeleteCertificate
, Resource: arn:api7:gateway:gatewaygroup/%s
certificate_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the Certificate. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
""
IAM Action: gateway:CreateCertificate
, Resource: arn:api7:gateway:gatewaygroup/%s
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
name | string [ 1 .. 65536 ] characters The object name. |
desc | string <= 65536 characters The object description. |
cert required | string [ 1 .. 65536 ] characters ^[^\$] The certificate in PEM format. |
object Key-value pairs of labels. |
{- "name": "us-west-rsc",
- "desc": "Object description.",
- "cert": "-----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----",
- "labels": {
- "version": "v2",
- "env": "prod"
}
}
{- "value": {
- "name": "us-west-rsc",
- "desc": "Object description.",
- "cert": "-----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "associated_snis": [
- "string"
], - "exptime": 1735680000,
- "validity_start": 1714540800,
- "validity_end": 1730419200
}
}
IAM Action: gateway:GetCertificate
, Resource: arn:api7:gateway:gatewaygroup/%s
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
order_by | string Default: "exptime" Enum: "name" "exptime" |
search | string Example: search=version%3Dv2 Condition to search resources by. |
labels | string non-empty Example: labels=labels%5Bversion%5D=v2 Label(s) to filter resources by. The format is |
sni_id | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: sni_id=bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The object ID. |
sni_name | string SNI name. |
exptime | integer Filter out results that expired before this time. |
{- "list": [
- {
- "name": "us-west-rsc",
- "desc": "Object description.",
- "cert": "-----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "associated_snis": [
- "string"
], - "exptime": 1735680000,
- "validity_start": 1714540800,
- "validity_end": 1730419200
}
], - "total": 1
}
IAM Action: gateway:GetCertificate
, Resource: arn:api7:gateway:gatewaygroup/%s
ca_certificate_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the certificate. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
{- "value": {
- "name": "us-west-rsc",
- "desc": "Object description.",
- "cert": "-----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "associated_snis": [
- "string"
], - "exptime": 1735680000,
- "validity_start": 1714540800,
- "validity_end": 1730419200
}
}
IAM Action: gateway:UpdateCertificate
, Resource: arn:api7:gateway:gatewaygroup/%s
ca_certificate_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the certificate. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
name | string [ 1 .. 65536 ] characters The object name. |
desc | string <= 65536 characters The object description. |
cert required | string [ 1 .. 65536 ] characters ^[^\$] The certificate in PEM format. |
object Key-value pairs of labels. |
{- "name": "us-west-rsc",
- "desc": "Object description.",
- "cert": "-----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----",
- "labels": {
- "version": "v2",
- "env": "prod"
}
}
{- "value": {
- "name": "us-west-rsc",
- "desc": "Object description.",
- "cert": "-----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "associated_snis": [
- "string"
], - "exptime": 1735680000,
- "validity_start": 1714540800,
- "validity_end": 1730419200
}
}
IAM Action: gateway:UpdateCertificate
, Resource: arn:api7:gateway:gatewaygroup/%s
ca_certificate_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the certificate. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
op required | string Enum: "add" "replace" The operation to be performed. |
path required | string Path to the field to be replaced or added. Path should follow the JSON Pointer format. |
value required | any Value to be added or replaced. |
[- {
- "op": "add",
- "path": "/name",
- "value": "new-name"
}
]
{- "value": {
- "name": "us-west-rsc",
- "desc": "Object description.",
- "cert": "-----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "associated_snis": [
- "string"
], - "exptime": 1735680000,
- "validity_start": 1714540800,
- "validity_end": 1730419200
}
}
IAM Action: gateway:DeleteCertificate
, Resource: arn:api7:gateway:gatewaygroup/%s
ca_certificate_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the certificate. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
""
IAM Action: gateway:CreateSNI
, Resource: arn:api7:gateway:gatewaygroup/%s
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
name | string [ 1 .. 65536 ] characters The object name. |
domain | string^\*?[0-9a-zA-Z-._]+$ The HTTP host. |
desc | string <= 65536 characters The object description. |
Array of Certificate Reference (string) or Certificate Content (string) non-empty An array of certificates. | |
object mTLS configurations. | |
object Key-value pairs of labels. | |
ssl_protocols | Array of strings Default: ["TLSv1.2","TLSv1.3"] Items Enum: "TLSv1.1" "TLSv1.2" "TLSv1.3" An array of TLS protocol versions. |
{- "name": "us-west-rsc",
- "domain": "httpbin.org",
- "desc": "Object description.",
- "certificates": [
- "$secret://aws/john/apisix-secrets/john-key-auth"
], - "mtls": {
- "enabled": true,
- "ca_certificates": [
- "$secret://aws/john/apisix-secrets/john-key-auth"
]
}, - "labels": {
- "version": "v2",
- "env": "prod"
}, - "ssl_protocols": [
- "TLSv1.2",
- "TLSv1.3"
]
}
{- "value": {
- "name": "us-west-rsc",
- "domain": "httpbin.org",
- "desc": "Object description.",
- "certificates": [
- "$secret://aws/john/apisix-secrets/john-key-auth"
], - "mtls": {
- "enabled": true,
- "ca_certificates": [
- "$secret://aws/john/apisix-secrets/john-key-auth"
]
}, - "labels": {
- "version": "v2",
- "env": "prod"
}, - "ssl_protocols": [
- "TLSv1.2",
- "TLSv1.3"
], - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:GetSNI
, Resource: arn:api7:gateway:gatewaygroup/%s
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
order_by | string Default: "name" Value: "name" |
search | string Example: search=version%3Dv2 Condition to search resources by. |
labels | string non-empty Example: labels=labels%5Bversion%5D=v2 Label(s) to filter resources by. The format is |
domain | string^\*?[0-9a-zA-Z-._]+$ Example: domain=httpbin.org The domain of the SNI. |
mtls_enabled | Array of booleans If true, enable mTLS. |
{- "list": [
- {
- "name": "us-west-rsc",
- "domain": "httpbin.org",
- "desc": "Object description.",
- "certificates": [
- "$secret://aws/john/apisix-secrets/john-key-auth"
], - "mtls": {
- "enabled": true,
- "ca_certificates": [
- "$secret://aws/john/apisix-secrets/john-key-auth"
]
}, - "labels": {
- "version": "v2",
- "env": "prod"
}, - "ssl_protocols": [
- "TLSv1.2",
- "TLSv1.3"
], - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
], - "total": 1
}
IAM Action: gateway:GetSNI
, Resource: arn:api7:gateway:gatewaygroup/%s
sni_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the SNI object. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
{- "value": {
- "name": "us-west-rsc",
- "domain": "httpbin.org",
- "desc": "Object description.",
- "certificates": [
- "$secret://aws/john/apisix-secrets/john-key-auth"
], - "mtls": {
- "enabled": true,
- "ca_certificates": [
- "$secret://aws/john/apisix-secrets/john-key-auth"
]
}, - "labels": {
- "version": "v2",
- "env": "prod"
}, - "ssl_protocols": [
- "TLSv1.2",
- "TLSv1.3"
], - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:UpdateSNI
, Resource: arn:api7:gateway:gatewaygroup/%s
sni_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the SNI object. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
name | string [ 1 .. 65536 ] characters The object name. |
domain | string^\*?[0-9a-zA-Z-._]+$ The HTTP host. |
desc | string <= 65536 characters The object description. |
Array of Certificate Reference (string) or Certificate Content (string) non-empty An array of certificates. | |
object mTLS configurations. | |
object Key-value pairs of labels. | |
ssl_protocols | Array of strings Default: ["TLSv1.2","TLSv1.3"] Items Enum: "TLSv1.1" "TLSv1.2" "TLSv1.3" An array of TLS protocol versions. |
{- "name": "us-west-rsc",
- "domain": "httpbin.org",
- "desc": "Object description.",
- "certificates": [
- "$secret://aws/john/apisix-secrets/john-key-auth"
], - "mtls": {
- "enabled": true,
- "ca_certificates": [
- "$secret://aws/john/apisix-secrets/john-key-auth"
]
}, - "labels": {
- "version": "v2",
- "env": "prod"
}, - "ssl_protocols": [
- "TLSv1.2",
- "TLSv1.3"
]
}
{- "value": {
- "name": "us-west-rsc",
- "domain": "httpbin.org",
- "desc": "Object description.",
- "certificates": [
- "$secret://aws/john/apisix-secrets/john-key-auth"
], - "mtls": {
- "enabled": true,
- "ca_certificates": [
- "$secret://aws/john/apisix-secrets/john-key-auth"
]
}, - "labels": {
- "version": "v2",
- "env": "prod"
}, - "ssl_protocols": [
- "TLSv1.2",
- "TLSv1.3"
], - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:UpdateSNI
, Resource: arn:api7:gateway:gatewaygroup/%s
sni_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the SNI object. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
op required | string Enum: "add" "replace" The operation to be performed. |
path required | string Path to the field to be replaced or added. Path should follow the JSON Pointer format. |
value required | any Value to be added or replaced. |
[- {
- "op": "add",
- "path": "/name",
- "value": "new-name"
}
]
{- "value": {
- "name": "us-west-rsc",
- "domain": "httpbin.org",
- "desc": "Object description.",
- "certificates": [
- "$secret://aws/john/apisix-secrets/john-key-auth"
], - "mtls": {
- "enabled": true,
- "ca_certificates": [
- "$secret://aws/john/apisix-secrets/john-key-auth"
]
}, - "labels": {
- "version": "v2",
- "env": "prod"
}, - "ssl_protocols": [
- "TLSv1.2",
- "TLSv1.3"
], - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:DeleteSNI
, Resource: arn:api7:gateway:gatewaygroup/%s
sni_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the SNI object. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
""
IAM Action: gateway:CreateConsumer
, Resource: arn:api7:gateway:gatewaygroup/%s/consumer/*
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
username required | string [ 1 .. 512 ] characters ^[a-zA-Z0-9_\-]+$ The unique identifier of the consumer. |
plugins | object Key-value pairs of plugins and their configurations on the object. |
desc | string <= 65536 characters The object description. |
object Key-value pairs of labels. |
{- "username": "johndoe",
- "plugins": {
- "key-auth": { }
}, - "desc": "Object description.",
- "labels": {
- "version": "v2",
- "env": "prod"
}
}
{- "value": {
- "username": "johndoe",
- "plugins": {
- "key-auth": { }
}, - "desc": "Object description.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:GetConsumer
, Resource: arn:api7:gateway:gatewaygroup/%s/consumer/%s
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
order_by | string Default: "updated_at" Enum: "created_at" "updated_at" "username" Index to order consumers by. |
search | string Example: search=version%3Dv2 Condition to search resources by. |
labels | string non-empty Example: labels=labels%5Bversion%5D=v2 Label(s) to filter resources by. The format is |
{- "list": [
- {
- "username": "johndoe",
- "plugins": {
- "key-auth": { }
}, - "desc": "Object description.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "created_at": 1742288232,
- "updated_at": 1742288235
}
], - "total": 1
}
IAM Action: gateway:GetConsumer
, Resource: arn:api7:gateway:gatewaygroup/%s/consumer/%s
username required | string [ 1 .. 512 ] characters ^[a-zA-Z0-9_\-]+$ Example: johndoe The unique identifier of the consumer. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
{- "value": {
- "username": "johndoe",
- "plugins": {
- "key-auth": { }
}, - "desc": "Object description.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:UpdateConsumer
, Resource: arn:api7:gateway:gatewaygroup/%s/consumer/%s
username required | string [ 1 .. 512 ] characters ^[a-zA-Z0-9_\-]+$ Example: johndoe The unique identifier of the consumer. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
username required | string [ 1 .. 512 ] characters ^[a-zA-Z0-9_\-]+$ The unique identifier of the consumer. |
plugins | object Key-value pairs of plugins and their configurations on the object. |
desc | string <= 65536 characters The object description. |
object Key-value pairs of labels. |
{- "username": "johndoe",
- "plugins": {
- "key-auth": { }
}, - "desc": "Object description.",
- "labels": {
- "version": "v2",
- "env": "prod"
}
}
{- "value": {
- "username": "johndoe",
- "plugins": {
- "key-auth": { }
}, - "desc": "Object description.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:DeleteConsumer
, Resource: arn:api7:gateway:gatewaygroup/%s/consumer/%s
username required | string [ 1 .. 512 ] characters ^[a-zA-Z0-9_\-]+$ Example: johndoe The unique identifier of the consumer. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
""
IAM Action: gateway:UpdateConsumer
, Resource: arn:api7:gateway:gatewaygroup/%s/consumer/%s
username required | string [ 1 .. 512 ] characters ^[a-zA-Z0-9_\-]+$ Example: johndoe The unique identifier of the consumer. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
op required | string Enum: "add" "replace" The operation to be performed. |
path required | string Path to the field to be replaced or added. Path should follow the JSON Pointer format. |
value required | any Value to be added or replaced. |
[- {
- "op": "add",
- "path": "/name",
- "value": "new-name"
}
]
{- "value": {
- "username": "johndoe",
- "plugins": {
- "key-auth": { }
}, - "desc": "Object description.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:CreateConsumerCredential
, Resource: arn:api7:gateway:gatewaygroup/%s/consumer/%s
username required | string [ 1 .. 512 ] characters ^[a-zA-Z0-9_\-]+$ Example: johndoe The unique identifier of the consumer. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
name required | string [ 1 .. 100 ] characters The object name. |
required | key-auth (object) or basic-auth (object) or hmac-auth (object) or jwt-auth (object) = 1 properties Plugin configuration. |
desc | string <= 65536 characters The object description. |
object Key-value pairs of labels. |
{- "name": "us-west-rsc",
- "plugins": {
- "key-auth": {
- "key": "john-key"
}
}, - "desc": "Object description.",
- "labels": {
- "version": "v2",
- "env": "prod"
}
}
{- "value": {
- "name": "us-west-rsc",
- "plugins": {
- "key-auth": {
- "key": "john-key"
}
}, - "desc": "Object description.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:GetConsumerCredential
, Resource: arn:api7:gateway:gatewaygroup/%s/consumer/%s
username required | string [ 1 .. 512 ] characters ^[a-zA-Z0-9_\-]+$ Example: johndoe The unique identifier of the consumer. |
plugin_name | string [ 1 .. 100 ] characters Example: plugin_name=us-west-rsc the plugin name of the consumer credential. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
order_by | string Default: "updated_at" Enum: "created_at" "updated_at" "name" Index to order consumers by. |
search | string Example: search=version%3Dv2 Condition to search resources by. |
labels | string non-empty Example: labels=labels%5Bversion%5D=v2 Label(s) to filter resources by. The format is |
{- "list": [
- {
- "name": "us-west-rsc",
- "plugins": {
- "key-auth": {
- "key": "john-key"
}
}, - "desc": "Object description.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
], - "total": 1
}
IAM Action: gateway:GetConsumerCredential
, Resource: arn:api7:gateway:gatewaygroup/%s/consumer/%s
username required | string [ 1 .. 512 ] characters ^[a-zA-Z0-9_\-]+$ Example: johndoe The unique identifier of the consumer. |
credential_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the consumer credential. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
{- "value": {
- "name": "us-west-rsc",
- "plugins": {
- "key-auth": {
- "key": "john-key"
}
}, - "desc": "Object description.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:UpdateConsumerCredential
, Resource: arn:api7:gateway:gatewaygroup/%s/consumer/%s
username required | string [ 1 .. 512 ] characters ^[a-zA-Z0-9_\-]+$ Example: johndoe The unique identifier of the consumer. |
credential_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the consumer credential. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
name required | string [ 1 .. 100 ] characters The object name. |
required | key-auth (object) or basic-auth (object) or hmac-auth (object) or jwt-auth (object) = 1 properties Plugin configuration. |
desc | string <= 65536 characters The object description. |
object Key-value pairs of labels. |
{- "name": "us-west-rsc",
- "plugins": {
- "key-auth": {
- "key": "john-key"
}
}, - "desc": "Object description.",
- "labels": {
- "version": "v2",
- "env": "prod"
}
}
{- "value": {
- "name": "us-west-rsc",
- "plugins": {
- "key-auth": {
- "key": "john-key"
}
}, - "desc": "Object description.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:DeleteConsumerCredential
, Resource: arn:api7:gateway:gatewaygroup/%s/consumer/%s
username required | string [ 1 .. 512 ] characters ^[a-zA-Z0-9_\-]+$ Example: johndoe The unique identifier of the consumer. |
credential_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the consumer credential. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
""
IAM Action: portal:CreateAPIProduct
, Resource: arn:api7:portal:apiproduct/*
type required | string Default: "gateway" Value: "gateway" |
name required | string [ 1 .. 100 ] characters The object name. |
logo | string The base64-encoded logo image of the API product. |
desc | string The description of the API product. |
object Key-value pairs of labels. | |
object non-empty The authentication configuration of the API product. | |
required | Array of objects non-empty An array of gateway groups and services that the API product is linked to. |
status | string Default: "draft" Enum: "draft" "published" Status of the API product. |
subscription_auto_approval | boolean Default: false If true, the subscription is automatically approved. |
can_view_unsubscribed | boolean Default: true If true, developers can view the unsubscribed API. |
visibility | string Default: "public" Enum: "public" "logged_in" The visibility of the API product in the API hub. |
{- "type": "gateway",
- "name": "Weather Insights API",
- "logo": "string",
- "desc": "The Weather Insights API provides real-time and historical weather data for any location worldwide.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "auth": {
- "key-auth": {
- "header": "apikey",
- "hide_credentials": false,
- "query": "apikey"
}
}, - "linked_gateway_services": [
- {
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01"
}
], - "status": "draft",
- "subscription_auto_approval": false,
- "can_view_unsubscribed": true,
- "visibility": "public"
}
{- "value": {
- "type": "gateway",
- "name": "Weather Insights API",
- "logo": "string",
- "desc": "The Weather Insights API provides real-time and historical weather data for any location worldwide.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "auth": {
- "key-auth": {
- "header": "apikey",
- "hide_credentials": false,
- "query": "apikey"
}
}, - "linked_gateway_services": [
- {
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "gateway_group_name": "us-west-rsc",
- "name": "Weather Insights API",
- "version": "1.3.2",
- "status": 0,
- "hosts": [
- "weatherinsights.com"
], - "updated_at": 1742288230,
- "openapi_title": "Weather Insights API - OpenAPI 3.0"
}
], - "status": "draft",
- "subscription_auto_approval": false,
- "can_view_unsubscribed": true,
- "visibility": "public",
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "notifications": [
- {
- "type": "email",
- "email_subject": "API7 Enterprise alert.",
- "content": "This is a alert testing email.",
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "event": "subscription_approval_created",
- "contact_point_ids": [
- "6c97bc5f-3356-41f5-894c-c88df5389bd2"
]
}
]
}
}
IAM Action: portal:GetAPIProduct
, Resource: arn:api7:portal:apiproduct/%s
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
order_by | string Default: "updated_at" Enum: "created_at" "updated_at" Index to order resources by. |
search | string Example: search=version%3Dv2 Condition to search resources by. |
service_id | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: service_id=bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service template. |
{- "list": [
- {
- "type": "gateway",
- "name": "Weather Insights API",
- "logo": "string",
- "desc": "The Weather Insights API provides real-time and historical weather data for any location worldwide.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "auth": {
- "key-auth": {
- "header": "apikey",
- "hide_credentials": false,
- "query": "apikey"
}
}, - "linked_gateway_services": [
- {
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "gateway_group_name": "us-west-rsc",
- "name": "Weather Insights API",
- "version": "1.3.2",
- "status": 0,
- "hosts": [
- "weatherinsights.com"
], - "updated_at": 1742288230,
- "openapi_title": "Weather Insights API - OpenAPI 3.0"
}
], - "status": "draft",
- "subscription_auto_approval": false,
- "can_view_unsubscribed": true,
- "visibility": "public",
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
], - "total": 1
}
IAM Action: portal:GetAPIProduct
, Resource: arn:api7:portal:apiproduct/%s
api_product_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the API product. |
{- "value": {
- "type": "gateway",
- "name": "Weather Insights API",
- "logo": "string",
- "desc": "The Weather Insights API provides real-time and historical weather data for any location worldwide.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "auth": {
- "key-auth": {
- "header": "apikey",
- "hide_credentials": false,
- "query": "apikey"
}
}, - "linked_gateway_services": [
- {
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "gateway_group_name": "us-west-rsc",
- "name": "Weather Insights API",
- "version": "1.3.2",
- "status": 0,
- "hosts": [
- "weatherinsights.com"
], - "updated_at": 1742288230,
- "openapi_title": "Weather Insights API - OpenAPI 3.0"
}
], - "status": "draft",
- "subscription_auto_approval": false,
- "can_view_unsubscribed": true,
- "visibility": "public",
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "notifications": [
- {
- "type": "email",
- "email_subject": "API7 Enterprise alert.",
- "content": "This is a alert testing email.",
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "event": "subscription_approval_created",
- "contact_point_ids": [
- "6c97bc5f-3356-41f5-894c-c88df5389bd2"
]
}
]
}
}
IAM Action: portal:UpdateAPIProduct
, Resource: arn:api7:portal:apiproduct/%s
api_product_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the API product. |
type required | string Default: "gateway" Value: "gateway" |
name required | string [ 1 .. 100 ] characters The object name. |
logo | string The base64-encoded logo image of the API product. |
desc | string The description of the API product. |
object Key-value pairs of labels. | |
object non-empty The authentication configuration of the API product. | |
required | Array of objects non-empty An array of gateway groups and services that the API product is linked to. |
status | string Default: "draft" Enum: "draft" "published" Status of the API product. |
subscription_auto_approval | boolean Default: false If true, the subscription is automatically approved. |
can_view_unsubscribed | boolean Default: true If true, developers can view the unsubscribed API. |
visibility | string Default: "public" Enum: "public" "logged_in" The visibility of the API product in the API hub. |
{- "type": "gateway",
- "name": "Weather Insights API",
- "logo": "string",
- "desc": "The Weather Insights API provides real-time and historical weather data for any location worldwide.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "auth": {
- "key-auth": {
- "header": "apikey",
- "hide_credentials": false,
- "query": "apikey"
}
}, - "linked_gateway_services": [
- {
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01"
}
], - "status": "draft",
- "subscription_auto_approval": false,
- "can_view_unsubscribed": true,
- "visibility": "public"
}
{- "value": {
- "type": "gateway",
- "name": "Weather Insights API",
- "logo": "string",
- "desc": "The Weather Insights API provides real-time and historical weather data for any location worldwide.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "auth": {
- "key-auth": {
- "header": "apikey",
- "hide_credentials": false,
- "query": "apikey"
}
}, - "linked_gateway_services": [
- {
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "gateway_group_name": "us-west-rsc",
- "name": "Weather Insights API",
- "version": "1.3.2",
- "status": 0,
- "hosts": [
- "weatherinsights.com"
], - "updated_at": 1742288230,
- "openapi_title": "Weather Insights API - OpenAPI 3.0"
}
], - "status": "draft",
- "subscription_auto_approval": false,
- "can_view_unsubscribed": true,
- "visibility": "public",
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "notifications": [
- {
- "type": "email",
- "email_subject": "API7 Enterprise alert.",
- "content": "This is a alert testing email.",
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "event": "subscription_approval_created",
- "contact_point_ids": [
- "6c97bc5f-3356-41f5-894c-c88df5389bd2"
]
}
]
}
}
IAM Action: portal:UpdateAPIProduct
, Resource: arn:api7:portal:apiproduct/%s
api_product_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the API product. |
op required | string Enum: "add" "replace" The operation to be performed. |
path required | string Path to the field to be replaced or added. Path should follow the JSON Pointer format. |
value required | any Value to be added or replaced. |
[- {
- "op": "add",
- "path": "/name",
- "value": "new-name"
}
]
{- "value": {
- "type": "gateway",
- "name": "Weather Insights API",
- "logo": "string",
- "desc": "The Weather Insights API provides real-time and historical weather data for any location worldwide.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "auth": {
- "key-auth": {
- "header": "apikey",
- "hide_credentials": false,
- "query": "apikey"
}
}, - "linked_gateway_services": [
- {
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "gateway_group_name": "us-west-rsc",
- "name": "Weather Insights API",
- "version": "1.3.2",
- "status": 0,
- "hosts": [
- "weatherinsights.com"
], - "updated_at": 1742288230,
- "openapi_title": "Weather Insights API - OpenAPI 3.0"
}
], - "status": "draft",
- "subscription_auto_approval": false,
- "can_view_unsubscribed": true,
- "visibility": "public",
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "notifications": [
- {
- "type": "email",
- "email_subject": "API7 Enterprise alert.",
- "content": "This is a alert testing email.",
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "event": "subscription_approval_created",
- "contact_point_ids": [
- "6c97bc5f-3356-41f5-894c-c88df5389bd2"
]
}
]
}
}
IAM Action: portal:DeleteAPIProduct
, Resource: arn:api7:portal:apiproduct/%s
api_product_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the API product. |
""
IAM Action: portal:GetAPIProduct
, Resource: arn:api7:portal:apiproduct/%s
api_product_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the API product. |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
order_by | string Default: "subscribed_at" Enum: "developer_name" "subscribed_at" |
search | string Example: search=version%3Dv2 Condition to search resources by. |
labels | string non-empty Example: labels=labels%5Bversion%5D=v2 Label(s) to filter resources by. The format is |
{- "list": [
- {
- "id": "string",
- "developer_id": "string",
- "developer_name": "string",
- "subscribed_at": 1742288230,
- "application_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "application_name": "us-west-rsc",
- "api_product_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "api_product_name": "us-west-rsc",
- "status": "unsubscribed"
}
], - "total": 1
}
IAM Action: portal:UpdateAPIProduct
, Resource: arn:api7:portal:apiproduct/%s
api_product_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the API product. |
subscription_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 the unique identifier of the subscription. |
""
IAM Action: portal:GetAPIProduct
, Resource: arn:api7:portal:apiproduct/%s
api_product_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the API product. |
notification_type | string Enum: "email" "webhook" The type of the notification. |
event | string Enum: "subscription_approval_created" "subscription_approval_accepted" "subscription_approval_rejected" "subscription_cancelled" Notification trigger. |
contact_point_id | string Example: contact_point_id=6c97bc5f-3356-41f5-894c-c88df5389bd2 The contact point ID of the notification. |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
order_by | string Default: "notified_at" Value: "notified_at" Order to list the notifications by. |
{- "list": [
- {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "notified_at": 1742288230,
- "notification": {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "event": "subscription_approval_created",
- "contact_points": [
- {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "name": "cp-docs-test"
}
], - "type": "email",
- "subject": "API7 Notification",
- "content": "This is a test notification."
}, - "developer_id": "7e4d29f5-a4bc-4e0d-9c02-5a0d8e1c3427",
- "developer_name": "johndoe",
- "application_id": "default",
- "application_name": "Weather Insights API",
- "approval_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "subscription_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "notification_logs": [
- {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "contact_point_name": "cp-docs-test",
- "resource_type": "alert_policy",
- "resource_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "resource_name": "Weather Insights API",
- "status": "failed",
- "send_time": 1759649130,
- "request": "{\"from\": \"test.send@api7.ai\", \"to\": \"test.receive@api7.ai\", \"subject\": \"API7 Notification\", \"content\": \"This is a test notification.\"}",
- "response": "450 The domain must be verified in your account to send emails."
}
], - "resource_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "resource_name": "Weather Insights API"
}
], - "total": 1
}
IAM Action: portal:GetDeveloper
, Resource: arn:api7:portal:developer/%s
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
order_by | string Default: "last_active_at" Enum: "last_active_at" "created_at" Index to order developers by. |
search | string Example: search=version%3Dv2 Condition to search resources by. |
{- "list": [
- {
- "username": "dev1",
- "name": "dev one",
- "last_active_at": 1742288233,
- "email": "developer-test@email.com",
- "email_verified": true,
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "state": "Pending"
}
], - "total": 1
}
IAM Action: portal:InviteDeveloper
, Resource: arn:api7:portal:developer/*
username required | string [ 1 .. 128 ] characters The username of the user. |
password required | string [ 1 .. 128 ] characters The password of the user. |
name | string [ 1 .. 128 ] characters The name of the user. |
{- "username": "john",
- "password": "john-safe-password",
- "name": "john"
}
{- "value": {
- "username": "dev1",
- "name": "dev one",
- "last_active_at": 1742288233,
- "email": "developer-test@email.com",
- "email_verified": true,
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "state": "Pending"
}
}
See Prometheus instant queries for more information.
query required | string Example: query=apisix Prometheus expression query string. |
Unix Timestamp (integer) or RFC3339 Timestamp (string) Evaluation timestamp. Accepts either a Unix timestamp or an RFC3339 timestamp. | |
Float (number) or Duration (string) Evaluation timeout, either as:
| |
limit | integer Maximum number of returned series. 0 means disabled. |
{- "value": {
- "status": "success",
- "data": {
- "resultType": "matrix",
- "result": [
- {
- "metric": {
- "label": "xxx"
}, - "values": [
- [
- 1684740675,
- 1
], - [
- 1684740690,
- 2
]
]
}
]
}
}
}
See Prometheus range queries for more information.
query required | string Example: query=apisix Prometheus expression query string. |
required | Unix Timestamp (integer) or RFC3339 Timestamp (string) Start timestamp, inclusive. Accepts either a Unix timestamp or an RFC3339 timestamp. |
required | Unix Timestamp (integer) or RFC3339 Timestamp (string) End timestamp, inclusive. Accepts either a Unix timestamp or an RFC3339 timestamp. |
required | Float (number) or Duration (string) Query resolution step width, either as:
|
Float (number) or Duration (string) Evaluation timeout, either as:
| |
limit | integer Maximum number of returned series. 0 means disabled. |
{- "value": {
- "status": "success",
- "data": {
- "resultType": "matrix",
- "result": [
- {
- "metric": {
- "label": "xxx"
}, - "values": [
- [
- 1684740675,
- 1
], - [
- 1684740690,
- 2
]
]
}
]
}
}
}
required | Fixed Endpoints (string) or Dynamic Label Values Endpoint (string) Prometheus HTTP API endpoint. See the Prometheus docs for the available URL query parameters for each endpoint. |
{- "value": {
- "status": "success",
- "data": {
- "resultType": "matrix",
- "result": [
- {
- "metric": {
- "label": "xxx"
}, - "values": [
- [
- 1684740675,
- 1
], - [
- 1684740690,
- 2
]
]
}
]
}
}
}
required | Fixed Endpoints (string) or Dynamic Label Values Endpoint (string) Prometheus HTTP API endpoint. See the Prometheus docs for the available body parameters for each endpoint. |
property name* additional property | any |
{- "value": {
- "status": "success",
- "data": {
- "resultType": "matrix",
- "result": [
- {
- "metric": {
- "label": "xxx"
}, - "values": [
- [
- 1684740675,
- 1
], - [
- 1684740690,
- 2
]
]
}
]
}
}
}
IAM Action: gateway:CreateGlobalPluginRule
, Resource: arn:api7:gateway:gatewaygroup/%s
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
plugins required | object Key-value pairs of plugins and their configurations on the object. |
{- "plugins": {
- "key-auth": { }
}
}
{- "value": {
- "plugins": {
- "key-auth": { }
}, - "id": "key-auth",
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:GetGlobalPluginRule
, Resource: arn:api7:gateway:gatewaygroup/%s
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
order_by | string Default: "updated_at" Enum: "created_at" "updated_at" Index to order resources by. |
search | string Example: search=version%3Dv2 Condition to search resources by. |
{- "list": [
- {
- "plugins": {
- "key-auth": { }
}, - "id": "key-auth",
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
], - "total": 1
}
IAM Action: gateway:GetGlobalPluginRule
, Resource: arn:api7:gateway:gatewaygroup/%s
global_rule_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the global rule. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
{- "value": {
- "plugins": {
- "key-auth": { }
}, - "id": "key-auth",
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:UpdateGlobalPluginRule
, Resource: arn:api7:gateway:gatewaygroup/%s
global_rule_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the global rule. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
plugins required | object Key-value pairs of plugins and their configurations on the object. |
{- "plugins": {
- "key-auth": { }
}
}
{- "value": {
- "plugins": {
- "key-auth": { }
}, - "id": "key-auth",
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:DeleteGlobalPluginRule
, Resource: arn:api7:gateway:gatewaygroup/%s
global_rule_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the global rule. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
""
IAM Action: gateway:GetPluginMetadata
, Resource: arn:api7:gateway:gatewaygroup/%s
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
{- "value": {
- "prometheus": {
- "disabled_labels": {
- "status": [
- "code"
]
}
}, - "syslog": {
- "log_format": {
- "@timestamp": "$time_iso8601",
- "client_ip": "$remote_addr",
- "host": "$host",
- "route_id": "$route_id"
}
}
}
}
IAM Action: gateway:GetPluginMetadata
, Resource: arn:api7:gateway:gatewaygroup/%s
plugin_name required | string [ 1 .. 64 ] characters Name of the plugin. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
return_default | boolean Default: false When set to true, the default value is returned when plugin metadata is not found. |
{- "value": {
- "disabled_labels": {
- "status": [
- "code"
]
}
}
}
IAM Action: gateway:UpdatePluginMetadata
, Resource: arn:api7:gateway:gatewaygroup/%s
plugin_name required | string [ 1 .. 64 ] characters Name of the plugin. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
Plugin metadata.
{- "disabled_labels": {
- "status": [
- "code"
]
}
}
{- "value": {
- "disabled_labels": {
- "status": [
- "code"
]
}
}
}
IAM Action: gateway:DeletePluginMetadata
, Resource: arn:api7:gateway:gatewaygroup/%s
plugin_name required | string [ 1 .. 64 ] characters Name of the plugin. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
""
subsystem | string Default: "http" Enum: "http" "stream" Example: subsystem=stream Type to filter the plugin list. |
{- "value": {
- "acl": {
- "schema": {
- "$comment": "this is a mark for our injected plugin schema",
- "allOf": [
- {
- "if": {
- "properties": {
- "external_user_label_field_parser": {
- "const": "segmented_text"
}
}, - "required": [
- "external_user_label_field_parser"
]
}, - "then": {
- "required": [
- "external_user_label_field_separator"
]
}
}
], - "anyOf": [
- {
- "required": [
- "allow_labels"
]
}, - {
- "required": [
- "deny_labels"
]
}
], - "properties": {
- "_meta": {
- "properties": {
- "disable": {
- "type": "boolean"
}, - "error_response": {
- "oneOf": [
- {
- "type": "string"
}, - {
- "type": "object"
}
]
}, - "filter": {
- "description": "filter determines whether the plugin needs to be executed at runtime",
- "type": "array"
}, - "pre_function": {
- "description": "function to be executed in each phase before execution of plugins. The pre_function will have access to two arguments: `conf` and `ctx`.",
- "type": "string"
}, - "priority": {
- "description": "priority of plugins by customized order",
- "type": "integer"
}
}, - "type": "object"
}, - "allow_labels": {
- "minProperties": 1,
- "patternProperties": {
- ".*": {
- "items": {
- "type": "string"
}, - "minItems": 1,
- "type": "array"
}
}, - "type": "object"
}, - "deny_labels": {
- "minProperties": 1,
- "patternProperties": {
- ".*": {
- "items": {
- "type": "string"
}, - "minItems": 1,
- "type": "array"
}
}, - "type": "object"
}, - "external_user_label_field": {
- "default": "groups",
- "type": "string"
}, - "external_user_label_field_key": {
- "minLength": 1,
- "type": "string"
}, - "external_user_label_field_parser": {
- "enum": [
- "segmented_text",
- "json",
- "table"
], - "type": "string"
}, - "external_user_label_field_separator": {
- "description": "The separator(regex) of the segmented_text parser",
- "minLength": 1,
- "type": "string"
}, - "rejected_code": {
- "default": 403,
- "minimum": 200,
- "type": "integer"
}, - "rejected_msg": {
- "type": "string"
}
}, - "type": "object"
}, - "priority": 2410
}, - "ai-aliyun-content-moderation": {
- "schema": {
- "$comment": "this is a mark for our injected plugin schema",
- "encrypt_fields": [
- "access_key_secret"
], - "properties": {
- "_meta": {
- "additionalProperties": false,
- "properties": {
- "disable": {
- "type": "boolean"
}, - "error_response": {
- "oneOf": [
- {
- "type": "string"
}, - {
- "type": "object"
}
]
}, - "filter": {
- "description": "filter determines whether the plugin needs to be executed at runtime",
- "type": "array"
}, - "pre_function": {
- "description": "function to be executed in each phase before execution of plugins. The pre_function will have access to two arguments: `conf` and `ctx`.",
- "type": "string"
}, - "priority": {
- "description": "priority of plugins by customized order",
- "type": "integer"
}
}, - "type": "object"
}, - "access_key_id": {
- "minLength": 1,
- "type": "string"
}, - "access_key_secret": {
- "minLength": 1,
- "type": "string"
}, - "check_request": {
- "default": true,
- "type": "boolean"
}, - "check_response": {
- "default": false,
- "type": "boolean"
}, - "deny_code": {
- "default": 200,
- "type": "number"
}, - "deny_message": {
- "type": "string"
}, - "endpoint": {
- "minLength": 1,
- "type": "string"
}, - "region_id": {
- "minLength": 1,
- "type": "string"
}, - "request_check_length_limit": {
- "default": 2000,
- "type": "number"
}, - "request_check_service": {
- "default": "llm_query_moderation",
- "minLength": 1,
- "type": "string"
}, - "response_check_length_limit": {
- "default": 5000,
- "type": "number"
}, - "response_check_service": {
- "default": "llm_response_moderation",
- "minLength": 1,
- "type": "string"
}, - "risk_level_bar": {
- "default": "high",
- "enum": [
- "none",
- "low",
- "medium",
- "high",
- "max"
], - "type": "string"
}, - "ssl_verify": {
- "default": true,
- "type": "boolean"
}, - "stream_check_cache_size": {
- "default": 128,
- "description": "max characters per moderation batch in realtime mode",
- "minimum": 1,
- "type": "integer"
}, - "stream_check_interval": {
- "default": 3,
- "description": "seconds between batch checks in realtime mode",
- "minimum": 0.1,
- "type": "number"
}, - "stream_check_mode": {
- "default": "final_packet",
- "description": "realtime: batched checks during streaming | final_packet: append risk_level at end\n",
- "enum": [
- "realtime",
- "final_packet"
], - "type": "string"
}, - "timeout": {
- "default": 10000,
- "description": "timeout in milliseconds",
- "minimum": 1,
- "type": "integer"
}
}, - "required": [
- "endpoint",
- "region_id",
- "access_key_id",
- "access_key_secret"
], - "type": "object"
}, - "priority": 1029
}
}
}
has_metadata | boolean Default: false If true, show plugin names where the plugins have metadata. |
subsystem | string Default: "http" Enum: "http" "stream" Example: subsystem=stream Type to filter the plugin list. |
[- "ip-restriction",
- "limit-conn",
- "mqtt-proxy",
- "prometheus",
- "syslog"
]
Get schema definition of a plugin, including plugin meta properties and plugin properties.
The endpoint returns the same response as the /apisix/admin/schema/plugins/{plugin_name}
endpoint when scope
is not set.
plugin_name required | string [ 1 .. 64 ] characters Name of the plugin. |
scope | string Value: "all" The scope of the returned plugin information. |
subsystem | string Default: "http" Enum: "http" "stream" Example: subsystem=stream Type to filter the plugin list. |
{- "value": {
- "$comment": "this is a mark for our injected plugin schema",
- "properties": {
- "_meta": {
- "properties": {
- "disable": {
- "type": "boolean"
}, - "error_response": {
- "oneOf": [
- {
- "type": "string"
}, - {
- "type": "object"
}
]
}, - "filter": {
- "description": "filter determines whether the plugin needs to be executed at runtime",
- "type": "array"
}, - "pre_function": {
- "description": "function to be executed in each phase before execution of plugins. The pre_function will have access to two arguments: `conf` and `ctx`.",
- "type": "string"
}, - "priority": {
- "description": "priority of plugins by customized order",
- "type": "integer"
}
}, - "type": "object"
}, - "prefer_name": {
- "default": false,
- "type": "boolean"
}
}, - "type": "object"
}
}
Get schema definition of a plugin, including plugin meta properties and plugin properties.
plugin_name required | string [ 1 .. 64 ] characters Name of the plugin. |
subsystem | string Default: "http" Enum: "http" "stream" Example: subsystem=stream Type to filter the plugin list. |
{- "value": {
- "$comment": "this is a mark for our injected plugin schema",
- "properties": {
- "_meta": {
- "properties": {
- "disable": {
- "type": "boolean"
}, - "error_response": {
- "oneOf": [
- {
- "type": "string"
}, - {
- "type": "object"
}
]
}, - "filter": {
- "description": "filter determines whether the plugin needs to be executed at runtime",
- "type": "array"
}, - "pre_function": {
- "description": "function to be executed in each phase before execution of plugins. The pre_function will have access to two arguments: `conf` and `ctx`.",
- "type": "string"
}, - "priority": {
- "description": "priority of plugins by customized order",
- "type": "integer"
}
}, - "type": "object"
}, - "prefer_name": {
- "default": false,
- "type": "boolean"
}
}, - "type": "object"
}
}
subsystem | string Default: "http" Enum: "http" "stream" Example: subsystem=stream Type to filter the plugin list. |
gateway_group_id | string >= 1 Gateway group ID. |
{- "value": [
- {
- "plugin_name": "prometheus",
- "type": "Observability",
- "is_custom": false
}
]
}
plugin_name required | string [ 1 .. 64 ] characters Name of the plugin. |
{- "value": {
- "consumer_credential": {
- "list": [
- {
- "name": "ka",
- "id": "9f1c2c80b6093aa7e9cbd9f0855f56586a646ba0",
- "gateway_group_id": "default",
- "gateway_group_name": "default"
}, - {
- "name": "jack",
- "id": "439129f8-a6c5-4ea7-9f96-6ed108cfc0b0",
- "gateway_group_id": "ce9bf912-eb47-4c28-85a7-ffae5256d226",
- "gateway_group_name": "jack"
}, - {
- "name": "test",
- "id": "21c3b211-2463-4cfc-8eb4-1f8cd679eec0",
- "gateway_group_id": "b14f4ec3-f79b-4aa7-baeb-f892540c26f3",
- "gateway_group_name": "29jjc"
}
], - "total": 3
}, - "published_service": {
- "list": [
- {
- "name": "httpbin",
- "id": "60109630-3022-4c6d-9b1f-0440ec88ef5f",
- "gateway_group_id": "bfc91d42-b83a-4309-8cab-6763c27f715e",
- "gateway_group_name": "jw_test"
}, - {
- "name": "name2",
- "id": "4bc1938e-8d3c-4a89-8089-b31bfa6989dc",
- "gateway_group_id": "b14f4ec3-f79b-4aa7-baeb-f892540c26f3",
- "gateway_group_name": "29jjc"
}
], - "total": 2
}
}
}
resource_name required | string >= 1 Enum: "service" "upstream" "stream_service" "route" "consumer" "consumer_credential" "global_rule" "ssl" "vault_secret" "aws_secret" "kubernetes_secret" "plugin_metadata" "stream_route" Example: consumer Name of the resource. |
{- "value": { },
- "description": "The consumer description.",
- "properties": {
- "desc": {
- "description": "The object description.",
- "maxLength": 65536,
- "type": "string"
}, - "labels": {
- "additionalProperties": {
- "maxLength": 65536,
- "minLength": 1,
- "pattern": "^.+$",
- "type": "string"
}, - "example": {
- "keyA": "valueA",
- "keyB": "valueB"
}, - "type": "object"
}, - "plugins": {
- "description": "The key-value pairs which represent the plugins attached on the object.",
- "type": "object"
}, - "username": {
- "maxLength": 512,
- "minLength": 1,
- "pattern": "^[a-zA-Z0-9_\\-]+$",
- "type": "string"
}
}, - "required": [
- "username"
], - "type": "object"
}
Get schema definition of a plugin, including plugin meta properties and plugin properties.
plugin_name required | string [ 1 .. 64 ] characters Name of the plugin. |
subsystem | string Default: "http" Enum: "http" "stream" Example: subsystem=stream Type to filter the plugin list. |
{- "value": {
- "$comment": "this is a mark for our injected plugin schema",
- "properties": {
- "_meta": {
- "properties": {
- "disable": {
- "type": "boolean"
}, - "error_response": {
- "oneOf": [
- {
- "type": "string"
}, - {
- "type": "object"
}
]
}, - "filter": {
- "description": "filter determines whether the plugin needs to be executed at runtime",
- "type": "array"
}, - "pre_function": {
- "description": "function to be executed in each phase before execution of plugins. The pre_function will have access to two arguments: `conf` and `ctx`.",
- "type": "string"
}, - "priority": {
- "description": "priority of plugins by customized order",
- "type": "integer"
}
}, - "type": "object"
}, - "prefer_name": {
- "default": false,
- "type": "boolean"
}
}, - "type": "object"
}
}
The endpoint returns the request body schema of PUT/POST requests for users to understand how to structure a request.
method required | string >= 1 Enum: "POST" "PUT" HTTP method to determine which request body to return. |
path required | string >= 1 Example: path=/apisix/admin/consumers API endpoint. |
{- "value": { },
- "description": "The consumer description.",
- "properties": {
- "desc": {
- "description": "The object description.",
- "maxLength": 65536,
- "type": "string"
}, - "labels": {
- "additionalProperties": {
- "maxLength": 65536,
- "minLength": 1,
- "pattern": "^.+$",
- "type": "string"
}, - "example": {
- "keyA": "valueA",
- "keyB": "valueB"
}, - "type": "object"
}, - "plugins": {
- "description": "The key-value pairs which represent the plugins attached on the object.",
- "type": "object"
}, - "username": {
- "maxLength": 512,
- "minLength": 1,
- "pattern": "^[a-zA-Z0-9_\\-]+$",
- "type": "string"
}
}, - "required": [
- "username"
], - "type": "object"
}
{- "value": {
- "service": { },
- "route": { },
- "stream_service": { },
- "stream_route": { },
- "upstream": { },
- "consumer": { },
- "consumer_credential": { },
- "global_rule": { },
- "ssl": { },
- "aws_secret": { },
- "vault_secret": { },
- "kubernetes_secret": { },
- "plugin_metadata": { }
}
}
IAM Action: gateway:GetGatewayInstance
, Resource: arn:api7:gateway:gatewaygroup/%s
gateway_group_id | string >= 1 Gateway group ID. |
order_by | string Default: "last_heartbeat_time" Enum: "created_at" "last_heartbeat_time" Index to order gateway instances by. |
status | string Enum: "Healthy" "OutOfSync" "LostConnection" "Offline" The value of the instance status. |
compatibility | string Enum: "Compatible" "Incompatible" "PartiallyCompatible" The compatibility of the gateway instance version. |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
search | string Example: search=version%3Dv2 Condition to search resources by. |
{- "list": [
- {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "hostname": "api7-ee-3-gateway-56ffbfd46d-p99fj",
- "ip": "192.168.215.2",
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "version": "3.2.2",
- "ports": [
- 9080,
- 9443
], - "last_heartbeat_time": 1742288230,
- "last_retrieve_config_time": 1742288230,
- "to_be_deleted_at": 1742288230,
- "created_at": 1742288232,
- "dataplane_certificate_expire_time": 1742288230,
- "status": "Healthy",
- "cores": 1,
- "compatibility": "Compatible"
}
], - "total": 1
}
IAM Action: gateway:GetGatewayInstance
, Resource: arn:api7:gateway:gatewaygroup/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
order_by | string Default: "last_heartbeat_time" Enum: "created_at" "last_heartbeat_time" Index to order gateway instances by. |
status | string Enum: "Healthy" "OutOfSync" "LostConnection" "Offline" The value of the instance status. |
compatibility | string Enum: "Compatible" "Incompatible" "PartiallyCompatible" The compatibility of the gateway instance version. |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
search | string Example: search=version%3Dv2 Condition to search resources by. |
{- "list": [
- {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "hostname": "api7-ee-3-gateway-56ffbfd46d-p99fj",
- "ip": "192.168.215.2",
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "version": "3.2.2",
- "ports": [
- 9080,
- 9443
], - "last_heartbeat_time": 1742288230,
- "last_retrieve_config_time": 1742288230,
- "to_be_deleted_at": 1742288230,
- "created_at": 1742288232,
- "dataplane_certificate_expire_time": 1742288230,
- "status": "Healthy",
- "cores": 1,
- "compatibility": "Compatible"
}
], - "total": 1
}
IAM Action: gateway:GetGatewayInstance
, Resource: arn:api7:gateway:gatewaygroup/%s
field required | string Value: "status" Field to count by. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
search | string Example: search=version%3Dv2 Condition to search resources by. |
{- "value": [
- {
- "key": "Healthy",
- "count": 1
}
]
}
The gateway instance’s core usage is exported hourly within the specified time interval.
IAM Action: gateway:GetGatewayInstanceCore
, Resource: arn:api7:gateway:gatewaygroup/*
begin_at required | integer <int64> The start time to export the gateway instance core usage. |
end_at required | integer <int64> The end time to export the gateway instance core usage. |
time,max_dp_cores 1749132000,9 1749128400,9 1749124800,9 1749121200,9 1749117600,9 1749114000,9 1749110400,9 1749106800,17 1749103200,1 1749099600,1 1749096000,1 1749092400,1 1749088800,1
IAM Action: gateway:CreateGatewayInstance
, Resource: arn:api7:gateway:gatewaygroup/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
dp_manager_address | string non-empty Example: dp_manager_address=10.15.101.5 The IP address of the control plane. |
validity_period | integer [ 1 .. 10950 ] Default: 3650 The validity period of the certificate in days. |
image | string non-empty Example: image=api7/api7-ee-3-gateway Docker image. |
http_port | integer Default: 9080 The HTTP port of the control plane. |
https_port | integer Default: 9443 The HTTPS port of the control plane. |
name | string non-empty The hostname of the control plane. |
extra_args[] | Array of strings Example: extra_args[]=a=b&extra_args[]=c=d Additional docker run arguments. |
docker run -d -e API7_CONTROL_PLANE_ENDPOINTS='["https://12.12.123.123:31344"]' \ -e API7_GATEWAY_GROUP_SHORT_ID=tabqbdwnahkqo \ -e API7_CONTROL_PLANE_CERT="-----BEGIN CERTIFICATE----- MIIBhjCCATigAwIBAgICBAAwBQYDK2VwMEQxCzAJBgNVBAYTAlVTMRMwEQYDVQQI ... -----END CERTIFICATE-----" \ -e API7_CONTROL_PLANE_KEY="-----BEGIN PRIVATE KEY----- MC4CAQAwBQYDK2VwBCIEIG1Q/eJDdTZ4krnd7ezprKcZ2ASeTSrhpWglMzh9d0Hs -----END PRIVATE KEY-----" \ -e API7_CONTROL_PLANE_CA="-----BEGIN CERTIFICATE----- MIIBdTCCASegAwIBAgIQVXqTFu/hH4caZptKdGp04zAFBgMrZXAwRDELMAkGA1UE ... -----END CERTIFICATE-----" \ -e API7_CONTROL_PLANE_SNI="api7ee3-dp-manager" \ -p 9080:9080 \ -p 9443:9443 \ api7/api7-ee-3-gateway:latest
IAM Action: gateway:CreateGatewayInstance
, Resource: arn:api7:gateway:gatewaygroup/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
dp_manager_address | string non-empty Example: dp_manager_address=10.15.101.5 The IP address of the control plane. |
validity_period | integer [ 1 .. 10950 ] Default: 3650 The validity period of the certificate in days. |
name required | string Gateway name. |
namespace required | string Gateway namespace. |
service_account | string Service account to install the gateway. |
replicas | integer Default: 1 The number of replicas. |
workers | integer Example: workers=5 The number of worker processes for the gateway instance. By default, it is configured to match the number of CPU cores on the server hosting the gateway instance. |
cpu_limit | string Example: cpu_limit=6 The CPU limit in number of cores. |
memory_limit | string Example: memory_limit=6Gi The memory limit. Use the format |
extra_values[] | Array of strings Example: extra_values[]=a=b&extra_values[]=c=d Extra values to be passed to the Helm chart, in the form of |
helm repo add api7 https://charts.api7.ai helm repo update cat > /tmp/tls.crt <<EOF -----BEGIN CERTIFICATE----- MIIBhjCCATigAwIBAgICBAAwBQYDK2VwMEQxCzAJBgNVBAYTAlVTMRMwEQYDVQQI ... -----END CERTIFICATE----- EOF cat > /tmp/tls.key <<EOF -----BEGIN PRIVATE KEY----- MC4CAQAwBQ...AuNANhyrM9qUepu5ZGtVgXnX -----END PRIVATE KEY----- EOF cat > /tmp/ca.crt <<EOF -----BEGIN CERTIFICATE----- MIIBdTCCASegAwIBAgIQVXqTFu/hH4caZptKdGp04zAFBgMrZXAwRDELMAkGA1UE ... -----END CERTIFICATE----- -----BEGIN CERTIFICATE----- MIIBeDCCASqgAwIBAgIRAPNxgFOmSXOwtIdZOgynsLswBQYDK2VwMEQxCzAJBgNV ... -----END CERTIFICATE----- EOF kubectl create namespace default --dry-run=client -o yaml | kubectl apply -f - kubectl create secret generic -n default name-tls --from-file=tls.crt=/tmp/tls.crt --from-file=tls.key=/tmp/tls.key --from-file=ca.crt=/tmp/ca.crt helm upgrade --install -n default --create-namespace name api7/gateway \ --set "etcd.auth.tls.enabled=true" \ --set "etcd.auth.tls.existingSecret=name-tls" \ --set "etcd.auth.tls.certFilename=tls.crt" \ --set "etcd.auth.tls.certKeyFilename=tls.key" \ --set "etcd.auth.tls.sni=api7ee3-dp-manager" \ --set "etcd.auth.tls.verify=true" \ --set "gateway.tls.existingCASecret=name-tls" \ --set "gateway.tls.certCAFilename=ca.crt" \ --set "apisix.extraEnvVars[0].name=API7_GATEWAY_GROUP_SHORT_ID" \ --set "apisix.extraEnvVars[0].value=tabqbdwnahkqo" \ --set "etcd.host[0]=https://12.12.123.123:31344" \ --set "apisix.resources.limits.cpu=4" \ --set "apisix.resources.limits.memory=7168Mi" \ --set "apisix.replicaCount=1" \ --set "apisix.image.repository=api7/api7-ee-3-gateway" \ --set "apisix.image.tag=latest"
IAM Action: gateway:CreateGatewayInstance
, Resource: arn:api7:gateway:gatewaygroup/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
dp_manager_address | string non-empty Example: dp_manager_address=10.15.101.5 The IP address of the control plane. |
validity_period | integer [ 1 .. 10950 ] Default: 3650 The validity period of the certificate in days. |
name required | string Gateway name. |
namespace required | string Gateway namespace. |
service_account | string Service account to install the gateway. |
replicas | integer Default: 1 The number of replicas. |
workers | integer Example: workers=5 The number of worker processes for the gateway instance. By default, it is configured to match the number of CPU cores on the server hosting the gateway instance. |
cpu_limit | string Example: cpu_limit=6 The CPU limit in number of cores. |
memory_limit | string Example: memory_limit=6Gi The memory limit. Use the format |
apiVersion: v1 data: tls.crt: LS0tLS1CRUdJTiB... tls.key: LS0tLS1CRUdJTiB... ca.crt: LS0tLS1CRUdJTiB... kind: Secret metadata: name: name-tls namespace: default type: kubernetes.io/tls --- apisix: replicaCount: 1 image: repository: api7/api7-ee-3-gateway tag: dev extraEnvVars: - name: API7_GATEWAY_GROUP_SHORT_ID value: "tabqbdwnahkqo" etcd: host: - "https://12.12.123.123:31344" auth: tls: enabled: true existingSecret: name-tls certFilename: tls.crt certKeyFilename: tls.key sni: api7ee3-dp-manager verify: true gateway: tls: existingCASecret: name-tls certCAFilename: ca.crt
IAM Action: gateway:DeleteGatewayInstance
, Resource: arn:api7:gateway:gatewaygroup/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
gateway_instance_id required | string >= 1 Gateway instance ID. |
""
IAM Action: gateway:CreateGatewayInstance
, Resource: arn:api7:gateway:gatewaygroup/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
validity_period | integer [ 1 .. 10950 ] Default: 3650 The validity period of the certificate in days. |
{- "validity_period": 3650
}
{- "value": {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "certificate": "-----BEGIN CERTIFICATE-----\\n...\\n-----END CERTIFICATE-----\\n",
- "private_key": "-----BEGIN PRIVATE KEY-----\\n...\\n-----END PRIVATE KEY-----\\n",
- "expiry": 1742288230
}
}
IAM Action: gateway:CreateGatewayInstance
, Resource: arn:api7:gateway:gatewaygroup/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
only_token | boolean If true, the response will only contain the token. |
{- "value": {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "token_plain_text": "tubqbejxbhuao-2MIFcKD1dfaIm0i36Cqb2V2xfuIdwh9f60PJy0C1wYxBMeoTU2-8d2adba4c1444dd69a6d66e47b5ebff1"
}
}
IAM Action: gateway:GetGatewayInstance
, Resource: arn:api7:gateway:gatewaygroup/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
order_by | string Default: "last_heartbeat_time" Enum: "created_at" "last_heartbeat_time" Index to order gateway instances by. |
status | string Enum: "Healthy" "OutOfSync" "LostConnection" "Offline" The value of the instance status. |
compatibility | string Enum: "Compatible" "Incompatible" "PartiallyCompatible" The compatibility of the gateway instance version. |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
search | string Example: search=version%3Dv2 Condition to search resources by. |
{- "list": [
- {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "hostname": "api7-ee-3-gateway-56ffbfd46d-p99fj",
- "ip": "192.168.215.2",
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "version": "3.2.2",
- "ports": [
- 9080,
- 9443
], - "last_heartbeat_time": 1742288230,
- "last_retrieve_config_time": 1742288230,
- "to_be_deleted_at": 1742288230,
- "created_at": 1742288232,
- "dataplane_certificate_expire_time": 1742288230,
- "status": "Healthy",
- "cores": 1,
- "compatibility": "Compatible"
}
], - "total": 1
}
IAM Action: gateway:GetGatewayInstance
, Resource: arn:api7:gateway:gatewaygroup/%s
field required | string Value: "status" Field to count by. |
gateway_group_id required | string >= 1 Example: gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. Optional when using the gateway group admin key to authenticate. |
search | string Example: search=version%3Dv2 Condition to search resources by. |
{- "value": [
- {
- "key": "Healthy",
- "count": 1
}
]
}
The gateway instance’s core usage is exported hourly within the specified time interval.
IAM Action: gateway:GetGatewayInstanceCore
, Resource: arn:api7:gateway:gatewaygroup/*
begin_at required | integer <int64> The start time to export the gateway instance core usage. |
end_at required | integer <int64> The end time to export the gateway instance core usage. |
time,max_dp_cores 1749132000,9 1749128400,9 1749124800,9 1749121200,9 1749117600,9 1749114000,9 1749110400,9 1749106800,17 1749103200,1 1749099600,1 1749096000,1 1749092400,1 1749088800,1
IAM Action: gateway:GetGatewayGroup
, Resource: arn:api7:gateway:gatewaygroup/%s
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
order_by | string Default: "updated_at" Enum: "created_at" "updated_at" Index to order resources by. |
search | string Example: search=version%3Dv2 Condition to search resources by. |
labels | string non-empty Example: labels=labels%5Bversion%5D=v2 Label(s) to filter resources by. The format is |
{- "list": [
- {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "type": "api7_gateway",
- "name": "us-west-rsc",
- "description": "Gateway group description.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "enforce_service_publishing": true,
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "config": {
- "control_plane_key_prefix": "/gateway_groups/us-west-1",
- "control_plane_user": "etcd_user",
- "control_plane_password": "safe_password",
- "image_tag": "latest"
}
}
], - "total": 1
}
IAM Action: gateway:CreateGatewayGroup
, Resource: arn:api7:gateway:gatewaygroup/%s
type | string Default: "api7_gateway" Enum: "api7_gateway" "api7_ingress_controller" |
name required | string [ 1 .. 100 ] characters The object name. |
description | string Gateway group description. |
object Key-value pairs of labels. | |
enforce_service_publishing | boolean If ture, bypass version control and rollback when updating services directly on a gateway group. |
{- "type": "api7_gateway",
- "name": "us-west-rsc",
- "description": "Gateway group description.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "enforce_service_publishing": true
}
{- "value": {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "type": "api7_gateway",
- "name": "us-west-rsc",
- "description": "Gateway group description.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "enforce_service_publishing": true,
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "config": {
- "control_plane_key_prefix": "/gateway_groups/us-west-1",
- "control_plane_user": "etcd_user",
- "control_plane_password": "safe_password",
- "image_tag": "latest"
}
}
}
resource_type required | string Enum: "ssl" "consumer" "gateway_instance" Resource type. |
{- "list": [
- {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "type": "api7_gateway",
- "name": "us-west-rsc",
- "description": "Gateway group description.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "enforce_service_publishing": true,
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "config": {
- "control_plane_key_prefix": "/gateway_groups/us-west-1",
- "control_plane_user": "etcd_user",
- "control_plane_password": "safe_password",
- "image_tag": "latest"
}, - "count": 0
}
], - "total": 1
}
IAM Action: gateway:GetSSLCertificate
, Resource: arn:api7:gateway:gatewaygroup/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
ssl_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the SSL object. |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
order_by | string Default: "updated_at" Enum: "created_at" "updated_at" Index to order resources by. |
{- "list": [
- {
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "service_name": "us-west-rsc",
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "upstream_name": "sample-upstream",
- "ssl_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
], - "total": 1
}
IAM Action: gateway:GetSNI
, Resource: arn:api7:gateway:gatewaygroup/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
sni_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the SNI object. |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
search | string Example: search=version%3Dv2 Condition to search resources by. |
{- "list": [
- {
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "service_name": "us-west-rsc",
- "hosts": [
- "httpbin.org"
]
}
], - "total": 1
}
IAM Action: gateway:GetCertificate
, Resource: arn:api7:gateway:gatewaygroup/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
certificate_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the Certificate. |
resource_type | string Default: "sni" Enum: "sni" "upstream" Type of resource referencing the certificate. |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
order_by | string Default: "updated_at" Enum: "created_at" "updated_at" Index to order resources by. |
search | string Example: search=version%3Dv2 Condition to search resources by. |
{- "list": [
- {
- "sni_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "sni_name": "sample-sni",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "service_name": "us-west-rsc",
- "hosts": [
- "httpbin.org"
]
}
], - "total": 1
}
IAM Action: gateway:GetCACertificate
, Resource: arn:api7:gateway:gatewaygroup/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
ca_certificate_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the certificate. |
resource_type | string Default: "sni" Enum: "sni" "upstream" Type of resource referencing the certificate. |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
order_by | string Default: "updated_at" Enum: "created_at" "updated_at" Index to order resources by. |
search | string Example: search=version%3Dv2 Condition to search resources by. |
{- "list": [
- {
- "sni_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "sni_name": "sample-sni",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "service_name": "us-west-rsc",
- "hosts": [
- "httpbin.org"
]
}
], - "total": 1
}
IAM Action: gateway:GetCACertificate
, Resource: arn:api7:gateway:gatewaygroup/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
Certificate Reference (string) or Certificate Content (string) Certificate. | |
One of string (Certificate Reference) ^\$(secret|env|ENV):// Path to the certificate in environment variable or secret manager. |
{- "cert": "$secret://aws/john/apisix-secrets/john-key-auth"
}
{- "value": {
- "name": "us-west-rsc",
- "desc": "Object description.",
- "cert": "$secret://aws/john/apisix-secrets/john-key-auth",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "common_name": "example.com",
- "subject_alt_names": [
- "www.example.com"
], - "associated_snis": [
- "1cf56bfe-7727-4584-93f2-9d09271bd42a"
], - "exptime": 1735680000,
- "validity_start": 1714540800,
- "validity_end": 1730419200
}
}
IAM Action: gateway:GetCACertificate
, Resource: arn:api7:gateway:gatewaygroup/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
cert | string [ 1 .. 65536 ] characters ^[^\$] The certificate in PEM format. |
{- "cert": "-----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----"
}
{- "value": {
- "name": "us-west-rsc",
- "desc": "Object description.",
- "cert": "-----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "associated_snis": [
- "string"
], - "exptime": 1735680000,
- "validity_start": 1714540800,
- "validity_end": 1730419200
}
}
IAM Action: gateway:GetSecretProvider
, Resource: arn:api7:gateway:gatewaygroup/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
secret_provider required | string Enum: "vault" "aws" "kubernetes" Secret provider. |
secret_provider_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 Secret provider ID. |
resource_type | string Enum: "consumer" "service" "route" "ssl" "global_rule" "consumer_credential" "certificate" Resource type. |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
order_by | string Default: "updated_at" Enum: "created_at" "updated_at" Index to order resources by. |
{- "list": [
- {
- "parent_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "resource_type": "route",
- "resource_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "resource_name": "us-west-rsc",
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "field": "key-auth/key",
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "secret_manager": "vault",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
], - "total": 1
}
IAM Action: gateway:DeleteGatewayGroup
, Resource: arn:api7:gateway:gatewaygroup/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
""
IAM Action: gateway:UpdateGatewayGroup
, Resource: arn:api7:gateway:gatewaygroup/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
name required | string [ 1 .. 100 ] characters The object name. |
description required | string Gateway group description. |
object Key-value pairs of labels. |
{- "name": "us-west-rsc",
- "description": "Gateway group description.",
- "labels": {
- "version": "v2",
- "env": "prod"
}
}
{- "value": {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "type": "api7_gateway",
- "name": "us-west-rsc",
- "description": "Gateway group description.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "enforce_service_publishing": true,
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "config": {
- "control_plane_key_prefix": "/gateway_groups/us-west-1",
- "control_plane_user": "etcd_user",
- "control_plane_password": "safe_password",
- "image_tag": "latest"
}
}
}
IAM Action: gateway:GetGatewayGroup
, Resource: arn:api7:gateway:gatewaygroup/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
{- "value": {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "type": "api7_gateway",
- "name": "us-west-rsc",
- "description": "Gateway group description.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "enforce_service_publishing": true,
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "config": {
- "control_plane_key_prefix": "/gateway_groups/us-west-1",
- "control_plane_user": "etcd_user",
- "control_plane_password": "safe_password",
- "image_tag": "latest"
}
}
}
IAM Action: gateway:GetAdminKey
, Resource: arn:api7:gateway:gatewaygroup/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
{- "value": {
- "key": "a7ee-iBTTIAOm76y2Q7h2xxxxx1uCyVQ3HY36l6hH98igxxxxxx-a591ad8b17db4f88b24b3c5602356971"
}
}
IAM Action: gateway:UpdateGatewayGroup
, Resource: arn:api7:gateway:gatewaygroup/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
{- "value": {
- "key": "a7ee-iBTTIAOm76y2Q7h2xxxxx1uCyVQ3HY36l6hH98igxxxxxx-a591ad8b17db4f88b24b3c5602356971"
}
}
IAM Action: gateway:CreateGatewayInstance
, Resource: arn:api7:gateway:gatewaygroup/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
dp_manager_address | string non-empty Example: dp_manager_address=10.15.101.5 The IP address of the control plane. |
validity_period | integer [ 1 .. 10950 ] Default: 3650 The validity period of the certificate in days. |
image | string non-empty Example: image=api7/api7-ee-3-gateway Docker image. |
http_port | integer Default: 9080 The HTTP port of the control plane. |
https_port | integer Default: 9443 The HTTPS port of the control plane. |
name | string non-empty The hostname of the control plane. |
extra_args[] | Array of strings Example: extra_args[]=a=b&extra_args[]=c=d Additional docker run arguments. |
docker run -d -e API7_CONTROL_PLANE_ENDPOINTS='["https://12.12.123.123:31344"]' \ -e API7_GATEWAY_GROUP_SHORT_ID=tabqbdwnahkqo \ -e API7_CONTROL_PLANE_CERT="-----BEGIN CERTIFICATE----- MIIBhjCCATigAwIBAgICBAAwBQYDK2VwMEQxCzAJBgNVBAYTAlVTMRMwEQYDVQQI ... -----END CERTIFICATE-----" \ -e API7_CONTROL_PLANE_KEY="-----BEGIN PRIVATE KEY----- MC4CAQAwBQYDK2VwBCIEIG1Q/eJDdTZ4krnd7ezprKcZ2ASeTSrhpWglMzh9d0Hs -----END PRIVATE KEY-----" \ -e API7_CONTROL_PLANE_CA="-----BEGIN CERTIFICATE----- MIIBdTCCASegAwIBAgIQVXqTFu/hH4caZptKdGp04zAFBgMrZXAwRDELMAkGA1UE ... -----END CERTIFICATE-----" \ -e API7_CONTROL_PLANE_SNI="api7ee3-dp-manager" \ -p 9080:9080 \ -p 9443:9443 \ api7/api7-ee-3-gateway:latest
IAM Action: gateway:CreateGatewayInstance
, Resource: arn:api7:gateway:gatewaygroup/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
dp_manager_address | string non-empty Example: dp_manager_address=10.15.101.5 The IP address of the control plane. |
validity_period | integer [ 1 .. 10950 ] Default: 3650 The validity period of the certificate in days. |
name required | string Gateway name. |
namespace required | string Gateway namespace. |
service_account | string Service account to install the gateway. |
replicas | integer Default: 1 The number of replicas. |
workers | integer Example: workers=5 The number of worker processes for the gateway instance. By default, it is configured to match the number of CPU cores on the server hosting the gateway instance. |
cpu_limit | string Example: cpu_limit=6 The CPU limit in number of cores. |
memory_limit | string Example: memory_limit=6Gi The memory limit. Use the format |
extra_values[] | Array of strings Example: extra_values[]=a=b&extra_values[]=c=d Extra values to be passed to the Helm chart, in the form of |
helm repo add api7 https://charts.api7.ai helm repo update cat > /tmp/tls.crt <<EOF -----BEGIN CERTIFICATE----- MIIBhjCCATigAwIBAgICBAAwBQYDK2VwMEQxCzAJBgNVBAYTAlVTMRMwEQYDVQQI ... -----END CERTIFICATE----- EOF cat > /tmp/tls.key <<EOF -----BEGIN PRIVATE KEY----- MC4CAQAwBQ...AuNANhyrM9qUepu5ZGtVgXnX -----END PRIVATE KEY----- EOF cat > /tmp/ca.crt <<EOF -----BEGIN CERTIFICATE----- MIIBdTCCASegAwIBAgIQVXqTFu/hH4caZptKdGp04zAFBgMrZXAwRDELMAkGA1UE ... -----END CERTIFICATE----- -----BEGIN CERTIFICATE----- MIIBeDCCASqgAwIBAgIRAPNxgFOmSXOwtIdZOgynsLswBQYDK2VwMEQxCzAJBgNV ... -----END CERTIFICATE----- EOF kubectl create namespace default --dry-run=client -o yaml | kubectl apply -f - kubectl create secret generic -n default name-tls --from-file=tls.crt=/tmp/tls.crt --from-file=tls.key=/tmp/tls.key --from-file=ca.crt=/tmp/ca.crt helm upgrade --install -n default --create-namespace name api7/gateway \ --set "etcd.auth.tls.enabled=true" \ --set "etcd.auth.tls.existingSecret=name-tls" \ --set "etcd.auth.tls.certFilename=tls.crt" \ --set "etcd.auth.tls.certKeyFilename=tls.key" \ --set "etcd.auth.tls.sni=api7ee3-dp-manager" \ --set "etcd.auth.tls.verify=true" \ --set "gateway.tls.existingCASecret=name-tls" \ --set "gateway.tls.certCAFilename=ca.crt" \ --set "apisix.extraEnvVars[0].name=API7_GATEWAY_GROUP_SHORT_ID" \ --set "apisix.extraEnvVars[0].value=tabqbdwnahkqo" \ --set "etcd.host[0]=https://12.12.123.123:31344" \ --set "apisix.resources.limits.cpu=4" \ --set "apisix.resources.limits.memory=7168Mi" \ --set "apisix.replicaCount=1" \ --set "apisix.image.repository=api7/api7-ee-3-gateway" \ --set "apisix.image.tag=latest"
IAM Action: gateway:CreateGatewayInstance
, Resource: arn:api7:gateway:gatewaygroup/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
dp_manager_address | string non-empty Example: dp_manager_address=10.15.101.5 The IP address of the control plane. |
validity_period | integer [ 1 .. 10950 ] Default: 3650 The validity period of the certificate in days. |
name required | string Gateway name. |
namespace required | string Gateway namespace. |
service_account | string Service account to install the gateway. |
replicas | integer Default: 1 The number of replicas. |
workers | integer Example: workers=5 The number of worker processes for the gateway instance. By default, it is configured to match the number of CPU cores on the server hosting the gateway instance. |
cpu_limit | string Example: cpu_limit=6 The CPU limit in number of cores. |
memory_limit | string Example: memory_limit=6Gi The memory limit. Use the format |
apiVersion: v1 data: tls.crt: LS0tLS1CRUdJTiB... tls.key: LS0tLS1CRUdJTiB... ca.crt: LS0tLS1CRUdJTiB... kind: Secret metadata: name: name-tls namespace: default type: kubernetes.io/tls --- apisix: replicaCount: 1 image: repository: api7/api7-ee-3-gateway tag: dev extraEnvVars: - name: API7_GATEWAY_GROUP_SHORT_ID value: "tabqbdwnahkqo" etcd: host: - "https://12.12.123.123:31344" auth: tls: enabled: true existingSecret: name-tls certFilename: tls.crt certKeyFilename: tls.key sni: api7ee3-dp-manager verify: true gateway: tls: existingCASecret: name-tls certCAFilename: ca.crt
IAM Action: gateway:GetAdminKey
, Resource: arn:api7:gateway:gatewaygroup/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
name required | string Gateway name. |
namespace required | string Gateway namespace. |
type | string Default: "gateway-api" Enum: "gateway-api" "ingress" "ingress-v1beta1" |
kubectl create namespace default --dry-run=client -o yaml | kubectl apply -f - echo " --- apiVersion: gateway.networking.k8s.io/v1 kind: GatewayClass metadata: name: apisix spec: controllerName: apisix.apache.org/apisix-ingress-controller --- apiVersion: apisix.apache.org/v1alpha1 kind: GatewayProxy metadata: name: name spec: provider: type: ControlPlane controlPlane: endpoints: - ["12.12.123.123"] auth: type: AdminKey adminKey: value: a7adm-ZgR85iE... --- apiVersion: gateway.networking.k8s.io/v1 kind: Gateway metadata: name: apisix spec: gatewayClassName: apisix listeners: - name: http protocol: HTTP port: 80 infrastructure: parametersRef: group: apisix.apache.org kind: GatewayProxy name: name " | kubectl apply -f - -n default
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
{- "value": { },
- "error_msg": "error message"
}
IAM Action: gateway:CreateGatewayInstance
, Resource: arn:api7:gateway:gatewaygroup/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
validity_period | integer [ 1 .. 10950 ] Default: 3650 The validity period of the certificate in days. |
{- "validity_period": 3650
}
{- "value": {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "certificate": "-----BEGIN CERTIFICATE-----\\n...\\n-----END CERTIFICATE-----\\n",
- "private_key": "-----BEGIN PRIVATE KEY-----\\n...\\n-----END PRIVATE KEY-----\\n",
- "expiry": 1742288230
}
}
IAM Action: gateway:GetPublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
Deprecated, you can use GET /apisix/admin/services
for instead.
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
unhealthy_nodes | Array of strings Items Enum: "unhealthy_nodes_exists" "no_unhealthy_nodes" Filter of services based on whether unhealthy nodes exist. |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
order_by | string Default: "updated_at" Enum: "created_at" "updated_at" "publish_time" "name" Index to order published services by. |
search | string Example: search=version%3Dv2 Condition to search resources by. |
labels | string non-empty Example: labels=labels%5Bversion%5D=v2 Label(s) to filter resources by. The format is |
hosts | Array of strings[ items^\*?[0-9a-zA-Z-._]+$ ] Example: hosts=httpbin.org |
type | Array of strings Items Enum: "http" "stream" Type of service. |
{- "list": [
- {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "type": "http",
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "apisix_service_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "version": "1.3.2",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "gateway_group_name": "us-west-rsc",
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "unhealthy_nodes_count": 0,
- "status": 0
}
], - "total": 1
}
IAM Action: gateway:GetPublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
service_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service template. |
{- "value": {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "type": "http",
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "apisix_service_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "version": "1.3.2",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "gateway_group_name": "us-west-rsc",
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "unhealthy_nodes_count": 0,
- "status": 0
}
}
IAM Action: gateway:DeletePublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
service_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service template. |
""
IAM Action: gateway:GetPublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
service_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service template. |
{- "value": {
- "raw_openapi": "Raw OpenAPI spec",
- "api_count": 10,
- "api_desc": "OAS description."
}
}
IAM Action: gateway:UpdatePublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
service_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service template. |
raw_openapi | string The raw OpenAPI spec of the service. |
{- "raw_openapi": "Raw OpenAPI spec"
}
{- "value": {
- "raw_openapi": "Raw OpenAPI spec",
- "api_count": 10,
- "api_desc": "OAS description."
}
}
IAM Action: gateway:GetPublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
service_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service template. |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
order_by | string Default: "updated_at" Enum: "created_at" "updated_at" Index to order resources by. |
{- "list": [
- {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "methods": [
- "GET"
], - "vars": [
- [
- "arg_version",
- "==",
- "v2"
], - [
- "arg_ttl",
- "<",
- 3600
]
], - "paths": [
- "/get"
], - "priority": 0,
- "enable_websocket": true,
- "timeout": {
- "connect": 60,
- "send": 60,
- "read": 60
}, - "plugins": {
- "key-auth": { }
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "route_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_version_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101"
}
], - "total": 1
}
IAM Action: gateway:GetPublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
service_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service template. |
route_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the route in the service template. |
{- "value": {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "methods": [
- "GET"
], - "vars": [
- [
- "arg_version",
- "==",
- "v2"
], - [
- "arg_ttl",
- "<",
- 3600
]
], - "paths": [
- "/get"
], - "priority": 0,
- "enable_websocket": true,
- "timeout": {
- "connect": 60,
- "send": 60,
- "read": 60
}, - "plugins": {
- "key-auth": { }
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "route_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_version_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101"
}
}
IAM Action: gateway:GetPublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
service_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service template. |
route_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the route in the service template. |
{- "value": {
- "timeout": {
- "connect": 60,
- "send": 60,
- "read": 60
}, - "plugins": {
- "key-auth": { }
}
}
}
IAM Action: gateway:UpdatePublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
service_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service template. |
route_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the route in the service template. |
op required | string Enum: "add" "replace" The operation to be performed. |
path required | string Path to the field to be replaced or added. Path should follow the JSON Pointer format. |
value required | any Value to be added or replaced. |
[- {
- "op": "add",
- "path": "/name",
- "value": "new-name"
}
]
{- "value": {
- "timeout": {
- "connect": 60,
- "send": 60,
- "read": 60
}, - "plugins": {
- "key-auth": { }
}
}
}
IAM Action: gateway:GetPublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
service_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service template. |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
order_by | string Default: "updated_at" Enum: "created_at" "updated_at" Index to order resources by. |
{- "list": [
- {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "remote_addr": "127.0.0.1",
- "server_addr": "mysql",
- "server_port": 3306,
- "plugins": {
- "ip-restriction": {
- "whitelist": [
- "192.168.0.1/24"
], - "message": "Access denied"
}
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "stream_route_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_version_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101"
}
], - "total": 1
}
IAM Action: gateway:GetPublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
service_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service template. |
stream_route_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the stream route in the service template. |
{- "value": {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "remote_addr": "127.0.0.1",
- "server_addr": "mysql",
- "server_port": 3306,
- "plugins": {
- "ip-restriction": {
- "whitelist": [
- "192.168.0.1/24"
], - "message": "Access denied"
}
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "stream_route_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_version_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101"
}
}
IAM Action: gateway:GetPublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
service_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service template. |
stream_route_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the stream route in the service template. |
{- "value": {
- "plugins": {
- "key-auth": { }
}
}
}
IAM Action: gateway:UpdatePublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
service_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service template. |
stream_route_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the stream route in the service template. |
op required | string Enum: "add" "replace" The operation to be performed. |
path required | string Path to the field to be replaced or added. Path should follow the JSON Pointer format. |
value required | any Value to be added or replaced. |
[- {
- "op": "add",
- "path": "/name",
- "value": "new-name"
}
]
{- "value": {
- "plugins": {
- "key-auth": { }
}
}
}
IAM Action: gateway:GetPublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
service_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service template. |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
order_by | string Default: "publish_time" Value: "publish_time" Index to order resources by. |
{- "list": [
- {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "type": "http",
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "apisix_service_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "version": "1.3.2",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "publish_time": 1742288232
}
], - "total": 1
}
IAM Action: gateway:GetPublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
service_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service template. |
{- "value": {
- "hosts": [
- "httpbin.org"
], - "path_prefix": "/test",
- "strip_path_prefix": true,
- "upstream": {
- "name": "us-west-rsc",
- "scheme": "http",
- "desc": "Object description.",
- "type": "chash",
- "hash_on": "vars",
- "key": "$host",
- "retries": 50,
- "keepalive_pool": {
- "size": 320,
- "idle_timeout": 60,
- "requests": 1000
}, - "timeout": {
- "connect": 60,
- "send": 60,
- "read": 60
}, - "retry_timeout": 0,
- "pass_host": "pass",
- "upstream_host": "httpbin.org",
- "nodes": [
- {
- "host": "httpbin.org",
- "port": 8080,
- "weight": 100,
- "priority": 0
}
], - "service_name": "<ServiceRegistryID>/public/group/httpbin",
- "discovery_type": "nacos",
- "discovery_args": {
- "metadata": {
- "namespace_id": "public",
- "group_name": "DEFAULT_GROUP"
}
}, - "tls": {
- "client_cert": "$secret://aws/john/apisix-secrets/john-key-auth",
- "client_key": "$secret://aws/john/apisix-secrets/john-key-auth"
}, - "client_certificate": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "ca_certificates": [
- "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101"
], - "tls_verify": true,
- "checks": {
- "active": {
- "type": "http",
- "timeout": 1,
- "concurrency": 10,
- "host": "httpbin.org",
- "port": 1,
- "http_path": "/",
- "https_verify_certificate": true,
- "req_headers": [
- "user-agent: go/1.20"
], - "healthy": {
- "interval": 1,
- "http_statuses": [
- 200,
- 302
], - "successes": 2
}, - "unhealthy": {
- "interval": 1,
- "http_statuses": [
- 429,
- 404,
- 500,
- 501,
- 502,
- 503,
- 504,
- 505
], - "http_failures": 5,
- "tcp_failures": 2,
- "timeouts": 3
}
}
}
}, - "status": 0,
- "plugins": {
- "key-auth": { }
}
}
}
IAM Action: gateway:UpdatePublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
service_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service template. |
dry-run | string Value: "all" When specified, run the operation in dry-run mode. |
op required | string Enum: "add" "replace" The operation to be performed. |
path required | string Path to the field to be replaced or added. Path should follow the JSON Pointer format. |
value required | any Value to be added or replaced. |
[- {
- "op": "add",
- "path": "/name",
- "value": "new-name"
}
]
{- "value": {
- "hosts": [
- "httpbin.org"
], - "path_prefix": "/test",
- "strip_path_prefix": true,
- "upstream": {
- "name": "us-west-rsc",
- "scheme": "http",
- "desc": "Object description.",
- "type": "chash",
- "hash_on": "vars",
- "key": "$host",
- "retries": 50,
- "keepalive_pool": {
- "size": 320,
- "idle_timeout": 60,
- "requests": 1000
}, - "timeout": {
- "connect": 60,
- "send": 60,
- "read": 60
}, - "retry_timeout": 0,
- "pass_host": "pass",
- "upstream_host": "httpbin.org",
- "nodes": [
- {
- "host": "httpbin.org",
- "port": 8080,
- "weight": 100,
- "priority": 0
}
], - "service_name": "<ServiceRegistryID>/public/group/httpbin",
- "discovery_type": "nacos",
- "discovery_args": {
- "metadata": {
- "namespace_id": "public",
- "group_name": "DEFAULT_GROUP"
}
}, - "tls": {
- "client_cert": "$secret://aws/john/apisix-secrets/john-key-auth",
- "client_key": "$secret://aws/john/apisix-secrets/john-key-auth"
}, - "client_certificate": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "ca_certificates": [
- "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101"
], - "tls_verify": true,
- "checks": {
- "active": {
- "type": "http",
- "timeout": 1,
- "concurrency": 10,
- "host": "httpbin.org",
- "port": 1,
- "http_path": "/",
- "https_verify_certificate": true,
- "req_headers": [
- "user-agent: go/1.20"
], - "healthy": {
- "interval": 1,
- "http_statuses": [
- 200,
- 302
], - "successes": 2
}, - "unhealthy": {
- "interval": 1,
- "http_statuses": [
- 429,
- 404,
- 500,
- 501,
- 502,
- 503,
- 504,
- 505
], - "http_failures": 5,
- "tcp_failures": 2,
- "timeouts": 3
}
}
}
}, - "status": 0,
- "plugins": {
- "key-auth": { }
}
}
}
IAM Action: gateway:GetPublishedService
, Resource: arn:api7:gateway:gatewaygroup/%s/publishedservice/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
service_template_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the service template. |
{- "value": {
- "httpbin.com:80": {
- "host": "httpbin.com",
- "port": 80,
- "total": 1,
- "healthy": 1,
- "unhealthy": 0,
- "unknown": 0,
- "updated_at": 1750150319,
- "gateway_instances": [
- {
- "id": "xxx-yyy-zzz",
- "hostname": "api7ee3-apisix-699b68db7f-cxgcw",
- "status": "healthy",
- "created_at": 1750150300,
- "updated_at": 1750150335
}
]
}
}
}
IAM Action: gateway:GetServiceRegistry
, Resource: arn:api7:gateway:gatewaygroup/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
order_by | string Default: "updated_at" Enum: "created_at" "updated_at" "last_connect_time" Index to order service registry connections by. |
search | string Example: search=version%3Dv2 Condition to search resources by. |
{- "list": [
- {
- "name": "sample-service-registry",
- "description": "service registry description",
- "health_check": {
- "probe_interval": 15,
- "probe_timeout": 5
}, - "type": "kubernetes",
- "kubernetes_config": {
- "service": {
- "schema": "http",
- "host": "httpbin.org",
- "port": "6443"
}, - "namespace_selector": {
- "equal": "prod",
- "not_equal": "kube-system",
- "match": [
- "team-a"
], - "not_match": [
- "test-env"
]
}, - "label_selector": "app=nginx,env=prod",
- "client": {
- "token_file": "/var/run/secrets/kubernetes.io/serviceaccount/token"
}
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "status": "healthy",
- "last_connect_time": 1742288230,
- "associated_services_count": 0
}
], - "total": 1
}
IAM Action: gateway:ConnectServiceRegistry
, Resource: arn:api7:gateway:gatewaygroup/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
name | string [ 1 .. 100 ] characters The object name. |
description | string Service registry description. |
object Health check configurations. | |
type required | string Value: "kubernetes" The kubernetes service type. |
required | object Kubernetes service registry configurations. |
{- "name": "sample-service-registry",
- "description": "service registry description",
- "health_check": {
- "probe_interval": 15,
- "probe_timeout": 5
}, - "type": "kubernetes",
- "kubernetes_config": {
- "service": {
- "schema": "http",
- "host": "httpbin.org",
- "port": "6443"
}, - "namespace_selector": {
- "equal": "prod",
- "not_equal": "kube-system",
- "match": [
- "team-a"
], - "not_match": [
- "test-env"
]
}, - "label_selector": "app=nginx,env=prod",
- "client": {
- "token_file": "/var/run/secrets/kubernetes.io/serviceaccount/token"
}
}
}
{- "value": {
- "name": "sample-service-registry",
- "description": "service registry description",
- "health_check": {
- "probe_interval": 15,
- "probe_timeout": 5
}, - "type": "kubernetes",
- "kubernetes_config": {
- "service": {
- "schema": "http",
- "host": "httpbin.org",
- "port": "6443"
}, - "namespace_selector": {
- "equal": "prod",
- "not_equal": "kube-system",
- "match": [
- "team-a"
], - "not_match": [
- "test-env"
]
}, - "label_selector": "app=nginx,env=prod",
- "client": {
- "token_file": "/var/run/secrets/kubernetes.io/serviceaccount/token"
}
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "status": "healthy",
- "last_connect_time": 1742288230
}
}
IAM Action: gateway:CreateGatewayInstance
, Resource: arn:api7:gateway:gatewaygroup/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
only_token | boolean If true, the response will only contain the token. |
{- "value": {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "token_plain_text": "tubqbejxbhuao-2MIFcKD1dfaIm0i36Cqb2V2xfuIdwh9f60PJy0C1wYxBMeoTU2-8d2adba4c1444dd69a6d66e47b5ebff1"
}
}
IAM Action: gateway:GetServiceRegistry
, Resource: arn:api7:gateway:gatewaygroup/%s
service_registry_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Service registry ID. |
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
{- "value": {
- "name": "sample-service-registry",
- "description": "service registry description",
- "health_check": {
- "probe_interval": 15,
- "probe_timeout": 5
}, - "type": "kubernetes",
- "kubernetes_config": {
- "service": {
- "schema": "http",
- "host": "httpbin.org",
- "port": "6443"
}, - "namespace_selector": {
- "equal": "prod",
- "not_equal": "kube-system",
- "match": [
- "team-a"
], - "not_match": [
- "test-env"
]
}, - "label_selector": "app=nginx,env=prod",
- "client": {
- "token_file": "/var/run/secrets/kubernetes.io/serviceaccount/token"
}
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "status": "healthy",
- "last_connect_time": 1742288230
}
}
IAM Action: gateway:UpdateServiceRegistry
, Resource: arn:api7:gateway:gatewaygroup/%s
service_registry_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Service registry ID. |
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
name | string [ 1 .. 100 ] characters The object name. |
description | string Service registry description. |
object Health check configurations. | |
type required | string Value: "kubernetes" The kubernetes service type. |
required | object Kubernetes service registry configurations. |
{- "name": "sample-service-registry",
- "description": "service registry description",
- "health_check": {
- "probe_interval": 15,
- "probe_timeout": 5
}, - "type": "kubernetes",
- "kubernetes_config": {
- "service": {
- "schema": "http",
- "host": "httpbin.org",
- "port": "6443"
}, - "namespace_selector": {
- "equal": "prod",
- "not_equal": "kube-system",
- "match": [
- "team-a"
], - "not_match": [
- "test-env"
]
}, - "label_selector": "app=nginx,env=prod",
- "client": {
- "token_file": "/var/run/secrets/kubernetes.io/serviceaccount/token"
}
}
}
{- "value": { }
}
IAM Action: gateway:DisconnectServiceRegistry
, Resource: arn:api7:gateway:gatewaygroup/%s
service_registry_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Service registry ID. |
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
""
IAM Action: gateway:GetServiceRegistry
, Resource: arn:api7:gateway:gatewaygroup/%s
service_registry_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Service registry ID. |
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
order_by | string Default: "updated_at" Enum: "created_at" "updated_at" "publish_time" "name" Index to order published services by. |
{- "list": [
- {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "type": "http",
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "apisix_service_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "version": "1.3.2",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "gateway_group_name": "us-west-rsc",
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "unhealthy_nodes_count": 0,
- "status": 0
}
], - "total": 1
}
IAM Action: gateway:GetServiceRegistry
, Resource: arn:api7:gateway:gatewaygroup/%s
service_registry_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Service registry ID. |
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
{- "value": {
- "type": "kubernetes",
- "internal_services": {
- "default": [
- "service1",
- "service2"
], - "kube-system": [
- "kube-dns"
]
}
}
}
service_registry_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Service registry ID. |
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
{- "list": [
- {
- "namespace": "f8b9a1d3-74c7-4a70-9b89-1fc447c1b2e6",
- "namespace_show_name": "public"
}
], - "total": 1
}
IAM Action: gateway:GetServiceRegistry
, Resource: arn:api7:gateway:gatewaygroup/%s
service_registry_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Service registry ID. |
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
nacos_namespace required | string >= 1 Example: public Nacos namespace name. |
{- "list": [
- "DEFAULT_GROUP",
- "DEV_GROUP",
- "TEST_GROUP",
- "STAGING_GROUP",
- "PROD_GROUP"
], - "total": 5
}
IAM Action: gateway:GetServiceRegistry
, Resource: arn:api7:gateway:gatewaygroup/%s
service_registry_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Service registry ID. |
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
nacos_namespace required | string >= 1 Example: public Nacos namespace name. |
nacos_group required | string >= 1 Example: DEFAULT_GROUP Nacos group. |
{- "list": [
- "auth-service",
- "user-service",
- "order-service",
- "payment-service",
- "inventory-service"
], - "total": 5
}
IAM Action: gateway:GetServiceRegistry
, Resource: arn:api7:gateway:gatewaygroup/%s
service_registry_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Service registry ID. |
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
nacos_namespace required | string >= 1 Example: public Nacos namespace name. |
nacos_group required | string >= 1 Example: DEFAULT_GROUP Nacos group. |
nacos_service required | string >= 1 Example: api7ee3-keycloak Nacos service. |
{- "list": [
- {
- "version": "1.0.0",
- "env": "prod",
- "location": "beijing"
}, - {
- "version": "1.0.1",
- "env": "prod",
- "location": "shanghai"
}, - {
- "version": "1.0.0",
- "env": "staging",
- "location": "beijing"
}
], - "total": 3,
- "value": {
- "version": [
- "1.0.0",
- "1.0.1"
], - "env": [
- "prod",
- "staging"
], - "location": [
- "beijing",
- "shanghai"
]
}
}
IAM Action: gateway:GetServiceRegistry
, Resource: arn:api7:gateway:gatewaygroup/%s
service_registry_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Service registry ID. |
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
order_by | string Default: "connect_time" Value: "connect_time" Index to order health check history by. |
status | Array of strings Items Enum: "healthy" "lost_connection" "connecting" Service registry connection status. |
search | string Example: search=version%3Dv2 Condition to search resources by. |
{- "list": [
- {
- "instance_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_registry_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "hostname": "nacos-srv.test",
- "status": "healthy",
- "connect_time": 1742288230
}
], - "total": 1
}
IAM Action: iam:GetUser
, Resource: arn:api7:iam:user/%s
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
order_by | string Default: "updated_at" Enum: "created_at" "updated_at" Index to order resources by. |
roles | Array of strings >= 1 Any array of roles. |
{- "list": [
- {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "username": "admin",
- "name": "admin",
- "email": "test@email.com",
- "email_verified": true,
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "provider": "builtin",
- "roles": [
- {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "name": "super_admin",
- "desc": "Object description.",
- "type": "built_in",
- "policies": [
- "super-admin-permission-policy"
]
}
], - "boundaries": [
- {
- "name": "sample-policy",
- "type": "built_in",
- "desc": "Object description.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "policy_document": {
- "statement": [
- {
- "effect": "allow",
- "resources": [
- "arn:api7:gateway:servicetemplate/<.*>"
], - "actions": [
- "gateway:GetServiceTemplate"
], - "conditions": {
- "gateway_group_label": {
- "type": "MatchLabel",
- "options": {
- "key": "env",
- "operator": "exact_match",
- "value": "prod"
}
}
}
}
]
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
]
}
], - "total": 1
}
IAM Action: iam:GetUser
, Resource: arn:api7:iam:user/%s
user_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 The user ID. |
{- "value": {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "username": "admin",
- "name": "admin",
- "email": "test@email.com",
- "email_verified": true,
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "provider": "builtin",
- "roles": [
- {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "name": "super_admin",
- "desc": "Object description.",
- "type": "built_in",
- "policies": [
- "super-admin-permission-policy"
]
}
], - "boundaries": [
- {
- "name": "sample-policy",
- "type": "built_in",
- "desc": "Object description.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "policy_document": {
- "statement": [
- {
- "effect": "allow",
- "resources": [
- "arn:api7:gateway:servicetemplate/<.*>"
], - "actions": [
- "gateway:GetServiceTemplate"
], - "conditions": {
- "gateway_group_label": {
- "type": "MatchLabel",
- "options": {
- "key": "env",
- "operator": "exact_match",
- "value": "prod"
}
}
}
}
]
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
]
}
}
IAM Action: iam:UpdateUser
, Resource: arn:api7:iam:user/%s
user_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 The user ID. |
object Key-value pairs of labels. | |||
|
{- "labels": {
- "version": "v2",
- "env": "prod"
}
}
""
Update a user’s boundaries using a list of permission policy IDs.
IAM Action: iam:UpdateUserBoundary
, Resource: arn:api7:iam:user/%s
user_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 The user ID. |
[- "efd3bcc7-b61a-47ec-942b-b36bf249f1da"
]
""
IAM Action: iam:ResetPassword
, Resource: arn:api7:iam:user/%s
user_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 The user ID. |
password required | string [ 1 .. 128 ] characters The password of the user. |
{- "password": "safe-password"
}
""
{- "value": {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "username": "admin",
- "name": "admin",
- "email": "test@email.com",
- "email_verified": true,
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "provider": "builtin",
- "roles": [
- {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "name": "super_admin",
- "desc": "Object description.",
- "type": "built_in",
- "policies": [
- "super-admin-permission-policy"
]
}
], - "boundaries": [
- {
- "name": "sample-policy",
- "type": "built_in",
- "desc": "Object description.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "policy_document": {
- "statement": [
- {
- "effect": "allow",
- "resources": [
- "arn:api7:gateway:servicetemplate/<.*>"
], - "actions": [
- "gateway:GetServiceTemplate"
], - "conditions": {
- "gateway_group_label": {
- "type": "MatchLabel",
- "options": {
- "key": "env",
- "operator": "exact_match",
- "value": "prod"
}
}
}
}
]
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
]
}
}
IAM Action: iam:InviteUser
, Resource: arn:api7:iam:user/*
username required | string [ 1 .. 128 ] characters The username of the user. |
password required | string [ 1 .. 128 ] characters The password of the user. |
boundaries | Array of strings The permission boundaries of the user. |
name | string [ 1 .. 128 ] characters The name of the user. |
{- "username": "string",
- "password": "safe-password",
- "boundaries": [
- "string"
], - "name": "string"
}
{- "value": {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "username": "admin",
- "name": "admin",
- "email": "test@email.com",
- "email_verified": true,
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "provider": "builtin",
- "roles": [
- {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "name": "super_admin",
- "desc": "Object description.",
- "type": "built_in",
- "policies": [
- "super-admin-permission-policy"
]
}
], - "boundaries": [
- {
- "name": "sample-policy",
- "type": "built_in",
- "desc": "Object description.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "policy_document": {
- "statement": [
- {
- "effect": "allow",
- "resources": [
- "arn:api7:gateway:servicetemplate/<.*>"
], - "actions": [
- "gateway:GetServiceTemplate"
], - "conditions": {
- "gateway_group_label": {
- "type": "MatchLabel",
- "options": {
- "key": "env",
- "operator": "exact_match",
- "value": "prod"
}
}
}
}
]
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
], - "invitation_link": "string"
}
}
old_password | string [ 1 .. 128 ] characters |
new_password required | string [ 1 .. 128 ] characters |
{- "old_password": "old-password",
- "new_password": "new-password"
}
""
username required | string [ 1 .. 128 ] characters The username of the user. |
password required | string [ 1 .. 128 ] characters The password of the user. |
{- "username": "john",
- "password": "safe-password"
}
{- "value": { }
}
IAM Action: iam:UpdateUserRole
, Resource: arn:api7:iam:user/%s
user_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 The user ID. |
roles required | Array of strings[ items [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ ] An array of role IDs associated with a user. |
{- "roles": [
- "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101"
]
}
""
additional property | object (properties) | ||||||
|
{- "hasAccess": {
- "resource": "arn:api7:iam:role/767ff422-614b-4c0c-a4ea-287c26c773ba",
- "action": "iam:UpdateCustomRole",
- "context": {
- "role_label": {
- "platform": "external"
}
}
}
}
{- "value": {
- "hasAccess": true
}
}
login_option_id required | string Login option ID. |
username required | string [ 1 .. 128 ] characters The username of the user. |
password required | string [ 1 .. 128 ] characters The password of the user. |
{- "username": "john",
- "password": "safe-password"
}
{- "value": {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "name": "example-login",
- "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAACXBIWXMAAAsTAAALEwEAmpwYAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAH4SURBVHgBrVVLUhsxEH3SaBJSxJQWLLJKzAkClcqCVcINkhuYk6RygnCDkBOYI3iXTVKQE9ipggIGKKb42TAjNWrbY0+BkcY2b6ceqV/3688Ac6CrF+r/tfzmuyMxI25rL75klO+exDbFcxP0luItAjXbKteSsOe7qzAFWBJpbZOIVhNlkAkgyvHP96ZyBiyJMGaXnd8JQhJZgNBZSzGfRKS1LiRxR822dpwPPgq/PAyvRCzJnb1pukhXC9uZi5ylGfgPEzyZQbcWNwpJChtLcxyZ8WOaMYPua/XZRffzoT1xzq0Yn3vGX+B+EJOMr67yFkXZivO1XdjOnTRpROVr6XqKDmYh6JO4xy8vs00mMpJ2kpI0QwTl8RKUiZSlX+9yhcWSPqIiQaVBEyQ/Lbi2X7EK19LiULlOArWqvK00aC7wUSctWom3WcQZNH6/QT30VqACerX4HMMhY+yrfFxwgW3H9339aHLBgwQ8bG4e2sWZu+lAPSq4m0VsfDxF66E9KJE02Uge099Bj5ynzntjknNGuMgk3hd5JqU1McReluOrbx7CRRaynwGvCd5DIzOw5Vb1RmjYghkQdxCVNuhAks0PZ9hBBXgJSEPfGqoXPxdUkGQq8NK7WFL0Zxn0dxk/MAO8GQhX4E6cTSXJVAQnsdHXBmvzSHIP3R3bZScnj8UAAAAASUVORK5CYII=",
- "disable": false,
- "role_mapping": [
- {
- "role_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "role_attribute_key": "Position",
- "operation": "exact_match",
- "role_attribute_value": "Team Leader"
}
], - "boundary_mapping": [
- {
- "permission_policy_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "attribute_key": "Group",
- "operation": "exact_match",
- "attribute_value": "Finance"
}
], - "provider_type": "oidc",
- "oidc_config": {
- "client_id": "my-oidc-client-id",
- "client_secret": "s3cr3tK3yForOIDC",
- "request_scopes": [
- "openid",
- "email",
- "profile"
], - "ssl_verify": true,
- "attributes": {
- "first_name": "john",
- "last_name": "doe",
- "username": "johndoe"
}
}
}
}
login_option_id required | string Login option ID. |
SAMLResponse required | string Base64 encoded SAML response |
RelayState | string State information to be relayed with the response |
login_option_id required | string Login option ID. |
SAMLResponse required | string Base64 encoded SAML response |
RelayState | string State information to be relayed with the response |
IAM Action: iam:UpdateUserRole
, Resource: arn:api7:iam:user/%s
user_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 The user ID. |
roles required | Array of strings[ items [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ ] An array of role IDs associated with a user. |
{- "roles": [
- "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101"
]
}
""
IAM Action: iam:GetRole
, Resource: arn:api7:iam:role/%s
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
order_by | string Default: "updated_at" Enum: "created_at" "updated_at" Index to order resources by. |
search | string Example: search=version%3Dv2 Condition to search resources by. |
labels | string non-empty Example: labels=labels%5Bversion%5D=v2 Label(s) to filter resources by. The format is |
{- "list": [
- {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "name": "View Consumer",
- "desc": "This role allows users to view comsumers.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "type": "custom",
- "policies": [
- "super-admin-permission-policy"
], - "created_at": 1742288232,
- "updated_at": 1742288235
}
], - "total": 1
}
IAM Action: iam:CreateRole
, Resource: arn:api7:iam:role/*
name required | string [ 1 .. 256 ] characters The role name. |
desc | string <= 65536 characters The object description. |
object Key-value pairs of labels. | |
policies | Array of strings non-empty unique [ items [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ ] The polices attached to the role. |
{- "name": "View Consumer",
- "desc": "This role allows users to view comsumers.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "policies": [
- "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101"
]
}
{- "value": {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "name": "View Consumer",
- "desc": "This role allows users to view comsumers.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "type": "custom",
- "policies": [
- "super-admin-permission-policy"
], - "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: iam:GetRole
, Resource: arn:api7:iam:role/%s
role_id required | string >= 1 Example: 4b9b56d1-147e-49ef-bcaa-88cc5bcf403f Role ID. |
{- "value": {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "name": "View Consumer",
- "desc": "This role allows users to view comsumers.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "type": "custom",
- "policies": [
- "super-admin-permission-policy"
], - "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: iam:UpdateRole
, Resource: arn:api7:iam:role/%s
role_id required | string >= 1 Example: 4b9b56d1-147e-49ef-bcaa-88cc5bcf403f Role ID. |
name required | string [ 1 .. 256 ] characters The role name. |
desc | string <= 65536 characters The object description. |
object Key-value pairs of labels. | |
policies | Array of strings non-empty unique [ items [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ ] The polices attached to the role. |
{- "name": "View Consumer",
- "desc": "This role allows users to view comsumers.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "policies": [
- "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101"
]
}
{- "value": {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "name": "View Consumer",
- "desc": "This role allows users to view comsumers.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "type": "custom",
- "policies": [
- "super-admin-permission-policy"
], - "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: iam:GetPermissionPolicy
, Resource: arn:api7:iam:permissionpolicy/%s
role_id required | string >= 1 Example: 4b9b56d1-147e-49ef-bcaa-88cc5bcf403f Role ID. |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
order_by | string Default: "updated_at" Enum: "created_at" "updated_at" Index to order resources by. |
search | string Example: search=version%3Dv2 Condition to search resources by. |
labels | string non-empty Example: labels=labels%5Bversion%5D=v2 Label(s) to filter resources by. The format is |
{- "list": [
- {
- "name": "sample-policy",
- "type": "built_in",
- "desc": "Object description.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "policy_document": {
- "statement": [
- {
- "effect": "allow",
- "resources": [
- "arn:api7:gateway:servicetemplate/<.*>"
], - "actions": [
- "gateway:GetServiceTemplate"
], - "conditions": {
- "gateway_group_label": {
- "type": "MatchLabel",
- "options": {
- "key": "env",
- "operator": "exact_match",
- "value": "prod"
}
}
}
}
]
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
], - "total": 1
}
IAM Action: iam:UpdateRole
, Resource: arn:api7:iam:role/%s
role_id required | string >= 1 Example: 4b9b56d1-147e-49ef-bcaa-88cc5bcf403f Role ID. |
[- "efd3bcc7-b61a-47ec-942b-b36bf249f1da"
]
{- "value": { }
}
IAM Action: iam:UpdateRole
, Resource: arn:api7:iam:role/%s
role_id required | string >= 1 Example: 4b9b56d1-147e-49ef-bcaa-88cc5bcf403f Role ID. |
[- "efd3bcc7-b61a-47ec-942b-b36bf249f1da"
]
{- "value": { }
}
additional property | object (properties) | ||||||
|
{- "hasAccess": {
- "resource": "arn:api7:iam:role/767ff422-614b-4c0c-a4ea-287c26c773ba",
- "action": "iam:UpdateCustomRole",
- "context": {
- "role_label": {
- "platform": "external"
}
}
}
}
{- "value": {
- "hasAccess": true
}
}
IAM Action: iam:GetPermissionPolicy
, Resource: arn:api7:iam:permissionpolicy/%s
role_id required | string >= 1 Example: 4b9b56d1-147e-49ef-bcaa-88cc5bcf403f Role ID. |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
order_by | string Default: "updated_at" Enum: "created_at" "updated_at" Index to order resources by. |
search | string Example: search=version%3Dv2 Condition to search resources by. |
labels | string non-empty Example: labels=labels%5Bversion%5D=v2 Label(s) to filter resources by. The format is |
{- "list": [
- {
- "name": "sample-policy",
- "type": "built_in",
- "desc": "Object description.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "policy_document": {
- "statement": [
- {
- "effect": "allow",
- "resources": [
- "arn:api7:gateway:servicetemplate/<.*>"
], - "actions": [
- "gateway:GetServiceTemplate"
], - "conditions": {
- "gateway_group_label": {
- "type": "MatchLabel",
- "options": {
- "key": "env",
- "operator": "exact_match",
- "value": "prod"
}
}
}
}
]
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
], - "total": 1
}
IAM Action: iam:UpdateRole
, Resource: arn:api7:iam:role/%s
role_id required | string >= 1 Example: 4b9b56d1-147e-49ef-bcaa-88cc5bcf403f Role ID. |
[- "efd3bcc7-b61a-47ec-942b-b36bf249f1da"
]
{- "value": { }
}
IAM Action: iam:UpdateRole
, Resource: arn:api7:iam:role/%s
role_id required | string >= 1 Example: 4b9b56d1-147e-49ef-bcaa-88cc5bcf403f Role ID. |
[- "efd3bcc7-b61a-47ec-942b-b36bf249f1da"
]
{- "value": { }
}
IAM Action: iam:CreatePermissionPolicy
, Resource: arn:api7:iam:permissionpolicy/*
name required | string [ 1 .. 100 ] characters The policy name. |
type | string Enum: "built_in" "custom" The permission policy type. |
desc | string <= 65536 characters The description of the policy. |
object The labels of the policy. | |
required | object Policy document. |
{- "name": "sample-policy",
- "type": "built_in",
- "desc": "Object description.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "policy_document": {
- "statement": [
- {
- "effect": "allow",
- "resources": [
- "arn:api7:gateway:servicetemplate/<.*>"
], - "actions": [
- "gateway:GetServiceTemplate"
], - "conditions": {
- "gateway_group_label": {
- "type": "MatchLabel",
- "options": {
- "key": "env",
- "operator": "exact_match",
- "value": "prod"
}
}
}
}
]
}
}
{- "value": {
- "name": "sample-policy",
- "type": "built_in",
- "desc": "Object description.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "policy_document": {
- "statement": [
- {
- "effect": "allow",
- "resources": [
- "arn:api7:gateway:servicetemplate/<.*>"
], - "actions": [
- "gateway:GetServiceTemplate"
], - "conditions": {
- "gateway_group_label": {
- "type": "MatchLabel",
- "options": {
- "key": "env",
- "operator": "exact_match",
- "value": "prod"
}
}
}
}
]
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: iam:GetPermissionPolicy
, Resource: arn:api7:iam:permissionpolicy/%s
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
order_by | string Default: "updated_at" Enum: "created_at" "updated_at" Index to order resources by. |
search | string Example: search=version%3Dv2 Condition to search resources by. |
labels | string non-empty Example: labels=labels%5Bversion%5D=v2 Label(s) to filter resources by. The format is |
{- "list": [
- {
- "name": "sample-policy",
- "type": "built_in",
- "desc": "Object description.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "policy_document": {
- "statement": [
- {
- "effect": "allow",
- "resources": [
- "arn:api7:gateway:servicetemplate/<.*>"
], - "actions": [
- "gateway:GetServiceTemplate"
], - "conditions": {
- "gateway_group_label": {
- "type": "MatchLabel",
- "options": {
- "key": "env",
- "operator": "exact_match",
- "value": "prod"
}
}
}
}
]
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
], - "total": 1
}
IAM Action: iam:GetPermissionPolicy
, Resource: arn:api7:iam:permissionpolicy/%s
permission_policy_id required | string >= 1 Permission policy ID. |
{- "value": {
- "name": "sample-policy",
- "type": "built_in",
- "desc": "Object description.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "policy_document": {
- "statement": [
- {
- "effect": "allow",
- "resources": [
- "arn:api7:gateway:servicetemplate/<.*>"
], - "actions": [
- "gateway:GetServiceTemplate"
], - "conditions": {
- "gateway_group_label": {
- "type": "MatchLabel",
- "options": {
- "key": "env",
- "operator": "exact_match",
- "value": "prod"
}
}
}
}
]
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: iam:UpdatePermissionPolicy
, Resource: arn:api7:iam:permissionpolicy/%s
permission_policy_id required | string >= 1 Permission policy ID. |
name required | string [ 1 .. 100 ] characters The policy name. |
type | string Enum: "built_in" "custom" The permission policy type. |
desc | string <= 65536 characters The description of the policy. |
object The labels of the policy. | |
required | object Policy document. |
{- "name": "sample-policy",
- "type": "built_in",
- "desc": "Object description.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "policy_document": {
- "statement": [
- {
- "effect": "allow",
- "resources": [
- "arn:api7:gateway:servicetemplate/<.*>"
], - "actions": [
- "gateway:GetServiceTemplate"
], - "conditions": {
- "gateway_group_label": {
- "type": "MatchLabel",
- "options": {
- "key": "env",
- "operator": "exact_match",
- "value": "prod"
}
}
}
}
]
}
}
{- "value": {
- "name": "sample-policy",
- "type": "built_in",
- "desc": "Object description.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "policy_document": {
- "statement": [
- {
- "effect": "allow",
- "resources": [
- "arn:api7:gateway:servicetemplate/<.*>"
], - "actions": [
- "gateway:GetServiceTemplate"
], - "conditions": {
- "gateway_group_label": {
- "type": "MatchLabel",
- "options": {
- "key": "env",
- "operator": "exact_match",
- "value": "prod"
}
}
}
}
]
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: iam:GetPermissionPolicy
, Resource: arn:api7:iam:permissionpolicy/%s
permission_policy_id required | string >= 1 Permission policy ID. |
{- "list": [
- {
- "type": "role",
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "name": "consumer role"
}
], - "total": 1
}
IAM Action: gateway:GetAlertPolicy
, Resource: arn:api7:gateway:alert/%s
order_by | string Default: "updated_at" Enum: "created_at" "updated_at" "name" "severity" Index to order alert policies by. |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
search | string Example: search=version%3Dv2 Condition to search resources by. |
labels | string non-empty Example: labels=labels%5Bversion%5D=v2 Label(s) to filter resources by. The format is |
status | Array of strings Items Enum: "enabled" "disabled" Alert enablement status. |
severity | Array of strings Items Enum: "high" "medium" "low" Alert severity. |
{- "list": [
- {
- "name": "500 status alert",
- "desc": "Object description.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "enable": true,
- "check_interval": 1,
- "severity": "high",
- "trigger_logical_operator": "All",
- "id": "509fd356-df70-480b-8622-c38e27cfdd99",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
], - "total": 1
}
IAM Action: gateway:CreateAlertPolicy
, Resource: arn:api7:gateway:alert/*
name required | string [ 1 .. 100 ] characters The alert policy name. |
desc | string <= 65536 characters The alert policy description. |
object Key-value pairs of labels. | |
enable | boolean Default: true If true, enable the alert policy. |
check_interval | integer [ 1 .. 86400 ] The check interval for the alert policy. The unit is second. |
severity | string Default: "medium" Enum: "high" "medium" "low" The alert severity level. |
trigger_logical_operator required | string Default: "All" Enum: "All" "Any" The logical relationship between multiple triggers. |
required | Array of Status Code (object) or Certificate Expiry (object) or License Expiry (object) or Gateway Instance Offline (object) or Data Plane Cores Exceeded (object) or Numbers of Healthy Gateway Instances (object) non-empty The alert trigger conditions. |
Array of Email (object) or Webhook (object) The alert notifications. |
{- "name": "500 status alert",
- "desc": "Object description.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "enable": true,
- "check_interval": 1,
- "severity": "high",
- "trigger_logical_operator": "All",
- "trigger_conditions": [
- {
- "event": "number_of_status_code",
- "scope": {
- "gateway_group_ids": [
- "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101"
], - "gateway_group_labels": {
- "version": "v2",
- "env": "prod"
}
}, - "event_config": {
- "duration": 60,
- "unit": "second",
- "http_status_code": "500"
}, - "operator": "larger_than",
- "value": 5
}
], - "notifications": [
- {
- "type": "email",
- "contact_point_ids": [
- "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101"
], - "subject": "API7 Notification",
- "content": "The xxx gateway group has received more than 5 responses with 500 status code in the last 60 seconds."
}
]
}
{- "value": {
- "id": "509fd356-df70-480b-8622-c38e27cfdd99",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "name": "500 status alert",
- "desc": "Object description.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "enable": true,
- "check_interval": 1,
- "severity": "high",
- "trigger_logical_operator": "All",
- "trigger_conditions": [
- {
- "event": "number_of_status_code",
- "scope": {
- "gateway_group_ids": [
- "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101"
], - "gateway_group_labels": {
- "version": "v2",
- "env": "prod"
}
}, - "event_config": {
- "duration": 60,
- "unit": "second",
- "http_status_code": "500"
}, - "operator": "larger_than",
- "value": 5
}
], - "notifications": [
- {
- "type": "email",
- "contact_point_ids": [
- "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101"
], - "subject": "API7 Notification",
- "content": "The xxx gateway group has received more than 5 responses with 500 status code in the last 60 seconds."
}
]
}
}
IAM Action: gateway:GetAlertPolicy
, Resource: arn:api7:gateway:alert/%s
alert_policy_id required | string Alert policy ID. |
{- "value": {
- "id": "509fd356-df70-480b-8622-c38e27cfdd99",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "name": "500 status alert",
- "desc": "Object description.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "enable": true,
- "check_interval": 1,
- "severity": "high",
- "trigger_logical_operator": "All",
- "trigger_conditions": [
- {
- "event": "number_of_status_code",
- "scope": {
- "gateway_group_ids": [
- "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101"
], - "gateway_group_labels": {
- "version": "v2",
- "env": "prod"
}
}, - "event_config": {
- "duration": 60,
- "unit": "second",
- "http_status_code": "500"
}, - "operator": "larger_than",
- "value": 5
}
], - "notifications": [
- {
- "type": "email",
- "contact_point_ids": [
- "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101"
], - "subject": "API7 Notification",
- "content": "The xxx gateway group has received more than 5 responses with 500 status code in the last 60 seconds."
}
]
}
}
IAM Action: gateway:UpdateAlertPolicy
, Resource: arn:api7:gateway:alert/%s
alert_policy_id required | string Alert policy ID. |
name required | string [ 1 .. 100 ] characters The alert policy name. |
desc | string <= 65536 characters The alert policy description. |
object Key-value pairs of labels. | |
enable | boolean Default: true If true, enable the alert policy. |
check_interval | integer [ 1 .. 86400 ] The check interval for the alert policy. The unit is second. |
severity | string Default: "medium" Enum: "high" "medium" "low" The alert severity level. |
trigger_logical_operator required | string Default: "All" Enum: "All" "Any" The logical relationship between multiple triggers. |
required | Array of Status Code (object) or Certificate Expiry (object) or License Expiry (object) or Gateway Instance Offline (object) or Data Plane Cores Exceeded (object) or Numbers of Healthy Gateway Instances (object) non-empty The alert trigger conditions. |
Array of Email (object) or Webhook (object) The alert notifications. |
{- "name": "500 status alert",
- "desc": "Object description.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "enable": true,
- "check_interval": 1,
- "severity": "high",
- "trigger_logical_operator": "All",
- "trigger_conditions": [
- {
- "event": "number_of_status_code",
- "scope": {
- "gateway_group_ids": [
- "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101"
], - "gateway_group_labels": {
- "version": "v2",
- "env": "prod"
}
}, - "event_config": {
- "duration": 60,
- "unit": "second",
- "http_status_code": "500"
}, - "operator": "larger_than",
- "value": 5
}
], - "notifications": [
- {
- "type": "email",
- "contact_point_ids": [
- "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101"
], - "subject": "API7 Notification",
- "content": "The xxx gateway group has received more than 5 responses with 500 status code in the last 60 seconds."
}
]
}
{- "value": { }
}
IAM Action: gateway:UpdateAlertPolicy
, Resource: arn:api7:gateway:alert/%s
alert_policy_id required | string Alert policy ID. |
op required | string Enum: "add" "replace" The operation to be performed. |
path required | string Path to the field to be replaced or added. Path should follow the JSON Pointer format. |
value required | any Value to be added or replaced. |
[- {
- "op": "add",
- "path": "/name",
- "value": "new-name"
}
]
{- "value": { }
}
IAM Action: gateway:GetAlertPolicy
, Resource: arn:api7:gateway:alert/*
alert_policy_id | string Alert policy ID. |
severity | Array of strings Items Enum: "high" "medium" "low" Alert severity. |
start_at | integer Start at timestamp to filter the audit logs. |
end_at | integer End at timestamp to filter the audit logs. |
gateway_group_id | string >= 1 Gateway group ID. |
order_by | string Default: "alert_time" Value: "alert_time" Index to order alerts by. |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
search | string Example: search=version%3Dv2 Condition to search resources by. |
{- "list": [
- {
- "id": "ce6dbbb2-b8bc-4df8-b3e3-5af09c4a045f",
- "alert_policy_id": "72a2186a-f249-4da1-a2ec-a186150895b2",
- "alert_policy_name": "500 status code",
- "trigger_gateway_groups": [
- {
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "gateway_group_name": "us-west-rsc"
}
], - "severity": "high",
- "alert_time": 0,
- "alert_detail": "string",
- "notification_logs": [
- {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "contact_point_name": "cp-docs-test",
- "resource_type": "alert_policy",
- "resource_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "resource_name": "Weather Insights API",
- "status": "failed",
- "send_time": 1759649130,
- "request": "{\"from\": \"test.send@api7.ai\", \"to\": \"test.receive@api7.ai\", \"subject\": \"API7 Notification\", \"content\": \"This is a test notification.\"}",
- "response": "450 The domain must be verified in your account to send emails."
}
], - "created_at": 1742288232,
- "updated_at": 1742288235
}
], - "total": 1
}
IAM Action: iam:GetAudit
, Resource: arn:api7:iam:organization/*
event_type | string Example: event_type=AddConsumerCredential The event type. Event types can be looked up using the |
operator_id | string The user ID of the operator. |
gateway_group_id | string >= 1 Gateway group ID. |
resource_id | string The resource ID. |
start_at | integer Start at timestamp to filter the audit logs. |
end_at | integer End at timestamp to filter the audit logs. |
order_by | string Default: "event_time" Value: "event_time" Index to order audit logs by. |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
{- "list": [
- {
- "id": "7f7cc13c-9a86-42b9-a1bc-d337e18cb0fe",
- "event_time": 1742288230,
- "operator_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "operator": {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "username": "admin",
- "name": "admin",
- "email": "test@email.com",
- "email_verified": true
}, - "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "source": "dashboard",
- "token_name": "docs",
- "event_type": "string",
- "resource_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "ip_address": "10.15.101.5",
- "error_message": "Duplicate key in test2's credentials",
- "http_request": {
- "method": "POST",
- "uri": "/apisix/admin/consumers/test2/credentials?gateway_group_id=default",
- "body": {
- "name": "test",
- "plugins": {
- "key-auth": {
- "key": "********"
}
}
}, - "user_agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0.0.0 Safari/537.36"
}, - "http_response": {
- "status_code": 400,
- "body": { }
}
}
], - "total": 1
}
IAM Action: iam:ExportAudits
, Resource: arn:api7:iam:organization/*
event_type | string Example: event_type=AddConsumerCredential The event type. Event types can be looked up using the |
operator_id | string The user ID of the operator. |
gateway_group_id | string >= 1 Gateway group ID. |
resource_id | string The resource ID. |
start_at | integer Start at timestamp to filter the audit logs. |
end_at | integer End at timestamp to filter the audit logs. |
format required | string Enum: "json" "csv" Format to export. |
name required | string <= 40 characters The token name. |
expires_at required | integer <int64> The expiration timestamp of the token. |
{- "name": "test-token",
- "expires_at": 1752288235
}
{- "value": {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "name": "test-token",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "expires_at": 1752288235,
- "user_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "org_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "token": "a7ee-gyb4v2Ryc2xfh9w707Z7r6IW3E0c1D7hu7x9ZT8Fxxxxx3G4Q9-5b101b5c7fc34e988f1ff9979cc191e1"
}
}
order_by | string Default: "created_at" Enum: "created_at" "updated_at" "expires_at" Index to order the tokens by. |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
search | string Example: search=version%3Dv2 Condition to search resources by. |
{- "list": [
- {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "name": "test-token",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "expires_at": 1752288235,
- "user_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "org_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "user_name": "test-user",
- "last_used_at": 1742288235
}
], - "total": 1
}
token_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the token. |
{- "value": {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "name": "test-token",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "expires_at": 1752288235,
- "user_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "org_id": "bc1b95c9-b348-4832-acc3-e257d2342df1"
}
}
token_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the token. |
name required | string <= 40 characters The token name. |
{- "name": "test-token"
}
{- "value": {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "name": "test-token",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "expires_at": 1752288235,
- "user_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "org_id": "bc1b95c9-b348-4832-acc3-e257d2342df1"
}
}
token_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 The unique identifier of the token. |
expires_at required | integer <int64> The expiration timestamp of the token. |
{- "expires_at": 1752288235
}
{- "value": {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "name": "test-token",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "expires_at": 1752288235,
- "user_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "org_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "token": "a7ee-gyb4v2Ryc2xfh9w707Z7r6IW3E0c1D7hu7x9ZT8Fxxxxx3G4Q9-5b101b5c7fc34e988f1ff9979cc191e1"
}
}
IAM Action: gateway:GetServiceRegistry
, Resource: arn:api7:gateway:gatewaygroup/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
order_by | string Default: "updated_at" Enum: "created_at" "updated_at" "last_connect_time" Index to order service registry connections by. |
search | string Example: search=version%3Dv2 Condition to search resources by. |
{- "list": [
- {
- "name": "sample-service-registry",
- "description": "service registry description",
- "health_check": {
- "probe_interval": 15,
- "probe_timeout": 5
}, - "type": "kubernetes",
- "kubernetes_config": {
- "service": {
- "schema": "http",
- "host": "httpbin.org",
- "port": "6443"
}, - "namespace_selector": {
- "equal": "prod",
- "not_equal": "kube-system",
- "match": [
- "team-a"
], - "not_match": [
- "test-env"
]
}, - "label_selector": "app=nginx,env=prod",
- "client": {
- "token_file": "/var/run/secrets/kubernetes.io/serviceaccount/token"
}
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "status": "healthy",
- "last_connect_time": 1742288230,
- "associated_services_count": 0
}
], - "total": 1
}
IAM Action: gateway:ConnectServiceRegistry
, Resource: arn:api7:gateway:gatewaygroup/%s
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
name | string [ 1 .. 100 ] characters The object name. |
description | string Service registry description. |
object Health check configurations. | |
type required | string Value: "kubernetes" The kubernetes service type. |
required | object Kubernetes service registry configurations. |
{- "name": "sample-service-registry",
- "description": "service registry description",
- "health_check": {
- "probe_interval": 15,
- "probe_timeout": 5
}, - "type": "kubernetes",
- "kubernetes_config": {
- "service": {
- "schema": "http",
- "host": "httpbin.org",
- "port": "6443"
}, - "namespace_selector": {
- "equal": "prod",
- "not_equal": "kube-system",
- "match": [
- "team-a"
], - "not_match": [
- "test-env"
]
}, - "label_selector": "app=nginx,env=prod",
- "client": {
- "token_file": "/var/run/secrets/kubernetes.io/serviceaccount/token"
}
}
}
{- "value": {
- "name": "sample-service-registry",
- "description": "service registry description",
- "health_check": {
- "probe_interval": 15,
- "probe_timeout": 5
}, - "type": "kubernetes",
- "kubernetes_config": {
- "service": {
- "schema": "http",
- "host": "httpbin.org",
- "port": "6443"
}, - "namespace_selector": {
- "equal": "prod",
- "not_equal": "kube-system",
- "match": [
- "team-a"
], - "not_match": [
- "test-env"
]
}, - "label_selector": "app=nginx,env=prod",
- "client": {
- "token_file": "/var/run/secrets/kubernetes.io/serviceaccount/token"
}
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "status": "healthy",
- "last_connect_time": 1742288230
}
}
IAM Action: gateway:GetServiceRegistry
, Resource: arn:api7:gateway:gatewaygroup/%s
service_registry_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Service registry ID. |
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
{- "value": {
- "name": "sample-service-registry",
- "description": "service registry description",
- "health_check": {
- "probe_interval": 15,
- "probe_timeout": 5
}, - "type": "kubernetes",
- "kubernetes_config": {
- "service": {
- "schema": "http",
- "host": "httpbin.org",
- "port": "6443"
}, - "namespace_selector": {
- "equal": "prod",
- "not_equal": "kube-system",
- "match": [
- "team-a"
], - "not_match": [
- "test-env"
]
}, - "label_selector": "app=nginx,env=prod",
- "client": {
- "token_file": "/var/run/secrets/kubernetes.io/serviceaccount/token"
}
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "status": "healthy",
- "last_connect_time": 1742288230
}
}
IAM Action: gateway:UpdateServiceRegistry
, Resource: arn:api7:gateway:gatewaygroup/%s
service_registry_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Service registry ID. |
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
name | string [ 1 .. 100 ] characters The object name. |
description | string Service registry description. |
object Health check configurations. | |
type required | string Value: "kubernetes" The kubernetes service type. |
required | object Kubernetes service registry configurations. |
{- "name": "sample-service-registry",
- "description": "service registry description",
- "health_check": {
- "probe_interval": 15,
- "probe_timeout": 5
}, - "type": "kubernetes",
- "kubernetes_config": {
- "service": {
- "schema": "http",
- "host": "httpbin.org",
- "port": "6443"
}, - "namespace_selector": {
- "equal": "prod",
- "not_equal": "kube-system",
- "match": [
- "team-a"
], - "not_match": [
- "test-env"
]
}, - "label_selector": "app=nginx,env=prod",
- "client": {
- "token_file": "/var/run/secrets/kubernetes.io/serviceaccount/token"
}
}
}
{- "value": { }
}
IAM Action: gateway:DisconnectServiceRegistry
, Resource: arn:api7:gateway:gatewaygroup/%s
service_registry_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Service registry ID. |
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
""
IAM Action: gateway:GetServiceRegistry
, Resource: arn:api7:gateway:gatewaygroup/%s
service_registry_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Service registry ID. |
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
order_by | string Default: "updated_at" Enum: "created_at" "updated_at" "publish_time" "name" Index to order published services by. |
{- "list": [
- {
- "name": "us-west-rsc",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "desc": "Object description.",
- "type": "http",
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "apisix_service_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "version": "1.3.2",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "gateway_group_name": "us-west-rsc",
- "gateway_group_id": "bc1b95c9-b348-4832-acc3-e257d2342df1",
- "unhealthy_nodes_count": 0,
- "status": 0
}
], - "total": 1
}
IAM Action: gateway:GetServiceRegistry
, Resource: arn:api7:gateway:gatewaygroup/%s
service_registry_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Service registry ID. |
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
{- "value": {
- "type": "kubernetes",
- "internal_services": {
- "default": [
- "service1",
- "service2"
], - "kube-system": [
- "kube-dns"
]
}
}
}
service_registry_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Service registry ID. |
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
{- "list": [
- {
- "namespace": "f8b9a1d3-74c7-4a70-9b89-1fc447c1b2e6",
- "namespace_show_name": "public"
}
], - "total": 1
}
IAM Action: gateway:GetServiceRegistry
, Resource: arn:api7:gateway:gatewaygroup/%s
service_registry_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Service registry ID. |
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
nacos_namespace required | string >= 1 Example: public Nacos namespace name. |
{- "list": [
- "DEFAULT_GROUP",
- "DEV_GROUP",
- "TEST_GROUP",
- "STAGING_GROUP",
- "PROD_GROUP"
], - "total": 5
}
IAM Action: gateway:GetServiceRegistry
, Resource: arn:api7:gateway:gatewaygroup/%s
service_registry_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Service registry ID. |
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
nacos_namespace required | string >= 1 Example: public Nacos namespace name. |
nacos_group required | string >= 1 Example: DEFAULT_GROUP Nacos group. |
{- "list": [
- "auth-service",
- "user-service",
- "order-service",
- "payment-service",
- "inventory-service"
], - "total": 5
}
IAM Action: gateway:GetServiceRegistry
, Resource: arn:api7:gateway:gatewaygroup/%s
service_registry_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Service registry ID. |
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
nacos_namespace required | string >= 1 Example: public Nacos namespace name. |
nacos_group required | string >= 1 Example: DEFAULT_GROUP Nacos group. |
nacos_service required | string >= 1 Example: api7ee3-keycloak Nacos service. |
{- "list": [
- {
- "version": "1.0.0",
- "env": "prod",
- "location": "beijing"
}, - {
- "version": "1.0.1",
- "env": "prod",
- "location": "shanghai"
}, - {
- "version": "1.0.0",
- "env": "staging",
- "location": "beijing"
}
], - "total": 3,
- "value": {
- "version": [
- "1.0.0",
- "1.0.1"
], - "env": [
- "prod",
- "staging"
], - "location": [
- "beijing",
- "shanghai"
]
}
}
IAM Action: gateway:GetServiceRegistry
, Resource: arn:api7:gateway:gatewaygroup/%s
service_registry_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Service registry ID. |
gateway_group_id required | string >= 1 Example: 86fb9981-d9d2-4555-9df8-91ae92129335 Gateway group ID. |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
order_by | string Default: "connect_time" Value: "connect_time" Index to order health check history by. |
status | Array of strings Items Enum: "healthy" "lost_connection" "connecting" Service registry connection status. |
search | string Example: search=version%3Dv2 Condition to search resources by. |
{- "list": [
- {
- "instance_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "service_registry_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "hostname": "nacos-srv.test",
- "status": "healthy",
- "connect_time": 1742288230
}
], - "total": 1
}
resource_type required | string Enum: "gateway_group" "consumer" "consumer_credential" "ssl" "service" "route" "stream_route" "role" "permission_policy" "published_service" "secret" "contact_point" "alert_policy" "certificate" "api_product" "sni" Resource type. |
gateway_group_id | string >= 1 Gateway group ID. |
{- "value": {
- "k8s/namespace": [
- "api7-ingress-system",
- "default",
- "api7"
], - "manager-by": [
- "api7-ingress-controller",
- "apisix-ingress-controller"
]
}
}
IAM Action: gateway:UpdateDeploymentSetting
, Resource: arn:api7:gateway:gatewaysetting/*
dp_manager_address | Array of strings <url_scheme_port> [ 0 .. 32 ] items unique [ items <url_scheme_port > non-empty [^\/]$ ] DP manager address. |
source | string Enum: "database" "config" The source of the control plane address and Admin API address. |
admin_api_address | string <url_scheme> The URL address of the Admin API. |
{- "source": "database",
}
{- "value": {
- "source": "database",
}
}
{- "value": {
- "source": "database",
}
}
IAM Action: iam:UpdateSCIMProvisioning
, Resource: arn:api7:iam:organization/*
enable_scim | boolean Enable or disable the SCIM endpoint for provisioning and user management. |
{- "enable_scim": true
}
{- "value": {
- "enable_scim": true,
- "scim_encrypt_key": "F6OqjCmoRBqFBQIEsdpl33vgfLYTWJe6ynkwitqmaVE=",
- "scim_key_salt": "rIXtKGq4oXkzbwEzhzQ3FOa1nOPa2GuPDjdGGJ5TstpCv5irk8KSguBF4YukQqix"
}
}
IAM Action: iam:GetSCIMProvisioning
, Resource: arn:api7:iam:organization/*
{- "value": {
- "enable_scim": true,
- "scim_encrypt_key": "F6OqjCmoRBqFBQIEsdpl33vgfLYTWJe6ynkwitqmaVE=",
- "scim_key_salt": "rIXtKGq4oXkzbwEzhzQ3FOa1nOPa2GuPDjdGGJ5TstpCv5irk8KSguBF4YukQqix"
}
}
IAM Action: iam:UpdateSMTPServer
, Resource: arn:api7:iam:organization/*
enable required | boolean Enable SMTP Server. |
address required | string <host_port> The SMTP server address in host:port format. |
authentication_type | string Enum: "TLS" "STARTTLS" The authentication type of the SMTP server. |
ssl_verify required | boolean Whether to validate server-side SSL. |
username required | string Username used to authenticate with the SMTP server. |
password required | string Password used to authenticate with the SMTP server. |
from_name required | string^\s*("(?:[^"\\]|\\.)*"|([^<>@]+))?\s*$ Sender's name. |
from_address required | string <email> Sender's email address. |
{- "enable": true,
- "address": "smtp.example.com:587",
- "authentication_type": "TLS",
- "ssl_verify": true,
- "username": "smtp-user@example.com",
- "password": "secretpassword123",
- "from_name": "John Doe",
- "from_address": "sender@example.com"
}
{- "value": {
- "enable": true,
- "address": "smtp.example.com:587",
- "authentication_type": "TLS",
- "ssl_verify": true,
- "username": "smtp-user@example.com",
- "password": "secretpassword123",
- "from_name": "John Doe",
- "from_address": "sender@example.com"
}
}
IAM Action: iam:GetSMTPServer
, Resource: arn:api7:iam:organization/*
{- "value": {
- "enable": true,
- "address": "smtp.example.com:587",
- "authentication_type": "TLS",
- "ssl_verify": true,
- "username": "smtp-user@example.com",
- "password": "secretpassword123",
- "from_name": "John Doe",
- "from_address": "sender@example.com"
}
}
IAM Action: portal:UpdateDeveloperPortalPublicAccess
, Resource: arn:api7:portal:loginsetting/*
portal_public_access | boolean If true, allow public access to the developer portal. |
{- "portal_public_access": true
}
{- "value": {
- "portal_public_access": true
}
}
IAM Action: portal:GetDeveloperLoginOption
, Resource: arn:api7:portal:loginsetting/*
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
order_by | string Default: "updated_at" Enum: "created_at" "updated_at" Index to order resources by. |
search | string Example: search=version%3Dv2 Condition to search resources by. |
name | string Name of the resource. |
{- "value": {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "name": "example-login",
- "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAACXBIWXMAAAsTAAALEwEAmpwYAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAH4SURBVHgBrVVLUhsxEH3SaBJSxJQWLLJKzAkClcqCVcINkhuYk6RygnCDkBOYI3iXTVKQE9ipggIGKKb42TAjNWrbY0+BkcY2b6ceqV/3688Ac6CrF+r/tfzmuyMxI25rL75klO+exDbFcxP0luItAjXbKteSsOe7qzAFWBJpbZOIVhNlkAkgyvHP96ZyBiyJMGaXnd8JQhJZgNBZSzGfRKS1LiRxR822dpwPPgq/PAyvRCzJnb1pukhXC9uZi5ylGfgPEzyZQbcWNwpJChtLcxyZ8WOaMYPua/XZRffzoT1xzq0Yn3vGX+B+EJOMr67yFkXZivO1XdjOnTRpROVr6XqKDmYh6JO4xy8vs00mMpJ2kpI0QwTl8RKUiZSlX+9yhcWSPqIiQaVBEyQ/Lbi2X7EK19LiULlOArWqvK00aC7wUSctWom3WcQZNH6/QT30VqACerX4HMMhY+yrfFxwgW3H9339aHLBgwQ8bG4e2sWZu+lAPSq4m0VsfDxF66E9KJE02Uge099Bj5ynzntjknNGuMgk3hd5JqU1McReluOrbx7CRRaynwGvCd5DIzOw5Vb1RmjYghkQdxCVNuhAks0PZ9hBBXgJSEPfGqoXPxdUkGQq8NK7WFL0Zxn0dxk/MAO8GQhX4E6cTSXJVAQnsdHXBmvzSHIP3R3bZScnj8UAAAAASUVORK5CYII=",
- "disable": false,
- "provider_type": "oidc",
- "oidc_config": {
- "client_id": "my-oidc-client-id",
- "client_secret": "s3cr3tK3yForOIDC",
- "request_scopes": [
- "openid",
- "email",
- "profile"
], - "ssl_verify": true,
- "attributes": {
- "first_name": "john",
- "last_name": "doe",
- "username": "johndoe"
}
}
}
}
IAM Action: portal:CreateDeveloperLoginOption
, Resource: arn:api7:portal:loginsetting/*
name | string [ 1 .. 256 ] characters Name of the login option. |
logo | string The base64-encoded logo image. |
disable | boolean Default: false If true, disable the login option. |
provider_type | string Value: "oidc" The login option type. |
object OIDC configuration. |
{- "name": "example-login",
- "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAACXBIWXMAAAsTAAALEwEAmpwYAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAH4SURBVHgBrVVLUhsxEH3SaBJSxJQWLLJKzAkClcqCVcINkhuYk6RygnCDkBOYI3iXTVKQE9ipggIGKKb42TAjNWrbY0+BkcY2b6ceqV/3688Ac6CrF+r/tfzmuyMxI25rL75klO+exDbFcxP0luItAjXbKteSsOe7qzAFWBJpbZOIVhNlkAkgyvHP96ZyBiyJMGaXnd8JQhJZgNBZSzGfRKS1LiRxR822dpwPPgq/PAyvRCzJnb1pukhXC9uZi5ylGfgPEzyZQbcWNwpJChtLcxyZ8WOaMYPua/XZRffzoT1xzq0Yn3vGX+B+EJOMr67yFkXZivO1XdjOnTRpROVr6XqKDmYh6JO4xy8vs00mMpJ2kpI0QwTl8RKUiZSlX+9yhcWSPqIiQaVBEyQ/Lbi2X7EK19LiULlOArWqvK00aC7wUSctWom3WcQZNH6/QT30VqACerX4HMMhY+yrfFxwgW3H9339aHLBgwQ8bG4e2sWZu+lAPSq4m0VsfDxF66E9KJE02Uge099Bj5ynzntjknNGuMgk3hd5JqU1McReluOrbx7CRRaynwGvCd5DIzOw5Vb1RmjYghkQdxCVNuhAks0PZ9hBBXgJSEPfGqoXPxdUkGQq8NK7WFL0Zxn0dxk/MAO8GQhX4E6cTSXJVAQnsdHXBmvzSHIP3R3bZScnj8UAAAAASUVORK5CYII=",
- "disable": false,
- "provider_type": "oidc",
- "oidc_config": {
- "client_id": "my-oidc-client-id",
- "client_secret": "s3cr3tK3yForOIDC",
- "request_scopes": [
- "openid",
- "email",
- "profile"
], - "ssl_verify": true,
- "attributes": {
- "first_name": "john",
- "last_name": "doe",
- "username": "johndoe"
}
}
}
{- "list": [
- {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "name": "example-login",
- "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAACXBIWXMAAAsTAAALEwEAmpwYAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAH4SURBVHgBrVVLUhsxEH3SaBJSxJQWLLJKzAkClcqCVcINkhuYk6RygnCDkBOYI3iXTVKQE9ipggIGKKb42TAjNWrbY0+BkcY2b6ceqV/3688Ac6CrF+r/tfzmuyMxI25rL75klO+exDbFcxP0luItAjXbKteSsOe7qzAFWBJpbZOIVhNlkAkgyvHP96ZyBiyJMGaXnd8JQhJZgNBZSzGfRKS1LiRxR822dpwPPgq/PAyvRCzJnb1pukhXC9uZi5ylGfgPEzyZQbcWNwpJChtLcxyZ8WOaMYPua/XZRffzoT1xzq0Yn3vGX+B+EJOMr67yFkXZivO1XdjOnTRpROVr6XqKDmYh6JO4xy8vs00mMpJ2kpI0QwTl8RKUiZSlX+9yhcWSPqIiQaVBEyQ/Lbi2X7EK19LiULlOArWqvK00aC7wUSctWom3WcQZNH6/QT30VqACerX4HMMhY+yrfFxwgW3H9339aHLBgwQ8bG4e2sWZu+lAPSq4m0VsfDxF66E9KJE02Uge099Bj5ynzntjknNGuMgk3hd5JqU1McReluOrbx7CRRaynwGvCd5DIzOw5Vb1RmjYghkQdxCVNuhAks0PZ9hBBXgJSEPfGqoXPxdUkGQq8NK7WFL0Zxn0dxk/MAO8GQhX4E6cTSXJVAQnsdHXBmvzSHIP3R3bZScnj8UAAAAASUVORK5CYII=",
- "disable": false,
- "role_mapping": [
- {
- "role_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "role_attribute_key": "Position",
- "operation": "exact_match",
- "role_attribute_value": "Team Leader"
}
], - "boundary_mapping": [
- {
- "permission_policy_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "attribute_key": "Group",
- "operation": "exact_match",
- "attribute_value": "Finance"
}
], - "provider_type": "oidc",
- "oidc_config": {
- "client_id": "my-oidc-client-id",
- "client_secret": "s3cr3tK3yForOIDC",
- "request_scopes": [
- "openid",
- "email",
- "profile"
], - "ssl_verify": true,
- "attributes": {
- "first_name": "john",
- "last_name": "doe",
- "username": "johndoe"
}
}
}
], - "total": 1
}
IAM Action: portal:GetDeveloperLoginOption
, Resource: arn:api7:portal:loginsetting/*
login_option_id required | string Login option ID. |
{- "value": {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "name": "example-login",
- "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAACXBIWXMAAAsTAAALEwEAmpwYAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAH4SURBVHgBrVVLUhsxEH3SaBJSxJQWLLJKzAkClcqCVcINkhuYk6RygnCDkBOYI3iXTVKQE9ipggIGKKb42TAjNWrbY0+BkcY2b6ceqV/3688Ac6CrF+r/tfzmuyMxI25rL75klO+exDbFcxP0luItAjXbKteSsOe7qzAFWBJpbZOIVhNlkAkgyvHP96ZyBiyJMGaXnd8JQhJZgNBZSzGfRKS1LiRxR822dpwPPgq/PAyvRCzJnb1pukhXC9uZi5ylGfgPEzyZQbcWNwpJChtLcxyZ8WOaMYPua/XZRffzoT1xzq0Yn3vGX+B+EJOMr67yFkXZivO1XdjOnTRpROVr6XqKDmYh6JO4xy8vs00mMpJ2kpI0QwTl8RKUiZSlX+9yhcWSPqIiQaVBEyQ/Lbi2X7EK19LiULlOArWqvK00aC7wUSctWom3WcQZNH6/QT30VqACerX4HMMhY+yrfFxwgW3H9339aHLBgwQ8bG4e2sWZu+lAPSq4m0VsfDxF66E9KJE02Uge099Bj5ynzntjknNGuMgk3hd5JqU1McReluOrbx7CRRaynwGvCd5DIzOw5Vb1RmjYghkQdxCVNuhAks0PZ9hBBXgJSEPfGqoXPxdUkGQq8NK7WFL0Zxn0dxk/MAO8GQhX4E6cTSXJVAQnsdHXBmvzSHIP3R3bZScnj8UAAAAASUVORK5CYII=",
- "disable": false,
- "provider_type": "oidc",
- "oidc_config": {
- "client_id": "my-oidc-client-id",
- "client_secret": "s3cr3tK3yForOIDC",
- "request_scopes": [
- "openid",
- "email",
- "profile"
], - "ssl_verify": true,
- "attributes": {
- "first_name": "john",
- "last_name": "doe",
- "username": "johndoe"
}
}
}
}
IAM Action: portal:UpdateDeveloperLoginOption
, Resource: arn:api7:portal:loginsetting/*
login_option_id required | string Login option ID. |
name | string [ 1 .. 256 ] characters Name of the login option. |
logo | string The base64-encoded logo image. |
disable | boolean Default: false If true, disable the login option. |
provider_type | string Value: "oidc" The login option type. |
object OIDC configuration. |
{- "name": "example-login",
- "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAACXBIWXMAAAsTAAALEwEAmpwYAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAH4SURBVHgBrVVLUhsxEH3SaBJSxJQWLLJKzAkClcqCVcINkhuYk6RygnCDkBOYI3iXTVKQE9ipggIGKKb42TAjNWrbY0+BkcY2b6ceqV/3688Ac6CrF+r/tfzmuyMxI25rL75klO+exDbFcxP0luItAjXbKteSsOe7qzAFWBJpbZOIVhNlkAkgyvHP96ZyBiyJMGaXnd8JQhJZgNBZSzGfRKS1LiRxR822dpwPPgq/PAyvRCzJnb1pukhXC9uZi5ylGfgPEzyZQbcWNwpJChtLcxyZ8WOaMYPua/XZRffzoT1xzq0Yn3vGX+B+EJOMr67yFkXZivO1XdjOnTRpROVr6XqKDmYh6JO4xy8vs00mMpJ2kpI0QwTl8RKUiZSlX+9yhcWSPqIiQaVBEyQ/Lbi2X7EK19LiULlOArWqvK00aC7wUSctWom3WcQZNH6/QT30VqACerX4HMMhY+yrfFxwgW3H9339aHLBgwQ8bG4e2sWZu+lAPSq4m0VsfDxF66E9KJE02Uge099Bj5ynzntjknNGuMgk3hd5JqU1McReluOrbx7CRRaynwGvCd5DIzOw5Vb1RmjYghkQdxCVNuhAks0PZ9hBBXgJSEPfGqoXPxdUkGQq8NK7WFL0Zxn0dxk/MAO8GQhX4E6cTSXJVAQnsdHXBmvzSHIP3R3bZScnj8UAAAAASUVORK5CYII=",
- "disable": false,
- "provider_type": "oidc",
- "oidc_config": {
- "client_id": "my-oidc-client-id",
- "client_secret": "s3cr3tK3yForOIDC",
- "request_scopes": [
- "openid",
- "email",
- "profile"
], - "ssl_verify": true,
- "attributes": {
- "first_name": "john",
- "last_name": "doe",
- "username": "johndoe"
}
}
}
{- "value": {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "name": "example-login",
- "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAACXBIWXMAAAsTAAALEwEAmpwYAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAH4SURBVHgBrVVLUhsxEH3SaBJSxJQWLLJKzAkClcqCVcINkhuYk6RygnCDkBOYI3iXTVKQE9ipggIGKKb42TAjNWrbY0+BkcY2b6ceqV/3688Ac6CrF+r/tfzmuyMxI25rL75klO+exDbFcxP0luItAjXbKteSsOe7qzAFWBJpbZOIVhNlkAkgyvHP96ZyBiyJMGaXnd8JQhJZgNBZSzGfRKS1LiRxR822dpwPPgq/PAyvRCzJnb1pukhXC9uZi5ylGfgPEzyZQbcWNwpJChtLcxyZ8WOaMYPua/XZRffzoT1xzq0Yn3vGX+B+EJOMr67yFkXZivO1XdjOnTRpROVr6XqKDmYh6JO4xy8vs00mMpJ2kpI0QwTl8RKUiZSlX+9yhcWSPqIiQaVBEyQ/Lbi2X7EK19LiULlOArWqvK00aC7wUSctWom3WcQZNH6/QT30VqACerX4HMMhY+yrfFxwgW3H9339aHLBgwQ8bG4e2sWZu+lAPSq4m0VsfDxF66E9KJE02Uge099Bj5ynzntjknNGuMgk3hd5JqU1McReluOrbx7CRRaynwGvCd5DIzOw5Vb1RmjYghkQdxCVNuhAks0PZ9hBBXgJSEPfGqoXPxdUkGQq8NK7WFL0Zxn0dxk/MAO8GQhX4E6cTSXJVAQnsdHXBmvzSHIP3R3bZScnj8UAAAAASUVORK5CYII=",
- "disable": false,
- "provider_type": "oidc",
- "oidc_config": {
- "client_id": "my-oidc-client-id",
- "client_secret": "s3cr3tK3yForOIDC",
- "request_scopes": [
- "openid",
- "email",
- "profile"
], - "ssl_verify": true,
- "attributes": {
- "first_name": "john",
- "last_name": "doe",
- "username": "johndoe"
}
}
}
}
IAM Action: portal:UpdateDeveloperLoginOption
, Resource: arn:api7:portal:loginsetting/*
login_option_id required | string Login option ID. |
op required | string Enum: "add" "replace" The operation to be performed. |
path required | string Path to the field to be replaced or added. Path should follow the JSON Pointer format. |
value required | any Value to be added or replaced. |
[- {
- "op": "add",
- "path": "/name",
- "value": "new-name"
}
]
{- "value": {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "name": "example-login",
- "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAACXBIWXMAAAsTAAALEwEAmpwYAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAH4SURBVHgBrVVLUhsxEH3SaBJSxJQWLLJKzAkClcqCVcINkhuYk6RygnCDkBOYI3iXTVKQE9ipggIGKKb42TAjNWrbY0+BkcY2b6ceqV/3688Ac6CrF+r/tfzmuyMxI25rL75klO+exDbFcxP0luItAjXbKteSsOe7qzAFWBJpbZOIVhNlkAkgyvHP96ZyBiyJMGaXnd8JQhJZgNBZSzGfRKS1LiRxR822dpwPPgq/PAyvRCzJnb1pukhXC9uZi5ylGfgPEzyZQbcWNwpJChtLcxyZ8WOaMYPua/XZRffzoT1xzq0Yn3vGX+B+EJOMr67yFkXZivO1XdjOnTRpROVr6XqKDmYh6JO4xy8vs00mMpJ2kpI0QwTl8RKUiZSlX+9yhcWSPqIiQaVBEyQ/Lbi2X7EK19LiULlOArWqvK00aC7wUSctWom3WcQZNH6/QT30VqACerX4HMMhY+yrfFxwgW3H9339aHLBgwQ8bG4e2sWZu+lAPSq4m0VsfDxF66E9KJE02Uge099Bj5ynzntjknNGuMgk3hd5JqU1McReluOrbx7CRRaynwGvCd5DIzOw5Vb1RmjYghkQdxCVNuhAks0PZ9hBBXgJSEPfGqoXPxdUkGQq8NK7WFL0Zxn0dxk/MAO8GQhX4E6cTSXJVAQnsdHXBmvzSHIP3R3bZScnj8UAAAAASUVORK5CYII=",
- "disable": false,
- "provider_type": "oidc",
- "oidc_config": {
- "client_id": "my-oidc-client-id",
- "client_secret": "s3cr3tK3yForOIDC",
- "request_scopes": [
- "openid",
- "email",
- "profile"
], - "ssl_verify": true,
- "attributes": {
- "first_name": "john",
- "last_name": "doe",
- "username": "johndoe"
}
}
}
}
IAM Action: portal:UpdateDeveloperSCIMProvisioning
, Resource: arn:api7:portal:loginsetting/*
enable_scim | boolean Enable or disable the SCIM endpoint for provisioning and user management. |
{- "enable_scim": true
}
{- "value": {
- "enable_scim": true,
- "scim_encrypt_key": "F6OqjCmoRBqFBQIEsdpl33vgfLYTWJe6ynkwitqmaVE=",
- "scim_key_salt": "rIXtKGq4oXkzbwEzhzQ3FOa1nOPa2GuPDjdGGJ5TstpCv5irk8KSguBF4YukQqix"
}
}
IAM Action: portal:GetDeveloperSCIMProvisioning
, Resource: arn:api7:portal:loginsetting/*
{- "value": {
- "enable_scim": true,
- "scim_encrypt_key": "F6OqjCmoRBqFBQIEsdpl33vgfLYTWJe6ynkwitqmaVE=",
- "scim_key_salt": "rIXtKGq4oXkzbwEzhzQ3FOa1nOPa2GuPDjdGGJ5TstpCv5irk8KSguBF4YukQqix"
}
}
IAM Action: portal:UpdateDeveloperSCIMProvisioning
, Resource: arn:api7:portal:loginsetting/*
{- "value": "a7scim-t1dJGY89gg8tqMwV2QunhV7472Z26C9VjE3mkZUfgIEpj0WJ1I7FGoEXG92SMYpEw9iciDB2gQI-default"
}
IAM Action: iam:GetLoginOption
, Resource: arn:api7:iam:organization/*
login_option_id required | string Login option ID. |
{- "value": {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "name": "example-login",
- "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAACXBIWXMAAAsTAAALEwEAmpwYAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAH4SURBVHgBrVVLUhsxEH3SaBJSxJQWLLJKzAkClcqCVcINkhuYk6RygnCDkBOYI3iXTVKQE9ipggIGKKb42TAjNWrbY0+BkcY2b6ceqV/3688Ac6CrF+r/tfzmuyMxI25rL75klO+exDbFcxP0luItAjXbKteSsOe7qzAFWBJpbZOIVhNlkAkgyvHP96ZyBiyJMGaXnd8JQhJZgNBZSzGfRKS1LiRxR822dpwPPgq/PAyvRCzJnb1pukhXC9uZi5ylGfgPEzyZQbcWNwpJChtLcxyZ8WOaMYPua/XZRffzoT1xzq0Yn3vGX+B+EJOMr67yFkXZivO1XdjOnTRpROVr6XqKDmYh6JO4xy8vs00mMpJ2kpI0QwTl8RKUiZSlX+9yhcWSPqIiQaVBEyQ/Lbi2X7EK19LiULlOArWqvK00aC7wUSctWom3WcQZNH6/QT30VqACerX4HMMhY+yrfFxwgW3H9339aHLBgwQ8bG4e2sWZu+lAPSq4m0VsfDxF66E9KJE02Uge099Bj5ynzntjknNGuMgk3hd5JqU1McReluOrbx7CRRaynwGvCd5DIzOw5Vb1RmjYghkQdxCVNuhAks0PZ9hBBXgJSEPfGqoXPxdUkGQq8NK7WFL0Zxn0dxk/MAO8GQhX4E6cTSXJVAQnsdHXBmvzSHIP3R3bZScnj8UAAAAASUVORK5CYII=",
- "disable": false,
- "role_mapping": [
- {
- "role_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "role_attribute_key": "Position",
- "operation": "exact_match",
- "role_attribute_value": "Team Leader"
}
], - "boundary_mapping": [
- {
- "permission_policy_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "attribute_key": "Group",
- "operation": "exact_match",
- "attribute_value": "Finance"
}
], - "provider_type": "oidc",
- "oidc_config": {
- "client_id": "my-oidc-client-id",
- "client_secret": "s3cr3tK3yForOIDC",
- "request_scopes": [
- "openid",
- "email",
- "profile"
], - "ssl_verify": true,
- "attributes": {
- "first_name": "john",
- "last_name": "doe",
- "username": "johndoe"
}
}
}
}
IAM Action: iam:UpdateLoginOption
, Resource: arn:api7:iam:organization/*
login_option_id required | string Login option ID. |
name | string [ 1 .. 256 ] characters Name of the login option. |
logo | string The base64-encoded logo image. |
disable | boolean Default: false If true, disable the login option. |
Array of objects A list of role mappings defining operations and conditions under which roles are applied. | |
Array of objects A list of permission boundary mappings defining operations and conditions under which permission boundary are applied. | |
provider_type | string Value: "oidc" The login option type. |
object OIDC configuration. |
{- "name": "example-login",
- "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAACXBIWXMAAAsTAAALEwEAmpwYAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAH4SURBVHgBrVVLUhsxEH3SaBJSxJQWLLJKzAkClcqCVcINkhuYk6RygnCDkBOYI3iXTVKQE9ipggIGKKb42TAjNWrbY0+BkcY2b6ceqV/3688Ac6CrF+r/tfzmuyMxI25rL75klO+exDbFcxP0luItAjXbKteSsOe7qzAFWBJpbZOIVhNlkAkgyvHP96ZyBiyJMGaXnd8JQhJZgNBZSzGfRKS1LiRxR822dpwPPgq/PAyvRCzJnb1pukhXC9uZi5ylGfgPEzyZQbcWNwpJChtLcxyZ8WOaMYPua/XZRffzoT1xzq0Yn3vGX+B+EJOMr67yFkXZivO1XdjOnTRpROVr6XqKDmYh6JO4xy8vs00mMpJ2kpI0QwTl8RKUiZSlX+9yhcWSPqIiQaVBEyQ/Lbi2X7EK19LiULlOArWqvK00aC7wUSctWom3WcQZNH6/QT30VqACerX4HMMhY+yrfFxwgW3H9339aHLBgwQ8bG4e2sWZu+lAPSq4m0VsfDxF66E9KJE02Uge099Bj5ynzntjknNGuMgk3hd5JqU1McReluOrbx7CRRaynwGvCd5DIzOw5Vb1RmjYghkQdxCVNuhAks0PZ9hBBXgJSEPfGqoXPxdUkGQq8NK7WFL0Zxn0dxk/MAO8GQhX4E6cTSXJVAQnsdHXBmvzSHIP3R3bZScnj8UAAAAASUVORK5CYII=",
- "disable": false,
- "role_mapping": [
- {
- "role_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "role_attribute_key": "Position",
- "operation": "exact_match",
- "role_attribute_value": "Team Leader"
}
], - "boundary_mapping": [
- {
- "permission_policy_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "attribute_key": "Group",
- "operation": "exact_match",
- "attribute_value": "Finance"
}
], - "provider_type": "oidc",
- "oidc_config": {
- "client_id": "my-oidc-client-id",
- "client_secret": "s3cr3tK3yForOIDC",
- "request_scopes": [
- "openid",
- "email",
- "profile"
], - "ssl_verify": true,
- "attributes": {
- "first_name": "john",
- "last_name": "doe",
- "username": "johndoe"
}
}
}
{- "value": {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "name": "example-login",
- "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAACXBIWXMAAAsTAAALEwEAmpwYAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAH4SURBVHgBrVVLUhsxEH3SaBJSxJQWLLJKzAkClcqCVcINkhuYk6RygnCDkBOYI3iXTVKQE9ipggIGKKb42TAjNWrbY0+BkcY2b6ceqV/3688Ac6CrF+r/tfzmuyMxI25rL75klO+exDbFcxP0luItAjXbKteSsOe7qzAFWBJpbZOIVhNlkAkgyvHP96ZyBiyJMGaXnd8JQhJZgNBZSzGfRKS1LiRxR822dpwPPgq/PAyvRCzJnb1pukhXC9uZi5ylGfgPEzyZQbcWNwpJChtLcxyZ8WOaMYPua/XZRffzoT1xzq0Yn3vGX+B+EJOMr67yFkXZivO1XdjOnTRpROVr6XqKDmYh6JO4xy8vs00mMpJ2kpI0QwTl8RKUiZSlX+9yhcWSPqIiQaVBEyQ/Lbi2X7EK19LiULlOArWqvK00aC7wUSctWom3WcQZNH6/QT30VqACerX4HMMhY+yrfFxwgW3H9339aHLBgwQ8bG4e2sWZu+lAPSq4m0VsfDxF66E9KJE02Uge099Bj5ynzntjknNGuMgk3hd5JqU1McReluOrbx7CRRaynwGvCd5DIzOw5Vb1RmjYghkQdxCVNuhAks0PZ9hBBXgJSEPfGqoXPxdUkGQq8NK7WFL0Zxn0dxk/MAO8GQhX4E6cTSXJVAQnsdHXBmvzSHIP3R3bZScnj8UAAAAASUVORK5CYII=",
- "disable": false,
- "role_mapping": [
- {
- "role_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "role_attribute_key": "Position",
- "operation": "exact_match",
- "role_attribute_value": "Team Leader"
}
], - "boundary_mapping": [
- {
- "permission_policy_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "attribute_key": "Group",
- "operation": "exact_match",
- "attribute_value": "Finance"
}
], - "provider_type": "oidc",
- "oidc_config": {
- "client_id": "my-oidc-client-id",
- "client_secret": "s3cr3tK3yForOIDC",
- "request_scopes": [
- "openid",
- "email",
- "profile"
], - "ssl_verify": true,
- "attributes": {
- "first_name": "john",
- "last_name": "doe",
- "username": "johndoe"
}
}
}
}
IAM Action: iam:UpdateLoginOption
, Resource: arn:api7:iam:organization/*
login_option_id required | string Login option ID. |
op required | string Enum: "add" "replace" The operation to be performed. |
path required | string Path to the field to be replaced or added. Path should follow the JSON Pointer format. |
value required | any Value to be added or replaced. |
[- {
- "op": "add",
- "path": "/name",
- "value": "new-name"
}
]
{- "value": {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "name": "example-login",
- "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAACXBIWXMAAAsTAAALEwEAmpwYAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAH4SURBVHgBrVVLUhsxEH3SaBJSxJQWLLJKzAkClcqCVcINkhuYk6RygnCDkBOYI3iXTVKQE9ipggIGKKb42TAjNWrbY0+BkcY2b6ceqV/3688Ac6CrF+r/tfzmuyMxI25rL75klO+exDbFcxP0luItAjXbKteSsOe7qzAFWBJpbZOIVhNlkAkgyvHP96ZyBiyJMGaXnd8JQhJZgNBZSzGfRKS1LiRxR822dpwPPgq/PAyvRCzJnb1pukhXC9uZi5ylGfgPEzyZQbcWNwpJChtLcxyZ8WOaMYPua/XZRffzoT1xzq0Yn3vGX+B+EJOMr67yFkXZivO1XdjOnTRpROVr6XqKDmYh6JO4xy8vs00mMpJ2kpI0QwTl8RKUiZSlX+9yhcWSPqIiQaVBEyQ/Lbi2X7EK19LiULlOArWqvK00aC7wUSctWom3WcQZNH6/QT30VqACerX4HMMhY+yrfFxwgW3H9339aHLBgwQ8bG4e2sWZu+lAPSq4m0VsfDxF66E9KJE02Uge099Bj5ynzntjknNGuMgk3hd5JqU1McReluOrbx7CRRaynwGvCd5DIzOw5Vb1RmjYghkQdxCVNuhAks0PZ9hBBXgJSEPfGqoXPxdUkGQq8NK7WFL0Zxn0dxk/MAO8GQhX4E6cTSXJVAQnsdHXBmvzSHIP3R3bZScnj8UAAAAASUVORK5CYII=",
- "disable": false,
- "role_mapping": [
- {
- "role_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "role_attribute_key": "Position",
- "operation": "exact_match",
- "role_attribute_value": "Team Leader"
}
], - "boundary_mapping": [
- {
- "permission_policy_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "attribute_key": "Group",
- "operation": "exact_match",
- "attribute_value": "Finance"
}
], - "provider_type": "oidc",
- "oidc_config": {
- "client_id": "my-oidc-client-id",
- "client_secret": "s3cr3tK3yForOIDC",
- "request_scopes": [
- "openid",
- "email",
- "profile"
], - "ssl_verify": true,
- "attributes": {
- "first_name": "john",
- "last_name": "doe",
- "username": "johndoe"
}
}
}
}
IAM Action: iam:GetLoginOption
, Resource: arn:api7:iam:organization/*
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
order_by | string Default: "updated_at" Enum: "created_at" "updated_at" Index to order resources by. |
search | string Example: search=version%3Dv2 Condition to search resources by. |
name | string Name of the resource. |
{- "list": [
- {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "name": "example-login",
- "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAACXBIWXMAAAsTAAALEwEAmpwYAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAH4SURBVHgBrVVLUhsxEH3SaBJSxJQWLLJKzAkClcqCVcINkhuYk6RygnCDkBOYI3iXTVKQE9ipggIGKKb42TAjNWrbY0+BkcY2b6ceqV/3688Ac6CrF+r/tfzmuyMxI25rL75klO+exDbFcxP0luItAjXbKteSsOe7qzAFWBJpbZOIVhNlkAkgyvHP96ZyBiyJMGaXnd8JQhJZgNBZSzGfRKS1LiRxR822dpwPPgq/PAyvRCzJnb1pukhXC9uZi5ylGfgPEzyZQbcWNwpJChtLcxyZ8WOaMYPua/XZRffzoT1xzq0Yn3vGX+B+EJOMr67yFkXZivO1XdjOnTRpROVr6XqKDmYh6JO4xy8vs00mMpJ2kpI0QwTl8RKUiZSlX+9yhcWSPqIiQaVBEyQ/Lbi2X7EK19LiULlOArWqvK00aC7wUSctWom3WcQZNH6/QT30VqACerX4HMMhY+yrfFxwgW3H9339aHLBgwQ8bG4e2sWZu+lAPSq4m0VsfDxF66E9KJE02Uge099Bj5ynzntjknNGuMgk3hd5JqU1McReluOrbx7CRRaynwGvCd5DIzOw5Vb1RmjYghkQdxCVNuhAks0PZ9hBBXgJSEPfGqoXPxdUkGQq8NK7WFL0Zxn0dxk/MAO8GQhX4E6cTSXJVAQnsdHXBmvzSHIP3R3bZScnj8UAAAAASUVORK5CYII=",
- "disable": false,
- "role_mapping": [
- {
- "role_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "role_attribute_key": "Position",
- "operation": "exact_match",
- "role_attribute_value": "Team Leader"
}
], - "boundary_mapping": [
- {
- "permission_policy_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "attribute_key": "Group",
- "operation": "exact_match",
- "attribute_value": "Finance"
}
], - "provider_type": "oidc",
- "oidc_config": {
- "client_id": "my-oidc-client-id",
- "client_secret": "s3cr3tK3yForOIDC",
- "request_scopes": [
- "openid",
- "email",
- "profile"
], - "ssl_verify": true,
- "attributes": {
- "first_name": "john",
- "last_name": "doe",
- "username": "johndoe"
}
}
}
], - "total": 1
}
IAM Action: iam:CreateLoginOption
, Resource: arn:api7:iam:organization/*
name | string [ 1 .. 256 ] characters Name of the login option. |
logo | string The base64-encoded logo image. |
disable | boolean Default: false If true, disable the login option. |
Array of objects A list of role mappings defining operations and conditions under which roles are applied. | |
Array of objects A list of permission boundary mappings defining operations and conditions under which permission boundary are applied. | |
provider_type | string Value: "oidc" The login option type. |
object OIDC configuration. |
{- "name": "example-login",
- "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAACXBIWXMAAAsTAAALEwEAmpwYAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAH4SURBVHgBrVVLUhsxEH3SaBJSxJQWLLJKzAkClcqCVcINkhuYk6RygnCDkBOYI3iXTVKQE9ipggIGKKb42TAjNWrbY0+BkcY2b6ceqV/3688Ac6CrF+r/tfzmuyMxI25rL75klO+exDbFcxP0luItAjXbKteSsOe7qzAFWBJpbZOIVhNlkAkgyvHP96ZyBiyJMGaXnd8JQhJZgNBZSzGfRKS1LiRxR822dpwPPgq/PAyvRCzJnb1pukhXC9uZi5ylGfgPEzyZQbcWNwpJChtLcxyZ8WOaMYPua/XZRffzoT1xzq0Yn3vGX+B+EJOMr67yFkXZivO1XdjOnTRpROVr6XqKDmYh6JO4xy8vs00mMpJ2kpI0QwTl8RKUiZSlX+9yhcWSPqIiQaVBEyQ/Lbi2X7EK19LiULlOArWqvK00aC7wUSctWom3WcQZNH6/QT30VqACerX4HMMhY+yrfFxwgW3H9339aHLBgwQ8bG4e2sWZu+lAPSq4m0VsfDxF66E9KJE02Uge099Bj5ynzntjknNGuMgk3hd5JqU1McReluOrbx7CRRaynwGvCd5DIzOw5Vb1RmjYghkQdxCVNuhAks0PZ9hBBXgJSEPfGqoXPxdUkGQq8NK7WFL0Zxn0dxk/MAO8GQhX4E6cTSXJVAQnsdHXBmvzSHIP3R3bZScnj8UAAAAASUVORK5CYII=",
- "disable": false,
- "role_mapping": [
- {
- "role_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "role_attribute_key": "Position",
- "operation": "exact_match",
- "role_attribute_value": "Team Leader"
}
], - "boundary_mapping": [
- {
- "permission_policy_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "attribute_key": "Group",
- "operation": "exact_match",
- "attribute_value": "Finance"
}
], - "provider_type": "oidc",
- "oidc_config": {
- "client_id": "my-oidc-client-id",
- "client_secret": "s3cr3tK3yForOIDC",
- "request_scopes": [
- "openid",
- "email",
- "profile"
], - "ssl_verify": true,
- "attributes": {
- "first_name": "john",
- "last_name": "doe",
- "username": "johndoe"
}
}
}
{- "list": [
- {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "name": "example-login",
- "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAACXBIWXMAAAsTAAALEwEAmpwYAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAH4SURBVHgBrVVLUhsxEH3SaBJSxJQWLLJKzAkClcqCVcINkhuYk6RygnCDkBOYI3iXTVKQE9ipggIGKKb42TAjNWrbY0+BkcY2b6ceqV/3688Ac6CrF+r/tfzmuyMxI25rL75klO+exDbFcxP0luItAjXbKteSsOe7qzAFWBJpbZOIVhNlkAkgyvHP96ZyBiyJMGaXnd8JQhJZgNBZSzGfRKS1LiRxR822dpwPPgq/PAyvRCzJnb1pukhXC9uZi5ylGfgPEzyZQbcWNwpJChtLcxyZ8WOaMYPua/XZRffzoT1xzq0Yn3vGX+B+EJOMr67yFkXZivO1XdjOnTRpROVr6XqKDmYh6JO4xy8vs00mMpJ2kpI0QwTl8RKUiZSlX+9yhcWSPqIiQaVBEyQ/Lbi2X7EK19LiULlOArWqvK00aC7wUSctWom3WcQZNH6/QT30VqACerX4HMMhY+yrfFxwgW3H9339aHLBgwQ8bG4e2sWZu+lAPSq4m0VsfDxF66E9KJE02Uge099Bj5ynzntjknNGuMgk3hd5JqU1McReluOrbx7CRRaynwGvCd5DIzOw5Vb1RmjYghkQdxCVNuhAks0PZ9hBBXgJSEPfGqoXPxdUkGQq8NK7WFL0Zxn0dxk/MAO8GQhX4E6cTSXJVAQnsdHXBmvzSHIP3R3bZScnj8UAAAAASUVORK5CYII=",
- "disable": false,
- "role_mapping": [
- {
- "role_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "role_attribute_key": "Position",
- "operation": "exact_match",
- "role_attribute_value": "Team Leader"
}
], - "boundary_mapping": [
- {
- "permission_policy_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "attribute_key": "Group",
- "operation": "exact_match",
- "attribute_value": "Finance"
}
], - "provider_type": "oidc",
- "oidc_config": {
- "client_id": "my-oidc-client-id",
- "client_secret": "s3cr3tK3yForOIDC",
- "request_scopes": [
- "openid",
- "email",
- "profile"
], - "ssl_verify": true,
- "attributes": {
- "first_name": "john",
- "last_name": "doe",
- "username": "johndoe"
}
}
}
], - "total": 1
}
List login options. No authentication is required, and provider or policy/role details are not included in the response.
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
order_by | string Default: "updated_at" Enum: "created_at" "updated_at" Index to order resources by. |
search | string Example: search=version%3Dv2 Condition to search resources by. |
name | string Name of the resource. |
{- "list": [
- {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "name": "API7 Integrated Authentication",
- "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAACXBIWXMAAAsTAAALEwEAmpwYAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAH4SURBVHgBrVVLUhsxEH3SaBJSxJQWLLJKzAkClcqCVcINkhuYk6RygnCDkBOYI3iXTVKQE9ipggIGKKb42TAjNWrbY0+BkcY2b6ceqV/3688Ac6CrF+r/tfzmuyMxI25rL75klO+exDbFcxP0luItAjXbKteSsOe7qzAFWBJpbZOIVhNlkAkgyvHP96ZyBiyJMGaXnd8JQhJZgNBZSzGfRKS1LiRxR822dpwPPgq/PAyvRCzJnb1pukhXC9uZi5ylGfgPEzyZQbcWNwpJChtLcxyZ8WOaMYPua/XZRffzoT1xzq0Yn3vGX+B+EJOMr67yFkXZivO1XdjOnTRpROVr6XqKDmYh6JO4xy8vs00mMpJ2kpI0QwTl8RKUiZSlX+9yhcWSPqIiQaVBEyQ/Lbi2X7EK19LiULlOArWqvK00aC7wUSctWom3WcQZNH6/QT30VqACerX4HMMhY+yrfFxwgW3H9339aHLBgwQ8bG4e2sWZu+lAPSq4m0VsfDxF66E9KJE02Uge099Bj5ynzntjknNGuMgk3hd5JqU1McReluOrbx7CRRaynwGvCd5DIzOw5Vb1RmjYghkQdxCVNuhAks0PZ9hBBXgJSEPfGqoXPxdUkGQq8NK7WFL0Zxn0dxk/MAO8GQhX4E6cTSXJVAQnsdHXBmvzSHIP3R3bZScnj8UAAAAASUVORK5CYII=",
- "disable": false,
- "provider_type": "built_in",
- "builtin_config": {
- "login_with_email": false
}
}
], - "total": 1
}
resource_type required | string Enum: "gateway_group" "contact_point" Resource type. |
ids required | Array of strings non-empty unique [ items non-empty ] An array of resource IDs. |
{- "resource_type": "gateway_group",
- "ids": [
- "string"
]
}
{- "value": {
- "b5f57bda-b52b-41f6-9a30-a4c6442a3a74": "gateway-group-1",
- "f6ef6104-32a3-4382-a4b8-07cc17c466d8": "gateway-group-2"
}
}
IAM Action: gateway:GetCustomPlugin
, Resource: arn:api7:gateway:gatewaysetting/*
gateway_group_id | string >= 1 Gateway group ID. |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
order_by | string Default: "updated_at" Enum: "created_at" "updated_at" Index to order resources by. |
search | string Example: search=version%3Dv2 Condition to search resources by. |
name | string Name of the resource. |
{- "list": [
- {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "name": "route-id-register",
- "version": "0.2",
- "source_code": "local core = require(\"apisix.core\")\nlocal ngx = ngx\n\nlocal schema = {\n type = \"object\"\n}\n\nlocal plugin_name = \"route-id-register\"\n\nlocal _M = {\n version = 0.2,\n priority = 1,\n name = plugin_name,\n schema = schema,\n scope = \"global\",\n}\n\nfunction _M.check_schema(conf)\n return core.schema.check(schema, conf);\nend\n\nfunction _M.log(conf, ctx)\n if ctx.var.route_id then\n ngx.var.route_id = ctx.var.route_id\n end\nend\n\nreturn _M\n",
- "file": "bG9jYWwgY29yZSA9IHJlcXVpcmUoImFwaXNpeC5jb3JlIikKbG9jYWwgbmd4ID0gbmd4Cgpsb2NhbCBzY2hlbWEgPSB7CiAgICB0eXBlID0gIm9iamVjdCIKfQoKbG9jYWwgcGx1Z2luX25hbWUgPSAicm91dGUtaWQtcmVnaXN0ZXIiCgpsb2NhbCBfTSA9IHsKICB2ZXJzaW9uID0gMC4yLAogIHByaW9yaXR5ID0gMSwKICBuYW1lID0gcGx1Z2luX25hbWUsCiAgc2NoZW1hID0gc2NoZW1hLAogIHNjb3BlID0gImdsb2JhbCIsCn0KCmZ1bmN0aW9uIF9NLmNoZWNrX3NjaGVtYShjb25mKQogIHJldHVybiBjb3JlLnNjaGVtYS5jaGVjayhzY2hlbWEsIGNvbmYpOwplbmQKCmZ1bmN0aW9uIF9NLmxvZyhjb25mLCBjdHgpCiAgaWYgY3R4LnZhci5yb3V0ZV9pZCB0aGVuCiAgICBuZ3gudmFyLnJvdXRlX2lkID0gY3R4LnZhci5yb3V0ZV9pZAogIGVuZAplbmQKCnJldHVybiBfTQo=",
- "catalog": "General",
- "description": "This plugin records the matched route’s ID into an Nginx variable ($route_id) for use in logging and monitoring.",
- "author": "plugindev",
- "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAACXBIWXMAAAsTAAALEwEAmpwYAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAH4SURBVHgBrVVLUhsxEH3SaBJSxJQWLLJKzAkClcqCVcINkhuYk6RygnCDkBOYI3iXTVKQE9ipggIGKKb42TAjNWrbY0+BkcY2b6ceqV/3688Ac6CrF+r/tfzmuyMxI25rL75klO+exDbFcxP0luItAjXbKteSsOe7qzAFWBJpbZOIVhNlkAkgyvHP96ZyBiyJMGaXnd8JQhJZgNBZSzGfRKS1LiRxR822dpwPPgq/PAyvRCzJnb1pukhXC9uZi5ylGfgPEzyZQbcWNwpJChtLcxyZ8WOaMYPua/XZRffzoT1xzq0Yn3vGX+B+EJOMr67yFkXZivO1XdjOnTRpROVr6XqKDmYh6JO4xy8vs00mMpJ2kpI0QwTl8RKUiZSlX+9yhcWSPqIiQaVBEyQ/Lbi2X7EK19LiULlOArWqvK00aC7wUSctWom3WcQZNH6/QT30VqACerX4HMMhY+yrfFxwgW3H9339aHLBgwQ8bG4e2sWZu+lAPSq4m0VsfDxF66E9KJE02Uge099Bj5ynzntjknNGuMgk3hd5JqU1McReluOrbx7CRRaynwGvCd5DIzOw5Vb1RmjYghkQdxCVNuhAks0PZ9hBBXgJSEPfGqoXPxdUkGQq8NK7WFL0Zxn0dxk/MAO8GQhX4E6cTSXJVAQnsdHXBmvzSHIP3R3bZScnj8UAAAAASUVORK5CYII=",
- "is_obfuscated": false,
- "gateway_groups": [
- "bc1b95c9-b348-4832-acc3-e257d2342df1"
], - "created_at": 1742288232,
- "updated_at": 1742288235
}
], - "total": 1
}
IAM Action: gateway:CreateCustomPlugin
, Resource: arn:api7:gateway:gatewaysetting/*
source_code required | string The source code for the plugin. |
catalog | string Plugin category, such as "Traffic" or "Observability". |
description | string A brief description of the plugin. |
documentation_link | string Link to the plugin's documentation. |
author | string Author of the plugin. |
logo | string The base64-encoded logo image. |
gateway_groups required | Array of strings[ items [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ ] An array of gateway group IDs that the custom plugin is associated with. |
{- "source_code": "local core = require(\"apisix.core\")\nlocal ngx = ngx\n\nlocal schema = {\n type = \"object\"\n}\n\nlocal plugin_name = \"route-id-register\"\n\nlocal _M = {\n version = 0.2,\n priority = 1,\n name = plugin_name,\n schema = schema,\n scope = \"global\",\n}\n\nfunction _M.check_schema(conf)\n return core.schema.check(schema, conf);\nend\n\nfunction _M.log(conf, ctx)\n if ctx.var.route_id then\n ngx.var.route_id = ctx.var.route_id\n end\nend\n\nreturn _M\n",
- "catalog": "General",
- "description": "This plugin records the matched route’s ID into an Nginx variable ($route_id) for use in logging and monitoring.",
- "author": "plugindev",
- "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAACXBIWXMAAAsTAAALEwEAmpwYAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAH4SURBVHgBrVVLUhsxEH3SaBJSxJQWLLJKzAkClcqCVcINkhuYk6RygnCDkBOYI3iXTVKQE9ipggIGKKb42TAjNWrbY0+BkcY2b6ceqV/3688Ac6CrF+r/tfzmuyMxI25rL75klO+exDbFcxP0luItAjXbKteSsOe7qzAFWBJpbZOIVhNlkAkgyvHP96ZyBiyJMGaXnd8JQhJZgNBZSzGfRKS1LiRxR822dpwPPgq/PAyvRCzJnb1pukhXC9uZi5ylGfgPEzyZQbcWNwpJChtLcxyZ8WOaMYPua/XZRffzoT1xzq0Yn3vGX+B+EJOMr67yFkXZivO1XdjOnTRpROVr6XqKDmYh6JO4xy8vs00mMpJ2kpI0QwTl8RKUiZSlX+9yhcWSPqIiQaVBEyQ/Lbi2X7EK19LiULlOArWqvK00aC7wUSctWom3WcQZNH6/QT30VqACerX4HMMhY+yrfFxwgW3H9339aHLBgwQ8bG4e2sWZu+lAPSq4m0VsfDxF66E9KJE02Uge099Bj5ynzntjknNGuMgk3hd5JqU1McReluOrbx7CRRaynwGvCd5DIzOw5Vb1RmjYghkQdxCVNuhAks0PZ9hBBXgJSEPfGqoXPxdUkGQq8NK7WFL0Zxn0dxk/MAO8GQhX4E6cTSXJVAQnsdHXBmvzSHIP3R3bZScnj8UAAAAASUVORK5CYII=",
- "gateway_groups": [
- "bc1b95c9-b348-4832-acc3-e257d2342df1"
]
}
{- "value": {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "name": "route-id-register",
- "version": "0.2",
- "source_code": "local core = require(\"apisix.core\")\nlocal ngx = ngx\n\nlocal schema = {\n type = \"object\"\n}\n\nlocal plugin_name = \"route-id-register\"\n\nlocal _M = {\n version = 0.2,\n priority = 1,\n name = plugin_name,\n schema = schema,\n scope = \"global\",\n}\n\nfunction _M.check_schema(conf)\n return core.schema.check(schema, conf);\nend\n\nfunction _M.log(conf, ctx)\n if ctx.var.route_id then\n ngx.var.route_id = ctx.var.route_id\n end\nend\n\nreturn _M\n",
- "file": "bG9jYWwgY29yZSA9IHJlcXVpcmUoImFwaXNpeC5jb3JlIikKbG9jYWwgbmd4ID0gbmd4Cgpsb2NhbCBzY2hlbWEgPSB7CiAgICB0eXBlID0gIm9iamVjdCIKfQoKbG9jYWwgcGx1Z2luX25hbWUgPSAicm91dGUtaWQtcmVnaXN0ZXIiCgpsb2NhbCBfTSA9IHsKICB2ZXJzaW9uID0gMC4yLAogIHByaW9yaXR5ID0gMSwKICBuYW1lID0gcGx1Z2luX25hbWUsCiAgc2NoZW1hID0gc2NoZW1hLAogIHNjb3BlID0gImdsb2JhbCIsCn0KCmZ1bmN0aW9uIF9NLmNoZWNrX3NjaGVtYShjb25mKQogIHJldHVybiBjb3JlLnNjaGVtYS5jaGVjayhzY2hlbWEsIGNvbmYpOwplbmQKCmZ1bmN0aW9uIF9NLmxvZyhjb25mLCBjdHgpCiAgaWYgY3R4LnZhci5yb3V0ZV9pZCB0aGVuCiAgICBuZ3gudmFyLnJvdXRlX2lkID0gY3R4LnZhci5yb3V0ZV9pZAogIGVuZAplbmQKCnJldHVybiBfTQo=",
- "catalog": "General",
- "description": "This plugin records the matched route’s ID into an Nginx variable ($route_id) for use in logging and monitoring.",
- "author": "plugindev",
- "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAACXBIWXMAAAsTAAALEwEAmpwYAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAH4SURBVHgBrVVLUhsxEH3SaBJSxJQWLLJKzAkClcqCVcINkhuYk6RygnCDkBOYI3iXTVKQE9ipggIGKKb42TAjNWrbY0+BkcY2b6ceqV/3688Ac6CrF+r/tfzmuyMxI25rL75klO+exDbFcxP0luItAjXbKteSsOe7qzAFWBJpbZOIVhNlkAkgyvHP96ZyBiyJMGaXnd8JQhJZgNBZSzGfRKS1LiRxR822dpwPPgq/PAyvRCzJnb1pukhXC9uZi5ylGfgPEzyZQbcWNwpJChtLcxyZ8WOaMYPua/XZRffzoT1xzq0Yn3vGX+B+EJOMr67yFkXZivO1XdjOnTRpROVr6XqKDmYh6JO4xy8vs00mMpJ2kpI0QwTl8RKUiZSlX+9yhcWSPqIiQaVBEyQ/Lbi2X7EK19LiULlOArWqvK00aC7wUSctWom3WcQZNH6/QT30VqACerX4HMMhY+yrfFxwgW3H9339aHLBgwQ8bG4e2sWZu+lAPSq4m0VsfDxF66E9KJE02Uge099Bj5ynzntjknNGuMgk3hd5JqU1McReluOrbx7CRRaynwGvCd5DIzOw5Vb1RmjYghkQdxCVNuhAks0PZ9hBBXgJSEPfGqoXPxdUkGQq8NK7WFL0Zxn0dxk/MAO8GQhX4E6cTSXJVAQnsdHXBmvzSHIP3R3bZScnj8UAAAAASUVORK5CYII=",
- "is_obfuscated": false,
- "gateway_groups": [
- "bc1b95c9-b348-4832-acc3-e257d2342df1"
], - "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:GetCustomPlugin
, Resource: arn:api7:gateway:gatewaysetting/*
custom_plugin_id required | string Custom plugin ID. |
{- "value": {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "name": "route-id-register",
- "version": "0.2",
- "source_code": "local core = require(\"apisix.core\")\nlocal ngx = ngx\n\nlocal schema = {\n type = \"object\"\n}\n\nlocal plugin_name = \"route-id-register\"\n\nlocal _M = {\n version = 0.2,\n priority = 1,\n name = plugin_name,\n schema = schema,\n scope = \"global\",\n}\n\nfunction _M.check_schema(conf)\n return core.schema.check(schema, conf);\nend\n\nfunction _M.log(conf, ctx)\n if ctx.var.route_id then\n ngx.var.route_id = ctx.var.route_id\n end\nend\n\nreturn _M\n",
- "file": "bG9jYWwgY29yZSA9IHJlcXVpcmUoImFwaXNpeC5jb3JlIikKbG9jYWwgbmd4ID0gbmd4Cgpsb2NhbCBzY2hlbWEgPSB7CiAgICB0eXBlID0gIm9iamVjdCIKfQoKbG9jYWwgcGx1Z2luX25hbWUgPSAicm91dGUtaWQtcmVnaXN0ZXIiCgpsb2NhbCBfTSA9IHsKICB2ZXJzaW9uID0gMC4yLAogIHByaW9yaXR5ID0gMSwKICBuYW1lID0gcGx1Z2luX25hbWUsCiAgc2NoZW1hID0gc2NoZW1hLAogIHNjb3BlID0gImdsb2JhbCIsCn0KCmZ1bmN0aW9uIF9NLmNoZWNrX3NjaGVtYShjb25mKQogIHJldHVybiBjb3JlLnNjaGVtYS5jaGVjayhzY2hlbWEsIGNvbmYpOwplbmQKCmZ1bmN0aW9uIF9NLmxvZyhjb25mLCBjdHgpCiAgaWYgY3R4LnZhci5yb3V0ZV9pZCB0aGVuCiAgICBuZ3gudmFyLnJvdXRlX2lkID0gY3R4LnZhci5yb3V0ZV9pZAogIGVuZAplbmQKCnJldHVybiBfTQo=",
- "catalog": "General",
- "description": "This plugin records the matched route’s ID into an Nginx variable ($route_id) for use in logging and monitoring.",
- "author": "plugindev",
- "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAACXBIWXMAAAsTAAALEwEAmpwYAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAH4SURBVHgBrVVLUhsxEH3SaBJSxJQWLLJKzAkClcqCVcINkhuYk6RygnCDkBOYI3iXTVKQE9ipggIGKKb42TAjNWrbY0+BkcY2b6ceqV/3688Ac6CrF+r/tfzmuyMxI25rL75klO+exDbFcxP0luItAjXbKteSsOe7qzAFWBJpbZOIVhNlkAkgyvHP96ZyBiyJMGaXnd8JQhJZgNBZSzGfRKS1LiRxR822dpwPPgq/PAyvRCzJnb1pukhXC9uZi5ylGfgPEzyZQbcWNwpJChtLcxyZ8WOaMYPua/XZRffzoT1xzq0Yn3vGX+B+EJOMr67yFkXZivO1XdjOnTRpROVr6XqKDmYh6JO4xy8vs00mMpJ2kpI0QwTl8RKUiZSlX+9yhcWSPqIiQaVBEyQ/Lbi2X7EK19LiULlOArWqvK00aC7wUSctWom3WcQZNH6/QT30VqACerX4HMMhY+yrfFxwgW3H9339aHLBgwQ8bG4e2sWZu+lAPSq4m0VsfDxF66E9KJE02Uge099Bj5ynzntjknNGuMgk3hd5JqU1McReluOrbx7CRRaynwGvCd5DIzOw5Vb1RmjYghkQdxCVNuhAks0PZ9hBBXgJSEPfGqoXPxdUkGQq8NK7WFL0Zxn0dxk/MAO8GQhX4E6cTSXJVAQnsdHXBmvzSHIP3R3bZScnj8UAAAAASUVORK5CYII=",
- "is_obfuscated": false,
- "gateway_groups": [
- "bc1b95c9-b348-4832-acc3-e257d2342df1"
], - "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: gateway:UpdateCustomPlugin
, Resource: arn:api7:gateway:gatewaysetting/*
custom_plugin_id required | string Custom plugin ID. |
source_code required | string The source code for the plugin. |
catalog | string Plugin category, such as "Traffic" or "Observability". |
description | string A brief description of the plugin. |
documentation_link | string Link to the plugin's documentation. |
author | string Author of the plugin. |
logo | string The base64-encoded logo image. |
gateway_groups required | Array of strings[ items [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ ] An array of gateway group IDs that the custom plugin is associated with. |
{- "source_code": "local core = require(\"apisix.core\")\nlocal ngx = ngx\n\nlocal schema = {\n type = \"object\"\n}\n\nlocal plugin_name = \"route-id-register\"\n\nlocal _M = {\n version = 0.2,\n priority = 1,\n name = plugin_name,\n schema = schema,\n scope = \"global\",\n}\n\nfunction _M.check_schema(conf)\n return core.schema.check(schema, conf);\nend\n\nfunction _M.log(conf, ctx)\n if ctx.var.route_id then\n ngx.var.route_id = ctx.var.route_id\n end\nend\n\nreturn _M\n",
- "catalog": "General",
- "description": "This plugin records the matched route’s ID into an Nginx variable ($route_id) for use in logging and monitoring.",
- "author": "plugindev",
- "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAACXBIWXMAAAsTAAALEwEAmpwYAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAH4SURBVHgBrVVLUhsxEH3SaBJSxJQWLLJKzAkClcqCVcINkhuYk6RygnCDkBOYI3iXTVKQE9ipggIGKKb42TAjNWrbY0+BkcY2b6ceqV/3688Ac6CrF+r/tfzmuyMxI25rL75klO+exDbFcxP0luItAjXbKteSsOe7qzAFWBJpbZOIVhNlkAkgyvHP96ZyBiyJMGaXnd8JQhJZgNBZSzGfRKS1LiRxR822dpwPPgq/PAyvRCzJnb1pukhXC9uZi5ylGfgPEzyZQbcWNwpJChtLcxyZ8WOaMYPua/XZRffzoT1xzq0Yn3vGX+B+EJOMr67yFkXZivO1XdjOnTRpROVr6XqKDmYh6JO4xy8vs00mMpJ2kpI0QwTl8RKUiZSlX+9yhcWSPqIiQaVBEyQ/Lbi2X7EK19LiULlOArWqvK00aC7wUSctWom3WcQZNH6/QT30VqACerX4HMMhY+yrfFxwgW3H9339aHLBgwQ8bG4e2sWZu+lAPSq4m0VsfDxF66E9KJE02Uge099Bj5ynzntjknNGuMgk3hd5JqU1McReluOrbx7CRRaynwGvCd5DIzOw5Vb1RmjYghkQdxCVNuhAks0PZ9hBBXgJSEPfGqoXPxdUkGQq8NK7WFL0Zxn0dxk/MAO8GQhX4E6cTSXJVAQnsdHXBmvzSHIP3R3bZScnj8UAAAAASUVORK5CYII=",
- "gateway_groups": [
- "bc1b95c9-b348-4832-acc3-e257d2342df1"
]
}
{- "value": {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "name": "route-id-register",
- "version": "0.2",
- "source_code": "local core = require(\"apisix.core\")\nlocal ngx = ngx\n\nlocal schema = {\n type = \"object\"\n}\n\nlocal plugin_name = \"route-id-register\"\n\nlocal _M = {\n version = 0.2,\n priority = 1,\n name = plugin_name,\n schema = schema,\n scope = \"global\",\n}\n\nfunction _M.check_schema(conf)\n return core.schema.check(schema, conf);\nend\n\nfunction _M.log(conf, ctx)\n if ctx.var.route_id then\n ngx.var.route_id = ctx.var.route_id\n end\nend\n\nreturn _M\n",
- "file": "bG9jYWwgY29yZSA9IHJlcXVpcmUoImFwaXNpeC5jb3JlIikKbG9jYWwgbmd4ID0gbmd4Cgpsb2NhbCBzY2hlbWEgPSB7CiAgICB0eXBlID0gIm9iamVjdCIKfQoKbG9jYWwgcGx1Z2luX25hbWUgPSAicm91dGUtaWQtcmVnaXN0ZXIiCgpsb2NhbCBfTSA9IHsKICB2ZXJzaW9uID0gMC4yLAogIHByaW9yaXR5ID0gMSwKICBuYW1lID0gcGx1Z2luX25hbWUsCiAgc2NoZW1hID0gc2NoZW1hLAogIHNjb3BlID0gImdsb2JhbCIsCn0KCmZ1bmN0aW9uIF9NLmNoZWNrX3NjaGVtYShjb25mKQogIHJldHVybiBjb3JlLnNjaGVtYS5jaGVjayhzY2hlbWEsIGNvbmYpOwplbmQKCmZ1bmN0aW9uIF9NLmxvZyhjb25mLCBjdHgpCiAgaWYgY3R4LnZhci5yb3V0ZV9pZCB0aGVuCiAgICBuZ3gudmFyLnJvdXRlX2lkID0gY3R4LnZhci5yb3V0ZV9pZAogIGVuZAplbmQKCnJldHVybiBfTQo=",
- "catalog": "General",
- "description": "This plugin records the matched route’s ID into an Nginx variable ($route_id) for use in logging and monitoring.",
- "author": "plugindev",
- "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAACXBIWXMAAAsTAAALEwEAmpwYAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAH4SURBVHgBrVVLUhsxEH3SaBJSxJQWLLJKzAkClcqCVcINkhuYk6RygnCDkBOYI3iXTVKQE9ipggIGKKb42TAjNWrbY0+BkcY2b6ceqV/3688Ac6CrF+r/tfzmuyMxI25rL75klO+exDbFcxP0luItAjXbKteSsOe7qzAFWBJpbZOIVhNlkAkgyvHP96ZyBiyJMGaXnd8JQhJZgNBZSzGfRKS1LiRxR822dpwPPgq/PAyvRCzJnb1pukhXC9uZi5ylGfgPEzyZQbcWNwpJChtLcxyZ8WOaMYPua/XZRffzoT1xzq0Yn3vGX+B+EJOMr67yFkXZivO1XdjOnTRpROVr6XqKDmYh6JO4xy8vs00mMpJ2kpI0QwTl8RKUiZSlX+9yhcWSPqIiQaVBEyQ/Lbi2X7EK19LiULlOArWqvK00aC7wUSctWom3WcQZNH6/QT30VqACerX4HMMhY+yrfFxwgW3H9339aHLBgwQ8bG4e2sWZu+lAPSq4m0VsfDxF66E9KJE02Uge099Bj5ynzntjknNGuMgk3hd5JqU1McReluOrbx7CRRaynwGvCd5DIzOw5Vb1RmjYghkQdxCVNuhAks0PZ9hBBXgJSEPfGqoXPxdUkGQq8NK7WFL0Zxn0dxk/MAO8GQhX4E6cTSXJVAQnsdHXBmvzSHIP3R3bZScnj8UAAAAASUVORK5CYII=",
- "is_obfuscated": false,
- "gateway_groups": [
- "bc1b95c9-b348-4832-acc3-e257d2342df1"
], - "created_at": 1742288232,
- "updated_at": 1742288235
}
}
file required | string Base64-encoded ZIP archive that contains the plugin package. The archive includes the plugin code and the plugin metadata. |
{- "file": "bG9jYWwgY29yZSA9IHJlcXVpcmUoImFwaXNpeC5jb3JlIikKbG9jYWwgbmd4ID0gbmd4Cgpsb2NhbCBzY2hlbWEgPSB7CiAgICB0eXBlID0gIm9iamVjdCIKfQoKbG9jYWwgcGx1Z2luX25hbWUgPSAicm91dGUtaWQtcmVnaXN0ZXIiCgpsb2NhbCBfTSA9IHsKICB2ZXJzaW9uID0gMC4yLAogIHByaW9yaXR5ID0gMSwKICBuYW1lID0gcGx1Z2luX25hbWUsCiAgc2NoZW1hID0gc2NoZW1hLAogIHNjb3BlID0gImdsb2JhbCIsCn0KCmZ1bmN0aW9uIF9NLmNoZWNrX3NjaGVtYShjb25mKQogIHJldHVybiBjb3JlLnNjaGVtYS5jaGVjayhzY2hlbWEsIGNvbmYpOwplbmQKCmZ1bmN0aW9uIF9NLmxvZyhjb25mLCBjdHgpCiAgaWYgY3R4LnZhci5yb3V0ZV9pZCB0aGVuCiAgICBuZ3gudmFyLnJvdXRlX2lkID0gY3R4LnZhci5yb3V0ZV9pZAogIGVuZAplbmQKCnJldHVybiBfTQo="
}
{- "value": {
- "name": "route-id-register",
- "version": "0.2",
- "catalog": "General",
- "description": "string",
- "author": "plugindev",
- "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAACXBIWXMAAAsTAAALEwEAmpwYAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAH4SURBVHgBrVVLUhsxEH3SaBJSxJQWLLJKzAkClcqCVcINkhuYk6RygnCDkBOYI3iXTVKQE9ipggIGKKb42TAjNWrbY0+BkcY2b6ceqV/3688Ac6CrF+r/tfzmuyMxI25rL75klO+exDbFcxP0luItAjXbKteSsOe7qzAFWBJpbZOIVhNlkAkgyvHP96ZyBiyJMGaXnd8JQhJZgNBZSzGfRKS1LiRxR822dpwPPgq/PAyvRCzJnb1pukhXC9uZi5ylGfgPEzyZQbcWNwpJChtLcxyZ8WOaMYPua/XZRffzoT1xzq0Yn3vGX+B+EJOMr67yFkXZivO1XdjOnTRpROVr6XqKDmYh6JO4xy8vs00mMpJ2kpI0QwTl8RKUiZSlX+9yhcWSPqIiQaVBEyQ/Lbi2X7EK19LiULlOArWqvK00aC7wUSctWom3WcQZNH6/QT30VqACerX4HMMhY+yrfFxwgW3H9339aHLBgwQ8bG4e2sWZu+lAPSq4m0VsfDxF66E9KJE02Uge099Bj5ynzntjknNGuMgk3hd5JqU1McReluOrbx7CRRaynwGvCd5DIzOw5Vb1RmjYghkQdxCVNuhAks0PZ9hBBXgJSEPfGqoXPxdUkGQq8NK7WFL0Zxn0dxk/MAO8GQhX4E6cTSXJVAQnsdHXBmvzSHIP3R3bZScnj8UAAAAASUVORK5CYII="
}
}
IAM Action: iam:CreateContactPoint
, Resource: arn:api7:iam:contactpoint/*
name | string [ 1 .. 256 ] characters Name of the contact point. |
desc | string <= 65536 characters The object description. |
object Key-value pairs of labels. | |
type | string Value: "email" Type of contact point. |
required | object Contact point email configurations. |
{- "name": "cp-docs-test",
- "desc": "Object description.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "type": "email",
- "email_config": {
- "email": [
- "user@example.com"
]
}
}
{- "value": {
- "name": "cp-docs-test",
- "desc": "Object description.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "type": "email",
- "email_config": {
- "email": [
- "user@example.com"
]
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: iam:GetContactPoint
, Resource: arn:api7:iam:contactpoint/%s
type | string Enum: "email" "webhook" |
labels | string non-empty Example: labels=labels%5Bversion%5D=v2 Label(s) to filter resources by. The format is |
search | string Example: search=version%3Dv2 Condition to search resources by. |
order_by | string Default: "updated_at" Enum: "created_at" "updated_at" Index to order resources by. |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
{- "list": [
- {
- "name": "cp-docs-test",
- "desc": "Object description.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "type": "email",
- "email_config": {
- "email": [
- "user@example.com"
]
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
], - "total": 1
}
IAM Action: iam:GetContactPoint
, Resource: arn:api7:iam:contactpoint/%s
contact_point_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 Contact point ID. |
{- "value": {
- "name": "cp-docs-test",
- "desc": "Object description.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "type": "email",
- "email_config": {
- "email": [
- "user@example.com"
]
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: iam:UpdateContactPoint
, Resource: arn:api7:iam:contactpoint/%s
contact_point_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 Contact point ID. |
name | string [ 1 .. 256 ] characters Name of the contact point. |
desc | string <= 65536 characters The object description. |
object Key-value pairs of labels. | |
type | string Value: "email" Type of contact point. |
required | object Contact point email configurations. |
{- "name": "cp-docs-test",
- "desc": "Object description.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "type": "email",
- "email_config": {
- "email": [
- "user@example.com"
]
}
}
{- "value": {
- "name": "cp-docs-test",
- "desc": "Object description.",
- "labels": {
- "version": "v2",
- "env": "prod"
}, - "type": "email",
- "email_config": {
- "email": [
- "user@example.com"
]
}, - "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235
}
}
IAM Action: iam:DeleteContactPoint
, Resource: arn:api7:iam:contactpoint/%s
contact_point_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 Contact point ID. |
""
IAM Action: iam:GetContactPoint
, Resource: arn:api7:iam:contactpoint/%s
contact_point_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 Contact point ID. |
start_at | integer Start at timestamp to filter the audit logs. |
end_at | integer End at timestamp to filter the audit logs. |
resource_type | string Enum: "alert_policy" "api_product_notification" Type of notification. |
status | string Enum: "success" "failed" Notification sending status. |
order_by | string Default: "send_time" Value: "send_time" Index to order the notifications by. |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
{- "list": [
- {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "contact_point_name": "cp-docs-test",
- "resource_type": "alert_policy",
- "resource_id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "resource_name": "Weather Insights API",
- "status": "failed",
- "send_time": 1759649130,
- "request": "{\"from\": \"test.send@api7.ai\", \"to\": \"test.receive@api7.ai\", \"subject\": \"API7 Notification\", \"content\": \"This is a test notification.\"}",
- "response": "450 The domain must be verified in your account to send emails."
}
], - "total": 1
}
IAM Action: iam:GetContactPoint
, Resource: arn:api7:iam:contactpoint/%s
contact_point_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 Contact point ID. |
resource_type | string Enum: "alert_policy" "api_product_notification" Type of notification. |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
{- "list": [
- {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "resource_type": "alert_policy",
- "resource_id": "b32e678e-7f6b-4a50-b113-550621ed4c01",
- "resource_name": "Weather Insights API"
}
], - "total": 1
}
For event type api_product_subscription
: IAM Action: portal:ApproveAPIProductSubscription
, Resource: arn:api7:portal:apiproduct/%s
For event type developer_registration
: IAM Action: portal:ApproveDeveloperSignUp
, Resource: arn:api7:portal:developer/*
status | string Enum: "pending" "finished" Approval status. |
result | string Enum: "accepted" "rejected" "cancelled" Approval outcome. |
event | string Enum: "api_product_subscription" "developer_registration" Approval event. |
resource_type | string Enum: "api_product" "developer" Resource type. |
resource_name | string Resource name. |
operator_name | string Operator name. |
applicant_name | string Applicant name. |
page | integer <int64> >= 1 Page number of the listed resources. Used together with |
page_size | integer <int64> >= 1 Number of resources listed per page. Used together with |
direction | string Default: "desc" Enum: "asc" "desc" Order to list the resources by. The sorting index follows the configuration of |
order_by | string Default: "applied_at" Enum: "applied_at" "resource_name" "operated_at" Index to order approvals by. |
search | string Example: search=version%3Dv2 Condition to search resources by. |
{- "list": [
- {
- "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
- "created_at": 1742288232,
- "updated_at": 1742288235,
- "event": "api_product_subscription",
- "resource_type": "api_product",
- "resource_id": "cf232ad4-2e9a-4dc0-ad6f-9c1a898465ae",
- "resource_name": "Weather Insights API",
- "applicant_type": "developer",
- "applicant_id": "78c93683-3eb3-4129-bb57-3a564a0ab2b0",
- "applicant_name": "dev1",
- "applied_at": 1742288230,
- "result": "accepted",
- "operator_id": "bf073ca7-ada6-4e75-be80-730436798cce",
- "operator_name": "admin1",
- "operated_at": 1742288230,
- "status": "pending"
}
], - "total": 1
}
For event type api_product_subscription
: IAM Action: portal:ApproveAPIProductSubscription
, Resource: arn:api7:portal:apiproduct/%s
For event type developer_registration
: IAM Action: portal:ApproveDeveloperSignUp
, Resource: arn:api7:portal:developer/*
approval_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 Approval ID. |
{- "value": { }
}
For event type api_product_subscription
: IAM Action: portal:ApproveAPIProductSubscription
, Resource: arn:api7:portal:apiproduct/%s
For event type developer_registration
: IAM Action: portal:ApproveDeveloperSignUp
, Resource: arn:api7:portal:developer/*
approval_id required | string [ 1 .. 256 ] characters ^[a-zA-Z0-9-_.]+$ Example: bd58fce2-b6cc-4d2d-a53c-6ce11b19c101 Approval ID. |
{- "value": { }
}