Skip to main content

workloads

Overview

Nameworkloads
TypeResource
Idgoogle.assuredworkloads.workloads

Fields

NameDatatypeDescription
namestringOptional. The resource name of the workload. Format: organizations/{organization}/locations/{location}/workloads/{workload} Read-only.
partnerstringOptional. Partner regime associated with this workload.
kajEnrollmentStatestringOutput only. Represents the KAJ enrollment state of the given workload.
enableSovereignControlsbooleanOptional. Indicates the sovereignty status of the given workload. Currently meant to be used by Europe/Canada customers.
billingAccountstringOptional. The billing account used for the resources which are direct children of workload. This billing account is initially associated with the resources created as part of Workload creation. After the initial creation of these resources, the customer can change the assigned billing account. The resource name has the form billingAccounts/{billing_account_id}. For example, billingAccounts/012345-567890-ABCDEF.
partnerPermissionsobjectPermissions granted to the AW Partner SA account for the customer workload
kmsSettingsobjectSettings specific to the Key Management Service.
resourceSettingsarrayInput only. Resource properties that are used to customize workload resources. These properties (such as custom project id) will be used to create workload resources if possible. This field is optional.
displayNamestringRequired. The user-assigned display name of the Workload. When present it must be between 4 to 30 characters. Allowed characters are: lowercase and uppercase letters, numbers, hyphen, and spaces. Example: My Workload
saaEnrollmentResponseobjectSigned Access Approvals (SAA) enrollment response.
labelsobjectOptional. Labels applied to the workload.
provisionedResourcesParentstringInput only. The parent resource for the resources managed by this Assured Workload. May be either empty or a folder resource which is a child of the Workload parent. If not specified all resources are created under the parent organization. Format: folders/{folder_id}
complianceStatusobjectRepresents the Compliance Status of this workload
createTimestringOutput only. Immutable. The Workload creation timestamp.
violationNotificationsEnabledbooleanOptional. Indicates whether the e-mail notification for a violation is enabled for a workload. This value will be by default True, and if not present will be considered as true. This should only be updated via updateWorkload call. Any Changes to this field during the createWorkload call will not be honored. This will always be true while creating the workload.
compliantButDisallowedServicesarrayOutput only. Urls for services which are compliant for this Assured Workload, but which are currently disallowed by the ResourceUsageRestriction org policy. Invoke RestrictAllowedResources endpoint to allow your project developers to use these services in their environment."
complianceRegimestringRequired. Immutable. Compliance Regime associated with this workload.
resourcesarrayOutput only. The resources associated with this workload. These resources will be created when creating the workload. If any of the projects already exist, the workload creation will fail. Always read only.
ekmProvisioningResponseobjectExternal key management systems(EKM) Provisioning response
etagstringOptional. ETag of the workload, it is calculated on the basis of the Workload contents. It will be used in Update & Delete operations.

Methods

NameAccessible byRequired ParamsDescription
getSELECTlocationsId, organizationsId, workloadsIdGets Assured Workload associated with a CRM Node
listSELECTlocationsId, organizationsIdLists Assured Workloads under a CRM Node.
createINSERTlocationsId, organizationsIdCreates Assured Workload.
deleteDELETElocationsId, organizationsId, workloadsIdDeletes the workload. Make sure that workload's direct children are already in a deleted state, otherwise the request will fail with a FAILED_PRECONDITION error. In addition to assuredworkloads.workload.delete permission, the user should also have orgpolicy.policy.set permission on the deleted folder to remove Assured Workloads OrgPolicies.
_listEXEClocationsId, organizationsIdLists Assured Workloads under a CRM Node.
mutate_partner_permissionsEXEClocationsId, organizationsId, workloadsIdUpdate the permissions settings for an existing partner workload. For force updates don't set etag field in the Workload. Only one update operation per workload can be in progress.
patchEXEClocationsId, organizationsId, workloadsIdUpdates an existing workload. Currently allows updating of workload display_name and labels. For force updates don't set etag field in the Workload. Only one update operation per workload can be in progress.
restrict_allowed_resourcesEXEClocationsId, organizationsId, workloadsIdRestrict the list of resources allowed in the Workload environment. The current list of allowed products can be found at https://cloud.google.com/assured-workloads/docs/supported-products In addition to assuredworkloads.workload.update permission, the user should also have orgpolicy.policy.set permission on the folder resource to use this functionality.