Docs Home Pulumi IaC Pulumi ESC Pulumi Cloud Packages Tutorials
  1. Packages
  2. Google Cloud Native
  3. API Docs
  4. servicemanagement
  5. servicemanagement/v1
  6. Rollout

Google Cloud Native is in preview. Google Cloud Classic is fully supported.

Google Cloud Native v0.32.0 published on Wednesday, Nov 29, 2023 by Pulumi
pulumi/pulumi-google-native

google-native.servicemanagement/v1.Rollout

Explore with Pulumi AI

google-native logo

Google Cloud Native is in preview. Google Cloud Classic is fully supported.

Google Cloud Native v0.32.0 published on Wednesday, Nov 29, 2023 by Pulumi
pulumi/pulumi-google-native

    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 Auto-naming is currently not supported for this resource. Note - this resource’s API doesn’t support deletion. When deleted, the resource will persist on Google Cloud even though it will be deleted from Pulumi state.

    Create Rollout Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new Rollout(name: string, args: RolloutArgs, opts?: CustomResourceOptions);
    @overload
def Rollout(resource_name: str,
            args: RolloutArgs,
            opts: Optional[ResourceOptions] = None)

@overload
def Rollout(resource_name: str,
            opts: Optional[ResourceOptions] = None,
            service_name: Optional[str] = None,
            create_time: Optional[str] = None,
            created_by: Optional[str] = None,
            delete_service_strategy: Optional[DeleteServiceStrategyArgs] = None,
            rollout_id: Optional[str] = None,
            traffic_percent_strategy: Optional[TrafficPercentStrategyArgs] = None)
    func NewRollout(ctx *Context, name string, args RolloutArgs, opts ...ResourceOption) (*Rollout, error)
    public Rollout(string name, RolloutArgs args, CustomResourceOptions? opts = null)
    public Rollout(String name, RolloutArgs args)
public Rollout(String name, RolloutArgs args, CustomResourceOptions options)

    type: google-native:servicemanagement/v1:Rollout
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

    Parameters

    name string
    The unique name of the resource.
    args RolloutArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args RolloutArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args RolloutArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args RolloutArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args RolloutArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var google_nativeRolloutResource = new GoogleNative.ServiceManagement.V1.Rollout("google-nativeRolloutResource", new()
{
    ServiceName = "string",
    CreateTime = "string",
    CreatedBy = "string",
    DeleteServiceStrategy = null,
    RolloutId = "string",
    TrafficPercentStrategy = new GoogleNative.ServiceManagement.V1.Inputs.TrafficPercentStrategyArgs
    {
        Percentages = 
        {
            { "string", "string" },
        },
    },
});

    example, err := servicemanagement.NewRollout(ctx, "google-nativeRolloutResource", &servicemanagement.RolloutArgs{
	ServiceName:           pulumi.String("string"),
	CreateTime:            pulumi.String("string"),
	CreatedBy:             pulumi.String("string"),
	DeleteServiceStrategy: &servicemanagement.DeleteServiceStrategyArgs{},
	RolloutId:             pulumi.String("string"),
	TrafficPercentStrategy: &servicemanagement.TrafficPercentStrategyArgs{
		Percentages: pulumi.StringMap{
			"string": pulumi.String("string"),
		},
	},
})

    var google_nativeRolloutResource = new Rollout("google-nativeRolloutResource", RolloutArgs.builder()
    .serviceName("string")
    .createTime("string")
    .createdBy("string")
    .deleteServiceStrategy()
    .rolloutId("string")
    .trafficPercentStrategy(TrafficPercentStrategyArgs.builder()
        .percentages(Map.of("string", "string"))
        .build())
    .build());

    google_native_rollout_resource = google_native.servicemanagement.v1.Rollout("google-nativeRolloutResource",
    service_name="string",
    create_time="string",
    created_by="string",
    delete_service_strategy={},
    rollout_id="string",
    traffic_percent_strategy={
        "percentages": {
            "string": "string",
        },
    })

    const google_nativeRolloutResource = new google_native.servicemanagement.v1.Rollout("google-nativeRolloutResource", {
    serviceName: "string",
    createTime: "string",
    createdBy: "string",
    deleteServiceStrategy: {},
    rolloutId: "string",
    trafficPercentStrategy: {
        percentages: {
            string: "string",
        },
    },
});

    type: google-native:servicemanagement/v1:Rollout
properties:
    createTime: string
    createdBy: string
    deleteServiceStrategy: {}
    rolloutId: string
    serviceName: string
    trafficPercentStrategy:
        percentages:
            string: string

    Rollout Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The Rollout resource accepts the following input properties:

    ServiceName string
    The name of the service associated with this Rollout.
    CreateTime string
    Creation time of the rollout. Readonly.
    CreatedBy string
    The user who created the Rollout. Readonly.
    DeleteServiceStrategy Pulumi.GoogleNative.ServiceManagement.V1.Inputs.DeleteServiceStrategy
    The strategy associated with a rollout to delete a ManagedService. Readonly.
    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'
    TrafficPercentStrategy Pulumi.GoogleNative.ServiceManagement.V1.Inputs.TrafficPercentStrategy
    Google Service Control selects service configurations based on traffic percentage.
    ServiceName string
    The name of the service associated with this Rollout.
    CreateTime string
    Creation time of the rollout. Readonly.
    CreatedBy string
    The user who created the Rollout. Readonly.
    DeleteServiceStrategy DeleteServiceStrategyArgs
    The strategy associated with a rollout to delete a ManagedService. Readonly.
    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'
    TrafficPercentStrategy TrafficPercentStrategyArgs
    Google Service Control selects service configurations based on traffic percentage.
    serviceName String
    The name of the service associated with this Rollout.
    createTime String
    Creation time of the rollout. Readonly.
    createdBy String
    The user who created the Rollout. Readonly.
    deleteServiceStrategy DeleteServiceStrategy
    The strategy associated with a rollout to delete a ManagedService. Readonly.
    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'
    trafficPercentStrategy TrafficPercentStrategy
    Google Service Control selects service configurations based on traffic percentage.
    serviceName string
    The name of the service associated with this Rollout.
    createTime string
    Creation time of the rollout. Readonly.
    createdBy string
    The user who created the Rollout. Readonly.
    deleteServiceStrategy DeleteServiceStrategy
    The strategy associated with a rollout to delete a ManagedService. Readonly.
    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'
    trafficPercentStrategy TrafficPercentStrategy
    Google Service Control selects service configurations based on traffic percentage.
    service_name str
    The name of the service associated with this Rollout.
    create_time str
    Creation time of the rollout. Readonly.
    created_by str
    The user who created the Rollout. Readonly.
    delete_service_strategy DeleteServiceStrategyArgs
    The strategy associated with a rollout to delete a ManagedService. Readonly.
    rollout_id str
    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'
    traffic_percent_strategy TrafficPercentStrategyArgs
    Google Service Control selects service configurations based on traffic percentage.
    serviceName String
    The name of the service associated with this Rollout.
    createTime String
    Creation time of the rollout. Readonly.
    createdBy String
    The user who created the Rollout. Readonly.
    deleteServiceStrategy Property Map
    The strategy associated with a rollout to delete a ManagedService. Readonly.
    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'
    trafficPercentStrategy Property Map
    Google Service Control selects service configurations based on traffic percentage.

    Outputs

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

    Id string
    The provider-assigned unique ID for this managed resource.
    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.
    Id string
    The provider-assigned unique ID for this managed resource.
    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.
    id String
    The provider-assigned unique ID for this managed resource.
    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.
    id string
    The provider-assigned unique ID for this managed resource.
    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.
    id str
    The provider-assigned unique ID for this managed resource.
    status str
    The status of this rollout. Readonly. In case of a failed rollout, the system will automatically rollback to the current Rollout version. Readonly.
    id String
    The provider-assigned unique ID for this managed resource.
    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.

    Supporting Types

    TrafficPercentStrategy, TrafficPercentStrategyArgs

    Percentages Dictionary<string, string>
    Maps 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.
    Percentages map[string]string
    Maps 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.
    percentages Map<String,String>
    Maps 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.
    percentages {[key: string]: string}
    Maps 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.
    percentages Mapping[str, str]
    Maps 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.
    percentages Map<String>
    Maps 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.

    TrafficPercentStrategyResponse, TrafficPercentStrategyResponseArgs

    Percentages Dictionary<string, string>
    Maps 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.
    Percentages map[string]string
    Maps 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.
    percentages Map<String,String>
    Maps 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.
    percentages {[key: string]: string}
    Maps 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.
    percentages Mapping[str, str]
    Maps 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.
    percentages Map<String>
    Maps 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.

    Package Details

    Repository
    Google Cloud Native pulumi/pulumi-google-native
    License
    Apache-2.0
    google-native logo

    Google Cloud Native is in preview. Google Cloud Classic is fully supported.

    Google Cloud Native v0.32.0 published on Wednesday, Nov 29, 2023 by Pulumi
    pulumi/pulumi-google-native