1. Packages
  2. Google Cloud (GCP) Classic
  3. API Docs
  4. vmwareengine
  5. getAnnouncements
Viewing docs for Google Cloud v9.15.0
published on Thursday, Mar 12, 2026 by Pulumi
gcp logo
Viewing docs for Google Cloud v9.15.0
published on Thursday, Mar 12, 2026 by Pulumi

    Use this data source to list announcements in a region.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as gcp from "@pulumi/gcp";
    
    const ds = gcp.vmwareengine.getAnnouncements({
        parent: "projects/my-project/locations/us-west1-a",
    });
    
    import pulumi
    import pulumi_gcp as gcp
    
    ds = gcp.vmwareengine.get_announcements(parent="projects/my-project/locations/us-west1-a")
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-gcp/sdk/v9/go/gcp/vmwareengine"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := vmwareengine.GetAnnouncements(ctx, &vmwareengine.GetAnnouncementsArgs{
    			Parent: "projects/my-project/locations/us-west1-a",
    		}, nil)
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Gcp = Pulumi.Gcp;
    
    return await Deployment.RunAsync(() => 
    {
        var ds = Gcp.VMwareEngine.GetAnnouncements.Invoke(new()
        {
            Parent = "projects/my-project/locations/us-west1-a",
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.gcp.vmwareengine.VmwareengineFunctions;
    import com.pulumi.gcp.vmwareengine.inputs.GetAnnouncementsArgs;
    import java.util.List;
    import java.util.ArrayList;
    import java.util.Map;
    import java.io.File;
    import java.nio.file.Files;
    import java.nio.file.Paths;
    
    public class App {
        public static void main(String[] args) {
            Pulumi.run(App::stack);
        }
    
        public static void stack(Context ctx) {
            final var ds = VmwareengineFunctions.getAnnouncements(GetAnnouncementsArgs.builder()
                .parent("projects/my-project/locations/us-west1-a")
                .build());
    
        }
    }
    
    variables:
      ds:
        fn::invoke:
          function: gcp:vmwareengine:getAnnouncements
          arguments:
            parent: projects/my-project/locations/us-west1-a
    

    Using getAnnouncements

    Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

    function getAnnouncements(args: GetAnnouncementsArgs, opts?: InvokeOptions): Promise<GetAnnouncementsResult>
    function getAnnouncementsOutput(args: GetAnnouncementsOutputArgs, opts?: InvokeOptions): Output<GetAnnouncementsResult>
    def get_announcements(name: Optional[str] = None,
                          parent: Optional[str] = None,
                          opts: Optional[InvokeOptions] = None) -> GetAnnouncementsResult
    def get_announcements_output(name: Optional[pulumi.Input[str]] = None,
                          parent: Optional[pulumi.Input[str]] = None,
                          opts: Optional[InvokeOptions] = None) -> Output[GetAnnouncementsResult]
    func GetAnnouncements(ctx *Context, args *GetAnnouncementsArgs, opts ...InvokeOption) (*GetAnnouncementsResult, error)
    func GetAnnouncementsOutput(ctx *Context, args *GetAnnouncementsOutputArgs, opts ...InvokeOption) GetAnnouncementsResultOutput

    > Note: This function is named GetAnnouncements in the Go SDK.

    public static class GetAnnouncements 
    {
        public static Task<GetAnnouncementsResult> InvokeAsync(GetAnnouncementsArgs args, InvokeOptions? opts = null)
        public static Output<GetAnnouncementsResult> Invoke(GetAnnouncementsInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetAnnouncementsResult> getAnnouncements(GetAnnouncementsArgs args, InvokeOptions options)
    public static Output<GetAnnouncementsResult> getAnnouncements(GetAnnouncementsArgs args, InvokeOptions options)
    
    fn::invoke:
      function: gcp:vmwareengine/getAnnouncements:getAnnouncements
      arguments:
        # arguments dictionary

    The following arguments are supported:

    Parent string
    The resource name of the region for which announcements will be listed. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: projects/my-project/locations/us-west1-a
    Name string
    The resource name of the specific Announcement to retrieve. If provided, the announcements list will contain only this announcement.
    Parent string
    The resource name of the region for which announcements will be listed. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: projects/my-project/locations/us-west1-a
    Name string
    The resource name of the specific Announcement to retrieve. If provided, the announcements list will contain only this announcement.
    parent String
    The resource name of the region for which announcements will be listed. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: projects/my-project/locations/us-west1-a
    name String
    The resource name of the specific Announcement to retrieve. If provided, the announcements list will contain only this announcement.
    parent string
    The resource name of the region for which announcements will be listed. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: projects/my-project/locations/us-west1-a
    name string
    The resource name of the specific Announcement to retrieve. If provided, the announcements list will contain only this announcement.
    parent str
    The resource name of the region for which announcements will be listed. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: projects/my-project/locations/us-west1-a
    name str
    The resource name of the specific Announcement to retrieve. If provided, the announcements list will contain only this announcement.
    parent String
    The resource name of the region for which announcements will be listed. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: projects/my-project/locations/us-west1-a
    name String
    The resource name of the specific Announcement to retrieve. If provided, the announcements list will contain only this announcement.

    getAnnouncements Result

    The following output properties are available:

    Announcements List<GetAnnouncementsAnnouncement>
    A list of VMware Engine announcements. Contains one element if name is specified in the arguments, otherwise all announcements for the region.
    Id string
    The provider-assigned unique ID for this managed resource.
    Parent string
    Name string
    The resource name of the announcement.
    Announcements []GetAnnouncementsAnnouncement
    A list of VMware Engine announcements. Contains one element if name is specified in the arguments, otherwise all announcements for the region.
    Id string
    The provider-assigned unique ID for this managed resource.
    Parent string
    Name string
    The resource name of the announcement.
    announcements List<GetAnnouncementsAnnouncement>
    A list of VMware Engine announcements. Contains one element if name is specified in the arguments, otherwise all announcements for the region.
    id String
    The provider-assigned unique ID for this managed resource.
    parent String
    name String
    The resource name of the announcement.
    announcements GetAnnouncementsAnnouncement[]
    A list of VMware Engine announcements. Contains one element if name is specified in the arguments, otherwise all announcements for the region.
    id string
    The provider-assigned unique ID for this managed resource.
    parent string
    name string
    The resource name of the announcement.
    announcements Sequence[GetAnnouncementsAnnouncement]
    A list of VMware Engine announcements. Contains one element if name is specified in the arguments, otherwise all announcements for the region.
    id str
    The provider-assigned unique ID for this managed resource.
    parent str
    name str
    The resource name of the announcement.
    announcements List<Property Map>
    A list of VMware Engine announcements. Contains one element if name is specified in the arguments, otherwise all announcements for the region.
    id String
    The provider-assigned unique ID for this managed resource.
    parent String
    name String
    The resource name of the announcement.

    Supporting Types

    GetAnnouncementsAnnouncement

    Code string
    Code of the announcement. Possible values include: MAINTENANCE_SCHEDULE_NOT_AVAILABLE, MAINTENANCE_SCHEDULE_READY, MAINTENANCE_SCHEDULE_LOCKED, MAINTENANCE_SCHEDULE_CANCELED, MAINTENANCE_INPROGRESS, MAINTENANCE_SUCCESSFUL, MAINTENANCE_CANCELED, MAINTENANCE_PAUSED, MAINTENANCE_FAILED, IMMUTABLE_MAINTENANCE_SCHEDULE_READY, MAINTENANCE_STARTING_SOON.
    Metadata Dictionary<string, string>
    Additional structured details about this announcement
    Name string
    The resource name of the specific Announcement to retrieve. If provided, the announcements list will contain only this announcement.
    TargetResourceType string
    Target Resource Type defines the type of the target for the announcement.
    Code string
    Code of the announcement. Possible values include: MAINTENANCE_SCHEDULE_NOT_AVAILABLE, MAINTENANCE_SCHEDULE_READY, MAINTENANCE_SCHEDULE_LOCKED, MAINTENANCE_SCHEDULE_CANCELED, MAINTENANCE_INPROGRESS, MAINTENANCE_SUCCESSFUL, MAINTENANCE_CANCELED, MAINTENANCE_PAUSED, MAINTENANCE_FAILED, IMMUTABLE_MAINTENANCE_SCHEDULE_READY, MAINTENANCE_STARTING_SOON.
    Metadata map[string]string
    Additional structured details about this announcement
    Name string
    The resource name of the specific Announcement to retrieve. If provided, the announcements list will contain only this announcement.
    TargetResourceType string
    Target Resource Type defines the type of the target for the announcement.
    code String
    Code of the announcement. Possible values include: MAINTENANCE_SCHEDULE_NOT_AVAILABLE, MAINTENANCE_SCHEDULE_READY, MAINTENANCE_SCHEDULE_LOCKED, MAINTENANCE_SCHEDULE_CANCELED, MAINTENANCE_INPROGRESS, MAINTENANCE_SUCCESSFUL, MAINTENANCE_CANCELED, MAINTENANCE_PAUSED, MAINTENANCE_FAILED, IMMUTABLE_MAINTENANCE_SCHEDULE_READY, MAINTENANCE_STARTING_SOON.
    metadata Map<String,String>
    Additional structured details about this announcement
    name String
    The resource name of the specific Announcement to retrieve. If provided, the announcements list will contain only this announcement.
    targetResourceType String
    Target Resource Type defines the type of the target for the announcement.
    code string
    Code of the announcement. Possible values include: MAINTENANCE_SCHEDULE_NOT_AVAILABLE, MAINTENANCE_SCHEDULE_READY, MAINTENANCE_SCHEDULE_LOCKED, MAINTENANCE_SCHEDULE_CANCELED, MAINTENANCE_INPROGRESS, MAINTENANCE_SUCCESSFUL, MAINTENANCE_CANCELED, MAINTENANCE_PAUSED, MAINTENANCE_FAILED, IMMUTABLE_MAINTENANCE_SCHEDULE_READY, MAINTENANCE_STARTING_SOON.
    metadata {[key: string]: string}
    Additional structured details about this announcement
    name string
    The resource name of the specific Announcement to retrieve. If provided, the announcements list will contain only this announcement.
    targetResourceType string
    Target Resource Type defines the type of the target for the announcement.
    code str
    Code of the announcement. Possible values include: MAINTENANCE_SCHEDULE_NOT_AVAILABLE, MAINTENANCE_SCHEDULE_READY, MAINTENANCE_SCHEDULE_LOCKED, MAINTENANCE_SCHEDULE_CANCELED, MAINTENANCE_INPROGRESS, MAINTENANCE_SUCCESSFUL, MAINTENANCE_CANCELED, MAINTENANCE_PAUSED, MAINTENANCE_FAILED, IMMUTABLE_MAINTENANCE_SCHEDULE_READY, MAINTENANCE_STARTING_SOON.
    metadata Mapping[str, str]
    Additional structured details about this announcement
    name str
    The resource name of the specific Announcement to retrieve. If provided, the announcements list will contain only this announcement.
    target_resource_type str
    Target Resource Type defines the type of the target for the announcement.
    code String
    Code of the announcement. Possible values include: MAINTENANCE_SCHEDULE_NOT_AVAILABLE, MAINTENANCE_SCHEDULE_READY, MAINTENANCE_SCHEDULE_LOCKED, MAINTENANCE_SCHEDULE_CANCELED, MAINTENANCE_INPROGRESS, MAINTENANCE_SUCCESSFUL, MAINTENANCE_CANCELED, MAINTENANCE_PAUSED, MAINTENANCE_FAILED, IMMUTABLE_MAINTENANCE_SCHEDULE_READY, MAINTENANCE_STARTING_SOON.
    metadata Map<String>
    Additional structured details about this announcement
    name String
    The resource name of the specific Announcement to retrieve. If provided, the announcements list will contain only this announcement.
    targetResourceType String
    Target Resource Type defines the type of the target for the announcement.

    Package Details

    Repository
    Google Cloud (GCP) Classic pulumi/pulumi-gcp
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the google-beta Terraform Provider.
    gcp logo
    Viewing docs for Google Cloud v9.15.0
    published on Thursday, Mar 12, 2026 by Pulumi
      Try Pulumi Cloud free. Your team will thank you.