1. Packages
  2. Google Cloud Native
  3. API Docs
  4. essentialcontacts
  5. essentialcontacts/v1
  6. Contact

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

google-native.essentialcontacts/v1.Contact

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

    Adds a new contact for a resource. Auto-naming is currently not supported for this resource.

    Create Contact Resource

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

    Constructor syntax

    new Contact(name: string, args: ContactArgs, opts?: CustomResourceOptions);
    @overload
    def Contact(resource_name: str,
                args: ContactArgs,
                opts: Optional[ResourceOptions] = None)
    
    @overload
    def Contact(resource_name: str,
                opts: Optional[ResourceOptions] = None,
                email: Optional[str] = None,
                language_tag: Optional[str] = None,
                notification_category_subscriptions: Optional[Sequence[ContactNotificationCategorySubscriptionsItem]] = None,
                project: Optional[str] = None,
                validate_time: Optional[str] = None,
                validation_state: Optional[ContactValidationState] = None)
    func NewContact(ctx *Context, name string, args ContactArgs, opts ...ResourceOption) (*Contact, error)
    public Contact(string name, ContactArgs args, CustomResourceOptions? opts = null)
    public Contact(String name, ContactArgs args)
    public Contact(String name, ContactArgs args, CustomResourceOptions options)
    
    type: google-native:essentialcontacts/v1:Contact
    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 ContactArgs
    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 ContactArgs
    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 ContactArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args ContactArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args ContactArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Example

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

    var contactResource = new GoogleNative.EssentialContacts.V1.Contact("contactResource", new()
    {
        Email = "string",
        LanguageTag = "string",
        NotificationCategorySubscriptions = new[]
        {
            GoogleNative.EssentialContacts.V1.ContactNotificationCategorySubscriptionsItem.NotificationCategoryUnspecified,
        },
        Project = "string",
        ValidateTime = "string",
        ValidationState = GoogleNative.EssentialContacts.V1.ContactValidationState.ValidationStateUnspecified,
    });
    
    example, err := essentialcontacts.NewContact(ctx, "contactResource", &essentialcontacts.ContactArgs{
    Email: pulumi.String("string"),
    LanguageTag: pulumi.String("string"),
    NotificationCategorySubscriptions: essentialcontacts.ContactNotificationCategorySubscriptionsItemArray{
    essentialcontacts.ContactNotificationCategorySubscriptionsItemNotificationCategoryUnspecified,
    },
    Project: pulumi.String("string"),
    ValidateTime: pulumi.String("string"),
    ValidationState: essentialcontacts.ContactValidationStateValidationStateUnspecified,
    })
    
    var contactResource = new Contact("contactResource", ContactArgs.builder()
        .email("string")
        .languageTag("string")
        .notificationCategorySubscriptions("NOTIFICATION_CATEGORY_UNSPECIFIED")
        .project("string")
        .validateTime("string")
        .validationState("VALIDATION_STATE_UNSPECIFIED")
        .build());
    
    contact_resource = google_native.essentialcontacts.v1.Contact("contactResource",
        email="string",
        language_tag="string",
        notification_category_subscriptions=[google_native.essentialcontacts.v1.ContactNotificationCategorySubscriptionsItem.NOTIFICATION_CATEGORY_UNSPECIFIED],
        project="string",
        validate_time="string",
        validation_state=google_native.essentialcontacts.v1.ContactValidationState.VALIDATION_STATE_UNSPECIFIED)
    
    const contactResource = new google_native.essentialcontacts.v1.Contact("contactResource", {
        email: "string",
        languageTag: "string",
        notificationCategorySubscriptions: [google_native.essentialcontacts.v1.ContactNotificationCategorySubscriptionsItem.NotificationCategoryUnspecified],
        project: "string",
        validateTime: "string",
        validationState: google_native.essentialcontacts.v1.ContactValidationState.ValidationStateUnspecified,
    });
    
    type: google-native:essentialcontacts/v1:Contact
    properties:
        email: string
        languageTag: string
        notificationCategorySubscriptions:
            - NOTIFICATION_CATEGORY_UNSPECIFIED
        project: string
        validateTime: string
        validationState: VALIDATION_STATE_UNSPECIFIED
    

    Contact Resource Properties

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

    Inputs

    The Contact resource accepts the following input properties:

    Email string
    The email address to send notifications to. The email address does not need to be a Google Account.
    LanguageTag string
    The preferred language for notifications, as a ISO 639-1 language code. See Supported languages for a list of supported languages.
    NotificationCategorySubscriptions List<Pulumi.GoogleNative.EssentialContacts.V1.ContactNotificationCategorySubscriptionsItem>
    The categories of notifications that the contact will receive communications for.
    Project string
    ValidateTime string
    The last time the validation_state was updated, either manually or automatically. A contact is considered stale if its validation state was updated more than 1 year ago.
    ValidationState Pulumi.GoogleNative.EssentialContacts.V1.ContactValidationState
    The validity of the contact. A contact is considered valid if it is the correct recipient for notifications for a particular resource.
    Email string
    The email address to send notifications to. The email address does not need to be a Google Account.
    LanguageTag string
    The preferred language for notifications, as a ISO 639-1 language code. See Supported languages for a list of supported languages.
    NotificationCategorySubscriptions []ContactNotificationCategorySubscriptionsItem
    The categories of notifications that the contact will receive communications for.
    Project string
    ValidateTime string
    The last time the validation_state was updated, either manually or automatically. A contact is considered stale if its validation state was updated more than 1 year ago.
    ValidationState ContactValidationState
    The validity of the contact. A contact is considered valid if it is the correct recipient for notifications for a particular resource.
    email String
    The email address to send notifications to. The email address does not need to be a Google Account.
    languageTag String
    The preferred language for notifications, as a ISO 639-1 language code. See Supported languages for a list of supported languages.
    notificationCategorySubscriptions List<ContactNotificationCategorySubscriptionsItem>
    The categories of notifications that the contact will receive communications for.
    project String
    validateTime String
    The last time the validation_state was updated, either manually or automatically. A contact is considered stale if its validation state was updated more than 1 year ago.
    validationState ContactValidationState
    The validity of the contact. A contact is considered valid if it is the correct recipient for notifications for a particular resource.
    email string
    The email address to send notifications to. The email address does not need to be a Google Account.
    languageTag string
    The preferred language for notifications, as a ISO 639-1 language code. See Supported languages for a list of supported languages.
    notificationCategorySubscriptions ContactNotificationCategorySubscriptionsItem[]
    The categories of notifications that the contact will receive communications for.
    project string
    validateTime string
    The last time the validation_state was updated, either manually or automatically. A contact is considered stale if its validation state was updated more than 1 year ago.
    validationState ContactValidationState
    The validity of the contact. A contact is considered valid if it is the correct recipient for notifications for a particular resource.
    email str
    The email address to send notifications to. The email address does not need to be a Google Account.
    language_tag str
    The preferred language for notifications, as a ISO 639-1 language code. See Supported languages for a list of supported languages.
    notification_category_subscriptions Sequence[ContactNotificationCategorySubscriptionsItem]
    The categories of notifications that the contact will receive communications for.
    project str
    validate_time str
    The last time the validation_state was updated, either manually or automatically. A contact is considered stale if its validation state was updated more than 1 year ago.
    validation_state ContactValidationState
    The validity of the contact. A contact is considered valid if it is the correct recipient for notifications for a particular resource.
    email String
    The email address to send notifications to. The email address does not need to be a Google Account.
    languageTag String
    The preferred language for notifications, as a ISO 639-1 language code. See Supported languages for a list of supported languages.
    notificationCategorySubscriptions List<"NOTIFICATION_CATEGORY_UNSPECIFIED" | "ALL" | "SUSPENSION" | "SECURITY" | "TECHNICAL" | "BILLING" | "LEGAL" | "PRODUCT_UPDATES" | "TECHNICAL_INCIDENTS">
    The categories of notifications that the contact will receive communications for.
    project String
    validateTime String
    The last time the validation_state was updated, either manually or automatically. A contact is considered stale if its validation state was updated more than 1 year ago.
    validationState "VALIDATION_STATE_UNSPECIFIED" | "VALID" | "INVALID"
    The validity of the contact. A contact is considered valid if it is the correct recipient for notifications for a particular resource.

    Outputs

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

    Id string
    The provider-assigned unique ID for this managed resource.
    Name string
    The identifier for the contact. Format: {resource_type}/{resource_id}/contacts/{contact_id}
    Id string
    The provider-assigned unique ID for this managed resource.
    Name string
    The identifier for the contact. Format: {resource_type}/{resource_id}/contacts/{contact_id}
    id String
    The provider-assigned unique ID for this managed resource.
    name String
    The identifier for the contact. Format: {resource_type}/{resource_id}/contacts/{contact_id}
    id string
    The provider-assigned unique ID for this managed resource.
    name string
    The identifier for the contact. Format: {resource_type}/{resource_id}/contacts/{contact_id}
    id str
    The provider-assigned unique ID for this managed resource.
    name str
    The identifier for the contact. Format: {resource_type}/{resource_id}/contacts/{contact_id}
    id String
    The provider-assigned unique ID for this managed resource.
    name String
    The identifier for the contact. Format: {resource_type}/{resource_id}/contacts/{contact_id}

    Supporting Types

    ContactNotificationCategorySubscriptionsItem, ContactNotificationCategorySubscriptionsItemArgs

    NotificationCategoryUnspecified
    NOTIFICATION_CATEGORY_UNSPECIFIEDNotification category is unrecognized or unspecified.
    All
    ALLAll notifications related to the resource, including notifications pertaining to categories added in the future.
    Suspension
    SUSPENSIONNotifications related to imminent account suspension.
    Security
    SECURITYNotifications related to security/privacy incidents, notifications, and vulnerabilities.
    Technical
    TECHNICALNotifications related to technical events and issues such as outages, errors, or bugs.
    Billing
    BILLINGNotifications related to billing and payments notifications, price updates, errors, or credits.
    Legal
    LEGALNotifications related to enforcement actions, regulatory compliance, or government notices.
    ProductUpdates
    PRODUCT_UPDATESNotifications related to new versions, product terms updates, or deprecations.
    TechnicalIncidents
    TECHNICAL_INCIDENTSChild category of TECHNICAL. If assigned, technical incident notifications will go to these contacts instead of TECHNICAL.
    ContactNotificationCategorySubscriptionsItemNotificationCategoryUnspecified
    NOTIFICATION_CATEGORY_UNSPECIFIEDNotification category is unrecognized or unspecified.
    ContactNotificationCategorySubscriptionsItemAll
    ALLAll notifications related to the resource, including notifications pertaining to categories added in the future.
    ContactNotificationCategorySubscriptionsItemSuspension
    SUSPENSIONNotifications related to imminent account suspension.
    ContactNotificationCategorySubscriptionsItemSecurity
    SECURITYNotifications related to security/privacy incidents, notifications, and vulnerabilities.
    ContactNotificationCategorySubscriptionsItemTechnical
    TECHNICALNotifications related to technical events and issues such as outages, errors, or bugs.
    ContactNotificationCategorySubscriptionsItemBilling
    BILLINGNotifications related to billing and payments notifications, price updates, errors, or credits.
    ContactNotificationCategorySubscriptionsItemLegal
    LEGALNotifications related to enforcement actions, regulatory compliance, or government notices.
    ContactNotificationCategorySubscriptionsItemProductUpdates
    PRODUCT_UPDATESNotifications related to new versions, product terms updates, or deprecations.
    ContactNotificationCategorySubscriptionsItemTechnicalIncidents
    TECHNICAL_INCIDENTSChild category of TECHNICAL. If assigned, technical incident notifications will go to these contacts instead of TECHNICAL.
    NotificationCategoryUnspecified
    NOTIFICATION_CATEGORY_UNSPECIFIEDNotification category is unrecognized or unspecified.
    All
    ALLAll notifications related to the resource, including notifications pertaining to categories added in the future.
    Suspension
    SUSPENSIONNotifications related to imminent account suspension.
    Security
    SECURITYNotifications related to security/privacy incidents, notifications, and vulnerabilities.
    Technical
    TECHNICALNotifications related to technical events and issues such as outages, errors, or bugs.
    Billing
    BILLINGNotifications related to billing and payments notifications, price updates, errors, or credits.
    Legal
    LEGALNotifications related to enforcement actions, regulatory compliance, or government notices.
    ProductUpdates
    PRODUCT_UPDATESNotifications related to new versions, product terms updates, or deprecations.
    TechnicalIncidents
    TECHNICAL_INCIDENTSChild category of TECHNICAL. If assigned, technical incident notifications will go to these contacts instead of TECHNICAL.
    NotificationCategoryUnspecified
    NOTIFICATION_CATEGORY_UNSPECIFIEDNotification category is unrecognized or unspecified.
    All
    ALLAll notifications related to the resource, including notifications pertaining to categories added in the future.
    Suspension
    SUSPENSIONNotifications related to imminent account suspension.
    Security
    SECURITYNotifications related to security/privacy incidents, notifications, and vulnerabilities.
    Technical
    TECHNICALNotifications related to technical events and issues such as outages, errors, or bugs.
    Billing
    BILLINGNotifications related to billing and payments notifications, price updates, errors, or credits.
    Legal
    LEGALNotifications related to enforcement actions, regulatory compliance, or government notices.
    ProductUpdates
    PRODUCT_UPDATESNotifications related to new versions, product terms updates, or deprecations.
    TechnicalIncidents
    TECHNICAL_INCIDENTSChild category of TECHNICAL. If assigned, technical incident notifications will go to these contacts instead of TECHNICAL.
    NOTIFICATION_CATEGORY_UNSPECIFIED
    NOTIFICATION_CATEGORY_UNSPECIFIEDNotification category is unrecognized or unspecified.
    ALL
    ALLAll notifications related to the resource, including notifications pertaining to categories added in the future.
    SUSPENSION
    SUSPENSIONNotifications related to imminent account suspension.
    SECURITY
    SECURITYNotifications related to security/privacy incidents, notifications, and vulnerabilities.
    TECHNICAL
    TECHNICALNotifications related to technical events and issues such as outages, errors, or bugs.
    BILLING
    BILLINGNotifications related to billing and payments notifications, price updates, errors, or credits.
    LEGAL
    LEGALNotifications related to enforcement actions, regulatory compliance, or government notices.
    PRODUCT_UPDATES
    PRODUCT_UPDATESNotifications related to new versions, product terms updates, or deprecations.
    TECHNICAL_INCIDENTS
    TECHNICAL_INCIDENTSChild category of TECHNICAL. If assigned, technical incident notifications will go to these contacts instead of TECHNICAL.
    "NOTIFICATION_CATEGORY_UNSPECIFIED"
    NOTIFICATION_CATEGORY_UNSPECIFIEDNotification category is unrecognized or unspecified.
    "ALL"
    ALLAll notifications related to the resource, including notifications pertaining to categories added in the future.
    "SUSPENSION"
    SUSPENSIONNotifications related to imminent account suspension.
    "SECURITY"
    SECURITYNotifications related to security/privacy incidents, notifications, and vulnerabilities.
    "TECHNICAL"
    TECHNICALNotifications related to technical events and issues such as outages, errors, or bugs.
    "BILLING"
    BILLINGNotifications related to billing and payments notifications, price updates, errors, or credits.
    "LEGAL"
    LEGALNotifications related to enforcement actions, regulatory compliance, or government notices.
    "PRODUCT_UPDATES"
    PRODUCT_UPDATESNotifications related to new versions, product terms updates, or deprecations.
    "TECHNICAL_INCIDENTS"
    TECHNICAL_INCIDENTSChild category of TECHNICAL. If assigned, technical incident notifications will go to these contacts instead of TECHNICAL.

    ContactValidationState, ContactValidationStateArgs

    ValidationStateUnspecified
    VALIDATION_STATE_UNSPECIFIEDThe validation state is unknown or unspecified.
    Valid
    VALIDThe contact is marked as valid. This is usually done manually by the contact admin. All new contacts begin in the valid state.
    Invalid
    INVALIDThe contact is considered invalid. This may become the state if the contact's email is found to be unreachable.
    ContactValidationStateValidationStateUnspecified
    VALIDATION_STATE_UNSPECIFIEDThe validation state is unknown or unspecified.
    ContactValidationStateValid
    VALIDThe contact is marked as valid. This is usually done manually by the contact admin. All new contacts begin in the valid state.
    ContactValidationStateInvalid
    INVALIDThe contact is considered invalid. This may become the state if the contact's email is found to be unreachable.
    ValidationStateUnspecified
    VALIDATION_STATE_UNSPECIFIEDThe validation state is unknown or unspecified.
    Valid
    VALIDThe contact is marked as valid. This is usually done manually by the contact admin. All new contacts begin in the valid state.
    Invalid
    INVALIDThe contact is considered invalid. This may become the state if the contact's email is found to be unreachable.
    ValidationStateUnspecified
    VALIDATION_STATE_UNSPECIFIEDThe validation state is unknown or unspecified.
    Valid
    VALIDThe contact is marked as valid. This is usually done manually by the contact admin. All new contacts begin in the valid state.
    Invalid
    INVALIDThe contact is considered invalid. This may become the state if the contact's email is found to be unreachable.
    VALIDATION_STATE_UNSPECIFIED
    VALIDATION_STATE_UNSPECIFIEDThe validation state is unknown or unspecified.
    VALID
    VALIDThe contact is marked as valid. This is usually done manually by the contact admin. All new contacts begin in the valid state.
    INVALID
    INVALIDThe contact is considered invalid. This may become the state if the contact's email is found to be unreachable.
    "VALIDATION_STATE_UNSPECIFIED"
    VALIDATION_STATE_UNSPECIFIEDThe validation state is unknown or unspecified.
    "VALID"
    VALIDThe contact is marked as valid. This is usually done manually by the contact admin. All new contacts begin in the valid state.
    "INVALID"
    INVALIDThe contact is considered invalid. This may become the state if the contact's email is found to be unreachable.

    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