google_api_service_management v0.11.0 GoogleApi.ServiceManagement.V1.Api.Services View Source

API calls for all endpoints tagged Services.

Link to this section Summary

Functions

Creates a new service configuration (version) for a managed service. This method only stores the service configuration. To roll out the service configuration to backend systems please call CreateServiceRollout.

Lists the history of the service configuration for a managed service, from the newest to the oldest.

Creates a new service configuration (version) for a managed service based on user-supplied configuration source files (for example: OpenAPI Specification). This method stores the source configurations as well as the generated service configuration. To rollout the service configuration to other services, please call CreateServiceRollout.

Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.

Sets the access control policy on the specified resource. Replaces any existing policy.

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.

Creates a new managed service. Please note one producer project can own no more than 20 services.

Deletes a managed service. This method will change the service to the Soft-Delete state for 30 days. Within this period, service producers may call UndeleteService to restore the service. After 30 days, the service will be permanently deleted.

Disables a service for a project, so it can no longer be be used for the project. It prevents accidental usage that may cause unexpected billing charges or security leaks.

Enables a service for a project, so it can be used for the project. See Cloud Auth Guide for more information.

Generates and returns a report (errors, warnings and changes from existing configurations) associated with GenerateConfigReportRequest.new_value

Gets a managed service. Authentication is required unless the service is public.

Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.

Creates a new service configuration rollout. Based on rollout, the Google Service Management will roll out the service configurations to different backend services. For example, the logging configuration will be pushed to Google Cloud Logging.

Lists the history of the service configuration rollouts for a managed service, from the newest to the oldest.

Sets the access control policy on the specified resource. Replaces any existing policy.

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.

Revives a previously deleted managed service. The method restores the service using the configuration at the time the service was deleted. The target service must exist and must have been deleted within the last 30 days.

Link to this section Functions

Link to this function

servicemanagement_services_configs_create(connection, service_name, optional_params \\ [], opts \\ []) View Source
servicemanagement_services_configs_create(
  Tesla.Env.client(),
  String.t(),
  keyword(),
  keyword()
) ::
  {:ok, GoogleApi.ServiceManagement.V1.Model.Service.t()}
  | {:error, Tesla.Env.t()}

Creates a new service configuration (version) for a managed service. This method only stores the service configuration. To roll out the service configuration to backend systems please call CreateServiceRollout.

Only the 100 most recent service configurations and ones referenced by existing rollouts are kept for each service. The rest will be deleted eventually.

Parameters

  • connection (type: GoogleApi.ServiceManagement.V1.Connection.t) - Connection to server
  • service_name (type: String.t) - The name of the service. See the overview for naming requirements. For example: example.googleapis.com.
  • optional_params (type: keyword()) - Optional parameters

    • :$.xgafv (type: String.t) - V1 error format.
    • :access_token (type: String.t) - OAuth access token.
    • :alt (type: String.t) - Data format for response.
    • :callback (type: String.t) - JSONP
    • :fields (type: String.t) - Selector specifying which fields to include in a partial response.
    • :key (type: String.t) - API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
    • :oauth_token (type: String.t) - OAuth 2.0 token for the current user.
    • :prettyPrint (type: boolean()) - Returns response with indentations and line breaks.
    • :quotaUser (type: String.t) - 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.
    • :uploadType (type: String.t) - Legacy upload protocol for media (e.g. "media", "multipart").
    • :upload_protocol (type: String.t) - Upload protocol for media (e.g. "raw", "multipart").
    • :body (type: GoogleApi.ServiceManagement.V1.Model.Service.t) -
  • opts (type: keyword()) - Call options

Returns

  • {:ok, %GoogleApi.ServiceManagement.V1.Model.Service{}} on success
  • {:error, info} on failure
Link to this function

servicemanagement_services_configs_get(connection, service_name, config_id, optional_params \\ [], opts \\ []) View Source
servicemanagement_services_configs_get(
  Tesla.Env.client(),
  String.t(),
  String.t(),
  keyword(),
  keyword()
) ::
  {:ok, GoogleApi.ServiceManagement.V1.Model.Service.t()}
  | {:error, Tesla.Env.t()}

Gets a service configuration (version) for a managed service.

Parameters

  • connection (type: GoogleApi.ServiceManagement.V1.Connection.t) - Connection to server

  • service_name (type: String.t) - The name of the service. See the overview for naming requirements. For example: example.googleapis.com.

  • config_id (type: String.t) - The id of the service configuration resource.

    This field must be specified for the server to return all fields, including SourceInfo.

  • optional_params (type: keyword()) - Optional parameters

    • :$.xgafv (type: String.t) - V1 error format.
    • :access_token (type: String.t) - OAuth access token.
    • :alt (type: String.t) - Data format for response.
    • :callback (type: String.t) - JSONP
    • :fields (type: String.t) - Selector specifying which fields to include in a partial response.
    • :key (type: String.t) - API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
    • :oauth_token (type: String.t) - OAuth 2.0 token for the current user.
    • :prettyPrint (type: boolean()) - Returns response with indentations and line breaks.
    • :quotaUser (type: String.t) - 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.
    • :uploadType (type: String.t) - Legacy upload protocol for media (e.g. "media", "multipart").
    • :upload_protocol (type: String.t) - Upload protocol for media (e.g. "raw", "multipart").
    • :view (type: String.t) - Specifies which parts of the Service Config should be returned in the response.
  • opts (type: keyword()) - Call options

Returns

  • {:ok, %GoogleApi.ServiceManagement.V1.Model.Service{}} on success
  • {:error, info} on failure
Link to this function

servicemanagement_services_configs_list(connection, service_name, optional_params \\ [], opts \\ []) View Source
servicemanagement_services_configs_list(
  Tesla.Env.client(),
  String.t(),
  keyword(),
  keyword()
) ::
  {:ok, GoogleApi.ServiceManagement.V1.Model.ListServiceConfigsResponse.t()}
  | {:error, Tesla.Env.t()}

Lists the history of the service configuration for a managed service, from the newest to the oldest.

Parameters

  • connection (type: GoogleApi.ServiceManagement.V1.Connection.t) - Connection to server
  • service_name (type: String.t) - The name of the service. See the overview for naming requirements. For example: example.googleapis.com.
  • optional_params (type: keyword()) - Optional parameters

    • :$.xgafv (type: String.t) - V1 error format.
    • :access_token (type: String.t) - OAuth access token.
    • :alt (type: String.t) - Data format for response.
    • :callback (type: String.t) - JSONP
    • :fields (type: String.t) - Selector specifying which fields to include in a partial response.
    • :key (type: String.t) - API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
    • :oauth_token (type: String.t) - OAuth 2.0 token for the current user.
    • :prettyPrint (type: boolean()) - Returns response with indentations and line breaks.
    • :quotaUser (type: String.t) - 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.
    • :uploadType (type: String.t) - Legacy upload protocol for media (e.g. "media", "multipart").
    • :upload_protocol (type: String.t) - Upload protocol for media (e.g. "raw", "multipart").
    • :pageSize (type: integer()) - The max number of items to include in the response list. Page size is 50 if not specified. Maximum value is 100.
    • :pageToken (type: String.t) - The token of the page to retrieve.
  • opts (type: keyword()) - Call options

Returns

  • {:ok, %GoogleApi.ServiceManagement.V1.Model.ListServiceConfigsResponse{}} on success
  • {:error, info} on failure
Link to this function

servicemanagement_services_configs_submit(connection, service_name, optional_params \\ [], opts \\ []) View Source
servicemanagement_services_configs_submit(
  Tesla.Env.client(),
  String.t(),
  keyword(),
  keyword()
) ::
  {:ok, GoogleApi.ServiceManagement.V1.Model.Operation.t()}
  | {:error, Tesla.Env.t()}

Creates a new service configuration (version) for a managed service based on user-supplied configuration source files (for example: OpenAPI Specification). This method stores the source configurations as well as the generated service configuration. To rollout the service configuration to other services, please call CreateServiceRollout.

Only the 100 most recent configuration sources and ones referenced by existing service configurtions are kept for each service. The rest will be deleted eventually.

Operation

Parameters

  • connection (type: GoogleApi.ServiceManagement.V1.Connection.t) - Connection to server
  • service_name (type: String.t) - The name of the service. See the overview for naming requirements. For example: example.googleapis.com.
  • optional_params (type: keyword()) - Optional parameters

    • :$.xgafv (type: String.t) - V1 error format.
    • :access_token (type: String.t) - OAuth access token.
    • :alt (type: String.t) - Data format for response.
    • :callback (type: String.t) - JSONP
    • :fields (type: String.t) - Selector specifying which fields to include in a partial response.
    • :key (type: String.t) - API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
    • :oauth_token (type: String.t) - OAuth 2.0 token for the current user.
    • :prettyPrint (type: boolean()) - Returns response with indentations and line breaks.
    • :quotaUser (type: String.t) - 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.
    • :uploadType (type: String.t) - Legacy upload protocol for media (e.g. "media", "multipart").
    • :upload_protocol (type: String.t) - Upload protocol for media (e.g. "raw", "multipart").
    • :body (type: GoogleApi.ServiceManagement.V1.Model.SubmitConfigSourceRequest.t) -
  • opts (type: keyword()) - Call options

Returns

  • {:ok, %GoogleApi.ServiceManagement.V1.Model.Operation{}} on success
  • {:error, info} on failure
Link to this function

servicemanagement_services_consumers_get_iam_policy(connection, resource, optional_params \\ [], opts \\ []) View Source
servicemanagement_services_consumers_get_iam_policy(
  Tesla.Env.client(),
  String.t(),
  keyword(),
  keyword()
) ::
  {:ok, GoogleApi.ServiceManagement.V1.Model.Policy.t()}
  | {:error, Tesla.Env.t()}

Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.

Parameters

  • connection (type: GoogleApi.ServiceManagement.V1.Connection.t) - Connection to server
  • resource (type: String.t) - REQUIRED: The resource for which the policy is being requested. See the operation documentation for the appropriate value for this field.
  • optional_params (type: keyword()) - Optional parameters

    • :$.xgafv (type: String.t) - V1 error format.
    • :access_token (type: String.t) - OAuth access token.
    • :alt (type: String.t) - Data format for response.
    • :callback (type: String.t) - JSONP
    • :fields (type: String.t) - Selector specifying which fields to include in a partial response.
    • :key (type: String.t) - API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
    • :oauth_token (type: String.t) - OAuth 2.0 token for the current user.
    • :prettyPrint (type: boolean()) - Returns response with indentations and line breaks.
    • :quotaUser (type: String.t) - 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.
    • :uploadType (type: String.t) - Legacy upload protocol for media (e.g. "media", "multipart").
    • :upload_protocol (type: String.t) - Upload protocol for media (e.g. "raw", "multipart").
    • :body (type: GoogleApi.ServiceManagement.V1.Model.GetIamPolicyRequest.t) -
  • opts (type: keyword()) - Call options

Returns

  • {:ok, %GoogleApi.ServiceManagement.V1.Model.Policy{}} on success
  • {:error, info} on failure
Link to this function

servicemanagement_services_consumers_set_iam_policy(connection, resource, optional_params \\ [], opts \\ []) View Source
servicemanagement_services_consumers_set_iam_policy(
  Tesla.Env.client(),
  String.t(),
  keyword(),
  keyword()
) ::
  {:ok, GoogleApi.ServiceManagement.V1.Model.Policy.t()}
  | {:error, Tesla.Env.t()}

Sets the access control policy on the specified resource. Replaces any existing policy.

Parameters

  • connection (type: GoogleApi.ServiceManagement.V1.Connection.t) - Connection to server
  • resource (type: String.t) - REQUIRED: The resource for which the policy is being specified. See the operation documentation for the appropriate value for this field.
  • optional_params (type: keyword()) - Optional parameters

    • :$.xgafv (type: String.t) - V1 error format.
    • :access_token (type: String.t) - OAuth access token.
    • :alt (type: String.t) - Data format for response.
    • :callback (type: String.t) - JSONP
    • :fields (type: String.t) - Selector specifying which fields to include in a partial response.
    • :key (type: String.t) - API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
    • :oauth_token (type: String.t) - OAuth 2.0 token for the current user.
    • :prettyPrint (type: boolean()) - Returns response with indentations and line breaks.
    • :quotaUser (type: String.t) - 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.
    • :uploadType (type: String.t) - Legacy upload protocol for media (e.g. "media", "multipart").
    • :upload_protocol (type: String.t) - Upload protocol for media (e.g. "raw", "multipart").
    • :body (type: GoogleApi.ServiceManagement.V1.Model.SetIamPolicyRequest.t) -
  • opts (type: keyword()) - Call options

Returns

  • {:ok, %GoogleApi.ServiceManagement.V1.Model.Policy{}} on success
  • {:error, info} on failure
Link to this function

servicemanagement_services_consumers_test_iam_permissions(connection, resource, optional_params \\ [], opts \\ []) View Source
servicemanagement_services_consumers_test_iam_permissions(
  Tesla.Env.client(),
  String.t(),
  keyword(),
  keyword()
) ::
  {:ok, GoogleApi.ServiceManagement.V1.Model.TestIamPermissionsResponse.t()}
  | {:error, Tesla.Env.t()}

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.

Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may "fail open" without warning.

Parameters

  • connection (type: GoogleApi.ServiceManagement.V1.Connection.t) - Connection to server
  • resource (type: String.t) - REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field.
  • optional_params (type: keyword()) - Optional parameters

    • :$.xgafv (type: String.t) - V1 error format.
    • :access_token (type: String.t) - OAuth access token.
    • :alt (type: String.t) - Data format for response.
    • :callback (type: String.t) - JSONP
    • :fields (type: String.t) - Selector specifying which fields to include in a partial response.
    • :key (type: String.t) - API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
    • :oauth_token (type: String.t) - OAuth 2.0 token for the current user.
    • :prettyPrint (type: boolean()) - Returns response with indentations and line breaks.
    • :quotaUser (type: String.t) - 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.
    • :uploadType (type: String.t) - Legacy upload protocol for media (e.g. "media", "multipart").
    • :upload_protocol (type: String.t) - Upload protocol for media (e.g. "raw", "multipart").
    • :body (type: GoogleApi.ServiceManagement.V1.Model.TestIamPermissionsRequest.t) -
  • opts (type: keyword()) - Call options

Returns

  • {:ok, %GoogleApi.ServiceManagement.V1.Model.TestIamPermissionsResponse{}} on success
  • {:error, info} on failure
Link to this function

servicemanagement_services_create(connection, optional_params \\ [], opts \\ []) View Source
servicemanagement_services_create(Tesla.Env.client(), keyword(), keyword()) ::
  {:ok, GoogleApi.ServiceManagement.V1.Model.Operation.t()}
  | {:error, Tesla.Env.t()}

Creates a new managed service. Please note one producer project can own no more than 20 services.

Operation

Parameters

  • connection (type: GoogleApi.ServiceManagement.V1.Connection.t) - Connection to server
  • optional_params (type: keyword()) - Optional parameters

    • :$.xgafv (type: String.t) - V1 error format.
    • :access_token (type: String.t) - OAuth access token.
    • :alt (type: String.t) - Data format for response.
    • :callback (type: String.t) - JSONP
    • :fields (type: String.t) - Selector specifying which fields to include in a partial response.
    • :key (type: String.t) - API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
    • :oauth_token (type: String.t) - OAuth 2.0 token for the current user.
    • :prettyPrint (type: boolean()) - Returns response with indentations and line breaks.
    • :quotaUser (type: String.t) - 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.
    • :uploadType (type: String.t) - Legacy upload protocol for media (e.g. "media", "multipart").
    • :upload_protocol (type: String.t) - Upload protocol for media (e.g. "raw", "multipart").
    • :body (type: GoogleApi.ServiceManagement.V1.Model.ManagedService.t) -
  • opts (type: keyword()) - Call options

Returns

  • {:ok, %GoogleApi.ServiceManagement.V1.Model.Operation{}} on success
  • {:error, info} on failure
Link to this function

servicemanagement_services_delete(connection, service_name, optional_params \\ [], opts \\ []) View Source
servicemanagement_services_delete(
  Tesla.Env.client(),
  String.t(),
  keyword(),
  keyword()
) ::
  {:ok, GoogleApi.ServiceManagement.V1.Model.Operation.t()}
  | {:error, Tesla.Env.t()}

Deletes a managed service. This method will change the service to the Soft-Delete state for 30 days. Within this period, service producers may call UndeleteService to restore the service. After 30 days, the service will be permanently deleted.

Operation

Parameters

  • connection (type: GoogleApi.ServiceManagement.V1.Connection.t) - Connection to server
  • service_name (type: String.t) - The name of the service. See the overview for naming requirements. For example: example.googleapis.com.
  • optional_params (type: keyword()) - Optional parameters

    • :$.xgafv (type: String.t) - V1 error format.
    • :access_token (type: String.t) - OAuth access token.
    • :alt (type: String.t) - Data format for response.
    • :callback (type: String.t) - JSONP
    • :fields (type: String.t) - Selector specifying which fields to include in a partial response.
    • :key (type: String.t) - API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
    • :oauth_token (type: String.t) - OAuth 2.0 token for the current user.
    • :prettyPrint (type: boolean()) - Returns response with indentations and line breaks.
    • :quotaUser (type: String.t) - 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.
    • :uploadType (type: String.t) - Legacy upload protocol for media (e.g. "media", "multipart").
    • :upload_protocol (type: String.t) - Upload protocol for media (e.g. "raw", "multipart").
  • opts (type: keyword()) - Call options

Returns

  • {:ok, %GoogleApi.ServiceManagement.V1.Model.Operation{}} on success
  • {:error, info} on failure
Link to this function

servicemanagement_services_disable(connection, service_name, optional_params \\ [], opts \\ []) View Source
servicemanagement_services_disable(
  Tesla.Env.client(),
  String.t(),
  keyword(),
  keyword()
) ::
  {:ok, GoogleApi.ServiceManagement.V1.Model.Operation.t()}
  | {:error, Tesla.Env.t()}

Disables a service for a project, so it can no longer be be used for the project. It prevents accidental usage that may cause unexpected billing charges or security leaks.

Operation

Parameters

  • connection (type: GoogleApi.ServiceManagement.V1.Connection.t) - Connection to server
  • service_name (type: String.t) - Name of the service to disable. Specifying an unknown service name will cause the request to fail.
  • optional_params (type: keyword()) - Optional parameters

    • :$.xgafv (type: String.t) - V1 error format.
    • :access_token (type: String.t) - OAuth access token.
    • :alt (type: String.t) - Data format for response.
    • :callback (type: String.t) - JSONP
    • :fields (type: String.t) - Selector specifying which fields to include in a partial response.
    • :key (type: String.t) - API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
    • :oauth_token (type: String.t) - OAuth 2.0 token for the current user.
    • :prettyPrint (type: boolean()) - Returns response with indentations and line breaks.
    • :quotaUser (type: String.t) - 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.
    • :uploadType (type: String.t) - Legacy upload protocol for media (e.g. "media", "multipart").
    • :upload_protocol (type: String.t) - Upload protocol for media (e.g. "raw", "multipart").
    • :body (type: GoogleApi.ServiceManagement.V1.Model.DisableServiceRequest.t) -
  • opts (type: keyword()) - Call options

Returns

  • {:ok, %GoogleApi.ServiceManagement.V1.Model.Operation{}} on success
  • {:error, info} on failure
Link to this function

servicemanagement_services_enable(connection, service_name, optional_params \\ [], opts \\ []) View Source
servicemanagement_services_enable(
  Tesla.Env.client(),
  String.t(),
  keyword(),
  keyword()
) ::
  {:ok, GoogleApi.ServiceManagement.V1.Model.Operation.t()}
  | {:error, Tesla.Env.t()}

Enables a service for a project, so it can be used for the project. See Cloud Auth Guide for more information.

Operation

Parameters

  • connection (type: GoogleApi.ServiceManagement.V1.Connection.t) - Connection to server
  • service_name (type: String.t) - Name of the service to enable. Specifying an unknown service name will cause the request to fail.
  • optional_params (type: keyword()) - Optional parameters

    • :$.xgafv (type: String.t) - V1 error format.
    • :access_token (type: String.t) - OAuth access token.
    • :alt (type: String.t) - Data format for response.
    • :callback (type: String.t) - JSONP
    • :fields (type: String.t) - Selector specifying which fields to include in a partial response.
    • :key (type: String.t) - API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
    • :oauth_token (type: String.t) - OAuth 2.0 token for the current user.
    • :prettyPrint (type: boolean()) - Returns response with indentations and line breaks.
    • :quotaUser (type: String.t) - 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.
    • :uploadType (type: String.t) - Legacy upload protocol for media (e.g. "media", "multipart").
    • :upload_protocol (type: String.t) - Upload protocol for media (e.g. "raw", "multipart").
    • :body (type: GoogleApi.ServiceManagement.V1.Model.EnableServiceRequest.t) -
  • opts (type: keyword()) - Call options

Returns

  • {:ok, %GoogleApi.ServiceManagement.V1.Model.Operation{}} on success
  • {:error, info} on failure
Link to this function

servicemanagement_services_generate_config_report(connection, optional_params \\ [], opts \\ []) View Source
servicemanagement_services_generate_config_report(
  Tesla.Env.client(),
  keyword(),
  keyword()
) ::
  {:ok, GoogleApi.ServiceManagement.V1.Model.GenerateConfigReportResponse.t()}
  | {:error, Tesla.Env.t()}

Generates and returns a report (errors, warnings and changes from existing configurations) associated with GenerateConfigReportRequest.new_value

If GenerateConfigReportRequest.old_value is specified, GenerateConfigReportRequest will contain a single ChangeReport based on the comparison between GenerateConfigReportRequest.new_value and GenerateConfigReportRequest.old_value. If GenerateConfigReportRequest.old_value is not specified, this method will compare GenerateConfigReportRequest.new_value with the last pushed service configuration.

Parameters

  • connection (type: GoogleApi.ServiceManagement.V1.Connection.t) - Connection to server
  • optional_params (type: keyword()) - Optional parameters

    • :$.xgafv (type: String.t) - V1 error format.
    • :access_token (type: String.t) - OAuth access token.
    • :alt (type: String.t) - Data format for response.
    • :callback (type: String.t) - JSONP
    • :fields (type: String.t) - Selector specifying which fields to include in a partial response.
    • :key (type: String.t) - API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
    • :oauth_token (type: String.t) - OAuth 2.0 token for the current user.
    • :prettyPrint (type: boolean()) - Returns response with indentations and line breaks.
    • :quotaUser (type: String.t) - 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.
    • :uploadType (type: String.t) - Legacy upload protocol for media (e.g. "media", "multipart").
    • :upload_protocol (type: String.t) - Upload protocol for media (e.g. "raw", "multipart").
    • :body (type: GoogleApi.ServiceManagement.V1.Model.GenerateConfigReportRequest.t) -
  • opts (type: keyword()) - Call options

Returns

  • {:ok, %GoogleApi.ServiceManagement.V1.Model.GenerateConfigReportResponse{}} on success
  • {:error, info} on failure
Link to this function

servicemanagement_services_get(connection, service_name, optional_params \\ [], opts \\ []) View Source
servicemanagement_services_get(
  Tesla.Env.client(),
  String.t(),
  keyword(),
  keyword()
) ::
  {:ok, GoogleApi.ServiceManagement.V1.Model.ManagedService.t()}
  | {:error, Tesla.Env.t()}

Gets a managed service. Authentication is required unless the service is public.

Parameters

  • connection (type: GoogleApi.ServiceManagement.V1.Connection.t) - Connection to server
  • service_name (type: String.t) - The name of the service. See the ServiceManager overview for naming requirements. For example: example.googleapis.com.
  • optional_params (type: keyword()) - Optional parameters

    • :$.xgafv (type: String.t) - V1 error format.
    • :access_token (type: String.t) - OAuth access token.
    • :alt (type: String.t) - Data format for response.
    • :callback (type: String.t) - JSONP
    • :fields (type: String.t) - Selector specifying which fields to include in a partial response.
    • :key (type: String.t) - API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
    • :oauth_token (type: String.t) - OAuth 2.0 token for the current user.
    • :prettyPrint (type: boolean()) - Returns response with indentations and line breaks.
    • :quotaUser (type: String.t) - 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.
    • :uploadType (type: String.t) - Legacy upload protocol for media (e.g. "media", "multipart").
    • :upload_protocol (type: String.t) - Upload protocol for media (e.g. "raw", "multipart").
  • opts (type: keyword()) - Call options

Returns

  • {:ok, %GoogleApi.ServiceManagement.V1.Model.ManagedService{}} on success
  • {:error, info} on failure
Link to this function

servicemanagement_services_get_config(connection, service_name, optional_params \\ [], opts \\ []) View Source
servicemanagement_services_get_config(
  Tesla.Env.client(),
  String.t(),
  keyword(),
  keyword()
) ::
  {:ok, GoogleApi.ServiceManagement.V1.Model.Service.t()}
  | {:error, Tesla.Env.t()}

Gets a service configuration (version) for a managed service.

Parameters

  • connection (type: GoogleApi.ServiceManagement.V1.Connection.t) - Connection to server

  • service_name (type: String.t) - The name of the service. See the overview for naming requirements. For example: example.googleapis.com.

  • optional_params (type: keyword()) - Optional parameters

    • :$.xgafv (type: String.t) - V1 error format.

    • :access_token (type: String.t) - OAuth access token.

    • :alt (type: String.t) - Data format for response.

    • :callback (type: String.t) - JSONP

    • :fields (type: String.t) - Selector specifying which fields to include in a partial response.

    • :key (type: String.t) - API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.

    • :oauth_token (type: String.t) - OAuth 2.0 token for the current user.

    • :prettyPrint (type: boolean()) - Returns response with indentations and line breaks.

    • :quotaUser (type: String.t) - 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.

    • :uploadType (type: String.t) - Legacy upload protocol for media (e.g. "media", "multipart").

    • :upload_protocol (type: String.t) - Upload protocol for media (e.g. "raw", "multipart").

    • :configId (type: String.t) - The id of the service configuration resource.

      This field must be specified for the server to return all fields, including SourceInfo.

    • :view (type: String.t) - Specifies which parts of the Service Config should be returned in the response.

  • opts (type: keyword()) - Call options

Returns

  • {:ok, %GoogleApi.ServiceManagement.V1.Model.Service{}} on success
  • {:error, info} on failure
Link to this function

servicemanagement_services_get_iam_policy(connection, resource, optional_params \\ [], opts \\ []) View Source
servicemanagement_services_get_iam_policy(
  Tesla.Env.client(),
  String.t(),
  keyword(),
  keyword()
) ::
  {:ok, GoogleApi.ServiceManagement.V1.Model.Policy.t()}
  | {:error, Tesla.Env.t()}

Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.

Parameters

  • connection (type: GoogleApi.ServiceManagement.V1.Connection.t) - Connection to server
  • resource (type: String.t) - REQUIRED: The resource for which the policy is being requested. See the operation documentation for the appropriate value for this field.
  • optional_params (type: keyword()) - Optional parameters

    • :$.xgafv (type: String.t) - V1 error format.
    • :access_token (type: String.t) - OAuth access token.
    • :alt (type: String.t) - Data format for response.
    • :callback (type: String.t) - JSONP
    • :fields (type: String.t) - Selector specifying which fields to include in a partial response.
    • :key (type: String.t) - API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
    • :oauth_token (type: String.t) - OAuth 2.0 token for the current user.
    • :prettyPrint (type: boolean()) - Returns response with indentations and line breaks.
    • :quotaUser (type: String.t) - 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.
    • :uploadType (type: String.t) - Legacy upload protocol for media (e.g. "media", "multipart").
    • :upload_protocol (type: String.t) - Upload protocol for media (e.g. "raw", "multipart").
    • :body (type: GoogleApi.ServiceManagement.V1.Model.GetIamPolicyRequest.t) -
  • opts (type: keyword()) - Call options

Returns

  • {:ok, %GoogleApi.ServiceManagement.V1.Model.Policy{}} on success
  • {:error, info} on failure
Link to this function

servicemanagement_services_list(connection, optional_params \\ [], opts \\ []) View Source
servicemanagement_services_list(Tesla.Env.client(), keyword(), keyword()) ::
  {:ok, GoogleApi.ServiceManagement.V1.Model.ListServicesResponse.t()}
  | {:error, Tesla.Env.t()}

Lists managed services.

Returns all public services. For authenticated users, also returns all services the calling user has "servicemanagement.services.get" permission for.

BETA: If the caller specifies the consumer_id, it returns only the services enabled on the consumer. The consumer_id must have the format of "project:{PROJECT-ID}".

Parameters

  • connection (type: GoogleApi.ServiceManagement.V1.Connection.t) - Connection to server

  • optional_params (type: keyword()) - Optional parameters

    • :$.xgafv (type: String.t) - V1 error format.

    • :access_token (type: String.t) - OAuth access token.

    • :alt (type: String.t) - Data format for response.

    • :callback (type: String.t) - JSONP

    • :fields (type: String.t) - Selector specifying which fields to include in a partial response.

    • :key (type: String.t) - API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.

    • :oauth_token (type: String.t) - OAuth 2.0 token for the current user.

    • :prettyPrint (type: boolean()) - Returns response with indentations and line breaks.

    • :quotaUser (type: String.t) - 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.

    • :uploadType (type: String.t) - Legacy upload protocol for media (e.g. "media", "multipart").

    • :upload_protocol (type: String.t) - Upload protocol for media (e.g. "raw", "multipart").

    • :consumerId (type: String.t) - Include services consumed by the specified consumer.

      The Google Service Management implementation accepts the following forms:

      • project:
    • :pageSize (type: integer()) - The max number of items to include in the response list. Page size is 50 if not specified. Maximum value is 100.

    • :pageToken (type: String.t) - Token identifying which result to start with; returned by a previous list call.

    • :producerProjectId (type: String.t) - Include services produced by the specified project.

  • opts (type: keyword()) - Call options

Returns

  • {:ok, %GoogleApi.ServiceManagement.V1.Model.ListServicesResponse{}} on success
  • {:error, info} on failure
Link to this function

servicemanagement_services_rollouts_create(connection, service_name, optional_params \\ [], opts \\ []) View Source
servicemanagement_services_rollouts_create(
  Tesla.Env.client(),
  String.t(),
  keyword(),
  keyword()
) ::
  {:ok, GoogleApi.ServiceManagement.V1.Model.Operation.t()}
  | {:error, Tesla.Env.t()}

Creates a new service configuration rollout. Based on rollout, the Google Service Management will roll out the service configurations to different backend services. For example, the logging configuration will be pushed to Google Cloud Logging.

Please note that any previous pending and running Rollouts and associated Operations will be automatically cancelled so that the latest Rollout will not be blocked by previous Rollouts.

Only the 100 most recent (in any state) and the last 10 successful (if not already part of the set of 100 most recent) rollouts are kept for each service. The rest will be deleted eventually.

Operation

Parameters

  • connection (type: GoogleApi.ServiceManagement.V1.Connection.t) - Connection to server

  • service_name (type: String.t) - The name of the service. See the overview for naming requirements. For example: example.googleapis.com.

  • optional_params (type: keyword()) - Optional parameters

    • :$.xgafv (type: String.t) - V1 error format.

    • :access_token (type: String.t) - OAuth access token.

    • :alt (type: String.t) - Data format for response.

    • :callback (type: String.t) - JSONP

    • :fields (type: String.t) - Selector specifying which fields to include in a partial response.

    • :key (type: String.t) - API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.

    • :oauth_token (type: String.t) - OAuth 2.0 token for the current user.

    • :prettyPrint (type: boolean()) - Returns response with indentations and line breaks.

    • :quotaUser (type: String.t) - 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.

    • :uploadType (type: String.t) - Legacy upload protocol for media (e.g. "media", "multipart").

    • :upload_protocol (type: String.t) - Upload protocol for media (e.g. "raw", "multipart").

    • :baseRolloutId (type: String.t) - Unimplemented. Do not use this feature until this comment is removed.

      The rollout id that rollout to be created based on.

      Rollout should be constructed based on current successful rollout, this field indicates the current successful rollout id that new rollout based on to construct, if current successful rollout changed when server receives the request, request will be rejected for safety.

    • :body (type: GoogleApi.ServiceManagement.V1.Model.Rollout.t) -

  • opts (type: keyword()) - Call options

Returns

  • {:ok, %GoogleApi.ServiceManagement.V1.Model.Operation{}} on success
  • {:error, info} on failure
Link to this function

servicemanagement_services_rollouts_get(connection, service_name, rollout_id, optional_params \\ [], opts \\ []) View Source
servicemanagement_services_rollouts_get(
  Tesla.Env.client(),
  String.t(),
  String.t(),
  keyword(),
  keyword()
) ::
  {:ok, GoogleApi.ServiceManagement.V1.Model.Rollout.t()}
  | {:error, Tesla.Env.t()}

Gets a service configuration rollout.

Parameters

  • connection (type: GoogleApi.ServiceManagement.V1.Connection.t) - Connection to server
  • service_name (type: String.t) - The name of the service. See the overview for naming requirements. For example: example.googleapis.com.
  • rollout_id (type: String.t) - The id of the rollout resource.
  • optional_params (type: keyword()) - Optional parameters

    • :$.xgafv (type: String.t) - V1 error format.
    • :access_token (type: String.t) - OAuth access token.
    • :alt (type: String.t) - Data format for response.
    • :callback (type: String.t) - JSONP
    • :fields (type: String.t) - Selector specifying which fields to include in a partial response.
    • :key (type: String.t) - API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
    • :oauth_token (type: String.t) - OAuth 2.0 token for the current user.
    • :prettyPrint (type: boolean()) - Returns response with indentations and line breaks.
    • :quotaUser (type: String.t) - 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.
    • :uploadType (type: String.t) - Legacy upload protocol for media (e.g. "media", "multipart").
    • :upload_protocol (type: String.t) - Upload protocol for media (e.g. "raw", "multipart").
  • opts (type: keyword()) - Call options

Returns

  • {:ok, %GoogleApi.ServiceManagement.V1.Model.Rollout{}} on success
  • {:error, info} on failure
Link to this function

servicemanagement_services_rollouts_list(connection, service_name, optional_params \\ [], opts \\ []) View Source
servicemanagement_services_rollouts_list(
  Tesla.Env.client(),
  String.t(),
  keyword(),
  keyword()
) ::
  {:ok, GoogleApi.ServiceManagement.V1.Model.ListServiceRolloutsResponse.t()}
  | {:error, Tesla.Env.t()}

Lists the history of the service configuration rollouts for a managed service, from the newest to the oldest.

Parameters

  • connection (type: GoogleApi.ServiceManagement.V1.Connection.t) - Connection to server
  • service_name (type: String.t) - The name of the service. See the overview for naming requirements. For example: example.googleapis.com.
  • optional_params (type: keyword()) - Optional parameters

    • :$.xgafv (type: String.t) - V1 error format.
    • :access_token (type: String.t) - OAuth access token.
    • :alt (type: String.t) - Data format for response.
    • :callback (type: String.t) - JSONP
    • :fields (type: String.t) - Selector specifying which fields to include in a partial response.
    • :key (type: String.t) - API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
    • :oauth_token (type: String.t) - OAuth 2.0 token for the current user.
    • :prettyPrint (type: boolean()) - Returns response with indentations and line breaks.
    • :quotaUser (type: String.t) - 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.
    • :uploadType (type: String.t) - Legacy upload protocol for media (e.g. "media", "multipart").
    • :upload_protocol (type: String.t) - Upload protocol for media (e.g. "raw", "multipart").
    • :filter (type: String.t) - Use filter to return subset of rollouts. The following filters are supported: -- To limit the results to only those in

       [status](google.api.servicemanagement.v1.RolloutStatus) 'SUCCESS',
       use filter='status=SUCCESS'

      -- To limit the results to those in

       [status](google.api.servicemanagement.v1.RolloutStatus) 'CANCELLED'
       or 'FAILED', use filter='status=CANCELLED OR status=FAILED'
    • :pageSize (type: integer()) - The max number of items to include in the response list. Page size is 50 if not specified. Maximum value is 100.
    • :pageToken (type: String.t) - The token of the page to retrieve.
  • opts (type: keyword()) - Call options

Returns

  • {:ok, %GoogleApi.ServiceManagement.V1.Model.ListServiceRolloutsResponse{}} on success
  • {:error, info} on failure
Link to this function

servicemanagement_services_set_iam_policy(connection, resource, optional_params \\ [], opts \\ []) View Source
servicemanagement_services_set_iam_policy(
  Tesla.Env.client(),
  String.t(),
  keyword(),
  keyword()
) ::
  {:ok, GoogleApi.ServiceManagement.V1.Model.Policy.t()}
  | {:error, Tesla.Env.t()}

Sets the access control policy on the specified resource. Replaces any existing policy.

Parameters

  • connection (type: GoogleApi.ServiceManagement.V1.Connection.t) - Connection to server
  • resource (type: String.t) - REQUIRED: The resource for which the policy is being specified. See the operation documentation for the appropriate value for this field.
  • optional_params (type: keyword()) - Optional parameters

    • :$.xgafv (type: String.t) - V1 error format.
    • :access_token (type: String.t) - OAuth access token.
    • :alt (type: String.t) - Data format for response.
    • :callback (type: String.t) - JSONP
    • :fields (type: String.t) - Selector specifying which fields to include in a partial response.
    • :key (type: String.t) - API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
    • :oauth_token (type: String.t) - OAuth 2.0 token for the current user.
    • :prettyPrint (type: boolean()) - Returns response with indentations and line breaks.
    • :quotaUser (type: String.t) - 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.
    • :uploadType (type: String.t) - Legacy upload protocol for media (e.g. "media", "multipart").
    • :upload_protocol (type: String.t) - Upload protocol for media (e.g. "raw", "multipart").
    • :body (type: GoogleApi.ServiceManagement.V1.Model.SetIamPolicyRequest.t) -
  • opts (type: keyword()) - Call options

Returns

  • {:ok, %GoogleApi.ServiceManagement.V1.Model.Policy{}} on success
  • {:error, info} on failure
Link to this function

servicemanagement_services_test_iam_permissions(connection, resource, optional_params \\ [], opts \\ []) View Source
servicemanagement_services_test_iam_permissions(
  Tesla.Env.client(),
  String.t(),
  keyword(),
  keyword()
) ::
  {:ok, GoogleApi.ServiceManagement.V1.Model.TestIamPermissionsResponse.t()}
  | {:error, Tesla.Env.t()}

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.

Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may "fail open" without warning.

Parameters

  • connection (type: GoogleApi.ServiceManagement.V1.Connection.t) - Connection to server
  • resource (type: String.t) - REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field.
  • optional_params (type: keyword()) - Optional parameters

    • :$.xgafv (type: String.t) - V1 error format.
    • :access_token (type: String.t) - OAuth access token.
    • :alt (type: String.t) - Data format for response.
    • :callback (type: String.t) - JSONP
    • :fields (type: String.t) - Selector specifying which fields to include in a partial response.
    • :key (type: String.t) - API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
    • :oauth_token (type: String.t) - OAuth 2.0 token for the current user.
    • :prettyPrint (type: boolean()) - Returns response with indentations and line breaks.
    • :quotaUser (type: String.t) - 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.
    • :uploadType (type: String.t) - Legacy upload protocol for media (e.g. "media", "multipart").
    • :upload_protocol (type: String.t) - Upload protocol for media (e.g. "raw", "multipart").
    • :body (type: GoogleApi.ServiceManagement.V1.Model.TestIamPermissionsRequest.t) -
  • opts (type: keyword()) - Call options

Returns

  • {:ok, %GoogleApi.ServiceManagement.V1.Model.TestIamPermissionsResponse{}} on success
  • {:error, info} on failure
Link to this function

servicemanagement_services_undelete(connection, service_name, optional_params \\ [], opts \\ []) View Source
servicemanagement_services_undelete(
  Tesla.Env.client(),
  String.t(),
  keyword(),
  keyword()
) ::
  {:ok, GoogleApi.ServiceManagement.V1.Model.Operation.t()}
  | {:error, Tesla.Env.t()}

Revives a previously deleted managed service. The method restores the service using the configuration at the time the service was deleted. The target service must exist and must have been deleted within the last 30 days.

Operation

Parameters

  • connection (type: GoogleApi.ServiceManagement.V1.Connection.t) - Connection to server
  • service_name (type: String.t) - The name of the service. See the overview for naming requirements. For example: example.googleapis.com.
  • optional_params (type: keyword()) - Optional parameters

    • :$.xgafv (type: String.t) - V1 error format.
    • :access_token (type: String.t) - OAuth access token.
    • :alt (type: String.t) - Data format for response.
    • :callback (type: String.t) - JSONP
    • :fields (type: String.t) - Selector specifying which fields to include in a partial response.
    • :key (type: String.t) - API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
    • :oauth_token (type: String.t) - OAuth 2.0 token for the current user.
    • :prettyPrint (type: boolean()) - Returns response with indentations and line breaks.
    • :quotaUser (type: String.t) - 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.
    • :uploadType (type: String.t) - Legacy upload protocol for media (e.g. "media", "multipart").
    • :upload_protocol (type: String.t) - Upload protocol for media (e.g. "raw", "multipart").
  • opts (type: keyword()) - Call options

Returns

  • {:ok, %GoogleApi.ServiceManagement.V1.Model.Operation{}} on success
  • {:error, info} on failure