google-apis-apigee_v1 0.48.0 → 0.51.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -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