configs

Creates, updates, deletes, gets or lists a configs resource.

Overview

Name	configs
Type	Resource
Id	google.servicemanagement.configs

Fields

The following fields are returned by SELECT queries:

get

Name	Datatype	Description
id	string	A unique ID for a specific instance of this message, typically assigned by the client for tracking purpose. Must be no longer than 63 characters and only lower case letters, digits, '.', '_' and '-' are allowed. If empty, the server may choose to generate one instead.
name	string	The service name, which is a DNS-like logical identifier for the service, such as calendar.googleapis.com. The service name typically goes through DNS verification to make sure the owner of the service also owns the DNS name.
apis	array	A list of API interfaces exported by this service. Only the name field of the google.protobuf.Api needs to be provided by the configuration author, as the remaining fields will be derived from the IDL during the normalization process. It is an error to specify an API interface here which cannot be resolved against the associated IDL files.
aspects	array	Configuration aspects. This is a repeated field to allow multiple aspects to be configured. The kind field in each ConfigAspect specifies the type of aspect. The spec field contains the configuration for that aspect. The schema for the spec field is defined by the backend service owners.
authentication	object	Auth configuration. (id: Authentication)
backend	object	API backend configuration. (id: Backend)
billing	object	Billing configuration. (id: Billing)
configVersion	integer (uint32)	Obsolete. Do not use. This field has no semantic meaning. The service config compiler always sets this field to 3.
context	object	Context configuration. (id: Context)
control	object	Configuration for the service control plane. (id: Control)
customError	object	Custom error configuration. (id: CustomError)
documentation	object	Additional API documentation. (id: Documentation)
endpoints	array	Configuration for network endpoints. If this is empty, then an endpoint with the same name as the service is automatically generated to service all defined APIs.
enums	array	A list of all enum types included in this API service. Enums referenced directly or indirectly by the apis are automatically included. Enums which are not referenced but shall be included should be listed here by name by the configuration author. Example: enums: - name: google.someapi.v1.SomeEnum
http	object	HTTP configuration. (id: Http)
logging	object	Logging configuration. (id: Logging)
logs	array	Defines the logs used by this service.
metrics	array	Defines the metrics used by this service.
monitoredResources	array	Defines the monitored resources used by this service. This is required by the Service.monitoring and Service.logging configurations.
monitoring	object	Monitoring configuration. (id: Monitoring)
producerProjectId	string	The Google project that owns this service.
publishing	object	Settings for Google Cloud Client libraries generated from APIs defined as protocol buffers. (id: Publishing)
quota	object	Quota configuration. (id: Quota)
sourceInfo	object	Output only. The source information for this configuration if available. (id: SourceInfo)
systemParameters	object	System parameter configuration. (id: SystemParameters)
systemTypes	array	A list of all proto message types included in this API service. It serves similar purpose as [google.api.Service.types], except that these types are not needed by user-defined APIs. Therefore, they will not show up in the generated discovery doc. This field should only be used to define system APIs in ESF.
title	string	The product title for this service, it is the name displayed in Google Cloud Console.
types	array	A list of all proto message types included in this API service. Types referenced directly or indirectly by the apis are automatically included. Messages which are not referenced but shall be included, such as types used by the google.protobuf.Any type, should be listed here by name by the configuration author. Example: types: - name: google.protobuf.Int32
usage	object	Configuration controlling usage of this service. (id: Usage)

list

Name	Datatype	Description
id	string	A unique ID for a specific instance of this message, typically assigned by the client for tracking purpose. Must be no longer than 63 characters and only lower case letters, digits, '.', '_' and '-' are allowed. If empty, the server may choose to generate one instead.
name	string	The service name, which is a DNS-like logical identifier for the service, such as calendar.googleapis.com. The service name typically goes through DNS verification to make sure the owner of the service also owns the DNS name.
apis	array	A list of API interfaces exported by this service. Only the name field of the google.protobuf.Api needs to be provided by the configuration author, as the remaining fields will be derived from the IDL during the normalization process. It is an error to specify an API interface here which cannot be resolved against the associated IDL files.
aspects	array	Configuration aspects. This is a repeated field to allow multiple aspects to be configured. The kind field in each ConfigAspect specifies the type of aspect. The spec field contains the configuration for that aspect. The schema for the spec field is defined by the backend service owners.
authentication	object	Auth configuration. (id: Authentication)
backend	object	API backend configuration. (id: Backend)
billing	object	Billing configuration. (id: Billing)
configVersion	integer (uint32)	Obsolete. Do not use. This field has no semantic meaning. The service config compiler always sets this field to 3.
context	object	Context configuration. (id: Context)
control	object	Configuration for the service control plane. (id: Control)
customError	object	Custom error configuration. (id: CustomError)
documentation	object	Additional API documentation. (id: Documentation)
endpoints	array	Configuration for network endpoints. If this is empty, then an endpoint with the same name as the service is automatically generated to service all defined APIs.
enums	array	A list of all enum types included in this API service. Enums referenced directly or indirectly by the apis are automatically included. Enums which are not referenced but shall be included should be listed here by name by the configuration author. Example: enums: - name: google.someapi.v1.SomeEnum
http	object	HTTP configuration. (id: Http)
logging	object	Logging configuration. (id: Logging)
logs	array	Defines the logs used by this service.
metrics	array	Defines the metrics used by this service.
monitoredResources	array	Defines the monitored resources used by this service. This is required by the Service.monitoring and Service.logging configurations.
monitoring	object	Monitoring configuration. (id: Monitoring)
producerProjectId	string	The Google project that owns this service.
publishing	object	Settings for Google Cloud Client libraries generated from APIs defined as protocol buffers. (id: Publishing)
quota	object	Quota configuration. (id: Quota)
sourceInfo	object	Output only. The source information for this configuration if available. (id: SourceInfo)
systemParameters	object	System parameter configuration. (id: SystemParameters)
systemTypes	array	A list of all proto message types included in this API service. It serves similar purpose as [google.api.Service.types], except that these types are not needed by user-defined APIs. Therefore, they will not show up in the generated discovery doc. This field should only be used to define system APIs in ESF.
title	string	The product title for this service, it is the name displayed in Google Cloud Console.
types	array	A list of all proto message types included in this API service. Types referenced directly or indirectly by the apis are automatically included. Messages which are not referenced but shall be included, such as types used by the google.protobuf.Any type, should be listed here by name by the configuration author. Example: types: - name: google.protobuf.Int32
usage	object	Configuration controlling usage of this service. (id: Usage)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	serviceName, configId	view	Gets a service configuration (version) for a managed service.
list	select	serviceName	pageSize, pageToken	Lists the history of the service configuration for a managed service, from the newest to the oldest.
create	insert	serviceName		Creates a new service configuration (version) for a managed service. This method only stores the service configuration. To roll out the service configuration to backend systems please call CreateServiceRollout. Only the 100 most recent service configurations and ones referenced by existing rollouts are kept for each service. The rest will be deleted eventually.
submit	exec	serviceName		Creates a new service configuration (version) for a managed service based on user-supplied configuration source files (for example: OpenAPI Specification). This method stores the source configurations as well as the generated service configuration. To rollout the service configuration to other services, please call CreateServiceRollout. Only the 100 most recent configuration sources and ones referenced by existing service configurtions are kept for each service. The rest will be deleted eventually. Operation

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
configId	string
serviceName	string
pageSize	integer (int32)
pageToken	string
view	string

SELECT examples

get

Gets a service configuration (version) for a managed service.

SELECT
id,
name,
apis,
aspects,
authentication,
backend,
billing,
configVersion,
context,
control,
customError,
documentation,
endpoints,
enums,
http,
logging,
logs,
metrics,
monitoredResources,
monitoring,
producerProjectId,
publishing,
quota,
sourceInfo,
systemParameters,
systemTypes,
title,
types,
usage
FROM google.servicemanagement.configs
WHERE serviceName = '{{ serviceName }}' -- required
AND configId = '{{ configId }}' -- required
AND view = '{{ view }}'
;

list

Lists the history of the service configuration for a managed service, from the newest to the oldest.

SELECT
id,
name,
apis,
aspects,
authentication,
backend,
billing,
configVersion,
context,
control,
customError,
documentation,
endpoints,
enums,
http,
logging,
logs,
metrics,
monitoredResources,
monitoring,
producerProjectId,
publishing,
quota,
sourceInfo,
systemParameters,
systemTypes,
title,
types,
usage
FROM google.servicemanagement.configs
WHERE serviceName = '{{ serviceName }}' -- required
AND pageSize = '{{ pageSize }}'
AND pageToken = '{{ pageToken }}'
;

INSERT examples

create

Creates a new service configuration (version) for a managed service. This method only stores the service configuration. To roll out the service configuration to backend systems please call CreateServiceRollout. Only the 100 most recent service configurations and ones referenced by existing rollouts are kept for each service. The rest will be deleted eventually.

INSERT INTO google.servicemanagement.configs (
data__apis,
data__aspects,
data__authentication,
data__backend,
data__billing,
data__configVersion,
data__context,
data__control,
data__customError,
data__documentation,
data__endpoints,
data__enums,
data__http,
data__id,
data__logging,
data__logs,
data__metrics,
data__monitoredResources,
data__monitoring,
data__name,
data__producerProjectId,
data__publishing,
data__quota,
data__sourceInfo,
data__systemParameters,
data__systemTypes,
data__title,
data__types,
data__usage,
serviceName
)
SELECT 
'{{ apis }}',
'{{ aspects }}',
'{{ authentication }}',
'{{ backend }}',
'{{ billing }}',
{{ configVersion }},
'{{ context }}',
'{{ control }}',
'{{ customError }}',
'{{ documentation }}',
'{{ endpoints }}',
'{{ enums }}',
'{{ http }}',
'{{ id }}',
'{{ logging }}',
'{{ logs }}',
'{{ metrics }}',
'{{ monitoredResources }}',
'{{ monitoring }}',
'{{ name }}',
'{{ producerProjectId }}',
'{{ publishing }}',
'{{ quota }}',
'{{ sourceInfo }}',
'{{ systemParameters }}',
'{{ systemTypes }}',
'{{ title }}',
'{{ types }}',
'{{ usage }}',
'{{ serviceName }}'
RETURNING
id,
name,
apis,
aspects,
authentication,
backend,
billing,
configVersion,
context,
control,
customError,
documentation,
endpoints,
enums,
http,
logging,
logs,
metrics,
monitoredResources,
monitoring,
producerProjectId,
publishing,
quota,
sourceInfo,
systemParameters,
systemTypes,
title,
types,
usage
;

Manifest

# Description fields are for documentation purposes
- name: configs
props:
  - name: serviceName
    value: "{{ serviceName }}"
    description: Required parameter for the configs resource.
  - name: apis
    description: |
      A list of API interfaces exported by this service. Only the `name` field of the google.protobuf.Api needs to be provided by the configuration author, as the remaining fields will be derived from the IDL during the normalization process. It is an error to specify an API interface here which cannot be resolved against the associated IDL files.
    value:
      - edition: "{{ edition }}"
        methods: "{{ methods }}"
        mixins: "{{ mixins }}"
        name: "{{ name }}"
        options: "{{ options }}"
        sourceContext:
          fileName: "{{ fileName }}"
        syntax: "{{ syntax }}"
        version: "{{ version }}"
  - name: aspects
    description: |
      Configuration aspects. This is a repeated field to allow multiple aspects to be configured. The kind field in each ConfigAspect specifies the type of aspect. The spec field contains the configuration for that aspect. The schema for the spec field is defined by the backend service owners.
    value:
      - kind: "{{ kind }}"
        rules: "{{ rules }}"
        spec: "{{ spec }}"
  - name: authentication
    description: |
      Auth configuration.
    value:
      providers:
        - audiences: "{{ audiences }}"
          authorizationUrl: "{{ authorizationUrl }}"
          id: "{{ id }}"
          issuer: "{{ issuer }}"
          jwksUri: "{{ jwksUri }}"
          jwtLocations: "{{ jwtLocations }}"
      rules:
        - allowWithoutCredential: {{ allowWithoutCredential }}
          oauth:
            canonicalScopes: "{{ canonicalScopes }}"
          requirements: "{{ requirements }}"
          selector: "{{ selector }}"
  - name: backend
    description: |
      API backend configuration.
    value:
      rules:
        - address: "{{ address }}"
          deadline: {{ deadline }}
          disableAuth: {{ disableAuth }}
          jwtAudience: "{{ jwtAudience }}"
          loadBalancingPolicy: "{{ loadBalancingPolicy }}"
          minDeadline: {{ minDeadline }}
          operationDeadline: {{ operationDeadline }}
          overridesByRequestProtocol: "{{ overridesByRequestProtocol }}"
          pathTranslation: "{{ pathTranslation }}"
          protocol: "{{ protocol }}"
          selector: "{{ selector }}"
  - name: billing
    description: |
      Billing configuration.
    value:
      consumerDestinations:
        - metrics: "{{ metrics }}"
          monitoredResource: "{{ monitoredResource }}"
  - name: configVersion
    value: {{ configVersion }}
    description: |
      Obsolete. Do not use. This field has no semantic meaning. The service config compiler always sets this field to `3`.
  - name: context
    description: |
      Context configuration.
    value:
      rules:
        - allowedRequestExtensions: "{{ allowedRequestExtensions }}"
          allowedResponseExtensions: "{{ allowedResponseExtensions }}"
          provided: "{{ provided }}"
          requested: "{{ requested }}"
          selector: "{{ selector }}"
  - name: control
    description: |
      Configuration for the service control plane.
    value:
      environment: "{{ environment }}"
      methodPolicies:
        - requestPolicies: "{{ requestPolicies }}"
          selector: "{{ selector }}"
  - name: customError
    description: |
      Custom error configuration.
    value:
      rules:
        - isErrorType: {{ isErrorType }}
          selector: "{{ selector }}"
      types:
        - "{{ types }}"
  - name: documentation
    description: |
      Additional API documentation.
    value:
      additionalIamInfo: "{{ additionalIamInfo }}"
      documentationRootUrl: "{{ documentationRootUrl }}"
      overview: "{{ overview }}"
      pages:
        - content: "{{ content }}"
          name: "{{ name }}"
          subpages: "{{ subpages }}"
      rules:
        - deprecationDescription: "{{ deprecationDescription }}"
          description: "{{ description }}"
          disableReplacementWords: "{{ disableReplacementWords }}"
          selector: "{{ selector }}"
      sectionOverrides:
        - content: "{{ content }}"
          name: "{{ name }}"
          subpages: "{{ subpages }}"
      serviceRootUrl: "{{ serviceRootUrl }}"
      summary: "{{ summary }}"
  - name: endpoints
    description: |
      Configuration for network endpoints. If this is empty, then an endpoint with the same name as the service is automatically generated to service all defined APIs.
    value:
      - aliases: "{{ aliases }}"
        allowCors: {{ allowCors }}
        name: "{{ name }}"
        target: "{{ target }}"
  - name: enums
    description: |
      A list of all enum types included in this API service. Enums referenced directly or indirectly by the `apis` are automatically included. Enums which are not referenced but shall be included should be listed here by name by the configuration author. Example: enums: - name: google.someapi.v1.SomeEnum
    value:
      - edition: "{{ edition }}"
        enumvalue: "{{ enumvalue }}"
        name: "{{ name }}"
        options: "{{ options }}"
        sourceContext:
          fileName: "{{ fileName }}"
        syntax: "{{ syntax }}"
  - name: http
    description: |
      HTTP configuration.
    value:
      fullyDecodeReservedExpansion: {{ fullyDecodeReservedExpansion }}
      rules:
        - additionalBindings: "{{ additionalBindings }}"
          body: "{{ body }}"
          custom:
            kind: "{{ kind }}"
            path: "{{ path }}"
          delete: "{{ delete }}"
          get: "{{ get }}"
          patch: "{{ patch }}"
          post: "{{ post }}"
          put: "{{ put }}"
          responseBody: "{{ responseBody }}"
          selector: "{{ selector }}"
  - name: id
    value: "{{ id }}"
    description: |
      A unique ID for a specific instance of this message, typically assigned by the client for tracking purpose. Must be no longer than 63 characters and only lower case letters, digits, '.', '_' and '-' are allowed. If empty, the server may choose to generate one instead.
  - name: logging
    description: |
      Logging configuration.
    value:
      consumerDestinations:
        - logs: "{{ logs }}"
          monitoredResource: "{{ monitoredResource }}"
      producerDestinations:
        - logs: "{{ logs }}"
          monitoredResource: "{{ monitoredResource }}"
  - name: logs
    description: |
      Defines the logs used by this service.
    value:
      - description: "{{ description }}"
        displayName: "{{ displayName }}"
        labels: "{{ labels }}"
        name: "{{ name }}"
  - name: metrics
    description: |
      Defines the metrics used by this service.
    value:
      - description: "{{ description }}"
        displayName: "{{ displayName }}"
        labels: "{{ labels }}"
        launchStage: "{{ launchStage }}"
        metadata:
          ingestDelay: "{{ ingestDelay }}"
          launchStage: "{{ launchStage }}"
          samplePeriod: "{{ samplePeriod }}"
          timeSeriesResourceHierarchyLevel:
            - "{{ timeSeriesResourceHierarchyLevel }}"
        metricKind: "{{ metricKind }}"
        monitoredResourceTypes: "{{ monitoredResourceTypes }}"
        name: "{{ name }}"
        type: "{{ type }}"
        unit: "{{ unit }}"
        valueType: "{{ valueType }}"
  - name: monitoredResources
    description: |
      Defines the monitored resources used by this service. This is required by the `Service.monitoring` and `Service.logging` configurations.
    value:
      - description: "{{ description }}"
        displayName: "{{ displayName }}"
        labels: "{{ labels }}"
        launchStage: "{{ launchStage }}"
        name: "{{ name }}"
        type: "{{ type }}"
  - name: monitoring
    description: |
      Monitoring configuration.
    value:
      consumerDestinations:
        - metrics: "{{ metrics }}"
          monitoredResource: "{{ monitoredResource }}"
      producerDestinations:
        - metrics: "{{ metrics }}"
          monitoredResource: "{{ monitoredResource }}"
  - name: name
    value: "{{ name }}"
    description: |
      The service name, which is a DNS-like logical identifier for the service, such as `calendar.googleapis.com`. The service name typically goes through DNS verification to make sure the owner of the service also owns the DNS name.
  - name: producerProjectId
    value: "{{ producerProjectId }}"
    description: |
      The Google project that owns this service.
  - name: publishing
    description: |
      Settings for [Google Cloud Client libraries](https://cloud.google.com/apis/docs/cloud-client-libraries) generated from APIs defined as protocol buffers.
    value:
      apiShortName: "{{ apiShortName }}"
      codeownerGithubTeams:
        - "{{ codeownerGithubTeams }}"
      docTagPrefix: "{{ docTagPrefix }}"
      documentationUri: "{{ documentationUri }}"
      githubLabel: "{{ githubLabel }}"
      librarySettings:
        - cppSettings:
            common:
              destinations:
                - "{{ destinations }}"
              referenceDocsUri: "{{ referenceDocsUri }}"
              selectiveGapicGeneration:
                generateOmittedAsInternal: {{ generateOmittedAsInternal }}
                methods: "{{ methods }}"
          dotnetSettings:
            common:
              destinations:
                - "{{ destinations }}"
              referenceDocsUri: "{{ referenceDocsUri }}"
              selectiveGapicGeneration:
                generateOmittedAsInternal: {{ generateOmittedAsInternal }}
                methods: "{{ methods }}"
            forcedNamespaceAliases:
              - "{{ forcedNamespaceAliases }}"
            handwrittenSignatures:
              - "{{ handwrittenSignatures }}"
            ignoredResources:
              - "{{ ignoredResources }}"
            renamedResources: "{{ renamedResources }}"
            renamedServices: "{{ renamedServices }}"
          goSettings:
            common:
              destinations:
                - "{{ destinations }}"
              referenceDocsUri: "{{ referenceDocsUri }}"
              selectiveGapicGeneration:
                generateOmittedAsInternal: {{ generateOmittedAsInternal }}
                methods: "{{ methods }}"
            renamedServices: "{{ renamedServices }}"
          javaSettings:
            common:
              destinations:
                - "{{ destinations }}"
              referenceDocsUri: "{{ referenceDocsUri }}"
              selectiveGapicGeneration:
                generateOmittedAsInternal: {{ generateOmittedAsInternal }}
                methods: "{{ methods }}"
            libraryPackage: "{{ libraryPackage }}"
            serviceClassNames: "{{ serviceClassNames }}"
          launchStage: "{{ launchStage }}"
          nodeSettings:
            common:
              destinations:
                - "{{ destinations }}"
              referenceDocsUri: "{{ referenceDocsUri }}"
              selectiveGapicGeneration:
                generateOmittedAsInternal: {{ generateOmittedAsInternal }}
                methods: "{{ methods }}"
          phpSettings:
            common:
              destinations:
                - "{{ destinations }}"
              referenceDocsUri: "{{ referenceDocsUri }}"
              selectiveGapicGeneration:
                generateOmittedAsInternal: {{ generateOmittedAsInternal }}
                methods: "{{ methods }}"
            libraryPackage: "{{ libraryPackage }}"
          pythonSettings:
            common:
              destinations:
                - "{{ destinations }}"
              referenceDocsUri: "{{ referenceDocsUri }}"
              selectiveGapicGeneration:
                generateOmittedAsInternal: {{ generateOmittedAsInternal }}
                methods: "{{ methods }}"
            experimentalFeatures:
              protobufPythonicTypesEnabled: {{ protobufPythonicTypesEnabled }}
              restAsyncIoEnabled: {{ restAsyncIoEnabled }}
              unversionedPackageDisabled: {{ unversionedPackageDisabled }}
          restNumericEnums: {{ restNumericEnums }}
          rubySettings:
            common:
              destinations:
                - "{{ destinations }}"
              referenceDocsUri: "{{ referenceDocsUri }}"
              selectiveGapicGeneration:
                generateOmittedAsInternal: {{ generateOmittedAsInternal }}
                methods: "{{ methods }}"
          version: "{{ version }}"
      methodSettings:
        - autoPopulatedFields: "{{ autoPopulatedFields }}"
          batching:
            batchDescriptor:
              batchedField: "{{ batchedField }}"
              discriminatorFields:
                - "{{ discriminatorFields }}"
              subresponseField: "{{ subresponseField }}"
            thresholds:
              delayThreshold: "{{ delayThreshold }}"
              elementCountLimit: {{ elementCountLimit }}
              elementCountThreshold: {{ elementCountThreshold }}
              flowControlByteLimit: {{ flowControlByteLimit }}
              flowControlElementLimit: {{ flowControlElementLimit }}
              flowControlLimitExceededBehavior: "{{ flowControlLimitExceededBehavior }}"
              requestByteLimit: {{ requestByteLimit }}
              requestByteThreshold: "{{ requestByteThreshold }}"
          longRunning:
            initialPollDelay: "{{ initialPollDelay }}"
            maxPollDelay: "{{ maxPollDelay }}"
            pollDelayMultiplier: {{ pollDelayMultiplier }}
            totalPollTimeout: "{{ totalPollTimeout }}"
          selector: "{{ selector }}"
      newIssueUri: "{{ newIssueUri }}"
      organization: "{{ organization }}"
      protoReferenceDocumentationUri: "{{ protoReferenceDocumentationUri }}"
      restReferenceDocumentationUri: "{{ restReferenceDocumentationUri }}"
  - name: quota
    description: |
      Quota configuration.
    value:
      limits:
        - defaultLimit: "{{ defaultLimit }}"
          description: "{{ description }}"
          displayName: "{{ displayName }}"
          duration: "{{ duration }}"
          freeTier: "{{ freeTier }}"
          maxLimit: "{{ maxLimit }}"
          metric: "{{ metric }}"
          name: "{{ name }}"
          trafficSource: "{{ trafficSource }}"
          unit: "{{ unit }}"
          values: "{{ values }}"
      metricRules:
        - agenticMetricCosts: "{{ agenticMetricCosts }}"
          metricCosts: "{{ metricCosts }}"
          nonagenticMetricCosts: "{{ nonagenticMetricCosts }}"
          selector: "{{ selector }}"
  - name: sourceInfo
    description: |
      Output only. The source information for this configuration if available.
    value:
      sourceFiles: "{{ sourceFiles }}"
  - name: systemParameters
    description: |
      System parameter configuration.
    value:
      rules:
        - parameters: "{{ parameters }}"
          selector: "{{ selector }}"
  - name: systemTypes
    description: |
      A list of all proto message types included in this API service. It serves similar purpose as [google.api.Service.types], except that these types are not needed by user-defined APIs. Therefore, they will not show up in the generated discovery doc. This field should only be used to define system APIs in ESF.
    value:
      - edition: "{{ edition }}"
        fields: "{{ fields }}"
        name: "{{ name }}"
        oneofs: "{{ oneofs }}"
        options: "{{ options }}"
        sourceContext:
          fileName: "{{ fileName }}"
        syntax: "{{ syntax }}"
  - name: title
    value: "{{ title }}"
    description: |
      The product title for this service, it is the name displayed in Google Cloud Console.
  - name: types
    description: |
      A list of all proto message types included in this API service. Types referenced directly or indirectly by the `apis` are automatically included. Messages which are not referenced but shall be included, such as types used by the `google.protobuf.Any` type, should be listed here by name by the configuration author. Example: types: - name: google.protobuf.Int32
    value:
      - edition: "{{ edition }}"
        fields: "{{ fields }}"
        name: "{{ name }}"
        oneofs: "{{ oneofs }}"
        options: "{{ options }}"
        sourceContext:
          fileName: "{{ fileName }}"
        syntax: "{{ syntax }}"
  - name: usage
    description: |
      Configuration controlling usage of this service.
    value:
      producerNotificationChannel: "{{ producerNotificationChannel }}"
      requirements:
        - "{{ requirements }}"
      rules:
        - allowUnregisteredCalls: {{ allowUnregisteredCalls }}
          selector: "{{ selector }}"
          skipServiceControl: {{ skipServiceControl }}

Lifecycle Methods

submit

Creates a new service configuration (version) for a managed service based on user-supplied configuration source files (for example: OpenAPI Specification). This method stores the source configurations as well as the generated service configuration. To rollout the service configuration to other services, please call CreateServiceRollout. Only the 100 most recent configuration sources and ones referenced by existing service configurtions are kept for each service. The rest will be deleted eventually. Operation

EXEC google.servicemanagement.configs.submit 
@serviceName='{{ serviceName }}' --required 
@@json=
'{
"configSource": "{{ configSource }}", 
"validateOnly": {{ validateOnly }}
}'
;