Opciones de mandato

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

Opciones de mandato

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

Opciones de mandato

NAME (necesario)

Nombre del grupo de recursos

Ejemplos

Crear un grupo de recursos example-group:

ibmcloud resource group-create example-group

Opciones de mandato

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

Opciones de mandato

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

Ejemplos

Listar todas las definiciones de cuota:

ibmcloud resource quotas

Opciones de mandato

NAME (necesario)

Nombre de la cuota

Ejemplos

Mostrar detalles de cuota free:

ibmcloud resource quota free

Opciones de mandato

--service-name SERVICE_NAME

Nombre de pertenencia al servicio

--location LOCATION

Filtrar por ubicación

--type INSTANCE_TYPE

Tipo de instancias. El tipo service_instance se 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 LIMIT

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

Listar la siguiente página de instancias de servicio con un tamaño de página de 10

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

Opciones de mandato

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

Opciones de mandato

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 puntos finales de servicio. Los valores posibles son 'public', 'private', 'public-and-private'. 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

Opciones de mandato

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

Opciones de mandato

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

Opciones de mandato

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

Opciones de mandato

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

Opciones de mandato

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

Opciones de mandato

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

Opciones de mandato

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 que serviceRole aparece 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_NAME se omite o se establece en None.

-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

Opciones de mandato

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

Opciones de mandato

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

Opciones de mandato

-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 true para aplicar los criterios de búsqueda sólo a los recursos reclamados. Establezca esta opción en false para buscar sólo los recursos activos. false es 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"

Opciones de mandato

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

Opciones de mandato

--output value

Especifique el formato de salida. Ahora sólo se admite JSON.

Opciones de mandato

--offset value, -o value

Número de posición de recurso inicial (valor predeterminado: 0).

--limit value, -l value

Número de recursos a devolver (máximo 1000) (valor predeterminado: 100).

--provider value, -p value

Mostrar recursos de infraestructura clásica, el único valor permitido es: classic-infrastructure. Utilícelo para recursos de tipo SoftLayer_Hardware, SoftLayer_Network_Application_Delivery_Controller, SoftLayer_Network_Subnet_IpAddress o SoftLayer_Network_Vlan.

--details value, -d value

Mostrar atributos adicionales para cada etiqueta, el único valor permitido es true.

--attached value, -a value

Mostrar sólo las etiquetas filtradas adjuntas a un recurso, el único valor permitido es true.

--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 desea listar (obligatorio si el tipo de etiqueta está establecido en service).

--output value

Especifique el formato de salida. Ahora sólo se admite JSON.

-q, --quiet

Suprimir la salida detallada.

Opciones de mandato

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

Opciones de mandato

--tag-names value

Lista separada por comas de nombres de etiqueta.

--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 etiqueta. Los únicos valores permitidos son: user, service o access (valor predeterminado: user).

--tag-type value

El tipo de etiqueta. Los únicos valores permitidos son user o service. El valor predeterminado es user.

--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:value se 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 MyTag a un clúster de Kubernetes denominado MyCluster, busque en primer lugar el CRN del clúster que desea etiquetar:

  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 MyTag --resource-id rn:v1:bluemix:public:containers-kubernetes:us-south:a/a27a4741a57dcf5c965939adb66fe1c7:a46242e638ca47b09f10e9a3cbe5687a::
  

• Para adjuntar la etiqueta de usuario MyTag a un recurso denominado MyResource:

  ibmcloud resource tag-attach --tag-name MyTag --resource-name  'MyResource'
  

• Para adjuntar la etiqueta de usuario MyTag a un invitado virtual de infraestructura clásica denominado MyVM, busque primero el ID del invitado virtual que desee etiquetar:

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

  Tome nota del ID, que es una serie similar a 48373549.

  Para adjuntar la etiqueta, ejecute el mandato siguiente:

  ibmcloud resource tag-attach --tag-names MyTag --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 denominada Project data, ejecute el mandato siguiente:

  ibmcloud resource tag-attach --tag-names "project:myproject" --resource-name Project data -—tag-type access
  

• Para actualizar a production el valor de la etiqueta de usuario env en un recurso denominado MyResource, ejecute el mandato siguiente:

  ibmcloud resource tag-attach --tag-names 'env:production' --resource-name 'MyResource' --update
  

• Para actualizar a production el valor de la etiqueta de gestión de acceso env en un recurso denominado MyResource, 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 MyResource por un nuevo conjunto de etiquetas tag1, tag2 y tag3, 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 MyResource por el código compliance:hipaa, ejecute el mandato siguiente:

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

Opciones de mandato

--tag-names value

Lista separada por comas de nombres de etiqueta.

--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 se deben adjuntar las etiquetas (solo es obligatorio para los recursos de la infraestructura clásica de tipo SoftLayer_Hardware, SoftLayer_Network_Application_Delivery_Controller, SoftLayer_Network_Subnet_IpAddress o SoftLayer_Network_Vlan).

--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 desconectar la etiqueta de usuario MyTag de un clúster de Kubernetes denominado MyCluster, busque en primer lugar el CRN del clúster del que desea desconectar la etiqueta:

  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 MyTag --resource-id rn:v1:bluemix:public:containers-kubernetes:us-south:a/a27a4741a57dcf5c965939adb66fe1c7:a46242e638ca47b09f10e9a3cbe5687a::
  

• Para desconectar la etiqueta de usuario MyTag de un recurso denominado MyResource:

  ibmcloud resource tag-detach --tag-name MyTag --resource-name 'MyResource'
  

• Para desconectar la etiqueta de usuario MyTag de un invitado virtual de infraestructura clásica denominado MyVM, busque primero el ID del invitado virtual del que desee desconectar la etiqueta:

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

  Tome nota del ID, que es una serie similar a 48373549.

• Para desconectar la etiqueta, ejecute el mandato siguiente:

  ibmcloud resource tag-detach --tag-names MyTag --resource-id 48373549 --resource-type SoftLayer_Virtual_Guest
  

• Para desconectar la etiqueta de gestión de acceso project:myproject de una instancia de IBM Cloud Object Storage denominada Project 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:value de MyResource, 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'
  

Opciones de mandato

--tag-name value

Nombre de la etiqueta que se va a suprimir.

--provider value, -p value

Elimina la etiqueta en el proveedor especificado (el único valor admitido es classic-infrastructure). Utilícelo para recursos de tipo SoftLayer_Hardware, SoftLayer_Network_Application_Delivery_Controller, SoftLayer_Network_Subnet_IpAddress o SoftLayer_Network_Vlan.

--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 suprimir la etiqueta de usuario MyTag de la cuenta:

  ibmcloud resource tag-delete --tag-name "MyTag"
  

• Para suprimir la etiqueta de gestión de acceso project:myproject de 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
  

Opciones de mandato

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

Opciones de mandato

RECLAMATION_ID

ID de reclamación de recurso

Ejemplos

Mostrar detalles de una reclamación de recurso:

ibmcloud resource reclamation daf12d343ef

Opciones de mandato

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

Opciones de mandato

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