Skip to main content
← back to extensions

@swamp/gcp/servicemanagement

v2026.04.23.1

Google Cloud servicemanagement infrastructure models

Repository

https://github.com/systeminit/swamp-extensions

Platforms

linux-x86_64linux-aarch64darwin-x86_64darwin-aarch64

Labels

gcpgoogle-cloudservicemanagementcloudinfrastructure

Contents

models

Quality score

Verified by Swamp

How well-documented and verifiable this extension is.

100%

Grade A

  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types1/1earned
  • Has description1/1earned
  • At least one platform tag (or universal)1/1earned
  • Two or more platform tags (or universal)1/1earned
  • License declared1/1earned
  • Verified public repository2/2earned

Install

$ swamp extension pull @swamp/gcp/servicemanagement

services_configs.tsv2026.04.23.1

Global Arguments

ArgumentTypeDescription
apis?arrayThe source edition string, only valid when syntax is SYNTAX_EDITIONS.
aspects?arrayThe type of this aspect configuration.
authentication?objectThe list of JWT [audiences](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#section-4.1.3). that are allowed to access. A JWT containing any of these audiences will be accepted. When this setting is absent, JWTs with audiences: - "https://[service.name]/[google.protobuf.Api.name]" - "https://[service.name]/" will be accepted. For example, if no audiences are in the setting, LibraryService API will accept JWTs with the following audiences: - https://library-example.googleapis.com/google.example.library.v1.LibraryService - https://library-example.googleapis.com/ Example: audiences: bookstore_android.apps.googleusercontent.com, bookstore_web.apps.googleusercontent.com
backend?objectThe address of the API backend. The scheme is used to determine the backend protocol and security. The following schemes are accepted: SCHEME PROTOCOL SECURITY http:// HTTP None https:// HTTP TLS grpc:// gRPC None grpcs:// gRPC TLS It is recommended to explicitly include a scheme. Leaving out the scheme may cause constrasting behaviors across platforms. If the port is unspecified, the default is: - 80 for schemes without TLS - 443 for schemes with TLS For HTTP backends, use protocol to specify the protocol version.
billing?objectNames of the metrics to report to this billing destination. Each name must be defined in Service.metrics section.
configVersion?numberObsolete. Do not use. This field has no semantic meaning. The service config compiler always sets this field to `3`.
context?objectA list of full type names or extension IDs of extensions allowed in grpc side channel from client to backend.
control?objectThe service controller environment to use. If empty, no control plane features (like quota and billing) will be enabled. The recommended value for most services is servicecontrol.googleapis.com.
customError?objectMark this message as possible payload in error response. Otherwise, objects of this type will be filtered when they appear in error payload.
documentation?objectOptional information about the IAM configuration. This is typically used to link to documentation about a product's IAM roles and permissions.
endpoints?arrayAliases for this endpoint, these will be served by the same UrlMap as the parent endpoint, and will be provisioned in the GCP stack for the Regional Endpoints.
enums?arrayThe source edition string, only valid when syntax is SYNTAX_EDITIONS.
http?objectWhen set to true, URL path parameters will be fully URI-decoded except in cases of single segment matches in reserved expansion, where "%2F" will be left encoded. The default behavior is to not decode RFC 6570 reserved characters in multi segment matches.
id?stringA 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.
logging?objectNames of the logs to be sent to this destination. Each name must be defined in the Service.logs section. If the log name is not a domain scoped name, it will be automatically prefixed with the service name followed by "/".
logs?arrayA human-readable description of this log. This information appears in the documentation and can contain details.
metrics?arrayA detailed description of the metric, which can be used in documentation.
monitoredResources?arrayOptional. A detailed description of the monitored resource type that might be used in documentation.
monitoring?objectTypes of the metrics to report to this monitoring destination. Each type must be defined in Service.metrics section.
name?stringThe 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.
producerProjectId?stringThe Google project that owns this service.
publishing?objectUsed as a tracking tag when collecting data about the APIs developer relations artifacts like docs, packages delivered to package managers, etc. Example: "speech".
quota?objectDefault number of tokens that can be consumed during the specified duration. This is the number of tokens assigned when a client application developer activates the service for his/her project. Specifying a value of 0 will block all requests. This can be used if you are provisioning quota to selected consumers and blocking others. Similarly, a value of -1 will indicate an unlimited quota. No other negative values are allowed. Used by group-based quotas only.
sourceInfo?objectAll files used during config generation.
systemParameters?objectDefine the HTTP header name to use for the parameter. It is case insensitive.
systemTypes?arrayThe source edition string, only valid when syntax is SYNTAX_EDITIONS.
title?stringThe product title for this service, it is the name displayed in Google Cloud Console.
types?arrayThe source edition string, only valid when syntax is SYNTAX_EDITIONS.
usage?objectThe full resource name of a channel used for sending notifications to the service producer. Google Service Management currently only supports [Google Cloud Pub/Sub](https://cloud.google.com/pubsub) as a notification channel. To use Google Cloud Pub/Sub as the channel, this must be the name of a Cloud Pub/Sub topic that uses the Cloud Pub/Sub topic name format documented in https://cloud.google.com/pubsub/docs/overview.
serviceNamestringRequired. The name of the service. See the [overview](https://cloud.google.com/service-management/overview) for naming requirements. For example: `example.googleapis.com`.
createCreate a configs
getGet a configs
ArgumentTypeDescription
identifierstringThe name of the configs
syncSync configs state from GCP
submitsubmit
ArgumentTypeDescription
configSource?any
validateOnly?any
services_rollouts.tsv2026.04.23.1

Global Arguments

ArgumentTypeDescription
namestringInstance name for this resource (used as the unique identifier in the factory pattern)
createTime?stringCreation time of the rollout. Readonly.
createdBy?stringThe user who created the Rollout. Readonly.
deleteServiceStrategy?objectStrategy used to delete a service. This strategy is a placeholder only used by the system generated rollout to delete a service.
rolloutId?stringOptional. Unique identifier of this Rollout. Must be no longer than 63 characters and only lower case letters, digits, '.', '_' and '-' are allowed. If not specified by client, the server will generate one. The generated id will have the form of, where \"date\" is the create date in ISO 8601 format. \"revision number\" is a monotonically increasing positive number that is reset every day for each service. An example of the generated rollout_id is '2016-02-16r1'
serviceName?stringThe name of the service associated with this Rollout.
status?enumThe status of this rollout. Readonly. In case of a failed rollout, the system will automatically rollback to the current Rollout version. Readonly.
trafficPercentStrategy?objectMaps service configuration IDs to their corresponding traffic percentage. Key is the service configuration ID, Value is the traffic percentage which must be greater than 0.0 and the sum must equal to 100.0.
createCreate a rollouts
getGet a rollouts
ArgumentTypeDescription
identifierstringThe name of the rollouts
syncSync rollouts state from GCP
services.tsv2026.04.23.1

Global Arguments

ArgumentTypeDescription
namestringInstance name for this resource (used as the unique identifier in the factory pattern)
producerProjectId?stringID of the project that produces and owns this service.
serviceName?stringThe name of the service. See the [overview](https://cloud.google.com/service-infrastructure/docs/overview) for naming requirements.
createCreate a services
getGet a services
ArgumentTypeDescription
identifierstringThe name of the services
deleteDelete the services
ArgumentTypeDescription
identifierstringThe name of the services
syncSync services state from GCP
generate_config_reportgenerate config report
ArgumentTypeDescription
newConfig?any
oldConfig?any
get_configget config
undeleteundelete