Google Native

v0.26.0 published on Friday, Sep 16, 2022 by Pulumi

ServiceAttachment

Creates a ServiceAttachment in the specified project in the given scope using the parameters that are included in the request.

Create a ServiceAttachment Resource

new ServiceAttachment(name: string, args: ServiceAttachmentArgs, opts?: CustomResourceOptions);
@overload
def ServiceAttachment(resource_name: str,
                      opts: Optional[ResourceOptions] = None,
                      connection_preference: Optional[ServiceAttachmentConnectionPreference] = None,
                      consumer_accept_lists: Optional[Sequence[ServiceAttachmentConsumerProjectLimitArgs]] = None,
                      consumer_reject_lists: Optional[Sequence[str]] = None,
                      description: Optional[str] = None,
                      domain_names: Optional[Sequence[str]] = None,
                      enable_proxy_protocol: Optional[bool] = None,
                      name: Optional[str] = None,
                      nat_subnets: Optional[Sequence[str]] = None,
                      producer_forwarding_rule: Optional[str] = None,
                      project: Optional[str] = None,
                      region: Optional[str] = None,
                      request_id: Optional[str] = None,
                      target_service: Optional[str] = None)
@overload
def ServiceAttachment(resource_name: str,
                      args: ServiceAttachmentArgs,
                      opts: Optional[ResourceOptions] = None)
func NewServiceAttachment(ctx *Context, name string, args ServiceAttachmentArgs, opts ...ResourceOption) (*ServiceAttachment, error)
public ServiceAttachment(string name, ServiceAttachmentArgs args, CustomResourceOptions? opts = null)
public ServiceAttachment(String name, ServiceAttachmentArgs args)
public ServiceAttachment(String name, ServiceAttachmentArgs args, CustomResourceOptions options)
type: google-native:compute/alpha:ServiceAttachment
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

name string
The unique name of the resource.
args ServiceAttachmentArgs
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 ServiceAttachmentArgs
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 ServiceAttachmentArgs
The arguments to resource properties.
opts ResourceOption
Bag of options to control resource's behavior.
name string
The unique name of the resource.
args ServiceAttachmentArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
name String
The unique name of the resource.
args ServiceAttachmentArgs
The arguments to resource properties.
options CustomResourceOptions
Bag of options to control resource's behavior.

ServiceAttachment 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 ServiceAttachment resource accepts the following input properties:

Region string
ConnectionPreference Pulumi.GoogleNative.Compute.Alpha.ServiceAttachmentConnectionPreference

The connection preference of service attachment. The value can be set to ACCEPT_AUTOMATIC. An ACCEPT_AUTOMATIC service attachment is one that always accepts the connection from consumer forwarding rules.

ConsumerAcceptLists List<Pulumi.GoogleNative.Compute.Alpha.Inputs.ServiceAttachmentConsumerProjectLimitArgs>

Projects that are allowed to connect to this service attachment.

ConsumerRejectLists List<string>

Projects that are not allowed to connect to this service attachment. The project can be specified using its id or number.

Description string

An optional description of this resource. Provide this property when you create the resource.

DomainNames List<string>

If specified, the domain name will be used during the integration between the PSC connected endpoints and the Cloud DNS. For example, this is a valid domain name: "p.mycompany.com.". Current max number of domain names supported is 1.

EnableProxyProtocol bool

If true, enable the proxy protocol which is for supplying client TCP/IP address data in TCP connections that traverse proxies on their way to destination servers.

Name string

Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.

NatSubnets List<string>

An array of URLs where each entry is the URL of a subnet provided by the service producer to use for NAT in this service attachment.

ProducerForwardingRule string

The URL of a forwarding rule with loadBalancingScheme INTERNAL* that is serving the endpoint identified by this service attachment.

Project string
RequestId string

An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).

TargetService string

The URL of a service serving the endpoint identified by this service attachment.

Region string
ConnectionPreference ServiceAttachmentConnectionPreference

The connection preference of service attachment. The value can be set to ACCEPT_AUTOMATIC. An ACCEPT_AUTOMATIC service attachment is one that always accepts the connection from consumer forwarding rules.

ConsumerAcceptLists []ServiceAttachmentConsumerProjectLimitArgs

Projects that are allowed to connect to this service attachment.

ConsumerRejectLists []string

Projects that are not allowed to connect to this service attachment. The project can be specified using its id or number.

Description string

An optional description of this resource. Provide this property when you create the resource.

DomainNames []string

If specified, the domain name will be used during the integration between the PSC connected endpoints and the Cloud DNS. For example, this is a valid domain name: "p.mycompany.com.". Current max number of domain names supported is 1.

EnableProxyProtocol bool

If true, enable the proxy protocol which is for supplying client TCP/IP address data in TCP connections that traverse proxies on their way to destination servers.

Name string

Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.

NatSubnets []string

An array of URLs where each entry is the URL of a subnet provided by the service producer to use for NAT in this service attachment.

ProducerForwardingRule string

The URL of a forwarding rule with loadBalancingScheme INTERNAL* that is serving the endpoint identified by this service attachment.

Project string
RequestId string

An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).

TargetService string

The URL of a service serving the endpoint identified by this service attachment.

region String
connectionPreference ServiceAttachmentConnectionPreference

The connection preference of service attachment. The value can be set to ACCEPT_AUTOMATIC. An ACCEPT_AUTOMATIC service attachment is one that always accepts the connection from consumer forwarding rules.

consumerAcceptLists List<ServiceAttachmentConsumerProjectLimitArgs>

Projects that are allowed to connect to this service attachment.

consumerRejectLists List<String>

Projects that are not allowed to connect to this service attachment. The project can be specified using its id or number.

description String

An optional description of this resource. Provide this property when you create the resource.

domainNames List<String>

If specified, the domain name will be used during the integration between the PSC connected endpoints and the Cloud DNS. For example, this is a valid domain name: "p.mycompany.com.". Current max number of domain names supported is 1.

enableProxyProtocol Boolean

If true, enable the proxy protocol which is for supplying client TCP/IP address data in TCP connections that traverse proxies on their way to destination servers.

name String

Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.

natSubnets List<String>

An array of URLs where each entry is the URL of a subnet provided by the service producer to use for NAT in this service attachment.

producerForwardingRule String

The URL of a forwarding rule with loadBalancingScheme INTERNAL* that is serving the endpoint identified by this service attachment.

project String
requestId String

An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).

targetService String

The URL of a service serving the endpoint identified by this service attachment.

region string
connectionPreference ServiceAttachmentConnectionPreference

The connection preference of service attachment. The value can be set to ACCEPT_AUTOMATIC. An ACCEPT_AUTOMATIC service attachment is one that always accepts the connection from consumer forwarding rules.

consumerAcceptLists ServiceAttachmentConsumerProjectLimitArgs[]

Projects that are allowed to connect to this service attachment.

consumerRejectLists string[]

Projects that are not allowed to connect to this service attachment. The project can be specified using its id or number.

description string

An optional description of this resource. Provide this property when you create the resource.

domainNames string[]

If specified, the domain name will be used during the integration between the PSC connected endpoints and the Cloud DNS. For example, this is a valid domain name: "p.mycompany.com.". Current max number of domain names supported is 1.

enableProxyProtocol boolean

If true, enable the proxy protocol which is for supplying client TCP/IP address data in TCP connections that traverse proxies on their way to destination servers.

name string

Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.

natSubnets string[]

An array of URLs where each entry is the URL of a subnet provided by the service producer to use for NAT in this service attachment.

producerForwardingRule string

The URL of a forwarding rule with loadBalancingScheme INTERNAL* that is serving the endpoint identified by this service attachment.

project string
requestId string

An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).

targetService string

The URL of a service serving the endpoint identified by this service attachment.

region str
connection_preference ServiceAttachmentConnectionPreference

The connection preference of service attachment. The value can be set to ACCEPT_AUTOMATIC. An ACCEPT_AUTOMATIC service attachment is one that always accepts the connection from consumer forwarding rules.

consumer_accept_lists Sequence[ServiceAttachmentConsumerProjectLimitArgs]

Projects that are allowed to connect to this service attachment.

consumer_reject_lists Sequence[str]

Projects that are not allowed to connect to this service attachment. The project can be specified using its id or number.

description str

An optional description of this resource. Provide this property when you create the resource.

domain_names Sequence[str]

If specified, the domain name will be used during the integration between the PSC connected endpoints and the Cloud DNS. For example, this is a valid domain name: "p.mycompany.com.". Current max number of domain names supported is 1.

enable_proxy_protocol bool

If true, enable the proxy protocol which is for supplying client TCP/IP address data in TCP connections that traverse proxies on their way to destination servers.

name str

Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.

nat_subnets Sequence[str]

An array of URLs where each entry is the URL of a subnet provided by the service producer to use for NAT in this service attachment.

producer_forwarding_rule str

The URL of a forwarding rule with loadBalancingScheme INTERNAL* that is serving the endpoint identified by this service attachment.

project str
request_id str

An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).

target_service str

The URL of a service serving the endpoint identified by this service attachment.

region String
connectionPreference "ACCEPT_AUTOMATIC" | "ACCEPT_MANUAL" | "CONNECTION_PREFERENCE_UNSPECIFIED"

The connection preference of service attachment. The value can be set to ACCEPT_AUTOMATIC. An ACCEPT_AUTOMATIC service attachment is one that always accepts the connection from consumer forwarding rules.

consumerAcceptLists List<Property Map>

Projects that are allowed to connect to this service attachment.

consumerRejectLists List<String>

Projects that are not allowed to connect to this service attachment. The project can be specified using its id or number.

description String

An optional description of this resource. Provide this property when you create the resource.

domainNames List<String>

If specified, the domain name will be used during the integration between the PSC connected endpoints and the Cloud DNS. For example, this is a valid domain name: "p.mycompany.com.". Current max number of domain names supported is 1.

enableProxyProtocol Boolean

If true, enable the proxy protocol which is for supplying client TCP/IP address data in TCP connections that traverse proxies on their way to destination servers.

name String

Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.

natSubnets List<String>

An array of URLs where each entry is the URL of a subnet provided by the service producer to use for NAT in this service attachment.

producerForwardingRule String

The URL of a forwarding rule with loadBalancingScheme INTERNAL* that is serving the endpoint identified by this service attachment.

project String
requestId String

An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).

targetService String

The URL of a service serving the endpoint identified by this service attachment.

Outputs

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

ConnectedEndpoints List<Pulumi.GoogleNative.Compute.Alpha.Outputs.ServiceAttachmentConnectedEndpointResponse>

An array of connections for all the consumers connected to this service attachment.

CreationTimestamp string

Creation timestamp in RFC3339 text format.

Fingerprint string

Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a ServiceAttachment. An up-to-date fingerprint must be provided in order to patch/update the ServiceAttachment; otherwise, the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve the ServiceAttachment.

Id string

The provider-assigned unique ID for this managed resource.

Kind string

Type of the resource. Always compute#serviceAttachment for service attachments.

PscServiceAttachmentId Pulumi.GoogleNative.Compute.Alpha.Outputs.Uint128Response

An 128-bit global unique ID of the PSC service attachment.

SelfLink string

Server-defined URL for the resource.

ConnectedEndpoints []ServiceAttachmentConnectedEndpointResponse

An array of connections for all the consumers connected to this service attachment.

CreationTimestamp string

Creation timestamp in RFC3339 text format.

Fingerprint string

Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a ServiceAttachment. An up-to-date fingerprint must be provided in order to patch/update the ServiceAttachment; otherwise, the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve the ServiceAttachment.

Id string

The provider-assigned unique ID for this managed resource.

Kind string

Type of the resource. Always compute#serviceAttachment for service attachments.

PscServiceAttachmentId Uint128Response

An 128-bit global unique ID of the PSC service attachment.

SelfLink string

Server-defined URL for the resource.

connectedEndpoints List<ServiceAttachmentConnectedEndpointResponse>

An array of connections for all the consumers connected to this service attachment.

creationTimestamp String

Creation timestamp in RFC3339 text format.

fingerprint String

Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a ServiceAttachment. An up-to-date fingerprint must be provided in order to patch/update the ServiceAttachment; otherwise, the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve the ServiceAttachment.

id String

The provider-assigned unique ID for this managed resource.

kind String

Type of the resource. Always compute#serviceAttachment for service attachments.

pscServiceAttachmentId Uint128Response

An 128-bit global unique ID of the PSC service attachment.

selfLink String

Server-defined URL for the resource.

connectedEndpoints ServiceAttachmentConnectedEndpointResponse[]

An array of connections for all the consumers connected to this service attachment.

creationTimestamp string

Creation timestamp in RFC3339 text format.

fingerprint string

Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a ServiceAttachment. An up-to-date fingerprint must be provided in order to patch/update the ServiceAttachment; otherwise, the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve the ServiceAttachment.

id string

The provider-assigned unique ID for this managed resource.

kind string

Type of the resource. Always compute#serviceAttachment for service attachments.

pscServiceAttachmentId Uint128Response

An 128-bit global unique ID of the PSC service attachment.

selfLink string

Server-defined URL for the resource.

connected_endpoints Sequence[ServiceAttachmentConnectedEndpointResponse]

An array of connections for all the consumers connected to this service attachment.

creation_timestamp str

Creation timestamp in RFC3339 text format.

fingerprint str

Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a ServiceAttachment. An up-to-date fingerprint must be provided in order to patch/update the ServiceAttachment; otherwise, the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve the ServiceAttachment.

id str

The provider-assigned unique ID for this managed resource.

kind str

Type of the resource. Always compute#serviceAttachment for service attachments.

psc_service_attachment_id Uint128Response

An 128-bit global unique ID of the PSC service attachment.

self_link str

Server-defined URL for the resource.

connectedEndpoints List<Property Map>

An array of connections for all the consumers connected to this service attachment.

creationTimestamp String

Creation timestamp in RFC3339 text format.

fingerprint String

Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a ServiceAttachment. An up-to-date fingerprint must be provided in order to patch/update the ServiceAttachment; otherwise, the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve the ServiceAttachment.

id String

The provider-assigned unique ID for this managed resource.

kind String

Type of the resource. Always compute#serviceAttachment for service attachments.

pscServiceAttachmentId Property Map

An 128-bit global unique ID of the PSC service attachment.

selfLink String

Server-defined URL for the resource.

Supporting Types

ServiceAttachmentConnectedEndpointResponse

Endpoint string

The url of a connected endpoint.

PscConnectionId string

The PSC connection id of the connected endpoint.

Status string

The status of a connected endpoint to this service attachment.

Endpoint string

The url of a connected endpoint.

PscConnectionId string

The PSC connection id of the connected endpoint.

Status string

The status of a connected endpoint to this service attachment.

endpoint String

The url of a connected endpoint.

pscConnectionId String

The PSC connection id of the connected endpoint.

status String

The status of a connected endpoint to this service attachment.

endpoint string

The url of a connected endpoint.

pscConnectionId string

The PSC connection id of the connected endpoint.

status string

The status of a connected endpoint to this service attachment.

endpoint str

The url of a connected endpoint.

psc_connection_id str

The PSC connection id of the connected endpoint.

status str

The status of a connected endpoint to this service attachment.

endpoint String

The url of a connected endpoint.

pscConnectionId String

The PSC connection id of the connected endpoint.

status String

The status of a connected endpoint to this service attachment.

ServiceAttachmentConnectionPreference

AcceptAutomatic
ACCEPT_AUTOMATIC
AcceptManual
ACCEPT_MANUAL
ConnectionPreferenceUnspecified
CONNECTION_PREFERENCE_UNSPECIFIED
ServiceAttachmentConnectionPreferenceAcceptAutomatic
ACCEPT_AUTOMATIC
ServiceAttachmentConnectionPreferenceAcceptManual
ACCEPT_MANUAL
ServiceAttachmentConnectionPreferenceConnectionPreferenceUnspecified
CONNECTION_PREFERENCE_UNSPECIFIED
AcceptAutomatic
ACCEPT_AUTOMATIC
AcceptManual
ACCEPT_MANUAL
ConnectionPreferenceUnspecified
CONNECTION_PREFERENCE_UNSPECIFIED
AcceptAutomatic
ACCEPT_AUTOMATIC
AcceptManual
ACCEPT_MANUAL
ConnectionPreferenceUnspecified
CONNECTION_PREFERENCE_UNSPECIFIED
ACCEPT_AUTOMATIC
ACCEPT_AUTOMATIC
ACCEPT_MANUAL
ACCEPT_MANUAL
CONNECTION_PREFERENCE_UNSPECIFIED
CONNECTION_PREFERENCE_UNSPECIFIED
"ACCEPT_AUTOMATIC"
ACCEPT_AUTOMATIC
"ACCEPT_MANUAL"
ACCEPT_MANUAL
"CONNECTION_PREFERENCE_UNSPECIFIED"
CONNECTION_PREFERENCE_UNSPECIFIED

ServiceAttachmentConsumerProjectLimit

ConnectionLimit int

The value of the limit to set.

ProjectIdOrNum string

The project id or number for the project to set the limit for.

ConnectionLimit int

The value of the limit to set.

ProjectIdOrNum string

The project id or number for the project to set the limit for.

connectionLimit Integer

The value of the limit to set.

projectIdOrNum String

The project id or number for the project to set the limit for.

connectionLimit number

The value of the limit to set.

projectIdOrNum string

The project id or number for the project to set the limit for.

connection_limit int

The value of the limit to set.

project_id_or_num str

The project id or number for the project to set the limit for.

connectionLimit Number

The value of the limit to set.

projectIdOrNum String

The project id or number for the project to set the limit for.

ServiceAttachmentConsumerProjectLimitResponse

ConnectionLimit int

The value of the limit to set.

ProjectIdOrNum string

The project id or number for the project to set the limit for.

ConnectionLimit int

The value of the limit to set.

ProjectIdOrNum string

The project id or number for the project to set the limit for.

connectionLimit Integer

The value of the limit to set.

projectIdOrNum String

The project id or number for the project to set the limit for.

connectionLimit number

The value of the limit to set.

projectIdOrNum string

The project id or number for the project to set the limit for.

connection_limit int

The value of the limit to set.

project_id_or_num str

The project id or number for the project to set the limit for.

connectionLimit Number

The value of the limit to set.

projectIdOrNum String

The project id or number for the project to set the limit for.

Uint128Response

High string
Low string
High string
Low string
high String
low String
high string
low string
high str
low str
high String
low String

Package Details

Repository
https://github.com/pulumi/pulumi-google-native
License
Apache-2.0