Cómo trabajar con recursos y grupos de recursos (ibmcloud resource)
Un grupo de recursos es una manera de organizar sus recursos de cuenta en agrupaciones personalizables. Utilice los siguientes mandatos de la interfaz de línea de mandatos de IBM Cloud® para gestionar los recursos de IBM Cloud en un grupo de recursos.
ibmcloud resource groups
Listar grupos de recursos.
ibmcloud resource groups [--default]
Opciones de comando
- --default
- Obtener el grupo predeterminado de la cuenta actual.
Ejemplos
Listar todos los grupos de recursos de la cuenta de destino actual:
ibmcloud resource groups
Lista el grupo por defecto de la cuenta actualmente seleccionada:
ibmcloud resource groups --default
ibmcloud resource group
Mostrar detalles de un grupo de recursos
ibmcloud resource group NAME [--id]
Opciones de comando
- NAME (necesario)
- Nombre del grupo de recursos
- --id
- Mostrar solo ID
Ejemplos
Mostrar grupo de recursos example-group:
ibmcloud resource group example-group
Mostrar solo el ID del grupo de recursos example-group:
ibmcloud resource group example-group --id
ibmcloud resource group-create
Crear un grupo de recursos:
ibmcloud resource group-create NAME
Opciones de comando
- NAME (necesario)
- Nombre del grupo de recursos
Ejemplos
Crear un grupo de recursos example-group:
ibmcloud resource group-create example-group
ibmcloud resource group-update
Actualizar un grupo de recursos existente
ibmcloud resource group-update NAME [-n, --name NEW_NAME] [-f, --force]
Opciones de comando
- NAME (necesario)
- Nombre del grupo de recursos de destino
- -n, --name
- Nuevo nombre de grupo de recursos
- -f, --force
- Forzar actualización sin confirmación
Ejemplos
Cambie el nombre del grupo de recursos example-group a trial-group:
ibmcloud resource group-update example-group -n trial-group
ibmcloud resource group-delete
Suprimir un grupo de recursos existente
ibmcloud resource group-delete NAME [-f, --force]
Opciones de comando
- NAME (necesario)
- Nombre del grupo de recursos de destino
- -f, --force
- Forzar la supresión sin confirmación
Ejemplos
Suprimir grupo de recursos example-group:
ibmcloud resource group-delete example-group -f
ibmcloud resource quotas
Listar todas las definiciones de cuota.
ibmcloud resource quotas
Ejemplos
Listar todas las definiciones de cuota:
ibmcloud resource quotas
ibmcloud resource quota
Mostrar detalles de una definición de cuota.
ibmcloud resource quota NAME
Opciones de comando
- NAME (necesario)
- Nombre de la cuota
Ejemplos
Mostrar detalles de cuota free:
ibmcloud resource quota free
ibmcloud resource service-instances
Listar instancias de servicio.
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]
Opciones de comando
- --service-name SERVICE_NAME
- Nombre de pertenencia al servicio
- --location LOCATION
- Filtrar por ubicación
- --type INSTANCE_TYPE
- Tipo de instancias. El tipo
service_instancese utiliza si no se especifica. Utilícelo todo para listar todos los tipos de instancias. - -g RESOURCE_GROUP
- Nombre del grupo de recursos
- --all-resource-groups
- Consultar todos los grupos de recursos
- --long
- Mostrar más campos en la salida
- --limit LÍMITE
- Número de recursos a devolver
- --offset OFFSET
- Número de posición del recurso inicial
- --output FORMAT
- Especifique el formato de salida. Ahora sólo se admite JSON.
- -q, --quiet
- Suprimir la salida detallada.
Ejemplos
Listar las instancias de servicio del servicio test-service:
ibmcloud resource service-instances --service-name test-service
Lista la siguiente página de instancias de servicio con 10 registros por página.
ibmcloud resource service-instances --offset 1 --limit 10
ibmcloud resource service-instance
Mostrar los detalles de una instancia de servicio.
ibmcloud resource service-instance (NAME|ID) [--location LOCATION] [--id]
Opciones de comando
- NAME (necesario), exclusivo con ID
- Nombre de la instancia de servicio
- ID (necesario), exclusivo con NAME
- ID de la instancia de servicio
- --location
- Filtrar por ubicación
- --id
- Mostrar el ID de la instancia de servicio
Ejemplos
Mostrar detalles de la instancia de servicio my-service-instance:
ibmcloud resource service-instance my-service-instance
ibmcloud resource service-instance-create
Crear una instancia de servicio.
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]
Opciones de comando
- NAME (necesario)
- Nombre de la instancia de servicio
- SERVICE_NAME o SERVICE_ID (necesario)
- Nombre o ID del servicio. Para listar las ofertas de servicios, utilice la dirección
ibmcloud catalog service-marketplacecomando. - SERVICE_PLAN_NAME o SERVICE_PLAN_ID (necesario)
- Nombre o ID del plan de servicio
- LOCATION (obligatorio)
- Ubicación o entorno de destino para crear la instancia de servicio
- -d, --deployment DEPLOYMENT_NAME
- Nombre del despliegue
- -p, --parameters @JSONFILE o JSON_STRING
- Archivo JSON o serie JSON de parámetros para crear instancia de servicio
- -g RESOURCE_GROUP
- Nombre del grupo de recursos
- --service-endpoints SERVICE_ENDPOINTS_TYPE
- Tipos de extremos de servicio permitidos por la definición del servicio. Los valores típicos son "público", "privado", "público y privado". El valor por defecto para los endpoints de servicio es el tipo configurado por el servicio en IBM Cloud®.
- --allow-cleanup
- Si la instancia de servicio se debe suprimir (limpiar) durante el proceso de una llamada de supresión de instancia de la región
- --lock
- Indica si debe crear la instancia de servicio con estado bloqueado
- --subscription
- ID de suscripción asociado a este servicio y plan
Ejemplos
Cree una instancia de servicio denominada my-service-instance que utilice el plan de servicio test-service-plan del servicio test-service en la ubicación eu-gb:
ibmcloud resource service-instance-create my-service-instance test-service test-service-plan eu-gb
ibmcloud resource service-instance-update
Actualizar instancia de servicio.
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]
Opciones de comando
- Nombre (obligatorio)
- Nombre de la instancia de servicio, exclusivo con ID
- ID (necesario)
- ID de la instancia de servicio, exclusivo con NAME
- -n, --name NEW_NAME
- Nuevo nombre de instancia de servicio
- --service-plan-id SERVICE_PLAN_ID
- Nuevo ID de plan de servicio
- -p, --parameters @JSON_FILE | JSON_STRING
- Archivo JSON o serie JSON de parámetros para crear instancia de servicio
- -g RESOURCE_GROUP
- Nombre del grupo de recursos
- --service-endpoints SERVICE_ENDPOINTS_TYPE
- Tipos de puntos finales de servicio. Los valores posibles son 'public', 'private', 'public-and-private'.
- -f, --force
- Forzar actualización sin confirmación
Ejemplos
Actualizar la instancia de servicio my-service-instance, cambiar su nombre a new-service-instance:
ibmcloud resource service-instance-update my-service-instance -n new-service-instance
ibmcloud resource service-instance-delete
Suprima la instancia de servicio. Si el suministro está en curso, el mandato intenta cancelar el proceso de suministro. Es posible que algunos servicios no soporten la cancelación.
ibmcloud resource service-instance-delete (NAME|ID) [-f, --force] [--recursive]
Opciones de comando
- Nombre (obligatorio)
- Nombre de la instancia de servicio, exclusivo con ID
- ID (necesario)
- ID de la instancia de servicio, exclusivo con NAME
- -f, --force
- Forzar la supresión sin confirmación
- --recursive
- Suprimir todos los recursos de pertenencia
Ejemplos
Suprimir instancia de servicio de recurso my-service-instance:
ibmcloud resource service-instance-delete my-service-instance
ibmcloud resource service-instance-lock
Bloquear instancia de servicio.
ibmcloud resource service-instance-lock ( NAME | ID ) [-g RESOURCE_GROUP] [-f, --force]
Opciones de comando
- Nombre (obligatorio)
- Nombre de la instancia de servicio, exclusivo con ID
- ID (necesario)
- ID de la instancia de servicio, exclusivo con NAME
- -g RESOURCE_GROUP
- Nombre del grupo de recursos
- -f, --force
- Forzar el bloqueo sin confirmación
Ejemplos
Bloquear instancia de servicio de recurso my-service-instance:
ibmcloud resource service-instance-lock my-service-instance
ibmcloud resource service-instance-unlock
Desbloquea la instancia de servicio.
ibmcloud resource service-instance-unlock ( NAME | ID ) [-g RESOURCE_GROUP] [-f, --force]
Opciones de comando
- Nombre (obligatorio)
- Nombre de la instancia de servicio, exclusivo con ID
- ID (necesario)
- ID de la instancia de servicio, exclusivo con NAME
- -g RESOURCE_GROUP
- Nombre del grupo de recursos
- -f, --force
- Forzar el bloqueo sin confirmación
Ejemplos
Desbloquear instancia de servicio de recurso my-service-instance:
ibmcloud resource service-instance-unlock my-service-instance
ibmcloud resource service-keys
Lista las claves de servicio de la instancia de servicio.
ibmcloud resource service-keys [ --instance-id ID | --instance-name NAME ]
Opciones de comando
- --instance-id
- ID de instancia de servicio
- --instance-name
- Nombre de instancia de servicio
Ejemplos
Listar claves de servicio de la instancia de servicio my-service-instance:
ibmcloud resource service-keys --instance-name my-service-instance
ibmcloud resource service-key
Muestra los detalles de las claves de servicio, donde los n primeros caracteres del nombre de la clave de servicio coinciden con el valor proporcionado de KEY_NAME.
ibmcloud resource service-key (NAME | ID) [-g RESOURCE_GROUP] [--id]
Opciones de comando
- NOMBRE
- Nombre de la clave
- ID
- ID de la clave
- -g
- Nombre del grupo de recursos
- --id
- Muestra el ID de la clave de servicio. Esta opción y '--output' son mutuamente excluyentes.
- -g RESOURCE_GROUP
- Nombre del grupo de recursos
Ejemplos
Mostrar detalles de la clave de servicio my-service-key:
ibmcloud resource service-key my-service-key
Mostrar detalles de la clave de servicio con el 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
Crear una clave de servicio.
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]
Opciones de comando
- NAME (necesario)
- Nombre de la clave.
- ROLE_NAME (opcional)
- Nombre del rol de servicio de IAM. El rol especificado no puede ser uno de los roles de plataforma predeterminados. Puede verificar la elegibilidad de cualquier rol para su uso con esta opción ejecutando
ibmcloud iam roles --service <your-service>y comprobando queserviceRoleaparece en el CRN del rol. - --instance-id SERVICE_INSTANCE_ID
- ID de la instancia de servicio.
- --instance-name SERVICE_INSTANCE_NAME
- Nombre de la instancia de servicio.
- --service-id SERVICE_ID
- Nombre o UUID del ID de servicio al que pertenece el rol. Sólo puede establecerse cuando
ROLE_NAMEse omite o se establece enNone. - -p, --parameters @JSON_FILE | JSON_TEXT
- Parámetros del archivo JSON o de la serie JSON.
- -g RESOURCE_GROUP
- Nombre de grupo de recursos.
- --service-endpoint SERVICE_ENDPOINT_TYPE
- Tipo de punto final de servicio. Los valores posibles son 'public' o 'private'.
- --output FORMAT (opcional)
- Especifique el formato de salida. Solo se admite JSON.
- -f, --force
- Forzar la creación sin confirmación
- -q, --quite
- Suprimir la salida detallada.
Ejemplos
Crear una clave de servicio llamada my-service-key con el rol Administrator para la instancia de servicio my-service-instance:
ibmcloud resource service-key-create my-service-key Administrator --instance-name my-service-instance
Crear una clave de servicio llamada my-service-key sin ningún rol para una instancia de servicio no habilitada para iam my-service-instance:
ibmcloud resource service-key-create my-service-key --instance-name my-service-instance
ibmcloud resource service-key-update
Actualizar una clave de servicio.
ibmcloud resource service-key-update ( NAME | ID ) [-n, --name NEW_NAME] [-g RESOURCE_GROUP] [-f, --force]
Opciones de comando
- NAME | ID
- Nombre o ID de la clave
- -n, --name NEW_NAME
- Nuevo nombre de la clave
- -g RESOURCE_GROUP
- ID del grupo de recursos al que pertenece la clave
- -f, --force
- Forzar actualización sin confirmación
Ejemplos
Actualizar una clave de servicio llamada my-service-key y asignarle el nuevo nombre my-service-key-2:
ibmcloud resource service-key-update my-service-key -n my-service-key-2
ibmcloud resource service-key-delete
Suprimir una clave de servicio.
ibmcloud resource service-key-delete ( KEY_NAME | KEY_ID ) [-f, --force]
Opciones de comando
- KEY_NAME | KEY_ID
- Nombre de la clave o el ID de la clave
- -f, --force
- Forzar la supresión sin confirmación
Ejemplos
Suprimir la clave de servicio my-service-key:
ibmcloud resource service-key-delete my-service-key
ibmcloud resource search
Buscar recursos utilizando la sintaxis de consultas de 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]
Opciones de comando
- -ir, --is-reclaimed
- Buscar recursos de cuenta que se han reclamado. Sin embargo, por defecto la búsqueda sólo devuelve recursos activos. Puede establecer is-reclaimed a any para buscar recursos tanto si están reclamados como si no. Establezca esta opción en
truepara aplicar los criterios de búsqueda sólo a los recursos reclamados. Establezca esta opción enfalsepara buscar sólo los recursos activos.falsees el comportamiento predeterminado. - -o, -offset
- Número de posición del recurso inicial
- -l, -limit
- Número de recursos a devolver, hasta un máximo de 10.000.
- -s, --sort-by
- Propiedad por la que ordenar. Los valores aceptados son
name,family,region,type,crn. - -p, --provider
- Mostrar recursos de infraestructura clásica. El único valor permitido es
classic-infrastructure.
Atributos que se pueden buscar
Puede buscar por muchos atributos para delimitar su búsqueda. Estos son algunos ejemplos:
- nombre
- El nombre del recurso definido por el usuario.
- región
- La ubicación geográfica en la que se suministra el recurso. Por ejemplo: us-south, us-east, au-syd, eu-gb, eu-de y jp-tok.
- service_name
- El nombre del servicio, tal como aparece en la columna Nombre de la salida de 'ibmcloud catalog service-marketplace'.
- creation_date
- La fecha en que se ha creado el recurso.
- modification_date
- La fecha de la última modificación del recurso.
Para ver la lista completa de atributos que puede buscar, consulte Búsqueda de recursos.
Ejemplos
Buscar recursos del controlador de recursos en la ubicación especificada (es decir, en la región us-south):
ibmcloud resource search "region:us-south AND family:resource_controller"
Buscar grupos de recursos con el nombre default:
ibmcloud resource search "name:default AND type:resource-group"
Buscar un recurso con el nombre de Recurso de Nube (CRN) especificado:
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:\""
Buscar un recurso con la etiqueta especificada:
ibmcloud resource search "tags:\"mykey:myvalue\""
Buscar el recurso de invitado virtual de infraestructura clásica con el ID especificado (solo con -p classic-infrastructure):
ibmcloud resource search "id:12345678 _objectType:SoftLayer_Virtual_Guest"
Buscar el recurso de hardware de infraestructura clásica con el nombre de etiqueta especificado (solo con -p classic-infrastructure):
ibmcloud resource search "tagReferences.tag.name:name _objectType:SoftLayer_Hardware"
suscripción a recursos ibmcloud
Mostrar detalles de una suscripción.
ibmcloud resource subscription SUBSCRIPTION_ID
Opciones de comando
- SUBSCRIPTION_ID (obligatorio)
- Campo SUBSCRIPTION_ID de una suscripción
Ejemplos
Mostrar detalles de la suscripción my-subscription-id:
ibmcloud resource subscription my-subscription-id
suscripciones a recursos ibmcloud
Lista de suscripciones de su cuenta
ibmcloud resource subscriptions [--output FORMAT]
Opciones de comando
- --output value
- Especifique el formato de salida. Ahora sólo se admite JSON.
ibmcloud resource tag-create
Crear una etiqueta de gestión de acceso:
ibmcloud resource tag-create --tag-names TAG_NAMES
Opciones de comando
- --tag-names value
- Lista separada por comas de nombres de etiqueta.
- -q, --quiet
- Suprimir la salida detallada.
Este mandato solo es válido para etiquetas de gestión de acceso. Por ejemplo:
- Ejecute el mandato siguiente para crear el código de gestión de acceso
project:myproject:ibmcloud resource tag-create —tag-names “project:myproject”
ibmcloud resource tag-attach
Adjuntar una o más etiquetas a un recurso:
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]
Opciones de comando
- --tag-names value
- Lista separada por comas de nombres de etiqueta.
- --resources-query valor
- Cadena de consulta de búsqueda global para recuperar los recursos en los que deben adjuntarse las etiquetas
- --resource-name value
- El nombre del recurso al que deben adjuntarse las etiquetas.
- --resource-id value
- CRN del recurso al que se deben adjuntar las etiquetas (para un recurso de la infraestructura clásica, es el ID del recurso).
- --resource-type value
- Tipo de recurso al que deben aplicarse las etiquetas. Esto sólo es necesario para los recursos de Infraestructura Clásica de los siguientes tipos: 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, y SoftLayer_Network_Firewall_Module_Context.
- --tag-type value
- El tipo de etiqueta. Los únicos valores permitidos son
useroservice. El valor predeterminado esuser. - --account-id value
- El ID de la cuenta que posee los recursos que se van a etiquetar (obligatorio si el tipo de etiqueta está establecido en service).
- --replace
- La lista de nombres de etiquetas sustituye a la lista actual de nombres de etiquetas que se adjuntan al recurso.
- --update
- Los nombres de etiqueta con el formato
key:valuese actualizarán. La opción no tiene ningún efecto en los nombres de etiqueta que no están en ese formato. - -q, --quiet
- Suprimir la salida detallada.
Ejemplos
-
Para adjuntar la etiqueta de usuario
my-taga un clúster Kubernetes denominadoMyCluster, identifique primero el CRN del clúster:ibmcloud resource search 'type:k8\-cluster AND name:MyCluster'Tome nota del CRN, que es una serie similar a la del ejemplo siguiente:
crn:v1:bluemix:public:containers-kubernetes:us-south:a/a27a4741a57dcf5c965939adb66fe1c7:a46242e638ca47b09f10e9a3cbe5687a::Para adjuntar la etiqueta, ejecute el mandato siguiente:
ibmcloud resource tag-attach --tag-names my-tag --resource-id rn:v1:bluemix:public:containers-kubernetes:us-south:a/a27a4741a57dcf5c965939adb66fe1c7:a46242e638ca47b09f10e9a3cbe5687a:: -
Para adjuntar la etiqueta de usuario
my-taga un recurso denominadoMyResource:ibmcloud resource tag-attach --tag-name my-tag --resource-name 'MyResource' -
Para adjuntar las etiquetas de usuario
my-tag-1ymy-tag-2a todos los clusters Kubernetes desplegados enus-south, ejecute el siguiente comando :ibmcloud resource tag-attach --tag-names my-tag-1,my-tag-2 --resources-query 'service_name:containers-kubernetes AND region:us-south'El comando recupera inicialmente todos los clusters Kubernetes en us-south que se pueden ver, y posteriormente adjunta las dos etiquetas especificadas a cada uno. A continuación, muestra el resultado de la operación para cada grupo Kubernetes.
-
Para adjuntar la etiqueta de usuario
my-taga un invitado virtual de infraestructura clásica llamadoMyVM, identifique el ID del invitado virtual:ibmcloud resource search 'fullyQualifiedDomainName:MyVM _objectType:SoftLayer_Virtual_Guest' -p classic-infrastructureTome nota del ID, que es una serie similar a
48373549.Para adjuntar la etiqueta, ejecute el mandato siguiente:
ibmcloud resource tag-attach --tag-names my-tag --resource-id 48373549 --resource-type SoftLayer_Virtual_Guest -
Para adjuntar la etiqueta de gestión de acceso
project:myproject, que ha creado anteriormente, a una instancia de IBM Cloud Object Storage denominadaProject data, ejecute el mandato siguiente:ibmcloud resource tag-attach --tag-names "project:myproject" --resource-name Project data -—tag-type access -
Para actualizar a
productionel valor de la etiqueta de usuarioenven un recurso denominadoMyResource, ejecute el mandato siguiente:ibmcloud resource tag-attach --tag-names 'env:production' --resource-name 'MyResource' --update -
Para actualizar a
productionel valor de la etiqueta de gestión de accesoenven un recurso denominadoMyResource, ejecute el mandato siguiente:ibmcloud resource tag-attach --tag-names 'env:production' --resource-name 'MyResource' --update --tag-type access -
Para sustituir todas las etiquetas de usuario de
MyResourcepor un nuevo conjunto de etiquetastag1,tag2ytag3, ejecute el mandato siguiente:ibmcloud resource tag-attach --tag-names 'tag1,tag2,tag3' --resource-name 'MyResource' --replace -
Para sustituir todos los códigos de gestión de acceso de
MyResourcepor el códigocompliance:hipaa, ejecute el mandato siguiente:ibmcloud resource tag-attach --tag-names 'compliance:hipaa' --resource-name 'MyResource' --replace --tag-type access
ibmcloud resource tag-detach
Desvincular una o más etiquetas de un recurso:
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]
Opciones de comando
- --tag-names value
- Lista separada por comas de nombres de etiqueta.
- --resources-query valor
- Cadena de consulta de búsqueda global para recuperar los recursos en los que deben separarse las etiquetas
- --resource-name value
- El nombre del recurso al que deben adjuntarse las etiquetas.
- --resource-id value
- CRN del recurso al que se deben adjuntar las etiquetas (para un recurso de la infraestructura clásica, es el ID del recurso).
- --resource-type value
- Tipo de recurso en el que deben eliminarse las etiquetas. Esto sólo es necesario para los recursos de Infraestructura Clásica de los siguientes tipos: 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, y SoftLayer_Network_Firewall_Module_Context.
- --tag-type value
- Tipo de etiqueta. Los únicos valores permitidos son: usuario, servicio o acceso (valor por defecto: usuario).
- --account-id value
- El ID de la cuenta que posee los recursos que se van a desconectar (obligatorio si el tipo de etiqueta está establecido en service).
- -q, --quiet
- Suprimir la salida detallada.
Ejemplos
-
Para separar la etiqueta de usuario
my-tagde un clúster Kubernetes denominadoMyCluster, identifique primero el CRN del clúster:ibmcloud resource search 'type:k8\-cluster AND name:MyCluster'Tome nota del CRN, que es una serie similar a la del ejemplo siguiente:
crn:v1:bluemix:public:containers-kubernetes:us-south:a/a27a4741a57dcf5c965939adb66fe1c7:a46242e638ca47b09f10e9a3cbe5687a::Para desconectar la etiqueta, ejecute el mandato siguiente:
ibmcloud resource tag-detach --tag-names my-tag --resource-id crn:v1:bluemix:public:containers-kubernetes:us-south:a/a27a4741a57dcf5c965939adb66fe1c7:a46242e638ca47b09f10e9a3cbe5687a:: -
Para desvincular la etiqueta de usuario
my-tagde un recurso denominadoMyResource:ibmcloud resource tag-detach --tag-name my-tag --resource-name 'MyResource' -
Para separar las etiquetas de usuario
my-tag-1ymy-tag-2de todos los clusters Kubernetes desplegados enus-south, ejecute el siguiente comando :ibmcloud resource tag-detach --tag-names my-tag-1,my-tag-2 --resources-query 'service_name:containers-kubernetes AND region:us-south'El comando recupera inicialmente todos los clusters Kubernetes en us-south que se pueden ver, y posteriormente separa las dos etiquetas especificadas de cada uno. A continuación, muestra el resultado de la operación para cada grupo Kubernetes.
-
Para separar la etiqueta de usuario
my-tagde un invitado virtual de infraestructura clásica llamadoMyVM, primero busque el ID del invitado virtual del que desea separar la etiqueta:ibmcloud resource search 'fullyQualifiedDomainName:MyVM _objectType:SoftLayer_Virtual_Guest' -p classic-infrastructureTome nota del ID, que es una serie similar a
48373549.Para desconectar la etiqueta, ejecute el mandato siguiente:
ibmcloud resource tag-detach --tag-names my-tag --resource-id 48373549 --resource-type SoftLayer_Virtual_Guest -
Para desconectar la etiqueta de gestión de acceso
project:myprojectde una instancia de IBM Cloud Object Storage denominadaProject data, ejecute el mandato siguiente:ibmcloud resource tag-detach --tag-names "project:myproject" --resource-name Project data -—tag-type access -
Para desconectar el código
env:valuedeMyResource, independientemente de su valor, ejecute el mandato siguiente:ibmcloud resource tag-detach --tag-names 'env:*' —resource-name 'MyResource' -
Para desconectar todas las etiquetas de
MyResource, ejecute el mandato siguiente:ibmcloud resource tag-detach --tag-names '*' —resource-name 'MyResource'
ibmcloud resource tag-delete
Suprimir una etiqueta:
ibmcloud resource tag-delete (--tag-name TAG_NAME | -a, --all [-f, --force]) [-p, --provider PROVIDER] [--tag-type TAG_TYPE] [--account-id ACCOUNT_ID]
Opciones de comando
- --tag-name value
- Nombre de la etiqueta que se va a suprimir.
- --provider value, -p value
- Elimina las etiquetas asociadas al proveedor especificado. El único valor permitido es: infraestructura-clásica. Utilice este comando para eliminar las etiquetas de Infraestructura clásica.
- --tag-type value
- Tipo de etiqueta. Los únicos valores permitidos son: usuario, servicio o acceso (valor por defecto: usuario).
- account-id value
- El ID de la cuenta que posee las etiquetas que se van a suprimir (obligatorio si el tipo de etiqueta está establecido en service).
- --force, -f
- Suprimir todas las etiquetas sin confirmación.
- --all, -a
- Elimina todas las etiquetas que no estén asociadas a ningún recurso.
- -q, --quiet
- Suprimir la salida detallada.
Solo se puede suprimir una etiqueta si no se ha adjuntado a ningún recurso.
Ejemplos
- Para eliminar la etiqueta de usuario
my-tagde la cuenta:ibmcloud resource tag-delete --tag-name "my-tag" - Para suprimir la etiqueta de gestión de acceso
project:myprojectde la cuenta:ibmcloud resource tag-delete --tag-name "project:myproject" --tag-type access - Para suprimir todas las etiquetas de usuario no utilizadas de la cuenta:
ibmcloud resource tag-delete -a - Para suprimir todas las etiquetas de gestión de acceso no utilizadas de la cuenta:
ibmcloud resource tag-delete -a --tag-type access
ibmcloud resource reclamations
Listar los recursos reclamados que se pueden restaurar o suprimir:
ibmcloud resource reclamations [--resource-instance-id INSTANCE_ID]
Opciones de comando
- --resource-instance-id
- El ID exclusivo global (GUID) de la instancia de recurso
Ejemplos
Listar todas las reclamaciones de recursos:
ibmcloud resource reclamations
Listar las reclamaciones de recursos de una instancia de servicio determinada:
ibmcloud resource reclamations --resource-instance-id abcd1234-ef56-486e-b293-22d6c7eb6699
ibmcloud resource reclamation
Mostrar detalles de una reclamación de recurso:
ibmcloud resource reclamation RECLAMATION_ID
Opciones de comando
- RECLAMATION_ID
- ID de reclamación de recurso
Ejemplos
Mostrar detalles de una reclamación de recurso:
ibmcloud resource reclamation daf12d343ef
ibmcloud resource reclamation-restore
El tiempo que se puede recuperar un recurso eliminado depende del servicio de que se trate. Consulte la documentación específica del servicio para determinar si admite la reclamación y, en caso afirmativo, el periodo de reclamación.
Restaurar un recurso reclamado para que el recurso vuelva a estar disponible:
ibmcloud resource reclamation-restore ID [--comment COMMENT]
Opciones de comando
- ID
- ID de la reclamación de recurso
- --comment
- Comentarios sobre la acción
Ejemplos
Restaurar una reclamación de recurso con el ID d9fendfwlw:
ibmcloud resource reclamation-restore "d9fendfwlw"
Restaurar una reclamación de recursos con el ID d9fendfwlw, dejar un comentario de need to use for another 3 months y mostrar la salida JSON:
ibmcloud resource reclamation-restore "d9fendfwlw" --comment "need to use for another 3 months" --output JSON
ibmcloud resource reclamation-delete
Suprimir un recurso reclamado para que dicho recurso ya no se pueda restaurar:
ibmcloud resource reclamation-delete ID [--comment COMMENT] [--f, --force]
Opciones de comando
- ID
- ID de la reclamación de recurso
- --comment
- Comentarios sobre la acción
- -f, --force
- Forzar la supresión sin confirmación
Ejemplos
Suprimir una reclamación de recurso con el ID d9fendfwlw:
ibmcloud resource reclamation-delete "d9fendfwlw"
Suprimir una reclamación de recurso con el ID d9fendfwlw y dejar un comentario de no longer needed sin confirmación:
ibmcloud resource reclamation-delete "d9fendfwlw" --comment "no longer needed" -f