Ressourcengruppe erstellen

Wenn Sie über ein nutzungsabhängiges Konto oder ein Abonnementkonto verfügen, dann können Sie mehrere Ressourcengruppen erstellen, um auf einfache Weise Kontingente zu verwalten und die Informationen zu Abrechnung und Nutzung für ein Ressourcenset anzuzeigen. Durch die Gruppierung von Ressourcen wird außerdem die gleichzeitige Zuweisung von Zugriffsberechtigungen für mehrere Instanzen an die Benutzer erleichtert. Sie können maximal 1000 Ressourcengruppen pro Konto haben. Ihnen muss eine IAM-Richtlinie mit der Administratorrolle für alle Kontoverwaltungsservices zugewiesen sein, damit Sie zusätzliche Ressourcengruppen erstellen können. Wenn Sie über ein Lite-Konto oder ein 30-Tage-Testkonto verfügen, können Sie zwar keine zusätzlichen Ressourcengruppen erstellen, jedoch die Standardressourcengruppe umbenennen.

Ressourcengruppe in der Konsole erstellen

1. Gehen Sie in der IBM Cloud-Konsole auf Verwalten > Konto > Kontoressourcen > Ressourcengruppen.
2. Klicken Sie auf Erstellen.
3. Geben Sie einen Namen für Ihre Ressourcengruppe ein.
4. Klicken Sie auf Erstellen.

Ressourcengruppe über die Befehlszeilenschnittstelle (CLI) erstellen

Sie können eine Ressourcengruppe erstellen und umbenennen oder eine Ressource in einer Gruppe anzeigen, indem Sie die IBM Cloud® Befehlszeilenschnittstelle. Ausführliche Informationen zur Arbeit mit Ressourcen finden Sie in Mit Ressourcen und Ressourcengruppen arbeiten.

1. Melden Sie sich an und wählen Sie das Konto aus.

   ibmcloud login
   

2. Erstellen Sie eine neue Ressourcengruppe, indem Sie den Befehl ibmcloud resource group-create ausführen. Zum Beispiel wird mit dem folgenden Befehl eine Ressourcengruppe mit dem Namen group2 erstellt:

ibmcloud resource group-create group2

Ressourcengruppe über die Anwendungsprogrammierschnittstelle (API) erstellen

Wenn Sie über ein nutzungsabhängiges Konto oder ein Abonnementkonto verfügen, dann können Sie mehrere Ressourcengruppen erstellen, um auf einfache Weise Kontingente zu verwalten und die Informationen zu Abrechnung und Nutzung für ein Ressourcenset anzuzeigen. Durch die Gruppierung von Ressourcen wird außerdem die gleichzeitige Zuweisung von Zugriffsberechtigungen für mehrere Instanzen an die Benutzer erleichtert.

Ihnen muss eine IAM-Richtlinie mit der Administratorrolle für alle Kontoverwaltungsservices zugewiesen sein, damit Sie zusätzliche Ressourcengruppen erstellen können. Wenn Sie über ein Lite-Konto oder ein 30-Tage-Testkonto verfügen, können Sie zwar keine zusätzlichen Ressourcengruppen erstellen, jedoch die Standardressourcengruppe umbenennen.

Sie können eine Ressourcengruppe erstellen, indem Sie die IBM Cloud® Resource Manager-API aufrufen, wie im folgenden Beispiel dargestellt:

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 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))

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))

Vorbereitende Schritte

Bevor Sie Ressourcengruppen mit Terraform verwalten können, müssen Sie die folgenden Schritte durchführen:

• Installieren Sie das Terraform CLI und konfigurieren Sie das IBM Cloud Provider-Plugin für Terraform. Weitere Informationen finden Sie in der Anleitung zu den ersten Schritten mit Terraform auf IBM Cloud®. Das Plug-in abstrahiert die IBM Cloud APIs, die zur Erfüllung dieses Tasks verwendet werden.

• Erstellen Sie eine Terraform-Konfigurationsdatei mit dem Namen main.tf. In dieser Datei definieren Sie die Ressourcen mit Hilfe der HashiCorp Configuration Language. Weitere Informationen finden Sie in der Terraform-Dokumentation.

Ressourcengruppe mittels Terraform erstellen

Verwenden Sie die folgenden Schritte, um eine Ressourcengruppe mit Terraform zu erstellen:

1. Erstellen Sie ein Argument in Ihrer Datei " main.tf. Im folgenden Beispiel wird eine Zugriffsgruppe unter Verwendung der Ressource ibm_resource_group erstellt; hierbei steht name für einen eindeutigen Namen zur Kennzeichnung der Ressourcengruppe.

   resource "ibm_resource_group" "resourceGroup" {
    name     = "prod"
   }
   

   Sie können tags angeben, die der Ressourcengruppeninstanz zugeordnet sind. Weitere Informationen finden Sie in den Argumentreferenzdetails auf der Seite "Terraform Resource Management ".

2. Nachdem Sie Ihre Konfigurationsdatei erstellt haben, initialisieren Sie die Terraform CLI. Weitere Informationen finden Sie unter Initialisierung von Arbeitsverzeichnissen.

   terraform init
   

3. Bereitstellung der Ressourcen aus der Datei " main.tf. Weitere Informationen finden Sie unter Bereitstellung der Infrastruktur mit Terraform.

   1. Führen Sie ' terraform plan aus, um einen Terraform-Ausführungsplan zu erstellen, der eine Vorschau auf die vorgeschlagenen Aktionen enthält.

      terraform plan
      

   2. Führen Sie ' terraform apply aus, um die im Plan definierten Ressourcen zu erstellen.

      terraform apply
      

Ressourcengruppe umbenennen

Ihre erste Ressourcengruppe wird vom System für Sie erstellt und erhält den Namen Default. Sie können den Namen dieser Gruppe oder anderer Gruppen, die Sie erstellen, aktualisieren.

ibmcloud resource group-update Default [-n, --name Admin]

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 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))

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))

Ressourcen zu einer Ressourcengruppe hinzufügen

Dienste, die mit IAM verwaltet werden, gehören zu einer Ressourcengruppe. Wenn Sie eine Instanz eines dieser Services über den Katalog erstellen, werden Sie aufgefordert, die Instanz einer Ressourcengruppe zuzuweisen. Planen Sie sorgfältig, wie Ressourcen in Ihrem Konto strukturiert werden sollen, bevor Sie Ressourcen zu einer Ressourcengruppe zuweisen. Ihre Ressourcengruppenauswahl bei der Erstellung der Instanz ist endgültig und kann nicht geändert werden.

Ihre Ressourcengruppenauswahl bei der Erstellung der Instanz ist endgültig und kann nicht geändert werden.

Der IBM Cloud-Kontoeigner kann Ressourcen zu jeder beliebigen Ressourcengruppe hinzufügen, die übrigen Benutzer können dies nur, wenn ihnen zuvor über eine IAM-Zugriffsrichtlinie Zugriff erteilt wurde. Benutzern in Ihrem Konto müssen zwei Zugriffsrichtlinien zugewiesen werden, damit sie Ressourcen über den Katalog erstellen und zu einer Ressourcengruppe hinzufügen können:

• Eine Richtlinie mit Rolle des Anzeigeberechtigten ('A') oder höher für die Ressourcengruppe selbst
• Eine Richtlinie mit Rolle des Bearbeiters oder höher für den Service im Konto

Führen Sie die folgenden Schritte aus, um die Ressourcen zu einer Ressourcengruppe hinzuzufügen:

1. Gehen Sie in der IBM Cloud-Konsole auf Verwalten > Konto > Kontoressourcen > Ressourcengruppen.
2. Klicken Sie im Aktionen-Menü auf das und wählen Sie Ressourcen hinzufügen.
3. Hier werden Sie an den Katalog weitergeleitet. Sie können die Produkte durchsuchen oder nach einer bestimmten Kategorie, einem Anbieter, einem Preisplan, einer Art der Konformität oder einem Veröffentlichungstyp filtern. Beispiele für Ressourcen sind Apps, Serviceinstanzen, Container-Cluster, Speicherdatenträger, Virtual Server-Systeme und Software.

Ressourcen über die Anwendungsprogrammierschnittstelle (API) zu einer Ressourcengruppe hinzufügen

Unter Katalogeinstellungen verwalten finden Sie Informationen zum Festlegen der Anzeigeoptionen für den IBM Cloud®-Katalog und zur Steuerung des Zugriffs auf Produkte im öffentlichen Katalog und in den privaten Katalogen in Ihrem Konto.

Ressourcen in einer Ressourcengruppe anzeigen

Um einfach die Ressourcen anzuzeigen, die einer Ressourcengruppe zugewiesen sind, gehen Sie zum Navigationsmenüsymbol > Ressourcenliste. Filtern Sie anschließend nach der Ressourcengruppe.

Wenn Sie Ihre klassische Infrastruktur-Ressource auf der Seite Ressourcenliste nicht finden können, überprüfen Sie die Geräteliste, indem Sie auf das Symbol Navigationssymbol > Klassische Infrastruktur > Geräteliste klicken.

Ressourcen in einer Ressourcengruppe mithilfe der Befehlszeilenschnittstelle anzeigen

1. Melden Sie sich an und wählen Sie das Konto aus.

   ibmcloud login
   

2. Zeigen Sie die Ressourcen an, die einer bestimmten Ressourcengruppe zugewiesen sind, indem Sie den Befehl ibmcloud resource service-instances ausführen. Zum Beispiel werden mit dem folgenden Befehl alle Ressourcen aufgeführt, die sich in der Ressourcengruppe Default befinden:

ibmcloud resource service-instances -g Default

Ressourcen in einer Ressourcengruppe über die Anwendungsprogrammierschnittstelle (API) anzeigen

Sie können die Ressourcen in einer Ressourcengruppe anzeigen, indem Sie die IBM Cloud® Resource Controller-API aufrufen, wie im folgenden Beispiel dargestellt:

curl -X GET https://resource-controller.cloud.ibm.com/v2/resource_instances -H 'Authorization: Bearer <>'

ListResourceInstancesOptions listResourceInstancesOptions = new ListResourceInstancesOptions.Builder()
  .name(resourceInstanceName)
  .build();
Response<ResourceInstancesList> response = service.listResourceInstances(listResourceInstancesOptions).execute();
ResourceInstancesList resourceInstancesList = response.getResult();
System.out.printf("listResourceInstances() response:\n%s\n", resourceInstancesList.toString());

const params = {
  name: resourceInstanceName,
};
resourceControllerService.listResourceInstances(params)
  .then(res => {
    console.log('listResourceInstances() response:\n' + JSON.stringify(res.result, null, 2));
  })
  .catch(err => {
    console.warn(err)
  });

resource_instances_list = resource_controller_service.list_resource_instances(
    name=resource_instance_name
).get_result()
print('\nlist_resource_instances() response:\n',
      json.dumps(resource_instances_list, indent=2))

listResourceInstancesOptions := resourceControllerService.NewListResourceInstancesOptions()
listResourceInstancesOptions = listResourceInstancesOptions.SetName(resourceInstanceName)
resourceInstancesList, response, err := resourceControllerService.ListResourceInstances(listResourceInstancesOptions)
if err != nil {
  panic(err)
}
b, _ := json.MarshalIndent(resourceInstancesList, "", "  ")
fmt.Printf("\nListResourceInstances() response:\n%s\n", string(b))

Löschen einer Ressourcengruppe über die Konsole

Die Standardressourcengruppe, die zu Ihrem Konto hinzugefügt wird, kann nicht gelöscht werden. Mit Ausnahme der Standardressourcengruppe können Sie Ressourcengruppen löschen, sofern diese keine Ressourcen enthalten.

Führen Sie die folgenden Schritte aus, um eine Ressourcengruppe zu löschen, die keine Ressourcen enthält und bei der es sich nicht um die Standardressourcengruppe handelt:

1. Gehen Sie in der IBM Cloud-Konsole auf Verwalten > Konto > Kontoressourcen > Ressourcengruppen.
2. Klicken Sie auf das Symbol Aktionen > Löschen.

Ressourcengruppe über die Befehlszeilenschnittstelle (CLI) löschen

Führen Sie den Befehl ibmcloud resource group-delete aus, um eine Ressourcengruppe zu löschen, die keine Ressourcen enthält und bei der es sich nicht um die Standardressourcengruppe handelt. Beispiel: Ressourcengruppe example-group löschen:

ibmcloud resource group-delete example-group -f

Ressourcengruppe über die Anwendungsprogrammierschnittstelle (API) löschen

Sie können eine Ressourcengruppe programmgesteuert löschen, indem Sie die Resource Manager-API aufrufen, wie in der folgenden Beispielanforderung dargestellt. Detaillierte Informationen zur API finden Sie unter Resource Manager API.

curl -X DELETE \
  https://resource-controller.cloud.ibm.com/v2/resource_groups/09f8c1c0742c493f80baaf7835212345 \
  -H 'Authorization: Bearer <IAM_TOKEN>'
  -H 'Content-Type: application/json'

String id = '09f8c1c0742c493f80baaf7835212345';
DeleteResourceGroupOptions options = new DeleteResourceGroupOptions.Builder().id(id).build();
Response<Void> response = service.deleteResourceGroup(options).execute();
System.out.println(response):

const params = {
    id: '09f8c1c0742c493f80baaf7835212345'
};
service.deleteResourceGroup(params).then(response => {
    console.log(response)
}).catch(err => {});

delete_resource_group(self,
        id: str,
        **kwargs
    ) -> DetailedResponse

ID := "09f8c1c0742c493f80baaf7835212345"
deleteResourceGroupOptionsModel := service.NewDeleteResourceGroupOptions(ID)
detailedResponse, err := service.DeleteResourceGroup(deleteResourceGroupOptionsModel)

Ressourcengruppe mittels Terraform löschen

Bevor Sie eine Ressourcengruppe mit Hilfe von Terraform löschen können, müssen Sie folgende Schritte durchführen:

• Installieren Sie das Terraform CLI und konfigurieren Sie das IBM Cloud Provider-Plugin für Terraform. Weitere Informationen finden Sie in der Anleitung zu den ersten Schritten mit Terraform auf IBM Cloud®. Das Plug-in abstrahiert die IBM Cloud APIs, die zur Erfüllung dieses Tasks verwendet werden.
• Erstellen Sie eine Terraform-Konfigurationsdatei mit dem Namen main.tf. In dieser Datei definieren Sie die Ressourcen mit Hilfe der HashiCorp Configuration Language. Weitere Informationen finden Sie in der Terraform-Dokumentation.

Führen Sie die folgenden Schritte aus, um eine Ressourcengruppe zu löschen:

Die Ressourcengruppe kann nur gelöscht werden, wenn sie keine Ressourcen enthält.

1. Sie können die Ressourcengruppe löschen, indem Sie den folgenden Codeblock aus Ihrer Terraform-Datei main.tf entfernen. Sie müssen die E-Mail-Adresse resourceGroup mithilfe der Terraform-Datei erstellt haben.

   resource "ibm_resource_group" "resourceGroup" {
    name     = "prod"
   }
   

   Weitere Informationen finden Sie in den Argumentreferenzdetails auf der Seite "Terraform Resource Management ".

2. Nachdem Sie Ihre Konfigurationsdatei erstellt haben, initialisieren Sie die Terraform CLI. Weitere Informationen finden Sie unter Initialisierung von Arbeitsverzeichnissen.

   terraform init
   

3. Bereitstellung der Ressourcen aus der Datei " main.tf. Weitere Informationen finden Sie unter Bereitstellung der Infrastruktur mit Terraform.

   1. Führen Sie ' terraform plan aus, um einen Terraform-Ausführungsplan zu erstellen, der eine Vorschau auf die vorgeschlagenen Aktionen enthält.

      terraform plan
      

   2. Führen Sie ' terraform apply aus, um die im Plan definierten Ressourcen zu erstellen.

      terraform apply
      

Sie können eine Ressourcengruppe auch mit dem folgenden Befehl terraform destroy löschen.

terraform destroy -target RESOURCE_TYPE.NAME -target RESOURCE_TYPE2.NAME