generated/google/apis/sourcerepo_v1/service.rb in google-api-client-0.11.3 vs generated/google/apis/sourcerepo_v1/service.rb in google-api-client-0.12.0

- old
+ new

@@ -45,246 +45,247 @@ def initialize super('https://sourcerepo.googleapis.com/', '') @batch_path = 'batch' end - # Deletes a repo. - # @param [String] name - # The name of the repo to delete. Values are of the form - # `projects/<project>/repos/<repo>`. + # Gets the access control policy for a resource. + # Returns an empty policy if the resource exists and does not have a policy + # set. + # @param [String] resource + # REQUIRED: The resource for which the policy is being requested. + # See the operation documentation for the appropriate value for this field. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user # Available to use for quota purposes for server-side applications. Can be any # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # # @yield [result, err] Result & error if block supplied - # @yieldparam result [Google::Apis::SourcerepoV1::Empty] parsed result object + # @yieldparam result [Google::Apis::SourcerepoV1::Policy] parsed result object # @yieldparam err [StandardError] error object if request failed # - # @return [Google::Apis::SourcerepoV1::Empty] + # @return [Google::Apis::SourcerepoV1::Policy] # # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def delete_project_repo(name, fields: nil, quota_user: nil, options: nil, &block) - command = make_simple_command(:delete, 'v1/{+name}', options) - command.response_representation = Google::Apis::SourcerepoV1::Empty::Representation - command.response_class = Google::Apis::SourcerepoV1::Empty - command.params['name'] = name unless name.nil? + def get_project_repo_iam_policy(resource, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:get, 'v1/{+resource}:getIamPolicy', options) + command.response_representation = Google::Apis::SourcerepoV1::Policy::Representation + command.response_class = Google::Apis::SourcerepoV1::Policy + command.params['resource'] = resource unless resource.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end - # Returns all repos belonging to a project. + # Returns information about a repo. # @param [String] name - # The project ID whose repos should be listed. Values are of the form - # `projects/<project>`. - # @param [String] page_token - # Resume listing repositories where a prior ListReposResponse - # left off. This is an opaque token that must be obtained from - # a recent, prior ListReposResponse's next_page_token field. - # @param [Fixnum] page_size - # Maximum number of repositories to return; between 1 and 500. - # If not set or zero, defaults to 100 at the server. + # The name of the requested repository. Values are of the form + # `projects/<project>/repos/<repo>`. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user # Available to use for quota purposes for server-side applications. Can be any # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # # @yield [result, err] Result & error if block supplied - # @yieldparam result [Google::Apis::SourcerepoV1::ListReposResponse] parsed result object + # @yieldparam result [Google::Apis::SourcerepoV1::Repo] parsed result object # @yieldparam err [StandardError] error object if request failed # - # @return [Google::Apis::SourcerepoV1::ListReposResponse] + # @return [Google::Apis::SourcerepoV1::Repo] # # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def list_project_repos(name, page_token: nil, page_size: nil, fields: nil, quota_user: nil, options: nil, &block) - command = make_simple_command(:get, 'v1/{+name}/repos', options) - command.response_representation = Google::Apis::SourcerepoV1::ListReposResponse::Representation - command.response_class = Google::Apis::SourcerepoV1::ListReposResponse + def get_project_repo(name, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:get, 'v1/{+name}', options) + command.response_representation = Google::Apis::SourcerepoV1::Repo::Representation + command.response_class = Google::Apis::SourcerepoV1::Repo command.params['name'] = name unless name.nil? - command.query['pageToken'] = page_token unless page_token.nil? - command.query['pageSize'] = page_size unless page_size.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end - # Creates a repo in the given project with the given name.. - # If the named repository already exists, `CreateRepo` returns - # `ALREADY_EXISTS`. - # @param [String] parent - # The project in which to create the repo. Values are of the form - # `projects/<project>`. - # @param [Google::Apis::SourcerepoV1::Repo] repo_object + # Returns permissions that a caller has on the specified resource. + # If the resource does not exist, this will return an empty set of + # permissions, not a NOT_FOUND error. + # @param [String] resource + # REQUIRED: The resource for which the policy detail is being requested. + # See the operation documentation for the appropriate value for this field. + # @param [Google::Apis::SourcerepoV1::TestIamPermissionsRequest] test_iam_permissions_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user # Available to use for quota purposes for server-side applications. Can be any # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # # @yield [result, err] Result & error if block supplied - # @yieldparam result [Google::Apis::SourcerepoV1::Repo] parsed result object + # @yieldparam result [Google::Apis::SourcerepoV1::TestIamPermissionsResponse] parsed result object # @yieldparam err [StandardError] error object if request failed # - # @return [Google::Apis::SourcerepoV1::Repo] + # @return [Google::Apis::SourcerepoV1::TestIamPermissionsResponse] # # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def create_project_repo(parent, repo_object = nil, fields: nil, quota_user: nil, options: nil, &block) - command = make_simple_command(:post, 'v1/{+parent}/repos', options) - command.request_representation = Google::Apis::SourcerepoV1::Repo::Representation - command.request_object = repo_object - command.response_representation = Google::Apis::SourcerepoV1::Repo::Representation - command.response_class = Google::Apis::SourcerepoV1::Repo - command.params['parent'] = parent unless parent.nil? + def test_repo_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options) + command.request_representation = Google::Apis::SourcerepoV1::TestIamPermissionsRequest::Representation + command.request_object = test_iam_permissions_request_object + command.response_representation = Google::Apis::SourcerepoV1::TestIamPermissionsResponse::Representation + command.response_class = Google::Apis::SourcerepoV1::TestIamPermissionsResponse + command.params['resource'] = resource unless resource.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end - # Sets the access control policy on the specified resource. Replaces any - # existing policy. - # @param [String] resource - # REQUIRED: The resource for which the policy is being specified. - # See the operation documentation for the appropriate value for this field. - # @param [Google::Apis::SourcerepoV1::SetIamPolicyRequest] set_iam_policy_request_object + # Deletes a repo. + # @param [String] name + # The name of the repo to delete. Values are of the form + # `projects/<project>/repos/<repo>`. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user # Available to use for quota purposes for server-side applications. Can be any # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # # @yield [result, err] Result & error if block supplied - # @yieldparam result [Google::Apis::SourcerepoV1::Policy] parsed result object + # @yieldparam result [Google::Apis::SourcerepoV1::Empty] parsed result object # @yieldparam err [StandardError] error object if request failed # - # @return [Google::Apis::SourcerepoV1::Policy] + # @return [Google::Apis::SourcerepoV1::Empty] # # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def set_repo_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) - command = make_simple_command(:post, 'v1/{+resource}:setIamPolicy', options) - command.request_representation = Google::Apis::SourcerepoV1::SetIamPolicyRequest::Representation - command.request_object = set_iam_policy_request_object - command.response_representation = Google::Apis::SourcerepoV1::Policy::Representation - command.response_class = Google::Apis::SourcerepoV1::Policy - command.params['resource'] = resource unless resource.nil? + def delete_project_repo(name, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:delete, 'v1/{+name}', options) + command.response_representation = Google::Apis::SourcerepoV1::Empty::Representation + command.response_class = Google::Apis::SourcerepoV1::Empty + command.params['name'] = name unless name.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end - # Gets the access control policy for a resource. - # Returns an empty policy if the resource exists and does not have a policy - # set. - # @param [String] resource - # REQUIRED: The resource for which the policy is being requested. - # See the operation documentation for the appropriate value for this field. + # Returns all repos belonging to a project. The sizes of the repos are + # not set by ListRepos. To get the size of a repo, use GetRepo. + # @param [String] name + # The project ID whose repos should be listed. Values are of the form + # `projects/<project>`. + # @param [String] page_token + # Resume listing repositories where a prior ListReposResponse + # left off. This is an opaque token that must be obtained from + # a recent, prior ListReposResponse's next_page_token field. + # @param [Fixnum] page_size + # Maximum number of repositories to return; between 1 and 500. + # If not set or zero, defaults to 100 at the server. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user # Available to use for quota purposes for server-side applications. Can be any # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # # @yield [result, err] Result & error if block supplied - # @yieldparam result [Google::Apis::SourcerepoV1::Policy] parsed result object + # @yieldparam result [Google::Apis::SourcerepoV1::ListReposResponse] parsed result object # @yieldparam err [StandardError] error object if request failed # - # @return [Google::Apis::SourcerepoV1::Policy] + # @return [Google::Apis::SourcerepoV1::ListReposResponse] # # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def get_project_repo_iam_policy(resource, fields: nil, quota_user: nil, options: nil, &block) - command = make_simple_command(:get, 'v1/{+resource}:getIamPolicy', options) - command.response_representation = Google::Apis::SourcerepoV1::Policy::Representation - command.response_class = Google::Apis::SourcerepoV1::Policy - command.params['resource'] = resource unless resource.nil? + def list_project_repos(name, page_token: nil, page_size: nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:get, 'v1/{+name}/repos', options) + command.response_representation = Google::Apis::SourcerepoV1::ListReposResponse::Representation + command.response_class = Google::Apis::SourcerepoV1::ListReposResponse + command.params['name'] = name unless name.nil? + command.query['pageToken'] = page_token unless page_token.nil? + command.query['pageSize'] = page_size unless page_size.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end - # Returns information about a repo. - # @param [String] name - # The name of the requested repository. Values are of the form - # `projects/<project>/repos/<repo>`. + # Sets the access control policy on the specified resource. Replaces any + # existing policy. + # @param [String] resource + # REQUIRED: The resource for which the policy is being specified. + # See the operation documentation for the appropriate value for this field. + # @param [Google::Apis::SourcerepoV1::SetIamPolicyRequest] set_iam_policy_request_object # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user # Available to use for quota purposes for server-side applications. Can be any # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # # @yield [result, err] Result & error if block supplied - # @yieldparam result [Google::Apis::SourcerepoV1::Repo] parsed result object + # @yieldparam result [Google::Apis::SourcerepoV1::Policy] parsed result object # @yieldparam err [StandardError] error object if request failed # - # @return [Google::Apis::SourcerepoV1::Repo] + # @return [Google::Apis::SourcerepoV1::Policy] # # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def get_project_repo(name, fields: nil, quota_user: nil, options: nil, &block) - command = make_simple_command(:get, 'v1/{+name}', options) - command.response_representation = Google::Apis::SourcerepoV1::Repo::Representation - command.response_class = Google::Apis::SourcerepoV1::Repo - command.params['name'] = name unless name.nil? + def set_repo_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:post, 'v1/{+resource}:setIamPolicy', options) + command.request_representation = Google::Apis::SourcerepoV1::SetIamPolicyRequest::Representation + command.request_object = set_iam_policy_request_object + command.response_representation = Google::Apis::SourcerepoV1::Policy::Representation + command.response_class = Google::Apis::SourcerepoV1::Policy + command.params['resource'] = resource unless resource.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end - # Returns permissions that a caller has on the specified resource. - # If the resource does not exist, this will return an empty set of - # permissions, not a NOT_FOUND error. - # @param [String] resource - # REQUIRED: The resource for which the policy detail is being requested. - # See the operation documentation for the appropriate value for this field. - # @param [Google::Apis::SourcerepoV1::TestIamPermissionsRequest] test_iam_permissions_request_object + # Creates a repo in the given project with the given name. + # If the named repository already exists, `CreateRepo` returns + # `ALREADY_EXISTS`. + # @param [String] parent + # The project in which to create the repo. Values are of the form + # `projects/<project>`. + # @param [Google::Apis::SourcerepoV1::Repo] repo_object # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user # Available to use for quota purposes for server-side applications. Can be any # arbitrary string assigned to a user, but should not exceed 40 characters. # @param [Google::Apis::RequestOptions] options # Request-specific options # # @yield [result, err] Result & error if block supplied - # @yieldparam result [Google::Apis::SourcerepoV1::TestIamPermissionsResponse] parsed result object + # @yieldparam result [Google::Apis::SourcerepoV1::Repo] parsed result object # @yieldparam err [StandardError] error object if request failed # - # @return [Google::Apis::SourcerepoV1::TestIamPermissionsResponse] + # @return [Google::Apis::SourcerepoV1::Repo] # # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification # @raise [Google::Apis::AuthorizationError] Authorization is required - def test_repo_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block) - command = make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options) - command.request_representation = Google::Apis::SourcerepoV1::TestIamPermissionsRequest::Representation - command.request_object = test_iam_permissions_request_object - command.response_representation = Google::Apis::SourcerepoV1::TestIamPermissionsResponse::Representation - command.response_class = Google::Apis::SourcerepoV1::TestIamPermissionsResponse - command.params['resource'] = resource unless resource.nil? + def create_project_repo(parent, repo_object = nil, fields: nil, quota_user: nil, options: nil, &block) + command = make_simple_command(:post, 'v1/{+parent}/repos', options) + command.request_representation = Google::Apis::SourcerepoV1::Repo::Representation + command.request_object = repo_object + command.response_representation = Google::Apis::SourcerepoV1::Repo::Representation + command.response_class = Google::Apis::SourcerepoV1::Repo + command.params['parent'] = parent unless parent.nil? command.query['fields'] = fields unless fields.nil? command.query['quotaUser'] = quota_user unless quota_user.nil? execute_or_queue_command(command, &block) end