Mit Ressourcen und Ressourcengruppen arbeiten (ibmcloud resource)

Eine Ressourcengruppe bietet Ihnen die Möglichkeit, Ihre Kontoressourcen in anpassbaren Gruppierungen zu organisieren. Mit den folgenden Befehlen der Befehlszeilenschnittstelle (CLI) von IBM Cloud® können Sie IBM Cloud-Ressourcen in einer Ressourcengruppe verwalten.

ibmcloud resource groups

Ressourcengruppen auflisten:

ibmcloud resource groups [--default]

Befehlsoptionen

--default
Standardgruppe des aktuellen Kontos abrufen.

Beispiele

Alle Ressourcengruppen unter aktuellem Zielkonto auflisten:

ibmcloud resource groups

Listet die Standardgruppe des aktuellen Zielkontos auf:

ibmcloud resource groups --default

IBM Cloud-Ressourcengruppe

Details einer Ressourcengruppe anzeigen

ibmcloud resource group NAME [--id]

Befehlsoptionen

NAME (erforderlich)
Der Name der Ressourcengruppe
--id
Nur ID anzeigen

Beispiele

Ressourcengruppe example-group anzeigen:

ibmcloud resource group example-group

Nur ID der Ressourcengruppe example-group anzeigen:

ibmcloud resource group example-group --id

ibmcloud resource group-create

Ressourcengruppe erstellen:

ibmcloud resource group-create NAME

Befehlsoptionen

NAME (erforderlich)
Der Name der Ressourcengruppe

Beispiele

Ressourcengruppe example-group erstellen:

ibmcloud resource group-create example-group

ibmcloud resource group-update

Vorhandene Ressourcengruppe aktualisieren

ibmcloud resource group-update NAME [-n, --name NEW_NAME] [-f, --force]

Befehlsoptionen

NAME (erforderlich)
Der Name der Zielressourcengruppe
-n, --name
Neuer Name der Ressourcengruppe.
-f, --force
Aktualisierung ohne Bestätigung erzwingen

Beispiele

Ressourcengruppe example-group in trial-group umbenennen:

ibmcloud resource group-update example-group -n trial-group

ibmcloud resource group-delete

Vorhandene Ressourcengruppe löschen:

ibmcloud resource group-delete NAME [-f, --force]

Befehlsoptionen

NAME (erforderlich)
Der Name der Zielressourcengruppe
-f, --force
Löschen ohne Bestätigung erzwingen

Beispiele

Ressourcengruppe example-group löschen:

ibmcloud resource group-delete example-group -f

ibmcloud resource quotas

Alle Kontingentdefinitionen auflisten:

ibmcloud resource quotas

Beispiele

Alle Kontingentdefinitionen auflisten:

ibmcloud resource quotas

ibmcloud resource quota

Details einer Kontingentdefinition anzeigen:

ibmcloud resource quota NAME

Befehlsoptionen

NAME (erforderlich)
Der Name des Kontingents

Beispiele

Details des Kontingents free anzeigen:

ibmcloud resource quota free

ibmcloud resource service-instances

Serviceinstanzen auflisten.

ibmcloud resource service-instances [--service-name SERVICE_NAME] [--location LOCATION] [--type INSTANCE_TYPE] [-g RESOURCE_GROUP | --all-resource-groups] [--long] [--limit LIMIT] [--offset OFFSET] [--output FORMAT] [-q, --quiet]

Befehlsoptionen

--service-name SERVICE_NAME
Name der Zugehörigkeit zum Dienst
--location LOCATION
Nach Position filtern
--type INSTANCE_TYPE
Instanztypen. Falls nicht angegeben, wird der Typ service_instance verwendet. Verwenden Sie all, um alle Typen von Instanzen aufzulisten.
-g RESOURCE_GROUP
Name der Ressourcengruppe
--all-resource-groups
Alle Ressourcengruppen abfragen.
--long
Weitere Felder in der Ausgabe anzeigen
--limit LIMIT
Anzahl der zurückzugebenden Ressourcen
--offset OFFSET
Anfangspositionsnummer der Ressource
--output FORMAT
Geben Sie das Ausgabeformat an. Derzeit wird nur JSON unterstützt.
-q, --quiet
Ausführliche Ausgabe unterdrücken.

Beispiele

Serviceinstanzen des Service test-service auflisten:

ibmcloud resource service-instances --service-name test-service

Nächste Seite der Dienstinstanzen mit 10 Datensätzen pro Seite auflisten.

ibmcloud resource service-instances --offset 1 --limit 10

ibmcloud resource service-instance

Details einer Serviceinstanz anzeigen:

ibmcloud resource service-instance (NAME|ID) [--location LOCATION] [--id]

Befehlsoptionen

NAME (erforderlich), gegenseitig ausschließend mit ID
Der Name der Serviceinstanz
ID (erforderlich), gegenseitig ausschließend mit NAME
ID der Serviceinstanz
--location
Nach Position filtern
--id
Anzeige der ID der Serviceinstanz

Beispiele

Details der Serviceinstanz my-service-instance anzeigen:

ibmcloud resource service-instance my-service-instance

ibmcloud resource service-instance-create

Serviceinstanz erstellen

ibmcloud resource service-instance-create NAME (SERVICE_NAME | SERVICE_ID) SERVICE_PLAN_NAME LOCATION [-d, --deployment DEPLOYMENT_NAME] [-p, --parameters @JSON_FILE | JSON_STRING ] [-g RESOURCE_GROUP] [--service-endpoints SERVICE_ENDPOINTS_TYPE] [--allow-cleanup] [--lock] [--subscription SUBSCRIPTION_ID]

Befehlsoptionen

NAME (erforderlich)
Der Name der Serviceinstanz
SERVICE_NAME oder SERVICE_ID (erforderlich)
Der Name oder die ID des Service. Verwenden Sie zur Auflistung von Serviceangeboten die Website ibmcloud catalog service-marketplacebefehl.
SERVICE_PLAN_NAME oder SERVICE_PLAN_ID (erforderlich)
Der Name oder die ID des Serviceplans
LOCATION (erforderlich)
Zielposition oder -umgebung zum Erstellen der Serviceinstanz
-d, --deployment DEPLOYMENT_NAME
Name der Bereitstellung
-p, --parameters @JSONFILE or JSON_STRING
JSON-Datei oder JSON-Zeichenfolge zum Erstellen einer Serviceinstanz.
-g RESOURCE_GROUP
Name der Ressourcengruppe
--service-endpoints SERVICE_ENDPOINTS_TYPE
Arten von Dienstendpunkten, wie sie nach der Definition des Dienstes zulässig sind. Typische Werte sind "öffentlich", "privat", "öffentlich und privat". Der Standardwert für Dienstendpunkte ist der Typ, der vom Dienst in IBM Cloud® konfiguriert wurde.
--allow-cleanup
Angabe, ob die Serviceinstanz während der Verarbeitung eines Aufrufs zum Löschen einer Regionsinstanz gelöscht (bereinigt) werden soll.
--lock
Angabe, ob die Serviceinstanz mit dem Status 'Gesperrt' erstellt werden soll
--subscription
Mit diesem Dienst und Plan verbundene Abonnement-ID

Beispiele

Erstellen Sie eine Dienstinstanz mit dem Namen my-service-instance, die den Dienstplan test-service-plan des Dienstes test-service am Standort eu-gb verwendet:

ibmcloud resource service-instance-create my-service-instance test-service test-service-plan eu-gb

ibmcloud resource service-instance-update

Serviceinstanz aktualisieren.

ibmcloud resource service-instance-update ( NAME | ID ) [-n, --name NEW_NAME] [--service-plan-id SERVICE_PLAN_ID] [-p, --parameters @JSON_FILE | JSON_STRING ] [-g RESOURCE_GROUP] [--service-endpoints SERVICE_ENDPOINTS_TYPE] [-f, --force]

Befehlsoptionen

Name (erforderlich)
Name der Serviceinstanz, gegenseitig ausschließend mit ID
ID (erforderlich)
ID der Serviceinstanz, gegenseitig ausschließend mit NAME
-n, --name NEW_NAME
Der neue Name der Serviceinstanz
--service-plan-id SERVICE_PLAN_ID
Die neue ID des Serviceplans
-p, --parameters @JSON_FILE | JSON_STRING
JSON-Datei oder JSON-Zeichenfolge zum Erstellen einer Serviceinstanz.
-g RESOURCE_GROUP
Name der Ressourcengruppe
--service-endpoints SERVICE_ENDPOINTS_TYPE
Serviceendpunkttypen. Mögliche Werte sind 'public', 'private', 'public-and-private'.
-f, --force
Aktualisierung ohne Bestätigung erzwingen

Beispiele

Serviceinstanz my-service-instance aktualisieren und ihren Namen in new-service-instance ändern:

ibmcloud resource service-instance-update my-service-instance -n new-service-instance

ibmcloud resource service-instance-delete

Serviceinstanz löschen. Wenn die Bereitstellung läuft, versucht der Befehl, den Bereitstellungsprozess abzubrechen. Einige Services unterstützen die Stornierung möglicherweise nicht.

ibmcloud resource service-instance-delete (NAME|ID) [-f, --force] [--recursive]

Befehlsoptionen

Name (erforderlich)
Name der Serviceinstanz, gegenseitig ausschließend mit ID
ID (erforderlich)
ID der Serviceinstanz, gegenseitig ausschließend mit NAME
-f, --force
Löschen ohne Bestätigung erzwingen
--recursive
Alle zugehörigen Ressourcen löschen

Beispiele

Ressourcenserviceinstanz my-service-instance löschen:

ibmcloud resource service-instance-delete my-service-instance

ibmcloud resource service-instance-lock

Serviceinstanz sperren:

ibmcloud resource service-instance-lock ( NAME | ID ) [-g RESOURCE_GROUP] [-f, --force]

Befehlsoptionen

Name (erforderlich)
Name der Serviceinstanz, gegenseitig ausschließend mit ID
ID (erforderlich)
ID der Serviceinstanz, gegenseitig ausschließend mit NAME
-g RESOURCE_GROUP
Name der Ressourcengruppe
-f, --force
Sperren ohne Bestätigung erzwingen

Beispiele

Ressourcenserviceinstanz my-service-instance sperren:

ibmcloud resource service-instance-lock my-service-instance

ibmcloud resource service-instance-unlock

Entsperren Sie die Dienstinstanz.

ibmcloud resource service-instance-unlock ( NAME | ID ) [-g RESOURCE_GROUP] [-f, --force]

Befehlsoptionen

Name (erforderlich)
Name der Serviceinstanz, gegenseitig ausschließend mit ID
ID (erforderlich)
ID der Serviceinstanz, gegenseitig ausschließend mit NAME
-g RESOURCE_GROUP
Name der Ressourcengruppe
-f, --force
Sperren ohne Bestätigung erzwingen

Beispiele

Ressourcenserviceinstanz my-service-instance entsperren:

ibmcloud resource service-instance-unlock my-service-instance

ibmcloud resource service-keys

Liste der Serviceschlüssel der Serviceinstanz.

ibmcloud resource service-keys [ --instance-id ID | --instance-name NAME ]

Befehlsoptionen

--instance-id
Die Serviceinstanz-ID
--instance-name
Der Serviceinstanzname

Beispiele

Serviceschlüssel der Serviceinstanz my-service-instance auflisten:

ibmcloud resource service-keys --instance-name my-service-instance

ibmcloud resource service-key

Die Details jeder beliebigen Anzahl an Serviceschlüsseln anzeigen, wobei die ersten n Zeichen des Serviceschlüsselnamens mit dem bereitgestellten Schlüsselnamen (KEY_NAME) übereinstimmen:

ibmcloud resource service-key (NAME | ID) [-g RESOURCE_GROUP] [--id]

Befehlsoptionen

NAME
Der Name des Schlüssels
ID
ID des Schlüssels
-g
Name der Ressourcengruppe
--id
Anzeige der ID des Dienstschlüssels. Diese Option ist gegenseitig ausschließend mit '--output'.
-g RESOURCE_GROUP
Name der Ressourcengruppe

Beispiele

Details des Serviceschlüssels my-service-key anzeigen:

ibmcloud resource service-key my-service-key

Details des Serviceschlüssels mit der ID crn:v1:bluemix:public:cloudantnosqldb:us-south:a/537860630a5ba7115be954e8d5aa5689:cc2a6d6c-8f5e-4038-b975-b09b51d1d8dc:resource-key:9057f12e-fbf5-421d-8865-764422217a79 anzeigen:

ibmcloud resource service-key crn:v1:bluemix:public:cloudantnosqldb:us-south:a/537860630a5ba7115be954e8d5aa5689:cc2a6d6c-8f5e-4038-b975-b09b51d1d8dc:resource-key:9057f12e-fbf5-421d-8865-764422217a79

ibmcloud resource service-key-create

Einen Serviceschlüssel erstellen.

ibmcloud resource service-key-create NAME [ROLE_NAME] ( --instance-id SERVICE_INSTANCE_ID | --instance-name SERVICE_INSTANCE_NAME) [--service-id SERVICE_ID] [-p, --parameters @JSON_FILE | JSON_TEXT] [-g RESOURCE_GROUP] [--service-endpoint SERVICE_ENDPOINT_TYPE] [-f, --force] [-f, --force] [-q, --quiet]

Befehlsoptionen

NAME (erforderlich)
Name des Schlüssels.
ROLE_NAME (optional)
Name der IAM-Servicerolle. Die angegebene Rolle kann keine der Standardplattformrollen sein. Sie können die Eignung jeder Rolle für die Verwendung dieser Option überprüfen, indem Sie ibmcloud iam roles --service <your-service> ausführen und prüfen, ob serviceRole in der CRN der Rolle erscheint.
--instance-id SERVICE_INSTANCE_ID
ID der Serviceinstanz.
--instance-name SERVICE_INSTANCE_NAME
Name der Serviceinstanz.
--service-id SERVICE_ID
Name oder UUID der Service-ID, zu der die Rolle gehört. Kann nur gesetzt werden, wenn ROLE_NAME weggelassen wird oder auf None gesetzt ist.
-p, --parameters @JSON_FILE | JSON_TEXT
Parameter JSON-Datei oder JSON-Zeichenfolge.
-g RESOURCE_GROUP
Name der Ressourcengruppe.
--service-endpoint SERVICE_ENDPOINT_TYPE
Serviceendpunkttyp. Mögliche Werte sind 'public' oder 'private'.
--output FORMAT (optional)
Geben Sie das Ausgabeformat an. Es wird nur JSON unterstützt.
-f, --force
Erstellung ohne Bestätigung erzwingen
-q, --quite
Ausführliche Ausgabe unterdrücken.

Beispiele

Serviceschlüssel mit dem Namen my-service-key und der Rolle Administrator für die Serviceinstanz my-service-instance erstellen:

ibmcloud resource service-key-create my-service-key Administrator --instance-name my-service-instance

Serviceschlüssel mit dem Namen my-service-key ohne Rolle für eine nicht IAM-fähige Serviceinstanz my-service-instance erstellen:

ibmcloud resource service-key-create my-service-key --instance-name my-service-instance

ibmcloud resource service-key-update

Serviceschlüssel aktualisieren:

ibmcloud resource service-key-update ( NAME | ID ) [-n, --name NEW_NAME] [-g RESOURCE_GROUP] [-f, --force]

Befehlsoptionen

NAME | ID
Der Name oder die ID des Schlüssels
-n, --name NEW_NAME
Der neue Name des Schlüssels
-g RESOURCE_GROUP
Die ID der Ressourcengruppe, zu der der Schlüssel gehört
-f, --force
Aktualisierung ohne Bestätigung erzwingen

Beispiele

Serviceschlüssel mit dem Namen my-service-key aktualisieren und den neuen Namen my-service-key-2 zuweisen:

ibmcloud resource service-key-update my-service-key -n my-service-key-2

ibmcloud resource service-key-delete

Serviceschlüssel löschen:

ibmcloud resource service-key-delete ( KEY_NAME | KEY_ID ) [-f, --force]

Befehlsoptionen

KEY_NAME | KEY_ID
Name des Schlüssels oder ID des Schlüssels
-f, --force
Löschen ohne Bestätigung erzwingen

Beispiele

Serviceschlüssel my-service-key löschen:

ibmcloud resource service-key-delete my-service-key

ibmcloud-Ressourcen-Abonnement

Details zu einem Abonnement anzeigen.

ibmcloud resource subscription SUBSCRIPTION_ID

Befehlsoptionen

SUBSCRIPTION_ID (erforderlich)
SUBSCRIPTION_ID-Feld eines Abonnements

Beispiele

Details zum Abonnement anzeigen my-subscription-id:

ibmcloud resource subscription my-subscription-id

ibmcloud-Ressourcen-Abonnements

Liste der Abonnements für Ihr Konto

ibmcloud resource subscriptions [--output FORMAT]

Befehlsoptionen

--output value
Geben Sie das Ausgabeformat an. Derzeit wird nur JSON unterstützt.

ibmcloud resource tags

Alle Tags in Ihrem Abrechnungskonto auflisten:

ibmcloud resource tags [-o, --offset OFFSET] [-l, --limit LIMIT]  [-p, --provider classic-infrastructure] [-d, --details true] [-a, --attached true] [--output FORMAT] [--tag-type TAG_TYPE] [--account-id ACCOUNT_ID]

Befehlsoptionen

--offset value, -o value
Anfangspositionsnummer der Ressource (Standardwert: 0).
--limit value, -l value
Anzahl der Ressourcen, die zurückgegeben werden sollen (maximal 1000) (Standardwert: 100).
--provider value, -p value
Zeigt Tags an, die mit den Classic Infrastructure-Ressourcen verknüpft sind. Der einzige zulässige Wert ist: classic-infrastructure. Verwenden Sie den Befehl, um die in der Classic Infrastructure definierten Tags abzurufen.
--details value, -d value
Zusätzliche Attribute für die einzelnen Tags anzeigen; einziger zulässiger Wert: 'true'.
--attached value, -a value
Nur gefilterte Tags anzeigen, die einer Ressource zugeordnet sind; der einzig zulässige Wert ist true.
--tag-type value
Typ des Tags. Die einzigen zulässigen Werte sind: user, service oder access (Standardwert: user).
--account-id value
ID des Kontos, das Eigner der Tags ist, die aufgelistet werden sollen (erforderlich, wenn für den Tagtyp der Wert 'service' angegeben wird).
--output value
Geben Sie das Ausgabeformat an. Derzeit wird nur JSON unterstützt.
-q, --quiet
Ausführliche Ausgabe unterdrücken.

ibmcloud resource tag-create

Zugriffsverwaltungstag erstellen:

ibmcloud resource tag-create --tag-names TAG_NAMES

Befehlsoptionen

--tag-names value
Durch Kommas getrennte Liste der Tagnamen.
-q, --quiet
Ausführliche Ausgabe unterdrücken.

Dieser Befehl ist nur für Zugriffsverwaltungstags gültig. Zum Beispiel:

  • Führen Sie den folgenden Befehl aus, um den Zugriffsverwaltungstag project:myproject zu erstellen:
    ibmcloud resource tag-create —tag-names “project:myproject”
    

ibmcloud resource tag-attach

Mindestens einen Tag einer Ressource zuordnen:

ibmcloud resource tag-attach --tag-names TAG_NAMES (--resource-name NAME | --resource-id RESOURCE_ID | --resources-query RESOURCES_QUERY) [--resource-type RESOURCE_TYPE] [--tag-type TAG_TYPE] [--account-id ACCOUNT_ID] [--replace] [--update]

Befehlsoptionen

--tag-names value
Durch Kommas getrennte Liste der Tagnamen.
--resources-query wert
Abfrage-String für die globale Suche, um die Ressourcen abzurufen, an die die Tags angehängt werden sollen
--resource-name value
Der Name der Ressource, an der die Tags angebracht werden müssen.
--resource-id value
Der Cloudressourcenname (CRN) der Ressource, der die Tags zugeordnet werden sollen (bei Ressourcen der klassischen Infrastruktur ist dies die ID der Ressource).
--resource-type value
Ressourcentyp, auf den Tags angewendet werden müssen. Dies ist nur für Classic Infrastructure-Ressourcen der folgenden Typen erforderlich: SoftLayer_Hardware_Server, SoftLayer_Hardware, SoftLayer_Virtual_Guest, SoftLayer_Network_Vlan_Firewall, SoftLayer_Network_Application_Delivery_Controller, SoftLayer_Network_Vlan, SoftLayer_Virtual_DedicatedHost, SoftLayer_Network_Component_Firewall, und SoftLayer_Network_Firewall_Module_Context.
--tag-type value
Typ des Tags. Einzige zulässige Werte: user oder service. Der Standardwert ist user.
--account-id value
ID des Kontos, das Eigner der Ressourcen ist, denen Tags zugeordnet werden sollen (erforderlich, wenn für den Tagtyp der Wert 'service' angegeben wird).
--replace
Die Liste der Tag-Namen ersetzt die aktuelle Liste der Tag-Namen, die der Ressource zugeordnet sind.
--update
Die Tagnamen im Format key:value werden aktualisiert. Die Option hat keine Auswirkung auf Tagnamen, die dieses Format nicht aufweisen.
-q, --quiet
Ausführliche Ausgabe unterdrücken.

Beispiele

  • Um das Benutzertag my-tag einem Cluster Kubernetes mit dem Namen MyCluster zuzuordnen, identifizieren Sie zunächst die CRN des Clusters:

    ibmcloud resource search 'type:k8\-cluster AND name:MyCluster'
    

    Notieren Sie die CRN, bei der es sich um eine Zeichenfolge ähnlich diesem Beispiel handelt:

    crn:v1:bluemix:public:containers-kubernetes:us-south:a/a27a4741a57dcf5c965939adb66fe1c7:a46242e638ca47b09f10e9a3cbe5687a::
    

    Führen Sie den folgenden Befehl aus, um den Tag zuzuordnen:

    ibmcloud resource tag-attach --tag-names my-tag --resource-id rn:v1:bluemix:public:containers-kubernetes:us-south:a/a27a4741a57dcf5c965939adb66fe1c7:a46242e638ca47b09f10e9a3cbe5687a::
    
  • So fügen Sie my-tag user tag einer Ressource namens MyResource zu:

    ibmcloud resource tag-attach --tag-name my-tag --resource-name  'MyResource'
    
  • Führen Sie den folgenden Befehl aus, um die Benutzer-Tags my-tag-1 und my-tag-2 an alle Kubernetes-Cluster anzuhängen, die in us-south bereitgestellt werden:

    ibmcloud resource tag-attach --tag-names my-tag-1,my-tag-2 --resources-query 'service_name:containers-kubernetes AND region:us-south'
    

    Der Befehl ruft zunächst alle Kubernetes clusters in us-south ab, die Sie anzeigen können, und fügt anschließend die beiden angegebenen Tags an jeden einzelnen an. Anschließend wird das Ergebnis des Vorgangs für jeden Kubernetes-Cluster angezeigt.

  • Um my-tag einem virtuellen Gast der klassischen Infrastruktur mit dem Namen MyVM zuzuordnen, identifizieren Sie die ID des virtuellen Gastes:

    ibmcloud resource search 'fullyQualifiedDomainName:MyVM  _objectType:SoftLayer_Virtual_Guest' -p classic-infrastructure
    

    Notieren Sie die ID, bei der es sich um eine Zeichenfolge ähnlich 48373549 handelt.

    Führen Sie den folgenden Befehl aus, um den Tag zuzuordnen:

    ibmcloud resource tag-attach --tag-names my-tag --resource-id 48373549 --resource-type SoftLayer_Virtual_Guest
    
  • Führen Sie den folgenden Befehl aus, um den zuvor erstellten Zugriffsverwaltungstag project:myproject einer IBM Cloud Object Storage-Instanz mit dem Namen Project data zuzuordnen:

    ibmcloud resource tag-attach --tag-names "project:myproject" --resource-name Project data -—tag-type access
    
  • Führen Sie den folgenden Befehl aus, um den Wert des Benutzertags env für eine Ressource namens MyResource auf production zu aktualisieren:

    ibmcloud resource tag-attach --tag-names 'env:production' --resource-name 'MyResource' --update
    
  • Führen Sie den folgenden Befehl aus, um den Wert des Zugriffsmanagementtags env für eine Ressource mit dem Namen MyResource auf production zu aktualisieren:

    ibmcloud resource tag-attach --tag-names 'env:production' --resource-name 'MyResource' --update --tag-type access
    
  • Führen Sie den folgenden Befehl aus, um alle Benutzertags von MyResource durch eine neue Gruppe von Tags tag1, tag2 und tag3 zu ersetzen:

    ibmcloud resource tag-attach --tag-names 'tag1,tag2,tag3' --resource-name 'MyResource' --replace
    
  • Führen Sie den folgenden Befehl aus, um alle Zugriffsmanagementtags von MyResource durch den Tag compliance:hipaa zu ersetzen:

    ibmcloud resource tag-attach --tag-names 'compliance:hipaa' --resource-name 'MyResource' --replace --tag-type access
    

ibmcloud resource tag-detach

Für mindestens einen Tag die Zuordnung zu einer Ressource aufheben:

ibmcloud resource tag-detach --tag-names TAG_NAMES (--resource-name NAME | --resource-id RESOURCE_ID | --resources-query RESOURCES_QUERY) [--resource-type RESOURCE_TYPE] [--tag-type TAG_TYPE] [--account-id ACCOUNT_ID]

Befehlsoptionen

--tag-names value
Durch Kommas getrennte Liste der Tagnamen.
--resources-query wert
Abfrage-String für die globale Suche, um die Ressourcen abzurufen, an denen die Tags abgetrennt werden sollen
--resource-name value
Der Name der Ressource, an der die Tags angebracht werden sollen.
--resource-id value
Der Cloudressourcenname (CRN) der Ressource, der die Tags zugeordnet werden sollen (bei Ressourcen der klassischen Infrastruktur ist dies die ID der Ressource).
--resource-type value
Ressourcentyp, bei dem die Tags entfernt werden müssen. Dies ist nur für Classic Infrastructure-Ressourcen der folgenden Typen erforderlich: SoftLayer_Hardware_Server, SoftLayer_Hardware, SoftLayer_Virtual_Guest, SoftLayer_Network_Vlan_Firewall, SoftLayer_Network_Application_Delivery_Controller, SoftLayer_Network_Vlan, SoftLayer_Virtual_DedicatedHost, SoftLayer_Network_Component_Firewall, und SoftLayer_Network_Firewall_Module_Context.
--tag-type value
Typ des Tags. Die einzigen zulässigen Werte sind: user, service oder access (Standardwert: user).
--account-id value
ID des Kontos, das Eigner der Ressourcen ist, für die die Zuordnung aufgehoben werden soll (erforderlich, wenn für den Tagtyp der Wert 'service' angegeben wird).
-q, --quiet
Ausführliche Ausgabe unterdrücken.

Beispiele

  • Um das Benutzertag my-tag von einem Cluster Kubernetes mit dem Namen MyCluster zu trennen, identifizieren Sie zunächst die CRN des Clusters:

    ibmcloud resource search 'type:k8\-cluster AND name:MyCluster'
    

    Notieren Sie die CRN, bei der es sich um eine Zeichenfolge ähnlich diesem Beispiel handelt:

    crn:v1:bluemix:public:containers-kubernetes:us-south:a/a27a4741a57dcf5c965939adb66fe1c7:a46242e638ca47b09f10e9a3cbe5687a::
    

    Führen Sie den folgenden Befehl aus, um die Zuordnung des Tags aufzuheben:

    ibmcloud resource tag-detach --tag-names my-tag --resource-id crn:v1:bluemix:public:containers-kubernetes:us-south:a/a27a4741a57dcf5c965939adb66fe1c7:a46242e638ca47b09f10e9a3cbe5687a::
    
  • So lösen Sie das Benutzer-Tag my-tag von einer Ressource namens MyResource:

    ibmcloud resource tag-detach --tag-name my-tag --resource-name 'MyResource'
    
  • Führen Sie den folgenden Befehl aus, um die Benutzer-Tags my-tag-1 und my-tag-2 von allen Kubernetes-Clustern zu trennen, die in us-south bereitgestellt werden:

    ibmcloud resource tag-detach --tag-names my-tag-1,my-tag-2 --resources-query 'service_name:containers-kubernetes AND region:us-south'
    

    Der Befehl ruft zunächst alle Kubernetes-Cluster in us-south ab, die Sie anzeigen können, und trennt anschließend die beiden angegebenen Tags von jedem ab. Anschließend wird das Ergebnis des Vorgangs für jeden Kubernetes-Cluster angezeigt.

  • Um das Benutzer-Tag my-tag von einem virtuellen Gast mit klassischer Infrastruktur namens MyVM zu entfernen, suchen Sie zunächst nach der ID des virtuellen Gastes, von dem Sie das Tag entfernen möchten:

    ibmcloud resource search 'fullyQualifiedDomainName:MyVM  _objectType:SoftLayer_Virtual_Guest' -p classic-infrastructure
    

    Notieren Sie die ID, bei der es sich um eine Zeichenfolge ähnlich 48373549 handelt.

    Führen Sie den folgenden Befehl aus, um die Zuordnung des Tags aufzuheben:

    ibmcloud resource tag-detach --tag-names my-tag --resource-id 48373549 --resource-type SoftLayer_Virtual_Guest
    
  • Führen Sie den folgenden Befehl aus, um die Zuordnung des Zugriffsverwaltungstags project:myproject zu einer IBM Cloud Object Storage-Instanz mit dem Namen Project data aufzuheben:

    ibmcloud resource tag-detach --tag-names "project:myproject" --resource-name Project data -—tag-type access
    
  • Führen Sie den folgenden Befehl aus, um den Tag env:value unabhängig von seinem Wert von MyResource abzuhängen:

    ibmcloud resource tag-detach --tag-names 'env:*' —resource-name 'MyResource'
    
  • Führen Sie den folgenden Befehl aus, um alle Tags von MyResource abzuhängen:

    ibmcloud resource tag-detach --tag-names '*' —resource-name 'MyResource'
    

ibmcloud resource tag-delete

Tag löschen:

ibmcloud resource tag-delete (--tag-name TAG_NAME | -a, --all  [-f, --force]) [-p, --provider PROVIDER] [--tag-type TAG_TYPE] [--account-id ACCOUNT_ID]

Befehlsoptionen

--tag-name value
Name des zu löschenden Tags.
--provider value, -p value
Löscht die Tags, die mit dem angegebenen Anbieter verbunden sind. Der einzige zulässige Wert ist: classic-infrastructure. Verwenden Sie den Befehl, um die Classic Infrastructure-Tags zu löschen.
--tag-type value
Typ des Tags. Die einzigen zulässigen Werte sind: user, service oder access (Standardwert: user).
account-id value
ID des Kontos, das Eigner der Tags ist, die gelöscht werden sollen (erforderlich, wenn für den Tagtyp der Wert 'service' angegeben wird).
--force, -f
Tags ohne Bestätigung löschen.
--all, -a
Löschen Sie alle Tags, die nicht mit Ressourcen verbunden sind.
-q, --quiet
Ausführliche Ausgabe unterdrücken.

Es können nur Tags gelöscht werden, die keiner Ressource zugeordnet sind.

Beispiele

  • So löschen Sie den Benutzer-Tag my-tag aus dem Konto:
    ibmcloud resource tag-delete --tag-name "my-tag"
    
  • Führen Sie den folgenden Befehl aus, um den Zugriffsverwaltungstag project:myproject aus dem Konto zu löschen:
    ibmcloud resource tag-delete --tag-name "project:myproject" --tag-type access
    
  • Führen Sie den folgenden Befehl aus, um alle nicht verwendeten Benutzertags aus dem Konto zu löschen:
    ibmcloud resource tag-delete -a
    
  • Führen Sie den folgenden Befehl aus, um alle nicht verwendeten Zugriffsverwaltungstags aus dem Konto zu löschen:
    ibmcloud resource tag-delete -a --tag-type access
    

ibmcloud resource reclamations

Zurückgeforderte Ressourcen auflisten, die wiederhergestellt oder gelöscht werden können:

ibmcloud resource reclamations [--resource-instance-id INSTANCE_ID]

Befehlsoptionen

--resource-instance-id
Die global eindeutige ID (GUID) der Ressourceninstanz.

Beispiele

Alle Ressourcenrückforderungen auflisten:

ibmcloud resource reclamations

Ressourcenrückforderungen einer bestimmten Serviceinstanz auflisten:

ibmcloud resource reclamations --resource-instance-id abcd1234-ef56-486e-b293-22d6c7eb6699

ibmcloud resource reclamation

Details einer Ressourcenrückforderung anzeigen:

ibmcloud resource reclamation RECLAMATION_ID

Befehlsoptionen

RECLAMATION_ID
ID der Ressourcenrückforderung.

Beispiele

Details einer Ressourcenrückforderung anzeigen:

ibmcloud resource reclamation daf12d343ef

ibmcloud resource reclamation-restore

Wie lange eine gelöschte Ressource wiederhergestellt werden kann, hängt von dem jeweiligen Dienst ab. Prüfen Sie die dienstspezifische Dokumentation, um festzustellen, ob der Dienst die Reklamation unterstützt, und wenn ja, wie lange die Reklamation dauert.

Zurückgeforderte Ressource wiederherstellen, um sie wieder verfügbar zu machen:

ibmcloud resource reclamation-restore ID [--comment COMMENT]

Befehlsoptionen

ID
ID der Ressourcenrückforderung.
--comment
Kommentare zu der Aktion.

Beispiele

Ressourcenrückforderung mit der ID d9fendfwlw wiederherstellen:

ibmcloud resource reclamation-restore "d9fendfwlw"

Eine Ressourcenrückforderung mit der ID d9fendfwlw wiederherstellen, einen Kommentar von need to use for another 3 months hinterlassen und die JSON-Ausgabe anzeigen:

ibmcloud resource reclamation-restore "d9fendfwlw" --comment "need to use for another 3 months" --output JSON

ibmcloud resource reclamation-delete

Zurückgeforderte Ressource löschen, damit sie nicht wiederhergestellt werden kann:

ibmcloud resource reclamation-delete ID [--comment COMMENT] [--f, --force]

Befehlsoptionen

ID
ID der Ressourcenrückforderung.
--comment
Kommentare zu der Aktion.
-f, --force
Löschen ohne Bestätigung erzwingen

Beispiele

Ressourcenrückforderung mit der ID d9fendfwlw löschen:

ibmcloud resource reclamation-delete "d9fendfwlw"

Eine Ressourcenrückforderung mit der ID d9fendfwlw löschen und einen Kommentar von no longer needed ohne Bestätigung hinterlassen:

ibmcloud resource reclamation-delete "d9fendfwlw" --comment "no longer needed" -f