{ "schemas": { "GoogleProtobufEmpty": { "description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }", "id": "GoogleProtobufEmpty", "type": "object", "properties": {} }, "GoogleCloudAssuredworkloadsV1WorkloadPartnerPermissions": { "description": "Permissions granted to the AW Partner SA account for the customer workload", "id": "GoogleCloudAssuredworkloadsV1WorkloadPartnerPermissions", "type": "object", "properties": { "assuredWorkloadsMonitoring": { "type": "boolean", "description": "Optional. Allow partner to view violation alerts." }, "serviceAccessApprover": { "description": "Optional. Allow partner to view access approval logs.", "type": "boolean" }, "dataLogsViewer": { "description": "Allow the partner to view inspectability logs and monitoring violations.", "type": "boolean" } } }, "GoogleCloudAssuredworkloadsV1ViolationRemediation": { "description": "Represents remediation guidance to resolve compliance violation for AssuredWorkload", "type": "object", "properties": { "remediationType": { "type": "string", "enumDescriptions": [ "Unspecified remediation type", "Remediation type for boolean org policy", "Remediation type for list org policy which have allowed values in the monitoring rule", "Remediation type for list org policy which have denied values in the monitoring rule", "Remediation type for gcp.restrictCmekCryptoKeyProjects", "Remediation type for resource violation." ], "description": "Output only. Reemediation type based on the type of org policy values violated", "enum": [ "REMEDIATION_TYPE_UNSPECIFIED", "REMEDIATION_BOOLEAN_ORG_POLICY_VIOLATION", "REMEDIATION_LIST_ALLOWED_VALUES_ORG_POLICY_VIOLATION", "REMEDIATION_LIST_DENIED_VALUES_ORG_POLICY_VIOLATION", "REMEDIATION_RESTRICT_CMEK_CRYPTO_KEY_PROJECTS_ORG_POLICY_VIOLATION", "REMEDIATION_RESOURCE_VIOLATION" ], "readOnly": true }, "compliantValues": { "type": "array", "items": { "type": "string" }, "description": "Values that can resolve the violation For example: for list org policy violations, this will either be the list of allowed or denied values" }, "instructions": { "description": "Required. Remediation instructions to resolve violations", "$ref": "GoogleCloudAssuredworkloadsV1ViolationRemediationInstructions" } }, "id": "GoogleCloudAssuredworkloadsV1ViolationRemediation" }, "GoogleLongrunningOperation": { "properties": { "response": { "description": "The normal, successful response of the operation. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.", "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." } }, "done": { "type": "boolean", "description": "If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available." }, "name": { "type": "string", "description": "The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`." }, "metadata": { "type": "object", "description": "Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.", "additionalProperties": { "description": "Properties of the object. Contains field @type with type URL.", "type": "any" } }, "error": { "description": "The error result of the operation in case of failure or cancellation.", "$ref": "GoogleRpcStatus" } }, "id": "GoogleLongrunningOperation", "description": "This resource represents a long-running operation that is the result of a network API call.", "type": "object" }, "GoogleCloudAssuredworkloadsV1MoveImpact": { "type": "object", "description": "Represents the impact of moving the asset to the target.", "properties": { "detail": { "type": "string", "description": "Explanation of the impact." } }, "id": "GoogleCloudAssuredworkloadsV1MoveImpact" }, "GoogleCloudAssuredworkloadsV1WorkloadComplianceStatus": { "properties": { "acknowledgedResourceViolationCount": { "type": "integer", "description": "Number of current resource violations which are not acknowledged.", "format": "int32" }, "activeResourceViolationCount": { "type": "integer", "description": "Number of current resource violations which are acknowledged.", "format": "int32" }, "acknowledgedViolationCount": { "type": "integer", "format": "int32", "description": "Number of current orgPolicy violations which are acknowledged." }, "activeViolationCount": { "description": "Number of current orgPolicy violations which are not acknowledged.", "format": "int32", "type": "integer" } }, "description": "Represents the Compliance Status of this workload", "type": "object", "id": "GoogleCloudAssuredworkloadsV1WorkloadComplianceStatus" }, "GoogleCloudAssuredworkloadsV1WorkloadResourceInfo": { "id": "GoogleCloudAssuredworkloadsV1WorkloadResourceInfo", "properties": { "resourceId": { "description": "Resource identifier. For a project this represents project_number.", "type": "string", "format": "int64" }, "resourceType": { "description": "Indicates the type of resource.", "enum": [ "RESOURCE_TYPE_UNSPECIFIED", "CONSUMER_PROJECT", "CONSUMER_FOLDER", "ENCRYPTION_KEYS_PROJECT", "KEYRING" ], "enumDescriptions": [ "Unknown resource type.", "Deprecated. Existing workloads will continue to support this, but new CreateWorkloadRequests should not specify this as an input value.", "Consumer Folder.", "Consumer project containing encryption keys.", "Keyring resource that hosts encryption keys." ], "enumDeprecated": [ false, true, false, false, false ], "type": "string" } }, "type": "object", "description": "Represent the resources that are children of this Workload." }, "GoogleCloudAssuredworkloadsV1CreateWorkloadOperationMetadata": { "type": "object", "id": "GoogleCloudAssuredworkloadsV1CreateWorkloadOperationMetadata", "properties": { "createTime": { "type": "string", "description": "Optional. Time when the operation was created.", "format": "google-datetime" }, "parent": { "type": "string", "description": "Optional. The parent of the workload." }, "displayName": { "description": "Optional. The display name of the workload.", "type": "string" }, "complianceRegime": { "enum": [ "COMPLIANCE_REGIME_UNSPECIFIED", "IL4", "CJIS", "FEDRAMP_HIGH", "FEDRAMP_MODERATE", "US_REGIONAL_ACCESS", "HIPAA", "HITRUST", "EU_REGIONS_AND_SUPPORT", "CA_REGIONS_AND_SUPPORT", "ITAR", "AU_REGIONS_AND_US_SUPPORT", "ASSURED_WORKLOADS_FOR_PARTNERS", "ISR_REGIONS", "ISR_REGIONS_AND_SUPPORT", "CA_PROTECTED_B", "IL5", "IL2", "JP_REGIONS_AND_SUPPORT", "KSA_REGIONS_AND_SUPPORT_WITH_SOVEREIGNTY_CONTROLS", "REGIONAL_CONTROLS", "FREE_REGIONS" ], "description": "Optional. Compliance controls that should be applied to the resources managed by the workload.", "enumDescriptions": [ "Unknown compliance regime.", "Information protection as per DoD IL4 requirements.", "Criminal Justice Information Services (CJIS) Security policies.", "FedRAMP High data protection controls", "FedRAMP Moderate data protection controls", "Assured Workloads For US Regions data protection controls", "Health Insurance Portability and Accountability Act controls", "Health Information Trust Alliance controls", "Assured Workloads For EU Regions and Support controls", "Assured Workloads For Canada Regions and Support controls", "International Traffic in Arms Regulations", "Assured Workloads for Australia Regions and Support controls", "Assured Workloads for Partners;", "Assured Workloads for Israel", "Assured Workloads for Israel Regions", "Assured Workloads for Canada Protected B regime", "Information protection as per DoD IL5 requirements.", "Information protection as per DoD IL2 requirements.", "Assured Workloads for Japan Regions", "KSA R5 Controls.", "Assured Workloads for Regional Controls/Free Regions", "Assured Workloads for Regional Controls/Free Regions" ], "type": "string" } }, "description": "Operation metadata to give request details of CreateWorkload." }, "GoogleCloudAssuredworkloadsV1RestrictAllowedResourcesRequest": { "type": "object", "properties": { "restrictionType": { "description": "Required. The type of restriction for using gcp products in the Workload environment.", "enumDescriptions": [ "Unknown restriction type.", "Allow the use all of all gcp products, irrespective of the compliance posture. This effectively removes gcp.restrictServiceUsage OrgPolicy on the AssuredWorkloads Folder.", "Based on Workload's compliance regime, allowed list changes. See - https://cloud.google.com/assured-workloads/docs/supported-products for the list of supported resources.", "Similar to ALLOW_COMPLIANT_RESOURCES but adds the list of compliant resources to the existing list of compliant resources. Effective org-policy of the Folder is considered to ensure there is no disruption to the existing customer workflows." ], "type": "string", "enum": [ "RESTRICTION_TYPE_UNSPECIFIED", "ALLOW_ALL_GCP_RESOURCES", "ALLOW_COMPLIANT_RESOURCES", "APPEND_COMPLIANT_RESOURCES" ] } }, "description": "Request for restricting list of available resources in Workload environment.", "id": "GoogleCloudAssuredworkloadsV1RestrictAllowedResourcesRequest" }, "GoogleCloudAssuredworkloadsV1AssetMoveAnalysis": { "description": "Represents move analysis results for an asset.", "id": "GoogleCloudAssuredworkloadsV1AssetMoveAnalysis", "type": "object", "properties": { "analysisGroups": { "type": "array", "items": { "$ref": "GoogleCloudAssuredworkloadsV1MoveAnalysisGroup" }, "description": "List of eligible analyses performed for the asset." }, "asset": { "type": "string", "description": "The full resource name of the asset being analyzed. Example: //compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1" }, "assetType": { "type": "string", "description": "Type of the asset being analyzed. Possible values will be among the ones listed [here](https://cloud.google.com/asset-inventory/docs/supported-asset-types)." } } }, "GoogleRpcStatus": { "description": "The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).", "properties": { "message": { "description": "A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.", "type": "string" }, "details": { "description": "A list of messages that carry the error details. There is a common set of message types for APIs to use.", "items": { "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." } }, "type": "array" }, "code": { "description": "The status code, which should be an enum value of google.rpc.Code.", "type": "integer", "format": "int32" } }, "type": "object", "id": "GoogleRpcStatus" }, "GoogleCloudAssuredworkloadsV1ListWorkloadsResponse": { "description": "Response of ListWorkloads endpoint.", "id": "GoogleCloudAssuredworkloadsV1ListWorkloadsResponse", "type": "object", "properties": { "nextPageToken": { "description": "The next page token. Return empty if reached the last page.", "type": "string" }, "workloads": { "items": { "$ref": "GoogleCloudAssuredworkloadsV1Workload" }, "description": "List of Workloads under a given parent.", "type": "array" } } }, "GoogleCloudAssuredworkloadsV1Violation": { "type": "object", "description": "Workload monitoring Violation.", "id": "GoogleCloudAssuredworkloadsV1Violation", "properties": { "nonCompliantOrgPolicy": { "description": "Output only. Immutable. Name of the OrgPolicy which was modified with non-compliant change and resulted this violation. Format: projects/{project_number}/policies/{constraint_name} folders/{folder_id}/policies/{constraint_name} organizations/{organization_id}/policies/{constraint_name}", "type": "string", "readOnly": true }, "parentProjectNumber": { "type": "string", "readOnly": true, "description": "Optional. Output only. Parent project number where resource is present. Empty for org-policy violations." }, "beginTime": { "description": "Output only. Time of the event which triggered the Violation.", "type": "string", "readOnly": true, "format": "google-datetime" }, "updateTime": { "readOnly": true, "type": "string", "format": "google-datetime", "description": "Output only. The last time when the Violation record was updated." }, "category": { "description": "Output only. Category under which this violation is mapped. e.g. Location, Service Usage, Access, Encryption, etc.", "type": "string", "readOnly": true }, "acknowledgementTime": { "format": "google-datetime", "description": "Optional. Timestamp when this violation was acknowledged first. Check exception_contexts to find the last time the violation was acknowledged when there are more than one violations. This field will be absent when acknowledged field is marked as false.", "type": "string" }, "orgPolicyConstraint": { "type": "string", "deprecated": true, "description": "Output only. Immutable. The org-policy-constraint that was incorrectly changed, which resulted in this violation.", "readOnly": true }, "violationType": { "readOnly": true, "enumDescriptions": [ "Unspecified type.", "Org Policy Violation.", "Resource Violation." ], "enum": [ "VIOLATION_TYPE_UNSPECIFIED", "ORG_POLICY", "RESOURCE" ], "description": "Output only. Type of the violation", "type": "string" }, "associatedOrgPolicyViolationId": { "readOnly": true, "description": "Optional. Output only. Violation Id of the org-policy violation due to which the resource violation is caused. Empty for org-policy violations.", "type": "string" }, "resolveTime": { "description": "Output only. Time of the event which fixed the Violation. If the violation is ACTIVE this will be empty.", "type": "string", "readOnly": true, "format": "google-datetime" }, "remediation": { "readOnly": true, "description": "Output only. Compliance violation remediation", "$ref": "GoogleCloudAssuredworkloadsV1ViolationRemediation" }, "exceptionAuditLogLink": { "readOnly": true, "description": "Output only. Immutable. Audit Log link to find business justification provided for violation exception. Format: https://console.cloud.google.com/logs/query;query={logName}{protoPayload.resourceName}{protoPayload.methodName}{timeRange}{organization}", "type": "string" }, "resourceType": { "description": "Optional. Output only. Type of the resource like compute.googleapis.com/Disk, etc. Empty for org-policy violations.", "readOnly": true, "type": "string" }, "name": { "readOnly": true, "type": "string", "description": "Output only. Immutable. Name of the Violation. Format: organizations/{organization}/locations/{location}/workloads/{workload_id}/violations/{violations_id}" }, "description": { "readOnly": true, "description": "Output only. Description for the Violation. e.g. OrgPolicy gcp.resourceLocations has non compliant value.", "type": "string" }, "auditLogLink": { "readOnly": true, "description": "Output only. Immutable. Audit Log Link for violated resource Format: https://console.cloud.google.com/logs/query;query={logName}{protoPayload.resourceName}{timeRange}{folder}", "type": "string" }, "exceptionContexts": { "readOnly": true, "type": "array", "items": { "$ref": "GoogleCloudAssuredworkloadsV1ViolationExceptionContext" }, "description": "Output only. List of all the exception detail added for the violation." }, "state": { "readOnly": true, "enum": [ "STATE_UNSPECIFIED", "RESOLVED", "UNRESOLVED", "EXCEPTION" ], "type": "string", "enumDescriptions": [ "Unspecified state.", "Violation is resolved.", "Violation is Unresolved", "Violation is Exception" ], "description": "Output only. State of the violation" }, "resourceName": { "description": "Optional. Output only. Name of the resource like //storage.googleapis.com/myprojectxyz-testbucket. Empty for org-policy violations.", "readOnly": true, "type": "string" }, "acknowledged": { "description": "A boolean that indicates if the violation is acknowledged", "type": "boolean" } } }, "GoogleCloudAssuredworkloadsV1ViolationRemediationInstructions": { "id": "GoogleCloudAssuredworkloadsV1ViolationRemediationInstructions", "type": "object", "properties": { "gcloudInstructions": { "$ref": "GoogleCloudAssuredworkloadsV1ViolationRemediationInstructionsGcloud", "description": "Remediation instructions to resolve violation via gcloud cli" }, "consoleInstructions": { "$ref": "GoogleCloudAssuredworkloadsV1ViolationRemediationInstructionsConsole", "description": "Remediation instructions to resolve violation via cloud console" } }, "description": "Instructions to remediate violation" }, "GoogleCloudAssuredworkloadsV1EnableResourceMonitoringResponse": { "properties": {}, "description": "Response for EnableResourceMonitoring endpoint.", "type": "object", "id": "GoogleCloudAssuredworkloadsV1EnableResourceMonitoringResponse" }, "GoogleCloudAssuredworkloadsV1Workload": { "properties": { "violationNotificationsEnabled": { "description": "Optional. 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.", "type": "boolean" }, "resourceSettings": { "description": "Input 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.", "type": "array", "items": { "$ref": "GoogleCloudAssuredworkloadsV1WorkloadResourceSettings" } }, "kmsSettings": { "deprecated": true, "description": "Input only. Settings used to create a CMEK crypto key. When set, a project with a KMS CMEK key is provisioned. This field is deprecated as of Feb 28, 2022. In order to create a Keyring, callers should specify, ENCRYPTION_KEYS_PROJECT or KEYRING in ResourceSettings.resource_type field.", "$ref": "GoogleCloudAssuredworkloadsV1WorkloadKMSSettings" }, "billingAccount": { "type": "string", "description": "Optional. 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`." }, "etag": { "type": "string", "description": "Optional. ETag of the workload, it is calculated on the basis of the Workload contents. It will be used in Update & Delete operations." }, "createTime": { "type": "string", "format": "google-datetime", "description": "Output only. Immutable. The Workload creation timestamp.", "readOnly": true }, "name": { "description": "Optional. The resource name of the workload. Format: organizations/{organization}/locations/{location}/workloads/{workload} Read-only.", "type": "string" }, "saaEnrollmentResponse": { "$ref": "GoogleCloudAssuredworkloadsV1WorkloadSaaEnrollmentResponse", "description": "Output only. Represents the SAA enrollment response of the given workload. SAA enrollment response is queried during GetWorkload call. In failure cases, user friendly error message is shown in SAA details page.", "readOnly": true }, "ekmProvisioningResponse": { "description": "Output only. Represents the Ekm Provisioning State of the given workload.", "$ref": "GoogleCloudAssuredworkloadsV1WorkloadEkmProvisioningResponse", "readOnly": true }, "complianceStatus": { "description": "Output only. Count of active Violations in the Workload.", "$ref": "GoogleCloudAssuredworkloadsV1WorkloadComplianceStatus", "readOnly": true }, "partner": { "enumDescriptions": [ "", "Enum representing S3NS (Thales) partner.", "Enum representing T_SYSTEM (TSI) partner.", "Enum representing SIA_MINSAIT (Indra) partner.", "Enum representing PSN (TIM) partner." ], "enum": [ "PARTNER_UNSPECIFIED", "LOCAL_CONTROLS_BY_S3NS", "SOVEREIGN_CONTROLS_BY_T_SYSTEMS", "SOVEREIGN_CONTROLS_BY_SIA_MINSAIT", "SOVEREIGN_CONTROLS_BY_PSN" ], "description": "Optional. Partner regime associated with this workload.", "type": "string" }, "kajEnrollmentState": { "type": "string", "readOnly": true, "enum": [ "KAJ_ENROLLMENT_STATE_UNSPECIFIED", "KAJ_ENROLLMENT_STATE_PENDING", "KAJ_ENROLLMENT_STATE_COMPLETE" ], "enumDescriptions": [ "Default State for KAJ Enrollment.", "Pending State for KAJ Enrollment.", "Complete State for KAJ Enrollment." ], "description": "Output only. Represents the KAJ enrollment state of the given workload." }, "provisionedResourcesParent": { "type": "string", "description": "Input 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}" }, "labels": { "additionalProperties": { "type": "string" }, "description": "Optional. Labels applied to the workload.", "type": "object" }, "resourceMonitoringEnabled": { "readOnly": true, "type": "boolean", "description": "Output only. Indicates whether resource monitoring is enabled for workload or not. It is true when Resource feed is subscribed to AWM topic and AWM Service Agent Role is binded to AW Service Account for resource Assured workload." }, "complianceRegime": { "type": "string", "enumDescriptions": [ "Unknown compliance regime.", "Information protection as per DoD IL4 requirements.", "Criminal Justice Information Services (CJIS) Security policies.", "FedRAMP High data protection controls", "FedRAMP Moderate data protection controls", "Assured Workloads For US Regions data protection controls", "Health Insurance Portability and Accountability Act controls", "Health Information Trust Alliance controls", "Assured Workloads For EU Regions and Support controls", "Assured Workloads For Canada Regions and Support controls", "International Traffic in Arms Regulations", "Assured Workloads for Australia Regions and Support controls", "Assured Workloads for Partners;", "Assured Workloads for Israel", "Assured Workloads for Israel Regions", "Assured Workloads for Canada Protected B regime", "Information protection as per DoD IL5 requirements.", "Information protection as per DoD IL2 requirements.", "Assured Workloads for Japan Regions", "KSA R5 Controls.", "Assured Workloads for Regional Controls/Free Regions", "Assured Workloads for Regional Controls/Free Regions" ], "description": "Required. Immutable. Compliance Regime associated with this workload.", "enum": [ "COMPLIANCE_REGIME_UNSPECIFIED", "IL4", "CJIS", "FEDRAMP_HIGH", "FEDRAMP_MODERATE", "US_REGIONAL_ACCESS", "HIPAA", "HITRUST", "EU_REGIONS_AND_SUPPORT", "CA_REGIONS_AND_SUPPORT", "ITAR", "AU_REGIONS_AND_US_SUPPORT", "ASSURED_WORKLOADS_FOR_PARTNERS", "ISR_REGIONS", "ISR_REGIONS_AND_SUPPORT", "CA_PROTECTED_B", "IL5", "IL2", "JP_REGIONS_AND_SUPPORT", "KSA_REGIONS_AND_SUPPORT_WITH_SOVEREIGNTY_CONTROLS", "REGIONAL_CONTROLS", "FREE_REGIONS" ] }, "partnerPermissions": { "$ref": "GoogleCloudAssuredworkloadsV1WorkloadPartnerPermissions", "description": "Optional. Permissions granted to the AW Partner SA account for the customer workload" }, "enableSovereignControls": { "description": "Optional. Indicates the sovereignty status of the given workload. Currently meant to be used by Europe/Canada customers.", "type": "boolean" }, "resources": { "items": { "$ref": "GoogleCloudAssuredworkloadsV1WorkloadResourceInfo" }, "readOnly": true, "description": "Output 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.", "type": "array" }, "compliantButDisallowedServices": { "readOnly": true, "type": "array", "description": "Output 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.", "items": { "type": "string" } }, "displayName": { "type": "string", "description": "Required. 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" } }, "id": "GoogleCloudAssuredworkloadsV1Workload", "description": "A Workload object for managing highly regulated workloads of cloud customers.", "type": "object" }, "GoogleCloudAssuredworkloadsV1WorkloadResourceSettings": { "id": "GoogleCloudAssuredworkloadsV1WorkloadResourceSettings", "properties": { "resourceId": { "type": "string", "description": "Resource identifier. For a project this represents project_id. If the project is already taken, the workload creation will fail. For KeyRing, this represents the keyring_id. For a folder, don't set this value as folder_id is assigned by Google." }, "resourceType": { "description": "Indicates the type of resource. This field should be specified to correspond the id to the right project type (CONSUMER_PROJECT or ENCRYPTION_KEYS_PROJECT)", "type": "string", "enum": [ "RESOURCE_TYPE_UNSPECIFIED", "CONSUMER_PROJECT", "CONSUMER_FOLDER", "ENCRYPTION_KEYS_PROJECT", "KEYRING" ], "enumDeprecated": [ false, true, false, false, false ], "enumDescriptions": [ "Unknown resource type.", "Deprecated. Existing workloads will continue to support this, but new CreateWorkloadRequests should not specify this as an input value.", "Consumer Folder.", "Consumer project containing encryption keys.", "Keyring resource that hosts encryption keys." ] }, "displayName": { "description": "User-assigned resource display name. If not empty it will be used to create a resource with the specified name.", "type": "string" } }, "type": "object", "description": "Represent the custom settings for the resources to be created." }, "GoogleCloudAssuredworkloadsV1WorkloadEkmProvisioningResponse": { "properties": { "ekmProvisioningState": { "enumDescriptions": [ "Default State for Ekm Provisioning", "Pending State for Ekm Provisioning", "Failed State for Ekm Provisioning", "Completed State for Ekm Provisioning" ], "type": "string", "enum": [ "EKM_PROVISIONING_STATE_UNSPECIFIED", "EKM_PROVISIONING_STATE_PENDING", "EKM_PROVISIONING_STATE_FAILED", "EKM_PROVISIONING_STATE_COMPLETED" ], "description": "Indicates Ekm enrollment Provisioning of a given workload." }, "ekmProvisioningErrorDomain": { "enum": [ "EKM_PROVISIONING_ERROR_DOMAIN_UNSPECIFIED", "UNSPECIFIED_ERROR", "GOOGLE_SERVER_ERROR", "EXTERNAL_USER_ERROR", "EXTERNAL_PARTNER_ERROR", "TIMEOUT_ERROR" ], "type": "string", "enumDescriptions": [ "No error domain", "Error but domain is unspecified.", "Internal logic breaks within provisioning code.", "Error occurred with the customer not granting permission/creating resource.", "Error occurred within the partner's provisioning cluster.", "Resource wasn't provisioned in the required 7 day time period" ], "description": "Indicates Ekm provisioning error if any." }, "ekmProvisioningErrorMapping": { "enumDescriptions": [ "Error is unspecified.", "Service account is used is invalid.", "Iam permission monitoring.MetricsScopeAdmin wasn't applied.", "Iam permission cloudkms.ekmConnectionsAdmin wasn't applied." ], "enum": [ "EKM_PROVISIONING_ERROR_MAPPING_UNSPECIFIED", "INVALID_SERVICE_ACCOUNT", "MISSING_METRICS_SCOPE_ADMIN_PERMISSION", "MISSING_EKM_CONNECTION_ADMIN_PERMISSION" ], "type": "string", "description": "Detailed error message if Ekm provisioning fails" } }, "id": "GoogleCloudAssuredworkloadsV1WorkloadEkmProvisioningResponse", "description": "External key management systems(EKM) Provisioning response", "type": "object" }, "GoogleCloudAssuredworkloadsV1MoveAnalysisResult": { "properties": { "warnings": { "type": "array", "description": "List of warnings. These are risks that may or may not result in compliance violations.", "items": { "$ref": "GoogleCloudAssuredworkloadsV1MoveImpact" } }, "blockers": { "description": "List of blockers. If not resolved, these will result in compliance violations in the target.", "items": { "$ref": "GoogleCloudAssuredworkloadsV1MoveImpact" }, "type": "array" } }, "description": "Represents the successful move analysis results for a group.", "id": "GoogleCloudAssuredworkloadsV1MoveAnalysisResult", "type": "object" }, "GoogleLongrunningListOperationsResponse": { "id": "GoogleLongrunningListOperationsResponse", "description": "The response message for Operations.ListOperations.", "type": "object", "properties": { "nextPageToken": { "description": "The standard List next-page token.", "type": "string" }, "operations": { "description": "A list of operations that matches the specified filter in the request.", "type": "array", "items": { "$ref": "GoogleLongrunningOperation" } } } }, "GoogleCloudAssuredworkloadsV1ViolationRemediationInstructionsConsole": { "id": "GoogleCloudAssuredworkloadsV1ViolationRemediationInstructionsConsole", "properties": { "steps": { "type": "array", "description": "Steps to resolve violation via cloud console", "items": { "type": "string" } }, "consoleUris": { "items": { "type": "string" }, "description": "Link to console page where violations can be resolved", "type": "array" }, "additionalLinks": { "items": { "type": "string" }, "type": "array", "description": "Additional urls for more information about steps" } }, "type": "object", "description": "Remediation instructions to resolve violation via cloud console" }, "GoogleCloudAssuredworkloadsV1ViolationRemediationInstructionsGcloud": { "type": "object", "properties": { "steps": { "type": "array", "description": "Steps to resolve violation via gcloud cli", "items": { "type": "string" } }, "additionalLinks": { "items": { "type": "string" }, "description": "Additional urls for more information about steps", "type": "array" }, "gcloudCommands": { "items": { "type": "string" }, "description": "Gcloud command to resolve violation", "type": "array" } }, "description": "Remediation instructions to resolve violation via gcloud cli", "id": "GoogleCloudAssuredworkloadsV1ViolationRemediationInstructionsGcloud" }, "GoogleCloudAssuredworkloadsV1WorkloadKMSSettings": { "description": "Settings specific to the Key Management Service.", "id": "GoogleCloudAssuredworkloadsV1WorkloadKMSSettings", "properties": { "rotationPeriod": { "type": "string", "format": "google-duration", "description": "Required. Input only. Immutable. [next_rotation_time] will be advanced by this period when the Key Management Service automatically rotates a key. Must be at least 24 hours and at most 876,000 hours." }, "nextRotationTime": { "description": "Required. Input only. Immutable. The time at which the Key Management Service will automatically create a new version of the crypto key and mark it as the primary.", "format": "google-datetime", "type": "string" } }, "deprecated": true, "type": "object" }, "GoogleCloudAssuredworkloadsV1AcknowledgeViolationRequest": { "properties": { "acknowledgeType": { "enumDescriptions": [ "Acknowledge type unspecified.", "Acknowledge only the specific violation.", "Acknowledge specified orgPolicy violation and also associated resource violations." ], "description": "Optional. Acknowledge type of specified violation.", "type": "string", "enum": [ "ACKNOWLEDGE_TYPE_UNSPECIFIED", "SINGLE_VIOLATION", "EXISTING_CHILD_RESOURCE_VIOLATIONS" ] }, "nonCompliantOrgPolicy": { "description": "Optional. This field is deprecated and will be removed in future version of the API. Name of the OrgPolicy which was modified with non-compliant change and resulted in this violation. Format: projects/{project_number}/policies/{constraint_name} folders/{folder_id}/policies/{constraint_name} organizations/{organization_id}/policies/{constraint_name}", "type": "string", "deprecated": true }, "comment": { "type": "string", "description": "Required. Business justification explaining the need for violation acknowledgement" } }, "description": "Request for acknowledging the violation", "id": "GoogleCloudAssuredworkloadsV1AcknowledgeViolationRequest", "type": "object" }, "GoogleCloudAssuredworkloadsV1MoveAnalysisGroup": { "id": "GoogleCloudAssuredworkloadsV1MoveAnalysisGroup", "description": "Represents a logical group of checks performed for an asset. If successful, the group contains the analysis result, otherwise it contains an error with the failure reason.", "type": "object", "properties": { "analysisResult": { "$ref": "GoogleCloudAssuredworkloadsV1MoveAnalysisResult", "description": "Result of a successful analysis." }, "error": { "$ref": "GoogleRpcStatus", "description": "Error details for a failed analysis." }, "displayName": { "description": "Name of the analysis group.", "type": "string" } } }, "GoogleCloudAssuredworkloadsV1ViolationExceptionContext": { "id": "GoogleCloudAssuredworkloadsV1ViolationExceptionContext", "description": "Violation exception detail.", "properties": { "comment": { "type": "string", "description": "Business justification provided towards the acknowledgement of the violation." }, "acknowledgementTime": { "format": "google-datetime", "description": "Timestamp when the violation was acknowledged.", "type": "string" }, "userName": { "type": "string", "description": "Name of the user (or service account) who acknowledged the violation." } }, "type": "object" }, "GoogleCloudAssuredworkloadsV1AnalyzeWorkloadMoveResponse": { "id": "GoogleCloudAssuredworkloadsV1AnalyzeWorkloadMoveResponse", "properties": { "nextPageToken": { "description": "The next page token. Is empty if the last page is reached.", "type": "string" }, "assetMoveAnalyses": { "type": "array", "description": "List of analysis results for each asset in scope.", "items": { "$ref": "GoogleCloudAssuredworkloadsV1AssetMoveAnalysis" } } }, "description": "Response containing the analysis results for the hypothetical resource move.", "type": "object" }, "GoogleCloudAssuredworkloadsV1MutatePartnerPermissionsRequest": { "type": "object", "properties": { "updateMask": { "type": "string", "format": "google-fieldmask", "description": "Required. The list of fields to be updated. E.g. update_mask { paths: \"partner_permissions.data_logs_viewer\"}" }, "partnerPermissions": { "description": "Required. The partner permissions to be updated.", "$ref": "GoogleCloudAssuredworkloadsV1WorkloadPartnerPermissions" }, "etag": { "type": "string", "description": "Optional. The etag of the workload. If this is provided, it must match the server's etag." } }, "description": "Request for updating permission settings for a partner workload.", "id": "GoogleCloudAssuredworkloadsV1MutatePartnerPermissionsRequest" }, "GoogleCloudAssuredworkloadsV1ListViolationsResponse": { "description": "Response of ListViolations endpoint.", "type": "object", "id": "GoogleCloudAssuredworkloadsV1ListViolationsResponse", "properties": { "nextPageToken": { "type": "string", "description": "The next page token. Returns empty if reached the last page." }, "violations": { "type": "array", "items": { "$ref": "GoogleCloudAssuredworkloadsV1Violation" }, "description": "List of Violations under a Workload." } } }, "GoogleCloudAssuredworkloadsV1RestrictAllowedResourcesResponse": { "id": "GoogleCloudAssuredworkloadsV1RestrictAllowedResourcesResponse", "description": "Response for restricting the list of allowed resources.", "properties": {}, "type": "object" }, "GoogleCloudAssuredworkloadsV1WorkloadSaaEnrollmentResponse": { "description": "Signed Access Approvals (SAA) enrollment response.", "id": "GoogleCloudAssuredworkloadsV1WorkloadSaaEnrollmentResponse", "properties": { "setupErrors": { "description": "Indicates SAA enrollment setup error if any.", "type": "array", "items": { "enumDescriptions": [ "Unspecified.", "Invalid states for all customers, to be redirected to AA UI for additional details.", "Returned when there is not an EKM key configured.", "Returned when there are no enrolled services or the customer is enrolled in CAA only for a subset of services.", "Returned when exception was encountered during evaluation of other criteria." ], "enum": [ "SETUP_ERROR_UNSPECIFIED", "ERROR_INVALID_BASE_SETUP", "ERROR_MISSING_EXTERNAL_SIGNING_KEY", "ERROR_NOT_ALL_SERVICES_ENROLLED", "ERROR_SETUP_CHECK_FAILED" ], "type": "string" } }, "setupStatus": { "enum": [ "SETUP_STATE_UNSPECIFIED", "STATUS_PENDING", "STATUS_COMPLETE" ], "description": "Indicates SAA enrollment status of a given workload.", "type": "string", "enumDescriptions": [ "Unspecified.", "SAA enrollment pending.", "SAA enrollment comopleted." ] } }, "type": "object" }, "GoogleCloudAssuredworkloadsV1AcknowledgeViolationResponse": { "description": "Response for violation acknowledgement", "type": "object", "properties": {}, "id": "GoogleCloudAssuredworkloadsV1AcknowledgeViolationResponse" } }, "batchPath": "batch", "basePath": "", "description": "", "kind": "discovery#restDescription", "icons": { "x16": "http://www.google.com/images/icons/product/search-16.gif", "x32": "http://www.google.com/images/icons/product/search-32.gif" }, "discoveryVersion": "v1", "canonicalName": "Assuredworkloads", "baseUrl": "https://assuredworkloads.googleapis.com/", "auth": { "oauth2": { "scopes": { "https://www.googleapis.com/auth/cloud-platform": { "description": "See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account." } } } }, "protocol": "rest", "id": "assuredworkloads:v1", "mtlsRootUrl": "https://assuredworkloads.mtls.googleapis.com/", "version": "v1", "documentationLink": "https://cloud.google.com/learnmoreurl", "parameters": { "upload_protocol": { "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").", "type": "string", "location": "query" }, "callback": { "description": "JSONP", "location": "query", "type": "string" }, "uploadType": { "type": "string", "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").", "location": "query" }, "quotaUser": { "type": "string", "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.", "location": "query" }, "$.xgafv": { "location": "query", "enum": [ "1", "2" ], "description": "V1 error format.", "enumDescriptions": [ "v1 error format", "v2 error format" ], "type": "string" }, "key": { "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.", "location": "query", "type": "string" }, "access_token": { "type": "string", "location": "query", "description": "OAuth access token." }, "oauth_token": { "type": "string", "location": "query", "description": "OAuth 2.0 token for the current user." }, "prettyPrint": { "type": "boolean", "description": "Returns response with indentations and line breaks.", "location": "query", "default": "true" }, "fields": { "location": "query", "description": "Selector specifying which fields to include in a partial response.", "type": "string" }, "alt": { "location": "query", "default": "json", "type": "string", "description": "Data format for response.", "enumDescriptions": [ "Responses with Content-Type of application/json", "Media download with context-dependent Content-Type", "Responses with Content-Type of application/x-protobuf" ], "enum": [ "json", "media", "proto" ] } }, "resources": { "organizations": { "resources": { "locations": { "resources": { "operations": { "methods": { "get": { "httpMethod": "GET", "id": "assuredworkloads.organizations.locations.operations.get", "parameters": { "name": { "required": true, "description": "The name of the operation resource.", "pattern": "^organizations/[^/]+/locations/[^/]+/operations/[^/]+$", "location": "path", "type": "string" } }, "path": "v1/{+name}", "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}/operations/{operationsId}", "response": { "$ref": "GoogleLongrunningOperation" }, "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] }, "list": { "httpMethod": "GET", "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}/operations", "id": "assuredworkloads.organizations.locations.operations.list", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "filter": { "location": "query", "description": "The standard list filter.", "type": "string" }, "pageSize": { "description": "The standard list page size.", "format": "int32", "type": "integer", "location": "query" }, "pageToken": { "description": "The standard list page token.", "location": "query", "type": "string" }, "name": { "pattern": "^organizations/[^/]+/locations/[^/]+$", "description": "The name of the operation's parent resource.", "location": "path", "required": true, "type": "string" } }, "path": "v1/{+name}/operations", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "parameterOrder": [ "name" ] } } }, "workloads": { "methods": { "list": { "id": "assuredworkloads.organizations.locations.workloads.list", "description": "Lists Assured Workloads under a CRM Node.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameterOrder": [ "parent" ], "path": "v1/{+parent}/workloads", "response": { "$ref": "GoogleCloudAssuredworkloadsV1ListWorkloadsResponse" }, "parameters": { "pageSize": { "description": "Page size.", "type": "integer", "location": "query", "format": "int32" }, "parent": { "description": "Required. Parent Resource to list workloads from. Must be of the form `organizations/{org_id}/locations/{location}`.", "required": true, "pattern": "^organizations/[^/]+/locations/[^/]+$", "location": "path", "type": "string" }, "filter": { "description": "A custom filter for filtering by properties of a workload. At this time, only filtering by labels is supported.", "type": "string", "location": "query" }, "pageToken": { "location": "query", "type": "string", "description": "Page token returned from previous request. Page token contains context from previous request. Page token needs to be passed in the second and following requests." } }, "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}/workloads" }, "create": { "response": { "$ref": "GoogleLongrunningOperation" }, "request": { "$ref": "GoogleCloudAssuredworkloadsV1Workload" }, "path": "v1/{+parent}/workloads", "description": "Creates Assured Workload.", "parameterOrder": [ "parent" ], "httpMethod": "POST", "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}/workloads", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "assuredworkloads.organizations.locations.workloads.create", "parameters": { "externalId": { "location": "query", "description": "Optional. A identifier associated with the workload and underlying projects which allows for the break down of billing costs for a workload. The value provided for the identifier will add a label to the workload and contained projects with the identifier as the value.", "type": "string" }, "parent": { "type": "string", "required": true, "location": "path", "description": "Required. The resource name of the new Workload's parent. Must be of the form `organizations/{org_id}/locations/{location_id}`.", "pattern": "^organizations/[^/]+/locations/[^/]+$" } } }, "enableResourceMonitoring": { "parameters": { "name": { "pattern": "^organizations/[^/]+/locations/[^/]+/workloads/[^/]+$", "required": true, "location": "path", "type": "string", "description": "Required. The `name` field is used to identify the workload. Format: organizations/{org_id}/locations/{location_id}/workloads/{workload_id}" } }, "httpMethod": "POST", "path": "v1/{+name}:enableResourceMonitoring", "response": { "$ref": "GoogleCloudAssuredworkloadsV1EnableResourceMonitoringResponse" }, "description": "Enable resource violation monitoring for a workload.", "parameterOrder": [ "name" ], "id": "assuredworkloads.organizations.locations.workloads.enableResourceMonitoring", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}/workloads/{workloadsId}:enableResourceMonitoring" }, "analyzeWorkloadMove": { "parameterOrder": [ "target" ], "id": "assuredworkloads.organizations.locations.workloads.analyzeWorkloadMove", "description": "Analyzes a hypothetical move of a source resource to a target workload to surface compliance risks. The analysis is best effort and is not guaranteed to be exhaustive.", "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}/workloads/{workloadsId}:analyzeWorkloadMove", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "pageSize": { "format": "int32", "location": "query", "type": "integer", "description": "Optional. Page size. If a value is not specified, the default value of 10 is used." }, "target": { "type": "string", "required": true, "description": "Required. The resource ID of the folder-based destination workload. This workload is where the source resource will hypothetically be moved to. Specify the workload's relative resource name, formatted as: \"organizations/{ORGANIZATION_ID}/locations/{LOCATION_ID}/workloads/{WORKLOAD_ID}\" For example: \"organizations/123/locations/us-east1/workloads/assured-workload-2\"", "location": "path", "pattern": "^organizations/[^/]+/locations/[^/]+/workloads/[^/]+$" }, "project": { "description": "The source type is a project. Specify the project's relative resource name, formatted as either a project number or a project ID: \"projects/{PROJECT_NUMBER}\" or \"projects/{PROJECT_ID}\" For example: \"projects/951040570662\" when specifying a project number, or \"projects/my-project-123\" when specifying a project ID.", "location": "query", "type": "string" }, "assetTypes": { "description": "Optional. List of asset types to be analyzed, including and under the source resource. If empty, all assets are analyzed. The complete list of asset types is available [here](https://cloud.google.com/asset-inventory/docs/supported-asset-types).", "type": "string", "repeated": true, "location": "query" }, "pageToken": { "description": "Optional. The page token from the previous response. It needs to be passed in the second and following requests.", "location": "query", "type": "string" } }, "response": { "$ref": "GoogleCloudAssuredworkloadsV1AnalyzeWorkloadMoveResponse" }, "httpMethod": "GET", "path": "v1/{+target}:analyzeWorkloadMove" }, "restrictAllowedResources": { "response": { "$ref": "GoogleCloudAssuredworkloadsV1RestrictAllowedResourcesResponse" }, "parameterOrder": [ "name" ], "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}/workloads/{workloadsId}:restrictAllowedResources", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}:restrictAllowedResources", "request": { "$ref": "GoogleCloudAssuredworkloadsV1RestrictAllowedResourcesRequest" }, "httpMethod": "POST", "parameters": { "name": { "description": "Required. The resource name of the Workload. This is the workloads's relative path in the API, formatted as \"organizations/{organization_id}/locations/{location_id}/workloads/{workload_id}\". For example, \"organizations/123/locations/us-east1/workloads/assured-workload-1\".", "type": "string", "location": "path", "pattern": "^organizations/[^/]+/locations/[^/]+/workloads/[^/]+$", "required": true } }, "id": "assuredworkloads.organizations.locations.workloads.restrictAllowedResources", "description": "Restrict 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." }, "get": { "response": { "$ref": "GoogleCloudAssuredworkloadsV1Workload" }, "id": "assuredworkloads.organizations.locations.workloads.get", "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}/workloads/{workloadsId}", "httpMethod": "GET", "description": "Gets Assured Workload associated with a CRM Node", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "type": "string", "pattern": "^organizations/[^/]+/locations/[^/]+/workloads/[^/]+$", "description": "Required. The resource name of the Workload to fetch. This is the workloads's relative path in the API, formatted as \"organizations/{organization_id}/locations/{location_id}/workloads/{workload_id}\". For example, \"organizations/123/locations/us-east1/workloads/assured-workload-1\".", "location": "path", "required": true } }, "parameterOrder": [ "name" ], "path": "v1/{+name}" }, "mutatePartnerPermissions": { "httpMethod": "PATCH", "parameters": { "name": { "type": "string", "description": "Required. The `name` field is used to identify the workload. Format: organizations/{org_id}/locations/{location_id}/workloads/{workload_id}", "pattern": "^organizations/[^/]+/locations/[^/]+/workloads/[^/]+$", "required": true, "location": "path" } }, "response": { "$ref": "GoogleCloudAssuredworkloadsV1Workload" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "assuredworkloads.organizations.locations.workloads.mutatePartnerPermissions", "parameterOrder": [ "name" ], "request": { "$ref": "GoogleCloudAssuredworkloadsV1MutatePartnerPermissionsRequest" }, "description": "Update 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.", "path": "v1/{+name}:mutatePartnerPermissions", "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}/workloads/{workloadsId}:mutatePartnerPermissions" }, "patch": { "httpMethod": "PATCH", "description": "Updates 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.", "path": "v1/{+name}", "parameterOrder": [ "name" ], "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}/workloads/{workloadsId}", "parameters": { "name": { "description": "Optional. The resource name of the workload. Format: organizations/{organization}/locations/{location}/workloads/{workload} Read-only.", "required": true, "pattern": "^organizations/[^/]+/locations/[^/]+/workloads/[^/]+$", "location": "path", "type": "string" }, "updateMask": { "location": "query", "type": "string", "description": "Required. The list of fields to be updated.", "format": "google-fieldmask" } }, "id": "assuredworkloads.organizations.locations.workloads.patch", "request": { "$ref": "GoogleCloudAssuredworkloadsV1Workload" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudAssuredworkloadsV1Workload" } }, "delete": { "path": "v1/{+name}", "description": "Deletes 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.", "httpMethod": "DELETE", "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}/workloads/{workloadsId}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleProtobufEmpty" }, "id": "assuredworkloads.organizations.locations.workloads.delete", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "etag": { "description": "Optional. The etag of the workload. If this is provided, it must match the server's etag.", "location": "query", "type": "string" }, "name": { "type": "string", "required": true, "location": "path", "pattern": "^organizations/[^/]+/locations/[^/]+/workloads/[^/]+$", "description": "Required. The `name` field is used to identify the workload. Format: organizations/{org_id}/locations/{location_id}/workloads/{workload_id}" } } } }, "resources": { "violations": { "methods": { "acknowledge": { "id": "assuredworkloads.organizations.locations.workloads.violations.acknowledge", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "description": "Acknowledges an existing violation. By acknowledging a violation, users acknowledge the existence of a compliance violation in their workload and decide to ignore it due to a valid business justification. Acknowledgement is a permanent operation and it cannot be reverted.", "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}/workloads/{workloadsId}/violations/{violationsId}:acknowledge", "parameters": { "name": { "required": true, "location": "path", "pattern": "^organizations/[^/]+/locations/[^/]+/workloads/[^/]+/violations/[^/]+$", "type": "string", "description": "Required. The resource name of the Violation to acknowledge. Format: organizations/{organization}/locations/{location}/workloads/{workload}/violations/{violation}" } }, "response": { "$ref": "GoogleCloudAssuredworkloadsV1AcknowledgeViolationResponse" }, "request": { "$ref": "GoogleCloudAssuredworkloadsV1AcknowledgeViolationRequest" }, "path": "v1/{+name}:acknowledge", "parameterOrder": [ "name" ] }, "get": { "parameterOrder": [ "name" ], "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}/workloads/{workloadsId}/violations/{violationsId}", "parameters": { "name": { "pattern": "^organizations/[^/]+/locations/[^/]+/workloads/[^/]+/violations/[^/]+$", "required": true, "location": "path", "type": "string", "description": "Required. The resource name of the Violation to fetch (ie. Violation.name). Format: organizations/{organization}/locations/{location}/workloads/{workload}/violations/{violation}" } }, "path": "v1/{+name}", "response": { "$ref": "GoogleCloudAssuredworkloadsV1Violation" }, "httpMethod": "GET", "id": "assuredworkloads.organizations.locations.workloads.violations.get", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Retrieves Assured Workload Violation based on ID." }, "list": { "path": "v1/{+parent}/violations", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Lists the Violations in the AssuredWorkload Environment. Callers may also choose to read across multiple Workloads as per [AIP-159](https://google.aip.dev/159) by using '-' (the hyphen or dash character) as a wildcard character instead of workload-id in the parent. Format `organizations/{org_id}/locations/{location}/workloads/-`", "id": "assuredworkloads.organizations.locations.workloads.violations.list", "httpMethod": "GET", "response": { "$ref": "GoogleCloudAssuredworkloadsV1ListViolationsResponse" }, "parameterOrder": [ "parent" ], "parameters": { "filter": { "location": "query", "description": "Optional. A custom filter for filtering by the Violations properties.", "type": "string" }, "interval.endTime": { "location": "query", "type": "string", "description": "The end of the time window.", "format": "google-datetime" }, "parent": { "required": true, "type": "string", "location": "path", "description": "Required. The Workload name. Format `organizations/{org_id}/locations/{location}/workloads/{workload}`.", "pattern": "^organizations/[^/]+/locations/[^/]+/workloads/[^/]+$" }, "pageSize": { "type": "integer", "format": "int32", "location": "query", "description": "Optional. Page size." }, "interval.startTime": { "location": "query", "type": "string", "format": "google-datetime", "description": "The start of the time window." }, "pageToken": { "location": "query", "description": "Optional. Page token returned from previous request.", "type": "string" } }, "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}/workloads/{workloadsId}/violations" } } } } } } } } } }, "version_module": true, "title": "Assured Workloads API", "revision": "20240422", "rootUrl": "https://assuredworkloads.googleapis.com/", "ownerName": "Google", "name": "assuredworkloads", "ownerDomain": "google.com", "servicePath": "", "fullyEncodeReservedExpansion": true }