Introduction
Quickly assign users access to more than one resource at a time by creating and updating resource groups with the IBM Cloud® Resource Manager API. You can delete any resource group only if it doesn't contain any resources, and it isn't the default resource group. When a user creates an account, a default resource group is created in the account. All IBM Cloud resources must be provisioned within a resource group. If an account is suspended, the corresponding resource group and all resources within it are also suspended.
In a Lite account, a user can have only one resource group. For a Pay-As-You-Go or Subscription account, a user can create more than one resource group.
To create resource instances within resource groups, see the IBM Cloud® Resource Controller API.
SDKs for Java, Node, Python, and Go are available to make it easier to programmatically access the API from your code. The client libraries that are provided by the SDKs implement best practices for using the API and reduce the amount of code that you need to write. The tab for each language includes code examples that demonstrate how to use the client libraries. For more information about using the SDKs, see the IBM Cloud SDK Common project on GitHub.
Installing the Java SDK
Maven
<dependency>
<groupId>com.ibm.cloud</groupId>
<artifactId>resource-manager</artifactId>
<version>{version}</version>
</dependency>
Gradle
compile 'com.ibm.cloud:resource-manager:{version}'
View on GitHub https://github.com/IBM/platform-services-java-sdk
Installing the Go SDK
Go modules (recommended): Add the following import in your code, and then run go build
or go mod tidy
import (
"github.com/IBM/platform-services-go-sdk/resourcemanagerv2"
)
Go get
go get -u github.com/IBM/platform-services-go-sdk/resourcemanagerv2
View on GitHub https://github.com/IBM/platform-services-go-sdk
Installing the Node SDK
npm install @ibm-cloud/platform-services
View on GitHub https://github.com/IBM/platform-services-node-sdk
Installing the Python SDK
pip install --upgrade ibm-platform-services
View on GitHub https://github.com/IBM/platform-services-python-sdk
Endpoint URLs
The Resource Manager API uses the following global endpoint URL for all regions. When you call the API, add the path for each method to form the complete API endpoint for your requests.
https://resource-controller.cloud.ibm.com
If you enabled service endpoints in your account, you can send API requests over the IBM Cloud private network at the following base endpoint URLs. For more information, see Enabling VRF and service endpoints.
- Private endpoint URL for VPC infrastructure:
https://private.resource-controller.cloud.ibm.com
- Private endpoint URLs for classic infrastructure:
- Dallas:
https://private.us-south.resource-controller.cloud.ibm.com
- Washington DC:
https://private.us-east.resource-controller.cloud.ibm.com
- Dallas:
Example API request
curl -X {request_method} "https://resource-controller.cloud.ibm.com/{method_endpoint}"
Replace {request_method}
and {method_endpoint}
in this example with the values for your particular API call.
Authentication
Authorization to the Resource Manager API is enforced by using an IBM Cloud Identity and Access Management (IAM) access token. The token is used to determine the actions that a user or service ID has access to when they use the API.
Obtaining an IAM token for an authenticated user or service ID is described in the IAM Identity Services API documentation.
To use the API, add a valid IAM token to the HTTP Authorization request header, for example, -H 'Authorization: Bearer <TOKEN>'
.
When you use the SDK, configure an IAM authenticator with the IAM API key. The authenticator automatically obtains the IAM access token for the API key and includes it with each request. You can construct an authenticator in either of two ways:
- Programmatically by constructing an IAM authenticator instance and supplying your IAM API key
- By defining the API key in external configuration properties and then using the SDK authenticator factory to construct an IAM authenticator that uses the configured IAM API key
In this example of using external configuration properties, an IAM authenticator instance is created with the configured API key, and then the service client is constructed with this authenticator instance and the configured service URL.
For more information, see the Authentication section of the IBM Cloud SDK Common documentation.
To call each method, you'll need to be assigned a role that includes the required IAM actions. Each method lists the associated action. For more information about IAM actions and how they map to roles, see Assigning access to account management services.
To retrieve your access token:
curl -X POST "https://iam.test.cloud.ibm.com/identity/token" --header 'Content-Type: application/x-www-form-urlencoded' --header 'Accept: application/json' --data-urlencode 'grant_type=urn:ibm:params:oauth:grant-type:apikey' --data-urlencode 'apikey=<API_KEY>'
Replace <API_KEY>
with your IAM API key.
Setting client options through external configuration
Example environment variables, where <SERVICE_URL>
is the endpoint URL and <API_KEY>
is your IAM API key
export RESOURCE_MANAGER_URL=<SERVICE_URL>
export RESOURCE_MANAGER_AUTHTYPE=iam
export RESOURCE_MANAGER_APIKEY=<API_KEY>
Example of constructing the service client
import {
"github.com/IBM/platform-services-go-sdk/resourcemanagerv2"
}
...
serviceClientOptions := &resourcemanagerv2.ResourceManagerV2Options{}
serviceClient, err := resourcemanagerv2.NewResourceManagerV2UsingExternalConfig(serviceClientOptions)
For more authentication examples, check out the IBM Cloud SDK Common project on GitHub.
Setting client options through external configuration
Example environment variables, where <SERVICE_URL>
is the endpoint URL and <API_KEY>
is your IAM API key
export RESOURCE_MANAGER_URL=<SERVICE_URL>
export RESOURCE_MANAGER_AUTHTYPE=iam
export RESOURCE_MANAGER_APIKEY=<API_KEY>
Example of constructing the service client
import com.ibm.cloud.platform_services.resource_manager.v2.ResourceManager;
...
ResourceManager serviceClient = ResourceManager.newInstance();
For more authentication examples, check out the IBM Cloud SDK Common project on GitHub.
Setting client options through external configuration
Example environment variables, where <SERVICE_URL>
is the endpoint URL and <API_KEY>
is your IAM API key
export RESOURCE_MANAGER_URL=<SERVICE_URL>
export RESOURCE_MANAGER_AUTHTYPE=iam
export RESOURCE_MANAGER_APIKEY=<API_KEY>
Example of constructing the service client
const ResourceManagerV2 = require('@ibm-cloud/platform-services/resource-manager/v2');
...
const serviceClient = ResourceManagerV2.newInstance({});
For more authentication examples, check out the IBM Cloud SDK Common project on GitHub.
Setting client options through external configuration
Example environment variables, where <SERVICE_URL>
is the endpoint URL and <API_KEY>
is your IAM API key
export RESOURCE_MANAGER_URL=<SERVICE_URL>
export RESOURCE_MANAGER_AUTHTYPE=iam
export RESOURCE_MANAGER_APIKEY=<API_KEY>
Example of constructing the service client
from ibm_platform_services import ResourceManagerV2
...
service_client = ResourceManagerV2.new_instance()
For more authentication examples, check out the IBM Cloud SDK Common project on GitHub.
Auditing
You can monitor API activity within your account by using the IBM Cloud Activity Tracker service. When an API method is called, an event is generated that you can then track and audit from within Activity Tracker. For methods that generate these events, the specific event type is listed with each individual method.
For more information about how to track Account and Billing activity, see Auditing events for account management.
Error handling
This API uses standard HTTP response codes to indicate whether a method completed successfully. A 200
response indicates success. A 400
type response indicates a failure, and a 500
type response indicates an internal system error.
HTTP Error Code | Description | Recovery |
---|---|---|
200 |
Success | The request was successful. |
201 |
Success | The resource group was successfully created. |
400 |
Bad Request | The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request. |
401 |
Unauthorized | You are not authorized to make this request. Log in to IBM Cloud and try again. If this error persists, contact the account owner to check your permissions. |
403 |
Forbidden | The supplied authentication is not authorized to access '{namespace}'. |
404 |
Not Found | The requested resource cannot be found. |
410 |
Gone | The resource is valid but has been removed already in a previous call |
500 |
Internal Server Error | offering_name is currently unavailable. Your request cannot not be processed. Wait a few minutes and try again. |
Rate limiting
Rate limits for API requests are enforced on a per-caller basis. If the number of requests for a particular method and endpoint reaches the request limit within the specified time window, no further requests are accepted until the timer expires. After the timer expires, a new time window begins with the next accepted request.
The response to each HTTP request includes headers that you can use to determine whether you are close to the rate limit:
X-RateLimit-Reset
: The time the current timer expires (in UNIX epoch time)X-RateLimit-Remaining
: The number of requests that remain in the current time windowX-RateLimit-Limit
: The total number of requests that are allowed within the time window
An HTTP status code of 429
indicates that the rate limit was exceeded.
Currently, the rate of allowed requests for all resource manager APIs is 500 requests per 10 seconds.
Methods
Get a list of all resource groups
Call this method to retrieve information about all resource groups and associated quotas in an account. The id
returned in the response can be used to create a resource instance later. The response can be filtered based on queryParams such as account_id
, name
, default
, and more to narrow your search.Users need to be assigned IAM policies with the Viewer role or higher on the targeted resource groups.
Call this method to retrieve information about all resource groups and associated quotas in an account. The id
returned in the response can be used to create a resource instance later. The response can be filtered based on queryParams such as account_id
, name
, default
, and more to narrow your search.Users need to be assigned IAM policies with the Viewer role or higher on the targeted resource groups.
Call this method to retrieve information about all resource groups and associated quotas in an account. The id
returned in the response can be used to create a resource instance later. The response can be filtered based on queryParams such as account_id
, name
, default
, and more to narrow your search.Users need to be assigned IAM policies with the Viewer role or higher on the targeted resource groups.
Call this method to retrieve information about all resource groups and associated quotas in an account. The id
returned in the response can be used to create a resource instance later. The response can be filtered based on queryParams such as account_id
, name
, default
, and more to narrow your search.Users need to be assigned IAM policies with the Viewer role or higher on the targeted resource groups.
Call this method to retrieve information about all resource groups and associated quotas in an account. The id
returned in the response can be used to create a resource instance later. The response can be filtered based on queryParams such as account_id
, name
, default
, and more to narrow your search.Users need to be assigned IAM policies with the Viewer role or higher on the targeted resource groups.
GET /v2/resource_groups
(resourceManager *ResourceManagerV2) ListResourceGroups(listResourceGroupsOptions *ListResourceGroupsOptions) (result *ResourceGroupList, response *core.DetailedResponse, err error)
(resourceManager *ResourceManagerV2) ListResourceGroupsWithContext(ctx context.Context, listResourceGroupsOptions *ListResourceGroupsOptions) (result *ResourceGroupList, response *core.DetailedResponse, err error)
ServiceCall<ResourceGroupList> listResourceGroups(ListResourceGroupsOptions listResourceGroupsOptions)
listResourceGroups(params)
list_resource_groups(self,
*,
account_id: str = None,
date: str = None,
name: str = None,
default: bool = None,
include_deleted: bool = None,
**kwargs
) -> DetailedResponse
Request
Instantiate the ListResourceGroupsOptions
struct and set the fields to provide parameter values for the ListResourceGroups
method.
Use the ListResourceGroupsOptions.Builder
to create a ListResourceGroupsOptions
object that contains the parameter values for the listResourceGroups
method.
Query Parameters
The ID of the account that contains the resource groups that you want to get.
The date in the format of YYYY-MM which returns resource groups. Deleted resource groups will be excluded before this month.
The name of the resource group.
Boolean value to specify whether or not to list default resource groups.
Boolean value to specify whether or not to list deleted resource groups.
WithContext method only
A context.Context instance that you can use to specify a timeout for the operation or to cancel an in-flight request.
The ListResourceGroups options.
The ID of the account that contains the resource groups that you want to get.
The date in the format of YYYY-MM which returns resource groups. Deleted resource groups will be excluded before this month.
The name of the resource group.
Boolean value to specify whether or not to list default resource groups.
Boolean value to specify whether or not to list default resource groups.
The listResourceGroups options.
The ID of the account that contains the resource groups that you want to get.
The date in the format of YYYY-MM which returns resource groups. Deleted resource groups will be excluded before this month.
The name of the resource group.
Boolean value to specify whether or not to list default resource groups.
Boolean value to specify whether or not to list default resource groups.
parameters
The ID of the account that contains the resource groups that you want to get.
The date in the format of YYYY-MM which returns resource groups. Deleted resource groups will be excluded before this month.
The name of the resource group.
Boolean value to specify whether or not to list default resource groups.
Boolean value to specify whether or not to list default resource groups.
parameters
The ID of the account that contains the resource groups that you want to get.
The date in the format of YYYY-MM which returns resource groups. Deleted resource groups will be excluded before this month.
The name of the resource group.
Boolean value to specify whether or not to list default resource groups.
Boolean value to specify whether or not to list default resource groups.
curl -X GET https://resource-controller.cloud.ibm.com/v2/resource_groups?account_id=987d4cfd77b04e9b9e1a6asdcc861234&date=2019-09&name=test -H 'Authorization: Bearer <IAM_TOKEN>'
listResourceGroupsOptions := resourceManagerService.NewListResourceGroupsOptions() listResourceGroupsOptions.SetAccountID(exampleUserAccountID) listResourceGroupsOptions.SetIncludeDeleted(true) resourceGroupList, response, err := resourceManagerService.ListResourceGroups(listResourceGroupsOptions) if err != nil { panic(err) } b, _ := json.MarshalIndent(resourceGroupList, "", " ") fmt.Println(string(b))
ListResourceGroupsOptions listResourceGroupsOptions = new ListResourceGroupsOptions.Builder() .accountId(exampleUserAccountId) .includeDeleted(true) .build(); Response<ResourceGroupList> response = resourceManagerService.listResourceGroups(listResourceGroupsOptions).execute(); ResourceGroupList resourceGroupList = response.getResult(); System.out.println(resourceGroupList);
const params = { accountId: exampleUserAccountId, includeDeleted: true, } resourceManagerService.listResourceGroups(params) .then(res => { console.log(JSON.stringify(res.result, null, 2)); }) .catch(err => { console.warn(err) });
resource_group_list = resource_manager_service.list_resource_groups( account_id=example_user_account_id, include_deleted=True, ).get_result() print(json.dumps(resource_group_list, indent=2))
Response
A list of resource groups
The list of resource groups
A list of resource groups.
The list of resource groups.
- Resources
An alpha-numeric value identifying the resource group.
The full CRN (cloud resource name) associated with the resource group. For more on this format, see Cloud Resource Names.
An alpha-numeric value identifying the account ID.
The human-readable name of the resource group.
The state of the resource group.
Identify if this resource group is default of the account or not.
An alpha-numeric value identifying the quota ID associated with the resource group.
The URL to access the quota details that associated with the resource group.
The URL to access the payment methods details that associated with the resource group.
An array of the resources that linked to the resource group.
The URL to access the team details that associated with the resource group.
The date when the resource group was initially created.
The date when the resource group was last updated.
A list of resource groups.
The list of resource groups.
- resources
An alpha-numeric value identifying the resource group.
The full CRN (cloud resource name) associated with the resource group. For more on this format, see Cloud Resource Names.
An alpha-numeric value identifying the account ID.
The human-readable name of the resource group.
The state of the resource group.
Identify if this resource group is default of the account or not.
An alpha-numeric value identifying the quota ID associated with the resource group.
The URL to access the quota details that associated with the resource group.
The URL to access the payment methods details that associated with the resource group.
An array of the resources that linked to the resource group.
The URL to access the team details that associated with the resource group.
The date when the resource group was initially created.
The date when the resource group was last updated.
A list of resource groups.
The list of resource groups.
- resources
An alpha-numeric value identifying the resource group.
The full CRN (cloud resource name) associated with the resource group. For more on this format, see Cloud Resource Names.
An alpha-numeric value identifying the account ID.
The human-readable name of the resource group.
The state of the resource group.
Identify if this resource group is default of the account or not.
An alpha-numeric value identifying the quota ID associated with the resource group.
The URL to access the quota details that associated with the resource group.
The URL to access the payment methods details that associated with the resource group.
An array of the resources that linked to the resource group.
The URL to access the team details that associated with the resource group.
The date when the resource group was initially created.
The date when the resource group was last updated.
A list of resource groups.
The list of resource groups.
- resources
An alpha-numeric value identifying the resource group.
The full CRN (cloud resource name) associated with the resource group. For more on this format, see Cloud Resource Names.
An alpha-numeric value identifying the account ID.
The human-readable name of the resource group.
The state of the resource group.
Identify if this resource group is default of the account or not.
An alpha-numeric value identifying the quota ID associated with the resource group.
The URL to access the quota details that associated with the resource group.
The URL to access the payment methods details that associated with the resource group.
An array of the resources that linked to the resource group.
The URL to access the team details that associated with the resource group.
The date when the resource group was initially created.
The date when the resource group was last updated.
Status Code
The resource groups was successfully retrieved.
The request could have invalid payload.
Your access token is invalid or authentication of your token failed.
Your access token is valid but does not have the necessary permissions to access this resource.
The resource could not be found.
Too many requests. Please wait a few minutes and try again.
Your request could not be processed. Please try again later. If the problem persists, note the
transaction-id
in the response header and contact IBM Cloud support.
{ "resources": [ { "id": "fee82deba12e4c0fb69c3b09d1f12345", "crn": "crn:v1:bluemix:public:resource-controller::a/987d4cfd77b04e9b9e1a6asdcc861234::resource-group:fee82deba12e4c0fb69c3b09d1f12345", "account_id": "987d4cfd77b04e9b9e1a6asdcc861234", "name": "test", "state": "ACTIVE", "default": false, "quota_id": "a3d7b8d01e261c24677937c29ab33f3c", "quota_url": "/v2/quota_definitions/a3d7b8d01e261c24677937c29ab33f3c", "payment_methods_url": "/v2/resource_groups/fee82deba12e4c0fb69c3b09d1f12345/payment_methods", "resource_linkages": [], "teams_url": "/v2/resource_groups/fee82deba12e4c0fb69c3b09d1f12345/teams", "created_at": "2019-03-04T17:30:33.826Z", "updated_at": "2019-03-04T17:30:33.826Z" } ] }
{ "resources": [ { "id": "fee82deba12e4c0fb69c3b09d1f12345", "crn": "crn:v1:bluemix:public:resource-controller::a/987d4cfd77b04e9b9e1a6asdcc861234::resource-group:fee82deba12e4c0fb69c3b09d1f12345", "account_id": "987d4cfd77b04e9b9e1a6asdcc861234", "name": "test", "state": "ACTIVE", "default": false, "quota_id": "a3d7b8d01e261c24677937c29ab33f3c", "quota_url": "/v2/quota_definitions/a3d7b8d01e261c24677937c29ab33f3c", "payment_methods_url": "/v2/resource_groups/fee82deba12e4c0fb69c3b09d1f12345/payment_methods", "resource_linkages": [], "teams_url": "/v2/resource_groups/fee82deba12e4c0fb69c3b09d1f12345/teams", "created_at": "2019-03-04T17:30:33.826Z", "updated_at": "2019-03-04T17:30:33.826Z" } ] }
Create a resource group
Create a resource group in an account to organize your account resources in customizable groupings so that you can quickly assign users access to more than one resource at a time. To learn what makes a good resource group strategy, see Best practices for organizing resources. A default resource group is created when an account is created. If you have a Lite account or 30-day trial, you cannot create extra resource groups, but you can rename your default resource group. If you have a Pay-As-You-Go or Subscription account, you can create multiple resource groups. You must be assigned an IAM policy with the Administrator role on All Account Management services to create extra resource groups.
Create a resource group in an account to organize your account resources in customizable groupings so that you can quickly assign users access to more than one resource at a time. To learn what makes a good resource group strategy, see Best practices for organizing resources. A default resource group is created when an account is created. If you have a Lite account or 30-day trial, you cannot create extra resource groups, but you can rename your default resource group. If you have a Pay-As-You-Go or Subscription account, you can create multiple resource groups. You must be assigned an IAM policy with the Administrator role on All Account Management services to create extra resource groups.
Create a resource group in an account to organize your account resources in customizable groupings so that you can quickly assign users access to more than one resource at a time. To learn what makes a good resource group strategy, see Best practices for organizing resources. A default resource group is created when an account is created. If you have a Lite account or 30-day trial, you cannot create extra resource groups, but you can rename your default resource group. If you have a Pay-As-You-Go or Subscription account, you can create multiple resource groups. You must be assigned an IAM policy with the Administrator role on All Account Management services to create extra resource groups.
Create a resource group in an account to organize your account resources in customizable groupings so that you can quickly assign users access to more than one resource at a time. To learn what makes a good resource group strategy, see Best practices for organizing resources. A default resource group is created when an account is created. If you have a Lite account or 30-day trial, you cannot create extra resource groups, but you can rename your default resource group. If you have a Pay-As-You-Go or Subscription account, you can create multiple resource groups. You must be assigned an IAM policy with the Administrator role on All Account Management services to create extra resource groups.
Create a resource group in an account to organize your account resources in customizable groupings so that you can quickly assign users access to more than one resource at a time. To learn what makes a good resource group strategy, see Best practices for organizing resources. A default resource group is created when an account is created. If you have a Lite account or 30-day trial, you cannot create extra resource groups, but you can rename your default resource group. If you have a Pay-As-You-Go or Subscription account, you can create multiple resource groups. You must be assigned an IAM policy with the Administrator role on All Account Management services to create extra resource groups.
POST /v2/resource_groups
(resourceManager *ResourceManagerV2) CreateResourceGroup(createResourceGroupOptions *CreateResourceGroupOptions) (result *ResCreateResourceGroup, response *core.DetailedResponse, err error)
(resourceManager *ResourceManagerV2) CreateResourceGroupWithContext(ctx context.Context, createResourceGroupOptions *CreateResourceGroupOptions) (result *ResCreateResourceGroup, response *core.DetailedResponse, err error)
ServiceCall<ResCreateResourceGroup> createResourceGroup(CreateResourceGroupOptions createResourceGroupOptions)
createResourceGroup(params)
create_resource_group(self,
*,
name: str = None,
account_id: str = None,
**kwargs
) -> DetailedResponse
Request
Instantiate the CreateResourceGroupOptions
struct and set the fields to provide parameter values for the CreateResourceGroup
method.
Use the CreateResourceGroupOptions.Builder
to create a CreateResourceGroupOptions
object that contains the parameter values for the createResourceGroup
method.
Request body for creating a resource group
The new name of the resource group.
Example:
test1
The account id of the resource group.
Example:
25eba2a9-beef-450b-82cf-f5ad5e36c6dd
WithContext method only
A context.Context instance that you can use to specify a timeout for the operation or to cancel an in-flight request.
The CreateResourceGroup options.
The new name of the resource group.
Examples:test1
The account id of the resource group.
Examples:25eba2a9-beef-450b-82cf-f5ad5e36c6dd
The createResourceGroup options.
The new name of the resource group.
Examples:test1
The account id of the resource group.
Examples:25eba2a9-beef-450b-82cf-f5ad5e36c6dd
parameters
The new name of the resource group.
Examples:The account id of the resource group.
Examples:
parameters
The new name of the resource group.
Examples:The account id of the resource group.
Examples:
curl -X POST https://resource-controller.cloud.ibm.com/v2/resource_groups -H 'Authorization: Bearer <IAM_TOKEN>' -H 'Content-Type: application/json' -d '{ "account_id": "987d4cfd77b04e9b9e1a6asdcc861234", "name": "test" }'
createResourceGroupOptions := resourceManagerService.NewCreateResourceGroupOptions() createResourceGroupOptions.SetAccountID(exampleUserAccountID) createResourceGroupOptions.SetName("ExampleGroup") resCreateResourceGroup, response, err := resourceManagerService.CreateResourceGroup(createResourceGroupOptions) if err != nil { panic(err) } b, _ := json.MarshalIndent(resCreateResourceGroup, "", " ") fmt.Println(string(b))
CreateResourceGroupOptions createResourceGroupOptions = new CreateResourceGroupOptions.Builder() .accountId(exampleUserAccountId) .name("ExampleGroup") .build(); Response<ResCreateResourceGroup> response = resourceManagerService.createResourceGroup(createResourceGroupOptions).execute(); ResCreateResourceGroup resCreateResourceGroup = response.getResult(); System.out.println(resCreateResourceGroup);
const params = { accountId: exampleUserAccountId, name: "ExampleGroup" }; resourceManagerService.createResourceGroup(params) .then(res => { resourceGroupId = res.result.id; console.log(JSON.stringify(res.result, null, 2)); }) .catch(err => { console.warn(err) });
res_create_resource_group = resource_manager_service.create_resource_group( account_id=example_user_account_id, name='ExampleGroup', ).get_result() print(json.dumps(res_create_resource_group, indent=2))
Response
A newly-created resource group
An alpha-numeric value identifying the resource group.
The full CRN (cloud resource name) associated with the resource group. For more on this format, see Cloud Resource Names.
A newly-created resource group.
An alpha-numeric value identifying the resource group.
The full CRN (cloud resource name) associated with the resource group. For more on this format, see Cloud Resource Names.
A newly-created resource group.
An alpha-numeric value identifying the resource group.
The full CRN (cloud resource name) associated with the resource group. For more on this format, see Cloud Resource Names.
A newly-created resource group.
An alpha-numeric value identifying the resource group.
The full CRN (cloud resource name) associated with the resource group. For more on this format, see Cloud Resource Names.
A newly-created resource group.
An alpha-numeric value identifying the resource group.
The full CRN (cloud resource name) associated with the resource group. For more on this format, see Cloud Resource Names.
Status Code
Resource group has been created.
The request could have invalid payload.
Your access token is invalid or authentication of your token failed.
Your access token is valid but does not have the necessary permissions to access this resource.
The resource could not be found.
Too many requests. Please wait a few minutes and try again.
Your request could not be processed. Please try again later. If the problem persists, note the
transaction-id
in the response header and contact IBM Cloud support.
{ "id": "fee82deba12e4c0fb69c3b09d1f12345", "crn": "crn:v1:bluemix:public:resource-controller::a/987d4cfd77b04e9b9e1a6asdcc861234::resource-group:fee82deba12e4c0fb69c3b09d1f12345" }
{ "id": "fee82deba12e4c0fb69c3b09d1f12345", "crn": "crn:v1:bluemix:public:resource-controller::a/987d4cfd77b04e9b9e1a6asdcc861234::resource-group:fee82deba12e4c0fb69c3b09d1f12345" }
Get a resource group
Retrieve a resource group by alias ID. Call this method to get details about a particular resource group, like the name of the resource group, associated quotas, whether the state is active, the resource group ID and the CRN. The id
returned in the response can be used to create a resource instance later. Users need to be assigned an IAM policy with the Viewer role or higher on the targeted resource group.
Retrieve a resource group by alias ID. Call this method to get details about a particular resource group, like the name of the resource group, associated quotas, whether the state is active, the resource group ID and the CRN. The id
returned in the response can be used to create a resource instance later. Users need to be assigned an IAM policy with the Viewer role or higher on the targeted resource group.
Retrieve a resource group by alias ID. Call this method to get details about a particular resource group, like the name of the resource group, associated quotas, whether the state is active, the resource group ID and the CRN. The id
returned in the response can be used to create a resource instance later. Users need to be assigned an IAM policy with the Viewer role or higher on the targeted resource group.
Retrieve a resource group by alias ID. Call this method to get details about a particular resource group, like the name of the resource group, associated quotas, whether the state is active, the resource group ID and the CRN. The id
returned in the response can be used to create a resource instance later. Users need to be assigned an IAM policy with the Viewer role or higher on the targeted resource group.
Retrieve a resource group by alias ID. Call this method to get details about a particular resource group, like the name of the resource group, associated quotas, whether the state is active, the resource group ID and the CRN. The id
returned in the response can be used to create a resource instance later. Users need to be assigned an IAM policy with the Viewer role or higher on the targeted resource group.
GET /v2/resource_groups/{id}
(resourceManager *ResourceManagerV2) GetResourceGroup(getResourceGroupOptions *GetResourceGroupOptions) (result *ResourceGroup, response *core.DetailedResponse, err error)
(resourceManager *ResourceManagerV2) GetResourceGroupWithContext(ctx context.Context, getResourceGroupOptions *GetResourceGroupOptions) (result *ResourceGroup, response *core.DetailedResponse, err error)
ServiceCall<ResourceGroup> getResourceGroup(GetResourceGroupOptions getResourceGroupOptions)
getResourceGroup(params)
get_resource_group(self,
id: str,
**kwargs
) -> DetailedResponse
Request
Instantiate the GetResourceGroupOptions
struct and set the fields to provide parameter values for the GetResourceGroup
method.
Use the GetResourceGroupOptions.Builder
to create a GetResourceGroupOptions
object that contains the parameter values for the getResourceGroup
method.
Path Parameters
The short or long ID of the alias.
WithContext method only
A context.Context instance that you can use to specify a timeout for the operation or to cancel an in-flight request.
The GetResourceGroup options.
The short or long ID of the alias.
The getResourceGroup options.
The short or long ID of the alias.
parameters
The short or long ID of the alias.
parameters
The short or long ID of the alias.
curl -X GET https://resource-controller.cloud.ibm.com/v2/resource_groups/09f8c1c0742c493f80baaf7835212345 -H 'Authorization: Bearer <IAM_TOKEN>'
getResourceGroupOptions := resourceManagerService.NewGetResourceGroupOptions( resourceGroupID, ) resourceGroup, response, err := resourceManagerService.GetResourceGroup(getResourceGroupOptions) if err != nil { panic(err) } b, _ := json.MarshalIndent(resourceGroup, "", " ") fmt.Println(string(b))
GetResourceGroupOptions getResourceGroupOptions = new GetResourceGroupOptions.Builder() .id(resourceGroupId) .build(); Response<ResourceGroup> response = resourceManagerService.getResourceGroup(getResourceGroupOptions).execute(); ResourceGroup resourceGroup = response.getResult(); System.out.println(resourceGroup);
const params = { id: resourceGroupId, }; resourceManagerService.getResourceGroup(params) .then(res => { console.log(JSON.stringify(res.result, null, 2)); }) .catch(err => { console.warn(err) });
resource_group = resource_manager_service.get_resource_group( id=resource_group_id, ).get_result() print(json.dumps(resource_group, indent=2))
Response
A resource group
An alpha-numeric value identifying the resource group.
The full CRN (cloud resource name) associated with the resource group. For more on this format, see Cloud Resource Names.
An alpha-numeric value identifying the account ID.
The human-readable name of the resource group.
The state of the resource group.
Identify if this resource group is default of the account or not.
An alpha-numeric value identifying the quota ID associated with the resource group.
The URL to access the quota details that associated with the resource group.
The URL to access the payment methods details that associated with the resource group.
An array of the resources that linked to the resource group.
The URL to access the team details that associated with the resource group.
The date when the resource group was initially created.
The date when the resource group was last updated.
A resource group.
An alpha-numeric value identifying the resource group.
The full CRN (cloud resource name) associated with the resource group. For more on this format, see Cloud Resource Names.
An alpha-numeric value identifying the account ID.
The human-readable name of the resource group.
The state of the resource group.
Identify if this resource group is default of the account or not.
An alpha-numeric value identifying the quota ID associated with the resource group.
The URL to access the quota details that associated with the resource group.
The URL to access the payment methods details that associated with the resource group.
An array of the resources that linked to the resource group.
The URL to access the team details that associated with the resource group.
The date when the resource group was initially created.
The date when the resource group was last updated.
A resource group.
An alpha-numeric value identifying the resource group.
The full CRN (cloud resource name) associated with the resource group. For more on this format, see Cloud Resource Names.
An alpha-numeric value identifying the account ID.
The human-readable name of the resource group.
The state of the resource group.
Identify if this resource group is default of the account or not.
An alpha-numeric value identifying the quota ID associated with the resource group.
The URL to access the quota details that associated with the resource group.
The URL to access the payment methods details that associated with the resource group.
An array of the resources that linked to the resource group.
The URL to access the team details that associated with the resource group.
The date when the resource group was initially created.
The date when the resource group was last updated.
A resource group.
An alpha-numeric value identifying the resource group.
The full CRN (cloud resource name) associated with the resource group. For more on this format, see Cloud Resource Names.
An alpha-numeric value identifying the account ID.
The human-readable name of the resource group.
The state of the resource group.
Identify if this resource group is default of the account or not.
An alpha-numeric value identifying the quota ID associated with the resource group.
The URL to access the quota details that associated with the resource group.
The URL to access the payment methods details that associated with the resource group.
An array of the resources that linked to the resource group.
The URL to access the team details that associated with the resource group.
The date when the resource group was initially created.
The date when the resource group was last updated.
A resource group.
An alpha-numeric value identifying the resource group.
The full CRN (cloud resource name) associated with the resource group. For more on this format, see Cloud Resource Names.
An alpha-numeric value identifying the account ID.
The human-readable name of the resource group.
The state of the resource group.
Identify if this resource group is default of the account or not.
An alpha-numeric value identifying the quota ID associated with the resource group.
The URL to access the quota details that associated with the resource group.
The URL to access the payment methods details that associated with the resource group.
An array of the resources that linked to the resource group.
The URL to access the team details that associated with the resource group.
The date when the resource group was initially created.
The date when the resource group was last updated.
Status Code
200 OK
Your access token is invalid or authentication of your token failed.
Your access token is valid but does not have the necessary permissions to access this resource.
The resource could not be found.
Too many requests. Please wait a few minutes and try again.
Your request could not be processed. Please try again later. If the problem persists, note the
transaction-id
in the response header and contact IBM Cloud support.
{ "id": "fee82deba12e4c0fb69c3b09d1f12345", "crn": "crn:v1:bluemix:public:resource-controller::a/987d4cfd77b04e9b9e1a6asdcc861234::resource-group:fee82deba12e4c0fb69c3b09d1f12345", "account_id": "987d4cfd77b04e9b9e1a6asdcc861234", "name": "test", "state": "ACTIVE", "default": false, "quota_id": "a3d7b8d01e261c24677937c29ab33f3c", "quota_url": "/v2/quota_definitions/a3d7b8d01e261c24677937c29ab33f3c", "payment_methods_url": "/v2/resource_groups/fee82deba12e4c0fb69c3b09d1f12345/payment_methods", "resource_linkages": [], "teams_url": "/v2/resource_groups/fee82deba12e4c0fb69c3b09d1f12345/teams", "created_at": "2019-03-04T17:30:33.826Z", "updated_at": "2019-03-04T17:30:33.826Z" }
{ "id": "fee82deba12e4c0fb69c3b09d1f12345", "crn": "crn:v1:bluemix:public:resource-controller::a/987d4cfd77b04e9b9e1a6asdcc861234::resource-group:fee82deba12e4c0fb69c3b09d1f12345", "account_id": "987d4cfd77b04e9b9e1a6asdcc861234", "name": "test", "state": "ACTIVE", "default": false, "quota_id": "a3d7b8d01e261c24677937c29ab33f3c", "quota_url": "/v2/quota_definitions/a3d7b8d01e261c24677937c29ab33f3c", "payment_methods_url": "/v2/resource_groups/fee82deba12e4c0fb69c3b09d1f12345/payment_methods", "resource_linkages": [], "teams_url": "/v2/resource_groups/fee82deba12e4c0fb69c3b09d1f12345/teams", "created_at": "2019-03-04T17:30:33.826Z", "updated_at": "2019-03-04T17:30:33.826Z" }
Update a resource group
Update a resource group by the alias ID. Call this method to update information about an existing resource group. You can rename a resource group and activate or suspend a particular resource group. To update a resource group, users need to be assigned with IAM policies with the Editor role or higher.
Update a resource group by the alias ID. Call this method to update information about an existing resource group. You can rename a resource group and activate or suspend a particular resource group. To update a resource group, users need to be assigned with IAM policies with the Editor role or higher.
Update a resource group by the alias ID. Call this method to update information about an existing resource group. You can rename a resource group and activate or suspend a particular resource group. To update a resource group, users need to be assigned with IAM policies with the Editor role or higher.
Update a resource group by the alias ID. Call this method to update information about an existing resource group. You can rename a resource group and activate or suspend a particular resource group. To update a resource group, users need to be assigned with IAM policies with the Editor role or higher.
Update a resource group by the alias ID. Call this method to update information about an existing resource group. You can rename a resource group and activate or suspend a particular resource group. To update a resource group, users need to be assigned with IAM policies with the Editor role or higher.
PATCH /v2/resource_groups/{id}
(resourceManager *ResourceManagerV2) UpdateResourceGroup(updateResourceGroupOptions *UpdateResourceGroupOptions) (result *ResourceGroup, response *core.DetailedResponse, err error)
(resourceManager *ResourceManagerV2) UpdateResourceGroupWithContext(ctx context.Context, updateResourceGroupOptions *UpdateResourceGroupOptions) (result *ResourceGroup, response *core.DetailedResponse, err error)
ServiceCall<ResourceGroup> updateResourceGroup(UpdateResourceGroupOptions updateResourceGroupOptions)
updateResourceGroup(params)
update_resource_group(self,
id: str,
*,
name: str = None,
state: str = None,
**kwargs
) -> DetailedResponse
Request
Instantiate the UpdateResourceGroupOptions
struct and set the fields to provide parameter values for the UpdateResourceGroup
method.
Use the UpdateResourceGroupOptions.Builder
to create a UpdateResourceGroupOptions
object that contains the parameter values for the updateResourceGroup
method.
Path Parameters
The short or long ID of the alias.
Request body for updating a resource group
The new name of the resource group.
The state of the resource group.
WithContext method only
A context.Context instance that you can use to specify a timeout for the operation or to cancel an in-flight request.
The UpdateResourceGroup options.
The short or long ID of the alias.
The new name of the resource group.
The state of the resource group.
The updateResourceGroup options.
The short or long ID of the alias.
The new name of the resource group.
The state of the resource group.
parameters
The short or long ID of the alias.
The new name of the resource group.
The state of the resource group.
parameters
The short or long ID of the alias.
The new name of the resource group.
The state of the resource group.
curl -X PATCH https://resource-controller.cloud.ibm.com/v2/resource_groups/09f8c1c0742c493f80baaf7835212345 -H 'Authorization: Bearer <IAM_TOKEN>' -H 'Content-Type: application/json' -d '{ "name": "test1" }'
updateResourceGroupOptions := resourceManagerService.NewUpdateResourceGroupOptions( resourceGroupID, ) updateResourceGroupOptions.SetName("RenamedExampleGroup") updateResourceGroupOptions.SetState("ACTIVE") resourceGroup, response, err := resourceManagerService.UpdateResourceGroup(updateResourceGroupOptions) if err != nil { panic(err) } b, _ := json.MarshalIndent(resourceGroup, "", " ") fmt.Println(string(b))
UpdateResourceGroupOptions updateResourceGroupOptions = new UpdateResourceGroupOptions.Builder() .id(resourceGroupId) .name("RenamedExampleGroup") .state("ACTIVE") .build(); Response<ResourceGroup> response = resourceManagerService.updateResourceGroup(updateResourceGroupOptions).execute(); ResourceGroup resourceGroup = response.getResult(); System.out.println(resourceGroup);
const params = { id: resourceGroupId, state: 'ACTIVE', name: 'RenamedExampleGroup' }; resourceManagerService.updateResourceGroup(params) .then(res => { console.log(JSON.stringify(res.result, null, 2)); }) .catch(err => { console.warn(err) });
resource_group = resource_manager_service.update_resource_group( id=resource_group_id, name='RenamedExampleGroup', state='ACTIVE', ).get_result() print(json.dumps(resource_group, indent=2))
Response
A resource group
An alpha-numeric value identifying the resource group.
The full CRN (cloud resource name) associated with the resource group. For more on this format, see Cloud Resource Names.
An alpha-numeric value identifying the account ID.
The human-readable name of the resource group.
The state of the resource group.
Identify if this resource group is default of the account or not.
An alpha-numeric value identifying the quota ID associated with the resource group.
The URL to access the quota details that associated with the resource group.
The URL to access the payment methods details that associated with the resource group.
An array of the resources that linked to the resource group.
The URL to access the team details that associated with the resource group.
The date when the resource group was initially created.
The date when the resource group was last updated.
A resource group.
An alpha-numeric value identifying the resource group.
The full CRN (cloud resource name) associated with the resource group. For more on this format, see Cloud Resource Names.
An alpha-numeric value identifying the account ID.
The human-readable name of the resource group.
The state of the resource group.
Identify if this resource group is default of the account or not.
An alpha-numeric value identifying the quota ID associated with the resource group.
The URL to access the quota details that associated with the resource group.
The URL to access the payment methods details that associated with the resource group.
An array of the resources that linked to the resource group.
The URL to access the team details that associated with the resource group.
The date when the resource group was initially created.
The date when the resource group was last updated.
A resource group.
An alpha-numeric value identifying the resource group.
The full CRN (cloud resource name) associated with the resource group. For more on this format, see Cloud Resource Names.
An alpha-numeric value identifying the account ID.
The human-readable name of the resource group.
The state of the resource group.
Identify if this resource group is default of the account or not.
An alpha-numeric value identifying the quota ID associated with the resource group.
The URL to access the quota details that associated with the resource group.
The URL to access the payment methods details that associated with the resource group.
An array of the resources that linked to the resource group.
The URL to access the team details that associated with the resource group.
The date when the resource group was initially created.
The date when the resource group was last updated.
A resource group.
An alpha-numeric value identifying the resource group.
The full CRN (cloud resource name) associated with the resource group. For more on this format, see Cloud Resource Names.
An alpha-numeric value identifying the account ID.
The human-readable name of the resource group.
The state of the resource group.
Identify if this resource group is default of the account or not.
An alpha-numeric value identifying the quota ID associated with the resource group.
The URL to access the quota details that associated with the resource group.
The URL to access the payment methods details that associated with the resource group.
An array of the resources that linked to the resource group.
The URL to access the team details that associated with the resource group.
The date when the resource group was initially created.
The date when the resource group was last updated.
A resource group.
An alpha-numeric value identifying the resource group.
The full CRN (cloud resource name) associated with the resource group. For more on this format, see Cloud Resource Names.
An alpha-numeric value identifying the account ID.
The human-readable name of the resource group.
The state of the resource group.
Identify if this resource group is default of the account or not.
An alpha-numeric value identifying the quota ID associated with the resource group.
The URL to access the quota details that associated with the resource group.
The URL to access the payment methods details that associated with the resource group.
An array of the resources that linked to the resource group.
The URL to access the team details that associated with the resource group.
The date when the resource group was initially created.
The date when the resource group was last updated.
Status Code
Successfully updated resource group.
The request could have invalid payload.
Your access token is invalid or authentication of your token failed.
Your access token is valid but does not have the necessary permissions to access this resource.
The resource could not be found.
Too many requests. Please wait a few minutes and try again.
Your request could not be processed. Please try again later. If the problem persists, note the
transaction-id
in the response header and contact IBM Cloud support.
{ "id": "fee82deba12e4c0fb69c3b09d1f12345", "crn": "crn:v1:bluemix:public:resource-controller::a/987d4cfd77b04e9b9e1a6asdcc861234::resource-group:fee82deba12e4c0fb69c3b09d1f12345", "account_id": "987d4cfd77b04e9b9e1a6asdcc861234", "name": "test1", "state": "ACTIVE", "default": false, "quota_id": "a3d7b8d01e261c24677937c29ab33f3c", "quota_url": "/v2/quota_definitions/a3d7b8d01e261c24677937c29ab33f3c", "payment_methods_url": "/v2/resource_groups/fee82deba12e4c0fb69c3b09d1f12345/payment_methods", "resource_linkages": [], "teams_url": "/v2/resource_groups/fee82deba12e4c0fb69c3b09d1f12345/teams", "created_at": "2019-03-04T17:30:33.826Z", "updated_at": "2019-03-04T17:30:33.826Z" }
{ "id": "fee82deba12e4c0fb69c3b09d1f12345", "crn": "crn:v1:bluemix:public:resource-controller::a/987d4cfd77b04e9b9e1a6asdcc861234::resource-group:fee82deba12e4c0fb69c3b09d1f12345", "account_id": "987d4cfd77b04e9b9e1a6asdcc861234", "name": "test1", "state": "ACTIVE", "default": false, "quota_id": "a3d7b8d01e261c24677937c29ab33f3c", "quota_url": "/v2/quota_definitions/a3d7b8d01e261c24677937c29ab33f3c", "payment_methods_url": "/v2/resource_groups/fee82deba12e4c0fb69c3b09d1f12345/payment_methods", "resource_linkages": [], "teams_url": "/v2/resource_groups/fee82deba12e4c0fb69c3b09d1f12345/teams", "created_at": "2019-03-04T17:30:33.826Z", "updated_at": "2019-03-04T17:30:33.826Z" }
Delete a resource group
Delete a resource group by the alias ID. You can delete a resource group only if the targeted resource group does not contain any resources or if it is not a default resource group. When a user creates an account, a default resource group is created in the account. If you want to delete a resource group that contains resources, first delete the resource instances. Then, delete the resource group when all resource instances in the group are deleted. Users need to be assigned an IAM policy with the Editor role or higher on the targeted resource group.
Delete a resource group by the alias ID. You can delete a resource group only if the targeted resource group does not contain any resources or if it is not a default resource group. When a user creates an account, a default resource group is created in the account. If you want to delete a resource group that contains resources, first delete the resource instances. Then, delete the resource group when all resource instances in the group are deleted. Users need to be assigned an IAM policy with the Editor role or higher on the targeted resource group.
Delete a resource group by the alias ID. You can delete a resource group only if the targeted resource group does not contain any resources or if it is not a default resource group. When a user creates an account, a default resource group is created in the account. If you want to delete a resource group that contains resources, first delete the resource instances. Then, delete the resource group when all resource instances in the group are deleted. Users need to be assigned an IAM policy with the Editor role or higher on the targeted resource group.
Delete a resource group by the alias ID. You can delete a resource group only if the targeted resource group does not contain any resources or if it is not a default resource group. When a user creates an account, a default resource group is created in the account. If you want to delete a resource group that contains resources, first delete the resource instances. Then, delete the resource group when all resource instances in the group are deleted. Users need to be assigned an IAM policy with the Editor role or higher on the targeted resource group.
Delete a resource group by the alias ID. You can delete a resource group only if the targeted resource group does not contain any resources or if it is not a default resource group. When a user creates an account, a default resource group is created in the account. If you want to delete a resource group that contains resources, first delete the resource instances. Then, delete the resource group when all resource instances in the group are deleted. Users need to be assigned an IAM policy with the Editor role or higher on the targeted resource group.
DELETE /v2/resource_groups/{id}
(resourceManager *ResourceManagerV2) DeleteResourceGroup(deleteResourceGroupOptions *DeleteResourceGroupOptions) (response *core.DetailedResponse, err error)
(resourceManager *ResourceManagerV2) DeleteResourceGroupWithContext(ctx context.Context, deleteResourceGroupOptions *DeleteResourceGroupOptions) (response *core.DetailedResponse, err error)
ServiceCall<Void> deleteResourceGroup(DeleteResourceGroupOptions deleteResourceGroupOptions)
deleteResourceGroup(params)
delete_resource_group(self,
id: str,
**kwargs
) -> DetailedResponse
Request
Instantiate the DeleteResourceGroupOptions
struct and set the fields to provide parameter values for the DeleteResourceGroup
method.
Use the DeleteResourceGroupOptions.Builder
to create a DeleteResourceGroupOptions
object that contains the parameter values for the deleteResourceGroup
method.
Path Parameters
The short or long ID of the alias.
WithContext method only
A context.Context instance that you can use to specify a timeout for the operation or to cancel an in-flight request.
The DeleteResourceGroup options.
The short or long ID of the alias.
The deleteResourceGroup options.
The short or long ID of the alias.
parameters
The short or long ID of the alias.
parameters
The short or long ID of the alias.
curl -X DELETE https://resource-controller.cloud.ibm.com/v2/resource_groups/09f8c1c0742c493f80baaf7835212345 -H 'Authorization: Bearer <IAM_TOKEN>' -H 'Content-Type: application/json'
deleteResourceGroupOptions := resourceManagerService.NewDeleteResourceGroupOptions( resourceGroupID, ) response, err := deleteResourceManagerService.DeleteResourceGroup(deleteResourceGroupOptions) if err != nil { panic(err) }
DeleteResourceGroupOptions deleteResourceGroupOptions = new DeleteResourceGroupOptions.Builder() .id(resourceGroupId) .build(); deleteResourceManagerService.deleteResourceGroup(deleteResourceGroupOptions).execute();
const params = { id: resourceGroupId, }; deleteResourceManagerService.deleteResourceGroup(params) .then(res => { console.log(JSON.stringify(res.result, null, 2)); }) .catch(err => { console.warn(err) });
response = delete_resource_manager_service.delete_resource_group( id=resource_group_id, ).get_result() print(json.dumps(response, indent=2))
Response
Status Code
The resource group is successfully deleted.
The request could have invalid payload.
Your access token is invalid or authentication of your token failed.
Your access token is valid but does not have the necessary permissions to access this resource.
The resource could not be found.
Too many requests. Please wait a few minutes and try again.
Your request could not be processed. Please try again later. If the problem persists, note the
transaction-id
in the response header and contact IBM Cloud support.
No Sample Response
List quota definitions
Get a list of all quota definitions. Quotas for a resource group limit the number of apps, instances, and memory allowed for that specific resource group. Each resource group that you have on your account has a specific set of quotas. Standard quotas are for resource groups that are created by users with a Lite account, and Pay-As-You-Go quotas are for resource groups that are created with a Pay-As-You-Go account. This method provides list of all available quota definitions. No specific IAM policy needed.
Get a list of all quota definitions. Quotas for a resource group limit the number of apps, instances, and memory allowed for that specific resource group. Each resource group that you have on your account has a specific set of quotas. Standard quotas are for resource groups that are created by users with a Lite account, and Pay-As-You-Go quotas are for resource groups that are created with a Pay-As-You-Go account. This method provides list of all available quota definitions. No specific IAM policy needed.
Get a list of all quota definitions. Quotas for a resource group limit the number of apps, instances, and memory allowed for that specific resource group. Each resource group that you have on your account has a specific set of quotas. Standard quotas are for resource groups that are created by users with a Lite account, and Pay-As-You-Go quotas are for resource groups that are created with a Pay-As-You-Go account. This method provides list of all available quota definitions. No specific IAM policy needed.
Get a list of all quota definitions. Quotas for a resource group limit the number of apps, instances, and memory allowed for that specific resource group. Each resource group that you have on your account has a specific set of quotas. Standard quotas are for resource groups that are created by users with a Lite account, and Pay-As-You-Go quotas are for resource groups that are created with a Pay-As-You-Go account. This method provides list of all available quota definitions. No specific IAM policy needed.
Get a list of all quota definitions. Quotas for a resource group limit the number of apps, instances, and memory allowed for that specific resource group. Each resource group that you have on your account has a specific set of quotas. Standard quotas are for resource groups that are created by users with a Lite account, and Pay-As-You-Go quotas are for resource groups that are created with a Pay-As-You-Go account. This method provides list of all available quota definitions. No specific IAM policy needed.
GET /v2/quota_definitions
(resourceManager *ResourceManagerV2) ListQuotaDefinitions(listQuotaDefinitionsOptions *ListQuotaDefinitionsOptions) (result *QuotaDefinitionList, response *core.DetailedResponse, err error)
(resourceManager *ResourceManagerV2) ListQuotaDefinitionsWithContext(ctx context.Context, listQuotaDefinitionsOptions *ListQuotaDefinitionsOptions) (result *QuotaDefinitionList, response *core.DetailedResponse, err error)
ServiceCall<QuotaDefinitionList> listQuotaDefinitions()
listQuotaDefinitions(params)
list_quota_definitions(self,
**kwargs
) -> DetailedResponse
Request
No Request Parameters
WithContext method only
A context.Context instance that you can use to specify a timeout for the operation or to cancel an in-flight request.
No Request Parameters
No Request Parameters
No Request Parameters
No Request Parameters
curl -X GET https://resource-controller.cloud.ibm.com/v2/quota_definitions -H 'Authorization: Bearer <IAM_TOKEN>'
listQuotaDefinitionsOptions := resourceManagerService.NewListQuotaDefinitionsOptions() quotaDefinitionList, response, err := resourceManagerService.ListQuotaDefinitions(listQuotaDefinitionsOptions) if err != nil { panic(err) } b, _ := json.MarshalIndent(quotaDefinitionList, "", " ") fmt.Println(string(b))
ListQuotaDefinitionsOptions listQuotaDefinitionsOptions = new ListQuotaDefinitionsOptions(); Response<QuotaDefinitionList> response = resourceManagerService.listQuotaDefinitions().execute(); QuotaDefinitionList quotaDefinitionList = response.getResult(); System.out.println(quotaDefinitionList);
resourceManagerService.listQuotaDefinitions({}) .then(res => { console.log(JSON.stringify(res.result, null, 2)); }) .catch(err => { console.warn(err) });
quota_definition_list = resource_manager_service.list_quota_definitions().get_result() print(json.dumps(quota_definition_list, indent=2))
Response
A list of quota definitions
The list of quota definitions
A list of quota definitions.
The list of quota definitions.
- Resources
An alpha-numeric value identifying the quota.
The human-readable name of the quota.
The type of the quota.
The total app limit.
The total service instances limit per app.
Default number of instances per lite plan.
The total instances limit per app.
The total memory of app instance.
The total app memory capacity.
The VSI limit.
The resource quotas associated with a quota definition.
- ResourceQuotas
An alpha-numeric value identifying the quota.
The human-readable name of the quota.
The full CRN (cloud resource name) associated with the quota. For more on this format, see https://cloud.ibm.com/docs/account?topic=account-crn.
The limit number of this resource.
The date when the quota was initially created.
The date when the quota was last updated.
A list of quota definitions.
The list of quota definitions.
- resources
An alpha-numeric value identifying the quota.
The human-readable name of the quota.
The type of the quota.
The total app limit.
The total service instances limit per app.
Default number of instances per lite plan.
The total instances limit per app.
The total memory of app instance.
The total app memory capacity.
The VSI limit.
The resource quotas associated with a quota definition.
- resourceQuotas
An alpha-numeric value identifying the quota.
The human-readable name of the quota.
The full CRN (cloud resource name) associated with the quota. For more on this format, see https://cloud.ibm.com/docs/account?topic=account-crn.
The limit number of this resource.
The date when the quota was initially created.
The date when the quota was last updated.
A list of quota definitions.
The list of quota definitions.
- resources
An alpha-numeric value identifying the quota.
The human-readable name of the quota.
The type of the quota.
The total app limit.
The total service instances limit per app.
Default number of instances per lite plan.
The total instances limit per app.
The total memory of app instance.
The total app memory capacity.
The VSI limit.
The resource quotas associated with a quota definition.
- resource_quotas
An alpha-numeric value identifying the quota.
The human-readable name of the quota.
The full CRN (cloud resource name) associated with the quota. For more on this format, see https://cloud.ibm.com/docs/account?topic=account-crn.
The limit number of this resource.
The date when the quota was initially created.
The date when the quota was last updated.
A list of quota definitions.
The list of quota definitions.
- resources
An alpha-numeric value identifying the quota.
The human-readable name of the quota.
The type of the quota.
The total app limit.
The total service instances limit per app.
Default number of instances per lite plan.
The total instances limit per app.
The total memory of app instance.
The total app memory capacity.
The VSI limit.
The resource quotas associated with a quota definition.
- resource_quotas
An alpha-numeric value identifying the quota.
The human-readable name of the quota.
The full CRN (cloud resource name) associated with the quota. For more on this format, see https://cloud.ibm.com/docs/account?topic=account-crn.
The limit number of this resource.
The date when the quota was initially created.
The date when the quota was last updated.
Status Code
The quota definitions were successfully retrieved.
The request could have invalid payload.
Your access token is invalid or authentication of your token failed.
Your access token is valid but does not have the necessary permissions to access this resource.
The resource could not be found.
Too many requests. Please wait a few minutes and try again.
Your request could not be processed. Please try again later. If the problem persists, note the
transaction-id
in the response header and contact IBM Cloud support.
{ "resources": [ { "_id": "7ce89f4a-4381-4600-b814-3cd9a412345", "_rev": "14-e8384c02aac04afcc08ce7991234556", "name": "Trial Quota", "type": "SDQ", "number_of_service_instances": 1000, "number_of_apps": 4, "instances_per_app": 4, "instance_memory": "1G", "total_app_memory": "1G", "vsi_limit": 1, "resource_quotas": [ { "_id": "65012f5b6fa84ecaaac5eab4abc12345", "resource_id": "rcf0c17db8-35ad-11e7-a919-92ebc1234567", "crn": "crn:v1:bluemix:public:resource-catalog::global:::rcf0c17db8-35ad-11e7-a919-92ebc1234567", "limit": 1 } ], "created_at": "2017-05-16T17:12:52.925Z", "updated_at": "2019-01-09T17:12:52.925Z" } ] }
{ "resources": [ { "_id": "7ce89f4a-4381-4600-b814-3cd9a412345", "_rev": "14-e8384c02aac04afcc08ce7991234556", "name": "Trial Quota", "type": "SDQ", "number_of_service_instances": 1000, "number_of_apps": 4, "instances_per_app": 4, "instance_memory": "1G", "total_app_memory": "1G", "vsi_limit": 1, "resource_quotas": [ { "_id": "65012f5b6fa84ecaaac5eab4abc12345", "resource_id": "rcf0c17db8-35ad-11e7-a919-92ebc1234567", "crn": "crn:v1:bluemix:public:resource-catalog::global:::rcf0c17db8-35ad-11e7-a919-92ebc1234567", "limit": 1 } ], "created_at": "2017-05-16T17:12:52.925Z", "updated_at": "2019-01-09T17:12:52.925Z" } ] }
Get a quota definition
Call this method to retrieve information about a particular quota by passing the quota ID. The response can be used to identify the quota type, Standard or Paid. Information about available resources, such as number of apps, number of service instances, and memory, are returned in the response. Quotas for a resource group limit the number of apps, instances, and memory allowed for that specific resource group. Each resource group that you have on your account has a specific set of quotas. Standard quotas are for resource groups that are created by users with a Lite account, and Pay-As-You-Go quotas are for resource groups that are created with a Pay-As-You-Go account. No specific IAM policy needed.
Call this method to retrieve information about a particular quota by passing the quota ID. The response can be used to identify the quota type, Standard or Paid. Information about available resources, such as number of apps, number of service instances, and memory, are returned in the response. Quotas for a resource group limit the number of apps, instances, and memory allowed for that specific resource group. Each resource group that you have on your account has a specific set of quotas. Standard quotas are for resource groups that are created by users with a Lite account, and Pay-As-You-Go quotas are for resource groups that are created with a Pay-As-You-Go account. No specific IAM policy needed.
Call this method to retrieve information about a particular quota by passing the quota ID. The response can be used to identify the quota type, Standard or Paid. Information about available resources, such as number of apps, number of service instances, and memory, are returned in the response. Quotas for a resource group limit the number of apps, instances, and memory allowed for that specific resource group. Each resource group that you have on your account has a specific set of quotas. Standard quotas are for resource groups that are created by users with a Lite account, and Pay-As-You-Go quotas are for resource groups that are created with a Pay-As-You-Go account. No specific IAM policy needed.
Call this method to retrieve information about a particular quota by passing the quota ID. The response can be used to identify the quota type, Standard or Paid. Information about available resources, such as number of apps, number of service instances, and memory, are returned in the response. Quotas for a resource group limit the number of apps, instances, and memory allowed for that specific resource group. Each resource group that you have on your account has a specific set of quotas. Standard quotas are for resource groups that are created by users with a Lite account, and Pay-As-You-Go quotas are for resource groups that are created with a Pay-As-You-Go account. No specific IAM policy needed.
Call this method to retrieve information about a particular quota by passing the quota ID. The response can be used to identify the quota type, Standard or Paid. Information about available resources, such as number of apps, number of service instances, and memory, are returned in the response. Quotas for a resource group limit the number of apps, instances, and memory allowed for that specific resource group. Each resource group that you have on your account has a specific set of quotas. Standard quotas are for resource groups that are created by users with a Lite account, and Pay-As-You-Go quotas are for resource groups that are created with a Pay-As-You-Go account. No specific IAM policy needed.
GET /v2/quota_definitions/{id}
(resourceManager *ResourceManagerV2) GetQuotaDefinition(getQuotaDefinitionOptions *GetQuotaDefinitionOptions) (result *QuotaDefinition, response *core.DetailedResponse, err error)
(resourceManager *ResourceManagerV2) GetQuotaDefinitionWithContext(ctx context.Context, getQuotaDefinitionOptions *GetQuotaDefinitionOptions) (result *QuotaDefinition, response *core.DetailedResponse, err error)
ServiceCall<QuotaDefinition> getQuotaDefinition(GetQuotaDefinitionOptions getQuotaDefinitionOptions)
getQuotaDefinition(params)
get_quota_definition(self,
id: str,
**kwargs
) -> DetailedResponse
Request
Instantiate the GetQuotaDefinitionOptions
struct and set the fields to provide parameter values for the GetQuotaDefinition
method.
Use the GetQuotaDefinitionOptions.Builder
to create a GetQuotaDefinitionOptions
object that contains the parameter values for the getQuotaDefinition
method.
Path Parameters
The id of the quota.
WithContext method only
A context.Context instance that you can use to specify a timeout for the operation or to cancel an in-flight request.
The GetQuotaDefinition options.
The id of the quota.
The getQuotaDefinition options.
The id of the quota.
parameters
The id of the quota.
parameters
The id of the quota.
curl -X GET https://resource-controller.cloud.ibm.com/v2/quota_definitions/7ce89f4a-4381-4600-b814-3cd9a4f12345 -H 'Authorization: Bearer <IAM_TOKEN>'
getQuotaDefinitionOptions := resourceManagerService.NewGetQuotaDefinitionOptions( exampleQuotaID, ) quotaDefinition, response, err := resourceManagerService.GetQuotaDefinition(getQuotaDefinitionOptions) if err != nil { panic(err) } b, _ := json.MarshalIndent(quotaDefinition, "", " ") fmt.Println(string(b))
GetQuotaDefinitionOptions getQuotaDefinitionOptions = new GetQuotaDefinitionOptions.Builder() .id(exampleQuotaId) .build(); Response<QuotaDefinition> response = resourceManagerService.getQuotaDefinition(getQuotaDefinitionOptions).execute(); QuotaDefinition quotaDefinition = response.getResult(); System.out.println(quotaDefinition);
const params = { id: exampleQuotaId, }; resourceManagerService.getQuotaDefinition(params) .then(res => { console.log(JSON.stringify(res.result, null, 2)); }) .catch(err => { console.warn(err) });
quota_definition = resource_manager_service.get_quota_definition( id=example_quota_id, ).get_result() print(json.dumps(quota_definition, indent=2))
Response
A returned quota definition
An alpha-numeric value identifying the quota.
The human-readable name of the quota.
The type of the quota.
The total app limit.
The total service instances limit per app.
Default number of instances per lite plan.
The total instances limit per app.
The total memory of app instance.
The total app memory capacity.
The VSI limit.
The resource quotas associated with a quota definition.
The date when the quota was initially created.
The date when the quota was last updated.
A returned quota definition.
An alpha-numeric value identifying the quota.
The human-readable name of the quota.
The type of the quota.
The total app limit.
The total service instances limit per app.
Default number of instances per lite plan.
The total instances limit per app.
The total memory of app instance.
The total app memory capacity.
The VSI limit.
The resource quotas associated with a quota definition.
- ResourceQuotas
An alpha-numeric value identifying the quota.
The human-readable name of the quota.
The full CRN (cloud resource name) associated with the quota. For more on this format, see https://cloud.ibm.com/docs/account?topic=account-crn.
The limit number of this resource.
The date when the quota was initially created.
The date when the quota was last updated.
A returned quota definition.
An alpha-numeric value identifying the quota.
The human-readable name of the quota.
The type of the quota.
The total app limit.
The total service instances limit per app.
Default number of instances per lite plan.
The total instances limit per app.
The total memory of app instance.
The total app memory capacity.
The VSI limit.
The resource quotas associated with a quota definition.
- resourceQuotas
An alpha-numeric value identifying the quota.
The human-readable name of the quota.
The full CRN (cloud resource name) associated with the quota. For more on this format, see https://cloud.ibm.com/docs/account?topic=account-crn.
The limit number of this resource.
The date when the quota was initially created.
The date when the quota was last updated.
A returned quota definition.
An alpha-numeric value identifying the quota.
The human-readable name of the quota.
The type of the quota.
The total app limit.
The total service instances limit per app.
Default number of instances per lite plan.
The total instances limit per app.
The total memory of app instance.
The total app memory capacity.
The VSI limit.
The resource quotas associated with a quota definition.
- resource_quotas
An alpha-numeric value identifying the quota.
The human-readable name of the quota.
The full CRN (cloud resource name) associated with the quota. For more on this format, see https://cloud.ibm.com/docs/account?topic=account-crn.
The limit number of this resource.
The date when the quota was initially created.
The date when the quota was last updated.
A returned quota definition.
An alpha-numeric value identifying the quota.
The human-readable name of the quota.
The type of the quota.
The total app limit.
The total service instances limit per app.
Default number of instances per lite plan.
The total instances limit per app.
The total memory of app instance.
The total app memory capacity.
The VSI limit.
The resource quotas associated with a quota definition.
- resource_quotas
An alpha-numeric value identifying the quota.
The human-readable name of the quota.
The full CRN (cloud resource name) associated with the quota. For more on this format, see https://cloud.ibm.com/docs/account?topic=account-crn.
The limit number of this resource.
The date when the quota was initially created.
The date when the quota was last updated.
Status Code
The quota is successfully retrieved.
The request could have invalid payload.
Your access token is invalid or authentication of your token failed.
Your access token is valid but does not have the necessary permissions to access this resource.
The resource could not be found.
Too many requests. Please wait a few minutes and try again.
Your request could not be processed. Please try again later. If the problem persists, note the
transaction-id
in the response header and contact IBM Cloud support.
{ "_id": "7ce89f4a-4381-4600-b814-3cd9a412345", "_rev": "14-e8384c02aac04afcc08ce7991234556", "name": "Trial Quota", "type": "SDQ", "number_of_service_instances": 1000, "number_of_apps": 4, "instances_per_app": 4, "instance_memory": "1G", "total_app_memory": "1G", "vsi_limit": 1, "resource_quotas": [ { "_id": "65012f5b6fa84ecaaac5eab4abc12345", "resource_id": "rcf0c17db8-35ad-11e7-a919-92ebc1234567", "crn": "crn:v1:bluemix:public:resource-catalog::global:::rcf0c17db8-35ad-11e7-a919-92ebc1234567", "limit": 1 } ], "created_at": "2017-05-16T17:12:52.925Z", "updated_at": "2019-01-09T17:12:52.925Z" }
{ "_id": "7ce89f4a-4381-4600-b814-3cd9a412345", "_rev": "14-e8384c02aac04afcc08ce7991234556", "name": "Trial Quota", "type": "SDQ", "number_of_service_instances": 1000, "number_of_apps": 4, "instances_per_app": 4, "instance_memory": "1G", "total_app_memory": "1G", "vsi_limit": 1, "resource_quotas": [ { "_id": "65012f5b6fa84ecaaac5eab4abc12345", "resource_id": "rcf0c17db8-35ad-11e7-a919-92ebc1234567", "crn": "crn:v1:bluemix:public:resource-catalog::global:::rcf0c17db8-35ad-11e7-a919-92ebc1234567", "limit": 1 } ], "created_at": "2017-05-16T17:12:52.925Z", "updated_at": "2019-01-09T17:12:52.925Z" }