google-apis-apigee_v1 0.48.0 → 0.51.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -122,14 +122,14 @@ module Google
122
122
 
123
123
  # Delete an Apigee organization. For organizations with BillingType EVALUATION,
124
124
  # an immediate deletion is performed. For paid organizations, a soft-deletion is
125
- # performed. The organization can be restored within the soft-deletion period -
125
+ # performed. The organization can be restored within the soft-deletion period
126
126
  # which can be controlled using the retention field in the request.
127
127
  # @param [String] name
128
128
  # Required. Name of the organization. Use the following structure in your
129
129
  # request: `organizations/`org``
130
130
  # @param [String] retention
131
- # Optional. This setting is only applicable for organizations that are soft-
132
- # deleted (i.e. BillingType is not EVALUATION). It controls how long
131
+ # Optional. This setting is applicable only for organizations that are soft-
132
+ # deleted (i.e., BillingType is not EVALUATION). It controls how long
133
133
  # Organization data will be retained after the initial delete operation
134
134
  # completes. During this period, the Organization may be restored to its last
135
135
  # known state. After this period, the Organization will no longer be able to be
@@ -2675,26 +2675,25 @@ module Google
2675
2675
  # Manages access to a developer app by enabling you to: * Approve or revoke a
2676
2676
  # developer app * Generate a new consumer key and secret for a developer app To
2677
2677
  # approve or revoke a developer app, set the `action` query parameter to `
2678
- # approved` or `revoked`, respectively, and the `Content-Type` header to `
2678
+ # approve` or `revoke`, respectively, and the `Content-Type` header to `
2679
2679
  # application/octet-stream`. If a developer app is revoked, none of its API keys
2680
- # are valid for API calls even though the keys are still `approved`. If
2681
- # successful, the API call returns the following HTTP status code: `204 No
2682
- # Content` To generate a new consumer key and secret for a developer app, pass
2683
- # the new key/secret details. Rather than replace an existing key, this API
2684
- # generates a new key. In this case, multiple key pairs may be associated with a
2685
- # single developer app. Each key pair has an independent status (`approved` or `
2686
- # revoked`) and expiration time. Any approved, non-expired key can be used in an
2687
- # API call. For example, if you're using API key rotation, you can generate new
2688
- # keys with expiration times that overlap keys that are going to expire. You
2689
- # might also generate a new consumer key/secret if the security of the original
2690
- # key/secret is compromised. The `keyExpiresIn` property defines the expiration
2691
- # time for the API key in milliseconds. If you don't set this property or set it
2692
- # to `-1`, the API key never expires. **Notes**: * When generating a new key/
2693
- # secret, this API replaces the existing attributes, notes, and callback URLs
2694
- # with those specified in the request. Include or exclude any existing
2695
- # information that you want to retain or delete, respectively. * To migrate
2696
- # existing consumer keys and secrets to hybrid from another system, see the
2697
- # CreateDeveloperAppKey API.
2680
+ # are valid for API calls even though the keys are still approved. If successful,
2681
+ # the API call returns the following HTTP status code: `204 No Content` To
2682
+ # generate a new consumer key and secret for a developer app, pass the new key/
2683
+ # secret details. Rather than replace an existing key, this API generates a new
2684
+ # key. In this case, multiple key pairs may be associated with a single
2685
+ # developer app. Each key pair has an independent status (`approve` or `revoke`)
2686
+ # and expiration time. Any approved, non-expired key can be used in an API call.
2687
+ # For example, if you're using API key rotation, you can generate new keys with
2688
+ # expiration times that overlap keys that are going to expire. You might also
2689
+ # generate a new consumer key/secret if the security of the original key/secret
2690
+ # is compromised. The `keyExpiresIn` property defines the expiration time for
2691
+ # the API key in milliseconds. If you don't set this property or set it to `-1`,
2692
+ # the API key never expires. **Notes**: * When generating a new key/secret, this
2693
+ # API replaces the existing attributes, notes, and callback URLs with those
2694
+ # specified in the request. Include or exclude any existing information that you
2695
+ # want to retain or delete, respectively. * To migrate existing consumer keys
2696
+ # and secrets to hybrid from another system, see the CreateDeveloperAppKey API.
2698
2697
  # @param [String] name
2699
2698
  # Required. Name of the developer app. Use the following structure in your
2700
2699
  # request: `organizations/`org`/developers/`developer_email`/apps/`app``
@@ -4153,8 +4152,10 @@ module Google
4153
4152
  execute_or_queue_command(command, &block)
4154
4153
  end
4155
4154
 
4156
- # Deletes an environment from an organization. **Note**: You must delete all key
4157
- # value maps and key value entries before you can delete an environment.
4155
+ # Deletes an environment from an organization. **Warning: You must delete all
4156
+ # key value maps and key value entries before you delete an environment.**
4157
+ # Otherwise, if you re-create the environment the key value map entry operations
4158
+ # will encounter encryption/decryption discrepancies.
4158
4159
  # @param [String] name
4159
4160
  # Required. Name of the environment. Use the following structure in your request:
4160
4161
  # `organizations/`org`/environments/`env``
@@ -6874,6 +6875,197 @@ module Google
6874
6875
  execute_or_queue_command(command, &block)
6875
6876
  end
6876
6877
 
6878
+ # Submit a report request to be processed in the background. If the submission
6879
+ # succeeds, the API returns a 200 status and an ID that refer to the report
6880
+ # request. In addition to the HTTP status 200, the `state` of "enqueued" means
6881
+ # that the request succeeded.
6882
+ # @param [String] parent
6883
+ # Required. The parent resource name. Must be of the form `organizations/`org`/
6884
+ # environments/`env``.
6885
+ # @param [Google::Apis::ApigeeV1::GoogleCloudApigeeV1SecurityReportQuery] google_cloud_apigee_v1_security_report_query_object
6886
+ # @param [String] fields
6887
+ # Selector specifying which fields to include in a partial response.
6888
+ # @param [String] quota_user
6889
+ # Available to use for quota purposes for server-side applications. Can be any
6890
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
6891
+ # @param [Google::Apis::RequestOptions] options
6892
+ # Request-specific options
6893
+ #
6894
+ # @yield [result, err] Result & error if block supplied
6895
+ # @yieldparam result [Google::Apis::ApigeeV1::GoogleCloudApigeeV1SecurityReport] parsed result object
6896
+ # @yieldparam err [StandardError] error object if request failed
6897
+ #
6898
+ # @return [Google::Apis::ApigeeV1::GoogleCloudApigeeV1SecurityReport]
6899
+ #
6900
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
6901
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
6902
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
6903
+ def create_organization_environment_security_report(parent, google_cloud_apigee_v1_security_report_query_object = nil, fields: nil, quota_user: nil, options: nil, &block)
6904
+ command = make_simple_command(:post, 'v1/{+parent}/securityReports', options)
6905
+ command.request_representation = Google::Apis::ApigeeV1::GoogleCloudApigeeV1SecurityReportQuery::Representation
6906
+ command.request_object = google_cloud_apigee_v1_security_report_query_object
6907
+ command.response_representation = Google::Apis::ApigeeV1::GoogleCloudApigeeV1SecurityReport::Representation
6908
+ command.response_class = Google::Apis::ApigeeV1::GoogleCloudApigeeV1SecurityReport
6909
+ command.params['parent'] = parent unless parent.nil?
6910
+ command.query['fields'] = fields unless fields.nil?
6911
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
6912
+ execute_or_queue_command(command, &block)
6913
+ end
6914
+
6915
+ # Get security report status If the query is still in progress, the `state` is
6916
+ # set to "running" After the query has completed successfully, `state` is set to
6917
+ # "completed"
6918
+ # @param [String] name
6919
+ # Required. Name of the security report to get. Must be of the form `
6920
+ # organizations/`org`/environments/`env`/securityReports/`reportId``.
6921
+ # @param [String] fields
6922
+ # Selector specifying which fields to include in a partial response.
6923
+ # @param [String] quota_user
6924
+ # Available to use for quota purposes for server-side applications. Can be any
6925
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
6926
+ # @param [Google::Apis::RequestOptions] options
6927
+ # Request-specific options
6928
+ #
6929
+ # @yield [result, err] Result & error if block supplied
6930
+ # @yieldparam result [Google::Apis::ApigeeV1::GoogleCloudApigeeV1SecurityReport] parsed result object
6931
+ # @yieldparam err [StandardError] error object if request failed
6932
+ #
6933
+ # @return [Google::Apis::ApigeeV1::GoogleCloudApigeeV1SecurityReport]
6934
+ #
6935
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
6936
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
6937
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
6938
+ def get_organization_environment_security_report(name, fields: nil, quota_user: nil, options: nil, &block)
6939
+ command = make_simple_command(:get, 'v1/{+name}', options)
6940
+ command.response_representation = Google::Apis::ApigeeV1::GoogleCloudApigeeV1SecurityReport::Representation
6941
+ command.response_class = Google::Apis::ApigeeV1::GoogleCloudApigeeV1SecurityReport
6942
+ command.params['name'] = name unless name.nil?
6943
+ command.query['fields'] = fields unless fields.nil?
6944
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
6945
+ execute_or_queue_command(command, &block)
6946
+ end
6947
+
6948
+ # After the query is completed, use this API to retrieve the results as file. If
6949
+ # the request succeeds, and there is a non-zero result set, the result is
6950
+ # downloaded to the client as a zipped JSON file. The name of the downloaded
6951
+ # file will be: OfflineQueryResult-.zip Example: `OfflineQueryResult-9cfc0d85-
6952
+ # 0f30-46d6-ae6f-318d0cb961bd.zip`
6953
+ # @param [String] name
6954
+ # Required. Name of the security report result to get. Must be of the form `
6955
+ # organizations/`org`/environments/`env`/securityReports/`reportId`/result`.
6956
+ # @param [String] fields
6957
+ # Selector specifying which fields to include in a partial response.
6958
+ # @param [String] quota_user
6959
+ # Available to use for quota purposes for server-side applications. Can be any
6960
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
6961
+ # @param [Google::Apis::RequestOptions] options
6962
+ # Request-specific options
6963
+ #
6964
+ # @yield [result, err] Result & error if block supplied
6965
+ # @yieldparam result [Google::Apis::ApigeeV1::GoogleApiHttpBody] parsed result object
6966
+ # @yieldparam err [StandardError] error object if request failed
6967
+ #
6968
+ # @return [Google::Apis::ApigeeV1::GoogleApiHttpBody]
6969
+ #
6970
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
6971
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
6972
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
6973
+ def get_organization_environment_security_report_result(name, fields: nil, quota_user: nil, options: nil, &block)
6974
+ command = make_simple_command(:get, 'v1/{+name}', options)
6975
+ command.response_representation = Google::Apis::ApigeeV1::GoogleApiHttpBody::Representation
6976
+ command.response_class = Google::Apis::ApigeeV1::GoogleApiHttpBody
6977
+ command.params['name'] = name unless name.nil?
6978
+ command.query['fields'] = fields unless fields.nil?
6979
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
6980
+ execute_or_queue_command(command, &block)
6981
+ end
6982
+
6983
+ # After the query is completed, use this API to view the query result when
6984
+ # result size is small.
6985
+ # @param [String] name
6986
+ # Required. Name of the security report result view to get. Must be of the form `
6987
+ # organizations/`org`/environments/`env`/securityReports/`reportId`/resultView`.
6988
+ # @param [String] fields
6989
+ # Selector specifying which fields to include in a partial response.
6990
+ # @param [String] quota_user
6991
+ # Available to use for quota purposes for server-side applications. Can be any
6992
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
6993
+ # @param [Google::Apis::RequestOptions] options
6994
+ # Request-specific options
6995
+ #
6996
+ # @yield [result, err] Result & error if block supplied
6997
+ # @yieldparam result [Google::Apis::ApigeeV1::GoogleCloudApigeeV1SecurityReportResultView] parsed result object
6998
+ # @yieldparam err [StandardError] error object if request failed
6999
+ #
7000
+ # @return [Google::Apis::ApigeeV1::GoogleCloudApigeeV1SecurityReportResultView]
7001
+ #
7002
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
7003
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
7004
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
7005
+ def get_organization_environment_security_report_result_view(name, fields: nil, quota_user: nil, options: nil, &block)
7006
+ command = make_simple_command(:get, 'v1/{+name}', options)
7007
+ command.response_representation = Google::Apis::ApigeeV1::GoogleCloudApigeeV1SecurityReportResultView::Representation
7008
+ command.response_class = Google::Apis::ApigeeV1::GoogleCloudApigeeV1SecurityReportResultView
7009
+ command.params['name'] = name unless name.nil?
7010
+ command.query['fields'] = fields unless fields.nil?
7011
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
7012
+ execute_or_queue_command(command, &block)
7013
+ end
7014
+
7015
+ # Return a list of Security Reports
7016
+ # @param [String] parent
7017
+ # Required. The parent resource name. Must be of the form `organizations/`org`/
7018
+ # environments/`env``.
7019
+ # @param [String] dataset
7020
+ # Filter response list by dataset. Example: `api`, `mint`
7021
+ # @param [String] from
7022
+ # Filter response list by returning security reports that created after this
7023
+ # date time. Time must be in ISO date-time format like '2011-12-03T10:15:30Z'.
7024
+ # @param [Fixnum] page_size
7025
+ # The maximum number of security report to return in the list response.
7026
+ # @param [String] page_token
7027
+ # Token returned from the previous list response to fetch the next page.
7028
+ # @param [String] status
7029
+ # Filter response list by security reports status.
7030
+ # @param [String] submitted_by
7031
+ # Filter response list by user who submitted queries.
7032
+ # @param [String] to
7033
+ # Filter response list by returning security reports that created before this
7034
+ # date time. Time must be in ISO date-time format like '2011-12-03T10:16:30Z'.
7035
+ # @param [String] fields
7036
+ # Selector specifying which fields to include in a partial response.
7037
+ # @param [String] quota_user
7038
+ # Available to use for quota purposes for server-side applications. Can be any
7039
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
7040
+ # @param [Google::Apis::RequestOptions] options
7041
+ # Request-specific options
7042
+ #
7043
+ # @yield [result, err] Result & error if block supplied
7044
+ # @yieldparam result [Google::Apis::ApigeeV1::GoogleCloudApigeeV1ListSecurityReportsResponse] parsed result object
7045
+ # @yieldparam err [StandardError] error object if request failed
7046
+ #
7047
+ # @return [Google::Apis::ApigeeV1::GoogleCloudApigeeV1ListSecurityReportsResponse]
7048
+ #
7049
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
7050
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
7051
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
7052
+ def list_organization_environment_security_reports(parent, dataset: nil, from: nil, page_size: nil, page_token: nil, status: nil, submitted_by: nil, to: nil, fields: nil, quota_user: nil, options: nil, &block)
7053
+ command = make_simple_command(:get, 'v1/{+parent}/securityReports', options)
7054
+ command.response_representation = Google::Apis::ApigeeV1::GoogleCloudApigeeV1ListSecurityReportsResponse::Representation
7055
+ command.response_class = Google::Apis::ApigeeV1::GoogleCloudApigeeV1ListSecurityReportsResponse
7056
+ command.params['parent'] = parent unless parent.nil?
7057
+ command.query['dataset'] = dataset unless dataset.nil?
7058
+ command.query['from'] = from unless from.nil?
7059
+ command.query['pageSize'] = page_size unless page_size.nil?
7060
+ command.query['pageToken'] = page_token unless page_token.nil?
7061
+ command.query['status'] = status unless status.nil?
7062
+ command.query['submittedBy'] = submitted_by unless submitted_by.nil?
7063
+ command.query['to'] = to unless to.nil?
7064
+ command.query['fields'] = fields unless fields.nil?
7065
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
7066
+ execute_or_queue_command(command, &block)
7067
+ end
7068
+
6877
7069
  # Lists all deployments of a shared flow in an environment.
6878
7070
  # @param [String] parent
6879
7071
  # Required. Name representing a shared flow in an environment in the following
@@ -7632,6 +7824,198 @@ module Google
7632
7824
  execute_or_queue_command(command, &block)
7633
7825
  end
7634
7826
 
7827
+ # Submit a query at host level to be processed in the background. If the
7828
+ # submission of the query succeeds, the API returns a 201 status and an ID that
7829
+ # refer to the query. In addition to the HTTP status 201, the `state` of "
7830
+ # enqueued" means that the request succeeded.
7831
+ # @param [String] parent
7832
+ # Required. The parent resource name. Must be of the form `organizations/`org``.
7833
+ # @param [Google::Apis::ApigeeV1::GoogleCloudApigeeV1SecurityReportQuery] google_cloud_apigee_v1_security_report_query_object
7834
+ # @param [String] fields
7835
+ # Selector specifying which fields to include in a partial response.
7836
+ # @param [String] quota_user
7837
+ # Available to use for quota purposes for server-side applications. Can be any
7838
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
7839
+ # @param [Google::Apis::RequestOptions] options
7840
+ # Request-specific options
7841
+ #
7842
+ # @yield [result, err] Result & error if block supplied
7843
+ # @yieldparam result [Google::Apis::ApigeeV1::GoogleCloudApigeeV1SecurityReport] parsed result object
7844
+ # @yieldparam err [StandardError] error object if request failed
7845
+ #
7846
+ # @return [Google::Apis::ApigeeV1::GoogleCloudApigeeV1SecurityReport]
7847
+ #
7848
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
7849
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
7850
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
7851
+ def create_organization_host_security_report(parent, google_cloud_apigee_v1_security_report_query_object = nil, fields: nil, quota_user: nil, options: nil, &block)
7852
+ command = make_simple_command(:post, 'v1/{+parent}/hostSecurityReports', options)
7853
+ command.request_representation = Google::Apis::ApigeeV1::GoogleCloudApigeeV1SecurityReportQuery::Representation
7854
+ command.request_object = google_cloud_apigee_v1_security_report_query_object
7855
+ command.response_representation = Google::Apis::ApigeeV1::GoogleCloudApigeeV1SecurityReport::Representation
7856
+ command.response_class = Google::Apis::ApigeeV1::GoogleCloudApigeeV1SecurityReport
7857
+ command.params['parent'] = parent unless parent.nil?
7858
+ command.query['fields'] = fields unless fields.nil?
7859
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
7860
+ execute_or_queue_command(command, &block)
7861
+ end
7862
+
7863
+ # Get status of a query submitted at host level. If the query is still in
7864
+ # progress, the `state` is set to "running" After the query has completed
7865
+ # successfully, `state` is set to "completed"
7866
+ # @param [String] name
7867
+ # Required. Name of the security report to get. Must be of the form `
7868
+ # organizations/`org`/securityReports/`reportId``.
7869
+ # @param [String] fields
7870
+ # Selector specifying which fields to include in a partial response.
7871
+ # @param [String] quota_user
7872
+ # Available to use for quota purposes for server-side applications. Can be any
7873
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
7874
+ # @param [Google::Apis::RequestOptions] options
7875
+ # Request-specific options
7876
+ #
7877
+ # @yield [result, err] Result & error if block supplied
7878
+ # @yieldparam result [Google::Apis::ApigeeV1::GoogleCloudApigeeV1SecurityReport] parsed result object
7879
+ # @yieldparam err [StandardError] error object if request failed
7880
+ #
7881
+ # @return [Google::Apis::ApigeeV1::GoogleCloudApigeeV1SecurityReport]
7882
+ #
7883
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
7884
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
7885
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
7886
+ def get_organization_host_security_report(name, fields: nil, quota_user: nil, options: nil, &block)
7887
+ command = make_simple_command(:get, 'v1/{+name}', options)
7888
+ command.response_representation = Google::Apis::ApigeeV1::GoogleCloudApigeeV1SecurityReport::Representation
7889
+ command.response_class = Google::Apis::ApigeeV1::GoogleCloudApigeeV1SecurityReport
7890
+ command.params['name'] = name unless name.nil?
7891
+ command.query['fields'] = fields unless fields.nil?
7892
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
7893
+ execute_or_queue_command(command, &block)
7894
+ end
7895
+
7896
+ # After the query is completed, use this API to retrieve the results. If the
7897
+ # request succeeds, and there is a non-zero result set, the result is downloaded
7898
+ # to the client as a zipped JSON file. The name of the downloaded file will be:
7899
+ # OfflineQueryResult-.zip Example: `OfflineQueryResult-9cfc0d85-0f30-46d6-ae6f-
7900
+ # 318d0cb961bd.zip`
7901
+ # @param [String] name
7902
+ # Required. Name of the security report result to get. Must be of the form `
7903
+ # organizations/`org`/securityReports/`reportId`/result`.
7904
+ # @param [String] fields
7905
+ # Selector specifying which fields to include in a partial response.
7906
+ # @param [String] quota_user
7907
+ # Available to use for quota purposes for server-side applications. Can be any
7908
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
7909
+ # @param [Google::Apis::RequestOptions] options
7910
+ # Request-specific options
7911
+ #
7912
+ # @yield [result, err] Result & error if block supplied
7913
+ # @yieldparam result [Google::Apis::ApigeeV1::GoogleApiHttpBody] parsed result object
7914
+ # @yieldparam err [StandardError] error object if request failed
7915
+ #
7916
+ # @return [Google::Apis::ApigeeV1::GoogleApiHttpBody]
7917
+ #
7918
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
7919
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
7920
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
7921
+ def get_organization_host_security_report_result(name, fields: nil, quota_user: nil, options: nil, &block)
7922
+ command = make_simple_command(:get, 'v1/{+name}', options)
7923
+ command.response_representation = Google::Apis::ApigeeV1::GoogleApiHttpBody::Representation
7924
+ command.response_class = Google::Apis::ApigeeV1::GoogleApiHttpBody
7925
+ command.params['name'] = name unless name.nil?
7926
+ command.query['fields'] = fields unless fields.nil?
7927
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
7928
+ execute_or_queue_command(command, &block)
7929
+ end
7930
+
7931
+ # After the query is completed, use this API to view the query result when
7932
+ # result size is small.
7933
+ # @param [String] name
7934
+ # Required. Name of the security report result view to get. Must be of the form `
7935
+ # organizations/`org`/securityReports/`reportId`/resultView`.
7936
+ # @param [String] fields
7937
+ # Selector specifying which fields to include in a partial response.
7938
+ # @param [String] quota_user
7939
+ # Available to use for quota purposes for server-side applications. Can be any
7940
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
7941
+ # @param [Google::Apis::RequestOptions] options
7942
+ # Request-specific options
7943
+ #
7944
+ # @yield [result, err] Result & error if block supplied
7945
+ # @yieldparam result [Google::Apis::ApigeeV1::GoogleCloudApigeeV1SecurityReportResultView] parsed result object
7946
+ # @yieldparam err [StandardError] error object if request failed
7947
+ #
7948
+ # @return [Google::Apis::ApigeeV1::GoogleCloudApigeeV1SecurityReportResultView]
7949
+ #
7950
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
7951
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
7952
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
7953
+ def get_organization_host_security_report_result_view(name, fields: nil, quota_user: nil, options: nil, &block)
7954
+ command = make_simple_command(:get, 'v1/{+name}', options)
7955
+ command.response_representation = Google::Apis::ApigeeV1::GoogleCloudApigeeV1SecurityReportResultView::Representation
7956
+ command.response_class = Google::Apis::ApigeeV1::GoogleCloudApigeeV1SecurityReportResultView
7957
+ command.params['name'] = name unless name.nil?
7958
+ command.query['fields'] = fields unless fields.nil?
7959
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
7960
+ execute_or_queue_command(command, &block)
7961
+ end
7962
+
7963
+ # Return a list of Security Reports at host level.
7964
+ # @param [String] parent
7965
+ # Required. The parent resource name. Must be of the form `organizations/`org``.
7966
+ # @param [String] dataset
7967
+ # Filter response list by dataset. Example: `api`, `mint`
7968
+ # @param [String] envgroup_hostname
7969
+ # Required. Filter response list by hostname.
7970
+ # @param [String] from
7971
+ # Filter response list by returning security reports that created after this
7972
+ # date time. Time must be in ISO date-time format like '2011-12-03T10:15:30Z'.
7973
+ # @param [Fixnum] page_size
7974
+ # The maximum number of security report to return in the list response.
7975
+ # @param [String] page_token
7976
+ # Token returned from the previous list response to fetch the next page.
7977
+ # @param [String] status
7978
+ # Filter response list by security report status.
7979
+ # @param [String] submitted_by
7980
+ # Filter response list by user who submitted queries.
7981
+ # @param [String] to
7982
+ # Filter response list by returning security reports that created before this
7983
+ # date time. Time must be in ISO date-time format like '2011-12-03T10:16:30Z'.
7984
+ # @param [String] fields
7985
+ # Selector specifying which fields to include in a partial response.
7986
+ # @param [String] quota_user
7987
+ # Available to use for quota purposes for server-side applications. Can be any
7988
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
7989
+ # @param [Google::Apis::RequestOptions] options
7990
+ # Request-specific options
7991
+ #
7992
+ # @yield [result, err] Result & error if block supplied
7993
+ # @yieldparam result [Google::Apis::ApigeeV1::GoogleCloudApigeeV1ListSecurityReportsResponse] parsed result object
7994
+ # @yieldparam err [StandardError] error object if request failed
7995
+ #
7996
+ # @return [Google::Apis::ApigeeV1::GoogleCloudApigeeV1ListSecurityReportsResponse]
7997
+ #
7998
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
7999
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
8000
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
8001
+ def list_organization_host_security_reports(parent, dataset: nil, envgroup_hostname: nil, from: nil, page_size: nil, page_token: nil, status: nil, submitted_by: nil, to: nil, fields: nil, quota_user: nil, options: nil, &block)
8002
+ command = make_simple_command(:get, 'v1/{+parent}/hostSecurityReports', options)
8003
+ command.response_representation = Google::Apis::ApigeeV1::GoogleCloudApigeeV1ListSecurityReportsResponse::Representation
8004
+ command.response_class = Google::Apis::ApigeeV1::GoogleCloudApigeeV1ListSecurityReportsResponse
8005
+ command.params['parent'] = parent unless parent.nil?
8006
+ command.query['dataset'] = dataset unless dataset.nil?
8007
+ command.query['envgroupHostname'] = envgroup_hostname unless envgroup_hostname.nil?
8008
+ command.query['from'] = from unless from.nil?
8009
+ command.query['pageSize'] = page_size unless page_size.nil?
8010
+ command.query['pageToken'] = page_token unless page_token.nil?
8011
+ command.query['status'] = status unless status.nil?
8012
+ command.query['submittedBy'] = submitted_by unless submitted_by.nil?
8013
+ command.query['to'] = to unless to.nil?
8014
+ command.query['fields'] = fields unless fields.nil?
8015
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
8016
+ execute_or_queue_command(command, &block)
8017
+ end
8018
+
7635
8019
  # Retrieve metrics grouped by dimensions in host level. The types of metrics you
7636
8020
  # can retrieve include traffic, message counts, API call latency, response size,
7637
8021
  # and cache hits and counts. Dimensions let you view metrics in meaningful
@@ -8863,6 +9247,222 @@ module Google
8863
9247
  execute_or_queue_command(command, &block)
8864
9248
  end
8865
9249
 
9250
+ # GetSecurityProfile gets the specified security profile. Returns NOT_FOUND if
9251
+ # security profile is not present for the specified organization.
9252
+ # @param [String] name
9253
+ # Required. Security profile in the following format: `organizations/`org`/
9254
+ # securityProfiles/`profile`'. Profile may optionally contain revision ID. If
9255
+ # revision ID is not provided, the response will contain latest revision by
9256
+ # default. Example: organizations/testOrg/securityProfiles/testProfile@5
9257
+ # @param [String] fields
9258
+ # Selector specifying which fields to include in a partial response.
9259
+ # @param [String] quota_user
9260
+ # Available to use for quota purposes for server-side applications. Can be any
9261
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
9262
+ # @param [Google::Apis::RequestOptions] options
9263
+ # Request-specific options
9264
+ #
9265
+ # @yield [result, err] Result & error if block supplied
9266
+ # @yieldparam result [Google::Apis::ApigeeV1::GoogleCloudApigeeV1SecurityProfile] parsed result object
9267
+ # @yieldparam err [StandardError] error object if request failed
9268
+ #
9269
+ # @return [Google::Apis::ApigeeV1::GoogleCloudApigeeV1SecurityProfile]
9270
+ #
9271
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
9272
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
9273
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
9274
+ def get_organization_security_profile(name, fields: nil, quota_user: nil, options: nil, &block)
9275
+ command = make_simple_command(:get, 'v1/{+name}', options)
9276
+ command.response_representation = Google::Apis::ApigeeV1::GoogleCloudApigeeV1SecurityProfile::Representation
9277
+ command.response_class = Google::Apis::ApigeeV1::GoogleCloudApigeeV1SecurityProfile
9278
+ command.params['name'] = name unless name.nil?
9279
+ command.query['fields'] = fields unless fields.nil?
9280
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
9281
+ execute_or_queue_command(command, &block)
9282
+ end
9283
+
9284
+ # ListSecurityProfiles lists all the security profiles associated with the org
9285
+ # including attached and unattached profiles.
9286
+ # @param [String] parent
9287
+ # Required. For a specific organization, list of all the security profiles.
9288
+ # Format: `organizations/`org``
9289
+ # @param [Fixnum] page_size
9290
+ # The maximum number of profiles to return. The service may return fewer than
9291
+ # this value. If unspecified, at most 50 profiles will be returned.
9292
+ # @param [String] page_token
9293
+ # A page token, received from a previous `ListSecurityProfiles` call. Provide
9294
+ # this to retrieve the subsequent page.
9295
+ # @param [String] fields
9296
+ # Selector specifying which fields to include in a partial response.
9297
+ # @param [String] quota_user
9298
+ # Available to use for quota purposes for server-side applications. Can be any
9299
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
9300
+ # @param [Google::Apis::RequestOptions] options
9301
+ # Request-specific options
9302
+ #
9303
+ # @yield [result, err] Result & error if block supplied
9304
+ # @yieldparam result [Google::Apis::ApigeeV1::GoogleCloudApigeeV1ListSecurityProfilesResponse] parsed result object
9305
+ # @yieldparam err [StandardError] error object if request failed
9306
+ #
9307
+ # @return [Google::Apis::ApigeeV1::GoogleCloudApigeeV1ListSecurityProfilesResponse]
9308
+ #
9309
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
9310
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
9311
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
9312
+ def list_organization_security_profiles(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
9313
+ command = make_simple_command(:get, 'v1/{+parent}/securityProfiles', options)
9314
+ command.response_representation = Google::Apis::ApigeeV1::GoogleCloudApigeeV1ListSecurityProfilesResponse::Representation
9315
+ command.response_class = Google::Apis::ApigeeV1::GoogleCloudApigeeV1ListSecurityProfilesResponse
9316
+ command.params['parent'] = parent unless parent.nil?
9317
+ command.query['pageSize'] = page_size unless page_size.nil?
9318
+ command.query['pageToken'] = page_token unless page_token.nil?
9319
+ command.query['fields'] = fields unless fields.nil?
9320
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
9321
+ execute_or_queue_command(command, &block)
9322
+ end
9323
+
9324
+ # ListSecurityProfileRevisions lists all the revisions of the security profile.
9325
+ # @param [String] name
9326
+ # Required. For a specific profile, list all the revisions. Format: `
9327
+ # organizations/`org`/securityProfiles/`profile``
9328
+ # @param [Fixnum] page_size
9329
+ # The maximum number of profile revisions to return. The service may return
9330
+ # fewer than this value. If unspecified, at most 50 revisions will be returned.
9331
+ # @param [String] page_token
9332
+ # A page token, received from a previous `ListSecurityProfileRevisions` call.
9333
+ # Provide this to retrieve the subsequent page.
9334
+ # @param [String] fields
9335
+ # Selector specifying which fields to include in a partial response.
9336
+ # @param [String] quota_user
9337
+ # Available to use for quota purposes for server-side applications. Can be any
9338
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
9339
+ # @param [Google::Apis::RequestOptions] options
9340
+ # Request-specific options
9341
+ #
9342
+ # @yield [result, err] Result & error if block supplied
9343
+ # @yieldparam result [Google::Apis::ApigeeV1::GoogleCloudApigeeV1ListSecurityProfileRevisionsResponse] parsed result object
9344
+ # @yieldparam err [StandardError] error object if request failed
9345
+ #
9346
+ # @return [Google::Apis::ApigeeV1::GoogleCloudApigeeV1ListSecurityProfileRevisionsResponse]
9347
+ #
9348
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
9349
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
9350
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
9351
+ def list_organization_security_profile_revisions(name, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
9352
+ command = make_simple_command(:get, 'v1/{+name}:listRevisions', options)
9353
+ command.response_representation = Google::Apis::ApigeeV1::GoogleCloudApigeeV1ListSecurityProfileRevisionsResponse::Representation
9354
+ command.response_class = Google::Apis::ApigeeV1::GoogleCloudApigeeV1ListSecurityProfileRevisionsResponse
9355
+ command.params['name'] = name unless name.nil?
9356
+ command.query['pageSize'] = page_size unless page_size.nil?
9357
+ command.query['pageToken'] = page_token unless page_token.nil?
9358
+ command.query['fields'] = fields unless fields.nil?
9359
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
9360
+ execute_or_queue_command(command, &block)
9361
+ end
9362
+
9363
+ # ComputeEnvironmentScores calculates scores for requested time range for the
9364
+ # specified security profile and environment.
9365
+ # @param [String] profile_environment
9366
+ # Required. Name of organization and environment and profile id for which score
9367
+ # needs to be computed. Format: organizations/`org`/securityProfiles/`profile`/
9368
+ # environments/`env`
9369
+ # @param [Google::Apis::ApigeeV1::GoogleCloudApigeeV1ComputeEnvironmentScoresRequest] google_cloud_apigee_v1_compute_environment_scores_request_object
9370
+ # @param [String] fields
9371
+ # Selector specifying which fields to include in a partial response.
9372
+ # @param [String] quota_user
9373
+ # Available to use for quota purposes for server-side applications. Can be any
9374
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
9375
+ # @param [Google::Apis::RequestOptions] options
9376
+ # Request-specific options
9377
+ #
9378
+ # @yield [result, err] Result & error if block supplied
9379
+ # @yieldparam result [Google::Apis::ApigeeV1::GoogleCloudApigeeV1ComputeEnvironmentScoresResponse] parsed result object
9380
+ # @yieldparam err [StandardError] error object if request failed
9381
+ #
9382
+ # @return [Google::Apis::ApigeeV1::GoogleCloudApigeeV1ComputeEnvironmentScoresResponse]
9383
+ #
9384
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
9385
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
9386
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
9387
+ def compute_organization_security_profile_environment_environment_scores(profile_environment, google_cloud_apigee_v1_compute_environment_scores_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
9388
+ command = make_simple_command(:post, 'v1/{+profileEnvironment}:computeEnvironmentScores', options)
9389
+ command.request_representation = Google::Apis::ApigeeV1::GoogleCloudApigeeV1ComputeEnvironmentScoresRequest::Representation
9390
+ command.request_object = google_cloud_apigee_v1_compute_environment_scores_request_object
9391
+ command.response_representation = Google::Apis::ApigeeV1::GoogleCloudApigeeV1ComputeEnvironmentScoresResponse::Representation
9392
+ command.response_class = Google::Apis::ApigeeV1::GoogleCloudApigeeV1ComputeEnvironmentScoresResponse
9393
+ command.params['profileEnvironment'] = profile_environment unless profile_environment.nil?
9394
+ command.query['fields'] = fields unless fields.nil?
9395
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
9396
+ execute_or_queue_command(command, &block)
9397
+ end
9398
+
9399
+ # CreateSecurityProfileEnvironmentAssociation creates profile environment
9400
+ # association i.e. attaches environment to security profile.
9401
+ # @param [String] parent
9402
+ # Required. Name of organization and security profile ID. Format: organizations/`
9403
+ # org`/securityProfiles/`profile`
9404
+ # @param [Google::Apis::ApigeeV1::GoogleCloudApigeeV1SecurityProfileEnvironmentAssociation] google_cloud_apigee_v1_security_profile_environment_association_object
9405
+ # @param [String] fields
9406
+ # Selector specifying which fields to include in a partial response.
9407
+ # @param [String] quota_user
9408
+ # Available to use for quota purposes for server-side applications. Can be any
9409
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
9410
+ # @param [Google::Apis::RequestOptions] options
9411
+ # Request-specific options
9412
+ #
9413
+ # @yield [result, err] Result & error if block supplied
9414
+ # @yieldparam result [Google::Apis::ApigeeV1::GoogleCloudApigeeV1SecurityProfileEnvironmentAssociation] parsed result object
9415
+ # @yieldparam err [StandardError] error object if request failed
9416
+ #
9417
+ # @return [Google::Apis::ApigeeV1::GoogleCloudApigeeV1SecurityProfileEnvironmentAssociation]
9418
+ #
9419
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
9420
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
9421
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
9422
+ def create_organization_security_profile_environment(parent, google_cloud_apigee_v1_security_profile_environment_association_object = nil, fields: nil, quota_user: nil, options: nil, &block)
9423
+ command = make_simple_command(:post, 'v1/{+parent}/environments', options)
9424
+ command.request_representation = Google::Apis::ApigeeV1::GoogleCloudApigeeV1SecurityProfileEnvironmentAssociation::Representation
9425
+ command.request_object = google_cloud_apigee_v1_security_profile_environment_association_object
9426
+ command.response_representation = Google::Apis::ApigeeV1::GoogleCloudApigeeV1SecurityProfileEnvironmentAssociation::Representation
9427
+ command.response_class = Google::Apis::ApigeeV1::GoogleCloudApigeeV1SecurityProfileEnvironmentAssociation
9428
+ command.params['parent'] = parent unless parent.nil?
9429
+ command.query['fields'] = fields unless fields.nil?
9430
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
9431
+ execute_or_queue_command(command, &block)
9432
+ end
9433
+
9434
+ # DeleteSecurityProfileEnvironmentAssociation removes profile environment
9435
+ # association i.e. detaches environment from security profile.
9436
+ # @param [String] name
9437
+ # Required. The name of the environment attachment to delete. Format:
9438
+ # organizations/`org`/securityProfiles/`profile`/environments/`env`
9439
+ # @param [String] fields
9440
+ # Selector specifying which fields to include in a partial response.
9441
+ # @param [String] quota_user
9442
+ # Available to use for quota purposes for server-side applications. Can be any
9443
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
9444
+ # @param [Google::Apis::RequestOptions] options
9445
+ # Request-specific options
9446
+ #
9447
+ # @yield [result, err] Result & error if block supplied
9448
+ # @yieldparam result [Google::Apis::ApigeeV1::GoogleProtobufEmpty] parsed result object
9449
+ # @yieldparam err [StandardError] error object if request failed
9450
+ #
9451
+ # @return [Google::Apis::ApigeeV1::GoogleProtobufEmpty]
9452
+ #
9453
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
9454
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
9455
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
9456
+ def delete_organization_security_profile_environment(name, fields: nil, quota_user: nil, options: nil, &block)
9457
+ command = make_simple_command(:delete, 'v1/{+name}', options)
9458
+ command.response_representation = Google::Apis::ApigeeV1::GoogleProtobufEmpty::Representation
9459
+ command.response_class = Google::Apis::ApigeeV1::GoogleProtobufEmpty
9460
+ command.params['name'] = name unless name.nil?
9461
+ command.query['fields'] = fields unless fields.nil?
9462
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
9463
+ execute_or_queue_command(command, &block)
9464
+ end
9465
+
8866
9466
  # Uploads a ZIP-formatted shared flow configuration bundle to an organization.
8867
9467
  # If the shared flow already exists, this creates a new revision of it. If the
8868
9468
  # shared flow does not exist, this creates it. Once imported, the shared flow