ibm_cloud_iam 1.0.2 → 2.0.0

data/docs/TrustedProfileTemplateAssignmentsApi.md

@@ -0,0 +1,376 @@
+# IbmCloudIam::TrustedProfileTemplateAssignmentsApi
+
+All URIs are relative to *https://iam.cloud.ibm.com*
+
+| Method | HTTP request | Description |
+| ------ | ------------ | ----------- |
+| [**create_trusted_profile_assignment**](TrustedProfileTemplateAssignmentsApi.md#create_trusted_profile_assignment) | **POST** /v1/profile_assignments/ | Create assignment |
+| [**delete_trusted_profile_assignment**](TrustedProfileTemplateAssignmentsApi.md#delete_trusted_profile_assignment) | **DELETE** /v1/profile_assignments/{assignment_id} | Delete assignment |
+| [**get_trusted_profile_assignment**](TrustedProfileTemplateAssignmentsApi.md#get_trusted_profile_assignment) | **GET** /v1/profile_assignments/{assignment_id} | Get assignment |
+| [**list_trusted_profile_assignments**](TrustedProfileTemplateAssignmentsApi.md#list_trusted_profile_assignments) | **GET** /v1/profile_assignments/ | List assignments |
+| [**update_trusted_profile_assignment**](TrustedProfileTemplateAssignmentsApi.md#update_trusted_profile_assignment) | **PATCH** /v1/profile_assignments/{assignment_id} | Update assignment |
+
+
+## create_trusted_profile_assignment
+
+> <TemplateAssignmentResponse> create_trusted_profile_assignment(create_template_assignment_request, opts)
+
+Create assignment
+
+Create an assigment for a trusted profile template.
+
+### Examples
+
+```ruby
+require 'time'
+require 'ibm_cloud_iam'
+
+api_instance = IbmCloudIam::TrustedProfileTemplateAssignmentsApi.new
+create_template_assignment_request = IbmCloudIam::CreateTemplateAssignmentRequest.new({template_id: 'template_id_example', template_version: 3.56, target_type: 'Account', target: 'target_example'}) # CreateTemplateAssignmentRequest | Body parameters to create an account settings template Assignment
+opts = {
+  authorization: 'authorization_example' # String | Authorization Token used for the request. The supported token type is a Cloud IAM Access Token. If the token is omitted the request will fail with BXNIM0308E: 'No authorization header found'. Make sure that the provided token has the required authority for the request.
+}
+
+begin
+  # Create assignment
+  result = api_instance.create_trusted_profile_assignment(create_template_assignment_request, opts)
+  p result
+rescue IbmCloudIam::ApiError => e
+  puts "Error when calling TrustedProfileTemplateAssignmentsApi->create_trusted_profile_assignment: #{e}"
+end
+```
+
+#### Using the create_trusted_profile_assignment_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<TemplateAssignmentResponse>, Integer, Hash)> create_trusted_profile_assignment_with_http_info(create_template_assignment_request, opts)
+
+```ruby
+begin
+  # Create assignment
+  data, status_code, headers = api_instance.create_trusted_profile_assignment_with_http_info(create_template_assignment_request, opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <TemplateAssignmentResponse>
+rescue IbmCloudIam::ApiError => e
+  puts "Error when calling TrustedProfileTemplateAssignmentsApi->create_trusted_profile_assignment_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **create_template_assignment_request** | [**CreateTemplateAssignmentRequest**](CreateTemplateAssignmentRequest.md) | Body parameters to create an account settings template Assignment |  |
+| **authorization** | **String** | Authorization Token used for the request. The supported token type is a Cloud IAM Access Token. If the token is omitted the request will fail with BXNIM0308E: &#39;No authorization header found&#39;. Make sure that the provided token has the required authority for the request. | [optional] |
+
+### Return type
+
+[**TemplateAssignmentResponse**](TemplateAssignmentResponse.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## delete_trusted_profile_assignment
+
+> <ExceptionResponse> delete_trusted_profile_assignment(assignment_id, opts)
+
+Delete assignment
+
+Delete a trusted profile assignment. This removes any IAM resources created by this assignment in child accounts.
+
+### Examples
+
+```ruby
+require 'time'
+require 'ibm_cloud_iam'
+
+api_instance = IbmCloudIam::TrustedProfileTemplateAssignmentsApi.new
+assignment_id = 'assignment_id_example' # String | ID of the Assignment Record
+opts = {
+  authorization: 'authorization_example' # String | Authorization Token used for the request. The supported token type is a Cloud IAM Access Token. If the token is omitted the request will fail with BXNIM0308E: 'No authorization header found'. Make sure that the provided token has the required authority for the request.
+}
+
+begin
+  # Delete assignment
+  result = api_instance.delete_trusted_profile_assignment(assignment_id, opts)
+  p result
+rescue IbmCloudIam::ApiError => e
+  puts "Error when calling TrustedProfileTemplateAssignmentsApi->delete_trusted_profile_assignment: #{e}"
+end
+```
+
+#### Using the delete_trusted_profile_assignment_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<ExceptionResponse>, Integer, Hash)> delete_trusted_profile_assignment_with_http_info(assignment_id, opts)
+
+```ruby
+begin
+  # Delete assignment
+  data, status_code, headers = api_instance.delete_trusted_profile_assignment_with_http_info(assignment_id, opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <ExceptionResponse>
+rescue IbmCloudIam::ApiError => e
+  puts "Error when calling TrustedProfileTemplateAssignmentsApi->delete_trusted_profile_assignment_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **assignment_id** | **String** | ID of the Assignment Record |  |
+| **authorization** | **String** | Authorization Token used for the request. The supported token type is a Cloud IAM Access Token. If the token is omitted the request will fail with BXNIM0308E: &#39;No authorization header found&#39;. Make sure that the provided token has the required authority for the request. | [optional] |
+
+### Return type
+
+[**ExceptionResponse**](ExceptionResponse.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## get_trusted_profile_assignment
+
+> <TemplateAssignmentResponse> get_trusted_profile_assignment(assignment_id, opts)
+
+Get assignment
+
+Get an assigment for a trusted profile template.
+
+### Examples
+
+```ruby
+require 'time'
+require 'ibm_cloud_iam'
+
+api_instance = IbmCloudIam::TrustedProfileTemplateAssignmentsApi.new
+assignment_id = 'assignment_id_example' # String | ID of the Assignment Record
+opts = {
+  include_history: true, # Boolean | Defines if the entity history is included in the response
+  authorization: 'authorization_example' # String | Authorization Token used for the request. The supported token type is a Cloud IAM Access Token. If the token is omitted the request will fail with BXNIM0308E: 'No authorization header found'. Make sure that the provided token has the required authority for the request.
+}
+
+begin
+  # Get assignment
+  result = api_instance.get_trusted_profile_assignment(assignment_id, opts)
+  p result
+rescue IbmCloudIam::ApiError => e
+  puts "Error when calling TrustedProfileTemplateAssignmentsApi->get_trusted_profile_assignment: #{e}"
+end
+```
+
+#### Using the get_trusted_profile_assignment_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<TemplateAssignmentResponse>, Integer, Hash)> get_trusted_profile_assignment_with_http_info(assignment_id, opts)
+
+```ruby
+begin
+  # Get assignment
+  data, status_code, headers = api_instance.get_trusted_profile_assignment_with_http_info(assignment_id, opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <TemplateAssignmentResponse>
+rescue IbmCloudIam::ApiError => e
+  puts "Error when calling TrustedProfileTemplateAssignmentsApi->get_trusted_profile_assignment_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **assignment_id** | **String** | ID of the Assignment Record |  |
+| **include_history** | **Boolean** | Defines if the entity history is included in the response | [optional][default to false] |
+| **authorization** | **String** | Authorization Token used for the request. The supported token type is a Cloud IAM Access Token. If the token is omitted the request will fail with BXNIM0308E: &#39;No authorization header found&#39;. Make sure that the provided token has the required authority for the request. | [optional] |
+
+### Return type
+
+[**TemplateAssignmentResponse**](TemplateAssignmentResponse.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## list_trusted_profile_assignments
+
+> <TemplateAssignmentListResponse> list_trusted_profile_assignments(opts)
+
+List assignments
+
+List trusted profile template assignments.
+
+### Examples
+
+```ruby
+require 'time'
+require 'ibm_cloud_iam'
+
+api_instance = IbmCloudIam::TrustedProfileTemplateAssignmentsApi.new
+opts = {
+  account_id: 'account_id_example', # String | Account ID of the Assignments to query. This parameter is required unless using a pagetoken.
+  template_id: 'template_id_example', # String | Filter results by Template Id
+  template_version: 'template_version_example', # String | Filter results Template Version
+  target: 'target_example', # String | Filter results by the assignment target
+  target_type: 'Account', # String | Filter results by the assignment's target type
+  limit: 56, # Integer | Optional size of a single page. Default is 20 items per page. Valid range is 1 to 100
+  pagetoken: 'pagetoken_example', # String | Optional Prev or Next page token returned from a previous query execution. Default is start with first page.
+  sort: 'template_id', # String | If specified, the items are sorted by the value of this property
+  order: 'asc', # String | Sort order
+  include_history: true, # Boolean | Defines if the entity history is included in the response
+  authorization: 'authorization_example' # String | Authorization Token used for the request. The supported token type is a Cloud IAM Access Token. If the token is omitted the request will fail with BXNIM0308E: 'No authorization header found'. Make sure that the provided token has the required authority for the request.
+}
+
+begin
+  # List assignments
+  result = api_instance.list_trusted_profile_assignments(opts)
+  p result
+rescue IbmCloudIam::ApiError => e
+  puts "Error when calling TrustedProfileTemplateAssignmentsApi->list_trusted_profile_assignments: #{e}"
+end
+```
+
+#### Using the list_trusted_profile_assignments_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<TemplateAssignmentListResponse>, Integer, Hash)> list_trusted_profile_assignments_with_http_info(opts)
+
+```ruby
+begin
+  # List assignments
+  data, status_code, headers = api_instance.list_trusted_profile_assignments_with_http_info(opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <TemplateAssignmentListResponse>
+rescue IbmCloudIam::ApiError => e
+  puts "Error when calling TrustedProfileTemplateAssignmentsApi->list_trusted_profile_assignments_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **account_id** | **String** | Account ID of the Assignments to query. This parameter is required unless using a pagetoken. | [optional] |
+| **template_id** | **String** | Filter results by Template Id | [optional] |
+| **template_version** | **String** | Filter results Template Version | [optional] |
+| **target** | **String** | Filter results by the assignment target | [optional] |
+| **target_type** | **String** | Filter results by the assignment&#39;s target type | [optional] |
+| **limit** | **Integer** | Optional size of a single page. Default is 20 items per page. Valid range is 1 to 100 | [optional][default to 20] |
+| **pagetoken** | **String** | Optional Prev or Next page token returned from a previous query execution. Default is start with first page. | [optional] |
+| **sort** | **String** | If specified, the items are sorted by the value of this property | [optional][default to &#39;created_at&#39;] |
+| **order** | **String** | Sort order | [optional][default to &#39;asc&#39;] |
+| **include_history** | **Boolean** | Defines if the entity history is included in the response | [optional][default to false] |
+| **authorization** | **String** | Authorization Token used for the request. The supported token type is a Cloud IAM Access Token. If the token is omitted the request will fail with BXNIM0308E: &#39;No authorization header found&#39;. Make sure that the provided token has the required authority for the request. | [optional] |
+
+### Return type
+
+[**TemplateAssignmentListResponse**](TemplateAssignmentListResponse.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## update_trusted_profile_assignment
+
+> <TemplateAssignmentResponse> update_trusted_profile_assignment(assignment_id, if_match, update_template_assignment_request, opts)
+
+Update assignment
+
+Update a trusted profile assignment. Call this method to retry failed assignments or migrate the trusted profile in child accounts to a new version.
+
+### Examples
+
+```ruby
+require 'time'
+require 'ibm_cloud_iam'
+
+api_instance = IbmCloudIam::TrustedProfileTemplateAssignmentsApi.new
+assignment_id = 'assignment_id_example' # String | ID of the Assignment Record
+if_match = 'if_match_example' # String | Version of the Assignment to be updated. Specify the version that you retrieved when reading the Assignment. This value  helps identifying parallel usage of this API. Pass * to indicate to update any version available. This might result in stale updates. 
+update_template_assignment_request = IbmCloudIam::UpdateTemplateAssignmentRequest.new({template_version: 3.56}) # UpdateTemplateAssignmentRequest | Request to update an assignment
+opts = {
+  authorization: 'authorization_example' # String | Authorization Token used for the request. The supported token type is a Cloud IAM Access Token. If the token is omitted the request will fail with BXNIM0308E: 'No authorization header found'. Make sure that the provided token has the required authority for the request.
+}
+
+begin
+  # Update assignment
+  result = api_instance.update_trusted_profile_assignment(assignment_id, if_match, update_template_assignment_request, opts)
+  p result
+rescue IbmCloudIam::ApiError => e
+  puts "Error when calling TrustedProfileTemplateAssignmentsApi->update_trusted_profile_assignment: #{e}"
+end
+```
+
+#### Using the update_trusted_profile_assignment_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<TemplateAssignmentResponse>, Integer, Hash)> update_trusted_profile_assignment_with_http_info(assignment_id, if_match, update_template_assignment_request, opts)
+
+```ruby
+begin
+  # Update assignment
+  data, status_code, headers = api_instance.update_trusted_profile_assignment_with_http_info(assignment_id, if_match, update_template_assignment_request, opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <TemplateAssignmentResponse>
+rescue IbmCloudIam::ApiError => e
+  puts "Error when calling TrustedProfileTemplateAssignmentsApi->update_trusted_profile_assignment_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **assignment_id** | **String** | ID of the Assignment Record |  |
+| **if_match** | **String** | Version of the Assignment to be updated. Specify the version that you retrieved when reading the Assignment. This value  helps identifying parallel usage of this API. Pass * to indicate to update any version available. This might result in stale updates.  |  |
+| **update_template_assignment_request** | [**UpdateTemplateAssignmentRequest**](UpdateTemplateAssignmentRequest.md) | Request to update an assignment |  |
+| **authorization** | **String** | Authorization Token used for the request. The supported token type is a Cloud IAM Access Token. If the token is omitted the request will fail with BXNIM0308E: &#39;No authorization header found&#39;. Make sure that the provided token has the required authority for the request. | [optional] |
+
+### Return type
+
+[**TemplateAssignmentResponse**](TemplateAssignmentResponse.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+

data/docs/TrustedProfileTemplateClaimRule.md

@@ -0,0 +1,26 @@
+# IbmCloudIam::TrustedProfileTemplateClaimRule
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **name** | **String** | Name of the claim rule to be created or updated | [optional] |
+| **type** | **String** | Type of the claim rule |  |
+| **realm_name** | **String** | The realm name of the Idp this claim rule applies to. This field is required only if the type is specified as 'Profile-SAML'. | [optional] |
+| **expiration** | **Integer** | Session expiration in seconds, only required if type is 'Profile-SAML'. | [optional] |
+| **conditions** | [**Array<ProfileClaimRuleConditions>**](ProfileClaimRuleConditions.md) | Conditions of this claim rule. |  |
+
+## Example
+
+```ruby
+require 'ibm_cloud_iam'
+
+instance = IbmCloudIam::TrustedProfileTemplateClaimRule.new(
+  name: null,
+  type: null,
+  realm_name: null,
+  expiration: null,
+  conditions: null
+)
+```
+

data/docs/TrustedProfileTemplateList.md

@@ -0,0 +1,30 @@
+# IbmCloudIam::TrustedProfileTemplateList
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **context** | [**ResponseContext**](ResponseContext.md) |  | [optional] |
+| **offset** | **Integer** | The offset of the current page. | [optional] |
+| **limit** | **Integer** | Optional size of a single page. | [optional][default to 20] |
+| **first** | **String** | Link to the first page. | [optional] |
+| **previous** | **String** | Link to the previous available page. If 'previous' property is not part of the response no previous page is available. | [optional] |
+| **_next** | **String** | Link to the next available page. If 'next' property is not part of the response no next page is available. | [optional] |
+| **profile_templates** | [**Array<TrustedProfileTemplateResponse>**](TrustedProfileTemplateResponse.md) | List of Profile Templates based on the query paramters and the page size. The profile_templates array is always part of the response but might be empty depending on the query parameter values provided. |  |
+
+## Example
+
+```ruby
+require 'ibm_cloud_iam'
+
+instance = IbmCloudIam::TrustedProfileTemplateList.new(
+  context: null,
+  offset: null,
+  limit: null,
+  first: null,
+  previous: null,
+  _next: null,
+  profile_templates: null
+)
+```
+

data/docs/TrustedProfileTemplateRequest.md

@@ -0,0 +1,28 @@
+# IbmCloudIam::TrustedProfileTemplateRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **account_id** | **String** | ID of the account where the template resides. | [optional] |
+| **name** | **String** | The name of the trusted profile template. This is visible only in the enterprise account. Required field when creating a new template. Otherwise this field is optional. If the field is included it will change the name value for all existing versions of the template. | [optional] |
+| **description** | **String** | The description of the trusted profile template. Describe the template for enterprise account users. | [optional] |
+| **profile** | [**TemplateProfileComponentRequest**](TemplateProfileComponentRequest.md) |  | [optional] |
+| **policy_template_references** | [**Array<PolicyTemplateReference>**](PolicyTemplateReference.md) | Existing policy templates that you can reference to assign access in the trusted profile component. | [optional] |
+| **action_controls** | [**ActionControls**](ActionControls.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'ibm_cloud_iam'
+
+instance = IbmCloudIam::TrustedProfileTemplateRequest.new(
+  account_id: null,
+  name: null,
+  description: null,
+  profile: null,
+  policy_template_references: null,
+  action_controls: null
+)
+```
+

data/docs/TrustedProfileTemplateResponse.md

@@ -0,0 +1,48 @@
+# IbmCloudIam::TrustedProfileTemplateResponse
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** | ID of the the template |  |
+| **version** | **Integer** | Version of the the template |  |
+| **account_id** | **String** | ID of the account where the template resides. |  |
+| **name** | **String** | The name of the trusted profile template. This is visible only in the enterprise account. |  |
+| **description** | **String** | The description of the trusted profile template. Describe the template for enterprise account users. | [optional] |
+| **committed** | **Boolean** | Committed flag determines if the template is ready for assignment | [optional] |
+| **profile** | [**TemplateProfileComponentResponse**](TemplateProfileComponentResponse.md) |  | [optional] |
+| **policy_template_references** | [**Array<PolicyTemplateReference>**](PolicyTemplateReference.md) | Existing policy templates that you can reference to assign access in the trusted profile component. | [optional] |
+| **action_controls** | [**ActionControls**](ActionControls.md) |  | [optional] |
+| **history** | [**Array<EnityHistoryRecord>**](EnityHistoryRecord.md) | History of the trusted profile template. | [optional] |
+| **entity_tag** | **String** | Entity tag for this templateId-version combination | [optional] |
+| **crn** | **String** | Cloud resource name | [optional] |
+| **created_at** | **String** | Timestamp of when the template was created | [optional] |
+| **created_by_id** | **String** | IAMid of the creator | [optional] |
+| **last_modified_at** | **String** | Timestamp of when the template was last modified | [optional] |
+| **last_modified_by_id** | **String** | IAMid of the identity that made the latest modification | [optional] |
+
+## Example
+
+```ruby
+require 'ibm_cloud_iam'
+
+instance = IbmCloudIam::TrustedProfileTemplateResponse.new(
+  id: null,
+  version: null,
+  account_id: null,
+  name: null,
+  description: null,
+  committed: null,
+  profile: null,
+  policy_template_references: null,
+  action_controls: null,
+  history: null,
+  entity_tag: null,
+  crn: null,
+  created_at: null,
+  created_by_id: null,
+  last_modified_at: null,
+  last_modified_by_id: null
+)
+```
+