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.servicedirectory/v1beta1.getService
Explore with Pulumi AI
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
Gets a service.
Using getService
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 getService(args: GetServiceArgs, opts?: InvokeOptions): Promise<GetServiceResult>
function getServiceOutput(args: GetServiceOutputArgs, opts?: InvokeOptions): Output<GetServiceResult>
def get_service(location: Optional[str] = None,
namespace_id: Optional[str] = None,
project: Optional[str] = None,
service_id: Optional[str] = None,
opts: Optional[InvokeOptions] = None) -> GetServiceResult
def get_service_output(location: Optional[pulumi.Input[str]] = None,
namespace_id: Optional[pulumi.Input[str]] = None,
project: Optional[pulumi.Input[str]] = None,
service_id: Optional[pulumi.Input[str]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetServiceResult]
func LookupService(ctx *Context, args *LookupServiceArgs, opts ...InvokeOption) (*LookupServiceResult, error)
func LookupServiceOutput(ctx *Context, args *LookupServiceOutputArgs, opts ...InvokeOption) LookupServiceResultOutput
> Note: This function is named LookupService
in the Go SDK.
public static class GetService
{
public static Task<GetServiceResult> InvokeAsync(GetServiceArgs args, InvokeOptions? opts = null)
public static Output<GetServiceResult> Invoke(GetServiceInvokeArgs args, InvokeOptions? opts = null)
}
public static CompletableFuture<GetServiceResult> getService(GetServiceArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
fn::invoke:
function: google-native:servicedirectory/v1beta1:getService
arguments:
# arguments dictionary
The following arguments are supported:
- Location string
- Namespace
Id string - Service
Id string - Project string
- Location string
- Namespace
Id string - Service
Id string - Project string
- location String
- namespace
Id String - service
Id String - project String
- location string
- namespace
Id string - service
Id string - project string
- location str
- namespace_
id str - service_
id str - project str
- location String
- namespace
Id String - service
Id String - project String
getService Result
The following output properties are available:
- Create
Time string - The timestamp when the service was created.
- Endpoints
List<Pulumi.
Google Native. Service Directory. V1Beta1. Outputs. Endpoint Response> - Endpoints associated with this service. Returned on LookupService.ResolveService. Control plane clients should use RegistrationService.ListEndpoints.
- Metadata Dictionary<string, string>
- Optional. Metadata for the service. This data can be consumed by service clients. Restrictions: * The entire metadata dictionary may contain up to 2000 characters, spread accoss all key-value pairs. Metadata that goes beyond this limit are rejected * Valid metadata keys have two segments: an optional prefix and name, separated by a slash (/). The name segment is required and must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between. The prefix is optional. If specified, the prefix must be a DNS subdomain: a series of DNS labels separated by dots (.), not longer than 253 characters in total, followed by a slash (/). Metadata that fails to meet these requirements are rejected Note: This field is equivalent to the
annotations
field in the v1 API. They have the same syntax and read/write to the same location in Service Directory. - Name string
- Immutable. The resource name for the service in the format
projects/*/locations/*/namespaces/*/services/*
. - Uid string
- A globally unique identifier (in UUID4 format) for this service.
- Update
Time string - The timestamp when the service was last updated. Note: endpoints being created/deleted/updated within the service are not considered service updates for the purpose of this timestamp.
- Create
Time string - The timestamp when the service was created.
- Endpoints
[]Endpoint
Response - Endpoints associated with this service. Returned on LookupService.ResolveService. Control plane clients should use RegistrationService.ListEndpoints.
- Metadata map[string]string
- Optional. Metadata for the service. This data can be consumed by service clients. Restrictions: * The entire metadata dictionary may contain up to 2000 characters, spread accoss all key-value pairs. Metadata that goes beyond this limit are rejected * Valid metadata keys have two segments: an optional prefix and name, separated by a slash (/). The name segment is required and must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between. The prefix is optional. If specified, the prefix must be a DNS subdomain: a series of DNS labels separated by dots (.), not longer than 253 characters in total, followed by a slash (/). Metadata that fails to meet these requirements are rejected Note: This field is equivalent to the
annotations
field in the v1 API. They have the same syntax and read/write to the same location in Service Directory. - Name string
- Immutable. The resource name for the service in the format
projects/*/locations/*/namespaces/*/services/*
. - Uid string
- A globally unique identifier (in UUID4 format) for this service.
- Update
Time string - The timestamp when the service was last updated. Note: endpoints being created/deleted/updated within the service are not considered service updates for the purpose of this timestamp.
- create
Time String - The timestamp when the service was created.
- endpoints
List<Endpoint
Response> - Endpoints associated with this service. Returned on LookupService.ResolveService. Control plane clients should use RegistrationService.ListEndpoints.
- metadata Map<String,String>
- Optional. Metadata for the service. This data can be consumed by service clients. Restrictions: * The entire metadata dictionary may contain up to 2000 characters, spread accoss all key-value pairs. Metadata that goes beyond this limit are rejected * Valid metadata keys have two segments: an optional prefix and name, separated by a slash (/). The name segment is required and must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between. The prefix is optional. If specified, the prefix must be a DNS subdomain: a series of DNS labels separated by dots (.), not longer than 253 characters in total, followed by a slash (/). Metadata that fails to meet these requirements are rejected Note: This field is equivalent to the
annotations
field in the v1 API. They have the same syntax and read/write to the same location in Service Directory. - name String
- Immutable. The resource name for the service in the format
projects/*/locations/*/namespaces/*/services/*
. - uid String
- A globally unique identifier (in UUID4 format) for this service.
- update
Time String - The timestamp when the service was last updated. Note: endpoints being created/deleted/updated within the service are not considered service updates for the purpose of this timestamp.
- create
Time string - The timestamp when the service was created.
- endpoints
Endpoint
Response[] - Endpoints associated with this service. Returned on LookupService.ResolveService. Control plane clients should use RegistrationService.ListEndpoints.
- metadata {[key: string]: string}
- Optional. Metadata for the service. This data can be consumed by service clients. Restrictions: * The entire metadata dictionary may contain up to 2000 characters, spread accoss all key-value pairs. Metadata that goes beyond this limit are rejected * Valid metadata keys have two segments: an optional prefix and name, separated by a slash (/). The name segment is required and must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between. The prefix is optional. If specified, the prefix must be a DNS subdomain: a series of DNS labels separated by dots (.), not longer than 253 characters in total, followed by a slash (/). Metadata that fails to meet these requirements are rejected Note: This field is equivalent to the
annotations
field in the v1 API. They have the same syntax and read/write to the same location in Service Directory. - name string
- Immutable. The resource name for the service in the format
projects/*/locations/*/namespaces/*/services/*
. - uid string
- A globally unique identifier (in UUID4 format) for this service.
- update
Time string - The timestamp when the service was last updated. Note: endpoints being created/deleted/updated within the service are not considered service updates for the purpose of this timestamp.
- create_
time str - The timestamp when the service was created.
- endpoints
Sequence[Endpoint
Response] - Endpoints associated with this service. Returned on LookupService.ResolveService. Control plane clients should use RegistrationService.ListEndpoints.
- metadata Mapping[str, str]
- Optional. Metadata for the service. This data can be consumed by service clients. Restrictions: * The entire metadata dictionary may contain up to 2000 characters, spread accoss all key-value pairs. Metadata that goes beyond this limit are rejected * Valid metadata keys have two segments: an optional prefix and name, separated by a slash (/). The name segment is required and must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between. The prefix is optional. If specified, the prefix must be a DNS subdomain: a series of DNS labels separated by dots (.), not longer than 253 characters in total, followed by a slash (/). Metadata that fails to meet these requirements are rejected Note: This field is equivalent to the
annotations
field in the v1 API. They have the same syntax and read/write to the same location in Service Directory. - name str
- Immutable. The resource name for the service in the format
projects/*/locations/*/namespaces/*/services/*
. - uid str
- A globally unique identifier (in UUID4 format) for this service.
- update_
time str - The timestamp when the service was last updated. Note: endpoints being created/deleted/updated within the service are not considered service updates for the purpose of this timestamp.
- create
Time String - The timestamp when the service was created.
- endpoints List<Property Map>
- Endpoints associated with this service. Returned on LookupService.ResolveService. Control plane clients should use RegistrationService.ListEndpoints.
- metadata Map<String>
- Optional. Metadata for the service. This data can be consumed by service clients. Restrictions: * The entire metadata dictionary may contain up to 2000 characters, spread accoss all key-value pairs. Metadata that goes beyond this limit are rejected * Valid metadata keys have two segments: an optional prefix and name, separated by a slash (/). The name segment is required and must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between. The prefix is optional. If specified, the prefix must be a DNS subdomain: a series of DNS labels separated by dots (.), not longer than 253 characters in total, followed by a slash (/). Metadata that fails to meet these requirements are rejected Note: This field is equivalent to the
annotations
field in the v1 API. They have the same syntax and read/write to the same location in Service Directory. - name String
- Immutable. The resource name for the service in the format
projects/*/locations/*/namespaces/*/services/*
. - uid String
- A globally unique identifier (in UUID4 format) for this service.
- update
Time String - The timestamp when the service was last updated. Note: endpoints being created/deleted/updated within the service are not considered service updates for the purpose of this timestamp.
Supporting Types
EndpointResponse
- Address string
- Optional. An IPv4 or IPv6 address. Service Directory rejects bad addresses like: *
8.8.8
*8.8.8.8:53
*test:bad:address
*[::1]
*[::1]:8080
Limited to 45 characters. - Create
Time string - The timestamp when the endpoint was created.
- Metadata Dictionary<string, string>
- Optional. Metadata for the endpoint. This data can be consumed by service clients. Restrictions: * The entire metadata dictionary may contain up to 512 characters, spread accoss all key-value pairs. Metadata that goes beyond this limit are rejected * Valid metadata keys have two segments: an optional prefix and name, separated by a slash (/). The name segment is required and must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between. The prefix is optional. If specified, the prefix must be a DNS subdomain: a series of DNS labels separated by dots (.), not longer than 253 characters in total, followed by a slash (/). Metadata that fails to meet these requirements are rejected Note: This field is equivalent to the
annotations
field in the v1 API. They have the same syntax and read/write to the same location in Service Directory. - Name string
- Immutable. The resource name for the endpoint in the format
projects/*/locations/*/namespaces/*/services/*/endpoints/*
. - Network string
- Immutable. The Google Compute Engine network (VPC) of the endpoint in the format
projects//locations/global/networks/*
. The project must be specified by project number (project id is rejected). Incorrectly formatted networks are rejected, but no other validation is performed on this field (ex. network or project existence, reachability, or permissions). - Port int
- Optional. Service Directory rejects values outside of
[0, 65535]
. - Uid string
- A globally unique identifier (in UUID4 format) for this endpoint.
- Update
Time string - The timestamp when the endpoint was last updated.
- Address string
- Optional. An IPv4 or IPv6 address. Service Directory rejects bad addresses like: *
8.8.8
*8.8.8.8:53
*test:bad:address
*[::1]
*[::1]:8080
Limited to 45 characters. - Create
Time string - The timestamp when the endpoint was created.
- Metadata map[string]string
- Optional. Metadata for the endpoint. This data can be consumed by service clients. Restrictions: * The entire metadata dictionary may contain up to 512 characters, spread accoss all key-value pairs. Metadata that goes beyond this limit are rejected * Valid metadata keys have two segments: an optional prefix and name, separated by a slash (/). The name segment is required and must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between. The prefix is optional. If specified, the prefix must be a DNS subdomain: a series of DNS labels separated by dots (.), not longer than 253 characters in total, followed by a slash (/). Metadata that fails to meet these requirements are rejected Note: This field is equivalent to the
annotations
field in the v1 API. They have the same syntax and read/write to the same location in Service Directory. - Name string
- Immutable. The resource name for the endpoint in the format
projects/*/locations/*/namespaces/*/services/*/endpoints/*
. - Network string
- Immutable. The Google Compute Engine network (VPC) of the endpoint in the format
projects//locations/global/networks/*
. The project must be specified by project number (project id is rejected). Incorrectly formatted networks are rejected, but no other validation is performed on this field (ex. network or project existence, reachability, or permissions). - Port int
- Optional. Service Directory rejects values outside of
[0, 65535]
. - Uid string
- A globally unique identifier (in UUID4 format) for this endpoint.
- Update
Time string - The timestamp when the endpoint was last updated.
- address String
- Optional. An IPv4 or IPv6 address. Service Directory rejects bad addresses like: *
8.8.8
*8.8.8.8:53
*test:bad:address
*[::1]
*[::1]:8080
Limited to 45 characters. - create
Time String - The timestamp when the endpoint was created.
- metadata Map<String,String>
- Optional. Metadata for the endpoint. This data can be consumed by service clients. Restrictions: * The entire metadata dictionary may contain up to 512 characters, spread accoss all key-value pairs. Metadata that goes beyond this limit are rejected * Valid metadata keys have two segments: an optional prefix and name, separated by a slash (/). The name segment is required and must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between. The prefix is optional. If specified, the prefix must be a DNS subdomain: a series of DNS labels separated by dots (.), not longer than 253 characters in total, followed by a slash (/). Metadata that fails to meet these requirements are rejected Note: This field is equivalent to the
annotations
field in the v1 API. They have the same syntax and read/write to the same location in Service Directory. - name String
- Immutable. The resource name for the endpoint in the format
projects/*/locations/*/namespaces/*/services/*/endpoints/*
. - network String
- Immutable. The Google Compute Engine network (VPC) of the endpoint in the format
projects//locations/global/networks/*
. The project must be specified by project number (project id is rejected). Incorrectly formatted networks are rejected, but no other validation is performed on this field (ex. network or project existence, reachability, or permissions). - port Integer
- Optional. Service Directory rejects values outside of
[0, 65535]
. - uid String
- A globally unique identifier (in UUID4 format) for this endpoint.
- update
Time String - The timestamp when the endpoint was last updated.
- address string
- Optional. An IPv4 or IPv6 address. Service Directory rejects bad addresses like: *
8.8.8
*8.8.8.8:53
*test:bad:address
*[::1]
*[::1]:8080
Limited to 45 characters. - create
Time string - The timestamp when the endpoint was created.
- metadata {[key: string]: string}
- Optional. Metadata for the endpoint. This data can be consumed by service clients. Restrictions: * The entire metadata dictionary may contain up to 512 characters, spread accoss all key-value pairs. Metadata that goes beyond this limit are rejected * Valid metadata keys have two segments: an optional prefix and name, separated by a slash (/). The name segment is required and must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between. The prefix is optional. If specified, the prefix must be a DNS subdomain: a series of DNS labels separated by dots (.), not longer than 253 characters in total, followed by a slash (/). Metadata that fails to meet these requirements are rejected Note: This field is equivalent to the
annotations
field in the v1 API. They have the same syntax and read/write to the same location in Service Directory. - name string
- Immutable. The resource name for the endpoint in the format
projects/*/locations/*/namespaces/*/services/*/endpoints/*
. - network string
- Immutable. The Google Compute Engine network (VPC) of the endpoint in the format
projects//locations/global/networks/*
. The project must be specified by project number (project id is rejected). Incorrectly formatted networks are rejected, but no other validation is performed on this field (ex. network or project existence, reachability, or permissions). - port number
- Optional. Service Directory rejects values outside of
[0, 65535]
. - uid string
- A globally unique identifier (in UUID4 format) for this endpoint.
- update
Time string - The timestamp when the endpoint was last updated.
- address str
- Optional. An IPv4 or IPv6 address. Service Directory rejects bad addresses like: *
8.8.8
*8.8.8.8:53
*test:bad:address
*[::1]
*[::1]:8080
Limited to 45 characters. - create_
time str - The timestamp when the endpoint was created.
- metadata Mapping[str, str]
- Optional. Metadata for the endpoint. This data can be consumed by service clients. Restrictions: * The entire metadata dictionary may contain up to 512 characters, spread accoss all key-value pairs. Metadata that goes beyond this limit are rejected * Valid metadata keys have two segments: an optional prefix and name, separated by a slash (/). The name segment is required and must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between. The prefix is optional. If specified, the prefix must be a DNS subdomain: a series of DNS labels separated by dots (.), not longer than 253 characters in total, followed by a slash (/). Metadata that fails to meet these requirements are rejected Note: This field is equivalent to the
annotations
field in the v1 API. They have the same syntax and read/write to the same location in Service Directory. - name str
- Immutable. The resource name for the endpoint in the format
projects/*/locations/*/namespaces/*/services/*/endpoints/*
. - network str
- Immutable. The Google Compute Engine network (VPC) of the endpoint in the format
projects//locations/global/networks/*
. The project must be specified by project number (project id is rejected). Incorrectly formatted networks are rejected, but no other validation is performed on this field (ex. network or project existence, reachability, or permissions). - port int
- Optional. Service Directory rejects values outside of
[0, 65535]
. - uid str
- A globally unique identifier (in UUID4 format) for this endpoint.
- update_
time str - The timestamp when the endpoint was last updated.
- address String
- Optional. An IPv4 or IPv6 address. Service Directory rejects bad addresses like: *
8.8.8
*8.8.8.8:53
*test:bad:address
*[::1]
*[::1]:8080
Limited to 45 characters. - create
Time String - The timestamp when the endpoint was created.
- metadata Map<String>
- Optional. Metadata for the endpoint. This data can be consumed by service clients. Restrictions: * The entire metadata dictionary may contain up to 512 characters, spread accoss all key-value pairs. Metadata that goes beyond this limit are rejected * Valid metadata keys have two segments: an optional prefix and name, separated by a slash (/). The name segment is required and must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between. The prefix is optional. If specified, the prefix must be a DNS subdomain: a series of DNS labels separated by dots (.), not longer than 253 characters in total, followed by a slash (/). Metadata that fails to meet these requirements are rejected Note: This field is equivalent to the
annotations
field in the v1 API. They have the same syntax and read/write to the same location in Service Directory. - name String
- Immutable. The resource name for the endpoint in the format
projects/*/locations/*/namespaces/*/services/*/endpoints/*
. - network String
- Immutable. The Google Compute Engine network (VPC) of the endpoint in the format
projects//locations/global/networks/*
. The project must be specified by project number (project id is rejected). Incorrectly formatted networks are rejected, but no other validation is performed on this field (ex. network or project existence, reachability, or permissions). - port Number
- Optional. Service Directory rejects values outside of
[0, 65535]
. - uid String
- A globally unique identifier (in UUID4 format) for this endpoint.
- update
Time String - The timestamp when the endpoint was last updated.
Package Details
- Repository
- Google Cloud Native pulumi/pulumi-google-native
- License
- Apache-2.0
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