ibm_cloud_global_tagging 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 1b98e16fbdc79a562552abdcc28cc816501ceb20e1bf12ecb39eccb0da94aa2b
+  data.tar.gz: dc318d07b06565bc6dae87986257074c494c43dad1ae6b145f6661059b78ed69
+SHA512:
+  metadata.gz: 627ccff44ff024e7ab892b416871b893c5dabe3902feaadbf66142a3a0d21efe88805b05ec98c18af6ed021ebfab6713b1b619b9152f78a9f05d7251af623fdb
+  data.tar.gz: 1b01dbfd1af5ab59d66c1c6316a135c43fa93a56caf2fb2e6601f8565c53bf8616f7e117d0ed1e2fb1a432d4273a14efceef70544c7d25c8ae65ef7c7a267fe9

data/.bumpversion.cfg

@@ -0,0 +1,13 @@
+[bumpversion]
+current_version = 0.0.1
+commit = True
+message = Update version {current_version} -> {new_version}
+
+[bumpversion:file:lib/ibm_cloud_global_tagging/version.rb]
+search = VERSION = '{current_version}'
+replace = VERSION = '{new_version}'
+
+[bumpversion:file:README.md]
+search = {current_version}
+replace = {new_version}
+

data/.gitignore

@@ -0,0 +1,13 @@
+/*.gem
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+/Gemfile.lock
+
+# rspec failure tracking
+.rspec_status

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.travis.yml

@@ -0,0 +1,49 @@
+language: ruby
+dist: trusty
+cache: bundler
+
+notifications:
+  email: true
+
+matrix:
+  fast_finish: true 
+
+before_install:
+  - git fetch --tags
+  - sudo apt-get update
+  - sudo apt-get install python
+  - nvm install node
+  - nvm use node
+  - gem install bundler:1.16.3
+
+install:
+  - bundle _1.16.3_ install
+
+script:
+- bundle exec rake
+
+# To enable semantic-release, uncomment these sections.
+# before_deploy:
+#  - pip install --user bumpversion
+#  - npm install -g semantic-release
+#  - npm install -g @semantic-release/changelog
+#  - npm install -g @semantic-release/exec
+#  - npm install -g @semantic-release/git
+#  - npm install -g @semantic-release/github
+#  - npm install -g @semantic-release/commit-analyzer
+# 
+# deploy:
+# - provider: script
+#   script: npx semantic-release
+#   skip_cleanup: true
+#   on:
+#     branch: master
+#     rvm: 2.5.1
+#
+# - provider: rubygems
+#   api_key: $RUBYGEMS_API_KEY
+#   gem: ibm_cloud_global_tagging
+#   on:
+#     rvm: '2.5.1'
+#     branch: master
+#

data/CHANGELOG.md

@@ -0,0 +1,2 @@
+= 0.0.1
+* Initial release

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,76 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, sex characteristics, gender identity and expression,
+level of experience, education, socio-economic status, nationality, personal
+appearance, race, religion, or sexual identity and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+ advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+ address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+ professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at phil_adams@us.ibm.com. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at https://www.contributor-covenant.org/version/1/4/code-of-conduct.html
+
+[homepage]: https://www.contributor-covenant.org
+
+For answers to common questions about this code of conduct, see
+https://www.contributor-covenant.org/faq

data/CONTRIBUTING.md

@@ -0,0 +1,13 @@
+# Questions
+If you are having problems using the APIs or have a question about IBM Cloud services,
+please ask a question at
+[Stack Overflow](http://stackoverflow.com/questions/ask?tags=ibm-cloud).
+
+# Issues
+If you encounter an issue with the project, you are welcome to submit a
+[bug report](https://github.com/IBM-Cloud/ibm-cloud-sdk-ruby/issues).
+Before that, please search for similar issues. It's possible that someone has already reported the problem.
+
+# General Information
+For general guidance on contributing to this project, please see
+[this link](https://github.com/IBM/ibm-cloud-sdk-common/blob/master/CONTRIBUTING_ruby.md)

data/Gemfile

@@ -0,0 +1,7 @@
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in ibm_cloud_global_tagging.gemspec
+gemspec
+
+gem "rake", "~> 12.0"
+gem "rspec", "~> 3.0"

data/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

data/README.md

@@ -0,0 +1,84 @@
+[![Build Status](https://travis-ci.com/IBM-Cloud/ibm-cloud-sdk-ruby.svg?token=eW5FVD71iyte6tTby8gr&branch=master)](https://travis.ibm.com/IBM-Cloud/ibm-cloud-sdk-ruby)
+[![semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg)](https://github.com/semantic-release/semantic-release)
+# IBM Cloud Global Tagging Ruby SDK
+
+Ruby client library to interact with various [IBM Cloud Platform Services APIs](https://cloud.ibm.com/apidocs?category=platform-services).
+
+Disclaimer: this SDK is being released initially as a **pre-release** version.
+Changes might occur which impact applications that use this SDK.
+
+## Table of Contents
+
+<!--
+  The TOC below is generated using the `markdown-toc` node package.
+
+      https://github.com/jonschlinkert/markdown-toc
+
+  You should regenerate the TOC after making changes to this file.
+
+      npx markdown-toc -i README.md
+  -->
+
+<!-- toc -->
+
+- [Overview](#overview)
+- [Prerequisites](#prerequisites)
+- [Installation](#installation)
+- [Using the SDK](#using-the-sdk)
+- [Questions](#questions)
+- [Issues](#issues)
+- [Open source @ IBM](#open-source--ibm)
+- [Contributing](#contributing)
+- [License](#license)
+
+<!-- tocstop -->
+
+## Overview
+
+The IBM Cloud Platform Services Ruby SDK allows developers to programmatically interact with the following
+IBM Cloud services:
+
+Service Name | Imported Class Name
+--- | ---
+<!-- [Example Service](https://cloud.ibm.com/apidocs/example-service) | exampleservicev1 -->
+
+## Prerequisites
+
+[ibm-cloud-onboarding]: https://cloud.ibm.com/registration
+
+* An [IBM Cloud][ibm-cloud-onboarding] account.
+* An IAM API key to allow the SDK to access your account. Create one [here](https://cloud.ibm.com/iam/apikeys).
+* Ruby 2.3.0 or above.
+
+## Installation
+
+To install, use `gem`
+
+```bash
+gem install "ibm_cloud_global_tagging"
+```
+
+## Using the SDK
+For general SDK usage information, please see [this link](https://github.com/IBM/ibm-cloud-sdk-common/blob/master/gems/ibm_cloud_global_tagging/README.md)
+
+## Questions
+
+If you are having difficulties using this SDK or have a question about the IBM Cloud services,
+please ask a question
+[Stack Overflow](http://stackoverflow.com/questions/ask?tags=ibm-cloud).
+
+## Issues
+If you encounter an issue with the project, you are welcome to submit a
+[bug report](https://github.com/IBM-Cloud/ibm-cloud-sdk-ruby/issues).
+Before that, please search for similar issues. It's possible that someone has already reported the problem.
+
+## Open source @ IBM
+Find more open source projects on the [IBM Github Page](http://ibm.github.io/)
+
+## Contributing
+See [CONTRIBUTING.md](https://github.com/IBM-Cloud/ibm-cloud-sdk-ruby/blob/master/gems/ibm_cloud_global_tagging/CONTRIBUTING.md).
+
+## License
+
+This SDK is released under the Apache 2.0 license.
+The license's full text can be found in [LICENSE](https://github.com/IBM-Cloud/ibm-cloud-sdk-ruby/blob/master/gems/ibm_cloud_global_tagging/LICENSE).

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "ibm_cloud_global_tagging"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/ibm_cloud_global_tagging.gemspec

@@ -0,0 +1,40 @@
+require_relative 'lib/ibm_cloud_global_tagging/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "ibm_cloud_global_tagging"
+  spec.version       = IbmCloudGlobalTagging::VERSION
+  spec.authors       = ["adam.grare@ibm.com"]
+  spec.email         = ["adam.grare@ibm.com"]
+
+  spec.summary       = %q{IBM Cloud Global Tagging Ruby SDK}
+  spec.homepage      = "https://github.com/IBM-Cloud/ibm-cloud-sdk-ruby"
+  spec.licenses      = ["Apache-2.0"]
+  spec.required_ruby_version = Gem::Requirement.new(">= 2.3.0")
+
+  spec.metadata["allowed_push_host"] = "https://rubygems.org"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = spec.homepage
+  spec.metadata["changelog_uri"] = "#{spec.metadata["source_code_uri"]}/blob/master/CHANGELOG.md"
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files         = Dir.chdir(File.expand_path('..', __FILE__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_runtime_dependency "concurrent-ruby", "~> 1.0"
+  spec.add_runtime_dependency "http", "~> 4.1.0"
+  spec.add_runtime_dependency "ibm_cloud_sdk_core", "~> 1.1.1"
+  spec.add_runtime_dependency "jwt", "~> 2.2.1"
+
+  spec.add_development_dependency "bundler"
+  spec.add_development_dependency "codecov"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rubocop", "0.62"
+  spec.add_development_dependency "simplecov", "~> 0.16"
+  spec.add_development_dependency "webmock", "~> 3.4"
+end

data/lib/ibm_cloud_global_tagging.rb

@@ -0,0 +1,10 @@
+require "ibm_cloud_global_tagging/version"
+require "ibm_cloud_sdk_core"
+
+module IbmCloudGlobalTagging
+  ApiException = IBMCloudSdkCore::ApiException
+  DetailedResponse = IBMCloudSdkCore::DetailedResponse
+
+  require_relative "./ibm_cloud_global_tagging/common.rb"
+  require_relative "./ibm_cloud_global_tagging/global_tagging_v1.rb"
+end

data/lib/ibm_cloud_global_tagging/common.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require_relative "./version.rb"
+
+module IbmCloudGlobalTagging
+  # SDK Common class
+  class Common
+    def initialize(*); end
+
+    def get_sdk_headers(service_name, service_version, operation_id)
+      headers = {}
+      user_agent_string = "ibm_cloud_global_tagging-ruby-sdk-" + IbmCloudGlobalTagging::VERSION + " #{RbConfig::CONFIG["host"]}"
+      user_agent_string += " #{RbConfig::CONFIG["RUBY_BASE_NAME"]}-#{RbConfig::CONFIG["RUBY_PROGRAM_VERSION"]}"
+
+      headers["User-Agent"] = user_agent_string
+      return headers if service_name.nil? || service_version.nil? || operation_id.nil?
+
+      headers["X-IBMCloud-SDK-Analytics"] = "service_name=#{service_name};service_version=#{service_version};operation_id=#{operation_id}"
+      headers
+    end
+  end
+end

data/lib/ibm_cloud_global_tagging/global_tagging_v1.rb

@@ -0,0 +1,304 @@
+# frozen_string_literal: true
+
+# (C) Copyright IBM Corp. 2021.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# IBM OpenAPI SDK Code Generator Version: 99-SNAPSHOT-891116d3-20210112-104458
+#
+# Manage your tags with the Tagging API in IBM Cloud. You can attach, detach, delete a
+# tag or list all tags in your billing account with the Tagging API. The tag name must be
+# unique within a billing account. You can create tags in two formats: `key:value` or
+# `label`. The tagging API supports two types of tag: `user` and `service`. `service` tags
+# cannot be attached to IMS resources (see `providers=ims` query parameter). `service`
+# tags must be in the form `service_prefix:tag_label` where `service_prefix` identifies
+# the Service owning the tag.
+
+require "concurrent"
+require "erb"
+require "json"
+require "ibm_cloud_sdk_core"
+require_relative "./common.rb"
+
+module IbmCloudGlobalTagging
+  ##
+  # The global_tagging V1 service.
+  class GlobalTaggingV1 < IBMCloudSdkCore::BaseService
+    include Concurrent::Async
+    DEFAULT_SERVICE_NAME = "global_tagging"
+    DEFAULT_SERVICE_URL = "https://tags.global-search-tagging.cloud.ibm.com"
+    ##
+    # @!method initialize(args)
+    # Construct a new client for the global_tagging service.
+    #
+    # @param args [Hash] The args to initialize with
+    # @option args service_url [String] The base service URL to use when contacting the service.
+    #   The base service_url may differ between IBM Cloud regions.
+    # @option args authenticator [Object] The Authenticator instance to be configured for this service.
+    # @option args service_name [String] The name of the service to configure. Will be used as the key to load
+    #   any external configuration, if applicable.
+    def initialize(args = {})
+      @__async_initialized__ = false
+      defaults = {}
+      defaults[:service_url] = DEFAULT_SERVICE_URL
+      defaults[:service_name] = DEFAULT_SERVICE_NAME
+      defaults[:authenticator] = nil
+      user_service_url = args[:service_url] unless args[:service_url].nil?
+      args = defaults.merge(args)
+      super
+      @service_url = user_service_url unless user_service_url.nil?
+    end
+
+    #########################
+    # tags
+    #########################
+
+    ##
+    # @!method list_tags(account_id: nil, tag_type: nil, full_data: nil, providers: nil, attached_to: nil, offset: nil, limit: nil, timeout: nil, order_by_name: nil, attached_only: nil)
+    # Get all tags.
+    # Lists all tags in a billing account. Use the `attached_to` parameter to return the
+    #   list of tags attached to the specified resource.
+    # @param account_id [String] The ID of the billing account to list the tags for. If it is not set, then it is
+    #   taken from the authorization token. This parameter is required if `tag_type` is
+    #   set to `service`.
+    # @param tag_type [String] The type of the tag you want to list. Supported values are `user` and `service`.
+    # @param full_data [Boolean] If set to `true`, this query returns the provider, `ghost`, `ims` or `ghost,ims`,
+    #   where the tag exists and the number of attached resources.
+    # @param providers [Array[String]] Select a provider. Supported values are `ghost` and `ims`. To list GhoST tags and
+    #   infrastructure tags use `ghost,ims`. `service` tags can only be attached to GhoST
+    #   onboarded resources, so you don't need to set this parameter when listing
+    #   `service` tags.
+    # @param attached_to [String] If you want to return only the list of tags attached to a specified resource, pass
+    #   the ID of the resource on this parameter. For GhoST onboarded resources, the
+    #   resource ID is the CRN; for IMS resources, it is the IMS ID. When using this
+    #   parameter, you must specify the appropriate provider (`ims` or `ghost`).
+    # @param offset [Fixnum] The offset is the index of the item from which you want to start returning data
+    #   from.
+    # @param limit [Fixnum] The number of tags to return.
+    # @param timeout [Fixnum] The search timeout bounds the search request to be executed within the specified
+    #   time value. It returns the hits accumulated until time runs out.
+    # @param order_by_name [String] Order the output by tag name.
+    # @param attached_only [Boolean] Filter on attached tags. If `true`, it returns only tags that are attached to one
+    #   or more resources. If `false`, it returns all tags.
+    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
+    def list_tags(account_id: nil, tag_type: nil, full_data: nil, providers: nil, attached_to: nil, offset: nil, limit: nil, timeout: nil, order_by_name: nil, attached_only: nil)
+      headers = {
+      }
+      sdk_headers = Common.new.get_sdk_headers("global_tagging", "V1", "list_tags")
+      headers.merge!(sdk_headers)
+      providers *= "," unless providers.nil?
+
+      params = {
+        "account_id" => account_id,
+        "tag_type" => tag_type,
+        "full_data" => full_data,
+        "providers" => providers,
+        "attached_to" => attached_to,
+        "offset" => offset,
+        "limit" => limit,
+        "timeout" => timeout,
+        "order_by_name" => order_by_name,
+        "attached_only" => attached_only
+      }
+
+      method_url = "/v3/tags"
+
+      response = request(
+        method: "GET",
+        url: method_url,
+        headers: headers,
+        params: params,
+        accept_json: true
+      )
+      response
+    end
+
+    ##
+    # @!method delete_tag_all(providers: nil, account_id: nil, tag_type: nil)
+    # Delete all unused tags.
+    # Delete the tags that are not attached to any resource.
+    # @param providers [String] Select a provider. Supported values are `ghost` and `ims`.
+    # @param account_id [String] The ID of the billing account to delete the tags for. If it is not set, then it is
+    #   taken from the authorization token. It is a required parameter if `tag_type` is
+    #   set to `service`.
+    # @param tag_type [String] The type of the tag. Supported values are `user` and `service`. `service` is not
+    #   supported if the `providers` parameter is set to `ims`.
+    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
+    def delete_tag_all(providers: nil, account_id: nil, tag_type: nil)
+      headers = {
+      }
+      sdk_headers = Common.new.get_sdk_headers("global_tagging", "V1", "delete_tag_all")
+      headers.merge!(sdk_headers)
+
+      params = {
+        "providers" => providers,
+        "account_id" => account_id,
+        "tag_type" => tag_type
+      }
+
+      method_url = "/v3/tags"
+
+      response = request(
+        method: "DELETE",
+        url: method_url,
+        headers: headers,
+        params: params,
+        accept_json: true
+      )
+      response
+    end
+
+    ##
+    # @!method delete_tag(tag_name:, providers: nil, account_id: nil, tag_type: nil)
+    # Delete an unused tag.
+    # Delete an existing tag. A tag can be deleted only if it is not attached to any
+    #   resource.
+    # @param tag_name [String] The name of tag to be deleted.
+    # @param providers [Array[String]] Select a provider. Supported values are `ghost` and `ims`. To delete tag both in
+    #   GhoST in IMS, use `ghost,ims`.
+    # @param account_id [String] The ID of the billing account to delete the tag for. It is a required parameter if
+    #   `tag_type` is set to `service`, otherwise it is inferred from the authorization
+    #   IAM token.
+    # @param tag_type [String] The type of the tag. Supported values are `user` and `service`. `service` is not
+    #   supported for `providers=ims`.
+    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
+    def delete_tag(tag_name:, providers: nil, account_id: nil, tag_type: nil)
+      raise ArgumentError.new("tag_name must be provided") if tag_name.nil?
+
+      headers = {
+      }
+      sdk_headers = Common.new.get_sdk_headers("global_tagging", "V1", "delete_tag")
+      headers.merge!(sdk_headers)
+      providers *= "," unless providers.nil?
+
+      params = {
+        "providers" => providers,
+        "account_id" => account_id,
+        "tag_type" => tag_type
+      }
+
+      method_url = "/v3/tags/%s" % [ERB::Util.url_encode(tag_name)]
+
+      response = request(
+        method: "DELETE",
+        url: method_url,
+        headers: headers,
+        params: params,
+        accept_json: true
+      )
+      response
+    end
+
+    ##
+    # @!method attach_tag(resources:, tag_name: nil, tag_names: nil, account_id: nil, tag_type: nil)
+    # Attach tags.
+    # Attaches one or more tags to one or more resources. To attach a `user` tag on a
+    #   resource, you must have the access listed in the [Granting users access to tag
+    #   resources](https://cloud.ibm.com/docs/account?topic=account-access) documentation.
+    #   To attach a `service` tag, you must be an authorized service. If that is the case,
+    #   then you can attach a `service` tag with your registered `prefix` to any resource
+    #   in any account. The account ID must be set through the `account_id` query
+    #   parameter.
+    # @param resources [Array[Resource]] List of resources on which the tag or tags should be attached.
+    # @param tag_name [String] The name of the tag to attach.
+    # @param tag_names [Array[String]] An array of tag names to attach.
+    # @param account_id [String] The ID of the billing account where the resources to be tagged lives. It is a
+    #   required parameter if `tag_type` is set to `service`. Otherwise, it is inferred
+    #   from the authorization IAM token.
+    # @param tag_type [String] The type of the tag. Supported values are `user` and `service`. `service` is not
+    #   supported if `providers` is set to `ims`.
+    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
+    def attach_tag(resources:, tag_name: nil, tag_names: nil, account_id: nil, tag_type: nil)
+      raise ArgumentError.new("resources must be provided") if resources.nil?
+
+      headers = {
+      }
+      sdk_headers = Common.new.get_sdk_headers("global_tagging", "V1", "attach_tag")
+      headers.merge!(sdk_headers)
+
+      params = {
+        "account_id" => account_id,
+        "tag_type" => tag_type
+      }
+
+      data = {
+        "resources" => resources,
+        "tag_name" => tag_name,
+        "tag_names" => tag_names
+      }
+
+      method_url = "/v3/tags/attach"
+
+      response = request(
+        method: "POST",
+        url: method_url,
+        headers: headers,
+        params: params,
+        json: data,
+        accept_json: true
+      )
+      response
+    end
+
+    ##
+    # @!method detach_tag(resources:, tag_name: nil, tag_names: nil, account_id: nil, tag_type: nil)
+    # Detach tags.
+    # Detaches one or more tags from one or more resources. To detach a `user` tag on a
+    #   resource you must have the permissions listed in the [Granting users access to tag
+    #   resources](https://cloud.ibm.com/docs/account?topic=account-access) documentation.
+    #   To detach a `service` tag you must be an authorized Service. If that is the case,
+    #   then you can detach a `service` tag with your registered `prefix` from any
+    #   resource in any account. The account ID must be set through the `account_id` query
+    #   parameter.
+    # @param resources [Array[Resource]] List of resources on which the tag or tags should be detached.
+    # @param tag_name [String] The name of the tag to detach.
+    # @param tag_names [Array[String]] An array of tag names to detach.
+    # @param account_id [String] The ID of the billing account where the resources to be un-tagged lives. It is a
+    #   required parameter if `tag_type` is set to `service`, otherwise it is inferred
+    #   from the authorization IAM token.
+    # @param tag_type [String] The type of the tag. Supported values are `user` and `service`. `service` is not
+    #   supported for `providers=ims`.
+    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
+    def detach_tag(resources:, tag_name: nil, tag_names: nil, account_id: nil, tag_type: nil)
+      raise ArgumentError.new("resources must be provided") if resources.nil?
+
+      headers = {
+      }
+      sdk_headers = Common.new.get_sdk_headers("global_tagging", "V1", "detach_tag")
+      headers.merge!(sdk_headers)
+
+      params = {
+        "account_id" => account_id,
+        "tag_type" => tag_type
+      }
+
+      data = {
+        "resources" => resources,
+        "tag_name" => tag_name,
+        "tag_names" => tag_names
+      }
+
+      method_url = "/v3/tags/detach"
+
+      response = request(
+        method: "POST",
+        url: method_url,
+        headers: headers,
+        params: params,
+        json: data,
+        accept_json: true
+      )
+      response
+    end
+  end
+end

data/lib/ibm_cloud_global_tagging/version.rb

@@ -0,0 +1,3 @@
+module IbmCloudGlobalTagging
+  VERSION = "0.1.0"
+end

metadata

@@ -0,0 +1,205 @@
+--- !ruby/object:Gem::Specification
+name: ibm_cloud_global_tagging
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- adam.grare@ibm.com
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2021-01-19 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: concurrent-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: http
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.1.0
+- !ruby/object:Gem::Dependency
+  name: ibm_cloud_sdk_core
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.1.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.1.1
+- !ruby/object:Gem::Dependency
+  name: jwt
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.2.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.2.1
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: codecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: '0.62'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: '0.62'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.16'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.16'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.4'
+description:
+email:
+- adam.grare@ibm.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".bumpversion.cfg"
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
+- CONTRIBUTING.md
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- ibm_cloud_global_tagging.gemspec
+- lib/ibm_cloud_global_tagging.rb
+- lib/ibm_cloud_global_tagging/common.rb
+- lib/ibm_cloud_global_tagging/global_tagging_v1.rb
+- lib/ibm_cloud_global_tagging/version.rb
+homepage: https://github.com/IBM-Cloud/ibm-cloud-sdk-ruby
+licenses:
+- Apache-2.0
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/IBM-Cloud/ibm-cloud-sdk-ruby
+  source_code_uri: https://github.com/IBM-Cloud/ibm-cloud-sdk-ruby
+  changelog_uri: https://github.com/IBM-Cloud/ibm-cloud-sdk-ruby/blob/master/CHANGELOG.md
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.3.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.2.5
+signing_key:
+specification_version: 4
+summary: IBM Cloud Global Tagging Ruby SDK
+test_files: []