## Index

- `AppHub` (interface)
- `Application` (message)
- `Application.State` (enum)
- `Attributes` (message)
- `Boundary` (message)
- `Boundary.Type` (enum)
- `Channel` (message)
- `ContactInfo` (message)
- `CreateApplicationRequest` (message)
- `CreateServiceProjectAttachmentRequest` (message)
- `CreateServiceRequest` (message)
- `CreateWorkloadRequest` (message)
- `Criticality` (message)
- `Criticality.Type` (enum)
- `DeleteApplicationRequest` (message)
- `DeleteServiceProjectAttachmentRequest` (message)
- `DeleteServiceRequest` (message)
- `DeleteWorkloadRequest` (message)
- `DetachServiceProjectAttachmentRequest` (message)
- `DetachServiceProjectAttachmentResponse` (message)
- `DiscoveredService` (message)
- `DiscoveredWorkload` (message)
- `Environment` (message)
- `Environment.Type` (enum)
- `ExtendedMetadata` (message)
- `ExtendedMetadataSchema` (message)
- `FindUnregisteredServicesRequest` (message)
- `FindUnregisteredServicesResponse` (message)
- `FindUnregisteredWorkloadsRequest` (message)
- `FindUnregisteredWorkloadsResponse` (message)
- `FunctionalType` (message)
- `FunctionalType.Type` (enum)
- `GetApplicationRequest` (message)
- `GetBoundaryRequest` (message)
- `GetDiscoveredServiceRequest` (message)
- `GetDiscoveredWorkloadRequest` (message)
- `GetExtendedMetadataSchemaRequest` (message)
- `GetServiceProjectAttachmentRequest` (message)
- `GetServiceRequest` (message)
- `GetWorkloadRequest` (message)
- `Identity` (message)
- `ListApplicationsRequest` (message)
- `ListApplicationsResponse` (message)
- `ListDiscoveredServicesRequest` (message)
- `ListDiscoveredServicesResponse` (message)
- `ListDiscoveredWorkloadsRequest` (message)
- `ListDiscoveredWorkloadsResponse` (message)
- `ListExtendedMetadataSchemasRequest` (message)
- `ListExtendedMetadataSchemasResponse` (message)
- `ListServiceProjectAttachmentsRequest` (message)
- `ListServiceProjectAttachmentsResponse` (message)
- `ListServicesRequest` (message)
- `ListServicesResponse` (message)
- `ListWorkloadsRequest` (message)
- `ListWorkloadsResponse` (message)
- `LookupDiscoveredServiceRequest` (message)
- `LookupDiscoveredServiceResponse` (message)
- `LookupDiscoveredWorkloadRequest` (message)
- `LookupDiscoveredWorkloadResponse` (message)
- `LookupServiceProjectAttachmentRequest` (message)
- `LookupServiceProjectAttachmentResponse` (message)
- `OperationMetadata` (message)
- `RegistrationType` (message)
- `RegistrationType.Type` (enum)
- `Scope` (message)
- `Scope.Type` (enum)
- `Service` (message)
- `Service.State` (enum)
- `ServiceProjectAttachment` (message)
- `ServiceProjectAttachment.State` (enum)
- `ServiceProperties` (message)
- `ServiceReference` (message)
- `UpdateApplicationRequest` (message)
- `UpdateBoundaryRequest` (message)
- `UpdateServiceRequest` (message)
- `UpdateWorkloadRequest` (message)
- `Workload` (message)
- `Workload.State` (enum)
- `WorkloadProperties` (message)
- `WorkloadReference` (message)

## AppHub

The App Hub API allows you to manage App Hub resources.

| CreateApplication |
|---|
| `` rpc CreateApplication(`CreateApplicationRequest`) returns (`Operation`) `` Creates an Application in a host project and location. Authorization scopes :   Requires the following OAuth scope: - `https://www.googleapis.com/auth/cloud-platform` For more information, see the [Authentication Overview](https://docs.cloud.google.com/docs/authentication.md.txt#authorization-gcp). IAM Permissions :   Requires the following [IAM](https://cloud.google.com/iam/docs) permission on the `parent` resource: - `apphub.applications.create` For more information, see the [IAM documentation](https://cloud.google.com/iam/docs). |

| CreateService |
|---|
| `` rpc CreateService(`CreateServiceRequest`) returns (`Operation`) `` Creates a Service in an Application. Authorization scopes :   Requires the following OAuth scope: - `https://www.googleapis.com/auth/cloud-platform` For more information, see the [Authentication Overview](https://docs.cloud.google.com/docs/authentication.md.txt#authorization-gcp). IAM Permissions :   Requires the following [IAM](https://cloud.google.com/iam/docs) permission on the `parent` resource: - `apphub.services.create` Requires the following [IAM](https://cloud.google.com/iam/docs) permission on the `discoveredService` resource: - `apphub.discoveredServices.register` For more information, see the [IAM documentation](https://cloud.google.com/iam/docs). |

| CreateServiceProjectAttachment |
|---|
| `` rpc CreateServiceProjectAttachment(`CreateServiceProjectAttachmentRequest`) returns (`Operation`) `` Attaches a service project to the host project. Authorization scopes :   Requires the following OAuth scope: - `https://www.googleapis.com/auth/cloud-platform` For more information, see the [Authentication Overview](https://docs.cloud.google.com/docs/authentication.md.txt#authorization-gcp). IAM Permissions :   Requires the following [IAM](https://cloud.google.com/iam/docs) permission on the `parent` resource: - `apphub.serviceProjectAttachments.create` Requires the following [IAM](https://cloud.google.com/iam/docs) permission on the `serviceProject` resource: - `apphub.serviceProjectAttachments.attach` For more information, see the [IAM documentation](https://cloud.google.com/iam/docs). |

| CreateWorkload |
|---|
| `` rpc CreateWorkload(`CreateWorkloadRequest`) returns (`Operation`) `` Creates a Workload in an Application. Authorization scopes :   Requires the following OAuth scope: - `https://www.googleapis.com/auth/cloud-platform` For more information, see the [Authentication Overview](https://docs.cloud.google.com/docs/authentication.md.txt#authorization-gcp). IAM Permissions :   Requires the following [IAM](https://cloud.google.com/iam/docs) permission on the `parent` resource: - `apphub.workloads.create` Requires the following [IAM](https://cloud.google.com/iam/docs) permission on the `discoveredWorkload` resource: - `apphub.discoveredWorkloads.register` For more information, see the [IAM documentation](https://cloud.google.com/iam/docs). |

| DeleteApplication |
|---|
| `` rpc DeleteApplication(`DeleteApplicationRequest`) returns (`Operation`) `` Deletes an Application in a host project and location. Authorization scopes :   Requires the following OAuth scope: - `https://www.googleapis.com/auth/cloud-platform` For more information, see the [Authentication Overview](https://docs.cloud.google.com/docs/authentication.md.txt#authorization-gcp). IAM Permissions :   Requires the following [IAM](https://cloud.google.com/iam/docs) permission on the `name` resource: - `apphub.applications.delete` For more information, see the [IAM documentation](https://cloud.google.com/iam/docs). |

| DeleteService |
|---|
| `` rpc DeleteService(`DeleteServiceRequest`) returns (`Operation`) `` Deletes a Service from an Application. Authorization scopes :   Requires the following OAuth scope: - `https://www.googleapis.com/auth/cloud-platform` For more information, see the [Authentication Overview](https://docs.cloud.google.com/docs/authentication.md.txt#authorization-gcp). IAM Permissions :   Requires the following [IAM](https://cloud.google.com/iam/docs) permission on the `name` resource: - `apphub.services.delete` For more information, see the [IAM documentation](https://cloud.google.com/iam/docs). |

| DeleteServiceProjectAttachment |
|---|
| `` rpc DeleteServiceProjectAttachment(`DeleteServiceProjectAttachmentRequest`) returns (`Operation`) `` Deletes a service project attachment. Authorization scopes :   Requires the following OAuth scope: - `https://www.googleapis.com/auth/cloud-platform` For more information, see the [Authentication Overview](https://docs.cloud.google.com/docs/authentication.md.txt#authorization-gcp). IAM Permissions :   Requires the following [IAM](https://cloud.google.com/iam/docs) permission on the `name` resource: - `apphub.serviceProjectAttachments.delete` For more information, see the [IAM documentation](https://cloud.google.com/iam/docs). |

| DeleteWorkload |
|---|
| `` rpc DeleteWorkload(`DeleteWorkloadRequest`) returns (`Operation`) `` Deletes a Workload from an Application. Authorization scopes :   Requires the following OAuth scope: - `https://www.googleapis.com/auth/cloud-platform` For more information, see the [Authentication Overview](https://docs.cloud.google.com/docs/authentication.md.txt#authorization-gcp). IAM Permissions :   Requires the following [IAM](https://cloud.google.com/iam/docs) permission on the `name` resource: - `apphub.workloads.delete` For more information, see the [IAM documentation](https://cloud.google.com/iam/docs). |

| DetachServiceProjectAttachment |
|---|
| `` rpc DetachServiceProjectAttachment(`DetachServiceProjectAttachmentRequest`) returns (`DetachServiceProjectAttachmentResponse`) `` Detaches a service project from a host project. You can call this API from any service project without needing access to the host project that it is attached to. Authorization scopes :   Requires the following OAuth scope: - `https://www.googleapis.com/auth/cloud-platform` For more information, see the [Authentication Overview](https://docs.cloud.google.com/docs/authentication.md.txt#authorization-gcp). IAM Permissions :   Requires the following [IAM](https://cloud.google.com/iam/docs) permission on the `name` resource: - `apphub.serviceProjectAttachments.detach` For more information, see the [IAM documentation](https://cloud.google.com/iam/docs). |

| FindUnregisteredServices |
|---|
| `` rpc FindUnregisteredServices(`FindUnregisteredServicesRequest`) returns (`FindUnregisteredServicesResponse`) `` Finds unregistered services in a host project and location. Authorization scopes :   Requires the following OAuth scope: - `https://www.googleapis.com/auth/cloud-platform` For more information, see the [Authentication Overview](https://docs.cloud.google.com/docs/authentication.md.txt#authorization-gcp). IAM Permissions :   Requires the following [IAM](https://cloud.google.com/iam/docs) permission on the `parent` resource: - `apphub.discoveredServices.list` For more information, see the [IAM documentation](https://cloud.google.com/iam/docs). |

| FindUnregisteredWorkloads |
|---|
| `` rpc FindUnregisteredWorkloads(`FindUnregisteredWorkloadsRequest`) returns (`FindUnregisteredWorkloadsResponse`) `` Finds unregistered workloads in a host project and location. Authorization scopes :   Requires the following OAuth scope: - `https://www.googleapis.com/auth/cloud-platform` For more information, see the [Authentication Overview](https://docs.cloud.google.com/docs/authentication.md.txt#authorization-gcp). IAM Permissions :   Requires the following [IAM](https://cloud.google.com/iam/docs) permission on the `parent` resource: - `apphub.discoveredWorkloads.list` For more information, see the [IAM documentation](https://cloud.google.com/iam/docs). |

| GetApplication |
|---|
| `` rpc GetApplication(`GetApplicationRequest`) returns (`Application`) `` Gets an Application in a host project and location. Authorization scopes :   Requires the following OAuth scope: - `https://www.googleapis.com/auth/cloud-platform` For more information, see the [Authentication Overview](https://docs.cloud.google.com/docs/authentication.md.txt#authorization-gcp). IAM Permissions :   Requires the following [IAM](https://cloud.google.com/iam/docs) permission on the `name` resource: - `apphub.applications.get` For more information, see the [IAM documentation](https://cloud.google.com/iam/docs). |

| GetBoundary |
|---|
| `` rpc GetBoundary(`GetBoundaryRequest`) returns (`Boundary`) `` Gets a Boundary. Authorization scopes :   Requires the following OAuth scope: - `https://www.googleapis.com/auth/cloud-platform` For more information, see the [Authentication Overview](https://docs.cloud.google.com/docs/authentication.md.txt#authorization-gcp). IAM Permissions :   Requires the following [IAM](https://cloud.google.com/iam/docs) permission on the `name` resource: - `apphub.boundaries.get` For more information, see the [IAM documentation](https://cloud.google.com/iam/docs). |

| GetDiscoveredService |
|---|
| `` rpc GetDiscoveredService(`GetDiscoveredServiceRequest`) returns (`DiscoveredService`) `` Gets a Discovered Service in a host project and location. Authorization scopes :   Requires the following OAuth scope: - `https://www.googleapis.com/auth/cloud-platform` For more information, see the [Authentication Overview](https://docs.cloud.google.com/docs/authentication.md.txt#authorization-gcp). IAM Permissions :   Requires the following [IAM](https://cloud.google.com/iam/docs) permission on the `name` resource: - `apphub.discoveredServices.get` For more information, see the [IAM documentation](https://cloud.google.com/iam/docs). |

| GetDiscoveredWorkload |
|---|
| `` rpc GetDiscoveredWorkload(`GetDiscoveredWorkloadRequest`) returns (`DiscoveredWorkload`) `` Gets a Discovered Workload in a host project and location. Authorization scopes :   Requires the following OAuth scope: - `https://www.googleapis.com/auth/cloud-platform` For more information, see the [Authentication Overview](https://docs.cloud.google.com/docs/authentication.md.txt#authorization-gcp). IAM Permissions :   Requires the following [IAM](https://cloud.google.com/iam/docs) permission on the `name` resource: - `apphub.discoveredWorkloads.get` For more information, see the [IAM documentation](https://cloud.google.com/iam/docs). |

| GetExtendedMetadataSchema |
|---|
| `` rpc GetExtendedMetadataSchema(`GetExtendedMetadataSchemaRequest`) returns (`ExtendedMetadataSchema`) `` Gets an Extended Metadata Schema. Authorization scopes :   Requires the following OAuth scope: - `https://www.googleapis.com/auth/cloud-platform` For more information, see the [Authentication Overview](https://docs.cloud.google.com/docs/authentication.md.txt#authorization-gcp). IAM Permissions :   Requires the following [IAM](https://cloud.google.com/iam/docs) permission on the `name` resource: - `apphub.extendedMetadataSchemas.get` For more information, see the [IAM documentation](https://cloud.google.com/iam/docs). |

| GetService |
|---|
| `` rpc GetService(`GetServiceRequest`) returns (`Service`) `` Gets a Service in an Application. Authorization scopes :   Requires the following OAuth scope: - `https://www.googleapis.com/auth/cloud-platform` For more information, see the [Authentication Overview](https://docs.cloud.google.com/docs/authentication.md.txt#authorization-gcp). IAM Permissions :   Requires the following [IAM](https://cloud.google.com/iam/docs) permission on the `name` resource: - `apphub.services.get` For more information, see the [IAM documentation](https://cloud.google.com/iam/docs). |

| GetServiceProjectAttachment |
|---|
| `` rpc GetServiceProjectAttachment(`GetServiceProjectAttachmentRequest`) returns (`ServiceProjectAttachment`) `` Gets a service project attachment. Authorization scopes :   Requires the following OAuth scope: - `https://www.googleapis.com/auth/cloud-platform` For more information, see the [Authentication Overview](https://docs.cloud.google.com/docs/authentication.md.txt#authorization-gcp). IAM Permissions :   Requires the following [IAM](https://cloud.google.com/iam/docs) permission on the `name` resource: - `apphub.serviceProjectAttachments.get` For more information, see the [IAM documentation](https://cloud.google.com/iam/docs). |

| GetWorkload |
|---|
| `` rpc GetWorkload(`GetWorkloadRequest`) returns (`Workload`) `` Gets a Workload in an Application. Authorization scopes :   Requires the following OAuth scope: - `https://www.googleapis.com/auth/cloud-platform` For more information, see the [Authentication Overview](https://docs.cloud.google.com/docs/authentication.md.txt#authorization-gcp). IAM Permissions :   Requires the following [IAM](https://cloud.google.com/iam/docs) permission on the `name` resource: - `apphub.workloads.get` For more information, see the [IAM documentation](https://cloud.google.com/iam/docs). |

| ListApplications |
|---|
| `` rpc ListApplications(`ListApplicationsRequest`) returns (`ListApplicationsResponse`) `` Lists Applications in a host project and location. Authorization scopes :   Requires the following OAuth scope: - `https://www.googleapis.com/auth/cloud-platform` For more information, see the [Authentication Overview](https://docs.cloud.google.com/docs/authentication.md.txt#authorization-gcp). IAM Permissions :   Requires the following [IAM](https://cloud.google.com/iam/docs) permission on the `parent` resource: - `apphub.applications.list` For more information, see the [IAM documentation](https://cloud.google.com/iam/docs). |

| ListDiscoveredServices |
|---|
| `` rpc ListDiscoveredServices(`ListDiscoveredServicesRequest`) returns (`ListDiscoveredServicesResponse`) `` Lists Discovered Services that can be added to an Application in a host project and location. Authorization scopes :   Requires the following OAuth scope: - `https://www.googleapis.com/auth/cloud-platform` For more information, see the [Authentication Overview](https://docs.cloud.google.com/docs/authentication.md.txt#authorization-gcp). IAM Permissions :   Requires the following [IAM](https://cloud.google.com/iam/docs) permission on the `parent` resource: - `apphub.discoveredServices.list` For more information, see the [IAM documentation](https://cloud.google.com/iam/docs). |

| ListDiscoveredWorkloads |
|---|
| `` rpc ListDiscoveredWorkloads(`ListDiscoveredWorkloadsRequest`) returns (`ListDiscoveredWorkloadsResponse`) `` Lists Discovered Workloads that can be added to an Application in a host project and location. Authorization scopes :   Requires the following OAuth scope: - `https://www.googleapis.com/auth/cloud-platform` For more information, see the [Authentication Overview](https://docs.cloud.google.com/docs/authentication.md.txt#authorization-gcp). IAM Permissions :   Requires the following [IAM](https://cloud.google.com/iam/docs) permission on the `parent` resource: - `apphub.discoveredWorkloads.list` For more information, see the [IAM documentation](https://cloud.google.com/iam/docs). |

| ListExtendedMetadataSchemas |
|---|
| `` rpc ListExtendedMetadataSchemas(`ListExtendedMetadataSchemasRequest`) returns (`ListExtendedMetadataSchemasResponse`) `` Lists Extended Metadata Schemas available in a host project and location. Authorization scopes :   Requires the following OAuth scope: - `https://www.googleapis.com/auth/cloud-platform` For more information, see the [Authentication Overview](https://docs.cloud.google.com/docs/authentication.md.txt#authorization-gcp). IAM Permissions :   Requires the following [IAM](https://cloud.google.com/iam/docs) permission on the `parent` resource: - `apphub.extendedMetadataSchemas.list` For more information, see the [IAM documentation](https://cloud.google.com/iam/docs). |

| ListServiceProjectAttachments |
|---|
| `` rpc ListServiceProjectAttachments(`ListServiceProjectAttachmentsRequest`) returns (`ListServiceProjectAttachmentsResponse`) `` Lists service projects attached to the host project. Authorization scopes :   Requires the following OAuth scope: - `https://www.googleapis.com/auth/cloud-platform` For more information, see the [Authentication Overview](https://docs.cloud.google.com/docs/authentication.md.txt#authorization-gcp). IAM Permissions :   Requires the following [IAM](https://cloud.google.com/iam/docs) permission on the `parent` resource: - `apphub.serviceProjectAttachments.list` For more information, see the [IAM documentation](https://cloud.google.com/iam/docs). |

| ListServices |
|---|
| `` rpc ListServices(`ListServicesRequest`) returns (`ListServicesResponse`) `` Lists Services in an Application. Authorization scopes :   Requires the following OAuth scope: - `https://www.googleapis.com/auth/cloud-platform` For more information, see the [Authentication Overview](https://docs.cloud.google.com/docs/authentication.md.txt#authorization-gcp). IAM Permissions :   Requires the following [IAM](https://cloud.google.com/iam/docs) permission on the `parent` resource: - `apphub.services.list` For more information, see the [IAM documentation](https://cloud.google.com/iam/docs). |

| ListWorkloads |
|---|
| `` rpc ListWorkloads(`ListWorkloadsRequest`) returns (`ListWorkloadsResponse`) `` Lists Workloads in an Application. Authorization scopes :   Requires the following OAuth scope: - `https://www.googleapis.com/auth/cloud-platform` For more information, see the [Authentication Overview](https://docs.cloud.google.com/docs/authentication.md.txt#authorization-gcp). IAM Permissions :   Requires the following [IAM](https://cloud.google.com/iam/docs) permission on the `parent` resource: - `apphub.workloads.list` For more information, see the [IAM documentation](https://cloud.google.com/iam/docs). |

| LookupDiscoveredService |
|---|
| `` rpc LookupDiscoveredService(`LookupDiscoveredServiceRequest`) returns (`LookupDiscoveredServiceResponse`) `` Lists a Discovered Service in a host project and location, with a given resource URI. Authorization scopes :   Requires the following OAuth scope: - `https://www.googleapis.com/auth/cloud-platform` For more information, see the [Authentication Overview](https://docs.cloud.google.com/docs/authentication.md.txt#authorization-gcp). IAM Permissions :   Requires the following [IAM](https://cloud.google.com/iam/docs) permission on the `parent` resource: - `apphub.discoveredServices.list` For more information, see the [IAM documentation](https://cloud.google.com/iam/docs). |

| LookupDiscoveredWorkload |
|---|
| `` rpc LookupDiscoveredWorkload(`LookupDiscoveredWorkloadRequest`) returns (`LookupDiscoveredWorkloadResponse`) `` Lists a Discovered Workload in a host project and location, with a given resource URI. Authorization scopes :   Requires the following OAuth scope: - `https://www.googleapis.com/auth/cloud-platform` For more information, see the [Authentication Overview](https://docs.cloud.google.com/docs/authentication.md.txt#authorization-gcp). IAM Permissions :   Requires the following [IAM](https://cloud.google.com/iam/docs) permission on the `parent` resource: - `apphub.discoveredWorkloads.list` For more information, see the [IAM documentation](https://cloud.google.com/iam/docs). |

| LookupServiceProjectAttachment |
|---|
| `` rpc LookupServiceProjectAttachment(`LookupServiceProjectAttachmentRequest`) returns (`LookupServiceProjectAttachmentResponse`) `` Lists a service project attachment for a given service project. You can call this API from any project to find if it is attached to a host project. Authorization scopes :   Requires the following OAuth scope: - `https://www.googleapis.com/auth/cloud-platform` For more information, see the [Authentication Overview](https://docs.cloud.google.com/docs/authentication.md.txt#authorization-gcp). IAM Permissions :   Requires the following [IAM](https://cloud.google.com/iam/docs) permission on the `name` resource: - `apphub.serviceProjectAttachments.lookup` For more information, see the [IAM documentation](https://cloud.google.com/iam/docs). |

| UpdateApplication |
|---|
| `` rpc UpdateApplication(`UpdateApplicationRequest`) returns (`Operation`) `` Updates an Application in a host project and location. Authorization scopes :   Requires the following OAuth scope: - `https://www.googleapis.com/auth/cloud-platform` For more information, see the [Authentication Overview](https://docs.cloud.google.com/docs/authentication.md.txt#authorization-gcp). IAM Permissions :   Requires the following [IAM](https://cloud.google.com/iam/docs) permission on the `name` resource: - `apphub.applications.update` For more information, see the [IAM documentation](https://cloud.google.com/iam/docs). |

| UpdateBoundary |
|---|
| `` rpc UpdateBoundary(`UpdateBoundaryRequest`) returns (`Operation`) `` Updates a Boundary. Authorization scopes :   Requires the following OAuth scope: - `https://www.googleapis.com/auth/cloud-platform` For more information, see the [Authentication Overview](https://docs.cloud.google.com/docs/authentication.md.txt#authorization-gcp). IAM Permissions :   Requires the following [IAM](https://cloud.google.com/iam/docs) permission on the `crmNode` resource: - `apphub.boundaries.attach` Requires the following [IAM](https://cloud.google.com/iam/docs) permission on the `name` resource: - `apphub.boundaries.update` For more information, see the [IAM documentation](https://cloud.google.com/iam/docs). |

| UpdateService |
|---|
| `` rpc UpdateService(`UpdateServiceRequest`) returns (`Operation`) `` Updates a Service in an Application. Authorization scopes :   Requires the following OAuth scope: - `https://www.googleapis.com/auth/cloud-platform` For more information, see the [Authentication Overview](https://docs.cloud.google.com/docs/authentication.md.txt#authorization-gcp). IAM Permissions :   Requires the following [IAM](https://cloud.google.com/iam/docs) permission on the `name` resource: - `apphub.services.update` For more information, see the [IAM documentation](https://cloud.google.com/iam/docs). |

| UpdateWorkload |
|---|
| `` rpc UpdateWorkload(`UpdateWorkloadRequest`) returns (`Operation`) `` Updates a Workload in an Application. Authorization scopes :   Requires the following OAuth scope: - `https://www.googleapis.com/auth/cloud-platform` For more information, see the [Authentication Overview](https://docs.cloud.google.com/docs/authentication.md.txt#authorization-gcp). IAM Permissions :   Requires the following [IAM](https://cloud.google.com/iam/docs) permission on the `name` resource: - `apphub.workloads.update` For more information, see the [IAM documentation](https://cloud.google.com/iam/docs). |

## Application

Application defines the governance boundary for App Hub entities that perform a logical end-to-end business function. App Hub supports application level IAM permission to align with governance requirements.

| Fields ||
|---|---|
| `name` | `string` Identifier. The resource name of an Application. Format: `"projects/{host-project-id}/locations/{location}/applications/{application-id}"` |
| `display_name` | `string` Optional. User-defined name for the Application. Can have a maximum length of 63 characters. |
| `description` | `string` Optional. User-defined description of an Application. Can have a maximum length of 2048 characters. |
| `attributes` | `Attributes` Optional. Consumer provided attributes. |
| `create_time` | `Timestamp` Output only. Create time. |
| `update_time` | `Timestamp` Output only. Update time. |
| `scope` | `Scope` Required. Immutable. Defines what data can be included into this Application. Limits which Services and Workloads can be registered. |
| `uid` | `string` Output only. A universally unique identifier (in UUID4 format) for the `Application`. |
| `state` | `State` Output only. Application state. |

## State

Application state.

| Enums ||
|---|---|
| `STATE_UNSPECIFIED` | Unspecified state. |
| `CREATING` | The Application is being created. |
| `ACTIVE` | The Application is ready to register Services and Workloads. |
| `DELETING` | The Application is being deleted. |

## Attributes

Consumer provided attributes.

| Fields ||
|---|---|
| `criticality` | `Criticality` Optional. User-defined criticality information. |
| `environment` | `Environment` Optional. User-defined environment information. |
| `developer_owners[]` | `ContactInfo` Optional. Developer team that owns development and coding. |
| `operator_owners[]` | `ContactInfo` Optional. Operator team that ensures runtime and operations. |
| `business_owners[]` | `ContactInfo` Optional. Business team that ensures user needs are met and value is delivered |

## Boundary

Application management boundary.

| Fields ||
|---|---|
| `name` | `string` Identifier. The resource name of the boundary. Format: "projects/{project}/locations/{location}/boundary" |
| `create_time` | `Timestamp` Output only. Create time. |
| `update_time` | `Timestamp` Output only. Update time. |
| `type` | `Type` Output only. Boundary type. |
| Union field `scope`. The scope defining the boundary. `scope` can be only one of the following: ||
| `crm_node` | `string` Optional. The resource name of the CRM node being attached to the boundary. Format: `projects/{project-number}` or `projects/{project-id}` |

## Type

Boundary management type.

| Enums ||
|---|---|
| `TYPE_UNSPECIFIED` | Unspecified type. |
| `AUTOMATIC` | The Boundary automatically includes all descendants of the CRM node. |
| `MANUAL` | The list of projects within the Boundary is managed by the user. |
| `MANAGED_AUTOMATIC` | The Boundary automatically includes all descendants of the CRM node, which is set via App Management folder capability. |

## Channel

Separate message to accommodate custom formats across IRC and Slack.

| Fields ||
|---|---|
| `uri` | `string` Required. URI of the channel. |

## ContactInfo

Contact information of stakeholders.

| Fields ||
|---|---|
| `display_name` | `string` Optional. Contact's name. Can have a maximum length of 63 characters. |
| `email` | `string` Required. Email address of the contacts. |
| `channel` | `Channel` Optional. Communication channel of the contacts. |

## CreateApplicationRequest

Request for CreateApplication.

| Fields ||
|---|---|
| `parent` | `string` Required. Project and location to create Application in. Expected format: `projects/{project}/locations/{location}`. |
| `application_id` | `string` Required. The Application identifier. Must contain only lowercase letters, numbers or hyphens, with the first character a letter, the last a letter or a number, and a 63 character maximum. |
| `application` | `Application` Required. The resource being created |
| `request_id` | `string` Optional. 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. The server will guarantee that for at least 60 minutes since the first request. 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). |

## CreateServiceProjectAttachmentRequest

Request for CreateServiceProjectAttachment.

| Fields ||
|---|---|
| `parent` | `string` Required. Host project ID and location to which service project is being attached. Only global location is supported. Expected format: `projects/{project}/locations/{location}`. |
| `service_project_attachment_id` | `string` Required. The service project attachment identifier must contain the project id of the service project specified in the service_project_attachment.service_project field. |
| `service_project_attachment` | `ServiceProjectAttachment` Required. The resource being created. |
| `request_id` | `string` Optional. 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. The server will guarantee that for at least 60 minutes since the first request. 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). |

## CreateServiceRequest

Request for CreateService.

| Fields ||
|---|---|
| `parent` | `string` Required. Fully qualified name of the parent Application to create the Service in. Expected format: `projects/{project}/locations/{location}/applications/{application}`. |
| `service_id` | `string` Required. The Service identifier. Must contain only lowercase letters, numbers or hyphens, with the first character a letter, the last a letter or a number, and a 63 character maximum. |
| `service` | `Service` Required. The resource being created. |
| `request_id` | `string` Optional. 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. The server will guarantee that for at least 60 minutes since the first request. 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). |

## CreateWorkloadRequest

Request for CreateWorkload.

| Fields ||
|---|---|
| `parent` | `string` Required. Fully qualified name of the Application to create Workload in. Expected format: `projects/{project}/locations/{location}/applications/{application}`. |
| `workload_id` | `string` Required. The Workload identifier. Must contain only lowercase letters, numbers or hyphens, with the first character a letter, the last a letter or a number, and a 63 character maximum. |
| `workload` | `Workload` Required. The resource being created. |
| `request_id` | `string` Optional. 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. The server will guarantee that for at least 60 minutes since the first request. 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). |

## Criticality

Criticality of the Application, Service, or Workload

| Fields ||
|---|---|
| `level (deprecated)` | `string` > [!WARNING] > This item is deprecated! Optional. Criticality level. Can contain only lowercase letters, numeric characters, underscores, and dashes. Can have a maximum length of 63 characters. Deprecated: Please refer to type instead. |
| `mission_critical (deprecated)` | `bool` > [!WARNING] > This item is deprecated! Optional. Indicates mission-critical Application, Service, or Workload. Deprecated: Please refer to type instead. |
| `type` | `Type` Required. Criticality Type. |

## Type

Criticality Type.

| Enums ||
|---|---|
| `TYPE_UNSPECIFIED` | Unspecified type. |
| `MISSION_CRITICAL` | Mission critical service, application or workload. |
| `HIGH` | High impact. |
| `MEDIUM` | Medium impact. |
| `LOW` | Low impact. |

## DeleteApplicationRequest

Request for DeleteApplication.

| Fields ||
|---|---|
| `name` | `string` Required. Fully qualified name of the Application to delete. Expected format: `projects/{project}/locations/{location}/applications/{application}`. |
| `request_id` | `string` Optional. 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. The server will guarantee that for at least 60 minutes after the first request. 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). |

## DeleteServiceProjectAttachmentRequest

Request for DeleteServiceProjectAttachment.

| Fields ||
|---|---|
| `name` | `string` Required. Fully qualified name of the service project attachment to delete. Expected format: `projects/{project}/locations/{location}/serviceProjectAttachments/{serviceProjectAttachment}`. |
| `request_id` | `string` Optional. 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. The server will guarantee that for at least 60 minutes after the first request. 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). |

## DeleteServiceRequest

Request for DeleteService.

| Fields ||
|---|---|
| `name` | `string` Required. Fully qualified name of the Service to delete from an Application. Expected format: `projects/{project}/locations/{location}/applications/{application}/services/{service}`. |
| `request_id` | `string` Optional. 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. The server will guarantee that for at least 60 minutes after the first request. 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). |

## DeleteWorkloadRequest

Request for DeleteWorkload.

| Fields ||
|---|---|
| `name` | `string` Required. Fully qualified name of the Workload to delete from an Application. Expected format: `projects/{project}/locations/{location}/applications/{application}/workloads/{workload}`. |
| `request_id` | `string` Optional. 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. The server will guarantee that for at least 60 minutes after the first request. 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). |

## DetachServiceProjectAttachmentRequest

Request for DetachServiceProjectAttachment.

| Fields ||
|---|---|
| `name` | `string` Required. Service project id and location to detach from a host project. Only global location is supported. Expected format: `projects/{project}/locations/{location}`. |

## DetachServiceProjectAttachmentResponse

This type has no fields.
Response for DetachServiceProjectAttachment.

## DiscoveredService

DiscoveredService is a network or API interface that exposes some functionality to clients for consumption over the network. A discovered service can be registered to a App Hub service.

| Fields ||
|---|---|
| `name` | `string` Identifier. The resource name of the discovered service. Format: `"projects/{host-project-id}/locations/{location}/discoveredServices/{uuid}"` |
| `service_reference` | `ServiceReference` Output only. Reference to an underlying networking resource that can comprise a Service. These are immutable. |
| `service_properties` | `ServiceProperties` Output only. Properties of an underlying compute resource that can comprise a Service. These are immutable. |

## DiscoveredWorkload

DiscoveredWorkload is a binary deployment (such as managed instance groups (MIGs) and GKE deployments) that performs the smallest logical subset of business functionality. A discovered workload can be registered to an App Hub Workload.

| Fields ||
|---|---|
| `name` | `string` Identifier. The resource name of the discovered workload. Format: `"projects/{host-project-id}/locations/{location}/discoveredWorkloads/{uuid}"` |
| `workload_reference` | `WorkloadReference` Output only. Reference of an underlying compute resource represented by the Workload. These are immutable. |
| `workload_properties` | `WorkloadProperties` Output only. Properties of an underlying compute resource represented by the Workload. These are immutable. |

## Environment

Environment of the Application, Service, or Workload

| Fields ||
|---|---|
| `environment (deprecated)` | `string` > [!WARNING] > This item is deprecated! Optional. Environment name. Can contain only lowercase letters, numeric characters, underscores, and dashes. Can have a maximum length of 63 characters. Deprecated: Please refer to type instead. |
| `type` | `Type` Required. Environment Type. |

## Type

Environment Type.

| Enums ||
|---|---|
| `TYPE_UNSPECIFIED` | Unspecified type. |
| `PRODUCTION` | Production environment. |
| `STAGING` | Staging environment. |
| `TEST` | Test environment. |
| `DEVELOPMENT` | Development environment. |

## ExtendedMetadata

Additional metadata for a Service or Workload.

| Fields ||
|---|---|
| `metadata_struct` | `Struct` Output only. The metadata contents. |

## ExtendedMetadataSchema

ExtendedMetadataSchema represents a schema for extended metadata of a service or workload.

| Fields ||
|---|---|
| `name` | `string` Identifier. Resource name of the schema. Format: projects//locations//extendedMetadataSchemas/ |
| `json_schema` | `string` Output only. The JSON schema as a string. |
| `schema_version` | `int64` Output only. The version of the schema. New versions are required to be backwards compatible. |

## FindUnregisteredServicesRequest

Request for FindUnregisteredServices.

| Fields ||
|---|---|
| `parent` | `string` Required. Project and location to find unregistered Discovered Services on. Expected format: `projects/{project}/locations/{location}`. |
| `page_size` | `int32` Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. |
| `page_token` | `string` Optional. A token identifying a page of results the server should return. |
| `filter` | `string` Optional. Filtering results. |
| `order_by` | `string` Optional. Hint for how to order the results. |

## FindUnregisteredServicesResponse

Response for FindUnregisteredServices.

| Fields ||
|---|---|
| `discovered_services[]` | `DiscoveredService` List of Discovered Services. |
| `next_page_token` | `string` A token identifying a page of results the server should return. |
| `unreachable[]` | `string` Locations that could not be reached. |

## FindUnregisteredWorkloadsRequest

Request for FindUnregisteredWorkloads.

| Fields ||
|---|---|
| `parent` | `string` Required. Project and location to find unregistered Discovered Workloads on. Expected format: `projects/{project}/locations/{location}`. |
| `page_size` | `int32` Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. |
| `page_token` | `string` Optional. A token identifying a page of results the server should return. |
| `filter` | `string` Optional. Filtering results. |
| `order_by` | `string` Optional. Hint for how to order the results. |

## FindUnregisteredWorkloadsResponse

Response for FindUnregisteredWorkloads.

| Fields ||
|---|---|
| `discovered_workloads[]` | `DiscoveredWorkload` List of Discovered Workloads. |
| `next_page_token` | `string` A token identifying a page of results the server should return. |
| `unreachable[]` | `string` Locations that could not be reached. |

## FunctionalType

The functional type of a service or workload.

| Fields ||
|---|---|
| `type` | `Type` Output only. The functional type of a service or workload. |

## Type

The functional type of a service or workload.

| Enums ||
|---|---|
| `TYPE_UNSPECIFIED` | Unspecified type. |
| `AGENT` | Agent type. |
| `MCP_SERVER` | MCP Server type. |

## GetApplicationRequest

Request for GetApplication.

| Fields ||
|---|---|
| `name` | `string` Required. Fully qualified name of the Application to fetch. Expected format: `projects/{project}/locations/{location}/applications/{application}`. |

## GetBoundaryRequest

Request message for AppHub.GetBoundary.

| Fields ||
|---|---|
| `name` | `string` Required. The name of the boundary to retrieve. Format: `projects/{project}/locations/{location}/boundary`. |

## GetDiscoveredServiceRequest

Request for GetDiscoveredService.

| Fields ||
|---|---|
| `name` | `string` Required. Fully qualified name of the Discovered Service to fetch. Expected format: `projects/{project}/locations/{location}/discoveredServices/{discoveredService}`. |

## GetDiscoveredWorkloadRequest

Request for GetDiscoveredWorkload.

| Fields ||
|---|---|
| `name` | `string` Required. Fully qualified name of the Discovered Workload to fetch. Expected format: `projects/{project}/locations/{location}/discoveredWorkloads/{discoveredWorkload}`. |

## GetExtendedMetadataSchemaRequest

Request for GetExtendedMetadataSchema.

| Fields ||
|---|---|
| `name` | `string` Required. Schema resource name. Format: `projects/{project}/locations/{location}/extendedMetadataSchemas/{extended_metadata_schema}`. `{extended_metadata_schema}` has the format `"apphub.googleapis.com/{SchemaName}"`. |

## GetServiceProjectAttachmentRequest

Request for GetServiceProjectAttachment.

| Fields ||
|---|---|
| `name` | `string` Required. Fully qualified name of the service project attachment to retrieve. Expected format: `projects/{project}/locations/{location}/serviceProjectAttachments/{serviceProjectAttachment}`. |

## GetServiceRequest

Request for GetService.

| Fields ||
|---|---|
| `name` | `string` Required. Fully qualified name of the Service to fetch. Expected format: `projects/{project}/locations/{location}/applications/{application}/services/{service}`. |

## GetWorkloadRequest

Request for GetWorkload.

| Fields ||
|---|---|
| `name` | `string` Required. Fully qualified name of the Workload to fetch. Expected format: `projects/{project}/locations/{location}/applications/{application}/workloads/{workload}`. |

## Identity

The identity associated with a service or workload.

| Fields ||
|---|---|
| `principal` | `string` Output only. The principal of the identity. Supported formats: - `sa://my-sa@PROJECT_ID.iam.gserviceaccount.com` for GCP Service Account - `principal://POOL_ID.global.PROJECT_NUMBER.workload.id.goog/ns/NAMESPACE_ID/sa/MANAGED_IDENTITY_ID` for Managed Workload Identity |

## ListApplicationsRequest

Request for ListApplications.

| Fields ||
|---|---|
| `parent` | `string` Required. Project and location to list Applications on. Expected format: `projects/{project}/locations/{location}`. |
| `page_size` | `int32` Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. |
| `page_token` | `string` Optional. A token identifying a page of results the server should return. |
| `filter` | `string` Optional. Filtering results. |
| `order_by` | `string` Optional. Hint for how to order the results. |

## ListApplicationsResponse

Response for ListApplications.

| Fields ||
|---|---|
| `applications[]` | `Application` List of Applications. |
| `next_page_token` | `string` A token identifying a page of results the server should return. |
| `unreachable[]` | `string` Locations that could not be reached. |

## ListDiscoveredServicesRequest

Request for ListDiscoveredServices.

| Fields ||
|---|---|
| `parent` | `string` Required. Project and location to list Discovered Services on. Expected format: `projects/{project}/locations/{location}`. |
| `page_size` | `int32` Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. |
| `page_token` | `string` Optional. A token identifying a page of results the server should return. |
| `filter` | `string` Optional. Filtering results. |
| `order_by` | `string` Optional. Hint for how to order the results. |

## ListDiscoveredServicesResponse

Response for ListDiscoveredServices.

| Fields ||
|---|---|
| `discovered_services[]` | `DiscoveredService` List of Discovered Services. |
| `next_page_token` | `string` A token identifying a page of results the server should return. |
| `unreachable[]` | `string` Locations that could not be reached. |

## ListDiscoveredWorkloadsRequest

Request for ListDiscoveredWorkloads.

| Fields ||
|---|---|
| `parent` | `string` Required. Project and location to list Discovered Workloads on. Expected format: `projects/{project}/locations/{location}`. |
| `page_size` | `int32` Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. |
| `page_token` | `string` Optional. A token identifying a page of results the server should return. |
| `filter` | `string` Optional. Filtering results. |
| `order_by` | `string` Optional. Hint for how to order the results. |

## ListDiscoveredWorkloadsResponse

Response for ListDiscoveredWorkloads.

| Fields ||
|---|---|
| `discovered_workloads[]` | `DiscoveredWorkload` List of Discovered Workloads. |
| `next_page_token` | `string` A token identifying a page of results the server should return. |
| `unreachable[]` | `string` Locations that could not be reached. |

## ListExtendedMetadataSchemasRequest

Request for ListExtendedMetadataSchemas.

| Fields ||
|---|---|
| `parent` | `string` Required. Project and location to list Extended Metadata Schemas on. Expected format: `projects/{project}/locations/{location}`. |
| `page_size` | `int32` Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. |
| `page_token` | `string` Optional. A token identifying a page of results the server should return. |

## ListExtendedMetadataSchemasResponse

Response for ListExtendedMetadataSchemas.

| Fields ||
|---|---|
| `extended_metadata_schemas[]` | `ExtendedMetadataSchema` List of Extended Metadata Schemas. |
| `next_page_token` | `string` A token identifying a page of results the server should return. |

## ListServiceProjectAttachmentsRequest

Request for ListServiceProjectAttachments.

| Fields ||
|---|---|
| `parent` | `string` Required. Host project ID and location to list service project attachments. Only global location is supported. Expected format: `projects/{project}/locations/{location}`. |
| `page_size` | `int32` Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. |
| `page_token` | `string` Optional. A token identifying a page of results the server should return. |
| `filter` | `string` Optional. Filtering results. |
| `order_by` | `string` Optional. Hint for how to order the results. |

## ListServiceProjectAttachmentsResponse

Response for ListServiceProjectAttachments.

| Fields ||
|---|---|
| `service_project_attachments[]` | `ServiceProjectAttachment` List of service project attachments. |
| `next_page_token` | `string` A token identifying a page of results the server should return. |
| `unreachable[]` | `string` Locations that could not be reached. |

## ListServicesRequest

Request for ListServices.

| Fields ||
|---|---|
| `parent` | `string` Required. Fully qualified name of the parent Application to list Services for. Expected format: `projects/{project}/locations/{location}/applications/{application}`. |
| `page_size` | `int32` Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. |
| `page_token` | `string` Optional. A token identifying a page of results the server should return. |
| `filter` | `string` Optional. Filtering results |
| `order_by` | `string` Optional. Hint for how to order the results |

## ListServicesResponse

Response for ListServices.

| Fields ||
|---|---|
| `services[]` | `Service` List of Services. |
| `next_page_token` | `string` A token identifying a page of results the server should return. |
| `unreachable[]` | `string` Locations that could not be reached. |

## ListWorkloadsRequest

Request for ListWorkloads.

| Fields ||
|---|---|
| `parent` | `string` Required. Fully qualified name of the parent Application to list Workloads for. Expected format: `projects/{project}/locations/{location}/applications/{application}`. |
| `page_size` | `int32` Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default. |
| `page_token` | `string` Optional. A token identifying a page of results the server should return. |
| `filter` | `string` Optional. Filtering results. |
| `order_by` | `string` Optional. Hint for how to order the results. |

## ListWorkloadsResponse

Response for ListWorkloads.

| Fields ||
|---|---|
| `workloads[]` | `Workload` List of Workloads. |
| `next_page_token` | `string` A token identifying a page of results the server should return. |
| `unreachable[]` | `string` Locations that could not be reached. |

## LookupDiscoveredServiceRequest

Request for LookupDiscoveredService.

| Fields ||
|---|---|
| `parent` | `string` Required. Host project ID and location to lookup Discovered Service in. Expected format: `projects/{project}/locations/{location}`. |
| `uri` | `string` Required. Resource URI to find DiscoveredService for. Accepts both project number and project ID and does translation when needed. |

## LookupDiscoveredServiceResponse

Response for LookupDiscoveredService.

| Fields ||
|---|---|
| `discovered_service` | `DiscoveredService` Discovered Service if exists, empty otherwise. |

## LookupDiscoveredWorkloadRequest

Request for LookupDiscoveredWorkload.

| Fields ||
|---|---|
| `parent` | `string` Required. Host project ID and location to lookup Discovered Workload in. Expected format: `projects/{project}/locations/{location}`. |
| `uri` | `string` Required. Resource URI to find Discovered Workload for. Accepts both project number and project ID and does translation when needed. |

## LookupDiscoveredWorkloadResponse

Response for LookupDiscoveredWorkload.

| Fields ||
|---|---|
| `discovered_workload` | `DiscoveredWorkload` Discovered Workload if exists, empty otherwise. |

## LookupServiceProjectAttachmentRequest

Request for LookupServiceProjectAttachment.

| Fields ||
|---|---|
| `name` | `string` Required. Service project ID and location to lookup service project attachment for. Only global location is supported. Expected format: `projects/{project}/locations/{location}`. |

## LookupServiceProjectAttachmentResponse

Response for LookupServiceProjectAttachment.

| Fields ||
|---|---|
| `service_project_attachment` | `ServiceProjectAttachment` Service project attachment for a project if exists, empty otherwise. |

## OperationMetadata

Represents the metadata of the long-running operation.

| Fields ||
|---|---|
| `create_time` | `Timestamp` Output only. The time the operation was created. |
| `end_time` | `Timestamp` Output only. The time the operation finished running. |
| `target` | `string` Output only. Server-defined resource path for the target of the operation. |
| `verb` | `string` Output only. Name of the verb executed by the operation. |
| `status_message` | `string` Output only. Human-readable status of the operation, if any. |
| `requested_cancellation` | `bool` Output only. Identifies whether the user has requested cancellation of the operation. Operations that have been cancelled successfully have `google.longrunning.Operation.error` value with a `google.rpc.Status.code` of 1, corresponding to `Code.CANCELLED`. |
| `api_version` | `string` Output only. API version used to start the operation. |

## RegistrationType

The registration type of a service.

| Fields ||
|---|---|
| `type` | `Type` Output only. The registration type of a service. |

## Type

The registration type of a service.

| Enums ||
|---|---|
| `TYPE_UNSPECIFIED` | Unspecified registration type. Defaults to EXCLUSIVE. |
| `EXCLUSIVE` | The service can only be registered to one application. |
| `SHARED` | The service can be registered to multiple applications. |

## Scope

Scope of an application.

| Fields ||
|---|---|
| `type` | `Type` Required. Scope Type. |

## Type

Scope Type.

| Enums ||
|---|---|
| `TYPE_UNSPECIFIED` | Unspecified type. |
| `REGIONAL` | Regional type. |
| `GLOBAL` | Global type. |
| `MULTI_REGIONAL` | Multi-regional type. |

## Service

Service is an App Hub data model that contains a discovered service, which represents a network or API interface that exposes some functionality to clients for consumption over the network.

| Fields ||
|---|---|
| `name` | `string` Identifier. The resource name of a Service. Format: `"projects/{host-project-id}/locations/{location}/applications/{application-id}/services/{service-id}"` |
| `display_name` | `string` Optional. User-defined name for the Service. Can have a maximum length of 63 characters. |
| `description` | `string` Optional. User-defined description of a Service. Can have a maximum length of 2048 characters. |
| `service_reference` | `ServiceReference` Output only. Reference to an underlying networking resource that can comprise a Service. These are immutable. |
| `service_properties` | `ServiceProperties` Output only. Properties of an underlying compute resource that can comprise a Service. These are immutable. |
| `attributes` | `Attributes` Optional. Consumer provided attributes. |
| `discovered_service` | `string` Required. Immutable. The resource name of the original discovered service. |
| `create_time` | `Timestamp` Output only. Create time. |
| `update_time` | `Timestamp` Output only. Update time. |
| `uid` | `string` Output only. A universally unique identifier (UUID) for the `Service` in the UUID4 format. |
| `state` | `State` Output only. Service state. |

## State

Service state.

| Enums ||
|---|---|
| `STATE_UNSPECIFIED` | Unspecified state. |
| `CREATING` | The service is being created. |
| `ACTIVE` | The service is ready. |
| `DELETING` | The service is being deleted. |
| `DETACHED` | The underlying networking resources have been deleted. |

## ServiceProjectAttachment

ServiceProjectAttachment represents an attachment from a service project to a host project. Service projects contain the underlying cloud infrastructure resources, and expose these resources to the host project through a ServiceProjectAttachment. With the attachments, the host project can provide an aggregated view of resources across all service projects.

| Fields ||
|---|---|
| `name` | `string` Identifier. The resource name of a ServiceProjectAttachment. Format: `"projects/{host-project-id}/locations/global/serviceProjectAttachments/{service-project-id}."` |
| `service_project` | `string` Required. Immutable. Service project name in the format: `"projects/abc"` or `"projects/123"`. As input, project name with either project id or number are accepted. As output, this field will contain project number. |
| `create_time` | `Timestamp` Output only. Create time. |
| `uid` | `string` Output only. A globally unique identifier (in UUID4 format) for the `ServiceProjectAttachment`. |
| `state` | `State` Output only. ServiceProjectAttachment state. |

## State

ServiceProjectAttachment state.

| Enums ||
|---|---|
| `STATE_UNSPECIFIED` | Unspecified state. |
| `CREATING` | The ServiceProjectAttachment is being created. |
| `ACTIVE` | The ServiceProjectAttachment is ready. This means Services and Workloads under the corresponding ServiceProjectAttachment is ready for registration. |
| `DELETING` | The ServiceProjectAttachment is being deleted. |

## ServiceProperties

Properties of an underlying cloud resource that can comprise a Service.

| Fields ||
|---|---|
| `gcp_project` | `string` Output only. The service project identifier that the underlying cloud resource resides in. |
| `location` | `string` Output only. The location that the underlying resource resides in, for example, us-west1. |
| `zone` | `string` Output only. The location that the underlying resource resides in if it is zonal, for example, us-west1-a). |
| `functional_type` | `FunctionalType` Output only. The type of the service. |
| `registration_type` | `RegistrationType` Output only. The registration type of the service. |
| `extended_metadata` | ``map<string, `ExtendedMetadata`>`` Output only. Additional metadata specific to the resource type. The key is a string that identifies the type of metadata and the value is the metadata contents specific to that type. Key format: `apphub.googleapis.com/{metadataType}` |
| `identity` | `Identity` Output only. The identity associated with the service. |

## ServiceReference

Reference to an underlying networking resource that can comprise a Service.

| Fields ||
|---|---|
| `uri` | `string` Output only. The underlying resource URI. For example, URI of Forwarding Rule, URL Map, and Backend Service. |
| `path` | `string` Output only. Additional path under the resource URI (demultiplexing one resource URI into multiple entries). Smallest unit a policy can be attached to. Examples: URL Map path entry. |

## UpdateApplicationRequest

Request for UpdateApplication.

| Fields ||
|---|---|
| `update_mask` | `FieldMask` Required. Field mask is used to specify the fields to be overwritten in the Application resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. The API changes the values of the fields as specified in the update_mask. The API ignores the values of all fields not covered by the update_mask. You can also unset a field by not specifying it in the updated message, but adding the field to the mask. This clears whatever value the field previously had. |
| `application` | `Application` Required. The resource being updated. |
| `request_id` | `string` Optional. 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. The server will guarantee that for at least 60 minutes since the first request. 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). |

## UpdateBoundaryRequest

Request message for AppHub.UpdateBoundary.

| Fields ||
|---|---|
| `update_mask` | `FieldMask` Required. Field mask is used to specify the fields to be overwritten in the Boundary resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten. |
| `boundary` | `Boundary` Required. The boundary to update. |
| `request_id` | `string` Optional. 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. The server will guarantee that for at least 60 minutes since the first request. 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). |

## UpdateServiceRequest

Request for UpdateService.

| Fields ||
|---|---|
| `update_mask` | `FieldMask` Required. Field mask is used to specify the fields to be overwritten in the Service resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. The API changes the values of the fields as specified in the update_mask. The API ignores the values of all fields not covered by the update_mask. You can also unset a field by not specifying it in the updated message, but adding the field to the mask. This clears whatever value the field previously had. |
| `service` | `Service` Required. The resource being updated. |
| `request_id` | `string` Optional. 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. The server will guarantee that for at least 60 minutes since the first request. 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). |

## UpdateWorkloadRequest

Request for UpdateWorkload.

| Fields ||
|---|---|
| `update_mask` | `FieldMask` Required. Field mask is used to specify the fields to be overwritten in the Workload resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. The API changes the values of the fields as specified in the update_mask. The API ignores the values of all fields not covered by the update_mask. You can also unset a field by not specifying it in the updated message, but adding the field to the mask. This clears whatever value the field previously had. |
| `workload` | `Workload` Required. The resource being updated. |
| `request_id` | `string` Optional. 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. The server will guarantee that for at least 60 minutes since the first request. 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). |

## Workload

Workload is an App Hub data model that contains a discovered workload, which represents a binary deployment (such as managed instance groups (MIGs) and GKE deployments) that performs the smallest logical subset of business functionality.

| Fields ||
|---|---|
| `name` | `string` Identifier. The resource name of the Workload. Format: `"projects/{host-project-id}/locations/{location}/applications/{application-id}/workloads/{workload-id}"` |
| `display_name` | `string` Optional. User-defined name for the Workload. Can have a maximum length of 63 characters. |
| `description` | `string` Optional. User-defined description of a Workload. Can have a maximum length of 2048 characters. |
| `workload_reference` | `WorkloadReference` Output only. Reference of an underlying compute resource represented by the Workload. These are immutable. |
| `workload_properties` | `WorkloadProperties` Output only. Properties of an underlying compute resource represented by the Workload. These are immutable. |
| `discovered_workload` | `string` Required. Immutable. The resource name of the original discovered workload. |
| `attributes` | `Attributes` Optional. Consumer provided attributes. |
| `create_time` | `Timestamp` Output only. Create time. |
| `update_time` | `Timestamp` Output only. Update time. |
| `uid` | `string` Output only. A universally unique identifier (UUID) for the `Workload` in the UUID4 format. |
| `state` | `State` Output only. Workload state. |

## State

Workload state.

| Enums ||
|---|---|
| `STATE_UNSPECIFIED` | Unspecified state. |
| `CREATING` | The Workload is being created. |
| `ACTIVE` | The Workload is ready. |
| `DELETING` | The Workload is being deleted. |
| `DETACHED` | The underlying compute resources have been deleted. |

## WorkloadProperties

Properties of an underlying compute resource represented by the Workload.

| Fields ||
|---|---|
| `gcp_project` | `string` Output only. The service project identifier that the underlying cloud resource resides in. Empty for non-cloud resources. |
| `location` | `string` Output only. The location that the underlying compute resource resides in (for example, us-west1). |
| `zone` | `string` Output only. The location that the underlying compute resource resides in if it is zonal (for example, us-west1-a). |
| `functional_type` | `FunctionalType` Output only. The type of the workload. |
| `extended_metadata` | ``map<string, `ExtendedMetadata`>`` Output only. Additional metadata specific to the resource type. The key is a string that identifies the type of metadata and the value is the metadata contents specific to that type. Key format: `apphub.googleapis.com/{metadataType}` |
| `identity` | `Identity` Output only. The identity associated with the workload. |

## WorkloadReference

Reference of an underlying compute resource represented by the Workload.

| Fields ||
|---|---|
| `uri` | `string` Output only. The underlying compute resource uri. |