Utilisation de ressources et de groupes de ressources (ibmcloud resource)
Un groupe de ressources permet d'organiser vos ressources de compte en regroupements personnalisables. Les commandes suivantes de l'interface de ligne de commande IBM Cloud® permettent de gérer les ressources IBM Cloud d'un groupe de ressources.
ibmcloud resource groups
Répertorier les groupes de ressources.
ibmcloud resource groups [--default]
Options de commande
- --default
- Obtenir le groupe par défaut du compte en cours.
Exemples
Répertorier tous les groupes de ressources du compte actuellement ciblé :
ibmcloud resource groups
Liste le groupe par défaut du compte actuellement ciblé :
ibmcloud resource groups --default
ibmcloud resource group
Afficher les détails d'un groupe de ressources
ibmcloud resource group NAME [--id]
Options de commande
- NAME (obligatoire)
- Nom du groupe de ressources
- --id
- Afficher l'ID uniquement
Exemples
Afficher le groupe de ressources example-group :
ibmcloud resource group example-group
Afficher uniquement le groupe de ressources example-group :
ibmcloud resource group example-group --id
ibmcloud resource group-create
Créer un groupe de ressources :
ibmcloud resource group-create NAME
Options de commande
- NAME (obligatoire)
- Nom du groupe de ressources
Exemples
Créer un groupe de ressources example-group :
ibmcloud resource group-create example-group
ibmcloud resource group-update
Mettre à jour un groupe de ressources existant
ibmcloud resource group-update NAME [-n, --name NEW_NAME] [-f, --force]
Options de commande
- NAME (obligatoire)
- Nom du groupe de ressources cible
- -n, --name
- Nouveau nom du groupe de ressources
- -f, --force
- Forcer la mise à jour sans confirmation
Exemples
Renommer le groupe de ressources example-group en trial-group :
ibmcloud resource group-update example-group -n trial-group
ibmcloud resource group-delete
Supprimer un groupe de ressources existant
ibmcloud resource group-delete NAME [-f, --force]
Options de commande
- NAME (obligatoire)
- Nom du groupe de ressources cible
- -f, --force
- Forcer la suppression sans confirmation
Exemples
Supprimer le groupe de ressources example-group :
ibmcloud resource group-delete example-group -f
ibmcloud resource quotas
Répertorier toutes les définitions de quota
ibmcloud resource quotas
Exemples
Répertorier toutes les définitions de quota :
ibmcloud resource quotas
ibmcloud resource quota
Afficher les détails d'une définition de quota.
ibmcloud resource quota NAME
Options de commande
- NAME (obligatoire)
- Nom du quota
Exemples
Afficher les détails du quota free :
ibmcloud resource quota free
ibmcloud resource service-instances
Répertorier les instances de service.
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]
Options de commande
- --service-name SERVICE_NAME
- Nom d'appartenance au service
- --location LOCATION
- Filtrer par localisation
- --type INSTANCE_TYPE
- Type des instances. Le type
service_instanceest utilisé s'il n'est pas spécifié. Utilisez tout pour répertorier tous les types d'instance. - -g RESOURCE_GROUP
- Nom du groupe de ressources
- --all-resource-groups
- Interroger tous les groupes de ressources
- --long
- Afficher plus de champs dans le résultat
- --limit LIMITE
- Nombre de ressources à restituer
- --offset OFFSET
- Numéro de position de ressource de début
- --output FORMAT
- Spécifier le format des sorties. Seul JSON est pris en charge maintenant.
- -q, --quiet
- Supprimer la sortie prolixe.
Exemples
Répertorier les instances de service du service test-service :
ibmcloud resource service-instances --service-name test-service
Liste de la page suivante des instances de service avec 10 enregistrements par page.
ibmcloud resource service-instances --offset 1 --limit 10
ibmcloud resource service-instance
Afficher les détails d'une instance de service.
ibmcloud resource service-instance (NAME|ID) [--location LOCATION] [--id]
Options de commande
- NAME (obligatoire), exclut ID
- Nom de l'instance de service
- ID (obligatoire), exclut NAME
- ID de l'instance de service
- --location
- Filtrer par localisation
- --id
- Afficher l'ID de l'instance de service
Exemples
Afficher les détails de l'instance de service my-service-instance :
ibmcloud resource service-instance my-service-instance
ibmcloud resource service-instance-create
Créez une instance de service.
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]
Options de commande
- NAME (obligatoire)
- Nom de l'instance de service
- SERVICE_NAME ou SERVICE_ID (obligatoire)
- Nom ou ID du service. Pour dresser la liste des services offerts, utilisez le site
ibmcloud catalog service-marketplacecommande. - SERVICE_PLAN_NAME ou SERVICE_PLAN_ID (obligatoire)
- Nom ou ID du plan de service
- LOCATION (obligatoire)
- Environnement ou emplacement cible pour créer l'instance de service
- -d, --deployment DEPLOYMENT_NAME
- Nom du déploiement
- -p, --parameters @JSONFILE or JSON_STRING
- Fichier JSON ou chaînes de paramètres JSON pour la création de l'instance de service
- -g RESOURCE_GROUP
- Nom du groupe de ressources
- --service-endpoints SERVICE_ENDPOINTS_TYPE
- Types de points d'extrémité de service autorisés par la définition du service. Les valeurs typiques sont "public", "privé", "public et privé". La valeur par défaut pour les points de terminaison des services est le type configuré par le service dans IBM Cloud®
- --allow-cleanup
- Indique si l'instance de service doit être supprimée (nettoyée) lors du traitement d'un appel de suppression d'une instance de région
- --lock
- Définit si l'instance de service est créée avec l'état verrouillé
- --subscription
- ID d'abonnement associé à ce service et à ce plan
Exemples
Créez une instance de service nommée my-service-instance qui utilise le plan de service test-service-plan du service test-service sur l'emplacement eu-gb:
ibmcloud resource service-instance-create my-service-instance test-service test-service-plan eu-gb
ibmcloud resource service-instance-update
Mettre à jour l'instance de service.
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]
Options de commande
- Nom (obligatoire)
- Nom de l'instance de service, exclut ID
- ID (obligatoire)
- ID de l'instance de service, exclut NAME
- -n, --name NEW_NAME
- Nouveau nom de l'instance de service
- --service-plan-id SERVICE_PLAN_ID
- Nouvel ID du plan de service
- -p, --parameters @JSON_FILE | JSON_STRING
- Fichier JSON ou chaînes de paramètres JSON pour la création de l'instance de service
- -g RESOURCE_GROUP
- Nom du groupe de ressources
- --service-endpoints SERVICE_ENDPOINTS_TYPE
- Types des noeuds finaux de service. Les valeurs possibles sont 'public', 'private', 'public-and-private'.
- -f, --force
- Forcer la mise à jour sans confirmation
Exemples
Mettre à jour l'instance de service my-service-instance et remplacer son nom par new-service-instance :
ibmcloud resource service-instance-update my-service-instance -n new-service-instance
ibmcloud resource service-instance-delete
Supprimer l'instance de service. Si la mise à disposition est en cours, la commande tente d'annuler le processus de mise à disposition. Certains services peuvent ne pas prendre en charge l'annulation.
ibmcloud resource service-instance-delete (NAME|ID) [-f, --force] [--recursive]
Options de commande
- Nom (obligatoire)
- Nom de l'instance de service, exclut ID
- ID (obligatoire)
- ID de l'instance de service, exclut NAME
- -f, --force
- Forcer la suppression sans confirmation
- --recursive
- Supprimer toutes les ressources membres
Exemples
Supprimer l'instance de service de ressource my-service-instance :
ibmcloud resource service-instance-delete my-service-instance
ibmcloud resource service-instance-lock
Verrouiller l'instance de service.
ibmcloud resource service-instance-lock ( NAME | ID ) [-g RESOURCE_GROUP] [-f, --force]
Options de commande
- Nom (obligatoire)
- Nom de l'instance de service, exclut ID
- ID (obligatoire)
- ID de l'instance de service, exclut NAME
- -g RESOURCE_GROUP
- Nom du groupe de ressources
- -f, --force
- Forcer le verrouillage sans confirmation
Exemples
Verrouiller l'instance de service de ressource my-service-instance :
ibmcloud resource service-instance-lock my-service-instance
ibmcloud resource service-instance-unlock
Déverrouiller l'instance de service.
ibmcloud resource service-instance-unlock ( NAME | ID ) [-g RESOURCE_GROUP] [-f, --force]
Options de commande
- Nom (obligatoire)
- Nom de l'instance de service, exclut ID
- ID (obligatoire)
- ID de l'instance de service, exclut NAME
- -g RESOURCE_GROUP
- Nom du groupe de ressources
- -f, --force
- Forcer le verrouillage sans confirmation
Exemples
Déverrouiller l'instance de service de ressource my-service-instance :
ibmcloud resource service-instance-unlock my-service-instance
ibmcloud resource service-keys
Liste des clés de service de l'instance de service.
ibmcloud resource service-keys [ --instance-id ID | --instance-name NAME ]
Options de commande
- --instance-id
- ID de l'instance de service
- --instance-name
- Nom de l'instance de service
Exemples
Répertorier les clés de service de l'instance de service my-service-instance :
ibmcloud resource service-keys --instance-name my-service-instance
ibmcloud resource service-key
Affiche des informations détaillées sur les clés de service, où les premiers caractères n du nom de clé de service correspondent à l'élément KEY_NAME indiqué.
ibmcloud resource service-key (NAME | ID) [-g RESOURCE_GROUP] [--id]
Options de commande
- NOM
- Nom de la clé
- ID
- ID de la clé
- -g
- Nom du groupe de ressources
- --id
- Affiche l'ID de la clé de service. Cette option exclut '--output'.
- -g RESOURCE_GROUP
- Nom du groupe de ressources
Exemples
Afficher les détails des clés de service my-service-key :
ibmcloud resource service-key my-service-key
Afficher les détails de la clé de service portant l'ID 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 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
Créer une clé de service.
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]
Options de commande
- NAME (obligatoire)
- Nom de la clé.
- ROLE_NAME (facultatif)
- Nom du rôle de service IAM. Le rôle spécifié ne peut pas être l'un des rôles de plateforme par défaut. Vous pouvez vérifier l'admissibilité d'un rôle à l'utilisation de cette option en exécutant
ibmcloud iam roles --service <your-service>et en vérifiant queserviceRoleapparaît dans le CRN du rôle. - --instance-id SERVICE_INSTANCE_ID
- ID de l'instance de service.
- --instance-name SERVICE_INSTANCE_NAME
- Nom de l'instance de service.
- --service-id SERVICE_ID
- Nom ou identificateur unique universel de l'ID de service auquel le rôle appartient. Ne peut être défini que lorsque
ROLE_NAMEest omis ou a pour valeurNone. - -p, --parameters @JSON_FILE | JSON_TEXT
- Fichier JSON ou chaîne JSON de paramètres.
- -g RESOURCE_GROUP
- Nom du groupe de ressources.
- --service-endpoint SERVICE_ENDPOINT_TYPE
- Type de noeud final de service. Les valeurs possibles sont 'public' ou 'private'.
- --output FORMAT (facultatif)
- Spécifier le format des sorties. Seul JSON est pris en charge.
- -f, --force
- Forcer la création sans confirmation
- -q, --quite
- Supprimer la sortie prolixe.
Exemples
Créer une clé de service nommée my-service-key avec le rôle Administrator pour l'instance de service my-service-instance :
ibmcloud resource service-key-create my-service-key Administrator --instance-name my-service-instance
Créer une clé de service nommée my-service-key sans aucun rôle pour une instance de service non activée par iam my-service-instance :
ibmcloud resource service-key-create my-service-key --instance-name my-service-instance
ibmcloud resource service-key-update
Mettre à jour une clé de service.
ibmcloud resource service-key-update ( NAME | ID ) [-n, --name NEW_NAME] [-g RESOURCE_GROUP] [-f, --force]
Options de commande
- NAME | ID
- Nom ou ID de la clé
- -n, --name NEW_NAME
- Nouveau nom de la clé
- -g RESOURCE_GROUP
- ID du groupe de ressources auquel la clé appartient
- -f, --force
- Forcer la mise à jour sans confirmation
Exemples
Mettre à jour une clé de service nommée my-service-key et lui attribuer le nouveau nom my-service-key-2 :
ibmcloud resource service-key-update my-service-key -n my-service-key-2
ibmcloud resource service-key-delete
Supprimer une clé de service.
ibmcloud resource service-key-delete ( KEY_NAME | KEY_ID ) [-f, --force]
Options de commande
- KEY_NAME | KEY_ID
- Nom de la clé ou de l'ID de la clé
- -f, --force
- Forcer la suppression sans confirmation
Exemples
Supprimer la clé de service my-service-key :
ibmcloud resource service-key-delete my-service-key
ibmcloud resource search
Rechercher des ressources à l'aide de la syntaxe de requête Lucene.
ibmcloud resource search LUCENE_QUERY [-o, --offset OFFSET] [-l, --limit LIMIT] [-s, --sort-by (name, family, region, type, crn)] [-p, --provider PROVIDER] [-ir, --is-reclaimed (false, true, any)] [--output FORMAT]
Options de commande
- -ir, --is-reclaimed
- Recherchez les ressources de compte qui ont été récupérées. Cependant, par défaut, la recherche ne renvoie que les ressources actives. Vous pouvez donner à is-reclaimed la valeur "any" pour rechercher des ressources, qu'elles soient
récupérées ou non. Définissez cette option sur
truepour appliquer les critères de recherche uniquement aux ressources récupérées. Définissez cette option surfalsepour rechercher uniquement les ressources actives.falseest le comportement par défaut. - -o, -offset
- Numéro de position de ressource de début
- -l, -limit
- Nombre de ressources à renvoyer (10000 au maximum).
- -s, --sort-by
- Propriété à utiliser pour le tri. Les valeurs acceptées sont les suivantes :
name,family,region,type,crn. - -p, --provider
- Afficher les ressources d'infrastructure classique. La seule valeur prise en charge est
classic-infrastructure.
Attributs à rechercher
Vous pouvez rechercher de nombreux attributs afin d'élargir votre recherche. Voici quelques exemples :
- nom
- Nom défini par l'utilisateur de la ressource.
- région
- Emplacement géographique où la ressource est mise à disposition. Par exemple : us-south, us-east, au-syd, eu-gb, eu-de et jp-tok.
- service_name
- Nom du service, tel qu'il apparaît dans la colonne de nom de la sortie de l'élément 'ibmcloud catalog service-marketplace'.
- creation_date
- Date de création de la ressource.
- modification_date
- Date de dernière modification de la ressource.
Pour obtenir la liste complète des attributs que vous pouvez rechercher, voir Recherche de ressources.
Exemples
Recherche des ressources du contrôleur de ressources dans l'emplacement spécifié (c'est-à-dire dans la région us-south):
ibmcloud resource search "region:us-south AND family:resource_controller"
Rechercher les groupes de ressources portant le nom default :
ibmcloud resource search "name:default AND type:resource-group"
Rechercher une ressource portant le nom de ressource de cloud indiqué :
ibmcloud resource search "crn:\"crn:v1:bluemix:public:cloudantnosqldb:us-south:s/4948af7e-cc78-4321-998a-e549dd5e9210:41a031cd-e9e5-4c46-975d-9e4a6391322e:cf-service-instance:\""
Rechercher une ressource avec l'étiquette indiqué :
ibmcloud resource search "tags:\"mykey:myvalue\""
Rechercher la ressource d'invité virtuel d'infrastructure classique avec l'ID spécifié (uniquement avec -p classic-infrastructure) :
ibmcloud resource search "id:12345678 _objectType:SoftLayer_Virtual_Guest"
Rechercher la ressource de matériel d'infrastructure classique avec le nom d'étiquette indiqué (uniquement avec -p classic-infrastructure) :
ibmcloud resource search "tagReferences.tag.name:name _objectType:SoftLayer_Hardware"
abonnement aux ressources ibmcloud
Afficher les détails d'un abonnement.
ibmcloud resource subscription SUBSCRIPTION_ID
Options de commande
- SUBSCRIPTION_ID (obligatoire)
- Champ SUBSCRIPTION_ID d'un abonnement
Exemples
Afficher les détails de l'abonnement my-subscription-id:
ibmcloud resource subscription my-subscription-id
abonnements aux ressources ibmcloud
Liste des abonnements pour votre compte
ibmcloud resource subscriptions [--output FORMAT]
Options de commande
- --output value
- Spécifier le format des sorties. Seul JSON est pris en charge maintenant.
ibmcloud resource tag-create
Créer une étiquette de gestion des accès :
ibmcloud resource tag-create --tag-names TAG_NAMES
Options de commande
- --tag-names value
- Liste de noms d'étiquettes séparés par des virgules.
- -q, --quiet
- Supprimer la sortie prolixe.
Cette commande n'est valide que pour les étiquettes de gestion des accès. Exemple :
- Exécutez la commande suivante pour créer l'étiquette de gestion des accès
project:myproject:ibmcloud resource tag-create —tag-names “project:myproject”
ibmcloud resource tag-attach
Associer une ou plusieurs étiquettes à une ressource :
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]
Options de commande
- --tag-names value
- Liste de noms d'étiquettes séparés par des virgules.
- --resources-query valeur
- Chaîne de requête de recherche globale pour récupérer les ressources sur lesquelles les balises doivent être attachées
- --resource-name value
- Le nom de la ressource sur laquelle les étiquettes doivent être attachées.
- --resource-id value
- Nom CRN de la ressource à laquelle les étiquettes doivent être associées (pour la ressource d'infrastructure classique, il s'agit de l'ID de la ressource).
- --resource-type value
- Type de ressource auquel les balises doivent être appliquées. Cela n'est nécessaire que pour les ressources de l'infrastructure classique des types suivants : 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, et SoftLayer_Network_Firewall_Module_Context.
- --tag-type value
- Type d'étiquette. Les seules valeurs admises sont
userouservice. La valeur par défaut estuser. - --account-id value
- ID du compte propriétaire des ressources à étiqueter (requis si le type d'étiquette est défini sur service).
- --replace
- La liste des noms de balises remplace la liste actuelle des noms de balises attachés à la ressource.
- --update
- Les noms de balise au format
key:valueseront mis à jour. L'option n'a aucun effet sur les noms de balise qui ne sont pas dans ce format. - -q, --quiet
- Supprimer la sortie prolixe.
Exemples
-
Pour attacher le tag utilisateur
my-tagà un cluster Kubernetes nomméMyCluster, identifiez d'abord le CRN du cluster :ibmcloud resource search 'type:k8\-cluster AND name:MyCluster'Notez le nom CRN, qui est une chaîne similaire à l'exemple suivant :
crn:v1:bluemix:public:containers-kubernetes:us-south:a/a27a4741a57dcf5c965939adb66fe1c7:a46242e638ca47b09f10e9a3cbe5687a::Pour associer l'étiquette, exécutez la commande suivante :
ibmcloud resource tag-attach --tag-names my-tag --resource-id rn:v1:bluemix:public:containers-kubernetes:us-south:a/a27a4741a57dcf5c965939adb66fe1c7:a46242e638ca47b09f10e9a3cbe5687a:: -
Pour attacher l'étiquette utilisateur
my-tagà une ressource nomméeMyResource:ibmcloud resource tag-attach --tag-name my-tag --resource-name 'MyResource' -
Pour attacher les tags utilisateurs
my-tag-1etmy-tag-2à tous les clusters Kubernetes déployés dansus-south, exécutez la commande suivante :ibmcloud resource tag-attach --tag-names my-tag-1,my-tag-2 --resources-query 'service_name:containers-kubernetes AND region:us-south'La commande récupère d'abord tous les clusters Kubernetes dans us-south que vous pouvez visualiser, et attache ensuite les deux balises spécifiées à chacun d'entre eux. Il affiche ensuite le résultat de l'opération pour chaque grappe Kubernetes.
-
Pour attacher le tag utilisateur
my-tagà un invité virtuel d'infrastructure classique nomméMyVM, identifiez l'ID de l'invité virtuel :ibmcloud resource search 'fullyQualifiedDomainName:MyVM _objectType:SoftLayer_Virtual_Guest' -p classic-infrastructureNotez l'ID, qui est une chaîne similaire à
48373549.Pour associer l'étiquette, exécutez la commande suivante :
ibmcloud resource tag-attach --tag-names my-tag --resource-id 48373549 --resource-type SoftLayer_Virtual_Guest -
Pour associer l'étiquette de gestion des accès
project:myprojectprécédemment créée à une instance d'IBM Cloud Object Storage nomméeProject data, exécutez la commande suivante :ibmcloud resource tag-attach --tag-names "project:myproject" --resource-name Project data -—tag-type access -
Pour mettre à jour
productionla valeur de la balise utilisateurenvsur une ressource nomméeMyResource, exécutez la commande suivante:ibmcloud resource tag-attach --tag-names 'env:production' --resource-name 'MyResource' --update -
Pour mettre à jour
productionla valeur de la balise de gestion des accèsenvsur une ressource nomméeMyResource, exécutez la commande suivante:ibmcloud resource tag-attach --tag-names 'env:production' --resource-name 'MyResource' --update --tag-type access -
Pour remplacer toutes les balises utilisateur de
MyResourcepar un nouvel ensemble de balisestag1,tag2ettag3, exécutez la commande suivante:ibmcloud resource tag-attach --tag-names 'tag1,tag2,tag3' --resource-name 'MyResource' --replace -
Pour remplacer toutes les balises de gestion des accès de
MyResourcepar la balisecompliance:hipaa, exécutez la commande suivante:ibmcloud resource tag-attach --tag-names 'compliance:hipaa' --resource-name 'MyResource' --replace --tag-type access
ibmcloud resource tag-detach
Dissociation d'une ou de plusieurs étiquettes d'une ressource :
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]
Options de commande
- --tag-names value
- Liste de noms d'étiquettes séparés par des virgules.
- --resources-query valeur
- Chaîne de requête de recherche globale pour récupérer les ressources sur lesquelles les balises doivent être détachées
- --resource-name value
- Le nom de la ressource sur laquelle les balises doivent être attachées.
- --resource-id value
- Nom CRN de la ressource à laquelle les étiquettes doivent être associées (pour la ressource d'infrastructure classique, il s'agit de l'ID de la ressource).
- --resource-type value
- Type de ressource sur laquelle les balises doivent être retirées. Cela n'est nécessaire que pour les ressources de l'infrastructure classique des types suivants : 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, et SoftLayer_Network_Firewall_Module_Context.
- --tag-type value
- Type d'étiquette. Les seules valeurs autorisées sont : user, service ou access (valeur par défaut : user).
- --account-id value
- ID du compte propriétaire des ressources à dissocier (requis si le type d'étiquette est défini sur service).
- -q, --quiet
- Supprimer la sortie prolixe.
Exemples
-
Pour détacher le tag utilisateur
my-tagd'un cluster Kubernetes nomméMyCluster, il faut d'abord identifier le CRN du cluster :ibmcloud resource search 'type:k8\-cluster AND name:MyCluster'Notez le nom CRN, qui est une chaîne similaire à l'exemple suivant :
crn:v1:bluemix:public:containers-kubernetes:us-south:a/a27a4741a57dcf5c965939adb66fe1c7:a46242e638ca47b09f10e9a3cbe5687a::Pour dissocier l'étiquette, exécutez la commande suivante :
ibmcloud resource tag-detach --tag-names my-tag --resource-id crn:v1:bluemix:public:containers-kubernetes:us-south:a/a27a4741a57dcf5c965939adb66fe1c7:a46242e638ca47b09f10e9a3cbe5687a:: -
Pour détacher le tag utilisateur
my-tagd'une ressource nomméeMyResource:ibmcloud resource tag-detach --tag-name my-tag --resource-name 'MyResource' -
Pour détacher les balises utilisateur
my-tag-1etmy-tag-2de tous les clusters Kubernetes déployés dansus-south, exécutez la commande suivante :ibmcloud resource tag-detach --tag-names my-tag-1,my-tag-2 --resources-query 'service_name:containers-kubernetes AND region:us-south'La commande récupère d'abord tous les clusters Kubernetes dans us-south que vous pouvez visualiser, puis détache les deux balises spécifiées de chacun d'entre eux. Il affiche ensuite le résultat de l'opération pour chaque grappe Kubernetes.
-
Pour détacher le tag utilisateur
my-tagd'un invité virtuel d'infrastructure classique nomméMyVM, recherchez d'abord l'ID de l'invité virtuel dont vous souhaitez détacher le tag :ibmcloud resource search 'fullyQualifiedDomainName:MyVM _objectType:SoftLayer_Virtual_Guest' -p classic-infrastructureNotez l'ID, qui est une chaîne similaire à
48373549.Pour dissocier l'étiquette, exécutez la commande suivante :
ibmcloud resource tag-detach --tag-names my-tag --resource-id 48373549 --resource-type SoftLayer_Virtual_Guest -
Pour dissocier l'étiquette de gestion des accès
project:myprojectd'une instance d'IBM Cloud Object Storage nomméeProject data, exécutez la commande suivante :ibmcloud resource tag-detach --tag-names "project:myproject" --resource-name Project data -—tag-type access -
Pour dissocier la balise
env:valuedeMyResource, quelle que soit sa valeur, exécutez la commande suivante:ibmcloud resource tag-detach --tag-names 'env:*' —resource-name 'MyResource' -
Pour dissocier toutes les étiquettes de
MyResource, exécutez la commande suivante:ibmcloud resource tag-detach --tag-names '*' —resource-name 'MyResource'
ibmcloud resource tag-delete
Supprimer une étiquette :
ibmcloud resource tag-delete (--tag-name TAG_NAME | -a, --all [-f, --force]) [-p, --provider PROVIDER] [--tag-type TAG_TYPE] [--account-id ACCOUNT_ID]
Options de commande
- --tag-name value
- Nom d'étiquette à supprimer.
- --provider value, -p value
- Supprime les balises associées au fournisseur spécifié. La seule valeur autorisée est : classic-infrastructure. Utilisez la commande pour supprimer les balises de l'infrastructure classique.
- --tag-type value
- Type d'étiquette. Les seules valeurs autorisées sont : user, service ou access (valeur par défaut : user).
- account-id value
- ID du compte propriétaire des étiquettes à supprimer (requis si le type d'étiquette est défini sur service).
- --force, -f
- Supprimer les étiquettes sans confirmation.
- --all, -a
- Supprimer toutes les étiquettes qui ne sont rattachées à aucune ressource.
- -q, --quiet
- Supprimer la sortie prolixe.
Une étiquette ne peut être supprimée que si elle n'est associée à aucune ressource.
Exemples
- Pour supprimer le tag utilisateur
my-tagdu compte :ibmcloud resource tag-delete --tag-name "my-tag" - Pour supprimer l'étiquette de gestion des accès
project:myprojectdu compte :ibmcloud resource tag-delete --tag-name "project:myproject" --tag-type access - Pour supprimer toutes les étiquettes utilisateur non utilisées du compte :
ibmcloud resource tag-delete -a - Pour supprimer toutes les étiquettes de gestion des accès non utilisées du compte :
ibmcloud resource tag-delete -a --tag-type access
ibmcloud resource reclamations
Répertorier les ressources récupérées qui peuvent être restaurées ou supprimées :
ibmcloud resource reclamations [--resource-instance-id INSTANCE_ID]
Options de commande
- --resource-instance-id
- Identificateur global unique de l'instance de ressource
Exemples
Répertorier toutes les récupérations de ressource :
ibmcloud resource reclamations
Répertorier les réclamations de ressource d'une instance de service spécifique :
ibmcloud resource reclamations --resource-instance-id abcd1234-ef56-486e-b293-22d6c7eb6699
ibmcloud resource reclamation
Afficher les détails d'une réclamation de ressource :
ibmcloud resource reclamation RECLAMATION_ID
Options de commande
- RECLAMATION_ID
- ID de réclamation de ressource
Exemples
Afficher les détails d'une réclamation de ressource :
ibmcloud resource reclamation daf12d343ef
ibmcloud resource reclamation-restore
Le délai de récupération d'une ressource supprimée dépend du service concerné. Vérifier la documentation spécifique au service pour déterminer si le service prend en charge la réclamation et, le cas échéant, la période de réclamation.
Restaurer une ressource récupérée pour qu'elle soit de nouveau disponible :
ibmcloud resource reclamation-restore ID [--comment COMMENT]
Options de commande
- ID
- ID de la récupération de ressource
- --comment
- Commentaires au sujet de l'action
Exemples
Restaurer une récupération de ressource portant l'ID d9fendfwlw :
ibmcloud resource reclamation-restore "d9fendfwlw"
Restaurez une récupération de ressource avec l'ID d9fendfwlw, laissez un commentaire de need to use for another 3 monthset afficher la sortie JSON :
ibmcloud resource reclamation-restore "d9fendfwlw" --comment "need to use for another 3 months" --output JSON
ibmcloud resource reclamation-delete
Supprimer une ressource récupérée pour qu'elle ne puisse plus être restaurée :
ibmcloud resource reclamation-delete ID [--comment COMMENT] [--f, --force]
Options de commande
- ID
- ID de la récupération de ressource
- --comment
- Commentaires au sujet de l'action
- -f, --force
- Forcer la suppression sans confirmation
Exemples
Supprimer une récupération de ressource portant l'ID d9fendfwlw :
ibmcloud resource reclamation-delete "d9fendfwlw"
Supprimez une récupération de ressource avec l'ID d9fendfwlw et laissez un commentaire de no longer needed sans confirmation :
ibmcloud resource reclamation-delete "d9fendfwlw" --comment "no longer needed" -f