From cc74e2780e8e80810cf9db73035d91a0eff46ab3 Mon Sep 17 00:00:00 2001 From: Google APIs Date: Sat, 25 Jul 2020 00:38:17 +0000 Subject: [PATCH] Autogenerated update (2020-07-25) Update: - cloudfunctions_v1 - cloudresourcemanager_v1 - cloudresourcemanager_v1beta1 - cloudresourcemanager_v2 - cloudresourcemanager_v2beta1 - customsearch_v1 - dataflow_v1b3 - displayvideo_v1 - redis_v1beta1 - sasportal_v1alpha1 - youtube_partner_v1 --- api_names_out.yaml | 170 +++ generated/google/apis/cloudfunctions_v1.rb | 2 +- .../google/apis/cloudfunctions_v1/classes.rb | 45 - .../apis/cloudfunctions_v1/representations.rb | 17 - .../google/apis/cloudresourcemanager_v1.rb | 2 +- .../apis/cloudresourcemanager_v1/classes.rb | 1257 +++++++---------- .../apis/cloudresourcemanager_v1/service.rb | 447 +++--- .../apis/cloudresourcemanager_v1beta1.rb | 2 +- .../cloudresourcemanager_v1beta1/classes.rb | 687 ++++----- .../cloudresourcemanager_v1beta1/service.rb | 314 ++-- .../google/apis/cloudresourcemanager_v2.rb | 2 +- .../apis/cloudresourcemanager_v2/classes.rb | 672 ++++----- .../apis/cloudresourcemanager_v2/service.rb | 225 ++- .../apis/cloudresourcemanager_v2beta1.rb | 2 +- .../cloudresourcemanager_v2beta1/classes.rb | 672 ++++----- .../cloudresourcemanager_v2beta1/service.rb | 225 ++- generated/google/apis/customsearch_v1.rb | 2 +- .../google/apis/customsearch_v1/classes.rb | 24 +- .../google/apis/customsearch_v1/service.rb | 12 +- generated/google/apis/dataflow_v1b3.rb | 2 +- .../google/apis/dataflow_v1b3/classes.rb | 3 +- generated/google/apis/displayvideo_v1.rb | 5 +- .../google/apis/displayvideo_v1/classes.rb | 518 +++++++ .../apis/displayvideo_v1/representations.rb | 264 ++++ .../google/apis/displayvideo_v1/service.rb | 572 +++++++- generated/google/apis/redis_v1beta1.rb | 2 +- .../google/apis/redis_v1beta1/classes.rb | 397 ++++++ .../apis/redis_v1beta1/representations.rb | 139 ++ generated/google/apis/sasportal_v1alpha1.rb | 2 +- .../google/apis/sasportal_v1alpha1/classes.rb | 73 - .../sasportal_v1alpha1/representations.rb | 32 - .../google/apis/sasportal_v1alpha1/service.rb | 477 ------- generated/google/apis/youtube_partner_v1.rb | 2 +- 33 files changed, 3894 insertions(+), 3373 deletions(-) diff --git a/api_names_out.yaml b/api_names_out.yaml index 3c10192f9..d48d5d6d3 100644 --- a/api_names_out.yaml +++ b/api_names_out.yaml @@ -83835,6 +83835,11 @@ "/displayvideo:v1/AssignedTargetingOption/userRewardedContentDetails": user_rewarded_content_details "/displayvideo:v1/AssignedTargetingOption/videoPlayerSizeDetails": video_player_size_details "/displayvideo:v1/AssignedTargetingOption/viewabilityDetails": viewability_details +"/displayvideo:v1/AssignedUserRole": assigned_user_role +"/displayvideo:v1/AssignedUserRole/advertiserId": advertiser_id +"/displayvideo:v1/AssignedUserRole/assignedUserRoleId": assigned_user_role_id +"/displayvideo:v1/AssignedUserRole/partnerId": partner_id +"/displayvideo:v1/AssignedUserRole/userRole": user_role "/displayvideo:v1/AudienceGroupAssignedTargetingOptionDetails": audience_group_assigned_targeting_option_details "/displayvideo:v1/AudienceGroupAssignedTargetingOptionDetails/excludedFirstAndThirdPartyAudienceGroup": excluded_first_and_third_party_audience_group "/displayvideo:v1/AudienceGroupAssignedTargetingOptionDetails/excludedGoogleAudienceGroup": excluded_google_audience_group @@ -83847,6 +83852,10 @@ "/displayvideo:v1/AudioVideoOffset": audio_video_offset "/displayvideo:v1/AudioVideoOffset/percentage": percentage "/displayvideo:v1/AudioVideoOffset/seconds": seconds +"/displayvideo:v1/AuditAdvertiserResponse": audit_advertiser_response +"/displayvideo:v1/AuditAdvertiserResponse/usedCampaignsCount": used_campaigns_count +"/displayvideo:v1/AuditAdvertiserResponse/usedInsertionOrdersCount": used_insertion_orders_count +"/displayvideo:v1/AuditAdvertiserResponse/usedLineItemsCount": used_line_items_count "/displayvideo:v1/AuthorizedSellerStatusAssignedTargetingOptionDetails": authorized_seller_status_assigned_targeting_option_details "/displayvideo:v1/AuthorizedSellerStatusAssignedTargetingOptionDetails/authorizedSellerStatus": authorized_seller_status "/displayvideo:v1/AuthorizedSellerStatusAssignedTargetingOptionDetails/targetingOptionId": targeting_option_id @@ -83889,6 +83898,14 @@ "/displayvideo:v1/BulkEditAssignedLocationsResponse": bulk_edit_assigned_locations_response "/displayvideo:v1/BulkEditAssignedLocationsResponse/assignedLocations": assigned_locations "/displayvideo:v1/BulkEditAssignedLocationsResponse/assignedLocations/assigned_location": assigned_location +"/displayvideo:v1/BulkEditAssignedUserRolesRequest": bulk_edit_assigned_user_roles_request +"/displayvideo:v1/BulkEditAssignedUserRolesRequest/createdAssignedUserRoles": created_assigned_user_roles +"/displayvideo:v1/BulkEditAssignedUserRolesRequest/createdAssignedUserRoles/created_assigned_user_role": created_assigned_user_role +"/displayvideo:v1/BulkEditAssignedUserRolesRequest/deletedAssignedUserRoles": deleted_assigned_user_roles +"/displayvideo:v1/BulkEditAssignedUserRolesRequest/deletedAssignedUserRoles/deleted_assigned_user_role": deleted_assigned_user_role +"/displayvideo:v1/BulkEditAssignedUserRolesResponse": bulk_edit_assigned_user_roles_response +"/displayvideo:v1/BulkEditAssignedUserRolesResponse/createdAssignedUserRoles": created_assigned_user_roles +"/displayvideo:v1/BulkEditAssignedUserRolesResponse/createdAssignedUserRoles/created_assigned_user_role": created_assigned_user_role "/displayvideo:v1/BulkEditLineItemAssignedTargetingOptionsRequest": bulk_edit_line_item_assigned_targeting_options_request "/displayvideo:v1/BulkEditLineItemAssignedTargetingOptionsRequest/createRequests": create_requests "/displayvideo:v1/BulkEditLineItemAssignedTargetingOptionsRequest/createRequests/create_request": create_request @@ -83906,6 +83923,15 @@ "/displayvideo:v1/BulkEditNegativeKeywordsResponse": bulk_edit_negative_keywords_response "/displayvideo:v1/BulkEditNegativeKeywordsResponse/negativeKeywords": negative_keywords "/displayvideo:v1/BulkEditNegativeKeywordsResponse/negativeKeywords/negative_keyword": negative_keyword +"/displayvideo:v1/BulkEditPartnerAssignedTargetingOptionsRequest": bulk_edit_partner_assigned_targeting_options_request +"/displayvideo:v1/BulkEditPartnerAssignedTargetingOptionsRequest/createRequests": create_requests +"/displayvideo:v1/BulkEditPartnerAssignedTargetingOptionsRequest/createRequests/create_request": create_request +"/displayvideo:v1/BulkEditPartnerAssignedTargetingOptionsRequest/deleteRequests": delete_requests +"/displayvideo:v1/BulkEditPartnerAssignedTargetingOptionsRequest/deleteRequests/delete_request": delete_request +"/displayvideo:v1/BulkEditPartnerAssignedTargetingOptionsResponse": bulk_edit_partner_assigned_targeting_options_response +"/displayvideo:v1/BulkEditPartnerAssignedTargetingOptionsResponse/createdAssignedTargetingOptions": created_assigned_targeting_options +? "/displayvideo:v1/BulkEditPartnerAssignedTargetingOptionsResponse/createdAssignedTargetingOptions/created_assigned_targeting_option" +: created_assigned_targeting_option "/displayvideo:v1/BulkEditSitesRequest": bulk_edit_sites_request "/displayvideo:v1/BulkEditSitesRequest/advertiserId": advertiser_id "/displayvideo:v1/BulkEditSitesRequest/createdSites": created_sites @@ -84155,6 +84181,14 @@ "/displayvideo:v1/EnvironmentTargetingOptionDetails/environment": environment "/displayvideo:v1/ExchangeAssignedTargetingOptionDetails": exchange_assigned_targeting_option_details "/displayvideo:v1/ExchangeAssignedTargetingOptionDetails/targetingOptionId": targeting_option_id +"/displayvideo:v1/ExchangeConfig": exchange_config +"/displayvideo:v1/ExchangeConfig/enabledExchanges": enabled_exchanges +"/displayvideo:v1/ExchangeConfig/enabledExchanges/enabled_exchange": enabled_exchange +"/displayvideo:v1/ExchangeConfigEnabledExchange": exchange_config_enabled_exchange +"/displayvideo:v1/ExchangeConfigEnabledExchange/exchange": exchange +"/displayvideo:v1/ExchangeConfigEnabledExchange/googleAdManagerAgencyId": google_ad_manager_agency_id +"/displayvideo:v1/ExchangeConfigEnabledExchange/googleAdManagerBuyerNetworkId": google_ad_manager_buyer_network_id +"/displayvideo:v1/ExchangeConfigEnabledExchange/seatId": seat_id "/displayvideo:v1/ExchangeReviewStatus": exchange_review_status "/displayvideo:v1/ExchangeReviewStatus/exchange": exchange "/displayvideo:v1/ExchangeReviewStatus/status": status @@ -84442,6 +84476,14 @@ "/displayvideo:v1/ListNegativeKeywordsResponse/negativeKeywords": negative_keywords "/displayvideo:v1/ListNegativeKeywordsResponse/negativeKeywords/negative_keyword": negative_keyword "/displayvideo:v1/ListNegativeKeywordsResponse/nextPageToken": next_page_token +"/displayvideo:v1/ListPartnerAssignedTargetingOptionsResponse": list_partner_assigned_targeting_options_response +"/displayvideo:v1/ListPartnerAssignedTargetingOptionsResponse/assignedTargetingOptions": assigned_targeting_options +"/displayvideo:v1/ListPartnerAssignedTargetingOptionsResponse/assignedTargetingOptions/assigned_targeting_option": assigned_targeting_option +"/displayvideo:v1/ListPartnerAssignedTargetingOptionsResponse/nextPageToken": next_page_token +"/displayvideo:v1/ListPartnersResponse": list_partners_response +"/displayvideo:v1/ListPartnersResponse/nextPageToken": next_page_token +"/displayvideo:v1/ListPartnersResponse/partners": partners +"/displayvideo:v1/ListPartnersResponse/partners/partner": partner "/displayvideo:v1/ListSitesResponse": list_sites_response "/displayvideo:v1/ListSitesResponse/nextPageToken": next_page_token "/displayvideo:v1/ListSitesResponse/sites": sites @@ -84450,6 +84492,10 @@ "/displayvideo:v1/ListTargetingOptionsResponse/nextPageToken": next_page_token "/displayvideo:v1/ListTargetingOptionsResponse/targetingOptions": targeting_options "/displayvideo:v1/ListTargetingOptionsResponse/targetingOptions/targeting_option": targeting_option +"/displayvideo:v1/ListUsersResponse": list_users_response +"/displayvideo:v1/ListUsersResponse/nextPageToken": next_page_token +"/displayvideo:v1/ListUsersResponse/users": users +"/displayvideo:v1/ListUsersResponse/users/user": user "/displayvideo:v1/LocationList": location_list "/displayvideo:v1/LocationList/advertiserId": advertiser_id "/displayvideo:v1/LocationList/displayName": display_name @@ -84462,6 +84508,9 @@ "/displayvideo:v1/MaximizeSpendBidStrategy": maximize_spend_bid_strategy "/displayvideo:v1/MaximizeSpendBidStrategy/maxAverageCpmBidAmountMicros": max_average_cpm_bid_amount_micros "/displayvideo:v1/MaximizeSpendBidStrategy/performanceGoalType": performance_goal_type +"/displayvideo:v1/MeasurementConfig": measurement_config +"/displayvideo:v1/MeasurementConfig/dv360ToCmCostReportingEnabled": dv360_to_cm_cost_reporting_enabled +"/displayvideo:v1/MeasurementConfig/dv360ToCmDataSharingEnabled": dv360_to_cm_data_sharing_enabled "/displayvideo:v1/Money": money "/displayvideo:v1/Money/currencyCode": currency_code "/displayvideo:v1/Money/nanos": nanos @@ -84520,12 +84569,29 @@ "/displayvideo:v1/ParentalStatusAssignedTargetingOptionDetails/targetingOptionId": targeting_option_id "/displayvideo:v1/ParentalStatusTargetingOptionDetails": parental_status_targeting_option_details "/displayvideo:v1/ParentalStatusTargetingOptionDetails/parentalStatus": parental_status +"/displayvideo:v1/Partner": partner +"/displayvideo:v1/Partner/adServerConfig": ad_server_config +"/displayvideo:v1/Partner/dataAccessConfig": data_access_config +"/displayvideo:v1/Partner/displayName": display_name +"/displayvideo:v1/Partner/entityStatus": entity_status +"/displayvideo:v1/Partner/exchangeConfig": exchange_config +"/displayvideo:v1/Partner/generalConfig": general_config +"/displayvideo:v1/Partner/name": name +"/displayvideo:v1/Partner/partnerId": partner_id +"/displayvideo:v1/Partner/updateTime": update_time +"/displayvideo:v1/PartnerAdServerConfig": partner_ad_server_config +"/displayvideo:v1/PartnerAdServerConfig/measurementConfig": measurement_config "/displayvideo:v1/PartnerCost": partner_cost "/displayvideo:v1/PartnerCost/costType": cost_type "/displayvideo:v1/PartnerCost/feeAmount": fee_amount "/displayvideo:v1/PartnerCost/feePercentageMillis": fee_percentage_millis "/displayvideo:v1/PartnerCost/feeType": fee_type "/displayvideo:v1/PartnerCost/invoiceType": invoice_type +"/displayvideo:v1/PartnerDataAccessConfig": partner_data_access_config +"/displayvideo:v1/PartnerDataAccessConfig/sdfConfig": sdf_config +"/displayvideo:v1/PartnerGeneralConfig": partner_general_config +"/displayvideo:v1/PartnerGeneralConfig/currencyCode": currency_code +"/displayvideo:v1/PartnerGeneralConfig/timeZone": time_zone "/displayvideo:v1/PartnerRevenueModel": partner_revenue_model "/displayvideo:v1/PartnerRevenueModel/markupAmount": markup_amount "/displayvideo:v1/PartnerRevenueModel/markupType": markup_type @@ -84651,6 +84717,13 @@ "/displayvideo:v1/UrlAssignedTargetingOptionDetails": url_assigned_targeting_option_details "/displayvideo:v1/UrlAssignedTargetingOptionDetails/negative": negative "/displayvideo:v1/UrlAssignedTargetingOptionDetails/url": url +"/displayvideo:v1/User": user +"/displayvideo:v1/User/assignedUserRoles": assigned_user_roles +"/displayvideo:v1/User/assignedUserRoles/assigned_user_role": assigned_user_role +"/displayvideo:v1/User/displayName": display_name +"/displayvideo:v1/User/email": email +"/displayvideo:v1/User/name": name +"/displayvideo:v1/User/userId": user_id "/displayvideo:v1/UserRewardedContentAssignedTargetingOptionDetails": user_rewarded_content_assigned_targeting_option_details "/displayvideo:v1/UserRewardedContentAssignedTargetingOptionDetails/targetingOptionId": targeting_option_id "/displayvideo:v1/UserRewardedContentAssignedTargetingOptionDetails/userRewardedContent": user_rewarded_content @@ -84668,6 +84741,9 @@ "/displayvideo:v1/ViewabilityTargetingOptionDetails/viewability": viewability "/displayvideo:v1/displayvideo.advertisers.assets.upload": upload_advertiser_asset "/displayvideo:v1/displayvideo.advertisers.assets.upload/advertiserId": advertiser_id +"/displayvideo:v1/displayvideo.advertisers.audit": audit_advertiser +"/displayvideo:v1/displayvideo.advertisers.audit/advertiserId": advertiser_id +"/displayvideo:v1/displayvideo.advertisers.audit/readMask": read_mask "/displayvideo:v1/displayvideo.advertisers.bulkEditAdvertiserAssignedTargetingOptions": bulk_edit_advertiser_assigned_targeting_options "/displayvideo:v1/displayvideo.advertisers.bulkEditAdvertiserAssignedTargetingOptions/advertiserId": advertiser_id "/displayvideo:v1/displayvideo.advertisers.bulkListAdvertiserAssignedTargetingOptions": bulk_advertiser_list_advertiser_assigned_targeting_options @@ -85019,6 +85095,8 @@ "/displayvideo:v1/displayvideo.inventorySources.list/partnerId": partner_id "/displayvideo:v1/displayvideo.media.download": download_medium "/displayvideo:v1/displayvideo.media.download/resourceName": resource_name +"/displayvideo:v1/displayvideo.partners.bulkEditPartnerAssignedTargetingOptions": bulk_edit_partner_assigned_targeting_options +"/displayvideo:v1/displayvideo.partners.bulkEditPartnerAssignedTargetingOptions/partnerId": partner_id "/displayvideo:v1/displayvideo.partners.channels.create": create_partner_channel "/displayvideo:v1/displayvideo.partners.channels.create/advertiserId": advertiser_id "/displayvideo:v1/displayvideo.partners.channels.create/partnerId": partner_id @@ -85058,6 +85136,31 @@ "/displayvideo:v1/displayvideo.partners.channels.sites.list/pageSize": page_size "/displayvideo:v1/displayvideo.partners.channels.sites.list/pageToken": page_token "/displayvideo:v1/displayvideo.partners.channels.sites.list/partnerId": partner_id +"/displayvideo:v1/displayvideo.partners.get": get_partner +"/displayvideo:v1/displayvideo.partners.get/partnerId": partner_id +"/displayvideo:v1/displayvideo.partners.list": list_partners +"/displayvideo:v1/displayvideo.partners.list/filter": filter +"/displayvideo:v1/displayvideo.partners.list/orderBy": order_by +"/displayvideo:v1/displayvideo.partners.list/pageSize": page_size +"/displayvideo:v1/displayvideo.partners.list/pageToken": page_token +"/displayvideo:v1/displayvideo.partners.targetingTypes.assignedTargetingOptions.create": create_partner_targeting_type_assigned_targeting_option +"/displayvideo:v1/displayvideo.partners.targetingTypes.assignedTargetingOptions.create/partnerId": partner_id +"/displayvideo:v1/displayvideo.partners.targetingTypes.assignedTargetingOptions.create/targetingType": targeting_type +"/displayvideo:v1/displayvideo.partners.targetingTypes.assignedTargetingOptions.delete": delete_partner_targeting_type_assigned_targeting_option +"/displayvideo:v1/displayvideo.partners.targetingTypes.assignedTargetingOptions.delete/assignedTargetingOptionId": assigned_targeting_option_id +"/displayvideo:v1/displayvideo.partners.targetingTypes.assignedTargetingOptions.delete/partnerId": partner_id +"/displayvideo:v1/displayvideo.partners.targetingTypes.assignedTargetingOptions.delete/targetingType": targeting_type +"/displayvideo:v1/displayvideo.partners.targetingTypes.assignedTargetingOptions.get": get_partner_targeting_type_assigned_targeting_option +"/displayvideo:v1/displayvideo.partners.targetingTypes.assignedTargetingOptions.get/assignedTargetingOptionId": assigned_targeting_option_id +"/displayvideo:v1/displayvideo.partners.targetingTypes.assignedTargetingOptions.get/partnerId": partner_id +"/displayvideo:v1/displayvideo.partners.targetingTypes.assignedTargetingOptions.get/targetingType": targeting_type +"/displayvideo:v1/displayvideo.partners.targetingTypes.assignedTargetingOptions.list": list_partner_targeting_type_assigned_targeting_options +"/displayvideo:v1/displayvideo.partners.targetingTypes.assignedTargetingOptions.list/filter": filter +"/displayvideo:v1/displayvideo.partners.targetingTypes.assignedTargetingOptions.list/orderBy": order_by +"/displayvideo:v1/displayvideo.partners.targetingTypes.assignedTargetingOptions.list/pageSize": page_size +"/displayvideo:v1/displayvideo.partners.targetingTypes.assignedTargetingOptions.list/pageToken": page_token +"/displayvideo:v1/displayvideo.partners.targetingTypes.assignedTargetingOptions.list/partnerId": partner_id +"/displayvideo:v1/displayvideo.partners.targetingTypes.assignedTargetingOptions.list/targetingType": targeting_type "/displayvideo:v1/displayvideo.sdfdownloadtasks.create": create_sdfdownloadtask_sdf_download_task "/displayvideo:v1/displayvideo.sdfdownloadtasks.operations.get": get_sdfdownloadtask_operation "/displayvideo:v1/displayvideo.sdfdownloadtasks.operations.get/name": name @@ -85072,6 +85175,21 @@ "/displayvideo:v1/displayvideo.targetingTypes.targetingOptions.list/pageSize": page_size "/displayvideo:v1/displayvideo.targetingTypes.targetingOptions.list/pageToken": page_token "/displayvideo:v1/displayvideo.targetingTypes.targetingOptions.list/targetingType": targeting_type +"/displayvideo:v1/displayvideo.users.bulkEditAssignedUserRoles": bulk_edit_assigned_user_roles +"/displayvideo:v1/displayvideo.users.bulkEditAssignedUserRoles/userId": user_id +"/displayvideo:v1/displayvideo.users.create": create_user +"/displayvideo:v1/displayvideo.users.delete": delete_user +"/displayvideo:v1/displayvideo.users.delete/userId": user_id +"/displayvideo:v1/displayvideo.users.get": get_user +"/displayvideo:v1/displayvideo.users.get/userId": user_id +"/displayvideo:v1/displayvideo.users.list": list_users +"/displayvideo:v1/displayvideo.users.list/filter": filter +"/displayvideo:v1/displayvideo.users.list/orderBy": order_by +"/displayvideo:v1/displayvideo.users.list/pageSize": page_size +"/displayvideo:v1/displayvideo.users.list/pageToken": page_token +"/displayvideo:v1/displayvideo.users.patch": patch_user +"/displayvideo:v1/displayvideo.users.patch/updateMask": update_mask +"/displayvideo:v1/displayvideo.users.patch/userId": user_id "/displayvideo:v1/fields": fields "/displayvideo:v1/key": key "/displayvideo:v1/quotaUser": quota_user @@ -114668,6 +114786,58 @@ "/redis:v1beta1/GoogleCloudRedisV1beta1LocationMetadata/availableZones": available_zones "/redis:v1beta1/GoogleCloudRedisV1beta1LocationMetadata/availableZones/available_zone": available_zone "/redis:v1beta1/GoogleCloudRedisV1beta1ZoneMetadata": google_cloud_redis_v1beta1_zone_metadata +"/redis:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1Instance": google_cloud_saasaccelerator_management_providers_v1_instance +"/redis:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1Instance/consumerDefinedName": consumer_defined_name +"/redis:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1Instance/createTime": create_time +"/redis:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1Instance/labels": labels +"/redis:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1Instance/labels/label": label +"/redis:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1Instance/maintenancePolicyNames": maintenance_policy_names +"/redis:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1Instance/maintenancePolicyNames/maintenance_policy_name": maintenance_policy_name +"/redis:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1Instance/maintenanceSchedules": maintenance_schedules +"/redis:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1Instance/maintenanceSchedules/maintenance_schedule": maintenance_schedule +"/redis:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1Instance/maintenanceSettings": maintenance_settings +"/redis:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1Instance/name": name +"/redis:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1Instance/producerMetadata": producer_metadata +"/redis:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1Instance/producerMetadata/producer_metadatum": producer_metadatum +"/redis:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1Instance/provisionedResources": provisioned_resources +"/redis:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1Instance/provisionedResources/provisioned_resource": provisioned_resource +"/redis:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1Instance/slmInstanceTemplate": slm_instance_template +"/redis:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1Instance/sloMetadata": slo_metadata +"/redis:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1Instance/softwareVersions": software_versions +"/redis:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1Instance/softwareVersions/software_version": software_version +"/redis:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1Instance/state": state +"/redis:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1Instance/tenantProjectId": tenant_project_id +"/redis:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1Instance/updateTime": update_time +"/redis:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSchedule": google_cloud_saasaccelerator_management_providers_v1_maintenance_schedule +"/redis:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSchedule/canReschedule": can_reschedule +"/redis:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSchedule/endTime": end_time +"/redis:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSchedule/rolloutManagementPolicy": rollout_management_policy +"/redis:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSchedule/startTime": start_time +"/redis:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSettings": google_cloud_saasaccelerator_management_providers_v1_maintenance_settings +"/redis:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSettings/exclude": exclude +"/redis:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata": google_cloud_saasaccelerator_management_providers_v1_node_slo_metadata +"/redis:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata/exclusions": exclusions +"/redis:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata/exclusions/exclusion": exclusion +"/redis:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata/location": location +"/redis:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata/nodeId": node_id +"/redis:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1ProvisionedResource": google_cloud_saasaccelerator_management_providers_v1_provisioned_resource +"/redis:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1ProvisionedResource/resourceType": resource_type +"/redis:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1ProvisionedResource/resourceUrl": resource_url +"/redis:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1SloEligibility": google_cloud_saasaccelerator_management_providers_v1_slo_eligibility +"/redis:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1SloEligibility/eligible": eligible +"/redis:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1SloEligibility/reason": reason +"/redis:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion": google_cloud_saasaccelerator_management_providers_v1_slo_exclusion +"/redis:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion/duration": duration +"/redis:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion/reason": reason +"/redis:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion/sliName": sli_name +"/redis:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion/startTime": start_time +"/redis:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata": google_cloud_saasaccelerator_management_providers_v1_slo_metadata +"/redis:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata/eligibility": eligibility +"/redis:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata/exclusions": exclusions +"/redis:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata/exclusions/exclusion": exclusion +"/redis:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata/nodes": nodes +"/redis:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata/nodes/node": node +"/redis:v1beta1/GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata/tier": tier "/redis:v1beta1/ImportInstanceRequest": import_instance_request "/redis:v1beta1/ImportInstanceRequest/inputConfig": input_config "/redis:v1beta1/InputConfig": input_config diff --git a/generated/google/apis/cloudfunctions_v1.rb b/generated/google/apis/cloudfunctions_v1.rb index f8e427ef7..73d746459 100644 --- a/generated/google/apis/cloudfunctions_v1.rb +++ b/generated/google/apis/cloudfunctions_v1.rb @@ -25,7 +25,7 @@ module Google # @see https://cloud.google.com/functions module CloudfunctionsV1 VERSION = 'V1' - REVISION = '20200629' + REVISION = '20200717' # View and manage your data across Google Cloud Platform services AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform' diff --git a/generated/google/apis/cloudfunctions_v1/classes.rb b/generated/google/apis/cloudfunctions_v1/classes.rb index 48eac4838..26c40a14b 100644 --- a/generated/google/apis/cloudfunctions_v1/classes.rb +++ b/generated/google/apis/cloudfunctions_v1/classes.rb @@ -962,51 +962,6 @@ module Google end end - # Metadata describing an Operation - class OperationMetadataV1Beta2 - include Google::Apis::Core::Hashable - - # The original request that started the operation. - # Corresponds to the JSON property `request` - # @return [Hash] - attr_accessor :request - - # Target of the operation - for example - # projects/project-1/locations/region-1/functions/function-1 - # Corresponds to the JSON property `target` - # @return [String] - attr_accessor :target - - # Type of operation. - # Corresponds to the JSON property `type` - # @return [String] - attr_accessor :type - - # The last update timestamp of the operation. - # Corresponds to the JSON property `updateTime` - # @return [String] - attr_accessor :update_time - - # Version id of the function created or updated by an API call. - # This field is only populated for Create and Update operations. - # Corresponds to the JSON property `versionId` - # @return [Fixnum] - attr_accessor :version_id - - def initialize(**args) - update!(**args) - end - - # Update properties of this object - def update!(**args) - @request = args[:request] if args.key?(:request) - @target = args[:target] if args.key?(:target) - @type = args[:type] if args.key?(:type) - @update_time = args[:update_time] if args.key?(:update_time) - @version_id = args[:version_id] if args.key?(:version_id) - end - end - # An Identity and Access Management (IAM) policy, which specifies access # controls for Google Cloud resources. # A `Policy` is a collection of `bindings`. A `binding` binds one or more diff --git a/generated/google/apis/cloudfunctions_v1/representations.rb b/generated/google/apis/cloudfunctions_v1/representations.rb index 03583f5ec..d7b79e6e4 100644 --- a/generated/google/apis/cloudfunctions_v1/representations.rb +++ b/generated/google/apis/cloudfunctions_v1/representations.rb @@ -142,12 +142,6 @@ module Google include Google::Apis::Core::JsonObjectSupport end - class OperationMetadataV1Beta2 - class Representation < Google::Apis::Core::JsonRepresentation; end - - include Google::Apis::Core::JsonObjectSupport - end - class Policy class Representation < Google::Apis::Core::JsonRepresentation; end @@ -391,17 +385,6 @@ module Google end end - class OperationMetadataV1Beta2 - # @private - class Representation < Google::Apis::Core::JsonRepresentation - hash :request, as: 'request' - property :target, as: 'target' - property :type, as: 'type' - property :update_time, as: 'updateTime' - property :version_id, :numeric_string => true, as: 'versionId' - end - end - class Policy # @private class Representation < Google::Apis::Core::JsonRepresentation diff --git a/generated/google/apis/cloudresourcemanager_v1.rb b/generated/google/apis/cloudresourcemanager_v1.rb index cf904033b..6c202a83f 100644 --- a/generated/google/apis/cloudresourcemanager_v1.rb +++ b/generated/google/apis/cloudresourcemanager_v1.rb @@ -26,7 +26,7 @@ module Google # @see https://cloud.google.com/resource-manager module CloudresourcemanagerV1 VERSION = 'V1' - REVISION = '20200622' + REVISION = '20200720' # View and manage your data across Google Cloud Platform services AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform' diff --git a/generated/google/apis/cloudresourcemanager_v1/classes.rb b/generated/google/apis/cloudresourcemanager_v1/classes.rb index c4fd62453..50b847b90 100644 --- a/generated/google/apis/cloudresourcemanager_v1/classes.rb +++ b/generated/google/apis/cloudresourcemanager_v1/classes.rb @@ -28,8 +28,8 @@ module Google # A container to reference an id for any resource type. A `resource` in Google # Cloud Platform is a generic term for something you (a developer) may want to - # interact with through one of our API's. Some examples are an App Engine app, - # a Compute Engine instance, a Cloud SQL database, and so on. + # interact with through one of our API's. Some examples are an App Engine app, a + # Compute Engine instance, a Cloud SQL database, and so on. # Corresponds to the JSON property `resourceId` # @return [Google::Apis::CloudresourcemanagerV1::ResourceId] attr_accessor :resource_id @@ -44,53 +44,21 @@ module Google end end - # Specifies the audit configuration for a service. - # The configuration determines which permission types are logged, and what - # identities, if any, are exempted from logging. - # An AuditConfig must have one or more AuditLogConfigs. - # If there are AuditConfigs for both `allServices` and a specific service, - # the union of the two AuditConfigs is used for that service: the log_types - # specified in each AuditConfig are enabled, and the exempted_members in each - # AuditLogConfig are exempted. - # Example Policy with multiple AuditConfigs: - # ` - # "audit_configs": [ - # ` - # "service": "allServices", - # "audit_log_configs": [ - # ` - # "log_type": "DATA_READ", - # "exempted_members": [ - # "user:jose@example.com" - # ] - # `, - # ` - # "log_type": "DATA_WRITE" - # `, - # ` - # "log_type": "ADMIN_READ" - # ` - # ] - # `, - # ` - # "service": "sampleservice.googleapis.com", - # "audit_log_configs": [ - # ` - # "log_type": "DATA_READ" - # `, - # ` - # "log_type": "DATA_WRITE", - # "exempted_members": [ - # "user:aliya@example.com" - # ] - # ` - # ] - # ` - # ] - # ` - # For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ - # logging. It also exempts jose@example.com from DATA_READ logging, and - # aliya@example.com from DATA_WRITE logging. + # Specifies the audit configuration for a service. The configuration determines + # which permission types are logged, and what identities, if any, are exempted + # from logging. An AuditConfig must have one or more AuditLogConfigs. If there + # are AuditConfigs for both `allServices` and a specific service, the union of + # the two AuditConfigs is used for that service: the log_types specified in each + # AuditConfig are enabled, and the exempted_members in each AuditLogConfig are + # exempted. Example Policy with multiple AuditConfigs: ` "audit_configs": [ ` " + # service": "allServices", "audit_log_configs": [ ` "log_type": "DATA_READ", " + # exempted_members": [ "user:jose@example.com" ] `, ` "log_type": "DATA_WRITE" `, + # ` "log_type": "ADMIN_READ" ` ] `, ` "service": "sampleservice.googleapis.com", + # "audit_log_configs": [ ` "log_type": "DATA_READ" `, ` "log_type": "DATA_WRITE" + # , "exempted_members": [ "user:aliya@example.com" ] ` ] ` ] ` For sampleservice, + # this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also + # exempts jose@example.com from DATA_READ logging, and aliya@example.com from + # DATA_WRITE logging. class AuditConfig include Google::Apis::Core::Hashable @@ -99,9 +67,9 @@ module Google # @return [Array] attr_accessor :audit_log_configs - # Specifies a service that will be enabled for audit logging. - # For example, `storage.googleapis.com`, `cloudsql.googleapis.com`. - # `allServices` is a special value that covers all services. + # Specifies a service that will be enabled for audit logging. For example, ` + # storage.googleapis.com`, `cloudsql.googleapis.com`. `allServices` is a special + # value that covers all services. # Corresponds to the JSON property `service` # @return [String] attr_accessor :service @@ -117,28 +85,15 @@ module Google end end - # Provides the configuration for logging a type of permissions. - # Example: - # ` - # "audit_log_configs": [ - # ` - # "log_type": "DATA_READ", - # "exempted_members": [ - # "user:jose@example.com" - # ] - # `, - # ` - # "log_type": "DATA_WRITE" - # ` - # ] - # ` - # This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting - # jose@example.com from DATA_READ logging. + # Provides the configuration for logging a type of permissions. Example: ` " + # audit_log_configs": [ ` "log_type": "DATA_READ", "exempted_members": [ "user: + # jose@example.com" ] `, ` "log_type": "DATA_WRITE" ` ] ` This enables ' + # DATA_READ' and 'DATA_WRITE' logging, while exempting jose@example.com from + # DATA_READ logging. class AuditLogConfig include Google::Apis::Core::Hashable - # Specifies the identities that do not cause logging for this type of - # permission. + # Specifies the identities that do not cause logging for this type of permission. # Follows the same format of Binding.members. # Corresponds to the JSON property `exemptedMembers` # @return [Array] @@ -164,69 +119,57 @@ module Google class Binding include Google::Apis::Core::Hashable - # Represents a textual expression in the Common Expression Language (CEL) - # syntax. CEL is a C-like expression language. The syntax and semantics of CEL - # are documented at https://github.com/google/cel-spec. - # Example (Comparison): - # title: "Summary size limit" - # description: "Determines if a summary is less than 100 chars" - # expression: "document.summary.size() < 100" - # Example (Equality): - # title: "Requestor is owner" - # description: "Determines if requestor is the document owner" - # expression: "document.owner == request.auth.claims.email" - # Example (Logic): - # title: "Public documents" - # description: "Determine whether the document should be publicly visible" - # expression: "document.type != 'private' && document.type != 'internal'" - # Example (Data Manipulation): - # title: "Notification string" - # description: "Create a notification string with a timestamp." - # expression: "'New message received at ' + string(document.create_time)" - # The exact variables and functions that may be referenced within an expression - # are determined by the service that evaluates it. See the service - # documentation for additional information. + # Represents a textual expression in the Common Expression Language (CEL) syntax. + # CEL is a C-like expression language. The syntax and semantics of CEL are + # documented at https://github.com/google/cel-spec. Example (Comparison): title: + # "Summary size limit" description: "Determines if a summary is less than 100 + # chars" expression: "document.summary.size() < 100" Example (Equality): title: " + # Requestor is owner" description: "Determines if requestor is the document + # owner" expression: "document.owner == request.auth.claims.email" Example ( + # Logic): title: "Public documents" description: "Determine whether the document + # should be publicly visible" expression: "document.type != 'private' && + # document.type != 'internal'" Example (Data Manipulation): title: "Notification + # string" description: "Create a notification string with a timestamp." + # expression: "'New message received at ' + string(document.create_time)" The + # exact variables and functions that may be referenced within an expression are + # determined by the service that evaluates it. See the service documentation for + # additional information. # Corresponds to the JSON property `condition` # @return [Google::Apis::CloudresourcemanagerV1::Expr] attr_accessor :condition - # Specifies the identities requesting access for a Cloud Platform resource. - # `members` can have the following values: - # * `allUsers`: A special identifier that represents anyone who is - # on the internet; with or without a Google account. - # * `allAuthenticatedUsers`: A special identifier that represents anyone - # who is authenticated with a Google account or a service account. - # * `user:`emailid``: An email address that represents a specific Google - # account. For example, `alice@example.com` . - # * `serviceAccount:`emailid``: An email address that represents a service - # account. For example, `my-other-app@appspot.gserviceaccount.com`. - # * `group:`emailid``: An email address that represents a Google group. - # For example, `admins@example.com`. - # * `deleted:user:`emailid`?uid=`uniqueid``: An email address (plus unique - # identifier) representing a user that has been recently deleted. For - # example, `alice@example.com?uid=123456789012345678901`. If the user is - # recovered, this value reverts to `user:`emailid`` and the recovered user - # retains the role in the binding. - # * `deleted:serviceAccount:`emailid`?uid=`uniqueid``: An email address (plus - # unique identifier) representing a service account that has been recently - # deleted. For example, - # `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. - # If the service account is undeleted, this value reverts to - # `serviceAccount:`emailid`` and the undeleted service account retains the - # role in the binding. - # * `deleted:group:`emailid`?uid=`uniqueid``: An email address (plus unique - # identifier) representing a Google group that has been recently - # deleted. For example, `admins@example.com?uid=123456789012345678901`. If - # the group is recovered, this value reverts to `group:`emailid`` and the - # recovered group retains the role in the binding. - # * `domain:`domain``: The G Suite domain (primary) that represents all the - # users of that domain. For example, `google.com` or `example.com`. + # Specifies the identities requesting access for a Cloud Platform resource. ` + # members` can have the following values: * `allUsers`: A special identifier + # that represents anyone who is on the internet; with or without a Google + # account. * `allAuthenticatedUsers`: A special identifier that represents + # anyone who is authenticated with a Google account or a service account. * ` + # user:`emailid``: An email address that represents a specific Google account. + # For example, `alice@example.com` . * `serviceAccount:`emailid``: An email + # address that represents a service account. For example, `my-other-app@appspot. + # gserviceaccount.com`. * `group:`emailid``: An email address that represents a + # Google group. For example, `admins@example.com`. * `deleted:user:`emailid`?uid= + # `uniqueid``: An email address (plus unique identifier) representing a user + # that has been recently deleted. For example, `alice@example.com?uid= + # 123456789012345678901`. If the user is recovered, this value reverts to `user:` + # emailid`` and the recovered user retains the role in the binding. * `deleted: + # serviceAccount:`emailid`?uid=`uniqueid``: An email address (plus unique + # identifier) representing a service account that has been recently deleted. For + # example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. + # If the service account is undeleted, this value reverts to `serviceAccount:` + # emailid`` and the undeleted service account retains the role in the binding. * + # `deleted:group:`emailid`?uid=`uniqueid``: An email address (plus unique + # identifier) representing a Google group that has been recently deleted. For + # example, `admins@example.com?uid=123456789012345678901`. If the group is + # recovered, this value reverts to `group:`emailid`` and the recovered group + # retains the role in the binding. * `domain:`domain``: The G Suite domain ( + # primary) that represents all the users of that domain. For example, `google. + # com` or `example.com`. # Corresponds to the JSON property `members` # @return [Array] attr_accessor :members - # Role that is assigned to `members`. - # For example, `roles/viewer`, `roles/editor`, or `roles/owner`. + # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor` + # , or `roles/owner`. # Corresponds to the JSON property `role` # @return [String] attr_accessor :role @@ -243,10 +186,9 @@ module Google end end - # A `Constraint` that is either enforced or not. - # For example a constraint `constraints/compute.disableSerialPortAccess`. - # If it is enforced on a VM instance, serial port connections will not be - # opened to that instance. + # A `Constraint` that is either enforced or not. For example a constraint ` + # constraints/compute.disableSerialPortAccess`. If it is enforced on a VM + # instance, serial port connections will not be opened to that instance. class BooleanConstraint include Google::Apis::Core::Hashable @@ -264,45 +206,29 @@ module Google class BooleanPolicy include Google::Apis::Core::Hashable - # If `true`, then the `Policy` is enforced. If `false`, then any - # configuration is acceptable. - # Suppose you have a `Constraint` - # `constraints/compute.disableSerialPortAccess` with `constraint_default` - # set to `ALLOW`. A `Policy` for that `Constraint` exhibits the following - # behavior: - # - If the `Policy` at this resource has enforced set to `false`, serial - # port connection attempts will be allowed. - # - If the `Policy` at this resource has enforced set to `true`, serial - # port connection attempts will be refused. - # - If the `Policy` at this resource is `RestoreDefault`, serial port - # connection attempts will be allowed. - # - If no `Policy` is set at this resource or anywhere higher in the - # resource hierarchy, serial port connection attempts will be allowed. - # - If no `Policy` is set at this resource, but one exists higher in the - # resource hierarchy, the behavior is as if the`Policy` were set at - # this resource. - # The following examples demonstrate the different possible layerings: - # Example 1 (nearest `Constraint` wins): - # `organizations/foo` has a `Policy` with: - # `enforced: false` - # `projects/bar` has no `Policy` set. - # The constraint at `projects/bar` and `organizations/foo` will not be - # enforced. - # Example 2 (enforcement gets replaced): - # `organizations/foo` has a `Policy` with: - # `enforced: false` - # `projects/bar` has a `Policy` with: - # `enforced: true` - # The constraint at `organizations/foo` is not enforced. - # The constraint at `projects/bar` is enforced. - # Example 3 (RestoreDefault): - # `organizations/foo` has a `Policy` with: - # `enforced: true` - # `projects/bar` has a `Policy` with: - # `RestoreDefault: ``` - # The constraint at `organizations/foo` is enforced. - # The constraint at `projects/bar` is not enforced, because - # `constraint_default` for the `Constraint` is `ALLOW`. + # If `true`, then the `Policy` is enforced. If `false`, then any configuration + # is acceptable. Suppose you have a `Constraint` `constraints/compute. + # disableSerialPortAccess` with `constraint_default` set to `ALLOW`. A `Policy` + # for that `Constraint` exhibits the following behavior: - If the `Policy` at + # this resource has enforced set to `false`, serial port connection attempts + # will be allowed. - If the `Policy` at this resource has enforced set to `true`, + # serial port connection attempts will be refused. - If the `Policy` at this + # resource is `RestoreDefault`, serial port connection attempts will be allowed. + # - If no `Policy` is set at this resource or anywhere higher in the resource + # hierarchy, serial port connection attempts will be allowed. - If no `Policy` + # is set at this resource, but one exists higher in the resource hierarchy, the + # behavior is as if the`Policy` were set at this resource. The following + # examples demonstrate the different possible layerings: Example 1 (nearest ` + # Constraint` wins): `organizations/foo` has a `Policy` with: `enforced: false` ` + # projects/bar` has no `Policy` set. The constraint at `projects/bar` and ` + # organizations/foo` will not be enforced. Example 2 (enforcement gets replaced): + # `organizations/foo` has a `Policy` with: `enforced: false` `projects/bar` has + # a `Policy` with: `enforced: true` The constraint at `organizations/foo` is not + # enforced. The constraint at `projects/bar` is enforced. Example 3 ( + # RestoreDefault): `organizations/foo` has a `Policy` with: `enforced: true` ` + # projects/bar` has a `Policy` with: `RestoreDefault: ``` The constraint at ` + # organizations/foo` is enforced. The constraint at `projects/bar` is not + # enforced, because `constraint_default` for the `Constraint` is `ALLOW`. # Corresponds to the JSON property `enforced` # @return [Boolean] attr_accessor :enforced @@ -327,8 +253,8 @@ module Google # @return [String] attr_accessor :constraint - # The current version, for concurrency control. Not sending an `etag` - # will cause the `Policy` to be cleared blindly. + # The current version, for concurrency control. Not sending an `etag` will cause + # the `Policy` to be cleared blindly. # Corresponds to the JSON property `etag` # NOTE: Values are automatically base64 encoded/decoded in the client library. # @return [String] @@ -347,24 +273,22 @@ module Google # A `Constraint` describes a way in which a resource's configuration can be # restricted. For example, it controls which cloud services can be activated - # across an organization, or whether a Compute Engine instance can have - # serial port connections established. `Constraints` can be configured by the + # across an organization, or whether a Compute Engine instance can have serial + # port connections established. `Constraints` can be configured by the # organization's policy administrator to fit the needs of the organzation by - # setting Policies for `Constraints` at different locations in the - # organization's resource hierarchy. Policies are inherited down the resource - # hierarchy from higher levels, but can also be overridden. For details about - # the inheritance rules please read about - # [Policies](/resource-manager/reference/rest/v1/Policy). + # setting Policies for `Constraints` at different locations in the organization' + # s resource hierarchy. Policies are inherited down the resource hierarchy from + # higher levels, but can also be overridden. For details about the inheritance + # rules please read about [Policies](/resource-manager/reference/rest/v1/Policy). # `Constraints` have a default behavior determined by the `constraint_default` - # field, which is the enforcement behavior that is used in the absence of a - # `Policy` being defined or inherited for the resource in question. + # field, which is the enforcement behavior that is used in the absence of a ` + # Policy` being defined or inherited for the resource in question. class Constraint include Google::Apis::Core::Hashable - # A `Constraint` that is either enforced or not. - # For example a constraint `constraints/compute.disableSerialPortAccess`. - # If it is enforced on a VM instance, serial port connections will not be - # opened to that instance. + # A `Constraint` that is either enforced or not. For example a constraint ` + # constraints/compute.disableSerialPortAccess`. If it is enforced on a VM + # instance, serial port connections will not be opened to that instance. # Corresponds to the JSON property `booleanConstraint` # @return [Google::Apis::CloudresourcemanagerV1::BooleanConstraint] attr_accessor :boolean_constraint @@ -375,14 +299,12 @@ module Google attr_accessor :constraint_default # Detailed description of what this `Constraint` controls as well as how and - # where it is enforced. - # Mutable. + # where it is enforced. Mutable. # Corresponds to the JSON property `description` # @return [String] attr_accessor :description - # The human readable name. - # Mutable. + # The human readable name. Mutable. # Corresponds to the JSON property `displayName` # @return [String] attr_accessor :display_name @@ -393,8 +315,8 @@ module Google # @return [Google::Apis::CloudresourcemanagerV1::ListConstraint] attr_accessor :list_constraint - # Immutable value, required to globally be unique. For example, - # `constraints/serviceuser.services` + # Immutable value, required to globally be unique. For example, `constraints/ + # serviceuser.services` # Corresponds to the JSON property `name` # @return [String] attr_accessor :name @@ -420,13 +342,11 @@ module Google end end - # 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); - # ` - # The JSON representation for `Empty` is empty JSON object ````. + # 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); ` The JSON representation for + # `Empty` is empty JSON object ````. class Empty include Google::Apis::Core::Hashable @@ -439,52 +359,43 @@ module Google end end - # Represents a textual expression in the Common Expression Language (CEL) - # syntax. CEL is a C-like expression language. The syntax and semantics of CEL - # are documented at https://github.com/google/cel-spec. - # Example (Comparison): - # title: "Summary size limit" - # description: "Determines if a summary is less than 100 chars" - # expression: "document.summary.size() < 100" - # Example (Equality): - # title: "Requestor is owner" - # description: "Determines if requestor is the document owner" - # expression: "document.owner == request.auth.claims.email" - # Example (Logic): - # title: "Public documents" - # description: "Determine whether the document should be publicly visible" - # expression: "document.type != 'private' && document.type != 'internal'" - # Example (Data Manipulation): - # title: "Notification string" - # description: "Create a notification string with a timestamp." - # expression: "'New message received at ' + string(document.create_time)" - # The exact variables and functions that may be referenced within an expression - # are determined by the service that evaluates it. See the service - # documentation for additional information. + # Represents a textual expression in the Common Expression Language (CEL) syntax. + # CEL is a C-like expression language. The syntax and semantics of CEL are + # documented at https://github.com/google/cel-spec. Example (Comparison): title: + # "Summary size limit" description: "Determines if a summary is less than 100 + # chars" expression: "document.summary.size() < 100" Example (Equality): title: " + # Requestor is owner" description: "Determines if requestor is the document + # owner" expression: "document.owner == request.auth.claims.email" Example ( + # Logic): title: "Public documents" description: "Determine whether the document + # should be publicly visible" expression: "document.type != 'private' && + # document.type != 'internal'" Example (Data Manipulation): title: "Notification + # string" description: "Create a notification string with a timestamp." + # expression: "'New message received at ' + string(document.create_time)" The + # exact variables and functions that may be referenced within an expression are + # determined by the service that evaluates it. See the service documentation for + # additional information. class Expr include Google::Apis::Core::Hashable - # Optional. Description of the expression. This is a longer text which - # describes the expression, e.g. when hovered over it in a UI. + # Optional. Description of the expression. This is a longer text which describes + # the expression, e.g. when hovered over it in a UI. # Corresponds to the JSON property `description` # @return [String] attr_accessor :description - # Textual representation of an expression in Common Expression Language - # syntax. + # Textual representation of an expression in Common Expression Language syntax. # Corresponds to the JSON property `expression` # @return [String] attr_accessor :expression - # Optional. String indicating the location of the expression for error - # reporting, e.g. a file name and a position in the file. + # Optional. String indicating the location of the expression for error reporting, + # e.g. a file name and a position in the file. # Corresponds to the JSON property `location` # @return [String] attr_accessor :location - # Optional. Title for the expression, i.e. a short string describing - # its purpose. This can be used e.g. in UIs which allow to enter the - # expression. + # Optional. Title for the expression, i.e. a short string describing its purpose. + # This can be used e.g. in UIs which allow to enter the expression. # Corresponds to the JSON property `title` # @return [String] attr_accessor :title @@ -506,8 +417,8 @@ module Google class FolderOperation include Google::Apis::Core::Hashable - # The resource name of the folder or organization we are either creating - # the folder under or moving the folder to. + # The resource name of the folder or organization we are either creating the + # folder under or moving the folder to. # Corresponds to the JSON property `destinationParent` # @return [String] attr_accessor :destination_parent @@ -522,8 +433,8 @@ module Google # @return [String] attr_accessor :operation_type - # The resource name of the folder's parent. - # Only applicable when the operation_type is MOVE. + # The resource name of the folder's parent. Only applicable when the + # operation_type is MOVE. # Corresponds to the JSON property `sourceParent` # @return [String] attr_accessor :source_parent @@ -560,9 +471,7 @@ module Google end end - # The request sent to the - # GetAncestry - # method. + # The request sent to the GetAncestry method. class GetAncestryRequest include Google::Apis::Core::Hashable @@ -575,15 +484,12 @@ module Google end end - # Response from the - # projects.getAncestry - # method. + # Response from the projects.getAncestry method. class GetAncestryResponse include Google::Apis::Core::Hashable - # Ancestors are ordered from bottom to top of the resource hierarchy. The - # first ancestor is the project itself, followed by the project's parent, - # etc.. + # Ancestors are ordered from bottom to top of the resource hierarchy. The first + # ancestor is the project itself, followed by the project's parent, etc.. # Corresponds to the JSON property `ancestor` # @return [Array] attr_accessor :ancestor @@ -659,15 +565,13 @@ module Google class GetPolicyOptions include Google::Apis::Core::Hashable - # Optional. The policy format version to be returned. - # Valid values are 0, 1, and 3. Requests specifying an invalid value will be - # rejected. - # Requests for policies with any conditional bindings must specify version 3. - # Policies without any conditional bindings may specify any valid value or - # leave the field unset. - # To learn which resources support conditions in their IAM policies, see the - # [IAM - # documentation](https://cloud.google.com/iam/help/conditions/resource-policies). + # Optional. The policy format version to be returned. Valid values are 0, 1, and + # 3. Requests specifying an invalid value will be rejected. Requests for + # policies with any conditional bindings must specify version 3. Policies + # without any conditional bindings may specify any valid value or leave the + # field unset. To learn which resources support conditions in their IAM policies, + # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/ + # resource-policies). # Corresponds to the JSON property `requestedPolicyVersion` # @return [Fixnum] attr_accessor :requested_policy_version @@ -692,39 +596,35 @@ module Google # @return [String] attr_accessor :create_time - # A system-generated unique identifier for this Lien. - # Example: `liens/1234abcd` + # A system-generated unique identifier for this Lien. Example: `liens/1234abcd` # Corresponds to the JSON property `name` # @return [String] attr_accessor :name - # A stable, user-visible/meaningful string identifying the origin of the - # Lien, intended to be inspected programmatically. Maximum length of 200 - # characters. + # A stable, user-visible/meaningful string identifying the origin of the Lien, + # intended to be inspected programmatically. Maximum length of 200 characters. # Example: 'compute.googleapis.com' # Corresponds to the JSON property `origin` # @return [String] attr_accessor :origin - # A reference to the resource this Lien is attached to. The server will - # validate the parent against those for which Liens are supported. - # Example: `projects/1234` + # A reference to the resource this Lien is attached to. The server will validate + # the parent against those for which Liens are supported. Example: `projects/ + # 1234` # Corresponds to the JSON property `parent` # @return [String] attr_accessor :parent - # Concise user-visible strings indicating why an action cannot be performed - # on a resource. Maximum length of 200 characters. - # Example: 'Holds production API key' + # Concise user-visible strings indicating why an action cannot be performed on a + # resource. Maximum length of 200 characters. Example: 'Holds production API key' # Corresponds to the JSON property `reason` # @return [String] attr_accessor :reason - # The types of operations which should be blocked as a result of this Lien. - # Each value should correspond to an IAM permission. The server will - # validate the permissions against those for which Liens are supported. - # An empty list is meaningless and will be rejected. - # Example: ['resourcemanager.projects.delete'] + # The types of operations which should be blocked as a result of this Lien. Each + # value should correspond to an IAM permission. The server will validate the + # permissions against those for which Liens are supported. An empty list is + # meaningless and will be rejected. Example: ['resourcemanager.projects.delete'] # Corresponds to the JSON property `restrictions` # @return [Array] attr_accessor :restrictions @@ -749,15 +649,14 @@ module Google class ListAvailableOrgPolicyConstraintsRequest include Google::Apis::Core::Hashable - # Size of the pages to be returned. This is currently unsupported and will - # be ignored. The server may at any point start using this field to limit - # page size. + # Size of the pages to be returned. This is currently unsupported and will be + # ignored. The server may at any point start using this field to limit page size. # Corresponds to the JSON property `pageSize` # @return [Fixnum] attr_accessor :page_size - # Page token used to retrieve the next page. This is currently unsupported - # and will be ignored. The server may at any point start using this field. + # Page token used to retrieve the next page. This is currently unsupported and + # will be ignored. The server may at any point start using this field. # Corresponds to the JSON property `pageToken` # @return [String] attr_accessor :page_token @@ -774,8 +673,8 @@ module Google end # The response returned from the `ListAvailableOrgPolicyConstraints` method. - # Returns all `Constraints` that could be set at this level of the hierarchy - # (contrast with the response from `ListPolicies`, which returns all policies + # Returns all `Constraints` that could be set at this level of the hierarchy ( + # contrast with the response from `ListPolicies`, which returns all policies # which are set). class ListAvailableOrgPolicyConstraintsResponse include Google::Apis::Core::Hashable @@ -806,16 +705,15 @@ module Google class ListConstraint include Google::Apis::Core::Hashable - # Optional. The Google Cloud Console will try to default to a configuration - # that matches the value specified in this `Constraint`. + # Optional. The Google Cloud Console will try to default to a configuration that + # matches the value specified in this `Constraint`. # Corresponds to the JSON property `suggestedValue` # @return [String] attr_accessor :suggested_value - # Indicates whether subtrees of Cloud Resource Manager resource hierarchy - # can be used in `Policy.allowed_values` and `Policy.denied_values`. For - # example, `"under:folders/123"` would match any resource under the - # 'folders/123' folder. + # Indicates whether subtrees of Cloud Resource Manager resource hierarchy can be + # used in `Policy.allowed_values` and `Policy.denied_values`. For example, `" + # under:folders/123"` would match any resource under the 'folders/123' folder. # Corresponds to the JSON property `supportsUnder` # @return [Boolean] attr_accessor :supports_under @@ -862,15 +760,14 @@ module Google class ListOrgPoliciesRequest include Google::Apis::Core::Hashable - # Size of the pages to be returned. This is currently unsupported and will - # be ignored. The server may at any point start using this field to limit - # page size. + # Size of the pages to be returned. This is currently unsupported and will be + # ignored. The server may at any point start using this field to limit page size. # Corresponds to the JSON property `pageSize` # @return [Fixnum] attr_accessor :page_size - # Page token used to retrieve the next page. This is currently unsupported - # and will be ignored. The server may at any point start using this field. + # Page token used to retrieve the next page. This is currently unsupported and + # will be ignored. The server may at any point start using this field. # Corresponds to the JSON property `pageToken` # @return [String] attr_accessor :page_token @@ -886,19 +783,19 @@ module Google end end - # The response returned from the `ListOrgPolicies` method. It will be empty - # if no `Policies` are set on the resource. + # The response returned from the `ListOrgPolicies` method. It will be empty if + # no `Policies` are set on the resource. class ListOrgPoliciesResponse include Google::Apis::Core::Hashable - # Page token used to retrieve the next page. This is currently not used, but - # the server may at any point start supplying a valid token. + # Page token used to retrieve the next page. This is currently not used, but the + # server may at any point start supplying a valid token. # Corresponds to the JSON property `nextPageToken` # @return [String] attr_accessor :next_page_token - # The `Policies` that are set on the resource. It will be empty if no - # `Policies` are set. + # The `Policies` that are set on the resource. It will be empty if no `Policies` + # are set. # Corresponds to the JSON property `policies` # @return [Array] attr_accessor :policies @@ -914,26 +811,22 @@ module Google end end - # Used in `policy_type` to specify how `list_policy` behaves at this - # resource. - # `ListPolicy` can define specific values and subtrees of Cloud Resource - # Manager resource hierarchy (`Organizations`, `Folders`, `Projects`) that - # are allowed or denied by setting the `allowed_values` and `denied_values` - # fields. This is achieved by using the `under:` and optional `is:` prefixes. - # The `under:` prefix is used to denote resource subtree values. - # The `is:` prefix is used to denote specific values, and is required only - # if the value contains a ":". Values prefixed with "is:" are treated the - # same as values with no prefix. - # Ancestry subtrees must be in one of the following formats: - # - "projects/", e.g. "projects/tokyo-rain-123" - # - "folders/", e.g. "folders/1234" - # - "organizations/", e.g. "organizations/1234" - # The `supports_under` field of the associated `Constraint` defines whether - # ancestry prefixes can be used. You can set `allowed_values` and - # `denied_values` in the same `Policy` if `all_values` is - # `ALL_VALUES_UNSPECIFIED`. `ALLOW` or `DENY` are used to allow or deny all - # values. If `all_values` is set to either `ALLOW` or `DENY`, - # `allowed_values` and `denied_values` must be unset. + # Used in `policy_type` to specify how `list_policy` behaves at this resource. ` + # ListPolicy` can define specific values and subtrees of Cloud Resource Manager + # resource hierarchy (`Organizations`, `Folders`, `Projects`) that are allowed + # or denied by setting the `allowed_values` and `denied_values` fields. This is + # achieved by using the `under:` and optional `is:` prefixes. The `under:` + # prefix is used to denote resource subtree values. The `is:` prefix is used to + # denote specific values, and is required only if the value contains a ":". + # Values prefixed with "is:" are treated the same as values with no prefix. + # Ancestry subtrees must be in one of the following formats: - "projects/", e.g. + # "projects/tokyo-rain-123" - "folders/", e.g. "folders/1234" - "organizations/", + # e.g. "organizations/1234" The `supports_under` field of the associated ` + # Constraint` defines whether ancestry prefixes can be used. You can set ` + # allowed_values` and `denied_values` in the same `Policy` if `all_values` is ` + # ALL_VALUES_UNSPECIFIED`. `ALLOW` or `DENY` are used to allow or deny all + # values. If `all_values` is set to either `ALLOW` or `DENY`, `allowed_values` + # and `denied_values` must be unset. class ListPolicy include Google::Apis::Core::Hashable @@ -942,112 +835,83 @@ module Google # @return [String] attr_accessor :all_values - # List of values allowed at this resource. Can only be set if `all_values` - # is set to `ALL_VALUES_UNSPECIFIED`. + # List of values allowed at this resource. Can only be set if `all_values` is + # set to `ALL_VALUES_UNSPECIFIED`. # Corresponds to the JSON property `allowedValues` # @return [Array] attr_accessor :allowed_values - # List of values denied at this resource. Can only be set if `all_values` - # is set to `ALL_VALUES_UNSPECIFIED`. + # List of values denied at this resource. Can only be set if `all_values` is set + # to `ALL_VALUES_UNSPECIFIED`. # Corresponds to the JSON property `deniedValues` # @return [Array] attr_accessor :denied_values - # Determines the inheritance behavior for this `Policy`. - # By default, a `ListPolicy` set at a resource supersedes any `Policy` set - # anywhere up the resource hierarchy. However, if `inherit_from_parent` is - # set to `true`, then the values from the effective `Policy` of the parent - # resource are inherited, meaning the values set in this `Policy` are - # added to the values inherited up the hierarchy. - # Setting `Policy` hierarchies that inherit both allowed values and denied - # values isn't recommended in most circumstances to keep the configuration - # simple and understandable. However, it is possible to set a `Policy` with - # `allowed_values` set that inherits a `Policy` with `denied_values` set. - # In this case, the values that are allowed must be in `allowed_values` and - # not present in `denied_values`. - # For example, suppose you have a `Constraint` - # `constraints/serviceuser.services`, which has a `constraint_type` of - # `list_constraint`, and with `constraint_default` set to `ALLOW`. - # Suppose that at the Organization level, a `Policy` is applied that - # restricts the allowed API activations to ``E1`, `E2``. Then, if a - # `Policy` is applied to a project below the Organization that has - # `inherit_from_parent` set to `false` and field all_values set to DENY, - # then an attempt to activate any API will be denied. - # The following examples demonstrate different possible layerings for - # `projects/bar` parented by `organizations/foo`: - # Example 1 (no inherited values): - # `organizations/foo` has a `Policy` with values: - # `allowed_values: "E1" allowed_values:"E2"` - # `projects/bar` has `inherit_from_parent` `false` and values: - # `allowed_values: "E3" allowed_values: "E4"` - # The accepted values at `organizations/foo` are `E1`, `E2`. - # The accepted values at `projects/bar` are `E3`, and `E4`. - # Example 2 (inherited values): - # `organizations/foo` has a `Policy` with values: - # `allowed_values: "E1" allowed_values:"E2"` - # `projects/bar` has a `Policy` with values: - # `value: "E3" value: "E4" inherit_from_parent: true` - # The accepted values at `organizations/foo` are `E1`, `E2`. - # The accepted values at `projects/bar` are `E1`, `E2`, `E3`, and `E4`. - # Example 3 (inheriting both allowed and denied values): - # `organizations/foo` has a `Policy` with values: - # `allowed_values: "E1" allowed_values: "E2"` - # `projects/bar` has a `Policy` with: - # `denied_values: "E1"` - # The accepted values at `organizations/foo` are `E1`, `E2`. - # The value accepted at `projects/bar` is `E2`. - # Example 4 (RestoreDefault): - # `organizations/foo` has a `Policy` with values: - # `allowed_values: "E1" allowed_values:"E2"` - # `projects/bar` has a `Policy` with values: - # `RestoreDefault: ``` - # The accepted values at `organizations/foo` are `E1`, `E2`. - # The accepted values at `projects/bar` are either all or none depending on - # the value of `constraint_default` (if `ALLOW`, all; if - # `DENY`, none). - # Example 5 (no policy inherits parent policy): - # `organizations/foo` has no `Policy` set. - # `projects/bar` has no `Policy` set. - # The accepted values at both levels are either all or none depending on - # the value of `constraint_default` (if `ALLOW`, all; if - # `DENY`, none). - # Example 6 (ListConstraint allowing all): - # `organizations/foo` has a `Policy` with values: - # `allowed_values: "E1" allowed_values: "E2"` - # `projects/bar` has a `Policy` with: - # `all: ALLOW` - # The accepted values at `organizations/foo` are `E1`, E2`. - # Any value is accepted at `projects/bar`. - # Example 7 (ListConstraint allowing none): - # `organizations/foo` has a `Policy` with values: - # `allowed_values: "E1" allowed_values: "E2"` - # `projects/bar` has a `Policy` with: - # `all: DENY` - # The accepted values at `organizations/foo` are `E1`, E2`. - # No value is accepted at `projects/bar`. - # Example 10 (allowed and denied subtrees of Resource Manager hierarchy): - # Given the following resource hierarchy - # O1->`F1, F2`; F1->`P1`; F2->`P2, P3`, - # `organizations/foo` has a `Policy` with values: - # `allowed_values: "under:organizations/O1"` - # `projects/bar` has a `Policy` with: - # `allowed_values: "under:projects/P3"` - # `denied_values: "under:folders/F2"` - # The accepted values at `organizations/foo` are `organizations/O1`, - # `folders/F1`, `folders/F2`, `projects/P1`, `projects/P2`, - # `projects/P3`. - # The accepted values at `projects/bar` are `organizations/O1`, - # `folders/F1`, `projects/P1`. + # Determines the inheritance behavior for this `Policy`. By default, a ` + # ListPolicy` set at a resource supersedes any `Policy` set anywhere up the + # resource hierarchy. However, if `inherit_from_parent` is set to `true`, then + # the values from the effective `Policy` of the parent resource are inherited, + # meaning the values set in this `Policy` are added to the values inherited up + # the hierarchy. Setting `Policy` hierarchies that inherit both allowed values + # and denied values isn't recommended in most circumstances to keep the + # configuration simple and understandable. However, it is possible to set a ` + # Policy` with `allowed_values` set that inherits a `Policy` with `denied_values` + # set. In this case, the values that are allowed must be in `allowed_values` + # and not present in `denied_values`. For example, suppose you have a ` + # Constraint` `constraints/serviceuser.services`, which has a `constraint_type` + # of `list_constraint`, and with `constraint_default` set to `ALLOW`. Suppose + # that at the Organization level, a `Policy` is applied that restricts the + # allowed API activations to ``E1`, `E2``. Then, if a `Policy` is applied to a + # project below the Organization that has `inherit_from_parent` set to `false` + # and field all_values set to DENY, then an attempt to activate any API will be + # denied. The following examples demonstrate different possible layerings for ` + # projects/bar` parented by `organizations/foo`: Example 1 (no inherited values): + # `organizations/foo` has a `Policy` with values: `allowed_values: "E1" + # allowed_values:"E2"` `projects/bar` has `inherit_from_parent` `false` and + # values: `allowed_values: "E3" allowed_values: "E4"` The accepted values at ` + # organizations/foo` are `E1`, `E2`. The accepted values at `projects/bar` are ` + # E3`, and `E4`. Example 2 (inherited values): `organizations/foo` has a `Policy` + # with values: `allowed_values: "E1" allowed_values:"E2"` `projects/bar` has a ` + # Policy` with values: `value: "E3" value: "E4" inherit_from_parent: true` The + # accepted values at `organizations/foo` are `E1`, `E2`. The accepted values at ` + # projects/bar` are `E1`, `E2`, `E3`, and `E4`. Example 3 (inheriting both + # allowed and denied values): `organizations/foo` has a `Policy` with values: ` + # allowed_values: "E1" allowed_values: "E2"` `projects/bar` has a `Policy` with: + # `denied_values: "E1"` The accepted values at `organizations/foo` are `E1`, `E2` + # . The value accepted at `projects/bar` is `E2`. Example 4 (RestoreDefault): ` + # organizations/foo` has a `Policy` with values: `allowed_values: "E1" + # allowed_values:"E2"` `projects/bar` has a `Policy` with values: ` + # RestoreDefault: ``` The accepted values at `organizations/foo` are `E1`, `E2`. + # The accepted values at `projects/bar` are either all or none depending on the + # value of `constraint_default` (if `ALLOW`, all; if `DENY`, none). Example 5 ( + # no policy inherits parent policy): `organizations/foo` has no `Policy` set. ` + # projects/bar` has no `Policy` set. The accepted values at both levels are + # either all or none depending on the value of `constraint_default` (if `ALLOW`, + # all; if `DENY`, none). Example 6 (ListConstraint allowing all): `organizations/ + # foo` has a `Policy` with values: `allowed_values: "E1" allowed_values: "E2"` ` + # projects/bar` has a `Policy` with: `all: ALLOW` The accepted values at ` + # organizations/foo` are `E1`, E2`. Any value is accepted at `projects/bar`. + # Example 7 (ListConstraint allowing none): `organizations/foo` has a `Policy` + # with values: `allowed_values: "E1" allowed_values: "E2"` `projects/bar` has a ` + # Policy` with: `all: DENY` The accepted values at `organizations/foo` are `E1`, + # E2`. No value is accepted at `projects/bar`. Example 10 (allowed and denied + # subtrees of Resource Manager hierarchy): Given the following resource + # hierarchy O1->`F1, F2`; F1->`P1`; F2->`P2, P3`, `organizations/foo` has a ` + # Policy` with values: `allowed_values: "under:organizations/O1"` `projects/bar` + # has a `Policy` with: `allowed_values: "under:projects/P3"` `denied_values: " + # under:folders/F2"` The accepted values at `organizations/foo` are ` + # organizations/O1`, `folders/F1`, `folders/F2`, `projects/P1`, `projects/P2`, ` + # projects/P3`. The accepted values at `projects/bar` are `organizations/O1`, ` + # folders/F1`, `projects/P1`. # Corresponds to the JSON property `inheritFromParent` # @return [Boolean] attr_accessor :inherit_from_parent alias_method :inherit_from_parent?, :inherit_from_parent - # Optional. The Google Cloud Console will try to default to a configuration - # that matches the value specified in this `Policy`. If `suggested_value` - # is not set, it will inherit the value specified higher in the hierarchy, - # unless `inherit_from_parent` is `false`. + # Optional. The Google Cloud Console will try to default to a configuration that + # matches the value specified in this `Policy`. If `suggested_value` is not set, + # it will inherit the value specified higher in the hierarchy, unless ` + # inherit_from_parent` is `false`. # Corresponds to the JSON property `suggestedValue` # @return [String] attr_accessor :suggested_value @@ -1066,29 +930,23 @@ module Google end end - # A page of the response received from the - # ListProjects - # method. - # A paginated response where more pages are available has - # `next_page_token` set. This token can be used in a subsequent request to - # retrieve the next request page. + # A page of the response received from the ListProjects method. A paginated + # response where more pages are available has `next_page_token` set. This token + # can be used in a subsequent request to retrieve the next request page. class ListProjectsResponse include Google::Apis::Core::Hashable - # Pagination token. - # If the result set is too large to fit in a single response, this token - # is returned. It encodes the position of the current result cursor. + # Pagination token. If the result set is too large to fit in a single response, + # this token is returned. It encodes the position of the current result cursor. # Feeding this value into a new list request with the `page_token` parameter - # gives the next page of the results. - # When `next_page_token` is not filled in, there is no next page and - # the list returned is the last page in the result set. + # gives the next page of the results. When `next_page_token` is not filled in, + # there is no next page and the list returned is the last page in the result set. # Pagination tokens have a limited lifetime. # Corresponds to the JSON property `nextPageToken` # @return [String] attr_accessor :next_page_token - # The list of Projects that matched the list filter. This list can - # be paginated. + # The list of Projects that matched the list filter. This list can be paginated. # Corresponds to the JSON property `projects` # @return [Array] attr_accessor :projects @@ -1109,47 +967,45 @@ module Google class Operation include Google::Apis::Core::Hashable - # 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. + # 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. # Corresponds to the JSON property `done` # @return [Boolean] attr_accessor :done alias_method :done?, :done - # 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). + # 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). # Corresponds to the JSON property `error` # @return [Google::Apis::CloudresourcemanagerV1::Status] attr_accessor :error - # 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. + # 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. # Corresponds to the JSON property `metadata` # @return [Hash] attr_accessor :metadata # 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``. + # originally returns it. If you use the default HTTP mapping, the `name` should + # be a resource name ending with `operations/`unique_id``. # Corresponds to the JSON property `name` # @return [String] attr_accessor :name - # The normal response of the operation in case of success. 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`. + # The normal response of the operation in case of success. 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`. # Corresponds to the JSON property `response` # @return [Hash] attr_accessor :response @@ -1179,76 +1035,65 @@ module Google # @return [Google::Apis::CloudresourcemanagerV1::BooleanPolicy] attr_accessor :boolean_policy - # The name of the `Constraint` the `Policy` is configuring, for example, - # `constraints/serviceuser.services`. - # A [list of available - # constraints](/resource-manager/docs/organization-policy/org-policy-constraints) - # is available. + # The name of the `Constraint` the `Policy` is configuring, for example, ` + # constraints/serviceuser.services`. A [list of available constraints](/resource- + # manager/docs/organization-policy/org-policy-constraints) is available. # Immutable after creation. # Corresponds to the JSON property `constraint` # @return [String] attr_accessor :constraint # An opaque tag indicating the current version of the `Policy`, used for - # concurrency control. - # When the `Policy` is returned from either a `GetPolicy` or a - # `ListOrgPolicy` request, this `etag` indicates the version of the current - # `Policy` to use when executing a read-modify-write loop. - # When the `Policy` is returned from a `GetEffectivePolicy` request, the - # `etag` will be unset. - # When the `Policy` is used in a `SetOrgPolicy` method, use the `etag` value - # that was returned from a `GetOrgPolicy` request as part of a - # read-modify-write loop for concurrency control. Not setting the `etag`in a - # `SetOrgPolicy` request will result in an unconditional write of the - # `Policy`. + # concurrency control. When the `Policy` is returned from either a `GetPolicy` + # or a `ListOrgPolicy` request, this `etag` indicates the version of the current + # `Policy` to use when executing a read-modify-write loop. When the `Policy` is + # returned from a `GetEffectivePolicy` request, the `etag` will be unset. When + # the `Policy` is used in a `SetOrgPolicy` method, use the `etag` value that was + # returned from a `GetOrgPolicy` request as part of a read-modify-write loop for + # concurrency control. Not setting the `etag`in a `SetOrgPolicy` request will + # result in an unconditional write of the `Policy`. # Corresponds to the JSON property `etag` # NOTE: Values are automatically base64 encoded/decoded in the client library. # @return [String] attr_accessor :etag - # Used in `policy_type` to specify how `list_policy` behaves at this - # resource. - # `ListPolicy` can define specific values and subtrees of Cloud Resource - # Manager resource hierarchy (`Organizations`, `Folders`, `Projects`) that - # are allowed or denied by setting the `allowed_values` and `denied_values` - # fields. This is achieved by using the `under:` and optional `is:` prefixes. - # The `under:` prefix is used to denote resource subtree values. - # The `is:` prefix is used to denote specific values, and is required only - # if the value contains a ":". Values prefixed with "is:" are treated the - # same as values with no prefix. - # Ancestry subtrees must be in one of the following formats: - # - "projects/", e.g. "projects/tokyo-rain-123" - # - "folders/", e.g. "folders/1234" - # - "organizations/", e.g. "organizations/1234" - # The `supports_under` field of the associated `Constraint` defines whether - # ancestry prefixes can be used. You can set `allowed_values` and - # `denied_values` in the same `Policy` if `all_values` is - # `ALL_VALUES_UNSPECIFIED`. `ALLOW` or `DENY` are used to allow or deny all - # values. If `all_values` is set to either `ALLOW` or `DENY`, - # `allowed_values` and `denied_values` must be unset. + # Used in `policy_type` to specify how `list_policy` behaves at this resource. ` + # ListPolicy` can define specific values and subtrees of Cloud Resource Manager + # resource hierarchy (`Organizations`, `Folders`, `Projects`) that are allowed + # or denied by setting the `allowed_values` and `denied_values` fields. This is + # achieved by using the `under:` and optional `is:` prefixes. The `under:` + # prefix is used to denote resource subtree values. The `is:` prefix is used to + # denote specific values, and is required only if the value contains a ":". + # Values prefixed with "is:" are treated the same as values with no prefix. + # Ancestry subtrees must be in one of the following formats: - "projects/", e.g. + # "projects/tokyo-rain-123" - "folders/", e.g. "folders/1234" - "organizations/", + # e.g. "organizations/1234" The `supports_under` field of the associated ` + # Constraint` defines whether ancestry prefixes can be used. You can set ` + # allowed_values` and `denied_values` in the same `Policy` if `all_values` is ` + # ALL_VALUES_UNSPECIFIED`. `ALLOW` or `DENY` are used to allow or deny all + # values. If `all_values` is set to either `ALLOW` or `DENY`, `allowed_values` + # and `denied_values` must be unset. # Corresponds to the JSON property `listPolicy` # @return [Google::Apis::CloudresourcemanagerV1::ListPolicy] attr_accessor :list_policy - # Ignores policies set above this resource and restores the - # `constraint_default` enforcement behavior of the specific `Constraint` at - # this resource. - # Suppose that `constraint_default` is set to `ALLOW` for the - # `Constraint` `constraints/serviceuser.services`. Suppose that organization - # foo.com sets a `Policy` at their Organization resource node that restricts - # the allowed service activations to deny all service activations. They - # could then set a `Policy` with the `policy_type` `restore_default` on - # several experimental projects, restoring the `constraint_default` - # enforcement of the `Constraint` for only those projects, allowing those - # projects to have all services activated. + # Ignores policies set above this resource and restores the `constraint_default` + # enforcement behavior of the specific `Constraint` at this resource. Suppose + # that `constraint_default` is set to `ALLOW` for the `Constraint` `constraints/ + # serviceuser.services`. Suppose that organization foo.com sets a `Policy` at + # their Organization resource node that restricts the allowed service + # activations to deny all service activations. They could then set a `Policy` + # with the `policy_type` `restore_default` on several experimental projects, + # restoring the `constraint_default` enforcement of the `Constraint` for only + # those projects, allowing those projects to have all services activated. # Corresponds to the JSON property `restoreDefault` # @return [Google::Apis::CloudresourcemanagerV1::RestoreDefault] attr_accessor :restore_default - # The time stamp the `Policy` was previously updated. This is set by the - # server, not specified by the caller, and represents the last time a call to - # `SetOrgPolicy` was made for that `Policy`. Any value set by the client will - # be ignored. + # The time stamp the `Policy` was previously updated. This is set by the server, + # not specified by the caller, and represents the last time a call to ` + # SetOrgPolicy` was made for that `Policy`. Any value set by the client will be + # ignored. # Corresponds to the JSON property `updateTime` # @return [String] attr_accessor :update_time @@ -1274,8 +1119,8 @@ module Google end end - # The root node in the resource hierarchy to which a particular entity's - # (e.g., company) resources belong. + # The root node in the resource hierarchy to which a particular entity's (e.g., + # company) resources belong. class Organization include Google::Apis::Core::Hashable @@ -1284,10 +1129,10 @@ module Google # @return [String] attr_accessor :creation_time - # A human-readable string that refers to the Organization in the - # GCP Console UI. This string is set by the server and cannot be - # changed. The string will be set to the primary domain (for example, - # "google.com") of the G Suite customer that owns the organization. + # A human-readable string that refers to the Organization in the GCP Console UI. + # This string is set by the server and cannot be changed. The string will be set + # to the primary domain (for example, "google.com") of the G Suite customer that + # owns the organization. # Corresponds to the JSON property `displayName` # @return [String] attr_accessor :display_name @@ -1297,16 +1142,16 @@ module Google # @return [String] attr_accessor :lifecycle_state - # Output only. The resource name of the organization. This is the - # organization's relative path in the API. Its format is - # "organizations/[organization_id]". For example, "organizations/1234". + # Output only. The resource name of the organization. This is the organization's + # relative path in the API. Its format is "organizations/[organization_id]". For + # example, "organizations/1234". # Corresponds to the JSON property `name` # @return [String] attr_accessor :name - # The entity that owns an Organization. The lifetime of the Organization and - # all of its descendants are bound to the `OrganizationOwner`. If the - # `OrganizationOwner` is deleted, the Organization and all its descendants will + # The entity that owns an Organization. The lifetime of the Organization and all + # of its descendants are bound to the `OrganizationOwner`. If the ` + # OrganizationOwner` is deleted, the Organization and all its descendants will # be deleted. # Corresponds to the JSON property `owner` # @return [Google::Apis::CloudresourcemanagerV1::OrganizationOwner] @@ -1326,9 +1171,9 @@ module Google end end - # The entity that owns an Organization. The lifetime of the Organization and - # all of its descendants are bound to the `OrganizationOwner`. If the - # `OrganizationOwner` is deleted, the Organization and all its descendants will + # The entity that owns an Organization. The lifetime of the Organization and all + # of its descendants are bound to the `OrganizationOwner`. If the ` + # OrganizationOwner` is deleted, the Organization and all its descendants will # be deleted. class OrganizationOwner include Google::Apis::Core::Hashable @@ -1349,66 +1194,32 @@ module Google end # An Identity and Access Management (IAM) policy, which specifies access - # controls for Google Cloud resources. - # A `Policy` is a collection of `bindings`. A `binding` binds one or more - # `members` to a single `role`. Members can be user accounts, service accounts, - # Google groups, and domains (such as G Suite). A `role` is a named list of - # permissions; each `role` can be an IAM predefined role or a user-created - # custom role. - # For some types of Google Cloud resources, a `binding` can also specify a - # `condition`, which is a logical expression that allows access to a resource - # only if the expression evaluates to `true`. A condition can add constraints - # based on attributes of the request, the resource, or both. To learn which - # resources support conditions in their IAM policies, see the - # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource- - # policies). - # **JSON example:** - # ` - # "bindings": [ - # ` - # "role": "roles/resourcemanager.organizationAdmin", - # "members": [ - # "user:mike@example.com", - # "group:admins@example.com", - # "domain:google.com", - # "serviceAccount:my-project-id@appspot.gserviceaccount.com" - # ] - # `, - # ` - # "role": "roles/resourcemanager.organizationViewer", - # "members": [ - # "user:eve@example.com" - # ], - # "condition": ` - # "title": "expirable access", - # "description": "Does not grant access after Sep 2020", - # "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z') - # ", - # ` - # ` - # ], - # "etag": "BwWWja0YfJA=", - # "version": 3 - # ` - # **YAML example:** - # bindings: - # - members: - # - user:mike@example.com - # - group:admins@example.com - # - domain:google.com - # - serviceAccount:my-project-id@appspot.gserviceaccount.com - # role: roles/resourcemanager.organizationAdmin - # - members: - # - user:eve@example.com - # role: roles/resourcemanager.organizationViewer - # condition: - # title: expirable access - # description: Does not grant access after Sep 2020 - # expression: request.time < timestamp('2020-10-01T00:00:00.000Z') - # - etag: BwWWja0YfJA= - # - version: 3 - # For a description of IAM and its features, see the - # [IAM documentation](https://cloud.google.com/iam/docs/). + # controls for Google Cloud resources. A `Policy` is a collection of `bindings`. + # A `binding` binds one or more `members` to a single `role`. Members can be + # user accounts, service accounts, Google groups, and domains (such as G Suite). + # A `role` is a named list of permissions; each `role` can be an IAM predefined + # role or a user-created custom role. For some types of Google Cloud resources, + # a `binding` can also specify a `condition`, which is a logical expression that + # allows access to a resource only if the expression evaluates to `true`. A + # condition can add constraints based on attributes of the request, the resource, + # or both. To learn which resources support conditions in their IAM policies, + # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/ + # resource-policies). **JSON example:** ` "bindings": [ ` "role": "roles/ + # resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", " + # group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@ + # appspot.gserviceaccount.com" ] `, ` "role": "roles/resourcemanager. + # organizationViewer", "members": [ "user:eve@example.com" ], "condition": ` " + # title": "expirable access", "description": "Does not grant access after Sep + # 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", ` + # ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:** bindings: - + # members: - user:mike@example.com - group:admins@example.com - domain:google. + # com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/ + # resourcemanager.organizationAdmin - members: - user:eve@example.com role: + # roles/resourcemanager.organizationViewer condition: title: expirable access + # description: Does not grant access after Sep 2020 expression: request.time < + # timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: 3 For a + # description of IAM and its features, see the [IAM documentation](https://cloud. + # google.com/iam/docs/). class Policy include Google::Apis::Core::Hashable @@ -1417,48 +1228,44 @@ module Google # @return [Array] attr_accessor :audit_configs - # Associates a list of `members` to a `role`. Optionally, may specify a - # `condition` that determines how and when the `bindings` are applied. Each - # of the `bindings` must contain at least one member. + # Associates a list of `members` to a `role`. Optionally, may specify a ` + # condition` that determines how and when the `bindings` are applied. Each of + # the `bindings` must contain at least one member. # Corresponds to the JSON property `bindings` # @return [Array] attr_accessor :bindings - # `etag` is used for optimistic concurrency control as a way to help - # prevent simultaneous updates of a policy from overwriting each other. - # It is strongly suggested that systems make use of the `etag` in the - # read-modify-write cycle to perform policy updates in order to avoid race - # conditions: An `etag` is returned in the response to `getIamPolicy`, and - # systems are expected to put that etag in the request to `setIamPolicy` to - # ensure that their change will be applied to the same version of the policy. - # **Important:** If you use IAM Conditions, you must include the `etag` field - # whenever you call `setIamPolicy`. If you omit this field, then IAM allows - # you to overwrite a version `3` policy with a version `1` policy, and all of - # the conditions in the version `3` policy are lost. + # `etag` is used for optimistic concurrency control as a way to help prevent + # simultaneous updates of a policy from overwriting each other. It is strongly + # suggested that systems make use of the `etag` in the read-modify-write cycle + # to perform policy updates in order to avoid race conditions: An `etag` is + # returned in the response to `getIamPolicy`, and systems are expected to put + # that etag in the request to `setIamPolicy` to ensure that their change will be + # applied to the same version of the policy. **Important:** If you use IAM + # Conditions, you must include the `etag` field whenever you call `setIamPolicy`. + # If you omit this field, then IAM allows you to overwrite a version `3` policy + # with a version `1` policy, and all of the conditions in the version `3` policy + # are lost. # Corresponds to the JSON property `etag` # NOTE: Values are automatically base64 encoded/decoded in the client library. # @return [String] attr_accessor :etag - # Specifies the format of the policy. - # Valid values are `0`, `1`, and `3`. Requests that specify an invalid value - # are rejected. - # Any operation that affects conditional role bindings must specify version - # `3`. This requirement applies to the following operations: - # * Getting a policy that includes a conditional role binding - # * Adding a conditional role binding to a policy - # * Changing a conditional role binding in a policy - # * Removing any role binding, with or without a condition, from a policy - # that includes conditions - # **Important:** If you use IAM Conditions, you must include the `etag` field - # whenever you call `setIamPolicy`. If you omit this field, then IAM allows - # you to overwrite a version `3` policy with a version `1` policy, and all of - # the conditions in the version `3` policy are lost. - # If a policy does not include any conditions, operations on that policy may - # specify any valid version or leave the field unset. - # To learn which resources support conditions in their IAM policies, see the - # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource- - # policies). + # Specifies the format of the policy. Valid values are `0`, `1`, and `3`. + # Requests that specify an invalid value are rejected. Any operation that + # affects conditional role bindings must specify version `3`. This requirement + # applies to the following operations: * Getting a policy that includes a + # conditional role binding * Adding a conditional role binding to a policy * + # Changing a conditional role binding in a policy * Removing any role binding, + # with or without a condition, from a policy that includes conditions ** + # Important:** If you use IAM Conditions, you must include the `etag` field + # whenever you call `setIamPolicy`. If you omit this field, then IAM allows you + # to overwrite a version `3` policy with a version `1` policy, and all of the + # conditions in the version `3` policy are lost. If a policy does not include + # any conditions, operations on that policy may specify any valid version or + # leave the field unset. To learn which resources support conditions in their + # IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/ + # conditions/resource-policies). # Corresponds to the JSON property `version` # @return [Fixnum] attr_accessor :version @@ -1476,69 +1283,56 @@ module Google end end - # A Project is a high-level Google Cloud Platform entity. It is a - # container for ACLs, APIs, App Engine Apps, VMs, and other - # Google Cloud Platform resources. + # A Project is a high-level Google Cloud Platform entity. It is a container for + # ACLs, APIs, App Engine Apps, VMs, and other Google Cloud Platform resources. class Project include Google::Apis::Core::Hashable - # Creation time. - # Read-only. + # Creation time. Read-only. # Corresponds to the JSON property `createTime` # @return [String] attr_accessor :create_time - # The labels associated with this Project. - # Label keys must be between 1 and 63 characters long and must conform - # to the following regular expression: a-z`0,62`. - # Label values must be between 0 and 63 characters long and must conform - # to the regular expression [a-z0-9_-]`0,63`. A label value can be empty. - # No more than 256 labels can be associated with a given resource. - # Clients should store labels in a representation such as JSON that does not - # depend on specific characters being disallowed. - # Example: "environment" : "dev" - # Read-write. + # The labels associated with this Project. Label keys must be between 1 and 63 + # characters long and must conform to the following regular expression: a-z`0,62` + # . Label values must be between 0 and 63 characters long and must conform to + # the regular expression [a-z0-9_-]`0,63`. A label value can be empty. No more + # than 256 labels can be associated with a given resource. Clients should store + # labels in a representation such as JSON that does not depend on specific + # characters being disallowed. Example: "environment" : "dev" Read-write. # Corresponds to the JSON property `labels` # @return [Hash] attr_accessor :labels - # The Project lifecycle state. - # Read-only. + # The Project lifecycle state. Read-only. # Corresponds to the JSON property `lifecycleState` # @return [String] attr_accessor :lifecycle_state - # The optional user-assigned display name of the Project. - # When present it must be between 4 to 30 characters. - # Allowed characters are: lowercase and uppercase letters, numbers, - # hyphen, single-quote, double-quote, space, and exclamation point. - # Example: My Project - # Read-write. + # The optional user-assigned display name of the Project. When present it must + # be between 4 to 30 characters. Allowed characters are: lowercase and uppercase + # letters, numbers, hyphen, single-quote, double-quote, space, and exclamation + # point. Example: My Project Read-write. # Corresponds to the JSON property `name` # @return [String] attr_accessor :name # A container to reference an id for any resource type. A `resource` in Google # Cloud Platform is a generic term for something you (a developer) may want to - # interact with through one of our API's. Some examples are an App Engine app, - # a Compute Engine instance, a Cloud SQL database, and so on. + # interact with through one of our API's. Some examples are an App Engine app, a + # Compute Engine instance, a Cloud SQL database, and so on. # Corresponds to the JSON property `parent` # @return [Google::Apis::CloudresourcemanagerV1::ResourceId] attr_accessor :parent - # The unique, user-assigned ID of the Project. - # It must be 6 to 30 lowercase letters, digits, or hyphens. - # It must start with a letter. - # Trailing hyphens are prohibited. - # Example: tokyo-rain-123 - # Read-only after creation. + # The unique, user-assigned ID of the Project. It must be 6 to 30 lowercase + # letters, digits, or hyphens. It must start with a letter. Trailing hyphens are + # prohibited. Example: tokyo-rain-123 Read-only after creation. # Corresponds to the JSON property `projectId` # @return [String] attr_accessor :project_id - # The number uniquely identifying the project. - # Example: 415104041262 - # Read-only. + # The number uniquely identifying the project. Example: 415104041262 Read-only. # Corresponds to the JSON property `projectNumber` # @return [Fixnum] attr_accessor :project_number @@ -1570,9 +1364,8 @@ module Google # @return [String] attr_accessor :create_time - # True if the project can be retrieved using GetProject. No other operations - # on the project are guaranteed to work until the project creation is - # complete. + # True if the project can be retrieved using GetProject. No other operations on + # the project are guaranteed to work until the project creation is complete. # Corresponds to the JSON property `gettable` # @return [Boolean] attr_accessor :gettable @@ -1598,19 +1391,19 @@ module Google # A container to reference an id for any resource type. A `resource` in Google # Cloud Platform is a generic term for something you (a developer) may want to - # interact with through one of our API's. Some examples are an App Engine app, - # a Compute Engine instance, a Cloud SQL database, and so on. + # interact with through one of our API's. Some examples are an App Engine app, a + # Compute Engine instance, a Cloud SQL database, and so on. class ResourceId include Google::Apis::Core::Hashable - # Required field for the type-specific id. This should correspond to the id - # used in the type-specific API's. + # Required field for the type-specific id. This should correspond to the id used + # in the type-specific API's. # Corresponds to the JSON property `id` # @return [String] attr_accessor :id - # Required field representing the resource type this id is for. - # At present, the valid types are: "organization", "folder", and "project". + # Required field representing the resource type this id is for. At present, the + # valid types are: "organization", "folder", and "project". # Corresponds to the JSON property `type` # @return [String] attr_accessor :type @@ -1626,17 +1419,15 @@ module Google end end - # Ignores policies set above this resource and restores the - # `constraint_default` enforcement behavior of the specific `Constraint` at - # this resource. - # Suppose that `constraint_default` is set to `ALLOW` for the - # `Constraint` `constraints/serviceuser.services`. Suppose that organization - # foo.com sets a `Policy` at their Organization resource node that restricts - # the allowed service activations to deny all service activations. They - # could then set a `Policy` with the `policy_type` `restore_default` on - # several experimental projects, restoring the `constraint_default` - # enforcement of the `Constraint` for only those projects, allowing those - # projects to have all services activated. + # Ignores policies set above this resource and restores the `constraint_default` + # enforcement behavior of the specific `Constraint` at this resource. Suppose + # that `constraint_default` is set to `ALLOW` for the `Constraint` `constraints/ + # serviceuser.services`. Suppose that organization foo.com sets a `Policy` at + # their Organization resource node that restricts the allowed service + # activations to deny all service activations. They could then set a `Policy` + # with the `policy_type` `restore_default` on several experimental projects, + # restoring the `constraint_default` enforcement of the `Constraint` for only + # those projects, allowing those projects to have all services activated. class RestoreDefault include Google::Apis::Core::Hashable @@ -1653,28 +1444,25 @@ module Google class SearchOrganizationsRequest include Google::Apis::Core::Hashable - # An optional query string used to filter the Organizations to return in - # the response. Filter rules are case-insensitive. - # Organizations may be filtered by `owner.directoryCustomerId` or by - # `domain`, where the domain is a G Suite domain, for example: - # * Filter `owner.directorycustomerid:123456789` returns Organization - # resources with `owner.directory_customer_id` equal to `123456789`. - # * Filter `domain:google.com` returns Organization resources corresponding - # to the domain `google.com`. - # This field is optional. + # An optional query string used to filter the Organizations to return in the + # response. Filter rules are case-insensitive. Organizations may be filtered by ` + # owner.directoryCustomerId` or by `domain`, where the domain is a G Suite + # domain, for example: * Filter `owner.directorycustomerid:123456789` returns + # Organization resources with `owner.directory_customer_id` equal to `123456789`. + # * Filter `domain:google.com` returns Organization resources corresponding to + # the domain `google.com`. This field is optional. # Corresponds to the JSON property `filter` # @return [String] attr_accessor :filter - # The maximum number of Organizations to return in the response. - # This field is optional. + # The maximum number of Organizations to return in the response. This field is + # optional. # Corresponds to the JSON property `pageSize` # @return [Fixnum] attr_accessor :page_size - # A pagination token returned from a previous call to `SearchOrganizations` - # that indicates from where listing should continue. - # This field is optional. + # A pagination token returned from a previous call to `SearchOrganizations` that + # indicates from where listing should continue. This field is optional. # Corresponds to the JSON property `pageToken` # @return [String] attr_accessor :page_token @@ -1696,16 +1484,15 @@ module Google include Google::Apis::Core::Hashable # A pagination token to be used to retrieve the next page of results. If the - # result is too large to fit within the page size specified in the request, - # this field will be set with a token that can be used to fetch the next page - # of results. If this field is empty, it indicates that this response - # contains the last page of results. + # result is too large to fit within the page size specified in the request, this + # field will be set with a token that can be used to fetch the next page of + # results. If this field is empty, it indicates that this response contains the + # last page of results. # Corresponds to the JSON property `nextPageToken` # @return [String] attr_accessor :next_page_token - # The list of Organizations that matched the search query, possibly - # paginated. + # The list of Organizations that matched the search query, possibly paginated. # Corresponds to the JSON property `organizations` # @return [Array] attr_accessor :organizations @@ -1726,74 +1513,39 @@ module Google include Google::Apis::Core::Hashable # An Identity and Access Management (IAM) policy, which specifies access - # controls for Google Cloud resources. - # A `Policy` is a collection of `bindings`. A `binding` binds one or more - # `members` to a single `role`. Members can be user accounts, service accounts, - # Google groups, and domains (such as G Suite). A `role` is a named list of - # permissions; each `role` can be an IAM predefined role or a user-created - # custom role. - # For some types of Google Cloud resources, a `binding` can also specify a - # `condition`, which is a logical expression that allows access to a resource - # only if the expression evaluates to `true`. A condition can add constraints - # based on attributes of the request, the resource, or both. To learn which - # resources support conditions in their IAM policies, see the - # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource- - # policies). - # **JSON example:** - # ` - # "bindings": [ - # ` - # "role": "roles/resourcemanager.organizationAdmin", - # "members": [ - # "user:mike@example.com", - # "group:admins@example.com", - # "domain:google.com", - # "serviceAccount:my-project-id@appspot.gserviceaccount.com" - # ] - # `, - # ` - # "role": "roles/resourcemanager.organizationViewer", - # "members": [ - # "user:eve@example.com" - # ], - # "condition": ` - # "title": "expirable access", - # "description": "Does not grant access after Sep 2020", - # "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z') - # ", - # ` - # ` - # ], - # "etag": "BwWWja0YfJA=", - # "version": 3 - # ` - # **YAML example:** - # bindings: - # - members: - # - user:mike@example.com - # - group:admins@example.com - # - domain:google.com - # - serviceAccount:my-project-id@appspot.gserviceaccount.com - # role: roles/resourcemanager.organizationAdmin - # - members: - # - user:eve@example.com - # role: roles/resourcemanager.organizationViewer - # condition: - # title: expirable access - # description: Does not grant access after Sep 2020 - # expression: request.time < timestamp('2020-10-01T00:00:00.000Z') - # - etag: BwWWja0YfJA= - # - version: 3 - # For a description of IAM and its features, see the - # [IAM documentation](https://cloud.google.com/iam/docs/). + # controls for Google Cloud resources. A `Policy` is a collection of `bindings`. + # A `binding` binds one or more `members` to a single `role`. Members can be + # user accounts, service accounts, Google groups, and domains (such as G Suite). + # A `role` is a named list of permissions; each `role` can be an IAM predefined + # role or a user-created custom role. For some types of Google Cloud resources, + # a `binding` can also specify a `condition`, which is a logical expression that + # allows access to a resource only if the expression evaluates to `true`. A + # condition can add constraints based on attributes of the request, the resource, + # or both. To learn which resources support conditions in their IAM policies, + # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/ + # resource-policies). **JSON example:** ` "bindings": [ ` "role": "roles/ + # resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", " + # group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@ + # appspot.gserviceaccount.com" ] `, ` "role": "roles/resourcemanager. + # organizationViewer", "members": [ "user:eve@example.com" ], "condition": ` " + # title": "expirable access", "description": "Does not grant access after Sep + # 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", ` + # ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:** bindings: - + # members: - user:mike@example.com - group:admins@example.com - domain:google. + # com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/ + # resourcemanager.organizationAdmin - members: - user:eve@example.com role: + # roles/resourcemanager.organizationViewer condition: title: expirable access + # description: Does not grant access after Sep 2020 expression: request.time < + # timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: 3 For a + # description of IAM and its features, see the [IAM documentation](https://cloud. + # google.com/iam/docs/). # Corresponds to the JSON property `policy` # @return [Google::Apis::CloudresourcemanagerV1::Policy] attr_accessor :policy # OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only - # the fields in the mask will be modified. If no mask is provided, the - # following default mask is used: - # `paths: "bindings, etag"` + # the fields in the mask will be modified. If no mask is provided, the following + # default mask is used: `paths: "bindings, etag"` # Corresponds to the JSON property `updateMask` # @return [String] attr_accessor :update_mask @@ -1829,12 +1581,12 @@ module Google end end - # 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). + # 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). class Status include Google::Apis::Core::Hashable @@ -1843,15 +1595,15 @@ module Google # @return [Fixnum] attr_accessor :code - # A list of messages that carry the error details. There is a common set of + # A list of messages that carry the error details. There is a common set of # message types for APIs to use. # Corresponds to the JSON property `details` # @return [Array>] attr_accessor :details - # 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. + # 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. # Corresponds to the JSON property `message` # @return [String] attr_accessor :message @@ -1872,10 +1624,9 @@ module Google class TestIamPermissionsRequest include Google::Apis::Core::Hashable - # The set of permissions to check for the `resource`. Permissions with - # wildcards (such as '*' or 'storage.*') are not allowed. For more - # information see - # [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions). + # The set of permissions to check for the `resource`. Permissions with wildcards + # (such as '*' or 'storage.*') are not allowed. For more information see [IAM + # Overview](https://cloud.google.com/iam/docs/overview#permissions). # Corresponds to the JSON property `permissions` # @return [Array] attr_accessor :permissions @@ -1894,8 +1645,7 @@ module Google class TestIamPermissionsResponse include Google::Apis::Core::Hashable - # A subset of `TestPermissionsRequest.permissions` that the caller is - # allowed. + # A subset of `TestPermissionsRequest.permissions` that the caller is allowed. # Corresponds to the JSON property `permissions` # @return [Array] attr_accessor :permissions @@ -1910,8 +1660,7 @@ module Google end end - # The request sent to the UndeleteProject - # method. + # The request sent to the UndeleteProject method. class UndeleteProjectRequest include Google::Apis::Core::Hashable diff --git a/generated/google/apis/cloudresourcemanager_v1/service.rb b/generated/google/apis/cloudresourcemanager_v1/service.rb index ce3fcf5c2..2809ff0a9 100644 --- a/generated/google/apis/cloudresourcemanager_v1/service.rb +++ b/generated/google/apis/cloudresourcemanager_v1/service.rb @@ -81,11 +81,11 @@ module Google execute_or_queue_command(command, &block) end - # Gets the effective `Policy` on a resource. This is the result of merging - # `Policies` in the resource hierarchy. The returned `Policy` will not have - # an `etag`set because it is a computed `Policy` across multiple resources. - # Subtrees of Resource Manager resource hierarchy with 'under:' prefix will - # not be expanded. + # Gets the effective `Policy` on a resource. This is the result of merging ` + # Policies` in the resource hierarchy. The returned `Policy` will not have an ` + # etag`set because it is a computed `Policy` across multiple resources. Subtrees + # of Resource Manager resource hierarchy with 'under:' prefix will not be + # expanded. # @param [String] resource # The name of the resource to start computing the effective `Policy`. # @param [Google::Apis::CloudresourcemanagerV1::GetEffectiveOrgPolicyRequest] get_effective_org_policy_request_object @@ -118,11 +118,10 @@ module Google execute_or_queue_command(command, &block) end - # Gets a `Policy` on a resource. - # If no `Policy` is set on the resource, a `Policy` is returned with default - # values including `POLICY_TYPE_NOT_SET` for the `policy_type oneof`. The - # `etag` value can be used with `SetOrgPolicy()` to create or update a - # `Policy` during read-modify-write. + # Gets a `Policy` on a resource. If no `Policy` is set on the resource, a ` + # Policy` is returned with default values including `POLICY_TYPE_NOT_SET` for + # the `policy_type oneof`. The `etag` value can be used with `SetOrgPolicy()` to + # create or update a `Policy` during read-modify-write. # @param [String] resource # Name of the resource the `Policy` is set on. # @param [Google::Apis::CloudresourcemanagerV1::GetOrgPolicyRequest] get_org_policy_request_object @@ -222,9 +221,9 @@ module Google end # Updates the specified `Policy` on the resource. Creates a new `Policy` for - # that `Constraint` on the resource if one does not exist. - # Not supplying an `etag` on the request `Policy` results in an unconditional - # write of the `Policy`. + # that `Constraint` on the resource if one does not exist. Not supplying an ` + # etag` on the request `Policy` results in an unconditional write of the `Policy` + # . # @param [String] resource # Resource name of the resource to attach the `Policy`. # @param [Google::Apis::CloudresourcemanagerV1::SetOrgPolicyRequest] set_org_policy_request_object @@ -258,10 +257,10 @@ module Google end # Create a Lien which applies to the resource denoted by the `parent` field. - # Callers of this method will require permission on the `parent` resource. - # For example, applying to `projects/1234` requires permission - # `resourcemanager.projects.updateLiens`. - # NOTE: Some resources may limit the number of Liens which may be applied. + # Callers of this method will require permission on the `parent` resource. For + # example, applying to `projects/1234` requires permission `resourcemanager. + # projects.updateLiens`. NOTE: Some resources may limit the number of Liens + # which may be applied. # @param [Google::Apis::CloudresourcemanagerV1::Lien] lien_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -291,10 +290,9 @@ module Google execute_or_queue_command(command, &block) end - # Delete a Lien by `name`. - # Callers of this method will require permission on the `parent` resource. - # For example, a Lien with a `parent` of `projects/1234` requires permission - # `resourcemanager.projects.updateLiens`. + # Delete a Lien by `name`. Callers of this method will require permission on the + # `parent` resource. For example, a Lien with a `parent` of `projects/1234` + # requires permission `resourcemanager.projects.updateLiens`. # @param [String] name # Required. The name/identifier of the Lien to delete. # @param [String] fields @@ -324,11 +322,10 @@ module Google execute_or_queue_command(command, &block) end - # Retrieve a Lien by `name`. - # Callers of this method will require permission on the `parent` resource. - # For example, a Lien with a `parent` of `projects/1234` requires permission - # requires permission `resourcemanager.projects.get` or - # `resourcemanager.projects.updateLiens`. + # Retrieve a Lien by `name`. Callers of this method will require permission on + # the `parent` resource. For example, a Lien with a `parent` of `projects/1234` + # requires permission requires permission `resourcemanager.projects.get` or ` + # resourcemanager.projects.updateLiens`. # @param [String] name # Required. The name/identifier of the Lien. # @param [String] fields @@ -358,19 +355,17 @@ module Google execute_or_queue_command(command, &block) end - # List all Liens applied to the `parent` resource. - # Callers of this method will require permission on the `parent` resource. - # For example, a Lien with a `parent` of `projects/1234` requires permission - # `resourcemanager.projects.get`. + # List all Liens applied to the `parent` resource. Callers of this method will + # require permission on the `parent` resource. For example, a Lien with a ` + # parent` of `projects/1234` requires permission `resourcemanager.projects.get`. # @param [Fixnum] page_size # The maximum number of items to return. This is a suggestion for the server. # @param [String] page_token # The `next_page_token` value returned from a previous List request, if any. # @param [String] parent - # Required. The name of the resource to list all attached Liens. - # For example, `projects/1234`. - # (google.api.field_policy).resource_type annotation is not set since the - # parent depends on the meta api implementation. This field could be a + # Required. The name of the resource to list all attached Liens. For example, ` + # projects/1234`. (google.api.field_policy).resource_type annotation is not set + # since the parent depends on the meta api implementation. This field could be a # project or other sub project resources. # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -401,9 +396,8 @@ module Google execute_or_queue_command(command, &block) end - # 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. + # 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. # @param [String] name # The name of the operation resource. # @param [String] fields @@ -469,8 +463,8 @@ module Google # Fetches an Organization resource identified by the specified resource name. # @param [String] name # The resource name of the Organization to fetch. This is the organization's - # relative path in the API, formatted as "organizations/[organizationId]". - # For example, "organizations/1234". + # relative path in the API, formatted as "organizations/[organizationId]". For + # example, "organizations/1234". # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -498,11 +492,11 @@ module Google execute_or_queue_command(command, &block) end - # Gets the effective `Policy` on a resource. This is the result of merging - # `Policies` in the resource hierarchy. The returned `Policy` will not have - # an `etag`set because it is a computed `Policy` across multiple resources. - # Subtrees of Resource Manager resource hierarchy with 'under:' prefix will - # not be expanded. + # Gets the effective `Policy` on a resource. This is the result of merging ` + # Policies` in the resource hierarchy. The returned `Policy` will not have an ` + # etag`set because it is a computed `Policy` across multiple resources. Subtrees + # of Resource Manager resource hierarchy with 'under:' prefix will not be + # expanded. # @param [String] resource # The name of the resource to start computing the effective `Policy`. # @param [Google::Apis::CloudresourcemanagerV1::GetEffectiveOrgPolicyRequest] get_effective_org_policy_request_object @@ -535,14 +529,14 @@ module Google execute_or_queue_command(command, &block) end - # Gets the access control policy for an Organization resource. May be empty - # if no such policy or resource exists. The `resource` field should be the - # organization's resource name, e.g. "organizations/123". - # Authorization requires the Google IAM permission - # `resourcemanager.organizations.getIamPolicy` on the specified organization + # Gets the access control policy for an Organization resource. May be empty if + # no such policy or resource exists. The `resource` field should be the + # organization's resource name, e.g. "organizations/123". Authorization requires + # the Google IAM permission `resourcemanager.organizations.getIamPolicy` on the + # specified organization # @param [String] resource - # REQUIRED: The resource for which the policy is being requested. - # See the operation documentation for the appropriate value for this field. + # REQUIRED: The resource for which the policy is being requested. See the + # operation documentation for the appropriate value for this field. # @param [Google::Apis::CloudresourcemanagerV1::GetIamPolicyRequest] get_iam_policy_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -573,11 +567,10 @@ module Google execute_or_queue_command(command, &block) end - # Gets a `Policy` on a resource. - # If no `Policy` is set on the resource, a `Policy` is returned with default - # values including `POLICY_TYPE_NOT_SET` for the `policy_type oneof`. The - # `etag` value can be used with `SetOrgPolicy()` to create or update a - # `Policy` during read-modify-write. + # Gets a `Policy` on a resource. If no `Policy` is set on the resource, a ` + # Policy` is returned with default values including `POLICY_TYPE_NOT_SET` for + # the `policy_type oneof`. The `etag` value can be used with `SetOrgPolicy()` to + # create or update a `Policy` during read-modify-write. # @param [String] resource # Name of the resource the `Policy` is set on. # @param [Google::Apis::CloudresourcemanagerV1::GetOrgPolicyRequest] get_org_policy_request_object @@ -676,12 +669,11 @@ module Google execute_or_queue_command(command, &block) end - # Searches Organization resources that are visible to the user and satisfy - # the specified filter. This method returns Organizations in an unspecified - # order. New Organizations do not necessarily appear at the end of the - # results. - # Search will only return organizations on which the user has the permission - # `resourcemanager.organizations.get` + # Searches Organization resources that are visible to the user and satisfy the + # specified filter. This method returns Organizations in an unspecified order. + # New Organizations do not necessarily appear at the end of the results. Search + # will only return organizations on which the user has the permission ` + # resourcemanager.organizations.get` # @param [Google::Apis::CloudresourcemanagerV1::SearchOrganizationsRequest] search_organizations_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -713,12 +705,12 @@ module Google # Sets the access control policy on an Organization resource. Replaces any # existing policy. The `resource` field should be the organization's resource - # name, e.g. "organizations/123". - # Authorization requires the Google IAM permission - # `resourcemanager.organizations.setIamPolicy` on the specified organization + # name, e.g. "organizations/123". Authorization requires the Google IAM + # permission `resourcemanager.organizations.setIamPolicy` on the specified + # organization # @param [String] resource - # REQUIRED: The resource for which the policy is being specified. - # See the operation documentation for the appropriate value for this field. + # REQUIRED: The resource for which the policy is being specified. See the + # operation documentation for the appropriate value for this field. # @param [Google::Apis::CloudresourcemanagerV1::SetIamPolicyRequest] set_iam_policy_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -750,9 +742,9 @@ module Google end # Updates the specified `Policy` on the resource. Creates a new `Policy` for - # that `Constraint` on the resource if one does not exist. - # Not supplying an `etag` on the request `Policy` results in an unconditional - # write of the `Policy`. + # that `Constraint` on the resource if one does not exist. Not supplying an ` + # etag` on the request `Policy` results in an unconditional write of the `Policy` + # . # @param [String] resource # Resource name of the resource to attach the `Policy`. # @param [Google::Apis::CloudresourcemanagerV1::SetOrgPolicyRequest] set_org_policy_request_object @@ -785,13 +777,12 @@ module Google execute_or_queue_command(command, &block) end - # Returns permissions that a caller has on the specified Organization. - # The `resource` field should be the organization's resource name, - # e.g. "organizations/123". - # There are no permissions required for making this API call. + # Returns permissions that a caller has on the specified Organization. The ` + # resource` field should be the organization's resource name, e.g. " + # organizations/123". There are no permissions required for making this API call. # @param [String] resource - # REQUIRED: The resource for which the policy detail is being requested. - # See the operation documentation for the appropriate value for this field. + # REQUIRED: The resource for which the policy detail is being requested. See the + # operation documentation for the appropriate value for this field. # @param [Google::Apis::CloudresourcemanagerV1::TestIamPermissionsRequest] test_iam_permissions_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -855,19 +846,17 @@ module Google execute_or_queue_command(command, &block) end - # Request that a new Project be created. The result is an Operation which - # can be used to track the creation process. This process usually takes a few - # seconds, but can sometimes take much longer. The tracking Operation is - # automatically deleted after a few hours, so there is no need to call - # DeleteOperation. - # Authorization requires the Google IAM permission - # `resourcemanager.projects.create` on the specified parent for the new - # project. The parent is identified by a specified ResourceId, - # which must include both an ID and a type, such as organization. - # This method does not associate the new project with a billing account. - # You can set or update the billing account associated with a project using - # the [`projects.updateBillingInfo`] - # (/billing/reference/rest/v1/projects/updateBillingInfo) method. + # Request that a new Project be created. The result is an Operation which can be + # used to track the creation process. This process usually takes a few seconds, + # but can sometimes take much longer. The tracking Operation is automatically + # deleted after a few hours, so there is no need to call DeleteOperation. + # Authorization requires the Google IAM permission `resourcemanager.projects. + # create` on the specified parent for the new project. The parent is identified + # by a specified ResourceId, which must include both an ID and a type, such as + # organization. This method does not associate the new project with a billing + # account. You can set or update the billing account associated with a project + # using the [`projects.updateBillingInfo`] (/billing/reference/rest/v1/projects/ + # updateBillingInfo) method. # @param [Google::Apis::CloudresourcemanagerV1::Project] project_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -897,26 +886,18 @@ module Google execute_or_queue_command(command, &block) end - # Marks the Project identified by the specified - # `project_id` (for example, `my-project-123`) for deletion. - # This method will only affect the Project if it has a lifecycle state of - # ACTIVE. - # This method changes the Project's lifecycle state from - # ACTIVE - # to DELETE_REQUESTED. - # The deletion starts at an unspecified time, - # at which point the Project is no longer accessible. - # Until the deletion completes, you can check the lifecycle state - # checked by retrieving the Project with GetProject, - # and the Project remains visible to ListProjects. - # However, you cannot update the project. - # After the deletion completes, the Project is not retrievable by - # the GetProject and - # ListProjects methods. - # The caller must have modify permissions for this Project. + # Marks the Project identified by the specified `project_id` (for example, `my- + # project-123`) for deletion. This method will only affect the Project if it has + # a lifecycle state of ACTIVE. This method changes the Project's lifecycle state + # from ACTIVE to DELETE_REQUESTED. The deletion starts at an unspecified time, + # at which point the Project is no longer accessible. Until the deletion + # completes, you can check the lifecycle state checked by retrieving the Project + # with GetProject, and the Project remains visible to ListProjects. However, you + # cannot update the project. After the deletion completes, the Project is not + # retrievable by the GetProject and ListProjects methods. The caller must have + # modify permissions for this Project. # @param [String] project_id - # The Project ID (for example, `foo-bar-123`). - # Required. + # The Project ID (for example, `foo-bar-123`). Required. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -944,12 +925,10 @@ module Google execute_or_queue_command(command, &block) end - # Retrieves the Project identified by the specified - # `project_id` (for example, `my-project-123`). - # The caller must have read permissions for this Project. + # Retrieves the Project identified by the specified `project_id` (for example, ` + # my-project-123`). The caller must have read permissions for this Project. # @param [String] project_id - # The Project ID (for example, `my-project-123`). - # Required. + # The Project ID (for example, `my-project-123`). Required. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -977,12 +956,11 @@ module Google execute_or_queue_command(command, &block) end - # Gets a list of ancestors in the resource hierarchy for the Project - # identified by the specified `project_id` (for example, `my-project-123`). - # The caller must have read permissions for this Project. + # Gets a list of ancestors in the resource hierarchy for the Project identified + # by the specified `project_id` (for example, `my-project-123`). The caller must + # have read permissions for this Project. # @param [String] project_id - # The Project ID (for example, `my-project-123`). - # Required. + # The Project ID (for example, `my-project-123`). Required. # @param [Google::Apis::CloudresourcemanagerV1::GetAncestryRequest] get_ancestry_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -1013,11 +991,11 @@ module Google execute_or_queue_command(command, &block) end - # Gets the effective `Policy` on a resource. This is the result of merging - # `Policies` in the resource hierarchy. The returned `Policy` will not have - # an `etag`set because it is a computed `Policy` across multiple resources. - # Subtrees of Resource Manager resource hierarchy with 'under:' prefix will - # not be expanded. + # Gets the effective `Policy` on a resource. This is the result of merging ` + # Policies` in the resource hierarchy. The returned `Policy` will not have an ` + # etag`set because it is a computed `Policy` across multiple resources. Subtrees + # of Resource Manager resource hierarchy with 'under:' prefix will not be + # expanded. # @param [String] resource # The name of the resource to start computing the effective `Policy`. # @param [Google::Apis::CloudresourcemanagerV1::GetEffectiveOrgPolicyRequest] get_effective_org_policy_request_object @@ -1050,15 +1028,15 @@ module Google execute_or_queue_command(command, &block) end - # Returns the IAM access control policy for the specified Project. - # Permission is denied if the policy or the resource does not exist. - # Authorization requires the Google IAM permission - # `resourcemanager.projects.getIamPolicy` on the project. - # For additional information about `resource` (e.g. my-project-id) structure - # and identification, see [Resource Names](/apis/design/resource_names). + # Returns the IAM access control policy for the specified Project. Permission is + # denied if the policy or the resource does not exist. Authorization requires + # the Google IAM permission `resourcemanager.projects.getIamPolicy` on the + # project. For additional information about `resource` (e.g. my-project-id) + # structure and identification, see [Resource Names](/apis/design/resource_names) + # . # @param [String] resource - # REQUIRED: The resource for which the policy is being requested. - # See the operation documentation for the appropriate value for this field. + # REQUIRED: The resource for which the policy is being requested. See the + # operation documentation for the appropriate value for this field. # @param [Google::Apis::CloudresourcemanagerV1::GetIamPolicyRequest] get_iam_policy_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -1089,11 +1067,10 @@ module Google execute_or_queue_command(command, &block) end - # Gets a `Policy` on a resource. - # If no `Policy` is set on the resource, a `Policy` is returned with default - # values including `POLICY_TYPE_NOT_SET` for the `policy_type oneof`. The - # `etag` value can be used with `SetOrgPolicy()` to create or update a - # `Policy` during read-modify-write. + # Gets a `Policy` on a resource. If no `Policy` is set on the resource, a ` + # Policy` is returned with default values including `POLICY_TYPE_NOT_SET` for + # the `policy_type oneof`. The `etag` value can be used with `SetOrgPolicy()` to + # create or update a `Policy` during read-modify-write. # @param [String] resource # Name of the resource the `Policy` is set on. # @param [Google::Apis::CloudresourcemanagerV1::GetOrgPolicyRequest] get_org_policy_request_object @@ -1127,61 +1104,43 @@ module Google end # Lists Projects that the caller has the `resourcemanager.projects.get` - # permission on and satisfy the specified filter. - # This method returns Projects in an unspecified order. - # This method is eventually consistent with project mutations; this means - # that a newly created project may not appear in the results or recent - # updates to an existing project may not be reflected in the results. To - # retrieve the latest state of a project, use the - # GetProject method. - # NOTE: If the request filter contains a `parent.type` and `parent.id` and - # the caller has the `resourcemanager.projects.list` permission on the - # parent, the results will be drawn from an alternate index which provides - # more consistent results. In future versions of this API, this List method - # will be split into List and Search to properly capture the behavorial - # difference. + # permission on and satisfy the specified filter. This method returns Projects + # in an unspecified order. This method is eventually consistent with project + # mutations; this means that a newly created project may not appear in the + # results or recent updates to an existing project may not be reflected in the + # results. To retrieve the latest state of a project, use the GetProject method. + # NOTE: If the request filter contains a `parent.type` and `parent.id` and the + # caller has the `resourcemanager.projects.list` permission on the parent, the + # results will be drawn from an alternate index which provides more consistent + # results. In future versions of this API, this List method will be split into + # List and Search to properly capture the behavorial difference. # @param [String] filter - # An expression for filtering the results of the request. Filter rules are - # case insensitive. Some eligible fields for filtering are: - # + `name` - # + `id` - # + `labels.` (where *key* is the name of a label) - # + `parent.type` - # + `parent.id` - # + `lifecycleState` - # Some examples of filter strings: - # | Filter | Description | - # |------------------|-----------------------------------------------------| - # | name:how* | The project's name starts with "how". | - # | name:Howl | The project's name is `Howl` or `howl`. | - # | name:HOWL | Equivalent to above. | - # | NAME:howl | Equivalent to above. | - # | labels.color:* | The project has the label `color`. | - # | labels.color:red | The project's label `color` has the value `red`. | - # | labels.color:red labels.size:big | The project's label `color` | - # : : has the value `red` and its : - # : : label`size` has the value : - # : : `big`. : - # | lifecycleState:DELETE_REQUESTED | Only show projects that are | - # : : pending deletion. : - # If no filter is specified, the call will return projects for which the user - # has the `resourcemanager.projects.get` permission. - # NOTE: To perform a by-parent query (eg., what projects are directly in a - # Folder), the caller must have the `resourcemanager.projects.list` - # permission on the parent and the filter must contain both a `parent.type` - # and a `parent.id` restriction - # (example: "parent.type:folder parent.id:123"). In this case an alternate - # search index is used which provides more consistent results. - # Optional. + # An expression for filtering the results of the request. Filter rules are case + # insensitive. Some eligible fields for filtering are: + `name` + `id` + `labels. + # ` (where *key* is the name of a label) + `parent.type` + `parent.id` + ` + # lifecycleState` Some examples of filter strings: | Filter | Description | |---- + # --------------|-----------------------------------------------------| | name: + # how* | The project's name starts with "how". | | name:Howl | The project's + # name is `Howl` or `howl`. | | name:HOWL | Equivalent to above. | | NAME:howl | + # Equivalent to above. | | labels.color:* | The project has the label `color`. | + # | labels.color:red | The project's label `color` has the value `red`. | | + # labels.color:red labels.size:big | The project's label `color` | : : has the + # value `red` and its : : : label`size` has the value : : : `big`. : | + # lifecycleState:DELETE_REQUESTED | Only show projects that are | : : pending + # deletion. : If no filter is specified, the call will return projects for which + # the user has the `resourcemanager.projects.get` permission. NOTE: To perform a + # by-parent query (eg., what projects are directly in a Folder), the caller must + # have the `resourcemanager.projects.list` permission on the parent and the + # filter must contain both a `parent.type` and a `parent.id` restriction ( + # example: "parent.type:folder parent.id:123"). In this case an alternate search + # index is used which provides more consistent results. Optional. # @param [Fixnum] page_size - # The maximum number of Projects to return in the response. - # The server can return fewer Projects than requested. - # If unspecified, server picks an appropriate default. - # Optional. + # The maximum number of Projects to return in the response. The server can + # return fewer Projects than requested. If unspecified, server picks an + # appropriate default. Optional. # @param [String] page_token - # A pagination token returned from a previous call to ListProjects - # that indicates from where listing should continue. - # Optional. + # A pagination token returned from a previous call to ListProjects that + # indicates from where listing should continue. Optional. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -1277,47 +1236,41 @@ module Google execute_or_queue_command(command, &block) end - # Sets the IAM access control policy for the specified Project. - # CAUTION: This method will replace the existing policy, and cannot be used - # to append additional IAM settings. - # NOTE: Removing service accounts from policies or changing their roles can - # render services completely inoperable. It is important to understand how - # the service account is being used before removing or updating its roles. - # For additional information about `resource` (e.g. my-project-id) structure - # and identification, see [Resource Names](/apis/design/resource_names). - # The following constraints apply when using `setIamPolicy()`: - # + Project does not support `allUsers` and `allAuthenticatedUsers` as - # `members` in a `Binding` of a `Policy`. - # + The owner role can be granted to a `user`, `serviceAccount`, or a group - # that is part of an organization. For example, - # group@myownpersonaldomain.com could be added as an owner to a project in - # the myownpersonaldomain.com organization, but not the examplepetstore.com - # organization. - # + Service accounts can be made owners of a project directly + # Sets the IAM access control policy for the specified Project. CAUTION: This + # method will replace the existing policy, and cannot be used to append + # additional IAM settings. NOTE: Removing service accounts from policies or + # changing their roles can render services completely inoperable. It is + # important to understand how the service account is being used before removing + # or updating its roles. For additional information about `resource` (e.g. my- + # project-id) structure and identification, see [Resource Names](/apis/design/ + # resource_names). The following constraints apply when using `setIamPolicy()`: + + # Project does not support `allUsers` and `allAuthenticatedUsers` as `members` + # in a `Binding` of a `Policy`. + The owner role can be granted to a `user`, ` + # serviceAccount`, or a group that is part of an organization. For example, + # group@myownpersonaldomain.com could be added as an owner to a project in the + # myownpersonaldomain.com organization, but not the examplepetstore.com + # organization. + Service accounts can be made owners of a project directly # without any restrictions. However, to be added as an owner, a user must be - # invited via Cloud Platform console and must accept the invitation. - # + A user cannot be granted the owner role using `setIamPolicy()`. The user - # must be granted the owner role using the Cloud Platform Console and must - # explicitly accept the invitation. - # + You can only grant ownership of a project to a member by using the - # GCP Console. Inviting a member will deliver an invitation email that - # they must accept. An invitation email is not generated if you are - # granting a role other than owner, or if both the member you are inviting - # and the project are part of your organization. - # + Membership changes that leave the project without any owners that have - # accepted the Terms of Service (ToS) will be rejected. - # + If the project is not part of an organization, there must be at least - # one owner who has accepted the Terms of Service (ToS) agreement in the - # policy. Calling `setIamPolicy()` to remove the last ToS-accepted owner - # from the policy will fail. This restriction also applies to legacy - # projects that no longer have owners who have accepted the ToS. Edits to - # IAM policies will be rejected until the lack of a ToS-accepting owner is - # rectified. - # Authorization requires the Google IAM permission - # `resourcemanager.projects.setIamPolicy` on the project + # invited via Cloud Platform console and must accept the invitation. + A user + # cannot be granted the owner role using `setIamPolicy()`. The user must be + # granted the owner role using the Cloud Platform Console and must explicitly + # accept the invitation. + You can only grant ownership of a project to a member + # by using the GCP Console. Inviting a member will deliver an invitation email + # that they must accept. An invitation email is not generated if you are + # granting a role other than owner, or if both the member you are inviting and + # the project are part of your organization. + Membership changes that leave the + # project without any owners that have accepted the Terms of Service (ToS) will + # be rejected. + If the project is not part of an organization, there must be at + # least one owner who has accepted the Terms of Service (ToS) agreement in the + # policy. Calling `setIamPolicy()` to remove the last ToS-accepted owner from + # the policy will fail. This restriction also applies to legacy projects that no + # longer have owners who have accepted the ToS. Edits to IAM policies will be + # rejected until the lack of a ToS-accepting owner is rectified. Authorization + # requires the Google IAM permission `resourcemanager.projects.setIamPolicy` on + # the project # @param [String] resource - # REQUIRED: The resource for which the policy is being specified. - # See the operation documentation for the appropriate value for this field. + # REQUIRED: The resource for which the policy is being specified. See the + # operation documentation for the appropriate value for this field. # @param [Google::Apis::CloudresourcemanagerV1::SetIamPolicyRequest] set_iam_policy_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -1349,9 +1302,9 @@ module Google end # Updates the specified `Policy` on the resource. Creates a new `Policy` for - # that `Constraint` on the resource if one does not exist. - # Not supplying an `etag` on the request `Policy` results in an unconditional - # write of the `Policy`. + # that `Constraint` on the resource if one does not exist. Not supplying an ` + # etag` on the request `Policy` results in an unconditional write of the `Policy` + # . # @param [String] resource # Resource name of the resource to attach the `Policy`. # @param [Google::Apis::CloudresourcemanagerV1::SetOrgPolicyRequest] set_org_policy_request_object @@ -1384,13 +1337,13 @@ module Google execute_or_queue_command(command, &block) end - # Returns permissions that a caller has on the specified Project. - # For additional information about `resource` (e.g. my-project-id) structure - # and identification, see [Resource Names](/apis/design/resource_names). - # There are no permissions required for making this API call. + # Returns permissions that a caller has on the specified Project. For additional + # information about `resource` (e.g. my-project-id) structure and identification, + # see [Resource Names](/apis/design/resource_names). There are no permissions + # required for making this API call. # @param [String] resource - # REQUIRED: The resource for which the policy detail is being requested. - # See the operation documentation for the appropriate value for this field. + # REQUIRED: The resource for which the policy detail is being requested. See the + # operation documentation for the appropriate value for this field. # @param [Google::Apis::CloudresourcemanagerV1::TestIamPermissionsRequest] test_iam_permissions_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -1421,15 +1374,12 @@ module Google execute_or_queue_command(command, &block) end - # Restores the Project identified by the specified - # `project_id` (for example, `my-project-123`). - # You can only use this method for a Project that has a lifecycle state of - # DELETE_REQUESTED. - # After deletion starts, the Project cannot be restored. - # The caller must have modify permissions for this Project. + # Restores the Project identified by the specified `project_id` (for example, ` + # my-project-123`). You can only use this method for a Project that has a + # lifecycle state of DELETE_REQUESTED. After deletion starts, the Project cannot + # be restored. The caller must have modify permissions for this Project. # @param [String] project_id - # The project ID (for example, `foo-bar-123`). - # Required. + # The project ID (for example, `foo-bar-123`). Required. # @param [Google::Apis::CloudresourcemanagerV1::UndeleteProjectRequest] undelete_project_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -1460,12 +1410,11 @@ module Google execute_or_queue_command(command, &block) end - # Updates the attributes of the Project identified by the specified - # `project_id` (for example, `my-project-123`). - # The caller must have modify permissions for this Project. + # Updates the attributes of the Project identified by the specified `project_id` + # (for example, `my-project-123`). The caller must have modify permissions for + # this Project. # @param [String] project_id - # The project ID (for example, `my-project-123`). - # Required. + # The project ID (for example, `my-project-123`). Required. # @param [Google::Apis::CloudresourcemanagerV1::Project] project_object # @param [String] fields # Selector specifying which fields to include in a partial response. diff --git a/generated/google/apis/cloudresourcemanager_v1beta1.rb b/generated/google/apis/cloudresourcemanager_v1beta1.rb index 92476b62a..5ee55e568 100644 --- a/generated/google/apis/cloudresourcemanager_v1beta1.rb +++ b/generated/google/apis/cloudresourcemanager_v1beta1.rb @@ -26,7 +26,7 @@ module Google # @see https://cloud.google.com/resource-manager module CloudresourcemanagerV1beta1 VERSION = 'V1beta1' - REVISION = '20200622' + REVISION = '20200720' # View and manage your data across Google Cloud Platform services AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform' diff --git a/generated/google/apis/cloudresourcemanager_v1beta1/classes.rb b/generated/google/apis/cloudresourcemanager_v1beta1/classes.rb index af63823d9..76fee4d0d 100644 --- a/generated/google/apis/cloudresourcemanager_v1beta1/classes.rb +++ b/generated/google/apis/cloudresourcemanager_v1beta1/classes.rb @@ -28,8 +28,8 @@ module Google # A container to reference an id for any resource type. A `resource` in Google # Cloud Platform is a generic term for something you (a developer) may want to - # interact with through one of our API's. Some examples are an App Engine app, - # a Compute Engine instance, a Cloud SQL database, and so on. + # interact with through one of our API's. Some examples are an App Engine app, a + # Compute Engine instance, a Cloud SQL database, and so on. # Corresponds to the JSON property `resourceId` # @return [Google::Apis::CloudresourcemanagerV1beta1::ResourceId] attr_accessor :resource_id @@ -44,53 +44,21 @@ module Google end end - # Specifies the audit configuration for a service. - # The configuration determines which permission types are logged, and what - # identities, if any, are exempted from logging. - # An AuditConfig must have one or more AuditLogConfigs. - # If there are AuditConfigs for both `allServices` and a specific service, - # the union of the two AuditConfigs is used for that service: the log_types - # specified in each AuditConfig are enabled, and the exempted_members in each - # AuditLogConfig are exempted. - # Example Policy with multiple AuditConfigs: - # ` - # "audit_configs": [ - # ` - # "service": "allServices", - # "audit_log_configs": [ - # ` - # "log_type": "DATA_READ", - # "exempted_members": [ - # "user:jose@example.com" - # ] - # `, - # ` - # "log_type": "DATA_WRITE" - # `, - # ` - # "log_type": "ADMIN_READ" - # ` - # ] - # `, - # ` - # "service": "sampleservice.googleapis.com", - # "audit_log_configs": [ - # ` - # "log_type": "DATA_READ" - # `, - # ` - # "log_type": "DATA_WRITE", - # "exempted_members": [ - # "user:aliya@example.com" - # ] - # ` - # ] - # ` - # ] - # ` - # For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ - # logging. It also exempts jose@example.com from DATA_READ logging, and - # aliya@example.com from DATA_WRITE logging. + # Specifies the audit configuration for a service. The configuration determines + # which permission types are logged, and what identities, if any, are exempted + # from logging. An AuditConfig must have one or more AuditLogConfigs. If there + # are AuditConfigs for both `allServices` and a specific service, the union of + # the two AuditConfigs is used for that service: the log_types specified in each + # AuditConfig are enabled, and the exempted_members in each AuditLogConfig are + # exempted. Example Policy with multiple AuditConfigs: ` "audit_configs": [ ` " + # service": "allServices", "audit_log_configs": [ ` "log_type": "DATA_READ", " + # exempted_members": [ "user:jose@example.com" ] `, ` "log_type": "DATA_WRITE" `, + # ` "log_type": "ADMIN_READ" ` ] `, ` "service": "sampleservice.googleapis.com", + # "audit_log_configs": [ ` "log_type": "DATA_READ" `, ` "log_type": "DATA_WRITE" + # , "exempted_members": [ "user:aliya@example.com" ] ` ] ` ] ` For sampleservice, + # this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also + # exempts jose@example.com from DATA_READ logging, and aliya@example.com from + # DATA_WRITE logging. class AuditConfig include Google::Apis::Core::Hashable @@ -99,9 +67,9 @@ module Google # @return [Array] attr_accessor :audit_log_configs - # Specifies a service that will be enabled for audit logging. - # For example, `storage.googleapis.com`, `cloudsql.googleapis.com`. - # `allServices` is a special value that covers all services. + # Specifies a service that will be enabled for audit logging. For example, ` + # storage.googleapis.com`, `cloudsql.googleapis.com`. `allServices` is a special + # value that covers all services. # Corresponds to the JSON property `service` # @return [String] attr_accessor :service @@ -117,28 +85,15 @@ module Google end end - # Provides the configuration for logging a type of permissions. - # Example: - # ` - # "audit_log_configs": [ - # ` - # "log_type": "DATA_READ", - # "exempted_members": [ - # "user:jose@example.com" - # ] - # `, - # ` - # "log_type": "DATA_WRITE" - # ` - # ] - # ` - # This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting - # jose@example.com from DATA_READ logging. + # Provides the configuration for logging a type of permissions. Example: ` " + # audit_log_configs": [ ` "log_type": "DATA_READ", "exempted_members": [ "user: + # jose@example.com" ] `, ` "log_type": "DATA_WRITE" ` ] ` This enables ' + # DATA_READ' and 'DATA_WRITE' logging, while exempting jose@example.com from + # DATA_READ logging. class AuditLogConfig include Google::Apis::Core::Hashable - # Specifies the identities that do not cause logging for this type of - # permission. + # Specifies the identities that do not cause logging for this type of permission. # Follows the same format of Binding.members. # Corresponds to the JSON property `exemptedMembers` # @return [Array] @@ -164,69 +119,57 @@ module Google class Binding include Google::Apis::Core::Hashable - # Represents a textual expression in the Common Expression Language (CEL) - # syntax. CEL is a C-like expression language. The syntax and semantics of CEL - # are documented at https://github.com/google/cel-spec. - # Example (Comparison): - # title: "Summary size limit" - # description: "Determines if a summary is less than 100 chars" - # expression: "document.summary.size() < 100" - # Example (Equality): - # title: "Requestor is owner" - # description: "Determines if requestor is the document owner" - # expression: "document.owner == request.auth.claims.email" - # Example (Logic): - # title: "Public documents" - # description: "Determine whether the document should be publicly visible" - # expression: "document.type != 'private' && document.type != 'internal'" - # Example (Data Manipulation): - # title: "Notification string" - # description: "Create a notification string with a timestamp." - # expression: "'New message received at ' + string(document.create_time)" - # The exact variables and functions that may be referenced within an expression - # are determined by the service that evaluates it. See the service - # documentation for additional information. + # Represents a textual expression in the Common Expression Language (CEL) syntax. + # CEL is a C-like expression language. The syntax and semantics of CEL are + # documented at https://github.com/google/cel-spec. Example (Comparison): title: + # "Summary size limit" description: "Determines if a summary is less than 100 + # chars" expression: "document.summary.size() < 100" Example (Equality): title: " + # Requestor is owner" description: "Determines if requestor is the document + # owner" expression: "document.owner == request.auth.claims.email" Example ( + # Logic): title: "Public documents" description: "Determine whether the document + # should be publicly visible" expression: "document.type != 'private' && + # document.type != 'internal'" Example (Data Manipulation): title: "Notification + # string" description: "Create a notification string with a timestamp." + # expression: "'New message received at ' + string(document.create_time)" The + # exact variables and functions that may be referenced within an expression are + # determined by the service that evaluates it. See the service documentation for + # additional information. # Corresponds to the JSON property `condition` # @return [Google::Apis::CloudresourcemanagerV1beta1::Expr] attr_accessor :condition - # Specifies the identities requesting access for a Cloud Platform resource. - # `members` can have the following values: - # * `allUsers`: A special identifier that represents anyone who is - # on the internet; with or without a Google account. - # * `allAuthenticatedUsers`: A special identifier that represents anyone - # who is authenticated with a Google account or a service account. - # * `user:`emailid``: An email address that represents a specific Google - # account. For example, `alice@example.com` . - # * `serviceAccount:`emailid``: An email address that represents a service - # account. For example, `my-other-app@appspot.gserviceaccount.com`. - # * `group:`emailid``: An email address that represents a Google group. - # For example, `admins@example.com`. - # * `deleted:user:`emailid`?uid=`uniqueid``: An email address (plus unique - # identifier) representing a user that has been recently deleted. For - # example, `alice@example.com?uid=123456789012345678901`. If the user is - # recovered, this value reverts to `user:`emailid`` and the recovered user - # retains the role in the binding. - # * `deleted:serviceAccount:`emailid`?uid=`uniqueid``: An email address (plus - # unique identifier) representing a service account that has been recently - # deleted. For example, - # `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. - # If the service account is undeleted, this value reverts to - # `serviceAccount:`emailid`` and the undeleted service account retains the - # role in the binding. - # * `deleted:group:`emailid`?uid=`uniqueid``: An email address (plus unique - # identifier) representing a Google group that has been recently - # deleted. For example, `admins@example.com?uid=123456789012345678901`. If - # the group is recovered, this value reverts to `group:`emailid`` and the - # recovered group retains the role in the binding. - # * `domain:`domain``: The G Suite domain (primary) that represents all the - # users of that domain. For example, `google.com` or `example.com`. + # Specifies the identities requesting access for a Cloud Platform resource. ` + # members` can have the following values: * `allUsers`: A special identifier + # that represents anyone who is on the internet; with or without a Google + # account. * `allAuthenticatedUsers`: A special identifier that represents + # anyone who is authenticated with a Google account or a service account. * ` + # user:`emailid``: An email address that represents a specific Google account. + # For example, `alice@example.com` . * `serviceAccount:`emailid``: An email + # address that represents a service account. For example, `my-other-app@appspot. + # gserviceaccount.com`. * `group:`emailid``: An email address that represents a + # Google group. For example, `admins@example.com`. * `deleted:user:`emailid`?uid= + # `uniqueid``: An email address (plus unique identifier) representing a user + # that has been recently deleted. For example, `alice@example.com?uid= + # 123456789012345678901`. If the user is recovered, this value reverts to `user:` + # emailid`` and the recovered user retains the role in the binding. * `deleted: + # serviceAccount:`emailid`?uid=`uniqueid``: An email address (plus unique + # identifier) representing a service account that has been recently deleted. For + # example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. + # If the service account is undeleted, this value reverts to `serviceAccount:` + # emailid`` and the undeleted service account retains the role in the binding. * + # `deleted:group:`emailid`?uid=`uniqueid``: An email address (plus unique + # identifier) representing a Google group that has been recently deleted. For + # example, `admins@example.com?uid=123456789012345678901`. If the group is + # recovered, this value reverts to `group:`emailid`` and the recovered group + # retains the role in the binding. * `domain:`domain``: The G Suite domain ( + # primary) that represents all the users of that domain. For example, `google. + # com` or `example.com`. # Corresponds to the JSON property `members` # @return [Array] attr_accessor :members - # Role that is assigned to `members`. - # For example, `roles/viewer`, `roles/editor`, or `roles/owner`. + # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor` + # , or `roles/owner`. # Corresponds to the JSON property `role` # @return [String] attr_accessor :role @@ -243,13 +186,11 @@ module Google end end - # 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); - # ` - # The JSON representation for `Empty` is empty JSON object ````. + # 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); ` The JSON representation for + # `Empty` is empty JSON object ````. class Empty include Google::Apis::Core::Hashable @@ -262,52 +203,43 @@ module Google end end - # Represents a textual expression in the Common Expression Language (CEL) - # syntax. CEL is a C-like expression language. The syntax and semantics of CEL - # are documented at https://github.com/google/cel-spec. - # Example (Comparison): - # title: "Summary size limit" - # description: "Determines if a summary is less than 100 chars" - # expression: "document.summary.size() < 100" - # Example (Equality): - # title: "Requestor is owner" - # description: "Determines if requestor is the document owner" - # expression: "document.owner == request.auth.claims.email" - # Example (Logic): - # title: "Public documents" - # description: "Determine whether the document should be publicly visible" - # expression: "document.type != 'private' && document.type != 'internal'" - # Example (Data Manipulation): - # title: "Notification string" - # description: "Create a notification string with a timestamp." - # expression: "'New message received at ' + string(document.create_time)" - # The exact variables and functions that may be referenced within an expression - # are determined by the service that evaluates it. See the service - # documentation for additional information. + # Represents a textual expression in the Common Expression Language (CEL) syntax. + # CEL is a C-like expression language. The syntax and semantics of CEL are + # documented at https://github.com/google/cel-spec. Example (Comparison): title: + # "Summary size limit" description: "Determines if a summary is less than 100 + # chars" expression: "document.summary.size() < 100" Example (Equality): title: " + # Requestor is owner" description: "Determines if requestor is the document + # owner" expression: "document.owner == request.auth.claims.email" Example ( + # Logic): title: "Public documents" description: "Determine whether the document + # should be publicly visible" expression: "document.type != 'private' && + # document.type != 'internal'" Example (Data Manipulation): title: "Notification + # string" description: "Create a notification string with a timestamp." + # expression: "'New message received at ' + string(document.create_time)" The + # exact variables and functions that may be referenced within an expression are + # determined by the service that evaluates it. See the service documentation for + # additional information. class Expr include Google::Apis::Core::Hashable - # Optional. Description of the expression. This is a longer text which - # describes the expression, e.g. when hovered over it in a UI. + # Optional. Description of the expression. This is a longer text which describes + # the expression, e.g. when hovered over it in a UI. # Corresponds to the JSON property `description` # @return [String] attr_accessor :description - # Textual representation of an expression in Common Expression Language - # syntax. + # Textual representation of an expression in Common Expression Language syntax. # Corresponds to the JSON property `expression` # @return [String] attr_accessor :expression - # Optional. String indicating the location of the expression for error - # reporting, e.g. a file name and a position in the file. + # Optional. String indicating the location of the expression for error reporting, + # e.g. a file name and a position in the file. # Corresponds to the JSON property `location` # @return [String] attr_accessor :location - # Optional. Title for the expression, i.e. a short string describing - # its purpose. This can be used e.g. in UIs which allow to enter the - # expression. + # Optional. Title for the expression, i.e. a short string describing its purpose. + # This can be used e.g. in UIs which allow to enter the expression. # Corresponds to the JSON property `title` # @return [String] attr_accessor :title @@ -329,8 +261,8 @@ module Google class FolderOperation include Google::Apis::Core::Hashable - # The resource name of the folder or organization we are either creating - # the folder under or moving the folder to. + # The resource name of the folder or organization we are either creating the + # folder under or moving the folder to. # Corresponds to the JSON property `destinationParent` # @return [String] attr_accessor :destination_parent @@ -345,8 +277,8 @@ module Google # @return [String] attr_accessor :operation_type - # The resource name of the folder's parent. - # Only applicable when the operation_type is MOVE. + # The resource name of the folder's parent. Only applicable when the + # operation_type is MOVE. # Corresponds to the JSON property `sourceParent` # @return [String] attr_accessor :source_parent @@ -383,9 +315,8 @@ module Google end end - # The request sent to the - # [google.cloudresourcemanager.projects.v1beta1.DeveloperProjects.GetAncestry] - # method. + # The request sent to the [google.cloudresourcemanager.projects.v1beta1. + # DeveloperProjects.GetAncestry] method. class GetAncestryRequest include Google::Apis::Core::Hashable @@ -398,15 +329,12 @@ module Google end end - # Response from the - # projects.getAncestry - # method. + # Response from the projects.getAncestry method. class GetAncestryResponse include Google::Apis::Core::Hashable - # Ancestors are ordered from bottom to top of the resource hierarchy. The - # first ancestor is the project itself, followed by the project's parent, - # etc. + # Ancestors are ordered from bottom to top of the resource hierarchy. The first + # ancestor is the project itself, followed by the project's parent, etc. # Corresponds to the JSON property `ancestor` # @return [Array] attr_accessor :ancestor @@ -444,15 +372,13 @@ module Google class GetPolicyOptions include Google::Apis::Core::Hashable - # Optional. The policy format version to be returned. - # Valid values are 0, 1, and 3. Requests specifying an invalid value will be - # rejected. - # Requests for policies with any conditional bindings must specify version 3. - # Policies without any conditional bindings may specify any valid value or - # leave the field unset. - # To learn which resources support conditions in their IAM policies, see the - # [IAM - # documentation](https://cloud.google.com/iam/help/conditions/resource-policies). + # Optional. The policy format version to be returned. Valid values are 0, 1, and + # 3. Requests specifying an invalid value will be rejected. Requests for + # policies with any conditional bindings must specify version 3. Policies + # without any conditional bindings may specify any valid value or leave the + # field unset. To learn which resources support conditions in their IAM policies, + # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/ + # resource-policies). # Corresponds to the JSON property `requestedPolicyVersion` # @return [Fixnum] attr_accessor :requested_policy_version @@ -472,10 +398,10 @@ module Google include Google::Apis::Core::Hashable # A pagination token to be used to retrieve the next page of results. If the - # result is too large to fit within the page size specified in the request, - # this field will be set with a token that can be used to fetch the next page - # of results. If this field is empty, it indicates that this response - # contains the last page of results. + # result is too large to fit within the page size specified in the request, this + # field will be set with a token that can be used to fetch the next page of + # results. If this field is empty, it indicates that this response contains the + # last page of results. # Corresponds to the JSON property `nextPageToken` # @return [String] attr_accessor :next_page_token @@ -496,29 +422,23 @@ module Google end end - # A page of the response received from the - # ListProjects - # method. - # A paginated response where more pages are available has - # `next_page_token` set. This token can be used in a subsequent request to - # retrieve the next request page. + # A page of the response received from the ListProjects method. A paginated + # response where more pages are available has `next_page_token` set. This token + # can be used in a subsequent request to retrieve the next request page. class ListProjectsResponse include Google::Apis::Core::Hashable - # Pagination token. - # If the result set is too large to fit in a single response, this token - # is returned. It encodes the position of the current result cursor. + # Pagination token. If the result set is too large to fit in a single response, + # this token is returned. It encodes the position of the current result cursor. # Feeding this value into a new list request with the `page_token` parameter - # gives the next page of the results. - # When `next_page_token` is not filled in, there is no next page and - # the list returned is the last page in the result set. + # gives the next page of the results. When `next_page_token` is not filled in, + # there is no next page and the list returned is the last page in the result set. # Pagination tokens have a limited lifetime. # Corresponds to the JSON property `nextPageToken` # @return [String] attr_accessor :next_page_token - # The list of Projects that matched the list filter. This list can - # be paginated. + # The list of Projects that matched the list filter. This list can be paginated. # Corresponds to the JSON property `projects` # @return [Array] attr_accessor :projects @@ -534,8 +454,8 @@ module Google end end - # The root node in the resource hierarchy to which a particular entity's - # (e.g., company) resources belong. + # The root node in the resource hierarchy to which a particular entity's (e.g., + # company) resources belong. class Organization include Google::Apis::Core::Hashable @@ -544,10 +464,10 @@ module Google # @return [String] attr_accessor :creation_time - # A human-readable string that refers to the Organization in the - # GCP Console UI. This string is set by the server and cannot be - # changed. The string will be set to the primary domain (for example, - # "google.com") of the G Suite customer that owns the organization. + # A human-readable string that refers to the Organization in the GCP Console UI. + # This string is set by the server and cannot be changed. The string will be set + # to the primary domain (for example, "google.com") of the G Suite customer that + # owns the organization. # Corresponds to the JSON property `displayName` # @return [String] attr_accessor :display_name @@ -557,23 +477,22 @@ module Google # @return [String] attr_accessor :lifecycle_state - # Output only. The resource name of the organization. This is the - # organization's relative path in the API. Its format is - # "organizations/[organization_id]". For example, "organizations/1234". + # Output only. The resource name of the organization. This is the organization's + # relative path in the API. Its format is "organizations/[organization_id]". For + # example, "organizations/1234". # Corresponds to the JSON property `name` # @return [String] attr_accessor :name - # An immutable id for the Organization that is assigned on creation. This - # should be omitted when creating a new Organization. - # This field is read-only. + # An immutable id for the Organization that is assigned on creation. This should + # be omitted when creating a new Organization. This field is read-only. # Corresponds to the JSON property `organizationId` # @return [String] attr_accessor :organization_id - # The entity that owns an Organization. The lifetime of the Organization and - # all of its descendants are bound to the `OrganizationOwner`. If the - # `OrganizationOwner` is deleted, the Organization and all its descendants will + # The entity that owns an Organization. The lifetime of the Organization and all + # of its descendants are bound to the `OrganizationOwner`. If the ` + # OrganizationOwner` is deleted, the Organization and all its descendants will # be deleted. # Corresponds to the JSON property `owner` # @return [Google::Apis::CloudresourcemanagerV1beta1::OrganizationOwner] @@ -594,9 +513,9 @@ module Google end end - # The entity that owns an Organization. The lifetime of the Organization and - # all of its descendants are bound to the `OrganizationOwner`. If the - # `OrganizationOwner` is deleted, the Organization and all its descendants will + # The entity that owns an Organization. The lifetime of the Organization and all + # of its descendants are bound to the `OrganizationOwner`. If the ` + # OrganizationOwner` is deleted, the Organization and all its descendants will # be deleted. class OrganizationOwner include Google::Apis::Core::Hashable @@ -617,66 +536,32 @@ module Google end # An Identity and Access Management (IAM) policy, which specifies access - # controls for Google Cloud resources. - # A `Policy` is a collection of `bindings`. A `binding` binds one or more - # `members` to a single `role`. Members can be user accounts, service accounts, - # Google groups, and domains (such as G Suite). A `role` is a named list of - # permissions; each `role` can be an IAM predefined role or a user-created - # custom role. - # For some types of Google Cloud resources, a `binding` can also specify a - # `condition`, which is a logical expression that allows access to a resource - # only if the expression evaluates to `true`. A condition can add constraints - # based on attributes of the request, the resource, or both. To learn which - # resources support conditions in their IAM policies, see the - # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource- - # policies). - # **JSON example:** - # ` - # "bindings": [ - # ` - # "role": "roles/resourcemanager.organizationAdmin", - # "members": [ - # "user:mike@example.com", - # "group:admins@example.com", - # "domain:google.com", - # "serviceAccount:my-project-id@appspot.gserviceaccount.com" - # ] - # `, - # ` - # "role": "roles/resourcemanager.organizationViewer", - # "members": [ - # "user:eve@example.com" - # ], - # "condition": ` - # "title": "expirable access", - # "description": "Does not grant access after Sep 2020", - # "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z') - # ", - # ` - # ` - # ], - # "etag": "BwWWja0YfJA=", - # "version": 3 - # ` - # **YAML example:** - # bindings: - # - members: - # - user:mike@example.com - # - group:admins@example.com - # - domain:google.com - # - serviceAccount:my-project-id@appspot.gserviceaccount.com - # role: roles/resourcemanager.organizationAdmin - # - members: - # - user:eve@example.com - # role: roles/resourcemanager.organizationViewer - # condition: - # title: expirable access - # description: Does not grant access after Sep 2020 - # expression: request.time < timestamp('2020-10-01T00:00:00.000Z') - # - etag: BwWWja0YfJA= - # - version: 3 - # For a description of IAM and its features, see the - # [IAM documentation](https://cloud.google.com/iam/docs/). + # controls for Google Cloud resources. A `Policy` is a collection of `bindings`. + # A `binding` binds one or more `members` to a single `role`. Members can be + # user accounts, service accounts, Google groups, and domains (such as G Suite). + # A `role` is a named list of permissions; each `role` can be an IAM predefined + # role or a user-created custom role. For some types of Google Cloud resources, + # a `binding` can also specify a `condition`, which is a logical expression that + # allows access to a resource only if the expression evaluates to `true`. A + # condition can add constraints based on attributes of the request, the resource, + # or both. To learn which resources support conditions in their IAM policies, + # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/ + # resource-policies). **JSON example:** ` "bindings": [ ` "role": "roles/ + # resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", " + # group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@ + # appspot.gserviceaccount.com" ] `, ` "role": "roles/resourcemanager. + # organizationViewer", "members": [ "user:eve@example.com" ], "condition": ` " + # title": "expirable access", "description": "Does not grant access after Sep + # 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", ` + # ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:** bindings: - + # members: - user:mike@example.com - group:admins@example.com - domain:google. + # com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/ + # resourcemanager.organizationAdmin - members: - user:eve@example.com role: + # roles/resourcemanager.organizationViewer condition: title: expirable access + # description: Does not grant access after Sep 2020 expression: request.time < + # timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: 3 For a + # description of IAM and its features, see the [IAM documentation](https://cloud. + # google.com/iam/docs/). class Policy include Google::Apis::Core::Hashable @@ -685,48 +570,44 @@ module Google # @return [Array] attr_accessor :audit_configs - # Associates a list of `members` to a `role`. Optionally, may specify a - # `condition` that determines how and when the `bindings` are applied. Each - # of the `bindings` must contain at least one member. + # Associates a list of `members` to a `role`. Optionally, may specify a ` + # condition` that determines how and when the `bindings` are applied. Each of + # the `bindings` must contain at least one member. # Corresponds to the JSON property `bindings` # @return [Array] attr_accessor :bindings - # `etag` is used for optimistic concurrency control as a way to help - # prevent simultaneous updates of a policy from overwriting each other. - # It is strongly suggested that systems make use of the `etag` in the - # read-modify-write cycle to perform policy updates in order to avoid race - # conditions: An `etag` is returned in the response to `getIamPolicy`, and - # systems are expected to put that etag in the request to `setIamPolicy` to - # ensure that their change will be applied to the same version of the policy. - # **Important:** If you use IAM Conditions, you must include the `etag` field - # whenever you call `setIamPolicy`. If you omit this field, then IAM allows - # you to overwrite a version `3` policy with a version `1` policy, and all of - # the conditions in the version `3` policy are lost. + # `etag` is used for optimistic concurrency control as a way to help prevent + # simultaneous updates of a policy from overwriting each other. It is strongly + # suggested that systems make use of the `etag` in the read-modify-write cycle + # to perform policy updates in order to avoid race conditions: An `etag` is + # returned in the response to `getIamPolicy`, and systems are expected to put + # that etag in the request to `setIamPolicy` to ensure that their change will be + # applied to the same version of the policy. **Important:** If you use IAM + # Conditions, you must include the `etag` field whenever you call `setIamPolicy`. + # If you omit this field, then IAM allows you to overwrite a version `3` policy + # with a version `1` policy, and all of the conditions in the version `3` policy + # are lost. # Corresponds to the JSON property `etag` # NOTE: Values are automatically base64 encoded/decoded in the client library. # @return [String] attr_accessor :etag - # Specifies the format of the policy. - # Valid values are `0`, `1`, and `3`. Requests that specify an invalid value - # are rejected. - # Any operation that affects conditional role bindings must specify version - # `3`. This requirement applies to the following operations: - # * Getting a policy that includes a conditional role binding - # * Adding a conditional role binding to a policy - # * Changing a conditional role binding in a policy - # * Removing any role binding, with or without a condition, from a policy - # that includes conditions - # **Important:** If you use IAM Conditions, you must include the `etag` field - # whenever you call `setIamPolicy`. If you omit this field, then IAM allows - # you to overwrite a version `3` policy with a version `1` policy, and all of - # the conditions in the version `3` policy are lost. - # If a policy does not include any conditions, operations on that policy may - # specify any valid version or leave the field unset. - # To learn which resources support conditions in their IAM policies, see the - # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource- - # policies). + # Specifies the format of the policy. Valid values are `0`, `1`, and `3`. + # Requests that specify an invalid value are rejected. Any operation that + # affects conditional role bindings must specify version `3`. This requirement + # applies to the following operations: * Getting a policy that includes a + # conditional role binding * Adding a conditional role binding to a policy * + # Changing a conditional role binding in a policy * Removing any role binding, + # with or without a condition, from a policy that includes conditions ** + # Important:** If you use IAM Conditions, you must include the `etag` field + # whenever you call `setIamPolicy`. If you omit this field, then IAM allows you + # to overwrite a version `3` policy with a version `1` policy, and all of the + # conditions in the version `3` policy are lost. If a policy does not include + # any conditions, operations on that policy may specify any valid version or + # leave the field unset. To learn which resources support conditions in their + # IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/ + # conditions/resource-policies). # Corresponds to the JSON property `version` # @return [Fixnum] attr_accessor :version @@ -744,69 +625,56 @@ module Google end end - # A Project is a high-level Google Cloud Platform entity. It is a - # container for ACLs, APIs, App Engine Apps, VMs, and other - # Google Cloud Platform resources. + # A Project is a high-level Google Cloud Platform entity. It is a container for + # ACLs, APIs, App Engine Apps, VMs, and other Google Cloud Platform resources. class Project include Google::Apis::Core::Hashable - # Creation time. - # Read-only. + # Creation time. Read-only. # Corresponds to the JSON property `createTime` # @return [String] attr_accessor :create_time - # The labels associated with this Project. - # Label keys must be between 1 and 63 characters long and must conform - # to the following regular expression: a-z`0,62`. - # Label values must be between 0 and 63 characters long and must conform - # to the regular expression [a-z0-9_-]`0,63`. A label value can be empty. - # No more than 256 labels can be associated with a given resource. - # Clients should store labels in a representation such as JSON that does not - # depend on specific characters being disallowed. - # Example: "environment" : "dev" - # Read-write. + # The labels associated with this Project. Label keys must be between 1 and 63 + # characters long and must conform to the following regular expression: a-z`0,62` + # . Label values must be between 0 and 63 characters long and must conform to + # the regular expression [a-z0-9_-]`0,63`. A label value can be empty. No more + # than 256 labels can be associated with a given resource. Clients should store + # labels in a representation such as JSON that does not depend on specific + # characters being disallowed. Example: "environment" : "dev" Read-write. # Corresponds to the JSON property `labels` # @return [Hash] attr_accessor :labels - # The Project lifecycle state. - # Read-only. + # The Project lifecycle state. Read-only. # Corresponds to the JSON property `lifecycleState` # @return [String] attr_accessor :lifecycle_state - # The optional user-assigned display name of the Project. - # When present it must be between 4 to 30 characters. - # Allowed characters are: lowercase and uppercase letters, numbers, - # hyphen, single-quote, double-quote, space, and exclamation point. - # Example: My Project - # Read-write. + # The optional user-assigned display name of the Project. When present it must + # be between 4 to 30 characters. Allowed characters are: lowercase and uppercase + # letters, numbers, hyphen, single-quote, double-quote, space, and exclamation + # point. Example: My Project Read-write. # Corresponds to the JSON property `name` # @return [String] attr_accessor :name # A container to reference an id for any resource type. A `resource` in Google # Cloud Platform is a generic term for something you (a developer) may want to - # interact with through one of our API's. Some examples are an App Engine app, - # a Compute Engine instance, a Cloud SQL database, and so on. + # interact with through one of our API's. Some examples are an App Engine app, a + # Compute Engine instance, a Cloud SQL database, and so on. # Corresponds to the JSON property `parent` # @return [Google::Apis::CloudresourcemanagerV1beta1::ResourceId] attr_accessor :parent - # The unique, user-assigned ID of the Project. - # It must be 6 to 30 lowercase letters, digits, or hyphens. - # It must start with a letter. - # Trailing hyphens are prohibited. - # Example: tokyo-rain-123 - # Read-only after creation. + # The unique, user-assigned ID of the Project. It must be 6 to 30 lowercase + # letters, digits, or hyphens. It must start with a letter. Trailing hyphens are + # prohibited. Example: tokyo-rain-123 Read-only after creation. # Corresponds to the JSON property `projectId` # @return [String] attr_accessor :project_id - # The number uniquely identifying the project. - # Example: 415104041262 - # Read-only. + # The number uniquely identifying the project. Example: 415104041262 Read-only. # Corresponds to the JSON property `projectNumber` # @return [Fixnum] attr_accessor :project_number @@ -838,9 +706,8 @@ module Google # @return [String] attr_accessor :create_time - # True if the project can be retrieved using GetProject. No other operations - # on the project are guaranteed to work until the project creation is - # complete. + # True if the project can be retrieved using GetProject. No other operations on + # the project are guaranteed to work until the project creation is complete. # Corresponds to the JSON property `gettable` # @return [Boolean] attr_accessor :gettable @@ -866,19 +733,19 @@ module Google # A container to reference an id for any resource type. A `resource` in Google # Cloud Platform is a generic term for something you (a developer) may want to - # interact with through one of our API's. Some examples are an App Engine app, - # a Compute Engine instance, a Cloud SQL database, and so on. + # interact with through one of our API's. Some examples are an App Engine app, a + # Compute Engine instance, a Cloud SQL database, and so on. class ResourceId include Google::Apis::Core::Hashable - # Required field for the type-specific id. This should correspond to the id - # used in the type-specific API's. + # Required field for the type-specific id. This should correspond to the id used + # in the type-specific API's. # Corresponds to the JSON property `id` # @return [String] attr_accessor :id - # Required field representing the resource type this id is for. - # At present, the valid types are "project", "folder", and "organization". + # Required field representing the resource type this id is for. At present, the + # valid types are "project", "folder", and "organization". # Corresponds to the JSON property `type` # @return [String] attr_accessor :type @@ -899,74 +766,39 @@ module Google include Google::Apis::Core::Hashable # An Identity and Access Management (IAM) policy, which specifies access - # controls for Google Cloud resources. - # A `Policy` is a collection of `bindings`. A `binding` binds one or more - # `members` to a single `role`. Members can be user accounts, service accounts, - # Google groups, and domains (such as G Suite). A `role` is a named list of - # permissions; each `role` can be an IAM predefined role or a user-created - # custom role. - # For some types of Google Cloud resources, a `binding` can also specify a - # `condition`, which is a logical expression that allows access to a resource - # only if the expression evaluates to `true`. A condition can add constraints - # based on attributes of the request, the resource, or both. To learn which - # resources support conditions in their IAM policies, see the - # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource- - # policies). - # **JSON example:** - # ` - # "bindings": [ - # ` - # "role": "roles/resourcemanager.organizationAdmin", - # "members": [ - # "user:mike@example.com", - # "group:admins@example.com", - # "domain:google.com", - # "serviceAccount:my-project-id@appspot.gserviceaccount.com" - # ] - # `, - # ` - # "role": "roles/resourcemanager.organizationViewer", - # "members": [ - # "user:eve@example.com" - # ], - # "condition": ` - # "title": "expirable access", - # "description": "Does not grant access after Sep 2020", - # "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z') - # ", - # ` - # ` - # ], - # "etag": "BwWWja0YfJA=", - # "version": 3 - # ` - # **YAML example:** - # bindings: - # - members: - # - user:mike@example.com - # - group:admins@example.com - # - domain:google.com - # - serviceAccount:my-project-id@appspot.gserviceaccount.com - # role: roles/resourcemanager.organizationAdmin - # - members: - # - user:eve@example.com - # role: roles/resourcemanager.organizationViewer - # condition: - # title: expirable access - # description: Does not grant access after Sep 2020 - # expression: request.time < timestamp('2020-10-01T00:00:00.000Z') - # - etag: BwWWja0YfJA= - # - version: 3 - # For a description of IAM and its features, see the - # [IAM documentation](https://cloud.google.com/iam/docs/). + # controls for Google Cloud resources. A `Policy` is a collection of `bindings`. + # A `binding` binds one or more `members` to a single `role`. Members can be + # user accounts, service accounts, Google groups, and domains (such as G Suite). + # A `role` is a named list of permissions; each `role` can be an IAM predefined + # role or a user-created custom role. For some types of Google Cloud resources, + # a `binding` can also specify a `condition`, which is a logical expression that + # allows access to a resource only if the expression evaluates to `true`. A + # condition can add constraints based on attributes of the request, the resource, + # or both. To learn which resources support conditions in their IAM policies, + # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/ + # resource-policies). **JSON example:** ` "bindings": [ ` "role": "roles/ + # resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", " + # group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@ + # appspot.gserviceaccount.com" ] `, ` "role": "roles/resourcemanager. + # organizationViewer", "members": [ "user:eve@example.com" ], "condition": ` " + # title": "expirable access", "description": "Does not grant access after Sep + # 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", ` + # ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:** bindings: - + # members: - user:mike@example.com - group:admins@example.com - domain:google. + # com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/ + # resourcemanager.organizationAdmin - members: - user:eve@example.com role: + # roles/resourcemanager.organizationViewer condition: title: expirable access + # description: Does not grant access after Sep 2020 expression: request.time < + # timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: 3 For a + # description of IAM and its features, see the [IAM documentation](https://cloud. + # google.com/iam/docs/). # Corresponds to the JSON property `policy` # @return [Google::Apis::CloudresourcemanagerV1beta1::Policy] attr_accessor :policy # OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only - # the fields in the mask will be modified. If no mask is provided, the - # following default mask is used: - # `paths: "bindings, etag"` + # the fields in the mask will be modified. If no mask is provided, the following + # default mask is used: `paths: "bindings, etag"` # Corresponds to the JSON property `updateMask` # @return [String] attr_accessor :update_mask @@ -986,10 +818,9 @@ module Google class TestIamPermissionsRequest include Google::Apis::Core::Hashable - # The set of permissions to check for the `resource`. Permissions with - # wildcards (such as '*' or 'storage.*') are not allowed. For more - # information see - # [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions). + # The set of permissions to check for the `resource`. Permissions with wildcards + # (such as '*' or 'storage.*') are not allowed. For more information see [IAM + # Overview](https://cloud.google.com/iam/docs/overview#permissions). # Corresponds to the JSON property `permissions` # @return [Array] attr_accessor :permissions @@ -1008,8 +839,7 @@ module Google class TestIamPermissionsResponse include Google::Apis::Core::Hashable - # A subset of `TestPermissionsRequest.permissions` that the caller is - # allowed. + # A subset of `TestPermissionsRequest.permissions` that the caller is allowed. # Corresponds to the JSON property `permissions` # @return [Array] attr_accessor :permissions @@ -1024,8 +854,7 @@ module Google end end - # The request sent to the UndeleteProject - # method. + # The request sent to the UndeleteProject method. class UndeleteProjectRequest include Google::Apis::Core::Hashable diff --git a/generated/google/apis/cloudresourcemanager_v1beta1/service.rb b/generated/google/apis/cloudresourcemanager_v1beta1/service.rb index fa0a16010..293a65ca4 100644 --- a/generated/google/apis/cloudresourcemanager_v1beta1/service.rb +++ b/generated/google/apis/cloudresourcemanager_v1beta1/service.rb @@ -51,11 +51,11 @@ module Google # Fetches an Organization resource identified by the specified resource name. # @param [String] name # The resource name of the Organization to fetch. This is the organization's - # relative path in the API, formatted as "organizations/[organizationId]". - # For example, "organizations/1234". + # relative path in the API, formatted as "organizations/[organizationId]". For + # example, "organizations/1234". # @param [String] organization_id - # The id of the Organization resource to fetch. - # This field is deprecated and will be removed in v1. Use name instead. + # The id of the Organization resource to fetch. This field is deprecated and + # will be removed in v1. Use name instead. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -84,12 +84,12 @@ module Google execute_or_queue_command(command, &block) end - # Gets the access control policy for an Organization resource. May be empty - # if no such policy or resource exists. The `resource` field should be the + # Gets the access control policy for an Organization resource. May be empty if + # no such policy or resource exists. The `resource` field should be the # organization's resource name, e.g. "organizations/123". # @param [String] resource - # REQUIRED: The resource for which the policy is being requested. - # See the operation documentation for the appropriate value for this field. + # REQUIRED: The resource for which the policy is being requested. See the + # operation documentation for the appropriate value for this field. # @param [Google::Apis::CloudresourcemanagerV1beta1::GetIamPolicyRequest] get_iam_policy_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -120,26 +120,23 @@ module Google execute_or_queue_command(command, &block) end - # Lists Organization resources that are visible to the user and satisfy - # the specified filter. This method returns Organizations in an unspecified - # order. New Organizations do not necessarily appear at the end of the list. + # Lists Organization resources that are visible to the user and satisfy the + # specified filter. This method returns Organizations in an unspecified order. + # New Organizations do not necessarily appear at the end of the list. # @param [String] filter - # An optional query string used to filter the Organizations to return in - # the response. Filter rules are case-insensitive. - # Organizations may be filtered by `owner.directoryCustomerId` or by - # `domain`, where the domain is a G Suite domain, for example: - # * Filter `owner.directorycustomerid:123456789` returns Organization - # resources with `owner.directory_customer_id` equal to `123456789`. - # * Filter `domain:google.com` returns Organization resources corresponding - # to the domain `google.com`. - # This field is optional. + # An optional query string used to filter the Organizations to return in the + # response. Filter rules are case-insensitive. Organizations may be filtered by ` + # owner.directoryCustomerId` or by `domain`, where the domain is a G Suite + # domain, for example: * Filter `owner.directorycustomerid:123456789` returns + # Organization resources with `owner.directory_customer_id` equal to `123456789`. + # * Filter `domain:google.com` returns Organization resources corresponding to + # the domain `google.com`. This field is optional. # @param [Fixnum] page_size - # The maximum number of Organizations to return in the response. - # This field is optional. + # The maximum number of Organizations to return in the response. This field is + # optional. # @param [String] page_token - # A pagination token returned from a previous call to `ListOrganizations` - # that indicates from where listing should continue. - # This field is optional. + # A pagination token returned from a previous call to `ListOrganizations` that + # indicates from where listing should continue. This field is optional. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -173,8 +170,8 @@ module Google # existing policy. The `resource` field should be the organization's resource # name, e.g. "organizations/123". # @param [String] resource - # REQUIRED: The resource for which the policy is being specified. - # See the operation documentation for the appropriate value for this field. + # REQUIRED: The resource for which the policy is being specified. See the + # operation documentation for the appropriate value for this field. # @param [Google::Apis::CloudresourcemanagerV1beta1::SetIamPolicyRequest] set_iam_policy_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -205,12 +202,12 @@ module Google execute_or_queue_command(command, &block) end - # Returns permissions that a caller has on the specified Organization. - # The `resource` field should be the organization's resource name, - # e.g. "organizations/123". + # Returns permissions that a caller has on the specified Organization. The ` + # resource` field should be the organization's resource name, e.g. " + # organizations/123". # @param [String] resource - # REQUIRED: The resource for which the policy detail is being requested. - # See the operation documentation for the appropriate value for this field. + # REQUIRED: The resource for which the policy detail is being requested. See the + # operation documentation for the appropriate value for this field. # @param [Google::Apis::CloudresourcemanagerV1beta1::TestIamPermissionsRequest] test_iam_permissions_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -243,9 +240,9 @@ module Google # Updates an Organization resource identified by the specified resource name. # @param [String] name - # Output only. The resource name of the organization. This is the - # organization's relative path in the API. Its format is - # "organizations/[organization_id]". For example, "organizations/1234". + # Output only. The resource name of the organization. This is the organization's + # relative path in the API. Its format is "organizations/[organization_id]". For + # example, "organizations/1234". # @param [Google::Apis::CloudresourcemanagerV1beta1::Organization] organization_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -276,18 +273,15 @@ module Google execute_or_queue_command(command, &block) end - # Creates a Project resource. - # Initially, the Project resource is owned by its creator exclusively. - # The creator can later grant permission to others to read or update the - # Project. - # Several APIs are activated automatically for the Project, including - # Google Cloud Storage. The parent is identified by a specified - # ResourceId, which must include both an ID and a type, such as - # project, folder, or organization. - # This method does not associate the new project with a billing account. - # You can set or update the billing account associated with a project using - # the [`projects.updateBillingInfo`] - # (/billing/reference/rest/v1/projects/updateBillingInfo) method. + # Creates a Project resource. Initially, the Project resource is owned by its + # creator exclusively. The creator can later grant permission to others to read + # or update the Project. Several APIs are activated automatically for the + # Project, including Google Cloud Storage. The parent is identified by a + # specified ResourceId, which must include both an ID and a type, such as + # project, folder, or organization. This method does not associate the new + # project with a billing account. You can set or update the billing account + # associated with a project using the [`projects.updateBillingInfo`] (/billing/ + # reference/rest/v1/projects/updateBillingInfo) method. # @param [Google::Apis::CloudresourcemanagerV1beta1::Project] project_object # @param [Boolean] use_legacy_stack # A now unused experiment opt-out option. @@ -320,27 +314,18 @@ module Google execute_or_queue_command(command, &block) end - # Marks the Project identified by the specified - # `project_id` (for example, `my-project-123`) for deletion. - # This method will only affect the Project if it has a lifecycle state of - # ACTIVE. - # This method changes the Project's lifecycle state from - # ACTIVE - # to DELETE_REQUESTED. - # The deletion starts at an unspecified time, at which point the project is - # no longer accessible. - # Until the deletion completes, you can check the lifecycle state - # checked by retrieving the Project with GetProject, - # and the Project remains visible to ListProjects. - # However, you cannot update the project. - # After the deletion completes, the Project is not retrievable by - # the GetProject - # and ListProjects - # methods. - # The caller must have modify permissions for this Project. + # Marks the Project identified by the specified `project_id` (for example, `my- + # project-123`) for deletion. This method will only affect the Project if it has + # a lifecycle state of ACTIVE. This method changes the Project's lifecycle state + # from ACTIVE to DELETE_REQUESTED. The deletion starts at an unspecified time, + # at which point the project is no longer accessible. Until the deletion + # completes, you can check the lifecycle state checked by retrieving the Project + # with GetProject, and the Project remains visible to ListProjects. However, you + # cannot update the project. After the deletion completes, the Project is not + # retrievable by the GetProject and ListProjects methods. The caller must have + # modify permissions for this Project. # @param [String] project_id - # The Project ID (for example, `foo-bar-123`). - # Required. + # The Project ID (for example, `foo-bar-123`). Required. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -368,12 +353,10 @@ module Google execute_or_queue_command(command, &block) end - # Retrieves the Project identified by the specified - # `project_id` (for example, `my-project-123`). - # The caller must have read permissions for this Project. + # Retrieves the Project identified by the specified `project_id` (for example, ` + # my-project-123`). The caller must have read permissions for this Project. # @param [String] project_id - # The Project ID (for example, `my-project-123`). - # Required. + # The Project ID (for example, `my-project-123`). Required. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -401,12 +384,11 @@ module Google execute_or_queue_command(command, &block) end - # Gets a list of ancestors in the resource hierarchy for the Project - # identified by the specified `project_id` (for example, `my-project-123`). - # The caller must have read permissions for this Project. + # Gets a list of ancestors in the resource hierarchy for the Project identified + # by the specified `project_id` (for example, `my-project-123`). The caller must + # have read permissions for this Project. # @param [String] project_id - # The Project ID (for example, `my-project-123`). - # Required. + # The Project ID (for example, `my-project-123`). Required. # @param [Google::Apis::CloudresourcemanagerV1beta1::GetAncestryRequest] get_ancestry_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -437,13 +419,13 @@ module Google execute_or_queue_command(command, &block) end - # Returns the IAM access control policy for the specified Project. - # Permission is denied if the policy or the resource does not exist. - # For additional information about resource structure and identification, - # see [Resource Names](/apis/design/resource_names). + # Returns the IAM access control policy for the specified Project. Permission is + # denied if the policy or the resource does not exist. For additional + # information about resource structure and identification, see [Resource Names](/ + # apis/design/resource_names). # @param [String] resource - # REQUIRED: The resource for which the policy is being requested. - # See the operation documentation for the appropriate value for this field. + # REQUIRED: The resource for which the policy is being requested. See the + # operation documentation for the appropriate value for this field. # @param [Google::Apis::CloudresourcemanagerV1beta1::GetIamPolicyRequest] get_iam_policy_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -475,56 +457,42 @@ module Google end # Lists Projects that the caller has the `resourcemanager.projects.get` - # permission on and satisfy the specified filter. - # This method returns Projects in an unspecified order. - # This method is eventually consistent with project mutations; this means - # that a newly created project may not appear in the results or recent - # updates to an existing project may not be reflected in the results. To - # retrieve the latest state of a project, use the - # GetProject method. - # NOTE: If the request filter contains a `parent.type` and `parent.id` and - # the caller has the `resourcemanager.projects.list` permission on the - # parent, the results will be drawn from an alternate index which provides - # more consistent results. In future versions of this API, this List method - # will be split into List and Search to properly capture the behavorial - # difference. + # permission on and satisfy the specified filter. This method returns Projects + # in an unspecified order. This method is eventually consistent with project + # mutations; this means that a newly created project may not appear in the + # results or recent updates to an existing project may not be reflected in the + # results. To retrieve the latest state of a project, use the GetProject method. + # NOTE: If the request filter contains a `parent.type` and `parent.id` and the + # caller has the `resourcemanager.projects.list` permission on the parent, the + # results will be drawn from an alternate index which provides more consistent + # results. In future versions of this API, this List method will be split into + # List and Search to properly capture the behavorial difference. # @param [String] filter - # An expression for filtering the results of the request. Filter rules are - # case insensitive. The fields eligible for filtering are: - # + `name` - # + `id` - # + `labels.` (where *key* is the name of a label) - # + `parent.type` - # + `parent.id` - # Some examples of using labels as filters: - # | Filter | Description | - # |------------------|-----------------------------------------------------| - # | name:how* | The project's name starts with "how". | - # | name:Howl | The project's name is `Howl` or `howl`. | - # | name:HOWL | Equivalent to above. | - # | NAME:howl | Equivalent to above. | - # | labels.color:* | The project has the label `color`. | - # | labels.color:red | The project's label `color` has the value `red`. | - # | labels.color:red labels.size:big |The project's label `color` has - # the value `red` and its label `size` has the value `big`. | - # If no filter is specified, the call will return projects for which the user - # has the `resourcemanager.projects.get` permission. - # NOTE: To perform a by-parent query (eg., what projects are directly in a - # Folder), the caller must have the `resourcemanager.projects.list` - # permission on the parent and the filter must contain both a `parent.type` - # and a `parent.id` restriction - # (example: "parent.type:folder parent.id:123"). In this case an alternate - # search index is used which provides more consistent results. - # Optional. + # An expression for filtering the results of the request. Filter rules are case + # insensitive. The fields eligible for filtering are: + `name` + `id` + `labels.` + # (where *key* is the name of a label) + `parent.type` + `parent.id` Some + # examples of using labels as filters: | Filter | Description | |---------------- + # --|-----------------------------------------------------| | name:how* | The + # project's name starts with "how". | | name:Howl | The project's name is `Howl` + # or `howl`. | | name:HOWL | Equivalent to above. | | NAME:howl | Equivalent to + # above. | | labels.color:* | The project has the label `color`. | | labels. + # color:red | The project's label `color` has the value `red`. | | labels.color: + # red labels.size:big |The project's label `color` has the value `red` and its + # label `size` has the value `big`. | If no filter is specified, the call will + # return projects for which the user has the `resourcemanager.projects.get` + # permission. NOTE: To perform a by-parent query (eg., what projects are + # directly in a Folder), the caller must have the `resourcemanager.projects.list` + # permission on the parent and the filter must contain both a `parent.type` and + # a `parent.id` restriction (example: "parent.type:folder parent.id:123"). In + # this case an alternate search index is used which provides more consistent + # results. Optional. # @param [Fixnum] page_size - # The maximum number of Projects to return in the response. - # The server can return fewer Projects than requested. - # If unspecified, server picks an appropriate default. - # Optional. + # The maximum number of Projects to return in the response. The server can + # return fewer Projects than requested. If unspecified, server picks an + # appropriate default. Optional. # @param [String] page_token - # A pagination token returned from a previous call to ListProjects - # that indicates from where listing should continue. - # Optional. + # A pagination token returned from a previous call to ListProjects that + # indicates from where listing should continue. Optional. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -554,42 +522,36 @@ module Google execute_or_queue_command(command, &block) end - # Sets the IAM access control policy for the specified Project. - # CAUTION: This method will replace the existing policy, and cannot be used - # to append additional IAM settings. - # NOTE: Removing service accounts from policies or changing their roles can - # render services completely inoperable. It is important to understand how - # the service account is being used before removing or updating its roles. - # The following constraints apply when using `setIamPolicy()`: - # + Project does not support `allUsers` and `allAuthenticatedUsers` as - # `members` in a `Binding` of a `Policy`. - # + The owner role can be granted to a `user`, `serviceAccount`, or a group - # that is part of an organization. For example, - # group@myownpersonaldomain.com could be added as an owner to a project in - # the myownpersonaldomain.com organization, but not the examplepetstore.com - # organization. - # + Service accounts can be made owners of a project directly - # without any restrictions. However, to be added as an owner, a user must be - # invited via Cloud Platform console and must accept the invitation. + # Sets the IAM access control policy for the specified Project. CAUTION: This + # method will replace the existing policy, and cannot be used to append + # additional IAM settings. NOTE: Removing service accounts from policies or + # changing their roles can render services completely inoperable. It is + # important to understand how the service account is being used before removing + # or updating its roles. The following constraints apply when using ` + # setIamPolicy()`: + Project does not support `allUsers` and ` + # allAuthenticatedUsers` as `members` in a `Binding` of a `Policy`. + The owner + # role can be granted to a `user`, `serviceAccount`, or a group that is part of + # an organization. For example, group@myownpersonaldomain.com could be added as + # an owner to a project in the myownpersonaldomain.com organization, but not the + # examplepetstore.com organization. + Service accounts can be made owners of a + # project directly without any restrictions. However, to be added as an owner, a + # user must be invited via Cloud Platform console and must accept the invitation. # + A user cannot be granted the owner role using `setIamPolicy()`. The user # must be granted the owner role using the Cloud Platform Console and must - # explicitly accept the invitation. - # + Invitations to grant the owner role cannot be sent using - # `setIamPolicy()`; they must be sent only using the Cloud Platform Console. - # + Membership changes that leave the project without any owners that have - # accepted the Terms of Service (ToS) will be rejected. - # + If the project is not part of an organization, there must be at least - # one owner who has accepted the Terms of Service (ToS) agreement in the - # policy. Calling `setIamPolicy()` to remove the last ToS-accepted owner - # from the policy will fail. This restriction also applies to legacy - # projects that no longer have owners who have accepted the ToS. Edits to - # IAM policies will be rejected until the lack of a ToS-accepting owner is - # rectified. - # Authorization requires the Google IAM permission - # `resourcemanager.projects.setIamPolicy` on the project + # explicitly accept the invitation. + Invitations to grant the owner role cannot + # be sent using `setIamPolicy()`; they must be sent only using the Cloud + # Platform Console. + Membership changes that leave the project without any + # owners that have accepted the Terms of Service (ToS) will be rejected. + If + # the project is not part of an organization, there must be at least one owner + # who has accepted the Terms of Service (ToS) agreement in the policy. Calling ` + # setIamPolicy()` to remove the last ToS-accepted owner from the policy will + # fail. This restriction also applies to legacy projects that no longer have + # owners who have accepted the ToS. Edits to IAM policies will be rejected until + # the lack of a ToS-accepting owner is rectified. Authorization requires the + # Google IAM permission `resourcemanager.projects.setIamPolicy` on the project # @param [String] resource - # REQUIRED: The resource for which the policy is being specified. - # See the operation documentation for the appropriate value for this field. + # REQUIRED: The resource for which the policy is being specified. See the + # operation documentation for the appropriate value for this field. # @param [Google::Apis::CloudresourcemanagerV1beta1::SetIamPolicyRequest] set_iam_policy_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -622,8 +584,8 @@ module Google # Returns permissions that a caller has on the specified Project. # @param [String] resource - # REQUIRED: The resource for which the policy detail is being requested. - # See the operation documentation for the appropriate value for this field. + # REQUIRED: The resource for which the policy detail is being requested. See the + # operation documentation for the appropriate value for this field. # @param [Google::Apis::CloudresourcemanagerV1beta1::TestIamPermissionsRequest] test_iam_permissions_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -654,15 +616,12 @@ module Google execute_or_queue_command(command, &block) end - # Restores the Project identified by the specified - # `project_id` (for example, `my-project-123`). - # You can only use this method for a Project that has a lifecycle state of - # DELETE_REQUESTED. - # After deletion starts, the Project cannot be restored. - # The caller must have modify permissions for this Project. + # Restores the Project identified by the specified `project_id` (for example, ` + # my-project-123`). You can only use this method for a Project that has a + # lifecycle state of DELETE_REQUESTED. After deletion starts, the Project cannot + # be restored. The caller must have modify permissions for this Project. # @param [String] project_id - # The project ID (for example, `foo-bar-123`). - # Required. + # The project ID (for example, `foo-bar-123`). Required. # @param [Google::Apis::CloudresourcemanagerV1beta1::UndeleteProjectRequest] undelete_project_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -693,12 +652,11 @@ module Google execute_or_queue_command(command, &block) end - # Updates the attributes of the Project identified by the specified - # `project_id` (for example, `my-project-123`). - # The caller must have modify permissions for this Project. + # Updates the attributes of the Project identified by the specified `project_id` + # (for example, `my-project-123`). The caller must have modify permissions for + # this Project. # @param [String] project_id - # The project ID (for example, `my-project-123`). - # Required. + # The project ID (for example, `my-project-123`). Required. # @param [Google::Apis::CloudresourcemanagerV1beta1::Project] project_object # @param [String] fields # Selector specifying which fields to include in a partial response. diff --git a/generated/google/apis/cloudresourcemanager_v2.rb b/generated/google/apis/cloudresourcemanager_v2.rb index 0d9fd0a91..a6b23e049 100644 --- a/generated/google/apis/cloudresourcemanager_v2.rb +++ b/generated/google/apis/cloudresourcemanager_v2.rb @@ -26,7 +26,7 @@ module Google # @see https://cloud.google.com/resource-manager module CloudresourcemanagerV2 VERSION = 'V2' - REVISION = '20200617' + REVISION = '20200720' # View and manage your data across Google Cloud Platform services AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform' diff --git a/generated/google/apis/cloudresourcemanager_v2/classes.rb b/generated/google/apis/cloudresourcemanager_v2/classes.rb index 146656e09..1c1d458f8 100644 --- a/generated/google/apis/cloudresourcemanager_v2/classes.rb +++ b/generated/google/apis/cloudresourcemanager_v2/classes.rb @@ -22,53 +22,21 @@ module Google module Apis module CloudresourcemanagerV2 - # Specifies the audit configuration for a service. - # The configuration determines which permission types are logged, and what - # identities, if any, are exempted from logging. - # An AuditConfig must have one or more AuditLogConfigs. - # If there are AuditConfigs for both `allServices` and a specific service, - # the union of the two AuditConfigs is used for that service: the log_types - # specified in each AuditConfig are enabled, and the exempted_members in each - # AuditLogConfig are exempted. - # Example Policy with multiple AuditConfigs: - # ` - # "audit_configs": [ - # ` - # "service": "allServices", - # "audit_log_configs": [ - # ` - # "log_type": "DATA_READ", - # "exempted_members": [ - # "user:jose@example.com" - # ] - # `, - # ` - # "log_type": "DATA_WRITE" - # `, - # ` - # "log_type": "ADMIN_READ" - # ` - # ] - # `, - # ` - # "service": "sampleservice.googleapis.com", - # "audit_log_configs": [ - # ` - # "log_type": "DATA_READ" - # `, - # ` - # "log_type": "DATA_WRITE", - # "exempted_members": [ - # "user:aliya@example.com" - # ] - # ` - # ] - # ` - # ] - # ` - # For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ - # logging. It also exempts jose@example.com from DATA_READ logging, and - # aliya@example.com from DATA_WRITE logging. + # Specifies the audit configuration for a service. The configuration determines + # which permission types are logged, and what identities, if any, are exempted + # from logging. An AuditConfig must have one or more AuditLogConfigs. If there + # are AuditConfigs for both `allServices` and a specific service, the union of + # the two AuditConfigs is used for that service: the log_types specified in each + # AuditConfig are enabled, and the exempted_members in each AuditLogConfig are + # exempted. Example Policy with multiple AuditConfigs: ` "audit_configs": [ ` " + # service": "allServices", "audit_log_configs": [ ` "log_type": "DATA_READ", " + # exempted_members": [ "user:jose@example.com" ] `, ` "log_type": "DATA_WRITE" `, + # ` "log_type": "ADMIN_READ" ` ] `, ` "service": "sampleservice.googleapis.com", + # "audit_log_configs": [ ` "log_type": "DATA_READ" `, ` "log_type": "DATA_WRITE" + # , "exempted_members": [ "user:aliya@example.com" ] ` ] ` ] ` For sampleservice, + # this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also + # exempts jose@example.com from DATA_READ logging, and aliya@example.com from + # DATA_WRITE logging. class AuditConfig include Google::Apis::Core::Hashable @@ -77,9 +45,9 @@ module Google # @return [Array] attr_accessor :audit_log_configs - # Specifies a service that will be enabled for audit logging. - # For example, `storage.googleapis.com`, `cloudsql.googleapis.com`. - # `allServices` is a special value that covers all services. + # Specifies a service that will be enabled for audit logging. For example, ` + # storage.googleapis.com`, `cloudsql.googleapis.com`. `allServices` is a special + # value that covers all services. # Corresponds to the JSON property `service` # @return [String] attr_accessor :service @@ -95,28 +63,15 @@ module Google end end - # Provides the configuration for logging a type of permissions. - # Example: - # ` - # "audit_log_configs": [ - # ` - # "log_type": "DATA_READ", - # "exempted_members": [ - # "user:jose@example.com" - # ] - # `, - # ` - # "log_type": "DATA_WRITE" - # ` - # ] - # ` - # This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting - # jose@example.com from DATA_READ logging. + # Provides the configuration for logging a type of permissions. Example: ` " + # audit_log_configs": [ ` "log_type": "DATA_READ", "exempted_members": [ "user: + # jose@example.com" ] `, ` "log_type": "DATA_WRITE" ` ] ` This enables ' + # DATA_READ' and 'DATA_WRITE' logging, while exempting jose@example.com from + # DATA_READ logging. class AuditLogConfig include Google::Apis::Core::Hashable - # Specifies the identities that do not cause logging for this type of - # permission. + # Specifies the identities that do not cause logging for this type of permission. # Follows the same format of Binding.members. # Corresponds to the JSON property `exemptedMembers` # @return [Array] @@ -142,69 +97,57 @@ module Google class Binding include Google::Apis::Core::Hashable - # Represents a textual expression in the Common Expression Language (CEL) - # syntax. CEL is a C-like expression language. The syntax and semantics of CEL - # are documented at https://github.com/google/cel-spec. - # Example (Comparison): - # title: "Summary size limit" - # description: "Determines if a summary is less than 100 chars" - # expression: "document.summary.size() < 100" - # Example (Equality): - # title: "Requestor is owner" - # description: "Determines if requestor is the document owner" - # expression: "document.owner == request.auth.claims.email" - # Example (Logic): - # title: "Public documents" - # description: "Determine whether the document should be publicly visible" - # expression: "document.type != 'private' && document.type != 'internal'" - # Example (Data Manipulation): - # title: "Notification string" - # description: "Create a notification string with a timestamp." - # expression: "'New message received at ' + string(document.create_time)" - # The exact variables and functions that may be referenced within an expression - # are determined by the service that evaluates it. See the service - # documentation for additional information. + # Represents a textual expression in the Common Expression Language (CEL) syntax. + # CEL is a C-like expression language. The syntax and semantics of CEL are + # documented at https://github.com/google/cel-spec. Example (Comparison): title: + # "Summary size limit" description: "Determines if a summary is less than 100 + # chars" expression: "document.summary.size() < 100" Example (Equality): title: " + # Requestor is owner" description: "Determines if requestor is the document + # owner" expression: "document.owner == request.auth.claims.email" Example ( + # Logic): title: "Public documents" description: "Determine whether the document + # should be publicly visible" expression: "document.type != 'private' && + # document.type != 'internal'" Example (Data Manipulation): title: "Notification + # string" description: "Create a notification string with a timestamp." + # expression: "'New message received at ' + string(document.create_time)" The + # exact variables and functions that may be referenced within an expression are + # determined by the service that evaluates it. See the service documentation for + # additional information. # Corresponds to the JSON property `condition` # @return [Google::Apis::CloudresourcemanagerV2::Expr] attr_accessor :condition - # Specifies the identities requesting access for a Cloud Platform resource. - # `members` can have the following values: - # * `allUsers`: A special identifier that represents anyone who is - # on the internet; with or without a Google account. - # * `allAuthenticatedUsers`: A special identifier that represents anyone - # who is authenticated with a Google account or a service account. - # * `user:`emailid``: An email address that represents a specific Google - # account. For example, `alice@example.com` . - # * `serviceAccount:`emailid``: An email address that represents a service - # account. For example, `my-other-app@appspot.gserviceaccount.com`. - # * `group:`emailid``: An email address that represents a Google group. - # For example, `admins@example.com`. - # * `deleted:user:`emailid`?uid=`uniqueid``: An email address (plus unique - # identifier) representing a user that has been recently deleted. For - # example, `alice@example.com?uid=123456789012345678901`. If the user is - # recovered, this value reverts to `user:`emailid`` and the recovered user - # retains the role in the binding. - # * `deleted:serviceAccount:`emailid`?uid=`uniqueid``: An email address (plus - # unique identifier) representing a service account that has been recently - # deleted. For example, - # `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. - # If the service account is undeleted, this value reverts to - # `serviceAccount:`emailid`` and the undeleted service account retains the - # role in the binding. - # * `deleted:group:`emailid`?uid=`uniqueid``: An email address (plus unique - # identifier) representing a Google group that has been recently - # deleted. For example, `admins@example.com?uid=123456789012345678901`. If - # the group is recovered, this value reverts to `group:`emailid`` and the - # recovered group retains the role in the binding. - # * `domain:`domain``: The G Suite domain (primary) that represents all the - # users of that domain. For example, `google.com` or `example.com`. + # Specifies the identities requesting access for a Cloud Platform resource. ` + # members` can have the following values: * `allUsers`: A special identifier + # that represents anyone who is on the internet; with or without a Google + # account. * `allAuthenticatedUsers`: A special identifier that represents + # anyone who is authenticated with a Google account or a service account. * ` + # user:`emailid``: An email address that represents a specific Google account. + # For example, `alice@example.com` . * `serviceAccount:`emailid``: An email + # address that represents a service account. For example, `my-other-app@appspot. + # gserviceaccount.com`. * `group:`emailid``: An email address that represents a + # Google group. For example, `admins@example.com`. * `deleted:user:`emailid`?uid= + # `uniqueid``: An email address (plus unique identifier) representing a user + # that has been recently deleted. For example, `alice@example.com?uid= + # 123456789012345678901`. If the user is recovered, this value reverts to `user:` + # emailid`` and the recovered user retains the role in the binding. * `deleted: + # serviceAccount:`emailid`?uid=`uniqueid``: An email address (plus unique + # identifier) representing a service account that has been recently deleted. For + # example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. + # If the service account is undeleted, this value reverts to `serviceAccount:` + # emailid`` and the undeleted service account retains the role in the binding. * + # `deleted:group:`emailid`?uid=`uniqueid``: An email address (plus unique + # identifier) representing a Google group that has been recently deleted. For + # example, `admins@example.com?uid=123456789012345678901`. If the group is + # recovered, this value reverts to `group:`emailid`` and the recovered group + # retains the role in the binding. * `domain:`domain``: The G Suite domain ( + # primary) that represents all the users of that domain. For example, `google. + # com` or `example.com`. # Corresponds to the JSON property `members` # @return [Array] attr_accessor :members - # Role that is assigned to `members`. - # For example, `roles/viewer`, `roles/editor`, or `roles/owner`. + # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor` + # , or `roles/owner`. # Corresponds to the JSON property `role` # @return [String] attr_accessor :role @@ -221,52 +164,43 @@ module Google end end - # Represents a textual expression in the Common Expression Language (CEL) - # syntax. CEL is a C-like expression language. The syntax and semantics of CEL - # are documented at https://github.com/google/cel-spec. - # Example (Comparison): - # title: "Summary size limit" - # description: "Determines if a summary is less than 100 chars" - # expression: "document.summary.size() < 100" - # Example (Equality): - # title: "Requestor is owner" - # description: "Determines if requestor is the document owner" - # expression: "document.owner == request.auth.claims.email" - # Example (Logic): - # title: "Public documents" - # description: "Determine whether the document should be publicly visible" - # expression: "document.type != 'private' && document.type != 'internal'" - # Example (Data Manipulation): - # title: "Notification string" - # description: "Create a notification string with a timestamp." - # expression: "'New message received at ' + string(document.create_time)" - # The exact variables and functions that may be referenced within an expression - # are determined by the service that evaluates it. See the service - # documentation for additional information. + # Represents a textual expression in the Common Expression Language (CEL) syntax. + # CEL is a C-like expression language. The syntax and semantics of CEL are + # documented at https://github.com/google/cel-spec. Example (Comparison): title: + # "Summary size limit" description: "Determines if a summary is less than 100 + # chars" expression: "document.summary.size() < 100" Example (Equality): title: " + # Requestor is owner" description: "Determines if requestor is the document + # owner" expression: "document.owner == request.auth.claims.email" Example ( + # Logic): title: "Public documents" description: "Determine whether the document + # should be publicly visible" expression: "document.type != 'private' && + # document.type != 'internal'" Example (Data Manipulation): title: "Notification + # string" description: "Create a notification string with a timestamp." + # expression: "'New message received at ' + string(document.create_time)" The + # exact variables and functions that may be referenced within an expression are + # determined by the service that evaluates it. See the service documentation for + # additional information. class Expr include Google::Apis::Core::Hashable - # Optional. Description of the expression. This is a longer text which - # describes the expression, e.g. when hovered over it in a UI. + # Optional. Description of the expression. This is a longer text which describes + # the expression, e.g. when hovered over it in a UI. # Corresponds to the JSON property `description` # @return [String] attr_accessor :description - # Textual representation of an expression in Common Expression Language - # syntax. + # Textual representation of an expression in Common Expression Language syntax. # Corresponds to the JSON property `expression` # @return [String] attr_accessor :expression - # Optional. String indicating the location of the expression for error - # reporting, e.g. a file name and a position in the file. + # Optional. String indicating the location of the expression for error reporting, + # e.g. a file name and a position in the file. # Corresponds to the JSON property `location` # @return [String] attr_accessor :location - # Optional. Title for the expression, i.e. a short string describing - # its purpose. This can be used e.g. in UIs which allow to enter the - # expression. + # Optional. Title for the expression, i.e. a short string describing its purpose. + # This can be used e.g. in UIs which allow to enter the expression. # Corresponds to the JSON property `title` # @return [String] attr_accessor :title @@ -284,8 +218,8 @@ module Google end end - # A Folder in an Organization's resource hierarchy, used to - # organize that Organization's resources. + # A Folder in an Organization's resource hierarchy, used to organize that + # Organization's resources. class Folder include Google::Apis::Core::Hashable @@ -294,34 +228,30 @@ module Google # @return [String] attr_accessor :create_time - # The folder’s display name. - # A folder’s display name must be unique amongst its siblings, e.g. - # no two folders with the same parent can share the same display name. - # The display name must start and end with a letter or digit, may contain - # letters, digits, spaces, hyphens and underscores and can be no longer - # than 30 characters. This is captured by the regular expression: - # [\p`L`\p`N`]([\p`L`\p`N`_- ]`0,28`[\p`L`\p`N`])?. + # The folder’s display name. A folder’s display name must be unique amongst its + # siblings, e.g. no two folders with the same parent can share the same display + # name. The display name must start and end with a letter or digit, may contain + # letters, digits, spaces, hyphens and underscores and can be no longer than 30 + # characters. This is captured by the regular expression: [\p`L`\p`N`]([\p`L`\p` + # N`_- ]`0,28`[\p`L`\p`N`])?. # Corresponds to the JSON property `displayName` # @return [String] attr_accessor :display_name - # Output only. The lifecycle state of the folder. - # Updates to the lifecycle_state must be performed via - # DeleteFolder and - # UndeleteFolder. + # Output only. The lifecycle state of the folder. Updates to the lifecycle_state + # must be performed via DeleteFolder and UndeleteFolder. # Corresponds to the JSON property `lifecycleState` # @return [String] attr_accessor :lifecycle_state - # Output only. The resource name of the Folder. - # Its format is `folders/`folder_id``, for example: "folders/1234". + # Output only. The resource name of the Folder. Its format is `folders/` + # folder_id``, for example: "folders/1234". # Corresponds to the JSON property `name` # @return [String] attr_accessor :name - # Required. The Folder’s parent's resource name. - # Updates to the folder's parent must be performed via - # MoveFolder. + # Required. The Folder’s parent's resource name. Updates to the folder's parent + # must be performed via MoveFolder. # Corresponds to the JSON property `parent` # @return [String] attr_accessor :parent @@ -344,8 +274,8 @@ module Google class FolderOperation include Google::Apis::Core::Hashable - # The resource name of the folder or organization we are either creating - # the folder under or moving the folder to. + # The resource name of the folder or organization we are either creating the + # folder under or moving the folder to. # Corresponds to the JSON property `destinationParent` # @return [String] attr_accessor :destination_parent @@ -360,8 +290,8 @@ module Google # @return [String] attr_accessor :operation_type - # The resource name of the folder's parent. - # Only applicable when the operation_type is MOVE. + # The resource name of the folder's parent. Only applicable when the + # operation_type is MOVE. # Corresponds to the JSON property `sourceParent` # @return [String] attr_accessor :source_parent @@ -421,15 +351,13 @@ module Google class GetPolicyOptions include Google::Apis::Core::Hashable - # Optional. The policy format version to be returned. - # Valid values are 0, 1, and 3. Requests specifying an invalid value will be - # rejected. - # Requests for policies with any conditional bindings must specify version 3. - # Policies without any conditional bindings may specify any valid value or - # leave the field unset. - # To learn which resources support conditions in their IAM policies, see the - # [IAM - # documentation](https://cloud.google.com/iam/help/conditions/resource-policies). + # Optional. The policy format version to be returned. Valid values are 0, 1, and + # 3. Requests specifying an invalid value will be rejected. Requests for + # policies with any conditional bindings must specify version 3. Policies + # without any conditional bindings may specify any valid value or leave the + # field unset. To learn which resources support conditions in their IAM policies, + # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/ + # resource-policies). # Corresponds to the JSON property `requestedPolicyVersion` # @return [Fixnum] attr_accessor :requested_policy_version @@ -448,14 +376,14 @@ module Google class ListFoldersResponse include Google::Apis::Core::Hashable - # A possibly paginated list of Folders that are direct descendants of - # the specified parent resource. + # A possibly paginated list of Folders that are direct descendants of the + # specified parent resource. # Corresponds to the JSON property `folders` # @return [Array] attr_accessor :folders - # A pagination token returned from a previous call to `ListFolders` - # that indicates from where listing should continue. + # A pagination token returned from a previous call to `ListFolders` that + # indicates from where listing should continue. # Corresponds to the JSON property `nextPageToken` # @return [String] attr_accessor :next_page_token @@ -475,9 +403,9 @@ module Google class MoveFolderRequest include Google::Apis::Core::Hashable - # Required. The resource name of the Folder or Organization to reparent - # the folder under. - # Must be of the form `folders/`folder_id`` or `organizations/`org_id``. + # Required. The resource name of the Folder or Organization to reparent the + # folder under. Must be of the form `folders/`folder_id`` or `organizations/` + # org_id``. # Corresponds to the JSON property `destinationParent` # @return [String] attr_accessor :destination_parent @@ -497,47 +425,45 @@ module Google class Operation include Google::Apis::Core::Hashable - # 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. + # 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. # Corresponds to the JSON property `done` # @return [Boolean] attr_accessor :done alias_method :done?, :done - # 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). + # 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). # Corresponds to the JSON property `error` # @return [Google::Apis::CloudresourcemanagerV2::Status] attr_accessor :error - # 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. + # 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. # Corresponds to the JSON property `metadata` # @return [Hash] attr_accessor :metadata # 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``. + # originally returns it. If you use the default HTTP mapping, the `name` should + # be a resource name ending with `operations/`unique_id``. # Corresponds to the JSON property `name` # @return [String] attr_accessor :name - # The normal response of the operation in case of success. 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`. + # The normal response of the operation in case of success. 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`. # Corresponds to the JSON property `response` # @return [Hash] attr_accessor :response @@ -557,66 +483,32 @@ module Google end # An Identity and Access Management (IAM) policy, which specifies access - # controls for Google Cloud resources. - # A `Policy` is a collection of `bindings`. A `binding` binds one or more - # `members` to a single `role`. Members can be user accounts, service accounts, - # Google groups, and domains (such as G Suite). A `role` is a named list of - # permissions; each `role` can be an IAM predefined role or a user-created - # custom role. - # For some types of Google Cloud resources, a `binding` can also specify a - # `condition`, which is a logical expression that allows access to a resource - # only if the expression evaluates to `true`. A condition can add constraints - # based on attributes of the request, the resource, or both. To learn which - # resources support conditions in their IAM policies, see the - # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource- - # policies). - # **JSON example:** - # ` - # "bindings": [ - # ` - # "role": "roles/resourcemanager.organizationAdmin", - # "members": [ - # "user:mike@example.com", - # "group:admins@example.com", - # "domain:google.com", - # "serviceAccount:my-project-id@appspot.gserviceaccount.com" - # ] - # `, - # ` - # "role": "roles/resourcemanager.organizationViewer", - # "members": [ - # "user:eve@example.com" - # ], - # "condition": ` - # "title": "expirable access", - # "description": "Does not grant access after Sep 2020", - # "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z') - # ", - # ` - # ` - # ], - # "etag": "BwWWja0YfJA=", - # "version": 3 - # ` - # **YAML example:** - # bindings: - # - members: - # - user:mike@example.com - # - group:admins@example.com - # - domain:google.com - # - serviceAccount:my-project-id@appspot.gserviceaccount.com - # role: roles/resourcemanager.organizationAdmin - # - members: - # - user:eve@example.com - # role: roles/resourcemanager.organizationViewer - # condition: - # title: expirable access - # description: Does not grant access after Sep 2020 - # expression: request.time < timestamp('2020-10-01T00:00:00.000Z') - # - etag: BwWWja0YfJA= - # - version: 3 - # For a description of IAM and its features, see the - # [IAM documentation](https://cloud.google.com/iam/docs/). + # controls for Google Cloud resources. A `Policy` is a collection of `bindings`. + # A `binding` binds one or more `members` to a single `role`. Members can be + # user accounts, service accounts, Google groups, and domains (such as G Suite). + # A `role` is a named list of permissions; each `role` can be an IAM predefined + # role or a user-created custom role. For some types of Google Cloud resources, + # a `binding` can also specify a `condition`, which is a logical expression that + # allows access to a resource only if the expression evaluates to `true`. A + # condition can add constraints based on attributes of the request, the resource, + # or both. To learn which resources support conditions in their IAM policies, + # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/ + # resource-policies). **JSON example:** ` "bindings": [ ` "role": "roles/ + # resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", " + # group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@ + # appspot.gserviceaccount.com" ] `, ` "role": "roles/resourcemanager. + # organizationViewer", "members": [ "user:eve@example.com" ], "condition": ` " + # title": "expirable access", "description": "Does not grant access after Sep + # 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", ` + # ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:** bindings: - + # members: - user:mike@example.com - group:admins@example.com - domain:google. + # com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/ + # resourcemanager.organizationAdmin - members: - user:eve@example.com role: + # roles/resourcemanager.organizationViewer condition: title: expirable access + # description: Does not grant access after Sep 2020 expression: request.time < + # timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: 3 For a + # description of IAM and its features, see the [IAM documentation](https://cloud. + # google.com/iam/docs/). class Policy include Google::Apis::Core::Hashable @@ -625,48 +517,44 @@ module Google # @return [Array] attr_accessor :audit_configs - # Associates a list of `members` to a `role`. Optionally, may specify a - # `condition` that determines how and when the `bindings` are applied. Each - # of the `bindings` must contain at least one member. + # Associates a list of `members` to a `role`. Optionally, may specify a ` + # condition` that determines how and when the `bindings` are applied. Each of + # the `bindings` must contain at least one member. # Corresponds to the JSON property `bindings` # @return [Array] attr_accessor :bindings - # `etag` is used for optimistic concurrency control as a way to help - # prevent simultaneous updates of a policy from overwriting each other. - # It is strongly suggested that systems make use of the `etag` in the - # read-modify-write cycle to perform policy updates in order to avoid race - # conditions: An `etag` is returned in the response to `getIamPolicy`, and - # systems are expected to put that etag in the request to `setIamPolicy` to - # ensure that their change will be applied to the same version of the policy. - # **Important:** If you use IAM Conditions, you must include the `etag` field - # whenever you call `setIamPolicy`. If you omit this field, then IAM allows - # you to overwrite a version `3` policy with a version `1` policy, and all of - # the conditions in the version `3` policy are lost. + # `etag` is used for optimistic concurrency control as a way to help prevent + # simultaneous updates of a policy from overwriting each other. It is strongly + # suggested that systems make use of the `etag` in the read-modify-write cycle + # to perform policy updates in order to avoid race conditions: An `etag` is + # returned in the response to `getIamPolicy`, and systems are expected to put + # that etag in the request to `setIamPolicy` to ensure that their change will be + # applied to the same version of the policy. **Important:** If you use IAM + # Conditions, you must include the `etag` field whenever you call `setIamPolicy`. + # If you omit this field, then IAM allows you to overwrite a version `3` policy + # with a version `1` policy, and all of the conditions in the version `3` policy + # are lost. # Corresponds to the JSON property `etag` # NOTE: Values are automatically base64 encoded/decoded in the client library. # @return [String] attr_accessor :etag - # Specifies the format of the policy. - # Valid values are `0`, `1`, and `3`. Requests that specify an invalid value - # are rejected. - # Any operation that affects conditional role bindings must specify version - # `3`. This requirement applies to the following operations: - # * Getting a policy that includes a conditional role binding - # * Adding a conditional role binding to a policy - # * Changing a conditional role binding in a policy - # * Removing any role binding, with or without a condition, from a policy - # that includes conditions - # **Important:** If you use IAM Conditions, you must include the `etag` field - # whenever you call `setIamPolicy`. If you omit this field, then IAM allows - # you to overwrite a version `3` policy with a version `1` policy, and all of - # the conditions in the version `3` policy are lost. - # If a policy does not include any conditions, operations on that policy may - # specify any valid version or leave the field unset. - # To learn which resources support conditions in their IAM policies, see the - # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource- - # policies). + # Specifies the format of the policy. Valid values are `0`, `1`, and `3`. + # Requests that specify an invalid value are rejected. Any operation that + # affects conditional role bindings must specify version `3`. This requirement + # applies to the following operations: * Getting a policy that includes a + # conditional role binding * Adding a conditional role binding to a policy * + # Changing a conditional role binding in a policy * Removing any role binding, + # with or without a condition, from a policy that includes conditions ** + # Important:** If you use IAM Conditions, you must include the `etag` field + # whenever you call `setIamPolicy`. If you omit this field, then IAM allows you + # to overwrite a version `3` policy with a version `1` policy, and all of the + # conditions in the version `3` policy are lost. If a policy does not include + # any conditions, operations on that policy may specify any valid version or + # leave the field unset. To learn which resources support conditions in their + # IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/ + # conditions/resource-policies). # Corresponds to the JSON property `version` # @return [Fixnum] attr_accessor :version @@ -695,9 +583,8 @@ module Google # @return [String] attr_accessor :create_time - # True if the project can be retrieved using GetProject. No other operations - # on the project are guaranteed to work until the project creation is - # complete. + # True if the project can be retrieved using GetProject. No other operations on + # the project are guaranteed to work until the project creation is complete. # Corresponds to the JSON property `gettable` # @return [Boolean] attr_accessor :gettable @@ -736,25 +623,20 @@ module Google # @return [String] attr_accessor :page_token - # Search criteria used to select the Folders to return. - # If no search criteria is specified then all accessible folders will be - # returned. - # Query expressions can be used to restrict results based upon displayName, - # lifecycleState and parent, where the operators `=`, `NOT`, `AND` and `OR` - # can be used along with the suffix wildcard symbol `*`. - # The displayName field in a query expression should use escaped quotes - # for values that include whitespace to prevent unexpected behavior. - # Some example queries are: - # * Query `displayName=Test*` returns Folder resources whose display name - # starts with "Test". - # * Query `lifecycleState=ACTIVE` returns Folder resources with - # `lifecycleState` set to `ACTIVE`. - # * Query `parent=folders/123` returns Folder resources that have - # `folders/123` as a parent resource. - # * Query `parent=folders/123 AND lifecycleState=ACTIVE` returns active - # Folder resources that have `folders/123` as a parent resource. - # * Query `displayName=\\"Test String\\"` returns Folder resources with - # display names that include both "Test" and "String". + # Search criteria used to select the Folders to return. If no search criteria is + # specified then all accessible folders will be returned. Query expressions can + # be used to restrict results based upon displayName, lifecycleState and parent, + # where the operators `=`, `NOT`, `AND` and `OR` can be used along with the + # suffix wildcard symbol `*`. The displayName field in a query expression should + # use escaped quotes for values that include whitespace to prevent unexpected + # behavior. Some example queries are: * Query `displayName=Test*` returns Folder + # resources whose display name starts with "Test". * Query `lifecycleState= + # ACTIVE` returns Folder resources with `lifecycleState` set to `ACTIVE`. * + # Query `parent=folders/123` returns Folder resources that have `folders/123` as + # a parent resource. * Query `parent=folders/123 AND lifecycleState=ACTIVE` + # returns active Folder resources that have `folders/123` as a parent resource. * + # Query `displayName=\\"Test String\\"` returns Folder resources with display + # names that include both "Test" and "String". # Corresponds to the JSON property `query` # @return [String] attr_accessor :query @@ -775,14 +657,13 @@ module Google class SearchFoldersResponse include Google::Apis::Core::Hashable - # A possibly paginated folder search results. - # the specified parent resource. + # A possibly paginated folder search results. the specified parent resource. # Corresponds to the JSON property `folders` # @return [Array] attr_accessor :folders - # A pagination token returned from a previous call to `SearchFolders` - # that indicates from where searching should continue. + # A pagination token returned from a previous call to `SearchFolders` that + # indicates from where searching should continue. # Corresponds to the JSON property `nextPageToken` # @return [String] attr_accessor :next_page_token @@ -803,74 +684,39 @@ module Google include Google::Apis::Core::Hashable # An Identity and Access Management (IAM) policy, which specifies access - # controls for Google Cloud resources. - # A `Policy` is a collection of `bindings`. A `binding` binds one or more - # `members` to a single `role`. Members can be user accounts, service accounts, - # Google groups, and domains (such as G Suite). A `role` is a named list of - # permissions; each `role` can be an IAM predefined role or a user-created - # custom role. - # For some types of Google Cloud resources, a `binding` can also specify a - # `condition`, which is a logical expression that allows access to a resource - # only if the expression evaluates to `true`. A condition can add constraints - # based on attributes of the request, the resource, or both. To learn which - # resources support conditions in their IAM policies, see the - # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource- - # policies). - # **JSON example:** - # ` - # "bindings": [ - # ` - # "role": "roles/resourcemanager.organizationAdmin", - # "members": [ - # "user:mike@example.com", - # "group:admins@example.com", - # "domain:google.com", - # "serviceAccount:my-project-id@appspot.gserviceaccount.com" - # ] - # `, - # ` - # "role": "roles/resourcemanager.organizationViewer", - # "members": [ - # "user:eve@example.com" - # ], - # "condition": ` - # "title": "expirable access", - # "description": "Does not grant access after Sep 2020", - # "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z') - # ", - # ` - # ` - # ], - # "etag": "BwWWja0YfJA=", - # "version": 3 - # ` - # **YAML example:** - # bindings: - # - members: - # - user:mike@example.com - # - group:admins@example.com - # - domain:google.com - # - serviceAccount:my-project-id@appspot.gserviceaccount.com - # role: roles/resourcemanager.organizationAdmin - # - members: - # - user:eve@example.com - # role: roles/resourcemanager.organizationViewer - # condition: - # title: expirable access - # description: Does not grant access after Sep 2020 - # expression: request.time < timestamp('2020-10-01T00:00:00.000Z') - # - etag: BwWWja0YfJA= - # - version: 3 - # For a description of IAM and its features, see the - # [IAM documentation](https://cloud.google.com/iam/docs/). + # controls for Google Cloud resources. A `Policy` is a collection of `bindings`. + # A `binding` binds one or more `members` to a single `role`. Members can be + # user accounts, service accounts, Google groups, and domains (such as G Suite). + # A `role` is a named list of permissions; each `role` can be an IAM predefined + # role or a user-created custom role. For some types of Google Cloud resources, + # a `binding` can also specify a `condition`, which is a logical expression that + # allows access to a resource only if the expression evaluates to `true`. A + # condition can add constraints based on attributes of the request, the resource, + # or both. To learn which resources support conditions in their IAM policies, + # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/ + # resource-policies). **JSON example:** ` "bindings": [ ` "role": "roles/ + # resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", " + # group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@ + # appspot.gserviceaccount.com" ] `, ` "role": "roles/resourcemanager. + # organizationViewer", "members": [ "user:eve@example.com" ], "condition": ` " + # title": "expirable access", "description": "Does not grant access after Sep + # 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", ` + # ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:** bindings: - + # members: - user:mike@example.com - group:admins@example.com - domain:google. + # com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/ + # resourcemanager.organizationAdmin - members: - user:eve@example.com role: + # roles/resourcemanager.organizationViewer condition: title: expirable access + # description: Does not grant access after Sep 2020 expression: request.time < + # timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: 3 For a + # description of IAM and its features, see the [IAM documentation](https://cloud. + # google.com/iam/docs/). # Corresponds to the JSON property `policy` # @return [Google::Apis::CloudresourcemanagerV2::Policy] attr_accessor :policy # OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only - # the fields in the mask will be modified. If no mask is provided, the - # following default mask is used: - # `paths: "bindings, etag"` + # the fields in the mask will be modified. If no mask is provided, the following + # default mask is used: `paths: "bindings, etag"` # Corresponds to the JSON property `updateMask` # @return [String] attr_accessor :update_mask @@ -886,12 +732,12 @@ module Google end end - # 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). + # 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). class Status include Google::Apis::Core::Hashable @@ -900,15 +746,15 @@ module Google # @return [Fixnum] attr_accessor :code - # A list of messages that carry the error details. There is a common set of + # A list of messages that carry the error details. There is a common set of # message types for APIs to use. # Corresponds to the JSON property `details` # @return [Array>] attr_accessor :details - # 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. + # 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. # Corresponds to the JSON property `message` # @return [String] attr_accessor :message @@ -929,10 +775,9 @@ module Google class TestIamPermissionsRequest include Google::Apis::Core::Hashable - # The set of permissions to check for the `resource`. Permissions with - # wildcards (such as '*' or 'storage.*') are not allowed. For more - # information see - # [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions). + # The set of permissions to check for the `resource`. Permissions with wildcards + # (such as '*' or 'storage.*') are not allowed. For more information see [IAM + # Overview](https://cloud.google.com/iam/docs/overview#permissions). # Corresponds to the JSON property `permissions` # @return [Array] attr_accessor :permissions @@ -951,8 +796,7 @@ module Google class TestIamPermissionsResponse include Google::Apis::Core::Hashable - # A subset of `TestPermissionsRequest.permissions` that the caller is - # allowed. + # A subset of `TestPermissionsRequest.permissions` that the caller is allowed. # Corresponds to the JSON property `permissions` # @return [Array] attr_accessor :permissions diff --git a/generated/google/apis/cloudresourcemanager_v2/service.rb b/generated/google/apis/cloudresourcemanager_v2/service.rb index f0637ade0..70065c6a9 100644 --- a/generated/google/apis/cloudresourcemanager_v2/service.rb +++ b/generated/google/apis/cloudresourcemanager_v2/service.rb @@ -48,33 +48,27 @@ module Google @batch_path = 'batch' end - # Creates a Folder in the resource hierarchy. - # Returns an Operation which can be used to track the progress of the - # folder creation workflow. - # Upon success the Operation.response field will be populated with the - # created Folder. - # In order to succeed, the addition of this new Folder must not violate - # the Folder naming, height or fanout constraints. - # + The Folder's display_name must be distinct from all other Folder's that - # share its parent. - # + The addition of the Folder must not cause the active Folder hierarchy - # to exceed a height of 4. Note, the full active + deleted Folder hierarchy - # is allowed to reach a height of 8; this provides additional headroom when - # moving folders that contain deleted folders. - # + The addition of the Folder must not cause the total number of Folders - # under its parent to exceed 100. - # If the operation fails due to a folder constraint violation, some errors - # may be returned by the CreateFolder request, with status code - # FAILED_PRECONDITION and an error description. Other folder constraint - # violations will be communicated in the Operation, with the specific - # PreconditionFailure returned via the details list in the Operation.error - # field. + # Creates a Folder in the resource hierarchy. Returns an Operation which can be + # used to track the progress of the folder creation workflow. Upon success the + # Operation.response field will be populated with the created Folder. In order + # to succeed, the addition of this new Folder must not violate the Folder naming, + # height or fanout constraints. + The Folder's display_name must be distinct + # from all other Folder's that share its parent. + The addition of the Folder + # must not cause the active Folder hierarchy to exceed a height of 4. Note, the + # full active + deleted Folder hierarchy is allowed to reach a height of 8; this + # provides additional headroom when moving folders that contain deleted folders. + # + The addition of the Folder must not cause the total number of Folders under + # its parent to exceed 100. If the operation fails due to a folder constraint + # violation, some errors may be returned by the CreateFolder request, with + # status code FAILED_PRECONDITION and an error description. Other folder + # constraint violations will be communicated in the Operation, with the specific + # PreconditionFailure returned via the details list in the Operation.error field. # The caller must have `resourcemanager.folders.create` permission on the # identified parent. # @param [Google::Apis::CloudresourcemanagerV2::Folder] folder_object # @param [String] parent - # Required. The resource name of the new Folder's parent. - # Must be of the form `folders/`folder_id`` or `organizations/`org_id``. + # Required. The resource name of the new Folder's parent. Must be of the form ` + # folders/`folder_id`` or `organizations/`org_id``. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -104,18 +98,14 @@ module Google execute_or_queue_command(command, &block) end - # Requests deletion of a Folder. The Folder is moved into the - # DELETE_REQUESTED state - # immediately, and is deleted approximately 30 days later. This method may - # only be called on an empty Folder in the - # ACTIVE state, where a Folder is empty if - # it doesn't contain any Folders or Projects in the - # ACTIVE state. - # The caller must have `resourcemanager.folders.delete` permission on the - # identified folder. + # Requests deletion of a Folder. The Folder is moved into the DELETE_REQUESTED + # state immediately, and is deleted approximately 30 days later. This method may + # only be called on an empty Folder in the ACTIVE state, where a Folder is empty + # if it doesn't contain any Folders or Projects in the ACTIVE state. The caller + # must have `resourcemanager.folders.delete` permission on the identified folder. # @param [String] name - # Required. the resource name of the Folder to be deleted. - # Must be of the form `folders/`folder_id``. + # Required. the resource name of the Folder to be deleted. Must be of the form ` + # folders/`folder_id``. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -143,14 +133,13 @@ module Google execute_or_queue_command(command, &block) end - # Retrieves a Folder identified by the supplied resource name. - # Valid Folder resource names have the format `folders/`folder_id`` - # (for example, `folders/1234`). - # The caller must have `resourcemanager.folders.get` permission on the + # Retrieves a Folder identified by the supplied resource name. Valid Folder + # resource names have the format `folders/`folder_id`` (for example, `folders/ + # 1234`). The caller must have `resourcemanager.folders.get` permission on the # identified folder. # @param [String] name - # Required. The resource name of the Folder to retrieve. - # Must be of the form `folders/`folder_id``. + # Required. The resource name of the Folder to retrieve. Must be of the form ` + # folders/`folder_id``. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -178,14 +167,13 @@ module Google execute_or_queue_command(command, &block) end - # Gets the access control policy for a Folder. The returned policy may be - # empty if no such policy or resource exists. The `resource` field should - # be the Folder's resource name, e.g. "folders/1234". - # The caller must have `resourcemanager.folders.getIamPolicy` permission - # on the identified folder. + # Gets the access control policy for a Folder. The returned policy may be empty + # if no such policy or resource exists. The `resource` field should be the + # Folder's resource name, e.g. "folders/1234". The caller must have ` + # resourcemanager.folders.getIamPolicy` permission on the identified folder. # @param [String] resource - # REQUIRED: The resource for which the policy is being requested. - # See the operation documentation for the appropriate value for this field. + # REQUIRED: The resource for which the policy is being requested. See the + # operation documentation for the appropriate value for this field. # @param [Google::Apis::CloudresourcemanagerV2::GetIamPolicyRequest] get_iam_policy_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -217,12 +205,10 @@ module Google end # Lists the Folders that are direct descendants of supplied parent resource. - # List provides a strongly consistent view of the Folders underneath - # the specified parent resource. - # List returns Folders sorted based upon the (ascending) lexical ordering - # of their display_name. - # The caller must have `resourcemanager.folders.list` permission on the - # identified parent. + # List provides a strongly consistent view of the Folders underneath the + # specified parent resource. List returns Folders sorted based upon the ( + # ascending) lexical ordering of their display_name. The caller must have ` + # resourcemanager.folders.list` permission on the identified parent. # @param [Fixnum] page_size # Optional. The maximum number of Folders to return in the response. # @param [String] page_token @@ -230,14 +216,12 @@ module Google # that indicates where this listing should continue from. # @param [String] parent # Required. The resource name of the Organization or Folder whose Folders are - # being listed. - # Must be of the form `folders/`folder_id`` or `organizations/`org_id``. - # Access to this method is controlled by checking the - # `resourcemanager.folders.list` permission on the `parent`. + # being listed. Must be of the form `folders/`folder_id`` or `organizations/` + # org_id``. Access to this method is controlled by checking the `resourcemanager. + # folders.list` permission on the `parent`. # @param [Boolean] show_deleted - # Optional. Controls whether Folders in the - # DELETE_REQUESTED - # state should be returned. Defaults to false. + # Optional. Controls whether Folders in the DELETE_REQUESTED state should be + # returned. Defaults to false. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -268,26 +252,21 @@ module Google execute_or_queue_command(command, &block) end - # Moves a Folder under a new resource parent. - # Returns an Operation which can be used to track the progress of the - # folder move workflow. - # Upon success the Operation.response field will be populated with the - # moved Folder. - # Upon failure, a FolderOperationError categorizing the failure cause will - # be returned - if the failure occurs synchronously then the - # FolderOperationError will be returned via the Status.details field - # and if it occurs asynchronously then the FolderOperation will be returned - # via the Operation.error field. - # In addition, the Operation.metadata field will be populated with a - # FolderOperation message as an aid to stateless clients. - # Folder moves will be rejected if they violate either the naming, height - # or fanout constraints described in the - # CreateFolder documentation. - # The caller must have `resourcemanager.folders.move` permission on the - # folder's current and proposed new parent. + # Moves a Folder under a new resource parent. Returns an Operation which can be + # used to track the progress of the folder move workflow. Upon success the + # Operation.response field will be populated with the moved Folder. Upon failure, + # a FolderOperationError categorizing the failure cause will be returned - if + # the failure occurs synchronously then the FolderOperationError will be + # returned via the Status.details field and if it occurs asynchronously then the + # FolderOperation will be returned via the Operation.error field. In addition, + # the Operation.metadata field will be populated with a FolderOperation message + # as an aid to stateless clients. Folder moves will be rejected if they violate + # either the naming, height or fanout constraints described in the CreateFolder + # documentation. The caller must have `resourcemanager.folders.move` permission + # on the folder's current and proposed new parent. # @param [String] name - # Required. The resource name of the Folder to move. - # Must be of the form folders/`folder_id` + # Required. The resource name of the Folder to move. Must be of the form folders/ + # `folder_id` # @param [Google::Apis::CloudresourcemanagerV2::MoveFolderRequest] move_folder_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -318,26 +297,22 @@ module Google execute_or_queue_command(command, &block) end - # Updates a Folder, changing its display_name. - # Changes to the folder display_name will be rejected if they violate either - # the display_name formatting rules or naming constraints described in - # the CreateFolder documentation. - # The Folder's display name must start and end with a letter or digit, - # may contain letters, digits, spaces, hyphens and underscores and can be - # no longer than 30 characters. This is captured by the regular expression: - # [\p`L`\p`N`]([\p`L`\p`N`_- ]`0,28`[\p`L`\p`N`])?. - # The caller must have `resourcemanager.folders.update` permission on the - # identified folder. - # If the update fails due to the unique name constraint then a - # PreconditionFailure explaining this violation will be returned - # in the Status.details field. + # Updates a Folder, changing its display_name. Changes to the folder + # display_name will be rejected if they violate either the display_name + # formatting rules or naming constraints described in the CreateFolder + # documentation. The Folder's display name must start and end with a letter or + # digit, may contain letters, digits, spaces, hyphens and underscores and can be + # no longer than 30 characters. This is captured by the regular expression: [\p` + # L`\p`N`]([\p`L`\p`N`_- ]`0,28`[\p`L`\p`N`])?. The caller must have ` + # resourcemanager.folders.update` permission on the identified folder. If the + # update fails due to the unique name constraint then a PreconditionFailure + # explaining this violation will be returned in the Status.details field. # @param [String] name - # Output only. The resource name of the Folder. - # Its format is `folders/`folder_id``, for example: "folders/1234". + # Output only. The resource name of the Folder. Its format is `folders/` + # folder_id``, for example: "folders/1234". # @param [Google::Apis::CloudresourcemanagerV2::Folder] folder_object # @param [String] update_mask - # Required. Fields to be updated. - # Only the `display_name` can be updated. + # Required. Fields to be updated. Only the `display_name` can be updated. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -368,11 +343,10 @@ module Google execute_or_queue_command(command, &block) end - # Search for folders that match specific filter criteria. - # Search provides an eventually consistent view of the folders a user has - # access to which meet the specified filter criteria. - # This will only return folders on which the caller has the - # permission `resourcemanager.folders.get`. + # Search for folders that match specific filter criteria. Search provides an + # eventually consistent view of the folders a user has access to which meet the + # specified filter criteria. This will only return folders on which the caller + # has the permission `resourcemanager.folders.get`. # @param [Google::Apis::CloudresourcemanagerV2::SearchFoldersRequest] search_folders_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -402,14 +376,13 @@ module Google execute_or_queue_command(command, &block) end - # Sets the access control policy on a Folder, replacing any existing policy. - # The `resource` field should be the Folder's resource name, e.g. - # "folders/1234". - # The caller must have `resourcemanager.folders.setIamPolicy` permission - # on the identified folder. + # Sets the access control policy on a Folder, replacing any existing policy. The + # `resource` field should be the Folder's resource name, e.g. "folders/1234". + # The caller must have `resourcemanager.folders.setIamPolicy` permission on the + # identified folder. # @param [String] resource - # REQUIRED: The resource for which the policy is being specified. - # See the operation documentation for the appropriate value for this field. + # REQUIRED: The resource for which the policy is being specified. See the + # operation documentation for the appropriate value for this field. # @param [Google::Apis::CloudresourcemanagerV2::SetIamPolicyRequest] set_iam_policy_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -440,13 +413,12 @@ module Google execute_or_queue_command(command, &block) end - # Returns permissions that a caller has on the specified Folder. - # The `resource` field should be the Folder's resource name, - # e.g. "folders/1234". - # There are no permissions required for making this API call. + # Returns permissions that a caller has on the specified Folder. The `resource` + # field should be the Folder's resource name, e.g. "folders/1234". There are no + # permissions required for making this API call. # @param [String] resource - # REQUIRED: The resource for which the policy detail is being requested. - # See the operation documentation for the appropriate value for this field. + # REQUIRED: The resource for which the policy detail is being requested. See the + # operation documentation for the appropriate value for this field. # @param [Google::Apis::CloudresourcemanagerV2::TestIamPermissionsRequest] test_iam_permissions_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -477,19 +449,15 @@ module Google execute_or_queue_command(command, &block) end - # Cancels the deletion request for a Folder. This method may only be - # called on a Folder in the - # DELETE_REQUESTED state. - # In order to succeed, the Folder's parent must be in the - # ACTIVE state. - # In addition, reintroducing the folder into the tree must not violate - # folder naming, height and fanout constraints described in the - # CreateFolder documentation. - # The caller must have `resourcemanager.folders.undelete` permission on the - # identified folder. + # Cancels the deletion request for a Folder. This method may only be called on a + # Folder in the DELETE_REQUESTED state. In order to succeed, the Folder's parent + # must be in the ACTIVE state. In addition, reintroducing the folder into the + # tree must not violate folder naming, height and fanout constraints described + # in the CreateFolder documentation. The caller must have `resourcemanager. + # folders.undelete` permission on the identified folder. # @param [String] name - # Required. The resource name of the Folder to undelete. - # Must be of the form `folders/`folder_id``. + # Required. The resource name of the Folder to undelete. Must be of the form ` + # folders/`folder_id``. # @param [Google::Apis::CloudresourcemanagerV2::UndeleteFolderRequest] undelete_folder_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -520,9 +488,8 @@ module Google execute_or_queue_command(command, &block) end - # 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. + # 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. # @param [String] name # The name of the operation resource. # @param [String] fields diff --git a/generated/google/apis/cloudresourcemanager_v2beta1.rb b/generated/google/apis/cloudresourcemanager_v2beta1.rb index ccc58c0c3..69bc635e3 100644 --- a/generated/google/apis/cloudresourcemanager_v2beta1.rb +++ b/generated/google/apis/cloudresourcemanager_v2beta1.rb @@ -26,7 +26,7 @@ module Google # @see https://cloud.google.com/resource-manager module CloudresourcemanagerV2beta1 VERSION = 'V2beta1' - REVISION = '20200617' + REVISION = '20200720' # View and manage your data across Google Cloud Platform services AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform' diff --git a/generated/google/apis/cloudresourcemanager_v2beta1/classes.rb b/generated/google/apis/cloudresourcemanager_v2beta1/classes.rb index 9740cd91e..778b569c5 100644 --- a/generated/google/apis/cloudresourcemanager_v2beta1/classes.rb +++ b/generated/google/apis/cloudresourcemanager_v2beta1/classes.rb @@ -22,53 +22,21 @@ module Google module Apis module CloudresourcemanagerV2beta1 - # Specifies the audit configuration for a service. - # The configuration determines which permission types are logged, and what - # identities, if any, are exempted from logging. - # An AuditConfig must have one or more AuditLogConfigs. - # If there are AuditConfigs for both `allServices` and a specific service, - # the union of the two AuditConfigs is used for that service: the log_types - # specified in each AuditConfig are enabled, and the exempted_members in each - # AuditLogConfig are exempted. - # Example Policy with multiple AuditConfigs: - # ` - # "audit_configs": [ - # ` - # "service": "allServices", - # "audit_log_configs": [ - # ` - # "log_type": "DATA_READ", - # "exempted_members": [ - # "user:jose@example.com" - # ] - # `, - # ` - # "log_type": "DATA_WRITE" - # `, - # ` - # "log_type": "ADMIN_READ" - # ` - # ] - # `, - # ` - # "service": "sampleservice.googleapis.com", - # "audit_log_configs": [ - # ` - # "log_type": "DATA_READ" - # `, - # ` - # "log_type": "DATA_WRITE", - # "exempted_members": [ - # "user:aliya@example.com" - # ] - # ` - # ] - # ` - # ] - # ` - # For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ - # logging. It also exempts jose@example.com from DATA_READ logging, and - # aliya@example.com from DATA_WRITE logging. + # Specifies the audit configuration for a service. The configuration determines + # which permission types are logged, and what identities, if any, are exempted + # from logging. An AuditConfig must have one or more AuditLogConfigs. If there + # are AuditConfigs for both `allServices` and a specific service, the union of + # the two AuditConfigs is used for that service: the log_types specified in each + # AuditConfig are enabled, and the exempted_members in each AuditLogConfig are + # exempted. Example Policy with multiple AuditConfigs: ` "audit_configs": [ ` " + # service": "allServices", "audit_log_configs": [ ` "log_type": "DATA_READ", " + # exempted_members": [ "user:jose@example.com" ] `, ` "log_type": "DATA_WRITE" `, + # ` "log_type": "ADMIN_READ" ` ] `, ` "service": "sampleservice.googleapis.com", + # "audit_log_configs": [ ` "log_type": "DATA_READ" `, ` "log_type": "DATA_WRITE" + # , "exempted_members": [ "user:aliya@example.com" ] ` ] ` ] ` For sampleservice, + # this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also + # exempts jose@example.com from DATA_READ logging, and aliya@example.com from + # DATA_WRITE logging. class AuditConfig include Google::Apis::Core::Hashable @@ -77,9 +45,9 @@ module Google # @return [Array] attr_accessor :audit_log_configs - # Specifies a service that will be enabled for audit logging. - # For example, `storage.googleapis.com`, `cloudsql.googleapis.com`. - # `allServices` is a special value that covers all services. + # Specifies a service that will be enabled for audit logging. For example, ` + # storage.googleapis.com`, `cloudsql.googleapis.com`. `allServices` is a special + # value that covers all services. # Corresponds to the JSON property `service` # @return [String] attr_accessor :service @@ -95,28 +63,15 @@ module Google end end - # Provides the configuration for logging a type of permissions. - # Example: - # ` - # "audit_log_configs": [ - # ` - # "log_type": "DATA_READ", - # "exempted_members": [ - # "user:jose@example.com" - # ] - # `, - # ` - # "log_type": "DATA_WRITE" - # ` - # ] - # ` - # This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting - # jose@example.com from DATA_READ logging. + # Provides the configuration for logging a type of permissions. Example: ` " + # audit_log_configs": [ ` "log_type": "DATA_READ", "exempted_members": [ "user: + # jose@example.com" ] `, ` "log_type": "DATA_WRITE" ` ] ` This enables ' + # DATA_READ' and 'DATA_WRITE' logging, while exempting jose@example.com from + # DATA_READ logging. class AuditLogConfig include Google::Apis::Core::Hashable - # Specifies the identities that do not cause logging for this type of - # permission. + # Specifies the identities that do not cause logging for this type of permission. # Follows the same format of Binding.members. # Corresponds to the JSON property `exemptedMembers` # @return [Array] @@ -142,69 +97,57 @@ module Google class Binding include Google::Apis::Core::Hashable - # Represents a textual expression in the Common Expression Language (CEL) - # syntax. CEL is a C-like expression language. The syntax and semantics of CEL - # are documented at https://github.com/google/cel-spec. - # Example (Comparison): - # title: "Summary size limit" - # description: "Determines if a summary is less than 100 chars" - # expression: "document.summary.size() < 100" - # Example (Equality): - # title: "Requestor is owner" - # description: "Determines if requestor is the document owner" - # expression: "document.owner == request.auth.claims.email" - # Example (Logic): - # title: "Public documents" - # description: "Determine whether the document should be publicly visible" - # expression: "document.type != 'private' && document.type != 'internal'" - # Example (Data Manipulation): - # title: "Notification string" - # description: "Create a notification string with a timestamp." - # expression: "'New message received at ' + string(document.create_time)" - # The exact variables and functions that may be referenced within an expression - # are determined by the service that evaluates it. See the service - # documentation for additional information. + # Represents a textual expression in the Common Expression Language (CEL) syntax. + # CEL is a C-like expression language. The syntax and semantics of CEL are + # documented at https://github.com/google/cel-spec. Example (Comparison): title: + # "Summary size limit" description: "Determines if a summary is less than 100 + # chars" expression: "document.summary.size() < 100" Example (Equality): title: " + # Requestor is owner" description: "Determines if requestor is the document + # owner" expression: "document.owner == request.auth.claims.email" Example ( + # Logic): title: "Public documents" description: "Determine whether the document + # should be publicly visible" expression: "document.type != 'private' && + # document.type != 'internal'" Example (Data Manipulation): title: "Notification + # string" description: "Create a notification string with a timestamp." + # expression: "'New message received at ' + string(document.create_time)" The + # exact variables and functions that may be referenced within an expression are + # determined by the service that evaluates it. See the service documentation for + # additional information. # Corresponds to the JSON property `condition` # @return [Google::Apis::CloudresourcemanagerV2beta1::Expr] attr_accessor :condition - # Specifies the identities requesting access for a Cloud Platform resource. - # `members` can have the following values: - # * `allUsers`: A special identifier that represents anyone who is - # on the internet; with or without a Google account. - # * `allAuthenticatedUsers`: A special identifier that represents anyone - # who is authenticated with a Google account or a service account. - # * `user:`emailid``: An email address that represents a specific Google - # account. For example, `alice@example.com` . - # * `serviceAccount:`emailid``: An email address that represents a service - # account. For example, `my-other-app@appspot.gserviceaccount.com`. - # * `group:`emailid``: An email address that represents a Google group. - # For example, `admins@example.com`. - # * `deleted:user:`emailid`?uid=`uniqueid``: An email address (plus unique - # identifier) representing a user that has been recently deleted. For - # example, `alice@example.com?uid=123456789012345678901`. If the user is - # recovered, this value reverts to `user:`emailid`` and the recovered user - # retains the role in the binding. - # * `deleted:serviceAccount:`emailid`?uid=`uniqueid``: An email address (plus - # unique identifier) representing a service account that has been recently - # deleted. For example, - # `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. - # If the service account is undeleted, this value reverts to - # `serviceAccount:`emailid`` and the undeleted service account retains the - # role in the binding. - # * `deleted:group:`emailid`?uid=`uniqueid``: An email address (plus unique - # identifier) representing a Google group that has been recently - # deleted. For example, `admins@example.com?uid=123456789012345678901`. If - # the group is recovered, this value reverts to `group:`emailid`` and the - # recovered group retains the role in the binding. - # * `domain:`domain``: The G Suite domain (primary) that represents all the - # users of that domain. For example, `google.com` or `example.com`. + # Specifies the identities requesting access for a Cloud Platform resource. ` + # members` can have the following values: * `allUsers`: A special identifier + # that represents anyone who is on the internet; with or without a Google + # account. * `allAuthenticatedUsers`: A special identifier that represents + # anyone who is authenticated with a Google account or a service account. * ` + # user:`emailid``: An email address that represents a specific Google account. + # For example, `alice@example.com` . * `serviceAccount:`emailid``: An email + # address that represents a service account. For example, `my-other-app@appspot. + # gserviceaccount.com`. * `group:`emailid``: An email address that represents a + # Google group. For example, `admins@example.com`. * `deleted:user:`emailid`?uid= + # `uniqueid``: An email address (plus unique identifier) representing a user + # that has been recently deleted. For example, `alice@example.com?uid= + # 123456789012345678901`. If the user is recovered, this value reverts to `user:` + # emailid`` and the recovered user retains the role in the binding. * `deleted: + # serviceAccount:`emailid`?uid=`uniqueid``: An email address (plus unique + # identifier) representing a service account that has been recently deleted. For + # example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. + # If the service account is undeleted, this value reverts to `serviceAccount:` + # emailid`` and the undeleted service account retains the role in the binding. * + # `deleted:group:`emailid`?uid=`uniqueid``: An email address (plus unique + # identifier) representing a Google group that has been recently deleted. For + # example, `admins@example.com?uid=123456789012345678901`. If the group is + # recovered, this value reverts to `group:`emailid`` and the recovered group + # retains the role in the binding. * `domain:`domain``: The G Suite domain ( + # primary) that represents all the users of that domain. For example, `google. + # com` or `example.com`. # Corresponds to the JSON property `members` # @return [Array] attr_accessor :members - # Role that is assigned to `members`. - # For example, `roles/viewer`, `roles/editor`, or `roles/owner`. + # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor` + # , or `roles/owner`. # Corresponds to the JSON property `role` # @return [String] attr_accessor :role @@ -221,52 +164,43 @@ module Google end end - # Represents a textual expression in the Common Expression Language (CEL) - # syntax. CEL is a C-like expression language. The syntax and semantics of CEL - # are documented at https://github.com/google/cel-spec. - # Example (Comparison): - # title: "Summary size limit" - # description: "Determines if a summary is less than 100 chars" - # expression: "document.summary.size() < 100" - # Example (Equality): - # title: "Requestor is owner" - # description: "Determines if requestor is the document owner" - # expression: "document.owner == request.auth.claims.email" - # Example (Logic): - # title: "Public documents" - # description: "Determine whether the document should be publicly visible" - # expression: "document.type != 'private' && document.type != 'internal'" - # Example (Data Manipulation): - # title: "Notification string" - # description: "Create a notification string with a timestamp." - # expression: "'New message received at ' + string(document.create_time)" - # The exact variables and functions that may be referenced within an expression - # are determined by the service that evaluates it. See the service - # documentation for additional information. + # Represents a textual expression in the Common Expression Language (CEL) syntax. + # CEL is a C-like expression language. The syntax and semantics of CEL are + # documented at https://github.com/google/cel-spec. Example (Comparison): title: + # "Summary size limit" description: "Determines if a summary is less than 100 + # chars" expression: "document.summary.size() < 100" Example (Equality): title: " + # Requestor is owner" description: "Determines if requestor is the document + # owner" expression: "document.owner == request.auth.claims.email" Example ( + # Logic): title: "Public documents" description: "Determine whether the document + # should be publicly visible" expression: "document.type != 'private' && + # document.type != 'internal'" Example (Data Manipulation): title: "Notification + # string" description: "Create a notification string with a timestamp." + # expression: "'New message received at ' + string(document.create_time)" The + # exact variables and functions that may be referenced within an expression are + # determined by the service that evaluates it. See the service documentation for + # additional information. class Expr include Google::Apis::Core::Hashable - # Optional. Description of the expression. This is a longer text which - # describes the expression, e.g. when hovered over it in a UI. + # Optional. Description of the expression. This is a longer text which describes + # the expression, e.g. when hovered over it in a UI. # Corresponds to the JSON property `description` # @return [String] attr_accessor :description - # Textual representation of an expression in Common Expression Language - # syntax. + # Textual representation of an expression in Common Expression Language syntax. # Corresponds to the JSON property `expression` # @return [String] attr_accessor :expression - # Optional. String indicating the location of the expression for error - # reporting, e.g. a file name and a position in the file. + # Optional. String indicating the location of the expression for error reporting, + # e.g. a file name and a position in the file. # Corresponds to the JSON property `location` # @return [String] attr_accessor :location - # Optional. Title for the expression, i.e. a short string describing - # its purpose. This can be used e.g. in UIs which allow to enter the - # expression. + # Optional. Title for the expression, i.e. a short string describing its purpose. + # This can be used e.g. in UIs which allow to enter the expression. # Corresponds to the JSON property `title` # @return [String] attr_accessor :title @@ -284,8 +218,8 @@ module Google end end - # A Folder in an Organization's resource hierarchy, used to - # organize that Organization's resources. + # A Folder in an Organization's resource hierarchy, used to organize that + # Organization's resources. class Folder include Google::Apis::Core::Hashable @@ -294,34 +228,30 @@ module Google # @return [String] attr_accessor :create_time - # The folder’s display name. - # A folder’s display name must be unique amongst its siblings, e.g. - # no two folders with the same parent can share the same display name. - # The display name must start and end with a letter or digit, may contain - # letters, digits, spaces, hyphens and underscores and can be no longer - # than 30 characters. This is captured by the regular expression: - # [\p`L`\p`N`]([\p`L`\p`N`_- ]`0,28`[\p`L`\p`N`])?. + # The folder’s display name. A folder’s display name must be unique amongst its + # siblings, e.g. no two folders with the same parent can share the same display + # name. The display name must start and end with a letter or digit, may contain + # letters, digits, spaces, hyphens and underscores and can be no longer than 30 + # characters. This is captured by the regular expression: [\p`L`\p`N`]([\p`L`\p` + # N`_- ]`0,28`[\p`L`\p`N`])?. # Corresponds to the JSON property `displayName` # @return [String] attr_accessor :display_name - # Output only. The lifecycle state of the folder. - # Updates to the lifecycle_state must be performed via - # DeleteFolder and - # UndeleteFolder. + # Output only. The lifecycle state of the folder. Updates to the lifecycle_state + # must be performed via DeleteFolder and UndeleteFolder. # Corresponds to the JSON property `lifecycleState` # @return [String] attr_accessor :lifecycle_state - # Output only. The resource name of the Folder. - # Its format is `folders/`folder_id``, for example: "folders/1234". + # Output only. The resource name of the Folder. Its format is `folders/` + # folder_id``, for example: "folders/1234". # Corresponds to the JSON property `name` # @return [String] attr_accessor :name - # Required. The Folder’s parent's resource name. - # Updates to the folder's parent must be performed via - # MoveFolder. + # Required. The Folder’s parent's resource name. Updates to the folder's parent + # must be performed via MoveFolder. # Corresponds to the JSON property `parent` # @return [String] attr_accessor :parent @@ -344,8 +274,8 @@ module Google class FolderOperation include Google::Apis::Core::Hashable - # The resource name of the folder or organization we are either creating - # the folder under or moving the folder to. + # The resource name of the folder or organization we are either creating the + # folder under or moving the folder to. # Corresponds to the JSON property `destinationParent` # @return [String] attr_accessor :destination_parent @@ -360,8 +290,8 @@ module Google # @return [String] attr_accessor :operation_type - # The resource name of the folder's parent. - # Only applicable when the operation_type is MOVE. + # The resource name of the folder's parent. Only applicable when the + # operation_type is MOVE. # Corresponds to the JSON property `sourceParent` # @return [String] attr_accessor :source_parent @@ -421,15 +351,13 @@ module Google class GetPolicyOptions include Google::Apis::Core::Hashable - # Optional. The policy format version to be returned. - # Valid values are 0, 1, and 3. Requests specifying an invalid value will be - # rejected. - # Requests for policies with any conditional bindings must specify version 3. - # Policies without any conditional bindings may specify any valid value or - # leave the field unset. - # To learn which resources support conditions in their IAM policies, see the - # [IAM - # documentation](https://cloud.google.com/iam/help/conditions/resource-policies). + # Optional. The policy format version to be returned. Valid values are 0, 1, and + # 3. Requests specifying an invalid value will be rejected. Requests for + # policies with any conditional bindings must specify version 3. Policies + # without any conditional bindings may specify any valid value or leave the + # field unset. To learn which resources support conditions in their IAM policies, + # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/ + # resource-policies). # Corresponds to the JSON property `requestedPolicyVersion` # @return [Fixnum] attr_accessor :requested_policy_version @@ -448,14 +376,14 @@ module Google class ListFoldersResponse include Google::Apis::Core::Hashable - # A possibly paginated list of Folders that are direct descendants of - # the specified parent resource. + # A possibly paginated list of Folders that are direct descendants of the + # specified parent resource. # Corresponds to the JSON property `folders` # @return [Array] attr_accessor :folders - # A pagination token returned from a previous call to `ListFolders` - # that indicates from where listing should continue. + # A pagination token returned from a previous call to `ListFolders` that + # indicates from where listing should continue. # Corresponds to the JSON property `nextPageToken` # @return [String] attr_accessor :next_page_token @@ -475,9 +403,9 @@ module Google class MoveFolderRequest include Google::Apis::Core::Hashable - # Required. The resource name of the Folder or Organization to reparent - # the folder under. - # Must be of the form `folders/`folder_id`` or `organizations/`org_id``. + # Required. The resource name of the Folder or Organization to reparent the + # folder under. Must be of the form `folders/`folder_id`` or `organizations/` + # org_id``. # Corresponds to the JSON property `destinationParent` # @return [String] attr_accessor :destination_parent @@ -497,47 +425,45 @@ module Google class Operation include Google::Apis::Core::Hashable - # 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. + # 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. # Corresponds to the JSON property `done` # @return [Boolean] attr_accessor :done alias_method :done?, :done - # 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). + # 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). # Corresponds to the JSON property `error` # @return [Google::Apis::CloudresourcemanagerV2beta1::Status] attr_accessor :error - # 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. + # 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. # Corresponds to the JSON property `metadata` # @return [Hash] attr_accessor :metadata # 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``. + # originally returns it. If you use the default HTTP mapping, the `name` should + # be a resource name ending with `operations/`unique_id``. # Corresponds to the JSON property `name` # @return [String] attr_accessor :name - # The normal response of the operation in case of success. 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`. + # The normal response of the operation in case of success. 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`. # Corresponds to the JSON property `response` # @return [Hash] attr_accessor :response @@ -557,66 +483,32 @@ module Google end # An Identity and Access Management (IAM) policy, which specifies access - # controls for Google Cloud resources. - # A `Policy` is a collection of `bindings`. A `binding` binds one or more - # `members` to a single `role`. Members can be user accounts, service accounts, - # Google groups, and domains (such as G Suite). A `role` is a named list of - # permissions; each `role` can be an IAM predefined role or a user-created - # custom role. - # For some types of Google Cloud resources, a `binding` can also specify a - # `condition`, which is a logical expression that allows access to a resource - # only if the expression evaluates to `true`. A condition can add constraints - # based on attributes of the request, the resource, or both. To learn which - # resources support conditions in their IAM policies, see the - # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource- - # policies). - # **JSON example:** - # ` - # "bindings": [ - # ` - # "role": "roles/resourcemanager.organizationAdmin", - # "members": [ - # "user:mike@example.com", - # "group:admins@example.com", - # "domain:google.com", - # "serviceAccount:my-project-id@appspot.gserviceaccount.com" - # ] - # `, - # ` - # "role": "roles/resourcemanager.organizationViewer", - # "members": [ - # "user:eve@example.com" - # ], - # "condition": ` - # "title": "expirable access", - # "description": "Does not grant access after Sep 2020", - # "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z') - # ", - # ` - # ` - # ], - # "etag": "BwWWja0YfJA=", - # "version": 3 - # ` - # **YAML example:** - # bindings: - # - members: - # - user:mike@example.com - # - group:admins@example.com - # - domain:google.com - # - serviceAccount:my-project-id@appspot.gserviceaccount.com - # role: roles/resourcemanager.organizationAdmin - # - members: - # - user:eve@example.com - # role: roles/resourcemanager.organizationViewer - # condition: - # title: expirable access - # description: Does not grant access after Sep 2020 - # expression: request.time < timestamp('2020-10-01T00:00:00.000Z') - # - etag: BwWWja0YfJA= - # - version: 3 - # For a description of IAM and its features, see the - # [IAM documentation](https://cloud.google.com/iam/docs/). + # controls for Google Cloud resources. A `Policy` is a collection of `bindings`. + # A `binding` binds one or more `members` to a single `role`. Members can be + # user accounts, service accounts, Google groups, and domains (such as G Suite). + # A `role` is a named list of permissions; each `role` can be an IAM predefined + # role or a user-created custom role. For some types of Google Cloud resources, + # a `binding` can also specify a `condition`, which is a logical expression that + # allows access to a resource only if the expression evaluates to `true`. A + # condition can add constraints based on attributes of the request, the resource, + # or both. To learn which resources support conditions in their IAM policies, + # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/ + # resource-policies). **JSON example:** ` "bindings": [ ` "role": "roles/ + # resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", " + # group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@ + # appspot.gserviceaccount.com" ] `, ` "role": "roles/resourcemanager. + # organizationViewer", "members": [ "user:eve@example.com" ], "condition": ` " + # title": "expirable access", "description": "Does not grant access after Sep + # 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", ` + # ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:** bindings: - + # members: - user:mike@example.com - group:admins@example.com - domain:google. + # com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/ + # resourcemanager.organizationAdmin - members: - user:eve@example.com role: + # roles/resourcemanager.organizationViewer condition: title: expirable access + # description: Does not grant access after Sep 2020 expression: request.time < + # timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: 3 For a + # description of IAM and its features, see the [IAM documentation](https://cloud. + # google.com/iam/docs/). class Policy include Google::Apis::Core::Hashable @@ -625,48 +517,44 @@ module Google # @return [Array] attr_accessor :audit_configs - # Associates a list of `members` to a `role`. Optionally, may specify a - # `condition` that determines how and when the `bindings` are applied. Each - # of the `bindings` must contain at least one member. + # Associates a list of `members` to a `role`. Optionally, may specify a ` + # condition` that determines how and when the `bindings` are applied. Each of + # the `bindings` must contain at least one member. # Corresponds to the JSON property `bindings` # @return [Array] attr_accessor :bindings - # `etag` is used for optimistic concurrency control as a way to help - # prevent simultaneous updates of a policy from overwriting each other. - # It is strongly suggested that systems make use of the `etag` in the - # read-modify-write cycle to perform policy updates in order to avoid race - # conditions: An `etag` is returned in the response to `getIamPolicy`, and - # systems are expected to put that etag in the request to `setIamPolicy` to - # ensure that their change will be applied to the same version of the policy. - # **Important:** If you use IAM Conditions, you must include the `etag` field - # whenever you call `setIamPolicy`. If you omit this field, then IAM allows - # you to overwrite a version `3` policy with a version `1` policy, and all of - # the conditions in the version `3` policy are lost. + # `etag` is used for optimistic concurrency control as a way to help prevent + # simultaneous updates of a policy from overwriting each other. It is strongly + # suggested that systems make use of the `etag` in the read-modify-write cycle + # to perform policy updates in order to avoid race conditions: An `etag` is + # returned in the response to `getIamPolicy`, and systems are expected to put + # that etag in the request to `setIamPolicy` to ensure that their change will be + # applied to the same version of the policy. **Important:** If you use IAM + # Conditions, you must include the `etag` field whenever you call `setIamPolicy`. + # If you omit this field, then IAM allows you to overwrite a version `3` policy + # with a version `1` policy, and all of the conditions in the version `3` policy + # are lost. # Corresponds to the JSON property `etag` # NOTE: Values are automatically base64 encoded/decoded in the client library. # @return [String] attr_accessor :etag - # Specifies the format of the policy. - # Valid values are `0`, `1`, and `3`. Requests that specify an invalid value - # are rejected. - # Any operation that affects conditional role bindings must specify version - # `3`. This requirement applies to the following operations: - # * Getting a policy that includes a conditional role binding - # * Adding a conditional role binding to a policy - # * Changing a conditional role binding in a policy - # * Removing any role binding, with or without a condition, from a policy - # that includes conditions - # **Important:** If you use IAM Conditions, you must include the `etag` field - # whenever you call `setIamPolicy`. If you omit this field, then IAM allows - # you to overwrite a version `3` policy with a version `1` policy, and all of - # the conditions in the version `3` policy are lost. - # If a policy does not include any conditions, operations on that policy may - # specify any valid version or leave the field unset. - # To learn which resources support conditions in their IAM policies, see the - # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource- - # policies). + # Specifies the format of the policy. Valid values are `0`, `1`, and `3`. + # Requests that specify an invalid value are rejected. Any operation that + # affects conditional role bindings must specify version `3`. This requirement + # applies to the following operations: * Getting a policy that includes a + # conditional role binding * Adding a conditional role binding to a policy * + # Changing a conditional role binding in a policy * Removing any role binding, + # with or without a condition, from a policy that includes conditions ** + # Important:** If you use IAM Conditions, you must include the `etag` field + # whenever you call `setIamPolicy`. If you omit this field, then IAM allows you + # to overwrite a version `3` policy with a version `1` policy, and all of the + # conditions in the version `3` policy are lost. If a policy does not include + # any conditions, operations on that policy may specify any valid version or + # leave the field unset. To learn which resources support conditions in their + # IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/ + # conditions/resource-policies). # Corresponds to the JSON property `version` # @return [Fixnum] attr_accessor :version @@ -695,9 +583,8 @@ module Google # @return [String] attr_accessor :create_time - # True if the project can be retrieved using GetProject. No other operations - # on the project are guaranteed to work until the project creation is - # complete. + # True if the project can be retrieved using GetProject. No other operations on + # the project are guaranteed to work until the project creation is complete. # Corresponds to the JSON property `gettable` # @return [Boolean] attr_accessor :gettable @@ -736,25 +623,20 @@ module Google # @return [String] attr_accessor :page_token - # Search criteria used to select the Folders to return. - # If no search criteria is specified then all accessible folders will be - # returned. - # Query expressions can be used to restrict results based upon displayName, - # lifecycleState and parent, where the operators `=`, `NOT`, `AND` and `OR` - # can be used along with the suffix wildcard symbol `*`. - # The displayName field in a query expression should use escaped quotes - # for values that include whitespace to prevent unexpected behavior. - # Some example queries are: - # * Query `displayName=Test*` returns Folder resources whose display name - # starts with "Test". - # * Query `lifecycleState=ACTIVE` returns Folder resources with - # `lifecycleState` set to `ACTIVE`. - # * Query `parent=folders/123` returns Folder resources that have - # `folders/123` as a parent resource. - # * Query `parent=folders/123 AND lifecycleState=ACTIVE` returns active - # Folder resources that have `folders/123` as a parent resource. - # * Query `displayName=\\"Test String\\"` returns Folder resources with - # display names that include both "Test" and "String". + # Search criteria used to select the Folders to return. If no search criteria is + # specified then all accessible folders will be returned. Query expressions can + # be used to restrict results based upon displayName, lifecycleState and parent, + # where the operators `=`, `NOT`, `AND` and `OR` can be used along with the + # suffix wildcard symbol `*`. The displayName field in a query expression should + # use escaped quotes for values that include whitespace to prevent unexpected + # behavior. Some example queries are: * Query `displayName=Test*` returns Folder + # resources whose display name starts with "Test". * Query `lifecycleState= + # ACTIVE` returns Folder resources with `lifecycleState` set to `ACTIVE`. * + # Query `parent=folders/123` returns Folder resources that have `folders/123` as + # a parent resource. * Query `parent=folders/123 AND lifecycleState=ACTIVE` + # returns active Folder resources that have `folders/123` as a parent resource. * + # Query `displayName=\\"Test String\\"` returns Folder resources with display + # names that include both "Test" and "String". # Corresponds to the JSON property `query` # @return [String] attr_accessor :query @@ -775,14 +657,13 @@ module Google class SearchFoldersResponse include Google::Apis::Core::Hashable - # A possibly paginated folder search results. - # the specified parent resource. + # A possibly paginated folder search results. the specified parent resource. # Corresponds to the JSON property `folders` # @return [Array] attr_accessor :folders - # A pagination token returned from a previous call to `SearchFolders` - # that indicates from where searching should continue. + # A pagination token returned from a previous call to `SearchFolders` that + # indicates from where searching should continue. # Corresponds to the JSON property `nextPageToken` # @return [String] attr_accessor :next_page_token @@ -803,74 +684,39 @@ module Google include Google::Apis::Core::Hashable # An Identity and Access Management (IAM) policy, which specifies access - # controls for Google Cloud resources. - # A `Policy` is a collection of `bindings`. A `binding` binds one or more - # `members` to a single `role`. Members can be user accounts, service accounts, - # Google groups, and domains (such as G Suite). A `role` is a named list of - # permissions; each `role` can be an IAM predefined role or a user-created - # custom role. - # For some types of Google Cloud resources, a `binding` can also specify a - # `condition`, which is a logical expression that allows access to a resource - # only if the expression evaluates to `true`. A condition can add constraints - # based on attributes of the request, the resource, or both. To learn which - # resources support conditions in their IAM policies, see the - # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource- - # policies). - # **JSON example:** - # ` - # "bindings": [ - # ` - # "role": "roles/resourcemanager.organizationAdmin", - # "members": [ - # "user:mike@example.com", - # "group:admins@example.com", - # "domain:google.com", - # "serviceAccount:my-project-id@appspot.gserviceaccount.com" - # ] - # `, - # ` - # "role": "roles/resourcemanager.organizationViewer", - # "members": [ - # "user:eve@example.com" - # ], - # "condition": ` - # "title": "expirable access", - # "description": "Does not grant access after Sep 2020", - # "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z') - # ", - # ` - # ` - # ], - # "etag": "BwWWja0YfJA=", - # "version": 3 - # ` - # **YAML example:** - # bindings: - # - members: - # - user:mike@example.com - # - group:admins@example.com - # - domain:google.com - # - serviceAccount:my-project-id@appspot.gserviceaccount.com - # role: roles/resourcemanager.organizationAdmin - # - members: - # - user:eve@example.com - # role: roles/resourcemanager.organizationViewer - # condition: - # title: expirable access - # description: Does not grant access after Sep 2020 - # expression: request.time < timestamp('2020-10-01T00:00:00.000Z') - # - etag: BwWWja0YfJA= - # - version: 3 - # For a description of IAM and its features, see the - # [IAM documentation](https://cloud.google.com/iam/docs/). + # controls for Google Cloud resources. A `Policy` is a collection of `bindings`. + # A `binding` binds one or more `members` to a single `role`. Members can be + # user accounts, service accounts, Google groups, and domains (such as G Suite). + # A `role` is a named list of permissions; each `role` can be an IAM predefined + # role or a user-created custom role. For some types of Google Cloud resources, + # a `binding` can also specify a `condition`, which is a logical expression that + # allows access to a resource only if the expression evaluates to `true`. A + # condition can add constraints based on attributes of the request, the resource, + # or both. To learn which resources support conditions in their IAM policies, + # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/ + # resource-policies). **JSON example:** ` "bindings": [ ` "role": "roles/ + # resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", " + # group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@ + # appspot.gserviceaccount.com" ] `, ` "role": "roles/resourcemanager. + # organizationViewer", "members": [ "user:eve@example.com" ], "condition": ` " + # title": "expirable access", "description": "Does not grant access after Sep + # 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", ` + # ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:** bindings: - + # members: - user:mike@example.com - group:admins@example.com - domain:google. + # com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/ + # resourcemanager.organizationAdmin - members: - user:eve@example.com role: + # roles/resourcemanager.organizationViewer condition: title: expirable access + # description: Does not grant access after Sep 2020 expression: request.time < + # timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: 3 For a + # description of IAM and its features, see the [IAM documentation](https://cloud. + # google.com/iam/docs/). # Corresponds to the JSON property `policy` # @return [Google::Apis::CloudresourcemanagerV2beta1::Policy] attr_accessor :policy # OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only - # the fields in the mask will be modified. If no mask is provided, the - # following default mask is used: - # `paths: "bindings, etag"` + # the fields in the mask will be modified. If no mask is provided, the following + # default mask is used: `paths: "bindings, etag"` # Corresponds to the JSON property `updateMask` # @return [String] attr_accessor :update_mask @@ -886,12 +732,12 @@ module Google end end - # 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). + # 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). class Status include Google::Apis::Core::Hashable @@ -900,15 +746,15 @@ module Google # @return [Fixnum] attr_accessor :code - # A list of messages that carry the error details. There is a common set of + # A list of messages that carry the error details. There is a common set of # message types for APIs to use. # Corresponds to the JSON property `details` # @return [Array>] attr_accessor :details - # 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. + # 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. # Corresponds to the JSON property `message` # @return [String] attr_accessor :message @@ -929,10 +775,9 @@ module Google class TestIamPermissionsRequest include Google::Apis::Core::Hashable - # The set of permissions to check for the `resource`. Permissions with - # wildcards (such as '*' or 'storage.*') are not allowed. For more - # information see - # [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions). + # The set of permissions to check for the `resource`. Permissions with wildcards + # (such as '*' or 'storage.*') are not allowed. For more information see [IAM + # Overview](https://cloud.google.com/iam/docs/overview#permissions). # Corresponds to the JSON property `permissions` # @return [Array] attr_accessor :permissions @@ -951,8 +796,7 @@ module Google class TestIamPermissionsResponse include Google::Apis::Core::Hashable - # A subset of `TestPermissionsRequest.permissions` that the caller is - # allowed. + # A subset of `TestPermissionsRequest.permissions` that the caller is allowed. # Corresponds to the JSON property `permissions` # @return [Array] attr_accessor :permissions diff --git a/generated/google/apis/cloudresourcemanager_v2beta1/service.rb b/generated/google/apis/cloudresourcemanager_v2beta1/service.rb index 50978a1fc..226c36634 100644 --- a/generated/google/apis/cloudresourcemanager_v2beta1/service.rb +++ b/generated/google/apis/cloudresourcemanager_v2beta1/service.rb @@ -48,33 +48,27 @@ module Google @batch_path = 'batch' end - # Creates a Folder in the resource hierarchy. - # Returns an Operation which can be used to track the progress of the - # folder creation workflow. - # Upon success the Operation.response field will be populated with the - # created Folder. - # In order to succeed, the addition of this new Folder must not violate - # the Folder naming, height or fanout constraints. - # + The Folder's display_name must be distinct from all other Folder's that - # share its parent. - # + The addition of the Folder must not cause the active Folder hierarchy - # to exceed a height of 4. Note, the full active + deleted Folder hierarchy - # is allowed to reach a height of 8; this provides additional headroom when - # moving folders that contain deleted folders. - # + The addition of the Folder must not cause the total number of Folders - # under its parent to exceed 100. - # If the operation fails due to a folder constraint violation, some errors - # may be returned by the CreateFolder request, with status code - # FAILED_PRECONDITION and an error description. Other folder constraint - # violations will be communicated in the Operation, with the specific - # PreconditionFailure returned via the details list in the Operation.error - # field. + # Creates a Folder in the resource hierarchy. Returns an Operation which can be + # used to track the progress of the folder creation workflow. Upon success the + # Operation.response field will be populated with the created Folder. In order + # to succeed, the addition of this new Folder must not violate the Folder naming, + # height or fanout constraints. + The Folder's display_name must be distinct + # from all other Folder's that share its parent. + The addition of the Folder + # must not cause the active Folder hierarchy to exceed a height of 4. Note, the + # full active + deleted Folder hierarchy is allowed to reach a height of 8; this + # provides additional headroom when moving folders that contain deleted folders. + # + The addition of the Folder must not cause the total number of Folders under + # its parent to exceed 100. If the operation fails due to a folder constraint + # violation, some errors may be returned by the CreateFolder request, with + # status code FAILED_PRECONDITION and an error description. Other folder + # constraint violations will be communicated in the Operation, with the specific + # PreconditionFailure returned via the details list in the Operation.error field. # The caller must have `resourcemanager.folders.create` permission on the # identified parent. # @param [Google::Apis::CloudresourcemanagerV2beta1::Folder] folder_object # @param [String] parent - # Required. The resource name of the new Folder's parent. - # Must be of the form `folders/`folder_id`` or `organizations/`org_id``. + # Required. The resource name of the new Folder's parent. Must be of the form ` + # folders/`folder_id`` or `organizations/`org_id``. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -104,18 +98,14 @@ module Google execute_or_queue_command(command, &block) end - # Requests deletion of a Folder. The Folder is moved into the - # DELETE_REQUESTED state - # immediately, and is deleted approximately 30 days later. This method may - # only be called on an empty Folder in the - # ACTIVE state, where a Folder is empty if - # it doesn't contain any Folders or Projects in the - # ACTIVE state. - # The caller must have `resourcemanager.folders.delete` permission on the - # identified folder. + # Requests deletion of a Folder. The Folder is moved into the DELETE_REQUESTED + # state immediately, and is deleted approximately 30 days later. This method may + # only be called on an empty Folder in the ACTIVE state, where a Folder is empty + # if it doesn't contain any Folders or Projects in the ACTIVE state. The caller + # must have `resourcemanager.folders.delete` permission on the identified folder. # @param [String] name - # Required. the resource name of the Folder to be deleted. - # Must be of the form `folders/`folder_id``. + # Required. the resource name of the Folder to be deleted. Must be of the form ` + # folders/`folder_id``. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -143,14 +133,13 @@ module Google execute_or_queue_command(command, &block) end - # Retrieves a Folder identified by the supplied resource name. - # Valid Folder resource names have the format `folders/`folder_id`` - # (for example, `folders/1234`). - # The caller must have `resourcemanager.folders.get` permission on the + # Retrieves a Folder identified by the supplied resource name. Valid Folder + # resource names have the format `folders/`folder_id`` (for example, `folders/ + # 1234`). The caller must have `resourcemanager.folders.get` permission on the # identified folder. # @param [String] name - # Required. The resource name of the Folder to retrieve. - # Must be of the form `folders/`folder_id``. + # Required. The resource name of the Folder to retrieve. Must be of the form ` + # folders/`folder_id``. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -178,14 +167,13 @@ module Google execute_or_queue_command(command, &block) end - # Gets the access control policy for a Folder. The returned policy may be - # empty if no such policy or resource exists. The `resource` field should - # be the Folder's resource name, e.g. "folders/1234". - # The caller must have `resourcemanager.folders.getIamPolicy` permission - # on the identified folder. + # Gets the access control policy for a Folder. The returned policy may be empty + # if no such policy or resource exists. The `resource` field should be the + # Folder's resource name, e.g. "folders/1234". The caller must have ` + # resourcemanager.folders.getIamPolicy` permission on the identified folder. # @param [String] resource - # REQUIRED: The resource for which the policy is being requested. - # See the operation documentation for the appropriate value for this field. + # REQUIRED: The resource for which the policy is being requested. See the + # operation documentation for the appropriate value for this field. # @param [Google::Apis::CloudresourcemanagerV2beta1::GetIamPolicyRequest] get_iam_policy_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -217,12 +205,10 @@ module Google end # Lists the Folders that are direct descendants of supplied parent resource. - # List provides a strongly consistent view of the Folders underneath - # the specified parent resource. - # List returns Folders sorted based upon the (ascending) lexical ordering - # of their display_name. - # The caller must have `resourcemanager.folders.list` permission on the - # identified parent. + # List provides a strongly consistent view of the Folders underneath the + # specified parent resource. List returns Folders sorted based upon the ( + # ascending) lexical ordering of their display_name. The caller must have ` + # resourcemanager.folders.list` permission on the identified parent. # @param [Fixnum] page_size # Optional. The maximum number of Folders to return in the response. # @param [String] page_token @@ -230,14 +216,12 @@ module Google # that indicates where this listing should continue from. # @param [String] parent # Required. The resource name of the Organization or Folder whose Folders are - # being listed. - # Must be of the form `folders/`folder_id`` or `organizations/`org_id``. - # Access to this method is controlled by checking the - # `resourcemanager.folders.list` permission on the `parent`. + # being listed. Must be of the form `folders/`folder_id`` or `organizations/` + # org_id``. Access to this method is controlled by checking the `resourcemanager. + # folders.list` permission on the `parent`. # @param [Boolean] show_deleted - # Optional. Controls whether Folders in the - # DELETE_REQUESTED - # state should be returned. Defaults to false. + # Optional. Controls whether Folders in the DELETE_REQUESTED state should be + # returned. Defaults to false. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -268,26 +252,21 @@ module Google execute_or_queue_command(command, &block) end - # Moves a Folder under a new resource parent. - # Returns an Operation which can be used to track the progress of the - # folder move workflow. - # Upon success the Operation.response field will be populated with the - # moved Folder. - # Upon failure, a FolderOperationError categorizing the failure cause will - # be returned - if the failure occurs synchronously then the - # FolderOperationError will be returned via the Status.details field - # and if it occurs asynchronously then the FolderOperation will be returned - # via the Operation.error field. - # In addition, the Operation.metadata field will be populated with a - # FolderOperation message as an aid to stateless clients. - # Folder moves will be rejected if they violate either the naming, height - # or fanout constraints described in the - # CreateFolder documentation. - # The caller must have `resourcemanager.folders.move` permission on the - # folder's current and proposed new parent. + # Moves a Folder under a new resource parent. Returns an Operation which can be + # used to track the progress of the folder move workflow. Upon success the + # Operation.response field will be populated with the moved Folder. Upon failure, + # a FolderOperationError categorizing the failure cause will be returned - if + # the failure occurs synchronously then the FolderOperationError will be + # returned via the Status.details field and if it occurs asynchronously then the + # FolderOperation will be returned via the Operation.error field. In addition, + # the Operation.metadata field will be populated with a FolderOperation message + # as an aid to stateless clients. Folder moves will be rejected if they violate + # either the naming, height or fanout constraints described in the CreateFolder + # documentation. The caller must have `resourcemanager.folders.move` permission + # on the folder's current and proposed new parent. # @param [String] name - # Required. The resource name of the Folder to move. - # Must be of the form folders/`folder_id` + # Required. The resource name of the Folder to move. Must be of the form folders/ + # `folder_id` # @param [Google::Apis::CloudresourcemanagerV2beta1::MoveFolderRequest] move_folder_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -318,26 +297,22 @@ module Google execute_or_queue_command(command, &block) end - # Updates a Folder, changing its display_name. - # Changes to the folder display_name will be rejected if they violate either - # the display_name formatting rules or naming constraints described in - # the CreateFolder documentation. - # The Folder's display name must start and end with a letter or digit, - # may contain letters, digits, spaces, hyphens and underscores and can be - # no longer than 30 characters. This is captured by the regular expression: - # [\p`L`\p`N`]([\p`L`\p`N`_- ]`0,28`[\p`L`\p`N`])?. - # The caller must have `resourcemanager.folders.update` permission on the - # identified folder. - # If the update fails due to the unique name constraint then a - # PreconditionFailure explaining this violation will be returned - # in the Status.details field. + # Updates a Folder, changing its display_name. Changes to the folder + # display_name will be rejected if they violate either the display_name + # formatting rules or naming constraints described in the CreateFolder + # documentation. The Folder's display name must start and end with a letter or + # digit, may contain letters, digits, spaces, hyphens and underscores and can be + # no longer than 30 characters. This is captured by the regular expression: [\p` + # L`\p`N`]([\p`L`\p`N`_- ]`0,28`[\p`L`\p`N`])?. The caller must have ` + # resourcemanager.folders.update` permission on the identified folder. If the + # update fails due to the unique name constraint then a PreconditionFailure + # explaining this violation will be returned in the Status.details field. # @param [String] name - # Output only. The resource name of the Folder. - # Its format is `folders/`folder_id``, for example: "folders/1234". + # Output only. The resource name of the Folder. Its format is `folders/` + # folder_id``, for example: "folders/1234". # @param [Google::Apis::CloudresourcemanagerV2beta1::Folder] folder_object # @param [String] update_mask - # Required. Fields to be updated. - # Only the `display_name` can be updated. + # Required. Fields to be updated. Only the `display_name` can be updated. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user @@ -368,11 +343,10 @@ module Google execute_or_queue_command(command, &block) end - # Search for folders that match specific filter criteria. - # Search provides an eventually consistent view of the folders a user has - # access to which meet the specified filter criteria. - # This will only return folders on which the caller has the - # permission `resourcemanager.folders.get`. + # Search for folders that match specific filter criteria. Search provides an + # eventually consistent view of the folders a user has access to which meet the + # specified filter criteria. This will only return folders on which the caller + # has the permission `resourcemanager.folders.get`. # @param [Google::Apis::CloudresourcemanagerV2beta1::SearchFoldersRequest] search_folders_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -402,14 +376,13 @@ module Google execute_or_queue_command(command, &block) end - # Sets the access control policy on a Folder, replacing any existing policy. - # The `resource` field should be the Folder's resource name, e.g. - # "folders/1234". - # The caller must have `resourcemanager.folders.setIamPolicy` permission - # on the identified folder. + # Sets the access control policy on a Folder, replacing any existing policy. The + # `resource` field should be the Folder's resource name, e.g. "folders/1234". + # The caller must have `resourcemanager.folders.setIamPolicy` permission on the + # identified folder. # @param [String] resource - # REQUIRED: The resource for which the policy is being specified. - # See the operation documentation for the appropriate value for this field. + # REQUIRED: The resource for which the policy is being specified. See the + # operation documentation for the appropriate value for this field. # @param [Google::Apis::CloudresourcemanagerV2beta1::SetIamPolicyRequest] set_iam_policy_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -440,13 +413,12 @@ module Google execute_or_queue_command(command, &block) end - # Returns permissions that a caller has on the specified Folder. - # The `resource` field should be the Folder's resource name, - # e.g. "folders/1234". - # There are no permissions required for making this API call. + # Returns permissions that a caller has on the specified Folder. The `resource` + # field should be the Folder's resource name, e.g. "folders/1234". There are no + # permissions required for making this API call. # @param [String] resource - # REQUIRED: The resource for which the policy detail is being requested. - # See the operation documentation for the appropriate value for this field. + # REQUIRED: The resource for which the policy detail is being requested. See the + # operation documentation for the appropriate value for this field. # @param [Google::Apis::CloudresourcemanagerV2beta1::TestIamPermissionsRequest] test_iam_permissions_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -477,19 +449,15 @@ module Google execute_or_queue_command(command, &block) end - # Cancels the deletion request for a Folder. This method may only be - # called on a Folder in the - # DELETE_REQUESTED state. - # In order to succeed, the Folder's parent must be in the - # ACTIVE state. - # In addition, reintroducing the folder into the tree must not violate - # folder naming, height and fanout constraints described in the - # CreateFolder documentation. - # The caller must have `resourcemanager.folders.undelete` permission on the - # identified folder. + # Cancels the deletion request for a Folder. This method may only be called on a + # Folder in the DELETE_REQUESTED state. In order to succeed, the Folder's parent + # must be in the ACTIVE state. In addition, reintroducing the folder into the + # tree must not violate folder naming, height and fanout constraints described + # in the CreateFolder documentation. The caller must have `resourcemanager. + # folders.undelete` permission on the identified folder. # @param [String] name - # Required. The resource name of the Folder to undelete. - # Must be of the form `folders/`folder_id``. + # Required. The resource name of the Folder to undelete. Must be of the form ` + # folders/`folder_id``. # @param [Google::Apis::CloudresourcemanagerV2beta1::UndeleteFolderRequest] undelete_folder_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -520,9 +488,8 @@ module Google execute_or_queue_command(command, &block) end - # 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. + # 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. # @param [String] name # The name of the operation resource. # @param [String] fields diff --git a/generated/google/apis/customsearch_v1.rb b/generated/google/apis/customsearch_v1.rb index 5ad39076a..ac24e0217 100644 --- a/generated/google/apis/customsearch_v1.rb +++ b/generated/google/apis/customsearch_v1.rb @@ -25,7 +25,7 @@ module Google # @see https://developers.google.com/custom-search/v1/introduction module CustomsearchV1 VERSION = 'V1' - REVISION = '20200715' + REVISION = '20200723' end end end diff --git a/generated/google/apis/customsearch_v1/classes.rb b/generated/google/apis/customsearch_v1/classes.rb index 35607e2d3..676886091 100644 --- a/generated/google/apis/customsearch_v1/classes.rb +++ b/generated/google/apis/customsearch_v1/classes.rb @@ -464,9 +464,10 @@ module Google # @return [String] attr_accessor :cr - # The identifier of a custom search engine created using the Custom Search - # [Control Panel](https://cse.google.com/). This is a custom property not - # defined in the OpenSearch spec. This parameter is **required**. + # The identifier of an engine created using the Programmable Search Engine + # [Control Panel](https://programmablesearchengine.google.com/). This is a + # custom property not defined in the OpenSearch spec. This parameter is + # **required**. # Corresponds to the JSON property `cx` # @return [String] attr_accessor :cx @@ -821,9 +822,10 @@ module Google # @return [String] attr_accessor :cr - # The identifier of a custom search engine created using the Custom Search - # [Control Panel](https://cse.google.com/). This is a custom property not - # defined in the OpenSearch spec. This parameter is **required**. + # The identifier of an engine created using the Programmable Search Engine + # [Control Panel](https://programmablesearchengine.google.com/). This is a + # custom property not defined in the OpenSearch spec. This parameter is + # **required**. # Corresponds to the JSON property `cx` # @return [String] attr_accessor :cx @@ -1178,9 +1180,10 @@ module Google # @return [String] attr_accessor :cr - # The identifier of a custom search engine created using the Custom Search - # [Control Panel](https://cse.google.com/). This is a custom property not - # defined in the OpenSearch spec. This parameter is **required**. + # The identifier of an engine created using the Programmable Search Engine + # [Control Panel](https://programmablesearchengine.google.com/). This is a + # custom property not defined in the OpenSearch spec. This parameter is + # **required**. # Corresponds to the JSON property `cx` # @return [String] attr_accessor :cx @@ -1585,7 +1588,8 @@ module Google # @return [String] attr_accessor :template - # The MIME type of the OpenSearch URL template for the Custom Search API. + # The MIME type of the OpenSearch URL template for the Custom Search JSON + # API. # Corresponds to the JSON property `type` # @return [String] attr_accessor :type diff --git a/generated/google/apis/customsearch_v1/service.rb b/generated/google/apis/customsearch_v1/service.rb index d0352fe80..0e91ddc2f 100644 --- a/generated/google/apis/customsearch_v1/service.rb +++ b/generated/google/apis/customsearch_v1/service.rb @@ -47,8 +47,8 @@ module Google @batch_path = 'batch' end - # Returns metadata about the search performed, metadata about the custom - # search engine used for the search, and the search results. + # Returns metadata about the search performed, metadata about the + # engine used for the search, and the search results. # @param [String] c2coff # Enables or disables [Simplified and Traditional Chinese # Search](https://developers.google.com/custom-search/docs/xml_results# @@ -71,7 +71,7 @@ module Google # xml_results_appendices#countryCollections) # page for a list of valid values for this parameter. # @param [String] cx - # The custom search engine ID to use for this request. + # The Programmable Search Engine ID to use for this request. # @param [String] date_restrict # Restricts results to URLs based on date. Supported values include: # * `d[number]`: requests results from the specified number of past days. @@ -326,8 +326,8 @@ module Google execute_or_queue_command(command, &block) end - # Returns metadata about the search performed, metadata about the custom - # search engine used for the search, and the search results. Uses a small set + # Returns metadata about the search performed, metadata about the + # engine used for the search, and the search results. Uses a small set # of url patterns. # @param [String] c2coff # Enables or disables [Simplified and Traditional Chinese @@ -351,7 +351,7 @@ module Google # xml_results_appendices#countryCollections) # page for a list of valid values for this parameter. # @param [String] cx - # The custom search engine ID to use for this request. + # The Programmable Search Engine ID to use for this request. # @param [String] date_restrict # Restricts results to URLs based on date. Supported values include: # * `d[number]`: requests results from the specified number of past days. diff --git a/generated/google/apis/dataflow_v1b3.rb b/generated/google/apis/dataflow_v1b3.rb index 6b6b46183..88f581b1b 100644 --- a/generated/google/apis/dataflow_v1b3.rb +++ b/generated/google/apis/dataflow_v1b3.rb @@ -25,7 +25,7 @@ module Google # @see https://cloud.google.com/dataflow module DataflowV1b3 VERSION = 'V1b3' - REVISION = '20200703' + REVISION = '20200713' # View and manage your data across Google Cloud Platform services AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform' diff --git a/generated/google/apis/dataflow_v1b3/classes.rb b/generated/google/apis/dataflow_v1b3/classes.rb index 3ba927add..64136dc77 100644 --- a/generated/google/apis/dataflow_v1b3/classes.rb +++ b/generated/google/apis/dataflow_v1b3/classes.rb @@ -2038,7 +2038,8 @@ module Google attr_accessor :start_time # Exactly one of step or steps_location should be specified. - # The top-level steps that constitute the entire job. + # The top-level steps that constitute the entire job. Only retrieved with + # JOB_VIEW_ALL. # Corresponds to the JSON property `steps` # @return [Array] attr_accessor :steps diff --git a/generated/google/apis/displayvideo_v1.rb b/generated/google/apis/displayvideo_v1.rb index ff82ce9e3..6b5acc518 100644 --- a/generated/google/apis/displayvideo_v1.rb +++ b/generated/google/apis/displayvideo_v1.rb @@ -26,7 +26,7 @@ module Google # @see https://developers.google.com/display-video/ module DisplayvideoV1 VERSION = 'V1' - REVISION = '20200723' + REVISION = '20200724' # Create, see, edit, and permanently delete your Display & Video 360 entities and reports AUTH_DISPLAY_VIDEO = 'https://www.googleapis.com/auth/display-video' @@ -34,6 +34,9 @@ module Google # Create, see, and edit Display & Video 360 Campaign entities and see billing invoices AUTH_DISPLAY_VIDEO_MEDIAPLANNING = 'https://www.googleapis.com/auth/display-video-mediaplanning' + # New Service: https://www.googleapis.com/auth/display-video-user-management + AUTH_DISPLAY_VIDEO_USER_MANAGEMENT = 'https://www.googleapis.com/auth/display-video-user-management' + # View and manage your reports in DoubleClick Bid Manager AUTH_DOUBLECLICKBIDMANAGER = 'https://www.googleapis.com/auth/doubleclickbidmanager' end diff --git a/generated/google/apis/displayvideo_v1/classes.rb b/generated/google/apis/displayvideo_v1/classes.rb index efef7342d..e4d145a31 100644 --- a/generated/google/apis/displayvideo_v1/classes.rb +++ b/generated/google/apis/displayvideo_v1/classes.rb @@ -985,6 +985,44 @@ module Google end end + # A single assigned user role, which defines a user's authorized interaction + # with a specified partner or advertiser. + class AssignedUserRole + include Google::Apis::Core::Hashable + + # The ID of the advertiser that the assigend user role applies to. + # Corresponds to the JSON property `advertiserId` + # @return [Fixnum] + attr_accessor :advertiser_id + + # Output only. The ID of the assigned user role. + # Corresponds to the JSON property `assignedUserRoleId` + # @return [String] + attr_accessor :assigned_user_role_id + + # The ID of the partner that the assigned user role applies to. + # Corresponds to the JSON property `partnerId` + # @return [Fixnum] + attr_accessor :partner_id + + # Required. The user role to assign to a user for the entity. + # Corresponds to the JSON property `userRole` + # @return [String] + attr_accessor :user_role + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @advertiser_id = args[:advertiser_id] if args.key?(:advertiser_id) + @assigned_user_role_id = args[:assigned_user_role_id] if args.key?(:assigned_user_role_id) + @partner_id = args[:partner_id] if args.key?(:partner_id) + @user_role = args[:user_role] if args.key?(:user_role) + end + end + # Assigned audience group targeting option details. This will be populated in # the details field of an AssignedTargetingOption when targeting_type is ` # TARGETING_TYPE_AUDIENCE_GROUP`. The relation between each group is UNION, @@ -1074,6 +1112,41 @@ module Google end end + # Response message for AdvertiserService.AuditAdvertiser. + class AuditAdvertiserResponse + include Google::Apis::Core::Hashable + + # The number of ACTIVE and PAUSED campaigns under this advertiser. These + # campaigns count towards the limit of 9,999 campaigns per advertiser. + # Corresponds to the JSON property `usedCampaignsCount` + # @return [Fixnum] + attr_accessor :used_campaigns_count + + # The number of ACTIVE, PAUSED and DRAFT insertion orders under this advertiser. + # These insertion orders count towards the limit of 9,999 insertion orders per + # advertiser. + # Corresponds to the JSON property `usedInsertionOrdersCount` + # @return [Fixnum] + attr_accessor :used_insertion_orders_count + + # The number of ACTIVE, PAUSED, and DRAFT line items under this advertiser. + # These line items count towards the limit of 9,999 line items per advertiser. + # Corresponds to the JSON property `usedLineItemsCount` + # @return [Fixnum] + attr_accessor :used_line_items_count + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @used_campaigns_count = args[:used_campaigns_count] if args.key?(:used_campaigns_count) + @used_insertion_orders_count = args[:used_insertion_orders_count] if args.key?(:used_insertion_orders_count) + @used_line_items_count = args[:used_line_items_count] if args.key?(:used_line_items_count) + end + end + # Represents an assigned authorized seller status. This will be populated in the # details field of an AssignedTargetingOption when targeting_type is ` # TARGETING_TYPE_AUTHORIZED_SELLER_STATUS`. @@ -1368,6 +1441,54 @@ module Google end end + # Request message for BulkEditAssignedUserRoles. + class BulkEditAssignedUserRolesRequest + include Google::Apis::Core::Hashable + + # The assigned user roles to create in batch, specified as a list of + # AssignedUserRoles. + # Corresponds to the JSON property `createdAssignedUserRoles` + # @return [Array] + attr_accessor :created_assigned_user_roles + + # The assigned user roles to delete in batch, specified as a list of + # assigned_user_role_ids. The format of assigned_user_role_id is `entityType- + # entityid`, for example `partner-123`. + # Corresponds to the JSON property `deletedAssignedUserRoles` + # @return [Array] + attr_accessor :deleted_assigned_user_roles + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @created_assigned_user_roles = args[:created_assigned_user_roles] if args.key?(:created_assigned_user_roles) + @deleted_assigned_user_roles = args[:deleted_assigned_user_roles] if args.key?(:deleted_assigned_user_roles) + end + end + + # Response message for BulkEditAssignedUserRoles. + class BulkEditAssignedUserRolesResponse + include Google::Apis::Core::Hashable + + # The list of assigned user roles that have been successfully created. This list + # will be absent if empty. + # Corresponds to the JSON property `createdAssignedUserRoles` + # @return [Array] + attr_accessor :created_assigned_user_roles + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @created_assigned_user_roles = args[:created_assigned_user_roles] if args.key?(:created_assigned_user_roles) + end + end + # Request message for BulkEditLineItemAssignedTargetingOptions. class BulkEditLineItemAssignedTargetingOptionsRequest include Google::Apis::Core::Hashable @@ -1462,6 +1583,55 @@ module Google end end + # Request message for BulkEditPartnerAssignedTargetingOptions. + class BulkEditPartnerAssignedTargetingOptionsRequest + include Google::Apis::Core::Hashable + + # The assigned targeting options to create in batch, specified as a list of ` + # CreateAssignedTargetingOptionsRequest`. Supported targeting types: * ` + # TARGETING_TYPE_CHANNEL` + # Corresponds to the JSON property `createRequests` + # @return [Array] + attr_accessor :create_requests + + # The assigned targeting options to delete in batch, specified as a list of ` + # DeleteAssignedTargetingOptionsRequest`. Supported targeting types: * ` + # TARGETING_TYPE_CHANNEL` + # Corresponds to the JSON property `deleteRequests` + # @return [Array] + attr_accessor :delete_requests + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @create_requests = args[:create_requests] if args.key?(:create_requests) + @delete_requests = args[:delete_requests] if args.key?(:delete_requests) + end + end + + # + class BulkEditPartnerAssignedTargetingOptionsResponse + include Google::Apis::Core::Hashable + + # The list of assigned targeting options that have been successfully created. + # This list will be absent if empty. + # Corresponds to the JSON property `createdAssignedTargetingOptions` + # @return [Array] + attr_accessor :created_assigned_targeting_options + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @created_assigned_targeting_options = args[:created_assigned_targeting_options] if args.key?(:created_assigned_targeting_options) + end + end + # Request message for SiteService.BulkEditSites. class BulkEditSitesRequest include Google::Apis::Core::Hashable @@ -3439,6 +3609,65 @@ module Google end end + # Settings that control which exchanges are enabled for a partner. + class ExchangeConfig + include Google::Apis::Core::Hashable + + # All enabled exchanges in the partner. Duplicate enabled exchanges will be + # ignored. + # Corresponds to the JSON property `enabledExchanges` + # @return [Array] + attr_accessor :enabled_exchanges + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @enabled_exchanges = args[:enabled_exchanges] if args.key?(:enabled_exchanges) + end + end + + # An enabled exchange in the partner. + class ExchangeConfigEnabledExchange + include Google::Apis::Core::Hashable + + # The enabled exchange. + # Corresponds to the JSON property `exchange` + # @return [String] + attr_accessor :exchange + + # Output only. Agency ID of Google Ad Manager. The field is only relevant when + # Google Ad Manager is the enabled exchange. + # Corresponds to the JSON property `googleAdManagerAgencyId` + # @return [String] + attr_accessor :google_ad_manager_agency_id + + # Output only. Network ID of Google Ad Manager. The field is only relevant when + # Google Ad Manager is the enabled exchange. + # Corresponds to the JSON property `googleAdManagerBuyerNetworkId` + # @return [String] + attr_accessor :google_ad_manager_buyer_network_id + + # Output only. Seat ID of the enabled exchange. + # Corresponds to the JSON property `seatId` + # @return [String] + attr_accessor :seat_id + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @exchange = args[:exchange] if args.key?(:exchange) + @google_ad_manager_agency_id = args[:google_ad_manager_agency_id] if args.key?(:google_ad_manager_agency_id) + @google_ad_manager_buyer_network_id = args[:google_ad_manager_buyer_network_id] if args.key?(:google_ad_manager_buyer_network_id) + @seat_id = args[:seat_id] if args.key?(:seat_id) + end + end + # Exchange review status for the creative. class ExchangeReviewStatus include Google::Apis::Core::Hashable @@ -5589,6 +5818,61 @@ module Google end end + # Response message for ListPartnerAssignedTargetingOptions. + class ListPartnerAssignedTargetingOptionsResponse + include Google::Apis::Core::Hashable + + # The list of assigned targeting options. This list will be absent if empty. + # Corresponds to the JSON property `assignedTargetingOptions` + # @return [Array] + attr_accessor :assigned_targeting_options + + # A token identifying the next page of results. This value should be specified + # as the pageToken in a subsequent ListPartnerAssignedTargetingOptionsRequest to + # fetch the next page of results. This token will be absent if there are no more + # assigned_targeting_options to return. + # Corresponds to the JSON property `nextPageToken` + # @return [String] + attr_accessor :next_page_token + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @assigned_targeting_options = args[:assigned_targeting_options] if args.key?(:assigned_targeting_options) + @next_page_token = args[:next_page_token] if args.key?(:next_page_token) + end + end + + # Response message for ListPartners. + class ListPartnersResponse + include Google::Apis::Core::Hashable + + # A token to retrieve the next page of results. Pass this value in the + # page_token field in the subsequent call to `ListPartners` method to retrieve + # the next page of results. + # Corresponds to the JSON property `nextPageToken` + # @return [String] + attr_accessor :next_page_token + + # The list of partners. This list will be absent if empty. + # Corresponds to the JSON property `partners` + # @return [Array] + attr_accessor :partners + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @next_page_token = args[:next_page_token] if args.key?(:next_page_token) + @partners = args[:partners] if args.key?(:partners) + end + end + # Response message for SiteService.ListSites. class ListSitesResponse include Google::Apis::Core::Hashable @@ -5643,6 +5927,34 @@ module Google end end + # Response message for ListUsers. + class ListUsersResponse + include Google::Apis::Core::Hashable + + # A token to retrieve the next page of results. Pass this value in the + # page_token field in the subsequent call to `ListUsers` method to retrieve the + # next page of results. This token will be absent if there are no more results + # to return. + # Corresponds to the JSON property `nextPageToken` + # @return [String] + attr_accessor :next_page_token + + # The list of users. This list will be absent if empty. + # Corresponds to the JSON property `users` + # @return [Array] + attr_accessor :users + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @next_page_token = args[:next_page_token] if args.key?(:next_page_token) + @users = args[:users] if args.key?(:users) + end + end + # A list of locations used for targeting. class LocationList include Google::Apis::Core::Hashable @@ -5748,6 +6060,33 @@ module Google end end + # Measurement settings of a partner. + class MeasurementConfig + include Google::Apis::Core::Hashable + + # Whether or not to report DV360 cost to CM. + # Corresponds to the JSON property `dv360ToCmCostReportingEnabled` + # @return [Boolean] + attr_accessor :dv360_to_cm_cost_reporting_enabled + alias_method :dv360_to_cm_cost_reporting_enabled?, :dv360_to_cm_cost_reporting_enabled + + # Whether or not to include DV360 data in CM data transfer reports. + # Corresponds to the JSON property `dv360ToCmDataSharingEnabled` + # @return [Boolean] + attr_accessor :dv360_to_cm_data_sharing_enabled + alias_method :dv360_to_cm_data_sharing_enabled?, :dv360_to_cm_data_sharing_enabled + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @dv360_to_cm_cost_reporting_enabled = args[:dv360_to_cm_cost_reporting_enabled] if args.key?(:dv360_to_cm_cost_reporting_enabled) + @dv360_to_cm_data_sharing_enabled = args[:dv360_to_cm_data_sharing_enabled] if args.key?(:dv360_to_cm_data_sharing_enabled) + end + end + # Represents an amount of money with its currency type. class Money include Google::Apis::Core::Hashable @@ -6240,6 +6579,94 @@ module Google end end + # A single partner in Display & Video 360 (DV360). + class Partner + include Google::Apis::Core::Hashable + + # Ad server related settings of a partner. + # Corresponds to the JSON property `adServerConfig` + # @return [Google::Apis::DisplayvideoV1::PartnerAdServerConfig] + attr_accessor :ad_server_config + + # Settings that control how partner related data may be accessed. + # Corresponds to the JSON property `dataAccessConfig` + # @return [Google::Apis::DisplayvideoV1::PartnerDataAccessConfig] + attr_accessor :data_access_config + + # The display name of the partner. Must be UTF-8 encoded with a maximum size of + # 240 bytes. + # Corresponds to the JSON property `displayName` + # @return [String] + attr_accessor :display_name + + # Output only. The status of the partner. + # Corresponds to the JSON property `entityStatus` + # @return [String] + attr_accessor :entity_status + + # Settings that control which exchanges are enabled for a partner. + # Corresponds to the JSON property `exchangeConfig` + # @return [Google::Apis::DisplayvideoV1::ExchangeConfig] + attr_accessor :exchange_config + + # General settings of a partner. + # Corresponds to the JSON property `generalConfig` + # @return [Google::Apis::DisplayvideoV1::PartnerGeneralConfig] + attr_accessor :general_config + + # Output only. The resource name of the partner. + # Corresponds to the JSON property `name` + # @return [String] + attr_accessor :name + + # Output only. The unique ID of the partner. Assigned by the system. + # Corresponds to the JSON property `partnerId` + # @return [Fixnum] + attr_accessor :partner_id + + # Output only. The timestamp when the partner was last updated. Assigned by the + # system. + # Corresponds to the JSON property `updateTime` + # @return [String] + attr_accessor :update_time + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @ad_server_config = args[:ad_server_config] if args.key?(:ad_server_config) + @data_access_config = args[:data_access_config] if args.key?(:data_access_config) + @display_name = args[:display_name] if args.key?(:display_name) + @entity_status = args[:entity_status] if args.key?(:entity_status) + @exchange_config = args[:exchange_config] if args.key?(:exchange_config) + @general_config = args[:general_config] if args.key?(:general_config) + @name = args[:name] if args.key?(:name) + @partner_id = args[:partner_id] if args.key?(:partner_id) + @update_time = args[:update_time] if args.key?(:update_time) + end + end + + # Ad server related settings of a partner. + class PartnerAdServerConfig + include Google::Apis::Core::Hashable + + # Measurement settings of a partner. + # Corresponds to the JSON property `measurementConfig` + # @return [Google::Apis::DisplayvideoV1::MeasurementConfig] + attr_accessor :measurement_config + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @measurement_config = args[:measurement_config] if args.key?(:measurement_config) + end + end + # Settings that control a partner cost. A partner cost is any type of expense # involved in running a campaign, other than the costs of purchasing impressions # (which is called the media cost) and using third-party audience segment data ( @@ -6294,6 +6721,52 @@ module Google end end + # Settings that control how partner related data may be accessed. + class PartnerDataAccessConfig + include Google::Apis::Core::Hashable + + # Structured Data File (SDF) related settings. + # Corresponds to the JSON property `sdfConfig` + # @return [Google::Apis::DisplayvideoV1::SdfConfig] + attr_accessor :sdf_config + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @sdf_config = args[:sdf_config] if args.key?(:sdf_config) + end + end + + # General settings of a partner. + class PartnerGeneralConfig + include Google::Apis::Core::Hashable + + # Immutable. Partner's currency in ISO 4217 format. + # Corresponds to the JSON property `currencyCode` + # @return [String] + attr_accessor :currency_code + + # Immutable. The standard TZ database name of the partner's time zone. For + # example, `America/New_York`. See more at: https://en.wikipedia.org/wiki/ + # List_of_tz_database_time_zones + # Corresponds to the JSON property `timeZone` + # @return [String] + attr_accessor :time_zone + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @currency_code = args[:currency_code] if args.key?(:currency_code) + @time_zone = args[:time_zone] if args.key?(:time_zone) + end + end + # Settings that control how partner revenue is calculated. class PartnerRevenueModel include Google::Apis::Core::Hashable @@ -7365,6 +7838,51 @@ module Google end end + # A single user in Display & Video 360. + class User + include Google::Apis::Core::Hashable + + # The assigned user roles. Required in CreateUser. Output only in UpdateUser. + # Can only be updated through BulkEditAssignedUserRoles. + # Corresponds to the JSON property `assignedUserRoles` + # @return [Array] + attr_accessor :assigned_user_roles + + # Required. The display name of the user. Must be UTF-8 encoded with a maximum + # size of 240 bytes. + # Corresponds to the JSON property `displayName` + # @return [String] + attr_accessor :display_name + + # Required. Immutable. The email address used to identify the user. + # Corresponds to the JSON property `email` + # @return [String] + attr_accessor :email + + # Output only. The resource name of the user. + # Corresponds to the JSON property `name` + # @return [String] + attr_accessor :name + + # Output only. The unique ID of the user. Assigned by the system. + # Corresponds to the JSON property `userId` + # @return [Fixnum] + attr_accessor :user_id + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @assigned_user_roles = args[:assigned_user_roles] if args.key?(:assigned_user_roles) + @display_name = args[:display_name] if args.key?(:display_name) + @email = args[:email] if args.key?(:email) + @name = args[:name] if args.key?(:name) + @user_id = args[:user_id] if args.key?(:user_id) + end + end + # User rewarded content targeting option details. This will be populated in the # user_rewarded_content_details field when targeting_type is ` # TARGETING_TYPE_USER_REWARDED_CONTENT`. diff --git a/generated/google/apis/displayvideo_v1/representations.rb b/generated/google/apis/displayvideo_v1/representations.rb index 44613bc0c..1c0e2fc73 100644 --- a/generated/google/apis/displayvideo_v1/representations.rb +++ b/generated/google/apis/displayvideo_v1/representations.rb @@ -136,6 +136,12 @@ module Google include Google::Apis::Core::JsonObjectSupport end + class AssignedUserRole + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + class AudienceGroupAssignedTargetingOptionDetails class Representation < Google::Apis::Core::JsonRepresentation; end @@ -148,6 +154,12 @@ module Google include Google::Apis::Core::JsonObjectSupport end + class AuditAdvertiserResponse + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + class AuthorizedSellerStatusAssignedTargetingOptionDetails class Representation < Google::Apis::Core::JsonRepresentation; end @@ -214,6 +226,18 @@ module Google include Google::Apis::Core::JsonObjectSupport end + class BulkEditAssignedUserRolesRequest + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + + class BulkEditAssignedUserRolesResponse + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + class BulkEditLineItemAssignedTargetingOptionsRequest class Representation < Google::Apis::Core::JsonRepresentation; end @@ -238,6 +262,18 @@ module Google include Google::Apis::Core::JsonObjectSupport end + class BulkEditPartnerAssignedTargetingOptionsRequest + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + + class BulkEditPartnerAssignedTargetingOptionsResponse + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + class BulkEditSitesRequest class Representation < Google::Apis::Core::JsonRepresentation; end @@ -562,6 +598,18 @@ module Google include Google::Apis::Core::JsonObjectSupport end + class ExchangeConfig + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + + class ExchangeConfigEnabledExchange + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + class ExchangeReviewStatus class Representation < Google::Apis::Core::JsonRepresentation; end @@ -910,6 +958,18 @@ module Google include Google::Apis::Core::JsonObjectSupport end + class ListPartnerAssignedTargetingOptionsResponse + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + + class ListPartnersResponse + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + class ListSitesResponse class Representation < Google::Apis::Core::JsonRepresentation; end @@ -922,6 +982,12 @@ module Google include Google::Apis::Core::JsonObjectSupport end + class ListUsersResponse + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + class LocationList class Representation < Google::Apis::Core::JsonRepresentation; end @@ -940,6 +1006,12 @@ module Google include Google::Apis::Core::JsonObjectSupport end + class MeasurementConfig + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + class Money class Representation < Google::Apis::Core::JsonRepresentation; end @@ -1024,12 +1096,36 @@ module Google include Google::Apis::Core::JsonObjectSupport end + class Partner + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + + class PartnerAdServerConfig + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + class PartnerCost class Representation < Google::Apis::Core::JsonRepresentation; end include Google::Apis::Core::JsonObjectSupport end + class PartnerDataAccessConfig + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + + class PartnerGeneralConfig + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + class PartnerRevenueModel class Representation < Google::Apis::Core::JsonRepresentation; end @@ -1192,6 +1288,12 @@ module Google include Google::Apis::Core::JsonObjectSupport end + class User + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + class UserRewardedContentAssignedTargetingOptionDetails class Representation < Google::Apis::Core::JsonRepresentation; end @@ -1482,6 +1584,16 @@ module Google end end + class AssignedUserRole + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :advertiser_id, :numeric_string => true, as: 'advertiserId' + property :assigned_user_role_id, as: 'assignedUserRoleId' + property :partner_id, :numeric_string => true, as: 'partnerId' + property :user_role, as: 'userRole' + end + end + class AudienceGroupAssignedTargetingOptionDetails # @private class Representation < Google::Apis::Core::JsonRepresentation @@ -1508,6 +1620,15 @@ module Google end end + class AuditAdvertiserResponse + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :used_campaigns_count, :numeric_string => true, as: 'usedCampaignsCount' + property :used_insertion_orders_count, :numeric_string => true, as: 'usedInsertionOrdersCount' + property :used_line_items_count, :numeric_string => true, as: 'usedLineItemsCount' + end + end + class AuthorizedSellerStatusAssignedTargetingOptionDetails # @private class Representation < Google::Apis::Core::JsonRepresentation @@ -1605,6 +1726,23 @@ module Google end end + class BulkEditAssignedUserRolesRequest + # @private + class Representation < Google::Apis::Core::JsonRepresentation + collection :created_assigned_user_roles, as: 'createdAssignedUserRoles', class: Google::Apis::DisplayvideoV1::AssignedUserRole, decorator: Google::Apis::DisplayvideoV1::AssignedUserRole::Representation + + collection :deleted_assigned_user_roles, as: 'deletedAssignedUserRoles' + end + end + + class BulkEditAssignedUserRolesResponse + # @private + class Representation < Google::Apis::Core::JsonRepresentation + collection :created_assigned_user_roles, as: 'createdAssignedUserRoles', class: Google::Apis::DisplayvideoV1::AssignedUserRole, decorator: Google::Apis::DisplayvideoV1::AssignedUserRole::Representation + + end + end + class BulkEditLineItemAssignedTargetingOptionsRequest # @private class Representation < Google::Apis::Core::JsonRepresentation @@ -1640,6 +1778,24 @@ module Google end end + class BulkEditPartnerAssignedTargetingOptionsRequest + # @private + class Representation < Google::Apis::Core::JsonRepresentation + collection :create_requests, as: 'createRequests', class: Google::Apis::DisplayvideoV1::CreateAssignedTargetingOptionsRequest, decorator: Google::Apis::DisplayvideoV1::CreateAssignedTargetingOptionsRequest::Representation + + collection :delete_requests, as: 'deleteRequests', class: Google::Apis::DisplayvideoV1::DeleteAssignedTargetingOptionsRequest, decorator: Google::Apis::DisplayvideoV1::DeleteAssignedTargetingOptionsRequest::Representation + + end + end + + class BulkEditPartnerAssignedTargetingOptionsResponse + # @private + class Representation < Google::Apis::Core::JsonRepresentation + collection :created_assigned_targeting_options, as: 'createdAssignedTargetingOptions', class: Google::Apis::DisplayvideoV1::AssignedTargetingOption, decorator: Google::Apis::DisplayvideoV1::AssignedTargetingOption::Representation + + end + end + class BulkEditSitesRequest # @private class Representation < Google::Apis::Core::JsonRepresentation @@ -2174,6 +2330,24 @@ module Google end end + class ExchangeConfig + # @private + class Representation < Google::Apis::Core::JsonRepresentation + collection :enabled_exchanges, as: 'enabledExchanges', class: Google::Apis::DisplayvideoV1::ExchangeConfigEnabledExchange, decorator: Google::Apis::DisplayvideoV1::ExchangeConfigEnabledExchange::Representation + + end + end + + class ExchangeConfigEnabledExchange + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :exchange, as: 'exchange' + property :google_ad_manager_agency_id, as: 'googleAdManagerAgencyId' + property :google_ad_manager_buyer_network_id, as: 'googleAdManagerBuyerNetworkId' + property :seat_id, as: 'seatId' + end + end + class ExchangeReviewStatus # @private class Representation < Google::Apis::Core::JsonRepresentation @@ -2763,6 +2937,24 @@ module Google end end + class ListPartnerAssignedTargetingOptionsResponse + # @private + class Representation < Google::Apis::Core::JsonRepresentation + collection :assigned_targeting_options, as: 'assignedTargetingOptions', class: Google::Apis::DisplayvideoV1::AssignedTargetingOption, decorator: Google::Apis::DisplayvideoV1::AssignedTargetingOption::Representation + + property :next_page_token, as: 'nextPageToken' + end + end + + class ListPartnersResponse + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :next_page_token, as: 'nextPageToken' + collection :partners, as: 'partners', class: Google::Apis::DisplayvideoV1::Partner, decorator: Google::Apis::DisplayvideoV1::Partner::Representation + + end + end + class ListSitesResponse # @private class Representation < Google::Apis::Core::JsonRepresentation @@ -2781,6 +2973,15 @@ module Google end end + class ListUsersResponse + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :next_page_token, as: 'nextPageToken' + collection :users, as: 'users', class: Google::Apis::DisplayvideoV1::User, decorator: Google::Apis::DisplayvideoV1::User::Representation + + end + end + class LocationList # @private class Representation < Google::Apis::Core::JsonRepresentation @@ -2808,6 +3009,14 @@ module Google end end + class MeasurementConfig + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :dv360_to_cm_cost_reporting_enabled, as: 'dv360ToCmCostReportingEnabled' + property :dv360_to_cm_data_sharing_enabled, as: 'dv360ToCmDataSharingEnabled' + end + end + class Money # @private class Representation < Google::Apis::Core::JsonRepresentation @@ -2934,6 +3143,33 @@ module Google end end + class Partner + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :ad_server_config, as: 'adServerConfig', class: Google::Apis::DisplayvideoV1::PartnerAdServerConfig, decorator: Google::Apis::DisplayvideoV1::PartnerAdServerConfig::Representation + + property :data_access_config, as: 'dataAccessConfig', class: Google::Apis::DisplayvideoV1::PartnerDataAccessConfig, decorator: Google::Apis::DisplayvideoV1::PartnerDataAccessConfig::Representation + + property :display_name, as: 'displayName' + property :entity_status, as: 'entityStatus' + property :exchange_config, as: 'exchangeConfig', class: Google::Apis::DisplayvideoV1::ExchangeConfig, decorator: Google::Apis::DisplayvideoV1::ExchangeConfig::Representation + + property :general_config, as: 'generalConfig', class: Google::Apis::DisplayvideoV1::PartnerGeneralConfig, decorator: Google::Apis::DisplayvideoV1::PartnerGeneralConfig::Representation + + property :name, as: 'name' + property :partner_id, :numeric_string => true, as: 'partnerId' + property :update_time, as: 'updateTime' + end + end + + class PartnerAdServerConfig + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :measurement_config, as: 'measurementConfig', class: Google::Apis::DisplayvideoV1::MeasurementConfig, decorator: Google::Apis::DisplayvideoV1::MeasurementConfig::Representation + + end + end + class PartnerCost # @private class Representation < Google::Apis::Core::JsonRepresentation @@ -2945,6 +3181,22 @@ module Google end end + class PartnerDataAccessConfig + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :sdf_config, as: 'sdfConfig', class: Google::Apis::DisplayvideoV1::SdfConfig, decorator: Google::Apis::DisplayvideoV1::SdfConfig::Representation + + end + end + + class PartnerGeneralConfig + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :currency_code, as: 'currencyCode' + property :time_zone, as: 'timeZone' + end + end + class PartnerRevenueModel # @private class Representation < Google::Apis::Core::JsonRepresentation @@ -3234,6 +3486,18 @@ module Google end end + class User + # @private + class Representation < Google::Apis::Core::JsonRepresentation + collection :assigned_user_roles, as: 'assignedUserRoles', class: Google::Apis::DisplayvideoV1::AssignedUserRole, decorator: Google::Apis::DisplayvideoV1::AssignedUserRole::Representation + + property :display_name, as: 'displayName' + property :email, as: 'email' + property :name, as: 'name' + property :user_id, :numeric_string => true, as: 'userId' + end + end + class UserRewardedContentAssignedTargetingOptionDetails # @private class Representation < Google::Apis::Core::JsonRepresentation diff --git a/generated/google/apis/displayvideo_v1/service.rb b/generated/google/apis/displayvideo_v1/service.rb index 251a2e658..8f7e06be0 100644 --- a/generated/google/apis/displayvideo_v1/service.rb +++ b/generated/google/apis/displayvideo_v1/service.rb @@ -48,6 +48,43 @@ module Google @batch_path = 'batch' end + # Audits an advertiser. Returns the counts of used entities per resource type + # under the advertiser provided. Used entities count towards their [respective + # resource limit]: (https://support.google.com/displayvideo/answer/6071450?hl=en) + # @param [Fixnum] advertiser_id + # Required. The ID of the advertiser to audit. + # @param [String] read_mask + # Optional. The specific fields to return. If no mask is specified, all fields + # in the response proto will be filled. Valid values are: * usedLineItemsCount * + # usedInsertionOrdersCount * usedCampaignsCount + # @param [String] fields + # Selector specifying which fields to include in a partial response. + # @param [String] quota_user + # 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. + # @param [Google::Apis::RequestOptions] options + # Request-specific options + # + # @yield [result, err] Result & error if block supplied + # @yieldparam result [Google::Apis::DisplayvideoV1::AuditAdvertiserResponse] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::DisplayvideoV1::AuditAdvertiserResponse] + # + # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried + # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification + # @raise [Google::Apis::AuthorizationError] Authorization is required + def audit_advertiser(advertiser_id, read_mask: nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:get, 'v1/advertisers/{+advertiserId}:audit', options) + command.response_representation = Google::Apis::DisplayvideoV1::AuditAdvertiserResponse::Representation + command.response_class = Google::Apis::DisplayvideoV1::AuditAdvertiserResponse + command.params['advertiserId'] = advertiser_id unless advertiser_id.nil? + command.query['readMask'] = read_mask unless read_mask.nil? + command.query['fields'] = fields unless fields.nil? + command.query['quotaUser'] = quota_user unless quota_user.nil? + execute_or_queue_command(command, &block) + end + # Bulk edits targeting options under a single advertiser. The operation will # delete the assigned targeting options provided in # BulkEditAdvertiserAssignedTargetingOptionsRequest.delete_requests and then @@ -1560,14 +1597,17 @@ module Google # expressions are made up of one or more restrictions. * Restrictions can be # combined by `AND` or `OR` logical operators. A sequence of restrictions # implicitly uses `AND`. * A restriction has the form of ``field` `operator` ` - # value``. * The operator must be `EQUALS (=)`. * Supported fields: - ` - # campaignId` - `insertionOrderId` - `entityStatus` - `lineItemType` Examples: * - # All line items under an insertion order: `insertionOrderId="1234"` * All ` + # value``. * The operator used on `flight.dateRange.endDate` must be LESS THAN (< + # ). * The operators used on all other fields must be `EQUALS (=)`. * Supported + # fields: - `campaignId` - `insertionOrderId` - `entityStatus` - `lineItemType` - + # `flight.dateRange.endDate` (input formatted as YYYY-MM-DD) Examples: * All + # line items under an insertion order: `insertionOrderId="1234"` * All ` # ENTITY_STATUS_ACTIVE` or `ENTITY_STATUS_PAUSED` and ` # LINE_ITEM_TYPE_DISPLAY_DEFAULT` line items under an advertiser: `(entityStatus= # "ENTITY_STATUS_ACTIVE" OR entityStatus="ENTITY_STATUS_PAUSED") AND - # lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT"` The length of this field should - # be no more than 500 characters. + # lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT"` * All line items whose flight + # dates end before March 28, 2019: `flight.dateRange.endDate<"2019-03-28"` The + # length of this field should be no more than 500 characters. # @param [String] order_by # Field by which to sort the list. Acceptable values are: * "displayName" ( # default) * "entityStatus" * “flight.dateRange.endDate” The default sorting @@ -3710,6 +3750,126 @@ module Google execute_or_queue_command(command, &block) end + # Bulk edits targeting options under a single partner. The operation will delete + # the assigned targeting options provided in + # BulkEditPartnerAssignedTargetingOptionsRequest.delete_requests and then create + # the assigned targeting options provided in + # BulkEditPartnerAssignedTargetingOptionsRequest.create_requests . + # @param [Fixnum] partner_id + # Required. The ID of the partner. + # @param [Google::Apis::DisplayvideoV1::BulkEditPartnerAssignedTargetingOptionsRequest] bulk_edit_partner_assigned_targeting_options_request_object + # @param [String] fields + # Selector specifying which fields to include in a partial response. + # @param [String] quota_user + # 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. + # @param [Google::Apis::RequestOptions] options + # Request-specific options + # + # @yield [result, err] Result & error if block supplied + # @yieldparam result [Google::Apis::DisplayvideoV1::BulkEditPartnerAssignedTargetingOptionsResponse] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::DisplayvideoV1::BulkEditPartnerAssignedTargetingOptionsResponse] + # + # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried + # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification + # @raise [Google::Apis::AuthorizationError] Authorization is required + def bulk_edit_partner_assigned_targeting_options(partner_id, bulk_edit_partner_assigned_targeting_options_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:post, 'v1/partners/{+partnerId}:bulkEditPartnerAssignedTargetingOptions', options) + command.request_representation = Google::Apis::DisplayvideoV1::BulkEditPartnerAssignedTargetingOptionsRequest::Representation + command.request_object = bulk_edit_partner_assigned_targeting_options_request_object + command.response_representation = Google::Apis::DisplayvideoV1::BulkEditPartnerAssignedTargetingOptionsResponse::Representation + command.response_class = Google::Apis::DisplayvideoV1::BulkEditPartnerAssignedTargetingOptionsResponse + command.params['partnerId'] = partner_id unless partner_id.nil? + command.query['fields'] = fields unless fields.nil? + command.query['quotaUser'] = quota_user unless quota_user.nil? + execute_or_queue_command(command, &block) + end + + # Gets a partner. + # @param [Fixnum] partner_id + # Required. The ID of the partner to fetch. + # @param [String] fields + # Selector specifying which fields to include in a partial response. + # @param [String] quota_user + # 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. + # @param [Google::Apis::RequestOptions] options + # Request-specific options + # + # @yield [result, err] Result & error if block supplied + # @yieldparam result [Google::Apis::DisplayvideoV1::Partner] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::DisplayvideoV1::Partner] + # + # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried + # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification + # @raise [Google::Apis::AuthorizationError] Authorization is required + def get_partner(partner_id, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:get, 'v1/partners/{+partnerId}', options) + command.response_representation = Google::Apis::DisplayvideoV1::Partner::Representation + command.response_class = Google::Apis::DisplayvideoV1::Partner + command.params['partnerId'] = partner_id unless partner_id.nil? + command.query['fields'] = fields unless fields.nil? + command.query['quotaUser'] = quota_user unless quota_user.nil? + execute_or_queue_command(command, &block) + end + + # Lists partners that are accessible to the current user. The order is defined + # by the order_by parameter. + # @param [String] filter + # Allows filtering by partner properties. Supported syntax: * Filter expressions + # are made up of one or more restrictions. * Restrictions can be combined by ` + # AND` or `OR` logical operators. A sequence of restrictions implicitly uses ` + # AND`. * A restriction has the form of ``field` `operator` `value``. * The + # operator must be `EQUALS (=)`. * Supported fields: - `entityStatus` Examples: * + # All active partners: `entityStatus="ENTITY_STATUS_ACTIVE"` The length of this + # field should be no more than 500 characters. + # @param [String] order_by + # Field by which to sort the list. Acceptable values are: * `displayName` The + # default sorting order is ascending. To specify descending order for a field, a + # suffix "desc" should be added to the field name. For example, `displayName + # desc`. + # @param [Fixnum] page_size + # Requested page size. Must be between `1` and `100`. If unspecified will + # default to `100`. + # @param [String] page_token + # A token identifying a page of results the server should return. Typically, + # this is the value of next_page_token returned from the previous call to ` + # ListPartners` method. If not specified, the first page of results will be + # returned. + # @param [String] fields + # Selector specifying which fields to include in a partial response. + # @param [String] quota_user + # 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. + # @param [Google::Apis::RequestOptions] options + # Request-specific options + # + # @yield [result, err] Result & error if block supplied + # @yieldparam result [Google::Apis::DisplayvideoV1::ListPartnersResponse] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::DisplayvideoV1::ListPartnersResponse] + # + # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried + # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification + # @raise [Google::Apis::AuthorizationError] Authorization is required + def list_partners(filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:get, 'v1/partners', options) + command.response_representation = Google::Apis::DisplayvideoV1::ListPartnersResponse::Representation + command.response_class = Google::Apis::DisplayvideoV1::ListPartnersResponse + command.query['filter'] = filter unless filter.nil? + command.query['orderBy'] = order_by unless order_by.nil? + command.query['pageSize'] = page_size unless page_size.nil? + command.query['pageToken'] = page_token unless page_token.nil? + command.query['fields'] = fields unless fields.nil? + command.query['quotaUser'] = quota_user unless quota_user.nil? + execute_or_queue_command(command, &block) + end + # Creates a new channel. Returns the newly created channel if successful. # @param [Fixnum] partner_id # The ID of the partner that owns the created channel. @@ -4058,6 +4218,179 @@ module Google execute_or_queue_command(command, &block) end + # Assigns a targeting option to a partner. Returns the assigned targeting option + # if successful. + # @param [Fixnum] partner_id + # Required. The ID of the partner. + # @param [String] targeting_type + # Required. Identifies the type of this assigned targeting option. Supported + # targeting types: * `TARGETING_TYPE_CHANNEL` + # @param [Google::Apis::DisplayvideoV1::AssignedTargetingOption] assigned_targeting_option_object + # @param [String] fields + # Selector specifying which fields to include in a partial response. + # @param [String] quota_user + # 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. + # @param [Google::Apis::RequestOptions] options + # Request-specific options + # + # @yield [result, err] Result & error if block supplied + # @yieldparam result [Google::Apis::DisplayvideoV1::AssignedTargetingOption] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::DisplayvideoV1::AssignedTargetingOption] + # + # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried + # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification + # @raise [Google::Apis::AuthorizationError] Authorization is required + def create_partner_targeting_type_assigned_targeting_option(partner_id, targeting_type, assigned_targeting_option_object = nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:post, 'v1/partners/{+partnerId}/targetingTypes/{+targetingType}/assignedTargetingOptions', options) + command.request_representation = Google::Apis::DisplayvideoV1::AssignedTargetingOption::Representation + command.request_object = assigned_targeting_option_object + command.response_representation = Google::Apis::DisplayvideoV1::AssignedTargetingOption::Representation + command.response_class = Google::Apis::DisplayvideoV1::AssignedTargetingOption + command.params['partnerId'] = partner_id unless partner_id.nil? + command.params['targetingType'] = targeting_type unless targeting_type.nil? + command.query['fields'] = fields unless fields.nil? + command.query['quotaUser'] = quota_user unless quota_user.nil? + execute_or_queue_command(command, &block) + end + + # Deletes an assigned targeting option from a partner. + # @param [Fixnum] partner_id + # Required. The ID of the partner. + # @param [String] targeting_type + # Required. Identifies the type of this assigned targeting option. Supported + # targeting types: * `TARGETING_TYPE_CHANNEL` + # @param [String] assigned_targeting_option_id + # Required. The ID of the assigned targeting option to delete. + # @param [String] fields + # Selector specifying which fields to include in a partial response. + # @param [String] quota_user + # 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. + # @param [Google::Apis::RequestOptions] options + # Request-specific options + # + # @yield [result, err] Result & error if block supplied + # @yieldparam result [Google::Apis::DisplayvideoV1::Empty] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::DisplayvideoV1::Empty] + # + # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried + # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification + # @raise [Google::Apis::AuthorizationError] Authorization is required + def delete_partner_targeting_type_assigned_targeting_option(partner_id, targeting_type, assigned_targeting_option_id, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:delete, 'v1/partners/{+partnerId}/targetingTypes/{+targetingType}/assignedTargetingOptions/{+assignedTargetingOptionId}', options) + command.response_representation = Google::Apis::DisplayvideoV1::Empty::Representation + command.response_class = Google::Apis::DisplayvideoV1::Empty + command.params['partnerId'] = partner_id unless partner_id.nil? + command.params['targetingType'] = targeting_type unless targeting_type.nil? + command.params['assignedTargetingOptionId'] = assigned_targeting_option_id unless assigned_targeting_option_id.nil? + command.query['fields'] = fields unless fields.nil? + command.query['quotaUser'] = quota_user unless quota_user.nil? + execute_or_queue_command(command, &block) + end + + # Gets a single targeting option assigned to a partner. + # @param [Fixnum] partner_id + # Required. The ID of the partner. + # @param [String] targeting_type + # Required. Identifies the type of this assigned targeting option. Supported + # targeting types: * `TARGETING_TYPE_CHANNEL` + # @param [String] assigned_targeting_option_id + # Required. An identifier unique to the targeting type in this partner that + # identifies the assigned targeting option being requested. + # @param [String] fields + # Selector specifying which fields to include in a partial response. + # @param [String] quota_user + # 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. + # @param [Google::Apis::RequestOptions] options + # Request-specific options + # + # @yield [result, err] Result & error if block supplied + # @yieldparam result [Google::Apis::DisplayvideoV1::AssignedTargetingOption] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::DisplayvideoV1::AssignedTargetingOption] + # + # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried + # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification + # @raise [Google::Apis::AuthorizationError] Authorization is required + def get_partner_targeting_type_assigned_targeting_option(partner_id, targeting_type, assigned_targeting_option_id, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:get, 'v1/partners/{+partnerId}/targetingTypes/{+targetingType}/assignedTargetingOptions/{+assignedTargetingOptionId}', options) + command.response_representation = Google::Apis::DisplayvideoV1::AssignedTargetingOption::Representation + command.response_class = Google::Apis::DisplayvideoV1::AssignedTargetingOption + command.params['partnerId'] = partner_id unless partner_id.nil? + command.params['targetingType'] = targeting_type unless targeting_type.nil? + command.params['assignedTargetingOptionId'] = assigned_targeting_option_id unless assigned_targeting_option_id.nil? + command.query['fields'] = fields unless fields.nil? + command.query['quotaUser'] = quota_user unless quota_user.nil? + execute_or_queue_command(command, &block) + end + + # Lists the targeting options assigned to a partner. + # @param [Fixnum] partner_id + # Required. The ID of the partner. + # @param [String] targeting_type + # Required. Identifies the type of assigned targeting options to list. Supported + # targeting types: * `TARGETING_TYPE_CHANNEL` + # @param [String] filter + # Allows filtering by assigned targeting option properties. Supported syntax: * + # Filter expressions are made up of one or more restrictions. * Restrictions can + # be combined by the logical operator `OR`. * A restriction has the form of `` + # field` `operator` `value``. * The operator must be `EQUALS (=)`. * Supported + # fields: - `assignedTargetingOptionId` Examples: * AssignedTargetingOption with + # ID 123456 `assignedTargetingOptionId="123456"` The length of this field should + # be no more than 500 characters. + # @param [String] order_by + # Field by which to sort the list. Acceptable values are: * ` + # assignedTargetingOptionId` (default) The default sorting order is ascending. + # To specify descending order for a field, a suffix "desc" should be added to + # the field name. Example: `assignedTargetingOptionId desc`. + # @param [Fixnum] page_size + # Requested page size. Must be between `1` and `100`. If unspecified will + # default to `100`. Returns error code `INVALID_ARGUMENT` if an invalid value is + # specified. + # @param [String] page_token + # A token identifying a page of results the server should return. Typically, + # this is the value of next_page_token returned from the previous call to ` + # ListPartnerAssignedTargetingOptions` method. If not specified, the first page + # of results will be returned. + # @param [String] fields + # Selector specifying which fields to include in a partial response. + # @param [String] quota_user + # 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. + # @param [Google::Apis::RequestOptions] options + # Request-specific options + # + # @yield [result, err] Result & error if block supplied + # @yieldparam result [Google::Apis::DisplayvideoV1::ListPartnerAssignedTargetingOptionsResponse] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::DisplayvideoV1::ListPartnerAssignedTargetingOptionsResponse] + # + # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried + # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification + # @raise [Google::Apis::AuthorizationError] Authorization is required + def list_partner_targeting_type_assigned_targeting_options(partner_id, targeting_type, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:get, 'v1/partners/{+partnerId}/targetingTypes/{+targetingType}/assignedTargetingOptions', options) + command.response_representation = Google::Apis::DisplayvideoV1::ListPartnerAssignedTargetingOptionsResponse::Representation + command.response_class = Google::Apis::DisplayvideoV1::ListPartnerAssignedTargetingOptionsResponse + command.params['partnerId'] = partner_id unless partner_id.nil? + command.params['targetingType'] = targeting_type unless targeting_type.nil? + command.query['filter'] = filter unless filter.nil? + command.query['orderBy'] = order_by unless order_by.nil? + command.query['pageSize'] = page_size unless page_size.nil? + command.query['pageToken'] = page_token unless page_token.nil? + command.query['fields'] = fields unless fields.nil? + command.query['quotaUser'] = quota_user unless quota_user.nil? + execute_or_queue_command(command, &block) + end + # Creates an SDF Download Task. Returns an Operation. An SDF Download Task is a # long-running, asynchronous operation. The metadata type of this operation is # SdfDownloadTaskMetadata. If the request is successful, the response type of @@ -4218,6 +4551,235 @@ module Google command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end + + # Bulk edits user roles for a user. The operation will delete the assigned user + # roles provided in BulkEditAssignedUserRolesRequest.deleted_assigned_user_roles + # and then assign the user roles provided in BulkEditAssignedUserRolesRequest. + # created_assigned_user_roles. + # @param [Fixnum] user_id + # Required. The ID of the user to which the assigned user roles belong. + # @param [Google::Apis::DisplayvideoV1::BulkEditAssignedUserRolesRequest] bulk_edit_assigned_user_roles_request_object + # @param [String] fields + # Selector specifying which fields to include in a partial response. + # @param [String] quota_user + # 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. + # @param [Google::Apis::RequestOptions] options + # Request-specific options + # + # @yield [result, err] Result & error if block supplied + # @yieldparam result [Google::Apis::DisplayvideoV1::BulkEditAssignedUserRolesResponse] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::DisplayvideoV1::BulkEditAssignedUserRolesResponse] + # + # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried + # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification + # @raise [Google::Apis::AuthorizationError] Authorization is required + def bulk_edit_assigned_user_roles(user_id, bulk_edit_assigned_user_roles_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:post, 'v1/users/{+userId}:bulkEditAssignedUserRoles', options) + command.request_representation = Google::Apis::DisplayvideoV1::BulkEditAssignedUserRolesRequest::Representation + command.request_object = bulk_edit_assigned_user_roles_request_object + command.response_representation = Google::Apis::DisplayvideoV1::BulkEditAssignedUserRolesResponse::Representation + command.response_class = Google::Apis::DisplayvideoV1::BulkEditAssignedUserRolesResponse + command.params['userId'] = user_id unless user_id.nil? + command.query['fields'] = fields unless fields.nil? + command.query['quotaUser'] = quota_user unless quota_user.nil? + execute_or_queue_command(command, &block) + end + + # Creates a new user. Returns the newly created user if successful. + # @param [Google::Apis::DisplayvideoV1::User] user_object + # @param [String] fields + # Selector specifying which fields to include in a partial response. + # @param [String] quota_user + # 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. + # @param [Google::Apis::RequestOptions] options + # Request-specific options + # + # @yield [result, err] Result & error if block supplied + # @yieldparam result [Google::Apis::DisplayvideoV1::User] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::DisplayvideoV1::User] + # + # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried + # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification + # @raise [Google::Apis::AuthorizationError] Authorization is required + def create_user(user_object = nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:post, 'v1/users', options) + command.request_representation = Google::Apis::DisplayvideoV1::User::Representation + command.request_object = user_object + command.response_representation = Google::Apis::DisplayvideoV1::User::Representation + command.response_class = Google::Apis::DisplayvideoV1::User + command.query['fields'] = fields unless fields.nil? + command.query['quotaUser'] = quota_user unless quota_user.nil? + execute_or_queue_command(command, &block) + end + + # Deletes a user. + # @param [Fixnum] user_id + # Required. The ID of the user to delete. + # @param [String] fields + # Selector specifying which fields to include in a partial response. + # @param [String] quota_user + # 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. + # @param [Google::Apis::RequestOptions] options + # Request-specific options + # + # @yield [result, err] Result & error if block supplied + # @yieldparam result [Google::Apis::DisplayvideoV1::Empty] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::DisplayvideoV1::Empty] + # + # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried + # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification + # @raise [Google::Apis::AuthorizationError] Authorization is required + def delete_user(user_id, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:delete, 'v1/users/{+userId}', options) + command.response_representation = Google::Apis::DisplayvideoV1::Empty::Representation + command.response_class = Google::Apis::DisplayvideoV1::Empty + command.params['userId'] = user_id unless user_id.nil? + command.query['fields'] = fields unless fields.nil? + command.query['quotaUser'] = quota_user unless quota_user.nil? + execute_or_queue_command(command, &block) + end + + # Gets a user. + # @param [Fixnum] user_id + # Required. The ID of the user to fetch. + # @param [String] fields + # Selector specifying which fields to include in a partial response. + # @param [String] quota_user + # 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. + # @param [Google::Apis::RequestOptions] options + # Request-specific options + # + # @yield [result, err] Result & error if block supplied + # @yieldparam result [Google::Apis::DisplayvideoV1::User] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::DisplayvideoV1::User] + # + # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried + # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification + # @raise [Google::Apis::AuthorizationError] Authorization is required + def get_user(user_id, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:get, 'v1/users/{+userId}', options) + command.response_representation = Google::Apis::DisplayvideoV1::User::Representation + command.response_class = Google::Apis::DisplayvideoV1::User + command.params['userId'] = user_id unless user_id.nil? + command.query['fields'] = fields unless fields.nil? + command.query['quotaUser'] = quota_user unless quota_user.nil? + execute_or_queue_command(command, &block) + end + + # Lists users that are accessible to the current user. If two users have user + # roles on the same partner or advertiser, they can access each other. + # @param [String] filter + # Allows filtering by user properties. Supported syntax: * Filter expressions + # are made up of one or more restrictions. * Restrictions can be combined by the + # logical operator `AND`. * A restriction has the form of ``field` `operator` ` + # value``. * The operator must be `CONTAINS (:)` or `EQUALS (=)`. * The operator + # must be `CONTAINS (:)` for the following fields: - `displayName` - `email` * + # The operator must be `EQUALS (=)` for the following fields: - ` + # assignedUserRole.userRole` - `assignedUserRole.partnerId` - `assignedUserRole. + # advertiserId` - `assignedUserRole.entityType`: A synthetic field of + # AssignedUserRole used for filtering. Identifies the type of entity to which + # the user role is assigned. Valid values are `Partner` and `Advertiser`. - ` + # assignedUserRole.parentPartnerId`: A synthetic field of AssignedUserRole used + # for filtering. Identifies the parent partner of the entity to which the user + # role is assigned." Examples: * The user with displayName containing `foo`: ` + # displayName:"foo"` * The user with email containing `bar`: `email:"bar"` * All + # users with standard user roles: `assignedUserRole.userRole="STANDARD"` * All + # users with user roles for partner 123: `assignedUserRole.partnerId="123"` * + # All users with user roles for advertiser 123: `assignedUserRole.advertiserId=" + # 123"` * All users with partner level user roles: `entityType="PARTNER"` * All + # users with user roles for partner 123 and advertisers under partner 123: ` + # parentPartnerId="123"` The length of this field should be no more than 500 + # characters. + # @param [String] order_by + # Field by which to sort the list. Acceptable values are: * `displayName` ( + # default) The default sorting order is ascending. To specify descending order + # for a field, a suffix "desc" should be added to the field name. For example, ` + # displayName desc`. + # @param [Fixnum] page_size + # Requested page size. Must be between `1` and `100`. If unspecified will + # default to `100`. + # @param [String] page_token + # A token identifying a page of results the server should return. Typically, + # this is the value of next_page_token returned from the previous call to ` + # ListUsers` method. If not specified, the first page of results will be + # returned. + # @param [String] fields + # Selector specifying which fields to include in a partial response. + # @param [String] quota_user + # 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. + # @param [Google::Apis::RequestOptions] options + # Request-specific options + # + # @yield [result, err] Result & error if block supplied + # @yieldparam result [Google::Apis::DisplayvideoV1::ListUsersResponse] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::DisplayvideoV1::ListUsersResponse] + # + # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried + # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification + # @raise [Google::Apis::AuthorizationError] Authorization is required + def list_users(filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:get, 'v1/users', options) + command.response_representation = Google::Apis::DisplayvideoV1::ListUsersResponse::Representation + command.response_class = Google::Apis::DisplayvideoV1::ListUsersResponse + command.query['filter'] = filter unless filter.nil? + command.query['orderBy'] = order_by unless order_by.nil? + command.query['pageSize'] = page_size unless page_size.nil? + command.query['pageToken'] = page_token unless page_token.nil? + command.query['fields'] = fields unless fields.nil? + command.query['quotaUser'] = quota_user unless quota_user.nil? + execute_or_queue_command(command, &block) + end + + # Updates an existing user. Returns the updated user if successful. + # @param [Fixnum] user_id + # Output only. The unique ID of the user. Assigned by the system. + # @param [Google::Apis::DisplayvideoV1::User] user_object + # @param [String] update_mask + # Required. The mask to control which fields to update. + # @param [String] fields + # Selector specifying which fields to include in a partial response. + # @param [String] quota_user + # 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. + # @param [Google::Apis::RequestOptions] options + # Request-specific options + # + # @yield [result, err] Result & error if block supplied + # @yieldparam result [Google::Apis::DisplayvideoV1::User] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::DisplayvideoV1::User] + # + # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried + # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification + # @raise [Google::Apis::AuthorizationError] Authorization is required + def patch_user(user_id, user_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:patch, 'v1/users/{+userId}', options) + command.request_representation = Google::Apis::DisplayvideoV1::User::Representation + command.request_object = user_object + command.response_representation = Google::Apis::DisplayvideoV1::User::Representation + command.response_class = Google::Apis::DisplayvideoV1::User + command.params['userId'] = user_id unless user_id.nil? + command.query['updateMask'] = update_mask unless update_mask.nil? + command.query['fields'] = fields unless fields.nil? + command.query['quotaUser'] = quota_user unless quota_user.nil? + execute_or_queue_command(command, &block) + end protected diff --git a/generated/google/apis/redis_v1beta1.rb b/generated/google/apis/redis_v1beta1.rb index 6250c6976..ec9a38c31 100644 --- a/generated/google/apis/redis_v1beta1.rb +++ b/generated/google/apis/redis_v1beta1.rb @@ -25,7 +25,7 @@ module Google # @see https://cloud.google.com/memorystore/docs/redis/ module RedisV1beta1 VERSION = 'V1beta1' - REVISION = '20200706' + REVISION = '20200722' # View and manage your data across Google Cloud Platform services AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform' diff --git a/generated/google/apis/redis_v1beta1/classes.rb b/generated/google/apis/redis_v1beta1/classes.rb index 7765556e8..006c03be0 100644 --- a/generated/google/apis/redis_v1beta1/classes.rb +++ b/generated/google/apis/redis_v1beta1/classes.rb @@ -217,6 +217,403 @@ module Google end end + # + class GoogleCloudSaasacceleratorManagementProvidersV1Instance + include Google::Apis::Core::Hashable + + # consumer_defined_name is the name that is set by the consumer. On the other + # hand Name field represents system-assigned id of an instance so consumers + # are not necessarily aware of it. + # consumer_defined_name is used for notification/UI purposes for consumer to + # recognize their instances. + # Corresponds to the JSON property `consumerDefinedName` + # @return [String] + attr_accessor :consumer_defined_name + + # Output only. Timestamp when the resource was created. + # Corresponds to the JSON property `createTime` + # @return [String] + attr_accessor :create_time + + # Optional. Resource labels to represent user provided metadata. Each label + # is a key-value pair, where both the key and the value are arbitrary strings + # provided by the user. + # Corresponds to the JSON property `labels` + # @return [Hash] + attr_accessor :labels + + # The MaintenancePolicies that have been attached to the instance. + # The key must be of the type name of the oneof policy name defined in + # MaintenancePolicy, and the referenced policy must define the same policy + # type. For complete details of MaintenancePolicy, please refer to + # go/cloud-saas-mw-ug. + # Corresponds to the JSON property `maintenancePolicyNames` + # @return [Hash] + attr_accessor :maintenance_policy_names + + # The MaintenanceSchedule contains the scheduling information of published + # maintenance schedule. + # Corresponds to the JSON property `maintenanceSchedules` + # @return [Hash] + attr_accessor :maintenance_schedules + + # Maintenance settings associated with instance. Allows service producers and + # end users to assign settings that controls maintenance on this instance. + # Corresponds to the JSON property `maintenanceSettings` + # @return [Google::Apis::RedisV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSettings] + attr_accessor :maintenance_settings + + # Unique name of the resource. It uses the form: + # `projects/`project_id`/locations/`location_id`/instances/`instance_id`` + # Corresponds to the JSON property `name` + # @return [String] + attr_accessor :name + + # Output only. Custom string attributes used primarily to expose + # producer-specific information in monitoring dashboards. + # See go/get-instance-metadata. + # Corresponds to the JSON property `producerMetadata` + # @return [Hash] + attr_accessor :producer_metadata + + # Output only. The list of data plane resources provisioned for this + # instance, e.g. compute VMs. See go/get-instance-metadata. + # Corresponds to the JSON property `provisionedResources` + # @return [Array] + attr_accessor :provisioned_resources + + # Link to the SLM instance template. Only populated when updating SLM + # instances via SSA's Actuation service adaptor. + # Service producers with custom control plane (e.g. Cloud SQL) doesn't + # need to populate this field. Instead they should use software_versions. + # Corresponds to the JSON property `slmInstanceTemplate` + # @return [String] + attr_accessor :slm_instance_template + + # SloMetadata contains resources required for proper SLO classification of the + # instance. + # Corresponds to the JSON property `sloMetadata` + # @return [Google::Apis::RedisV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata] + attr_accessor :slo_metadata + + # Software versions that are used to deploy this instance. This can be + # mutated by rollout services. + # Corresponds to the JSON property `softwareVersions` + # @return [Hash] + attr_accessor :software_versions + + # Output only. Current lifecycle state of the resource (e.g. if it's being + # created or ready to use). + # Corresponds to the JSON property `state` + # @return [String] + attr_accessor :state + + # Output only. ID of the associated GCP tenant project. + # See go/get-instance-metadata. + # Corresponds to the JSON property `tenantProjectId` + # @return [String] + attr_accessor :tenant_project_id + + # Output only. Timestamp when the resource was last modified. + # Corresponds to the JSON property `updateTime` + # @return [String] + attr_accessor :update_time + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @consumer_defined_name = args[:consumer_defined_name] if args.key?(:consumer_defined_name) + @create_time = args[:create_time] if args.key?(:create_time) + @labels = args[:labels] if args.key?(:labels) + @maintenance_policy_names = args[:maintenance_policy_names] if args.key?(:maintenance_policy_names) + @maintenance_schedules = args[:maintenance_schedules] if args.key?(:maintenance_schedules) + @maintenance_settings = args[:maintenance_settings] if args.key?(:maintenance_settings) + @name = args[:name] if args.key?(:name) + @producer_metadata = args[:producer_metadata] if args.key?(:producer_metadata) + @provisioned_resources = args[:provisioned_resources] if args.key?(:provisioned_resources) + @slm_instance_template = args[:slm_instance_template] if args.key?(:slm_instance_template) + @slo_metadata = args[:slo_metadata] if args.key?(:slo_metadata) + @software_versions = args[:software_versions] if args.key?(:software_versions) + @state = args[:state] if args.key?(:state) + @tenant_project_id = args[:tenant_project_id] if args.key?(:tenant_project_id) + @update_time = args[:update_time] if args.key?(:update_time) + end + end + + # Maintenance schedule which is exposed to customer and potentially end user, + # indicating published upcoming future maintenance schedule + class GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSchedule + include Google::Apis::Core::Hashable + + # Can this scheduled update be rescheduled? + # By default, it's true and API needs to do explicitly check whether it's + # set, if it's set as false explicitly, it's false + # Corresponds to the JSON property `canReschedule` + # @return [Boolean] + attr_accessor :can_reschedule + alias_method :can_reschedule?, :can_reschedule + + # The scheduled end time for the maintenance. + # Corresponds to the JSON property `endTime` + # @return [String] + attr_accessor :end_time + + # The rollout management policy this maintenance schedule is associated + # with. When doing reschedule update request, the reschedule should be + # against this given policy. + # Corresponds to the JSON property `rolloutManagementPolicy` + # @return [String] + attr_accessor :rollout_management_policy + + # The scheduled start time for the maintenance. + # Corresponds to the JSON property `startTime` + # @return [String] + attr_accessor :start_time + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @can_reschedule = args[:can_reschedule] if args.key?(:can_reschedule) + @end_time = args[:end_time] if args.key?(:end_time) + @rollout_management_policy = args[:rollout_management_policy] if args.key?(:rollout_management_policy) + @start_time = args[:start_time] if args.key?(:start_time) + end + end + + # Maintenance settings associated with instance. Allows service producers and + # end users to assign settings that controls maintenance on this instance. + class GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSettings + include Google::Apis::Core::Hashable + + # Optional. Exclude instance from maintenance. When true, rollout service will + # not + # attempt maintenance on the instance. Rollout service will include the + # instance in reported rollout progress as not attempted. + # Corresponds to the JSON property `exclude` + # @return [Boolean] + attr_accessor :exclude + alias_method :exclude?, :exclude + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @exclude = args[:exclude] if args.key?(:exclude) + end + end + + # Node information for custom per-node SLO implementations. + # SSA does not support per-node SLO, but producers can populate per-node + # information in SloMetadata for custom precomputations. + # SSA Eligibility Exporter will emit per-node metric based on this information. + class GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata + include Google::Apis::Core::Hashable + + # By default node is eligible if instance is eligible. + # But individual node might be excluded from SLO by adding entry here. + # For semantic see SloMetadata.exclusions. + # If both instance and node level exclusions are present for time period, + # the node level's reason will be reported by Eligibility Exporter. + # Corresponds to the JSON property `exclusions` + # @return [Array] + attr_accessor :exclusions + + # The location of the node, if different from instance location. + # Corresponds to the JSON property `location` + # @return [String] + attr_accessor :location + + # The id of the node. + # This should be equal to SaasInstanceNode.node_id. + # Corresponds to the JSON property `nodeId` + # @return [String] + attr_accessor :node_id + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @exclusions = args[:exclusions] if args.key?(:exclusions) + @location = args[:location] if args.key?(:location) + @node_id = args[:node_id] if args.key?(:node_id) + end + end + + # Describes provisioned dataplane resources. + class GoogleCloudSaasacceleratorManagementProvidersV1ProvisionedResource + include Google::Apis::Core::Hashable + + # Type of the resource. This can be either a GCP resource or a custom one + # (e.g. another cloud provider's VM). For GCP compute resources use singular + # form of the names listed in GCP compute API documentation + # (https://cloud.google.com/compute/docs/reference/rest/v1/), prefixed with + # 'compute-', for example: 'compute-instance', 'compute-disk', + # 'compute-autoscaler'. + # Corresponds to the JSON property `resourceType` + # @return [String] + attr_accessor :resource_type + + # URL identifying the resource, e.g. + # "https://www.googleapis.com/compute/v1/projects/...)". + # Corresponds to the JSON property `resourceUrl` + # @return [String] + attr_accessor :resource_url + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @resource_type = args[:resource_type] if args.key?(:resource_type) + @resource_url = args[:resource_url] if args.key?(:resource_url) + end + end + + # SloEligibility is a tuple containing eligibility value: true if an instance + # is eligible for SLO calculation or false if it should be excluded from all + # SLO-related calculations along with a user-defined reason. + class GoogleCloudSaasacceleratorManagementProvidersV1SloEligibility + include Google::Apis::Core::Hashable + + # Whether an instance is eligible or ineligible. + # Corresponds to the JSON property `eligible` + # @return [Boolean] + attr_accessor :eligible + alias_method :eligible?, :eligible + + # User-defined reason for the current value of instance eligibility. Usually, + # this can be directly mapped to the internal state. An empty reason is + # allowed. + # Corresponds to the JSON property `reason` + # @return [String] + attr_accessor :reason + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @eligible = args[:eligible] if args.key?(:eligible) + @reason = args[:reason] if args.key?(:reason) + end + end + + # SloExclusion represents an exclusion in SLI calculation applies to all SLOs. + class GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion + include Google::Apis::Core::Hashable + + # Exclusion duration. No restrictions on the possible values. + # When an ongoing operation is taking longer than initially expected, + # an existing entry in the exclusion list can be updated by extending the + # duration. This is supported by the subsystem exporting eligibility data + # as long as such extension is committed at least 10 minutes before the + # original exclusion expiration - otherwise it is possible that there will + # be "gaps" in the exclusion application in the exported timeseries. + # Corresponds to the JSON property `duration` + # @return [String] + attr_accessor :duration + + # Human-readable reason for the exclusion. + # This should be a static string (e.g. "Disruptive update in progress") + # and should not contain dynamically generated data (e.g. instance name). + # Can be left empty. + # Corresponds to the JSON property `reason` + # @return [String] + attr_accessor :reason + + # Name of an SLI that this exclusion applies to. Can be left empty, + # signaling that the instance should be excluded from all SLIs defined + # in the service SLO configuration. + # Corresponds to the JSON property `sliName` + # @return [String] + attr_accessor :sli_name + + # Start time of the exclusion. No alignment (e.g. to a full minute) needed. + # Corresponds to the JSON property `startTime` + # @return [String] + attr_accessor :start_time + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @duration = args[:duration] if args.key?(:duration) + @reason = args[:reason] if args.key?(:reason) + @sli_name = args[:sli_name] if args.key?(:sli_name) + @start_time = args[:start_time] if args.key?(:start_time) + end + end + + # SloMetadata contains resources required for proper SLO classification of the + # instance. + class GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata + include Google::Apis::Core::Hashable + + # SloEligibility is a tuple containing eligibility value: true if an instance + # is eligible for SLO calculation or false if it should be excluded from all + # SLO-related calculations along with a user-defined reason. + # Corresponds to the JSON property `eligibility` + # @return [Google::Apis::RedisV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1SloEligibility] + attr_accessor :eligibility + + # List of SLO exclusion windows. When multiple entries in the list match + # (matching the exclusion time-window against current time point) + # the exclusion reason used in the first matching entry will be published. + # It is not needed to include expired exclusion in this list, as only the + # currently applicable exclusions are taken into account by the eligibility + # exporting subsystem (the historical state of exclusions will be reflected + # in the historically produced timeseries regardless of the current state). + # This field can be used to mark the instance as temporary ineligible + # for the purpose of SLO calculation. For permanent instance SLO exclusion, + # use of custom instance eligibility is recommended. See 'eligibility' field + # below. + # Corresponds to the JSON property `exclusions` + # @return [Array] + attr_accessor :exclusions + + # Optional. List of nodes. + # Some producers need to use per-node metadata to calculate SLO. + # This field allows such producers to publish per-node SLO meta data, + # which will be consumed by SSA Eligibility Exporter and published in the + # form of per node metric to Monarch. + # Corresponds to the JSON property `nodes` + # @return [Array] + attr_accessor :nodes + + # Name of the SLO tier the Instance belongs to. This name will be expected to + # match the tiers specified in the service SLO configuration. + # Field is mandatory and must not be empty. + # Corresponds to the JSON property `tier` + # @return [String] + attr_accessor :tier + + def initialize(**args) + update!(**args) + end + + # Update properties of this object + def update!(**args) + @eligibility = args[:eligibility] if args.key?(:eligibility) + @exclusions = args[:exclusions] if args.key?(:exclusions) + @nodes = args[:nodes] if args.key?(:nodes) + @tier = args[:tier] if args.key?(:tier) + end + end + # Request for Import. class ImportInstanceRequest include Google::Apis::Core::Hashable diff --git a/generated/google/apis/redis_v1beta1/representations.rb b/generated/google/apis/redis_v1beta1/representations.rb index c4e57631f..210899ca6 100644 --- a/generated/google/apis/redis_v1beta1/representations.rb +++ b/generated/google/apis/redis_v1beta1/representations.rb @@ -70,6 +70,54 @@ module Google include Google::Apis::Core::JsonObjectSupport end + class GoogleCloudSaasacceleratorManagementProvidersV1Instance + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + + class GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSchedule + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + + class GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSettings + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + + class GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + + class GoogleCloudSaasacceleratorManagementProvidersV1ProvisionedResource + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + + class GoogleCloudSaasacceleratorManagementProvidersV1SloEligibility + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + + class GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + + class GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata + class Representation < Google::Apis::Core::JsonRepresentation; end + + include Google::Apis::Core::JsonObjectSupport + end + class ImportInstanceRequest class Representation < Google::Apis::Core::JsonRepresentation; end @@ -198,6 +246,97 @@ module Google end end + class GoogleCloudSaasacceleratorManagementProvidersV1Instance + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :consumer_defined_name, as: 'consumerDefinedName' + property :create_time, as: 'createTime' + hash :labels, as: 'labels' + hash :maintenance_policy_names, as: 'maintenancePolicyNames' + hash :maintenance_schedules, as: 'maintenanceSchedules', class: Google::Apis::RedisV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSchedule, decorator: Google::Apis::RedisV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSchedule::Representation + + property :maintenance_settings, as: 'maintenanceSettings', class: Google::Apis::RedisV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSettings, decorator: Google::Apis::RedisV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSettings::Representation + + property :name, as: 'name' + hash :producer_metadata, as: 'producerMetadata' + collection :provisioned_resources, as: 'provisionedResources', class: Google::Apis::RedisV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1ProvisionedResource, decorator: Google::Apis::RedisV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1ProvisionedResource::Representation + + property :slm_instance_template, as: 'slmInstanceTemplate' + property :slo_metadata, as: 'sloMetadata', class: Google::Apis::RedisV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata, decorator: Google::Apis::RedisV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata::Representation + + hash :software_versions, as: 'softwareVersions' + property :state, as: 'state' + property :tenant_project_id, as: 'tenantProjectId' + property :update_time, as: 'updateTime' + end + end + + class GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSchedule + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :can_reschedule, as: 'canReschedule' + property :end_time, as: 'endTime' + property :rollout_management_policy, as: 'rolloutManagementPolicy' + property :start_time, as: 'startTime' + end + end + + class GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSettings + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :exclude, as: 'exclude' + end + end + + class GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata + # @private + class Representation < Google::Apis::Core::JsonRepresentation + collection :exclusions, as: 'exclusions', class: Google::Apis::RedisV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion, decorator: Google::Apis::RedisV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion::Representation + + property :location, as: 'location' + property :node_id, as: 'nodeId' + end + end + + class GoogleCloudSaasacceleratorManagementProvidersV1ProvisionedResource + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :resource_type, as: 'resourceType' + property :resource_url, as: 'resourceUrl' + end + end + + class GoogleCloudSaasacceleratorManagementProvidersV1SloEligibility + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :eligible, as: 'eligible' + property :reason, as: 'reason' + end + end + + class GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :duration, as: 'duration' + property :reason, as: 'reason' + property :sli_name, as: 'sliName' + property :start_time, as: 'startTime' + end + end + + class GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata + # @private + class Representation < Google::Apis::Core::JsonRepresentation + property :eligibility, as: 'eligibility', class: Google::Apis::RedisV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1SloEligibility, decorator: Google::Apis::RedisV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1SloEligibility::Representation + + collection :exclusions, as: 'exclusions', class: Google::Apis::RedisV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion, decorator: Google::Apis::RedisV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion::Representation + + collection :nodes, as: 'nodes', class: Google::Apis::RedisV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata, decorator: Google::Apis::RedisV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata::Representation + + property :tier, as: 'tier' + end + end + class ImportInstanceRequest # @private class Representation < Google::Apis::Core::JsonRepresentation diff --git a/generated/google/apis/sasportal_v1alpha1.rb b/generated/google/apis/sasportal_v1alpha1.rb index 70ad4d0ba..8a6e7c4f5 100644 --- a/generated/google/apis/sasportal_v1alpha1.rb +++ b/generated/google/apis/sasportal_v1alpha1.rb @@ -25,7 +25,7 @@ module Google # @see https://developers.google.com/spectrum-access-system/ module SasportalV1alpha1 VERSION = 'V1alpha1' - REVISION = '20200629' + REVISION = '20200722' # View your email address AUTH_USERINFO_EMAIL = 'https://www.googleapis.com/auth/userinfo.email' diff --git a/generated/google/apis/sasportal_v1alpha1/classes.rb b/generated/google/apis/sasportal_v1alpha1/classes.rb index ac325c113..84899cd4a 100644 --- a/generated/google/apis/sasportal_v1alpha1/classes.rb +++ b/generated/google/apis/sasportal_v1alpha1/classes.rb @@ -150,50 +150,6 @@ module Google end end - # The Deployment. - class SasPortalDeployment - include Google::Apis::Core::Hashable - - # The allowed billing modes under this deployment. - # Corresponds to the JSON property `allowedBillingModes` - # @return [Array] - attr_accessor :allowed_billing_modes - - # Default billing mode for the deployment and devices under it. - # Corresponds to the JSON property `defaultBillingMode` - # @return [String] - attr_accessor :default_billing_mode - - # The deployment's display name. - # Corresponds to the JSON property `displayName` - # @return [String] - attr_accessor :display_name - - # Output only. Resource name. - # Corresponds to the JSON property `name` - # @return [String] - attr_accessor :name - - # User id used by the devices belonging to this deployment. Each deployment - # should be associated with one unique user_id. - # Corresponds to the JSON property `sasUserIds` - # @return [Array] - attr_accessor :sas_user_ids - - def initialize(**args) - update!(**args) - end - - # Update properties of this object - def update!(**args) - @allowed_billing_modes = args[:allowed_billing_modes] if args.key?(:allowed_billing_modes) - @default_billing_mode = args[:default_billing_mode] if args.key?(:default_billing_mode) - @display_name = args[:display_name] if args.key?(:display_name) - @name = args[:name] if args.key?(:name) - @sas_user_ids = args[:sas_user_ids] if args.key?(:sas_user_ids) - end - end - # class SasPortalDevice include Google::Apis::Core::Hashable @@ -765,35 +721,6 @@ module Google end end - # Response for ListDeployments method. - class SasPortalListDeploymentsResponse - include Google::Apis::Core::Hashable - - # The deployments that match the - # request. - # Corresponds to the JSON property `deployments` - # @return [Array] - attr_accessor :deployments - - # A pagination token returned from a previous call to - # ListDeployments method that indicates - # from where listing should continue. If the field is missing or empty, it - # means there is no more deployments. - # Corresponds to the JSON property `nextPageToken` - # @return [String] - attr_accessor :next_page_token - - def initialize(**args) - update!(**args) - end - - # Update properties of this object - def update!(**args) - @deployments = args[:deployments] if args.key?(:deployments) - @next_page_token = args[:next_page_token] if args.key?(:next_page_token) - end - end - # Response for ListDevices method. class SasPortalListDevicesResponse include Google::Apis::Core::Hashable diff --git a/generated/google/apis/sasportal_v1alpha1/representations.rb b/generated/google/apis/sasportal_v1alpha1/representations.rb index f201ca30b..3e973278a 100644 --- a/generated/google/apis/sasportal_v1alpha1/representations.rb +++ b/generated/google/apis/sasportal_v1alpha1/representations.rb @@ -52,12 +52,6 @@ module Google include Google::Apis::Core::JsonObjectSupport end - class SasPortalDeployment - class Representation < Google::Apis::Core::JsonRepresentation; end - - include Google::Apis::Core::JsonObjectSupport - end - class SasPortalDevice class Representation < Google::Apis::Core::JsonRepresentation; end @@ -142,12 +136,6 @@ module Google include Google::Apis::Core::JsonObjectSupport end - class SasPortalListDeploymentsResponse - class Representation < Google::Apis::Core::JsonRepresentation; end - - include Google::Apis::Core::JsonObjectSupport - end - class SasPortalListDevicesResponse class Representation < Google::Apis::Core::JsonRepresentation; end @@ -278,17 +266,6 @@ module Google end end - class SasPortalDeployment - # @private - class Representation < Google::Apis::Core::JsonRepresentation - collection :allowed_billing_modes, as: 'allowedBillingModes' - property :default_billing_mode, as: 'defaultBillingMode' - property :display_name, as: 'displayName' - property :name, as: 'name' - collection :sas_user_ids, as: 'sasUserIds' - end - end - class SasPortalDevice # @private class Representation < Google::Apis::Core::JsonRepresentation @@ -439,15 +416,6 @@ module Google end end - class SasPortalListDeploymentsResponse - # @private - class Representation < Google::Apis::Core::JsonRepresentation - collection :deployments, as: 'deployments', class: Google::Apis::SasportalV1alpha1::SasPortalDeployment, decorator: Google::Apis::SasportalV1alpha1::SasPortalDeployment::Representation - - property :next_page_token, as: 'nextPageToken' - end - end - class SasPortalListDevicesResponse # @private class Representation < Google::Apis::Core::JsonRepresentation diff --git a/generated/google/apis/sasportal_v1alpha1/service.rb b/generated/google/apis/sasportal_v1alpha1/service.rb index 7238e19bd..0cef41909 100644 --- a/generated/google/apis/sasportal_v1alpha1/service.rb +++ b/generated/google/apis/sasportal_v1alpha1/service.rb @@ -149,174 +149,6 @@ module Google execute_or_queue_command(command, &block) end - # Creates a new deployment. - # @param [String] parent - # Required. The parent resource name where the deployment is to be created. - # @param [Google::Apis::SasportalV1alpha1::SasPortalDeployment] sas_portal_deployment_object - # @param [String] fields - # Selector specifying which fields to include in a partial response. - # @param [String] quota_user - # 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. - # @param [Google::Apis::RequestOptions] options - # Request-specific options - # - # @yield [result, err] Result & error if block supplied - # @yieldparam result [Google::Apis::SasportalV1alpha1::SasPortalDeployment] parsed result object - # @yieldparam err [StandardError] error object if request failed - # - # @return [Google::Apis::SasportalV1alpha1::SasPortalDeployment] - # - # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried - # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification - # @raise [Google::Apis::AuthorizationError] Authorization is required - def create_customer_deployment(parent, sas_portal_deployment_object = nil, fields: nil, quota_user: nil, options: nil, &block) - command = make_simple_command(:post, 'v1alpha1/{+parent}/deployments', options) - command.request_representation = Google::Apis::SasportalV1alpha1::SasPortalDeployment::Representation - command.request_object = sas_portal_deployment_object - command.response_representation = Google::Apis::SasportalV1alpha1::SasPortalDeployment::Representation - command.response_class = Google::Apis::SasportalV1alpha1::SasPortalDeployment - command.params['parent'] = parent unless parent.nil? - command.query['fields'] = fields unless fields.nil? - command.query['quotaUser'] = quota_user unless quota_user.nil? - execute_or_queue_command(command, &block) - end - - # Deletes a deployment. - # @param [String] name - # Required. The name of the deployment. - # @param [String] fields - # Selector specifying which fields to include in a partial response. - # @param [String] quota_user - # 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. - # @param [Google::Apis::RequestOptions] options - # Request-specific options - # - # @yield [result, err] Result & error if block supplied - # @yieldparam result [Google::Apis::SasportalV1alpha1::SasPortalEmpty] parsed result object - # @yieldparam err [StandardError] error object if request failed - # - # @return [Google::Apis::SasportalV1alpha1::SasPortalEmpty] - # - # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried - # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification - # @raise [Google::Apis::AuthorizationError] Authorization is required - def delete_customer_deployment(name, fields: nil, quota_user: nil, options: nil, &block) - command = make_simple_command(:delete, 'v1alpha1/{+name}', options) - command.response_representation = Google::Apis::SasportalV1alpha1::SasPortalEmpty::Representation - command.response_class = Google::Apis::SasportalV1alpha1::SasPortalEmpty - command.params['name'] = name unless name.nil? - command.query['fields'] = fields unless fields.nil? - command.query['quotaUser'] = quota_user unless quota_user.nil? - execute_or_queue_command(command, &block) - end - - # Returns a requested deployment. - # @param [String] name - # Required. The name of the deployment. - # @param [String] fields - # Selector specifying which fields to include in a partial response. - # @param [String] quota_user - # 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. - # @param [Google::Apis::RequestOptions] options - # Request-specific options - # - # @yield [result, err] Result & error if block supplied - # @yieldparam result [Google::Apis::SasportalV1alpha1::SasPortalDeployment] parsed result object - # @yieldparam err [StandardError] error object if request failed - # - # @return [Google::Apis::SasportalV1alpha1::SasPortalDeployment] - # - # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried - # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification - # @raise [Google::Apis::AuthorizationError] Authorization is required - def get_customer_deployment(name, fields: nil, quota_user: nil, options: nil, &block) - command = make_simple_command(:get, 'v1alpha1/{+name}', options) - command.response_representation = Google::Apis::SasportalV1alpha1::SasPortalDeployment::Representation - command.response_class = Google::Apis::SasportalV1alpha1::SasPortalDeployment - command.params['name'] = name unless name.nil? - command.query['fields'] = fields unless fields.nil? - command.query['quotaUser'] = quota_user unless quota_user.nil? - execute_or_queue_command(command, &block) - end - - # Lists deployments. - # @param [String] parent - # Required. The parent resource name, for example, "nodes/1", - # customer/1/nodes/2. - # @param [Fixnum] page_size - # The maximum number of deployments to return in the response. - # @param [String] page_token - # A pagination token returned from a previous call to ListDeployments - # method that - # indicates where this listing should continue from. - # @param [String] fields - # Selector specifying which fields to include in a partial response. - # @param [String] quota_user - # 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. - # @param [Google::Apis::RequestOptions] options - # Request-specific options - # - # @yield [result, err] Result & error if block supplied - # @yieldparam result [Google::Apis::SasportalV1alpha1::SasPortalListDeploymentsResponse] parsed result object - # @yieldparam err [StandardError] error object if request failed - # - # @return [Google::Apis::SasportalV1alpha1::SasPortalListDeploymentsResponse] - # - # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried - # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification - # @raise [Google::Apis::AuthorizationError] Authorization is required - def list_customer_deployments(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block) - command = make_simple_command(:get, 'v1alpha1/{+parent}/deployments', options) - command.response_representation = Google::Apis::SasportalV1alpha1::SasPortalListDeploymentsResponse::Representation - command.response_class = Google::Apis::SasportalV1alpha1::SasPortalListDeploymentsResponse - command.params['parent'] = parent unless parent.nil? - command.query['pageSize'] = page_size unless page_size.nil? - command.query['pageToken'] = page_token unless page_token.nil? - command.query['fields'] = fields unless fields.nil? - command.query['quotaUser'] = quota_user unless quota_user.nil? - execute_or_queue_command(command, &block) - end - - # Updates an existing deployment. - # @param [String] name - # Output only. Resource name. - # @param [Google::Apis::SasportalV1alpha1::SasPortalDeployment] sas_portal_deployment_object - # @param [String] update_mask - # Fields to be updated. - # @param [String] fields - # Selector specifying which fields to include in a partial response. - # @param [String] quota_user - # 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. - # @param [Google::Apis::RequestOptions] options - # Request-specific options - # - # @yield [result, err] Result & error if block supplied - # @yieldparam result [Google::Apis::SasportalV1alpha1::SasPortalDeployment] parsed result object - # @yieldparam err [StandardError] error object if request failed - # - # @return [Google::Apis::SasportalV1alpha1::SasPortalDeployment] - # - # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried - # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification - # @raise [Google::Apis::AuthorizationError] Authorization is required - def patch_customer_deployment(name, sas_portal_deployment_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block) - command = make_simple_command(:patch, 'v1alpha1/{+name}', options) - command.request_representation = Google::Apis::SasportalV1alpha1::SasPortalDeployment::Representation - command.request_object = sas_portal_deployment_object - command.response_representation = Google::Apis::SasportalV1alpha1::SasPortalDeployment::Representation - command.response_class = Google::Apis::SasportalV1alpha1::SasPortalDeployment - command.params['name'] = name unless name.nil? - command.query['updateMask'] = update_mask unless update_mask.nil? - command.query['fields'] = fields unless fields.nil? - command.query['quotaUser'] = quota_user unless quota_user.nil? - execute_or_queue_command(command, &block) - end - # Creates a device under a node or customer. Returned devices are unordered. # @param [String] parent # Required. The name of the parent resource. @@ -856,78 +688,6 @@ module Google execute_or_queue_command(command, &block) end - # Creates a new deployment. - # @param [String] parent - # Required. The parent resource name where the deployment is to be created. - # @param [Google::Apis::SasportalV1alpha1::SasPortalDeployment] sas_portal_deployment_object - # @param [String] fields - # Selector specifying which fields to include in a partial response. - # @param [String] quota_user - # 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. - # @param [Google::Apis::RequestOptions] options - # Request-specific options - # - # @yield [result, err] Result & error if block supplied - # @yieldparam result [Google::Apis::SasportalV1alpha1::SasPortalDeployment] parsed result object - # @yieldparam err [StandardError] error object if request failed - # - # @return [Google::Apis::SasportalV1alpha1::SasPortalDeployment] - # - # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried - # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification - # @raise [Google::Apis::AuthorizationError] Authorization is required - def create_customer_node_deployment(parent, sas_portal_deployment_object = nil, fields: nil, quota_user: nil, options: nil, &block) - command = make_simple_command(:post, 'v1alpha1/{+parent}/deployments', options) - command.request_representation = Google::Apis::SasportalV1alpha1::SasPortalDeployment::Representation - command.request_object = sas_portal_deployment_object - command.response_representation = Google::Apis::SasportalV1alpha1::SasPortalDeployment::Representation - command.response_class = Google::Apis::SasportalV1alpha1::SasPortalDeployment - command.params['parent'] = parent unless parent.nil? - command.query['fields'] = fields unless fields.nil? - command.query['quotaUser'] = quota_user unless quota_user.nil? - execute_or_queue_command(command, &block) - end - - # Lists deployments. - # @param [String] parent - # Required. The parent resource name, for example, "nodes/1", - # customer/1/nodes/2. - # @param [Fixnum] page_size - # The maximum number of deployments to return in the response. - # @param [String] page_token - # A pagination token returned from a previous call to ListDeployments - # method that - # indicates where this listing should continue from. - # @param [String] fields - # Selector specifying which fields to include in a partial response. - # @param [String] quota_user - # 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. - # @param [Google::Apis::RequestOptions] options - # Request-specific options - # - # @yield [result, err] Result & error if block supplied - # @yieldparam result [Google::Apis::SasportalV1alpha1::SasPortalListDeploymentsResponse] parsed result object - # @yieldparam err [StandardError] error object if request failed - # - # @return [Google::Apis::SasportalV1alpha1::SasPortalListDeploymentsResponse] - # - # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried - # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification - # @raise [Google::Apis::AuthorizationError] Authorization is required - def list_customer_node_deployments(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block) - command = make_simple_command(:get, 'v1alpha1/{+parent}/deployments', options) - command.response_representation = Google::Apis::SasportalV1alpha1::SasPortalListDeploymentsResponse::Representation - command.response_class = Google::Apis::SasportalV1alpha1::SasPortalListDeploymentsResponse - command.params['parent'] = parent unless parent.nil? - command.query['pageSize'] = page_size unless page_size.nil? - command.query['pageToken'] = page_token unless page_token.nil? - command.query['fields'] = fields unless fields.nil? - command.query['quotaUser'] = quota_user unless quota_user.nil? - execute_or_queue_command(command, &block) - end - # Creates a new node. # @param [String] parent # Required. The parent resource name where the node is to be created. @@ -998,36 +758,6 @@ module Google execute_or_queue_command(command, &block) end - # Returns a requested deployment. - # @param [String] name - # Required. The name of the deployment. - # @param [String] fields - # Selector specifying which fields to include in a partial response. - # @param [String] quota_user - # 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. - # @param [Google::Apis::RequestOptions] options - # Request-specific options - # - # @yield [result, err] Result & error if block supplied - # @yieldparam result [Google::Apis::SasportalV1alpha1::SasPortalDeployment] parsed result object - # @yieldparam err [StandardError] error object if request failed - # - # @return [Google::Apis::SasportalV1alpha1::SasPortalDeployment] - # - # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried - # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification - # @raise [Google::Apis::AuthorizationError] Authorization is required - def get_deployment(name, fields: nil, quota_user: nil, options: nil, &block) - command = make_simple_command(:get, 'v1alpha1/{+name}', options) - command.response_representation = Google::Apis::SasportalV1alpha1::SasPortalDeployment::Representation - command.response_class = Google::Apis::SasportalV1alpha1::SasPortalDeployment - command.params['name'] = name unless name.nil? - command.query['fields'] = fields unless fields.nil? - command.query['quotaUser'] = quota_user unless quota_user.nil? - execute_or_queue_command(command, &block) - end - # Generates a secret to be used with the ValidateInstaller method # @param [Google::Apis::SasportalV1alpha1::SasPortalGenerateSecretRequest] sas_portal_generate_secret_request_object # @param [String] fields @@ -1118,141 +848,6 @@ module Google execute_or_queue_command(command, &block) end - # Deletes a deployment. - # @param [String] name - # Required. The name of the deployment. - # @param [String] fields - # Selector specifying which fields to include in a partial response. - # @param [String] quota_user - # 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. - # @param [Google::Apis::RequestOptions] options - # Request-specific options - # - # @yield [result, err] Result & error if block supplied - # @yieldparam result [Google::Apis::SasportalV1alpha1::SasPortalEmpty] parsed result object - # @yieldparam err [StandardError] error object if request failed - # - # @return [Google::Apis::SasportalV1alpha1::SasPortalEmpty] - # - # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried - # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification - # @raise [Google::Apis::AuthorizationError] Authorization is required - def delete_node_deployment(name, fields: nil, quota_user: nil, options: nil, &block) - command = make_simple_command(:delete, 'v1alpha1/{+name}', options) - command.response_representation = Google::Apis::SasportalV1alpha1::SasPortalEmpty::Representation - command.response_class = Google::Apis::SasportalV1alpha1::SasPortalEmpty - command.params['name'] = name unless name.nil? - command.query['fields'] = fields unless fields.nil? - command.query['quotaUser'] = quota_user unless quota_user.nil? - execute_or_queue_command(command, &block) - end - - # Returns a requested deployment. - # @param [String] name - # Required. The name of the deployment. - # @param [String] fields - # Selector specifying which fields to include in a partial response. - # @param [String] quota_user - # 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. - # @param [Google::Apis::RequestOptions] options - # Request-specific options - # - # @yield [result, err] Result & error if block supplied - # @yieldparam result [Google::Apis::SasportalV1alpha1::SasPortalDeployment] parsed result object - # @yieldparam err [StandardError] error object if request failed - # - # @return [Google::Apis::SasportalV1alpha1::SasPortalDeployment] - # - # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried - # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification - # @raise [Google::Apis::AuthorizationError] Authorization is required - def get_node_deployment(name, fields: nil, quota_user: nil, options: nil, &block) - command = make_simple_command(:get, 'v1alpha1/{+name}', options) - command.response_representation = Google::Apis::SasportalV1alpha1::SasPortalDeployment::Representation - command.response_class = Google::Apis::SasportalV1alpha1::SasPortalDeployment - command.params['name'] = name unless name.nil? - command.query['fields'] = fields unless fields.nil? - command.query['quotaUser'] = quota_user unless quota_user.nil? - execute_or_queue_command(command, &block) - end - - # Lists deployments. - # @param [String] parent - # Required. The parent resource name, for example, "nodes/1", - # customer/1/nodes/2. - # @param [Fixnum] page_size - # The maximum number of deployments to return in the response. - # @param [String] page_token - # A pagination token returned from a previous call to ListDeployments - # method that - # indicates where this listing should continue from. - # @param [String] fields - # Selector specifying which fields to include in a partial response. - # @param [String] quota_user - # 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. - # @param [Google::Apis::RequestOptions] options - # Request-specific options - # - # @yield [result, err] Result & error if block supplied - # @yieldparam result [Google::Apis::SasportalV1alpha1::SasPortalListDeploymentsResponse] parsed result object - # @yieldparam err [StandardError] error object if request failed - # - # @return [Google::Apis::SasportalV1alpha1::SasPortalListDeploymentsResponse] - # - # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried - # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification - # @raise [Google::Apis::AuthorizationError] Authorization is required - def list_node_deployments(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block) - command = make_simple_command(:get, 'v1alpha1/{+parent}/deployments', options) - command.response_representation = Google::Apis::SasportalV1alpha1::SasPortalListDeploymentsResponse::Representation - command.response_class = Google::Apis::SasportalV1alpha1::SasPortalListDeploymentsResponse - command.params['parent'] = parent unless parent.nil? - command.query['pageSize'] = page_size unless page_size.nil? - command.query['pageToken'] = page_token unless page_token.nil? - command.query['fields'] = fields unless fields.nil? - command.query['quotaUser'] = quota_user unless quota_user.nil? - execute_or_queue_command(command, &block) - end - - # Updates an existing deployment. - # @param [String] name - # Output only. Resource name. - # @param [Google::Apis::SasportalV1alpha1::SasPortalDeployment] sas_portal_deployment_object - # @param [String] update_mask - # Fields to be updated. - # @param [String] fields - # Selector specifying which fields to include in a partial response. - # @param [String] quota_user - # 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. - # @param [Google::Apis::RequestOptions] options - # Request-specific options - # - # @yield [result, err] Result & error if block supplied - # @yieldparam result [Google::Apis::SasportalV1alpha1::SasPortalDeployment] parsed result object - # @yieldparam err [StandardError] error object if request failed - # - # @return [Google::Apis::SasportalV1alpha1::SasPortalDeployment] - # - # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried - # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification - # @raise [Google::Apis::AuthorizationError] Authorization is required - def patch_node_deployment(name, sas_portal_deployment_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block) - command = make_simple_command(:patch, 'v1alpha1/{+name}', options) - command.request_representation = Google::Apis::SasportalV1alpha1::SasPortalDeployment::Representation - command.request_object = sas_portal_deployment_object - command.response_representation = Google::Apis::SasportalV1alpha1::SasPortalDeployment::Representation - command.response_class = Google::Apis::SasportalV1alpha1::SasPortalDeployment - command.params['name'] = name unless name.nil? - command.query['updateMask'] = update_mask unless update_mask.nil? - command.query['fields'] = fields unless fields.nil? - command.query['quotaUser'] = quota_user unless quota_user.nil? - execute_or_queue_command(command, &block) - end - # Creates a device under a node or customer. Returned devices are unordered. # @param [String] parent # Required. The name of the parent resource. @@ -1792,78 +1387,6 @@ module Google execute_or_queue_command(command, &block) end - # Creates a new deployment. - # @param [String] parent - # Required. The parent resource name where the deployment is to be created. - # @param [Google::Apis::SasportalV1alpha1::SasPortalDeployment] sas_portal_deployment_object - # @param [String] fields - # Selector specifying which fields to include in a partial response. - # @param [String] quota_user - # 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. - # @param [Google::Apis::RequestOptions] options - # Request-specific options - # - # @yield [result, err] Result & error if block supplied - # @yieldparam result [Google::Apis::SasportalV1alpha1::SasPortalDeployment] parsed result object - # @yieldparam err [StandardError] error object if request failed - # - # @return [Google::Apis::SasportalV1alpha1::SasPortalDeployment] - # - # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried - # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification - # @raise [Google::Apis::AuthorizationError] Authorization is required - def create_node_node_deployment(parent, sas_portal_deployment_object = nil, fields: nil, quota_user: nil, options: nil, &block) - command = make_simple_command(:post, 'v1alpha1/{+parent}/deployments', options) - command.request_representation = Google::Apis::SasportalV1alpha1::SasPortalDeployment::Representation - command.request_object = sas_portal_deployment_object - command.response_representation = Google::Apis::SasportalV1alpha1::SasPortalDeployment::Representation - command.response_class = Google::Apis::SasportalV1alpha1::SasPortalDeployment - command.params['parent'] = parent unless parent.nil? - command.query['fields'] = fields unless fields.nil? - command.query['quotaUser'] = quota_user unless quota_user.nil? - execute_or_queue_command(command, &block) - end - - # Lists deployments. - # @param [String] parent - # Required. The parent resource name, for example, "nodes/1", - # customer/1/nodes/2. - # @param [Fixnum] page_size - # The maximum number of deployments to return in the response. - # @param [String] page_token - # A pagination token returned from a previous call to ListDeployments - # method that - # indicates where this listing should continue from. - # @param [String] fields - # Selector specifying which fields to include in a partial response. - # @param [String] quota_user - # 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. - # @param [Google::Apis::RequestOptions] options - # Request-specific options - # - # @yield [result, err] Result & error if block supplied - # @yieldparam result [Google::Apis::SasportalV1alpha1::SasPortalListDeploymentsResponse] parsed result object - # @yieldparam err [StandardError] error object if request failed - # - # @return [Google::Apis::SasportalV1alpha1::SasPortalListDeploymentsResponse] - # - # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried - # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification - # @raise [Google::Apis::AuthorizationError] Authorization is required - def list_node_node_deployments(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block) - command = make_simple_command(:get, 'v1alpha1/{+parent}/deployments', options) - command.response_representation = Google::Apis::SasportalV1alpha1::SasPortalListDeploymentsResponse::Representation - command.response_class = Google::Apis::SasportalV1alpha1::SasPortalListDeploymentsResponse - command.params['parent'] = parent unless parent.nil? - command.query['pageSize'] = page_size unless page_size.nil? - command.query['pageToken'] = page_token unless page_token.nil? - command.query['fields'] = fields unless fields.nil? - command.query['quotaUser'] = quota_user unless quota_user.nil? - execute_or_queue_command(command, &block) - end - # Creates a device under a node or customer. Returned devices are unordered. # @param [String] parent # Required. The name of the parent resource. diff --git a/generated/google/apis/youtube_partner_v1.rb b/generated/google/apis/youtube_partner_v1.rb index 230635468..024a01eaa 100644 --- a/generated/google/apis/youtube_partner_v1.rb +++ b/generated/google/apis/youtube_partner_v1.rb @@ -26,7 +26,7 @@ module Google # @see https://devsite.googleplex.com/youtube/partner/docs/v1/ module YoutubePartnerV1 VERSION = 'V1' - REVISION = '20200723' + REVISION = '20200724' # View and manage your assets and associated content on YouTube AUTH_YOUTUBEPARTNER = 'https://www.googleapis.com/auth/youtubepartner'