rollouts

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

Overview

Name	rollouts
Type	Resource
Id	google.servicemanagement.rollouts

Fields

Name	Datatype	Description
createTime	string	Creation time of the rollout. Readonly.
createdBy	string	The user who created the Rollout. Readonly.
deleteServiceStrategy	object	Strategy used to delete a service. This strategy is a placeholder only used by the system generated rollout to delete a service.
rolloutId	string	Optional. 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	string	The name of the service associated with this Rollout.
status	string	The status of this rollout. Readonly. In case of a failed rollout, the system will automatically rollback to the current Rollout version. Readonly.
trafficPercentStrategy	object	Strategy that specifies how clients of Google Service Controller want to send traffic to use different config versions. This is generally used by API proxy to split traffic based on your configured percentage for each config version. One example of how to gradually rollout a new service configuration using this strategy: Day 1 Rollout { id: "example.googleapis.com/rollout_20160206" traffic_percent_strategy { percentages: { "example.googleapis.com/20160201": 70.00 "example.googleapis.com/20160206": 30.00 } } } Day 2 Rollout { id: "example.googleapis.com/rollout_20160207" traffic_percent_strategy: { percentages: { "example.googleapis.com/20160206": 100.00 } } }

Methods

Name	Accessible by	Required Params	Description
get	SELECT	rolloutId, serviceName	Gets a service configuration rollout.
list	SELECT	serviceName	Lists the history of the service configuration rollouts for a managed service, from the newest to the oldest.
create	INSERT	serviceName	Creates a new service configuration rollout. Based on rollout, the Google Service Management will roll out the service configurations to different backend services. For example, the logging configuration will be pushed to Google Cloud Logging. Please note that any previous pending and running Rollouts and associated Operations will be automatically cancelled so that the latest Rollout will not be blocked by previous Rollouts. Only the 100 most recent (in any state) and the last 10 successful (if not already part of the set of 100 most recent) rollouts are kept for each service. The rest will be deleted eventually. Operation

SELECT examples

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

SELECT
createTime,
createdBy,
deleteServiceStrategy,
rolloutId,
serviceName,
status,
trafficPercentStrategy
FROM google.servicemanagement.rollouts
WHERE serviceName = '{{ serviceName }}';

INSERT example

Use the following StackQL query and manifest file to create a new rollouts resource.

All Properties

/*+ create */
INSERT INTO google.servicemanagement.rollouts (
serviceName,
rolloutId,
createdBy,
status,
trafficPercentStrategy,
deleteServiceStrategy,
serviceName
)
SELECT 
'{{ serviceName }}',
'{{ rolloutId }}',
'{{ createdBy }}',
'{{ status }}',
'{{ trafficPercentStrategy }}',
'{{ deleteServiceStrategy }}',
'{{ serviceName }}'
;

Manifest

- name: your_resource_model_name
  props:
    - name: rolloutId
      value: string
    - name: createTime
      value: string
    - name: createdBy
      value: string
    - name: status
      value: string
    - name: trafficPercentStrategy
      value:
        - name: percentages
          value: object
    - name: deleteServiceStrategy
      value: []
    - name: serviceName
      value: string